@rowsncolumns/spreadsheet-state 29.0.0 → 29.1.0

package/dist/esm/hooks/use-structured-reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-structured-reference.d.ts","sourceRoot":"","sources":["../../../hooks/use-structured-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAG/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK3D,eAAO,MAAM,sBAAsB,GAAI,oCAIpC;IACD,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACvC,iBAGgB,MAAM,GAAG,SAAS,eAChB,MAAM,EAAE,GAAG,SAAS,WACxB,OAAO,eACH,MAAM,GAAG,SAAS,aACpB,MAAM,QACX,UAAU,KACf,SAAS,GAAG,UA0JlB,CAAC"}
+{"version":3,"file":"use-structured-reference.d.ts","sourceRoot":"","sources":["../../../hooks/use-structured-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAG/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK3D,eAAO,MAAM,sBAAsB,GAAI,oCAIpC;IACD,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACvC,iBAGgB,MAAM,GAAG,SAAS,eAChB,MAAM,EAAE,GAAG,SAAS,WACxB,OAAO,eACH,MAAM,GAAG,SAAS,aACpB,MAAM,QACX,UAAU,KACf,SAAS,GAAG,UA4KlB,CAAC"}

package/dist/esm/hooks/use-structured-reference.js

@@ -63,6 +63,23 @@ export const useStructuredReference = ({ tables, sheetId, getSheetName, }) => {
                 sheet: getSheetName(table.sheetId),
             };
         }
