@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/communication/AiChatPanel.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Button, EmptyState, IconTile, Input, Spinner } from '@adminium/ui';
+import { KeyRound, Send, Sparkles } from 'lucide-react';
+import { useState } from 'react';
+import { chatRowsOf, fmtClock, formatAbsoluteTime, localeOf, sortBySentAt, sourceOf, stringField, CHAT_DEMO_EPOCH, } from './chat-lib.js';
+// Config schema + deterministic demo payload live in the pure
+// `communication-config` module so the registry metadata graph never eagerly
+// pulls this component's @adminium/ui deps (acceptance #3); re-exported here so
+// the family barrel, stories, and tests keep one import point per widget.
+export { aiChatPanelConfigSchema, aiChatPanelDemoData } from './communication-config.js';
+export function AiChatPanel({ turns, suggestions = [], providerConfigured = true, providerLabel, assistantName, composerPlaceholder, sendLabel, pending = false, pendingLabel, configureTitle, configureBody, configureCtaLabel, emptyTitle, emptyBody, onSend, onConfigure, locale: localeProp, dir, testId, }) {
+    // `format.locale` is a free-string in the shared config, so '' / 'x-1' are
+    // schema-valid and would throw out of every Intl call. Normalize at the edge.
+    const locale = localeOf(localeProp);
+    const [draft, setDraft] = useState('');
+    const ordered = sortBySentAt(turns.map((turn) => ({ ...turn, own: turn.role === 'user', sentAt: turn.sentAt ?? '' })));
+    const send = (prompt) => {
+        const body = prompt.trim();
+        if (body === '')
+            return;
+        onSend?.(body);
+        setDraft('');
+    };
+    const submit = (event) => {
+        event.preventDefault();
+        send(draft);
+    };
+    return (_jsxs("div", { "data-widget": "ai-chat-panel", "data-testid": testId, "data-provider-configured": providerConfigured ? '' : undefined, ...(dir === undefined ? {} : { dir }), className: "flex h-full flex-col", children: [_jsxs("div", { className: "flex items-center gap-2.5 border-b border-border/60 px-4 py-3", children: [_jsx(IconTile, { size: "sm", tone: "accent", icon: _jsx(Sparkles, {}) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "truncate text-body-sm font-bold text-fg", children: assistantName ?? 'Assistant' }), providerLabel !== undefined && (_jsx("div", { className: "truncate font-mono text-caption text-fg-subtle", children: providerLabel }))] })] }), !providerConfigured ? (
+            // No provider → the panel is inert by design: no composer, no callbacks
+            // that could imply a request is possible (06 §4 — the server owns keys).
+            _jsx("div", { "data-part": "configure-provider", className: "flex-1", children: _jsx(EmptyState, { compact: true, icon: _jsx(KeyRound, {}), tone: "warn", title: configureTitle ?? 'No AI provider configured', body: configureBody ??
+                        'Add an Anthropic or OpenAI key — or point Adminium at your own endpoint — to ask questions about your schema.', actions: onConfigure === undefined ? undefined : (_jsx(Button, { variant: "primary", size: "sm", onClick: onConfigure, children: configureCtaLabel ?? 'Configure a provider' })) }) })) : (_jsxs(_Fragment, { children: [ordered.length === 0 ? (_jsx("div", { className: "flex-1", children: _jsx(EmptyState, { compact: true, icon: _jsx(Sparkles, {}), tone: "accent", title: emptyTitle ?? 'Ask about your data', body: emptyBody ?? 'Ask a question about your schema, tables, or metrics to get started.' }) })) : (_jsxs("div", { "data-part": "ai-transcript", className: "flex flex-1 flex-col gap-2 overflow-auto p-4", children: [ordered.map((turn) => (_jsx(AiBubble, { turn: turn, locale: locale }, turn.id))), pending && (_jsxs("div", { "data-part": "ai-pending", className: "flex items-center gap-2 py-1", children: [_jsx(Spinner, { size: "sm" }), _jsx("span", { className: "text-caption italic text-fg-subtle", children: pendingLabel ?? 'Thinking…' })] }))] })), suggestions.length > 0 && (_jsx("ul", { "data-part": "suggestion-chips", className: "flex flex-wrap gap-1.5 px-4 pb-2", children: suggestions.map((suggestion) => (_jsx("li", { children: _jsx("button", { type: "button", "data-part": "suggestion-chip", disabled: pending, onClick: () => send(suggestion), className: "rounded-full border border-border bg-surface-2 px-2.5 py-1 text-caption font-semibold text-fg-muted hover:border-accent hover:text-accent focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent disabled:pointer-events-none disabled:opacity-40", children: suggestion }) }, suggestion))) })), _jsxs("form", { "data-part": "composer", onSubmit: submit, className: "flex items-center gap-2 border-t border-border/60 p-3", children: [_jsx(Input, { "aria-label": composerPlaceholder ?? 'Ask a question', placeholder: composerPlaceholder ?? 'Ask a question…', value: draft, disabled: pending, onChange: (event) => setDraft(event.currentTarget.value) }), _jsx("button", { type: "submit", "data-part": "send-button", "aria-label": sendLabel ?? 'Send', disabled: pending || draft.trim() === '', className: "grid size-9 shrink-0 place-items-center rounded-md bg-accent text-accent-fg hover:opacity-90 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent disabled:pointer-events-none disabled:opacity-40", children: _jsx(Send, { className: "size-4 rtl:-scale-x-100", "aria-hidden": "true" }) })] })] }))] }));
+}
+function AiBubble({ turn, locale }) {
+    const own = turn.own;
+    const stamp = turn.sentAt !== undefined && turn.sentAt !== '' ? turn.sentAt : undefined;
+    return (_jsxs("div", { "data-part": "ai-turn", "data-role": turn.role, className: `flex items-start gap-2 ${own ? 'justify-end' : 'justify-start'}`, children: [!own && _jsx(IconTile, { size: "sm", tone: "accent", icon: _jsx(Sparkles, {}), className: "mt-0.5 shrink-0" }), _jsxs("div", { "data-part": "ai-bubble", className: `max-w-[80%] rounded-2xl px-3 py-2 text-body-sm leading-relaxed ${own ? 'rounded-ee-sm bg-accent text-accent-fg' : 'rounded-es-sm border border-border bg-surface text-fg'}`, children: [_jsx("p", { className: "whitespace-pre-wrap break-words", children: turn.body }), stamp !== undefined && (_jsx("time", { dateTime: stamp, title: formatAbsoluteTime(stamp, locale), "data-part": "ai-time", className: `mt-1 block font-mono text-[9.5px] tabular-nums ${own ? 'text-end text-accent-fg/70' : 'text-start text-fg-subtle'}`, children: fmtClock(locale, stamp) }))] })] }));
+}
+function turnsOf(data, config) {
+    return chatRowsOf(data).map((row, index) => {
+        const sentAt = stringField(row, config.sentAtField);
+        return {
+            id: row['id'] ?? index,
+            role: stringField(row, config.roleField) === 'user' ? 'user' : 'assistant',
+            body: stringField(row, config.bodyField) ?? '',
+            sentAt: sentAt ?? new Date(CHAT_DEMO_EPOCH).toISOString(),
+        };
+    });
+}
+export function AiChatPanelWidget({ config, data, onEvent }) {
+    const turns = turnsOf(data, config);
+    const source = sourceOf(config.binding);
+    return (_jsx(AiChatPanel, { turns: turns, suggestions: config.suggestions, providerConfigured: config.providerConfigured, pending: config.pending, ...(config.providerLabel === undefined ? {} : { providerLabel: config.providerLabel }), ...(config.assistantName === undefined ? {} : { assistantName: config.assistantName }), ...(config.composerPlaceholder === undefined ? {} : { composerPlaceholder: config.composerPlaceholder }), ...(config.sendLabel === undefined ? {} : { sendLabel: config.sendLabel }), ...(config.pendingLabel === undefined ? {} : { pendingLabel: config.pendingLabel }), ...(config.configureTitle === undefined ? {} : { configureTitle: config.configureTitle }), ...(config.configureBody === undefined ? {} : { configureBody: config.configureBody }), ...(config.configureCtaLabel === undefined ? {} : { configureCtaLabel: config.configureCtaLabel }), ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.emptyBody === undefined ? {} : { emptyBody: config.emptyBody }), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.testId === undefined ? {} : { testId: config.testId }), 
+        // The host owns the LLM run (POST /api/v1/llm/…): the widget only reports
+        // the prompt as an insert intent against the transcript table.
+        onSend: (prompt) => {
+            onEvent({
+                type: 'mutate',
+                intent: 'insert',
+                ...(source.connectionId === undefined ? {} : { connectionId: source.connectionId }),
+                table: source.table,
+                values: { [config.roleField]: 'user', [config.bodyField]: prompt },
+            });
+        }, ...(config.configureHref === undefined
+            ? {}
+            : {
+                onConfigure: () => {
+                    onEvent({ type: 'drill-through', href: config.configureHref });
+                },
+            }) }));
+}
+//# sourceMappingURL=AiChatPanel.js.map

