@rowsncolumns/spreadsheet-state 29.0.0 → 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/table.d.ts

@@ -1,6 +1,17 @@
 import { type ParsedToken } from "@rowsncolumns/calculator";
-import type { CellInterface, GridRange } from "@rowsncolumns/common-types";
+import type { CellInterface, ExtendedValue, GridRange } from "@rowsncolumns/common-types";
 import type { BandedRange, FilterView, TableView } from "@rowsncolumns/spreadsheet";
+/**
+ * Excel's default for the Create Table dialog's "My table has headers": checked when the
+ * range's first row reads as a header row — it holds at least one value, every value in it is
+ * text (a number or boolean there means the data starts on the first row), and at least one row
+ * of data lies below it. A single-row range defaults to unchecked.
+ */
+export declare const guessTableHasHeaders: ({ sheetId, range, getEffectiveExtendedValue, }: {
+    sheetId: number;
+    range: GridRange;
+    getEffectiveExtendedValue: (sheetId: number, rowIndex: number, columnIndex: number) => ExtendedValue | null | undefined;
+}) => boolean;
 /**
  * Get table column index
  * @param sheetId
@@ -25,7 +36,20 @@ export declare const findAdjacentTable: (sheetId: number, cell: CellInterface, t
  * @returns
  */
 export declare const findAdjacentBandedRange: (sheetId: number, cell: CellInterface, bandedRanges: BandedRange[] | undefined, getUserEnteredValue: (sheetId: number, rowIndex: number, columnIndex: number) => string | undefined) => readonly [BandedRange | undefined, boolean, boolean];
-export declare const isTableColumnCellsFillable: (sheetId: number, range: GridRange, excludeCell: CellInterface, existingColumnFormula: string | undefined, currentValue: string | boolean | undefined, activeSheetName: string, getUserEnteredValue: (sheetId: number, rowIndex: number, columnIndex: number) => string | undefined) => boolean;
+/**
+ * Excel's calculated-column fill decision, shared with the Rust engine's
+ * `auto_fill_calculated_column` (rowsncolumns/spreadsheet#681): a formula just
+ * written into a table body cell fills the whole column when every OTHER body
+ * cell of that column is either empty (a fresh column) or holds the same
+ * formula relative to its row (a consistent calculated column, which the new
+ * formula overwrites). A literal anywhere, or two rows that disagree, leave
+ * the edit a one-cell exception. The column's cells are the reference — not
+ * the formula recorded on `columns[].formula`, which has no row of its own —
+ * so the overwrite works from any row, not only the one the column was
+ * created from (#668 T-50). A consistent column is a calculated column
+ * whatever its formula references (`=TODAY()`, `=1`), like Excel (#668 T-29).
+ */
+export declare const isTableColumnCellsFillable: (sheetId: number, range: GridRange, excludeCell: CellInterface, currentValue: string | boolean | undefined, activeSheetName: string, getUserEnteredValue: (sheetId: number, rowIndex: number, columnIndex: number) => string | undefined) => boolean;
 export declare const addTableNameToTokens: (tokens: ParsedToken[], title: string) => string;
 export declare const removeTableName: (tokens: ParsedToken[], title: string) => string;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../api/table.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACV,MAAM,2BAA2B,CAAC;AAkBnC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,uBAiBhC,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,0BAMvC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,EAC/B,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,uDAgDxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,cAAc,WAAW,EAAE,GAAG,SAAS,EACvC,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,yDA8CxB,CAAC;AAGF,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM,EACf,OAAO,SAAS,EAChB,aAAa,aAAa,EAC1B,uBAAuB,MAAM,GAAG,SAAS,EACzC,cAAc,MAAM,GAAG,OAAO,GAAG,SAAS,EAC1C,iBAAiB,MAAM,EACvB,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,YAsExB,CAAC;AAiCF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,WAAW,EAAE,EAAE,OAAO,MAAM,WAyBxE,CAAC;AAcF,eAAO,MAAM,eAAe,GAAI,QAAQ,WAAW,EAAE,EAAE,OAAO,MAAM,WA2BnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,GAAG,UAAU,EAC7B,MAAM,MAAM,EAAE,EACd,gBAAgB,MAAM,SAoDvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,SAAS,GAAG,UAAU,EAC7B,MAAM,MAAM,EAAE,EACd,gBAAgB,MAAM,SAoDvB,CAAC"}
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../api/table.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAEjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACV,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACV,MAAM,2BAA2B,CAAC;AAmBnC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,gDAIlC;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,yBAAyB,EAAE,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;CACvC,KAAG,OA8BH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,uBAiBhC,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,0BAMvC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,EAC/B,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,uDA8DxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,cAAc,WAAW,EAAE,GAAG,SAAS,EACvC,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,yDA8CxB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM,EACf,OAAO,SAAS,EAChB,aAAa,aAAa,EAC1B,cAAc,MAAM,GAAG,OAAO,GAAG,SAAS,EAC1C,iBAAiB,MAAM,EACvB,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,YAuDxB,CAAC;AAGF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,WAAW,EAAE,EAAE,OAAO,MAAM,WAyBxE,CAAC;AAcF,eAAO,MAAM,eAAe,GAAI,QAAQ,WAAW,EAAE,EAAE,OAAO,MAAM,WA2BnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,GAAG,UAAU,EAC7B,MAAM,MAAM,EAAE,EACd,gBAAgB,MAAM,SAoDvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,SAAS,GAAG,UAAU,EAC7B,MAAM,MAAM,EAAE,EACd,gBAAgB,MAAM,SAoDvB,CAAC"}