@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/tables/widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.d.ts","sourceRoot":"","sources":["../../../src/families/tables/widgets.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;GAMG;AAKH,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAoD5B,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,cAAc,CAAC,+BA+BpF;AAED,wBAAgB,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,sBAAsB,CAAC,+BAkB3F;AAED,wBAAgB,uBAAuB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,uBAAuB,CAAC,+BAuBtG;AAED,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,oBAAoB,CAAC,+BAShG;AAED,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,eAAe,CAAC,+BA4BtF"}

package/dist/families/tables/widgets.js

@@ -0,0 +1,132 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { BulkActionToolbar } from './BulkActionToolbar.js';
+import { DataGrid } from './DataGrid.js';
+import { DetailKeyValue } from './DetailKeyValue.js';
+import { MiniTable } from './MiniTable.js';
+import { PaginationFooter } from './PaginationFooter.js';
+/**
+ * Registry-facing widget components for the `tables` family — thin adapters
+ * binding `WidgetProps` (config + data + onEvent) onto the standalone
+ * components, which the `page-crud` template also composes directly with
+ * richer host wiring. One module so Vite emits a single family chunk
+ * (04 §2.3); `definitions.ts` lazy-imports it per widget.
+ */
+// Config schemas live in the pure `tables-config` module so the registry
+// metadata graph never reaches this component file (04 §2.3). Re-exported here
+// to keep existing import points stable.
+export { bulkActionToolbarConfigSchema, dataGridConfigSchema, detailKeyValueConfigSchema, miniTableConfigSchema, paginationFooterConfigSchema, } from './tables-config.js';
+// --- data narrowing ---------------------------------------------------------
+/** Rows from a `record-list` payload (CRUD list envelope or bare array). */
+function rowsOf(data) {
+    if (Array.isArray(data))
+        return data;
+    if (typeof data === 'object' && data !== null && Array.isArray(data.data)) {
+        return data.data;
+    }
+    return [];
+}
+/**
+ * Column specs: instance config wins; demo payloads embed their own
+ * `columns` so palette/storybook rendering works with default config.
+ */
+function columnsOf(config, data) {
+    if (config.columns.length > 0)
+        return config.columns;
+    if (typeof data === 'object' && data !== null && Array.isArray(data.columns)) {
+        return data.columns;
+    }
+    return [];
+}
+function recordOf(data) {
+    if (typeof data === 'object' && data !== null) {
+        const envelope = data;
+        if (typeof envelope.data === 'object' && envelope.data !== null && !Array.isArray(envelope.data)) {
+            return envelope.data;
+        }
+        if (!Array.isArray(data))
+            return data;
+    }
+    return {};
+}
+function formatContext(config) {
+    return { locale: config.format?.locale, currency: config.format?.currency };
+}
+/** Qualified table name from a shared-config binding (query descriptor §5.1). */
+function bindingTable(config) {
+    const binding = config.binding;
+    if (binding === undefined)
+        return undefined;
+    const { schema, name } = binding.source;
+    return { table: schema === undefined ? name : `${schema}.${name}`, connectionId: binding.connectionId };
+}
+// --- widget components -------------------------------------------------------
+export function DataGridWidget({ config, data, onEvent }) {
+    const columns = columnsOf(config, data);
+    const source = bindingTable(config);
+    return (_jsx(DataGrid, { columns: columns, rows: rowsOf(data), selectable: config.selectable, density: config.density, cellContext: { onEvent, connectionId: source?.connectionId, ...formatContext(config) }, ...(config.rowAction === 'none'
+            ? {}
+            : {
+                onRowOpen: (row) => {
+                    if (config.rowAction === 'link' && config.href !== undefined) {
+                        onEvent({ type: 'drill-through', href: config.href });
+                        return;
+                    }
+                    const pk = columns.find((column) => column.primaryKey);
+                    if (pk !== undefined && source !== undefined) {
+                        onEvent({
+                            type: 'record-open',
+                            connectionId: source.connectionId,
+                            table: source.table,
+                            recordId: row[pk.name],
+                        });
+                    }
+                },
+            }) }));
+}
+export function PaginationFooterWidget({ config, data }) {
+    const rows = rowsOf(data);
+    const page = (typeof data === 'object' && data !== null
+        ? data.page
+        : undefined) ?? { limit: config.pageSize, offset: 0, total: null };
+    return (_jsx(PaginationFooter, { rangeStart: rows.length === 0 ? 0 : page.offset + 1, rangeEnd: page.offset + rows.length, total: page.total, hasPrev: page.offset > 0, hasNext: page.total !== null && page.offset + rows.length < page.total, onPrev: () => { }, onNext: () => { }, pageSize: config.pageSize, onPageSizeChange: () => { } }));
+}
+export function BulkActionToolbarWidget({ config, data, onEvent }) {
+    const selectedIds = Array.isArray(data) ? data.map(String) : [];
+    const source = bindingTable(config);
+    return (_jsx(BulkActionToolbar, { selectedIds: selectedIds, actions: config.actions, onAction: (key, ids) => {
+            if (key === 'delete' && source !== undefined) {
+                for (const id of ids) {
+                    onEvent({
+                        type: 'mutate',
+                        intent: 'delete',
+                        connectionId: source.connectionId,
+                        table: source.table,
+                        recordId: id,
+                    });
+                }
+            }
+        }, onClear: () => { } }));
+}
+export function DetailKeyValueWidget({ config, data, onEvent }) {
+    return (_jsx(DetailKeyValue, { columns: columnsOf(config, data), record: recordOf(data), showTypeTags: config.showTypeTags, cellContext: { onEvent, ...formatContext(config) } }));
+}
+export function MiniTableWidget({ config, data, onEvent }) {
+    const columns = columnsOf(config, data);
+    const source = bindingTable(config);
+    return (_jsx(MiniTable, { columns: columns, rows: rowsOf(data), limit: config.limit, onEvent: onEvent, cellContext: { onEvent, connectionId: source?.connectionId, ...formatContext(config) }, ...(config.viewAllHref !== undefined ? { viewAllHref: config.viewAllHref } : {}), ...(source === undefined
+            ? {}
+            : {
+                onRowOpen: (row) => {
+                    const pk = columns.find((column) => column.primaryKey);
+                    if (pk !== undefined) {
+                        onEvent({
+                            type: 'record-open',
+                            connectionId: source.connectionId,
+                            table: source.table,
+                            recordId: row[pk.name],
+                        });
+                    }
+                },
+            }) }));
+}
+//# sourceMappingURL=widgets.js.map