package/dist/families/communication/AiChatPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiChatPanel.js","sourceRoot":"","sources":["../../../src/families/communication/AiChatPanel.tsx"],"names":[],"mappings":"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"}

package/dist/families/communication/CallWidget.d.ts

@@ -0,0 +1,45 @@
+import type { CallKind, CallState } from './chat-lib.js';
+import type { CallWidgetConfig } from './communication-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { callWidgetConfigSchema, callWidgetDemoData } from './communication-config.js';
+export type { CallWidgetConfig };
+/**
+ * `call-widget` (annex §9) — the ringing state: a large avatar wrapped in an
+ * expanding accent ring, the voice/video kind label, and accept/decline
+ * controls. The annex flags it as niche and says why it is kept: marketplace
+ * apps (a POS support line, a telehealth micro-SaaS).
+ *
+ * A SHELL, NOT A CALL STACK: it renders `{kind, peer, state}` and emits accept /
+ * decline / hang-up as `mutate` intents through `onEvent` (the host runs them
+ * through the CRUD API with audit + undo, 04 §2.1). It never opens a media
+ * device or a peer connection — a marketplace app that wants real WebRTC owns
+ * that and drives this widget's `state` column.
+ *
+ * MOTION: the expanding ring is `motion-safe:animate-ping`, so it is inert under
+ * `prefers-reduced-motion` (02 §6) — the static ring still reads as "ringing",
+ * and the state label carries the meaning for anyone who never sees the
+ * animation at all.
+ *
+ * RTL: centered column flow with logical gaps only; nothing to mirror.
+ */
+export interface CallWidgetProps {
+    peer: string;
+    kind: CallKind;
+    state: CallState;
+    actions?: boolean | undefined;
+    /** Already-translated copy (the host resolves the i18n keys). */
+    kindLabel?: string | undefined;
+    stateLabel?: string | undefined;
+    acceptLabel?: string | undefined;
+    declineLabel?: string | undefined;
+    endLabel?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    onAccept?: (() => void) | undefined;
+    onDecline?: (() => void) | undefined;
+    locale?: string | undefined;
+    testId?: string | undefined;
+}
+export declare function CallWidget({ peer, kind, state, actions, kindLabel, stateLabel, acceptLabel, declineLabel, endLabel, emptyTitle, emptyBody, onAccept, onDecline, locale: localeProp, testId, }: CallWidgetProps): import("react").JSX.Element;
+export declare function CallWidgetWidget({ config, data, onEvent }: WidgetProps<CallWidgetConfig>): import("react").JSX.Element;
+//# sourceMappingURL=CallWidget.d.ts.map

