@rowsncolumns/spreadsheet-state 28.0.76 → 29.1.0

package/dist/esm/api/formula.js

@@ -1,4 +1,4 @@
-import { cleanupColumnName, cleanupTableName, isRangeToken, lexify, stripPropertyFromCellRef, tokenVocabulary, } from "@rowsncolumns/calculator";
+import { cleanupColumnName, cleanupSpecialItem, cleanupTableName, detectCurrentRow, isRangeToken, lexify, stripPropertyFromCellRef, tokenVocabulary, } from "@rowsncolumns/calculator";
 import { addressToCell, alpha2number, cellToAddress, desanitizeSheetName, number2Alpha, sanitizeSheetName, } from "@rowsncolumns/utils";
 export { ERROR_CIRCULAR_DEPENDENCY, ERROR_REFERENCE, formulaToRelativeReference, } from "@rowsncolumns/calculator";
 /**
@@ -151,11 +151,79 @@ export const breakTableReferencesInFormula = (formulaValue, tableName) => {
  * Excel's text for a deleted table column (`=Table1[@Qty]*2` →
  * `=Table1[@#REF!]*2`). Keeps every other character of the reference as typed.
  */
-export const breakTableColumnsInFormula = (formulaValue, tableName, columnNames) => {
-    if (!formulaValue.includes("[") || columnNames.length === 0) {
+export const breakTableColumnsInFormula = (formulaValue, tableName, columnNames) => replaceTableColumnsInFormula(formulaValue, tableName, columnNames, REF_ERROR_COLUMN);
+/**
+ * Rename the column `oldName` → `newName` inside the structured references to
+ * `tableName` (or, when `tableName` is undefined, the bare this-row form
+ * `[@Col]` whose table is implied by the formula's own cell): `Table1[Qty]`,
+ * `[@Qty]`, `Table1[[#Headers],[Qty]]` and `Table1[[Qty]:[Price]]` all follow
+ * a header-cell edit in Excel. Column names compare case-insensitively; every
+ * other character of the reference is kept as typed.
+ */
+export const renameTableColumnInFormula = (formulaValue, tableName, oldName, newName) => oldName && newName && oldName !== newName
+    ? renameTableColumnsInFormula(formulaValue, tableName, new Map([[oldName.toLowerCase(), newName]]))
+    : formulaValue;
+/**
+ * Rename several columns of `tableName` at once — `renames` maps each
+ * LOWER-CASED old name to its new name. One pass over the formula, so
+ * `Name` → `Qty` and `Qty` → `Name` swap instead of chaining into the same
+ * column (a header row re-derived after a row delete, or several header cells
+ * written by one paste / change-batch).
+ */
+export const renameTableColumnsInFormula = (formulaValue, tableName, renames) => rewriteTableColumnsInFormula(formulaValue, tableName, (name) => renames.get(name));
+/**
+ * Rename the table `oldName` → `newName` in every structured reference
+ * (`Old[Col]`, `Old[@Col]`, `Old[[#Headers],[Col]]`, `Old[#All]`) — Excel
+ * rewrites them all when a table is renamed. Table names compare
+ * case-insensitively; the bare `[@Col]` form names no table and is left alone.
+ */
+export const renameTableInFormula = (formulaValue, oldName, newName) => {
+    if (!oldName || !newName || oldName === newName) {
+        return formulaValue;
+    }
+    return renameTablesInFormula(formulaValue, new Map([[oldName.toLowerCase(), newName]]));
+};
+/**
+ * Rename several tables at once — `renames` maps each LOWER-CASED old name to
+ * its new name. One pass, so `Sales` → `Sales2` and `Sales2` → `Sales3` never
+ * chain (a sheet duplicated with both tables re-points each reference exactly
+ * once).
+ */
+export const renameTablesInFormula = (formulaValue, renames) => {
+    if (!formulaValue.includes("[") || renames.size === 0) {
+        return formulaValue;
+    }
+    const tokens = cloneTokens(lexify(formulaValue).tokens);
+    let hasChanges = false;
+    for (const token of tokens) {
+        if (!isTableNameToken(token))
+            continue;
+        const newName = renames.get(cleanupTableName(token.image).trim().toLowerCase());
+        if (newName === undefined)
+            continue;
+        // The image is the name as typed plus its opening bracket.
+        token.image = newName + token.image.slice(token.image.indexOf("["));
+        hasChanges = true;
+    }
+    return hasChanges ? detokenize(tokens) : formulaValue;
+};
+const replaceTableColumnsInFormula = (formulaValue, tableName, columnNames, replacement) => {
+    if (columnNames.length === 0) {
         return formulaValue;
     }
     const targets = new Set(columnNames.map((name) => name.toLowerCase()));
+    return rewriteTableColumnsInFormula(formulaValue, tableName, (name) => targets.has(name) ? replacement : undefined);
+};
+/**
+ * Rewrite the column items of every structured reference into `tableName`
+ * (or, when undefined, the bare `[@Col]` forms) through `resolve`, which maps
+ * a LOWER-CASED column name to its replacement or `undefined` to leave it.
+ * Each item is resolved once, so a set of renames applies in a single pass.
+ */
+const rewriteTableColumnsInFormula = (formulaValue, tableName, resolve) => {
+    if (!formulaValue.includes("[")) {
+        return formulaValue;
+    }
     const target = tableName?.toLowerCase();
     const tokens = cloneTokens(lexify(formulaValue).tokens);
     let hasChanges = false;
@@ -168,8 +236,9 @@ export const breakTableColumnsInFormula = (formulaValue, tableName, columnNames)
                 cleanupTableName(token.image).trim().toLowerCase() === target;
             if (matches) {
                 for (let j = i + 1; j < end; j++) {
-                    if (breakColumnToken(tokens[j], targets))
+                    if (replaceColumnToken(tokens[j], resolve)) {
                         hasChanges = true;
+                    }
                 }
             }
             i = end;
@@ -177,26 +246,184 @@ export const breakTableColumnsInFormula = (formulaValue, tableName, columnNames)
         }
         // A bare `[@Col]` / `[Col]` names the table the formula cell sits in.
         if (target === undefined && isTableColumnToken(token)) {
-            if (breakColumnToken(token, targets))
+            if (replaceColumnToken(token, resolve))
                 hasChanges = true;
         }
         i++;
     }
     return hasChanges ? detokenize(tokens) : formulaValue;
 };
