@rowsncolumns/spreadsheet-state 28.0.66

package/dist/cjs/hooks/use-on-change-formatting.d.ts

@@ -0,0 +1,44 @@
+import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
+import type { BorderLocation, BorderStyle, CanvasGridMethods, CellData, CellFormat, Color, FormattingType, FormattingValue, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import type { Patch } from "immer";
+import type { OnCommand } from "../commands";
+import type { CalculationOperation } from "./use-calculation";
+import type { CellXfsRegistry } from "./use-cellxfs-registry";
+import type { useSheetProperties } from "./use-sheet-properties";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+export type UseOnChangeFormattingProps<T extends CellData, S extends Sheet> = {
+    locale?: string;
+    cellXfsRegistry?: CellXfsRegistry;
+    getDataValidationById?: ReturnType<typeof useSheetProperties>["getDataValidationById"];
+    onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
+    onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
+    createHistory: () => (patches: SpreadsheetPatch<Patch>) => void;
+    enqueueCalculation: (operation: CalculationOperation) => void;
+    getFormattedValue: ReturnType<typeof useSheetProperties>["getFormattedValue"];
+    /**
+     * Check if a cell is merged cell
+     * @param sheetId
+     * @param rowIndex
+     * @param columnIndex
+     * @returns
+     */
+    isMergedCell?: (sheetId: number, rowIndex: number, columnIndex: number) => boolean | undefined;
+    getCellDimensions?: CanvasGridMethods["getCellDimensions"];
+    getRowHeight?: CanvasGridMethods["getRowHeight"];
+    /**
+     * Emit a high-level command alongside the immer-patch history.
+     */
+    onCommand?: OnCommand;
+};
+export type OnChangeFormattingWithCellFormat = (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[], cellFormatOrCellFormatArray: CellFormat | undefined | null | (CellFormat | undefined | null)[][], options?: FormattingChangeOptions) => void;
+export type FormattingChangeOptions = {
+    replace?: boolean;
+};
+export type OnChangeFormattingWithTypeValue<K extends FormattingType> = (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[], type: K, value: FormattingValue<K>, options?: FormattingChangeOptions) => void;
+export declare const useOnChangeFormatting: <T extends CellData, S extends Sheet, K extends FormattingType>({ locale, cellXfsRegistry, getFormattedValue, onChangeSheetData, onChangeSheets, enqueueCalculation, createHistory, getCellDimensions, getRowHeight, isMergedCell, getDataValidationById, onCommand, }: UseOnChangeFormattingProps<T, S>) => {
+    onChangeFormatting: (...args: Parameters<OnChangeFormattingWithTypeValue<K> | OnChangeFormattingWithCellFormat>) => void;
+    onChangeBorder: (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[], location: BorderLocation, color: Color | undefined, style?: BorderStyle | undefined) => void;
+    onRepeatFormatting: (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+};
+//# sourceMappingURL=use-on-change-formatting.d.ts.map

package/dist/cjs/hooks/use-on-change-formatting.d.ts.map

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

package/dist/cjs/hooks/use-on-change-formatting.js

@@ -0,0 +1,165 @@
+import { __read, __spreadArray } from "tslib";
+import { useCallback, useRef } from "react";
+import { changeBorder } from "../interface/change-border";
+import { changeFormatting } from "../interface/change-formatting";
+import { useShowError } from "../atoms/error-state.atom";
+import { SHEET_PROTECTION_ERROR_TITLE, useCanEditCellRange, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
+export var useOnChangeFormatting = function (_a) {
+    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, getFormattedValue = _a.getFormattedValue, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, enqueueCalculation = _a.enqueueCalculation, createHistory = _a.createHistory, getCellDimensions = _a.getCellDimensions, getRowHeight = _a.getRowHeight, isMergedCell = _a.isMergedCell, getDataValidationById = _a.getDataValidationById, onCommand = _a.onCommand;
+    var canEditCellRange = useCanEditCellRange();
+    var canPerformSheetAction = useCanPerformSheetAction();
+    var showError = useShowError();
+    var lastFormattingRef = useRef(undefined);
+    // Change formatting
+    var onChangeFormatting = useCallback(function () {
+        var _a, _b, _c;
+        var _d;
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        var sheetId;
+        var activeCell;
+        var type;
+        var value;
+        var cellFormatOrCellFormatArray;
+        if (args.length === 5) {
+            _a = __read(args, 5), sheetId = _a[0], activeCell = _a[1], type = _a[3], value = _a[4];
+            // Cell format
+            cellFormatOrCellFormatArray = (_b = {}, _b[type] = value, _b);
+        }
+        else {
+            _c = __read(args, 4), sheetId = _c[0], activeCell = _c[1], cellFormatOrCellFormatArray = _c[3];
+        }
+        if (!canPerformSheetAction(sheetId, "formatCells")) {
+            showError({
+                title: SHEET_PROTECTION_ERROR_TITLE,
+                message: "You can't change formatting on a protected sheet.",
+            });
+            return;
+        }
+        if (!canEditCellRange(sheetId, activeCell)) {
+            console.debug("This range is protected, users cannot edit this cell range.");
+            return;
+        }
+        changeFormatting({
+            createHistory: createHistory,
+            enqueueCalculation: enqueueCalculation,
+            getCellDimensions: getCellDimensions,
+            getFormattedValue: getFormattedValue,
+            getRowHeight: getRowHeight,
+            isMergedCell: isMergedCell,
+            onChangeSheetData: onChangeSheetData,
+            onChangeSheets: onChangeSheets,
+            locale: locale,
+            cellXfsRegistry: cellXfsRegistry,
+            getDataValidationById: getDataValidationById,
+        }).apply(void 0, __spreadArray([], __read(args), false));
+        // Keep reference of last formatting
+        if (cellFormatOrCellFormatArray &&
+            !Array.isArray(cellFormatOrCellFormatArray)) {
+            lastFormattingRef.current = [cellFormatOrCellFormatArray];
+        }
+        // Emit semantic command. Both call shapes normalize to a CellFormat.
+        if (onCommand) {
+            var selections = ((_d = args[2]) !== null && _d !== void 0 ? _d : []);
+            var optionsArg = args.length === 5
+                ? args[5]
+                : args[4];
+            onCommand({
+                command: "change-formatting",
+                sheetId: sheetId,
+                activeCell: activeCell,
+                selections: selections,
+                cellFormat: cellFormatOrCellFormatArray,
+                options: optionsArg,
+            });
+        }
+    }, [
+        locale,
+        cellXfsRegistry,
+        getDataValidationById,
+        isMergedCell,
+        onChangeSheetData,
+        enqueueCalculation,
+        onChangeSheets,
+        createHistory,
+        getFormattedValue,
+        getCellDimensions,
+        getRowHeight,
+        canEditCellRange,
+        canPerformSheetAction,
+        showError,
+        onCommand,
+    ]);
+    // Change borders
+    var onChangeBorder = useCallback(function (sheetId, activeCell, selections, location, color, style) {
+        if (style === void 0) { style = "solid"; }
+        if (!canPerformSheetAction(sheetId, "formatCells")) {
+            showError({
+                title: SHEET_PROTECTION_ERROR_TITLE,
+                message: "You can't change formatting on a protected sheet.",
+            });
+            return;
+        }
+        if (!canEditCellRange(sheetId, activeCell)) {
+            console.debug("This range is protected, users cannot edit this cell range.");
+            return;
+        }
+        changeBorder({
+            createHistory: createHistory,
+            enqueueCalculation: enqueueCalculation,
+            getCellDimensions: getCellDimensions,
+            getFormattedValue: getFormattedValue,
+            getRowHeight: getRowHeight,
+            isMergedCell: isMergedCell,
+            onChangeSheetData: onChangeSheetData,
+            onChangeSheets: onChangeSheets,
+            locale: locale,
+            cellXfsRegistry: cellXfsRegistry,
+        })(sheetId, activeCell, selections, location, color, style);
+        // Keep reference of last formatting
+        lastFormattingRef.current = ["borders", location, color, style];
+        // Emit semantic command, mirroring the callback args verbatim.
+        onCommand === null || onCommand === void 0 ? void 0 : onCommand({
+            command: "change-border",
+            sheetId: sheetId,
+            activeCell: activeCell,
+            selections: selections,
+            location: location,
+            color: color,
+            style: style,
+        });
+    }, [
+        locale,
+        createHistory,
+        canEditCellRange,
+        canPerformSheetAction,
+        showError,
+        cellXfsRegistry,
+        getCellDimensions,
+        getFormattedValue,
+        getRowHeight,
+        isMergedCell,
+        onChangeSheets,
+        onChangeSheetData,
+        enqueueCalculation,
+        onCommand,
+    ]);
+    // rRepeat formatting
+    var onRepeatFormatting = useCallback(function (sheetId, activeCell, selections) {
+        var previousFormatting = lastFormattingRef.current;
+        if (previousFormatting) {
+            var _a = __read(previousFormatting, 1), type = _a[0];
+            // Borders
+            if (type === "borders" && previousFormatting.length === 4) {
+                var _b = __read(previousFormatting, 4), _1 = _b[0], location_1 = _b[1], color = _b[2], style = _b[3];
+                onChangeBorder === null || onChangeBorder === void 0 ? void 0 : onChangeBorder(sheetId, activeCell, selections, location_1, color, style);
+            }
+            else {
+                onChangeFormatting === null || onChangeFormatting === void 0 ? void 0 : onChangeFormatting(sheetId, activeCell, selections, previousFormatting);
+            }
+        }
+    }, [onChangeFormatting, onChangeBorder]);
+    return { onChangeFormatting: onChangeFormatting, onChangeBorder: onChangeBorder, onRepeatFormatting: onRepeatFormatting };
+};

package/dist/cjs/hooks/use-on-change-sheet-tabcolor.d.ts

@@ -0,0 +1,11 @@
+import { type CellData, type Color, type Sheet } from "@rowsncolumns/spreadsheet";
+import type { OnCommand } from "../commands";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+export type UseOnChangeSheetTabcolorProps<T extends CellData, S extends Sheet> = {
+    onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
+    createHistory(): (patches: SpreadsheetPatch) => void;
+    onCommand?: OnCommand;
+};
+export declare const useOnChangeSheetTabcolor: <T extends CellData, S extends Sheet>({ onChangeSheets, createHistory, onCommand, }: UseOnChangeSheetTabcolorProps<T, S>) => (sheetId: number, color: Color | undefined) => void;
+//# sourceMappingURL=use-on-change-sheet-tabcolor.d.ts.map

package/dist/cjs/hooks/use-on-change-sheet-tabcolor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-change-sheet-tabcolor.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-change-sheet-tabcolor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,KAAK,EACV,KAAK,KAAK,EACX,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,6BAA6B,CACvC,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,IACb;IACF,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AACF,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,+CAI3E,6BAA6B,CAAC,CAAC,EAAE,CAAC,CAAC,eAIxB,MAAM,SAAS,KAAK,GAAG,SAAS,SA2B7C,CAAC"}

package/dist/cjs/hooks/use-on-change-sheet-tabcolor.js

@@ -0,0 +1,27 @@
+import { useCallback } from "react";
+import { changeSheetTabcolor } from "../interface/change-sheet-tabcolor";
+import { useCanEditSheet, useCanEditWorkbook } from "./use-can-edit-cellrange";
+export var useOnChangeSheetTabcolor = function (_a) {
+    var onChangeSheets = _a.onChangeSheets, createHistory = _a.createHistory, onCommand = _a.onCommand;
+    var canEditSheet = useCanEditSheet();
+    var canEditWorkbook = useCanEditWorkbook();
+    return useCallback(function (sheetId, color) {
+        if (!canEditWorkbook()) {
+            console.debug("Workbook is structurally protected, cannot change sheet tab color.");
+            return;
+        }
+        if (!canEditSheet(sheetId)) {
+            console.debug("This range is protected, users cannot edit this cell range.");
+            return;
+        }
+        changeSheetTabcolor({
+            onChangeSheets: onChangeSheets,
+            createHistory: createHistory,
+        })(sheetId, color);
+        onCommand === null || onCommand === void 0 ? void 0 : onCommand({
+            command: "change-sheet-tab-color",
+            sheetId: sheetId,
+            color: color,
+        });
+    }, [createHistory, onChangeSheets, canEditSheet, canEditWorkbook, onCommand]);
+};

package/dist/cjs/hooks/use-on-change-table-column.d.ts

@@ -0,0 +1,25 @@
+import type { CellInterface, GridRange } from "@rowsncolumns/common-types";
+import type { CellData, Sheet, TableView } from "@rowsncolumns/spreadsheet";
+import type { Patch } from "immer";
+import type { OnCommand } from "../commands";
+import type { GeneratedNames } from "../generated-names";
+import type { CalculationOperation, useCalculation } from "./use-calculation";
+import type { CellXfsRegistry } from "./use-cellxfs-registry";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SharedStringRegistry } from "./use-ss-registry";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+export type UseOnChangeTableColumnProps<T extends CellData, S extends Sheet> = {
+    locale?: string;
+    cellXfsRegistry?: CellXfsRegistry;
+    sharedStringRegistry?: SharedStringRegistry;
+    onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
+    onChangeTables: UseSpreadsheetProps<T, S>["onChangeTables"];
+    enqueueCalculation(operation: CalculationOperation): void;
+    enqueueGraphOperation(operation: CalculationOperation): void;
+    getDependents: ReturnType<typeof useCalculation>["getDependents"];
+    createHistory: () => (patches: SpreadsheetPatch<Patch>) => void;
+    onCommand?: OnCommand;
+    generatedNames?: GeneratedNames;
+};
+export declare const useOnChangeTableColumn: <T extends CellData, S extends Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, onChangeSheetData, onChangeTables, getDependents, enqueueCalculation, enqueueGraphOperation, createHistory, onCommand, generatedNames, }: UseOnChangeTableColumnProps<T, S>) => (sheetId: number, coords: CellInterface, value: string | boolean | undefined, currentTable: TableView | undefined, isRowExpansion: boolean, isColumnExpansion: boolean, range: GridRange) => void;
+//# sourceMappingURL=use-on-change-table-column.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-change-table-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-change-table-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,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,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,qBAAqB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAE7D,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAChE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,2LAYzE,2BAA2B,CAAC,CAAC,EAAE,CAAC,CAAC,eAIrB,MAAM,UACP,aAAa,SACd,MAAM,GAAG,OAAO,GAAG,SAAS,gBACrB,SAAS,GAAG,SAAS,kBACnB,OAAO,qBACJ,OAAO,SACnB,SAAS,SA4DrB,CAAC"}

