@rowsncolumns/spreadsheet 10.2.74 → 10.2.75

package/dist/esm/atoms/subtotal-dialog.atom.d.ts

@@ -0,0 +1,39 @@
+import type { SubtotalOptions } from "../types";
+/** One column of the range being subtotalled. */
+export type SubtotalDialogColumn = {
+    /** Absolute sheet column index. */
+    columnIndex: number;
+    /** Positional label, e.g. "Column B". */
+    label: string;
+    /** Text of the first row, shown instead of `label` when the data has headers. */
+    header?: string;
+};
+/** The dialog's choices; the opener adds the `range`. */
+export type SubtotalDialogChoices = Omit<SubtotalOptions, "range">;
+/**
+ * Open-state + payload for the Subtotal dialog (Excel's Data → Outline →
+ * Subtotal). The context menu opens it with the range's columns; the
+ * host-mounted dialog routes the choices back through `onApply`.
+ */
+export type SubtotalDialogRequest = {
+    columns: SubtotalDialogColumn[];
+    /** Initial state of "My data has headers". */
+    hasHeader: boolean;
+    /** Routed to `onSubtotal` by the opener. */
+    onApply: (choices: SubtotalDialogChoices) => void;
+};
+export declare const subtotalDialogAtom: import("jotai").PrimitiveAtom<SubtotalDialogRequest | null> & {
+    init: SubtotalDialogRequest | null;
+};
+export declare const useSubtotalDialogState: () => [SubtotalDialogRequest | null, (args_0: SubtotalDialogRequest | ((prev: SubtotalDialogRequest | null) => SubtotalDialogRequest | null) | null) => void];
+/** Number of mounted `SubtotalDialogHost`s — the menu item is offered only while > 0. */
+export declare const subtotalDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `SubtotalDialogHost` is mounted. */
+export declare const useIsSubtotalDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterSubtotalDialogHost: () => void;
+/** Returns a function that opens the host-mounted Subtotal dialog. */
+export declare const useOpenSubtotalDialog: () => (request: SubtotalDialogRequest) => void;
+//# sourceMappingURL=subtotal-dialog.atom.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subtotal-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/subtotal-dialog.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,iDAAiD;AACjD,MAAM,MAAM,oBAAoB,GAAG;IACjC,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,eAAO,MAAM,kBAAkB;;CAA2C,CAAC;AAE3E,eAAO,MAAM,sBAAsB,+JAAoC,CAAC;AAExE,yFAAyF;AACzF,eAAO,MAAM,2BAA2B;;CAAU,CAAC;AAEnD,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,eACQ,CAAC;AAEhD,yEAAyE;AACzE,eAAO,MAAM,6BAA6B,YAMzC,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,kBAGpB,qBAAqB,SAGlC,CAAC"}

package/dist/esm/atoms/subtotal-dialog.atom.js

@@ -0,0 +1,21 @@
+import { atom, useAtom, useAtomValue, useSetAtom } from "jotai";
+import { useCallback, useEffect } from "react";
+export const subtotalDialogAtom = atom(null);
+export const useSubtotalDialogState = () => useAtom(subtotalDialogAtom);
+/** Number of mounted `SubtotalDialogHost`s — the menu item is offered only while > 0. */
+export const subtotalDialogHostCountAtom = atom(0);
+/** True when at least one `SubtotalDialogHost` is mounted. */
+export const useIsSubtotalDialogMounted = () => useAtomValue(subtotalDialogHostCountAtom) > 0;
+/** Registers the calling component as a dialog host for its lifetime. */
+export const useRegisterSubtotalDialogHost = () => {
+    const setCount = useSetAtom(subtotalDialogHostCountAtom);
+    useEffect(() => {
+        setCount((count) => count + 1);
+        return () => setCount((count) => count - 1);
+    }, [setCount]);
+};
+/** Returns a function that opens the host-mounted Subtotal dialog. */
+export const useOpenSubtotalDialog = () => {
+    const setRequest = useSetAtom(subtotalDialogAtom);
+    return useCallback((request) => setRequest(request), [setRequest]);
+};

package/dist/esm/atoms/text-to-columns-dialog.atom.d.ts

