@rowsncolumns/spreadsheet 10.2.68

package/dist/cjs/hooks/use-formula-range-helpers.d.ts

@@ -0,0 +1,21 @@
+import type { SheetRange } from "../types";
+type useFormulaRangeHelpersProps = {
+    sheetId: number;
+};
+export declare const useFormulaRangeHelpers: ({ sheetId, }: useFormulaRangeHelpersProps) => {
+    rangeToFormula: (dataRange?: SheetRange) => string;
+    formulaToRange: (formula: string) => {
+        sheetId: number | undefined;
+        startRowIndex: number;
+        endRowIndex: number;
+        startColumnIndex: number;
+        endColumnIndex: number;
+    } | undefined;
+    rangeToAddress: (dataRange?: SheetRange) => string;
+};
+export declare const useFormulaInputState: (sheetId: number, initialRange?: SheetRange | undefined) => {
+    value: string;
+    onChange: (value: string, onValidRange: (range: SheetRange) => void) => void;
+};
+export {};
+//# sourceMappingURL=use-formula-range-helpers.d.ts.map

package/dist/cjs/hooks/use-formula-range-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-formula-range-helpers.d.ts","sourceRoot":"","sources":["../../../hooks/use-formula-range-helpers.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,KAAK,2BAA2B,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,cAEpC,2BAA2B;iCASb,UAAU;8BAwBb,MAAM;;;;;;;iCAZH,UAAU;CA+B1B,CAAC;AAGF,eAAO,MAAM,oBAAoB,GAC/B,SAAS,MAAM,EACf,eAAe,UAAU,GAAG,SAAS;;sBAU3B,MAAM,gBAAgB,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI;CAc5D,CAAC"}

package/dist/cjs/hooks/use-formula-range-helpers.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFormulaInputState = exports.useFormulaRangeHelpers = void 0;
+var tslib_1 = require("tslib");
+var react_1 = require("react");
+var atoms_1 = require("../atoms");
+var useFormulaRangeHelpers = function (_a) {
+    var sheetId = _a.sheetId;
+    var getSelectionsFromFormula = (0, atoms_1.useGetSelectionsFromFormula)();
+    var getSheetId = (0, atoms_1.useGetSheetId)();
+    var getSheetName = (0, atoms_1.useGetSheetName)();
+    var getAddressFromSelection = (0, atoms_1.useGetAddressFromSelection)();
+    var getR1C1AddressFromSelection = (0, atoms_1.useGetR1C1AddressFromSelection)();
+    // Range to pure formula
+    var rangeToFormula = (0, react_1.useCallback)(function (dataRange) {
+        if (!dataRange) {
+            return "=";
+        }
+        var sheetName = getSheetName === null || getSheetName === void 0 ? void 0 : getSheetName(dataRange === null || dataRange === void 0 ? void 0 : dataRange.sheetId);
+        return "=" + (getAddressFromSelection === null || getAddressFromSelection === void 0 ? void 0 : getAddressFromSelection({ range: dataRange }, sheetName));
+    }, [getSheetName, getAddressFromSelection]);
+    // Range to r1c1 address
+    var rangeToAddress = (0, react_1.useCallback)(function (dataRange) {
+        var _a;
+        if (!dataRange) {
+            return "=";
+        }
+        var sheetName = getSheetName === null || getSheetName === void 0 ? void 0 : getSheetName(dataRange === null || dataRange === void 0 ? void 0 : dataRange.sheetId);
+        return (_a = getR1C1AddressFromSelection === null || getR1C1AddressFromSelection === void 0 ? void 0 : getR1C1AddressFromSelection(dataRange, sheetName)) !== null && _a !== void 0 ? _a : "=";
+    }, [getSheetName, getR1C1AddressFromSelection]);
+    // Formula to range
+    var formulaToRange = (0, react_1.useCallback)(function (formula) {
+        var selections = getSelectionsFromFormula === null || getSelectionsFromFormula === void 0 ? void 0 : getSelectionsFromFormula(formula);
+        if (!selections || !selections.length) {
+            return undefined;
+        }
+        var _a = selections[selections.length - 1], range = _a.range, sheetName = _a.sheetName;
+        return tslib_1.__assign(tslib_1.__assign({}, range), { sheetId: sheetName ? getSheetId === null || getSheetId === void 0 ? void 0 : getSheetId(sheetName) : sheetId });
+    }, [sheetId, getSelectionsFromFormula, getSheetId]);
+    return {
+        rangeToFormula: rangeToFormula,
+        formulaToRange: formulaToRange,
+        rangeToAddress: rangeToAddress,
+    };
+};
+exports.useFormulaRangeHelpers = useFormulaRangeHelpers;
+// Hook to manage formula input state safely
+var useFormulaInputState = function (sheetId, initialRange) {
+    var _a = (0, exports.useFormulaRangeHelpers)({
+        sheetId: sheetId,
+    }), rangeToFormula = _a.rangeToFormula, formulaToRange = _a.formulaToRange;
+    var _b = tslib_1.__read((0, react_1.useState)(function () {
+        return rangeToFormula(initialRange);
+    }), 2), rawFormula = _b[0], setRawFormula = _b[1];
+    var handleChange = (0, react_1.useCallback)(function (value, onValidRange) {
+        setRawFormula(value);
+        var parsed = formulaToRange(value);
+        if (parsed !== undefined && parsed.sheetId !== undefined) {
+            onValidRange(parsed);
+        }
+    }, [formulaToRange]);
+    return {
+        value: rawFormula,
+        onChange: handleChange,
+    };
+};
+exports.useFormulaInputState = useFormulaInputState;