package/dist/families/communication/CallWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallWidget.d.ts","sourceRoot":"","sources":["../../../src/families/communication/CallWidget.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAM3D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACvF,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACpC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAKD,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,OAAc,EACd,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,EACR,SAAS,EACT,MAAM,EAAE,UAAU,EAClB,MAAM,GACP,EAAE,eAAe,+BAkEjB;AAgBD,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,gBAAgB,CAAC,+BA8CxF"}

package/dist/families/communication/CallWidget.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Avatar, Button, EmptyState } from '@adminium/ui';
+import { Phone, PhoneOff, Video } from 'lucide-react';
+import { callKindOf, callStateOf, localeOf, recordRowOf, sourceOf, stringField } from './chat-lib.js';
+// Config schema + deterministic demo payload live in the pure
+// `communication-config` module so the registry metadata graph never eagerly
+// pulls this component's @adminium/ui deps (acceptance #3); re-exported here so
+// the family barrel, stories, and tests keep one import point per widget.
+export { callWidgetConfigSchema, callWidgetDemoData } from './communication-config.js';
+/** Ringing is the only state that pulses; a live call is steady. */
+const RINGS = { ringing: true, connecting: true, active: false, ended: false };
+export function CallWidget({ peer, kind, state, actions = true, kindLabel, stateLabel, acceptLabel, declineLabel, endLabel, emptyTitle, emptyBody, onAccept, onDecline, locale: localeProp, testId, }) {
+    // `format.locale` is a free-string in the shared config, so '' / 'x-1' are
+    // schema-valid and would throw out of Avatar's `toLocaleUpperCase`.
+    const locale = localeOf(localeProp);
+    if (peer.trim() === '') {
+        return (_jsx(EmptyState, { compact: true, preset: "all-caught-up", title: emptyTitle ?? 'No active call', body: emptyBody ?? 'An incoming call will appear here.' }));
+    }
+    const ringing = RINGS[state];
+    const ended = state === 'ended';
+    const KindIcon = kind === 'video' ? Video : Phone;
+    return (_jsxs("div", { "data-widget": "call-widget", "data-testid": testId, "data-call-state": state, "data-call-kind": kind, className: "flex h-full flex-col items-center justify-center gap-4 p-6 text-center compact:gap-3 compact:p-4", children: [_jsxs("div", { className: "relative flex items-center justify-center", children: [ringing && (_jsx("span", { "aria-hidden": "true", "data-part": "call-ring", className: "absolute inset-0 rounded-full border-2 border-accent motion-safe:animate-ping" })), _jsx(Avatar, { name: peer, size: "2xl", locale: locale })] }), _jsxs("div", { className: "flex flex-col items-center gap-1", children: [_jsx("p", { className: "text-body font-bold text-fg", children: peer }), _jsxs("p", { "data-part": "call-kind", className: "flex items-center gap-1.5 text-caption font-medium text-fg-muted", children: [_jsx(KindIcon, { "aria-hidden": "true", className: "size-3.5" }), kindLabel ?? (kind === 'video' ? 'Video call' : 'Voice call')] }), _jsx("p", { "data-part": "call-state", className: "text-caption text-fg-subtle", children: stateLabel ?? state })] }), actions && !ended && (_jsxs("div", { className: "flex items-center gap-3", children: [state === 'ringing' && (_jsx(Button, { size: "sm", variant: "primary", iconLeft: _jsx(Phone, {}), onClick: onAccept, children: acceptLabel ?? 'Accept' })), _jsx(Button, { size: "sm", variant: "destructive", iconLeft: _jsx(PhoneOff, {}), onClick: onDecline, children: state === 'active' ? (endLabel ?? 'End call') : (declineLabel ?? 'Decline') })] }))] }));
+}
+/** The already-translated label for a call state, from the per-state config keys. */
+function stateLabelOf(state, config) {
+    switch (state) {
+        case 'ringing':
+            return config.ringingLabel;
+        case 'connecting':
+            return config.connectingLabel;
+        case 'active':
+            return config.activeLabel;
+        case 'ended':
+            return config.endedLabel;
+    }
+}
+export function CallWidgetWidget({ config, data, onEvent }) {
+    const row = recordRowOf(data);
+    const kind = callKindOf(row?.[config.kindField]);
+    const state = callStateOf(row?.[config.stateField]);
+    const peer = row === null ? '' : (stringField(row, config.peerField) ?? '');
+    const source = sourceOf(config.binding);
+    const rawId = row?.['id'];
+    const recordId = typeof rawId === 'string' || typeof rawId === 'number' ? rawId : undefined;
+    /** Accept/decline are state transitions on the call row — the host writes them. */
+    const transition = (next) => {
+        onEvent({
+            type: 'mutate',
+            intent: 'update',
+            ...(source.connectionId === undefined ? {} : { connectionId: source.connectionId }),
+            table: source.table,
+            ...(recordId === undefined ? {} : { recordId }),
+            values: { [config.stateField]: next },
+        });
+    };
+    return (_jsx(CallWidget, { peer: peer, kind: kind, state: state, actions: config.actions, ...(kind === 'video'
+            ? config.videoLabel === undefined
+                ? {}
+                : { kindLabel: config.videoLabel }
+            : config.voiceLabel === undefined
+                ? {}
+                : { kindLabel: config.voiceLabel }), ...(stateLabelOf(state, config) === undefined ? {} : { stateLabel: stateLabelOf(state, config) }), ...(config.acceptLabel === undefined ? {} : { acceptLabel: config.acceptLabel }), ...(config.declineLabel === undefined ? {} : { declineLabel: config.declineLabel }), ...(config.endLabel === undefined ? {} : { endLabel: config.endLabel }), ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.emptyBody === undefined ? {} : { emptyBody: config.emptyBody }), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.testId === undefined ? {} : { testId: config.testId }), onAccept: () => transition('active'), onDecline: () => transition('ended') }));
+}
+//# sourceMappingURL=CallWidget.js.map