package/dist/cjs/hooks/use-on-change-table-column.js

@@ -0,0 +1,53 @@
+import { useTokenizer } from "@rowsncolumns/spreadsheet";
+import { useCallback } from "react";
+import { changeTableColumn } from "../interface/change-table-column";
+export var useOnChangeTableColumn = function (_a) {
+    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, onChangeSheetData = _a.onChangeSheetData, onChangeTables = _a.onChangeTables, getDependents = _a.getDependents, enqueueCalculation = _a.enqueueCalculation, enqueueGraphOperation = _a.enqueueGraphOperation, createHistory = _a.createHistory, onCommand = _a.onCommand, generatedNames = _a.generatedNames;
+    var tokenizer = useTokenizer();
+    return useCallback(function (sheetId, coords, value, currentTable, isRowExpansion, isColumnExpansion, range) {
+        changeTableColumn({
+            locale: locale,
+            cellXfsRegistry: cellXfsRegistry,
+            sharedStringRegistry: sharedStringRegistry,
+            onChangeSheetData: onChangeSheetData,
+            onChangeTables: onChangeTables,
+            getDependents: getDependents,
+            enqueueCalculation: enqueueCalculation,
+            enqueueGraphOperation: enqueueGraphOperation,
+            createHistory: createHistory,
+            tokenizer: tokenizer,
+            generatedNames: generatedNames,
+        })(sheetId, coords, value, currentTable, isRowExpansion, isColumnExpansion, range);
+        // A header-cell edit on an existing column is a rename — stream the intent so the engine
+        // updates its header list + redefines the table (structured refs resolve to the new name).
+        // Column expansion (adding a column) rides update-table; this is only the in-place rename.
+        if (currentTable &&
+            !isColumnExpansion &&
+            currentTable.range.startRowIndex === coords.rowIndex &&
+            coords.columnIndex >= currentTable.range.startColumnIndex &&
+            coords.columnIndex <= currentTable.range.endColumnIndex &&
+            typeof value === "string" &&
+            value) {
+            onCommand === null || onCommand === void 0 ? void 0 : onCommand({
+                command: "change-table-column",
+                sheetId: sheetId,
+                tableId: currentTable.id,
+                columnIndex: coords.columnIndex,
+                name: value,
+            });
+        }
+    }, [
+        locale,
+        cellXfsRegistry,
+        sharedStringRegistry,
+        onChangeSheetData,
+        onChangeTables,
+        getDependents,
+        enqueueCalculation,
+        enqueueGraphOperation,
+        createHistory,
+        tokenizer,
+        onCommand,
+        generatedNames,
+    ]);
+};