@@ -0,0 +1,34 @@
+import type { SplitTextOptions } from "../types";
+/**
+ * Open-state + payload for the Text to Columns dialog (Excel's Data → Text
+ * to Columns wizard: Delimited / Fixed width). The context menu opens it
+ * with a preview of the selected column's texts; the host-mounted dialog
+ * routes the chosen delimiter or column breaks back through `onApply`.
+ */
+export type TextToColumnsDialogRequest = {
+    /** Texts of the first cells of the selected column (for the preview / ruler). */
+    preview: string[];
+    /** Routed to `onSplitTextToColumns` by the opener. */
+    onApply: (options: {
+        delimiter: string;
+    } & SplitTextOptions) => void;
+};
+export declare const textToColumnsDialogAtom: import("jotai").PrimitiveAtom<TextToColumnsDialogRequest | null> & {
+    init: TextToColumnsDialogRequest | null;
+};
+export declare const useTextToColumnsDialogState: () => [TextToColumnsDialogRequest | null, (args_0: TextToColumnsDialogRequest | ((prev: TextToColumnsDialogRequest | null) => TextToColumnsDialogRequest | null) | null) => void];
+/**
+ * Number of mounted `TextToColumnsDialogHost`s. The context menu only offers
+ * "Fixed width…" while a host is mounted, so a host that has not adopted the
+ * dialog keeps its one-click delimiter items and no dead entry.
+ */
+export declare const textToColumnsDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `TextToColumnsDialogHost` is mounted. */
+export declare const useIsTextToColumnsDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterTextToColumnsDialogHost: () => void;
+/** Returns a function that opens the host-mounted Text to Columns dialog. */
+export declare const useOpenTextToColumnsDialog: () => (request: TextToColumnsDialogRequest) => void;
+//# sourceMappingURL=text-to-columns-dialog.atom.d.ts.map

package/dist/esm/atoms/text-to-columns-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-to-columns-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/text-to-columns-dialog.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,iFAAiF;IACjF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sDAAsD;IACtD,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,gBAAgB,KAAK,IAAI,CAAC;CACtE,CAAC;AAEF,eAAO,MAAM,uBAAuB;;CAEnC,CAAC;AAEF,eAAO,MAAM,2BAA2B,mLACN,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,gCAAgC;;CAAU,CAAC;AAExD,mEAAmE;AACnE,eAAO,MAAM,+BAA+B,eACQ,CAAC;AAErD,yEAAyE;AACzE,eAAO,MAAM,kCAAkC,YAM9C,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B,kBAGzB,0BAA0B,SAGvC,CAAC"}

package/dist/esm/atoms/text-to-columns-dialog.atom.js

@@ -0,0 +1,25 @@
+import { atom, useAtom, useAtomValue, useSetAtom } from "jotai";
+import { useCallback, useEffect } from "react";
+export const textToColumnsDialogAtom = atom(null);
+export const useTextToColumnsDialogState = () => useAtom(textToColumnsDialogAtom);
+/**
+ * Number of mounted `TextToColumnsDialogHost`s. The context menu only offers
+ * "Fixed width…" while a host is mounted, so a host that has not adopted the
+ * dialog keeps its one-click delimiter items and no dead entry.
+ */
+export const textToColumnsDialogHostCountAtom = atom(0);
+/** True when at least one `TextToColumnsDialogHost` is mounted. */
+export const useIsTextToColumnsDialogMounted = () => useAtomValue(textToColumnsDialogHostCountAtom) > 0;
+/** Registers the calling component as a dialog host for its lifetime. */
+export const useRegisterTextToColumnsDialogHost = () => {
+    const setCount = useSetAtom(textToColumnsDialogHostCountAtom);
+    useEffect(() => {
+        setCount((count) => count + 1);
+        return () => setCount((count) => count - 1);
+    }, [setCount]);
+};
+/** Returns a function that opens the host-mounted Text to Columns dialog. */
+export const useOpenTextToColumnsDialog = () => {
+    const setRequest = useSetAtom(textToColumnsDialogAtom);
+    return useCallback((request) => setRequest(request), [setRequest]);
+};

