@rowsncolumns/spreadsheet-state 29.0.0 → 29.1.0

package/dist/cjs/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/cjs/hooks/use-structured-reference.js

@@ -66,6 +66,23 @@ export var useStructuredReference = function (_a) {
                 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/cjs/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/cjs/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/cjs/hooks/use-undo-redo-actions.js

@@ -4,7 +4,7 @@ import { isNil } from "@rowsncolumns/utils";
 import { useCallback } from "react";
 import { applyPatches } from "../api/patches";
 export var useUndoRedoActions = function (_a) {
-    var sheetId = _a.sheetId, onChangeSheets = _a.onChangeSheets, onChangeSheetData = _a.onChangeSheetData, onChangeActiveCell = _a.onChangeActiveCell, onChangeSelections = _a.onChangeSelections, onChangeActiveSheet = _a.onChangeActiveSheet, onChangePivotTables = _a.onChangePivotTables, onChangeTables = _a.onChangeTables, onChangeNamedRanges = _a.onChangeNamedRanges, onChangeEmbeds = _a.onChangeEmbeds, onChangeCharts = _a.onChangeCharts, onChangeTheme = _a.onChangeTheme, onChangeCellXfs = _a.onChangeCellXfs, onChangeConditionalFormats = _a.onChangeConditionalFormats, onChangeDataValidations = _a.onChangeDataValidations, onChangeProtectedRanges = _a.onChangeProtectedRanges, onChangeSlicers = _a.onChangeSlicers, onChangeCitations = _a.onChangeCitations, onChangeSharedStrings = _a.onChangeSharedStrings, enqueueCalculation = _a.enqueueCalculation, clearRangeCache = _a.clearRangeCache;
+    var sheetId = _a.sheetId, onChangeSheets = _a.onChangeSheets, onChangeSheetData = _a.onChangeSheetData, onChangeActiveCell = _a.onChangeActiveCell, onChangeSelections = _a.onChangeSelections, onChangeActiveSheet = _a.onChangeActiveSheet, onChangePivotTables = _a.onChangePivotTables, onChangeTables = _a.onChangeTables, onChangeNamedRanges = _a.onChangeNamedRanges, onChangeEmbeds = _a.onChangeEmbeds, onChangeCharts = _a.onChangeCharts, onChangeTheme = _a.onChangeTheme, onChangeCellXfs = _a.onChangeCellXfs, onChangeConditionalFormats = _a.onChangeConditionalFormats, onChangeDataValidations = _a.onChangeDataValidations, onChangeProtectedRanges = _a.onChangeProtectedRanges, onChangeCustomTableStyles = _a.onChangeCustomTableStyles, onChangeSlicers = _a.onChangeSlicers, onChangeCitations = _a.onChangeCitations, onChangeSharedStrings = _a.onChangeSharedStrings, enqueueCalculation = _a.enqueueCalculation, clearRangeCache = _a.clearRangeCache;
     var _b = useSpreadsheet(), scrollToCell = _b.scrollToCell, updateSelectionStartEndReference = _b.updateSelectionStartEndReference;
     var focusEmbedOrChart = useFocusEmbedOrChart();
     // Undo/redo side-effects
@@ -114,6 +114,12 @@ export var useUndoRedoActions = function (_a) {
                 return applyPatches(prev, patch.namedRanges[action === "undo" ? "inversePatches" : "patches"]);
             });
         }