package/dist/families/communication/CallWidget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallWidget.js","sourceRoot":"","sources":["../../../src/families/communication/CallWidget.tsx"],"names":[],"mappings":"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"}

package/dist/families/communication/ChatThread.d.ts

@@ -0,0 +1,49 @@
+import type { ChatMessage } from './chat-lib.js';
+import type { ChatThreadConfig } from './communication-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { chatThreadConfigSchema, chatThreadDemoData } from './communication-config.js';
+export type { ChatThreadConfig };
+/**
+ * `chat-thread` (annex §9) — grouped message bubbles for one conversation:
+ * sender-aware styling, an avatar on the first message of each author-run, a
+ * mono timestamp on the last, day separators between day groups, attachment
+ * chips, and a composer.
+ *
+ * RTL IS STRUCTURAL, NOT COSMETIC (10 §5.2 / acceptance #9): own messages align
+ * to the INLINE-END edge via `justify-end` — flexbox `flex-end` resolves along
+ * the writing direction, so the bubbles genuinely swap sides under `dir="rtl"`
+ * rather than merely re-labelling. The asymmetric bubble corner uses the LOGICAL
+ * corner utilities (`rounded-ee-*` on own, `rounded-es-*` on other), so the
+ * "tail" corner tracks the same edge the bubble is docked to in both directions.
+ * There is not one physical `ml-/mr-/left-/right-/rounded-br-` utility in here.
+ *
+ * Binds to an ordered `record-list` of messages whose author/body/sentAt/
+ * attachments columns are named in config. Ports designs/Chat.dc.html (thread).
+ */
+export interface ChatThreadProps {
+    messages: readonly ChatMessage[];
+    peerName?: string | undefined;
+    peerStatus?: string | undefined;
+    peerOnline?: boolean | undefined;
+    composer?: boolean | undefined;
+    composerPlaceholder?: string | undefined;
+    sendLabel?: string | undefined;
+    attachments?: boolean | undefined;
+    attachLabel?: string | undefined;
+    typingIndicator?: boolean | undefined;
+    typingLabel?: string | undefined;
+    daySeparators?: boolean | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    onSend?: ((body: string) => void) | undefined;
+    onAttach?: (() => void) | undefined;
+    /** Injectable clock for deterministic "Today"/"Yesterday" separators. */
+    now?: number | undefined;
+    locale?: string | undefined;
+    /** Story/VRT only: render inside an explicit direction context. */
+    dir?: 'ltr' | 'rtl' | undefined;
+    testId?: string | undefined;
+}
+export declare function ChatThread({ messages, peerName, peerStatus, peerOnline, composer, composerPlaceholder, sendLabel, attachments, attachLabel, typingIndicator, typingLabel, daySeparators, emptyTitle, emptyBody, onSend, onAttach, now, locale: localeProp, dir, testId, }: ChatThreadProps): import("react").JSX.Element;
+export declare function ChatThreadWidget({ config, data, onEvent }: WidgetProps<ChatThreadConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ChatThread.d.ts.map

package/dist/families/communication/ChatThread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatThread.d.ts","sourceRoot":"","sources":["../../../src/families/communication/ChatThread.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAA8B,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAM3D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACvF,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACpC,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,mEAAmE;IACnE,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAkB,EAClB,QAAe,EACf,mBAAmB,EACnB,SAAS,EACT,WAAkB,EAClB,WAAW,EACX,eAAuB,EACvB,WAAW,EACX,aAAoB,EACpB,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,EACR,GAAqB,EACrB,MAAM,EAAE,UAAU,EAClB,GAAG,EACH,MAAM,GACP,EAAE,eAAe,+BAmHjB;AAkGD,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,gBAAgB,CAAC,+BAkCxF"}

package/dist/families/communication/ChatThread.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Avatar, EmptyState, Input, Tag } from '@adminium/ui';
+import { Paperclip, Send } from 'lucide-react';
+import { useState } from 'react';
+import { TypingIndicator } from './TypingIndicator.js';
+import { chatRowsOf, fmtClock, fmtDaySeparator, formatAbsoluteTime, groupMessages, localeOf, sourceOf, toChatMessage, CHAT_DEMO_EPOCH, } from './chat-lib.js';
+// Config schema + deterministic demo payload live in the pure
+// `communication-config` module so the registry metadata graph never eagerly
+// pulls this component's @adminium/ui deps (acceptance #3); re-exported here so
+// the family barrel, stories, and tests keep one import point per widget.
+export { chatThreadConfigSchema, chatThreadDemoData } from './communication-config.js';
+export function ChatThread({ messages, peerName, peerStatus, peerOnline = false, composer = true, composerPlaceholder, sendLabel, attachments = true, attachLabel, typingIndicator = false, typingLabel, daySeparators = true, emptyTitle, emptyBody, onSend, onAttach, now = CHAT_DEMO_EPOCH, locale: localeProp, dir, testId, }) {
+    // `format.locale` is a free-string in the shared config, so '' / 'x-1' are
+    // schema-valid and would throw out of every Intl call. Normalize at the edge.
+    const locale = localeOf(localeProp);
+    const [draft, setDraft] = useState('');
+    const groups = groupMessages(messages);
+    const submit = (event) => {
+        event.preventDefault();
+        const body = draft.trim();
+        if (body === '')
+            return;
+        onSend?.(body);
+        setDraft('');
+    };
+    return (_jsxs("div", { "data-widget": "chat-thread", "data-testid": testId, ...(dir === undefined ? {} : { dir }), className: "flex h-full flex-col", children: [peerName !== undefined && (_jsxs("div", { className: "flex items-center gap-3 border-b border-border/60 px-4 py-3", children: [_jsx(Avatar, { name: peerName, size: "md", locale: locale, ...(peerOnline ? { presence: 'pos' } : {}) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "truncate text-body-sm font-bold text-fg", children: peerName }), peerStatus !== undefined && (_jsx("div", { className: `truncate text-caption ${peerOnline ? 'text-pos' : 'text-fg-subtle'}`, children: peerStatus }))] })] })), messages.length === 0 ? (_jsx("div", { className: "flex-1", children: _jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'No messages yet', body: emptyBody ?? 'Messages in this conversation will appear here.' }) })) : (_jsxs("div", { "data-part": "thread-scroll", className: "flex flex-1 flex-col gap-1 overflow-auto p-4", children: [groups.map((group) => (_jsxs("div", { "data-part": "day-group", "data-day": group.key, children: [daySeparators && (_jsxs("div", { "data-part": "day-separator", className: "flex items-center gap-3 py-3", children: [_jsx("span", { className: "h-px flex-1 bg-border" }), _jsx("span", { className: "whitespace-nowrap font-mono text-caption font-bold uppercase tracking-wide text-fg-subtle", children: fmtDaySeparator(locale, group.date, now) }), _jsx("span", { className: "h-px flex-1 bg-border" })] })), group.bubbles.map((bubble) => (_jsx(Bubble, { bubble: bubble, locale: locale, showAttachments: attachments }, bubble.id)))] }, group.key))), _jsx(TypingIndicator, { typing: typingIndicator, typists: peerName === undefined ? [] : [peerName], locale: locale, ...(typingLabel === undefined ? {} : { label: typingLabel }) })] })), composer && (_jsxs("form", { "data-part": "composer", onSubmit: submit, className: "flex items-center gap-2 border-t border-border/60 p-3", children: [attachments && (_jsx("button", { type: "button", "data-part": "attach-button", "aria-label": attachLabel ?? 'Add attachment', onClick: onAttach, className: "grid size-8 shrink-0 place-items-center rounded-md text-fg-subtle hover:bg-surface-2 hover:text-fg-muted focus-visible:outline-2 focus-visible:outline-accent", children: _jsx(Paperclip, { className: "size-4", "aria-hidden": "true" }) })), _jsx(Input, { "aria-label": composerPlaceholder ?? 'Message', placeholder: composerPlaceholder ?? 'Write a message…', value: draft, onChange: (event) => setDraft(event.currentTarget.value) }), _jsx("button", { type: "submit", "data-part": "send-button", "aria-label": sendLabel ?? 'Send', disabled: draft.trim() === '', className: "grid size-9 shrink-0 place-items-center rounded-md bg-accent text-accent-fg hover:opacity-90 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent disabled:pointer-events-none disabled:opacity-40", children: _jsx(Send, { className: "size-4 rtl:-scale-x-100", "aria-hidden": "true" }) })] }))] }));
+}
+/**
+ * One message bubble. `justify-end` docks own messages to the inline-end edge
+ * (mirrors under RTL); the squared "tail" corner is the LOGICAL end-end corner
+ * on own bubbles and the end-start corner on incoming ones.
+ */
+function Bubble({ bubble, locale, showAttachments, }) {
+    const own = bubble.own;
+    return (_jsxs("div", { "data-part": "message-row", "data-own": own ? '' : undefined, "data-starts-run": bubble.startsRun ? '' : undefined, className: `flex items-end gap-2 ${own ? 'justify-end' : 'justify-start'} ${bubble.startsRun ? 'mt-2.5' : 'mt-0.5'}`, children: [!own &&
+                (bubble.startsRun ? (_jsx(Avatar, { name: bubble.author ?? '', size: "sm", locale: locale, className: "mb-0.5" })) : (
+                // Keeps the run's bubbles flush with the first one's inline edge.
+                _jsx("span", { "data-part": "avatar-spacer", className: "size-6 shrink-0", "aria-hidden": "true" }))), _jsxs("div", { "data-part": "message-bubble", className: `max-w-[68%] rounded-2xl px-3 py-2 text-body-sm leading-relaxed ${own
+                    ? 'rounded-ee-sm bg-accent text-accent-fg'
+                    : 'rounded-es-sm border border-border bg-surface text-fg'}`, children: [!own && bubble.startsRun && bubble.author !== undefined && (_jsx("div", { "data-part": "message-author", className: "mb-0.5 text-caption font-bold text-fg-muted", children: bubble.author })), _jsx("p", { className: "whitespace-pre-wrap break-words", children: bubble.body }), showAttachments && bubble.attachments !== undefined && bubble.attachments.length > 0 && (_jsx("ul", { "data-part": "attachment-chips", className: "mt-1.5 flex flex-wrap gap-1", children: bubble.attachments.map((file) => (_jsx("li", { children: _jsx(AttachmentChip, { file: file, own: own }) }, file.name))) })), bubble.endsRun && (_jsx("time", { dateTime: bubble.sentAt, title: formatAbsoluteTime(bubble.sentAt, locale), "data-part": "message-time", className: `mt-1 block font-mono text-[9.5px] tabular-nums ${own ? 'text-end text-accent-fg/70' : 'text-start text-fg-subtle'}`, children: fmtClock(locale, bubble.sentAt) }))] })] }));
+}
+function AttachmentChip({ file, own }) {
+    return (_jsxs(Tag, { "data-part": "attachment-chip", tone: own ? 'neutral' : 'accent', className: own ? 'bg-accent-fg/15 text-accent-fg' : '', children: [_jsx(Paperclip, { className: "size-2.5", "aria-hidden": "true" }), _jsx("span", { className: "max-w-[10rem] truncate", children: file.name }), file.size !== undefined && _jsx("span", { className: "font-mono tabular-nums opacity-70", children: file.size })] }));
+}
+function messagesOf(data, config) {
+    return chatRowsOf(data).map((row, index) => toChatMessage(row, index, {
+        authorField: config.authorField,
+        bodyField: config.bodyField,
+        sentAtField: config.sentAtField,
+        attachmentsField: config.attachmentsField,
+        ownField: config.ownField,
+        ...(config.ownAuthor === undefined ? {} : { ownAuthor: config.ownAuthor }),
+    }));
+}
+export function ChatThreadWidget({ config, data, onEvent }) {
+    const messages = messagesOf(data, config);
+    const source = sourceOf(config.binding);
+    return (_jsx(ChatThread, { messages: messages, composer: config.composer, attachments: config.attachments, typingIndicator: config.typingIndicator, daySeparators: config.daySeparators, peerOnline: config.peerOnline, ...(config.peerName === undefined ? {} : { peerName: config.peerName }), ...(config.peerStatus === undefined ? {} : { peerStatus: config.peerStatus }), ...(config.composerPlaceholder === undefined ? {} : { composerPlaceholder: config.composerPlaceholder }), ...(config.sendLabel === undefined ? {} : { sendLabel: config.sendLabel }), ...(config.typingLabel === undefined ? {} : { typingLabel: config.typingLabel }), ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.emptyBody === undefined ? {} : { emptyBody: config.emptyBody }), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.format?.referenceTime === undefined ? {} : { now: config.format.referenceTime }), ...(config.testId === undefined ? {} : { testId: config.testId }), 
+        // Sending is a mutation INTENT — the host runs the INSERT through the CRUD
+        // API (with audit + undo); the widget never writes (04 §2.1).
+        onSend: (body) => {
+            onEvent({
+                type: 'mutate',
+                intent: 'insert',
+                ...(source.connectionId === undefined ? {} : { connectionId: source.connectionId }),
+                table: source.table,
+                values: { [config.bodyField]: body },
+            });
+        } }));
+}
+//# sourceMappingURL=ChatThread.js.map