package/dist/esm/atoms/watch-window.atom.d.ts

@@ -0,0 +1,37 @@
+import type { SheetCoordinate } from "../types";
+/** A watched cell (Excel's Watch Window row). */
+export type WatchWindowEntry = SheetCoordinate;
+/**
+ * What the grid publishes so the host-mounted panel can show live values
+ * and jump to a cell. Republished on every grid render while a host is
+ * mounted, so values track recalculation.
+ */
+export type WatchWindowContext = {
+    getSheetName?: (sheetId: number) => string | undefined;
+    getFormattedValue: (sheetId: number, rowIndex: number, columnIndex: number) => string | undefined;
+    getFormula: (sheetId: number, rowIndex: number, columnIndex: number) => string | undefined | null;
+    onNavigate: (cell: SheetCoordinate) => void;
+};
+export declare const watchWindowEntriesAtom: import("jotai").PrimitiveAtom<SheetCoordinate[]> & {
+    init: SheetCoordinate[];
+};
+export declare const watchWindowOpenAtom: import("jotai").PrimitiveAtom<boolean> & {
+    init: boolean;
+};
+export declare const watchWindowContextAtom: import("jotai").PrimitiveAtom<WatchWindowContext | null> & {
+    init: WatchWindowContext | null;
+};
+/** Number of mounted `WatchWindowHost`s — the grid offers "Add watch" only then. */
+export declare const watchWindowHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+export declare const useIsWatchWindowMounted: () => boolean;
+export declare const useRegisterWatchWindowHost: () => void;
+export declare const useWatchWindowEntries: () => [SheetCoordinate[], (args_0: SheetCoordinate[] | ((prev: SheetCoordinate[]) => SheetCoordinate[])) => void];
+export declare const useWatchWindowOpen: () => [boolean, (args_0: boolean | ((prev: boolean) => boolean)) => void];
+export declare const useWatchWindowContext: () => WatchWindowContext | null;
+export declare const useSetWatchWindowContext: () => (args_0: WatchWindowContext | ((prev: WatchWindowContext | null) => WatchWindowContext | null) | null) => void;
+/** Adds a cell (once) and opens the panel. */
+export declare const useAddWatch: () => (cell: SheetCoordinate) => void;
+export declare const useRemoveWatch: () => (cell: SheetCoordinate) => void;
+//# sourceMappingURL=watch-window.atom.d.ts.map

package/dist/esm/atoms/watch-window.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-window.atom.d.ts","sourceRoot":"","sources":["../../../atoms/watch-window.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACvD,iBAAiB,EAAE,CACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,CAAC;IACxB,UAAU,EAAE,CACV,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF,eAAO,MAAM,sBAAsB;;CAA+B,CAAC;AACnE,eAAO,MAAM,mBAAmB;;CAAc,CAAC;AAC/C,eAAO,MAAM,sBAAsB;;CAAwC,CAAC;AAE5E,oFAAoF;AACpF,eAAO,MAAM,wBAAwB;;CAAU,CAAC;AAEhD,eAAO,MAAM,uBAAuB,eACQ,CAAC;AAE7C,eAAO,MAAM,0BAA0B,YAMtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,mHAAwC,CAAC;AAC3E,eAAO,MAAM,kBAAkB,2EAAqC,CAAC;AACrE,eAAO,MAAM,qBAAqB,iCAA6C,CAAC;AAChF,eAAO,MAAM,wBAAwB,sHACD,CAAC;AAOrC,8CAA8C;AAC9C,eAAO,MAAM,WAAW,eAIb,eAAe,SAUzB,CAAC;AAEF,eAAO,MAAM,cAAc,eAGhB,eAAe,SAMzB,CAAC"}

package/dist/esm/atoms/watch-window.atom.js

