@rowsncolumns/spreadsheet-state 28.0.66

package/dist/esm/hooks/use-on-insert-autosum.js

@@ -0,0 +1,91 @@
+import { clampIndex, Direction, findLastContentfulCell, findNextCellInDataRegion, scheduleIdlePriorityCallback, } from "@rowsncolumns/grid";
+import { useGetAddressFromSelection } from "@rowsncolumns/spreadsheet";
+import { useActiveEditor, useSpreadsheet } from "@rowsncolumns/spreadsheet";
+import { isNil } from "@rowsncolumns/utils";
+import { useCallback, useRef } from "react";
+import { createSelectionBetweenCell } from "../api/selection";
+export const useOnInsertAutoSum = ({ getEffectiveValue, getEffectiveFormat, isHiddenRow, }) => {
+    const { makeEditable } = useSpreadsheet();
+    const activeEditorRef = useRef(undefined);
+    const activeEditor = useActiveEditor();
+    const getSelectionToAddress = useGetAddressFromSelection();
+    // Keep ref in sync
+    activeEditorRef.current = activeEditor;
+    return useCallback((sheetId, activeCell, functionName = "SUM") => {
+        const isHidden = (rowIndex) => isHiddenRow?.(sheetId, rowIndex);
+        const getEffectiveValueWrapper = (...args) => {
+            const value = getEffectiveValue(...args);
+            // Ignore strings
+            if (typeof value !== "number") {
+                return undefined;
+            }
+            // Ignore dates
+            const format = getEffectiveFormat?.(...args);
+            if (format?.numberFormat?.type === "DATE" ||
+                format?.numberFormat?.type === "DATE_TIME") {
+                return undefined;
+            }
+            return value;
+        };
+        const getAutoSumRangeInDirection = (direction) => {
+            // Get starting cell
+            const startIndex = findNextCellInDataRegion(sheetId, activeCell, getEffectiveValueWrapper, isHidden, direction, 1);
+            const startCell = direction === Direction.Up
+                ? { rowIndex: startIndex, columnIndex: activeCell.columnIndex }
+                : { rowIndex: activeCell.rowIndex, columnIndex: startIndex };
+            // Validate startCell as has value
+            const startCellValue = getEffectiveValueWrapper(sheetId, startCell.rowIndex, startCell.columnIndex);
+            // Get starting cell
+            const lastContentfulCell = isNil(startCellValue)
+                ? undefined
+                : findLastContentfulCell(sheetId, startCell, getEffectiveValueWrapper, isHidden, direction, 1);
+            const previousCell = direction === Direction.Up
+                ? {
+                    ...activeCell,
+                    rowIndex: clampIndex(activeCell.rowIndex - 1, isHidden, direction),
+                }
+                : {
+                    ...activeCell,
+                    columIndex: clampIndex(activeCell.columnIndex - 1, isHidden, direction),
+                };
+            return isNil(lastContentfulCell)
+                ? undefined
+                : getSelectionToAddress?.(createSelectionBetweenCell(previousCell, lastContentfulCell), undefined, { ...activeCell, sheetId });
+        };
+        let autoSumRange = "";
+        const directionLookup = [Direction.Up, Direction.Left];
+        for (const dir of directionLookup) {
+            autoSumRange = getAutoSumRangeInDirection(dir) ?? "";
+            if (autoSumRange) {
+                break;
+            }
+        }
+        const formula = `=${functionName}(${autoSumRange})`;
+        // Make editable
+        makeEditable?.(sheetId, activeCell, formula);
+        // Move cursor
+        scheduleIdlePriorityCallback(() => {
+            const selection = activeEditorRef.current?.selection;
+            if (selection) {
+                const startOffset = 5;
+                const endOffset = startOffset + autoSumRange.length;
+                // activeEditorRef.current?.select({
+                //   anchor: {
+                //     path: selection.anchor.path,
+                //     offset: startOffset,
+                //   },
+                //   focus: {
+                //     path: selection.anchor.path,
+                //     offset: endOffset,
+                //   },
+                // });
+            }
+        });
+    }, [
+        makeEditable,
+        getEffectiveValue,
+        isHiddenRow,
+        getEffectiveFormat,
+        getSelectionToAddress,
+    ]);
+};

