@wtdlee/repomap 0.3.0 → 0.3.2

package/dist/generators/index.d.ts

@@ -1,3 +1,431 @@
-export * from './mermaid-generator.js';
-export * from './markdown-generator.js';
-export * from './page-map-generator.js';
+import { AnalysisResult, CrossRepoLink, MermaidDiagram, DataFlow, DocumentationReport } from '../types.js';
+
+/**
+ * Mermaid diagram generator
+ * Mermaidダイアグラム生成器
+ */
+declare class MermaidGenerator {
+    /**
+     * Generate all diagrams from analysis result
+     */
+    generateAll(results: AnalysisResult[], crossRepoLinks: CrossRepoLink[]): MermaidDiagram[];
+    /**
+     * Generate navigation flowchart - grouped by URL category
+     */
+    generateNavigationDiagram(result: AnalysisResult): MermaidDiagram;
+    /**
+     * Generate data flow diagram
+     */
+    generateDataFlowDiagram(result: AnalysisResult): MermaidDiagram;
+    /**
+     * Generate component hierarchy diagram
+     */
+    generateComponentDiagram(result: AnalysisResult): MermaidDiagram;
+    /**
+     * Generate GraphQL operations diagram
+     */
+    generateGraphQLDiagram(result: AnalysisResult): MermaidDiagram;
+    /**
+     * Generate cross-repository diagram
+     */
+    generateCrossRepoDiagram(results: AnalysisResult[], crossRepoLinks: CrossRepoLink[]): MermaidDiagram;
+    /**
+     * Generate sequence diagram for a specific flow
+     */
+    generateSequenceDiagram(flow: DataFlow): MermaidDiagram;
+}
+
+/**
+ * Markdown documentation generator
+ * Markdownドキュメント生成器
+ */
+declare class MarkdownGenerator {
+    /**
+     * Generate complete documentation
+     */
+    generateDocumentation(report: DocumentationReport): Map<string, string>;
+    private generateIndex;
+    private generateRepoIndex;
+    private generatePagesDoc;
+    private generateComponentsDoc;
+    private extractFeatureFromPage;
+    private extractFeatureFromComponent;
+    private formatComponentDataOps;
+    private generateGraphQLDoc;
+    private formatGraphQLFields;
+    private generateDataFlowDoc;
+    private getPageOperations;
+    private generateCrossRepoDoc;
+    private createPageDataFlowDiagram;
+    private generateDiagramsDoc;
+}
+
+/**
+ * Environment detection utilities
+ * 環境検出ユーティリティ
+ */
+type EnvironmentType = 'nextjs' | 'react' | 'rails' | 'generic';
+interface DetectedEnvironment {
+    type: EnvironmentType;
+    detected: boolean;
+    version?: string;
+    path: string;
+    features: string[];
+}
+interface EnvironmentDetectionResult {
+    environments: DetectedEnvironment[];
+    hasNextjs: boolean;
+    hasReact: boolean;
+    hasRails: boolean;
+    primary: EnvironmentType;
+}
+
+/**
+ * Rails Routes Analyzer using tree-sitter
+ * tree-sitterを使用してroutes.rbを解析する
+ */
+interface RailsRoute {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'ALL';
+    path: string;
+    controller: string;
+    action: string;
+    name?: string;
+    namespace?: string;
+    authenticated?: boolean;
+    line: number;
+}
+interface ResourceInfo {
+    name: string;
+    controller: string;
+    only?: string[];
+    except?: string[];
+    nested: ResourceInfo[];
+    memberRoutes: RailsRoute[];
+    collectionRoutes: RailsRoute[];
+    line: number;
+}
+interface MountedEngine {
+    engine: string;
+    mountPath: string;
+    line: number;
+}
+interface RailsRoutesResult {
+    routes: RailsRoute[];
+    namespaces: string[];
+    resources: ResourceInfo[];
+    mountedEngines: MountedEngine[];
+    drawnFiles: string[];
+    errors: string[];
+}
+
+/**
+ * Rails Controller Analyzer using tree-sitter
+ * tree-sitterを使用してコントローラファイルを解析する
+ */
+interface ControllerInfo {
+    name: string;
+    filePath: string;
+    className: string;
+    parentClass: string;
+    namespace?: string;
+    actions: ActionInfo[];
+    beforeActions: FilterInfo[];
+    afterActions: FilterInfo[];
+    aroundActions: FilterInfo[];
+    skipBeforeActions: FilterInfo[];
+    concerns: string[];
+    helpers: string[];
+    rescueFrom: RescueInfo[];
+    layoutInfo?: LayoutInfo;
+    line: number;
+}
+interface InstanceVarAssignment {
+    name: string;
+    assignedType?: string;
+    assignedValue?: string;
+    line?: number;
+}
+interface ActionInfo {
+    name: string;
+    line: number;
+    visibility: 'public' | 'private' | 'protected';
+    parameters: string[];
+    rendersJson?: boolean;
+    rendersHtml?: boolean;
+    redirectsTo?: string;
+    respondsTo?: string[];
+    servicesCalled: string[];
+    modelsCalled: string[];
+    methodCalls: string[];
+    instanceVarAssignments?: InstanceVarAssignment[];
+}
+interface FilterInfo {
+    name: string;
+    only?: string[];
+    except?: string[];
+    if?: string;
+    unless?: string;
+    line: number;
+}
+interface RescueInfo {
+    exception: string;
+    handler: string;
+    line: number;
+}
+interface LayoutInfo {
+    name: string;
+    conditions?: string;
+}
+interface RailsControllersResult {
+    controllers: ControllerInfo[];
+    totalActions: number;
+    namespaces: string[];
+    concerns: string[];
+    errors: string[];
+}
+
+/**
+ * Rails Model Analyzer using tree-sitter
+ * tree-sitterを使用してモデルファイルを解析する
+ */
+interface ModelInfo {
+    name: string;
+    filePath: string;
+    className: string;
+    parentClass: string;
+    tableName?: string;
+    associations: AssociationInfo[];
+    validations: ValidationInfo[];
+    callbacks: CallbackInfo[];
+    scopes: ScopeInfo[];
+    concerns: string[];
+    enums: EnumInfo[];
+    attributes: AttributeInfo[];
+    classMethodsCount: number;
+    instanceMethodsCount: number;
+    line: number;
+}
+interface AssociationInfo {
+    type: 'belongs_to' | 'has_one' | 'has_many' | 'has_and_belongs_to_many';
+    name: string;
+    className?: string;
+    foreignKey?: string;
+    through?: string;
+    polymorphic?: boolean;
+    dependent?: string;
+    optional?: boolean;
+    line: number;
+}
+interface ValidationInfo {
+    type: string;
+    attributes: string[];
+    options?: Record<string, string>;
+    line: number;
+}
+interface CallbackInfo {
+    type: string;
+    method: string;
+    conditions?: string;
+    line: number;
+}
+interface ScopeInfo {
+    name: string;
+    lambda: boolean;
+    line: number;
+}
+interface EnumInfo {
+    name: string;
+    values: string[];
+    line: number;
+}
+interface AttributeInfo {
+    name: string;
+    type?: string;
+    default?: string;
+    line: number;
+}
+interface RailsModelsResult {
+    models: ModelInfo[];
+    totalAssociations: number;
+    totalValidations: number;
+    concerns: string[];
+    namespaces: string[];
+    errors: string[];
+}
+
+/**
+ * Rails gRPC Service Analyzer using tree-sitter
+ * tree-sitterを使用してgRPCサービスを解析する
+ */
+interface GrpcServiceInfo {
+    name: string;
+    filePath: string;
+    className: string;
+    parentClass: string;
+    namespace?: string;
+    protoService?: string;
+    rpcs: RpcMethodInfo[];
+    policies: string[];
+    serializers: string[];
+    concerns: string[];
+    line: number;
+}
+interface RpcMethodInfo {
+    name: string;
+    requestType?: string;
+    responseType?: string;
+    streaming?: 'none' | 'server' | 'client' | 'bidirectional';
+    policyMethod?: string;
+    modelsUsed: string[];
+    servicesUsed: string[];
+    line: number;
+}
+interface RailsGrpcResult {
+    services: GrpcServiceInfo[];
+    totalRpcs: number;
+    namespaces: string[];
+    errors: string[];
+}
+
+interface ReactComponentRef {
+    name: string;
+    propsVar?: string;
+    ssr?: boolean;
+    line?: number;
+}
+interface RailsViewInfo {
+    name: string;
+    path: string;
+    controller: string;
+    action: string;
+    format: string;
+    template: 'haml' | 'erb' | 'yml' | 'other';
+    routePath?: string;
+    partials: string[];
+    helpers: string[];
+    instanceVars: string[];
+    reactComponents: ReactComponentRef[];
+    line?: number;
+}
+interface RailsPageInfo {
+    route: string;
+    method: string;
+    controller: string;
+    action: string;
+    view?: RailsViewInfo;
+    apis: RailsApiCall[];
+    services: string[];
+    grpcCalls: string[];
+    modelAccess: string[];
+}
+interface RailsApiCall {
+    type: 'grpc' | 'service' | 'http' | 'internal';
+    name: string;
+    method?: string;
+    source: string;
+    line?: number;
+}
+interface RailsViewAnalysisResult {
+    views: RailsViewInfo[];
+    pages: RailsPageInfo[];
+    summary: {
+        totalViews: number;
+        totalPages: number;
+        byController: Record<string, number>;
+        byTemplate: Record<string, number>;
+    };
+}
+
+interface ReactComponentMapping {
+    name: string;
+    entryFile?: string;
+    sourceFile?: string;
+    importPath?: string;
+    ssr: boolean;
+    usedIn: ReactComponentUsage[];
+}
+interface ReactComponentUsage {
+    viewPath: string;
+    controller: string;
+    action: string;
+    propsVar?: string;
+    line?: number;
+    pattern: ReactMountPattern;
+}
+type ReactMountPattern = 'data-react-component' | 'render_react_component' | 'react_component' | 'redux_store' | 'stimulus-reflex' | 'turbo-frame-react';
+interface ReactAnalysisResult {
+    components: ReactComponentMapping[];
+    entryPoints: EntryPointInfo[];
+    detectedPaths: DetectedPaths;
+    summary: {
+        totalComponents: number;
+        totalEntryPoints: number;
+        ssrComponents: number;
+        clientComponents: number;
+    };
+}
+interface EntryPointInfo {
+    file: string;
+    fullPath: string;
+    componentName: string;
+    imports: string[];
+    selector?: string;
+}
+interface DetectedPaths {
+    entryDirs: string[];
+    componentDirs: string[];
+    integrationPattern: 'react-rails' | 'react_on_rails' | 'webpacker' | 'vite' | 'custom' | 'unknown';
+}
+
+/**
+ * Rails Analyzers - Index
+ * Rails分析モジュールのエクスポート
+ */
+
+interface RailsAnalysisResult {
+    routes: RailsRoutesResult;
+    controllers: RailsControllersResult;
+    models: RailsModelsResult;
+    grpc: RailsGrpcResult;
+    views: RailsViewAnalysisResult;
+    react: ReactAnalysisResult;
+    summary: RailsSummary;
+}
+interface RailsSummary {
+    totalRoutes: number;
+    totalControllers: number;
+    totalActions: number;
+    totalModels: number;
+    totalAssociations: number;
+    totalValidations: number;
+    totalGrpcServices: number;
+    totalRpcs: number;
+    totalViews: number;
+    totalPages: number;
+    totalReactComponents: number;
+    ssrReactComponents: number;
+    namespaces: string[];
+    concerns: string[];
+}
+
+interface PageMapOptions {
+    envResult?: EnvironmentDetectionResult | null;
+    railsAnalysis?: RailsAnalysisResult | null;
+    activeTab?: 'pages' | 'rails' | 'api';
+    staticMode?: boolean;
+}
+/**
+ * Interactive page map generator
+ */
+declare class PageMapGenerator {
+    private graphqlOps;
+    private apiCalls;
+    private components;
+    generatePageMapHtml(report: DocumentationReport, options?: PageMapOptions): string;
+    private buildHierarchy;
+    private renderPageMapHtml;
+    private buildTreeHtml;
+    private getPageType;
+}
+
+export { MarkdownGenerator, MermaidGenerator, PageMapGenerator, type PageMapOptions };

