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

package/dist/commands/details-types.d.ts

@@ -0,0 +1,315 @@
+/**
+ * details 型定義
+ *
+ * 詳細ページ生成に使用する全てのインターフェースと型
+ */
+import { type ActionType } from "../utils/action-inference.js";
+import { type AppName } from "../utils/app-inference.js";
+export interface DetailsOptions {
+    project: string;
+    config: string;
+    output?: string;
+    verbose?: boolean;
+}
+export interface Screen {
+    name: string;
+    path: string;
+    route: string;
+    description: string;
+    usedComponents?: string[];
+    usedActions?: string[];
+    testCoverage?: TestCoverageInfo;
+}
+export interface Component {
+    name: string;
+    path: string;
+    description: string;
+    usedInScreens?: string[];
+    usedInComponents?: string[];
+    usedActions?: string[];
+    testCoverage?: TestCoverageInfo;
+}
+export interface Action {
+    name: string;
+    path: string;
+    description: string;
+    usedInScreens?: string[];
+    usedInComponents?: string[];
+    dbTables?: string[];
+    testCoverage?: TestCoverageInfo;
+    actionType?: ActionType;
+}
+export interface Table {
+    name: string;
+    path: string;
+    description: string;
+    usedInActions?: string[];
+}
+export interface Module {
+    name: string;
+    path: string;
+    description?: string;
+    usedInScreens?: string[];
+    usedInComponents?: string[];
+    usedInActions?: string[];
+    usedInMiddleware?: string[];
+    usedInLayouts?: string[];
+    usedModules?: string[];
+    usedInModules?: string[];
+    category?: string;
+}
+export interface TestCoverageInfo {
+    hasTest: boolean;
+    testCount: number;
+    status: "covered" | "partial" | "none";
+}
+export interface Feature {
+    screens: Screen[];
+    components: Component[];
+    actions: Action[];
+    modules: Module[];
+    tables: Table[];
+}
+/**
+ * 型定義アイテム（feature-map.ts と同期）
+ */
+export interface TypeItem {
+    name: string;
+    kind: "interface" | "type" | "enum";
+    description?: string;
+    fields?: {
+        name: string;
+        type: string;
+        description?: string;
+    }[];
+    values?: string[];
+    sourceCode?: string;
+}
+/**
+ * ユーティリティアイテム（feature-map.ts と同期）
+ */
+export interface UtilityItem {
+    name: string;
+    kind: "constant" | "function";
+    description?: string;
+    type?: string;
+    value?: string;
+    params?: {
+        name: string;
+        type: string;
+    }[];
+}
+export interface FeatureMap {
+    features: Record<string, Feature>;
+    uncategorized?: Feature;
+    moduleDescriptions?: Record<string, string>;
+    moduleTypes?: Record<string, TypeItem[]>;
+    moduleUtilities?: Record<string, UtilityItem[]>;
+    generatedAt: string;
+}
+export interface BddAnnotation {
+    given?: string;
+    when?: string;
+    then?: string;
+    and?: string[];
+}
+export interface DescribeDoc {
+    name: string;
+    testdoc?: string;
+    purpose?: string;
+}
+export interface ShirokumaTestCase {
+    file: string;
+    describe: string;
+    it: string;
+    line: number;
+    framework: "jest" | "playwright";
+    description?: string;
+    purpose?: string;
+    precondition?: string;
+    expected?: string;
+    bdd?: BddAnnotation;
+    describeDocs?: DescribeDoc[];
+}
+export interface TestCasesJson {
+    testCases: ShirokumaTestCase[];
+    summary: {
+        totalFiles: number;
+        totalTests: number;
+    };
+    generatedAt: string;
+}
+export type TestCategory = "happy-path" | "error-handling" | "auth" | "validation" | "edge-case" | "integration" | "other";
+export interface CategorizedTestCase extends ShirokumaTestCase {
+    category: TestCategory;
+    summary: string;
+}
+export interface TestCoverageAnalysis {
+    totalTests: number;
+    byCategory: Record<TestCategory, CategorizedTestCase[]>;
+    missingPatterns: string[];
+    coverageScore: number;
+    recommendations: string[];
+}
+/**
+ * Zodスキーマパラメータ情報
+ */
+export interface ZodParameter {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    format?: string;
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+    pattern?: string;
+    default?: string | number | boolean;
+    enum?: string[];
+    validation?: {
+        message: string;
+    };
+}
+/**
+ * 詳細ページJSON出力用の型
+ * Next.jsポータルで使用
+ */
+export interface DetailJsonItem {
+    name: string;
+    type: "screen" | "component" | "action" | "module" | "table";
+    moduleName: string;
+    description: string;
+    filePath: string;
+    sourceCode: string;
+    app?: AppName;
+    jsDoc: {
+        description: string;
+        params: {
+            name: string;
+            type?: string;
+            description: string;
+        }[];
+        returns?: string;
+        throws?: string[];
+        examples: string[];
+        tags: {
+            name: string;
+            value: string;
+        }[];
+    };
+    related: {
+        usedInScreens?: string[];
+        usedInComponents?: string[];
+        usedInActions?: string[];
+        usedInMiddleware?: string[];
+        usedInLayouts?: string[];
+        usedModules?: string[];
+        usedInModules?: string[];
+        dbTables?: string[];
+    };
+    testCoverage: {
+        hasTest: boolean;
+        totalTests: number;
+        coverageScore: number;
+        byCategory: Record<string, DetailTestCase[]>;
+        recommendations: string[];
+    };
+    inputSchema?: {
+        name: string;
+        parameters: ZodParameter[];
+    };
+    outputSchema?: {
+        type: string;
+        successType?: string;
+        errorType?: string;
+    };
+    errorCodes?: {
+        code: string;
+        description: string;
+        status?: number;
+    }[];
+    authLevel?: "none" | "authenticated" | "member" | "admin";
+    rateLimit?: string;
+    csrfProtection?: boolean;
+}
+export interface DetailTestCase {
+    name: string;
+    file: string;
+    line: number;
+    summary: string;
+    purpose?: string;
+    expected?: string;
+    bdd?: BddAnnotation;
+}
+export interface DetailsJson {
+    details: Record<string, DetailJsonItem>;
+    generatedAt: string;
+}
+export interface ParsedJSDoc {
+    description: string;
+    params: {
+        name: string;
+        type?: string;
+        description: string;
+    }[];
+    returns?: string;
+    throws?: string[];
+    examples: string[];
+    tags: {
+        name: string;
+        value: string;
+    }[];
+}
+export interface DetailHTMLData {
+    type: "screen" | "component" | "action" | "module" | "table";
+    name: string;
+    moduleName: string;
+    description: string;
+    filePath: string;
+    route?: string;
+    code: string;
+    jsDoc: string;
+    testCases: CategorizedTestCase[];
+    testAnalysis: TestCoverageAnalysis;
+    related: {
+        type: string;
+        items: string[];
+        linkType: string;
+        sourcePath?: string;
+    }[];
+    projectName: string;
+    /** アクション種別 (action用) */
+    actionType?: ActionType;
+}
+export interface ModulePageData {
+    type: "screen" | "component" | "action" | "module" | "table";
+    moduleName: string;
+    moduleDescription?: string;
+    items: (Screen | Component | Action | Table)[];
+    types?: TypeItem[];
+    utilities?: UtilityItem[];
+    testCases?: CategorizedTestCase[];
+    projectName: string;
+}
+/**
+ * 詳細ページ生成の共有コンテキスト
+ *
+ * 以前のグローバル変数（allTestCases, detailsJsonItems, existingElements）を
+ * パラメータとして渡すためのオブジェクト
+ */
+export interface DetailsContext {
+    /** テストケース一覧 (test-cases.json から読み込み) */
+    allTestCases: ShirokumaTestCase[];
+    /** JSON出力用の詳細データ */
+    detailsJsonItems: Record<string, DetailJsonItem>;
+    /** 存在する要素のマップ（リンク生成時に使用） */
+    existingElements: {
+        screens: Map<string, string>;
+        components: Map<string, string>;
+        actions: Map<string, string>;
+        modules: Map<string, string>;
+        tables: Map<string, string>;
+    };
+}
+//# sourceMappingURL=details-types.d.ts.map

