@openpkg-ts/sdk 0.52.1 → 0.53.0

package/dist/index.d.ts

@@ -43,8 +43,6 @@ interface ExternalsConfig {
 	include?: string[];
 	/** Package patterns to never resolve */
 	exclude?: string[];
-	/** Max transitive depth for resolution (default: 1) */
-	depth?: number;
 }
 interface ExtractOptions {
 	entryFile: string;
@@ -53,8 +51,6 @@ interface ExtractOptions {
 	baseDir?: string;
 	content?: string;
 	maxTypeDepth?: number;
-	maxExternalTypeDepth?: number;
-	resolveExternalTypes?: boolean;
 	schemaExtraction?: "static" | "hybrid";
 	/** Include $schema URL in output */
 	includeSchema?: boolean;
@@ -117,15 +113,6 @@ interface ExtractResult {
 		/** Extraction method used: 'compiled' or 'direct-ts (runtime)' */
 		method?: string;
 	};
-	/** Degraded mode info when extracting from .d.ts files */
-	degradedMode?: {
-		reason: "dts-source";
-		stats: {
-			exportsWithoutDescription: number;
-			paramsWithoutDocs: number;
-			missingExamples: number;
-		};
-	};
 	/** Export verification comparing discovered vs extracted */
 	verification?: ExportVerification;
 }
@@ -231,41 +218,6 @@ declare function loadConfig(cwd: string): OpenpkgConfig | null;
 * @returns Merged config
 */
 declare function mergeConfig(fileConfig: OpenpkgConfig | null, cliOptions: Partial<OpenpkgConfig>): OpenpkgConfig;
-import { OpenPkg as OpenPkg2, SpecExport } from "@openpkg-ts/spec";
-interface DiagnosticItem {
-	exportId: string;
-	exportName: string;
-	issue: string;
-	/** Member name if issue is on a member */
-	member?: string;
-	/** Parameter name if issue is on a parameter */
-	param?: string;
-}
-interface SpecDiagnostics {
-	/** Exports/members without descriptions */
-	missingDescriptions: DiagnosticItem[];
-	/** Exports marked @deprecated but no reason provided */
-	deprecatedNoReason: DiagnosticItem[];
-	/** Function params without descriptions in JSDoc */
-	missingParamDocs: DiagnosticItem[];
-}
-/**
-* Check if has @deprecated tag.
-*/
-declare function hasDeprecatedTag(exp: SpecExport): boolean;
-/**
-* Get deprecation message from @deprecated tag.
-* Returns undefined if no reason provided.
-*/
-declare function getDeprecationMessage(exp: SpecExport): string | undefined;
-/**
-* Find params without descriptions in JSDoc.
-*/
-declare function findMissingParamDocs(exp: SpecExport): string[];
-/**
-* Analyze a spec for quality issues.
-*/
-declare function analyzeSpec(spec: OpenPkg2): SpecDiagnostics;
 import { SpecMember } from "@openpkg-ts/spec";
 /**
 * Extract badge strings from a member's visibility and flags.
@@ -276,8 +228,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 OpenPkg8, SpecExport as SpecExport3, SpecExportKind as SpecExportKind4, SpecType } from "@openpkg-ts/spec";
-import { OpenPkg as OpenPkg3 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg7, SpecExport as SpecExport2, SpecExportKind as SpecExportKind4, SpecType } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg2 } from "@openpkg-ts/spec";
 interface HTMLOptions {
 	/** Page title override */
 	title?: string;
@@ -318,8 +270,8 @@ interface HTMLOptions {
 * const fragment = docs.toHTML({ export: 'greet', fullDocument: false })
 * ```
 */
-declare function toHTML2(spec: OpenPkg3, options?: HTMLOptions): string;
-import { OpenPkg as OpenPkg4, SpecExportKind, SpecInlineTag } from "@openpkg-ts/spec";
+declare function toHTML2(spec: OpenPkg2, options?: HTMLOptions): string;
+import { OpenPkg as OpenPkg3, SpecExportKind, SpecInlineTag } from "@openpkg-ts/spec";
 interface JSONOptions {
 	/** Include raw spec data alongside simplified data */
 	includeRaw?: boolean;
@@ -414,7 +366,7 @@ interface SimplifiedSpec {
 * // { id, name, kind, signature, parameters, returns, ... }
 * ```
 */
-declare function toJSON2(spec: OpenPkg4, options?: JSONOptions): SimplifiedSpec | SimplifiedExport;
+declare function toJSON2(spec: OpenPkg3, options?: JSONOptions): SimplifiedSpec | SimplifiedExport;
 /**
 * Serialize to JSON string with formatting.
 *
@@ -422,10 +374,10 @@ declare function toJSON2(spec: OpenPkg4, options?: JSONOptions): SimplifiedSpec
 * @param options - JSON options plus pretty formatting option
 * @returns JSON string
 */
-declare function toJSONString(spec: OpenPkg4, options?: JSONOptions & {
+declare function toJSONString(spec: OpenPkg3, options?: JSONOptions & {
 	pretty?: boolean;
 }): string;
-import { OpenPkg as OpenPkg5, SpecExport as SpecExport2 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg4, SpecExport } from "@openpkg-ts/spec";
 interface MarkdownOptions {
 	/** Include frontmatter in output */
 	frontmatter?: boolean;
@@ -471,7 +423,7 @@ interface ExportMarkdownOptions extends MarkdownOptions {
 * })
 * ```
 */
-declare function exportToMarkdown(exp: SpecExport2, options?: MarkdownOptions): string;
+declare function exportToMarkdown(exp: SpecExport, options?: MarkdownOptions): string;
 /**
 * Render entire spec to MDX.
 *
@@ -494,8 +446,8 @@ declare function exportToMarkdown(exp: SpecExport2, options?: MarkdownOptions):
 * // Single * const fnMdx = docs.toMarkdown({ export: 'greet' })
 * ```
 */
-declare function toMarkdown2(spec: OpenPkg5, options?: ExportMarkdownOptions): string;
-import { OpenPkg as OpenPkg6, SpecExportKind as SpecExportKind2 } from "@openpkg-ts/spec";
+declare function toMarkdown2(spec: OpenPkg4, options?: ExportMarkdownOptions): string;
+import { OpenPkg as OpenPkg5, SpecExportKind as SpecExportKind2 } from "@openpkg-ts/spec";
 type NavFormat = "fumadocs" | "docusaurus" | "generic";
 type GroupBy = "kind" | "module" | "tag" | "none";
 interface NavOptions {
@@ -570,7 +522,7 @@ type DocusaurusSidebar = DocusaurusSidebarItem[];
 * const sidebar = docs.toNavigation({ format: 'docusaurus' })
 * ```
 */
-declare function toNavigation2(spec: OpenPkg6, options?: NavOptions): GenericNav | FumadocsMeta | DocusaurusSidebar;
+declare function toNavigation2(spec: OpenPkg5, options?: NavOptions): GenericNav | FumadocsMeta | DocusaurusSidebar;
 /**
 * Generate Fumadocs meta.json file content.
 *
@@ -586,7 +538,7 @@ declare function toNavigation2(spec: OpenPkg6, options?: NavOptions): GenericNav
 * fs.writeFileSync('docs/api/meta.json', meta)
 * ```
 */
-declare function toFumadocsMetaJSON(spec: OpenPkg6, options?: Omit<NavOptions, "format">): string;
+declare function toFumadocsMetaJSON(spec: OpenPkg5, options?: Omit<NavOptions, "format">): string;
 /**
 * Generate Docusaurus sidebar config.
 *
@@ -602,8 +554,8 @@ declare function toFumadocsMetaJSON(spec: OpenPkg6, options?: Omit<NavOptions, "
 * fs.writeFileSync('sidebars.js', sidebar)
 * ```
 */
-declare function toDocusaurusSidebarJS(spec: OpenPkg6, options?: Omit<NavOptions, "format">): string;
-import { OpenPkg as OpenPkg7, SpecExportKind as SpecExportKind3 } from "@openpkg-ts/spec";
+declare function toDocusaurusSidebarJS(spec: OpenPkg5, options?: Omit<NavOptions, "format">): string;
+import { OpenPkg as OpenPkg6, SpecExportKind as SpecExportKind3 } from "@openpkg-ts/spec";
 interface SearchOptions {
 	/** Base URL for search result links */
 	baseUrl?: string;
@@ -696,7 +648,7 @@ interface SearchIndex {
 * // { records: [...], version: '1.0.0', packageName: 'my-lib' }
 * ```
 */
-declare function toSearchIndex2(spec: OpenPkg7, options?: SearchOptions): SearchIndex;
+declare function toSearchIndex2(spec: OpenPkg6, options?: SearchOptions): SearchIndex;
 /**
 * Generate Pagefind-compatible records.
 *
@@ -712,7 +664,7 @@ declare function toSearchIndex2(spec: OpenPkg7, options?: SearchOptions): Search
 * })
 * ```
 */
-declare function toPagefindRecords2(spec: OpenPkg7, options?: SearchOptions): PagefindRecord[];
+declare function toPagefindRecords2(spec: OpenPkg6, options?: SearchOptions): PagefindRecord[];
 /**
 * Generate Algolia-compatible records.
 *
@@ -726,7 +678,7 @@ declare function toPagefindRecords2(spec: OpenPkg7, options?: SearchOptions): Pa
 * // Upload to Algolia index
 * ```
 */
-declare function toAlgoliaRecords2(spec: OpenPkg7, options?: SearchOptions): AlgoliaRecord[];
+declare function toAlgoliaRecords2(spec: OpenPkg6, options?: SearchOptions): AlgoliaRecord[];
 /**
 * Serialize search index to JSON string.
 *
@@ -740,36 +692,36 @@ declare function toAlgoliaRecords2(spec: OpenPkg7, options?: SearchOptions): Alg
 * fs.writeFileSync('search-index.json', json)
 * ```
 */
-declare function toSearchIndexJSON(spec: OpenPkg7, options?: SearchOptions & {
+declare function toSearchIndexJSON(spec: OpenPkg6, options?: SearchOptions & {
 	pretty?: boolean;
 }): string;
 interface LoadOptions {
 	/** Path to openpkg.json file or the spec object directly */
-	input: string | OpenPkg8;
+	input: string | OpenPkg7;
 }
 interface DocsInstance {
 	/** The parsed OpenPkg spec */
-	spec: OpenPkg8;
+	spec: OpenPkg7;
 	/** Get an by its ID */
-	getExport(id: string): SpecExport3 | undefined;
+	getExport(id: string): SpecExport2 | undefined;
 	/** Get a type definition by its ID */
 	getType(id: string): SpecType | undefined;
 	/** Get all exports of a specific kind */
-	getExportsByKind(kind: SpecExportKind4): SpecExport3[];
+	getExportsByKind(kind: SpecExportKind4): SpecExport2[];
 	/** Get all exports */
-	getAllExports(): SpecExport3[];
+	getAllExports(): SpecExport2[];
 	/** Get all type definitions */
 	getAllTypes(): SpecType[];
 	/** Get exports by JSDoc tag (e.g., '@beta', '@internal') */
-	getExportsByTag(tagName: string): SpecExport3[];
+	getExportsByTag(tagName: string): SpecExport2[];
 	/** Search exports by name or description */
-	search(query: string): SpecExport3[];
+	search(query: string): SpecExport2[];
 	/** Get exports belonging to a specific module/namespace */
-	getModule(moduleName: string): SpecExport3[];
+	getModule(moduleName: string): SpecExport2[];
 	/** Get deprecated exports */
-	getDeprecated(): SpecExport3[];
+	getDeprecated(): SpecExport2[];
 	/** Get exports grouped by kind */
-	groupByKind(): Record<SpecExportKind4, SpecExport3[]>;
+	groupByKind(): Record<SpecExportKind4, SpecExport2[]>;
 	/** Render spec or single to an MDX string */
 	toMarkdown(options?: ExportMarkdownOptions): string;
 	/** Render spec or single to an HTML string */
@@ -797,7 +749,7 @@ interface DocsInstance {
 * const docs = loadSpec(spec)
 * ```
 */
-declare function loadSpec(spec: OpenPkg8): DocsInstance;
+declare function loadSpec(spec: OpenPkg7): DocsInstance;
 /**
 * Creates a docs instance for querying and rendering API documentation.
 *
@@ -822,8 +774,8 @@ declare function loadSpec(spec: OpenPkg8): DocsInstance;
 * docs.search('hook')
 * ```
 */
-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";
+declare function createDocs(input: string | OpenPkg7): DocsInstance;
+import { OpenPkg as OpenPkg8, SpecExport as SpecExport3, SpecMember as SpecMember2, SpecSchema, SpecSignature, SpecType as SpecType2, SpecTypeParameter } from "@openpkg-ts/spec";
 interface FormatSchemaOptions {
 	/** Include package attribution for external types */
 	includePackage?: boolean;
@@ -908,7 +860,7 @@ declare function formatReturnType(sig?: SpecSignature): string;
 * // 'class Logger extends EventEmitter'
 * ```
 */
-declare function buildSignatureString(exp: SpecExport4, sigIndex?: number): string;
+declare function buildSignatureString(exp: SpecExport3, sigIndex?: number): string;
 /**
 * Resolve a type reference to its definition.
 *
@@ -922,7 +874,7 @@ declare function buildSignatureString(exp: SpecExport4, sigIndex?: number): stri
 * // { id: 'User', name: 'User', kind: 'interface', ... }
 * ```
 */
-declare function resolveTypeRef(ref: string, spec: OpenPkg9): SpecType2 | undefined;
+declare function resolveTypeRef(ref: string, spec: OpenPkg8): SpecType2 | undefined;
 /**
 * Check if a member is a method (has signatures).
 *
@@ -1037,8 +989,8 @@ declare function formatConditionalType(condType: SpecConditionalType): string;
 * ```
 */
 declare function formatMappedType(mappedType: SpecMappedType): string;
-import { OpenPkg as OpenPkg10, SpecExport as SpecExport5, SpecExportKind as SpecExportKind6 } from "@openpkg-ts/spec";
-type Predicate = (exp: SpecExport5) => boolean;
+import { OpenPkg as OpenPkg9, SpecExport as SpecExport4, SpecExportKind as SpecExportKind6 } from "@openpkg-ts/spec";
+type Predicate = (exp: SpecExport4) => boolean;
 /**
 * Chainable query builder for filtering OpenPkg exports.
 * Filters are lazy - predicates only run on execution methods (find, first, count, etc).
@@ -1046,7 +998,7 @@ type Predicate = (exp: SpecExport5) => boolean;
 declare class QueryBuilder {
 	private spec;
 	private predicates;
-	constructor(spec: OpenPkg10);
+	constructor(spec: OpenPkg9);
 	/**
 	* Filter by kind(s)
 	*/
@@ -1084,11 +1036,11 @@ declare class QueryBuilder {
 	/**
 	* Execute query and return matching exports
 	*/
-	find(): SpecExport5[];
+	find(): SpecExport4[];
 	/**
 	* Execute query and return first match (or undefined)
 	*/
-	first(): SpecExport5 | undefined;
+	first(): SpecExport4 | undefined;
 	/**
 	* Execute query and return count of matches
 	*/
@@ -1100,12 +1052,12 @@ declare class QueryBuilder {
 	/**
 	* Execute query and return a new filtered OpenPkg spec
 	*/
-	toSpec(): OpenPkg10;
+	toSpec(): OpenPkg9;
 }
 /**
 * Create a query builder for the given spec
 */
-declare function query(spec: OpenPkg10): QueryBuilder;
+declare function query(spec: OpenPkg9): QueryBuilder;
 import { EntryPointDetectionMethod as EntryPointDetectionMethod2 } from "@openpkg-ts/spec";
 type PackageRecord = {
 	name: string;
@@ -1149,10 +1101,6 @@ type ResolveEmpty = {
 	kind: "empty";
 	reason: string;
 };
-type ResolveRemote = {
-	kind: "remote";
-	input: string;
-};
 type ResolveExplicit = {
 	kind: "explicit";
 	entryFile: string;
@@ -1162,9 +1110,14 @@ type ResolveUnavailable = {
 	kind: "unavailable";
 	reason: string;
 };
-type ResolveTargetResult = ResolveOk | ResolveAmbiguous | ResolveNeedsBuild | ResolveEmpty | ResolveRemote | ResolveExplicit | ResolveUnavailable;
+type ResolveTargetResult = (ResolveOk | ResolveAmbiguous | ResolveNeedsBuild | ResolveEmpty | ResolveExplicit | ResolveUnavailable) & {
+	/** Present when this resolution owns a temp clone. Call after extraction. */
+	cleanup?: () => void;
+};
 declare function isRemoteInput(input: string): boolean;
 declare function isEntryFilePath(input: string): boolean;
+/** Absolute, explicit relative, slash-containing, or entry-file paths — not bare intent words. */
+declare function isPathLikeInput(input: string): boolean;
 declare function parseGithubRepo(input: string): {
 	owner: string;
 	repo: string;
@@ -1177,7 +1130,7 @@ declare function pickEntry(pkgDir: string): {
 	entryPointSource: EntryPointDetectionMethod2;
 } | null;
 declare function resolveTarget(options?: ResolveTargetOptions): Promise<ResolveTargetResult>;
-import { OpenPkg as OpenPkg11, SpecExportKind as SpecExportKind7 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg10, SpecExportKind as SpecExportKind7 } from "@openpkg-ts/spec";
 type FilterCriteria = {
 	/** Filter by kinds */
 	kinds?: SpecExportKind7[];
@@ -1202,7 +1155,7 @@ type FilterCriteria = {
 };
 type FilterResult = {
 	/** New spec with only matched exports (immutable) */
-	spec: OpenPkg11;
+	spec: OpenPkg10;
 	/** Number of exports that matched */
 	matched: number;
 	/** Total number of exports in original spec */
@@ -1218,8 +1171,8 @@ type FilterResult = {
 * @param criteria - Filter criteria (empty criteria matches all)
 * @returns FilterResult with new spec, matched count, total count
 */
-declare function filterSpec(spec: OpenPkg11, criteria: FilterCriteria): FilterResult;
-import { SpecExport as SpecExport6, SpecType as SpecType3 } from "@openpkg-ts/spec";
+declare function filterSpec(spec: OpenPkg10, criteria: FilterCriteria): FilterResult;
+import { SpecExport as SpecExport5, SpecType as SpecType3 } from "@openpkg-ts/spec";
 interface GetExportOptions {
 	/** Entry point file path */
 	entryFile: string;
@@ -1234,7 +1187,7 @@ interface GetExportOptions {
 }
 interface GetExportResult {
 	/** The spec, or null if not found */
-	export: SpecExport6 | null;
+	export: SpecExport5 | null;
 	/** Related types referenced by the */
 	types: SpecType3[];
 	/** Errors encountered */
@@ -1299,9 +1252,7 @@ interface SerializerContext {
 	program: ts.Program;
 	sourceFile: ts.SourceFile;
 	maxTypeDepth: number;
-	maxExternalTypeDepth: number;
 	currentDepth: number;
-	resolveExternalTypes: boolean;
 	typeRegistry: TypeRegistry;
 	exportedIds: Set<string>;
 	/** Stack-style recursion guard for buildSchemaInternal (add before recurse, delete after) */
@@ -1679,7 +1630,7 @@ declare class CacheManager<
 * @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.isDtsSource - Set true when extracting from .d.ts (declaration-only generation metadata)
 * @param options.externals - Config for resolving re-exports from external packages
 *
 * @returns Promise resolving to extraction result
@@ -1775,7 +1726,7 @@ declare const arktypeAdapter: SchemaAdapter;
 declare const typeboxAdapter: SchemaAdapter;
 declare const valibotAdapter: SchemaAdapter;
 declare const zodAdapter: SchemaAdapter;
-import { OpenPkg as OpenPkg12, SpecExport as SpecExport9, SpecType as SpecType6 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg11, SpecExport as SpecExport8, SpecType as SpecType6 } from "@openpkg-ts/spec";
 interface AsStandardSchemaOptions {
 	keepExtensions?: boolean;
 }
@@ -1783,7 +1734,7 @@ interface AsStandardSchemaOptions {
 * Wrap an export, type, or named subject as a StandardJSONSchemaV1 producer.
 * A string subject is resolved against the spec (exports first, then types).
 */
-declare function asStandardSchema(subject: SpecExport9 | SpecType6 | string, spec: OpenPkg12, options?: AsStandardSchemaOptions): StandardJSONSchemaV1;
+declare function asStandardSchema(subject: SpecExport8 | SpecType6 | string, spec: OpenPkg11, options?: AsStandardSchemaOptions): StandardJSONSchemaV1;
 import { SpecSchema as SpecSchema2 } from "@openpkg-ts/spec";
 /** Object-shaped SpecSchema (excludes the string shorthand) — spreadable. */
 type BuiltinSchema = Extract<SpecSchema2, object>;
@@ -1793,8 +1744,8 @@ type BuiltinSchema = Extract<SpecSchema2, object>;
 * in a spec's types[]) and by adapters mapping refs for external consumers.
 */
 declare const BUILTIN_TYPE_SCHEMAS: Record<string, BuiltinSchema>;
-import { OpenPkg as OpenPkg13, SpecExport as SpecExport11, SpecType as SpecType8 } from "@openpkg-ts/spec";
-import { SpecExport as SpecExport10, SpecMember as SpecMember3, SpecSchema as SpecSchema3, SpecType as SpecType7 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg12, SpecExport as SpecExport10, SpecType as SpecType8 } from "@openpkg-ts/spec";
+import { SpecExport as SpecExport9, SpecMember as SpecMember3, SpecSchema as SpecSchema3, SpecType as SpecType7 } from "@openpkg-ts/spec";
 /**
 * Options for schema normalization
 */
@@ -1815,7 +1766,7 @@ type JSONSchema = Record<string, unknown>;
 * @returns JSON Schema 2020-12 compatible schema
 */
 declare function normalizeSchema(schema: SpecSchema3, options?: NormalizeOptions): JSONSchema;
-declare function normalizeExport(exp: SpecExport10, options?: NormalizeOptions): SpecExport10;
+declare function normalizeExport(exp: SpecExport9, options?: NormalizeOptions): SpecExport9;
 /**
 * Normalize a SpecType, normalizing its schema and nested schemas.
 *
@@ -1862,13 +1813,13 @@ interface JsonSchemaDocument extends Record<string, unknown> {
 * Root a JSON Schema document at a single or type, bundling only its
 * transitively-referenced types into `$defs`.
 */
-declare function exportToJsonSchema(subject: SpecExport11 | SpecType8, spec: OpenPkg13, options?: Omit<ToJsonSchemaOptions, "root">): JsonSchemaDocument;
+declare function exportToJsonSchema(subject: SpecExport10 | SpecType8, spec: OpenPkg12, options?: Omit<ToJsonSchemaOptions, "root">): JsonSchemaDocument;
 /**
 * Lift a whole spec (or, with `root`, a single named export/type) into a
 * standalone JSON Schema 2020-12 document.
 */
-declare function toJsonSchema(spec: OpenPkg13, options?: ToJsonSchemaOptions): JsonSchemaDocument;
-import { OpenPkg as OpenPkg14, SpecSchema as SpecSchema4 } from "@openpkg-ts/spec";
+declare function toJsonSchema(spec: OpenPkg12, options?: ToJsonSchemaOptions): JsonSchemaDocument;
+import { OpenPkg as OpenPkg13, SpecSchema as SpecSchema4 } from "@openpkg-ts/spec";
 /** Strip TypeScript-specific extension keywords from a schema tree (deep). */
 declare function stripTsExtensions(schema: JSONSchema): JSONSchema;
 interface BundleOptions {
@@ -1894,8 +1845,8 @@ interface BundleResult {
 * `x-ts-type` marker (type parameters), or a `#/$defs/<key>` ref whose target
 * is collected (transitively, cycle-safe) into `defs`.
 */
-declare function bundleRefs(root: SpecSchema4, spec: OpenPkg14, options?: BundleOptions): BundleResult;
-import { OpenPkg as OpenPkg15, SpecExport as SpecExport12 } from "@openpkg-ts/spec";
+declare function bundleRefs(root: SpecSchema4, spec: OpenPkg13, options?: BundleOptions): BundleResult;
+import { OpenPkg as OpenPkg14, SpecExport as SpecExport11 } from "@openpkg-ts/spec";
 type ToolSchemaProvider = "openai-strict" | "anthropic";
 interface ToToolSchemaOptions {
 	provider: ToolSchemaProvider;
@@ -1915,25 +1866,25 @@ interface ToolSchemaResult {
 * Build an AI tool-use parameter schema for a function export.
 * Throws for non-function exports (class/variable support is out of scope in v1).
 */
-declare function toToolSchema(exp: SpecExport12, spec: OpenPkg15, options: ToToolSchemaOptions): ToolSchemaResult;
-import { SpecExport as SpecExport13 } from "@openpkg-ts/spec";
+declare function toToolSchema(exp: SpecExport11, spec: OpenPkg14, options: ToToolSchemaOptions): ToolSchemaResult;
+import { SpecExport as SpecExport12 } from "@openpkg-ts/spec";
 import ts9 from "typescript";
-declare function serializeClass(node: ts9.ClassDeclaration, ctx: SerializerContext): SpecExport13 | null;
-import { SpecExport as SpecExport14 } from "@openpkg-ts/spec";
+declare function serializeClass(node: ts9.ClassDeclaration, ctx: SerializerContext): SpecExport12 | null;
+import { SpecExport as SpecExport13 } from "@openpkg-ts/spec";
 import ts10 from "typescript";
-declare function serializeEnum(node: ts10.EnumDeclaration, ctx: SerializerContext): SpecExport14 | null;
-import { SpecExport as SpecExport15 } from "@openpkg-ts/spec";
+declare function serializeEnum(node: ts10.EnumDeclaration, ctx: SerializerContext): SpecExport13 | null;
+import { SpecExport as SpecExport14 } from "@openpkg-ts/spec";
 import ts11 from "typescript";
-declare function serializeFunctionExport(node: ts11.FunctionDeclaration | ts11.ArrowFunction | ts11.FunctionExpression, ctx: SerializerContext, nameOverride?: string): SpecExport15 | null;
-import { SpecExport as SpecExport16 } from "@openpkg-ts/spec";
+declare function serializeFunctionExport(node: ts11.FunctionDeclaration | ts11.ArrowFunction | ts11.FunctionExpression, ctx: SerializerContext, nameOverride?: string): SpecExport14 | null;
+import { SpecExport as SpecExport15 } from "@openpkg-ts/spec";
 import ts12 from "typescript";
-declare function serializeInterface(node: ts12.InterfaceDeclaration, ctx: SerializerContext): SpecExport16 | null;
-import { SpecExport as SpecExport17 } from "@openpkg-ts/spec";
+declare function serializeInterface(node: ts12.InterfaceDeclaration, ctx: SerializerContext): SpecExport15 | null;
+import { SpecExport as SpecExport16 } from "@openpkg-ts/spec";
 import ts13 from "typescript";
-declare function serializeTypeAlias(node: ts13.TypeAliasDeclaration, ctx: SerializerContext): SpecExport17 | null;
-import { SpecExport as SpecExport18 } from "@openpkg-ts/spec";
+declare function serializeTypeAlias(node: ts13.TypeAliasDeclaration, ctx: SerializerContext): SpecExport16 | null;
+import { SpecExport as SpecExport17 } from "@openpkg-ts/spec";
 import ts14 from "typescript";
-declare function serializeVariable(node: ts14.VariableDeclaration, statement: ts14.VariableStatement, ctx: SerializerContext): SpecExport18 | null;
+declare function serializeVariable(node: ts14.VariableDeclaration, statement: ts14.VariableStatement, ctx: SerializerContext): SpecExport17 | null;
 import { SpecSignatureParameter } from "@openpkg-ts/spec";
 import ts15 from "typescript";
 declare function extractParameters(signature: ts15.Signature, ctx: SerializerContext): SpecSignatureParameter[];
@@ -2079,4 +2030,4 @@ declare function findDiscriminatorProperty(unionTypes: ts16.Type[], checker: ts1
 import ts17 from "typescript";
 declare function isExported(node: ts17.Node): boolean;
 declare function getNodeName(node: ts17.Node): string | undefined;
-export { zodAdapter, writtenTypeText, withDescription2 as withDescription, withDeprecated, validateSpec, valibotAdapter, typeboxAdapter, toToolSchema, toSearchIndexJSON, toSearchIndex2 as toSearchIndex, toPagefindRecords2 as toPagefindRecords, toNavigation2 as toNavigation, toMarkdown2 as toMarkdown, toJsonSchema, toJSONString, toJSON2 as toJSON, toHTML2 as toHTML, toFumadocsMetaJSON, toDocusaurusSidebarJS, toAlgoliaRecords2 as toAlgoliaRecords, stripUndefinedFromType, stripTsExtensions, sortByName, shouldEmitAliasTypeText, serializeVariable, serializeTypeAlias, serializeInterface, serializeFunctionExport, serializeEnum, serializeClass, scrubImportQualifiers, schemasAreEqual, schemaIsAny, resolveTypeRef, resolveTarget, resolveExportTarget, resolveCompiledPath, renderTypeText, registerReferencedTypes, registerAdapter, recommendSemverBump, query, pickEntry, parseGithubRepo, normalizeType, normalizeSchema, normalizeMembers, normalizeExport, mergeConfig, loadSpec, loadConfig, listExports, isTypeReference, isTypeOnlyExport, isSymbolDeprecated, isStandardJSONSchema, isSchemaType, isRemoteInput, isReadonlyPropertySymbol, isPureRefSchema, isProperty, isPrimitiveName, isMethod, isExported, isEntryFilePath, isBuiltinSymbol, isBuiltinGeneric, isAnonymous, hasDeprecatedTag, groupByVisibility, getValidationErrors, getTypeOrigin, getSourceLocation, getProperties, getParamDescription, getNonNullableType, getNodeName, getMethods, getMemberBadges, getJSDocComment, getExportKind, getExport2 as getExport, getDeprecationMessage, getAvailableVersions, toMarkdown2 as generateDocs, formatTypeParameters, formatSchema, formatReturnType, formatParameters, formatMappedType, formatConditionalType, formatBadges, findWorkspaceRoot, findMissingParamDocs, findDiscriminatorProperty, findAdapter, filterSpec, extractTypeParameters, extractStandardSchemasFromTs, extractStandardSchemasFromProject, extractStandardSchemas, extractSpec, extractSchemaType, extractParameters, extract, exportToMarkdown, exportToJsonSchema, ensureNonEmptySchema, diffSpec2 as diffSpecs, diffSpec, detectTsRuntime, deduplicateSchemas, decoratePropertySchema, declaredTypeNode, createProgram, createDocs, cloneRemote, categorizeBreakingChanges, catalogPackages, calculateNextVersion, bundleRefs, buildSignatureString, buildSchema, buildObjectSchema, buildFunctionSchema, assertSpec, asStandardSchema, arktypeAdapter, analyzeSpec, TypeRegistry, TypeReference2 as TypeReference, TsRuntime, ToolSchemaResult, ToolSchemaProvider, ToToolSchemaOptions, ToJsonSchemaOptions, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, StandardJSONSchemaTarget, StandardJSONSchemaOptions, SpecMappedType, SpecError, SpecDiff, SpecDiagnostics, SpecConditionalType, SkippedExportDetail, SimplifiedSpec, SimplifiedSignature, SimplifiedReturn, SimplifiedParameter, SimplifiedMember, SimplifiedExport, SimplifiedExample, SerializerContext, SemverRecommendation, SemverBump, SearchRecord, SearchOptions, SearchIndex, SchemaVersion, SchemaExtractionResult, SchemaAdapter, STRING_PROTOTYPE_METHODS, ResolveUnavailable, ResolveTargetResult, ResolveTargetOptions, ResolveRemote, ResolveOk, ResolveNeedsBuild, ResolveExplicit, ResolveEmpty, ResolveAmbiguous, QueryBuilder, ProjectExtractionOutput, ProjectExtractionInfo, ProgramResult, ProgramOptions, PagefindRecord, PackageRecord, PRIMITIVES, OpenpkgConfig, NormalizeOptions, NavOptions, NavItem, NavGroup, NavFormat, NUMBER_PROTOTYPE_METHODS, MemberChangeInfo, MarkdownOptions, LoadOptions, ListExportsResult, ListExportsOptions, LATEST_VERSION, JsonSchemaDocument, JSONSchema, JSONOptions, JEV_MODEL, JEV_CONFIDENCE, HTMLOptions, GroupBy, GetExportResult, GetExportOptions, GenericNav, FumadocsMetaItem, FumadocsMeta, FormatSchemaOptions, ForgottenExport, FilterResult, FilterCriteria, ExtractionWarningCode, ExtractionWarning, ExtractStandardSchemasOptions, ExtractResult, ExtractOptions, ExtractFromProjectOptions, ExternalsConfig, ExportVerification, ExportTracker, ExportMarkdownOptions, ExportItem, EvaluateResult, EvaluateRequest, EvaluateFn, DocusaurusSidebarItem, DocusaurusSidebar, DocsInstance, DiagnosticItem, Diagnostic, CloneFn, CategorizedBreaking, CacheManagerOptions, CacheManager, CONFIG_FILENAME, BundleResult, BundleOptions, BuiltinSchema, BreakingSeverity, BUILTIN_TYPE_SCHEMAS, AsStandardSchemaOptions, AlgoliaRecord, ARRAY_PROTOTYPE_METHODS };
+export { zodAdapter, writtenTypeText, withDescription2 as withDescription, withDeprecated, validateSpec, valibotAdapter, typeboxAdapter, toToolSchema, toSearchIndexJSON, toSearchIndex2 as toSearchIndex, toPagefindRecords2 as toPagefindRecords, toNavigation2 as toNavigation, toMarkdown2 as toMarkdown, toJsonSchema, toJSONString, toJSON2 as toJSON, toHTML2 as toHTML, toFumadocsMetaJSON, toDocusaurusSidebarJS, toAlgoliaRecords2 as toAlgoliaRecords, stripUndefinedFromType, stripTsExtensions, sortByName, shouldEmitAliasTypeText, serializeVariable, serializeTypeAlias, serializeInterface, serializeFunctionExport, serializeEnum, serializeClass, scrubImportQualifiers, schemasAreEqual, schemaIsAny, resolveTypeRef, resolveTarget, resolveExportTarget, resolveCompiledPath, renderTypeText, registerReferencedTypes, registerAdapter, recommendSemverBump, query, pickEntry, parseGithubRepo, normalizeType, normalizeSchema, normalizeMembers, normalizeExport, mergeConfig, loadSpec, loadConfig, listExports, isTypeReference, isTypeOnlyExport, isSymbolDeprecated, isStandardJSONSchema, isSchemaType, isRemoteInput, isReadonlyPropertySymbol, isPureRefSchema, isProperty, isPrimitiveName, isPathLikeInput, isMethod, isExported, isEntryFilePath, isBuiltinSymbol, isBuiltinGeneric, isAnonymous, groupByVisibility, getValidationErrors, getTypeOrigin, getSourceLocation, getProperties, getParamDescription, getNonNullableType, getNodeName, getMethods, getMemberBadges, getJSDocComment, getExportKind, getExport2 as getExport, getAvailableVersions, toMarkdown2 as generateDocs, formatTypeParameters, formatSchema, formatReturnType, formatParameters, formatMappedType, formatConditionalType, formatBadges, findWorkspaceRoot, findDiscriminatorProperty, findAdapter, filterSpec, extractTypeParameters, extractStandardSchemasFromTs, extractStandardSchemasFromProject, extractStandardSchemas, extractSpec, extractSchemaType, extractParameters, extract, exportToMarkdown, exportToJsonSchema, ensureNonEmptySchema, diffSpec2 as diffSpecs, diffSpec, detectTsRuntime, deduplicateSchemas, decoratePropertySchema, declaredTypeNode, createProgram, createDocs, cloneRemote, categorizeBreakingChanges, catalogPackages, calculateNextVersion, bundleRefs, buildSignatureString, buildSchema, buildObjectSchema, buildFunctionSchema, assertSpec, asStandardSchema, arktypeAdapter, TypeRegistry, TypeReference2 as TypeReference, TsRuntime, ToolSchemaResult, ToolSchemaProvider, ToToolSchemaOptions, ToJsonSchemaOptions, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, StandardJSONSchemaTarget, StandardJSONSchemaOptions, SpecMappedType, SpecError, SpecDiff, SpecConditionalType, SkippedExportDetail, SimplifiedSpec, SimplifiedSignature, SimplifiedReturn, SimplifiedParameter, SimplifiedMember, SimplifiedExport, SimplifiedExample, SerializerContext, SemverRecommendation, SemverBump, SearchRecord, SearchOptions, SearchIndex, SchemaVersion, SchemaExtractionResult, SchemaAdapter, STRING_PROTOTYPE_METHODS, ResolveUnavailable, ResolveTargetResult, ResolveTargetOptions, ResolveOk, ResolveNeedsBuild, ResolveExplicit, ResolveEmpty, ResolveAmbiguous, QueryBuilder, ProjectExtractionOutput, ProjectExtractionInfo, ProgramResult, ProgramOptions, PagefindRecord, PackageRecord, PRIMITIVES, OpenpkgConfig, NormalizeOptions, NavOptions, NavItem, NavGroup, NavFormat, NUMBER_PROTOTYPE_METHODS, MemberChangeInfo, MarkdownOptions, LoadOptions, ListExportsResult, ListExportsOptions, LATEST_VERSION, JsonSchemaDocument, JSONSchema, JSONOptions, JEV_MODEL, JEV_CONFIDENCE, HTMLOptions, GroupBy, GetExportResult, GetExportOptions, GenericNav, FumadocsMetaItem, FumadocsMeta, FormatSchemaOptions, ForgottenExport, FilterResult, FilterCriteria, ExtractionWarningCode, ExtractionWarning, ExtractStandardSchemasOptions, ExtractResult, ExtractOptions, ExtractFromProjectOptions, ExternalsConfig, ExportVerification, ExportTracker, ExportMarkdownOptions, ExportItem, EvaluateResult, EvaluateRequest, EvaluateFn, DocusaurusSidebarItem, DocusaurusSidebar, DocsInstance, Diagnostic, CloneFn, CategorizedBreaking, CacheManagerOptions, CacheManager, CONFIG_FILENAME, BundleResult, BundleOptions, BuiltinSchema, BreakingSeverity, BUILTIN_TYPE_SCHEMAS, AsStandardSchemaOptions, AlgoliaRecord, ARRAY_PROTOTYPE_METHODS };