lsp-intelligence 0.2.1 → 0.3.2

package/dist/analysis/ts/extractExports.js

@@ -0,0 +1,178 @@
+import ts from 'typescript';
+/**
+ * Extract all exports from a TypeScript/JavaScript source file using the TS AST.
+ * Supports ESM (export function, export const, export { }, export * from, export default)
+ * and basic CJS (module.exports, exports.foo).
+ */
+export function extractExports(sf) {
+    const exports = [];
+    const filePath = sf.fileName;
+    function visit(node) {
+        // ESM: export function foo() {}
+        if (ts.isFunctionDeclaration(node) && hasExportModifier(node) && node.name) {
+            exports.push({
+                name: node.name.text,
+                exportedAs: [node.name.text],
+                kind: 'function',
+                filePath,
+                line: lineOf(node, sf),
+            });
+        }
+        // ESM: export class Foo {}
+        if (ts.isClassDeclaration(node) && hasExportModifier(node) && node.name) {
+            exports.push({
+                name: node.name.text,
+                exportedAs: [node.name.text],
+                kind: 'class',
+                filePath,
+                line: lineOf(node, sf),
+            });
+        }
+        // ESM: export interface Foo {}
+        if (ts.isInterfaceDeclaration(node) && hasExportModifier(node)) {
+            exports.push({
+                name: node.name.text,
+                exportedAs: [node.name.text],
+                kind: 'interface',
+                filePath,
+                line: lineOf(node, sf),
+                isTypeOnly: true,
+            });
+        }
+        // ESM: export type Foo = ...
+        if (ts.isTypeAliasDeclaration(node) && hasExportModifier(node)) {
+            exports.push({
+                name: node.name.text,
+                exportedAs: [node.name.text],
+                kind: 'type',
+                filePath,
+                line: lineOf(node, sf),
+                isTypeOnly: true,
+            });
+        }
+        // ESM: export enum Foo {}
+        if (ts.isEnumDeclaration(node) && hasExportModifier(node)) {
+            exports.push({
+                name: node.name.text,
+                exportedAs: [node.name.text],
+                kind: 'enum',
+                filePath,
+                line: lineOf(node, sf),
+            });
+        }
+        // ESM: export const foo = ..., export let bar = ...
+        if (ts.isVariableStatement(node) && hasExportModifier(node)) {
+            for (const decl of node.declarationList.declarations) {
+                if (ts.isIdentifier(decl.name)) {
+                    exports.push({
+                        name: decl.name.text,
+                        exportedAs: [decl.name.text],
+                        kind: node.declarationList.flags & ts.NodeFlags.Const ? 'const' : 'var',
+                        filePath,
+                        line: lineOf(node, sf),
+                    });
+                }
+            }
+        }
+        // ESM: export default ...
+        if (ts.isExportAssignment(node) && !node.isExportEquals) {
+            const name = ts.isIdentifier(node.expression) ? node.expression.text : 'default';
+            exports.push({
+                name,
+                exportedAs: ['default'],
+                kind: 'default',
+                filePath,
+                line: lineOf(node, sf),
+            });
+        }
+        // ESM: export { foo, bar as baz }
+        if (ts.isExportDeclaration(node)) {
+            const moduleSpec = node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier)
+                ? node.moduleSpecifier.text : undefined;
+            if (node.exportClause && ts.isNamedExports(node.exportClause)) {
+                for (const spec of node.exportClause.elements) {
+                    const localName = (spec.propertyName ?? spec.name).text;
+                    const exportedName = spec.name.text;
+                    exports.push({
+                        name: localName,
+                        exportedAs: [exportedName],
+                        kind: moduleSpec ? 'reexport' : 'unknown',
+                        filePath,
+                        line: lineOf(spec, sf),
+                        isTypeOnly: node.isTypeOnly || spec.isTypeOnly,
+                        moduleSpecifier: moduleSpec,
+                    });
+                }
+            }
+            else if (!node.exportClause && moduleSpec) {
+                // export * from '...'
+                exports.push({
+                    name: '*',
+                    exportedAs: ['*'],
+                    kind: 'reexport',
+                    filePath,
+                    line: lineOf(node, sf),
+                    moduleSpecifier: moduleSpec,
+                });
+            }
+        }
+        // CJS: module.exports = ... or module.exports.foo = ...
+        if (ts.isExpressionStatement(node) && ts.isBinaryExpression(node.expression)) {
+            const left = node.expression.left;
+            if (ts.isPropertyAccessExpression(left)) {
+                const text = getPropertyChain(left);
+                if (text === 'module.exports') {
+                    exports.push({
+                        name: 'default',
+                        exportedAs: ['default'],
+                        kind: 'cjs',
+                        filePath,
+                        line: lineOf(node, sf),
+                    });
+                }
+                else if (text.startsWith('module.exports.')) {
+                    const name = text.slice('module.exports.'.length);
+                    exports.push({
+                        name,
+                        exportedAs: [name],
+                        kind: 'cjs',
+                        filePath,
+                        line: lineOf(node, sf),
+                    });
+                }
+                else if (text.startsWith('exports.')) {
+                    const name = text.slice('exports.'.length);
+                    exports.push({
+                        name,
+                        exportedAs: [name],
+                        kind: 'cjs',
+                        filePath,
+                        line: lineOf(node, sf),
+                    });
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sf);
+    return exports;
+}
+function hasExportModifier(node) {
+    const mods = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+    return mods?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+}
+function lineOf(node, sf) {
+    return sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+}
+function getPropertyChain(node) {
+    const parts = [node.name.text];
+    let current = node.expression;
+    while (ts.isPropertyAccessExpression(current)) {
+        parts.unshift(current.name.text);
+        current = current.expression;
+    }
+    if (ts.isIdentifier(current))
+        parts.unshift(current.text);
+    return parts.join('.');
+}
+//# sourceMappingURL=extractExports.js.map

package/dist/analysis/ts/extractExports.js.map

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

package/dist/analysis/ts/extractRoutes.d.ts

@@ -0,0 +1,12 @@
+import ts from 'typescript';
+import type { RouteIndexEntry } from '../../search/types.js';
+/**
+ * Extract route definitions from a TypeScript/JavaScript source file.
+ *
+ * Supports:
+ * - Express/Fastify: app.get('/path', handler), router.post(...)
+ * - Next.js App Router: exported GET/POST/etc in route.ts files
+ * - Next.js Pages API: default export in pages/api/** files
+ * - Route maps: object literals with path/method/handler fields
+ */
+export declare function extractRoutes(sf: ts.SourceFile): RouteIndexEntry[];

package/dist/analysis/ts/extractRoutes.js

@@ -0,0 +1,165 @@
+import ts from 'typescript';
+import * as path from 'path';
+const HTTP_METHODS = new Set(['get', 'post', 'put', 'patch', 'delete', 'options', 'head', 'all', 'use']);
+const NEXT_HANDLER_NAMES = new Set(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS', 'HEAD']);
+/**
+ * Extract route definitions from a TypeScript/JavaScript source file.
+ *
+ * Supports:
+ * - Express/Fastify: app.get('/path', handler), router.post(...)
+ * - Next.js App Router: exported GET/POST/etc in route.ts files
+ * - Next.js Pages API: default export in pages/api/** files
+ * - Route maps: object literals with path/method/handler fields
+ */
+export function extractRoutes(sf) {
+    const entries = [];
+    const filePath = sf.fileName;
+    const basename = path.basename(filePath, path.extname(filePath));
+    const isRouteFile = basename === 'route';
+    const isPagesApi = filePath.includes('/pages/api/') || filePath.includes('/pages\\api\\');
+    function visit(node) {
+        // A. Express/Fastify-style: app.get('/path', handler)
+        if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression)) {
+            const method = node.expression.name.text.toLowerCase();
+            if (HTTP_METHODS.has(method) && node.arguments.length >= 1) {
+                const firstArg = node.arguments[0];
+                if (ts.isStringLiteral(firstArg) || ts.isNoSubstitutionTemplateLiteral(firstArg)) {
+                    const routePath = firstArg.text;
+                    const line = sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+                    const callee = getCalleeText(node.expression.expression);
+                    entries.push({
+                        filePath, line,
+                        method: method === 'use' ? undefined : method.toUpperCase(),
+                        path: routePath,
+                        framework: callee?.includes('fastify') ? 'fastify' : 'express',
+                        enclosingSymbol: callee,
+                        tokens: tokenize(`${method} ${routePath} ${callee ?? ''}`),
+                        text: `${method.toUpperCase()} ${routePath}`,
+                    });
+                }
+            }
+        }
+        // B. Fastify route({ method, url, handler })
+        if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression)) {
+            if (node.expression.name.text === 'route' && node.arguments.length >= 1) {
+                const arg = node.arguments[0];
+                if (ts.isObjectLiteralExpression(arg)) {
+                    const method = getPropertyValue(arg, 'method');
+                    const url = getPropertyValue(arg, 'url');
+                    if (method && url) {
+                        const line = sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+                        entries.push({
+                            filePath, line,
+                            method: method.toUpperCase(),
+                            path: url,
+                            framework: 'fastify',
+                            tokens: tokenize(`${method} ${url} route`),
+                            text: `${method.toUpperCase()} ${url}`,
+                        });
+                    }
+                }
+            }
+        }
+        // C. Next.js App Router: exported GET, POST, etc. in route.ts
+        if (isRouteFile && isExportedNamedDeclaration(node)) {
+            const name = getExportedName(node);
+            if (name && NEXT_HANDLER_NAMES.has(name)) {
+                const line = sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+                const routePath = deriveRouteFromFilePath(filePath);
+                entries.push({
+                    filePath, line,
+                    method: name,
+                    path: routePath,
+                    framework: 'next-app-router',
+                    enclosingSymbol: name,
+                    tokens: tokenize(`${name} ${routePath ?? ''} next handler`),
+                    text: `${name} ${routePath ?? filePath}`,
+                });
+            }
+        }
+        // D. Next.js Pages API: default export in pages/api/**
+        if (isPagesApi && ts.isExportAssignment(node)) {
+            const line = sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+            const routePath = deriveRouteFromFilePath(filePath);
+            entries.push({
+                filePath, line,
+                path: routePath,
+                framework: 'next-pages-api',
+                tokens: tokenize(`${routePath ?? ''} api handler pages`),
+                text: `handler ${routePath ?? filePath}`,
+            });
+        }
+        // E. Route map: object with path/route/method/handler keys
+        if (ts.isObjectLiteralExpression(node) && node.properties.length >= 2) {
+            const hasPath = hasProperty(node, 'path') || hasProperty(node, 'route');
+            const hasHandler = hasProperty(node, 'handler') || hasProperty(node, 'component') || hasProperty(node, 'action');
+            if (hasPath && hasHandler) {
+                const routePath = getPropertyValue(node, 'path') ?? getPropertyValue(node, 'route');
+                const method = getPropertyValue(node, 'method');
+                const line = sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+                entries.push({
+                    filePath, line,
+                    method: method?.toUpperCase(),
+                    path: routePath,
+                    framework: 'route-map',
+                    tokens: tokenize(`${method ?? ''} ${routePath ?? ''} route map`),
+                    text: `${method?.toUpperCase() ?? 'ROUTE'} ${routePath ?? '?'}`,
+                });
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sf);
+    return entries;
+}
+function getCalleeText(expr) {
+    if (ts.isIdentifier(expr))
+        return expr.text;
+    if (ts.isPropertyAccessExpression(expr))
+        return getCalleeText(expr.expression);
+    return undefined;
+}
+function isExportedNamedDeclaration(node) {
+    if (ts.isFunctionDeclaration(node) || ts.isVariableStatement(node)) {
+        const mods = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+        return mods?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+    }
+    return false;
+}
+function getExportedName(node) {
+    if (ts.isFunctionDeclaration(node) && node.name)
+        return node.name.text;
+    if (ts.isVariableStatement(node)) {
+        for (const decl of node.declarationList.declarations) {
+            if (ts.isIdentifier(decl.name))
+                return decl.name.text;
+        }
+    }
+    return undefined;
+}
+function hasProperty(obj, name) {
+    return obj.properties.some((p) => ts.isPropertyAssignment(p) && ts.isIdentifier(p.name) && p.name.text === name);
+}
+function getPropertyValue(obj, name) {
+    for (const p of obj.properties) {
+        if (ts.isPropertyAssignment(p) && ts.isIdentifier(p.name) && p.name.text === name) {
+            if (ts.isStringLiteral(p.initializer))
+                return p.initializer.text;
+        }
+    }
+    return undefined;
+}
+function deriveRouteFromFilePath(filePath) {
+    // Next.js: derive /api/foo from pages/api/foo.ts or app/api/foo/route.ts
+    const pagesMatch = filePath.match(/pages[/\\]api[/\\](.+?)(?:\/index)?\.\w+$/);
+    if (pagesMatch)
+        return `/api/${pagesMatch[1].replace(/\\/g, '/')}`;
+    const appMatch = filePath.match(/app[/\\](.+?)[/\\]route\.\w+$/);
+    if (appMatch)
+        return `/${appMatch[1].replace(/\\/g, '/')}`;
+    return undefined;
+}
+function tokenize(text) {
+    return text.toLowerCase().replace(/[^a-z0-9/\s-_]/g, ' ').split(/[\s-_/]+/).filter((t) => t.length > 1);
+}
+//# sourceMappingURL=extractRoutes.js.map

package/dist/analysis/ts/extractRoutes.js.map

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

package/dist/analysis/ts/parseSourceFile.d.ts

@@ -2,9 +2,13 @@ import ts from 'typescript';
 /**
  * Parse a TypeScript/JavaScript file into a ts.SourceFile using the TypeScript compiler API.
  * Supports: .ts, .tsx, .js, .jsx, .mjs, .cjs
+ *
+ * @param text - Optional overlay text. If provided, skips disk read and parses this content
+ *               instead. Used by Phase 2A snapshot-aware indexing for unsaved-buffer support.
+ *
  * Returns null if the file doesn't exist or can't be parsed.
  */
-export declare function parseSourceFile(filePath: string): ts.SourceFile | null;
+export declare function parseSourceFile(filePath: string, text?: string): ts.SourceFile | null;
 /**
  * Parse source content directly (for base-version comparison).
  */

package/dist/analysis/ts/parseSourceFile.js

@@ -4,11 +4,15 @@ import { scriptKindForFile } from '../../search/fileKinds.js';
 /**
  * Parse a TypeScript/JavaScript file into a ts.SourceFile using the TypeScript compiler API.
  * Supports: .ts, .tsx, .js, .jsx, .mjs, .cjs
+ *
+ * @param text - Optional overlay text. If provided, skips disk read and parses this content
+ *               instead. Used by Phase 2A snapshot-aware indexing for unsaved-buffer support.
+ *
  * Returns null if the file doesn't exist or can't be parsed.
  */
-export function parseSourceFile(filePath) {
+export function parseSourceFile(filePath, text) {
     try {
-        const content = fs.readFileSync(filePath, 'utf-8');
+        const content = text ?? fs.readFileSync(filePath, 'utf-8');
         return ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true, scriptKindForFile(filePath));
     }
     catch {

package/dist/analysis/ts/parseSourceFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseSourceFile.js","sourceRoot":"","sources":["../../../src/analysis/ts/parseSourceFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,QAAgB;IAClE,OAAO,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3G,CAAC"}
+{"version":3,"file":"parseSourceFile.js","sourceRoot":"","sources":["../../../src/analysis/ts/parseSourceFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAa;IAC7D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,QAAgB;IAClE,OAAO,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3G,CAAC"}

package/dist/analysis/ts/program/CheckerQueries.d.ts

@@ -0,0 +1,56 @@
+import ts from 'typescript';
+/**
+ * Focused TypeScript semantic query helpers built on a ts.Program.
+ *
+ * These answer questions that AST analysis alone cannot answer reliably.
+ * All methods are read-only and do not modify the program state.
+ *
+ * Keep integration points narrow: callers should ask for specific facts,
+ * not raw ts.Type objects.
+ */
+export declare class CheckerQueries {
+    private readonly program;
+    private checker;
+    constructor(program: ts.Program);
+    /**
+     * Get the string-valued members of an exported enum.
+     * Returns null if the enum cannot be found in the program.
+     */
+    getEnumMembers(filePath: string, enumName: string): string[] | null;
+    /**
+     * Given a switch statement (by containing function / file and line),
+     * return which enum members are handled and which are missing.
+     */
+    getSwitchExhaustiveness(filePath: string, enumFilePath: string, enumName: string): {
+        handled: string[];
+        missing: string[];
+        isExhaustive: boolean;
+    } | null;
+    /**
+     * Get the type text of an exported symbol in a file.
+     * Returns a human-readable type string, or null if not found.
+     */
+    getExportedSymbolType(filePath: string, symbolName: string): string | null;
+    /**
+     * Get parameter facts for an exported function: name, type text, optional status.
+     */
+    getFunctionParams(filePath: string, funcName: string): Array<{
+        name: string;
+        typeText: string;
+        optional: boolean;
+        rest: boolean;
+    }> | null;
+    /**
+     * Get the return type text for an exported function.
+     */
+    getReturnType(filePath: string, funcName: string): string | null;
+    /**
+     * Get semantic diagnostics for a file.
+     * Lighter than running the full LSP — useful for quick checks.
+     */
+    getSemanticDiagnostics(filePath: string): readonly ts.Diagnostic[];
+    /**
+     * Get all files in the program (resolved root names).
+     */
+    getProgramFiles(): string[];
+}

package/dist/analysis/ts/program/CheckerQueries.js

@@ -0,0 +1,187 @@
+import ts from 'typescript';
+/**
+ * Focused TypeScript semantic query helpers built on a ts.Program.
+ *
+ * These answer questions that AST analysis alone cannot answer reliably.
+ * All methods are read-only and do not modify the program state.
+ *
+ * Keep integration points narrow: callers should ask for specific facts,
+ * not raw ts.Type objects.
+ */
+export class CheckerQueries {
+    program;
+    checker;
+    constructor(program) {
+        this.program = program;
+        this.checker = program.getTypeChecker();
+    }
+    // ---------------------------------------------------------------------------
+    // Enum queries
+    // ---------------------------------------------------------------------------
+    /**
+     * Get the string-valued members of an exported enum.
+     * Returns null if the enum cannot be found in the program.
+     */
+    getEnumMembers(filePath, enumName) {
+        const sf = this.program.getSourceFile(filePath);
+        if (!sf)
+            return null;
+        let enumDecl;
+        ts.forEachChild(sf, (node) => {
+            if (ts.isEnumDeclaration(node) && node.name.text === enumName) {
+                enumDecl = node;
+            }
+        });
+        if (!enumDecl)
+            return null;
+        return enumDecl.members.map((m) => ts.isIdentifier(m.name) ? m.name.text : m.name.getText(sf));
+    }
+    /**
+     * Given a switch statement (by containing function / file and line),
+     * return which enum members are handled and which are missing.
+     */
+    getSwitchExhaustiveness(filePath, enumFilePath, enumName) {
+        const allMembers = this.getEnumMembers(enumFilePath, enumName);
+        if (!allMembers)
+            return null;
+        const sf = this.program.getSourceFile(filePath);
+        if (!sf)
+            return null;
+        const handled = new Set();
+        const visit = (node) => {
+            if (ts.isSwitchStatement(node)) {
+                for (const clause of node.caseBlock.clauses) {
+                    if (ts.isCaseClause(clause)) {
+                        // Check if the case expression is an enum member access
+                        if (ts.isPropertyAccessExpression(clause.expression)) {
+                            const memberName = clause.expression.name.text;
+                            if (allMembers.includes(memberName)) {
+                                handled.add(memberName);
+                            }
+                        }
+                    }
+                }
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sf);
+        const missing = allMembers.filter((m) => !handled.has(m));
+        return { handled: [...handled], missing, isExhaustive: missing.length === 0 };
+    }
+    // ---------------------------------------------------------------------------
+    // Function / type queries
+    // ---------------------------------------------------------------------------
+    /**
+     * Get the type text of an exported symbol in a file.
+     * Returns a human-readable type string, or null if not found.
+     */
+    getExportedSymbolType(filePath, symbolName) {
+        const sf = this.program.getSourceFile(filePath);
+        if (!sf)
+            return null;
+        let result = null;
+        const visit = (node) => {
+            if (result)
+                return;
+            // Function declarations
+            if (ts.isFunctionDeclaration(node) && node.name?.text === symbolName) {
+                const sym = this.checker.getSymbolAtLocation(node.name);
+                if (sym)
+                    result = this.checker.typeToString(this.checker.getTypeOfSymbolAtLocation(sym, node));
+                return;
+            }
+            // Variable declarations
+            if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name) && node.name.text === symbolName) {
+                const sym = this.checker.getSymbolAtLocation(node.name);
+                if (sym)
+                    result = this.checker.typeToString(this.checker.getTypeOfSymbolAtLocation(sym, node));
+                return;
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sf);
+        return result;
+    }
+    /**
+     * Get parameter facts for an exported function: name, type text, optional status.
+     */
+    getFunctionParams(filePath, funcName) {
+        const sf = this.program.getSourceFile(filePath);
+        if (!sf)
+            return null;
+        let funcNode;
+        const visit = (node) => {
+            if (funcNode)
+                return;
+            if (ts.isFunctionDeclaration(node) && node.name?.text === funcName) {
+                funcNode = node;
+                return;
+            }
+            if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name) && node.name.text === funcName) {
+                if (node.initializer && (ts.isArrowFunction(node.initializer) || ts.isFunctionExpression(node.initializer))) {
+                    funcNode = node.initializer;
+                    return;
+                }
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sf);
+        if (!funcNode)
+            return null;
+        return funcNode.parameters.map((p) => ({
+            name: ts.isIdentifier(p.name) ? p.name.text : p.name.getText(sf),
+            typeText: p.type ? p.type.getText(sf) : this.checker.typeToString(this.checker.getTypeAtLocation(p)),
+            optional: !!p.questionToken || !!p.initializer,
+            rest: !!p.dotDotDotToken,
+        }));
+    }
+    /**
+     * Get the return type text for an exported function.
+     */
+    getReturnType(filePath, funcName) {
+        const sf = this.program.getSourceFile(filePath);
+        if (!sf)
+            return null;
+        let result = null;
+        const visit = (node) => {
+            if (result)
+                return;
+            if (ts.isFunctionDeclaration(node) && node.name?.text === funcName) {
+                const sig = this.checker.getSignatureFromDeclaration(node);
+                if (sig)
+                    result = this.checker.typeToString(sig.getReturnType());
+                return;
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sf);
+        return result;
+    }
+    // ---------------------------------------------------------------------------
+    // Diagnostics
+    // ---------------------------------------------------------------------------
+    /**
+     * Get semantic diagnostics for a file.
+     * Lighter than running the full LSP — useful for quick checks.
+     */
+    getSemanticDiagnostics(filePath) {
+        const sf = this.program.getSourceFile(filePath);
+        if (!sf)
+            return [];
+        try {
+            return this.program.getSemanticDiagnostics(sf);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Get all files in the program (resolved root names).
+     */
+    getProgramFiles() {
+        return this.program.getSourceFiles()
+            .map((sf) => sf.fileName)
+            .filter((f) => !f.includes('node_modules') && !f.endsWith('.d.ts'));
+    }
+}
+//# sourceMappingURL=CheckerQueries.js.map