@adminiumjs/widgets 0.1.0-rc.1

package/dist/grid/layout-edit.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Pure editing math for the dashboard grid edit mode (04-widget-registry.md
+ * §6.2). The static renderer's geometry + top-gravity compaction live in
+ * `./layout-math.ts` and are REUSED here (never rebuilt); this module adds the
+ * mutation primitives the dnd-kit drag/resize + keyboard paths funnel through:
+ *
+ *   applyMove   place an item at a target cell, pushing colliding items DOWN
+ *   applyResize resize an item (clamped to its registry `minW × minH` and the
+ *               grid), pushing colliding items down
+ *   commitDraft apply a combined position+size draft (the keyboard commit path)
+ *   findFirstFit first free cell for inserting a new widget (builder palette)
+ *
+ * Move/resize deliberately leave the layout UN-compacted; callers finish with
+ * `compactVertical` (04 §6.2: "drop → applyMove(...) then compactVertical(...)").
+ * Pushing collisions DOWN before that top-gravity settle is what makes a drop
+ * onto an occupied cell reorder deterministically rather than overlap: the
+ * anchor keeps the smaller `y`, so `compactVertical` (which floats items up in
+ * `(y, x)` order) settles it above the displaced items. All functions are pure
+ * and total — an unknown id returns the layout unchanged.
+ */
+import { type MinSize } from './layout-schema.js';
+import type { LayoutItem, PageLayout } from './layout-schema.js';
+/** A position+size draft (the keyboard edit session and resize preview). */
+export interface LayoutDraft {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/**
+ * Force a single item fully inside the 12-col grid with a non-negative row and
+ * a width/height within the schema bounds. `min` clamps width/height to the
+ * widget's registry floor (never below `minW × minH`, 04 §6.1); the SE resize
+ * handle grows to the inline-end, so width is capped at `GRID_COLUMNS - x` with
+ * `x` held fixed.
+ */
+export declare function clampItem(item: LayoutItem, min?: MinSize): LayoutItem;
+/**
+ * Move `id` to target cell `(x, y)` (keeping its size), pushing colliding items
+ * down. UN-compacted — pair with `compactVertical` (see file header, 04 §6.2).
+ */
+export declare function applyMove(layout: PageLayout, id: string, x: number, y: number): PageLayout;
+/**
+ * Resize `id` to `w × h` (keeping its position), never below `min.minW × minH`
+ * and never past the grid edge, pushing colliding items down. UN-compacted.
+ */
+export declare function applyResize(layout: PageLayout, id: string, w: number, h: number, min?: MinSize): PageLayout;
+/** Convenience: move then top-gravity settle (the pointer-drop / keyboard-move
+ *  commit path). */
+export declare function moveAndCompact(layout: PageLayout, id: string, x: number, y: number): PageLayout;
+/** Convenience: resize then top-gravity settle. */
+export declare function resizeAndCompact(layout: PageLayout, id: string, w: number, h: number, min?: MinSize): PageLayout;
+/**
+ * Commit a combined position+size draft (the keyboard edit session's `Enter`),
+ * clamped to `min` and the grid, collisions pushed down, then settled. One call
+ * so a session that both moved and resized lands atomically.
+ */
+export declare function commitDraft(layout: PageLayout, id: string, draft: LayoutDraft, min?: MinSize): PageLayout;
+/**
+ * First free cell for a `w × h` widget, scanning rows top-to-bottom then columns
+ * inline-start-to-end (04 §6.2, builder palette insertion). Always succeeds —
+ * the row below every placed item is guaranteed empty.
+ */
+export declare function findFirstFit(layout: PageLayout, w: number, h: number): {
+    x: number;
+    y: number;
+};
+/**
+ * Pixel step of one grid cell, measured from the live grid surface. `colStep`
+ * is one column plus one gap; `rowStep` is one 40 px half-row plus one gap. Fed
+ * to the drag/resize pixel→cell conversions below.
+ */
+export interface CellStep {
+    colStep: number;
+    rowStep: number;
+}
+/** Snap a pixel offset to a whole number of cells (nearest). Guards a zero/NaN
+ *  step (unmeasured surface) to 0 so drags never divide by zero. */
+export declare function snapPxToCells(px: number, step: number): number;
+/**
+ * Convert a dnd-kit pointer `delta` (px moved since drag start) to a signed
+ * `(dx, dy)` in grid cells. RTL mirroring is NOT applied here — pointer geometry
+ * is already visual; the caller mirrors the *result* only for the keyboard path.
+ */
+export declare function pointerDeltaToCells(delta: {
+    x: number;
+    y: number;
+}, cell: CellStep): {
+    dx: number;
+    dy: number;
+};
+/**
+ * Resolve a pointer-drop `delta` (px since drag start) to the item's target
+ * cell, matching the keyboard-move semantics (04 §6.2):
+ *
+ *  - the horizontal delta is mirrored LOGICALLY under `dir="rtl"` (the pointer
+ *    geometry is visual; a rightward visual drag must LOWER the logical column
+ *    in RTL — the same mirror the keyboard path and pointer-resize apply);
+ *  - `x` is CAPPED at `GRID_COLUMNS - w` so the item keeps its width when
+ *    dragged toward the inline-end edge (applyMove's documented "keeping its
+ *    size" contract) rather than being silently narrowed by `clampItem`.
+ */
+export declare function pointerMoveTarget(item: {
+    x: number;
+    y: number;
+    w: number;
+}, delta: {
+    x: number;
+    y: number;
+}, cell: CellStep, dir: 'ltr' | 'rtl'): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=layout-edit.d.ts.map

package/dist/grid/layout-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-edit.d.ts","sourceRoot":"","sources":["../../src/grid/layout-edit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEjE,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AASD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,GAAE,OAA0B,GAAG,UAAU,CAWvF;AA6CD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAE1F;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,GAAG,GAAE,OAA0B,GAC9B,UAAU,CAEZ;AAED;oBACoB;AACpB,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAE/F;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,EAClB,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,GAAG,GAAE,OAA0B,GAC9B,UAAU,CAEZ;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,WAAW,EAClB,GAAG,GAAE,OAA0B,GAC9B,UAAU,CAGZ;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAW/F;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;oEACoE;AACpE,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/B,IAAI,EAAE,QAAQ,GACb;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAE5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACzC,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,KAAK,GAAG,KAAK,GACjB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAM1B"}

package/dist/grid/layout-edit.js

@@ -0,0 +1,167 @@
+/**
+ * Pure editing math for the dashboard grid edit mode (04-widget-registry.md
+ * §6.2). The static renderer's geometry + top-gravity compaction live in
+ * `./layout-math.ts` and are REUSED here (never rebuilt); this module adds the
+ * mutation primitives the dnd-kit drag/resize + keyboard paths funnel through:
+ *
+ *   applyMove   place an item at a target cell, pushing colliding items DOWN
+ *   applyResize resize an item (clamped to its registry `minW × minH` and the
+ *               grid), pushing colliding items down
+ *   commitDraft apply a combined position+size draft (the keyboard commit path)
+ *   findFirstFit first free cell for inserting a new widget (builder palette)
+ *
+ * Move/resize deliberately leave the layout UN-compacted; callers finish with
+ * `compactVertical` (04 §6.2: "drop → applyMove(...) then compactVertical(...)").
+ * Pushing collisions DOWN before that top-gravity settle is what makes a drop
+ * onto an occupied cell reorder deterministically rather than overlap: the
+ * anchor keeps the smaller `y`, so `compactVertical` (which floats items up in
+ * `(y, x)` order) settles it above the displaced items. All functions are pure
+ * and total — an unknown id returns the layout unchanged.
+ */
+import { GRID_COLUMNS, compactVertical, sortByPosition } from './layout-math.js';
+import { DEFAULT_MIN_SIZE, MAX_H } from './layout-schema.js';
+function rectsOverlap(a, b) {
+    return a.x < b.x + b.w && b.x < a.x + a.w && a.y < b.y + b.h && b.y < a.y + a.h;
+}
+const clampInt = (value, lo, hi) => Math.min(Math.max(Math.round(value), lo), hi);
+/**
+ * Force a single item fully inside the 12-col grid with a non-negative row and
+ * a width/height within the schema bounds. `min` clamps width/height to the
+ * widget's registry floor (never below `minW × minH`, 04 §6.1); the SE resize
+ * handle grows to the inline-end, so width is capped at `GRID_COLUMNS - x` with
+ * `x` held fixed.
+ */
+export function clampItem(item, min = DEFAULT_MIN_SIZE) {
+    const minW = Math.max(1, Math.min(min.minW, GRID_COLUMNS));
+    const minH = Math.max(1, min.minH);
+    // Cap `x` so the min width still fits before the grid edge: an item at column
+    // 11 with `minW: 2` shifts one column inline-start rather than shrink below
+    // its floor (04 §6.1 — never below `minW × minH`).
+    const x = clampInt(item.x, 0, GRID_COLUMNS - minW);
+    const w = clampInt(item.w, minW, GRID_COLUMNS - x);
+    const h = clampInt(item.h, minH, MAX_H);
+    const y = Math.max(0, Math.round(item.y));
+    return { ...item, x, y, w, h };
+}
+/**
+ * Resolve overlaps by pushing every non-anchor item straight down below the
+ * anchor (and below any already-settled item it then meets). The anchor is
+ * pinned; others are processed in `(y, x)` order so the result is deterministic.
+ * Terminates: a pushed item's `y` only ever increases, bounded by the stack of
+ * settled heights.
+ */
+function pushDownCollisions(items, anchorId) {
+    const anchor = items.find((entry) => entry.i === anchorId);
+    if (anchor === undefined)
+        return [...items];
+    const settled = [anchor];
+    for (const item of sortByPosition(items.filter((entry) => entry.i !== anchorId))) {
+        let candidate = { ...item };
+        let moved = true;
+        while (moved) {
+            moved = false;
+            for (const other of settled) {
+                if (rectsOverlap(candidate, other)) {
+                    candidate = { ...candidate, y: other.y + other.h };
+                    moved = true;
+                }
+            }
+        }
+        settled.push(candidate);
+    }
+    return settled;
+}
+/** Apply a partial position/size patch to one item, clamp it, and push down
+ *  everything it now collides with. Returns the UN-compacted layout. */
+function placeAndResolve(layout, id, patch, min) {
+    const target = layout.items.find((entry) => entry.i === id);
+    if (target === undefined)
+        return layout;
+    const moved = clampItem({ ...target, ...patch }, min);
+    const next = layout.items.map((entry) => (entry.i === id ? moved : entry));
+    return { ...layout, items: pushDownCollisions(next, id) };
+}
+/**
+ * Move `id` to target cell `(x, y)` (keeping its size), pushing colliding items
+ * down. UN-compacted — pair with `compactVertical` (see file header, 04 §6.2).
+ */
+export function applyMove(layout, id, x, y) {
+    return placeAndResolve(layout, id, { x, y }, DEFAULT_MIN_SIZE);
+}
+/**
+ * Resize `id` to `w × h` (keeping its position), never below `min.minW × minH`
+ * and never past the grid edge, pushing colliding items down. UN-compacted.
+ */
+export function applyResize(layout, id, w, h, min = DEFAULT_MIN_SIZE) {
+    return placeAndResolve(layout, id, { w, h }, min);
+}
+/** Convenience: move then top-gravity settle (the pointer-drop / keyboard-move
+ *  commit path). */
+export function moveAndCompact(layout, id, x, y) {
+    return { ...layout, items: compactVertical(applyMove(layout, id, x, y).items) };
+}
+/** Convenience: resize then top-gravity settle. */
+export function resizeAndCompact(layout, id, w, h, min = DEFAULT_MIN_SIZE) {
+    return { ...layout, items: compactVertical(applyResize(layout, id, w, h, min).items) };
+}
+/**
+ * Commit a combined position+size draft (the keyboard edit session's `Enter`),
+ * clamped to `min` and the grid, collisions pushed down, then settled. One call
+ * so a session that both moved and resized lands atomically.
+ */
+export function commitDraft(layout, id, draft, min = DEFAULT_MIN_SIZE) {
+    const resolved = placeAndResolve(layout, id, draft, min);
+    return { ...layout, items: compactVertical(resolved.items) };
+}
+/**
+ * First free cell for a `w × h` widget, scanning rows top-to-bottom then columns
+ * inline-start-to-end (04 §6.2, builder palette insertion). Always succeeds —
+ * the row below every placed item is guaranteed empty.
+ */
+export function findFirstFit(layout, w, h) {
+    const width = clampInt(w, 1, GRID_COLUMNS);
+    const height = Math.max(1, Math.round(h));
+    const bottom = layout.items.reduce((max, item) => Math.max(max, item.y + item.h), 0);
+    for (let y = 0; y <= bottom; y += 1) {
+        for (let x = 0; x <= GRID_COLUMNS - width; x += 1) {
+            const probe = { i: '', widget: '', x, y, w: width, h: height, config: {} };
+            if (!layout.items.some((item) => rectsOverlap(probe, item)))
+                return { x, y };
+        }
+    }
+    return { x: 0, y: bottom };
+}
+/** Snap a pixel offset to a whole number of cells (nearest). Guards a zero/NaN
+ *  step (unmeasured surface) to 0 so drags never divide by zero. */
+export function snapPxToCells(px, step) {
+    if (!Number.isFinite(step) || step <= 0)
+        return 0;
+    return Math.round(px / step);
+}
+/**
+ * Convert a dnd-kit pointer `delta` (px moved since drag start) to a signed
+ * `(dx, dy)` in grid cells. RTL mirroring is NOT applied here — pointer geometry
+ * is already visual; the caller mirrors the *result* only for the keyboard path.
+ */
+export function pointerDeltaToCells(delta, cell) {
+    return { dx: snapPxToCells(delta.x, cell.colStep), dy: snapPxToCells(delta.y, cell.rowStep) };
+}
+/**
+ * Resolve a pointer-drop `delta` (px since drag start) to the item's target
+ * cell, matching the keyboard-move semantics (04 §6.2):
+ *
+ *  - the horizontal delta is mirrored LOGICALLY under `dir="rtl"` (the pointer
+ *    geometry is visual; a rightward visual drag must LOWER the logical column
+ *    in RTL — the same mirror the keyboard path and pointer-resize apply);
+ *  - `x` is CAPPED at `GRID_COLUMNS - w` so the item keeps its width when
+ *    dragged toward the inline-end edge (applyMove's documented "keeping its
+ *    size" contract) rather than being silently narrowed by `clampItem`.
+ */
+export function pointerMoveTarget(item, delta, cell, dir) {
+    const { dx: rawDx, dy } = pointerDeltaToCells(delta, cell);
+    const dx = (dir === 'rtl' ? -1 : 1) * rawDx;
+    const x = Math.min(Math.max(item.x + dx, 0), Math.max(0, GRID_COLUMNS - item.w));
+    const y = Math.max(0, item.y + dy);
+    return { x, y };
+}
+//# sourceMappingURL=layout-edit.js.map

package/dist/grid/layout-edit.js.map

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

package/dist/grid/layout-math.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Static layout math for the dashboard grid (04-widget-registry.md §6.1).
+ * M4 renders layouts read-only — the dnd-kit editing pipeline (applyMove,
+ * drag compaction, findFirstFit) is 04-T12/M7. What the static renderer
+ * needs: geometry constants, stacking order, and the deterministic
+ * top-gravity compaction used to normalize stored layouts before render.
+ */
+import type { LayoutItem } from '../page-config/index.js';
+/** 12 fluid columns (04 §6.1). */
+export declare const GRID_COLUMNS = 12;
+/** Heights persist in half-row units of 40 px (annex row unit ≈ 80 px). */
+export declare const ROW_UNIT_PX = 40;
+/** Grid gap (04 §6.1). */
+export declare const GRID_GAP_PX = 16;
+/**
+ * Reading order for breakpoint stacking: below `lg` the grid reflows to a
+ * single column ordered by `(y, x)` (04 §6.1) — the renderer sorts the DOM
+ * so source order matches.
+ */
+export declare function sortByPosition(items: readonly LayoutItem[]): LayoutItem[];
+/**
+ * Deterministic top-gravity compaction (04 §6.2): every item floats up
+ * until it hits another placed item or row 0. Idempotent; never produces
+ * overlaps or negative coordinates. Stored layouts normalize through this
+ * before render so gaps left by removed/failed widgets close up.
+ */
+export declare function compactVertical(items: readonly LayoutItem[]): LayoutItem[];
+//# sourceMappingURL=layout-math.d.ts.map

package/dist/grid/layout-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-math.d.ts","sourceRoot":"","sources":["../../src/grid/layout-math.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,kCAAkC;AAClC,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,2EAA2E;AAC3E,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,0BAA0B;AAC1B,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,CAEzE;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,CAY1E"}

package/dist/grid/layout-math.js

@@ -0,0 +1,45 @@
+/**
+ * Static layout math for the dashboard grid (04-widget-registry.md §6.1).
+ * M4 renders layouts read-only — the dnd-kit editing pipeline (applyMove,
+ * drag compaction, findFirstFit) is 04-T12/M7. What the static renderer
+ * needs: geometry constants, stacking order, and the deterministic
+ * top-gravity compaction used to normalize stored layouts before render.
+ */
+/** 12 fluid columns (04 §6.1). */
+export const GRID_COLUMNS = 12;
+/** Heights persist in half-row units of 40 px (annex row unit ≈ 80 px). */
+export const ROW_UNIT_PX = 40;
+/** Grid gap (04 §6.1). */
+export const GRID_GAP_PX = 16;
+/**
+ * Reading order for breakpoint stacking: below `lg` the grid reflows to a
+ * single column ordered by `(y, x)` (04 §6.1) — the renderer sorts the DOM
+ * so source order matches.
+ */
+export function sortByPosition(items) {
+    return [...items].sort((a, b) => (a.y === b.y ? a.x - b.x : a.y - b.y));
+}
+function overlaps(a, b) {
+    return a.x < b.x + b.w && b.x < a.x + a.w && a.y < b.y + b.h && b.y < a.y + a.h;
+}
+/**
+ * Deterministic top-gravity compaction (04 §6.2): every item floats up
+ * until it hits another placed item or row 0. Idempotent; never produces
+ * overlaps or negative coordinates. Stored layouts normalize through this
+ * before render so gaps left by removed/failed widgets close up.
+ */
+export function compactVertical(items) {
+    const placed = [];
+    for (const item of sortByPosition(items)) {
+        let candidate = { ...item, y: Math.max(0, item.y) };
+        while (candidate.y > 0) {
+            const above = { ...candidate, y: candidate.y - 1 };
+            if (placed.some((other) => overlaps(above, other)))
+                break;
+            candidate = above;
+        }
+        placed.push(candidate);
+    }
+    return placed;
+}
+//# sourceMappingURL=layout-math.js.map

package/dist/grid/layout-math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-math.js","sourceRoot":"","sources":["../../src/grid/layout-math.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,kCAAkC;AAClC,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,2EAA2E;AAC3E,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC9B,0BAA0B;AAC1B,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAE9B;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAA4B;IACzD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,QAAQ,CAAC,CAAa,EAAE,CAAa;IAC5C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAA4B;IAC1D,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,IAAI,SAAS,GAAe,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,KAAK,GAAe,EAAE,GAAG,SAAS,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/D,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAAE,MAAM;YAC1D,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/grid/layout-schema.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Grid-track layout schema surface (04-widget-registry.md §6.1).
+ *
+ * The canonical `layoutItemSchema` / `pageLayoutSchema` Zod definitions live in
+ * the pure-Zod leaf `../page-config/layout.ts` — that module is import-frozen
+ * to `zod` only so `@adminium/engine/config` and the server can consume the
+ * schema without pulling React, dnd-kit, or node builtins (leaf-purity.test.ts).
+ * The grid cannot be that source (it imports React + dnd-kit), so re-exporting
+ * the leaf here keeps ONE canonical schema while giving the grid track — and the
+ * layout-persistence track (04-T13), which references it — a stable
+ * `grid/layout-schema` import point per the wave brief. There is deliberately no
+ * second Zod definition to drift from.
+ */
+export { layoutItemSchema, pageLayoutSchema, type LayoutItem, type PageLayout, } from '../page-config/layout.js';
+/** Max stored height in 40 px half-units (04 §6.1 — `h: z…max(24)`). */
+export declare const MAX_H = 24;
+/**
+ * The subset of a widget's registry `sizing` the grid enforces on drag/resize:
+ * a widget can never be resized below `minW × minH` (04 §6.1). The grid takes
+ * this as an injected resolver (`getSizing`) rather than importing the registry,
+ * so the grid stays free of widget component code / family chunks (04 §2.3).
+ */
+export interface MinSize {
+    /** Minimum width in 12-col grid units. */
+    minW: number;
+    /** Minimum height in 40 px half-units. */
+    minH: number;
+}
+/** Fallback when the host supplies no per-widget `getSizing` resolver. */
+export declare const DEFAULT_MIN_SIZE: MinSize;
+//# sourceMappingURL=layout-schema.d.ts.map

package/dist/grid/layout-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-schema.d.ts","sourceRoot":"","sources":["../../src/grid/layout-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,0BAA0B,CAAC;AAElC,wEAAwE;AACxE,eAAO,MAAM,KAAK,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,EAAE,OAA8B,CAAC"}

package/dist/grid/layout-schema.js

@@ -0,0 +1,19 @@
+/**
+ * Grid-track layout schema surface (04-widget-registry.md §6.1).
+ *
+ * The canonical `layoutItemSchema` / `pageLayoutSchema` Zod definitions live in
+ * the pure-Zod leaf `../page-config/layout.ts` — that module is import-frozen
+ * to `zod` only so `@adminium/engine/config` and the server can consume the
+ * schema without pulling React, dnd-kit, or node builtins (leaf-purity.test.ts).
+ * The grid cannot be that source (it imports React + dnd-kit), so re-exporting
+ * the leaf here keeps ONE canonical schema while giving the grid track — and the
+ * layout-persistence track (04-T13), which references it — a stable
+ * `grid/layout-schema` import point per the wave brief. There is deliberately no
+ * second Zod definition to drift from.
+ */
+export { layoutItemSchema, pageLayoutSchema, } from '../page-config/layout.js';
+/** Max stored height in 40 px half-units (04 §6.1 — `h: z…max(24)`). */
+export const MAX_H = 24;
+/** Fallback when the host supplies no per-widget `getSizing` resolver. */
+export const DEFAULT_MIN_SIZE = { minW: 1, minH: 1 };
+//# sourceMappingURL=layout-schema.js.map

package/dist/grid/layout-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-schema.js","sourceRoot":"","sources":["../../src/grid/layout-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GAGjB,MAAM,0BAA0B,CAAC;AAElC,wEAAwE;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;AAexB,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAY,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @adminium/widgets — Widget registry, WidgetFrame/WidgetHost, page templates,
+ * dashboard grid (workplan/04-widget-registry.md).
+ *
+ * NOTE: the pure-Zod page-config leaf (data shapes, query descriptor, layout
+ * schema) is NOT re-exported here — import it from
+ * `@adminium/widgets/page-config` so `@adminium/engine/config` and the server
+ * can consume it without pulling React/component code (01-architecture.md
+ * §6.1; enforced by dep-cruiser + test/leaf-purity.test.ts).
+ */
+export declare const PACKAGE_NAME = "@adminium/widgets";
+export { WIDGET_FAMILIES, defineWidget, type WidgetCapabilities, type WidgetDefinition, type WidgetEvent, type WidgetFamily, type WidgetPlacement, type WidgetProps, type WidgetSizing, type WidgetSkeleton, } from './registry/types.js';
+export { widgetSharedConfigSchema, type WidgetSharedConfig } from './registry/shared-config.js';
+export { DuplicateWidgetIdError, WidgetNotFoundError, assertWidget, buildRegistry, getWidget, logConfigWarnings, validateConfigAgainst, validateInstanceConfig, widgetRegistry, widgetsByFamily, type ConfigWarning, type ParsedConfig, } from './registry/index.js';
+export { WIDGET_MISSING_ID, widgetMissingConfigSchema, widgetMissingDefinition, } from './registry/widget-missing.js';
+export { DEFAULT_WIDGET_RUNTIME_ENV, MAP_WIDGET_PREFIX, OFFLINE_MAP_FALLBACK_ID, offlineAssetsRequired, resolveOfflineWidgetId, type WidgetRuntime, type WidgetRuntimeEnv, } from './registry/offline.js';
+export { isEmptyByShape, isEmptyData } from './registry/data-empty.js';
+export { DuplicatePageTemplateIdError, PAGE_DASHBOARD_TEMPLATE_ID, buildPageTemplateRegistry, getPageTemplate, pageTemplateDefinitions, pageTemplateRegistry, type PageTemplateDefinition, } from './registry/page-templates.js';
+export { LLM_ALLOWED_PAGE_TEMPLATES, LLM_ALLOWED_SEMANTICS, LLM_ALLOWED_TEMPLATES, LLM_ALLOWED_WIDGETS, type LlmSemanticTone, } from './registry/llm-allowlist.js';
+export { computeDelta, formatMetricValue, formatOptionsOf, type DeltaInfo, type DeltaMode, type MetricFormat, type MetricFormatOptions, } from './lib/format.js';
+export { asCategorical, asMetricDelta, asSingleMetric, asTimeseries, timeseriesValues, type CategoricalData, type CategoricalItemData, type MetricDeltaData, type SingleMetricData, type TimeseriesData, type TsPointData, } from './lib/shapes.js';
+export { DashboardGrid, type DashboardGridProps, type RenderItemContext } from './grid/DashboardGrid.js';
+export { GRID_COLUMNS, GRID_GAP_PX, ROW_UNIT_PX, compactVertical, sortByPosition, } from './grid/layout-math.js';
+export { DEFAULT_MIN_SIZE, MAX_H, type MinSize, } from './grid/layout-schema.js';
+export { applyMove, applyResize, clampItem, commitDraft, findFirstFit, moveAndCompact, pointerDeltaToCells, resizeAndCompact, snapPxToCells, type CellStep, type LayoutDraft, } from './grid/layout-edit.js';
+export { GridDragHandle, GridResizeHandle, defaultGridAnnouncements, defaultGridEditLabels, snapToGridModifier, useGridItemEdit, type GridAnnouncements, type GridEditLabels, type GridEditLabelsInput, type GridItemEditControls, } from './grid/grid-edit.js';
+export { PageDashboard, type PageDashboardProps } from './templates/page-dashboard/PageDashboard.js';
+export { useDashboardData, type DashboardDataAdapter, type DashboardDataStates, type WidgetQueryRequest, } from './templates/page-dashboard/data-adapter.js';
+export { demoDashboardLayout } from './templates/page-dashboard/demo-layout.js';
+export { WidgetFrame, type WidgetFrameEmptyContent, type WidgetFrameProps, type WidgetFrameState, } from './frame/WidgetFrame.js';
+export { SkeletonSilhouette, type SkeletonSilhouetteProps } from './frame/SkeletonSilhouette.js';
+export { WidgetErrorBoundary, type WidgetErrorBoundaryProps } from './frame/WidgetErrorBoundary.js';
+export { WidgetHost, type WidgetDataState, type WidgetHostProps } from './frame/WidgetHost.js';
+export { WidgetRuntimeProvider, useWidgetRuntimeEnv, useResolvedWidgetId, type WidgetRuntimeProviderProps, } from './frame/WidgetRuntimeContext.js';
+export { ChartDirectionBridge, type ChartDirectionBridgeProps } from './frame/ChartDirectionBridge.js';
+export * from './families/tables/index.js';
+export { ApiKeysPanelView, type ApiKeysPanelViewProps } from './families/domain/ApiKeysPanel.js';
+export { CodeSnippetBlockView, type CodeSnippetBlockViewProps } from './families/domain/OpsApi.js';
+export type { ApiKeyRecord } from './families/domain/domain-ops-types.js';
+export * from './templates/page-crud/index.js';
+export * from './templates/page-board/index.js';
+export * from './templates/page-calendar/index.js';
+export * from './templates/page-scheduler/index.js';
+export * from './templates/page-directory/index.js';
+export * from './templates/page-master-detail/index.js';
+export * from './templates/page-queue-inbox/index.js';
+export * from './templates/page-log-viewer/index.js';
+export * from './templates/page-files/index.js';
+export * from './templates/page-chat/index.js';
+export * from './templates/page-builder/index.js';
+export { isBlockId } from './families/domain/block-lib.js';
+export * from './templates/page-wizard/index.js';
+export * from './templates/page-settings/index.js';
+export { ColumnMappingTableWidget, ValidationIssuesListWidget, mappingRowsOf, issuesOf, type ColumnMappingTableConfig, type MappingRow, type ValidationIssue, type ValidationIssuesListConfig, } from './families/forms/index.js';
+export { columnMappingTableConfigSchema, validationIssuesListConfigSchema, } from './families/forms/forms-config.js';
+export { SKIP_TARGET } from './families/forms/forms-builders.js';
+export { UploadDropzone, type UploadDropzoneProps } from './families/media/UploadDropzone.js';
+export { ScheduledJobsList, type ScheduledJobsListProps } from './families/calendar/ScheduledJobsList.js';
+export type { ScheduledJob } from './families/calendar/calendar-types.js';
+export { ConnectionStringField, TableInclusionChecklist, type ConnectionStringFieldProps, type TableInclusionChecklistProps, } from './families/forms/index.js';
+export { DSN_ENGINES, DSN_PROVIDER_CHIPS, dsnHost, dsnPlaceholder, dsnValidationCode, dsnWithEngine, engineForDsn, providerChipsFor, type DsnEngine, type DsnProviderChip, type DsnValidationCode, } from './families/forms/forms-dsn.js';
+export { HIGH_VOLUME_ROWS, defaultIncludedIds, inclusionCounts, isHighVolume, type InclusionTable, } from './families/forms/forms-tables.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,104 @@
+/**
+ * @adminium/widgets — Widget registry, WidgetFrame/WidgetHost, page templates,
+ * dashboard grid (workplan/04-widget-registry.md).
+ *
+ * NOTE: the pure-Zod page-config leaf (data shapes, query descriptor, layout
+ * schema) is NOT re-exported here — import it from
+ * `@adminium/widgets/page-config` so `@adminium/engine/config` and the server
+ * can consume it without pulling React/component code (01-architecture.md
+ * §6.1; enforced by dep-cruiser + test/leaf-purity.test.ts).
+ */
+export const PACKAGE_NAME = '@adminium/widgets';
+// Registry — types + shared config
+export { WIDGET_FAMILIES, defineWidget, } from './registry/types.js';
+export { widgetSharedConfigSchema } from './registry/shared-config.js';
+// Registry — map + lookup + config validation
+export { DuplicateWidgetIdError, WidgetNotFoundError, assertWidget, buildRegistry, getWidget, logConfigWarnings, validateConfigAgainst, validateInstanceConfig, widgetRegistry, widgetsByFamily, } from './registry/index.js';
+export { WIDGET_MISSING_ID, widgetMissingConfigSchema, widgetMissingDefinition, } from './registry/widget-missing.js';
+// Offline asset policy (11-electron.md §7): `map-*` → `map-choropleth-grid` when
+// the host app reports a desktop/offline runtime. WidgetHost applies it on every
+// mount; the host app supplies the env through `WidgetRuntimeProvider`.
+export { DEFAULT_WIDGET_RUNTIME_ENV, MAP_WIDGET_PREFIX, OFFLINE_MAP_FALLBACK_ID, offlineAssetsRequired, resolveOfflineWidgetId, } from './registry/offline.js';
+export { isEmptyByShape, isEmptyData } from './registry/data-empty.js';
+// Page-template registry — the source of truth the LLM allow-lists derive from
+export { DuplicatePageTemplateIdError, PAGE_DASHBOARD_TEMPLATE_ID, buildPageTemplateRegistry, getPageTemplate, pageTemplateDefinitions, pageTemplateRegistry, } from './registry/page-templates.js';
+// LLM allow-lists (06-llm-assist.md §4.4/§5) — closed vocabularies the
+// enrichment prompt injects; derived from the registries above so they cannot
+// drift from what the runtime can render.
+export { LLM_ALLOWED_PAGE_TEMPLATES, LLM_ALLOWED_SEMANTICS, LLM_ALLOWED_TEMPLATES, LLM_ALLOWED_WIDGETS, } from './registry/llm-allowlist.js';
+// Formatting + payload narrowing shared by widget components
+export { computeDelta, formatMetricValue, formatOptionsOf, } from './lib/format.js';
+export { asCategorical, asMetricDelta, asSingleMetric, asTimeseries, timeseriesValues, } from './lib/shapes.js';
+// Dashboard grid (04 §6): static renderer + geometry (M4), edit mode 04-T12
+export { DashboardGrid } from './grid/DashboardGrid.js';
+export { GRID_COLUMNS, GRID_GAP_PX, ROW_UNIT_PX, compactVertical, sortByPosition, } from './grid/layout-math.js';
+export { DEFAULT_MIN_SIZE, MAX_H, } from './grid/layout-schema.js';
+export { applyMove, applyResize, clampItem, commitDraft, findFirstFit, moveAndCompact, pointerDeltaToCells, resizeAndCompact, snapPxToCells, } from './grid/layout-edit.js';
+export { GridDragHandle, GridResizeHandle, defaultGridAnnouncements, defaultGridEditLabels, snapToGridModifier, useGridItemEdit, } from './grid/grid-edit.js';
+// Templates — page-dashboard (04 §10, 09 §7.2)
+export { PageDashboard } from './templates/page-dashboard/PageDashboard.js';
+export { useDashboardData, } from './templates/page-dashboard/data-adapter.js';
+export { demoDashboardLayout } from './templates/page-dashboard/demo-layout.js';
+// Frame — universal widget chrome + states
+export { WidgetFrame, } from './frame/WidgetFrame.js';
+export { SkeletonSilhouette } from './frame/SkeletonSilhouette.js';
+export { WidgetErrorBoundary } from './frame/WidgetErrorBoundary.js';
+export { WidgetHost } from './frame/WidgetHost.js';
+export { WidgetRuntimeProvider, useWidgetRuntimeEnv, useResolvedWidgetId, } from './frame/WidgetRuntimeContext.js';
+export { ChartDirectionBridge } from './frame/ChartDirectionBridge.js';
+// Tables family — standalone components + column-spec vocabulary (M4-T03).
+// `tablesWidgetDefinitions` is registry metadata; component exports here are
+// for template/host composition (the registry still lazy-loads its own refs).
+export * from './families/tables/index.js';
+// Domain family — the annex §13 props-only VIEWS the Studio/platform surfaces
+// compose. Exported by NAME (not `export *`) because this is a deliberate
+// cross-package contract, not the family's whole surface — same rule as the
+// forms family below. `ApiKeysPanelView` backs the M10-T06 API Keys page and
+// `CodeSnippetBlockView` its quick-start snippet: the *-Widget halves stay
+// registry-only (they bind to generated-app tables; the platform page drives
+// the view from `/api/v1/api-keys` instead).
+export { ApiKeysPanelView } from './families/domain/ApiKeysPanel.js';
+export { CodeSnippetBlockView } from './families/domain/OpsApi.js';
+// Page templates — page-crud (09 §7.1): template component + CrudApi contract.
+export * from './templates/page-crud/index.js';
+// Page templates — planning archetypes (09 §7.5/§7.6): board, calendar, scheduler.
+export * from './templates/page-board/index.js';
+export * from './templates/page-calendar/index.js';
+export * from './templates/page-scheduler/index.js';
+// Page templates — the M7 people/queues archetypes (09 §7.3/§7.4/§7.7).
+export * from './templates/page-directory/index.js';
+export * from './templates/page-master-detail/index.js';
+export * from './templates/page-queue-inbox/index.js';
+// Page templates — page-log-viewer / page-files / page-chat (09 §7.8/§7.9).
+export * from './templates/page-log-viewer/index.js';
+export * from './templates/page-files/index.js';
+export * from './templates/page-chat/index.js';
+// Page templates — page-builder (09 §7.11): renderer + doc algebra. `isBlockId`
+// rides along for the email-templates editor's block ⇄ doc mapping (the block
+// vocabulary is already public via BLOCK_IDS on this template's index).
+export * from './templates/page-builder/index.js';
+export { isBlockId } from './families/domain/block-lib.js';
+// Page templates — page-wizard (M7-T07, 09 §11.1): the stepped-flow shell the
+// Import Wizard binding mounts, plus the family widgets its steps and the
+// Data Exports page compose. Named exports, same cross-package-contract rule
+// as the forms block below.
+export * from './templates/page-wizard/index.js';
+// Page templates — page-settings (M7 T6, comp: Notification Settings): the
+// event × channel preference matrix with per-cell autosave.
+export * from './templates/page-settings/index.js';
+export { ColumnMappingTableWidget, ValidationIssuesListWidget, mappingRowsOf, issuesOf, } from './families/forms/index.js';
+export { columnMappingTableConfigSchema, validationIssuesListConfigSchema, } from './families/forms/forms-config.js';
+export { SKIP_TARGET } from './families/forms/forms-builders.js';
+export { UploadDropzone } from './families/media/UploadDropzone.js';
+export { ScheduledJobsList } from './families/calendar/ScheduledJobsList.js';
+// Forms family — the two §10 widgets the Studio connect wizard COMPOSES, plus
+// the pure rules behind them. Exported by NAME (not `export *`) because this is
+// a deliberate cross-package contract, not the family's whole surface: the
+// wizard used to carry its own copy of the DSN field and the table checklist,
+// and `@adminium/widgets` may never import `apps/*`, so the shared half lives
+// here and the wizard consumes it. See `families/forms/forms-dsn.ts` and
+// `families/forms/forms-tables.ts` for why the duplication had to end.
+export { ConnectionStringField, TableInclusionChecklist, } from './families/forms/index.js';
+export { DSN_ENGINES, DSN_PROVIDER_CHIPS, dsnHost, dsnPlaceholder, dsnValidationCode, dsnWithEngine, engineForDsn, providerChipsFor, } from './families/forms/forms-dsn.js';
+export { HIGH_VOLUME_ROWS, defaultIncludedIds, inclusionCounts, isHighVolume, } from './families/forms/forms-tables.js';
+//# sourceMappingURL=index.js.map