@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/chrome/Breadcrumb.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * `breadcrumb` (annex §11) — ancestor chain from parent pointers, clickable,
+ * separator glyph, RTL-aware. Evidence: File Manager.
+ *
+ * Wraps @adminium/ui's `Breadcrumbs`, which already owns the separator chevron
+ * and its RTL mirroring; this file adds the record-list binding, the deep-trail
+ * collapse, and routes clicks through `onEvent`.
+ */
+import { Breadcrumbs } from '@adminium/ui';
+import { collapseTrail } from './chrome-lib.js';
+import { breadcrumbConfigSchema, breadcrumbDemoData } from './chrome-config.js';
+import { isSafeHref, recordRowsOf, stringField } from './chrome-lib.js';
+export { breadcrumbConfigSchema, breadcrumbDemoData };
+/** Project the §3 `record-list` payload onto the ordered ancestor trail. */
+export function crumbsOf(data, config) {
+    const rows = recordRowsOf(data);
+    const out = [];
+    for (const [index, row] of rows.entries()) {
+        const label = stringField(row, config.labelField);
+        if (label === undefined)
+            continue;
+        const href = stringField(row, config.hrefField);
+        out.push({
+            id: stringField(row, config.idField) ?? `crumb-${index}`,
+            label,
+            ...(isSafeHref(href) ? { href } : {}),
+        });
+    }
+    return out;
+}
+export function BreadcrumbWidget({ config, data, onEvent }) {
+    const crumbs = crumbsOf(data, config);
+    const shown = collapseTrail(crumbs, config.maxDepth);
+    if (shown.length === 0)
+        return null;
+    return (_jsx("div", { className: "flex h-full items-center px-4 pb-4", "data-widget": "breadcrumb", "data-testid": config.testId, children: _jsx(Breadcrumbs, { label: config.a11yLabel ?? 'Breadcrumb', items: shown.map((crumb) => crumb === null
+                ? // The collapsed middle: a non-interactive ellipsis, never a link.
+                    { label: '…' }
+                : {
+                    label: crumb.label,
+                    ...(crumb.href === undefined
+                        ? {}
+                        : { onClick: () => onEvent({ type: 'drill-through', href: crumb.href }) }),
+                }) }) }));
+}
+//# sourceMappingURL=Breadcrumb.js.map

package/dist/families/chrome/Breadcrumb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Breadcrumb.js","sourceRoot":"","sources":["../../../src/families/chrome/Breadcrumb.tsx"],"names":[],"mappings":";AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGxE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,CAAC;AAStD,4EAA4E;AAC5E,MAAM,UAAU,QAAQ,CAAC,IAAa,EAAE,MAAwB;IAC9D,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,GAAG,GAAY,EAAE,CAAC;IACxB,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAChD,GAAG,CAAC,IAAI,CAAC;YACP,EAAE,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,SAAS,KAAK,EAAE;YACxD,KAAK;YACL,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAiC;IACvF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAErD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,OAAO,CACL,cAAK,SAAS,EAAC,oCAAoC,iBAAa,YAAY,iBAAc,MAAM,CAAC,MAAM,YACrG,KAAC,WAAW,IACV,KAAK,EAAE,MAAM,CAAC,SAAS,IAAI,YAAY,EACvC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACzB,KAAK,KAAK,IAAI;gBACZ,CAAC,CAAC,kEAAkE;oBAClE,EAAE,KAAK,EAAE,GAAG,EAAE;gBAChB,CAAC,CAAC;oBACE,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;wBAC1B,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAc,EAAE,CAAC,EAAE,CAAC;iBACvF,CACN,GACD,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/families/chrome/CommandPaletteWidget.d.ts

