@grafloria/element 0.3.19 → 0.3.21

package/{src/libs/element → esm}/src/lib/dashboard-kit/dashboard.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * `dashboard({ views, widgets })` — the DATA-FIRST dashboard authoring API.
  *
@@ -43,15 +42,12 @@
  * Cells are the truth and live in the existing `GridItemConfig`, so save/load
  * round-trips with no extra work — same as every other kit.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDashboardHandle = createDashboardHandle;
-exports.dashboard = dashboard;
-const tslib_1 = require("tslib");
-const engine_1 = require("@grafloria/engine");
-const grid_binder_1 = require("./grid-binder");
-const grid_mapping_1 = require("./grid-mapping");
-const styles_1 = require("./styles");
-const widgets_1 = require("./widgets");
+import { __awaiter } from "tslib";
+import { AddToGroupCommand, BatchCommand, BringNodeToFrontCommand, Command, GroupModel, NodeModel, RemoveFromGroupCommand, RemoveNodeCommand, SendNodeToBackCommand, } from '@grafloria/engine';
+import { bindDashboardGrid, } from './grid-binder';
+import { gridItemFromCell } from './grid-mapping';
+import { ensureDashboardKitStyles } from './styles';
+import { defaultWidgetRenderer } from './widgets';
 /**
  * Add a widget node AND its board membership as ONE undoable step.
  *
@@ -63,7 +59,7 @@ const widgets_1 = require("./widgets");
  * would need two Ctrl-Z. This composite does both in its own execute(), and
  * unwinds both in undo().
  */