+        // Totals row only — the table's last row; Excel: `#REF!` while the totals row is off.
+        if (specialItem === "#Totals") {
+            if (!totalRow) {
+                throw new FormulaError("#REF!", "Table has no totals row");
+            }
+            return {
+                from: {
+                    row: range.endRowIndex,
+                    col: startColumnIndex,
+                },
+                to: {
+                    row: range.endRowIndex,
+                    col: endColumnIndex,
+                },
+                sheet: getSheetName(table.sheetId),
+            };
+        }
         // All
         if (specialItem === "#All") {
             return {

package/dist/esm/hooks/use-undo-redo-actions.d.ts

@@ -16,6 +16,7 @@ export type UseUndoRedoActionsProps<T extends CellData, S extends Sheet> = {
     onChangeCitations?: UseSpreadsheetProps<T, S>["onChangeCitations"];
     onChangeSharedStrings?: UseSpreadsheetProps<T, S>["onChangeSharedStrings"];
     onChangeProtectedRanges?: UseSpreadsheetProps<T, S>["onChangeProtectedRanges"];
+    onChangeCustomTableStyles?: UseSpreadsheetProps<T, S>["onChangeCustomTableStyles"];
     onChangeConditionalFormats?: UseSpreadsheetProps<T, S>["onChangeConditionalFormats"];
     onChangeDataValidations?: UseSpreadsheetProps<T, S>["onChangeDataValidations"];
     onChangeTheme?: UseSpreadsheetProps<T, S>["onChangeTheme"];
@@ -32,7 +33,7 @@ export type UseUndoRedoActionsProps<T extends CellData, S extends Sheet> = {
      */
     clearRangeCache?: () => void;
 };
-export declare const useUndoRedoActions: <T extends CellData, S extends Sheet>({ sheetId, onChangeSheets, onChangeSheetData, onChangeActiveCell, onChangeSelections, onChangeActiveSheet, onChangePivotTables, onChangeTables, onChangeNamedRanges, onChangeEmbeds, onChangeCharts, onChangeTheme, onChangeCellXfs, onChangeConditionalFormats, onChangeDataValidations, onChangeProtectedRanges, onChangeSlicers, onChangeCitations, onChangeSharedStrings, enqueueCalculation, clearRangeCache, }: UseUndoRedoActionsProps<T, S>) => {
+export declare const useUndoRedoActions: <T extends CellData, S extends Sheet>({ sheetId, onChangeSheets, onChangeSheetData, onChangeActiveCell, onChangeSelections, onChangeActiveSheet, onChangePivotTables, onChangeTables, onChangeNamedRanges, onChangeEmbeds, onChangeCharts, onChangeTheme, onChangeCellXfs, onChangeConditionalFormats, onChangeDataValidations, onChangeProtectedRanges, onChangeCustomTableStyles, onChangeSlicers, onChangeCitations, onChangeSharedStrings, enqueueCalculation, clearRangeCache, }: UseUndoRedoActionsProps<T, S>) => {
     onUndoAction: (patch: SpreadsheetPatch<Patch>) => void;
     onRedoAction: (patch: SpreadsheetPatch<Patch>) => void;
     applyPatch: (patch: SpreadsheetPatch<Patch>) => void;

package/dist/esm/hooks/use-undo-redo-actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-undo-redo-actions.d.ts","sourceRoot":"","sources":["../../../hooks/use-undo-redo-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,KAAK,EACN,MAAM,2BAA2B,CAAC;AAQnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAKnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,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,cAAc,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7D,cAAc,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7D,mBAAmB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACvE,eAAe,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC/D,eAAe,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC/D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACnE,qBAAqB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC;IAC3E,uBAAuB,CAAC,EAAE,mBAAmB,CAC3C,CAAC,EACD,CAAC,CACF,CAAC,yBAAyB,CAAC,CAAC;IAC7B,0BAA0B,CAAC,EAAE,mBAAmB,CAC9C,CAAC,EACD,CAAC,CACF,CAAC,4BAA4B,CAAC,CAAC;IAChC,uBAAuB,CAAC,EAAE,mBAAmB,CAC3C,CAAC,EACD,CAAC,CACF,CAAC,yBAAyB,CAAC,CAAC;IAC7B,aAAa,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAC3D,kBAAkB,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC7D,kBAAkB,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC7D,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACtE,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,sZAsBrE,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC;0BAqQpB,gBAAgB,CAAC,KAAK,CAAC;0BAQvB,gBAAgB,CAAC,KAAK,CAAC;wBAQvB,gBAAgB,CAAC,KAAK,CAAC;CAWlC,CAAC"}
+{"version":3,"file":"use-undo-redo-actions.d.ts","sourceRoot":"","sources":["../../../hooks/use-undo-redo-actions.ts"],"names":[],"mappings":"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"}

package/dist/esm/hooks/use-undo-redo-actions.js

@@ -2,7 +2,7 @@ import { DEFAULT_ARRAY, isSelectionACell, useFocusEmbedOrChart, useSpreadsheet,
 import { isNil } from "@rowsncolumns/utils";
 import { useCallback } from "react";
 import { applyPatches } from "../api/patches";
-export const useUndoRedoActions = ({ sheetId, onChangeSheets, onChangeSheetData, onChangeActiveCell, onChangeSelections, onChangeActiveSheet, onChangePivotTables, onChangeTables, onChangeNamedRanges, onChangeEmbeds, onChangeCharts, onChangeTheme, onChangeCellXfs, onChangeConditionalFormats, onChangeDataValidations, onChangeProtectedRanges, onChangeSlicers, onChangeCitations, onChangeSharedStrings, enqueueCalculation, clearRangeCache, }) => {
+export const useUndoRedoActions = ({ sheetId, onChangeSheets, onChangeSheetData, onChangeActiveCell, onChangeSelections, onChangeActiveSheet, onChangePivotTables, onChangeTables, onChangeNamedRanges, onChangeEmbeds, onChangeCharts, onChangeTheme, onChangeCellXfs, onChangeConditionalFormats, onChangeDataValidations, onChangeProtectedRanges, onChangeCustomTableStyles, onChangeSlicers, onChangeCitations, onChangeSharedStrings, enqueueCalculation, clearRangeCache, }) => {
     const { scrollToCell, updateSelectionStartEndReference } = useSpreadsheet();
     const focusEmbedOrChart = useFocusEmbedOrChart();
     // Undo/redo side-effects
@@ -87,6 +87,10 @@ export const useUndoRedoActions = ({ sheetId, onChangeSheets, onChangeSheetData,
         if (patch.namedRanges) {
             onChangeNamedRanges?.((prev) => applyPatches(prev, patch.namedRanges[action === "undo" ? "inversePatches" : "patches"]));
         }
+        // Update custom table styles
+        if (patch.customTableStyles) {
+            onChangeCustomTableStyles?.((prev) => applyPatches(prev ?? [], patch.customTableStyles[action === "undo" ? "inversePatches" : "patches"]));
+        }
         // Update protected ranges
         if (patch.protectedRanges) {
             onChangeProtectedRanges?.((prev) => applyPatches(prev, patch.protectedRanges[action === "undo" ? "inversePatches" : "patches"]));
@@ -119,7 +123,9 @@ export const useUndoRedoActions = ({ sheetId, onChangeSheets, onChangeSheetData,
         if (patch.sharedStrings) {
             onChangeSharedStrings?.((prev) => applyPatches(prev, patch.sharedStrings[action === "undo" ? "inversePatches" : "patches"]));
         }
-        if (patch.selectedEmbedOrChart && patch.selectedEmbedOrChart[action]) {
+        // `undefined` is meaningful here: the object does not exist after this step (undo of a
+        // create, redo of a delete), so the selection is cleared rather than left pointing at it.
+        if (patch.selectedEmbedOrChart) {
             focusEmbedOrChart(patch.selectedEmbedOrChart[action]);
         }
     }, [

package/dist/esm/hooks/use-undo-redo.d.ts

@@ -51,14 +51,26 @@ export type SpreadsheetPatch<T extends Patch = Patch> = {
     cellXfs?: PatchType<T>;
     sharedStrings?: PatchType<T>;
     bandedRanges?: PatchType<T>;
+    customTableStyles?: PatchType<T>;
     disableRecalc?: boolean;
     isFullRecalc?: boolean;
     slicers?: PatchType<T>;
     citations?: PatchType<T>;
 };
+/**
+ * Fold the history of one more step into an entry that already holds earlier
+ * steps of the same user action — the composition rule behind
+ * {@link useUndoRedo}'s `batchHistory`. Patch pairs concatenate (forward in
+ * step order, inverse in reverse step order), the undo-side view state keeps
+ * the FIRST step's (where the user was before the action) and the redo side
+ * the LAST step's, recalc cells union, and a recalc is disabled only when
+ * every step disabled it.
+ */
+export declare const mergeSpreadsheetPatches: <T extends Patch>(existing: SpreadsheetPatch<T> | undefined, incoming: SpreadsheetPatch<T>) => SpreadsheetPatch<T>;
 export declare const useUndoRedo: <T extends Patch = Patch>({ isEnabled, onUndoAction, onRedoAction, onChangeHistory, }: UseUndoRedoProps<T>) => {
     createHistory: (callback?: () => void) => (patches: SpreadsheetPatch<T>) => void;
     createHistoryWithoutPointer: () => (patches: SpreadsheetPatch<T>) => void;
+    batchHistory: <R>(action: () => R) => R;
     onUndo: () => void;
     onRedo: () => void;
     onClearHistory: () => void;

package/dist/esm/hooks/use-undo-redo.d.ts.map

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

package/dist/esm/hooks/use-undo-redo.js

@@ -1,11 +1,108 @@
 import { useCallbackRef } from "@rowsncolumns/spreadsheet";
 import { debug, isNil } from "@rowsncolumns/utils";
 import { useCallback, useRef } from "react";
+/** The keys of a {@link SpreadsheetPatch} that hold immer patch pairs. */
+const PATCH_KEYS = [
+    "sheetData",
+    "sheets",
+    "protectedRanges",
+    "conditionalFormats",
+    "dataValidations",
+    "pivotTables",
+    "theme",
+    "tables",
+    "namedRanges",
+    "charts",
+    "embeds",
+    "cellXfs",
+    "sharedStrings",
+    "bandedRanges",
+    "customTableStyles",
+    "slicers",
+    "citations",
+];
+const appendPatchType = (existing, incoming) => existing
+    ? {
+        // Forward patches replay in the order the steps ran; the inverse of a
+        // sequence undoes the LAST step first.
+        patches: [...existing.patches, ...incoming.patches],
+        inversePatches: [...incoming.inversePatches, ...existing.inversePatches],
+    }
+    : incoming;
+/**
+ * Fold the history of one more step into an entry that already holds earlier
+ * steps of the same user action — the composition rule behind
+ * {@link useUndoRedo}'s `batchHistory`. Patch pairs concatenate (forward in
+ * step order, inverse in reverse step order), the undo-side view state keeps
+ * the FIRST step's (where the user was before the action) and the redo side
+ * the LAST step's, recalc cells union, and a recalc is disabled only when
+ * every step disabled it.
+ */
+export const mergeSpreadsheetPatches = (existing, incoming) => {
+    if (!existing) {
+        return incoming;
+    }
+    const merged = { ...existing };
+    for (const key of PATCH_KEYS) {
+        const value = incoming[key];
+        if (value) {
+            merged[key] = appendPatchType(existing[key], value);
+        }
+    }
+    if (incoming.activeCell) {
+        merged.activeCell = {
+            undo: existing.activeCell?.undo ?? incoming.activeCell.undo,
+            redo: incoming.activeCell.redo,
+        };
+    }
+    if (incoming.selections) {
+        merged.selections = {
+            undo: existing.selections?.undo ?? incoming.selections.undo,
+            redo: incoming.selections.redo,
+        };
+    }
+    if (incoming.sheetId) {
+        merged.sheetId = {
+            undo: existing.sheetId?.undo ?? incoming.sheetId.undo,
+            redo: incoming.sheetId.redo,
+        };
+    }
+    if (incoming.selectedEmbedOrChart) {
+        merged.selectedEmbedOrChart = {
+            undo: existing.selectedEmbedOrChart?.undo ?? incoming.selectedEmbedOrChart.undo,
+            redo: incoming.selectedEmbedOrChart.redo,
+        };
+    }
+    if (incoming.recalcCells) {
+        merged.recalcCells = {
+            undo: new Map([
+                ...(existing.recalcCells?.undo ?? []),
+                ...incoming.recalcCells.undo,
+            ]),
+            redo: new Map([
+                ...(existing.recalcCells?.redo ?? []),
+                ...incoming.recalcCells.redo,
+            ]),
+        };
+    }
+    if (incoming.disableRecalc !== undefined || existing.disableRecalc !== undefined) {
+        merged.disableRecalc = Boolean(existing.disableRecalc && incoming.disableRecalc);
+    }
+    if (incoming.isFullRecalc || existing.isFullRecalc) {
+        merged.isFullRecalc = true;
+    }
+    return merged;
+};
 export const useUndoRedo = ({ isEnabled = true, onUndoAction, onRedoAction, onChangeHistory, }) => {
     const undoStack = useRef([]);
     const undoStackPointer = useRef(-1);
     const onChangeHistoryStable = useCallbackRef(onChangeHistory);
     const pointerSetRef = useRef(new Set());
+    // Pointers opened by `batchHistory`: every save into one of them is FOLDED
+    // into the entry (patches concatenate) instead of replacing same-named keys.
+    const batchedPointersRef = useRef(new Set());
+    // The pointer every `createHistory()` joins while a `batchHistory` runs.
+    const activeBatchPointerRef = useRef(undefined);
     const historyQueueRef = useRef(undefined);
     const saveHistoryCallbackRef = useRef(undefined);
     const getQueue = useCallback(() => {
@@ -28,10 +125,12 @@ export const useUndoRedo = ({ isEnabled = true, onUndoAction, onRedoAction, onCh
     }, [getQueue, onChangeHistoryStable]);
     // Save to point
     const onSaveHistoryToPointer = useCallback((patches, pointer) => {
-        undoStack.current[pointer] = {
-            ...undoStack.current[pointer],
-            ...patches,
-        };
+        undoStack.current[pointer] = batchedPointersRef.current.has(pointer)
+            ? mergeSpreadsheetPatches(undoStack.current[pointer], patches)
+            : {
+                ...undoStack.current[pointer],
+                ...patches,
+            };
         // There can be multiple state updates in a single
         // pointer, So use a queue
         // Eg: When a cell is added to end of table
@@ -39,15 +138,23 @@ export const useUndoRedo = ({ isEnabled = true, onUndoAction, onRedoAction, onCh
         // 2. History 2 => Expand table, Recompute calculated column
         if (pointerSetRef.current.add(pointer).size === 1) {
             requestAnimationFrame(() => {
-                for (const p of pointerSetRef.current) {
+                // Broadcast in POINTER order — the order the operations ran — not in
+                // the order their first save arrived. With React state setters the
+                // saves run when the render processes each slice's queue, i.e. in
+                // hook order (a later operation's `sharedStrings` save lands before
+                // an earlier operation's `sheetData` save), and a collaboration
+                // document that replays the entries as received would apply a
+                // write before the row insert it depends on.
+                const pointers = Array.from(pointerSetRef.current).sort((a, b) => a - b);
+                for (const p of pointers) {
                     triggerHistoryChange(undoStack.current[p]);
                 }
                 pointerSetRef.current.clear();
             });
         }
     }, [triggerHistoryChange]);
-    // Create next history pointer
-    const createHistoryPointer = useCallback(() => {
+    // Allocate the next history pointer (always a fresh entry; truncates redo).
+    const allocateHistoryPointer = useCallback(() => {
         if (!isEnabled) {
             debug("Undo/Redo functionality has been disabled");
             return;
@@ -56,6 +163,14 @@ export const useUndoRedo = ({ isEnabled = true, onUndoAction, onRedoAction, onCh
         undoStack.current.length = pointer;
         return pointer;
     }, [isEnabled]);
+    // Create next history pointer — inside a `batchHistory` every operation
+    // joins the batch's single entry.
+    const createHistoryPointer = useCallback(() => {
+        if (activeBatchPointerRef.current !== undefined) {
+            return activeBatchPointerRef.current;
+        }
+        return allocateHistoryPointer();
+    }, [allocateHistoryPointer]);
     // Create current history
     const createHistory = useCallback((callback) => {
         const pointer = createHistoryPointer();
@@ -68,6 +183,32 @@ export const useUndoRedo = ({ isEnabled = true, onUndoAction, onRedoAction, onCh
             return onSaveHistoryToPointer(patches, pointer);
         };
     }, [createHistoryPointer, onSaveHistoryToPointer]);
+    /**
+     * Run `action` with every `createHistory()` it triggers — directly or
+     * through the hooks it composes — recording into ONE undo entry, so a
+     * multi-step user action (Data → Subtotal's inserts, writes and groupings;
+     * Insert Cut Cells' open-move-close) undoes and redoes in a single step and
+     * reaches `onChangeHistory` as a single batch, the way Excel treats it. The
+     * steps' patches are folded with {@link mergeSpreadsheetPatches}; a batch
+     * started inside another joins the outer one. Returns `action`'s result.
+     */
+    const batchHistory = useCallback((action) => {
+        if (activeBatchPointerRef.current !== undefined) {
+            return action();
+        }
+        const pointer = allocateHistoryPointer();
+        if (isNil(pointer)) {
+            return action();
+        }
+        batchedPointersRef.current.add(pointer);
+        activeBatchPointerRef.current = pointer;
+        try {
+            return action();
+        }
+        finally {
+            activeBatchPointerRef.current = undefined;
+        }
+    }, [allocateHistoryPointer]);
     // Save history without
     const createHistoryWithoutPointer = useCallback(() => {
         return (patches) => {
@@ -81,6 +222,11 @@ export const useUndoRedo = ({ isEnabled = true, onUndoAction, onRedoAction, onCh
         }
         const patches = undoStack.current[undoStackPointer.current];
         undoStackPointer.current--;
+        // An entry nothing was saved into (an operation that bailed out after
+        // opening its pointer) has nothing to revert.
+        if (!patches) {
+            return;
+        }
         onUndoAction?.(patches);
         // Trigger history change
         triggerHistoryChange(patches, "undo");
@@ -92,6 +238,9 @@ export const useUndoRedo = ({ isEnabled = true, onUndoAction, onRedoAction, onCh
         }
         undoStackPointer.current++;
         const patches = undoStack.current[undoStackPointer.current];
+        if (!patches) {
+            return;
+        }
         onRedoAction?.(patches);
         // Trigger history change
         triggerHistoryChange(patches, "redo");
@@ -100,10 +249,12 @@ export const useUndoRedo = ({ isEnabled = true, onUndoAction, onRedoAction, onCh
     const onClearHistory = useCallback(() => {
         undoStack.current = [];
         undoStackPointer.current = -1;
+        batchedPointersRef.current.clear();
     }, []);
     return {
         createHistory,
         createHistoryWithoutPointer,
+        batchHistory,
         onUndo,
         onRedo,
         onClearHistory,

package/dist/esm/hooks/utils/sort-rows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sort-rows.d.ts","sourceRoot":"","sources":["../../../../hooks/utils/sort-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAI3D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,EAAE,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7D,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACtD,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC9B,CAAC;AA8HF,eAAO,MAAM,2BAA2B,GACtC,YAAY,YAAY,EAAE,EAC1B,gBAAgB,MAAM;AACtB;;;;GAIG;AACH,WAAW,SAAS,EAAE,GAAG,iBAAiB,EAAE,mBAuB7C,CAAC"}
+{"version":3,"file":"sort-rows.d.ts","sourceRoot":"","sources":["../../../../hooks/utils/sort-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAQ3D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,EAAE,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7D,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACtD,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC9B,CAAC;AA+HF,eAAO,MAAM,2BAA2B,GACtC,YAAY,YAAY,EAAE,EAC1B,gBAAgB,MAAM;AACtB;;;;GAIG;AACH,WAAW,SAAS,EAAE,GAAG,iBAAiB,EAAE,mBAuB7C,CAAC"}

package/dist/esm/hooks/utils/sort-rows.js

@@ -1,9 +1,10 @@
-import { cellValueSorter } from "../../api/sort";
+import { cellValueSorter, isSortErrorValue, } from "../../api/sort";
 const toSortableValue = (value) => {
     if (typeof value === "string" ||
         typeof value === "number" ||
         typeof value === "boolean" ||
-        value == null) {
+        value == null ||
+        isSortErrorValue(value)) {
         return value;
     }
     return String(value);
@@ -28,7 +29,7 @@ const surfaceMatchSorter = (leftMatches, rightMatches, sortOrder) => {
 /** Custom-list comparator. Values not in the list sort last. */
 const customListSorter = (left, right, list, sortOrder) => {
     const indexOf = (v) => {
-        if (v == null)
+        if (v == null || isSortErrorValue(v))
             return -1;
         const s = String(v).toLowerCase();
         return list.findIndex((entry) => entry.toLowerCase() === s);

package/dist/esm/index.d.ts

@@ -1,6 +1,8 @@
 export * from "./generated-names";
+export * from "./helpers/sheet-title";
 export * from "./hooks/use-spreadsheet-state";
 export * from "./hooks/use-on-copy";
+export * from "./hooks/use-on-undo-calculated-column";
 export { generateDataFromClipboard, pickFormatting, pickFormula, pickValue, transpose, } from "./api/copy-paste";
 export { applyPasteOperation, isBlankClipboardCell, normalizePasteSpecialOptions, PASTE_SPECIAL_OPTIONS_KEY, PASTE_SPECIAL_TYPE_KEY, resolvePasteSpecialOptions, type ResolvedPasteSpecialOptions, } from "./api/paste-special";
 export * from "./hooks/use-calculation";
@@ -12,6 +14,7 @@ export * from "./hooks/use-async-datasource";
 export * from "./hooks/use-search";
 export * from "./hooks/use-calculation-initialize";
 export * from "./hooks/use-comments";
+export * from "./hooks/use-sparkline-groups";
 export * from "./components";
 export * from "./api/datatype";
 export * from "./sheet-cell";
@@ -29,6 +32,7 @@ export * from "./constants";
 export * from "./types";
 export * from "./commands";
 export type { ClearType } from "./interface/delete-cells";
+export { buildTableSlicers, getTableSlicerColumnNames, } from "./interface/slicers";
 export * from "./hooks/use-cellxfs-registry";
 export * from "./hooks/use-ss-registry";
 export * from "./hooks/use-sheet-properties";
@@ -44,6 +48,9 @@ export * from "./api/paint-format";
 export * from "./hooks/use-on-locale-change";
 export * from "./hooks/use-on-request-resize";
 export * from "./hooks/use-on-request-edit-table";
+export * from "./hooks/use-on-request-create-table";
+export * from "./hooks/use-on-request-resize-table";
+export * from "./hooks/use-on-request-insert-slicer";
 export * from "./hooks/use-on-request-delete-sheet";
 export * from "./hooks/use-on-request-data-validation";
 export * from "./hooks/use-on-request-define-named-range";

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,2BAA2B,GACjC,MAAM,qBAAqB,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAG7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uCAAuC,CAAC;AACtD,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,2BAA2B,GACjC,MAAM,qBAAqB,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EACL,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAG7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC"}

package/dist/esm/index.js

@@ -1,6 +1,8 @@
 export * from "./generated-names";
+export * from "./helpers/sheet-title";
 export * from "./hooks/use-spreadsheet-state";
 export * from "./hooks/use-on-copy";
+export * from "./hooks/use-on-undo-calculated-column";
 export { generateDataFromClipboard, pickFormatting, pickFormula, pickValue, transpose, } from "./api/copy-paste";
 export { applyPasteOperation, isBlankClipboardCell, normalizePasteSpecialOptions, PASTE_SPECIAL_OPTIONS_KEY, PASTE_SPECIAL_TYPE_KEY, resolvePasteSpecialOptions, } from "./api/paste-special";
 export * from "./hooks/use-calculation";
@@ -12,6 +14,7 @@ export * from "./hooks/use-async-datasource";
 export * from "./hooks/use-search";
 export * from "./hooks/use-calculation-initialize";
 export * from "./hooks/use-comments";
+export * from "./hooks/use-sparkline-groups";
 export * from "./components";
 export * from "./api/datatype";
 export * from "./sheet-cell";
@@ -28,6 +31,8 @@ export * from "./api/structural-guards";
 export * from "./constants";
 export * from "./types";
 export * from "./commands";
+// The slicers Excel's Insert Slicers dialog builds for a table (hosts building their own dialog).
+export { buildTableSlicers, getTableSlicerColumnNames, } from "./interface/slicers";
 // Register
 export * from "./hooks/use-cellxfs-registry";
 export * from "./hooks/use-ss-registry";
@@ -46,6 +51,9 @@ export * from "./hooks/use-on-locale-change";
 // atoms the dialog hosts read; nothing else exports them).
 export * from "./hooks/use-on-request-resize";
 export * from "./hooks/use-on-request-edit-table";
+export * from "./hooks/use-on-request-create-table";
+export * from "./hooks/use-on-request-resize-table";
+export * from "./hooks/use-on-request-insert-slicer";
 export * from "./hooks/use-on-request-delete-sheet";
 export * from "./hooks/use-on-request-data-validation";
 export * from "./hooks/use-on-request-define-named-range";

package/dist/esm/interface/apply-fill.d.ts

@@ -1,6 +1,29 @@
-import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
-import type { CellData, FillOptions, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import type { CellInterface, GridRange, SelectionArea } from "@rowsncolumns/common-types";
+import { Direction } from "@rowsncolumns/common-types";
+import type { CellData, FillOptions, SelectionAttributes, Sheet, TableView } from "@rowsncolumns/spreadsheet";
 import { type AutoFillType } from "../api/fill";
 import type { UseOnFillProps } from "../hooks/use-on-fill";
-export declare const applyFill: <T extends CellData, S extends Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, getCellData, getEffectiveValue, getFormattedValue, getAutoFillValues, getSheetName, enqueueCalculation, enqueueStructureChange, onChangeSheetData, createHistory, onChangeDataValidations, getMerges, onFillMerges, }: UseOnFillProps<T, S>) => (sheetId: number, activeCell: CellInterface, fillSelection: SelectionArea, selections: SelectionArea<SelectionAttributes>[], fillableSelections?: SelectionArea<SelectionAttributes>[], fillType?: AutoFillType, options?: FillOptions) => Promise<void>;
+export declare const applyFill: <T extends CellData, S extends Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, getCellData, getEffectiveValue, getFormattedValue, getAutoFillValues, getSheetName, enqueueCalculation, enqueueStructureChange, onChangeSheetData, createHistory, onChangeDataValidations, getMerges, onFillMerges, tables, getUserEnteredValue, onChangeTableColumn, batchHistory, autoExpandTables, }: UseOnFillProps<T, S>) => (sheetId: number, activeCell: CellInterface, fillSelection: SelectionArea, selections: SelectionArea<SelectionAttributes>[], fillableSelections?: SelectionArea<SelectionAttributes>[], fillType?: AutoFillType, options?: FillOptions) => Promise<void>;
+/**
+ * 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 declare const findFillTableExpansion: ({ sheetId, direction, selection, filledArea, tables, getUserEnteredValue, }: {
+    sheetId: number;
+    direction: Direction;
+    selection: GridRange;
+    filledArea: GridRange;
+    tables: TableView[] | undefined;
+    getUserEnteredValue: ((sheetId: number, rowIndex: number, columnIndex: number) => string | undefined) | undefined;
+}) => {
+    table: TableView;
+    coords: CellInterface;
+    isRowExpansion: boolean;
+    isColumnExpansion: boolean;
+    range: GridRange;
+} | undefined;
 //# sourceMappingURL=apply-fill.d.ts.map

package/dist/esm/interface/apply-fill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-fill.d.ts","sourceRoot":"","sources":["../../../interface/apply-fill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAKnC,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,aAAa,CAAC;AAGhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAW3D,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,+RAiB5D,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,MAGnB,SAAS,MAAM,EAEf,YAAY,aAAa,EAEzB,eAAe,aAAa,EAE5B,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAChD,qBAAqB,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAEzD,WAAW,YAAY,EAEvB,UAAU,WAAW,kBA+SxB,CAAC"}
+{"version":3,"file":"apply-fill.d.ts","sourceRoot":"","sources":["../../../interface/apply-fill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,KAAK,EACL,SAAS,EACV,MAAM,2BAA2B,CAAC;AAKnC,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,aAAa,CAAC;AAIhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAW3D,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,iXAsB5D,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,MAGnB,SAAS,MAAM,EAEf,YAAY,aAAa,EAEzB,eAAe,aAAa,EAE5B,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAChD,qBAAqB,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAEzD,WAAW,YAAY,EAEvB,UAAU,WAAW,kBAkXxB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,6EAOpC;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,SAAS,CAAC;IACtB,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IAChC,mBAAmB,EACf,CAAC,CACC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,CAAC,GACxB,SAAS,CAAC;CACf,KACG;IACE,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC;CAClB,GACD,SAmDH,CAAC"}