@rowsncolumns/spreadsheet 10.2.68

package/dist/cjs/hooks/use-editor-cancel.d.ts

@@ -0,0 +1,25 @@
+import type { CanvasGridProps } from "../components/canvas-grid/typings";
+import type { useSelection } from "./use-selection";
+type UseEditorCancelProps = {
+    /**
+     * Change sheet callback
+     */
+    onChangeActiveSheet: CanvasGridProps["onChangeActiveSheet"];
+    /**
+     * Current sheet id
+     */
+    sheetId: number;
+    /**
+     * Set active cell
+     * @param coords
+     * @param shouldScroll
+     */
+    setActiveCell: ReturnType<typeof useSelection>["setActiveCell"];
+    /**
+     * Oncomplete callback
+     */
+    onComplete?(): void;
+};
+export declare const useEditorCancel: ({ sheetId, onChangeActiveSheet, setActiveCell, onComplete, }: UseEditorCancelProps) => (e?: React.KeyboardEvent<HTMLElement>) => void;
+export {};
+//# sourceMappingURL=use-editor-cancel.d.ts.map

package/dist/cjs/hooks/use-editor-cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-editor-cancel.d.ts","sourceRoot":"","sources":["../../../hooks/use-editor-cancel.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,KAAK,oBAAoB,GAAG;IAC1B;;OAEG;IACH,mBAAmB,EAAE,eAAe,CAAC,qBAAqB,CAAC,CAAC;IAC5D;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,aAAa,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC;IAChE;;OAEG;IACH,UAAU,CAAC,IAAI,IAAI,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,8DAK7B,oBAAoB,UAKd,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,SA0CxC,CAAC"}

package/dist/cjs/hooks/use-editor-cancel.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useEditorCancel = void 0;
+var tslib_1 = require("tslib");
+var utils_1 = require("@rowsncolumns/utils");
+var react_1 = require("react");
+var active_editor_atom_1 = require("../atoms/active-editor.atom");
+var editing_cell_atom_1 = require("../atoms/editing-cell.atom");
+var formula_mode_atom_1 = require("../atoms/formula-mode.atom");
+var useEditorCancel = function (_a) {
+    var sheetId = _a.sheetId, onChangeActiveSheet = _a.onChangeActiveSheet, setActiveCell = _a.setActiveCell, onComplete = _a.onComplete;
+    var setFormulaMode = (0, formula_mode_atom_1.useSetFormulaMode)();
+    var _b = tslib_1.__read((0, editing_cell_atom_1.useEditingCell)(), 2), editingCellCoordinate = _b[0], setEditingCellCoordinate = _b[1];
+    var setActiveEditor = (0, active_editor_atom_1.useSetActiveEditor)();
+    return (0, react_1.useCallback)(function (e) {
+        if ((0, utils_1.isNil)(editingCellCoordinate)) {
+            return;
+        }
+        /**
+         * activeCell !== editingCell
+         * as user may have selected others cells
+         * while entering formulas
+         */
+        if ((e === null || e === void 0 ? void 0 : e.key) === "Escape") {
+            // Switch to active sheet
+            if (editingCellCoordinate.sheetId !== sheetId) {
+                onChangeActiveSheet === null || onChangeActiveSheet === void 0 ? void 0 : onChangeActiveSheet(editingCellCoordinate.sheetId);
+            }
+            // Set and scroll to active cell. onChangeActiveCell does not scroll
+            setActiveCell(editingCellCoordinate.sheetId, editingCellCoordinate);
+        }
+        /* Reset editing cell */
+        setEditingCellCoordinate(undefined);
+        // Reset editor
+        setActiveEditor(undefined);
+        /* Reset formula mode */
+        setFormulaMode(false);
+        // On complete callback
+        onComplete === null || onComplete === void 0 ? void 0 : onComplete();
+    }, [
+        setActiveCell,
+        setActiveEditor,
+        setFormulaMode,
+        editingCellCoordinate,
+        setEditingCellCoordinate,
+        sheetId,
+        onChangeActiveSheet,
+        onComplete,
+    ]);
+};
+exports.useEditorCancel = useEditorCancel;

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

