@rowsncolumns/spreadsheet-state 29.0.0 → 29.1.1

package/dist/esm/api/copy-paste.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copy-paste.d.ts","sourceRoot":"","sources":["../../../api/copy-paste.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,SAAS,EACV,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,SAAS,EAEV,MAAM,2BAA2B,CAAC;AAanC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAW1E,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,UAAU,GACV,YAAY,GACZ,kBAAkB,GAClB,YAAY,GACZ,WAAW,GACX,WAAW,GACX,YAAY,GACZ,aAAa,GACb,WAAW,GACX,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,cAAc,CAAC;AAEnB,eAAO,MAAM,qBAAqB,UAWjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAU,CAAC,SAAS,QAAQ,EAChE,GAAG,cAAc,GAAG,SAAS,EAC7B,YAAY,aAAa,EACzB,SAAS,MAAM,EACf,iBAAiB,MAAM,EACvB,qBAAqB,OAAO,EAC5B,SAAS,MAAM,EACf,qBAAqB,mBAAmB,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,EACjE,iBAAiB,OAAO,EACxB,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACvC,iBAAiB,cAAc,EAC/B,UAAU;IACR;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,KACA,OAAO,CACN;IACE,OAAO,CAAC,EAAE,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GACD,SAAS,CAyQZ,CAAC;AAEF,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,SAazC;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAC/C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,yCAwB9C;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAC1C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,EAC7C,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,yCAkChB;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,EAC7C,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,yCAwBhB;AAED,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,KACnD,MAAM,EAmBR,CAAC"}
+{"version":3,"file":"copy-paste.d.ts","sourceRoot":"","sources":["../../../api/copy-paste.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,SAAS,EACV,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,SAAS,EAEV,MAAM,2BAA2B,CAAC;AAcnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAW1E,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,UAAU,GACV,YAAY,GACZ,kBAAkB,GAClB,YAAY,GACZ,WAAW,GACX,WAAW,GACX,YAAY,GACZ,aAAa,GACb,WAAW,GACX,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,cAAc,CAAC;AAEnB,eAAO,MAAM,qBAAqB,UAWjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAU,CAAC,SAAS,QAAQ,EAChE,GAAG,cAAc,GAAG,SAAS,EAC7B,YAAY,aAAa,EACzB,SAAS,MAAM,EACf,iBAAiB,MAAM,EACvB,qBAAqB,OAAO,EAC5B,SAAS,MAAM,EACf,qBAAqB,mBAAmB,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,EACjE,iBAAiB,OAAO,EACxB,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACvC,UAAU;IACR;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,KACA,OAAO,CACN;IACE,OAAO,CAAC,EAAE,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GACD,SAAS,CAqQZ,CAAC;AAEF,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,SAazC;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAC/C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,yCAwB9C;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAC1C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,EAC7C,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,yCAkChB;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,EAC7C,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,yCAwBhB;AAED,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,KACnD,MAAM,EAmBR,CAAC"}

package/dist/esm/api/copy-paste.js

@@ -1,7 +1,6 @@
 import { createCellDataArrayFromCSVString, readImageFileAsDataUri, } from "@rowsncolumns/toolkit";
 import { getCellEffectiveFormat, isAFormula, isNil, log, } from "@rowsncolumns/utils";
 import { uuid } from "@rowsncolumns/utils";
-import { getGeneratedTableCopyName } from "../generated-names";
 import { defaultCellCoords, defaultSheetId, isStyleReference, SheetCell, } from "../sheet-cell";
 import { isRichSharedString } from "../types";
 import { isBoolean, isValidURLorEmail } from "./datatype";
@@ -18,7 +17,7 @@ export const SUPPORTED_IMAGE_TYPES = [
     "image/webp",
     "image/x-icon",
 ];
-export const generateDataFromClipboard = async (e, activeCell, sheetId, activeSheetName, preserveFormatting, locale, idCreationStrategy, forcePlainText, sanitizeHtml, generatedNames, options) => {
+export const generateDataFromClipboard = async (e, activeCell, sheetId, activeSheetName, preserveFormatting, locale, idCreationStrategy, forcePlainText, sanitizeHtml, options) => {
     const items = e?.clipboardData?.items;
     const files = e?.clipboardData?.files;
     const formatOrder = [
@@ -84,7 +83,6 @@ export const generateDataFromClipboard = async (e, activeCell, sheetId, activeSh
                         const rowSpan = table.range.endRowIndex - table.range.startRowIndex;
                         const colSpan = table.range.endColumnIndex - table.range.startColumnIndex;
                         table.id = idCreationStrategy?.("table") ?? uuid();
-                        table.title = getGeneratedTableCopyName(table.title, generatedNames);
                         // Update sheet id
                         table.sheetId = sheetId;
                         table.range.startRowIndex = activeCell.rowIndex + rowDelta;

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

@@ -1,10 +1,24 @@
-import type { ColorFilterCriteria, ConditionType, ConditionValue, FilterSpec, IconFilterCriteria } from "@rowsncolumns/spreadsheet";
+import type { BooleanCondition, ColorFilterCriteria, ConditionType, ConditionValue, FilterConditionJoin, FilterCriteria, FilterSpec, IconFilterCriteria } from "@rowsncolumns/spreadsheet";
 export type CreateFilterSpecsExtras = {
     /** Pass `null` to clear an existing color filter on this column. */
     colorFilter?: ColorFilterCriteria | null;
     /** Pass `null` to clear an existing icon filter on this column. */
     iconFilter?: IconFilterCriteria | null;
+    /**
+     * Custom AutoFilter second clause + join (Excel's And / Or). Pass `null`
+     * to drop an existing second clause; omit to preserve it.
+     */
+    condition2?: BooleanCondition | null;
+    conditionJoin?: FilterConditionJoin | null;
 };
+/**
+ * Whether a column's criteria still filter anything. An entry with no
+ * condition, no value whitelist and no color / icon criterion is inert, so
+ * `createFilterSpecs` drops it — Excel's "Clear Filter From <column>" —
+ * instead of leaving a stale spec behind (the rnc engine's
+ * `upsert_filter_spec` removes such entries the same way).
+ */
+export declare const isFilterCriteriaActive: (criteria: FilterCriteria) => boolean;
 /**
  * Create a new filterspec
  * @param filterSpecs

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

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../api/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,UAAU,EACV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,uBAAuB,GAAG;IACpC,oEAAoE;IACpE,WAAW,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACzC,mEAAmE;IACnE,UAAU,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACxC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,aAAa,UAAU,EAAE,GAAG,SAAS,EACrC,aAAa,MAAM,EACnB,eAAe,aAAa,GAAG,SAAS,EACxC,iBAAiB,cAAc,EAAE,GAAG,SAAS,EAC7C,eAAe,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,EAC1C,SAAQ,uBAA4B,KACnC,UAAU,EAuCZ,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GACzC,cAAa,UAAU,EAAO,+BAO/B,CAAC"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../api/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,uBAAuB,GAAG;IACpC,oEAAoE;IACpE,WAAW,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACzC,mEAAmE;IACnE,UAAU,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,aAAa,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,UAAU,cAAc,KAAG,OAO/D,CAAC;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,aAAa,UAAU,EAAE,GAAG,SAAS,EACrC,aAAa,MAAM,EACnB,eAAe,aAAa,GAAG,SAAS,EACxC,iBAAiB,cAAc,EAAE,GAAG,SAAS,EAC7C,eAAe,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,EAC1C,SAAQ,uBAA4B,KACnC,UAAU,EAuDZ,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GACzC,cAAa,UAAU,EAAO,+BAO/B,CAAC"}

package/dist/esm/api/filter.js

@@ -1,3 +1,15 @@
+/**
+ * Whether a column's criteria still filter anything. An entry with no
+ * condition, no value whitelist and no color / icon criterion is inert, so
+ * `createFilterSpecs` drops it — Excel's "Clear Filter From <column>" —
+ * instead of leaving a stale spec behind (the rnc engine's
+ * `upsert_filter_spec` removes such entries the same way).
+ */
+export const isFilterCriteriaActive = (criteria) => Boolean(criteria.condition?.type ||
+    criteria.condition2?.type ||
+    criteria.visibleValues?.length ||
+    criteria.colorFilter ||
+    criteria.iconFilter);
 /**
  * Create a new filterspec
  * @param filterSpecs
@@ -31,8 +43,24 @@ export const createFilterSpecs = (filterSpecs, columnIndex, conditionType, condi
                 : exists?.filterCriteria.iconFilter
                     ? { iconFilter: exists.filterCriteria.iconFilter }
                     : {}),
+            ...(extras.condition2 !== undefined
+                ? extras.condition2
+                    ? {
+                        condition2: extras.condition2,
+                        conditionJoin: extras.conditionJoin ?? "AND",
+                    }
+                    : {}
+                : exists?.filterCriteria.condition2
+                    ? {
+                        condition2: exists.filterCriteria.condition2,
+                        conditionJoin: exists.filterCriteria.conditionJoin ?? "AND",
+                    }
+                    : {}),
         },
     };
+    if (!isFilterCriteriaActive(filterSpec.filterCriteria)) {
+        return (filterSpecs ?? []).filter((spec) => spec.columnIndex !== columnIndex);
+    }
     if (exists && filterSpecs) {
         return filterSpecs.map((spec) => {
             if (spec.columnIndex === columnIndex) {

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

@@ -1,3 +1,4 @@
+import type { GridRange } from "@rowsncolumns/common-types";
 import type { ParsedToken } from "@rowsncolumns/spreadsheet";
 export { ERROR_CIRCULAR_DEPENDENCY, ERROR_REFERENCE, formulaToRelativeReference, } from "@rowsncolumns/calculator";
 export type { FormulaToRelativeReferenceOptions } from "@rowsncolumns/calculator";
@@ -39,6 +40,68 @@ export declare const breakTableReferencesInFormula: (formulaValue: string, table
  * `=Table1[@#REF!]*2`). Keeps every other character of the reference as typed.
  */
 export declare const breakTableColumnsInFormula: (formulaValue: string, tableName: string | undefined, columnNames: string[]) => string;
+/**
+ * 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 declare const renameTableColumnInFormula: (formulaValue: string, tableName: string | undefined, oldName: string, newName: string) => string;
+/**
+ * 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 declare const renameTableColumnsInFormula: (formulaValue: string, tableName: string | undefined, renames: ReadonlyMap<string, string>) => string;
+/**
+ * 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 declare const renameTableInFormula: (formulaValue: string, oldName: string, newName: string) => string;
+/**
+ * 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 declare const renameTablesInFormula: (formulaValue: string, renames: ReadonlyMap<string, string>) => string;
+/** The table geometry a structured reference resolves against — the `TableView` fields that matter. */
+export type StructuredRefTable = {
+    title: string;
+    range: GridRange;
+    headerRow?: boolean | null;
+    totalRow?: boolean | null;
+    /** Column names in header order. */
+    columnNames: string[];
+};
+export type ConvertStructuredRefsOptions = {
+    /** Name of the sheet the table lives on. */
+    tableSheetName: string;
+    /** Name of the sheet the formula cell lives on — the reference is sheet-qualified when it differs. */
+    formulaSheetName: string;
+    /** Row of the formula cell: what a this-row item (`[@Col]`) resolves to. */
+    formulaRowIndex: number;
+    /** Whether the formula cell sits inside the table, which the bare `[@Col]` / `[Col]` forms name. */
+    inTable: boolean;
+};
+/**
+ * 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 declare const convertStructuredRefsToA1InFormula: (formulaValue: string, table: StructuredRefTable, options: ConvertStructuredRefsOptions) => string;
 /**
  * Converts tokens to string
  * @param tokens

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

@@ -1 +1 @@
-{"version":3,"file":"formula.d.ts","sourceRoot":"","sources":["../../../api/formula.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,2BAA2B,CAAC;AAUpE,OAAO,EACL,yBAAyB,EACzB,eAAe,EACf,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAC;AAElF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,cAAc,MAAM,EACpB,SAAS,MAAM,EACf,SAAS,MAAM,WA4BhB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,MAAM,EACpB,SAAS,MAAM,EACf,SAAS,MAAM,WAehB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,cAAc,MAAM,EACpB,SAAS,MAAM,EACf,SAAS,MAAM,WAYhB,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAgDxC;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,GACxC,cAAc,MAAM,EACpB,WAAW,MAAM,KAChB,MA4BF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACrC,cAAc,MAAM,EACpB,WAAW,MAAM,GAAG,SAAS,EAC7B,aAAa,MAAM,EAAE,KACpB,MA+BF,CAAC;AAaF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,WAAW,EAAE,WAU/C,CAAC;AAiBF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,EACf,UAAU,MAAM,EAChB,aAAa,MAAM,WAGpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,MAAM,GAAG,SAAS,YAGpE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,GAAG,SAAS,YAGjE,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;;;OAKG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,6BAA6B,GAAG,6BAA6B,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAmBrE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,MAAM,GAAG,SAAS,EAC3B,gBAAgB,MAAM,EACtB,OAAO,MAAM,EACb,WAAW,KAAK,GAAG,QAAQ,EAC3B,iBAAiB,MAAM,EACvB,UAAS,6BAAkC,KAC1C,MAAM,GAAG,SAyKX,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,GAAG,SAAS,EAC3B,eAAe,MAAM,EACrB,OAAO,MAAM,EACb,WAAW,KAAK,GAAG,QAAQ,EAC3B,iBAAiB,MAAM,EACvB,UAAS,6BAAkC,KAC1C,MAAM,GAAG,SAkPX,CAAC"}
+{"version":3,"file":"formula.d.ts","sourceRoot":"","sources":["../../../api/formula.ts"],"names":[],"mappings":"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"}

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/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"}