@prodisco/search-libs 0.1.0

package/dist/extractor/ast-parser.js

@@ -0,0 +1,118 @@
+/**
+ * TypeScript AST parsing utilities
+ */
+import * as ts from 'typescript';
+/**
+ * Create a TypeScript source file from source code
+ */
+export function createSourceFile(filePath, sourceCode) {
+    return ts.createSourceFile(filePath, sourceCode, ts.ScriptTarget.Latest, true);
+}
+/**
+ * Extract JSDoc comment from a node
+ */
+export function getJSDocDescription(node) {
+    const jsDocComments = ts.getJSDocCommentsAndTags(node);
+    for (const comment of jsDocComments) {
+        if (ts.isJSDoc(comment) && comment.comment) {
+            if (typeof comment.comment === 'string') {
+                return comment.comment;
+            }
+            // Handle JSDoc comment that is an array of nodes
+            if (Array.isArray(comment.comment)) {
+                return comment.comment
+                    .map((c) => (typeof c === 'string' ? c : c.getText()))
+                    .join('');
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Extract nested type references from a TypeNode
+ * Returns all type references found in the node
+ */
+export function extractNestedTypeRefs(typeNode, sourceFile) {
+    if (!typeNode) {
+        return [];
+    }
+    const refs = [];
+    function visit(node) {
+        if (ts.isTypeReferenceNode(node)) {
+            const typeName = node.typeName.getText(sourceFile);
+            if (!refs.includes(typeName)) {
+                refs.push(typeName);
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(typeNode);
+    return refs;
+}
+/**
+ * Extract parameter information from a function/method signature
+ */
+export function extractParameterInfo(params, sourceFile) {
+    const result = [];
+    for (const param of params) {
+        const name = param.name.getText(sourceFile);
+        const type = param.type?.getText(sourceFile) || 'any';
+        const optional = !!param.questionToken || !!param.initializer;
+        const description = getJSDocDescription(param);
+        result.push({ name, type, optional, description });
+    }
+    return result;
+}
+/**
+ * Split camelCase/PascalCase identifiers into separate words for better search matching
+ * e.g., "queryRange" -> "query Range", "queryRangeStream" -> "query Range Stream"
+ */
+export function splitCamelCase(identifier) {
+    return identifier.replace(/([a-z])([A-Z])/g, '$1 $2');
+}
+/**
+ * Check if a node has a specific modifier
+ */
+export function hasModifier(node, kind) {
+    const modifiers = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+    return modifiers?.some((m) => m.kind === kind) ?? false;
+}
+/**
+ * Check if a method is async (has async modifier or returns Promise)
+ */
+export function isAsyncMethod(node, sourceFile) {
+    // Check for async modifier
+    if (hasModifier(node, ts.SyntaxKind.AsyncKeyword)) {
+        return true;
+    }
+    // Check if return type is Promise
+    const returnType = node.type?.getText(sourceFile);
+    return returnType?.startsWith('Promise<') ?? false;
+}
+/**
+ * Check if a method is static
+ */
+export function isStaticMethod(node) {
+    return hasModifier(node, ts.SyntaxKind.StaticKeyword);
+}
+/**
+ * Check if a member is private (has private modifier or starts with underscore)
+ */
+export function isPrivateMember(node, sourceFile, name) {
+    if (hasModifier(node, ts.SyntaxKind.PrivateKeyword)) {
+        return true;
+    }
+    if (name && name.startsWith('_')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Get the text of a node, safely handling undefined
+ */
+export function getNodeText(node, sourceFile) {
+    if (!node)
+        return '';
+    return node.getText(sourceFile);
+}
+//# sourceMappingURL=ast-parser.js.map

package/dist/extractor/ast-parser.js.map

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

package/dist/extractor/function-extractor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Extract standalone functions from TypeScript files
+ */
+import * as ts from 'typescript';
+import type { ExtractedFunction } from './types.js';
+export interface ExtractFunctionsOptions {
+    /** If provided, only functions whose *local* name is in the set will be returned. */
+    allowlist?: Set<string>;
+    /** Optional rename map from localName -> publicName */
+    aliases?: Map<string, string>;
+}
+/**
+ * Extract all exported functions from a TypeScript file
+ */
+export declare function extractFunctionsFromFile(filePath: string, libraryName: string, options?: ExtractFunctionsOptions): ExtractedFunction[];
+/**
+ * Extract functions from export declarations (for libraries that re-export)
+ */
+export declare function extractExportedFunctions(sourceFile: ts.SourceFile, libraryName: string, filePath: string, resolver?: (moduleName: string) => string | null): ExtractedFunction[];
+//# sourceMappingURL=function-extractor.d.ts.map

package/dist/extractor/function-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-extractor.d.ts","sourceRoot":"","sources":["../../src/extractor/function-extractor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,YAAY,CAAC;AAQnE,MAAM,WAAW,uBAAuB;IACtC,qFAAqF;IACrF,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,uDAAuD;IACvD,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,uBAAuB,GAChC,iBAAiB,EAAE,CA+ErB;AAmGD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAC/C,iBAAiB,EAAE,CAkCrB"}

package/dist/extractor/function-extractor.js

@@ -0,0 +1,169 @@
+/**
+ * Extract standalone functions from TypeScript files
+ */
+import * as ts from 'typescript';
+import { readFileSync, existsSync } from 'fs';
+import { createSourceFile, getJSDocDescription, extractParameterInfo, } from './ast-parser.js';
+function isJavaScriptFile(filePath) {
+    return filePath.endsWith('.js') || filePath.endsWith('.mjs') || filePath.endsWith('.cjs');
+}
+/**
+ * Extract all exported functions from a TypeScript file
+ */
+export function extractFunctionsFromFile(filePath, libraryName, options) {
+    if (!existsSync(filePath)) {
+        return [];
+    }
+    const sourceCode = readFileSync(filePath, 'utf-8');
+    const sourceFile = createSourceFile(filePath, sourceCode);
+    const functions = [];
+    const allowlist = options?.allowlist;
+    const aliases = options?.aliases;
+    const defaultReturnType = isJavaScriptFile(filePath) ? 'any' : 'void';
+    function pushWithAlias(func) {
+        const publicName = aliases?.get(func.name) ?? func.name;
+        if (publicName !== func.name) {
+            func = {
+                ...func,
+                name: publicName,
+                signature: buildSignature(publicName, func.parameters, func.returnType),
+            };
+        }
+        functions.push(func);
+    }
+    function visit(node) {
+        // Extract function declarations
+        if (ts.isFunctionDeclaration(node) && node.name) {
+            const localName = node.name.text;
+            if (allowlist && !allowlist.has(localName)) {
+                // Not part of the public surface (or not requested)
+            }
+            else {
+                const extracted = extractFunctionDeclaration(node, sourceFile, libraryName, filePath, defaultReturnType);
+                if (extracted)
+                    pushWithAlias(extracted);
+            }
+        }
+        // Extract exported variable declarations that are arrow functions
+        if (ts.isVariableStatement(node)) {
+            const isExported = node.modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+            for (const decl of node.declarationList.declarations) {
+                if (ts.isIdentifier(decl.name) &&
+                    decl.initializer &&
+                    (ts.isArrowFunction(decl.initializer) ||
+                        ts.isFunctionExpression(decl.initializer))) {
+                    const localName = decl.name.text;
+                    const shouldInclude = allowlist
+                        ? allowlist.has(localName)
+                        : isExported;
+                    if (!shouldInclude)
+                        continue;
+                    const extracted = extractArrowFunction(decl, decl.initializer, sourceFile, libraryName, filePath, defaultReturnType);
+                    if (extracted)
+                        pushWithAlias(extracted);
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return functions;
+}
+/**
+ * Extract a function declaration
+ */
+function extractFunctionDeclaration(node, sourceFile, libraryName, filePath, defaultReturnType) {
+    if (!node.name)
+        return null;
+    const name = node.name.text;
+    // Skip internal functions
+    if (name.startsWith('_')) {
+        return null;
+    }
+    const description = getJSDocDescription(node) || `${name} function`;
+    const parameters = extractParameterInfo(node.parameters, sourceFile);
+    const returnType = node.type?.getText(sourceFile) || defaultReturnType;
+    const signature = buildSignature(name, parameters, returnType);
+    return {
+        name,
+        description,
+        signature,
+        parameters,
+        returnType,
+        sourceFile: filePath,
+        library: libraryName,
+    };
+}
+/**
+ * Extract an arrow function or function expression
+ */
+function extractArrowFunction(decl, func, sourceFile, libraryName, filePath, defaultReturnType) {
+    if (!ts.isIdentifier(decl.name))
+        return null;
+    const name = decl.name.text;
+    // Skip internal functions
+    if (name.startsWith('_')) {
+        return null;
+    }
+    const description = getJSDocDescription(decl) ||
+        getJSDocDescription(func) ||
+        `${name} function`;
+    const parameters = extractParameterInfo(func.parameters, sourceFile);
+    // Get return type from function or infer from arrow function
+    let returnType = func.type?.getText(sourceFile);
+    if (!returnType) {
+        // For JS (and TS without annotations), we default to a safe "any"
+        returnType = defaultReturnType === 'any' ? 'any' : ts.isArrowFunction(func) ? 'any' : defaultReturnType;
+    }
+    const signature = buildSignature(name, parameters, returnType);
+    return {
+        name,
+        description,
+        signature,
+        parameters,
+        returnType,
+        sourceFile: filePath,
+        library: libraryName,
+    };
+}
+/**
+ * Build a function signature string
+ */
+function buildSignature(name, parameters, returnType) {
+    const paramStr = parameters
+        .map((p) => `${p.name}${p.optional ? '?' : ''}: ${p.type}`)
+        .join(', ');
+    return `${name}(${paramStr}): ${returnType}`;
+}
+/**
+ * Extract functions from export declarations (for libraries that re-export)
+ */
+export function extractExportedFunctions(sourceFile, libraryName, filePath, resolver) {
+    const functions = [];
+    function visit(node) {
+        // Handle named exports: export { foo, bar }
+        if (ts.isExportDeclaration(node) &&
+            node.exportClause &&
+            ts.isNamedExports(node.exportClause)) {
+            for (const element of node.exportClause.elements) {
+                const exportName = element.name.getText(sourceFile);
+                // If there's a module specifier and a resolver, try to get the actual function
+                if (node.moduleSpecifier && resolver) {
+                    const moduleSpec = node.moduleSpecifier.getText(sourceFile).replace(/['"]/g, '');
+                    const resolvedPath = resolver(moduleSpec);
+                    if (resolvedPath) {
+                        const moduleFunctions = extractFunctionsFromFile(resolvedPath, libraryName);
+                        const found = moduleFunctions.find((f) => f.name === exportName);
+                        if (found) {
+                            functions.push(found);
+                        }
+                    }
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return functions;
+}
+//# sourceMappingURL=function-extractor.js.map

package/dist/extractor/function-extractor.js.map

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

package/dist/extractor/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Extractor module - Extract types, methods, and functions from TypeScript packages
+ */
+import type { ExtractionOptions, ExtractionResult } from './types.js';
+export * from './types.js';
+export { resolvePackage, findDtsFiles } from './package-resolver.js';
+export { extractTypesFromFile } from './type-extractor.js';
+export { extractMethodsFromFile } from './method-extractor.js';
+export { extractFunctionsFromFile } from './function-extractor.js';
+export * from './ast-parser.js';
+/**
+ * Extract types, methods, and functions from an npm package
+ */
+export declare function extractFromPackage(options: ExtractionOptions): ExtractionResult;
+/**
+ * Extract from specific .d.ts files
+ */
+export declare function extractFromFiles(files: string[], libraryName: string, options?: {
+    typeFilter?: RegExp | ((name: string) => boolean);
+    methodFilter?: RegExp | ((name: string) => boolean);
+}): ExtractionResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/extractor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extractor/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAKjB,MAAM,YAAY,CAAC;AAapB,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,cAAc,iBAAiB,CAAC;AAEhC;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAyM/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAClD,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;CACrD,GACA,gBAAgB,CAOlB"}

package/dist/extractor/index.js

@@ -0,0 +1,194 @@
+/**
+ * Extractor module - Extract types, methods, and functions from TypeScript packages
+ */
+import { join } from 'path';
+import { resolvePackage, getPackageJson, findMainEsmJs, buildEsmExportSurface, } from './package-resolver.js';
+import { extractTypesFromFile } from './type-extractor.js';
+import { extractMethodsFromFile } from './method-extractor.js';
+import { extractFunctionsFromFile } from './function-extractor.js';
+// Re-export types
+export * from './types.js';
+// Re-export utilities
+export { resolvePackage, findDtsFiles } from './package-resolver.js';
+export { extractTypesFromFile } from './type-extractor.js';
+export { extractMethodsFromFile } from './method-extractor.js';
+export { extractFunctionsFromFile } from './function-extractor.js';
+export * from './ast-parser.js';
+/**
+ * Extract types, methods, and functions from an npm package
+ */
+export function extractFromPackage(options) {
+    const { packageName, dtsFiles: providedDtsFiles, typeFilter, methodFilter, classFilter, basePath = process.cwd(), } = options;
+    const types = [];
+    const methods = [];
+    const functions = [];
+    const errors = [];
+    // Resolve package if no files provided
+    let dtsFiles = providedDtsFiles;
+    let exportAliases;
+    let publicExports;
+    let jsSurface;
+    if (!dtsFiles || dtsFiles.length === 0) {
+        const packageInfo = resolvePackage(packageName, basePath);
+        if (!packageInfo) {
+            errors.push({
+                file: packageName,
+                message: `Could not resolve package: ${packageName}`,
+            });
+            return { packageName, types, methods, functions, errors };
+        }
+        dtsFiles = packageInfo.allDtsFiles;
+        exportAliases = packageInfo.exportAliases;
+        publicExports = packageInfo.publicExports;
+        // JS fallback: if no .d.ts files exist, attempt to index from ESM JavaScript source.
+        if (dtsFiles.length === 0) {
+            const packageJsonPath = join(packageInfo.packagePath, 'package.json');
+            const packageJson = getPackageJson(packageJsonPath);
+            if (!packageJson) {
+                errors.push({
+                    file: packageName,
+                    message: `No .d.ts files found and could not read package.json for package: ${packageName}`,
+                });
+                return { packageName, types, methods, functions, errors };
+            }
+            const entryFile = findMainEsmJs(packageInfo.packagePath, packageJson);
+            if (!entryFile) {
+                errors.push({
+                    file: packageName,
+                    message: `No .d.ts files found and no ESM JavaScript entrypoint found for package: ${packageName}`,
+                });
+                return { packageName, types, methods, functions, errors };
+            }
+            jsSurface = buildEsmExportSurface(entryFile);
+            if (jsSurface.publicExports.size === 0) {
+                errors.push({
+                    file: packageName,
+                    message: `No .d.ts files found and no ESM exports discovered for package: ${packageName}`,
+                });
+                return { packageName, types, methods, functions, errors };
+            }
+        }
+    }
+    // Create filter functions
+    const typeFilterFn = typeof typeFilter === 'function'
+        ? typeFilter
+        : typeFilter instanceof RegExp
+            ? (name) => typeFilter.test(name)
+            : undefined;
+    const methodFilterFn = typeof methodFilter === 'function'
+        ? methodFilter
+        : methodFilter instanceof RegExp
+            ? (name) => methodFilter.test(name)
+            : undefined;
+    const classFilterFn = typeof classFilter === 'function'
+        ? classFilter
+        : classFilter instanceof RegExp
+            ? (name) => classFilter.test(name)
+            : undefined;
+    // === JS fallback extraction (ESM-only) ===
+    if (jsSurface) {
+        for (const filePath of jsSurface.filesToParse) {
+            const allowlist = jsSurface.exportAllowlistByFile.get(filePath);
+            if (!allowlist || allowlist.size === 0) {
+                continue;
+            }
+            const aliases = jsSurface.aliasMapByFile.get(filePath);
+            try {
+                // Extract types (classes) and filter to public surface
+                const fileTypes = extractTypesFromFile(filePath, packageName, {
+                    allowlist,
+                    aliases,
+                });
+                const filteredTypes = typeFilterFn
+                    ? fileTypes.filter((t) => typeFilterFn(t.name))
+                    : fileTypes;
+                types.push(...filteredTypes);
+                // Extract methods, then filter by exported classes (file-level allowlist) and apply aliases.
+                const rawMethods = extractMethodsFromFile(filePath, packageName);
+                const fileMethods = rawMethods
+                    .filter((m) => allowlist.has(m.className))
+                    .map((m) => {
+                    const internalClassName = m.className;
+                    const publicClassName = aliases?.get(internalClassName) ?? internalClassName;
+                    const description = m.description === `${m.name} method of ${internalClassName}`
+                        ? `${m.name} method of ${publicClassName}`
+                        : m.description;
+                    return {
+                        ...m,
+                        className: publicClassName,
+                        description,
+                    };
+                })
+                    .filter((m) => (classFilterFn ? classFilterFn(m.className) : true));
+                const filteredMethods = methodFilterFn
+                    ? fileMethods.filter((m) => methodFilterFn(m.name))
+                    : fileMethods;
+                methods.push(...filteredMethods);
+                // Extract functions and filter to public surface + apply aliases
+                const fileFunctions = extractFunctionsFromFile(filePath, packageName, {
+                    allowlist,
+                    aliases,
+                });
+                const filteredFunctions = methodFilterFn
+                    ? fileFunctions.filter((f) => methodFilterFn(f.name))
+                    : fileFunctions;
+                functions.push(...filteredFunctions);
+            }
+            catch (error) {
+                errors.push({
+                    file: filePath,
+                    message: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return { packageName, types, methods, functions, errors };
+    }
+    // === TypeScript declaration (.d.ts) extraction ===
+    for (const filePath of dtsFiles) {
+        try {
+            // Extract types
+            const fileTypes = extractTypesFromFile(filePath, packageName);
+            const filteredTypes = typeFilterFn
+                ? fileTypes.filter((t) => typeFilterFn(t.name))
+                : fileTypes;
+            types.push(...filteredTypes);
+            // Extract methods (pass classFilter, exportAliases, and publicExports for proper filtering)
+            const fileMethods = extractMethodsFromFile(filePath, packageName, classFilterFn, exportAliases, publicExports);
+            const filteredMethods = methodFilterFn
+                ? fileMethods.filter((m) => methodFilterFn(m.name))
+                : fileMethods;
+            methods.push(...filteredMethods);
+            // Extract functions
+            const fileFunctions = extractFunctionsFromFile(filePath, packageName);
+            const filteredFunctions = methodFilterFn
+                ? fileFunctions.filter((f) => methodFilterFn(f.name))
+                : fileFunctions;
+            functions.push(...filteredFunctions);
+        }
+        catch (error) {
+            errors.push({
+                file: filePath,
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return {
+        packageName,
+        types,
+        methods,
+        functions,
+        errors,
+    };
+}
+/**
+ * Extract from specific .d.ts files
+ */
+export function extractFromFiles(files, libraryName, options) {
+    return extractFromPackage({
+        packageName: libraryName,
+        dtsFiles: files,
+        typeFilter: options?.typeFilter,
+        methodFilter: options?.methodFilter,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/extractor/index.js.map

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

package/dist/extractor/method-extractor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Extract methods from TypeScript class declarations
+ */
+import * as ts from 'typescript';
+import type { ExtractedMethod } from './types.js';
+/**
+ * Extract all methods from a TypeScript file
+ *
+ * @param filePath - Path to the .d.ts file
+ * @param libraryName - Name of the library
+ * @param classFilter - Optional filter function for class names
+ * @param exportAliases - Optional map of internal class names to exported aliases
+ * @param publicExports - Optional set of publicly exported names (only index these)
+ */
+export declare function extractMethodsFromFile(filePath: string, libraryName: string, classFilter?: (className: string) => boolean, exportAliases?: Map<string, string>, publicExports?: Set<string>): ExtractedMethod[];
+/**
+ * Extract methods from a class declaration
+ *
+ * @param classNode - The class declaration AST node
+ * @param sourceFile - The source file containing the class
+ * @param libraryName - Name of the library
+ * @param filePath - Path to the source file
+ * @param resolvedClassName - Optional pre-resolved class name (with export alias applied)
+ */
+export declare function extractMethodsFromClass(classNode: ts.ClassDeclaration, sourceFile: ts.SourceFile, libraryName: string, filePath: string, resolvedClassName?: string): ExtractedMethod[];
+/**
+ * Extract methods from an interface declaration (for type libraries)
+ */
+export declare function extractMethodsFromInterface(interfaceNode: ts.InterfaceDeclaration, sourceFile: ts.SourceFile, libraryName: string, filePath: string): ExtractedMethod[];
+//# sourceMappingURL=method-extractor.d.ts.map

package/dist/extractor/method-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-extractor.d.ts","sourceRoot":"","sources":["../../src/extractor/method-extractor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAUlD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,EAC5C,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,eAAe,EAAE,CAmDnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,EAAE,CAAC,gBAAgB,EAC9B,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,CAAC,EAAE,MAAM,GACzB,eAAe,EAAE,CA6EnB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,EAAE,CAAC,oBAAoB,EACtC,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,eAAe,EAAE,CAyCnB"}