package/dist/esm/hooks/use-on-insert-cells-shift-down.d.ts

@@ -0,0 +1,28 @@
+import { type CellInterface, type SelectionArea } from "@rowsncolumns/grid";
+import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import type { OnCommand } from "../commands";
+import type { CellXfsRegistry } from "./use-cellxfs-registry";
+import type { SharedStringRegistry } from "./use-ss-registry";
+import type { useCalculation } from "./use-calculation";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+export type UseOnInsertCellsShiftDown<T extends CellData, S extends Sheet> = {
+    rowCount: number;
+    columnCount: number;
+    locale?: string;
+    cellXfsRegistry?: CellXfsRegistry;
+    sharedStringRegistry?: SharedStringRegistry;
+    getActiveCell: () => CellInterface;
+    getSelections(): SelectionArea<SelectionAttributes>[];
+    createHistory: () => (patches: SpreadsheetPatch) => void;
+    getDependents: ReturnType<typeof useCalculation>["getDependents"];
+    enqueueCalculation: ReturnType<typeof useCalculation>["enqueueCalculation"];
+    enqueueStructureChange?: ReturnType<typeof useCalculation>["enqueueStructureChange"];
+    enqueueGraphOperation: ReturnType<typeof useCalculation>["enqueueGraphOperation"];
+    onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
+    onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
+    onChangeCitations?: UseSpreadsheetProps<T, S>["onChangeCitations"];
+    onCommand?: OnCommand;
+};
+export declare const useOnInsertCellsShiftDown: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onCommand, }: UseOnInsertCellsShiftDown<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+//# sourceMappingURL=use-on-insert-cells-shift-down.d.ts.map

package/dist/esm/hooks/use-on-insert-cells-shift-down.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-insert-cells-shift-down.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-cells-shift-down.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,aAAa,IAAI,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACtD,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,cAAc,CACtB,CAAC,wBAAwB,CAAC,CAAC;IAC5B,qBAAqB,EAAE,UAAU,CAC/B,OAAO,cAAc,CACtB,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACnE,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,2QAiB5E,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,eAMnB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,SA+DrD,CAAC"}

package/dist/esm/hooks/use-on-insert-cells-shift-down.js

@@ -0,0 +1,65 @@
+import { useCallback } from "react";
+import { insertCellsShiftDown } from "../interface/insert-cells-shift-down";
+import { useShowError } from "../atoms/error-state.atom";
+import { SHEET_PROTECTION_ERROR_TITLE, useCanEditCellRange, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
+export const useOnInsertCellsShiftDown = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onCommand, }) => {
+    const canEditCellRange = useCanEditCellRange();
+    const canPerformSheetAction = useCanPerformSheetAction();
+    const showError = useShowError();
+    return useCallback((sheetId, activeCell, selections) => {
+        if (!canPerformSheetAction(sheetId, "insertRows")) {
+            showError({
+                title: SHEET_PROTECTION_ERROR_TITLE,
+                message: "You can't insert cells on a protected sheet.",
+            });
+            return;
+        }
+        if (!canEditCellRange(sheetId, activeCell)) {
+            console.debug("This range is protected, users cannot edit this cell range.");
+            return;
+        }
+        insertCellsShiftDown({
+            rowCount,
+            columnCount,
+            locale,
+            cellXfsRegistry,
+            sharedStringRegistry,
+            getActiveCell,
+            getSelections,
+            getDependents,
+            createHistory,
+            enqueueGraphOperation,
+            enqueueCalculation,
+            enqueueStructureChange,
+            onChangeSheetData,
+            onChangeSheets,
+            onChangeCitations,
+        })(sheetId, activeCell, selections);
+        onCommand?.({
+            command: "insert-cells-shift-down",
+            sheetId,
+            activeCell,
+            selections,
+        });
+    }, [
+        rowCount,
+        columnCount,
+        locale,
+        cellXfsRegistry,
+        sharedStringRegistry,
+        getActiveCell,
+        getSelections,
+        getDependents,
+        enqueueGraphOperation,
+        enqueueCalculation,
+        enqueueStructureChange,
+        onChangeSheetData,
+        createHistory,
+        onChangeSheets,
+        onChangeCitations,
+        canEditCellRange,
+        canPerformSheetAction,
+        showError,
+        onCommand,
+    ]);
+};

