@wtdlee/repomap 0.1.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
-# repomap
+# @wtdlee/repomap
 
-[![npm version](https://badge.fury.io/js/repomap.svg)](https://badge.fury.io/js/repomap)
+[![npm version](https://badge.fury.io/js/@wtdlee%2Frepomap.svg)](https://www.npmjs.com/package/@wtdlee/repomap)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 Interactive documentation generator for code repositories. Visualize pages, components, routes, and data flows with an intuitive web interface.
@@ -36,13 +36,13 @@ Interactive documentation generator for code repositories. Visualize pages, comp
 
 ```bash
 # Global installation
-npm install -g repomap
+npm install -g @wtdlee/repomap
 
 # Or use directly with npx
-npx repomap serve
+npx @wtdlee/repomap serve
 
 # Or install as project dependency
-npm install repomap
+npm install @wtdlee/repomap
 ```
 
 ## Quick Start
@@ -54,7 +54,7 @@ npm install repomap
 cd my-project
 
 # Start the documentation server (auto-detects project type)
-npx repomap serve
+npx @wtdlee/repomap serve
 
 # Open http://localhost:3030
 ```
@@ -105,10 +105,10 @@ Generate static documentation and deploy to GitHub Pages:
 
 ```bash
 # Generate static HTML files
-npx repomap generate --static --output ./docs
+npx @wtdlee/repomap generate --static --output ./docs
 
 # In CI mode (minimal output)
-npx repomap generate --static --ci --output ./docs
+npx @wtdlee/repomap generate --static --ci --output ./docs
 ```
 
 Example GitHub Actions workflow (`.github/workflows/docs.yml`):
@@ -133,7 +133,7 @@ jobs:
         with:
           node-version: '20'
       - run: npm ci
-      - run: npx repomap generate --static --ci --output ./docs
+      - run: npx @wtdlee/repomap generate --static --ci --output ./docs
       - uses: actions/upload-pages-artifact@v3
         with:
           path: './docs'
@@ -170,7 +170,7 @@ jobs:
         with:
           node-version: '20'
       - run: npm ci
-      - run: npx repomap generate --static --ci --format json --output ./docs
+      - run: npx @wtdlee/repomap generate --static --ci --format json --output ./docs
       - name: Post Comment
         uses: actions/github-script@v7
         with:
@@ -202,8 +202,8 @@ See more examples in [`examples/ci/`](./examples/ci/)
 ### Basic Usage
 
 ```typescript
-import { DocGeneratorEngine, DocServer } from "repomap";
-import type { DocGeneratorConfig, DocumentationReport } from "repomap";
+import { DocGeneratorEngine, DocServer } from "@wtdlee/repomap";
+import type { DocGeneratorConfig, DocumentationReport } from "@wtdlee/repomap";
 
 const config: DocGeneratorConfig = {
   outputDir: "./.repomap",
@@ -259,7 +259,7 @@ console.log(`Total pages: ${report.repositories[0].summary.totalPages}`);
 ### Start Documentation Server
 
 ```typescript
-import { DocServer } from "repomap";
+import { DocServer } from "@wtdlee/repomap";
 
 const server = new DocServer(config, 3030, { noCache: false });
 await server.start(true); // true = open browser automatically
@@ -269,16 +269,16 @@ await server.start(true); // true = open browser automatically
 
 ```typescript
 // Import specific modules
-import { PagesAnalyzer, GraphQLAnalyzer } from "repomap/analyzers";
-import { PageMapGenerator, MermaidGenerator } from "repomap/generators";
-import { DocServer } from "repomap/server";
-import type { PageInfo, GraphQLOperation } from "repomap/types";
+import { PagesAnalyzer, GraphQLAnalyzer } from "@wtdlee/repomap/analyzers";
+import { PageMapGenerator, MermaidGenerator } from "@wtdlee/repomap/generators";
+import { DocServer } from "@wtdlee/repomap/server";
+import type { PageInfo, GraphQLOperation } from "@wtdlee/repomap/types";
 ```
 
 ### Analyzing Rails Applications
 
 ```typescript
-import { RailsMapGenerator } from "repomap";
+import { RailsMapGenerator } from "@wtdlee/repomap";
 
 const generator = new RailsMapGenerator("/path/to/rails-app");
 await generator.generate({
@@ -292,7 +292,7 @@ await generator.generate({
 Create `repomap.config.ts` in your project root:
 
 ```typescript
-import type { DocGeneratorConfig } from "repomap";
+import type { DocGeneratorConfig } from "@wtdlee/repomap";
 
 export const config: DocGeneratorConfig = {
   outputDir: "./.repomap",
@@ -517,11 +517,4 @@ MIT
 
 ## Changelog
 
-### 0.1.0
-- Initial release
-- Page map visualization for Next.js/React
-- Rails application analysis (routes, controllers, models, views)
-- GraphQL operations detection and visualization
-- Data flow analysis
-- Interactive web interface with live reload
-- Multi-repository support
+See [GitHub Releases](https://github.com/wtdlee/repomap/releases) for a detailed changelog.

package/dist/analyzers/base-analyzer.d.ts

@@ -43,4 +43,3 @@ export declare abstract class BaseAnalyzer {
      */
     protected error(message: string, error?: Error): void;
 }
-//# sourceMappingURL=base-analyzer.d.ts.map

package/dist/analyzers/base-analyzer.js

@@ -45,4 +45,3 @@ export class BaseAnalyzer {
         console.error(`[${this.getName()}] ❌ ${message}`, error?.message || '');
     }
 }
-//# sourceMappingURL=base-analyzer.js.map

package/dist/analyzers/dataflow-analyzer.d.ts

@@ -27,4 +27,3 @@ export declare class DataFlowAnalyzer extends BaseAnalyzer {
     private analyzeApolloFlows;
     private analyzePropDrilling;
 }
-//# sourceMappingURL=dataflow-analyzer.d.ts.map

package/dist/analyzers/dataflow-analyzer.js

@@ -423,4 +423,3 @@ export class DataFlowAnalyzer extends BaseAnalyzer {
         return flows;
     }
 }
-//# sourceMappingURL=dataflow-analyzer.js.map

package/dist/analyzers/graphql-analyzer.d.ts

@@ -20,4 +20,3 @@ export declare class GraphQLAnalyzer extends BaseAnalyzer {
     private inferReturnType;
     private findOperationUsage;
 }
-//# sourceMappingURL=graphql-analyzer.d.ts.map

package/dist/analyzers/graphql-analyzer.js

@@ -384,4 +384,3 @@ export class GraphQLAnalyzer extends BaseAnalyzer {
         }
     }
 }
-//# sourceMappingURL=graphql-analyzer.js.map

package/dist/analyzers/index.d.ts

@@ -3,4 +3,3 @@ export * from './pages-analyzer.js';
 export * from './graphql-analyzer.js';
 export * from './dataflow-analyzer.js';
 export * from './rest-api-analyzer.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/analyzers/index.js

@@ -3,4 +3,3 @@ export * from './pages-analyzer.js';
 export * from './graphql-analyzer.js';
 export * from './dataflow-analyzer.js';
 export * from './rest-api-analyzer.js';
-//# sourceMappingURL=index.js.map

package/dist/analyzers/pages-analyzer.d.ts

@@ -82,4 +82,3 @@ export declare class PagesAnalyzer extends BaseAnalyzer {
     private extractSteps;
     private extractLinkedPages;
 }
-//# sourceMappingURL=pages-analyzer.d.ts.map

package/dist/analyzers/pages-analyzer.js

@@ -1693,4 +1693,3 @@ export class PagesAnalyzer extends BaseAnalyzer {
         return linkedPages;
     }
 }
-//# sourceMappingURL=pages-analyzer.js.map

package/dist/analyzers/rails/index.d.ts

@@ -44,4 +44,3 @@ export interface RailsSummary {
  * Analyze a complete Rails application
  */
 export declare function analyzeRailsApp(rootPath: string): Promise<RailsAnalysisResult>;
-//# sourceMappingURL=index.d.ts.map

package/dist/analyzers/rails/index.js

@@ -143,4 +143,3 @@ const isMainModule = import.meta.url === `file://${process.argv[1]}`;
 if (isMainModule) {
     main().catch(console.error);
 }
-//# sourceMappingURL=index.js.map

package/dist/analyzers/rails/rails-controller-analyzer.d.ts

@@ -80,4 +80,3 @@ export declare class RailsControllerAnalyzer {
     private getCallArguments;
     private extractArrayValues;
 }
-//# sourceMappingURL=rails-controller-analyzer.d.ts.map

package/dist/analyzers/rails/rails-controller-analyzer.js

@@ -476,4 +476,3 @@ const isMainModule = import.meta.url === `file://${process.argv[1]}`;
 if (isMainModule) {
     main().catch(console.error);
 }
-//# sourceMappingURL=rails-controller-analyzer.js.map

package/dist/analyzers/rails/rails-grpc-analyzer.d.ts

@@ -42,4 +42,3 @@ export declare class RailsGrpcAnalyzer {
     private parseRpcMethod;
     private getCallArguments;
 }
-//# sourceMappingURL=rails-grpc-analyzer.d.ts.map

package/dist/analyzers/rails/rails-grpc-analyzer.js

@@ -260,4 +260,3 @@ const isMainModule = import.meta.url === `file://${process.argv[1]}`;
 if (isMainModule) {
     main().catch(console.error);
 }
-//# sourceMappingURL=rails-grpc-analyzer.js.map

package/dist/analyzers/rails/rails-model-analyzer.d.ts

@@ -86,4 +86,3 @@ export declare class RailsModelAnalyzer {
     private parseAttribute;
     private getCallArguments;
 }
-//# sourceMappingURL=rails-model-analyzer.d.ts.map

package/dist/analyzers/rails/rails-model-analyzer.js

@@ -491,4 +491,3 @@ const isMainModule = import.meta.url === `file://${process.argv[1]}`;
 if (isMainModule) {
     main().catch(console.error);
 }
-//# sourceMappingURL=rails-model-analyzer.js.map

package/dist/analyzers/rails/rails-react-analyzer.d.ts

@@ -39,4 +39,3 @@ export interface DetectedPaths {
     integrationPattern: 'react-rails' | 'react_on_rails' | 'webpacker' | 'vite' | 'custom' | 'unknown';
 }
 export declare function analyzeReactComponents(rootPath: string): Promise<ReactAnalysisResult>;
-//# sourceMappingURL=rails-react-analyzer.d.ts.map

package/dist/analyzers/rails/rails-react-analyzer.js

@@ -527,4 +527,3 @@ function toKebabCase(str) {
         .toLowerCase()
         .replace(/^-/, '');
 }
-//# sourceMappingURL=rails-react-analyzer.js.map

package/dist/analyzers/rails/rails-routes-analyzer.d.ts

@@ -60,4 +60,3 @@ export declare class RailsRoutesAnalyzer {
     private extractStringValue;
     private extractArrayValues;
 }
-//# sourceMappingURL=rails-routes-analyzer.d.ts.map

package/dist/analyzers/rails/rails-routes-analyzer.js

@@ -538,4 +538,3 @@ const isMainModule = import.meta.url === `file://${process.argv[1]}`;
 if (isMainModule) {
     main().catch(console.error);
 }
-//# sourceMappingURL=rails-routes-analyzer.js.map

package/dist/analyzers/rails/rails-view-analyzer.d.ts

@@ -47,4 +47,3 @@ export interface RailsViewAnalysisResult {
     };
 }
 export declare function analyzeRailsViews(rootPath: string): Promise<RailsViewAnalysisResult>;
-//# sourceMappingURL=rails-view-analyzer.d.ts.map

package/dist/analyzers/rails/rails-view-analyzer.js

@@ -384,4 +384,3 @@ function extractModelAccess(content) {
     }
     return [...new Set(models)];
 }
-//# sourceMappingURL=rails-view-analyzer.js.map

package/dist/analyzers/rails/ruby-parser.d.ts

@@ -61,4 +61,3 @@ export declare function getMethodName(methodNode: SyntaxNode): string | null;
  * Get method parameters
  */
 export declare function getMethodParameters(methodNode: SyntaxNode): string[];
-//# sourceMappingURL=ruby-parser.d.ts.map

package/dist/analyzers/rails/ruby-parser.js

@@ -210,4 +210,3 @@ export function getMethodParameters(methodNode) {
     }
     return params;
 }
-//# sourceMappingURL=ruby-parser.js.map

package/dist/analyzers/rest-api-analyzer.d.ts

@@ -63,4 +63,3 @@ export declare class RestApiAnalyzer extends BaseAnalyzer {
      */
     private normalizeMethod;
 }
-//# sourceMappingURL=rest-api-analyzer.d.ts.map

package/dist/analyzers/rest-api-analyzer.js

@@ -477,4 +477,3 @@ export class RestApiAnalyzer extends BaseAnalyzer {
         return 'unknown';
     }
 }
-//# sourceMappingURL=rest-api-analyzer.js.map

package/dist/cli.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -547,4 +547,3 @@ function showDiff(previous, current) {
     }
 }
 program.parse();
-//# sourceMappingURL=cli.js.map

package/dist/core/cache.d.ts

@@ -45,4 +45,3 @@ export declare class AnalysisCache {
         size: string;
     };
 }
-//# sourceMappingURL=cache.d.ts.map

package/dist/core/cache.js

@@ -149,4 +149,3 @@ export class AnalysisCache {
         };
     }
 }
-//# sourceMappingURL=cache.js.map

package/dist/core/engine.d.ts

@@ -44,4 +44,3 @@ export declare class DocGeneratorEngine {
      */
     private writeDocumentation;
 }
-//# sourceMappingURL=engine.d.ts.map

package/dist/core/engine.js

@@ -317,4 +317,3 @@ export class DocGeneratorEngine {
         console.log(`  📋 report.json`);
     }
 }
