@grafloria/element 0.3.19 → 0.3.20

package/src/lib/dashboard-kit/grid-mapping.js.map

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

package/src/lib/dashboard-kit/grid-mapping.spec.ts

@@ -1,308 +0,0 @@
-/**
- * Dashboard-kit pure math — the acceptance suite for the binder's DOM-free
- * parts: cell↔pixel mapping in BOTH sizing modes, the GridItemConfig↔cell
- * round-trip, and gesture commit-batch construction.
- *
- * The numbers are the demo page's real geometry (TAB_W 1180 × TAB_H 660,
- * gap/padding 14, 12 columns) so a failure reads against the exact board the
- * user drives.
- *
- * MUTATION-PROVEN asserts (each mutant applied, run, seen red, reverted):
- *   K1  rowHeightFor's fit formula: dropping the `(rows-1)*gap` term
- *       (`(design - 2*padding) / rows`) → 'fit derives the exact overview row
- *       height' fails (121.0 ≠ 115.2) and the round-trip test fails.
- *   K2  buildCommitCommands' MoveNodeCommand old-position capture: passing
- *       `d.posAfter` as oldPosition → 'move command records the exact inverse'
- *       fails (serialized oldPosition equals the new one).
- */
-import { MoveNodeCommand, ResizeNodeCommand, SetGridItemCommand } from '@grafloria/engine';
-import {
-  boardHeightFor,
-  buildCommitCommands,
-  cellFromGridItem,
-  cellToRect,
-  columnUnitFor,
-  gridItemFromCell,
-  pointToCell,
-  rowHeightFor,
-  sizeToSpan,
-  type DashboardGridGeometry,
-  type TileDelta,
-  type WorldRect,
-} from './grid-mapping';
-
-const FRAME: WorldRect = { x: 0, y: 0, width: 1180, height: 660 };
-
-const geom = (overrides: Partial<DashboardGridGeometry> = {}): DashboardGridGeometry => ({
-  columns: 12,
-  gap: 14,
-  padding: 14,
-  sizing: 'fit',
-  baseRowHeight: 130,
-  minRowHeight: 28,
-  designHeight: 660,
-  ...overrides,
-});
-
-describe('dashboard-kit mapping — row height and board height', () => {
-  it('fit derives the exact overview row height (5 rows in a 660 board)', () => {
-    // 660 = 2*14 + 5*rowH + 4*14  →  rowH = (660 - 28 - 56) / 5 = 115.2   (K1)
-    expect(rowHeightFor(geom(), 5)).toBeCloseTo(115.2, 5);
-  });
-
-  it('fit squeezes as rows grow, and stops at the minRowHeight floor', () => {
-    const g = geom();
-    expect(rowHeightFor(g, 6)).toBeLessThan(rowHeightFor(g, 5));
-    expect(rowHeightFor(g, 500)).toBe(g.minRowHeight);
-  });
-
-  it('grow keeps the base row height regardless of rows', () => {
-    const g = geom({ sizing: 'grow' });
-    expect(rowHeightFor(g, 1)).toBe(130);
-    expect(rowHeightFor(g, 50)).toBe(130);
-  });
-
-  it('fit board height IS the design height; grow extends but never shrinks below it', () => {
-    expect(boardHeightFor(geom(), 12)).toBe(660);
-    const g = geom({ sizing: 'grow' });
-    // 5 rows at 130: 2*14 + 5*130 + 4*14 = 734 > 660 → grows.
-    expect(boardHeightFor(g, 5)).toBe(734);
-    // 3 rows at 130: 2*14 + 3*130 + 2*14 = 446 < 660 → design height holds.
-    expect(boardHeightFor(g, 3)).toBe(660);
-  });
-});
-
-describe('dashboard-kit mapping — cell ↔ pixel round-trip (both modes)', () => {
-  const cases: Array<{ mode: 'fit' | 'grow'; rows: number }> = [
-    { mode: 'fit', rows: 5 },
-    { mode: 'fit', rows: 3 },
-    { mode: 'grow', rows: 5 },
-    { mode: 'grow', rows: 8 },
-  ];
-
-  it.each(cases)('cellToRect → pointToCell/sizeToSpan is the identity ($mode, $rows rows)', ({ mode, rows }) => {
-    const g = geom({ sizing: mode });
-    for (const cell of [
-      { x: 0, y: 0, w: 3, h: 1 },
-      { x: 8, y: 1, w: 4, h: 2 },
-      { x: 0, y: 3, w: 12, h: 2 },
-      { x: 5, y: 2, w: 1, h: 1 },
-    ]) {
-      const r = cellToRect(cell, FRAME, g, rows);
-      expect(pointToCell(r.x, r.y, FRAME, g, rows)).toEqual({ x: cell.x, y: cell.y });
-      expect(sizeToSpan(r.width, r.height, FRAME, g, rows)).toEqual({ w: cell.w, h: cell.h });
-    }
-  });
-
-  it('projects the demo line chart (span 8 of 12) to the flex-identical width', () => {
-    // colUnit = (1180 - 28 - 154) / 12 = 83.1666…; span8 = 8*cu + 7*14
-    const g = geom();
-    expect(columnUnitFor(g, FRAME.width)).toBeCloseTo(83.1667, 3);
-    const r = cellToRect({ x: 0, y: 1, w: 8, h: 2 }, FRAME, g, 5);
-    expect(r.width).toBeCloseTo(8 * 83.16667 + 7 * 14, 2);
-    expect(r.x).toBeCloseTo(14, 5);
-    // y = padding + 1 * (rowH + gap) = 14 + 129.2
-    expect(r.y).toBeCloseTo(14 + 115.2 + 14, 3);
-  });
-
-  it('midpoint rounding: a tile dragged just under half a pitch stays; past it, crosses', () => {
-    const g = geom();
-    const r = cellToRect({ x: 3, y: 0, w: 3, h: 1 }, FRAME, g, 5);
-    const pitch = columnUnitFor(g, FRAME.width) + g.gap;
-    expect(pointToCell(r.x + pitch * 0.49, r.y, FRAME, g, 5).x).toBe(3);
-    expect(pointToCell(r.x + pitch * 0.51, r.y, FRAME, g, 5).x).toBe(4);
-  });
-
-  it('projection is frame-relative: a parked board (x = -20000) projects off-canvas', () => {
-    const parked: WorldRect = { ...FRAME, x: -20000 };
-    const r = cellToRect({ x: 0, y: 0, w: 3, h: 1 }, parked, geom(), 5);
-    expect(r.x).toBe(-20000 + 14);
-  });
-});
-
-// ===========================================================================
-// RTL — the model is direction-agnostic; ONLY this mapping mirrors.
-//
-// Every assert below is written as a comparison between the SAME cells mapped
-// LTR and RTL, so what is being proved is the mirror relationship itself
-// rather than a pile of hand-computed pixels.
-// ===========================================================================
-describe('dashboard-kit mapping — RTL mirrors pixels, never cells', () => {
-  const CELLS = [
-    { x: 0, y: 0, w: 3, h: 1 },
-    { x: 8, y: 1, w: 4, h: 2 },
-    { x: 0, y: 3, w: 12, h: 2 },
-    { x: 5, y: 2, w: 1, h: 1 },
-  ];
-
-  it('cell x=0 renders at the RIGHT edge, and the whole row mirrors', () => {
-    const ltr = geom();
-    const rtl = geom({ rtl: true });
-    const a = cellToRect({ x: 0, y: 0, w: 3, h: 1 }, FRAME, rtl, 5);
-    // Its RIGHT edge sits one padding in from the board's right edge…
-    expect(a.x + a.width).toBeCloseTo(FRAME.x + FRAME.width - 14, 5);
-    // …which is the exact mirror of where LTR puts its LEFT edge.
-    const aL = cellToRect({ x: 0, y: 0, w: 3, h: 1 }, FRAME, ltr, 5);
-    expect(aL.x).toBeCloseTo(14, 5);
-    // The last column mirrors to the left edge.
-    const z = cellToRect({ x: 9, y: 0, w: 3, h: 1 }, FRAME, rtl, 5);
-    expect(z.x).toBeCloseTo(14, 5);
-  });
-
-  it('is an exact mirror of LTR for every cell: same size, mirrored x, same y', () => {
-    const ltr = geom();
-    const rtl = geom({ rtl: true });
-    for (const cell of CELLS) {
-      const l = cellToRect(cell, FRAME, ltr, 5);
-      const r = cellToRect(cell, FRAME, rtl, 5);
-      expect(r.width).toBeCloseTo(l.width, 6);
-      expect(r.height).toBeCloseTo(l.height, 6);
-      expect(r.y).toBeCloseTo(l.y, 6); // rows are direction-agnostic
-      // mirror identity: distance-from-right in RTL == distance-from-left in LTR
-      const fromRight = FRAME.x + FRAME.width - (r.x + r.width);
-      const fromLeft = l.x - FRAME.x;
-      expect(fromRight).toBeCloseTo(fromLeft, 6);
-    }
-  });
-
-  it('cellToRect → pointToCell is the identity in RTL too (the drag contract)', () => {
-    const g = geom({ rtl: true });
-    for (const cell of CELLS) {
-      const r = cellToRect(cell, FRAME, g, 5);
-      // The span MUST be passed: mirrored, the leading edge is the right one.
-      expect(pointToCell(r.x, r.y, FRAME, g, 5, cell.w)).toEqual({ x: cell.x, y: cell.y });
-      // Spans themselves never mirror.
-      expect(sizeToSpan(r.width, r.height, FRAME, g, 5)).toEqual({ w: cell.w, h: cell.h });
-    }
-  });
-
-  it('midpoint rounding mirrors: dragging LEFT in RTL advances the cell', () => {
-    const g = geom({ rtl: true });
-    const cell = { x: 3, y: 0, w: 3, h: 1 };
-    const r = cellToRect(cell, FRAME, g, 5);
-    const pitch = columnUnitFor(g, FRAME.width) + g.gap;
-    // A nudge leftwards past half a pitch moves to the NEXT cell (x+1), because
-    // cells advance leftwards; the same nudge rightwards goes back to x-1.
-    expect(pointToCell(r.x - pitch * 0.51, r.y, FRAME, g, 5, cell.w).x).toBe(4);
-    expect(pointToCell(r.x - pitch * 0.49, r.y, FRAME, g, 5, cell.w).x).toBe(3);
-    expect(pointToCell(r.x + pitch * 0.51, r.y, FRAME, g, 5, cell.w).x).toBe(2);
-  });
-
-  it('LTR is untouched by the new span argument (every old call site is safe)', () => {
-    const g = geom();
-    const r = cellToRect({ x: 4, y: 1, w: 5, h: 1 }, FRAME, g, 5);
-    expect(pointToCell(r.x, r.y, FRAME, g, 5)).toEqual({ x: 4, y: 1 });
-    expect(pointToCell(r.x, r.y, FRAME, g, 5, 5)).toEqual({ x: 4, y: 1 });
-    expect(pointToCell(r.x, r.y, FRAME, g, 5, 99)).toEqual({ x: 4, y: 1 });
-  });
-
-  it('rows, row heights and board heights are identical in both directions', () => {
-    const ltr = geom();
-    const rtl = geom({ rtl: true });
-    expect(rowHeightFor(rtl, 5)).toBe(rowHeightFor(ltr, 5));
-    expect(boardHeightFor(rtl, 5)).toBe(boardHeightFor(ltr, 5));
-    expect(columnUnitFor(rtl, FRAME.width)).toBe(columnUnitFor(ltr, FRAME.width));
-  });
-});
-
-describe('dashboard-kit mapping — GridItemConfig ↔ cells', () => {
-  it('round-trips cells through the persisted 1-based line numbers', () => {
-    const cell = { x: 8, y: 1, w: 4, h: 2 };
-    const gi = gridItemFromCell(cell);
-    expect(gi).toEqual({ columnStart: 9, columnEnd: 13, rowStart: 2, rowEnd: 4 });
-    expect(cellFromGridItem(gi)).toEqual(cell);
-  });
-
-  it("ignores 'auto' placements and missing configs", () => {
-    expect(cellFromGridItem(undefined)).toBeNull();
-    expect(cellFromGridItem({ columnStart: 'auto', rowStart: 1 })).toBeNull();
-    expect(cellFromGridItem({ columnStart: 1 })).toBeNull(); // no rowStart
-  });
-
-  it('fills missing end lines from the adoption fallback (metadata columnSpan)', () => {
-    expect(cellFromGridItem({ columnStart: 3, rowStart: 2 }, { w: 6, h: 2 })).toEqual({
-      x: 2,
-      y: 1,
-      w: 6,
-      h: 2,
-    });
-  });
-});
-
-describe('dashboard-kit mapping — commit-batch construction', () => {
-  const delta = (over: Partial<TileDelta>): TileDelta => ({
-    id: 'a',
-    cellBefore: { x: 0, y: 0, w: 3, h: 1 },
-    cellAfter: { x: 0, y: 0, w: 3, h: 1 },
-    posBefore: { x: 14, y: 14 },
-    posAfter: { x: 14, y: 14 },
-    sizeBefore: { width: 100, height: 100 },
-    sizeAfter: { width: 100, height: 100 },
-    ...over,
-  });
-
-  it('emits NOTHING for an unchanged tile', () => {
-    expect(buildCommitCommands([delta({})])).toHaveLength(0);
-  });
-
-  it('cells changed → SetGridItemCommand carrying the AFTER cells', () => {
-    const cmds = buildCommitCommands([
-      delta({ cellAfter: { x: 3, y: 0, w: 3, h: 1 }, posAfter: { x: 300, y: 14 } }),
-    ]);
-    const set = cmds.find((c) => c instanceof SetGridItemCommand);
-    expect(set).toBeDefined();
-    expect(set!.serialize().data).toMatchObject({
-      nodeId: 'a',
-      gridConfig: { columnStart: 4, columnEnd: 7, rowStart: 1, rowEnd: 2 },
-    });
-  });
-
-  it('move command records the exact inverse (old position ≠ new)', () => {
-    const cmds = buildCommitCommands([delta({ posAfter: { x: 300, y: 140 } })]);
-    expect(cmds).toHaveLength(1);
-    const move = cmds[0] as MoveNodeCommand;
-    expect(move).toBeInstanceOf(MoveNodeCommand);
-    const data = move.serialize().data as {
-      newPosition: { x: number; y: number };
-      oldPosition: { x: number; y: number };
-    };
-    expect(data.newPosition).toEqual({ x: 300, y: 140 });
-    expect(data.oldPosition).toEqual({ x: 14, y: 14 }); // (K2)
-  });
-
-  it('size changed → ResizeNodeCommand; locked and group tiles get no geometry commands', () => {
-    const cmds = buildCommitCommands([
-      delta({ sizeAfter: { width: 200, height: 240 } }),
-      delta({ id: 'pinned', locked: true, posAfter: { x: 999, y: 999 } }),
-      delta({
-        id: 'slab',
-        isGroup: true,
-        posAfter: { x: 999, y: 999 },
-        cellAfter: { x: 0, y: 5, w: 12, h: 1 },
-      }),
-    ]);
-    expect(cmds.filter((c) => c instanceof ResizeNodeCommand)).toHaveLength(1);
-    expect(cmds.filter((c) => c instanceof MoveNodeCommand)).toHaveLength(0);
-    expect(cmds.filter((c) => c instanceof SetGridItemCommand)).toHaveLength(0);
-  });
-
-  it('one gesture, many tiles → one flat command list covering every change', () => {
-    const cmds = buildCommitCommands([
-      delta({
-        cellAfter: { x: 3, y: 0, w: 3, h: 1 },
-        posAfter: { x: 300, y: 14 },
-      }),
-      delta({
-        id: 'b',
-        cellBefore: { x: 3, y: 0, w: 3, h: 1 },
-        cellAfter: { x: 0, y: 0, w: 3, h: 1 },
-        posBefore: { x: 300, y: 14 },
-        posAfter: { x: 14, y: 14 },
-      }),
-    ]);
-    // 2× SetGridItem + 2× Move — the whole swap in one undoable batch.
-    expect(cmds).toHaveLength(4);
-    expect(cmds.filter((c) => c instanceof SetGridItemCommand)).toHaveLength(2);
-    expect(cmds.filter((c) => c instanceof MoveNodeCommand)).toHaveLength(2);
-  });
-});

