@openpkg-ts/sdk 0.35.0 → 0.35.1

package/dist/browser.d.ts

@@ -606,7 +606,7 @@ declare function formatConditionalType(condType: SpecConditionalType): string;
 * ```
 */
 declare function formatMappedType(mappedType: SpecMappedType): string;
-import { OpenPkg as OpenPkg9, SpecExport as SpecExport5, SpecExportKind as SpecExportKind5 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg9, SpecExport as SpecExport5, SpecExportKind as SpecExportKind6 } from "@openpkg-ts/spec";
 type Predicate = (exp: SpecExport5) => boolean;
 /**
 * Chainable query builder for filtering OpenPkg exports.
@@ -619,7 +619,7 @@ declare class QueryBuilder {
 	/**
 	* Filter by kind(s)
 	*/
-	byKind(...kinds: SpecExportKind5[]): this;
+	byKind(...kinds: SpecExportKind6[]): this;
 	/**
 	* Filter by name (exact string or regex pattern)
 	*/

package/dist/browser.js

@@ -25,7 +25,7 @@ import {
   toPagefindRecords,
   toSearchIndex,
   toSearchIndexJSON
-} from "./shared/chunk-skapcfq1.js";
+} from "./shared/chunk-4fgxg5jj.js";
 export {
   toSearchIndexJSON,
   toSearchIndex,

package/dist/index.d.ts

@@ -951,7 +951,7 @@ 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";
+import { OpenPkg as OpenPkg10, SpecExport as SpecExport5, SpecExportKind as SpecExportKind6 } from "@openpkg-ts/spec";
 type Predicate = (exp: SpecExport5) => boolean;
 /**
 * Chainable query builder for filtering OpenPkg exports.
@@ -964,7 +964,7 @@ declare class QueryBuilder {
 	/**
 	* Filter by kind(s)
 	*/
-	byKind(...kinds: SpecExportKind5[]): this;
+	byKind(...kinds: SpecExportKind6[]): this;
 	/**
 	* Filter by name (exact string or regex pattern)
 	*/
@@ -1043,10 +1043,10 @@ declare function toReactString(spec: OpenPkg11, options?: {
 	variant?: "full" | "index";
 	componentsPath?: string;
 }): string;
-import { OpenPkg as OpenPkg12, SpecExportKind as SpecExportKind6 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg12, SpecExportKind as SpecExportKind7 } from "@openpkg-ts/spec";
 type FilterCriteria = {
 	/** Filter by kinds */
-	kinds?: SpecExportKind6[];
+	kinds?: SpecExportKind7[];
 	/** Filter by names (exact match) */
 	names?: string[];
 	/** Filter by IDs */
@@ -1218,7 +1218,7 @@ declare function resolveExportTarget(symbol: ts3.Symbol, checker: ts3.TypeChecke
 	targetSymbol: ts3.Symbol;
 	isTypeOnly: boolean;
 };
-import { SpecExample, SpecSource, SpecTag, SpecTypeParameter as SpecTypeParameter2 } from "@openpkg-ts/spec";
+import { SpecExample, SpecExportKind as SpecExportKind8, SpecSource, SpecTag, SpecTypeParameter as SpecTypeParameter2 } from "@openpkg-ts/spec";
 import ts4 from "typescript";
 declare function getJSDocComment(node: ts4.Node, symbol?: ts4.Symbol, checker?: ts4.TypeChecker): {
 	description?: string;
@@ -1248,6 +1248,8 @@ declare function isSymbolDeprecated(symbol: ts4.Symbol | undefined): {
 	deprecated: boolean;
 	reason?: string;
 };
+/** Classify a declaration node into an kind */
+declare function getExportKind(declaration: ts4.Declaration, type: ts4.Type): SpecExportKind8;
 /**
 * Target version for JSON Schema generation.
 * @see https://standardschema.dev/json-schema
@@ -1469,6 +1471,11 @@ declare class CacheManager<
 	*/
 	set(key: K, value: V): void;
 	/**
+	* Get cached value or compute, cache, and return it.
+	* Unlike has()+get(), this correctly updates LRU order in a single operation.
+	*/
+	getOrCompute(key: K, compute: () => V): V;
+	/**
 	* Delete a specific key from the cache.
 	*/
 	delete(key: K): boolean;
@@ -1630,6 +1637,7 @@ import ts15 from "typescript";
 * Used for types that have specific serialization formats.
 */
 declare const BUILTIN_TYPE_SCHEMAS: Record<string, SpecSchema2>;
+declare const PRIMITIVES: Set<string>;
 declare const ARRAY_PROTOTYPE_METHODS: Set<string>;
 /**
 * Check if a name is a primitive type
@@ -1662,7 +1670,7 @@ declare function ensureNonEmptySchema(schema: SpecSchema2, type: ts15.Type, chec
 * Uses $ref for named types and typeArguments for generics.
 * Guarantees non-empty schema output via ensureNonEmptySchema wrapper.
 */
-declare function buildSchema(type: ts15.Type, checker: ts15.TypeChecker, ctx?: SerializerContext, _depth?: number): SpecSchema2;
+declare function buildSchema(type: ts15.Type, checker: ts15.TypeChecker, ctx?: SerializerContext): SpecSchema2;
 /**
 * Check if a schema is a pure $ref (only has $ref property)
 */
@@ -1756,4 +1764,4 @@ declare function normalizeMembers(members: SpecMember3[], options?: NormalizeOpt
 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 };
+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, getExportKind, 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, PRIMITIVES, 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 };

package/dist/index.js

@@ -1,7 +1,10 @@
 import {
+  KIND_ORDER,
   QueryBuilder,
   analyzeSpec,
   buildSignatureString,
+  filterExports,
+  findExport,
   findMissingParamDocs,
   formatBadges,
   formatConditionalType,
@@ -14,6 +17,7 @@ import {
   getMemberBadges,
   getMethods,
   getProperties,
+  groupByKind,
   groupByVisibility,
   hasDeprecatedTag,
   isMethod,
@@ -25,7 +29,7 @@ import {
   toPagefindRecords,
   toSearchIndex,
   toSearchIndexJSON
-} from "./shared/chunk-skapcfq1.js";
+} from "./shared/chunk-4fgxg5jj.js";
 
 // src/primitives/diff.ts
 import {
@@ -69,13 +73,13 @@ function mergeConfig(fileConfig, cliOptions) {
   if (!fileConfig) {
     return cliOptions;
   }
-  return {
-    externals: {
-      include: cliOptions.externals?.include ?? fileConfig.externals?.include,
-      exclude: cliOptions.externals?.exclude ?? fileConfig.externals?.exclude,
-      depth: cliOptions.externals?.depth ?? fileConfig.externals?.depth
-    }
+  const externals = {
+    include: cliOptions.externals?.include ?? fileConfig.externals?.include,
+    exclude: cliOptions.externals?.exclude ?? fileConfig.externals?.exclude,
+    depth: cliOptions.externals?.depth ?? fileConfig.externals?.depth
   };
+  const hasExternals = externals.include || externals.exclude || externals.depth !== undefined;
+  return hasExternals ? { externals } : {};
 }
 // src/core/loader.ts
 import * as fs2 from "node:fs";
@@ -345,10 +349,7 @@ function renderExport(exp) {
 function toHTML(spec, options = {}) {
   const { includeStyles = true, fullDocument = true, customCSS = "" } = options;
   if (options.export) {
-    const exp = spec.exports.find((e) => e.name === options.export || e.id === options.export);
-    if (!exp) {
-      throw new Error(`Export not found: ${options.export}`);
-    }
+    const exp = findExport(spec, options.export);
     const content2 = renderExport(exp);
     if (!fullDocument)
       return content2;
@@ -373,24 +374,17 @@ function toHTML(spec, options = {}) {
   }
   let specExports = spec.exports;
   if (options.exports?.length) {
-    const ids = new Set(options.exports);
-    specExports = spec.exports.filter((e) => ids.has(e.name) || ids.has(e.id));
+    specExports = filterExports(spec, options.exports);
   }
   const title = options.title || `${spec.meta.name} API Reference`;
   const description = spec.meta.description ? `<p>${escapeHTML(spec.meta.description)}</p>` : "";
-  const byKind = {};
-  for (const exp of specExports) {
-    if (!byKind[exp.kind])
-      byKind[exp.kind] = [];
-    byKind[exp.kind].push(exp);
-  }
+  const byKind = groupByKind(specExports);
   const navItems = Object.entries(byKind).map(([kind, exports]) => {
     const links = exports.map((e) => `<a href="#${e.id}">${escapeHTML(e.name)}</a>`).join("");
     return `<li><strong>${kind}s:</strong> ${links}</li>`;
   }).join("");
   const nav = `<nav><ul>${navItems}</ul></nav>`;
-  const kindOrder = ["function", "class", "interface", "type", "enum", "variable"];
-  const sections = kindOrder.filter((kind) => byKind[kind]?.length).map((kind) => {
+  const sections = KIND_ORDER.filter((kind) => byKind[kind]?.length).map((kind) => {
     const exports = byKind[kind].map(renderExport).join("");
     return `
         <section class="kind-section">
