@rowsncolumns/spreadsheet-state 29.1.4 → 29.1.6

package/dist/esm/hooks/use-on-find-replace.js

@@ -1,10 +1,25 @@
-import { isNil, iterateCellsInRange } from "@rowsncolumns/utils";
+import { getCellEffectiveValue, getCellUserEnteredValue, getExtendedValueBool, getExtendedValueFormula, getExtendedValueNumber, getExtendedValueString, isNil, iterateCellsInRange, } from "@rowsncolumns/utils";
 import { produceWithPatches } from "immer";
+import isEqual from "lodash/isEqual";
 import { useCallback } from "react";
 import { createSheetCellIdentifier } from "../api/formula";
 import { createSheetDraft } from "../api/immer-utils";
-import { SheetCell } from "../sheet-cell";
+import { SheetCell, hasExcelTextPrefix, stripExcelTextPrefix, } from "../sheet-cell";
 import { buildSearchRegex } from "./use-search";
+/**
+ * The text `text` becomes after replacing every match of `regex` with
+ * `replaceWith`, or `undefined` when nothing matches / nothing changes (the
+ * cell is then left untouched). `regex` is the `g`-flagged matcher from
+ * `buildSearchRegex`, so `lastIndex` is reset before each use.
+ */
+const replaceIn = (regex, text, replaceWith) => {
+    regex.lastIndex = 0;
+    if (!regex.test(text))
+        return undefined;
+    regex.lastIndex = 0;
+    const next = text.replace(regex, replaceWith ?? "");
+    return next === text ? undefined : next;
+};
 export const useOnFindReplace = ({ locale, createHistory, onChangeSheetData, enqueueCalculation, enqueueStructureChange, sharedStringRegistry, onCommand, }) => {
     return useCallback((lookupRanges, searchStr, replaceWith, options) => {
         // Build the matcher once with the same helper `useSearch` uses, so
@@ -55,28 +70,101 @@ export const useOnFindReplace = ({ locale, createHistory, onChangeSheetData, enq
                         const currentSheet = createSheetDraft(draft, range.sheetId, rowIndex);
                         const cellData = draft[range.sheetId]?.[rowIndex]?.values?.[columnIndex];
                         sheetCell.assign(range.sheetId, { rowIndex, columnIndex }, cellData, { locale });
-                        // Match AND replace against the formatted value — what
-                        // the user sees and what `useSearch` matched. The
-                        // user-entered value can be a number / formula whose
-                        // display form ("$100.00") doesn't contain the literal
-                        // search string ("100"), so trying to replace in `sv`
-                        // alone misses those cells. Writing the replaced
-                        // formatted text back as the new user-entered value
-                        // mirrors Excel / Google Sheets — a cell that was
-                        // numeric with a currency format becomes the plain
-                        // string the user typed in the Replace box.
-                        const formattedValue = sheetCell.formattedValue;
-                        if (isNil(formattedValue))
-                            continue;
-                        // `g` flag is set by `buildSearchRegex`; reset lastIndex
-                        // before .test so a stateful regex doesn't skip the
-                        // first character on a re-run.
-                        regex.lastIndex = 0;
-                        if (!regex.test(formattedValue))
+                        // Excel's Replace edits the cell's STORED content (it runs in
+                        // "Look in: Formulas" only), so the match text and the write
+                        // depend on what the cell holds — never on the display alone:
+                        //  - a formula cell is matched on and rewritten in its SOURCE
+                        //    text (`=SUM(A1:A2)` → `=SUM(B1:A2)`); its computed result
+                        //    is not a hit, so the formula is never flattened to a
+                        //    literal;
+                        //  - a text cell is matched on its display (what `useSearch`
+                        //    highlighted) but the replacement runs over the stored
+                        //    string and is written back AS TEXT — `'0123` keeps its
+                        //    quote prefix (`'0124`), a Text-formatted `0123` stays
+                        //    `0124`, and a text whose new content looks numeric is not
+                        //    re-inferred;
+                        //  - a number / boolean / date is matched on its display
+                        //    ("$1,234.50"), the replacement runs over that display and
+                        //    the result is re-entered under the cell's own number
+                        //    format — `$1,235.50` stays the number 1235.5 in currency,
+                        //    `1/15/2025` stays a date serial — and the format itself
+                        //    is left exactly as it was.
+                        const ue = getCellUserEnteredValue(cellData);
+                        const ev = getCellEffectiveValue(cellData);
+                        const formula = getExtendedValueFormula(ue);
+                        // The legacy model keeps a number's ENTERED string in `ue.sv`
+                        // ("$1,234.50") and its value in `ev.nv`, so `ue.sv` alone does
+                        // not make a cell text: a literal is text when it evaluates to
+                        // a string, carries Excel's `'` prefix, or sits in a Text
+                        // format. Anything else with a stored string is a typed
+                        // number / boolean / date.
+                        const storedText = isNil(formula)
+                            ? getExtendedValueString(ue)
+                            : undefined;
+                        const isNumericLiteral = !isNil(getExtendedValueNumber(ev)) ||
+                            !isNil(getExtendedValueBool(ev));
+                        const isTextLiteral = !isNil(storedText) &&
+                            !isNumericLiteral &&
+                            (!isNil(getExtendedValueString(ev)) ||
+                                hasExcelTextPrefix(storedText) ||
+                                sheetCell.isText(sheetCell.getNumberFormat()));
+                        let next;
+                        let writeAsText = false;
+                        let textPrefix = "";
+                        if (!isNil(formula)) {
+                            next = replaceIn(regex, formula, replaceWith);
+                        }
+                        else {
+                            const formattedValue = sheetCell.formattedValue;
+                            if (isNil(formattedValue))
+                                continue;
+                            // `g` flag is set by `buildSearchRegex`; reset lastIndex
+                            // before .test so a stateful regex doesn't skip the
+                            // first character on a re-run.
+                            regex.lastIndex = 0;
+                            if (!regex.test(formattedValue))
+                                continue;
+                            if (isTextLiteral) {
+                                if (hasExcelTextPrefix(storedText)) {
+                                    textPrefix = "'";
+                                }
+                                const base = textPrefix
+                                    ? stripExcelTextPrefix(storedText)
+                                    : storedText;
+                                // A needle that appears only in an `@`-pattern's
+                                // decoration (`"Note: "@`) is not cell content.
+                                next = replaceIn(regex, base, replaceWith);
+                                writeAsText = true;
+                            }
+                            else {
+                                next = replaceIn(regex, formattedValue, replaceWith);
+                            }
+                        }
+                        if (isNil(next))
                             continue;
-                        regex.lastIndex = 0;
-                        const next = formattedValue.replace(regex, replaceWith ?? "");
-                        sheetCell.setUserEnteredValue(next);
+                        if (next === "") {
+                            sheetCell.setUserEnteredValue("");
+                        }
+                        else if (writeAsText) {
+                            if (textPrefix) {
+                                // The normal entry path keeps a `'`-prefixed entry as text
+                                // and preserves the prefix in `ue.sv` for the formula bar.
+                                sheetCell.setUserEnteredValue(`${textPrefix}${next}`);
+                            }
+                            else {
+                                sheetCell.setUserEnteredValue(next, undefined, {
+                                    disableTypeInference: true,
+                                });
+                            }
+                        }
+                        else {
+                            const numberFormat = sheetCell.getNumberFormat();
+                            sheetCell.setUserEnteredValue(next);
+                            if (!isNil(numberFormat) &&
+                                !isEqual(sheetCell.getNumberFormat(), numberFormat)) {
+                                sheetCell.setUserEnteredFormat("numberFormat", numberFormat);
+                            }
+                        }
                         sharedStringRegistry?.registerCell(sheetCell);
                         currentSheet[rowIndex].values[columnIndex] =
                             sheetCell.getCellData();

package/dist/esm/hooks/use-on-insert-image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-insert-image.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EACV,QAAQ,EAER,KAAK,EACN,MAAM,2BAA2B,CAAC;AAYnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,qBAAqB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,kBAAkB,CAAC,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;IAC/D,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,kHAQnE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,iBAIb,IAAI,GAAG,MAAM,WACf,MAAM,cACH,aAAa,YACf,iBAAiB,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,kBAoJhE,CAAC"}
+{"version":3,"file":"use-on-insert-image.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EACV,QAAQ,EAER,KAAK,EACN,MAAM,2BAA2B,CAAC;AAanC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,qBAAqB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,kBAAkB,CAAC,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;IAC/D,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,kHAQnE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,iBAIb,IAAI,GAAG,MAAM,WACf,MAAM,cACH,aAAa,YACf,iBAAiB,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,kBA0IhE,CAAC"}

package/dist/esm/hooks/use-on-insert-image.js

@@ -1,26 +1,25 @@
 import { useGetSheetDimensions } from "@rowsncolumns/spreadsheet";
 import { getImageDimensionsFromUrl, readImageFileAsDataUri, } from "@rowsncolumns/toolkit";
-import { log, uuid } from "@rowsncolumns/utils";
+import { log } from "@rowsncolumns/utils";
 import { produceWithPatches } from "immer";
 import { useCallback } from "react";
 import { createSheetCellIdentifier } from "../api/formula";
+import { createImageEmbed, fitImageToViewport } from "../api/image-embed";
 import { createSheetDraft } from "../api/immer-utils";
 import { SheetCell } from "../sheet-cell";
 export const useOnInsertImage = ({ locale, idCreationStrategy, enqueueCalculation, createHistory, onChangeEmbeds, onChangeSheetData, onCommand, }) => {
     const getSheetDimensions = useGetSheetDimensions();
     return useCallback(async (fileOrUrl, sheetId, activeCell, options) => {
         const { insertOverCells, embedId } = options ?? {};
-        const maxDimension = 800;
         const [imageUrl, width, height] = fileOrUrl instanceof File
             ? await readImageFileAsDataUri(fileOrUrl)
             : [
                 fileOrUrl,
                 ...(await getImageDimensionsFromUrl(fileOrUrl)),
             ];
-        const ratio = width / height;
-        const [sheetWidth = maxDimension] = getSheetDimensions?.() ?? [];
-        const finalWidth = Math.min(width, Math.min(sheetWidth, maxDimension));
-        const finalHeight = finalWidth / ratio;
+        // Excel's default picture size: natural pixels, scaled down to fit the visible grid.
+        const viewport = getSheetDimensions?.();
+        const { widthPixels: finalWidth, heightPixels: finalHeight } = fitImageToViewport(width, height, viewport);
         // Recalc cells
         const recalcCells = new Map();
         const saveHistory = createHistory();
@@ -33,25 +32,16 @@ export const useOnInsertImage = ({ locale, idCreationStrategy, enqueueCalculatio
                     if (!draft) {
                         draft = [];
                     }
-                    const embed = {
-                        embedId: idCreationStrategy?.("embed") ?? uuid(),
-                        position: {
-                            sheetId,
-                            overlayPosition: {
-                                anchorCell: activeCell,
-                                widthPixels: finalWidth,
-                                heightPixels: finalHeight,
-                                offsetXPixels: 0,
-                                offsetYPixels: 0,
-                            },
-                        },
-                        borderColor: "transparent",
-                        lockAspectRatio: true,
-                        spec: {
-                            type: "image",
-                            imageUrl,
-                        },
-                    };
+                    // The same floating picture the clipboard paste / file drop create.
+                    const embed = createImageEmbed({
+                        sheetId,
+                        anchorCell: activeCell,
+                        imageUrl,
+                        width,
+                        height,
+                        viewport,
+                        idCreationStrategy,
+                    });
                     if (embedId) {
                         const idx = draft.findIndex((cur) => cur.embedId === embedId);
                         if (idx !== -1) {

package/dist/esm/hooks/use-on-paste.d.ts

@@ -95,7 +95,8 @@ type UseOnPasteProps<T extends CellData, S extends Sheet> = {
      */
     onChangeCitations?: UseSpreadsheetProps<T, S>["onChangeCitations"];
     /**
-     * Optional HTML sanitizer for clipboard paste operations
+     * Optional additional HTML sanitizer for clipboard paste operations. The
+     * built-in sanitizer always runs afterwards; this can only tighten it.
      */
     sanitizeHtml?: (html: string) => string;
     /**

package/dist/esm/hooks/use-on-paste.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-paste.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-paste.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-on-paste.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-paste.ts"],"names":[],"mappings":"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"}

package/dist/esm/hooks/use-on-paste.js

@@ -1,7 +1,7 @@
 import { isStaticNode } from "@rowsncolumns/dag";
 import { areaInsideArea, areaIntersects, isAreasEqual } from "@rowsncolumns/grid";
 import { selectionFromActiveCell } from "@rowsncolumns/grid";
-import { DEFAULT_COLUMN_COUNT, DEFAULT_ROW_COUNT, findActiveTableWithinCell, loadWebFont, MAX_COLUMN_COUNT, MAX_ROW_COUNT, useFocusEmbedOrChart, useGetFinalRowHeight, useRedrawGrid, } from "@rowsncolumns/spreadsheet";
+import { DEFAULT_COLUMN_COUNT, DEFAULT_ROW_COUNT, findActiveTableWithinCell, loadWebFont, MAX_COLUMN_COUNT, MAX_ROW_COUNT, useFocusEmbedOrChart, useGetFinalRowHeight, useGetSheetDimensions, useRedrawGrid, } from "@rowsncolumns/spreadsheet";
 import { isSelectionACell, useGetEffectiveValuesFromRange, } from "@rowsncolumns/spreadsheet";
 import { error, getCellFormattedValue, getCellUserEnteredFormat, getCellUserEnteredValue, getExtendedValueBool, getExtendedValueFormula, getExtendedValueNumber, getExtendedValueString, isNil, iterateCellsInRange, uuidString, } from "@rowsncolumns/utils";
 import { produceWithPatches } from "immer";
@@ -73,6 +73,7 @@ export const useOnPaste = ({ rowCount, columnCount, locale, sheetData, tables: c
     });
     const redrawGrid = useRedrawGrid();
     const getFinalRowHeight = useGetFinalRowHeight();
+    const getSheetDimensions = useGetSheetDimensions();
     const { enqueue, processQueue } = useCalculationQueue({ enqueueCalculation });
     return useCallback(async (e, sourceSheetId, destinationSheetId, copiedSelections, activeCell, selections, finalSelections, isCutOperation) => {
         // Paste Special request (values / formats / formulas, operation, skip
@@ -109,7 +110,7 @@ export const useOnPaste = ({ rowCount, columnCount, locale, sheetData, tables: c
             }
         }
         else {
-            const pasteResults = await generateDataFromClipboard(e, activeCell, destinationSheetId, activeSheetName, preserveFormatting, locale, idCreationStrategy, forcePlainText, sanitizeHtml);
+            const pasteResults = await generateDataFromClipboard(e, activeCell, destinationSheetId, activeSheetName, preserveFormatting, locale, idCreationStrategy, forcePlainText, sanitizeHtml, { imageViewport: getSheetDimensions?.() });
             selectedRowValues = pasteResults?.results ?? [];
             merges = pasteResults?.merges;
             embeds = pasteResults?.embeds;
@@ -121,6 +122,34 @@ export const useOnPaste = ({ rowCount, columnCount, locale, sheetData, tables: c
         if (isNil(selectedRowValues)) {
             return;
         }
+        // Floating objects the clipboard carried (the pasted picture(s) of an image paste) — one
+        // undo entry, the first one selected, like a freshly inserted chart.
+        const insertEmbeds = (saveHistory, pastedEmbeds) => {
+            const firstEmbedId = pastedEmbeds[0].embedId;
+            onChangeEmbeds?.((prevEmbeds) => {
+                const [nextState, patches, inversePatches] = produceWithPatches(prevEmbeds, (draft) => {
+                    draft.push(...pastedEmbeds);
+                });
+                saveHistory({
+                    embeds: { patches, inversePatches },
+                    selectedEmbedOrChart: { redo: firstEmbedId, undo: undefined },
+                });
+                return nextState;
+            });
+            // Selected first embed
+            focusEmbedOrChart(firstEmbedId);
+        };
+        // An image paste writes NO cells: the picture floats over the grid anchored at the active
+        // cell (Excel / Google Sheets Ctrl+V of a picture), so it skips the cell-paste pipeline.
+        if (!selectedRowValues.length && embeds?.length) {
+            const anchorRange = selectionFromActiveCell(activeCell)[0].range;
+            if (!canEditCellRange(destinationSheetId, anchorRange)) {
+                console.debug("Protected range, You cannot paste on to protected cells.");
+                return;
+            }
+            insertEmbeds(createHistory(), embeds);
+            return;
+        }
         if (pasteSpecial.transpose && selectedRowValues.length) {
             selectedRowValues = transpose(selectedRowValues);
         }
@@ -668,6 +697,13 @@ export const useOnPaste = ({ rowCount, columnCount, locale, sheetData, tables: c
                                     }
                                 }
                             }
+                            // The landed block replaces the merge geometry it covers (Excel: pasting a
+                            // block over a merged cell unmerges it so every pasted value is visible; a
+                            // cut block's merges travel with it, and a partial cover was refused above).
+                            // A single copied cell pasted onto a merged cell keeps the merge and fills it.
+                            if (sheet.merges?.length && rowSpan * colSpan > 1) {
+                                sheet.merges = sheet.merges.filter((merge) => !areaIntersects(merge, to.range));
+                            }
                             // Update merges
                             if (mergesToAdd) {
                                 sheet.merges = sheet.merges ?? [];
@@ -717,6 +753,12 @@ export const useOnPaste = ({ rowCount, columnCount, locale, sheetData, tables: c
                                     // Clipboard-provided row heights win.
                                     if (clipboardSizedRows.has(rowIndex))
                                         continue;
+                                    // Excel keeps a custom (user-dragged) height: only auto-height
+                                    // rows refit to pasted wrapped / multi-line text. The grid's
+                                    // measurer also skips pinned rows — the guard here keeps the
+                                    // rule at the write site so no measurer can clobber the pin.
+                                    if (sheet.rowMetadata?.[rowIndex]?.resizedByUser)
+                                        continue;
                                     const rowData = selectedRowValues[dataRowIndex];
                                     if (!rowData)
                                         continue;
@@ -918,19 +960,7 @@ export const useOnPaste = ({ rowCount, columnCount, locale, sheetData, tables: c
             }
             // Embeds
             if (embeds?.length) {
-                const firstEmbedId = embeds[0].embedId;
-                onChangeEmbeds?.((prevEmbeds) => {
-                    const [nextState, patches, inversePatches] = produceWithPatches(prevEmbeds, (draft) => {
-                        draft.push(...embeds);
-                    });
-                    saveHistory({
-                        embeds: { patches, inversePatches },
-                        selectedEmbedOrChart: { redo: firstEmbedId, undo: undefined },
-                    });
-                    return nextState;
-                });
-                // Selected first embed
-                focusEmbedOrChart(embeds[0].embedId);
+                insertEmbeds(saveHistory, embeds);
             }
             // Tables
             if (tables?.length) {
@@ -1091,6 +1121,7 @@ export const useOnPaste = ({ rowCount, columnCount, locale, sheetData, tables: c
         getUserEnteredValue,
         focusEmbedOrChart,
         redrawGrid,
+        getSheetDimensions,
         processQueue,
         enqueue,
         isHiddenByFilterRow,

package/dist/esm/hooks/use-on-rename-sheet.d.ts

@@ -7,6 +7,8 @@ import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
 import type { SpreadsheetPatch } from "./use-undo-redo";
 type UseOnRenameSheetProps<T extends CellData, S extends Sheet> = {
     locale?: string;
+    /** The workbook's sheets — a rename to a title another sheet holds (case-insensitively) is refused. */
+    sheets: S[];
     onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
     onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
     onChangeActiveCell(sheetId: number, cell: CellInterface): void;
@@ -16,6 +18,6 @@ type UseOnRenameSheetProps<T extends CellData, S extends Sheet> = {
     createHistory(): (patches: SpreadsheetPatch) => void;
     onCommand?: OnCommand;
 };
-export declare const useOnRenameSheet: <T extends CellData, S extends Sheet>({ locale, onChangeSheetData, onChangeSheets, onChangeActiveCell, getActiveCell, getGraphNodes, getPrecedents, createHistory, onCommand, }: UseOnRenameSheetProps<T, S>) => (sheetId: number, name: string, oldName: string) => void;
+export declare const useOnRenameSheet: <T extends CellData, S extends Sheet>({ locale, sheets, onChangeSheetData, onChangeSheets, onChangeActiveCell, getActiveCell, getGraphNodes, getPrecedents, createHistory, onCommand, }: UseOnRenameSheetProps<T, S>) => (sheetId: number, name: string, oldName: string) => void;
 export {};
 //# sourceMappingURL=use-on-rename-sheet.d.ts.map

package/dist/esm/hooks/use-on-rename-sheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-rename-sheet.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-rename-sheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,aAAa,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAKtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,qBAAqB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/D,aAAa,IAAI,aAAa,CAAC;IAC/B,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC,CAAC;IACpE,aAAa,CACX,MAAM,EAAE,cAAc,GACrB,CAAC,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC,EAAE,CAAC;IAC7C,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,2IAUnE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,eAIhB,MAAM,QAAQ,MAAM,WAAW,MAAM,SAyFlD,CAAC"}
+{"version":3,"file":"use-on-rename-sheet.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-rename-sheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,aAAa,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAOtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,qBAAqB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uGAAuG;IACvG,MAAM,EAAE,CAAC,EAAE,CAAC;IACZ,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/D,aAAa,IAAI,aAAa,CAAC;IAC/B,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC,CAAC;IACpE,aAAa,CACX,MAAM,EAAE,cAAc,GACrB,CAAC,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC,EAAE,CAAC;IAC7C,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,mJAWnE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,eAKhB,MAAM,QAAQ,MAAM,WAAW,MAAM,SAiGlD,CAAC"}

package/dist/esm/hooks/use-on-rename-sheet.js

@@ -1,18 +1,26 @@
+import { validateSheetName } from "@rowsncolumns/utils";
 import { produceWithPatches } from "immer";
 import { useCallback } from "react";
 import { updateFormulaSheetReferences } from "../api/rename-sheet";
-import { isValidSheetTitle, truncateSheetTitle } from "../helpers/sheet-title";
+import { useShowError } from "../atoms/error-state.atom";
 import { useCanEditSheet, useCanEditWorkbook } from "./use-can-edit-cellrange";
-export const useOnRenameSheet = ({ locale, onChangeSheetData, onChangeSheets, onChangeActiveCell, getActiveCell, getGraphNodes, getPrecedents, createHistory, onCommand, }) => {
+export const useOnRenameSheet = ({ locale, sheets, onChangeSheetData, onChangeSheets, onChangeActiveCell, getActiveCell, getGraphNodes, getPrecedents, createHistory, onCommand, }) => {
     const canEditSheet = useCanEditSheet();
     const canEditWorkbook = useCanEditWorkbook();
+    const showError = useShowError();
     return useCallback((sheetId, name, oldName) => {
-        // Worksheet names cannot be empty or whitespace-only
-        if (!isValidSheetTitle(name)) {
-            console.debug("Sheet name cannot be empty.");
+        // Excel's worksheet-name rules (rowsncolumns/spreadsheet#939 U-01): at most 31 characters,
+        // none of `\ / ? * [ ] :`, no leading / trailing apostrophe, not `History`, and unique
+        // case-insensitively (the calc engine's sheet registry folds case too: `SHEET1` beside
+        // `Sheet1` would alias one engine sheet). Every refusal shows Excel's dialog text; a blank
+        // name is a silent no-op (the tab editor's "nothing typed").
+        const validation = validateSheetName(name, sheets, sheetId);
+        if (!validation.ok) {
+            if (validation.reason !== "blank") {
+                showError({ title: "Error", message: validation.message });
+            }
             return;
         }
-        const truncatedName = truncateSheetTitle(name);
         if (!canEditWorkbook()) {
             console.debug("Workbook is structurally protected, cannot rename a sheet.");
             return;
@@ -27,7 +35,7 @@ export const useOnRenameSheet = ({ locale, onChangeSheetData, onChangeSheets, on
             const [nextState, patches, inversePatches] = produceWithPatches(prevSheets, (draft) => {
                 const sheet = draft.find((sheet) => sheet.sheetId === sheetId);
                 if (sheet) {
-                    sheet.title = truncatedName;
+                    sheet.title = name;
                 }
             });
             // Save sheets history
@@ -42,7 +50,7 @@ export const useOnRenameSheet = ({ locale, onChangeSheetData, onChangeSheets, on
                 updateFormulaSheetReferences(draft, {
                     sheetId,
                     oldName,
-                    newName: truncatedName,
+                    newName: name,
                     locale,
                     getGraphNodes,
                     getPrecedents,
@@ -59,11 +67,12 @@ export const useOnRenameSheet = ({ locale, onChangeSheetData, onChangeSheets, on
         onCommand?.({
             command: "rename-sheet",
             sheetId,
-            name: truncatedName,
+            name,
             oldName,
         });
     }, [
         locale,
+        sheets,
         onChangeActiveCell,
         onChangeSheetData,
         onChangeSheets,
@@ -73,6 +82,7 @@ export const useOnRenameSheet = ({ locale, onChangeSheetData, onChangeSheets, on
         createHistory,
         canEditSheet,
         canEditWorkbook,
+        showError,
         onCommand,
     ]);
 };

package/dist/esm/hooks/use-on-sort-column.d.ts

@@ -1,3 +1,4 @@
+import type { GridRange } from "@rowsncolumns/common-types";
 import { type CellData, type Sheet, type SortOrder, type SpreadsheetTheme } from "@rowsncolumns/spreadsheet";
 import type { OnCommand } from "../commands";
 import type { useCalculation } from "./use-calculation";
@@ -41,6 +42,11 @@ export type UseOnSortColumnProps<T extends CellData, S extends Sheet = Sheet> =
     getCellData(sheetId: number, rowIndex: number, columnIndex: number): T | null | undefined;
     /** Length of the sheet's committed data array — the last row a sort touches. */
     getDataRowCount(sheetId: number): number | undefined;
+    /**
+     * The sheet's merged regions. Excel refuses a sort over merged cells that
+     * are not laid out identically on every row of the sorted block.
+     */
+    getMerges?(sheetId: number): GridRange[] | null | undefined;
     /**
      * Any hidden row (by the user, a filter, or a collapsed group). Used as
      * the pin predicate only when `isManuallyHiddenRow` is not supplied.
@@ -74,5 +80,5 @@ export type UseOnSortColumnProps<T extends CellData, S extends Sheet = Sheet> =
  * @param param0
  * @returns
  */
-export declare const useOnSortColumn: <T extends CellData, S extends Sheet = Sheet>({ rowCount, columnCount, locale, sharedStringRegistry, createHistory, enqueueCalculation, enqueueStructureChange, enqueueGraphOperation, onChangeSheetData, onChangeSheets, getCellData, getDataRowCount, isHiddenRow, isManuallyHiddenRow, getDependents, getFrozenRowCount, getSheetName, getEffectiveFormat, theme, enableSortTimingLogs, onCommand, }: UseOnSortColumnProps<T, S>) => (sheetId: number, sortedColumnIndex: number, sortOrder: SortOrder, options?: SortColumnOptions, additionalLevels?: SortColumnLevel[]) => void;
+export declare const useOnSortColumn: <T extends CellData, S extends Sheet = Sheet>({ rowCount, columnCount, locale, sharedStringRegistry, createHistory, enqueueCalculation, enqueueStructureChange, enqueueGraphOperation, onChangeSheetData, onChangeSheets, getCellData, getDataRowCount, getMerges, isHiddenRow, isManuallyHiddenRow, getDependents, getFrozenRowCount, getSheetName, getEffectiveFormat, theme, enableSortTimingLogs, onCommand, }: UseOnSortColumnProps<T, S>) => (sheetId: number, sortedColumnIndex: number, sortOrder: SortOrder, options?: SortColumnOptions, additionalLevels?: SortColumnLevel[]) => void;
 //# sourceMappingURL=use-on-sort-column.d.ts.map

package/dist/esm/hooks/use-on-sort-column.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-sort-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-sort-column.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-on-sort-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-sort-column.ts"],"names":[],"mappings":"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"}

package/dist/esm/hooks/use-on-sort-column.js

@@ -4,6 +4,7 @@ import { produceWithPatches } from "immer";
 import { useCallback } from "react";
 import { createSheetCellIdentifier } from "../api/formula";
 import { getCellSortValue } from "../api/sort";
+import { getSortMergeRefusal } from "../api/structural-guards";
 import { createSheetDraft } from "../api/immer-utils";
 import { SheetCell } from "../sheet-cell";
 import { useShowError } from "../atoms/error-state.atom";
@@ -33,7 +34,7 @@ const buildSortValue = (options, fallbackValue, getEffectiveFormat, theme, sheet
  * @param param0
  * @returns
  */
-export const useOnSortColumn = ({ rowCount, columnCount, locale, sharedStringRegistry, createHistory, enqueueCalculation, enqueueStructureChange, enqueueGraphOperation, onChangeSheetData, onChangeSheets, getCellData, getDataRowCount, isHiddenRow, isManuallyHiddenRow, getDependents, getFrozenRowCount, getSheetName, getEffectiveFormat, theme, enableSortTimingLogs, onCommand, }) => {
+export const useOnSortColumn = ({ rowCount, columnCount, locale, sharedStringRegistry, createHistory, enqueueCalculation, enqueueStructureChange, enqueueGraphOperation, onChangeSheetData, onChangeSheets, getCellData, getDataRowCount, getMerges, isHiddenRow, isManuallyHiddenRow, getDependents, getFrozenRowCount, getSheetName, getEffectiveFormat, theme, enableSortTimingLogs, onCommand, }) => {
     const canEditSheet = useCanEditSheet();
     const canPerformSheetAction = useCanPerformSheetAction();
     const showError = useShowError();
@@ -60,6 +61,21 @@ export const useOnSortColumn = ({ rowCount, columnCount, locale, sharedStringReg
             ? performance.now.bind(performance)
             : Date.now;
         const activeSheetName = getSheetName(sheetId);
+        // Excel refuses to sort a block whose merged cells differ in layout between rows — the
+        // anchor values would move while the merge outlines stayed behind.
+        const mergeRefusal = getSortMergeRefusal({
+            range: {
+                startRowIndex: 1,
+                endRowIndex: getDataRowCount(sheetId) ?? 0,
+                startColumnIndex: 1,
+                endColumnIndex: columnCount,
+            },
+            merges: getMerges?.(sheetId),
+        });
+        if (mergeRefusal) {
+            showError(mergeRefusal);
+            return;
+        }
         // We need to track this for history. Precedent cells
         const recalcCells = new Map();
         // History
@@ -290,6 +306,7 @@ export const useOnSortColumn = ({ rowCount, columnCount, locale, sharedStringReg
         onChangeSheets,
         getCellData,
         getDataRowCount,
+        getMerges,
         isHiddenRow,
         isManuallyHiddenRow,
         getDependents,

package/dist/esm/hooks/use-on-sort-range.d.ts

@@ -1,4 +1,5 @@
-import type { SelectionArea } from "@rowsncolumns/common-types";
+import type { GridRange, SelectionArea } from "@rowsncolumns/common-types";
+import { type CellInterface } from "@rowsncolumns/grid";
 import { type CellData, type Sheet, type SelectionAttributes, type SortOrder, type SpreadsheetTheme } from "@rowsncolumns/spreadsheet";
 import type { OnCommand } from "../commands";
 import type { useCalculation } from "./use-calculation";
@@ -42,6 +43,12 @@ export type UseOnSortRangeProps<T extends CellData, S extends Sheet = Sheet> = {
     getDependents: ReturnType<typeof useCalculation>["getDependents"];
     getFrozenRowCount(sheetId: number): number;
     getSheetName(sheetId: number): string;
+    /**
+     * The sheet's merged regions. A range whose merges are not laid out
+     * identically on every row is refused (Excel), because the sort would move
+     * the anchor values without their merge outlines.
+     */
+    getMerges?(sheetId: number): GridRange[] | null | undefined;
     /**
      * Optional — needed when callers pass per-column specs using
      * `sortBy: "cellColor" | "fontColor" | "icon"`. Without it those sort
@@ -54,6 +61,13 @@ export type UseOnSortRangeProps<T extends CellData, S extends Sheet = Sheet> = {
      */
     theme: SpreadsheetTheme;
     onCommand?: OnCommand;
+    /**
+     * The cursor at sort time. When it stands inside the sorted range (and no
+     * per-column `specs` are given) its column is the sort key — Excel / Sheets
+     * "Sort A to Z" sorts the range by the column the user is in, not by its
+     * leftmost column. Without it the legacy leftmost-column-first order applies.
+     */
+    getActiveCell?: () => CellInterface | null | undefined;
 };
 /**
  * Sorts a column range.
@@ -61,5 +75,5 @@ export type UseOnSortRangeProps<T extends CellData, S extends Sheet = Sheet> = {
  * @param param0
  * @returns
  */
-export declare const useOnSortRange: <T extends CellData, S extends Sheet = Sheet>({ locale, sharedStringRegistry, createHistory, enqueueStructureChange, enqueueGraphOperation, enqueueCalculation, onChangeSheetData, onChangeSheets, getCellData, getDependents, isHiddenRow, isManuallyHiddenRow, getFrozenRowCount, getSheetName, getEffectiveFormat, theme, onCommand, }: UseOnSortRangeProps<T, S>) => (sheetId: number, selections: SelectionArea<SelectionAttributes>[], sortOrder: SortOrder, specs?: DimensionSortSpec[]) => void;
+export declare const useOnSortRange: <T extends CellData, S extends Sheet = Sheet>({ locale, sharedStringRegistry, createHistory, enqueueStructureChange, enqueueGraphOperation, enqueueCalculation, onChangeSheetData, onChangeSheets, getCellData, getDependents, isHiddenRow, isManuallyHiddenRow, getFrozenRowCount, getSheetName, getMerges, getEffectiveFormat, theme, onCommand, getActiveCell, }: UseOnSortRangeProps<T, S>) => (sheetId: number, selections: SelectionArea<SelectionAttributes>[], sortOrder: SortOrder, specs?: DimensionSortSpec[]) => void;
 //# sourceMappingURL=use-on-sort-range.d.ts.map

package/dist/esm/hooks/use-on-sort-range.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-sort-range.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-sort-range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,KAAK,EAIV,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AAQnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,mBAAmB,CAC7B,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,GAAG,KAAK,IACrB;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,cAAc,CACtB,CAAC,wBAAwB,CAAC,CAAC;IAC5B,qBAAqB,EAAE,UAAU,CAC/B,OAAO,cAAc,CACtB,CAAC,uBAAuB,CAAC,CAAC;IAC3B,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC/D;;;;OAIG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7D;;;;OAIG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACxD;;;;;OAKG;IACH,mBAAmB,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,UAAU,CAC7B,OAAO,kBAAkB,CAC1B,CAAC,oBAAoB,CAAC,CAAC;IACxB;;;OAGG;IACH,KAAK,EAAE,gBAAgB,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,6RAkBzE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,eAMb,MAAM,cACH,aAAa,CAAC,mBAAmB,CAAC,EAAE,aACrC,SAAS,UAQZ,iBAAiB,EAAE,SA2UhC,CAAC"}
+{"version":3,"file":"use-on-sort-range.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-sort-range.ts"],"names":[],"mappings":"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"}