docgen-ai 0.1.0

package/dist/core/parsers/registry.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Parser Registry — routes files to the correct language parser.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePythonFileAsync = exports.parsePythonFile = exports.parseJavaScriptFile = void 0;
+exports.parseFile = parseFile;
+exports.canParse = canParse;
+exports.getSupportedLanguages = getSupportedLanguages;
+exports.warmup = warmup;
+const javascript_1 = require("./javascript");
+const python_1 = require("./python");
+const helpers_1 = require("../../utils/helpers");
+const logger_1 = require("../../utils/logger");
+const log = logger_1.logger.child('Parser');
+const PARSERS = {
+    javascript: javascript_1.parseJavaScriptFile,
+    typescript: javascript_1.parseJavaScriptFile,
+    python: python_1.parsePythonFile,
+};
+function parseFile(filePath, rootDir) {
+    const language = (0, helpers_1.detectLanguage)(filePath);
+    const parser = PARSERS[language];
+    if (!parser) {
+        log.debug(`No parser for: ${language}`, { filePath });
+        return null;
+    }
+    try {
+        return parser(filePath, (0, helpers_1.readFileContent)(filePath), rootDir);
+    }
+    catch (err) {
+        log.error(`Parse failed: ${filePath}`, { error: err.message });
+        return null;
+    }
+}
+function canParse(filePath) {
+    return (0, helpers_1.detectLanguage)(filePath) in PARSERS;
+}
+function getSupportedLanguages() {
+    return Object.keys(PARSERS);
+}
+var javascript_2 = require("./javascript");
+Object.defineProperty(exports, "parseJavaScriptFile", { enumerable: true, get: function () { return javascript_2.parseJavaScriptFile; } });
+var python_2 = require("./python");
+Object.defineProperty(exports, "parsePythonFile", { enumerable: true, get: function () { return python_2.parsePythonFile; } });
+Object.defineProperty(exports, "parsePythonFileAsync", { enumerable: true, get: function () { return python_2.parsePythonFileAsync; } });
+/**
+ * Pre-initialize tree-sitter for Python (call once at startup).
+ * After this, parsePythonFile uses tree-sitter synchronously.
+ */
+async function warmup() {
+    const { parsePythonFileAsync } = require('./python');
+    // Parse a trivial file to trigger WASM loading
+    await parsePythonFileAsync('/dev/null', 'pass\n', '/');
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/parsers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/parsers/registry.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAgBH,8BAUC;AAED,4BAEC;AAED,sDAEC;AASD,wBAIC;AA5CD,6CAAmD;AACnD,qCAA2C;AAC3C,iDAAsE;AACtE,+CAA4C;AAE5C,MAAM,GAAG,GAAG,eAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAEnC,MAAM,OAAO,GAAyF;IACpG,UAAU,EAAE,gCAAmB;IAC/B,UAAU,EAAE,gCAAmB;IAC/B,MAAM,EAAE,wBAAe;CACxB,CAAC;AAEF,SAAgB,SAAS,CAAC,QAAgB,EAAE,OAAe;IACzD,MAAM,QAAQ,GAAG,IAAA,wBAAc,EAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,EAAE,CAAC;QAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IACpF,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,QAAQ,EAAE,IAAA,yBAAe,EAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,GAAG,CAAC,KAAK,CAAC,iBAAiB,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAgB,QAAQ,CAAC,QAAgB;IACvC,OAAO,IAAA,wBAAc,EAAC,QAAQ,CAAC,IAAI,OAAO,CAAC;AAC7C,CAAC;AAED,SAAgB,qBAAqB;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,2CAAmD;AAA1C,iHAAA,mBAAmB,OAAA;AAC5B,mCAAiE;AAAxD,yGAAA,eAAe,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAE9C;;;GAGG;AACI,KAAK,UAAU,MAAM;IAC1B,MAAM,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrD,+CAA+C;IAC/C,MAAM,oBAAoB,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;AACzD,CAAC"}

package/dist/core/pipeline.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ============================================================================
+ * DOCUMENTATION PIPELINE — Master Orchestrator
+ * ============================================================================
+ *
+ *   Config → Analyze → Generate → Write → Report
+ */
+import { DocgenConfig, ProjectAnalysis, GeneratedDoc } from '../types/definitions';
+export interface PipelineResult {
+    analysis: ProjectAnalysis;
+    generatedDocs: GeneratedDoc[];
+    outputDir: string;
+    duration: number;
+    errors: string[];
+}
+export declare function runPipeline(config: DocgenConfig): Promise<PipelineResult>;
+export declare function runAnalysisOnly(config: DocgenConfig): Promise<ProjectAnalysis>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/core/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAQnF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CA+C/E;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAEpF"}

package/dist/core/pipeline.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * ============================================================================
+ * DOCUMENTATION PIPELINE — Master Orchestrator
+ * ============================================================================
+ *
+ *   Config → Analyze → Generate → Write → Report
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPipeline = runPipeline;
+exports.runAnalysisOnly = runAnalysisOnly;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const project_1 = require("./analyzers/project");
+const registry_1 = require("./generators/registry");
+const logger_1 = require("../utils/logger");
+const helpers_1 = require("../utils/helpers");
+const log = logger_1.logger.child('Pipeline');
+async function runPipeline(config) {
+    const startTime = Date.now();
+    const errors = [];
+    log.info('══════════════════════════════════════════════');
+    log.info('  DOCGEN — Documentation Generation Pipeline');
+    log.info('══════════════════════════════════════════════');
+    log.info(`Project: ${config.projectRoot}`);
+    log.info(`Output:  ${config.outputDir}`);
+    log.info(`AI: ${config.ai.enabled ? config.ai.provider + '/' + config.ai.model : 'disabled'}`);
+    // Stage 1: Analyze
+    log.info('📂 Stage 1/3: Analyzing codebase...');
+    const analysis = await (0, project_1.analyzeProject)(config);
+    log.info(`✓ ${analysis.files.length} files, ${analysis.modules.length} modules, ${analysis.apiEndpoints.length} endpoints`);
+    // Stage 2: Generate
+    log.info('📝 Stage 2/3: Generating documentation...');
+    const generatedDocs = await (0, registry_1.runGenerators)(analysis, config);
+    log.info(`✓ ${generatedDocs.length} doc files generated`);
+    // Stage 3: Write
+    log.info('💾 Stage 3/3: Writing files...');
+    const outputDir = path.resolve(config.projectRoot, config.outputDir);
+    for (const doc of generatedDocs) {
+        try {
+            const finalPath = doc.filePath === 'README.md'
+                ? path.join(config.projectRoot, 'README.md')
+                : doc.filePath.startsWith('docs/')
+                    ? path.join(config.projectRoot, doc.filePath)
+                    : path.join(outputDir, doc.filePath);
+            (0, helpers_1.ensureDir)(path.dirname(finalPath));
+            fs.writeFileSync(finalPath, doc.content, 'utf-8');
+            log.info(`  ✓ ${doc.filePath}`);
+        }
+        catch (err) {
+            errors.push(`Failed to write ${doc.filePath}: ${err.message}`);
+            log.error(`  ✗ ${doc.filePath}: ${err.message}`);
+        }
+    }
+    const duration = Date.now() - startTime;
+    log.info('');
+    log.info(`✅ Done in ${(duration / 1000).toFixed(1)}s — ${generatedDocs.length} docs written to ${outputDir}`);
+    return { analysis, generatedDocs, outputDir, duration, errors };
+}
+async function runAnalysisOnly(config) {
+    return (0, project_1.analyzeProject)(config);
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/core/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ============================================================================
+ * DOCGEN — Public API
+ * ============================================================================
+ *
+ * This is the programmatic API. Use this when integrating docgen
+ * into other tools, build scripts, or CI pipelines.
+ *
+ * USAGE:
+ *   import { analyzeProject, runPipeline, loadConfig } from '@docgen/core';
+ *   const config = loadConfig('./my-project');
+ *   const result = await runPipeline(config);
+ */
+export { loadConfig, generateConfigFile, DEFAULT_CONFIG } from './config/loader';
+export { runPipeline, runAnalysisOnly } from './core/pipeline';
+export { analyzeProject } from './core/analyzers/project';
+export { runGenerators } from './core/generators/registry';
+export { parseFile, canParse, getSupportedLanguages } from './core/parsers/registry';
+export { AnalysisCache } from './core/cache/file-cache';
+export * from './types/definitions';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * ============================================================================
+ * DOCGEN — Public API
+ * ============================================================================
+ *
+ * This is the programmatic API. Use this when integrating docgen
+ * into other tools, build scripts, or CI pipelines.
+ *
+ * USAGE:
+ *   import { analyzeProject, runPipeline, loadConfig } from '@docgen/core';
+ *   const config = loadConfig('./my-project');
+ *   const result = await runPipeline(config);
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalysisCache = exports.getSupportedLanguages = exports.canParse = exports.parseFile = exports.runGenerators = exports.analyzeProject = exports.runAnalysisOnly = exports.runPipeline = exports.DEFAULT_CONFIG = exports.generateConfigFile = exports.loadConfig = void 0;
+var loader_1 = require("./config/loader");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return loader_1.loadConfig; } });
+Object.defineProperty(exports, "generateConfigFile", { enumerable: true, get: function () { return loader_1.generateConfigFile; } });
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return loader_1.DEFAULT_CONFIG; } });
+var pipeline_1 = require("./core/pipeline");
+Object.defineProperty(exports, "runPipeline", { enumerable: true, get: function () { return pipeline_1.runPipeline; } });
+Object.defineProperty(exports, "runAnalysisOnly", { enumerable: true, get: function () { return pipeline_1.runAnalysisOnly; } });
+var project_1 = require("./core/analyzers/project");
+Object.defineProperty(exports, "analyzeProject", { enumerable: true, get: function () { return project_1.analyzeProject; } });
+var registry_1 = require("./core/generators/registry");
+Object.defineProperty(exports, "runGenerators", { enumerable: true, get: function () { return registry_1.runGenerators; } });
+var registry_2 = require("./core/parsers/registry");
+Object.defineProperty(exports, "parseFile", { enumerable: true, get: function () { return registry_2.parseFile; } });
+Object.defineProperty(exports, "canParse", { enumerable: true, get: function () { return registry_2.canParse; } });
+Object.defineProperty(exports, "getSupportedLanguages", { enumerable: true, get: function () { return registry_2.getSupportedLanguages; } });
+var file_cache_1 = require("./core/cache/file-cache");
+Object.defineProperty(exports, "AnalysisCache", { enumerable: true, get: function () { return file_cache_1.AnalysisCache; } });
+__exportStar(require("./types/definitions"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;;AAEH,0CAAiF;AAAxE,oGAAA,UAAU,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAAE,wGAAA,cAAc,OAAA;AACvD,4CAA+D;AAAtD,uGAAA,WAAW,OAAA;AAAE,2GAAA,eAAe,OAAA;AACrC,oDAA0D;AAAjD,yGAAA,cAAc,OAAA;AACvB,uDAA2D;AAAlD,yGAAA,aAAa,OAAA;AACtB,oDAAqF;AAA5E,qGAAA,SAAS,OAAA;AAAE,oGAAA,QAAQ,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AACnD,sDAAwD;AAA/C,2GAAA,aAAa,OAAA;AACtB,sDAAoC"}

package/dist/types/definitions.d.ts

@@ -0,0 +1,220 @@
+/**
+ * ============================================================================
+ * DOCGEN — CORE TYPE DEFINITIONS
+ * ============================================================================
+ * Every module speaks this language. Analyzers produce these types,
+ * generators consume them. This decouples all components.
+ */
+export type SupportedLanguage = 'javascript' | 'typescript' | 'python' | 'java' | 'go' | 'rust';
+export type SupportedFramework = 'express' | 'nestjs' | 'nextjs' | 'fastapi' | 'flask' | 'django' | 'react' | 'vue' | 'angular' | 'generic';
+export interface AnalyzedFile {
+    filePath: string;
+    relativePath: string;
+    language: SupportedLanguage;
+    lineCount: number;
+    contentHash: string;
+    functions: FunctionInfo[];
+    classes: ClassInfo[];
+    imports: ImportInfo[];
+    exports: ExportInfo[];
+    apiEndpoints: APIEndpoint[];
+    comments: CommentInfo[];
+    parseErrors: ParseError[];
+}
+export interface FunctionInfo {
+    name: string;
+    className?: string;
+    params: ParameterInfo[];
+    returnType?: string;
+    isExported: boolean;
+    isAsync: boolean;
+    startLine: number;
+    endLine: number;
+    complexity: number;
+    existingDoc?: string;
+    body?: string;
+    decorators: string[];
+}
+export interface ParameterInfo {
+    name: string;
+    type?: string;
+    defaultValue?: string;
+    isOptional: boolean;
+    description?: string;
+}
+export interface ClassInfo {
+    name: string;
+    superClass?: string;
+    implements: string[];
+    methods: FunctionInfo[];
+    properties: PropertyInfo[];
+    isExported: boolean;
+    startLine: number;
+    endLine: number;
+    existingDoc?: string;
+    decorators: string[];
+}
+export interface PropertyInfo {
+    name: string;
+    type?: string;
+    isStatic: boolean;
+    isPrivate: boolean;
+    defaultValue?: string;
+}
+export interface ImportInfo {
+    source: string;
+    specifiers: string[];
+    isRelative: boolean;
+    defaultImport?: string;
+}
+export interface ExportInfo {
+    name: string;
+    type: 'function' | 'class' | 'variable' | 'type' | 'default' | 'namespace';
+    isDefault: boolean;
+}
+export interface APIEndpoint {
+    method: string;
+    path: string;
+    handler: string;
+    middleware: string[];
+    requestSchema?: SchemaInfo;
+    responseSchema?: SchemaInfo;
+    requiresAuth: boolean;
+    filePath: string;
+    line: number;
+}
+export interface SchemaInfo {
+    type: string;
+    properties?: Record<string, {
+        type: string;
+        required?: boolean;
+        description?: string;
+    }>;
+    example?: unknown;
+}
+export interface CommentInfo {
+    type: 'line' | 'block' | 'jsdoc' | 'docstring';
+    text: string;
+    line: number;
+    associatedEntity?: string;
+}
+export interface ModuleInfo {
+    name: string;
+    path: string;
+    description?: string;
+    files: AnalyzedFile[];
+    dependencies: string[];
+    dependents: string[];
+    publicAPI: ExportInfo[];
+    totalLines: number;
+    role?: 'api' | 'service' | 'model' | 'utility' | 'config' | 'test' | 'ui' | 'middleware';
+}
+export interface ProjectAnalysis {
+    name: string;
+    rootPath: string;
+    version?: string;
+    description?: string;
+    languages: LanguageStats[];
+    frameworks: FrameworkDetection[];
+    files: AnalyzedFile[];
+    modules: ModuleInfo[];
+    dependencyGraph: DependencyEdge[];
+    externalDependencies: ExternalDependency[];
+    apiEndpoints: APIEndpoint[];
+    configFiles: ConfigFile[];
+    envVariables: EnvVariable[];
+    analyzedAt: Date;
+    analysisDuration: number;
+    errors: ParseError[];
+}
+export interface LanguageStats {
+    language: string;
+    fileCount: number;
+    lineCount: number;
+    percentage: number;
+}
+export interface FrameworkDetection {
+    framework: string;
+    confidence: number;
+    evidence: string[];
+}
+export interface DependencyEdge {
+    from: string;
+    to: string;
+    type: 'import' | 'extends' | 'implements' | 'uses' | 'calls';
+    symbols: string[];
+}
+export interface ExternalDependency {
+    name: string;
+    version?: string;
+    category: string;
+    isDev: boolean;
+}
+export interface ConfigFile {
+    path: string;
+    type: string;
+    description?: string;
+}
+export interface EnvVariable {
+    name: string;
+    usedIn: string[];
+    hasDefault: boolean;
+    isRequired: boolean;
+    description?: string;
+}
+export interface ParseError {
+    filePath: string;
+    line?: number;
+    message: string;
+    severity: 'warning' | 'error';
+}
+export interface DocgenConfig {
+    projectRoot: string;
+    outputDir: string;
+    include: string[];
+    exclude: string[];
+    generators: GeneratorName[];
+    ai: AIConfig;
+    cache: CacheConfig;
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    insertInlineDoc: boolean;
+    overwriteExistingDocs: boolean;
+    concurrency: number;
+}
+export type GeneratorName = 'readme' | 'architecture' | 'modules' | 'api' | 'functions' | 'integrations' | 'setup' | 'all';
+export interface AIConfig {
+    enabled: boolean;
+    provider: string;
+    apiKey?: string;
+    model: string;
+    maxTokens: number;
+    temperature: number;
+}
+export interface CacheConfig {
+    enabled: boolean;
+    directory: string;
+    ttl: number;
+}
+export interface GeneratedDoc {
+    filePath: string;
+    content: string;
+    generator: GeneratorName;
+    generatedAt: Date;
+    inputHash: string;
+}
+export interface DocgenPlugin {
+    name: string;
+    version: string;
+    init?(config: DocgenConfig): Promise<void>;
+    analyzers?: PluginAnalyzer[];
+    generators?: PluginGenerator[];
+}
+export interface PluginAnalyzer {
+    extensions: string[];
+    analyze(filePath: string, content: string): Promise<AnalyzedFile>;
+}
+export interface PluginGenerator {
+    name: string;
+    generate(analysis: ProjectAnalysis, config: DocgenConfig): Promise<GeneratedDoc[]>;
+}
+//# sourceMappingURL=definitions.d.ts.map

package/dist/types/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/types/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;AAEhG,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAChE,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAI5C,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAID,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IAC3E,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,YAAY,CAAC;CAC1F;AAID,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,oBAAoB,EAAE,kBAAkB,EAAE,CAAC;IAC3C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,UAAU,EAAE,IAAI,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAID,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;CAC/B;AAID,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC9C,eAAe,EAAE,OAAO,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GACrB,QAAQ,GAAG,cAAc,GAAG,SAAS,GAAG,KAAK,GAC7C,WAAW,GAAG,cAAc,GAAG,OAAO,GAAG,KAAK,CAAC;AAEnD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAID,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACpF"}

package/dist/types/definitions.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * ============================================================================
+ * DOCGEN — CORE TYPE DEFINITIONS
+ * ============================================================================
+ * Every module speaks this language. Analyzers produce these types,
+ * generators consume them. This decouples all components.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=definitions.js.map

package/dist/types/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/types/definitions.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ============================================================================
+ * UTILITY HELPERS — Shared pure functions across the platform
+ * ============================================================================
+ */
+export declare function findFiles(rootDir: string, includePatterns: string[], excludePatterns: string[]): string[];
+export declare function hashContent(content: string): string;
+export declare function hashFile(filePath: string): string;
+export declare function detectLanguage(filePath: string): string;
+export declare function readFileContent(filePath: string): string;
+export declare function fileExists(filePath: string): boolean;
+export declare function ensureDir(dirPath: string): void;
+export declare function inferModuleName(relativePath: string, depth?: number): string;
+export declare function countLines(content: string): number;
+export declare function truncate(text: string, maxLength: number): string;
+export declare function detectFrameworks(rootDir: string): Array<{
+    framework: string;
+    confidence: number;
+    evidence: string[];
+}>;
+export declare function parsePackageJson(rootDir: string): Record<string, any> | null;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EAAE,EACzB,eAAe,EAAE,MAAM,EAAE,GACxB,MAAM,EAAE,CAyBV;AAID,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAUD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAID,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAID,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAM/E;AAID,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGhE;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiCtH;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAI5E"}