@@ -0,0 +1,13 @@
+import { type CellInterface, type SelectionArea } from "@rowsncolumns/grid";
+import type { TextFormatRun } from "@rowsncolumns/ui";
+import type { CanvasGridProps, SelectionAttributes } from "../components/canvas-grid/typings";
+type UseEditorChangeProps = {
+    selections: SelectionArea<SelectionAttributes>[];
+    getSelectionsFromFormula(value: string, cell: CellInterface): SelectionArea<SelectionAttributes>[];
+    onChangeEditorValue: CanvasGridProps["onChangeEditorValue"];
+    onChangeSelections?: CanvasGridProps["onChangeSelections"];
+    onChangeActiveCell?: CanvasGridProps["onChangeActiveCell"];
+};
+export declare const useEditorChange: ({ selections, getSelectionsFromFormula, onChangeEditorValue, onChangeSelections, onChangeActiveCell, }: UseEditorChangeProps) => (value: string, textFormatRuns: TextFormatRun[] | undefined | null, editingSheetId: number, activeCell: CellInterface) => void;
+export {};
+//# sourceMappingURL=use-editor-change.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-editor-change.d.ts","sourceRoot":"","sources":["../../../hooks/use-editor-change.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AActD,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,mCAAmC,CAAC;AAG3C,KAAK,oBAAoB,GAAG;IAC1B,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACjD,wBAAwB,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,aAAa,GAClB,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACxC,mBAAmB,EAAE,eAAe,CAAC,qBAAqB,CAAC,CAAC;IAC5D,kBAAkB,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAC3D,kBAAkB,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;CAC5D,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,wGAM7B,oBAAoB,aASV,MAAM,kBACG,aAAa,EAAE,GAAG,SAAS,GAAG,IAAI,kBAClC,MAAM,cACV,aAAa,SA2D9B,CAAC"}

package/dist/cjs/hooks/use-editor-change.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useEditorChange = void 0;
+var grid_1 = require("@rowsncolumns/grid");
+var utils_1 = require("@rowsncolumns/utils");
+var react_1 = require("react");
+var atoms_1 = require("../atoms");
+var formula_bar_editor_value_atom_1 = require("../atoms/formula-bar-editor-value.atom");
+var formula_mode_atom_1 = require("../atoms/formula-mode.atom");
+var formula_selections_atom_1 = require("../atoms/formula-selections.atom");
+var config_1 = require("../config");
+var useEditorChange = function (_a) {
+    var selections = _a.selections, getSelectionsFromFormula = _a.getSelectionsFromFormula, onChangeEditorValue = _a.onChangeEditorValue, onChangeSelections = _a.onChangeSelections, onChangeActiveCell = _a.onChangeActiveCell;
+    var setFormulaMode = (0, formula_mode_atom_1.useSetFormulaMode)();
+    var setFormulaSelections = (0, formula_selections_atom_1.useSetFormulaSelections)();
+    var formulaSelections = (0, formula_selections_atom_1.useFormulaSelections)();
+    var setFormulaBarTextFormatRuns = (0, formula_bar_editor_value_atom_1.useSetFormulaBarTextFormatRuns)();
+    var setFormulabarEditorValue = (0, formula_bar_editor_value_atom_1.useSetFormulabarEditorValue)();
+    var editingCellCoordinate = (0, atoms_1.useEditingCellCoordinate)();
+    return (0, react_1.useCallback)(function (value, textFormatRuns, editingSheetId, activeCell) {
+        // Update value of formulabar
+        setFormulabarEditorValue(value);
+        setFormulaBarTextFormatRuns(textFormatRuns);
+        // Detect formulas
+        var isFormula = (0, utils_1.isAFormula)(value);
+        /**
+         * Explicitly set formula mode
+         * Formula mode can be set from
+         * 1. Cell Editor
+         * 2. Formula bar Editor
+         * 3. External cell editor
+         *
+         */
+        setFormulaMode(isFormula);
+        // Reset activeCell
+        var shouldResetActiveCell = isFormula
+            ? formulaSelections.length === 0
+            : editingCellCoordinate &&
+                (0, grid_1.isEqualCells)(editingCellCoordinate, activeCell);
+        /**
+         * Rethink this approach
+         */
+        if (isFormula) {
+            var selections_1 = getSelectionsFromFormula(value, activeCell);
+            setFormulaSelections === null || setFormulaSelections === void 0 ? void 0 : setFormulaSelections(selections_1);
+        }
+        else if (selections.length) {
+            // Clear selections
+            onChangeSelections === null || onChangeSelections === void 0 ? void 0 : onChangeSelections(editingSheetId, config_1.DEFAULT_ARRAY, true);
+        }
+        if (shouldResetActiveCell && editingCellCoordinate) {
+            onChangeActiveCell === null || onChangeActiveCell === void 0 ? void 0 : onChangeActiveCell(editingSheetId, editingCellCoordinate);
+        }
+        // Callback when editor value changes
+        if (onChangeEditorValue && activeCell) {
+            onChangeEditorValue(value, editingSheetId, activeCell);
+        }
+    }, [
+        selections,
+        editingCellCoordinate,
+        formulaSelections,
+        setFormulaMode,
+        getSelectionsFromFormula,
+        setFormulaSelections,
+        setFormulabarEditorValue,
+        setFormulaBarTextFormatRuns,
+        onChangeEditorValue,
+        onChangeSelections,
+        onChangeActiveCell,
+    ]);
+};
+exports.useEditorChange = useEditorChange;

