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

package/dist/lint/annotation-lint.js

@@ -0,0 +1,510 @@
+/**
+ * アノテーション整合性検証ロジック
+ *
+ * コードアノテーション（@usedComponents, @screen, @component等）の
+ * 整合性を検証するユーティリティ関数群
+ *
+ * @module lint/annotation-lint
+ */
+import { minimatch } from "minimatch";
+/**
+ * JSDoc から @usedComponents アノテーションを抽出
+ *
+ * @param content - ファイル内容
+ * @returns コンポーネント名の配列
+ *
+ * @example
+ * ```typescript
+ * const components = extractUsedComponentsAnnotation(`
+ *   /**
+ *    * @usedComponents Button, Card, Dialog
+ *    *\/
+ *   export function MyComponent() {}
+ * `);
+ * // Returns: ["Button", "Card", "Dialog"]
+ * ```
+ */
+export function extractUsedComponentsAnnotation(content) {
+    // JSDocブロックを探す
+    const jsdocPattern = /\/\*\*[\s\S]*?\*\//g;
+    const jsdocMatches = content.match(jsdocPattern);
+    if (!jsdocMatches) {
+        return [];
+    }
+    for (const jsdoc of jsdocMatches) {
+        // @usedComponents タグを探す
+        // 複数行対応: @usedComponents の後の値を、次の @ または */ まで取得
+        const usedComponentsMatch = jsdoc.match(/@usedComponents\s+([^@]*?)(?=\s*(?:@|\*\/))/s);
+        if (usedComponentsMatch) {
+            const rawValue = usedComponentsMatch[1];
+            // クリーンアップ: * や改行を除去し、カンマで分割
+            const cleaned = rawValue
+                .replace(/\*/g, "")
+                .replace(/\n/g, " ")
+                .trim();
+            // カンマで分割し、トリム
+            const components = cleaned
+                .split(",")
+                .map((s) => s.trim())
+                .filter((s) => s.length > 0);
+            return components;
+        }
+    }
+    return [];
+}
+/**
+ * import文からコンポーネント名を抽出
+ *
+ * components ディレクトリからのインポートのみを対象とする
+ *
+ * @param content - ファイル内容
+ * @param options - 抽出オプション
+ * @returns コンポーネント名の配列
+ *
+ * @example
+ * ```typescript
+ * const components = extractComponentsFromImports(`
+ *   import { Button, Card } from "@/components/ui/button";
+ * `, { excludeHooks: true });
+ * // Returns: ["Button", "Card"]
+ * ```
+ */
+export function extractComponentsFromImports(content, options = {}) {
+    const { excludeHooks = false } = options;
+    const components = [];
+    // Named imports from components directory
+    // Matches: import { A, B } from "@/components/...", "../components/...", "./components/..."
+    const namedImportPattern = /import\s*\{([^}]+)\}\s*from\s*["'](?:@\/|\.\.\/|\.\/)?components\/[^"']+["']/g;
+    let match;
+    while ((match = namedImportPattern.exec(content)) !== null) {
+        const imports = match[1];
+        const names = imports.split(",").map((s) => s.trim());
+        for (const name of names) {
+            // Handle "A as B" syntax - take original name (A)
+            const actualName = name.split(/\s+as\s+/)[0].trim();
+            // Skip empty names
+            if (!actualName)
+                continue;
+            // Skip hooks if excludeHooks is true
+            if (excludeHooks && actualName.startsWith("use")) {
+                continue;
+            }
+            // Only include PascalCase names (components start with uppercase)
+            if (/^[A-Z]/.test(actualName)) {
+                components.push(actualName);
+            }
+        }
+    }
+    // Default imports from components directory
+    // Matches: import A from "@/components/...", "../components/...", "./components/..."
+    const defaultImportPattern = /import\s+([A-Z][a-zA-Z0-9]*)\s+from\s*["'](?:@\/|\.\.\/|\.\/)?components\/[^"']+["']/g;
+    while ((match = defaultImportPattern.exec(content)) !== null) {
+        const name = match[1];
+        if (name && /^[A-Z]/.test(name)) {
+            components.push(name);
+        }
+    }
+    // Remove duplicates
+    return [...new Set(components)];
+}
+/**
+ * @usedComponents アノテーションとインポートを比較
+ *
+ * @param annotated - アノテーションに記載されたコンポーネント
+ * @param imported - インポートされているコンポーネント
+ * @returns 比較結果
+ *
+ * @example
+ * ```typescript
+ * const result = compareUsedComponents(
+ *   ["Button", "Card"],
+ *   ["Button", "Card", "Dialog"]
+ * );
+ * // result.missing: ["Dialog"]
+ * // result.extra: []
+ * // result.valid: false
+ * ```
+ */
+export function compareUsedComponents(annotated, imported) {
+    const annotatedSet = new Set(annotated);
+    const importedSet = new Set(imported);
+    // Missing: imported but not annotated
+    const missing = imported.filter((c) => !annotatedSet.has(c));
+    // Extra: annotated but not imported
+    const extra = annotated.filter((c) => !importedSet.has(c));
+    return {
+        valid: missing.length === 0 && extra.length === 0,
+        annotated,
+        imported,
+        missing,
+        extra,
+    };
+}
+/**
+ * パスがパターンに一致するか確認
+ */
+function matchesPattern(filePath, patterns) {
+    return patterns.some((pattern) => minimatch(filePath, pattern));
+}
+/**
+ * @screen アノテーションの存在をチェック
+ *
+ * page.tsx ファイルに @screen アノテーションがあるか確認
+ *
+ * @param content - ファイル内容
+ * @param filePath - ファイルパス
+ * @param options - チェックオプション
+ * @returns チェック結果
+ *
+ * @example
+ * ```typescript
+ * const result = checkScreenAnnotation(
+ *   content,
+ *   "app/[locale]/dashboard/page.tsx",
+ *   { exclude: ["*\/not-found.tsx"] }
+ * );
+ * ```
+ */
+export function checkScreenAnnotation(content, filePath, options = {}) {
+    const { exclude = [] } = options;
+    const errors = [];
+    const warnings = [];
+    const infos = [];
+    // Check if file should be excluded
+    if (matchesPattern(filePath, exclude)) {
+        return {
+            valid: true,
+            skipped: true,
+            errors: [],
+            warnings: [],
+            infos: [],
+        };
+    }
+    // Check for @screen annotation
+    // Support screen names with parentheses like "(dashboard)SettingsScreen"
+    const hasScreenAnnotation = /@screen\s+\S+/.test(content);
+    if (!hasScreenAnnotation) {
+        const issue = {
+            type: "warning",
+            message: `Missing @screen annotation in page file`,
+            file: filePath,
+            rule: "screen-required",
+            annotation: "@screen",
+        };
+        warnings.push(issue);
+    }
+    return {
+        valid: warnings.length === 0 && errors.length === 0,
+        skipped: false,
+        errors,
+        warnings,
+        infos,
+    };
+}
+/**
+ * @component アノテーションの存在をチェック
+ *
+ * コンポーネントファイルに @component アノテーションがあるか確認
+ *
+ * @param content - ファイル内容
+ * @param filePath - ファイルパス
+ * @param options - チェックオプション
+ * @returns チェック結果
+ *
+ * @example
+ * ```typescript
+ * const result = checkComponentAnnotation(
+ *   content,
+ *   "components/project-list.tsx",
+ *   { exclude: ["*\/ui\/**"] }
+ * );
+ * ```
+ */
+export function checkComponentAnnotation(content, filePath, options = {}) {
+    const { exclude = [] } = options;
+    const errors = [];
+    const warnings = [];
+    const infos = [];
+    // Check if file should be excluded
+    if (matchesPattern(filePath, exclude)) {
+        return {
+            valid: true,
+            skipped: true,
+            errors: [],
+            warnings: [],
+            infos: [],
+        };
+    }
+    // Check for @component annotation
+    const hasComponentAnnotation = /@component\s+\w+/.test(content);
+    if (!hasComponentAnnotation) {
+        const issue = {
+            type: "info",
+            message: `Missing @component annotation in component file`,
+            file: filePath,
+            rule: "component-required",
+            annotation: "@component",
+        };
+        // For component, we use info level
+        infos.push(issue);
+    }
+    return {
+        // info is not a blocking issue, so valid is true if only infos
+        valid: errors.length === 0 && warnings.length === 0,
+        skipped: false,
+        errors,
+        warnings,
+        infos,
+    };
+}
+// ============================================
+// Fix Functions for --fix option
+// ============================================
+/**
+ * ファイルパスからスクリーン名を生成
+ *
+ * @param filePath - ファイルパス
+ * @returns スクリーン名 (PascalCase + "Screen")
+ *
+ * @example
+ * ```typescript
+ * generateScreenName("app/[locale]/dashboard/page.tsx")
+ * // Returns: "DashboardScreen"
+ *
+ * generateScreenName("app/[locale]/settings/profile/page.tsx")
+ * // Returns: "SettingsProfileScreen"
+ * ```
+ */
+export function generateScreenName(filePath) {
+    // ファイルパスからルート部分を抽出
+    // app/[locale]/dashboard/page.tsx -> dashboard
+    // apps/web/app/[locale]/posts/[id]/page.tsx -> posts/[id]
+    const parts = filePath.split("/");
+    // app ディレクトリ以降を取得
+    const appIndex = parts.findIndex((p) => p === "app");
+    if (appIndex === -1) {
+        return "UnknownScreen";
+    }
+    // app と page.tsx の間のパーツを取得
+    const routeParts = parts.slice(appIndex + 1, -1); // 最後の page.tsx を除く
+    // [locale] を除外
+    const meaningfulParts = routeParts.filter((p) => p !== "[locale]" && p !== "(auth)" && p !== "(main)");
+    if (meaningfulParts.length === 0) {
+        return "HomeScreen";
+    }
+    // PascalCase に変換
+    const screenName = meaningfulParts
+        .map((part) => {
+        // 動的セグメント [id] -> Id
+        if (part.startsWith("[") && part.endsWith("]")) {
+            const inner = part.slice(1, -1);
+            return inner.charAt(0).toUpperCase() + inner.slice(1);
+        }
+        // kebab-case -> PascalCase
+        return part
+            .split("-")
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+            .join("");
+    })
+        .join("");
+    return `${screenName}Screen`;
+}
+/**
+ * ファイルパスからルートを生成
+ *
+ * @param filePath - ファイルパス
+ * @returns ルートパス
+ *
+ * @example
+ * ```typescript
+ * generateRoute("app/[locale]/posts/page.tsx")
+ * // Returns: "/posts"
+ *
+ * generateRoute("app/[locale]/posts/[id]/page.tsx")
+ * // Returns: "/posts/[id]"
+ * ```
+ */
+export function generateRoute(filePath) {
+    const parts = filePath.split("/");
+    // app ディレクトリ以降を取得
+    const appIndex = parts.findIndex((p) => p === "app");
+    if (appIndex === -1) {
+        return "/";
+    }
+    // app と page.tsx の間のパーツを取得
+    const routeParts = parts.slice(appIndex + 1, -1);
+    // [locale] とグループ (xxx) を除外
+    const meaningfulParts = routeParts.filter((p) => p !== "[locale]" && !p.startsWith("("));
+    if (meaningfulParts.length === 0) {
+        return "/";
+    }
+    return "/" + meaningfulParts.join("/");
+}
+/**
+ * JSDocコメントブロックを検出
+ */
+function findFirstJSDoc(content) {
+    const jsdocPattern = /\/\*\*[\s\S]*?\*\//;
+    const match = content.match(jsdocPattern);
+    if (!match || match.index === undefined) {
+        return null;
+    }
+    return {
+        start: match.index,
+        end: match.index + match[0].length,
+        text: match[0],
+    };
+}
+/**
+ * JSDocにタグを追加または更新
+ */
+function addOrUpdateJSDocTag(jsdocText, tag, value) {
+    // 既存のタグを検索
+    const tagPattern = new RegExp(`@${tag}\\s+[^@\\n]*`, "g");
+    if (tagPattern.test(jsdocText)) {
+        // 既存のタグを更新
+        return jsdocText.replace(tagPattern, `@${tag} ${value}`);
+    }
+    // 閉じる */ の前に新しいタグを追加
+    return jsdocText.replace(/\s*\*\/\s*$/, `\n * @${tag} ${value}\n */`);
+}
+/**
+ * 新しいJSDocブロックを作成
+ */
+function createJSDoc(tags) {
+    const lines = ["/**"];
+    for (const { tag, value } of tags) {
+        lines.push(` * @${tag} ${value}`);
+    }
+    lines.push(" */");
+    return lines.join("\n");
+}
+/**
+ * @usedComponents アノテーションを自動修正
+ *
+ * @param content - ファイル内容
+ * @param filePath - ファイルパス (未使用だが将来の拡張用)
+ * @returns 修正結果
+ */
+export function fixUsedComponentsAnnotation(content, filePath) {
+    // インポートからコンポーネントを抽出
+    const components = extractComponentsFromImports(content, {
+        excludeHooks: true,
+    });
+    // コンポーネントがなければ変更なし
+    if (components.length === 0) {
+        return { changed: false, content };
+    }
+    const componentsList = components.join(", ");
+    const existingAnnotation = extractUsedComponentsAnnotation(content);
+    // 既存のアノテーションと同じなら変更なし
+    if (existingAnnotation.length === components.length &&
+        existingAnnotation.every((c) => components.includes(c))) {
+        return { changed: false, content };
+    }
+    // JSDocを探す
+    const jsdoc = findFirstJSDoc(content);
+    if (jsdoc) {
+        // 既存のJSDocにタグを追加/更新
+        const updatedJSDoc = addOrUpdateJSDocTag(jsdoc.text, "usedComponents", componentsList);
+        const newContent = content.slice(0, jsdoc.start) +
+            updatedJSDoc +
+            content.slice(jsdoc.end);
+        return { changed: true, content: newContent };
+    }
+    // JSDocがない場合、ファイル先頭に新規作成
+    const newJSDoc = createJSDoc([
+        { tag: "usedComponents", value: componentsList },
+    ]);
+    return { changed: true, content: newJSDoc + "\n" + content };
+}
+/**
+ * @screen アノテーションを自動修正
+ *
+ * @param content - ファイル内容
+ * @param filePath - ファイルパス
+ * @returns 修正結果
+ */
+export function fixScreenAnnotation(content, filePath) {
+    // 既存の @screen があれば変更なし
+    if (/@screen\s+\w+/.test(content)) {
+        return { changed: false, content };
+    }
+    const screenName = generateScreenName(filePath);
+    const jsdoc = findFirstJSDoc(content);
+    if (jsdoc) {
+        const updatedJSDoc = addOrUpdateJSDocTag(jsdoc.text, "screen", screenName);
+        const newContent = content.slice(0, jsdoc.start) +
+            updatedJSDoc +
+            content.slice(jsdoc.end);
+        return { changed: true, content: newContent };
+    }
+    const newJSDoc = createJSDoc([{ tag: "screen", value: screenName }]);
+    return { changed: true, content: newJSDoc + "\n" + content };
+}
+/**
+ * @route アノテーションを自動修正
+ *
+ * @param content - ファイル内容
+ * @param filePath - ファイルパス
+ * @returns 修正結果
+ */
+export function fixRouteAnnotation(content, filePath) {
+    // 既存の @route があれば変更なし
+    if (/@route\s+\//.test(content)) {
+        return { changed: false, content };
+    }
+    const route = generateRoute(filePath);
+    const jsdoc = findFirstJSDoc(content);
+    if (jsdoc) {
+        const updatedJSDoc = addOrUpdateJSDocTag(jsdoc.text, "route", route);
+        const newContent = content.slice(0, jsdoc.start) +
+            updatedJSDoc +
+            content.slice(jsdoc.end);
+        return { changed: true, content: newContent };
+    }
+    const newJSDoc = createJSDoc([{ tag: "route", value: route }]);
+    return { changed: true, content: newJSDoc + "\n" + content };
+}
+/**
+ * 複数の修正を一度に適用
+ *
+ * @param content - ファイル内容
+ * @param filePath - ファイルパス
+ * @param options - 修正オプション
+ * @returns 修正結果
+ */
+export function applyFixes(content, filePath, options) {
+    let currentContent = content;
+    const changes = [];
+    // @usedComponents の修正
+    if (options.fixUsedComponents) {
+        const result = fixUsedComponentsAnnotation(currentContent, filePath);
+        if (result.changed) {
+            currentContent = result.content;
+            changes.push("@usedComponents");
+        }
+    }
+    // @screen の修正
+    if (options.fixScreen) {
+        const result = fixScreenAnnotation(currentContent, filePath);
+        if (result.changed) {
+            currentContent = result.content;
+            changes.push("@screen");
+        }
+    }
+    // @route の修正
+    if (options.fixRoute) {
+        const result = fixRouteAnnotation(currentContent, filePath);
+        if (result.changed) {
+            currentContent = result.content;
+            changes.push("@route");
+        }
+    }
+    return {
+        changed: changes.length > 0,
+        content: currentContent,
+        changes,
+    };
+}
+//# sourceMappingURL=annotation-lint.js.map