package/dist/cjs/hooks/use-get-tooltip.d.ts

@@ -0,0 +1,52 @@
+import type { ElementType, ReactNode } from "react";
+import React from "react";
+import type { CellTooltipProps } from "../components/cell-tooltip";
+import type { CellData, ErrorValue } from "../types";
+type UseGetTooltipProps<T extends CellData> = {
+    sheetId: number;
+    /**
+     * Get hyperlink of a cell
+     * @param rowIndex
+     * @param columnIndex
+     */
+    getHyperlink(sheetId: number, rowIndex: number, columnIndex: number): T["hyperlink"] | undefined;
+    /**
+     * Get display value of a cell
+     * @param rowIndex
+     * @param columnIndex
+     */
+    getFormattedValue(sheetId: number, rowIndex: number, columnIndex: number): string | undefined;
+    /**
+     * Get error value of a cell
+     * @param rowIndex
+     * @param columnIndex
+     */
+    getErrorValue(sheetId: number, rowIndex: number, columnIndex: number): ErrorValue | undefined;
+    /**
+     * Get notes
+     */
+    getNote: (sheetId: number, rowIndex: number, columnIndex: number) => string | undefined;
+    /**
+     * Get custom tooltip content for a cell
+     * @param sheetId
+     * @param rowIndex
+     * @param columnIndex
+     * @returns ReactNode (component) or string content for the tooltip
+     */
+    getTooltipContent?: (sheetId: number, rowIndex: number, columnIndex: number) => ReactNode | string | undefined;
+    /**
+     * Optional error resolution component for a cell
+     */
+    errorResolutionComponent?: (sheetId: number, rowIndex: number, columnIndex: number) => ReactNode;
+    /**
+     * Cell tooltip element
+     */
+    CellTooltip?: ElementType<CellTooltipProps>;
+    /**
+     * Show notes as tooltip
+     */
+    showNotes?: boolean;
+};
+export declare const useGetTooltip: <T extends CellData>({ getHyperlink, getErrorValue, getFormattedValue, getNote, getTooltipContent, errorResolutionComponent, sheetId, showNotes, CellTooltip, }: UseGetTooltipProps<T>) => ({ cell, noteEditorCell, x, y, width, height, scrollLeft, scrollTop, onRemoveLink, onSelectLink, onRequestShowNote, onRequestCloseNote, onRequestUpdateNote, onRequestPinTooltip, onRequestUnpinTooltip, }: CellTooltipProps) => React.JSX.Element | null;
+export {};
+//# sourceMappingURL=use-get-tooltip.d.ts.map

package/dist/cjs/hooks/use-get-tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-get-tooltip.d.ts","sourceRoot":"","sources":["../../../hooks/use-get-tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,KAAsB,MAAM,OAAO,CAAC;AAE3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGrD,KAAK,kBAAkB,CAAC,CAAC,SAAS,QAAQ,IAAI;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,YAAY,CACV,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,CAAC,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IAC9B;;;;OAIG;IACH,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAAC;IACtB;;;;OAIG;IACH,aAAa,CACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,UAAU,GAAG,SAAS,CAAC;IAC1B;;OAEG;IACH,OAAO,EAAE,CACP,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,CAAC;IACxB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,CAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC;;OAEG;IACH,wBAAwB,CAAC,EAAE,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,SAAS,CAAC;IACf;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAC5C;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,QAAQ,EAAE,4IAU/C,kBAAkB,CAAC,CAAC,CAAC,iNAmBf,gBAAgB,6BA4GxB,CAAC"}

