@freighttech/ui 0.13.18

package/dist/backend/dynamic-table/utils/anchoredPosition.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/utils/anchoredPosition.ts"],
+  "sourcesContent": ["/**\n * Placement maths for every portal-rendered dropdown in the grid.\n *\n * Extracted because three of them (`ColumnFilterPopover`, `SelectMenu`,\n * `PerspectiveTabMenu`) had each hand-rolled it, and two of the three got the\n * flip wrong in the same way:\n *\n *     top: flipAbove ? Math.max(8, rect.top - 4) : rect.bottom + 4\n *     ...\n *     transform: flipAbove ? 'translateY(-100%)' : undefined\n *\n * The `Math.max(8, \u2026)` reads like a clamp against the top edge, but the\n * `translateY(-100%)` is applied AFTERWARDS and shifts the panel up by its own\n * full height \u2014 so the clamp protects nothing. Measured on the real transport\n * list at a 560px-tall viewport, the column-filter popover landed at\n * `top: -156`, hiding its search box, \"Select all\" and first two options above\n * the top of the window. A filter you cannot search or select-all in.\n *\n * The fix is not a bigger clamp, it is capping the HEIGHT. `maxHeight` is\n * bounded by the space actually available on the chosen side, which makes\n * `translateY(-100%)` exact and safe: a panel that can never be taller than the\n * gap above the anchor can never be pushed past the top of the viewport. The\n * transform stays because it is self-measuring \u2014 it needs no second render pass\n * to learn the panel's real height.\n *\n * Horizontal clamping is unconditional. `SelectMenu` sets `minWidth` (not\n * `width`), so a long option label grows the menu past the trigger; in the\n * Configure View drawer the triggers already sit near the right edge, so the\n * overflow direction is the one that goes off-screen.\n */\n\nexport interface AnchoredPlacement {\n  /** Viewport coordinate for `position: fixed`. */\n  top: number;\n  left: number;\n  /**\n   * Hard cap. Apply it \u2014 it is what makes `flipAbove` safe. Panels that would\n   * rather scroll than be cut off should pair it with `overflow: auto`.\n   */\n  maxHeight: number;\n  /** True \u21D2 the caller must apply `transform: translateY(-100%)`. */\n  flipAbove: boolean;\n}\n\nexport interface AnchoredPositionOptions {\n  /** Rendered width of the panel, used for the horizontal clamp. */\n  width: number;\n  /** Height the panel wants when nothing is in its way. */\n  preferredHeight: number;\n  /** Which anchor edge the panel's left edge lines up with. */\n  align?: 'start' | 'end';\n  /** Gap between anchor and panel. */\n  gap?: number;\n  /** Keep-out band at every viewport edge. */\n  margin?: number;\n  /**\n   * Never shrink below this, even in a very short viewport. A 40px-tall\n   * dropdown is not a usable dropdown; better to overlap the anchor slightly\n   * and stay operable than to collapse into a sliver.\n   */\n  minHeight?: number;\n}\n\n/**\n * Place a panel against an anchor rect, flipping and clamping so it is always\n * fully inside the viewport.\n *\n * Flips above only when that genuinely buys room: if there is no space either\n * way it stays below, where the clamp still keeps it on screen. Comparing the\n * two sides (rather than \"does it fit below? no \u21D2 flip\") is what stops a menu\n * near the top of the window flipping into the space it hasn't got.\n */\nexport function computeAnchoredPosition(\n  anchor: { top: number; bottom: number; left: number; right: number },\n  viewport: { width: number; height: number },\n  options: AnchoredPositionOptions,\n): AnchoredPlacement {\n  const { width, preferredHeight, align = 'start', gap = 4, margin = 8, minHeight = 120 } = options;\n\n  const spaceBelow = viewport.height - anchor.bottom - gap - margin;\n  const spaceAbove = anchor.top - gap - margin;\n\n  // Only flip when above is genuinely roomier. `spaceBelow < preferredHeight`\n  // alone would flip a panel anchored near the TOP of the window into an even\n  // smaller gap \u2014 which is exactly how the popover ended up at top: -156.\n  const flipAbove = spaceBelow < preferredHeight && spaceAbove > spaceBelow;\n\n  const available = flipAbove ? spaceAbove : spaceBelow;\n  // `minHeight` wins over `available` on purpose: in a viewport too short for\n  // either side we accept a little overlap rather than an unusable sliver. The\n  // horizontal clamp and `overflow: auto` keep it reachable.\n  const maxHeight = Math.max(minHeight, Math.min(preferredHeight, available));\n\n  const preferredLeft = align === 'end' ? anchor.right - width : anchor.left;\n  const maxLeft = viewport.width - width - margin;\n  // `Math.max(margin, \u2026)` last so a panel wider than the viewport pins to the\n  // left edge rather than hanging off it on the right.\n  const left = Math.max(margin, Math.min(preferredLeft, maxLeft));\n\n  return {\n    top: flipAbove ? anchor.top - gap : anchor.bottom + gap,\n    left,\n    maxHeight,\n    flipAbove,\n  };\n}\n"],
+  "mappings": "AAwEO,SAAS,wBACd,QACA,UACA,SACmB;AACnB,QAAM,EAAE,OAAO,iBAAiB,QAAQ,SAAS,MAAM,GAAG,SAAS,GAAG,YAAY,IAAI,IAAI;AAE1F,QAAM,aAAa,SAAS,SAAS,OAAO,SAAS,MAAM;AAC3D,QAAM,aAAa,OAAO,MAAM,MAAM;AAKtC,QAAM,YAAY,aAAa,mBAAmB,aAAa;AAE/D,QAAM,YAAY,YAAY,aAAa;AAI3C,QAAM,YAAY,KAAK,IAAI,WAAW,KAAK,IAAI,iBAAiB,SAAS,CAAC;AAE1E,QAAM,gBAAgB,UAAU,QAAQ,OAAO,QAAQ,QAAQ,OAAO;AACtE,QAAM,UAAU,SAAS,QAAQ,QAAQ;AAGzC,QAAM,OAAO,KAAK,IAAI,QAAQ,KAAK,IAAI,eAAe,OAAO,CAAC;AAE9D,SAAO;AAAA,IACL,KAAK,YAAY,OAAO,MAAM,MAAM,OAAO,SAAS;AAAA,IACpD;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/backend/dynamic-table/utils/badgeAutoFit.js

@@ -0,0 +1,35 @@
+const BADGE_FIT_MAX_WIDTH = 360;
+const BADGE_FIT_PADDING = 16;
+const BADGE_FIT_PADDING_WITH_COMMENT = 36;
+function badgeFitWidth(contentWidth, hasComment) {
+  const pad = hasComment ? BADGE_FIT_PADDING_WITH_COMMENT : BADGE_FIT_PADDING;
+  return Math.min(Math.ceil(contentWidth) + pad + 2, BADGE_FIT_MAX_WIDTH);
+}
+function recordBadgeFit(cache, columnKey, width) {
+  if (!Number.isFinite(width) || width <= 0) return false;
+  const current = cache.get(columnKey);
+  if (current != null && current >= width) return false;
+  cache.set(columnKey, width);
+  return true;
+}
+function planBadgeWidths(cache, cols, getColumnWidth, isUserResized) {
+  if (cache.size === 0) return [];
+  const writes = [];
+  for (let col = 0; col < cols.length; col++) {
+    const fit = cache.get(cols[col].data);
+    if (fit == null) continue;
+    if (isUserResized(col)) continue;
+    if (getColumnWidth(col) >= fit) continue;
+    writes.push({ col, width: fit });
+  }
+  return writes;
+}
+export {
+  BADGE_FIT_MAX_WIDTH,
+  BADGE_FIT_PADDING,
+  BADGE_FIT_PADDING_WITH_COMMENT,
+  badgeFitWidth,
+  planBadgeWidths,
+  recordBadgeFit
+};
+//# sourceMappingURL=badgeAutoFit.js.map