package/dist/cjs/hooks/use-editor-keydown.d.ts

@@ -0,0 +1,11 @@
+import type React from "react";
+import type { CanvasGridProps } from "../components/canvas-grid/typings";
+type UseEditorKeydownProps = {
+    sheetId: number;
+    onSelectPreviousSheet: CanvasGridProps["onSelectPreviousSheet"];
+    onSelectNextSheet: CanvasGridProps["onSelectNextSheet"];
+    onKeyDownSelection?(e: React.KeyboardEvent<HTMLElement>): void;
+};
+export declare const useEditorKeydown: ({ sheetId, onSelectPreviousSheet, onSelectNextSheet, onKeyDownSelection, }: UseEditorKeydownProps) => (e: React.KeyboardEvent<HTMLDivElement>) => void;
+export {};
+//# sourceMappingURL=use-editor-keydown.d.ts.map

package/dist/cjs/hooks/use-editor-keydown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-editor-keydown.d.ts","sourceRoot":"","sources":["../../../hooks/use-editor-keydown.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGzE,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB,EAAE,eAAe,CAAC,uBAAuB,CAAC,CAAC;IAChE,iBAAiB,EAAE,eAAe,CAAC,mBAAmB,CAAC,CAAC;IACxD,kBAAkB,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;CAChE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,4EAK9B,qBAAqB,SAKd,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,SAuC5C,CAAC"}

package/dist/cjs/hooks/use-editor-keydown.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useEditorKeydown = void 0;
+var utils_1 = require("@rowsncolumns/utils");
+var react_1 = require("react");
+var formula_mode_atom_1 = require("../atoms/formula-mode.atom");
+var formula_selection_state_atom_1 = require("../atoms/formula-selection-state.atom");
+var use_callback_ref_1 = require("./use-callback-ref");
+var useEditorKeydown = function (_a) {
+    var sheetId = _a.sheetId, onSelectPreviousSheet = _a.onSelectPreviousSheet, onSelectNextSheet = _a.onSelectNextSheet, onKeyDownSelection = _a.onKeyDownSelection;
+    var formulaMode = (0, formula_mode_atom_1.useFormulaModeValue)();
+    var canSelectCells = (0, formula_selection_state_atom_1.useFormualSelectionState)().canSelectCells;
+    return (0, use_callback_ref_1.useCallbackRef)((0, react_1.useCallback)(function (e) {
+        var isAltKey = e.altKey;
+        var isArrowKey = (0, utils_1.isAnArrowKey)(e.key);
+        /**
+         * User can navigate between sheets
+         */
+        if (isAltKey && isArrowKey) {
+            switch (e.key) {
+                case "ArrowUp":
+                    onSelectPreviousSheet === null || onSelectPreviousSheet === void 0 ? void 0 : onSelectPreviousSheet(sheetId, e);
+                    break;
+                case "ArrowDown":
+                    onSelectNextSheet === null || onSelectNextSheet === void 0 ? void 0 : onSelectNextSheet(sheetId, e);
+                    break;
+            }
+            if (e.isDefaultPrevented()) {
+                return;
+            }
+        }
+        // Pass it on to use-selection hook
+        // for cell selection
+        // Check for newSelectionMode && canSelectCells?
+        if (formulaMode && canSelectCells && (0, utils_1.isAnArrowKey)(e.key)) {
+            onKeyDownSelection === null || onKeyDownSelection === void 0 ? void 0 : onKeyDownSelection(e);
+        }
+    }, [
+        sheetId,
+        onSelectPreviousSheet,
+        onSelectNextSheet,
+        formulaMode,
+        onKeyDownSelection,
+        canSelectCells,
+    ]));
+};
+exports.useEditorKeydown = useEditorKeydown;