@@ -0,0 +1,37 @@
+import { atom, useAtom, useAtomValue, useSetAtom } from "jotai";
+import { useCallback, useEffect } from "react";
+export const watchWindowEntriesAtom = atom([]);
+export const watchWindowOpenAtom = atom(false);
+export const watchWindowContextAtom = atom(null);
+/** Number of mounted `WatchWindowHost`s — the grid offers "Add watch" only then. */
+export const watchWindowHostCountAtom = atom(0);
+export const useIsWatchWindowMounted = () => useAtomValue(watchWindowHostCountAtom) > 0;
+export const useRegisterWatchWindowHost = () => {
+    const setCount = useSetAtom(watchWindowHostCountAtom);
+    useEffect(() => {
+        setCount((count) => count + 1);
+        return () => setCount((count) => count - 1);
+    }, [setCount]);
+};
+export const useWatchWindowEntries = () => useAtom(watchWindowEntriesAtom);
+export const useWatchWindowOpen = () => useAtom(watchWindowOpenAtom);
+export const useWatchWindowContext = () => useAtomValue(watchWindowContextAtom);
+export const useSetWatchWindowContext = () => useSetAtom(watchWindowContextAtom);
+const sameCell = (a, b) => a.sheetId === b.sheetId &&
+    a.rowIndex === b.rowIndex &&
+    a.columnIndex === b.columnIndex;
+/** Adds a cell (once) and opens the panel. */
+export const useAddWatch = () => {
+    const setEntries = useSetAtom(watchWindowEntriesAtom);
+    const setOpen = useSetAtom(watchWindowOpenAtom);
+    return useCallback((cell) => {
+        setEntries((entries) => entries.some((entry) => sameCell(entry, cell))
+            ? entries
+            : [...entries, cell]);
+        setOpen(true);
+    }, [setEntries, setOpen]);
+};
+export const useRemoveWatch = () => {
+    const setEntries = useSetAtom(watchWindowEntriesAtom);
+    return useCallback((cell) => setEntries((entries) => entries.filter((entry) => !sameCell(entry, cell))), [setEntries]);
+};

package/dist/esm/components/advanced-filter-dialog/index.d.ts

