@wtdlee/repomap 0.3.0 → 0.3.1

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

@@ -0,0 +1,180 @@
+import { RepositoryConfig, AnalysisResult } from './types.js';
+
+/**
+ * Base class for all analyzers
+ * 全分析器の基底クラス
+ */
+declare abstract class BaseAnalyzer {
+    protected config: RepositoryConfig;
+    protected basePath: string;
+    constructor(config: RepositoryConfig);
+    /**
+     * Run the analysis
+     * 分析を実行
+     */
+    abstract analyze(): Promise<Partial<AnalysisResult>>;
+    /**
+     * Get the analyzer name
+     * 分析器名を取得
+     */
+    abstract getName(): string;
+    /**
+     * Resolve path relative to repository root
+     * リポジトリルートからの相対パスを解決
+     */
+    protected resolvePath(relativePath: string): string;
+    /**
+     * Get setting value with fallback
+     * 設定値を取得（フォールバック付き）
+     */
+    protected getSetting(key: string, defaultValue?: string): string;
+    /**
+     * Log analysis progress
+     * 分析進捗をログ出力
+     */
+    protected log(message: string): void;
+    /**
+     * Log warning
+     * 警告をログ出力
+     */
+    protected warn(message: string): void;
+    /**
+     * Log error
+     * エラーをログ出力
+     */
+    protected error(message: string, error?: Error): void;
+}
+
+/**
+ * Analyzer for Next.js pages
+ * Next.jsページの分析器
+ */
+declare class PagesAnalyzer extends BaseAnalyzer {
+    private project;
+    private codegenMap;
+    constructor(config: RepositoryConfig);
+    /**
+     * Extract GraphQL operation name from a gql template literal or function call
+     * Handles multiple patterns:
+     * - gql`query Name { ... }`
+     * - gql(/‌* GraphQL *‌/ `query Name { ... }`)
+     * - graphql(`query Name { ... }`)
+     */
+    private extractOperationNameFromGql;
+    /**
+     * Find and extract operation name from a variable declaration in source file
+     * Handles cases like: const Query = gql(comment `query ActualName...`)
+     */
+    private findOperationNameFromVariable;
+    getName(): string;
+    analyze(): Promise<Partial<AnalysisResult>>;
+    private analyzePageFile;
+    /**
+     * Detect the pages root directory from a file path
+     * e.g., /project/src/pages/users/index.tsx -> /project/src/pages
+     */
+    private detectPagesRoot;
+    private filePathToRoutePath;
+    private extractRouteParams;
+    private findPageComponent;
+    private extractLayout;
+    private extractAuthRequirement;
+    private extractRolesFromCondition;
+    private extractPermissions;
+    private extractDataFetching;
+    private symbolTraceCache;
+    /**
+     * Analyze an imported component file for GraphQL queries with full symbol tracing
+     * 임포트된 컴포넌트를 재귀적으로 완전 추적
+     */
+    private analyzeImportedComponent;
+    /**
+     * Analyze a custom hook file for GraphQL queries with recursive tracing
+     */
+    private analyzeCustomHook;
+    private globalContextQueries;
+    /**
+     * Find page files from multiple possible locations
+     * Next.js, React, Rails+React 구조 모두 지원
+     */
+    private findPageFiles;
+    /**
+     * Analyze _app.tsx for global providers that use GraphQL
+     * _app.tsx에서 전역 Context Provider의 GraphQL 분석
+     */
+    private analyzeAppFile;
+    /**
+     * Load codegen mapping from __generated__ folders (optional)
+     * 코드젠 폴더가 있으면 Document → Operation name 매핑 로드
+     */
+    private loadCodegenMapping;
+    /**
+     * Resolve Document name to operation name using codegen map
+     */
+    private resolveDocumentName;
+    /**
+     * Follow re-export in index file to find the actual component file
+     */
+    private followReExport;
+    /**
+     * Check if a name looks like a React component (PascalCase with common suffixes)
+     */
+    private isComponentName;
+    private extractNavigation;
+    /**
+     * Extract multi-step flow information (wizard, stepper, onboarding)
+     */
+    private extractSteps;
+    private extractLinkedPages;
+}
+
+/**
+ * Analyzer for GraphQL operations
+ * GraphQL操作の分析器
+ */
+declare class GraphQLAnalyzer extends BaseAnalyzer {
+    private project;
+    constructor(config: RepositoryConfig);
+    getName(): string;
+    analyze(): Promise<Partial<AnalysisResult>>;
+    private analyzeGraphQLFiles;
+    private analyzeInlineGraphQL;
+    private extractOperationsFromDocument;
+    private extractOperation;
+    private extractFields;
+    private extractVariables;
+    private typeNodeToString;
+    private extractFragmentReferences;
+    private inferReturnType;
+    private findOperationUsage;
+}
+
+/**
+ * Analyzer for data flow patterns
+ * データフローパターンの分析器
+ */
+declare class DataFlowAnalyzer extends BaseAnalyzer {
+    private project;
+    private componentCache;
+    constructor(config: RepositoryConfig);
+    getName(): string;
+    analyze(): Promise<Partial<AnalysisResult>>;
+    private analyzeComponents;
+    private analyzeComponentFile;
+    private isComponentName;
+    private extractComponentInfo;
+    private extractHookInfo;
+    private extractProps;
+    private extractHooksUsed;
+    private extractOperationName;
+    private extractContextName;
+    private extractDependencies;
+    private extractStateManagement;
+    private buildDependencyGraph;
+    private analyzeDataFlows;
+    private analyzeContextFlows;
+    private analyzeApolloFlows;
+    private analyzePropDrilling;
+}
+
+export { BaseAnalyzer as B, DataFlowAnalyzer as D, GraphQLAnalyzer as G, PagesAnalyzer as P };

package/dist/env-detector-EEMVUEIA.js

@@ -0,0 +1 @@
+export { detectEnvironments, getAnalyzersForEnvironments } from './chunk-3PWXDB7B.js';

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,2 @@
-export * from './mermaid-generator.js';
-export * from './markdown-generator.js';
-export * from './page-map-generator.js';
+export { MarkdownGenerator, MermaidGenerator } from '../chunk-SSU6QFTX.js';
+export { PageMapGenerator } from '../chunk-3YFXZAP7.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,8 @@
-// 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 { DocGeneratorEngine, DocServer } from './chunk-M6YNU536.js';
+import './chunk-E4WRODSI.js';
+import './chunk-3PWXDB7B.js';
+export { BaseAnalyzer, DataFlowAnalyzer, GraphQLAnalyzer, PagesAnalyzer } from './chunk-GNBMJMET.js';
+export { MarkdownGenerator, MermaidGenerator } from './chunk-SSU6QFTX.js';
+export { PageMapGenerator } from './chunk-3YFXZAP7.js';
+import './chunk-OWM6WNLE.js';

package/dist/page-map-generator-6MJGPBVA.js

@@ -0,0 +1 @@
+export { PageMapGenerator } from './chunk-3YFXZAP7.js';