-class AddWidgetCommand extends engine_1.Command {
+class AddWidgetCommand extends Command {
     constructor(node, groupId) {
         super('Add widget');
         this.node = node;
@@ -101,7 +97,7 @@ let autoId = 0;
  *  spec build can never drift apart on metadata. */
 function buildWidgetNode(w, rowHeight) {
     var _a, _b, _c, _d, _e, _f;
-    const node = new engine_1.NodeModel({
+    const node = new NodeModel({
         id: w.id,
         type: 'widget',
         position: { x: 0, y: 0 },
@@ -162,7 +158,7 @@ function assignCells(widgets, columns) {
  * `dashboard()` and `fromDocument()`. Reads/writes the mutable `ctx.active` /
  * `ctx.apiRef` cells so the caller's finalize can wire the API in afterwards.
  */
-function createDashboardHandle(ctx) {
+export function createDashboardHandle(ctx) {
     const { views, groups, binders, specById, viewOfWidget } = ctx;
     const hostOf = (id) => ctx.hosts.get(id);
     const execCommand = (cmd) => {
@@ -258,7 +254,7 @@ function createDashboardHandle(ctx) {
             if (w.pinned)
                 node.setState({ locked: true });
             // ONE undoable step (see AddWidgetCommand for why this cannot be a batch).
-            execCommand(existing ? new engine_1.AddToGroupCommand(group.id, w.id) : new AddWidgetCommand(node, group.id));
+            execCommand(existing ? new AddToGroupCommand(group.id, w.id) : new AddWidgetCommand(node, group.id));
             (_d = binders.get(vid)) === null || _d === void 0 ? void 0 : _d.sync();
             (_e = ctx.apiRef) === null || _e === void 0 ? void 0 : _e.renderNow();
             return makeWidgetHandle(w.id);
@@ -365,13 +361,13 @@ function createDashboardHandle(ctx) {
                 return ((_b = (_a = node()) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 : _b.locked) === true;
             },
             resize(span, rows) {
-                return tslib_1.__awaiter(this, void 0, void 0, function* () {
+                return __awaiter(this, void 0, void 0, function* () {
                     var _a, _b;
                     return (_b = (yield ((_a = binder()) === null || _a === void 0 ? void 0 : _a.resizeTo(id, span, rows)))) !== null && _b !== void 0 ? _b : false;
                 });
             },
             moveTo(x, y) {
-                return tslib_1.__awaiter(this, void 0, void 0, function* () {
+                return __awaiter(this, void 0, void 0, function* () {
                     var _a, _b;
                     return (_b = (yield ((_a = binder()) === null || _a === void 0 ? void 0 : _a.moveTo(id, x, y)))) !== null && _b !== void 0 ? _b : false;
                 });
@@ -390,12 +386,12 @@ function createDashboardHandle(ctx) {
             },
             bringToFront() {
                 var _a;
-                execCommand(new engine_1.BringNodeToFrontCommand(id));
+                execCommand(new BringNodeToFrontCommand(id));
                 (_a = ctx.apiRef) === null || _a === void 0 ? void 0 : _a.renderNow();
             },
             sendToBack() {
                 var _a;
-                execCommand(new engine_1.SendNodeToBackCommand(id));
+                execCommand(new SendNodeToBackCommand(id));
                 (_a = ctx.apiRef) === null || _a === void 0 ? void 0 : _a.renderNow();
             },
             update(patch) {
@@ -422,8 +418,8 @@ function createDashboardHandle(ctx) {
                 // gone from the engine, so planRemoval() would return [] and the
                 // survivors' cells would never commit.
                 const survivors = (_a = displaced) !== null && _a !== void 0 ? _a : b.planRemoval(id);
-                const cmds = [...survivors, new engine_1.RemoveFromGroupCommand(group.id, id), new engine_1.RemoveNodeCommand(id)];
-                void execCommand(new engine_1.BatchCommand('Remove widget', cmds));
+                const cmds = [...survivors, new RemoveFromGroupCommand(group.id, id), new RemoveNodeCommand(id)];
+                void execCommand(new BatchCommand('Remove widget', cmds));
                 const v = views.find((x) => x.id === viewId);
                 if (v)
                     v.widgets = v.widgets.filter((w) => w.id !== id);
@@ -443,9 +439,9 @@ function createDashboardHandle(ctx) {
     }
     return handle;
 }
-function dashboard(options) {
+export function dashboard(options) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
-    (0, styles_1.ensureDashboardKitStyles)();
+    ensureDashboardKitStyles();
     const columns = (_a = options.columns) !== null && _a !== void 0 ? _a : DEFAULTS.columns;
     const gap = (_b = options.gap) !== null && _b !== void 0 ? _b : DEFAULTS.gap;
     const rowHeight = (_c = options.rowHeight) !== null && _c !== void 0 ? _c : DEFAULTS.rowHeight;
@@ -477,7 +473,7 @@ function dashboard(options) {
     // No renderWidget → the built-in renderers draw the declared `kind` from the
     // developer's own `data` (widgets.ts), unknown kinds landing on the titled
     // frame they always did.
-    const renderWidget = (_k = options.renderWidget) !== null && _k !== void 0 ? _k : widgets_1.defaultWidgetRenderer;
+    const renderWidget = (_k = options.renderWidget) !== null && _k !== void 0 ? _k : defaultWidgetRenderer;
     // -- runtime: ONE shared handle over a boxed context -----------------------
     // The two MUTABLE cells the handle used to close over as free `let`s —
     // `active` (showView reassigns it) and `apiRef` (finalize sets it) — are boxed
@@ -527,7 +523,7 @@ function dashboard(options) {
             for (const v of views) {
                 // One board per view; the group is a pure LAYOUT CONTAINER, so its
                 // chrome is suppressed (frameChrome) exactly as a dashboard needs.
-                const g = new engine_1.GroupModel({ id: v.id, name: (_a = v.name) !== null && _a !== void 0 ? _a : v.id });
+                const g = new GroupModel({ id: v.id, name: (_a = v.name) !== null && _a !== void 0 ? _a : v.id });
                 model.addGroup(g);
                 g.setMetadata('frameChrome', 'none');
                 // THE BOARD'S GEOMETRY, PERSISTED. Cells alone do not describe a board:
@@ -561,7 +557,7 @@ function dashboard(options) {
                     // and made toJSON() → dashboard() NOT round-trip (a saved layout
                     // rebuilt back into its declaration order rather than its cells).
                     if (w.x !== undefined && w.y !== undefined) {
-                        n.setGridItem((0, grid_mapping_1.gridItemFromCell)({ x: w.x, y: w.y, w: (_j = w.span) !== null && _j !== void 0 ? _j : 3, h: (_k = w.rows) !== null && _k !== void 0 ? _k : 1 }));
+                        n.setGridItem(gridItemFromCell({ x: w.x, y: w.y, w: (_j = w.span) !== null && _j !== void 0 ? _j : 3, h: (_k = w.rows) !== null && _k !== void 0 ? _k : 1 }));
                     }
                     if (w.pinned)
                         n.setState({ locked: true });
@@ -577,7 +573,7 @@ function dashboard(options) {
                         n.removePort(p.id);
                     g.addMember(w.id);
                 }
-                binders.set(v.id, (0, grid_binder_1.bindDashboardGrid)(a, g, Object.assign(Object.assign(Object.assign({ columns: (_l = v.columns) !== null && _l !== void 0 ? _l : columns, gap, padding: gap, sizing: (_m = options.sizing) !== null && _m !== void 0 ? _m : 'fit', baseRowHeight: rowHeight, designHeight: (_o = v.height) !== null && _o !== void 0 ? _o : boardH, float: (_p = options.float) !== null && _p !== void 0 ? _p : false, rtl: (_q = options.rtl) !== null && _q !== void 0 ? _q : false }, (options.responsive ? { responsive: options.responsive } : {})), ((_r = options.binder) !== null && _r !== void 0 ? _r : {})), { onGesture: (e) => {
+                binders.set(v.id, bindDashboardGrid(a, g, Object.assign(Object.assign(Object.assign({ columns: (_l = v.columns) !== null && _l !== void 0 ? _l : columns, gap, padding: gap, sizing: (_m = options.sizing) !== null && _m !== void 0 ? _m : 'fit', baseRowHeight: rowHeight, designHeight: (_o = v.height) !== null && _o !== void 0 ? _o : boardH, float: (_p = options.float) !== null && _p !== void 0 ? _p : false, rtl: (_q = options.rtl) !== null && _q !== void 0 ? _q : false }, (options.responsive ? { responsive: options.responsive } : {})), ((_r = options.binder) !== null && _r !== void 0 ? _r : {})), { onGesture: (e) => {
                         var _a, _b;
                         if (e.type === 'commit' && options.onLayoutChange) {
                             const snapshot = handle.toJSON().views.find((x) => x.id === v.id);

package/{src/libs/element → esm}/src/lib/dashboard-kit/grid-binder.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * `bindDashboardGrid(api, group, options)` — the dashboard-grid gesture binder
  * (Phase 2 of the dashboard-grid plan; the plan page's Section-1 prototype is
@@ -50,13 +49,11 @@
  * carry no GridItemConfig); their INNER layout is their own concern — bind a
  * second `bindDashboardGrid` on the section for a nested pack grid.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.bindDashboardGrid = bindDashboardGrid;
-const tslib_1 = require("tslib");
-const engine_1 = require("@grafloria/engine");
-const renderer_1 = require("@grafloria/renderer");
-const grid_mapping_1 = require("./grid-mapping");
-const styles_1 = require("./styles");
+import { __awaiter } from "tslib";
+import { AddToGroupCommand, BatchCommand, Command, GridPackEngine, RemoveFromGroupCommand, } from '@grafloria/engine';
+import { registerTool } from '@grafloria/renderer';
+import { buildCommitCommands, cellFromGridItem, cellToRect, columnUnitFor, gridItemFromCell, pointToCell, rowHeightFor, sizeToSpan, } from './grid-mapping';
+import { ensureDashboardKitStyles } from './styles';
 const BOARD_REGISTRY = new Map();
 /**
  * Undoable cell+frame write for a GROUP member (the strip's slab). The engine
@@ -64,7 +61,7 @@ const BOARD_REGISTRY = new Map();
  * cells live in group metadata — this closes nested height escalation into
  * the gesture's single BatchCommand so one undo restores the strip too.
  */
-class SetGroupCellCommand extends engine_1.Command {
+class SetGroupCellCommand extends Command {
     constructor(groupId, cellBefore, cellAfter, frameBefore, frameAfter) {
         super('Resize section');
         this.groupId = groupId;
@@ -78,7 +75,7 @@ class SetGroupCellCommand extends engine_1.Command {
         const grp = diagram === null || diagram === void 0 ? void 0 : diagram.getGroup(this.groupId);
         if (!grp)
             return;
-        grp.setMetadata('gridItem', (0, grid_mapping_1.gridItemFromCell)(cell));
+        grp.setMetadata('gridItem', gridItemFromCell(cell));
         grp.setFrame(Object.assign({}, frame));
     }
     execute(context) {
@@ -105,9 +102,9 @@ class SetGroupCellCommand extends engine_1.Command {
 const DRAG_THRESHOLD = 4;
 const GLIDE_OFF_DELAY = 400;
 let binderSeq = 0;
-function bindDashboardGrid(api, group, options = {}) {
+export function bindDashboardGrid(api, group, options = {}) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
-    (0, styles_1.ensureDashboardKitStyles)();
+    ensureDashboardKitStyles();
     const diagram = api.getModel();
     /** The DECLARED count — the board's authored width, and the responsive cap. */
     const maxColumns = (_a = options.columns) !== null && _a !== void 0 ? _a : 12;
@@ -127,7 +124,7 @@ function bindDashboardGrid(api, group, options = {}) {
     const wantHandles = options.resizeHandles !== false;
     const designH = (_k = (_h = options.designHeight) !== null && _h !== void 0 ? _h : (_j = group.size) === null || _j === void 0 ? void 0 : _j.height) !== null && _k !== void 0 ? _k : 0;
     let sizing = (_l = options.sizing) !== null && _l !== void 0 ? _l : 'fit';
-    let engine = new engine_1.GridPackEngine([], { columns, float, maxRows });
+    let engine = new GridPackEngine([], { columns, float, maxRows });
     let gesture = null;
     let disposed = false;
     /** Reentrancy guard: our own derived frame writes must not re-project. */
@@ -180,7 +177,7 @@ function bindDashboardGrid(api, group, options = {}) {
             const spanMeta = Number((_a = node.getMetadata) === null || _a === void 0 ? void 0 : _a.call(node, 'columnSpan')) || 0;
             const rowsMeta = Number((_b = node.getMetadata) === null || _b === void 0 ? void 0 : _b.call(node, 'rowSpan')) || 0;
             const locked = ((_c = node.state) === null || _c === void 0 ? void 0 : _c.locked) === true;
-            const cell = (0, grid_mapping_1.cellFromGridItem)((_d = node.getGridItem) === null || _d === void 0 ? void 0 : _d.call(node), {
+            const cell = cellFromGridItem((_d = node.getGridItem) === null || _d === void 0 ? void 0 : _d.call(node), {
                 w: spanMeta || 1,
                 h: rowsMeta || 1,
             });
@@ -192,8 +189,8 @@ function bindDashboardGrid(api, group, options = {}) {
                 // First adoption from pixels: where the tile already sits. The SPAN is
                 // resolved first because the mirrored (RTL) mapping needs it to turn a
                 // left edge into a cell.
-                const s = (0, grid_mapping_1.sizeToSpan)(node.size.width, node.size.height, f, g, rows());
-                const p = (0, grid_mapping_1.pointToCell)(node.position.x, node.position.y, f, g, rows(), spanMeta || s.w);
+                const s = sizeToSpan(node.size.width, node.size.height, f, g, rows());
+                const p = pointToCell(node.position.x, node.position.y, f, g, rows(), spanMeta || s.w);
                 return {
                     id,
                     x: Math.max(0, p.x),
@@ -207,7 +204,7 @@ function bindDashboardGrid(api, group, options = {}) {
         }
         const grp = diagram.getGroup(id);
         const cell = grp
-            ? (0, grid_mapping_1.cellFromGridItem)((_e = grp.getMetadata) === null || _e === void 0 ? void 0 : _e.call(grp, 'gridItem'))
+            ? cellFromGridItem((_e = grp.getMetadata) === null || _e === void 0 ? void 0 : _e.call(grp, 'gridItem'))
             : null;
         // Member groups are LOCKED slabs (see the module doc).
         if (cell)
@@ -220,13 +217,13 @@ function bindDashboardGrid(api, group, options = {}) {
         const cell = { x: item.x, y: item.y, w: item.w, h: item.h };
         const node = diagram.getNode(id);
         if (node) {
-            if (!(0, grid_mapping_1.cellFromGridItem)((_a = node.getGridItem) === null || _a === void 0 ? void 0 : _a.call(node)))
-                node.setGridItem((0, grid_mapping_1.gridItemFromCell)(cell));
+            if (!cellFromGridItem((_a = node.getGridItem) === null || _a === void 0 ? void 0 : _a.call(node)))
+                node.setGridItem(gridItemFromCell(cell));
             return;
         }
         const grp = diagram.getGroup(id);
-        if (grp && !(0, grid_mapping_1.cellFromGridItem)((_b = grp.getMetadata) === null || _b === void 0 ? void 0 : _b.call(grp, 'gridItem'))) {
-            grp.setMetadata('gridItem', (0, grid_mapping_1.gridItemFromCell)(cell));
+        if (grp && !cellFromGridItem((_b = grp.getMetadata) === null || _b === void 0 ? void 0 : _b.call(grp, 'gridItem'))) {
+            grp.setMetadata('gridItem', gridItemFromCell(cell));
         }
     };
     // -- projection: cells -> pixels -------------------------------------------
@@ -290,7 +287,7 @@ function bindDashboardGrid(api, group, options = {}) {
                     continue; // the ghost
                 if (item.id === adoptedGhostId)
                     continue; // a ghost adopted from another binder
-                writeRect(item.id, (0, grid_mapping_1.cellToRect)(item, f, g, r));
+                writeRect(item.id, cellToRect(item, f, g, r));
             }
         }
         finally {
@@ -320,7 +317,7 @@ function bindDashboardGrid(api, group, options = {}) {
             placeholder.className = 'axdb-ph';
             layer.prepend(placeholder);
         }
-        const r = (0, grid_mapping_1.cellToRect)(item, frame(), geom(), rows());
+        const r = cellToRect(item, frame(), geom(), rows());
         placeholder.style.display = 'block';
         placeholder.style.left = `${r.x}px`;
         placeholder.style.top = `${r.y}px`;
@@ -430,7 +427,7 @@ function bindDashboardGrid(api, group, options = {}) {
     const execute = (name, commands) => {
         if (commands.length === 0)
             return false;
-        void api.getEngine().commandManager.execute(new engine_1.BatchCommand(name, commands));
+        void api.getEngine().commandManager.execute(new BatchCommand(name, commands));
         return true;
     };
     // -- membership + bounds sync ----------------------------------------------
@@ -519,10 +516,10 @@ function bindDashboardGrid(api, group, options = {}) {
                     const cell = { x: item.x, y: item.y, w: item.w, h: item.h };
                     const node = diagram.getNode(item.id);
                     if (node) {
-                        node.setGridItem((0, grid_mapping_1.gridItemFromCell)(cell));
+                        node.setGridItem(gridItemFromCell(cell));
                         continue;
                     }
-                    (_a = diagram.getGroup(item.id)) === null || _a === void 0 ? void 0 : _a.setMetadata('gridItem', (0, grid_mapping_1.gridItemFromCell)(cell));
+                    (_a = diagram.getGroup(item.id)) === null || _a === void 0 ? void 0 : _a.setMetadata('gridItem', gridItemFromCell(cell));
                 }
             });
         }
@@ -562,7 +559,7 @@ function bindDashboardGrid(api, group, options = {}) {
     const boardVisualHeight = () => {
         const f = frame();
         const g = geom();
-        return Math.max(f.height, 2 * padding + rows() * ((0, grid_mapping_1.rowHeightFor)(g, rows()) + gap) - gap);
+        return Math.max(f.height, 2 * padding + rows() * (rowHeightFor(g, rows()) + gap) - gap);
     };
     const worldInsideBoard = (x, y) => {
         const f = frame();
@@ -576,7 +573,7 @@ function bindDashboardGrid(api, group, options = {}) {
         if (worldInsideBoardExtended(x, y))
             return true;
         const f = frame();
-        const band = (0, grid_mapping_1.rowHeightFor)(geom(), rows()) + gap;
+        const band = rowHeightFor(geom(), rows()) + gap;
         return (x >= f.x - EDGE_GRACE &&
             x <= f.x + f.width + EDGE_GRACE &&
             y >= f.y - EDGE_GRACE &&
@@ -587,7 +584,7 @@ function bindDashboardGrid(api, group, options = {}) {
         if (worldInsideBoard(x, y))
             return true;
         const f = frame();
-        const band = (0, grid_mapping_1.rowHeightFor)(geom(), rows()) + gap;
+        const band = rowHeightFor(geom(), rows()) + gap;
         return x >= f.x && x <= f.x + f.width && y >= f.y && y <= f.y + boardVisualHeight() + band;
     };
     const insideMemberGroupFrame = (x, y) => {
@@ -693,7 +690,7 @@ function bindDashboardGrid(api, group, options = {}) {
         gesture = null;
         project();
         const deltas = deltasSince(g.startCells, g.startGeom);
-        const commands = (0, grid_mapping_1.buildCommitCommands)(deltas);
+        const commands = buildCommitCommands(deltas);
         if (g.esc && g.esc.rowsAdded !== 0) {
             commands.push(new SetGroupCellCommand(group.id, g.esc.cellBefore, g.esc.cellAfter, g.esc.frameBefore, g.esc.frameAfter));
         }
@@ -726,7 +723,7 @@ function bindDashboardGrid(api, group, options = {}) {
                     const lockedNode = ((_b = (_a = diagram.getNode(id)) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 : _b.locked) === true;
                     items.push(Object.assign(Object.assign({ id }, c), { locked: lockedNode || isGroupMember(id) }));
                 }
-                engine = new engine_1.GridPackEngine(items, { columns, float, maxRows });
+                engine = new GridPackEngine(items, { columns, float, maxRows });
             }
             else {
                 engine.cancelGesture();
@@ -774,8 +771,8 @@ function bindDashboardGrid(api, group, options = {}) {
     const centredTopLeft = (worldX, worldY, spans) => {
         const f = frame();
         const g = geom();
-        const cu = (0, grid_mapping_1.columnUnitFor)(g, f.width);
-        const rh = (0, grid_mapping_1.rowHeightFor)(g, rows());
+        const cu = columnUnitFor(g, f.width);
+        const rh = rowHeightFor(g, rows());
         return {
             x: worldX - (spans.w * (cu + gap) - gap) / 2,
             y: worldY - (spans.h * (rh + gap) - gap) / 2,
@@ -857,7 +854,7 @@ function bindDashboardGrid(api, group, options = {}) {
                 if (g.removedFromBoard) {
                     g.removedFromBoard = false;
                     (_c = hostOf(g.id)) === null || _c === void 0 ? void 0 : _c.classList.remove('axdb-out');
-                    const cell = (0, grid_mapping_1.pointToCell)(desired.x, desired.y, frame(), geom(), rows(), g.spans.w);
+                    const cell = pointToCell(desired.x, desired.y, frame(), geom(), rows(), g.spans.w);
                     // Re-enter at the bottom edge (collision-free), then take the cursor
                     // cell GATELESSLY — a first placement skips the anti-jitter gate.
                     engine.add({ id: g.id, x: 0, y: engine.rows(), w: g.spans.w, h: g.spans.h });
@@ -866,7 +863,7 @@ function bindDashboardGrid(api, group, options = {}) {
                 }
                 else {
                     const spanW = (_e = (_d = engine.getItem(g.id)) === null || _d === void 0 ? void 0 : _d.w) !== null && _e !== void 0 ? _e : g.spans.w;
-                    const cell = (0, grid_mapping_1.pointToCell)(desired.x, desired.y, frame(), geom(), rows(), spanW);
+                    const cell = pointToCell(desired.x, desired.y, frame(), geom(), rows(), spanW);
                     if (engine.moveCheck(g.id, cell.x, cell.y).changed)
                         project();
                 }
@@ -898,7 +895,7 @@ function bindDashboardGrid(api, group, options = {}) {
         const dh = ev.world.y - g.downWorld.y;
         const f = frame();
         const gg = geom();
-        const minW = Math.max(8, (0, grid_mapping_1.columnUnitFor)(gg, f.width));
+        const minW = Math.max(8, columnUnitFor(gg, f.width));
         let w = Math.max(minW, g.startSize.width + dw);
         // The height min-clamp is applied AFTER the escalation logic below: on a
         // grown strip "one current row" IS the whole strip, and clamping the
@@ -957,11 +954,11 @@ function bindDashboardGrid(api, group, options = {}) {
         // (Escalation above may have just grown OR shrunk the board — re-read.)
         const fNow = frame();
         const ggNow = geom();
-        h = Math.max(Math.max(8, (0, grid_mapping_1.rowHeightFor)(ggNow, rows())), h);
+        h = Math.max(Math.max(8, rowHeightFor(ggNow, rows())), h);
         const itemNow = engine.getItem(g.id);
         if (itemNow) {
-            const cuNow = (0, grid_mapping_1.columnUnitFor)(ggNow, fNow.width);
-            const rhNow = (0, grid_mapping_1.rowHeightFor)(ggNow, rows());
+            const cuNow = columnUnitFor(ggNow, fNow.width);
+            const rhNow = rowHeightFor(ggNow, rows());
             w = Math.min(w, (columns - itemNow.x) * (cuNow + gap) - gap);
             if (maxRows !== undefined) {
                 h = Math.min(h, Math.max(1, maxRows - itemNow.y) * (rhNow + gap) - gap);
@@ -982,7 +979,7 @@ function bindDashboardGrid(api, group, options = {}) {
         }
         const spanF = maxRows !== undefined ? frame() : f;
         const spanG = maxRows !== undefined ? geom() : gg;
-        const span = (0, grid_mapping_1.sizeToSpan)(w, h, spanF, spanG, rows());
+        const span = sizeToSpan(w, h, spanF, spanG, rows());
         if (engine.resizeCheck(g.id, span.w, span.h).changed)
             project();
         syncPlaceholder();
@@ -1016,14 +1013,14 @@ function bindDashboardGrid(api, group, options = {}) {
             finally {
                 writing = false;
             }
-            const sourceDisplaced = (0, grid_mapping_1.buildCommitCommands)(deltasSince(g.startCells, g.startGeom, g.id));
+            const sourceDisplaced = buildCommitCommands(deltasSince(g.startCells, g.startGeom, g.id));
             const before = g.startCells.get(g.id);
             const geomBefore = g.startGeom.get(g.id);
             const crossing = [
                 ...sourceDisplaced,
-                new engine_1.RemoveFromGroupCommand(group.id, g.id),
-                new engine_1.AddToGroupCommand(targetGroupId, g.id),
-                ...(0, grid_mapping_1.buildCommitCommands)([
+                new RemoveFromGroupCommand(group.id, g.id),
+                new AddToGroupCommand(targetGroupId, g.id),
+                ...buildCommitCommands([
                     {
                         id: g.id,
                         locked: false,
@@ -1068,7 +1065,7 @@ function bindDashboardGrid(api, group, options = {}) {
         }
         if (g.removedFromBoard && dragOut === 'remove') {
             // Release OUTSIDE the board → remove via the page's atomic command path.
-            const displaced = (0, grid_mapping_1.buildCommitCommands)(deltasSince(g.startCells, g.startGeom, g.id));
+            const displaced = buildCommitCommands(deltasSince(g.startCells, g.startGeom, g.id));
             const snap = g.startGeom.get(g.id);
             if (snap) {
                 // Park the node on its start rect so the page's RemoveNodeCommand
@@ -1127,7 +1124,7 @@ function bindDashboardGrid(api, group, options = {}) {
             return null;
         const f = frame();
         const gg = geom();
-        const span = (0, grid_mapping_1.sizeToSpan)(pxSize.width, pxSize.height, f, gg, rows());
+        const span = sizeToSpan(pxSize.width, pxSize.height, f, gg, rows());
         // Clamp to the TARGET board's shape: a tall tile entering a one-row strip
         // arrives as a strip-height tile, not a refusal.
         span.w = Math.max(1, Math.min(columns, span.w));
@@ -1157,7 +1154,7 @@ function bindDashboardGrid(api, group, options = {}) {
         }
         adoptedGhostId = node.id;
         const tl = centredTopLeft(world.x, world.y, span);
-        const cell0 = (0, grid_mapping_1.pointToCell)(tl.x, tl.y, f, gg, rows(), span.w);
+        const cell0 = pointToCell(tl.x, tl.y, f, gg, rows(), span.w);
         engine.moveCheck(node.id, cell0.x, cell0.y, { gate: false });
         armGlide();
         project();
@@ -1169,7 +1166,7 @@ function bindDashboardGrid(api, group, options = {}) {
                 if (!item)
                     return;
                 const tlm = centredTopLeft(w.x, w.y, { w: item.w, h: item.h });
-                const cell = (0, grid_mapping_1.pointToCell)(tlm.x, tlm.y, frame(), geom(), rows(), item.w);
+                const cell = pointToCell(tlm.x, tlm.y, frame(), geom(), rows(), item.w);
                 if (engine.moveCheck(node.id, cell.x, cell.y).changed)
                     project();
                 syncPlaceholder();
@@ -1191,8 +1188,8 @@ function bindDashboardGrid(api, group, options = {}) {
                     return null;
                 }
                 const cell = { x: item.x, y: item.y, w: item.w, h: item.h };
-                const rect = (0, grid_mapping_1.cellToRect)(item, frame(), geom(), rows());
-                const commands = (0, grid_mapping_1.buildCommitCommands)(deltasSince(startCells, startGeom, node.id));
+                const rect = cellToRect(item, frame(), geom(), rows());
+                const commands = buildCommitCommands(deltasSince(startCells, startGeom, node.id));
                 engine.endGesture();
                 adoptedGhostId = null;
                 disarmGlideSoon();
@@ -1305,7 +1302,7 @@ function bindDashboardGrid(api, group, options = {}) {
             cancelActiveGesture();
         },
     };
-    const unregisterTool = (0, renderer_1.registerTool)(tool);
+    const unregisterTool = registerTool(tool);
     // -- palette drag-in --------------------------------------------------------
     const beginPaletteDrag = (node, spec, event) => {
         var _a, _b;
@@ -1370,7 +1367,7 @@ function bindDashboardGrid(api, group, options = {}) {
             const inside = worldInsideBoard(world.x, world.y);
             if (inside) {
                 const tl = centredTopLeft(world.x, world.y, g.spans);
-                const cell = (0, grid_mapping_1.pointToCell)(tl.x, tl.y, frame(), geom(), rows(), g.spans.w);
+                const cell = pointToCell(tl.x, tl.y, frame(), geom(), rows(), g.spans.w);
                 if (g.removedFromBoard) {
                     g.removedFromBoard = false;
                     // Enter at the bottom edge (collision-free), then take the cursor
@@ -1406,8 +1403,8 @@ function bindDashboardGrid(api, group, options = {}) {
             if (commit && !g.removedFromBoard && engine.getItem(g.id)) {
                 const item = engine.getItem(g.id);
                 const cell = { x: item.x, y: item.y, w: item.w, h: item.h };
-                node.setGridItem((0, grid_mapping_1.gridItemFromCell)(cell));
-                const displaced = (0, grid_mapping_1.buildCommitCommands)(deltasSince(g.startCells, g.startGeom, g.id));
+                node.setGridItem(gridItemFromCell(cell));
+                const displaced = buildCommitCommands(deltasSince(g.startCells, g.startGeom, g.id));
                 engine.endGesture();
                 cleanupGestureVisuals(g);
                 gesture = null;
@@ -1435,7 +1432,7 @@ function bindDashboardGrid(api, group, options = {}) {
         group.on('bounds:changed', (() => onBoundsChanged())),
     ];
     /** Run one programmatic gesture through the same snapshot→op→commit pipeline. */
-    const programmatic = (name, id, op) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+    const programmatic = (name, id, op) => __awaiter(this, void 0, void 0, function* () {
         if (disposed || gesture || !engine.getItem(id))
             return false;
         engine.beginGesture();
@@ -1450,17 +1447,17 @@ function bindDashboardGrid(api, group, options = {}) {
         try {
             const it = engine.getItem(id);
             if (it)
-                writeRect(id, (0, grid_mapping_1.cellToRect)(it, frame(), geom(), rows()));
+                writeRect(id, cellToRect(it, frame(), geom(), rows()));
         }
         finally {
             writing = false;
         }
-        const commands = (0, grid_mapping_1.buildCommitCommands)(deltasSince(snap.cells, snap.geoms));
+        const commands = buildCommitCommands(deltasSince(snap.cells, snap.geoms));
         engine.endGesture();
         disarmGlideSoon();
         enforceBoardHeight();
         if (commands.length > 0) {
-            yield api.getEngine().commandManager.execute(new engine_1.BatchCommand(name, commands));
+            yield api.getEngine().commandManager.execute(new BatchCommand(name, commands));
         }
         api.renderNow();
         return true;
@@ -1483,7 +1480,7 @@ function bindDashboardGrid(api, group, options = {}) {
             // would silently lose its wide layouts the first time anything else
             // happened, and growing back would re-derive instead of restoring.
             const carried = engine.getLayouts();
-            engine = new engine_1.GridPackEngine(items, { columns, float, maxRows });
+            engine = new GridPackEngine(items, { columns, float, maxRows });
             engine.setLayouts(carried);
             for (const item of engine.getItems())
                 persistAdoptedCell(item.id, item);
@@ -1550,8 +1547,8 @@ function bindDashboardGrid(api, group, options = {}) {
                 padding,
                 sizing,
                 rows: r,
-                rowHeight: (0, grid_mapping_1.rowHeightFor)(g, r),
-                columnUnit: (0, grid_mapping_1.columnUnitFor)(g, f.width),
+                rowHeight: rowHeightFor(g, r),
+                columnUnit: columnUnitFor(g, f.width),
                 boardHeight: f.height,
                 frame: f,
             };
@@ -1562,13 +1559,13 @@ function bindDashboardGrid(api, group, options = {}) {
         },
         cellRectOf(id) {
             const it = engine.getItem(id);
-            return it ? (0, grid_mapping_1.cellToRect)(it, frame(), geom(), rows()) : undefined;
+            return it ? cellToRect(it, frame(), geom(), rows()) : undefined;
         },
         planRemoval(id) {
             const it = engine.getItem(id);
             if (!it)
                 return [];
-            const clone = new engine_1.GridPackEngine(engine.getItems().map((i) => (Object.assign({}, i))), { columns, float });
+            const clone = new GridPackEngine(engine.getItems().map((i) => (Object.assign({}, i))), { columns, float });
             clone.remove(id);
             const f = frame();
             const g = geom();
@@ -1579,7 +1576,7 @@ function bindDashboardGrid(api, group, options = {}) {
                 const e = memberEntity(item.id);
                 if (!before || !e)
                     continue;
-                const target = (0, grid_mapping_1.cellToRect)(item, f, g, rAfter);
+                const target = cellToRect(item, f, g, rAfter);
                 deltas.push({
                     id: item.id,
                     locked: !!item.locked,
@@ -1592,7 +1589,7 @@ function bindDashboardGrid(api, group, options = {}) {
                     sizeAfter: { width: target.width, height: target.height },
                 });
             }
-            return (0, grid_mapping_1.buildCommitCommands)(deltas);
+            return buildCommitCommands(deltas);
         },
         moveTo(id, x, y) {
             return programmatic('Move widget', id, () => engine.moveCheck(id, x, y).changed);