@@ -0,0 +1,28 @@
+import React from "react";
+import type { AdvancedFilterOptions } from "../../types";
+export type AdvancedFilterDialogProps = {
+    /** Controls visibility. */
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /** Default "List range" (A1 reference of the data block around the active cell). */
+    initialListRange: string;
+    /** Emits the resolved options; the host routes them to `onAdvancedFilter`. */
+    onApply(options: AdvancedFilterOptions): void;
+};
+/**
+ * Excel's Advanced Filter dialog: filter in place or copy to another
+ * location, a list range, a criteria range (header row + criteria rows),
+ * the copy destination and "Unique records only".
+ */
+export declare const AdvancedFilterDialog: React.MemoExoticComponent<({ open, onOpenChange, initialListRange, onApply }: AdvancedFilterDialogProps) => React.JSX.Element>;
+/**
+ * Host-mounted, atom-driven wrapper around {@link AdvancedFilterDialog}.
+ * Mount once in the host; the context menu opens it via
+ * `useOpenAdvancedFilterDialog` and only offers the item while a host is
+ * mounted.
+ */
+export declare const AdvancedFilterDialogHost: {
+    (): React.JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/advanced-filter-dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/advanced-filter-dialog/index.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAMtE,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE/E,MAAM,MAAM,yBAAyB,GAAG;IACtC,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,oFAAoF;IACpF,gBAAgB,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC/C,CAAC;AAQF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,gFACqB,yBAAyB,uBAsK9E,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;CAcpC,CAAC"}

package/dist/esm/components/advanced-filter-dialog/index.js

@@ -0,0 +1,125 @@
+import { Cross1Icon } from "@rowsncolumns/icons";
+import { Button, Dialog, DialogBody, DialogCloseButton, DialogContent, DialogDescription, DialogTitle, Input, Separator, } from "@rowsncolumns/ui";
+import { addressToCell, addressToSelection } from "@rowsncolumns/utils";
+import React, { memo, useCallback, useEffect, useState } from "react";
+import { useAdvancedFilterDialogState, useRegisterAdvancedFilterDialogHost, } from "../../atoms/advanced-filter-dialog.atom";
+const parseRange = (text) => {
+    const trimmed = text.trim().replace(/^[^!]*!/, "");
+    if (!/^\$?[A-Za-z]{1,3}\$?\d+(:\$?[A-Za-z]{1,3}\$?\d+)?$/.test(trimmed))
+        return undefined;
+    return addressToSelection(trimmed)?.range;
+};
+/**
+ * Excel's Advanced Filter dialog: filter in place or copy to another
+ * location, a list range, a criteria range (header row + criteria rows),
+ * the copy destination and "Unique records only".
+ */
+export const AdvancedFilterDialog = memo(({ open, onOpenChange, initialListRange, onApply }) => {
+    const [action, setAction] = useState("filter");
+    const [listRange, setListRange] = useState(initialListRange);
+    const [criteriaRange, setCriteriaRange] = useState("");
+    const [copyTo, setCopyTo] = useState("");
+    const [uniqueOnly, setUniqueOnly] = useState(false);
+    const [error, setError] = useState(undefined);
+    useEffect(() => {
+        if (open) {
+            setAction("filter");
+            setListRange(initialListRange);
+            setCriteriaRange("");
+            setCopyTo("");
+            setUniqueOnly(false);
+            setError(undefined);
+        }
+        // Only reset on open transitions.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [open]);
+    const submit = useCallback((event) => {
+        event.preventDefault();
+        const list = parseRange(listRange);
+        if (!list) {
+            setError("List range must be a range reference, e.g. A1:C20.");
+            return;
+        }
+        const criteria = parseRange(criteriaRange);
+        if (!criteria) {
+            setError("Criteria range must be a range reference, e.g. E1:F3.");
+            return;
+        }
+        let destination;
+        if (action === "copy") {
+            const cell = addressToCell(copyTo.trim().replace(/^[^!]*!/, "").split(":")[0] ?? "");
+            if (!copyTo.trim() || !cell) {
+                setError("Copy to must be a cell reference, e.g. H1.");
+                return;
+            }
+            destination = cell;
+        }
+        setError(undefined);
+        onApply({
+            listRange: list,
+            criteriaRange: criteria,
+            action,
+            copyTo: destination,
+            uniqueOnly,
+        });
+        onOpenChange(false);
+    }, [action, listRange, criteriaRange, copyTo, uniqueOnly, onApply, onOpenChange]);
+    return (React.createElement(Dialog, { open: open, onOpenChange: onOpenChange },
+        React.createElement(DialogContent, { className: "w-[400px] max-w-[92vw] pointer-events-auto" },
+            React.createElement(DialogTitle, null, "Advanced filter"),
+            React.createElement(DialogDescription, null, "Filter a list with a criteria range: conditions in one row AND together, rows OR together."),
+            React.createElement(DialogCloseButton, { onClick: () => onOpenChange(false) },
+                React.createElement(Cross1Icon, null)),
+            React.createElement(DialogBody, { className: "flex flex-col gap-3 font-system text-sm" },
+                React.createElement("form", { className: "flex flex-col gap-3", onSubmit: submit },
+                    React.createElement("div", { className: "flex flex-col gap-1", role: "radiogroup", "aria-label": "Action" },
+                        React.createElement("label", { className: "flex items-center gap-1" },
+                            React.createElement("input", { type: "radio", name: "advanced-filter-action", value: "filter", checked: action === "filter", onChange: () => setAction("filter") }),
+                            "Filter the list, in-place"),
+                        React.createElement("label", { className: "flex items-center gap-1" },
+                            React.createElement("input", { type: "radio", name: "advanced-filter-action", value: "copy", checked: action === "copy", onChange: () => setAction("copy") }),
+                            "Copy to another location")),
+                    React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                        "List range:",
+                        React.createElement(Input, { value: listRange, "aria-label": "List range", onChange: (e) => {
+                                setListRange(e.target.value);
+                                setError(undefined);
+                            } })),
+                    React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                        "Criteria range:",
+                        React.createElement(Input, { autoFocus: true, value: criteriaRange, "aria-label": "Criteria range", placeholder: "e.g. E1:F3", onChange: (e) => {
+                                setCriteriaRange(e.target.value);
+                                setError(undefined);
+                            } })),
+                    action === "copy" ? (React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                        "Copy to:",
+                        React.createElement(Input, { value: copyTo, "aria-label": "Copy to", placeholder: "e.g. H1", onChange: (e) => {
+                                setCopyTo(e.target.value);
+                                setError(undefined);
+                            } }))) : null,
+                    React.createElement("label", { className: "flex items-center gap-1" },
+                        React.createElement("input", { type: "checkbox", name: "uniqueOnly", checked: uniqueOnly, onChange: (e) => setUniqueOnly(e.target.checked) }),
+                        "Unique records only"),
+                    error ? (React.createElement("div", { role: "alert", className: "text-xs text-rnc-destructive" }, error)) : null,
+                    React.createElement(Separator, null),
+                    React.createElement("div", { className: "flex justify-end gap-2" },
+                        React.createElement(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onOpenChange(false) }, "Cancel"),
+                        React.createElement(Button, { type: "submit", size: "sm" }, "OK")))))));
+});
+AdvancedFilterDialog.displayName = "AdvancedFilterDialog";
+/**
+ * Host-mounted, atom-driven wrapper around {@link AdvancedFilterDialog}.
+ * Mount once in the host; the context menu opens it via
+ * `useOpenAdvancedFilterDialog` and only offers the item while a host is
+ * mounted.
+ */
+export const AdvancedFilterDialogHost = () => {
+    useRegisterAdvancedFilterDialogHost();
+    const [request, setRequest] = useAdvancedFilterDialogState();
+    const close = useCallback(() => setRequest(null), [setRequest]);
+    return (React.createElement(AdvancedFilterDialog, { open: request != null, onOpenChange: (open) => {
+            if (!open)
+                close();
+        }, initialListRange: request?.listRange ?? "", onApply: (options) => request?.onApply(options) }));
+};
+AdvancedFilterDialogHost.displayName = "AdvancedFilterDialogHost";

