@adminiumjs/widgets 0.1.0-rc.1

package/dist/frame/WidgetRuntimeContext.js

@@ -0,0 +1,62 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * 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 { createContext, useContext } from 'react';
+import { DEFAULT_WIDGET_RUNTIME_ENV, resolveOfflineWidgetId, } from '../registry/offline.js';
+const WidgetRuntimeContext = createContext(DEFAULT_WIDGET_RUNTIME_ENV);
+/**
+ * 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 function WidgetRuntimeProvider({ env, children }) {
+    return _jsx(WidgetRuntimeContext.Provider, { value: env, children: children });
+}
+/** The provided env, or {@link DEFAULT_WIDGET_RUNTIME_ENV} without a provider. */
+export function useWidgetRuntimeEnv() {
+    return useContext(WidgetRuntimeContext);
+}
+/**
+ * §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 function useResolvedWidgetId(widgetId) {
+    return resolveOfflineWidgetId(widgetId, useWidgetRuntimeEnv());
+}
+//# sourceMappingURL=WidgetRuntimeContext.js.map

package/dist/frame/WidgetRuntimeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetRuntimeContext.js","sourceRoot":"","sources":["../../src/frame/WidgetRuntimeContext.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAElE,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,oBAAoB,GAAG,aAAa,CAAmB,0BAA0B,CAAC,CAAC;AAOzF;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAA8B;IACjF,OAAO,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,GAAG,YAAG,QAAQ,GAAiC,CAAC;AAC/F,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB;IACjC,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,sBAAsB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/generate/crud-body.d.ts

@@ -0,0 +1,93 @@
+/**
+ * `page-crud` config-body composer — the body-building vocabulary of the
+ * Engine's bespoke `generate/crud.ts`, relocated behind the leaf boundary
+ * (research/widget-registry.md §14: "Every included table"; 01-architecture.md
+ * §6.1 fixes the config body shape: `columns[]`, `defaultSort`, `pageSize`,
+ * `detail`).
+ *
+ * `page-crud` deliberately keeps its TYPED body (09-generated-app.md §3.3) —
+ * this module produces `config.columns`/`form`/`detail`, not a `config.layout`,
+ * and the Engine still wraps the body into the §6.1 envelope. What moved is the
+ * vocabulary: column selection, tones, form-field mapping — the rules of *what
+ * a crud page contains* — now live beside the candidate rules (04 §8: the
+ * Registry owns what can be instantiated and why).
+ *
+ * PARITY CONTRACT: `packages/engine/test/generate-baseline.test.ts` pins the
+ * generator's output byte-identical, so every function here reproduces the
+ * bespoke builder's exact behaviour — same exclusions, same key order, same
+ * fallbacks. Inputs are the structural mirrors of `../registry/candidates.ts`;
+ * the Engine's adapter fills them from `TableModel`/`ClassifiedTable`.
+ *
+ * Column selection follows 05 (assignment note): display column, status,
+ * money, dates first; list capped at ~8 visible columns. Secrets are
+ * hard-excluded (05 §7.1 rule 1), pk ids are hidden by default (rule 2) —
+ * emitted as `hidden` specs (not dropped) so the page-crud template can still
+ * resolve row identity and generate the create/edit form's key field.
+ */
+import type { GridColumnSpecInput } from '../page-config/grid-column-spec.js';
+import { type CandidateRelation, type CandidateTable, type ClassifiedTableInput } from '../registry/candidates.js';
+/**
+ * The tones the crud generator actually emits — a subset of `gridToneSchema`.
+ * `'muted'` is the rule-7 fallback ("inactive / draft / neutral", same
+ * vocabulary as the LLM contract's `Tone`); renderers map it onto the neutral
+ * treatment (`families/tables/cells.tsx`).
+ */
+export type CrudEnumTone = 'pos' | 'warn' | 'danger' | 'muted';
+/**
+ * Mirrored (deliberately) by `packages/llm/src/apply/normalize.ts` — the LLM
+ * apply path re-derives tones for enum values the generator never saw.
+ */
+export declare function enumTones(values: readonly string[]): Record<string, CrudEnumTone>;
+export interface CrudBodyContext {
+    /** read-only-analytics intent, no-PK tables, and views render read-only. */
+    readOnly: boolean;
+    /** Tables included in this generation run (detail tabs only link these). */
+    includedTableIds: ReadonlySet<string>;
+    /** Every model relation — detail tabs derive from the inbound ones. */
+    relations: readonly CandidateRelation[];
+}
+/** Detail-tab entry (09 §7.1 — `tab-bar` with live count pills). */
+export interface CrudDetailTab {
+    /** The referencing table's id. */
+    table: string;
+    /** Its FK column into this page's table. */
+    fkColumn: string | undefined;
+    label: string;
+}
+export interface CrudSortSpec {
+    column: string;
+    dir: 'asc' | 'desc';
+}
+/** One generated form field (09 §7.1 — the modal-wizard renders these). */
+export interface CrudFormField {
+    column: string;
+    label: string;
+    required: boolean;
+    input?: 'fk-combobox' | 'segmented' | 'select' | 'switch' | 'date' | 'datetime' | 'number' | 'json' | 'textarea' | 'text';
+    /** fk-combobox target table id. */
+    ref?: string;
+    /** segmented/select options. */
+    options?: readonly string[];
+    format?: 'currency';
+    maxLength?: number;
+    unique?: boolean;
+}
+/** The typed `page-crud` config body (01 §6.1 / 09 §3.3), pre-envelope. */
+export interface CrudPageBody {
+    columns: GridColumnSpecInput[];
+    defaultSort: CrudSortSpec[];
+    pageSize: number;
+    keyField: string | null;
+    readOnly: boolean;
+    detail: {
+        template: 'page-record';
+        tabsFromInboundFks: true;
+        tabs: CrudDetailTab[];
+    };
+    form?: {
+        fields: CrudFormField[];
+    };
+}
+/** Build the typed `page-crud` config body for one table (pre-envelope). */
+export declare function composeCrudBody(table: CandidateTable, classified: ClassifiedTableInput, ctx: CrudBodyContext): CrudPageBody;
+//# sourceMappingURL=crud-body.d.ts.map