package/dist/esm/hooks/use-on-insert-cells-shift-right.d.ts

@@ -0,0 +1,28 @@
+import { type CellInterface, type SelectionArea } from "@rowsncolumns/grid";
+import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import type { OnCommand } from "../commands";
+import type { CellXfsRegistry } from "./use-cellxfs-registry";
+import type { SharedStringRegistry } from "./use-ss-registry";
+import type { useCalculation } from "./use-calculation";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+export type UseOnInsertCellsShiftRight<T extends CellData, S extends Sheet> = {
+    rowCount: number;
+    columnCount: number;
+    locale?: string;
+    cellXfsRegistry?: CellXfsRegistry;
+    sharedStringRegistry?: SharedStringRegistry;
+    getActiveCell: () => CellInterface;
+    getSelections(): SelectionArea<SelectionAttributes>[];
+    getDependents: ReturnType<typeof useCalculation>["getDependents"];
+    createHistory: () => (patches: SpreadsheetPatch) => void;
+    enqueueCalculation: ReturnType<typeof useCalculation>["enqueueCalculation"];
+    enqueueStructureChange?: ReturnType<typeof useCalculation>["enqueueStructureChange"];
+    enqueueGraphOperation: ReturnType<typeof useCalculation>["enqueueGraphOperation"];
+    onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
+    onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
+    onChangeCitations?: UseSpreadsheetProps<T, S>["onChangeCitations"];
+    onCommand?: OnCommand;
+};
+export declare const useOnInsertCellsShiftRight: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onCommand, }: UseOnInsertCellsShiftRight<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+//# sourceMappingURL=use-on-insert-cells-shift-right.d.ts.map

package/dist/esm/hooks/use-on-insert-cells-shift-right.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-insert-cells-shift-right.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-cells-shift-right.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,0BAA0B,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,aAAa,IAAI,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACtD,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,cAAc,CACtB,CAAC,wBAAwB,CAAC,CAAC;IAC5B,qBAAqB,EAAE,UAAU,CAC/B,OAAO,cAAc,CACtB,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACnE,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,EACf,2QAiBC,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,eAMpB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,SA8DrD,CAAC"}

package/dist/esm/hooks/use-on-insert-cells-shift-right.js

@@ -0,0 +1,65 @@
+import { useCallback } from "react";
+import { insertCellsShiftRight } from "../interface/insert-cells-shift-right";
+import { useShowError } from "../atoms/error-state.atom";
+import { SHEET_PROTECTION_ERROR_TITLE, useCanEditCellRange, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
+export const useOnInsertCellsShiftRight = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onCommand, }) => {
+    const canEditCellRange = useCanEditCellRange();
+    const canPerformSheetAction = useCanPerformSheetAction();
+    const showError = useShowError();
+    return useCallback((sheetId, activeCell, selections) => {
+        if (!canPerformSheetAction(sheetId, "insertColumns")) {
+            showError({
+                title: SHEET_PROTECTION_ERROR_TITLE,
+                message: "You can't insert cells on a protected sheet.",
+            });
+            return;
+        }
+        if (!canEditCellRange(sheetId, activeCell)) {
+            console.debug("This range is protected, users cannot edit this cell range.");
+            return;
+        }
+        insertCellsShiftRight({
+            rowCount,
+            columnCount,
+            locale,
+            cellXfsRegistry,
+            sharedStringRegistry,
+            getActiveCell,
+            getSelections,
+            getDependents,
+            createHistory,
+            enqueueGraphOperation,
+            enqueueCalculation,
+            enqueueStructureChange,
+            onChangeSheetData,
+            onChangeSheets,
+            onChangeCitations,
+        })(sheetId, activeCell, selections);
+        onCommand?.({
+            command: "insert-cells-shift-right",
+            sheetId,
+            activeCell,
+            selections,
+        });
+    }, [
+        rowCount,
+        columnCount,
+        locale,
+        cellXfsRegistry,
+        sharedStringRegistry,
+        getActiveCell,
+        getSelections,
+        getDependents,
+        enqueueGraphOperation,
+        enqueueCalculation,
+        enqueueStructureChange,
+        onChangeSheetData,
+        createHistory,
+        onChangeSheets,
+        onChangeCitations,
+        canEditCellRange,
+        canPerformSheetAction,
+        showError,
+        onCommand,
+    ]);
+};