package/dist/cjs/hooks/use-get-tooltip.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useGetTooltip = void 0;
+var tslib_1 = require("tslib");
+var react_1 = tslib_1.__importStar(require("react"));
+var cell_tooltip_1 = require("../components/cell-tooltip");
+var helpers_1 = require("../helpers");
+var use_callback_ref_1 = require("./use-callback-ref");
+var useGetTooltip = function (_a) {
+    var getHyperlink = _a.getHyperlink, getErrorValue = _a.getErrorValue, getFormattedValue = _a.getFormattedValue, getNote = _a.getNote, getTooltipContent = _a.getTooltipContent, errorResolutionComponent = _a.errorResolutionComponent, sheetId = _a.sheetId, showNotes = _a.showNotes, CellTooltip = _a.CellTooltip;
+    return (0, use_callback_ref_1.useCallbackRef)((0, react_1.useCallback)(function (_a) {
+        var cell = _a.cell, noteEditorCell = _a.noteEditorCell, x = _a.x, y = _a.y, width = _a.width, height = _a.height, scrollLeft = _a.scrollLeft, scrollTop = _a.scrollTop, onRemoveLink = _a.onRemoveLink, onSelectLink = _a.onSelectLink, onRequestShowNote = _a.onRequestShowNote, onRequestCloseNote = _a.onRequestCloseNote, onRequestUpdateNote = _a.onRequestUpdateNote, onRequestPinTooltip = _a.onRequestPinTooltip, onRequestUnpinTooltip = _a.onRequestUnpinTooltip;
+        if (!cell) {
+            return null;
+        }
+        var rowIndex = cell.rowIndex, columnIndex = cell.columnIndex;
+        // Hyperlink
+        var hyperlink = getHyperlink(sheetId, rowIndex, columnIndex);
+        // Is Link
+        var isHyperlink = Boolean(hyperlink);
+        // Notes
+        var note = showNotes
+            ? getNote(sheetId, rowIndex, columnIndex)
+            : undefined;
+        // Custom tooltip content
+        var customTooltipContent = getTooltipContent === null || getTooltipContent === void 0 ? void 0 : getTooltipContent(sheetId, rowIndex, columnIndex);
+        // Data validation errors (Invalid icon)
+        var errorValue = getErrorValue(sheetId, rowIndex, columnIndex);
+        var isInvalid = (errorValue === null || errorValue === void 0 ? void 0 : errorValue.type) === "Invalid";
+        // Error from formula calculation (Error icon)
+        var isError = (errorValue === null || errorValue === void 0 ? void 0 : errorValue.type) === "Error";
+        // TooltipElement
+        var TooltipElement = CellTooltip !== null && CellTooltip !== void 0 ? CellTooltip : cell_tooltip_1.CellTooltip;
+        if (!isError &&
+            !isInvalid &&
+            !isHyperlink &&
+            !note &&
+            !noteEditorCell &&
+            !customTooltipContent) {
+            return null;
+        }
+        // Check if we are rendering notes
+        // Error has precedence
+        var variant = (0, helpers_1.getTooltipVariant)(isError, isInvalid, isHyperlink, noteEditorCell ? true : !!note, customTooltipContent ? true : false);
+        // Content
+        var content = isError || isInvalid ? errorValue.message : undefined;
+        // Title
+        var title = isHyperlink
+            ? getFormattedValue(sheetId, rowIndex, columnIndex)
+            : undefined;
+        return (react_1.default.createElement(TooltipElement, { hyperlink: hyperlink, onRemoveLink: onRemoveLink, onSelectLink: onSelectLink, content: content, customContent: customTooltipContent, errorResolutionComponent: errorResolutionComponent, title: title, note: note, variant: variant, position: isHyperlink || customTooltipContent ? "bottom" : undefined, cell: cell, x: x, y: y, sheetId: sheetId, height: height, width: width, scrollLeft: scrollLeft, scrollTop: scrollTop, onRequestShowNote: onRequestShowNote, onRequestCloseNote: onRequestCloseNote, onRequestUpdateNote: onRequestUpdateNote, noteEditorCell: noteEditorCell, onRequestPinTooltip: onRequestPinTooltip, onRequestUnpinTooltip: onRequestUnpinTooltip }));
+    }, [
+        getErrorValue,
+        getFormattedValue,
+        getHyperlink,
+        getNote,
+        getTooltipContent,
+        errorResolutionComponent,
+        sheetId,
+        showNotes,
+        CellTooltip,
+    ]));
+};
+exports.useGetTooltip = useGetTooltip;

package/dist/cjs/hooks/use-get-values-from-range.d.ts

