@rowsncolumns/spreadsheet 10.2.77 → 10.3.0

package/dist/esm/api/move-overwrite.js

@@ -0,0 +1,25 @@
+/** Excel's prompt before a plain drag-move overwrites non-empty destination cells. */
+export const MOVE_OVERWRITE_PROMPT = "There's already data here. Do you want to replace it?";
+/**
+ * Whether a plain (overwrite) drag-move from `from` to `to` needs Excel's
+ * "There's already data here. Do you want to replace it?" prompt: true when any
+ * destination cell OUTSIDE the source block holds a value. Cells the block itself
+ * currently occupies are never "data here" — they leave with the move — so an
+ * overlapping drag one cell over prompts only for the newly covered strip. An
+ * empty destination never prompts; Shift+drag (insert) and Ctrl+drag (copy) never
+ * reach this check.
+ */
+export const needsOverwritePrompt = (from, to, hasValue) => {
+    for (let rowIndex = to.startRowIndex; rowIndex <= to.endRowIndex; rowIndex++) {
+        for (let columnIndex = to.startColumnIndex; columnIndex <= to.endColumnIndex; columnIndex++) {
+            const insideSource = rowIndex >= from.startRowIndex &&
+                rowIndex <= from.endRowIndex &&
+                columnIndex >= from.startColumnIndex &&
+                columnIndex <= from.endColumnIndex;
+            if (!insideSource && hasValue(rowIndex, columnIndex)) {
+                return true;
+            }
+        }
+    }
+    return false;
+};

package/dist/esm/api/multi-selection.d.ts

@@ -0,0 +1,59 @@
+import type { GridRange, SelectionArea } from "@rowsncolumns/grid";
+/**
+ * How Excel treats the areas of a multi-area (Ctrl-click) selection for the
+ * structural commands (rowsncolumns/spreadsheet#647 INS-08 / UI-07):
+ *
+ * - `single` — one area (or none): the normal Insert / Delete dialog path.
+ * - `all-rows` — every area is an entire-row band: insert / delete one block
+ *   per area, sized to that area, applied bottom-up.
+ * - `all-columns` — every area is an entire-column band: same, per column band.
+ * - `mixed` — any partial area, or rows mixed with columns: Excel refuses
+ *   with "That command cannot be used on multiple selections."
+ */
+export type MultiSelectionKind = "single" | "all-rows" | "all-columns" | "mixed";
+export type WholeBandPredicates = {
+    isWholeRow(range: GridRange): boolean;
+    isWholeColumn(range: GridRange): boolean;
+};
+/** Entire-row test for a sheet `columnCount` wide (the grid's left bound is column 1). */
+export declare const wholeRowPredicate: (columnCount: number, selectionLeftBound?: number) => (range: GridRange) => boolean;
+/** Entire-column test for a sheet `rowCount` tall (the grid's top bound is row 1). */
+export declare const wholeColumnPredicate: (rowCount: number, selectionTopBound?: number) => (range: GridRange) => boolean;
+/**
+ * Entire-row test when the sheet extent is unknown: the grid's row-header
+ * bookkeeping (`selectedRowHeadersIds`) already lists every row that belongs
+ * to a whole-row area, so an area is whole-row when its first and last rows
+ * are both listed.
+ */
+export declare const wholeRowPredicateFromHeaderIds: (rowHeaderIds: readonly number[]) => (range: GridRange) => boolean;
+export declare const wholeColumnPredicateFromHeaderIds: (columnHeaderIds: readonly number[]) => (range: GridRange) => boolean;
+export declare const classifyMultiSelection: (selections: readonly SelectionArea[], { isWholeRow, isWholeColumn }: WholeBandPredicates) => MultiSelectionKind;
+export type IndexBand = {
+    start: number;
+    end: number;
+};
+/**
+ * The bands (start..end, inclusive) a per-area structural command acts on,
+ * deduplicated and ordered bottom-up / right-to-left so inserting one block
+ * per band never shifts a band that is still to be processed (INS-08).
+ */
+export declare const bandsForAreas: (selections: readonly SelectionArea[], axis: "row" | "column") => IndexBand[];
+/**
+ * Groups header ids (e.g. `selectedRowHeadersIds`) into contiguous bands,
+ * bottom-up. Fallback for callers that only know which rows/columns are
+ * selected, not the areas they came from.
+ */
+export declare const bandsFromIndexes: (indexes: readonly number[]) => IndexBand[];
+/** Sorted, de-duplicated row (or column) indexes covered by ALL areas. */
+export declare const indexesForAreas: (selections: readonly SelectionArea[], axis: "row" | "column") => number[];
+export type InsertCellsChoice = "shift-right" | "shift-down" | "entire-row" | "entire-column";
+export type DeleteCellsChoice = "shift-left" | "shift-up" | "entire-row" | "entire-column";
+/**
+ * Excel pre-selects the shift that moves the fewest neighbours: a selection
+ * taller than it is wide shifts cells right; a wider-than-tall or square one
+ * shifts cells down (UI-06).
+ */
+export declare const defaultInsertCellsChoice: (range: GridRange) => InsertCellsChoice;
+/** Delete mirrors Insert: taller-than-wide → shift left, otherwise shift up. */
+export declare const defaultDeleteCellsChoice: (range: GridRange) => DeleteCellsChoice;
+//# sourceMappingURL=multi-selection.d.ts.map

