@openpkg-ts/extract 0.14.4 → 0.15.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;
 	/**
-	* Build a lightweight stub type (no deep schema extraction).
+	* Check if schema is a self-referential $ref
 	*/
-	private buildStubType;
-	registerFromSymbol(symbol: ts.Symbol, checker: ts.TypeChecker): SpecType | undefined;
+	private isSelfRef;
+	/**
+	* Build object schema from type properties (for interfaces/classes)
+	*/
+	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;
@@ -71,17 +92,17 @@ interface Diagnostic {
 	};
 }
 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 +230,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";

package/dist/src/index.js

@@ -26,7 +26,7 @@ import {
   serializeTypeAlias,
   serializeVariable,
   withDescription
-} from "../shared/chunk-axmbd6k1.js";
+} from "../shared/chunk-0bt6mcnx.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.4",
+  "version": "0.15.0",
   "description": "TypeScript export extraction to OpenPkg spec",
   "keywords": [
     "openpkg",