package/dist/cjs/hooks/use-on-change-theme.d.ts

@@ -0,0 +1,11 @@
+import type { CellData, SpreadsheetTheme } from "@rowsncolumns/spreadsheet";
+import type { OnCommand } from "../commands";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+export type UseOnChangeThemeProps<T extends CellData> = {
+    onChangeTheme: UseSpreadsheetProps<T>["onChangeTheme"];
+    createHistory: () => (patches: SpreadsheetPatch) => void;
+    onCommand?: OnCommand;
+};
+export declare const useOnChangeTheme: <T extends CellData>({ createHistory, onChangeTheme, onCommand, }: UseOnChangeThemeProps<T>) => (theme: SpreadsheetTheme) => Promise<void>;
+//# sourceMappingURL=use-on-change-theme.d.ts.map

package/dist/cjs/hooks/use-on-change-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-change-theme.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-change-theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,QAAQ,IAAI;IACtD,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IACvD,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EAAE,8CAIlD,qBAAqB,CAAC,CAAC,CAAC,aAET,gBAAgB,kBAUjC,CAAC"}

package/dist/cjs/hooks/use-on-change-theme.js

@@ -0,0 +1,20 @@
+import { __awaiter, __generator } from "tslib";
+import { useCallback } from "react";
+import { changeTheme } from "../interface/change-theme";
+export var useOnChangeTheme = function (_a) {
+    var createHistory = _a.createHistory, onChangeTheme = _a.onChangeTheme, onCommand = _a.onCommand;
+    return useCallback(function (theme) { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, changeTheme({
+                        createHistory: createHistory,
+                        onChangeTheme: onChangeTheme,
+                    })(theme)];
+                case 1:
+                    _a.sent();
+                    onCommand === null || onCommand === void 0 ? void 0 : onCommand({ command: "change-theme", theme: theme });
+                    return [2 /*return*/];
+            }
+        });
+    }); }, [createHistory, onChangeTheme, onCommand]);
+};