-//# sourceMappingURL=engine.js.map

package/dist/core/index.d.ts

@@ -1,3 +1,2 @@
 export * from './engine.js';
 export * from './cache.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/core/index.js

@@ -1,3 +1,2 @@
 export * from './engine.js';
 export * from './cache.js';
-//# sourceMappingURL=index.js.map

package/dist/generators/index.d.ts

@@ -1,4 +1,3 @@
 export * from './mermaid-generator.js';
 export * from './markdown-generator.js';
 export * from './page-map-generator.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/generators/index.js

@@ -1,4 +1,3 @@
 export * from './mermaid-generator.js';
 export * from './markdown-generator.js';
 export * from './page-map-generator.js';
-//# sourceMappingURL=index.js.map

package/dist/generators/markdown-generator.d.ts

@@ -23,4 +23,3 @@ export declare class MarkdownGenerator {
     private createPageDataFlowDiagram;
     private generateDiagramsDoc;
 }
-//# sourceMappingURL=markdown-generator.d.ts.map

package/dist/generators/markdown-generator.js

@@ -780,4 +780,3 @@ export class MarkdownGenerator {
         return lines.join('\n');
     }
 }
-//# sourceMappingURL=markdown-generator.js.map

package/dist/generators/mermaid-generator.d.ts