package/dist/generators/index.js

@@ -1,3 +1 @@
-export * from './mermaid-generator.js';
-export * from './markdown-generator.js';
-export * from './page-map-generator.js';
+export{b as MarkdownGenerator,a as MermaidGenerator}from'../chunk-XWZH2RDG.js';export{a as PageMapGenerator}from'../chunk-MOEA75XK.js';

package/dist/index.d.ts

@@ -1,10 +1,53 @@
-export * from './types.js';
-export * from './core/engine.js';
-export * from './analyzers/base-analyzer.js';
-export * from './analyzers/pages-analyzer.js';
-export * from './analyzers/graphql-analyzer.js';
-export * from './analyzers/dataflow-analyzer.js';
-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';
+import { DocGeneratorConfig, DocumentationReport } from './types.js';
+export { APICall, APIConnection, APIEndpoint, AnalysisConfig, AnalysisResult, AnalyzerType, AssociationInfo, AttributeInfo, AuthRequirement, ComponentInfo, CrossRepoAnalysis, CrossRepoLink, DataFetchingInfo, DataFlow, DataFlowNode, DiagramConfig, DiagramType, GraphQLField, GraphQLOperation, IntegrationsConfig, MermaidDiagram, ModelInfo, NavigationFlow, NavigationInfo, PageInfo, ParameterInfo, PropInfo, RepositoryConfig, RepositoryReport, RepositorySummary, ResponseInfo, SiteConfig, StepInfo, VariableInfo, WatchConfig } from './types.js';
+export { B as BaseAnalyzer, D as DataFlowAnalyzer, G as GraphQLAnalyzer, P as PagesAnalyzer } from './dataflow-analyzer-BfAiqVUp.js';
+export { MarkdownGenerator, MermaidGenerator, PageMapGenerator, PageMapOptions } from './generators/index.js';
+export { DocServer, DocServerOptions } from './server/index.js';
+
+/**
+ * Main documentation generation engine
+ * メインドキュメント生成エンジン
+ */
+declare class DocGeneratorEngine {
+    private config;
+    private mermaidGenerator;
+    private markdownGenerator;
+    private noCache;
+    constructor(config: DocGeneratorConfig, options?: {
+        noCache?: boolean;
+    });
+    /**
+     * Run documentation generation for all configured repositories
+     */
+    generate(): Promise<DocumentationReport>;
+    /**
+     * Analyze a single repository (with caching)
+     */
+    private analyzeRepository;
+    /**
+     * Get repository version and commit info
+     */
+    private getRepoInfo;
+    /**
+     * Create analyzer instance based on type
+     */
+    private createAnalyzer;
+    /**
+     * Merge multiple analysis results
+     */
+    private mergeAnalysisResults;
+    /**
+     * Analyze cross-repository relationships
+     */
+    private analyzeCrossRepo;
+    /**
+     * Extract cross-repository links
+     */
+    private extractCrossRepoLinks;
+    /**
+     * Write documentation to output directory
+     */
+    private writeDocumentation;
+}
+
+export { DocGeneratorConfig, DocGeneratorEngine, DocumentationReport };