@@ -0,0 +1,46 @@
+/**
+ * `command-palette` (annex §11) — ⌘K modal: live substring filter over an index,
+ * grouped results in fixed order, keyboard navigation, ↵ executes/navigates,
+ * match highlighting, footer key legend, empty state. The generator builds its
+ * index from tables, recent records, metrics and actions (annex §11
+ * auto-instantiation: "the app shell always mounts … `command-palette`").
+ *
+ * Wraps @adminium/ui's `CommandPalette` + `useCommandK`, which own the dialog
+ * shell, the `aria-activedescendant` combobox semantics, the ↑↓-wrap keyboard
+ * model, match filtering and the footer legend. This file adds the `record-list`
+ * index binding, the fixed group ordering, and `drill-through` on select.
+ *
+ * SELF-MOUNTING (`placement: 'overlay'`): the widget binds ⌘K itself rather than
+ * exposing an `open` prop, because `WidgetProps` has no channel for host-owned
+ * open state — mounting the widget IS wiring the hotkey. It renders nothing
+ * until triggered.
+ */
+import type { CommandGroupKey } from './chrome-lib.js';
+import { commandPaletteConfigSchema, commandPaletteDemoData } from './chrome-config.js';
+import type { CommandPaletteConfig } from './chrome-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { commandPaletteConfigSchema, commandPaletteDemoData };
+export type { CommandPaletteConfig };
+export interface CommandEntry {
+    id: string;
+    group: CommandGroupKey;
+    label: string;
+    sub?: string | undefined;
+    icon?: string | undefined;
+    href?: string | undefined;
+    shortcut?: string | undefined;
+}
+/** Project the §3 `record-list` index payload onto palette entries. */
+export declare function commandEntriesOf(data: unknown, config: CommandPaletteConfig): CommandEntry[];
+/**
+ * Bucket entries into the manifest's fixed group order (annex §11 "grouped
+ * results in fixed order"). Groups the index carries but the order does not
+ * render AFTER the ordered ones — a new index group must never vanish silently.
+ * Empty groups are dropped.
+ */
+export declare function groupEntries(entries: readonly CommandEntry[], order: readonly CommandGroupKey[], maxPerGroup: number): {
+    key: CommandGroupKey;
+    entries: CommandEntry[];
+}[];
+export declare function CommandPaletteWidget({ config, data, onEvent }: WidgetProps<CommandPaletteConfig>): import("react").JSX.Element;
+//# sourceMappingURL=CommandPaletteWidget.d.ts.map

package/dist/families/chrome/CommandPaletteWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandPaletteWidget.d.ts","sourceRoot":"","sources":["../../../src/families/chrome/CommandPaletteWidget.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAaD,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,oBAAoB,GAAG,YAAY,EAAE,CAkB5F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,WAAW,EAAE,MAAM,GAClB;IAAE,GAAG,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,EAAE,CAmBrD;AAED,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,oBAAoB,CAAC,+BAmDhG"}

package/dist/families/chrome/CommandPaletteWidget.js