package/dist/cjs/hooks/use-editor-submit.d.ts

@@ -0,0 +1,58 @@
+import type { DataValidationRuleAlert } from "@rowsncolumns/common-types";
+import type { CellInterface } from "@rowsncolumns/grid";
+import type { TextFormatRun } from "@rowsncolumns/ui";
+import type { ValidationAlertRequest } from "../atoms/validation-alert.atom";
+import type { CanvasGridProps } from "../components/canvas-grid/typings";
+import type { EditorSubmitOptions } from "./use-editable";
+import type { useSelection } from "./use-selection";
+/**
+ * Commit-time data-validation enforcement decision for a value about to be
+ * written. `block` rejects the value (Excel `errorStyle="stop"`); `confirm`
+ * lets the user override (`warning` / `information`).
+ */
+export type CommitValidation = {
+    decision: "block" | "confirm";
+    alert: DataValidationRuleAlert;
+};
+type UseEditorSubmitProps = {
+    /**
+     * Callback to change a sheet
+     */
+    onChangeActiveSheet: CanvasGridProps["onChangeActiveSheet"];
+    /**
+     * Current sheet id
+     */
+    sheetId: number;
+    /**
+     * Set active cell
+     * @param coords
+     * @param shouldScroll
+     */
+    setActiveCell: ReturnType<typeof useSelection>["setActiveCell"];
+    /**
+     * On change callback
+     * @param sheetId
+     * @param cell
+     * @param value
+     */
+    onChange: CanvasGridProps["onChange"];
+    /**
+     * Oncomplete callback
+     */
+    onComplete?(): void;
+    /**
+     * Resolve the data-validation enforcement decision for a value about to be
+     * committed at a cell. Returns `undefined` when there is nothing to enforce
+     * (no rule, no error alert, value valid, or a formula rule that can't be
+     * evaluated synchronously — those keep the flag-only red marker).
+     */
+    getCommitValidation?: (sheetId: number, rowIndex: number, columnIndex: number, value: string | boolean, previousValue: string | boolean | undefined | null) => CommitValidation | undefined;
+    /**
+     * Opens the blocking data-validation alert dialog. Resolves to `true` when
+     * the user chose to proceed (or acknowledged a `stop`), `false` to discard.
+     */
+    showValidationAlert?: (request: ValidationAlertRequest) => Promise<boolean>;
+};
+export declare const useEditorSubmit: ({ sheetId, onChangeActiveSheet, setActiveCell, onChange, onComplete, getCommitValidation, showValidationAlert, }: UseEditorSubmitProps) => (value: string | boolean, textFormatRuns: TextFormatRun[] | undefined | null, previousValue: string | boolean | undefined | null, editingSheetId: number, activeCell: CellInterface, nextActiveCell?: CellInterface | null, isDirty?: boolean, options?: EditorSubmitOptions) => Promise<void>;
+export {};
+//# sourceMappingURL=use-editor-submit.d.ts.map

