@adminiumjs/widgets 0.1.0-rc.1

package/dist/generate/dashboard-domain.js

@@ -0,0 +1,269 @@
+/**
+ * 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 { humanize, } from '../registry/candidates.js';
+function tag(entry, column) {
+    const info = entry.classified.columns.find((c) => c.column === column.name);
+    return info?.semantic ?? 'plain';
+}
+function ordinalOf(column) {
+    return column.ordinal ?? 0;
+}
+/** Query-descriptor `source` for a table (bespoke `descriptorSource` shape). */
+function descriptorSource(entry) {
+    const { table } = entry;
+    return {
+        ...(table.schema === undefined ? {} : { schema: table.schema }),
+        name: table.name,
+        type: (table.kind ?? 'table') === 'table' ? 'table' : 'view',
+    };
+}
+/**
+ * Rank a domain's columns matching `predicate`: hub table first, then tables
+ * adjacent to the hub, then the rest; within a table, declaration order.
+ */
+function rankDomainColumns(domain, model, relations, predicate) {
+    const adjacent = new Set();
+    for (const relation of relations) {
+        if (relation.from.tableId === domain.hubTableId)
+            adjacent.add(relation.to.tableId);
+        if (relation.to.tableId === domain.hubTableId)
+            adjacent.add(relation.from.tableId);
+    }
+    const tier = (id) => (id === domain.hubTableId ? 0 : adjacent.has(id) ? 1 : 2);
+    const out = [];
+    for (const entry of model) {
+        if (!domain.tableIds.includes(entry.table.id))
+            continue;
+        for (const column of entry.table.columns) {
+            const semantic = tag(entry, column);
+            if (predicate(semantic, column))
+                out.push({ entry, column, semantic });
+        }
+    }
+    out.sort((a, b) => tier(a.entry.table.id) - tier(b.entry.table.id) ||
+        a.entry.table.id.localeCompare(b.entry.table.id) ||
+        ordinalOf(a.column) - ordinalOf(b.column));
+    return out;
+}
+const TIMESTAMPY = new Set(['date', 'timestamp', 'timestamptz']);
+/** Best time axis: created-at first (05 §7.1 rule 9), else event timestamps. */
+function bestTimestamp(domain, model, relations) {
+    const createdAt = rankDomainColumns(domain, model, relations, (s) => s === 'created-at');
+    if (createdAt.length > 0)
+        return createdAt[0];
+    const eventish = rankDomainColumns(domain, model, relations, (s, c) => (s === 'event-timestamp' || s === 'date-range') && TIMESTAMPY.has(c.logicalType));
+    return eventish[0] ?? null;
+}
+/** Donut group-by ranking: status > category > geo-region > boolean flags. */
+function bestCategorical(domain, model, relations) {
+    for (const wanted of ['status-workflow', 'category-enum', 'geo-region', 'boolean-flag']) {
+        const hits = rankDomainColumns(domain, model, relations, (s) => s === wanted);
+        if (hits.length === 0)
+            continue;
+        if (wanted === 'geo-region') {
+            // Country beats region/state/city-level codes as a breakdown.
+            const country = hits.find((h) => /country/i.test(h.column.name));
+            return country ?? hits[0];
+        }
+        return hits[0];
+    }
+    return null;
+}
+/** §8 trigger: a domain can host a dashboard only with ≥ 1 time axis. */
+export function domainHasDashboardSignal(domain, model, relations) {
+    return bestTimestamp(domain, model, relations) !== null;
+}
+/** The §15 dashboard candidates all share one score: input order decides. */
+const DOMAIN_SCORE = 1;
+/** Bespoke `ACTIVE`-state vocabulary for the status KPI (annex §1/§6). */
+const ACTIVE_STATE = /^(open|pending|new|in_progress|active|todo|backlog)$/i;
+function kpi(instanceId, title, binding, extra = {}) {
+    return {
+        widget: 'kpi-stat-card',
+        shape: binding.shape,
+        score: DOMAIN_SCORE,
+        instanceId,
+        config: { title, binding, ...extra },
+    };
+}
+/**
+ * Build the four §15 KPI candidates for a domain. Always returns exactly 4
+ * when the domain has enough tables (fallbacks: secondary-table counts) so
+ * the KPI row is stable; `composeTemplate` tiles them 3×3 along the row.
+ */
+function kpiRow(domain, model, relations, connectionId) {
+    const byId = new Map(model.map((entry) => [entry.table.id, entry]));
+    const hub = byId.get(domain.hubTableId);
+    const hubLabel = humanize(hub.table.name);
+    const items = [];
+    // 1 — COUNT(*) of the hub table.
+    items.push(kpi(`kpi-count-${hub.table.name}`, `Total ${hubLabel}`, {
+        kind: 'table-query',
+        connectionId,
+        source: descriptorSource(hub),
+        shape: 'single-metric',
+        aggregations: [{ fn: 'count', alias: 'value' }],
+    }));
+    // 2 — money SUM when present (hub first, then adjacent tables).
+    const money = rankDomainColumns(domain, model, relations, (s) => s === 'money')[0];
+    if (money !== undefined) {
+        items.push(kpi(`kpi-sum-${money.entry.table.name}-${money.column.name}`, `Total ${humanize(money.column.name)}`, {
+            kind: 'table-query',
+            connectionId,
+            source: descriptorSource(money.entry),
+            shape: 'single-metric',
+            aggregations: [{ fn: 'sum', column: money.column.name, alias: 'value' }],
+        }, { format: 'currency' }));
+    }
+    // 3 — new-this-period on the created-at family, with prior comparison.
+    const ts = bestTimestamp(domain, model, relations);
+    if (ts !== null && items.length < 4) {
+        items.push(kpi(`kpi-new-${ts.entry.table.name}`, `New ${humanize(ts.entry.table.name)} (30d)`, {
+            kind: 'table-query',
+            connectionId,
+            source: descriptorSource(ts.entry),
+            shape: 'metric+delta',
+            aggregations: [{ fn: 'count', alias: 'value' }],
+            window: { column: ts.column.name, last: 30, unit: 'day', compareToPrior: true },
+        }));
+    }
+    // 4 — status-group count when a workflow enum exists…
+    const status = rankDomainColumns(domain, model, relations, (s) => s === 'status-workflow')[0];
+    if (status !== undefined && items.length < 4) {
+        const values = status.column.enumValues ?? [];
+        const active = values.find((v) => ACTIVE_STATE.test(v)) ?? values[0] ?? null;
+        if (active !== null) {
+            items.push(kpi(`kpi-status-${status.entry.table.name}`, `${humanize(active)} ${humanize(status.entry.table.name)}`, {
+                kind: 'table-query',
+                connectionId,
+                source: descriptorSource(status.entry),
+                shape: 'single-metric',
+                aggregations: [{ fn: 'count', alias: 'value' }],
+                filters: [{ column: status.column.name, op: 'eq', value: active }],
+            }));
+        }
+    }
+    // …fallbacks: counts of the next-most-connected entity tables.
+    if (items.length < 4) {
+        const fallbacks = domain.tableIds
+            .map((id) => byId.get(id))
+            .filter((entry) => entry !== undefined &&
+            entry.table.id !== hub.table.id &&
+            entry.classified.role !== 'join-table')
+            .sort((a, b) => (b.table.rowCountEstimate ?? 0) - (a.table.rowCountEstimate ?? 0) ||
+            a.table.id.localeCompare(b.table.id));
+        for (const entry of fallbacks) {
+            if (items.length >= 4)
+                break;
+            items.push(kpi(`kpi-count-${entry.table.name}`, `Total ${humanize(entry.table.name)}`, {
+                kind: 'table-query',
+                connectionId,
+                source: descriptorSource(entry),
+                shape: 'single-metric',
+                aggregations: [{ fn: 'count', alias: 'value' }],
+            }));
+        }
+    }
+    return items.slice(0, 4);
+}
+/**
+ * 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 function emitDomainDashboardCandidates(domain, model, relations, ctx) {
+    const hub = model.find((entry) => entry.table.id === domain.hubTableId);
+    if (hub === undefined)
+        return null;
+    const ts = bestTimestamp(domain, model, relations);
+    if (ts === null)
+        return null; // §8: dashboard needs ≥1 timestamp in the domain
+    const items = kpiRow(domain, model, relations, ctx.connectionId);
+    // Hero timeseries: money sum when the time-axis table has a money column,
+    // else row count, bucketed by month (§15 chart candidate ranking).
+    const heroMoney = ts.entry.table.columns.find((c) => tag(ts.entry, c) === 'money');
+    items.push({
+        widget: 'chart-line-area',
+        shape: 'timeseries',
+        score: DOMAIN_SCORE,
+        instanceId: `hero-line-${ts.entry.table.name}`,
+        config: {
+            title: heroMoney !== undefined
+                ? `${humanize(heroMoney.name)} per Month`
+                : `${humanize(ts.entry.table.name)} per Month`,
+            binding: {
+                kind: 'table-query',
+                connectionId: ctx.connectionId,
+                source: descriptorSource(ts.entry),
+                shape: 'timeseries',
+                aggregations: [
+                    heroMoney !== undefined
+                        ? { fn: 'sum', column: heroMoney.name, alias: 'value' }
+                        : { fn: 'count', alias: 'value' },
+                ],
+                bucket: { column: ts.column.name, unit: 'month' },
+            },
+        },
+    });
+    // Donut: top categorical/status breakdown (§15), beside the hero.
+    const categorical = bestCategorical(domain, model, relations);
+    if (categorical !== null) {
+        items.push({
+            widget: 'chart-donut',
+            shape: 'categorical',
+            score: DOMAIN_SCORE,
+            instanceId: `donut-${categorical.entry.table.name}-${categorical.column.name}`,
+            config: {
+                title: `${humanize(categorical.entry.table.name)} by ${humanize(categorical.column.name)}`,
+                binding: {
+                    kind: 'table-query',
+                    connectionId: ctx.connectionId,
+                    source: descriptorSource(categorical.entry),
+                    shape: 'categorical',
+                    aggregations: [{ fn: 'count', alias: 'value' }],
+                    groupBy: [categorical.column.name],
+                    limit: 8,
+                },
+            },
+        });
+    }
+    return items;
+}
+//# sourceMappingURL=dashboard-domain.js.map

package/dist/generate/dashboard-domain.js.map

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

package/dist/generate/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `@adminium/widgets/generate` — the **pure generator leaf** subpath.
+ *
+ * WHAT IT IS: the registry-owned, engine-facing pieces of the
+ * auto-instantiation pipeline (04-widget-registry.md §8), and nothing else:
+ *
+ *   - **H1/H2** `emitCandidates` + `candidateRules` + the §14 archetype triggers
+ *     (`../registry/candidates.ts`, `../registry/archetypes.ts`);
+ *   - **H4** `composeTemplate` + the shipped `page-*.json` manifests +
+ *     `pageTemplateSchema` (`../templates/`);
+ *   - the generated-page body vocabulary: `composeCrudBody` (the typed
+ *     `page-crud` config body, 09 §3.3) and `emitDomainDashboardCandidates`
+ *     (the §15 per-domain dashboard widget set) — `./crud-body.ts`,
+ *     `./dashboard-domain.ts`.
+ *
+ * WHY IT EXISTS: 04 §8 puts hooks H1/H2/H4 in the Engine's hands
+ * ("`composeTemplate(templateId, candidates, ctx)` … → `PageConfig` rows written
+ * to `adminium_pages`") while 04 §8 also fixes the rules' home in this package
+ * ("the Registry owns what can be instantiated and why … so the catalog and its
+ * trigger logic never drift apart"). The Engine therefore needs *some* import of
+ * this package, and 01-architecture.md §2.3 allows it exactly one: a leaf
+ * subpath that pulls no component code. `@adminium/widgets/page-config` is the
+ * wrong one — it is the frozen **config-body schema** leaf that the server and
+ * `@adminium/engine/config` bundle, and it must not grow generator logic. So
+ * this is a second leaf, under the same rules:
+ *
+ *   **PURITY CONTRACT** — every module reachable from here imports only `zod`,
+ *   the `page-config` leaf, and each other. No React, no component code, no
+ *   `node:` builtins, no `@adminium/ui|charts|i18n|tokens`. `leaf-purity.test.ts`
+ *   is the gate; `.dependency-cruiser.cjs` (`engine-no-full-widgets`) carves out
+ *   this path and nothing else.
+ *
+ * Notably absent: `../templates/crosscheck.ts` (it reads the live
+ * `widgetRegistry`, i.e. component code) and `../templates/page-crud|page-
+ * dashboard/` (React). Callers that need a registry-membership test pass one in
+ * as `ctx.isRegistered` — that inverts the dependency and keeps this leaf pure.
+ * `REGISTERED_WIDGET_IDS` below is the leaf-safe **data mirror** of that map for
+ * callers with no registry of their own to pass (the Engine, and through it the
+ * server, which 01 §2.3 bars from importing this package at all); a parity test
+ * pins it to `widgetRegistry`.
+ */
+export { FAMILY_CAPS, buildCandidateView, candidateRules, emitCandidates, emitModelCandidates, humanize, type CandidateColumn, type CandidateContext, type CandidateRelation, type CandidateRule, type CandidateTable, type CandidateTableInput, type CandidateView, type ClassifiedColumnInput, type ClassifiedTableInput, type ViewColumn, type WidgetCandidate, } from '../registry/candidates.js';
+export { composeCrudBody, enumTones, type CrudBodyContext, type CrudDetailTab, type CrudEnumTone, type CrudFormField, type CrudPageBody, type CrudSortSpec, } from './crud-body.js';
+export { domainHasDashboardSignal, emitDomainDashboardCandidates, type DashboardDomain, type DashboardDomainContext, } from './dashboard-domain.js';
+export { gridColumnSpecSchema, type GridColumnSpec, type GridColumnSpecInput, type GridTone, } from '../page-config/grid-column-spec.js';
+export { REGISTERED_WIDGET_IDS, isRegisteredWidgetId, } from '../registry/registered-ids.js';
+export { ARCHETYPE_TEMPLATE_IDS, archetypeRules, scoreArchetypes, selectArchetype, selectModelArchetypes, type ArchetypeRule, type ArchetypeSelection, } from '../registry/archetypes.js';
+export { InvalidPageTemplateError, pageTemplateSchema, parsePageTemplate, slotCapacity, type PageTemplate, type PageTemplateInput, type SlotAccepts, type SlotArea, type TemplateChrome, type TemplateSlot, } from '../templates/template-schema.js';
+export { DuplicatePageTemplateManifestError, PAGE_TEMPLATE_IDS, buildTemplateManifests, getPageTemplateManifest, pageTemplateManifests, } from '../templates/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 '../templates/compose.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,eAAe,EACf,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,QAAQ,GACd,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,kCAAkC,EAClC,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,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,yBAAyB,CAAC"}

