@cj-tech-master/excelts 1.4.5-canary.20251212053535.13d32d8 → 1.4.5-canary.20251212143538.45665af

package/dist/esm/doc/column.js

@@ -2,9 +2,11 @@ import { colCache } from "../utils/col-cache.js";
 import { isEqual } from "../utils/under-dash.js";
 import { Enums } from "./enums.js";
 const DEFAULT_COLUMN_WIDTH = 9;
-// Column defines the column properties for 1 column.
-// This includes header rows, widths, key, (style), etc.
-// Worksheet will condense the columns as appropriate during serialization
+/**
+ * Column defines the column properties for 1 column.
+ * This includes header rows, widths, key, (style), etc.
+ * Worksheet will condense the columns as appropriate during serialization
+ */
 class Column {
     constructor(worksheet, number, defn) {
         this._worksheet = worksheet;
@@ -20,6 +22,9 @@ class Column {
     get worksheet() {
         return this._worksheet;
     }
+    /**
+     * Column letter key
+     */
     get letter() {
         return colCache.n2l(this._number);
     }
@@ -68,6 +73,9 @@ class Column {
         }
         return [];
     }
+    /**
+     * Can be a string to set one row high header or an array to set multi-row high header
+     */
     get header() {
         return this._header;
     }
@@ -82,6 +90,9 @@ class Column {
             this._header = undefined;
         }
     }
+    /**
+     * The name of the properties associated with this column in each row
+     */
     get key() {
         return this._key;
     }
@@ -95,18 +106,27 @@ class Column {
             this._worksheet.setColumnKey(this._key, this);
         }
     }
+    /**
+     * Hides the column
+     */
     get hidden() {
         return !!this._hidden;
     }
     set hidden(value) {
         this._hidden = value;
     }
+    /**
+     * Set an outline level for columns
+     */
     get outlineLevel() {
         return this._outlineLevel || 0;
     }
     set outlineLevel(value) {
         this._outlineLevel = value;
     }
+    /**
+     * Indicate the collapsed state based on outlineLevel
+     */
     get collapsed() {
         return !!(this._outlineLevel && this._outlineLevel >= this._worksheet.properties.outlineLevelCol);
     }
