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

package/dist/parsers/drizzle-schema.js

@@ -0,0 +1,376 @@
+/**
+ * Drizzle ORM スキーマパーサー
+ *
+ * TypeScript スキーマファイルを直接パースしてテーブル情報を抽出。
+ * drizzle-dbml-generator が利用できない場合のフォールバック。
+ *
+ * @module parsers/drizzle-schema
+ */
+import { basename } from "node:path";
+import { readFile, listFiles } from "../utils/file.js";
+import { createLogger } from "../utils/logger.js";
+// =============================================================================
+// メインパーサー
+// =============================================================================
+/**
+ * スキーマディレクトリからすべてのテーブルを抽出
+ */
+export function parseDrizzleSchemaDir(schemaDir, logger) {
+    const log = logger || createLogger(false);
+    const schemaFiles = listFiles(schemaDir, {
+        extensions: [".ts"],
+        recursive: false,
+    }).filter((f) => !f.endsWith(".test.ts") &&
+        !f.endsWith(".spec.ts") &&
+        !basename(f).startsWith("index"));
+    log.debug(`スキーマファイル: ${schemaFiles.length} 件`);
+    const allTables = [];
+    for (const file of schemaFiles) {
+        const content = readFile(file);
+        if (!content)
+            continue;
+        const tables = parseDrizzleSchema(content, file, log);
+        allTables.push(...tables);
+    }
+    log.debug(`抽出テーブル: ${allTables.length} 件`);
+    return {
+        tables: allTables,
+        generatedAt: new Date().toISOString(),
+    };
+}
+/**
+ * 単一スキーマファイルからテーブルを抽出
+ */
+export function parseDrizzleSchema(sourceCode, filePath, logger) {
+    const log = logger || createLogger(false);
+    const tables = [];
+    const fileName = basename(filePath);
+    // pgTable 定義を検出
+    // パターン: export const varName = pgTable("table_name", { ... }, (table) => [...])
+    const pgTableRegex = /(?:\/\*\*[\s\S]*?\*\/\s*)?export\s+const\s+(\w+)\s*=\s*pgTable\s*\(\s*["'](\w+)["']\s*,\s*\{/g;
+    let match;
+    while ((match = pgTableRegex.exec(sourceCode)) !== null) {
+        const variableName = match[1];
+        const tableName = match[2];
+        const defStart = match.index;
+        // JSDoc コメントを抽出
+        const jsDoc = extractJsDocBefore(sourceCode, defStart);
+        const description = extractDescriptionFromJsDoc(jsDoc);
+        // テーブル定義の本体を抽出
+        const tableBody = extractTableBody(sourceCode, match.index + match[0].length - 1);
+        if (!tableBody) {
+            log.debug(`テーブル本体を抽出できません: ${tableName}`);
+            continue;
+        }
+        // カラムを抽出
+        const columns = extractColumns(tableBody.columnsBody, sourceCode, defStart);
+        // インデックスを抽出
+        const indexes = extractIndexes(tableBody.indexesBody);
+        // 外部キーを抽出（カラムの references から）
+        const foreignKeys = extractForeignKeys(tableBody.columnsBody, sourceCode, defStart);
+        tables.push({
+            name: tableName,
+            variableName,
+            file: fileName,
+            description,
+            category: inferCategoryFromFile(fileName),
+            columns,
+            foreignKeys,
+            indexes,
+        });
+        log.debug(`テーブル抽出: ${tableName} (${columns.length} カラム, ${foreignKeys.length} FK, ${indexes.length} インデックス)`);
+    }
+    return tables;
+}
+// =============================================================================
+// 内部ヘルパー関数
+// =============================================================================
+/**
+ * pgTable の本体を抽出（カラム定義とインデックス定義）
+ */
+function extractTableBody(sourceCode, startIndex) {
+    // { から開始して対応する } を見つける
+    let depth = 1;
+    let pos = startIndex + 1;
+    while (pos < sourceCode.length && depth > 0) {
+        const char = sourceCode[pos];
+        if (char === "{")
+            depth++;
+        else if (char === "}")
+            depth--;
+        pos++;
+    }
+    const columnsEnd = pos - 1;
+    const columnsBody = sourceCode.substring(startIndex + 1, columnsEnd);
+    // インデックス定義部分を抽出 }, (table) => [...])
+    let indexesBody = "";
+    const afterColumns = sourceCode.substring(columnsEnd);
+    const indexMatch = afterColumns.match(/^\s*\}\s*,\s*\(\s*\w*\s*\)\s*=>\s*\(\s*\{([\s\S]*?)\}\s*\)/);
+    if (indexMatch) {
+        indexesBody = indexMatch[1];
+    }
+    else {
+        // 別の形式: }, (table) => [...])
+        const altIndexMatch = afterColumns.match(/^\s*\}\s*,\s*\(\s*\w*\s*\)\s*=>\s*\[([\s\S]*?)\]\s*\)/);
+        if (altIndexMatch) {
+            indexesBody = altIndexMatch[1];
+        }
+    }
+    return { columnsBody, indexesBody };
+}
+/**
+ * カラム定義を抽出
+ */
+function extractColumns(columnsBody, fullSource, tableStart) {
+    const columns = [];
+    // カラム定義パターン:
+    // columnName: type('sql_name').constraint1().constraint2()...
+    // /** comment */ columnName: type('sql_name')
+    const columnRegex = /(?:\/\*\*\s*([\s\S]*?)\s*\*\/\s*)?(\w+)\s*:\s*(\w+)\s*\(\s*["'](\w+)["']/g;
+    let match;
+    while ((match = columnRegex.exec(columnsBody)) !== null) {
+        const jsDocComment = match[1];
+        const variableName = match[2];
+        const drizzleType = match[3];
+        const sqlName = match[4];
+        // 残りの定義を抽出（次の行または , まで）
+        const afterMatch = columnsBody.substring(match.index + match[0].length);
+        const restMatch = afterMatch.match(/^[^,\n]*/);
+        const restDef = restMatch ? restMatch[0] : "";
+        // 型を推論
+        const type = mapDrizzleTypeToSql(drizzleType, restDef);
+        // 制約を解析
+        const isPrimaryKey = restDef.includes("primaryKey()") || restDef.includes(".primaryKey()");
+        const isNotNull = restDef.includes("notNull()") || restDef.includes(".notNull()");
+        const isUnique = restDef.includes("unique()") || restDef.includes(".unique()");
+        // デフォルト値を抽出
+        const defaultMatch = restDef.match(/default(?:Now)?\s*\(\s*([^)]*)\s*\)/);
+        const defaultValue = defaultMatch ? defaultMatch[1].trim() || "now()" : undefined;
+        // JSDocから説明を抽出
+        const description = jsDocComment
+            ? jsDocComment.replace(/\s*\n\s*\*?\s*/g, " ").trim()
+            : undefined;
+        columns.push({
+            name: sqlName,
+            variableName,
+            type,
+            primaryKey: isPrimaryKey,
+            nullable: !isNotNull && !isPrimaryKey,
+            unique: isUnique,
+            default: defaultValue,
+            description,
+        });
+    }
+    // スプレッド構文で追加されるカラムを検出 (...timestamps)
+    if (columnsBody.includes("...timestamps")) {
+        columns.push({ name: "created_at", variableName: "createdAt", type: "timestamp", nullable: false }, { name: "updated_at", variableName: "updatedAt", type: "timestamp", nullable: false });
+    }
+    if (columnsBody.includes("...authTimestamps")) {
+        columns.push({ name: "created_at", variableName: "createdAt", type: "timestamp", nullable: false }, { name: "updated_at", variableName: "updatedAt", type: "timestamp", nullable: false });
+    }
+    return columns;
+}
+/**
+ * 外部キーを抽出
+ */
+function extractForeignKeys(columnsBody, fullSource, tableStart) {
+    const foreignKeys = [];
+    // references(() => table.column) パターンを検出
+    // 例: .references(() => users.id, { onDelete: 'cascade' })
+    const refRegex = /(\w+)\s*:\s*\w+\s*\(\s*["'](\w+)["'][^)]*\)(?:[^.]*)?\.references\s*\(\s*\(\s*\)\s*=>\s*(\w+)\.(\w+)/g;
+    let match;
+    while ((match = refRegex.exec(columnsBody)) !== null) {
+        const columnName = match[2]; // SQL カラム名
+        const refTable = match[3]; // 参照テーブル変数名
+        const refColumn = match[4]; // 参照カラム名
+        // onDelete オプションを抽出
+        const afterRef = columnsBody.substring(match.index + match[0].length, match.index + match[0].length + 100);
+        const onDeleteMatch = afterRef.match(/onDelete\s*:\s*["'](\w+)["']/);
+        foreignKeys.push({
+            column: columnName,
+            references: {
+                table: mapVariableToTableName(refTable),
+                column: refColumn,
+            },
+            onDelete: onDeleteMatch ? onDeleteMatch[1] : undefined,
+        });
+    }
+    return foreignKeys;
+}
+/**
+ * インデックス定義を抽出
+ */
+function extractIndexes(indexesBody) {
+    const indexes = [];
+    if (!indexesBody.trim())
+        return indexes;
+    // インデックス定義パターン:
+    // index("name").on(table.col1, table.col2)
+    // uniqueIndex("name").on(table.col)
+    const indexRegex = /(uniqueIndex|index)\s*\(\s*["']([^"']+)["']\s*\)\s*\.on\s*\(([^)]+)\)/g;
+    let match;
+    while ((match = indexRegex.exec(indexesBody)) !== null) {
+        const isUnique = match[1] === "uniqueIndex";
+        const name = match[2];
+        const columnsStr = match[3];
+        // table.col1, table.col2 -> [col1, col2]
+        const columns = columnsStr
+            .split(",")
+            .map((c) => {
+            const colMatch = c.trim().match(/\w+\.(\w+)/);
+            return colMatch ? camelToSnake(colMatch[1]) : "";
+        })
+            .filter((c) => c);
+        indexes.push({
+            name,
+            columns,
+            unique: isUnique,
+        });
+    }
+    return indexes;
+}
+/**
+ * 定義の直前にある JSDoc を抽出
+ */
+function extractJsDocBefore(sourceCode, defStart) {
+    const beforeDef = sourceCode.substring(0, defStart);
+    const jsDocEnd = beforeDef.lastIndexOf("*/");
+    if (jsDocEnd === -1)
+        return "";
+    // */ と定義の間に他のコードがないか確認
+    const between = beforeDef.substring(jsDocEnd + 2);
+    if (!/^\s*$/.test(between))
+        return "";
+    const jsDocStart = beforeDef.lastIndexOf("/**");
+    if (jsDocStart === -1 || jsDocStart > jsDocEnd)
+        return "";
+    return beforeDef.substring(jsDocStart, jsDocEnd + 2);
+}
+/**
+ * JSDoc から説明文を抽出
+ */
+function extractDescriptionFromJsDoc(jsDoc) {
+    if (!jsDoc)
+        return undefined;
+    // /** と */ を除去して行に分割
+    const lines = jsDoc
+        .replace(/^\/\*\*\s*/, "")
+        .replace(/\s*\*\/$/, "")
+        .split("\n")
+        .map((l) => l.replace(/^\s*\*\s?/, "").trim())
+        .filter((l) => !l.startsWith("@"));
+    const description = lines.join(" ").trim();
+    return description || undefined;
+}
+/**
+ * Drizzle 型を SQL 型にマッピング
+ */
+function mapDrizzleTypeToSql(drizzleType, restDef) {
+    const typeMap = {
+        uuid: "uuid",
+        text: "text",
+        varchar: "varchar",
+        char: "char",
+        integer: "integer",
+        smallint: "smallint",
+        bigint: "bigint",
+        serial: "serial",
+        smallserial: "smallserial",
+        bigserial: "bigserial",
+        boolean: "boolean",
+        timestamp: "timestamp",
+        date: "date",
+        time: "time",
+        interval: "interval",
+        numeric: "numeric",
+        decimal: "decimal",
+        real: "real",
+        doublePrecision: "double precision",
+        json: "json",
+        jsonb: "jsonb",
+        bytea: "bytea",
+        inet: "inet",
+        cidr: "cidr",
+        macaddr: "macaddr",
+    };
+    return typeMap[drizzleType] || drizzleType;
+}
+/**
+ * 変数名をテーブル名にマッピング
+ */
+function mapVariableToTableName(variableName) {
+    // users, sessions, accounts などはそのまま
+    // 単数形→複数形の変換は不要（変数名がそのままテーブル名の場合が多い）
+    return variableName;
+}
+/**
+ * camelCase を snake_case に変換
+ */
+function camelToSnake(str) {
+    return str.replace(/[A-Z]/g, (m) => "_" + m.toLowerCase());
+}
+/**
+ * ファイル名からカテゴリを推論
+ */
+function inferCategoryFromFile(fileName) {
+    const name = fileName.replace(/\.ts$/, "").toLowerCase();
+    const categoryMap = {
+        auth: "authentication",
+        users: "authentication",
+        sessions: "authentication",
+        accounts: "authentication",
+        verification: "authentication",
+        content: "content",
+        posts: "content",
+        categories: "content",
+        tags: "content",
+        comments: "content",
+        organizations: "organizations",
+        projects: "projects",
+        entities: "entities",
+        relations: "relations",
+        activities: "activities",
+        tokens: "tokens",
+        common: "common",
+        audit: "audit",
+    };
+    return categoryMap[name] || "other";
+}
+/**
+ * DrizzleSchemaResult を Portal 用 JSON に変換
+ */
+export function toPortalDbSchema(result) {
+    return {
+        tables: result.tables.map((table) => ({
+            name: table.name,
+            file: table.file,
+            description: table.description,
+            category: table.category,
+            columnCount: table.columns.length,
+            columns: table.columns.map((col) => ({
+                name: col.name,
+                type: col.type,
+                primaryKey: col.primaryKey,
+                nullable: col.nullable,
+                unique: col.unique,
+                default: col.default,
+                description: col.description,
+            })),
+            foreignKeys: table.foreignKeys.length > 0
+                ? table.foreignKeys.map((fk) => ({
+                    column: fk.column,
+                    references: fk.references,
+                }))
+                : undefined,
+            indexes: table.indexes.length > 0
+                ? table.indexes.map((idx) => ({
+                    name: idx.name,
+                    columns: idx.columns,
+                    unique: idx.unique,
+                }))
+                : undefined,
+        })),
+        generatedAt: result.generatedAt,
+    };
+}
+//# sourceMappingURL=drizzle-schema.js.map

package/dist/parsers/drizzle-schema.js.map

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

package/dist/parsers/feature-map-tags.d.ts

@@ -0,0 +1,45 @@
+/**
+ * feature-map JSDoc タグパーサー
+ *
+ * TypeScript ファイルから feature-map 用のカスタム JSDoc タグを解析し、
+ * FeatureMapItem に変換する。
+ */
+import type { FeatureMapItem, FileMetadata, ParseResult } from "../commands/feature-map-types.js";
+/**
+ * ファイルヘッダー領域の終了位置を検出
+ *
+ * @description
+ * ファイルヘッダー領域とは、以下のいずれかが最初に現れるまでの領域:
+ * - "use server" または "use client" ディレクティブ
+ * - import 文
+ * - export 文
+ * - 通常の関数/変数宣言
+ *
+ * ファイルヘッダー内のJSDocコメントは、モジュール全体のドキュメントとして扱い、
+ * 個別のアイテム（Screen/Component/Action）として抽出しない。
+ *
+ * @param content - ファイル内容
+ * @returns ヘッダー領域の終了位置（インデックス）
+ */
+export declare function findCodeStartIndex(content: string): number;
+/**
+ * ファイルヘッダーからメタデータを抽出
+ */
+export declare function extractFileMetadata(content: string, codeStartIndex: number): FileMetadata;
+/**
+ * ファイルから Feature Map タグを解析
+ */
+export declare function parseFeatureMapTags(content: string, filePath: string): FeatureMapItem[];
+/**
+ * ファイルから Feature Map タグを解析（メタデータ付き）
+ */
+export declare function parseFeatureMapTagsWithMetadata(content: string, filePath: string): ParseResult;
+/**
+ * コメント後のコードからアイテム名を抽出
+ */
+export declare function extractItemName(code: string): string | undefined;
+/**
+ * JSDoc ブロックを解析（ファイルメタデータ継承版）
+ */
+export declare function parseJSDocBlock(jsdocBlock: string, filePath: string, defaultName: string | undefined, fileMetadata: FileMetadata): FeatureMapItem | null;
+//# sourceMappingURL=feature-map-tags.d.ts.map

package/dist/parsers/feature-map-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-map-tags.d.ts","sourceRoot":"","sources":["../../src/parsers/feature-map-tags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EAGZ,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAyB1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,YAAY,CA+BzF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAEvF;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAwG9F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkBhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,YAAY,EAAE,YAAY,GACzB,cAAc,GAAG,IAAI,CAwFvB"}