@@ -516,24 +510,14 @@ function simplifyExport(exp) {
 }
 function toJSON(spec, options = {}) {
   if (options.export) {
-    const exp = spec.exports.find((e) => e.name === options.export || e.id === options.export);
-    if (!exp) {
-      throw new Error(`Export not found: ${options.export}`);
-    }
-    return simplifyExport(exp);
+    return simplifyExport(findExport(spec, options.export));
   }
   let specExports = spec.exports;
   if (options.exports?.length) {
-    const ids = new Set(options.exports);
-    specExports = spec.exports.filter((e) => ids.has(e.name) || ids.has(e.id));
+    specExports = filterExports(spec, options.exports);
   }
   const exports = specExports.map(simplifyExport);
-  const byKind = {};
-  for (const exp of exports) {
-    if (!byKind[exp.kind])
-      byKind[exp.kind] = [];
-    byKind[exp.kind].push(exp);
-  }
+  const byKind = groupByKind(exports);
   return {
     name: spec.meta.name,
     version: spec.meta.version,
@@ -876,16 +860,11 @@ function exportToMarkdown(exp, options = {}) {
 }
 function toMarkdown(spec, options = {}) {
   if (options.export) {
-    const exp = spec.exports.find((e) => e.name === options.export || e.id === options.export);
-    if (!exp) {
-      throw new Error(`Export not found: ${options.export}`);
-    }
-    return exportToMarkdown(exp, options);
+    return exportToMarkdown(findExport(spec, options.export), options);
   }
   let specExports = spec.exports;
   if (options.exports?.length) {
-    const ids = new Set(options.exports);
-    specExports = spec.exports.filter((e) => ids.has(e.name) || ids.has(e.id));
+    specExports = filterExports(spec, options.exports);
     if (specExports.length === 0)
       return "";
   }
@@ -914,14 +893,8 @@ function toMarkdown(spec, options = {}) {
     parts.push(spec.meta.description);
     parts.push("");
   }
-  const byKind = {};
-  for (const exp of specExports) {
-    if (!byKind[exp.kind])
-      byKind[exp.kind] = [];
-    byKind[exp.kind].push(exp);
-  }
-  const kindOrder = ["function", "class", "interface", "type", "enum", "variable"];
-  for (const kind of kindOrder) {
+  const byKind = groupByKind(specExports);
+  for (const kind of KIND_ORDER) {
     const exports = byKind[kind];
     if (!exports?.length)
       continue;
@@ -1024,21 +997,9 @@ function toGenericNav(spec, options) {
     });
   }
   if (groupBy === "kind") {
-    const kindOrder = [
-      "function",
-      "class",
-      "interface",
-      "type",
-      "enum",
-      "variable",
-      "namespace",
-      "module",
-      "reference",
-      "external"
-    ];
     groups.sort((a, b) => {
-      const aIdx = kindOrder.indexOf(a.title.toLowerCase().replace(/s$/, ""));
-      const bIdx = kindOrder.indexOf(b.title.toLowerCase().replace(/s$/, ""));
+      const aIdx = KIND_ORDER.indexOf(a.title.toLowerCase().replace(/s$/, ""));
+      const bIdx = KIND_ORDER.indexOf(b.title.toLowerCase().replace(/s$/, ""));
       return aIdx - bIdx;
     });
   }
@@ -1926,6 +1887,23 @@ function getParamDescription(propertyName, jsdocTags, inferredAlias) {
   }
   return;
 }
+function extractVarianceModifiers(modifiers) {
+  if (!modifiers)
+    return {};
+  let hasIn = false;
+  let hasOut = false;
+  let isConst;
+  for (const mod of modifiers) {
+    if (mod.kind === ts2.SyntaxKind.InKeyword)
+      hasIn = true;
+    if (mod.kind === ts2.SyntaxKind.OutKeyword)
+      hasOut = true;
+    if (mod.kind === ts2.SyntaxKind.ConstKeyword)
+      isConst = true;
+  }
+  const variance = hasIn && hasOut ? "inout" : hasIn ? "in" : hasOut ? "out" : undefined;
+  return { variance, isConst };
+}
 function extractTypeParameters(node, checker) {
   if (!node.typeParameters || node.typeParameters.length === 0) {
     return;
@@ -1942,27 +1920,7 @@ function extractTypeParameters(node, checker) {
       const defType = checker.getTypeAtLocation(tp.default);
       defaultType = checker.typeToString(defType);
     }
-    let variance;
-    let isConst;
-    const modifiers = ts2.getModifiers(tp);
-    if (modifiers) {
-      let hasIn = false;
-      let hasOut = false;
-      for (const mod of modifiers) {
-        if (mod.kind === ts2.SyntaxKind.InKeyword)
-          hasIn = true;
-        if (mod.kind === ts2.SyntaxKind.OutKeyword)
-          hasOut = true;
-        if (mod.kind === ts2.SyntaxKind.ConstKeyword)
-          isConst = true;
-      }
-      if (hasIn && hasOut)
-        variance = "inout";
-      else if (hasIn)
-        variance = "in";
-      else if (hasOut)
-        variance = "out";
-    }
+    const { variance, isConst } = extractVarianceModifiers(ts2.getModifiers(tp));
     return {
       name,
       ...constraint ? { constraint } : {},
@@ -2027,25 +1985,7 @@ function extractTypeParametersFromSignature(signature, checker) {
     const declarations = tpSymbol?.getDeclarations() ?? [];
     for (const decl of declarations) {
       if (ts2.isTypeParameterDeclaration(decl)) {
-        const modifiers = ts2.getModifiers(decl);
-        if (modifiers) {
-          let hasIn = false;
-          let hasOut = false;
-          for (const mod of modifiers) {
-            if (mod.kind === ts2.SyntaxKind.InKeyword)
-              hasIn = true;
-            if (mod.kind === ts2.SyntaxKind.OutKeyword)
-              hasOut = true;
-            if (mod.kind === ts2.SyntaxKind.ConstKeyword)
-              isConst = true;
-          }
-          if (hasIn && hasOut)
-            variance = "inout";
-          else if (hasIn)
-            variance = "in";
-          else if (hasOut)
-            variance = "out";
-        }
+        ({ variance, isConst } = extractVarianceModifiers(ts2.getModifiers(decl)));
         break;
       }
     }
@@ -2058,6 +1998,23 @@ function extractTypeParametersFromSignature(signature, checker) {
     };
   });
 }
+function getExportKind(declaration, type) {
+  if (ts2.isFunctionDeclaration(declaration) || ts2.isFunctionExpression(declaration))
+    return "function";
+  if (ts2.isClassDeclaration(declaration))
+    return "class";
+  if (ts2.isInterfaceDeclaration(declaration))
+    return "interface";
+  if (ts2.isTypeAliasDeclaration(declaration))
+    return "type";
+  if (ts2.isEnumDeclaration(declaration))
+    return "enum";
+  if (ts2.isModuleDeclaration(declaration) || ts2.isNamespaceExport(declaration))
+    return "namespace";
+  if (ts2.isVariableDeclaration(declaration) && type.getCallSignatures().length > 0)
+    return "function";
+  return "variable";
+}
 
 // src/types/parameters.ts
 import ts4 from "typescript";
@@ -2088,6 +2045,9 @@ var BUILTIN_TYPE_SCHEMAS = {
   BigInt64Array: { type: "string", format: "byte" },
   BigUint64Array: { type: "string", format: "byte" }
 };
+function setSchemaExtension(schema, key, value) {
+  schema[key] = value;
+}
 var PRIMITIVES = new Set([
   "string",
   "number",
@@ -2263,7 +2223,7 @@ function ensureNonEmptySchema(schema, type, checker) {
   }
   return schema;
 }
-function buildSchema(type, checker, ctx, _depth = 0) {
+function buildSchema(type, checker, ctx) {
   const schema = buildSchemaInternal(type, checker, ctx);
   return ensureNonEmptySchema(schema, type, checker);
 }
@@ -2454,7 +2414,7 @@ function buildSchemaInternal(type, checker, ctx) {
             typeArguments: typeArgs.map((t) => buildSchema(t, checker, ctx))
           };
           if (packageOrigin) {
-            schema2["x-ts-package"] = packageOrigin;
+            setSchemaExtension(schema2, "x-ts-package", packageOrigin);
           }
           return schema2;
         });
@@ -2464,7 +2424,7 @@ function buildSchemaInternal(type, checker, ctx) {
         typeArguments: typeArgs.map((t) => buildSchema(t, checker, ctx))
       };
       if (packageOrigin) {
-        schema["x-ts-package"] = packageOrigin;
+        setSchemaExtension(schema, "x-ts-package", packageOrigin);
       }
       return schema;
     }
@@ -2485,7 +2445,7 @@ function buildSchemaInternal(type, checker, ctx) {
             typeArguments: aliasTypeArgs.map((t) => buildSchema(t, checker, ctx))
           };
           if (packageOrigin) {
-            schema2["x-ts-package"] = packageOrigin;
+            setSchemaExtension(schema2, "x-ts-package", packageOrigin);
           }
           return schema2;
         });
