@ciderjs/gasnuki 0.3.0 → 0.3.2

package/README.ja.md

@@ -1,6 +1,6 @@
 # gasnuki
 
-[![Test Coverage](https://img.shields.io/badge/test%20coverage-84.76%25-green)](https://github.com/luthpg/gasnuki)
+[![Test Coverage](https://img.shields.io/badge/test%20coverage-95.1%25-brightgreen)](https://github.com/luthpg/gasnuki)
 [![License](https://img.shields.io/badge/license-ISC-blue.svg)](LICENSE)
 [![npm version](https://img.shields.io/npm/v/@ciderjs/gasnuki.svg)](https://www.npmjs.com/package/@ciderjs/gasnuki)
 [![GitHub issues](https://img.shields.io/github/issues/luthpg/gasnuki.svg)](https://github.com/luthpg/gasnuki/issues)

package/README.md

@@ -1,6 +1,6 @@
 # @ciderjs/gasnuki
 
-[![Test Coverage](https://img.shields.io/badge/test%20coverage-84.76%25-green)](https://github.com/luthpg/gasnuki)
+[![Test Coverage](https://img.shields.io/badge/test%20coverage-95.1%25-brightgreen)](https://github.com/luthpg/gasnuki)
 [![License](https://img.shields.io/badge/license-ISC-blue.svg)](LICENSE)
 [![npm version](https://img.shields.io/npm/v/@ciderjs/gasnuki.svg)](https://www.npmjs.com/package/@ciderjs/gasnuki)
 [![GitHub issues](https://img.shields.io/github/issues/luthpg/gasnuki.svg)](https://github.com/luthpg/gasnuki/issues)

package/dist/cli.cjs

@@ -4,7 +4,7 @@
 const path = require('node:path');
 const commander = require('commander');
 const index = require('./index.cjs');
-const config = require('./shared/gasnuki.CxoM0Mts.cjs');
+const config = require('./shared/gasnuki.BziruiRW.cjs');
 require('chokidar');
 require('consola');
 require('node:fs');
@@ -25,7 +25,7 @@ function _interopNamespaceCompat(e) {
 
 const path__namespace = /*#__PURE__*/_interopNamespaceCompat(path);
 
-const version = "0.3.0";
+const version = "0.3.2";
 
 const parseArgs = async (command) => {
   const cliOpts = command.opts();

package/dist/cli.mjs

@@ -2,14 +2,14 @@
 import * as path from 'node:path';
 import { Command } from 'commander';
 import { generateTypes } from './index.mjs';
-import { l as loadConfig } from './shared/gasnuki.BYl_yopE.mjs';
+import { l as loadConfig } from './shared/gasnuki.CS6ipBfD.mjs';
 import 'chokidar';
 import 'consola';
 import 'node:fs';
 import 'ts-morph';
 import 'jiti';
 
-const version = "0.3.0";
+const version = "0.3.2";
 
 const parseArgs = async (command) => {
   const cliOpts = command.opts();

package/dist/index.cjs

@@ -3,7 +3,7 @@
 const path = require('node:path');
 const chokidar = require('chokidar');
 const consola = require('consola');
-const config = require('./shared/gasnuki.CxoM0Mts.cjs');
+const config = require('./shared/gasnuki.BziruiRW.cjs');
 require('node:fs');
 require('ts-morph');
 require('jiti');

package/dist/index.mjs

@@ -1,8 +1,8 @@
 import * as path from 'node:path';
 import * as chokidar from 'chokidar';
 import { consola } from 'consola';
-import { g as generateAppsScriptTypes } from './shared/gasnuki.BYl_yopE.mjs';
-export { d as defineConfig } from './shared/gasnuki.BYl_yopE.mjs';
+import { g as generateAppsScriptTypes } from './shared/gasnuki.CS6ipBfD.mjs';
+export { d as defineConfig } from './shared/gasnuki.CS6ipBfD.mjs';
 import 'node:fs';
 import 'ts-morph';
 import 'jiti';

package/dist/shared/{gasnuki.CxoM0Mts.cjs → gasnuki.BziruiRW.cjs}

@@ -92,8 +92,13 @@ const generateAppsScriptTypes = async ({
   const methodDefinitions = [];
   const exportedDeclarations = [];
   const exportedDeclarationNames = /* @__PURE__ */ new Set();
-  const exportedFunctions = [];
   for (const sourceFile of sourceFiles) {
+    const filePath = sourceFile.getFilePath().replace(/\\/g, "/");
+    const srcPath = absoluteSrcDir.replace(/\\/g, "/");
+    const projectRelativeSrcPath = path__namespace.join(projectPath, srcDir).replace(/\\/g, "/");
+    if (!filePath.startsWith(srcPath) && !filePath.startsWith(projectRelativeSrcPath)) {
+      continue;
+    }
     for (const iface of sourceFile.getInterfaces()) {
       if (!iface.getName()?.endsWith("_")) {
         exportedDeclarations.push(iface);
@@ -112,7 +117,6 @@ const generateAppsScriptTypes = async ({
         exportedDeclarations.push(func);
         exportedDeclarationNames.add(name);
         methodDefinitions.push(getInterfaceMethodDefinition_(name, func));
-        exportedFunctions.push(func);
       }
     }
     for (const varStmt of sourceFile.getVariableStatements()) {
@@ -124,7 +128,6 @@ const generateAppsScriptTypes = async ({
           exportedDeclarations.push(varDecl);
           exportedDeclarationNames.add(name);
           methodDefinitions.push(getInterfaceMethodDefinition_(name, funcExpr));
-          exportedFunctions.push(funcExpr);
         }
       }
     }
@@ -156,38 +159,18 @@ const generateAppsScriptTypes = async ({
       }
     }
   };
-  const returnValueSymbols = /* @__PURE__ */ new Set();
-  for (const func of exportedFunctions) {
-    collectSymbolsFromType(func.getReturnType(), returnValueSymbols);
-  }
   const symbolsToProcess = /* @__PURE__ */ new Set();
   for (const decl of exportedDeclarations) {
     if (decl.getKind() === tsMorph.SyntaxKind.FunctionDeclaration || decl.getKind() === tsMorph.SyntaxKind.VariableDeclaration && (decl.getInitializer()?.getKind() === tsMorph.SyntaxKind.ArrowFunction || decl.getInitializer()?.getKind() === tsMorph.SyntaxKind.FunctionExpression)) {
       const func = decl.getKind() === tsMorph.SyntaxKind.FunctionDeclaration ? decl : decl.getInitializer();
       const parameters = func.getParameters();
       for (const param of parameters) {
-        const typeRefs = param.getDescendantsOfKind(tsMorph.SyntaxKind.TypeReference);
-        for (const typeRef of typeRefs) {
-          const symbol = typeRef.getType().getAliasSymbol() ?? typeRef.getType().getSymbol();
-          if (symbol) symbolsToProcess.add(symbol);
-        }
-      }
-      const returnTypeNode = func.getReturnTypeNode();
-      if (returnTypeNode) {
-        const typeRefs = returnTypeNode.getDescendantsOfKind(
-          tsMorph.SyntaxKind.TypeReference
-        );
-        for (const typeRef of typeRefs) {
-          const symbol = typeRef.getType().getAliasSymbol() ?? typeRef.getType().getSymbol();
-          if (symbol) symbolsToProcess.add(symbol);
-        }
+        collectSymbolsFromType(param.getType(), symbolsToProcess);
       }
+      const returnType = func.getReturnType();
+      collectSymbolsFromType(returnType, symbolsToProcess);
     } else if (decl.getKind() === tsMorph.SyntaxKind.InterfaceDeclaration || decl.getKind() === tsMorph.SyntaxKind.TypeAliasDeclaration) {
-      const typeRefs = decl.getDescendantsOfKind(tsMorph.SyntaxKind.TypeReference);
-      for (const typeRef of typeRefs) {
-        const symbol = typeRef.getType().getAliasSymbol() ?? typeRef.getType().getSymbol();
-        if (symbol) symbolsToProcess.add(symbol);
-      }
+      collectSymbolsFromType(decl.getType(), symbolsToProcess);
     }
   }
   const importsMap = /* @__PURE__ */ new Map();
@@ -210,31 +193,14 @@ const generateAppsScriptTypes = async ({
       continue;
     }
     const sourceFile = declaration.getSourceFile();
-    if (sourceFile.getFilePath().includes("node_modules")) {
+    const sourceFilePath = sourceFile.getFilePath();
+    if (sourceFilePath.includes("node_modules")) {
       continue;
     }
     processedSymbols.add(symbolName);
-    const isLocalDefinition = declaration.getParent()?.getKind() !== tsMorph.SyntaxKind.SourceFile;
-    if (isLocalDefinition) {
-      if (returnValueSymbols.has(symbol)) {
-        const declText = declaration.getText();
-        inlineDefinitions.set(symbolName, declText);
-        const tempSourceFile = project.createSourceFile(
-          `__temp_${symbolName}.ts`,
-          declText
-        );
-        for (const descendant of tempSourceFile.getDescendantsOfKind(
-          tsMorph.SyntaxKind.TypeReference
-        )) {
-          const newSymbol = descendant.getType().getAliasSymbol() ?? descendant.getType().getSymbol();
-          if (newSymbol) {
-            symbolsToProcess.add(newSymbol);
-          }
-        }
-        tempSourceFile.delete();
-      }
-    } else {
-      let modulePath = path__namespace.relative(absoluteOutDir, sourceFile.getFilePath()).replace(/\\/g, "/");
+    const isExternal = !sourceFilePath.replace(/\\/g, "/").startsWith(absoluteSrcDir.replace(/\\/g, "/")) && !sourceFilePath.replace(/\\/g, "/").startsWith(path__namespace.join(projectPath, srcDir).replace(/\\/g, "/"));
+    if (isExternal) {
+      let modulePath = path__namespace.relative(absoluteOutDir, sourceFilePath).replace(/\\/g, "/");
       modulePath = modulePath.replace(/\.(d\.)?ts$/, "");
       if (modulePath.endsWith("/index")) {
         modulePath = modulePath.slice(0, -6);
@@ -249,6 +215,17 @@ const generateAppsScriptTypes = async ({
         importsMap.set(modulePath, /* @__PURE__ */ new Set());
       }
       importsMap.get(modulePath)?.add(symbolName);
+    } else {
+      const declText = declaration.getText();
+      inlineDefinitions.set(symbolName, declText);
+    }
+    for (const descendant of declaration.getDescendantsOfKind(
+      tsMorph.SyntaxKind.TypeReference
+    )) {
+      const newSymbol = descendant.getType().getAliasSymbol() ?? descendant.getType().getSymbol();
+      if (newSymbol) {
+        symbolsToProcess.add(newSymbol);
+      }
     }
   }
   if (!fs__namespace.existsSync(absoluteOutDir)) {

package/dist/shared/{gasnuki.BYl_yopE.mjs → gasnuki.CS6ipBfD.mjs}

@@ -75,8 +75,13 @@ const generateAppsScriptTypes = async ({
   const methodDefinitions = [];
   const exportedDeclarations = [];
   const exportedDeclarationNames = /* @__PURE__ */ new Set();
-  const exportedFunctions = [];
   for (const sourceFile of sourceFiles) {
+    const filePath = sourceFile.getFilePath().replace(/\\/g, "/");
+    const srcPath = absoluteSrcDir.replace(/\\/g, "/");
+    const projectRelativeSrcPath = path.join(projectPath, srcDir).replace(/\\/g, "/");
+    if (!filePath.startsWith(srcPath) && !filePath.startsWith(projectRelativeSrcPath)) {
+      continue;
+    }
     for (const iface of sourceFile.getInterfaces()) {
       if (!iface.getName()?.endsWith("_")) {
         exportedDeclarations.push(iface);
@@ -95,7 +100,6 @@ const generateAppsScriptTypes = async ({
         exportedDeclarations.push(func);
         exportedDeclarationNames.add(name);
         methodDefinitions.push(getInterfaceMethodDefinition_(name, func));
-        exportedFunctions.push(func);
       }
     }
     for (const varStmt of sourceFile.getVariableStatements()) {
@@ -107,7 +111,6 @@ const generateAppsScriptTypes = async ({
           exportedDeclarations.push(varDecl);
           exportedDeclarationNames.add(name);
           methodDefinitions.push(getInterfaceMethodDefinition_(name, funcExpr));
-          exportedFunctions.push(funcExpr);
         }
       }
     }
@@ -139,38 +142,18 @@ const generateAppsScriptTypes = async ({
       }
     }
   };
-  const returnValueSymbols = /* @__PURE__ */ new Set();
-  for (const func of exportedFunctions) {
-    collectSymbolsFromType(func.getReturnType(), returnValueSymbols);
-  }
   const symbolsToProcess = /* @__PURE__ */ new Set();
   for (const decl of exportedDeclarations) {
     if (decl.getKind() === SyntaxKind.FunctionDeclaration || decl.getKind() === SyntaxKind.VariableDeclaration && (decl.getInitializer()?.getKind() === SyntaxKind.ArrowFunction || decl.getInitializer()?.getKind() === SyntaxKind.FunctionExpression)) {
       const func = decl.getKind() === SyntaxKind.FunctionDeclaration ? decl : decl.getInitializer();
       const parameters = func.getParameters();
       for (const param of parameters) {
-        const typeRefs = param.getDescendantsOfKind(SyntaxKind.TypeReference);
-        for (const typeRef of typeRefs) {
-          const symbol = typeRef.getType().getAliasSymbol() ?? typeRef.getType().getSymbol();
-          if (symbol) symbolsToProcess.add(symbol);
-        }
-      }
-      const returnTypeNode = func.getReturnTypeNode();
-      if (returnTypeNode) {
-        const typeRefs = returnTypeNode.getDescendantsOfKind(
-          SyntaxKind.TypeReference
-        );
-        for (const typeRef of typeRefs) {
-          const symbol = typeRef.getType().getAliasSymbol() ?? typeRef.getType().getSymbol();
-          if (symbol) symbolsToProcess.add(symbol);
-        }
+        collectSymbolsFromType(param.getType(), symbolsToProcess);
       }
+      const returnType = func.getReturnType();
+      collectSymbolsFromType(returnType, symbolsToProcess);
     } else if (decl.getKind() === SyntaxKind.InterfaceDeclaration || decl.getKind() === SyntaxKind.TypeAliasDeclaration) {
-      const typeRefs = decl.getDescendantsOfKind(SyntaxKind.TypeReference);
-      for (const typeRef of typeRefs) {
-        const symbol = typeRef.getType().getAliasSymbol() ?? typeRef.getType().getSymbol();
-        if (symbol) symbolsToProcess.add(symbol);
-      }
+      collectSymbolsFromType(decl.getType(), symbolsToProcess);
     }
   }
   const importsMap = /* @__PURE__ */ new Map();
@@ -193,31 +176,14 @@ const generateAppsScriptTypes = async ({
       continue;
     }
     const sourceFile = declaration.getSourceFile();
-    if (sourceFile.getFilePath().includes("node_modules")) {
+    const sourceFilePath = sourceFile.getFilePath();
+    if (sourceFilePath.includes("node_modules")) {
       continue;
     }
     processedSymbols.add(symbolName);
-    const isLocalDefinition = declaration.getParent()?.getKind() !== SyntaxKind.SourceFile;
-    if (isLocalDefinition) {
-      if (returnValueSymbols.has(symbol)) {
-        const declText = declaration.getText();
-        inlineDefinitions.set(symbolName, declText);
-        const tempSourceFile = project.createSourceFile(
-          `__temp_${symbolName}.ts`,
-          declText
-        );
-        for (const descendant of tempSourceFile.getDescendantsOfKind(
-          SyntaxKind.TypeReference
-        )) {
-          const newSymbol = descendant.getType().getAliasSymbol() ?? descendant.getType().getSymbol();
-          if (newSymbol) {
-            symbolsToProcess.add(newSymbol);
-          }
-        }
-        tempSourceFile.delete();
-      }
-    } else {
-      let modulePath = path.relative(absoluteOutDir, sourceFile.getFilePath()).replace(/\\/g, "/");
+    const isExternal = !sourceFilePath.replace(/\\/g, "/").startsWith(absoluteSrcDir.replace(/\\/g, "/")) && !sourceFilePath.replace(/\\/g, "/").startsWith(path.join(projectPath, srcDir).replace(/\\/g, "/"));
+    if (isExternal) {
+      let modulePath = path.relative(absoluteOutDir, sourceFilePath).replace(/\\/g, "/");
       modulePath = modulePath.replace(/\.(d\.)?ts$/, "");
       if (modulePath.endsWith("/index")) {
         modulePath = modulePath.slice(0, -6);
@@ -232,6 +198,17 @@ const generateAppsScriptTypes = async ({
         importsMap.set(modulePath, /* @__PURE__ */ new Set());
       }
       importsMap.get(modulePath)?.add(symbolName);
+    } else {
+      const declText = declaration.getText();
+      inlineDefinitions.set(symbolName, declText);
+    }
+    for (const descendant of declaration.getDescendantsOfKind(
+      SyntaxKind.TypeReference
+    )) {
+      const newSymbol = descendant.getType().getAliasSymbol() ?? descendant.getType().getSymbol();
+      if (newSymbol) {
+        symbolsToProcess.add(newSymbol);
+      }
     }
   }
   if (!fs.existsSync(absoluteOutDir)) {

package/dist/vite.cjs

@@ -2,7 +2,7 @@
 
 const path = require('node:path');
 const consola = require('consola');
-const config = require('./shared/gasnuki.CxoM0Mts.cjs');
+const config = require('./shared/gasnuki.BziruiRW.cjs');
 require('node:fs');
 require('ts-morph');
 require('jiti');

package/dist/vite.mjs

@@ -1,6 +1,6 @@
 import * as path from 'node:path';
 import { consola } from 'consola';
-import { l as loadConfig, g as generateAppsScriptTypes } from './shared/gasnuki.BYl_yopE.mjs';
+import { l as loadConfig, g as generateAppsScriptTypes } from './shared/gasnuki.CS6ipBfD.mjs';
 import 'node:fs';
 import 'ts-morph';
 import 'jiti';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ciderjs/gasnuki",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Type definitions and utilities for Google Apps Script client-side API",
   "main": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -36,6 +36,7 @@
     "test:coverage:update": "pnpm test:coverage && pnpm update-coverage-badge",
     "prepublish": "pnpm run generate && pnpm run check && pnpm run test:coverage:update && pnpm run build",
     "pg:react": "pnpm -C playground/react",
+    "pg:react-vite": "pnpm -C playground/react-with-vite-plugin",
     "pg:vue": "pnpm -C playground/vue3"
   },
   "keywords": [
@@ -62,7 +63,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.2.6",
-    "@types/node": "^24.7.2",
+    "@types/node": "^24.8.1",
     "@vitest/coverage-v8": "3.2.4",
     "typescript": "^5.9.3",
     "unbuild": "^3.6.1",

package/.docs/vite-plugin/design.md

@@ -1,220 +0,0 @@
-# `@ciderjs/gasnuki` Viteプラグイン 設計書
-
-## 1. はじめに
-
-### 1.1. 目的
-
-本ドキュメントは、先に作成された「`@ciderjs/gasnuki` Viteプラグイン機能追加 要件定義書」に基づき、Viteプラグイン機能の具体的なアーキテクチャ、実装詳細、データ構造などを定義することを目的とする。
-
-### 1.2. 対象読者
-
-`@ciderjs/gasnuki` の開発者およびコントリビューターを対象とする。
-
-## 2. アーキテクチャ概要
-
-`@ciderjs/gasnuki` のViteプラグインは、Viteの開発サーバーのライフサイクルにフックすることで動作する。既存の型生成コアロジック (`generateAppsScriptTypes`) を再利用し、Viteの開発環境とシームレスに連携する。
-
-### 2.1. 構成図
-
-```mermaid
-graph TD
-    subgraph Vite開発環境
-        A[vite.config.ts] --> B(Vite Dev Server);
-        B -- 起動 --> C{gasnuki Plugin};
-        B -- ファイル変更通知 --> C;
-    end
-
-    subgraph gasnuki Plugin
-        C -- configResolvedフック --> D[設定解決ロジック];
-        C -- configureServerフック --> E[初回生成 & ウォッチャー設定];
-        E -- ファイル変更イベント --> F[型再生成トリガー];
-    end
-
-    subgraph gasnuki コアモジュール
-        G[./modules/config.ts];
-        H[./modules/generate.ts];
-    end
-
-    D -- 読み込み --> G;
-    E -- 実行 --> H;
-    F -- 実行 --> H;
-
-    style Vite開発環境 fill:#e6f2ff,stroke:#b3d9ff
-    style gasnukiコアモジュール fill:#fff2e6,stroke:#ffdab3
-```
-
-### 2.2. 処理フロー
-
-1.  **設定解決**: Vite開発サーバー起動時、`configResolved` フックが発火。Viteの設定情報 (`config.root`) を元にプロジェクトルートを特定し、プラグインオプション、`gasnuki.config.ts`、デフォルト値をマージして最終的な設定を確定する。
-2.  **初回生成**: `configureServer` フックで、開発サーバーの起動処理の一環として、型定義の初回生成 (`generateAppsScriptTypes`) を実行する。
-3.  **ファイル監視と再生成**: 同じく `configureServer` フック内で、Viteのファイルウォッチャー (`server.watcher`) を利用して、設定されたソースディレクトリ (`srcDir`) を監視する。ファイルの追加・変更・削除を検知すると、再度 `generateAppsScriptTypes` を実行して型定義を更新する。
-
-## 3. ファイル構成
-
-| ファイルパス         | 状態 | 役割                                                                                                |
-| :------------------- | :--- | :-------------------------------------------------------------------------------------------------- |
-| `src/vite.ts`        | 新規 | Viteプラグインのロジックを実装する。プラグインのファクトリ関数 `gasnuki()` をエクスポートする。         |
-| `package.json`       | 変更 | `exports` フィールドに `./vite` エントリーポイントを追加し、Viteプラグインを外部から利用可能にする。    |
-| `build.config.ts`    | 変更 | `unbuild` のビルド対象に `src/vite.ts` を追加する。                                                   |
-| `src/modules/generate.ts` | 変更 | (必要であれば) Vite環境でのロギングやエラーハンドリングを改善するために軽微な修正を行う可能性がある。 |
-| `src/modules/config.ts`   | 変更なし | 既存のコンフィグローダーをそのまま利用する。                                                        |
-
-## 4. 詳細設計
-
-### 4.1. Viteプラグインエントリーポイント (`src/vite.ts`)
-
-プラグインは `gasnuki(options?: UserConfig): Plugin` というファクトリ関数として提供する。
-
-```typescript:gasnuki Vite Plugin:src/vite.ts
-import type { Plugin, ResolvedConfig, ViteDevServer } from 'vite';
-import * as path from 'node:path';
-import { consola } from 'consola';
-import { generateAppsScriptTypes } from './modules/generate';
-import { loadConfig, type UserConfig } from './modules/config';
-import type { GenerateOptions } from './index';
-
-/**
- * A factory function to create the gasnuki Vite plugin.
- * @param options - The user-defined configuration for gasnuki.
- * @returns The Vite plugin object.
- */
-export function gasnuki(options?: UserConfig): Plugin {
-  let projectRoot: string;
-  let gasnukiOptions: Omit<GenerateOptions, 'watch' | 'project'>;
-
-  // Debounce mechanism to prevent rapid-fire regeneration
-  let debounceTimer: NodeJS.Timeout | null = null;
-  const debounce = (func: () => void, timeout = 300) => {
-    if (debounceTimer) {
-      clearTimeout(debounceTimer);
-    }
-    debounceTimer = setTimeout(func, timeout);
-  };
-
-  const runGeneration = (triggeredBy?: string) => {
-    debounce(async () => {
-      const reason = triggeredBy ? ` (triggered by: ${triggeredBy})` : '';
-      consola.info(`[gasnuki] Generating AppsScript types${reason}...`);
-      try {
-        await generateAppsScriptTypes({
-          ...gasnukiOptions,
-          project: projectRoot,
-        });
-        consola.success('[gasnuki] Type generation complete.');
-      } catch (e) {
-        consola.error(`[gasnuki] Type generation failed: ${(e as Error).message}`);
-      }
-    });
-  };
-
-  return {
-    name: 'vite-plugin-gasnuki',
-    apply: 'serve', // Apply only in serve mode
-
-    async configResolved(config: ResolvedConfig) {
-      projectRoot = config.root;
-      const fileConfig = await loadConfig(projectRoot);
-      const defaultOptions: Partial<GenerateOptions> = {
-        srcDir: 'server',
-        outDir: 'types',
-        outputFile: 'appsscript.ts',
-      };
-      gasnukiOptions = {
-        ...defaultOptions,
-        ...fileConfig,
-        ...(options || {}),
-      };
-    },
-
-    async configureServer(server: ViteDevServer) {
-      const targetDir = path.resolve(projectRoot, gasnukiOptions.srcDir);
-
-      // Initial generation on server startup
-      runGeneration('server startup');
-
-      // Watch for file changes
-      server.watcher.on('all', (event, filePath) => {
-        // Normalize paths for reliable comparison
-        const normalizedFilePath = path.normalize(filePath);
-        const normalizedTargetDir = path.normalize(targetDir);
-
-        if (normalizedFilePath.startsWith(normalizedTargetDir)) {
-          runGeneration(path.relative(projectRoot, filePath));
-        }
-      });
-    },
-  };
-}
-```
-
-### 4.2. 設定解決ロジック (`configResolved` フック内)
-
-1.  `config.root` からプロジェクトのルートパスを取得する。
-2.  既存の `loadConfig(projectRoot)` を呼び出し、`gasnuki.config.ts` の内容を読み込む。
-3.  以下の優先順位で設定をマージし、`gasnukiOptions` として内部に保持する。
-    1.  **高**: `vite.config.ts` でプラグインに渡された `options`
-    2.  **中**: `gasnuki.config.ts` の内容
-    3.  **低**: プラグイン内部で定義されたデフォルト値 (`srcDir`, `outDir`, `outputFile`)
-
-### 4.3. ファイル監視ロジック (`configureServer` フック内)
-
--   Viteの `server.watcher` を利用することで、`chokidar` を直接依存関係に追加する必要はない。
--   `on('all', callback)` を使用し、ファイルの追加(`add`)、変更(`change`)、削除(`unlink`) すべてのイベントを捕捉する。
--   イベントのコールバック内で、変更されたファイルパスが `gasnukiOptions.srcDir` 内に存在するかをチェックし、関係のないファイルの変更で再生成が走らないようにする。
--   頻繁なファイル変更による過剰な再生成を防ぐため、300ms程度のデバウンス処理を実装する。
-
-## 5. データ構造・インターフェース
-
-### 5.1. `UserConfig` (既存)
-
-既存の `UserConfig` 型をそのままプラグインオプションの型として利用する。
-
-```typescript
-// src/modules/config.ts (既存)
-export type UserConfig = Partial<Omit<GenerateOptions, 'watch' | 'project'>>;
-```
-
-## 6. シーケンス図
-
-### 6.1. 開発サーバー起動時
-
-```mermaid
-sequenceDiagram
-    participant User
-    participant Vite
-    participant gasnukiPlugin as gasnuki Plugin
-    participant Core as gasnuki Core
-
-    User->>Vite: `vite dev` を実行
-    Vite->>gasnukiPlugin: configResolved フックを呼び出し
-    gasnukiPlugin->>Core: loadConfig()
-    Core-->>gasnukiPlugin: 設定ファイルを返す
-    gasnukiPlugin->>gasnukiPlugin: 設定をマージ
-    Vite->>gasnukiPlugin: configureServer フックを呼び出し
-    gasnukiPlugin->>gasnukiPlugin: runGeneration('server startup')
-    gasnukiPlugin->>Core: generateAppsScriptTypes()
-    Core-->>gasnukiPlugin: 生成完了
-    Note right of gasnukiPlugin: ファイルウォッチャーを設定
-```
-
-### 6.2. ファイル変更時
-
-```mermaid
-sequenceDiagram
-    participant User
-    participant ViteWatcher
-    participant gasnukiPlugin as gasnuki Plugin
-    participant Core as gasnuki Core
-
-    User->>ViteWatcher: ソースファイルを変更・保存
-    ViteWatcher->>gasnukiPlugin: 'all' イベントを発火
-    gasnukiPlugin->>gasnukiPlugin: runGeneration('path/to/file.ts')
-    Note right of gasnukiPlugin: (デバウンス処理)
-    gasnukiPlugin->>Core: generateAppsScriptTypes()
-    Core-->>gasnukiPlugin: 再生成完了
-```
-
-## 7. その他考慮事項
-
--   **エラー表示**: `generateAppsScriptTypes` が例外をスローした場合、`consola.error` を使用してViteのコンソールにスタックトレースを含む詳細なエラー情報を出力する。これにより、開発者はエラーの原因を特定しやすくなる。
--   **テスト**: Viteプラグインの動作を検証するための単体テスト・結合テストを追加する。`vite` を `devDependencies` に追加し、テスト環境内でViteサーバーをプログラム的に起動してプラグインの各フックが正しく動作するかを確認する。

package/.docs/vite-plugin/requirements.md

@@ -1,72 +0,0 @@
-# `@ciderjs/gasnuki` Viteプラグイン機能追加 要件定義書
-
-## 1. 概要
-
-本ドキュメントは、npmパッケージ `@ciderjs/gasnuki` にViteプラグイン機能を追加するための要件を定義するものである。
-
-## 2. 背景・目的
-
-`@ciderjs/gasnuki` は、Google Apps Script (GAS) のサーバーサイドコードからTypeScriptの型定義を生成するCLIツールである。現状では、開発者はCLIを単独で、または `--watch` モードで実行する必要がある。
-
-Viteを利用したフロントエンド開発プロジェクトにおいて、`vite dev` コマンドによる開発サーバーのライフサイクルと `gasnuki` の型生成プロセスを連携させることで、以下の目的を達成する。
-
--   **開発体験の向上**: 開発者は `vite dev` を実行するだけで、GASコードの変更が自動的にクライアントサイドの型定義に反映されるようになり、手動でのコマンド実行や別プロセスの管理が不要になる。
--   **設定の統合**: `gasnuki` に関する設定を `vite.config.ts` 内に集約し、プロジェクト設定の一元管理を促進する。
--   **シームレスな統合**: Viteの開発エコシステムに `gasnuki` をスムーズに統合し、導入のハードルを下げる。
-
-## 3. スコープ
-
-### 3.1. スコープ内
-
--   Viteの開発サーバー (`vite dev` / `serve`) 実行時に動作するViteプラグインの開発。
--   プラグイン経由での `gasnuki` の設定。
--   開発サーバー起動時の初回型定義生成。
--   ソースファイルの変更を監視し、型定義を自動で再生成する機能。
-
-### 3.2. スコープ外
-
--   Viteのビルドプロセス (`vite build`) へのフック。`gasnuki` は開発時の型安全性を目的とするため、本番ビルドには関与しない。
--   CLI機能の変更・廃止。既存のCLI機能はそのまま維持する。
-
-## 4. 機能要件
-
-| ID   | 機能名                         | 種別 | 概要                                                                                                                                                                                                             |
-| :--- | :----------------------------- | :--- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| F-01 | **プラグインインターフェース** | 新規 | `import { gasnuki } from '@ciderjs/gasnuki/vite'` のようにインポートできるエントリーポイントを提供する。<br>プラグインは `gasnuki(options?: UserConfig)` という形式のファクトリ関数として提供する。              |
-| F-02 | **設定の解決**                 | 変更 | プラグインに `options` が渡された場合はその設定を優先する。<br>`options` がない場合は、プロジェクトルートの `gasnuki.config.ts` 等を自動で読み込む。<br>プロジェクトルートの特定にはViteのコンフィグを利用する。 |
-| F-03 | **初回型定義生成**             | 新規 | `vite dev` コマンドで開発サーバーが起動する際に、型定義の生成処理を一度実行する。                                                                                                                                |
-| F-04 | **ファイル変更時の自動再生成** | 新規 | 開発サーバーの起動中、設定された `srcDir` 内の `.ts` ファイルの変更（追加・更新・削除）を監視し、変更があった場合に型定義の再生成を自動で実行する。                                                              |
-| F-05 | **既存機能との連携**           | 変更 | 型定義の生成ロジック (`generateAppsScriptTypes`) や設定ファイルの読み込みロジック (`loadConfig`) など、既存のコア機能を再利用して実装する。                                                                      |
-
-## 5. 非機能要件
-
-| ID    | 要件項目           | 概要                                                                                                   |
-| :---- | :----------------- | :----------------------------------------------------------------------------------------------------- |
-| NF-01 | **パフォーマンス** | ファイル変更時の再生成処理が、開発サーバーの応答性やパフォーマンスに大きな影響を与えないこと。         |
-| NF-02 | **ユーザビリティ** | `vite.config.ts` に数行追加するだけで導入できる、シンプルで分かりやすいAPIを提供すること。             |
-| NF-03 | **フィードバック** | 型定義の生成・再生成の開始、成功、エラー発生時には、Viteのコンソールに適切なメッセージを出力すること。 |
-| NF-04 | **互換性**         | 既存のCLI機能とViteプラグイン機能が共存でき、互いに影響を与えないこと。                                |
-
-## 6. 実装方針
-
-### 6.1. パッケージ構成
-
--   プラグインのロジックを実装するファイル (例: `src/vite.ts`) を新設する。
--   `package.json` の `exports` フィールドに、Viteプラグイン用のエントリーポイント (例: `./vite`) を追加する。
--   ビルド設定 (`build.config.ts`) を更新し、Viteプラグイン用のファイルを成果物として出力する。
-
-### 6.2. Viteプラグインフックの利用
-
--   **`name`**: プラグインを識別するための一意な名前 (例: `vite-plugin-gasnuki`) を設定する。
--   **`apply: 'serve'`**: 開発サーバーでのみプラグインが動作するように制限する。
--   **`configResolved(config)`**: Viteの設定が解決された後に呼び出されるフック。`config.root` を基準にプロジェクトルートを特定し、`gasnuki` の最終的な設定オブジェクトをここで確定させる。
--   **`configureServer(server)`**: 開発サーバーが構成された際に呼び出されるフック。
-    -   サーバー起動処理の一環として、初回の型生成処理を非同期で実行する。
-    -   `server.watcher` (Viteが内部で使用する `chokidar` インスタンス) を利用して、対象ソースファイルの変更イベントを購読する。
-    -   ファイル変更イベント発生時に、型定義の再生成処理を呼び出す。
-
-## 7. ドキュメント
-
--   `README.md` および `README.ja.md` を更新し、「Viteプラグインとしての利用」のセクションを追加する。
-    -   `vite.config.ts` への基本的な設定例を記載する。
-    -   プラグインに渡せるオプションについて説明する。