dep-context-mcp 1.0.0

package/dist/cache/registry.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Cache registry - manages the index of cached packages
+ */
+export interface CacheEntry {
+    packageName: string;
+    version: string;
+    snapshotPath: string;
+    generatedAt: string;
+    checksum: string;
+}
+export interface CacheRegistry {
+    version: string;
+    entries: Record<string, CacheEntry>;
+    lastUpdated: string;
+}
+/**
+ * Creates an empty registry
+ */
+export declare function createEmptyRegistry(): CacheRegistry;
+/**
+ * Loads the registry from disk
+ */
+export declare function loadRegistry(cacheDir: string): Promise<CacheRegistry>;
+/**
+ * Saves the registry to disk
+ */
+export declare function saveRegistry(cacheDir: string, registry: CacheRegistry): Promise<void>;
+/**
+ * Adds or updates an entry in the registry
+ */
+export declare function addEntry(registry: CacheRegistry, packageName: string, version: string, snapshotPath: string, generatedAt: string, checksum: string): CacheRegistry;
+/**
+ * Removes an entry from the registry
+ */
+export declare function removeEntry(registry: CacheRegistry, packageName: string): CacheRegistry;
+/**
+ * Gets an entry from the registry
+ */
+export declare function getEntry(registry: CacheRegistry, packageName: string): CacheEntry | undefined;
+/**
+ * Checks if an entry exists and matches the version
+ */
+export declare function hasValidEntry(registry: CacheRegistry, packageName: string, version: string): boolean;
+//# sourceMappingURL=registry.d.ts.map

package/dist/cache/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/cache/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACnC,WAAW,EAAE,MAAM,CAAA;CACpB;AAID;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAMnD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAsB3E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3F;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,aAAa,CAcf;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CAMvF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE7F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGpG"}

package/dist/cache/registry.js

@@ -0,0 +1,92 @@
+/**
+ * Cache registry - manages the index of cached packages
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { existsSync } from 'node:fs';
+const REGISTRY_VERSION = '1.0.0';
+/**
+ * Creates an empty registry
+ */
+export function createEmptyRegistry() {
+    return {
+        version: REGISTRY_VERSION,
+        entries: {},
+        lastUpdated: new Date().toISOString()
+    };
+}
+/**
+ * Loads the registry from disk
+ */
+export async function loadRegistry(cacheDir) {
+    const registryPath = join(cacheDir, 'registry.json');
+    if (!existsSync(registryPath)) {
+        return createEmptyRegistry();
+    }
+    try {
+        const content = await readFile(registryPath, 'utf-8');
+        const registry = JSON.parse(content);
+        // Validate version
+        if (registry.version !== REGISTRY_VERSION) {
+            // Version mismatch - return empty registry (will rebuild cache)
+            return createEmptyRegistry();
+        }
+        return registry;
+    }
+    catch {
+        // Corrupted registry - return empty
+        return createEmptyRegistry();
+    }
+}
+/**
+ * Saves the registry to disk
+ */
+export async function saveRegistry(cacheDir, registry) {
+    const registryPath = join(cacheDir, 'registry.json');
+    // Ensure cache directory exists
+    await mkdir(dirname(registryPath), { recursive: true });
+    registry.lastUpdated = new Date().toISOString();
+    await writeFile(registryPath, JSON.stringify(registry, null, 2), 'utf-8');
+}
+/**
+ * Adds or updates an entry in the registry
+ */
+export function addEntry(registry, packageName, version, snapshotPath, generatedAt, checksum) {
+    return {
+        ...registry,
+        entries: {
+            ...registry.entries,
+            [packageName]: {
+                packageName,
+                version,
+                snapshotPath,
+                generatedAt,
+                checksum
+            }
+        }
+    };
+}
+/**
+ * Removes an entry from the registry
+ */
+export function removeEntry(registry, packageName) {
+    const { [packageName]: _, ...remainingEntries } = registry.entries;
+    return {
+        ...registry,
+        entries: remainingEntries
+    };
+}
+/**
+ * Gets an entry from the registry
+ */
+export function getEntry(registry, packageName) {
+    return registry.entries[packageName];
+}
+/**
+ * Checks if an entry exists and matches the version
+ */
+export function hasValidEntry(registry, packageName, version) {
+    const entry = registry.entries[packageName];
+    return entry !== undefined && entry.version === version;
+}
+//# sourceMappingURL=registry.js.map