package/dist/families/tables/widgets.js.map

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

package/dist/frame/ChartDirectionBridge.d.ts

@@ -0,0 +1,6 @@
+import type { ReactNode } from 'react';
+export interface ChartDirectionBridgeProps {
+    children: ReactNode;
+}
+export declare function ChartDirectionBridge({ children }: ChartDirectionBridgeProps): import("react").JSX.Element;
+//# sourceMappingURL=ChartDirectionBridge.d.ts.map

package/dist/frame/ChartDirectionBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartDirectionBridge.d.ts","sourceRoot":"","sources":["../../src/frame/ChartDirectionBridge.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,EAAE,yBAAyB,+BAG3E"}

package/dist/frame/ChartDirectionBridge.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Bridges the resolved app direction into `@adminium/charts`'
+ * `ChartDirectionContext` so every chart mirrors its chrome (categorical bar
+ * order, legend/tooltip/axis side) under RTL while keeping time axes LTR
+ * (10-i18n-theming.md §5.5). Charts default their context to `'ltr'`, so
+ * without this bridge they never mirror even on an RTL page — the "RTL-aware"
+ * claim would be claim-only at the app level.
+ *
+ * Direction comes from `useTheme().dir` — the same resolved value `ThemeProvider`
+ * stamps on `<html>` and drives the Radix `DirectionProvider` from — so it stays
+ * live across a locale switch and needs only a `<ThemeProvider>` ancestor (not
+ * `<I18nProvider>`). Mount once, high in the app tree.
+ */
+import { useTheme } from '@adminium/ui';
+import { ChartDirectionContext } from '@adminium/charts';
+export function ChartDirectionBridge({ children }) {
+    const { dir } = useTheme();
+    return _jsx(ChartDirectionContext.Provider, { value: dir, children: children });
+}
+//# sourceMappingURL=ChartDirectionBridge.js.map

package/dist/frame/ChartDirectionBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartDirectionBridge.js","sourceRoot":"","sources":["../../src/frame/ChartDirectionBridge.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAMzD,MAAM,UAAU,oBAAoB,CAAC,EAAE,QAAQ,EAA6B;IAC1E,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC3B,OAAO,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,GAAG,YAAG,QAAQ,GAAkC,CAAC;AACjG,CAAC"}

package/dist/frame/SkeletonSilhouette.d.ts

@@ -0,0 +1,12 @@
+import type { WidgetSkeleton } from '../registry/types.js';
+/**
+ * Per-family skeleton silhouettes for the WidgetFrame `skeleton` state and
+ * for lazy-chunk Suspense fallbacks (04 §4). Built from the ui `Skeleton`
+ * shimmer; the container carries `aria-busy` (individual bones are
+ * aria-hidden per ui convention).
+ */
+export interface SkeletonSilhouetteProps {
+    variant: WidgetSkeleton;
+}
+export declare function SkeletonSilhouette({ variant }: SkeletonSilhouetteProps): import("react").JSX.Element;
+//# sourceMappingURL=SkeletonSilhouette.d.ts.map

package/dist/frame/SkeletonSilhouette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkeletonSilhouette.d.ts","sourceRoot":"","sources":["../../src/frame/SkeletonSilhouette.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE,uBAAuB,+BA2DtE"}

