@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/chrome/ShortcutsPanel.js

@@ -0,0 +1,37 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `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 { Kbd } from '@adminium/ui';
+import { DEFAULT_SHORTCUT_GROUPS, shortcutsPanelConfigSchema, shortcutsPanelDemoData } from './chrome-config.js';
+export { shortcutsPanelConfigSchema, shortcutsPanelDemoData, DEFAULT_SHORTCUT_GROUPS };
+/** The token a shortcut definition uses for "the platform's primary modifier". */
+export const MOD_TOKEN = 'MOD';
+/** Resolve `MOD` to the platform glyph; every other key renders verbatim. */
+export function displayKey(key, modKey) {
+    return key === MOD_TOKEN ? modKey : key;
+}
+export function ShortcutsPanelView({ groups, modKey = '⌘', footerHint, emptyTitle, testId, }) {
+    if (groups.length === 0) {
+        return _jsx("p", { className: "px-4 pb-4 text-body-sm text-fg-muted", children: emptyTitle ?? 'No shortcuts registered.' });
+    }
+    return (_jsxs("div", { "data-widget": "shortcuts-panel", "data-testid": testId, className: "h-full overflow-y-auto px-4 pb-4", children: [_jsx("div", { className: "grid grid-cols-1 gap-x-8 gap-y-5 sm:grid-cols-2", children: groups.map((group) => (_jsxs("section", { "data-part": "shortcut-group", children: [_jsx("h3", { className: "mb-2 text-caption font-bold uppercase tracking-wide text-fg-subtle", children: group.group }), _jsx("ul", { className: "m-0 flex list-none flex-col gap-1.5 p-0", children: group.entries.map((entry) => (_jsxs("li", { className: "flex items-center justify-between gap-3", children: [_jsx("span", { className: "min-w-0 truncate text-body-sm text-fg-muted", children: entry.label }), _jsx("span", { "data-part": "keycaps", className: "flex shrink-0 items-center gap-1", children: entry.keys.map((key, index) => (
+                                        // Keys can legitimately repeat within a chord (e.g. "G then G"),
+                                        // so the index is part of the identity here.
+                                        _jsxs("span", { className: "flex items-center gap-1", children: [index > 0 && entry.isSequence === true && (_jsx("span", { className: "text-caption text-fg-subtle", children: "then" })), _jsx(Kbd, { children: displayKey(key, modKey) })] }, `${key}-${index}`))) })] }, entry.label))) })] }, group.group))) }), footerHint !== undefined && _jsx("p", { className: "mt-4 text-caption text-fg-subtle", children: footerHint })] }));
+}
+export function ShortcutsPanelWidget({ config }) {
+    return (_jsx(ShortcutsPanelView, { groups: config.groups ?? DEFAULT_SHORTCUT_GROUPS, modKey: config.modKey, footerHint: config.footerHint, emptyTitle: config.emptyTitle, testId: config.testId }));
+}
+//# sourceMappingURL=ShortcutsPanel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ShortcutsPanel.js","sourceRoot":"","sources":["../../../src/families/chrome/ShortcutsPanel.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAIjH,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,CAAC;AAGvF,kFAAkF;AAClF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC;AAE/B,6EAA6E;AAC7E,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,MAAc;IACpD,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;AAC1C,CAAC;AAqBD,MAAM,UAAU,kBAAkB,CAAC,EACjC,MAAM,EACN,MAAM,GAAG,GAAG,EACZ,UAAU,EACV,UAAU,EACV,MAAM,GACkB;IACxB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,YAAG,SAAS,EAAC,sCAAsC,YAAE,UAAU,IAAI,0BAA0B,GAAK,CAAC;IAC5G,CAAC;IAED,OAAO,CACL,8BAAiB,iBAAiB,iBAAc,MAAM,EAAE,SAAS,EAAC,kCAAkC,aAClG,cAAK,SAAS,EAAC,iDAAiD,YAC7D,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACrB,gCAAqC,gBAAgB,aACnD,aAAI,SAAS,EAAC,oEAAoE,YAAE,KAAK,CAAC,KAAK,GAAM,EACrG,aAAI,SAAS,EAAC,yCAAyC,YACpD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAC5B,cAAsB,SAAS,EAAC,yCAAyC,aACvE,eAAM,SAAS,EAAC,6CAA6C,YAAE,KAAK,CAAC,KAAK,GAAQ,EAClF,4BAAgB,SAAS,EAAC,SAAS,EAAC,kCAAkC,YACnE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC;wCAC9B,iEAAiE;wCACjE,6CAA6C;wCAC7C,gBAA8B,SAAS,EAAC,yBAAyB,aAC9D,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,IAAI,CACzC,eAAM,SAAS,EAAC,6BAA6B,qBAAY,CAC1D,EACD,KAAC,GAAG,cAAE,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,GAAO,KAJ3B,GAAG,GAAG,IAAI,KAAK,EAAE,CAKrB,CACR,CAAC,GACG,KAbA,KAAK,CAAC,KAAK,CAcf,CACN,CAAC,GACC,KApBO,KAAK,CAAC,KAAK,CAqBf,CACX,CAAC,GACE,EACL,UAAU,KAAK,SAAS,IAAI,YAAG,SAAS,EAAC,kCAAkC,YAAE,UAAU,GAAK,IACzF,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAE,MAAM,EAAqC;IAChF,OAAO,CACL,KAAC,kBAAkB,IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,uBAAuB,EAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,UAAU,EAAE,MAAM,CAAC,UAAU,EAC7B,UAAU,EAAE,MAAM,CAAC,UAAU,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,GACrB,CACH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,55 @@
+/**
+ * `sidebar-nav` (annex §11) — grouped data-driven nav: group labels, icon links,
+ * active state, optional live count badges. The generator builds its payload
+ * from the included tables + adminium pages (annex §11 auto-instantiation: "the
+ * app shell always mounts `sidebar-nav`"), and tables with unread/pending
+ * semantics push counts into `badgeField`.
+ *
+ * Built fresh in the widgets package rather than lifted from
+ * `apps/dashboard/src/shell/SidebarNav.tsx`: that one is bound to the app's
+ * `BootstrapData`, its `@tanstack/react-router` `Link`, its `t()` and its
+ * `navSections` module — a widget may never import an app (04 §2.1). The annex's
+ * contract here is the generic groups/items payload. The app keeps its shell rail.
+ *
+ * Navigation goes through `onEvent` (04 §2.1): the widget renders anchors so
+ * middle-click / "open in new tab" keep working, but a plain left-click is
+ * intercepted and handed to the host's router.
+ */
+import { sidebarNavConfigSchema, sidebarNavDemoData } from './chrome-config.js';
+import type { SidebarNavConfig } from './chrome-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { sidebarNavConfigSchema, sidebarNavDemoData };
+export type { SidebarNavConfig };
+export interface NavItem {
+    key: string;
+    label: string;
+    icon?: string | undefined;
+    href?: string | undefined;
+    badge?: number | undefined;
+}
+export interface NavGroup {
+    key: string;
+    label?: string | undefined;
+    items: NavItem[];
+}
+/**
+ * Group the flat payload into ordered sections. Config `groups` fixes the order
+ * and supplies display labels; groups the payload has but config does not render
+ * AFTER the ordered ones in first-seen order — a new table must never silently
+ * vanish from the nav just because nobody updated the group list.
+ */
+export declare function navGroupsOf(data: unknown, config: SidebarNavConfig): NavGroup[];
+export interface SidebarNavViewProps {
+    groups: readonly NavGroup[];
+    activeHref?: string | undefined;
+    showBadges?: boolean | undefined;
+    locale?: string | undefined;
+    a11yLabel?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    onNavigate?: ((href: string) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function SidebarNavView({ groups, activeHref, showBadges, locale, a11yLabel, emptyTitle, emptyBody, onNavigate, testId, }: SidebarNavViewProps): import("react").JSX.Element;
+export declare function SidebarNavWidget({ config, data, onEvent }: WidgetProps<SidebarNavConfig>): import("react").JSX.Element;
+//# sourceMappingURL=SidebarNav.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarNav.d.ts","sourceRoot":"","sources":["../../../src/families/chrome/SidebarNav.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,GAAG,QAAQ,EAAE,CAkC/E;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,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,cAAc,CAAC,EAC7B,MAAM,EACN,UAAU,EACV,UAAiB,EACjB,MAAM,EACN,SAAS,EACT,UAAU,EACV,SAAS,EACT,UAAU,EACV,MAAM,GACP,EAAE,mBAAmB,+BA0ErB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,gBAAgB,CAAC,+BAcxF"}

package/dist/families/chrome/SidebarNav.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `sidebar-nav` (annex §11) — grouped data-driven nav: group labels, icon links,
+ * active state, optional live count badges. The generator builds its payload
+ * from the included tables + adminium pages (annex §11 auto-instantiation: "the
+ * app shell always mounts `sidebar-nav`"), and tables with unread/pending
+ * semantics push counts into `badgeField`.
+ *
+ * Built fresh in the widgets package rather than lifted from
+ * `apps/dashboard/src/shell/SidebarNav.tsx`: that one is bound to the app's
+ * `BootstrapData`, its `@tanstack/react-router` `Link`, its `t()` and its
+ * `navSections` module — a widget may never import an app (04 §2.1). The annex's
+ * contract here is the generic groups/items payload. The app keeps its shell rail.
+ *
+ * Navigation goes through `onEvent` (04 §2.1): the widget renders anchors so
+ * middle-click / "open in new tab" keep working, but a plain left-click is
+ * intercepted and handed to the host's router.
+ */
+import { Badge, EmptyState, cn } from '@adminium/ui';
+import { chromeIcon } from './chrome-icons.js';
+import { formatCount, isSafeHref, recordRowsOf, numberField, stringField } from './chrome-lib.js';
+import { sidebarNavConfigSchema, sidebarNavDemoData } from './chrome-config.js';
+export { sidebarNavConfigSchema, sidebarNavDemoData };
+/**
+ * Group the flat payload into ordered sections. Config `groups` fixes the order
+ * and supplies display labels; groups the payload has but config does not render
+ * AFTER the ordered ones in first-seen order — a new table must never silently
+ * vanish from the nav just because nobody updated the group list.
+ */
+export function navGroupsOf(data, config) {
+    const rows = recordRowsOf(data);
+    const byKey = new Map();
+    const seen = [];
+    for (const row of rows) {
+        const label = stringField(row, config.labelField);
+        if (label === undefined)
+            continue;
+        const groupKey = stringField(row, config.groupField) ?? '';
+        if (!byKey.has(groupKey)) {
+            byKey.set(groupKey, { key: groupKey, items: [] });
+            seen.push(groupKey);
+        }
+        const href = stringField(row, config.hrefField);
+        byKey.get(groupKey)?.items.push({
+            key: stringField(row, config.keyField) ?? href ?? label,
+            label,
+            icon: stringField(row, config.iconField),
+            ...(isSafeHref(href) ? { href } : {}),
+            badge: numberField(row, config.badgeField),
+        });
+    }
+    const ordered = config.groups ?? [];
+    const orderedKeys = new Set(ordered.map((g) => g.key));
+    const out = [];
+    for (const g of ordered) {
+        const found = byKey.get(g.key);
+        if (found !== undefined)
+            out.push({ ...found, label: g.label ?? found.label });
+    }
+    for (const key of seen) {
+        if (!orderedKeys.has(key))
+            out.push(byKey.get(key));
+    }
+    return out;
+}
+export function SidebarNavView({ groups, activeHref, showBadges = true, locale, a11yLabel, emptyTitle, emptyBody, onNavigate, testId, }) {
+    if (groups.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'No navigation yet', body: emptyBody ?? 'Included tables appear here once a connection is generated.' }));
+    }
+    const click = (event, href) => {
+        // Let the browser own modified clicks (new tab/window) and non-primary
+        // buttons; only a plain left-click is the host's to route.
+        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("nav", { "data-widget": "sidebar-nav", "data-testid": testId, "aria-label": a11yLabel ?? 'Main', className: "h-full overflow-y-auto px-2 pb-4", children: groups.map((group) => (_jsxs("section", { "data-part": "nav-group", "data-group": group.key, className: "mb-4", children: [group.label !== undefined && group.label !== '' && (_jsx("h3", { className: "mb-1 px-2 text-caption font-bold uppercase tracking-wide text-fg-subtle", children: group.label })), _jsx("ul", { className: "m-0 flex list-none flex-col gap-0.5 p-0", children: group.items.map((item) => {
+                        const active = item.href !== undefined && item.href === activeHref;
+                        const count = showBadges ? formatCount(item.badge, locale) : undefined;
+                        const icon = chromeIcon(item.icon);
+                        return (_jsx("li", { children: _jsxs("a", { href: item.href ?? '#', "data-part": "nav-item", "data-active": active ? 'true' : undefined, "aria-current": active ? 'page' : undefined, onClick: (event) => click(event, item.href), className: cn('flex items-center gap-2.5 rounded-lg px-2 py-1.5 text-body-sm no-underline', active ? 'bg-accent-soft font-bold text-accent' : 'text-fg-muted hover:bg-surface-2 hover:text-fg'), children: [icon !== undefined && (_jsx("span", { "aria-hidden": "true", className: "flex size-4 shrink-0 items-center justify-center [&_svg]:size-4", children: icon })), _jsx("span", { className: "min-w-0 flex-1 truncate", children: item.label }), count !== undefined && (_jsx(Badge, { "data-part": "nav-badge", tone: active ? 'accent' : 'neutral', className: "shrink-0", children: count }))] }) }, item.key));
+                    }) })] }, group.key))) }));
+}
+export function SidebarNavWidget({ config, data, onEvent }) {
+    return (_jsx(SidebarNavView, { groups: navGroupsOf(data, config), activeHref: config.activeHref, showBadges: config.showBadges, locale: config.format?.locale, a11yLabel: config.a11yLabel, emptyTitle: config.emptyTitle, emptyBody: config.emptyBody, onNavigate: (href) => onEvent({ type: 'drill-through', href }), testId: config.testId }));
+}
+//# sourceMappingURL=SidebarNav.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * `tab-bar` (annex §11) — icon+label underline or pill tabs driving panel
+ * visibility; supports count pills in labels and cross-page link tabs. Evidence:
+ * Workspace Settings, CRUD Admin (tab count pills), Ticket Queue.
+ *
+ * Wraps @adminium/ui's `Tabs`/`TabsList`/`TabsTrigger` (Radix — which owns the
+ * roving-tabindex keyboard model and the `underline`/`pill` variants); this file
+ * adds the record-list binding, the count pills, and cross-page link tabs.
+ *
+ * SCOPE: the widget renders the TAB STRIP, not the panels. Tabs in a generated
+ * page either drive a sibling widget's filter (the host reads the active key) or
+ * navigate (`hrefField`) — so there is no `TabsContent` here by design.
+ */
+import { tabBarConfigSchema, tabBarDemoData } from './chrome-config.js';
+import type { TabBarConfig } from './chrome-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { tabBarConfigSchema, tabBarDemoData };
+export type { TabBarConfig };
+export interface TabDef {
+    key: string;
+    label: string;
+    icon?: string | undefined;
+    count?: number | undefined;
+    href?: string | undefined;
+}
+/** Project the §3 `record-list` payload onto tab defs. */
+export declare function tabsOf(data: unknown, config: TabBarConfig): TabDef[];
+export declare function TabBarWidget({ config, data, onEvent }: WidgetProps<TabBarConfig>): import("react").JSX.Element | null;
+//# sourceMappingURL=TabBar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TabBar.d.ts","sourceRoot":"","sources":["../../../src/families/chrome/TabBar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,0DAA0D;AAC1D,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAgBpE;AAED,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,YAAY,CAAC,sCA6ChF"}

package/dist/families/chrome/TabBar.js

@@ -0,0 +1,61 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `tab-bar` (annex §11) — icon+label underline or pill tabs driving panel
+ * visibility; supports count pills in labels and cross-page link tabs. Evidence:
+ * Workspace Settings, CRUD Admin (tab count pills), Ticket Queue.
+ *
+ * Wraps @adminium/ui's `Tabs`/`TabsList`/`TabsTrigger` (Radix — which owns the
+ * roving-tabindex keyboard model and the `underline`/`pill` variants); this file
+ * adds the record-list binding, the count pills, and cross-page link tabs.
+ *
+ * SCOPE: the widget renders the TAB STRIP, not the panels. Tabs in a generated
+ * page either drive a sibling widget's filter (the host reads the active key) or
+ * navigate (`hrefField`) — so there is no `TabsContent` here by design.
+ */
+import { Tabs, TabsList, TabsTrigger } from '@adminium/ui';
+import { chromeIcon } from './chrome-icons.js';
+import { isSafeHref, numberField, recordRowsOf, stringField } from './chrome-lib.js';
+import { tabBarConfigSchema, tabBarDemoData } from './chrome-config.js';
+export { tabBarConfigSchema, tabBarDemoData };
+/** Project the §3 `record-list` payload onto tab defs. */
+export function tabsOf(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({
+            key: stringField(row, config.keyField) ?? `tab-${index}`,
+            label,
+            icon: stringField(row, config.iconField),
+            count: numberField(row, config.countField),
+            ...(isSafeHref(href) ? { href } : {}),
+        });
+    }
+    return out;
+}
+export function TabBarWidget({ config, data, onEvent }) {
+    const tabs = tabsOf(data, config);
+    if (tabs.length === 0)
+        return null;
+    // `tabs` is non-empty here, so the fallback always resolves to a real key —
+    // Radix needs a defined `value` (a controlled Tabs root cannot take undefined).
+    const active = config.activeKey ?? tabs[0].key;
+    return (_jsx("div", { className: "flex h-full items-start px-4 pb-4", "data-widget": "tab-bar", "data-testid": config.testId, children: _jsx(Tabs
+        // `variant` maps the annex's `style` vocabulary onto the UI component's.
+        , { 
+            // `variant` maps the annex's `style` vocabulary onto the UI component's.
+            variant: config.style === 'segmented' ? 'pill' : 'underline', value: active, onValueChange: (key) => {
+                // A link tab navigates; a filter tab just reports the change and the
+                // host re-queries its siblings. Both go through onEvent (04 §2.1).
+                const href = tabs.find((tab) => tab.key === key)?.href;
+                if (href !== undefined)
+                    onEvent({ type: 'drill-through', href });
+            }, className: "w-full", children: _jsx(TabsList, { "aria-label": config.a11yLabel ?? 'Tabs', children: tabs.map((tab) => {
+                    const icon = chromeIcon(tab.icon);
+                    return (_jsxs(TabsTrigger, { value: tab.key, "data-part": "tab", ...(config.counts && tab.count !== undefined ? { count: tab.count } : {}), children: [icon !== undefined && (_jsx("span", { "aria-hidden": "true", className: "me-1.5 inline-flex size-4 items-center justify-center [&_svg]:size-4", children: icon })), tab.label] }, tab.key));
+                }) }) }) }));
+}
+//# sourceMappingURL=TabBar.js.map

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

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