@@ -33,4 +33,3 @@ export declare class MermaidGenerator {
      */
     generateSequenceDiagram(flow: DataFlow): MermaidDiagram;
 }
-//# sourceMappingURL=mermaid-generator.d.ts.map

package/dist/generators/mermaid-generator.js

@@ -362,4 +362,3 @@ export class MermaidGenerator {
         };
     }
 }
-//# sourceMappingURL=mermaid-generator.js.map

package/dist/generators/page-map-generator.d.ts

@@ -20,4 +20,3 @@ export declare class PageMapGenerator {
     private buildTreeHtml;
     private getPageType;
 }
-//# sourceMappingURL=page-map-generator.d.ts.map

package/dist/generators/page-map-generator.js

@@ -3560,4 +3560,3 @@ export class PageMapGenerator {
         return { label: 'LIST', color: '#06b6d4' };
     }
 }
-//# sourceMappingURL=page-map-generator.js.map

package/dist/generators/rails-map-generator.d.ts

@@ -19,4 +19,3 @@ export declare class RailsMapGenerator {
     private generateRoutesView;
     private highlightParams;
 }
-//# sourceMappingURL=rails-map-generator.d.ts.map

package/dist/generators/rails-map-generator.js

@@ -906,4 +906,3 @@ const isMainModule = import.meta.url === `file://${process.argv[1]}`;
 if (isMainModule) {
     main().catch(console.error);
 }