@@ -0,0 +1,121 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * `command-palette` (annex §11) — ⌘K modal: live substring filter over an index,
+ * grouped results in fixed order, keyboard navigation, ↵ executes/navigates,
+ * match highlighting, footer key legend, empty state. The generator builds its
+ * index from tables, recent records, metrics and actions (annex §11
+ * auto-instantiation: "the app shell always mounts … `command-palette`").
+ *
+ * Wraps @adminium/ui's `CommandPalette` + `useCommandK`, which own the dialog
+ * shell, the `aria-activedescendant` combobox semantics, the ↑↓-wrap keyboard
+ * model, match filtering and the footer legend. This file adds the `record-list`
+ * index binding, the fixed group ordering, and `drill-through` on select.
+ *
+ * SELF-MOUNTING (`placement: 'overlay'`): the widget binds ⌘K itself rather than
+ * exposing an `open` prop, because `WidgetProps` has no channel for host-owned
+ * open state — mounting the widget IS wiring the hotkey. It renders nothing
+ * until triggered.
+ */
+import { CommandPalette, useCommandK } from '@adminium/ui';
+import { useCallback, useMemo, useState } from 'react';
+import { chromeIcon } from './chrome-icons.js';
+import { COMMAND_GROUPS, DEFAULT_COMMAND_GROUP_ORDER, isSafeHref, oneOf, recordRowsOf, stringField } from './chrome-lib.js';
+import { commandPaletteConfigSchema, commandPaletteDemoData } from './chrome-config.js';
+export { commandPaletteConfigSchema, commandPaletteDemoData };
+/** Developer fallbacks (English); the dashboard passes translated labels via config. */
+const DEFAULT_GROUP_LABELS = {
+    actions: 'Actions',
+    navigate: 'Navigate',
+    recent: 'Recent',
+    pages: 'Pages',
+    metrics: 'Metrics',
+    people: 'People',
+    records: 'Records',
+};
+/** Project the §3 `record-list` index payload onto palette entries. */
+export function commandEntriesOf(data, config) {
+    const rows = recordRowsOf(data);
+    const out = [];
+    for (const [index, row] of rows.entries()) {
+        const label = stringField(row, config.labelField);
+        if (label === undefined)
+            continue;
+        const href = stringField(row, config.hrefField);
+        out.push({
+            id: stringField(row, config.idField) ?? `cmd-${index}`,
+            group: oneOf(row[config.groupField], COMMAND_GROUPS, 'navigate'),
+            label,
+            sub: stringField(row, config.subField),
+            icon: stringField(row, config.iconField),
+            ...(isSafeHref(href) ? { href } : {}),
+            shortcut: stringField(row, config.shortcutField),
+        });
+    }
+    return out;
+}
+/**
+ * Bucket entries into the manifest's fixed group order (annex §11 "grouped
+ * results in fixed order"). Groups the index carries but the order does not
+ * render AFTER the ordered ones — a new index group must never vanish silently.
+ * Empty groups are dropped.
+ */
+export function groupEntries(entries, order, maxPerGroup) {
+    const byGroup = new Map();
+    const seen = [];
+    for (const entry of entries) {
+        if (!byGroup.has(entry.group)) {
+            byGroup.set(entry.group, []);
+            seen.push(entry.group);
+        }
+        byGroup.get(entry.group)?.push(entry);
+    }
+    const ordered = new Set(order);
+    const keys = [...order, ...seen.filter((key) => !ordered.has(key))];
+    const out = [];
+    for (const key of keys) {
+        const bucket = byGroup.get(key);
+        if (bucket !== undefined && bucket.length > 0)
+            out.push({ key, entries: bucket.slice(0, maxPerGroup) });
+    }
+    return out;
+}
+export function CommandPaletteWidget({ config, data, onEvent }) {
+    const [open, setOpen] = useState(false);
+    // The hook re-registers on every identity change, so the toggle is memoized
+    // to keep one listener for the widget's lifetime.
+    const toggle = useCallback(() => setOpen((previous) => !previous), []);
+    useCommandK(toggle);
+    const entries = useMemo(() => commandEntriesOf(data, config), [data, config]);
+    const byId = useMemo(() => new Map(entries.map((entry) => [entry.id, entry])), [entries]);
+    const groups = useMemo(() => {
+        const order = config.groupOrder ?? DEFAULT_COMMAND_GROUP_ORDER;
+        return groupEntries(entries, order, config.maxPerGroup).map((group) => ({
+            id: group.key,
+            label: config.groupLabels?.[group.key] ?? DEFAULT_GROUP_LABELS[group.key],
+            items: group.entries.map((entry) => ({
+                id: entry.id,
+                label: entry.label,
+                icon: chromeIcon(entry.icon),
+                ...(entry.shortcut === undefined ? {} : { hint: entry.shortcut }),
+                // The subtitle (a table name, "Opened yesterday") is real search
+                // surface — feeding it to the filter is why "public.orders" finds Orders.
+                ...(entry.sub === undefined ? {} : { keywords: [entry.sub] }),
+            })),
+        }));
+    }, [entries, config.groupOrder, config.groupLabels, config.maxPerGroup]);
+    return (_jsx("div", { "data-widget": "command-palette", "data-testid": config.testId, children: _jsx(CommandPalette, { open: open, onOpenChange: setOpen, groups: groups, onSelect: (item) => {
+                const href = byId.get(item.id)?.href;
+                if (href !== undefined)
+                    onEvent({ type: 'drill-through', href });
+            }, labels: {
+                dialog: config.title ?? 'Command palette',
+                placeholder: config.placeholder ?? 'Search actions, pages and records…',
+                navigate: config.navigateHint ?? 'Navigate',
+                open: config.selectHint ?? 'Open',
+                close: config.closeHint ?? 'Close',
+                empty: (query) => query === ''
+                    ? (config.emptyBody ?? 'Start typing to search.')
+                    : (config.emptyTitle ?? `No results for "${query}"`),
+            } }) }));
+}
+//# sourceMappingURL=CommandPaletteWidget.js.map

package/dist/families/chrome/CommandPaletteWidget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandPaletteWidget.js","sourceRoot":"","sources":["../../../src/families/chrome/CommandPaletteWidget.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,2BAA2B,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE5H,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAIxF,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,CAAC;AAa9D,wFAAwF;AACxF,MAAM,oBAAoB,GAAoC;IAC5D,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,IAAa,EAAE,MAA4B;IAC1E,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAChD,GAAG,CAAC,IAAI,CAAC;YACP,EAAE,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,EAAE;YACtD,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC;YAChE,KAAK;YACL,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC;YACtC,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC;YACxC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,QAAQ,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,aAAa,CAAC;SACjD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAgC,EAChC,KAAiC,EACjC,WAAmB;IAEnB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmC,CAAC;IAC3D,MAAM,IAAI,GAAsB,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,GAAG,GAAwD,EAAE,CAAC;IACpE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAqC;IAC/F,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,4EAA4E;IAC5E,kDAAkD;IAClD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;IACvE,WAAW,CAAC,MAAM,CAAC,CAAC;IAEpB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1F,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,IAAI,2BAA2B,CAAC;QAC/D,OAAO,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACtE,EAAE,EAAE,KAAK,CAAC,GAAG;YACb,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC;YACzE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACnC,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC5B,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACjE,iEAAiE;gBACjE,0EAA0E;gBAC1E,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;aAC9D,CAAC,CAAC;SACJ,CAAC,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAEzE,OAAO,CACL,6BAAiB,iBAAiB,iBAAc,MAAM,CAAC,MAAM,YAC3D,KAAC,cAAc,IACb,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;gBACjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC;gBACrC,IAAI,IAAI,KAAK,SAAS;oBAAE,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,CAAC,EACD,MAAM,EAAE;gBACN,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,iBAAiB;gBACzC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,oCAAoC;gBACvE,QAAQ,EAAE,MAAM,CAAC,YAAY,IAAI,UAAU;gBAC3C,IAAI,EAAE,MAAM,CAAC,UAAU,IAAI,MAAM;gBACjC,KAAK,EAAE,MAAM,CAAC,SAAS,IAAI,OAAO;gBAClC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,KAAK,KAAK,EAAE;oBACV,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,yBAAyB,CAAC;oBACjD,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,IAAI,mBAAmB,KAAK,GAAG,CAAC;aACzD,GACD,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/families/chrome/GlobalSearch.d.ts