package/dist/families/communication/ChatThread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatThread.js","sourceRoot":"","sources":["../../../src/families/communication/ChatThread.tsx"],"names":[],"mappings":"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"}

package/dist/families/communication/ConversationInbox.d.ts

@@ -0,0 +1,47 @@
+import type { ConversationInboxConfig } from './communication-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { conversationInboxConfigSchema, conversationInboxDemoData } from './communication-config.js';
+export type { ConversationInboxConfig };
+/**
+ * `conversation-inbox` (annex §9) — selectable conversation rows: avatar with a
+ * presence dot, name, relative time, last-message preview (bold when unread),
+ * and an unread count pill. Selecting a row clears its unread state and emits
+ * `onSelect(id)`, which the page wires to a sibling `chat-thread` (annex §14:
+ * conversations + messages tables → an inbox + thread page).
+ *
+ * The selected row is marked by a `border-s-2` accent rail + accent-soft tint —
+ * a LOGICAL inline-start border, so it moves to the right edge under `dir="rtl"`
+ * (10 §5.2). Ports designs/Chat.dc.html (conversation list pane).
+ */
+export interface ConversationRow {
+    id: string | number;
+    name: string;
+    preview?: string | undefined;
+    /** ISO 8601 timestamp of the last message. */
+    ts?: string | undefined;
+    unread?: number | undefined;
+    online?: boolean | undefined;
+    group?: boolean | undefined;
+}
+export interface ConversationInboxProps {
+    conversations: readonly ConversationRow[];
+    /** Controlled selection; falls back to the first row when unset. */
+    selectedId?: string | number | undefined;
+    onSelect?: ((id: string | number) => void) | undefined;
+    presence?: boolean | undefined;
+    groupChats?: boolean | undefined;
+    searchable?: boolean | undefined;
+    searchLabel?: string | undefined;
+    searchPlaceholder?: string | undefined;
+    clearUnreadOnSelect?: boolean | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    noMatchesTitle?: string | undefined;
+    /** Injectable clock for deterministic relative timestamps. */
+    now?: number | undefined;
+    locale?: string | undefined;
+    testId?: string | undefined;
+}
+export declare function ConversationInbox({ conversations, selectedId, onSelect, presence, groupChats, searchable, searchLabel, searchPlaceholder, clearUnreadOnSelect, emptyTitle, emptyBody, noMatchesTitle, now, locale: localeProp, testId, }: ConversationInboxProps): import("react").JSX.Element;
+export declare function ConversationInboxWidget({ config, data, onEvent }: WidgetProps<ConversationInboxConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ConversationInbox.d.ts.map

package/dist/families/communication/ConversationInbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationInbox.d.ts","sourceRoot":"","sources":["../../../src/families/communication/ConversationInbox.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAM3D,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACrG,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAExC;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,mBAAmB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,iBAAiB,CAAC,EAChC,aAAa,EACb,UAAU,EACV,QAAQ,EACR,QAAe,EACf,UAAiB,EACjB,UAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,mBAA0B,EAC1B,UAAU,EACV,SAAS,EACT,cAAc,EACd,GAAG,EACH,MAAM,EAAE,UAAU,EAClB,MAAM,GACP,EAAE,sBAAsB,+BA8HxB;AAkBD,wBAAgB,uBAAuB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,uBAAuB,CAAC,+BA6BtG"}

package/dist/families/communication/ConversationInbox.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Avatar, CountBadge, EmptyState, SearchInput } from '@adminium/ui';
+import { Users } from 'lucide-react';
+import { useMemo, useState } from 'react';
+import { boolField, chatRowsOf, fmtCount, formatAbsoluteTime, formatRelativeTime, localeOf, numberField, sourceOf, stringField, } from './chat-lib.js';
+// Config schema + deterministic demo payload live in the pure
+// `communication-config` module so the registry metadata graph never eagerly
+// pulls this component's @adminium/ui deps (acceptance #3); re-exported here so
+// the family barrel, stories, and tests keep one import point per widget.
+export { conversationInboxConfigSchema, conversationInboxDemoData } from './communication-config.js';
+export function ConversationInbox({ conversations, selectedId, onSelect, presence = true, groupChats = true, searchable = false, searchLabel, searchPlaceholder, clearUnreadOnSelect = true, emptyTitle, emptyBody, noMatchesTitle, now, locale: localeProp, testId, }) {
+    // `format.locale` is a free-string in the shared config, so '' / 'x-1' are
+    // schema-valid and would throw out of every Intl call (and out of
+    // toLocaleLowerCase below). Normalize once, at the boundary.
+    const locale = localeOf(localeProp);
+    const [query, setQuery] = useState('');
+    // Uncontrolled selection + locally-cleared unread ids: the widget owns its
+    // interaction state; the host learns about it through `onSelect`.
+    const [internalId, setInternalId] = useState(undefined);
+    const [readIds, setReadIds] = useState(new Set());
+    const activeId = selectedId ?? internalId ?? conversations[0]?.id;
+    const visible = useMemo(() => {
+        const needle = query.trim().toLocaleLowerCase(locale);
+        if (needle === '')
+            return conversations;
+        return conversations.filter((row) => row.name.toLocaleLowerCase(locale).includes(needle) ||
+            (row.preview ?? '').toLocaleLowerCase(locale).includes(needle));
+    }, [conversations, query, locale]);
+    if (conversations.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "all-caught-up", title: emptyTitle ?? 'No conversations', body: emptyBody ?? 'Conversations will appear here as messages arrive.' }));
+    }
+    const select = (id) => {
+        if (selectedId === undefined)
+            setInternalId(id);
+        if (clearUnreadOnSelect)
+            setReadIds((previous) => new Set(previous).add(id));
+        onSelect?.(id);
+    };
+    return (_jsxs("div", { "data-widget": "conversation-inbox", "data-testid": testId, className: "flex h-full flex-col", children: [searchable && (_jsx("div", { className: "border-b border-border/60 p-3", children: _jsx(SearchInput, { "aria-label": searchLabel ?? 'Search conversations', placeholder: searchPlaceholder ?? 'Search conversations…', value: query, onChange: (event) => setQuery(event.currentTarget.value), onClear: () => setQuery(''), clearLabel: searchLabel ?? 'Search conversations' }) })), visible.length === 0 ? (_jsx(EmptyState, { compact: true, preset: "no-matches", title: noMatchesTitle ?? 'No conversations match', body: emptyBody ?? undefined })) : (_jsx("ul", { className: "flex-1 overflow-auto", children: visible.map((row) => {
+                    const selected = row.id === activeId;
+                    const unread = readIds.has(row.id) ? 0 : (row.unread ?? 0);
+                    return (_jsx("li", { children: _jsxs("button", { type: "button", "data-part": "conversation-row", "data-conversation-id": String(row.id), "data-selected": selected ? '' : undefined, "data-unread": unread > 0 ? '' : undefined, "aria-current": selected ? 'true' : undefined, onClick: () => select(row.id), className: `flex w-full items-center gap-3 border-s-2 px-3 py-3 text-start transition-colors focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-accent ${selected ? 'border-s-accent bg-accent-soft' : 'border-s-transparent hover:bg-surface-2/60'}`, children: [_jsx(Avatar, { name: row.name, size: "lg", locale: locale, ...(presence && row.online === true ? { presence: 'pos' } : {}) }), _jsxs("span", { className: "flex min-w-0 flex-1 flex-col gap-0.5", children: [_jsxs("span", { className: "flex items-center gap-1.5", children: [groupChats && row.group === true && (_jsx(Users, { "data-part": "group-glyph", className: "size-3 shrink-0 text-fg-subtle", "aria-hidden": "true" })), _jsx("span", { className: "min-w-0 flex-1 truncate text-body-sm font-bold text-fg", children: row.name }), row.ts !== undefined && (_jsx("time", { dateTime: row.ts, title: formatAbsoluteTime(row.ts, locale), className: "shrink-0 whitespace-nowrap font-mono text-caption tabular-nums text-fg-subtle", children: formatRelativeTime(row.ts, { locale, ...(now === undefined ? {} : { now }) }) }))] }), _jsxs("span", { className: "flex items-center gap-1.5", children: [_jsx("span", { "data-part": "conversation-preview", className: `min-w-0 flex-1 truncate text-caption ${unread > 0 ? 'font-bold text-fg' : 'font-medium text-fg-muted'}`, children: row.preview ?? '' }), unread > 0 && (_jsx(CountBadge, { active: true, "data-part": "unread-pill", className: "shrink-0", children: fmtCount(locale, unread) }))] })] })] }) }, row.id));
+                }) }))] }));
+}
+function conversationsOf(data, config) {
+    return chatRowsOf(data).map((row, index) => {
+        const preview = stringField(row, config.previewField);
+        const ts = stringField(row, config.sentAtField);
+        return {
+            id: row['id'] ?? index,
+            name: stringField(row, config.nameField) ?? '',
+            ...(preview === undefined ? {} : { preview }),
+            ...(ts === undefined ? {} : { ts }),
+            unread: numberField(row, config.unreadField),
+            online: boolField(row, config.onlineField),
+            group: boolField(row, config.groupField),
+        };
+    });
+}
+export function ConversationInboxWidget({ config, data, onEvent }) {
+    const conversations = conversationsOf(data, config);
+    const source = sourceOf(config.binding);
+    return (_jsx(ConversationInbox, { conversations: conversations, presence: config.presence, groupChats: config.groupChats, searchable: config.searchable, clearUnreadOnSelect: config.clearUnreadOnSelect, ...(config.searchLabel === undefined ? {} : { searchLabel: config.searchLabel }), ...(config.searchPlaceholder === undefined ? {} : { searchPlaceholder: config.searchPlaceholder }), ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.emptyBody === undefined ? {} : { emptyBody: config.emptyBody }), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.format?.referenceTime === undefined ? {} : { now: config.format.referenceTime }), ...(config.testId === undefined ? {} : { testId: config.testId }), onSelect: (id) => {
+            // Selection is a record-open intent: the page host focuses the sibling
+            // chat-thread on this conversation (annex §14 inbox + thread pairing).
+            onEvent({
+                type: 'record-open',
+                ...(source.connectionId === undefined ? {} : { connectionId: source.connectionId }),
+                table: source.table,
+                recordId: id,
+            });
+        } }));
+}
+//# sourceMappingURL=ConversationInbox.js.map

