@freighttech/ui 0.13.18

package/dist/backend/dynamic-table/hooks/index.js

@@ -0,0 +1,524 @@
+import { useCallback, useContext, useSyncExternalStore, createContext, useMemo } from "react";
+import { apiCall } from "../../utils/apiCall.js";
+import { selectionToTsv } from "../utils/clipboard.js";
+const CellStoreContext = createContext(null);
+const useCellStore = () => {
+  const store = useContext(CellStoreContext);
+  if (!store) {
+    throw new Error("useCellStore must be used within CellStoreContext.Provider");
+  }
+  return store;
+};
+function useStoreRevision() {
+  const store = useCellStore();
+  const subscribe = useCallback(
+    (onStoreChange) => store.subscribeToStore(onStoreChange),
+    [store]
+  );
+  const getSnapshot = useCallback(() => store.getStoreRevision(), [store]);
+  const getServerSnapshot = useCallback(() => 0, []);
+  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+function useCellState(row, col) {
+  const store = useCellStore();
+  const subscribe = useCallback(
+    (onStoreChange) => store.subscribe(row, col, onStoreChange),
+    [store, row, col]
+  );
+  const getSnapshot = useCallback(() => store.getRevision(row, col), [store, row, col]);
+  const getServerSnapshot = useCallback(() => 0, []);
+  useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+  return store.getCellState(row, col);
+}
+function useSelectionRevision() {
+  const store = useCellStore();
+  const subscribe = useCallback(
+    (onStoreChange) => store.subscribeToSelection(onStoreChange),
+    [store]
+  );
+  const getSnapshot = useCallback(() => store.getSelectionRevision(), [store]);
+  const getServerSnapshot = useCallback(() => 0, []);
+  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+function useSelection() {
+  const store = useCellStore();
+  useSelectionRevision();
+  return store.getSelection();
+}
+function useDragHandling(store, colCount) {
+  const dragState = { current: { isDragging: false, type: null, start: null } };
+  const handleDragStart = useCallback(
+    (row, col, type) => {
+      dragState.current = {
+        isDragging: true,
+        type,
+        start: { row, col }
+      };
+      if (type === "row") {
+        store.setSelection({
+          type: "rowRange",
+          anchor: { row, col: 0 },
+          focus: { row, col: colCount - 1 }
+        });
+      } else if (type === "column") {
+        store.setSelection({
+          type: "colRange",
+          anchor: { row: 0, col },
+          focus: { row: store.getRowCount() - 1, col }
+        });
+      } else {
+        store.setSelection({
+          type: "range",
+          anchor: { row, col },
+          focus: { row, col }
+        });
+      }
+    },
+    [store, colCount]
+  );
+  const handleDragMove = useCallback(
+    (row, col) => {
+      if (!dragState.current.isDragging || !dragState.current.start) return;
+      const selection = store.getSelection();
+      if (!selection.anchor) return;
+      if (dragState.current.type === "row") {
+        store.setSelection({
+          ...selection,
+          focus: { row, col: colCount - 1 }
+        });
+      } else if (dragState.current.type === "column") {
+        store.setSelection({
+          ...selection,
+          focus: { row: store.getRowCount() - 1, col }
+        });
+      } else {
+        store.setSelection({
+          ...selection,
+          focus: { row, col }
+        });
+      }
+    },
+    [store, colCount]
+  );
+  const handleDragEnd = useCallback(() => {
+    dragState.current = { isDragging: false, type: null, start: null };
+  }, []);
+  return {
+    dragState,
+    handleDragStart,
+    handleDragMove,
+    handleDragEnd
+  };
+}
+function isEditableCell(column) {
+  if (!column) return false;
+  if (column.readOnly === true) return false;
+  return true;
+}
+function columnMountsEditor(column) {
+  if (!column) return false;
+  if (typeof column.editor === "function") return true;
+  return column.readOnly !== true;
+}
+const ARROW_KEYS = ["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight"];
+function arrowDelta(key) {
+  switch (key) {
+    case "ArrowUp":
+      return { dRow: -1, dCol: 0 };
+    case "ArrowDown":
+      return { dRow: 1, dCol: 0 };
+    case "ArrowLeft":
+      return { dRow: 0, dCol: -1 };
+    default:
+      return { dRow: 0, dCol: 1 };
+  }
+}
+function isBlankValue(value) {
+  return value === null || value === void 0 || value === "";
+}
+function findDataEdge(store, from, colCount, key) {
+  const { dRow, dCol } = arrowDelta(key);
+  const rowCount = store.getRowCount();
+  const inside = (r, c) => r >= 0 && r < rowCount && c >= 0 && c < colCount;
+  const blank = (r, c) => isBlankValue(store.getCellValue(r, c));
+  let { row, col } = from;
+  if (!inside(row + dRow, col + dCol)) return { row, col };
+  const crossingBlankRun = blank(row + dRow, col + dCol);
+  row += dRow;
+  col += dCol;
+  while (inside(row + dRow, col + dCol)) {
+    if (crossingBlankRun ? !blank(row, col) : blank(row + dRow, col + dCol)) break;
+    row += dRow;
+    col += dCol;
+  }
+  return { row, col };
+}
+function stepOne(from, rowCount, colCount, key) {
+  const { dRow, dCol } = arrowDelta(key);
+  return {
+    row: Math.min(rowCount - 1, Math.max(0, from.row + dRow)),
+    col: Math.min(colCount - 1, Math.max(0, from.col + dCol))
+  };
+}
+function useKeyboardNavigation(store, colCount, columns, autoEditOnTab = true, _onSave, siblingTableRefs) {
+  const handleKeyDown = useCallback(
+    (e) => {
+      const editing = store.getEditingCell();
+      const bounds = store.getSelectionBounds();
+      if (e.key === "Enter" && !e.shiftKey && editing) {
+        e.preventDefault();
+        const currentRow = editing.row;
+        const currentCol = editing.col;
+        const nextRow = currentRow + 1;
+        if (nextRow < store.getRowCount()) {
+          store.clearEditing();
+          store.setSelection({
+            type: "range",
+            anchor: { row: nextRow, col: currentCol },
+            focus: { row: nextRow, col: currentCol }
+          });
+          store.setEditingCell(nextRow, currentCol);
+        } else {
+          store.clearEditing();
+          store.focusTable();
+        }
+        return;
+      }
+      if (e.key === "Enter" && !e.shiftKey && !editing && bounds) {
+        if (bounds.startRow === bounds.endRow && bounds.startCol === bounds.endCol) {
+          e.preventDefault();
+          if (!columnMountsEditor(columns[bounds.startCol])) return;
+          store.setEditingCell(bounds.startRow, bounds.startCol);
+          return;
+        }
+      }
+      if (e.key === "Escape") {
+        if (editing) {
+          e.preventDefault();
+          store.clearEditing();
+        } else if (bounds) {
+          e.preventDefault();
+          store.setSelection({ type: null, anchor: null, focus: null });
+        }
+        return;
+      }
+      if (e.key === "Tab") {
+        const direction = e.shiftKey ? -1 : 1;
+        let currentRow;
+        let currentCol;
+        if (editing) {
+          currentRow = editing.row;
+          currentCol = editing.col;
+        } else if (bounds && bounds.startRow === bounds.endRow && bounds.startCol === bounds.endCol) {
+          currentRow = bounds.startRow;
+          currentCol = bounds.startCol;
+        } else {
+          const rowCount2 = store.getRowCount();
+          if (rowCount2 === 0) return;
+          currentRow = direction === 1 ? 0 : rowCount2 - 1;
+          currentCol = direction === 1 ? -1 : colCount;
+        }
+        const rowCount = store.getRowCount();
+        const totalCells = rowCount * colCount;
+        let nextCol = currentCol + direction;
+        let nextRow = currentRow;
+        let checked = 0;
+        if (nextCol >= colCount) {
+          nextCol = 0;
+          nextRow++;
+        } else if (nextCol < 0) {
+          nextCol = colCount - 1;
+          nextRow--;
+        }
+        while (checked < totalCells) {
+          if (nextRow < 0 || nextRow >= rowCount) break;
+          if (isEditableCell(columns[nextCol])) {
+            e.preventDefault();
+            store.clearEditing();
+            store.setSelection({
+              type: "range",
+              anchor: { row: nextRow, col: nextCol },
+              focus: { row: nextRow, col: nextCol }
+            });
+            if (autoEditOnTab) {
+              store.setEditingCell(nextRow, nextCol);
+            }
+            return;
+          }
+          nextCol += direction;
+          if (nextCol >= colCount) {
+            nextCol = 0;
+            nextRow++;
+          } else if (nextCol < 0) {
+            nextCol = colCount - 1;
+            nextRow--;
+          }
+          checked++;
+        }
+        const siblingRef = direction === 1 ? siblingTableRefs?.next?.current : siblingTableRefs?.prev?.current;
+        if (siblingRef) {
+          e.preventDefault();
+          store.clearEditing();
+          store.setSelection({ type: null, anchor: null, focus: null });
+          siblingRef.setAttribute("data-focus-direction", direction === 1 ? "down" : "up");
+          siblingRef.setAttribute("data-focus-trigger", "tab");
+          siblingRef.focus();
+          return;
+        }
+        if (store.getRowCount() > 0) {
+          e.preventDefault();
+          if (!bounds) {
+            const targetRow = direction === 1 ? 0 : store.getRowCount() - 1;
+            store.setSelection({
+              type: "range",
+              anchor: { row: targetRow, col: 0 },
+              focus: { row: targetRow, col: 0 }
+            });
+          }
+          return;
+        }
+        if (editing) {
+          store.clearEditing();
+        }
+        store.setSelection({ type: null, anchor: null, focus: null });
+        return;
+      }
+      if (!editing && ARROW_KEYS.includes(e.key)) {
+        e.preventDefault();
+        const rowCount = store.getRowCount();
+        if (rowCount === 0) return;
+        const selection = store.getSelection();
+        const jumpToEdge = e.ctrlKey || e.metaKey;
+        const seedSelection = () => {
+          const isForward = e.key === "ArrowDown" || e.key === "ArrowRight";
+          const targetRow = isForward ? 0 : rowCount - 1;
+          const targetCol = isForward ? 0 : colCount - 1;
+          store.setSelection({
+            type: "range",
+            anchor: { row: targetRow, col: targetCol },
+            focus: { row: targetRow, col: targetCol }
+          });
+        };
+        if (e.shiftKey) {
+          const { anchor, focus } = selection;
+          if (!anchor || !focus) {
+            seedSelection();
+            return;
+          }
+          const next = jumpToEdge ? findDataEdge(store, focus, colCount, e.key) : stepOne(focus, rowCount, colCount, e.key);
+          if (next.row === focus.row && next.col === focus.col) return;
+          store.setSelection({
+            // Row/column-header selections keep their shape while extending:
+            // `calcBounds` pins the other axis for those types, so a rowRange
+            // extended by Shift+Down stays a set of whole rows.
+            type: selection.type === "rowRange" || selection.type === "colRange" ? selection.type : "range",
+            anchor,
+            focus: next
+          });
+          return;
+        }
+        if (!bounds) {
+          seedSelection();
+          return;
+        }
+        const currentRow = Math.min(rowCount - 1, Math.max(
+          0,
+          selection.type === "colRange" ? bounds.startRow : selection.focus?.row ?? bounds.startRow
+        ));
+        const currentCol = Math.min(colCount - 1, Math.max(
+          0,
+          selection.type === "rowRange" ? bounds.startCol : selection.focus?.col ?? bounds.startCol
+        ));
+        const isRange = bounds.startRow !== bounds.endRow || bounds.startCol !== bounds.endCol;
+        let nextRow = currentRow;
+        let nextCol = currentCol;
+        if (jumpToEdge) {
+          const edge = findDataEdge(store, { row: currentRow, col: currentCol }, colCount, e.key);
+          nextRow = edge.row;
+          nextCol = edge.col;
+        } else if (e.key === "ArrowLeft") {
+          nextCol = Math.max(0, currentCol - 1);
+        } else if (e.key === "ArrowRight") {
+          nextCol = Math.min(colCount - 1, currentCol + 1);
+        } else if (e.key === "ArrowUp") {
+          if (currentRow === 0 && siblingTableRefs?.prev?.current) {
+            store.setSelection({ type: null, anchor: null, focus: null });
+            const target = siblingTableRefs.prev.current;
+            target.setAttribute("data-focus-direction", "up");
+            target.focus();
+            return;
+          }
+          nextRow = Math.max(0, currentRow - 1);
+        } else {
+          if (currentRow === rowCount - 1 && siblingTableRefs?.next?.current) {
+            store.setSelection({ type: null, anchor: null, focus: null });
+            const target = siblingTableRefs.next.current;
+            target.setAttribute("data-focus-direction", "down");
+            target.focus();
+            return;
+          }
+          nextRow = Math.min(rowCount - 1, currentRow + 1);
+        }
+        if (isRange || nextRow !== currentRow || nextCol !== currentCol) {
+          store.setSelection({
+            type: "range",
+            anchor: { row: nextRow, col: nextCol },
+            focus: { row: nextRow, col: nextCol }
+          });
+        }
+      }
+    },
+    [store, colCount, columns, autoEditOnTab, siblingTableRefs]
+  );
+  return handleKeyDown;
+}
+function useCopyHandler(store, tableRef, options) {
+  const { getFallbackText, onCopy } = options ?? {};
+  const handleCopy = useCallback(
+    (e) => {
+      if (tableRef?.current && e.target instanceof Node) {
+        if (!tableRef.current.contains(e.target)) {
+          return;
+        }
+      }
+      let text = null;
+      const cells = store.getCellsInSelection();
+      const bounds = store.getSelectionBounds();
+      const copiedRect = cells.length > 0 && bounds ? bounds : null;
+      if (cells.length > 0 && bounds) {
+        text = selectionToTsv(cells, bounds);
+      } else {
+        text = getFallbackText?.() ?? null;
+      }
+      if (text == null || text === "") return;
+      if (e.clipboardData) {
+        e.clipboardData.setData("text/plain", text);
+        e.preventDefault();
+        onCopy?.(copiedRect);
+      }
+    },
+    [store, tableRef, getFallbackText, onCopy]
+  );
+  return handleCopy;
+}
+const ROW_HEADER_WIDTH = 32;
+function useStickyOffsets(columns, store, rowHeaders) {
+  const widthRevision = store.getStoreRevision();
+  return useMemo(
+    () => computeStickyOffsets(columns, store, rowHeaders),
+    // `widthRevision` is the store-width dependency; it is read, not called.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [columns, store, rowHeaders, widthRevision]
+  );
+}
+function computeStickyOffsets(columns, store, rowHeaders) {
+  const leftOffsets = [];
+  const rightOffsets = [];
+  let leftOffset = rowHeaders ? ROW_HEADER_WIDTH : 0;
+  let rightOffset = 0;
+  columns.forEach((col, index) => {
+    const colWidth = store.getColumnWidth(index);
+    if (col.sticky === "left") {
+      leftOffsets[index] = leftOffset;
+      leftOffset += colWidth;
+    } else {
+      leftOffsets[index] = void 0;
+    }
+  });
+  const rightStickyCols = [];
+  columns.forEach((col, index) => {
+    if (col.sticky === "right") {
+      rightStickyCols.push({ index, width: store.getColumnWidth(index) });
+    }
+  });
+  rightStickyCols.reverse().forEach(({ index, width }) => {
+    rightOffsets[index] = rightOffset;
+    rightOffset += width;
+  });
+  columns.forEach((col, index) => {
+    if (col.sticky !== "right") {
+      rightOffsets[index] = void 0;
+    }
+  });
+  return { leftOffsets, rightOffsets };
+}
+function matchesShortcut(event, shortcut) {
+  if (event.key.toLowerCase() !== shortcut.key.toLowerCase()) return false;
+  const needsCtrlOrCmd = shortcut.ctrlOrCmd ?? false;
+  const hasCtrlOrCmd = event.ctrlKey || event.metaKey;
+  if (needsCtrlOrCmd !== hasCtrlOrCmd) return false;
+  const needsShift = shortcut.shift ?? false;
+  if (needsShift !== event.shiftKey) return false;
+  const needsAlt = shortcut.alt ?? false;
+  if (needsAlt !== event.altKey) return false;
+  return true;
+}
+function useRowActionShortcuts(store, shortcuts, onRowAction) {
+  const handleShortcut = useCallback(
+    (event) => {
+      if (!shortcuts?.rowActions?.length || !onRowAction) return false;
+      if (store.getEditingCell()) return false;
+      const bounds = store.getSelectionBounds();
+      if (!bounds) return false;
+      if (bounds.startRow !== bounds.endRow || bounds.startCol !== bounds.endCol) return false;
+      const rowIndex = bounds.startRow;
+      for (const shortcut of shortcuts.rowActions) {
+        if (matchesShortcut(event, shortcut)) {
+          event.preventDefault();
+          const rowData = store.getRowData(rowIndex);
+          onRowAction(shortcut.id, rowData, rowIndex);
+          return true;
+        }
+      }
+      return false;
+    },
+    [store, shortcuts, onRowAction]
+  );
+  return handleShortcut;
+}
+function useFilterSuggestions(options) {
+  const { entityType, enabled = true } = options;
+  const loadSuggestions = useMemo(() => {
+    if (!enabled || !entityType) return void 0;
+    return async (field, query) => {
+      try {
+        const params = new URLSearchParams({
+          entityId: entityType,
+          field,
+          query: query || ""
+        });
+        const result = await apiCall(
+          `/api/entities/filter-suggestions?${params.toString()}`,
+          { credentials: "include" }
+        );
+        if (!result.ok || !result.result) {
+          return [];
+        }
+        return result.result.items ?? [];
+      } catch (error) {
+        console.error("[useFilterSuggestions] Failed to fetch suggestions:", error);
+        return [];
+      }
+    };
+  }, [entityType, enabled]);
+  return loadSuggestions;
+}
+export {
+  CellStoreContext,
+  ROW_HEADER_WIDTH,
+  columnMountsEditor,
+  computeStickyOffsets,
+  findDataEdge,
+  useCellState,
+  useCellStore,
+  useCopyHandler,
+  useDragHandling,
+  useFilterSuggestions,
+  useKeyboardNavigation,
+  useRowActionShortcuts,
+  useSelection,
+  useSelectionRevision,
+  useStickyOffsets,
+  useStoreRevision
+};
+//# sourceMappingURL=index.js.map

package/dist/backend/dynamic-table/hooks/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/hooks/index.ts"],
+  "sourcesContent": ["// hooks.ts\n\nimport React, { useCallback, useContext, useSyncExternalStore, createContext, useMemo } from 'react';\nimport { CellStore } from '../store/index';\nimport { CellState, ColumnDef, DragState, SelectionBounds, SelectionState, LoadFilterSuggestions, KeyboardShortcutsConfig, OnRowAction, RowActionShortcut } from '../types/index';\nimport { apiCall } from '../../utils/apiCall';\nimport { selectionToTsv } from '../utils/clipboard';\n\n// ============================================\n// CONTEXT\n// ============================================\nexport const CellStoreContext = createContext<CellStore | null>(null);\n\nexport const useCellStore = (): CellStore => {\n  const store = useContext(CellStoreContext);\n  if (!store) {\n    throw new Error('useCellStore must be used within CellStoreContext.Provider');\n  }\n  return store;\n};\n\n// ============================================\n// STORE REVISION HOOK (triggers re-render on row add/remove)\n// ============================================\nexport function useStoreRevision(): number {\n  const store = useCellStore();\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => store.subscribeToStore(onStoreChange),\n    [store]\n  );\n\n  const getSnapshot = useCallback(() => store.getStoreRevision(), [store]);\n  const getServerSnapshot = useCallback(() => 0, []); // Return default value for SSR\n\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n\n// ============================================\n// CELL STATE HOOK\n// ============================================\nexport function useCellState(row: number, col: number): CellState {\n  const store = useCellStore();\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => store.subscribe(row, col, onStoreChange),\n    [store, row, col]\n  );\n\n  const getSnapshot = useCallback(() => store.getRevision(row, col), [store, row, col]);\n  const getServerSnapshot = useCallback(() => 0, []); // Return default value for SSR\n\n  // This triggers re-render when revision changes\n  useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n\n  // Return fresh state on each render\n  return store.getCellState(row, col);\n}\n\n// ============================================\n// SELECTION REVISION HOOK (triggers re-render on selection change)\n// ============================================\nexport function useSelectionRevision(): number {\n  const store = useCellStore();\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => store.subscribeToSelection(onStoreChange),\n    [store]\n  );\n\n  const getSnapshot = useCallback(() => store.getSelectionRevision(), [store]);\n  const getServerSnapshot = useCallback(() => 0, []); // Return default value for SSR\n\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n\n// ============================================\n// SELECTION HOOK (for components that need selection without cell subscription)\n// ============================================\nexport function useSelection(): SelectionState {\n  const store = useCellStore();\n  // Subscribe to selection changes so component re-renders\n  useSelectionRevision();\n  return store.getSelection();\n}\n\n// ============================================\n// DRAG HANDLING HOOK\n// ============================================\nexport function useDragHandling(\n  store: CellStore,\n  colCount: number\n): {\n  dragState: React.MutableRefObject<DragState>;\n  handleDragStart: (row: number, col: number, type: 'cell' | 'row' | 'column') => void;\n  handleDragMove: (row: number, col: number) => void;\n  handleDragEnd: () => void;\n} {\n  const dragState = { current: { isDragging: false, type: null, start: null } as DragState };\n\n  const handleDragStart = useCallback(\n    (row: number, col: number, type: 'cell' | 'row' | 'column') => {\n      dragState.current = {\n        isDragging: true,\n        type,\n        start: { row, col },\n      };\n\n      if (type === 'row') {\n        store.setSelection({\n          type: 'rowRange',\n          anchor: { row, col: 0 },\n          focus: { row, col: colCount - 1 },\n        });\n      } else if (type === 'column') {\n        store.setSelection({\n          type: 'colRange',\n          anchor: { row: 0, col },\n          focus: { row: store.getRowCount() - 1, col },\n        });\n      } else {\n        store.setSelection({\n          type: 'range',\n          anchor: { row, col },\n          focus: { row, col },\n        });\n      }\n    },\n    [store, colCount]\n  );\n\n  const handleDragMove = useCallback(\n    (row: number, col: number) => {\n      if (!dragState.current.isDragging || !dragState.current.start) return;\n\n      const selection = store.getSelection();\n      if (!selection.anchor) return;\n\n      if (dragState.current.type === 'row') {\n        store.setSelection({\n          ...selection,\n          focus: { row, col: colCount - 1 },\n        });\n      } else if (dragState.current.type === 'column') {\n        store.setSelection({\n          ...selection,\n          focus: { row: store.getRowCount() - 1, col },\n        });\n      } else {\n        store.setSelection({\n          ...selection,\n          focus: { row, col },\n        });\n      }\n    },\n    [store, colCount]\n  );\n\n  const handleDragEnd = useCallback(() => {\n    dragState.current = { isDragging: false, type: null, start: null };\n  }, []);\n\n  return {\n    dragState,\n    handleDragStart,\n    handleDragMove,\n    handleDragEnd,\n  };\n}\n\n// ============================================\n// CELL EDITABILITY HELPER\n// ============================================\n\n/**\n * Determines if a cell is editable based on column configuration.\n * Used by keyboard navigation to skip read-only cells.\n */\nfunction isEditableCell(column: ColumnDef | undefined): boolean {\n  if (!column) return false;\n  if (column.readOnly === true) return false;\n  return true;\n}\n\n/**\n * Will an editor actually MOUNT for this column?\n *\n * This is the precondition for `setEditingCell`, and it is deliberately not the\n * same question as `isEditableCell`: `getCellEditor` (components/editors.tsx)\n * lets a custom `col.editor` win over `readOnly`, and returns `null` for a\n * read-only column without one.\n *\n * Opening an edit session that mounts no editor is a SOFT LOCK, not a cosmetic\n * bug: `Cell` renders the editor branch and so paints nothing (the cell goes\n * blank), while the store now reports an editing cell \u2014 which makes every arrow\n * key fall through the `!editing` guard below and do nothing. The user is stuck\n * on an invisible cell with no way out but Escape. Ledger row 1.27.\n */\nexport function columnMountsEditor(column: ColumnDef | undefined): boolean {\n  if (!column) return false;\n  if (typeof column.editor === 'function') return true;\n  return column.readOnly !== true;\n}\n\n// ============================================\n// ARROW-KEY GEOMETRY\n// ============================================\n\nexport type CellCoord = { row: number; col: number };\n\nconst ARROW_KEYS = ['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight'];\n\n/** Unit step for an arrow key. */\nfunction arrowDelta(key: string): { dRow: number; dCol: number } {\n  switch (key) {\n    case 'ArrowUp': return { dRow: -1, dCol: 0 };\n    case 'ArrowDown': return { dRow: 1, dCol: 0 };\n    case 'ArrowLeft': return { dRow: 0, dCol: -1 };\n    default: return { dRow: 0, dCol: 1 };\n  }\n}\n\nfunction isBlankValue(value: unknown): boolean {\n  return value === null || value === undefined || value === '';\n}\n\n/**\n * Excel's `Ctrl`+Arrow target: the edge of the current data block.\n *\n * - Neighbour has data \u2192 land on the LAST cell before the next blank.\n * - Neighbour is blank \u2192 skip the blank run and land on the FIRST cell with data.\n * - Either way, stop at the table edge.\n *\n * Pure index arithmetic over `store.getCellValue(row, col)` \u2014 which is a\n * projection off the row objects, so this answers for columns that are not\n * mounted (column virtualization is live on `/backend/invoicing`). It never\n * queries the DOM, per the range-operation contract.\n */\nexport function findDataEdge(\n  store: Pick<CellStore, 'getCellValue' | 'getRowCount'>,\n  from: CellCoord,\n  colCount: number,\n  key: string,\n): CellCoord {\n  const { dRow, dCol } = arrowDelta(key);\n  const rowCount = store.getRowCount();\n  const inside = (r: number, c: number) => r >= 0 && r < rowCount && c >= 0 && c < colCount;\n  const blank = (r: number, c: number) => isBlankValue(store.getCellValue(r, c));\n\n  let { row, col } = from;\n  if (!inside(row + dRow, col + dCol)) return { row, col };\n\n  const crossingBlankRun = blank(row + dRow, col + dCol);\n  row += dRow;\n  col += dCol;\n\n  while (inside(row + dRow, col + dCol)) {\n    if (crossingBlankRun ? !blank(row, col) : blank(row + dRow, col + dCol)) break;\n    row += dRow;\n    col += dCol;\n  }\n  return { row, col };\n}\n\n/** One clamped step from `from` in the arrow's direction. */\nfunction stepOne(from: CellCoord, rowCount: number, colCount: number, key: string): CellCoord {\n  const { dRow, dCol } = arrowDelta(key);\n  return {\n    row: Math.min(rowCount - 1, Math.max(0, from.row + dRow)),\n    col: Math.min(colCount - 1, Math.max(0, from.col + dCol)),\n  };\n}\n\n// ============================================\n// KEYBOARD NAVIGATION HOOK\n// ============================================\nexport function useKeyboardNavigation(\n  store: CellStore,\n  colCount: number,\n  columns: ColumnDef[],\n  autoEditOnTab: boolean = true,\n  // Note: onSave parameter kept for backwards compatibility but editors now save before navigation\n  _onSave?: (row: number, col: number, value: any) => void,\n  siblingTableRefs?: {\n    prev?: React.RefObject<HTMLDivElement | null>;\n    next?: React.RefObject<HTMLDivElement | null>;\n  }\n) {\n  const handleKeyDown = useCallback(\n    (e: KeyboardEvent) => {\n      // Note: This handler should be attached to the table element (not document)\n      // so it only receives events from within the table\n\n      const editing = store.getEditingCell();\n      const bounds = store.getSelectionBounds();\n\n      // Enter navigation - when editing, move down (Excel-like behavior)\n      // Note: Editors save the value before the event bubbles here\n      if (e.key === 'Enter' && !e.shiftKey && editing) {\n        e.preventDefault();\n\n        const currentRow = editing.row;\n        const currentCol = editing.col;\n\n        // Move to next row (down), same column\n        const nextRow = currentRow + 1;\n\n        if (nextRow < store.getRowCount()) {\n          store.clearEditing();\n          store.setSelection({\n            type: 'range',\n            anchor: { row: nextRow, col: currentCol },\n            focus: { row: nextRow, col: currentCol },\n          });\n          store.setEditingCell(nextRow, currentCol);\n        } else {\n          // At the last row, clear editing and restore focus to the table\n          // container so subsequent Tab/Arrow keys still reach this handler.\n          store.clearEditing();\n          store.focusTable();\n        }\n        return;\n      }\n\n      // Enter to start editing (when not already editing)\n      // Note: Shift+Enter is reserved for row-action shortcuts (e.g., open detail view)\n      if (e.key === 'Enter' && !e.shiftKey && !editing && bounds) {\n        if (bounds.startRow === bounds.endRow && bounds.startCol === bounds.endCol) {\n          e.preventDefault();\n          // A column that mounts no editor is a NO-OP, never an edit session.\n          // Without this guard the store reports an editing cell that renders\n          // nothing, the cell goes blank and every arrow key below is swallowed\n          // by the `!editing` guard \u2014 the grid soft-locks. Ledger row 1.27.\n          // The user-facing \"this column is read-only\" hint is raised one rung\n          // up, in `DynamicTable`, which owns `flash` and the translations.\n          if (!columnMountsEditor(columns[bounds.startCol])) return;\n          store.setEditingCell(bounds.startRow, bounds.startCol);\n          return;\n        }\n      }\n\n      // Escape: two-step behavior\n      // 1st Escape while editing: exit edit mode without saving, keep cell selected\n      // 2nd Escape (cell selected, not editing): clear selection, keep table focused\n      // 3rd Escape (no selection, no editing): do nothing \u2014 let the event bubble\n      //     to parent handlers (e.g., drawer close)\n      if (e.key === 'Escape') {\n        if (editing) {\n          e.preventDefault();\n          store.clearEditing();\n        } else if (bounds) {\n          e.preventDefault();\n          store.setSelection({ type: null, anchor: null, focus: null });\n        }\n        // If neither editing nor selection, don't preventDefault \u2014\n        // let the event propagate so the parent (drawer) can handle it.\n        return;\n      }\n\n      // Tab navigation - move to next/prev editable cell, skipping read-only columns\n      // Wraps across rows. When no editable cell remains in the table,\n      // clears state and lets native Tab move focus to the next focusable element.\n      // Note: Editors save the value before the event bubbles here\n      if (e.key === 'Tab') {\n        const direction = e.shiftKey ? -1 : 1;\n        let currentRow: number;\n        let currentCol: number;\n\n        if (editing) {\n          currentRow = editing.row;\n          currentCol = editing.col;\n        } else if (bounds && bounds.startRow === bounds.endRow && bounds.startCol === bounds.endCol) {\n          currentRow = bounds.startRow;\n          currentCol = bounds.startCol;\n        } else {\n          // No selection yet \u2014 seed position so the search loop finds the\n          // first editable cell (forward Tab) or last editable cell (Shift+Tab).\n          // For forward: start at (0, -1) so +1 direction lands on col 0, row 0.\n          // For backward: start at (lastRow, colCount) so -1 lands on last col, last row.\n          const rowCount = store.getRowCount();\n          if (rowCount === 0) return;\n          currentRow = direction === 1 ? 0 : rowCount - 1;\n          currentCol = direction === 1 ? -1 : colCount;\n        }\n\n        const rowCount = store.getRowCount();\n        const totalCells = rowCount * colCount;\n        let nextCol = currentCol + direction;\n        let nextRow = currentRow;\n        let checked = 0;\n\n        // Wrap column and row boundaries\n        if (nextCol >= colCount) {\n          nextCol = 0;\n          nextRow++;\n        } else if (nextCol < 0) {\n          nextCol = colCount - 1;\n          nextRow--;\n        }\n\n        // Search for the next editable cell, wrapping across rows\n        while (checked < totalCells) {\n          if (nextRow < 0 || nextRow >= rowCount) break;\n\n          if (isEditableCell(columns[nextCol])) {\n            e.preventDefault();\n            store.clearEditing();\n            store.setSelection({\n              type: 'range',\n              anchor: { row: nextRow, col: nextCol },\n              focus: { row: nextRow, col: nextCol },\n            });\n            if (autoEditOnTab) {\n              store.setEditingCell(nextRow, nextCol);\n            }\n            return;\n          }\n\n          // Move to next candidate\n          nextCol += direction;\n          if (nextCol >= colCount) {\n            nextCol = 0;\n            nextRow++;\n          } else if (nextCol < 0) {\n            nextCol = colCount - 1;\n            nextRow--;\n          }\n          checked++;\n        }\n\n        // No editable cell found forward/backward in this table.\n        // Before trapping Tab, check if a sibling table exists in the\n        // Tab direction so the user can navigate across stacked tables.\n        const siblingRef = direction === 1\n          ? siblingTableRefs?.next?.current\n          : siblingTableRefs?.prev?.current;\n\n        if (siblingRef) {\n          e.preventDefault();\n          store.clearEditing();\n          store.setSelection({ type: null, anchor: null, focus: null });\n          siblingRef.setAttribute('data-focus-direction', direction === 1 ? 'down' : 'up');\n          siblingRef.setAttribute('data-focus-trigger', 'tab');\n          siblingRef.focus();\n          return;\n        }\n\n        // No sibling table \u2014 fall back to existing behaviour:\n        // trap Tab for non-empty tables, let native Tab escape for empty ones.\n        if (store.getRowCount() > 0) {\n          e.preventDefault();\n          if (!bounds) {\n            const targetRow = direction === 1 ? 0 : store.getRowCount() - 1;\n            store.setSelection({\n              type: 'range',\n              anchor: { row: targetRow, col: 0 },\n              focus: { row: targetRow, col: 0 },\n            });\n          }\n          return;\n        }\n        if (editing) {\n          store.clearEditing();\n        }\n        store.setSelection({ type: null, anchor: null, focus: null });\n        return;\n      }\n\n      // Arrow navigation (only when not editing)\n      // Arrows move to the adjacent cell (including read-only cells).\n      // Read-only skipping only applies to Tab navigation.\n      // ArrowUp at first row / ArrowDown at last row can move to sibling tables.\n      //\n      // Modifiers, Excel-exact:\n      //   Arrow             move one cell and RESET the anchor\n      //   Shift+Arrow       EXTEND the range from the stable anchor\n      //   Ctrl/Cmd+Arrow    move to the edge of the data block\n      //   Ctrl/Cmd+Shift+Arrow   extend to the edge of the data block\n      if (!editing && ARROW_KEYS.includes(e.key)) {\n        e.preventDefault();\n\n        const rowCount = store.getRowCount();\n        if (rowCount === 0) return;\n\n        const selection = store.getSelection();\n        const jumpToEdge = e.ctrlKey || e.metaKey;\n\n        // Seeded when there is nothing to move or extend from. ArrowDown/Right\n        // seed the first cell, ArrowUp/Left the last \u2014 including for Shift,\n        // whose first press then has an anchor for the second to grow from.\n        const seedSelection = () => {\n          const isForward = e.key === 'ArrowDown' || e.key === 'ArrowRight';\n          const targetRow = isForward ? 0 : rowCount - 1;\n          const targetCol = isForward ? 0 : colCount - 1;\n          store.setSelection({\n            type: 'range',\n            anchor: { row: targetRow, col: targetCol },\n            focus: { row: targetRow, col: targetCol },\n          });\n        };\n\n        // ---- Shift+Arrow: grow or shrink against the anchor ----\n        // The anchor NEVER moves here; only the focus does, so pressing\n        // Shift+Down four times then Shift+Up twice leaves a 3-row range \u2014\n        // extension is reversible, which \"move the whole selection\" is not.\n        if (e.shiftKey) {\n          const { anchor, focus } = selection;\n          if (!anchor || !focus) {\n            seedSelection();\n            return;\n          }\n          const next = jumpToEdge\n            ? findDataEdge(store, focus, colCount, e.key)\n            : stepOne(focus, rowCount, colCount, e.key);\n          if (next.row === focus.row && next.col === focus.col) return;\n          store.setSelection({\n            // Row/column-header selections keep their shape while extending:\n            // `calcBounds` pins the other axis for those types, so a rowRange\n            // extended by Shift+Down stays a set of whole rows.\n            type: selection.type === 'rowRange' || selection.type === 'colRange'\n              ? selection.type\n              : 'range',\n            anchor,\n            focus: next,\n          });\n          return;\n        }\n\n        if (!bounds) {\n          seedSelection();\n          return;\n        }\n\n        // The cursor is the FOCUS, not the top-left: after Shift+Down\u00D73 a plain\n        // ArrowDown must continue from where the extension ended, not jump back\n        // to the anchor. For whole-row/column selections the pinned axis has no\n        // meaningful focus, so it collapses onto the bounds' start instead.\n        const currentRow = Math.min(rowCount - 1, Math.max(0,\n          selection.type === 'colRange' ? bounds.startRow : (selection.focus?.row ?? bounds.startRow)));\n        const currentCol = Math.min(colCount - 1, Math.max(0,\n          selection.type === 'rowRange' ? bounds.startCol : (selection.focus?.col ?? bounds.startCol)));\n        const isRange = bounds.startRow !== bounds.endRow || bounds.startCol !== bounds.endCol;\n        let nextRow = currentRow;\n        let nextCol = currentCol;\n\n        if (jumpToEdge) {\n          const edge = findDataEdge(store, { row: currentRow, col: currentCol }, colCount, e.key);\n          nextRow = edge.row;\n          nextCol = edge.col;\n        } else if (e.key === 'ArrowLeft') {\n          nextCol = Math.max(0, currentCol - 1);\n        } else if (e.key === 'ArrowRight') {\n          nextCol = Math.min(colCount - 1, currentCol + 1);\n        } else if (e.key === 'ArrowUp') {\n          if (currentRow === 0 && siblingTableRefs?.prev?.current) {\n            // At first row \u2014 move to previous sibling table (select last row)\n            store.setSelection({ type: null, anchor: null, focus: null });\n            const target = siblingTableRefs.prev.current;\n            target.setAttribute('data-focus-direction', 'up');\n            target.focus();\n            return;\n          }\n          nextRow = Math.max(0, currentRow - 1);\n        } else {\n          if (currentRow === rowCount - 1 && siblingTableRefs?.next?.current) {\n            // At last row \u2014 move to next sibling table (select first row)\n            store.setSelection({ type: null, anchor: null, focus: null });\n            const target = siblingTableRefs.next.current;\n            target.setAttribute('data-focus-direction', 'down');\n            target.focus();\n            return;\n          }\n          nextRow = Math.min(rowCount - 1, currentRow + 1);\n        }\n\n        // Write when the position changed OR when a range has to collapse \u2014\n        // a plain arrow always ends with exactly one cell selected.\n        if (isRange || nextRow !== currentRow || nextCol !== currentCol) {\n          store.setSelection({\n            type: 'range',\n            anchor: { row: nextRow, col: nextCol },\n            focus: { row: nextRow, col: nextCol },\n          });\n        }\n      }\n    },\n    [store, colCount, columns, autoEditOnTab, siblingTableRefs]\n  );\n\n  return handleKeyDown;\n}\n\n// ============================================\n// COPY HANDLER HOOK\n// ============================================\nexport interface CopyHandlerOptions {\n  /**\n   * Fallback text to copy when there is NO cell-range selection \u2014 e.g. when only\n   * checkbox row-selection is active. Return `null`/`''` to copy nothing.\n   */\n  getFallbackText?: () => string | null;\n  /**\n   * Called after a successful copy (cell-range OR fallback) \u2014 e.g. to flash.\n   *\n   * Receives the copied RECTANGLE, or `null` when the copy came from the\n   * checkbox-row fallback and therefore has no cell range. The marching-ants\n   * marker needs it: it can only be drawn around a rectangle, and it must not\n   * be invented for a row selection that has none.\n   */\n  onCopy?: (bounds: SelectionBounds | null) => void;\n}\n\nexport function useCopyHandler(\n  store: CellStore,\n  tableRef?: React.RefObject<HTMLDivElement | null>,\n  options?: CopyHandlerOptions\n) {\n  const { getFallbackText, onCopy } = options ?? {};\n  const handleCopy = useCallback(\n    (e: ClipboardEvent) => {\n      // Only intercept copy if the event target is inside this table\n      // This allows text selection in drawers/dialogs to work normally\n      if (tableRef?.current && e.target instanceof Node) {\n        if (!tableRef.current.contains(e.target)) {\n          return;\n        }\n      }\n\n      let text: string | null = null;\n      const cells = store.getCellsInSelection();\n      const bounds = store.getSelectionBounds();\n      const copiedRect = cells.length > 0 && bounds ? bounds : null;\n\n      if (cells.length > 0 && bounds) {\n        // Cell-range selection \u2192 TSV block, through THE shared serializer so\n        // Ctrl+C and Ctrl+X can never disagree about what was on the clipboard.\n        text = selectionToTsv(cells, bounds);\n      } else {\n        // No cell-range \u2192 fall back to checkbox row-selection (if provided).\n        text = getFallbackText?.() ?? null;\n      }\n\n      if (text == null || text === '') return;\n\n      if (e.clipboardData) {\n        e.clipboardData.setData('text/plain', text);\n        e.preventDefault();\n        onCopy?.(copiedRect);\n      }\n    },\n    [store, tableRef, getFallbackText, onCopy]\n  );\n\n  return handleCopy;\n}\n\n// ============================================\n// STICKY OFFSETS HOOK\n// ============================================\n/**\n * Rendered width of the row-header (checkbox) column. The header/body cells\n * declare an inline `width: 50`, but the v2 theme's\n * `.hot-container .hot-row-header { max-width: 32px }` clamps the actual box to\n * 32px \u2014 so sticky-left offsets (frozen columns, pinned columns) MUST start at\n * 32, not 50. Mismatching this leaves an 18px gap to the left of the first\n * pinned column.\n */\nexport const ROW_HEADER_WIDTH = 32;\n\nexport function useStickyOffsets(\n  columns: { sticky?: 'left' | 'right'; width?: number }[],\n  store: CellStore,\n  rowHeaders: boolean\n): StickyOffsets {\n  // Widths live in the store, so a resize is observed through the store\n  // revision rather than by recomputing on every render. Memoising matters:\n  // these two arrays are passed straight into every `VirtualRow`, and a fresh\n  // array identity per render defeats the row's `React.memo` on its own \u2014\n  // before any handler prop gets a chance to (anchor Defect 5).\n  const widthRevision = store.getStoreRevision();\n  return useMemo(\n    () => computeStickyOffsets(columns, store, rowHeaders),\n    // `widthRevision` is the store-width dependency; it is read, not called.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [columns, store, rowHeaders, widthRevision],\n  );\n}\n\nexport interface StickyOffsets {\n  leftOffsets: (number | undefined)[];\n  rightOffsets: (number | undefined)[];\n}\n\n/**\n * Pure sticky-offset arithmetic. Widths come from the STORE (not from the\n * column objects handed in), which is what makes a manual resize move the\n * pinned columns with it. Walks EVERY column \u2014 offsets for a pinned column are\n * relative to all its predecessors, so this must never be narrowed to a\n * virtualization window.\n */\nexport function computeStickyOffsets(\n  columns: { sticky?: 'left' | 'right'; width?: number }[],\n  store: CellStore,\n  rowHeaders: boolean,\n): StickyOffsets {\n  const leftOffsets: (number | undefined)[] = [];\n  const rightOffsets: (number | undefined)[] = [];\n\n  let leftOffset = rowHeaders ? ROW_HEADER_WIDTH : 0;\n  let rightOffset = 0;\n\n  // Calculate left sticky offsets\n  columns.forEach((col, index) => {\n    const colWidth = store.getColumnWidth(index);\n\n    if (col.sticky === 'left') {\n      leftOffsets[index] = leftOffset;\n      leftOffset += colWidth;\n    } else {\n      leftOffsets[index] = undefined;\n    }\n  });\n\n  // Calculate right sticky offsets (need to go backwards)\n  const rightStickyCols: { index: number; width: number }[] = [];\n  columns.forEach((col, index) => {\n    if (col.sticky === 'right') {\n      rightStickyCols.push({ index, width: store.getColumnWidth(index) });\n    }\n  });\n\n  rightStickyCols.reverse().forEach(({ index, width }) => {\n    rightOffsets[index] = rightOffset;\n    rightOffset += width;\n  });\n\n  // Fill undefined for non-sticky columns\n  columns.forEach((col, index) => {\n    if (col.sticky !== 'right') {\n      rightOffsets[index] = undefined;\n    }\n  });\n\n  return { leftOffsets, rightOffsets };\n}\n\n// ============================================\n// ROW ACTION SHORTCUTS HOOK\n// ============================================\n\n/**\n * Checks if a keyboard event matches a shortcut definition.\n */\nfunction matchesShortcut(event: KeyboardEvent, shortcut: RowActionShortcut): boolean {\n  if (event.key.toLowerCase() !== shortcut.key.toLowerCase()) return false;\n\n  const needsCtrlOrCmd = shortcut.ctrlOrCmd ?? false;\n  const hasCtrlOrCmd = event.ctrlKey || event.metaKey;\n  if (needsCtrlOrCmd !== hasCtrlOrCmd) return false;\n\n  const needsShift = shortcut.shift ?? false;\n  if (needsShift !== event.shiftKey) return false;\n\n  const needsAlt = shortcut.alt ?? false;\n  if (needsAlt !== event.altKey) return false;\n\n  return true;\n}\n\n/**\n * Hook that returns a keydown handler for row-level keyboard shortcuts.\n * Shortcuts only fire when:\n * - A single cell is selected (not a range)\n * - Not currently editing a cell\n * - Not holding unexpected modifiers\n *\n * @returns A handler that should be called from the table's keydown handler.\n *          Returns true if a shortcut matched (caller should stop further processing).\n */\nexport function useRowActionShortcuts(\n  store: CellStore,\n  shortcuts?: KeyboardShortcutsConfig,\n  onRowAction?: OnRowAction\n) {\n  const handleShortcut = useCallback(\n    (event: KeyboardEvent): boolean => {\n      if (!shortcuts?.rowActions?.length || !onRowAction) return false;\n\n      // Only fire when not editing\n      if (store.getEditingCell()) return false;\n\n      // Only fire with a single-cell selection\n      const bounds = store.getSelectionBounds();\n      if (!bounds) return false;\n      if (bounds.startRow !== bounds.endRow || bounds.startCol !== bounds.endCol) return false;\n\n      const rowIndex = bounds.startRow;\n\n      for (const shortcut of shortcuts.rowActions) {\n        if (matchesShortcut(event, shortcut)) {\n          event.preventDefault();\n          const rowData = store.getRowData(rowIndex);\n          onRowAction(shortcut.id, rowData, rowIndex);\n          return true;\n        }\n      }\n\n      return false;\n    },\n    [store, shortcuts, onRowAction]\n  );\n\n  return handleShortcut;\n}\n\n// ============================================\n// FILTER SUGGESTIONS HOOK\n// ============================================\n\nexport interface UseFilterSuggestionsOptions {\n  /**\n   * The entity type to fetch suggestions for.\n   * Must be a valid entity ID (e.g., 'catalog:products', 'customers:people')\n   */\n  entityType: string;\n  /**\n   * Whether the hook is enabled. When false, returns undefined.\n   * Useful for conditionally enabling server-side suggestions.\n   * @default true\n   */\n  enabled?: boolean;\n}\n\n/**\n * Hook that returns a LoadFilterSuggestions function for use with DynamicTable.\n * Fetches filter suggestions from the server API for large datasets.\n *\n * @example\n * ```tsx\n * function ProductsTable() {\n *   const loadFilterSuggestions = useFilterSuggestions({\n *     entityType: 'catalog:products'\n *   });\n *\n *   return (\n *     <DynamicTable\n *       // ... other props\n *       loadFilterSuggestions={loadFilterSuggestions}\n *     />\n *   );\n * }\n * ```\n */\nexport function useFilterSuggestions(\n  options: UseFilterSuggestionsOptions\n): LoadFilterSuggestions | undefined {\n  const { entityType, enabled = true } = options;\n\n  const loadSuggestions = useMemo<LoadFilterSuggestions | undefined>(() => {\n    if (!enabled || !entityType) return undefined;\n\n    return async (field: string, query: string): Promise<string[]> => {\n      try {\n        const params = new URLSearchParams({\n          entityId: entityType,\n          field,\n          query: query || '',\n        });\n\n        const result = await apiCall<{ items: string[] }>(\n          `/api/entities/filter-suggestions?${params.toString()}`,\n          { credentials: 'include' }\n        );\n\n        if (!result.ok || !result.result) {\n          return [];\n        }\n\n        return result.result.items ?? [];\n      } catch (error) {\n        console.error('[useFilterSuggestions] Failed to fetch suggestions:', error);\n        return [];\n      }\n    };\n  }, [entityType, enabled]);\n\n  return loadSuggestions;\n}\n"],
+  "mappings": "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",
+  "names": ["rowCount"]
+}

package/dist/backend/dynamic-table/hooks/useAbbreviations.js

@@ -0,0 +1,19 @@
+"use client";
+import * as React from "react";
+import { abbreviationsVersion, subscribeAbbreviations } from "../utils/abbreviations.js";
+function getServerSnapshot() {
+  return 0;
+}
+function useAbbreviationsVersion() {
+  return React.useSyncExternalStore(
+    subscribeAbbreviations,
+    abbreviationsVersion,
+    getServerSnapshot
+  );
+}
+var useAbbreviations_default = useAbbreviationsVersion;
+export {
+  useAbbreviations_default as default,
+  useAbbreviationsVersion
+};
+//# sourceMappingURL=useAbbreviations.js.map

package/dist/backend/dynamic-table/hooks/useAbbreviations.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/hooks/useAbbreviations.ts"],
+  "sourcesContent": ["'use client'\n\n/**\n * DynamicTable \u2014 ABBREVIATION DICTIONARY SUBSCRIPTION\n * \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n *\n * `utils/abbreviations.ts` is a process-local registry populated ONCE at app\n * boot from the `facilities` and `contractors` tables. That import order is the\n * whole problem this file exists to solve:\n *\n *   1. the grid mounts and renders every cell \u2014 dictionary still empty,\n *   2. the boot fetch resolves and `registerAbbreviations` fills the registry,\n *   3. \u2026and nothing re-renders, so the user keeps looking at \"Port Gda\u0144sk\"\n *      until they happen to sort, filter or page.\n *\n * The registry's own doc says consumers \"must include `abbreviationsVersion()`\n * in their dependency list\", but a plain module-level integer is not something\n * React can observe \u2014 reading it inside a `useMemo` captures whatever it was at\n * mount and never notices the bump. `useSyncExternalStore` is the correct\n * primitive: `subscribeAbbreviations` is the subscribe half, and\n * `abbreviationsVersion` is the snapshot half.\n *\n * \u2500\u2500 Usage \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n * Put the returned number in the dependency list of whatever memoizes derived\n * label output \u2014 the column definitions, a precomputed initials index:\n *\n *     const abbrevVersion = useAbbreviationsVersion()\n *     const columns = React.useMemo(() => buildColumns(), [cfg, abbrevVersion])\n *\n * \u2500\u2500 Why the version and not the dictionary itself \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n * The renderers read the registry directly at render time (one `Map.get`), so\n * they never need the dictionary threaded through props. All that is missing is\n * the SIGNAL that a re-render is now worth doing, and an integer is the\n * cheapest possible carrier for it \u2014 it changes at most twice in the lifetime\n * of a page, so nothing downstream is re-computed on any other pass.\n *\n * \u2500\u2500 SSR \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n * The server snapshot is a constant `0` rather than `abbreviationsVersion()`.\n * On the server the registry only ever holds the static seed, and returning a\n * value that could differ between the server render and the client's first\n * render is precisely the hydration mismatch `getServerSnapshot` exists to\n * prevent.\n * \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n */\n\nimport * as React from 'react'\n\nimport { abbreviationsVersion, subscribeAbbreviations } from '../utils/abbreviations'\n\n/** Constant across every server render \u2014 see the SSR note above. */\nfunction getServerSnapshot(): number {\n  return 0\n}\n\n/**\n * The current abbreviation-dictionary version, re-rendering the caller whenever\n * a dictionary is registered.\n */\nexport function useAbbreviationsVersion(): number {\n  return React.useSyncExternalStore(\n    subscribeAbbreviations,\n    abbreviationsVersion,\n    getServerSnapshot,\n  )\n}\n\nexport default useAbbreviationsVersion\n"],
+  "mappings": ";AA6CA,YAAY,WAAW;AAEvB,SAAS,sBAAsB,8BAA8B;AAG7D,SAAS,oBAA4B;AACnC,SAAO;AACT;AAMO,SAAS,0BAAkC;AAChD,SAAO,MAAM;AAAA,IACX;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,IAAO,2BAAQ;",
+  "names": []
+}