@adminiumjs/widgets 0.1.0-rc.1

package/dist/templates/compose.js

@@ -0,0 +1,216 @@
+/**
+ * `composeTemplate` — the page-template composition engine (04-widget-registry.md
+ * §10, task 04-T07).
+ *
+ * Fills each manifest slot with the highest-scoring **accepted** candidate,
+ * repeating slots take the top-N, unfilled *optional* slots are dropped or
+ * empty-stated, and composition fails only when a slot marked `required: true`
+ * is unfillable — which surfaces as a Studio warning rather than an exception,
+ * matching the `buildDashboardEnvelope` → `null` + caller-records-a-warning
+ * idiom already used by `@adminium/engine/generate`.
+ *
+ * WHAT THIS IS NOT: the return value is an **in-memory intermediate**. Nothing
+ * here persists, and nothing here builds the stored envelope — the Engine wraps
+ * `ComposedPage` into `v`/`kind`/`id`/`template`/`title`/`source`/`nav`/`access`/
+ * `config` (01-architecture.md §6.1) with `layout` under `config.layout` and
+ * `toolbar`/`overlays` in the template's config body. Keeping the wrap out of
+ * this package is what lets `@adminium/widgets` stay free of engine imports.
+ *
+ * DETERMINISM: generation output is content-hashed (`generated_hash`, H5), so a
+ * re-run over an unchanged schema must produce a byte-identical page. Every
+ * ordering decision below is therefore total — candidate ties break on widget id
+ * then on the caller's original array index, never on `Array.prototype.sort`
+ * stability alone.
+ */
+import { pageLayoutSchema } from '../page-config/layout.js';
+import { GRID_COLUMNS } from '../grid/layout-math.js';
+import { pageTemplateManifests } from './manifests.js';
+import { slotCapacity } from './template-schema.js';
+/** Registry id of the widget used for `fallback: 'empty-state'` slots (annex §12). */
+export const EMPTY_STATE_WIDGET_ID = 'empty-state';
+/**
+ * Envelope `kind` per template (09-generated-app.md §3.2 mapping table). Grid-
+ * composed dashboards are `kind: 'dashboard'`; every other template the
+ * Generated App renders is `kind: 'page'`. Checked in rather than derived: the
+ * §10 manifest schema has no `kind` field (and must not grow one — it is the
+ * published contract third-party manifests are written against), and the
+ * mapping is a property of the *envelope* spec, not of the template's layout.
+ */
+const DASHBOARD_KIND_TEMPLATES = new Set(['page-dashboard', 'page-hub-home']);
+export function templateKind(templateId) {
+    return DASHBOARD_KIND_TEMPLATES.has(templateId) ? 'dashboard' : 'page';
+}
+/** Does `slot.accepts` admit this candidate? (04 §10 — shape contract OR id allowlist.) */
+export function slotAccepts(slot, candidate) {
+    const byWidget = slot.accepts.widgets?.includes(candidate.widget) ?? false;
+    const byShape = slot.accepts.shapes?.includes(candidate.shape) ?? false;
+    return byWidget || byShape;
+}
+/** Total order: score desc, then widget id asc, then input order asc. */
+function compareCandidates(a, b) {
+    return (b.candidate.score - a.candidate.score ||
+        a.candidate.widget.localeCompare(b.candidate.widget) ||
+        a.order - b.order);
+}
+/**
+ * Geometry of the n-th instance of a (possibly repeating) slot. `flow: 'row'`
+ * tiles along x and wraps to a new band once the 12-column grid is full;
+ * `flow: 'column'` stacks along y. A non-repeating slot always yields `area`.
+ */
+export function slotInstanceArea(slot, index) {
+    const { x, y, w, h } = slot.area;
+    if (slot.repeat === undefined || index === 0)
+        return { x, y, w, h };
+    if (slot.repeat.flow === 'column')
+        return { x, y: y + index * h, w, h };
+    // Row flow: advance along x, wrapping back to the slot's origin column when
+    // the next instance would overflow the 12-column grid.
+    const perBand = Math.max(1, Math.floor((GRID_COLUMNS - x) / Math.max(1, w)));
+    const band = Math.floor(index / perBand);
+    const withinBand = index % perBand;
+    return { x: x + withinBand * w, y: y + band * h, w, h };
+}
+function instanceId(slot, index, candidate, ctx) {
+    if (ctx.makeInstanceId !== undefined)
+        return ctx.makeInstanceId(slot.slot, index, candidate);
+    if (candidate.instanceId !== undefined)
+        return candidate.instanceId;
+    return slotCapacity(slot) > 1 ? `${slot.slot}-${index + 1}` : slot.slot;
+}
+/** Registry filter for chrome ids — an unregistered id would render `widget-missing`. */
+function filterChrome(ids, kind, templateId, ctx, warnings) {
+    const out = [];
+    for (const id of ids ?? []) {
+        if (ctx.isRegistered !== undefined && !ctx.isRegistered(id)) {
+            warnings.push({
+                code: 'chrome-widget-unregistered',
+                templateId,
+                widgetId: id,
+                message: `Template '${templateId}' declares ${kind} widget '${id}', which is not registered; dropped from the composed page`,
+            });
+            continue;
+        }
+        out.push(id);
+    }
+    return out;
+}
+/**
+ * Compose a page from a template manifest + the ranked candidates the Engine's
+ * rules emitted for it.
+ *
+ * @param template  A registered template id, or a parsed manifest (marketplace / test).
+ * @param candidates Ranked candidates; each is placed into at most one slot.
+ */
+export function composeTemplate(template, candidates, ctx = {}) {
+    const warnings = [];
+    let manifest;
+    if (typeof template === 'string') {
+        const found = (ctx.templates ?? pageTemplateManifests).get(template);
+        if (found === undefined) {
+            warnings.push({
+                code: 'unknown-template',
+                templateId: template,
+                message: `No page-template manifest registered as '${template}'`,
+            });
+            return { page: null, warnings };
+        }
+        manifest = found;
+    }
+    else {
+        manifest = template;
+    }
+    const templateId = manifest.id;
+    // Drop candidates naming an unregistered widget before any matching happens —
+    // they must never reach the layout (they would render `widget-missing`).
+    const pool = [];
+    candidates.forEach((candidate, order) => {
+        if (ctx.isRegistered !== undefined && !ctx.isRegistered(candidate.widget)) {
+            warnings.push({
+                code: 'candidate-unregistered',
+                templateId,
+                widgetId: candidate.widget,
+                message: `Candidate widget '${candidate.widget}' is not registered; dropped before slot matching`,
+            });
+            return;
+        }
+        pool.push({ candidate, order });
+    });
+    const taken = new Set(); // consumed `order` values — one slot per candidate
+    const items = [];
+    let failed = false;
+    for (const slot of manifest.slots) {
+        const capacity = slotCapacity(slot);
+        const picks = pool
+            .filter((entry) => !taken.has(entry.order) && slotAccepts(slot, entry.candidate))
+            .sort(compareCandidates)
+            .slice(0, capacity);
+        if (picks.length === 0) {
+            if (slot.required) {
+                failed = true;
+                warnings.push({
+                    code: 'required-slot-unfillable',
+                    templateId,
+                    slot: slot.slot,
+                    message: `Required slot '${slot.slot}' of '${templateId}' has no accepted candidate`,
+                });
+                continue;
+            }
+            if (slot.fallback === 'empty-state') {
+                if (ctx.isRegistered !== undefined && !ctx.isRegistered(EMPTY_STATE_WIDGET_ID)) {
+                    warnings.push({
+                        code: 'empty-state-unavailable',
+                        templateId,
+                        slot: slot.slot,
+                        widgetId: EMPTY_STATE_WIDGET_ID,
+                        message: `Slot '${slot.slot}' of '${templateId}' wanted an '${EMPTY_STATE_WIDGET_ID}' fallback, which is not registered; omitted instead`,
+                    });
+                    continue;
+                }
+                const area = slotInstanceArea(slot, 0);
+                items.push({ i: slot.slot, widget: EMPTY_STATE_WIDGET_ID, ...area, config: {} });
+                continue;
+            }
+            warnings.push({
+                code: 'optional-slot-omitted',
+                templateId,
+                slot: slot.slot,
+                message: `Optional slot '${slot.slot}' of '${templateId}' had no accepted candidate; omitted`,
+            });
+            continue;
+        }
+        picks.forEach((entry, index) => {
+            taken.add(entry.order);
+            items.push({
+                i: instanceId(slot, index, entry.candidate, ctx),
+                widget: entry.candidate.widget,
+                ...slotInstanceArea(slot, index),
+                config: { ...entry.candidate.config },
+            });
+        });
+    }
+    if (failed)
+        return { page: null, warnings };
+    const layout = pageLayoutSchema.safeParse({ version: 1, items });
+    if (!layout.success) {
+        warnings.push({
+            code: 'invalid-layout',
+            templateId,
+            message: `Composed layout for '${templateId}' is not a valid pageLayout: ${layout.error.issues
+                .map((i) => `${i.path.join('.')}: ${i.message}`)
+                .join('; ')}`,
+        });
+        return { page: null, warnings };
+    }
+    return {
+        page: {
+            type: templateKind(templateId),
+            template: templateId,
+            templateVersion: manifest.version,
+            layout: layout.data,
+            toolbar: filterChrome(manifest.chrome?.toolbar, 'toolbar', templateId, ctx, warnings),
+            overlays: filterChrome(manifest.chrome?.overlays, 'overlays', templateId, ctx, warnings),
+        },
+        warnings,
+    };
+}
+//# sourceMappingURL=compose.js.map

