@rowsncolumns/spreadsheet-state 29.0.0 → 29.1.0

package/dist/cjs/api/sort.js

@@ -1,8 +1,40 @@
 import { isNil } from "@rowsncolumns/utils";
+/**
+ * The text order both engines sort with: case- and accent-insensitive,
+ * digit runs by numeric value ("a2" < "a10"). `rnc_cellmodel::collate_text`
+ * is its Rust twin.
+ */
 var comparator = new Intl.Collator("en", {
     numeric: true,
     sensitivity: "base",
 }).compare;
+export var isSortErrorValue = function (value) {
+    return typeof value === "object" && value !== null && "sortError" in value;
+};
+/**
+ * The value a sort compares for a cell: its error when it has one, else the
+ * effective value, else the display text.
+ */
+export var getCellSortValue = function (cell) {
+    var _a, _b;
+    return cell.error
+        ? { sortError: (_a = cell.formattedValue) !== null && _a !== void 0 ? _a : "" }
+        : ((_b = cell.getEffectiveValue()) !== null && _b !== void 0 ? _b : cell.formattedValue);
+};
+/** Excel's ascending order of value types: numbers < text < logicals < errors. */
+var tierOf = function (value) {
+    return typeof value === "number"
+        ? 0
+        : typeof value === "string"
+            ? 1
+            : typeof value === "boolean"
+                ? 2
+                : 3;
+};
+/**
+ * Excel's sort order: numbers < text < logicals < errors, blanks last in
+ * BOTH directions, text compared case-insensitively through the collator.
+ */
 export var cellValueSorter = function (left, right, sortOrder) {
     var isEmpty = function (value) {
         if (isNil(value)) {
@@ -12,7 +44,7 @@ export var cellValueSorter = function (left, right, sortOrder) {
     };
     var leftEmpty = isEmpty(left);
     var rightEmpty = isEmpty(right);
-    // Ignore empty rows
+    // Blanks stay last regardless of direction.
     if (leftEmpty && rightEmpty) {
         return 0;
     }
@@ -22,12 +54,26 @@ export var cellValueSorter = function (left, right, sortOrder) {
     if (rightEmpty) {
         return -1;
     }
-    var isNumbers = typeof left === "number" && typeof right === "number";
-    var comparisonResult = isNumbers
-        ? left - right
-        : comparator(String(left), String(right));
+    var direction = sortOrder === "ASCENDING" ? 1 : -1;
+    var leftTier = tierOf(left);
+    var rightTier = tierOf(right);
+    if (leftTier !== rightTier) {
+        return direction * Math.sign(leftTier - rightTier);
+    }
+    var comparisonResult = 0;
+    if (typeof left === "number" && typeof right === "number") {
+        comparisonResult = left - right;
+    }
+    else if (typeof left === "string" && typeof right === "string") {
+        comparisonResult = comparator(left, right);
+    }
+    else if (typeof left === "boolean" && typeof right === "boolean") {
+        // FALSE before TRUE.
+        comparisonResult = Number(left) - Number(right);
+    }
+    // Errors compare equal: Excel keeps them in their original order.
     if (comparisonResult !== 0) {
-        return (sortOrder === "ASCENDING" ? 1 : -1) * Math.sign(comparisonResult);
+        return direction * Math.sign(comparisonResult);
     }
     return 0;
 };

package/dist/cjs/api/structural-guards.d.ts

@@ -46,6 +46,24 @@ export declare const findTornArray: (arrayRanges: readonly GridRange[] | undefin
  * inside the deleted block. */
 export declare const isRangeInsideBand: (range: GridRange, band: StructuralBand) => boolean;
 export declare const isRangeInsideBlock: (outer: GridRange, inner: GridRange) => boolean;
+/**
+ * T-07 — the Excel refusal for defining a table over `range` (create / update): another table on
+ * the sheet (`table-overlap`, judged first) or a merged cell (`table-merged-cells`). `excludeTableId`
+ * leaves the table being edited out. `insertedRows`, when given, is a one-or-more-row insert that
+ * runs first (the Create Table dialog's header row): tables and merges wholly inside its band are
+ * judged at their shifted position.
+ */
+export declare const getTableRangeRefusal: ({ sheetId, range, tables, merges, excludeTableId, insertedRows, }: {
+    sheetId: number;
+    range: GridRange;
+    tables?: readonly TableView[] | null;
+    merges?: readonly GridRange[] | null;
+    excludeTableId?: TableView["id"];
+    insertedRows?: {
+        band: StructuralBand;
+        count: number;
+    };
+}) => StructuralRefusal | undefined;
 /**
  * The Excel refusal (if any) for an insert/delete-cells shift of `range`. Checks run in Excel's
  * order: array tear, merge tear, table tear, off-sheet push. `undefined` means the edit may proceed.
@@ -63,6 +81,45 @@ export declare const getShiftCellsRefusal: <T extends CellData>({ direction, ran
     tables?: readonly TableView[] | null;
     arrayRanges?: readonly GridRange[] | null;
 }) => StructuralRefusal | undefined;
+/**
+ * T-46 — the refusal (if any) for a drag-move / cut of `from` onto `to`. Excel moves a table whole
+ * when the block contains it, but refuses to move PART of a table (the block covers some of its
+ * cells) and refuses a block landing on another table's cells; a block that is a whole table
+ * landing on another table is a table overlap. A same-table column reorder is decided before this.
+ */
+export declare const getMoveRangeRefusal: ({ sheetId, from, to, toSheetId, tables, }: {
+    sheetId: number;
+    from: GridRange;
+    to: GridRange;
+    /** The destination sheet — a cut + paste can land on another sheet; defaults to `sheetId`. */
+    toSheetId?: number;
+    tables?: readonly TableView[] | null;
+}) => StructuralRefusal | undefined;
+/**
+ * T-81 — the refusal for a fill whose filled cells (`target` minus `source`) reach a table's totals
+ * row. Excel's fill handle never extends over a totals row (the row is derived, not data), so the
+ * whole fill is refused and nothing is written. A fill whose source IS the totals row (filling away
+ * from the table) is not affected.
+ */
+export declare const getFillTotalsRowRefusal: ({ sheetId, source, target, tables, }: {
+    sheetId: number;
+    source: GridRange;
+    target: GridRange;
+    tables?: readonly TableView[] | null;
+}) => StructuralRefusal | undefined;
+/**
+ * T-47 — the refusal (if any) for Insert / Delete Table Rows (`axis: "row"`) or Table Columns
+ * (`axis: "column"`) on `table`. The edit shifts the cells of the table's band — its columns from
+ * the table down to the sheet edge, or its rows from the table right to the sheet edge. Another
+ * table wholly inside that band moves with it; one the band reaches but does not contain would be
+ * torn apart, so Excel refuses the edit.
+ */
+export declare const getTableEditRefusal: ({ sheetId, table, axis, tables, }: {
+    sheetId: number;
+    table: TableView;
+    axis: "row" | "column";
+    tables?: readonly TableView[] | null;
+}) => StructuralRefusal | undefined;
 /**
  * INS-06 / INS-09 — the refusal for a whole-row (`axis: "row"`) or whole-column insert of `count`
  * lines before `referenceIndex`, given the hard grid cap (`maxRowCount` / `maxColumnCount`). Blank

package/dist/cjs/api/structural-guards.d.ts.map

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

package/dist/cjs/api/structural-guards.js

@@ -1,4 +1,4 @@
-import { __read } from "tslib";
+import { __assign, __read } from "tslib";
 import { selectionFromActiveCell } from "@rowsncolumns/utils";
 import { structuralRefusal, } from "../constants";
 /** The selection a cell shift operates on — the LAST selection, or the active cell as a 1×1. The
@@ -140,6 +140,31 @@ export var isRangeInsideBand = function (range, band) {
     return rangeContains(band, range);
 };
 export var isRangeInsideBlock = rangeContains;
+/**
+ * T-07 — the Excel refusal for defining a table over `range` (create / update): another table on
+ * the sheet (`table-overlap`, judged first) or a merged cell (`table-merged-cells`). `excludeTableId`
+ * leaves the table being edited out. `insertedRows`, when given, is a one-or-more-row insert that
+ * runs first (the Create Table dialog's header row): tables and merges wholly inside its band are
+ * judged at their shifted position.
+ */
+export var getTableRangeRefusal = function (_a) {
+    var sheetId = _a.sheetId, range = _a.range, tables = _a.tables, merges = _a.merges, excludeTableId = _a.excludeTableId, insertedRows = _a.insertedRows;
+    var shifted = function (candidate) {
+        return insertedRows && isRangeInsideBand(candidate, insertedRows.band)
+            ? __assign(__assign({}, candidate), { startRowIndex: candidate.startRowIndex + insertedRows.count, endRowIndex: candidate.endRowIndex + insertedRows.count }) : candidate;
+    };
+    if (tables === null || tables === void 0 ? void 0 : tables.some(function (table) {
+        return table.sheetId === sheetId &&
+            table.id !== excludeTableId &&
+            rangesIntersect(shifted(table.range), range);
+    })) {
+        return structuralRefusal("table-overlap");
+    }
+    if (merges === null || merges === void 0 ? void 0 : merges.some(function (merge) { return rangesIntersect(shifted(merge), range); })) {
+        return structuralRefusal("table-merged-cells");
+    }
+    return undefined;
+};
 /**
  * The Excel refusal (if any) for an insert/delete-cells shift of `range`. Checks run in Excel's
  * order: array tear, merge tear, table tear, off-sheet push. `undefined` means the edit may proceed.
@@ -176,6 +201,73 @@ export var getShiftCellsRefusal = function (_a) {
     }
     return undefined;
 };
+/**
+ * T-46 — the refusal (if any) for a drag-move / cut of `from` onto `to`. Excel moves a table whole
+ * when the block contains it, but refuses to move PART of a table (the block covers some of its
+ * cells) and refuses a block landing on another table's cells; a block that is a whole table
+ * landing on another table is a table overlap. A same-table column reorder is decided before this.
+ */
+export var getMoveRangeRefusal = function (_a) {
+    var _b;
+    var sheetId = _a.sheetId, from = _a.from, to = _a.to, _c = _a.toSheetId, toSheetId = _c === void 0 ? sheetId : _c, tables = _a.tables;
+    var sheetTables = tables === null || tables === void 0 ? void 0 : tables.filter(function (table) { return table.sheetId === sheetId; });
+    var destinationTables = toSheetId === sheetId
+        ? sheetTables
+        : tables === null || tables === void 0 ? void 0 : tables.filter(function (table) { return table.sheetId === toSheetId; });
+    if (!(sheetTables === null || sheetTables === void 0 ? void 0 : sheetTables.length) && !(destinationTables === null || destinationTables === void 0 ? void 0 : destinationTables.length))
+        return undefined;
+    var moved = (_b = sheetTables === null || sheetTables === void 0 ? void 0 : sheetTables.filter(function (table) { return rangeContains(from, table.range); })) !== null && _b !== void 0 ? _b : [];
+    if (sheetTables === null || sheetTables === void 0 ? void 0 : sheetTables.some(function (table) {
+        return !moved.includes(table) && rangesIntersect(table.range, from);
+    })) {
+        return structuralRefusal("torn-table");
+    }
+    if (destinationTables === null || destinationTables === void 0 ? void 0 : destinationTables.some(function (table) { return !moved.includes(table) && rangesIntersect(table.range, to); })) {
+        return structuralRefusal(moved.length ? "table-overlap" : "torn-table");
+    }
+    return undefined;
+};
+/**
+ * T-81 — the refusal for a fill whose filled cells (`target` minus `source`) reach a table's totals
+ * row. Excel's fill handle never extends over a totals row (the row is derived, not data), so the
+ * whole fill is refused and nothing is written. A fill whose source IS the totals row (filling away
+ * from the table) is not affected.
+ */
+export var getFillTotalsRowRefusal = function (_a) {
+    var sheetId = _a.sheetId, source = _a.source, target = _a.target, tables = _a.tables;
+    return (tables === null || tables === void 0 ? void 0 : tables.some(function (table) {
+        if (table.sheetId !== sheetId || !table.totalRow)
+            return false;
+        var totalsRow = table.range.endRowIndex;
+        if (totalsRow < target.startRowIndex || totalsRow > target.endRowIndex) {
+            return false;
+        }
+        var hit = {
+            startRowIndex: totalsRow,
+            endRowIndex: totalsRow,
+            startColumnIndex: Math.max(table.range.startColumnIndex, target.startColumnIndex),
+            endColumnIndex: Math.min(table.range.endColumnIndex, target.endColumnIndex),
+        };
+        return hit.startColumnIndex <= hit.endColumnIndex && !rangeContains(source, hit);
+    }))
+        ? structuralRefusal("table-totals-fill")
+        : undefined;
+};
+/**
+ * T-47 — the refusal (if any) for Insert / Delete Table Rows (`axis: "row"`) or Table Columns
+ * (`axis: "column"`) on `table`. The edit shifts the cells of the table's band — its columns from
+ * the table down to the sheet edge, or its rows from the table right to the sheet edge. Another
+ * table wholly inside that band moves with it; one the band reaches but does not contain would be
+ * torn apart, so Excel refuses the edit.
+ */
+export var getTableEditRefusal = function (_a) {
+    var sheetId = _a.sheetId, table = _a.table, axis = _a.axis, tables = _a.tables;
+    var band = axis === "row"
+        ? __assign(__assign({}, table.range), { endRowIndex: Number.POSITIVE_INFINITY }) : __assign(__assign({}, table.range), { endColumnIndex: Number.POSITIVE_INFINITY });
+    return findTornTable(tables === null || tables === void 0 ? void 0 : tables.filter(function (other) { return other.id !== table.id; }), sheetId, band)
+        ? structuralRefusal("torn-table")
+        : undefined;
+};
 /**
  * INS-06 / INS-09 — the refusal for a whole-row (`axis: "row"`) or whole-column insert of `count`
  * lines before `referenceIndex`, given the hard grid cap (`maxRowCount` / `maxColumnCount`). Blank

package/dist/cjs/api/structural-table-refs.d.ts

@@ -27,9 +27,10 @@ export type RemovedTableParts = {
     }>;
 };
 /**
- * Which tables / table columns `deleteRow` (a table goes with its header row)
- * or `deleteColumn` (a table goes when every column is deleted; otherwise the
- * covered columns are spliced out) removes for the band
+ * Which tables / table columns `deleteRow` (a table goes only when every one
+ * of its rows is deleted — losing its header row keeps it, the next row
+ * becomes the header) or `deleteColumn` (a table goes when every column is
+ * deleted; otherwise the covered columns are spliced out) removes for the band
  * `[minIndex, maxIndex]` on `sheetId`. Mirrors the table updates those
  * interfaces apply to `tables`.
  */
@@ -59,6 +60,60 @@ export type BreakStructuredRefsParams<T extends CellData> = {
  * when it is available (cost O(formula cells)); without one the draft is swept.
  */
 export declare const breakStructuredRefsForRemovedTableParts: <T extends CellData>({ draft, sheetId, axis, referenceIndex, count, removed, getGraphNodes, enqueueCalculation, enqueueGraphOperation, recalcCells, locale, cellXfsRegistry, sharedStringRegistry, }: BreakStructuredRefsParams<T>) => void;
+export type RewriteFormulasParams<T extends CellData> = Pick<BreakStructuredRefsParams<T>, "draft" | "getGraphNodes" | "enqueueCalculation" | "enqueueGraphOperation" | "recalcCells" | "locale" | "cellXfsRegistry" | "sharedStringRegistry">;
+/**
+ * Column `oldName` of `table` was renamed `newName` (a header-cell edit):
+ * rewrite every structured reference to it across the workbook, including the
+ * bare `[@Old]` forms of the formulas that sit inside the table.
+ */
+export declare const renameTableColumnInFormulas: <T extends CellData>({ table, oldName, newName, ...params }: RewriteFormulasParams<T> & {
+    table: Pick<TableView, "title" | "sheetId" | "range">;
+    oldName: string;
+    newName: string;
+}) => void;
+/**
+ * Several columns of `table` were renamed at once (a header row re-derived
+ * after a row delete, several header cells written by one paste /
+ * change-batch): `renames` maps each LOWER-CASED old name to its new name and
+ * every formula is rewritten in ONE pass, so `Name` → `Qty` and `Qty` → `Name`
+ * swap instead of chaining into the same column.
+ */
+export declare const renameTableColumnsInFormulas: <T extends CellData>({ table, renames, ...params }: RewriteFormulasParams<T> & {
+    table: Pick<TableView, "title" | "sheetId" | "range">;
+    renames: ReadonlyMap<string, string>;
+}) => void;
+/**
+ * The header cells one write renamed (`planHeaderCellRenames`), applied per
+ * table as a single multi-column rename.
+ */
+export declare const renameHeaderCellsInFormulas: <T extends CellData>({ headerRenames, ...params }: RewriteFormulasParams<T> & {
+    headerRenames: readonly {
+        table: Pick<TableView, "id" | "title" | "sheetId" | "range">;
+        oldName: string | undefined;
+        newName: string;
+    }[];
+}) => void;
+/**
+ * `table` is being converted to a range (Excel's Convert to Range): rewrite
+ * every structured reference into it across the workbook to the A1 reference
+ * it resolves to — `T[Col]` → `$B$2:$B$9`, `[@Col]` → `B3`,
+ * `T[[#Headers],[Col]]` → `$B$1`, qualified with the table's sheet from another
+ * sheet — so the formulas keep their values once the table is gone. Runs
+ * BEFORE the table is removed; the bare `[@Col]` forms belong to the formulas
+ * that sit inside the table.
+ */
+export declare const convertTableReferencesToA1InFormulas: <T extends CellData>({ table, getSheetName, ...params }: RewriteFormulasParams<T> & {
+    table: Pick<TableView, "title" | "sheetId" | "range" | "headerRow" | "totalRow" | "columns">;
+    getSheetName(sheetId: number): string;
+}) => void;
+/**
+ * Table `oldName` was renamed `newName` (the Edit Table dialog / `updateTable`):
+ * rewrite `Old[…]` → `New[…]` in every formula across the workbook.
+ */
+export declare const renameTableInFormulas: <T extends CellData>({ oldName, newName, ...params }: RewriteFormulasParams<T> & {
+    oldName: string;
+    newName: string;
+}) => void;
 /**
  * Drop the materialised spill cells of every dynamic-array anchor that sits
  * inside the deleted band `[minIndex, maxIndex]` (rows or columns) of

package/dist/cjs/api/structural-table-refs.d.ts.map

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

package/dist/cjs/api/structural-table-refs.js

@@ -1,13 +1,14 @@
-import { __assign, __read, __values } from "tslib";
+import { __assign, __read, __rest, __values } from "tslib";
 import { isCellNode } from "@rowsncolumns/dag";
 import { addressToCell, getCellUserEnteredValue, getExtendedValueFormula, } from "@rowsncolumns/utils";
 import { SheetCell } from "../sheet-cell";
-import { breakTableColumnsInFormula, breakTableReferencesInFormula, createSheetCellIdentifier, } from "./formula";
+import { breakTableColumnsInFormula, breakTableReferencesInFormula, convertStructuredRefsToA1InFormula, createSheetCellIdentifier, renameTableColumnsInFormula, renameTableInFormula, } from "./formula";
 import { createSheetDraft } from "./immer-utils";
 /**
- * Which tables / table columns `deleteRow` (a table goes with its header row)
- * or `deleteColumn` (a table goes when every column is deleted; otherwise the
- * covered columns are spliced out) removes for the band
+ * Which tables / table columns `deleteRow` (a table goes only when every one
+ * of its rows is deleted — losing its header row keeps it, the next row
+ * becomes the header) or `deleteColumn` (a table goes when every column is
+ * deleted; otherwise the covered columns are spliced out) removes for the band
  * `[minIndex, maxIndex]` on `sheetId`. Mirrors the table updates those
  * interfaces apply to `tables`.
  */
@@ -21,13 +22,13 @@ export var collectRemovedTableParts = function (tables, sheetId, axis, minIndex,
             if (table.sheetId !== sheetId || !table.title)
                 continue;
             if (axis === "row") {
-                var startRowIndex = table.range.startRowIndex;
-                if (startRowIndex >= minIndex && startRowIndex <= maxIndex) {
+                var _f = table.range, startRowIndex = _f.startRowIndex, endRowIndex = _f.endRowIndex;
+                if (minIndex <= startRowIndex && maxIndex >= endRowIndex) {
                     removed.tables.push(table.title);
                 }
                 continue;
             }
-            var _f = table.range, startColumnIndex = _f.startColumnIndex, endColumnIndex = _f.endColumnIndex;
+            var _g = table.range, startColumnIndex = _g.startColumnIndex, endColumnIndex = _g.endColumnIndex;
             if (maxIndex < startColumnIndex || minIndex > endColumnIndex)
                 continue;
             if (minIndex <= startColumnIndex && maxIndex >= endColumnIndex) {
@@ -157,8 +158,168 @@ export var breakStructuredRefsForRemovedTableParts = function (_a) {
         finally { if (e_2) throw e_2.error; }
     }
 };
+/**
+ * Apply `rewrite` to the text of every formula cell across all sheets (from
+ * the dependency graph when available, else a draft sweep), writing back the
+ * ones it changed and re-entering them in the graph for recalculation. Cells
+ * keep their position — this is the in-place rewrite behind a table / table
+ * column rename.
+ */
+var rewriteFormulasInDraft = function (_a, rewrite) {
+    var e_5, _b;
+    var _c, _d;
+    var draft = _a.draft, getGraphNodes = _a.getGraphNodes, enqueueCalculation = _a.enqueueCalculation, enqueueGraphOperation = _a.enqueueGraphOperation, recalcCells = _a.recalcCells, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry;
+    var sheetCell = new SheetCell();
+    try {
+        for (var _e = __values(collectFormulaPositions(draft, getGraphNodes)), _f = _e.next(); !_f.done; _f = _e.next()) {
+            var pos = _f.value;
+            var currentSheet = createSheetDraft(draft, pos.sheetId, pos.rowIndex);
+            var cellData = (_d = (_c = currentSheet[pos.rowIndex]) === null || _c === void 0 ? void 0 : _c.values) === null || _d === void 0 ? void 0 : _d[pos.columnIndex];
+            var formula = getExtendedValueFormula(getCellUserEnteredValue(cellData));
+            if (!formula || !formula.includes("["))
+                continue;
+            var updated = rewrite(formula, pos);
+            if (updated === formula)
+                continue;
+            sheetCell.assign(pos.sheetId, { rowIndex: pos.rowIndex, columnIndex: pos.columnIndex }, cellData, { locale: locale, cellXfsRegistry: cellXfsRegistry, sharedStringRegistry: sharedStringRegistry });
+            sheetCell.setFormulaValue(updated, false);
+            currentSheet[pos.rowIndex].values[pos.columnIndex] =
+                sheetCell.getCellData();
+            var enqueueOperation = sheetCell.ephemeral()
+                ? enqueueCalculation
+                : enqueueGraphOperation;
+            enqueueOperation === null || enqueueOperation === void 0 ? void 0 : enqueueOperation({ type: "remove", position: pos });
+            enqueueOperation === null || enqueueOperation === void 0 ? void 0 : enqueueOperation({ type: "add", position: pos, force: true });
+            recalcCells.set(createSheetCellIdentifier(pos.sheetId, pos.rowIndex, pos.columnIndex), __assign(__assign({}, pos), { force: true }));
+        }
+    }
+    catch (e_5_1) { e_5 = { error: e_5_1 }; }
+    finally {
+        try {
+            if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
+        }
+        finally { if (e_5) throw e_5.error; }
+    }
+};
+/**
+ * Column `oldName` of `table` was renamed `newName` (a header-cell edit):
+ * rewrite every structured reference to it across the workbook, including the
+ * bare `[@Old]` forms of the formulas that sit inside the table.
+ */
+export var renameTableColumnInFormulas = function (_a) {
+    var table = _a.table, oldName = _a.oldName, newName = _a.newName, params = __rest(_a, ["table", "oldName", "newName"]);
+    if (!oldName || !newName || oldName === newName)
+        return;
+    renameTableColumnsInFormulas(__assign(__assign({}, params), { table: table, renames: new Map([[oldName.toLowerCase(), newName]]) }));
+};
+/**
+ * Several columns of `table` were renamed at once (a header row re-derived
+ * after a row delete, several header cells written by one paste /
+ * change-batch): `renames` maps each LOWER-CASED old name to its new name and
+ * every formula is rewritten in ONE pass, so `Name` → `Qty` and `Qty` → `Name`
+ * swap instead of chaining into the same column.
+ */
+export var renameTableColumnsInFormulas = function (_a) {
+    var table = _a.table, renames = _a.renames, params = __rest(_a, ["table", "renames"]);
+    if (renames.size === 0)
+        return;
+    rewriteFormulasInDraft(params, function (formula, pos) {
+        var updated = table.title
+            ? renameTableColumnsInFormula(formula, table.title, renames)
+            : formula;
+        if (pos.sheetId === table.sheetId &&
+            isWithinRange(table.range, pos.rowIndex, pos.columnIndex)) {
+            updated = renameTableColumnsInFormula(updated, undefined, renames);
+        }
+        return updated;
+    });
+};
+/**
+ * The header cells one write renamed (`planHeaderCellRenames`), applied per
+ * table as a single multi-column rename.
+ */
+export var renameHeaderCellsInFormulas = function (_a) {
+    var e_6, _b, e_7, _c;
+    var _d;
+    var headerRenames = _a.headerRenames, params = __rest(_a, ["headerRenames"]);
+    var byTable = new Map();
+    try {
+        for (var headerRenames_1 = __values(headerRenames), headerRenames_1_1 = headerRenames_1.next(); !headerRenames_1_1.done; headerRenames_1_1 = headerRenames_1.next()) {
+            var _e = headerRenames_1_1.value, table = _e.table, oldName = _e.oldName, newName = _e.newName;
+            if (!oldName || oldName === newName)
+                continue;
+            var entry = (_d = byTable.get(table.id)) !== null && _d !== void 0 ? _d : { table: table, renames: new Map() };
+            entry.renames.set(oldName.toLowerCase(), newName);
+            byTable.set(table.id, entry);
+        }
+    }
+    catch (e_6_1) { e_6 = { error: e_6_1 }; }
+    finally {
+        try {
+            if (headerRenames_1_1 && !headerRenames_1_1.done && (_b = headerRenames_1.return)) _b.call(headerRenames_1);
+        }
+        finally { if (e_6) throw e_6.error; }
+    }
+    try {
+        for (var _f = __values(byTable.values()), _g = _f.next(); !_g.done; _g = _f.next()) {
+            var _h = _g.value, table = _h.table, renames = _h.renames;
+            renameTableColumnsInFormulas(__assign(__assign({}, params), { table: table, renames: renames }));
+        }
+    }
+    catch (e_7_1) { e_7 = { error: e_7_1 }; }
+    finally {
+        try {
+            if (_g && !_g.done && (_c = _f.return)) _c.call(_f);
+        }
+        finally { if (e_7) throw e_7.error; }
+    }
+};
+/**
+ * `table` is being converted to a range (Excel's Convert to Range): rewrite
+ * every structured reference into it across the workbook to the A1 reference
+ * it resolves to — `T[Col]` → `$B$2:$B$9`, `[@Col]` → `B3`,
+ * `T[[#Headers],[Col]]` → `$B$1`, qualified with the table's sheet from another
+ * sheet — so the formulas keep their values once the table is gone. Runs
+ * BEFORE the table is removed; the bare `[@Col]` forms belong to the formulas
+ * that sit inside the table.
+ */
+export var convertTableReferencesToA1InFormulas = function (_a) {
+    var _b;
+    var table = _a.table, getSheetName = _a.getSheetName, params = __rest(_a, ["table", "getSheetName"]);
+    if (!table.title)
+        return;
+    var target = {
+        title: table.title,
+        range: table.range,
+        headerRow: table.headerRow,
+        totalRow: table.totalRow,
+        columnNames: ((_b = table.columns) !== null && _b !== void 0 ? _b : []).map(function (column) { return column.name; }),
+    };
+    var tableSheetName = getSheetName(table.sheetId);
+    rewriteFormulasInDraft(params, function (formula, pos) {
+        return convertStructuredRefsToA1InFormula(formula, target, {
+            tableSheetName: tableSheetName,
+            formulaSheetName: getSheetName(pos.sheetId),
+            formulaRowIndex: pos.rowIndex,
+            inTable: pos.sheetId === table.sheetId &&
+                isWithinRange(table.range, pos.rowIndex, pos.columnIndex),
+        });
+    });
+};
+/**
+ * Table `oldName` was renamed `newName` (the Edit Table dialog / `updateTable`):
+ * rewrite `Old[…]` → `New[…]` in every formula across the workbook.
+ */
+export var renameTableInFormulas = function (_a) {
+    var oldName = _a.oldName, newName = _a.newName, params = __rest(_a, ["oldName", "newName"]);
+    if (!oldName || !newName || oldName === newName)
+        return;
+    rewriteFormulasInDraft(params, function (formula) {
+        return renameTableInFormula(formula, oldName, newName);
+    });
+};
 var collectFormulaPositions = function (draft, getGraphNodes) {
-    var e_5, _a, e_6, _b;
+    var e_8, _a, e_9, _b;
     if (getGraphNodes) {
         var graphNodes = void 0;
         try {
@@ -179,12 +340,12 @@ var collectFormulaPositions = function (draft, getGraphNodes) {
                     positions_1.push(__assign({}, node.position));
                 }
             }
-            catch (e_5_1) { e_5 = { error: e_5_1 }; }
+            catch (e_8_1) { e_8 = { error: e_8_1 }; }
             finally {
                 try {
                     if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
                 }
-                finally { if (e_5) throw e_5.error; }
+                finally { if (e_8) throw e_8.error; }
             }
             if (sawNode)
                 return positions_1;
@@ -212,17 +373,17 @@ var collectFormulaPositions = function (draft, getGraphNodes) {
             _loop_1(key);
         }
     }
-    catch (e_6_1) { e_6 = { error: e_6_1 }; }
+    catch (e_9_1) { e_9 = { error: e_9_1 }; }
     finally {
         try {
             if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
         }
-        finally { if (e_6) throw e_6.error; }
+        finally { if (e_9) throw e_9.error; }
     }
     return positions;
 };
 export var removeSpillsOfDeletedAnchors = function (_a) {
-    var e_7, _b;
+    var e_10, _b;
     var _c, _d, _e;
     var draft = _a.draft, sheetId = _a.sheetId, axis = _a.axis, minIndex = _a.minIndex, maxIndex = _a.maxIndex, getArrayRange = _a.getArrayRange, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry;
     var sheetRows = draft[sheetId];
@@ -287,12 +448,12 @@ export var removeSpillsOfDeletedAnchors = function (_a) {
             }
         }
     }
-    catch (e_7_1) { e_7 = { error: e_7_1 }; }
+    catch (e_10_1) { e_10 = { error: e_10_1 }; }
     finally {
         try {
             if (anchors_1_1 && !anchors_1_1.done && (_b = anchors_1.return)) _b.call(anchors_1);
         }
-        finally { if (e_7) throw e_7.error; }
+        finally { if (e_10) throw e_10.error; }
     }
 };
 /** `C1:C3` (the anchor's persisted `af`) → its rectangle; `undefined` when absent/unparseable. */