package/dist/backend/dynamic-table/utils/badgeAutoFit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/utils/badgeAutoFit.ts"],
+  "sourcesContent": ["import type { ColumnDef } from '../types/index';\n\n/**\n * Badge auto-fit \u2014 the MODEL half.\n *\n * Status/type pills must never be clipped (unlike text, which ellipses), so a\n * badge column grows to fit its widest pill. The measurement itself has to\n * touch the DOM \u2014 a consumer's custom renderer can emit any label it likes, so\n * there is no string in the model to measure \u2014 but the *decision* must not.\n *\n * Why this module exists (anchor Defect 6 / range-operation contract rule 6):\n * the original effect compared `badge.scrollWidth` against `td.clientWidth` and\n * wrote `store.setColumnWidth` for whatever happened to be mounted. Two things\n * are wrong with that under column virtualization:\n *\n *  1. It is *geometry-coupled*: the answer depended on how wide the cell\n *     currently is, so widening a column could change what the next pass\n *     decided \u2014 a column widening as it scrolls into view shifts every later\n *     offset, changes the mounted window, and mounts another badge column.\n *     That is a scroll-coupled layout feedback loop, and it visibly jitters.\n *  2. It was *index-keyed and mount-scoped*: a column that was not mounted had\n *     no fit at all, and a perspective reorder moved a fitted width onto a\n *     different column.\n *\n * The fix, in two halves:\n *\n *  - Measurement is INTRINSIC and one-shot per pill: `badge.scrollWidth` is the\n *    pill's own content width, which does not depend on the cell's width, the\n *    scroll position or the mounted window. It is never re-derived from the\n *    column's current width.\n *  - The result is cached by the STABLE `col.data` key (never the index, same\n *    rule as `frozenColumns` and width persistence) and re-applied to whatever\n *    index that key currently occupies. So `store.getColumnWidth(i)` answers\n *    for every `i`, mounted or not, and survives reorder/hide/show.\n *\n * The cache is grow-only, which makes the whole thing idempotent: a column that\n * is already wide enough produces no write, so no write can trigger another\n * measurement pass.\n */\n\n/** Hard cap so one freak value cannot blow out the layout. */\nexport const BADGE_FIT_MAX_WIDTH = 360;\n\n/**\n * Horizontal padding to reserve around a pill. A commented cell keeps 28px on\n * the right for the comment indicator; without counting that the column fits\n * the pill alone and the pill ends up sitting under the icon.\n */\nexport const BADGE_FIT_PADDING = 16;\nexport const BADGE_FIT_PADDING_WITH_COMMENT = 36;\n\n/**\n * Stored width that shows a pill of `contentWidth` in full: intrinsic content\n * + padding + a 2px buffer, capped. Depends on nothing but the pill itself \u2014\n * no cell width, no scroll offset, no mounted window.\n */\nexport function badgeFitWidth(contentWidth: number, hasComment: boolean): number {\n  const pad = hasComment ? BADGE_FIT_PADDING_WITH_COMMENT : BADGE_FIT_PADDING;\n  return Math.min(Math.ceil(contentWidth) + pad + 2, BADGE_FIT_MAX_WIDTH);\n}\n\n/**\n * Record a measurement against the stable column key, grow-only.\n * Returns true when the cache actually changed.\n */\nexport function recordBadgeFit(\n  cache: Map<string, number>,\n  columnKey: string,\n  width: number,\n): boolean {\n  if (!Number.isFinite(width) || width <= 0) return false;\n  const current = cache.get(columnKey);\n  if (current != null && current >= width) return false;\n  cache.set(columnKey, width);\n  return true;\n}\n\nexport interface BadgeWidthWrite {\n  /** Index into the CURRENT view-order column array. */\n  col: number;\n  width: number;\n}\n\n/**\n * Turn the key-keyed cache into the set of width writes to apply, for the\n * column order as it stands now. Every cached key is considered \u2014 including\n * columns that are not mounted \u2014 so a fitted width follows its column through\n * a reorder and is already correct when the column scrolls back into view.\n *\n * Grow-only, and never fights a width the user set by hand.\n */\nexport function planBadgeWidths(\n  cache: Map<string, number>,\n  cols: ColumnDef[],\n  getColumnWidth: (col: number) => number,\n  isUserResized: (col: number) => boolean,\n): BadgeWidthWrite[] {\n  if (cache.size === 0) return [];\n  const writes: BadgeWidthWrite[] = [];\n  for (let col = 0; col < cols.length; col++) {\n    const fit = cache.get(cols[col].data);\n    if (fit == null) continue;\n    if (isUserResized(col)) continue;\n    if (getColumnWidth(col) >= fit) continue;\n    writes.push({ col, width: fit });\n  }\n  return writes;\n}\n"],
+  "mappings": "AAyCO,MAAM,sBAAsB;AAO5B,MAAM,oBAAoB;AAC1B,MAAM,iCAAiC;AAOvC,SAAS,cAAc,cAAsB,YAA6B;AAC/E,QAAM,MAAM,aAAa,iCAAiC;AAC1D,SAAO,KAAK,IAAI,KAAK,KAAK,YAAY,IAAI,MAAM,GAAG,mBAAmB;AACxE;AAMO,SAAS,eACd,OACA,WACA,OACS;AACT,MAAI,CAAC,OAAO,SAAS,KAAK,KAAK,SAAS,EAAG,QAAO;AAClD,QAAM,UAAU,MAAM,IAAI,SAAS;AACnC,MAAI,WAAW,QAAQ,WAAW,MAAO,QAAO;AAChD,QAAM,IAAI,WAAW,KAAK;AAC1B,SAAO;AACT;AAgBO,SAAS,gBACd,OACA,MACA,gBACA,eACmB;AACnB,MAAI,MAAM,SAAS,EAAG,QAAO,CAAC;AAC9B,QAAM,SAA4B,CAAC;AACnC,WAAS,MAAM,GAAG,MAAM,KAAK,QAAQ,OAAO;AAC1C,UAAM,MAAM,MAAM,IAAI,KAAK,GAAG,EAAE,IAAI;AACpC,QAAI,OAAO,KAAM;AACjB,QAAI,cAAc,GAAG,EAAG;AACxB,QAAI,eAAe,GAAG,KAAK,IAAK;AAChC,WAAO,KAAK,EAAE,KAAK,OAAO,IAAI,CAAC;AAAA,EACjC;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/backend/dynamic-table/utils/clipboard.js

