@cj-tech-master/excelts 4.0.2 → 4.0.3-canary.20260106020433.b618378

package/dist/browser/modules/excel/table.d.ts

@@ -8,6 +8,7 @@ interface TableModel {
     rows: CellValue[][];
     headerRow?: boolean;
     totalsRow?: boolean;
+    qualifyImplicitStructuredReferences?: boolean;
     style?: TableStyleProperties;
     tl?: Address;
     autoFilterRef?: string;

package/dist/browser/modules/excel/table.js

@@ -174,13 +174,18 @@ class Table {
             data.forEach((value, j) => {
                 const cell = r.getCell(col + j);
                 const formula = value?.formula;
-                cell.value =
-                    typeof formula === "string"
-                        ? {
-                            ...value,
-                            formula: formula.replace(/(^|[^A-Za-z0-9_])\[@\[?([^\[\]]+?)\]?\]/g, `$1${table.name}[[#This Row],[$2]]`)
-                        }
-                        : value;
+                if (typeof formula === "string") {
+                    const shouldQualify = table.qualifyImplicitStructuredReferences === true;
+                    cell.value = {
+                        ...value,
+                        formula: shouldQualify
+                            ? formula.replace(/(^|[^A-Za-z0-9_])\[@\[?([^\[\]]+?)\]?\]/g, `$1${table.name}[[#This Row],[$2]]`)
+                            : formula
+                    };
+                }
+                else {
+                    cell.value = value;
+                }
                 assignStyle(cell, table.columns[j].style);
             });
         });

package/dist/browser/modules/excel/types.d.ts

@@ -476,6 +476,13 @@ export interface TableProperties {
     ref: string;
     headerRow?: boolean;
     totalsRow?: boolean;
+    /**
+     * When true, expands implicit structured references like [@A] to
+     * TableName[[#This Row],[A]] when storing table row formulas.
+     *
+     * Default: false (keeps formulas as provided, e.g. [@A]).
+     */
+    qualifyImplicitStructuredReferences?: boolean;
     style?: TableStyleProperties;
     columns: TableColumnProperties[];
     rows: any[][];

package/dist/cjs/modules/excel/table.js

@@ -177,13 +177,18 @@ class Table {
             data.forEach((value, j) => {
                 const cell = r.getCell(col + j);
                 const formula = value?.formula;
-                cell.value =
-                    typeof formula === "string"
-                        ? {
-                            ...value,
-                            formula: formula.replace(/(^|[^A-Za-z0-9_])\[@\[?([^\[\]]+?)\]?\]/g, `$1${table.name}[[#This Row],[$2]]`)
-                        }
-                        : value;
+                if (typeof formula === "string") {
+                    const shouldQualify = table.qualifyImplicitStructuredReferences === true;
+                    cell.value = {
+                        ...value,
+                        formula: shouldQualify
+                            ? formula.replace(/(^|[^A-Za-z0-9_])\[@\[?([^\[\]]+?)\]?\]/g, `$1${table.name}[[#This Row],[$2]]`)
+                            : formula
+                    };
+                }
+                else {
+                    cell.value = value;
+                }
                 assignStyle(cell, table.columns[j].style);
             });
         });

package/dist/esm/modules/excel/table.js

@@ -174,13 +174,18 @@ class Table {
             data.forEach((value, j) => {
                 const cell = r.getCell(col + j);
                 const formula = value?.formula;
-                cell.value =
-                    typeof formula === "string"
-                        ? {
-                            ...value,
-                            formula: formula.replace(/(^|[^A-Za-z0-9_])\[@\[?([^\[\]]+?)\]?\]/g, `$1${table.name}[[#This Row],[$2]]`)
-                        }
-                        : value;
+                if (typeof formula === "string") {
+                    const shouldQualify = table.qualifyImplicitStructuredReferences === true;
+                    cell.value = {
+                        ...value,
+                        formula: shouldQualify
+                            ? formula.replace(/(^|[^A-Za-z0-9_])\[@\[?([^\[\]]+?)\]?\]/g, `$1${table.name}[[#This Row],[$2]]`)
+                            : formula
+                    };
+                }
+                else {
+                    cell.value = value;
+                }
                 assignStyle(cell, table.columns[j].style);
             });
         });

package/dist/iife/excelts.iife.js

@@ -1,5 +1,5 @@
 /*!
- * @cj-tech-master/excelts v4.0.2
+ * @cj-tech-master/excelts v4.0.3-canary.20260106020433.b618378
  * TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.
  * (c) 2026 cjnoname
  * Released under the MIT License
@@ -2396,10 +2396,13 @@ var ExcelTS = (function(exports) {
 				data.forEach((value, j) => {
 					const cell = r.getCell(col + j);
 					const formula = value?.formula;
-					cell.value = typeof formula === "string" ? {
-						...value,
-						formula: formula.replace(/(^|[^A-Za-z0-9_])\[@\[?([^\[\]]+?)\]?\]/g, `$1${table.name}[[#This Row],[$2]]`)
-					} : value;
+					if (typeof formula === "string") {
+						const shouldQualify = table.qualifyImplicitStructuredReferences === true;
+						cell.value = {
+							...value,
+							formula: shouldQualify ? formula.replace(/(^|[^A-Za-z0-9_])\[@\[?([^\[\]]+?)\]?\]/g, `$1${table.name}[[#This Row],[$2]]`) : formula
+						};
+					} else cell.value = value;
 					assignStyle(cell, table.columns[j].style);
 				});
 			});