dep-context-mcp 1.0.0

package/dist/extraction/external-resolver.js

@@ -0,0 +1,79 @@
+/**
+ * External Package Resolver - Resolves type definitions from external packages
+ *
+ * When a package re-exports from external dependencies (e.g., vitest re-exports from @vitest/runner),
+ * this resolver finds the type definitions in those external packages.
+ */
+import { createPackageResolver } from '../resolver/package.js';
+/**
+ * Creates an ExternalPackageResolver with caching
+ */
+export function createExternalPackageResolver(projectRoot) {
+    // Cache for successfully resolved packages
+    const resolvedCache = new Map();
+    // Set of packages that failed to resolve (to avoid repeated attempts)
+    const failedPackages = new Set();
+    // Use the existing package resolver
+    const packageResolver = createPackageResolver(projectRoot);
+    return {
+        async resolve(packageName) {
+            // Check failed cache first
+            if (failedPackages.has(packageName)) {
+                return {
+                    success: false,
+                    typesPath: undefined,
+                    metadata: undefined,
+                    error: `Package '${packageName}' previously failed to resolve`
+                };
+            }
+            // Check success cache
+            const cached = resolvedCache.get(packageName);
+            if (cached) {
+                return cached;
+            }
+            // Attempt to resolve
+            try {
+                const resolved = await packageResolver.resolve(packageName);
+                if (!resolved.success || !resolved.metadata) {
+                    failedPackages.add(packageName);
+                    return {
+                        success: false,
+                        typesPath: undefined,
+                        metadata: undefined,
+                        error: resolved.error ?? `Package '${packageName}' not found`
+                    };
+                }
+                const result = {
+                    success: true,
+                    typesPath: resolved.metadata.typesPath,
+                    metadata: resolved.metadata,
+                    error: undefined
+                };
+                // Cache successful resolution
+                resolvedCache.set(packageName, result);
+                return result;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                failedPackages.add(packageName);
+                return {
+                    success: false,
+                    typesPath: undefined,
+                    metadata: undefined,
+                    error: `Failed to resolve '${packageName}': ${message}`
+                };
+            }
+        },
+        clearCache() {
+            resolvedCache.clear();
+            failedPackages.clear();
+        },
+        getCacheStats() {
+            return {
+                resolved: resolvedCache.size,
+                failed: failedPackages.size
+            };
+        }
+    };
+}
+//# sourceMappingURL=external-resolver.js.map

package/dist/extraction/external-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-resolver.js","sourceRoot":"","sources":["../../src/extraction/external-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAwB,MAAM,wBAAwB,CAAA;AAepF;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,WAAmB;IAC/D,2CAA2C;IAC3C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkC,CAAA;IAE/D,sEAAsE;IACtE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAA;IAExC,oCAAoC;IACpC,MAAM,eAAe,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAA;IAE1D,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,WAAmB;YAC/B,2BAA2B;YAC3B,IAAI,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBACpC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,SAAS,EAAE,SAAS;oBACpB,QAAQ,EAAE,SAAS;oBACnB,KAAK,EAAE,YAAY,WAAW,gCAAgC;iBAC/D,CAAA;YACH,CAAC;YAED,sBAAsB;YACtB,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;YAC7C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,MAAM,CAAA;YACf,CAAC;YAED,qBAAqB;YACrB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;gBAE3D,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;oBAC5C,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;oBAC/B,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,SAAS,EAAE,SAAS;wBACpB,QAAQ,EAAE,SAAS;wBACnB,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,YAAY,WAAW,aAAa;qBAC9D,CAAA;gBACH,CAAC;gBAED,MAAM,MAAM,GAA2B;oBACrC,OAAO,EAAE,IAAI;oBACb,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS;oBACtC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,KAAK,EAAE,SAAS;iBACjB,CAAA;gBAED,8BAA8B;gBAC9B,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;gBAEtC,OAAO,MAAM,CAAA;YACf,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACtE,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;gBAC/B,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,SAAS,EAAE,SAAS;oBACpB,QAAQ,EAAE,SAAS;oBACnB,KAAK,EAAE,sBAAsB,WAAW,MAAM,OAAO,EAAE;iBACxD,CAAA;YACH,CAAC;QACH,CAAC;QAED,UAAU;YACR,aAAa,CAAC,KAAK,EAAE,CAAA;YACrB,cAAc,CAAC,KAAK,EAAE,CAAA;QACxB,CAAC;QAED,aAAa;YACX,OAAO;gBACL,QAAQ,EAAE,aAAa,CAAC,IAAI;gBAC5B,MAAM,EAAE,cAAc,CAAC,IAAI;aAC5B,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/extraction/import-tracker.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Import Tracker - Tracks import declarations for resolving export-from-import patterns
+ *
+ * Many packages use the pattern:
+ *   import { foo } from './internal/foo.js';
+ *   export { foo };
+ *
+ * This module tracks imports so we can follow them when resolving exports.
+ */
+import * as ts from 'typescript';
+/**
+ * Represents an imported symbol
+ */
+export interface ImportedSymbol {
+    /** Name used in the current file */
+    localName: string;
+    /** Original name in the source file (may differ if aliased) */
+    originalName: string;
+    /** Relative path to the source module */
+    sourcePath: string;
+    /** Whether this is a namespace import (import * as ns) */
+    isNamespace: boolean;
+}
+/**
+ * Tracks imports from a TypeScript source file
+ */
+export declare class ImportTracker {
+    private imports;
+    /**
+     * Process an import declaration and track all imported symbols
+     */
+    trackImport(node: ts.ImportDeclaration, _sourceFile: ts.SourceFile): void;
+    /**
+     * Check if a name refers to an imported symbol
+     */
+    isImported(name: string): boolean;
+    /**
+     * Get the import information for a symbol
+     */
+    getImport(name: string): ImportedSymbol | undefined;
+    /**
+     * Get all tracked imports
+     */
+    getAllImports(): ImportedSymbol[];
+    /**
+     * Get all imports from a specific source path
+     */
+    getImportsFromSource(sourcePath: string): ImportedSymbol[];
+    /**
+     * Clear all tracked imports
+     */
+    clear(): void;
+}
+/**
+ * Create an ImportTracker and populate it from a source file
+ */
+export declare function createImportTracker(sourceFile: ts.SourceFile): ImportTracker;
+//# sourceMappingURL=import-tracker.d.ts.map