package/dist/generate/crud-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-body.d.ts","sourceRoot":"","sources":["../../src/generate/crud-body.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AAWnC;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CASjF;AA2DD,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,uEAAuE;IACvE,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACzC;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,KAAK,GAAG,MAAM,CAAC;CACrB;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EACF,aAAa,GACb,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,UAAU,GACV,QAAQ,GACR,MAAM,GACN,UAAU,GACV,MAAM,CAAC;IACX,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,WAAW,EAAE,YAAY,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE;QACN,QAAQ,EAAE,aAAa,CAAC;QACxB,kBAAkB,EAAE,IAAI,CAAC;QACzB,IAAI,EAAE,aAAa,EAAE,CAAC;KACvB,CAAC;IACF,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;CACpC;AAoMD,4EAA4E;AAC5E,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,oBAAoB,EAChC,GAAG,EAAE,eAAe,GACnB,YAAY,CAoBd"}

package/dist/generate/crud-body.js

@@ -0,0 +1,323 @@
+/**
+ * `page-crud` config-body composer — the body-building vocabulary of the
+ * Engine's bespoke `generate/crud.ts`, relocated behind the leaf boundary
+ * (research/widget-registry.md §14: "Every included table"; 01-architecture.md
+ * §6.1 fixes the config body shape: `columns[]`, `defaultSort`, `pageSize`,
+ * `detail`).
+ *
+ * `page-crud` deliberately keeps its TYPED body (09-generated-app.md §3.3) —
+ * this module produces `config.columns`/`form`/`detail`, not a `config.layout`,
+ * and the Engine still wraps the body into the §6.1 envelope. What moved is the
+ * vocabulary: column selection, tones, form-field mapping — the rules of *what
+ * a crud page contains* — now live beside the candidate rules (04 §8: the
+ * Registry owns what can be instantiated and why).
+ *
+ * PARITY CONTRACT: `packages/engine/test/generate-baseline.test.ts` pins the
+ * generator's output byte-identical, so every function here reproduces the
+ * bespoke builder's exact behaviour — same exclusions, same key order, same
+ * fallbacks. Inputs are the structural mirrors of `../registry/candidates.ts`;
+ * the Engine's adapter fills them from `TableModel`/`ClassifiedTable`.
+ *
+ * Column selection follows 05 (assignment note): display column, status,
+ * money, dates first; list capped at ~8 visible columns. Secrets are
+ * hard-excluded (05 §7.1 rule 1), pk ids are hidden by default (rule 2) —
+ * emitted as `hidden` specs (not dropped) so the page-crud template can still
+ * resolve row identity and generate the create/edit form's key field.
+ */
+import { humanize, } from '../registry/candidates.js';
+/** Max list-visible columns (05 "cap ~8"). */
+const LIST_COLUMN_CAP = 8;
+const DEFAULT_PAGE_SIZE = 50;
+/** §7.1 rule-7 heuristic tone map for status pills. */
+const TONE_POS = /^(active|paid|done|completed?|closed|approved|healthy|shipped|delivered)$/i;
+const TONE_WARN = /^(pending|trial|review|in_review|draft|queued|on_hold|paused|open|new)$/i;
+const TONE_DANGER = /^(failed|rejected|churned|overdue|blocked|cancell?ed|error)$/i;
+/**
+ * Mirrored (deliberately) by `packages/llm/src/apply/normalize.ts` — the LLM
+ * apply path re-derives tones for enum values the generator never saw.
+ */
+export function enumTones(values) {
+    const tones = {};
+    for (const value of values) {
+        if (TONE_POS.test(value))
+            tones[value] = 'pos';
+        else if (TONE_WARN.test(value))
+            tones[value] = 'warn';
+        else if (TONE_DANGER.test(value))
+            tones[value] = 'danger';
+        else
+            tones[value] = 'muted';
+    }
+    return tones;
+}
+const NUMERIC_TYPES = new Set(['integer', 'bigint', 'decimal', 'float']);
+/**
+ * List-visibility priority (lower = earlier): display column, then status,
+ * money, dates, FK chips, categories, identity columns, the rest. Excluded
+ * entirely: secrets, pk ids, binary/image/json payloads, free text.
+ */
+function rankColumn(column, semantics, displayColumn) {
+    if (semantics.secret ?? false)
+        return null;
+    const tag = semantics.semantic;
+    if (tag === 'pk-id')
+        return null; // hidden by default in grids (rule 2)
+    if (column.logicalType === 'binary' || column.logicalType === 'json')
+        return null;
+    if (tag === 'image-url' || tag === 'json-config' || tag === 'free-text')
+        return null;
+    if (column.name === displayColumn)
+        return 0;
+    switch (tag) {
+        case 'status-workflow':
+            return 1;
+        case 'money':
+            return 2;
+        case 'created-at':
+        case 'updated-at':
+            return 3;
+        case 'event-timestamp':
+        case 'date-range':
+            return 4;
+        case 'fk':
+            return 5;
+        case 'category-enum':
+            return 6;
+        case 'person-name':
+        case 'email':
+            return 7;
+        case 'boolean-flag':
+            return 8;
+        case 'percent':
+        case 'score':
+        case 'duration':
+            return 9;
+        case 'phone':
+        case 'url':
+        case 'slug':
+            return 10;
+        default:
+            return 12;
+    }
+}
+/** `enumValues` carries resolved values or is absent — absent ⇔ no enum. */
+function enumValuesFor(column) {
+    return column.enumValues ?? null;
+}
+/** Sort key: engine `ColumnModel.ordinal` (0 = unspecified — ties keep declaration order). */
+function ordinalOf(column) {
+    return column.ordinal ?? 0;
+}
+/**
+ * One `config.columns[]` entry in the `gridColumnSpecSchema` vocabulary — the
+ * page-crud template's column contract ({name, logicalType, semantic, …}); the
+ * renderers derive the cell treatment from logicalType+semantic, so no widget
+ * id is stored per column.
+ */
+function buildColumnDef(column, semantics) {
+    const def = {
+        name: column.name,
+        label: humanize(column.name),
+        // The candidate mirror keeps `logicalType` an open string; the engine enum
+        // it mirrors is identical to GRID_LOGICAL_TYPES (schema-model.ts §6), so
+        // the narrow assertion cannot widen the emitted vocabulary.
+        logicalType: column.logicalType,
+        semantic: semantics.semantic,
+        sortable: true,
+    };
+    if (semantics.format !== null && semantics.format !== undefined)
+        def.format = semantics.format;
+    if (semantics.semantic === 'money')
+        def.align = 'end';
+    if (semantics.semantic === 'pk-id' ||
+        semantics.semantic === 'external-id' ||
+        semantics.semantic === 'email') {
+        def.mono = true;
+    }
+    if (column.references !== null && column.references !== undefined) {
+        def.fk = { table: column.references.tableId, column: column.references.column };
+    }
+    const values = enumValuesFor(column);
+    if (values !== null) {
+        def.enumValues = [...values];
+        if (semantics.semantic === 'status-workflow')
+            def.enumTones = enumTones(values);
+    }
+    if (semantics.maskedByDefault ?? false)
+        def.pii = true;
+    // Form-generation facts (RecordForm reads these off the same spec).
+    if (column.isPrimaryKey ?? false)
+        def.primaryKey = true;
+    if (!(column.nullable ?? true))
+        def.nullable = false;
+    if (column.defaultKind !== null && column.defaultKind !== undefined)
+        def.hasDefault = true;
+    if (column.isUnique ?? false)
+        def.unique = true;
+    if ((column.isGenerated ?? false) ||
+        semantics.semantic === 'created-at' ||
+        semantics.semantic === 'updated-at') {
+        def.readOnly = true;
+    }
+    if (column.maxLength !== null && column.maxLength !== undefined)
+        def.maxLength = column.maxLength;
+    return def;
+}
+function listColumns(table, classified) {
+    const byName = new Map(classified.columns.map((c) => [c.column, c]));
+    const displayColumn = classified.displayColumn ?? null;
+    const ranked = [];
+    for (const column of table.columns) {
+        const semantics = byName.get(column.name);
+        if (semantics === undefined)
+            continue;
+        const priority = rankColumn(column, semantics, displayColumn);
+        if (priority === null)
+            continue;
+        ranked.push({ column, semantics, priority });
+    }
+    // Stable: priority, then declaration order.
+    ranked.sort((a, b) => a.priority - b.priority || ordinalOf(a.column) - ordinalOf(b.column));
+    const defs = ranked
+        .slice(0, LIST_COLUMN_CAP)
+        .map(({ column, semantics }) => buildColumnDef(column, semantics));
+    // Every PK column needs a spec even when rankColumn() drops it from the
+    // visible set (pk-id, rule 2): the page-crud template derives row identity
+    // (rowIdOf → the record-route `:recordId`) and the create/edit form fields
+    // from `config.columns`, and a natural PK with no DB default is a *required*
+    // create input. Append the still-missing PK columns as `hidden` — DataGrid
+    // filters hidden specs out of the grid, so the list stays pk-free while
+    // forms/detail and row ids resolve (gridColumnSpecSchema: "Hidden from the
+    // grid but still available to forms/detail").
+    const present = new Set(defs.map((def) => def.name));
+    for (const column of table.columns) {
+        if (!(column.isPrimaryKey ?? false) || present.has(column.name))
+            continue;
+        const semantics = byName.get(column.name);
+        if (semantics === undefined)
+            continue;
+        defs.push({ ...buildColumnDef(column, semantics), hidden: true });
+    }
+    return defs;
+}
+function defaultSort(table, classified) {
+    const createdAt = classified.columns.find((c) => c.semantic === 'created-at');
+    if (createdAt !== undefined)
+        return [{ column: createdAt.column, dir: 'desc' }];
+    const pk = (table.primaryKey ?? [])[0];
+    if (pk !== undefined)
+        return [{ column: pk, dir: 'desc' }];
+    return [];
+}
+/** Detail tabs from inbound FKs (09 §7.1) — conf ≥ 0.8, deduped, no self-FK. */
+function detailTabs(table, relations, includedTableIds) {
+    const tabs = [];
+    const seen = new Set();
+    for (const relation of [...relations].sort((a, b) => a.id.localeCompare(b.id))) {
+        if (relation.to.tableId !== table.id)
+            continue;
+        if (relation.from.tableId === table.id)
+            continue; // self-FK → hierarchy, not a tab
+        if (relation.confidence < 0.8)
+            continue;
+        if (!includedTableIds.has(relation.from.tableId))
+            continue;
+        const key = `${relation.from.tableId}:${relation.from.columns.join(',')}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        tabs.push({
+            table: relation.from.tableId,
+            fkColumn: relation.from.columns[0],
+            label: humanize(relation.from.tableId),
+        });
+    }
+    return tabs;
+}
+const AUTO_MANAGED_TAGS = new Set(['created-at', 'updated-at']);
+/** Generated form field defs (09 §7.1 — the modal-wizard renders these). */
+function formFields(table, classified) {
+    const byName = new Map(classified.columns.map((c) => [c.column, c]));
+    const fields = [];
+    for (const column of table.columns) {
+        const semantics = byName.get(column.name);
+        if (semantics === undefined || (semantics.secret ?? false))
+            continue;
+        if (column.isGenerated ?? false)
+            continue;
+        const defaultKind = column.defaultKind ?? null;
+        const auto = defaultKind !== null && defaultKind !== 'literal' && defaultKind !== 'expression';
+        if ((column.isPrimaryKey ?? false) && auto)
+            continue; // autoincrement / uuid PKs
+        if (AUTO_MANAGED_TAGS.has(semantics.semantic) && defaultKind !== null)
+            continue;
+        const field = {
+            column: column.name,
+            label: humanize(column.name),
+            required: !(column.nullable ?? true) && defaultKind === null,
+        };
+        const tag = semantics.semantic;
+        if (tag === 'fk' && column.references !== null && column.references !== undefined) {
+            field.input = 'fk-combobox';
+            field.ref = column.references.tableId;
+        }
+        else if (column.logicalType === 'enum') {
+            const values = enumValuesFor(column) ?? [];
+            field.input = values.length > 0 && values.length <= 3 ? 'segmented' : 'select';
+            field.options = values;
+        }
+        else if (column.logicalType === 'boolean' || tag === 'boolean-flag') {
+            field.input = 'switch';
+        }
+        else if (column.logicalType === 'date') {
+            field.input = 'date';
+        }
+        else if (column.logicalType === 'timestamp' ||
+            column.logicalType === 'timestamptz' ||
+            column.logicalType === 'time') {
+            field.input = 'datetime';
+        }
+        else if (NUMERIC_TYPES.has(column.logicalType)) {
+            field.input = 'number';
+            if (tag === 'money')
+                field.format = 'currency';
+        }
+        else if (column.logicalType === 'json') {
+            field.input = 'json';
+        }
+        else if (tag === 'free-text') {
+            field.input = 'textarea';
+        }
+        else {
+            field.input = 'text';
+            if (column.maxLength !== null && column.maxLength !== undefined) {
+                field.maxLength = column.maxLength;
+            }
+        }
+        if ((column.isUnique ?? false) && !(column.isPrimaryKey ?? false))
+            field.unique = true;
+        fields.push(field);
+    }
+    return fields;
+}
+/** Build the typed `page-crud` config body for one table (pre-envelope). */
+export function composeCrudBody(table, classified, ctx) {
+    const readOnly = ctx.readOnly || (table.primaryKey ?? []).length === 0 || (table.kind ?? 'table') !== 'table';
+    const body = {
+        columns: listColumns(table, classified),
+        defaultSort: defaultSort(table, classified),
+        pageSize: DEFAULT_PAGE_SIZE,
+        keyField: classified.displayColumn ?? (table.primaryKey ?? [])[0] ?? null,
+        readOnly,
+        detail: {
+            template: 'page-record',
+            tabsFromInboundFks: true,
+            tabs: detailTabs(table, ctx.relations, ctx.includedTableIds),
+        },
+    };
+    if (!readOnly) {
+        body.form = { fields: formFields(table, classified) };
+    }
+    return body;
+}
+//# sourceMappingURL=crud-body.js.map

package/dist/generate/crud-body.js.map

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

package/dist/generate/dashboard-domain.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Domain-scoped `page-dashboard` candidate assembly — the cross-table widget
+ * selection of the Engine's bespoke `generate/dashboard.ts`, relocated behind
+ * the leaf boundary (research/widget-registry.md §14 trigger, §15 decision
+ * summary: one dashboard per FK-cluster domain).
+ *
+ * Widget set per §15: 4 KPI candidates (COUNT(*), money SUM when present,
+ * new-this-period on the created-at family, status-group count with a
+ * secondary-table fallback), a hero timeseries (`chart-line-area`) bucketing
+ * the best timestamp by month, and a `chart-donut` over the top categorical
+ * breakdown.
+ *
+ * Unlike the bespoke builder this module emits `TemplateCandidate[]` and stops:
+ * geometry comes from the `page-dashboard` manifest via `composeTemplate`
+ * (04 §10), not from hand-stamped x/y/w/h. The manifest's v2 slot areas
+ * reproduce the bespoke spans exactly (kpi 3×3 row, hero 8×8, donut 4×8), and
+ * each candidate carries the bespoke instance id so regenerated layout items
+ * keep their identity. Domain detection itself (FK clustering, hub election,
+ * naming) stays in the Engine — this module receives the result as a
+ * structural mirror ({@link DashboardDomain}), same contract style as
+ * `../registry/candidates.ts`.
+ *
+ * SEMANTIC SOURCE: column tags and table roles come from `entry.classified` —
+ * the classification the Engine adapter supplies (recomputed on the model as
+ * generated, with `source: 'llm' | 'override'` column stamps folded in, 05 §7).
+ * The bespoke builder read full-model stamped semantics instead; the delta is
+ * deliberate and pinned by `generate-archetypes.test.ts` — on a filtered model
+ * a join table whose partner is excluded reclassifies (and may take a fallback
+ * KPI), exactly as it earns a `page-crud`.
+ *
+ * DETERMINISM: candidates are emitted in the bespoke order with equal scores —
+ * `composeTemplate`'s total order (score, widget id, input order) then
+ * preserves it, so a re-run over an unchanged schema composes an identical
+ * layout (H5 `generated_hash`).
+ */
+import type { TemplateCandidate } from '../templates/compose.js';
+import { type CandidateRelation, type CandidateTableInput } from '../registry/candidates.js';
+/** The engine `Domain` fields this assembly reads (structural mirror). */
+export interface DashboardDomain {
+    /** Deterministic kebab-case key, e.g. `orders`. */
+    key: string;
+    /** Human label, e.g. `Orders`. */
+    label: string;
+    /** All member table ids, sorted. */
+    tableIds: readonly string[];
+    /** The weighted hub — highest relation degree. */
+    hubTableId: string;
+}
+export interface DashboardDomainContext {
+    /** `adminium_connections.id` every emitted binding scopes to. */
+    connectionId: string;
+}
+/** §8 trigger: a domain can host a dashboard only with ≥ 1 time axis. */
+export declare function domainHasDashboardSignal(domain: DashboardDomain, model: readonly CandidateTableInput[], relations: readonly CandidateRelation[]): boolean;
+/**
+ * Emit the §15 candidate set for one domain's `page-dashboard`, in slot order:
+ * KPI row, hero timeseries, donut breakdown. Feed the result to
+ * `composeTemplate('page-dashboard', …)` — the manifest supplies the geometry.
+ *
+ * Returns `null` when the domain's hub is not in `model` or the domain has no
+ * time axis at all (05 §8 trigger requires ≥ 1 timestamp) — the caller records
+ * a warning, exactly the bespoke `buildDashboardEnvelope` → `null` idiom.
+ */
+export declare function emitDomainDashboardCandidates(domain: DashboardDomain, model: readonly CandidateTableInput[], relations: readonly CandidateRelation[], ctx: DashboardDomainContext): TemplateCandidate[] | null;
+//# sourceMappingURL=dashboard-domain.d.ts.map

package/dist/generate/dashboard-domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-domain.d.ts","sourceRoot":"","sources":["../../src/generate/dashboard-domain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,2BAA2B,CAAC;AAEnC,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;CACtB;AAoGD,yEAAyE;AACzE,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,SAAS,EAAE,SAAS,iBAAiB,EAAE,GACtC,OAAO,CAET;AA0ID;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,SAAS,EAAE,SAAS,iBAAiB,EAAE,EACvC,GAAG,EAAE,sBAAsB,GAC1B,iBAAiB,EAAE,GAAG,IAAI,CA6D5B"}