@niicojs/excel 0.2.0 → 0.2.2

package/dist/index.js

@@ -2339,8 +2339,6 @@ const builder = new XMLBuilder(builderOptions);
    */ static create() {
         const workbook = new Workbook();
         workbook._dirty = true;
-        // Add default sheet
-        workbook.addSheet('Sheet1');
         return workbook;
     }
     /**
@@ -2525,13 +2523,20 @@ const builder = new 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 +2567,41 @@ const builder = new 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@niicojs/excel",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "typescript library to manipulate excel files",
   "homepage": "https://github.com/niicojs/excel#readme",
   "bugs": {

package/src/index.ts

@@ -28,6 +28,7 @@ export type {
   // Sheet from data types
   SheetFromDataConfig,
   ColumnConfig,
+  RichCellValue,
 } from './types';
 
 // Utility exports

package/src/types.ts

@@ -191,3 +191,16 @@ export 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.
+ */
+export interface RichCellValue {
+  /** Cell value */
+  value?: CellValue;
+  /** Formula (without leading '=') */
+  formula?: string;
+  /** Cell style */
+  style?: CellStyle;
+}

package/src/workbook.ts

@@ -6,6 +6,7 @@ import type {
   CellValue,
   SheetFromDataConfig,
   ColumnConfig,
+  RichCellValue,
 } from './types';
 import { Worksheet } from './worksheet';
 import { SharedStrings } from './shared-strings';
@@ -87,9 +88,6 @@ export class Workbook {
     const workbook = new Workbook();
     workbook._dirty = true;
 
-    // Add default sheet
-    workbook.addSheet('Sheet1');
-
     return workbook;
   }
 
@@ -315,15 +313,22 @@ export 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 {
     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);
@@ -361,12 +366,20 @@ export class Workbook {
         const value = rowData[colConfig.key];
         const cell = sheet.cell(startRow + rowIdx, startCol + colIdx);
 
-        // Convert value to CellValue
-        cell.value = this._toCellValue(value);
+        // Check if value is a rich cell definition
+        if (this._isRichCellValue(value)) {
+          const richValue = value as RichCellValue;
+          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
+        // Apply column style if defined (merged with cell style)
         if (colConfig.style) {
-          cell.style = colConfig.style;
+          cell.style = { ...cell.style, ...colConfig.style };
         }
       }
     }
@@ -374,6 +387,21 @@ export class Workbook {
     return sheet;
   }
 
+  /**
+   * Check if a value is a rich cell value object with value, formula, or style fields
+   */
+  private _isRichCellValue(value: unknown): value is RichCellValue {
+    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 as Record<string, unknown>;
+    return 'value' in obj || 'formula' in obj || 'style' in obj;
+  }
+
   /**
    * Infer column configuration from the first data object
    */