@openpkg-ts/extract 0.14.5 → 0.16.0

package/dist/src/index.d.ts

@@ -1,5 +1,19 @@
 import { SpecType } from "@openpkg-ts/spec";
+import ts2 from "typescript";
 import ts from "typescript";
+interface SerializerContext {
+	typeChecker: ts.TypeChecker;
+	program: ts.Program;
+	sourceFile: ts.SourceFile;
+	maxTypeDepth: number;
+	maxExternalTypeDepth: number;
+	currentDepth: number;
+	resolveExternalTypes: boolean;
+	typeRegistry: TypeRegistry;
+	exportedIds: Set<string>;
+	/** Track visited types to prevent infinite recursion */
+	visitedTypes: Set<ts.Type>;
+}
 declare class TypeRegistry {
 	private types;
 	private processing;
@@ -8,24 +22,31 @@ declare class TypeRegistry {
 	has(id: string): boolean;
 	getAll(): SpecType[];
 	/**
-	* Register a type from a ts.Type (lightweight stub).
+	* Register a type from a ts.Type with structured schema.
 	* Returns the type ID if registered, undefined if skipped.
 	*/
-	registerType(type: ts.Type, checker: ts.TypeChecker, exportedIds: Set<string>): string | undefined;
+	registerType(type: ts2.Type, ctx: SerializerContext): string | undefined;
+	/**
+	* Build a SpecType with structured schema using buildSchema.
+	*/
+	private buildSpecType;
+	/**
+	* Check if schema is a self-referential $ref
+	*/
+	private isSelfRef;
 	/**
-	* Build a lightweight stub type (no deep schema extraction).
+	* Build object schema from type properties (for interfaces/classes)
 	*/
-	private buildStubType;
-	registerFromSymbol(symbol: ts.Symbol, checker: ts.TypeChecker): SpecType | undefined;
+	private buildObjectSchemaFromType;
 }
 import { SpecExample, SpecSource, SpecTag, SpecTypeParameter } from "@openpkg-ts/spec";
-import ts2 from "typescript";
-declare function getJSDocComment(node: ts2.Node): {
+import ts3 from "typescript";
+declare function getJSDocComment(node: ts3.Node): {
 	description?: string;
 	tags: SpecTag[];
 	examples: SpecExample[];
 };
-declare function getSourceLocation(node: ts2.Node, sourceFile: ts2.SourceFile): SpecSource;
+declare function getSourceLocation(node: ts3.Node, sourceFile: ts3.SourceFile): SpecSource;
 /**
 * Get description for a destructured parameter property from JSDoc @param tags.
 * Matches patterns like:
@@ -33,16 +54,16 @@ declare function getSourceLocation(node: ts2.Node, sourceFile: ts2.SourceFile):
 * - @param opts.paramName - dotted notation with alias
 * - @param {type} paramName - type annotation format
 */
-declare function getParamDescription(propertyName: string, jsdocTags: readonly ts2.JSDocTag[], inferredAlias?: string): string | undefined;
-type DeclarationWithTypeParams = ts2.FunctionDeclaration | ts2.ClassDeclaration | ts2.InterfaceDeclaration | ts2.TypeAliasDeclaration | ts2.MethodDeclaration | ts2.ArrowFunction;
+declare function getParamDescription(propertyName: string, jsdocTags: readonly ts3.JSDocTag[], inferredAlias?: string): string | undefined;
+type DeclarationWithTypeParams = ts3.FunctionDeclaration | ts3.ClassDeclaration | ts3.InterfaceDeclaration | ts3.TypeAliasDeclaration | ts3.MethodDeclaration | ts3.ArrowFunction;
 /**
 * Extract type parameters from declarations like `<T extends Base, K = Default>`
 */
-declare function extractTypeParameters(node: DeclarationWithTypeParams, checker: ts2.TypeChecker): SpecTypeParameter[] | undefined;
+declare function extractTypeParameters(node: DeclarationWithTypeParams, checker: ts3.TypeChecker): SpecTypeParameter[] | undefined;
 /**
 * Check if a symbol is marked as deprecated via @deprecated JSDoc tag.
 */
-declare function isSymbolDeprecated(symbol: ts2.Symbol | undefined): boolean;
+declare function isSymbolDeprecated(symbol: ts3.Symbol | undefined): boolean;
 import { OpenPkg } from "@openpkg-ts/spec";
 interface ExtractOptions {
 	entryFile: string;
@@ -58,6 +79,7 @@ interface ExtractOptions {
 interface ExtractResult {
 	spec: OpenPkg;
 	diagnostics: Diagnostic[];
+	forgottenExports?: ForgottenExport[];
 }
 interface Diagnostic {
 	message: string;
@@ -70,18 +92,33 @@ interface Diagnostic {
 		column?: number;
 	};
 }
+/** Context tracking for type references in public API */
+interface TypeReference2 {
+	typeName: string;
+	exportName: string;
+	location: "return" | "parameter" | "property" | "extends" | "type-parameter";
+	path?: string;
+}
+/** Structured data for forgotten exports */
+interface ForgottenExport {
+	name: string;
+	definedIn?: string;
+	referencedBy: TypeReference2[];
+	isExternal: boolean;
+	fix?: string;
+}
 declare function extract(options: ExtractOptions): Promise<ExtractResult>;
-import ts3 from "typescript";
+import ts4 from "typescript";
 interface ProgramOptions {
 	entryFile: string;
 	baseDir?: string;
 	content?: string;
 }
 interface ProgramResult {
-	program: ts3.Program;
-	compilerHost: ts3.CompilerHost;
-	compilerOptions: ts3.CompilerOptions;
-	sourceFile?: ts3.SourceFile;
+	program: ts4.Program;
+	compilerHost: ts4.CompilerHost;
+	compilerOptions: ts4.CompilerOptions;
+	sourceFile?: ts4.SourceFile;
 	configPath?: string;
 }
 declare function createProgram({ entryFile, baseDir, content }: ProgramOptions): ProgramResult;
@@ -209,20 +246,6 @@ declare function extractStandardSchemas(compiledJsPath: string, options?: Extrac
 declare function extractStandardSchemasFromProject(entryFile: string, baseDir: string, options?: ExtractStandardSchemasOptions): Promise<StandardSchemaExtractionOutput>;
 import { SpecExport } from "@openpkg-ts/spec";
 import ts5 from "typescript";
-import ts4 from "typescript";
-interface SerializerContext {
-	typeChecker: ts4.TypeChecker;
-	program: ts4.Program;
-	sourceFile: ts4.SourceFile;
-	maxTypeDepth: number;
-	maxExternalTypeDepth: number;
-	currentDepth: number;
-	resolveExternalTypes: boolean;
-	typeRegistry: TypeRegistry;
-	exportedIds: Set<string>;
-	/** Track visited types to prevent infinite recursion */
-	visitedTypes: Set<ts4.Type>;
-}
 declare function serializeClass(node: ts5.ClassDeclaration, ctx: SerializerContext): SpecExport | null;
 import { SpecExport as SpecExport2 } from "@openpkg-ts/spec";
 import ts6 from "typescript";
@@ -302,4 +325,4 @@ declare function findDiscriminatorProperty(unionTypes: ts12.Type[], checker: ts1
 import ts13 from "typescript";
 declare function isExported(node: ts13.Node): boolean;
 declare function getNodeName(node: ts13.Node): string | undefined;
-export { zodAdapter, withDescription, valibotAdapter, typeboxAdapter, serializeVariable, serializeTypeAlias, serializeInterface, serializeFunctionExport, serializeEnum, serializeClass, schemasAreEqual, schemaIsAny, resolveCompiledPath, registerReferencedTypes, registerAdapter, isTypeReference, isSymbolDeprecated, isStandardJSONSchema, isSchemaType, isPureRefSchema, isPrimitiveName, isExported, isBuiltinGeneric, isAnonymous, getSourceLocation, getParamDescription, getNonNullableType, getNodeName, getJSDocComment, findDiscriminatorProperty, findAdapter, extractTypeParameters, extractStandardSchemasFromProject, extractStandardSchemas, extractSchemaType, extractParameters, extract, deduplicateSchemas, createProgram, buildSchema, arktypeAdapter, TypeRegistry, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, SerializerContext, SchemaExtractionResult, SchemaAdapter, ProgramResult, ProgramOptions, ExtractStandardSchemasOptions, ExtractResult, ExtractOptions, Diagnostic, BUILTIN_TYPE_SCHEMAS };
+export { zodAdapter, withDescription, valibotAdapter, typeboxAdapter, serializeVariable, serializeTypeAlias, serializeInterface, serializeFunctionExport, serializeEnum, serializeClass, schemasAreEqual, schemaIsAny, resolveCompiledPath, registerReferencedTypes, registerAdapter, isTypeReference, isSymbolDeprecated, isStandardJSONSchema, isSchemaType, isPureRefSchema, isPrimitiveName, isExported, isBuiltinGeneric, isAnonymous, getSourceLocation, getParamDescription, getNonNullableType, getNodeName, getJSDocComment, findDiscriminatorProperty, findAdapter, extractTypeParameters, extractStandardSchemasFromProject, extractStandardSchemas, extractSchemaType, extractParameters, extract, deduplicateSchemas, createProgram, buildSchema, arktypeAdapter, TypeRegistry, TypeReference2 as TypeReference, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, SerializerContext, SchemaExtractionResult, SchemaAdapter, ProgramResult, ProgramOptions, ForgottenExport, ExtractStandardSchemasOptions, ExtractResult, ExtractOptions, Diagnostic, BUILTIN_TYPE_SCHEMAS };

package/dist/src/index.js

@@ -26,7 +26,7 @@ import {
   serializeTypeAlias,
   serializeVariable,
   withDescription
-} from "../shared/chunk-mhaxcbzq.js";
+} from "../shared/chunk-2v40ecks.js";
 // src/schema/registry.ts
 function isTypeReference(type) {
   return !!(type.flags & 524288 && type.objectFlags && type.objectFlags & 4);

package/package.json

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