package/dist/esm/components/calculation-options-dialog/index.d.ts

@@ -0,0 +1,33 @@
+import React from "react";
+import type { IterativeCalculationOptions } from "../../types";
+/** Excel's defaults (File → Options → Formulas → Calculation options). */
+export declare const DEFAULT_ITERATIVE_CALCULATION: Required<IterativeCalculationOptions>;
+/**
+ * Normalise a form draft the way Excel does: iterations are a whole number
+ * 1…32767, maximum change is a non-negative number; anything else falls
+ * back to the current value.
+ */
+export declare const normalizeIterativeCalculation: (draft: {
+    enabled: boolean;
+    maxIterations: string;
+    maxChange: string;
+}, current: IterativeCalculationOptions | undefined) => IterativeCalculationOptions;
+export type CalculationOptionsDialogProps = {
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /** The workbook's current policy (host state / engine setting). */
+    value?: IterativeCalculationOptions | null;
+    /**
+     * Receives the new policy on OK. Legacy engine: feed it back into the
+     * `iterativeCalculation` prop of `useSpreadsheetState`; rnc engine: the
+     * `set-iterative-calculation` command.
+     */
+    onChange(next: IterativeCalculationOptions): void;
+};
+/**
+ * Excel's iterative-calculation options (enable / maximum iterations /
+ * maximum change) as a dialog. Purely presentational — the host owns the
+ * setting and applies it through `onChange`.
+ */
+export declare const CalculationOptionsDialog: React.MemoExoticComponent<({ open, onOpenChange, value, onChange }: CalculationOptionsDialogProps) => React.JSX.Element>;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/calculation-options-dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/calculation-options-dialog/index.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAyB,MAAM,OAAO,CAAC;AAE9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE/D,0EAA0E;AAC1E,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAAC,2BAA2B,CAK7E,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GACxC,OAAO;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EACrE,SAAS,2BAA2B,GAAG,SAAS,KAC/C,2BAeF,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,mEAAmE;IACnE,KAAK,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,2BAA2B,GAAG,IAAI,CAAC;CACnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,sEACO,6BAA6B,uBAgFxE,CAAC"}

package/dist/esm/components/calculation-options-dialog/index.js