package/dist/frame/SkeletonSilhouette.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Skeleton } from '@adminium/ui';
+export function SkeletonSilhouette({ variant }) {
+    return (_jsxs("div", { "aria-busy": "true", "data-skeleton-variant": variant, className: "flex min-h-20 flex-col gap-3 p-4 compact:gap-2 compact:p-3", children: [variant === 'card' && (_jsxs(_Fragment, { children: [_jsxs("div", { className: "flex items-center gap-3", children: [_jsx(Skeleton, { rounded: "lg", width: 36, height: 36 }), _jsx(Skeleton, { height: 12, width: "40%" })] }), _jsx(Skeleton, { height: 28, width: "55%" }), _jsx(Skeleton, { height: 10, width: "70%" })] })), variant === 'chart' && (_jsxs(_Fragment, { children: [_jsx(Skeleton, { height: 12, width: "35%" }), _jsxs("div", { className: "flex flex-1 items-end gap-2", children: [_jsx(Skeleton, { height: 48, className: "flex-1" }), _jsx(Skeleton, { height: 80, className: "flex-1" }), _jsx(Skeleton, { height: 64, className: "flex-1" }), _jsx(Skeleton, { height: 96, className: "flex-1" }), _jsx(Skeleton, { height: 72, className: "flex-1" })] }), _jsx(Skeleton, { height: 8, width: "90%" })] })), variant === 'table' && (_jsxs(_Fragment, { children: [_jsx(Skeleton, { height: 12, width: "60%" }), [0, 1, 2, 3].map((row) => (_jsxs("div", { className: "flex items-center gap-3", children: [_jsx(Skeleton, { height: 12, width: "25%" }), _jsx(Skeleton, { height: 12, className: "flex-1" }), _jsx(Skeleton, { height: 12, width: "15%" })] }, row)))] })), variant === 'list' && (_jsx(_Fragment, { children: [0, 1, 2].map((row) => (_jsxs("div", { className: "flex items-center gap-3", children: [_jsx(Skeleton, { rounded: "full", width: 32, height: 32 }), _jsxs("div", { className: "flex flex-1 flex-col gap-1.5", children: [_jsx(Skeleton, { height: 12, width: "60%" }), _jsx(Skeleton, { height: 10, width: "40%" })] }), _jsx(Skeleton, { height: 10, width: 48 })] }, row))) })), variant === 'block' && _jsx(Skeleton, { rounded: "lg", className: "min-h-24 flex-1" })] }));
+}
+//# sourceMappingURL=SkeletonSilhouette.js.map

package/dist/frame/SkeletonSilhouette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkeletonSilhouette.js","sourceRoot":"","sources":["../../src/frame/SkeletonSilhouette.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAcxC,MAAM,UAAU,kBAAkB,CAAC,EAAE,OAAO,EAA2B;IACrE,OAAO,CACL,4BACY,MAAM,2BACO,OAAO,EAC9B,SAAS,EAAC,4DAA4D,aAErE,OAAO,KAAK,MAAM,IAAI,CACrB,8BACE,eAAK,SAAS,EAAC,yBAAyB,aACtC,KAAC,QAAQ,IAAC,OAAO,EAAC,IAAI,EAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,GAAI,EAChD,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAC,KAAK,GAAG,IAChC,EACN,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAC,KAAK,GAAG,EACpC,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAC,KAAK,GAAG,IACnC,CACJ,EACA,OAAO,KAAK,OAAO,IAAI,CACtB,8BACE,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAC,KAAK,GAAG,EACpC,eAAK,SAAS,EAAC,6BAA6B,aAC1C,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAC,QAAQ,GAAG,EAC3C,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAC,QAAQ,GAAG,EAC3C,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAC,QAAQ,GAAG,EAC3C,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAC,QAAQ,GAAG,EAC3C,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAC,QAAQ,GAAG,IACvC,EACN,KAAC,QAAQ,IAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAC,KAAK,GAAG,IAClC,CACJ,EACA,OAAO,KAAK,OAAO,IAAI,CACtB,8BACE,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAC,KAAK,GAAG,EACnC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CACzB,eAAe,SAAS,EAAC,yBAAyB,aAChD,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAC,KAAK,GAAG,EACpC,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAC,QAAQ,GAAG,EAC3C,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAC,KAAK,GAAG,KAH5B,GAAG,CAIP,CACP,CAAC,IACD,CACJ,EACA,OAAO,KAAK,MAAM,IAAI,CACrB,4BACG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CACtB,eAAe,SAAS,EAAC,yBAAyB,aAChD,KAAC,QAAQ,IAAC,OAAO,EAAC,MAAM,EAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,GAAI,EAClD,eAAK,SAAS,EAAC,8BAA8B,aAC3C,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAC,KAAK,GAAG,EACpC,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAC,KAAK,GAAG,IAChC,EACN,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,GAAI,KAN3B,GAAG,CAOP,CACP,CAAC,GACD,CACJ,EACA,OAAO,KAAK,OAAO,IAAI,KAAC,QAAQ,IAAC,OAAO,EAAC,IAAI,EAAC,SAAS,EAAC,iBAAiB,GAAG,IACzE,CACP,CAAC;AACJ,CAAC"}

package/dist/frame/WidgetErrorBoundary.d.ts

