@adminiumjs/widgets 0.1.0-rc.1

package/dist/registry/offline.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Offline asset policy for the widget registry (11-electron.md §7, 11-T09).
+ *
+ * §7's maps row, in full:
+ *
+ * > Leaflet is **never loaded** in desktop runtime; the geo widget family renders
+ * > its designed fallback, the choropleth/tilegram grid. The widget registry
+ * > resolves `map-*` widgets to `choropleth-grid` when `runtime === "desktop"` or
+ * > `offlineAssets === true`.
+ *
+ * WHY THE REGISTRY AND NOT THE WIDGET. `map-bubble`'s component already degrades
+ * on its own — it catches a failed `await import('leaflet')` and renders the
+ * ranked companion list under a "map unavailable" notice. That is the right
+ * behavior for a self-host box whose CDN is briefly unreachable, and the wrong
+ * one for the desktop app: the chunk fetch and the tile requests would still be
+ * ATTEMPTED (§7's smoke test asserts zero of them), the user would see an error
+ * state where a working visual belongs, and the guarantee would depend on a
+ * component's catch block rather than on the app never asking for a map. Resolving
+ * one id to another BEFORE the lazy ref is read means the map chunk is never
+ * imported, so Leaflet is not loaded — it is not even requested.
+ *
+ * `map-*` IS A PREFIX RULE, NOT A TWO-ENTRY TABLE, and that is deliberate: the
+ * annex §7 family is open, and a future `map-heat`/`map-routes` would otherwise
+ * ship a map engine into the offline build on the day it landed, silently and with
+ * every gate green. The rule reads the way §7 states it, so new map ids are
+ * covered by default and opting one OUT is the change that has to be argued for.
+ *
+ * Pure module — no React, no registry map import. The resolution runs in
+ * `frame/WidgetHost.tsx` (the single mount path for every registry widget), fed
+ * by `WidgetRuntimeProvider`; see those two files for the wiring.
+ */
+/** Which wrapper is running the SPA (11-electron.md §4 detection contract). */
+export type WidgetRuntime = 'browser' | 'desktop';
+export interface WidgetRuntimeEnv {
+    /** `desktop` ⇒ the Electron shell (§2.1), which must never touch the network. */
+    runtime: WidgetRuntime;
+    /**
+     * Force the offline policy on a non-desktop runtime — §7's second trigger.
+     * Self-host behind an air-gap is the case that exists today; the offline smoke
+     * test (11-T18) is the case that exercises it without an Electron shell.
+     */
+    offlineAssets: boolean;
+}
+/**
+ * What every surface without a provider gets: the plain browser. Self-host and
+ * Cloud serve the identical bundle and are online by definition, so this is the
+ * honest default rather than a placeholder — and it is why an un-wrapped test or
+ * story still renders the real map.
+ */
+export declare const DEFAULT_WIDGET_RUNTIME_ENV: WidgetRuntimeEnv;
+/** §7's `map-*`. Every id under it is network-bearing until proven otherwise. */
+export declare const MAP_WIDGET_PREFIX = "map-";
+/**
+ * §7's `choropleth-grid` — the geo family's designed offline fallback: an SVG
+ * tilegram over `@adminium/charts` (dependency-light, no tiles, no engine).
+ * It is itself `map-*`-prefixed, so the rule below is idempotent on it.
+ */
+export declare const OFFLINE_MAP_FALLBACK_ID = "map-choropleth-grid";
+/** §7's two triggers, in one place so they cannot drift between call sites. */
+export declare function offlineAssetsRequired(env: WidgetRuntimeEnv): boolean;
+/**
+ * The registry id a runtime should actually mount for a stored id (§7).
+ *
+ * Online → identity, always: this must be invisible on self-host and Cloud, where
+ * a placed bubble map is a bubble map. Offline → every `map-*` id collapses onto
+ * the tilegram, including `map-choropleth-grid` itself (a no-op, by construction).
+ *
+ * Stored page config is NOT rewritten. The same `map-bubble` row keeps rendering a
+ * real map on self-host and a tilegram in the desktop app, which is the point:
+ * one config document, two runtimes, no migration when a database moves between
+ * them.
+ */
+export declare function resolveOfflineWidgetId(id: string, env: WidgetRuntimeEnv): string;
+//# sourceMappingURL=offline.d.ts.map

package/dist/registry/offline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.d.ts","sourceRoot":"","sources":["../../src/registry/offline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,OAAO,EAAE,aAAa,CAAC;IACvB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,gBAA+D,CAAC;AAEzG,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAE7D,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAEpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAGhF"}

package/dist/registry/offline.js

@@ -0,0 +1,68 @@
+/**
+ * Offline asset policy for the widget registry (11-electron.md §7, 11-T09).
+ *
+ * §7's maps row, in full:
+ *
+ * > Leaflet is **never loaded** in desktop runtime; the geo widget family renders
+ * > its designed fallback, the choropleth/tilegram grid. The widget registry
+ * > resolves `map-*` widgets to `choropleth-grid` when `runtime === "desktop"` or
+ * > `offlineAssets === true`.
+ *
+ * WHY THE REGISTRY AND NOT THE WIDGET. `map-bubble`'s component already degrades
+ * on its own — it catches a failed `await import('leaflet')` and renders the
+ * ranked companion list under a "map unavailable" notice. That is the right
+ * behavior for a self-host box whose CDN is briefly unreachable, and the wrong
+ * one for the desktop app: the chunk fetch and the tile requests would still be
+ * ATTEMPTED (§7's smoke test asserts zero of them), the user would see an error
+ * state where a working visual belongs, and the guarantee would depend on a
+ * component's catch block rather than on the app never asking for a map. Resolving
+ * one id to another BEFORE the lazy ref is read means the map chunk is never
+ * imported, so Leaflet is not loaded — it is not even requested.
+ *
+ * `map-*` IS A PREFIX RULE, NOT A TWO-ENTRY TABLE, and that is deliberate: the
+ * annex §7 family is open, and a future `map-heat`/`map-routes` would otherwise
+ * ship a map engine into the offline build on the day it landed, silently and with
+ * every gate green. The rule reads the way §7 states it, so new map ids are
+ * covered by default and opting one OUT is the change that has to be argued for.
+ *
+ * Pure module — no React, no registry map import. The resolution runs in
+ * `frame/WidgetHost.tsx` (the single mount path for every registry widget), fed
+ * by `WidgetRuntimeProvider`; see those two files for the wiring.
+ */
+/**
+ * What every surface without a provider gets: the plain browser. Self-host and
+ * Cloud serve the identical bundle and are online by definition, so this is the
+ * honest default rather than a placeholder — and it is why an un-wrapped test or
+ * story still renders the real map.
+ */
+export const DEFAULT_WIDGET_RUNTIME_ENV = { runtime: 'browser', offlineAssets: false };
+/** §7's `map-*`. Every id under it is network-bearing until proven otherwise. */
+export const MAP_WIDGET_PREFIX = 'map-';
+/**
+ * §7's `choropleth-grid` — the geo family's designed offline fallback: an SVG
+ * tilegram over `@adminium/charts` (dependency-light, no tiles, no engine).
+ * It is itself `map-*`-prefixed, so the rule below is idempotent on it.
+ */
+export const OFFLINE_MAP_FALLBACK_ID = 'map-choropleth-grid';
+/** §7's two triggers, in one place so they cannot drift between call sites. */
+export function offlineAssetsRequired(env) {
+    return env.runtime === 'desktop' || env.offlineAssets;
+}
+/**
+ * The registry id a runtime should actually mount for a stored id (§7).
+ *
+ * Online → identity, always: this must be invisible on self-host and Cloud, where
+ * a placed bubble map is a bubble map. Offline → every `map-*` id collapses onto
+ * the tilegram, including `map-choropleth-grid` itself (a no-op, by construction).
+ *
+ * Stored page config is NOT rewritten. The same `map-bubble` row keeps rendering a
+ * real map on self-host and a tilegram in the desktop app, which is the point:
+ * one config document, two runtimes, no migration when a database moves between
+ * them.
+ */
+export function resolveOfflineWidgetId(id, env) {
+    if (!offlineAssetsRequired(env))
+        return id;
+    return id.startsWith(MAP_WIDGET_PREFIX) ? OFFLINE_MAP_FALLBACK_ID : id;
+}
+//# sourceMappingURL=offline.js.map

package/dist/registry/offline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.js","sourceRoot":"","sources":["../../src/registry/offline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAgBH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqB,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAEzG,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE7D,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,GAAqB;IACzD,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,aAAa,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAU,EAAE,GAAqB;IACtE,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3C,OAAO,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;AACzE,CAAC"}

package/dist/registry/page-templates.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Page-template registry — the single source of truth for which page templates
+ * `@adminium/widgets` can render (04-widget-registry.md §10; 09-generated-app.md
+ * §7). The LLM allow-lists (`llm-allowlist.ts`) derive from this map, so a
+ * template the runtime cannot mount can never be recommended to, or accepted
+ * from, the model (06-llm-assist.md §5 decision 6). A Studio template picker
+ * does not exist yet; when one is built it should consume this registry the
+ * same way (see `descriptionKey` below for the i18n contract it must follow).
+ *
+ * The runtime ships fourteen templates (mirroring `builtinTemplates` in the
+ * dashboard's `pages/templates.tsx`):
+ *   - `page-crud`      — the per-table resource template, generated for EVERY
+ *                        table, therefore renderable but never LLM-recommended.
+ *   - `page-dashboard` — the widget-grid template.
+ *   - the twelve M7 wave-2 templates. The nine data-shaped archetypes
+ *     (`page-board` … `page-chat`) are recommendable — each is emittable by a
+ *     §14 auto-trigger (`archetypes.ts`) and materializable from an accepted
+ *     LLM suggestion (`composeRequestedArchetype`). The three tool surfaces
+ *     (`page-builder`, `page-wizard`, `page-settings`) are renderable but NOT
+ *     recommendable: they are platform/tool pages, not
+ *     per-table archetypes, and the §8.3 materialization path cannot compose
+ *     them (no `ARCHETYPE_NAV` placement), so an accepted suggestion could
+ *     never become a working page.
+ *
+ * New templates register by appending a `PageTemplateDefinition` to
+ * `pageTemplateDefinitions`; every list derived from this registry then grows
+ * automatically — there is no parallel hand-maintained id list to keep in sync.
+ *
+ * Metadata only: the heavy React template components live under
+ * `src/templates/*` and mount through the dashboard PageRenderer, never here, so
+ * this module (and the allow-lists that read it) stay lightweight and
+ * browser-safe.
+ */
+export interface PageTemplateDefinition {
+    /** kebab-case template id — matches the stored `page.template` value. */
+    id: string;
+    /**
+     * Whether the LLM may *recommend* this template for a user table. `page-crud`
+     * is always generated for every table, so it is renderable but never
+     * recommendable (06-llm-assist.md §5 decision 6 — "page-crud is always
+     * generated and must not be recommended"). All other templates are
+     * recommendable candidates the model ranks per table.
+     */
+    recommendable: boolean;
+    /**
+     * i18n key reserved for a future Studio template picker's label/tooltip,
+     * following `templates.<camelCaseId>.description` (pinned by
+     * `page-templates.test.ts`). NOT resolvable today: no locale catalog carries
+     * these keys and nothing in the running app consumes them yet. A consumer
+     * must therefore render `t(descriptionKey, humanize(id))`-style — key with a
+     * humanized-id fallback, exactly how the dashboard `WidgetPalette` consumes
+     * widget `descriptionKey`s — or add the catalog entries when it lands.
+     */
+    descriptionKey: string;
+}
+/**
+ * Registry id of the per-table CRUD template. Mirrors `PAGE_CRUD_TEMPLATE_ID`
+ * exported by `templates/page-crud` (a regression test in
+ * `page-templates.test.ts` pins the two together so they cannot drift) — kept
+ * as a literal here so the lightweight registry never imports the heavy
+ * component module.
+ */
+export declare const PAGE_CRUD_TEMPLATE_ID = "page-crud";
+/** Registry id of the dashboard widget-grid template. */
+export declare const PAGE_DASHBOARD_TEMPLATE_ID = "page-dashboard";
+/**
+ * Every page template the runtime ships today, in nav/importance order. Append
+ * here when a new template component lands; the allow-lists follow automatically.
+ */
+export declare const pageTemplateDefinitions: readonly PageTemplateDefinition[];
+export declare class DuplicatePageTemplateIdError extends Error {
+    readonly templateId: string;
+    constructor(templateId: string);
+}
+/** Build an id→definition map; duplicate ids throw at module init. */
+export declare function buildPageTemplateRegistry(definitions: readonly PageTemplateDefinition[]): ReadonlyMap<string, PageTemplateDefinition>;
+export declare const pageTemplateRegistry: ReadonlyMap<string, PageTemplateDefinition>;
+export declare function getPageTemplate(id: string): PageTemplateDefinition | undefined;
+//# sourceMappingURL=page-templates.d.ts.map

package/dist/registry/page-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-templates.d.ts","sourceRoot":"","sources":["../../src/registry/page-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;OAMG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;;;;;;;OAQG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,cAAc,CAAC;AAEjD,yDAAyD;AACzD,eAAO,MAAM,0BAA0B,mBAAmB,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,sBAAsB,EAgCpE,CAAC;AAEF,qBAAa,4BAA6B,SAAQ,KAAK;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAIxC;AAED,sEAAsE;AACtE,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,SAAS,sBAAsB,EAAE,GAC7C,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAO7C;AAED,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CACzB,CAAC;AAErD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAE9E"}

package/dist/registry/page-templates.js

@@ -0,0 +1,103 @@
+/**
+ * Page-template registry — the single source of truth for which page templates
+ * `@adminium/widgets` can render (04-widget-registry.md §10; 09-generated-app.md
+ * §7). The LLM allow-lists (`llm-allowlist.ts`) derive from this map, so a
+ * template the runtime cannot mount can never be recommended to, or accepted
+ * from, the model (06-llm-assist.md §5 decision 6). A Studio template picker
+ * does not exist yet; when one is built it should consume this registry the
+ * same way (see `descriptionKey` below for the i18n contract it must follow).
+ *
+ * The runtime ships fourteen templates (mirroring `builtinTemplates` in the
+ * dashboard's `pages/templates.tsx`):
+ *   - `page-crud`      — the per-table resource template, generated for EVERY
+ *                        table, therefore renderable but never LLM-recommended.
+ *   - `page-dashboard` — the widget-grid template.
+ *   - the twelve M7 wave-2 templates. The nine data-shaped archetypes
+ *     (`page-board` … `page-chat`) are recommendable — each is emittable by a
+ *     §14 auto-trigger (`archetypes.ts`) and materializable from an accepted
+ *     LLM suggestion (`composeRequestedArchetype`). The three tool surfaces
+ *     (`page-builder`, `page-wizard`, `page-settings`) are renderable but NOT
+ *     recommendable: they are platform/tool pages, not
+ *     per-table archetypes, and the §8.3 materialization path cannot compose
+ *     them (no `ARCHETYPE_NAV` placement), so an accepted suggestion could
+ *     never become a working page.
+ *
+ * New templates register by appending a `PageTemplateDefinition` to
+ * `pageTemplateDefinitions`; every list derived from this registry then grows
+ * automatically — there is no parallel hand-maintained id list to keep in sync.
+ *
+ * Metadata only: the heavy React template components live under
+ * `src/templates/*` and mount through the dashboard PageRenderer, never here, so
+ * this module (and the allow-lists that read it) stay lightweight and
+ * browser-safe.
+ */
+/**
+ * Registry id of the per-table CRUD template. Mirrors `PAGE_CRUD_TEMPLATE_ID`
+ * exported by `templates/page-crud` (a regression test in
+ * `page-templates.test.ts` pins the two together so they cannot drift) — kept
+ * as a literal here so the lightweight registry never imports the heavy
+ * component module.
+ */
+export const PAGE_CRUD_TEMPLATE_ID = 'page-crud';
+/** Registry id of the dashboard widget-grid template. */
+export const PAGE_DASHBOARD_TEMPLATE_ID = 'page-dashboard';
+/**
+ * Every page template the runtime ships today, in nav/importance order. Append
+ * here when a new template component lands; the allow-lists follow automatically.
+ */
+export const pageTemplateDefinitions = [
+    { id: PAGE_CRUD_TEMPLATE_ID, recommendable: false, descriptionKey: 'templates.pageCrud.description' },
+    {
+        id: PAGE_DASHBOARD_TEMPLATE_ID,
+        recommendable: true,
+        descriptionKey: 'templates.pageDashboard.description',
+    },
+    // M7 wave 2 — planning archetypes (09 §7.5/§7.6).
+    { id: 'page-board', recommendable: true, descriptionKey: 'templates.pageBoard.description' },
+    { id: 'page-calendar', recommendable: true, descriptionKey: 'templates.pageCalendar.description' },
+    { id: 'page-scheduler', recommendable: true, descriptionKey: 'templates.pageScheduler.description' },
+    // People / queues (09 §7.3/§7.4/§7.7).
+    { id: 'page-directory', recommendable: true, descriptionKey: 'templates.pageDirectory.description' },
+    {
+        id: 'page-master-detail',
+        recommendable: true,
+        descriptionKey: 'templates.pageMasterDetail.description',
+    },
+    {
+        id: 'page-queue-inbox',
+        recommendable: true,
+        descriptionKey: 'templates.pageQueueInbox.description',
+    },
+    // Logs / media / chat (09 §7.8/§7.9).
+    { id: 'page-log-viewer', recommendable: true, descriptionKey: 'templates.pageLogViewer.description' },
+    { id: 'page-files', recommendable: true, descriptionKey: 'templates.pageFiles.description' },
+    { id: 'page-chat', recommendable: true, descriptionKey: 'templates.pageChat.description' },
+    // Builder / wizard / settings (09 §7.11, §11.1, §8.2) — tool surfaces: the
+    // LLM must never recommend them per table (see module docblock).
+    { id: 'page-builder', recommendable: false, descriptionKey: 'templates.pageBuilder.description' },
+    { id: 'page-wizard', recommendable: false, descriptionKey: 'templates.pageWizard.description' },
+    { id: 'page-settings', recommendable: false, descriptionKey: 'templates.pageSettings.description' },
+];
+export class DuplicatePageTemplateIdError extends Error {
+    templateId;
+    constructor(templateId) {
+        super(`Duplicate page-template id: '${templateId}' — page-template ids are unique`);
+        this.templateId = templateId;
+        this.name = 'DuplicatePageTemplateIdError';
+    }
+}
+/** Build an id→definition map; duplicate ids throw at module init. */
+export function buildPageTemplateRegistry(definitions) {
+    const map = new Map();
+    for (const definition of definitions) {
+        if (map.has(definition.id))
+            throw new DuplicatePageTemplateIdError(definition.id);
+        map.set(definition.id, definition);
+    }
+    return map;
+}
+export const pageTemplateRegistry = buildPageTemplateRegistry(pageTemplateDefinitions);
+export function getPageTemplate(id) {
+    return pageTemplateRegistry.get(id);
+}
+//# sourceMappingURL=page-templates.js.map

package/dist/registry/page-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-templates.js","sourceRoot":"","sources":["../../src/registry/page-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAyBH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC;AAEjD,yDAAyD;AACzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAsC;IACxE,EAAE,EAAE,EAAE,qBAAqB,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE,gCAAgC,EAAE;IACrG;QACE,EAAE,EAAE,0BAA0B;QAC9B,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,qCAAqC;KACtD;IACD,kDAAkD;IAClD,EAAE,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,iCAAiC,EAAE;IAC5F,EAAE,EAAE,EAAE,eAAe,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,oCAAoC,EAAE;IAClG,EAAE,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,qCAAqC,EAAE;IACpG,uCAAuC;IACvC,EAAE,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,qCAAqC,EAAE;IACpG;QACE,EAAE,EAAE,oBAAoB;QACxB,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,wCAAwC;KACzD;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,sCAAsC;KACvD;IACD,sCAAsC;IACtC,EAAE,EAAE,EAAE,iBAAiB,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,qCAAqC,EAAE;IACrG,EAAE,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,iCAAiC,EAAE;IAC5F,EAAE,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,gCAAgC,EAAE;IAC1F,2EAA2E;IAC3E,iEAAiE;IACjE,EAAE,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE,mCAAmC,EAAE;IACjG,EAAE,EAAE,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE,kCAAkC,EAAE;IAC/F,EAAE,EAAE,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE,oCAAoC,EAAE;CACpG,CAAC;AAEF,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAChC;IAArB,YAAqB,UAAkB;QACrC,KAAK,CAAC,gCAAgC,UAAU,kCAAkC,CAAC,CAAC;QADjE,eAAU,GAAV,UAAU,CAAQ;QAErC,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED,sEAAsE;AACtE,MAAM,UAAU,yBAAyB,CACvC,WAA8C;IAE9C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkC,CAAC;IACtD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,4BAA4B,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAClF,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAC/B,yBAAyB,CAAC,uBAAuB,CAAC,CAAC;AAErD,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/registry/registered-ids.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The live `widgetRegistry`'s id set, as a **pure, checked-in list**.
+ *
+ * WHY THIS EXISTS: `./index.ts` builds `widgetRegistry` from the per-family
+ * `definitions.ts` modules — component code. The generator leaf
+ * (`../generate/index.ts`) and everything downstream of it (the Engine, and
+ * through it the server) may not import that (01-architecture.md §2.3; the
+ * `engine-no-full-widgets` / `server-no-ui-widgets-charts` dependency-cruiser
+ * rules). Yet 04 §8 H1/H4 require generation to know which ids are registered:
+ * an unregistered id reaching a stored page renders `widget-missing`, and
+ * `composeTemplate`'s whole PENDING-id discipline is only sound when the
+ * membership test is actually supplied.
+ *
+ * So the id set is inverted into data: this list is the leaf-safe mirror the
+ * generator defaults to, and `registered-ids.test.ts` fails the moment it drifts
+ * from `[...widgetRegistry.keys()]` in either direction. Same "checked-in
+ * expectation, gated by a parity test" discipline as
+ * `../templates/crosscheck.ts`'s `PENDING_TEMPLATE_WIDGET_IDS` and
+ * `../qa/delivered.ts` — register a widget, add it here, and the gate tells you
+ * if you forget.
+ *
+ * Sorted; ids are globally unique (04 §2.1).
+ */
+export declare const REGISTERED_WIDGET_IDS: readonly string[];
+/** Registry-membership test — the default `ctx.isRegistered` for generation. */
+export declare function isRegisteredWidgetId(widgetId: string): boolean;
+//# sourceMappingURL=registered-ids.d.ts.map

package/dist/registry/registered-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registered-ids.d.ts","sourceRoot":"","sources":["../../src/registry/registered-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAkLlD,CAAC;AAIF,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE9D"}

package/dist/registry/registered-ids.js

@@ -0,0 +1,208 @@
+/**
+ * The live `widgetRegistry`'s id set, as a **pure, checked-in list**.
+ *
+ * WHY THIS EXISTS: `./index.ts` builds `widgetRegistry` from the per-family
+ * `definitions.ts` modules — component code. The generator leaf
+ * (`../generate/index.ts`) and everything downstream of it (the Engine, and
+ * through it the server) may not import that (01-architecture.md §2.3; the
+ * `engine-no-full-widgets` / `server-no-ui-widgets-charts` dependency-cruiser
+ * rules). Yet 04 §8 H1/H4 require generation to know which ids are registered:
+ * an unregistered id reaching a stored page renders `widget-missing`, and
+ * `composeTemplate`'s whole PENDING-id discipline is only sound when the
+ * membership test is actually supplied.
+ *
+ * So the id set is inverted into data: this list is the leaf-safe mirror the
+ * generator defaults to, and `registered-ids.test.ts` fails the moment it drifts
+ * from `[...widgetRegistry.keys()]` in either direction. Same "checked-in
+ * expectation, gated by a parity test" discipline as
+ * `../templates/crosscheck.ts`'s `PENDING_TEMPLATE_WIDGET_IDS` and
+ * `../qa/delivered.ts` — register a widget, add it here, and the gate tells you
+ * if you forget.
+ *
+ * Sorted; ids are globally unique (04 §2.1).
+ */
+export const REGISTERED_WIDGET_IDS = [
+    'accordion-list',
+    'activity-feed',
+    'ai-chat-panel',
+    'alert-banner',
+    'api-keys-panel',
+    'api-playground',
+    'attachment-list',
+    'auto-insights',
+    'autosave-indicator',
+    'avatar-stack',
+    'block-approval',
+    'block-attachments',
+    'block-bar-chart',
+    'block-contact',
+    'block-delivery-stepper',
+    'block-discount-codes',
+    'block-highlight-box',
+    'block-image-placeholder',
+    'block-kpi-row',
+    'block-late-fees',
+    'block-line-chart',
+    'block-line-items',
+    'block-loyalty-banner',
+    'block-multi-currency',
+    'block-payment-history',
+    'block-qr-pay',
+    'block-recurring-banner',
+    'block-signature',
+    'block-tax-breakdown',
+    'block-terms-checkbox',
+    'block-totals-summary',
+    'block-two-col-table',
+    'board-card',
+    'breadcrumb',
+    'bulk-action-toolbar',
+    'calendar-legend-filter',
+    'calendar-month',
+    'call-widget',
+    'capacity-board',
+    'card-gallery',
+    'chart-anomaly',
+    'chart-bar',
+    'chart-boxplot',
+    'chart-bullet',
+    'chart-bump',
+    'chart-candlestick',
+    'chart-chord',
+    'chart-choropleth-grid',
+    'chart-cohort-matrix',
+    'chart-correlation-matrix',
+    'chart-donut',
+    'chart-forecast',
+    'chart-funnel',
+    'chart-heat-month',
+    'chart-heatmap-calendar',
+    'chart-hexbin',
+    'chart-line-area',
+    'chart-marimekko',
+    'chart-multiline',
+    'chart-parallel-coordinates',
+    'chart-pareto',
+    'chart-radar',
+    'chart-radial-bar',
+    'chart-ranking-bars',
+    'chart-ridgeline',
+    'chart-sankey',
+    'chart-scatter-bubble',
+    'chart-slope',
+    'chart-sparkline',
+    'chart-stacked-bar-100',
+    'chart-stream',
+    'chart-sunburst',
+    'chart-timeline-lanes',
+    'chart-treemap',
+    'chart-violin',
+    'chart-waterfall',
+    'chart-wordcloud',
+    'chat-thread',
+    'chip-cloud',
+    'chip-input',
+    'code-snippet-block',
+    'column-mapping-table',
+    'command-palette',
+    'comparison-matrix',
+    'connection-status',
+    'connection-string-field',
+    'conversation-inbox',
+    'credit-card-tile',
+    'data-grid',
+    'date-range-picker',
+    'day-agenda',
+    'detail-key-value',
+    'diagnostics-readout',
+    'document-canvas',
+    'drawer-form',
+    'empty-state',
+    'experiment-variant-compare',
+    'export-builder',
+    'file-browser',
+    'filter-chip-bar',
+    'flow-builder',
+    'gantt-chart',
+    'gauge-arc',
+    'gauge-ring',
+    'global-search',
+    'grouped-summary-table',
+    'image-board',
+    'inline-compose-card',
+    'inline-editable-field',
+    'ip-allowlist-card',
+    'kanban-board',
+    'kanban-swimlane-grid',
+    'kpi-stat-card',
+    'kpi-stat-tile-compact',
+    'link-list',
+    'live-timer',
+    'load-older-paginator',
+    'log-table',
+    'map-bubble',
+    'map-choropleth-grid',
+    'master-list',
+    'metric-hero',
+    'micro-kpi-subtitle',
+    'mini-table',
+    'modal-wizard',
+    'nav-card',
+    'notification-feed',
+    'onboarding-checklist',
+    'option-cards',
+    'org-chart',
+    'otp-input',
+    'pagination-footer',
+    'password-strength-meter',
+    'period-comparison',
+    'plan-pricing-cards',
+    'policy-list',
+    'progress-bar',
+    'progress-log-console',
+    'question-builder',
+    'ranked-entity-list',
+    'realtime-feed',
+    'resource-api-card',
+    'rule-builder',
+    'schedule-matrix',
+    'scheduled-jobs-list',
+    'schema-tree',
+    'segmented-control',
+    'shortcuts-panel',
+    'sidebar-nav',
+    'slo-monitor-card',
+    'sparkline-table',
+    'starter-template-picker',
+    'stat-pair-card',
+    'state-hero',
+    'status-banner-hero',
+    'status-pill',
+    'stepper',
+    'sync-status-card',
+    'tab-bar',
+    'table-inclusion-checklist',
+    'testimonial-card',
+    'timeline-vertical',
+    'toast-stack',
+    'toggle-matrix',
+    'toggle-switch-list',
+    'top-movers-list',
+    'trust-badges',
+    'typing-indicator',
+    'unread-badge',
+    'upcoming-events-list',
+    'upload-dropzone',
+    'upload-progress-list',
+    'uptime-segment-bar',
+    'usage-meter',
+    'validation-issues-list',
+    'webhook-endpoints-list',
+    'widget-missing',
+];
+const REGISTERED = new Set(REGISTERED_WIDGET_IDS);
+/** Registry-membership test — the default `ctx.isRegistered` for generation. */
+export function isRegisteredWidgetId(widgetId) {
+    return REGISTERED.has(widgetId);
+}
+//# sourceMappingURL=registered-ids.js.map

package/dist/registry/registered-ids.js.map

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