@rowsncolumns/spreadsheet-state 28.0.73 → 28.0.74

package/dist/cjs/hooks/use-on-advanced-filter.js

@@ -0,0 +1,42 @@
+import { useCallback } from "react";
+import { applyAdvancedFilterPlan, planAdvancedFilter, } from "../api/advanced-filter";
+import { useCanEditCellRange, useCanEditSheet } from "./use-can-edit-cellrange";
+/**
+ * Excel's Data → Sort & Filter → Advanced, composed over the existing
+ * hide/show-row and batch-write callbacks so both engines execute it through
+ * the same streamed commands. Records are compared by their effective value
+ * (numbers stay numeric) and fall back to the displayed text. Returns the
+ * applied plan, or `undefined` when the list has no records, the copy
+ * destination is missing / protected, or the sheet cannot be edited.
+ */
+export var useOnAdvancedFilter = function (_a) {
+    var getEffectiveValue = _a.getEffectiveValue, getFormattedValue = _a.getFormattedValue, onHideRow = _a.onHideRow, onShowRow = _a.onShowRow, onChangeBatch = _a.onChangeBatch;
+    var canEditCellRange = useCanEditCellRange();
+    var canEditSheet = useCanEditSheet();
+    return useCallback(function (sheetId, options) {
+        if (!canEditSheet(sheetId)) {
+            console.debug("This sheet is protected, users cannot filter it.");
+            return undefined;
+        }
+        var plan = planAdvancedFilter(options, function (rowIndex, columnIndex) {
+            var value = getEffectiveValue(sheetId, rowIndex, columnIndex);
+            return value !== null && value !== void 0 ? value : getFormattedValue(sheetId, rowIndex, columnIndex);
+        });
+        if (!plan)
+            return undefined;
+        if (plan.copy && !canEditCellRange(sheetId, plan.copy.range)) {
+            console.debug("This range is protected, users cannot edit this cell range.");
+            return undefined;
+        }
+        applyAdvancedFilterPlan(sheetId, plan, { onHideRow: onHideRow, onShowRow: onShowRow, onChangeBatch: onChangeBatch });
+        return plan;
+    }, [
+        canEditSheet,
+        canEditCellRange,
+        getEffectiveValue,
+        getFormattedValue,
+        onHideRow,
+        onShowRow,
+        onChangeBatch,
+    ]);
+};

package/dist/cjs/hooks/use-on-goal-seek.d.ts

@@ -0,0 +1,30 @@
+import type { CellInterface } from "@rowsncolumns/common-types";
+import { type GoalSeekResult } from "../api/goal-seek";
+import type { useCalculation } from "./use-calculation";
+import type { useOnChange } from "./use-on-change";
+import type { useSheetProperties } from "./use-sheet-properties";
+export type { GoalSeekResult };
+export type UseOnGoalSeekProps = {
+    getFormulaValue: ReturnType<typeof useSheetProperties>["getFormulaValue"];
+    getEffectiveValue: ReturnType<typeof useSheetProperties>["getEffectiveValue"];
+    /** The calculator's scratch evaluation (UNFORMATTED results). */
+    onRequestCalculate: ReturnType<typeof useCalculation>["onRequestCalculate"];
+    getDependents: ReturnType<typeof useCalculation>["getDependents"];
+    onChange: ReturnType<typeof useOnChange>;
+};
+/**
+ * Excel's Goal Seek (Data → What-If Analysis): find the value of
+ * `changingCell` that makes the formula in `setCell` evaluate to
+ * `targetValue`. Every trial is a scratch evaluation — the changing cell is
+ * pinned through the calculator's override map and the formula cells between
+ * it and the set cell (its transitive dependents, in dependency order) are
+ * re-evaluated into the same map, so nothing is written until the search
+ * ends. The final value is committed through `onChange` (one undo step,
+ * streamed to any engine consumer like a typed edit).
+ *
+ * Resolves to `undefined` when the set cell holds no formula or the changing
+ * cell is protected; otherwise the {@link GoalSeekResult} — Excel reports
+ * "found a solution" / "may not have found a solution" from `status`.
+ */
+export declare const useOnGoalSeek: ({ getFormulaValue, getEffectiveValue, onRequestCalculate, getDependents, onChange, }: UseOnGoalSeekProps) => (sheetId: number, setCell: CellInterface, targetValue: number, changingCell: CellInterface) => Promise<GoalSeekResult | undefined>;
+//# sourceMappingURL=use-on-goal-seek.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-goal-seek.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-goal-seek.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAIhE,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC1E,iBAAiB,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC9E,iEAAiE;IACjE,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,QAAQ,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;CAC1C,CAAC;AAUF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAI,sFAM3B,kBAAkB,eAKN,MAAM,WACN,aAAa,eACT,MAAM,gBACL,aAAa,KAC1B,OAAO,CAAC,cAAc,GAAG,SAAS,CA+DxC,CAAC"}

package/dist/cjs/hooks/use-on-goal-seek.js

