@refrakt-md/cli 0.9.0 → 0.9.1

package/dist/extractors/types.d.ts

@@ -1,55 +0,0 @@
-export type SymbolKind = 'function' | 'class' | 'interface' | 'enum' | 'type' | 'module' | 'hook' | 'component';
-export interface SymbolParameter {
-    name: string;
-    type: string;
-    description: string;
-    optional: boolean;
-    defaultValue?: string;
-    children?: SymbolParameter[];
-}
-export interface SymbolReturn {
-    type: string;
-    description: string;
-}
-export interface SymbolThrows {
-    type: string;
-    description: string;
-}
-export interface SymbolMemberDoc {
-    name: string;
-    kind: 'property' | 'method' | 'constructor' | 'accessor' | 'index-signature';
-    signature: string;
-    description: string;
-    parameters?: SymbolParameter[];
-    returns?: SymbolReturn;
-    throws?: SymbolThrows[];
-    since?: string;
-    deprecated?: string;
-}
-export interface SymbolGroupDoc {
-    label: string;
-    members: SymbolMemberDoc[];
-}
-export interface SymbolDoc {
-    name: string;
-    kind: SymbolKind;
-    signature: string;
-    description: string;
-    parameters?: SymbolParameter[];
-    returns?: SymbolReturn;
-    throws?: SymbolThrows[];
-    since?: string;
-    deprecated?: string;
-    source?: string;
-    groups?: SymbolGroupDoc[];
-    filePath: string;
-    line: number;
-}
-export interface ExtractorResult {
-    symbols: SymbolDoc[];
-    filePath: string;
-}
-export interface SymbolExtractor {
-    extractFile(filePath: string): ExtractorResult;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/extractors/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/extractors/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAEhH,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,iBAAiB,CAAC;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC/B,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAC;CAC/C"}

package/dist/extractors/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/extractors/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/extractors/types.ts"],"names":[],"mappings":""}

package/dist/extractors/typescript.d.ts

@@ -1,28 +0,0 @@
-import type { SymbolExtractor, ExtractorResult } from './types.js';
-export declare class TypeScriptExtractor implements SymbolExtractor {
-    private program;
-    private checker;
-    private rootDir;
-    private sourceUrl?;
-    constructor(rootDir: string, sourceUrl?: string);
-    extractFile(filePath: string): ExtractorResult;
-    private extractExport;
-    private extractFunction;
-    private extractVariable;
-    private extractClass;
-    private extractClassMembers;
-    private extractInterface;
-    private extractInterfaceMembers;
-    private extractEnum;
-    private extractTypeAlias;
-    private extractMemberDoc;
-    private extractParameters;
-    private extractReturn;
-    private extractThrows;
-    private isPrivateOrProtected;
-    private hasModifier;
-    private buildSourceUrl;
-}
-/** Find all TypeScript source files in a directory */
-export declare function findSourceFiles(dir: string): string[];
-//# sourceMappingURL=typescript.d.ts.map

package/dist/extractors/typescript.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../src/extractors/typescript.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEsB,eAAe,EAAE,eAAe,EACjE,MAAM,YAAY,CAAC;AAkFpB,qBAAa,mBAAoB,YAAW,eAAe;IAC1D,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAoB/C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;IAmB9C,OAAO,CAAC,aAAa;IAuCrB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,eAAe;IAiDvB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,mBAAmB;IAuC3B,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,uBAAuB;IAuB/B,OAAO,CAAC,WAAW;IAyCnB,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,gBAAgB;IAkFxB,OAAO,CAAC,iBAAiB;IA8CzB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;CAKtB;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAQrD"}

package/dist/extractors/typescript.js

@@ -1,566 +0,0 @@
-import ts from 'typescript';
-import { resolve, relative, dirname } from 'node:path';
-import { readdirSync, statSync, existsSync } from 'node:fs';
-function getJSDocDescription(node) {
-    const jsDocs = node.jsDoc;
-    if (!jsDocs || jsDocs.length === 0)
-        return '';
-    const doc = jsDocs[jsDocs.length - 1];
-    if (!doc.comment)
-        return '';
-    if (typeof doc.comment === 'string')
-        return doc.comment;
-    return doc.comment.map((c) => c.text ?? '').join('');
-}
-function extractJSDoc(node) {
-    const description = getJSDocDescription(node);
-    const params = new Map();
-    let returns;
-    let since;
-    let deprecated;
-    const throws = [];
-    const tags = ts.getJSDocTags(node);
-    for (const tag of tags) {
-        const tagName = tag.tagName.text;
-        const comment = typeof tag.comment === 'string'
-            ? tag.comment
-            : tag.comment?.map((c) => c.text ?? '').join('') ?? '';
-        switch (tagName) {
-            case 'param': {
-                const paramTag = tag;
-                const name = paramTag.name?.getText() ?? '';
-                if (name)
-                    params.set(name, comment);
-                break;
-            }
-            case 'returns':
-            case 'return':
-                returns = comment;
-                break;
-            case 'since':
-                since = comment.trim();
-                break;
-            case 'deprecated':
-                deprecated = comment.trim() || 'true';
-                break;
-            case 'throws':
-            case 'throw':
-                throws.push(comment);
-                break;
-        }
-    }
-    return { description, params, returns, since, deprecated, throws };
-}
-function getLineNumber(node, sourceFile) {
-    return sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile)).line + 1;
-}
-function findTsFiles(dir) {
-    const files = [];
-    const entries = readdirSync(dir);
-    for (const entry of entries) {
-        if (entry === 'node_modules' || entry.startsWith('.'))
-            continue;
-        const fullPath = resolve(dir, entry);
-        const stat = statSync(fullPath);
-        if (stat.isDirectory()) {
-            files.push(...findTsFiles(fullPath));
-        }
-        else if (/\.tsx?$/.test(entry) && !entry.endsWith('.d.ts') && !entry.endsWith('.test.ts') && !entry.endsWith('.spec.ts')) {
-            files.push(fullPath);
-        }
-    }
-    return files;
-}
-export class TypeScriptExtractor {
-    program;
-    checker;
-    rootDir;
-    sourceUrl;
-    constructor(rootDir, sourceUrl) {
-        this.rootDir = resolve(rootDir);
-        this.sourceUrl = sourceUrl;
-        const configPath = ts.findConfigFile(this.rootDir, ts.sys.fileExists, 'tsconfig.json');
-        if (configPath) {
-            const configFile = ts.readConfigFile(configPath, ts.sys.readFile);
-            const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, dirname(configPath));
-            this.program = ts.createProgram(parsed.fileNames, parsed.options);
-        }
-        else {
-            const files = findTsFiles(this.rootDir);
-            this.program = ts.createProgram(files, {
-                target: ts.ScriptTarget.ESNext,
-                module: ts.ModuleKind.NodeNext,
-                moduleResolution: ts.ModuleResolutionKind.NodeNext,
-            });
-        }
-        this.checker = this.program.getTypeChecker();
-    }
-    extractFile(filePath) {
-        const absPath = resolve(filePath);
-        const sourceFile = this.program.getSourceFile(absPath);
-        if (!sourceFile)
-            return { symbols: [], filePath: absPath };
-        const fileSymbol = this.checker.getSymbolAtLocation(sourceFile);
-        if (!fileSymbol)
-            return { symbols: [], filePath: absPath };
-        const exports = this.checker.getExportsOfModule(fileSymbol);
-        const symbols = [];
-        for (const exp of exports) {
-            const doc = this.extractExport(exp, sourceFile);
-            if (doc)
-                symbols.push(doc);
-        }
-        return { symbols, filePath: absPath };
-    }
-    extractExport(symbol, sourceFile) {
-        // Resolve aliases (re-exports)
-        let resolved = symbol;
-        if (resolved.flags & ts.SymbolFlags.Alias) {
-            resolved = this.checker.getAliasedSymbol(resolved);
-        }
-        const declarations = resolved.getDeclarations();
-        if (!declarations || declarations.length === 0)
-            return null;
-        const decl = declarations[0];
-        // Skip re-exports from other files
-        if (decl.getSourceFile() !== sourceFile)
-            return null;
-        const name = symbol.getName();
-        if (ts.isFunctionDeclaration(decl)) {
-            return this.extractFunction(name, resolved, decl, sourceFile);
-        }
-        if (ts.isClassDeclaration(decl)) {
-            return this.extractClass(name, resolved, decl, sourceFile);
-        }
-        if (ts.isInterfaceDeclaration(decl)) {
-            return this.extractInterface(name, resolved, decl, sourceFile);
-        }
-        if (ts.isEnumDeclaration(decl)) {
-            return this.extractEnum(name, resolved, decl, sourceFile);
-        }
-        if (ts.isTypeAliasDeclaration(decl)) {
-            return this.extractTypeAlias(name, resolved, decl, sourceFile);
-        }
-        if (ts.isVariableDeclaration(decl)) {
-            return this.extractVariable(name, resolved, decl, sourceFile);
-        }
-        return null;
-    }
-    extractFunction(name, symbol, decl, sourceFile) {
-        const jsDoc = extractJSDoc(decl);
-        const kind = name.startsWith('use') && /^use[A-Z]/.test(name) ? 'hook' : 'function';
-        const type = this.checker.getTypeOfSymbolAtLocation(symbol, decl);
-        const signatures = type.getCallSignatures();
-        const signature = signatures.length > 0
-            ? this.checker.signatureToString(signatures[0], decl, ts.TypeFormatFlags.WriteArrowStyleSignature | ts.TypeFormatFlags.NoTruncation)
-            : this.checker.typeToString(type, decl, ts.TypeFormatFlags.NoTruncation);
-        const parameters = this.extractParameters(decl.parameters, jsDoc);
-        const returns = this.extractReturn(signatures[0], jsDoc);
-        const throws = this.extractThrows(jsDoc);
-        return {
-            name, kind, signature,
-            description: jsDoc.description,
-            parameters: parameters.length > 0 ? parameters : undefined,
-            returns, throws: throws.length > 0 ? throws : undefined,
-            since: jsDoc.since, deprecated: jsDoc.deprecated,
-            source: this.buildSourceUrl(sourceFile.fileName, getLineNumber(decl, sourceFile)),
-            filePath: sourceFile.fileName,
-            line: getLineNumber(decl, sourceFile),
-        };
-    }
-    extractVariable(name, symbol, decl, sourceFile) {
-        const type = this.checker.getTypeOfSymbolAtLocation(symbol, decl);
-        const callSigs = type.getCallSignatures();
-        // If the variable is a function (arrow function or function expression)
-        if (callSigs.length > 0) {
-            // Get JSDoc from the variable statement, not the declaration
-            const varStatement = decl.parent?.parent;
-            const jsDoc = varStatement ? extractJSDoc(varStatement) : extractJSDoc(decl);
-            const kind = name.startsWith('use') && /^use[A-Z]/.test(name) ? 'hook' : 'function';
-            const signature = this.checker.signatureToString(callSigs[0], decl, ts.TypeFormatFlags.WriteArrowStyleSignature | ts.TypeFormatFlags.NoTruncation);
-            // Try to get parameters from the initializer if it's an arrow function
-            let parameters = [];
-            if (decl.initializer && (ts.isArrowFunction(decl.initializer) || ts.isFunctionExpression(decl.initializer))) {
-                parameters = this.extractParameters(decl.initializer.parameters, jsDoc);
-            }
-            const returns = this.extractReturn(callSigs[0], jsDoc);
-            const throws = this.extractThrows(jsDoc);
-            return {
-                name, kind, signature,
-                description: jsDoc.description,
-                parameters: parameters.length > 0 ? parameters : undefined,
-                returns, throws: throws.length > 0 ? throws : undefined,
-                since: jsDoc.since, deprecated: jsDoc.deprecated,
-                source: this.buildSourceUrl(sourceFile.fileName, getLineNumber(decl, sourceFile)),
-                filePath: sourceFile.fileName,
-                line: getLineNumber(decl, sourceFile),
-            };
-        }
-        // Non-function variable — treat as a constant/value
-        const varStatement = decl.parent?.parent;
-        const jsDoc = varStatement ? extractJSDoc(varStatement) : extractJSDoc(decl);
-        const typeStr = this.checker.typeToString(type, decl, ts.TypeFormatFlags.NoTruncation);
-        return {
-            name, kind: 'function', // use 'function' kind for exported constants since there's no 'const' kind
-            signature: `const ${name}: ${typeStr}`,
-            description: jsDoc.description,
-            since: jsDoc.since, deprecated: jsDoc.deprecated,
-            source: this.buildSourceUrl(sourceFile.fileName, getLineNumber(decl, sourceFile)),
-            filePath: sourceFile.fileName,
-            line: getLineNumber(decl, sourceFile),
-        };
-    }
-    extractClass(name, _symbol, decl, sourceFile) {
-        const jsDoc = extractJSDoc(decl);
-        // Build class signature
-        let signature = `class ${name}`;
-        if (decl.heritageClauses) {
-            for (const clause of decl.heritageClauses) {
-                const keyword = clause.token === ts.SyntaxKind.ExtendsKeyword ? 'extends' : 'implements';
-                const types = clause.types.map(t => t.getText(sourceFile)).join(', ');
-                signature += ` ${keyword} ${types}`;
-            }
-        }
-        const groups = this.extractClassMembers(decl, sourceFile);
-        return {
-            name, kind: 'class', signature,
-            description: jsDoc.description,
-            groups: groups.length > 0 ? groups : undefined,
-            since: jsDoc.since, deprecated: jsDoc.deprecated,
-            source: this.buildSourceUrl(sourceFile.fileName, getLineNumber(decl, sourceFile)),
-            filePath: sourceFile.fileName,
-            line: getLineNumber(decl, sourceFile),
-        };
-    }
-    extractClassMembers(decl, sourceFile) {
-        const constructors = [];
-        const properties = [];
-        const methods = [];
-        const staticProperties = [];
-        const staticMethods = [];
-        const accessors = [];
-        for (const member of decl.members) {
-            if (this.isPrivateOrProtected(member))
-                continue;
-            const isStatic = this.hasModifier(member, ts.SyntaxKind.StaticKeyword);
-            if (ts.isConstructorDeclaration(member)) {
-                constructors.push(this.extractMemberDoc(member, 'constructor', sourceFile));
-            }
-            else if (ts.isPropertyDeclaration(member)) {
-                const doc = this.extractMemberDoc(member, 'property', sourceFile);
-                if (isStatic)
-                    staticProperties.push(doc);
-                else
-                    properties.push(doc);
-            }
-            else if (ts.isMethodDeclaration(member)) {
-                const doc = this.extractMemberDoc(member, 'method', sourceFile);
-                if (isStatic)
-                    staticMethods.push(doc);
-                else
-                    methods.push(doc);
-            }
-            else if (ts.isGetAccessorDeclaration(member) || ts.isSetAccessorDeclaration(member)) {
-                accessors.push(this.extractMemberDoc(member, 'accessor', sourceFile));
-            }
-        }
-        const groups = [];
-        if (constructors.length > 0)
-            groups.push({ label: 'Constructor', members: constructors });
-        if (properties.length > 0)
-            groups.push({ label: 'Properties', members: properties });
-        if (methods.length > 0)
-            groups.push({ label: 'Methods', members: methods });
-        if (staticProperties.length > 0)
-            groups.push({ label: 'Static Properties', members: staticProperties });
-        if (staticMethods.length > 0)
-            groups.push({ label: 'Static Methods', members: staticMethods });
-        if (accessors.length > 0)
-            groups.push({ label: 'Accessors', members: accessors });
-        return groups;
-    }
-    extractInterface(name, _symbol, decl, sourceFile) {
-        const jsDoc = extractJSDoc(decl);
-        let signature = `interface ${name}`;
-        if (decl.heritageClauses) {
-            for (const clause of decl.heritageClauses) {
-                const types = clause.types.map(t => t.getText(sourceFile)).join(', ');
-                signature += ` extends ${types}`;
-            }
-        }
-        if (decl.typeParameters && decl.typeParameters.length > 0) {
-            const params = decl.typeParameters.map(tp => tp.getText(sourceFile)).join(', ');
-            signature = `interface ${name}<${params}>` + signature.slice(`interface ${name}`.length);
-        }
-        const groups = this.extractInterfaceMembers(decl, sourceFile);
-        return {
-            name, kind: 'interface', signature,
-            description: jsDoc.description,
-            groups: groups.length > 0 ? groups : undefined,
-            since: jsDoc.since, deprecated: jsDoc.deprecated,
-            source: this.buildSourceUrl(sourceFile.fileName, getLineNumber(decl, sourceFile)),
-            filePath: sourceFile.fileName,
-            line: getLineNumber(decl, sourceFile),
-        };
-    }
-    extractInterfaceMembers(decl, sourceFile) {
-        const properties = [];
-        const methods = [];
-        const indexSignatures = [];
-        for (const member of decl.members) {
-            if (ts.isPropertySignature(member)) {
-                properties.push(this.extractMemberDoc(member, 'property', sourceFile));
-            }
-            else if (ts.isMethodSignature(member)) {
-                methods.push(this.extractMemberDoc(member, 'method', sourceFile));
-            }
-            else if (ts.isIndexSignatureDeclaration(member)) {
-                indexSignatures.push(this.extractMemberDoc(member, 'index-signature', sourceFile));
-            }
-        }
-        const groups = [];
-        if (properties.length > 0)
-            groups.push({ label: 'Properties', members: properties });
-        if (methods.length > 0)
-            groups.push({ label: 'Methods', members: methods });
-        if (indexSignatures.length > 0)
-            groups.push({ label: 'Index Signatures', members: indexSignatures });
-        return groups;
-    }
-    extractEnum(name, _symbol, decl, sourceFile) {
-        const jsDoc = extractJSDoc(decl);
-        const parameters = [];
-        for (const member of decl.members) {
-            const memberName = member.name.getText(sourceFile);
-            const memberJsDoc = extractJSDoc(member);
-            let value = '';
-            if (member.initializer) {
-                value = member.initializer.getText(sourceFile);
-            }
-            else {
-                // Computed enum value
-                const memberSymbol = this.checker.getSymbolAtLocation(member.name);
-                if (memberSymbol) {
-                    const constantValue = this.checker.getConstantValue(member);
-                    if (constantValue !== undefined) {
-                        value = typeof constantValue === 'string' ? `"${constantValue}"` : String(constantValue);
-                    }
-                }
-            }
-            parameters.push({
-                name: memberName,
-                type: value,
-                description: memberJsDoc.description,
-                optional: false,
-            });
-        }
-        return {
-            name, kind: 'enum',
-            signature: `enum ${name}`,
-            description: jsDoc.description,
-            parameters: parameters.length > 0 ? parameters : undefined,
-            since: jsDoc.since, deprecated: jsDoc.deprecated,
-            source: this.buildSourceUrl(sourceFile.fileName, getLineNumber(decl, sourceFile)),
-            filePath: sourceFile.fileName,
-            line: getLineNumber(decl, sourceFile),
-        };
-    }
-    extractTypeAlias(name, _symbol, decl, sourceFile) {
-        const jsDoc = extractJSDoc(decl);
-        const typeNode = decl.type;
-        const typeText = typeNode.getText(sourceFile);
-        let signature = `type ${name}`;
-        if (decl.typeParameters && decl.typeParameters.length > 0) {
-            const params = decl.typeParameters.map(tp => tp.getText(sourceFile)).join(', ');
-            signature += `<${params}>`;
-        }
-        signature += ` = ${typeText}`;
-        return {
-            name, kind: 'type', signature,
-            description: jsDoc.description,
-            since: jsDoc.since, deprecated: jsDoc.deprecated,
-            source: this.buildSourceUrl(sourceFile.fileName, getLineNumber(decl, sourceFile)),
-            filePath: sourceFile.fileName,
-            line: getLineNumber(decl, sourceFile),
-        };
-    }
-    extractMemberDoc(member, kind, sourceFile) {
-        const jsDoc = extractJSDoc(member);
-        let name = '';
-        let signature = '';
-        let parameters;
-        let returns;
-        let throws;
-        if (ts.isConstructorDeclaration(member)) {
-            name = 'constructor';
-            const paramTexts = member.parameters.map(p => p.getText(sourceFile)).join(', ');
-            signature = `new (${paramTexts})`;
-            parameters = this.extractParameters(member.parameters, jsDoc);
-        }
-        else if (ts.isMethodDeclaration(member) || ts.isMethodSignature(member)) {
-            name = member.name?.getText(sourceFile) ?? '';
-            const memberSymbol = member.name ? this.checker.getSymbolAtLocation(member.name) : undefined;
-            if (memberSymbol) {
-                const type = this.checker.getTypeOfSymbolAtLocation(memberSymbol, member);
-                const callSigs = type.getCallSignatures();
-                if (callSigs.length > 0) {
-                    signature = `${name}${this.checker.signatureToString(callSigs[0], member, ts.TypeFormatFlags.NoTruncation)}`;
-                }
-                else {
-                    signature = member.getText(sourceFile);
-                }
-            }
-            else {
-                signature = member.getText(sourceFile);
-            }
-            if ('parameters' in member) {
-                parameters = this.extractParameters(member.parameters, jsDoc);
-            }
-            const memberSymbol2 = member.name ? this.checker.getSymbolAtLocation(member.name) : undefined;
-            if (memberSymbol2) {
-                const type = this.checker.getTypeOfSymbolAtLocation(memberSymbol2, member);
-                const callSigs = type.getCallSignatures();
-                if (callSigs.length > 0) {
-                    returns = this.extractReturn(callSigs[0], jsDoc);
-                }
-            }
-            const throwsDocs = this.extractThrows(jsDoc);
-            if (throwsDocs.length > 0)
-                throws = throwsDocs;
-        }
-        else if (ts.isPropertyDeclaration(member) || ts.isPropertySignature(member)) {
-            name = member.name?.getText(sourceFile) ?? '';
-            const memberSymbol = member.name ? this.checker.getSymbolAtLocation(member.name) : undefined;
-            if (memberSymbol) {
-                const type = this.checker.getTypeOfSymbolAtLocation(memberSymbol, member);
-                const typeStr = this.checker.typeToString(type, member, ts.TypeFormatFlags.NoTruncation);
-                const optional = member.questionToken ? '?' : '';
-                signature = `${name}${optional}: ${typeStr}`;
-            }
-            else {
-                signature = member.getText(sourceFile);
-            }
-        }
-        else if (ts.isGetAccessorDeclaration(member)) {
-            name = member.name?.getText(sourceFile) ?? '';
-            const memberSymbol = member.name ? this.checker.getSymbolAtLocation(member.name) : undefined;
-            if (memberSymbol) {
-                const type = this.checker.getTypeOfSymbolAtLocation(memberSymbol, member);
-                const typeStr = this.checker.typeToString(type, member, ts.TypeFormatFlags.NoTruncation);
-                signature = `get ${name}(): ${typeStr}`;
-            }
-            else {
-                signature = member.getText(sourceFile);
-            }
-        }
-        else if (ts.isSetAccessorDeclaration(member)) {
-            name = member.name?.getText(sourceFile) ?? '';
-            signature = member.getText(sourceFile);
-        }
-        else if (ts.isIndexSignatureDeclaration(member)) {
-            name = '[index]';
-            signature = member.getText(sourceFile);
-        }
-        return {
-            name, kind, signature,
-            description: jsDoc.description,
-            parameters: parameters && parameters.length > 0 ? parameters : undefined,
-            returns, throws,
-            since: jsDoc.since, deprecated: jsDoc.deprecated,
-        };
-    }
-    extractParameters(params, jsDoc) {
-        return params.map(param => {
-            const name = param.name.getText();
-            const paramSymbol = this.checker.getSymbolAtLocation(param.name);
-            let type = 'unknown';
-            if (paramSymbol) {
-                const paramType = this.checker.getTypeOfSymbolAtLocation(paramSymbol, param);
-                type = this.checker.typeToString(paramType, param, ts.TypeFormatFlags.NoTruncation);
-            }
-            else if (param.type) {
-                type = param.type.getText();
-            }
-            const optional = !!param.questionToken || !!param.initializer;
-            let defaultValue;
-            if (param.initializer) {
-                defaultValue = param.initializer.getText();
-            }
-            const description = jsDoc.params.get(name) ?? '';
-            // Check for destructured object parameters with documented children
-            let children;
-            if (ts.isObjectBindingPattern(param.name)) {
-                children = param.name.elements.map(element => {
-                    const childName = element.name.getText();
-                    const childDesc = jsDoc.params.get(`${name}.${childName}`) ?? jsDoc.params.get(childName) ?? '';
-                    const childSymbol = this.checker.getSymbolAtLocation(element.name);
-                    let childType = 'unknown';
-                    if (childSymbol) {
-                        const ct = this.checker.getTypeOfSymbolAtLocation(childSymbol, element);
-                        childType = this.checker.typeToString(ct, element, ts.TypeFormatFlags.NoTruncation);
-                    }
-                    return {
-                        name: childName,
-                        type: childType,
-                        description: childDesc,
-                        optional: !!element.dotDotDotToken || !!element.initializer,
-                        defaultValue: element.initializer?.getText(),
-                    };
-                });
-            }
-            return { name, type, description, optional, defaultValue, children };
-        });
-    }
-    extractReturn(signature, jsDoc) {
-        if (!signature)
-            return undefined;
-        const returnType = this.checker.getReturnTypeOfSignature(signature);
-        const typeStr = this.checker.typeToString(returnType, undefined, ts.TypeFormatFlags.NoTruncation);
-        if (typeStr === 'void' && !jsDoc.returns)
-            return undefined;
-        return {
-            type: typeStr,
-            description: jsDoc.returns ?? '',
-        };
-    }
-    extractThrows(jsDoc) {
-        return jsDoc.throws.map(text => {
-            // Parse "ErrorType description" or just "description"
-            const match = text.match(/^(\w+)\s+(.*)/);
-            if (match) {
-                return { type: match[1], description: match[2] };
-            }
-            return { type: 'Error', description: text };
-        });
-    }
-    isPrivateOrProtected(member) {
-        const flags = ts.getCombinedModifierFlags(member);
-        return !!(flags & (ts.ModifierFlags.Private | ts.ModifierFlags.Protected));
-    }
-    hasModifier(member, kind) {
-        // Use canHaveModifiers + getModifiers for TS 5.x compatibility
-        const node = member;
-        if (!ts.canHaveModifiers(node))
-            return false;
-        const modifiers = ts.getModifiers(node);
-        return modifiers?.some((m) => m.kind === kind) ?? false;
-    }
-    buildSourceUrl(filePath, line) {
-        if (!this.sourceUrl)
-            return undefined;
-        const rel = relative(this.rootDir, filePath).replace(/\\/g, '/');
-        return `${this.sourceUrl.replace(/\/$/, '')}/${rel}#L${line}`;
-    }
-}
-/** Find all TypeScript source files in a directory */
-export function findSourceFiles(dir) {
-    const absDir = resolve(dir);
-    if (!existsSync(absDir))
-        return [];
-    const stat = statSync(absDir);
-    if (!stat.isDirectory()) {
-        return /\.tsx?$/.test(absDir) ? [absDir] : [];
-    }
-    return findTsFiles(absDir);
-}
-//# sourceMappingURL=typescript.js.map