@openpkg-ts/sdk 0.37.1 → 0.39.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
@@ -1575,7 +1551,7 @@ interface ProgramResult {
 	/** Resolved project references (workspace packages) */
 	projectReferences?: ts7.ResolvedProjectReference[];
 }
-declare function createProgram({ entryFile, baseDir, content }: ProgramOptions): ProgramResult;
+declare function createProgram(options: ProgramOptions): ProgramResult;
 import * as TS from "typescript";
 /**
 * A schema adapter can detect and extract output types from a specific
@@ -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) {
@@ -1513,6 +1298,7 @@ function filterSpec(spec, criteria) {
 import ts11 from "typescript";
 
 // src/ast/utils.ts
+import * as path2 from "node:path";
 import ts from "typescript";
 function parseExamplesFromTags(tags) {
   const examples = [];
@@ -1657,8 +1443,10 @@ function getJSDocComment(node, symbol, checker) {
 }
 function getSourceLocation(node, sourceFile) {
   const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+  const relative2 = path2.relative(process.cwd(), sourceFile.fileName);
+  const file = relative2.startsWith("..") ? sourceFile.fileName : relative2;
   return {
-    file: sourceFile.fileName,
+    file,
     line: line + 1
   };
 }
@@ -1828,7 +1616,7 @@ function getExportKind(declaration, type) {
 }
 
 // src/compiler/program.ts
-import * as fs4 from "node:fs";
+import * as fs3 from "node:fs";
 import * as path3 from "node:path";
 import ts2 from "typescript";
 function isJsFile(file) {
@@ -1850,6 +1638,22 @@ var DEFAULT_COMPILER_OPTIONS = {
   declaration: true,
   moduleResolution: ts2.ModuleResolutionKind.NodeJs
 };
+function resolveWorkspaceEntry(pkgDir) {
+  const candidates = [
+    path3.join(pkgDir, "src", "index.ts"),
+    path3.join(pkgDir, "src", "index.tsx"),
+    path3.join(pkgDir, "index.ts")
+  ];
+  try {
+    const pkg = JSON.parse(fs3.readFileSync(path3.join(pkgDir, "package.json"), "utf-8"));
+    for (const field of [pkg.types, pkg.typings]) {
+      if (typeof field === "string") {
+        candidates.push(path3.resolve(pkgDir, field));
+      }
+    }
+  } catch {}
+  return candidates.find((c) => fs3.existsSync(c));
+}
 function resolveProjectReferences(configPath, parsedConfig) {
   const additionalFiles = [];
   if (!parsedConfig.projectReferences?.length) {
@@ -1858,8 +1662,8 @@ function resolveProjectReferences(configPath, parsedConfig) {
   const configDir = path3.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 refConfigPath = fs3.existsSync(path3.join(refPath, "tsconfig.json")) ? path3.join(refPath, "tsconfig.json") : refPath;
+    if (!fs3.existsSync(refConfigPath))
       continue;
     const refConfigFile = ts2.readConfigFile(refConfigPath, ts2.sys.readFile);
     if (refConfigFile.error)
@@ -1898,9 +1702,9 @@ function buildWorkspaceMap(baseDir) {
   let workspaceGlobs = [];
   for (let i = 0;i < 10; i++) {
     const pnpmPath = path3.join(currentDir, "pnpm-workspace.yaml");
-    if (fs4.existsSync(pnpmPath)) {
+    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;
@@ -1909,9 +1713,9 @@ function buildWorkspaceMap(baseDir) {
       } catch {}
     }
     const pkgPath = path3.join(currentDir, "package.json");
-    if (fs4.existsSync(pkgPath)) {
+    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 || [];
@@ -1929,32 +1733,30 @@ function buildWorkspaceMap(baseDir) {
   const packages = new Map;
   for (const glob of workspaceGlobs) {
     const globDir = path3.join(rootDir, glob.replace(/\/\*$/, ""));
-    if (!fs4.existsSync(globDir) || !fs4.statSync(globDir).isDirectory())
+    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))
+      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;
-          packages.set(pkg.name, srcDir);
+          packages.set(pkg.name, pkgDir);
         }
       } catch {}
     }
   }
   return packages.size > 0 ? { packages, rootDir } : undefined;
 }
-function createProgram({
-  entryFile,
-  baseDir = path3.dirname(entryFile),
-  content
-}) {
+function createProgram(options) {
+  const { content } = options;
+  const entryFile = path3.resolve(options.entryFile);
+  const baseDir = path3.resolve(options.baseDir ?? path3.dirname(entryFile));
   let configPath = ts2.findConfigFile(baseDir, ts2.sys.fileExists, "tsconfig.json");
   if (!configPath) {
     configPath = ts2.findConfigFile(baseDir, ts2.sys.fileExists, "jsconfig.json");
@@ -1987,20 +1789,20 @@ function createProgram({
   let inMemorySource;
   if (workspaceMap) {
     const originalResolveModuleNames = compilerHost.resolveModuleNames?.bind(compilerHost);
-    compilerHost.resolveModuleNames = (moduleNames, containingFile, _reusedNames, redirectedReference, options) => {
+    compilerHost.resolveModuleNames = (moduleNames, containingFile, _reusedNames, redirectedReference, options2) => {
       return moduleNames.map((moduleName) => {
-        const srcDir = workspaceMap.packages.get(moduleName);
-        if (srcDir) {
-          const indexFile = path3.join(srcDir, "index.ts");
-          if (fs4.existsSync(indexFile)) {
-            return { resolvedFileName: indexFile, isExternalLibraryImport: false };
+        const pkgDir = workspaceMap.packages.get(moduleName);
+        if (pkgDir) {
+          const entryPath = resolveWorkspaceEntry(pkgDir);
+          if (entryPath) {
+            return { resolvedFileName: entryPath, isExternalLibraryImport: false };
           }
         }
         if (originalResolveModuleNames) {
-          const result = originalResolveModuleNames([moduleName], containingFile, _reusedNames, redirectedReference, options);
+          const result = originalResolveModuleNames([moduleName], containingFile, _reusedNames, redirectedReference, options2);
           return result[0];
         }
-        const resolved = ts2.resolveModuleName(moduleName, containingFile, options, compilerHost);
+        const resolved = ts2.resolveModuleName(moduleName, containingFile, options2, compilerHost);
         return resolved.resolvedModule;
       });
     };
@@ -2108,6 +1910,18 @@ var BUILTIN_GENERICS = new Set([
   "InstanceType",
   "Awaited"
 ]);
+var RESOLVED_UTILITY_TYPES = new Set([
+  "Partial",
+  "Required",
+  "Readonly",
+  "Pick",
+  "Omit",
+  "Record",
+  "Exclude",
+  "Extract",
+  "NonNullable",
+  "Awaited"
+]);
 var BUILTIN_TYPES = new Set([
   "Date",
   "RegExp",
@@ -2533,6 +2347,13 @@ function buildSchemaInternal(type, checker, ctx) {
       if (BUILTIN_TYPES.has(name)) {
         return { $ref: `#/types/${name}` };
       }
+      if (RESOLVED_UTILITY_TYPES.has(name) && type.flags & ts3.TypeFlags.Object) {
+        const props = type.getProperties();
+        const hasIndex = checker.getIndexInfosOfType(type).length > 0;
+        if (props.length > 0 || hasIndex) {
+          return buildObjectSchema(props, checker, ctx, type);
+        }
+      }
       if (isBuiltinGeneric(name) || !name.startsWith("__")) {
         const packageOrigin = getTypeOrigin(type, checker);
         if (ctx) {
@@ -2647,7 +2468,11 @@ function buildObjectSchema(properties, checker, ctx, originalType) {
       properties: props,
       ...required.length > 0 ? { required } : {}
     };
-    if (Object.keys(props).length === 0 && originalType) {
+    const stringIndex = originalType ? checker.getIndexInfosOfType(originalType).find((i) => i.keyType.flags & ts3.TypeFlags.String) : undefined;
+    if (stringIndex) {
+      schema.additionalProperties = buildSchema(stringIndex.type, checker, ctx);
+    }
+    if (Object.keys(props).length === 0 && originalType && !stringIndex) {
       setSchemaExtension(schema, "x-ts-type", checker.typeToString(originalType));
     }
     return schema;
@@ -3162,7 +2987,8 @@ class TypeRegistry {
   }
   buildObjectSchemaFromProperties(type, checker, ctx) {
     const properties = type.getProperties();
-    if (properties.length === 0) {
+    const stringIndex = checker.getIndexInfosOfType(type).find((i) => i.keyType.flags & ts5.TypeFlags.String);
+    if (properties.length === 0 && !stringIndex) {
       return { type: checker.typeToString(type) };
     }
     const props = {};
@@ -3195,7 +3021,8 @@ class TypeRegistry {
     return {
       type: "object",
       properties: props,
-      ...required.length > 0 ? { required } : {}
+      ...required.length > 0 ? { required } : {},
+      ...stringIndex ? { additionalProperties: buildSchema(stringIndex.type, checker, ctx) } : {}
     };
   }
 }
@@ -4939,7 +4766,7 @@ function getDescriptionPreview(symbol, checker) {
   return `${firstLine.slice(0, 77)}...`;
 }
 // src/builder/spec-builder.ts
-import * as fs7 from "node:fs";
+import * as fs6 from "node:fs";
 import * as path8 from "node:path";
 import { SCHEMA_URL, SCHEMA_VERSION } from "@openpkg-ts/spec";
 import ts16 from "typescript";
@@ -4976,7 +4803,7 @@ 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";
 var MAX_BUFFER_SIZE = 10 * 1024 * 1024;
@@ -5232,14 +5059,14 @@ 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`);
   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) => {
@@ -5270,7 +5097,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 +5151,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 +5163,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) });
@@ -5349,10 +5176,10 @@ async function extractStandardSchemasFromTs(tsFilePath, options = {}) {
 function readTsconfigOutDir(baseDir) {
   const tsconfigPath = path5.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) {
@@ -5392,7 +5219,7 @@ function resolveCompiledPath(tsPath, baseDir) {
     }
   }
   for (const candidate of candidates) {
-    if (fs5.existsSync(candidate)) {
+    if (fs4.existsSync(candidate)) {
       return candidate;
     }
   }
@@ -5405,7 +5232,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,7 +5348,7 @@ async function extractStandardSchemasFromProject(entryFile, baseDir, options = {
 }
 
 // src/builder/external-resolver.ts
-import * as fs6 from "node:fs";
+import * as fs5 from "node:fs";
 import * as path6 from "node:path";
 import picomatch from "picomatch";
 import ts14 from "typescript";
@@ -5561,9 +5388,9 @@ function findPackageJson(resolvedPath, packageName) {
   for (let i = 0;i < maxDepth; i++) {
     if (dir.endsWith(`node_modules/${packageDir}`)) {
       const pkgPath = path6.join(dir, "package.json");
-      if (fs6.existsSync(pkgPath)) {
+      if (fs5.existsSync(pkgPath)) {
         try {
-          return JSON.parse(fs6.readFileSync(pkgPath, "utf-8"));
+          return JSON.parse(fs5.readFileSync(pkgPath, "utf-8"));
         } catch {
           return;
         }
@@ -6600,8 +6427,8 @@ async function getPackageMeta(entryFile, baseDir) {
   while (dir !== path8.dirname(dir)) {
     const pkgPath = path8.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),
           version: pkg.version,
@@ -6638,8 +6465,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.39.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"