-//# sourceMappingURL=rails-map-generator.js.map

package/dist/index.d.ts

@@ -8,4 +8,3 @@ export * from './generators/mermaid-generator.js';
 export * from './generators/markdown-generator.js';
 export * from './generators/page-map-generator.js';
 export * from './server/doc-server.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -9,4 +9,3 @@ export * from './generators/mermaid-generator.js';
 export * from './generators/markdown-generator.js';
 export * from './generators/page-map-generator.js';
 export * from './server/doc-server.js';
-//# sourceMappingURL=index.js.map

package/dist/server/doc-server.d.ts

@@ -28,4 +28,3 @@ export declare class DocServer {
     private watchForChanges;
     stop(): void;
 }
-//# sourceMappingURL=doc-server.d.ts.map

package/dist/server/doc-server.js

@@ -9,6 +9,7 @@ import { PageMapGenerator } from '../generators/page-map-generator.js';
 import { RailsMapGenerator } from '../generators/rails-map-generator.js';
 import { detectEnvironments } from '../utils/env-detector.js';
 import { analyzeRailsApp } from '../analyzers/rails/index.js';
+import { findAvailablePort } from '../utils/port.js';
 /**
  * Documentation server with live reload
  * ライブリロード機能付きドキュメントサーバー
@@ -1167,6 +1168,18 @@ export class DocServer {
                 console.error(`   ⚠️ Rails analysis failed:`, error.message);
             }
         }
+        // Find available port (auto-detect if requested port is in use)
+        try {
+            const availablePort = await findAvailablePort(this.port);
+            if (availablePort !== this.port) {
+                console.log(`\n⚠️  Port ${this.port} is in use, using port ${availablePort} instead`);
+            }
+            this.port = availablePort;
+        }
+        catch (error) {
+            console.error(`\n❌ Failed to find available port: ${error.message}`);
+            process.exit(1);
+        }
         // Start server
         this.server.listen(this.port, () => {
             console.log(`\n🌐 Documentation server running at http://localhost:${this.port}`);
@@ -1230,4 +1243,3 @@ export class DocServer {
         console.log('\n👋 Server stopped');
     }
 }
-//# sourceMappingURL=doc-server.js.map

package/dist/server/index.d.ts

@@ -1,2 +1 @@
 export * from './doc-server.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/server/index.js

@@ -1,2 +1 @@
 export * from './doc-server.js';
-//# sourceMappingURL=index.js.map

package/dist/types.d.ts

@@ -291,4 +291,3 @@ export interface NavigationFlow {
     };
     trigger: string;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -3,4 +3,3 @@
  * ドキュメント生成ツールの型定義
  */
 export {};