@@ -0,0 +1,140 @@
+import { __assign, __awaiter, __generator, __values } from "tslib";
+import { isCellNode, makeKey } from "@rowsncolumns/dag";
+import { useCallback } from "react";
+import { goalSeek } from "../api/goal-seek";
+import { useCanEditCellRange } from "./use-can-edit-cellrange";
+/** Cap on the formula chain re-evaluated per trial (a runaway dependency fan-out). */
+var MAX_AFFECTED_CELLS = 2000;
+var sameCell = function (a, sheetId, b) {
+    var _a;
+    return ((_a = a.sheetId) !== null && _a !== void 0 ? _a : sheetId) === sheetId &&
+        a.rowIndex === b.rowIndex &&
+        a.columnIndex === b.columnIndex;
+};
+/**
+ * Excel's Goal Seek (Data → What-If Analysis): find the value of
+ * `changingCell` that makes the formula in `setCell` evaluate to
+ * `targetValue`. Every trial is a scratch evaluation — the changing cell is
+ * pinned through the calculator's override map and the formula cells between
+ * it and the set cell (its transitive dependents, in dependency order) are
+ * re-evaluated into the same map, so nothing is written until the search
+ * ends. The final value is committed through `onChange` (one undo step,
+ * streamed to any engine consumer like a typed edit).
+ *
+ * Resolves to `undefined` when the set cell holds no formula or the changing
+ * cell is protected; otherwise the {@link GoalSeekResult} — Excel reports
+ * "found a solution" / "may not have found a solution" from `status`.
+ */
+export var useOnGoalSeek = function (_a) {
+    var getFormulaValue = _a.getFormulaValue, getEffectiveValue = _a.getEffectiveValue, onRequestCalculate = _a.onRequestCalculate, getDependents = _a.getDependents, onChange = _a.onChange;
+    var canEditCellRange = useCanEditCellRange();
+    return useCallback(function (sheetId, setCell, targetValue, changingCell) { return __awaiter(void 0, void 0, void 0, function () {
+        var formula, changingPosition, affected, _a, _b, node, position, evaluate, current, initialValue, result;
+        var e_1, _c;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    if (!Number.isFinite(targetValue))
+                        return [2 /*return*/, undefined];
+                    if (!canEditCellRange(sheetId, changingCell)) {
+                        console.debug("This range is protected, users cannot edit this cell range.");
+                        return [2 /*return*/, undefined];
+                    }
+                    formula = getFormulaValue(sheetId, setCell.rowIndex, setCell.columnIndex);
+                    if (!formula)
+                        return [2 /*return*/, undefined];
+                    if (sameCell(setCell, sheetId, changingCell))
+                        return [2 /*return*/, undefined];
+                    changingPosition = __assign({ sheetId: sheetId }, changingCell);
+                    affected = [];
+                    try {
+                        for (_a = __values(getDependents(changingPosition)), _b = _a.next(); !_b.done; _b = _a.next()) {
+                            node = _b.value;
+                            if (!isCellNode(node))
+                                continue;
+                            position = node.position;
+                            if (sameCell(position, sheetId, setCell) && position.sheetId === sheetId)
+                                continue;
+                            if (position.conditionalFormatId != null || position.dataValidationId != null)
+                                continue;
+                            affected.push(position);
+                            if (affected.length >= MAX_AFFECTED_CELLS)
+                                break;
+                        }
+                    }
+                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                    finally {
+                        try {
+                            if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                    }
+                    evaluate = function (trial) { return __awaiter(void 0, void 0, void 0, function () {
+                        var overrides, scratch, affected_1, affected_1_1, position, cellFormula, value, e_2_1, result;
+                        var e_2, _a;
+                        return __generator(this, function (_b) {
+                            switch (_b.label) {
+                                case 0:
+                                    overrides = new Map([[makeKey(changingPosition), trial]]);
+                                    scratch = function (text, position) { return __awaiter(void 0, void 0, void 0, function () {
+                                        return __generator(this, function (_a) {
+                                            return [2 /*return*/, onRequestCalculate(text, position.sheetId, position.rowIndex, position.columnIndex, {
+                                                    overrides: overrides,
+                                                    disablePreview: true,
+                                                })];
+                                        });
+                                    }); };
+                                    _b.label = 1;
+                                case 1:
+                                    _b.trys.push([1, 6, 7, 8]);
+                                    affected_1 = __values(affected), affected_1_1 = affected_1.next();
+                                    _b.label = 2;
+                                case 2:
+                                    if (!!affected_1_1.done) return [3 /*break*/, 5];
+                                    position = affected_1_1.value;
+                                    cellFormula = getFormulaValue(position.sheetId, position.rowIndex, position.columnIndex);
+                                    if (!cellFormula)
+                                        return [3 /*break*/, 4];
+                                    return [4 /*yield*/, scratch(cellFormula, position)];
+                                case 3:
+                                    value = _b.sent();
+                                    // An errored intermediate reads as an error in the set cell too,
+                                    // which the solver treats as an unusable trial.
+                                    overrides.set(makeKey(position), value instanceof Error ? undefined : value);
+                                    _b.label = 4;
+                                case 4:
+                                    affected_1_1 = affected_1.next();
+                                    return [3 /*break*/, 2];
+                                case 5: return [3 /*break*/, 8];
+                                case 6:
+                                    e_2_1 = _b.sent();
+                                    e_2 = { error: e_2_1 };
+                                    return [3 /*break*/, 8];
+                                case 7:
+                                    try {
+                                        if (affected_1_1 && !affected_1_1.done && (_a = affected_1.return)) _a.call(affected_1);
+                                    }
+                                    finally { if (e_2) throw e_2.error; }
+                                    return [7 /*endfinally*/];
+                                case 8: return [4 /*yield*/, scratch(formula, __assign({ sheetId: sheetId }, setCell))];
+                                case 9:
+                                    result = _b.sent();
+                                    return [2 /*return*/, typeof result === "number" && Number.isFinite(result) ? result : undefined];
+                            }
+                        });
+                    }); };
+                    current = getEffectiveValue(sheetId, changingCell.rowIndex, changingCell.columnIndex);
+                    initialValue = typeof current === "number"
+                        ? current
+                        : typeof current === "string" && current.trim() !== "" && Number.isFinite(Number(current))
+                            ? Number(current)
+                            : 0;
+                    return [4 /*yield*/, goalSeek({ evaluate: evaluate, targetValue: targetValue, initialValue: initialValue })];
+                case 1:
+                    result = _d.sent();
+                    onChange(sheetId, changingCell, String(result.value), undefined);
+                    return [2 /*return*/, result];
+            }
+        });
+    }); }, [canEditCellRange, getFormulaValue, getEffectiveValue, onRequestCalculate, getDependents, onChange]);
+};