@@ -0,0 +1,26 @@
+import { Component } from 'react';
+import type { ErrorInfo, ReactNode } from 'react';
+export interface WidgetErrorBoundaryProps {
+    children: ReactNode;
+    /** Render prop for the caught state; `reset` re-attempts the children. */
+    fallback: (error: Error, reset: () => void) => ReactNode;
+    /** Render errors additionally log (audit-trail hookup lands with 04-T04). */
+    onError?: ((error: Error, info: ErrorInfo) => void) | undefined;
+}
+interface State {
+    error: Error | null;
+}
+/**
+ * Error boundary around the lazy widget component (04 §4 loaded state). A
+ * throwing widget — including a crashing marketplace code widget (04 §9) —
+ * degrades to the frame's error state and never breaks sibling widgets.
+ */
+export declare class WidgetErrorBoundary extends Component<WidgetErrorBoundaryProps, State> {
+    state: State;
+    static getDerivedStateFromError(error: unknown): State;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    private readonly reset;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=WidgetErrorBoundary.d.ts.map

package/dist/frame/WidgetErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/frame/WidgetErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,SAAS,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;IACzD,6EAA6E;IAC7E,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACjE;AAED,UAAU,KAAK;IACb,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,SAAS,CAAC,wBAAwB,EAAE,KAAK,CAAC;IACxE,KAAK,EAAE,KAAK,CAAmB;IAExC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK;IAI7C,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAI/D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAEpB;IAEO,MAAM,IAAI,SAAS;CAI7B"}

package/dist/frame/WidgetErrorBoundary.js

@@ -0,0 +1,24 @@
+import { Component } from 'react';
+/**
+ * Error boundary around the lazy widget component (04 §4 loaded state). A
+ * throwing widget — including a crashing marketplace code widget (04 §9) —
+ * degrades to the frame's error state and never breaks sibling widgets.
+ */
+export class WidgetErrorBoundary extends Component {
+    state = { error: null };
+    static getDerivedStateFromError(error) {
+        return { error: error instanceof Error ? error : new Error(String(error)) };
+    }
+    componentDidCatch(error, info) {
+        this.props.onError?.(error, info);
+    }
+    reset = () => {
+        this.setState({ error: null });
+    };
+    render() {
+        if (this.state.error !== null)
+            return this.props.fallback(this.state.error, this.reset);
+        return this.props.children;
+    }
+}
+//# sourceMappingURL=WidgetErrorBoundary.js.map

package/dist/frame/WidgetErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetErrorBoundary.js","sourceRoot":"","sources":["../../src/frame/WidgetErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAelC;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAA0C;IACxE,KAAK,GAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAExC,MAAM,CAAC,wBAAwB,CAAC,KAAc;QAC5C,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IAC9E,CAAC;IAEQ,iBAAiB,CAAC,KAAY,EAAE,IAAe;QACtD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAEgB,KAAK,GAAG,GAAS,EAAE;QAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC;IAEO,MAAM;QACb,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACxF,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF"}

package/dist/frame/WidgetFrame.d.ts

@@ -0,0 +1,51 @@
+import type { ReactNode } from 'react';
+import type { WidgetSkeleton } from '../registry/types.js';
+/**
+ * WidgetFrame — the universal wrapper every grid-placed widget renders inside
+ * (04-widget-registry.md §4). It owns chrome (header: title, info popover,
+ * kebab menu slot, drag-grip slot) and the four states, so widget components
+ * only ever render the LOADED state.
+ */
+export type WidgetFrameState = 'loaded' | 'skeleton' | 'empty' | 'error';
+export interface WidgetFrameEmptyContent {
+    icon?: ReactNode;
+    title?: ReactNode;
+    body?: ReactNode;
+}
+export interface WidgetFrameProps {
+    /** Which of the four states to render (04 §4 table). */
+    state: WidgetFrameState;
+    /** Header title (config or auto-generated by the Engine). */
+    title?: ReactNode | undefined;
+    /** Info-popover content (descriptionKey text, binding summary, last refreshed). */
+    info?: ReactNode | undefined;
+    /** Kebab DropdownMenu items (Refresh · Edit · Duplicate · Export · Remove). */
+    menu?: ReactNode | undefined;
+    /**
+     * Drag-grip slot at inline-start of the header — render prop so the M7
+     * dashboard grid can hand in its dnd-kit handle; only passed in edit mode.
+     */
+    dragGrip?: ReactNode | (() => ReactNode) | undefined;
+    /** Silhouette for the skeleton state / lazy fallback (definition.skeleton). */
+    skeleton?: WidgetSkeleton | undefined;
+    /** Empty-state copy override (config.emptyState); default "No data for range". */
+    empty?: WidgetFrameEmptyContent | undefined;
+    /** Localized error message (never raw SQL/driver text — 04 §4). */
+    errorMessage?: ReactNode | undefined;
+    /** Retry button handler — re-runs the query. Also invoked after a render-error reset. */
+    onRetry?: (() => void) | undefined;
+    /** Render-throw hook (audit logging). */
+    onRenderError?: ((error: Error) => void) | undefined;
+    /** Stale-while-revalidate: keep `loaded`, show a small header spinner (04 §4). */
+    refetching?: boolean;
+    /**
+     * Frameless variant for `placement: 'page'` widgets — states only, no card
+     * chrome (04 §4). `inline`/`overlay` widgets skip WidgetFrame entirely.
+     */
+    frameless?: boolean;
+    testId?: string | undefined;
+    /** The loaded widget component (rendered inside an error boundary). */
+    children?: ReactNode;
+}
+export declare function WidgetFrame({ state, title, info, menu, dragGrip, skeleton, empty, errorMessage, onRetry, onRenderError, refetching, frameless, testId, children, }: WidgetFrameProps): import("react").JSX.Element;
+//# sourceMappingURL=WidgetFrame.d.ts.map

package/dist/frame/WidgetFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetFrame.d.ts","sourceRoot":"","sources":["../../src/frame/WidgetFrame.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,KAAK,EAAE,gBAAgB,CAAC;IACxB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,mFAAmF;IACnF,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,MAAM,SAAS,CAAC,GAAG,SAAS,CAAC;IACrD,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,kFAAkF;IAClF,KAAK,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC5C,mEAAmE;IACnE,YAAY,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC,yFAAyF;IACzF,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACnC,yCAAyC;IACzC,aAAa,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAgBD,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,QAAiB,EACjB,KAAK,EACL,YAAY,EACZ,OAAO,EACP,aAAa,EACb,UAAkB,EAClB,SAAiB,EACjB,MAAM,EACN,QAAQ,GACT,EAAE,gBAAgB,+BA0FlB"}

package/dist/frame/WidgetFrame.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Button, Card, DropdownMenu, DropdownMenuContent, DropdownMenuTrigger, EmptyState, IconButton, IconTile, Popover, PopoverContent, PopoverTrigger, Spinner, } from '@adminium/ui';
+import { AlertTriangle, EllipsisVertical, Info, RotateCcw } from 'lucide-react';
+import { SkeletonSilhouette } from './SkeletonSilhouette.js';
+import { WidgetErrorBoundary } from './WidgetErrorBoundary.js';
+function ErrorBody({ message, onRetry }) {
+    return (_jsxs("div", { role: "alert", className: "flex flex-col items-center gap-3 px-4 py-8 text-center compact:py-6", children: [_jsx(IconTile, { tone: "danger", size: "lg", icon: _jsx(AlertTriangle, {}) }), _jsx("p", { className: "max-w-[320px] text-body-sm text-fg-muted", children: message }), onRetry === undefined ? null : (_jsx(Button, { size: "sm", variant: "secondary", iconLeft: _jsx(RotateCcw, {}), onClick: onRetry, children: "Retry" }))] }));
+}
+export function WidgetFrame({ state, title, info, menu, dragGrip, skeleton = 'card', empty, errorMessage, onRetry, onRenderError, refetching = false, frameless = false, testId, children, }) {
+    const grip = typeof dragGrip === 'function' ? dragGrip() : dragGrip;
+    const hasHeader = title !== undefined || info !== undefined || menu !== undefined || grip !== undefined;
+    const body = (() => {
+        switch (state) {
+            case 'skeleton':
+                return _jsx(SkeletonSilhouette, { variant: skeleton });
+            case 'empty':
+                return (_jsx(EmptyState, { compact: true, preset: "no-data", ...(empty?.icon !== undefined ? { icon: empty.icon } : {}), title: empty?.title ?? 'No data for range', ...(empty?.body !== undefined ? { body: empty.body } : {}) }));
+            case 'error':
+                return _jsx(ErrorBody, { message: errorMessage ?? 'Something went wrong loading this widget.', onRetry: onRetry });
+            case 'loaded':
+                return (_jsx(WidgetErrorBoundary, { onError: onRenderError === undefined ? undefined : (error) => onRenderError(error), fallback: (error, reset) => (_jsx(ErrorBody, { message: errorMessage ?? error.message ?? 'This widget failed to render.', onRetry: () => {
+                            reset();
+                            onRetry?.();
+                        } })), children: children }));
+        }
+    })();
+    const content = (_jsxs(_Fragment, { children: [hasHeader && (_jsxs("header", { className: "flex min-h-10 items-center gap-1.5 px-4 pt-3 compact:px-3 compact:pt-2", children: [grip, _jsx("h3", { className: "min-w-0 flex-1 truncate text-body-sm font-semibold text-fg", children: title }), refetching && _jsx(Spinner, { size: "sm", label: "Refreshing", className: "text-fg-muted" }), info !== undefined && (_jsxs(Popover, { children: [_jsx(PopoverTrigger, { asChild: true, children: _jsx(IconButton, { size: "sm", label: "Widget info", children: _jsx(Info, { size: 14 }) }) }), _jsx(PopoverContent, { align: "end", className: "max-w-72 text-body-sm text-fg-muted", children: info })] })), menu !== undefined && (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(IconButton, { size: "sm", label: "Widget menu", children: _jsx(EllipsisVertical, { size: 14 }) }) }), _jsx(DropdownMenuContent, { align: "end", children: menu })] }))] })), _jsx("div", { className: "min-h-0 flex-1", children: body })] }));
+    if (frameless) {
+        return (_jsx("section", { "data-widget-frame": true, "data-state": state, "data-testid": testId, className: "flex h-full flex-col", children: content }));
+    }
+    return (_jsx(Card, { asChild: true, padded: false, children: _jsx("section", { "data-widget-frame": true, "data-state": state, "data-testid": testId, className: "flex h-full flex-col overflow-hidden", children: content }) }));
+}
+//# sourceMappingURL=WidgetFrame.js.map