package/dist/lint/annotation-lint.js.map

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

package/dist/lint/annotation-types.d.ts

@@ -0,0 +1,161 @@
+/**
+ * lint-annotations 用型定義
+ *
+ * コードアノテーションの整合性検証に使用する型
+ */
+/**
+ * アノテーション検証の問題種別
+ */
+export type AnnotationIssueSeverity = "error" | "warning" | "info";
+/**
+ * 検出された問題
+ */
+export interface AnnotationIssue {
+    /** 問題種別 */
+    type: AnnotationIssueSeverity;
+    /** 問題メッセージ */
+    message: string;
+    /** ファイルパス */
+    file: string;
+    /** 行番号（オプション） */
+    line?: number;
+    /** ルールID */
+    rule: string;
+    /** アノテーション種別 */
+    annotation?: string;
+    /** 不足している項目 */
+    missing?: string[];
+    /** 余分な項目 */
+    extra?: string[];
+}
+/**
+ * @usedComponents 比較結果
+ */
+export interface UsedComponentsResult {
+    /** 検証が成功したか */
+    valid: boolean;
+    /** アノテーションに記載されているコンポーネント */
+    annotated: string[];
+    /** インポートされているコンポーネント */
+    imported: string[];
+    /** 不足（インポートにあるがアノテーションにない） */
+    missing: string[];
+    /** 余分（アノテーションにあるがインポートにない） */
+    extra: string[];
+}
+/**
+ * アノテーション存在チェック結果
+ */
+export interface AnnotationCheckResult {
+    /** 検証が成功したか */
+    valid: boolean;
+    /** スキップされたか（除外ファイル等） */
+    skipped: boolean;
+    /** 検出された問題 */
+    errors: AnnotationIssue[];
+    /** 警告 */
+    warnings: AnnotationIssue[];
+    /** 情報 */
+    infos: AnnotationIssue[];
+}
+/**
+ * ファイル検証結果
+ */
+export interface FileAnnotationReport {
+    /** ファイルパス */
+    file: string;
+    /** ファイル種別 (screen, component, action) */
+    fileType: "screen" | "component" | "action" | "other";
+    /** @usedComponents 検証結果 */
+    usedComponents?: UsedComponentsResult;
+    /** @screen 検証結果 */
+    screenCheck?: AnnotationCheckResult;
+    /** @component 検証結果 */
+    componentCheck?: AnnotationCheckResult;
+    /** 総合結果 */
+    result: {
+        valid: boolean;
+        errors: AnnotationIssue[];
+        warnings: AnnotationIssue[];
+        infos: AnnotationIssue[];
+    };
+}
+/**
+ * lint-annotations レポート
+ */
+export interface LintAnnotationsReport {
+    /** ファイル検証結果 */
+    fileResults: FileAnnotationReport[];
+    /** サマリー */
+    summary: {
+        /** チェックしたファイル数 */
+        filesChecked: number;
+        /** 問題のあるファイル数 */
+        filesWithIssues: number;
+        /** @usedComponents 不一致数 */
+        usedComponentsMismatch: number;
+        /** @screen 欠落数 */
+        missingScreen: number;
+        /** @component 欠落数 */
+        missingComponent: number;
+        /** エラー数 */
+        errorCount: number;
+        /** 警告数 */
+        warningCount: number;
+        /** 情報数 */
+        infoCount: number;
+    };
+    /** 合格したか */
+    passed: boolean;
+}
+/**
+ * lint-annotations 設定
+ */
+export interface LintAnnotationsConfig {
+    /** 有効か */
+    enabled: boolean;
+    /** strictモード */
+    strict: boolean;
+    /** ルール設定 */
+    rules: {
+        /** @usedComponents 整合性チェック */
+        "usedComponents-match"?: {
+            severity: AnnotationIssueSeverity;
+            checkOrder?: boolean;
+            excludeHooks?: boolean;
+        };
+        /** @screen 必須チェック */
+        "screen-required"?: {
+            severity: AnnotationIssueSeverity;
+            paths?: string[];
+            exclude?: string[];
+        };
+        /** @component 必須チェック */
+        "component-required"?: {
+            severity: AnnotationIssueSeverity;
+            paths?: string[];
+            exclude?: string[];
+        };
+    };
+    /** グローバル除外パターン */
+    exclude?: string[];
+}
+/**
+ * インポート抽出オプション
+ */
+export interface ExtractImportsOptions {
+    /** フック (useSomething) を除外するか */
+    excludeHooks?: boolean;
+}
+/**
+ * アノテーションチェックオプション
+ */
+export interface AnnotationCheckOptions {
+    /** 除外パターン */
+    exclude?: string[];
+}
+/**
+ * デフォルト設定
+ */
+export declare const defaultLintAnnotationsConfig: LintAnnotationsConfig;
+//# sourceMappingURL=annotation-types.d.ts.map