package/src/lib/dashboard-kit/grid-mapping.ts

@@ -1,283 +0,0 @@
-/**
- * Dashboard-kit pure math — Phase 2 of the dashboard-grid plan
- * (`documentation/api-architecture/dashboard-grid-plan.html`).
- *
- * Everything here is DOM-free and instance-free so it can be table-driven from
- * a jest spec: the cell↔pixel mapping in both sizing modes, the
- * GridItemConfig↔GridPackItem round-trip, and the gesture commit-batch
- * construction. The stateful binder (`grid-binder.ts`) is a thin pointer loop
- * over these functions plus the engine's `GridPackEngine` — the engine owns
- * ALL cell math (push/swap/gate/settle); this module owns only how cells and
- * pixels convert into each other and into undoable commands.
- *
- * SIZING MODES (user decision, recorded in the plan's Section 6):
- *   'fit'  — DevExtreme-style compact. The board keeps its DESIGN height and
- *            the row height re-derives from the content's row count, so every
- *            widget always stays inside the frame — nothing can be pushed out
- *            of reach. Guarded by `minRowHeight` so a pathological row count
- *            squeezes to a floor instead of zero.
- *   'grow' — rows keep `baseRowHeight` and the board frame extends downward
- *            to hold them (never below the design height). Camera refit after
- *            growth is the page's concern (its existing `frameTab`).
- */
-
-import {
-  MoveNodeCommand,
-  ResizeNodeCommand,
-  SetGridItemCommand,
-  type Command,
-  type GridItemConfig,
-} from '@grafloria/engine';
-
-/** One tile in integer board cells — the shape `GridPackEngine` speaks. */
-export interface CellRect {
-  x: number;
-  y: number;
-  w: number;
-  h: number;
-}
-
-/** A world-space rectangle (the group frame, or a projected tile). */
-export interface WorldRect {
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-}
-
-export interface DashboardGridGeometry {
-  /** Column count of the board (default 12). */
-  columns: number;
-  /** Gap between cells, px. */
-  gap: number;
-  /** Padding between the board frame and the outermost cells, px. */
-  padding: number;
-  sizing: 'fit' | 'grow';
-  /** Row height in 'grow' mode, px. */
-  baseRowHeight: number;
-  /** Floor for the derived 'fit' row height, px. */
-  minRowHeight: number;
-  /** The board's design height — 'fit' keeps it, 'grow' never shrinks below it. */
-  designHeight: number;
-  /**
-   * RIGHT-TO-LEFT boards. The MODEL is direction-agnostic — cell x=0 is always
-   * "the first column" and every rule in `GridPackEngine` (push, swap, gravity,
-   * the anti-jitter gate) is written in cells, so none of it changes. ONLY this
-   * module's pixel mapping mirrors: x=0 renders at the board's RIGHT edge and
-   * columns run leftwards. A layout saved in one direction therefore renders
-   * mirrored in the other with byte-identical cells, which is the property the
-   * kit's spec and the e2e battery both assert.
-   */
-  rtl?: boolean;
-}
-
-/** Row height for a board currently `rows` rows tall (both modes). */
-export function rowHeightFor(g: DashboardGridGeometry, rows: number): number {
-  if (g.sizing === 'grow') return g.baseRowHeight;
-  const r = Math.max(1, rows);
-  // design = 2*padding + r*rowH + (r-1)*gap  →  solve for rowH.
-  return Math.max(g.minRowHeight, (g.designHeight - 2 * g.padding - (r - 1) * g.gap) / r);
-}
-
-/** The board frame height the mode implies for `rows` rows. */
-export function boardHeightFor(g: DashboardGridGeometry, rows: number): number {
-  if (g.sizing === 'fit') return g.designHeight;
-  const r = Math.max(0, rows);
-  const content = 2 * g.padding + (r === 0 ? 0 : r * g.baseRowHeight + (r - 1) * g.gap);
-  return Math.max(g.designHeight, content);
-}
-
-/** Width of one column cell for a board `width` px wide. */
-export function columnUnitFor(g: DashboardGridGeometry, width: number): number {
-  return (width - 2 * g.padding - (g.columns - 1) * g.gap) / g.columns;
-}
-
-/** Width in px of a `w`-column span (the pitch identity used by both mappings). */
-export function spanWidthPx(w: number, g: DashboardGridGeometry, frameWidth: number): number {
-  const cu = columnUnitFor(g, frameWidth);
-  return w * cu + (w - 1) * g.gap;
-}
-
-/**
- * Project integer cells into a world rectangle inside `frame`.
- *
- * RTL mirrors about the board's vertical centre line: the distance from the
- * board's RIGHT padding edge to the tile's RIGHT edge equals what the LTR
- * distance from the left padding edge to the tile's LEFT edge would be. Only
- * the x term changes — rows, heights and spans are direction-agnostic.
- */
-export function cellToRect(
-  cell: CellRect,
-  frame: WorldRect,
-  g: DashboardGridGeometry,
-  rows: number
-): WorldRect {
-  const cu = columnUnitFor(g, frame.width);
-  const rh = rowHeightFor(g, rows);
-  const width = cell.w * cu + (cell.w - 1) * g.gap;
-  return {
-    x: g.rtl
-      ? frame.x + frame.width - g.padding - cell.x * (cu + g.gap) - width
-      : frame.x + g.padding + cell.x * (cu + g.gap),
-    y: frame.y + g.padding + cell.y * (rh + g.gap),
-    width,
-    height: cell.h * rh + (cell.h - 1) * g.gap,
-  };
-}
-
-/**
- * The cell whose slot a tile TOP-LEFT at world (x, y) is closest to — the
- * prototype's margin-adjusted midpoint rounding (`round(L / cellPitch)`).
- * Clamping to the board is the ENGINE's job (moveCheck clamps), not ours.
- *
- * `spanW` is the tile's COLUMN SPAN and is used only when `g.rtl`: mirrored,
- * the cell is decided by the tile's RIGHT edge (its leading edge), so the
- * span is what converts the given left edge into it. LTR ignores it entirely,
- * which is why every existing call site keeps its exact behaviour. Getting
- * this wrong is the classic RTL drag bug — the tile lands a span away from
- * the placeholder — so the e2e battery asserts drop-on-placeholder in RTL.
- */
-export function pointToCell(
-  x: number,
-  y: number,
-  frame: WorldRect,
-  g: DashboardGridGeometry,
-  rows: number,
-  spanW = 1
-): { x: number; y: number } {
-  const cu = columnUnitFor(g, frame.width);
-  const rh = rowHeightFor(g, rows);
-  const right = x + spanWidthPx(spanW, g, frame.width);
-  return {
-    x: g.rtl
-      ? Math.round((frame.x + frame.width - g.padding - right) / (cu + g.gap))
-      : Math.round((x - frame.x - g.padding) / (cu + g.gap)),
-    y: Math.round((y - frame.y - g.padding) / (rh + g.gap)),
-  };
-}
-
-/**
- * The integer span a fluid pixel size rounds to — the prototype's
- * `round((W + margin) / cellPitch)`, floored at 1×1.
- */
-export function sizeToSpan(
-  widthPx: number,
-  heightPx: number,
-  frame: WorldRect,
-  g: DashboardGridGeometry,
-  rows: number
-): { w: number; h: number } {
-  const cu = columnUnitFor(g, frame.width);
-  const rh = rowHeightFor(g, rows);
-  return {
-    w: Math.max(1, Math.round((widthPx + g.gap) / (cu + g.gap))),
-    h: Math.max(1, Math.round((heightPx + g.gap) / (rh + g.gap))),
-  };
-}
-
-// ---------------------------------------------------------------------------
-// GridItemConfig ↔ engine cells.
-//
-// The cell state lives in the EXISTING GridItemConfig (1-based, exclusive-end
-// line numbers — CSS grid vocabulary): columnStart/rowStart are the cell + 1,
-// columnEnd/rowEnd are cell + span + 1. Nothing new is persisted; save/load
-// already round-trips gridItem.
-// ---------------------------------------------------------------------------
-
-/** Engine cells → the GridItemConfig that persists them. */
-export function gridItemFromCell(cell: CellRect): GridItemConfig {
-  return {
-    columnStart: cell.x + 1,
-    columnEnd: cell.x + cell.w + 1,
-    rowStart: cell.y + 1,
-    rowEnd: cell.y + cell.h + 1,
-  };
-}
-
-/**
- * GridItemConfig → engine cells, or null when the config carries no usable
- * placement (absent, or 'auto' lines). `fallback` fills spans a partial
- * config omits — the first-adoption path uses metadata `columnSpan` there.
- */
-export function cellFromGridItem(
-  gi: GridItemConfig | undefined,
-  fallback?: { w?: number; h?: number }
-): CellRect | null {
-  if (!gi) return null;
-  const num = (v: number | 'auto' | undefined): number | null =>
-    typeof v === 'number' && Number.isFinite(v) ? v : null;
-  const cs = num(gi.columnStart);
-  const rs = num(gi.rowStart);
-  if (cs === null || rs === null) return null;
-  const ce = num(gi.columnEnd);
-  const re = num(gi.rowEnd);
-  const w = ce !== null ? ce - cs : fallback?.w ?? 1;
-  const h = re !== null ? re - rs : fallback?.h ?? 1;
-  return { x: cs - 1, y: rs - 1, w: Math.max(1, w), h: Math.max(1, h) };
-}
-
-// ---------------------------------------------------------------------------
-// Commit-batch construction.
-//
-// A gesture ends in ONE BatchCommand reconciling gesture-start → final state:
-//   - SetGridItemCommand for every tile whose CELLS changed (cells are the
-//     truth — undo restores them, and a later sync re-derives pixels);
-//   - MoveNodeCommand / ResizeNodeCommand for every UNLOCKED node whose
-//     geometry changed, so a bare undo (no binder sync) still restores what
-//     the user sees. Locked tiles never get geometry commands: the model's
-//     authoritative lock refuses those writes — their pixels are DERIVED
-//     state the binder re-projects via runSystemWrite.
-//   - MoveNodeCommand opts OUT of merging: one command per completed gesture
-//     must stay one undo step; the manager's 500ms merge window would fold
-//     two quick drags of the same tile into one.
-// ---------------------------------------------------------------------------
-
-export interface TileDelta {
-  id: string;
-  locked?: boolean;
-  /** Group members (layout slabs) get cells-only commands — never Move/Resize. */
-  isGroup?: boolean;
-  cellBefore: CellRect;
-  cellAfter: CellRect;
-  posBefore: { x: number; y: number };
-  posAfter: { x: number; y: number };
-  sizeBefore: { width: number; height: number; depth?: number };
-  sizeAfter: { width: number; height: number; depth?: number };
-}
-
-const cellsDiffer = (a: CellRect, b: CellRect): boolean =>
-  a.x !== b.x || a.y !== b.y || a.w !== b.w || a.h !== b.h;
-
-const EPS = 0.5;
-
-export function buildCommitCommands(deltas: TileDelta[]): Command[] {
-  const commands: Command[] = [];
-  for (const d of deltas) {
-    const cellChanged = cellsDiffer(d.cellBefore, d.cellAfter);
-    if (cellChanged && !d.isGroup) {
-      commands.push(new SetGridItemCommand(d.id, gridItemFromCell(d.cellAfter)));
-    }
-    if (d.locked || d.isGroup) continue;
-    if (
-      Math.abs(d.posAfter.x - d.posBefore.x) > EPS ||
-      Math.abs(d.posAfter.y - d.posBefore.y) > EPS
-    ) {
-      commands.push(
-        new MoveNodeCommand(d.id, { ...d.posAfter }, { ...d.posBefore }, { mergeable: false })
-      );
-    }
-    if (
-      Math.abs(d.sizeAfter.width - d.sizeBefore.width) > EPS ||
-      Math.abs(d.sizeAfter.height - d.sizeBefore.height) > EPS
-    ) {
-      commands.push(
-        new ResizeNodeCommand(
-          d.id,
-          { depth: 0, ...d.sizeAfter },
-          { depth: 0, ...d.sizeBefore }
-        )
-      );
-    }
-  }
-  return commands;
-}

