@openpkg-ts/sdk 0.34.0 → 0.35.0

package/dist/index.d.ts

@@ -1,74 +1,5 @@
 import { BreakingSeverity, CategorizedBreaking, calculateNextVersion, categorizeBreakingChanges, diffSpec, diffSpec as diffSpec2, MemberChangeInfo, recommendSemverBump, SemverBump, SemverRecommendation, SpecDiff } from "@openpkg-ts/spec";
-import { OpenPkg, SpecExport, SpecExportKind } from "@openpkg-ts/spec";
-type Predicate = (exp: SpecExport) => boolean;
-/**
-* Chainable query builder for filtering OpenPkg exports.
-* Filters are lazy - predicates only run on execution methods (find, first, count, etc).
-*/
-declare class QueryBuilder {
-	private spec;
-	private predicates;
-	constructor(spec: OpenPkg);
-	/**
-	* Filter by kind(s)
-	*/
-	byKind(...kinds: SpecExportKind[]): this;
-	/**
-	* Filter by name (exact string or regex pattern)
-	*/
-	byName(pattern: string | RegExp): this;
-	/**
-	* Filter by tag(s) - must have at least one matching tag
-	*/
-	byTag(...tags: string[]): this;
-	/**
-	* Filter by deprecation status
-	* @param include - true = only deprecated, false = exclude deprecated, undefined = all
-	*/
-	deprecated(include?: boolean): this;
-	/**
-	* Filter to exports with descriptions only
-	*/
-	withDescription(): this;
-	/**
-	* Search name and description (case-insensitive)
-	*/
-	search(term: string): this;
-	/**
-	* Custom predicate filter
-	*/
-	where(predicate: Predicate): this;
-	/**
-	* Filter by source module/file path (contains match)
-	*/
-	byModule(modulePath: string): this;
-	private matches;
-	/**
-	* Execute query and return matching exports
-	*/
-	find(): SpecExport[];
-	/**
-	* Execute query and return first match (or undefined)
-	*/
-	first(): SpecExport | undefined;
-	/**
-	* Execute query and return count of matches
-	*/
-	count(): number;
-	/**
-	* Execute query and return IDs of matching exports
-	*/
-	ids(): string[];
-	/**
-	* Execute query and return a new filtered OpenPkg spec
-	*/
-	toSpec(): OpenPkg;
-}
-/**
-* Create a query builder for the given spec
-*/
-declare function query(spec: OpenPkg): QueryBuilder;
-import { OpenPkg as OpenPkg2 } from "@openpkg-ts/spec";
+import { OpenPkg } from "@openpkg-ts/spec";
 /** Configuration for resolving external package re-exports */
 interface ExternalsConfig {
 	/** Package patterns to resolve (globs supported, e.g., "@myorg/*") */
@@ -102,9 +33,13 @@ interface ExtractOptions {
 	includePrivate?: boolean;
 	/** Configuration for resolving external package re-exports */
 	externals?: ExternalsConfig;
+	/** Max properties to serialize per object type (default: 20) */
+	maxProperties?: number;
+	/** Callback when properties are truncated */
+	onTruncation?: (typeName: string, actual: number, limit: number) => void;
 }
 interface ExtractResult {
-	spec: OpenPkg2;
+	spec: OpenPkg;
 	diagnostics: Diagnostic[];
 	forgottenExports?: ForgottenExport[];
 	/** Metadata about runtime schema extraction (when schemaExtraction: 'hybrid') */
@@ -117,6 +52,12 @@ interface ExtractResult {
 		vendors: string[];
 		/** Any errors encountered during runtime extraction */
 		errors: string[];
+		/** Non-fatal warnings from extraction (e.g., individual schema failures) */
+		warnings: Array<{
+			code: string;
+			message: string;
+			exportName?: string;
+		}>;
 		/** Extraction method used: 'compiled' or 'direct-ts (runtime)' */
 		method?: string;
 	};
@@ -222,7 +163,7 @@ declare function loadConfig(cwd: string): OpenpkgConfig | null;
 * @returns Merged config
 */
 declare function mergeConfig(fileConfig: OpenpkgConfig | null, cliOptions: Partial<OpenpkgConfig>): OpenpkgConfig;
-import { OpenPkg as OpenPkg3, SpecExport as SpecExport2 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg2, SpecExport } from "@openpkg-ts/spec";
 interface DiagnosticItem {
 	exportId: string;
 	exportName: string;
@@ -243,20 +184,20 @@ interface SpecDiagnostics {
 /**
 * Check if has @deprecated tag.
 */
-declare function hasDeprecatedTag(exp: SpecExport2): boolean;
+declare function hasDeprecatedTag(exp: SpecExport): boolean;
 /**
 * Get deprecation message from @deprecated tag.
 * Returns undefined if no reason provided.
 */
-declare function getDeprecationMessage(exp: SpecExport2): string | undefined;
+declare function getDeprecationMessage(exp: SpecExport): string | undefined;
 /**
 * Find params without descriptions in JSDoc.
 */
-declare function findMissingParamDocs(exp: SpecExport2): string[];
+declare function findMissingParamDocs(exp: SpecExport): string[];
 /**
 * Analyze a spec for quality issues.
 */
-declare function analyzeSpec(spec: OpenPkg3): SpecDiagnostics;
+declare function analyzeSpec(spec: OpenPkg2): SpecDiagnostics;
 import { SpecMember } from "@openpkg-ts/spec";
 /**
 * Extract badge strings from a member's visibility and flags.
@@ -267,8 +208,8 @@ declare function getMemberBadges(member: SpecMember): string[];
 * Format badges array into a display string (space-separated).
 */
 declare function formatBadges(badges: string[]): string;
-import { OpenPkg as OpenPkg9, SpecExport as SpecExport4, SpecExportKind as SpecExportKind5, SpecType } from "@openpkg-ts/spec";
-import { OpenPkg as OpenPkg4 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg8, SpecExport as SpecExport3, SpecExportKind as SpecExportKind4, SpecType } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg3 } from "@openpkg-ts/spec";
 interface HTMLOptions {
 	/** Page title override */
 	title?: string;
@@ -306,8 +247,8 @@ interface HTMLOptions {
 * const fragment = docs.toHTML({ export: 'greet', fullDocument: false })
 * ```
 */
-declare function toHTML2(spec: OpenPkg4, options?: HTMLOptions): string;
-import { OpenPkg as OpenPkg5, SpecExportKind as SpecExportKind2 } from "@openpkg-ts/spec";
+declare function toHTML2(spec: OpenPkg3, options?: HTMLOptions): string;
+import { OpenPkg as OpenPkg4, SpecExportKind } from "@openpkg-ts/spec";
 interface JSONOptions {
 	/** Include raw spec data alongside simplified data */
 	includeRaw?: boolean;
@@ -355,7 +296,7 @@ interface SimplifiedExample {
 interface SimplifiedExport {
 	id: string;
 	name: string;
-	kind: SpecExportKind2;
+	kind: SpecExportKind;
 	signature: string;
 	description?: string;
 	deprecated: boolean;
@@ -377,7 +318,7 @@ interface SimplifiedSpec {
 	version?: string;
 	description?: string;
 	exports: SimplifiedExport[];
-	byKind: Record<SpecExportKind2, SimplifiedExport[]>;
+	byKind: Record<SpecExportKind, SimplifiedExport[]>;
 	totalExports: number;
 }
 /**
@@ -401,7 +342,7 @@ interface SimplifiedSpec {
 * // { id, name, kind, signature, parameters, returns, ... }
 * ```
 */
-declare function toJSON2(spec: OpenPkg5, options?: JSONOptions): SimplifiedSpec | SimplifiedExport;
+declare function toJSON2(spec: OpenPkg4, options?: JSONOptions): SimplifiedSpec | SimplifiedExport;
 /**
 * Serialize to JSON string with formatting.
 *
@@ -409,10 +350,10 @@ declare function toJSON2(spec: OpenPkg5, options?: JSONOptions): SimplifiedSpec
 * @param options - JSON options plus pretty formatting option
 * @returns JSON string
 */
-declare function toJSONString(spec: OpenPkg5, options?: JSONOptions & {
+declare function toJSONString(spec: OpenPkg4, options?: JSONOptions & {
 	pretty?: boolean;
 }): string;
-import { OpenPkg as OpenPkg6, SpecExport as SpecExport3 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg5, SpecExport as SpecExport2 } from "@openpkg-ts/spec";
 interface MarkdownOptions {
 	/** Include frontmatter in output */
 	frontmatter?: boolean;
@@ -458,7 +399,7 @@ interface ExportMarkdownOptions extends MarkdownOptions {
 * })
 * ```
 */
-declare function exportToMarkdown(exp: SpecExport3, options?: MarkdownOptions): string;
+declare function exportToMarkdown(exp: SpecExport2, options?: MarkdownOptions): string;
 /**
 * Render entire spec to MDX.
 *
@@ -478,8 +419,8 @@ declare function exportToMarkdown(exp: SpecExport3, options?: MarkdownOptions):
 * // Single * const fnMdx = docs.toMarkdown({ export: 'greet' })
 * ```
 */
-declare function toMarkdown2(spec: OpenPkg6, options?: ExportMarkdownOptions): string;
-import { OpenPkg as OpenPkg7, SpecExportKind as SpecExportKind3 } from "@openpkg-ts/spec";
+declare function toMarkdown2(spec: OpenPkg5, options?: ExportMarkdownOptions): string;
+import { OpenPkg as OpenPkg6, SpecExportKind as SpecExportKind2 } from "@openpkg-ts/spec";
 type NavFormat = "fumadocs" | "docusaurus" | "generic";
 type GroupBy = "kind" | "module" | "tag" | "none";
 interface NavOptions {
@@ -494,7 +435,7 @@ interface NavOptions {
 	/** Include index pages for groups */
 	includeGroupIndex?: boolean;
 	/** Custom kind labels */
-	kindLabels?: Partial<Record<SpecExportKind3, string>>;
+	kindLabels?: Partial<Record<SpecExportKind2, string>>;
 	/** Sort exports alphabetically */
 	sortAlphabetically?: boolean;
 }
@@ -554,7 +495,7 @@ type DocusaurusSidebar = DocusaurusSidebarItem[];
 * const sidebar = docs.toNavigation({ format: 'docusaurus' })
 * ```
 */
-declare function toNavigation2(spec: OpenPkg7, options?: NavOptions): GenericNav | FumadocsMeta | DocusaurusSidebar;
+declare function toNavigation2(spec: OpenPkg6, options?: NavOptions): GenericNav | FumadocsMeta | DocusaurusSidebar;
 /**
 * Generate Fumadocs meta.json file content.
 *
@@ -568,7 +509,7 @@ declare function toNavigation2(spec: OpenPkg7, options?: NavOptions): GenericNav
 * fs.writeFileSync('docs/api/meta.json', meta)
 * ```
 */
-declare function toFumadocsMetaJSON(spec: OpenPkg7, options?: Omit<NavOptions, "format">): string;
+declare function toFumadocsMetaJSON(spec: OpenPkg6, options?: Omit<NavOptions, "format">): string;
 /**
 * Generate Docusaurus sidebar config.
 *
@@ -582,8 +523,8 @@ declare function toFumadocsMetaJSON(spec: OpenPkg7, options?: Omit<NavOptions, "
 * fs.writeFileSync('sidebars.js', sidebar)
 * ```
 */
-declare function toDocusaurusSidebarJS(spec: OpenPkg7, options?: Omit<NavOptions, "format">): string;
-import { OpenPkg as OpenPkg8, SpecExportKind as SpecExportKind4 } from "@openpkg-ts/spec";
+declare function toDocusaurusSidebarJS(spec: OpenPkg6, options?: Omit<NavOptions, "format">): string;
+import { OpenPkg as OpenPkg7, SpecExportKind as SpecExportKind3 } from "@openpkg-ts/spec";
 interface SearchOptions {
 	/** Base URL for search result links */
 	baseUrl?: string;
@@ -627,7 +568,7 @@ interface PagefindRecord {
 interface AlgoliaRecord {
 	objectID: string;
 	name: string;
-	kind: SpecExportKind4;
+	kind: SpecExportKind3;
 	description?: string;
 	signature: string;
 	content: string;
@@ -647,7 +588,7 @@ interface AlgoliaRecord {
 interface SearchRecord {
 	id: string;
 	name: string;
-	kind: SpecExportKind4;
+	kind: SpecExportKind3;
 	signature: string;
 	description?: string;
 	content: string;
@@ -676,7 +617,7 @@ interface SearchIndex {
 * // { records: [...], version: '1.0.0', packageName: 'my-lib' }
 * ```
 */
-declare function toSearchIndex2(spec: OpenPkg8, options?: SearchOptions): SearchIndex;
+declare function toSearchIndex2(spec: OpenPkg7, options?: SearchOptions): SearchIndex;
 /**
 * Generate Pagefind-compatible records.
 *
@@ -692,7 +633,7 @@ declare function toSearchIndex2(spec: OpenPkg8, options?: SearchOptions): Search
 * })
 * ```
 */
-declare function toPagefindRecords2(spec: OpenPkg8, options?: SearchOptions): PagefindRecord[];
+declare function toPagefindRecords2(spec: OpenPkg7, options?: SearchOptions): PagefindRecord[];
 /**
 * Generate Algolia-compatible records.
 *
@@ -706,7 +647,7 @@ declare function toPagefindRecords2(spec: OpenPkg8, options?: SearchOptions): Pa
 * // Upload to Algolia index
 * ```
 */
-declare function toAlgoliaRecords2(spec: OpenPkg8, options?: SearchOptions): AlgoliaRecord[];
+declare function toAlgoliaRecords2(spec: OpenPkg7, options?: SearchOptions): AlgoliaRecord[];
 /**
 * Serialize search index to JSON string.
 *
@@ -720,36 +661,36 @@ declare function toAlgoliaRecords2(spec: OpenPkg8, options?: SearchOptions): Alg
 * fs.writeFileSync('search-index.json', json)
 * ```
 */
-declare function toSearchIndexJSON(spec: OpenPkg8, options?: SearchOptions & {
+declare function toSearchIndexJSON(spec: OpenPkg7, options?: SearchOptions & {
 	pretty?: boolean;
 }): string;
 interface LoadOptions {
 	/** Path to openpkg.json file or the spec object directly */
-	input: string | OpenPkg9;
+	input: string | OpenPkg8;
 }
 interface DocsInstance {
 	/** The parsed OpenPkg spec */
-	spec: OpenPkg9;
+	spec: OpenPkg8;
 	/** Get an by its ID */
-	getExport(id: string): SpecExport4 | undefined;
+	getExport(id: string): SpecExport3 | undefined;
 	/** Get a type definition by its ID */
 	getType(id: string): SpecType | undefined;
 	/** Get all exports of a specific kind */
-	getExportsByKind(kind: SpecExportKind5): SpecExport4[];
+	getExportsByKind(kind: SpecExportKind4): SpecExport3[];
 	/** Get all exports */
-	getAllExports(): SpecExport4[];
+	getAllExports(): SpecExport3[];
 	/** Get all type definitions */
 	getAllTypes(): SpecType[];
 	/** Get exports by JSDoc tag (e.g., '@beta', '@internal') */
-	getExportsByTag(tagName: string): SpecExport4[];
+	getExportsByTag(tagName: string): SpecExport3[];
 	/** Search exports by name or description */
-	search(query: string): SpecExport4[];
+	search(query: string): SpecExport3[];
 	/** Get exports belonging to a specific module/namespace */
-	getModule(moduleName: string): SpecExport4[];
+	getModule(moduleName: string): SpecExport3[];
 	/** Get deprecated exports */
-	getDeprecated(): SpecExport4[];
+	getDeprecated(): SpecExport3[];
 	/** Get exports grouped by kind */
-	groupByKind(): Record<SpecExportKind5, SpecExport4[]>;
+	groupByKind(): Record<SpecExportKind4, SpecExport3[]>;
 	/** Render spec or single to MDX */
 	toMarkdown(options?: ExportMarkdownOptions): string;
 	/** Render spec or single to HTML */
@@ -777,7 +718,7 @@ interface DocsInstance {
 * const docs = loadSpec(spec)
 * ```
 */
-declare function loadSpec(spec: OpenPkg9): DocsInstance;
+declare function loadSpec(spec: OpenPkg8): DocsInstance;
 /**
 * Creates a docs instance for querying and rendering API documentation.
 *
@@ -799,8 +740,8 @@ declare function loadSpec(spec: OpenPkg9): DocsInstance;
 * docs.search('hook')
 * ```
 */
-declare function createDocs(input: string | OpenPkg9): DocsInstance;
-import { OpenPkg as OpenPkg10, SpecExport as SpecExport5, SpecMember as SpecMember2, SpecSchema, SpecSignature, SpecType as SpecType2, SpecTypeParameter } from "@openpkg-ts/spec";
+declare function createDocs(input: string | OpenPkg8): DocsInstance;
+import { OpenPkg as OpenPkg9, SpecExport as SpecExport4, SpecMember as SpecMember2, SpecSchema, SpecSignature, SpecType as SpecType2, SpecTypeParameter } from "@openpkg-ts/spec";
 interface FormatSchemaOptions {
 	/** Include package attribution for external types */
 	includePackage?: boolean;
@@ -881,7 +822,7 @@ declare function formatReturnType(sig?: SpecSignature): string;
 * // 'class Logger extends EventEmitter'
 * ```
 */
-declare function buildSignatureString(exp: SpecExport5, sigIndex?: number): string;
+declare function buildSignatureString(exp: SpecExport4, sigIndex?: number): string;
 /**
 * Resolve a type reference to its definition.
 *
@@ -895,7 +836,7 @@ declare function buildSignatureString(exp: SpecExport5, sigIndex?: number): stri
 * // { id: 'User', name: 'User', kind: 'interface', ... }
 * ```
 */
-declare function resolveTypeRef(ref: string, spec: OpenPkg10): SpecType2 | undefined;
+declare function resolveTypeRef(ref: string, spec: OpenPkg9): SpecType2 | undefined;
 /**
 * Check if a member is a method (has signatures).
 *
@@ -1010,6 +951,75 @@ declare function formatConditionalType(condType: SpecConditionalType): string;
 * ```
 */
 declare function formatMappedType(mappedType: SpecMappedType): string;
+import { OpenPkg as OpenPkg10, SpecExport as SpecExport5, SpecExportKind as SpecExportKind5 } from "@openpkg-ts/spec";
+type Predicate = (exp: SpecExport5) => boolean;
+/**
+* Chainable query builder for filtering OpenPkg exports.
+* Filters are lazy - predicates only run on execution methods (find, first, count, etc).
+*/
+declare class QueryBuilder {
+	private spec;
+	private predicates;
+	constructor(spec: OpenPkg10);
+	/**
+	* Filter by kind(s)
+	*/
+	byKind(...kinds: SpecExportKind5[]): this;
+	/**
+	* Filter by name (exact string or regex pattern)
+	*/
+	byName(pattern: string | RegExp): this;
+	/**
+	* Filter by tag(s) - must have at least one matching tag
+	*/
+	byTag(...tags: string[]): this;
+	/**
+	* Filter by deprecation status
+	* @param include - true = only deprecated, false = exclude deprecated, undefined = all
+	*/
+	deprecated(include?: boolean): this;
+	/**
+	* Filter to exports with descriptions only
+	*/
+	withDescription(): this;
+	/**
+	* Search name and description (case-insensitive)
+	*/
+	search(term: string): this;
+	/**
+	* Custom predicate filter
+	*/
+	where(predicate: Predicate): this;
+	/**
+	* Filter by source module/file path (contains match)
+	*/
+	byModule(modulePath: string): this;
+	private matches;
+	/**
+	* Execute query and return matching exports
+	*/
+	find(): SpecExport5[];
+	/**
+	* Execute query and return first match (or undefined)
+	*/
+	first(): SpecExport5 | undefined;
+	/**
+	* Execute query and return count of matches
+	*/
+	count(): number;
+	/**
+	* Execute query and return IDs of matching exports
+	*/
+	ids(): string[];
+	/**
+	* Execute query and return a new filtered OpenPkg spec
+	*/
+	toSpec(): OpenPkg10;
+}
+/**
+* Create a query builder for the given spec
+*/
+declare function query(spec: OpenPkg10): QueryBuilder;
 import { OpenPkg as OpenPkg11 } from "@openpkg-ts/spec";
 interface ReactLayoutOptions {
 	/** Output directory for generated files */
@@ -1165,6 +1175,10 @@ interface SerializerContext {
 	inTupleElement?: boolean;
 	/** Include private/protected class members (default: false) */
 	includePrivate?: boolean;
+	/** Max properties to serialize per object type (default: 20) */
+	maxProperties: number;
+	/** Callback when properties are truncated */
+	onTruncation?: (typeName: string, actual: number, limit: number) => void;
 }
 declare class TypeRegistry {
 	private types;
@@ -1296,11 +1310,34 @@ interface ExtractStandardSchemasOptions {
 	libraryOptions?: Record<string, unknown>;
 }
 /**
+* Warning codes for extraction diagnostics.
+*
+* - `SCHEMA_FAILED`: Standard Schema extraction failed (e.g., ~standard.jsonSchema.output() threw)
+* - `TYPEBOX_FAILED`: TypeBox schema sanitization failed
+* - `PARSE_FAILED`: Failed to parse subprocess JSON output
+* - `CLEANUP_FAILED`: Failed to delete temp worker script file
+* - `TSCONFIG_INVALID`: Could not parse tsconfig.json (uses defaults)
+*/
+type ExtractionWarningCode = "SCHEMA_FAILED" | "TYPEBOX_FAILED" | "PARSE_FAILED" | "CLEANUP_FAILED" | "TSCONFIG_INVALID" | "OUTPUT_TRUNCATED";
+/**
+* Warning from extraction process.
+* Captures non-fatal issues during schema extraction.
+*/
+interface ExtractionWarning {
+	/** Warning type identifier */
+	code: ExtractionWarningCode;
+	/** Human-readable description */
+	message: string;
+	/** Export name if applicable */
+	exportName?: string;
+}
+/**
 * Result of Standard Schema extraction.
 */
 interface StandardSchemaExtractionOutput {
 	schemas: Map<string, StandardSchemaExtractionResult>;
 	errors: string[];
+	warnings: ExtractionWarning[];
 }
 /**
 * Check if an object implements StandardJSONSchemaV1.
@@ -1387,21 +1424,124 @@ interface ProjectExtractionOutput extends StandardSchemaExtractionOutput {
 * @param options - Extraction options
 */
 declare function extractStandardSchemasFromProject(entryFile: string, baseDir: string, options?: ExtractFromProjectOptions): Promise<ProjectExtractionOutput>;
+/**
+* LRU Cache implementation with optional TTL support.
+* Used for bounded caching in spec extraction to prevent memory leaks.
+*/
+interface CacheManagerOptions {
+	/** Maximum number of entries (default: 1000) */
+	maxSize?: number;
+	/** Time-to-live in milliseconds (optional, no expiry if not set) */
+	ttl?: number;
+}
+/**
+* Bounded LRU cache with optional TTL.
+*
+* @example
+* ```ts
+* const cache = new CacheManager<string, number>({ maxSize: 100 });
+* cache.set('key', 42);
+* cache.get('key'); // 42
+* cache.clear();
+* ```
+*/
+declare class CacheManager<
+	K,
+	V
+> {
+	private cache;
+	private readonly maxSize;
+	private readonly ttl?;
+	constructor(options?: CacheManagerOptions);
+	/**
+	* Get a value from the cache.
+	* Returns undefined if not found or expired.
+	* Moves accessed entry to end (most recently used).
+	*/
+	get(key: K): V | undefined;
+	/**
+	* Check if key exists (without affecting LRU order).
+	*/
+	has(key: K): boolean;
+	/**
+	* Set a value in the cache.
+	* Evicts least recently used entry if at capacity.
+	*/
+	set(key: K, value: V): void;
+	/**
+	* Delete a specific key from the cache.
+	*/
+	delete(key: K): boolean;
+	/**
+	* Clear all entries from the cache.
+	*/
+	clear(): void;
+	/**
+	* Get the current number of entries.
+	*/
+	get size(): number;
+	/**
+	* Get all keys (for debugging/testing).
+	*/
+	keys(): IterableIterator<K>;
+	/**
+	* Get all values (for debugging/testing).
+	*/
+	values(): V[];
+}
+/**
+* Extract API specification from TypeScript source files.
+*
+* Analyzes exports from the entry file, serializes them to OpenPkg spec format,
+* and detects forgotten exports (types referenced but not exported).
+*
+* @param options - Extraction configuration
+* @param options.entryFile - Path to the entry TypeScript file
+* @param options.baseDir - Base directory for resolving imports (defaults to entryFile dir)
+* @param options.content - Optional in-memory source content (skips file read)
+* @param options.maxTypeDepth - Max depth for nested type resolution (default: 10)
+* @param options.only - Glob patterns to include (e.g., ["get*", "create*"])
+* @param options.ignore - Glob patterns to exclude (e.g., ["*Internal", "_*"])
+* @param options.onProgress - Callback fired for each export: (current, total, name) => void
+* @param options.isDtsSource - Set true when extracting from .d.ts (enables degraded mode)
+* @param options.externals - Config for resolving re-exports from external packages
+*
+* @returns Promise resolving to extraction result
+* @returns result.spec - The OpenPkg specification object
+* @returns result.diagnostics - Warnings/errors encountered during extraction
+* @returns result.verification - Stats comparing discovered vs extracted exports
+* @returns result.forgottenExports - Types referenced but not exported (internal only)
+*
+* @example
+* ```ts
+* import { extract } from '@openpkg-ts/sdk';
+*
+* const { spec, diagnostics } = await extract({
+*   entryFile: './src/index.ts',
+*   onProgress: (i, total, name) => console.log(`${i}/${total}: ${name}`),
+* });
+* ```
+*
+* @remarks
+* - Caches are cleared before and after extraction (via try/finally)
+* - Progress callback yields to event loop every 5 exports for UI responsiveness
+* - External package re-exports require explicit `externals.include` patterns
+*/
 declare function extract(options: ExtractOptions): Promise<ExtractResult>;
-import ts5 from "typescript";
+import ts7 from "typescript";
 interface ProgramOptions {
 	entryFile: string;
 	baseDir?: string;
 	content?: string;
 }
 interface ProgramResult {
-	program: ts5.Program;
-	compilerHost: ts5.CompilerHost;
-	compilerOptions: ts5.CompilerOptions;
-	sourceFile?: ts5.SourceFile;
+	program: ts7.Program;
+	compilerHost: ts7.CompilerHost;
+	compilerOptions: ts7.CompilerOptions;
+	sourceFile?: ts7.SourceFile;
 	configPath?: string;
 	/** Resolved project references (workspace packages) */
-	projectReferences?: ts5.ResolvedProjectReference[];
+	projectReferences?: ts7.ResolvedProjectReference[];
 }
 declare function createProgram({ entryFile, baseDir, content }: ProgramOptions): ProgramResult;
 import * as TS from "typescript";
@@ -1457,34 +1597,34 @@ declare const arktypeAdapter: SchemaAdapter;
 declare const typeboxAdapter: SchemaAdapter;
 declare const valibotAdapter: SchemaAdapter;
 declare const zodAdapter: SchemaAdapter;
-import { SpecExport as SpecExport8 } from "@openpkg-ts/spec";
-import ts6 from "typescript";
-declare function serializeClass(node: ts6.ClassDeclaration, ctx: SerializerContext): SpecExport8 | null;
 import { SpecExport as SpecExport9 } from "@openpkg-ts/spec";
-import ts7 from "typescript";
-declare function serializeEnum(node: ts7.EnumDeclaration, ctx: SerializerContext): SpecExport9 | null;
-import { SpecExport as SpecExport10 } from "@openpkg-ts/spec";
 import ts8 from "typescript";
-declare function serializeFunctionExport(node: ts8.FunctionDeclaration | ts8.ArrowFunction, ctx: SerializerContext, nameOverride?: string): SpecExport10 | null;
-import { SpecExport as SpecExport11 } from "@openpkg-ts/spec";
+declare function serializeClass(node: ts8.ClassDeclaration, ctx: SerializerContext): SpecExport9 | null;
+import { SpecExport as SpecExport10 } from "@openpkg-ts/spec";
 import ts9 from "typescript";
-declare function serializeInterface(node: ts9.InterfaceDeclaration, ctx: SerializerContext): SpecExport11 | null;
-import { SpecExport as SpecExport12 } from "@openpkg-ts/spec";
+declare function serializeEnum(node: ts9.EnumDeclaration, ctx: SerializerContext): SpecExport10 | null;
+import { SpecExport as SpecExport11 } from "@openpkg-ts/spec";
 import ts10 from "typescript";
-declare function serializeTypeAlias(node: ts10.TypeAliasDeclaration, ctx: SerializerContext): SpecExport12 | null;
-import { SpecExport as SpecExport13 } from "@openpkg-ts/spec";
+declare function serializeFunctionExport(node: ts10.FunctionDeclaration | ts10.ArrowFunction, ctx: SerializerContext, nameOverride?: string): SpecExport11 | null;
+import { SpecExport as SpecExport12 } from "@openpkg-ts/spec";
 import ts11 from "typescript";
-declare function serializeVariable(node: ts11.VariableDeclaration, statement: ts11.VariableStatement, ctx: SerializerContext): SpecExport13 | null;
-import { SpecSignatureParameter } from "@openpkg-ts/spec";
+declare function serializeInterface(node: ts11.InterfaceDeclaration, ctx: SerializerContext): SpecExport12 | null;
+import { SpecExport as SpecExport13 } from "@openpkg-ts/spec";
 import ts12 from "typescript";
-declare function extractParameters(signature: ts12.Signature, ctx: SerializerContext): SpecSignatureParameter[];
+declare function serializeTypeAlias(node: ts12.TypeAliasDeclaration, ctx: SerializerContext): SpecExport13 | null;
+import { SpecExport as SpecExport14 } from "@openpkg-ts/spec";
+import ts13 from "typescript";
+declare function serializeVariable(node: ts13.VariableDeclaration, statement: ts13.VariableStatement, ctx: SerializerContext): SpecExport14 | null;
+import { SpecSignatureParameter } from "@openpkg-ts/spec";
+import ts14 from "typescript";
+declare function extractParameters(signature: ts14.Signature, ctx: SerializerContext): SpecSignatureParameter[];
 /**
 * Recursively register types referenced by a ts.Type.
 * Uses ctx.visitedTypes to prevent infinite recursion on circular types.
 */
-declare function registerReferencedTypes(type: ts12.Type, ctx: SerializerContext, depth?: number): void;
+declare function registerReferencedTypes(type: ts14.Type, ctx: SerializerContext, depth?: number): void;
 import { SpecSchema as SpecSchema2 } from "@openpkg-ts/spec";
-import ts13 from "typescript";
+import ts15 from "typescript";
 /**
 * Built-in type schemas with JSON Schema format hints.
 * Used for types that have specific serialization formats.
@@ -1503,7 +1643,7 @@ declare function isPrimitiveName(name: string): boolean;
 * getTypeOrigin(trpcRouterType) // Returns '@trpc/server'
 * getTypeOrigin(localUserType) // Returns undefined
 */
-declare function getTypeOrigin(type: ts13.Type, _checker: ts13.TypeChecker): string | undefined;
+declare function getTypeOrigin(type: ts15.Type, _checker: ts15.TypeChecker): string | undefined;
 /**
 * Check if a name is a built-in generic type
 */
@@ -1511,18 +1651,18 @@ declare function isBuiltinGeneric(name: string): boolean;
 /**
 * Check if a type is anonymous (no meaningful symbol name)
 */
-declare function isAnonymous(type: ts13.Type): boolean;
+declare function isAnonymous(type: ts15.Type): boolean;
 /**
 * Ensure schema is non-empty — fallback to x-ts-type string representation if empty.
 * Never emit {} as a schema; always include meaningful type info.
 */
-declare function ensureNonEmptySchema(schema: SpecSchema2, type: ts13.Type, checker: ts13.TypeChecker): SpecSchema2;
+declare function ensureNonEmptySchema(schema: SpecSchema2, type: ts15.Type, checker: ts15.TypeChecker): SpecSchema2;
 /**
 * Build a structured SpecSchema from a TypeScript type.
 * Uses $ref for named types and typeArguments for generics.
 * Guarantees non-empty schema output via ensureNonEmptySchema wrapper.
 */
-declare function buildSchema(type: ts13.Type, checker: ts13.TypeChecker, ctx?: SerializerContext, _depth?: number): SpecSchema2;
+declare function buildSchema(type: ts15.Type, checker: ts15.TypeChecker, ctx?: SerializerContext, _depth?: number): SpecSchema2;
 /**
 * Check if a schema is a pure $ref (only has $ref property)
 */
@@ -1550,8 +1690,8 @@ declare function deduplicateSchemas(schemas: SpecSchema2[]): SpecSchema2[];
 * Find a discriminator property in a union of object types (tagged union pattern).
 * A valid discriminator has a unique literal value in each union member.
 */
-declare function findDiscriminatorProperty(unionTypes: ts13.Type[], checker: ts13.TypeChecker): string | undefined;
-import { SpecExport as SpecExport14, SpecMember as SpecMember3, SpecSchema as SpecSchema3, SpecType as SpecType5 } from "@openpkg-ts/spec";
+declare function findDiscriminatorProperty(unionTypes: ts15.Type[], checker: ts15.TypeChecker): string | undefined;
+import { SpecExport as SpecExport15, SpecMember as SpecMember3, SpecSchema as SpecSchema3, SpecType as SpecType6 } from "@openpkg-ts/spec";
 /**
 * Options for schema normalization
 */
@@ -1582,7 +1722,7 @@ declare function normalizeSchema(schema: SpecSchema3, options?: NormalizeOptions
 * 2. Normalize member schemas
 * 3. Generate a JSON Schema from members if members exist (populates `schema` field)
 */
-declare function normalizeExport(exp: SpecExport14, options?: NormalizeOptions): SpecExport14;
+declare function normalizeExport(exp: SpecExport15, options?: NormalizeOptions): SpecExport15;
 /**
 * Normalize a SpecType, normalizing its schema and nested schemas.
 *
@@ -1591,7 +1731,7 @@ declare function normalizeExport(exp: SpecExport14, options?: NormalizeOptions):
 * 2. Normalize member schemas
 * 3. Generate a JSON Schema from members if members exist (populates `schema` field)
 */
-declare function normalizeType(type: SpecType5, options?: NormalizeOptions): SpecType5;
+declare function normalizeType(type: SpecType6, options?: NormalizeOptions): SpecType6;
 /**
 * Convert a members array to JSON Schema properties format.
 *
@@ -1613,7 +1753,7 @@ declare function normalizeType(type: SpecType5, options?: NormalizeOptions): Spe
 * @returns JSON Schema object with properties, required, and additionalProperties
 */
 declare function normalizeMembers(members: SpecMember3[], options?: NormalizeOptions): JSONSchema;
-import ts14 from "typescript";
-declare function isExported(node: ts14.Node): boolean;
-declare function getNodeName(node: ts14.Node): string | undefined;
-export { zodAdapter, withDescription2 as withDescription, valibotAdapter, typeboxAdapter, toSearchIndexJSON, toSearchIndex2 as toSearchIndex, toReactString, toReact, toPagefindRecords2 as toPagefindRecords, toNavigation2 as toNavigation, toMarkdown2 as toMarkdown, toJSONString, toJSON2 as toJSON, toHTML2 as toHTML, toFumadocsMetaJSON, toDocusaurusSidebarJS, toAlgoliaRecords2 as toAlgoliaRecords, sortByName, serializeVariable, serializeTypeAlias, serializeInterface, serializeFunctionExport, serializeEnum, serializeClass, schemasAreEqual, schemaIsAny, resolveTypeRef, resolveExportTarget, resolveCompiledPath, registerReferencedTypes, registerAdapter, recommendSemverBump, query, normalizeType, normalizeSchema, normalizeMembers, normalizeExport, mergeConfig, loadSpec, loadConfig, listExports, isTypeReference, isTypeOnlyExport, isSymbolDeprecated, isStandardJSONSchema, isSchemaType, isPureRefSchema, isProperty, isPrimitiveName, isMethod, isExported, isBuiltinGeneric, isAnonymous, hasDeprecatedTag, groupByVisibility, getTypeOrigin, getSourceLocation, getProperties, getParamDescription, getNonNullableType, getNodeName, getMethods, getMemberBadges, getJSDocComment, getExport2 as getExport, getDeprecationMessage, toMarkdown2 as generateDocs, formatTypeParameters, formatSchema, formatReturnType, formatParameters, formatMappedType, formatConditionalType, formatBadges, findMissingParamDocs, findDiscriminatorProperty, findAdapter, filterSpec, extractTypeParameters, extractStandardSchemasFromTs, extractStandardSchemasFromProject, extractStandardSchemas, extractSpec, extractSchemaType, extractParameters, extract, exportToMarkdown, ensureNonEmptySchema, diffSpec2 as diffSpecs, diffSpec, detectTsRuntime, deduplicateSchemas, createProgram, createDocs, categorizeBreakingChanges, calculateNextVersion, buildSignatureString, buildSchema, arktypeAdapter, analyzeSpec, TypeRegistry, TypeReference2 as TypeReference, TsRuntime, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, StandardJSONSchemaTarget, StandardJSONSchemaOptions, SpecMappedType, SpecDiff, SpecDiagnostics, SpecConditionalType, SkippedExportDetail, SimplifiedSpec, SimplifiedSignature, SimplifiedReturn, SimplifiedParameter, SimplifiedMember, SimplifiedExport, SimplifiedExample, SerializerContext, SemverRecommendation, SemverBump, SearchRecord, SearchOptions, SearchIndex, SchemaExtractionResult, SchemaAdapter, ReactLayoutOptions, QueryBuilder, ProjectExtractionOutput, ProjectExtractionInfo, ProgramResult, ProgramOptions, PagefindRecord, OpenpkgConfig, NormalizeOptions, NavOptions, NavItem, NavGroup, NavFormat, MemberChangeInfo, MarkdownOptions, LoadOptions, ListExportsResult, ListExportsOptions, JSONSchema, JSONOptions, HTMLOptions, GroupBy, GetExportResult, GetExportOptions, GenericNav, FumadocsMetaItem, FumadocsMeta, FormatSchemaOptions, ForgottenExport, FilterResult, FilterCriteria, ExtractStandardSchemasOptions, ExtractResult, ExtractOptions, ExtractFromProjectOptions, ExternalsConfig, ExportVerification, ExportTracker, ExportMarkdownOptions, ExportItem, DocusaurusSidebarItem, DocusaurusSidebar, DocsInstance, DiagnosticItem, Diagnostic, CategorizedBreaking, CONFIG_FILENAME, BreakingSeverity, BUILTIN_TYPE_SCHEMAS, AlgoliaRecord, ARRAY_PROTOTYPE_METHODS };
+import ts16 from "typescript";
+declare function isExported(node: ts16.Node): boolean;
+declare function getNodeName(node: ts16.Node): string | undefined;
+export { zodAdapter, withDescription2 as withDescription, valibotAdapter, typeboxAdapter, toSearchIndexJSON, toSearchIndex2 as toSearchIndex, toReactString, toReact, toPagefindRecords2 as toPagefindRecords, toNavigation2 as toNavigation, toMarkdown2 as toMarkdown, toJSONString, toJSON2 as toJSON, toHTML2 as toHTML, toFumadocsMetaJSON, toDocusaurusSidebarJS, toAlgoliaRecords2 as toAlgoliaRecords, sortByName, serializeVariable, serializeTypeAlias, serializeInterface, serializeFunctionExport, serializeEnum, serializeClass, schemasAreEqual, schemaIsAny, resolveTypeRef, resolveExportTarget, resolveCompiledPath, registerReferencedTypes, registerAdapter, recommendSemverBump, query, normalizeType, normalizeSchema, normalizeMembers, normalizeExport, mergeConfig, loadSpec, loadConfig, listExports, isTypeReference, isTypeOnlyExport, isSymbolDeprecated, isStandardJSONSchema, isSchemaType, isPureRefSchema, isProperty, isPrimitiveName, isMethod, isExported, isBuiltinGeneric, isAnonymous, hasDeprecatedTag, groupByVisibility, getTypeOrigin, getSourceLocation, getProperties, getParamDescription, getNonNullableType, getNodeName, getMethods, getMemberBadges, getJSDocComment, getExport2 as getExport, getDeprecationMessage, toMarkdown2 as generateDocs, formatTypeParameters, formatSchema, formatReturnType, formatParameters, formatMappedType, formatConditionalType, formatBadges, findMissingParamDocs, findDiscriminatorProperty, findAdapter, filterSpec, extractTypeParameters, extractStandardSchemasFromTs, extractStandardSchemasFromProject, extractStandardSchemas, extractSpec, extractSchemaType, extractParameters, extract, exportToMarkdown, ensureNonEmptySchema, diffSpec2 as diffSpecs, diffSpec, detectTsRuntime, deduplicateSchemas, createProgram, createDocs, categorizeBreakingChanges, calculateNextVersion, buildSignatureString, buildSchema, arktypeAdapter, analyzeSpec, TypeRegistry, TypeReference2 as TypeReference, TsRuntime, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, StandardJSONSchemaTarget, StandardJSONSchemaOptions, SpecMappedType, SpecDiff, SpecDiagnostics, SpecConditionalType, SkippedExportDetail, SimplifiedSpec, SimplifiedSignature, SimplifiedReturn, SimplifiedParameter, SimplifiedMember, SimplifiedExport, SimplifiedExample, SerializerContext, SemverRecommendation, SemverBump, SearchRecord, SearchOptions, SearchIndex, SchemaExtractionResult, SchemaAdapter, ReactLayoutOptions, QueryBuilder, ProjectExtractionOutput, ProjectExtractionInfo, ProgramResult, ProgramOptions, PagefindRecord, OpenpkgConfig, NormalizeOptions, NavOptions, NavItem, NavGroup, NavFormat, MemberChangeInfo, MarkdownOptions, LoadOptions, ListExportsResult, ListExportsOptions, JSONSchema, JSONOptions, HTMLOptions, GroupBy, GetExportResult, GetExportOptions, GenericNav, FumadocsMetaItem, FumadocsMeta, FormatSchemaOptions, ForgottenExport, FilterResult, FilterCriteria, ExtractionWarningCode, ExtractionWarning, ExtractStandardSchemasOptions, ExtractResult, ExtractOptions, ExtractFromProjectOptions, ExternalsConfig, ExportVerification, ExportTracker, ExportMarkdownOptions, ExportItem, DocusaurusSidebarItem, DocusaurusSidebar, DocsInstance, DiagnosticItem, Diagnostic, CategorizedBreaking, CacheManagerOptions, CacheManager, CONFIG_FILENAME, BreakingSeverity, BUILTIN_TYPE_SCHEMAS, AlgoliaRecord, ARRAY_PROTOTYPE_METHODS };