package/dist/esm/hooks/use-on-insert-checkbox.d.ts

@@ -0,0 +1,17 @@
+import type { SelectionArea } from "@rowsncolumns/common-types";
+import type { CellInterface } from "@rowsncolumns/common-types";
+import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import type { OnCommand } from "../commands";
+import type { CalculationOperation } from "./use-calculation";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+type UseOnInsertCheckboxProps<T extends CellData, S extends Sheet> = {
+    locale?: string;
+    enqueueCalculation(operation: CalculationOperation): void;
+    onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
+    createHistory(): (patches: SpreadsheetPatch) => void;
+    onCommand?: OnCommand;
+};
+export declare const useOnInsertCheckbox: <T extends CellData, S extends Sheet>({ locale, enqueueCalculation, onChangeSheetData, createHistory, onCommand, }: UseOnInsertCheckboxProps<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+export {};
+//# sourceMappingURL=use-on-insert-checkbox.d.ts.map

package/dist/esm/hooks/use-on-insert-checkbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-insert-checkbox.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-checkbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,KAAK,EACV,QAAQ,EAER,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAMnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,wBAAwB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,8EAMtE,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,eAGlB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,SAmGrD,CAAC"}

package/dist/esm/hooks/use-on-insert-checkbox.js

@@ -0,0 +1,73 @@
+import { selectionFromActiveCell } from "@rowsncolumns/grid";
+import { produceWithPatches } from "immer";
+import { useCallback } from "react";
+import { createSheetCellIdentifier } from "../api/formula";
+import { createSheetDraft } from "../api/immer-utils";
+import { SheetCell } from "../sheet-cell";
+export const useOnInsertCheckbox = ({ locale, enqueueCalculation, onChangeSheetData, createHistory, onCommand, }) => {
+    return useCallback((sheetId, activeCell, selections) => {
+        const saveHistory = createHistory();
+        // We need to track this for history. Precedent cells
+        const recalcCells = new Map();
+        const sheetCell = new SheetCell();
+        const finalSelections = selections.length
+            ? selections
+            : selectionFromActiveCell(activeCell);
+        // Update sheets
+        onChangeSheetData?.((prevSheetData) => {
+            const [nextState, patches, inversePatches] = produceWithPatches(prevSheetData, (draft) => {
+                for (const selection of finalSelections) {
+                    for (let rowIndex = selection.range.startRowIndex; rowIndex <= selection.range.endRowIndex; rowIndex++) {
+                        const currentSheet = createSheetDraft(draft, sheetId, rowIndex);
+                        for (let columnIndex = selection.range.startColumnIndex; columnIndex <= selection.range.endColumnIndex; columnIndex++) {
+                            const cellData = currentSheet[rowIndex].values?.[columnIndex];
+                            // Create a cell
+                            sheetCell.assign(sheetId, { rowIndex, columnIndex }, cellData, { locale });
+                            // Add url
+                            const checkboxValidationId = `checkbox-${sheetId}-${rowIndex}-${columnIndex}`;
+                            const checkboxValidationRule = {
+                                id: checkboxValidationId,
+                                condition: {
+                                    type: "BOOLEAN",
+                                },
+                                // Excel parity: UI-created rules ignore blanks by default.
+                                allowBlank: true,
+                                ranges: [],
+                            };
+                            sheetCell.setDataValidation(checkboxValidationId, checkboxValidationRule);
+                            // Set cell data
+                            currentSheet[rowIndex].values[columnIndex] =
+                                sheetCell.getCellData();
+                            // Enqueue
+                            enqueueCalculation({
+                                position: { rowIndex, columnIndex, sheetId },
+                                type: "add",
+                            });
+                            // Add to recalc cells
+                            recalcCells.set(createSheetCellIdentifier(sheetId, rowIndex, columnIndex), {
+                                rowIndex,
+                                columnIndex,
+                                sheetId,
+                            });
+                        }
+                    }
+                }
+            });
+            // Save history
+            saveHistory({
+                sheetData: { patches, inversePatches },
+                activeCell: { undo: activeCell, redo: activeCell },
+                selections: { undo: selections, redo: selections },
+                sheetId: { undo: sheetId, redo: sheetId },
+                recalcCells: { undo: recalcCells, redo: recalcCells },
+            });
+            return nextState;
+        });
+        onCommand?.({
+            command: "insert-checkbox",
+            sheetId,
+            activeCell,
+            selections,
+        });
+    }, [locale, enqueueCalculation, onChangeSheetData, createHistory, onCommand]);
+};

package/dist/esm/hooks/use-on-insert-column.d.ts

@@ -0,0 +1,40 @@
+import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
+import type { SelectionAttributes, TableView } from "@rowsncolumns/spreadsheet";
+import { type CellData, type Sheet } from "@rowsncolumns/spreadsheet";
+import type { OnCommand } from "../commands";
+import type { GeneratedNames } from "../generated-names";
+import type { CellXfsRegistry } from "./use-cellxfs-registry";
+import type { SharedStringRegistry } from "./use-ss-registry";
+import type { useCalculation } from "./use-calculation";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+export type UseOnInsertColumnProps<T extends CellData, S extends Sheet> = {
+    rowCount: number;
+    columnCount: number;
+    locale?: string;
+    tables?: TableView[];
+    maxColumnCount?: number;
+    cellXfsRegistry?: CellXfsRegistry;
+    sharedStringRegistry?: SharedStringRegistry;
+    getActiveCell: () => CellInterface;
+    getSelections(): SelectionArea<SelectionAttributes>[];
+    getDependents: ReturnType<typeof useCalculation>["getDependents"];
+    getGraphNodes?: ReturnType<typeof useCalculation>["getGraphNodes"];
+    getGraphNodesInSheet?: ReturnType<typeof useCalculation>["getGraphNodesInSheet"];
+    createHistory: () => (patches: SpreadsheetPatch) => void;
+    enqueueCalculation: ReturnType<typeof useCalculation>["enqueueCalculation"];
+    enqueueStructureChange?: ReturnType<typeof useCalculation>["enqueueStructureChange"];
+    enqueueGraphOperation: ReturnType<typeof useCalculation>["enqueueGraphOperation"];
+    onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
+    onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
+    onChangeTables: UseSpreadsheetProps<T, S>["onChangeTables"];
+    onChangeDataValidations?: UseSpreadsheetProps<T, S>["onChangeDataValidations"];
+    onChangeConditionalFormats?: UseSpreadsheetProps<T, S>["onChangeConditionalFormats"];
+    onChangeCitations?: UseSpreadsheetProps<T, S>["onChangeCitations"];
+    onChangePivotTables?: UseSpreadsheetProps<T, S>["onChangePivotTables"];
+    getSheetName(sheetId: number): string;
+    onCommand?: OnCommand;
+    generatedNames?: GeneratedNames;
+};
+export declare const useOnInsertColumn: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, tables, maxColumnCount, cellXfsRegistry, sharedStringRegistry, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, getActiveCell, getSelections, getSheetName, onCommand, generatedNames, }: UseOnInsertColumnProps<T, S>) => (sheetId: number, referenceColumnIndex: number, numColumns?: number) => void;
+//# sourceMappingURL=use-on-insert-column.d.ts.map

