@rowsncolumns/spreadsheet 10.2.72 → 10.2.74

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

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PasteSpecialDialogHost = exports.PasteSpecialDialog = void 0;
+var tslib_1 = require("tslib");
+var ui_1 = require("@rowsncolumns/ui");
+var react_1 = tslib_1.__importStar(require("react"));
+var paste_special_dialog_atom_1 = require("../../atoms/paste-special-dialog.atom");
+var PASTE_MODES = [
+    { value: "all", label: "All" },
+    { value: "formulas", label: "Formulas" },
+    { value: "values", label: "Values" },
+    { value: "formats", label: "Formats" },
+];
+var OPERATIONS = [
+    { value: "none", label: "None" },
+    { value: "add", label: "Add" },
+    { value: "subtract", label: "Subtract" },
+    { value: "multiply", label: "Multiply" },
+    { value: "divide", label: "Divide" },
+];
+var RadioGroup = function (_a) {
+    var name = _a.name, legend = _a.legend, value = _a.value, options = _a.options, onChange = _a.onChange, disabled = _a.disabled;
+    return (react_1.default.createElement("fieldset", { className: "flex flex-col gap-1 min-w-0 disabled:opacity-50", disabled: disabled },
+        react_1.default.createElement("legend", { className: "text-xs font-medium mb-1" }, legend),
+        options.map(function (option) { return (react_1.default.createElement("label", { key: option.value, className: "flex items-center gap-2 text-xs py-0.5 cursor-pointer" },
+            react_1.default.createElement("input", { type: "radio", name: name, value: option.value, checked: value === option.value, disabled: disabled, onChange: function () { return 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.
+ */
+exports.PasteSpecialDialog = (0, react_1.memo)(function (_a) {
+    var open = _a.open, onOpenChange = _a.onOpenChange, onApply = _a.onApply;
+    var _b = tslib_1.__read((0, react_1.useState)("all"), 2), paste = _b[0], setPaste = _b[1];
+    var _c = tslib_1.__read((0, react_1.useState)("none"), 2), operation = _c[0], setOperation = _c[1];
+    var _d = tslib_1.__read((0, react_1.useState)(false), 2), skipBlanks = _d[0], setSkipBlanks = _d[1];
+    var _e = tslib_1.__read((0, react_1.useState)(false), 2), transpose = _e[0], setTranspose = _e[1];
+    // Excel greys Operation out under Paste → Formats (a formats paste never
+    // changes destination values); the choice is kept but not applied.
+    var operationDisabled = paste === "formats";
+    var commit = (0, react_1.useCallback)(function () {
+        onApply({
+            paste: paste,
+            operation: operation === "none" || operationDisabled ? undefined : operation,
+            skipBlanks: skipBlanks,
+            transpose: transpose,
+        });
+        onOpenChange(false);
+    }, [
+        onApply,
+        onOpenChange,
+        paste,
+        operation,
+        operationDisabled,
+        skipBlanks,
+        transpose,
+    ]);
+    return (react_1.default.createElement(ui_1.Dialog, { open: open, onOpenChange: onOpenChange, modal: true },
+        react_1.default.createElement(ui_1.DialogContent, { className: "w-[380px] max-w-[92vw] pointer-events-auto" },
+            react_1.default.createElement(ui_1.DialogTitle, null, "Paste Special"),
+            react_1.default.createElement(ui_1.DialogCloseButton, null),
+            react_1.default.createElement(ui_1.DialogBody, { className: "flex flex-col gap-4" },
+                react_1.default.createElement("div", { className: "grid grid-cols-2 gap-4" },
+                    react_1.default.createElement(RadioGroup, { name: "paste-special-paste", legend: "Paste", value: paste, options: PASTE_MODES, onChange: setPaste }),
+                    react_1.default.createElement(RadioGroup, { name: "paste-special-operation", legend: "Operation", value: operation, options: OPERATIONS, onChange: setOperation, disabled: operationDisabled })),
+                react_1.default.createElement("div", { className: "flex flex-col gap-1" },
+                    react_1.default.createElement("label", { className: "flex items-center gap-2 text-xs py-0.5 cursor-pointer" },
+                        react_1.default.createElement("input", { type: "checkbox", checked: skipBlanks, onChange: function (e) { return setSkipBlanks(e.target.checked); } }),
+                        "Skip blanks"),
+                    react_1.default.createElement("label", { className: "flex items-center gap-2 text-xs py-0.5 cursor-pointer" },
+                        react_1.default.createElement("input", { type: "checkbox", checked: transpose, onChange: function (e) { return setTranspose(e.target.checked); } }),
+                        "Transpose")),
+                react_1.default.createElement(ui_1.Separator, null),
+                react_1.default.createElement("div", { className: "flex justify-end gap-2" },
+                    react_1.default.createElement(ui_1.Button, { variant: "outline", size: "sm", onClick: function () { return onOpenChange(false); } }, "Cancel"),
+                    react_1.default.createElement(ui_1.Button, { size: "sm", onClick: commit }, "OK"))))));
+});
+exports.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.
+ */
+var PasteSpecialDialogHost = function () {
+    (0, paste_special_dialog_atom_1.useRegisterPasteSpecialDialogHost)();
+    var _a = tslib_1.__read((0, paste_special_dialog_atom_1.usePasteSpecialDialogState)(), 2), request = _a[0], setRequest = _a[1];
+    var close = (0, react_1.useCallback)(function () { return setRequest(null); }, [setRequest]);
+    if (!request)
+        return null;
+    return (react_1.default.createElement(exports.PasteSpecialDialog, { open: true, onOpenChange: function (open) {
+            if (!open)
+                close();
+        }, onApply: request.onApply }));
+};
+exports.PasteSpecialDialogHost = PasteSpecialDialogHost;
+exports.PasteSpecialDialogHost.displayName = "PasteSpecialDialogHost";

package/dist/cjs/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/cjs/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/cjs/components/remove-duplicates-dialog/index.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoveDuplicatesDialogHost = exports.RemoveDuplicatesDialog = void 0;
+var tslib_1 = require("tslib");
+var icons_1 = require("@rowsncolumns/icons");
+var ui_1 = require("@rowsncolumns/ui");
+var react_1 = tslib_1.__importStar(require("react"));
+var remove_duplicates_dialog_atom_1 = require("../../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.
+ */
+exports.RemoveDuplicatesDialog = (0, react_1.memo)(function (_a) {
+    var open = _a.open, onOpenChange = _a.onOpenChange, columns = _a.columns, _b = _a.initialHasHeader, initialHasHeader = _b === void 0 ? false : _b, onApply = _a.onApply;
+    var allColumnIndexes = (0, react_1.useMemo)(function () { return columns.map(function (column) { return column.columnIndex; }); }, [columns]);
+    var _c = tslib_1.__read((0, react_1.useState)(initialHasHeader), 2), hasHeader = _c[0], setHasHeader = _c[1];
+    var _d = tslib_1.__read((0, react_1.useState)(function () { return new Set(allColumnIndexes); }), 2), checked = _d[0], setChecked = _d[1];
+    // Re-seed when reopened for a different range.
+    (0, react_1.useEffect)(function () {
+        if (open) {
+            setHasHeader(initialHasHeader);
+            setChecked(new Set(allColumnIndexes));
+        }
+        // Only reset on open transitions.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [open]);
+    var toggleColumn = (0, react_1.useCallback)(function (columnIndex) {
+        setChecked(function (prev) {
+            var next = new Set(prev);
+            if (next.has(columnIndex)) {
+                next.delete(columnIndex);
+            }
+            else {
+                next.add(columnIndex);
+            }
+            return next;
+        });
+    }, []);
+    var commit = (0, react_1.useCallback)(function () {
+        var columnIndices = allColumnIndexes.filter(function (columnIndex) {
+            return checked.has(columnIndex);
+        });
+        onApply({ columnIndices: columnIndices, hasHeader: hasHeader });
+        onOpenChange(false);
+    }, [allColumnIndexes, checked, hasHeader, onApply, onOpenChange]);
+    return (react_1.default.createElement(ui_1.Dialog, { open: open, onOpenChange: onOpenChange },
+        react_1.default.createElement(ui_1.DialogContent, { className: "w-[420px] max-w-[92vw] pointer-events-auto" },
+            react_1.default.createElement(ui_1.DialogTitle, null, "Remove duplicates"),
+            react_1.default.createElement(ui_1.DialogDescription, null, "Select the columns that contain duplicate values. Rows that match in every selected column are removed, keeping the first one."),
+            react_1.default.createElement(ui_1.DialogCloseButton, { onClick: function () { return onOpenChange(false); } },
+                react_1.default.createElement(icons_1.Cross1Icon, null)),
+            react_1.default.createElement(ui_1.DialogBody, { className: "flex flex-col gap-3" },
+                react_1.default.createElement("label", { className: "font-system text-sm flex items-center gap-1" },
+                    react_1.default.createElement("input", { type: "checkbox", name: "hasHeader", checked: hasHeader, onChange: function (e) { return setHasHeader(e.target.checked); } }),
+                    "My data has headers"),
+                react_1.default.createElement("div", { className: "flex gap-2" },
+                    react_1.default.createElement(ui_1.Button, { variant: "outline", size: "xs", type: "button", onClick: function () { return setChecked(new Set(allColumnIndexes)); } }, "Select all"),
+                    react_1.default.createElement(ui_1.Button, { variant: "outline", size: "xs", type: "button", onClick: function () { return setChecked(new Set()); } }, "Unselect all")),
+                react_1.default.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(function (column) {
+                    var text = hasHeader && column.header ? column.header : column.label;
+                    return (react_1.default.createElement("label", { key: column.columnIndex, className: "font-system text-sm flex items-center gap-1" },
+                        react_1.default.createElement("input", { type: "checkbox", name: "column-".concat(column.columnIndex), checked: checked.has(column.columnIndex), onChange: function () { return toggleColumn(column.columnIndex); } }),
+                        react_1.default.createElement("span", { className: "truncate", title: text }, text)));
+                })),
+                react_1.default.createElement(ui_1.Separator, null),
+                react_1.default.createElement("div", { className: "flex justify-end gap-2" },
+                    react_1.default.createElement(ui_1.Button, { variant: "outline", size: "sm", type: "button", onClick: function () { return onOpenChange(false); } }, "Cancel"),
+                    react_1.default.createElement(ui_1.Button, { size: "sm", type: "button", onClick: commit, disabled: checked.size === 0 }, "OK"))))));
+});
+exports.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.
+ */
+var RemoveDuplicatesDialogHost = function () {
+    var _a;
+    (0, remove_duplicates_dialog_atom_1.useRegisterRemoveDuplicatesDialogHost)();
+    var _b = tslib_1.__read((0, remove_duplicates_dialog_atom_1.useRemoveDuplicatesDialogState)(), 2), request = _b[0], setRequest = _b[1];
+    var close = (0, react_1.useCallback)(function () { return setRequest(null); }, [setRequest]);
+    return (react_1.default.createElement(exports.RemoveDuplicatesDialog, { open: request != null, onOpenChange: function (open) {
+            if (!open)
+                close();
+        }, columns: (_a = request === null || request === void 0 ? void 0 : request.columns) !== null && _a !== void 0 ? _a : [], initialHasHeader: request === null || request === void 0 ? void 0 : request.hasHeader, onApply: function (options) { return request === null || request === void 0 ? void 0 : request.onApply(options); } }));
+};
+exports.RemoveDuplicatesDialogHost = RemoveDuplicatesDialogHost;
+exports.RemoveDuplicatesDialogHost.displayName = "RemoveDuplicatesDialogHost";

package/dist/cjs/components/toolbar/index.d.ts

@@ -10,6 +10,7 @@ export * from "./font-family-selector";
 export * from "./text-horizontal-align-selector";
 export * from "./text-vertical-align-selector";
 export * from "./text-wrap-selector";
+export * from "./text-rotation-selector";
 export * from "./text-format-selector";
 export * from "./theme-selector";
 export * from "./table-actions";

package/dist/cjs/components/toolbar/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/toolbar/index.tsx"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/toolbar/index.tsx"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/cjs/components/toolbar/index.js

@@ -13,6 +13,7 @@ tslib_1.__exportStar(require("./font-family-selector"), exports);
 tslib_1.__exportStar(require("./text-horizontal-align-selector"), exports);
 tslib_1.__exportStar(require("./text-vertical-align-selector"), exports);
 tslib_1.__exportStar(require("./text-wrap-selector"), exports);
+tslib_1.__exportStar(require("./text-rotation-selector"), exports);
 tslib_1.__exportStar(require("./text-format-selector"), exports);
 tslib_1.__exportStar(require("./theme-selector"), exports);
 tslib_1.__exportStar(require("./table-actions"), exports);

package/dist/cjs/components/toolbar/text-rotation-selector.d.ts

@@ -0,0 +1,29 @@
+import React from "react";
+import type { CellFormat } from "../../types";
+export type TextRotationValue = NonNullable<CellFormat["textRotation"]>;
+type TextRotationPreset = {
+    label: string;
+    value: TextRotationValue;
+};
+/**
+ * Excel's Orientation menu. Degrees are counter-clockwise positive (Excel's
+ * convention, what the renderer and the xlsx round-trip use), so "clockwise"
+ * presets are negative. `0` is horizontal — used instead of clearing the
+ * property so both engines apply it as a plain format write.
+ */
+export declare const TEXT_ROTATION_PRESETS: TextRotationPreset[];
+export declare const MIN_TEXT_ROTATION = -90;
+export declare const MAX_TEXT_ROTATION = 90;
+/**
+ * Coerce free-form degree input into the supported -90…90 range. Returns
+ * `undefined` for input that is not a finite number.
+ */
+export declare const clampTextRotation: (input: string | number) => number | undefined;
+type TextRotationSelectorProps = {
+    disabled?: boolean;
+    value?: CellFormat["textRotation"];
+    onChange(value: TextRotationValue): void;
+};
+export declare const TextRotationSelector: ({ value, onChange, disabled, }: TextRotationSelectorProps) => React.JSX.Element;
+export {};
+//# sourceMappingURL=text-rotation-selector.d.ts.map

package/dist/cjs/components/toolbar/text-rotation-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-rotation-selector.d.ts","sourceRoot":"","sources":["../../../../components/toolbar/text-rotation-selector.tsx"],"names":[],"mappings":"AAaA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAGnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;AAExE,KAAK,kBAAkB,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,iBAAiB,CAAC;CAC1B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,kBAAkB,EAOrD,CAAC;AAEF,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,GAAG,MAAM,uBAMvD,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC1C,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,gCAIlC,yBAAyB,sBAoF3B,CAAC"}

package/dist/cjs/components/toolbar/text-rotation-selector.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextRotationSelector = exports.clampTextRotation = exports.MAX_TEXT_ROTATION = exports.MIN_TEXT_ROTATION = exports.TEXT_ROTATION_PRESETS = void 0;
+var tslib_1 = require("tslib");
+var icons_1 = require("@rowsncolumns/icons");
+var ui_1 = require("@rowsncolumns/ui");
+var react_1 = tslib_1.__importStar(require("react"));
+var atoms_1 = require("../../atoms");
+/**
+ * Excel's Orientation menu. Degrees are counter-clockwise positive (Excel's
+ * convention, what the renderer and the xlsx round-trip use), so "clockwise"
+ * presets are negative. `0` is horizontal — used instead of clearing the
+ * property so both engines apply it as a plain format write.
+ */
+exports.TEXT_ROTATION_PRESETS = [
+    { label: "Horizontal", value: 0 },
+    { label: "Angle counterclockwise", value: 45 },
+    { label: "Angle clockwise", value: -45 },
+    { label: "Vertical text", value: "vertical" },
+    { label: "Rotate text up", value: 90 },
+    { label: "Rotate text down", value: -90 },
+];
+exports.MIN_TEXT_ROTATION = -90;
+exports.MAX_TEXT_ROTATION = 90;
+/**
+ * Coerce free-form degree input into the supported -90…90 range. Returns
+ * `undefined` for input that is not a finite number.
+ */
+var clampTextRotation = function (input) {
+    var value = typeof input === "number" ? input : Number(input);
+    if (!Number.isFinite(value)) {
+        return undefined;
+    }
+    return Math.max(exports.MIN_TEXT_ROTATION, Math.min(exports.MAX_TEXT_ROTATION, value));
+};
+exports.clampTextRotation = clampTextRotation;
+var TextRotationSelector = function (_a) {
+    var value = _a.value, onChange = _a.onChange, disabled = _a.disabled;
+    var focusSheet = (0, atoms_1.useFocusSheet)();
+    var _b = tslib_1.__read((0, react_1.useState)(false), 2), isOpen = _b[0], onOpenChange = _b[1];
+    var current = value !== null && value !== void 0 ? value : 0;
+    var _c = tslib_1.__read((0, react_1.useState)(typeof current === "number" ? String(current) : ""), 2), degrees = _c[0], setDegrees = _c[1];
+    // Reflect the active cell's rotation in the custom-degrees field whenever
+    // the popover opens on a different value.
+    (0, react_1.useEffect)(function () {
+        if (isOpen) {
+            setDegrees(typeof current === "number" ? String(current) : "");
+        }
+    }, [isOpen, current]);
+    var close = function () { return onOpenChange(false); };
+    var apply = function (next) {
+        onChange(next);
+        focusSheet === null || focusSheet === void 0 ? void 0 : focusSheet();
+        close();
+    };
+    var applyDegrees = function () {
+        var next = (0, exports.clampTextRotation)(degrees);
+        if (next !== undefined) {
+            apply(next);
+        }
+    };
+    return (react_1.default.createElement(ui_1.Popover, { open: isOpen, onOpenChange: onOpenChange },
+        react_1.default.createElement(ui_1.PopoverTrigger, { asChild: true },
+            react_1.default.createElement(ui_1.IconButton, { size: "lg", tooltip: "Text orientation", "aria-label": "Text orientation", disabled: disabled },
+                react_1.default.createElement(icons_1.RotateCounterClockwiseIcon, null),
+                react_1.default.createElement(icons_1.MdOutlineArrowDropDown, null))),
+        react_1.default.createElement(ui_1.PopoverContent, { align: "start" },
+            react_1.default.createElement(ui_1.Stack, { direction: "vertical", className: "gap-1 min-w-[200px]" },
+                exports.TEXT_ROTATION_PRESETS.map(function (preset) { return (react_1.default.createElement(ui_1.Button, { key: preset.label, size: "xs", variant: current === preset.value ? "primary" : "ghost", className: "justify-start", "aria-pressed": current === preset.value, onClick: function () { return apply(preset.value); } }, preset.label)); }),
+                react_1.default.createElement("form", { className: "flex items-center gap-1 pt-1 m-0", onSubmit: function (e) {
+                        e.preventDefault();
+                        applyDegrees();
+                    } },
+                    react_1.default.createElement("label", { className: "font-system text-xs shrink-0", htmlFor: "rnc-text-rotation-degrees" }, "Degrees"),
+                    react_1.default.createElement(ui_1.Input, { id: "rnc-text-rotation-degrees", type: "number", min: exports.MIN_TEXT_ROTATION, max: exports.MAX_TEXT_ROTATION, step: 1, value: degrees, onChange: function (e) { return setDegrees(e.target.value); }, className: "w-[72px]" }),
+                    react_1.default.createElement(ui_1.Button, { size: "xs", type: "submit" }, "Apply"))))));
+};
+exports.TextRotationSelector = TextRotationSelector;

package/dist/cjs/components/toolbar/text-wrap-selector.d.ts

@@ -3,7 +3,13 @@ import type { WrapStrategy } from "../../types";
 type TextWrapSelectorProps = {
     value?: WrapStrategy | null;
     onChange(value: WrapStrategy): void;
+    /**
+     * Excel's "Shrink to fit": scale the font down so the text fits the cell.
+     * The toggle only renders when `onChangeShrinkToFit` is provided.
+     */
+    shrinkToFit?: boolean | null;
+    onChangeShrinkToFit?(value: boolean): void;
 };
-export declare const TextWrapSelector: ({ value, onChange, }: TextWrapSelectorProps) => React.JSX.Element;
+export declare const TextWrapSelector: ({ value, onChange, shrinkToFit, onChangeShrinkToFit, }: TextWrapSelectorProps) => React.JSX.Element;
 export {};
 //# sourceMappingURL=text-wrap-selector.d.ts.map

package/dist/cjs/components/toolbar/text-wrap-selector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-wrap-selector.d.ts","sourceRoot":"","sources":["../../../../components/toolbar/text-wrap-selector.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAGxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,KAAK,qBAAqB,GAAG;IAC3B,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,sBAG9B,qBAAqB,sBA8DvB,CAAC"}
+{"version":3,"file":"text-wrap-selector.d.ts","sourceRoot":"","sources":["../../../../components/toolbar/text-wrap-selector.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAGxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,KAAK,qBAAqB,GAAG;IAC3B,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,mBAAmB,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5C,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,wDAK9B,qBAAqB,sBAoFvB,CAAC"}

package/dist/cjs/components/toolbar/text-wrap-selector.js

@@ -8,13 +8,13 @@ var ui_1 = require("@rowsncolumns/ui");
 var react_1 = tslib_1.__importStar(require("react"));
 var atoms_1 = require("../../atoms");
 var TextWrapSelector = function (_a) {
-    var _b = _a.value, value = _b === void 0 ? "overflow" : _b, onChange = _a.onChange;
+    var _b = _a.value, value = _b === void 0 ? "overflow" : _b, onChange = _a.onChange, shrinkToFit = _a.shrinkToFit, onChangeShrinkToFit = _a.onChangeShrinkToFit;
     var focusSheet = (0, atoms_1.useFocusSheet)();
     var _c = tslib_1.__read((0, react_1.useState)(false), 2), isOpen = _c[0], onOpenChange = _c[1];
     var close = function () { return onOpenChange(false); };
     return (react_1.default.createElement(ui_1.Popover, { open: isOpen, onOpenChange: onOpenChange },
         react_1.default.createElement(ui_1.PopoverTrigger, { asChild: true },
-            react_1.default.createElement(ui_1.IconButton, { size: "lg", tooltip: "Text wrapping" },
+            react_1.default.createElement(ui_1.IconButton, { size: "lg", tooltip: "Text wrapping", "aria-label": "Text wrapping" },
                 value === "overflow" ? (react_1.default.createElement(icons_1.TextOverflowIcon, null)) : value === "wrap" ? (react_1.default.createElement(icons_1.TextOverflowWrapIcon, null)) : (react_1.default.createElement(icons_1.TextoverflowClipIcon, null)),
                 react_1.default.createElement(icons_2.MdOutlineArrowDropDown, null))),
         react_1.default.createElement(ui_1.PopoverContent, { align: "start" },
@@ -36,6 +36,13 @@ var TextWrapSelector = function (_a) {
                         focusSheet === null || focusSheet === void 0 ? void 0 : focusSheet();
                         close();
                     } },
-                    react_1.default.createElement(icons_1.TextoverflowClipIcon, null))))));
+                    react_1.default.createElement(icons_1.TextoverflowClipIcon, null)),
+                onChangeShrinkToFit ? (react_1.default.createElement(ui_1.IconButton, { size: "lg", isActive: !!shrinkToFit, "aria-pressed": !!shrinkToFit, tooltip: "Shrink text to fit the cell", "aria-label": "Shrink text to fit the cell", className: "w-full justify-start gap-1", onClick: function () {
+                        onChangeShrinkToFit(!shrinkToFit);
+                        focusSheet === null || focusSheet === void 0 ? void 0 : focusSheet();
+                        close();
+                    } },
+                    react_1.default.createElement(icons_1.TextoverflowClipIcon, null),
+                    react_1.default.createElement("span", { className: "text-xs" }, "Shrink to fit"))) : null))));
 };
 exports.TextWrapSelector = TextWrapSelector;

package/dist/cjs/hooks/use-copy-paste-cut.d.ts

@@ -31,11 +31,30 @@ export type UseCopyPasteCutProps = {
     onCut: CanvasGridProps["onCut"];
 };
 export type PasteSpecialType = "Transposed" | "Formatting" | "Value" | "Formula" | "Link";
+/** Excel Paste Special → Operation: combine each pasted cell with the cell it lands on. */
+export type PasteSpecialOperation = "add" | "subtract" | "multiply" | "divide";
+/**
+ * Excel's Paste Special dialog as one request. `paste` picks what is
+ * pasted (all / values / formulas / formats), `operation` combines the pasted
+ * value with the destination (`=dest+source`, formulas stay formulas),
+ * `skipBlanks` leaves the destination untouched where the clipboard cell is
+ * empty and `transpose` swaps rows and columns. Every flag composes with the
+ * others; the legacy single-mode {@link PasteSpecialType} strings map onto
+ * the same fields.
+ */
+export type PasteSpecialOptions = {
+    paste?: "all" | "values" | "formulas" | "formats";
+    operation?: PasteSpecialOperation;
+    skipBlanks?: boolean;
+    transpose?: boolean;
+};
+/** Argument accepted by `paste()` — a legacy single mode or the full dialog request. */
+export type PasteSpecialRequest = PasteSpecialType | PasteSpecialOptions;
 export declare const useCopyPasteCut: ({ selections, activeCell, sheetId, onPaste, onCopy, onCut, focusSheet, }: UseCopyPasteCutProps) => {
     selections: SelectionArea[];
     copy: () => void;
     cut: () => void;
-    paste: (pasteSpecialType?: PasteSpecialType) => Promise<void>;
+    paste: (pasteSpecial?: PasteSpecialRequest) => Promise<void>;
     copiedSelections: any[];
     clearCopiedSelections: () => void;
     onInternalCopy: (e: ClipboardEvent, isCutOperation?: boolean) => boolean;

package/dist/cjs/hooks/use-copy-paste-cut.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-copy-paste-cut.d.ts","sourceRoot":"","sources":["../../../hooks/use-copy-paste-cut.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWvE,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,mCAAmC,CAAC;AAK3C,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,EAAE,aAAa,CAAC;IAC1B;;OAEG;IACH,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACpC;;OAEG;IACH,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC;;OAEG;IACH,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,YAAY,GACZ,OAAO,GACP,SAAS,GACT,MAAM,CAAC;AAEX,eAAO,MAAM,eAAe,GAAI,0EAQ7B,oBAAoB;;;;+BAoRO,gBAAgB;;;wBA1KtC,cAAc;yBAuDd,cAAc;uBAtBd,cAAc;CAmMrB,CAAC"}
+{"version":3,"file":"use-copy-paste-cut.d.ts","sourceRoot":"","sources":["../../../hooks/use-copy-paste-cut.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYvE,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,mCAAmC,CAAC;AAK3C,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,EAAE,aAAa,CAAC;IAC1B;;OAEG;IACH,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACpC;;OAEG;IACH,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC;;OAEG;IACH,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,YAAY,GACZ,OAAO,GACP,SAAS,GACT,MAAM,CAAC;AAEX,2FAA2F;AAC3F,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE/E;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAClD,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wFAAwF;AACxF,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAEzE,eAAO,MAAM,eAAe,GAAI,0EAQ7B,oBAAoB;;;;2BAoRG,mBAAmB;;;wBA1KrC,cAAc;yBAuDd,cAAc;uBAtBd,cAAc;CA0MrB,CAAC"}

package/dist/cjs/hooks/use-copy-paste-cut.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.useCopyPasteCut = void 0;
 var tslib_1 = require("tslib");
 var grid_1 = require("@rowsncolumns/grid");
+var utils_1 = require("@rowsncolumns/utils");
 var react_1 = require("react");
 var copy_paste_1 = require("../api/copy-paste");
 var selections_1 = require("../api/selections");
@@ -63,7 +64,7 @@ var useCopyPasteCut = function (_a) {
             return;
         }
         var handleKeyDown = function (e) {
-            if (!e.key || e.key.toLowerCase() !== "v") {
+            if (!e.key || (0, utils_1.getHotkeyKey)(e) !== "v") {
                 return;
             }
             if (!e.metaKey && !e.ctrlKey) {
@@ -215,16 +216,16 @@ var useCopyPasteCut = function (_a) {
         focusSheet();
     }, [cellEditorInstance, focusSheet]);
     // From contextmenu
-    var paste = (0, react_1.useCallback)(function (pasteSpecialType) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+    var paste = (0, react_1.useCallback)(function (pasteSpecial) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
         function getClipboardContents() {
             return tslib_1.__awaiter(this, void 0, void 0, function () {
                 var editorEl, dataTransfer, evt, clipboardItems, clipboardItems_1, clipboardItems_1_1, clipboardItem, _a, _b, type, blob, text, e_1_1, e_2_1, err_1;
                 var e_2, _c, e_1, _d;
-                var _e, _f, _g;
-                return tslib_1.__generator(this, function (_h) {
-                    switch (_h.label) {
+                var _e, _f, _g, _h;
+                return tslib_1.__generator(this, function (_j) {
+                    switch (_j.label) {
                         case 0:
-                            _h.trys.push([0, 17, , 18]);
+                            _j.trys.push([0, 17, , 18]);
                             editorEl = (_e = cellEditorInstance === null || cellEditorInstance === void 0 ? void 0 : cellEditorInstance.el) === null || _e === void 0 ? void 0 : _e.call(cellEditorInstance);
                             // Focus editor
                             cellEditorInstance === null || cellEditorInstance === void 0 ? void 0 : cellEditorInstance.focus();
@@ -236,37 +237,37 @@ var useCopyPasteCut = function (_a) {
                             });
                             return [4 /*yield*/, navigator.clipboard.read()];
                         case 1:
-                            clipboardItems = _h.sent();
-                            _h.label = 2;
+                            clipboardItems = _j.sent();
+                            _j.label = 2;
                         case 2:
-                            _h.trys.push([2, 14, 15, 16]);
+                            _j.trys.push([2, 14, 15, 16]);
                             clipboardItems_1 = tslib_1.__values(clipboardItems), clipboardItems_1_1 = clipboardItems_1.next();
-                            _h.label = 3;
+                            _j.label = 3;
                         case 3:
                             if (!!clipboardItems_1_1.done) return [3 /*break*/, 13];
                             clipboardItem = clipboardItems_1_1.value;
-                            _h.label = 4;
+                            _j.label = 4;
                         case 4:
-                            _h.trys.push([4, 10, 11, 12]);
+                            _j.trys.push([4, 10, 11, 12]);
                             _a = (e_1 = void 0, tslib_1.__values(clipboardItem.types)), _b = _a.next();
-                            _h.label = 5;
+                            _j.label = 5;
                         case 5:
                             if (!!_b.done) return [3 /*break*/, 9];
                             type = _b.value;
                             return [4 /*yield*/, clipboardItem.getType(type)];
                         case 6:
-                            blob = _h.sent();
+                            blob = _j.sent();
                             return [4 /*yield*/, blob.text()];
                         case 7:
-                            text = _h.sent();
+                            text = _j.sent();
                             (_f = evt.clipboardData) === null || _f === void 0 ? void 0 : _f.setData(type, text);
-                            _h.label = 8;
+                            _j.label = 8;
                         case 8:
                             _b = _a.next();
                             return [3 /*break*/, 5];
                         case 9: return [3 /*break*/, 12];
                         case 10:
-                            e_1_1 = _h.sent();
+                            e_1_1 = _j.sent();
                             e_1 = { error: e_1_1 };
                             return [3 /*break*/, 12];
                         case 11:
@@ -280,7 +281,7 @@ var useCopyPasteCut = function (_a) {
                             return [3 /*break*/, 3];
                         case 13: return [3 /*break*/, 16];
                         case 14:
-                            e_2_1 = _h.sent();
+                            e_2_1 = _j.sent();
                             e_2 = { error: e_2_1 };
                             return [3 /*break*/, 16];
                         case 15:
@@ -290,15 +291,20 @@ var useCopyPasteCut = function (_a) {
                             finally { if (e_2) throw e_2.error; }
                             return [7 /*endfinally*/];
                         case 16:
-                            if (pasteSpecialType) {
-                                (_g = evt.clipboardData) === null || _g === void 0 ? void 0 : _g.setData("pasteSpecialType", pasteSpecialType);
+                            // The paste pipelines read the request back from these synthetic
+                            // clipboard keys (`resolvePasteSpecialOptions` in spreadsheet-state).
+                            if (typeof pasteSpecial === "string") {
+                                (_g = evt.clipboardData) === null || _g === void 0 ? void 0 : _g.setData("pasteSpecialType", pasteSpecial);
+                            }
+                            else if (pasteSpecial) {
+                                (_h = evt.clipboardData) === null || _h === void 0 ? void 0 : _h.setData("pasteSpecialOptions", JSON.stringify(pasteSpecial));
                             }
                             if (editorEl) {
                                 editorEl.dispatchEvent(evt);
                             }
                             return [3 /*break*/, 18];
                         case 17:
-                            err_1 = _h.sent();
+                            err_1 = _j.sent();
                             console.error(err_1);
                             return [3 /*break*/, 18];
                         case 18: return [2 /*return*/];