@rowsncolumns/spreadsheet-state 28.0.73 → 28.0.75

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

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;AACpC,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,UAAU,EACX,MAAM,2BAA2B,CAAC;AAYnC,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;;iCA8EP,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE;kCAevC,MAAM,cACH,aAAa,eACZ,aAAa,CAAC,mBAAmB,CAAC,EAAE;oCAkF/B,UAAU,oBAIV,UAAU;CAmCjC,CAAC"}

package/dist/cjs/hooks/use-paint-format.js

@@ -1,39 +1,92 @@
 import { __assign, __read, __values } from "tslib";
-import { selectionFromActiveCell } from "@rowsncolumns/grid";
 import { useCallback, useState } from "react";
+import { collectPaintMerges, getBandedCellFormat, layerBandedFormat, paintSourceForActiveCell, spreadMergeAnchorFormats, tilePaintMerges, } from "../api/paint-format";
 // A paint-format target spanning at least this many rows/cols is a header-click
 // full-column/row selection, not an intentional drag — bound it to the pattern.
 var UNBOUNDED_PAINT_SPAN = 10000;
+var EMPTY_PATTERN = {
+    formats: [],
+    merges: [],
+    rows: 0,
+    cols: 0,
+};
 export var usePaintFormat = function (_a) {
-    var getEffectiveFormat = _a.getEffectiveFormat, onChangeFormatting = _a.onChangeFormatting, onChangeSelections = _a.onChangeSelections;
-    var _b = __read(useState([]), 2), paintFormats = _b[0], setPaintFormats = _b[1];
-    var onSavePaintFormat = useCallback(function (sheetId, activeCell, selections) {
+    var getEffectiveFormat = _a.getEffectiveFormat, onChangeFormatting = _a.onChangeFormatting, onChangeSelections = _a.onChangeSelections, getMerges = _a.getMerges, onPaintMerges = _a.onPaintMerges, getBandedCells = _a.getBandedCells;
+    var _b = __read(useState(EMPTY_PATTERN), 2), pattern = _b[0], setPattern = _b[1];
+    var paintFormats = pattern.formats;
+    /**
+     * Capture the visible look of `range`: the effective format of every cell layered over the
+     * table stripe the grid paints beneath it, plus the merges fully inside the range.
+     */
+    var capturePattern = useCallback(function (sheetId, ranges) {
         var e_1, _a;
-        var finalSelections = selections.length
-            ? selections
-            : selectionFromActiveCell(activeCell);
-        var paintFormats = [];
+        var _b, _c;
+        var bandedCells = getBandedCells === null || getBandedCells === void 0 ? void 0 : getBandedCells(sheetId);
+        var formats = [];
         try {
-            for (var finalSelections_1 = __values(finalSelections), finalSelections_1_1 = finalSelections_1.next(); !finalSelections_1_1.done; finalSelections_1_1 = finalSelections_1.next()) {
-                var sel = finalSelections_1_1.value;
-                for (var rowIndex = sel.range.startRowIndex; rowIndex <= sel.range.endRowIndex; rowIndex++) {
+            for (var ranges_1 = __values(ranges), ranges_1_1 = ranges_1.next(); !ranges_1_1.done; ranges_1_1 = ranges_1.next()) {
+                var range = ranges_1_1.value;
+                for (var rowIndex = range.startRowIndex; rowIndex <= range.endRowIndex; rowIndex++) {
                     var rowFormats = [];
-                    for (var columnIndex = sel.range.startColumnIndex; columnIndex <= sel.range.endColumnIndex; columnIndex++) {
-                        rowFormats.push(getEffectiveFormat(sheetId, rowIndex, columnIndex));
+                    for (var columnIndex = range.startColumnIndex; columnIndex <= range.endColumnIndex; columnIndex++) {
+                        rowFormats.push(layerBandedFormat(getEffectiveFormat(sheetId, rowIndex, columnIndex), getBandedCellFormat(bandedCells, rowIndex, columnIndex)));
                     }
-                    paintFormats.push(rowFormats);
+                    formats.push(rowFormats);
                 }
             }
         }
         catch (e_1_1) { e_1 = { error: e_1_1 }; }
         finally {
             try {
-                if (finalSelections_1_1 && !finalSelections_1_1.done && (_a = finalSelections_1.return)) _a.call(finalSelections_1);
+                if (ranges_1_1 && !ranges_1_1.done && (_a = ranges_1.return)) _a.call(ranges_1);
             }
             finally { if (e_1) throw e_1.error; }
         }
-        setPaintFormats(paintFormats);
-    }, [getEffectiveFormat]);
+        // Merges travel with a single-block source only; a multi-area capture has no single
+        // tiling origin (the format rows are stacked, as before).
+        var source = ranges.length === 1 ? ranges[0] : undefined;
+        var merges = source
+            ? collectPaintMerges(getMerges === null || getMerges === void 0 ? void 0 : getMerges(sheetId), source)
+            : [];
+        // Excel keeps a merged area's style on every constituent cell; the grid paints the anchor's.
+        spreadMergeAnchorFormats(formats, merges);
+        return {
+            formats: formats,
+            merges: merges,
+            rows: formats.length,
+            cols: (_c = (_b = formats[0]) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0,
+        };
+    }, [getEffectiveFormat, getBandedCells, getMerges]);
+    /**
+     * Replace the target's merges with the pattern's, tiled with the pattern's period.
+     */
+    var applyPatternMerges = useCallback(function (sheetId, activeCell, current, targets) {
+        var e_2, _a;
+        if (!current.merges.length || !onPaintMerges)
+            return;
+        try {
+            for (var targets_1 = __values(targets), targets_1_1 = targets_1.next(); !targets_1_1.done; targets_1_1 = targets_1.next()) {
+                var target = targets_1_1.value;
+                var tiled = tilePaintMerges(current.merges, current.rows, current.cols, target);
+                onPaintMerges(sheetId, activeCell, target, tiled);
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (targets_1_1 && !targets_1_1.done && (_a = targets_1.return)) _a.call(targets_1);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+    }, [onPaintMerges]);
+    var onSavePaintFormat = useCallback(function (sheetId, activeCell, selections) {
+        // A plain click on a merged cell arms the painter with the anchor and NO selection (the
+        // grid clears the list) — Excel treats that click as the whole merged area.
+        var ranges = selections.length
+            ? selections.map(function (sel) { return sel.range; })
+            : [paintSourceForActiveCell(getMerges === null || getMerges === void 0 ? void 0 : getMerges(sheetId), activeCell)];
+        setPattern(capturePattern(sheetId, ranges));
+    }, [capturePattern, getMerges]);
     // Applies a saved paintFormat
     var onApplyPaintFormat = useCallback(function (sheetId, activeCell, selections) {
         /**
@@ -46,9 +99,7 @@ export var usePaintFormat = function (_a) {
         // header-click full-column/row targets are bounded to the pattern so a paint
         // never enumerates an entire 1M-row column.
         var clampEnd = function (start, end, span) {
-            return end - start >= UNBOUNDED_PAINT_SPAN
-                ? Math.min(end, start + span)
-                : end;
+            return end - start >= UNBOUNDED_PAINT_SPAN ? Math.min(end, start + span) : end;
         };
         var newSelections = (selections === null || selections === void 0 ? void 0 : selections.length)
             ? selections.map(function (sel) { return (__assign(__assign({}, sel), { range: __assign(__assign({}, sel.range), { endRowIndex: clampEnd(sel.range.startRowIndex, sel.range.endRowIndex, rowSpan), endColumnIndex: clampEnd(sel.range.startColumnIndex, sel.range.endColumnIndex, colSpan) }) })); })
@@ -66,6 +117,8 @@ export var usePaintFormat = function (_a) {
         onChangeFormatting(sheetId, activeCell, newSelections, paintFormats, {
             replace: true,
         });
+        // Merges tile with the same period as the formats.
+        applyPatternMerges(sheetId, activeCell, pattern, newSelections.map(function (sel) { return sel.range; }));
         /**
          * User has made selections. lets preserve it
          */
@@ -73,8 +126,14 @@ export var usePaintFormat = function (_a) {
             onChangeSelections === null || onChangeSelections === void 0 ? void 0 : onChangeSelections(sheetId, newSelections);
         }
         // Reset paintformats
-        setPaintFormats([]);
-    }, [paintFormats, onChangeSelections, onChangeFormatting]);
+        setPattern(EMPTY_PATTERN);
+    }, [
+        pattern,
+        paintFormats,
+        onChangeSelections,
+        onChangeFormatting,
+        applyPatternMerges,
+    ]);
     /**
      * Copy formatting from a source range to target range
      */
@@ -87,24 +146,22 @@ export var usePaintFormat = function (_a) {
      * Sheet range to paste to
      */
     targetSheetRange) {
-        var paintFormats = [];
-        for (var rowIndex = sourceSheetRange.startRowIndex; rowIndex <= sourceSheetRange.endRowIndex; rowIndex++) {
-            var rowFormats = [];
-            for (var columnIndex = sourceSheetRange.startColumnIndex; columnIndex <= sourceSheetRange.endColumnIndex; columnIndex++) {
-                rowFormats.push(getEffectiveFormat(sourceSheetRange.sheetId, rowIndex, columnIndex));
-            }
-            paintFormats.push(rowFormats);
-        }
+        var captured = capturePattern(sourceSheetRange.sheetId, [
+            sourceSheetRange,
+        ]);
         // Apply
         var activeCell = {
             rowIndex: targetSheetRange.startRowIndex,
             columnIndex: targetSheetRange.startColumnIndex,
         };
         // Copy formatting
-        onChangeFormatting(targetSheetRange.sheetId, activeCell, [{ range: targetSheetRange }], paintFormats, {
+        onChangeFormatting(targetSheetRange.sheetId, activeCell, [{ range: targetSheetRange }], captured.formats, {
             replace: true,
         });
-    }, [onChangeFormatting, getEffectiveFormat]);
+        applyPatternMerges(targetSheetRange.sheetId, activeCell, captured, [
+            targetSheetRange,
+        ]);
+    }, [onChangeFormatting, capturePattern, applyPatternMerges]);
     return {
         isPaintFormatActive: paintFormats.length > 0,
         onSavePaintFormat: onSavePaintFormat,