@rowsncolumns/spreadsheet-state 28.0.76 → 29.1.0

package/dist/cjs/interface/apply-fill.js

@@ -5,11 +5,12 @@ import { produceWithPatches } from "immer";
 import { FILL_UNTOUCHED } from "../api/fill";
 import { createSheetCellIdentifier } from "../api/formula";
 import { createSheetDraft } from "../api/immer-utils";
+import { findAdjacentTable } from "../api/table";
 import { defaultCellCoords, defaultSheetId, SheetCell } from "../sheet-cell";
 import { getFillDirection } from "./../api/selection";
 import { collectDataValidationTarget, extendDataValidationRanges, } from "./data-validation-utils";
 export var applyFill = function (_a) {
-    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getDataValidationById = _a.getDataValidationById, getCellData = _a.getCellData, getEffectiveValue = _a.getEffectiveValue, getFormattedValue = _a.getFormattedValue, getAutoFillValues = _a.getAutoFillValues, getSheetName = _a.getSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, createHistory = _a.createHistory, onChangeDataValidations = _a.onChangeDataValidations, getMerges = _a.getMerges, onFillMerges = _a.onFillMerges;
+    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getDataValidationById = _a.getDataValidationById, getCellData = _a.getCellData, getEffectiveValue = _a.getEffectiveValue, getFormattedValue = _a.getFormattedValue, getAutoFillValues = _a.getAutoFillValues, getSheetName = _a.getSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, createHistory = _a.createHistory, onChangeDataValidations = _a.onChangeDataValidations, getMerges = _a.getMerges, onFillMerges = _a.onFillMerges, tables = _a.tables, getUserEnteredValue = _a.getUserEnteredValue, onChangeTableColumn = _a.onChangeTableColumn, _b = _a.batchHistory, batchHistory = _b === void 0 ? function (action) { return action(); } : _b, _c = _a.autoExpandTables, autoExpandTables = _c === void 0 ? true : _c;
     return function (
     // Active sheet ID
     sheetId, 
@@ -23,7 +24,7 @@ export var applyFill = function (_a) {
     fillType, 
     // Ctrl/Cmd toggle held on the fill handle and/or Series-dialog parameters
     options) { return __awaiter(void 0, void 0, void 0, function () {
-        var finalSelections, selection, saveHistory, fillBounds, direction, recalcCells, dataValidationTargets, fillValues, targetBounds, filledArea, sheetCell, getFillValue, writeCell, writeFilledCell, fillMerges;
+        var finalSelections, selection, fillBounds, direction, recalcCells, dataValidationTargets, fillValues, targetBounds, filledArea, tableExpansion, sheetCell, getFillValue, writeCell, writeFilledCell;
         var _a;
         return __generator(this, function (_b) {
             switch (_b.label) {
@@ -32,7 +33,6 @@ export var applyFill = function (_a) {
                         ? selections
                         : selectionFromActiveCell(activeCell);
                     selection = finalSelections[finalSelections.length - 1];
-                    saveHistory = createHistory();
                     fillBounds = fillSelection.range;
                     direction = getFillDirection(fillSelection, selection);
                     recalcCells = new Map();
@@ -84,6 +84,16 @@ export var applyFill = function (_a) {
                                     startColumnIndex: targetBounds.startColumnIndex,
                                     endColumnIndex: selection.range.startColumnIndex - 1,
                                 };
+                    tableExpansion = autoExpandTables
+                        ? findFillTableExpansion({
+                            sheetId: sheetId,
+                            direction: direction,
+                            selection: selection.range,
+                            filledArea: filledArea,
+                            tables: tables,
+                            getUserEnteredValue: getUserEnteredValue,
+                        })
+                        : undefined;
                     sheetCell = new SheetCell(defaultSheetId, defaultCellCoords, undefined, { locale: locale, cellXfsRegistry: cellXfsRegistry, getDataValidationById: getDataValidationById });
                     getFillValue = function (rowIndex, columnIndex) {
                         var _a;
@@ -133,118 +143,217 @@ export var applyFill = function (_a) {
                         startColumnIndex: fillBounds.startColumnIndex,
                         endColumnIndex: fillBounds.endColumnIndex,
                     });
-                    // Copy sheetdata
-                    onChangeSheetData === null || onChangeSheetData === void 0 ? void 0 : onChangeSheetData(function (prevSheetData) {
-                        var _a = __read(produceWithPatches(prevSheetData, function (draft) {
-                            var e_1, _a;
-                            var _b;
-                            switch (direction) {
-                                case Direction.Down: {
-                                    var start = selection.range.endRowIndex + 1;
-                                    var end = targetBounds.endRowIndex;
-                                    var counter = 0;
-                                    for (var i = start; i <= end; i++) {
-                                        var rowIndex = selection.range.startRowIndex + counter;
-                                        if (rowIndex > selection.range.endRowIndex) {
-                                            counter = 0;
-                                            rowIndex = selection.range.startRowIndex;
-                                        }
-                                        var rollingRowIndex = i - start;
-                                        for (var columnIndex = selection.range.startColumnIndex; columnIndex <= selection.range.endColumnIndex; columnIndex++) {
-                                            var rollingColumnIndex = columnIndex - selection.range.startColumnIndex;
-                                            writeFilledCell(draft, i, columnIndex, rollingRowIndex, rollingColumnIndex);
+                    // The fill and the table growth it triggers undo as ONE step.
+                    batchHistory(function () {
+                        var saveHistory = createHistory();
+                        // Copy sheetdata
+                        onChangeSheetData === null || onChangeSheetData === void 0 ? void 0 : onChangeSheetData(function (prevSheetData) {
+                            var _a = __read(produceWithPatches(prevSheetData, function (draft) {
+                                var e_1, _a;
+                                var _b;
+                                switch (direction) {
+                                    case Direction.Down: {
+                                        var start = selection.range.endRowIndex + 1;
+                                        var end = targetBounds.endRowIndex;
+                                        var counter = 0;
+                                        for (var i = start; i <= end; i++) {
+                                            var rowIndex = selection.range.startRowIndex + counter;
+                                            if (rowIndex > selection.range.endRowIndex) {
+                                                counter = 0;
+                                                rowIndex = selection.range.startRowIndex;
+                                            }
+                                            var rollingRowIndex = i - start;
+                                            for (var columnIndex = selection.range.startColumnIndex; columnIndex <= selection.range.endColumnIndex; columnIndex++) {
+                                                var rollingColumnIndex = columnIndex - selection.range.startColumnIndex;
+                                                writeFilledCell(draft, i, columnIndex, rollingRowIndex, rollingColumnIndex);
+                                            }
+                                            counter++;
                                         }
-                                        counter++;
+                                        break;
                                     }
-                                    break;
-                                }
-                                case Direction.Up: {
-                                    var start = selection.range.startRowIndex - 1;
-                                    var end = targetBounds.startRowIndex;
-                                    for (var i = start; i >= end; i--) {
-                                        var rollingRowIndex = i - targetBounds.startRowIndex;
-                                        for (var columnIndex = selection.range.startColumnIndex; columnIndex <= selection.range.endColumnIndex; columnIndex++) {
-                                            var rollingColumnIndex = columnIndex - selection.range.startColumnIndex;
-                                            writeFilledCell(draft, i, columnIndex, rollingRowIndex, rollingColumnIndex);
+                                    case Direction.Up: {
+                                        var start = selection.range.startRowIndex - 1;
+                                        var end = targetBounds.startRowIndex;
+                                        for (var i = start; i >= end; i--) {
+                                            var rollingRowIndex = i - targetBounds.startRowIndex;
+                                            for (var columnIndex = selection.range.startColumnIndex; columnIndex <= selection.range.endColumnIndex; columnIndex++) {
+                                                var rollingColumnIndex = columnIndex - selection.range.startColumnIndex;
+                                                writeFilledCell(draft, i, columnIndex, rollingRowIndex, rollingColumnIndex);
+                                            }
                                         }
+                                        break;
                                     }
-                                    break;
-                                }
-                                case Direction.Right: {
-                                    for (var rowIndex = selection.range.startRowIndex; rowIndex <= selection.range.endRowIndex; rowIndex++) {
-                                        var start = selection.range.endColumnIndex + 1;
-                                        var end = targetBounds.endColumnIndex;
-                                        var counter = 0;
-                                        var rollingRowIndex = rowIndex - selection.range.startRowIndex;
-                                        for (var j = start; j <= end; j++) {
-                                            var columnIndex = selection.range.startColumnIndex + counter;
-                                            if (columnIndex > selection.range.endColumnIndex) {
-                                                counter = 0;
-                                                columnIndex = selection.range.startColumnIndex;
+                                    case Direction.Right: {
+                                        for (var rowIndex = selection.range.startRowIndex; rowIndex <= selection.range.endRowIndex; rowIndex++) {
+                                            var start = selection.range.endColumnIndex + 1;
+                                            var end = targetBounds.endColumnIndex;
+                                            var counter = 0;
+                                            var rollingRowIndex = rowIndex - selection.range.startRowIndex;
+                                            for (var j = start; j <= end; j++) {
+                                                var columnIndex = selection.range.startColumnIndex + counter;
+                                                if (columnIndex > selection.range.endColumnIndex) {
+                                                    counter = 0;
+                                                    columnIndex = selection.range.startColumnIndex;
+                                                }
+                                                var rollingColumnIndex = j - start;
+                                                writeFilledCell(draft, rowIndex, j, rollingRowIndex, rollingColumnIndex);
+                                                counter++;
                                             }
-                                            var rollingColumnIndex = j - start;
-                                            writeFilledCell(draft, rowIndex, j, rollingRowIndex, rollingColumnIndex);
-                                            counter++;
                                         }
+                                        break;
                                     }
-                                    break;
-                                }
-                                case Direction.Left: {
-                                    for (var rowIndex = selection.range.startRowIndex; rowIndex <= selection.range.endRowIndex; rowIndex++) {
-                                        var start = selection.range.startColumnIndex - 1;
-                                        var end = targetBounds.startColumnIndex;
-                                        var rollingRowIndex = rowIndex - selection.range.startRowIndex;
-                                        var counter = 0;
-                                        for (var j = start; j >= end; j--) {
-                                            var columnIndex = selection.range.endColumnIndex + counter;
-                                            if (columnIndex < selection.range.startColumnIndex) {
-                                                counter = 0;
-                                                columnIndex = selection.range.endColumnIndex;
+                                    case Direction.Left: {
+                                        for (var rowIndex = selection.range.startRowIndex; rowIndex <= selection.range.endRowIndex; rowIndex++) {
+                                            var start = selection.range.startColumnIndex - 1;
+                                            var end = targetBounds.startColumnIndex;
+                                            var rollingRowIndex = rowIndex - selection.range.startRowIndex;
+                                            var counter = 0;
+                                            for (var j = start; j >= end; j--) {
+                                                var columnIndex = selection.range.endColumnIndex + counter;
+                                                if (columnIndex < selection.range.startColumnIndex) {
+                                                    counter = 0;
+                                                    columnIndex = selection.range.endColumnIndex;
+                                                }
+                                                var rollingColumnIndex = j - targetBounds.startColumnIndex;
+                                                writeFilledCell(draft, rowIndex, j, rollingRowIndex, rollingColumnIndex);
+                                                counter--;
                                             }
-                                            var rollingColumnIndex = j - targetBounds.startColumnIndex;
-                                            writeFilledCell(draft, rowIndex, j, rollingRowIndex, rollingColumnIndex);
-                                            counter--;
                                         }
+                                        break;
                                     }
-                                    break;
                                 }
-                            }
-                            try {
-                                // Series-dialog Trend: the seed cells Excel replaces with the fitted values.
-                                for (var _c = __values((_b = fillValues.seedCells) !== null && _b !== void 0 ? _b : []), _d = _c.next(); !_d.done; _d = _c.next()) {
-                                    var seed = _d.value;
-                                    writeCell(draft, seed.rowIndex, seed.columnIndex, seed.cell);
-                                }
-                            }
-                            catch (e_1_1) { e_1 = { error: e_1_1 }; }
-                            finally {
                                 try {
-                                    if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+                                    // Series-dialog Trend: the seed cells Excel replaces with the fitted values.
+                                    for (var _c = __values((_b = fillValues.seedCells) !== null && _b !== void 0 ? _b : []), _d = _c.next(); !_d.done; _d = _c.next()) {
+                                        var seed = _d.value;
+                                        writeCell(draft, seed.rowIndex, seed.columnIndex, seed.cell);
+                                    }
                                 }
-                                finally { if (e_1) throw e_1.error; }
-                            }
-                        }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
-                        // Save history
-                        saveHistory({
-                            sheetData: { patches: patches, inversePatches: inversePatches },
-                            recalcCells: { undo: recalcCells, redo: recalcCells },
-                            sheetId: { undo: sheetId, redo: sheetId },
-                            activeCell: { undo: activeCell, redo: activeCell },
-                            selections: {
-                                undo: fillableSelections !== null && fillableSelections !== void 0 ? fillableSelections : selections,
-                                redo: [__assign(__assign({}, fillSelection), { range: targetBounds })],
-                            },
+                                catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                                finally {
+                                    try {
+                                        if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+                                    }
+                                    finally { if (e_1) throw e_1.error; }
+                                }
+                            }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
+                            // Save history
+                            saveHistory({
+                                sheetData: { patches: patches, inversePatches: inversePatches },
+                                recalcCells: { undo: recalcCells, redo: recalcCells },
+                                sheetId: { undo: sheetId, redo: sheetId },
+                                activeCell: { undo: activeCell, redo: activeCell },
+                                selections: {
+                                    undo: fillableSelections !== null && fillableSelections !== void 0 ? fillableSelections : selections,
+                                    redo: [__assign(__assign({}, fillSelection), { range: targetBounds })],
+                                },
+                            });
+                            extendDataValidationRanges(dataValidationTargets, onChangeDataValidations, saveHistory);
+                            sharedStringRegistry === null || sharedStringRegistry === void 0 ? void 0 : sharedStringRegistry.getPatches(saveHistory);
+                            return nextState;
                         });
-                        extendDataValidationRanges(dataValidationTargets, onChangeDataValidations, saveHistory);
-                        sharedStringRegistry === null || sharedStringRegistry === void 0 ? void 0 : sharedStringRegistry.getPatches(saveHistory);
-                        return nextState;
+                        // A merged seed replicates its block shape over the filled area (Excel).
+                        var fillMerges = fillValues.fillMerges;
+                        if (fillMerges === null || fillMerges === void 0 ? void 0 : fillMerges.length) {
+                            onFillMerges === null || onFillMerges === void 0 ? void 0 : onFillMerges(sheetId, activeCell, filledArea, fillMerges, targetBounds);
+                        }
+                        if (tableExpansion) {
+                            var table_1 = tableExpansion.table, coords_1 = tableExpansion.coords, isRowExpansion = tableExpansion.isRowExpansion, isColumnExpansion_1 = tableExpansion.isColumnExpansion, range = tableExpansion.range;
+                            // The header cell of each new column names it (a rightward fill past the table grows it by
+                            // every filled column); every other expansion needs no value.
+                            var headerNameAt = function (columnIndex) {
+                                var _a;
+                                var headerValue = isColumnExpansion_1 && coords_1.rowIndex === table_1.range.startRowIndex
+                                    ? (_a = fillValues[coords_1.rowIndex - selection.range.startRowIndex]) === null || _a === void 0 ? void 0 : _a[columnIndex - (selection.range.endColumnIndex + 1)]
+                                    : undefined;
+                                var headerName = headerValue === undefined || headerValue === FILL_UNTOUCHED
+                                    ? undefined
+                                    : typeof headerValue === "object"
+                                        ? new SheetCell(sheetId, { rowIndex: coords_1.rowIndex, columnIndex: columnIndex }, headerValue, { locale: locale }).getUserEnteredValue()
+                                        : headerValue;
+                                return typeof headerName === "string" || typeof headerName === "boolean"
+                                    ? headerName
+                                    : typeof headerName === "number"
+                                        ? String(headerName)
+                                        : undefined;
+                            };
+                            var headerValues = [];
+                            for (var columnIndex = coords_1.columnIndex; columnIndex <= range.endColumnIndex; columnIndex++) {
+                                headerValues.push(headerNameAt(columnIndex));
+                            }
+                            onChangeTableColumn === null || onChangeTableColumn === void 0 ? void 0 : onChangeTableColumn(sheetId, coords_1, headerValues[0], table_1, isRowExpansion, isColumnExpansion_1, range, headerValues);
+                        }
                     });
-                    fillMerges = fillValues.fillMerges;
-                    if (fillMerges === null || fillMerges === void 0 ? void 0 : fillMerges.length) {
-                        onFillMerges === null || onFillMerges === void 0 ? void 0 : onFillMerges(sheetId, activeCell, filledArea, fillMerges, targetBounds);
-                    }
                     return [2 /*return*/];
             }
         });
     }); };
 };
+/**
+ * The table a fill grows, if any: for a downward fill the first filled row is the row right after a
+ * table (within its columns); for a rightward fill the first filled column is the column right after
+ * a table (within its rows). The fill may start inside the table — a drag from any body row past the
+ * last row grows it from that last row on. Adjacency, the empty-line rule and the totals-row rule
+ * (a table with a totals row never auto-grows) are `findAdjacentTable`'s, shared with typing and
+ * paste. Fills upward / leftward never grow a table.
+ */
+export var findFillTableExpansion = function (_a) {
+    var e_2, _b;
+    var sheetId = _a.sheetId, direction = _a.direction, selection = _a.selection, filledArea = _a.filledArea, tables = _a.tables, getUserEnteredValue = _a.getUserEnteredValue;
+    if (!(tables === null || tables === void 0 ? void 0 : tables.length) || !getUserEnteredValue) {
+        return undefined;
+    }
+    if (direction !== Direction.Down && direction !== Direction.Right) {
+        return undefined;
+    }
+    try {
+        for (var tables_1 = __values(tables), tables_1_1 = tables_1.next(); !tables_1_1.done; tables_1_1 = tables_1.next()) {
+            var table = tables_1_1.value;
+            if (table.sheetId !== sheetId) {
+                continue;
+            }
+            var coords = direction === Direction.Down
+                ? table.range.endRowIndex + 1 >= filledArea.startRowIndex &&
+                    table.range.endRowIndex + 1 <= filledArea.endRowIndex &&
+                    selection.startColumnIndex >= table.range.startColumnIndex &&
+                    selection.startColumnIndex <= table.range.endColumnIndex
+                    ? {
+                        rowIndex: table.range.endRowIndex + 1,
+                        columnIndex: selection.startColumnIndex,
+                    }
+                    : undefined
+                : table.range.endColumnIndex + 1 >= filledArea.startColumnIndex &&
+                    table.range.endColumnIndex + 1 <= filledArea.endColumnIndex &&
+                    selection.startRowIndex >= table.range.startRowIndex &&
+                    selection.startRowIndex <= table.range.endRowIndex
+                    ? {
+                        rowIndex: selection.startRowIndex,
+                        columnIndex: table.range.endColumnIndex + 1,
+                    }
+                    : undefined;
+            if (!coords) {
+                continue;
+            }
+            var _c = __read(findAdjacentTable(sheetId, coords, tables, getUserEnteredValue), 3), adjacentTable = _c[0], isRowExpansion = _c[1], isColumnExpansion = _c[2];
+            if (!adjacentTable || !(isRowExpansion || isColumnExpansion)) {
+                continue;
+            }
+            return {
+                table: adjacentTable,
+                coords: coords,
+                isRowExpansion: isRowExpansion,
+                isColumnExpansion: isColumnExpansion,
+                range: direction === Direction.Down
+                    ? __assign(__assign({}, filledArea), { startRowIndex: coords.rowIndex }) : __assign(__assign({}, filledArea), { startColumnIndex: coords.columnIndex }),
+            };
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (tables_1_1 && !tables_1_1.done && (_b = tables_1.return)) _b.call(tables_1);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return undefined;
+};

package/dist/cjs/interface/change-batch.d.ts

@@ -35,5 +35,5 @@ export interface ChangeBatchOptions {
      */
     disableTypeInference?: boolean;
 }
-export declare const changeBatch: <T extends CellData, K extends CellFormat, S extends Sheet = Sheet>({ createHistory, enqueueCalculation, onChangeSheetData, onChangeSheets, onChangeTableColumn, onChangeCalculatedColumn, tokenizer, getEffectiveValuesFromRange, locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, getFormattedValue, getUserEnteredValue, getCellDimensions, getRowHeight, isMergedCell, tables, onChangeCitations, }: UseOnChangeBatchProps<T, S>) => (sheetId: number, ranges: GridRange[] | GridRange, values: (string | boolean | number | undefined | null)[][] | string | boolean | number | undefined | null, formatting?: (K | undefined | null)[][] | K | null | undefined, citations?: (string | undefined | null)[][] | string | null | undefined, options?: ChangeBatchOptions) => void;
+export declare const changeBatch: <T extends CellData, K extends CellFormat, S extends Sheet = Sheet>({ createHistory, enqueueCalculation, enqueueGraphOperation, onChangeSheetData, onChangeSheets, onChangeTables, onChangeTableColumn, onChangeCalculatedColumn, tokenizer, getEffectiveValuesFromRange, locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, getFormattedValue, getUserEnteredValue, getCellDimensions, getRowHeight, isMergedCell, tables, onChangeCitations, autoExpandTables, generatedNames, }: UseOnChangeBatchProps<T, S>) => (sheetId: number, ranges: GridRange[] | GridRange, values: (string | boolean | number | undefined | null)[][] | string | boolean | number | undefined | null, formatting?: (K | undefined | null)[][] | K | null | undefined, citations?: (string | undefined | null)[][] | string | null | undefined, options?: ChangeBatchOptions) => void;
 //# sourceMappingURL=change-batch.d.ts.map

package/dist/cjs/interface/change-batch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change-batch.d.ts","sourceRoot":"","sources":["../../../interface/change-batch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EACV,QAAQ,EAER,KAAK,EAEN,MAAM,2BAA2B,CAAC;AAiBnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAI1E,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;;;;;;;;OAcG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,eAAO,MAAM,WAAW,GACtB,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,UAAU,EACpB,CAAC,SAAS,KAAK,GAAG,KAAK,EACvB,0VAoBC,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,MAE1B,SAAS,MAAM,EACf,QAAQ,SAAS,EAAE,GAAG,SAAS,EAC/B,QACI,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,GAClD,MAAM,GACN,OAAO,GACP,MAAM,GACN,SAAS,GACT,IAAI,EACR,aAAa,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,EAC9D,YAAY,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACvE,UAAS,kBAAuB,SA2ZnC,CAAC"}
+{"version":3,"file":"change-batch.d.ts","sourceRoot":"","sources":["../../../interface/change-batch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EACV,QAAQ,EAER,KAAK,EAEN,MAAM,2BAA2B,CAAC;AAkBnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAK1E,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;;;;;;;;OAcG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,eAAO,MAAM,WAAW,GACtB,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,UAAU,EACpB,CAAC,SAAS,KAAK,GAAG,KAAK,EACvB,maAwBC,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,MAE1B,SAAS,MAAM,EACf,QAAQ,SAAS,EAAE,GAAG,SAAS,EAC/B,QACI,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,GAClD,MAAM,GACN,OAAO,GACP,MAAM,GACN,SAAS,GACT,IAAI,EACR,aAAa,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,EAC9D,YAAY,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACvE,UAAS,kBAAuB,SAggBnC,CAAC"}

package/dist/cjs/interface/change-batch.js

@@ -4,15 +4,17 @@ import { alignmentImpliesWrap, isNil } from "@rowsncolumns/utils";
 import { produceWithPatches } from "immer";
 import { createSheetCellIdentifier } from "../api/formula";
 import { createSheetDraft } from "../api/immer-utils";
+import { renameHeaderCellsInFormulas } from "../api/structural-table-refs";
 import { findActiveTableWithinCell, findAdjacentTable, removeTableName, } from "../api/table";
+import { planHeaderCellRenames } from "./change-table-column";
 import { SheetCell } from "../sheet-cell";
 export var changeBatch = function (_a) {
-    var createHistory = _a.createHistory, enqueueCalculation = _a.enqueueCalculation, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTableColumn = _a.onChangeTableColumn, onChangeCalculatedColumn = _a.onChangeCalculatedColumn, tokenizer = _a.tokenizer, getEffectiveValuesFromRange = _a.getEffectiveValuesFromRange, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getDataValidationById = _a.getDataValidationById, getFormattedValue = _a.getFormattedValue, getUserEnteredValue = _a.getUserEnteredValue, getCellDimensions = _a.getCellDimensions, getRowHeight = _a.getRowHeight, isMergedCell = _a.isMergedCell, tables = _a.tables, onChangeCitations = _a.onChangeCitations;
+    var createHistory = _a.createHistory, enqueueCalculation = _a.enqueueCalculation, enqueueGraphOperation = _a.enqueueGraphOperation, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeTableColumn = _a.onChangeTableColumn, onChangeCalculatedColumn = _a.onChangeCalculatedColumn, tokenizer = _a.tokenizer, getEffectiveValuesFromRange = _a.getEffectiveValuesFromRange, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getDataValidationById = _a.getDataValidationById, getFormattedValue = _a.getFormattedValue, getUserEnteredValue = _a.getUserEnteredValue, getCellDimensions = _a.getCellDimensions, getRowHeight = _a.getRowHeight, isMergedCell = _a.isMergedCell, tables = _a.tables, onChangeCitations = _a.onChangeCitations, _b = _a.autoExpandTables, autoExpandTables = _b === void 0 ? true : _b, generatedNames = _a.generatedNames;
     return function (sheetId, ranges, values, formatting, citations, options) {
         var e_1, _a, _b;
-        var _c;
+        var _c, _d;
         if (options === void 0) { options = {}; }
-        var _d = options.enableEvaluation, enableEvaluation = _d === void 0 ? true : _d, _e = options.enableHistory, enableHistory = _e === void 0 ? true : _e, _f = options.formattingOnly, formattingOnly = _f === void 0 ? false : _f, _g = options.disableTypeInference, disableTypeInference = _g === void 0 ? false : _g;
+        var _e = options.enableEvaluation, enableEvaluation = _e === void 0 ? true : _e, _f = options.enableHistory, enableHistory = _f === void 0 ? true : _f, _g = options.formattingOnly, formattingOnly = _g === void 0 ? false : _g, _h = options.disableTypeInference, disableTypeInference = _h === void 0 ? false : _h;
         var saveHistory = enableHistory ? createHistory() : function () { return undefined; };
         // We need to track this for history. Precedent cells
         var recalcCells = new Map();
@@ -50,12 +52,43 @@ export var changeBatch = function (_a) {
         var isColumnExpansion = false;
         var currentTable;
         if (!formattingOnly && (tables === null || tables === void 0 ? void 0 : tables.length) && coords) {
-            _b = __read(findAdjacentTable(sheetId, coords, tables, getUserEnteredValue), 3), adjacentTable = _b[0], isRowExpansion = _b[1], isColumnExpansion = _b[2];
+            if (autoExpandTables) {
+                _b = __read(findAdjacentTable(sheetId, coords, tables, getUserEnteredValue), 3), adjacentTable = _b[0], isRowExpansion = _b[1], isColumnExpansion = _b[2];
+            }
             currentTable =
                 isColumnExpansion && adjacentTable
                     ? adjacentTable
                     : findActiveTableWithinCell(sheetId, coords, tables);
         }
+        // Header cells of existing tables the batch lands on take the typed-header
+        // rule: text, de-duplicated, structured references following.
+        var headerRenames = !formattingOnly && (tables === null || tables === void 0 ? void 0 : tables.length)
+            ? planHeaderCellRenames({
+                sheetId: sheetId,
+                tables: tables,
+                generatedNames: generatedNames,
+                cells: finalRanges.flatMap(function (range) {
+                    var _a;
+                    var cells = [];
+                    for (var rowIndex = range.startRowIndex; rowIndex <= range.endRowIndex; rowIndex++) {
+                        for (var columnIndex = range.startColumnIndex; columnIndex <= range.endColumnIndex; columnIndex++) {
+                            cells.push({
+                                rowIndex: rowIndex,
+                                columnIndex: columnIndex,
+                                value: Array.isArray(values)
+                                    ? (_a = values[rowIndex - range.startRowIndex]) === null || _a === void 0 ? void 0 : _a[columnIndex - range.startColumnIndex]
+                                    : values,
+                            });
+                        }
+                    }
+                    return cells;
+                }),
+            })
+            : [];
+        var headerRenameAt = new Map(headerRenames.map(function (rename) { return [
+            "".concat(rename.rowIndex, ":").concat(rename.columnIndex),
+            rename,
+        ]; }));
         // Update sheet data
         onChangeSheetData === null || onChangeSheetData === void 0 ? void 0 : onChangeSheetData(function (prevSheetData) {
             var _a = __read(produceWithPatches(prevSheetData, function (draft) {
@@ -87,7 +120,14 @@ export var changeBatch = function (_a) {
                                 });
                                 // Set text value of the cell
                                 // Skip value changes if formattingOnly is true
-                                if (!formattingOnly) {
+                                var headerRename = headerRenameAt.get("".concat(rowIndex, ":").concat(columnIndex));
+                                if (headerRename) {
+                                    // A table header cell holds its column name as text.
+                                    sheetCell.setUserEnteredValue(headerRename.newName, undefined, {
+                                        disableTypeInference: true,
+                                    });
+                                }
+                                else if (!formattingOnly) {
                                     if (isNil(value_1)) {
                                         sheetCell.deleteContents();
                                     }
@@ -160,6 +200,16 @@ export var changeBatch = function (_a) {
                     }
                     finally { if (e_2) throw e_2.error; }
                 }
+                renameHeaderCellsInFormulas({
+                    draft: draft,
+                    headerRenames: headerRenames,
+                    enqueueCalculation: enqueueCalculation,
+                    enqueueGraphOperation: enqueueGraphOperation,
+                    recalcCells: recalcCells,
+                    locale: locale,
+                    cellXfsRegistry: cellXfsRegistry,
+                    sharedStringRegistry: sharedStringRegistry,
+                });
             }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
             // Save history
             saveHistory({
@@ -171,8 +221,55 @@ export var changeBatch = function (_a) {
                 sheetId: { undo: sheetId, redo: sheetId },
                 recalcCells: { undo: recalcCells, redo: recalcCells },
             });
+            // Flush the registries HERE, after this updater interned the batch's
+            // strings and formats. When `onChangeSheetData` is a React state setter
+            // and the slice already has an update queued in this tick (a row insert
+            // composed with this write — Data → Subtotal, Insert Cut Cells, agent
+            // streams), React defers the updater to the render instead of running it
+            // eagerly; a flush issued after the dispatch would run before any string
+            // was minted, find the registries empty, and leave every text cell of the
+            // batch pointing at an `ss` id no table holds — blank locally and after
+            // reload. Inside the updater the strings are always there, and the
+            // patches land on this same history pointer.
+            cellXfsRegistry === null || cellXfsRegistry === void 0 ? void 0 : cellXfsRegistry.getPatches(saveHistory);
+            sharedStringRegistry === null || sharedStringRegistry === void 0 ? void 0 : sharedStringRegistry.getPatches(saveHistory);
             return nextState;
         });
+        if (headerRenames.length) {
+            onChangeTables === null || onChangeTables === void 0 ? void 0 : onChangeTables(function (prevTables) {
+                var _a = __read(produceWithPatches(prevTables, function (draft) {
+                    var e_3, _a;
+                    var _b;
+                    var _loop_1 = function (table, dimensionIndex, newName) {
+                        var current = draft.find(function (candidate) { return candidate.id === table.id; });
+                        if (!current)
+                            return "continue";
+                        (_b = current.columns) !== null && _b !== void 0 ? _b : (current.columns = []);
+                        if (current.columns[dimensionIndex]) {
+                            current.columns[dimensionIndex].name = newName;
+                        }
+                        else {
+                            current.columns[dimensionIndex] = { name: newName };
+                        }
+                    };
+                    try {
+                        for (var headerRenames_1 = __values(headerRenames), headerRenames_1_1 = headerRenames_1.next(); !headerRenames_1_1.done; headerRenames_1_1 = headerRenames_1.next()) {
+                            var _c = headerRenames_1_1.value, table = _c.table, dimensionIndex = _c.dimensionIndex, newName = _c.newName;
+                            _loop_1(table, dimensionIndex, newName);
+                        }
+                    }
+                    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                    finally {
+                        try {
+                            if (headerRenames_1_1 && !headerRenames_1_1.done && (_a = headerRenames_1.return)) _a.call(headerRenames_1);
+                        }
+                        finally { if (e_3) throw e_3.error; }
+                    }
+                }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
+                saveHistory({ tables: { patches: patches, inversePatches: inversePatches } });
+                return nextState;
+            });
+        }
         // Update sheet rowCount and columnCount if values were added beyond current bounds
         onChangeSheets === null || onChangeSheets === void 0 ? void 0 : onChangeSheets(function (prevSheets) {
             var _a = __read(produceWithPatches(prevSheets, function (draft) {
@@ -191,10 +288,6 @@ export var changeBatch = function (_a) {
             });
             return nextState;
         });
-        // Save cellXfs
-        cellXfsRegistry === null || cellXfsRegistry === void 0 ? void 0 : cellXfsRegistry.getPatches(saveHistory);
-        // Save shared strings patches
-        sharedStringRegistry === null || sharedStringRegistry === void 0 ? void 0 : sharedStringRegistry.getPatches(saveHistory);
         // Update row heights when text format or wrapping changes (Excel's
         // justify / distributed alignments wrap implicitly)
         var affectsRowHeight = function (cellFormat) {
@@ -215,11 +308,11 @@ export var changeBatch = function (_a) {
         if (shouldUpdateRowHeights) {
             onChangeSheets(function (prevSheets) {
                 var _a = __read(produceWithPatches(prevSheets, function (draft) {
-                    var e_3, _a;
+                    var e_4, _a;
                     var _b, _c, _d, _e, _f;
                     var sheet = draft.find(function (sheet) { return sheet.sheetId === sheetId; });
                     if (sheet) {
-                        var _loop_1 = function (range) {
+                        var _loop_2 = function (range) {
                             var rollingRowIndex = 0;
                             for (var rowIndex = range.startRowIndex; rowIndex <= range.endRowIndex; rowIndex++) {
                                 if (Array.isArray(formatting) &&
@@ -299,15 +392,15 @@ export var changeBatch = function (_a) {
                         try {
                             for (var finalRanges_3 = __values(finalRanges), finalRanges_3_1 = finalRanges_3.next(); !finalRanges_3_1.done; finalRanges_3_1 = finalRanges_3.next()) {
                                 var range = finalRanges_3_1.value;
-                                _loop_1(range);
+                                _loop_2(range);
                             }
                         }
-                        catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                        catch (e_4_1) { e_4 = { error: e_4_1 }; }
                         finally {
                             try {
                                 if (finalRanges_3_1 && !finalRanges_3_1.done && (_a = finalRanges_3.return)) _a.call(finalRanges_3);
                             }
-                            finally { if (e_3) throw e_3.error; }
+                            finally { if (e_4) throw e_4.error; }
                         }
                     }
                 }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
@@ -319,7 +412,11 @@ export var changeBatch = function (_a) {
         }
         if (!formattingOnly && (tables === null || tables === void 0 ? void 0 : tables.length) && primaryRange && coords) {
             if (onChangeTableColumn) {
-                onChangeTableColumn(sheetId, coords, value, adjacentTable, isRowExpansion, isColumnExpansion, primaryRange);
+                // A block written right of the table names every new column from its header cell.
+                var headerValues = isColumnExpansion && Array.isArray(values)
+                    ? (_d = values[0]) === null || _d === void 0 ? void 0 : _d.map(function (cell) { return cell !== null && cell !== void 0 ? cell : undefined; })
+                    : undefined;
+                onChangeTableColumn(sheetId, coords, value, adjacentTable, isRowExpansion, isColumnExpansion, primaryRange, headerValues);
             }
             if (onChangeCalculatedColumn) {
                 var isAdjacentColumn = currentTable &&

package/dist/cjs/interface/change-calculated-column.d.ts

@@ -1,5 +1,9 @@
 import type { CellInterface } from "@rowsncolumns/common-types";
-import type { CellData, TableView } from "@rowsncolumns/spreadsheet";
+import type { CalculatedColumnFill, CellData, TableView } from "@rowsncolumns/spreadsheet";
 import type { UseOnChangeCalculatedColumnProps } from "../hooks/use-on-change-calculated-column";
-export declare const changeCalculatedColumn: <T extends CellData>({ locale, sharedStringRegistry, cellXfsRegistry, onChangeTables, onChangeSheetData, getUserEnteredValue, getSheetName, createHistory, enqueueCalculation, onCommand, }: UseOnChangeCalculatedColumnProps<T>) => (sheetId: number, coords: CellInterface, value: string | boolean | undefined, currentTable: TableView | undefined) => void;
+export declare const changeCalculatedColumn: <T extends CellData>({ locale, sharedStringRegistry, cellXfsRegistry, onChangeTables, onChangeSheetData, getUserEnteredValue, getSheetName, createHistory, enqueueCalculation, onCommand, autoCalculatedColumns, }: UseOnChangeCalculatedColumnProps<T>) => (sheetId: number, coords: CellInterface, value: string | boolean | undefined, currentTable: TableView | undefined, options?: ChangeCalculatedColumnOptions) => CalculatedColumnFill | undefined;
+export type ChangeCalculatedColumnOptions = {
+    /** Fill the column even over cells that differ from the typed formula (the smart tag's "Overwrite all cells in this column with this formula"). */
+    force?: boolean;
+};
 //# sourceMappingURL=change-calculated-column.d.ts.map

package/dist/cjs/interface/change-calculated-column.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change-calculated-column.d.ts","sourceRoot":"","sources":["../../../interface/change-calculated-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAEV,QAAQ,EACR,SAAS,EACV,MAAM,2BAA2B,CAAC;AAOnC,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAIjG,eAAO,MAAM,sBAAsB,GAChC,CAAC,SAAS,QAAQ,EAAE,wKAWlB,gCAAgC,CAAC,CAAC,CAAC,MAEpC,SAAS,MAAM,EACf,QAAQ,aAAa,EACrB,OAAO,MAAM,GAAG,OAAO,GAAG,SAAS,EACnC,cAAc,SAAS,GAAG,SAAS,SAuKpC,CAAC"}
+{"version":3,"file":"change-calculated-column.d.ts","sourceRoot":"","sources":["../../../interface/change-calculated-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAEV,oBAAoB,EAEpB,QAAQ,EACR,SAAS,EACV,MAAM,2BAA2B,CAAC;AAOnC,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAQjG,eAAO,MAAM,sBAAsB,GAChC,CAAC,SAAS,QAAQ,EAAE,+LAYlB,gCAAgC,CAAC,CAAC,CAAC,MAEpC,SAAS,MAAM,EACf,QAAQ,aAAa,EACrB,OAAO,MAAM,GAAG,OAAO,GAAG,SAAS,EACnC,cAAc,SAAS,GAAG,SAAS,EACnC,UAAU,6BAA6B,KACtC,oBAAoB,GAAG,SA8PzB,CAAC;AAEJ,MAAM,MAAM,6BAA6B,GAAG;IAC1C,mJAAmJ;IACnJ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC"}