@rowsncolumns/spreadsheet-state 28.0.76 → 29.1.0

package/dist/cjs/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/cjs/api/filter.js

@@ -1,4 +1,19 @@
 import { __assign, __read, __spreadArray, __values } from "tslib";
+/**
+ * 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 var isFilterCriteriaActive = function (criteria) {
+    var _a, _b, _c;
+    return Boolean(((_a = criteria.condition) === null || _a === void 0 ? void 0 : _a.type) ||
+        ((_b = criteria.condition2) === null || _b === void 0 ? void 0 : _b.type) ||
+        ((_c = criteria.visibleValues) === null || _c === void 0 ? void 0 : _c.length) ||
+        criteria.colorFilter ||
+        criteria.iconFilter);
+};
 /**
  * Create a new filterspec
  * @param filterSpecs
@@ -9,13 +24,13 @@ import { __assign, __read, __spreadArray, __values } from "tslib";
  * @param extras Optional colorFilter / iconFilter criteria.
  */
 export var createFilterSpecs = function (filterSpecs, columnIndex, conditionType, conditionValues, visibleValues, extras) {
-    var _a, _b;
+    var _a, _b, _c, _d;
     if (extras === void 0) { extras = {}; }
     var exists = filterSpecs === null || filterSpecs === void 0 ? void 0 : filterSpecs.find(function (spec) { return spec.columnIndex === columnIndex; });
     // Spec
     var filterSpec = {
         columnIndex: columnIndex,
-        filterCriteria: __assign(__assign({ condition: {
+        filterCriteria: __assign(__assign(__assign({ condition: {
                 type: conditionType,
                 values: conditionValues,
             }, visibleValues: visibleValues }, (extras.colorFilter !== undefined
@@ -26,8 +41,23 @@ export var createFilterSpecs = function (filterSpecs, columnIndex, conditionType
             ? { iconFilter: (_b = extras.iconFilter) !== null && _b !== void 0 ? _b : undefined }
             : (exists === null || exists === void 0 ? void 0 : exists.filterCriteria.iconFilter)
                 ? { iconFilter: exists.filterCriteria.iconFilter }
+                : {})), (extras.condition2 !== undefined
+            ? extras.condition2
+                ? {
+                    condition2: extras.condition2,
+                    conditionJoin: (_c = extras.conditionJoin) !== null && _c !== void 0 ? _c : "AND",
+                }
+                : {}
+            : (exists === null || exists === void 0 ? void 0 : exists.filterCriteria.condition2)
+                ? {
+                    condition2: exists.filterCriteria.condition2,
+                    conditionJoin: (_d = exists.filterCriteria.conditionJoin) !== null && _d !== void 0 ? _d : "AND",
+                }
                 : {})),
     };
+    if (!isFilterCriteriaActive(filterSpec.filterCriteria)) {
+        return (filterSpecs !== null && filterSpecs !== void 0 ? filterSpecs : []).filter(function (spec) { return spec.columnIndex !== columnIndex; });
+    }
     if (exists && filterSpecs) {
         return filterSpecs.map(function (spec) {
             if (spec.columnIndex === columnIndex) {

package/dist/cjs/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/cjs/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":"AAUA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC3E,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,MAMA,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GACrC,cAAc,MAAM,EACpB,WAAW,MAAM,GAAG,SAAS,EAC7B,SAAS,MAAM,EACf,SAAS,MAAM,KACd,MAOe,CAAC;AAEnB;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACtC,cAAc,MAAM,EACpB,WAAW,MAAM,GAAG,SAAS,EAC7B,SAAS,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KACnC,MAGA,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,MAAM,EACpB,SAAS,MAAM,EACf,SAAS,MAAM,KACd,MAQF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,cAAc,MAAM,EACpB,SAAS,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KACnC,MAiBF,CAAC;AA6EF,uGAAuG;AACvG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,oCAAoC;IACpC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,sGAAsG;IACtG,gBAAgB,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,eAAe,EAAE,MAAM,CAAC;IACxB,oGAAoG;IACpG,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kCAAkC,GAC7C,cAAc,MAAM,EACpB,OAAO,kBAAkB,EACzB,SAAS,4BAA4B,KACpC,MAkDF,CAAC;AA2HF;;;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"}

package/dist/cjs/api/formula.js

@@ -1,5 +1,5 @@
-import { __assign, __read, __values } from "tslib";
-import { cleanupColumnName, cleanupTableName, isRangeToken, lexify, stripPropertyFromCellRef, tokenVocabulary, } from "@rowsncolumns/calculator";
+import { __assign, __read, __spreadArray, __values } from "tslib";
+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";
 /**
@@ -193,10 +193,99 @@ export var breakTableReferencesInFormula = function (formulaValue, tableName) {
  * `=Table1[@#REF!]*2`). Keeps every other character of the reference as typed.
  */
 export var breakTableColumnsInFormula = function (formulaValue, tableName, columnNames) {
-    if (!formulaValue.includes("[") || columnNames.length === 0) {
+    return 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 var renameTableColumnInFormula = function (formulaValue, tableName, oldName, newName) {
+    return 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 var renameTableColumnsInFormula = function (formulaValue, tableName, renames) {
+    return rewriteTableColumnsInFormula(formulaValue, tableName, function (name) {
+        return 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 var renameTableInFormula = function (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 var renameTablesInFormula = function (formulaValue, renames) {
+    var e_5, _a;
+    if (!formulaValue.includes("[") || renames.size === 0) {
+        return formulaValue;
+    }
+    var tokens = cloneTokens(lexify(formulaValue).tokens);
+    var hasChanges = false;
+    try {
+        for (var tokens_4 = __values(tokens), tokens_4_1 = tokens_4.next(); !tokens_4_1.done; tokens_4_1 = tokens_4.next()) {
+            var token = tokens_4_1.value;
+            if (!isTableNameToken(token))
+                continue;
+            var 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;
+        }
+    }
+    catch (e_5_1) { e_5 = { error: e_5_1 }; }
+    finally {
+        try {
+            if (tokens_4_1 && !tokens_4_1.done && (_a = tokens_4.return)) _a.call(tokens_4);
+        }
+        finally { if (e_5) throw e_5.error; }
+    }
+    return hasChanges ? detokenize(tokens) : formulaValue;
+};
+var replaceTableColumnsInFormula = function (formulaValue, tableName, columnNames, replacement) {
+    if (columnNames.length === 0) {
         return formulaValue;
     }
     var targets = new Set(columnNames.map(function (name) { return name.toLowerCase(); }));
+    return rewriteTableColumnsInFormula(formulaValue, tableName, function (name) {
+        return 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.
+ */
+var rewriteTableColumnsInFormula = function (formulaValue, tableName, resolve) {
+    if (!formulaValue.includes("[")) {
+        return formulaValue;
+    }
     var target = tableName === null || tableName === void 0 ? void 0 : tableName.toLowerCase();
     var tokens = cloneTokens(lexify(formulaValue).tokens);
     var hasChanges = false;
@@ -209,8 +298,9 @@ export var breakTableColumnsInFormula = function (formulaValue, tableName, colum
                 cleanupTableName(token.image).trim().toLowerCase() === target;
             if (matches) {
                 for (var j = i + 1; j < end; j++) {
-                    if (breakColumnToken(tokens[j], targets))
+                    if (replaceColumnToken(tokens[j], resolve)) {
                         hasChanges = true;
+                    }
                 }
             }
             i = end;
@@ -218,26 +308,206 @@ export var breakTableColumnsInFormula = function (formulaValue, tableName, colum
         }
         // 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;
 };
-var breakColumnToken = function (token, targets) {
+var replaceColumnToken = function (token, resolve) {
     if (!token || !isTableColumnToken(token))
         return false;
     var name = cleanupColumnName(token.image);
-    if (!name || !targets.has(name.toLowerCase()))
+    if (!name)
+        return false;
+    var replacement = resolve(name.toLowerCase());
+    if (replacement === undefined)
         return false;
     var 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 var convertStructuredRefsToA1InFormula = function (formulaValue, table, options) {
+    if (!formulaValue.includes("["))
+        return formulaValue;
+    var target = table.title.toLowerCase();
+    var tokens = cloneTokens(lexify(formulaValue).tokens);
+    var newTokens = [];
+    var hasChanges = false;
+    var i = 0;
+    while (i < tokens.length) {
+        var token = tokens[i];
+        if (isTableNameToken(token)) {
+            var 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.apply(newTokens, __spreadArray([], __read(tokens.slice(i, end)), false));
+                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("[")) {
+            var 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`). */
+var collapseToReference = function (start, end, image) {
+    var _a, _b;
+    return (__assign(__assign({}, start), { image: image, tokenType: image === REF_ERROR_TOKEN
+            ? tokenVocabulary.RefError
+            : tokenVocabulary.Cell, endOffset: (_a = end === null || end === void 0 ? void 0 : end.endOffset) !== null && _a !== void 0 ? _a : start.endOffset, endColumn: (_b = end === null || end === void 0 ? void 0 : end.endColumn) !== null && _b !== void 0 ? _b : 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!`.
+ */
+var resolveStructuredReference = function (table, specifier, _a) {
+    var e_6, _b, _c, e_7, _d;
+    var _e, _f;
+    var tableSheetName = _a.tableSheetName, formulaSheetName = _a.formulaSheetName, formulaRowIndex = _a.formulaRowIndex;
+    var thisRow = false;
+    var items = new Set();
+    var columns = [];
+    try {
+        for (var specifier_1 = __values(specifier), specifier_1_1 = specifier_1.next(); !specifier_1_1.done; specifier_1_1 = specifier_1.next()) {
+            var token = specifier_1_1.value;
+            var name_1 = token.tokenType.name;
+            if (name_1 === tokenVocabulary.SpecialItem.name) {
+                var item = cleanupSpecialItem(token.image).trim().toLowerCase();
+                if (item === "#this row")
+                    thisRow = true;
+                else
+                    items.add(item);
+            }
+            else if (name_1 === tokenVocabulary.TableColumnName.name) {
+                if (detectCurrentRow(token.image))
+                    thisRow = true;
+                var column = cleanupColumnName(token.image).trim();
+                if (column)
+                    columns.push(column);
+            }
+            else if (name_1 === tokenVocabulary.At.name) {
+                thisRow = true;
+            }
+        }
+    }
+    catch (e_6_1) { e_6 = { error: e_6_1 }; }
+    finally {
+        try {
+            if (specifier_1_1 && !specifier_1_1.done && (_b = specifier_1.return)) _b.call(specifier_1);
+        }
+        finally { if (e_6) throw e_6.error; }
+    }
+    var range = table.range;
+    var headerRow = (_e = table.headerRow) !== null && _e !== void 0 ? _e : true;
+    var totalRow = (_f = table.totalRow) !== null && _f !== void 0 ? _f : false;
+    var dataStartRowIndex = range.startRowIndex + (headerRow ? 1 : 0);
+    var dataEndRowIndex = range.endRowIndex - (totalRow ? 1 : 0);
+    // Column span: the named column, or the `[A]:[B]` pair (either order); none → every column.
+    var startColumnIndex = range.startColumnIndex;
+    var endColumnIndex = range.endColumnIndex;
+    if (columns.length) {
+        if (columns.length > 2)
+            return REF_ERROR_TOKEN;
+        var offsets = columns.map(function (column) {
+            return table.columnNames.findIndex(function (candidate) { return candidate.toLowerCase() === column.toLowerCase(); });
+        });
+        if (offsets.some(function (offset) { return offset === -1; }))
+            return REF_ERROR_TOKEN;
+        startColumnIndex = range.startColumnIndex + Math.min.apply(Math, __spreadArray([], __read(offsets), false));
+        endColumnIndex = range.startColumnIndex + Math.max.apply(Math, __spreadArray([], __read(offsets), false));
+    }
+    // Row band.
+    var startRowIndex;
+    var 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 {
+        var 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(function (a, b) { return a[0] - b[0]; });
+        _c = __read(bands[0], 2), startRowIndex = _c[0], endRowIndex = _c[1];
+        try {
+            for (var _g = __values(bands.slice(1)), _h = _g.next(); !_h.done; _h = _g.next()) {
+                var _j = __read(_h.value, 2), bandStart = _j[0], bandEnd = _j[1];
+                // `[#Headers],[#Totals]` skips the data rows: not one rectangle.
+                if (bandStart > endRowIndex + 1)
+                    return REF_ERROR_TOKEN;
+                endRowIndex = Math.max(endRowIndex, bandEnd);
+            }
+        }
+        catch (e_7_1) { e_7 = { error: e_7_1 }; }
+        finally {
+            try {
+                if (_h && !_h.done && (_d = _g.return)) _d.call(_g);
+            }
+            finally { if (e_7) throw e_7.error; }
+        }
+    }
+    var absolute = !thisRow;
+    var start = cellToAddress({ rowIndex: startRowIndex, columnIndex: startColumnIndex }, absolute, absolute);
+    var end = cellToAddress({ rowIndex: endRowIndex, columnIndex: endColumnIndex }, absolute, absolute);
+    if (!start || !end)
+        return REF_ERROR_TOKEN;
+    var prefix = tableSheetName.toLowerCase() !== formulaSheetName.toLowerCase()
+        ? "".concat(sanitizeSheetName(tableSheetName), "!")
+        : "";
+    return start === end ? "".concat(prefix).concat(start) : "".concat(prefix).concat(start, ":").concat(end);
+};
 /**
  * Converts tokens to string
  * @param tokens

package/dist/cjs/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/cjs/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/cjs/api/immer-utils.js

@@ -1,4 +1,4 @@
-import { __assign, __generator, __read, __values } from "tslib";
+import { __assign, __generator, __read, __rest, __values } from "tslib";
 import { isStaticNode } from "@rowsncolumns/dag";
 import { isCellCoordinate } from "@rowsncolumns/dag";
 import { tokenVocabulary } from "@rowsncolumns/fast-formula-parser";
@@ -20,6 +20,22 @@ export var createSheetDraft = function (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 var inheritedDimensionMetadata = function (metadata, referenceIndex) {
+    var source = metadata[referenceIndex > 1 ? referenceIndex - 1 : referenceIndex];
+    if (!source)
+        return undefined;
+    var _collapsed = source.collapsed, _hiddenByFilter = source.hiddenByFilter, inherited = __rest(source, ["collapsed", "hiddenByFilter"]);
+    return Object.keys(inherited).length ? inherited : undefined;
+};
 // Clone entire row
 export var cloneRowWithFormatting = function (rowData) {
     var _a;

package/dist/cjs/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/cjs/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"}