@niicojs/excel 0.1.0 → 0.2.0

package/dist/index.js

@@ -150,6 +150,10 @@ const ERROR_TYPES = new Set([
         }
         switch(t){
             case 'n':
+                // Check if this is actually a date stored as number
+                if (this._isDateFormat()) {
+                    return 'date';
+                }
                 return 'number';
             case 's':
             case 'str':
@@ -162,7 +166,12 @@ const ERROR_TYPES = new Set([
                 return 'date';
             default:
                 // If no type but has value, infer from value
-                if (typeof this._data.v === 'number') return 'number';
+                if (typeof this._data.v === 'number') {
+                    if (this._isDateFormat()) {
+                        return 'date';
+                    }
+                    return 'number';
+                }
                 if (typeof this._data.v === 'string') return 'string';
                 if (typeof this._data.v === 'boolean') return 'boolean';
                 return 'empty';
@@ -178,7 +187,14 @@ const ERROR_TYPES = new Set([
         }
         switch(t){
             case 'n':
-                return typeof v === 'number' ? v : parseFloat(String(v));
+                {
+                    const numVal = typeof v === 'number' ? v : parseFloat(String(v));
+                    // Check if this is actually a date stored as number
+                    if (this._isDateFormat()) {
+                        return this._excelDateToJs(numVal);
+                    }
+                    return numVal;
+                }
             case 's':
                 // Shared string reference
                 if (typeof v === 'number') {
@@ -240,9 +256,15 @@ const ERROR_TYPES = new Set([
             this._data.v = val ? 1 : 0;
             this._data.t = 'b';
         } else if (val instanceof Date) {
-            // Store as ISO date string with 'd' type
-            this._data.v = val.toISOString();
-            this._data.t = 'd';
+            // Store as Excel serial number with date format for maximum compatibility
+            this._data.v = this._jsDateToExcel(val);
+            this._data.t = 'n';
+            // Apply a default date format if no style is set
+            if (this._data.s === undefined) {
+                this._data.s = this._worksheet.workbook.styles.createStyle({
+                    numberFormat: 'yyyy-mm-dd'
+                });
+            }
         } else if ('error' in val) {
             this._data.v = val.error;
             this._data.t = 'e';
@@ -332,9 +354,16 @@ const ERROR_TYPES = new Set([
     /**
    * Check if this cell has a date number format
    */ _isDateFormat() {
-        // TODO: Check actual number format from styles
-        // For now, return false - dates should be explicitly typed
-        return false;
+        if (this._data.s === undefined) {
+            return false;
+        }
+        const style = this._worksheet.workbook.styles.getStyle(this._data.s);
+        if (!style.numberFormat) {
+            return false;
+        }
+        // Common date format patterns
+        const fmt = style.numberFormat.toLowerCase();
+        return fmt.includes('y') || fmt.includes('m') || fmt.includes('d') || fmt.includes('h') || fmt.includes('s') || fmt === 'general date' || fmt === 'short date' || fmt === 'long date';
     }
     /**
    * Convert Excel serial date to JavaScript Date
@@ -2465,6 +2494,110 @@ const builder = new XMLBuilder(builderOptions);
         return copy;
     }
     /**
+   * Create a new worksheet from an array of objects.
+   *
+   * The first row contains headers (object keys or custom column headers),
+   * and subsequent rows contain the object values.
+   *
+   * @param config - Configuration for the sheet creation
+   * @returns The created Worksheet
+   *
+   * @example
+   * ```typescript
+   * const data = [
+   *   { name: 'Alice', age: 30, city: 'Paris' },
+   *   { name: 'Bob', age: 25, city: 'London' },
+   *   { name: 'Charlie', age: 35, city: 'Berlin' },
+   * ];
+   *
+   * // Simple usage - all object keys become columns
+   * const sheet = wb.addSheetFromData({
+   *   name: 'People',
+   *   data: data,
+   * });
+   *
+   * // With custom column configuration
+   * const sheet2 = wb.addSheetFromData({
+   *   name: 'People Custom',
+   *   data: data,
+   *   columns: [
+   *     { key: 'name', header: 'Full Name' },
+   *     { key: 'age', header: 'Age (years)' },
+   *   ],
+   * });
+   * ```
+   */ 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);
+        }
+        // Create the new sheet
+        const sheet = this.addSheet(name);
+        // Parse start cell
+        const startAddr = parseAddress(startCell);
+        let startRow = startAddr.row;
+        const startCol = startAddr.col;
+        // Determine columns to use
+        const columnConfigs = columns ?? this._inferColumns(data[0]);
+        // Write header row
+        for(let colIdx = 0; colIdx < columnConfigs.length; colIdx++){
+            const colConfig = columnConfigs[colIdx];
+            const headerText = colConfig.header ?? String(colConfig.key);
+            const cell = sheet.cell(startRow, startCol + colIdx);
+            cell.value = headerText;
+            // Apply header style if enabled
+            if (headerStyle) {
+                cell.style = {
+                    bold: true
+                };
+            }
+        }
+        // Move to data rows
+        startRow++;
+        // Write data rows
+        for(let rowIdx = 0; rowIdx < data.length; rowIdx++){
+            const rowData = data[rowIdx];
+            for(let colIdx = 0; colIdx < columnConfigs.length; colIdx++){
+                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
+                if (colConfig.style) {
+                    cell.style = colConfig.style;
+                }
+            }
+        }
+        return sheet;
+    }
+    /**
+   * Infer column configuration from the first data object
+   */ _inferColumns(sample) {
+        return Object.keys(sample).map((key)=>({
+                key
+            }));
+    }
+    /**
+   * Convert an unknown value to a CellValue
+   */ _toCellValue(value) {
+        if (value === null || value === undefined) {
+            return null;
+        }
+        if (typeof value === 'number' || typeof value === 'string' || typeof value === 'boolean') {
+            return value;
+        }
+        if (value instanceof Date) {
+            return value;
+        }
+        if (typeof value === 'object' && 'error' in value) {
+            return value;
+        }
+        // Convert other types to string
+        return String(value);
+    }
+    /**
    * Create a pivot table from source data.
    *
    * @param config - Pivot table configuration
@@ -2675,7 +2808,8 @@ const builder = new XMLBuilder(builderOptions);
                 Type: rel.type,
                 Target: rel.target
             }, []));
-        let nextRelId = this._relationships.length + 1;
+        // Calculate next available relationship ID based on existing max ID
+        let nextRelId = Math.max(0, ...this._relationships.map((r)=>parseInt(r.id.replace('rId', ''), 10) || 0)) + 1;
         // Add shared strings relationship if needed
         if (this._sharedStrings.count > 0) {
             const hasSharedStrings = this._relationships.some((r)=>r.type === 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/sharedStrings');

package/package.json

@@ -1,17 +1,21 @@
 {
   "name": "@niicojs/excel",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "typescript library to manipulate excel files",
   "homepage": "https://github.com/niicojs/excel#readme",
   "bugs": {
     "url": "https://github.com/niicojs/excel/issues"
   },
+  "license": "MIT",
+  "author": "niico",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/niicojs/excel.git"
   },
-  "license": "MIT",
-  "author": "niico",
+  "files": [
+    "dist",
+    "src"
+  ],
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -29,10 +33,6 @@
     },
     "./package.json": "./package.json"
   },
-  "files": [
-    "dist",
-    "src"
-  ],
   "scripts": {
     "dev": "tsdx dev",
     "build": "tsdx build",

package/src/cell.ts

@@ -66,6 +66,10 @@ export class Cell {
     }
     switch (t) {
       case 'n':
+        // Check if this is actually a date stored as number
+        if (this._isDateFormat()) {
+          return 'date';
+        }
         return 'number';
       case 's':
       case 'str':
@@ -78,7 +82,12 @@ export class Cell {
         return 'date';
       default:
         // If no type but has value, infer from value
-        if (typeof this._data.v === 'number') return 'number';
+        if (typeof this._data.v === 'number') {
+          if (this._isDateFormat()) {
+            return 'date';
+          }
+          return 'number';
+        }
         if (typeof this._data.v === 'string') return 'string';
         if (typeof this._data.v === 'boolean') return 'boolean';
         return 'empty';
@@ -97,8 +106,14 @@ export class Cell {
     }
 
     switch (t) {
-      case 'n':
-        return typeof v === 'number' ? v : parseFloat(String(v));
+      case 'n': {
+        const numVal = typeof v === 'number' ? v : parseFloat(String(v));
+        // Check if this is actually a date stored as number
+        if (this._isDateFormat()) {
+          return this._excelDateToJs(numVal);
+        }
+        return numVal;
+      }
       case 's':
         // Shared string reference
         if (typeof v === 'number') {
@@ -160,9 +175,13 @@ export class Cell {
       this._data.v = val ? 1 : 0;
       this._data.t = 'b';
     } else if (val instanceof Date) {
-      // Store as ISO date string with 'd' type
-      this._data.v = val.toISOString();
-      this._data.t = 'd';
+      // Store as Excel serial number with date format for maximum compatibility
+      this._data.v = this._jsDateToExcel(val);
+      this._data.t = 'n';
+      // Apply a default date format if no style is set
+      if (this._data.s === undefined) {
+        this._data.s = this._worksheet.workbook.styles.createStyle({ numberFormat: 'yyyy-mm-dd' });
+      }
     } else if ('error' in val) {
       this._data.v = val.error;
       this._data.t = 'e';
@@ -272,9 +291,25 @@ export class Cell {
    * Check if this cell has a date number format
    */
   private _isDateFormat(): boolean {
-    // TODO: Check actual number format from styles
-    // For now, return false - dates should be explicitly typed
-    return false;
+    if (this._data.s === undefined) {
+      return false;
+    }
+    const style = this._worksheet.workbook.styles.getStyle(this._data.s);
+    if (!style.numberFormat) {
+      return false;
+    }
+    // Common date format patterns
+    const fmt = style.numberFormat.toLowerCase();
+    return (
+      fmt.includes('y') ||
+      fmt.includes('m') ||
+      fmt.includes('d') ||
+      fmt.includes('h') ||
+      fmt.includes('s') ||
+      fmt === 'general date' ||
+      fmt === 'short date' ||
+      fmt === 'long date'
+    );
   }
 
   /**

package/src/index.ts

@@ -25,6 +25,9 @@ export type {
   PivotValueConfig,
   AggregationType,
   PivotFieldAxis,
+  // Sheet from data types
+  SheetFromDataConfig,
+  ColumnConfig,
 } from './types';
 
 // Utility exports

package/src/types.ts

@@ -163,3 +163,31 @@ export interface PivotCacheField {
  * Pivot field axis assignment
  */
 export type PivotFieldAxis = 'row' | 'column' | 'filter' | 'value';
+
+/**
+ * Configuration for creating a sheet from an array of objects
+ */
+export interface SheetFromDataConfig<T extends object = Record<string, unknown>> {
+  /** Name of the sheet to create */
+  name: string;
+  /** Array of objects with the same structure */
+  data: T[];
+  /** Column definitions (optional - defaults to all keys from first object) */
+  columns?: ColumnConfig<T>[];
+  /** Apply header styling (bold text) (default: true) */
+  headerStyle?: boolean;
+  /** Starting cell address (default: 'A1') */
+  startCell?: string;
+}
+
+/**
+ * Column configuration for sheet data
+ */
+export interface ColumnConfig<T = Record<string, unknown>> {
+  /** Key from the object to use for this column */
+  key: keyof T;
+  /** Header text (optional - defaults to key name) */
+  header?: string;
+  /** Cell style for data cells in this column */
+  style?: CellStyle;
+}

package/src/workbook.ts

@@ -1,5 +1,12 @@
 import { readFile, writeFile } from 'fs/promises';
-import type { SheetDefinition, Relationship, PivotTableConfig, CellValue } from './types';
+import type {
+  SheetDefinition,
+  Relationship,
+  PivotTableConfig,
+  CellValue,
+  SheetFromDataConfig,
+  ColumnConfig,
+} from './types';
 import { Worksheet } from './worksheet';
 import { SharedStrings } from './shared-strings';
 import { Styles } from './styles';
@@ -276,6 +283,126 @@ export class Workbook {
     return copy;
   }
 
+  /**
+   * Create a new worksheet from an array of objects.
+   *
+   * The first row contains headers (object keys or custom column headers),
+   * and subsequent rows contain the object values.
+   *
+   * @param config - Configuration for the sheet creation
+   * @returns The created Worksheet
+   *
+   * @example
+   * ```typescript
+   * const data = [
+   *   { name: 'Alice', age: 30, city: 'Paris' },
+   *   { name: 'Bob', age: 25, city: 'London' },
+   *   { name: 'Charlie', age: 35, city: 'Berlin' },
+   * ];
+   *
+   * // Simple usage - all object keys become columns
+   * const sheet = wb.addSheetFromData({
+   *   name: 'People',
+   *   data: data,
+   * });
+   *
+   * // With custom column configuration
+   * const sheet2 = wb.addSheetFromData({
+   *   name: 'People Custom',
+   *   data: data,
+   *   columns: [
+   *     { key: 'name', header: 'Full Name' },
+   *     { key: 'age', header: 'Age (years)' },
+   *   ],
+   * });
+   * ```
+   */
+  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);
+    }
+
+    // Create the new sheet
+    const sheet = this.addSheet(name);
+
+    // Parse start cell
+    const startAddr = parseAddress(startCell);
+    let startRow = startAddr.row;
+    const startCol = startAddr.col;
+
+    // Determine columns to use
+    const columnConfigs: ColumnConfig<T>[] = columns ?? this._inferColumns(data[0]);
+
+    // Write header row
+    for (let colIdx = 0; colIdx < columnConfigs.length; colIdx++) {
+      const colConfig = columnConfigs[colIdx];
+      const headerText = colConfig.header ?? String(colConfig.key);
+      const cell = sheet.cell(startRow, startCol + colIdx);
+      cell.value = headerText;
+
+      // Apply header style if enabled
+      if (headerStyle) {
+        cell.style = { bold: true };
+      }
+    }
+
+    // Move to data rows
+    startRow++;
+
+    // Write data rows
+    for (let rowIdx = 0; rowIdx < data.length; rowIdx++) {
+      const rowData = data[rowIdx];
+
+      for (let colIdx = 0; colIdx < columnConfigs.length; colIdx++) {
+        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
+        if (colConfig.style) {
+          cell.style = colConfig.style;
+        }
+      }
+    }
+
+    return sheet;
+  }
+
+  /**
+   * Infer column configuration from the first data object
+   */
+  private _inferColumns<T extends object>(sample: T): ColumnConfig<T>[] {
+    return (Object.keys(sample) as (keyof T)[]).map((key) => ({
+      key,
+    }));
+  }
+
+  /**
+   * Convert an unknown value to a CellValue
+   */
+  private _toCellValue(value: unknown): CellValue {
+    if (value === null || value === undefined) {
+      return null;
+    }
+    if (typeof value === 'number' || typeof value === 'string' || typeof value === 'boolean') {
+      return value;
+    }
+    if (value instanceof Date) {
+      return value;
+    }
+    if (typeof value === 'object' && 'error' in value) {
+      return value as CellValue;
+    }
+    // Convert other types to string
+    return String(value);
+  }
+
   /**
    * Create a pivot table from source data.
    *
@@ -521,7 +648,8 @@ export class Workbook {
       createElement('Relationship', { Id: rel.id, Type: rel.type, Target: rel.target }, []),
     );
 
-    let nextRelId = this._relationships.length + 1;
+    // Calculate next available relationship ID based on existing max ID
+    let nextRelId = Math.max(0, ...this._relationships.map((r) => parseInt(r.id.replace('rId', ''), 10) || 0)) + 1;
 
     // Add shared strings relationship if needed
     if (this._sharedStrings.count > 0) {