@rowsncolumns/spreadsheet-state 29.0.0 → 29.1.0

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

@@ -1,24 +1,26 @@
 import { __assign, __awaiter, __generator, __read } from "tslib";
-import { areaIntersects, selectionFromActiveCell } from "@rowsncolumns/grid";
+import { areaIntersects, isAreasEqual, selectionFromActiveCell, } from "@rowsncolumns/grid";
 import { isCellWithinBounds } from "@rowsncolumns/grid";
-import { uuid } from "@rowsncolumns/utils";
+import { tableIdDuplicateMessage, uuid, validateTableName, } from "@rowsncolumns/utils";
 import { produceWithPatches } from "immer";
 import { useCallback } from "react";
-import { getConfictingTable } from "../helpers";
-import { createTable } from "../interface/create-table";
+import { getShiftCellsRefusal, getTableEditRefusal, getTableRangeRefusal, shiftBand, } from "../api/structural-guards";
+import { createTable, resolveCreateTableRange, } from "../interface/create-table";
 import { deleteTableColumn } from "../interface/delete-table-column";
 import { insertTableColumn } from "../interface/insert-column";
 import { removeTable } from "../interface/remove-table";
-import { updateTable } from "../interface/update-table";
+import { tableHeaderRowAboveIsFree, tableRowHasContent, } from "../interface/table-utils";
+import { resolveUpdatedTableRange, updateTable, } from "../interface/update-table";
 import { useShowError } from "./../atoms/error-state.atom";
 import { SHEET_PROTECTION_ERROR_TITLE, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
 import { getHiddenRowsFromFilterSpecs } from "./use-on-filter-table";
 export var useOnTable = function (_a) {
-    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, rowCount = _a.rowCount, columnCount = _a.columnCount, tables = _a.tables, basicFilter = _a.basicFilter, spreadsheetTheme = _a.theme, idCreationStrategy = _a.idCreationStrategy, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, createHistory = _a.createHistory, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeSheetData = _a.onChangeSheetData, getFormattedValue = _a.getFormattedValue, getEffectiveValue = _a.getEffectiveValue, onRequestCalculate = _a.onRequestCalculate, getDependents = _a.getDependents, enqueueGraphOperation = _a.enqueueGraphOperation, getContentfulRangeAroundCell = _a.getContentfulRangeAroundCell, getSheetName = _a.getSheetName, onCommand = _a.onCommand, generatedNames = _a.generatedNames;
+    var locale = _a.locale, batchHistory = _a.batchHistory, sheetData = _a.sheetData, sheets = _a.sheets, getActiveCell = _a.getActiveCell, getSelections = _a.getSelections, onChangeCitations = _a.onChangeCitations, onChangeCharts = _a.onChangeCharts, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, rowCount = _a.rowCount, columnCount = _a.columnCount, tables = _a.tables, namedRanges = _a.namedRanges, basicFilter = _a.basicFilter, spreadsheetTheme = _a.theme, idCreationStrategy = _a.idCreationStrategy, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, createHistory = _a.createHistory, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeSheetData = _a.onChangeSheetData, getFormattedValue = _a.getFormattedValue, getEffectiveValue = _a.getEffectiveValue, onRequestCalculate = _a.onRequestCalculate, getDependents = _a.getDependents, getGraphNodes = _a.getGraphNodes, getBandedCells = _a.getBandedCells, enqueueGraphOperation = _a.enqueueGraphOperation, getContentfulRangeAroundCell = _a.getContentfulRangeAroundCell, getSheetName = _a.getSheetName, onCommand = _a.onCommand, generatedNames = _a.generatedNames, getArrayRanges = _a.getArrayRanges, onChangeDataValidations = _a.onChangeDataValidations, onChangeConditionalFormats = _a.onChangeConditionalFormats;
     var showError = useShowError();
     var canPerformSheetAction = useCanPerformSheetAction();
     // Create a new table
-    var onCreateTable = useCallback(function (sheetId, activeCell, selections, tableSpec, theme, bandedRange) {
+    var onCreateTable = useCallback(function (sheetId, activeCell, selections, tableSpec, theme, bandedRange, options) {
+        var _a;
         // Validate
         var lastSelection = selections === null || selections === void 0 ? void 0 : selections[selections.length - 1];
         // Check basicFilter intersection
@@ -30,42 +32,105 @@ export var useOnTable = function (_a) {
             });
             return;
         }
-        // Check if this selection intersects
-        var tableIntersects = tables === null || tables === void 0 ? void 0 : tables.find(function (table) {
-            return areaIntersects(table.range, lastSelection === null || lastSelection === void 0 ? void 0 : lastSelection.range) &&
-                table.sheetId === sheetId;
-        });
-        if (tableIntersects) {
+        if ((tableSpec === null || tableSpec === void 0 ? void 0 : tableSpec.id) !== undefined &&
+            (tables === null || tables === void 0 ? void 0 : tables.some(function (table) { return table.id === tableSpec.id; }))) {
             showError({
                 title: "Error",
-                message: "You cannot create a table that spans another table.",
+                message: tableIdDuplicateMessage(tableSpec.id),
             });
             return;
         }
-        createTable({
-            locale: locale,
-            rowCount: rowCount,
-            columnCount: columnCount,
-            tables: tables,
-            basicFilter: basicFilter,
-            cellXfsRegistry: cellXfsRegistry,
-            sharedStringRegistry: sharedStringRegistry,
-            theme: spreadsheetTheme,
-            idCreationStrategy: idCreationStrategy,
-            enqueueCalculation: enqueueCalculation,
-            createHistory: createHistory,
-            onChangeSheets: onChangeSheets,
-            onChangeTables: onChangeTables,
-            onChangeSheetData: onChangeSheetData,
-            getFormattedValue: getFormattedValue,
-            getEffectiveValue: getEffectiveValue,
-            onRequestCalculate: onRequestCalculate,
-            getDependents: getDependents,
-            enqueueGraphOperation: enqueueGraphOperation,
+        var titleError = (tableSpec === null || tableSpec === void 0 ? void 0 : tableSpec.title) !== undefined
+            ? validateTableName(tableSpec.title, tables === null || tables === void 0 ? void 0 : tables.map(function (table) { return table.title; }), namedRanges === null || namedRanges === void 0 ? void 0 : namedRanges.map(function (namedRange) { return namedRange.name; }))
+            : undefined;
+        if (titleError) {
+            showError({ title: "Error", message: titleError });
+            return;
+        }
+        var dataRange = resolveCreateTableRange({
+            sheetId: sheetId,
+            activeCell: activeCell,
+            selections: selections,
+            tableSpec: tableSpec,
             getContentfulRangeAroundCell: getContentfulRangeAroundCell,
-            getSheetName: getSheetName,
-            generatedNames: generatedNames,
-        })(sheetId, activeCell, selections, tableSpec, theme, bandedRange);
+        });
+        var merges = (_a = sheets === null || sheets === void 0 ? void 0 : sheets.find(function (sheet) { return sheet.sheetId === sheetId; })) === null || _a === void 0 ? void 0 : _a.merges;
+        // "My table has headers" unchecked: the header row is inserted by shifting the range's
+        // columns down one row — refused (Excel) when that would tear a merge, table or array or
+        // push a non-blank cell off the sheet.
+        var insertsHeaderRow = (options === null || options === void 0 ? void 0 : options.hasHeaders) === false;
+        var headerRowInsert = insertsHeaderRow
+            ? __assign(__assign({}, dataRange), { endRowIndex: dataRange.startRowIndex }) : undefined;
+        if (headerRowInsert) {
+            var refusal = getShiftCellsRefusal({
+                direction: "down",
+                range: headerRowInsert,
+                sheetId: sheetId,
+                rows: sheetData === null || sheetData === void 0 ? void 0 : sheetData[sheetId],
+                rowCount: rowCount,
+                merges: merges,
+                tables: tables,
+            });
+            if (refusal) {
+                showError({ title: refusal.title, message: refusal.message });
+                return;
+            }
+        }
+        // Excel: a table cannot overlap another table or cover merged cells (T-07) — judged on the
+        // range the table will cover; with an inserted header row, tables and merges wholly inside
+        // the shifted columns have moved down one row by then.
+        var rangeRefusal = getTableRangeRefusal({
+            sheetId: sheetId,
+            range: headerRowInsert
+                ? __assign(__assign({}, dataRange), { endRowIndex: dataRange.endRowIndex + 1 }) : dataRange,
+            tables: tables,
+            merges: merges,
+            insertedRows: headerRowInsert
+                ? { band: shiftBand("down", headerRowInsert), count: 1 }
+                : undefined,
+        });
+        if (rangeRefusal) {
+            showError(rangeRefusal);
+            return;
+        }
+        var create = function () {
+            return createTable({
+                locale: locale,
+                rowCount: rowCount,
+                columnCount: columnCount,
+                tables: tables,
+                namedRanges: namedRanges,
+                basicFilter: basicFilter,
+                cellXfsRegistry: cellXfsRegistry,
+                sharedStringRegistry: sharedStringRegistry,
+                theme: spreadsheetTheme,
+                idCreationStrategy: idCreationStrategy,
+                enqueueCalculation: enqueueCalculation,
+                enqueueStructureChange: enqueueStructureChange,
+                createHistory: createHistory,
+                onChangeSheets: onChangeSheets,
+                onChangeTables: onChangeTables,
+                onChangeSheetData: onChangeSheetData,
+                onChangeCitations: onChangeCitations,
+                onChangeCharts: onChangeCharts,
+                getActiveCell: getActiveCell,
+                getSelections: getSelections,
+                getFormattedValue: getFormattedValue,
+                getEffectiveValue: getEffectiveValue,
+                onRequestCalculate: onRequestCalculate,
+                getDependents: getDependents,
+                enqueueGraphOperation: enqueueGraphOperation,
+                getContentfulRangeAroundCell: getContentfulRangeAroundCell,
+                getSheetName: getSheetName,
+                generatedNames: generatedNames,
+            })(sheetId, activeCell, selections, tableSpec, theme, bandedRange, options);
+        };
+        if (insertsHeaderRow && batchHistory) {
+            batchHistory(create);
+        }
+        else {
+            create();
+        }
         onCommand === null || onCommand === void 0 ? void 0 : onCommand({
             command: "create-table",
             sheetId: sheetId,
@@ -74,10 +139,20 @@ export var useOnTable = function (_a) {
             tableSpec: tableSpec,
             theme: theme,
             bandedRange: bandedRange,
+            hasHeaders: options === null || options === void 0 ? void 0 : options.hasHeaders,
         });
     }, [
         locale,
+        batchHistory,
+        sheetData,
+        sheets,
+        getActiveCell,
+        getSelections,
+        onChangeCitations,
+        onChangeCharts,
+        enqueueStructureChange,
         tables,
+        namedRanges,
         basicFilter,
         columnCount,
         cellXfsRegistry,
@@ -103,33 +178,134 @@ export var useOnTable = function (_a) {
     // Remove table
     var onRemoveTable = useCallback(function (tableView) {
         removeTable({
+            locale: locale,
+            cellXfsRegistry: cellXfsRegistry,
+            sharedStringRegistry: sharedStringRegistry,
+            getSheetName: getSheetName,
             onChangeTables: onChangeTables,
             onChangeSheets: onChangeSheets,
+            onChangeSheetData: onChangeSheetData,
             createHistory: createHistory,
             getDependents: getDependents,
+            getGraphNodes: getGraphNodes,
+            getBandedCells: getBandedCells,
             enqueueCalculation: enqueueCalculation,
+            enqueueGraphOperation: enqueueGraphOperation,
         })(tableView);
         onCommand === null || onCommand === void 0 ? void 0 : onCommand({ command: "remove-table", tableView: tableView });
     }, [
+        locale,
+        cellXfsRegistry,
+        sharedStringRegistry,
+        getSheetName,
         onChangeTables,
         getDependents,
+        getGraphNodes,
+        getBandedCells,
         enqueueCalculation,
+        enqueueGraphOperation,
         onChangeSheets,
+        onChangeSheetData,
         createHistory,
         onCommand,
     ]);
     // Update a table
     var onUpdateTable = useCallback(function (sheetId, tableId, updatedTable) {
+        var _a;
+        var table = tables === null || tables === void 0 ? void 0 : tables.find(function (table) { return table.id === tableId; });
+        var titleError = table &&
+            updatedTable.title !== undefined &&
+            updatedTable.title !== table.title
+            ? validateTableName(updatedTable.title, tables === null || tables === void 0 ? void 0 : tables.filter(function (t) { return t.id !== tableId; }).map(function (t) { return t.title; }), namedRanges === null || namedRanges === void 0 ? void 0 : namedRanges.map(function (namedRange) { return namedRange.name; }))
+            : undefined;
+        if (titleError) {
+            showError({ title: "Error", message: titleError });
+            return;
+        }
+        // Switching Total Row on over an occupied row shifts the table's column
+        // band down (`updateTable`); Excel refuses that shift when it would tear
+        // another table, a merge or an array, or push content off the sheet.
+        var totalRowShift = table &&
+            !table.totalRow &&
+            updatedTable.totalRow === true &&
+            tableRowHasContent(sheetData === null || sheetData === void 0 ? void 0 : sheetData[sheetId], table.range.endRowIndex + 1, table.range.startColumnIndex, table.range.endColumnIndex)
+            ? {
+                startRowIndex: table.range.endRowIndex + 1,
+                endRowIndex: table.range.endRowIndex + 1,
+                startColumnIndex: table.range.startColumnIndex,
+                endColumnIndex: table.range.endColumnIndex,
+            }
+            : undefined;
+        var merges = (_a = sheets === null || sheets === void 0 ? void 0 : sheets.find(function (sheet) { return sheet.sheetId === sheetId; })) === null || _a === void 0 ? void 0 : _a.merges;
+        if (totalRowShift) {
+            var refusal = getShiftCellsRefusal({
+                direction: "down",
+                range: totalRowShift,
+                sheetId: sheetId,
+                rows: sheetData === null || sheetData === void 0 ? void 0 : sheetData[sheetId],
+                rowCount: rowCount,
+                merges: merges,
+                tables: tables,
+                arrayRanges: getArrayRanges === null || getArrayRanges === void 0 ? void 0 : getArrayRanges(sheetId),
+            });
+            if (refusal) {
+                showError({ title: refusal.title, message: refusal.message });
+                return;
+            }
+        }
+        // Excel: the table's new range (an edited range, a total row switched on, or a header row
+        // re-added above the data) cannot overlap another table or cover merged cells (T-07). An
+        // unchanged range is not re-judged; with the occupied-row shift above, tables and merges
+        // wholly inside the shifted band are judged one row lower.
+        var nextRange = table &&
+            resolveUpdatedTableRange(table, updatedTable, {
+                headerRowAboveIsFree: tableHeaderRowAboveIsFree({
+                    sheetId: sheetId,
+                    table: table,
+                    sheetData: sheetData,
+                    tables: tables,
+                }),
+            });
+        var rangeRefusal = table && nextRange && !isAreasEqual(nextRange, table.range)
+            ? getTableRangeRefusal({
+                sheetId: sheetId,
+                range: nextRange,
+                tables: tables,
+                merges: merges,
+                excludeTableId: tableId,
+                insertedRows: totalRowShift
+                    ? { band: shiftBand("down", totalRowShift), count: 1 }
+                    : undefined,
+            })
+            : undefined;
+        if (rangeRefusal) {
+            showError(rangeRefusal);
+            return;
+        }
         updateTable({
             locale: locale,
             enqueueCalculation: enqueueCalculation,
+            enqueueGraphOperation: enqueueGraphOperation,
+            getGraphNodes: getGraphNodes,
             createHistory: createHistory,
             onChangeTables: onChangeTables,
             onChangeSheetData: onChangeSheetData,
             getFormattedValue: getFormattedValue,
             getDependents: getDependents,
             tables: tables,
+            namedRanges: namedRanges,
             generatedNames: generatedNames,
+            sheetData: sheetData,
+            rowCount: rowCount,
+            columnCount: columnCount,
+            cellXfsRegistry: cellXfsRegistry,
+            sharedStringRegistry: sharedStringRegistry,
+            getSheetName: getSheetName,
+            getActiveCell: getActiveCell,
+            enqueueStructureChange: enqueueStructureChange,
+            onChangeSheets: onChangeSheets,
+            onChangeDataValidations: onChangeDataValidations,
+            onChangeConditionalFormats: onChangeConditionalFormats,
         })(sheetId, tableId, updatedTable);
         onCommand === null || onCommand === void 0 ? void 0 : onCommand({
             command: "update-table",
@@ -140,14 +316,33 @@ export var useOnTable = function (_a) {
     }, [
         locale,
         tables,
+        namedRanges,
+        sheets,
+        showError,
         createHistory,
         getFormattedValue,
         onChangeTables,
         onChangeSheetData,
         enqueueCalculation,
+        enqueueGraphOperation,
+        getGraphNodes,
         getDependents,
         onCommand,
         generatedNames,
+        sheetData,
+        sheets,
+        getArrayRanges,
+        rowCount,
+        columnCount,
+        cellXfsRegistry,
+        sharedStringRegistry,
+        getSheetName,
+        getActiveCell,
+        enqueueGraphOperation,
+        enqueueStructureChange,
+        onChangeSheets,
+        onChangeDataValidations,
+        onChangeConditionalFormats,
     ]);
     /**
      * Create a basic filter
@@ -273,12 +468,16 @@ export var useOnTable = function (_a) {
     /**
      * Insert table column
      */
-    var onInsertTableColumn = useCallback(function (tableView, dimensionIndex, direction) {
-        // Validate
-        if (getConfictingTable(tables, tableView)) {
-            showError({
-                message: "You cannot insert or delete cells over part of a table.",
-            });
+    var onInsertTableColumn = useCallback(function (tableView, dimensionIndex, direction, count) {
+        // Excel refuses a table-column insert whose shifted band would tear another table (T-47).
+        var refusal = getTableEditRefusal({
+            sheetId: tableView.sheetId,
+            table: tableView,
+            axis: "column",
+            tables: tables,
+        });
+        if (refusal) {
+            showError({ title: refusal.title, message: refusal.message });
             return;
         }
         insertTableColumn({
@@ -293,17 +492,19 @@ export var useOnTable = function (_a) {
             onChangeTables: onChangeTables,
             onChangeSheets: onChangeSheets,
             onChangeSheetData: onChangeSheetData,
+            onChangeCharts: onChangeCharts,
             enqueueCalculation: enqueueCalculation,
             enqueueStructureChange: enqueueStructureChange,
             enqueueGraphOperation: enqueueGraphOperation,
             getDependents: getDependents,
             generatedNames: generatedNames,
-        })(tableView, dimensionIndex, direction);
+        })(tableView, dimensionIndex, direction, count);
         onCommand === null || onCommand === void 0 ? void 0 : onCommand({
             command: "insert-table-column",
             tableView: tableView,
             dimensionIndex: dimensionIndex,
             direction: direction,
+            count: count,
         });
     }, [
         tables,
@@ -317,6 +518,7 @@ export var useOnTable = function (_a) {
         onChangeTables,
         onChangeSheets,
         onChangeSheetData,
+        onChangeCharts,
         enqueueCalculation,
         enqueueStructureChange,
         enqueueGraphOperation,
@@ -327,11 +529,15 @@ export var useOnTable = function (_a) {
     ]);
     // Delete a table column
     var onDeleteTableColumn = useCallback(function (tableView, dimensionIndex) {
-        // Validate - keep React-specific validation at hook level
-        if (getConfictingTable(tables, tableView)) {
-            showError({
-                message: "You cannot insert or delete cells over part of a table.",
-            });
+        // Excel refuses a table-column delete whose shifted band would tear another table (T-47).
+        var refusal = getTableEditRefusal({
+            sheetId: tableView.sheetId,
+            table: tableView,
+            axis: "column",
+            tables: tables,
+        });
+        if (refusal) {
+            showError({ title: refusal.title, message: refusal.message });
             return;
         }
         deleteTableColumn({
@@ -345,6 +551,7 @@ export var useOnTable = function (_a) {
             onChangeTables: onChangeTables,
             onChangeSheets: onChangeSheets,
             onChangeSheetData: onChangeSheetData,
+            onChangeCharts: onChangeCharts,
             enqueueCalculation: enqueueCalculation,
             enqueueStructureChange: enqueueStructureChange,
             enqueueGraphOperation: enqueueGraphOperation,
@@ -367,6 +574,7 @@ export var useOnTable = function (_a) {
         onChangeTables,
         onChangeSheets,
         onChangeSheetData,
+        onChangeCharts,
         enqueueCalculation,
         enqueueStructureChange,
         enqueueGraphOperation,

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

@@ -0,0 +1,23 @@
+import type { CalculatedColumnFill, CellData, Sheet, TableView } from "@rowsncolumns/spreadsheet";
+import type { OnCommand } from "../commands";
+import type { useCalculation } from "./use-calculation";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+export type UseOnUndoCalculatedColumnProps<T extends CellData, S extends Sheet> = {
+    tables?: TableView[];
+    createHistory: () => (patches: SpreadsheetPatch) => void;
+    /** `useUndoRedo`'s `batchHistory`: the restored cells and the dropped column formula undo as one step. */
+    batchHistory: <R>(action: () => R) => R;
+    onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
+    onChangeTables: UseSpreadsheetProps<T, S>["onChangeTables"];
+    enqueueCalculation: ReturnType<typeof useCalculation>["enqueueCalculation"];
+    onCommand?: OnCommand;
+};
+/**
+ * Excel's "Undo Calculated Column" (the AutoCorrect smart tag after a formula typed into a table
+ * column filled it): the fill alone reverts — every body cell the fill overwrote goes back to what
+ * it held (empty, or the column's previous formula) — and the column stops being a calculated
+ * column. The typed cell keeps its formula. One undo step.
+ */
+export declare const useOnUndoCalculatedColumn: <T extends CellData, S extends Sheet>({ tables, createHistory, batchHistory, onChangeSheetData, onChangeTables, enqueueCalculation, onCommand, }: UseOnUndoCalculatedColumnProps<T, S>) => (fill: CalculatedColumnFill) => void;
+//# sourceMappingURL=use-on-undo-calculated-column.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-undo-calculated-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-undo-calculated-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EACpB,QAAQ,EACR,KAAK,EACL,SAAS,EACV,MAAM,2BAA2B,CAAC;AAMnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,8BAA8B,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAChF,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,0GAA0G;IAC1G,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,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,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,4GAQ5E,8BAA8B,CAAC,CAAC,EAAE,CAAC,CAAC,YAE5B,oBAAoB,SAgE9B,CAAC"}

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

@@ -0,0 +1,70 @@
+import { __assign, __read, __values } from "tslib";
+import { produceWithPatches } from "immer";
+import { useCallback } from "react";
+import { createSheetCellIdentifier } from "../api/formula";
+import { createSheetDraft } from "../api/immer-utils";
+/**
+ * Excel's "Undo Calculated Column" (the AutoCorrect smart tag after a formula typed into a table
+ * column filled it): the fill alone reverts — every body cell the fill overwrote goes back to what
+ * it held (empty, or the column's previous formula) — and the column stops being a calculated
+ * column. The typed cell keeps its formula. One undo step.
+ */
+export var useOnUndoCalculatedColumn = function (_a) {
+    var tables = _a.tables, createHistory = _a.createHistory, batchHistory = _a.batchHistory, onChangeSheetData = _a.onChangeSheetData, onChangeTables = _a.onChangeTables, enqueueCalculation = _a.enqueueCalculation, onCommand = _a.onCommand;
+    return useCallback(function (fill) {
+        var sheetId = fill.sheetId, tableId = fill.tableId, columnIndex = fill.columnIndex, previous = fill.previous;
+        var table = tables === null || tables === void 0 ? void 0 : tables.find(function (candidate) { return candidate.id === tableId && candidate.sheetId === sheetId; });
+        if (!table) {
+            return;
+        }
+        batchHistory(function () {
+            var saveHistory = createHistory();
+            var recalcCells = new Map();
+            onChangeSheetData === null || onChangeSheetData === void 0 ? void 0 : onChangeSheetData(function (prevSheetData) {
+                var _a = __read(produceWithPatches(prevSheetData, function (draft) {
+                    var e_1, _a;
+                    try {
+                        for (var previous_1 = __values(previous), previous_1_1 = previous_1.next(); !previous_1_1.done; previous_1_1 = previous_1.next()) {
+                            var _b = previous_1_1.value, rowIndex = _b.rowIndex, col = _b.columnIndex, cell = _b.cell;
+                            var currentSheet = createSheetDraft(draft, sheetId, rowIndex);
+                            currentSheet[rowIndex].values[col] = (cell !== null && cell !== void 0 ? cell : undefined);
+                            var position = { sheetId: sheetId, rowIndex: rowIndex, columnIndex: col };
+                            enqueueCalculation({ type: cell ? "add" : "remove", position: position, force: true });
+                            recalcCells.set(createSheetCellIdentifier(sheetId, rowIndex, col), __assign(__assign({}, position), { force: true }));
+                        }
+                    }
+                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                    finally {
+                        try {
+                            if (previous_1_1 && !previous_1_1.done && (_a = previous_1.return)) _a.call(previous_1);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                    }
+                }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
+                saveHistory(__assign({ sheetData: { patches: patches, inversePatches: inversePatches } }, (recalcCells.size
+                    ? { recalcCells: { undo: recalcCells, redo: recalcCells } }
+                    : {})));
+                return nextState;
+            });
+            onChangeTables === null || onChangeTables === void 0 ? void 0 : onChangeTables(function (prevTables) {
+                var _a = __read(produceWithPatches(prevTables, function (draft) {
+                    var _a;
+                    var current = draft.find(function (candidate) { return candidate.id === tableId && candidate.sheetId === sheetId; });
+                    var column = (_a = current === null || current === void 0 ? void 0 : current.columns) === null || _a === void 0 ? void 0 : _a[columnIndex - current.range.startColumnIndex];
+                    if (column) {
+                        delete column.formula;
+                    }
+                }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
+                saveHistory({ tables: { patches: patches, inversePatches: inversePatches } });
+                return nextState;
+            });
+        });
+        onCommand === null || onCommand === void 0 ? void 0 : onCommand({
+            command: "undo-calculated-column",
+            sheetId: sheetId,
+            tableId: tableId,
+            columnIndex: columnIndex,
+            previous: previous,
+        });
+    }, [tables, createHistory, batchHistory, onChangeSheetData, onChangeTables, enqueueCalculation, onCommand]);
+};

package/dist/cjs/hooks/use-on-undo-table-auto-expansion.d.ts

@@ -0,0 +1,28 @@
+import type { GridRange } from "@rowsncolumns/common-types";
+import type { CellData, Sheet, TableAutoExpansion, TableView } from "@rowsncolumns/spreadsheet";
+import type { OnCommand } from "../commands";
+import type { useCalculation } from "./use-calculation";
+import type { CellXfsRegistry } from "./use-cellxfs-registry";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+export type UseOnUndoTableAutoExpansionProps<T extends CellData, S extends Sheet> = {
+    locale?: string;
+    cellXfsRegistry?: CellXfsRegistry;
+    tables?: TableView[];
+    createHistory: () => (patches: SpreadsheetPatch) => void;
+    /** `useUndoRedo`'s `batchHistory`: the resize and the cell clears undo as one step. */
+    batchHistory: <R>(action: () => R) => R;
+    onResizeTable: (sheetId: number, table: TableView, range: GridRange) => void;
+    onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
+    enqueueCalculation: ReturnType<typeof useCalculation>["enqueueCalculation"];
+    onCommand?: OnCommand;
+};
+/**
+ * Excel's "Undo Table AutoExpansion" (the AutoCorrect smart tag after a table grew over a typed,
+ * pasted or filled cell): the table resizes back to the range it had before the growth, and the
+ * cells the growth itself wrote — the calculated-column formulas and generated header names it
+ * put into empty cells, the column formatting it copied onto cells that had none — are cleared.
+ * The user's own value stays, now a plain cell outside the table. One undo step.
+ */
+export declare const useOnUndoTableAutoExpansion: <T extends CellData, S extends Sheet>({ locale, cellXfsRegistry, tables, createHistory, batchHistory, onResizeTable, onChangeSheetData, enqueueCalculation, onCommand, }: UseOnUndoTableAutoExpansionProps<T, S>) => (expansion: TableAutoExpansion) => void;
+//# sourceMappingURL=use-on-undo-table-auto-expansion.d.ts.map

package/dist/cjs/hooks/use-on-undo-table-auto-expansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-undo-table-auto-expansion.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-undo-table-auto-expansion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EACV,QAAQ,EACR,KAAK,EACL,kBAAkB,EAClB,SAAS,EACV,MAAM,2BAA2B,CAAC;AAMnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,gCAAgC,CAC1C,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,IACb;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,uFAAuF;IACvF,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC7E,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,oIAU9E,gCAAgC,CAAC,CAAC,EAAE,CAAC,CAAC,iBAEzB,kBAAkB,SA4EjC,CAAC"}