@openpkg-ts/sdk 0.37.1 → 0.38.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Ryan Waits
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -733,8 +733,7 @@ declare function loadSpec(spec: OpenPkg8): DocsInstance;
 * Creates a docs instance for querying and rendering API documentation.
 *
 * Render methods (toMarkdown, toHTML, toJSON, toNavigation) return strings or
-* plain data objects — not React components. For React UI components, see the
-* `@openpkg-ts/registry` package.
+* plain data objects — not React components. Bring your own UI components.
 *
 * @example
 * ```ts
@@ -1038,30 +1037,7 @@ declare class QueryBuilder {
 * Create a query builder for the given spec
 */
 declare function query(spec: OpenPkg10): QueryBuilder;
-import { OpenPkg as OpenPkg11 } from "@openpkg-ts/spec";
-interface ReactLayoutOptions {
-	/** Output directory for generated files */
-	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 SpecExportKind7 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg11, SpecExportKind as SpecExportKind7 } from "@openpkg-ts/spec";
 type FilterCriteria = {
 	/** Filter by kinds */
 	kinds?: SpecExportKind7[];
@@ -1086,7 +1062,7 @@ type FilterCriteria = {
 };
 type FilterResult = {
 	/** New spec with only matched exports (immutable) */
-	spec: OpenPkg12;
+	spec: OpenPkg11;
 	/** Number of exports that matched */
 	matched: number;
 	/** Total number of exports in original spec */
@@ -1102,7 +1078,7 @@ type FilterResult = {
 * @param criteria - Filter criteria (empty criteria matches all)
 * @returns FilterResult with new spec, matched count, total count
 */
-declare function filterSpec(spec: OpenPkg12, criteria: FilterCriteria): FilterResult;
+declare function filterSpec(spec: OpenPkg11, criteria: FilterCriteria): FilterResult;
 import { SpecExport as SpecExport6, SpecType as SpecType3 } from "@openpkg-ts/spec";
 interface GetExportOptions {
 	/** Entry point file path */
@@ -1259,7 +1235,7 @@ declare function getSourceLocation(node: ts4.Node, sourceFile: ts4.SourceFile):
 * - @param {type} paramName - type annotation format
 */
 declare function getParamDescription(propertyName: string, jsdocTags: readonly ts4.JSDocTag[], inferredAlias?: string): string | undefined;
-type DeclarationWithTypeParams = ts4.FunctionDeclaration | ts4.ClassDeclaration | ts4.InterfaceDeclaration | ts4.TypeAliasDeclaration | ts4.MethodDeclaration | ts4.ArrowFunction;
+type DeclarationWithTypeParams = ts4.FunctionDeclaration | ts4.ClassDeclaration | ts4.InterfaceDeclaration | ts4.TypeAliasDeclaration | ts4.MethodDeclaration | ts4.ArrowFunction | ts4.FunctionExpression;
 /**
 * Extract type parameters from declarations like `<T extends Base, K = Default>`
 * Also captures variance annotations (in/out) and const modifier.
@@ -1274,7 +1250,7 @@ declare function isSymbolDeprecated(symbol: ts4.Symbol | undefined): {
 	reason?: string;
 };
 /** Classify a declaration node into an kind */
-declare function getExportKind(declaration: ts4.Declaration, type: ts4.Type): SpecExportKind8;
+declare function getExportKind(declaration: ts4.Declaration, type: ts4.Type): Exclude<SpecExportKind8, "module" | "reference" | "external">;
 /**
 * Target version for JSON Schema generation.
 * @see https://standardschema.dev/json-schema
@@ -1791,4 +1767,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, 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, STRING_PROTOTYPE_METHODS, ReactLayoutOptions, QueryBuilder, ProjectExtractionOutput, ProjectExtractionInfo, ProgramResult, ProgramOptions, PagefindRecord, PRIMITIVES, OpenpkgConfig, NormalizeOptions, NavOptions, NavItem, NavGroup, NavFormat, NUMBER_PROTOTYPE_METHODS, 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, 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, STRING_PROTOTYPE_METHODS, QueryBuilder, ProjectExtractionOutput, ProjectExtractionInfo, ProgramResult, ProgramOptions, PagefindRecord, PRIMITIVES, OpenpkgConfig, NormalizeOptions, NavOptions, NavItem, NavGroup, NavFormat, NUMBER_PROTOTYPE_METHODS, 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

@@ -1191,221 +1191,6 @@ function extractModuleName(exp) {
   }
   return;
 }
-// src/render/react.ts
-import * as fs3 from "node:fs";
-import * as path2 from "node:path";
-function generateFullLayout(spec, componentsPath) {
-  const pkgName = spec.meta.name;
-  return `'use client';
-
-import type { OpenPkg, SpecExport } from '@openpkg-ts/spec';
-import spec from './openpkg.json';
-
-// Add components via: openpkg docs add function-section class-section interface-section
-// Then uncomment the imports below and customize as needed.
-
-// import { FunctionSection } from '${componentsPath}/function-section';
-// import { ClassSection } from '${componentsPath}/class-section';
-// import { InterfaceSection } from '${componentsPath}/interface-section';
-// import { VariableSection } from '${componentsPath}/variable-section';
-// import { EnumSection } from '${componentsPath}/enum-section';
-
-/**
- * Renders a single export based on its kind.
- * Customize this to match your design system.
- */
-function ExportSection({ exp }: { exp: SpecExport }) {
-  // Uncomment the switch once you've added components:
-  // switch (exp.kind) {
-  //   case 'function':
-  //     return <FunctionSection key={exp.id} export={exp} spec={spec as OpenPkg} />;
-  //   case 'class':
-  //     return <ClassSection key={exp.id} export={exp} spec={spec as OpenPkg} />;
-  //   case 'interface':
-  //   case 'type':
-  //     return <InterfaceSection key={exp.id} export={exp} spec={spec as OpenPkg} />;
-  //   case 'variable':
-  //     return <VariableSection key={exp.id} export={exp} spec={spec as OpenPkg} />;
-  //   case 'enum':
-  //     return <EnumSection key={exp.id} export={exp} spec={spec as OpenPkg} />;
-  //   default:
-  //     return null;
-  // }
-
-  // Placeholder: replace with component imports above
-  return (
-    <section id={exp.id} className="py-8 border-b">
-      <h2 className="text-xl font-semibold">{exp.name}</h2>
-      <p className="text-muted-foreground">{exp.description || 'No description'}</p>
-      <code className="text-sm">{exp.kind}</code>
-    </section>
-  );
-}
-
-/**
- * Full API Reference Page for ${pkgName}
- *
- * This layout renders all exports on a single page.
- * Customize the grouping, styling, and components to match your docs.
- */
-export default function APIReferencePage() {
-  const typedSpec = spec as OpenPkg;
-  const exports = typedSpec.exports;
-
-  // Group exports by kind
-  const functions = exports.filter((e) => e.kind === 'function');
-  const classes = exports.filter((e) => e.kind === 'class');
-  const interfaces = exports.filter((e) => e.kind === 'interface' || e.kind === 'type');
-  const variables = exports.filter((e) => e.kind === 'variable');
-  const enums = exports.filter((e) => e.kind === 'enum');
-
-  return (
-    <div className="max-w-4xl mx-auto px-4 py-8">
-      <header className="mb-12">
-        <h1 className="text-3xl font-bold">{typedSpec.meta.name}</h1>
-        {typedSpec.meta.description && (
-          <p className="text-lg text-muted-foreground mt-2">{typedSpec.meta.description}</p>
-        )}
-        {typedSpec.meta.version && (
-          <p className="text-sm text-muted-foreground">v{typedSpec.meta.version}</p>
-        )}
-      </header>
-
-      {functions.length > 0 && (
-        <section className="mb-12">
-          <h2 className="text-2xl font-bold mb-6">Functions</h2>
-          {functions.map((exp) => (
-            <ExportSection key={exp.id} exp={exp} />
-          ))}
-        </section>
-      )}
-
-      {classes.length > 0 && (
-        <section className="mb-12">
-          <h2 className="text-2xl font-bold mb-6">Classes</h2>
-          {classes.map((exp) => (
-            <ExportSection key={exp.id} exp={exp} />
-          ))}
-        </section>
-      )}
-
-      {interfaces.length > 0 && (
-        <section className="mb-12">
-          <h2 className="text-2xl font-bold mb-6">Types & Interfaces</h2>
-          {interfaces.map((exp) => (
-            <ExportSection key={exp.id} exp={exp} />
-          ))}
-        </section>
-      )}
-
-      {variables.length > 0 && (
-        <section className="mb-12">
-          <h2 className="text-2xl font-bold mb-6">Variables</h2>
-          {variables.map((exp) => (
-            <ExportSection key={exp.id} exp={exp} />
-          ))}
-        </section>
-      )}
-
-      {enums.length > 0 && (
-        <section className="mb-12">
-          <h2 className="text-2xl font-bold mb-6">Enums</h2>
-          {enums.map((exp) => (
-            <ExportSection key={exp.id} exp={exp} />
-          ))}
-        </section>
-      )}
-    </div>
-  );
-}
-
-export { spec };
-`;
-}
-function generateIndexLayout(spec, componentsPath) {
-  const pkgName = spec.meta.name;
-  return `'use client';
-
-import type { OpenPkg } from '@openpkg-ts/spec';
-import spec from './openpkg.json';
-
-// Add the export-card component: openpkg docs add export-card
-// import { ExportCard } from '${componentsPath}/export-card';
-
-/**
- * API Reference Index Page for ${pkgName}
- *
- * Links to individual export pages. Best with file-based routing.
- * Customize the card component and links to match your docs.
- */
-export default function APIReferenceIndex() {
-  const typedSpec = spec as OpenPkg;
-  const exports = typedSpec.exports;
-
-  // Group exports by kind
-  const groups = [
-    { title: 'Functions', items: exports.filter((e) => e.kind === 'function') },
-    { title: 'Classes', items: exports.filter((e) => e.kind === 'class') },
-    { title: 'Types & Interfaces', items: exports.filter((e) => e.kind === 'interface' || e.kind === 'type') },
-    { title: 'Variables', items: exports.filter((e) => e.kind === 'variable') },
-    { title: 'Enums', items: exports.filter((e) => e.kind === 'enum') },
-  ].filter((g) => g.items.length > 0);
-
-  return (
-    <div className="max-w-4xl mx-auto px-4 py-8">
-      <header className="mb-12">
-        <h1 className="text-3xl font-bold">{typedSpec.meta.name}</h1>
-        {typedSpec.meta.description && (
-          <p className="text-lg text-muted-foreground mt-2">{typedSpec.meta.description}</p>
-        )}
-      </header>
-
-      {groups.map((group) => (
-        <section key={group.title} className="mb-12">
-          <h2 className="text-2xl font-bold mb-6">{group.title}</h2>
-          <div className="grid gap-4 md:grid-cols-2">
-            {group.items.map((exp) => (
-              // Replace with ExportCard once installed:
-              // <ExportCard key={exp.id} export={exp} href={\`/api/\${exp.name}\`} />
-              <a
-                key={exp.id}
-                href={\`/api/\${exp.name}\`}
-                className="block p-4 border rounded-lg hover:bg-muted transition-colors"
-              >
-                <h3 className="font-semibold">{exp.name}</h3>
-                <p className="text-sm text-muted-foreground line-clamp-2">
-                  {exp.description || 'No description'}
-                </p>
-                <span className="text-xs bg-muted px-2 py-1 rounded mt-2 inline-block">
-                  {exp.kind}
-                </span>
-              </a>
-            ))}
-          </div>
-        </section>
-      ))}
-    </div>
-  );
-}
-
-export { spec };
-`;
-}
-async function toReact(spec, options) {
-  const { outDir, variant = "full", componentsPath = "@/components/api" } = options;
-  if (!fs3.existsSync(outDir)) {
-    fs3.mkdirSync(outDir, { recursive: true });
-  }
-  const specPath = path2.join(outDir, "openpkg.json");
-  fs3.writeFileSync(specPath, JSON.stringify(spec, null, 2));
-  const layoutContent = variant === "index" ? generateIndexLayout(spec, componentsPath) : generateFullLayout(spec, componentsPath);
-  const layoutPath = path2.join(outDir, "page.tsx");
-  fs3.writeFileSync(layoutPath, layoutContent);
-}
-function toReactString(spec, options = {}) {
-  const { variant = "full", componentsPath = "@/components/api" } = options;
-  return variant === "index" ? generateIndexLayout(spec, componentsPath) : generateFullLayout(spec, componentsPath);
-}
 // src/primitives/filter.ts
 function matchesExport(exp, criteria) {
   if (criteria.kinds && criteria.kinds.length > 0) {
@@ -1828,8 +1613,8 @@ function getExportKind(declaration, type) {
 }
 
 // src/compiler/program.ts
-import * as fs4 from "node:fs";
-import * as path3 from "node:path";
+import * as fs3 from "node:fs";
+import * as path2 from "node:path";
 import ts2 from "typescript";
 function isJsFile(file) {
   return /\.(js|mjs|cjs|jsx)$/.test(file);
@@ -1855,16 +1640,16 @@ function resolveProjectReferences(configPath, parsedConfig) {
   if (!parsedConfig.projectReferences?.length) {
     return additionalFiles;
   }
-  const configDir = path3.dirname(configPath);
+  const configDir = path2.dirname(configPath);
   for (const ref of parsedConfig.projectReferences) {
-    const refPath = path3.resolve(configDir, ref.path);
-    const refConfigPath = fs4.existsSync(path3.join(refPath, "tsconfig.json")) ? path3.join(refPath, "tsconfig.json") : refPath;
-    if (!fs4.existsSync(refConfigPath))
+    const refPath = path2.resolve(configDir, ref.path);
+    const refConfigPath = fs3.existsSync(path2.join(refPath, "tsconfig.json")) ? path2.join(refPath, "tsconfig.json") : refPath;
+    if (!fs3.existsSync(refConfigPath))
       continue;
     const refConfigFile = ts2.readConfigFile(refConfigPath, ts2.sys.readFile);
     if (refConfigFile.error)
       continue;
-    const refParsed = ts2.parseJsonConfigFileContent(refConfigFile.config, ts2.sys, path3.dirname(refConfigPath));
+    const refParsed = ts2.parseJsonConfigFileContent(refConfigFile.config, ts2.sys, path2.dirname(refConfigPath));
     additionalFiles.push(...refParsed.fileNames);
   }
   return additionalFiles;
@@ -1897,10 +1682,10 @@ function buildWorkspaceMap(baseDir) {
   let rootDir;
   let workspaceGlobs = [];
   for (let i = 0;i < 10; i++) {
-    const pnpmPath = path3.join(currentDir, "pnpm-workspace.yaml");
-    if (fs4.existsSync(pnpmPath)) {
+    const pnpmPath = path2.join(currentDir, "pnpm-workspace.yaml");
+    if (fs3.existsSync(pnpmPath)) {
       try {
-        const yamlContent = fs4.readFileSync(pnpmPath, "utf-8");
+        const yamlContent = fs3.readFileSync(pnpmPath, "utf-8");
         workspaceGlobs = parsePnpmWorkspace(yamlContent);
         if (workspaceGlobs.length > 0) {
           rootDir = currentDir;
@@ -1908,10 +1693,10 @@ function buildWorkspaceMap(baseDir) {
         }
       } catch {}
     }
-    const pkgPath = path3.join(currentDir, "package.json");
-    if (fs4.existsSync(pkgPath)) {
+    const pkgPath = path2.join(currentDir, "package.json");
+    if (fs3.existsSync(pkgPath)) {
       try {
-        const pkg = JSON.parse(fs4.readFileSync(pkgPath, "utf-8"));
+        const pkg = JSON.parse(fs3.readFileSync(pkgPath, "utf-8"));
         if (pkg.workspaces) {
           rootDir = currentDir;
           workspaceGlobs = Array.isArray(pkg.workspaces) ? pkg.workspaces : pkg.workspaces?.packages || [];
@@ -1919,7 +1704,7 @@ function buildWorkspaceMap(baseDir) {
         }
       } catch {}
     }
-    const parent = path3.dirname(currentDir);
+    const parent = path2.dirname(currentDir);
     if (parent === currentDir)
       break;
     currentDir = parent;
@@ -1928,21 +1713,21 @@ function buildWorkspaceMap(baseDir) {
     return;
   const packages = new Map;
   for (const glob of workspaceGlobs) {
-    const globDir = path3.join(rootDir, glob.replace(/\/\*$/, ""));
-    if (!fs4.existsSync(globDir) || !fs4.statSync(globDir).isDirectory())
+    const globDir = path2.join(rootDir, glob.replace(/\/\*$/, ""));
+    if (!fs3.existsSync(globDir) || !fs3.statSync(globDir).isDirectory())
       continue;
-    const entries = fs4.readdirSync(globDir, { withFileTypes: true });
+    const entries = fs3.readdirSync(globDir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory())
         continue;
-      const pkgDir = path3.join(globDir, entry.name);
-      const pkgJsonPath = path3.join(pkgDir, "package.json");
-      if (!fs4.existsSync(pkgJsonPath))
+      const pkgDir = path2.join(globDir, entry.name);
+      const pkgJsonPath = path2.join(pkgDir, "package.json");
+      if (!fs3.existsSync(pkgJsonPath))
         continue;
       try {
-        const pkg = JSON.parse(fs4.readFileSync(pkgJsonPath, "utf-8"));
+        const pkg = JSON.parse(fs3.readFileSync(pkgJsonPath, "utf-8"));
         if (pkg.name) {
-          const srcDir = fs4.existsSync(path3.join(pkgDir, "src")) ? path3.join(pkgDir, "src") : pkgDir;
+          const srcDir = fs3.existsSync(path2.join(pkgDir, "src")) ? path2.join(pkgDir, "src") : pkgDir;
           packages.set(pkg.name, srcDir);
         }
       } catch {}
@@ -1952,7 +1737,7 @@ function buildWorkspaceMap(baseDir) {
 }
 function createProgram({
   entryFile,
-  baseDir = path3.dirname(entryFile),
+  baseDir = path2.dirname(entryFile),
   content
 }) {
   let configPath = ts2.findConfigFile(baseDir, ts2.sys.fileExists, "tsconfig.json");
@@ -1963,7 +1748,7 @@ function createProgram({
   let additionalRootFiles = [];
   if (configPath) {
     const configFile = ts2.readConfigFile(configPath, ts2.sys.readFile);
-    const parsedConfig = ts2.parseJsonConfigFileContent(configFile.config, ts2.sys, path3.dirname(configPath));
+    const parsedConfig = ts2.parseJsonConfigFileContent(configFile.config, ts2.sys, path2.dirname(configPath));
     compilerOptions = { ...compilerOptions, ...parsedConfig.options };
     additionalRootFiles = resolveProjectReferences(configPath, parsedConfig);
     const sourceFiles = parsedConfig.fileNames.filter((f) => !f.includes(".test.") && !f.includes(".spec.") && !f.includes("/dist/") && !f.includes("/node_modules/"));
@@ -1991,8 +1776,8 @@ function createProgram({
       return moduleNames.map((moduleName) => {
         const srcDir = workspaceMap.packages.get(moduleName);
         if (srcDir) {
-          const indexFile = path3.join(srcDir, "index.ts");
-          if (fs4.existsSync(indexFile)) {
+          const indexFile = path2.join(srcDir, "index.ts");
+          if (fs3.existsSync(indexFile)) {
             return { resolvedFileName: indexFile, isExternalLibraryImport: false };
           }
         }
@@ -4843,7 +4628,7 @@ function detectExternalPackage(symbol, checker) {
   return;
 }
 // src/primitives/list.ts
-import * as path4 from "node:path";
+import * as path3 from "node:path";
 import ts12 from "typescript";
 async function listExports(options) {
   const { entryFile, baseDir, content } = options;
@@ -4904,7 +4689,7 @@ function extractExportItem(symbol, checker, entryFile, entrySourceFile) {
     return {
       name,
       kind: "namespace",
-      file: path4.relative(path4.dirname(entryFile), declaration.fileName),
+      file: path3.relative(path3.dirname(entryFile), declaration.fileName),
       line: 1,
       reexport: true
     };
@@ -4918,7 +4703,7 @@ function extractExportItem(symbol, checker, entryFile, entrySourceFile) {
   return {
     name,
     kind,
-    file: path4.relative(path4.dirname(entryFile), sourceFile.fileName),
+    file: path3.relative(path3.dirname(entryFile), sourceFile.fileName),
     line: line + 1,
     ...description ? { description } : {},
     ...deprecated ? { deprecated: true } : {},
@@ -4939,8 +4724,8 @@ function getDescriptionPreview(symbol, checker) {
   return `${firstLine.slice(0, 77)}...`;
 }
 // src/builder/spec-builder.ts
-import * as fs7 from "node:fs";
-import * as path8 from "node:path";
+import * as fs6 from "node:fs";
+import * as path7 from "node:path";
 import { SCHEMA_URL, SCHEMA_VERSION } from "@openpkg-ts/spec";
 import ts16 from "typescript";
 
@@ -4976,9 +4761,9 @@ function resolveExportTarget2(symbol, checker) {
 
 // src/schema/standard-schema.ts
 import { spawn, spawnSync } from "node:child_process";
-import * as fs5 from "node:fs";
+import * as fs4 from "node:fs";
 import * as os from "node:os";
-import * as path5 from "node:path";
+import * as path4 from "node:path";
 var MAX_BUFFER_SIZE = 10 * 1024 * 1024;
 function isStandardJSONSchema(obj) {
   if (typeof obj !== "object" || obj === null)
@@ -5232,21 +5017,21 @@ async function extractStandardSchemasFromTs(tsFilePath, options = {}) {
     result.errors.push("No TypeScript runtime available. Install bun, tsx, or ts-node, or use Node 22+.");
     return result;
   }
-  if (!fs5.existsSync(tsFilePath)) {
+  if (!fs4.existsSync(tsFilePath)) {
     result.errors.push(`TypeScript file not found: ${tsFilePath}`);
     return result;
   }
   const tempDir = os.tmpdir();
-  const workerPath = path5.join(tempDir, `openpkg-extract-worker-${Date.now()}.ts`);
+  const workerPath = path4.join(tempDir, `openpkg-extract-worker-${Date.now()}.ts`);
   try {
-    fs5.writeFileSync(workerPath, TS_WORKER_SCRIPT);
+    fs4.writeFileSync(workerPath, TS_WORKER_SCRIPT);
     const optionsJson = JSON.stringify({ target, libraryOptions });
     const args = [...runtime.args, workerPath, tsFilePath, optionsJson];
     return await new Promise((resolve2) => {
       const child = spawn(runtime.cmd, args, {
         timeout,
         stdio: ["ignore", "pipe", "pipe"],
-        cwd: path5.dirname(tsFilePath)
+        cwd: path4.dirname(tsFilePath)
       });
       let stdout = "";
       let stderr = "";
@@ -5270,7 +5055,7 @@ async function extractStandardSchemasFromTs(tsFilePath, options = {}) {
       });
       child.on("close", (code) => {
         try {
-          fs5.unlinkSync(workerPath);
+          fs4.unlinkSync(workerPath);
         } catch (cleanupErr) {
           if (cleanupErr?.code !== "ENOENT") {
             result.warnings.push({ code: "CLEANUP_FAILED", message: String(cleanupErr) });
@@ -5324,7 +5109,7 @@ async function extractStandardSchemasFromTs(tsFilePath, options = {}) {
       });
       child.on("error", (err) => {
         try {
-          fs5.unlinkSync(workerPath);
+          fs4.unlinkSync(workerPath);
         } catch (cleanupErr) {
           if (cleanupErr?.code !== "ENOENT") {
             result.warnings.push({ code: "CLEANUP_FAILED", message: String(cleanupErr) });
@@ -5336,7 +5121,7 @@ async function extractStandardSchemasFromTs(tsFilePath, options = {}) {
     });
   } catch (e) {
     try {
-      fs5.unlinkSync(workerPath);
+      fs4.unlinkSync(workerPath);
     } catch (cleanupErr) {
       if (cleanupErr?.code !== "ENOENT") {
         result.warnings.push({ code: "CLEANUP_FAILED", message: String(cleanupErr) });
@@ -5347,12 +5132,12 @@ async function extractStandardSchemasFromTs(tsFilePath, options = {}) {
   }
 }
 function readTsconfigOutDir(baseDir) {
-  const tsconfigPath = path5.join(baseDir, "tsconfig.json");
+  const tsconfigPath = path4.join(baseDir, "tsconfig.json");
   try {
-    if (!fs5.existsSync(tsconfigPath)) {
+    if (!fs4.existsSync(tsconfigPath)) {
       return null;
     }
-    const content = fs5.readFileSync(tsconfigPath, "utf-8");
+    const content = fs4.readFileSync(tsconfigPath, "utf-8");
     const stripped = content.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "");
     const tsconfig = JSON.parse(stripped);
     if (tsconfig.compilerOptions?.outDir) {
@@ -5362,7 +5147,7 @@ function readTsconfigOutDir(baseDir) {
   return null;
 }
 function resolveCompiledPath(tsPath, baseDir) {
-  const relativePath = path5.relative(baseDir, tsPath);
+  const relativePath = path4.relative(baseDir, tsPath);
   const withoutExt = relativePath.replace(/\.tsx?$/, "");
   const srcPrefix = withoutExt.replace(/^src\//, "");
   const tsconfigOutDir = readTsconfigOutDir(baseDir);
@@ -5370,7 +5155,7 @@ function resolveCompiledPath(tsPath, baseDir) {
   const candidates = [];
   if (tsconfigOutDir) {
     for (const ext of extensions) {
-      candidates.push(path5.join(baseDir, tsconfigOutDir, `${srcPrefix}${ext}`));
+      candidates.push(path4.join(baseDir, tsconfigOutDir, `${srcPrefix}${ext}`));
     }
   }
   const commonOutDirs = ["dist", "build", "lib", "out"];
@@ -5378,21 +5163,21 @@ function resolveCompiledPath(tsPath, baseDir) {
     if (outDir === tsconfigOutDir)
       continue;
     for (const ext of extensions) {
-      candidates.push(path5.join(baseDir, outDir, `${srcPrefix}${ext}`));
+      candidates.push(path4.join(baseDir, outDir, `${srcPrefix}${ext}`));
     }
   }
   for (const ext of extensions) {
-    candidates.push(path5.join(baseDir, `${withoutExt}${ext}`));
+    candidates.push(path4.join(baseDir, `${withoutExt}${ext}`));
   }
   const workspaceMatch = baseDir.match(/^(.+\/packages\/[^/]+)$/);
   if (workspaceMatch) {
     const pkgRoot = workspaceMatch[1];
     for (const ext of extensions) {
-      candidates.push(path5.join(pkgRoot, "dist", `${srcPrefix}${ext}`));
+      candidates.push(path4.join(pkgRoot, "dist", `${srcPrefix}${ext}`));
     }
   }
   for (const candidate of candidates) {
-    if (fs5.existsSync(candidate)) {
+    if (fs4.existsSync(candidate)) {
       return candidate;
     }
   }
@@ -5405,7 +5190,7 @@ async function extractStandardSchemas(compiledJsPath, options = {}) {
     errors: [],
     warnings: []
   };
-  if (!fs5.existsSync(compiledJsPath)) {
+  if (!fs4.existsSync(compiledJsPath)) {
     result.errors.push(`Compiled JS not found: ${compiledJsPath}`);
     return result;
   }
@@ -5521,8 +5306,8 @@ async function extractStandardSchemasFromProject(entryFile, baseDir, options = {
 }
 
 // src/builder/external-resolver.ts
-import * as fs6 from "node:fs";
-import * as path6 from "node:path";
+import * as fs5 from "node:fs";
+import * as path5 from "node:path";
 import picomatch from "picomatch";
 import ts14 from "typescript";
 function matchesExternalPattern(packageName, include, exclude) {
@@ -5556,20 +5341,20 @@ function findPackageJson(resolvedPath, packageName) {
   const isScoped = packageName.startsWith("@");
   const packageParts = isScoped ? packageName.split("/").slice(0, 2) : [packageName.split("/")[0]];
   const packageDir = packageParts.join("/");
-  let dir = path6.dirname(resolvedPath);
+  let dir = path5.dirname(resolvedPath);
   const maxDepth = 10;
   for (let i = 0;i < maxDepth; i++) {
     if (dir.endsWith(`node_modules/${packageDir}`)) {
-      const pkgPath = path6.join(dir, "package.json");
-      if (fs6.existsSync(pkgPath)) {
+      const pkgPath = path5.join(dir, "package.json");
+      if (fs5.existsSync(pkgPath)) {
         try {
-          return JSON.parse(fs6.readFileSync(pkgPath, "utf-8"));
+          return JSON.parse(fs5.readFileSync(pkgPath, "utf-8"));
         } catch {
           return;
         }
       }
     }
-    const parent = path6.dirname(dir);
+    const parent = path5.dirname(dir);
     if (parent === dir)
       break;
     dir = parent;
@@ -5813,7 +5598,7 @@ function hasInternalTag(typeName, program, sourceFile) {
 }
 
 // src/builder/verification.ts
-import * as path7 from "node:path";
+import * as path6 from "node:path";
 var BUILTIN_TYPES2 = new Set([
   "Array",
   "ArrayBuffer",
@@ -5902,8 +5687,8 @@ function isExternalType2(definedIn, baseDir) {
     return true;
   if (definedIn.includes("node_modules"))
     return true;
-  const normalizedDefined = path7.resolve(definedIn);
-  const normalizedBase = path7.resolve(baseDir);
+  const normalizedDefined = path6.resolve(definedIn);
+  const normalizedBase = path6.resolve(baseDir);
   return !normalizedDefined.startsWith(normalizedBase);
 }
 function shouldSkipDanglingRef(name) {
@@ -6242,7 +6027,7 @@ async function extract(options) {
       }
     }
     const types = ctx.typeRegistry.getAll();
-    const projectBaseDir = baseDir ?? path8.dirname(entryFile);
+    const projectBaseDir = baseDir ?? path7.dirname(entryFile);
     const definedTypes = new Set(types.map((t) => t.id));
     const forgottenExports = collectForgottenExports(exports, types, program, sourceFile, exportedIds, projectBaseDir, definedTypes);
     for (const forgotten of forgottenExports) {
@@ -6275,7 +6060,7 @@ async function extract(options) {
     }
     let runtimeMetadata;
     if (options.schemaExtraction === "hybrid") {
-      const projectBaseDir2 = baseDir || path8.dirname(entryFile);
+      const projectBaseDir2 = baseDir || path7.dirname(entryFile);
       const runtimeResult = await extractStandardSchemasFromProject(entryFile, projectBaseDir2, {
         target: options.schemaTarget || "draft-2020-12",
         timeout: 15000
@@ -6564,7 +6349,7 @@ function createEmptySpec(entryFile, includeSchema, isDtsSource) {
   return {
     ...includeSchema ? { $schema: SCHEMA_URL } : {},
     openpkg: SCHEMA_VERSION,
-    meta: { name: path8.basename(entryFile, path8.extname(entryFile)) },
+    meta: { name: path7.basename(entryFile, path7.extname(entryFile)) },
     exports: [],
     generation: {
       generator: "@openpkg-ts/sdk",
@@ -6580,7 +6365,7 @@ function findTypeInProgram(name, checker, program, sourceFile, symFlags) {
   const localSym = checker.resolveName(name, sourceFile, symFlags, false);
   if (localSym)
     return checker.getDeclaredTypeOfSymbol(localSym);
-  const entryDir = path8.dirname(sourceFile.fileName);
+  const entryDir = path7.dirname(sourceFile.fileName);
   for (const sf of program.getSourceFiles()) {
     const fn = sf.fileName;
     if (fn.includes("/typescript/lib/lib.") || fn.includes("\\typescript\\lib\\lib."))
@@ -6596,22 +6381,22 @@ function findTypeInProgram(name, checker, program, sourceFile, symFlags) {
   return;
 }
 async function getPackageMeta(entryFile, baseDir) {
-  let dir = baseDir ?? path8.dirname(entryFile);
-  while (dir !== path8.dirname(dir)) {
-    const pkgPath = path8.join(dir, "package.json");
+  let dir = baseDir ?? path7.dirname(entryFile);
+  while (dir !== path7.dirname(dir)) {
+    const pkgPath = path7.join(dir, "package.json");
     try {
-      if (fs7.existsSync(pkgPath)) {
-        const pkg = JSON.parse(fs7.readFileSync(pkgPath, "utf-8"));
+      if (fs6.existsSync(pkgPath)) {
+        const pkg = JSON.parse(fs6.readFileSync(pkgPath, "utf-8"));
         return {
-          name: pkg.name ?? path8.basename(dir),
+          name: pkg.name ?? path7.basename(dir),
           version: pkg.version,
           description: pkg.description
         };
       }
     } catch {}
-    dir = path8.dirname(dir);
+    dir = path7.dirname(dir);
   }
-  return { name: path8.basename(baseDir ?? path8.dirname(entryFile)) };
+  return { name: path7.basename(baseDir ?? path7.dirname(entryFile)) };
 }
 
 // src/primitives/spec.ts
@@ -6638,8 +6423,6 @@ export {
   typeboxAdapter,
   toSearchIndexJSON,
   toSearchIndex,
-  toReactString,
-  toReact,
   toPagefindRecords,
   toNavigation,
   toMarkdown,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/sdk",
-  "version": "0.37.1",
+  "version": "0.38.0",
   "description": "TypeScript API extraction SDK - programmatic primitives for OpenPkg specs",
   "keywords": [
     "openpkg",
@@ -39,6 +39,7 @@
     "lint": "biome check src/",
     "lint:fix": "biome check --write src/",
     "format": "biome format --write src/",
+    "typecheck": "tsc --noEmit -p .",
     "test": "bun test"
   },
   "dependencies": {
@@ -57,7 +58,11 @@
   "devDependencies": {
     "@types/bun": "latest",
     "@types/node": "^20.0.0",
-    "bunup": "^0.16.20"
+    "@types/picomatch": "4.0.3",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "bunup": "^0.16.20",
+    "zod": "^4.3.6"
   },
   "publishConfig": {
     "access": "public"