@rowsncolumns/spreadsheet-state 28.0.76 → 29.1.0

package/dist/esm/hooks/use-on-update-named-range.js

@@ -1,13 +1,23 @@
 import { isStaticNode } from "@rowsncolumns/dag";
+import { validateDefinedNameAgainstTables } from "@rowsncolumns/utils";
 import { produceWithPatches } from "immer";
 import { useCallback } from "react";
 import { createSheetCellIdentifier } from "../api/formula";
 import { createSheetDraft } from "../api/immer-utils";
+import { useShowError } from "../atoms/error-state.atom";
 import { SheetCell } from "../sheet-cell";
 import { useCanEditSheet } from "./use-can-edit-cellrange";
-export const useOnUpdateNamedRange = ({ locale, getDependents, enqueueCalculation, createHistory, onChangeNamedRanges, onChangeSheetData, onCommand, }) => {
+export const useOnUpdateNamedRange = ({ locale, tables, getDependents, enqueueCalculation, createHistory, onChangeNamedRanges, onChangeSheetData, onCommand, }) => {
     const canEditSheet = useCanEditSheet();
+    const showError = useShowError();
     return useCallback((sheetId, namedRange, previousNamedRange) => {
+        const nameError = namedRange.name !== previousNamedRange.name
+            ? validateDefinedNameAgainstTables(namedRange.name, tables?.map((table) => table.title))
+            : undefined;
+        if (nameError) {
+            showError({ title: "Error", message: nameError });
+            return;
+        }
         // Protection — block named-range edits when the sheet is
         // protected. Sheet-scoped names are clearly owned by `sheetId`;
         // workbook-scoped names are typically authored from a sheet
@@ -97,6 +107,7 @@ export const useOnUpdateNamedRange = ({ locale, getDependents, enqueueCalculatio
         });
     }, [
         locale,
+        tables,
         onChangeNamedRanges,
         onChangeSheetData,
         enqueueCalculation,
@@ -104,5 +115,6 @@ export const useOnUpdateNamedRange = ({ locale, getDependents, enqueueCalculatio
         getDependents,
         onCommand,
         canEditSheet,
+        showError,
     ]);
 };

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

@@ -88,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;
+    isManuallyHiddenRow: (sheetId: number, rowIndex: number) => boolean;
     getRowOutlineLevel: (sheetId: number, rowIndex: number) => number;
     getSheetRowCount: (sheetId: number) => number;
     getSheetColumnCount: (sheetId: 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

@@ -64,6 +64,15 @@ const shallowArrayRefEqual = (a, b) => {
     }
     return true;
 };
+/** Which axes a range reader omits for a `HIDDEN_DIMENSION_STRATEGY` — rows only, columns only,
+ * both, or neither (`SHOW_ALL`, and `null`/`undefined`, which the chart callers use to mean
+ * "show all"). Same table as `hiddenStrategyAxes` in `@rowsncolumns/rnc-engine`. */
+const hiddenStrategyAxes = (strategy) => ({
+    skipRows: strategy === "SKIP_HIDDEN_ROWS_AND_COLUMNS" ||
+        strategy === "SKIP_HIDDEN_ROWS",
+    skipCols: strategy === "SKIP_HIDDEN_ROWS_AND_COLUMNS" ||
+        strategy === "SKIP_HIDDEN_COLUMNS",
+});
 export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, activeSheetId, dataValidations, protectFormulas, getEffectiveStructuredValue, cellXfs, cellXfsRegistry, cellStyles, sharedStrings, locale, use1904, lenientGrouping, getPrecedents, }) => {
     /* Callback refs */
     const getEffectiveStructuredValueRef = useCallbackRef(getEffectiveStructuredValue);
@@ -221,10 +230,12 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
     const getActualRowCount = useCallback((sheetId) => sheetData?.[sheetId]?.length ?? 0, [sheetData]);
     // Get frozen row count
     const getFrozenRowCount = useCallback((sheetId) => sheetPropertiesById.get(sheetId)?.frozenRowCount ?? 0, [sheetPropertiesById]);
-    // Hidden row
+    // Hidden row (by the user, a filter, or a collapsed outline group)
     const isHiddenRow = useCallback((sheetId, rowIndex) => {
         const metaData = sheetMetaDataById.get(sheetId)?.rowMetadata?.[rowIndex];
-        return Boolean(metaData?.hiddenByUser || metaData?.hiddenByFilter);
+        return Boolean(metaData?.hiddenByUser ||
+            metaData?.hiddenByFilter ||
+            metaData?.hiddenByGroup);
     }, [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]);
@@ -233,10 +244,17 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
         const metaData = sheetMetaDataById.get(sheetId)?.rowMetadata?.[rowIndex];
         return Boolean(metaData?.hiddenByFilter);
     }, [sheetMetaDataById]);