package/dist/templates/compose.js.map

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

package/dist/templates/crosscheck.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Registry cross-check for page-template manifests.
+ *
+ * A manifest is JSON: nothing in the type system stops it naming a widget id
+ * that does not exist. Two failure modes follow, with very different blast
+ * radii, so this module grades them:
+ *
+ *   - **A `required: true` slot NO registered widget can fill** is fatal. No
+ *     candidate can ever carry an unregistered id, so if every id the slot
+ *     allow-lists is unregistered *and* it accepts no shape, the slot is
+ *     permanently unfillable and `composeTemplate` returns `page: null` — the
+ *     template is dead on arrival, for every schema, forever. This is graded per
+ *     SLOT, not per id: a required slot that also accepts a registered widget (or
+ *     any `accepts.shapes` entry) still fills, so a single pending id among its
+ *     accepts is inert — and that is precisely the ahead-of-delivery workflow
+ *     `PENDING_TEMPLATE_WIDGET_IDS` exists to support.
+ *   - **An *optional* slot (or `chrome`) naming an unregistered id** is inert.
+ *     Optional slot allowlists are matched against candidates, and candidates
+ *     only ever carry registered ids, so the slot simply never fills and is
+ *     omitted; chrome ids are filtered by `composeTemplate` before they reach
+ *     the output. These are how a manifest records the annex §14 composition
+ *     ahead of the family that implements it.
+ *
+ * The inert case is therefore *allowed but must be declared*: every such id
+ * lives in `PENDING_TEMPLATE_WIDGET_IDS` below with the family that will deliver
+ * it. This is the `qa/annex-catalog.ts` `WAVE1_PENDING` discipline — the list is
+ * a checked-in expectation, so BOTH an undeclared unregistered id AND a stale
+ * entry (an id that has since been registered) fail the gate, forcing the list
+ * to shrink to empty as the families land. An id that is neither registered nor
+ * declared is always an error, wherever it appears.
+ */
+import type { PageTemplate } from './template-schema.js';
+/**
+ * Annex §14 widget ids referenced by a shipped manifest whose family has not
+ * been built yet, mapped to the family that will deliver them. Every one appears
+ * only in an optional slot (`fallback: 'omit'`) or in `chrome`, both of which
+ * degrade to nothing at compose time. Delete an entry the moment its widget
+ * registers — `crosscheck.test.ts` fails on stale entries.
+ */
+export declare const PENDING_TEMPLATE_WIDGET_IDS: Readonly<Record<string, string>>;
+export type CrossCheckCode = 
+/** A `required: true` slot no registered widget and no shape can fill. */
+'required-slot-unregistered'
+/** An unregistered id nowhere declared in `PENDING_TEMPLATE_WIDGET_IDS`. */
+ | 'unregistered-widget'
+/** A declared-pending id that is now registered — delete it from the list. */
+ | 'stale-pending-entry'
+/** A slot with neither `accepts.shapes` nor `accepts.widgets`: nothing can fill it. */
+ | 'slot-accepts-nothing'
+/** A pending id used somewhere `composeTemplate` cannot degrade it away. */
+ | 'pending-id-not-degradable';
+export interface CrossCheckIssue {
+    code: CrossCheckCode;
+    templateId: string;
+    slot?: string;
+    widgetId?: string;
+    message: string;
+}
+/**
+ * Cross-check one manifest against the live registry.
+ *
+ * @param isRegistered membership test against the assembled `widgetRegistry`.
+ * @returns issues, empty when the manifest is clean.
+ */
+export declare function crossCheckTemplate(manifest: PageTemplate, isRegistered: (widgetId: string) => boolean, pending?: Readonly<Record<string, string>>): CrossCheckIssue[];
+/** Cross-check every shipped manifest; the CI gate asserts this is empty. */
+export declare function crossCheckTemplates(manifests: Iterable<PageTemplate>, isRegistered: (widgetId: string) => boolean, pending?: Readonly<Record<string, string>>): CrossCheckIssue[];
+//# sourceMappingURL=crosscheck.d.ts.map

