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

package/dist/commands/deps.d.ts

@@ -0,0 +1,24 @@
+/**
+ * deps コマンド - 依存関係グラフ生成
+ *
+ * dependency-cruiser を使用してモジュール依存関係グラフを生成する。
+ *
+ * @example
+ * ```bash
+ * shirokuma-docs deps --project ./my-project
+ * ```
+ */
+interface DepsOptions {
+    project: string;
+    config: string;
+    output?: string;
+    verbose?: boolean;
+}
+/**
+ * deps コマンドハンドラ
+ *
+ * @param options - コマンドオプション
+ */
+export declare function depsCommand(options: DepsOptions): Promise<void>;
+export {};
+//# sourceMappingURL=deps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/commands/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAuJD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA2GrE"}

package/dist/commands/deps.js

@@ -0,0 +1,211 @@
+/**
+ * deps コマンド - 依存関係グラフ生成
+ *
+ * dependency-cruiser を使用してモジュール依存関係グラフを生成する。
+ *
+ * @example
+ * ```bash
+ * shirokuma-docs deps --project ./my-project
+ * ```
+ */
+import { resolve } from "node:path";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { loadConfig, getOutputPath, resolvePath } from "../utils/config.js";
+import { ensureDir, fileExists, writeFile } from "../utils/file.js";
+import { createLogger } from "../utils/logger.js";
+const execAsync = promisify(exec);
+/**
+ * dependency-cruiser がインストールされているか確認
+ */
+async function checkDepcruise(projectPath, logger) {
+    try {
+        await execAsync("npx depcruise --version", { cwd: projectPath });
+        return true;
+    }
+    catch {
+        logger.warn("dependency-cruiser がインストールされていません");
+        logger.info("インストール: pnpm add -D dependency-cruiser");
+        return false;
+    }
+}
+/**
+ * graphviz (dot) がインストールされているか確認
+ */
+async function checkGraphviz(logger) {
+    try {
+        await execAsync("dot -V");
+        return true;
+    }
+    catch {
+        logger.warn("graphviz がインストールされていません");
+        logger.info("インストール: apt install graphviz (Ubuntu/Debian)");
+        logger.info("           : brew install graphviz (macOS)");
+        return false;
+    }
+}
+/**
+ * 除外パターンから正規表現文字列を生成
+ */
+function buildExcludeRegex(patterns) {
+    return patterns
+        .map((p) => p.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))
+        .join("|");
+}
+/**
+ * include パターンから正規表現文字列を生成
+ */
+function buildIncludeRegex(patterns) {
+    return patterns.map((p) => `^${p}`).join("|");
+}
+/**
+ * JSON 形式で依存関係を出力
+ */
+async function generateJson(projectPath, existingPaths, excludeRegex, outputPath, logger, verbose) {
+    try {
+        const jsonCmd = [
+            "npx depcruise",
+            ...existingPaths.map((p) => `"${p}"`),
+            "--output-type json",
+            excludeRegex ? `--exclude "^(${excludeRegex})"` : "",
+        ]
+            .filter(Boolean)
+            .join(" ");
+        logger.debug(`実行: ${jsonCmd}`);
+        const { stdout, stderr } = await execAsync(jsonCmd, {
+            cwd: projectPath,
+            maxBuffer: 50 * 1024 * 1024, // 50MB buffer for large projects
+        });
+        if (stderr && verbose) {
+            logger.debug(`stderr: ${stderr}`);
+        }
+        // JSON を整形して保存
+        const jsonData = JSON.parse(stdout);
+        writeFile(outputPath, JSON.stringify(jsonData, null, 2));
+        logger.success(`依存関係データ (JSON): ${outputPath}`);
+        return true;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`JSON 生成失敗: ${errorMessage}`);
+        return false;
+    }
+}
+/**
+ * SVG 形式で依存関係グラフを出力
+ */
+async function generateSvg(projectPath, existingPaths, excludeRegex, outputPath, logger, verbose) {
+    // graphviz が必要
+    const hasGraphviz = await checkGraphviz(logger);
+    if (!hasGraphviz) {
+        logger.warn("SVG 生成をスキップ (graphviz が必要です)");
+        return false;
+    }
+    try {
+        // depcruise で DOT 形式を生成し、dot コマンドで SVG に変換
+        const svgCmd = [
+            "npx depcruise",
+            ...existingPaths.map((p) => `"${p}"`),
+            "--output-type dot",
+            excludeRegex ? `--exclude "^(${excludeRegex})"` : "",
+            `| dot -T svg -o "${outputPath}"`,
+        ]
+            .filter(Boolean)
+            .join(" ");
+        logger.debug(`実行: ${svgCmd}`);
+        await execAsync(svgCmd, {
+            cwd: projectPath,
+            shell: "/bin/bash",
+            maxBuffer: 50 * 1024 * 1024,
+        });
+        logger.success(`依存関係グラフ (SVG): ${outputPath}`);
+        return true;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`SVG 生成失敗: ${errorMessage}`);
+        return false;
+    }
+}
+/**
+ * deps コマンドハンドラ
+ *
+ * @param options - コマンドオプション
+ */
+export async function depsCommand(options) {
+    const logger = createLogger(options.verbose);
+    const projectPath = resolve(options.project);
+    logger.info("依存関係グラフを生成");
+    // 設定読み込み
+    const config = loadConfig(projectPath, options.config);
+    const depsConfig = config.deps || {};
+    // dependency-cruiser がインストールされているか確認
+    const hasDepcruise = await checkDepcruise(projectPath, logger);
+    if (!hasDepcruise) {
+        throw new Error("dependency-cruiser not installed");
+    }
+    // 出力ディレクトリを決定
+    const outputDir = options.output ||
+        (depsConfig.output
+            ? resolvePath(projectPath, depsConfig.output)
+            : getOutputPath(config, projectPath, "generated"));
+    ensureDir(outputDir);
+    logger.debug(`出力ディレクトリ: ${outputDir}`);
+    // 対象パスを取得
+    const includePaths = depsConfig.include || ["src", "lib", "app"];
+    const existingPaths = includePaths
+        .map((p) => resolvePath(projectPath, p))
+        .filter((p) => {
+        const exists = fileExists(p);
+        if (!exists) {
+            logger.debug(`パスが見つかりません: ${p}`);
+        }
+        return exists;
+    });
+    if (existingPaths.length === 0) {
+        logger.warn("対象パスが見つかりません");
+        logger.info(`検索パス: ${includePaths.join(", ")}`);
+        return;
+    }
+    logger.debug(`対象パス: ${existingPaths.join(", ")}`);
+    // 除外パターン
+    const excludePatterns = depsConfig.exclude || [
+        "node_modules",
+        ".next",
+        "dist",
+    ];
+    const excludeRegex = buildExcludeRegex(excludePatterns);
+    // 出力フォーマット (デフォルト: svg, json)
+    const formats = depsConfig.formats || ["svg", "json"];
+    // 各フォーマットで生成
+    const results = [];
+    for (const format of formats) {
+        switch (format) {
+            case "json": {
+                const jsonPath = resolve(outputDir, "dependencies.json");
+                const success = await generateJson(projectPath, existingPaths, excludeRegex, jsonPath, logger, options.verbose || false);
+                results.push({ format: "json", success });
+                break;
+            }
+            case "svg": {
+                const svgPath = resolve(outputDir, "dependencies.svg");
+                const success = await generateSvg(projectPath, existingPaths, excludeRegex, svgPath, logger, options.verbose || false);
+                results.push({ format: "svg", success });
+                break;
+            }
+            default:
+                logger.warn(`未対応のフォーマット: ${format}`);
+        }
+    }
+    // 結果サマリー
+    const successCount = results.filter((r) => r.success).length;
+    const failCount = results.filter((r) => !r.success).length;
+    if (successCount > 0) {
+        logger.success(`依存関係グラフ生成完了 (成功: ${successCount}, 失敗: ${failCount})`);
+    }
+    else {
+        logger.error("依存関係グラフ生成に失敗しました");
+        throw new Error("Failed to generate dependency graphs");
+    }
+}
+//# sourceMappingURL=deps.js.map

