@niicojs/excel 0.2.0 → 0.2.2

package/dist/index.d.ts

@@ -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.ts.map