@niicojs/excel 0.2.1 → 0.2.2

package/dist/index.cjs

@@ -2525,13 +2525,20 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
    *     { key: 'age', header: 'Age (years)' },
    *   ],
    * });
+   *
+   * // With rich cell values (value, formula, style)
+   * const dataWithFormulas = [
+   *   { product: 'Widget', price: 10, qty: 5, total: { formula: 'B2*C2', style: { bold: true } } },
+   *   { product: 'Gadget', price: 20, qty: 3, total: { formula: 'B3*C3', style: { bold: true } } },
+   * ];
+   * const sheet3 = wb.addSheetFromData({
+   *   name: 'With Formulas',
+   *   data: dataWithFormulas,
+   * });
    * ```
    */ addSheetFromData(config) {
         const { name, data, columns, headerStyle = true, startCell = 'A1' } = config;
-        if (data.length === 0) {
-            // Create empty sheet if no data
-            return this.addSheet(name);
-        }
+        if (!data?.length) return this.addSheet(name);
         // Create the new sheet
         const sheet = this.addSheet(name);
         // Parse start cell
@@ -2562,17 +2569,41 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
                 const colConfig = columnConfigs[colIdx];
                 const value = rowData[colConfig.key];
                 const cell = sheet.cell(startRow + rowIdx, startCol + colIdx);
-                // Convert value to CellValue
-                cell.value = this._toCellValue(value);
-                // Apply column style if defined
+                // Check if value is a rich cell definition
+                if (this._isRichCellValue(value)) {
+                    const richValue = value;
+                    if (richValue.value !== undefined) cell.value = richValue.value;
+                    if (richValue.formula !== undefined) cell.formula = richValue.formula;
+                    if (richValue.style !== undefined) cell.style = richValue.style;
+                } else {
+                    // Convert value to CellValue
+                    cell.value = this._toCellValue(value);
+                }
+                // Apply column style if defined (merged with cell style)
                 if (colConfig.style) {
-                    cell.style = colConfig.style;
+                    cell.style = {
+                        ...cell.style,
+                        ...colConfig.style
+                    };
                 }
             }
         }
         return sheet;
     }
     /**
+   * Check if a value is a rich cell value object with value, formula, or style fields
+   */ _isRichCellValue(value) {
+        if (value === null || value === undefined) {
+            return false;
+        }
+        if (typeof value !== 'object' || value instanceof Date) {
+            return false;
+        }
+        // Check if it has at least one of the rich cell properties
+        const obj = value;
+        return 'value' in obj || 'formula' in obj || 'style' in obj;
+    }
+    /**
    * Infer column configuration from the first data object
    */ _inferColumns(sample) {
         return Object.keys(sample).map((key)=>({

package/dist/index.d.cts

@@ -156,6 +156,18 @@ interface ColumnConfig<T = Record<string, unknown>> {
     /** Cell style for data cells in this column */
     style?: CellStyle;
 }
+/**
+ * Rich cell value with optional formula and style.
+ * Use this when you need to set value, formula, or style for individual cells.
+ */
+interface RichCellValue {
+    /** Cell value */
+    value?: CellValue;
+    /** Formula (without leading '=') */
+    formula?: string;
+    /** Cell style */
+    style?: CellStyle;
+}
 
 /**
  * Represents a single cell in a worksheet
@@ -723,9 +735,23 @@ declare class Workbook {
      *     { key: 'age', header: 'Age (years)' },
      *   ],
      * });
+     *
+     * // With rich cell values (value, formula, style)
+     * const dataWithFormulas = [
+     *   { product: 'Widget', price: 10, qty: 5, total: { formula: 'B2*C2', style: { bold: true } } },
+     *   { product: 'Gadget', price: 20, qty: 3, total: { formula: 'B3*C3', style: { bold: true } } },
+     * ];
+     * const sheet3 = wb.addSheetFromData({
+     *   name: 'With Formulas',
+     *   data: dataWithFormulas,
+     * });
      * ```
      */
     addSheetFromData<T extends object>(config: SheetFromDataConfig<T>): Worksheet;
+    /**
+     * Check if a value is a rich cell value object with value, formula, or style fields
+     */
+    private _isRichCellValue;
     /**
      * Infer column configuration from the first data object
      */
@@ -810,5 +836,5 @@ declare const parseRange: (range: string) => RangeAddress;
 declare const toRange: (range: RangeAddress) => string;
 
 export { Cell, PivotCache, PivotTable, Range, SharedStrings, Styles, Workbook, Worksheet, parseAddress, parseRange, toAddress, toRange };
-export type { AggregationType, Alignment, BorderStyle, BorderType, CellAddress, CellError, CellStyle, CellType, CellValue, ColumnConfig, ErrorType, PivotFieldAxis, PivotTableConfig, PivotValueConfig, RangeAddress, SheetFromDataConfig };
+export type { AggregationType, Alignment, BorderStyle, BorderType, CellAddress, CellError, CellStyle, CellType, CellValue, ColumnConfig, ErrorType, PivotFieldAxis, PivotTableConfig, PivotValueConfig, RangeAddress, RichCellValue, SheetFromDataConfig };
 //# sourceMappingURL=index.d.cts.map