@justmpm/deps-consult 1.0.0

package/build/extractors/examples-extractor.js

@@ -0,0 +1,224 @@
+/**
+ * Extrai exemplos de código de múltiplas fontes:
+ * 1. JSDoc @example tags
+ * 2. Arquivos em /examples ou /docs/examples
+ * 3. Seções do README
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+import { existsSync } from 'node:fs';
+import { uniqBy } from 'es-toolkit';
+/**
+ * Coleta exemplos de todas as fontes disponíveis.
+ */
+export async function extractExamples(packageDir, symbols, readme, targetSymbol) {
+    const allExamples = [];
+    // 1. JSDoc @example tags
+    const jsdocExamples = extractFromJSDoc(symbols, targetSymbol);
+    allExamples.push(...jsdocExamples);
+    // 2. Arquivos em /examples
+    const fileExamples = await extractFromExamplesDir(packageDir);
+    allExamples.push(...fileExamples);
+    // 3. README
+    if (readme) {
+        const readmeExamples = extractFromReadme(readme, targetSymbol);
+        allExamples.push(...readmeExamples);
+    }
+    // 4. Arquivos em /docs
+    const docsExamples = await extractFromDocsDir(packageDir);
+    allExamples.push(...docsExamples);
+    return uniqBy(allExamples, e => e.code.substring(0, 200));
+}
+/**
+ * Extrai exemplos de @example tags no JSDoc.
+ */
+function extractFromJSDoc(symbols, targetSymbol) {
+    const filtered = targetSymbol
+        ? symbols.filter(s => s.name === targetSymbol)
+        : symbols;
+    const examples = [];
+    for (const symbol of filtered) {
+        if (!symbol.jsdoc?.examples)
+            continue;
+        for (const example of symbol.jsdoc.examples) {
+            examples.push({
+                code: example,
+                language: detectLanguage(example),
+                context: symbol.name,
+                source: 'jsdoc',
+            });
+        }
+    }
+    return examples;
+}
+/**
+ * Extrai exemplos do diretório /examples do pacote.
+ */
+async function extractFromExamplesDir(packageDir) {
+    const examples = [];
+    const exampleDirs = [
+        join(packageDir, 'examples'),
+        join(packageDir, 'example'),
+        join(packageDir, 'docs', 'examples'),
+    ];
+    for (const dir of exampleDirs) {
+        if (!existsSync(dir))
+            continue;
+        try {
+            const files = await collectSourceFiles(dir);
+            for (const file of files) {
+                try {
+                    const content = await readFile(file, 'utf-8');
+                    if (content.trim().length > 0 && content.length < 10000) {
+                        examples.push({
+                            code: content.trim(),
+                            language: detectLanguageFromExt(extname(file)),
+                            context: file,
+                            source: 'examples-dir',
+                        });
+                    }
+                }
+                catch {
+                    // Arquivo inacessível, ignorar
+                }
+            }
+        }
+        catch {
+            // Diretório inacessível, ignorar
+        }
+    }
+    return examples.slice(0, 20);
+}
+/**
+ * Extrai exemplos de blocos de código do README.
+ */
+function extractFromReadme(readme, targetSymbol) {
+    const examples = [];
+    for (const block of readme.codeBlocks) {
+        if (targetSymbol && block.context && !block.context.toLowerCase().includes(targetSymbol.toLowerCase())) {
+            if (!block.code.includes(targetSymbol))
+                continue;
+        }
+        examples.push({
+            code: block.code,
+            language: block.language,
+            context: block.context,
+            source: 'readme',
+        });
+    }
+    return examples;
+}
+/**
+ * Extrai exemplos de /docs do pacote.
+ */
+async function extractFromDocsDir(packageDir) {
+    const docsDir = join(packageDir, 'docs');
+    if (!existsSync(docsDir))
+        return [];
+    const examples = [];
+    try {
+        const files = await collectSourceFiles(docsDir, ['.md', '.mdx']);
+        for (const file of files) {
+            try {
+                const content = await readFile(file, 'utf-8');
+                const codeBlocks = extractCodeBlocksFromMarkdown(content);
+                for (const block of codeBlocks) {
+                    examples.push({
+                        ...block,
+                        context: block.context ?? '',
+                        source: 'docs',
+                    });
+                }
+            }
+            catch {
+                // Ignorar
+            }
+        }
+    }
+    catch {
+        // Ignorar
+    }
+    return examples.slice(0, 20);
+}
+// ─────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────
+/**
+ * Coleta arquivos de source recursivamente.
+ */
+async function collectSourceFiles(dir, extensions = ['.ts', '.tsx', '.js', '.jsx', '.mjs']) {
+    const results = [];
+    async function walk(currentDir) {
+        try {
+            const entries = await readdir(currentDir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    await walk(fullPath);
+                }
+                else if (entry.isFile() && extensions.includes(extname(entry.name).toLowerCase())) {
+                    results.push(fullPath);
+                }
+            }
+        }
+        catch {
+            // Diretório inacessível
+        }
+    }
+    await walk(dir);
+    return results;
+}
+function detectLanguage(code) {
+    if (code.includes('import ') || code.includes('export ') || (code.includes(': ') && code.includes('=>'))) {
+        return 'typescript';
+    }
+    return 'javascript';
+}
+function detectLanguageFromExt(ext) {
+    const lower = ext.toLowerCase();
+    if (lower === '.ts' || lower === '.tsx')
+        return 'typescript';
+    if (lower === '.jsx')
+        return 'javascript';
+    if (lower === '.mjs')
+        return 'javascript';
+    return 'javascript';
+}
+function extractCodeBlocksFromMarkdown(content) {
+    const blocks = [];
+    const lines = content.split('\n');
+    let inBlock = false;
+    let buffer = [];
+    let lang;
+    let lastHeading;
+    for (const line of lines) {
+        const headingMatch = line.match(/^#{1,3}\s+(.+)/);
+        if (headingMatch) {
+            lastHeading = headingMatch[1]?.trim();
+        }
+        if (line.trimStart().startsWith('```')) {
+            if (inBlock) {
+                if (buffer.length > 0) {
+                    blocks.push({
+                        code: buffer.join('\n'),
+                        language: lang,
+                        context: lastHeading,
+                    });
+                }
+                buffer = [];
+                lang = undefined;
+                inBlock = false;
+            }
+            else {
+                inBlock = true;
+                lang = line.trim().replace('```', '').trim() || undefined;
+            }
+            continue;
+        }
+        if (inBlock) {
+            buffer.push(line);
+        }
+    }
+    return blocks;
+}
+//# sourceMappingURL=examples-extractor.js.map

package/build/extractors/examples-extractor.js.map

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

package/build/extractors/jsdoc-extractor.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Extrai JSDoc de declarações TypeScript via ts-morph.
+ * Captura @param, @returns, @example, @deprecated, @since, @see, @throws.
+ */
+import type { Node } from 'ts-morph';
+import type { JSDocData } from '../types/index.js';
+/**
+ * Extrai JSDoc de uma declaração.
+ */
+export declare function extractJSDoc(decl: Node): JSDocData | undefined;
+//# sourceMappingURL=jsdoc-extractor.d.ts.map

package/build/extractors/jsdoc-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsdoc-extractor.d.ts","sourceRoot":"","sources":["../../src/extractors/jsdoc-extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,CAqC9D"}

package/build/extractors/jsdoc-extractor.js

@@ -0,0 +1,115 @@
+/**
+ * Extrai JSDoc de uma declaração.
+ */
+export function extractJSDoc(decl) {
+    try {
+        const docs = getJsDocs(decl);
+        if (!docs || docs.length === 0)
+            return undefined;
+        const firstDoc = docs[0];
+        if (!firstDoc)
+            return undefined;
+        const description = getDescription(firstDoc);
+        const params = getParams(firstDoc);
+        const returns = getReturnTag(firstDoc);
+        const examples = getExamples(firstDoc);
+        const since = getTagValue(firstDoc, 'since');
+        const deprecated = getDeprecated(firstDoc);
+        const sees = getMultiTagValues(firstDoc, 'see');
+        const throws = getMultiTagValues(firstDoc, 'throws');
+        const defaultValue = getTagValue(firstDoc, 'default');
+        if (!description && params.length === 0 && !returns && examples.length === 0
+            && !since && !deprecated && sees.length === 0 && throws.length === 0 && !defaultValue) {
+            return undefined;
+        }
+        return {
+            description,
+            params: params.length > 0 ? params : undefined,
+            returns: returns ?? undefined,
+            examples: examples.length > 0 ? examples : undefined,
+            since: since ?? undefined,
+            deprecated,
+            sees: sees.length > 0 ? sees : undefined,
+            throws: throws.length > 0 ? throws : undefined,
+            defaultValue: defaultValue ?? undefined,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function getJsDocs(decl) {
+    try {
+        const docs = decl.getJsDocs?.();
+        return docs ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+function getDescription(doc) {
+    const text = doc.getCommentText()?.trim();
+    return text && text.length > 0 ? text : undefined;
+}
+function getParams(doc) {
+    const params = [];
+    for (const tag of doc.getTags()) {
+        if (tag.getTagName() === 'param') {
+            const name = tag.getName()?.trim() ?? '';
+            const description = tag.getDescriptionText()?.trim() ?? '';
+            if (name) {
+                params.push({ name, description });
+            }
+        }
+    }
+    return params;
+}
+function getReturnTag(doc) {
+    for (const tag of doc.getTags()) {
+        if (tag.getTagName() === 'returns' || tag.getTagName() === 'return') {
+            return tag.getDescriptionText()?.trim() || undefined;
+        }
+    }
+    return undefined;
+}
+function getExamples(doc) {
+    const examples = [];
+    for (const tag of doc.getTags()) {
+        if (tag.getTagName() === 'example') {
+            const text = tag.getCommentText() ?? tag.getDescriptionText() ?? '';
+            if (text.trim()) {
+                examples.push(text.trim());
+            }
+        }
+    }
+    return examples;
+}
+function getDeprecated(doc) {
+    for (const tag of doc.getTags()) {
+        if (tag.getTagName() === 'deprecated') {
+            const text = tag.getDescriptionText()?.trim();
+            return text && text.length > 0 ? text : true;
+        }
+    }
+    return undefined;
+}
+function getTagValue(doc, tagName) {
+    for (const tag of doc.getTags()) {
+        if (tag.getTagName() === tagName) {
+            return tag.getDescriptionText()?.trim() || undefined;
+        }
+    }
+    return undefined;
+}
+function getMultiTagValues(doc, tagName) {
+    const values = [];
+    for (const tag of doc.getTags()) {
+        if (tag.getTagName() === tagName) {
+            const text = tag.getDescriptionText()?.trim();
+            if (text)
+                values.push(text);
+        }
+    }
+    return values;
+}
+//# sourceMappingURL=jsdoc-extractor.js.map

package/build/extractors/jsdoc-extractor.js.map

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

package/build/extractors/readme-extractor.d.ts

@@ -0,0 +1,6 @@
+import type { ReadmeData } from '../types/index.js';
+/**
+ * Extrai dados do README do pacote.
+ */
+export declare function extractReadme(packageDir: string): Promise<ReadmeData | null>;
+//# sourceMappingURL=readme-extractor.d.ts.map

package/build/extractors/readme-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme-extractor.d.ts","sourceRoot":"","sources":["../../src/extractors/readme-extractor.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,mBAAmB,CAAC;AAGnE;;GAEG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAUlF"}

package/build/extractors/readme-extractor.js

@@ -0,0 +1,138 @@
+/**
+ * Extrai seções relevantes do README.md de um pacote.
+ * Parse manual de markdown sem dependência externa.
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { uniqBy } from 'es-toolkit';
+/**
+ * Extrai dados do README do pacote.
+ */
+export async function extractReadme(packageDir) {
+    const readmePath = await findReadme(packageDir);
+    if (!readmePath)
+        return null;
+    try {
+        const content = await readFile(readmePath, 'utf-8');
+        return parseReadme(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Encontra o arquivo README no diretório do pacote.
+ */
+async function findReadme(packageDir) {
+    const candidates = [
+        join(packageDir, 'README.md'),
+        join(packageDir, 'readme.md'),
+        join(packageDir, 'Readme.md'),
+        join(packageDir, 'README.MD'),
+        join(packageDir, 'README'),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    // Fallback: buscar com readdir
+    try {
+        const entries = await readdir(packageDir);
+        const readme = entries.find(e => e.toUpperCase() === 'README.MD' || e.toUpperCase() === 'README');
+        if (readme)
+            return join(packageDir, readme);
+    }
+    catch {
+        // Ignorar
+    }
+    return null;
+}
+/**
+ * Faz parse manual do README extraindo seções e blocos de código.
+ */
+function parseReadme(content) {
+    const lines = content.split('\n');
+    const sections = [];
+    const codeBlocks = [];
+    let currentSection = null;
+    let inCodeBlock = false;
+    let codeBuffer = [];
+    let codeLanguage;
+    let codeContext;
+    for (const line of lines) {
+        // Detectar blocos de código
+        if (line.trimStart().startsWith('```')) {
+            if (inCodeBlock) {
+                // Fechar bloco
+                if (codeBuffer.length > 0) {
+                    codeBlocks.push({
+                        code: codeBuffer.join('\n'),
+                        language: codeLanguage,
+                        context: codeContext,
+                    });
+                }
+                codeBuffer = [];
+                codeLanguage = undefined;
+                codeContext = undefined;
+                inCodeBlock = false;
+            }
+            else {
+                // Abrir bloco
+                inCodeBlock = true;
+                codeLanguage = line.trim().replace('```', '').trim() || undefined;
+                codeContext = currentSection?.title;
+            }
+            continue;
+        }
+        if (inCodeBlock) {
+            codeBuffer.push(line);
+            continue;
+        }
+        // Detectar seções (headings)
+        const headingMatch = line.match(/^(#{1,4})\s+(.+)/);
+        if (headingMatch) {
+            // Salvar seção anterior
+            if (currentSection && currentSection.content.trim()) {
+                sections.push(currentSection);
+            }
+            currentSection = {
+                title: headingMatch[2]?.trim() ?? '',
+                content: '',
+            };
+            continue;
+        }
+        // Adicionar conteúdo à seção atual
+        if (currentSection) {
+            currentSection.content += line + '\n';
+        }
+    }
+    // Salvar última seção
+    if (currentSection && currentSection.content.trim()) {
+        sections.push(currentSection);
+    }
+    // Identificar seções de uso
+    const usageSections = sections.filter(s => /usage|example|quick.?start|getting.?started|how.?to|api|guide/i.test(s.title));
+    // Identificar descrição (primeira seção ou conteúdo antes do primeiro heading)
+    const description = extractDescription(content, sections);
+    return {
+        description: description ?? undefined,
+        usageSections,
+        codeBlocks: uniqBy(codeBlocks, c => c.code.substring(0, 100)),
+    };
+}
+/**
+ * Extrai a descrição do README (texto antes do primeiro heading ou primeira seção).
+ */
+function extractDescription(content, sections) {
+    if (sections.length > 0 && !sections[0]?.title) {
+        return sections[0]?.content.trim();
+    }
+    const firstHeading = content.indexOf('\n#');
+    if (firstHeading > 0) {
+        const desc = content.substring(0, firstHeading).trim();
+        return desc.length > 0 ? desc : undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=readme-extractor.js.map

package/build/extractors/readme-extractor.js.map

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

package/build/formatters/markdown-formatter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Formata dados extraídos em markdown otimizado para contexto de LLM.
+ * Compacto mas informativo -- cada token conta.
+ */
+import type { PackageMeta, ExtractedSymbol, SearchResult } from '../types/index.js';
+import type { CodeExample } from '../extractors/examples-extractor.js';
+export declare function formatPackageInfo(meta: PackageMeta): string;
+export declare function formatApiSurface(symbols: ReadonlyArray<ExtractedSymbol>, kind: string, limit: number): string;
+export declare function formatSearchResults(results: ReadonlyArray<SearchResult>): string;
+export declare function formatSymbolUsage(symbol: ExtractedSymbol, importPaths: string[]): string;
+export declare function formatExamples(examples: ReadonlyArray<CodeExample>): string;
+//# sourceMappingURL=markdown-formatter.d.ts.map

package/build/formatters/markdown-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-formatter.d.ts","sourceRoot":"","sources":["../../src/formatters/markdown-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,YAAY,EACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAMvE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAiD3D;AAMD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAiCR;AAMD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,MAAM,CAwBhF;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CA6ExF;AAMD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,MAAM,CAuB3E"}