@wtdlee/repomap 0.6.0 → 0.8.0

package/README.md

@@ -1,14 +1,36 @@
-# @wtdlee/repomap
+<p align="center">
+  <img src="./src/generators/assets/favicon/favicon.svg" alt="Repomap" width="120">
+</p>
 
-[![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)
+<h1 align="center">@wtdlee/repomap</h1>
 
-Interactive documentation generator for code repositories. Visualize pages, components, routes, and data flows with an intuitive web interface.
+<p align="center">
+  <a href="https://www.npmjs.com/package/@wtdlee/repomap"><img src="https://badge.fury.io/js/@wtdlee%2Frepomap.svg" alt="npm version"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
+
+<p align="center">
+  Interactive documentation generator for code repositories.<br>
+  Visualize pages, components, routes, and data flows with an intuitive web interface.
+</p>
+
+## ⚡ Performance
+
+Powered by [SWC](https://swc.rs/) for blazing-fast AST parsing. Analyze large-scale codebases in seconds.
+
+| Codebase | Scale | Analysis Time |
+|----------|-------|---------------|
+| Next.js Frontend | 30 pages, 970+ components, 640+ GraphQL ops | **~3.2s** |
+| Rails + React Monolith | 5,700+ routes, 490 controllers, 820 models, 80+ gRPC | **~3.5s** |
+
+> 🚀 **10x faster** than ts-morph based solutions. No caching needed!
 
 ## Features
 
 ### 🗺️ Page Map
-- **Multi-framework support** - Next.js (Pages/App Router), React, Rails
+- **Multi-framework support** - Next.js (Pages/App Router), React SPA, Rails
+- **SPA support** - Automatic detection of react-router-dom routes from App.tsx/jsx/js
+- **Zero config for JS projects** - Works without tsconfig.json using smart defaults
 - **Interactive graph view** - Visual representation of page relationships
 - **Route analysis** - Automatic detection of routes, authentication, and data dependencies
 - **React component tracking** - Detect React components used in Rails views
@@ -24,13 +46,16 @@ Interactive documentation generator for code repositories. Visualize pages, comp
 
 ### 🔗 GraphQL Analysis
 - **Operations mapping** - Extract queries, mutations, and fragments
+- **Code Generator support** - Parse `__generated__/graphql.ts` (client preset)
 - **Field details** - View all fields with types and arguments
-- **Usage tracking** - See where operations are used
+- **Usage tracking** - See where operations are used in components
+- **Component integration** - Track GraphQL usage through component dependencies
 
 ### 📊 Data Flow
 - **Visual diagrams** - Mermaid-generated flowcharts
 - **Cross-component tracking** - Follow data through your application
 - **REST API detection** - Automatic API endpoint discovery
+- **High performance** - SWC-based parsing (10x faster than ts-morph)
 
 ## Installation
 
@@ -76,17 +101,18 @@ npx @wtdlee/repomap serve
 repomap serve [options]
   -p, --port <number>  Server port (default: 3030)
   -c, --config <path>  Path to config file
+  -o, --output <path>  Output directory (default: .repomap)
   --path <path>        Path to repository to analyze
-  --no-cache           Disable caching (always analyze from scratch)
+  --temp               Use OS temp directory (no files in repository)
   --no-open            Don't open browser automatically
 
 # generate command options
 repomap generate [options]
   -c, --config <path>  Path to config file
-  -o, --output <path>  Output directory
+  -o, --output <path>  Output directory (default: .repomap)
+  --temp               Use OS temp directory (no files in repository)
   --repo <name>        Analyze specific repository only
   --watch              Watch for changes and regenerate
-  --no-cache           Disable caching
   --static             Generate standalone HTML files (for GitHub Pages)
   --ci                 CI mode: minimal output, exit codes for errors
   --format <type>      Output format: json, html, markdown (default: all)
@@ -97,6 +123,19 @@ repomap rails [options]
   -o, --output <path>  Output HTML file path
 ```
 
+### Output Directory Options
+
+```bash
+# Default: creates .repomap in current directory
+repomap serve
+
+# Custom output directory
+repomap serve -o ./docs
+
+# Temporary directory (auto-cleaned on exit)
+repomap serve --temp
+```
+
 ## CI/CD Integration
 
 ### Deploy to GitHub Pages
@@ -261,7 +300,7 @@ console.log(`Total pages: ${report.repositories[0].summary.totalPages}`);
 ```typescript
 import { DocServer } from "@wtdlee/repomap";
 
-const server = new DocServer(config, 3030, { noCache: false });
+const server = new DocServer(config, 3030);
 await server.start(true); // true = open browser automatically
 ```
 
@@ -392,9 +431,19 @@ export default config;
 | Framework | Features |
 |-----------|----------|
 | **Next.js** | Pages Router, App Router, API routes, data fetching |
-| **React** | Components, GraphQL operations, hooks |
+| **React SPA** | react-router-dom routes, components, hooks (auto-detected from App.tsx) |
+| **React (JS)** | JavaScript projects without tsconfig.json |
 | **Rails** | Routes, Controllers, Models, Views, gRPC, React integration |
 
+### GraphQL Support
+
+| Pattern | Support |
+|---------|---------|
+| `.graphql` files | ✅ Full support |
+| `gql` template literals | ✅ Full support |
+| GraphQL Code Generator (`__generated__/graphql.ts`) | ✅ Full support |
+| `useQuery`, `useMutation`, `useLazyQuery` hooks | ✅ Tracked |
+
 ## Type Definitions
 
 ### Main Types
@@ -462,8 +511,7 @@ src/
 ├── server/
 │   └── doc-server.ts          # Express server with live reload
 ├── core/
-│   ├── engine.ts              # Main documentation engine
-│   └── cache.ts               # Caching utilities
+│   └── engine.ts              # Main documentation engine
 ├── utils/
 │   ├── env-detector.ts        # Environment detection
 │   └── parallel.ts            # Parallel processing utilities

package/dist/analyzers/index.d.ts

@@ -1,63 +1,213 @@
-import { B as BaseAnalyzer } from '../dataflow-analyzer-s6ufFkKC.js';
-export { D as DataFlowAnalyzer, G as GraphQLAnalyzer, P as PagesAnalyzer } from '../dataflow-analyzer-s6ufFkKC.js';
-import { RepositoryConfig, AnalysisResult } from '../types.js';
+import { B as BaseAnalyzer } from '../dataflow-analyzer-CJ2T0cGS.js';
+export { D as DataFlowAnalyzer, G as GraphQLAnalyzer, P as PagesAnalyzer } from '../dataflow-analyzer-CJ2T0cGS.js';
+import { Module, CallExpression } from '@swc/core';
+import { DataFetchingInfo, RepositoryConfig, AnalysisResult } from '../types.js';
+
+/**
+ * Unified GraphQL extraction utilities
+ *
+ * This module provides a single source of truth for all GraphQL operation extraction.
+ * All analyzers should use these utilities instead of implementing their own logic.
+ */
+
+/**
+ * All supported Apollo/GraphQL query hooks
+ */
+declare const GRAPHQL_QUERY_HOOKS: readonly ["useQuery", "useLazyQuery", "useSuspenseQuery", "useBackgroundQuery", "useReadQuery"];
+/**
+ * All supported Apollo/GraphQL mutation hooks
+ */
+declare const GRAPHQL_MUTATION_HOOKS: readonly ["useMutation"];
+/**
+ * All supported Apollo/GraphQL subscription and other hooks
+ */
+declare const GRAPHQL_OTHER_HOOKS: readonly ["useSubscription", "useFragment", "useApolloClient"];
+/**
+ * All GraphQL hooks combined
+ */
+declare const ALL_GRAPHQL_HOOKS: readonly ["useQuery", "useLazyQuery", "useSuspenseQuery", "useBackgroundQuery", "useReadQuery", "useMutation", "useSubscription", "useFragment", "useApolloClient"];
+/**
+ * Hook type mapping for data fetching info
+ */
+declare const HOOK_TYPE_MAP: Record<string, DataFetchingInfo['type']>;
+/**
+ * Keywords that indicate GraphQL usage in a file
+ */
+declare const GRAPHQL_INDICATORS: readonly ["Document", "useQuery", "useMutation", "useLazyQuery", "useSuspenseQuery", "useBackgroundQuery", "useSubscription", "Query", "Mutation", "gql", "graphql", "GET_", "FETCH_", "SEARCH_", "CREATE_", "UPDATE_", "DELETE_", "SUBSCRIBE_", "@apollo", "ApolloClient"];
+/**
+ * Context extracted from a file for GraphQL operation resolution
+ */
+interface GraphQLFileContext {
+    /** Document imports: import { GetUserDocument } from '...' */
+    documentImports: Map<string, string>;
+    /** Variable -> operation name mapping from gql() calls */
+    variableOperations: Map<string, string>;
+    /** Static property mappings: Component.Query = gql`...` */
+    staticPropertyOperations: Map<string, string>;
+    /** Codegen mapping: Document name -> operation name */
+    codegenMap: Map<string, {
+        operationName: string;
+        type: string;
+    }>;
+}
+/**
+ * Result of extracting GraphQL operations from a hook call
+ */
+interface ExtractedGraphQLOperation {
+    operationName: string;
+    hookName: string;
+    type: DataFetchingInfo['type'];
+    variables?: Record<string, string>;
+}
+/**
+ * Check if a hook name is a GraphQL query hook
+ */
+declare function isQueryHook(hookName: string): boolean;
+/**
+ * Check if a hook name is a GraphQL mutation hook
+ */
+declare function isMutationHook(hookName: string): boolean;
+/**
+ * Check if a hook name is a GraphQL subscription hook
+ */
+declare function isSubscriptionHook(hookName: string): boolean;
+/**
+ * Check if a hook name is any GraphQL hook
+ */
+declare function isGraphQLHook(hookName: string): boolean;
+/**
+ * Get the data fetching type for a hook
+ */
+declare function getHookType(hookName: string): DataFetchingInfo['type'];
+/**
+ * Check if content has any GraphQL indicators
+ */
+declare function hasGraphQLIndicators(content: string): boolean;
+/**
+ * Clean operation name by removing common suffixes
+ */
+declare function cleanOperationName(name: string): string;
+/**
+ * Safely parse TypeScript/TSX content to AST
+ */
+declare function parseToAst(content: string): Module | null;
+/**
+ * Get callee name from a call expression
+ */
+declare function getCalleeName(callee: any): string | null;
+/**
+ * Traverse AST and call callback for each node
+ */
+declare function traverseAst(node: any, callback: (node: any) => void): void;
+/**
+ * Extract all GraphQL context from a file in a single AST pass
+ * This is the main entry point for file-level analysis
+ */
+declare function extractGraphQLContext(ast: Module, content: string, codegenMap?: Map<string, {
+    operationName: string;
+    type: string;
+}>): GraphQLFileContext;
+/**
+ * Extract operation name from gql() function call
+ */
+declare function extractOperationNameFromGqlCall(call: any, content: string): string | null;
+/**
+ * Extract operation name from template literal
+ */
+declare function extractOperationNameFromTemplate(template: any, _content: string): string | null;
+/**
+ * Check if a hook call has GraphQL-related arguments
+ * This verifies the hook is actually used for GraphQL, not just has a similar name
+ * e.g., useQueryParams() is NOT a GraphQL hook, but useQuery(GetUserDocument) IS
+ */
+declare function hasGraphQLArgument(call: CallExpression, content: string, context: GraphQLFileContext): boolean;
+/**
+ * Resolve operation name from a hook call using file context
+ * This is the main API for resolving operation names
+ */
+declare function resolveOperationName(call: CallExpression, content: string, context: GraphQLFileContext): string | null;
+/**
+ * Extract all GraphQL operations from a file
+ * Returns a list of operations with their hook names and types
+ */
+declare function extractGraphQLOperationsFromFile(content: string, codegenMap?: Map<string, {
+    operationName: string;
+    type: string;
+}>): ExtractedGraphQLOperation[];
+/**
+ * Get displayable hook info string (for backward compatibility)
+ */
+declare function getHookInfoString(op: ExtractedGraphQLOperation): string;
 
 /**
  * Analyzer for REST API calls (fetch, axios, useSWR, etc.)
- * REST API呼び出しの分析器
+ * Uses @swc/core for fast parsing
  */
 declare class RestApiAnalyzer extends BaseAnalyzer {
-    private project;
     private apiCallCounter;
     constructor(config: RepositoryConfig);
     getName(): string;
     analyze(): Promise<Partial<AnalysisResult>>;
     /**
-     * Find fetch() calls
+     * Analyze a parsed module for API calls
+     */
+    private analyzeModule;
+    /**
+     * Traverse AST nodes recursively
      */
-    private findFetchCalls;
+    private traverseNode;
     /**
-     * Find axios calls (axios.get, axios.post, etc.)
+     * Analyze a call expression for API calls
      */
-    private findAxiosCalls;
+    private analyzeCallExpression;
     /**
-     * Find useSWR calls
+     * Get callee name from expression
      */
-    private findSwrCalls;
+    private getCalleeName;
     /**
-     * Extract API call info from fetch()
+     * Extract API call from fetch()
      */
     private extractFetchCall;
     /**
-     * Extract API call info from axios.method()
+     * Extract API call from axios.method()
      */
-    private extractAxiosCall;
+    private extractAxiosMethodCall;
     /**
-     * Extract API call info from axios() direct call
+     * Extract API call from axios() direct call
      */
     private extractAxiosDirectCall;
     /**
-     * Extract API call info from useSWR()
+     * Extract API call from useSWR()
      */
     private extractSwrCall;
     /**
-     * Get the name of the containing function/component
+     * Extract URL from an expression
      */
-    private getContainingFunctionName;
+    private extractUrlFromExpression;
     /**
-     * Extract URL from argument (handles literals, variables, function calls)
+     * Get line number from byte offset
      */
-    private extractUrlFromArg;
+    private getLineNumber;
     /**
-     * Clean string literal (remove quotes)
+     * Static file extensions to exclude from API detection
      */
-    private cleanStringLiteral;
+    private static readonly STATIC_FILE_EXTENSIONS;
     /**
-     * Check if URL looks like an API endpoint
+     * Non-API URL schemes to exclude
+     */
+    private static readonly NON_API_SCHEMES;
+    /**
+     * Check if URL looks like an API endpoint (generic approach)
+     * Uses exclusion-based logic: if it's not a static file, it's likely an API
      */
     private isApiUrl;
     /**
-     * Categorize API by URL pattern
+     * Known external service patterns for categorization
+     */
+    private static readonly SERVICE_PATTERNS;
+    /**
+     * Categorize API by URL pattern (generic approach)
+     * Automatically extracts service name from domain if not in known patterns
      */
     private categorizeApi;
     /**
@@ -66,4 +216,4 @@ declare class RestApiAnalyzer extends BaseAnalyzer {
     private normalizeMethod;
 }
 
-export { BaseAnalyzer, RestApiAnalyzer };
+export { ALL_GRAPHQL_HOOKS, BaseAnalyzer, type ExtractedGraphQLOperation, GRAPHQL_INDICATORS, GRAPHQL_MUTATION_HOOKS, GRAPHQL_OTHER_HOOKS, GRAPHQL_QUERY_HOOKS, type GraphQLFileContext, HOOK_TYPE_MAP, RestApiAnalyzer, cleanOperationName, extractGraphQLContext, extractGraphQLOperationsFromFile, extractOperationNameFromGqlCall, extractOperationNameFromTemplate, getCalleeName, getHookInfoString, getHookType, hasGraphQLArgument, hasGraphQLIndicators, isGraphQLHook, isMutationHook, isQueryHook, isSubscriptionHook, parseToAst, resolveOperationName, traverseAst };

package/dist/analyzers/index.js

@@ -1 +1 @@
-export{a as BaseAnalyzer,d as DataFlowAnalyzer,c as GraphQLAnalyzer,b as PagesAnalyzer,e as RestApiAnalyzer}from'../chunk-BPV4UZSW.js';
+export{e as ALL_GRAPHQL_HOOKS,a as BaseAnalyzer,A as DataFlowAnalyzer,g as GRAPHQL_INDICATORS,c as GRAPHQL_MUTATION_HOOKS,d as GRAPHQL_OTHER_HOOKS,b as GRAPHQL_QUERY_HOOKS,z as GraphQLAnalyzer,f as HOOK_TYPE_MAP,y as PagesAnalyzer,B as RestApiAnalyzer,n as cleanOperationName,r as extractGraphQLContext,w as extractGraphQLOperationsFromFile,s as extractOperationNameFromGqlCall,t as extractOperationNameFromTemplate,p as getCalleeName,x as getHookInfoString,l as getHookType,u as hasGraphQLArgument,m as hasGraphQLIndicators,k as isGraphQLHook,i as isMutationHook,h as isQueryHook,j as isSubscriptionHook,o as parseToAst,v as resolveOperationName,q as traverseAst}from'../chunk-TNUKDIO7.js';