package/dist/index.js

@@ -1,11 +1 @@
-// Main exports for the documentation generator
-export * from './types.js';
-export * from './core/engine.js';
-export * from './analyzers/base-analyzer.js';
-export * from './analyzers/pages-analyzer.js';
-export * from './analyzers/graphql-analyzer.js';
-export * from './analyzers/dataflow-analyzer.js';
-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';
+import'./chunk-6F4PWJZI.js';export{a as DocGeneratorEngine,b as DocServer}from'./chunk-4K4MGTPV.js';import'./chunk-SL2GMDBN.js';import'./chunk-VV3A3UE3.js';export{a as BaseAnalyzer,d as DataFlowAnalyzer,c as GraphQLAnalyzer,b as PagesAnalyzer}from'./chunk-J2CM7T7U.js';export{b as MarkdownGenerator,a as MermaidGenerator}from'./chunk-XWZH2RDG.js';export{a as PageMapGenerator}from'./chunk-MOEA75XK.js';import'./chunk-UJT5KTVK.js';

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

@@ -0,0 +1 @@
+export{a as PageMapGenerator}from'./chunk-MOEA75XK.js';

package/dist/rails-TJCDGBBF.js

@@ -0,0 +1 @@
+export{f as RailsControllerAnalyzer,h as RailsGrpcAnalyzer,g as RailsModelAnalyzer,e as RailsRoutesAnalyzer,k as analyzeRailsApp,i as analyzeRailsViews,j as analyzeReactComponents,d as findNodes,a as initRubyParser,b as parseRuby,c as parseRubyFile}from'./chunk-UJT5KTVK.js';

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

