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

package/dist/analyzers/reference-analyzer.js

@@ -0,0 +1,372 @@
+/**
+ * reference-analyzer.ts - ts-morph を使った自動参照解析
+ *
+ * コードベースを解析し、以下の使用関係を自動検出する：
+ * - Screen → Component: import + JSX使用
+ * - Screen → Action: import + 関数呼び出し
+ * - Component → Action: import + 関数呼び出し
+ * - Module → (逆参照): 上記から逆引き
+ */
+import { Project, SyntaxKind, Node } from "ts-morph";
+import { resolve, relative, dirname, basename } from "node:path";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger();
+// ===== デフォルトパターン =====
+const DEFAULT_COMPONENT_PATTERNS = [
+    /\/components\//,
+    /@\/components\//, // @/components/ エイリアス形式
+    /\/app\/.*\/components\//,
+];
+const DEFAULT_ACTION_PATTERNS = [
+    /\/lib\/actions\//,
+    /@\/lib\/actions\//, // @/lib/actions/ エイリアス形式
+    /\/actions\//,
+    /@\/actions\//, // @/actions/ エイリアス形式
+];
+const DEFAULT_MODULE_PATTERNS = [
+    /\/lib\/(?!actions)/, // lib/ 配下で actions 以外
+    /@\/lib\/(?!actions)/, // @/lib/ エイリアス形式（actions以外）
+];
+// ===== メイン解析関数 =====
+/**
+ * プロジェクトの参照関係を解析する
+ */
+export function analyzeProjectReferences(options) {
+    const { projectPath, tsConfigPath, targetFiles, componentPatterns = DEFAULT_COMPONENT_PATTERNS, actionPatterns = DEFAULT_ACTION_PATTERNS, modulePatterns = DEFAULT_MODULE_PATTERNS, verbose = false, } = options;
+    if (verbose) {
+        logger.info(`参照解析を開始: ${targetFiles.length} ファイル`);
+    }
+    // ts-morph プロジェクトを初期化
+    const project = new Project({
+        tsConfigFilePath: tsConfigPath || resolve(projectPath, "tsconfig.json"),
+        skipAddingFilesFromTsConfig: true,
+    });
+    // 対象ファイルを追加
+    for (const file of targetFiles) {
+        try {
+            project.addSourceFileAtPath(file);
+        }
+        catch {
+            // ファイルが存在しない場合はスキップ
+            if (verbose) {
+                logger.warn(`ファイルをスキップ: ${file}`);
+            }
+        }
+    }
+    const fileUsages = new Map();
+    const sourceFiles = project.getSourceFiles();
+    if (verbose) {
+        logger.info(`解析対象: ${sourceFiles.length} ファイル`);
+    }
+    // 各ファイルを解析
+    for (const sourceFile of sourceFiles) {
+        const filePath = relative(projectPath, sourceFile.getFilePath());
+        const usage = analyzeFileUsage(sourceFile, projectPath, componentPatterns, actionPatterns, modulePatterns);
+        if (usage.usedComponents.length > 0 ||
+            usage.usedActions.length > 0 ||
+            usage.usedModules.length > 0) {
+            fileUsages.set(filePath, usage);
+        }
+    }
+    // 逆参照マップを構築
+    const reverseRefs = buildReverseReferences(fileUsages);
+    if (verbose) {
+        logger.info(`解析完了: ${fileUsages.size} ファイルで参照を検出`);
+    }
+    // メモリ解放
+    project.getSourceFiles().forEach(sf => project.removeSourceFile(sf));
+    return { fileUsages, reverseRefs };
+}
+// ===== ファイル解析 =====
+/**
+ * 単一ファイルの使用関係を解析
+ */
+function analyzeFileUsage(sourceFile, projectPath, componentPatterns, actionPatterns, modulePatterns) {
+    const filePath = relative(projectPath, sourceFile.getFilePath());
+    const usedComponents = [];
+    const usedActions = [];
+    const usedModules = [];
+    const usedModulePaths = [];
+    // import 文を解析
+    const imports = sourceFile.getImportDeclarations();
+    for (const imp of imports) {
+        const moduleSpecifier = imp.getModuleSpecifierValue();
+        // 外部パッケージはスキップ
+        if (!moduleSpecifier.startsWith(".") && !moduleSpecifier.startsWith("@/")) {
+            continue;
+        }
+        // import 元のカテゴリを判定
+        const importCategory = categorizeImport(moduleSpecifier, componentPatterns, actionPatterns, modulePatterns);
+        if (importCategory === "none")
+            continue;
+        // モジュールの場合、パスも記録
+        if (importCategory === "module") {
+            const resolvedPath = resolveModulePath(moduleSpecifier, filePath, projectPath);
+            if (resolvedPath) {
+                usedModulePaths.push(resolvedPath);
+            }
+        }
+        // named import を抽出
+        const namedImports = imp.getNamedImports();
+        for (const named of namedImports) {
+            const name = named.getName();
+            switch (importCategory) {
+                case "component":
+                    // JSX で実際に使用されているか確認
+                    if (isUsedAsJsxElement(sourceFile, name)) {
+                        usedComponents.push(name);
+                    }
+                    break;
+                case "action":
+                    // 関数として呼び出されているか確認
+                    if (isCalledAsFunction(sourceFile, name)) {
+                        usedActions.push(name);
+                    }
+                    break;
+                case "module":
+                    // import されていれば使用とみなす
+                    usedModules.push(name);
+                    break;
+            }
+        }
+        // default import を抽出
+        const defaultImport = imp.getDefaultImport();
+        if (defaultImport) {
+            const name = defaultImport.getText();
+            switch (importCategory) {
+                case "component":
+                    if (isUsedAsJsxElement(sourceFile, name)) {
+                        usedComponents.push(name);
+                    }
+                    break;
+                case "action":
+                    if (isCalledAsFunction(sourceFile, name)) {
+                        usedActions.push(name);
+                    }
+                    break;
+                case "module":
+                    usedModules.push(name);
+                    break;
+            }
+        }
+    }
+    return {
+        filePath,
+        usedComponents: [...new Set(usedComponents)],
+        usedActions: [...new Set(usedActions)],
+        usedModules: [...new Set(usedModules)],
+        usedModulePaths: [...new Set(usedModulePaths)],
+    };
+}
+/**
+ * モジュールspecifierからファイルパスを解決
+ * @example "@/lib/auth/client" → "apps/admin/lib/auth/client.ts"
+ */
+function resolveModulePath(moduleSpecifier, importerPath, projectPath) {
+    // @/ エイリアスの処理
+    if (moduleSpecifier.startsWith("@/")) {
+        // @/lib/auth/client → lib/auth/client
+        const aliasPath = moduleSpecifier.slice(2);
+        // importer のアプリディレクトリを取得
+        const appMatch = importerPath.match(/^(apps\/[^/]+)\//);
+        if (appMatch) {
+            const appDir = appMatch[1];
+            // 拡張子がない場合は .ts を追加
+            const fullPath = `${appDir}/${aliasPath}`;
+            return fullPath.endsWith(".ts") || fullPath.endsWith(".tsx")
+                ? fullPath
+                : `${fullPath}.ts`;
+        }
+        return null;
+    }
+    // 相対パスの処理
+    if (moduleSpecifier.startsWith(".")) {
+        const importerDir = dirname(importerPath);
+        const resolvedPath = resolve(importerDir, moduleSpecifier);
+        const relativePath = relative(projectPath, resolvedPath);
+        return relativePath.endsWith(".ts") || relativePath.endsWith(".tsx")
+            ? relativePath
+            : `${relativePath}.ts`;
+    }
+    return null;
+}
+/**
+ * import 元のカテゴリを判定
+ */
+function categorizeImport(moduleSpecifier, componentPatterns, actionPatterns, modulePatterns) {
+    // コンポーネント
+    for (const pattern of componentPatterns) {
+        if (pattern.test(moduleSpecifier)) {
+            return "component";
+        }
+    }
+    // アクション
+    for (const pattern of actionPatterns) {
+        if (pattern.test(moduleSpecifier)) {
+            return "action";
+        }
+    }
+    // モジュール
+    for (const pattern of modulePatterns) {
+        if (pattern.test(moduleSpecifier)) {
+            return "module";
+        }
+    }
+    return "none";
+}
+/**
+ * 名前が JSX 要素として使用されているか確認
+ */
+function isUsedAsJsxElement(sourceFile, name) {
+    // JsxOpeningElement と JsxSelfClosingElement を検索
+    const jsxElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxOpeningElement);
+    const jsxSelfClosing = sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement);
+    for (const element of [...jsxElements, ...jsxSelfClosing]) {
+        const tagName = element.getTagNameNode().getText();
+        // 完全一致またはドット記法の先頭部分が一致
+        if (tagName === name || tagName.startsWith(`${name}.`)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * 名前が関数として呼び出されているか確認
+ */
+function isCalledAsFunction(sourceFile, name) {
+    const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression);
+    for (const call of callExpressions) {
+        const expression = call.getExpression();
+        const text = expression.getText();
+        // 直接呼び出し: actionName()
+        if (text === name) {
+            return true;
+        }
+        // await 呼び出し: await actionName()
+        // チェーン呼び出し: actionName.bind()
+        if (text.startsWith(`${name}.`) || text.startsWith(`${name}(`)) {
+            return true;
+        }
+    }
+    // AwaitExpression 内の呼び出しもチェック
+    const awaitExpressions = sourceFile.getDescendantsOfKind(SyntaxKind.AwaitExpression);
+    for (const awaitExpr of awaitExpressions) {
+        const expression = awaitExpr.getExpression();
+        if (Node.isCallExpression(expression)) {
+            const calleeText = expression.getExpression().getText();
+            if (calleeText === name) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+// ===== 逆参照マップ構築 =====
+/**
+ * ファイル使用情報から逆参照マップを構築
+ */
+function buildReverseReferences(fileUsages) {
+    const componentToFiles = new Map();
+    const actionToFiles = new Map();
+    const moduleToFiles = new Map();
+    const modulePathToFiles = new Map();
+    for (const [filePath, usage] of fileUsages) {
+        // コンポーネントの逆参照
+        for (const comp of usage.usedComponents) {
+            const existing = componentToFiles.get(comp) || [];
+            existing.push(filePath);
+            componentToFiles.set(comp, existing);
+        }
+        // アクションの逆参照
+        for (const action of usage.usedActions) {
+            const existing = actionToFiles.get(action) || [];
+            existing.push(filePath);
+            actionToFiles.set(action, existing);
+        }
+        // モジュールの逆参照（シンボル名）
+        for (const mod of usage.usedModules) {
+            const existing = moduleToFiles.get(mod) || [];
+            existing.push(filePath);
+            moduleToFiles.set(mod, existing);
+        }
+        // モジュールの逆参照（ファイルパス）
+        for (const modPath of usage.usedModulePaths) {
+            const existing = modulePathToFiles.get(modPath) || [];
+            existing.push(filePath);
+            modulePathToFiles.set(modPath, existing);
+        }
+    }
+    return {
+        componentToFiles,
+        actionToFiles,
+        moduleToFiles,
+        modulePathToFiles,
+    };
+}
+// ===== ユーティリティ関数 =====
+/**
+ * ファイルパスから要素名を抽出
+ * 例: "apps/admin/app/[locale]/posts/page.tsx" → "PostsScreen"
+ */
+export function extractElementNameFromPath(filePath, type) {
+    const fileName = basename(filePath, ".tsx").replace(".ts", "");
+    switch (type) {
+        case "screen":
+            // page.tsx → 親ディレクトリ名 + Screen
+            if (fileName === "page") {
+                const dir = basename(dirname(filePath));
+                // [locale] などの動的セグメントは除外
+                if (dir.startsWith("[") && dir.endsWith("]")) {
+                    const parentDir = basename(dirname(dirname(filePath)));
+                    return toPascalCase(parentDir) + "Screen";
+                }
+                return toPascalCase(dir) + "Screen";
+            }
+            return toPascalCase(fileName) + "Screen";
+        case "component":
+            return toPascalCase(fileName);
+        case "action":
+            return fileName; // アクションは camelCase のまま
+    }
+}
+/**
+ * kebab-case/snake_case を PascalCase に変換
+ */
+function toPascalCase(str) {
+    return str
+        .split(/[-_]/)
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join("");
+}
+/**
+ * ファイルパスが Screen ファイルかどうか判定
+ */
+export function isScreenFile(filePath) {
+    return filePath.includes("/app/") && filePath.endsWith("/page.tsx");
+}
+/**
+ * ファイルパスが Component ファイルかどうか判定
+ */
+export function isComponentFile(filePath) {
+    return filePath.includes("/components/") && filePath.endsWith(".tsx");
+}
+/**
+ * ファイルパスが Action ファイルかどうか判定
+ */
+export function isActionFile(filePath) {
+    return (filePath.includes("/lib/actions/") || filePath.includes("/actions/"))
+        && filePath.endsWith(".ts");
+}
+/**
+ * ファイルパスが Middleware ファイルかどうか判定
+ */
+export function isMiddlewareFile(filePath) {
+    return filePath.endsWith("/middleware.ts") || filePath.endsWith("/middleware.tsx");
+}
+/**
+ * ファイルパスが Layout ファイルかどうか判定
+ */
+export function isLayoutFile(filePath) {
+    return filePath.includes("/app/") && filePath.endsWith("/layout.tsx");
+}
+//# sourceMappingURL=reference-analyzer.js.map

package/dist/analyzers/reference-analyzer.js.map

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

package/dist/commands/adr.d.ts

@@ -0,0 +1,26 @@
+/**
+ * adr command - Architecture Decision Records management via GitHub Discussions
+ *
+ * ADRs are stored in GitHub Discussions (ADR category).
+ * This command is a convenience wrapper around discussions.
+ *
+ * Subcommands:
+ * - create: Create a new ADR Discussion
+ * - list: List ADR Discussions
+ * - get: Get ADR Discussion details
+ */
+/**
+ * ADR command options
+ */
+interface AdrOptions {
+    verbose?: boolean;
+    limit?: number;
+    repo?: string;
+    public?: boolean;
+}
+/**
+ * adr command handler
+ */
+export declare function adrCommand(action: string, titleOrTarget: string | undefined, options: AdrOptions): Promise<void>;
+export {};
+//# sourceMappingURL=adr.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adr.d.ts","sourceRoot":"","sources":["../../src/commands/adr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;GAEG;AACH,UAAU,UAAU;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAsGD;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/commands/adr.js

@@ -0,0 +1,129 @@
+/**
+ * adr command - Architecture Decision Records management via GitHub Discussions
+ *
+ * ADRs are stored in GitHub Discussions (ADR category).
+ * This command is a convenience wrapper around discussions.
+ *
+ * Subcommands:
+ * - create: Create a new ADR Discussion
+ * - list: List ADR Discussions
+ * - get: Get ADR Discussion details
+ */
+import { createLogger } from "../utils/logger.js";
+import { discussionsCommand } from "./discussions.js";
+/** ADR category name in GitHub Discussions */
+const ADR_CATEGORY = "ADR";
+/**
+ * Format ADR title with numbering convention
+ */
+function formatAdrTitle(title) {
+    // If already formatted as ADR-XXXX, keep as-is
+    if (/^ADR-\d{4}:/i.test(title)) {
+        return title;
+    }
+    // Otherwise, prefix with ADR- (number will be the Discussion number)
+    return `ADR: ${title}`;
+}
+/**
+ * Build ADR body from template
+ */
+function buildAdrBody(title) {
+    const today = new Date().toISOString().split("T")[0];
+    return `## Status
+Proposed
+
+## Date
+${today}
+
+## Context
+[What is the issue that is motivating this decision? What context or background is relevant?]
+
+## Decision
+[What change are we proposing/implementing? What alternatives were considered?]
+
+## Consequences
+[What becomes easier or harder as a result of this decision?]
+
+### Positive
+-
+
+### Concerns
+-
+
+## Related
+- Related ADRs: None
+- Related code:
+- References:
+`;
+}
+/**
+ * create subcommand - Create a new ADR as GitHub Discussion
+ */
+async function cmdCreate(title, options, logger) {
+    const formattedTitle = formatAdrTitle(title);
+    const body = buildAdrBody(title);
+    logger.info(`Creating ADR Discussion: ${formattedTitle}`);
+    await discussionsCommand("create", undefined, {
+        category: ADR_CATEGORY,
+        title: formattedTitle,
+        body,
+        verbose: options.verbose,
+        repo: options.repo,
+        public: options.public,
+    });
+}
+/**
+ * list subcommand - List ADR Discussions
+ */
+async function cmdList(options, logger) {
+    await discussionsCommand("list", undefined, {
+        category: ADR_CATEGORY,
+        limit: options.limit,
+        verbose: options.verbose,
+        repo: options.repo,
+        public: options.public,
+    });
+}
+/**
+ * get subcommand - Get ADR Discussion details
+ */
+async function cmdGet(target, options, logger) {
+    await discussionsCommand("get", target, {
+        verbose: options.verbose,
+        repo: options.repo,
+        public: options.public,
+    });
+}
+/**
+ * adr command handler
+ */
+export async function adrCommand(action, titleOrTarget, options) {
+    const logger = createLogger(options.verbose);
+    logger.debug(`ADR action: ${action}`);
+    switch (action) {
+        case "create":
+            if (!titleOrTarget) {
+                logger.error("Title is required");
+                logger.info('Usage: shirokuma-docs adr create "Decision title"');
+                process.exit(1);
+            }
+            await cmdCreate(titleOrTarget, options, logger);
+            break;
+        case "list":
+            await cmdList(options, logger);
+            break;
+        case "get":
+            if (!titleOrTarget) {
+                logger.error("Discussion number is required");
+                logger.info("Usage: shirokuma-docs adr get <number>");
+                process.exit(1);
+            }
+            await cmdGet(titleOrTarget, options, logger);
+            break;
+        default:
+            logger.error(`Unknown action: ${action}`);
+            logger.info("Available actions: create, list, get");
+            process.exit(1);
+    }
+}
+//# sourceMappingURL=adr.js.map

package/dist/commands/adr.js.map

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

package/dist/commands/api-tools.d.ts

@@ -0,0 +1,83 @@
+/**
+ * API Tools documentation generator
+ *
+ * Parses MCP Tool[] definitions and generates documentation.
+ * Supports apps/mcp/src/tools/*.ts structure.
+ */
+/**
+ * MCP Tool parameter definition
+ */
+export interface ApiToolParam {
+    name: string;
+    type: string;
+    description: string;
+    required: boolean;
+    default?: unknown;
+}
+/**
+ * MCP Tool annotation data from JSDoc
+ */
+export interface ApiToolAnnotation {
+    feature?: string;
+    dbTables?: string[];
+    authLevel?: "none" | "authenticated" | "member" | "admin";
+    relatedTests?: string;
+}
+/**
+ * Test case linked to MCP tool
+ */
+export interface ApiToolTest {
+    testdoc: string;
+    target: string;
+    feature?: string;
+    file: string;
+}
+/**
+ * HTTP Method type for Swagger-style display
+ */
+export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+/**
+ * MCP Tool definition
+ */
+export interface ApiToolDef {
+    name: string;
+    description: string;
+    params: ApiToolParam[];
+    sourceFile: string;
+    app: string;
+    category: string;
+    feature?: string;
+    dbTables?: string[];
+    authLevel?: string;
+    relatedTests?: string;
+    tests?: ApiToolTest[];
+    testCoverage?: {
+        hasTest: boolean;
+        totalTests: number;
+        coverageScore: number;
+    };
+    httpMethod?: HttpMethod;
+}
+/**
+ * API Tools output structure
+ */
+export interface ApiToolsOutput {
+    generatedAt: string;
+    projectPath: string;
+    tools: ApiToolDef[];
+    categories: string[];
+    apps: string[];
+}
+/**
+ * API Tools command options
+ */
+export interface ApiToolsOptions {
+    projectPath: string;
+    configPath?: string;
+    outputDir?: string;
+}
+/**
+ * Run API Tools documentation generator
+ */
+export declare function runApiTools(options: ApiToolsOptions): Promise<void>;
+//# sourceMappingURL=api-tools.d.ts.map

package/dist/commands/api-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-tools.d.ts","sourceRoot":"","sources":["../../src/commands/api-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IAEtB,YAAY,CAAC,EAAE;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IAEF,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AA0CD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AA8oBD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6CD;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAuGzE"}