@rowsncolumns/spreadsheet 10.6.5 → 10.7.0

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

@@ -1,12 +1,38 @@
 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" },
+/**
+ * Excel's Paste group, in its two columns (support.microsoft.com, "Paste
+ * special"): what the left column pastes, then the composites on the right.
+ */
+const PASTE_MODE_COLUMNS = [
+    [
+        { value: "all", label: "All" },
+        { value: "formulas", label: "Formulas" },
+        { value: "values", label: "Values" },
+        { value: "formats", label: "Formats" },
+        { value: "commentsAndNotes", label: "Comments and Notes" },
+        { value: "validation", label: "Validation" },
+    ],
+    [
+        { value: "allUsingSourceTheme", label: "All using Source theme" },
+        { value: "allExceptBorders", label: "All except borders" },
+        { value: "columnWidths", label: "Column widths" },
+        { value: "formulasAndNumberFormats", label: "Formulas and number formats" },
+        { value: "valuesAndNumberFormats", label: "Values and number formats" },
+        {
+            value: "allMergingConditionalFormats",
+            label: "All merging conditional formats",
+        },
+    ],
 ];
+/** The modes that never change destination values: Excel greys Operation out under them. */
+const NO_OPERATION_MODES = new Set([
+    "formats",
+    "commentsAndNotes",
+    "validation",
+    "columnWidths",
+]);
 const OPERATIONS = [
     { value: "none", label: "None" },
     { value: "add", label: "Add" },
@@ -14,24 +40,26 @@ const OPERATIONS = [
     { 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 },
+const RadioOption = ({ name, option, checked, disabled, onChange, }) => (React.createElement("label", { className: "flex items-center gap-2 text-xs py-0.5 cursor-pointer" },
+    React.createElement("input", { type: "radio", name: name, value: option.value, checked: checked, disabled: disabled, onChange: () => onChange(option.value) }),
+    option.label));
+const RadioGroup = ({ name, legend, value, columns, 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)))));
+    React.createElement("div", { className: "grid grid-flow-col auto-cols-fr gap-x-4" }, columns.map((column, index) => (React.createElement("div", { key: index, className: "flex flex-col gap-1 min-w-0" }, column.map((option) => (React.createElement(RadioOption, { key: option.value, name: name, option: option, checked: value === option.value, disabled: disabled, onChange: onChange })))))))));
 /**
- * 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.
+ * Excel's Paste Special dialog: what to paste (Excel's twelve Paste choices),
+ * an arithmetic operation against the destination, skip blanks, transpose and
+ * Paste Link. 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";
+    // Excel greys Operation out under Formats, Comments and Notes, Validation
+    // and Column widths (none of them changes destination values); the choice
+    // is kept but not applied.
+    const operationDisabled = NO_OPERATION_MODES.has(paste);
     const commit = useCallback(() => {
         onApply({
             paste,
@@ -49,15 +77,20 @@ export const PasteSpecialDialog = memo(({ open, onOpenChange, onApply }) => {
         skipBlanks,
         transpose,
     ]);
+    // Excel's Paste Link button: reference formulas to the copied cells, in
+    // their orientation when Transpose is ticked.
+    const commitLink = useCallback(() => {
+        onApply({ link: true, transpose });
+        onOpenChange(false);
+    }, [onApply, onOpenChange, 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(DialogContent, { className: "w-[460px] 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(RadioGroup, { name: "paste-special-paste", legend: "Paste", value: paste, columns: PASTE_MODE_COLUMNS, onChange: setPaste }),
+                React.createElement(RadioGroup, { name: "paste-special-operation", legend: "Operation", value: operation, columns: [OPERATIONS.slice(0, 3), OPERATIONS.slice(3)], onChange: setOperation, disabled: operationDisabled }),
+                React.createElement("div", { className: "grid grid-cols-2 gap-x-4" },
                     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"),
@@ -65,9 +98,11 @@ export const PasteSpecialDialog = memo(({ open, onOpenChange, onApply }) => {
                         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"))))));
+                React.createElement("div", { className: "flex justify-between gap-2" },
+                    React.createElement(Button, { variant: "outline", size: "sm", onClick: commitLink }, "Paste Link"),
+                    React.createElement("div", { className: "flex gap-2" },
+                        React.createElement(Button, { size: "sm", onClick: commit }, "OK"),
+                        React.createElement(Button, { variant: "outline", size: "sm", onClick: () => onOpenChange(false) }, "Cancel")))))));
 });
 PasteSpecialDialog.displayName = "PasteSpecialDialog";
 /**

package/dist/esm/components/protect-sheet-dialog/allow-edit-ranges-dialog.d.ts

@@ -0,0 +1,57 @@
+import type { GridRange } from "@rowsncolumns/grid";
+import React from "react";
+import type { AllowEditRange } from "../../types";
+/**
+ * Review ▸ Allow Edit Ranges (support.microsoft.com "Lock or unlock specific
+ * areas of a protected worksheet"): the sheet's titled ranges that stay
+ * editable once it is protected, with New / Modify / Delete and the
+ * New Range form (Title, Refers to cells, Range password).
+ */
+/** The Range form's submission. `password` absent = unchanged (Modify). */
+export type AllowEditRangeFormValue = {
+    title: string;
+    ranges: GridRange[];
+    password?: string;
+};
+/** Excel's text when "Refers to cells" is not a reference. */
+export declare const INVALID_REFERENCE_MESSAGE = "The reference you typed is not valid.";
+/** Excel's text for an empty or duplicate title. */
+export declare const EMPTY_TITLE_MESSAGE = "Enter a title for the range.";
+export declare const DUPLICATE_TITLE_MESSAGE = "The title you entered already exists. Enter a unique title.";
+/** `$A$1:$B$2` per rectangle, joined with commas, as Excel shows "Refers to cells". */
+export declare const rangesToReference: (ranges: GridRange[]) => string;
+/**
+ * Parse "Refers to cells": `=$A$1:$B$2,D4` (sheet prefixes and `$` ignored).
+ * `null` when any part is not a cell or range reference.
+ */
+export declare const referenceToRanges: (text: string) => GridRange[] | null;
+export type AllowEditRangesDialogProps = {
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /** The active sheet's ranges (rnc engine `allowEditRanges` filtered to it). */
+    ranges: AllowEditRange[];
+    /** Excel disables the list while the sheet is protected. */
+    sheetProtected: boolean;
+    /** The current selection, offered as a New range's cells. */
+    defaultRanges?: GridRange[];
+    /** rnc engine `onAddAllowEditRange(sheetId, value)`. */
+    onAdd(value: AllowEditRangeFormValue): void;
+    /** rnc engine `onUpdateAllowEditRange(sheetId, title, value)`. */
+    onUpdate(title: string, value: AllowEditRangeFormValue): void;
+    /** rnc engine `onDeleteAllowEditRange(sheetId, title)`. */
+    onDelete(title: string): void;
+    /** The dialog's "Protect Sheet…" button: opens the host's Protect Sheet dialog. */
+    onProtectSheet?(): void;
+};
+export declare const AllowEditRangesDialog: React.MemoExoticComponent<({ open, onOpenChange, ranges, sheetProtected, defaultRanges, onAdd, onUpdate, onDelete, onProtectSheet, }: AllowEditRangesDialogProps) => React.JSX.Element>;
+export type UnlockRangeDialogProps = {
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /** The range the user tried to edit. */
+    range?: AllowEditRange | null;
+    /** rnc engine `onUnlockAllowEditRange(sheetId, range.title, password)`. */
+    onConfirm(password: string): void;
+};
+/** Excel's Unlock Range prompt for a password-protected Allow Edit Range. */
+export declare const UnlockRangeDialog: React.MemoExoticComponent<({ open, onOpenChange, range, onConfirm }: UnlockRangeDialogProps) => React.JSX.Element>;
+//# sourceMappingURL=allow-edit-ranges-dialog.d.ts.map

