@rowsncolumns/spreadsheet 10.2.73 → 10.2.75

package/dist/esm/components/go-to-dialog/index.js

@@ -0,0 +1,124 @@
+import { Button, cn, Dialog, DialogBody, DialogCloseButton, DialogContent, DialogTitle, Input, Separator, } from "@rowsncolumns/ui";
+import { cellToAddress } from "@rowsncolumns/utils";
+import React, { memo, useCallback, useState } from "react";
+import { resolveGoToReference } from "../../api/go-to";
+import { GO_TO_SPECIAL_OPTIONS, } from "../../api/go-to-special";
+import { useGoToDialogState, useRegisterGoToDialogHost, } from "../../atoms/go-to-dialog.atom";
+const INVALID_REFERENCE = "Reference is not valid.";
+const NO_CELLS_FOUND = "No cells were found.";
+/**
+ * Excel's Go To dialog (`Ctrl+G` / `F5`): type a cell or range reference,
+ * optionally sheet-qualified, or pick a defined name, and the selection
+ * jumps there. Resolution is delegated to `resolve` so the dialog stays
+ * UI-only.
+ */
+export const GoToDialog = memo(({ open, onOpenChange, namedRanges, currentAddress, resolve, onNavigate, special, }) => {
+    const [reference, setReference] = useState("");
+    const [error, setError] = useState(undefined);
+    const [showSpecial, setShowSpecial] = useState(false);
+    const [specialKind, setSpecialKind] = useState("blanks");
+    const selectSpecial = useCallback(() => {
+        if (!special)
+            return;
+        const ranges = special.resolve(specialKind);
+        if (!ranges.length) {
+            setError(NO_CELLS_FOUND);
+            return;
+        }
+        special.onSelectRanges(ranges);
+        onOpenChange(false);
+    }, [special, specialKind, onOpenChange]);
+    const navigate = useCallback((text) => {
+        const range = resolve(text);
+        if (!range) {
+            setError(INVALID_REFERENCE);
+            return;
+        }
+        onNavigate(range);
+        onOpenChange(false);
+    }, [resolve, onNavigate, onOpenChange]);
+    const names = (namedRanges ?? []).filter((range) => range.range && !range.hidden);
+    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, showSpecial ? "Go To Special" : "Go To"),
+            React.createElement(DialogCloseButton, null),
+            React.createElement(DialogBody, { className: "flex flex-col gap-3" }, showSpecial && special ? (React.createElement("form", { className: "flex flex-col gap-3", onSubmit: (e) => {
+                    e.preventDefault();
+                    selectSpecial();
+                } },
+                React.createElement("fieldset", { className: "flex flex-col gap-1 border-0 p-0 m-0" },
+                    React.createElement("legend", { className: "text-xs font-medium pb-1" }, "Select"),
+                    GO_TO_SPECIAL_OPTIONS.map(({ kind, label }) => (React.createElement("label", { key: kind, className: "flex items-center gap-2 text-xs cursor-pointer" },
+                        React.createElement("input", { type: "radio", name: "goToSpecial", value: kind, checked: specialKind === kind, onChange: () => {
+                                setSpecialKind(kind);
+                                setError(undefined);
+                            } }),
+                        label)))),
+                error ? (React.createElement("div", { role: "alert", className: "text-xs text-rnc-destructive" }, error)) : null,
+                React.createElement(Separator, null),
+                React.createElement("div", { className: "flex justify-between gap-2" },
+                    React.createElement(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => {
+                            setShowSpecial(false);
+                            setError(undefined);
+                        } }, "Back"),
+                    React.createElement("div", { className: "flex gap-2" },
+                        React.createElement(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onOpenChange(false) }, "Cancel"),
+                        React.createElement(Button, { type: "submit", size: "sm" }, "OK"))))) : (React.createElement("form", { className: "flex flex-col gap-3", onSubmit: (e) => {
+                    e.preventDefault();
+                    navigate(reference);
+                } },
+                React.createElement("div", { className: "flex flex-col gap-1" },
+                    React.createElement("span", { className: "text-xs font-medium" }, "Go to:"),
+                    React.createElement("div", { role: "listbox", "aria-label": "Defined names", className: "h-[140px] overflow-auto rounded border border-rnc-border text-xs" }, names.length === 0 ? (React.createElement("div", { className: "px-2 py-1.5 text-rnc-foreground/60" }, "No defined names")) : (names.map((range) => (React.createElement("div", { key: String(range.namedRangeId), role: "option", "aria-selected": reference === range.name, className: cn("px-2 py-1 cursor-default select-none hover:bg-rnc-accent", reference === range.name && "bg-rnc-accent"), onClick: () => {
+                            setReference(range.name);
+                            setError(undefined);
+                        }, onDoubleClick: () => navigate(range.name) }, range.name)))))),
+                React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                    "Reference:",
+                    React.createElement(Input, { autoFocus: true, value: reference, placeholder: currentAddress, "aria-invalid": error ? true : undefined, onChange: (e) => {
+                            setReference(e.target.value);
+                            setError(undefined);
+                        } })),
+                error ? (React.createElement("div", { role: "alert", className: "text-xs text-rnc-destructive" }, error)) : null,
+                React.createElement(Separator, null),
+                React.createElement("div", { className: "flex justify-between gap-2" },
+                    special ? (React.createElement(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => {
+                            setShowSpecial(true);
+                            setError(undefined);
+                        } }, "Special\u2026")) : (React.createElement("span", null)),
+                    React.createElement("div", { className: "flex gap-2" },
+                        React.createElement(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onOpenChange(false) }, "Cancel"),
+                        React.createElement(Button, { type: "submit", size: "sm", disabled: !reference.trim() }, "OK")))))))));
+});
+GoToDialog.displayName = "GoToDialog";
+const currentAddressOf = (request) => {
+    const address = cellToAddress(request.activeCell) ?? "";
+    const sheetName = request.getSheetName?.(request.sheetId);
+    return sheetName ? `${sheetName}!${address}` : address;
+};
+/**
+ * Host-mounted, atom-driven wrapper around {@link GoToDialog}. Mount it once
+ * in the host alongside the other editor dialogs; the grid opens it on
+ * `Ctrl+G` / `F5` (unless the host handles `onRequestGoTo` itself).
+ */
+export const GoToDialogHost = () => {
+    useRegisterGoToDialogHost();
+    const [request, setRequest] = useGoToDialogState();
+    const close = useCallback(() => setRequest(null), [setRequest]);
+    const resolve = useCallback((reference) => request
+        ? resolveGoToReference(reference, {
+            sheetId: request.sheetId,
+            namedRanges: request.namedRanges,
+            getSheetId: request.getSheetId,
+            rowCount: request.rowCount,
+            columnCount: request.columnCount,
+        })
+        : undefined, [request]);
+    if (!request)
+        return null;
+    return (React.createElement(GoToDialog, { open: true, onOpenChange: (open) => {
+            if (!open)
+                close();
+        }, namedRanges: request.namedRanges, currentAddress: currentAddressOf(request), resolve: resolve, onNavigate: request.onNavigate, special: request.special }));
+};
+GoToDialogHost.displayName = "GoToDialogHost";