package/dist/esm/hooks/use-on-insert-column.d.ts.map

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

package/dist/esm/hooks/use-on-insert-column.js

@@ -0,0 +1,91 @@
+import { isNil } from "@rowsncolumns/utils";
+import { useCallback } from "react";
+import { useShowError } from "../atoms/error-state.atom";
+import { insertColumn } from "../interface/insert-column";
+import { SHEET_PROTECTION_ERROR_TITLE, useCanEditSheet, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
+export const useOnInsertColumn = ({ rowCount, columnCount, locale, tables, maxColumnCount, cellXfsRegistry, sharedStringRegistry, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, getActiveCell, getSelections, getSheetName, onCommand, generatedNames, }) => {
+    const canEditSheet = useCanEditSheet();
+    const canPerformSheetAction = useCanPerformSheetAction();
+    const showError = useShowError();
+    return useCallback((sheetId, referenceColumnIndex, numColumns = 1) => {
+        if (!canEditSheet(sheetId)) {
+            console.debug("This range is protected, users cannot edit this cell range.");
+            return;
+        }
+        if (!canPerformSheetAction(sheetId, "insertColumns")) {
+            showError({
+                title: SHEET_PROTECTION_ERROR_TITLE,
+                message: "You can't insert columns on a protected sheet.",
+            });
+            return;
+        }
+        if (!isNil(maxColumnCount) && columnCount >= maxColumnCount) {
+            showError({
+                title: "New columns cannot be added",
+                message: "You have reached the maximum number of columns.",
+            });
+            return;
+        }
+        insertColumn({
+            rowCount,
+            columnCount,
+            locale,
+            tables,
+            cellXfsRegistry,
+            sharedStringRegistry,
+            getDependents,
+            getGraphNodes,
+            getGraphNodesInSheet,
+            createHistory,
+            enqueueGraphOperation,
+            enqueueCalculation,
+            enqueueStructureChange,
+            onChangeSheetData,
+            onChangeSheets,
+            onChangeTables,
+            onChangeConditionalFormats,
+            onChangeDataValidations,
+            onChangeCitations,
+            onChangePivotTables,
+            getActiveCell,
+            getSelections,
+            getSheetName,
+            generatedNames,
+        })(sheetId, referenceColumnIndex, numColumns);
+        onCommand?.({
+            command: "insert-column",
+            sheetId,
+            referenceColumnIndex,
+            numColumns,
+        });
+    }, [
+        rowCount,
+        columnCount,
+        locale,
+        tables,
+        maxColumnCount,
+        cellXfsRegistry,
+        sharedStringRegistry,
+        showError,
+        getDependents,
+        getGraphNodes,
+        getGraphNodesInSheet,
+        getActiveCell,
+        getSelections,
+        enqueueGraphOperation,
+        enqueueCalculation,
+        enqueueStructureChange,
+        createHistory,
+        onChangeSheets,
+        onChangeTables,
+        onChangeSheetData,
+        onChangeConditionalFormats,
+        onChangeDataValidations,
+        onChangePivotTables,
+        canEditSheet,
+        canPerformSheetAction,
+        getSheetName,
+        onCommand,
+        generatedNames,
+    ]);
+};

package/dist/esm/hooks/use-on-insert-date-time.d.ts

@@ -0,0 +1,4 @@
+export declare const useOnInsertDateTime: ({ locale }: {
+    locale?: string;
+}) => (sheetId: number, activeCell: import("@rowsncolumns/grid").CellInterface, selections: import("@rowsncolumns/grid").SelectionArea<import("@rowsncolumns/spreadsheet").SelectionAttributes>[]) => void;
+//# sourceMappingURL=use-on-insert-date-time.d.ts.map

package/dist/esm/hooks/use-on-insert-date-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-insert-date-time.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-date-time.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB,GAAI,YAAY;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,yMAUlE,CAAC"}

package/dist/esm/hooks/use-on-insert-date-time.js

@@ -0,0 +1,11 @@
+import { useSpreadsheet } from "@rowsncolumns/spreadsheet";
+import { getDefaultDateTimeFormat, ssfFormat } from "@rowsncolumns/utils";
+import { useCallback } from "react";
+export const useOnInsertDateTime = ({ locale }) => {
+    const { makeEditable } = useSpreadsheet();
+    return useCallback((sheetId, activeCell) => {
+        const now = new Date();
+        const time = ssfFormat(getDefaultDateTimeFormat(locale), now, locale);
+        makeEditable?.(sheetId, activeCell, time);
+    }, [locale, makeEditable]);
+};

package/dist/esm/hooks/use-on-insert-date.d.ts

@@ -0,0 +1,4 @@
+export declare const useOnInsertDate: ({ locale }: {
+    locale?: string;
+}) => (sheetId: number, activeCell: import("@rowsncolumns/grid").CellInterface, selections: import("@rowsncolumns/grid").SelectionArea<import("@rowsncolumns/spreadsheet").SelectionAttributes>[]) => void;
+//# sourceMappingURL=use-on-insert-date.d.ts.map

package/dist/esm/hooks/use-on-insert-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-insert-date.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-date.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe,GAAI,YAAY;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,yMAW9D,CAAC"}

package/dist/esm/hooks/use-on-insert-date.js

@@ -0,0 +1,12 @@
+import { useSpreadsheet } from "@rowsncolumns/spreadsheet";
+import { getDefaultDateFormat, ssfFormat } from "@rowsncolumns/utils";
+import { useCallback } from "react";
+export const useOnInsertDate = ({ locale }) => {
+    const { makeEditable } = useSpreadsheet();
+    return useCallback((sheetId, activeCell) => {
+        const now = new Date();
+        const pattern = getDefaultDateFormat(locale);
+        const time = ssfFormat(pattern, now);
+        makeEditable?.(sheetId, activeCell, time);
+    }, [locale, makeEditable]);
+};

package/dist/esm/hooks/use-on-insert-image.d.ts

@@ -0,0 +1,24 @@
+import type { CellInterface } from "@rowsncolumns/common-types";
+import type { CellData, Sheet } from "@rowsncolumns/spreadsheet";
+import type { OnCommand } from "../commands";
+import type { CalculationOperation } from "./use-calculation";
+import type { InsertFileOptions } from "./use-on-drag-n-drop";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+type UseOnInsertImageProps<T extends CellData, S extends Sheet> = {
+    locale?: string;
+    /**
+     * Id creation strategy
+     */
+    idCreationStrategy?: UseSpreadsheetProps["idCreationStrategy"];
+    enqueueCalculation(operation: CalculationOperation): void;
+    createHistory: () => (patches: SpreadsheetPatch) => void;
+    onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
+    onChangeEmbeds: UseSpreadsheetProps<T, S>["onChangeEmbeds"];
+    onCommand?: OnCommand;
+};
+export declare const useOnInsertImage: <T extends CellData, S extends Sheet>({ locale, idCreationStrategy, enqueueCalculation, createHistory, onChangeEmbeds, onChangeSheetData, onCommand, }: UseOnInsertImageProps<T, S>) => (fileOrUrl: File | string, sheetId: number, activeCell: CellInterface, options?: InsertFileOptions & {
+    embedId?: string | number;
+}) => Promise<void>;
+export {};
+//# sourceMappingURL=use-on-insert-image.d.ts.map

package/dist/esm/hooks/use-on-insert-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-insert-image.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EACV,QAAQ,EAER,KAAK,EACN,MAAM,2BAA2B,CAAC;AAYnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,qBAAqB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,kBAAkB,CAAC,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;IAC/D,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,kHAQnE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,iBAIb,IAAI,GAAG,MAAM,WACf,MAAM,cACH,aAAa,YACf,iBAAiB,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,kBAoJhE,CAAC"}