@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/communication/communication-config.d.ts

@@ -0,0 +1,849 @@
+import { z } from 'zod';
+/**
+ * `communication` family config schemas + deterministic demo generators — PURE
+ * module (zod + chat-lib + shared-config only; no React component code).
+ *
+ * WHY THIS EXISTS: the registry metadata graph reaches this family through
+ * `communication-track.definitions.ts`, which imports the config schemas and the
+ * `demoData` generators. Those must NOT drag the @adminium/ui-heavy chat
+ * components into the eager registry chunk — the components load only through
+ * `lazy(() => import('./communication-track-components.js'))`, so the family
+ * stays one on-demand chunk (04 §2.3, acceptance #3). The `boards-config`
+ * convention; the component files re-export these symbols so barrel/story/test
+ * import points stay one-per-widget.
+ */
+/**
+ * Rows: {id, name, initials, preview, ts, unread, online, group?}. Field names
+ * are config-driven so the generator can bind a `conversations` table whose
+ * columns are named anything (04 §5 / annex §14 auto-instantiation).
+ */
+export declare const conversationInboxConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    nameField: z.ZodDefault<z.ZodString>;
+    previewField: z.ZodDefault<z.ZodString>;
+    sentAtField: z.ZodDefault<z.ZodString>;
+    unreadField: z.ZodDefault<z.ZodString>;
+    onlineField: z.ZodDefault<z.ZodString>;
+    presence: z.ZodDefault<z.ZodBoolean>;
+    groupChats: z.ZodDefault<z.ZodBoolean>;
+    groupField: z.ZodDefault<z.ZodString>;
+    searchable: z.ZodDefault<z.ZodBoolean>;
+    searchLabel: z.ZodOptional<z.ZodString>;
+    searchPlaceholder: z.ZodOptional<z.ZodString>;
+    clearUnreadOnSelect: z.ZodDefault<z.ZodBoolean>;
+    emptyTitle: z.ZodOptional<z.ZodString>;
+    emptyBody: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ConversationInboxConfig = z.infer<typeof conversationInboxConfigSchema>;
+/** Deterministic `record-list` of conversation rows (04 §7.7), canonical §3 `{ rows, total }`. */
+export declare function conversationInboxDemoData(seed: number): {
+    rows: Record<string, unknown>[];
+    total: number;
+};
+/**
+ * Ordered messages {author, body, sentAt, attachments} per conversation — every
+ * field name comes from config (the track contract: "record-list of messages
+ * with author/body/sentAt/attachments fields named in config").
+ */
+export declare const chatThreadConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    authorField: z.ZodDefault<z.ZodString>;
+    bodyField: z.ZodDefault<z.ZodString>;
+    sentAtField: z.ZodDefault<z.ZodString>;
+    attachmentsField: z.ZodDefault<z.ZodString>;
+    ownField: z.ZodDefault<z.ZodString>;
+    ownAuthor: z.ZodOptional<z.ZodString>;
+    peerName: z.ZodOptional<z.ZodString>;
+    peerStatus: z.ZodOptional<z.ZodString>;
+    peerOnline: z.ZodDefault<z.ZodBoolean>;
+    composer: z.ZodDefault<z.ZodBoolean>;
+    composerPlaceholder: z.ZodOptional<z.ZodString>;
+    sendLabel: z.ZodOptional<z.ZodString>;
+    attachments: z.ZodDefault<z.ZodBoolean>;
+    typingIndicator: z.ZodDefault<z.ZodBoolean>;
+    typingLabel: z.ZodOptional<z.ZodString>;
+    daySeparators: z.ZodDefault<z.ZodBoolean>;
+    emptyTitle: z.ZodOptional<z.ZodString>;
+    emptyBody: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ChatThreadConfig = z.infer<typeof chatThreadConfigSchema>;
+/**
+ * Deterministic `record-list` of messages spanning TWO days, so the day
+ * separator + author-run grouping are both exercised by demoData alone.
+ * Canonical §3 `{ rows, total }` envelope.
+ */
+export declare function chatThreadDemoData(seed: number): {
+    rows: Record<string, unknown>[];
+    total: number;
+};
+/**
+ * "Avatar + italic 'typing…' row bound to a boolean" — a `boolean-map` keyed by
+ * conversation id (annex §9: "boolean per conversation"). `conversationId`
+ * selects this instance's row; the display NAMES are config, not data, because
+ * the thread hosting the indicator already knows its peer (the annex places it
+ * as a child of `chat-thread`).
+ */
+export declare const typingIndicatorConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    peerName: z.ZodOptional<z.ZodString>;
+    typists: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    label: z.ZodOptional<z.ZodString>;
+    showAvatar: z.ZodDefault<z.ZodBoolean>;
+    maxAvatars: z.ZodDefault<z.ZodNumber>;
+    emptyTitle: z.ZodOptional<z.ZodString>;
+    emptyBody: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TypingIndicatorConfig = z.infer<typeof typingIndicatorConfigSchema>;
+/**
+ * Deterministic `boolean-map` of per-conversation typing state (04 §7.7), keyed
+ * by the same `c1…c7` ids `conversationInboxDemoData` emits so an inbox + thread
+ * + indicator demo page lines up.
+ *
+ * `c1` is pinned live for EVERY seed: `c1` is the inbox's first row (and so the
+ * thread's default selection), and a demo/VRT frame of a typing indicator that
+ * renders nothing would be a useless capture. The remaining six vary with the
+ * seed, which is what threads it through (the determinism gate asserts distinct
+ * seeds yield distinct payloads).
+ */
+export declare function typingIndicatorDemoData(seed: number): {
+    entries: Record<string, boolean>;
+};
+/**
+ * The ringing overlay: "{kind, peer, state}" — the §3 `record` shape. Niche by
+ * the annex's own note ("kept for marketplace apps: POS support line,
+ * telehealth micro-SaaS"), so it stays a thin, config-labelled shell: it renders
+ * call state and emits accept/decline as `mutate` intents. It never touches a
+ * media device — WebRTC (if a marketplace app ever wants it) is the host's.
+ */
+export declare const callWidgetConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    kindField: z.ZodDefault<z.ZodString>;
+    peerField: z.ZodDefault<z.ZodString>;
+    stateField: z.ZodDefault<z.ZodString>;
+    actions: z.ZodDefault<z.ZodBoolean>;
+    voiceLabel: z.ZodOptional<z.ZodString>;
+    videoLabel: z.ZodOptional<z.ZodString>;
+    ringingLabel: z.ZodOptional<z.ZodString>;
+    connectingLabel: z.ZodOptional<z.ZodString>;
+    activeLabel: z.ZodOptional<z.ZodString>;
+    endedLabel: z.ZodOptional<z.ZodString>;
+    acceptLabel: z.ZodOptional<z.ZodString>;
+    declineLabel: z.ZodOptional<z.ZodString>;
+    endLabel: z.ZodOptional<z.ZodString>;
+    emptyTitle: z.ZodOptional<z.ZodString>;
+    emptyBody: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CallWidgetConfig = z.infer<typeof callWidgetConfigSchema>;
+/**
+ * Deterministic `record` envelope for the ringing card (04 §7.7). Pinned to
+ * `ringing` for every seed — it is the annex's headline state (the expanding
+ * accent ring), so it is what the demo and every VRT capture must show; the
+ * peer and kind vary with the seed.
+ */
+export declare function callWidgetDemoData(seed: number): {
+    row: Record<string, unknown>;
+};
+/**
+ * The schema-Q&A / in-dashboard AI panel SHELL (04 §11, 06 §10). Rendering
+ * only: the M6 LLM layer (@adminium/llm + /api/v1/llm) lives on the server, so
+ * this widget never calls a provider — `providerConfigured: false` renders the
+ * "configure a provider" empty state and the host owns the send callback.
+ */
+export declare const aiChatPanelConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    roleField: z.ZodDefault<z.ZodString>;
+    bodyField: z.ZodDefault<z.ZodString>;
+    sentAtField: z.ZodDefault<z.ZodString>;
+    suggestions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    providerConfigured: z.ZodDefault<z.ZodBoolean>;
+    providerLabel: z.ZodOptional<z.ZodString>;
+    assistantName: z.ZodOptional<z.ZodString>;
+    composerPlaceholder: z.ZodOptional<z.ZodString>;
+    sendLabel: z.ZodOptional<z.ZodString>;
+    pending: z.ZodDefault<z.ZodBoolean>;
+    pendingLabel: z.ZodOptional<z.ZodString>;
+    configureTitle: z.ZodOptional<z.ZodString>;
+    configureBody: z.ZodOptional<z.ZodString>;
+    configureCtaLabel: z.ZodOptional<z.ZodString>;
+    configureHref: z.ZodOptional<z.ZodString>;
+    emptyTitle: z.ZodOptional<z.ZodString>;
+    emptyBody: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AiChatPanelConfig = z.infer<typeof aiChatPanelConfigSchema>;
+/** Deterministic `record-list` of assistant/user turns (04 §7.7), canonical §3 `{ rows, total }`. */
+export declare function aiChatPanelDemoData(seed: number): {
+    rows: Record<string, unknown>[];
+    total: number;
+};
+//# sourceMappingURL=communication-config.d.ts.map