@@ -0,0 +1,63 @@
+/**
+ * `global-search` (annex §11) — header search box with an anchored dropdown
+ * (quick links when empty, grouped results otherwise) plus a full-page results
+ * variant with a type filter rail, mixed-entity result cards and a count summary
+ * echoing the query. Evidence: Home, Search Results, Knowledge Base.
+ *
+ * Composed from @adminium/ui's `SearchInput`, `Popover`, `IconTile` and `Badge`.
+ * Filtering runs CLIENT-SIDE over the bound index (annex §11: "search index
+ * across entities") — the payload is the index, not a per-keystroke query, so
+ * typing never round-trips.
+ */
+import { globalSearchConfigSchema, globalSearchDemoData } from './chrome-config.js';
+import type { GlobalSearchConfig } from './chrome-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { globalSearchConfigSchema, globalSearchDemoData };
+export type { GlobalSearchConfig };
+export interface SearchResult {
+    id: string;
+    type: string;
+    label: string;
+    snippet?: string | undefined;
+    meta?: string | undefined;
+    href?: string | undefined;
+    updated?: string | undefined;
+}
+/** Project the §3 `record-list` index payload onto results. */
+export declare function searchResultsOf(data: unknown, config: GlobalSearchConfig): SearchResult[];
+/**
+ * The live filter (annex §11 "live substring filter"). Matches across the
+ * label, the snippet and the meta so a query like "shipped" finds a row whose
+ * status only appears in its snippet.
+ */
+export declare function filterResults(results: readonly SearchResult[], query: string, type: string | null): SearchResult[];
+/** Per-type facet counts for the rail — computed over the QUERY-filtered set, ignoring the type facet itself. */
+export declare function facetCounts(results: readonly SearchResult[], query: string): Map<string, number>;
+export interface GlobalSearchViewProps {
+    results: readonly SearchResult[];
+    variant?: 'dropdown' | 'page';
+    typeMeta?: Record<string, {
+        label?: string | undefined;
+        icon?: string | undefined;
+        tone?: string | undefined;
+    }> | undefined;
+    entityTypes?: readonly string[] | undefined;
+    quickLinks?: readonly {
+        label: string;
+        href: string;
+        icon?: string | undefined;
+    }[] | undefined;
+    maxResults?: number | undefined;
+    placeholder?: string | undefined;
+    summaryTemplate?: string | undefined;
+    allLabel?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    locale?: string | undefined;
+    referenceTime?: number | undefined;
+    onNavigate?: ((href: string) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function GlobalSearchView({ results, variant, typeMeta, entityTypes, quickLinks, maxResults, placeholder, summaryTemplate, allLabel, emptyTitle, emptyBody, locale, referenceTime, onNavigate, testId, }: GlobalSearchViewProps): import("react").JSX.Element;
+export declare function GlobalSearchWidget({ config, data, onEvent }: WidgetProps<GlobalSearchConfig>): import("react").JSX.Element;
+//# sourceMappingURL=GlobalSearch.d.ts.map

package/dist/families/chrome/GlobalSearch.d.ts.map

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

package/dist/families/chrome/GlobalSearch.js

@@ -0,0 +1,106 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `global-search` (annex §11) — header search box with an anchored dropdown
+ * (quick links when empty, grouped results otherwise) plus a full-page results
+ * variant with a type filter rail, mixed-entity result cards and a count summary
+ * echoing the query. Evidence: Home, Search Results, Knowledge Base.
+ *
+ * Composed from @adminium/ui's `SearchInput`, `Popover`, `IconTile` and `Badge`.
+ * Filtering runs CLIENT-SIDE over the bound index (annex §11: "search index
+ * across entities") — the payload is the index, not a per-keystroke query, so
+ * typing never round-trips.
+ */
+import { Badge, EmptyState, IconTile, Popover, PopoverContent, PopoverTrigger, SearchInput, cn } from '@adminium/ui';
+import { useMemo, useState } from 'react';
+import { chromeIcon } from './chrome-icons.js';
+import { formatUpdated, highlightParts, isSafeHref, matches, recordRowsOf, stringField } from './chrome-lib.js';
+import { globalSearchConfigSchema, globalSearchDemoData } from './chrome-config.js';
+export { globalSearchConfigSchema, globalSearchDemoData };
+const TONES = ['neutral', 'accent', 'pos', 'warn', 'danger', 'info'];
+/** Project the §3 `record-list` index payload onto results. */
+export function searchResultsOf(data, config) {
+    const rows = recordRowsOf(data);
+    const out = [];
+    for (const [index, row] of rows.entries()) {
+        const label = stringField(row, config.labelField);
+        if (label === undefined)
+            continue;
+        const href = stringField(row, config.hrefField);
+        out.push({
+            id: stringField(row, config.idField) ?? `hit-${index}`,
+            type: stringField(row, config.typeField) ?? 'record',
+            label,
+            snippet: stringField(row, config.snippetField),
+            meta: stringField(row, config.metaField),
+            ...(isSafeHref(href) ? { href } : {}),
+            updated: stringField(row, config.updatedField),
+        });
+    }
+    return out;
+}
+/**
+ * The live filter (annex §11 "live substring filter"). Matches across the
+ * label, the snippet and the meta so a query like "shipped" finds a row whose
+ * status only appears in its snippet.
+ */
+export function filterResults(results, query, type) {
+    return results.filter((result) => {
+        if (type !== null && result.type !== type)
+            return false;
+        return matches(result.label, query) || matches(result.snippet, query) || matches(result.meta, query);
+    });
+}
+/** Per-type facet counts for the rail — computed over the QUERY-filtered set, ignoring the type facet itself. */
+export function facetCounts(results, query) {
+    const counts = new Map();
+    for (const result of filterResults(results, query, null)) {
+        counts.set(result.type, (counts.get(result.type) ?? 0) + 1);
+    }
+    return counts;
+}
+/** Render a label with its matching span emphasised (annex §11 "match highlighting"). */
+function Highlighted({ text, query }) {
+    const parts = highlightParts(text, query);
+    if (parts === null)
+        return _jsx(_Fragment, { children: text });
+    return (_jsxs(_Fragment, { children: [parts.before, _jsx("mark", { className: "bg-accent-soft text-accent", children: parts.match }), parts.after] }));
+}
+function toneOf(value) {
+    return value !== undefined && TONES.includes(value) ? value : 'neutral';
+}
+export function GlobalSearchView({ results, variant = 'dropdown', typeMeta, entityTypes, quickLinks, maxResults = 20, placeholder, summaryTemplate, allLabel, emptyTitle, emptyBody, locale, referenceTime, onNavigate, testId, }) {
+    const [query, setQuery] = useState('');
+    const [type, setType] = useState(null);
+    const filtered = useMemo(() => filterResults(results, query, type).slice(0, maxResults), [results, query, type, maxResults]);
+    const counts = useMemo(() => facetCounts(results, query), [results, query]);
+    const click = (event, href) => {
+        if (href === undefined || onNavigate === undefined)
+            return;
+        if (event.defaultPrevented || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey || event.button !== 0)
+            return;
+        event.preventDefault();
+        onNavigate(href);
+    };
+    const resultRows = (_jsx("ul", { className: "m-0 flex list-none flex-col gap-0.5 p-0", children: filtered.map((result) => {
+            const meta = typeMeta?.[result.type];
+            const updated = formatUpdated(result.updated, locale, referenceTime);
+            return (_jsx("li", { children: _jsxs("a", { href: result.href ?? '#', "data-part": "search-result", "data-type": result.type, onClick: (event) => click(event, result.href), className: "flex items-start gap-3 rounded-lg p-2.5 no-underline hover:bg-surface-2 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent", children: [_jsx(IconTile, { size: "sm", tone: toneOf(meta?.tone), icon: chromeIcon(meta?.icon) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "truncate text-body-sm font-bold text-fg", children: _jsx(Highlighted, { text: result.label, query: query }) }), result.snippet !== undefined && (_jsx("p", { className: "truncate text-caption text-fg-muted", children: _jsx(Highlighted, { text: result.snippet, query: query }) }))] }), _jsxs("div", { className: "flex shrink-0 flex-col items-end gap-1", children: [_jsx(Badge, { tone: toneOf(meta?.tone), children: meta?.label ?? result.type }), updated !== undefined && _jsx("span", { className: "text-caption text-fg-subtle", children: updated })] })] }) }, result.id));
+        }) }));
+    const empty = (_jsx(EmptyState, { compact: true, preset: "no-matches", title: emptyTitle ?? 'No results', body: emptyBody ?? 'Try a different search term.' }));
+    // ── Full-page variant: facet rail + summary + result cards ───────────────
+    if (variant === 'page') {
+        const types = entityTypes ?? [...counts.keys()];
+        const summary = (summaryTemplate ?? '{count} results for "{query}"')
+            .replace('{count}', String(filtered.length))
+            .replace('{query}', query);
+        return (_jsxs("div", { "data-widget": "global-search", "data-variant": "page", "data-testid": testId, className: "flex h-full flex-col gap-3 px-4 pb-4", children: [_jsx(SearchInput, { value: query, onChange: (event) => setQuery(event.target.value), placeholder: placeholder ?? 'Search everything…', "aria-label": placeholder ?? 'Search' }), _jsxs("div", { className: "flex min-h-0 flex-1 gap-4", children: [_jsx("nav", { "data-part": "facet-rail", "aria-label": allLabel ?? 'Filter by type', className: "w-40 shrink-0 overflow-y-auto", children: _jsxs("ul", { className: "m-0 flex list-none flex-col gap-0.5 p-0", children: [_jsx("li", { children: _jsxs("button", { type: "button", "data-part": "facet", "data-active": type === null ? 'true' : undefined, "aria-pressed": type === null, onClick: () => setType(null), className: cn('flex w-full items-center justify-between rounded-lg px-2 py-1.5 text-body-sm', type === null ? 'bg-accent-soft font-bold text-accent' : 'text-fg-muted hover:bg-surface-2'), children: [_jsx("span", { children: allLabel ?? 'All' }), _jsx("span", { className: "text-caption", children: [...counts.values()].reduce((a, b) => a + b, 0) })] }) }), types.map((entityType) => (_jsx("li", { children: _jsxs("button", { type: "button", "data-part": "facet", "data-type": entityType, "data-active": type === entityType ? 'true' : undefined, "aria-pressed": type === entityType, onClick: () => setType(entityType), className: cn('flex w-full items-center justify-between rounded-lg px-2 py-1.5 text-body-sm', type === entityType ? 'bg-accent-soft font-bold text-accent' : 'text-fg-muted hover:bg-surface-2'), children: [_jsx("span", { className: "truncate", children: typeMeta?.[entityType]?.label ?? entityType }), _jsx("span", { className: "text-caption", children: counts.get(entityType) ?? 0 })] }) }, entityType)))] }) }), _jsxs("div", { className: "min-w-0 flex-1 overflow-y-auto", children: [_jsx("p", { "data-part": "search-summary", className: "mb-2 text-caption text-fg-subtle", children: summary }), filtered.length === 0 ? empty : resultRows] })] })] }));
+    }
+    // ── Header dropdown variant ──────────────────────────────────────────────
+    return (_jsx("div", { "data-widget": "global-search", "data-variant": "dropdown", "data-testid": testId, className: "px-4 pb-4", children: _jsxs(Popover, { open: query !== '', children: [_jsx(PopoverTrigger, { asChild: true, children: _jsx("div", { children: _jsx(SearchInput, { value: query, onChange: (event) => setQuery(event.target.value), placeholder: placeholder ?? 'Search everything…', "aria-label": placeholder ?? 'Search' }) }) }), _jsx(PopoverContent, { align: "start", className: "w-[min(28rem,90vw)] p-1.5", children: query === '' ? (
+                    // Empty query → quick links (annex §11), not an empty state.
+                    _jsx("ul", { "data-part": "quick-links", className: "m-0 flex list-none flex-col gap-0.5 p-0", children: (quickLinks ?? []).map((link) => (_jsx("li", { children: _jsxs("a", { href: link.href, onClick: (event) => click(event, link.href), className: "flex items-center gap-2.5 rounded-lg px-2.5 py-2 text-body-sm text-fg-muted no-underline hover:bg-surface-2 hover:text-fg", children: [_jsx(IconTile, { size: "sm", tone: "neutral", icon: chromeIcon(link.icon) }), link.label] }) }, link.href))) })) : filtered.length === 0 ? (empty) : (resultRows) })] }) }));
+}
+export function GlobalSearchWidget({ config, data, onEvent }) {
+    return (_jsx(GlobalSearchView, { results: searchResultsOf(data, config), variant: config.variant, typeMeta: config.typeMeta, entityTypes: config.entityTypes, quickLinks: config.quickLinks, maxResults: config.maxResults, placeholder: config.placeholder, summaryTemplate: config.summaryTemplate, allLabel: config.allLabel, emptyTitle: config.emptyTitle, emptyBody: config.emptyBody, locale: config.format?.locale, referenceTime: config.format?.referenceTime, onNavigate: (href) => onEvent({ type: 'drill-through', href }), testId: config.testId }));
+}
+//# sourceMappingURL=GlobalSearch.js.map