package/dist/cache/registry.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Configuration loader for the Dependency Context MCP Server
+ */
+export interface ExtractionConfig {
+    includeReadme: boolean;
+    includeJsDoc: boolean;
+    includeExamples: boolean;
+    maxReadmeLength: number;
+    maxExamples: number;
+}
+export interface VectorEmbeddingConfig {
+    provider: 'openai' | 'ollama';
+    ollama?: {
+        baseUrl?: string;
+        model?: string;
+    };
+    openai?: {
+        apiKey?: string;
+        model?: 'text-embedding-3-small' | 'text-embedding-3-large';
+        baseUrl?: string;
+    };
+}
+export interface VectorStorageConfig {
+    type: 'auto' | 'chroma' | 'file' | 'none';
+    chromaHost?: string;
+    localPath?: string;
+}
+export interface VectorConfig {
+    enabled: boolean;
+    embedding: VectorEmbeddingConfig;
+    storage: VectorStorageConfig;
+    indexConcurrency: number;
+}
+export interface GitLabConfig {
+    enabled: boolean;
+    baseUrl: string;
+    token: string;
+}
+export interface Config {
+    projectRoot: string;
+    nodeModulesPath: string;
+    cacheDir: string;
+    extraction: ExtractionConfig;
+    vector: VectorConfig;
+    gitlab: GitLabConfig;
+}
+export declare class ConfigValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validates a partial config object and returns a complete config with defaults applied
+ */
+export declare function validateConfig(partial: Partial<Config>): Config;
+/**
+ * Loads configuration from file or environment, applying defaults
+ */
+export declare function loadConfig(configPath?: string): Promise<Config>;
+/**
+ * Returns the default configuration
+ */
+export declare function getDefaultConfig(): Config;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,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,qBAAqB;IACpC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC7B,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,wBAAwB,GAAG,wBAAwB,CAAA;QAC3D,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,qBAAqB,CAAA;IAChC,OAAO,EAAE,mBAAmB,CAAA;IAC5B,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,gBAAgB,CAAA;IAC5B,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,YAAY,CAAA;CACrB;AAuCD,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAqG/D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0CrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/config/loader.js

