@rowsncolumns/spreadsheet-state 29.0.0 → 29.1.1

package/dist/cjs/hooks/use-on-change-batch.d.ts

@@ -33,11 +33,12 @@ export type UseOnChangeBatchProps<T extends CellData, S extends Sheet = Sheet> =
     onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
     onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
     onChangeTables?: UseSpreadsheetProps<T, S>["onChangeTables"];
+    onChangeCharts?: UseSpreadsheetProps<T, S>["onChangeCharts"];
     onChangeCitations?: UseSpreadsheetProps<T, S>["onChangeCitations"];
     onChangeTableColumn?: (sheetId: number, coords: {
         rowIndex: number;
         columnIndex: number;
-    }, value: string | boolean | undefined, currentTable: TableView | undefined, isRowExpansion: boolean, isColumnExpansion: boolean, range: GridRange) => void;
+    }, value: string | boolean | undefined, currentTable: TableView | undefined, isRowExpansion: boolean, isColumnExpansion: boolean, range: GridRange, headerValues?: (string | boolean | number | null | undefined)[]) => void;
     onChangeCalculatedColumn?: (sheetId: number, coords: {
         rowIndex: number;
         columnIndex: number;
@@ -49,6 +50,22 @@ export type UseOnChangeBatchProps<T extends CellData, S extends Sheet = Sheet> =
     tokenizer?(value: string): ParsedToken[];
     onCommand?: OnCommand;
     generatedNames?: GeneratedNames;
+    /** `useUndoRedo`'s `batchHistory`: the writes and the table growth they trigger undo as one step when wired. */
+    batchHistory?: <R>(action: () => R) => R;
+    /**
+     * Excel's "Include new rows and columns in table" AutoCorrect option: a value typed, pasted or
+     * filled into the row below / column right of a table grows the table. `false` turns the
+     * auto-expansion off (the "Stop Automatically Expanding Tables" smart-tag action).
+     * @default true
+     */
+    autoExpandTables?: boolean;
+    /**
+     * Excel's "Fill formulas in tables to create calculated columns" AutoCorrect option. `false`
+     * leaves a formula typed into a table column a one-cell edit (the "Stop automatically creating
+     * calculated columns" smart-tag action).
+     * @default true
+     */
+    autoCalculatedColumns?: boolean;
 };
-export declare const useOnChangeBatch: <T extends CellData, K extends CellFormat, S extends Sheet = Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, enqueueCalculation, onChangeSheetData, onChangeSheets, onChangeTables, tables, createHistory, getFormattedValue, getUserEnteredValue, getCellDimensions, getRowHeight, isMergedCell, enqueueGraphOperation, getDependents, getSheetName, onChangeCitations, onCommand, generatedNames, }: UseOnChangeBatchProps<T, S>) => (sheetId: number, ranges: GridRange[] | GridRange, values: (string | boolean | number | null | undefined)[][] | string | boolean | number | null | undefined, formatting?: (K | undefined | null)[][] | K | null | undefined, citations?: (string | undefined | null)[][] | string | null | undefined, changeBatchOptions?: ChangeBatchOptions) => void;
+export declare const useOnChangeBatch: <T extends CellData, K extends CellFormat, S extends Sheet = Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, enqueueCalculation, onChangeSheetData, onChangeSheets, onChangeTables, onChangeCharts, tables, createHistory, getFormattedValue, getUserEnteredValue, getCellDimensions, getRowHeight, isMergedCell, enqueueGraphOperation, getDependents, getSheetName, onChangeCitations, onCommand, generatedNames, batchHistory, autoExpandTables, autoCalculatedColumns, }: UseOnChangeBatchProps<T, S>) => (sheetId: number, ranges: GridRange[] | GridRange, values: (string | boolean | number | null | undefined)[][] | string | boolean | number | null | undefined, formatting?: (K | undefined | null)[][] | K | null | undefined, citations?: (string | undefined | null)[][] | string | null | undefined, changeBatchOptions?: ChangeBatchOptions) => void;
 //# sourceMappingURL=use-on-change-batch.d.ts.map

package/dist/cjs/hooks/use-on-change-batch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-change-batch.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-change-batch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-on-change-batch.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-change-batch.ts"],"names":[],"mappings":"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"}