package/dist/generate/index.js

@@ -0,0 +1,55 @@
+/**
+ * `@adminium/widgets/generate` — the **pure generator leaf** subpath.
+ *
+ * WHAT IT IS: the registry-owned, engine-facing pieces of the
+ * auto-instantiation pipeline (04-widget-registry.md §8), and nothing else:
+ *
+ *   - **H1/H2** `emitCandidates` + `candidateRules` + the §14 archetype triggers
+ *     (`../registry/candidates.ts`, `../registry/archetypes.ts`);
+ *   - **H4** `composeTemplate` + the shipped `page-*.json` manifests +
+ *     `pageTemplateSchema` (`../templates/`);
+ *   - the generated-page body vocabulary: `composeCrudBody` (the typed
+ *     `page-crud` config body, 09 §3.3) and `emitDomainDashboardCandidates`
+ *     (the §15 per-domain dashboard widget set) — `./crud-body.ts`,
+ *     `./dashboard-domain.ts`.
+ *
+ * WHY IT EXISTS: 04 §8 puts hooks H1/H2/H4 in the Engine's hands
+ * ("`composeTemplate(templateId, candidates, ctx)` … → `PageConfig` rows written
+ * to `adminium_pages`") while 04 §8 also fixes the rules' home in this package
+ * ("the Registry owns what can be instantiated and why … so the catalog and its
+ * trigger logic never drift apart"). The Engine therefore needs *some* import of
+ * this package, and 01-architecture.md §2.3 allows it exactly one: a leaf
+ * subpath that pulls no component code. `@adminium/widgets/page-config` is the
+ * wrong one — it is the frozen **config-body schema** leaf that the server and
+ * `@adminium/engine/config` bundle, and it must not grow generator logic. So
+ * this is a second leaf, under the same rules:
+ *
+ *   **PURITY CONTRACT** — every module reachable from here imports only `zod`,
+ *   the `page-config` leaf, and each other. No React, no component code, no
+ *   `node:` builtins, no `@adminium/ui|charts|i18n|tokens`. `leaf-purity.test.ts`
+ *   is the gate; `.dependency-cruiser.cjs` (`engine-no-full-widgets`) carves out
+ *   this path and nothing else.
+ *
+ * Notably absent: `../templates/crosscheck.ts` (it reads the live
+ * `widgetRegistry`, i.e. component code) and `../templates/page-crud|page-
+ * dashboard/` (React). Callers that need a registry-membership test pass one in
+ * as `ctx.isRegistered` — that inverts the dependency and keeps this leaf pure.
+ * `REGISTERED_WIDGET_IDS` below is the leaf-safe **data mirror** of that map for
+ * callers with no registry of their own to pass (the Engine, and through it the
+ * server, which 01 §2.3 bars from importing this package at all); a parity test
+ * pins it to `widgetRegistry`.
+ */
+/* --------------------------------------------- H1/H2: candidates + triggers */
+export { FAMILY_CAPS, buildCandidateView, candidateRules, emitCandidates, emitModelCandidates, humanize, } from '../registry/candidates.js';
+/* -------------------------- generated-page bodies: crud + domain dashboards */
+export { composeCrudBody, enumTones, } from './crud-body.js';
+export { domainHasDashboardSignal, emitDomainDashboardCandidates, } from './dashboard-domain.js';
+/* ------------------------------------- page-crud config-body column contract */
+export { gridColumnSpecSchema, } from '../page-config/grid-column-spec.js';
+export { REGISTERED_WIDGET_IDS, isRegisteredWidgetId, } from '../registry/registered-ids.js';
+export { ARCHETYPE_TEMPLATE_IDS, archetypeRules, scoreArchetypes, selectArchetype, selectModelArchetypes, } from '../registry/archetypes.js';
+/* ------------------------------------------------ H4: template composition */
+export { InvalidPageTemplateError, pageTemplateSchema, parsePageTemplate, slotCapacity, } from '../templates/template-schema.js';
+export { DuplicatePageTemplateManifestError, PAGE_TEMPLATE_IDS, buildTemplateManifests, getPageTemplateManifest, pageTemplateManifests, } from '../templates/manifests.js';
+export { EMPTY_STATE_WIDGET_ID, composeTemplate, slotAccepts, slotInstanceArea, templateKind, } from '../templates/compose.js';
+//# sourceMappingURL=index.js.map