package/dist/esm/api/multi-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-selection.d.ts","sourceRoot":"","sources":["../../../api/multi-selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,OAAO,CAAC;AAEjF,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;IACtC,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;CAC1C,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,GAC3B,aAAa,MAAM,EAAE,2BAAsB,MAC3C,OAAO,SAAS,YAEoB,CAAC;AAExC,sFAAsF;AACtF,eAAO,MAAM,oBAAoB,GAC9B,UAAU,MAAM,EAAE,0BAAqB,MACvC,OAAO,SAAS,YAC0D,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,GACxC,cAAc,SAAS,MAAM,EAAE,MAEtB,OAAO,SAAS,YAEzB,CAAC;AAEJ,eAAO,MAAM,iCAAiC,GAC3C,iBAAiB,SAAS,MAAM,EAAE,MAEzB,OAAO,SAAS,YAIzB,CAAC;AAEJ,eAAO,MAAM,sBAAsB,GACjC,YAAY,SAAS,aAAa,EAAE,EACpC,+BAA+B,mBAAmB,KACjD,kBAOF,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,aAAa,GACxB,YAAY,SAAS,aAAa,EAAE,EACpC,MAAM,KAAK,GAAG,QAAQ,KACrB,SAAS,EAcX,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,SAAS,EAYtE,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,eAAe,GAC1B,YAAY,SAAS,aAAa,EAAE,EACpC,MAAM,KAAK,GAAG,QAAQ,KACrB,MAAM,EAUR,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,eAAe,CAAC;AAEpB,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,eAAe,CAAC;AAMpB;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,SAAS,KAAG,iBACJ,CAAC;AAEzD,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,GAAI,OAAO,SAAS,KAAG,iBACP,CAAC"}

package/dist/esm/api/multi-selection.js

