import { type ExtractedComment } from "./extract";
/** インストール済みパッケージの所在とバージョン */
export interface InstalledPackageInfo {
    name: string;
    version: string;
    dir: string;
}
/**
 * projectDir から Node の解決規則でパッケージを見つけ、package.json の
 * バージョンを読む。見つからなければ案内付きのエラー。
 */
export declare function resolveInstalledPackageInfo(projectDir: string, packageName: string): InstalledPackageInfo;
/**
 * パッケージディレクトリ内の型定義ファイル(.d.ts / .d.mts / .d.cts)を
 * 再帰的に集める。入れ子の node_modules は対象外。パス順に整列して返す
 * (抽出結果の順序を安定させるため)。
 */
export declare function collectDeclarationFiles(packageDir: string): string[];
export interface PackageExtractResult {
    info: InstalledPackageInfo;
    /** 走査した型定義ファイル数 */
    fileCount: number;
    comments: ExtractedComment[];
}
/**
 * インストール済みパッケージの型定義から JSDoc を抽出する。
 *
 * symbol は "zod/lib/types.d.ts#ZodType.parse" のように
 * パッケージ名からの相対パスで記録する(status の一覧や共有パックを
 * 見たときに、どのパッケージのどの API か分かるようにするため)。
 */
export declare function extractInstalledPackage(projectDir: string, packageName: string): PackageExtractResult;