package/dist/esm/components/goal-seek-dialog/index.d.ts

@@ -0,0 +1,32 @@
+import React from "react";
+import type { GoalSeekResult } from "../../types";
+export type GoalSeekDialogProps = {
+    /** Controls visibility. */
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /** Default "Set cell" (A1 reference of the active cell). */
+    initialSetCell: string;
+    /**
+     * Runs the search with the three fields (A1 references + the numeric
+     * target). Resolves to the result, or `undefined` when the engine reports
+     * none (the rnc engine iterates natively and streams the cells back).
+     */
+    onApply(setCell: string, targetValue: number, changingCell: string): Promise<GoalSeekResult | undefined>;
+};
+/** Excel's status sentence for a finished search. */
+export declare const goalSeekStatusText: (setCell: string, result: GoalSeekResult | undefined) => string;
+/**
+ * Excel's Goal Seek dialog: Set cell / To value / By changing cell, then the
+ * Goal Seek Status sentence with target and current value.
+ */
+export declare const GoalSeekDialog: React.MemoExoticComponent<({ open, onOpenChange, initialSetCell, onApply }: GoalSeekDialogProps) => React.JSX.Element>;
+/**
+ * Host-mounted, atom-driven wrapper around {@link GoalSeekDialog}. Mount
+ * once in the host; the context menu opens it via `useOpenGoalSeekDialog`
+ * and only offers the item while a host is mounted.
+ */
+export declare const GoalSeekDialogHost: {
+    (): React.JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/goal-seek-dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/goal-seek-dialog/index.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAMtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,mBAAmB,GAAG;IAChC,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,OAAO,CACL,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;CACxC,CAAC;AAKF,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,GAC7B,SAAS,MAAM,EACf,QAAQ,cAAc,GAAG,SAAS,KACjC,MAKF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,8EACyB,mBAAmB,uBAyJtE,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;CAkB9B,CAAC"}

package/dist/esm/components/goal-seek-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 } from "@rowsncolumns/utils";
+import React, { memo, useCallback, useEffect, useState } from "react";
+import { useGoalSeekDialogState, useRegisterGoalSeekDialogHost, } from "../../atoms/goal-seek-dialog.atom";
+const isCellReference = (text) => /^\$?[A-Za-z]{1,3}\$?\d+$/.test(text.trim()) && addressToCell(text.trim()) != null;
+/** Excel's status sentence for a finished search. */
+export const goalSeekStatusText = (setCell, result) => {
+    if (!result)
+        return `Goal Seeking with Cell ${setCell} finished.`;
+    return result.status === "found"
+        ? `Goal Seeking with Cell ${setCell} found a solution.`
+        : `Goal Seeking with Cell ${setCell} may not have found a solution.`;
+};
+/**
+ * Excel's Goal Seek dialog: Set cell / To value / By changing cell, then the
+ * Goal Seek Status sentence with target and current value.
+ */
+export const GoalSeekDialog = memo(({ open, onOpenChange, initialSetCell, onApply }) => {
+    const [setCell, setSetCell] = useState(initialSetCell);
+    const [target, setTarget] = useState("");
+    const [changingCell, setChangingCell] = useState("");
+    const [error, setError] = useState(undefined);
+    const [busy, setBusy] = useState(false);
+    const [result, setResult] = useState(undefined);
+    useEffect(() => {
+        if (open) {
+            setSetCell(initialSetCell);
+            setTarget("");
+            setChangingCell("");
+            setError(undefined);
+            setBusy(false);
+            setResult(undefined);
+        }
+        // Only reset on open transitions.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [open]);
+    const submit = useCallback(async (event) => {
+        event.preventDefault();
+        const targetValue = Number(target.trim());
+        if (!isCellReference(setCell)) {
+            setError("Set cell must be a single cell reference, e.g. B4.");
+            return;
+        }
+        if (target.trim() === "" || !Number.isFinite(targetValue)) {
+            setError("To value must be a number.");
+            return;
+        }
+        if (!isCellReference(changingCell)) {
+            setError("By changing cell must be a single cell reference, e.g. A1.");
+            return;
+        }
+        setError(undefined);
+        setBusy(true);
+        try {
+            const outcome = await onApply(setCell.trim().toUpperCase(), targetValue, changingCell.trim().toUpperCase());
+            setResult({ setCell: setCell.trim().toUpperCase(), result: outcome });
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : "Goal Seek failed.");
+        }
+        finally {
+            setBusy(false);
+        }
+    }, [setCell, target, changingCell, onApply]);
+    return (React.createElement(Dialog, { open: open, onOpenChange: onOpenChange },
+        React.createElement(DialogContent, { className: "w-[360px] max-w-[92vw] pointer-events-auto" },
+            React.createElement(DialogTitle, null, result ? "Goal Seek Status" : "Goal Seek"),
+            React.createElement(DialogDescription, null, "Find the input value that makes a formula reach a target."),
+            React.createElement(DialogCloseButton, { onClick: () => onOpenChange(false) },
+                React.createElement(Cross1Icon, null)),
+            React.createElement(DialogBody, { className: "flex flex-col gap-3 font-system text-sm" }, result ? (React.createElement("div", { className: "flex flex-col gap-2", role: "status" },
+                React.createElement("div", null, goalSeekStatusText(result.setCell, result.result)),
+                result.result ? (React.createElement("dl", { className: "grid grid-cols-2 gap-1 text-xs" },
+                    React.createElement("dt", { className: "text-rnc-foreground/70" }, "Target value:"),
+                    React.createElement("dd", null, result.result.targetValue),
+                    React.createElement("dt", { className: "text-rnc-foreground/70" }, "Current value:"),
+                    React.createElement("dd", null, result.result.currentValue === undefined
+                        ? "—"
+                        : String(result.result.currentValue)))) : null,
+                React.createElement(Separator, null),
+                React.createElement("div", { className: "flex justify-end gap-2" },
+                    React.createElement(Button, { size: "sm", type: "button", onClick: () => onOpenChange(false) }, "OK")))) : (React.createElement("form", { className: "flex flex-col gap-3", onSubmit: submit },
+                React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                    "Set cell:",
+                    React.createElement(Input, { autoFocus: true, value: setCell, "aria-label": "Set cell", onChange: (e) => {
+                            setSetCell(e.target.value);
+                            setError(undefined);
+                        } })),
+                React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                    "To value:",
+                    React.createElement(Input, { value: target, "aria-label": "To value", inputMode: "decimal", onChange: (e) => {
+                            setTarget(e.target.value);
+                            setError(undefined);
+                        } })),
+                React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                    "By changing cell:",
+                    React.createElement(Input, { value: changingCell, "aria-label": "By changing cell", onChange: (e) => {
+                            setChangingCell(e.target.value);
+                            setError(undefined);
+                        } })),
+                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", disabled: busy }, busy ? "Seeking…" : "OK"))))))));
+});
+GoalSeekDialog.displayName = "GoalSeekDialog";
+/**
+ * Host-mounted, atom-driven wrapper around {@link GoalSeekDialog}. Mount
+ * once in the host; the context menu opens it via `useOpenGoalSeekDialog`
+ * and only offers the item while a host is mounted.
+ */
+export const GoalSeekDialogHost = () => {
+    useRegisterGoalSeekDialogHost();
+    const [request, setRequest] = useGoalSeekDialogState();
+    const close = useCallback(() => setRequest(null), [setRequest]);
+    return (React.createElement(GoalSeekDialog, { open: request != null, onOpenChange: (open) => {
+            if (!open)
+                close();
+        }, initialSetCell: request?.setCell ?? "", onApply: (setCell, targetValue, changingCell) => request
+            ? request.onApply(setCell, targetValue, changingCell)
+            : Promise.resolve(undefined) }));
+};
+GoalSeekDialogHost.displayName = "GoalSeekDialogHost";

package/dist/esm/components/paste-special-dialog/index.d.ts

@@ -0,0 +1,29 @@
+import React from "react";
+import type { PasteSpecialOptions } from "../../hooks/use-copy-paste-cut";
+export type PasteSpecialDialogProps = {
+    /** Controls visibility. */
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /**
+     * Emits the assembled request. The host routes it to the grid's
+     * `paste(options)`; the dialog never touches the clipboard itself.
+     */
+    onApply(options: PasteSpecialOptions): void;
+};
+/**
+ * Excel's Paste Special dialog: what to paste (all / formulas / values /
+ * formats), an arithmetic operation against the destination, skip blanks and
+ * transpose. Every choice composes into one `PasteSpecialOptions` request.
+ */
+export declare const PasteSpecialDialog: React.MemoExoticComponent<({ open, onOpenChange, onApply }: PasteSpecialDialogProps) => React.JSX.Element>;
+/**
+ * Host-mounted, atom-driven wrapper around {@link PasteSpecialDialog}. Mount
+ * it once in the host alongside the other editor dialogs; the grid opens it
+ * from the context menu ("Paste special…") and `Ctrl+Alt+V`. Remounted per
+ * request so each opening starts from Excel's defaults.
+ */
+export declare const PasteSpecialDialogHost: {
+    (): React.JSX.Element | null;
+    displayName: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/paste-special-dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/paste-special-dialog/index.tsx"],"names":[],"mappings":"AASA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAM3D,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAoBxC,MAAM,MAAM,uBAAuB,GAAG;IACpC,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC7C,CAAC;AAyCF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,8DACK,uBAAuB,uBA2F1D,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;CAclC,CAAC"}

package/dist/esm/components/paste-special-dialog/index.js

@@ -0,0 +1,90 @@
+import { Button, Dialog, DialogBody, DialogCloseButton, DialogContent, DialogTitle, Separator, } from "@rowsncolumns/ui";
+import React, { memo, useCallback, useState } from "react";
+import { usePasteSpecialDialogState, useRegisterPasteSpecialDialogHost, } from "../../atoms/paste-special-dialog.atom";
+const PASTE_MODES = [
+    { value: "all", label: "All" },
+    { value: "formulas", label: "Formulas" },
+    { value: "values", label: "Values" },
+    { value: "formats", label: "Formats" },
+];
+const OPERATIONS = [
+    { value: "none", label: "None" },
+    { value: "add", label: "Add" },
+    { value: "subtract", label: "Subtract" },
+    { value: "multiply", label: "Multiply" },
+    { value: "divide", label: "Divide" },
+];
+const RadioGroup = ({ name, legend, value, options, onChange, disabled, }) => (React.createElement("fieldset", { className: "flex flex-col gap-1 min-w-0 disabled:opacity-50", disabled: disabled },
+    React.createElement("legend", { className: "text-xs font-medium mb-1" }, legend),
+    options.map((option) => (React.createElement("label", { key: option.value, className: "flex items-center gap-2 text-xs py-0.5 cursor-pointer" },
+        React.createElement("input", { type: "radio", name: name, value: option.value, checked: value === option.value, disabled: disabled, onChange: () => onChange(option.value) }),
+        option.label)))));
+/**
+ * Excel's Paste Special dialog: what to paste (all / formulas / values /
+ * formats), an arithmetic operation against the destination, skip blanks and
+ * transpose. Every choice composes into one `PasteSpecialOptions` request.
+ */
+export const PasteSpecialDialog = memo(({ open, onOpenChange, onApply }) => {
+    const [paste, setPaste] = useState("all");
+    const [operation, setOperation] = useState("none");
+    const [skipBlanks, setSkipBlanks] = useState(false);
+    const [transpose, setTranspose] = useState(false);
+    // Excel greys Operation out under Paste → Formats (a formats paste never
+    // changes destination values); the choice is kept but not applied.
+    const operationDisabled = paste === "formats";
+    const commit = useCallback(() => {
+        onApply({
+            paste,
+            operation: operation === "none" || operationDisabled ? undefined : operation,
+            skipBlanks,
+            transpose,
+        });
+        onOpenChange(false);
+    }, [
+        onApply,
+        onOpenChange,
+        paste,
+        operation,
+        operationDisabled,
+        skipBlanks,
+        transpose,
+    ]);
+    return (React.createElement(Dialog, { open: open, onOpenChange: onOpenChange, modal: true },
+        React.createElement(DialogContent, { className: "w-[380px] max-w-[92vw] pointer-events-auto" },
+            React.createElement(DialogTitle, null, "Paste Special"),
+            React.createElement(DialogCloseButton, null),
+            React.createElement(DialogBody, { className: "flex flex-col gap-4" },
+                React.createElement("div", { className: "grid grid-cols-2 gap-4" },
+                    React.createElement(RadioGroup, { name: "paste-special-paste", legend: "Paste", value: paste, options: PASTE_MODES, onChange: setPaste }),
+                    React.createElement(RadioGroup, { name: "paste-special-operation", legend: "Operation", value: operation, options: OPERATIONS, onChange: setOperation, disabled: operationDisabled })),
+                React.createElement("div", { className: "flex flex-col gap-1" },
+                    React.createElement("label", { className: "flex items-center gap-2 text-xs py-0.5 cursor-pointer" },
+                        React.createElement("input", { type: "checkbox", checked: skipBlanks, onChange: (e) => setSkipBlanks(e.target.checked) }),
+                        "Skip blanks"),
+                    React.createElement("label", { className: "flex items-center gap-2 text-xs py-0.5 cursor-pointer" },
+                        React.createElement("input", { type: "checkbox", checked: transpose, onChange: (e) => setTranspose(e.target.checked) }),
+                        "Transpose")),
+                React.createElement(Separator, null),
+                React.createElement("div", { className: "flex justify-end gap-2" },
+                    React.createElement(Button, { variant: "outline", size: "sm", onClick: () => onOpenChange(false) }, "Cancel"),
+                    React.createElement(Button, { size: "sm", onClick: commit }, "OK"))))));
+});
+PasteSpecialDialog.displayName = "PasteSpecialDialog";
+/**
+ * Host-mounted, atom-driven wrapper around {@link PasteSpecialDialog}. Mount
+ * it once in the host alongside the other editor dialogs; the grid opens it
+ * from the context menu ("Paste special…") and `Ctrl+Alt+V`. Remounted per
+ * request so each opening starts from Excel's defaults.
+ */
+export const PasteSpecialDialogHost = () => {
+    useRegisterPasteSpecialDialogHost();
+    const [request, setRequest] = usePasteSpecialDialogState();
+    const close = useCallback(() => setRequest(null), [setRequest]);
+    if (!request)
+        return null;
+    return (React.createElement(PasteSpecialDialog, { open: true, onOpenChange: (open) => {
+            if (!open)
+                close();
+        }, onApply: request.onApply }));
+};
+PasteSpecialDialogHost.displayName = "PasteSpecialDialogHost";

package/dist/esm/components/remove-duplicates-dialog/index.d.ts

@@ -0,0 +1,37 @@
+import React from "react";
+import { type RemoveDuplicatesDialogColumn } from "../../atoms/remove-duplicates-dialog.atom";
+import type { RemoveDuplicatesOptions } from "../../types";
+export type { RemoveDuplicatesDialogColumn };
+export type RemoveDuplicatesDialogProps = {
+    /** Controls visibility. */
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /** Columns of the range, in sheet order. All start checked. */
+    columns: RemoveDuplicatesDialogColumn[];
+    /** Initial state of "My data has headers". */
+    initialHasHeader?: boolean;
+    /**
+     * Emits the chosen compare columns and header flag. The host routes these
+     * to `onRemoveDuplicates`; the dialog never touches state directly.
+     */
+    onApply(options: RemoveDuplicatesOptions): void;
+};
+/**
+ * Excel's "Remove Duplicates" dialog: a "My data has headers" toggle plus a
+ * checklist of the columns that decide whether two rows are duplicates.
+ * Unchecked columns still travel with their row — only the comparison
+ * narrows.
+ */
+export declare const RemoveDuplicatesDialog: React.MemoExoticComponent<({ open, onOpenChange, columns, initialHasHeader, onApply, }: RemoveDuplicatesDialogProps) => React.JSX.Element>;
+/**
+ * Host-mounted, atom-driven wrapper around {@link RemoveDuplicatesDialog}.
+ * Mount this once in the host (alongside the other editor dialogs); the
+ * context menu opens it via `useOpenRemoveDuplicatesDialog`. While no host is
+ * mounted the context menu keeps its one-click de-dupe, so adopting the
+ * dialog is opt-in per host.
+ */
+export declare const RemoveDuplicatesDialogHost: {
+    (): React.JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/remove-duplicates-dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/remove-duplicates-dialog/index.tsx"],"names":[],"mappings":"AAWA,OAAO,KAA0D,MAAM,OAAO,CAAC;AAE/E,OAAO,EACL,KAAK,4BAA4B,EAGlC,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,YAAY,EAAE,4BAA4B,EAAE,CAAC;AAE7C,MAAM,MAAM,2BAA2B,GAAG;IACxC,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,+DAA+D;IAC/D,OAAO,EAAE,4BAA4B,EAAE,CAAC;IACxC,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACjD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,0FAO9B,2BAA2B,uBAqI/B,CAAC;AAIF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;CAetC,CAAC"}

package/dist/esm/components/remove-duplicates-dialog/index.js

@@ -0,0 +1,82 @@
+import { Cross1Icon } from "@rowsncolumns/icons";
+import { Button, Dialog, DialogBody, DialogCloseButton, DialogContent, DialogDescription, DialogTitle, Separator, } from "@rowsncolumns/ui";
+import React, { memo, useCallback, useEffect, useMemo, useState } from "react";
+import { useRegisterRemoveDuplicatesDialogHost, useRemoveDuplicatesDialogState, } from "../../atoms/remove-duplicates-dialog.atom";
+/**
+ * Excel's "Remove Duplicates" dialog: a "My data has headers" toggle plus a
+ * checklist of the columns that decide whether two rows are duplicates.
+ * Unchecked columns still travel with their row — only the comparison
+ * narrows.
+ */
+export const RemoveDuplicatesDialog = memo(({ open, onOpenChange, columns, initialHasHeader = false, onApply, }) => {
+    const allColumnIndexes = useMemo(() => columns.map((column) => column.columnIndex), [columns]);
+    const [hasHeader, setHasHeader] = useState(initialHasHeader);
+    const [checked, setChecked] = useState(() => new Set(allColumnIndexes));
+    // Re-seed when reopened for a different range.
+    useEffect(() => {
+        if (open) {
+            setHasHeader(initialHasHeader);
+            setChecked(new Set(allColumnIndexes));
+        }
+        // Only reset on open transitions.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [open]);
+    const toggleColumn = useCallback((columnIndex) => {
+        setChecked((prev) => {
+            const next = new Set(prev);
+            if (next.has(columnIndex)) {
+                next.delete(columnIndex);
+            }
+            else {
+                next.add(columnIndex);
+            }
+            return next;
+        });
+    }, []);
+    const commit = useCallback(() => {
+        const columnIndices = allColumnIndexes.filter((columnIndex) => checked.has(columnIndex));
+        onApply({ columnIndices, hasHeader });
+        onOpenChange(false);
+    }, [allColumnIndexes, checked, hasHeader, onApply, onOpenChange]);
+    return (React.createElement(Dialog, { open: open, onOpenChange: onOpenChange },
+        React.createElement(DialogContent, { className: "w-[420px] max-w-[92vw] pointer-events-auto" },
+            React.createElement(DialogTitle, null, "Remove duplicates"),
+            React.createElement(DialogDescription, null, "Select the columns that contain duplicate values. Rows that match in every selected column are removed, keeping the first one."),
+            React.createElement(DialogCloseButton, { onClick: () => onOpenChange(false) },
+                React.createElement(Cross1Icon, null)),
+            React.createElement(DialogBody, { className: "flex flex-col gap-3" },
+                React.createElement("label", { className: "font-system text-sm flex items-center gap-1" },
+                    React.createElement("input", { type: "checkbox", name: "hasHeader", checked: hasHeader, onChange: (e) => setHasHeader(e.target.checked) }),
+                    "My data has headers"),
+                React.createElement("div", { className: "flex gap-2" },
+                    React.createElement(Button, { variant: "outline", size: "xs", type: "button", onClick: () => setChecked(new Set(allColumnIndexes)) }, "Select all"),
+                    React.createElement(Button, { variant: "outline", size: "xs", type: "button", onClick: () => setChecked(new Set()) }, "Unselect all")),
+                React.createElement("div", { className: "flex flex-col gap-1 max-h-[240px] overflow-y-auto border border-rnc-border rounded p-2", role: "group", "aria-label": "Columns" }, columns.map((column) => {
+                    const text = hasHeader && column.header ? column.header : column.label;
+                    return (React.createElement("label", { key: column.columnIndex, className: "font-system text-sm flex items-center gap-1" },
+                        React.createElement("input", { type: "checkbox", name: `column-${column.columnIndex}`, checked: checked.has(column.columnIndex), onChange: () => toggleColumn(column.columnIndex) }),
+                        React.createElement("span", { className: "truncate", title: text }, text)));
+                })),
+                React.createElement(Separator, null),
+                React.createElement("div", { className: "flex justify-end gap-2" },
+                    React.createElement(Button, { variant: "outline", size: "sm", type: "button", onClick: () => onOpenChange(false) }, "Cancel"),
+                    React.createElement(Button, { size: "sm", type: "button", onClick: commit, disabled: checked.size === 0 }, "OK"))))));
+});
+RemoveDuplicatesDialog.displayName = "RemoveDuplicatesDialog";
+/**
+ * Host-mounted, atom-driven wrapper around {@link RemoveDuplicatesDialog}.
+ * Mount this once in the host (alongside the other editor dialogs); the
+ * context menu opens it via `useOpenRemoveDuplicatesDialog`. While no host is
+ * mounted the context menu keeps its one-click de-dupe, so adopting the
+ * dialog is opt-in per host.
+ */
+export const RemoveDuplicatesDialogHost = () => {
+    useRegisterRemoveDuplicatesDialogHost();
+    const [request, setRequest] = useRemoveDuplicatesDialogState();
+    const close = useCallback(() => setRequest(null), [setRequest]);
+    return (React.createElement(RemoveDuplicatesDialog, { open: request != null, onOpenChange: (open) => {
+            if (!open)
+                close();
+        }, columns: request?.columns ?? [], initialHasHeader: request?.hasHeader, onApply: (options) => request?.onApply(options) }));
+};
+RemoveDuplicatesDialogHost.displayName = "RemoveDuplicatesDialogHost";

package/dist/esm/components/subtotal-dialog/index.d.ts

@@ -0,0 +1,30 @@
+import React from "react";
+import { type SubtotalDialogChoices, type SubtotalDialogColumn } from "../../atoms/subtotal-dialog.atom";
+export type { SubtotalDialogChoices, SubtotalDialogColumn };
+export type SubtotalDialogProps = {
+    /** Controls visibility. */
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /** Columns of the range, in sheet order. */
+    columns: SubtotalDialogColumn[];
+    /** Initial state of "My data has headers". */
+    initialHasHeader?: boolean;
+    /** Emits the choices; the host adds the range and routes to `onSubtotal`. */
+    onApply(choices: SubtotalDialogChoices): void;
+};
+/**
+ * Excel's Subtotal dialog: "At each change in" (group column), "Use
+ * function", "Add subtotal to" (aggregate columns), "Replace current
+ * subtotals". Summary rows are always placed below the data.
+ */
+export declare const SubtotalDialog: React.MemoExoticComponent<({ open, onOpenChange, columns, initialHasHeader, onApply, }: SubtotalDialogProps) => React.JSX.Element>;
+/**
+ * Host-mounted, atom-driven wrapper around {@link SubtotalDialog}. Mount
+ * once in the host; the context menu opens it via `useOpenSubtotalDialog`
+ * and only offers the item while a host is mounted.
+ */
+export declare const SubtotalDialogHost: {
+    (): React.JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/subtotal-dialog/index.tsx"],"names":[],"mappings":"AAWA,OAAO,KAA0D,MAAM,OAAO,CAAC;AAE/E,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAG1B,MAAM,kCAAkC,CAAC;AAG1C,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;AAoB5D,MAAM,MAAM,mBAAmB,GAAG;IAChC,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,4CAA4C;IAC5C,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6EAA6E;IAC7E,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC/C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,0FAOtB,mBAAmB,uBAoKvB,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;CAe9B,CAAC"}