@rowsncolumns/spreadsheet-state 29.0.0 → 29.1.1

package/dist/esm/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/esm/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/esm/hooks/use-on-change-calculated-column.js

@@ -1,8 +1,13 @@
+import { useSetCalculatedColumnFill } from "@rowsncolumns/spreadsheet";
 import { useCallback } from "react";
-import { changeCalculatedColumn } from "../interface/change-calculated-column";
-export const useOnChangeCalculatedColumn = ({ locale, cellXfsRegistry, sharedStringRegistry, onChangeTables, onChangeSheetData, getUserEnteredValue, getSheetName, createHistory, enqueueCalculation, onCommand, }) => {
-    return useCallback((sheetId, coords, value, currentTable) => {
-        changeCalculatedColumn({
+import { changeCalculatedColumn, } from "../interface/change-calculated-column";
+export const useOnChangeCalculatedColumn = ({ locale, cellXfsRegistry, sharedStringRegistry, onChangeTables, onChangeSheetData, getUserEnteredValue, getSheetName, createHistory, enqueueCalculation, onCommand, autoCalculatedColumns = true, }) => {
+    // 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.
+    const setCalculatedColumnFill = useSetCalculatedColumnFill();
+    return useCallback((sheetId, coords, value, currentTable, options) => {
+        const fill = changeCalculatedColumn({
             locale,
             cellXfsRegistry,
             sharedStringRegistry,
@@ -13,7 +18,12 @@ export const useOnChangeCalculatedColumn = ({ locale, cellXfsRegistry, sharedStr
             createHistory,
             enqueueCalculation,
             onCommand,
-        })(sheetId, coords, value, currentTable);
+            autoCalculatedColumns,
+        })(sheetId, coords, value, currentTable, options);
+        if (fill) {
+            setCalculatedColumnFill(fill);
+        }
+        return fill;
     }, [
         locale,
         cellXfsRegistry,
@@ -25,5 +35,7 @@ export const useOnChangeCalculatedColumn = ({ locale, cellXfsRegistry, sharedStr
         createHistory,
         enqueueCalculation,
         onCommand,
+        autoCalculatedColumns,
+        setCalculatedColumnFill,
     ]);
 };

package/dist/esm/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/esm/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/esm/hooks/use-on-change-table-column.js

@@ -1,22 +1,31 @@
-import { useTokenizer } from "@rowsncolumns/spreadsheet";
+import { useSetTableAutoExpansion, useTokenizer, } from "@rowsncolumns/spreadsheet";
 import { useCallback } from "react";
 import { changeTableColumn } from "../interface/change-table-column";
-export const useOnChangeTableColumn = ({ locale, cellXfsRegistry, sharedStringRegistry, onChangeSheetData, onChangeTables, getDependents, enqueueCalculation, enqueueGraphOperation, createHistory, onCommand, generatedNames, }) => {
+export const useOnChangeTableColumn = ({ locale, cellXfsRegistry, sharedStringRegistry, onChangeSheetData, onChangeTables, onChangeCharts, getDependents, getSheetName, enqueueCalculation, enqueueGraphOperation, createHistory, onCommand, generatedNames, tables, }) => {
     const tokenizer = useTokenizer();
-    return useCallback((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.
+    const setTableAutoExpansion = useSetTableAutoExpansion();
+    return useCallback((sheetId, coords, value, currentTable, isRowExpansion, isColumnExpansion, range, headerValues) => {
+        const expansion = changeTableColumn({
             locale,
             cellXfsRegistry,
             sharedStringRegistry,
             onChangeSheetData,
             onChangeTables,
+            onChangeCharts,
             getDependents,
+            getSheetName,
             enqueueCalculation,
             enqueueGraphOperation,
             createHistory,
             tokenizer,
             generatedNames,
-        })(sheetId, coords, value, currentTable, isRowExpansion, isColumnExpansion, range);
+            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.
@@ -41,6 +50,7 @@ export const useOnChangeTableColumn = ({ locale, cellXfsRegistry, sharedStringRe
         sharedStringRegistry,
         onChangeSheetData,
         onChangeTables,
+        onChangeCharts,
         getDependents,
         enqueueCalculation,
         enqueueGraphOperation,
@@ -48,5 +58,7 @@ export const useOnChangeTableColumn = ({ locale, cellXfsRegistry, sharedStringRe
         tokenizer,
         onCommand,
         generatedNames,
+        tables,
+        setTableAutoExpansion,
     ]);
 };

package/dist/esm/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/esm/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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"}