package/dist/cjs/hooks/use-on-change.d.ts

@@ -0,0 +1,61 @@
+import type { CellInterface } from "@rowsncolumns/common-types";
+import type { CellData, Sheet, TableView } from "@rowsncolumns/spreadsheet";
+import type { TextFormatRun } from "@rowsncolumns/ui";
+import type { Patch } from "immer";
+import type { OnCommand } from "../commands";
+import type { GeneratedNames } from "../generated-names";
+import type { CalculationOperation, useCalculation } from "./use-calculation";
+import type { CellXfsRegistry } from "./use-cellxfs-registry";
+import type { useSheetProperties } from "./use-sheet-properties";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SharedStringRegistry } from "./use-ss-registry";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+export type UseOnChangeProps<T extends CellData, S extends Sheet> = {
+    locale?: string;
+    tables?: TableView[];
+    getUserEnteredValue: ReturnType<typeof useSheetProperties>["getUserEnteredValue"];
+    /**
+     * Reads the previous textFormatRuns from the cell store. Used to
+     * detect pure-formatting edits (value unchanged, runs differ) when
+     * the caller doesn't supply `previousTextFormatRuns` explicitly.
+     */
+    getTextFormatRuns?: ReturnType<typeof useSheetProperties>["getTextFormatRuns"];
+    cellXfsRegistry?: CellXfsRegistry;
+    sharedStringRegistry?: SharedStringRegistry;
+    getDataValidationById?: ReturnType<typeof useSheetProperties>["getDataValidationById"];
+    onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
+    onChangeTables: UseSpreadsheetProps<T, S>["onChangeTables"];
+    onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
+    getDependents: ReturnType<typeof useCalculation>["getDependents"];
+    enqueueCalculation(operation: CalculationOperation): void;
+    enqueueGraphOperation(operation: CalculationOperation): void;
+    createHistory: () => (patches: SpreadsheetPatch<Patch>) => void;
+    getSheetName(sheetId: number): string;
+    /**
+     * Check if a cell is merged cell
+     * @param sheetId
+     * @param rowIndex
+     * @param columnIndex
+     * @returns
+     */
+    isMergedCell: (sheetId: number, rowIndex: number, columnIndex: number) => boolean | undefined;
+    /**
+     * Emit a high-level command alongside the immer-patch history.
+     */
+    onCommand?: OnCommand;
+    generatedNames?: GeneratedNames;
+};
+/**
+ * Change handler
+ * Undo history order
+ * 1. Cell change
+ * 2. If Table
+ *  1. Add column
+ *  2. If computed column - Fill all computed columns
+ *
+ * Refactor use-on-change and use-on-paste.
+ * @param param0
+ * @returns
+ */
+export declare const useOnChange: <T extends CellData, S extends Sheet>({ locale, tables, cellXfsRegistry, sharedStringRegistry, getUserEnteredValue, getTextFormatRuns, onChangeSheetData, onChangeTables, onChangeSheets, getDependents, enqueueCalculation, enqueueGraphOperation, createHistory, getDataValidationById, getSheetName, onCommand, generatedNames, }: UseOnChangeProps<T, S>) => (sheetId: number, coords: CellInterface, value: string, textFormatRuns: TextFormatRun[] | undefined | null, previousValue?: string | boolean | undefined, isDirty?: boolean, previousTextFormatRuns?: TextFormatRun[] | undefined | null) => void;
+//# sourceMappingURL=use-on-change.d.ts.map

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

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