package/dist/families/chrome/GlobalSearch.js.map

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

package/dist/families/chrome/NavCard.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `nav-card` (annex §11) — clickable surface card: tinted icon tile, title,
+ * 2-line description, hover lift + sliding arrow; for hub/landing pages inside
+ * the admin. Evidence: Home.
+ *
+ * Renders a GRID of cards from one `record-list` (the annex's contract is a
+ * `{name, desc, icon, href, tint}` LIST, and `columns` is its config), so one
+ * widget instance is the whole hub grid rather than one card per instance.
+ */
+import { navCardConfigSchema, navCardDemoData } from './chrome-config.js';
+import type { NavCardConfig } from './chrome-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { navCardConfigSchema, navCardDemoData };
+export type { NavCardConfig };
+declare const TINTS: readonly ["neutral", "accent", "pos", "warn", "danger", "info"];
+type Tint = (typeof TINTS)[number];
+export interface NavCardItem {
+    key: string;
+    name: string;
+    desc?: string | undefined;
+    icon?: string | undefined;
+    href?: string | undefined;
+    tint: Tint;
+}
+/** Project the §3 `record-list` payload onto hub cards. */
+export declare function navCardsOf(data: unknown, config: NavCardConfig): NavCardItem[];
+export interface NavCardViewProps {
+    items: readonly NavCardItem[];
+    columns?: number | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    onNavigate?: ((href: string) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function NavCardView({ items, columns, emptyTitle, emptyBody, onNavigate, testId }: NavCardViewProps): import("react").JSX.Element;
+export declare function NavCardWidget({ config, data, onEvent }: WidgetProps<NavCardConfig>): import("react").JSX.Element;
+//# sourceMappingURL=NavCard.d.ts.map

package/dist/families/chrome/NavCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavCard.d.ts","sourceRoot":"","sources":["../../../src/families/chrome/NavCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,QAAA,MAAM,KAAK,iEAAkE,CAAC;AAC9E,KAAK,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,WAAW,EAAE,CAiB9E;AAaD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,OAAW,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,gBAAgB,+BA4D9G;AAED,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,aAAa,CAAC,+BAWlF"}

package/dist/families/chrome/NavCard.js

@@ -0,0 +1,67 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `nav-card` (annex §11) — clickable surface card: tinted icon tile, title,
+ * 2-line description, hover lift + sliding arrow; for hub/landing pages inside
+ * the admin. Evidence: Home.
+ *
+ * Renders a GRID of cards from one `record-list` (the annex's contract is a
+ * `{name, desc, icon, href, tint}` LIST, and `columns` is its config), so one
+ * widget instance is the whole hub grid rather than one card per instance.
+ */
+import { EmptyState, IconTile, cn } from '@adminium/ui';
+import { ArrowRight } from 'lucide-react';
+import { chromeIcon } from './chrome-icons.js';
+import { isSafeHref, oneOf, recordRowsOf, stringField } from './chrome-lib.js';
+import { navCardConfigSchema, navCardDemoData } from './chrome-config.js';
+export { navCardConfigSchema, navCardDemoData };
+const TINTS = ['neutral', 'accent', 'pos', 'warn', 'danger', 'info'];
+/** Project the §3 `record-list` payload onto hub cards. */
+export function navCardsOf(data, config) {
+    const rows = recordRowsOf(data);
+    const out = [];
+    for (const [index, row] of rows.entries()) {
+        const name = stringField(row, config.nameField);
+        if (name === undefined)
+            continue;
+        const href = stringField(row, config.hrefField);
+        out.push({
+            key: `${name}-${index}`,
+            name,
+            desc: stringField(row, config.descField),
+            icon: stringField(row, config.iconField),
+            ...(isSafeHref(href) ? { href } : {}),
+            tint: oneOf(row[config.tintField], TINTS, 'accent'),
+        });
+    }
+    return out;
+}
+/**
+ * Explicit column classes — Tailwind scans source statically, so a computed
+ * `grid-cols-${n}` would emit no CSS. Keyed by the schema's 1–4 range.
+ */
+const COLUMN_CLASSES = {
+    1: 'grid-cols-1',
+    2: 'grid-cols-1 sm:grid-cols-2',
+    3: 'grid-cols-1 sm:grid-cols-2 lg:grid-cols-3',
+    4: 'grid-cols-1 sm:grid-cols-2 lg:grid-cols-4',
+};
+export function NavCardView({ items, columns = 3, emptyTitle, emptyBody, onNavigate, testId }) {
+    if (items.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'Nothing to show', body: emptyBody ?? 'Hub links appear here once pages are generated.' }));
+    }
+    const click = (event, href) => {
+        if (href === undefined || onNavigate === undefined)
+            return;
+        if (event.defaultPrevented || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey || event.button !== 0)
+            return;
+        event.preventDefault();
+        onNavigate(href);
+    };
+    return (_jsx("div", { "data-widget": "nav-card", "data-testid": testId, className: cn('grid h-full gap-3 overflow-auto px-4 pb-4', COLUMN_CLASSES[columns] ?? COLUMN_CLASSES[3]), children: items.map((item) => (_jsxs("a", { href: item.href ?? '#', "data-part": "nav-card-item", "data-tint": item.tint, onClick: (event) => click(event, item.href), className: cn('group flex items-start gap-3 rounded-xl border border-border bg-surface p-3.5 no-underline', 'transition-[transform,border-color,box-shadow] duration-150', 'hover:-translate-y-0.5 hover:border-border-strong hover:shadow-md', 'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent'), children: [_jsx(IconTile, { size: "md", tone: item.tint, icon: chromeIcon(item.icon) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "truncate text-body-sm font-bold text-fg", children: item.name }), item.desc !== undefined && (
+                        // 2-line clamp per the annex; the card is a teaser, not the page.
+                        _jsx("p", { className: "line-clamp-2 text-caption text-fg-muted", children: item.desc }))] }), _jsx(ArrowRight, { "aria-hidden": "true", className: "ms-0 size-4 shrink-0 text-fg-subtle transition-[margin] duration-150 group-hover:ms-1 rtl:rotate-180" })] }, item.key))) }));
+}
+export function NavCardWidget({ config, data, onEvent }) {
+    return (_jsx(NavCardView, { items: navCardsOf(data, config), columns: config.columns, emptyTitle: config.emptyTitle, emptyBody: config.emptyBody, onNavigate: (href) => onEvent({ type: 'drill-through', href }), testId: config.testId }));
+}
+//# sourceMappingURL=NavCard.js.map

