@rowsncolumns/spreadsheet-state 28.0.76 → 29.1.0

package/dist/esm/api/sort.js

@@ -1,8 +1,33 @@
 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.
+ */
 const { compare: comparator } = new Intl.Collator("en", {
     numeric: true,
     sensitivity: "base",
 });
+export const isSortErrorValue = (value) => 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 const getCellSortValue = (cell) => cell.error
+    ? { sortError: cell.formattedValue ?? "" }
+    : (cell.getEffectiveValue() ?? cell.formattedValue);
+/** Excel's ascending order of value types: numbers < text < logicals < errors. */
+const tierOf = (value) => 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 const cellValueSorter = (left, right, sortOrder) => {
     const isEmpty = (value) => {
         if (isNil(value)) {
@@ -12,7 +37,7 @@ export const cellValueSorter = (left, right, sortOrder) => {
     };
     const leftEmpty = isEmpty(left);
     const rightEmpty = isEmpty(right);
-    // Ignore empty rows
+    // Blanks stay last regardless of direction.
     if (leftEmpty && rightEmpty) {
         return 0;
     }
@@ -22,12 +47,26 @@ export const cellValueSorter = (left, right, sortOrder) => {
     if (rightEmpty) {
         return -1;
     }
-    const isNumbers = typeof left === "number" && typeof right === "number";
-    const comparisonResult = isNumbers
-        ? left - right
-        : comparator(String(left), String(right));
+    const direction = sortOrder === "ASCENDING" ? 1 : -1;
+    const leftTier = tierOf(left);
+    const rightTier = tierOf(right);
+    if (leftTier !== rightTier) {
+        return direction * Math.sign(leftTier - rightTier);
+    }
+    let 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/esm/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/esm/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/esm/api/structural-guards.js

@@ -126,6 +126,31 @@ export const findTornArray = (arrayRanges, band, deletedBlock) => findTornRange(
  * inside the deleted block. */
 export const isRangeInsideBand = (range, band) => rangeContains(band, range);
 export const 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 const getTableRangeRefusal = ({ sheetId, range, tables, merges, excludeTableId, insertedRows, }) => {
+    const shifted = (candidate) => insertedRows && isRangeInsideBand(candidate, insertedRows.band)
+        ? {
+            ...candidate,
+            startRowIndex: candidate.startRowIndex + insertedRows.count,
+            endRowIndex: candidate.endRowIndex + insertedRows.count,
+        }
+        : candidate;
+    if (tables?.some((table) => table.sheetId === sheetId &&
+        table.id !== excludeTableId &&
+        rangesIntersect(shifted(table.range), range))) {
+        return structuralRefusal("table-overlap");
+    }
+    if (merges?.some((merge) => 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.
@@ -161,6 +186,66 @@ export const getShiftCellsRefusal = ({ direction, range, sheetId, rows, rowCount
     }
     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 const getMoveRangeRefusal = ({ sheetId, from, to, toSheetId = sheetId, tables, }) => {
+    const sheetTables = tables?.filter((table) => table.sheetId === sheetId);
+    const destinationTables = toSheetId === sheetId
+        ? sheetTables
+        : tables?.filter((table) => table.sheetId === toSheetId);
+    if (!sheetTables?.length && !destinationTables?.length)
+        return undefined;
+    const moved = sheetTables?.filter((table) => rangeContains(from, table.range)) ?? [];
+    if (sheetTables?.some((table) => !moved.includes(table) && rangesIntersect(table.range, from))) {
+        return structuralRefusal("torn-table");
+    }
+    if (destinationTables?.some((table) => !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 const getFillTotalsRowRefusal = ({ sheetId, source, target, tables, }) => tables?.some((table) => {
+    if (table.sheetId !== sheetId || !table.totalRow)
+        return false;
+    const totalsRow = table.range.endRowIndex;
+    if (totalsRow < target.startRowIndex || totalsRow > target.endRowIndex) {
+        return false;
+    }
+    const 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 const getTableEditRefusal = ({ sheetId, table, axis, tables, }) => {
+    const band = axis === "row"
+        ? { ...table.range, endRowIndex: Number.POSITIVE_INFINITY }
+        : { ...table.range, endColumnIndex: Number.POSITIVE_INFINITY };
+    return findTornTable(tables?.filter((other) => 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/esm/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/esm/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/esm/api/structural-table-refs.js

@@ -1,12 +1,13 @@
 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`.
  */
@@ -16,8 +17,8 @@ export const collectRemovedTableParts = (tables, sheetId, axis, minIndex, maxInd
         if (table.sheetId !== sheetId || !table.title)
             continue;
         if (axis === "row") {
-            const { startRowIndex } = table.range;
-            if (startRowIndex >= minIndex && startRowIndex <= maxIndex) {
+            const { startRowIndex, endRowIndex } = table.range;
+            if (minIndex <= startRowIndex && maxIndex >= endRowIndex) {
                 removed.tables.push(table.title);
             }
             continue;
@@ -107,6 +108,125 @@ export const breakStructuredRefsForRemovedTableParts = ({ draft, sheetId, axis,
         recalcCells.set(createSheetCellIdentifier(nextPosition.sheetId, nextPosition.rowIndex, nextPosition.columnIndex), { ...nextPosition, force: true });
     }
 };
+/**
+ * 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.
+ */
+const rewriteFormulasInDraft = ({ draft, getGraphNodes, enqueueCalculation, enqueueGraphOperation, recalcCells, locale, cellXfsRegistry, sharedStringRegistry, }, rewrite) => {
+    const sheetCell = new SheetCell();
+    for (const pos of collectFormulaPositions(draft, getGraphNodes)) {
+        const currentSheet = createSheetDraft(draft, pos.sheetId, pos.rowIndex);
+        const cellData = currentSheet[pos.rowIndex]?.values?.[pos.columnIndex];
+        const formula = getExtendedValueFormula(getCellUserEnteredValue(cellData));
+        if (!formula || !formula.includes("["))
+            continue;
+        const updated = rewrite(formula, pos);
+        if (updated === formula)
+            continue;
+        sheetCell.assign(pos.sheetId, { rowIndex: pos.rowIndex, columnIndex: pos.columnIndex }, cellData, { locale, cellXfsRegistry, sharedStringRegistry });
+        sheetCell.setFormulaValue(updated, false);
+        currentSheet[pos.rowIndex].values[pos.columnIndex] =
+            sheetCell.getCellData();
+        const enqueueOperation = sheetCell.ephemeral()
+            ? enqueueCalculation
+            : enqueueGraphOperation;
+        enqueueOperation?.({ type: "remove", position: pos });
+        enqueueOperation?.({ type: "add", position: pos, force: true });
+        recalcCells.set(createSheetCellIdentifier(pos.sheetId, pos.rowIndex, pos.columnIndex), { ...pos, force: true });
+    }
+};
+/**
+ * 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 const renameTableColumnInFormulas = ({ table, oldName, newName, ...params }) => {
+    if (!oldName || !newName || oldName === newName)
+        return;
+    renameTableColumnsInFormulas({
+        ...params,
+        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 const renameTableColumnsInFormulas = ({ table, renames, ...params }) => {
+    if (renames.size === 0)
+        return;
+    rewriteFormulasInDraft(params, (formula, pos) => {
+        let 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 const renameHeaderCellsInFormulas = ({ headerRenames, ...params }) => {
+    const byTable = new Map();
+    for (const { table, oldName, newName } of headerRenames) {
+        if (!oldName || oldName === newName)
+            continue;
+        const entry = byTable.get(table.id) ?? { table, renames: new Map() };
+        entry.renames.set(oldName.toLowerCase(), newName);
+        byTable.set(table.id, entry);
+    }
+    for (const { table, renames } of byTable.values()) {
+        renameTableColumnsInFormulas({ ...params, table, renames });
+    }
+};
+/**
+ * `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 const convertTableReferencesToA1InFormulas = ({ table, getSheetName, ...params }) => {
+    if (!table.title)
+        return;
+    const target = {
+        title: table.title,
+        range: table.range,
+        headerRow: table.headerRow,
+        totalRow: table.totalRow,
+        columnNames: (table.columns ?? []).map((column) => column.name),
+    };
+    const tableSheetName = getSheetName(table.sheetId);
+    rewriteFormulasInDraft(params, (formula, pos) => convertStructuredRefsToA1InFormula(formula, target, {
+        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 const renameTableInFormulas = ({ oldName, newName, ...params }) => {
+    if (!oldName || !newName || oldName === newName)
+        return;
+    rewriteFormulasInDraft(params, (formula) => renameTableInFormula(formula, oldName, newName));
+};
 const collectFormulaPositions = (draft, getGraphNodes) => {
     if (getGraphNodes) {
         let graphNodes;

package/dist/esm/api/subtotal.d.ts

@@ -30,22 +30,29 @@ export type SubtotalWrite = {
     values: (string | null)[];
 };
 /**
- * The plan applies in this order, every index already in FINAL coordinates
- * (the sheet after all removals and insertions):
+ * The plan applies in this order:
  *   1. `deleteRows` (descending original indexes — existing subtotal rows),
- *   2. `insertRows` ascending: inserting at final row `r` shifts the not-yet
+ *   2. `ungroupRows`: one `ungroup-rows` call per entry — the outline reset of
+ *      "Replace current subtotals" — in the coordinates of the sheet AFTER the
+ *      deletes and BEFORE the inserts (the surviving data rows, compacted).
+ *      Group / ungroup are ±1 steps in both engines, so pass `k` lists the
+ *      surviving data rows that were deeper than level `k`; after the passes
+ *      every surviving row is back at level 0 (empty when nothing was outlined
+ *      or when not replacing). The reset has to precede the inserts: an
+ *      inserted row takes the row above's outline level in both engines
+ *      (Excel's "Format Same As Above" — a row inserted inside a group joins
+ *      it), so the total rows must be inserted next to level-0 rows — Excel's
+ *      own order: remove the subtotals, rows and outline, then apply afresh.
+ *   3. `insertRows` ascending, in FINAL coordinates (the sheet after all
+ *      removals and insertions): inserting at final row `r` shifts the not-yet
  *      final rows below it, so ascending order lands each new row exactly
  *      where the plan expects it,
- *   3. `writes` (labels + SUBTOTAL formulas),
- *   4. `ungroupRows`: one `ungroup-rows` call per entry — the outline reset of
- *      "Replace current subtotals". Group / ungroup are ±1 steps in both
- *      engines, so pass `k` lists the surviving data rows that were deeper
- *      than level `k`; after the passes every row of the range is back at
- *      level 0 (empty when nothing was outlined or when not replacing), then
- *   5. `outlineGroups`: one `group-rows` call per entry (Excel's levels — the
- *      first spans every row above the grand total, the second the detail
- *      rows of each group, so detail rows end at level 2 and subtotal rows
- *      at level 1 — the same three-level outline on every re-apply).
+ *   4. `writes` (labels + SUBTOTAL formulas), final coordinates, then
+ *   5. `outlineGroups`: one `group-rows` call per entry, final coordinates
+ *      (Excel's levels — the first spans every row above the grand total, the
+ *      second the detail rows of each group, so detail rows end at level 2 and
+ *      subtotal rows at level 1 — the same three-level outline on every
+ *      re-apply).
  */
 export type SubtotalPlan = {
     deleteRows: number[];

package/dist/esm/api/subtotal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subtotal.d.ts","sourceRoot":"","sources":["../../../api/subtotal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAYtE,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,0BAA0B,gBAAgB,CAAC;AACxD,eAAO,MAAM,kBAAkB,GAAI,YAAY,MAAM,WACP,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAClG,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1E,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC5D,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,WAAW,EAAE,SAAS,CAAC;CACxB,CAAC;AAcF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,eAAe,EACxB,QAAQ,cAAc,KACrB,YAAY,GAAG,SAyHjB,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC7D,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpF,aAAa,EAAE,CACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,KACxB,IAAI,CAAC;IACV,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC7D,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAChE,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,MAAM,YAAY,EAClB,UAAU,oBAAoB,SAwB/B,CAAC"}
+{"version":3,"file":"subtotal.d.ts","sourceRoot":"","sources":["../../../api/subtotal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAYtE,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,0BAA0B,gBAAgB,CAAC;AACxD,eAAO,MAAM,kBAAkB,GAAI,YAAY,MAAM,WACP,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAClG,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1E,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC5D,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,WAAW,EAAE,SAAS,CAAC;CACxB,CAAC;AAcF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,eAAe,EACxB,QAAQ,cAAc,KACrB,YAAY,GAAG,SA8HjB,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC7D,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpF,aAAa,EAAE,CACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,KACxB,IAAI,CAAC;IACV,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC7D,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAChE,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,MAAM,YAAY,EAClB,UAAU,oBAAoB,SA0B/B,CAAC"}

package/dist/esm/api/subtotal.js

@@ -109,19 +109,24 @@ export const planSubtotals = (options, reader) => {
         return values;
     };
     // "Replace current subtotals": the surviving data rows carry the previous
-    // outline (detail rows at 2, or deeper after repeated applies) into their
-    // final positions — the inserted total rows arrive at level 0 — so record
-    // how many ungroup steps each needs before the fresh levels go on.
+    // outline (detail rows at 2, or deeper after repeated applies) past the
+    // deletes, and a total row inserted below one of them would inherit that
+    // level (both engines give an inserted row the row above's outline level).
+    // So the reset runs between the deletes and the inserts, addressed to the
+    // compacted survivors — the k-th surviving data row sits at
+    // `firstDataRow + k` once the old total rows are gone — and records how
+    // many ungroup steps each needs before the fresh levels go on.
     const ungroupRows = [];
     let dataRowCursor = 0;
     let cursor = firstDataRow;
     for (const group of groups) {
         const groupStart = cursor;
         for (let i = 0; i < group.size; i++) {
+            const compactedRow = firstDataRow + dataRowCursor;
             const originalRow = dataRows[dataRowCursor++];
             const level = replaceCurrent ? (reader.getOutlineLevel?.(originalRow) ?? 0) : 0;
             for (let pass = 0; pass < level; pass++) {
-                (ungroupRows[pass] ??= []).push(cursor);
+                (ungroupRows[pass] ??= []).push(compactedRow);
             }
             detailRows.push(cursor++);
         }
@@ -159,6 +164,12 @@ export const planSubtotals = (options, reader) => {
 export const applySubtotalPlan = (sheetId, plan, executor) => {
     if (plan.deleteRows.length)
         executor.onDeleteRow(sheetId, plan.deleteRows);
+    // Outline reset before the inserts: the new total rows inherit the level of
+    // the row above them, which must already be 0 (see `SubtotalPlan`).
+    for (const rows of plan.ungroupRows) {
+        if (rows.length)
+            executor.onUngroupRows(sheetId, rows);
+    }
     for (const rowIndex of plan.insertRows) {
         executor.onInsertRow(sheetId, rowIndex, 1);
     }
@@ -170,10 +181,6 @@ export const applySubtotalPlan = (sheetId, plan, executor) => {
             endColumnIndex: write.startColumnIndex + write.values.length - 1,
         }, [write.values]);
     }
-    for (const rows of plan.ungroupRows) {
-        if (rows.length)
-            executor.onUngroupRows(sheetId, rows);
-    }
     for (const rows of plan.outlineGroups) {
         if (rows.length)
             executor.onGroupRows(sheetId, rows);