@@ -2495,7 +2455,7 @@ function buildSchemaInternal(type, checker, ctx) {
         typeArguments: aliasTypeArgs.map((t) => buildSchema(t, checker, ctx))
       };
       if (packageOrigin) {
-        schema["x-ts-package"] = packageOrigin;
+        setSchemaExtension(schema, "x-ts-package", packageOrigin);
       }
       return schema;
     }
@@ -2518,7 +2478,7 @@ function buildSchemaInternal(type, checker, ctx) {
       const packageOrigin = getTypeOrigin(type, checker);
       const schema = { $ref: `#/types/${name}` };
       if (packageOrigin) {
-        schema["x-ts-package"] = packageOrigin;
+        setSchemaExtension(schema, "x-ts-package", packageOrigin);
       }
       return schema;
     }
@@ -2585,7 +2545,7 @@ function buildObjectSchema(properties, checker, ctx, originalType) {
       ...required.length > 0 ? { required } : {}
     };
     if (Object.keys(props).length === 0 && originalType) {
-      schema["x-ts-type"] = checker.typeToString(originalType);
+      setSchemaExtension(schema, "x-ts-type", checker.typeToString(originalType));
     }
     return schema;
   };
@@ -2884,20 +2844,6 @@ import ts6 from "typescript";
 
 // src/ast/registry.ts
 import ts5 from "typescript";
