@openpkg-ts/extract 0.23.2 → 0.24.0

package/dist/src/index.d.ts

@@ -13,6 +13,8 @@ interface SerializerContext {
 	exportedIds: Set<string>;
 	/** Track visited types to prevent infinite recursion */
 	visitedTypes: Set<ts.Type>;
+	/** Flag to indicate we're processing tuple elements - skip Array prototype methods */
+	inTupleElement?: boolean;
 }
 declare class TypeRegistry {
 	private types;
@@ -58,75 +60,13 @@ declare function getParamDescription(propertyName: string, jsdocTags: readonly t
 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>`
+* Also captures variance annotations (in/out) and const modifier.
 */
 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: ts3.Symbol | undefined): boolean;
-import { OpenPkg } from "@openpkg-ts/spec";
-interface ExtractOptions {
-	entryFile: string;
-	baseDir?: string;
-	content?: string;
-	maxTypeDepth?: number;
-	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) */
-	only?: string[];
-	/** Ignore these exports (supports * wildcards) */
-	ignore?: string[];
-}
-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[];
-		/** Extraction method used: 'compiled' or 'direct-ts (runtime)' */
-		method?: string;
-	};
-}
-interface Diagnostic {
-	message: string;
-	severity: "error" | "warning" | "info";
-	code?: string;
-	suggestion?: string;
-	location?: {
-		file?: string;
-		line?: number;
-		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>;
 /**
 * Target version for JSON Schema generation.
 * @see https://standardschema.dev/json-schema
@@ -280,6 +220,69 @@ interface ProjectExtractionOutput extends StandardSchemaExtractionOutput {
 * @param options - Extraction options
 */
 declare function extractStandardSchemasFromProject(entryFile: string, baseDir: string, options?: ExtractFromProjectOptions): Promise<ProjectExtractionOutput>;
+import { OpenPkg } from "@openpkg-ts/spec";
+interface ExtractOptions {
+	entryFile: string;
+	baseDir?: string;
+	content?: string;
+	maxTypeDepth?: number;
+	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) */
+	only?: string[];
+	/** Ignore these exports (supports * wildcards) */
+	ignore?: string[];
+}
+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[];
+		/** Extraction method used: 'compiled' or 'direct-ts (runtime)' */
+		method?: string;
+	};
+}
+interface Diagnostic {
+	message: string;
+	severity: "error" | "warning" | "info";
+	code?: string;
+	suggestion?: string;
+	location?: {
+		file?: string;
+		line?: number;
+		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 ts4 from "typescript";
 interface ProgramOptions {
 	entryFile: string;
@@ -380,11 +383,21 @@ import ts12 from "typescript";
 * Used for types that have specific serialization formats.
 */
 declare const BUILTIN_TYPE_SCHEMAS: Record<string, SpecSchema>;
+declare const ARRAY_PROTOTYPE_METHODS: unknown;
 /**
 * Check if a name is a primitive type
 */
 declare function isPrimitiveName(name: string): boolean;
 /**
+* Get the origin package name for a type if it comes from node_modules.
+* Returns undefined for types defined in the current project.
+*
+* @example
+* getTypeOrigin(trpcRouterType) // Returns '@trpc/server'
+* getTypeOrigin(localUserType) // Returns undefined
+*/
+declare function getTypeOrigin(type: ts12.Type, _checker: ts12.TypeChecker): string | undefined;
+/**
 * Check if a name is a built-in generic type
 */
 declare function isBuiltinGeneric(name: string): boolean;
@@ -425,7 +438,7 @@ declare function deduplicateSchemas(schemas: SpecSchema[]): SpecSchema[];
 * A valid discriminator has a unique literal value in each union member.
 */
 declare function findDiscriminatorProperty(unionTypes: ts12.Type[], checker: ts12.TypeChecker): string | undefined;
-import { SpecSchema as SpecSchema2, SpecExport as SpecExport8, SpecType as SpecType2, SpecMember } from "@openpkg-ts/spec";
+import { SpecExport as SpecExport8, SpecMember, SpecSchema as SpecSchema2, SpecType as SpecType2 } from "@openpkg-ts/spec";
 /**
 * Options for schema normalization
 */
@@ -490,4 +503,4 @@ declare function normalizeMembers(members: SpecMember[], options?: NormalizeOpti
 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, normalizeType, normalizeSchema, normalizeMembers, normalizeExport, isTypeReference, isSymbolDeprecated, isStandardJSONSchema, isSchemaType, isPureRefSchema, isPrimitiveName, isExported, isBuiltinGeneric, isAnonymous, getSourceLocation, getParamDescription, getNonNullableType, getNodeName, getJSDocComment, findDiscriminatorProperty, findAdapter, extractTypeParameters, extractStandardSchemasFromTs, extractStandardSchemasFromProject, extractStandardSchemas, extractSchemaType, extractParameters, extract, detectTsRuntime, deduplicateSchemas, createProgram, buildSchema, arktypeAdapter, TypeRegistry, TypeReference2 as TypeReference, TsRuntime, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, StandardJSONSchemaTarget, StandardJSONSchemaOptions, SerializerContext, SchemaExtractionResult, SchemaAdapter, ProjectExtractionOutput, ProjectExtractionInfo, ProgramResult, ProgramOptions, NormalizeOptions, JSONSchema, ForgottenExport, ExtractStandardSchemasOptions, ExtractResult, ExtractOptions, ExtractFromProjectOptions, Diagnostic, BUILTIN_TYPE_SCHEMAS };
+export { zodAdapter, withDescription, valibotAdapter, typeboxAdapter, serializeVariable, serializeTypeAlias, serializeInterface, serializeFunctionExport, serializeEnum, serializeClass, schemasAreEqual, schemaIsAny, resolveCompiledPath, registerReferencedTypes, registerAdapter, normalizeType, normalizeSchema, normalizeMembers, normalizeExport, isTypeReference, isSymbolDeprecated, isStandardJSONSchema, isSchemaType, isPureRefSchema, isPrimitiveName, isExported, isBuiltinGeneric, isAnonymous, getTypeOrigin, getSourceLocation, getParamDescription, getNonNullableType, getNodeName, getJSDocComment, findDiscriminatorProperty, findAdapter, extractTypeParameters, extractStandardSchemasFromTs, extractStandardSchemasFromProject, extractStandardSchemas, extractSchemaType, extractParameters, extract, detectTsRuntime, deduplicateSchemas, createProgram, buildSchema, arktypeAdapter, TypeRegistry, TypeReference2 as TypeReference, TsRuntime, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, StandardJSONSchemaTarget, StandardJSONSchemaOptions, SerializerContext, SchemaExtractionResult, SchemaAdapter, ProjectExtractionOutput, ProjectExtractionInfo, ProgramResult, ProgramOptions, NormalizeOptions, JSONSchema, ForgottenExport, ExtractStandardSchemasOptions, ExtractResult, ExtractOptions, ExtractFromProjectOptions, Diagnostic, BUILTIN_TYPE_SCHEMAS, ARRAY_PROTOTYPE_METHODS };

package/dist/src/index.js

@@ -1,4 +1,5 @@
 import {
+  ARRAY_PROTOTYPE_METHODS,
   BUILTIN_TYPE_SCHEMAS,
   TypeRegistry,
   arktypeAdapter,
@@ -19,6 +20,7 @@ import {
   getNonNullableType,
   getParamDescription,
   getSourceLocation,
+  getTypeOrigin,
   isAnonymous,
   isBuiltinGeneric,
   isPrimitiveName,
@@ -46,7 +48,7 @@ import {
   valibotAdapter,
   withDescription,
   zodAdapter
-} from "../shared/chunk-8898fs2f.js";
+} from "../shared/chunk-bh378f7b.js";
 // src/types/utils.ts
 function isExported(node) {
   const modifiers = node.modifiers;
@@ -90,6 +92,7 @@ export {
   isExported,
   isBuiltinGeneric,
   isAnonymous,
+  getTypeOrigin,
   getSourceLocation,
   getParamDescription,
   getNonNullableType,
@@ -110,5 +113,6 @@ export {
   buildSchema,
   arktypeAdapter,
   TypeRegistry,
-  BUILTIN_TYPE_SCHEMAS
+  BUILTIN_TYPE_SCHEMAS,
+  ARRAY_PROTOTYPE_METHODS
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/extract",
-  "version": "0.23.2",
+  "version": "0.24.0",
   "description": "TypeScript export extraction to OpenPkg spec",
   "keywords": [
     "openpkg",
@@ -40,7 +40,7 @@
     "format": "biome format --write src/"
   },
   "dependencies": {
-    "@openpkg-ts/spec": "^0.23.0",
+    "@openpkg-ts/spec": "^0.24.0",
     "chalk": "^5.4.1",
     "commander": "^12.0.0",
     "tree-sitter-wasms": "^0.1.13",