@nx-ddd/excel 0.0.1

package/README.md

@@ -0,0 +1,123 @@
+# @nx-ddd/excel
+
+Excel操作のためのDDDベースのライブラリ
+
+## ディレクトリ構成
+
+```
+src/lib/
+├── domain/          # ドメイン層（インターフェース定義）
+│   └── index.ts
+├── infra/           # インフラストラクチャ層（実装）
+│   ├── excel.repository.impl.ts
+│   └── excel.repository.impl.spec.ts
+├── impl/            # サービス実装
+│   ├── excel.service.impl.ts
+│   └── excel.service.impl.spec.ts
+├── providers/       # DI設定
+│   └── excel.providers.ts
+├── tokens/          # InjectionToken定義
+│   └── excel.token.ts
+├── __mocks__/       # テスト用モック
+│   ├── fs.ts
+│   ├── path.ts
+│   └── xlsx.ts
+├── excel.converter.ts     # データ変換ユーティリティ
+├── excel.decorators.ts    # デコレーター
+├── excel.repository.ts    # リポジトリの再エクスポート
+└── excel.service.ts       # サービスインターフェース
+```
+
+## 使用方法
+
+### 1. DIの設定
+
+```typescript
+import { provideExcelService } from '@nx-ddd/excel/providers';
+
+// Angularアプリケーション
+@NgModule({
+  providers: [
+    ...provideExcelService()
+  ]
+})
+export class AppModule {}
+
+// スタンドアロンアプリケーション
+bootstrapApplication(AppComponent, {
+  providers: [
+    ...provideExcelService()
+  ]
+});
+```
+
+### 2. サービスの使用
+
+```typescript
+import { inject } from '@angular/core';
+import { EXCEL_SERVICE } from '@nx-ddd/excel/tokens';
+
+@Injectable()
+export class MyService {
+  private readonly excelService = inject(EXCEL_SERVICE);
+
+  async exportData() {
+    await this.excelService.writeSheet(
+      'output.xlsx',
+      'Sheet1',
+      data,
+      ['Column1', 'Column2']
+    );
+  }
+
+  async importData() {
+    const data = await this.excelService.readSheet('input.xlsx', 'Sheet1');
+    return data;
+  }
+}
+```
+
+### 3. リポジトリの使用
+
+```typescript
+import { getExcelRepository } from '@nx-ddd/excel';
+
+// エンティティクラス
+@Excel.Sheet('Users')
+class User {
+  @Excel.Column('名前')
+  name: string;
+  
+  @Excel.Column('メール')
+  email: string;
+}
+
+// リポジトリの取得
+const userRepo = getExcelRepository(User, {
+  path: 'users.xlsx',
+  sheetName: 'Users'
+});
+
+// データの保存
+await userRepo.saveMany(users);
+
+// データの読み込み
+const users = await userRepo.list();
+```
+
+## テスト
+
+```bash
+nx test @nx-ddd/excel
+```
+
+## エクスポート構成
+
+- `@nx-ddd/excel` - メインエクスポート
+- `@nx-ddd/excel/providers` - DI設定
+- `@nx-ddd/excel/tokens` - InjectionToken
+- `@nx-ddd/excel/impl` - 実装詳細（通常は直接使用しない）
+
+## Building
+
+Run `nx build @nx-ddd/excel` to build the library.

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@nx-ddd/excel",
+  "version": "0.0.1",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./providers": {
+      "types": "./src/lib/providers/index.d.ts",
+      "default": "./src/lib/providers/index.js"
+    },
+    "./tokens": {
+      "types": "./src/lib/tokens/index.d.ts",
+      "default": "./src/lib/tokens/index.js"
+    },
+    "./impl": {
+      "types": "./src/lib/impl/index.d.ts",
+      "default": "./src/lib/impl/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/src/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/excel"), exports);
+//# sourceMappingURL=index.js.map