@@ -148,16 +168,25 @@ class Column {
     get headerCount() {
         return this.headers.length;
     }
-    eachCell(options, iteratee) {
+    eachCell(optionsOrCallback, maybeCallback) {
         const colNumber = this.number;
-        if (!iteratee) {
-            iteratee = options;
+        let options;
+        let callback;
+        if (typeof optionsOrCallback === "function") {
             options = {};
+            callback = optionsOrCallback;
+        }
+        else {
+            options = optionsOrCallback;
+            callback = maybeCallback;
         }
         this._worksheet.eachRow(options, (row, rowNumber) => {
-            iteratee(row.getCell(colNumber), rowNumber);
+            callback(row.getCell(colNumber), rowNumber);
         });
     }
+    /**
+     * The cell values in the column
+     */
     get values() {
         const v = [];
         this.eachCell((cell, rowNumber) => {

package/dist/esm/doc/row.js

@@ -9,19 +9,29 @@ class Row {
         this.style = {};
         this.outlineLevel = 0;
     }
-    // return the row number
+    /**
+     * The row number
+     */
     get number() {
         return this._number;
     }
+    /**
+     * The worksheet that contains this row
+     */
     get worksheet() {
         return this._worksheet;
     }
-    // Inform Streaming Writer that this row (and all rows before it) are complete
-    // and ready to write. Has no effect on Worksheet document
+    /**
+     * Commit a completed row to stream.
+     * Inform Streaming Writer that this row (and all rows before it) are complete
+     * and ready to write. Has no effect on Worksheet document.
+     */
     commit() {
         this._worksheet._commitRow(this);
     }
-    // helps GC by breaking cyclic references
+    /**
+     * Helps GC by breaking cyclic references
+     */
     destroy() {
         delete this._worksheet;
         delete this._cells;
@@ -40,7 +50,9 @@ class Row {
         }
         return cell;
     }
-    // get cell by key, letter or column number
+    /**
+     * Get cell by number, column letter or column key
+     */
     getCell(col) {
         let colNum;
         if (typeof col === "string") {
@@ -63,7 +75,11 @@ class Row {
                 col: colNum
             }));
     }
-    // remove cell(s) and shift all higher cells down by count
+    /**
+     * Cut one or more cells (cells to the right are shifted left)
+     *
+     * Note: this operation will not affect other rows
+     */
     splice(start, count, ...inserts) {
         const nKeep = start + count;
         const nExpand = inserts.length - count;
@@ -112,26 +128,26 @@ class Row {
             cDst.comment = undefined;
         }
     }
-    eachCell(optionsOrIteratee, maybeIteratee) {
+    eachCell(optOrCallback, maybeCallback) {
         let options = null;
-        let iteratee;
-        if (typeof optionsOrIteratee === "function") {
-            iteratee = optionsOrIteratee;
+        let callback;
+        if (typeof optOrCallback === "function") {
+            callback = optOrCallback;
         }
         else {
-            options = optionsOrIteratee;
-            iteratee = maybeIteratee;
+            options = optOrCallback;
+            callback = maybeCallback;
         }
         if (options && options.includeEmpty) {
             const n = this._cells.length;
             for (let i = 1; i <= n; i++) {
-                iteratee(this.getCell(i), i);
+                callback(this.getCell(i), i);
             }
         }
         else {
             this._cells.forEach((cell, index) => {
                 if (cell && cell.type !== Enums.ValueType.Null) {
-                    iteratee(cell, index + 1);
+                    callback(cell, index + 1);
                 }
             });
         }
@@ -152,7 +168,9 @@ class Row {
         }
         ws.rowBreaks.push(pb);
     }
-    // return a sparse array of cell values
+    /**
+     * Get a row as a sparse array
+     */
     get values() {
         const values = [];
         this._cells.forEach(cell => {
@@ -162,7 +180,9 @@ class Row {
         });
         return values;
     }
-    // set the values by contiguous or sparse array, or by key'd object literal
+    /**
+     * Set the values by contiguous or sparse array, or by key'd object literal
+     */
     set values(value) {
         // this operation is not additive - any prior cells are removed
         this._cells = [];
@@ -198,13 +218,21 @@ class Row {
             });
         }
     }
-    // returns true if the row includes at least one cell with a value
+    /**
+     * Returns true if the row includes at least one cell with a value
+     */
     get hasValues() {
         return this._cells.some(cell => cell && cell.type !== Enums.ValueType.Null);
     }
+    /**
+     * Number of cells including empty ones
+     */
     get cellCount() {
         return this._cells.length;
     }
+    /**
+     * Number of non-empty cells
+     */
     get actualCellCount() {
         let count = 0;
         this.eachCell(() => {
@@ -212,7 +240,9 @@ class Row {
         });
         return count;
     }
-    // get the min and max column number for the non-null cells in this row or null
+    /**
+     * Get the min and max column number for the non-null cells in this row or null
+     */
     get dimensions() {
         let min = 0;
         let max = 0;

package/dist/esm/doc/workbook.js

@@ -26,12 +26,18 @@ class Workbook {
         this.pivotTables = [];
         this._definedNames = new DefinedNames();
     }
+    /**
+     * xlsx file format operations
+     */
     get xlsx() {
         if (!this._xlsx) {
             this._xlsx = new XLSX(this);
         }
         return this._xlsx;
     }
+    /**
+     * csv file format operations
+     */
     get csv() {
         if (!this._csv) {
             this._csv = new CSV(this);
@@ -47,6 +53,9 @@ class Workbook {
         }
         return this._worksheets.length || 1;
     }
+    /**
+     * Add a new worksheet and return a reference to it
+     */
     addWorksheet(name, options) {
         const id = this.nextId;
         const lastOrderNo = this._worksheets.reduce((acc, ws) => ((ws && ws.orderNo) > acc ? ws.orderNo : acc), 0);
@@ -70,6 +79,9 @@ class Workbook {
             worksheet.destroy();
         }
     }
+    /**
+     * Fetch sheet by name or id
+     */
     getWorksheet(id) {
         if (id === undefined) {
             return this._worksheets.find(Boolean);
@@ -82,6 +94,9 @@ class Workbook {
         }
         return undefined;
     }
+    /**
+     * Return a clone of worksheets in order
+     */
     get worksheets() {
         // return a clone of _worksheets
         return this._worksheets
@@ -89,9 +104,14 @@ class Workbook {
             .sort((a, b) => a.orderNo - b.orderNo)
             .filter(Boolean);
     }
-    eachSheet(iteratee) {
+    /**
+     * Iterate over all sheets.
+     *
+     * Note: `workbook.worksheets.forEach` will still work but this is better.
+     */
+    eachSheet(callback) {
         this.worksheets.forEach(sheet => {
-            iteratee(sheet, sheet.id);
+            callback(sheet, sheet.id);
         });
     }
     get definedNames() {
@@ -101,6 +121,9 @@ class Workbook {
         // Note: themes are not an exposed feature, meddle at your peril!
         this._themes = undefined;
     }
+    /**
+     * Add Image to Workbook and return the id
+     */
     addImage(image) {
         // TODO:  validation?
         const id = this.media.length;