@vantageos/mosaic 0.3.1 → 0.5.0

package/dist/PipelineBoard-FucyGArR.d.ts

@@ -0,0 +1,759 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { Observable } from 'rxjs';
+import { z } from 'zod';
+
+/**
+ * TableView pure logic (R01 / R10): sorting, selection and cell-kind rules. No React, no DOM.
+ * Shared by the React and Preact runtimes through the shared TableView implementation.
+ */
+type SortDirection = "asc" | "desc";
+interface SortState {
+    key: string;
+    direction: SortDirection;
+}
+/** How a column's cells are compared and rendered. */
+type ColumnKind = "text" | "number" | "amount" | "icon";
+type SelectionMode = "none" | "single" | "multiple";
+/**
+ * Exact comparison of decimal strings (token amounts): no Number() round trip, so values
+ * beyond 2^53 or with 18 decimals compare correctly. Unparseable input compares as equal.
+ */
+declare function compareDecimalStrings(a: string, b: string): number;
+/** Stable sort; missing values last in both directions. Never mutates `items`. */
+declare function sortItems<T>(items: readonly T[], getValue: (item: T) => unknown, kind: ColumnKind, direction: SortDirection, locale: string): T[];
+/** Header click cycle on a column: none -> asc -> desc -> none; another column restarts at asc. */
+declare function nextSort(current: SortState | undefined, key: string): SortState | undefined;
+
+type ColumnDef<TRow extends Record<string, unknown> = Record<string, unknown>> = {
+    key: string;
+    header: string;
+    type?: "text" | "number" | "amount" | "icon";
+    align?: "start" | "center" | "end";
+    width?: string | number;
+    sortable?: boolean;
+    sensitive?: boolean;
+    render?: (row: TRow) => ReactNode;
+};
+/**
+ * Validates the serialisable (non-function) portion of TableView props.
+ * The `rows$` Observable and `render` callbacks are not Zod-parseable and
+ * must be validated at the call-site type level.
+ */
+declare const TableViewPropsSchema: z.ZodObject<{
+    columns: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        header: z.ZodString;
+        /** Cell kind: drives comparison and rendering. `amount` = decimal STRING, never a float. */
+        type: z.ZodDefault<z.ZodEnum<["text", "number", "amount", "icon"]>>;
+        /** Defaults to `end` for `number` / `amount` columns, `start` otherwise. */
+        align: z.ZodOptional<z.ZodEnum<["start", "center", "end"]>>;
+        /** CSS width: a number is pixels. */
+        width: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        sortable: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Values of this column are masked in the A-1 markdown fallback and kept out of the HTML
+         * props of a tool result (delivered via the result `_meta`), never written to `content[]`.
+         */
+        sensitive: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "number" | "icon" | "text" | "amount";
+        key: string;
+        header: string;
+        sortable: boolean;
+        sensitive: boolean;
+        width?: string | number | undefined;
+        align?: "start" | "center" | "end" | undefined;
+    }, {
+        key: string;
+        header: string;
+        type?: "number" | "icon" | "text" | "amount" | undefined;
+        width?: string | number | undefined;
+        align?: "start" | "center" | "end" | undefined;
+        sortable?: boolean | undefined;
+        sensitive?: boolean | undefined;
+    }>, "many">;
+    /**
+     * Serialisable rows, for views built through `createMosaicResource` (the React props carry
+     * `rows` separately).
+     */
+    rows: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+    virtualizeThreshold: z.ZodDefault<z.ZodNumber>;
+    ariaLabel: z.ZodString;
+    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
+    selectionMode: z.ZodDefault<z.ZodEnum<["none", "single", "multiple"]>>;
+    /** Initial sort. */
+    sort: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        direction: z.ZodEnum<["asc", "desc"]>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        direction: "asc" | "desc";
+    }, {
+        key: string;
+        direction: "asc" | "desc";
+    }>>;
+    stickyHeader: z.ZodDefault<z.ZodBoolean>;
+    /** Scroll region height when `stickyHeader` is on (pixels). */
+    maxHeight: z.ZodDefault<z.ZodNumber>;
+    density: z.ZodDefault<z.ZodEnum<["comfortable", "compact"]>>;
+    loading: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    locale: "en" | "fr";
+    loading: boolean;
+    columns: {
+        type: "number" | "icon" | "text" | "amount";
+        key: string;
+        header: string;
+        sortable: boolean;
+        sensitive: boolean;
+        width?: string | number | undefined;
+        align?: "start" | "center" | "end" | undefined;
+    }[];
+    rows: Record<string, unknown>[];
+    virtualizeThreshold: number;
+    ariaLabel: string;
+    selectionMode: "none" | "single" | "multiple";
+    stickyHeader: boolean;
+    maxHeight: number;
+    density: "compact" | "comfortable";
+    sort?: {
+        key: string;
+        direction: "asc" | "desc";
+    } | undefined;
+}, {
+    columns: {
+        key: string;
+        header: string;
+        type?: "number" | "icon" | "text" | "amount" | undefined;
+        width?: string | number | undefined;
+        align?: "start" | "center" | "end" | undefined;
+        sortable?: boolean | undefined;
+        sensitive?: boolean | undefined;
+    }[];
+    ariaLabel: string;
+    locale?: "en" | "fr" | undefined;
+    sort?: {
+        key: string;
+        direction: "asc" | "desc";
+    } | undefined;
+    loading?: boolean | undefined;
+    rows?: Record<string, unknown>[] | undefined;
+    virtualizeThreshold?: number | undefined;
+    selectionMode?: "none" | "single" | "multiple" | undefined;
+    stickyHeader?: boolean | undefined;
+    maxHeight?: number | undefined;
+    density?: "compact" | "comfortable" | undefined;
+}>;
+type TableViewPropsSchemaInput = z.input<typeof TableViewPropsSchema>;
+type TableViewPropsSchemaOutput = z.output<typeof TableViewPropsSchema>;
+/** Options shared by the static and streaming variants (R01 / R10 extension). */
+type TableViewOptions<TRow extends Record<string, unknown>> = {
+    /** `none` (default) adds no selection column. `single` renders radios, `multiple` checkboxes. */
+    selectionMode?: SelectionMode;
+    /** Controlled selection: row keys (`id` when present, else `row-<original index>`). */
+    selectedKeys?: string[];
+    defaultSelectedKeys?: string[];
+    /** Selected rows in table order, plus their keys. Feed it to `selectionModelContext`. */
+    onSelectionChange?: (rows: Partial<TRow>[], keys: string[]) => void;
+    /** Controlled sort; `null` = unsorted. */
+    sort?: SortState | null;
+    defaultSort?: SortState;
+    onSortChange?: (sort: SortState | undefined) => void;
+    stickyHeader?: boolean;
+    /** Scroll region height in pixels when `stickyHeader` is on. Default 400. */
+    maxHeight?: number;
+    density?: "comfortable" | "compact";
+    /** Shows a Skeleton table instead of rows. */
+    loading?: boolean;
+};
+/**
+ * Props for the static TableView — accepts a plain array of rows.
+ * Primary API for already-fetched data (no rxjs required).
+ */
+type TableViewProps<TRow extends Record<string, unknown> = Record<string, unknown>> = {
+    columns: ColumnDef<TRow>[];
+    rows: Partial<TRow>[];
+    virtualizeThreshold?: number;
+    ariaLabel: string;
+    locale?: "en" | "fr";
+    /** v0.2.1+: when provided, rows become keyboard-activable (role=button + tabIndex=0 + Enter/Space). 5-BU ABSOLUTE blocker fix. */
+    onRowClick?: (row: TRow, index: number) => void;
+} & TableViewOptions<TRow>;
+/**
+ * Props for StreamingTableView — accepts an RxJS Observable for incremental row appending.
+ * Consumers using this variant MUST install rxjs ^7.8.0 in their project.
+ */
+type StreamingTableViewProps<TRow extends Record<string, unknown> = Record<string, unknown>> = {
+    columns: ColumnDef<TRow>[];
+    rows$: Observable<Partial<TRow>[]>;
+    virtualizeThreshold?: number;
+    ariaLabel: string;
+    locale?: "en" | "fr";
+    /** v0.2.1+: same semantics as static TableView. */
+    onRowClick?: (row: TRow, index: number) => void;
+} & TableViewOptions<TRow>;
+declare function validateTableViewProps(raw: unknown): TableViewPropsSchemaOutput;
+
+type AnyRow = Record<string, unknown>;
+/**
+ * TableView — Static rows variant (primary API).
+ *
+ * Accepts `rows: Row[]` for already-fetched data — no rxjs required.
+ * Activates TanStack Virtual v3 windowing when rows.length > virtualizeThreshold.
+ * Zod-validates serialisable props; renders role="alert" fallback on failure.
+ * Fully accessible: aria-rowcount, aria-label, scope="col", aria-sort on sortable headers.
+ *
+ * R01 / R10 extension (additive, every new prop optional): sortable columns, single / multiple
+ * selection, sticky header, compact density, column align / width, `amount` and `icon` cell kinds
+ * and a Skeleton loading state. Claude inline cards want few rows and no nested scrolling:
+ * keep inline summaries short and offer fullscreen for the full set.
+ */
+declare function TableView<TRow extends AnyRow = AnyRow>(props: TableViewProps<TRow>): react_jsx_runtime.JSX.Element;
+/**
+ * StreamingTableView — Streaming rows variant (advanced, opt-in).
+ *
+ * Pattern 4 Streaming Hydration reference implementation.
+ * Consumes an RxJS Observable<Row[]> for incremental row appending.
+ * Consumers MUST install rxjs ^7.8.0 in their project.
+ * Same extension props as TableView.
+ */
+declare function StreamingTableView<TRow extends AnyRow = AnyRow>(props: StreamingTableViewProps<TRow>): react_jsx_runtime.JSX.Element;
+
+/**
+ * EmptyState component props schema.
+ *
+ * Empty-set illustration + title + description + optional CTA.
+ * Consumer-driven i18n: caller passes already-localized strings.
+ *
+ * icon        — optional ReactNode / PreactNode passed by the caller
+ * title       — required heading (h2, consumer-driven i18n)
+ * description — optional supporting text
+ * action      — optional CTA: { label, onClick, variant? }
+ */
+declare const EmptyStatePropsSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        variant: z.ZodDefault<z.ZodEnum<["primary", "secondary"]>>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        variant: "primary" | "secondary";
+    }, {
+        label: string;
+        variant?: "primary" | "secondary" | undefined;
+    }>>;
+    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
+}, "strip", z.ZodTypeAny, {
+    locale: "en" | "fr";
+    title: string;
+    description?: string | undefined;
+    action?: {
+        label: string;
+        variant: "primary" | "secondary";
+    } | undefined;
+}, {
+    title: string;
+    locale?: "en" | "fr" | undefined;
+    description?: string | undefined;
+    action?: {
+        label: string;
+        variant?: "primary" | "secondary" | undefined;
+    } | undefined;
+}>;
+type EmptyStatePropsSchemaInput = z.input<typeof EmptyStatePropsSchema>;
+type EmptyStatePropsSchemaOutput = z.output<typeof EmptyStatePropsSchema>;
+/**
+ * Full EmptyState props including framework-specific node types and callback.
+ * `icon` and `action.onClick` are excluded from Zod (functions/nodes are not serializable).
+ *
+ * Note: action.variant is optional for callers — Zod applies "primary" default at parse time.
+ */
+type EmptyStateProps = Omit<EmptyStatePropsSchemaOutput, "action"> & {
+    icon?: any;
+    action?: {
+        label: string;
+        variant?: "primary" | "secondary";
+        onClick: () => void;
+    };
+};
+declare function validateEmptyStateProps(raw: unknown): EmptyStatePropsSchemaOutput;
+
+/**
+ * Skeleton — cross-runtime loading placeholder (React 19 implementation).
+ *
+ * Accepts `Record<string, unknown>` for MCP postMessage injection safety.
+ * Zod validation narrows before render. Invalid props → accessible error span.
+ *
+ * Animation "none" is auto-applied when prefers-reduced-motion is set (via
+ * Tailwind's animate-pulse which respects the media query natively), or by
+ * passing animation="none" explicitly.
+ *
+ * WCAG-AA:
+ * - role="status" + aria-busy="true" on the container
+ * - aria-label resolves via t() in EN/FR
+ * - aria-hidden="true" on individual line spans (status role covers the group)
+ */
+declare function Skeleton(raw: Record<string, unknown>): react_jsx_runtime.JSX.Element;
+
+/**
+ * Skeleton component props schema.
+ *
+ * variant  — shape of the placeholder:
+ *            "rect"   → rectangular block (default)
+ *            "circle" → circular avatar / icon placeholder
+ *            "text"   → single or multi-line text placeholder
+ *
+ * width / height — CSS values (string) or pixels (number).
+ *   "rect" defaults: width="100%", height=100
+ *   "circle" defaults: width=height (equal, square rendered as circle)
+ *   "text" defaults: width="100%", height=16
+ *
+ * count  — number of text line spans (only meaningful for variant="text").
+ *          Default 1. Ignored for rect/circle.
+ *
+ * animation — shimmer style:
+ *   "pulse" → opacity pulse (default)
+ *   "wave"  → left-to-right gradient sweep
+ *   "none"  → static placeholder (auto-selected when prefers-reduced-motion)
+ */
+declare const SkeletonPropsSchema: z.ZodObject<{
+    variant: z.ZodDefault<z.ZodEnum<["rect", "circle", "text"]>>;
+    width: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    height: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    count: z.ZodDefault<z.ZodNumber>;
+    animation: z.ZodDefault<z.ZodEnum<["pulse", "wave", "none"]>>;
+    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
+}, "strip", z.ZodTypeAny, {
+    locale: "en" | "fr";
+    variant: "rect" | "circle" | "text";
+    count: number;
+    animation: "none" | "pulse" | "wave";
+    width?: string | number | undefined;
+    height?: string | number | undefined;
+}, {
+    locale?: "en" | "fr" | undefined;
+    width?: string | number | undefined;
+    variant?: "rect" | "circle" | "text" | undefined;
+    height?: string | number | undefined;
+    count?: number | undefined;
+    animation?: "none" | "pulse" | "wave" | undefined;
+}>;
+type SkeletonProps = z.infer<typeof SkeletonPropsSchema>;
+declare function validateSkeletonProps(raw: unknown): SkeletonProps;
+/**
+ * Resolve final width/height CSS values given the variant and raw props.
+ * Centralised here so React + Preact runtimes share identical defaults.
+ */
+declare function resolveSkeletonDimensions(variant: SkeletonProps["variant"], width: SkeletonProps["width"], height: SkeletonProps["height"]): {
+    widthCss: string;
+    heightCss: string;
+};
+
+/**
+ * StatCard (R08): one metric — label, value, optional trend and change.
+ *
+ * Every field has a default so `{}` parses: a ChatGPT global entrypoint opens with empty
+ * arguments (openai/mcp-extensions docs/spec.md, entrypoints) and the view then shows an empty
+ * state instead of failing. `value` is a STRING (a decimal string for money, never a float).
+ * Claude inline cards count each stat toward the "4-5 data points" cap: keep few per card.
+ */
+declare const StatCardPropsSchema: z.ZodObject<{
+    label: z.ZodDefault<z.ZodString>;
+    value: z.ZodDefault<z.ZodString>;
+    unit: z.ZodOptional<z.ZodString>;
+    trend: z.ZodOptional<z.ZodEnum<["up", "down", "flat"]>>;
+    /** Pre-formatted change, e.g. "+4.2%". */
+    change: z.ZodOptional<z.ZodString>;
+    tone: z.ZodDefault<z.ZodEnum<["neutral", "success", "warning", "danger"]>>;
+    description: z.ZodOptional<z.ZodString>;
+    loading: z.ZodDefault<z.ZodBoolean>;
+    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    label: string;
+    locale: "en" | "fr";
+    loading: boolean;
+    tone: "warning" | "danger" | "neutral" | "success";
+    description?: string | undefined;
+    unit?: string | undefined;
+    trend?: "flat" | "up" | "down" | undefined;
+    change?: string | undefined;
+}, {
+    value?: string | undefined;
+    label?: string | undefined;
+    locale?: "en" | "fr" | undefined;
+    description?: string | undefined;
+    loading?: boolean | undefined;
+    unit?: string | undefined;
+    trend?: "flat" | "up" | "down" | undefined;
+    change?: string | undefined;
+    tone?: "warning" | "danger" | "neutral" | "success" | undefined;
+}>;
+type StatCardProps = z.input<typeof StatCardPropsSchema>;
+type StatCardPropsOutput = z.output<typeof StatCardPropsSchema>;
+declare function validateStatCardProps(raw: unknown): StatCardPropsOutput;
+
+/**
+ * StatCard — one KPI: label, value, optional unit, trend (word + arrow, never colour alone) and
+ * change. Skeleton while `loading`; an empty state for `{}` (ChatGPT entrypoint default).
+ * WCAG-AA: a labelled region; the trend is stated in text.
+ */
+declare function StatCard(raw: StatCardProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * BalanceCard (R09): a wallet balance for the Fuse server views.
+ *
+ * Source shape: fuse-mcp-server `src/tools/getBalance.ts` returns `{ address, token,
+ * tokenAddress?, decimals, balanceRaw?, balanceWei?, balanceFormatted }`. `balance` is the
+ * `balanceFormatted` DECIMAL STRING — shown as given, never routed through a float. Read-only.
+ * `{}` parses (ChatGPT entrypoint default).
+ */
+declare const BalanceCardPropsSchema: z.ZodObject<{
+    token: z.ZodDefault<z.ZodString>;
+    balance: z.ZodDefault<z.ZodString>;
+    address: z.ZodDefault<z.ZodString>;
+    tokenAddress: z.ZodOptional<z.ZodString>;
+    decimals: z.ZodOptional<z.ZodNumber>;
+    network: z.ZodOptional<z.ZodString>;
+    testnet: z.ZodDefault<z.ZodBoolean>;
+    /** Decimal string in `currency`. */
+    usdValue: z.ZodOptional<z.ZodString>;
+    currency: z.ZodDefault<z.ZodString>;
+    loading: z.ZodDefault<z.ZodBoolean>;
+    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
+}, "strip", z.ZodTypeAny, {
+    locale: "en" | "fr";
+    loading: boolean;
+    currency: string;
+    token: string;
+    balance: string;
+    address: string;
+    testnet: boolean;
+    tokenAddress?: string | undefined;
+    decimals?: number | undefined;
+    network?: string | undefined;
+    usdValue?: string | undefined;
+}, {
+    locale?: "en" | "fr" | undefined;
+    loading?: boolean | undefined;
+    currency?: string | undefined;
+    token?: string | undefined;
+    balance?: string | undefined;
+    address?: string | undefined;
+    tokenAddress?: string | undefined;
+    decimals?: number | undefined;
+    network?: string | undefined;
+    testnet?: boolean | undefined;
+    usdValue?: string | undefined;
+}>;
+type BalanceCardProps = z.input<typeof BalanceCardPropsSchema>;
+type BalanceCardPropsOutput = z.output<typeof BalanceCardPropsSchema>;
+declare function validateBalanceCardProps(raw: unknown): BalanceCardPropsOutput;
+
+/**
+ * BalanceCard — composition of {@link StatCard} (amount + token) with the network badge, a
+ * testnet badge, the truncated address (full address in `title`) and, when the sandbox exposes
+ * the async clipboard, a copy button. Read-only; no wallet action.
+ */
+declare function BalanceCard(raw: BalanceCardProps): react_jsx_runtime.JSX.Element;
+
+declare const FeedMessageSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    sender: z.ZodString;
+    channel: z.ZodOptional<z.ZodString>;
+    /** Plain text. Rendered as text, never as HTML. */
+    content: z.ZodString;
+    /** ISO 8601. */
+    timestamp: z.ZodString;
+    attachmentUrl: z.ZodOptional<z.ZodString>;
+    attachmentLabel: z.ZodOptional<z.ZodString>;
+    unread: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    content: string;
+    sender: string;
+    id?: string | undefined;
+    channel?: string | undefined;
+    attachmentUrl?: string | undefined;
+    attachmentLabel?: string | undefined;
+    unread?: boolean | undefined;
+}, {
+    timestamp: string;
+    content: string;
+    sender: string;
+    id?: string | undefined;
+    channel?: string | undefined;
+    attachmentUrl?: string | undefined;
+    attachmentLabel?: string | undefined;
+    unread?: boolean | undefined;
+}>;
+type FeedMessage = z.infer<typeof FeedMessageSchema>;
+/**
+ * MessageFeed (R03): VantagePeers messages as a READ-ONLY feed — not a chat input (Claude's
+ * design guidelines list chat inputs under patterns to avoid; the host composer exists).
+ * Messages are ordered oldest first; `maxItems` keeps the latest N (Claude inline: last few).
+ * `{}` parses (ChatGPT entrypoint default).
+ */
+declare const MessageFeedPropsSchema: z.ZodObject<{
+    messages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        sender: z.ZodString;
+        channel: z.ZodOptional<z.ZodString>;
+        /** Plain text. Rendered as text, never as HTML. */
+        content: z.ZodString;
+        /** ISO 8601. */
+        timestamp: z.ZodString;
+        attachmentUrl: z.ZodOptional<z.ZodString>;
+        attachmentLabel: z.ZodOptional<z.ZodString>;
+        unread: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        content: string;
+        sender: string;
+        id?: string | undefined;
+        channel?: string | undefined;
+        attachmentUrl?: string | undefined;
+        attachmentLabel?: string | undefined;
+        unread?: boolean | undefined;
+    }, {
+        timestamp: string;
+        content: string;
+        sender: string;
+        id?: string | undefined;
+        channel?: string | undefined;
+        attachmentUrl?: string | undefined;
+        attachmentLabel?: string | undefined;
+        unread?: boolean | undefined;
+    }>, "many">>;
+    maxItems: z.ZodOptional<z.ZodNumber>;
+    /** IANA timezone for timestamps (e.g. `hostContext.timeZone`). */
+    timeZone: z.ZodOptional<z.ZodString>;
+    /** Above this many shown messages the feed is virtualised through VirtualList. */
+    virtualizeThreshold: z.ZodDefault<z.ZodNumber>;
+    loading: z.ZodDefault<z.ZodBoolean>;
+    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
+}, "strip", z.ZodTypeAny, {
+    locale: "en" | "fr";
+    loading: boolean;
+    virtualizeThreshold: number;
+    messages: {
+        timestamp: string;
+        content: string;
+        sender: string;
+        id?: string | undefined;
+        channel?: string | undefined;
+        attachmentUrl?: string | undefined;
+        attachmentLabel?: string | undefined;
+        unread?: boolean | undefined;
+    }[];
+    timeZone?: string | undefined;
+    maxItems?: number | undefined;
+}, {
+    locale?: "en" | "fr" | undefined;
+    timeZone?: string | undefined;
+    loading?: boolean | undefined;
+    virtualizeThreshold?: number | undefined;
+    messages?: {
+        timestamp: string;
+        content: string;
+        sender: string;
+        id?: string | undefined;
+        channel?: string | undefined;
+        attachmentUrl?: string | undefined;
+        attachmentLabel?: string | undefined;
+        unread?: boolean | undefined;
+    }[] | undefined;
+    maxItems?: number | undefined;
+}>;
+type MessageFeedProps = z.input<typeof MessageFeedPropsSchema>;
+type MessageFeedPropsOutput = z.output<typeof MessageFeedPropsSchema>;
+declare function validateMessageFeedProps(raw: unknown): MessageFeedPropsOutput;
+
+type MessageFeedViewProps = MessageFeedProps & {
+    /**
+     * Route attachment links through the host (`ui/open-link`, see `openLink` in ./host) —
+     * sandboxed views cannot navigate. Without it an http(s) attachment is a plain anchor.
+     */
+    onOpenLink?: (url: string) => void;
+};
+/**
+ * MessageFeed — read-only message feed (R03). Plain-text content, safe attachment links, the
+ * latest `maxItems` for inline cards, VirtualList above `virtualizeThreshold`. Not a chat input.
+ */
+declare function MessageFeed(raw?: MessageFeedViewProps): react_jsx_runtime.JSX.Element;
+
+declare const PipelineDealSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    /** Decimal STRING (never a float), in the board currency. */
+    amount: z.ZodOptional<z.ZodString>;
+    contact: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    id: string;
+    amount?: string | undefined;
+    url?: string | undefined;
+    contact?: string | undefined;
+}, {
+    title: string;
+    id: string;
+    amount?: string | undefined;
+    url?: string | undefined;
+    contact?: string | undefined;
+}>;
+declare const PipelineStageSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    deals: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        /** Decimal STRING (never a float), in the board currency. */
+        amount: z.ZodOptional<z.ZodString>;
+        contact: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        amount?: string | undefined;
+        url?: string | undefined;
+        contact?: string | undefined;
+    }, {
+        title: string;
+        id: string;
+        amount?: string | undefined;
+        url?: string | undefined;
+        contact?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    deals: {
+        title: string;
+        id: string;
+        amount?: string | undefined;
+        url?: string | undefined;
+        contact?: string | undefined;
+    }[];
+}, {
+    id: string;
+    name: string;
+    deals?: {
+        title: string;
+        id: string;
+        amount?: string | undefined;
+        url?: string | undefined;
+        contact?: string | undefined;
+    }[] | undefined;
+}>;
+type PipelineDeal = z.infer<typeof PipelineDealSchema>;
+type PipelineStage = z.infer<typeof PipelineStageSchema>;
+/**
+ * PipelineBoard (R06): deals by stage, READ-ONLY (no drag, no stage change), fullscreen-first.
+ * `layout: "board"` is the fullscreen columns view; `"summary"` is the inline stage-totals card
+ * (see `layoutForDisplayMode`). `{}` parses: ChatGPT opens entrypoints fullscreen with empty
+ * arguments (openai/mcp-extensions docs/spec.md).
+ */
+declare const PipelineBoardPropsSchema: z.ZodObject<{
+    stages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        deals: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            /** Decimal STRING (never a float), in the board currency. */
+            amount: z.ZodOptional<z.ZodString>;
+            contact: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            id: string;
+            amount?: string | undefined;
+            url?: string | undefined;
+            contact?: string | undefined;
+        }, {
+            title: string;
+            id: string;
+            amount?: string | undefined;
+            url?: string | undefined;
+            contact?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        deals: {
+            title: string;
+            id: string;
+            amount?: string | undefined;
+            url?: string | undefined;
+            contact?: string | undefined;
+        }[];
+    }, {
+        id: string;
+        name: string;
+        deals?: {
+            title: string;
+            id: string;
+            amount?: string | undefined;
+            url?: string | undefined;
+            contact?: string | undefined;
+        }[] | undefined;
+    }>, "many">>;
+    /** ISO 4217 code used to format amounts. */
+    currency: z.ZodDefault<z.ZodString>;
+    layout: z.ZodDefault<z.ZodEnum<["board", "summary"]>>;
+    loading: z.ZodDefault<z.ZodBoolean>;
+    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
+}, "strip", z.ZodTypeAny, {
+    locale: "en" | "fr";
+    loading: boolean;
+    currency: string;
+    stages: {
+        id: string;
+        name: string;
+        deals: {
+            title: string;
+            id: string;
+            amount?: string | undefined;
+            url?: string | undefined;
+            contact?: string | undefined;
+        }[];
+    }[];
+    layout: "board" | "summary";
+}, {
+    locale?: "en" | "fr" | undefined;
+    loading?: boolean | undefined;
+    currency?: string | undefined;
+    stages?: {
+        id: string;
+        name: string;
+        deals?: {
+            title: string;
+            id: string;
+            amount?: string | undefined;
+            url?: string | undefined;
+            contact?: string | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    layout?: "board" | "summary" | undefined;
+}>;
+type PipelineBoardProps = z.input<typeof PipelineBoardPropsSchema>;
+type PipelineBoardPropsOutput = z.output<typeof PipelineBoardPropsSchema>;
+declare function validatePipelineBoardProps(raw: unknown): PipelineBoardPropsOutput;
+
+type PipelineBoardViewProps = PipelineBoardProps & {
+    /** Summary layout: ask the host for fullscreen (`requestDisplayMode` in ./host). */
+    onRequestFullscreen?: () => void;
+    /** Deal links go through the host (`ui/open-link`); without it deals with a url are plain text. */
+    onOpenLink?: (url: string) => void;
+};
+/**
+ * PipelineBoard — deals by stage, READ-ONLY. `board`: one labelled column per stage with stage
+ * filter chips (R25); `summary`: the inline stage-totals card. No drag-and-drop and no stage
+ * change (R07 deferred). Horizontal pan only; scroll padding honours the host safe-area insets.
+ */
+declare function PipelineBoard(raw?: PipelineBoardViewProps): react_jsx_runtime.JSX.Element;
+
+export { StreamingTableView as A, BalanceCard as B, type ColumnDef as C, type StreamingTableViewProps as D, type EmptyStateProps as E, type FeedMessage as F, type TableViewOptions as G, type TableViewProps as H, TableViewPropsSchema as I, type TableViewPropsSchemaInput as J, type TableViewPropsSchemaOutput as K, compareDecimalStrings as L, MessageFeed as M, nextSort as N, resolveSkeletonDimensions as O, PipelineBoard as P, sortItems as Q, validateBalanceCardProps as R, type SelectionMode as S, TableView as T, validateEmptyStateProps as U, validateMessageFeedProps as V, validatePipelineBoardProps as W, validateSkeletonProps as X, validateStatCardProps as Y, validateTableViewProps as Z, type BalanceCardProps as a, type BalanceCardPropsOutput as b, BalanceCardPropsSchema as c, type ColumnKind as d, EmptyStatePropsSchema as e, type EmptyStatePropsSchemaInput as f, type EmptyStatePropsSchemaOutput as g, type MessageFeedProps as h, type MessageFeedPropsOutput as i, MessageFeedPropsSchema as j, type MessageFeedViewProps as k, type PipelineBoardProps as l, type PipelineBoardPropsOutput as m, PipelineBoardPropsSchema as n, type PipelineBoardViewProps as o, type PipelineDeal as p, type PipelineStage as q, Skeleton as r, type SkeletonProps as s, SkeletonPropsSchema as t, type SortDirection as u, type SortState as v, StatCard as w, type StatCardProps as x, type StatCardPropsOutput as y, StatCardPropsSchema as z };