@vantageos/mosaic 0.3.1 → 0.5.0

package/dist/preact/display.d.ts

@@ -3,6 +3,7 @@ import { ComponentChildren, h } from 'preact';
 import { z } from 'zod';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
+export { StatusBadge, StatusBadgeProps, StatusBadgePropsSchema, validateStatusBadgeProps } from './media.js';
 import { Observable } from 'rxjs';
 
 /**
@@ -31,8 +32,8 @@ declare const EmptyStatePropsSchema: z.ZodObject<{
     }>>;
     locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
 }, "strip", z.ZodTypeAny, {
-    title: string;
     locale: "en" | "fr";
+    title: string;
     description?: string | undefined;
     action?: {
         label: string;
@@ -40,12 +41,12 @@ declare const EmptyStatePropsSchema: z.ZodObject<{
     } | undefined;
 }, {
     title: string;
+    locale?: "en" | "fr" | undefined;
     description?: string | undefined;
     action?: {
         label: string;
         variant?: "primary" | "secondary" | undefined;
     } | undefined;
-    locale?: "en" | "fr" | undefined;
 }>;
 type EmptyStatePropsSchemaOutput = z.output<typeof EmptyStatePropsSchema>;
 /**
@@ -123,16 +124,16 @@ declare const SkeletonPropsSchema: z.ZodObject<{
     animation: z.ZodDefault<z.ZodEnum<["pulse", "wave", "none"]>>;
     locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
 }, "strip", z.ZodTypeAny, {
-    variant: "circle" | "rect" | "text";
     locale: "en" | "fr";
+    variant: "rect" | "circle" | "text";
     count: number;
     animation: "none" | "pulse" | "wave";
     width?: string | number | undefined;
     height?: string | number | undefined;
 }, {
-    variant?: "circle" | "rect" | "text" | 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;
@@ -240,42 +241,77 @@ declare function validateVirtualListProps(raw: unknown): VirtualListPropsSchemaO
 declare function VirtualList<T = unknown>(props: VirtualListProps<T>): react_jsx_runtime.JSX.Element;
 
 /**
- * StatusBadge — cross-runtime status indicator badge (Preact 10 implementation).
+ * Badge — cross-runtime generic visual label primitive (Preact 10 implementation).
  *
  * Accepts `Record<string, unknown>` for MCP postMessage injection safety.
  * Zod validation narrows before render. Invalid props → accessible error span.
  *
  * WCAG-AA:
- * - `<output>` has implicit role="status" per ARIA spec §5.3.17
- * - aria-label from `label` prop (falls back to `status` string)
+ * - `<span>` with explicit aria-label combining Badge label + locale
+ * - Optional dot indicator is aria-hidden (decorative)
+ * - Optional count is aria-hidden (included in aria-label via label string)
  * - `lang` attribute set to locale for correct AT language announcement
  *
+ * Badge vs StatusBadge: Badge is the generic visual label primitive (variant + optional
+ * dot/count); StatusBadge is the status-specific semantic one using <output>.
+ *
  * Bilingue: EN/FR strings resolved via t() from i18n/strings — no hardcoded literals.
+ * Target: 0.3.2 patch release.
  */
-declare function StatusBadge(raw: Record<string, unknown>): preact.JSX.Element;
+declare function Badge(raw: Record<string, unknown>): preact.JSX.Element;
 
