genifyai 0.1.0

package/README.md

@@ -0,0 +1,156 @@
+# Genify
+
+一个基于 MCP（Model Context Protocol）的本地代码检索/定位服务：用 ripgrep 做粗筛，用 Tree-sitter（AST）做定义级精筛，向 MCP 客户端提供可调用的工具，从而让"找代码位置/读上下文"更稳定、更可复用。
+
+## 能做什么
+
+- `search_symbol`：按符号定义搜索（function/class/interface/type/enum/const/let/var/组件/方法等），返回精确位置与签名，支持自动跟随导出链路。
+- `read_range`：按行号范围读取文件片段（1-based，包含 endLine）。
+- `search_fuzzy`：自然语言/关键词/别名的多路召回（别名命中、定义召回、文件名召回、文本命中），返回候选与打分原因。
+- `register_alias`：把自然语言称呼映射到代码位置，便于长期稳定命中。
+
+## 支持的语言
+
+| 语言 | 扩展名 | 符号类型 |
+|------|--------|----------|
+| TypeScript/JavaScript | `.ts` `.tsx` `.js` `.jsx` | function, class, interface, type, enum, const, let, var, function_component, method, getter, setter |
+| Solidity | `.sol` | contract, library, sol_interface, struct, event, modifier, error, function, enum |
+| HTML | `.html` `.htm` | element (#id), component (web components) |
+| CSS/Less/Sass | `.css` `.less` `.sass` `.scss` | selector (.class/#id), variable (--custom-prop), keyframes |
+
+默认忽略 `node_modules/dist/build/.git` 等目录。
+
+## 特性
+
+- **多语言支持**：TypeScript/JavaScript、Solidity、HTML、CSS/Less/Sass
+- **导出链路跟随**：自动解析 `export { } from`、`export * from`、`export default`，找到原始定义位置（仅 TS/JS）
+- **AST 解析缓存**：基于文件 mtime 的智能缓存，避免重复解析
+- **智能忽略规则**：自动读取 `.gitignore`，无需额外配置
+
+## 依赖
+
+- Node.js `>= 18`
+- 包管理器：`pnpm`
+
+## 快速开始（本地运行）
+
+```bash
+pnpm install
+pnpm build
+node dist/index.js
+```
+
+该服务使用 MCP stdio 传输；通常不需要你手动运行，而是由 MCP 客户端按配置拉起。
+
+## 作为 MCP Server 接入
+
+Genify 的工作区根目录使用启动进程的 `cwd`（`process.cwd()`）。因此建议把 `cwd` 设置为你的项目根目录（或在客户端里把命令的工作目录指向项目根）。
+
+通用配置（支持 `command + args` 的 MCP 客户端都适用）：
+
+```json
+{
+  "mcpServers": {
+    "genify": {
+      "command": "node",
+      "args": ["<绝对路径>/Genify/dist/index.js"],
+      "env": {}
+    }
+  }
+}
+```
+
+如果你把它发布/安装成可执行命令，也可以用：
+
+```json
+{
+  "mcpServers": {
+    "genify": {
+      "command": "npx",
+      "args": ["-y", "genify"],
+      "env": {}
+    }
+  }
+}
+```
+
+## 工具说明
+
+### `search_symbol`
+
+按符号定义搜索（AST 精筛），自动跟随导出链路找到原始定义。
+
+输入：
+
+```json
+{ "query": "Header", "type": "function_component", "scope": "src", "limit": 20, "followExports": true }
+```
+
+- `query`：符号名称
+- `type`：可选，过滤符号类型
+- `scope`：可选，搜索范围（相对路径）
+- `limit`：可选，返回数量（默认 20）
+- `followExports`：可选，是否跟随导出链路（默认 true）
+
+输出（示例）：
+
+```json
+[
+  {
+    "name": "Header",
+    "kind": "function_component",
+    "file": "src/components/Header.tsx",
+    "location": { "startLine": 10, "endLine": 85, "startCol": 0, "endCol": 1 },
+    "range": "[10:85]",
+    "signature": "export const Header = (...) =>",
+    "language": "tsx"
+  }
+]
+```
+
+### `read_range`
+
+按行号范围读取片段（`"[start:end]"`，1-based，包含 end）。
+
+输入：
+
+```json
+{ "filePath": "src/index.ts", "range": "[1:80]", "surround": 0 }
+```
+
+### `register_alias`
+
+把"自然语言称呼"绑定到代码目标上（目标格式：`relativePath#SymbolName` 或 `relativePath`）。
+
+输入：
+
+```json
+{ "term": "反转卡片", "target": "src/components/FlipCard.tsx#FlipCard" }
+```
+
+别名存储位置（项目内本地状态）：`.genify/aliases.json`
+
+### `search_fuzzy`
+
+面向自然语言/别名/关键词的多路召回，返回候选、分数与原因。
+
+输入：
+
+```json
+{ "query": "反转卡片", "scope": "src", "limit": 20 }
+```
+
+输出字段：
+
+- `file`：相对工作区路径
+- `range`：建议读取范围
+- `symbol/kind`：可选，命中定义时给出
+- `score`：0~1
+- `reasons`：召回/排序原因（如 `alias_hit`、`definition_match`、`filename_match`、`text_hit`）
+
+## 开发
+
+```bash
+pnpm dev   # watch 模式编译
+pnpm build # 编译
+```

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { searchSymbol, searchSymbolSchema } from './tools/searchSymbol.js';
+import { readRange, readRangeSchema } from './tools/readRange.js';
+import { registerAlias, registerAliasSchema } from './tools/registerAlias.js';
+import { searchFuzzy, searchFuzzySchema } from './tools/searchFuzzy.js';
+import { setWorkspaceRoot } from './utils/pathResolver.js';
+const server = new Server({
+    name: 'genify',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// 列出可用工具
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: 'search_symbol',
+                description: 'Search for symbol definitions (function, class, interface, type, enum, const, etc.) in the codebase. Returns precise locations using AST parsing.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'Symbol name to search for',
+                        },
+                        type: {
+                            type: 'string',
+                            enum: [
+                                'function',
+                                'class',
+                                'interface',
+                                'type',
+                                'enum',
+                                'const',
+                                'let',
+                                'var',
+                                'function_component',
+                                'method',
+                                'getter',
+                                'setter',
+                            ],
+                            description: 'Optional filter by symbol type',
+                        },
+                        scope: {
+                            type: 'string',
+                            description: 'Search scope (directory path relative to workspace)',
+                        },
+                        limit: {
+                            type: 'number',
+                            description: 'Maximum number of results (default: 20)',
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'read_range',
+                description: 'Read a specific line range from a file. Use this to examine code at locations returned by search_symbol.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        filePath: {
+                            type: 'string',
+                            description: 'File path relative to workspace root',
+                        },
+                        range: {
+                            type: 'string',
+                            description: 'Line range in format "[startLine:endLine]" (1-based, inclusive)',
+                            pattern: '^\\[\\d+:\\d+\\]$',
+                        },
+                        surround: {
+                            type: 'number',
+                            description: 'Number of surrounding context lines (default: 0)',
+                        },
+                    },
+                    required: ['filePath', 'range'],
+                },
+            },
+            {
+                name: 'register_alias',
+                description: 'Register an alias/nickname for a code location. Use this when natural language terms do not appear in code.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        term: {
+                            type: 'string',
+                            description: 'Alias or nickname (e.g., "flip card", "反转卡片")',
+                        },
+                        target: {
+                            type: 'string',
+                            description: 'Target in format "relativePath#SymbolName" or "relativePath"',
+                        },
+                    },
+                    required: ['term', 'target'],
+                },
+            },
+            {
+                name: 'search_fuzzy',
+                description: 'Fuzzy search using natural language, aliases, or keywords. Returns ranked candidates with scores and reasons.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'Natural language query, alias, or fuzzy keyword',
+                        },
+                        scope: {
+                            type: 'string',
+                            description: 'Search scope (directory path relative to workspace)',
+                        },
+                        limit: {
+                            type: 'number',
+                            description: 'Maximum number of results (default: 20)',
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+        ],
+    };
+});
+// 处理工具调用
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'search_symbol': {
+                const input = searchSymbolSchema.parse(args);
+                const results = await searchSymbol(input);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(results, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'read_range': {
+                const input = readRangeSchema.parse(args);
+                const result = readRange(input);
+                if (!result) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({ error: 'Failed to read file or invalid range' }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'register_alias': {
+                const input = registerAliasSchema.parse(args);
+                const result = registerAlias(input);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'search_fuzzy': {
+                const input = searchFuzzySchema.parse(args);
+                const results = await searchFuzzy(input);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(results, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ error: `Unknown tool: ${name}` }),
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        console.error(`[genify] Error in tool ${name}:`, errorMessage);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: errorMessage }),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    // 设置工作区根目录
+    setWorkspaceRoot(process.cwd());
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[genify] Server started');
+}
+main().catch((err) => {
+    console.error('[genify] Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/parsers/cache.d.ts

@@ -0,0 +1,9 @@
+import type { ParseResult } from './types.js';
+export declare function getCachedResult(filePath: string): ParseResult | null;
+export declare function setCachedResult(filePath: string, result: ParseResult): void;
+export declare function invalidateCache(filePath?: string): void;
+export declare function getCacheStats(): {
+    size: number;
+    files: string[];
+};
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/parsers/cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAU9C,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAoBpE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAW3E;AAED,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAMvD;AAED,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAKjE"}

package/dist/parsers/cache.js

@@ -0,0 +1,51 @@
+import * as fs from 'node:fs';
+import { toAbsolute } from '../utils/pathResolver.js';
+const cache = new Map();
+export function getCachedResult(filePath) {
+    const entry = cache.get(filePath);
+    if (!entry)
+        return null;
+    const absolutePath = toAbsolute(filePath);
+    try {
+        const stat = fs.statSync(absolutePath);
+        const currentMtime = stat.mtimeMs;
+        if (currentMtime === entry.mtime) {
+            return entry.result;
+        }
+        // mtime 变化，缓存失效
+        cache.delete(filePath);
+        return null;
+    }
+    catch {
+        cache.delete(filePath);
+        return null;
+    }
+}
+export function setCachedResult(filePath, result) {
+    const absolutePath = toAbsolute(filePath);
+    try {
+        const stat = fs.statSync(absolutePath);
+        cache.set(filePath, {
+            mtime: stat.mtimeMs,
+            result,
+        });
+    }
+    catch {
+        // 文件不存在，不缓存
+    }
+}
+export function invalidateCache(filePath) {
+    if (filePath) {
+        cache.delete(filePath);
+    }
+    else {
+        cache.clear();
+    }
+}
+export function getCacheStats() {
+    return {
+        size: cache.size,
+        files: Array.from(cache.keys()),
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/parsers/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/parsers/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAOtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE5C,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC;QAElC,IAAI,YAAY,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,CAAC;QAED,gBAAgB;QAChB,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,MAAmB;IACnE,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACvC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;YAClB,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/parsers/css.d.ts

@@ -0,0 +1,5 @@
+import type { SymbolInfo, SymbolKind, ParseResult, LanguageParser } from './types.js';
+export declare function parseFile(filePath: string): ParseResult;
+export declare function parseFileForSymbol(filePath: string, query: string, type?: SymbolKind): SymbolInfo[];
+export declare const cssParserInstance: LanguageParser;
+//# sourceMappingURL=css.d.ts.map

package/dist/parsers/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/parsers/css.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAc,cAAc,EAAE,MAAM,YAAY,CAAC;AA2FlG,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CA4BvD;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,UAAU,GAChB,UAAU,EAAE,CAOd;AAED,eAAO,MAAM,iBAAiB,EAAE,cAK/B,CAAC"}

package/dist/parsers/css.js

@@ -0,0 +1,122 @@
+import Parser from 'tree-sitter';
+import CSS from 'tree-sitter-css';
+import { readFileContent, formatRange } from '../utils/fileReader.js';
+import { getCachedResult, setCachedResult } from './cache.js';
+import { registerParser } from './registry.js';
+const cssParser = new Parser();
+cssParser.setLanguage(CSS);
+function extractSelectorName(node) {
+    // 提取选择器文本，清理空白
+    return node.text.replace(/\s+/g, ' ').trim();
+}
+function collectSymbols(node, filePath, sourceCode, symbols) {
+    // 规则集（选择器）
+    if (node.type === 'rule_set') {
+        const selectorsNode = node.childForFieldName('selectors') || node.namedChildren[0];
+        if (selectorsNode) {
+            const selectorText = extractSelectorName(selectorsNode);
+            // 只记录 class 和 id 选择器
+            if (selectorText.startsWith('.') || selectorText.startsWith('#')) {
+                symbols.push({
+                    name: selectorText.split(/[,\s]/)[0], // 取第一个选择器
+                    kind: 'selector',
+                    file: filePath,
+                    location: {
+                        startLine: node.startPosition.row + 1,
+                        endLine: node.endPosition.row + 1,
+                        startCol: node.startPosition.column,
+                        endCol: node.endPosition.column,
+                    },
+                    range: formatRange(node.startPosition.row + 1, node.endPosition.row + 1),
+                    signature: selectorText.length > 60 ? selectorText.substring(0, 60) + '...' : selectorText,
+                    language: 'css',
+                });
+            }
+        }
+    }
+    // @keyframes
+    if (node.type === 'keyframes_statement') {
+        const nameNode = node.childForFieldName('name') || node.namedChildren.find(c => c.type === 'keyframes_name');
+        if (nameNode) {
+            symbols.push({
+                name: nameNode.text,
+                kind: 'keyframes',
+                file: filePath,
+                location: {
+                    startLine: node.startPosition.row + 1,
+                    endLine: node.endPosition.row + 1,
+                    startCol: node.startPosition.column,
+                    endCol: node.endPosition.column,
+                },
+                range: formatRange(node.startPosition.row + 1, node.endPosition.row + 1),
+                signature: `@keyframes ${nameNode.text}`,
+                language: 'css',
+            });
+        }
+    }
+    // CSS 自定义属性（变量）在 :root 或其他地方声明
+    if (node.type === 'declaration') {
+        const propertyNode = node.childForFieldName('property') || node.namedChildren[0];
+        if (propertyNode && propertyNode.text.startsWith('--')) {
+            symbols.push({
+                name: propertyNode.text,
+                kind: 'variable',
+                file: filePath,
+                location: {
+                    startLine: node.startPosition.row + 1,
+                    endLine: node.endPosition.row + 1,
+                    startCol: node.startPosition.column,
+                    endCol: node.endPosition.column,
+                },
+                range: formatRange(node.startPosition.row + 1, node.endPosition.row + 1),
+                signature: node.text.length > 60 ? node.text.substring(0, 60) + '...' : node.text,
+                language: 'css',
+            });
+        }
+    }
+    for (const child of node.namedChildren) {
+        collectSymbols(child, filePath, sourceCode, symbols);
+    }
+}
+export function parseFile(filePath) {
+    const cached = getCachedResult(filePath);
+    if (cached) {
+        return cached;
+    }
+    const sourceCode = readFileContent(filePath);
+    if (!sourceCode) {
+        return { symbols: [], exports: [], errors: [`Failed to read file: ${filePath}`] };
+    }
+    try {
+        const tree = cssParser.parse(sourceCode);
+        const symbols = [];
+        const exports = [];
+        collectSymbols(tree.rootNode, filePath, sourceCode, symbols);
+        const result = { symbols, exports, errors: [] };
+        setCachedResult(filePath, result);
+        return result;
+    }
+    catch (err) {
+        return {
+            symbols: [],
+            exports: [],
+            errors: [`Failed to parse file: ${filePath} - ${err}`],
+        };
+    }
+}
+export function parseFileForSymbol(filePath, query, type) {
+    const { symbols } = parseFile(filePath);
+    return symbols.filter((s) => {
+        const nameMatch = s.name.toLowerCase().includes(query.toLowerCase());
+        const typeMatch = !type || s.kind === type;
+        return nameMatch && typeMatch;
+    });
+}
+export const cssParserInstance = {
+    language: 'css',
+    extensions: ['.css', '.less', '.sass', '.scss'],
+    parseFile,
+    parseFileForSymbol,
+};
+registerParser(cssParserInstance);
+//# sourceMappingURL=css.js.map

package/dist/parsers/css.js.map

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

package/dist/parsers/exportResolver.d.ts

@@ -0,0 +1,12 @@
+import type { SymbolInfo } from './types.js';
+export interface ResolvedExport {
+    originalFile: string;
+    originalName: string;
+    resolvedFile: string;
+    resolvedSymbol?: SymbolInfo;
+    exportChain: string[];
+}
+export declare function followExport(filePath: string, exportedName: string, visited?: Set<string>, depth?: number): ResolvedExport | null;
+export declare function resolveSymbolThroughExports(filePath: string, symbolName: string): SymbolInfo | null;
+export declare function getAllReexportedSymbols(filePath: string, visited?: Set<string>, depth?: number): SymbolInfo[];
+//# sourceMappingURL=exportResolver.d.ts.map

package/dist/parsers/exportResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportResolver.d.ts","sourceRoot":"","sources":["../../src/parsers/exportResolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,YAAY,CAAC;AA2BzD,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,EAChC,KAAK,GAAE,MAAU,GAChB,cAAc,GAAG,IAAI,CAkEvB;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,UAAU,GAAG,IAAI,CAGnB;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,EAChC,KAAK,GAAE,MAAU,GAChB,UAAU,EAAE,CAuBd"}