package/src/lib/dashboard-kit/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AAAA,6CAMuB;AALrB,gHAAA,iBAAiB,OAAA;AAMnB,+CAewB;AAdtB,4GAAA,YAAY,OAAA;AACZ,8GAAA,cAAc,OAAA;AACd,6GAAA,aAAa,OAAA;AACb,0GAAA,UAAU,OAAA;AACV,2GAAA,WAAW,OAAA;AACX,0GAAA,UAAU,OAAA;AACV,2GAAA,WAAW,OAAA;AACX,gHAAA,gBAAgB,OAAA;AAChB,gHAAA,gBAAgB,OAAA;AAChB,mHAAA,mBAAmB,OAAA;AAMrB,mCAA4E;AAAnE,kHAAA,wBAAwB,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AAEzD,sEAAsE;AACtE,yCASqB;AARnB,sGAAA,SAAS,OAAA;AAUX,6EAA6E;AAC7E,qCAiBmB;AAhBjB,gHAAA,qBAAqB,OAAA;AACrB,0GAAA,eAAe,OAAA;AACf,2GAAA,gBAAgB,OAAA;AAChB,0GAAA,eAAe,OAAA;AACf,4GAAA,iBAAiB,OAAA;AACjB,6GAAA,kBAAkB,OAAA;AAClB,4GAAA,iBAAiB,OAAA;AACjB,gHAAA,qBAAqB,OAAA"}

