@rowsncolumns/spreadsheet-state 28.0.72 → 28.0.74

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

@@ -10,6 +10,7 @@ import { useCallback } from "react";
 import { processSideEffectDependentCells } from "../api/dependency";
 import { createSheetCellIdentifier } from "../api/formula";
 import { createSheetDraft } from "../api/immer-utils";
+import { applyPasteOperation, isBlankClipboardCell, resolvePasteSpecialOptions, } from "../api/paste-special";
 import { findAdjacentTable, findTableColumnIndex } from "../api/table";
 import { addCalculatedColumnsForRowExpansion } from "../interface/change-table-column";
 import { collectDataValidationTarget, extendDataValidationRanges, } from "../interface/data-validation-utils";
@@ -64,13 +65,15 @@ export var useOnPaste = function (_a) {
     var getFinalRowHeight = useGetFinalRowHeight();
     var _e = useCalculationQueue({ enqueueCalculation: enqueueCalculation }), enqueue = _e.enqueue, processQueue = _e.processQueue;
     return useCallback(function (e, sourceSheetId, destinationSheetId, copiedSelections, activeCell, selections, finalSelections, isCutOperation) { return __awaiter(void 0, void 0, void 0, function () {
-        var pasteSpecialType, pasteEvent, forcePlainText, activeSheetName, from, merges, embeds, tables, columnWidths, rowHeights, selectedRowValues, rowIndex, start, end, pasteResults, saveHistory, dataValidationTargets, fontFamilies, fontFamiliesWithWeights, err_1, _a, rowSpan, colSpan, to, rowDelta, columnDelta, _b, adjacentTable, isRowExpansion, isColumnExpansion, currentTable, nextSelections, existingTable, destinationRows, visibleRowIndexes, tableHeaderColumnIndex, cellValue, formattedValue, sharedStrings, sharedStringValue, activeCellValue, recalcCells, newEndRowIndex_1, pastedSheetData, values, rowIndex, row, columnIndex, cell, ue, firstEmbedId_1, citationIdMap_1, dataRowIndex, rowData, dataColumnIndex, cellValue_1, newCitations_1, citationIdRemap_1, _loop_1, _c, _d, _e, oldCitationId, _f, sourceRowIndex, sourceColumnIndex;
+        var pasteSpecial, pasteMode, pasteOperation, pasteEvent, forcePlainText, activeSheetName, from, merges, embeds, tables, columnWidths, rowHeights, selectedRowValues, rowIndex, start, end, pasteResults, saveHistory, dataValidationTargets, fontFamilies, fontFamiliesWithWeights, err_1, _a, rowSpan, colSpan, to, rowDelta, columnDelta, _b, adjacentTable, isRowExpansion, isColumnExpansion, currentTable, nextSelections, existingTable, destinationRows, visibleRowIndexes, tableHeaderColumnIndex, cellValue, formattedValue, sharedStrings, sharedStringValue, activeCellValue, recalcCells, newEndRowIndex_1, pastedSheetData, values, rowIndex, row, columnIndex, cell, ue, firstEmbedId_1, citationIdMap_1, dataRowIndex, rowData, dataColumnIndex, cellValue_1, newCitations_1, citationIdRemap_1, _loop_1, _c, _d, _e, oldCitationId, _f, sourceRowIndex, sourceColumnIndex;
         var e_1, _g;
-        var _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
-        return __generator(this, function (_1) {
-            switch (_1.label) {
+        var _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
+        return __generator(this, function (_0) {
+            switch (_0.label) {
                 case 0:
-                    pasteSpecialType = (_h = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _h === void 0 ? void 0 : _h.getData("pasteSpecialType");
+                    pasteSpecial = resolvePasteSpecialOptions(e === null || e === void 0 ? void 0 : e.clipboardData);
+                    pasteMode = pasteSpecial.paste;
+                    pasteOperation = pasteSpecial.operation;
                     pasteEvent = e;
                     forcePlainText = Boolean((pasteEvent === null || pasteEvent === void 0 ? void 0 : pasteEvent.__forcePlainText) ||
                         ((pasteEvent === null || pasteEvent === void 0 ? void 0 : pasteEvent.shiftKey) &&
@@ -82,34 +85,34 @@ export var useOnPaste = function (_a) {
                     for (rowIndex = from.range.startRowIndex; rowIndex <= from.range.endRowIndex; rowIndex++) {
                         start = from.range.startColumnIndex;
                         end = start + from.range.endColumnIndex - from.range.startColumnIndex + 1;
-                        selectedRowValues.push((_m = (_l = (_k = (_j = sheetData === null || sheetData === void 0 ? void 0 : sheetData[sourceSheetId]) === null || _j === void 0 ? void 0 : _j[rowIndex]) === null || _k === void 0 ? void 0 : _k.values) === null || _l === void 0 ? void 0 : _l.slice(start, end)) !== null && _m !== void 0 ? _m : []);
+                        selectedRowValues.push((_l = (_k = (_j = (_h = sheetData === null || sheetData === void 0 ? void 0 : sheetData[sourceSheetId]) === null || _h === void 0 ? void 0 : _h[rowIndex]) === null || _j === void 0 ? void 0 : _j.values) === null || _k === void 0 ? void 0 : _k.slice(start, end)) !== null && _l !== void 0 ? _l : []);
                     }
                     return [3 /*break*/, 3];
                 case 1: return [4 /*yield*/, generateDataFromClipboard(e, activeCell, destinationSheetId, activeSheetName, preserveFormatting, locale, idCreationStrategy, forcePlainText, sanitizeHtml, generatedNames)];
                 case 2:
-                    pasteResults = _1.sent();
-                    selectedRowValues = (_o = pasteResults === null || pasteResults === void 0 ? void 0 : pasteResults.results) !== null && _o !== void 0 ? _o : [];
+                    pasteResults = _0.sent();
+                    selectedRowValues = (_m = pasteResults === null || pasteResults === void 0 ? void 0 : pasteResults.results) !== null && _m !== void 0 ? _m : [];
                     merges = pasteResults === null || pasteResults === void 0 ? void 0 : pasteResults.merges;
                     embeds = pasteResults === null || pasteResults === void 0 ? void 0 : pasteResults.embeds;
                     tables = pasteResults === null || pasteResults === void 0 ? void 0 : pasteResults.tables;
                     rowHeights = pasteResults === null || pasteResults === void 0 ? void 0 : pasteResults.rowHeights;
                     columnWidths = pasteResults === null || pasteResults === void 0 ? void 0 : pasteResults.columnWidths;
-                    _1.label = 3;
+                    _0.label = 3;
                 case 3:
                     // No data,
                     if (isNil(selectedRowValues)) {
                         return [2 /*return*/];
                     }
-                    if (pasteSpecialType === "Transposed") {
+                    if (pasteSpecial.transpose && selectedRowValues.length) {
                         selectedRowValues = transpose(selectedRowValues);
                     }
-                    else if (pasteSpecialType === "Formatting") {
+                    if (pasteMode === "formats") {
                         selectedRowValues = pickFormatting(selectedRowValues);
                     }
-                    else if (pasteSpecialType === "Formula") {
+                    else if (pasteMode === "formulas") {
                         selectedRowValues = pickFormula(selectedRowValues, destinationSheetId, locale);
                     }
-                    else if (pasteSpecialType === "Value") {
+                    else if (pasteMode === "values") {
                         selectedRowValues = pickValue(selectedRowValues, destinationSheetId, locale);
                     }
                     saveHistory = createHistory();
@@ -119,34 +122,34 @@ export var useOnPaste = function (_a) {
                     fontFamiliesWithWeights = fontFamilies
                         .map(function (family) { return ["".concat(family, ":400"), "".concat(family, ":700")]; })
                         .flat();
-                    _1.label = 4;
+                    _0.label = 4;
                 case 4:
-                    _1.trys.push([4, 9, , 10]);
+                    _0.trys.push([4, 9, , 10]);
                     if (!onRequestFonts) return [3 /*break*/, 6];
                     return [4 /*yield*/, onRequestFonts(fontFamilies)];
                 case 5:
-                    _1.sent();
+                    _0.sent();
                     return [3 /*break*/, 8];
                 case 6: return [4 /*yield*/, loadWebFont(fontFamiliesWithWeights)];
                 case 7:
-                    _1.sent();
-                    _1.label = 8;
+                    _0.sent();
+                    _0.label = 8;
                 case 8:
                     redrawGrid === null || redrawGrid === void 0 ? void 0 : redrawGrid();
                     return [3 /*break*/, 10];
                 case 9:
-                    err_1 = _1.sent();
+                    err_1 = _0.sent();
                     error("Error loading webfonts", fontFamilies, err_1);
                     return [3 /*break*/, 10];
                 case 10:
                     _a = __read([
-                        (_p = selectedRowValues === null || selectedRowValues === void 0 ? void 0 : selectedRowValues.length) !== null && _p !== void 0 ? _p : 0,
+                        (_o = selectedRowValues === null || selectedRowValues === void 0 ? void 0 : selectedRowValues.length) !== null && _o !== void 0 ? _o : 0,
                         // For cut operations, use range dimensions since data may be sparse
                         isCutOperation && from
                             ? from.range.endColumnIndex - from.range.startColumnIndex + 1
-                            : (_r = (_q = selectedRowValues[0]) === null || _q === void 0 ? void 0 : _q.length) !== null && _r !== void 0 ? _r : 0,
+                            : (_q = (_p = selectedRowValues[0]) === null || _p === void 0 ? void 0 : _p.length) !== null && _q !== void 0 ? _q : 0,
                     ], 2), rowSpan = _a[0], colSpan = _a[1];
-                    to = (_s = selections === null || selections === void 0 ? void 0 : selections[(selections === null || selections === void 0 ? void 0 : selections.length) - 1]) !== null && _s !== void 0 ? _s : selectionFromActiveCell(activeCell)[0];
+                    to = (_r = selections === null || selections === void 0 ? void 0 : selections[(selections === null || selections === void 0 ? void 0 : selections.length) - 1]) !== null && _r !== void 0 ? _r : selectionFromActiveCell(activeCell)[0];
                     rowDelta = from && to ? to.range.startRowIndex - from.range.startRowIndex : -1;
                     columnDelta = from && to
                         ? to.range.startColumnIndex - from.range.startColumnIndex
@@ -206,7 +209,7 @@ export var useOnPaste = function (_a) {
                         return rowIndex;
                     });
                     tableHeaderColumnIndex = findTableColumnIndex(destinationSheetId, activeCell, currentTables);
-                    cellValue = (_t = selectedRowValues === null || selectedRowValues === void 0 ? void 0 : selectedRowValues[0]) === null || _t === void 0 ? void 0 : _t[0];
+                    cellValue = (_s = selectedRowValues === null || selectedRowValues === void 0 ? void 0 : selectedRowValues[0]) === null || _s === void 0 ? void 0 : _s[0];
                     formattedValue = getCellFormattedValue(cellValue);
                     sharedStrings = sharedStringRegistry === null || sharedStringRegistry === void 0 ? void 0 : sharedStringRegistry.getSharedStrings();
                     sharedStringValue = (cellValue === null || cellValue === void 0 ? void 0 : cellValue.ss) == null || !sharedStrings
@@ -257,7 +260,7 @@ export var useOnPaste = function (_a) {
                         onChangeSheetData === null || onChangeSheetData === void 0 ? void 0 : onChangeSheetData(function (prevSheetData) {
                             var _a = __read(produceWithPatches(prevSheetData, function (draft) {
                                 var e_2, _a, e_3, _b, e_4, _c, e_5, _d, e_6, _e;
-                                var _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
+                                var _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
                                 // For cut operation
                                 var movedKeys = new Set();
                                 /**
@@ -267,8 +270,8 @@ export var useOnPaste = function (_a) {
                                 if (isCutOperation && from && to && !isNil(sourceSheetId)) {
                                     var sheetId = sourceSheetId;
                                     try {
-                                        for (var _y = __values(iterateCellsInRange(from.range)), _z = _y.next(); !_z.done; _z = _y.next()) {
-                                            var _0 = __read(_z.value, 2), rowIndex = _0[0], columnIndex = _0[1];
+                                        for (var _1 = __values(iterateCellsInRange(from.range)), _2 = _1.next(); !_2.done; _2 = _1.next()) {
+                                            var _3 = __read(_2.value, 2), rowIndex = _3[0], columnIndex = _3[1];
                                             // Process dependents
                                             processSideEffectDependentCells({
                                                 draft: draft,
@@ -293,7 +296,7 @@ export var useOnPaste = function (_a) {
                                     catch (e_2_1) { e_2 = { error: e_2_1 }; }
                                     finally {
                                         try {
-                                            if (_z && !_z.done && (_a = _y.return)) _a.call(_y);
+                                            if (_2 && !_2.done && (_a = _1.return)) _a.call(_1);
                                         }
                                         finally { if (e_2) throw e_2.error; }
                                     }
@@ -320,7 +323,7 @@ export var useOnPaste = function (_a) {
                                     }
                                     try {
                                         for (var destinationRows_1 = __values(destinationRows), destinationRows_1_1 = destinationRows_1.next(); !destinationRows_1_1.done; destinationRows_1_1 = destinationRows_1.next()) {
-                                            var _1 = destinationRows_1_1.value, rowIndex = _1.rowIndex, dataRowIndex = _1.dataRowIndex;
+                                            var _4 = destinationRows_1_1.value, rowIndex = _4.rowIndex, dataRowIndex = _4.dataRowIndex;
                                             var currentSheet = createSheetDraft(draft, destinationSheetId, rowIndex);
                                             var columnCursor = 0;
                                             for (var columnIndex = to.range.startColumnIndex; columnIndex <= to.range.endColumnIndex; columnIndex++, columnCursor++) {
@@ -328,12 +331,12 @@ export var useOnPaste = function (_a) {
                                                 currentSheet[rowIndex].values[columnIndex] =
                                                     (_m = movedRowValues[dataRowIndex]) === null || _m === void 0 ? void 0 : _m[dataColumnIndex];
                                                 try {
-                                                    for (var _2 = (e_4 = void 0, __values(getDependents({
+                                                    for (var _5 = (e_4 = void 0, __values(getDependents({
                                                         rowIndex: rowIndex,
                                                         columnIndex: columnIndex,
                                                         sheetId: destinationSheetId,
-                                                    }))), _3 = _2.next(); !_3.done; _3 = _2.next()) {
-                                                        var dependent = _3.value;
+                                                    }))), _6 = _5.next(); !_6.done; _6 = _5.next()) {
+                                                        var dependent = _6.value;
                                                         if (isStaticNode(dependent)) {
                                                             continue;
                                                         }
@@ -349,7 +352,7 @@ export var useOnPaste = function (_a) {
                                                 catch (e_4_1) { e_4 = { error: e_4_1 }; }
                                                 finally {
                                                     try {
-                                                        if (_3 && !_3.done && (_c = _2.return)) _c.call(_2);
+                                                        if (_6 && !_6.done && (_c = _5.return)) _c.call(_5);
                                                     }
                                                     finally { if (e_4) throw e_4.error; }
                                                 }
@@ -387,26 +390,54 @@ export var useOnPaste = function (_a) {
                                     };
                                     try {
                                         for (var destinationRows_2 = __values(destinationRows), destinationRows_2_1 = destinationRows_2.next(); !destinationRows_2_1.done; destinationRows_2_1 = destinationRows_2.next()) {
-                                            var _4 = destinationRows_2_1.value, rowIndex = _4.rowIndex, dataRowIndex = _4.dataRowIndex;
+                                            var _7 = destinationRows_2_1.value, rowIndex = _7.rowIndex, dataRowIndex = _7.dataRowIndex;
                                             var currentSheet = createSheetDraft(draft, destinationSheetId, rowIndex);
                                             var columnCursor = 0;
                                             for (var columnIndex = to.range.startColumnIndex; columnIndex <= to.range.endColumnIndex; columnIndex++, columnCursor++) {
                                                 var dataColumnIndex = colSpan > 0 ? columnCursor % colSpan : 0;
                                                 var cellValue_2 = (_o = selectedRowValues[dataRowIndex]) === null || _o === void 0 ? void 0 : _o[dataColumnIndex];
-                                                if (pasteSpecialType === "Formatting") {
-                                                    var existingCellData = (_r = (_q = (_p = prevSheetData[destinationSheetId]) === null || _p === void 0 ? void 0 : _p[rowIndex]) === null || _q === void 0 ? void 0 : _q.values) === null || _r === void 0 ? void 0 : _r[columnIndex];
+                                                // Skip blanks: an empty clipboard cell leaves the
+                                                // destination (value and format) untouched.
+                                                if (pasteSpecial.skipBlanks &&
+                                                    isBlankClipboardCell(cellValue_2)) {
+                                                    continue;
+                                                }
+                                                // Operation: combine the pasted cell with the cell it
+                                                // lands on. The clipboard is anchored at the FIRST tile,
+                                                // so a source formula is relocated to the tile it lands
+                                                // on first (the same `moveFormula` shift the plain paste
+                                                // applies below); the composed `=(dest)op(source)` is
+                                                // then anchored at the destination and must not be moved
+                                                // again (that would shift the destination fragment too).
+                                                if (pasteOperation) {
+                                                    var sourceFormula = getExtendedValueFormula(getCellUserEnteredValue(cellValue_2));
+                                                    if (!isNil(sourceFormula) &&
+                                                        dataRowIndex === 0 &&
+                                                        dataColumnIndex === 0 &&
+                                                        (rowIndex !== sourceCell.rowIndex ||
+                                                            columnIndex !== sourceCell.columnIndex)) {
+                                                        var tileCell = new SheetCell();
+                                                        tileCell.setLocale(locale);
+                                                        tileCell.assign(destinationSheetId, sourceCell, cellValue_2);
+                                                        tileCell.moveFormula(sourceCell, { rowIndex: rowIndex, columnIndex: columnIndex }, activeSheetName, { preserveAbsolutes: true });
+                                                        cellValue_2 = __assign(__assign({}, cellValue_2), { ue: __assign(__assign({}, cellValue_2 === null || cellValue_2 === void 0 ? void 0 : cellValue_2.ue), { fv: tileCell.formula }) });
+                                                    }
+                                                    cellValue_2 = applyPasteOperation(cellValue_2, (_r = (_q = (_p = prevSheetData[destinationSheetId]) === null || _p === void 0 ? void 0 : _p[rowIndex]) === null || _q === void 0 ? void 0 : _q.values) === null || _r === void 0 ? void 0 : _r[columnIndex], pasteOperation, destinationSheetId, locale);
+                                                }
+                                                if (pasteMode === "formats") {
+                                                    var existingCellData = (_u = (_t = (_s = prevSheetData[destinationSheetId]) === null || _s === void 0 ? void 0 : _s[rowIndex]) === null || _t === void 0 ? void 0 : _t.values) === null || _u === void 0 ? void 0 : _u[columnIndex];
                                                     cellValue_2 = __assign(__assign({}, existingCellData), cellValue_2);
                                                     sheetCell.extendCellData(cellValue_2);
                                                 }
-                                                if (pasteSpecialType === "Value" || forcePlainText) {
-                                                    var existingCellData = (_u = (_t = (_s = prevSheetData[destinationSheetId]) === null || _s === void 0 ? void 0 : _s[rowIndex]) === null || _t === void 0 ? void 0 : _t.values) === null || _u === void 0 ? void 0 : _u[columnIndex];
+                                                if (pasteMode === "values" || forcePlainText) {
+                                                    var existingCellData = (_x = (_w = (_v = prevSheetData[destinationSheetId]) === null || _v === void 0 ? void 0 : _v[rowIndex]) === null || _w === void 0 ? void 0 : _w.values) === null || _x === void 0 ? void 0 : _x[columnIndex];
                                                     // Remove ss from existingCellData since we're replacing the value
-                                                    var _5 = existingCellData !== null && existingCellData !== void 0 ? existingCellData : {}, _ss = _5.ss, existingWithoutSs = __rest(_5, ["ss"]);
+                                                    var _8 = existingCellData !== null && existingCellData !== void 0 ? existingCellData : {}, _ss = _8.ss, existingWithoutSs = __rest(_8, ["ss"]);
                                                     cellValue_2 = __assign(__assign({}, existingWithoutSs), cellValue_2);
                                                     sheetCell.extendCellData(cellValue_2);
                                                 }
-                                                if (pasteSpecialType === "Transposed") {
-                                                    sheetCell.assign(destinationSheetId, { rowIndex: rowIndex, columnIndex: columnIndex }, (_x = (_w = (_v = prevSheetData[destinationSheetId]) === null || _v === void 0 ? void 0 : _v[rowIndex]) === null || _w === void 0 ? void 0 : _w.values) === null || _x === void 0 ? void 0 : _x[columnIndex], {
+                                                if (pasteSpecial.transpose && pasteMode === "all") {
+                                                    sheetCell.assign(destinationSheetId, { rowIndex: rowIndex, columnIndex: columnIndex }, (_0 = (_z = (_y = prevSheetData[destinationSheetId]) === null || _y === void 0 ? void 0 : _y[rowIndex]) === null || _z === void 0 ? void 0 : _z.values) === null || _0 === void 0 ? void 0 : _0[columnIndex], {
                                                         locale: locale,
                                                         cellXfsRegistry: cellXfsRegistry,
                                                         getDataValidationById: getDataValidationById,
@@ -427,11 +458,13 @@ export var useOnPaste = function (_a) {
                                                         sharedStringRegistry: sharedStringRegistry,
                                                     });
                                                 }
-                                                if (pasteSpecialType === "Formatting") {
+                                                if (pasteMode === "formats") {
                                                     sheetCell.refreshFormattedValue();
                                                 }
                                                 if (sheetCell.isFormula()) {
-                                                    if (dataRowIndex === 0 && dataColumnIndex === 0) {
+                                                    if (dataRowIndex === 0 &&
+                                                        dataColumnIndex === 0 &&
+                                                        !pasteOperation) {
                                                         sheetCell.moveFormula(sourceCell, {
                                                             rowIndex: rowIndex,
                                                             columnIndex: columnIndex,
@@ -454,12 +487,12 @@ export var useOnPaste = function (_a) {
                                                     });
                                                 }
                                                 try {
-                                                    for (var _6 = (e_6 = void 0, __values(getDependents({
+                                                    for (var _9 = (e_6 = void 0, __values(getDependents({
                                                         rowIndex: rowIndex,
                                                         columnIndex: columnIndex,
                                                         sheetId: destinationSheetId,
-                                                    }))), _7 = _6.next(); !_7.done; _7 = _6.next()) {
-                                                        var dependent = _7.value;
+                                                    }))), _10 = _9.next(); !_10.done; _10 = _9.next()) {
+                                                        var dependent = _10.value;
                                                         if (isStaticNode(dependent)) {
                                                             continue;
                                                         }
@@ -475,7 +508,7 @@ export var useOnPaste = function (_a) {
                                                 catch (e_6_1) { e_6 = { error: e_6_1 }; }
                                                 finally {
                                                     try {
-                                                        if (_7 && !_7.done && (_e = _6.return)) _e.call(_6);
+                                                        if (_10 && !_10.done && (_e = _9.return)) _e.call(_9);
                                                     }
                                                     finally { if (e_6) throw e_6.error; }
                                                 }
@@ -620,10 +653,7 @@ export var useOnPaste = function (_a) {
                                     // Skipped for paste-special variants since the destination
                                     // cell ends up as a merge of existing + pasted data, not
                                     // the raw pasted value we can read from selectedRowValues.
-                                    var skipAutoResize = pasteSpecialType === "Formatting" ||
-                                        pasteSpecialType === "Value" ||
-                                        pasteSpecialType === "Formula" ||
-                                        pasteSpecialType === "Transposed";
+                                    var skipAutoResize = pasteSpecial.isSpecial;
                                     if (!skipAutoResize &&
                                         getFinalRowHeight &&
                                         selectedRowValues.length &&
@@ -744,11 +774,11 @@ export var useOnPaste = function (_a) {
                             for (rowIndex = to.range.startRowIndex; rowIndex <= to.range.endRowIndex; rowIndex++) {
                                 row = [];
                                 for (columnIndex = to.range.startColumnIndex; columnIndex <= to.range.endColumnIndex; columnIndex++) {
-                                    cell = (_w = (_v = (_u = pastedSheetData[destinationSheetId]) === null || _u === void 0 ? void 0 : _u[rowIndex]) === null || _v === void 0 ? void 0 : _v.values) === null || _w === void 0 ? void 0 : _w[columnIndex];
+                                    cell = (_v = (_u = (_t = pastedSheetData[destinationSheetId]) === null || _t === void 0 ? void 0 : _t[rowIndex]) === null || _u === void 0 ? void 0 : _u.values) === null || _v === void 0 ? void 0 : _v[columnIndex];
                                     ue = cell ? getCellUserEnteredValue(cell) : undefined;
                                     // Formula text wins (e.g. "=SUM(A1:A2)"), else the literal string / number / bool.
                                     // `??` (not `||`) so 0 and false survive; `null` clears the cell.
-                                    row.push((_0 = (_z = (_y = (_x = getExtendedValueFormula(ue)) !== null && _x !== void 0 ? _x : getExtendedValueString(ue)) !== null && _y !== void 0 ? _y : getExtendedValueNumber(ue)) !== null && _z !== void 0 ? _z : getExtendedValueBool(ue)) !== null && _0 !== void 0 ? _0 : null);
+                                    row.push((_z = (_y = (_x = (_w = getExtendedValueFormula(ue)) !== null && _w !== void 0 ? _w : getExtendedValueString(ue)) !== null && _x !== void 0 ? _x : getExtendedValueNumber(ue)) !== null && _y !== void 0 ? _y : getExtendedValueBool(ue)) !== null && _z !== void 0 ? _z : null);
                                 }
                                 values.push(row);
                             }

package/dist/cjs/hooks/use-on-remove-duplicates.d.ts

@@ -1,5 +1,6 @@
 import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
 import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import { type RemoveDuplicatesOptions } from "../interface/remove-duplicates";
 import type { useCalculation } from "./use-calculation";
 import type { useSheetProperties } from "./use-sheet-properties";
 import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
@@ -17,5 +18,5 @@ export type UseOnRemoveDuplicatesProps<T extends CellData> = {
     onChangeSheetData: UseSpreadsheetProps<T, Sheet>["onChangeSheetData"];
     onCommand?: OnCommand;
 };
-export declare const useOnRemoveDuplicates: <T extends CellData>({ locale, cellXfsRegistry, sharedStringRegistry, getFormattedValue, onChangeSheetData, enqueueCalculation, createHistory, onCommand, }: UseOnRemoveDuplicatesProps<T>) => (sheetId: number, activeCell: CellInterface, selections?: SelectionArea<SelectionAttributes>[]) => import("../interface/remove-duplicates").RemoveDuplicatesResult | undefined;
+export declare const useOnRemoveDuplicates: <T extends CellData>({ locale, cellXfsRegistry, sharedStringRegistry, getFormattedValue, onChangeSheetData, enqueueCalculation, createHistory, onCommand, }: UseOnRemoveDuplicatesProps<T>) => (sheetId: number, activeCell: CellInterface, selections?: SelectionArea<SelectionAttributes>[], options?: RemoveDuplicatesOptions) => import("../interface/remove-duplicates").RemoveDuplicatesResult | undefined;
 //# sourceMappingURL=use-on-remove-duplicates.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-on-remove-duplicates.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-remove-duplicates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAKnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,MAAM,0BAA0B,CAAC,CAAC,SAAS,QAAQ,IAAI;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,iBAAiB,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC9E,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACtE,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EAAE,wIASvD,0BAA0B,CAAC,CAAC,CAAC,eAKjB,MAAM,cACH,aAAa,eACZ,aAAa,CAAC,mBAAmB,CAAC,EAAE,gFAyCtD,CAAC"}
+{"version":3,"file":"use-on-remove-duplicates.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-remove-duplicates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,MAAM,0BAA0B,CAAC,CAAC,SAAS,QAAQ,IAAI;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,iBAAiB,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC9E,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACtE,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EAAE,wIASvD,0BAA0B,CAAC,CAAC,CAAC,eAKjB,MAAM,cACH,aAAa,eACZ,aAAa,CAAC,mBAAmB,CAAC,EAAE,YACvC,uBAAuB,gFA2CtC,CAAC"}

package/dist/cjs/hooks/use-on-remove-duplicates.js

@@ -1,10 +1,10 @@
 import { useCallback } from "react";
-import { removeDuplicates } from "../interface/remove-duplicates";
+import { removeDuplicates, } from "../interface/remove-duplicates";
 import { useCanEditCellRange } from "./use-can-edit-cellrange";
 export var useOnRemoveDuplicates = function (_a) {
     var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getFormattedValue = _a.getFormattedValue, onChangeSheetData = _a.onChangeSheetData, enqueueCalculation = _a.enqueueCalculation, createHistory = _a.createHistory, onCommand = _a.onCommand;
     var canEditCellRange = useCanEditCellRange();
-    return useCallback(function (sheetId, activeCell, selections) {
+    return useCallback(function (sheetId, activeCell, selections, options) {
         if (!canEditCellRange(sheetId, activeCell)) {
             console.debug("This range is protected, users cannot edit this cell range.");
             return;
@@ -17,13 +17,15 @@ export var useOnRemoveDuplicates = function (_a) {
             onChangeSheetData: onChangeSheetData,
             enqueueCalculation: enqueueCalculation,
             createHistory: createHistory,
-        })(sheetId, activeCell, selections);
+        })(sheetId, activeCell, selections, options);
         // Stream the semantic command so an engine consumer recomputes from the deduped cells.
         onCommand === null || onCommand === void 0 ? void 0 : onCommand({
             command: "remove-duplicates",
             sheetId: sheetId,
             activeCell: activeCell,
             selections: selections !== null && selections !== void 0 ? selections : [],
+            columnIndices: options === null || options === void 0 ? void 0 : options.columnIndices,
+            hasHeader: options === null || options === void 0 ? void 0 : options.hasHeader,
         });
         return result;
     }, [

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

@@ -1 +1 @@
-{"version":3,"file":"use-on-show-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-show-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE/E,OAAO,KAAK,EACV,QAAQ,EAER,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAMnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,oBAAoB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC/D,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/D,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,GAC/C,IAAI,CAAC;IACR,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,iGAOlE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,eAMf,MAAM,iBAAiB,MAAM,EAAE,SAwF5C,CAAC"}
+{"version":3,"file":"use-on-show-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-show-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE/E,OAAO,KAAK,EACV,QAAQ,EAER,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAMnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,oBAAoB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC/D,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/D,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,GAC/C,IAAI,CAAC;IACR,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,iGAOlE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,eAMf,MAAM,iBAAiB,MAAM,EAAE,SAyF5C,CAAC"}

package/dist/cjs/hooks/use-on-show-column.js

@@ -24,6 +24,8 @@ export var useOnShowColumn = function (_a) {
             });
             return;
         }
+        if (columnIndexes.length === 0)
+            return;
         var saveHistory = createHistory();
         var firstColumnIndex = columnIndexes[0];
         var newActiveCell = (_a = getNextFocusableCell === null || getNextFocusableCell === void 0 ? void 0 : getNextFocusableCell(sheetId, { rowIndex: 0, columnIndex: firstColumnIndex }, Direction.Down, false)) !== null && _a !== void 0 ? _a : { rowIndex: 1, columnIndex: firstColumnIndex };

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

@@ -1 +1 @@
-{"version":3,"file":"use-on-show-row.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-show-row.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE/E,OAAO,KAAK,EACV,QAAQ,EAER,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AASnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,iBAAiB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC5D,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/D,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,GAC/C,IAAI,CAAC;IACR,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,IAAI,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,2HAQ/D,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,eAMZ,MAAM,cAAc,MAAM,EAAE,SA4FzC,CAAC"}
+{"version":3,"file":"use-on-show-row.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-show-row.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE/E,OAAO,KAAK,EACV,QAAQ,EAER,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AASnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,iBAAiB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC5D,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/D,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,GAC/C,IAAI,CAAC;IACR,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,IAAI,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,2HAQ/D,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,eAMZ,MAAM,cAAc,MAAM,EAAE,SA6FzC,CAAC"}

package/dist/cjs/hooks/use-on-show-row.js

@@ -24,6 +24,8 @@ export var useOnShowRow = function (_a) {
             });
             return;
         }
+        if (rowIndexes.length === 0)
+            return;
         var saveHistory = createHistory();
         var firstRowIndex = rowIndexes[0];
         var newActiveCell = (_a = getNextFocusableCell === null || getNextFocusableCell === void 0 ? void 0 : getNextFocusableCell(sheetId, { rowIndex: firstRowIndex, columnIndex: 0 }, Direction.Right, false)) !== null && _a !== void 0 ? _a : { rowIndex: firstRowIndex, columnIndex: 1 };

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,
+    ]);
+};

package/dist/cjs/hooks/use-paint-format.d.ts

@@ -1,5 +1,5 @@
-import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
-import type { SelectionAttributes, SheetRange } from "@rowsncolumns/spreadsheet";
+import type { CellInterface, GridRange, SelectionArea } from "@rowsncolumns/common-types";
+import type { CellFormat, SelectionAttributes, SheetRange } from "@rowsncolumns/spreadsheet";
 import type { useOnChangeFormatting } from "./use-on-change-formatting";
 import type { useSheetProperties } from "./use-sheet-properties";
 import type { useSheetState } from "./use-sheet-state";
@@ -7,8 +7,24 @@ export type UsePaintFormatProps = {
     onChangeSelections: ReturnType<typeof useSheetState>["onChangeSelections"];
     onChangeFormatting: ReturnType<typeof useOnChangeFormatting>["onChangeFormatting"];
     getEffectiveFormat: ReturnType<typeof useSheetProperties>["getEffectiveFormat"];
+    /**
+     * The merges of a sheet (absolute ranges). When provided, the painter carries the merges that
+     * lie fully inside the source block and tiles them onto the target (Sheets / Excel parity).
+     */
+    getMerges?: (sheetId: number) => GridRange[] | null | undefined;
+    /**
+     * Replace the merges inside `targetRange` with `merges` (already tiled, absolute). The
+     * spreadsheet-state wiring unmerges the target then merges each range in one step.
+     */
+    onPaintMerges?: (sheetId: number, activeCell: CellInterface, targetRange: GridRange, merges: GridRange[]) => void;
+    /**
+     * The table-banding / alternating-colour formats the grid paints on a sheet (keyed by
+     * `cellIdentifier`). When provided, the captured pattern carries the visible stripe colours as
+     * static fills, like Sheets.
+     */
+    getBandedCells?: (sheetId: number) => Map<string, CellFormat> | undefined;
 };
-export declare const usePaintFormat: ({ getEffectiveFormat, onChangeFormatting, onChangeSelections, }: UsePaintFormatProps) => {
+export declare const usePaintFormat: ({ getEffectiveFormat, onChangeFormatting, onChangeSelections, getMerges, onPaintMerges, getBandedCells, }: UsePaintFormatProps) => {
     isPaintFormatActive: boolean;
     onSavePaintFormat: (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
     onApplyPaintFormat: (sheetId: number, activeCell: CellInterface, selections?: SelectionArea<SelectionAttributes>[]) => void;

package/dist/cjs/hooks/use-paint-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-paint-format.d.ts","sourceRoot":"","sources":["../../../hooks/use-paint-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE/E,OAAO,KAAK,EAEV,mBAAmB,EACnB,UAAU,EACX,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG;IAChC,kBAAkB,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC3E,kBAAkB,EAAE,UAAU,CAC5B,OAAO,qBAAqB,CAC7B,CAAC,oBAAoB,CAAC,CAAC;IACxB,kBAAkB,EAAE,UAAU,CAC5B,OAAO,kBAAkB,CAC1B,CAAC,oBAAoB,CAAC,CAAC;CACzB,CAAC;AAMF,eAAO,MAAM,cAAc,GAAI,iEAI5B,mBAAmB;;iCAOP,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE;kCAiCvC,MAAM,cACH,aAAa,eACZ,aAAa,CAAC,mBAAmB,CAAC,EAAE;oCAsE/B,UAAU,oBAIV,UAAU;CAgDjC,CAAC"}
+{"version":3,"file":"use-paint-format.d.ts","sourceRoot":"","sources":["../../../hooks/use-paint-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,UAAU,EACX,MAAM,2BAA2B,CAAC;AAUnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG;IAChC,kBAAkB,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC3E,kBAAkB,EAAE,UAAU,CAC5B,OAAO,qBAAqB,CAC7B,CAAC,oBAAoB,CAAC,CAAC;IACxB,kBAAkB,EAAE,UAAU,CAC5B,OAAO,kBAAkB,CAC1B,CAAC,oBAAoB,CAAC,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAChE;;;OAGG;IACH,aAAa,CAAC,EAAE,CACd,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,EACzB,WAAW,EAAE,SAAS,EACtB,MAAM,EAAE,SAAS,EAAE,KAChB,IAAI,CAAC;IACV;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,CAAC;CAC3E,CAAC;AAaF,eAAO,MAAM,cAAc,GAAI,2GAO5B,mBAAmB;;iCA4EP,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE;kCAkBvC,MAAM,cACH,aAAa,eACZ,aAAa,CAAC,mBAAmB,CAAC,EAAE;oCAkF/B,UAAU,oBAIV,UAAU;CAmCjC,CAAC"}