xlkit 1.0.3

package/README.md

@@ -0,0 +1,182 @@
+# xlkit
+
+<p align="center">
+  <img src="./logo.png" alt="xlkit Logo" width="200" />
+</p>
+
+[ExcelJS](https://github.com/exceljs/exceljs) のための宣言的スキーマベースラッパーです。
+シンプルなスキーマでExcelの構造を定義するだけで、スタイル、フォーマット、レイアウトをxlkitが自動で処理します。
+
+[English README](./README_en.md)
+
+## 特徴
+
+- 📝 **宣言的スキーマ**: 列、ヘッダー、スタイルを一箇所で定義。
+- 🎨 **高度なスタイル設定**: ヘッダー、行、列、または特定のセルに対して、条件付きでスタイルを適用可能。
+- 🔗 **自動結合**: 同じ値を持つ縦方向のセルを自動的に結合 (`merge: 'vertical'`)。
+- 📏 **自動列幅**: コンテンツ（全角文字を含む）に基づいて列幅をスマートに計算。
+- 🌈 **Hexカラー**: 標準的な6桁のHexコード（`#FF0000`）を直接使用可能。
+- 🌐 **ユニバーサル**: Node.js（ファイル出力）とブラウザ/フロントエンド（`Uint8Array` 出力）の両方で動作。
+
+## インストール
+
+```bash
+npm install xlkit
+```
+
+## クイックスタート
+
+```typescript
+import { createWorkbook, defineSheet } from 'xlkit';
+
+// 1. データ型を定義
+interface User {
+  id: number;
+  name: string;
+  role: string;
+  isActive: boolean;
+}
+
+// 2. シートのスキーマを定義
+const userSheet = defineSheet<User>({
+  name: 'Users',
+  columns: [
+    { key: 'id', header: 'ID', width: 10 },
+    { key: 'name', header: '氏名', width: 20 },
+    { key: 'role', header: '役割', width: 'auto', merge: 'vertical' },
+    { 
+      key: 'isActive', 
+      header: 'ステータス', 
+      format: (val) => val ? '有効' : '無効',
+      style: (val) => ({ font: { color: val ? '#00AA00' : '#FF0000' } })
+    }
+  ],
+  borders: 'outer'
+});
+
+// 3. Excel生成
+await createWorkbook().addSheet(userSheet, users).save('users.xlsx');
+```
+
+## 詳細リファレンス
+
+### 1. レイアウトと列定義 (`columns`)
+
+列の定義は `columns` 配列で行います。
+
+| プロパティ | 型 | 説明 |
+| :--- | :--- | :--- |
+| `key` | `keyof T` | データのプロパティキー |
+| `header` | `string` | ヘッダーに表示するテキスト |
+| `width` | `number` \| `'auto'` | 列幅。`'auto'` を指定するとコンテンツに合わせて自動調整されます。 |
+| `merge` | `'vertical'` | `'vertical'` を指定すると、上下のセルが同じ値の場合に自動結合されます。 |
+| `format` | `string` \| `Function` | 数値/日付のフォーマット文字列（例: `'$#,##0'`, `'yyyy-mm-dd'`）または変換関数。 |
+| `style` | `Style` \| `Function` | 列全体のスタイル、または値に応じた条件付きスタイル関数。 |
+
+### 2. 罫線 (`borders`)
+
+シート全体の罫線プリセットを `borders` プロパティで指定できます。
+
+- **`'all'`**: すべてのセルに格子状の罫線を引きます。
+- **`'outer'`**: データ領域の外枠のみに罫線を引きます。
+- **`'header-body'`**: ヘッダー行の下に太めの線を引きます。
+- **`'none'`**: 罫線を引きません（デフォルト）。
+
+```typescript
+const sheet = defineSheet<User>({
+  // ...
+  borders: 'all', // 格子状
+});
+```
+
+個別のセルに罫線を設定したい場合は、`style` プロパティ内の `border` で詳細に指定可能です。
+
+### 3. スタイル (`style`)
+
+フォント、背景色、配置などを詳細に設定できます。6桁のHexカラーコード (`#RRGGBB`) が使用可能です。
+
+```typescript
+style: {
+  font: { 
+    name: 'Arial',
+    size: 12,
+    bold: true,
+    color: '#FF0000' // 赤色
+  },
+  fill: {
+    color: '#EEEEEE' // Hexカラーで簡単に指定
+  },
+  alignment: {
+    vertical: 'middle',
+    horizontal: 'center',
+    wrapText: true
+  },
+  border: {
+    top: { style: 'thin', color: { argb: 'FF000000' } },
+    // ...
+  }
+}
+```
+
+### 4. ヘッダー設定 (`header`)
+
+ヘッダー行のスタイルや構成をカスタマイズできます。
+
+```typescript
+header: {
+  rows: ['社員名簿 2025'], // 1行目（タイトルなど）
+  style: { // ヘッダー行のスタイル
+    font: { bold: true, color: '#FFFFFF' },
+    fill: { color: '#4472C4' }
+  },
+  borders: 'header-body' // ヘッダー下の罫線
+}
+```
+
+### 5. 行スタイル (`rows`)
+
+行ごとのスタイル（縞模様など）を定義できます。
+
+```typescript
+rows: {
+  style: (data, index) => {
+    // 偶数行に背景色をつける
+    return index % 2 === 0 ? { fill: { color: '#F0F0F0' } } : {};
+  }
+}
+```
+
+### 6. ブラウザ環境でのダウンロード
+
+ブラウザ環境では、`download()` メソッドを使って簡単にExcelファイルをダウンロードできます。
+
+```typescript
+// Node.js環境
+await createWorkbook().addSheet(sheet, data).save('output.xlsx');
+
+// ブラウザ環境
+await createWorkbook().addSheet(sheet, data).download('output.xlsx');
+```
+
+内部的には`saveToBuffer()`を呼び出してBlobを作成し、自動的にダウンロードを開始します。
+
+### 7. タイムアウト設定
+
+大量データ処理時のフリーズを防ぐため、`save()`、`saveToBuffer()`、`download()` にはデフォルトで10秒のタイムアウトが設定されています。
+
+```typescript
+// デフォルト（10秒）
+await createWorkbook().addSheet(sheet, data).save('output.xlsx');
+
+// カスタムタイムアウト（30秒）
+await createWorkbook().addSheet(sheet, data).save('output.xlsx', { timeout: 30000 });
+
+// ブラウザ環境でも同様
+await createWorkbook().addSheet(sheet, data).download('output.xlsx', { timeout: 15000 });
+```
+
+> **推奨**: 10万行以下のデータであればデフォルト設定で問題ありません。それ以上の大量データを扱う場合は、ファイル分割やストリーミング処理を検討してください。
+
+## ライセンス
+
+MIT

package/dist/Sheetflow.d.ts

@@ -0,0 +1,18 @@
+import { SheetDef } from './types';
+export declare class XLKit {
+    private workbook;
+    constructor();
+    addSheet<T>(def: SheetDef<T>, data: T[]): XLKit;
+    save(path: string, options?: {
+        timeout?: number;
+    }): Promise<void>;
+    saveToBuffer(options?: {
+        timeout?: number;
+    }): Promise<Uint8Array>;
+    download(filename: string, options?: {
+        timeout?: number;
+    }): Promise<void>;
+}
+export declare function createWorkbook(): XLKit;
+export declare function defineSheet<T>(def: SheetDef<T>): SheetDef<T>;
+//# sourceMappingURL=Sheetflow.d.ts.map

package/dist/Sheetflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sheetflow.d.ts","sourceRoot":"","sources":["../src/Sheetflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAsB,MAAM,SAAS,CAAC;AAGvD,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAmB;;IAMnC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK;IAsKzC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjE,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAajE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAiBhF;AAED,wBAAgB,cAAc,IAAI,KAAK,CAEtC;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAE5D"}

package/dist/Sheetflow.js

@@ -0,0 +1,212 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XLKit = void 0;
+exports.createWorkbook = createWorkbook;
+exports.defineSheet = defineSheet;
+const exceljs_1 = __importDefault(require("exceljs"));
+const style_1 = require("./utils/style");
+class XLKit {
+    constructor() {
+        this.workbook = new exceljs_1.default.Workbook();
+    }
+    addSheet(def, data) {
+        // Validate Sheet Name
+        if (!def.name) {
+            throw new Error('Sheet name is required.');
+        }
+        if (def.name.length > 31) {
+            throw new Error(`Sheet name "${def.name}" exceeds the maximum length of 31 characters.`);
+        }
+        // Invalid characters: \ / ? * [ ] :
+        const invalidChars = /[\\/?*[\]:]/;
+        if (invalidChars.test(def.name)) {
+            throw new Error(`Sheet name "${def.name}" contains invalid characters (\\ / ? * [ ] :).`);
+        }
+        const sheet = this.workbook.addWorksheet(def.name);
+        // 1. Setup Columns & Headers
+        const columns = def.columns.map((col, colIndex) => {
+            let width = col.width;
+            if (width === 'auto') {
+                let maxLen = col.header.length * (def.autoWidth?.headerIncluded !== false ? 1 : 0);
+                // Check data length (sample first 100 rows for performance if needed, currently all)
+                data.forEach(row => {
+                    const val = row[col.key];
+                    const str = val != null ? String(val) : '';
+                    // Simple full-width check: count as 2 if char code > 255
+                    let len = 0;
+                    for (let i = 0; i < str.length; i++) {
+                        len += str.charCodeAt(i) > 255 ? 2 : 1;
+                    }
+                    if (len > maxLen)
+                        maxLen = len;
+                });
+                const padding = def.autoWidth?.padding ?? 2;
+                const constant = def.autoWidth?.charWidthConstant ?? 1.2;
+                width = (maxLen + padding) * constant;
+            }
+            return {
+                header: col.header,
+                key: String(col.key),
+                width: typeof width === 'number' ? width : 15,
+                style: col.style && typeof col.style === 'object' ? (0, style_1.mapStyle)(col.style) : undefined
+            };
+        });
+        sheet.columns = columns;
+        // 2. Add Data & Apply Row Styles
+        data.forEach((row, rowIndex) => {
+            const addedRow = sheet.addRow(row);
+            // Apply row-level style
+            if (def.rows?.style) {
+                const rowStyle = def.rows.style(row, rowIndex);
+                const mappedStyle = (0, style_1.mapStyle)(rowStyle);
+                addedRow.eachCell((cell) => {
+                    cell.style = { ...cell.style, ...mappedStyle };
+                });
+            }
+            // Apply column-level conditional styles
+            def.columns.forEach((col, colIndex) => {
+                if (typeof col.style === 'function') {
+                    const cell = addedRow.getCell(colIndex + 1);
+                    const cellStyle = col.style(row[col.key], row, rowIndex);
+                    cell.style = { ...cell.style, ...(0, style_1.mapStyle)(cellStyle) };
+                }
+                if (col.format) {
+                    const cell = addedRow.getCell(colIndex + 1);
+                    if (typeof col.format === 'string') {
+                        cell.numFmt = col.format;
+                    }
+                    else {
+                        cell.value = col.format(row[col.key]);
+                    }
+                }
+            });
+        });
+        // 3. Apply Header Styles
+        if (def.header?.style) {
+            const headerRow = sheet.getRow(1);
+            const mappedHeaderStyle = (0, style_1.mapStyle)(def.header.style);
+            headerRow.eachCell((cell) => {
+                cell.style = { ...cell.style, ...mappedHeaderStyle };
+            });
+        }
+        // 4. Apply Vertical Merges
+        def.columns.forEach((col, colIndex) => {
+            if (col.merge === 'vertical') {
+                let startRow = 2; // 1-based, skip header (row 1)
+                let previousValue = null;
+                // Iterate from first data row to last
+                for (let i = 0; i < data.length; i++) {
+                    const currentRowIndex = i + 2;
+                    const cell = sheet.getCell(currentRowIndex, colIndex + 1);
+                    const currentValue = cell.value;
+                    if (i === 0) {
+                        previousValue = currentValue;
+                        continue;
+                    }
+                    // If value changed or it's the last row, process the merge
+                    if (currentValue !== previousValue) {
+                        if (currentRowIndex - 1 > startRow) {
+                            sheet.mergeCells(startRow, colIndex + 1, currentRowIndex - 1, colIndex + 1);
+                        }
+                        startRow = currentRowIndex;
+                        previousValue = currentValue;
+                    }
+                }
+                // Handle the last group
+                const lastRowIndex = data.length + 1;
+                if (lastRowIndex > startRow) {
+                    sheet.mergeCells(startRow, colIndex + 1, lastRowIndex, colIndex + 1);
+                }
+            }
+        });
+        // 5. Apply Borders
+        if (def.borders === 'all') {
+            sheet.eachRow((row) => {
+                row.eachCell((cell) => {
+                    cell.border = {
+                        top: { style: 'thin' },
+                        left: { style: 'thin' },
+                        bottom: { style: 'thin' },
+                        right: { style: 'thin' }
+                    };
+                });
+            });
+        }
+        else if (def.borders === 'outer') {
+            const lastRow = sheet.rowCount;
+            const lastCol = sheet.columnCount;
+            // Top & Bottom
+            for (let c = 1; c <= lastCol; c++) {
+                const topCell = sheet.getCell(1, c);
+                topCell.border = { ...topCell.border, top: { style: 'thin' } };
+                const bottomCell = sheet.getCell(lastRow, c);
+                bottomCell.border = { ...bottomCell.border, bottom: { style: 'thin' } };
+            }
+            // Left & Right
+            for (let r = 1; r <= lastRow; r++) {
+                const leftCell = sheet.getCell(r, 1);
+                leftCell.border = { ...leftCell.border, left: { style: 'thin' } };
+                const rightCell = sheet.getCell(r, lastCol);
+                rightCell.border = { ...rightCell.border, right: { style: 'thin' } };
+            }
+        }
+        else if (def.borders === 'header-body') {
+            const lastCol = sheet.columnCount;
+            for (let c = 1; c <= lastCol; c++) {
+                const headerCell = sheet.getCell(1, c);
+                headerCell.border = { ...headerCell.border, bottom: { style: 'medium' } };
+            }
+        }
+        return this;
+    }
+    async save(path, options) {
+        if (!path || path.trim() === '') {
+            throw new Error('File path cannot be empty.');
+        }
+        if (typeof process !== 'undefined' && process.versions && process.versions.node) {
+            const timeout = options?.timeout ?? 10000; // Default 10s
+            const writePromise = this.workbook.xlsx.writeFile(path);
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error(`Operation timed out after ${timeout}ms`)), timeout);
+            });
+            await Promise.race([writePromise, timeoutPromise]);
+        }
+        else {
+            throw new Error('File system access is only available in Node.js environment. Use saveToBuffer() instead.');
+        }
+    }
+    async saveToBuffer(options) {
+        const timeout = options?.timeout ?? 10000; // Default 10s
+        const writePromise = this.workbook.xlsx.writeBuffer();
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error(`Operation timed out after ${timeout}ms`)), timeout);
+        });
+        const buffer = await Promise.race([writePromise, timeoutPromise]);
+        return new Uint8Array(buffer);
+    }
+    async download(filename, options) {
+        if (typeof window === 'undefined' || typeof document === 'undefined') {
+            throw new Error('download() is only available in browser environment. Use save() for Node.js or saveToBuffer() for custom handling.');
+        }
+        const buffer = await this.saveToBuffer(options);
+        const blob = new Blob([buffer.buffer], {
+            type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+        });
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.href = url;
+        a.download = filename;
+        a.click();
+        URL.revokeObjectURL(url);
+    }
+}
+exports.XLKit = XLKit;
+function createWorkbook() {
+    return new XLKit();
+}
+function defineSheet(def) {
+    return def;
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './Sheetflow';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./Sheetflow"), exports);

package/dist/types.d.ts

@@ -0,0 +1,43 @@
+import { Alignment, Border, Fill, Font } from 'exceljs';
+export type HexColor = string;
+export interface XLStyle {
+    font?: Partial<Font> & {
+        color?: HexColor | {
+            argb: string;
+        };
+    };
+    fill?: Partial<Fill> & {
+        color?: HexColor;
+    };
+    alignment?: Partial<Alignment>;
+    border?: Partial<Border> | 'all' | 'outer' | 'header-body' | 'none';
+}
+export interface ColumnDef<T> {
+    key: keyof T;
+    header: string;
+    width?: number | 'auto';
+    merge?: 'vertical';
+    style?: XLStyle | ((val: any, row: T, index: number) => XLStyle);
+    format?: string | ((val: any) => string);
+}
+export interface HeaderConfig {
+    rows: string[];
+    style?: XLStyle;
+    borders?: 'header-body' | 'all' | 'none';
+}
+export interface SheetDef<T> {
+    name: string;
+    columns: ColumnDef<T>[];
+    header?: HeaderConfig;
+    rows?: {
+        style?: (data: T, index: number) => XLStyle;
+    };
+    defaultStyle?: XLStyle;
+    borders?: 'all' | 'outer' | 'header-body' | 'none';
+    autoWidth?: {
+        padding?: number;
+        headerIncluded?: boolean;
+        charWidthConstant?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,QAAQ,GAAG;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;CACrE;AAED,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IACjE,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;CAC1C;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;KAC7C,CAAC;IACF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;IACnD,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH"}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/color.d.ts

@@ -0,0 +1,2 @@
+export declare function toArgb(hex: string): string;
+//# sourceMappingURL=color.d.ts.map

package/dist/utils/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/utils/color.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAY1C"}

package/dist/utils/color.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toArgb = toArgb;
+function toArgb(hex) {
+    if (!hex)
+        return 'FF000000';
+    if (hex.startsWith('#')) {
+        hex = hex.slice(1);
+    }
+    if (hex.length === 3) {
+        hex = hex.split('').map(c => c + c).join('');
+    }
+    if (hex.length === 6) {
+        return 'FF' + hex.toUpperCase();
+    }
+    return hex.toUpperCase(); // Assume already ARGB or invalid
+}

package/dist/utils/style.d.ts

@@ -0,0 +1,4 @@
+import { Style } from 'exceljs';
+import { XLStyle } from '../types';
+export declare function mapStyle(style: XLStyle): Partial<Style>;
+//# sourceMappingURL=style.d.ts.map

package/dist/utils/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../src/utils/style.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAW,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGnC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAqCvD"}

package/dist/utils/style.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapStyle = mapStyle;
+const color_1 = require("./color");
+function mapStyle(style) {
+    const excelStyle = {};
+    if (style.font) {
+        excelStyle.font = { ...style.font };
+        if (typeof style.font.color === 'string') {
+            excelStyle.font.color = { argb: (0, color_1.toArgb)(style.font.color) };
+        }
+    }
+    if (style.fill) {
+        if (style.fill.color) {
+            excelStyle.fill = {
+                type: 'pattern',
+                pattern: 'solid',
+                fgColor: { argb: (0, color_1.toArgb)(style.fill.color) },
+            };
+        }
+        else {
+            // If no color is specified but fill is provided, use it as-is
+            excelStyle.fill = style.fill;
+        }
+    }
+    if (style.alignment) {
+        excelStyle.alignment = style.alignment;
+    }
+    if (style.border) {
+        if (typeof style.border === 'string') {
+            // Presets handled in main logic or expanded here
+            // For now, we'll handle explicit border objects here
+        }
+        else {
+            excelStyle.border = style.border;
+        }
+    }
+    return excelStyle;
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "xlkit",
+  "version": "1.0.3",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "excel",
+    "exceljs",
+    "spreadsheet",
+    "wrapper",
+    "declarative",
+    "schema"
+  ],
+  "author": "",
+  "license": "MIT",
+  "description": "xlkit - Declarative schema-based wrapper for ExcelJS with type safety and intuitive styling",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yn1323/xlkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yn1323/xlkit/issues"
+  },
+  "homepage": "https://github.com/yn1323/xlkit#readme",
+  "dependencies": {
+    "exceljs": "^4.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.12"
+  }
+}