package/dist/cjs/hooks/use-editor-submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-editor-submit.d.ts","sourceRoot":"","sources":["../../../hooks/use-editor-submit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE,uBAAuB,CAAC;CAChC,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B;;OAEG;IACH,mBAAmB,EAAE,eAAe,CAAC,qBAAqB,CAAC,CAAC;IAC5D;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,aAAa,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC;IAChE;;;;;OAKG;IACH,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IACtC;;OAEG;IACH,UAAU,CAAC,IAAI,IAAI,CAAC;IACpB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,CACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GAAG,OAAO,EACvB,aAAa,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,KAC/C,gBAAgB,GAAG,SAAS,CAAC;IAClC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7E,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,kHAQ7B,oBAAoB,aAMV,MAAM,GAAG,OAAO,kBACP,aAAa,EAAE,GAAG,SAAS,GAAG,IAAI,iBACnC,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,kBAClC,MAAM,cACV,aAAa,mBACR,aAAa,GAAG,IAAI,YAC3B,OAAO,YACP,mBAAmB,kBAgGlC,CAAC"}

package/dist/cjs/hooks/use-editor-submit.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useEditorSubmit = void 0;
+var tslib_1 = require("tslib");
+var utils_1 = require("@rowsncolumns/utils");
+var react_1 = require("react");
+var atoms_1 = require("../atoms");
+var editing_cell_atom_1 = require("../atoms/editing-cell.atom");
+var formula_mode_atom_1 = require("../atoms/formula-mode.atom");
+var useEditorSubmit = function (_a) {
+    var sheetId = _a.sheetId, onChangeActiveSheet = _a.onChangeActiveSheet, setActiveCell = _a.setActiveCell, onChange = _a.onChange, onComplete = _a.onComplete, getCommitValidation = _a.getCommitValidation, showValidationAlert = _a.showValidationAlert;
+    var _b = tslib_1.__read((0, formula_mode_atom_1.useFormulaMode)(), 2), formulaMode = _b[0], setFormulaMode = _b[1];
+    var _c = tslib_1.__read((0, editing_cell_atom_1.useEditingCell)(), 2), _ = _c[0], setEditingCellCoordinate = _c[1];
+    var setActiveEditor = (0, atoms_1.useSetActiveEditor)();
+    return (0, react_1.useCallback)(function (value, textFormatRuns, previousValue, editingSheetId, activeCell, nextActiveCell, isDirty, options) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+        var resetEditorState, commit, enforcement, decision, alert_1, request, proceed, _a;
+        var _b, _c;
+        return tslib_1.__generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    /* Balance parentheses */
+                    if (formulaMode && typeof value !== "boolean") {
+                        value = (0, utils_1.balanceFormula)(value);
+                    }
+                    resetEditorState = function () {
+                        setEditingCellCoordinate(undefined);
+                        setActiveEditor(undefined);
+                        setFormulaMode(false);
+                        onComplete === null || onComplete === void 0 ? void 0 : onComplete();
+                    };
+                    commit = function () {
+                        onChange === null || onChange === void 0 ? void 0 : onChange(editingSheetId, activeCell, value, textFormatRuns, previousValue, isDirty);
+                        // Switch to active sheet
+                        // Always change sheet first.
+                        // Skipped when the submit was triggered *by* a sheet change — the
+                        // value still lands on `editingSheetId`, but switching back would
+                        // undo the sheet the user just moved to.
+                        if (editingSheetId !== sheetId && !(options === null || options === void 0 ? void 0 : options.preserveActiveSheet)) {
+                            onChangeActiveSheet === null || onChangeActiveSheet === void 0 ? void 0 : onChangeActiveSheet(editingSheetId);
+                        }
+                        // Update and scroll to the new active cell
+                        if (nextActiveCell) {
+                            setActiveCell(editingSheetId, nextActiveCell);
+                        }
+                        resetEditorState();
+                    };
+                    if (!(value !== previousValue && getCommitValidation)) return [3 /*break*/, 4];
+                    enforcement = getCommitValidation(editingSheetId, activeCell.rowIndex, activeCell.columnIndex, value, previousValue);
+                    if (!enforcement) return [3 /*break*/, 4];
+                    decision = enforcement.decision, alert_1 = enforcement.alert;
+                    request = {
+                        style: alert_1.style,
+                        title: (_b = alert_1.message) === null || _b === void 0 ? void 0 : _b.title,
+                        message: (_c = alert_1.message) === null || _c === void 0 ? void 0 : _c.message,
+                        confirm: decision === "confirm",
+                    };
+                    if (decision === "block") {
+                        // `stop`: reject the value, keep the user on the cell.
+                        resetEditorState();
+                        void (showValidationAlert === null || showValidationAlert === void 0 ? void 0 : showValidationAlert(request));
+                        return [2 /*return*/];
+                    }
+                    if (!showValidationAlert) return [3 /*break*/, 2];
+                    return [4 /*yield*/, showValidationAlert(request)];
+                case 1:
+                    _a = _d.sent();
+                    return [3 /*break*/, 3];
+                case 2:
+                    _a = true;
+                    _d.label = 3;
+                case 3:
+                    proceed = _a;
+                    if (!proceed) {
+                        resetEditorState();
+                        return [2 /*return*/];
+                    }
+                    _d.label = 4;
+                case 4:
+                    commit();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, [
+        setActiveCell,
+        setActiveEditor,
+        setFormulaMode,
+        setEditingCellCoordinate,
+        formulaMode,
+        onChangeActiveSheet,
+        onChange,
+        onComplete,
+        sheetId,
+        getCommitValidation,
+        showValidationAlert,
+    ]);
+};
+exports.useEditorSubmit = useEditorSubmit;