@@ -0,0 +1,44 @@
+import type { SelectionArea } from "@rowsncolumns/grid";
+import type { CanvasGridProps, SelectionAttributes } from "../components/canvas-grid/typings";
+import type { CellData, ConditionalFormatRule, ConditionValue, CustomFormulaResult } from "../types";
+type UseGetValuesFromRangeProps<T extends CellData> = {
+    sheetId: number;
+    /**
+     * Get formatted string values. Works for both formulas and cells
+     * @param rowIndex
+     * @param columnIndex
+     */
+    getFormattedValue(sheetId: number, rowIndex: number, columnIndex: number): string | undefined;
+    /**
+     * Get validation effective value from sheet
+     * @param sheetId
+     * @param rowIndex
+     * @param columnIndex
+     * @returns
+     */
+    getValidationValue: (sheetId: number, rowIndex: number, columnIndex: number, rule?: ConditionalFormatRule) => CustomFormulaResult;
+    /**
+     * Get grid selections from an address
+     * @param address
+     */
+    getSelectionsFromFormula(address: string): SelectionArea<SelectionAttributes>[];
+    /**
+     * Get sheet id from a sheet name
+     */
+    getSheetId: CanvasGridProps["getSheetId"];
+    onRequestCalculate?: CanvasGridProps["onRequestCalculate"];
+    /**
+     * Optional full-store per-cell reader for validation source ranges — see
+     * `CanvasGridProps["getValidationSourceValue"]`. Defaults to `getFormattedValue`.
+     */
+    getValidationSourceValue?: CanvasGridProps["getValidationSourceValue"];
+};
+/**
+ * Get all user entered values from a range
+ * used in data validation
+ * @param param0
+ * @returns
+ */
+export declare const useGetValuesFromRange: <T extends CellData>({ sheetId, getFormattedValue, getValidationValue, getSheetId, getSelectionsFromFormula, onRequestCalculate, getValidationSourceValue, }: UseGetValuesFromRangeProps<T>) => readonly [(address: string) => ConditionValue[], (address: string) => ConditionValue[], (address: string, rowIndex: number, columnIndex: number, targetSheetId?: number) => Promise<ConditionValue[]>];
+export {};
+//# sourceMappingURL=use-get-values-from-range.d.ts.map

package/dist/cjs/hooks/use-get-values-from-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-get-values-from-range.d.ts","sourceRoot":"","sources":["../../../hooks/use-get-values-from-range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,QAAQ,EACR,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAGlB,KAAK,0BAA0B,CAAC,CAAC,SAAS,QAAQ,IAAI;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAAC;IACtB;;;;;;OAMG;IACH,kBAAkB,EAAE,CAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,qBAAqB,KACzB,mBAAmB,CAAC;IACzB;;;OAGG;IACH,wBAAwB,CACtB,OAAO,EAAE,MAAM,GACd,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACxC;;OAEG;IACH,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC1C,kBAAkB,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAC3D;;;OAGG;IACH,wBAAwB,CAAC,EAAE,eAAe,CAAC,0BAA0B,CAAC,CAAC;CACxE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EAAE,yIAQvD,0BAA0B,CAAC,CAAC,CAAC,yBAqDhB,MAAM,KAAG,cAAc,EAAE,YASzB,MAAM,KAAG,cAAc,EAAE,YAUxB,MAAM,YACL,MAAM,eACH,MAAM,kBACJ,MAAM,KACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CA4EjC,CAAC"}

