@niicojs/excel 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -152,6 +152,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':
@@ -164,7 +168,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';
@@ -180,7 +189,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') {
@@ -242,9 +258,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';
@@ -334,9 +356,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
@@ -2467,6 +2496,110 @@ const builder = new fastXmlParser.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
@@ -2677,7 +2810,8 @@ const builder = new fastXmlParser.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/dist/index.d.cts

@@ -130,6 +130,32 @@ interface PivotCacheField {
  * Pivot field axis assignment
  */
 type PivotFieldAxis = 'row' | 'column' | 'filter' | 'value';
+/**
+ * Configuration for creating a sheet from an array of objects
+ */
+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
+ */
+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;
+}
 
 /**
  * Represents a single cell in a worksheet
@@ -665,6 +691,49 @@ declare class Workbook {
      * Copy a worksheet
      */
     copySheet(sourceName: string, newName: string): Worksheet;
+    /**
+     * 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;
+    /**
+     * Infer column configuration from the first data object
+     */
+    private _inferColumns;
+    /**
+     * Convert an unknown value to a CellValue
+     */
+    private _toCellValue;
     /**
      * Create a pivot table from source data.
      *
@@ -741,5 +810,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, ErrorType, PivotFieldAxis, PivotTableConfig, PivotValueConfig, RangeAddress };
+export type { AggregationType, Alignment, BorderStyle, BorderType, CellAddress, CellError, CellStyle, CellType, CellValue, ColumnConfig, ErrorType, PivotFieldAxis, PivotTableConfig, PivotValueConfig, RangeAddress, SheetFromDataConfig };
 //# sourceMappingURL=index.d.cts.map