import { type Json, type ToolOutcome, type UIPayload } from "../../core/index.js"; import type { VendoTheme } from "../../core/apps/index.js"; import { type ReactNode } from "react"; import type { ParkedPress } from "../tree/renderer.js"; /** A generated view pinned into a slot (08-ui §4 — "or a pinned component"). * Unlike an app (a whole document), a pin is a single `vendo-genui/v2` tree the * user authored and pinned in place; it mounts through the same tree renderer + * error boundary, falling back to the host's original markup if it throws. */ export interface VendoSlotPin { /** The pinned generated view (a `vendo-genui/v2` tree payload). */ payload: UIPayload; /** Live data overriding the tree's embedded data model (08-ui §5). */ data?: Record; /** Action dispatch for the pinned component; defaults to the tree renderer's * fail-soft no-op when a pin carries no live handler. */ onAction?(req: { nodeId: string; action: string; payload?: Json; }): Promise; } /** 08-ui §4; 06-apps §8 — inline mount that never sacrifices host fallback content. * * A slot's one job is mounting brand-new generated apps (2026-08-02 final * shape — remix lives entirely on `` now). Three states: * - empty: no `appId`, no `pin`, no `children` → the ghost with a REAL CTA button * that opens the authoring surface (`onAuthor`, else the mounted conversation * or ⌘K palette, else a line saying to ask the assistant); * - app: `appId` → the whole app document mounts (via the single-app transport); * - pinned component: `pin` → the authored `vendo-genui/v2` view mounts in place. * * In both filled states the swap morphs through the ENG-205 render slot, using * the host's own markup as the exit frame, and the PinMount error boundary keeps * the original `children` as the visible recovery path (06-apps §8). Without any * of the three, the children render UNTOUCHED (no wrapper — hosts may inline * slots anywhere). */ export declare function VendoSlot({ id, label, description, appId: appIdProp, pin, onAuthor, onParked, discover, emptyState, theme, children }: { id: string; /** What a person choosing this slot in the "Add to…" picker reads. Defaults * to the id read as words ("net-worth-card" → "Net worth card"). */ label?: string; /** What this spot is FOR, in your own words ("main dashboard area, where * users keep KPI views"). It reaches the agent through the slot registry, so * it can tell two slots apart that a label alone cannot. Nobody sees it. */ description?: string; appId?: string; pin?: VendoSlotPin; /** Invoked when the empty-state CTA is activated — the seam to open your own * authoring surface. Defaults to opening a mounted VendoOverlay. */ onAuthor?(slotId: string): void; /** Invoked when a press inside the mounted view is parked on an approval. The * view settles itself when the decision lands (tree/parked-approvals.ts); * this is the seam for surfacing the decision where the person already is. */ onParked?: (parked: ParkedPress) => void; /** Pass `false` to stand pin self-discovery down even with no `appId`/`pin` * prop — for hosts that resolve the pin themselves (e.g. via useSlotApp * for a layout decision) and must not start a second poll. */ discover?: boolean; /** Empty-state invitation config. Every string * is host-customizable with white-label defaults; suggestions are 3 * host-aware prompts (generic fallbacks otherwise) whose tap PREFILLS the * conversation composer — never sends. */ emptyState?: { /** Default "This space builds itself". */ title?: string; /** Default "describe a view — it renders here, live on your data". */ subtitle?: string; /** Up to 3 prompt chips. Default: generic view-authoring prompts. */ suggestions?: string[]; /** Primary button label. Default "Design a view". */ ctaLabel?: string; }; /** * This slot's own brand tokens, merged group by group over the provider's * resolved theme — the same merge `VendoProvider` does over * `defaultVendoTheme`, so with no provider above this merges over the * defaults. The approval modal a press inside this slot parks on carries * these tokens too, even though it portals to ``. * * FRAME ONLY: it styles Vendo's own chrome — the ghost, the invitation, the * failure cards, the ✦ pin chrome. The mounted view itself keeps the * PROVIDER theme, whether it is an iframe-served app (themed over the app * transport) or a `pin` rendered natively: the tree surface restates the * provider tokens on its own root, so the local ones do not cascade in. * * A slot showing your OWN markup has no Vendo chrome on screen and gets no * wrapper at all, so this does nothing there — by design. */ theme?: Partial; children?: ReactNode; }): import("react").JSX.Element;