-//# sourceMappingURL=types.js.map

package/dist/utils/env-detector.d.ts

@@ -29,4 +29,3 @@ export declare function getAnalyzersForEnvironments(envResult: EnvironmentDetect
     frontend: string[];
     backend: string[];
 };
-//# sourceMappingURL=env-detector.d.ts.map

package/dist/utils/env-detector.js

@@ -186,4 +186,3 @@ export function getAnalyzersForEnvironments(envResult) {
     }
     return { frontend, backend };
 }
-//# sourceMappingURL=env-detector.js.map

package/dist/utils/parallel.d.ts

@@ -21,4 +21,3 @@ export declare function parallelMapSafe<T, R>(items: T[], fn: (item: T, index: n
  * 배치 단위로 처리
  */
 export declare function batchProcess<T, R>(items: T[], fn: (batch: T[]) => Promise<R[]>, batchSize?: number): Promise<R[]>;
-//# sourceMappingURL=parallel.d.ts.map

package/dist/utils/parallel.js

@@ -68,4 +68,3 @@ export async function batchProcess(items, fn, batchSize = 50) {
     }
     return results;
 }
-//# sourceMappingURL=parallel.js.map

package/dist/utils/port.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Check if a port is available
+ * ポートが使用可能かどうかを確認
+ */
+export declare function isPortAvailable(port: number): Promise<boolean>;
+/**
+ * Find an available port starting from the given port
+ * 指定されたポートから利用可能なポートを探す
+ *
+ * @param startPort - Port to start searching from
+ * @param maxAttempts - Maximum number of ports to try (default: 10)
+ * @returns Available port number
+ * @throws Error if no available port found within maxAttempts
+ */
+export declare function findAvailablePort(startPort: number, maxAttempts?: number): Promise<number>;

package/dist/utils/port.js

@@ -0,0 +1,41 @@
+import * as net from 'net';
+/**
+ * Check if a port is available
+ * ポートが使用可能かどうかを確認
+ */
+export function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                resolve(false);
+            }
+            else {
+                resolve(false);
+            }
+        });
+        server.once('listening', () => {
+            server.close();
+            resolve(true);
+        });
+        server.listen(port);
+    });
+}
+/**
+ * Find an available port starting from the given port
+ * 指定されたポートから利用可能なポートを探す
+ *
+ * @param startPort - Port to start searching from
+ * @param maxAttempts - Maximum number of ports to try (default: 10)
+ * @returns Available port number
+ * @throws Error if no available port found within maxAttempts
+ */
+export async function findAvailablePort(startPort, maxAttempts = 10) {
+    for (let i = 0; i < maxAttempts; i++) {
+        const port = startPort + i;
+        if (await isPortAvailable(port)) {
+            return port;
+        }
+    }
+    throw new Error(`No available port found between ${startPort} and ${startPort + maxAttempts - 1}`);
+}