@openpkg-ts/sdk 0.33.0 → 0.34.0

package/dist/browser.js

@@ -0,0 +1,56 @@
+import {
+  QueryBuilder,
+  analyzeSpec,
+  buildSignatureString,
+  findMissingParamDocs,
+  formatBadges,
+  formatConditionalType,
+  formatMappedType,
+  formatParameters,
+  formatReturnType,
+  formatSchema,
+  formatTypeParameters,
+  getDeprecationMessage,
+  getMemberBadges,
+  getMethods,
+  getProperties,
+  groupByVisibility,
+  hasDeprecatedTag,
+  isMethod,
+  isProperty,
+  query,
+  resolveTypeRef,
+  sortByName,
+  toAlgoliaRecords,
+  toPagefindRecords,
+  toSearchIndex,
+  toSearchIndexJSON
+} from "./shared/chunk-91b592v7.js";
+export {
+  toSearchIndexJSON,
+  toSearchIndex,
+  toPagefindRecords,
+  toAlgoliaRecords,
+  sortByName,
+  resolveTypeRef,
+  query,
+  isProperty,
+  isMethod,
+  hasDeprecatedTag,
+  groupByVisibility,
+  getProperties,
+  getMethods,
+  getMemberBadges,
+  getDeprecationMessage,
+  formatTypeParameters,
+  formatSchema,
+  formatReturnType,
+  formatParameters,
+  formatMappedType,
+  formatConditionalType,
+  formatBadges,
+  findMissingParamDocs,
+  buildSignatureString,
+  analyzeSpec,
+  QueryBuilder
+};

package/dist/index.d.ts

@@ -1,5 +1,74 @@
 import { BreakingSeverity, CategorizedBreaking, calculateNextVersion, categorizeBreakingChanges, diffSpec, diffSpec as diffSpec2, MemberChangeInfo, recommendSemverBump, SemverBump, SemverRecommendation, SpecDiff } from "@openpkg-ts/spec";