@@ -0,0 +1,193 @@
+/**
+ * Configuration loader for the Dependency Context MCP Server
+ */
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+const DEFAULT_CONFIG = {
+    projectRoot: process.cwd(),
+    nodeModulesPath: './node_modules',
+    cacheDir: './.cache/dep-context',
+    extraction: {
+        includeReadme: true,
+        includeJsDoc: true,
+        includeExamples: true,
+        maxReadmeLength: 5000,
+        maxExamples: 10
+    },
+    vector: {
+        enabled: false,
+        embedding: {
+            provider: 'ollama',
+            ollama: {
+                baseUrl: 'http://localhost:11434',
+                model: 'nomic-embed-text'
+            },
+            openai: {
+                model: 'text-embedding-3-small'
+            }
+        },
+        storage: {
+            type: 'auto',
+            chromaHost: 'http://localhost:8000',
+            localPath: './.cache/dep-context/vectors'
+        },
+        indexConcurrency: 4
+    },
+    gitlab: {
+        enabled: false,
+        baseUrl: '',
+        token: ''
+    }
+};
+export class ConfigValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigValidationError';
+    }
+}
+/**
+ * Validates a partial config object and returns a complete config with defaults applied
+ */
+export function validateConfig(partial) {
+    const config = {
+        ...DEFAULT_CONFIG,
+        ...partial,
+        extraction: {
+            ...DEFAULT_CONFIG.extraction,
+            ...partial.extraction
+        },
+        vector: {
+            ...DEFAULT_CONFIG.vector,
+            ...partial.vector,
+            embedding: {
+                ...DEFAULT_CONFIG.vector.embedding,
+                ...(partial.vector?.embedding || {}),
+                ollama: {
+                    ...DEFAULT_CONFIG.vector.embedding.ollama,
+                    ...(partial.vector?.embedding?.ollama || {})
+                },
+                openai: {
+                    ...DEFAULT_CONFIG.vector.embedding.openai,
+                    ...(partial.vector?.embedding?.openai || {})
+                }
+            },
+            storage: {
+                ...DEFAULT_CONFIG.vector.storage,
+                ...(partial.vector?.storage || {})
+            }
+        },
+        gitlab: {
+            ...DEFAULT_CONFIG.gitlab,
+            ...partial.gitlab
+        }
+    };
+    // Expand environment variables in API key
+    if (config.vector.embedding.openai?.apiKey?.startsWith('${') && config.vector.embedding.openai.apiKey.endsWith('}')) {
+        const envVar = config.vector.embedding.openai.apiKey.slice(2, -1);
+        config.vector.embedding.openai.apiKey = process.env[envVar] || '';
+    }
+    // Validate projectRoot
+    if (typeof config.projectRoot !== 'string' || config.projectRoot.length === 0) {
+        throw new ConfigValidationError('projectRoot must be a non-empty string');
+    }
+    // Validate nodeModulesPath
+    if (typeof config.nodeModulesPath !== 'string' || config.nodeModulesPath.length === 0) {
+        throw new ConfigValidationError('nodeModulesPath must be a non-empty string');
+    }
+    // Validate cacheDir
+    if (typeof config.cacheDir !== 'string' || config.cacheDir.length === 0) {
+        throw new ConfigValidationError('cacheDir must be a non-empty string');
+    }
+    // Validate extraction config
+    if (typeof config.extraction.includeReadme !== 'boolean') {
+        throw new ConfigValidationError('extraction.includeReadme must be a boolean');
+    }
+    if (typeof config.extraction.includeJsDoc !== 'boolean') {
+        throw new ConfigValidationError('extraction.includeJsDoc must be a boolean');
+    }
+    if (typeof config.extraction.includeExamples !== 'boolean') {
+        throw new ConfigValidationError('extraction.includeExamples must be a boolean');
+    }
+    if (typeof config.extraction.maxReadmeLength !== 'number' || config.extraction.maxReadmeLength < 0) {
+        throw new ConfigValidationError('extraction.maxReadmeLength must be a non-negative number');
+    }
+    if (typeof config.extraction.maxExamples !== 'number' || config.extraction.maxExamples < 0) {
+        throw new ConfigValidationError('extraction.maxExamples must be a non-negative number');
+    }
+    // Validate vector config
+    if (typeof config.vector.enabled !== 'boolean') {
+        throw new ConfigValidationError('vector.enabled must be a boolean');
+    }
+    if (config.vector.embedding.provider !== 'openai' && config.vector.embedding.provider !== 'ollama') {
+        throw new ConfigValidationError('vector.embedding.provider must be "openai" or "ollama"');
+    }
+    if (typeof config.vector.indexConcurrency !== 'number' || config.vector.indexConcurrency < 1) {
+        throw new ConfigValidationError('vector.indexConcurrency must be a positive number');
+    }
+    const validStorageTypes = ['auto', 'chroma', 'file', 'none'];
+    if (!validStorageTypes.includes(config.vector.storage.type)) {
+        throw new ConfigValidationError('vector.storage.type must be one of: auto, chroma, file, none');
+    }
+    // Validate gitlab config
+    if (typeof config.gitlab.enabled !== 'boolean') {
+        throw new ConfigValidationError('gitlab.enabled must be a boolean');
+    }
+    if (config.gitlab.enabled) {
+        if (typeof config.gitlab.baseUrl !== 'string' || config.gitlab.baseUrl.length === 0) {
+            throw new ConfigValidationError('gitlab.baseUrl must be a non-empty string when gitlab is enabled');
+        }
+        if (typeof config.gitlab.token !== 'string' || config.gitlab.token.length === 0) {
+            throw new ConfigValidationError('gitlab.token must be a non-empty string when gitlab is enabled');
+        }
+    }
+    return config;
+}
+/**
+ * Loads configuration from file or environment, applying defaults
+ */
+export async function loadConfig(configPath) {
+    // Check for config path from environment
+    const envConfigPath = process.env['DEPCONTEXT_CONFIG'];
+    // Try multiple config file names
+    let resolvedPath = configPath ?? envConfigPath;
+    if (!resolvedPath) {
+        if (existsSync('dep-context.config.json')) {
+            resolvedPath = 'dep-context.config.json';
+        }
+        else {
+            resolvedPath = 'config.json';
+        }
+    }
+    let fileConfig = {};
+    if (existsSync(resolvedPath)) {
+        try {
+            const content = await readFile(resolvedPath, 'utf-8');
+            fileConfig = JSON.parse(content);
+        }
+        catch (error) {
+            if (error instanceof SyntaxError) {
+                throw new ConfigValidationError(`Invalid JSON in config file: ${resolvedPath}`);
+            }
+            throw error;
+        }
+    }
+    // Apply environment variable overrides
+    if (process.env['DEPCONTEXT_CACHE_DIR']) {
+        fileConfig.cacheDir = process.env['DEPCONTEXT_CACHE_DIR'];
+    }
+    // GitLab token from environment
+    if (process.env['GITLAB_TOKEN'] && fileConfig.gitlab) {
+        fileConfig.gitlab = {
+            ...fileConfig.gitlab,
+            token: process.env['GITLAB_TOKEN']
+        };
+    }
+    return validateConfig(fileConfig);
+}
+/**
+ * Returns the default configuration
+ */
+export function getDefaultConfig() {
+    return { ...DEFAULT_CONFIG };
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/extraction/examples.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Example extractor - extracts and associates code examples from README files
+ */
+export interface CodeExample {
+    code: string;
+    language: string;
+    context: string;
+    associatedExports: string[];
+}
+/**
+ * Extracts code examples from markdown content with language and context
+ */
+export declare function extractExamples(markdown: string): CodeExample[];
+/**
+ * Associates code examples with known export names
+ */
+export declare function associateExamples(examples: CodeExample[], exportNames: string[]): CodeExample[];
+/**
+ * Filters examples to only those with associations, limited by count
+ */
+export declare function filterRelevantExamples(examples: CodeExample[], maxExamples?: number): CodeExample[];
+//# sourceMappingURL=examples.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../src/extraction/examples.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAC5B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CA2B/D;AA8BD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,WAAW,EAAE,EACvB,WAAW,EAAE,MAAM,EAAE,GACpB,WAAW,EAAE,CAqCf;AASD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,WAAW,EAAE,EACvB,WAAW,GAAE,MAAW,GACvB,WAAW,EAAE,CAOf"}

package/dist/extraction/examples.js

@@ -0,0 +1,109 @@
+/**
+ * Example extractor - extracts and associates code examples from README files
+ */
+/**
+ * Extracts code examples from markdown content with language and context
+ */
+export function extractExamples(markdown) {
+    const examples = [];
+    // Match fenced code blocks with js/ts language tags only
+    const codeBlockRegex = /```(typescript|javascript|ts|js|tsx|jsx)\n([\s\S]*?)```/gi;
+    let match;
+    while ((match = codeBlockRegex.exec(markdown)) !== null) {
+        const language = (match[1] || 'javascript').toLowerCase();
+        const code = match[2].trim();
+        // Skip empty or very short blocks
+        if (code.length < 10)
+            continue;
+        // Get context: up to 200 chars before the code block
+        const beforeBlock = markdown.slice(Math.max(0, match.index - 300), match.index);
+        const context = extractContext(beforeBlock);
+        examples.push({
+            code,
+            language: normaliseLanguage(language),
+            context,
+            associatedExports: [] // Filled in later
+        });
+    }
+    return examples;
+}
+/**
+ * Extracts the last paragraph before a code block as context
+ */
+function extractContext(text) {
+    // Split by double newlines and get the last non-empty paragraph
+    const paragraphs = text.split(/\n\n+/).filter(p => p.trim());
+    if (paragraphs.length === 0)
+        return '';
+    const lastPara = paragraphs[paragraphs.length - 1].trim();
+    // Clean up markdown formatting
+    return lastPara
+        .replace(/^#+\s*/, '') // Remove heading markers
+        .replace(/\*\*/g, '') // Remove bold
+        .replace(/\*/g, '') // Remove italic
+        .slice(0, 200); // Limit length
+}
+/**
+ * Normalises language tags
+ */
+function normaliseLanguage(lang) {
+    const normalised = lang.toLowerCase();
+    if (normalised === 'ts' || normalised === 'tsx')
+        return 'typescript';
+    if (normalised === 'js' || normalised === 'jsx')
+        return 'javascript';
+    return normalised;
+}
+/**
+ * Associates code examples with known export names
+ */
+export function associateExamples(examples, exportNames) {
+    // Create a set for fast lookup
+    const exports = new Set(exportNames);
+    // Build regex patterns for common usage patterns
+    // e.g., functionName(, ClassName., import { name }
+    return examples.map(example => {
+        const associated = [];
+        for (const name of exports) {
+            // Skip very short names to avoid false positives
+            if (name.length < 2)
+                continue;
+            // Check for common usage patterns
+            const patterns = [
+                new RegExp(`\\b${escapeRegex(name)}\\s*\\(`, 'g'), // function call: name(
+                new RegExp(`\\b${escapeRegex(name)}\\.`, 'g'), // method access: name.
+                new RegExp(`new\\s+${escapeRegex(name)}`, 'g'), // constructor: new Name
+                new RegExp(`:\\s*${escapeRegex(name)}\\b`, 'g'), // type annotation: : Name
+                new RegExp(`<${escapeRegex(name)}[\\s>]`, 'g'), // generic: <Name>
+                new RegExp(`import.*\\b${escapeRegex(name)}\\b`, 'g'), // import: import { name }
+            ];
+            for (const pattern of patterns) {
+                if (pattern.test(example.code)) {
+                    associated.push(name);
+                    break;
+                }
+            }
+        }
+        return {
+            ...example,
+            associatedExports: [...new Set(associated)] // Dedupe
+        };
+    });
+}
+/**
+ * Escapes special regex characters
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Filters examples to only those with associations, limited by count
+ */
+export function filterRelevantExamples(examples, maxExamples = 10) {
+    // Prioritise examples with more associations
+    const withAssociations = examples
+        .filter(e => e.associatedExports.length > 0)
+        .sort((a, b) => b.associatedExports.length - a.associatedExports.length);
+    return withAssociations.slice(0, maxExamples);
+}
+//# sourceMappingURL=examples.js.map

package/dist/extraction/examples.js.map

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

package/dist/extraction/external-resolver.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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 { type PackageMetadata } from '../resolver/package.js';
+export interface ExternalResolverResult {
+    success: boolean;
+    typesPath: string | undefined;
+    metadata: PackageMetadata | undefined;
+    error: string | undefined;
+}
+export interface ExternalPackageResolver {
+    resolve(packageName: string): Promise<ExternalResolverResult>;
+    clearCache(): void;
+    getCacheStats(): {
+        resolved: number;
+        failed: number;
+    };
+}
+/**
+ * Creates an ExternalPackageResolver with caching
+ */
+export declare function createExternalPackageResolver(projectRoot: string): ExternalPackageResolver;
+//# sourceMappingURL=external-resolver.d.ts.map

package/dist/extraction/external-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-resolver.d.ts","sourceRoot":"","sources":["../../src/extraction/external-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAEpF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAA;IACrC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAC7D,UAAU,IAAI,IAAI,CAAA;IAClB,aAAa,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CACtD;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,uBAAuB,CA6E1F"}