@@ -0,0 +1,61 @@
+import { Button, Dialog, DialogBody, DialogCloseButton, DialogContent, DialogTitle, Input, Separator, } from "@rowsncolumns/ui";
+import React, { memo, useState } from "react";
+/** Excel's defaults (File → Options → Formulas → Calculation options). */
+export const DEFAULT_ITERATIVE_CALCULATION = {
+    enabled: false,
+    maxIterations: 100,
+    maxChange: 0.001,
+};
+/**
+ * Normalise a form draft the way Excel does: iterations are a whole number
+ * 1…32767, maximum change is a non-negative number; anything else falls
+ * back to the current value.
+ */
+export const normalizeIterativeCalculation = (draft, current) => {
+    const parse = (text) => (text.trim() === "" ? NaN : Number(text));
+    const iterations = parse(draft.maxIterations);
+    const change = parse(draft.maxChange);
+    return {
+        enabled: draft.enabled,
+        maxIterations: Number.isFinite(iterations) && iterations >= 1
+            ? Math.min(32767, Math.floor(iterations))
+            : current?.maxIterations ?? DEFAULT_ITERATIVE_CALCULATION.maxIterations,
+        maxChange: Number.isFinite(change) && change >= 0
+            ? change
+            : current?.maxChange ?? DEFAULT_ITERATIVE_CALCULATION.maxChange,
+    };
+};
+/**
+ * Excel's iterative-calculation options (enable / maximum iterations /
+ * maximum change) as a dialog. Purely presentational — the host owns the
+ * setting and applies it through `onChange`.
+ */
+export const CalculationOptionsDialog = memo(({ open, onOpenChange, value, onChange }) => {
+    const [enabled, setEnabled] = useState(value?.enabled ?? false);
+    const [maxIterations, setMaxIterations] = useState(String(value?.maxIterations ?? DEFAULT_ITERATIVE_CALCULATION.maxIterations));
+    const [maxChange, setMaxChange] = useState(String(value?.maxChange ?? DEFAULT_ITERATIVE_CALCULATION.maxChange));
+    return (React.createElement(Dialog, { open: open, onOpenChange: onOpenChange, modal: true },
+        React.createElement(DialogContent, { className: "w-[360px] max-w-[92vw] pointer-events-auto" },
+            React.createElement(DialogTitle, null, "Calculation options"),
+            React.createElement(DialogCloseButton, null),
+            React.createElement(DialogBody, { className: "flex flex-col gap-3" },
+                React.createElement("form", { className: "flex flex-col gap-3", onSubmit: (e) => {
+                        e.preventDefault();
+                        onChange(normalizeIterativeCalculation({ enabled, maxIterations, maxChange }, value ?? undefined));
+                        onOpenChange(false);
+                    } },
+                    React.createElement("label", { className: "flex items-center gap-2 text-xs font-medium" },
+                        React.createElement("input", { type: "checkbox", checked: enabled, onChange: (e) => setEnabled(e.target.checked) }),
+                        "Enable iterative calculation"),
+                    React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                        "Maximum iterations:",
+                        React.createElement(Input, { type: "number", min: 1, max: 32767, step: 1, value: maxIterations, disabled: !enabled, onChange: (e) => setMaxIterations(e.target.value) })),
+                    React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                        "Maximum change:",
+                        React.createElement(Input, { type: "number", min: 0, step: "any", value: maxChange, disabled: !enabled, onChange: (e) => setMaxChange(e.target.value) })),
+                    React.createElement(Separator, null),
+                    React.createElement("div", { className: "flex justify-end gap-2" },
+                        React.createElement(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onOpenChange(false) }, "Cancel"),
+                        React.createElement(Button, { type: "submit", size: "sm" }, "OK")))))));
+});
+CalculationOptionsDialog.displayName = "CalculationOptionsDialog";

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;AA2Kf,OAAO,KAAK,EAEV,QAAQ,EAST,MAAM,aAAa,CAAC;AAarB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,WAAW,CAAC;AA2wJnB,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":"AA2CA,OAAO,KASN,MAAM,OAAO,CAAC;AAsLf,OAAO,KAAK,EAEV,QAAQ,EAST,MAAM,aAAa,CAAC;AAarB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,WAAW,CAAC;AA61JnB,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"}