-import { OpenPkg } 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";
 /** Configuration for resolving external package re-exports */
 interface ExternalsConfig {
 	/** Package patterns to resolve (globs supported, e.g., "@myorg/*") */
@@ -35,7 +104,7 @@ interface ExtractOptions {
 	externals?: ExternalsConfig;
 }
 interface ExtractResult {
-	spec: OpenPkg;
+	spec: OpenPkg2;
 	diagnostics: Diagnostic[];
 	forgottenExports?: ForgottenExport[];
 	/** Metadata about runtime schema extraction (when schemaExtraction: 'hybrid') */
@@ -153,7 +222,7 @@ 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";
+import { OpenPkg as OpenPkg3, SpecExport as SpecExport2 } from "@openpkg-ts/spec";
 interface DiagnosticItem {
 	exportId: string;
 	exportName: string;
@@ -174,20 +243,20 @@ interface SpecDiagnostics {
 /**
 * Check if has @deprecated tag.
 */
-declare function hasDeprecatedTag(exp: SpecExport): boolean;
+declare function hasDeprecatedTag(exp: SpecExport2): boolean;
 /**
 * Get deprecation message from @deprecated tag.
 * Returns undefined if no reason provided.
 */
-declare function getDeprecationMessage(exp: SpecExport): string | undefined;
+declare function getDeprecationMessage(exp: SpecExport2): string | undefined;
 /**
 * Find params without descriptions in JSDoc.
 */
-declare function findMissingParamDocs(exp: SpecExport): string[];
+declare function findMissingParamDocs(exp: SpecExport2): string[];
 /**
 * Analyze a spec for quality issues.
 */
-declare function analyzeSpec(spec: OpenPkg2): SpecDiagnostics;
+declare function analyzeSpec(spec: OpenPkg3): SpecDiagnostics;
 import { SpecMember } from "@openpkg-ts/spec";
 /**
 * Extract badge strings from a member's visibility and flags.
@@ -198,8 +267,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 OpenPkg9, SpecExport as SpecExport4, SpecExportKind as SpecExportKind5, SpecType } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg4 } from "@openpkg-ts/spec";
 interface HTMLOptions {
 	/** Page title override */
 	title?: string;
@@ -237,8 +306,8 @@ interface HTMLOptions {
 * const fragment = docs.toHTML({ export: 'greet', fullDocument: false })
 * ```
 */
-declare function toHTML2(spec: OpenPkg3, options?: HTMLOptions): string;
-import { OpenPkg as OpenPkg4, SpecExportKind } from "@openpkg-ts/spec";
+declare function toHTML2(spec: OpenPkg4, options?: HTMLOptions): string;
+import { OpenPkg as OpenPkg5, SpecExportKind as SpecExportKind2 } from "@openpkg-ts/spec";
 interface JSONOptions {
 	/** Include raw spec data alongside simplified data */
 	includeRaw?: boolean;
@@ -286,7 +355,7 @@ interface SimplifiedExample {
 interface SimplifiedExport {
 	id: string;
 	name: string;
-	kind: SpecExportKind;
+	kind: SpecExportKind2;
 	signature: string;
 	description?: string;
 	deprecated: boolean;
@@ -308,7 +377,7 @@ interface SimplifiedSpec {
 	version?: string;
 	description?: string;
 	exports: SimplifiedExport[];
-	byKind: Record<SpecExportKind, SimplifiedExport[]>;
+	byKind: Record<SpecExportKind2, SimplifiedExport[]>;
 	totalExports: number;
 }
 /**
@@ -332,7 +401,7 @@ interface SimplifiedSpec {
 * // { id, name, kind, signature, parameters, returns, ... }
 * ```
 */
-declare function toJSON2(spec: OpenPkg4, options?: JSONOptions): SimplifiedSpec | SimplifiedExport;
+declare function toJSON2(spec: OpenPkg5, options?: JSONOptions): SimplifiedSpec | SimplifiedExport;
 /**
 * Serialize to JSON string with formatting.
 *
@@ -340,10 +409,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: OpenPkg5, options?: JSONOptions & {
 	pretty?: boolean;
 }): string;
-import { OpenPkg as OpenPkg5, SpecExport as SpecExport2 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg6, SpecExport as SpecExport3 } from "@openpkg-ts/spec";
 interface MarkdownOptions {
 	/** Include frontmatter in output */
 	frontmatter?: boolean;
@@ -389,7 +458,7 @@ interface ExportMarkdownOptions extends MarkdownOptions {
 * })
 * ```
 */
-declare function exportToMarkdown(exp: SpecExport2, options?: MarkdownOptions): string;
+declare function exportToMarkdown(exp: SpecExport3, options?: MarkdownOptions): string;
 /**
 * Render entire spec to MDX.
 *
@@ -409,8 +478,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: OpenPkg6, options?: ExportMarkdownOptions): string;
+import { OpenPkg as OpenPkg7, SpecExportKind as SpecExportKind3 } from "@openpkg-ts/spec";
 type NavFormat = "fumadocs" | "docusaurus" | "generic";
 type GroupBy = "kind" | "module" | "tag" | "none";
 interface NavOptions {
@@ -425,7 +494,7 @@ interface NavOptions {
 	/** Include index pages for groups */
 	includeGroupIndex?: boolean;
 	/** Custom kind labels */
-	kindLabels?: Partial<Record<SpecExportKind2, string>>;
+	kindLabels?: Partial<Record<SpecExportKind3, string>>;
 	/** Sort exports alphabetically */
 	sortAlphabetically?: boolean;
 }
@@ -485,7 +554,7 @@ type DocusaurusSidebar = DocusaurusSidebarItem[];
 * const sidebar = docs.toNavigation({ format: 'docusaurus' })
 * ```
 */
-declare function toNavigation2(spec: OpenPkg6, options?: NavOptions): GenericNav | FumadocsMeta | DocusaurusSidebar;
+declare function toNavigation2(spec: OpenPkg7, options?: NavOptions): GenericNav | FumadocsMeta | DocusaurusSidebar;
 /**
 * Generate Fumadocs meta.json file content.
 *
@@ -499,7 +568,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: OpenPkg7, options?: Omit<NavOptions, "format">): string;
 /**
 * Generate Docusaurus sidebar config.
 *
@@ -513,8 +582,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: OpenPkg7, options?: Omit<NavOptions, "format">): string;
+import { OpenPkg as OpenPkg8, SpecExportKind as SpecExportKind4 } from "@openpkg-ts/spec";
 interface SearchOptions {
 	/** Base URL for search result links */
 	baseUrl?: string;
@@ -558,7 +627,7 @@ interface PagefindRecord {
 interface AlgoliaRecord {
 	objectID: string;
 	name: string;
-	kind: SpecExportKind3;
+	kind: SpecExportKind4;
 	description?: string;
 	signature: string;
 	content: string;
@@ -578,7 +647,7 @@ interface AlgoliaRecord {
 interface SearchRecord {
 	id: string;
 	name: string;
-	kind: SpecExportKind3;
+	kind: SpecExportKind4;
 	signature: string;
 	description?: string;
 	content: string;
@@ -607,7 +676,7 @@ interface SearchIndex {
 * // { records: [...], version: '1.0.0', packageName: 'my-lib' }
 * ```
 */
-declare function toSearchIndex2(spec: OpenPkg7, options?: SearchOptions): SearchIndex;
+declare function toSearchIndex2(spec: OpenPkg8, options?: SearchOptions): SearchIndex;
 /**
 * Generate Pagefind-compatible records.
 *
@@ -623,7 +692,7 @@ declare function toSearchIndex2(spec: OpenPkg7, options?: SearchOptions): Search
 * })
 * ```
 */
-declare function toPagefindRecords2(spec: OpenPkg7, options?: SearchOptions): PagefindRecord[];
+declare function toPagefindRecords2(spec: OpenPkg8, options?: SearchOptions): PagefindRecord[];
 /**
 * Generate Algolia-compatible records.
 *
@@ -637,7 +706,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: OpenPkg8, options?: SearchOptions): AlgoliaRecord[];
 /**
 * Serialize search index to JSON string.
 *
@@ -651,36 +720,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: OpenPkg8, options?: SearchOptions & {
 	pretty?: boolean;
 }): string;
 interface LoadOptions {
 	/** Path to openpkg.json file or the spec object directly */
-	input: string | OpenPkg8;
+	input: string | OpenPkg9;
 }
 interface DocsInstance {
 	/** The parsed OpenPkg spec */
-	spec: OpenPkg8;
+	spec: OpenPkg9;
 	/** Get an by its ID */
-	getExport(id: string): SpecExport3 | undefined;
+	getExport(id: string): SpecExport4 | 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: SpecExportKind5): SpecExport4[];
 	/** Get all exports */
-	getAllExports(): SpecExport3[];
+	getAllExports(): SpecExport4[];
 	/** Get all type definitions */
 	getAllTypes(): SpecType[];
 	/** Get exports by JSDoc tag (e.g., '@beta', '@internal') */
-	getExportsByTag(tagName: string): SpecExport3[];
+	getExportsByTag(tagName: string): SpecExport4[];
 	/** Search exports by name or description */
-	search(query: string): SpecExport3[];
+	search(query: string): SpecExport4[];
 	/** Get exports belonging to a specific module/namespace */
-	getModule(moduleName: string): SpecExport3[];
+	getModule(moduleName: string): SpecExport4[];
 	/** Get deprecated exports */
-	getDeprecated(): SpecExport3[];
+	getDeprecated(): SpecExport4[];
 	/** Get exports grouped by kind */
-	groupByKind(): Record<SpecExportKind4, SpecExport3[]>;
+	groupByKind(): Record<SpecExportKind5, SpecExport4[]>;
 	/** Render spec or single to MDX */
 	toMarkdown(options?: ExportMarkdownOptions): string;
 	/** Render spec or single to HTML */
@@ -708,7 +777,7 @@ interface DocsInstance {
 * const docs = loadSpec(spec)
 * ```
 */
-declare function loadSpec(spec: OpenPkg8): DocsInstance;
+declare function loadSpec(spec: OpenPkg9): DocsInstance;
 /**
 * Creates a docs instance for querying and rendering API documentation.
 *
@@ -730,8 +799,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 | OpenPkg9): DocsInstance;
+import { OpenPkg as OpenPkg10, SpecExport as SpecExport5, SpecMember as SpecMember2, SpecSchema, SpecSignature, SpecType as SpecType2, SpecTypeParameter } from "@openpkg-ts/spec";
 interface FormatSchemaOptions {
 	/** Include package attribution for external types */
 	includePackage?: boolean;
@@ -812,7 +881,7 @@ declare function formatReturnType(sig?: SpecSignature): string;
 * // 'class Logger extends EventEmitter'
 * ```
 */
-declare function buildSignatureString(exp: SpecExport4, sigIndex?: number): string;
+declare function buildSignatureString(exp: SpecExport5, sigIndex?: number): string;
 /**
 * Resolve a type reference to its definition.
 *
@@ -826,7 +895,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: OpenPkg10): SpecType2 | undefined;
 /**
 * Check if a member is a method (has signatures).
 *
@@ -941,10 +1010,33 @@ declare function formatConditionalType(condType: SpecConditionalType): string;
 * ```
 */
 declare function formatMappedType(mappedType: SpecMappedType): string;
-import { OpenPkg as OpenPkg10, SpecExportKind as SpecExportKind5 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg11 } from "@openpkg-ts/spec";
+interface ReactLayoutOptions {
+	/** Output directory for generated files */
+	outDir: string;
+	/** Layout variant: 'full' (single page) or 'index' (index with links) */
+	variant?: "full" | "index";
+	/** Components path alias (default: @/components/api) */
+	componentsPath?: string;
+}
+/**
+* Generate React layout from an OpenPkg spec.
+*
+* Unlike the old per-approach, this generates a single layout file.
+* Components are installed separately via the registry.
+*/
+declare function toReact(spec: OpenPkg11, options: ReactLayoutOptions): Promise<void>;
+/**
+* Generate layout code as a string (for preview).
+*/
+declare function toReactString(spec: OpenPkg11, options?: {
+	variant?: "full" | "index";
+	componentsPath?: string;
+}): string;
+import { OpenPkg as OpenPkg12, SpecExportKind as SpecExportKind6 } from "@openpkg-ts/spec";
 type FilterCriteria = {
 	/** Filter by kinds */
-	kinds?: SpecExportKind5[];
+	kinds?: SpecExportKind6[];
 	/** Filter by names (exact match) */
 	names?: string[];
 	/** Filter by IDs */
@@ -966,7 +1058,7 @@ type FilterCriteria = {
 };
 type FilterResult = {
 	/** New spec with only matched exports (immutable) */
-	spec: OpenPkg10;
+	spec: OpenPkg12;
 	/** Number of exports that matched */
 	matched: number;
 	/** Total number of exports in original spec */
@@ -982,8 +1074,8 @@ type FilterResult = {
 * @param criteria - Filter criteria (empty criteria matches all)
 * @returns FilterResult with new spec, matched count, total count
 */
-declare function filterSpec(spec: OpenPkg10, criteria: FilterCriteria): FilterResult;
-import { SpecExport as SpecExport5, SpecType as SpecType3 } from "@openpkg-ts/spec";
+declare function filterSpec(spec: OpenPkg12, criteria: FilterCriteria): FilterResult;
+import { SpecExport as SpecExport6, SpecType as SpecType3 } from "@openpkg-ts/spec";
 interface GetExportOptions {
 	/** Entry point file path */
 	entryFile: string;
@@ -998,7 +1090,7 @@ interface GetExportOptions {
 }
 interface GetExportResult {
 	/** The spec, or null if not found */
-	export: SpecExport5 | null;
+	export: SpecExport6 | null;
 	/** Related types referenced by the */
 	types: SpecType3[];
 	/** Errors encountered */
@@ -1365,24 +1457,24 @@ declare const arktypeAdapter: SchemaAdapter;
 declare const typeboxAdapter: SchemaAdapter;
 declare const valibotAdapter: SchemaAdapter;
 declare const zodAdapter: SchemaAdapter;
-import { SpecExport as SpecExport7 } from "@openpkg-ts/spec";
-import ts6 from "typescript";
-declare function serializeClass(node: ts6.ClassDeclaration, ctx: SerializerContext): SpecExport7 | null;
 import { SpecExport as SpecExport8 } from "@openpkg-ts/spec";
-import ts7 from "typescript";
-declare function serializeEnum(node: ts7.EnumDeclaration, ctx: SerializerContext): SpecExport8 | null;
+import ts6 from "typescript";
+declare function serializeClass(node: ts6.ClassDeclaration, ctx: SerializerContext): SpecExport8 | null;
 import { SpecExport as SpecExport9 } from "@openpkg-ts/spec";
-import ts8 from "typescript";
-declare function serializeFunctionExport(node: ts8.FunctionDeclaration | ts8.ArrowFunction, ctx: SerializerContext, nameOverride?: string): SpecExport9 | null;
+import ts7 from "typescript";
+declare function serializeEnum(node: ts7.EnumDeclaration, ctx: SerializerContext): SpecExport9 | null;
 import { SpecExport as SpecExport10 } from "@openpkg-ts/spec";
-import ts9 from "typescript";
-declare function serializeInterface(node: ts9.InterfaceDeclaration, ctx: SerializerContext): SpecExport10 | null;
+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";
-import ts10 from "typescript";
-declare function serializeTypeAlias(node: ts10.TypeAliasDeclaration, ctx: SerializerContext): SpecExport11 | null;
+import ts9 from "typescript";
+declare function serializeInterface(node: ts9.InterfaceDeclaration, ctx: SerializerContext): SpecExport11 | null;
 import { SpecExport as SpecExport12 } 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";
 import ts11 from "typescript";
-declare function serializeVariable(node: ts11.VariableDeclaration, statement: ts11.VariableStatement, ctx: SerializerContext): SpecExport12 | null;
+declare function serializeVariable(node: ts11.VariableDeclaration, statement: ts11.VariableStatement, ctx: SerializerContext): SpecExport13 | null;
 import { SpecSignatureParameter } from "@openpkg-ts/spec";
 import ts12 from "typescript";
 declare function extractParameters(signature: ts12.Signature, ctx: SerializerContext): SpecSignatureParameter[];
@@ -1441,7 +1533,7 @@ declare function isPureRefSchema(schema: SpecSchema2): schema is {
 * Add description to a schema, handling $ref properly.
 * For pure $ref schemas, wraps in allOf to preserve the reference.
 */
-declare function withDescription(schema: SpecSchema2, description: string): SpecSchema2;
+declare function withDescription2(schema: SpecSchema2, description: string): SpecSchema2;
 /**
 * Check if a schema represents the 'any' type
 */
@@ -1459,7 +1551,7 @@ declare function deduplicateSchemas(schemas: SpecSchema2[]): SpecSchema2[];
 * 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 SpecExport13, SpecMember as SpecMember3, SpecSchema as SpecSchema3, SpecType as SpecType5 } from "@openpkg-ts/spec";
+import { SpecExport as SpecExport14, SpecMember as SpecMember3, SpecSchema as SpecSchema3, SpecType as SpecType5 } from "@openpkg-ts/spec";
 /**
 * Options for schema normalization
 */
@@ -1490,7 +1582,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: SpecExport13, options?: NormalizeOptions): SpecExport13;
+declare function normalizeExport(exp: SpecExport14, options?: NormalizeOptions): SpecExport14;
 /**
 * Normalize a SpecType, normalizing its schema and nested schemas.
 *
@@ -1524,4 +1616,4 @@ declare function normalizeMembers(members: SpecMember3[], options?: NormalizeOpt
 import ts14 from "typescript";
 declare function isExported(node: ts14.Node): boolean;
 declare function getNodeName(node: ts14.Node): string | undefined;
-export { zodAdapter, withDescription, valibotAdapter, typeboxAdapter, toSearchIndexJSON, toSearchIndex2 as toSearchIndex, 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, 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, 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 };
+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 };