@rowsncolumns/spreadsheet-state 28.0.72 → 28.0.74

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

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

package/dist/esm/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/esm/hooks/use-on-show-column.js

@@ -21,6 +21,8 @@ export const useOnShowColumn = ({ createHistory, onChangeActiveCell, onChangeSel
             });
             return;
         }
+        if (columnIndexes.length === 0)
+            return;
         const saveHistory = createHistory();
         const firstColumnIndex = columnIndexes[0];
         const newActiveCell = getNextFocusableCell?.(sheetId, { rowIndex: 0, columnIndex: firstColumnIndex }, Direction.Down, false) ?? { rowIndex: 1, columnIndex: firstColumnIndex };

package/dist/esm/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/esm/hooks/use-on-show-row.js

@@ -21,6 +21,8 @@ export const useOnShowRow = ({ createHistory, onChangeActiveCell, onChangeSelect
             });
             return;
         }
+        if (rowIndexes.length === 0)
+            return;
         const saveHistory = createHistory();
         const firstRowIndex = rowIndexes[0];
         const newActiveCell = getNextFocusableCell?.(sheetId, { rowIndex: firstRowIndex, columnIndex: 0 }, Direction.Right, false) ?? { rowIndex: firstRowIndex, columnIndex: 1 };

package/dist/esm/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/esm/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/esm/hooks/use-on-subtotal.js

@@ -0,0 +1,48 @@
+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 const useOnSubtotal = ({ getEffectiveValue, getFormattedValue, getFormulaValue, getRowOutlineLevel, onDeleteRow, onInsertRow, onChangeBatch, onGroupRows, onUngroupRows, }) => {
+    const canEditCellRange = useCanEditCellRange();
+    return useCallback((sheetId, options) => {
+        if (!canEditCellRange(sheetId, options.range)) {
+            console.debug("This range is protected, users cannot edit this cell range.");
+            return undefined;
+        }
+        const plan = planSubtotals(options, {
+            getValue: (rowIndex, columnIndex) => getFormattedValue(sheetId, rowIndex, columnIndex) ??
+                getEffectiveValue(sheetId, rowIndex, columnIndex),
+            getFormula: (rowIndex, columnIndex) => getFormulaValue(sheetId, rowIndex, columnIndex),
+            getOutlineLevel: (rowIndex) => getRowOutlineLevel(sheetId, rowIndex),
+        });
+        if (!plan)
+            return undefined;
+        applySubtotalPlan(sheetId, plan, {
+            onDeleteRow,
+            onInsertRow,
+            onChangeBatch,
+            onGroupRows,
+            onUngroupRows,
+        });
+        return plan;
+    }, [
+        canEditCellRange,
+        getEffectiveValue,
+        getFormattedValue,
+        getFormulaValue,
+        getRowOutlineLevel,
+        onDeleteRow,
+        onInsertRow,
+        onChangeBatch,
+        onGroupRows,
+        onUngroupRows,
+    ]);
+};

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

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

@@ -1,26 +1,64 @@
 import { selectionFromActiveCell } from "@rowsncolumns/grid";
 import { useCallback, useState } from "react";
