@openpkg-ts/extract 0.20.0 → 0.21.0

package/dist/bin/tspec.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   extract
-} from "../shared/chunk-rej3ws8m.js";
+} from "../shared/chunk-yh8v9dbt.js";
 
 // src/cli/spec.ts
 import * as fs from "node:fs";
@@ -451,13 +451,21 @@ function createProgram() {
     }
     fs.writeFileSync(options.output, JSON.stringify(normalized, null, 2));
     spin.success(`Extracted to ${options.output}`);
+    if (result.runtimeSchemas) {
+      const { extracted, merged, vendors } = result.runtimeSchemas;
+      console.log(`ℹ Runtime schemas: ${merged}/${extracted} merged (${vendors.join(", ")})`);
+    }
     for (const diag of result.diagnostics) {
       if (diag.severity === "info" && !options.verbose)
         continue;
       const prefix2 = diag.severity === "error" ? "✗" : diag.severity === "warning" ? "⚠" : "ℹ";
       console.log(`${prefix2} ${diag.message}`);
     }
-    summary().addKeyValue("Exports", normalized.exports.length).addKeyValue("Types", normalized.types?.length || 0).print();
+    const sum = summary().addKeyValue("Exports", normalized.exports.length).addKeyValue("Types", normalized.types?.length || 0);
+    if (result.runtimeSchemas) {
+      sum.addKeyValue("Runtime Schemas", result.runtimeSchemas.merged);
+    }
+    sum.print();
   });
   return program;
 }

package/dist/shared/{chunk-rej3ws8m.js → chunk-yh8v9dbt.js}