@@ -0,0 +1,92 @@
+/** Entire-row test for a sheet `columnCount` wide (the grid's left bound is column 1). */
+export const wholeRowPredicate = (columnCount, selectionLeftBound = 1) => (range) => range.startColumnIndex <= selectionLeftBound &&
+    range.endColumnIndex >= columnCount;
+/** Entire-column test for a sheet `rowCount` tall (the grid's top bound is row 1). */
+export const wholeColumnPredicate = (rowCount, selectionTopBound = 1) => (range) => range.startRowIndex <= selectionTopBound && range.endRowIndex >= rowCount;
+/**
+ * Entire-row test when the sheet extent is unknown: the grid's row-header
+ * bookkeeping (`selectedRowHeadersIds`) already lists every row that belongs
+ * to a whole-row area, so an area is whole-row when its first and last rows
+ * are both listed.
+ */
+export const wholeRowPredicateFromHeaderIds = (rowHeaderIds) => {
+    const ids = new Set(rowHeaderIds);
+    return (range) => ids.size > 0 && ids.has(range.startRowIndex) && ids.has(range.endRowIndex);
+};
+export const wholeColumnPredicateFromHeaderIds = (columnHeaderIds) => {
+    const ids = new Set(columnHeaderIds);
+    return (range) => ids.size > 0 &&
+        ids.has(range.startColumnIndex) &&
+        ids.has(range.endColumnIndex);
+};
+export const classifyMultiSelection = (selections, { isWholeRow, isWholeColumn }) => {
+    if (selections.length <= 1)
+        return "single";
+    if (selections.every(({ range }) => isWholeRow(range)))
+        return "all-rows";
+    if (selections.every(({ range }) => isWholeColumn(range))) {
+        return "all-columns";
+    }
+    return "mixed";
+};
+/**
+ * The bands (start..end, inclusive) a per-area structural command acts on,
+ * deduplicated and ordered bottom-up / right-to-left so inserting one block
+ * per band never shifts a band that is still to be processed (INS-08).
+ */
+export const bandsForAreas = (selections, axis) => {
+    const seen = new Set();
+    const bands = [];
+    for (const { range } of selections) {
+        const band = axis === "row"
+            ? { start: range.startRowIndex, end: range.endRowIndex }
+            : { start: range.startColumnIndex, end: range.endColumnIndex };
+        const key = `${band.start}:${band.end}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        bands.push(band);
+    }
+    return bands.sort((a, b) => b.start - a.start);
+};
+/**
+ * Groups header ids (e.g. `selectedRowHeadersIds`) into contiguous bands,
+ * bottom-up. Fallback for callers that only know which rows/columns are
+ * selected, not the areas they came from.
+ */
+export const bandsFromIndexes = (indexes) => {
+    const sorted = Array.from(new Set(indexes)).sort((a, b) => a - b);
+    const bands = [];
+    for (const index of sorted) {
+        const last = bands[bands.length - 1];
+        if (last && index === last.end + 1) {
+            last.end = index;
+        }
+        else {
+            bands.push({ start: index, end: index });
+        }
+    }
+    return bands.sort((a, b) => b.start - a.start);
+};
+/** Sorted, de-duplicated row (or column) indexes covered by ALL areas. */
+export const indexesForAreas = (selections, axis) => {
+    const indexes = new Set();
+    for (const { range } of selections) {
+        const [start, end] = axis === "row"
+            ? [range.startRowIndex, range.endRowIndex]
+            : [range.startColumnIndex, range.endColumnIndex];
+        for (let index = start; index <= end; index++)
+            indexes.add(index);
+    }
+    return Array.from(indexes).sort((a, b) => a - b);
+};
+const isTallerThanWide = (range) => range.endRowIndex - range.startRowIndex >
+    range.endColumnIndex - range.startColumnIndex;
+/**
+ * Excel pre-selects the shift that moves the fewest neighbours: a selection
+ * taller than it is wide shifts cells right; a wider-than-tall or square one
+ * shifts cells down (UI-06).
+ */
+export const defaultInsertCellsChoice = (range) => isTallerThanWide(range) ? "shift-right" : "shift-down";
+/** Delete mirrors Insert: taller-than-wide → shift left, otherwise shift up. */
+export const defaultDeleteCellsChoice = (range) => isTallerThanWide(range) ? "shift-left" : "shift-up";

package/dist/esm/atoms/index.d.ts

@@ -19,7 +19,10 @@ export * from "./validation-alert.atom";
 export * from "./sort-dialog.atom";
 export * from "./paste-special-dialog.atom";
 export * from "./go-to-dialog.atom";
+export * from "./move-overwrite-confirm.atom";
 export * from "./evaluate-formula-dialog.atom";
 export * from "./remove-duplicates-dialog.atom";
 export * from "./watch-window.atom";
+export * from "./insert-cells-dialog.atom";
+export * from "./insert-options.atom";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/atoms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC"}

package/dist/esm/atoms/index.js

@@ -19,6 +19,9 @@ export * from "./validation-alert.atom";
 export * from "./sort-dialog.atom";
 export * from "./paste-special-dialog.atom";
 export * from "./go-to-dialog.atom";
+export * from "./move-overwrite-confirm.atom";
 export * from "./evaluate-formula-dialog.atom";
 export * from "./remove-duplicates-dialog.atom";
 export * from "./watch-window.atom";
+export * from "./insert-cells-dialog.atom";
+export * from "./insert-options.atom";

package/dist/esm/atoms/insert-cells-dialog.atom.d.ts

@@ -0,0 +1,36 @@
+import type { DeleteCellsChoice, InsertCellsChoice } from "../api/multi-selection";
+/**
+ * Open-state + payload for Excel's Insert / Delete cells dialog (right-click a
+ * cell → "Insert…" / "Delete…", `Ctrl` + `+` / `-` on a cell selection). The
+ * grid opens it with the shape-derived default; the host-mounted dialog routes
+ * the chosen entry back through `onApply`, and the opener dispatches the
+ * matching structural command (shift cells / entire row / entire column).
+ */
+export type InsertCellsDialogRequest = {
+    mode: "insert";
+    defaultChoice: InsertCellsChoice;
+    onApply: (choice: InsertCellsChoice) => void;
+} | {
+    mode: "delete";
+    defaultChoice: DeleteCellsChoice;
+    onApply: (choice: DeleteCellsChoice) => void;
+};
+export declare const insertCellsDialogAtom: import("jotai").PrimitiveAtom<InsertCellsDialogRequest | null> & {
+    init: InsertCellsDialogRequest | null;
+};
+export declare const useInsertCellsDialogState: () => [InsertCellsDialogRequest | null, (args_0: InsertCellsDialogRequest | ((prev: InsertCellsDialogRequest | null) => InsertCellsDialogRequest | null) | null) => void];
+/**
+ * Number of mounted `InsertCellsDialogHost`s. The context menu only offers the
+ * dialog entry while a host is mounted; without one it keeps the direct
+ * submenu so a host that has not adopted the dialog never gets a dead item.
+ */
+export declare const insertCellsDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `InsertCellsDialogHost` is mounted. */
+export declare const useIsInsertCellsDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterInsertCellsDialogHost: () => void;
+/** Returns a function that opens the host-mounted Insert / Delete cells dialog. */
+export declare const useOpenInsertCellsDialog: () => (request: InsertCellsDialogRequest) => void;
+//# sourceMappingURL=insert-cells-dialog.atom.d.ts.map

package/dist/esm/atoms/insert-cells-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-cells-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/insert-cells-dialog.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAChC;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,EAAE,iBAAiB,CAAC;IACjC,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC9C,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,EAAE,iBAAiB,CAAC;IACjC,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC9C,CAAC;AAEN,eAAO,MAAM,qBAAqB;;CAEjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,2KAAuC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;CAAU,CAAC;AAEtD,iEAAiE;AACjE,eAAO,MAAM,6BAA6B,eACQ,CAAC;AAEnD,yEAAyE;AACzE,eAAO,MAAM,gCAAgC,YAM5C,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,kBAGvB,wBAAwB,SAGrC,CAAC"}

package/dist/esm/atoms/insert-cells-dialog.atom.js

@@ -0,0 +1,25 @@
+import { atom, useAtom, useAtomValue, useSetAtom } from "jotai";
+import { useCallback, useEffect } from "react";
+export const insertCellsDialogAtom = atom(null);
+export const useInsertCellsDialogState = () => useAtom(insertCellsDialogAtom);
+/**
+ * Number of mounted `InsertCellsDialogHost`s. The context menu only offers the
+ * dialog entry while a host is mounted; without one it keeps the direct
+ * submenu so a host that has not adopted the dialog never gets a dead item.
+ */
+export const insertCellsDialogHostCountAtom = atom(0);
+/** True when at least one `InsertCellsDialogHost` is mounted. */
+export const useIsInsertCellsDialogMounted = () => useAtomValue(insertCellsDialogHostCountAtom) > 0;
+/** Registers the calling component as a dialog host for its lifetime. */
+export const useRegisterInsertCellsDialogHost = () => {
+    const setCount = useSetAtom(insertCellsDialogHostCountAtom);
+    useEffect(() => {
+        setCount((count) => count + 1);
+        return () => setCount((count) => count - 1);
+    }, [setCount]);
+};
+/** Returns a function that opens the host-mounted Insert / Delete cells dialog. */
+export const useOpenInsertCellsDialog = () => {
+    const setRequest = useSetAtom(insertCellsDialogAtom);
+    return useCallback((request) => setRequest(request), [setRequest]);
+};

package/dist/esm/atoms/insert-options.atom.d.ts

@@ -0,0 +1,21 @@
+import type { InsertedBand, InsertFormatOption } from "../api/insert-options";
+/**
+ * A just-inserted row / column band waiting for the user to (re)choose how it
+ * is formatted — Excel's Insert Options smart tag ("Format Same As Above /
+ * Below / Clear Formatting"; "Left / Right" for columns). The insert already
+ * applied `before` (the row above / column to the left); choosing another
+ * entry re-formats the band from the other neighbour, or clears it. Dropped
+ * on the next click elsewhere (a new active cell) or sheet switch.
+ */
+export type InsertOptionsRequest = InsertedBand & {
+    sheetId: number;
+    /** The entry currently applied to the band. */
+    option: InsertFormatOption;
+};
+export declare const insertOptionsAtom: import("jotai").PrimitiveAtom<InsertOptionsRequest | null> & {
+    init: InsertOptionsRequest | null;
+};
+export declare const useInsertOptionsState: () => [InsertOptionsRequest | null, (args_0: InsertOptionsRequest | ((prev: InsertOptionsRequest | null) => InsertOptionsRequest | null) | null) => void];
+export declare const useInsertOptionsValue: () => InsertOptionsRequest | null;
+export declare const useSetInsertOptions: () => (args_0: InsertOptionsRequest | ((prev: InsertOptionsRequest | null) => InsertOptionsRequest | null) | null) => void;
+//# sourceMappingURL=insert-options.atom.d.ts.map

package/dist/esm/atoms/insert-options.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-options.atom.d.ts","sourceRoot":"","sources":["../../../atoms/insert-options.atom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,MAAM,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;CAA0C,CAAC;AAEzE,eAAO,MAAM,qBAAqB,2JAAmC,CAAC;AACtE,eAAO,MAAM,qBAAqB,mCAAwC,CAAC;AAC3E,eAAO,MAAM,mBAAmB,4HAAsC,CAAC"}

package/dist/esm/atoms/insert-options.atom.js

@@ -0,0 +1,5 @@
+import { atom, useAtom, useAtomValue, useSetAtom } from "jotai";
+export const insertOptionsAtom = atom(null);
+export const useInsertOptionsState = () => useAtom(insertOptionsAtom);
+export const useInsertOptionsValue = () => useAtomValue(insertOptionsAtom);
+export const useSetInsertOptions = () => useSetAtom(insertOptionsAtom);

package/dist/esm/atoms/move-overwrite-confirm.atom.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Open-state + payload for the drag-move overwrite prompt (Excel: "There's
+ * already data here. Do you want to replace it?"). The grid raises it from the
+ * selection-border drop; the host-mounted dialog answers through `resolve`.
+ */
+export type MoveOverwriteConfirmRequest = {
+    message: string;
+    resolve: (replace: boolean) => void;
+};
+export declare const moveOverwriteConfirmAtom: import("jotai").PrimitiveAtom<MoveOverwriteConfirmRequest | null> & {
+    init: MoveOverwriteConfirmRequest | null;
+};
+export declare const useMoveOverwriteConfirmState: () => [MoveOverwriteConfirmRequest | null, (args_0: MoveOverwriteConfirmRequest | ((prev: MoveOverwriteConfirmRequest | null) => MoveOverwriteConfirmRequest | null) | null) => void];
+/** Number of mounted `MoveOverwriteConfirmDialogHost`s. */
+export declare const moveOverwriteConfirmHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when a host has mounted the dialog; otherwise the grid falls back to `window.confirm`. */
+export declare const useIsMoveOverwriteConfirmMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterMoveOverwriteConfirmHost: () => void;
+/** Returns a function that opens the host-mounted prompt and resolves with the user's answer. */
+export declare const useOpenMoveOverwriteConfirm: () => (message: string) => Promise<boolean>;
+//# sourceMappingURL=move-overwrite-confirm.atom.d.ts.map

package/dist/esm/atoms/move-overwrite-confirm.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-overwrite-confirm.atom.d.ts","sourceRoot":"","sources":["../../../atoms/move-overwrite-confirm.atom.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;CAEpC,CAAC;AAEF,eAAO,MAAM,4BAA4B,uLACN,CAAC;AAEpC,2DAA2D;AAC3D,eAAO,MAAM,iCAAiC;;CAAU,CAAC;AAEzD,kGAAkG;AAClG,eAAO,MAAM,gCAAgC,eACQ,CAAC;AAEtD,yEAAyE;AACzE,eAAO,MAAM,mCAAmC,YAM/C,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,2BAA2B,kBAG1B,MAAM,qBAYnB,CAAC"}

package/dist/esm/atoms/move-overwrite-confirm.atom.js

@@ -0,0 +1,29 @@
+import { atom, useAtom, useAtomValue, useSetAtom } from "jotai";
+import { useCallback, useEffect } from "react";
+export const moveOverwriteConfirmAtom = atom(null);
+export const useMoveOverwriteConfirmState = () => useAtom(moveOverwriteConfirmAtom);
+/** Number of mounted `MoveOverwriteConfirmDialogHost`s. */
+export const moveOverwriteConfirmHostCountAtom = atom(0);
+/** True when a host has mounted the dialog; otherwise the grid falls back to `window.confirm`. */
+export const useIsMoveOverwriteConfirmMounted = () => useAtomValue(moveOverwriteConfirmHostCountAtom) > 0;
+/** Registers the calling component as a dialog host for its lifetime. */
+export const useRegisterMoveOverwriteConfirmHost = () => {
+    const setCount = useSetAtom(moveOverwriteConfirmHostCountAtom);
+    useEffect(() => {
+        setCount((count) => count + 1);
+        return () => setCount((count) => count - 1);
+    }, [setCount]);
+};
+/** Returns a function that opens the host-mounted prompt and resolves with the user's answer. */
+export const useOpenMoveOverwriteConfirm = () => {
+    const setRequest = useSetAtom(moveOverwriteConfirmAtom);
+    return useCallback((message) => new Promise((resolve) => {
+        setRequest({
+            message,
+            resolve: (replace) => {
+                setRequest(null);
+                resolve(replace);
+            },
+        });
+    }), [setRequest]);
+};

package/dist/esm/atoms/sheet-context.atom.d.ts

@@ -5,6 +5,8 @@ export declare const spreadsheetContextAtom: import("jotai").PrimitiveAtom<Canva
 export declare const useSpreadsheet: () => CanvasGridMethods;
 export declare const tokenizerSelector: import("jotai").Atom<(str: string) => import("..").ParsedToken[]>;
 export declare const useTokenizer: () => (str: string) => import("..").ParsedToken[];
+export declare const useLocaleTokenizer: () => (str: string) => import("..").ParsedToken[];
+export declare const useFormulaLocale: () => import("@rowsncolumns/utils").FormulaLocale;
 export declare const useSetSpreadsheetContext: () => (args_0: CanvasGridMethods | ((prev: CanvasGridMethods) => CanvasGridMethods)) => void;
 export declare const useGetCellBounds: () => ((coords: import("@rowsncolumns/grid").CellInterface, spanMerges?: boolean | undefined) => import("@rowsncolumns/grid").GridRange) | undefined;
 export declare const useGetSelectionsFromFormula: () => ((value: string, anchorCell?: import("@rowsncolumns/grid").CellInterface) => import("@rowsncolumns/grid").SelectionArea<import("../components/canvas-grid/typings").SelectionAttributes>[]) | undefined;

package/dist/esm/atoms/sheet-context.atom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sheet-context.atom.d.ts","sourceRoot":"","sources":["../../../atoms/sheet-context.atom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,eAAO,MAAM,sBAAsB;;CAEjC,CAAC;AAEH,eAAO,MAAM,cAAc,yBAA6C,CAAC;AAGzE,eAAO,MAAM,iBAAiB,mEAE7B,CAAC;AAEF,eAAO,MAAM,YAAY,mDAAwC,CAAC;AAElE,eAAO,MAAM,wBAAwB,8FACD,CAAC;AAOrC,eAAO,MAAM,gBAAgB,sJAA4C,CAAC;AAO1E,eAAO,MAAM,2BAA2B,+MACK,CAAC;AAO9C,eAAO,MAAM,0BAA0B,uQACM,CAAC;AAO9C,eAAO,MAAM,8BAA8B,+GACM,CAAC;AAMlD,eAAO,MAAM,oBAAoB;;;cACQ,CAAC;AAM1C,eAAO,MAAM,eAAe,+GAA2C,CAAC;AAMxE,eAAO,MAAM,iBAAiB;;;;yBAA6C,CAAC;AAM5E,eAAO,MAAM,+BAA+B,wIACY,CAAC;AAMzD,eAAO,MAAM,0BAA0B,8HACQ,CAAC;AAMhD,eAAO,MAAM,0BAA0B,iIACQ,CAAC;AAEhD,eAAO,MAAM,wCAAwC,oPAEpD,CAAC;AAEF,eAAO,MAAM,mCAAmC,oOACQ,CAAC;AAEzD,eAAO,MAAM,mBAAmB,oHAE/B,CAAC;AAEF,eAAO,MAAM,cAAc,oGAA0C,CAAC;AAEtE,eAAO,MAAM,wBAAwB,kEAEpC,CAAC;AAEF,eAAO,MAAM,mBAAmB,kDAA+C,CAAC;AAEhF,eAAO,MAAM,2BAA2B,mDAEvC,CAAC;AAEF,eAAO,MAAM,sBAAsB,mCACQ,CAAC;AAE5C,eAAO,MAAM,0BAA0B,0GAEtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,0FACQ,CAAC;AAE3C,eAAO,MAAM,mCAAmC,gHAE/C,CAAC;AAEF,eAAO,MAAM,8BAA8B,gGACQ,CAAC;AAEpD,eAAO,MAAM,kBAAkB,4OAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,4NAAyC,CAAC;AAEpE,eAAO,MAAM,kBAAkB,gDAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,gCAAyC,CAAC;AAEpE,eAAO,MAAM,0BAA0B,oFAEtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,oEACQ,CAAC;AAE3C,eAAO,MAAM,yBAAyB,oMAErC,CAAC;AAEF,eAAO,MAAM,oBAAoB,oLACQ,CAAC;AAE1C,eAAO,MAAM,uBAAuB,sFAEnC,CAAC;AAEF,eAAO,MAAM,kBAAkB,sEAA8C,CAAC;AAE9E,eAAO,MAAM,oBAAoB,iEAEhC,CAAC;AAEF,eAAO,MAAM,eAAe,iDAA2C,CAAC;AAExE,eAAO,MAAM,kBAAkB,+EAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,+DAAyC,CAAC;AAEpE,eAAO,MAAM,0BAA0B,wOAEtC,CAAC;AAEF,eAAO,MAAM,kBAAkB,wNACW,CAAC;AAE3C,eAAO,MAAM,oBAAoB,oJAEhC,CAAC;AAEF,eAAO,MAAM,eAAe,oIAA2C,CAAC;AAExE,eAAO,MAAM,kBAAkB,gDAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,gCAAyC,CAAC;AAEpE,eAAO,MAAM,mBAAmB,sFAE/B,CAAC;AAEF,eAAO,MAAM,cAAc,sEAA0C,CAAC;AAEtE,eAAO,MAAM,sBAAsB,+FAElC,CAAC;AAEF,eAAO,MAAM,iBAAiB,+EAA6C,CAAC;AAE5E,eAAO,MAAM,kBAAkB,uFAE9B,CAAC;AACF,eAAO,MAAM,aAAa,uEAAyC,CAAC;AAEpE,eAAO,MAAM,4BAA4B,kLAExC,CAAC;AACF,eAAO,MAAM,uBAAuB,kKACQ,CAAC"}
+{"version":3,"file":"sheet-context.atom.d.ts","sourceRoot":"","sources":["../../../atoms/sheet-context.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,eAAO,MAAM,sBAAsB;;CAEjC,CAAC;AAEH,eAAO,MAAM,cAAc,yBAA6C,CAAC;AAGzE,eAAO,MAAM,iBAAiB,mEAE7B,CAAC;AAEF,eAAO,MAAM,YAAY,mDAAwC,CAAC;AAQlE,eAAO,MAAM,kBAAkB,mDAA8C,CAAC;AAO9E,eAAO,MAAM,gBAAgB,mDAA4C,CAAC;AAE1E,eAAO,MAAM,wBAAwB,8FACD,CAAC;AAOrC,eAAO,MAAM,gBAAgB,sJAA4C,CAAC;AAO1E,eAAO,MAAM,2BAA2B,+MACK,CAAC;AAO9C,eAAO,MAAM,0BAA0B,uQACM,CAAC;AAO9C,eAAO,MAAM,8BAA8B,+GACM,CAAC;AAMlD,eAAO,MAAM,oBAAoB;;;cACQ,CAAC;AAM1C,eAAO,MAAM,eAAe,+GAA2C,CAAC;AAMxE,eAAO,MAAM,iBAAiB;;;;yBAA6C,CAAC;AAM5E,eAAO,MAAM,+BAA+B,wIACY,CAAC;AAMzD,eAAO,MAAM,0BAA0B,8HACQ,CAAC;AAMhD,eAAO,MAAM,0BAA0B,iIACQ,CAAC;AAEhD,eAAO,MAAM,wCAAwC,oPAEpD,CAAC;AAEF,eAAO,MAAM,mCAAmC,oOACQ,CAAC;AAEzD,eAAO,MAAM,mBAAmB,oHAE/B,CAAC;AAEF,eAAO,MAAM,cAAc,oGAA0C,CAAC;AAEtE,eAAO,MAAM,wBAAwB,kEAEpC,CAAC;AAEF,eAAO,MAAM,mBAAmB,kDAA+C,CAAC;AAEhF,eAAO,MAAM,2BAA2B,mDAEvC,CAAC;AAEF,eAAO,MAAM,sBAAsB,mCACQ,CAAC;AAE5C,eAAO,MAAM,0BAA0B,0GAEtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,0FACQ,CAAC;AAE3C,eAAO,MAAM,mCAAmC,gHAE/C,CAAC;AAEF,eAAO,MAAM,8BAA8B,gGACQ,CAAC;AAEpD,eAAO,MAAM,kBAAkB,4OAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,4NAAyC,CAAC;AAEpE,eAAO,MAAM,kBAAkB,gDAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,gCAAyC,CAAC;AAEpE,eAAO,MAAM,0BAA0B,oFAEtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,oEACQ,CAAC;AAE3C,eAAO,MAAM,yBAAyB,oMAErC,CAAC;AAEF,eAAO,MAAM,oBAAoB,oLACQ,CAAC;AAE1C,eAAO,MAAM,uBAAuB,sFAEnC,CAAC;AAEF,eAAO,MAAM,kBAAkB,sEAA8C,CAAC;AAE9E,eAAO,MAAM,oBAAoB,iEAEhC,CAAC;AAEF,eAAO,MAAM,eAAe,iDAA2C,CAAC;AAExE,eAAO,MAAM,kBAAkB,+EAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,+DAAyC,CAAC;AAEpE,eAAO,MAAM,0BAA0B,wOAEtC,CAAC;AAEF,eAAO,MAAM,kBAAkB,wNACW,CAAC;AAE3C,eAAO,MAAM,oBAAoB,oJAEhC,CAAC;AAEF,eAAO,MAAM,eAAe,oIAA2C,CAAC;AAExE,eAAO,MAAM,kBAAkB,gDAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,gCAAyC,CAAC;AAEpE,eAAO,MAAM,mBAAmB,sFAE/B,CAAC;AAEF,eAAO,MAAM,cAAc,sEAA0C,CAAC;AAEtE,eAAO,MAAM,sBAAsB,+FAElC,CAAC;AAEF,eAAO,MAAM,iBAAiB,+EAA6C,CAAC;AAE5E,eAAO,MAAM,kBAAkB,uFAE9B,CAAC;AACF,eAAO,MAAM,aAAa,uEAAyC,CAAC;AAEpE,eAAO,MAAM,4BAA4B,kLAExC,CAAC;AACF,eAAO,MAAM,uBAAuB,kKACQ,CAAC"}

package/dist/esm/atoms/sheet-context.atom.js

@@ -1,3 +1,4 @@
+import { CANONICAL_FORMULA_LOCALE } from "@rowsncolumns/utils";
 import { atom, useAtomValue, useSetAtom } from "jotai";
 export const spreadsheetContextAtom = atom({
     tokenizer: () => [],
@@ -6,6 +7,15 @@ export const useSpreadsheet = () => useAtomValue(spreadsheetContextAtom);
 // Tokenizer selector
 export const tokenizerSelector = atom((get) => get(spreadsheetContextAtom).tokenizer);
 export const useTokenizer = () => useAtomValue(tokenizerSelector);
+// Formula-locale tokenizer (falls back to the canonical one before the grid publishes it)
+const localeTokenizerSelector = atom((get) => {
+    const context = get(spreadsheetContextAtom);
+    return context.localeTokenizer ?? context.tokenizer;
+});
+export const useLocaleTokenizer = () => useAtomValue(localeTokenizerSelector);
+// The grid's resolved formula locale (canonical until the grid publishes one)
+const formulaLocaleSelector = atom((get) => get(spreadsheetContextAtom).formulaLocale ?? CANONICAL_FORMULA_LOCALE);
+export const useFormulaLocale = () => useAtomValue(formulaLocaleSelector);
 export const useSetSpreadsheetContext = () => useSetAtom(spreadsheetContextAtom);
 // Cellbounds selector
 const getCellBoundsSelector = atom((get) => get(spreadsheetContextAtom).getCellBounds);

package/dist/esm/components/canvas-grid/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/canvas-grid/index.tsx"],"names":[],"mappings":"AA2CA,OAAO,KASN,MAAM,OAAO,CAAC;AA4Lf,OAAO,KAAK,EAGV,QAAQ,EAUT,MAAM,aAAa,CAAC;AAcrB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,WAAW,CAAC;AAmkKnB,eAAO,MAAM,UAAU,EAA4C,CACjE,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,EAEvB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GACvB,wBAAwB,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAChE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/canvas-grid/index.tsx"],"names":[],"mappings":"AA+CA,OAAO,KASN,MAAM,OAAO,CAAC;AAuMf,OAAO,KAAK,EAGV,QAAQ,EAUT,MAAM,aAAa,CAAC;AAcrB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,WAAW,CAAC;AAk1KnB,eAAO,MAAM,UAAU,EAA4C,CACjE,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,EAEvB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GACvB,wBAAwB,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAChE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC"}