package/dist/templates/crosscheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crosscheck.d.ts","sourceRoot":"","sources":["../../src/templates/crosscheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoCxE,CAAC;AAEF,MAAM,MAAM,cAAc;AACxB,0EAA0E;AACxE,4BAA4B;AAC9B,4EAA4E;GAC1E,qBAAqB;AACvB,8EAA8E;GAC5E,qBAAqB;AACvB,uFAAuF;GACrF,sBAAsB;AACxB,4EAA4E;GAC1E,2BAA2B,CAAC;AAEhC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAoCD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,EAC3C,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAA+B,GACtE,eAAe,EAAE,CA8EnB;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,EACjC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,EAC3C,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAA+B,GACtE,eAAe,EAAE,CAEnB"}

package/dist/templates/crosscheck.js

@@ -0,0 +1,155 @@
+/**
+ * Annex §14 widget ids referenced by a shipped manifest whose family has not
+ * been built yet, mapped to the family that will deliver them. Every one appears
+ * only in an optional slot (`fallback: 'omit'`) or in `chrome`, both of which
+ * degrade to nothing at compose time. Delete an entry the moment its widget
+ * registers — `crosscheck.test.ts` fails on stale entries.
+ */
+export const PENDING_TEMPLATE_WIDGET_IDS = {
+// NOTE: the forms (§10) and chrome (§11) entries that used to live here —
+// filter-chip-bar, modal-wizard, segmented-control, breadcrumb, global-search,
+// tab-bar — were delivered by Track FCS in M7 Wave 3 and are now registered,
+// so they were removed per the shrink-to-empty discipline above.
+// NOTE: the kpi (§1) entries — auto-insights, micro-kpi-subtitle,
+// stat-pair-card — and the feeds (§4) overlay `toast-stack` were delivered by
+// TRACK KPI-FEEDS in M7 Wave 4 and are now registered, so they were removed
+// per the same discipline (`crosscheck.test.ts` fails on a stale entry —
+// `stale-pending-entry` — which is what forced this edit). Their manifest
+// sites needed no change: the slots were already holding open with
+// `fallback: 'omit'` / sitting in `chrome`, so registering the ids is what
+// fills them.
+// NOTE: the calendar (§5) entries — calendar-legend-filter, date-range-picker,
+// upcoming-events-list — and the boards (§6) inline-compose-card were
+// delivered by TRACK TABLES-CAL-BOARDS in M7 Wave 4 and are now registered, so
+// they were removed per the shrink-to-empty discipline above. Their manifest
+// sites needed no edit: page-calendar's `legend`/`upcoming` and page-board's
+// `compose` were already holding the slots open with `fallback: 'omit'`, and
+// the pickers were already listed in the calendar/scheduler/log-viewer/
+// dashboard toolbars — registering the ids is what fills them.
+// NOTE: `call-widget` (§9, page-chat's optional `call` slot) was delivered by
+// TRACK COMM-GEO in M7 Wave 4 and is now registered, so it was removed per the
+// shrink-to-empty discipline above — `crosscheck.test.ts` fails on a stale
+// entry (`stale-pending-entry`), which is what forced this edit.
+// NOTE: `starter-template-picker` (§13, referenced by `page-builder`'s
+// `chrome.overlays`) was delivered by TRACK OPS in M7 Wave 4 and is now
+// registered, so it was removed per the shrink-to-empty discipline above —
+// `crosscheck.test.ts` fails on a stale entry (`stale-pending-entry`), which
+// is what forced this edit. page-builder needed no change: the picker already
+// sat in `chrome.overlays`, and registering the id is what mounts it.
+//
+// THIS LIST IS NOW EMPTY, which is the terminal state it was built to reach:
+// every id every shipped manifest names is registered. An entry reappearing
+// here means a manifest is naming a widget ahead of its family again.
+};
+function sitesOf(manifest, isRegistered) {
+    const out = [];
+    for (const slot of manifest.slots) {
+        const widgets = slot.accepts.widgets ?? [];
+        // A pending id in this slot is never load-bearing if the slot can still
+        // resolve without it: it omits rather than empty-states, OR it accepts a
+        // shape (reachable by other candidates), OR it allow-lists some OTHER widget
+        // that IS registered. Only a slot with none of those holds space for a widget
+        // that cannot render.
+        const degradesToNothing = slot.fallback === 'omit' ||
+            (slot.accepts.shapes ?? []).length > 0 ||
+            widgets.some((widgetId) => isRegistered(widgetId));
+        for (const widgetId of widgets) {
+            out.push({ site: { kind: 'slot', slot: slot.slot, degradesToNothing }, widgetId });
+        }
+    }
+    for (const widgetId of manifest.chrome?.toolbar ?? []) {
+        out.push({ site: { kind: 'chrome', slot: 'chrome.toolbar' }, widgetId });
+    }
+    for (const widgetId of manifest.chrome?.overlays ?? []) {
+        out.push({ site: { kind: 'chrome', slot: 'chrome.overlays' }, widgetId });
+    }
+    return out;
+}
+/**
+ * Cross-check one manifest against the live registry.
+ *
+ * @param isRegistered membership test against the assembled `widgetRegistry`.
+ * @returns issues, empty when the manifest is clean.
+ */
+export function crossCheckTemplate(manifest, isRegistered, pending = PENDING_TEMPLATE_WIDGET_IDS) {
+    const issues = [];
+    /** Slots already reported as structurally dead — their ids need no further grading. */
+    const deadSlots = new Set();
+    for (const slot of manifest.slots) {
+        const shapes = slot.accepts.shapes ?? [];
+        const widgets = slot.accepts.widgets ?? [];
+        if (shapes.length === 0 && widgets.length === 0) {
+            issues.push({
+                code: 'slot-accepts-nothing',
+                templateId: manifest.id,
+                slot: slot.slot,
+                message: `Slot '${slot.slot}' of '${manifest.id}' declares neither accepts.shapes nor accepts.widgets, so no candidate can ever fill it`,
+            });
+            deadSlots.add(slot.slot);
+            continue;
+        }
+        // Fatal only when NOTHING can fill the slot: no shape-accept, and every
+        // allow-listed widget unregistered. One pending id beside a registered
+        // sibling is inert — `composeTemplate` just never matches it.
+        if (!slot.required)
+            continue;
+        if (shapes.length > 0 || widgets.some((widgetId) => isRegistered(widgetId)))
+            continue;
+        issues.push({
+            code: 'required-slot-unregistered',
+            templateId: manifest.id,
+            slot: slot.slot,
+            widgetId: widgets[0],
+            message: `Required slot '${slot.slot}' of '${manifest.id}' accepts no shapes and allow-lists only unregistered widgets (${widgets
+                .map((widgetId) => `'${widgetId}'`)
+                .join(', ')}); the slot can never be filled`,
+        });
+        deadSlots.add(slot.slot);
+    }
+    for (const { site, widgetId } of sitesOf(manifest, isRegistered)) {
+        // The slot's own verdict already covers every id it lists — one issue per
+        // reference, as before.
+        if (site.kind === 'slot' && deadSlots.has(site.slot))
+            continue;
+        if (isRegistered(widgetId)) {
+            if (Object.hasOwn(pending, widgetId)) {
+                issues.push({
+                    code: 'stale-pending-entry',
+                    templateId: manifest.id,
+                    slot: site.slot,
+                    widgetId,
+                    message: `'${widgetId}' is now registered — remove it from PENDING_TEMPLATE_WIDGET_IDS`,
+                });
+            }
+            continue;
+        }
+        if (!Object.hasOwn(pending, widgetId)) {
+            issues.push({
+                code: 'unregistered-widget',
+                templateId: manifest.id,
+                slot: site.slot,
+                widgetId,
+                message: `'${manifest.id}' references unregistered widget '${widgetId}' at ${site.slot}; register it, remove the reference, or declare it in PENDING_TEMPLATE_WIDGET_IDS`,
+            });
+            continue;
+        }
+        // Declared-pending in an optional slot — clean only if the slot actually
+        // degrades to nothing. A slot that empty-states instead would hold space for
+        // a widget that cannot render.
+        if (site.kind === 'slot' && !site.degradesToNothing) {
+            issues.push({
+                code: 'pending-id-not-degradable',
+                templateId: manifest.id,
+                slot: site.slot,
+                widgetId,
+                message: `Slot '${site.slot}' of '${manifest.id}' only accepts pending widget '${widgetId}' but does not fall back to 'omit'`,
+            });
+        }
+    }
+    return issues;
+}
+/** Cross-check every shipped manifest; the CI gate asserts this is empty. */
+export function crossCheckTemplates(manifests, isRegistered, pending = PENDING_TEMPLATE_WIDGET_IDS) {
+    return [...manifests].flatMap((manifest) => crossCheckTemplate(manifest, isRegistered, pending));
+}
+//# sourceMappingURL=crosscheck.js.map