package/dist/frame/WidgetFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetFrame.js","sourceRoot":"","sources":["../../src/frame/WidgetFrame.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,MAAM,EACN,IAAI,EACJ,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,OAAO,EACP,cAAc,EACd,cAAc,EACd,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAqD/D,SAAS,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAA8D;IACjG,OAAO,CACL,eAAK,IAAI,EAAC,OAAO,EAAC,SAAS,EAAC,qEAAqE,aAC/F,KAAC,QAAQ,IAAC,IAAI,EAAC,QAAQ,EAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAE,KAAC,aAAa,KAAG,GAAI,EAC7D,YAAG,SAAS,EAAC,0CAA0C,YAAE,OAAO,GAAK,EACpE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC9B,KAAC,MAAM,IAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAC,WAAW,EAAC,QAAQ,EAAE,KAAC,SAAS,KAAG,EAAE,OAAO,EAAE,OAAO,sBAEtE,CACV,IACG,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAC1B,KAAK,EACL,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,QAAQ,GAAG,MAAM,EACjB,KAAK,EACL,YAAY,EACZ,OAAO,EACP,aAAa,EACb,UAAU,GAAG,KAAK,EAClB,SAAS,GAAG,KAAK,EACjB,MAAM,EACN,QAAQ,GACS;IACjB,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IACpE,MAAM,SAAS,GACb,KAAK,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,CAAC;IAExF,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE;QACjB,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,UAAU;gBACb,OAAO,KAAC,kBAAkB,IAAC,OAAO,EAAE,QAAQ,GAAI,CAAC;YACnD,KAAK,OAAO;gBACV,OAAO,CACL,KAAC,UAAU,IACT,OAAO,QACP,MAAM,EAAC,SAAS,KACZ,CAAC,KAAK,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAC3D,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,mBAAmB,KACtC,CAAC,KAAK,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAC3D,CACH,CAAC;YACJ,KAAK,OAAO;gBACV,OAAO,KAAC,SAAS,IAAC,OAAO,EAAE,YAAY,IAAI,2CAA2C,EAAE,OAAO,EAAE,OAAO,GAAI,CAAC;YAC/G,KAAK,QAAQ;gBACX,OAAO,CACL,KAAC,mBAAmB,IAClB,OAAO,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAClF,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAC1B,KAAC,SAAS,IACR,OAAO,EAAE,YAAY,IAAI,KAAK,CAAC,OAAO,IAAI,+BAA+B,EACzE,OAAO,EAAE,GAAG,EAAE;4BACZ,KAAK,EAAE,CAAC;4BACR,OAAO,EAAE,EAAE,CAAC;wBACd,CAAC,GACD,CACH,YAEA,QAAQ,GACW,CACvB,CAAC;QACN,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,MAAM,OAAO,GAAG,CACd,8BACG,SAAS,IAAI,CACZ,kBAAQ,SAAS,EAAC,wEAAwE,aACvF,IAAI,EACL,aAAI,SAAS,EAAC,4DAA4D,YAAE,KAAK,GAAM,EACtF,UAAU,IAAI,KAAC,OAAO,IAAC,IAAI,EAAC,IAAI,EAAC,KAAK,EAAC,YAAY,EAAC,SAAS,EAAC,eAAe,GAAG,EAChF,IAAI,KAAK,SAAS,IAAI,CACrB,MAAC,OAAO,eACN,KAAC,cAAc,IAAC,OAAO,kBACrB,KAAC,UAAU,IAAC,IAAI,EAAC,IAAI,EAAC,KAAK,EAAC,aAAa,YACvC,KAAC,IAAI,IAAC,IAAI,EAAE,EAAE,GAAI,GACP,GACE,EACjB,KAAC,cAAc,IAAC,KAAK,EAAC,KAAK,EAAC,SAAS,EAAC,qCAAqC,YACxE,IAAI,GACU,IACT,CACX,EACA,IAAI,KAAK,SAAS,IAAI,CACrB,MAAC,YAAY,eACX,KAAC,mBAAmB,IAAC,OAAO,kBAC1B,KAAC,UAAU,IAAC,IAAI,EAAC,IAAI,EAAC,KAAK,EAAC,aAAa,YACvC,KAAC,gBAAgB,IAAC,IAAI,EAAE,EAAE,GAAI,GACnB,GACO,EACtB,KAAC,mBAAmB,IAAC,KAAK,EAAC,KAAK,YAAE,IAAI,GAAuB,IAChD,CAChB,IACM,CACV,EACD,cAAK,SAAS,EAAC,gBAAgB,YAAE,IAAI,GAAO,IAC3C,CACJ,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CACL,2DAAuC,KAAK,iBAAe,MAAM,EAAE,SAAS,EAAC,sBAAsB,YAChG,OAAO,GACA,CACX,CAAC;IACJ,CAAC;IACD,OAAO,CACL,KAAC,IAAI,IAAC,OAAO,QAAC,MAAM,EAAE,KAAK,YACzB,2DAAuC,KAAK,iBAAe,MAAM,EAAE,SAAS,EAAC,sCAAsC,YAChH,OAAO,GACA,GACL,CACR,CAAC;AACJ,CAAC"}