-declare const StatusBadgePropsSchema: z.ZodObject<{
-    status: z.ZodString;
-    variant: z.ZodDefault<z.ZodEnum<["success", "warning", "danger", "info", "neutral"]>>;
-    label: z.ZodOptional<z.ZodString>;
-    locale: z.ZodEnum<["en", "fr"]>;
+declare const BadgePropsSchema: z.ZodObject<{
+    label: z.ZodString;
+    variant: z.ZodDefault<z.ZodEnum<["default", "primary", "success", "warning", "danger", "info", "neutral"]>>;
+    dot: z.ZodOptional<z.ZodBoolean>;
+    count: z.ZodOptional<z.ZodNumber>;
+    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
 }, "strip", z.ZodTypeAny, {
-    variant: "success" | "warning" | "danger" | "info" | "neutral";
-    status: string;
+    label: string;
+    variant: "primary" | "default" | "success" | "warning" | "danger" | "info" | "neutral";
     locale: "en" | "fr";
-    label?: string | undefined;
+    count?: number | undefined;
+    dot?: boolean | undefined;
 }, {
-    status: string;
-    locale: "en" | "fr";
-    label?: string | undefined;
-    variant?: "success" | "warning" | "danger" | "info" | "neutral" | undefined;
+    label: string;
+    variant?: "primary" | "default" | "success" | "warning" | "danger" | "info" | "neutral" | undefined;
+    locale?: "en" | "fr" | undefined;
+    count?: number | undefined;
+    dot?: boolean | undefined;
 }>;
-type StatusBadgeProps = z.infer<typeof StatusBadgePropsSchema>;
-declare function validateProps(raw: unknown): StatusBadgeProps;
+type BadgeProps = z.infer<typeof BadgePropsSchema>;
+declare function validateBadgeProps(raw: unknown): BadgeProps;
+
+/**
+ * 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;
 };
 /**
@@ -287,34 +323,128 @@ 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";
         header: string;
         key: string;
+        sortable: boolean;
+        sensitive: boolean;
+        width?: string | number | undefined;
+        align?: "start" | "center" | "end" | undefined;
     }, {
         header: string;
         key: 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: "desc" | "asc";
+    }, {
+        key: string;
+        direction: "desc" | "asc";
+    }>>;
+    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";
     columns: {
+        type: "number" | "icon" | "text" | "amount";
         header: string;
         key: string;
+        sortable: boolean;
+        sensitive: boolean;
+        width?: string | number | undefined;
+        align?: "start" | "center" | "end" | undefined;
     }[];
+    maxHeight: number;
+    rows: Record<string, unknown>[];
     virtualizeThreshold: number;
     ariaLabel: string;
+    selectionMode: "none" | "single" | "multiple";
+    stickyHeader: boolean;
+    density: "comfortable" | "compact";
+    loading: boolean;
+    sort?: {
+        key: string;
+        direction: "desc" | "asc";
+    } | undefined;
 }, {
     columns: {
         header: string;
         key: string;
+        type?: "number" | "icon" | "text" | "amount" | undefined;
+        width?: string | number | undefined;
+        align?: "start" | "center" | "end" | undefined;
+        sortable?: boolean | undefined;
+        sensitive?: boolean | undefined;
     }[];
     ariaLabel: string;
+    sort?: {
+        key: string;
+        direction: "desc" | "asc";
+    } | undefined;
     locale?: "en" | "fr" | undefined;
+    maxHeight?: number | undefined;
+    rows?: Record<string, unknown>[] | undefined;
     virtualizeThreshold?: number | undefined;
+    selectionMode?: "none" | "single" | "multiple" | undefined;
+    stickyHeader?: boolean | undefined;
+    density?: "comfortable" | "compact" | undefined;
+    loading?: boolean | undefined;
 }>;
 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).
@@ -327,7 +457,7 @@ type TableViewProps<TRow extends Record<string, unknown> = Record<string, unknow
     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.
@@ -340,28 +470,437 @@ type StreamingTableViewProps<TRow extends Record<string, unknown> = Record<strin
     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".
+ * 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 Record<string, unknown> = Record<string, unknown>>(props: TableViewProps<TRow>): react_jsx_runtime.JSX.Element;
+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.
- * 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".
+ * Same extension props as TableView.
+ */
+declare function StreamingTableView<TRow extends AnyRow = AnyRow>(props: StreamingTableViewProps<TRow>): react_jsx_runtime.JSX.Element;
+
+/**
+ * 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, {
+    label: string;
+    value: string;
+    locale: "en" | "fr";
+    loading: boolean;
+    tone: "success" | "warning" | "danger" | "neutral";
+    description?: string | undefined;
+    unit?: string | undefined;
+    trend?: "flat" | "up" | "down" | undefined;
+    change?: string | undefined;
+}, {
+    description?: string | undefined;
+    label?: string | undefined;
+    value?: string | undefined;
+    locale?: "en" | "fr" | undefined;
+    loading?: boolean | undefined;
+    unit?: string | undefined;
+    trend?: "flat" | "up" | "down" | undefined;
+    change?: string | undefined;
+    tone?: "success" | "warning" | "danger" | "neutral" | 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";
+    address: string;
+    loading: boolean;
+    currency: string;
+    token: string;
+    balance: string;
+    testnet: boolean;
+    tokenAddress?: string | undefined;
+    decimals?: number | undefined;
+    network?: string | undefined;
+    usdValue?: string | undefined;
+}, {
+    locale?: "en" | "fr" | undefined;
+    address?: string | undefined;
+    loading?: boolean | undefined;
+    currency?: string | undefined;
+    token?: string | undefined;
+    balance?: 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, {
+    content: string;
+    sender: string;
+    timestamp: string;
+    id?: string | undefined;
+    channel?: string | undefined;
+    attachmentUrl?: string | undefined;
+    attachmentLabel?: string | undefined;
+    unread?: boolean | undefined;
+}, {
+    content: string;
+    sender: string;
+    timestamp: 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, {
+        content: string;
+        sender: string;
+        timestamp: string;
+        id?: string | undefined;
+        channel?: string | undefined;
+        attachmentUrl?: string | undefined;
+        attachmentLabel?: string | undefined;
+        unread?: boolean | undefined;
+    }, {
+        content: string;
+        sender: string;
+        timestamp: 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";
+    virtualizeThreshold: number;
+    loading: boolean;
+    messages: {
+        content: string;
+        sender: string;
+        timestamp: 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;
+    virtualizeThreshold?: number | undefined;
+    loading?: boolean | undefined;
+    timeZone?: string | undefined;
+    messages?: {
+        content: string;
+        sender: string;
+        timestamp: 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: "summary" | "board";
+}, {
+    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?: "summary" | "board" | 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 StreamingTableView<TRow extends Record<string, unknown> = Record<string, unknown>>(props: StreamingTableViewProps<TRow>): react_jsx_runtime.JSX.Element;
+declare function PipelineBoard(raw?: PipelineBoardViewProps): react_jsx_runtime.JSX.Element;
 
-export { EmptyState, type EmptyStateProps, EmptyStatePropsSchema, Skeleton, type SkeletonProps, SkeletonPropsSchema, StatusBadge, type StatusBadgeProps, StatusBadgePropsSchema, StreamingTableView, type StreamingTableViewProps, TableView, type TableViewProps, TableViewPropsSchema, VirtualList, type VirtualListProps, VirtualListPropsSchema, resolveSkeletonDimensions, validateEmptyStateProps, validateSkeletonProps, validateProps as validateStatusBadgeProps, validateTableViewProps, validateVirtualListProps };
+export { Badge, type BadgeProps, BadgePropsSchema, BalanceCard, type BalanceCardProps, type BalanceCardPropsOutput, BalanceCardPropsSchema, type ColumnDef, type ColumnKind, EmptyState, type EmptyStateProps, EmptyStatePropsSchema, type FeedMessage, MessageFeed, type MessageFeedProps, type MessageFeedPropsOutput, MessageFeedPropsSchema, type MessageFeedViewProps, PipelineBoard, type PipelineBoardProps, type PipelineBoardPropsOutput, PipelineBoardPropsSchema, type PipelineBoardViewProps, type PipelineDeal, type PipelineStage, type SelectionMode, Skeleton, type SkeletonProps, SkeletonPropsSchema, type SortDirection, type SortState, StatCard, type StatCardProps, type StatCardPropsOutput, StatCardPropsSchema, StreamingTableView, type StreamingTableViewProps, TableView, type TableViewOptions, type TableViewProps, TableViewPropsSchema, VirtualList, type VirtualListProps, VirtualListPropsSchema, compareDecimalStrings, nextSort, resolveSkeletonDimensions, sortItems, validateBadgeProps, validateBalanceCardProps, validateEmptyStateProps, validateMessageFeedProps, validatePipelineBoardProps, validateSkeletonProps, validateStatCardProps, validateTableViewProps, validateVirtualListProps };