package/dist/cjs/hooks/use-on-change-batch.js

@@ -1,4 +1,4 @@
-import { __values } from "tslib";
+import { __assign, __values } from "tslib";
 import { useGetEffectiveValuesFromRange, useTokenizer, } from "@rowsncolumns/spreadsheet";
 import { useCallback } from "react";
 import { changeBatch } from "../interface/change-batch";
@@ -6,7 +6,7 @@ import { useCanEditCellRange } from "./use-can-edit-cellrange";
 import { useOnChangeCalculatedColumn } from "./use-on-change-calculated-column";
 import { useOnChangeTableColumn } from "./use-on-change-table-column";
 export var useOnChangeBatch = function (_a) {
-    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getDataValidationById = _a.getDataValidationById, enqueueCalculation = _a.enqueueCalculation, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, tables = _a.tables, createHistory = _a.createHistory, getFormattedValue = _a.getFormattedValue, getUserEnteredValue = _a.getUserEnteredValue, getCellDimensions = _a.getCellDimensions, getRowHeight = _a.getRowHeight, isMergedCell = _a.isMergedCell, enqueueGraphOperation = _a.enqueueGraphOperation, getDependents = _a.getDependents, getSheetName = _a.getSheetName, onChangeCitations = _a.onChangeCitations, onCommand = _a.onCommand, generatedNames = _a.generatedNames;
+    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getDataValidationById = _a.getDataValidationById, enqueueCalculation = _a.enqueueCalculation, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeCharts = _a.onChangeCharts, tables = _a.tables, createHistory = _a.createHistory, getFormattedValue = _a.getFormattedValue, getUserEnteredValue = _a.getUserEnteredValue, getCellDimensions = _a.getCellDimensions, getRowHeight = _a.getRowHeight, isMergedCell = _a.isMergedCell, enqueueGraphOperation = _a.enqueueGraphOperation, getDependents = _a.getDependents, getSheetName = _a.getSheetName, onChangeCitations = _a.onChangeCitations, onCommand = _a.onCommand, generatedNames = _a.generatedNames, _b = _a.batchHistory, batchHistory = _b === void 0 ? function (action) { return action(); } : _b, _c = _a.autoExpandTables, autoExpandTables = _c === void 0 ? true : _c, _d = _a.autoCalculatedColumns, autoCalculatedColumns = _d === void 0 ? true : _d;
     // Allowed values
     var getEffectiveValuesFromRange = useGetEffectiveValuesFromRange();
     var tokenizer = useTokenizer();
@@ -17,12 +17,14 @@ export var useOnChangeBatch = function (_a) {
         sharedStringRegistry: sharedStringRegistry,
         onChangeSheetData: onChangeSheetData,
         onChangeTables: onChangeTables,
+        onChangeCharts: onChangeCharts,
         getDependents: getDependents,
         enqueueCalculation: enqueueCalculation,
         enqueueGraphOperation: enqueueGraphOperation,
         createHistory: createHistory,
         onCommand: onCommand,
         generatedNames: generatedNames,
+        tables: tables,
     });
     var onChangeCalculatedColumn = useOnChangeCalculatedColumn({
         locale: locale,
@@ -35,6 +37,7 @@ export var useOnChangeBatch = function (_a) {
         createHistory: createHistory,
         enqueueCalculation: enqueueCalculation,
         onCommand: onCommand,
+        autoCalculatedColumns: autoCalculatedColumns,
     });
     return useCallback(function (sheetId, ranges, values, formatting, citations, changeBatchOptions) {
         var e_1, _a;
@@ -60,40 +63,41 @@ export var useOnChangeBatch = function (_a) {
             }
             finally { if (e_1) throw e_1.error; }
         }
-        changeBatch({
-            createHistory: createHistory,
-            enqueueCalculation: enqueueCalculation,
-            onChangeSheetData: onChangeSheetData,
-            onChangeSheets: onChangeSheets,
-            onChangeTables: onChangeTables,
-            getEffectiveValuesFromRange: getEffectiveValuesFromRange,
-            locale: locale,
-            cellXfsRegistry: cellXfsRegistry,
-            sharedStringRegistry: sharedStringRegistry,
-            getDataValidationById: getDataValidationById,
-            getFormattedValue: getFormattedValue,
-            getUserEnteredValue: getUserEnteredValue,
-            onChangeTableColumn: onChangeTableColumn,
-            onChangeCalculatedColumn: onChangeCalculatedColumn,
-            tokenizer: tokenizer,
-            getCellDimensions: getCellDimensions,
-            getRowHeight: getRowHeight,
-            isMergedCell: isMergedCell,
-            enqueueGraphOperation: enqueueGraphOperation,
-            getDependents: getDependents,
-            getSheetName: getSheetName,
-            tables: tables,
-            onChangeCitations: onChangeCitations,
-        })(sheetId, ranges, values, formatting, citations, changeBatchOptions);
-        onCommand === null || onCommand === void 0 ? void 0 : onCommand({
-            command: "change-batch",
-            sheetId: sheetId,
-            ranges: ranges,
-            values: values,
-            formatting: formatting,
-            citations: citations,
-            options: changeBatchOptions,
+        // A batch that records history opens ONE undo entry: the writes and the table growth /
+        // calculated-column fill they trigger undo together.
+        var runBatch = (changeBatchOptions === null || changeBatchOptions === void 0 ? void 0 : changeBatchOptions.enableHistory) === false
+            ? function (action) { return action(); }
+            : batchHistory;
+        runBatch(function () {
+            return changeBatch({
+                createHistory: createHistory,
+                enqueueCalculation: enqueueCalculation,
+                onChangeSheetData: onChangeSheetData,
+                onChangeSheets: onChangeSheets,
+                onChangeTables: onChangeTables,
+                getEffectiveValuesFromRange: getEffectiveValuesFromRange,
+                locale: locale,
+                cellXfsRegistry: cellXfsRegistry,
+                sharedStringRegistry: sharedStringRegistry,
+                getDataValidationById: getDataValidationById,
+                getFormattedValue: getFormattedValue,
+                getUserEnteredValue: getUserEnteredValue,
+                onChangeTableColumn: onChangeTableColumn,
+                onChangeCalculatedColumn: onChangeCalculatedColumn,
+                tokenizer: tokenizer,
+                getCellDimensions: getCellDimensions,
+                getRowHeight: getRowHeight,
+                isMergedCell: isMergedCell,
+                enqueueGraphOperation: enqueueGraphOperation,
+                getDependents: getDependents,
+                getSheetName: getSheetName,
+                tables: tables,
+                onChangeCitations: onChangeCitations,
+                autoExpandTables: autoExpandTables,
+                autoCalculatedColumns: autoCalculatedColumns,
+            })(sheetId, ranges, values, formatting, citations, changeBatchOptions);
         });
+        onCommand === null || onCommand === void 0 ? void 0 : onCommand(__assign(__assign({ command: "change-batch", sheetId: sheetId, ranges: ranges, values: values, formatting: formatting, citations: citations, options: changeBatchOptions }, (autoExpandTables ? {} : { autoExpandTables: autoExpandTables })), (autoCalculatedColumns ? {} : { autoCalculatedColumns: autoCalculatedColumns })));
     }, [
         locale,
         cellXfsRegistry,
@@ -108,6 +112,7 @@ export var useOnChangeBatch = function (_a) {
         onChangeSheets,
         getEffectiveValuesFromRange,
         onChangeTables,
+        onChangeCharts,
         getRowHeight,
         isMergedCell,
         tables,
@@ -120,5 +125,8 @@ export var useOnChangeBatch = function (_a) {
         onChangeCitations,
         onCommand,
         canEditCellRange,
+        batchHistory,
+        autoExpandTables,
+        autoCalculatedColumns,
     ]);
 };

package/dist/cjs/hooks/use-on-change-calculated-column.d.ts

@@ -2,6 +2,7 @@ import type { CellInterface } from "@rowsncolumns/common-types";
 import type { CellData, TableView } from "@rowsncolumns/spreadsheet";
 import type { Patch } from "immer";
 import type { OnCommand } from "../commands";
+import { type ChangeCalculatedColumnOptions } from "../interface/change-calculated-column";
 import type { CalculationOperation } from "./use-calculation";
 import type { CellXfsRegistry } from "./use-cellxfs-registry";
 import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
@@ -18,6 +19,14 @@ export type UseOnChangeCalculatedColumnProps<T extends CellData> = {
     enqueueCalculation(operation: CalculationOperation): void;
     createHistory: () => (patches: SpreadsheetPatch<Patch>) => void;
     onCommand?: OnCommand;
+    /**
+     * Excel's "Fill formulas in tables to create calculated columns" AutoCorrect option: a formula
+     * typed into an empty or consistently calculated table column fills the column. `false` leaves
+     * the formula a one-cell edit (the "Stop automatically creating calculated columns" smart-tag
+     * action).
+     * @default true
+     */
+    autoCalculatedColumns?: boolean;
 };
-export declare const useOnChangeCalculatedColumn: <T extends CellData>({ locale, cellXfsRegistry, sharedStringRegistry, onChangeTables, onChangeSheetData, getUserEnteredValue, getSheetName, createHistory, enqueueCalculation, onCommand, }: UseOnChangeCalculatedColumnProps<T>) => (sheetId: number, coords: CellInterface, value: string | boolean | undefined, currentTable: TableView | undefined) => void;
+export declare const useOnChangeCalculatedColumn: <T extends CellData>({ locale, cellXfsRegistry, sharedStringRegistry, onChangeTables, onChangeSheetData, getUserEnteredValue, getSheetName, createHistory, enqueueCalculation, onCommand, autoCalculatedColumns, }: UseOnChangeCalculatedColumnProps<T>) => (sheetId: number, coords: CellInterface, value: string | boolean | undefined, currentTable: TableView | undefined, options?: ChangeCalculatedColumnOptions) => import("@rowsncolumns/spreadsheet").CalculatedColumnFill | undefined;
 //# sourceMappingURL=use-on-change-calculated-column.d.ts.map

package/dist/cjs/hooks/use-on-change-calculated-column.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-change-calculated-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-change-calculated-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,gCAAgC,CAAC,CAAC,SAAS,QAAQ,IAAI;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzD,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC/D,mBAAmB,EAAE,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,CAAC;IACxB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAChE,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,QAAQ,EAAE,wKAW7D,gCAAgC,CAAC,CAAC,CAAC,eAGvB,MAAM,UACP,aAAa,SACd,MAAM,GAAG,OAAO,GAAG,SAAS,gBACrB,SAAS,GAAG,SAAS,SA4BxC,CAAC"}
+{"version":3,"file":"use-on-change-calculated-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-change-calculated-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,KAAK,6BAA6B,EAEnC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,gCAAgC,CAAC,CAAC,SAAS,QAAQ,IAAI;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzD,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC/D,mBAAmB,EAAE,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,CAAC;IACxB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAChE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,QAAQ,EAAE,+LAY7D,gCAAgC,CAAC,CAAC,CAAC,eAOvB,MAAM,UACP,aAAa,SACd,MAAM,GAAG,OAAO,GAAG,SAAS,gBACrB,SAAS,GAAG,SAAS,YACzB,6BAA6B,yEAmC5C,CAAC"}

package/dist/cjs/hooks/use-on-change-calculated-column.js

@@ -1,9 +1,14 @@
+import { useSetCalculatedColumnFill } from "@rowsncolumns/spreadsheet";
 import { useCallback } from "react";
-import { changeCalculatedColumn } from "../interface/change-calculated-column";
+import { changeCalculatedColumn, } from "../interface/change-calculated-column";
 export var useOnChangeCalculatedColumn = function (_a) {
-    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, onChangeTables = _a.onChangeTables, onChangeSheetData = _a.onChangeSheetData, getUserEnteredValue = _a.getUserEnteredValue, getSheetName = _a.getSheetName, createHistory = _a.createHistory, enqueueCalculation = _a.enqueueCalculation, onCommand = _a.onCommand;
-    return useCallback(function (sheetId, coords, value, currentTable) {
-        changeCalculatedColumn({
+    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, onChangeTables = _a.onChangeTables, onChangeSheetData = _a.onChangeSheetData, getUserEnteredValue = _a.getUserEnteredValue, getSheetName = _a.getSheetName, createHistory = _a.createHistory, enqueueCalculation = _a.enqueueCalculation, onCommand = _a.onCommand, _b = _a.autoCalculatedColumns, autoCalculatedColumns = _b === void 0 ? true : _b;
+    // Excel's AutoCorrect smart tag ("Undo Calculated Column" / "Overwrite all cells in this column
+    // with this formula" / "Stop automatically creating calculated columns"); `CanvasGrid` renders
+    // and dismisses it.
+    var setCalculatedColumnFill = useSetCalculatedColumnFill();
+    return useCallback(function (sheetId, coords, value, currentTable, options) {
+        var fill = changeCalculatedColumn({
             locale: locale,
             cellXfsRegistry: cellXfsRegistry,
             sharedStringRegistry: sharedStringRegistry,
@@ -14,7 +19,12 @@ export var useOnChangeCalculatedColumn = function (_a) {
             createHistory: createHistory,
             enqueueCalculation: enqueueCalculation,
             onCommand: onCommand,
-        })(sheetId, coords, value, currentTable);
+            autoCalculatedColumns: autoCalculatedColumns,
+        })(sheetId, coords, value, currentTable, options);
+        if (fill) {
+            setCalculatedColumnFill(fill);
+        }
+        return fill;
     }, [
         locale,
         cellXfsRegistry,
@@ -26,5 +36,7 @@ export var useOnChangeCalculatedColumn = function (_a) {
         createHistory,
         enqueueCalculation,
         onCommand,
+        autoCalculatedColumns,
+        setCalculatedColumnFill,
     ]);
 };

package/dist/cjs/hooks/use-on-change-table-column.d.ts

@@ -14,12 +14,17 @@ export type UseOnChangeTableColumnProps<T extends CellData, S extends Sheet> = {
     sharedStringRegistry?: SharedStringRegistry;
     onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
     onChangeTables: UseSpreadsheetProps<T, S>["onChangeTables"];
+    onChangeCharts?: UseSpreadsheetProps<T, S>["onChangeCharts"];
     enqueueCalculation(operation: CalculationOperation): void;
     enqueueGraphOperation(operation: CalculationOperation): void;
     getDependents: ReturnType<typeof useCalculation>["getDependents"];
+    /** Resolves same-sheet references when a new row inherits a calculated column. */
+    getSheetName?: (sheetId: number) => string;
     createHistory: () => (patches: SpreadsheetPatch<Patch>) => void;
     onCommand?: OnCommand;
     generatedNames?: GeneratedNames;
+    /** The document's tables — a column expansion never grows over a column another table occupies. */
+    tables?: readonly TableView[];
 };
-export declare const useOnChangeTableColumn: <T extends CellData, S extends Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, onChangeSheetData, onChangeTables, getDependents, enqueueCalculation, enqueueGraphOperation, createHistory, onCommand, generatedNames, }: UseOnChangeTableColumnProps<T, S>) => (sheetId: number, coords: CellInterface, value: string | boolean | undefined, currentTable: TableView | undefined, isRowExpansion: boolean, isColumnExpansion: boolean, range: GridRange) => void;
+export declare const useOnChangeTableColumn: <T extends CellData, S extends Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, onChangeSheetData, onChangeTables, onChangeCharts, getDependents, getSheetName, enqueueCalculation, enqueueGraphOperation, createHistory, onCommand, generatedNames, tables, }: UseOnChangeTableColumnProps<T, S>) => (sheetId: number, coords: CellInterface, value: string | boolean | undefined, currentTable: TableView | undefined, isRowExpansion: boolean, isColumnExpansion: boolean, range: GridRange, headerValues?: (string | boolean | number | null | undefined)[]) => void;
 //# sourceMappingURL=use-on-change-table-column.d.ts.map

package/dist/cjs/hooks/use-on-change-table-column.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-change-table-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-change-table-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,qBAAqB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAE7D,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAChE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,2LAYzE,2BAA2B,CAAC,CAAC,EAAE,CAAC,CAAC,eAIrB,MAAM,UACP,aAAa,SACd,MAAM,GAAG,OAAO,GAAG,SAAS,gBACrB,SAAS,GAAG,SAAS,kBACnB,OAAO,qBACJ,OAAO,SACnB,SAAS,SA4DrB,CAAC"}
+{"version":3,"file":"use-on-change-table-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-change-table-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,cAAc,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7D,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,qBAAqB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAE7D,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,kFAAkF;IAClF,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAChE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,mGAAmG;IACnG,MAAM,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,iOAezE,2BAA2B,CAAC,CAAC,EAAE,CAAC,CAAC,eAOrB,MAAM,UACP,aAAa,SACd,MAAM,GAAG,OAAO,GAAG,SAAS,gBACrB,SAAS,GAAG,SAAS,kBACnB,OAAO,qBACJ,OAAO,SACnB,SAAS,iBACD,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,SAsEpE,CAAC"}

package/dist/cjs/hooks/use-on-change-table-column.js

@@ -1,23 +1,32 @@
-import { useTokenizer } from "@rowsncolumns/spreadsheet";
+import { useSetTableAutoExpansion, useTokenizer, } from "@rowsncolumns/spreadsheet";
 import { useCallback } from "react";
 import { changeTableColumn } from "../interface/change-table-column";
 export var useOnChangeTableColumn = function (_a) {
-    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, onChangeSheetData = _a.onChangeSheetData, onChangeTables = _a.onChangeTables, getDependents = _a.getDependents, enqueueCalculation = _a.enqueueCalculation, enqueueGraphOperation = _a.enqueueGraphOperation, createHistory = _a.createHistory, onCommand = _a.onCommand, generatedNames = _a.generatedNames;
+    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, onChangeSheetData = _a.onChangeSheetData, onChangeTables = _a.onChangeTables, onChangeCharts = _a.onChangeCharts, getDependents = _a.getDependents, getSheetName = _a.getSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueGraphOperation = _a.enqueueGraphOperation, createHistory = _a.createHistory, onCommand = _a.onCommand, generatedNames = _a.generatedNames, tables = _a.tables;
     var tokenizer = useTokenizer();
-    return useCallback(function (sheetId, coords, value, currentTable, isRowExpansion, isColumnExpansion, range) {
-        changeTableColumn({
+    // Excel's AutoCorrect smart tag ("Undo Table AutoExpansion" / "Stop Automatically Expanding
+    // Tables") is armed on every growth; `CanvasGrid` renders and dismisses it.
+    var setTableAutoExpansion = useSetTableAutoExpansion();
+    return useCallback(function (sheetId, coords, value, currentTable, isRowExpansion, isColumnExpansion, range, headerValues) {
+        var expansion = changeTableColumn({
             locale: locale,
             cellXfsRegistry: cellXfsRegistry,
             sharedStringRegistry: sharedStringRegistry,
             onChangeSheetData: onChangeSheetData,
             onChangeTables: onChangeTables,
+            onChangeCharts: onChangeCharts,
             getDependents: getDependents,
+            getSheetName: getSheetName,
             enqueueCalculation: enqueueCalculation,
             enqueueGraphOperation: enqueueGraphOperation,
             createHistory: createHistory,
             tokenizer: tokenizer,
             generatedNames: generatedNames,
-        })(sheetId, coords, value, currentTable, isRowExpansion, isColumnExpansion, range);
+            tables: tables,
+        })(sheetId, coords, value, currentTable, isRowExpansion, isColumnExpansion, range, headerValues);
+        if (expansion) {
+            setTableAutoExpansion(expansion);
+        }
         // A header-cell edit on an existing column is a rename — stream the intent so the engine
         // updates its header list + redefines the table (structured refs resolve to the new name).
         // Column expansion (adding a column) rides update-table; this is only the in-place rename.
@@ -42,6 +51,7 @@ export var useOnChangeTableColumn = function (_a) {
         sharedStringRegistry,
         onChangeSheetData,
         onChangeTables,
+        onChangeCharts,
         getDependents,
         enqueueCalculation,
         enqueueGraphOperation,
@@ -49,5 +59,7 @@ export var useOnChangeTableColumn = function (_a) {
         tokenizer,
         onCommand,
         generatedNames,
+        tables,
+        setTableAutoExpansion,
     ]);
 };

package/dist/cjs/hooks/use-on-change.d.ts

@@ -25,8 +25,11 @@ export type UseOnChangeProps<T extends CellData, S extends Sheet> = {
     getDataValidationById?: ReturnType<typeof useSheetProperties>["getDataValidationById"];
     onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
     onChangeTables: UseSpreadsheetProps<T, S>["onChangeTables"];
+    onChangeCharts?: UseSpreadsheetProps<T, S>["onChangeCharts"];
     onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
     getDependents: ReturnType<typeof useCalculation>["getDependents"];
+    /** Formula cells to sweep for a header-cell rename; without it the sheet data is swept. */
+    getGraphNodes?: ReturnType<typeof useCalculation>["getGraphNodes"];
     enqueueCalculation(operation: CalculationOperation): void;
     enqueueGraphOperation(operation: CalculationOperation): void;
     createHistory: () => (patches: SpreadsheetPatch<Patch>) => void;
@@ -44,18 +47,48 @@ export type UseOnChangeProps<T extends CellData, S extends Sheet> = {
      */
     onCommand?: OnCommand;
     generatedNames?: GeneratedNames;
+    /** `useUndoRedo`'s `batchHistory`: the cell write and the table growth it triggers undo as one step when wired. */
+    batchHistory?: <R>(action: () => R) => R;
+    /**
+     * Scratch-evaluates a formula (`useCalculation`'s `onRequestCalculate`). A formula typed into a
+     * table header cell is stored as its RESULT text, like Excel; without it the formula is left as
+     * typed.
+     */
+    onRequestCalculate?: (value: string, sheetId: number, rowIndex: number, columnIndex: number, options?: {
+        disablePreview?: boolean;
+    }) => Promise<unknown>;
+    /**
+     * Excel's "Include new rows and columns in table" AutoCorrect option: a value typed, pasted or
+     * filled into the row below / column right of a table grows the table. `false` turns the
+     * auto-expansion off (the "Stop Automatically Expanding Tables" smart-tag action).
+     * @default true
+     */
+    autoExpandTables?: boolean;
+    /**
+     * Excel's "Fill formulas in tables to create calculated columns" AutoCorrect option. `false`
+     * leaves a formula typed into a table column a one-cell edit (the "Stop automatically creating
+     * calculated columns" smart-tag action).
+     * @default true
+     */
+    autoCalculatedColumns?: boolean;
 };
 /**
  * Change handler
- * Undo history order
+ * One undo step covers, in order:
  * 1. Cell change
  * 2. If Table
- *  1. Add column
+ *  1. Add column / row
  *  2. If computed column - Fill all computed columns
  *
  * Refactor use-on-change and use-on-paste.
  * @param param0
  * @returns
  */
-export declare const useOnChange: <T extends CellData, S extends Sheet>({ locale, tables, cellXfsRegistry, sharedStringRegistry, getUserEnteredValue, getTextFormatRuns, onChangeSheetData, onChangeTables, onChangeSheets, getDependents, enqueueCalculation, enqueueGraphOperation, createHistory, getDataValidationById, getSheetName, onCommand, generatedNames, }: UseOnChangeProps<T, S>) => (sheetId: number, coords: CellInterface, value: string, textFormatRuns: TextFormatRun[] | undefined | null, previousValue?: string | boolean | undefined, isDirty?: boolean, previousTextFormatRuns?: TextFormatRun[] | undefined | null) => void;
+type OnChangeOptions = {
+    /** The value is a header formula's evaluated result — stored as text as-is. */
+    headerResult?: boolean;
+};
+type OnChangeHandler = (sheetId: number, coords: CellInterface, value: string, textFormatRuns: TextFormatRun[] | undefined | null, previousValue?: string | boolean | undefined, isDirty?: boolean, previousTextFormatRuns?: TextFormatRun[] | undefined | null, options?: OnChangeOptions) => void;
+export declare const useOnChange: <T extends CellData, S extends Sheet>({ locale, tables, cellXfsRegistry, sharedStringRegistry, getUserEnteredValue, getTextFormatRuns, onChangeSheetData, onChangeTables, onChangeCharts, onChangeSheets, getDependents, getGraphNodes, enqueueCalculation, enqueueGraphOperation, createHistory, getDataValidationById, getSheetName, onCommand, generatedNames, batchHistory, onRequestCalculate, autoExpandTables, autoCalculatedColumns, }: UseOnChangeProps<T, S>) => OnChangeHandler;
+export {};
 //# sourceMappingURL=use-on-change.d.ts.map

package/dist/cjs/hooks/use-on-change.d.ts.map

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