package/dist/templates/crosscheck.js.map

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

package/dist/templates/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Page templates (04-widget-registry.md §10) — the manifest system.
+ *
+ * Two layers live under `src/templates/`:
+ *   - **the manifest engine** (this barrel): `pageTemplateSchema`, the shipped
+ *     `page-*.json` manifests, `composeTemplate`, and the registry cross-check.
+ *     Pure data + pure functions; the Engine's generator consumes them.
+ *   - **template components** (`page-crud/`, `page-dashboard/`): the React
+ *     surfaces that render a stored page. They are exported from the package
+ *     root, not here, and are unaffected by the manifest system — the manifests
+ *     *describe* their composition (see `manifests.ts`).
+ */
+export { InvalidPageTemplateError, pageTemplateSchema, parsePageTemplate, slotAcceptsSchema, slotAreaSchema, slotCapacity, slotFallbackSchema, slotRepeatFlowSchema, slotRepeatSchema, templateChromeSchema, templateSlotSchema, type PageTemplate, type PageTemplateInput, type SlotAccepts, type SlotArea, type SlotFallback, type SlotRepeat, type SlotRepeatFlow, type TemplateChrome, type TemplateSlot, } from './template-schema.js';
+export { DuplicatePageTemplateManifestError, PAGE_TEMPLATE_IDS, buildTemplateManifests, getPageTemplateManifest, pageTemplateManifests, } from './manifests.js';
+export { EMPTY_STATE_WIDGET_ID, composeTemplate, slotAccepts, slotInstanceArea, templateKind, type ComposeContext, type ComposeResult, type ComposeWarning, type ComposeWarningCode, type ComposedPage, type ComposedPageKind, type TemplateCandidate, } from './compose.js';
+export { PENDING_TEMPLATE_WIDGET_IDS, crossCheckTemplate, crossCheckTemplates, type CrossCheckCode, type CrossCheckIssue, } from './crosscheck.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kCAAkC,EAClC,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/templates/index.js

