shirokuma-docs 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ShirokumaLibrary
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,294 @@
+# shirokuma-docs
+
+Next.js + TypeScript project documentation generator CLI with bundled Claude Code skills.
+
+## Installation
+
+### Recommended: Installer Script (No sudo required)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ShirokumaLibrary/shirokuma-docs/main/install.sh | bash
+```
+
+To pre-select a language:
+
+```bash
+# Japanese
+curl -fsSL https://raw.githubusercontent.com/ShirokumaLibrary/shirokuma-docs/main/install.sh | bash -s -- --lang ja
+
+# English
+curl -fsSL https://raw.githubusercontent.com/ShirokumaLibrary/shirokuma-docs/main/install.sh | bash -s -- --lang en
+```
+
+This installs shirokuma-docs to `~/.local/` with a symlink in `~/.local/bin/`. Claude Code users already have `~/.local/bin` in PATH.
+
+### Alternative: npm / pnpm global install
+
+```bash
+# npm
+npm install -g shirokuma-docs
+
+# pnpm
+pnpm add -g shirokuma-docs
+```
+
+### Verify Installation
+
+```bash
+shirokuma-docs --version
+# => 0.1.0-alpha.1
+```
+
+## Getting Started
+
+```bash
+# Initialize in your project directory
+cd /path/to/your/project
+shirokuma-docs init --with-skills --with-rules --lang en
+```
+
+This single command:
+1. Creates `shirokuma-docs.config.yaml`
+2. Installs the **shirokuma-skills** plugin to `.claude/plugins/`
+3. Installs **shirokuma-hooks** safety hooks plugin
+4. Deploys rules to `.claude/rules/shirokuma/`
+5. Registers the plugin in Claude Code's global cache (auto-detected)
+
+Start a new Claude Code session and the skills will be available.
+
+## Upgrade
+
+```bash
+# Step 1: Update CLI
+curl -fsSL https://raw.githubusercontent.com/ShirokumaLibrary/shirokuma-docs/main/install.sh | bash
+# or: npm update -g shirokuma-docs
+
+# Step 2: Update plugins, rules, and cache
+cd /path/to/your/project
+shirokuma-docs update
+
+# Step 3: Start a new Claude Code session
+```
+
+### Troubleshooting
+
+If skills don't update after `shirokuma-docs update`:
+
+```bash
+# Force cache refresh
+claude plugin uninstall shirokuma-skills-en@shirokuma-library --scope project
+claude plugin install shirokuma-skills-en@shirokuma-library --scope project
+```
+
+## Uninstall
+
+```bash
+# If installed via install.sh
+rm -f ~/.local/bin/shirokuma-docs
+rm -rf ~/.local/share/shirokuma-docs
+
+# If installed via npm
+npm uninstall -g shirokuma-docs
+```
+
+To remove per-project files:
+
+```bash
+rm -rf .claude/plugins/shirokuma-skills-*/
+rm -rf .claude/plugins/shirokuma-hooks/
+rm -rf .claude/rules/shirokuma/
+rm -f shirokuma-docs.config.yaml
+```
+
+## Features
+
+### Documentation Generation (16 commands)
+
+| Command | Description |
+|---------|-------------|
+| `typedoc` | TypeDoc API documentation |
+| `schema` | Drizzle ORM to DBML/SVG ER diagrams |
+| `deps` | Dependency graph (dependency-cruiser) |
+| `test-cases` | Jest/Playwright test case extraction |
+| `coverage` | Jest coverage dashboard |
+| `portal` | Dark-themed HTML documentation portal |
+| `search-index` | Full-text search JSON index |
+| `overview` | Project overview page |
+| `feature-map` | Feature hierarchy map (4-layer) |
+| `link-docs` | API-test bidirectional links |
+| `screenshots` | Playwright screenshot generation |
+| `details` | Entity detail pages (Screen, Component, Action, Table) |
+| `impact` | Change impact analysis |
+| `api-tools` | MCP tool documentation |
+| `i18n` | i18n translation file documentation |
+| `packages` | Monorepo shared package documentation |
+
+### Validation (7 commands)
+
+| Command | Description |
+|---------|-------------|
+| `lint-tests` | @testdoc comment quality check |
+| `lint-coverage` | Implementation-test correspondence check |
+| `lint-docs` | Document structure validation |
+| `lint-code` | Code annotation / structure validation |
+| `lint-annotations` | Annotation consistency validation |
+| `lint-structure` | Project structure validation |
+| `lint-workflow` | AI workflow convention validation |
+
+### GitHub Integration (5 commands)
+
+| Command | Description |
+|---------|-------------|
+| `issues` | GitHub Issues management (Projects field integration) |
+| `projects` | GitHub Projects V2 management |
+| `discussions` | GitHub Discussions management |
+| `repo` | Repository info / label management |
+| `discussion-templates` | Discussion form template generation (i18n) |
+
+### Session Management
+
+| Command | Description |
+|---------|-------------|
+| `session start` | Start session (handover + issues + PRs) |
+| `session end` | End session (save handover + status update) |
+| `session check` | Issue-Project status consistency check (`--fix` for auto-repair) |
+
+### Management & Utilities
+
+| Command | Description |
+|---------|-------------|
+| `init` | Initialize config (with `--with-skills --with-rules` support) |
+| `generate` | Run all generation commands |
+| `update` | Update skills, rules, and cache (shorthand for `update-skills --sync`) |
+| `update-skills` | Update skills/rules with detailed options |
+| `adr` | ADR management (GitHub Discussions integration) |
+| `repo-pairs` | Public/Private repository pair management |
+| `github-data` | GitHub data JSON generation |
+| `md` | LLM-optimized Markdown management (build, validate, analyze, lint, list, extract) |
+
+## Claude Code Integration
+
+shirokuma-docs bundles the **shirokuma-skills** plugin (EN/JA), which provides skills, agents, and rules for Claude Code.
+
+### Key Skills (22 total)
+
+Invoke any skill as a slash command: `/<skill-name>` (e.g., `/committing-on-issue`, `/working-on-issue #42`).
+
+| Category | Skill | Purpose |
+|----------|-------|---------|
+| **Orchestration** | `working-on-issue` | Work dispatcher (entry point) |
+| | `planning-on-issue` | Issue planning phase |
+| **Session** | `starting-session` | Start work session |
+| | `ending-session` | End session with handover |
+| **Development** | `nextjs-vibe-coding` | TDD implementation for Next.js |
+| | `frontend-designing` | Distinctive UI design |
+| | `codebase-rule-discovery` | Pattern discovery + convention proposal |
+| | `reviewing-on-issue` | Code / security review |
+| | `best-practices-researching` | Research best practices |
+| | `claude-config-reviewing` | Config file quality check |
+| **Git / GitHub** | `committing-on-issue` | Stage, commit, push |
+| | `creating-pr-on-issue` | Create pull request |
+| | `managing-github-items` | Issue / Discussion creation |
+| | `showing-github` | Display project data / dashboard |
+| | `github-project-setup` | Project initial setup |
+| **Config** | `managing-skills` | Create / update skills |
+| | `managing-agents` | Create / update agents |
+| | `managing-rules` | Create / update rules |
+| | `managing-plugins` | Create / update plugins |
+| | `managing-output-styles` | Manage output styles |
+| **Other** | `project-config-generator` | Generate project config files |
+| | `publishing` | Public release via repo-pairs |
+
+### Rules (21 total)
+
+Deployed to `.claude/rules/shirokuma/`, covering:
+- Git commit style and branch workflow
+- GitHub project item management and Discussion usage
+- Next.js best practices (tech stack, known issues, testing, Tailwind v4)
+- shirokuma-docs CLI usage and plugin cache management
+- Memory operations and config authoring
+
+## Configuration
+
+`shirokuma-docs.config.yaml`:
+
+```yaml
+project:
+  name: "MyProject"
+  description: "Project description"
+
+output:
+  dir: "./docs"
+  portal: "./docs/portal"
+  generated: "./docs/generated"
+
+typedoc:
+  entryPoints:
+    - "./apps/web/lib/actions"
+    - "./packages/database/src/schema"
+  tsconfig: "./tsconfig.json"
+
+schema:
+  sources:
+    - path: "./packages/database/src/schema"
+
+deps:
+  include:
+    - "apps/web/lib/actions"
+    - "apps/web/components"
+  exclude:
+    - "node_modules"
+    - ".next"
+
+testCases:
+  jest:
+    config: "./jest.config.ts"
+    testMatch: ["**/__tests__/**/*.test.{ts,tsx}"]
+  playwright:
+    config: "./playwright.config.ts"
+    testDir: "./tests/e2e"
+
+github:
+  discussionsCategory: "Handovers"
+  listLimit: 20
+```
+
+## Output Structure
+
+```
+docs/
+├── portal/
+│   ├── index.html       # Portal top page
+│   ├── viewer.html      # Markdown/DBML/SVG viewer
+│   └── test-cases.html  # Test case list
+└── generated/
+    ├── api/             # TypeDoc Markdown
+    ├── api-html/        # TypeDoc HTML
+    ├── schema/
+    │   ├── schema.dbml
+    │   └── schema-docs.md
+    ├── dependencies.svg
+    ├── dependencies.html
+    └── test-cases.md
+```
+
+## Requirements
+
+- **Node.js**: 20.0.0+
+- **Claude Code**: For skills/rules integration
+- **gh CLI**: For GitHub commands (`gh auth login` required)
+
+### Optional Dependencies
+
+| Tool | Purpose | Install |
+|------|---------|---------|
+| graphviz | Dependency graph SVG | `apt install graphviz` |
+| typedoc | API documentation | `npm i -D typedoc typedoc-plugin-markdown` |
+| dependency-cruiser | Dependency analysis | `npm i -D dependency-cruiser` |
+| drizzle-dbml-generator | DBML generation | `npm i -D drizzle-dbml-generator` |
+
+## License
+
+MIT
+
+See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for third-party license information.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,18 @@
+# Third-Party Notices
+
+This project is licensed under the MIT License.
+The following components are licensed under different terms.
+
+## Apache License 2.0
+
+The following files are derived from [anthropics/skills](https://github.com/anthropics/skills)
+(skill-creator), licensed under Apache License 2.0:
+
+- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/scripts/init_skill.py
+- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/scripts/package_skill.py
+- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/scripts/quick_validate.py
+- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/reference-workflows.md
+- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/reference-output-patterns.md
+
+These files have been modified for use in shirokuma-docs.
+See the LICENSE.txt in each managing-skills/scripts directory for the full Apache License 2.0 text.

package/bin/shirokuma-docs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/analyzers/details-test-analysis.d.ts

@@ -0,0 +1,31 @@
+/**
+ * details-test-analysis - テストケース分析
+ *
+ * 要素・モジュールに関連するテストケースを抽出し、
+ * カテゴリ分類とカバレッジ分析を行う。
+ */
+import type { DetailsContext, TestCategory, CategorizedTestCase, TestCoverageAnalysis } from "../commands/details-types.js";
+/**
+ * 要素に関連するテストケースを抽出
+ */
+export declare function findTestCasesForElement(elementName: string, elementPath: string, ctx: DetailsContext): CategorizedTestCase[];
+/**
+ * テスト名からカテゴリを推定
+ */
+export declare function categorizeTest(testName: string, describePath: string): {
+    category: TestCategory;
+    summary: string;
+};
+/**
+ * テスト名から意図を抽出
+ */
+export declare function extractTestIntent(testName: string): string;
+/**
+ * テストカバレッジを分析
+ */
+export declare function analyzeTestCoverage(testCases: CategorizedTestCase[], hasAuth?: boolean, hasDb?: boolean): TestCoverageAnalysis;
+/**
+ * モジュールに関連するテストケースを抽出
+ */
+export declare function findTestCasesForModule(moduleName: string, type: string, ctx: DetailsContext): CategorizedTestCase[];
+//# sourceMappingURL=details-test-analysis.d.ts.map

package/dist/analyzers/details-test-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"details-test-analysis.d.ts","sourceRoot":"","sources":["../../src/analyzers/details-test-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EAEd,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,cAAc,GAClB,mBAAmB,EAAE,CAwBvB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAqC7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,mBAAmB,EAAE,EAChC,OAAO,GAAE,OAAe,EACxB,KAAK,GAAE,OAAe,GACrB,oBAAoB,CA+DtB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,cAAc,GAClB,mBAAmB,EAAE,CA8CvB"}

package/dist/analyzers/details-test-analysis.js

@@ -0,0 +1,172 @@
+/**
+ * details-test-analysis - テストケース分析
+ *
+ * 要素・モジュールに関連するテストケースを抽出し、
+ * カテゴリ分類とカバレッジ分析を行う。
+ */
+/**
+ * 要素に関連するテストケースを抽出
+ */
+export function findTestCasesForElement(elementName, elementPath, ctx) {
+    const results = [];
+    const lowerName = elementName.toLowerCase();
+    for (const tc of ctx.allTestCases) {
+        const descLower = tc.describe.toLowerCase();
+        const fileLower = tc.file.toLowerCase();
+        const isRelevant = descLower.includes(lowerName) ||
+            lowerName.includes(descLower.split(" > ")[0]) ||
+            fileLower.includes(lowerName.replace(/([A-Z])/g, "-$1").toLowerCase());
+        if (isRelevant) {
+            const { category, summary } = categorizeTest(tc.it, tc.describe);
+            results.push({
+                ...tc,
+                category,
+                summary: tc.description || summary,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * テスト名からカテゴリを推定
+ */
+export function categorizeTest(testName, describePath) {
+    const combined = `${describePath.toLowerCase()} ${testName.toLowerCase()}`;
+    // 認証・認可系
+    if (/auth|login|logout|session|permission|role|unauthorized|forbidden|credential|token/.test(combined)) {
+        return { category: "auth", summary: extractTestIntent(testName) };
+    }
+    // エラーハンドリング系
+    if (/throw|error|fail|reject|invalid|exception|catch|not found|404|500/.test(combined)) {
+        if (/valid|schema|required|min|max|format/.test(combined)) {
+            return { category: "validation", summary: extractTestIntent(testName) };
+        }
+        return { category: "error-handling", summary: extractTestIntent(testName) };
+    }
+    // バリデーション系
+    if (/valid|schema|required|min|max|format|type|constraint|sanitize/.test(combined)) {
+        return { category: "validation", summary: extractTestIntent(testName) };
+    }
+    // 境界値・エッジケース系
+    if (/empty|null|undefined|zero|boundary|edge|limit|overflow|special|unicode/.test(combined)) {
+        return { category: "edge-case", summary: extractTestIntent(testName) };
+    }
+    // 統合テスト系
+    if (/integration|e2e|end.to.end|workflow|scenario/.test(combined)) {
+        return { category: "integration", summary: extractTestIntent(testName) };
+    }
+    // 正常系（デフォルト）
+    if (/should|return|create|update|delete|get|fetch|render|display|show/.test(combined)) {
+        return { category: "happy-path", summary: extractTestIntent(testName) };
+    }
+    return { category: "other", summary: extractTestIntent(testName) };
+}
+/**
+ * テスト名から意図を抽出
+ */
+export function extractTestIntent(testName) {
+    const shouldMatch = testName.match(/should\s+(.+?)(?:\s+when\s+(.+))?$/i);
+    if (shouldMatch) {
+        const action = shouldMatch[1];
+        const condition = shouldMatch[2];
+        return condition ? `${action}（${condition}の場合）` : action;
+    }
+    return testName;
+}
+/**
+ * テストカバレッジを分析
+ */
+export function analyzeTestCoverage(testCases, hasAuth = false, hasDb = false) {
+    const byCategory = {
+        "happy-path": [],
+        "error-handling": [],
+        auth: [],
+        validation: [],
+        "edge-case": [],
+        integration: [],
+        other: [],
+    };
+    for (const tc of testCases) {
+        byCategory[tc.category].push(tc);
+    }
+    const missingPatterns = [];
+    const recommendations = [];
+    if (byCategory["happy-path"].length === 0) {
+        missingPatterns.push("正常系テスト");
+        recommendations.push("基本的な正常系テストを追加してください");
+    }
+    if (byCategory["error-handling"].length === 0) {
+        missingPatterns.push("エラーハンドリングテスト");
+        recommendations.push("エラー発生時の挙動をテストしてください");
+    }
+    if (hasAuth && byCategory.auth.length === 0) {
+        missingPatterns.push("認証・認可テスト");
+        recommendations.push("未認証/権限不足時のテストを追加してください");
+    }
+    if (hasDb && byCategory["edge-case"].length === 0) {
+        missingPatterns.push("境界値テスト");
+        recommendations.push("空データ、存在しないID等のエッジケースをテストしてください");
+    }
+    // スコア計算
+    let score = 0;
+    const weights = {
+        "happy-path": 30,
+        "error-handling": 25,
+        auth: hasAuth ? 20 : 0,
+        validation: 15,
+        "edge-case": 10,
+        integration: 5,
+        other: 0,
+    };
+    for (const [cat, weight] of Object.entries(weights)) {
+        if (byCategory[cat].length > 0) {
+            score += weight;
+        }
+    }
+    if (testCases.length >= 5)
+        score = Math.min(score + 10, 100);
+    if (testCases.length >= 10)
+        score = Math.min(score + 10, 100);
+    return {
+        totalTests: testCases.length,
+        byCategory,
+        missingPatterns,
+        coverageScore: score,
+        recommendations,
+    };
+}
+/**
+ * モジュールに関連するテストケースを抽出
+ */
+export function findTestCasesForModule(moduleName, type, ctx) {
+    const results = [];
+    const lowerName = moduleName.toLowerCase();
+    const pathPatterns = [];
+    switch (type) {
+        case "action":
+            pathPatterns.push(new RegExp(`/lib/actions/${lowerName}\\.test\\.ts$`, "i"), new RegExp(`/__tests__/lib/actions/${lowerName}\\.test\\.ts$`, "i"), new RegExp(`/actions/${lowerName}\\.test\\.ts$`, "i"));
+            break;
+        case "component":
+            pathPatterns.push(new RegExp(`/components/${lowerName}\\.test\\.tsx?$`, "i"), new RegExp(`/__tests__/components/${lowerName}\\.test\\.tsx?$`, "i"), new RegExp(`/components/.*${lowerName}.*\\.test\\.tsx?$`, "i"));
+            break;
+        case "screen":
+            pathPatterns.push(new RegExp(`/e2e/${lowerName}\\.spec\\.ts$`, "i"), new RegExp(`/${lowerName}\\.spec\\.ts$`, "i"));
+            break;
+        default:
+            break;
+    }
+    for (const tc of ctx.allTestCases) {
+        const matchesPath = pathPatterns.some((pattern) => pattern.test(tc.file));
+        const matchesDescribe = tc.describe.toLowerCase().includes(lowerName);
+        if (matchesPath || matchesDescribe) {
+            const { category, summary } = categorizeTest(tc.it, tc.describe);
+            results.push({
+                ...tc,
+                category,
+                summary: tc.description || summary,
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=details-test-analysis.js.map

package/dist/analyzers/details-test-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"details-test-analysis.js","sourceRoot":"","sources":["../../src/analyzers/details-test-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAmB,EACnB,WAAmB,EACnB,GAAmB;IAEnB,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IAE5C,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAExC,MAAM,UAAU,GACd,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC7B,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAEzE,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC;gBACX,GAAG,EAAE;gBACL,QAAQ;gBACR,OAAO,EAAE,EAAE,CAAC,WAAW,IAAI,OAAO;aACnC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,YAAoB;IAEpB,MAAM,QAAQ,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;IAE3E,SAAS;IACT,IAAI,mFAAmF,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;IACpE,CAAC;IAED,aAAa;IACb,IAAI,mEAAmE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvF,IAAI,sCAAsC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1E,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC9E,CAAC;IAED,WAAW;IACX,IAAI,+DAA+D,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1E,CAAC;IAED,cAAc;IACd,IAAI,wEAAwE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5F,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzE,CAAC;IAED,SAAS;IACT,IAAI,8CAA8C,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC3E,CAAC;IAED,aAAa;IACb,IAAI,kEAAkE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1E,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAC1E,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QACjC,OAAO,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,SAAS,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAgC,EAChC,UAAmB,KAAK,EACxB,QAAiB,KAAK;IAEtB,MAAM,UAAU,GAAgD;QAC9D,YAAY,EAAE,EAAE;QAChB,gBAAgB,EAAE,EAAE;QACpB,IAAI,EAAE,EAAE;QACR,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,eAAe,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,UAAU,CAAC,gBAAgB,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrC,eAAe,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,eAAe,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,eAAe,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IACzD,CAAC;IAED,QAAQ;IACR,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,OAAO,GAAG;QACd,YAAY,EAAE,EAAE;QAChB,gBAAgB,EAAE,EAAE;QACpB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACtB,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,CAAC;QACd,KAAK,EAAE,CAAC;KACT,CAAC;IAEF,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,IAAI,UAAU,CAAC,GAAmB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/C,KAAK,IAAI,MAAM,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC;QAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;IAC7D,IAAI,SAAS,CAAC,MAAM,IAAI,EAAE;QAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;IAE9D,OAAO;QACL,UAAU,EAAE,SAAS,CAAC,MAAM;QAC5B,UAAU;QACV,eAAe;QACf,aAAa,EAAE,KAAK;QACpB,eAAe;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAkB,EAClB,IAAY,EACZ,GAAmB;IAEnB,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAE3C,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,YAAY,CAAC,IAAI,CACf,IAAI,MAAM,CAAC,gBAAgB,SAAS,eAAe,EAAE,GAAG,CAAC,EACzD,IAAI,MAAM,CAAC,0BAA0B,SAAS,eAAe,EAAE,GAAG,CAAC,EACnE,IAAI,MAAM,CAAC,YAAY,SAAS,eAAe,EAAE,GAAG,CAAC,CACtD,CAAC;YACF,MAAM;QACR,KAAK,WAAW;YACd,YAAY,CAAC,IAAI,CACf,IAAI,MAAM,CAAC,eAAe,SAAS,iBAAiB,EAAE,GAAG,CAAC,EAC1D,IAAI,MAAM,CAAC,yBAAyB,SAAS,iBAAiB,EAAE,GAAG,CAAC,EACpE,IAAI,MAAM,CAAC,iBAAiB,SAAS,mBAAmB,EAAE,GAAG,CAAC,CAC/D,CAAC;YACF,MAAM;QACR,KAAK,QAAQ;YACX,YAAY,CAAC,IAAI,CACf,IAAI,MAAM,CAAC,QAAQ,SAAS,eAAe,EAAE,GAAG,CAAC,EACjD,IAAI,MAAM,CAAC,IAAI,SAAS,eAAe,EAAE,GAAG,CAAC,CAC9C,CAAC;YACF,MAAM;QACR;YACE,MAAM;IACV,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1E,MAAM,eAAe,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEtE,IAAI,WAAW,IAAI,eAAe,EAAE,CAAC;YACnC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC;gBACX,GAAG,EAAE;gBACL,QAAQ;gBACR,OAAO,EAAE,EAAE,CAAC,WAAW,IAAI,OAAO;aACnC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/analyzers/feature-map-builder.d.ts

@@ -0,0 +1,20 @@
+/**
+ * feature-map ビルダー
+ *
+ * 解析済みの FeatureMapItem 配列から FeatureMap 構造体を構築する。
+ * アイテムをフィーチャー別にグループ化し、適切な型に変換する。
+ */
+import type { ScreenItem, ComponentItem, ActionItem, TableItem, ModuleItem, FeatureGroup, TypeItem, UtilityItem, FeatureMap, FeatureMapItem } from "../commands/feature-map-types.js";
+/**
+ * Feature Map を構築
+ */
+export declare function buildFeatureMap(items: FeatureMapItem[], moduleDescriptions?: Map<string, string>, moduleTypes?: Map<string, TypeItem[]>, moduleUtilities?: Map<string, UtilityItem[]>): FeatureMap;
+/**
+ * アイテムを適切な構造に変換
+ */
+export declare function convertItem(item: FeatureMapItem): ScreenItem | ComponentItem | ActionItem | ModuleItem | TableItem;
+/**
+ * グループにアイテムを追加
+ */
+export declare function addToGroup(group: FeatureGroup, type: FeatureMapItem["type"], item: ScreenItem | ComponentItem | ActionItem | ModuleItem | TableItem): void;
+//# sourceMappingURL=feature-map-builder.d.ts.map

package/dist/analyzers/feature-map-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-map-builder.d.ts","sourceRoot":"","sources":["../../src/analyzers/feature-map-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,UAAU,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,cAAc,EACf,MAAM,kCAAkC,CAAC;AAE1C;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EAAE,EACvB,kBAAkB,GAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAa,EACnD,WAAW,GAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAa,EAChD,eAAe,GAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAa,GACtD,UAAU,CAmEZ;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,cAAc,GACnB,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CA6DlE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAC5B,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GACrE,IAAI,CAkBN"}