package/dist/extraction/import-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-tracker.d.ts","sourceRoot":"","sources":["../../src/extraction/import-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,0DAA0D;IAC1D,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAyC;IAExD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,EAAE,WAAW,EAAE,EAAE,CAAC,UAAU,GAAG,IAAI;IA0DzE;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAInD;;OAEG;IACH,aAAa,IAAI,cAAc,EAAE;IAIjC;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE;IAK1D;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,aAAa,CAU5E"}

package/dist/extraction/import-tracker.js

@@ -0,0 +1,113 @@
+/**
+ * Import Tracker - Tracks import declarations for resolving export-from-import patterns
+ *
+ * Many packages use the pattern:
+ *   import { foo } from './internal/foo.js';
+ *   export { foo };
+ *
+ * This module tracks imports so we can follow them when resolving exports.
+ */
+import * as ts from 'typescript';
+/**
+ * Tracks imports from a TypeScript source file
+ */
+export class ImportTracker {
+    imports = new Map();
+    /**
+     * Process an import declaration and track all imported symbols
+     */
+    trackImport(node, _sourceFile) {
+        // Get the module specifier (the path being imported from)
+        if (!ts.isStringLiteral(node.moduleSpecifier)) {
+            return;
+        }
+        const sourcePath = node.moduleSpecifier.text;
+        const importClause = node.importClause;
+        if (!importClause) {
+            // Side-effect import: import './module'
+            return;
+        }
+        // Handle default import: import foo from './module'
+        if (importClause.name) {
+            this.imports.set(importClause.name.text, {
+                localName: importClause.name.text,
+                originalName: 'default',
+                sourcePath,
+                isNamespace: false
+            });
+        }
+        // Handle named bindings
+        const namedBindings = importClause.namedBindings;
+        if (!namedBindings) {
+            return;
+        }
+        // Namespace import: import * as ns from './module'
+        if (ts.isNamespaceImport(namedBindings)) {
+            this.imports.set(namedBindings.name.text, {
+                localName: namedBindings.name.text,
+                originalName: '*',
+                sourcePath,
+                isNamespace: true
+            });
+            return;
+        }
+        // Named imports: import { a, b as c } from './module'
+        if (ts.isNamedImports(namedBindings)) {
+            for (const element of namedBindings.elements) {
+                const localName = element.name.text;
+                // If aliased (import { x as y }), propertyName is the original, name is the alias
+                const originalName = element.propertyName?.text ?? localName;
+                this.imports.set(localName, {
+                    localName,
+                    originalName,
+                    sourcePath,
+                    isNamespace: false
+                });
+            }
+        }
+    }
+    /**
+     * Check if a name refers to an imported symbol
+     */
+    isImported(name) {
+        return this.imports.has(name);
+    }
+    /**
+     * Get the import information for a symbol
+     */
+    getImport(name) {
+        return this.imports.get(name);
+    }
+    /**
+     * Get all tracked imports
+     */
+    getAllImports() {
+        return Array.from(this.imports.values());
+    }
+    /**
+     * Get all imports from a specific source path
+     */
+    getImportsFromSource(sourcePath) {
+        return Array.from(this.imports.values())
+            .filter(imp => imp.sourcePath === sourcePath);
+    }
+    /**
+     * Clear all tracked imports
+     */
+    clear() {
+        this.imports.clear();
+    }
+}
+/**
+ * Create an ImportTracker and populate it from a source file
+ */
+export function createImportTracker(sourceFile) {
+    const tracker = new ImportTracker();
+    for (const statement of sourceFile.statements) {
+        if (ts.isImportDeclaration(statement)) {
+            tracker.trackImport(statement, sourceFile);
+        }
+    }
+    return tracker;
+}
+//# sourceMappingURL=import-tracker.js.map

