@shirokuma-library/shirokuma-docs 0.1.0-alpha.5

package/dist/parsers/feature-map-tags.js

@@ -0,0 +1,292 @@
+/**
+ * feature-map JSDoc タグパーサー
+ *
+ * TypeScript ファイルから feature-map 用のカスタム JSDoc タグを解析し、
+ * FeatureMapItem に変換する。
+ */
+import { inferAppFromPath } from "../utils/app-inference.js";
+import { inferActionTypeFromPath } from "../utils/action-inference.js";
+import { isComponentFile } from "../analyzers/reference-analyzer.js";
+import { extractExportedComponentName } from "../parsers/jsdoc-common.js";
+import { extractTags, extractDescription, parseCommaSeparatedList } from "./feature-map-utils.js";
+import { extractExportedTypes, extractExportedUtilities } from "./feature-map-type-extraction.js";
+/**
+ * ファイルヘッダー領域の終了位置を検出
+ *
+ * @description
+ * ファイルヘッダー領域とは、以下のいずれかが最初に現れるまでの領域:
+ * - "use server" または "use client" ディレクティブ
+ * - import 文
+ * - export 文
+ * - 通常の関数/変数宣言
+ *
+ * ファイルヘッダー内のJSDocコメントは、モジュール全体のドキュメントとして扱い、
+ * 個別のアイテム（Screen/Component/Action）として抽出しない。
+ *
+ * @param content - ファイル内容
+ * @returns ヘッダー領域の終了位置（インデックス）
+ */
+export function findCodeStartIndex(content) {
+    // パターン1: import 文（先頭の空白・コメント無視）
+    const importMatch = content.match(/^(?:\/\/.*\n|\/\*[\s\S]*?\*\/\n|\s)*import\s/m);
+    if (importMatch && importMatch.index !== undefined) {
+        // import文の実際の開始位置を計算（コメント・空白の後）
+        const importStart = importMatch.index + importMatch[0].indexOf('import');
+        return importStart;
+    }
+    // パターン2: export 文
+    const exportMatch = content.match(/^(?:\/\/.*\n|\/\*[\s\S]*?\*\/\n|\s)*export\s/m);
+    if (exportMatch && exportMatch.index !== undefined) {
+        const exportStart = exportMatch.index + exportMatch[0].indexOf('export');
+        return exportStart;
+    }
+    // パターン3: トップレベルの関数/変数宣言
+    const declarationMatch = content.match(/^(?:\/\/.*\n|\/\*[\s\S]*?\*\/\n|\s)*(?:const|let|var|function|class|interface|type|enum)\s/m);
+    if (declarationMatch && declarationMatch.index !== undefined) {
+        const declarationStart = declarationMatch.index + declarationMatch[0].search(/(?:const|let|var|function|class|interface|type|enum)/);
+        return declarationStart;
+    }
+    // コード開始が見つからない場合は0（全てを対象）
+    return 0;
+}
+/**
+ * ファイルヘッダーからメタデータを抽出
+ */
+export function extractFileMetadata(content, codeStartIndex) {
+    const headerContent = content.slice(0, codeStartIndex);
+    // ファイルヘッダー内のJSDocを検索
+    const jsdocMatch = headerContent.match(/\/\*\*[\s\S]*?\*\//);
+    if (!jsdocMatch) {
+        return {};
+    }
+    const jsdocBlock = jsdocMatch[0];
+    const tags = extractTags(jsdocBlock);
+    // parseCommaSeparatedListは空配列を返すため、空の場合はundefinedに変換
+    const toUndefinedIfEmpty = (arr) => arr.length > 0 ? arr : undefined;
+    // モジュール説明を抽出（@description タグまたは先頭の説明文）
+    let moduleDescription = tags.description;
+    if (!moduleDescription) {
+        // @description がない場合は先頭の説明文を使用
+        moduleDescription = extractDescription(jsdocBlock);
+    }
+    return {
+        feature: tags.feature,
+        usedInScreens: toUndefinedIfEmpty(parseCommaSeparatedList(tags.usedInScreen)),
+        // ファイルレベルでは @usedComponents (複数形) を使用
+        usedInComponents: toUndefinedIfEmpty(parseCommaSeparatedList(tags.usedComponents)),
+        dbTables: toUndefinedIfEmpty(parseCommaSeparatedList(tags.dbTables)),
+        moduleDescription,
+        moduleName: tags.module,
+    };
+}
+/**
+ * ファイルから Feature Map タグを解析
+ */
+export function parseFeatureMapTags(content, filePath) {
+    return parseFeatureMapTagsWithMetadata(content, filePath).items;
+}
+/**
+ * ファイルから Feature Map タグを解析（メタデータ付き）
+ */
+export function parseFeatureMapTagsWithMetadata(content, filePath) {
+    const items = [];
+    // ファイルヘッダー領域の終了位置を検出
+    const codeStartIndex = findCodeStartIndex(content);
+    // ファイルヘッダーからメタデータを抽出
+    const fileMetadata = extractFileMetadata(content, codeStartIndex);
+    // エクスポートされた型定義を抽出
+    const types = extractExportedTypes(content);
+    // エクスポートされたユーティリティ（定数・ヘルパー関数）を抽出
+    const utilities = extractExportedUtilities(content);
+    // ファイルヘッダーJSDocから @screen/@component/@module を抽出
+    // (page.tsx など、ファイル全体が1つの画面/コンポーネント/モジュールを表す場合)
+    const headerContent = content.slice(0, codeStartIndex);
+    const headerJsdocMatch = headerContent.match(/\/\*\*[\s\S]*?\*\//);
+    if (headerJsdocMatch) {
+        const headerJsdoc = headerJsdocMatch[0];
+        const headerTags = extractTags(headerJsdoc);
+        // @screen/@component/@module/@serverAction/@dbTable がファイルヘッダーにある場合、アイテムとして追加
+        if (headerTags.screen || headerTags.component || headerTags.module || headerTags.serverAction !== undefined || headerTags.dbTable) {
+            // @serverAction/@dbTable の場合、関数名を抽出するために後続コードを取得
+            let headerItemName;
+            if (headerTags.serverAction !== undefined || headerTags.dbTable) {
+                const headerJsdocIndex = headerContent.indexOf(headerJsdoc);
+                const afterHeaderJsdoc = content.slice(headerJsdocIndex + headerJsdoc.length);
+                headerItemName = extractItemName(afterHeaderJsdoc);
+            }
+            const headerItem = parseJSDocBlock(headerJsdoc, filePath, headerItemName, fileMetadata);
+            if (headerItem) {
+                items.push(headerItem);
+            }
+        }
+        // @component が無いがコンポーネントファイルの場合、自動検出
+        else if (isComponentFile(filePath)) {
+            const autoComponentName = extractExportedComponentName(content);
+            if (autoComponentName) {
+                // 自動検出されたコンポーネントをアイテムとして追加
+                const description = extractDescription(headerJsdoc);
+                const usedComponents = parseCommaSeparatedList(headerTags.usedComponents);
+                const usedActions = parseCommaSeparatedList(headerTags.usedActions);
+                items.push({
+                    type: "component",
+                    name: autoComponentName,
+                    path: filePath,
+                    description: description || undefined,
+                    feature: fileMetadata.feature,
+                    usedInScreens: fileMetadata.usedInScreens || [],
+                    usedInComponents: [],
+                    usedComponents,
+                    usedActions,
+                    app: inferAppFromPath(filePath),
+                });
+            }
+        }
+    }
+    // @component アノテーションもヘッダーJSDocも無いがコンポーネントファイルの場合
+    else if (isComponentFile(filePath)) {
+        const autoComponentName = extractExportedComponentName(content);
+        if (autoComponentName) {
+            items.push({
+                type: "component",
+                name: autoComponentName,
+                path: filePath,
+                feature: undefined,
+                usedInScreens: [],
+                usedInComponents: [],
+                usedComponents: [],
+                usedActions: [],
+                app: inferAppFromPath(filePath),
+            });
+        }
+    }
+    // JSDoc コメントブロックを抽出 (/** ... */)
+    const jsdocRegex = /\/\*\*[\s\S]*?\*\//g;
+    const matches = content.matchAll(jsdocRegex);
+    for (const match of matches) {
+        const jsdocBlock = match[0];
+        const blockStart = match.index || 0;
+        // ファイルヘッダー領域内のJSDocはスキップ（上で処理済み）
+        if (blockStart < codeStartIndex) {
+            continue;
+        }
+        // コメント後のコードを取得 (関数名/変数名を抽出)
+        const afterComment = content.slice(blockStart + jsdocBlock.length);
+        const itemName = extractItemName(afterComment);
+        // タグを解析（ファイルメタデータを継承）
+        const item = parseJSDocBlock(jsdocBlock, filePath, itemName, fileMetadata);
+        if (item) {
+            items.push(item);
+        }
+    }
+    return { items, metadata: fileMetadata, types, utilities };
+}
+/**
+ * コメント後のコードからアイテム名を抽出
+ */
+export function extractItemName(code) {
+    // 関数/コンポーネント名を抽出
+    const patterns = [
+        /export\s+(?:async\s+)?function\s+(\w+)/,
+        /export\s+default\s+(?:async\s+)?function\s+(\w+)/,
+        /export\s+const\s+(\w+)/,
+        /(?:async\s+)?function\s+(\w+)/,
+        /const\s+(\w+)\s*=/,
+    ];
+    for (const pattern of patterns) {
+        const match = code.match(pattern);
+        if (match) {
+            return match[1];
+        }
+    }
+    return undefined;
+}
+/**
+ * JSDoc ブロックを解析（ファイルメタデータ継承版）
+ */
+export function parseJSDocBlock(jsdocBlock, filePath, defaultName, fileMetadata) {
+    // タグを抽出
+    const tags = extractTags(jsdocBlock);
+    // アイテムタイプを判定
+    let type;
+    let name = defaultName;
+    if (tags.screen) {
+        type = "screen";
+        name = tags.screen;
+    }
+    else if (tags.component) {
+        type = "component";
+        name = tags.component;
+    }
+    else if (tags.serverAction !== undefined) {
+        type = "action";
+        // nameはdefaultNameから取得
+    }
+    else if (tags.module) {
+        type = "module";
+        if (defaultName) {
+            name = defaultName.replace(/\//g, "-");
+        }
+        else {
+            const match = filePath.match(/lib\/(\w+)\/(\w+)\.ts$/);
+            if (match) {
+                name = `${match[1]}-${match[2]}`;
+            }
+            else {
+                name = filePath.split("/").pop()?.replace(/\.tsx?$/, "") || "unknown";
+            }
+        }
+    }
+    else if (tags.dbTable) {
+        type = "table";
+        name = tags.dbTable;
+    }
+    // タイプが不明な場合はスキップ
+    if (!type || !name) {
+        return null;
+    }
+    // 説明文を抽出
+    const description = extractDescription(jsdocBlock);
+    // アプリ名を推論
+    const app = inferAppFromPath(filePath);
+    // 基本アイテムを作成
+    const item = {
+        type,
+        name,
+        path: filePath,
+        feature: tags.feature || fileMetadata.feature,
+        description,
+        app,
+    };
+    // タイプ別の追加フィールド（ファイルメタデータを継承）
+    switch (type) {
+        case "screen":
+            item.route = tags.route;
+            item.usedComponents = parseCommaSeparatedList(tags.usedComponents);
+            item.usedActions = parseCommaSeparatedList(tags.usedActions);
+            break;
+        case "component":
+            item.usedInScreens = parseCommaSeparatedList(tags.usedInScreen);
+            item.usedActions = parseCommaSeparatedList(tags.usedActions);
+            break;
+        case "action": {
+            const functionUsedInScreens = parseCommaSeparatedList(tags.usedInScreen);
+            const functionUsedInComponents = parseCommaSeparatedList(tags.usedInComponent);
+            const functionDbTables = parseCommaSeparatedList(tags.dbTables);
+            item.usedInScreens = functionUsedInScreens.length > 0 ? functionUsedInScreens : fileMetadata.usedInScreens;
+            item.usedInComponents = functionUsedInComponents.length > 0 ? functionUsedInComponents : fileMetadata.usedInComponents;
+            item.dbTables = functionDbTables.length > 0 ? functionDbTables : fileMetadata.dbTables;
+            item.actionType = inferActionTypeFromPath(filePath);
+            break;
+        }
+        case "module":
+            item.category = tags.module;
+            item.usedInScreens = parseCommaSeparatedList(tags.usedInScreen);
+            item.usedInActions = parseCommaSeparatedList(tags.usedInActions);
+            break;
+        case "table":
+            item.usedInActions = parseCommaSeparatedList(tags.usedInActions);
+            break;
+    }
+    return item;
+}
+//# sourceMappingURL=feature-map-tags.js.map

package/dist/parsers/feature-map-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-map-tags.js","sourceRoot":"","sources":["../../src/parsers/feature-map-tags.ts"],"names":[],"mappings":"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"}

package/dist/parsers/feature-map-type-extraction.d.ts

@@ -0,0 +1,62 @@
+/**
+ * feature-map 型・ユーティリティ抽出
+ *
+ * TypeScript ソースコードからエクスポートされた型定義
+ * （interface, type, enum）とユーティリティ（定数, 関数）を抽出する。
+ */
+import type { TypeItem, UtilityItem } from "../commands/feature-map-types.js";
+/**
+ * エクスポートされた型定義を抽出
+ */
+export declare function extractExportedTypes(content: string): TypeItem[];
+/**
+ * ブレースで囲まれたブロックを抽出（ネスト対応）
+ *
+ * @param content - ソースコード全体
+ * @param startIndex - 開始ブレース '{' の位置
+ * @returns ブレース含む完全なブロック、または null
+ */
+export declare function extractBracedBlock(content: string, startIndex: number): string | null;
+/**
+ * 直前のJSDocコメントを抽出
+ *
+ * @description 宣言の直前（空白のみ許容）にあるJSDocコメントを検出し、
+ * JSDocとソースコードを結合して返す。
+ * ファイルヘッダーやインポート文の後のJSDocは除外する。
+ */
+export declare function extractPrecedingJSDoc(content: string, matchIndex: number, matchText: string): {
+    jsdoc: string | null;
+    sourceCode: string;
+};
+/**
+ * インターフェースのフィールドを抽出
+ */
+export declare function extractInterfaceFields(body: string): {
+    name: string;
+    type: string;
+    description?: string;
+}[];
+/**
+ * enumの値を抽出
+ */
+export declare function extractEnumValues(body: string): string[];
+/**
+ * エクスポートされたユーティリティ（定数・ヘルパー関数）を抽出
+ *
+ * @description
+ * - export const NAME = ... 形式の定数
+ * - export function name(...) 形式の関数（@serverAction タグがないもの）
+ * を抽出する。
+ *
+ * @param content - ファイル内容
+ * @returns ユーティリティアイテムの配列
+ */
+export declare function extractExportedUtilities(content: string): UtilityItem[];
+/**
+ * 関数の引数文字列をパースする
+ */
+export declare function parseParams(paramsStr: string): {
+    name: string;
+    type: string;
+}[];
+//# sourceMappingURL=feature-map-type-extraction.d.ts.map

package/dist/parsers/feature-map-type-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-map-type-extraction.d.ts","sourceRoot":"","sources":["../../src/parsers/feature-map-type-extraction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAE9E;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CAsGhE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkErF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CA6C9C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAmC3G;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAaxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAsDvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CA2B/E"}