+import { collectPaintMerges, getBandedCellFormat, layerBandedFormat, 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.
 const UNBOUNDED_PAINT_SPAN = 10_000;
-export const usePaintFormat = ({ getEffectiveFormat, onChangeFormatting, onChangeSelections, }) => {
-    const [paintFormats, setPaintFormats] = useState([]);
-    const onSavePaintFormat = useCallback((sheetId, activeCell, selections) => {
-        const finalSelections = selections.length
-            ? selections
-            : selectionFromActiveCell(activeCell);
-        const paintFormats = [];
-        for (const sel of finalSelections) {
-            for (let rowIndex = sel.range.startRowIndex; rowIndex <= sel.range.endRowIndex; rowIndex++) {
+const EMPTY_PATTERN = {
+    formats: [],
+    merges: [],
+    rows: 0,
+    cols: 0,
+};
+export const usePaintFormat = ({ getEffectiveFormat, onChangeFormatting, onChangeSelections, getMerges, onPaintMerges, getBandedCells, }) => {
+    const [pattern, setPattern] = useState(EMPTY_PATTERN);
+    const 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.
+     */
+    const capturePattern = useCallback((sheetId, ranges) => {
+        const bandedCells = getBandedCells?.(sheetId);
+        const formats = [];
+        for (const range of ranges) {
+            for (let rowIndex = range.startRowIndex; rowIndex <= range.endRowIndex; rowIndex++) {
                 const rowFormats = [];
-                for (let columnIndex = sel.range.startColumnIndex; columnIndex <= sel.range.endColumnIndex; columnIndex++) {
-                    rowFormats.push(getEffectiveFormat(sheetId, rowIndex, columnIndex));
+                for (let columnIndex = range.startColumnIndex; columnIndex <= range.endColumnIndex; columnIndex++) {
+                    rowFormats.push(layerBandedFormat(getEffectiveFormat(sheetId, rowIndex, columnIndex), getBandedCellFormat(bandedCells, rowIndex, columnIndex)));
                 }
-                paintFormats.push(rowFormats);
+                formats.push(rowFormats);
             }
         }
-        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).
+        const source = ranges.length === 1 ? ranges[0] : undefined;
+        const merges = source
+            ? collectPaintMerges(getMerges?.(sheetId), source)
+            : [];
+        return {
+            formats,
+            merges,
+            rows: formats.length,
+            cols: formats[0]?.length ?? 0,
+        };
+    }, [getEffectiveFormat, getBandedCells, getMerges]);
+    /**
+     * Replace the target's merges with the pattern's, tiled with the pattern's period.
+     */
+    const applyPatternMerges = useCallback((sheetId, activeCell, current, targets) => {
+        if (!current.merges.length || !onPaintMerges)
+            return;
+        for (const target of targets) {
+            const tiled = tilePaintMerges(current.merges, current.rows, current.cols, target);
+            onPaintMerges(sheetId, activeCell, target, tiled);
+        }
+    }, [onPaintMerges]);
+    const onSavePaintFormat = useCallback((sheetId, activeCell, selections) => {
+        const finalSelections = selections.length
+            ? selections
+            : selectionFromActiveCell(activeCell);
+        setPattern(capturePattern(sheetId, finalSelections.map((sel) => sel.range)));
+    }, [capturePattern]);
     // Applies a saved paintFormat
     const onApplyPaintFormat = useCallback((sheetId, activeCell, selections) => {
         /**
@@ -32,9 +70,7 @@ export const usePaintFormat = ({ getEffectiveFormat, onChangeFormatting, onChang
         // `changeFormatting` repeats the grid via its rolling indices). Only
         // header-click full-column/row targets are bounded to the pattern so a paint
         // never enumerates an entire 1M-row column.
-        const clampEnd = (start, end, span) => end - start >= UNBOUNDED_PAINT_SPAN
-            ? Math.min(end, start + span)
-            : end;
+        const clampEnd = (start, end, span) => end - start >= UNBOUNDED_PAINT_SPAN ? Math.min(end, start + span) : end;
         const newSelections = selections?.length
             ? selections.map((sel) => ({
                 ...sel,
@@ -58,6 +94,8 @@ export const usePaintFormat = ({ getEffectiveFormat, onChangeFormatting, onChang
         onChangeFormatting(sheetId, activeCell, newSelections, paintFormats, {
             replace: true,
         });
+        // Merges tile with the same period as the formats.
+        applyPatternMerges(sheetId, activeCell, pattern, newSelections.map((sel) => sel.range));
         /**
          * User has made selections. lets preserve it
          */
@@ -65,8 +103,14 @@ export const usePaintFormat = ({ getEffectiveFormat, onChangeFormatting, onChang
             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
      */
@@ -79,24 +123,22 @@ export const usePaintFormat = ({ getEffectiveFormat, onChangeFormatting, onChang
      * Sheet range to paste to
      */
     targetSheetRange) => {
-        const paintFormats = [];
-        for (let rowIndex = sourceSheetRange.startRowIndex; rowIndex <= sourceSheetRange.endRowIndex; rowIndex++) {
-            const rowFormats = [];
-            for (let columnIndex = sourceSheetRange.startColumnIndex; columnIndex <= sourceSheetRange.endColumnIndex; columnIndex++) {
-                rowFormats.push(getEffectiveFormat(sourceSheetRange.sheetId, rowIndex, columnIndex));
-            }
-            paintFormats.push(rowFormats);
-        }
+        const captured = capturePattern(sourceSheetRange.sheetId, [
+            sourceSheetRange,
+        ]);
         // Apply
         const 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,

package/dist/esm/hooks/use-sheet-properties.d.ts

@@ -49,6 +49,7 @@ export type UseSheetPropertiesProps<T extends CellData, S extends Sheet> = {
     getPrecedents?: (cell: FormulaPosition) => FormulaPrecedents;
 };
 export declare const useSheetProperties: <T extends CellData = CellData, S extends Sheet = Sheet>({ conditionalFormats, sheetData, sheets, activeSheetId, dataValidations, protectFormulas, getEffectiveStructuredValue, cellXfs, cellXfsRegistry, cellStyles, sharedStrings, locale, use1904, lenientGrouping, getPrecedents, }: UseSheetPropertiesProps<T, S>) => {
+    getFormulaValue: (sheetId: number, rowIndex: number, columnIndex: number) => string | undefined;
     getDataRowCount: (sheetId?: number) => number | undefined;
     getNonEmptyRowCount: (sheetId: number) => number | undefined;
     getNonEmptyColumnCount: (sheetId: number, rowIndex: number) => number | undefined;
@@ -56,6 +57,7 @@ export declare const useSheetProperties: <T extends CellData = CellData, S exten
     getSheetName: (sheetId: number) => string;
     getSheetCount: () => number;
     getSheetIndex: (sheetName?: string) => number | undefined;
+    getSheetNames: () => string[];
     getSheetProperties: (sheetId: number) => SheetProperty | undefined;
     getCellData: (sheetId: number, rowIndex: number, columnIndex: number) => T | null | undefined;
     getMentionsFromCell: (sheetId: number, rowIndex: number, columnIndex: number) => {
@@ -86,6 +88,7 @@ export declare const useSheetProperties: <T extends CellData = CellData, S exten
     getFormulasFromRange: (sheetRange: SheetRange, hiddenDimensionStategy?: HIDDEN_DIMENSION_STRATEGY) => (string | undefined)[];
     isHiddenRow: (sheetId: number, rowIndex: number) => boolean;
     isHiddenByFilterRow: (sheetId: number, rowIndex: number) => boolean;
+    getRowOutlineLevel: (sheetId: number, rowIndex: number) => number;
     getSheetRowCount: (sheetId: number) => number;
     getSheetColumnCount: (sheetId: number) => number;
     getColumnWidth: (sheetId: number, columnIndex: number) => number;

package/dist/esm/hooks/use-sheet-properties.d.ts.map

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

package/dist/esm/hooks/use-sheet-properties.js

@@ -226,6 +226,8 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
         const metaData = sheetMetaDataById.get(sheetId)?.rowMetadata?.[rowIndex];
         return Boolean(metaData?.hiddenByUser || metaData?.hiddenByFilter);
     }, [sheetMetaDataById]);
+    // Outline (row grouping) level, 0 when the row is not grouped
+    const getRowOutlineLevel = useCallback((sheetId, rowIndex) => sheetMetaDataById.get(sheetId)?.rowMetadata?.[rowIndex]?.outlineLevel ?? 0, [sheetMetaDataById]);
     // Hidden by filter row
     const isHiddenByFilterRow = useCallback((sheetId, rowIndex) => {
         const metaData = sheetMetaDataById.get(sheetId)?.rowMetadata?.[rowIndex];
@@ -253,6 +255,9 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
         });
         return map;
     }, [sheets]);
+    // Sheet names in tab order — resolves 3-D references (`Sheet1:Sheet3!A1`)
+    const orderedSheetNames = useMemo(() => sortSheetsByIndex(sheets, true).map((sheet) => sheet.title), [sheets]);
+    const getSheetNames = useCallbackRef(useCallback(() => orderedSheetNames, [orderedSheetNames]));
     // For calculator
     const getSheetIndex = useCallbackRef(useCallback((sheetName) => {
         const resolvedName = sheetName ?? sheetnameBySheetId.get(activeSheetId);
@@ -864,6 +869,7 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
         return columnarData;
     }, [getEffectiveValue, getFormattedValue]));
     return {
+        getFormulaValue,
         getDataRowCount,
         getNonEmptyRowCount,
         getNonEmptyColumnCount,
@@ -871,6 +877,7 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
         getSheetName,
         getSheetCount,
         getSheetIndex,
+        getSheetNames,
         getSheetProperties,
         getCellData,
         getMentionsFromCell,
@@ -894,6 +901,7 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
         getFormulasFromRange,
         isHiddenRow,
         isHiddenByFilterRow,
+        getRowOutlineLevel,
         getSheetRowCount,
         getSheetColumnCount,
         getColumnWidth,

package/dist/esm/hooks/use-split-text-to-columns.d.ts

@@ -1,5 +1,6 @@
 import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
 import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import type { SplitTextOptions } from "../api/split-text";
 import type { useCalculation } from "./use-calculation";
 import type { useSheetProperties } from "./use-sheet-properties";
 import type { useSheetState } from "./use-sheet-state";
@@ -15,5 +16,5 @@ export type UseSplitTextToColumnsProps<T extends CellData, S extends Sheet> = {
     onChangeSelections: ReturnType<typeof useSheetState>["onChangeSelections"];
     onCommand?: OnCommand;
 };
-export declare const useSplitTextToColumns: <T extends CellData, S extends Sheet>({ locale, getFormattedValue, onChangeSheetData, enqueueCalculation, createHistory, onChangeSelections, onCommand, }: UseSplitTextToColumnsProps<T, S>) => (sheetId: number, activeCell: CellInterface, selections?: SelectionArea<SelectionAttributes>[], delimiter?: string) => void;
+export declare const useSplitTextToColumns: <T extends CellData, S extends Sheet>({ locale, getFormattedValue, onChangeSheetData, enqueueCalculation, createHistory, onChangeSelections, onCommand, }: UseSplitTextToColumnsProps<T, S>) => (sheetId: number, activeCell: CellInterface, selections?: SelectionArea<SelectionAttributes>[], delimiter?: string, options?: SplitTextOptions) => void;
 //# sourceMappingURL=use-split-text-to-columns.d.ts.map

package/dist/esm/hooks/use-split-text-to-columns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-split-text-to-columns.d.ts","sourceRoot":"","sources":["../../../hooks/use-split-text-to-columns.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;AAInC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,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,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,0BAA0B,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,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,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,kBAAkB,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC3E,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,qHAQxE,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,eAGpB,MAAM,cACH,aAAa,eACZ,aAAa,CAAC,mBAAmB,CAAC,EAAE,6BA+BtD,CAAC"}
+{"version":3,"file":"use-split-text-to-columns.d.ts","sourceRoot":"","sources":["../../../hooks/use-split-text-to-columns.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,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,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,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,0BAA0B,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,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,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,kBAAkB,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC3E,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,qHAQxE,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,eAGpB,MAAM,cACH,aAAa,eACZ,aAAa,CAAC,mBAAmB,CAAC,EAAE,gCAEvC,gBAAgB,SA+B/B,CAAC"}

package/dist/esm/hooks/use-split-text-to-columns.js

@@ -1,7 +1,7 @@
 import { useCallback } from "react";
 import { splitText } from "../interface/split-text";
 export const useSplitTextToColumns = ({ locale, getFormattedValue, onChangeSheetData, enqueueCalculation, createHistory, onChangeSelections, onCommand, }) => {
-    return useCallback((sheetId, activeCell, selections, delimiter = ",") => {
+    return useCallback((sheetId, activeCell, selections, delimiter = ",", options) => {
         splitText({
             locale,
             getFormattedValue,
@@ -9,7 +9,7 @@ export const useSplitTextToColumns = ({ locale, getFormattedValue, onChangeSheet
             onChangeSheetData,
             createHistory,
             onChangeSelections,
-        })(sheetId, activeCell, selections, delimiter);
+        })(sheetId, activeCell, selections, delimiter, options);
         // Stream the semantic command so an engine consumer re-splits + recomputes.
         onCommand?.({
             command: "split-text-to-columns",
@@ -17,6 +17,7 @@ export const useSplitTextToColumns = ({ locale, getFormattedValue, onChangeSheet
             activeCell,
             selections: selections ?? [],
             delimiter,
+            columnBreaks: options?.columnBreaks,
         });
     }, [
         locale,