package/dist/commands/deps.js.map

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

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

@@ -0,0 +1,38 @@
+/**
+ * details-context - コンテキスト管理・要素リンク解決
+ *
+ * DetailsContext の作成、要素マップ管理、リンク解決、
+ * モジュール名抽出、ソースコード読み込みを提供する。
+ */
+import type { DetailsContext } from "./details-types.js";
+/**
+ * 空の DetailsContext を作成
+ */
+export declare function createDetailsContext(): DetailsContext;
+/**
+ * ファイルパスからモジュール名を抽出
+ */
+export declare function extractModuleName(filePath: string): string;
+/**
+ * 要素の完全キーを生成
+ */
+export declare function getElementFullKey(moduleName: string, elementName: string): string;
+/**
+ * linkTypeに対応する存在要素マップを取得
+ */
+export declare function getExistingMap(ctx: DetailsContext, linkType: string): Map<string, string>;
+/**
+ * 要素名からリンク情報を検索
+ */
+export declare function findElementLink(ctx: DetailsContext, linkType: string, elementName: string): {
+    module: string;
+} | null;
+/**
+ * ソースコードを読み込み
+ */
+export declare function readSourceCode(projectPath: string, filePath: string): string;
+/**
+ * 関数/コンポーネントのコードを抽出
+ */
+export declare function extractFunctionCode(sourceCode: string, targetName: string): string;
+//# sourceMappingURL=details-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"details-context.d.ts","sourceRoot":"","sources":["../../src/commands/details-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAYrD;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsB1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjF;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAezF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW3B;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyFlF"}