-    // Hidden column
+    // Hidden by the user or a collapsed outline group — not by a filter
+    const isManuallyHiddenRow = useCallback((sheetId, rowIndex) => {
+        const metaData = sheetMetaDataById.get(sheetId)?.rowMetadata?.[rowIndex];
+        return Boolean(metaData?.hiddenByUser || metaData?.hiddenByGroup);
+    }, [sheetMetaDataById]);
+    // Hidden column (by the user, a filter, or a collapsed outline group)
     const isColumnHidden = useCallback((sheetId, columnIndex) => {
         const metaData = sheetMetaDataById.get(sheetId)?.columnMetadata?.[columnIndex];
-        return Boolean(metaData?.hiddenByUser || metaData?.hiddenByFilter);
+        return Boolean(metaData?.hiddenByUser ||
+            metaData?.hiddenByFilter ||
+            metaData?.hiddenByGroup);
     }, [sheetMetaDataById]);
     // Get sheet count. Used for formuls
     const getSheetCount = useCallbackRef(useCallback(() => sheets.length, [sheets]));
@@ -767,10 +785,10 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
         const effectiveValues = [];
         const { sheetId } = sheetRange;
         const { startRowIndex, startColumnIndex, endRowIndex, endColumnIndex } = sheetRange;
+        const { skipRows, skipCols } = hiddenStrategyAxes(hiddenDimensionStategy);
         for (const [rowIndex, columnIndex] of iterateCells(startRowIndex, endColumnIndex, endRowIndex, startColumnIndex)) {
-            if (hiddenDimensionStategy === "SKIP_HIDDEN_ROWS_AND_COLUMNS" &&
-                (isHiddenRow(sheetId, rowIndex) ||
-                    isColumnHidden(sheetId, columnIndex))) {
+            if ((skipRows && isHiddenRow(sheetId, rowIndex)) ||
+                (skipCols && isColumnHidden(sheetId, columnIndex))) {
                 continue;
             }
             const effectiveValue = getEffectiveValue(sheetId, rowIndex, columnIndex);
@@ -785,10 +803,10 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
         const formattedValues = [];
         const { sheetId } = sheetRange;
         const { startRowIndex, startColumnIndex, endRowIndex, endColumnIndex } = sheetRange;
+        const { skipRows, skipCols } = hiddenStrategyAxes(hiddenDimensionStategy);
         for (const [rowIndex, columnIndex] of iterateCells(startRowIndex, endColumnIndex, endRowIndex, startColumnIndex)) {
-            if (hiddenDimensionStategy === "SKIP_HIDDEN_ROWS_AND_COLUMNS" &&
-                (isHiddenRow(sheetId, rowIndex) ||
-                    isColumnHidden(sheetId, columnIndex))) {
+            if ((skipRows && isHiddenRow(sheetId, rowIndex)) ||
+                (skipCols && isColumnHidden(sheetId, columnIndex))) {
                 continue;
             }
             const formattedValue = getFormattedValue(sheetId, rowIndex, columnIndex);
@@ -801,10 +819,10 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
         const formattingValues = [];
         const { sheetId } = sheetRange;
         const { startRowIndex, startColumnIndex, endRowIndex, endColumnIndex } = sheetRange;
+        const { skipRows, skipCols } = hiddenStrategyAxes(hiddenDimensionStategy);
         for (const [rowIndex, columnIndex] of iterateCells(startRowIndex, endColumnIndex, endRowIndex, startColumnIndex)) {
-            if (hiddenDimensionStategy === "SKIP_HIDDEN_ROWS_AND_COLUMNS" &&
-                (isHiddenRow(sheetId, rowIndex) ||
-                    isColumnHidden(sheetId, columnIndex))) {
+            if ((skipRows && isHiddenRow(sheetId, rowIndex)) ||
+                (skipCols && isColumnHidden(sheetId, columnIndex))) {
                 continue;
             }
             // Return the rendered format consumers actually see (auto-derived
@@ -820,10 +838,10 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
         const userEnteredValues = [];
         const { sheetId } = sheetRange;
         const { startRowIndex, startColumnIndex, endRowIndex, endColumnIndex } = sheetRange;
+        const { skipRows, skipCols } = hiddenStrategyAxes(hiddenDimensionStategy);
         for (const [rowIndex, columnIndex] of iterateCells(startRowIndex, endColumnIndex, endRowIndex, startColumnIndex)) {
-            if (hiddenDimensionStategy === "SKIP_HIDDEN_ROWS_AND_COLUMNS" &&
-                (isHiddenRow(sheetId, rowIndex) ||
-                    isColumnHidden(sheetId, columnIndex))) {
+            if ((skipRows && isHiddenRow(sheetId, rowIndex)) ||
+                (skipCols && isColumnHidden(sheetId, columnIndex))) {
                 continue;
             }
             const userEnteredValue = getUserEnteredStringValue(sheetId, rowIndex, columnIndex);
@@ -836,10 +854,10 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
         const formulas = [];
         const { sheetId } = sheetRange;
         const { startRowIndex, startColumnIndex, endRowIndex, endColumnIndex } = sheetRange;
+        const { skipRows, skipCols } = hiddenStrategyAxes(hiddenDimensionStategy);
         for (const [rowIndex, columnIndex] of iterateCells(startRowIndex, endColumnIndex, endRowIndex, startColumnIndex)) {
-            if (hiddenDimensionStategy === "SKIP_HIDDEN_ROWS_AND_COLUMNS" &&
-                (isHiddenRow(sheetId, rowIndex) ||
-                    isColumnHidden(sheetId, columnIndex))) {
+            if ((skipRows && isHiddenRow(sheetId, rowIndex)) ||
+                (skipCols && isColumnHidden(sheetId, columnIndex))) {
                 continue;
             }
             const formula = getFormulaValue(sheetId, rowIndex, columnIndex);
@@ -901,6 +919,7 @@ export const useSheetProperties = ({ conditionalFormats, sheetData, sheets, acti
         getFormulasFromRange,
         isHiddenRow,
         isHiddenByFilterRow,
+        isManuallyHiddenRow,
         getRowOutlineLevel,
         getSheetRowCount,
         getSheetColumnCount,

package/dist/esm/hooks/use-slicers.d.ts

@@ -10,8 +10,8 @@ export type UseOnSlicersProps<T extends CellData> = {
 };
 export declare const useSlicers: <T extends CellData>({ onChangeSlicers, createHistory, onCommand, }: UseOnSlicersProps<T>) => {
     onDeleteSlicer: (slicerId: string | number) => void;
-    onMoveSlicer: (slicerId: string | number, sheetId: number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number) => void;
-    onResizeSlicer: (slicerId: string | number, sheetId: number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number, width: number, height: number) => void;
+    onMoveSlicer: (slicerId: string | number, sheetId: number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number, toAnchor?: import("@rowsncolumns/spreadsheet").OverlayToAnchor) => void;
+    onResizeSlicer: (slicerId: string | number, sheetId: number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number, width: number, height: number, toAnchor?: import("@rowsncolumns/spreadsheet").OverlayToAnchor) => void;
     onCreateSlicer: (spec: Slicer) => void;
     onUpdateSlicer: (slicer: Slicer) => void;
     onRequestEditSlicer: (slicer: Slicer) => void;

package/dist/esm/hooks/use-slicers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-slicers.d.ts","sourceRoot":"","sources":["../../../hooks/use-slicers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,QAAQ,IAAI;IAClD,eAAe,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC3D,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,QAAQ,EAAE,gDAI5C,iBAAiB,CAAC,CAAC,CAAC;;;;2BAyGZ,MAAM;6BAjFJ,MAAM;kCA6FgC,MAAM;CAaxD,CAAC"}
+{"version":3,"file":"use-slicers.d.ts","sourceRoot":"","sources":["../../../hooks/use-slicers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,2BAA2B,CAAC;AAKnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,QAAQ,IAAI;IAClD,eAAe,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC3D,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,QAAQ,EAAE,gDAI5C,iBAAiB,CAAC,CAAC,CAAC;;;;2BA+GZ,MAAM;6BArFJ,MAAM;kCAoGN,MAAM;CAelB,CAAC"}

package/dist/esm/hooks/use-slicers.js

@@ -1,8 +1,12 @@
 import { useFocusSheet, } from "@rowsncolumns/spreadsheet";
 import { useCallback } from "react";
+import { useSetEditSlicerDialogState } from "../atoms/dialog-state.atom";
+import { useSetEditingSlicer } from "../atoms/editing-slicer.atom";
 import { createSlicer, deleteSlicer, moveSlicer, resizeSlicer, updateSlicer, } from "../interface/slicers";
 export const useSlicers = ({ onChangeSlicers, createHistory, onCommand, }) => {
     const focusSheet = useFocusSheet();
+    const setEditSlicerDialogState = useSetEditSlicerDialogState();
+    const setEditingSlicer = useSetEditingSlicer();
     // Delete
     const onDeleteSlicer = useCallback((slicerId) => {
         if (onChangeSlicers) {
@@ -25,12 +29,12 @@ export const useSlicers = ({ onChangeSlicers, createHistory, onCommand, }) => {
         focusSheet?.();
         onCommand?.({ command: "update-slicer", slicer });
     }, [onChangeSlicers, createHistory, focusSheet, onCommand]);
-    const onMoveSlicer = useCallback((slicerId, sheetId, anchorCell, offsetXPixels, offsetYPixels) => {
+    const onMoveSlicer = useCallback((slicerId, sheetId, anchorCell, offsetXPixels, offsetYPixels, toAnchor) => {
         if (onChangeSlicers) {
             moveSlicer({
                 onChangeSlicers,
                 createHistory,
-            })(slicerId, sheetId, anchorCell, offsetXPixels, offsetYPixels);
+            })(slicerId, sheetId, anchorCell, offsetXPixels, offsetYPixels, toAnchor);
         }
         onCommand?.({
             command: "move-slicer",
@@ -39,14 +43,15 @@ export const useSlicers = ({ onChangeSlicers, createHistory, onCommand, }) => {
             anchorCell,
             offsetXPixels,
             offsetYPixels,
+            ...toAnchor,
         });
     }, [onChangeSlicers, createHistory, onCommand]);
-    const onResizeSlicer = useCallback((slicerId, sheetId, anchorCell, offsetXPixels, offsetYPixels, width, height) => {
+    const onResizeSlicer = useCallback((slicerId, sheetId, anchorCell, offsetXPixels, offsetYPixels, width, height, toAnchor) => {
         if (onChangeSlicers) {
             resizeSlicer({
                 onChangeSlicers,
                 createHistory,
-            })(slicerId, sheetId, anchorCell, offsetXPixels, offsetYPixels, width, height);
+            })(slicerId, sheetId, anchorCell, offsetXPixels, offsetYPixels, width, height, toAnchor);
         }
         onCommand?.({
             command: "resize-slicer",
@@ -57,6 +62,7 @@ export const useSlicers = ({ onChangeSlicers, createHistory, onCommand, }) => {
             offsetYPixels,
             width,
             height,
+            ...toAnchor,
         });
     }, [onChangeSlicers, createHistory, onCommand]);
     // Create slicer
@@ -67,11 +73,13 @@ export const useSlicers = ({ onChangeSlicers, createHistory, onCommand, }) => {
         })(spec);
         onCommand?.({ command: "create-slicer", slicer: spec });
     }, [onChangeSlicers, createHistory, onCommand]);
-    // Request edit slicer
+    // Request edit slicer: opens the Slicer Settings dialog (`SlicerEditorDialog`) for `slicer`,
+    // the way the rnc chrome's `openDialog("editSlicer", slicer)` does. The dialog saves through
+    // `onUpdateSlicer`.
     const onRequestEditSlicer = useCallback((slicer) => {
-        // TODO: Add edit dialog support if needed
-        console.log("Edit slicer:", slicer);
-    }, []);
+        setEditingSlicer(slicer);
+        setEditSlicerDialogState(true);
+    }, [setEditingSlicer, setEditSlicerDialogState]);
     return {
         onDeleteSlicer,
         onMoveSlicer,

package/dist/esm/hooks/use-sparkline-groups.d.ts

@@ -0,0 +1,50 @@
+import type { CellInterface, GridRange, SelectionArea } from "@rowsncolumns/common-types";
+import type { SelectionAttributes } from "@rowsncolumns/spreadsheet";
+import { type SparklineGroup, type SparklineGroupOptions, type SparklineGroupPlan, type SparklineGroupType } from "@rowsncolumns/utils";
+/** Excel's Create Sparklines dialog result. */
+export type SparklineGroupSpec = {
+    sheetId: number;
+    type: SparklineGroupType;
+    /** Data Range — may be sheet-qualified. */
+    dataRange: string;
+    /** Location Range — a single row or column on `sheetId`. */
+    locationRange: string;
+    options?: SparklineGroupOptions;
+};
+/** A Sparkline Design change: any subset of the group's type, options, data or location. */
+export type SparklineGroupPatch = {
+    type?: SparklineGroupType;
+    options?: SparklineGroupOptions;
+    dataRange?: string;
+    locationRange?: string;
+};
+export type UseSparklineGroupsProps = {
+    /** The engine's batch cell write (`change-batch`). */
+    onChangeBatch: (sheetId: number, ranges: GridRange | GridRange[], values: (string | null | undefined)[][]) => void;
+    /** The engine's clear-contents (`delete-cells`). */
+    onDelete: (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+    /** Groups the writes of one action into one undo step. */
+    batchHistory: <R>(action: () => R) => R;
+    /** The cell's user-entered value — the legacy `ue` object or the Rust engine's string. */
+    getUserEnteredValue: (sheetId: number, rowIndex: number, columnIndex: number) => string | {
+        fv?: string | null;
+    } | null | undefined;
+};
+/**
+ * Excel sparkline groups for either engine, expressed through the engine's own cell writes: a group
+ * is a run of `=SPARKLINE(dataRange, {options})` cells sharing one option set — the shape both XLSX
+ * importers produce and both exporters fold back into `<x14:sparklineGroup>`. Every action lands as
+ * ONE undo step (`batchHistory`), and because the members are ordinary formula cells they recalc
+ * live and their ranges shift with inserted/deleted rows and columns like any reference.
+ */
+export declare const useSparklineGroups: ({ onChangeBatch, onDelete, batchHistory, getUserEnteredValue, }: UseSparklineGroupsProps) => {
+    getSparklineGroup: (sheetId: number, cell: CellInterface) => SparklineGroup | undefined;
+    getSparklineAt: (sheetId: number, cell: CellInterface) => import("@rowsncolumns/utils").ParsedSparklineFormula | null;
+    onCreateSparklineGroup: (spec: SparklineGroupSpec) => SparklineGroupPlan;
+    onUpdateSparklineGroup: (group: SparklineGroup, patch: SparklineGroupPatch) => SparklineGroupPlan;
+    onDeleteSparklineGroup: (group: SparklineGroup) => void;
+    onClearSparklines: (sheetId: number, cells: CellInterface[]) => void;
+    onGroupSparklines: (sheetId: number, activeCell: CellInterface, cells: CellInterface[]) => void;
+};
+export type SparklineGroupHandlers = ReturnType<typeof useSparklineGroups>;
+//# sourceMappingURL=use-sparkline-groups.d.ts.map

package/dist/esm/hooks/use-sparkline-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sparkline-groups.d.ts","sourceRoot":"","sources":["../../../hooks/use-sparkline-groups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAQL,KAAK,cAAc,EAEnB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EAGxB,MAAM,qBAAqB,CAAC;AAG7B,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,kBAAkB,CAAC;IACzB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC,CAAC;AAEF,4FAA4F;AAC5F,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,sDAAsD;IACtD,aAAa,EAAE,CACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,EAC/B,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,KACpC,IAAI,CAAC;IACV,oDAAoD;IACpD,QAAQ,EAAE,CACR,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,EACzB,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,KAC7C,IAAI,CAAC;IACV,0DAA0D;IAC1D,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,0FAA0F;IAC1F,mBAAmB,EAAE,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC;CACzD,CAAC;AAQF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,iEAKhC,uBAAuB;iCAYZ,MAAM,QAAQ,aAAa,KAAG,cAAc,GAAG,SAAS;8BA+IxD,MAAM,QAAQ,aAAa;mCAhG9B,kBAAkB,KAAG,kBAAkB;oCAmBtC,cAAc,SAAS,mBAAmB,KAAG,kBAAkB;oCA+B/D,cAAc;iCAUZ,MAAM,SAAS,aAAa,EAAE;iCAe9B,MAAM,cAAc,aAAa,SAAS,aAAa,EAAE;CAgDtE,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/esm/hooks/use-sparkline-groups.js

@@ -0,0 +1,146 @@
+import { buildSparklineFormula, convertCellToRange, isSparklineFormula, parseSparklineFormula, planSparklineGroup, rangeToA1, resolveSparklineGroup, sparklineGroupDataRange, sparklineGroupLocation, } from "@rowsncolumns/utils";
+import { useCallback, useMemo } from "react";
+const asSelections = (cells) => cells.map((cell) => ({ range: convertCellToRange(cell) }));
+const sameCell = (a, b) => a.rowIndex === b.rowIndex && a.columnIndex === b.columnIndex;
+/**
+ * Excel sparkline groups for either engine, expressed through the engine's own cell writes: a group
+ * is a run of `=SPARKLINE(dataRange, {options})` cells sharing one option set — the shape both XLSX
+ * importers produce and both exporters fold back into `<x14:sparklineGroup>`. Every action lands as
+ * ONE undo step (`batchHistory`), and because the members are ordinary formula cells they recalc
+ * live and their ranges shift with inserted/deleted rows and columns like any reference.
+ */
+export const useSparklineGroups = ({ onChangeBatch, onDelete, batchHistory, getUserEnteredValue, }) => {
+    const getFormula = useCallback((sheetId, rowIndex, columnIndex) => {
+        const ue = getUserEnteredValue(sheetId, rowIndex, columnIndex);
+        const value = typeof ue === "string" ? ue : ue?.fv;
+        return typeof value === "string" && value.startsWith("=") ? value : undefined;
+    }, [getUserEnteredValue]);
+    /** The group the cell belongs to, or `undefined` for a cell without a SPARKLINE formula. */
+    const getSparklineGroup = useCallback((sheetId, cell) => resolveSparklineGroup({ sheetId, cell, getFormula }), [getFormula]);
+    const writeMembers = useCallback((sheetId, members, type, options) => {
+        const formula = (member) => buildSparklineFormula(member.dataRange, { ...options, charttype: type });
+        // A single row/column of members writes as one block; anything else cell by cell.
+        const rows = new Set(members.map((m) => m.cell.rowIndex));
+        const cols = new Set(members.map((m) => m.cell.columnIndex));
+        const contiguous = members.length > 0 &&
+            ((rows.size === 1 && cols.size === members.length) ||
+                (cols.size === 1 && rows.size === members.length));
+        if (contiguous) {
+            const sorted = [...members].sort((a, b) => a.cell.rowIndex - b.cell.rowIndex || a.cell.columnIndex - b.cell.columnIndex);
+            const location = {
+                startRowIndex: sorted[0].cell.rowIndex,
+                endRowIndex: sorted[sorted.length - 1].cell.rowIndex,
+                startColumnIndex: sorted[0].cell.columnIndex,
+                endColumnIndex: sorted[sorted.length - 1].cell.columnIndex,
+            };
+            const values = rows.size === 1
+                ? [sorted.map((m) => formula(m))]
+                : sorted.map((m) => [formula(m)]);
+            onChangeBatch(sheetId, location, values);
+            return;
+        }
+        for (const member of members) {
+            onChangeBatch(sheetId, convertCellToRange(member.cell), [[formula(member)]]);
+        }
+    }, [onChangeBatch]);
+    /** Insert → Sparklines → Line / Column / Win-Loss (the Create Sparklines dialog's OK). */
+    const onCreateSparklineGroup = useCallback((spec) => {
+        const plan = planSparklineGroup({
+            dataRange: spec.dataRange,
+            locationRange: spec.locationRange,
+        });
+        const planned = plan.members;
+        if (plan.error || !planned)
+            return plan;
+        batchHistory(() => writeMembers(spec.sheetId, planned, spec.type, spec.options ?? {}));
+        return plan;
+    }, [batchHistory, writeMembers]);
+    /**
+     * Sparkline Design changes: type switch, point/colour/axis options, or Edit Group Location & Data.
+     * A location change clears the members that leave the group and writes the new ones — all in one
+     * undo step.
+     */
+    const onUpdateSparklineGroup = useCallback((group, patch) => {
+        const type = patch.type ?? group.type;
+        const options = patch.options ?? group.options;
+        let members = group.members;
+        if (patch.dataRange !== undefined || patch.locationRange !== undefined) {
+            const location = patch.locationRange ?? rangeToA1(sparklineGroupLocation(group));
+            const dataRange = patch.dataRange ?? sparklineGroupDataRange(group);
+            if (dataRange === undefined) {
+                return { error: "The data range is not valid." };
+            }
+            const plan = planSparklineGroup({ dataRange, locationRange: location });
+            if (plan.error || !plan.members)
+                return plan;
+            members = plan.members;
+        }
+        const next = members;
+        batchHistory(() => {
+            const removed = group.members
+                .filter((m) => !next.some((n) => sameCell(n.cell, m.cell)))
+                .map((m) => m.cell);
+            if (removed.length) {
+                onDelete(group.sheetId, removed[0], asSelections(removed));
+            }
+            writeMembers(group.sheetId, next, type, options);
+        });
+        return { members: next };
+    }, [batchHistory, onDelete, writeMembers]);
+    /** Sparkline Design → Clear → Clear Selected Sparkline Groups. */
+    const onDeleteSparklineGroup = useCallback((group) => {
+        const cells = group.members.map((m) => m.cell);
+        if (!cells.length)
+            return;
+        batchHistory(() => onDelete(group.sheetId, cells[0], asSelections(cells)));
+    }, [batchHistory, onDelete]);
+    /** Sparkline Design → Clear → Clear Selected Sparklines: only the SPARKLINE cells among `cells`. */
+    const onClearSparklines = useCallback((sheetId, cells) => {
+        const targets = cells.filter((cell) => isSparklineFormula(getFormula(sheetId, cell.rowIndex, cell.columnIndex)));
+        if (!targets.length)
+            return;
+        batchHistory(() => onDelete(sheetId, targets[0], asSelections(targets)));
+    }, [batchHistory, getFormula, onDelete]);
+    /**
+     * Sparkline Design → Group: every selected sparkline (and the rest of each one's group) adopts the
+     * active cell's group type and options, so they become one group.
+     */
+    const onGroupSparklines = useCallback((sheetId, activeCell, cells) => {
+        const target = getSparklineGroup(sheetId, activeCell);
+        if (!target)
+            return;
+        const members = new Map();
+        for (const cell of [activeCell, ...cells]) {
+            const group = getSparklineGroup(sheetId, cell);
+            for (const member of group?.members ?? []) {
+                members.set(`${member.cell.rowIndex}:${member.cell.columnIndex}`, member);
+            }
+        }
+        const changed = [...members.values()].filter((m) => !target.members.some((t) => sameCell(t.cell, m.cell)));
+        if (!changed.length)
+            return;
+        batchHistory(() => writeMembers(sheetId, changed, target.type, target.options));
+    }, [batchHistory, getSparklineGroup, writeMembers]);
+    /** The SPARKLINE formula of a cell, parsed (a per-cell read for menus and toolbars). */
+    const getSparklineAt = useCallback((sheetId, cell) => {
+        const formula = getFormula(sheetId, cell.rowIndex, cell.columnIndex);
+        return formula ? parseSparklineFormula(formula) : null;
+    }, [getFormula]);
+    return useMemo(() => ({
+        getSparklineGroup,
+        getSparklineAt,
+        onCreateSparklineGroup,
+        onUpdateSparklineGroup,
+        onDeleteSparklineGroup,
+        onClearSparklines,
+        onGroupSparklines,
+    }), [
+        getSparklineGroup,
+        getSparklineAt,
+        onCreateSparklineGroup,
+        onUpdateSparklineGroup,
+        onDeleteSparklineGroup,
+        onClearSparklines,
+        onGroupSparklines,
+    ]);
+};