package/dist/cjs/hooks/use-on-import-excel.d.ts

@@ -19,6 +19,7 @@ export type UseOnImportExcelFileProps<T extends CellData, S extends Sheet> = {
     onChangeCellXfs?: UseSpreadsheetProps<T, S>["onChangeCellXfs"];
     onRequestFonts: UseSpreadsheetProps<T, S>["onRequestFonts"];
     onChangeTheme: UseSpreadsheetProps<T, S>["onChangeTheme"];
+    onChangeNamedCellStyles?: UseSpreadsheetProps<T, S>["onChangeNamedCellStyles"];
     onChangeSlicers: UseSpreadsheetProps<T, S>["onChangeSlicers"];
     /**
      * Phase D1 — pivot table import. Worker emits
@@ -39,7 +40,15 @@ export type UseOnImportExcelFileProps<T extends CellData, S extends Sheet> = {
 export type ExcelImportResponse = {
     requiresRecalc?: boolean;
     iterativeCalculationOptions?: IterativeCalculationOptions;
+    /**
+     * Date system of the imported cell data — always the 1900 system: a
+     * `date1904` workbook is converted on import (date-formatted serials
+     * shifted by 1462 days), so this can be wired straight to
+     * `SheetCell.setUse1904` / `createExcelFile({ use1904 })`.
+     */
     use1904?: boolean;
+    /** The source workbook declared the 1904 date system (informational). */
+    sourceUse1904?: boolean;
     success: boolean;
     isPasswordProtected?: boolean;
 };
@@ -59,7 +68,7 @@ export type ExcelImportOptions = {
      */
     prompt?: UseSpreadsheetProps["onPrompt"];
 };