-const breakColumnToken = (token, targets) => {
+const replaceColumnToken = (token, resolve) => {
     if (!token || !isTableColumnToken(token))
         return false;
     const name = cleanupColumnName(token.image);
-    if (!name || !targets.has(name.toLowerCase()))
+    if (!name)
+        return false;
+    const replacement = resolve(name.toLowerCase());
+    if (replacement === undefined)
         return false;
     const at = token.image.indexOf(name);
     if (at === -1)
         return false;
     token.image =
-        token.image.slice(0, at) + REF_ERROR_COLUMN + token.image.slice(at + name.length);
+        token.image.slice(0, at) + replacement + token.image.slice(at + name.length);
     return true;
 };
+/**
+ * Rewrite every structured reference into `table` — `T[Col]`, `T[[#Headers],[Col]]`, `T[#All]`,
+ * `T[[A]:[B]]`, `T[@Col]`, `T[[#This Row],[Col]]` and, inside the table, the bare `[@Col]` /
+ * `[Col]` forms — to the plain A1 reference it resolves to, the way Excel's Convert to Range
+ * rewrites formulas so their values keep working once the table is gone. Column, header, totals
+ * and whole-table items become absolute (`$B$2:$B$9`, `$B$1`), this-row items the relative
+ * same-row reference (`B3`), and the reference is qualified with the table's sheet when the
+ * formula lives on another one. A reference that cannot resolve (an unknown column, `#Headers`
+ * on a headerless table, `@` outside the table's data rows) becomes the `#REF!` it would have
+ * evaluated to. Returns the input unchanged when the formula never references the table.
+ */
+export const convertStructuredRefsToA1InFormula = (formulaValue, table, options) => {
+    if (!formulaValue.includes("["))
+        return formulaValue;
+    const target = table.title.toLowerCase();
+    const tokens = cloneTokens(lexify(formulaValue).tokens);
+    const newTokens = [];
+    let hasChanges = false;
+    let i = 0;
+    while (i < tokens.length) {
+        const token = tokens[i];
+        if (isTableNameToken(token)) {
+            const end = structuredReferenceEnd(tokens, i);
+            if (cleanupTableName(token.image).trim().toLowerCase() !== target) {
+                // Another table's reference: keep it whole (its `@Col` items are not bare forms).
+                newTokens.push(...tokens.slice(i, end));
+                i = end;
+                continue;
+            }
+            newTokens.push(collapseToReference(token, tokens[end - 1], resolveStructuredReference(table, tokens.slice(i + 1, end), options)));
+            hasChanges = true;
+            i = end;
+            continue;
+        }
+        // A bare `[@Col]` / `[Col]` names the table the formula cell sits in.
+        if (options.inTable &&
+            isTableColumnToken(token) &&
+            token.image.startsWith("[")) {
+            const end = structuredReferenceEnd(tokens, i);
+            newTokens.push(collapseToReference(token, tokens[end - 1], resolveStructuredReference(table, tokens.slice(i, end), options)));
+            hasChanges = true;
+            i = end;
+            continue;
+        }
+        newTokens.push(token);
+        i++;
+    }
+    return hasChanges ? detokenize(newTokens) : formulaValue;
+};
+/** One reference token (or `#REF!`) standing in for the run `start … end` (see `collapseToRefError`). */
+const collapseToReference = (start, end, image) => ({
+    ...start,
+    image,
+    tokenType: image === REF_ERROR_TOKEN
+        ? tokenVocabulary.RefError
+        : tokenVocabulary.Cell,
+    endOffset: end?.endOffset ?? start.endOffset,
+    endColumn: end?.endColumn ?? start.endColumn,
+});
+/**
+ * The A1 text the structured-reference `specifier` tokens (everything after the table name up to
+ * the closing bracket, or the bare column form) resolve to against `table`, or `#REF!`.
+ */
+const resolveStructuredReference = (table, specifier, { tableSheetName, formulaSheetName, formulaRowIndex }) => {
+    let thisRow = false;
+    const items = new Set();
+    const columns = [];
+    for (const token of specifier) {
+        const name = token.tokenType.name;
+        if (name === tokenVocabulary.SpecialItem.name) {
+            const item = cleanupSpecialItem(token.image).trim().toLowerCase();
+            if (item === "#this row")
+                thisRow = true;
+            else
+                items.add(item);
+        }
+        else if (name === tokenVocabulary.TableColumnName.name) {
+            if (detectCurrentRow(token.image))
+                thisRow = true;
+            const column = cleanupColumnName(token.image).trim();
+            if (column)
+                columns.push(column);
+        }
+        else if (name === tokenVocabulary.At.name) {
+            thisRow = true;
+        }
+    }
+    const { range } = table;
+    const headerRow = table.headerRow ?? true;
+    const totalRow = table.totalRow ?? false;
+    const dataStartRowIndex = range.startRowIndex + (headerRow ? 1 : 0);
+    const dataEndRowIndex = range.endRowIndex - (totalRow ? 1 : 0);
+    // Column span: the named column, or the `[A]:[B]` pair (either order); none → every column.
+    let startColumnIndex = range.startColumnIndex;
+    let endColumnIndex = range.endColumnIndex;
+    if (columns.length) {
+        if (columns.length > 2)
+            return REF_ERROR_TOKEN;
+        const offsets = columns.map((column) => table.columnNames.findIndex((candidate) => candidate.toLowerCase() === column.toLowerCase()));
+        if (offsets.some((offset) => offset === -1))
+            return REF_ERROR_TOKEN;
+        startColumnIndex = range.startColumnIndex + Math.min(...offsets);
+        endColumnIndex = range.startColumnIndex + Math.max(...offsets);
+    }
+    // Row band.
+    let startRowIndex;
+    let endRowIndex;
+    if (thisRow) {
+        if (items.size ||
+            formulaRowIndex < dataStartRowIndex ||
+            formulaRowIndex > range.endRowIndex) {
+            return REF_ERROR_TOKEN;
+        }
+        startRowIndex = endRowIndex = formulaRowIndex;
+    }
+    else if (items.has("#all")) {
+        startRowIndex = range.startRowIndex;
+        endRowIndex = range.endRowIndex;
+    }
+    else {
+        const bands = [];
+        if (items.has("#headers")) {
+            if (!headerRow)
+                return REF_ERROR_TOKEN;
+            bands.push([range.startRowIndex, range.startRowIndex]);
+        }
+        if (items.has("#data") || (!items.has("#headers") && !items.has("#totals"))) {
+            if (dataStartRowIndex > dataEndRowIndex)
+                return REF_ERROR_TOKEN;
+            bands.push([dataStartRowIndex, dataEndRowIndex]);
+        }
+        if (items.has("#totals")) {
+            if (!totalRow)
+                return REF_ERROR_TOKEN;
+            bands.push([range.endRowIndex, range.endRowIndex]);
+        }
+        bands.sort((a, b) => a[0] - b[0]);
+        [startRowIndex, endRowIndex] = bands[0];
+        for (const [bandStart, bandEnd] of bands.slice(1)) {
+            // `[#Headers],[#Totals]` skips the data rows: not one rectangle.
+            if (bandStart > endRowIndex + 1)
+                return REF_ERROR_TOKEN;
+            endRowIndex = Math.max(endRowIndex, bandEnd);
+        }
+    }
+    const absolute = !thisRow;
+    const start = cellToAddress({ rowIndex: startRowIndex, columnIndex: startColumnIndex }, absolute, absolute);
+    const end = cellToAddress({ rowIndex: endRowIndex, columnIndex: endColumnIndex }, absolute, absolute);
+    if (!start || !end)
+        return REF_ERROR_TOKEN;
+    const prefix = tableSheetName.toLowerCase() !== formulaSheetName.toLowerCase()
+        ? `${sanitizeSheetName(tableSheetName)}!`
+        : "";
+    return start === end ? `${prefix}${start}` : `${prefix}${start}:${end}`;
+};
 /**
  * Converts tokens to string
  * @param tokens

package/dist/esm/api/immer-utils.d.ts

@@ -1,12 +1,22 @@
 import type { RowDataWithValue as SpreadsheetRowDataWithValue, SheetData as SpreadsheetSheetData } from "@rowsncolumns/common-types";
 import type { CellNode, CellRangeNode, StaticNode } from "@rowsncolumns/dag";
-import type { CellData, NumberFormat, NumberFormatType, ParsedToken } from "@rowsncolumns/spreadsheet";
+import type { CellData, DimensionProperties, NumberFormat, NumberFormatType, ParsedToken } from "@rowsncolumns/spreadsheet";
 import { type Draft } from "immer";
 import type { CellXfsRegistry } from "../hooks/use-cellxfs-registry";
 import type { useSheetProperties } from "../hooks/use-sheet-properties";
 type SheetData<T extends CellData> = SpreadsheetSheetData<T>;
 type RowDataWithValue<T extends CellData | null | undefined> = SpreadsheetRowDataWithValue<T>;
 export declare const createSheetDraft: <T extends CellData>(draft: Draft<SheetData<T>>, sheetId: number, rowIndex?: number) => Draft<RowDataWithValue<T | null | undefined>>[];
+/**
+ * Row/column metadata an inserted band inherits — Excel's "Format Same As
+ * Above / Left" (FMT-01 / FMT-02) carries the neighbour's height or width and
+ * hidden state along with its cell formats. The neighbour is the entry just
+ * before `referenceIndex`; an insert at index 1 has none and takes the entry
+ * being pushed away instead. The `collapsed` outline marker and filter-hiding
+ * stay with the original row / column. Returns `undefined` when there is
+ * nothing to inherit.
+ */
+export declare const inheritedDimensionMetadata: (metadata: readonly (DimensionProperties | null | undefined)[], referenceIndex: number) => DimensionProperties | undefined;
 export declare const cloneRowWithFormatting: <T extends CellData>(rowData: Draft<RowDataWithValue<T | null | undefined>> | undefined) => Draft<RowDataWithValue<T | null | undefined>>;
 export declare const cloneCellWithFormatting: <T extends CellData>(celLData: Draft<T> | undefined | null) => Draft<T> | null;
 export declare const getFunctionNamesFromFormula: (formula: string) => string[];

package/dist/esm/api/immer-utils.d.ts.map

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

package/dist/esm/api/immer-utils.js

@@ -18,6 +18,22 @@ export const createSheetDraft = (draft, sheetId, rowIndex) => {
     }
     return sheet;
 };