package/dist/cjs/hooks/use-get-values-from-range.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useGetValuesFromRange = void 0;
+var tslib_1 = require("tslib");
+var utils_1 = require("@rowsncolumns/utils");
+var react_1 = require("react");
+var use_callback_ref_1 = require("./use-callback-ref");
+/**
+ * Get all user entered values from a range
+ * used in data validation
+ * @param param0
+ * @returns
+ */
+var useGetValuesFromRange = function (_a) {
+    var sheetId = _a.sheetId, getFormattedValue = _a.getFormattedValue, getValidationValue = _a.getValidationValue, getSheetId = _a.getSheetId, getSelectionsFromFormula = _a.getSelectionsFromFormula, onRequestCalculate = _a.onRequestCalculate, getValidationSourceValue = _a.getValidationSourceValue;
+    // Windowed hosts supply an off-window-safe reader for validation source ranges
+    // (dropdown options + commit checks) — the plain `getFormattedValue` only sees the
+    // loaded viewport there. Defaults to `getFormattedValue`.
+    var readSourceValue = getValidationSourceValue !== null && getValidationSourceValue !== void 0 ? getValidationSourceValue : getFormattedValue;
+    var getValuesFromRange = (0, react_1.useCallback)(function (address, callback) {
+        var e_1, _a, e_2, _b;
+        var _c;
+        var selections = getSelectionsFromFormula(address);
+        var userEnteredValues = new Map();
+        try {
+            for (var selections_1 = tslib_1.__values(selections), selections_1_1 = selections_1.next(); !selections_1_1.done; selections_1_1 = selections_1.next()) {
+                var selection = selections_1_1.value;
+                var _d = selection.range, startRowIndex = _d.startRowIndex, startColumnIndex = _d.startColumnIndex, endRowIndex = _d.endRowIndex, endColumnIndex = _d.endColumnIndex, sheetName = selection.sheetName;
+                var selectedSheetId = sheetName
+                    ? (_c = getSheetId === null || getSheetId === void 0 ? void 0 : getSheetId(sheetName)) !== null && _c !== void 0 ? _c : sheetId
+                    : sheetId;
+                try {
+                    for (var _e = (e_2 = void 0, tslib_1.__values((0, utils_1.iterateCells)(startRowIndex, endColumnIndex, endRowIndex, startColumnIndex))), _f = _e.next(); !_f.done; _f = _e.next()) {
+                        var _g = tslib_1.__read(_f.value, 2), rowIndex = _g[0], columnIndex = _g[1];
+                        var userEnteredValue = callback(selectedSheetId, rowIndex, columnIndex);
+                        if (userEnteredValue) {
+                            userEnteredValues.set(userEnteredValue, {
+                                userEnteredValue: userEnteredValue,
+                            });
+                        }
+                    }
+                }
+                catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                finally {
+                    try {
+                        if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
+                    }
+                    finally { if (e_2) throw e_2.error; }
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (selections_1_1 && !selections_1_1.done && (_a = selections_1.return)) _a.call(selections_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return userEnteredValues;
+    }, [getSelectionsFromFormula, getSheetId, sheetId]);
+    /**
+     * Get formatted user entered values
+     */
+    var getFormattedValuesFromRange = (0, use_callback_ref_1.useCallbackRef)((0, react_1.useCallback)(function (address) {
+        return tslib_1.__spreadArray([], tslib_1.__read(getValuesFromRange(address, readSourceValue).values()), false);
+    }, [readSourceValue, getValuesFromRange]));
+    var getEffectiveValuesFromRange = (0, use_callback_ref_1.useCallbackRef)((0, react_1.useCallback)(function (address) {
+        return tslib_1.__spreadArray([], tslib_1.__read(getValuesFromRange(address, getValidationValue).values()), false);
+    }, [getValidationValue, getValuesFromRange]));
+    var getFormattedValuesFromRangeAsync = (0, use_callback_ref_1.useCallbackRef)((0, react_1.useCallback)(function (address_1, rowIndex_1, columnIndex_1) {
+        var args_1 = [];
+        for (var _i = 3; _i < arguments.length; _i++) {
+            args_1[_i - 3] = arguments[_i];
+        }
+        return tslib_1.__awaiter(void 0, tslib_1.__spreadArray([address_1, rowIndex_1, columnIndex_1], tslib_1.__read(args_1), false), void 0, function (address, rowIndex, columnIndex, targetSheetId) {
+            var trimmedAddress, isFormula, formulaBody, hasDirectReference, shouldCalc, selections, result, userEnteredValues, pushValue, result_1, result_1_1, row, row_1, row_1_1, entry, result_2, result_2_1, entry;
+            var e_3, _a, e_4, _b, e_5, _c;
+            var _d;
+            if (targetSheetId === void 0) { targetSheetId = sheetId; }
+            return tslib_1.__generator(this, function (_e) {
+                switch (_e.label) {
+                    case 0:
+                        trimmedAddress = (_d = address === null || address === void 0 ? void 0 : address.trim()) !== null && _d !== void 0 ? _d : "";
+                        isFormula = trimmedAddress.startsWith("=");
+                        formulaBody = isFormula ? trimmedAddress.slice(1) : trimmedAddress;
+                        hasDirectReference = (0, utils_1.checkIfStringIsReference)(formulaBody);
+                        shouldCalc = isFormula &&
+                            /(OFFSET|INDIRECT|FILTER|UNIQUE|SORT|SEQUENCE)\s*\(/i.test(formulaBody);
+                        if (!onRequestCalculate || !shouldCalc) {
+                            selections = getSelectionsFromFormula(address);
+                            if (hasDirectReference || selections.length) {
+                                return [2 /*return*/, tslib_1.__spreadArray([], tslib_1.__read(getValuesFromRange(address, readSourceValue).values()), false)];
+                            }
+                            return [2 /*return*/, []];
+                        }
+                        return [4 /*yield*/, onRequestCalculate(trimmedAddress, targetSheetId, rowIndex, columnIndex, { isArray: true, disablePreview: true })];
+                    case 1:
+                        result = _e.sent();
+                        userEnteredValues = new Map();
+                        pushValue = function (value) {
+                            var e_6, _a;
+                            if (value === null || value === undefined) {
+                                return;
+                            }
+                            if (Array.isArray(value)) {
+                                try {
+                                    for (var value_1 = tslib_1.__values(value), value_1_1 = value_1.next(); !value_1_1.done; value_1_1 = value_1.next()) {
+                                        var entry = value_1_1.value;
+                                        pushValue(entry);
+                                    }
+                                }
+                                catch (e_6_1) { e_6 = { error: e_6_1 }; }
+                                finally {
+                                    try {
+                                        if (value_1_1 && !value_1_1.done && (_a = value_1.return)) _a.call(value_1);
+                                    }
+                                    finally { if (e_6) throw e_6.error; }
+                                }
+                                return;
+                            }
+                            var userEnteredValue = value instanceof Date
+                                ? value.toISOString()
+                                : typeof value === "boolean"
+                                    ? value
+                                        ? "TRUE"
+                                        : "FALSE"
+                                    : String(value);
+                            userEnteredValues.set(userEnteredValue, { userEnteredValue: userEnteredValue });
+                        };
+                        if (Array.isArray(result)) {
+                            if (Array.isArray(result[0])) {
+                                try {
+                                    for (result_1 = tslib_1.__values(result), result_1_1 = result_1.next(); !result_1_1.done; result_1_1 = result_1.next()) {
+                                        row = result_1_1.value;
+                                        try {
+                                            for (row_1 = (e_4 = void 0, tslib_1.__values(row)), row_1_1 = row_1.next(); !row_1_1.done; row_1_1 = row_1.next()) {
+                                                entry = row_1_1.value;
+                                                pushValue(entry);
+                                            }
+                                        }
+                                        catch (e_4_1) { e_4 = { error: e_4_1 }; }
+                                        finally {
+                                            try {
+                                                if (row_1_1 && !row_1_1.done && (_b = row_1.return)) _b.call(row_1);
+                                            }
+                                            finally { if (e_4) throw e_4.error; }
+                                        }
+                                    }
+                                }
+                                catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                                finally {
+                                    try {
+                                        if (result_1_1 && !result_1_1.done && (_a = result_1.return)) _a.call(result_1);
+                                    }
+                                    finally { if (e_3) throw e_3.error; }
+                                }
+                            }
+                            else {
+                                try {
+                                    for (result_2 = tslib_1.__values(result), result_2_1 = result_2.next(); !result_2_1.done; result_2_1 = result_2.next()) {
+                                        entry = result_2_1.value;
+                                        pushValue(entry);
+                                    }
+                                }
+                                catch (e_5_1) { e_5 = { error: e_5_1 }; }
+                                finally {
+                                    try {
+                                        if (result_2_1 && !result_2_1.done && (_c = result_2.return)) _c.call(result_2);
+                                    }
+                                    finally { if (e_5) throw e_5.error; }
+                                }
+                            }
+                        }
+                        else {
+                            pushValue(result);
+                        }
+                        return [2 /*return*/, tslib_1.__spreadArray([], tslib_1.__read(userEnteredValues.values()), false)];
+                }
+            });
+        });
+    }, [
+        readSourceValue,
+        getSelectionsFromFormula,
+        getValuesFromRange,
+        onRequestCalculate,
+        sheetId,
+    ]));
+    return [
+        getFormattedValuesFromRange,
+        getEffectiveValuesFromRange,
+        getFormattedValuesFromRangeAsync,
+    ];
+};
+exports.useGetValuesFromRange = useGetValuesFromRange;

package/dist/cjs/hooks/use-grid-children.d.ts

@@ -0,0 +1,31 @@
+import type { GridChildrenProps } from "@rowsncolumns/grid";
+import React from "react";
+import type { SheetCoordinate, SheetRange } from "../types";
+import type { useEmbedsCharts } from "./use-embeds-charts";
+type UseGridChildrenProps = {
+    stickyEditor?: boolean;
+    editorComponent: React.ReactElement | null;
+    chartComponents: ReturnType<typeof useEmbedsCharts>["chartComponents"];
+    embedComponents: React.JSX.Element[] | null | undefined;
+    slicerComponents: React.JSX.Element[] | null | undefined;
+    pivotPlaceholders: React.JSX.Element[] | null | undefined;
+    tableResizers: React.JSX.Element[] | null | undefined;
+    hiddenColumnMarkers: React.JSX.Element | null | undefined;
+    frozenHiddenColumnMarkers: React.JSX.Element | null | undefined;
+    hiddenRowMarkers: React.JSX.Element | null | undefined;
+    frozenHiddenRowMarkers: React.JSX.Element | null | undefined;
+    headerMenuComponent: React.JSX.Element | null | undefined;
+    isHeaderMenuInFrozenColumn?: boolean;
+    popoverComponent: React.JSX.Element | null | undefined;
+    cellExpandComponent: React.JSX.Element | null | undefined;
+    popoverRange?: SheetRange | SheetCoordinate;
+    gridLineWidth?: number;
+    frozenColumns: number;
+    frozenRows: number;
+};
+export declare const useGridChildren: ({ stickyEditor, editorComponent, chartComponents, embedComponents, slicerComponents, pivotPlaceholders, tableResizers, hiddenColumnMarkers, frozenHiddenColumnMarkers, hiddenRowMarkers, frozenHiddenRowMarkers, gridLineWidth, frozenColumns, frozenRows, headerMenuComponent, isHeaderMenuInFrozenColumn, popoverRange, popoverComponent, cellExpandComponent, }: UseGridChildrenProps) => (props: GridChildrenProps) => React.JSX.Element;
+export declare const StyledGridChildren: ({ className, elevate, ...props }: React.HTMLAttributes<HTMLDivElement> & {
+    elevate?: boolean;
+}) => React.JSX.Element;
+export {};
+//# sourceMappingURL=use-grid-children.d.ts.map

package/dist/cjs/hooks/use-grid-children.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-grid-children.d.ts","sourceRoot":"","sources":["../../../hooks/use-grid-children.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAsB,MAAM,OAAO,CAAC;AAI3C,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,KAAK,oBAAoB,GAAG;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3C,eAAe,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACvE,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IACxD,gBAAgB,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IACzD,iBAAiB,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1D,aAAa,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD,mBAAmB,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1D,yBAAyB,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAChE,gBAAgB,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IACvD,sBAAsB,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAC7D,mBAAmB,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1D,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,gBAAgB,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IACvD,mBAAmB,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1D,YAAY,CAAC,EAAE,UAAU,GAAG,eAAe,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,oWAoB7B,oBAAoB,aAiBX,iBAAiB,sBAmI5B,CAAC;AA+BF,eAAO,MAAM,kBAAkB,GAAI,kCAIhC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,sBAS9D,CAAC"}

package/dist/cjs/hooks/use-grid-children.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StyledGridChildren = exports.useGridChildren = void 0;
+var tslib_1 = require("tslib");
+var ui_1 = require("@rowsncolumns/ui");
+var react_1 = tslib_1.__importStar(require("react"));
+var atoms_1 = require("../atoms");
+var helpers_1 = require("../helpers");
+var useGridChildren = function (_a) {
+    var stickyEditor = _a.stickyEditor, editorComponent = _a.editorComponent, chartComponents = _a.chartComponents, embedComponents = _a.embedComponents, slicerComponents = _a.slicerComponents, pivotPlaceholders = _a.pivotPlaceholders, tableResizers = _a.tableResizers, hiddenColumnMarkers = _a.hiddenColumnMarkers, frozenHiddenColumnMarkers = _a.frozenHiddenColumnMarkers, hiddenRowMarkers = _a.hiddenRowMarkers, frozenHiddenRowMarkers = _a.frozenHiddenRowMarkers, _b = _a.gridLineWidth, gridLineWidth = _b === void 0 ? 1 : _b, frozenColumns = _a.frozenColumns, frozenRows = _a.frozenRows, headerMenuComponent = _a.headerMenuComponent, isHeaderMenuInFrozenColumn = _a.isHeaderMenuInFrozenColumn, popoverRange = _a.popoverRange, popoverComponent = _a.popoverComponent, cellExpandComponent = _a.cellExpandComponent;
+    var editingCellCoordinate = (0, atoms_1.useEditingCellCoordinate)();
+    // Quite a bit of logic for non sticky editor
+    // Remove if majority dont use this
+    var stickyEditorPlacement = getCellPlacement(editingCellCoordinate, frozenRows, frozenColumns);
+    // Popover placement
+    var popoverPlacement = getCellPlacement(popoverRange, frozenRows, frozenColumns);
+    return (0, react_1.useCallback)(function (props) {
+        var frozenRowHeight = props.frozenRowHeight, frozenColumnWidth = props.frozenColumnWidth, scrollLeft = props.scrollLeft, scrollTop = props.scrollTop;
+        return (react_1.default.createElement(react_1.default.Fragment, null,
+            react_1.default.createElement(exports.StyledGridChildren, { elevate: true, style: {
+                    top: 0,
+                    // Menus on scrollable column headers are clipped at the frozen
+                    // boundary so they don't overlap frozen column headers
+                    left: isHeaderMenuInFrozenColumn ? 0 : frozenColumnWidth,
+                    height: frozenRowHeight + gridLineWidth,
+                } },
+                react_1.default.createElement("div", { style: {
+                        // Frozen column headers do not move with horizontal scroll
+                        transform: isHeaderMenuInFrozenColumn
+                            ? undefined
+                            : "translate(-".concat(scrollLeft + frozenColumnWidth, "px, 0)"),
+                        pointerEvents: "all",
+                    } }, headerMenuComponent)),
+            react_1.default.createElement(exports.StyledGridChildren, { style: {
+                    top: frozenRowHeight + gridLineWidth,
+                    left: frozenColumnWidth + gridLineWidth,
+                } },
+                react_1.default.createElement("div", { style: {
+                        transform: "translate(-".concat(scrollLeft + frozenColumnWidth, "px, -").concat(scrollTop + frozenRowHeight, "px)"),
+                    } },
+                    tableResizers,
+                    !stickyEditor && stickyEditorPlacement === "body"
+                        ? editorComponent
+                        : null,
+                    chartComponents.body,
+                    embedComponents,
+                    slicerComponents,
+                    pivotPlaceholders,
+                    popoverPlacement === "body" ? popoverComponent : null,
+                    cellExpandComponent)),
+            react_1.default.createElement(exports.StyledGridChildren, { style: {
+                    left: frozenColumnWidth + gridLineWidth,
+                } },
+                react_1.default.createElement("div", { 
+                    // className="relative z-[1]"
+                    style: {
+                        transform: "translate(-".concat(scrollLeft + frozenColumnWidth, "px, 0"),
+                    } },
+                    !stickyEditor && stickyEditorPlacement === "row"
+                        ? editorComponent
+                        : null,
+                    hiddenColumnMarkers,
+                    chartComponents.frozenRow,
+                    popoverPlacement === "row" ? popoverComponent : null)),
+            react_1.default.createElement(exports.StyledGridChildren, { style: {
+                    top: frozenRowHeight + gridLineWidth,
+                } },
+                react_1.default.createElement("div", { 
+                    // className="relative z-[1]"/
+                    style: {
+                        transform: "translate(0, -".concat(scrollTop + frozenRowHeight, "px)"),
+                    } },
+                    !stickyEditor && stickyEditorPlacement === "column"
+                        ? editorComponent
+                        : null,
+                    hiddenRowMarkers,
+                    chartComponents.frozenColumn,
+                    popoverPlacement === "column" ? popoverComponent : null)),
+            react_1.default.createElement(exports.StyledGridChildren, null,
+                !stickyEditor && stickyEditorPlacement === "intersection"
+                    ? editorComponent
+                    : null,
+                frozenHiddenColumnMarkers,
+                frozenHiddenRowMarkers,
+                chartComponents.intersection,
+                popoverPlacement === "intersection" ? popoverComponent : null)));
+    }, [
+        editorComponent,
+        stickyEditor,
+        hiddenColumnMarkers,
+        hiddenRowMarkers,
+        frozenHiddenColumnMarkers,
+        frozenHiddenRowMarkers,
+        chartComponents,
+        embedComponents,
+        slicerComponents,
+        pivotPlaceholders,
+        tableResizers,
+        gridLineWidth,
+        headerMenuComponent,
+        isHeaderMenuInFrozenColumn,
+        stickyEditorPlacement,
+        popoverComponent,
+        popoverPlacement,
+        cellExpandComponent,
+    ]);
+};
+exports.useGridChildren = useGridChildren;
+/**
+ * Get placement of sticky editing cell
+ * @param editingCell
+ * @param frozenRows
+ * @param frozenColumns
+ * @returns
+ */
+var getCellPlacement = function (editingCell, frozenRows, frozenColumns) {
+    if (!editingCell) {
+        return "body";
+    }
+    var _a = (0, helpers_1.isSheetRange)(editingCell)
+        ? {
+            rowIndex: editingCell.startColumnIndex,
+            columnIndex: editingCell.startColumnIndex,
+        }
+        : editingCell, columnIndex = _a.columnIndex, rowIndex = _a.rowIndex;
+    if (columnIndex < frozenColumns && rowIndex < frozenRows) {
+        return "intersection";
+    }
+    if (columnIndex < frozenColumns)
+        return "column";
+    if (rowIndex < frozenRows)
+        return "row";
+    return "body";
+};
+var StyledGridChildren = function (_a) {
+    var className = _a.className, elevate = _a.elevate, props = tslib_1.__rest(_a, ["className", "elevate"]);
+    return (react_1.default.createElement("div", tslib_1.__assign({ className: (0, ui_1.cn)("absolute inset-0 overflow-hidden pointer-events-none", elevate ? "z-[1]" : undefined, className) }, props)));
+};
+exports.StyledGridChildren = StyledGridChildren;