-export declare const useOnImportExcelFile: <T extends CellData, S extends Sheet>({ enableExcelImportHistory, onChangeSheetData, onChangeSheets, onChangeTables, onChangeEmbeds, onChangeNamedRanges, onChangeSharedStrings, onChangeConditionalFormats, onChangeDataValidations, onChangeCellXfs, onChangeCharts, onRequestFonts, onChangeTheme, onCreateDataValidationRule, onClearHistory, onChangeHistory, onChangeSlicers, onChangePivotTables, evaluateConditionalFormatting, evaluateDataValidations, clearRangeCache, onConfirm, onPrompt, }: UseOnImportExcelFileProps<T, S>) => {
+export declare const useOnImportExcelFile: <T extends CellData, S extends Sheet>({ enableExcelImportHistory, onChangeSheetData, onChangeSheets, onChangeTables, onChangeEmbeds, onChangeNamedRanges, onChangeSharedStrings, onChangeConditionalFormats, onChangeDataValidations, onChangeCellXfs, onChangeCharts, onRequestFonts, onChangeTheme, onChangeNamedCellStyles, onCreateDataValidationRule, onClearHistory, onChangeHistory, onChangeSlicers, onChangePivotTables, evaluateConditionalFormatting, evaluateDataValidations, clearRangeCache, onConfirm, onPrompt, }: UseOnImportExcelFileProps<T, S>) => {
     importExcelFile: (file: File | ArrayBuffer, options?: ExcelImportOptions) => Promise<ExcelImportResponse>;
     isImportingExcelfile: boolean;
     generateStatePatches: () => Promise<SpreadsheetPatch>;

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

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

package/dist/cjs/hooks/use-on-import-excel.js

@@ -7,7 +7,7 @@ import { useCallback, useState } from "react";
 import { SheetCell } from "../sheet-cell";
 var TIMEOUT_FONT_LOAD = 5000;
 export var useOnImportExcelFile = function (_a) {
-    var _b = _a.enableExcelImportHistory, enableExcelImportHistory = _b === void 0 ? false : _b, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeEmbeds = _a.onChangeEmbeds, onChangeNamedRanges = _a.onChangeNamedRanges, onChangeSharedStrings = _a.onChangeSharedStrings, onChangeConditionalFormats = _a.onChangeConditionalFormats, onChangeDataValidations = _a.onChangeDataValidations, onChangeCellXfs = _a.onChangeCellXfs, onChangeCharts = _a.onChangeCharts, onRequestFonts = _a.onRequestFonts, onChangeTheme = _a.onChangeTheme, onCreateDataValidationRule = _a.onCreateDataValidationRule, onClearHistory = _a.onClearHistory, onChangeHistory = _a.onChangeHistory, onChangeSlicers = _a.onChangeSlicers, onChangePivotTables = _a.onChangePivotTables, evaluateConditionalFormatting = _a.evaluateConditionalFormatting, evaluateDataValidations = _a.evaluateDataValidations, clearRangeCache = _a.clearRangeCache, onConfirm = _a.onConfirm, onPrompt = _a.onPrompt;
+    var _b = _a.enableExcelImportHistory, enableExcelImportHistory = _b === void 0 ? false : _b, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeEmbeds = _a.onChangeEmbeds, onChangeNamedRanges = _a.onChangeNamedRanges, onChangeSharedStrings = _a.onChangeSharedStrings, onChangeConditionalFormats = _a.onChangeConditionalFormats, onChangeDataValidations = _a.onChangeDataValidations, onChangeCellXfs = _a.onChangeCellXfs, onChangeCharts = _a.onChangeCharts, onRequestFonts = _a.onRequestFonts, onChangeTheme = _a.onChangeTheme, onChangeNamedCellStyles = _a.onChangeNamedCellStyles, onCreateDataValidationRule = _a.onCreateDataValidationRule, onClearHistory = _a.onClearHistory, onChangeHistory = _a.onChangeHistory, onChangeSlicers = _a.onChangeSlicers, onChangePivotTables = _a.onChangePivotTables, evaluateConditionalFormatting = _a.evaluateConditionalFormatting, evaluateDataValidations = _a.evaluateDataValidations, clearRangeCache = _a.clearRangeCache, onConfirm = _a.onConfirm, onPrompt = _a.onPrompt;
     var _c = __read(useState(false), 2), isImportingExcelfile = _c[0], setIsImporting = _c[1];
     var _d = __read(useLoadingIndicator(), 2), showLoader = _d[0], hideLoader = _d[1];
     var getViewPort = useGetViewPort();
@@ -247,7 +247,7 @@ export var useOnImportExcelFile = function (_a) {
                         var _a = createExcelImportWorker(file, minRowCount, minColumnCount), observable = _a.observable, sendMessage = _a.sendMessage;
                         var requiresRecalc = false;
                         var iterativeCalculationOptions;
-                        var use1904 = false;
+                        var sourceUse1904 = false;
                         var isPromptingForPassword = false;
                         var isPasswordProtected = false;
                         // Set import
@@ -381,7 +381,7 @@ export var useOnImportExcelFile = function (_a) {
                                             requiresRecalc = (_m = response.requiresRecalc) !== null && _m !== void 0 ? _m : false;
                                             iterativeCalculationOptions =
                                                 (_o = response.iterativeCalculationOptions) !== null && _o !== void 0 ? _o : undefined;
-                                            use1904 = (_p = response.use1904) !== null && _p !== void 0 ? _p : false;
+                                            sourceUse1904 = (_p = response.use1904) !== null && _p !== void 0 ? _p : false;
                                         }
                                         if (response.responseType === ResponseType.GET_SHEETS_SUCCESS) {
                                             onChangeSheets(response.sheets);
@@ -393,6 +393,9 @@ export var useOnImportExcelFile = function (_a) {
                                             if (response.theme) {
                                                 onChangeTheme === null || onChangeTheme === void 0 ? void 0 : onChangeTheme(response.theme);
                                             }
+                                            if (response.namedCellStyles) {
+                                                onChangeNamedCellStyles === null || onChangeNamedCellStyles === void 0 ? void 0 : onChangeNamedCellStyles(response.namedCellStyles);
+                                            }
                                         }
                                         if (response.responseType === ResponseType.GET_CONDITIONAL_FORMATTING) {
                                             showLoader("Loading conditional formatting");
@@ -644,7 +647,8 @@ export var useOnImportExcelFile = function (_a) {
                                         resolve({
                                             requiresRecalc: requiresRecalc,
                                             iterativeCalculationOptions: iterativeCalculationOptions,
-                                            use1904: use1904,
+                                            use1904: false,
+                                            sourceUse1904: sourceUse1904,
                                             success: true,
                                             isPasswordProtected: isPasswordProtected,
                                         });

package/dist/cjs/hooks/use-on-merge-unmerge-cells.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-merge-unmerge-cells.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-merge-unmerge-cells.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,SAAS,EAGV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAOnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAO9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,KAAK,2BAA2B,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC/D,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,kBAAkB,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC3E,kBAAkB,EAAE,CAAC,SAAS,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC9D,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,iKAWzE,2BAA2B,CAAC,CAAC,EAAE,CAAC,CAAC;4BASrB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,cACpC,SAAS;8BAiSZ,MAAM,cACH,aAAa,qBACN,aAAa,CAAC,mBAAmB,CAAC,EAAE;CA4I5D,CAAC"}
+{"version":3,"file":"use-on-merge-unmerge-cells.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-merge-unmerge-cells.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,SAAS,EAGV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAOnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAO9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,KAAK,2BAA2B,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC/D,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,kBAAkB,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC3E,kBAAkB,EAAE,CAAC,SAAS,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC9D,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,iKAWzE,2BAA2B,CAAC,CAAC,EAAE,CAAC,CAAC;4BASrB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,cACpC,SAAS;8BAqRZ,MAAM,cACH,aAAa,qBACN,aAAa,CAAC,mBAAmB,CAAC,EAAE;CA4I5D,CAAC"}

package/dist/cjs/hooks/use-on-merge-unmerge-cells.js

@@ -17,6 +17,7 @@ export var useOnMergeUnMergeCells = function (_a) {
      * Merge cells
      */
     var onMergeCells = useCallback(function (sheetId, activeCell, selections, direction) {
+        var e_1, _a;
         if (!selections.length) {
             error("Merge Cells: Could not merge cells without selections");
             return;
@@ -45,6 +46,23 @@ export var useOnMergeUnMergeCells = function (_a) {
                 newMerges.push(__assign(__assign({}, range), { startColumnIndex: columnIndex, endColumnIndex: columnIndex }));
             }
         }
+        else if (selections.length > 1) {
+            try {
+                // A multi-area selection merges each area on its own (Excel's Merge & Center on a
+                // Ctrl-selection). The format painter tiles a source block's merges through this path.
+                for (var selections_1 = __values(selections), selections_1_1 = selections_1.next(); !selections_1_1.done; selections_1_1 = selections_1.next()) {
+                    var sel = selections_1_1.value;
+                    newMerges.push(sel.range);
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (selections_1_1 && !selections_1_1.done && (_a = selections_1.return)) _a.call(selections_1);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        }
         else {
             newMerges.push(range);
         }
@@ -82,8 +100,8 @@ export var useOnMergeUnMergeCells = function (_a) {
         // Update sheet data
         onChangeSheetData === null || onChangeSheetData === void 0 ? void 0 : onChangeSheetData(function (prevSheetData) {
             var _a = __read(produceWithPatches(prevSheetData, function (draft) {
-                var e_1, _a, e_2, _b, e_3, _c;
-                var _d, _e, _f, _g, _h, _j, _k, _l;
+                var e_2, _a, e_3, _b, e_4, _c, e_5, _d;
+                var _e, _f, _g, _h, _j, _k, _l, _m;
                 // First, check if we need to move content to master cells
                 // If master cell is empty, find first cell with content and copy it
                 var checkCell = new SheetCell();
@@ -95,7 +113,7 @@ export var useOnMergeUnMergeCells = function (_a) {
                             columnIndex: mergeRange.startColumnIndex,
                         };
                         // Check if master cell has content
-                        var masterCellData = (_f = (_e = (_d = draft[sheetId]) === null || _d === void 0 ? void 0 : _d[masterCell.rowIndex]) === null || _e === void 0 ? void 0 : _e.values) === null || _f === void 0 ? void 0 : _f[masterCell.columnIndex];
+                        var masterCellData = (_g = (_f = (_e = draft[sheetId]) === null || _e === void 0 ? void 0 : _e[masterCell.rowIndex]) === null || _f === void 0 ? void 0 : _f.values) === null || _g === void 0 ? void 0 : _g[masterCell.columnIndex];
                         // Use current() to get plain data from Immer draft
                         var plainMasterCellData = masterCellData
                             ? current(masterCellData)
@@ -111,14 +129,14 @@ export var useOnMergeUnMergeCells = function (_a) {
                         // If master cell is empty, find first cell with content and copy it
                         if (!masterHasContent) {
                             try {
-                                for (var _m = (e_2 = void 0, __values(iterateCellsInRange(mergeRange))), _o = _m.next(); !_o.done; _o = _m.next()) {
-                                    var _p = __read(_o.value, 2), rowIndex = _p[0], columnIndex = _p[1];
+                                for (var _o = (e_3 = void 0, __values(iterateCellsInRange(mergeRange))), _p = _o.next(); !_p.done; _p = _o.next()) {
+                                    var _q = __read(_p.value, 2), rowIndex = _q[0], columnIndex = _q[1];
                                     // Skip the master cell itself
                                     if (rowIndex === masterCell.rowIndex &&
                                         columnIndex === masterCell.columnIndex) {
                                         continue;
                                     }
-                                    var cellData = (_j = (_h = (_g = draft[sheetId]) === null || _g === void 0 ? void 0 : _g[rowIndex]) === null || _h === void 0 ? void 0 : _h.values) === null || _j === void 0 ? void 0 : _j[columnIndex];
+                                    var cellData = (_k = (_j = (_h = draft[sheetId]) === null || _h === void 0 ? void 0 : _h[rowIndex]) === null || _j === void 0 ? void 0 : _j.values) === null || _k === void 0 ? void 0 : _k[columnIndex];
                                     // Use current() to get plain data from Immer draft
                                     var plainCellData = cellData ? current(cellData) : cellData;
                                     // Check if cell has content
@@ -137,50 +155,51 @@ export var useOnMergeUnMergeCells = function (_a) {
                                     }
                                 }
                             }
-                            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                            catch (e_3_1) { e_3 = { error: e_3_1 }; }
                             finally {
                                 try {
-                                    if (_o && !_o.done && (_b = _m.return)) _b.call(_m);
+                                    if (_p && !_p.done && (_b = _o.return)) _b.call(_o);
                                 }
-                                finally { if (e_2) throw e_2.error; }
+                                finally { if (e_3) throw e_3.error; }
                             }
                         }
                     }
                 }
-                catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                catch (e_2_1) { e_2 = { error: e_2_1 }; }
                 finally {
                     try {
                         if (newMerges_1_1 && !newMerges_1_1.done && (_a = newMerges_1.return)) _a.call(newMerges_1);
                     }
-                    finally { if (e_1) throw e_1.error; }
+                    finally { if (e_2) throw e_2.error; }
                 }
                 // Keep track of master cells
                 // Merging cells only keeps the upper-left value and discards other values.
                 var masterCells = new Set();
-                if (direction === Direction.Right) {
-                    for (var rowIndex = range.startRowIndex; rowIndex <= range.endRowIndex; rowIndex++) {
-                        masterCells.add(cellIdentifier(rowIndex, range.startColumnIndex));
+                try {
+                    for (var newMerges_2 = __values(newMerges), newMerges_2_1 = newMerges_2.next(); !newMerges_2_1.done; newMerges_2_1 = newMerges_2.next()) {
+                        var merge = newMerges_2_1.value;
+                        masterCells.add(cellIdentifier(merge.startRowIndex, merge.startColumnIndex));
                     }
                 }
-                else if (direction === Direction.Down) {
-                    for (var columnIndex = range.startColumnIndex; columnIndex <= range.endColumnIndex; columnIndex++) {
-                        masterCells.add(cellIdentifier(range.startRowIndex, columnIndex));
+                catch (e_4_1) { e_4 = { error: e_4_1 }; }
+                finally {
+                    try {
+                        if (newMerges_2_1 && !newMerges_2_1.done && (_c = newMerges_2.return)) _c.call(newMerges_2);
                     }
-                }
-                else {
-                    masterCells.add(cellIdentifier(range.startRowIndex, range.startColumnIndex));
+                    finally { if (e_4) throw e_4.error; }
                 }
                 // Create a cell
                 var sheetCell = new SheetCell();
+                var mergedCells = newMerges.flatMap(function (merge) { return __spreadArray([], __read(iterateCellsInRange(merge)), false); });
                 try {
-                    for (var _q = __values(iterateCellsInRange(range)), _r = _q.next(); !_r.done; _r = _q.next()) {
-                        var _s = __read(_r.value, 2), rowIndex = _s[0], columnIndex = _s[1];
+                    for (var mergedCells_1 = __values(mergedCells), mergedCells_1_1 = mergedCells_1.next(); !mergedCells_1_1.done; mergedCells_1_1 = mergedCells_1.next()) {
+                        var _r = __read(mergedCells_1_1.value, 2), rowIndex = _r[0], columnIndex = _r[1];
                         var cellId = cellIdentifier(rowIndex, columnIndex);
                         if (masterCells.has(cellId)) {
                             continue;
                         }
                         var currentSheet = createSheetDraft(draft, sheetId, rowIndex);
-                        sheetCell.assign(sheetId, { rowIndex: rowIndex, columnIndex: columnIndex }, (_l = (_k = draft[sheetId][rowIndex]) === null || _k === void 0 ? void 0 : _k.values) === null || _l === void 0 ? void 0 : _l[columnIndex], { locale: locale, sharedStringRegistry: sharedStringRegistry, cellXfsRegistry: cellXfsRegistry });
+                        sheetCell.assign(sheetId, { rowIndex: rowIndex, columnIndex: columnIndex }, (_m = (_l = draft[sheetId][rowIndex]) === null || _l === void 0 ? void 0 : _l.values) === null || _m === void 0 ? void 0 : _m[columnIndex], { locale: locale, sharedStringRegistry: sharedStringRegistry, cellXfsRegistry: cellXfsRegistry });
                         // Clear values
                         sheetCell.setUserEnteredValue(undefined);
                         sheetCell.setEffectiveValue(undefined);
@@ -200,12 +219,12 @@ export var useOnMergeUnMergeCells = function (_a) {
                         });
                     }
                 }
-                catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                catch (e_5_1) { e_5 = { error: e_5_1 }; }
                 finally {
                     try {
-                        if (_r && !_r.done && (_c = _q.return)) _c.call(_q);
+                        if (mergedCells_1_1 && !mergedCells_1_1.done && (_d = mergedCells_1.return)) _d.call(mergedCells_1);
                     }
-                    finally { if (e_3) throw e_3.error; }
+                    finally { if (e_5) throw e_5.error; }
                 }
             }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
             // Update history
@@ -275,7 +294,7 @@ export var useOnMergeUnMergeCells = function (_a) {
         if (activeMerges) {
             onChangeSheetData === null || onChangeSheetData === void 0 ? void 0 : onChangeSheetData(function (prevSheetData) {
                 var _a = __read(produceWithPatches(prevSheetData, function (draft) {
-                    var e_4, _a, e_5, _b;
+                    var e_6, _a, e_7, _b;
                     var _c, _d;
                     try {
                         for (var activeMerges_1 = __values(activeMerges), activeMerges_1_1 = activeMerges_1.next(); !activeMerges_1_1.done; activeMerges_1_1 = activeMerges_1.next()) {
@@ -288,7 +307,7 @@ export var useOnMergeUnMergeCells = function (_a) {
                             // Create a cell
                             var sheetCell = new SheetCell();
                             try {
-                                for (var _e = (e_5 = void 0, __values(iterateCellsInRange(range))), _f = _e.next(); !_f.done; _f = _e.next()) {
+                                for (var _e = (e_7 = void 0, __values(iterateCellsInRange(range))), _f = _e.next(); !_f.done; _f = _e.next()) {
                                     var _g = __read(_f.value, 2), rowIndex = _g[0], columnIndex = _g[1];
                                     if (isEqualCells({ rowIndex: rowIndex, columnIndex: columnIndex }, topRightCell)) {
                                         continue;
@@ -314,21 +333,21 @@ export var useOnMergeUnMergeCells = function (_a) {
                                     });
                                 }
                             }
-                            catch (e_5_1) { e_5 = { error: e_5_1 }; }
+                            catch (e_7_1) { e_7 = { error: e_7_1 }; }
                             finally {
                                 try {
                                     if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
                                 }
-                                finally { if (e_5) throw e_5.error; }
+                                finally { if (e_7) throw e_7.error; }
                             }
                         }
                     }
-                    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+                    catch (e_6_1) { e_6 = { error: e_6_1 }; }
                     finally {
                         try {
                             if (activeMerges_1_1 && !activeMerges_1_1.done && (_a = activeMerges_1.return)) _a.call(activeMerges_1);
                         }
-                        finally { if (e_4) throw e_4.error; }
+                        finally { if (e_6) throw e_6.error; }
                     }
                 }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
                 // Update history
@@ -340,8 +359,8 @@ export var useOnMergeUnMergeCells = function (_a) {
             });
             // Clear selections
             // const newSelections = currentSelections
-            var selections_1 = activeMerges.map(function (range) { return ({ range: range }); });
-            onChangeSelections === null || onChangeSelections === void 0 ? void 0 : onChangeSelections(sheetId, selections_1);
+            var selections_2 = activeMerges.map(function (range) { return ({ range: range }); });
+            onChangeSelections === null || onChangeSelections === void 0 ? void 0 : onChangeSelections(sheetId, selections_2);
         }
         onCommand === null || onCommand === void 0 ? void 0 : onCommand({
             command: "unmerge-cells",

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

@@ -0,0 +1,26 @@
+import type { GridRange } from "@rowsncolumns/common-types";
+import { type SubtotalOptions, type SubtotalPlan, type SubtotalPlanExecutor } from "../api/subtotal";
+import type { useSheetProperties } from "./use-sheet-properties";
+export type { SubtotalOptions, SubtotalPlan };
+export type UseOnSubtotalProps = {
+    getEffectiveValue: ReturnType<typeof useSheetProperties>["getEffectiveValue"];
+    getFormattedValue: ReturnType<typeof useSheetProperties>["getFormattedValue"];
+    getFormulaValue: ReturnType<typeof useSheetProperties>["getFormulaValue"];
+    getRowOutlineLevel: ReturnType<typeof useSheetProperties>["getRowOutlineLevel"];
+    onDeleteRow: SubtotalPlanExecutor["onDeleteRow"];
+    onInsertRow: SubtotalPlanExecutor["onInsertRow"];
+    onChangeBatch: (sheetId: number, ranges: GridRange, values: (string | null)[][]) => void;
+    onGroupRows: SubtotalPlanExecutor["onGroupRows"];
+    onUngroupRows: SubtotalPlanExecutor["onUngroupRows"];
+};
+/**
+ * Excel's Data → Outline → Subtotal, composed over the existing row
+ * insert / batch write / row grouping callbacks so both engines execute it
+ * through the same streamed commands (see `planSubtotals` for the layout).
+ * Groups on the DISPLAYED value of the group column (Excel compares what the
+ * cells show). "Replace current subtotals" also resets the range's outline
+ * before regrouping, so re-applying keeps Excel's three levels. Returns the
+ * applied plan, or `undefined` when the range is protected or has no data rows.
+ */
+export declare const useOnSubtotal: ({ getEffectiveValue, getFormattedValue, getFormulaValue, getRowOutlineLevel, onDeleteRow, onInsertRow, onChangeBatch, onGroupRows, onUngroupRows, }: UseOnSubtotalProps) => (sheetId: number, options: SubtotalOptions) => SubtotalPlan | undefined;
+//# sourceMappingURL=use-on-subtotal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-subtotal.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-subtotal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAE9C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iBAAiB,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC9E,iBAAiB,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC9E,eAAe,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC1E,kBAAkB,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAChF,WAAW,EAAE,oBAAoB,CAAC,aAAa,CAAC,CAAC;IACjD,WAAW,EAAE,oBAAoB,CAAC,aAAa,CAAC,CAAC;IACjD,aAAa,EAAE,CACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,KACxB,IAAI,CAAC;IACV,WAAW,EAAE,oBAAoB,CAAC,aAAa,CAAC,CAAC;IACjD,aAAa,EAAE,oBAAoB,CAAC,eAAe,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,qJAU3B,kBAAkB,eAIP,MAAM,WAAW,eAAe,KAAG,YAAY,GAAG,SAoC/D,CAAC"}

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

@@ -0,0 +1,53 @@
+import { useCallback } from "react";
+import { applySubtotalPlan, planSubtotals, } from "../api/subtotal";
+import { useCanEditCellRange } from "./use-can-edit-cellrange";
+/**
+ * Excel's Data → Outline → Subtotal, composed over the existing row
+ * insert / batch write / row grouping callbacks so both engines execute it
+ * through the same streamed commands (see `planSubtotals` for the layout).
+ * Groups on the DISPLAYED value of the group column (Excel compares what the
+ * cells show). "Replace current subtotals" also resets the range's outline
+ * before regrouping, so re-applying keeps Excel's three levels. Returns the
+ * applied plan, or `undefined` when the range is protected or has no data rows.
+ */
+export var useOnSubtotal = function (_a) {
+    var getEffectiveValue = _a.getEffectiveValue, getFormattedValue = _a.getFormattedValue, getFormulaValue = _a.getFormulaValue, getRowOutlineLevel = _a.getRowOutlineLevel, onDeleteRow = _a.onDeleteRow, onInsertRow = _a.onInsertRow, onChangeBatch = _a.onChangeBatch, onGroupRows = _a.onGroupRows, onUngroupRows = _a.onUngroupRows;
+    var canEditCellRange = useCanEditCellRange();
+    return useCallback(function (sheetId, options) {
+        if (!canEditCellRange(sheetId, options.range)) {
+            console.debug("This range is protected, users cannot edit this cell range.");
+            return undefined;
+        }
+        var plan = planSubtotals(options, {
+            getValue: function (rowIndex, columnIndex) {
+                var _a;
+                return (_a = getFormattedValue(sheetId, rowIndex, columnIndex)) !== null && _a !== void 0 ? _a : getEffectiveValue(sheetId, rowIndex, columnIndex);
+            },
+            getFormula: function (rowIndex, columnIndex) {
+                return getFormulaValue(sheetId, rowIndex, columnIndex);
+            },
+            getOutlineLevel: function (rowIndex) { return getRowOutlineLevel(sheetId, rowIndex); },
+        });
+        if (!plan)
+            return undefined;
+        applySubtotalPlan(sheetId, plan, {
+            onDeleteRow: onDeleteRow,
+            onInsertRow: onInsertRow,
+            onChangeBatch: onChangeBatch,
+            onGroupRows: onGroupRows,
+            onUngroupRows: onUngroupRows,
+        });
+        return plan;
+    }, [
+        canEditCellRange,
+        getEffectiveValue,
+        getFormattedValue,
+        getFormulaValue,
+        getRowOutlineLevel,
+        onDeleteRow,
+        onInsertRow,
+        onChangeBatch,
+        onGroupRows,
+        onUngroupRows,
+    ]);
+};