@@ -0,0 +1,172 @@
+const EMPTY_GRID = { rows: [], rowCount: 0, colCount: 0, source: "empty" };
+function parseTsv(text) {
+  if (!text) return [];
+  const rows = [];
+  let row = [];
+  let field = "";
+  let inQuotes = false;
+  let fieldWasQuoted = false;
+  const endField = () => {
+    row.push(field);
+    field = "";
+    fieldWasQuoted = false;
+  };
+  const endRow = () => {
+    endField();
+    rows.push(row);
+    row = [];
+  };
+  for (let i = 0; i < text.length; i++) {
+    const ch = text[i];
+    if (inQuotes) {
+      if (ch === '"') {
+        if (text[i + 1] === '"') {
+          field += '"';
+          i++;
+        } else {
+          inQuotes = false;
+        }
+      } else {
+        field += ch;
+      }
+      continue;
+    }
+    if (ch === '"' && field === "" && !fieldWasQuoted) {
+      inQuotes = true;
+      fieldWasQuoted = true;
+      continue;
+    }
+    if (ch === "	") {
+      endField();
+      continue;
+    }
+    if (ch === "\r") {
+      if (text[i + 1] === "\n") i++;
+      endRow();
+      continue;
+    }
+    if (ch === "\n") {
+      endRow();
+      continue;
+    }
+    field += ch;
+  }
+  if (field !== "" || fieldWasQuoted || row.length > 0) endRow();
+  return padGrid(rows);
+}
+function serialiseTsv(rows) {
+  return rows.map(
+    (row) => row.map((cell) => {
+      const value = cell === null || cell === void 0 ? "" : String(cell);
+      if (/[\t\r\n"]/.test(value)) return `"${value.replace(/"/g, '""')}"`;
+      return value;
+    }).join("	")
+  ).join("\n");
+}
+function selectionToTsv(cells, bounds) {
+  const rowCount = bounds.endRow - bounds.startRow + 1;
+  const colCount = bounds.endCol - bounds.startCol + 1;
+  if (rowCount <= 0 || colCount <= 0) return "";
+  const grid = Array.from(
+    { length: rowCount },
+    () => Array.from({ length: colCount }, () => "")
+  );
+  for (const cell of cells) {
+    const r = cell.row - bounds.startRow;
+    const c = cell.col - bounds.startCol;
+    if (r < 0 || r >= rowCount || c < 0 || c >= colCount) continue;
+    grid[r][c] = cell.value ?? "";
+  }
+  return serialiseTsv(grid);
+}
+function parseClipboardHtml(html) {
+  if (!html || !html.trim()) return null;
+  if (typeof DOMParser === "undefined") return null;
+  let doc;
+  try {
+    doc = new DOMParser().parseFromString(html, "text/html");
+  } catch {
+    return null;
+  }
+  const table = doc.querySelector("table");
+  if (!table) return null;
+  const trs = Array.from(
+    table.querySelectorAll(":scope > tr, :scope > thead > tr, :scope > tbody > tr, :scope > tfoot > tr")
+  );
+  if (trs.length === 0) return null;
+  const grid = [];
+  const spanned = /* @__PURE__ */ new Map();
+  trs.forEach((tr, r) => {
+    const out = grid[r] ?? (grid[r] = []);
+    const cells = Array.from(tr.querySelectorAll(":scope > td, :scope > th"));
+    let c = 0;
+    for (const cell of cells) {
+      while (spanned.has(`${r}:${c}`)) {
+        out[c] = spanned.get(`${r}:${c}`) ?? "";
+        spanned.delete(`${r}:${c}`);
+        c++;
+      }
+      const text = cellText(cell);
+      const colSpan = spanCount(cell.getAttribute("colspan"));
+      const rowSpan = spanCount(cell.getAttribute("rowspan"));
+      for (let dc = 0; dc < colSpan; dc++) {
+        out[c + dc] = dc === 0 ? text : "";
+        for (let dr = 1; dr < rowSpan; dr++) {
+          spanned.set(`${r + dr}:${c + dc}`, "");
+        }
+      }
+      c += colSpan;
+    }
+    while (spanned.has(`${r}:${c}`)) {
+      out[c] = spanned.get(`${r}:${c}`) ?? "";
+      spanned.delete(`${r}:${c}`);
+      c++;
+    }
+  });
+  const filled = grid.map((row) => Array.from(row, (cell) => cell ?? ""));
+  if (filled.length === 0) return null;
+  return padGrid(filled);
+}
+function spanCount(raw) {
+  const n = raw ? parseInt(raw, 10) : 1;
+  if (!Number.isFinite(n) || n < 1) return 1;
+  return Math.min(n, 1e3);
+}
+function cellText(cell) {
+  const clone = cell.cloneNode(true);
+  clone.querySelectorAll("br").forEach((br) => {
+    br.replaceWith(clone.ownerDocument.createTextNode("\n"));
+  });
+  return (clone.textContent ?? "").replace(/[\u00a0\u202f]/g, " ").replace(/^[ \t\r\n]+|[ \t\r\n]+$/g, "");
+}
+function parseClipboardGrid(payload) {
+  const fromHtml = parseClipboardHtml(payload.html);
+  if (fromHtml && !isBlankGrid(fromHtml)) return toGrid(fromHtml, "html");
+  const fromText = payload.text ? parseTsv(payload.text) : [];
+  if (fromText.length > 0 && !isBlankGrid(fromText)) return toGrid(fromText, "text");
+  return EMPTY_GRID;
+}
+function toGrid(rows, source) {
+  return { rows, rowCount: rows.length, colCount: rows[0]?.length ?? 0, source };
+}
+function isBlankGrid(rows) {
+  return rows.length === 0 || rows.every((row) => row.every((cell) => cell === ""));
+}
+function padGrid(rows) {
+  const width = rows.reduce((max, row) => Math.max(max, row.length), 0);
+  return rows.map((row) => {
+    if (row.length === width) return row;
+    const padded = row.slice();
+    while (padded.length < width) padded.push("");
+    return padded;
+  });
+}
+export {
+  padGrid,
+  parseClipboardGrid,
+  parseClipboardHtml,
+  parseTsv,
+  selectionToTsv,
+  serialiseTsv
+};
+//# sourceMappingURL=clipboard.js.map

package/dist/backend/dynamic-table/utils/clipboard.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/utils/clipboard.ts"],
+  "sourcesContent": ["// utils/clipboard.ts\n//\n// Clipboard payload <-> rectangular grid. PURE: no `ClipboardEvent`, no store,\n// no React. The caller reads `text/html` and `text/plain` off the event and\n// hands the strings in; everything below is testable without a browser.\n//\n// Why HTML first: Excel, Google Sheets and LibreOffice all put a real\n// `text/html` `<table>` on the clipboard AND a `text/plain` TSV. The HTML\n// preserves cell boundaries unambiguously \u2014 a cell containing a tab or a\n// newline is still one `<td>`, where the TSV has to quote it and hope the\n// reader unquotes the same way. TSV stays as the fallback because plenty of\n// sources (a text editor, a terminal, our own copy handler) emit only that.\n\n/** Which clipboard flavour produced the grid. `'empty'` means nothing usable. */\nexport type ClipboardGridSource = 'html' | 'text' | 'empty';\n\nexport interface ClipboardGrid {\n  /** Rectangular: every row has `colCount` entries, short rows padded with ''. */\n  rows: string[][];\n  rowCount: number;\n  colCount: number;\n  source: ClipboardGridSource;\n}\n\nexport interface ClipboardPayload {\n  html?: string | null;\n  text?: string | null;\n}\n\nconst EMPTY_GRID: ClipboardGrid = { rows: [], rowCount: 0, colCount: 0, source: 'empty' };\n\n// ============================================\n// TSV\n// ============================================\n\n/**\n * Parse a TSV block into a rectangular grid.\n *\n * Handles the three line endings (`\\r\\n`, `\\n`, `\\r`), one trailing newline\n * (Excel appends one), and RFC4180-style quoting \u2014 which Excel uses on the\n * `text/plain` flavour whenever a cell contains a tab, a newline or a quote:\n * the cell is wrapped in `\"` and internal `\"` are doubled.\n */\nexport function parseTsv(text: string): string[][] {\n  if (!text) return [];\n\n  const rows: string[][] = [];\n  let row: string[] = [];\n  let field = '';\n  let inQuotes = false;\n  let fieldWasQuoted = false;\n\n  const endField = () => {\n    row.push(field);\n    field = '';\n    fieldWasQuoted = false;\n  };\n  const endRow = () => {\n    endField();\n    rows.push(row);\n    row = [];\n  };\n\n  for (let i = 0; i < text.length; i++) {\n    const ch = text[i];\n\n    if (inQuotes) {\n      if (ch === '\"') {\n        if (text[i + 1] === '\"') {\n          field += '\"';\n          i++;\n        } else {\n          inQuotes = false;\n        }\n      } else {\n        field += ch;\n      }\n      continue;\n    }\n\n    if (ch === '\"' && field === '' && !fieldWasQuoted) {\n      inQuotes = true;\n      fieldWasQuoted = true;\n      continue;\n    }\n    if (ch === '\\t') {\n      endField();\n      continue;\n    }\n    if (ch === '\\r') {\n      // `\\r\\n` counts once; a lone `\\r` is an old-Mac line ending.\n      if (text[i + 1] === '\\n') i++;\n      endRow();\n      continue;\n    }\n    if (ch === '\\n') {\n      endRow();\n      continue;\n    }\n    field += ch;\n  }\n\n  // Anything still buffered is the last row; a payload ending in a newline has\n  // nothing buffered and must NOT gain a phantom empty row.\n  if (field !== '' || fieldWasQuoted || row.length > 0) endRow();\n\n  return padGrid(rows);\n}\n\n/**\n * Serialise a grid to TSV, quoting exactly the cells that need it. Round-trips\n * through `parseTsv`.\n */\nexport function serialiseTsv(rows: readonly (readonly unknown[])[]): string {\n  return rows\n    .map((row) =>\n      row\n        .map((cell) => {\n          const value = cell === null || cell === undefined ? '' : String(cell);\n          if (/[\\t\\r\\n\"]/.test(value)) return `\"${value.replace(/\"/g, '\"\"')}\"`;\n          return value;\n        })\n        .join('\\t'),\n    )\n    .join('\\n');\n}\n\n/**\n * Lay a flat list of selected cells back out as a rectangle and serialise it.\n *\n * THE serializer for everything that puts the grid's own selection on the\n * clipboard \u2014 `Ctrl+C`, the context-menu Copy and `Ctrl+X`. Cut must place\n * byte-identical text to Copy (a user who cuts, panics and pastes back has to\n * get exactly what was there), which is only guaranteed while there is one of\n * these.\n *\n * `cells` is `store.getCellsInSelection()`: already index-addressed and already\n * tolerant of unmounted columns. Missing cells stay empty rather than shifting\n * their neighbours left.\n */\nexport function selectionToTsv(\n  cells: readonly { row: number; col: number; value: unknown }[],\n  bounds: { startRow: number; endRow: number; startCol: number; endCol: number },\n): string {\n  const rowCount = bounds.endRow - bounds.startRow + 1;\n  const colCount = bounds.endCol - bounds.startCol + 1;\n  if (rowCount <= 0 || colCount <= 0) return '';\n  const grid: unknown[][] = Array.from({ length: rowCount }, () =>\n    Array.from({ length: colCount }, () => ''),\n  );\n  for (const cell of cells) {\n    const r = cell.row - bounds.startRow;\n    const c = cell.col - bounds.startCol;\n    if (r < 0 || r >= rowCount || c < 0 || c >= colCount) continue;\n    grid[r][c] = cell.value ?? '';\n  }\n  return serialiseTsv(grid);\n}\n\n// ============================================\n// HTML TABLE\n// ============================================\n\n/**\n * Parse the `text/html` flavour Excel/Sheets put on the clipboard.\n *\n * Returns `null` \u2014 never an empty grid \u2014 when there is no usable table, so the\n * caller can fall through to TSV rather than pasting nothing.\n *\n * Merged cells: a `colspan`/`rowspan` cell contributes its text to its\n * top-left position and empty strings to the rest of the span, which is what\n * Excel itself pastes out of a merged block.\n */\nexport function parseClipboardHtml(html: string | null | undefined): string[][] | null {\n  if (!html || !html.trim()) return null;\n  // Server-side rendering and non-DOM test environments have no parser; the\n  // TSV fallback covers them.\n  if (typeof DOMParser === 'undefined') return null;\n\n  let doc: Document;\n  try {\n    doc = new DOMParser().parseFromString(html, 'text/html');\n  } catch {\n    return null;\n  }\n\n  const table = doc.querySelector('table');\n  if (!table) return null;\n\n  const trs = Array.from(\n    table.querySelectorAll(':scope > tr, :scope > thead > tr, :scope > tbody > tr, :scope > tfoot > tr'),\n  );\n  if (trs.length === 0) return null;\n\n  const grid: string[][] = [];\n  // Cells claimed by a rowspan from an earlier row, keyed `row:col`.\n  const spanned = new Map<string, string>();\n\n  trs.forEach((tr, r) => {\n    const out: string[] = grid[r] ?? (grid[r] = []);\n    const cells = Array.from(tr.querySelectorAll(':scope > td, :scope > th'));\n    let c = 0;\n    for (const cell of cells) {\n      while (spanned.has(`${r}:${c}`)) {\n        out[c] = spanned.get(`${r}:${c}`) ?? '';\n        spanned.delete(`${r}:${c}`);\n        c++;\n      }\n      const text = cellText(cell);\n      const colSpan = spanCount(cell.getAttribute('colspan'));\n      const rowSpan = spanCount(cell.getAttribute('rowspan'));\n      for (let dc = 0; dc < colSpan; dc++) {\n        out[c + dc] = dc === 0 ? text : '';\n        for (let dr = 1; dr < rowSpan; dr++) {\n          spanned.set(`${r + dr}:${c + dc}`, '');\n        }\n      }\n      c += colSpan;\n    }\n    // Trailing cells claimed by a rowspan with no `td` after them.\n    while (spanned.has(`${r}:${c}`)) {\n      out[c] = spanned.get(`${r}:${c}`) ?? '';\n      spanned.delete(`${r}:${c}`);\n      c++;\n    }\n  });\n\n  const filled = grid.map((row) => Array.from(row, (cell) => cell ?? ''));\n  if (filled.length === 0) return null;\n  return padGrid(filled);\n}\n\nfunction spanCount(raw: string | null): number {\n  const n = raw ? parseInt(raw, 10) : 1;\n  if (!Number.isFinite(n) || n < 1) return 1;\n  // Excel writes real spans; anything absurd is a malformed payload, and\n  // allocating for it would be a denial-of-service on a paste.\n  return Math.min(n, 1000);\n}\n\n/**\n * A cell's text as a spreadsheet sees it: `<br>` becomes a newline, non-breaking\n * spaces become ordinary ones (Excel fills empty cells with `&nbsp;`), and the\n * source's pretty-printing whitespace is trimmed off the ends.\n */\nfunction cellText(cell: Element): string {\n  const clone = cell.cloneNode(true) as Element;\n  clone.querySelectorAll('br').forEach((br) => {\n    br.replaceWith(clone.ownerDocument!.createTextNode('\\n'));\n  });\n  return (clone.textContent ?? '')\n    .replace(/[\\u00a0\\u202f]/g, ' ')\n    .replace(/^[ \\t\\r\\n]+|[ \\t\\r\\n]+$/g, '');\n}\n\n// ============================================\n// ENTRY POINT\n// ============================================\n\n/**\n * Turn a clipboard payload into a rectangular grid: HTML table first, TSV\n * fallback, `source: 'empty'` when neither yields anything.\n *\n * A grid of exactly one empty cell counts as empty \u2014 pasting it would clear a\n * cell the user did not ask to clear.\n */\nexport function parseClipboardGrid(payload: ClipboardPayload): ClipboardGrid {\n  const fromHtml = parseClipboardHtml(payload.html);\n  if (fromHtml && !isBlankGrid(fromHtml)) return toGrid(fromHtml, 'html');\n\n  const fromText = payload.text ? parseTsv(payload.text) : [];\n  if (fromText.length > 0 && !isBlankGrid(fromText)) return toGrid(fromText, 'text');\n\n  return EMPTY_GRID;\n}\n\nfunction toGrid(rows: string[][], source: ClipboardGridSource): ClipboardGrid {\n  return { rows, rowCount: rows.length, colCount: rows[0]?.length ?? 0, source };\n}\n\nfunction isBlankGrid(rows: string[][]): boolean {\n  return rows.length === 0 || rows.every((row) => row.every((cell) => cell === ''));\n}\n\n/** Pad every row out to the widest, so callers can index without holes. */\nexport function padGrid(rows: string[][]): string[][] {\n  const width = rows.reduce((max, row) => Math.max(max, row.length), 0);\n  return rows.map((row) => {\n    if (row.length === width) return row;\n    const padded = row.slice();\n    while (padded.length < width) padded.push('');\n    return padded;\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/backend/dynamic-table/utils/coerceCellValue.js

@@ -0,0 +1,52 @@
+function isEmptyInput(value) {
+  return value === "" || value === null || value === void 0;
+}
+function sourceValues(col) {
+  const src = col.source;
+  if (!Array.isArray(src) || src.length === 0) return null;
+  return src.map(
+    (o) => o && typeof o === "object" ? String(o.value ?? o.id ?? "") : String(o)
+  );
+}
+function coerceCellValue(value, column) {
+  if (column.readOnly) return { ok: false, reason: "readOnly" };
+  if (!column.type) return { ok: true, value };
+  if (isEmptyInput(value)) return { ok: true, value: null };
+  switch (column.type) {
+    case "numeric": {
+      const raw = typeof value === "number" ? value : String(value).trim().replace(",", ".");
+      const parsed = typeof raw === "number" ? raw : parseFloat(raw);
+      if (!Number.isFinite(parsed)) return { ok: false, reason: "notCoercible" };
+      return { ok: true, value: parsed };
+    }
+    case "date": {
+      const date = value instanceof Date ? value : new Date(value);
+      if (Number.isNaN(date.getTime())) return { ok: false, reason: "notCoercible" };
+      const year = date.getFullYear();
+      const month = String(date.getMonth() + 1).padStart(2, "0");
+      const day = String(date.getDate()).padStart(2, "0");
+      return { ok: true, value: `${year}-${month}-${day}` };
+    }
+    case "boolean": {
+      if (typeof value === "boolean") return { ok: true, value };
+      const s = String(value).trim().toLowerCase();
+      if (s === "true" || s === "1" || s === "yes" || s === "tak") return { ok: true, value: true };
+      if (s === "false" || s === "0" || s === "no" || s === "nie") return { ok: true, value: false };
+      return { ok: false, reason: "notCoercible" };
+    }
+    case "dropdown":
+    case "multiselect": {
+      const allowed = sourceValues(column);
+      if (!allowed) return { ok: true, value };
+      const wanted = Array.isArray(value) ? value.map(String) : [String(value)];
+      if (wanted.some((v) => !allowed.includes(v))) return { ok: false, reason: "notInSource" };
+      return { ok: true, value };
+    }
+    default:
+      return { ok: true, value };
+  }
+}
+export {
+  coerceCellValue
+};
+//# sourceMappingURL=coerceCellValue.js.map

package/dist/backend/dynamic-table/utils/coerceCellValue.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/utils/coerceCellValue.ts"],
+  "sourcesContent": ["// utils/coerceCellValue.ts\n//\n// THE coercion table: \"can this raw value become this column's type, and if so\n// what exactly gets stored?\"\n//\n// It used to be `parseValueByType`, a private function inside\n// `handlers/index.ts` reachable only from the inline-edit path. Paste, fill,\n// find-&-replace and import all need the same answer, and a second table is how\n// a pasted date ends up stored differently from a typed one. So it moved here,\n// and it now RETURNS A VERDICT rather than a value: a multi-cell write must be\n// able to say \"3 cells were not numbers\" instead of silently blanking them.\n//\n// Pure: no store, no React, no DOM.\n\nimport type { ColumnDef } from '../types/index';\nimport type { CoerceResult } from '../handlers/cellWrites';\n\n/** Empty in the \"user cleared the cell\" sense. Clearing is always allowed. */\nfunction isEmptyInput(value: unknown): boolean {\n  return value === '' || value === null || value === undefined;\n}\n\n/** `col.source` entries may be plain scalars or `{ value | id }` objects. */\nfunction sourceValues(col: ColumnDef): string[] | null {\n  const src = col.source;\n  if (!Array.isArray(src) || src.length === 0) return null;\n  return src.map((o) =>\n    o && typeof o === 'object'\n      ? String((o as Record<string, unknown>).value ?? (o as Record<string, unknown>).id ?? '')\n      : String(o),\n  );\n}\n\n/**\n * Coerce one raw value for one column.\n *\n * Structurally identical to `CellValueCoercer`, so it can be handed straight to\n * `applyCellWrites({ coerce: coerceCellValue, ... })`.\n *\n * Verdicts:\n *  - `readOnly`      the column refuses writes outright;\n *  - `notCoercible`  a non-empty value that cannot become the column's type\n *                    (`'abc'` into a numeric column, `'32/13'` into a date);\n *  - `notInSource`   a `dropdown` / `multiselect` value outside `col.source`.\n *\n * Emptying is never a rejection here \u2014 `ColumnDef.required` is enforced one\n * level up, in `applyCellWrites`, where the row is known.\n */\nexport function coerceCellValue(value: unknown, column: ColumnDef): CoerceResult {\n  if (column.readOnly) return { ok: false, reason: 'readOnly' };\n  if (!column.type) return { ok: true, value };\n  if (isEmptyInput(value)) return { ok: true, value: null };\n\n  switch (column.type) {\n    case 'numeric': {\n      // Accept the Polish decimal comma users actually type; `parseFloat` alone\n      // reads \"1,5\" as 1.\n      const raw = typeof value === 'number' ? value : String(value).trim().replace(',', '.');\n      const parsed = typeof raw === 'number' ? raw : parseFloat(raw);\n      if (!Number.isFinite(parsed)) return { ok: false, reason: 'notCoercible' };\n      return { ok: true, value: parsed };\n    }\n\n    case 'date': {\n      const date = value instanceof Date ? value : new Date(value as string);\n      if (Number.isNaN(date.getTime())) return { ok: false, reason: 'notCoercible' };\n      // ISO date string (YYYY-MM-DD) so a Date round-tripped through a string\n      // stays the same day. LOCAL parts, not UTC: `toISOString()` would shift a\n      // Warsaw midnight back to the previous day.\n      const year = date.getFullYear();\n      const month = String(date.getMonth() + 1).padStart(2, '0');\n      const day = String(date.getDate()).padStart(2, '0');\n      return { ok: true, value: `${year}-${month}-${day}` };\n    }\n\n    case 'boolean': {\n      if (typeof value === 'boolean') return { ok: true, value };\n      const s = String(value).trim().toLowerCase();\n      if (s === 'true' || s === '1' || s === 'yes' || s === 'tak') return { ok: true, value: true };\n      if (s === 'false' || s === '0' || s === 'no' || s === 'nie') return { ok: true, value: false };\n      return { ok: false, reason: 'notCoercible' };\n    }\n\n    case 'dropdown':\n    case 'multiselect': {\n      const allowed = sourceValues(column);\n      if (!allowed) return { ok: true, value };\n      const wanted = Array.isArray(value) ? value.map(String) : [String(value)];\n      if (wanted.some((v) => !allowed.includes(v))) return { ok: false, reason: 'notInSource' };\n      return { ok: true, value };\n    }\n\n    default:\n      return { ok: true, value };\n  }\n}\n"],
+  "mappings": "AAkBA,SAAS,aAAa,OAAyB;AAC7C,SAAO,UAAU,MAAM,UAAU,QAAQ,UAAU;AACrD;AAGA,SAAS,aAAa,KAAiC;AACrD,QAAM,MAAM,IAAI;AAChB,MAAI,CAAC,MAAM,QAAQ,GAAG,KAAK,IAAI,WAAW,EAAG,QAAO;AACpD,SAAO,IAAI;AAAA,IAAI,CAAC,MACd,KAAK,OAAO,MAAM,WACd,OAAQ,EAA8B,SAAU,EAA8B,MAAM,EAAE,IACtF,OAAO,CAAC;AAAA,EACd;AACF;AAiBO,SAAS,gBAAgB,OAAgB,QAAiC;AAC/E,MAAI,OAAO,SAAU,QAAO,EAAE,IAAI,OAAO,QAAQ,WAAW;AAC5D,MAAI,CAAC,OAAO,KAAM,QAAO,EAAE,IAAI,MAAM,MAAM;AAC3C,MAAI,aAAa,KAAK,EAAG,QAAO,EAAE,IAAI,MAAM,OAAO,KAAK;AAExD,UAAQ,OAAO,MAAM;AAAA,IACnB,KAAK,WAAW;AAGd,YAAM,MAAM,OAAO,UAAU,WAAW,QAAQ,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,KAAK,GAAG;AACrF,YAAM,SAAS,OAAO,QAAQ,WAAW,MAAM,WAAW,GAAG;AAC7D,UAAI,CAAC,OAAO,SAAS,MAAM,EAAG,QAAO,EAAE,IAAI,OAAO,QAAQ,eAAe;AACzE,aAAO,EAAE,IAAI,MAAM,OAAO,OAAO;AAAA,IACnC;AAAA,IAEA,KAAK,QAAQ;AACX,YAAM,OAAO,iBAAiB,OAAO,QAAQ,IAAI,KAAK,KAAe;AACrE,UAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,EAAG,QAAO,EAAE,IAAI,OAAO,QAAQ,eAAe;AAI7E,YAAM,OAAO,KAAK,YAAY;AAC9B,YAAM,QAAQ,OAAO,KAAK,SAAS,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG;AACzD,YAAM,MAAM,OAAO,KAAK,QAAQ,CAAC,EAAE,SAAS,GAAG,GAAG;AAClD,aAAO,EAAE,IAAI,MAAM,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,GAAG;AAAA,IACtD;AAAA,IAEA,KAAK,WAAW;AACd,UAAI,OAAO,UAAU,UAAW,QAAO,EAAE,IAAI,MAAM,MAAM;AACzD,YAAM,IAAI,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY;AAC3C,UAAI,MAAM,UAAU,MAAM,OAAO,MAAM,SAAS,MAAM,MAAO,QAAO,EAAE,IAAI,MAAM,OAAO,KAAK;AAC5F,UAAI,MAAM,WAAW,MAAM,OAAO,MAAM,QAAQ,MAAM,MAAO,QAAO,EAAE,IAAI,MAAM,OAAO,MAAM;AAC7F,aAAO,EAAE,IAAI,OAAO,QAAQ,eAAe;AAAA,IAC7C;AAAA,IAEA,KAAK;AAAA,IACL,KAAK,eAAe;AAClB,YAAM,UAAU,aAAa,MAAM;AACnC,UAAI,CAAC,QAAS,QAAO,EAAE,IAAI,MAAM,MAAM;AACvC,YAAM,SAAS,MAAM,QAAQ,KAAK,IAAI,MAAM,IAAI,MAAM,IAAI,CAAC,OAAO,KAAK,CAAC;AACxE,UAAI,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,SAAS,CAAC,CAAC,EAAG,QAAO,EAAE,IAAI,OAAO,QAAQ,cAAc;AACxF,aAAO,EAAE,IAAI,MAAM,MAAM;AAAA,IAC3B;AAAA,IAEA;AACE,aAAO,EAAE,IAAI,MAAM,MAAM;AAAA,EAC7B;AACF;",
+  "names": []
+}

package/dist/backend/dynamic-table/utils/colorAdjacency.js

@@ -0,0 +1,27 @@
+const NO_COLOR_ADJACENCY = {
+  above: false,
+  below: false,
+  left: false,
+  right: false
+};
+function computeColorAdjacency(color, row, col, cols, annotations, keyAt) {
+  if (!color || !annotations || annotations.size === 0) return NO_COLOR_ADJACENCY;
+  const sameColorAt = (r, c) => {
+    const column = cols[c];
+    if (!column) return false;
+    const key = keyAt(r, column);
+    if (key == null) return false;
+    return annotations.get(key)?.color === color;
+  };
+  return {
+    above: sameColorAt(row - 1, col),
+    below: sameColorAt(row + 1, col),
+    left: sameColorAt(row, col - 1),
+    right: sameColorAt(row, col + 1)
+  };
+}
+export {
+  NO_COLOR_ADJACENCY,
+  computeColorAdjacency
+};
+//# sourceMappingURL=colorAdjacency.js.map

package/dist/backend/dynamic-table/utils/colorAdjacency.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/utils/colorAdjacency.ts"],
+  "sourcesContent": ["import type { ColumnDef } from '../types/index';\nimport type { AnnotationMap } from '../hooks/useAnnotations';\n\n/**\n * Colour-block adjacency \u2014 the MODEL replacement for anchor Defect 7.\n *\n * A 2-D block of same-coloured annotated cells must read as ONE shape: rounded\n * only on its outer corners, with the inter-row gap painted through. CSS cannot\n * see across `<tr>`s, so each cell is told about its four neighbours via\n * `data-cb-{above,below,left,right}`.\n *\n * The old implementation discovered those neighbours by running\n * `querySelectorAll('td.hot-cell[...][class*=\"cell-color-\"]')` over the grid on\n * every scroll event and comparing `data-row` / `data-col`. That is wrong twice:\n *\n *  1. It can only see MOUNTED cells. The row virtualizer already made the top\n *    and bottom rows of the window falsely report \"no neighbour\"; column\n *    virtualization adds the same lie on the left/right edges, mid-block, where\n *    users see it \u2014 a painted gap and a rounded corner in the middle of a\n *    colour run, moving as you scroll.\n *  2. It ran a full-grid DOM query inside the scroll handler, at the moment the\n *    browser is already committing a frame.\n *\n * Throttling would fix neither. Adjacency is a fact about the DATA, so it is\n * computed here from the annotation map, the row order and the column order,\n * and passed down as props (range-operation contract rule 7: an unmounted\n * neighbour is still a neighbour).\n *\n * Vertical adjacency is by DATA row index (`row \u00B1 1`), which is what the DOM\n * scan compared too \u2014 a group header rendered between two data rows does not\n * break a colour block.\n */\n\nexport interface ColorAdjacency {\n  above: boolean;\n  below: boolean;\n  left: boolean;\n  right: boolean;\n}\n\nexport const NO_COLOR_ADJACENCY: ColorAdjacency = {\n  above: false,\n  below: false,\n  left: false,\n  right: false,\n};\n\n/**\n * @param color       This cell's annotation colour (`null`/`undefined` = uncoloured).\n * @param row         Data row index.\n * @param col         Index into the FULL view-order column array.\n * @param cols        The full view-order column array \u2014 never a virtualization window.\n * @param annotations Map keyed `\"<entityType>:<rowId>:<columnKey>\"`.\n * @param keyAt       Builds that key for a (data row index, column). Returns\n *                    `null` when the cell has no annotation target \u2014 a row that\n *                    does not exist, or a column outside the scope. Supplied by\n *                    the grid so adjacency uses the SAME target resolver the\n *                    fetch and the dialog use (workshop B8a).\n */\nexport function computeColorAdjacency(\n  color: string | null | undefined,\n  row: number,\n  col: number,\n  cols: ColumnDef[],\n  annotations: AnnotationMap | undefined,\n  keyAt: (row: number, column: ColumnDef) => string | null,\n): ColorAdjacency {\n  // An uncoloured cell has no block to join, so it never needs the four\n  // attributes. Bailing here keeps the whole thing free for the overwhelming\n  // majority of cells.\n  if (!color || !annotations || annotations.size === 0) return NO_COLOR_ADJACENCY;\n\n  const sameColorAt = (r: number, c: number): boolean => {\n    const column = cols[c];\n    if (!column) return false;\n    const key = keyAt(r, column);\n    if (key == null) return false;\n    return annotations.get(key)?.color === color;\n  };\n\n  return {\n    above: sameColorAt(row - 1, col),\n    below: sameColorAt(row + 1, col),\n    left: sameColorAt(row, col - 1),\n    right: sameColorAt(row, col + 1),\n  };\n}\n"],
+  "mappings": "AAwCO,MAAM,qBAAqC;AAAA,EAChD,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AACT;AAcO,SAAS,sBACd,OACA,KACA,KACA,MACA,aACA,OACgB;AAIhB,MAAI,CAAC,SAAS,CAAC,eAAe,YAAY,SAAS,EAAG,QAAO;AAE7D,QAAM,cAAc,CAAC,GAAW,MAAuB;AACrD,UAAM,SAAS,KAAK,CAAC;AACrB,QAAI,CAAC,OAAQ,QAAO;AACpB,UAAM,MAAM,MAAM,GAAG,MAAM;AAC3B,QAAI,OAAO,KAAM,QAAO;AACxB,WAAO,YAAY,IAAI,GAAG,GAAG,UAAU;AAAA,EACzC;AAEA,SAAO;AAAA,IACL,OAAO,YAAY,MAAM,GAAG,GAAG;AAAA,IAC/B,OAAO,YAAY,MAAM,GAAG,GAAG;AAAA,IAC/B,MAAM,YAAY,KAAK,MAAM,CAAC;AAAA,IAC9B,OAAO,YAAY,KAAK,MAAM,CAAC;AAAA,EACjC;AACF;",
+  "names": []
+}

package/dist/backend/dynamic-table/utils/columnFill.js

@@ -0,0 +1,36 @@
+function computeColumnFill({
+  widths,
+  rigid,
+  furnitureWidth,
+  containerWidth
+}) {
+  const result = /* @__PURE__ */ new Map();
+  if (!(containerWidth > 0) || widths.length === 0) return result;
+  let declaredTotal = furnitureWidth;
+  for (const w of widths) declaredTotal += w;
+  const surplus = Math.floor(containerWidth) - declaredTotal;
+  if (surplus < 1) return result;
+  const flexible = [];
+  let flexibleTotal = 0;
+  for (let i = 0; i < widths.length; i++) {
+    if (rigid.has(i)) continue;
+    flexible.push(i);
+    flexibleTotal += widths[i];
+  }
+  if (flexible.length === 0 || flexibleTotal <= 0) return result;
+  let assigned = 0;
+  for (let n = 0; n < flexible.length - 1; n++) {
+    const idx = flexible[n];
+    const extra = Math.floor(surplus * widths[idx] / flexibleTotal);
+    if (extra > 0) result.set(idx, extra);
+    assigned += extra;
+  }
+  const last = flexible[flexible.length - 1];
+  const remainder = surplus - assigned;
+  if (remainder > 0) result.set(last, remainder);
+  return result;
+}
+export {
+  computeColumnFill
+};
+//# sourceMappingURL=columnFill.js.map

package/dist/backend/dynamic-table/utils/columnFill.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/utils/columnFill.ts"],
+  "sourcesContent": ["/**\n * FILL THE CONTAINER \u2014 the arithmetic behind \"a narrow table has no dead strip\n * to its right\".\n *\n * Two regimes, and only two:\n *\n *   declared total  <  container \u2192 EXPAND the flexible columns until the row\n *                                  ends exactly at the container's right edge.\n *   declared total  >= container \u2192 nothing to do; the grid scrolls horizontally\n *                                  at its declared widths.\n *\n * WHY THIS IS ARITHMETIC AND NOT `width: 100%`.\n *\n * Handing the row to the layout engine (`table { width: 100% }` + `flex-grow`)\n * fills the strip, but a stretched column's PAINTED width stops being its\n * DECLARED width \u2014 and column virtualization is built on declared widths: the\n * spacer that stands in for a run of unmounted columns has to be exactly as\n * wide as they would have been, or every mounted column lands at the wrong x.\n * That is why stretching used to force virtualization off, which made \"fills\n * the width\" and \"virtualized\" mutually exclusive on the widest lists \u2014 the\n * precise complaint this module answers.\n *\n * Resolving the surplus to PIXELS keeps every column's declared width honest,\n * so the spacers stay correct and both properties hold at once.\n *\n * WHAT IS RIGID (never touched):\n *  \u2022 pinned / frozen columns and the sticky checkbox + Actions columns \u2014 their\n *    widths are load-bearing for `position: sticky` offsets;\n *  \u2022 any column the user has resized by hand. Their number is their answer;\n *    growing it would silently overrule them.\n */\n\nexport interface ColumnFillInput {\n  /** DECLARED width of every column, in view order. Never a painted width. */\n  widths: readonly number[];\n  /** Indices that must keep their declared width exactly. */\n  rigid: ReadonlySet<number>;\n  /** Row furniture outside `widths`: the row-header gutter + Actions column. */\n  furnitureWidth: number;\n  /** The scroll container's inner width (`clientWidth`). */\n  containerWidth: number;\n}\n\n/**\n * Surplus pixels per column index. Only positive entries appear; an empty map\n * means \"declared widths already fill (or overflow) the container\".\n */\nexport function computeColumnFill({\n  widths,\n  rigid,\n  furnitureWidth,\n  containerWidth,\n}: ColumnFillInput): Map<number, number> {\n  const result = new Map<number, number>();\n  if (!(containerWidth > 0) || widths.length === 0) return result;\n\n  let declaredTotal = furnitureWidth;\n  for (const w of widths) declaredTotal += w;\n\n  // Floor the container: a fractional target would leave a sub-pixel sliver of\n  // dead strip or provoke a 1px horizontal scrollbar, and both read as a bug.\n  const surplus = Math.floor(containerWidth) - declaredTotal;\n  if (surplus < 1) return result;\n\n  const flexible: number[] = [];\n  let flexibleTotal = 0;\n  for (let i = 0; i < widths.length; i++) {\n    if (rigid.has(i)) continue;\n    flexible.push(i);\n    flexibleTotal += widths[i];\n  }\n  // Every column is pinned or hand-sized: there is nothing we are allowed to\n  // grow, so the strip stays. Deliberate \u2014 the alternative is overruling the\n  // user's own widths to win back some pixels.\n  if (flexible.length === 0 || flexibleTotal <= 0) return result;\n\n  // Proportional to declared width, so a wide description column takes more of\n  // the surplus than a narrow date one and the row keeps its rhythm.\n  let assigned = 0;\n  for (let n = 0; n < flexible.length - 1; n++) {\n    const idx = flexible[n];\n    const extra = Math.floor((surplus * widths[idx]) / flexibleTotal);\n    if (extra > 0) result.set(idx, extra);\n    assigned += extra;\n  }\n  // The last flexible column absorbs the rounding remainder, so the row lands\n  // on the container's edge to the pixel rather than 1\u20133px short of it.\n  const last = flexible[flexible.length - 1];\n  const remainder = surplus - assigned;\n  if (remainder > 0) result.set(last, remainder);\n\n  return result;\n}\n"],
+  "mappings": "AA+CO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAyC;AACvC,QAAM,SAAS,oBAAI,IAAoB;AACvC,MAAI,EAAE,iBAAiB,MAAM,OAAO,WAAW,EAAG,QAAO;AAEzD,MAAI,gBAAgB;AACpB,aAAW,KAAK,OAAQ,kBAAiB;AAIzC,QAAM,UAAU,KAAK,MAAM,cAAc,IAAI;AAC7C,MAAI,UAAU,EAAG,QAAO;AAExB,QAAM,WAAqB,CAAC;AAC5B,MAAI,gBAAgB;AACpB,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,QAAI,MAAM,IAAI,CAAC,EAAG;AAClB,aAAS,KAAK,CAAC;AACf,qBAAiB,OAAO,CAAC;AAAA,EAC3B;AAIA,MAAI,SAAS,WAAW,KAAK,iBAAiB,EAAG,QAAO;AAIxD,MAAI,WAAW;AACf,WAAS,IAAI,GAAG,IAAI,SAAS,SAAS,GAAG,KAAK;AAC5C,UAAM,MAAM,SAAS,CAAC;AACtB,UAAM,QAAQ,KAAK,MAAO,UAAU,OAAO,GAAG,IAAK,aAAa;AAChE,QAAI,QAAQ,EAAG,QAAO,IAAI,KAAK,KAAK;AACpC,gBAAY;AAAA,EACd;AAGA,QAAM,OAAO,SAAS,SAAS,SAAS,CAAC;AACzC,QAAM,YAAY,UAAU;AAC5B,MAAI,YAAY,EAAG,QAAO,IAAI,MAAM,SAAS;AAE7C,SAAO;AACT;",
+  "names": []
+}

package/dist/backend/dynamic-table/utils/columnSpacerStyle.js

@@ -0,0 +1,21 @@
+function columnSpacerStyle(width) {
+  return {
+    width,
+    flexBasis: width,
+    minWidth: width,
+    maxWidth: width,
+    flexShrink: 0,
+    flexGrow: 0,
+    padding: 0,
+    border: 0,
+    pointerEvents: "none"
+  };
+}
+function columnSpacerKey(fromIndex, toIndex) {
+  return `__spacer_${fromIndex}_${toIndex}`;
+}
+export {
+  columnSpacerKey,
+  columnSpacerStyle
+};
+//# sourceMappingURL=columnSpacerStyle.js.map

package/dist/backend/dynamic-table/utils/columnSpacerStyle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/utils/columnSpacerStyle.ts"],
+  "sourcesContent": ["import type * as React from 'react';\n\n/**\n * Geometry for the placeholder box that stands in for a run of unmounted\n * columns under horizontal virtualization.\n *\n * One function, four render sites (`ColumnHeaders`, `VirtualRow`,\n * `GroupSummaryRow`, `FooterTotalsRow`). If header spacers and body spacers can\n * drift by a pixel, sticky offsets and column alignment drift with them, so the\n * numbers are stated exactly once.\n *\n * HARD RULES, all of which are about correctness rather than looks:\n *\n *  1. `flexShrink: 0` / `flexGrow: 0` ALWAYS \u2014 a spacer that stretched would\n *     make the mounted columns land at the wrong x. Nothing in this grid\n *     stretches any more (`utils/columnFill.ts` resolves the fill-to-container\n *     surplus to PIXELS precisely so that spacer widths stay honest), and this\n *     is the belt to that braces.\n *  2. `pointerEvents: 'none'` \u2014 nothing may hit-test onto a spacer.\n *  3. NEVER `position: sticky`. A spacer that stuck would occlude real cells.\n *  4. No padding, no border. NOTE what is deliberately ABSENT: `background`.\n *     A striped, checkbox-selected or range-selected row paints its fill on the\n *     CELLS (`td.hot-cell`), not on the `<tr>`, so an inline `transparent` here\n *     would punch a visible hole through the middle of a highlighted row. The\n *     fill is handed to spacers by `styles/DynamicTable.v2.css` instead, which\n *     is the only place that knows what each row state is painted with.\n *\n * The two rules a style object cannot carry are stated here because they belong\n * with the same decision, and every call site obeys them:\n *\n *  5. A spacer element must NEVER carry `data-row` or `data-col`. Every pointer\n *     hit-test does `closest('td[data-row][data-col]')`, so a matching spacer\n *     would silently retarget writes to a column the user never clicked.\n *  6. It must be `aria-hidden` so it is not counted as a cell.\n */\nexport function columnSpacerStyle(width: number): React.CSSProperties {\n  return {\n    width,\n    flexBasis: width,\n    minWidth: width,\n    maxWidth: width,\n    flexShrink: 0,\n    flexGrow: 0,\n    padding: 0,\n    border: 0,\n    pointerEvents: 'none',\n  };\n}\n\n/** Stable React key for a spacer, derived from the run it covers. */\nexport function columnSpacerKey(fromIndex: number, toIndex: number): string {\n  return `__spacer_${fromIndex}_${toIndex}`;\n}\n"],
+  "mappings": "AAmCO,SAAS,kBAAkB,OAAoC;AACpE,SAAO;AAAA,IACL;AAAA,IACA,WAAW;AAAA,IACX,UAAU;AAAA,IACV,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,UAAU;AAAA,IACV,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,eAAe;AAAA,EACjB;AACF;AAGO,SAAS,gBAAgB,WAAmB,SAAyB;AAC1E,SAAO,YAAY,SAAS,IAAI,OAAO;AACzC;",
+  "names": []
+}