package/dist/families/chrome/NavCard.js.map

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

package/dist/families/chrome/ShortcutsPanel.d.ts

@@ -0,0 +1,42 @@
+/**
+ * `shortcuts-panel` (annex §11) — keyboard shortcuts cheat sheet: categorized
+ * groups of label + keycap combos, modifier and sequential "then" chords.
+ * Evidence: Shortcuts Panel, Metrics Dashboard.
+ *
+ * `static` by contract (annex §11: "static groups of {label, keys[],
+ * isSequence}") — the HOST owns the live shortcut manager and passes the
+ * registered set in as config, so the panel can never drift from a hardcoded
+ * list of its own.
+ *
+ * The `MOD` key token is resolved to the platform glyph at render (`⌘` on macOS,
+ * `Ctrl` elsewhere) from `config.modKey`, which the host sets — the widget does
+ * not sniff the platform (annex §11 "Keycaps localize per platform").
+ */
+import { DEFAULT_SHORTCUT_GROUPS, shortcutsPanelConfigSchema, shortcutsPanelDemoData } from './chrome-config.js';
+import type { ShortcutsPanelConfig } from './chrome-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { shortcutsPanelConfigSchema, shortcutsPanelDemoData, DEFAULT_SHORTCUT_GROUPS };
+export type { ShortcutsPanelConfig };
+/** The token a shortcut definition uses for "the platform's primary modifier". */
+export declare const MOD_TOKEN = "MOD";
+/** Resolve `MOD` to the platform glyph; every other key renders verbatim. */
+export declare function displayKey(key: string, modKey: string): string;
+export interface ShortcutEntry {
+    label: string;
+    keys: readonly string[];
+    isSequence?: boolean | undefined;
+}
+export interface ShortcutGroup {
+    group: string;
+    entries: readonly ShortcutEntry[];
+}
+export interface ShortcutsPanelViewProps {
+    groups: readonly ShortcutGroup[];
+    modKey?: string | undefined;
+    footerHint?: string | undefined;
+    emptyTitle?: string | undefined;
+    testId?: string | undefined;
+}
+export declare function ShortcutsPanelView({ groups, modKey, footerHint, emptyTitle, testId, }: ShortcutsPanelViewProps): import("react").JSX.Element;
+export declare function ShortcutsPanelWidget({ config }: WidgetProps<ShortcutsPanelConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ShortcutsPanel.d.ts.map

package/dist/families/chrome/ShortcutsPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShortcutsPanel.d.ts","sourceRoot":"","sources":["../../../src/families/chrome/ShortcutsPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,CAAC;AACvF,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC,kFAAkF;AAClF,eAAO,MAAM,SAAS,QAAQ,CAAC;AAE/B,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,MAAY,EACZ,UAAU,EACV,UAAU,EACV,MAAM,GACP,EAAE,uBAAuB,+BAoCzB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,oBAAoB,CAAC,+BAUjF"}