@@ -0,0 +1 @@
+export{a as RailsMapGenerator}from'./chunk-SL2GMDBN.js';import'./chunk-UJT5KTVK.js';

package/dist/server/index.d.ts

@@ -1 +1,33 @@
-export * from './doc-server.js';
+import { DocGeneratorConfig } from '../types.js';
+
+interface DocServerOptions {
+    noCache?: boolean;
+}
+/**
+ * Documentation server with live reload
+ * ライブリロード機能付きドキュメントサーバー
+ */
+declare class DocServer {
+    private config;
+    private port;
+    private app;
+    private server;
+    private io;
+    private engine;
+    private currentReport;
+    private envResult;
+    private railsAnalysis;
+    constructor(config: DocGeneratorConfig, port?: number, options?: DocServerOptions);
+    private setupRoutes;
+    private setupSocketIO;
+    private renderPage;
+    private getGraphQLData;
+    private getApiCallsData;
+    private getHtmlTemplate;
+    start(openBrowser?: boolean): Promise<void>;
+    private regenerate;
+    private watchForChanges;
+    stop(): void;
+}
+
+export { DocServer, type DocServerOptions };

package/dist/server/index.js

@@ -1 +1 @@
-export * from './doc-server.js';
+export{b as DocServer}from'../chunk-4K4MGTPV.js';import'../chunk-SL2GMDBN.js';import'../chunk-VV3A3UE3.js';import'../chunk-J2CM7T7U.js';import'../chunk-XWZH2RDG.js';import'../chunk-MOEA75XK.js';import'../chunk-UJT5KTVK.js';