package/dist/extraction/import-tracker.js.map

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

package/dist/extraction/readme.d.ts

@@ -0,0 +1,19 @@
+/**
+ * README extractor - reads and parses README.md from packages
+ */
+export interface ReadmeContent {
+    raw: string;
+    truncated: string;
+    codeExamples: string[];
+}
+/**
+ * Extracts README content from a package directory
+ */
+export declare function extractReadme(packagePath: string, maxLength?: number): Promise<ReadmeContent | undefined>;
+/**
+ * Creates a ReadmeExtractor instance
+ */
+export declare function createReadmeExtractor(): {
+    extract: typeof extractReadme;
+};
+//# sourceMappingURL=readme.d.ts.map

package/dist/extraction/readme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme.d.ts","sourceRoot":"","sources":["../../src/extraction/readme.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AA0CD;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAiCpC;AAED;;GAEG;AACH,wBAAgB,qBAAqB;;EAIpC"}

package/dist/extraction/readme.js

@@ -0,0 +1,79 @@
+/**
+ * README extractor - reads and parses README.md from packages
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+/**
+ * Extracts code blocks from markdown content
+ */
+function extractCodeBlocks(content) {
+    const codeBlockRegex = /```[\w]*\n([\s\S]*?)```/g;
+    const blocks = [];
+    let match;
+    while ((match = codeBlockRegex.exec(content)) !== null) {
+        blocks.push(match[1].trim());
+    }
+    return blocks;
+}
+/**
+ * Truncates content to a maximum word count while preserving complete sentences
+ */
+function truncateToWords(content, maxWords) {
+    const words = content.split(/\s+/);
+    if (words.length <= maxWords) {
+        return content;
+    }
+    // Take maxWords and try to end at a sentence boundary
+    const truncated = words.slice(0, maxWords).join(' ');
+    // Find the last sentence boundary
+    const lastPeriod = truncated.lastIndexOf('.');
+    const lastNewline = truncated.lastIndexOf('\n\n');
+    const boundary = Math.max(lastPeriod, lastNewline);
+    if (boundary > truncated.length * 0.5) {
+        return truncated.slice(0, boundary + 1) + '\n\n[truncated]';
+    }
+    return truncated + '...\n\n[truncated]';
+}
+/**
+ * Extracts README content from a package directory
+ */
+export async function extractReadme(packagePath, maxLength = 5000) {
+    // Try common README filenames
+    const readmeNames = ['README.md', 'readme.md', 'Readme.md', 'README.MD', 'README'];
+    let readmePath;
+    for (const name of readmeNames) {
+        const candidate = join(packagePath, name);
+        if (existsSync(candidate)) {
+            readmePath = candidate;
+            break;
+        }
+    }
+    if (!readmePath) {
+        return undefined;
+    }
+    try {
+        const raw = await readFile(readmePath, 'utf-8');
+        const codeExamples = extractCodeBlocks(raw);
+        // Calculate max words (rough estimate: 5 chars per word)
+        const maxWords = Math.floor(maxLength / 5);
+        const truncated = truncateToWords(raw, maxWords);
+        return {
+            raw,
+            truncated,
+            codeExamples
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Creates a ReadmeExtractor instance
+ */
+export function createReadmeExtractor() {
+    return {
+        extract: extractReadme
+    };
+}
+//# sourceMappingURL=readme.js.map

package/dist/extraction/readme.js.map

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

package/dist/extraction/snapshot.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Snapshot generator - creates AI-optimised markdown from extracted types
+ */
+import type { PackageMetadata } from '../resolver/package.js';
+import type { ExtractionResult } from './typescript.js';
+import type { ReadmeContent } from './readme.js';
+import type { CodeExample } from './examples.js';
+export interface SnapshotOptions {
+    includeReadme: boolean;
+    includeJsDoc: boolean;
+    includeExamples: boolean;
+    maxReadmeLength: number;
+    maxExamples: number;
+}
+export interface Snapshot {
+    packageName: string;
+    version: string;
+    generatedAt: string;
+    content: string;
+    checksum: string;
+}
+/**
+ * Generates a snapshot from extracted API information
+ */
+export declare function generateSnapshot(metadata: PackageMetadata, extraction: ExtractionResult, readme: ReadmeContent | undefined, options: SnapshotOptions, examples?: CodeExample[]): Snapshot;
+/**
+ * Creates a SnapshotGenerator instance
+ */
+export declare function createSnapshotGenerator(): {
+    generate: typeof generateSnapshot;
+};
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/extraction/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/extraction/snapshot.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EACV,gBAAgB,EAOjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,OAAO,CAAA;IACtB,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,OAAO,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACjB;AAuLD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,OAAO,EAAE,eAAe,EACxB,QAAQ,GAAE,WAAW,EAAO,GAC3B,QAAQ,CA4GV;AAED;;GAEG;AACH,wBAAgB,uBAAuB;;EAItC"}

package/dist/extraction/snapshot.js

@@ -0,0 +1,258 @@
+/**
+ * Snapshot generator - creates AI-optimised markdown from extracted types
+ */
+import { createHash } from 'node:crypto';
+/**
+ * Formats a function for markdown output
+ */
+function formatFunction(fn, includeJsDoc) {
+    const lines = [];
+    lines.push(`### ${fn.name}`);
+    lines.push('');
+    lines.push('```');
+    lines.push(`function ${fn.signature}`);
+    lines.push('```');
+    if (includeJsDoc && fn.jsDoc) {
+        lines.push('');
+        lines.push(fn.jsDoc);
+    }
+    if (fn.parameters.length > 0) {
+        lines.push('');
+        lines.push('**Parameters:**');
+        for (const param of fn.parameters) {
+            const optional = param.optional ? ' (optional)' : '';
+            lines.push(`- \`${param.name}\`: \`${param.type}\`${optional}`);
+        }
+    }
+    lines.push('');
+    lines.push(`**Returns:** \`${fn.returnType}\``);
+    return lines.join('\n');
+}
+/**
+ * Formats a method for markdown output
+ */
+function formatMethod(method) {
+    const staticPrefix = method.isStatic ? 'static ' : '';
+    const asyncPrefix = method.isAsync ? 'async ' : '';
+    return `- \`${staticPrefix}${asyncPrefix}${method.signature}\``;
+}
+/**
+ * Formats a property for markdown output
+ */
+function formatProperty(prop) {
+    const readonly = prop.readonly ? 'readonly ' : '';
+    const optional = prop.optional ? '?' : '';
+    return `- \`${readonly}${prop.name}${optional}: ${prop.type}\``;
+}
+/**
+ * Formats a class for markdown output
+ */
+function formatClass(cls, includeJsDoc) {
+    const lines = [];
+    lines.push(`### ${cls.name}`);
+    lines.push('');
+    if (includeJsDoc && cls.jsDoc) {
+        lines.push(cls.jsDoc);
+        lines.push('');
+    }
+    if (cls.constructorSignature) {
+        lines.push('**Constructor:**');
+        lines.push('```');
+        lines.push(cls.constructorSignature);
+        lines.push('```');
+        lines.push('');
+    }
+    if (cls.properties.length > 0) {
+        lines.push('**Properties:**');
+        for (const prop of cls.properties) {
+            lines.push(formatProperty(prop));
+        }
+        lines.push('');
+    }
+    if (cls.methods.length > 0) {
+        lines.push('**Methods:**');
+        for (const method of cls.methods) {
+            lines.push(formatMethod(method));
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Formats an interface for markdown output
+ */
+function formatInterface(iface, includeJsDoc) {
+    const lines = [];
+    lines.push(`### ${iface.name}`);
+    lines.push('');
+    if (includeJsDoc && iface.jsDoc) {
+        lines.push(iface.jsDoc);
+        lines.push('');
+    }
+    lines.push('```');
+    lines.push(`interface ${iface.name} {`);
+    for (const prop of iface.properties) {
+        const optional = prop.optional ? '?' : '';
+        const readonly = prop.readonly ? 'readonly ' : '';
+        lines.push(`  ${readonly}${prop.name}${optional}: ${prop.type}`);
+    }
+    for (const method of iface.methods) {
+        lines.push(`  ${method.signature}`);
+    }
+    lines.push('}');
+    lines.push('```');
+    return lines.join('\n');
+}
+/**
+ * Formats a type alias for markdown output
+ */
+function formatType(type, includeJsDoc) {
+    const lines = [];
+    lines.push(`### ${type.name}`);
+    lines.push('');
+    if (includeJsDoc && type.jsDoc) {
+        lines.push(type.jsDoc);
+        lines.push('');
+    }
+    lines.push('```');
+    lines.push(`type ${type.name} = ${type.definition}`);
+    lines.push('```');
+    return lines.join('\n');
+}
+/**
+ * Generates a checksum for the snapshot content
+ */
+function generateChecksum(content) {
+    return createHash('sha256').update(content).digest('hex').slice(0, 16);
+}
+/**
+ * Formats code examples for markdown output
+ */
+function formatExamples(examples) {
+    if (examples.length === 0)
+        return '';
+    const lines = [];
+    lines.push('## Examples');
+    lines.push('');
+    for (const example of examples) {
+        if (example.context) {
+            lines.push(example.context);
+            lines.push('');
+        }
+        lines.push('```' + example.language);
+        lines.push(example.code);
+        lines.push('```');
+        lines.push('');
+        if (example.associatedExports.length > 0) {
+            lines.push(`*Uses: ${example.associatedExports.join(', ')}*`);
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Generates a snapshot from extracted API information
+ */
+export function generateSnapshot(metadata, extraction, readme, options, examples = []) {
+    const lines = [];
+    const generatedAt = new Date().toISOString();
+    // Header
+    lines.push(`# ${metadata.name} v${metadata.version}`);
+    lines.push('');
+    if (metadata.description) {
+        lines.push(metadata.description);
+        lines.push('');
+    }
+    if (metadata.repository) {
+        lines.push(`**Repository:** ${metadata.repository}`);
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('');
+    // Overview from README
+    if (options.includeReadme && readme) {
+        lines.push('## Overview');
+        lines.push('');
+        lines.push(readme.truncated);
+        lines.push('');
+        lines.push('---');
+        lines.push('');
+    }
+    // Functions
+    if (extraction.functions.length > 0) {
+        lines.push('## Functions');
+        lines.push('');
+        for (const fn of extraction.functions) {
+            lines.push(formatFunction(fn, options.includeJsDoc));
+            lines.push('');
+        }
+    }
+    // Classes
+    if (extraction.classes.length > 0) {
+        lines.push('## Classes');
+        lines.push('');
+        for (const cls of extraction.classes) {
+            lines.push(formatClass(cls, options.includeJsDoc));
+            lines.push('');
+        }
+    }
+    // Interfaces
+    if (extraction.interfaces.length > 0) {
+        lines.push('## Interfaces');
+        lines.push('');
+        for (const iface of extraction.interfaces) {
+            lines.push(formatInterface(iface, options.includeJsDoc));
+            lines.push('');
+        }
+    }
+    // Types
+    if (extraction.types.length > 0) {
+        lines.push('## Types');
+        lines.push('');
+        for (const type of extraction.types) {
+            lines.push(formatType(type, options.includeJsDoc));
+            lines.push('');
+        }
+    }
+    // Examples (from README)
+    if (options.includeExamples && examples.length > 0) {
+        lines.push(formatExamples(examples.slice(0, options.maxExamples)));
+    }
+    // Dependencies
+    const deps = Object.entries(metadata.dependencies);
+    if (deps.length > 0) {
+        lines.push('## Dependencies');
+        lines.push('');
+        for (const [name, version] of deps) {
+            lines.push(`- \`${name}\` ${version}`);
+        }
+        lines.push('');
+    }
+    // Extraction errors (if any)
+    if (extraction.errors.length > 0) {
+        lines.push('## Notes');
+        lines.push('');
+        lines.push('Some exports could not be fully extracted:');
+        for (const error of extraction.errors) {
+            lines.push(`- ${error}`);
+        }
+        lines.push('');
+    }
+    const content = lines.join('\n');
+    const checksum = generateChecksum(content);
+    return {
+        packageName: metadata.name,
+        version: metadata.version,
+        generatedAt,
+        content,
+        checksum
+    };
+}
+/**
+ * Creates a SnapshotGenerator instance
+ */
+export function createSnapshotGenerator() {
+    return {
+        generate: generateSnapshot
+    };
+}
+//# sourceMappingURL=snapshot.js.map