package/dist/commands/details-context.js

@@ -0,0 +1,193 @@
+/**
+ * details-context - コンテキスト管理・要素リンク解決
+ *
+ * DetailsContext の作成、要素マップ管理、リンク解決、
+ * モジュール名抽出、ソースコード読み込みを提供する。
+ */
+import { resolve } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+// ===== コンテキスト作成 =====
+/**
+ * 空の DetailsContext を作成
+ */
+export function createDetailsContext() {
+    return {
+        allTestCases: [],
+        detailsJsonItems: {},
+        existingElements: {
+            screens: new Map(),
+            components: new Map(),
+            actions: new Map(),
+            modules: new Map(),
+            tables: new Map(),
+        },
+    };
+}
+// ===== モジュール名・キー =====
+/**
+ * ファイルパスからモジュール名を抽出
+ */
+export function extractModuleName(filePath) {
+    const segments = filePath.replace(/\\/g, "/").split("/");
+    const fileName = segments[segments.length - 1].replace(/\.(ts|tsx|js|jsx)$/, "");
+    const excludeDirs = ["app", "lib", "src", "components", "actions", "schema", "apps", "packages", "web", "admin", "public"];
+    for (let i = segments.length - 2; i >= 0; i--) {
+        const dir = segments[i];
+        if (dir.startsWith("(") && dir.endsWith(")")) {
+            return dir.slice(1, -1);
+        }
+        if (dir.startsWith("[") && dir.endsWith("]")) {
+            continue;
+        }
+        if (!excludeDirs.includes(dir.toLowerCase()) && dir.length > 0) {
+            return dir;
+        }
+    }
+    return fileName;
+}
+/**
+ * 要素の完全キーを生成
+ */
+export function getElementFullKey(moduleName, elementName) {
+    return `${moduleName}/${elementName}`;
+}
+// ===== リンク解決 =====
+/**
+ * linkTypeに対応する存在要素マップを取得
+ */
+export function getExistingMap(ctx, linkType) {
+    switch (linkType) {
+        case "screen":
+            return ctx.existingElements.screens;
+        case "component":
+            return ctx.existingElements.components;
+        case "action":
+            return ctx.existingElements.actions;
+        case "module":
+            return ctx.existingElements.modules;
+        case "table":
+            return ctx.existingElements.tables;
+        default:
+            return new Map();
+    }
+}
+/**
+ * 要素名からリンク情報を検索
+ */
+export function findElementLink(ctx, linkType, elementName) {
+    const map = getExistingMap(ctx, linkType);
+    for (const [fullKey, module] of map.entries()) {
+        const name = fullKey.split("/")[1];
+        if (name === elementName) {
+            return { module };
+        }
+    }
+    return null;
+}
+// ===== ソースコード読み込み =====
+/**
+ * ソースコードを読み込み
+ */
+export function readSourceCode(projectPath, filePath) {
+    const fullPath = resolve(projectPath, filePath);
+    if (!existsSync(fullPath)) {
+        return `// File not found: ${filePath}`;
+    }
+    try {
+        return readFileSync(fullPath, "utf-8");
+    }
+    catch {
+        return `// Error reading file: ${filePath}`;
+    }
+}
+/**
+ * 関数/コンポーネントのコードを抽出
+ */
+export function extractFunctionCode(sourceCode, targetName) {
+    const patterns = [
+        new RegExp(`(?:export\\s+)?(?:async\\s+)?function\\s+${targetName}\\s*[<({]`, "gm"),
+        new RegExp(`(?:export\\s+)?const\\s+${targetName}\\s*=`, "gm"),
+        new RegExp(`(?:export\\s+)?(?:default\\s+)?function\\s+${targetName}\\s*[<({]`, "gm"),
+    ];
+    for (const pattern of patterns) {
+        pattern.lastIndex = 0;
+        const match = pattern.exec(sourceCode);
+        if (match) {
+            let startIndex = match.index;
+            // 直前のJSDocコメントを探す
+            const before = sourceCode.slice(0, startIndex);
+            const lastCommentEnd = before.lastIndexOf("*/");
+            if (lastCommentEnd !== -1) {
+                const afterComment = before.slice(lastCommentEnd + 2);
+                if (/^\s*$/.test(afterComment)) {
+                    const commentStart = before.lastIndexOf("/**", lastCommentEnd);
+                    if (commentStart !== -1) {
+                        startIndex = commentStart;
+                    }
+                }
+            }
+            // 関数シグネチャをスキップして関数本体の { を見つける
+            let parenDepth = 0;
+            let bodyStartIndex = match.index;
+            let foundParenStart = false;
+            let inStringSig = false;
+            let stringCharSig = "";
+            for (let i = match.index; i < sourceCode.length; i++) {
+                const char = sourceCode[i];
+                const prevChar = sourceCode[i - 1];
+                if (!inStringSig && (char === '"' || char === "'" || char === "`") && prevChar !== "\\") {
+                    inStringSig = true;
+                    stringCharSig = char;
+                }
+                else if (inStringSig && char === stringCharSig && prevChar !== "\\") {
+                    inStringSig = false;
+                }
+                else if (!inStringSig) {
+                    if (char === "(") {
+                        parenDepth++;
+                        foundParenStart = true;
+                    }
+                    else if (char === ")") {
+                        parenDepth--;
+                    }
+                    else if (char === "{" && foundParenStart && parenDepth === 0) {
+                        bodyStartIndex = i;
+                        break;
+                    }
+                }
+            }
+            // 関数本体の括弧の深さで終了位置を特定
+            let braceDepth = 0;
+            let inString = false;
+            let stringChar = "";
+            let endIndex = bodyStartIndex;
+            for (let i = bodyStartIndex; i < sourceCode.length; i++) {
+                const char = sourceCode[i];
+                const prevChar = sourceCode[i - 1];
+                if (!inString && (char === '"' || char === "'" || char === "`") && prevChar !== "\\") {
+                    inString = true;
+                    stringChar = char;
+                }
+                else if (inString && char === stringChar && prevChar !== "\\") {
+                    inString = false;
+                }
+                else if (!inString) {
+                    if (char === "{")
+                        braceDepth++;
+                    else if (char === "}") {
+                        braceDepth--;
+                        if (braceDepth === 0) {
+                            endIndex = i + 1;
+                            break;
+                        }
+                    }
+                }
+            }
+            if (endIndex > bodyStartIndex) {
+                return sourceCode.slice(startIndex, endIndex).trim();
+            }
+        }
+    }
+    return sourceCode;
+}
+//# sourceMappingURL=details-context.js.map

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

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