package/dist/frame/WidgetHost.d.ts

@@ -0,0 +1,54 @@
+import type { ReactNode } from 'react';
+import type { WidgetDefinition, WidgetEvent } from '../registry/types.js';
+/**
+ * The data state handed to WidgetHost by the page renderer. DECISION (04
+ * §5.3): @adminium/widgets stays free of @tanstack/react-query — the
+ * `useWidgetData` hook (TanStack Query, batching, refreshInterval, params)
+ * lives in apps/dashboard (04-T03 binding layer), and this shape mirrors a
+ * TanStack Query result so the hook's output spreads straight in. Storybook
+ * and demo mode pass `{ status: 'success', data: demoData(seed) }` directly.
+ */
+export interface WidgetDataState<T = unknown> {
+    status: 'loading' | 'error' | 'success';
+    data?: T | undefined;
+    error?: unknown;
+    refetch?: (() => void) | undefined;
+    /** Stale-while-revalidate: true keeps `loaded` + header spinner (04 §4). */
+    isRefetching?: boolean | undefined;
+}
+export interface WidgetHostProps {
+    /** Registry id from the stored page config (`layout.items[].widget`). */
+    widgetId: string;
+    /** Widget instance id (`layout.items[].i`, nanoid). */
+    instanceId: string;
+    /** Raw stored instance config — validated here on mount (04 §2.2). */
+    config?: unknown;
+    data: WidgetDataState;
+    onEvent?: ((event: WidgetEvent) => void) | undefined;
+    /** Drag-grip render slot, forwarded to WidgetFrame (edit mode, M7). */
+    dragGrip?: ReactNode | (() => ReactNode) | undefined;
+    /** Kebab menu items, forwarded to WidgetFrame. */
+    menu?: ReactNode | undefined;
+    /** Info popover content override (defaults to the definition's descriptionKey). */
+    info?: ReactNode | undefined;
+    /**
+     * Registry override for tests and the manifest extension host; defaults to
+     * the global registry.
+     */
+    registry?: ReadonlyMap<string, WidgetDefinition> | undefined;
+}
+/**
+ * WidgetHost — binds a WidgetDefinition + stored instance config + a data
+ * state to WidgetFrame and the lazy widget component (04 §2.2, §4):
+ *
+ * - unknown widget id → the `widget-missing` system card, never a crash;
+ * - `map-*` → `map-choropleth-grid` under the offline asset policy, so the
+ *   desktop app never imports a map engine (11-electron.md §7; registry/offline.ts);
+ * - `validateInstanceConfig` on mount, per-field default fallback + one
+ *   structured console warning;
+ * - loading → skeleton silhouette; error → error card + Retry (refetch);
+ * - success + `isEmpty(data)` per the definition's dataContract → empty state;
+ * - lazy chunk loading → Suspense falls back to the same silhouette.
+ */
+export declare function WidgetHost({ widgetId, instanceId, config, data, onEvent, dragGrip, menu, info, registry, }: WidgetHostProps): import("react").JSX.Element;
+//# sourceMappingURL=WidgetHost.d.ts.map