-var PRIMITIVES2 = new Set([
-  "string",
-  "number",
-  "boolean",
-  "void",
-  "any",
-  "undefined",
-  "null",
-  "never",
-  "unknown",
-  "object",
-  "symbol",
-  "bigint"
-]);
 var BUILTINS = new Set([
   "Array",
   "ArrayBuffer",
@@ -2997,7 +2943,7 @@ class TypeRegistry {
     if (!symbol)
       return;
     const name = symbol.getName();
-    if (PRIMITIVES2.has(name))
+    if (PRIMITIVES.has(name))
       return;
     if (BUILTINS.has(name))
       return;
@@ -3246,6 +3192,32 @@ function serializeInheritedMember(symbol, inheritedFrom, ctx, isStatic) {
   };
 }
 
+// src/serializers/shared.ts
+function extractExportMetadata(node, symbol, checker, jsdocNode) {
+  const { deprecated, reason: deprecationReason } = isSymbolDeprecated(symbol);
+  const { description, tags, examples } = getJSDocComment(jsdocNode ?? node, symbol, checker);
+  const source = getSourceLocation(node, node.getSourceFile());
+  return { description, tags, examples, source, deprecated, deprecationReason };
+}
+function buildSignatures(callSignatures, checker, ctx) {
+  return callSignatures.map((sig, index) => {
+    const params = extractParameters(sig, ctx);
+    const returnType = checker.getReturnTypeOfSignature(sig);
+    registerReferencedTypes(returnType, ctx);
+    const sigDoc = getJSDocForSignature(sig, checker);
+    const sigTypeParams = extractTypeParametersFromSignature(sig, checker);
+    return {
+      parameters: params.length > 0 ? params : undefined,
+      returns: { schema: buildSchema(returnType, checker, ctx) },
+      ...sigDoc.description ? { description: sigDoc.description } : {},
+      ...sigDoc.tags.length > 0 ? { tags: sigDoc.tags } : {},
+      ...sigDoc.examples.length > 0 ? { examples: sigDoc.examples } : {},
+      ...sigTypeParams ? { typeParameters: sigTypeParams } : {},
+      ...callSignatures.length > 1 ? { overloadIndex: index } : {}
+    };
+  });
+}
+
 // src/serializers/classes.ts
 function serializeClass(node, ctx) {
   const { typeChecker: checker } = ctx;
@@ -3253,10 +3225,7 @@ function serializeClass(node, ctx) {
   const name = symbol?.getName() ?? node.name?.getText();
   if (!name)
     return null;
-  const { deprecated, reason: deprecationReason } = isSymbolDeprecated(symbol);
-  const declSourceFile = node.getSourceFile();
-  const { description, tags, examples } = getJSDocComment(node, symbol, checker);
-  const source = getSourceLocation(node, declSourceFile);
+  const { description, tags, examples, source, deprecated, deprecationReason } = extractExportMetadata(node, symbol, checker);
   const typeParameters = extractTypeParameters(node, checker);
   const members = [];
   const signatures = [];
@@ -3407,24 +3376,7 @@ function serializeMethod(node, ctx) {
   }
   const type = checker.getTypeAtLocation(node);
   const callSignatures = type.getCallSignatures();
-  const signatures = callSignatures.map((sig, index) => {
-    const params = extractParameters(sig, ctx);
-    const returnType = checker.getReturnTypeOfSignature(sig);
-    registerReferencedTypes(returnType, ctx);
-    const sigDoc = getJSDocForSignature(sig, checker);
-    const sigTypeParams = extractTypeParametersFromSignature(sig, checker);
-    return {
-      parameters: params.length > 0 ? params : undefined,
-      returns: {
-        schema: buildSchema(returnType, checker, ctx)
-      },
-      ...sigDoc.description ? { description: sigDoc.description } : {},
-      ...sigDoc.tags.length > 0 ? { tags: sigDoc.tags } : {},
-      ...sigDoc.examples.length > 0 ? { examples: sigDoc.examples } : {},
-      ...sigTypeParams ? { typeParameters: sigTypeParams } : {},
-      ...callSignatures.length > 1 ? { overloadIndex: index } : {}
-    };
-  });
+  const signatures = buildSignatures(callSignatures, checker, ctx);
   const flags = {};
   if (isStatic(node))
     flags.static = true;
@@ -3542,10 +3494,7 @@ function serializeEnum(node, ctx) {
   const name = symbol?.getName() ?? node.name?.getText();
   if (!name)
     return null;
-  const { deprecated, reason: deprecationReason } = isSymbolDeprecated(symbol);
-  const declSourceFile = node.getSourceFile();
-  const { description, tags, examples } = getJSDocComment(node, symbol, checker);
-  const source = getSourceLocation(node, declSourceFile);
+  const { description, tags, examples, source, deprecated, deprecationReason } = extractExportMetadata(node, symbol, checker);
   const members = node.members.map((member) => {
     const memberSymbol = checker.getSymbolAtLocation(member.name);
     const memberName = memberSymbol?.getName() ?? member.name.getText();
@@ -3615,10 +3564,7 @@ function serializeFunctionExport(node, ctx, nameOverride) {
   const name = nameOverride ?? symbol?.getName() ?? node.name?.getText();
   if (!name)
     return null;
-  const { deprecated, reason: deprecationReason } = isSymbolDeprecated(symbol);
-  const declSourceFile = node.getSourceFile();
-  const { description, tags, examples } = getJSDocComment(node, symbol, ctx.typeChecker);
-  const source = getSourceLocation(node, declSourceFile);
+  const { description, tags, examples, source, deprecated, deprecationReason } = extractExportMetadata(node, symbol, ctx.typeChecker);
   const typeParameters = extractTypeParameters(node, ctx.typeChecker);
   const type = ctx.typeChecker.getTypeAtLocation(node);
   const callSignatures = type.getCallSignatures();
@@ -3658,10 +3604,7 @@ function serializeInterface(node, ctx) {
   const name = symbol?.getName() ?? node.name?.getText();
   if (!name)
     return null;
-  const { deprecated, reason: deprecationReason } = isSymbolDeprecated(symbol);
-  const declSourceFile = node.getSourceFile();
-  const { description, tags, examples } = getJSDocComment(node, symbol, checker);
-  const source = getSourceLocation(node, declSourceFile);
+  const { description, tags, examples, source, deprecated, deprecationReason } = extractExportMetadata(node, symbol, checker);
   const typeParameters = extractTypeParameters(node, checker);
   const members = [];
   const methodsByName = new Map;
@@ -3770,24 +3713,7 @@ function serializeMethodSignature(node, ctx) {
   const { description, tags } = getJSDocComment(node);
   const type = checker.getTypeAtLocation(node);
   const callSignatures = type.getCallSignatures();
-  const signatures = callSignatures.map((sig, index) => {
-    const params = extractParameters(sig, ctx);
-    const returnType = checker.getReturnTypeOfSignature(sig);
-    registerReferencedTypes(returnType, ctx);
-    const sigDoc = getJSDocForSignature(sig, checker);
-    const sigTypeParams = extractTypeParametersFromSignature(sig, checker);
-    return {
-      parameters: params.length > 0 ? params : undefined,
-      returns: {
-        schema: buildSchema(returnType, checker, ctx)
-      },
-      ...sigDoc.description ? { description: sigDoc.description } : {},
-      ...sigDoc.tags.length > 0 ? { tags: sigDoc.tags } : {},
-      ...sigDoc.examples.length > 0 ? { examples: sigDoc.examples } : {},
-      ...sigTypeParams ? { typeParameters: sigTypeParams } : {},
-      ...callSignatures.length > 1 ? { overloadIndex: index } : {}
-    };
-  });
+  const signatures = buildSignatures(callSignatures, checker, ctx);
   const flags = {};
   if (node.questionToken)
     flags.optional = true;
@@ -3879,10 +3805,7 @@ function serializeTypeAlias(node, ctx) {
   const name = symbol?.getName() ?? node.name?.getText();
   if (!name)
     return null;
-  const { deprecated, reason: deprecationReason } = isSymbolDeprecated(symbol);
-  const declSourceFile = node.getSourceFile();
-  const { description, tags, examples } = getJSDocComment(node, symbol, ctx.typeChecker);
-  const source = getSourceLocation(node, declSourceFile);
+  const { description, tags, examples, source, deprecated, deprecationReason } = extractExportMetadata(node, symbol, ctx.typeChecker);
   const typeParameters = extractTypeParameters(node, ctx.typeChecker);
   const type = ctx.typeChecker.getTypeAtLocation(node);
   registerReferencedTypes(type, ctx);
@@ -4075,10 +3998,7 @@ function serializeVariable(node, statement, ctx) {
   const name = symbol?.getName() ?? node.name.getText();
   if (!name)
     return null;
-  const { deprecated, reason: deprecationReason } = isSymbolDeprecated(symbol);
-  const declSourceFile = node.getSourceFile();
-  const { description, tags, examples } = getJSDocComment(statement, symbol, ctx.typeChecker);
-  const source = getSourceLocation(node, declSourceFile);
+  const { description, tags, examples, source, deprecated, deprecationReason } = extractExportMetadata(node, symbol, ctx.typeChecker, statement);
   const type = ctx.typeChecker.getTypeAtLocation(node);
   const schemaExtraction = extractSchemaType(type, ctx.typeChecker);
   const typeToSerialize = schemaExtraction?.outputType ?? type;
@@ -4693,7 +4613,7 @@ function extractExportItem(symbol, checker, entryFile, entrySourceFile) {
   const sourceFile = declaration.getSourceFile();
   const { line } = sourceFile.getLineAndCharacterOfPosition(declaration.getStart());
   const description = getDescriptionPreview(targetSymbol, checker);
-  const deprecated = isSymbolDeprecated(targetSymbol);
+  const { deprecated } = isSymbolDeprecated(targetSymbol);
   const reexport = isReexport || sourceFile !== entrySourceFile;
   return {
     name,
@@ -4705,37 +4625,6 @@ function extractExportItem(symbol, checker, entryFile, entrySourceFile) {
     ...reexport ? { reexport: true } : {}
   };
 }
-function getExportKind(declaration, type) {
-  if (ts12.isSourceFile(declaration)) {
-    return "namespace";
-  }
-  if (ts12.isFunctionDeclaration(declaration) || ts12.isFunctionExpression(declaration)) {
-    return "function";
-  }
-  if (ts12.isClassDeclaration(declaration)) {
-    return "class";
-  }
-  if (ts12.isInterfaceDeclaration(declaration)) {
-    return "interface";
-  }
-  if (ts12.isTypeAliasDeclaration(declaration)) {
-    return "type";
-  }
-  if (ts12.isEnumDeclaration(declaration)) {
-    return "enum";
-  }
-  if (ts12.isModuleDeclaration(declaration) || ts12.isNamespaceExport(declaration)) {
-    return "namespace";
-  }
-  if (ts12.isVariableDeclaration(declaration)) {
-    const callSigs = type.getCallSignatures();
-    if (callSigs.length > 0) {
-      return "function";
-    }
-    return "variable";
-  }
-  return "variable";
-}
 function getDescriptionPreview(symbol, checker) {
   const docs = symbol.getDocumentationComment(checker);
   if (docs.length === 0)
@@ -5120,10 +5009,16 @@ async function extractStandardSchemasFromTs(tsFilePath, options = {}) {
           result.errors.push(`Failed to parse extraction output: ${e}`);
         }
         if (stdoutTruncated) {
-          result.warnings.push({ code: "OUTPUT_TRUNCATED", message: "stdout exceeded 10MB buffer limit" });
+          result.warnings.push({
+            code: "OUTPUT_TRUNCATED",
+            message: "stdout exceeded 10MB buffer limit"
+          });
         }
         if (stderrTruncated) {
-          result.warnings.push({ code: "OUTPUT_TRUNCATED", message: "stderr exceeded 10MB buffer limit" });
+          result.warnings.push({
+            code: "OUTPUT_TRUNCATED",
+            message: "stderr exceeded 10MB buffer limit"
+          });
         }
         resolve2(result);
       });
@@ -5274,10 +5169,16 @@ async function extractStandardSchemas(compiledJsPath, options = {}) {
         result.errors.push(`Failed to parse extraction output: ${e}`);
       }
       if (stdoutTruncated) {
-        result.warnings.push({ code: "OUTPUT_TRUNCATED", message: "stdout exceeded 10MB buffer limit" });
+        result.warnings.push({
+          code: "OUTPUT_TRUNCATED",
+          message: "stdout exceeded 10MB buffer limit"
+        });
       }
       if (stderrTruncated) {
-        result.warnings.push({ code: "OUTPUT_TRUNCATED", message: "stderr exceeded 10MB buffer limit" });
+        result.warnings.push({
+          code: "OUTPUT_TRUNCATED",
+          message: "stderr exceeded 10MB buffer limit"
+        });
       }
       resolve2(result);
     });
@@ -5375,30 +5276,6 @@ function findPackageJson(resolvedPath, packageName) {
   }
   return;
 }
-function determineExportKind(symbol, checker) {
-  const declarations = symbol.declarations ?? [];
-  const decl = declarations[0];
-  if (!decl)
-    return "variable";
-  if (ts14.isFunctionDeclaration(decl) || ts14.isFunctionExpression(decl))
-    return "function";
-  if (ts14.isClassDeclaration(decl))
-    return "class";
-  if (ts14.isInterfaceDeclaration(decl))
-    return "interface";
-  if (ts14.isTypeAliasDeclaration(decl))
-    return "type";
-  if (ts14.isEnumDeclaration(decl))
-    return "enum";
-  if (ts14.isModuleDeclaration(decl))
-    return "namespace";
-  if (ts14.isVariableDeclaration(decl)) {
-    const type = checker.getTypeAtLocation(decl);
-    if (type.getCallSignatures().length > 0)
-      return "function";
-  }
-  return "variable";
-}
 function extractExternalExport(exportName, resolvedModule, program, ctx, visited) {
   const key = `${resolvedModule.resolvedPath}:${exportName}`;
   if (visited.has(key)) {
@@ -5434,7 +5311,8 @@ function extractExternalExport(exportName, resolvedModule, program, ctx, visited
       resolvedSymbol = aliased;
     }
   }
-  const kind = determineExportKind(resolvedSymbol, checker);
+  const decl = (resolvedSymbol.declarations ?? [])[0];
+  const kind = decl ? getExportKind(decl, checker.getTypeAtLocation(decl)) : "variable";
   const docComment = resolvedSymbol.getDocumentationComment(checker);
   const description = docComment.length > 0 ? docComment.map((c) => c.text).join(`
 `) : undefined;
@@ -5453,24 +5331,7 @@ function extractExternalExport(exportName, resolvedModule, program, ctx, visited
     const type = checker.getTypeOfSymbol(resolvedSymbol);
     const callSignatures = type.getCallSignatures();
     if (callSignatures.length > 0) {
-      const signatures = callSignatures.map((sig, index) => {
-        const params = extractParameters(sig, ctx);
-        const returnType = checker.getReturnTypeOfSignature(sig);
-        registerReferencedTypes(returnType, ctx);
-        const returnSchema = buildSchema(returnType, checker, ctx);
-        const sigDoc = getJSDocForSignature(sig, checker);
-        const sigTypeParams = extractTypeParametersFromSignature(sig, checker);
-        return {
-          parameters: params,
-          returns: { schema: returnSchema },
-          ...sigDoc.description && { description: sigDoc.description },
-          ...sigDoc.tags.length > 0 && { tags: sigDoc.tags },
-          ...sigDoc.examples.length > 0 && { examples: sigDoc.examples },
-          ...sigTypeParams && { typeParameters: sigTypeParams },
-          ...callSignatures.length > 1 && { overloadIndex: index }
-        };
-      });
-      specExport.signatures = signatures;
+      specExport.signatures = buildSignatures(callSignatures, checker, ctx);
     }
   } else if (kind === "interface" || kind === "type" || kind === "class") {
     const type = checker.getTypeOfSymbol(resolvedSymbol);
@@ -5565,6 +5426,21 @@ class CacheManager {
     };
     this.cache.set(key, entry);
   }
+  getOrCompute(key, compute) {
+    const entry = this.cache.get(key);
+    if (entry) {
+      if (entry.expiresAt && Date.now() > entry.expiresAt) {
+        this.cache.delete(key);
+      } else {
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.value;
+      }
+    }
+    const value = compute();
+    this.set(key, value);
+    return value;
+  }
   delete(key) {
     return this.cache.delete(key);
   }
@@ -5604,55 +5480,36 @@ function getRegexCache() {
   return regexCache;
 }
 function findTypeDefinition(typeName, program, sourceFile) {
-  if (typeDefinitionCache.has(typeName)) {
-    return typeDefinitionCache.get(typeName);
-  }
-  const checker = program.getTypeChecker();
-  const findInNode = (node) => {
-    if ((ts15.isInterfaceDeclaration(node) || ts15.isTypeAliasDeclaration(node) || ts15.isClassDeclaration(node) || ts15.isEnumDeclaration(node)) && node.name?.text === typeName) {
-      const sf = node.getSourceFile();
-      return sf.fileName;
-    }
-    return ts15.forEachChild(node, findInNode);
-  };
-  const entryResult = findInNode(sourceFile);
-  if (entryResult) {
-    typeDefinitionCache.set(typeName, entryResult);
-    return entryResult;
-  }
-  for (const sf of program.getSourceFiles()) {
-    if (sf.isDeclarationFile && !sf.fileName.includes("node_modules")) {
-      const result = findInNode(sf);
-      if (result) {
-        typeDefinitionCache.set(typeName, result);
-        return result;
+  return typeDefinitionCache.getOrCompute(typeName, () => {
+    const checker = program.getTypeChecker();
+    const findInNode = (node) => {
+      if ((ts15.isInterfaceDeclaration(node) || ts15.isTypeAliasDeclaration(node) || ts15.isClassDeclaration(node) || ts15.isEnumDeclaration(node)) && node.name?.text === typeName) {
+        return node.getSourceFile().fileName;
+      }
+      return ts15.forEachChild(node, findInNode);
+    };
+    const entryResult = findInNode(sourceFile);
+    if (entryResult)
+      return entryResult;
+    for (const sf of program.getSourceFiles()) {
+      if (sf.isDeclarationFile && !sf.fileName.includes("node_modules")) {
+        const result = findInNode(sf);
+        if (result)
+          return result;
       }
     }
-  }
-  const symbol = checker.resolveName(typeName, sourceFile, ts15.SymbolFlags.Type, false);
-  if (symbol?.declarations?.[0]) {
-    const result = symbol.declarations[0].getSourceFile().fileName;
-    typeDefinitionCache.set(typeName, result);
-    return result;
-  }
-  typeDefinitionCache.set(typeName, undefined);
-  return;
+    const symbol = checker.resolveName(typeName, sourceFile, ts15.SymbolFlags.Type, false);
+    return symbol?.declarations?.[0]?.getSourceFile().fileName;
+  });
 }
 function hasInternalTag(typeName, program, sourceFile) {
-  const cached = internalTagCache.get(typeName);
-  if (cached !== undefined) {
-    return cached;
-  }
-  const checker = program.getTypeChecker();
-  const symbol = checker.resolveName(typeName, sourceFile, ts15.SymbolFlags.Type, false);
-  if (!symbol) {
-    internalTagCache.set(typeName, false);
-    return false;
-  }
-  const jsTags = symbol.getJsDocTags();
-  const isInternal = jsTags.some((tag) => tag.name === "internal");
-  internalTagCache.set(typeName, isInternal);
-  return isInternal;
+  return internalTagCache.getOrCompute(typeName, () => {
+    const checker = program.getTypeChecker();
+    const symbol = checker.resolveName(typeName, sourceFile, ts15.SymbolFlags.Type, false);
+    if (!symbol)
+      return false;
+    return symbol.getJsDocTags().some((tag) => tag.name === "internal");
+  });
 }
 
 // src/builder/verification.ts
@@ -6017,7 +5874,7 @@ async function extract(options) {
           }
           continue;
         }
-        const exp = serializeDeclaration2(declaration, symbol, targetSymbol, exportName, ctx, isTypeOnly);
+        const exp = serializeDeclaration2(declaration, symbol, exportName, ctx, isTypeOnly);
         if (exp) {
           exports.push(exp);
           tracker.status = "success";
@@ -6150,7 +6007,7 @@ async function extract(options) {
     clearTypeDefinitionCache();
   }
 }
-function serializeDeclaration2(declaration, exportSymbol, _targetSymbol, exportName, ctx, isTypeOnly = false) {
+function serializeDeclaration2(declaration, exportSymbol, exportName, ctx, isTypeOnly = false) {
   let result = null;
   if (ts16.isFunctionDeclaration(declaration)) {
     result = serializeFunctionExport(declaration, ctx);
@@ -6172,33 +6029,7 @@ function serializeDeclaration2(declaration, exportSymbol, _targetSymbol, exportN
         result = serializeVariable(declaration, varStatement, ctx);
       }
     }
-  } else if (ts16.isNamespaceExport(declaration) || ts16.isModuleDeclaration(declaration)) {
-    try {
-      result = serializeNamespaceExport(exportSymbol, exportName, ctx);
-    } catch {
-      result = {
-        id: exportName,
-        name: exportName,
-        kind: "namespace",
-        tags: [],
-        members: [],
-        examples: []
-      };
-    }
-  } else if (ts16.isNamespaceImport(declaration)) {
-    try {
-      result = serializeNamespaceExport(exportSymbol, exportName, ctx);
-    } catch {
-      result = {
-        id: exportName,
-        name: exportName,
-        kind: "namespace",
-        tags: [],
-        members: [],
-        examples: []
-      };
-    }
-  } else if (ts16.isSourceFile(declaration)) {
+  } else if (ts16.isNamespaceExport(declaration) || ts16.isModuleDeclaration(declaration) || ts16.isNamespaceImport(declaration) || ts16.isSourceFile(declaration)) {
     try {
       result = serializeNamespaceExport(exportSymbol, exportName, ctx);
     } catch {
@@ -6289,23 +6120,7 @@ function serializeNamespaceMember(symbol, memberName, ctx) {
 `) || undefined;
   let signatures;
   if (kind === "function" && callSignatures.length > 0) {
-    signatures = callSignatures.map((sig, index) => {
-      const params = extractParameters(sig, ctx);
-      const returnType = checker.getReturnTypeOfSignature(sig);
-      registerReferencedTypes(returnType, ctx);
-      const returnSchema = buildSchema(returnType, ctx.typeChecker, ctx);
-      const sigDoc = getJSDocForSignature(sig, checker);
-      const sigTypeParams = extractTypeParametersFromSignature(sig, ctx.typeChecker);
-      return {
-        parameters: params,
-        returns: { schema: returnSchema },
-        ...sigDoc.description ? { description: sigDoc.description } : {},
-        ...sigDoc.tags.length > 0 ? { tags: sigDoc.tags } : {},
-        ...sigDoc.examples.length > 0 ? { examples: sigDoc.examples } : {},
-        ...sigTypeParams ? { typeParameters: sigTypeParams } : {},
-        ...callSignatures.length > 1 ? { overloadIndex: index } : {}
-      };
-    });
+    signatures = buildSignatures(callSignatures, checker, ctx);
   }
   let schema;
   if (kind !== "function") {
@@ -6423,11 +6238,12 @@ async function getPackageMeta(entryFile, baseDir) {
 // src/primitives/spec.ts
 var extractSpec = extract;
 // src/types/utils.ts
+import ts17 from "typescript";
 function isExported(node) {
   const modifiers = node.modifiers;
   if (!modifiers)
     return false;
-  return modifiers.some((m) => m.kind === 95);
+  return modifiers.some((m) => m.kind === ts17.SyntaxKind.ExportKeyword);
 }
 function getNodeName(node) {
   if ("name" in node && node.name) {
@@ -6501,6 +6317,7 @@ export {
   getMethods,
   getMemberBadges,
   getJSDocComment,
+  getExportKind,
   getExport,
   getDeprecationMessage,
   toMarkdown as generateDocs,
@@ -6539,6 +6356,7 @@ export {
   analyzeSpec,
   TypeRegistry,
   QueryBuilder,
+  PRIMITIVES,
   CacheManager,
   CONFIG_FILENAME,
   BUILTIN_TYPE_SCHEMAS,

package/dist/shared/{chunk-skapcfq1.js → chunk-4fgxg5jj.js}

@@ -98,6 +98,9 @@ function formatBadges(badges) {
 }
 
 // src/core/query.ts
+import {
+  DISPLAY_KIND_ORDER
+} from "@openpkg-ts/spec";
 function formatFunctionSchema(schema) {
   const sigs = schema["x-ts-signatures"];
   if (!sigs?.length)
@@ -171,6 +174,14 @@ function formatSchema(schema, options) {
       }
       return "object";
     }
+    if ("const" in schema && schema.const !== undefined) {
+      const v = schema.const;
+      return withPackage(typeof v === "string" ? `"${v}"` : String(v));
+    }
+    if ("enum" in schema && Array.isArray(schema.enum)) {
+      const vals = schema.enum.map((v) => typeof v === "string" ? `"${v}"` : String(v));
+      return withPackage(vals.join(" | "));
+    }
     if ("type" in schema && typeof schema.type === "string") {
       return withPackage(schema.type);
     }
@@ -279,6 +290,22 @@ function groupByVisibility(members) {
 function sortByName(items) {
   return [...items].sort((a, b) => a.name.localeCompare(b.name));
 }
+var KIND_ORDER = [
+  ...DISPLAY_KIND_ORDER,
+  "namespace",
+  "module",
+  "reference",
+  "external"
+];
+function groupByKind(items) {
+  const groups = {};
+  for (const item of items) {
+    if (!groups[item.kind])
+      groups[item.kind] = [];
+    groups[item.kind].push(item);
+  }
+  return groups;
+}
 function formatConditionalType(condType) {
   const check = formatSchema(condType.checkType);
   const ext = formatSchema(condType.extendsType);
@@ -303,6 +330,16 @@ function formatMappedType(mappedType) {
   }
   return `{ ${readonlyMod}[${keyStr}]${optionalMod}: ${valueStr} }`;
 }
+function findExport(spec, name) {
+  const exp = spec.exports.find((e) => e.name === name || e.id === name);
+  if (!exp)
+    throw new Error(`Export not found: ${name}`);
+  return exp;
+}
+function filterExports(spec, names) {
+  const ids = new Set(names);
+  return spec.exports.filter((e) => ids.has(e.name) || ids.has(e.id));
+}
 
 // src/core/search.ts
 var defaultSlugify = (name) => name.toLowerCase().replace(/[^a-z0-9]+/g, "-");
@@ -388,7 +425,7 @@ function buildContent(exp, options = {}) {
   }
   return parts.join(" ");
 }
-function createSearchRecord(exp, _packageName, options = {}) {
+function createSearchRecord(exp, options = {}) {
   const { baseUrl = "/api", slugify = defaultSlugify } = options;
   return {
     id: exp.id,
@@ -403,7 +440,7 @@ function createSearchRecord(exp, _packageName, options = {}) {
   };
 }
 function toSearchIndex(spec, options = {}) {
-  const records = spec.exports.map((exp) => createSearchRecord(exp, spec.meta.name, options));
+  const records = spec.exports.map((exp) => createSearchRecord(exp, options));
   return {
     records,
     version: spec.meta.version || "0.0.0",
@@ -549,4 +586,4 @@ function query(spec) {
   return new QueryBuilder(spec);
 }
 
-export { hasDeprecatedTag, getDeprecationMessage, findMissingParamDocs, analyzeSpec, getMemberBadges, formatBadges, formatSchema, formatTypeParameters, formatParameters, formatReturnType, buildSignatureString, resolveTypeRef, isMethod, isProperty, getMethods, getProperties, groupByVisibility, sortByName, formatConditionalType, formatMappedType, toSearchIndex, toPagefindRecords, toAlgoliaRecords, toSearchIndexJSON, QueryBuilder, query };
+export { hasDeprecatedTag, getDeprecationMessage, findMissingParamDocs, analyzeSpec, getMemberBadges, formatBadges, formatSchema, formatTypeParameters, formatParameters, formatReturnType, buildSignatureString, resolveTypeRef, isMethod, isProperty, getMethods, getProperties, groupByVisibility, sortByName, KIND_ORDER, groupByKind, formatConditionalType, formatMappedType, findExport, filterExports, toSearchIndex, toPagefindRecords, toAlgoliaRecords, toSearchIndexJSON, QueryBuilder, query };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/sdk",
-  "version": "0.35.0",
+  "version": "0.35.1",
   "description": "TypeScript API extraction SDK - programmatic primitives for OpenPkg specs",
   "keywords": [
     "openpkg",
@@ -42,7 +42,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@openpkg-ts/spec": "^0.34.1",
+    "@openpkg-ts/spec": "^0.35.1",
     "picomatch": "4.0.3",
     "typescript": "^5.0.0"
   },