package/dist/generate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,gFAAgF;AAChF,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,QAAQ,GAYT,MAAM,2BAA2B,CAAC;AAEnC,gFAAgF;AAChF,OAAO,EACL,eAAe,EACf,SAAS,GAOV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,wBAAwB,EACxB,6BAA6B,GAG9B,MAAM,uBAAuB,CAAC;AAE/B,iFAAiF;AACjF,OAAO,EACL,oBAAoB,GAIrB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,eAAe,EACf,qBAAqB,GAGtB,MAAM,2BAA2B,CAAC;AAEnC,+EAA+E;AAC/E,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GAOb,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,kCAAkC,EAClC,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,YAAY,GAQb,MAAM,yBAAyB,CAAC"}

package/dist/grid/DashboardGrid.d.ts

@@ -0,0 +1,53 @@
+/**
+ * DashboardGrid — the `pageLayoutSchema` renderer (04-widget-registry.md §6).
+ * 12 fluid columns, 40 px half-row units, 16 px gap. Below `lg` the grid reflows
+ * to one stacked column ordered by `(y, x)`; items keep their height spans.
+ *
+ * Two modes on one surface:
+ *  - STATIC (default, M4): read-only placement. Unchanged from the original
+ *    renderer — the `page-dashboard` template and demos depend on it.
+ *  - EDIT (04-T12): pass `editMode` (the builder's pencil toggle). Each item
+ *    becomes a dnd-kit draggable whose activator is the WidgetFrame grip (the
+ *    host renders `<GridDragHandle/>` there), the grid surface is the droppable,
+ *    a custom modifier snaps the drag overlay to cells, and a pointer/keyboard
+ *    SE-corner (inline-end) handle resizes. On drop/commit the layout runs
+ *    `applyMove`/`applyResize` then `compactVertical` (all from ./layout-edit +
+ *    ./layout-math — never rebuilt here) and `onLayoutChange` fires the settled
+ *    `PageLayout`. Keyboard: focus the grip, arrows move a draft by one LOGICAL
+ *    cell, Shift+arrows resize, Enter saves, Escape reverts — announced through
+ *    one polite live region.
+ *
+ * Per-item placement uses the `--*` CSS-custom-property escape hatch (the only
+ * sanctioned style prop): coordinates land in `--gi-*` variables consumed by
+ * arbitrary-property utility classes, so no literal style values ever render.
+ */
+import type { ReactNode } from 'react';
+import type { GridEditLabelsInput } from './grid-edit.js';
+import type { MinSize } from './layout-schema.js';
+import type { LayoutItem, PageLayout } from './layout-schema.js';
+/** Extra context passed to `renderItem` so a host can place the drag grip. */
+export interface RenderItemContext {
+    editMode: boolean;
+    /** True while THIS item owns the keyboard edit session. */
+    grabbed: boolean;
+}
+export interface DashboardGridProps {
+    layout: PageLayout;
+    /** Render one placed widget (already position-sorted). In edit mode `ctx`
+     *  tells the host to render `<GridDragHandle/>` in the WidgetFrame grip slot. */
+    renderItem: (item: LayoutItem, ctx: RenderItemContext) => ReactNode;
+    className?: string | undefined;
+    testId?: string | undefined;
+    /** Builder edit toggle (04 §6.2). Off → the original static renderer. */
+    editMode?: boolean | undefined;
+    /** Settled `PageLayout` after every move/resize (debounced-persist upstream). */
+    onLayoutChange?: ((layout: PageLayout) => void) | undefined;
+    /** Per-widget resize floor (registry `sizing`); default `minW×minH = 1×1`. */
+    getSizing?: ((widgetId: string) => MinSize) | undefined;
+    /** Writing direction — mirrors the LOGICAL keyboard arrow semantics (04 §6.2). */
+    dir?: 'ltr' | 'rtl' | undefined;
+    /** i18n label + announcement overrides (builder passes `t('ui.grid.*')`). */
+    labels?: GridEditLabelsInput | undefined;
+}
+export declare function DashboardGrid({ layout, renderItem, className, testId, editMode, onLayoutChange, getSizing, dir, labels, }: DashboardGridProps): import("react").JSX.Element;
+//# sourceMappingURL=DashboardGrid.d.ts.map

package/dist/grid/DashboardGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DashboardGrid.d.ts","sourceRoot":"","sources":["../../src/grid/DashboardGrid.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAaH,OAAO,KAAK,EAGV,SAAS,EAEV,MAAM,OAAO,CAAC;AASf,OAAO,KAAK,EAAkB,mBAAmB,EAAwB,MAAM,gBAAgB,CAAC;AAShG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEjE,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB;qFACiF;IACjF,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,KAAK,SAAS,CAAC;IACpE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,iFAAiF;IACjF,cAAc,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC5D,8EAA8E;IAC9E,SAAS,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IACxD,kFAAkF;IAClF,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAChC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAC1C;AAgCD,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAgB,EAChB,cAAc,EACd,SAAS,EACT,GAAW,EACX,MAAM,GACP,EAAE,kBAAkB,+BAsCpB"}