@@ -0,0 +1,17 @@
+/**
+ * Page templates (04-widget-registry.md §10) — the manifest system.
+ *
+ * Two layers live under `src/templates/`:
+ *   - **the manifest engine** (this barrel): `pageTemplateSchema`, the shipped
+ *     `page-*.json` manifests, `composeTemplate`, and the registry cross-check.
+ *     Pure data + pure functions; the Engine's generator consumes them.
+ *   - **template components** (`page-crud/`, `page-dashboard/`): the React
+ *     surfaces that render a stored page. They are exported from the package
+ *     root, not here, and are unaffected by the manifest system — the manifests
+ *     *describe* their composition (see `manifests.ts`).
+ */
+export { InvalidPageTemplateError, pageTemplateSchema, parsePageTemplate, slotAcceptsSchema, slotAreaSchema, slotCapacity, slotFallbackSchema, slotRepeatFlowSchema, slotRepeatSchema, templateChromeSchema, templateSlotSchema, } from './template-schema.js';
+export { DuplicatePageTemplateManifestError, PAGE_TEMPLATE_IDS, buildTemplateManifests, getPageTemplateManifest, pageTemplateManifests, } from './manifests.js';
+export { EMPTY_STATE_WIDGET_ID, composeTemplate, slotAccepts, slotInstanceArea, templateKind, } from './compose.js';
+export { PENDING_TEMPLATE_WIDGET_IDS, crossCheckTemplate, crossCheckTemplates, } from './crosscheck.js';
+//# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GAUnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kCAAkC,EAClC,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,YAAY,GAQb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,mBAAmB,GAGpB,MAAM,iBAAiB,CAAC"}