package/dist/commands/details-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"details-types.d.ts","sourceRoot":"","sources":["../../src/commands/details-types.ts"],"names":[],"mappings":"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"}

package/dist/commands/details-types.js

@@ -0,0 +1,7 @@
+/**
+ * details 型定義
+ *
+ * 詳細ページ生成に使用する全てのインターフェースと型
+ */
+export {};
+//# sourceMappingURL=details-types.js.map

package/dist/commands/details-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"details-types.js","sourceRoot":"","sources":["../../src/commands/details-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/commands/details.d.ts

@@ -0,0 +1,24 @@
+/**
+ * details コマンド - 詳細ページ生成
+ *
+ * feature-map.json, test-cases.json, linked-docs.json を読み込み、
+ * 各要素（Screen, Component, Action, Table）の詳細ページを生成する。
+ *
+ * ロジックは以下のモジュールに分割:
+ * - details-types.ts: 型定義
+ * - details-context.ts: コンテキスト管理・リンク解決
+ * - details-jsdoc.ts: JSDoc解析
+ * - details-zod.ts: Zodスキーマ解析
+ * - details-test-analysis.ts: テスト分析
+ * - details-styles.ts: CSS・スクリプト
+ * - details-html.ts: コアHTML生成
+ * - details-entity-pages.ts: エンティティ詳細ページ
+ * - details-module-page.ts: モジュール概要ページ
+ */
+import type { DetailsOptions } from "./details-types.js";
+export type { DetailsOptions } from "./details-types.js";
+/**
+ * details コマンドのメインハンドラ
+ */
+export declare function detailsCommand(options: DetailsOptions): Promise<void>;
+//# sourceMappingURL=details.d.ts.map

package/dist/commands/details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.d.ts","sourceRoot":"","sources":["../../src/commands/details.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EACV,cAAc,EAWf,MAAM,oBAAoB,CAAC;AAa5B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoJ3E"}

package/dist/commands/details.js

@@ -0,0 +1,299 @@
+/**
+ * details コマンド - 詳細ページ生成
+ *
+ * feature-map.json, test-cases.json, linked-docs.json を読み込み、
+ * 各要素（Screen, Component, Action, Table）の詳細ページを生成する。
+ *
+ * ロジックは以下のモジュールに分割:
+ * - details-types.ts: 型定義
+ * - details-context.ts: コンテキスト管理・リンク解決
+ * - details-jsdoc.ts: JSDoc解析
+ * - details-zod.ts: Zodスキーマ解析
+ * - details-test-analysis.ts: テスト分析
+ * - details-styles.ts: CSS・スクリプト
+ * - details-html.ts: コアHTML生成
+ * - details-entity-pages.ts: エンティティ詳細ページ
+ * - details-module-page.ts: モジュール概要ページ
+ */
+import { resolve } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { loadConfig, getOutputPath } from "../utils/config.js";
+import { ensureDir, writeFile } from "../utils/file.js";
+import { createLogger } from "../utils/logger.js";
+import { createDetailsContext, extractModuleName, getElementFullKey } from "./details-context.js";
+import { findTestCasesForModule } from "../analyzers/details-test-analysis.js";
+import { generateScreenDetailPage, generateComponentDetailPage, generateActionDetailPage, generateTableDetailPage, generateModuleItemDetailPage, } from "../generators/details-entity-pages.js";
+import { generateModuleDetailPage } from "../generators/details-module-page.js";
+/**
+ * details コマンドのメインハンドラ
+ */
+export async function detailsCommand(options) {
+    const logger = createLogger(options.verbose);
+    const projectPath = resolve(options.project);
+    // コンテキスト作成
+    const ctx = createDetailsContext();
+    logger.info("詳細ページを生成");
+    // 設定読み込み
+    const config = loadConfig(projectPath, options.config);
+    const portalDir = getOutputPath(config, projectPath, "portal");
+    const detailsDir = resolve(portalDir, "details");
+    // 入力ファイルのパス
+    const featureMapPath = resolve(portalDir, "feature-map.json");
+    const testCasesPath = resolve(portalDir, "test-cases.json");
+    // 必須ファイルの存在チェック
+    if (!existsSync(featureMapPath)) {
+        logger.error(`feature-map.json が見つかりません: ${featureMapPath}`);
+        logger.info("先に 'shirokuma-docs feature-map' を実行してください");
+        return;
+    }
+    // feature-map.json 読み込み
+    const featureMap = JSON.parse(readFileSync(featureMapPath, "utf-8"));
+    logger.info(`feature-map.json を読み込みました`);
+    // test-cases.json 読み込み（オプション）
+    if (existsSync(testCasesPath)) {
+        const testCasesJson = JSON.parse(readFileSync(testCasesPath, "utf-8"));
+        ctx.allTestCases = testCasesJson.testCases;
+        logger.info(`test-cases.json を読み込みました (${ctx.allTestCases.length} テストケース)`);
+    }
+    else {
+        logger.warn("test-cases.json が見つかりません。テストケース情報はスキップします。");
+    }
+    // ディレクトリ作成
+    ensureDir(resolve(detailsDir, "screen"));
+    ensureDir(resolve(detailsDir, "component"));
+    ensureDir(resolve(detailsDir, "action"));
+    ensureDir(resolve(detailsDir, "module"));
+    ensureDir(resolve(detailsDir, "table"));
+    // 存在する要素を収集（リンク生成に使用）
+    collectExistingElements(ctx, featureMap);
+    // 統計
+    let screenCount = 0;
+    let componentCount = 0;
+    let actionCount = 0;
+    let moduleItemCount = 0;
+    let tableCount = 0;
+    // モジュールの事前マージ（異なるアプリから同名モジュールがある場合）
+    const mergedModulesMap = buildMergedModulesMap(featureMap);
+    // 処理済みモジュールを追跡（重複生成を防ぐ）
+    const generatedModules = new Set();
+    // 各機能の詳細ページを生成
+    for (const [featureName, feature] of Object.entries(featureMap.features)) {
+        for (const screen of feature.screens) {
+            generateScreenDetailPage(screen, detailsDir, projectPath, config.project.name, ctx);
+            screenCount++;
+        }
+        for (const component of feature.components) {
+            generateComponentDetailPage(component, detailsDir, projectPath, config.project.name, ctx);
+            componentCount++;
+        }
+        for (const action of feature.actions) {
+            generateActionDetailPage(action, detailsDir, projectPath, config.project.name, ctx);
+            actionCount++;
+        }
+        // Modules (lib/ ディレクトリのモジュール) - マージされたモジュールを使用
+        for (const mod of feature.modules || []) {
+            const key = `${featureName}/${mod.name}`;
+            if (generatedModules.has(key))
+                continue;
+            generatedModules.add(key);
+            const merged = mergedModulesMap.get(key);
+            if (merged) {
+                generateModuleItemDetailPage(merged.mod, featureName, detailsDir, projectPath, config.project.name, ctx);
+                moduleItemCount++;
+            }
+        }
+        for (const table of feature.tables) {
+            generateTableDetailPage(table, detailsDir, projectPath, config.project.name, ctx);
+            tableCount++;
+        }
+    }
+    // uncategorized も処理
+    if (featureMap.uncategorized) {
+        for (const screen of featureMap.uncategorized.screens || []) {
+            generateScreenDetailPage(screen, detailsDir, projectPath, config.project.name, ctx);
+            screenCount++;
+        }
+        for (const component of featureMap.uncategorized.components || []) {
+            generateComponentDetailPage(component, detailsDir, projectPath, config.project.name, ctx);
+            componentCount++;
+        }
+        for (const action of featureMap.uncategorized.actions || []) {
+            generateActionDetailPage(action, detailsDir, projectPath, config.project.name, ctx);
+            actionCount++;
+        }
+        for (const mod of featureMap.uncategorized.modules || []) {
+            const key = `Uncategorized/${mod.name}`;
+            if (generatedModules.has(key))
+                continue;
+            generatedModules.add(key);
+            const merged = mergedModulesMap.get(key);
+            if (merged) {
+                generateModuleItemDetailPage(merged.mod, "Uncategorized", detailsDir, projectPath, config.project.name, ctx);
+                moduleItemCount++;
+            }
+        }
+        for (const table of featureMap.uncategorized.tables || []) {
+            generateTableDetailPage(table, detailsDir, projectPath, config.project.name, ctx);
+            tableCount++;
+        }
+    }
+    // モジュール詳細ページの生成
+    const modulePageCount = generateModulePages(ctx, featureMap, detailsDir, config.project.name);
+    // details.json 出力
+    const detailsJson = {
+        details: ctx.detailsJsonItems,
+        generatedAt: new Date().toISOString(),
+    };
+    const detailsJsonPath = resolve(portalDir, "details.json");
+    writeFile(detailsJsonPath, JSON.stringify(detailsJson, null, 2));
+    logger.info(`  details.json: ${Object.keys(ctx.detailsJsonItems).length} items`);
+    logger.success(`詳細ページ生成完了:`);
+    logger.info(`  Screens: ${screenCount}`);
+    logger.info(`  Components: ${componentCount}`);
+    logger.info(`  Actions: ${actionCount}`);
+    logger.info(`  Modules: ${moduleItemCount}`);
+    logger.info(`  Tables: ${tableCount}`);
+    logger.info(`  Module Pages: ${modulePageCount}`);
+    logger.success(`出力先: ${detailsDir}`);
+}
+// ===== Internal helpers =====
+/**
+ * 存在する要素を収集してコンテキストに登録
+ */
+function collectExistingElements(ctx, featureMap) {
+    const collect = (feature) => {
+        feature.screens.forEach((s) => {
+            const module = extractModuleName(s.path);
+            const fullKey = getElementFullKey(module, s.name);
+            ctx.existingElements.screens.set(fullKey, module);
+        });
+        feature.components.forEach((c) => {
+            const module = extractModuleName(c.path);
+            const fullKey = getElementFullKey(module, c.name);
+            ctx.existingElements.components.set(fullKey, module);
+        });
+        feature.actions.forEach((a) => {
+            const module = extractModuleName(a.path);
+            const fullKey = getElementFullKey(module, a.name);
+            ctx.existingElements.actions.set(fullKey, module);
+        });
+        (feature.modules || []).forEach((m) => {
+            const module = extractModuleName(m.path);
+            const fullKey = getElementFullKey(module, m.name);
+            ctx.existingElements.modules.set(fullKey, module);
+        });
+        feature.tables.forEach((t) => {
+            const module = extractModuleName(t.path);
+            const fullKey = getElementFullKey(module, t.name);
+            ctx.existingElements.tables.set(fullKey, module);
+        });
+    };
+    for (const feature of Object.values(featureMap.features)) {
+        collect(feature);
+    }
+    if (featureMap.uncategorized) {
+        collect(featureMap.uncategorized);
+    }
+}
+/**
+ * モジュールの事前マージマップを構築
+ */
+function buildMergedModulesMap(featureMap) {
+    const mergedMap = new Map();
+    const mergeModuleRelated = (existing, newMod) => ({
+        ...existing,
+        usedInScreens: [...new Set([...(existing.usedInScreens || []), ...(newMod.usedInScreens || [])])],
+        usedInComponents: [...new Set([...(existing.usedInComponents || []), ...(newMod.usedInComponents || [])])],
+        usedInActions: [...new Set([...(existing.usedInActions || []), ...(newMod.usedInActions || [])])],
+        usedInMiddleware: [...new Set([...(existing.usedInMiddleware || []), ...(newMod.usedInMiddleware || [])])],
+        usedInLayouts: [...new Set([...(existing.usedInLayouts || []), ...(newMod.usedInLayouts || [])])],
+        usedModules: [...new Set([...(existing.usedModules || []), ...(newMod.usedModules || [])])],
+        usedInModules: [...new Set([...(existing.usedInModules || []), ...(newMod.usedInModules || [])])],
+    });
+    for (const [featureName, feature] of Object.entries(featureMap.features)) {
+        for (const mod of feature.modules || []) {
+            const key = `${featureName}/${mod.name}`;
+            const existing = mergedMap.get(key);
+            if (existing) {
+                mergedMap.set(key, { mod: mergeModuleRelated(existing.mod, mod), featureName });
+            }
+            else {
+                mergedMap.set(key, { mod, featureName });
+            }
+        }
+    }
+    if (featureMap.uncategorized) {
+        for (const mod of featureMap.uncategorized.modules || []) {
+            const key = `Uncategorized/${mod.name}`;
+            const existing = mergedMap.get(key);
+            if (existing) {
+                mergedMap.set(key, { mod: mergeModuleRelated(existing.mod, mod), featureName: "Uncategorized" });
+            }
+            else {
+                mergedMap.set(key, { mod, featureName: "Uncategorized" });
+            }
+        }
+    }
+    return mergedMap;
+}
+/**
+ * モジュール概要ページを生成
+ */
+function generateModulePages(ctx, featureMap, detailsDir, projectName) {
+    // アイテムをモジュール別にグループ化
+    const moduleGroups = {
+        screens: new Map(),
+        components: new Map(),
+        actions: new Map(),
+        tables: new Map(),
+    };
+    const groupByModule = (items, map) => {
+        for (const item of items) {
+            const moduleName = extractModuleName(item.path);
+            const existing = map.get(moduleName) || [];
+            existing.push(item);
+            map.set(moduleName, existing);
+        }
+    };
+    // 全機能からアイテムを収集
+    for (const feature of Object.values(featureMap.features)) {
+        groupByModule(feature.screens, moduleGroups.screens);
+        groupByModule(feature.components, moduleGroups.components);
+        groupByModule(feature.actions, moduleGroups.actions);
+        groupByModule(feature.tables, moduleGroups.tables);
+    }
+    if (featureMap.uncategorized) {
+        groupByModule(featureMap.uncategorized.screens || [], moduleGroups.screens);
+        groupByModule(featureMap.uncategorized.components || [], moduleGroups.components);
+        groupByModule(featureMap.uncategorized.actions || [], moduleGroups.actions);
+        groupByModule(featureMap.uncategorized.tables || [], moduleGroups.tables);
+    }
+    // モジュール説明、型定義、ユーティリティを取得
+    const moduleDescriptions = featureMap.moduleDescriptions || {};
+    const moduleTypes = featureMap.moduleTypes || {};
+    const moduleUtilities = featureMap.moduleUtilities || {};
+    let modulePageCount = 0;
+    const typeModuleMap = [
+        ["screen", moduleGroups.screens],
+        ["component", moduleGroups.components],
+        ["action", moduleGroups.actions],
+        ["table", moduleGroups.tables],
+    ];
+    for (const [type, moduleMap] of typeModuleMap) {
+        for (const [moduleName, items] of moduleMap) {
+            generateModuleDetailPage({
+                type: type,
+                moduleName,
+                moduleDescription: moduleDescriptions[moduleName],
+                items,
+                types: moduleTypes[moduleName],
+                utilities: moduleUtilities[moduleName],
+                testCases: findTestCasesForModule(moduleName, type, ctx),
+                projectName,
+            }, detailsDir);
+            modulePageCount++;
+        }
+    }
+    return modulePageCount;
+}
+//# sourceMappingURL=details.js.map