package/src/lib/dashboard-kit/index.ts

@@ -1,56 +0,0 @@
-export {
-  bindDashboardGrid,
-  type DashboardGridApi,
-  type DashboardGridOptions,
-  type DashboardGridHandle,
-  type DashboardResponsiveOptions,
-} from './grid-binder';
-export {
-  rowHeightFor,
-  boardHeightFor,
-  columnUnitFor,
-  cellToRect,
-  pointToCell,
-  sizeToSpan,
-  spanWidthPx,
-  gridItemFromCell,
-  cellFromGridItem,
-  buildCommitCommands,
-  type CellRect,
-  type WorldRect,
-  type DashboardGridGeometry,
-  type TileDelta,
-} from './grid-mapping';
-export { ensureDashboardKitStyles, DASHBOARD_KIT_STYLE_ID } from './styles';
-
-// The DATA-FIRST authoring API (the erDiagram/umlDiagram equivalent).
-export {
-  dashboard,
-  type DashboardOptions,
-  type DashboardSpec,
-  type DashboardSnapshot,
-  type DashboardHandle,
-  type DashboardViewSpec,
-  type DashboardWidgetSpec,
-  type WidgetHandle,
-} from './dashboard';
-
-// The built-in renderers behind `kind` — dashboard()'s default renderWidget.
-export {
-  defaultWidgetRenderer,
-  renderKpiWidget,
-  renderLineWidget,
-  renderBarWidget,
-  renderDonutWidget,
-  renderFunnelWidget,
-  renderTableWidget,
-  BUILT_IN_WIDGET_KINDS,
-  type WidgetRenderer,
-  type KpiWidgetData,
-  type LineWidgetData,
-  type LineSeries,
-  type BarWidgetData,
-  type DonutWidgetData,
-  type FunnelWidgetData,
-  type TableWidgetData,
-} from './widgets';

package/src/lib/dashboard-kit/styles.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"styles.js","sourceRoot":"","sources":["styles.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAkLH,4DAMC;AAtLY,QAAA,sBAAsB,GAAG,gCAAgC,CAAC;AAEvE,MAAM,GAAG,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2KX,CAAC;AAEF,wEAAwE;AACxE,SAAgB,wBAAwB,CAAC,MAAgB,QAAQ;IAC/D,IAAI,GAAG,CAAC,cAAc,CAAC,8BAAsB,CAAC;QAAE,OAAO;IACvD,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,GAAG,8BAAsB,CAAC;IAClC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC;IACxB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}