+        // Update custom table styles
+        if (patch.customTableStyles) {
+            onChangeCustomTableStyles === null || onChangeCustomTableStyles === void 0 ? void 0 : onChangeCustomTableStyles(function (prev) {
+                return applyPatches(prev !== null && prev !== void 0 ? prev : [], patch.customTableStyles[action === "undo" ? "inversePatches" : "patches"]);
+            });
+        }
         // Update protected ranges
         if (patch.protectedRanges) {
             onChangeProtectedRanges === null || onChangeProtectedRanges === void 0 ? void 0 : onChangeProtectedRanges(function (prev) {
@@ -162,7 +168,9 @@ export var useUndoRedoActions = function (_a) {
                 return 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/cjs/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/cjs/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/cjs/hooks/use-undo-redo.js

@@ -1,13 +1,118 @@
-import { __assign, __values } from "tslib";
+import { __assign, __read, __spreadArray, __values } from "tslib";
 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. */
+var PATCH_KEYS = [
+    "sheetData",
+    "sheets",
+    "protectedRanges",
+    "conditionalFormats",
+    "dataValidations",
+    "pivotTables",
+    "theme",
+    "tables",
+    "namedRanges",
+    "charts",
+    "embeds",
+    "cellXfs",
+    "sharedStrings",
+    "bandedRanges",
+    "customTableStyles",
+    "slicers",
+    "citations",
+];
+var appendPatchType = function (existing, incoming) {
+    return existing
+        ? {
+            // Forward patches replay in the order the steps ran; the inverse of a
+            // sequence undoes the LAST step first.
+            patches: __spreadArray(__spreadArray([], __read(existing.patches), false), __read(incoming.patches), false),
+            inversePatches: __spreadArray(__spreadArray([], __read(incoming.inversePatches), false), __read(existing.inversePatches), false),
+        }
+        : 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 var mergeSpreadsheetPatches = function (existing, incoming) {
+    var e_1, _a;
+    var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+    if (!existing) {
+        return incoming;
+    }
+    var merged = __assign({}, existing);
+    try {
+        for (var PATCH_KEYS_1 = __values(PATCH_KEYS), PATCH_KEYS_1_1 = PATCH_KEYS_1.next(); !PATCH_KEYS_1_1.done; PATCH_KEYS_1_1 = PATCH_KEYS_1.next()) {
+            var key = PATCH_KEYS_1_1.value;
+            var value = incoming[key];
+            if (value) {
+                merged[key] = appendPatchType(existing[key], value);
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (PATCH_KEYS_1_1 && !PATCH_KEYS_1_1.done && (_a = PATCH_KEYS_1.return)) _a.call(PATCH_KEYS_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    if (incoming.activeCell) {
+        merged.activeCell = {
+            undo: (_c = (_b = existing.activeCell) === null || _b === void 0 ? void 0 : _b.undo) !== null && _c !== void 0 ? _c : incoming.activeCell.undo,
+            redo: incoming.activeCell.redo,
+        };
+    }
+    if (incoming.selections) {
+        merged.selections = {
+            undo: (_e = (_d = existing.selections) === null || _d === void 0 ? void 0 : _d.undo) !== null && _e !== void 0 ? _e : incoming.selections.undo,
+            redo: incoming.selections.redo,
+        };
+    }
+    if (incoming.sheetId) {
+        merged.sheetId = {
+            undo: (_g = (_f = existing.sheetId) === null || _f === void 0 ? void 0 : _f.undo) !== null && _g !== void 0 ? _g : incoming.sheetId.undo,
+            redo: incoming.sheetId.redo,
+        };
+    }
+    if (incoming.selectedEmbedOrChart) {
+        merged.selectedEmbedOrChart = {
+            undo: (_j = (_h = existing.selectedEmbedOrChart) === null || _h === void 0 ? void 0 : _h.undo) !== null && _j !== void 0 ? _j : incoming.selectedEmbedOrChart.undo,
+            redo: incoming.selectedEmbedOrChart.redo,
+        };
+    }
+    if (incoming.recalcCells) {
+        merged.recalcCells = {
+            undo: new Map(__spreadArray(__spreadArray([], __read(((_l = (_k = existing.recalcCells) === null || _k === void 0 ? void 0 : _k.undo) !== null && _l !== void 0 ? _l : [])), false), __read(incoming.recalcCells.undo), false)),
+            redo: new Map(__spreadArray(__spreadArray([], __read(((_o = (_m = existing.recalcCells) === null || _m === void 0 ? void 0 : _m.redo) !== null && _o !== void 0 ? _o : [])), false), __read(incoming.recalcCells.redo), false)),
+        };
+    }
+    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 var useUndoRedo = function (_a) {
     var _b = _a.isEnabled, isEnabled = _b === void 0 ? true : _b, onUndoAction = _a.onUndoAction, onRedoAction = _a.onRedoAction, onChangeHistory = _a.onChangeHistory;
     var undoStack = useRef([]);
     var undoStackPointer = useRef(-1);
     var onChangeHistoryStable = useCallbackRef(onChangeHistory);
     var 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.
+    var batchedPointersRef = useRef(new Set());
+    // The pointer every `createHistory()` joins while a `batchHistory` runs.
+    var activeBatchPointerRef = useRef(undefined);
     var historyQueueRef = useRef(undefined);
     var saveHistoryCallbackRef = useRef(undefined);
     var getQueue = useCallback(function () {
@@ -31,7 +136,9 @@ export var useUndoRedo = function (_a) {
     }, [getQueue, onChangeHistoryStable]);
     // Save to point
     var onSaveHistoryToPointer = useCallback(function (patches, pointer) {
-        undoStack.current[pointer] = __assign(__assign({}, undoStack.current[pointer]), patches);
+        undoStack.current[pointer] = batchedPointersRef.current.has(pointer)
+            ? mergeSpreadsheetPatches(undoStack.current[pointer], patches)
+            : __assign(__assign({}, 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,26 +146,34 @@ export var useUndoRedo = function (_a) {
         // 2. History 2 => Expand table, Recompute calculated column
         if (pointerSetRef.current.add(pointer).size === 1) {
             requestAnimationFrame(function () {
-                var e_1, _a;
+                var e_2, _a;
+                // 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.
+                var pointers = Array.from(pointerSetRef.current).sort(function (a, b) { return a - b; });
                 try {
-                    for (var _b = __values(pointerSetRef.current), _c = _b.next(); !_c.done; _c = _b.next()) {
-                        var p = _c.value;
+                    for (var pointers_1 = __values(pointers), pointers_1_1 = pointers_1.next(); !pointers_1_1.done; pointers_1_1 = pointers_1.next()) {
+                        var p = pointers_1_1.value;
                         triggerHistoryChange(undoStack.current[p]);
                     }
                 }
-                catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                catch (e_2_1) { e_2 = { error: e_2_1 }; }
                 finally {
                     try {
-                        if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+                        if (pointers_1_1 && !pointers_1_1.done && (_a = pointers_1.return)) _a.call(pointers_1);
                     }
-                    finally { if (e_1) throw e_1.error; }
+                    finally { if (e_2) throw e_2.error; }
                 }
                 pointerSetRef.current.clear();
             });
         }
     }, [triggerHistoryChange]);
-    // Create next history pointer
-    var createHistoryPointer = useCallback(function () {
+    // Allocate the next history pointer (always a fresh entry; truncates redo).
+    var allocateHistoryPointer = useCallback(function () {
         if (!isEnabled) {
             debug("Undo/Redo functionality has been disabled");
             return;
@@ -67,6 +182,14 @@ export var useUndoRedo = function (_a) {
         undoStack.current.length = pointer;
         return pointer;
     }, [isEnabled]);
+    // Create next history pointer — inside a `batchHistory` every operation
+    // joins the batch's single entry.
+    var createHistoryPointer = useCallback(function () {
+        if (activeBatchPointerRef.current !== undefined) {
+            return activeBatchPointerRef.current;
+        }
+        return allocateHistoryPointer();
+    }, [allocateHistoryPointer]);
     // Create current history
     var createHistory = useCallback(function (callback) {
         var pointer = createHistoryPointer();
@@ -79,6 +202,32 @@ export var useUndoRedo = function (_a) {
             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.
+     */
+    var batchHistory = useCallback(function (action) {
+        if (activeBatchPointerRef.current !== undefined) {
+            return action();
+        }
+        var 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
     var createHistoryWithoutPointer = useCallback(function () {
         return function (patches) {
@@ -92,6 +241,11 @@ export var useUndoRedo = function (_a) {
         }
         var 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 === null || onUndoAction === void 0 ? void 0 : onUndoAction(patches);
         // Trigger history change
         triggerHistoryChange(patches, "undo");
@@ -103,6 +257,9 @@ export var useUndoRedo = function (_a) {
         }
         undoStackPointer.current++;
         var patches = undoStack.current[undoStackPointer.current];
+        if (!patches) {
+            return;
+        }
         onRedoAction === null || onRedoAction === void 0 ? void 0 : onRedoAction(patches);
         // Trigger history change
         triggerHistoryChange(patches, "redo");
@@ -111,10 +268,12 @@ export var useUndoRedo = function (_a) {
     var onClearHistory = useCallback(function () {
         undoStack.current = [];
         undoStackPointer.current = -1;
+        batchedPointersRef.current.clear();
     }, []);
     return {
         createHistory: createHistory,
         createHistoryWithoutPointer: createHistoryWithoutPointer,
+        batchHistory: batchHistory,
         onUndo: onUndo,
         onRedo: onRedo,
         onClearHistory: onClearHistory,

package/dist/cjs/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/cjs/hooks/utils/sort-rows.js

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

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