package/dist/templates/manifests.d.ts

@@ -0,0 +1,13 @@
+import { type PageTemplate } from './template-schema.js';
+export declare class DuplicatePageTemplateManifestError extends Error {
+    readonly templateId: string;
+    constructor(templateId: string);
+}
+/** Parse + index manifests; duplicate ids throw. Exported for marketplace bundles. */
+export declare function buildTemplateManifests(raw: readonly unknown[]): ReadonlyMap<string, PageTemplate>;
+/** Every shipped manifest, keyed by template id. */
+export declare const pageTemplateManifests: ReadonlyMap<string, PageTemplate>;
+/** Shipped template ids, in manifest order. */
+export declare const PAGE_TEMPLATE_IDS: readonly string[];
+export declare function getPageTemplateManifest(id: string): PageTemplate | undefined;
+//# sourceMappingURL=manifests.d.ts.map

package/dist/templates/manifests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifests.d.ts","sourceRoot":"","sources":["../../src/templates/manifests.ts"],"names":[],"mappings":"AA4DA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAyB5E,qBAAa,kCAAmC,SAAQ,KAAK;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAIxC;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,OAAO,EAAE,GAAG,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAQjG;AAED,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAC7B,CAAC;AAExC,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAsC,CAAC;AAEtF,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE5E"}

