@cj-tech-master/excelts 4.0.1 → 4.0.2-canary.20260104092100.3972145

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

@@ -173,7 +173,19 @@ class Table {
             const r = worksheet.getRow(row + count++);
             data.forEach((value, j) => {
                 const cell = r.getCell(col + j);
-                cell.value = value;
+                const formula = value?.formula;
+                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

@@ -176,7 +176,19 @@ class Table {
             const r = worksheet.getRow(row + count++);
             data.forEach((value, j) => {
                 const cell = r.getCell(col + j);
-                cell.value = value;
+                const formula = value?.formula;
+                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

@@ -173,7 +173,19 @@ class Table {
             const r = worksheet.getRow(row + count++);
             data.forEach((value, j) => {
                 const cell = r.getCell(col + j);
-                cell.value = value;
+                const formula = value?.formula;
+                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.1
+ * @cj-tech-master/excelts v4.0.2-canary.20260104092100.3972145
  * TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.
  * (c) 2026 cjnoname
  * Released under the MIT License
@@ -2395,7 +2395,14 @@ var ExcelTS = (function(exports) {
 				const r = worksheet.getRow(row + count++);
 				data.forEach((value, j) => {
 					const cell = r.getCell(col + j);
-					cell.value = value;
+					const formula = value?.formula;
+					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);
 				});
 			});