package/dist/cjs/hooks/use-embeds-charts.d.ts

@@ -0,0 +1,193 @@
+import type { CellInterface, CellPosition, PosXYRequired } from "@rowsncolumns/grid";
+import React from "react";
+import type { CanvasGridProps, SpreadsheetTheme } from "../components/canvas-grid/typings";
+export type OverlayBounds = {
+    left?: number;
+    right?: number;
+    top?: number;
+    bottom?: number;
+};
+export type FrozenPanePlacement = "body" | "frozenRow" | "frozenColumn" | "intersection";
+export type CategorizedComponents<T> = {
+    body: T[];
+    frozenRow: T[];
+    frozenColumn: T[];
+    intersection: T[];
+};
+/**
+ * Get placement of an item based on anchor cell position
+ */
+export declare const getOverlayPlacement: (anchorCell: {
+    rowIndex: number;
+    columnIndex: number;
+} | undefined, frozenRows: number, frozenColumns: number) => FrozenPanePlacement;
+export type UseEmbedsChartsProps = {
+    /**
+     * Charts to be displayed
+     */
+    charts: CanvasGridProps["charts"];
+    /**
+     * Embeds to be displayed on a sheet
+     */
+    embeds: CanvasGridProps["embeds"];
+    /**
+     * Slicers to be displayed on a sheet
+     */
+    slicers: CanvasGridProps["slicers"];
+    /**
+     * Current sheetId
+     */
+    sheetId: number;
+    /**
+     * Number of frozen rows
+     */
+    frozenRows?: number;
+    /**
+     * Number of frozen columns
+     */
+    frozenColumns?: number;
+    /**
+     * Selector border color of sheet
+     */
+    selectedColor?: string;
+    /**
+     * Embed and Chart background color
+     */
+    backgroundColor?: string;
+    /**
+     * Readonly mode
+     */
+    readonly?: boolean;
+    /**
+     * Get chart component
+     */
+    getChartComponent: CanvasGridProps["getChartComponent"];
+    /**
+     * Get embed component
+     */
+    getEmbedComponent: CanvasGridProps["getEmbedComponent"];
+    /**
+     * Get slicer component
+     */
+    getSlicerComponent: CanvasGridProps["getSlicerComponent"];
+    /**
+     * Get absolute position (relative to document)
+     * cos `getCellCoordsFromOffset` accepts absolute offset
+     * @param x
+     * @param y
+     */
+    getAbsolutePositionFromOffset(x: number, y: number): PosXYRequired | undefined;
+    /**
+     * Get cell coords from offset
+     * @param x
+     * @param y
+     * @param includeFrozen
+     */
+    getCellCoordsFromOffset(x: number, y: number, includeFrozen?: boolean | undefined): CellInterface | null | undefined;
+    /**
+     * Get offset of a cel
+     * @param cell
+     */
+    getCellOffsetFromCoords(cell: CellInterface): CellPosition | undefined;
+    /**
+     * Get current scroll position
+     */
+    getScrollPosition(): {
+        scrollLeft: number;
+        scrollTop: number;
+    };
+    /**
+     * Get overlay bounds
+     */
+    getBounds(): OverlayBounds;
+    /**
+     * Callback when user resizes a chart
+     * @param width
+     * @param height
+     */
+    onResizeChart: CanvasGridProps["onResizeChart"];
+    /**
+     * User is trying to delete an embed
+     */
+    onDeleteChart: CanvasGridProps["onDeleteChart"];
+    /**
+     * Fired when user moves a chart
+     * @param anchorCell
+     * @param offsetXPixels
+     * @param offsetYPixels
+     */
+    onMoveChart: CanvasGridProps["onMoveChart"];
+    /**
+     * Callback when user resizes an embed
+     * @param width
+     * @param height
+     */
+    onResizeEmbed: CanvasGridProps["onResizeEmbed"];
+    /**
+     * User is trying to delete an embed
+     */
+    onDeleteEmbed: CanvasGridProps["onDeleteEmbed"];
+    /**
+     * User trying to edit embed
+     */
+    onRequestEditEmbed: CanvasGridProps["onRequestEditEmbed"];
+    /**
+     * Fired when user moves an embed
+     * @param anchorCell
+     * @param offsetXPixels
+     * @param offsetYPixels
+     */
+    onMoveEmbed: CanvasGridProps["onMoveEmbed"];
+    /**
+     * Callback when user resizes a slicer
+     */
+    onResizeSlicer: CanvasGridProps["onResizeSlicer"];
+    /**
+     * User is trying to delete a slicer
+     */
+    onDeleteSlicer: CanvasGridProps["onDeleteSlicer"];
+    /**
+     * User trying to edit slicer
+     */
+    onRequestEditSlicer: CanvasGridProps["onRequestEditSlicer"];
+    /**
+     * Fired when user moves a slicer
+     */
+    onMoveSlicer: CanvasGridProps["onMoveSlicer"];
+    /**
+     * Callback when user filters a table
+     */
+    onFilterTable: CanvasGridProps["onFilterTable"];
+    onFilterPivot: CanvasGridProps["onFilterPivot"];
+    /**
+     * Tables on the sheet
+     */
+    tables: CanvasGridProps["tables"];
+    /**
+     * Pivot tables on the sheet
+     */
+    pivotTables: CanvasGridProps["pivotTables"];
+    /**
+     * Get formatted value for a cell
+     */
+    getFormattedValue: CanvasGridProps["getFormattedValue"];
+    /**
+     * Theme of the sheet
+     */
+    theme: SpreadsheetTheme;
+    /**
+     * Sheet scale
+     */
+    scale?: number;
+    /**
+     * Disable embeds
+     */
+    disabled: boolean;
+};
+export declare const useEmbedsCharts: ({ scale, charts, embeds, slicers, sheetId, frozenRows, frozenColumns, getCellOffsetFromCoords, getCellCoordsFromOffset, getAbsolutePositionFromOffset, getBounds, selectedColor, onMoveChart, onResizeChart, onMoveEmbed, onResizeEmbed, onDeleteChart, onDeleteEmbed, onRequestEditEmbed, onMoveSlicer, onResizeSlicer, onDeleteSlicer, onRequestEditSlicer, onFilterTable, onFilterPivot, tables, pivotTables, getFormattedValue, getChartComponent, getEmbedComponent, getSlicerComponent, readonly, theme, backgroundColor, disabled, }: UseEmbedsChartsProps) => {
+    chartComponents: CategorizedComponents<React.JSX.Element>;
+    embedComponents: React.JSX.Element[];
+    slicerComponents: React.JSX.Element[];
+    onMouseDown: () => void;
+};
+//# sourceMappingURL=use-embeds-charts.d.ts.map

package/dist/cjs/hooks/use-embeds-charts.d.ts.map

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