package/dist/templates/manifests.js

@@ -0,0 +1,110 @@
+/**
+ * The shipped page-template manifests (04-widget-registry.md §10).
+ *
+ * The `page-*.json` files beside this module are the source of truth — this
+ * module only imports and parses them, so the JSON stays the artifact the
+ * marketplace installer, the docs, and third-party `x-<vendor>-page-*` templates
+ * are written against (04 §9/§10). Parsing here (rather than at each call site)
+ * is what applies the schema's `required: false` / `fallback: 'omit'` defaults,
+ * so every consumer sees a fully-resolved `PageTemplate`.
+ *
+ * A malformed manifest throws at module init. That is deliberate: these files
+ * are checked in, `manifests.test.ts` is the CI gate (acceptance #16), and a
+ * template the runtime cannot parse must never reach page generation.
+ *
+ * COVERAGE: 14 of the 23 §14 archetypes ship today — the two the M4 generator
+ * already emits (`page-crud`, `page-dashboard`, whose components live under
+ * `templates/page-crud/` and `templates/page-dashboard/`; the manifests here
+ * *describe* those compositions) plus the nine M7 archetypes, plus the M7 Wave-4
+ * `page-builder` (TRACK BUILDER) — the archetype the §13 document vocabulary is
+ * built for, which is why it lands with `document-canvas` rather than waiting on
+ * the families its optional rails reference — plus wave 2's `page-wizard`
+ * (T5 data-io stepped flows) and `page-settings` (T6 notification preference
+ * matrix). The remaining nine (`page-status`, `page-billing`, `page-api`,
+ * `page-kb-docs`, `page-auth`, `page-system-state`, `page-marketing`,
+ * `page-hub-home`, `page-onboarding-checklist`) land with the families they are
+ * built from.
+ *
+ * `page-dashboard` VERSION 2 (04 §10): v2 raises the chart-slot heights
+ * (`hero-chart`/`breakdown`/`grid-secondary`) from h6 to h8 and re-stacks the
+ * rows below, matching the bespoke generator's CHART_HEIGHT=8 so migrating
+ * generated dashboards onto `composeTemplate` preserves their shipped
+ * geometry. No `migrations/` folder ships with the bump: nothing in the
+ * runtime consumes per-template migrations yet (H5 regenerates untouched
+ * pages in place, which re-composes against the current manifest), and 04 §10
+ * says migrations arrive with their first consumer, not speculatively.
+ *
+ * `page-crud` IS A TYPED-BODY TEMPLATE (09-generated-app.md §3.3): its stored
+ * config carries `columns[]`/`defaultSort`/`form`/`detail` (composed by
+ * `../generate/crud-body.ts`), NOT a `config.layout`, and `PageCrud.tsx` never
+ * reads slots. The slot list in `page-crud.json` is therefore *descriptive* —
+ * it records the §10 composition the hand-built template implements (grid +
+ * pagination + detail rails), keeping the manifest inside the published §10
+ * schema, which deliberately has no typed-body marker (see the SCHEMA FIDELITY
+ * note in `./template-schema.ts`). Do not feed `page-crud` through
+ * `composeTemplate` expecting the renderer to honour the result.
+ */
+import pageBoard from './page-board.json' with { type: 'json' };
+import pageBuilder from './page-builder.json' with { type: 'json' };
+import pageCalendar from './page-calendar.json' with { type: 'json' };
+import pageChat from './page-chat.json' with { type: 'json' };
+import pageCrud from './page-crud.json' with { type: 'json' };
+import pageDashboard from './page-dashboard.json' with { type: 'json' };
+import pageDirectory from './page-directory.json' with { type: 'json' };
+import pageFiles from './page-files.json' with { type: 'json' };
+import pageLogViewer from './page-log-viewer.json' with { type: 'json' };
+import pageMasterDetail from './page-master-detail.json' with { type: 'json' };
+import pageQueueInbox from './page-queue-inbox.json' with { type: 'json' };
+import pageScheduler from './page-scheduler.json' with { type: 'json' };
+import pageSettings from './page-settings.json' with { type: 'json' };
+import pageWizard from './page-wizard.json' with { type: 'json' };
+import { parsePageTemplate } from './template-schema.js';
+/**
+ * Raw manifest JSON, in nav/importance order. Typed `unknown` on purpose —
+ * `parsePageTemplate` is the only thing that may assert their shape, so a JSON
+ * edit that violates the schema fails the parse instead of silently widening a
+ * TypeScript inference.
+ */
+const MANIFEST_JSON = [
+    pageCrud,
+    pageDashboard,
+    pageMasterDetail,
+    pageQueueInbox,
+    pageBoard,
+    pageCalendar,
+    pageScheduler,
+    pageDirectory,
+    pageLogViewer,
+    pageFiles,
+    pageChat,
+    pageBuilder,
+    pageWizard,
+    pageSettings,
+];
+export class DuplicatePageTemplateManifestError extends Error {
+    templateId;
+    constructor(templateId) {
+        super(`Duplicate page-template manifest id: '${templateId}' — template ids are unique (04 §10)`);
+        this.templateId = templateId;
+        this.name = 'DuplicatePageTemplateManifestError';
+    }
+}
+/** Parse + index manifests; duplicate ids throw. Exported for marketplace bundles. */
+export function buildTemplateManifests(raw) {
+    const map = new Map();
+    for (const input of raw) {
+        const manifest = parsePageTemplate(input);
+        if (map.has(manifest.id))
+            throw new DuplicatePageTemplateManifestError(manifest.id);
+        map.set(manifest.id, manifest);
+    }
+    return map;
+}
+/** Every shipped manifest, keyed by template id. */
+export const pageTemplateManifests = buildTemplateManifests(MANIFEST_JSON);
+/** Shipped template ids, in manifest order. */
+export const PAGE_TEMPLATE_IDS = [...pageTemplateManifests.keys()];
+export function getPageTemplateManifest(id) {
+    return pageTemplateManifests.get(id);
+}
+//# sourceMappingURL=manifests.js.map