@@ -164,8 +164,8 @@ function buildSchema(type, checker, ctx, _depth = 0) {
     return { type: "number", enum: [literal] };
   }
   if (type.flags & ts.TypeFlags.BooleanLiteral) {
-    const intrinsicName = type.intrinsicName;
-    return { type: "boolean", enum: [intrinsicName === "true"] };
+    const typeString = checker.typeToString(type);
+    return { type: "boolean", enum: [typeString === "true"] };
   }
   if (type.isUnion()) {
     const types = type.types;
@@ -329,6 +329,9 @@ function isPureRefSchema(schema) {
   return typeof schema === "object" && Object.keys(schema).length === 1 && "$ref" in schema;
 }
 function withDescription(schema, description) {
+  if (typeof schema === "string") {
+    return { type: schema, description };
+  }
   if (isPureRefSchema(schema)) {
     return {
       allOf: [schema],
@@ -702,9 +705,9 @@ function getJSDocComment(node) {
     }
     return { name: tag.tagName.text, text: rawText };
   });
-  const jsDocComments = node.jsDoc;
+  const jsDocComments = ts3.getJSDocCommentsAndTags(node).filter(ts3.isJSDoc);
   let description;
-  if (jsDocComments && jsDocComments.length > 0) {
+  if (jsDocComments.length > 0) {
     const firstDoc = jsDocComments[0];
     if (firstDoc.comment) {
       description = typeof firstDoc.comment === "string" ? firstDoc.comment : ts3.getTextOfJSDocComment(firstDoc.comment);
@@ -1076,7 +1079,7 @@ function getMemberName(member) {
   return member.name.getText();
 }
 function getVisibility(member) {
-  const modifiers = ts6.getModifiers(member);
+  const modifiers = ts6.canHaveModifiers(member) ? ts6.getModifiers(member) : undefined;
   if (!modifiers)
     return;
   for (const mod of modifiers) {
@@ -1090,11 +1093,11 @@ function getVisibility(member) {
   return;
 }
 function isStatic(member) {
-  const modifiers = ts6.getModifiers(member);
+  const modifiers = ts6.canHaveModifiers(member) ? ts6.getModifiers(member) : undefined;
   return modifiers?.some((m) => m.kind === ts6.SyntaxKind.StaticKeyword) ?? false;
 }
 function isReadonly(member) {
-  const modifiers = ts6.getModifiers(member);
+  const modifiers = ts6.canHaveModifiers(member) ? ts6.getModifiers(member) : undefined;
   return modifiers?.some((m) => m.kind === ts6.SyntaxKind.ReadonlyKeyword) ?? false;
 }
 function serializeProperty(node, ctx) {
@@ -1463,7 +1466,7 @@ function getInterfaceExtends(node, checker) {
         const type = checker.getTypeAtLocation(expr);
         return type.getSymbol()?.getName() ?? expr.expression.getText();
       });
-      return names.length === 1 ? names[0] : names;
+      return names.join(" & ");
     }
   }
   return;
@@ -1519,9 +1522,240 @@ function serializeVariable(node, statement, ctx) {
   };
 }
 
-// src/builder/spec-builder.ts
+// src/schema/standard-schema.ts
+import { spawn } from "node:child_process";
 import * as fs from "node:fs";
 import * as path2 from "node:path";
+function isStandardJSONSchema(obj) {
+  if (typeof obj !== "object" || obj === null)
+    return false;
+  const std = obj["~standard"];
+  if (typeof std !== "object" || std === null)
+    return false;
+  const stdObj = std;
+  if (stdObj.version !== 1)
+    return false;
+  if (typeof stdObj.vendor !== "string")
+    return false;
+  const jsonSchema = stdObj.jsonSchema;
+  if (typeof jsonSchema !== "object" || jsonSchema === null)
+    return false;
+  const jsObj = jsonSchema;
+  return typeof jsObj.output === "function" && typeof jsObj.input === "function";
+}
+var WORKER_SCRIPT = `
+const path = require('path');
+const { pathToFileURL } = require('url');
+
+// TypeBox detection: schemas have Symbol.for('TypeBox.Kind') and are JSON Schema
+const TYPEBOX_KIND = Symbol.for('TypeBox.Kind');
+
+function isTypeBoxSchema(obj) {
+  if (!obj || typeof obj !== 'object') return false;
+  // TypeBox schemas always have Kind symbol (Union, Object, String, etc.)
+  // Also check for common JSON Schema props to avoid false positives
+  if (!obj[TYPEBOX_KIND]) return false;
+  return typeof obj.type === 'string' || 'anyOf' in obj || 'oneOf' in obj || 'allOf' in obj;
+}
+
+function sanitizeTypeBoxSchema(schema) {
+  // JSON.stringify removes symbol keys, keeping only JSON Schema props
+  return JSON.parse(JSON.stringify(schema));
+}
+
+async function extract() {
+  // With node -e, argv is: [node, arg1, arg2, ...]
+  // (the -e script is NOT in argv)
+  const [modulePath, optionsJson] = process.argv.slice(1);
+  const { target, libraryOptions } = JSON.parse(optionsJson || '{}');
+
+  try {
+    // Import the module using dynamic import (works with ESM and CJS)
+    const absPath = path.resolve(modulePath);
+    const mod = await import(pathToFileURL(absPath).href);
+    const results = [];
+
+    // Build exports map - handle both ESM and CJS (where exports are in mod.default)
+    const exports = {};
+    for (const [name, value] of Object.entries(mod)) {
+      if (name === 'default' && typeof value === 'object' && value !== null) {
+        // CJS module: spread default exports
+        Object.assign(exports, value);
+      } else if (name !== 'default') {
+        exports[name] = value;
+      }
+    }
+
+    // Check each export
+    for (const [name, value] of Object.entries(exports)) {
+      if (name.startsWith('_')) continue;
+      if (typeof value !== 'object' || value === null) continue;
+
+      // Priority 1: Standard JSON Schema (Zod 4.2+, ArkType 2.1.28+, Valibot 1.2+)
+      const std = value['~standard'];
+      if (std && typeof std === 'object' && std.version === 1 && typeof std.vendor === 'string' && std.jsonSchema && typeof std.jsonSchema.output === 'function') {
+        try {
+          // Per spec: pass options object with target and optional libraryOptions
+          const options = { target: target || 'draft-2020-12', ...(libraryOptions && { libraryOptions }) };
+          const outputSchema = std.jsonSchema.output(options);
+          const inputSchema = typeof std.jsonSchema.input === 'function' ? std.jsonSchema.input(options) : undefined;
+          results.push({
+            exportName: name,
+            vendor: std.vendor,
+            outputSchema,
+            inputSchema
+          });
+        } catch (e) {
+          // Skip schemas that fail to extract
+        }
+        continue;
+      }
+
+      // Priority 2: TypeBox (schema IS JSON Schema)
+      if (isTypeBoxSchema(value)) {
+        try {
+          results.push({
+            exportName: name,
+            vendor: 'typebox',
+            outputSchema: sanitizeTypeBoxSchema(value)
+          });
+        } catch (e) {
+          // Skip schemas that fail to extract
+        }
+        continue;
+      }
+    }
+
+    console.log(JSON.stringify({ success: true, results }));
+  } catch (e) {
+    console.log(JSON.stringify({ success: false, error: e.message }));
+  }
+}
+
+extract();
+`;
+function readTsconfigOutDir(baseDir) {
+  const tsconfigPath = path2.join(baseDir, "tsconfig.json");
+  try {
+    if (!fs.existsSync(tsconfigPath)) {
+      return null;
+    }
+    const content = fs.readFileSync(tsconfigPath, "utf-8");
+    const stripped = content.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "");
+    const tsconfig = JSON.parse(stripped);
+    if (tsconfig.compilerOptions?.outDir) {
+      return tsconfig.compilerOptions.outDir.replace(/^\.\//, "");
+    }
+  } catch {}
+  return null;
+}
+function resolveCompiledPath(tsPath, baseDir) {
+  const relativePath = path2.relative(baseDir, tsPath);
+  const withoutExt = relativePath.replace(/\.tsx?$/, "");
+  const srcPrefix = withoutExt.replace(/^src\//, "");
+  const tsconfigOutDir = readTsconfigOutDir(baseDir);
+  const extensions = [".js", ".mjs", ".cjs"];
+  const candidates = [];
+  if (tsconfigOutDir) {
+    for (const ext of extensions) {
+      candidates.push(path2.join(baseDir, tsconfigOutDir, `${srcPrefix}${ext}`));
+    }
+  }
+  const commonOutDirs = ["dist", "build", "lib", "out"];
+  for (const outDir of commonOutDirs) {
+    if (outDir === tsconfigOutDir)
+      continue;
+    for (const ext of extensions) {
+      candidates.push(path2.join(baseDir, outDir, `${srcPrefix}${ext}`));
+    }
+  }
+  for (const ext of extensions) {
+    candidates.push(path2.join(baseDir, `${withoutExt}${ext}`));
+  }
+  const workspaceMatch = baseDir.match(/^(.+\/packages\/[^/]+)$/);
+  if (workspaceMatch) {
+    const pkgRoot = workspaceMatch[1];
+    for (const ext of extensions) {
+      candidates.push(path2.join(pkgRoot, "dist", `${srcPrefix}${ext}`));
+    }
+  }
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+}
+async function extractStandardSchemas(compiledJsPath, options = {}) {
+  const { timeout = 1e4, target = "draft-2020-12", libraryOptions } = options;
+  const result = {
+    schemas: new Map,
+    errors: []
+  };
+  if (!fs.existsSync(compiledJsPath)) {
+    result.errors.push(`Compiled JS not found: ${compiledJsPath}`);
+    return result;
+  }
+  const optionsJson = JSON.stringify({ target, libraryOptions });
+  return new Promise((resolve) => {
+    const child = spawn("node", ["-e", WORKER_SCRIPT, compiledJsPath, optionsJson], {
+      timeout,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (data) => {
+      stdout += data.toString();
+    });
+    child.stderr.on("data", (data) => {
+      stderr += data.toString();
+    });
+    child.on("close", (code) => {
+      if (code !== 0) {
+        result.errors.push(`Extraction process failed: ${stderr || `exit code ${code}`}`);
+        resolve(result);
+        return;
+      }
+      try {
+        const parsed = JSON.parse(stdout);
+        if (!parsed.success) {
+          result.errors.push(`Extraction failed: ${parsed.error}`);
+          resolve(result);
+          return;
+        }
+        for (const item of parsed.results) {
+          result.schemas.set(item.exportName, {
+            exportName: item.exportName,
+            vendor: item.vendor,
+            outputSchema: item.outputSchema,
+            inputSchema: item.inputSchema
+          });
+        }
+      } catch (e) {
+        result.errors.push(`Failed to parse extraction output: ${e}`);
+      }
+      resolve(result);
+    });
+    child.on("error", (err) => {
+      result.errors.push(`Subprocess error: ${err.message}`);
+      resolve(result);
+    });
+  });
+}
+async function extractStandardSchemasFromProject(entryFile, baseDir, options = {}) {
+  const compiledPath = resolveCompiledPath(entryFile, baseDir);
+  if (!compiledPath) {
+    return {
+      schemas: new Map,
+      errors: [`Could not find compiled JS for ${entryFile}. Build the project first.`]
+    };
+  }
+  return extractStandardSchemas(compiledPath, options);
+}
+
+// src/builder/spec-builder.ts
+import * as fs2 from "node:fs";
+import * as path3 from "node:path";
 import { SCHEMA_URL, SCHEMA_VERSION } from "@openpkg-ts/spec";
 import ts8 from "typescript";
 
@@ -1541,6 +1775,34 @@ function createContext(program, sourceFile, options = {}) {
   };
 }
 
+// src/builder/schema-merger.ts
+function mergeRuntimeSchemas(staticExports, runtimeSchemas) {
+  let merged = 0;
+  const exports = staticExports.map((exp) => {
+    const runtime = runtimeSchemas.get(exp.name);
+    if (!runtime)
+      return exp;
+    merged++;
+    const mergedExport = {
+      ...exp,
+      schema: runtime.outputSchema,
+      tags: [
+        ...exp.tags || [],
+        { name: "vendor", text: runtime.vendor },
+        { name: "schema-source", text: "standard-json-schema" }
+      ]
+    };
+    if (runtime.inputSchema && JSON.stringify(runtime.inputSchema) !== JSON.stringify(runtime.outputSchema)) {
+      mergedExport.flags = {
+        ...mergedExport.flags,
+        inputSchema: runtime.inputSchema
+      };
+    }
+    return mergedExport;
+  });
+  return { merged, exports };
+}
+
 // src/builder/spec-builder.ts
 var BUILTIN_TYPES2 = new Set([
   "Array",
@@ -1638,7 +1900,7 @@ async function extract(options) {
     ignore
   } = options;
   const diagnostics = [];
-  const exports = [];
+  let exports = [];
   const result = createProgram({ entryFile, baseDir, content });
   const { program, sourceFile } = result;
   if (!sourceFile) {
@@ -1715,6 +1977,41 @@ async function extract(options) {
       code: "EXTERNAL_TYPES"
     });
   }
+  let runtimeMetadata;
+  if (options.schemaExtraction === "hybrid") {
+    const projectBaseDir = baseDir || path3.dirname(entryFile);
+    const compiledPath = resolveCompiledPath(entryFile, projectBaseDir);
+    if (compiledPath) {
+      const runtimeResult = await extractStandardSchemas(compiledPath, {
+        target: options.schemaTarget || "draft-2020-12",
+        timeout: 15000
+      });
+      if (runtimeResult.schemas.size > 0) {
+        const mergeResult = mergeRuntimeSchemas(exports, runtimeResult.schemas);
+        exports = mergeResult.exports;
+        runtimeMetadata = {
+          extracted: runtimeResult.schemas.size,
+          merged: mergeResult.merged,
+          vendors: [...new Set([...runtimeResult.schemas.values()].map((s) => s.vendor))],
+          errors: runtimeResult.errors
+        };
+      }
+      for (const error of runtimeResult.errors) {
+        diagnostics.push({
+          message: `Runtime schema extraction: ${error}`,
+          severity: "warning",
+          code: "RUNTIME_SCHEMA_ERROR"
+        });
+      }
+    } else {
+      diagnostics.push({
+        message: "Hybrid mode: Could not find compiled JS. Build the project first.",
+        severity: "warning",
+        code: "NO_COMPILED_JS",
+        suggestion: "Run `npm run build` or `tsc` before extraction"
+      });
+    }
+  }
   const spec = {
     ...includeSchema ? { $schema: SCHEMA_URL } : {},
     openpkg: SCHEMA_VERSION,
@@ -1723,14 +2020,16 @@ async function extract(options) {
     types,
     generation: {
       generator: "@openpkg-ts/extract",
-      timestamp: new Date().toISOString()
+      timestamp: new Date().toISOString(),
+      ...options.schemaExtraction === "hybrid" ? { schemaExtraction: "hybrid" } : {}
     }
   };
   const internalForgotten = forgottenExports.filter((f) => !f.isExternal);
   return {
     spec,
     diagnostics,
-    ...internalForgotten.length > 0 ? { forgottenExports: internalForgotten } : {}
+    ...internalForgotten.length > 0 ? { forgottenExports: internalForgotten } : {},
+    ...runtimeMetadata ? { runtimeSchemas: runtimeMetadata } : {}
   };
 }
 function collectAllRefsWithContext(obj, refs, state) {
@@ -2036,7 +2335,7 @@ function createEmptySpec(entryFile, includeSchema) {
   return {
     ...includeSchema ? { $schema: SCHEMA_URL } : {},
     openpkg: SCHEMA_VERSION,
-    meta: { name: path2.basename(entryFile, path2.extname(entryFile)) },
+    meta: { name: path3.basename(entryFile, path3.extname(entryFile)) },
     exports: [],
     generation: {
       generator: "@openpkg-ts/extract",
@@ -2045,18 +2344,18 @@ function createEmptySpec(entryFile, includeSchema) {
   };
 }
 async function getPackageMeta(entryFile, baseDir) {
-  const searchDir = baseDir ?? path2.dirname(entryFile);
-  const pkgPath = path2.join(searchDir, "package.json");
+  const searchDir = baseDir ?? path3.dirname(entryFile);
+  const pkgPath = path3.join(searchDir, "package.json");
   try {
-    if (fs.existsSync(pkgPath)) {
-      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    if (fs2.existsSync(pkgPath)) {
+      const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf-8"));
       return {
-        name: pkg.name ?? path2.basename(searchDir),
+        name: pkg.name ?? path3.basename(searchDir),
         version: pkg.version,
         description: pkg.description
       };
     }
   } catch {}
-  return { name: path2.basename(searchDir) };
+  return { name: path3.basename(searchDir) };
 }
-export { BUILTIN_TYPE_SCHEMAS, isPrimitiveName, isBuiltinGeneric, isAnonymous, buildSchema, isPureRefSchema, withDescription, schemaIsAny, schemasAreEqual, deduplicateSchemas, findDiscriminatorProperty, TypeRegistry, getJSDocComment, getSourceLocation, getParamDescription, extractTypeParameters, isSymbolDeprecated, createProgram, extractParameters, registerReferencedTypes, serializeClass, serializeEnum, serializeFunctionExport, serializeInterface, serializeTypeAlias, serializeVariable, extract };
+export { BUILTIN_TYPE_SCHEMAS, isPrimitiveName, isBuiltinGeneric, isAnonymous, buildSchema, isPureRefSchema, withDescription, schemaIsAny, schemasAreEqual, deduplicateSchemas, findDiscriminatorProperty, TypeRegistry, getJSDocComment, getSourceLocation, getParamDescription, extractTypeParameters, isSymbolDeprecated, createProgram, extractParameters, registerReferencedTypes, serializeClass, serializeEnum, serializeFunctionExport, serializeInterface, serializeTypeAlias, serializeVariable, isStandardJSONSchema, resolveCompiledPath, extractStandardSchemas, extractStandardSchemasFromProject, extract };

package/dist/src/index.d.ts

@@ -73,6 +73,8 @@ interface ExtractOptions {
 	maxExternalTypeDepth?: number;
 	resolveExternalTypes?: boolean;
 	schemaExtraction?: "static" | "hybrid";
+	/** Target JSON Schema dialect for runtime schema extraction */
+	schemaTarget?: "draft-2020-12" | "draft-07" | "openapi-3.0";
 	/** Include $schema URL in output */
 	includeSchema?: boolean;
 	/** Only extract these exports (supports * wildcards) */
@@ -84,6 +86,17 @@ interface ExtractResult {
 	spec: OpenPkg;
 	diagnostics: Diagnostic[];
 	forgottenExports?: ForgottenExport[];
+	/** Metadata about runtime schema extraction (when schemaExtraction: 'hybrid') */
+	runtimeSchemas?: {
+		/** Number of schema exports found */
+		extracted: number;
+		/** Number of schemas successfully merged with static types */
+		merged: number;
+		/** Schema vendors detected (e.g., 'zod', 'arktype', 'valibot', 'typebox') */
+		vendors: string[];
+		/** Any errors encountered during runtime extraction */
+		errors: string[];
+	};
 }
 interface Diagnostic {
 	message: string;
@@ -112,73 +125,6 @@ interface ForgottenExport {
 	fix?: string;
 }
 declare function extract(options: ExtractOptions): Promise<ExtractResult>;
-import ts4 from "typescript";
-interface ProgramOptions {
-	entryFile: string;
-	baseDir?: string;
-	content?: string;
-}
-interface ProgramResult {
-	program: ts4.Program;
-	compilerHost: ts4.CompilerHost;
-	compilerOptions: ts4.CompilerOptions;
-	sourceFile?: ts4.SourceFile;
-	configPath?: string;
-}
-declare function createProgram({ entryFile, baseDir, content }: ProgramOptions): ProgramResult;
-import * as TS from "typescript";
-/**
-* A schema adapter can detect and extract output types from a specific
-* schema validation library.
-*/
-interface SchemaAdapter {
-	/** Unique identifier for this adapter */
-	readonly id: string;
-	/** npm package name(s) this adapter handles */
-	readonly packages: readonly string[];
-	/**
-	* Check if a type matches this adapter's schema library.
-	* Should be fast - called for every export.
-	*/
-	matches(type: TS.Type, checker: TS.TypeChecker): boolean;
-	/**
-	* Extract the output type from a schema type.
-	* Returns null if extraction fails.
-	*/
-	extractOutputType(type: TS.Type, checker: TS.TypeChecker): TS.Type | null;
-	/**
-	* Extract the input type from a schema type (optional).
-	* Useful for transforms where input differs from output.
-	*/
-	extractInputType?(type: TS.Type, checker: TS.TypeChecker): TS.Type | null;
-}
-/**
-* Result of schema type extraction
-*/
-interface SchemaExtractionResult {
-	/** The adapter that matched */
-	adapter: SchemaAdapter;
-	/** The extracted output type */
-	outputType: TS.Type;
-	/** The extracted input type (if different from output) */
-	inputType?: TS.Type;
-}
-/**
-* Utility: Check if type is an object type reference (has type arguments)
-*/
-declare function isTypeReference(type: TS.Type): type is TS.TypeReference;
-/**
-* Utility: Remove undefined/null from a union type
-*/
-declare function getNonNullableType(type: TS.Type): TS.Type;
-declare function registerAdapter(adapter: SchemaAdapter): void;
-declare function findAdapter(type: TS.Type, checker: TS.TypeChecker): SchemaAdapter | undefined;
-declare function isSchemaType(type: TS.Type, checker: TS.TypeChecker): boolean;
-declare function extractSchemaType(type: TS.Type, checker: TS.TypeChecker): SchemaExtractionResult | null;
-declare const arktypeAdapter: SchemaAdapter;
-declare const typeboxAdapter: SchemaAdapter;
-declare const valibotAdapter: SchemaAdapter;
-declare const zodAdapter: SchemaAdapter;
 /**
 * Target version for JSON Schema generation.
 * @see https://standardschema.dev/json-schema
@@ -254,7 +200,8 @@ interface StandardSchemaExtractionOutput {
 declare function isStandardJSONSchema(obj: unknown): obj is StandardJSONSchemaV1;
 /**
 * Resolve compiled JS path from TypeScript source.
-* Tries common output locations: dist/, build/, lib/, same dir.
+* Reads tsconfig.json for outDir and tries multiple output patterns.
+* Supports .js, .mjs, and .cjs extensions.
 */
 declare function resolveCompiledPath(tsPath: string, baseDir: string): string | null;
 /**
@@ -278,24 +225,91 @@ declare function extractStandardSchemas(compiledJsPath: string, options?: Extrac
 * @param options - Extraction options
 */
 declare function extractStandardSchemasFromProject(entryFile: string, baseDir: string, options?: ExtractStandardSchemasOptions): Promise<StandardSchemaExtractionOutput>;
-import { SpecExport } from "@openpkg-ts/spec";
-import ts5 from "typescript";
-declare function serializeClass(node: ts5.ClassDeclaration, ctx: SerializerContext): SpecExport | null;
+import ts4 from "typescript";
+interface ProgramOptions {
+	entryFile: string;
+	baseDir?: string;
+	content?: string;
+}
+interface ProgramResult {
+	program: ts4.Program;
+	compilerHost: ts4.CompilerHost;
+	compilerOptions: ts4.CompilerOptions;
+	sourceFile?: ts4.SourceFile;
+	configPath?: string;
+}
+declare function createProgram({ entryFile, baseDir, content }: ProgramOptions): ProgramResult;
+import * as TS from "typescript";
+/**
+* A schema adapter can detect and extract output types from a specific
+* schema validation library.
+*/
+interface SchemaAdapter {
+	/** Unique identifier for this adapter */
+	readonly id: string;
+	/** npm package name(s) this adapter handles */
+	readonly packages: readonly string[];
+	/**
+	* Check if a type matches this adapter's schema library.
+	* Should be fast - called for every export.
+	*/
+	matches(type: TS.Type, checker: TS.TypeChecker): boolean;
+	/**
+	* Extract the output type from a schema type.
+	* Returns null if extraction fails.
+	*/
+	extractOutputType(type: TS.Type, checker: TS.TypeChecker): TS.Type | null;
+	/**
+	* Extract the input type from a schema type (optional).
+	* Useful for transforms where input differs from output.
+	*/
+	extractInputType?(type: TS.Type, checker: TS.TypeChecker): TS.Type | null;
+}
+/**
+* Result of schema type extraction
+*/
+interface SchemaExtractionResult {
+	/** The adapter that matched */
+	adapter: SchemaAdapter;
+	/** The extracted output type */
+	outputType: TS.Type;
+	/** The extracted input type (if different from output) */
+	inputType?: TS.Type;
+}
+/**
+* Utility: Check if type is an object type reference (has type arguments)
+*/
+declare function isTypeReference(type: TS.Type): type is TS.TypeReference;
+/**
+* Utility: Remove undefined/null from a union type
+*/
+declare function getNonNullableType(type: TS.Type): TS.Type;
+declare function registerAdapter(adapter: SchemaAdapter): void;
+declare function findAdapter(type: TS.Type, checker: TS.TypeChecker): SchemaAdapter | undefined;
+declare function isSchemaType(type: TS.Type, checker: TS.TypeChecker): boolean;
+declare function extractSchemaType(type: TS.Type, checker: TS.TypeChecker): SchemaExtractionResult | null;
+declare const arktypeAdapter: SchemaAdapter;
+declare const typeboxAdapter: SchemaAdapter;
+declare const valibotAdapter: SchemaAdapter;
+declare const zodAdapter: SchemaAdapter;
 import { SpecExport as SpecExport2 } from "@openpkg-ts/spec";
-import ts6 from "typescript";
-declare function serializeEnum(node: ts6.EnumDeclaration, ctx: SerializerContext): SpecExport2 | null;
+import ts5 from "typescript";
+declare function serializeClass(node: ts5.ClassDeclaration, ctx: SerializerContext): SpecExport2 | null;
 import { SpecExport as SpecExport3 } from "@openpkg-ts/spec";
-import ts7 from "typescript";
-declare function serializeFunctionExport(node: ts7.FunctionDeclaration | ts7.ArrowFunction, ctx: SerializerContext): SpecExport3 | null;
+import ts6 from "typescript";
+declare function serializeEnum(node: ts6.EnumDeclaration, ctx: SerializerContext): SpecExport3 | null;
 import { SpecExport as SpecExport4 } from "@openpkg-ts/spec";
-import ts8 from "typescript";
-declare function serializeInterface(node: ts8.InterfaceDeclaration, ctx: SerializerContext): SpecExport4 | null;
+import ts7 from "typescript";
+declare function serializeFunctionExport(node: ts7.FunctionDeclaration | ts7.ArrowFunction, ctx: SerializerContext): SpecExport4 | null;
 import { SpecExport as SpecExport5 } from "@openpkg-ts/spec";
-import ts9 from "typescript";
-declare function serializeTypeAlias(node: ts9.TypeAliasDeclaration, ctx: SerializerContext): SpecExport5 | null;
+import ts8 from "typescript";
+declare function serializeInterface(node: ts8.InterfaceDeclaration, ctx: SerializerContext): SpecExport5 | null;
 import { SpecExport as SpecExport6 } from "@openpkg-ts/spec";
+import ts9 from "typescript";
+declare function serializeTypeAlias(node: ts9.TypeAliasDeclaration, ctx: SerializerContext): SpecExport6 | null;
+import { SpecExport as SpecExport7 } from "@openpkg-ts/spec";
 import ts10 from "typescript";
-declare function serializeVariable(node: ts10.VariableDeclaration, statement: ts10.VariableStatement, ctx: SerializerContext): SpecExport6 | null;
+declare function serializeVariable(node: ts10.VariableDeclaration, statement: ts10.VariableStatement, ctx: SerializerContext): SpecExport7 | null;
 import { SpecSignatureParameter } from "@openpkg-ts/spec";
 import ts11 from "typescript";
 declare function extractParameters(signature: ts11.Signature, ctx: SerializerContext): SpecSignatureParameter[];

package/dist/src/index.js

@@ -6,6 +6,8 @@ import {
   deduplicateSchemas,
   extract,
   extractParameters,
+  extractStandardSchemas,
+  extractStandardSchemasFromProject,
   extractTypeParameters,
   findDiscriminatorProperty,
   getJSDocComment,
@@ -15,8 +17,10 @@ import {
   isBuiltinGeneric,
   isPrimitiveName,
   isPureRefSchema,
+  isStandardJSONSchema,
   isSymbolDeprecated,
   registerReferencedTypes,
+  resolveCompiledPath,
   schemaIsAny,
   schemasAreEqual,
   serializeClass,
@@ -26,7 +30,7 @@ import {
   serializeTypeAlias,
   serializeVariable,
   withDescription
-} from "../shared/chunk-rej3ws8m.js";
+} from "../shared/chunk-yh8v9dbt.js";
 // src/schema/registry.ts
 function isTypeReference(type) {
   return !!(type.flags & 524288 && type.objectFlags && type.objectFlags & 4);
@@ -57,7 +61,7 @@ function extractSchemaType(type, checker) {
   const outputType = adapter.extractOutputType(type, checker);
   if (!outputType)
     return null;
-  const inputType = adapter.extractInputType?.(type, checker);
+  const inputType = adapter.extractInputType?.(type, checker) ?? undefined;
   return {
     adapter,
     outputType,
@@ -189,200 +193,6 @@ registerAdapter(zodAdapter);
 registerAdapter(valibotAdapter);
 registerAdapter(arktypeAdapter);
 registerAdapter(typeboxAdapter);
-// src/schema/standard-schema.ts
-import { spawn } from "node:child_process";
-import * as fs from "node:fs";
-import * as path from "node:path";
-function isStandardJSONSchema(obj) {
-  if (typeof obj !== "object" || obj === null)
-    return false;
-  const std = obj["~standard"];
-  if (typeof std !== "object" || std === null)
-    return false;
-  const stdObj = std;
-  if (stdObj.version !== 1)
-    return false;
-  if (typeof stdObj.vendor !== "string")
-    return false;
-  const jsonSchema = stdObj.jsonSchema;
-  if (typeof jsonSchema !== "object" || jsonSchema === null)
-    return false;
-  const jsObj = jsonSchema;
-  return typeof jsObj.output === "function" && typeof jsObj.input === "function";
-}
-var WORKER_SCRIPT = `
-const path = require('path');
-const { pathToFileURL } = require('url');
-
-// TypeBox detection: schemas have Symbol.for('TypeBox.Kind') and are JSON Schema
-const TYPEBOX_KIND = Symbol.for('TypeBox.Kind');
-
-function isTypeBoxSchema(obj) {
-  if (!obj || typeof obj !== 'object') return false;
-  // TypeBox schemas always have Kind symbol (Union, Object, String, etc.)
-  // Also check for common JSON Schema props to avoid false positives
-  if (!obj[TYPEBOX_KIND]) return false;
-  return typeof obj.type === 'string' || 'anyOf' in obj || 'oneOf' in obj || 'allOf' in obj;
-}
-
-function sanitizeTypeBoxSchema(schema) {
-  // JSON.stringify removes symbol keys, keeping only JSON Schema props
-  return JSON.parse(JSON.stringify(schema));
-}
-
-async function extract() {
-  // With node -e, argv is: [node, arg1, arg2, ...]
-  // (the -e script is NOT in argv)
-  const [modulePath, optionsJson] = process.argv.slice(1);
-  const { target, libraryOptions } = JSON.parse(optionsJson || '{}');
-
-  try {
-    // Import the module using dynamic import (works with ESM and CJS)
-    const absPath = path.resolve(modulePath);
-    const mod = await import(pathToFileURL(absPath).href);
-    const results = [];
-
-    // Build exports map - handle both ESM and CJS (where exports are in mod.default)
-    const exports = {};
-    for (const [name, value] of Object.entries(mod)) {
-      if (name === 'default' && typeof value === 'object' && value !== null) {
-        // CJS module: spread default exports
-        Object.assign(exports, value);
-      } else if (name !== 'default') {
-        exports[name] = value;
-      }
-    }
-
-    // Check each export
-    for (const [name, value] of Object.entries(exports)) {
-      if (name.startsWith('_')) continue;
-      if (typeof value !== 'object' || value === null) continue;
-
-      // Priority 1: Standard JSON Schema (Zod 4.2+, ArkType 2.1.28+, Valibot 1.2+)
-      const std = value['~standard'];
-      if (std && typeof std === 'object' && std.version === 1 && typeof std.vendor === 'string' && std.jsonSchema && typeof std.jsonSchema.output === 'function') {
-        try {
-          // Per spec: pass options object with target and optional libraryOptions
-          const options = { target: target || 'draft-2020-12', ...(libraryOptions && { libraryOptions }) };
-          const outputSchema = std.jsonSchema.output(options);
-          const inputSchema = typeof std.jsonSchema.input === 'function' ? std.jsonSchema.input(options) : undefined;
-          results.push({
-            exportName: name,
-            vendor: std.vendor,
-            outputSchema,
-            inputSchema
-          });
-        } catch (e) {
-          // Skip schemas that fail to extract
-        }
-        continue;
-      }
-
-      // Priority 2: TypeBox (schema IS JSON Schema)
-      if (isTypeBoxSchema(value)) {
-        try {
-          results.push({
-            exportName: name,
-            vendor: 'typebox',
-            outputSchema: sanitizeTypeBoxSchema(value)
-          });
-        } catch (e) {
-          // Skip schemas that fail to extract
-        }
-        continue;
-      }
-    }
-
-    console.log(JSON.stringify({ success: true, results }));
-  } catch (e) {
-    console.log(JSON.stringify({ success: false, error: e.message }));
-  }
-}
-
-extract();
-`;
-function resolveCompiledPath(tsPath, baseDir) {
-  const relativePath = path.relative(baseDir, tsPath);
-  const withoutExt = relativePath.replace(/\.tsx?$/, "");
-  const candidates = [
-    path.join(baseDir, `${withoutExt}.js`),
-    path.join(baseDir, "dist", `${withoutExt.replace(/^src\//, "")}.js`),
-    path.join(baseDir, "build", `${withoutExt.replace(/^src\//, "")}.js`),
-    path.join(baseDir, "lib", `${withoutExt.replace(/^src\//, "")}.js`)
-  ];
-  for (const candidate of candidates) {
-    if (fs.existsSync(candidate)) {
-      return candidate;
-    }
-  }
-  return null;
-}
-async function extractStandardSchemas(compiledJsPath, options = {}) {
-  const { timeout = 1e4, target = "draft-2020-12", libraryOptions } = options;
-  const result = {
-    schemas: new Map,
-    errors: []
-  };
-  if (!fs.existsSync(compiledJsPath)) {
-    result.errors.push(`Compiled JS not found: ${compiledJsPath}`);
-    return result;
-  }
-  const optionsJson = JSON.stringify({ target, libraryOptions });
-  return new Promise((resolve) => {
-    const child = spawn("node", ["-e", WORKER_SCRIPT, compiledJsPath, optionsJson], {
-      timeout,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-    let stdout = "";
-    let stderr = "";
-    child.stdout.on("data", (data) => {
-      stdout += data.toString();
-    });
-    child.stderr.on("data", (data) => {
-      stderr += data.toString();
-    });
-    child.on("close", (code) => {
-      if (code !== 0) {
-        result.errors.push(`Extraction process failed: ${stderr || `exit code ${code}`}`);
-        resolve(result);
-        return;
-      }
-      try {
-        const parsed = JSON.parse(stdout);
-        if (!parsed.success) {
-          result.errors.push(`Extraction failed: ${parsed.error}`);
-          resolve(result);
-          return;
-        }
-        for (const item of parsed.results) {
-          result.schemas.set(item.exportName, {
-            exportName: item.exportName,
-            vendor: item.vendor,
-            outputSchema: item.outputSchema,
-            inputSchema: item.inputSchema
-          });
-        }
-      } catch (e) {
-        result.errors.push(`Failed to parse extraction output: ${e}`);
-      }
-      resolve(result);
-    });
-    child.on("error", (err) => {
-      result.errors.push(`Subprocess error: ${err.message}`);
-      resolve(result);
-    });
-  });
-}
-async function extractStandardSchemasFromProject(entryFile, baseDir, options = {}) {
-  const compiledPath = resolveCompiledPath(entryFile, baseDir);
-  if (!compiledPath) {
-    return {
-      schemas: new Map,
-      errors: [`Could not find compiled JS for ${entryFile}. Build the project first.`]
-    };
-  }
-  return extractStandardSchemas(compiledPath, options);
-}
 // src/types/utils.ts
 function isExported(node) {
   const modifiers = node.modifiers;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/extract",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "TypeScript export extraction to OpenPkg spec",
   "keywords": [
     "openpkg",