package/dist/families/communication/ConversationInbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationInbox.js","sourceRoot":"","sources":["../../../src/families/communication/ConversationInbox.tsx"],"names":[],"mappings":"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"}

package/dist/families/communication/TypingIndicator.d.ts

@@ -0,0 +1,40 @@
+import type { TypingIndicatorConfig } from './communication-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { typingIndicatorConfigSchema, typingIndicatorDemoData } from './communication-config.js';
+export type { TypingIndicatorConfig };
+/**
+ * `typing-indicator` (annex §9) — "Avatar + italic 'typing…' row bound to a
+ * boolean". Binds to a `boolean-map` keyed by conversation id and renders the
+ * peer's avatar (or the group's typists) beside an italic label and three
+ * staggered pulsing dots.
+ *
+ * ALSO THE THREAD'S OWN TYPING ROW: `chat-thread` renders this same component
+ * for its inline `typingIndicator` config rather than duplicating the markup —
+ * the annex places this widget as a "child of thread", so one implementation
+ * serves both the registered standalone instance and the embedded row. Both live
+ * in the family's single lazy chunk, so the reuse costs no extra bytes.
+ *
+ * IDLE RENDERS NOTHING, DELIBERATELY: a typing indicator is ephemeral, and it is
+ * a `placement: 'inline'` widget (no WidgetFrame card of its own), so an idle
+ * instance must occupy no space rather than leave a titled empty box in the
+ * thread. The `aria-live="polite"` wrapper stays mounted across the transition
+ * so assistive tech announces the row when it appears — an element that is
+ * itself inserted with `aria-live` on it is not reliably announced.
+ *
+ * RTL: pure logical flow (`flex` + `gap`), so the row mirrors with the thread.
+ */
+export interface TypingIndicatorProps {
+    /** Whether anyone is currently typing (the bound boolean). */
+    typing: boolean;
+    /** Names to show avatars for; empty → label only. */
+    typists?: readonly string[] | undefined;
+    /** Italic copy; already translated by the host. */
+    label?: string | undefined;
+    showAvatar?: boolean | undefined;
+    maxAvatars?: number | undefined;
+    locale?: string | undefined;
+    testId?: string | undefined;
+}
+export declare function TypingIndicator({ typing, typists, label, showAvatar, maxAvatars, locale: localeProp, testId, }: TypingIndicatorProps): import("react").JSX.Element;
+export declare function TypingIndicatorWidget({ config, data }: WidgetProps<TypingIndicatorConfig>): import("react").JSX.Element;
+//# sourceMappingURL=TypingIndicator.d.ts.map

package/dist/families/communication/TypingIndicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypingIndicator.d.ts","sourceRoot":"","sources":["../../../src/families/communication/TypingIndicator.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAM3D,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACjG,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,MAAM,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAkBD,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,OAAO,EACP,KAAK,EACL,UAAiB,EACjB,UAAc,EACd,MAAM,EAAE,UAAU,EAClB,MAAM,GACP,EAAE,oBAAoB,+BA+BtB;AAED,wBAAgB,qBAAqB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,qBAAqB,CAAC,+BAkBzF"}