package/dist/frame/WidgetHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetHost.d.ts","sourceRoot":"","sources":["../../src/frame/WidgetHost.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE1E;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACxC,IAAI,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACnC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,uEAAuE;IACvE,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,MAAM,SAAS,CAAC,GAAG,SAAS,CAAC;IACrD,kDAAkD;IAClD,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,mFAAmF;IACnF,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,CAAC;CAC9D;AAUD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,UAAU,EACV,MAAM,EACN,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,QAAQ,GACT,EAAE,eAAe,+BAqFjB"}

package/dist/frame/WidgetHost.js

@@ -0,0 +1,84 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Suspense, useEffect, useMemo } from 'react';
+import { isEmptyData } from '../registry/data-empty.js';
+import { logConfigWarnings, validateConfigAgainst, widgetRegistry } from '../registry/index.js';
+import { widgetMissingDefinition } from '../registry/widget-missing.js';
+import { SkeletonSilhouette } from './SkeletonSilhouette.js';
+import { WidgetFrame } from './WidgetFrame.js';
+import { useResolvedWidgetId } from './WidgetRuntimeContext.js';
+const noopEvent = () => { };
+function errorMessageOf(error) {
+    if (error instanceof Error && error.message !== '')
+        return error.message;
+    if (typeof error === 'string' && error !== '')
+        return error;
+    return undefined;
+}
+/**
+ * WidgetHost — binds a WidgetDefinition + stored instance config + a data
+ * state to WidgetFrame and the lazy widget component (04 §2.2, §4):
+ *
+ * - unknown widget id → the `widget-missing` system card, never a crash;
+ * - `map-*` → `map-choropleth-grid` under the offline asset policy, so the
+ *   desktop app never imports a map engine (11-electron.md §7; registry/offline.ts);
+ * - `validateInstanceConfig` on mount, per-field default fallback + one
+ *   structured console warning;
+ * - loading → skeleton silhouette; error → error card + Retry (refetch);
+ * - success + `isEmpty(data)` per the definition's dataContract → empty state;
+ * - lazy chunk loading → Suspense falls back to the same silhouette.
+ */
+export function WidgetHost({ widgetId, instanceId, config, data, onEvent, dragGrip, menu, info, registry, }) {
+    const map = registry ?? widgetRegistry;
+    // §7's offline asset policy, applied BEFORE the map is read — resolving the id
+    // is what keeps the map chunk (and Leaflet behind it) from ever being imported
+    // in the desktop shell. Identity online, so self-host/Cloud are untouched.
+    // A custom `registry` that lacks the fallback target renders widget-missing
+    // rather than the map: in an offline runtime that is the conservative answer,
+    // and `registry/offline.test.tsx` pins the target's presence in the real map.
+    const resolvedId = useResolvedWidgetId(widgetId);
+    const resolved = map.get(resolvedId);
+    const missing = resolved === undefined;
+    const definition = resolved ?? widgetMissingDefinition;
+    const parsed = useMemo(() => {
+        const validated = validateConfigAgainst(definition, config);
+        if (!missing)
+            return validated;
+        // Carry the missing id for the fallback card, plus a structured warning.
+        return {
+            config: { ...validated.config, missingId: widgetId },
+            warnings: [
+                {
+                    widgetId,
+                    path: '',
+                    code: 'unknown-widget',
+                    message: `No widget registered as '${widgetId}'; rendering the widget-missing fallback`,
+                },
+                ...validated.warnings,
+            ],
+        };
+    }, [definition, missing, widgetId, config]);
+    useEffect(() => {
+        logConfigWarnings(instanceId, parsed);
+    }, [instanceId, parsed]);
+    const state = missing
+        ? 'loaded'
+        : data.status === 'loading'
+            ? 'skeleton'
+            : data.status === 'error'
+                ? 'error'
+                : isEmptyData(data.data, definition.dataContract)
+                    ? 'empty'
+                    : 'loaded';
+    const cfg = parsed.config;
+    const emptyOverride = cfg.emptyState;
+    const Component = definition.component;
+    const frameless = definition.placement === 'page';
+    return (_jsx(WidgetFrame, { state: state, title: typeof cfg.title === 'string' ? cfg.title : undefined, info: info ?? definition.descriptionKey, menu: menu, dragGrip: dragGrip, skeleton: definition.skeleton, 
+        // titleKey/bodyKey are i18n keys — the dashboard resolves them via
+        // @adminium/i18n; passed through raw here so overrides stay visible
+        // even before the i18n hookup (04-T06 wires the translator).
+        empty: emptyOverride === undefined
+            ? undefined
+            : { title: emptyOverride.titleKey, body: emptyOverride.bodyKey }, errorMessage: data.status === 'error' ? errorMessageOf(data.error) : undefined, onRetry: data.refetch, refetching: data.isRefetching === true, frameless: frameless, testId: typeof cfg.testId === 'string' ? cfg.testId : undefined, children: _jsx(Suspense, { fallback: _jsx(SkeletonSilhouette, { variant: definition.skeleton }), children: _jsx(Component, { config: cfg, data: data.data, instanceId: instanceId, onEvent: onEvent ?? noopEvent }) }) }));
+}
+//# sourceMappingURL=WidgetHost.js.map