+/**
+ * Row/column metadata an inserted band inherits — Excel's "Format Same As
+ * Above / Left" (FMT-01 / FMT-02) carries the neighbour's height or width and
+ * hidden state along with its cell formats. The neighbour is the entry just
+ * before `referenceIndex`; an insert at index 1 has none and takes the entry
+ * being pushed away instead. The `collapsed` outline marker and filter-hiding
+ * stay with the original row / column. Returns `undefined` when there is
+ * nothing to inherit.
+ */
+export const inheritedDimensionMetadata = (metadata, referenceIndex) => {
+    const source = metadata[referenceIndex > 1 ? referenceIndex - 1 : referenceIndex];
+    if (!source)
+        return undefined;
+    const { collapsed: _collapsed, hiddenByFilter: _hiddenByFilter, ...inherited } = source;
+    return Object.keys(inherited).length ? inherited : undefined;
+};
 // Clone entire row
 export const cloneRowWithFormatting = (rowData) => {
     if (!rowData) {

package/dist/esm/api/insert-cut-cells.d.ts

@@ -0,0 +1,35 @@
+import type { GridRange } from "@rowsncolumns/common-types";
+/** How the destination band opens for an Insert Cut Cells block move. */
+export type InsertCutCellsShift = "down" | "right";
+export type InsertCutCellsPlan = {
+    /**
+     * `"down"` for a vertical move (the block changes rows), `"right"` when it slides along its
+     * own rows — the axis the destination band opens and the vacated source closes along.
+     */
+    shift: InsertCutCellsShift;
+    /**
+     * The source once the destination band has opened: it slides along by the block's size when
+     * it sits in that band (a block dragged UP within its own columns), else it is `from` as is.
+     */
+    shiftedSource: GridRange;
+    /**
+     * The bands the move shifts (each open-ended along `shift`): the destination band from `to`
+     * on, and the source band from the block on. A merge one of them covers only partially would
+     * be torn — Excel refuses the move ("We can't do that to a merged cell.").
+     */
+    bands: GridRange[];
+};
+/**
+ * Excel "Insert Cut Cells" / Shift+drag of a cell block, as the three structural steps the
+ * legacy hooks already own: open the destination band (`insertCells…` at `to`), move the block
+ * into the opening, then close the gap the block left (`deleteCells…` on the vacated source).
+ * The sheet keeps its cell count — Shift+drag A5 to A2 over r1..r6 gives r1 r5 r2 r3 r4 r6, never
+ * a blank — and a forward move within its own lanes lands `size` lines before `to`, Excel's
+ * pre-removal reference (cut A2, drop at row 6 → r1 r3 r4 r5 r2 r6), because the closing shift
+ * pulls the landed block up. `null` when the move is a no-op (the drop is inside the block or
+ * right after it) or cannot land the block whole (destination lanes overlapping the source
+ * lanes only partially — the closing shift would tear the block); the rnc engine's
+ * `move-range { insert }` applies the same rules.
+ */
+export declare const planInsertCutCells: (from: GridRange, to: GridRange) => InsertCutCellsPlan | null;
+//# sourceMappingURL=insert-cut-cells.d.ts.map

package/dist/esm/api/insert-cut-cells.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-cut-cells.d.ts","sourceRoot":"","sources":["../../../api/insert-cut-cells.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,yEAAyE;AACzE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,KAAK,EAAE,mBAAmB,CAAC;IAC3B;;;OAGG;IACH,aAAa,EAAE,SAAS,CAAC;IACzB;;;;OAIG;IACH,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,SAAS,EACf,IAAI,SAAS,KACZ,kBAAkB,GAAG,IAsDvB,CAAC"}

package/dist/esm/api/insert-cut-cells.js

@@ -0,0 +1,67 @@
+import { areaIntersects } from "@rowsncolumns/grid";
+const LAST_INDEX = Number.MAX_SAFE_INTEGER;
+/**
+ * Excel "Insert Cut Cells" / Shift+drag of a cell block, as the three structural steps the
+ * legacy hooks already own: open the destination band (`insertCells…` at `to`), move the block
+ * into the opening, then close the gap the block left (`deleteCells…` on the vacated source).
+ * The sheet keeps its cell count — Shift+drag A5 to A2 over r1..r6 gives r1 r5 r2 r3 r4 r6, never
+ * a blank — and a forward move within its own lanes lands `size` lines before `to`, Excel's
+ * pre-removal reference (cut A2, drop at row 6 → r1 r3 r4 r5 r2 r6), because the closing shift
+ * pulls the landed block up. `null` when the move is a no-op (the drop is inside the block or
+ * right after it) or cannot land the block whole (destination lanes overlapping the source
+ * lanes only partially — the closing shift would tear the block); the rnc engine's
+ * `move-range { insert }` applies the same rules.
+ */
+export const planInsertCutCells = (from, to) => {
+    if (areaIntersects(from, to)) {
+        return null;
+    }
+    const shift = to.startRowIndex === from.startRowIndex ? "right" : "down";
+    const vertical = shift === "down";
+    // (line, lane): the axis the bands shift along, and the perpendicular index.
+    const [l1, l2, k1, k2, t, tk1] = vertical
+        ? [
+            from.startRowIndex,
+            from.endRowIndex,
+            from.startColumnIndex,
+            from.endColumnIndex,
+            to.startRowIndex,
+            to.startColumnIndex,
+        ]
+        : [
+            from.startColumnIndex,
+            from.endColumnIndex,
+            from.startRowIndex,
+            from.endRowIndex,
+            to.startColumnIndex,
+            to.startRowIndex,
+        ];
+    const size = l2 - l1 + 1;
+    const tk2 = tk1 + (k2 - k1);
+    const lanesMeet = tk1 <= k2 && tk2 >= k1;
+    if (lanesMeet && tk1 !== k1) {
+        return null;
+    }
+    if (lanesMeet && t > l1 && t <= l2 + 1) {
+        return null;
+    }
+    // Opening the destination band above the block slides the block along with it.
+    const slides = lanesMeet && t < l1;
+    const shiftedSource = !slides
+        ? from
+        : vertical
+            ? {
+                ...from,
+                startRowIndex: from.startRowIndex + size,
+                endRowIndex: from.endRowIndex + size,
+            }
+            : {
+                ...from,
+                startColumnIndex: from.startColumnIndex + size,
+                endColumnIndex: from.endColumnIndex + size,
+            };
+    const band = (range) => vertical
+        ? { ...range, endRowIndex: LAST_INDEX }
+        : { ...range, endColumnIndex: LAST_INDEX };
+    return { shift, shiftedSource, bands: [band(to), band(from)] };
+};

package/dist/esm/api/merges.d.ts

@@ -1,4 +1,12 @@
 import type { GridRange } from "@rowsncolumns/common-types";
+/** Excel's refusal when a move / cut-paste / shift would tear a merged cell. */
+export declare const MERGED_CELL_MOVE_ERROR = "We can't do that to a merged cell.";
+/**
+ * The first merge that `range` covers only PARTIALLY (it intersects the range without being
+ * wholly inside it). Excel refuses any move, cut + paste or cell shift whose source or destination
+ * does that ("We can't do that to a merged cell."); merges wholly inside the range travel intact.
+ */
+export declare const findPartiallyCoveredMerge: (range: GridRange, merges: GridRange[] | undefined | null) => GridRange | undefined;
 export declare const moveMergedCells: (mergedCells: GridRange[] | undefined | null, op: "column-insert" | "row-insert" | "column-remove" | "row-remove", referenceIndex: number, count?: number, condition?: (area: GridRange) => boolean) => GridRange[] | null | undefined;
 export declare const shrinkMergesOnRowDelete: (merges: GridRange[], deleteStart: number, deleteCount: number) => GridRange[];
 export declare const shrinkMergesOnColumnDelete: (merges: GridRange[], deleteStart: number, deleteCount: number) => GridRange[];

package/dist/esm/api/merges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merges.d.ts","sourceRoot":"","sources":["../../../api/merges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAY5D,eAAO,MAAM,eAAe,GAC1B,aAAa,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,EAC3C,IAAI,eAAe,GAAG,YAAY,GAAG,eAAe,GAAG,YAAY,EACnE,gBAAgB,MAAM,EACtB,cAAS,EACT,YAAY,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,mCA2DzC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,gBA8CpB,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,gBA8CpB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,OAAO,MAAM,gBAyBd,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,OAAO,MAAM,gBAyBd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,EACtC,MAAM,KAAK,GAAG,QAAQ,EACtB,OAAO,MAAM,EACb,OAAO,MAAM,EACb,QAAQ,OAAO,EACf,WAAW,MAAM,EACjB,SAAS,MAAM,mCAkDhB,CAAC"}
+{"version":3,"file":"merges.d.ts","sourceRoot":"","sources":["../../../api/merges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,uCAAuC,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,SAAS,EAChB,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,KACrC,SAAS,GAAG,SAGZ,CAAC;AAYJ,eAAO,MAAM,eAAe,GAC1B,aAAa,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,EAC3C,IAAI,eAAe,GAAG,YAAY,GAAG,eAAe,GAAG,YAAY,EACnE,gBAAgB,MAAM,EACtB,cAAS,EACT,YAAY,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,mCA2DzC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,gBA8CpB,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,gBA8CpB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,OAAO,MAAM,gBAyBd,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,OAAO,MAAM,gBAyBd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,EACtC,MAAM,KAAK,GAAG,QAAQ,EACtB,OAAO,MAAM,EACb,OAAO,MAAM,EACb,QAAQ,OAAO,EACf,WAAW,MAAM,EACjB,SAAS,MAAM,mCAkDhB,CAAC"}

package/dist/esm/api/merges.js

@@ -1,3 +1,12 @@
+import { areaInsideArea, areaIntersects } from "@rowsncolumns/grid";
+/** Excel's refusal when a move / cut-paste / shift would tear a merged cell. */
+export const MERGED_CELL_MOVE_ERROR = "We can't do that to a merged cell.";
+/**
+ * The first merge that `range` covers only PARTIALLY (it intersects the range without being
+ * wholly inside it). Excel refuses any move, cut + paste or cell shift whose source or destination
+ * does that ("We can't do that to a merged cell."); merges wholly inside the range travel intact.
+ */
+export const findPartiallyCoveredMerge = (range, merges) => merges?.find((merge) => areaIntersects(merge, range) && !areaInsideArea(merge, range));
 /**
  * Move merged cells when user is inserts, deletes row and columns
  * @param mergedCells

package/dist/esm/api/paint-format.d.ts

@@ -1,4 +1,9 @@
 import type { CellFormat, CellInterface, GridRange } from "@rowsncolumns/common-types";
+import type { CellData } from "@rowsncolumns/spreadsheet";
+import type { Draft } from "immer";
+import type { CellXfsRegistry } from "../hooks/use-cellxfs-registry";
+import type { SheetData } from "../hooks/use-spreadsheet-state";
+import type { SharedStringRegistry } from "../hooks/use-ss-registry";
 /**
  * Format-painter pattern shared by both engines: the captured 2-D format grid plus the
  * source block's merge configuration, re-based to the block's top-left so it can be tiled
@@ -49,7 +54,23 @@ export declare const getBandedCellFormat: (bandedCells: Map<string, CellFormat>
  * Layer a cell's explicit format over the banded format the grid would paint beneath it, so the
  * captured pattern carries the VISIBLE look (Sheets copies the alternating colours as static cell
  * fills — it does not create a table or banding at the target). Explicit keys win; an explicit
- * `undefined` never clobbers a banded value.
+ * `undefined` never clobbers a banded value. `textFormat` merges key-wise: an explicitly bold
+ * header keeps the contrast text colour the band paints it with.
  */
 export declare const layerBandedFormat: (explicit: CellFormat | null | undefined, banded: CellFormat | undefined) => CellFormat | null | undefined;
+/**
+ * Write the banded (table stripe) formats the grid paints under `range` into the cells as
+ * static formats — Excel's Convert to Range bakes the table style into the cell formats — each
+ * cell's explicit format layered on top exactly as the format painter captures it. Runs inside
+ * the caller's sheet-data draft; cells without a band are untouched.
+ */
+export declare const bakeBandedFormats: <T extends CellData>({ draft, sheetId, range, bandedCells, locale, cellXfsRegistry, sharedStringRegistry, }: {
+    draft: Draft<SheetData<T>>;
+    sheetId: number;
+    range: GridRange;
+    bandedCells: Map<string, CellFormat> | undefined | null;
+    locale?: string;
+    cellXfsRegistry?: CellXfsRegistry;
+    sharedStringRegistry?: SharedStringRegistry;
+}) => void;
 //# sourceMappingURL=paint-format.d.ts.map

package/dist/esm/api/paint-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paint-format.d.ts","sourceRoot":"","sources":["../../../api/paint-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,SAAS,EACV,MAAM,4BAA4B,CAAC;AAGpC;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC;IAC7C,kFAAkF;IAClF,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAQF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,EACtC,QAAQ,SAAS,KAChB,SAAS,EAaX,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,EACtC,YAAY,aAAa,KACxB,SAkBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,EAC5C,gBAAgB,SAAS,EAAE,KAC1B,IAYF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,gBAAgB,SAAS,EAAE,EAC3B,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,QAAQ,SAAS,KAChB,SAAS,EAqBX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,aAAa,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,IAAI,EACvD,UAAU,MAAM,EAChB,aAAa,MAAM,KAClB,UAAU,GAAG,SACyC,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,UAAU,GAAG,IAAI,GAAG,SAAS,EACvC,QAAQ,UAAU,GAAG,SAAS,KAC7B,UAAU,GAAG,IAAI,GAAG,SAWtB,CAAC"}
+{"version":3,"file":"paint-format.d.ts","sourceRoot":"","sources":["../../../api/paint-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,SAAS,EACV,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIrE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC;IAC7C,kFAAkF;IAClF,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAQF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,EACtC,QAAQ,SAAS,KAChB,SAAS,EAaX,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,EACtC,YAAY,aAAa,KACxB,SAkBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,EAC5C,gBAAgB,SAAS,EAAE,KAC1B,IAYF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,gBAAgB,SAAS,EAAE,EAC3B,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,QAAQ,SAAS,KAChB,SAAS,EAqBX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,aAAa,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,IAAI,EACvD,UAAU,MAAM,EAChB,aAAa,MAAM,KAClB,UAAU,GAAG,SACyC,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,UAAU,GAAG,IAAI,GAAG,SAAS,EACvC,QAAQ,UAAU,GAAG,SAAS,KAC7B,UAAU,GAAG,IAAI,GAAG,SActB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,QAAQ,EAAE,wFAQnD;IACD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C,SA6CA,CAAC"}

package/dist/esm/api/paint-format.js

@@ -1,4 +1,6 @@
 import { cellIdentifier, isCellWithinBounds } from "@rowsncolumns/grid";
+import { SheetCell } from "../sheet-cell";
+import { createSheetDraft } from "./immer-utils";
 const rangeContains = (outer, inner) => inner.startRowIndex >= outer.startRowIndex &&
     inner.endRowIndex <= outer.endRowIndex &&
     inner.startColumnIndex >= outer.startColumnIndex &&
@@ -105,7 +107,8 @@ export const getBandedCellFormat = (bandedCells, rowIndex, columnIndex) => bande
  * Layer a cell's explicit format over the banded format the grid would paint beneath it, so the
  * captured pattern carries the VISIBLE look (Sheets copies the alternating colours as static cell
  * fills — it does not create a table or banding at the target). Explicit keys win; an explicit
- * `undefined` never clobbers a banded value.
+ * `undefined` never clobbers a banded value. `textFormat` merges key-wise: an explicitly bold
+ * header keeps the contrast text colour the band paints it with.
  */
 export const layerBandedFormat = (explicit, banded) => {
     if (!banded)
@@ -117,6 +120,46 @@ export const layerBandedFormat = (explicit, banded) => {
                 merged[key] = value;
             }
         }
+        if (explicit.textFormat && banded.textFormat) {
+            merged.textFormat = { ...banded.textFormat, ...explicit.textFormat };
+        }
     }
     return merged;
 };
+/**
+ * Write the banded (table stripe) formats the grid paints under `range` into the cells as
+ * static formats — Excel's Convert to Range bakes the table style into the cell formats — each
+ * cell's explicit format layered on top exactly as the format painter captures it. Runs inside
+ * the caller's sheet-data draft; cells without a band are untouched.
+ */
+export const bakeBandedFormats = ({ draft, sheetId, range, bandedCells, locale, cellXfsRegistry, sharedStringRegistry, }) => {
+    if (!bandedCells?.size)
+        return;
+    const sheetCell = new SheetCell();
+    for (let rowIndex = range.startRowIndex; rowIndex <= range.endRowIndex; rowIndex++) {
+        for (let columnIndex = range.startColumnIndex; columnIndex <= range.endColumnIndex; columnIndex++) {
+            const banded = getBandedCellFormat(bandedCells, rowIndex, columnIndex);
+            if (!banded)
+                continue;
+            const currentSheet = createSheetDraft(draft, sheetId, rowIndex);
+            sheetCell.assign(sheetId, { rowIndex, columnIndex }, currentSheet[rowIndex]?.values?.[columnIndex], { locale, cellXfsRegistry, sharedStringRegistry });
+            const baked = layerBandedFormat(sheetCell.userEnteredFormat, banded);
+            sheetCell.clearUserEnteredFormat();
+            for (const [key, value] of Object.entries(baked ?? {})) {
+                // A band carries `undefined` for the parts it does not paint (no border, no text
+                // colour) — those must not land as empty `{}` formats on the cell.
+                if (value === undefined)
+                    continue;
+                if (typeof value === "object" &&
+                    value !== null &&
+                    Object.values(value).every((part) => part === undefined)) {
+                    continue;
+                }
+                sheetCell.setUserEnteredFormat(key, value);
+            }
+            currentSheet[rowIndex].values[columnIndex] =
+                sheetCell.getCellData();
+            cellXfsRegistry?.registerCellXfs(sheetCell);
+        }
+    }
+};

package/dist/esm/api/sort.d.ts

@@ -1,3 +1,25 @@
 import type { SortOrder } from "@rowsncolumns/spreadsheet";
-export declare const cellValueSorter: (left: string | number | boolean | undefined | null, right: string | number | boolean | undefined | null, sortOrder: SortOrder) => number;
+/**
+ * A cell whose effective value is an error (`#DIV/0!`, `#N/A`, …). Errors
+ * form the last value tier and keep their relative order, as in Excel.
+ */
+export type SortErrorValue = {
+    readonly sortError: string;
+};
+export type SortCellValue = string | number | boolean | SortErrorValue | undefined | null;
+export declare const isSortErrorValue: (value: unknown) => value is SortErrorValue;
+/**
+ * The value a sort compares for a cell: its error when it has one, else the
+ * effective value, else the display text.
+ */
+export declare const getCellSortValue: (cell: {
+    readonly error: unknown;
+    getEffectiveValue(): string | number | boolean | undefined;
+    readonly formattedValue: string | undefined | null;
+}) => SortCellValue;
+/**
+ * Excel's sort order: numbers < text < logicals < errors, blanks last in
+ * BOTH directions, text compared case-insensitively through the collator.
+ */
+export declare const cellValueSorter: (left: SortCellValue, right: SortCellValue, sortOrder: SortOrder) => number;
 //# sourceMappingURL=sort.d.ts.map

package/dist/esm/api/sort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../../api/sort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAQ3D,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,EAClD,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,EACnD,WAAW,SAAS,WAiCrB,CAAC"}
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../../api/sort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAa3D;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,MAAM,GACN,OAAO,GACP,cAAc,GACd,SAAS,GACT,IAAI,CAAC;AAET,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cACU,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,iBAAiB,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;CACpD,KAAG,aAGmD,CAAC;AAYxD;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,aAAa,EACnB,OAAO,aAAa,EACpB,WAAW,SAAS,WA8CrB,CAAC"}