package/dist/esm/components/protect-sheet-dialog/allow-edit-ranges-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allow-edit-ranges-dialog.d.ts","sourceRoot":"","sources":["../../../../components/protect-sheet-dialog/allow-edit-ranges-dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAYpD,OAAO,KAAyB,MAAM,OAAO,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD;;;;;GAKG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,0CAA0C,CAAC;AACjF,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAClE,eAAO,MAAM,uBAAuB,gEAC2B,CAAC;AAEhE,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,SAAS,EAAE,KAAG,MAexC,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,SAAS,EAAE,GAAG,IAiB9D,CAAC;AA2HF,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,+EAA+E;IAC/E,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,4DAA4D;IAC5D,cAAc,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B,wDAAwD;IACxD,KAAK,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC5C,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC9D,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mFAAmF;IACnF,cAAc,CAAC,IAAI,IAAI,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,qBAAqB,wIAW7B,0BAA0B,uBAsI9B,CAAC;AAIF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,wCAAwC;IACxC,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,2EAA2E;IAC3E,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,uEACe,sBAAsB,uBAoDlE,CAAC"}

package/dist/esm/components/protect-sheet-dialog/allow-edit-ranges-dialog.js

@@ -0,0 +1,177 @@
+import { Button, Dialog, DialogBody, DialogCloseButton, DialogContent, DialogTitle, Input, Separator, } from "@rowsncolumns/ui";
+import { addressToSelection, cellToAddress } from "@rowsncolumns/utils";
+import React, { memo, useState } from "react";
+import { CONFIRM_PASSWORD_MISMATCH } from "./constants";
+/** Excel's text when "Refers to cells" is not a reference. */
+export const INVALID_REFERENCE_MESSAGE = "The reference you typed is not valid.";
+/** Excel's text for an empty or duplicate title. */
+export const EMPTY_TITLE_MESSAGE = "Enter a title for the range.";
+export const DUPLICATE_TITLE_MESSAGE = "The title you entered already exists. Enter a unique title.";
+/** `$A$1:$B$2` per rectangle, joined with commas, as Excel shows "Refers to cells". */
+export const rangesToReference = (ranges) => `=${ranges
+    .map((r) => {
+    const from = cellToAddress({ rowIndex: r.startRowIndex, columnIndex: r.startColumnIndex }, true, true);
+    const to = cellToAddress({ rowIndex: r.endRowIndex, columnIndex: r.endColumnIndex }, true, true);
+    return from === to ? `${from}` : `${from}:${to}`;
+})
+    .join(",")}`;
+/**
+ * Parse "Refers to cells": `=$A$1:$B$2,D4` (sheet prefixes and `$` ignored).
+ * `null` when any part is not a cell or range reference.
+ */
+export const referenceToRanges = (text) => {
+    const parts = text
+        .trim()
+        .replace(/^=/, "")
+        .split(/[,;]/)
+        .map((p) => p.trim())
+        .filter(Boolean);
+    if (parts.length === 0)
+        return null;
+    const out = [];
+    for (const part of parts) {
+        const bare = part.replace(/^.*!/, "").replace(/\$/g, "").toUpperCase();
+        if (!/^[A-Z]+\d+(:[A-Z]+\d+)?$/.test(bare))
+            return null;
+        const selection = addressToSelection(bare);
+        if (!selection)
+            return null;
+        out.push(selection.range);
+    }
+    return out;
+};
+const RangeForm = ({ heading, initial, defaultRanges, takenTitles, onCancel, onSubmit, }) => {
+    const [title, setTitle] = useState(initial?.title ?? `Range${takenTitles.length + 1}`);
+    const [reference, setReference] = useState(() => {
+        const ranges = initial?.ranges ?? defaultRanges;
+        return ranges?.length ? rangesToReference(ranges) : "";
+    });
+    const [password, setPassword] = useState("");
+    const [confirm, setConfirm] = useState("");
+    const [error, setError] = useState(null);
+    return (React.createElement("form", { "aria-label": heading, className: "flex flex-col gap-3", onSubmit: (e) => {
+            e.preventDefault();
+            const trimmed = title.trim();
+            if (!trimmed)
+                return setError(EMPTY_TITLE_MESSAGE);
+            if (takenTitles.includes(trimmed.toLowerCase())) {
+                return setError(DUPLICATE_TITLE_MESSAGE);
+            }
+            const ranges = referenceToRanges(reference);
+            if (!ranges)
+                return setError(INVALID_REFERENCE_MESSAGE);
+            if (password !== "" && password !== confirm) {
+                return setError(CONFIRM_PASSWORD_MISMATCH);
+            }
+            onSubmit({
+                title: trimmed,
+                ranges,
+                // New: empty = no password. Modify: empty = keep the current one.
+                ...(password !== "" || !initial ? { password } : {}),
+            });
+        } },
+        React.createElement("p", { className: "text-xs font-semibold" }, heading),
+        React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+            "Title:",
+            React.createElement(Input, { value: title, onChange: (e) => {
+                    setTitle(e.target.value);
+                    setError(null);
+                }, "data-testid": "allow-edit-range-title" })),
+        React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+            "Refers to cells:",
+            React.createElement(Input, { value: reference, onChange: (e) => {
+                    setReference(e.target.value);
+                    setError(null);
+                }, "data-testid": "allow-edit-range-reference" })),
+        React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+            "Range password:",
+            React.createElement(Input, { type: "password", autoComplete: "new-password", value: password, placeholder: initial?.hasPassword ? "(unchanged)" : undefined, onChange: (e) => {
+                    setPassword(e.target.value);
+                    setError(null);
+                }, "data-testid": "allow-edit-range-password" })),
+        password !== "" && (React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+            "Reenter password to proceed:",
+            React.createElement(Input, { type: "password", autoComplete: "new-password", value: confirm, onChange: (e) => {
+                    setConfirm(e.target.value);
+                    setError(null);
+                }, "data-testid": "allow-edit-range-password-confirm" }))),
+        error && (React.createElement("p", { role: "alert", className: "text-xs text-red-600" }, error)),
+        React.createElement("div", { className: "flex justify-end gap-2" },
+            React.createElement(Button, { type: "button", variant: "outline", size: "sm", onClick: onCancel }, "Cancel"),
+            React.createElement(Button, { type: "submit", size: "sm" }, "OK"))));
+};
+export const AllowEditRangesDialog = memo(({ open, onOpenChange, ranges, sheetProtected, defaultRanges, onAdd, onUpdate, onDelete, onProtectSheet, }) => {
+    const [selected, setSelected] = useState(null);
+    const [mode, setMode] = useState("list");
+    const current = ranges.find((r) => r.title === selected);
+    const titles = ranges.map((r) => r.title.toLowerCase());
+    const close = () => {
+        setMode("list");
+        onOpenChange(false);
+    };
+    return (React.createElement(Dialog, { open: open, onOpenChange: (o) => (o ? onOpenChange(o) : close()), modal: true },
+        React.createElement(DialogContent, { className: "w-[420px] max-w-[92vw] pointer-events-auto" },
+            React.createElement(DialogTitle, null, "Allow Users to Edit Ranges"),
+            React.createElement(DialogCloseButton, null),
+            React.createElement(DialogBody, null, mode === "list" ? (React.createElement("div", { className: "flex flex-col gap-3" },
+                React.createElement("p", { className: "text-xs", id: "allow-edit-ranges-caption" }, "Ranges unlocked by a password when sheet is protected:"),
+                sheetProtected && (React.createElement("p", { role: "status", className: "text-xs text-amber-700" }, "Unprotect the sheet to change its ranges.")),
+                React.createElement("div", { role: "listbox", "aria-labelledby": "allow-edit-ranges-caption", className: "flex max-h-48 min-h-24 flex-col overflow-y-auto rounded border text-xs" }, ranges.map((r) => (React.createElement("div", { key: r.title, role: "option", "aria-selected": r.title === selected, tabIndex: 0, "data-testid": `allow-edit-range-row-${r.title}`, className: `flex cursor-default justify-between gap-2 px-2 py-1 ${r.title === selected ? "bg-blue-100" : ""}`, onClick: () => setSelected(r.title), onKeyDown: (e) => {
+                        if (e.key === "Enter" || e.key === " ")
+                            setSelected(r.title);
+                    } },
+                    React.createElement("span", { className: "font-medium" }, r.title),
+                    React.createElement("span", null, rangesToReference(r.ranges)),
+                    r.hasPassword && React.createElement("span", { className: "text-gray-500" }, "(password)"))))),
+                React.createElement("div", { className: "flex gap-2" },
+                    React.createElement(Button, { type: "button", size: "sm", variant: "outline", disabled: sheetProtected, onClick: () => setMode("new") }, "New\u2026"),
+                    React.createElement(Button, { type: "button", size: "sm", variant: "outline", disabled: sheetProtected || !current, onClick: () => setMode("modify") }, "Modify\u2026"),
+                    React.createElement(Button, { type: "button", size: "sm", variant: "outline", disabled: sheetProtected || !current, onClick: () => {
+                            if (!current)
+                                return;
+                            onDelete(current.title);
+                            setSelected(null);
+                        } }, "Delete")),
+                React.createElement(Separator, null),
+                React.createElement("div", { className: "flex justify-end gap-2" },
+                    onProtectSheet && !sheetProtected && (React.createElement(Button, { type: "button", size: "sm", variant: "outline", onClick: () => {
+                            close();
+                            onProtectSheet();
+                        } }, "Protect Sheet\u2026")),
+                    React.createElement(Button, { type: "button", size: "sm", onClick: close }, "OK")))) : mode === "new" ? (React.createElement(RangeForm, { heading: "New Range", defaultRanges: defaultRanges, takenTitles: titles, onCancel: () => setMode("list"), onSubmit: (value) => {
+                    onAdd(value);
+                    setSelected(value.title);
+                    setMode("list");
+                } })) : current ? (React.createElement(RangeForm, { heading: "Modify Range", initial: current, takenTitles: titles.filter((t) => t !== current.title.toLowerCase()), onCancel: () => setMode("list"), onSubmit: (value) => {
+                    onUpdate(current.title, value);
+                    setSelected(value.title);
+                    setMode("list");
+                } })) : null))));
+});
+AllowEditRangesDialog.displayName = "AllowEditRangesDialog";
+/** Excel's Unlock Range prompt for a password-protected Allow Edit Range. */
+export const UnlockRangeDialog = memo(({ open, onOpenChange, range, onConfirm }) => {
+    const [password, setPassword] = useState("");
+    return (React.createElement(Dialog, { open: open, onOpenChange: onOpenChange, modal: true },
+        React.createElement(DialogContent, { className: "w-[340px] max-w-[92vw] pointer-events-auto" },
+            React.createElement(DialogTitle, null, "Unlock Range"),
+            React.createElement(DialogCloseButton, null),
+            React.createElement(DialogBody, null,
+                React.createElement("form", { className: "flex flex-col gap-3", onSubmit: (e) => {
+                        e.preventDefault();
+                        onConfirm(password);
+                        setPassword("");
+                        onOpenChange(false);
+                    } },
+                    React.createElement("p", { className: "text-xs" },
+                        "A cell you are trying to change is password protected.",
+                        range?.title ? ` (${range.title})` : ""),
+                    React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                        "Enter password to change this cell:",
+                        React.createElement(Input, { type: "password", autoComplete: "current-password", autoFocus: true, value: password, onChange: (e) => setPassword(e.target.value), "data-testid": "unlock-range-password" })),
+                    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")))))));
+});
+UnlockRangeDialog.displayName = "UnlockRangeDialog";

package/dist/esm/components/protect-sheet-dialog/constants.d.ts

@@ -0,0 +1,3 @@
+/** Excel's text when the re-entered password differs. */
+export declare const CONFIRM_PASSWORD_MISMATCH = "Confirmation password is not identical.";
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/components/protect-sheet-dialog/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../components/protect-sheet-dialog/constants.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,eAAO,MAAM,yBAAyB,4CAA4C,CAAC"}

package/dist/esm/components/protect-sheet-dialog/constants.js

@@ -0,0 +1,2 @@
+/** Excel's text when the re-entered password differs. */
+export const CONFIRM_PASSWORD_MISMATCH = "Confirmation password is not identical.";

package/dist/esm/components/protect-sheet-dialog/index.d.ts

@@ -21,8 +21,8 @@ export declare const sheetProtectionToAllowState: (protection?: SheetProtection
  * schema default.
  */
 export declare const allowStateToSheetProtection: (state: SheetProtectionAllowState) => Omit<SheetProtection, "password" | "algorithmName" | "hashValue" | "saltValue" | "spinCount">;
-/** Excel's text when the re-entered password differs. */
-export declare const CONFIRM_PASSWORD_MISMATCH = "Confirmation password is not identical.";
+export { CONFIRM_PASSWORD_MISMATCH } from "./constants";
+export * from "./allow-edit-ranges-dialog";
 export type ProtectSheetDialogProps = {
     open: boolean;
     onOpenChange(open: boolean): void;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/protect-sheet-dialog/index.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAyB,MAAM,OAAO,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,iFAAiF;AACjF,MAAM,MAAM,wBAAwB,GAChC,mBAAmB,GACnB,qBAAqB,GACrB,aAAa,GACb,eAAe,GACf,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,kBAAkB,GAClB,eAAe,GACf,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,aAAa,GACb,SAAS,GACT,WAAW,CAAC;AAEhB;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,aAAa,CAAC;IACzD,IAAI,EAAE,wBAAwB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;CACzB,CAgBA,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;AAElF,iFAAiF;AACjF,eAAO,MAAM,2BAA2B,GACtC,aAAa,eAAe,GAAG,IAAI,KAClC,yBAOF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GACtC,OAAO,yBAAyB,KAC/B,IAAI,CACL,eAAe,EACf,UAAU,GAAG,eAAe,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAOvE,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,yBAAyB,4CAA4C,CAAC;AA4DnF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,gEAAgE;IAChE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE;QACjB,eAAe,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;QAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI,CAAC;CACV,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,yEACgB,uBAAuB,uBAoErE,CAAC;AAIF,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,uEAAuE;IACvE,SAAS,CAAC,OAAO,EAAE;QAAE,aAAa,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACzE,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,gEACI,0BAA0B,uBAwD/D,CAAC;AAIF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,eAAe,uEACiB,oBAAoB,uBAmChE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/protect-sheet-dialog/index.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAyB,MAAM,OAAO,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,iFAAiF;AACjF,MAAM,MAAM,wBAAwB,GAChC,mBAAmB,GACnB,qBAAqB,GACrB,aAAa,GACb,eAAe,GACf,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,kBAAkB,GAClB,eAAe,GACf,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,aAAa,GACb,SAAS,GACT,WAAW,CAAC;AAEhB;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,aAAa,CAAC;IACzD,IAAI,EAAE,wBAAwB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;CACzB,CAgBA,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;AAElF,iFAAiF;AACjF,eAAO,MAAM,2BAA2B,GACtC,aAAa,eAAe,GAAG,IAAI,KAClC,yBAOF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GACtC,OAAO,yBAAyB,KAC/B,IAAI,CACL,eAAe,EACf,UAAU,GAAG,eAAe,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAOvE,CAAC;AAEF,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,cAAc,4BAA4B,CAAC;AA4D3C,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,gEAAgE;IAChE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE;QACjB,eAAe,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;QAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI,CAAC;CACV,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,yEACgB,uBAAuB,uBAoErE,CAAC;AAIF,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,uEAAuE;IACvE,SAAS,CAAC,OAAO,EAAE;QAAE,aAAa,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACzE,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,gEACI,0BAA0B,uBAwD/D,CAAC;AAIF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,eAAe,uEACiB,oBAAoB,uBAmChE,CAAC"}

package/dist/esm/components/protect-sheet-dialog/index.js

@@ -1,5 +1,6 @@
 import { Button, Dialog, DialogBody, DialogCloseButton, DialogContent, DialogTitle, Input, Separator, } from "@rowsncolumns/ui";
 import React, { memo, useState } from "react";
+import { CONFIRM_PASSWORD_MISMATCH } from "./constants";
 /**
  * Excel's "Allow all users of this worksheet to:" list, in the dialog's order
  * (support.microsoft.com "Protect a worksheet"), with the dialog defaults:
@@ -43,8 +44,8 @@ export const allowStateToSheetProtection = (state) => {
     }
     return protection;
 };
-/** Excel's text when the re-entered password differs. */
-export const CONFIRM_PASSWORD_MISMATCH = "Confirmation password is not identical.";
+export { CONFIRM_PASSWORD_MISMATCH } from "./constants";
+export * from "./allow-edit-ranges-dialog";
 /** Password + "Reenter password to proceed", as Excel's Confirm Password step. */
 const PasswordFields = ({ label, password, confirm, mismatch, onPassword, onConfirm, }) => (React.createElement(React.Fragment, null,
     React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },

package/dist/esm/components/scenario-manager-dialog/index.d.ts

@@ -0,0 +1,51 @@
+import React from "react";
+/** A Scenario Manager scenario — the `ScenarioDefinition` of `spreadsheet-state`. */
+export type ScenarioManagerScenario = {
+    name: string;
+    cells: {
+        rowIndex: number;
+        columnIndex: number;
+        value: string;
+    }[];
+    comment?: string;
+    locked?: boolean;
+    hidden?: boolean;
+};
+/** Excel's cap on changing cells per scenario. */
+export declare const MAX_SCENARIO_CHANGING_CELLS = 32;
+type Refusal = string | undefined;
+export type ScenarioManagerDialogProps = {
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /** The active sheet's scenarios. */
+    scenarios: ScenarioManagerScenario[];
+    /** The selection as A1 text (`B1:B2`) — Add's default changing cells. */
+    defaultChangingCells: string;
+    /** A cell's current value as typed — Add's default scenario values. */
+    getCellValue(rowIndex: number, columnIndex: number): string;
+    /** Each resolves to Excel's refusal message, or `undefined` once done. */
+    onAdd(scenario: ScenarioManagerScenario): Promise<Refusal> | Refusal;
+    onUpdate(name: string, scenario: ScenarioManagerScenario): Promise<Refusal> | Refusal;
+    onDelete(name: string): Promise<Refusal> | Refusal;
+    onShow(name: string): Promise<Refusal> | Refusal;
+    onSummary(resultCells: {
+        rowIndex: number;
+        columnIndex: number;
+    }[]): Promise<Refusal> | Refusal;
+};
+/**
+ * `B1:B3, D5` → its cells in order (deduplicated), or `null` when a part is not a
+ * cell or range reference.
+ */
+export declare const parseCellList: (text: string) => {
+    rowIndex: number;
+    columnIndex: number;
+}[] | null;
+/**
+ * Excel's Scenario Manager: the sheet's scenarios with Show / Add / Delete /
+ * Edit / Summary. Add and Edit ask for the name, changing cells and comment,
+ * then a value for each changing cell (Scenario Values). Merge is not offered.
+ */
+export declare const ScenarioManagerDialog: React.MemoExoticComponent<({ open, onOpenChange, scenarios, defaultChangingCells, getCellValue, onAdd, onUpdate, onDelete, onShow, onSummary, }: ScenarioManagerDialogProps) => React.JSX.Element>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/scenario-manager-dialog/index.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAEtE,qFAAqF;AACrF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,KAAK,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAElC,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,oCAAoC;IACpC,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,yEAAyE;IACzE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uEAAuE;IACvE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5D,0EAA0E;IAC1E,KAAK,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACjD,SAAS,CAAC,WAAW,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjG,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,KACX;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,IA2BhD,CAAC;AAWF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,mJAY7B,0BAA0B,uBAqS9B,CAAC"}