package/dist/frame/WidgetHost.js.map

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

package/dist/frame/WidgetRuntimeContext.d.ts

@@ -0,0 +1,58 @@
+/**
+ * React context carrying the host app's {@link WidgetRuntimeEnv} to WidgetHost —
+ * the input to §7's offline asset policy (11-electron.md §7, 11-T09).
+ *
+ * Mirrors `binding/StreamTransportContext.tsx`: the host app (`apps/dashboard`)
+ * decides once and provides here; the widgets package reads. It stays a context
+ * rather than a module-level setting because the value is a property of the
+ * running app, not of the module, and a mutable module global would make two
+ * suites in one process fight over it.
+ *
+ * SYNCHRONOUS BY DESIGN. The default is the browser, so an absent provider means
+ * "online" — and that is why the provider must sit above every widget-rendering
+ * route rather than be resolved from a query: a provider that arrived one render
+ * late would let a `map-bubble` mount, and the Leaflet chunk fetch it triggers is
+ * exactly the network touch the desktop app promises never to make. See
+ * `apps/dashboard/src/lib/widget-runtime.ts` for why the bridge, not
+ * `GET /api/v1/system/info`, is what feeds it.
+ */
+import { type ReactNode } from 'react';
+import { type WidgetRuntimeEnv } from '../registry/offline.js';
+export interface WidgetRuntimeProviderProps {
+    env: WidgetRuntimeEnv;
+    children: ReactNode;
+}
+/**
+ * Provide the runtime env to descendant widgets. Pass a STABLE `env` (a module
+ * const, or a memo) — this is context, so a fresh object per render re-renders
+ * every WidgetHost below it.
+ */
+export declare function WidgetRuntimeProvider({ env, children }: WidgetRuntimeProviderProps): import("react").JSX.Element;
+/** The provided env, or {@link DEFAULT_WIDGET_RUNTIME_ENV} without a provider. */
+export declare function useWidgetRuntimeEnv(): WidgetRuntimeEnv;
+/**
+ * §7's offline asset policy applied to a stored widget id — the id that will
+ * actually MOUNT in this runtime.
+ *
+ * ─── ANYTHING THAT LOOKS A WIDGET UP MUST GO THROUGH THIS ───────────────────
+ *
+ * A stored `map-bubble` mounts as `map-choropleth-grid` on desktop. Any code
+ * that reads the registry with the STORED id therefore gets a definition for a
+ * component that is not the one on screen — and the two disagree about their
+ * data contract, which is the interesting part.
+ *
+ * That is not hypothetical; it shipped. `useDashboardData` generated demo data
+ * from `registry.get(item.widget)`, so an unbound `map-bubble` on desktop
+ * produced `mapBubbleDemoData`'s `{points:[{name,lat,lng}]}` and handed it to
+ * `MapChoroplethGridWidget`, which needs `points[].code`. `choroplethLayout`
+ * skips every point whose code is absent from `US_TILEGRAM`, so ZERO tiles were
+ * placed — while `points.length` of 10 kept `isEmptyData` reporting 'loaded', so
+ * no empty state intervened either. The user saw a blank US map captioned with a
+ * top-5 list of world cities (Tokyo, London, New York, Berlin, Cairo) instead of
+ * §7's "designed fallback".
+ *
+ * Resolve FIRST, then look up. The identity case (any online runtime) costs
+ * nothing.
+ */
+export declare function useResolvedWidgetId(widgetId: string): string;
+//# sourceMappingURL=WidgetRuntimeContext.d.ts.map

package/dist/frame/WidgetRuntimeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetRuntimeContext.d.ts","sourceRoot":"","sources":["../../src/frame/WidgetRuntimeContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,gBAAgB,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,0BAA0B,+BAElF;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,IAAI,gBAAgB,CAEtD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D"}