@orval/core 8.8.1 → 8.9.1

package/dist/index.d.mts

@@ -186,6 +186,7 @@ interface NormalizedOperationOptions {
 interface NormalizedInputOptions {
   target: string | OpenApiDocument;
   override: OverrideInput;
+  unsafeDisableValidation: boolean;
   filters?: InputFiltersOptions;
   parserOptions?: {
     headers?: {
@@ -284,6 +285,16 @@ interface InputFiltersOptions {
 interface InputOptions {
   target: string | string[] | Record<string, unknown> | OpenApiDocument;
   override?: OverrideInput;
+  /**
+   * Disable OpenAPI spec validation.
+   *
+   * **Use at your own risk** — code generation with invalid specs is not guaranteed
+   * to work and may break in minor updates. Bug reports with validation disabled are
+   * not accepted.
+   *
+   * @default false
+   */
+  unsafeDisableValidation?: boolean;
   filters?: InputFiltersOptions;
   parserOptions?: {
     headers?: {
@@ -948,6 +959,8 @@ interface GeneratorClient {
   implementation: string;
   imports: GeneratorImport[];
   mutators?: GeneratorMutator[];
+  /** When set, overrides the default verbOption.doc prepended to the implementation */
+  docComment?: string;
 }
 interface GeneratorMutatorParsingInfo {
   numberOfParams: number;
@@ -1297,6 +1310,12 @@ declare function generateVerbImports({
   params
 }: GeneratorVerbOptions): GeneratorImport[];
 //#endregion
+//#region src/generators/input-filters.d.ts
+declare const COMPONENT_TYPES: readonly ["schemas", "responses", "parameters", "requestBodies"];
+type ComponentType = (typeof COMPONENT_TYPES)[number];
+declare function filteredVerbs(verbs: OpenApiPathItemObject, filters: NormalizedInputOptions['filters']): [string, any][];
+declare const collectReferencedComponents: (spec: OpenApiDocument, tags: (string | RegExp)[], mode: InputFiltersOptions["mode"]) => Record<ComponentType, string[]>;
+//#endregion
 //#region src/generators/models-inline.d.ts
 declare function generateModelInline(acc: string, model: string): string;
 declare function generateModelsInline(obj: Record<string, GeneratorSchema[]> | GeneratorSchema[]): string;
@@ -1509,7 +1528,6 @@ declare function generateVerbsOptions({
   pathRoute,
   context
 }: GenerateVerbsOptionsParams): Promise<GeneratorVerbsOptions>;
-declare function _filteredVerbs(verbs: OpenApiPathItemObject, filters: NormalizedInputOptions['filters']): [string, any][];
 //#endregion
 //#region src/getters/object.d.ts
 /**
@@ -1627,10 +1645,10 @@ declare function combineSchemas({
 declare function resolveDiscriminators(schemas: OpenApiSchemasObject, context: ContextSpec): OpenApiSchemasObject;
 //#endregion
 //#region src/getters/enum.d.ts
-declare function getEnumNames(schemaObject: OpenApiSchemaObject | undefined): string[] | undefined;
-declare function getEnumDescriptions(schemaObject: OpenApiSchemaObject | undefined): string[] | undefined;
-declare function getEnum(value: string, enumName: string, names: string[] | undefined, enumGenerationType: EnumGeneration, descriptions?: string[], enumNamingConvention?: NamingConvention): string;
-declare function getEnumImplementation(value: string, names?: string[], descriptions?: string[], enumNamingConvention?: NamingConvention): string;
+declare function getEnumNames(schemaObject: OpenApiSchemaObject | undefined): (string | undefined)[] | undefined;
+declare function getEnumDescriptions(schemaObject: OpenApiSchemaObject | undefined): (string | undefined)[] | undefined;
+declare function getEnum(value: string, enumName: string, names: (string | undefined)[] | undefined, enumGenerationType: EnumGeneration, descriptions?: (string | undefined)[], enumNamingConvention?: NamingConvention): string;
+declare function getEnumImplementation(value: string, names?: (string | undefined)[], descriptions?: (string | undefined)[], enumNamingConvention?: NamingConvention): string;
 interface CombinedEnumInput {
   value: string;
   isRef: boolean;
@@ -2346,5 +2364,5 @@ declare function generateTargetForTags(builder: WriteSpecBuilder, options: Norma
 declare function getOrvalGeneratedTypes(): string;
 declare function getTypedResponse(): string;
 //#endregion
-export { AngularHttpResourceOptions, AngularOptions, BODY_TYPE_NAME, BaseUrlFromConstant, BaseUrlFromSpec, BaseUrlRuntime, ClientBuilder, ClientDependenciesBuilder, ClientExtraFilesBuilder, ClientFileBuilder, ClientFooterBuilder, ClientGeneratorsBuilder, ClientHeaderBuilder, ClientMockBuilder, ClientMockGeneratorBuilder, ClientMockGeneratorImplementation, ClientTitleBuilder, Config, ConfigExternal, ConfigFn, ContentTypeFilter, ContextSpec, DeepNonNullable, EnumGeneration, ErrorWithTag, FetchOptions, FormDataArrayHandling, FormDataContext, FormDataType, GenerateMockImports, GenerateVerbOptionsParams, GenerateVerbsOptionsParams, GeneratorApiBuilder, GeneratorApiOperations, GeneratorApiResponse, GeneratorClient, GeneratorClientExtra, GeneratorClientFooter, GeneratorClientHeader, GeneratorClientImports, GeneratorClientTitle, GeneratorClients, GeneratorDependency, GeneratorImport, GeneratorMutator, GeneratorMutatorParsingInfo, GeneratorOperation, GeneratorOperations, GeneratorOptions, GeneratorSchema, GeneratorTarget, GeneratorTargetFull, GeneratorVerbOptions, GeneratorVerbsOptions, GetterBody, GetterParam, GetterParameters, GetterParams, GetterProp, GetterPropType, GetterProps, GetterQueryParam, GetterResponse, GlobalMockOptions, GlobalOptions, HonoOptions, Hook, HookCommand, HookFunction, HookOption, HooksOptions, ImportOpenApi, InputFiltersOptions, InputOptions, InputTransformerFn, InvalidateTarget, InvalidateTargetParam, JsDocOptions, LogLevel, LogLevels, LogOptions, LogType, Logger, LoggerOptions, McpOptions, McpServerOptions, MockData, MockDataArray, MockDataArrayFn, MockDataObject, MockDataObjectFn, MockOptions, MockProperties, MockPropertiesObject, MockPropertiesObjectFn, MutationInvalidatesConfig, MutationInvalidatesRule, Mutator, MutatorObject, NamingConvention, NormalizedAngularOptions, NormalizedConfig, NormalizedFetchOptions, NormalizedFormDataType, NormalizedHonoOptions, NormalizedHookCommand, NormalizedHookOptions, NormalizedInputOptions, NormalizedJsDocOptions, NormalizedMcpOptions, NormalizedMcpServerOptions, NormalizedMutator, NormalizedOperationOptions, NormalizedOptions, NormalizedOutputOptions, NormalizedOverrideOutput, NormalizedParamsSerializerOptions, NormalizedQueryOptions, NormalizedSchemaOptions, NormalizedZodOptions, OpenApiComponentsObject, OpenApiDocument, OpenApiEncodingObject, OpenApiExampleObject, OpenApiInfoObject, OpenApiMediaTypeObject, OpenApiOperationObject, OpenApiParameterObject, OpenApiPathItemObject, OpenApiPathsObject, OpenApiReferenceObject, OpenApiRequestBodyObject, OpenApiResponseObject, OpenApiResponsesObject, OpenApiSchemaObject, OpenApiSchemaObjectType, OpenApiSchemasObject, OpenApiServerObject, OperationOptions, Options, OptionsExport, OptionsFn, OutputClient, OutputClientFunc, OutputDocsOptions, OutputHttpClient, OutputMockType, OutputMode, OutputOptions, OverrideInput, OverrideMockOptions, OverrideOutput, OverrideOutputContentType, PackageJson, ParamsSerializerOptions, PreferredContentType, PropertySortOrder, QueryOptions, ReadonlyRequestBodiesMode, RefComponentSuffix, RefInfo, ResReqTypesValue, ResolverValue, ResponseTypeCategory, ScalarValue, SchemaGenerationType, SchemaOptions, SchemaType, SupportedFormatter, SwrOptions, TEMPLATE_TAG_REGEX, TsConfigTarget, Tsconfig, URL_REGEX, VERBS_WITH_BODY, Verbs, WriteModeProps, WriteSpecBuilder, ZodCoerceType, ZodDateTimeOptions, ZodOptions, ZodTimeOptions, _filteredVerbs, addDependency, asyncReduce, camel, combineSchemas, compareVersions, conventionName, count, createDebugger, createLogger, createSuccessMessage, createTypeAliasIfNeeded, dedupeUnionType, dynamicImport, escape, escapeRegExp, filterByContentType, fixCrossDirectoryImports, fixRegularSchemaImports, generalJSTypes, generalJSTypesWithArray, generateAxiosOptions, generateBodyMutatorConfig, generateBodyOptions, generateComponentDefinition, generateDependencyImports, generateFormDataAndUrlEncodedFunction, generateImports, generateModelInline, generateModelsInline, generateMutator, generateMutatorConfig, generateMutatorImports, generateMutatorRequestOptions, generateOptions, generateParameterDefinition, generateQueryParamsAxiosConfig, generateSchemasDefinition, generateTarget, generateTargetForTags, generateVerbImports, generateVerbOptions, generateVerbsOptions, getAngularFilteredParamsCallExpression, getAngularFilteredParamsExpression, getAngularFilteredParamsHelperBody, getArray, getBaseUrlRuntimeImports, getBodiesByContentType, getBody, getCombinedEnumValue, getDefaultContentType, getEnum, getEnumDescriptions, getEnumImplementation, getEnumNames, getEnumUnionFromSchema, getExtension, getFileInfo, getFormDataFieldFileType, getFullRoute, getIsBodyVerb, getKey, getMockFileExtensionByTypeName, getNumberWord, getObject, getOperationId, getOrvalGeneratedTypes, getParameters, getParams, getParamsInPath, getPropertySafe, getProps, getQueryParams, getRefInfo, getResReqTypes, getResponse, getResponseTypeCategory, getRoute, getRouteAsArray, getScalar, getSuccessResponseType, getTypedResponse, getWarningCount, isBinaryContentType, isBoolean, isDirectory, isFunction, isModule, isNullish, isNumber, isNumeric, isObject, isReference, isSchema, isString, isStringLike, isSyntheticDefaultImportsAllow, isUrl, isVerb, isVerbose, jsDoc, jsStringEscape, kebab, keyValuePairsToJsDoc, log, logError, logVerbose, logWarning, mergeDeep, mismatchArgsMessage, pascal, removeFilesAndEmptyFolders, resetWarnings, resolveDiscriminators, resolveExampleRefs, resolveInstalledVersion, resolveInstalledVersions, resolveObject, resolveRef, resolveValue, sanitize, setVerbose, snake, sortByPriority, splitSchemasByType, startMessage, stringify, toObjectString, path_d_exports as upath, upper, writeModelInline, writeModelsInline, writeSchema, writeSchemas, writeSingleMode, writeSplitMode, writeSplitTagsMode, writeTagsMode };
+export { AngularHttpResourceOptions, AngularOptions, BODY_TYPE_NAME, BaseUrlFromConstant, BaseUrlFromSpec, BaseUrlRuntime, ClientBuilder, ClientDependenciesBuilder, ClientExtraFilesBuilder, ClientFileBuilder, ClientFooterBuilder, ClientGeneratorsBuilder, ClientHeaderBuilder, ClientMockBuilder, ClientMockGeneratorBuilder, ClientMockGeneratorImplementation, ClientTitleBuilder, Config, ConfigExternal, ConfigFn, ContentTypeFilter, ContextSpec, DeepNonNullable, EnumGeneration, ErrorWithTag, FetchOptions, FormDataArrayHandling, FormDataContext, FormDataType, GenerateMockImports, GenerateVerbOptionsParams, GenerateVerbsOptionsParams, GeneratorApiBuilder, GeneratorApiOperations, GeneratorApiResponse, GeneratorClient, GeneratorClientExtra, GeneratorClientFooter, GeneratorClientHeader, GeneratorClientImports, GeneratorClientTitle, GeneratorClients, GeneratorDependency, GeneratorImport, GeneratorMutator, GeneratorMutatorParsingInfo, GeneratorOperation, GeneratorOperations, GeneratorOptions, GeneratorSchema, GeneratorTarget, GeneratorTargetFull, GeneratorVerbOptions, GeneratorVerbsOptions, GetterBody, GetterParam, GetterParameters, GetterParams, GetterProp, GetterPropType, GetterProps, GetterQueryParam, GetterResponse, GlobalMockOptions, GlobalOptions, HonoOptions, Hook, HookCommand, HookFunction, HookOption, HooksOptions, ImportOpenApi, InputFiltersOptions, InputOptions, InputTransformerFn, InvalidateTarget, InvalidateTargetParam, JsDocOptions, LogLevel, LogLevels, LogOptions, LogType, Logger, LoggerOptions, McpOptions, McpServerOptions, MockData, MockDataArray, MockDataArrayFn, MockDataObject, MockDataObjectFn, MockOptions, MockProperties, MockPropertiesObject, MockPropertiesObjectFn, MutationInvalidatesConfig, MutationInvalidatesRule, Mutator, MutatorObject, NamingConvention, NormalizedAngularOptions, NormalizedConfig, NormalizedFetchOptions, NormalizedFormDataType, NormalizedHonoOptions, NormalizedHookCommand, NormalizedHookOptions, NormalizedInputOptions, NormalizedJsDocOptions, NormalizedMcpOptions, NormalizedMcpServerOptions, NormalizedMutator, NormalizedOperationOptions, NormalizedOptions, NormalizedOutputOptions, NormalizedOverrideOutput, NormalizedParamsSerializerOptions, NormalizedQueryOptions, NormalizedSchemaOptions, NormalizedZodOptions, OpenApiComponentsObject, OpenApiDocument, OpenApiEncodingObject, OpenApiExampleObject, OpenApiInfoObject, OpenApiMediaTypeObject, OpenApiOperationObject, OpenApiParameterObject, OpenApiPathItemObject, OpenApiPathsObject, OpenApiReferenceObject, OpenApiRequestBodyObject, OpenApiResponseObject, OpenApiResponsesObject, OpenApiSchemaObject, OpenApiSchemaObjectType, OpenApiSchemasObject, OpenApiServerObject, OperationOptions, Options, OptionsExport, OptionsFn, OutputClient, OutputClientFunc, OutputDocsOptions, OutputHttpClient, OutputMockType, OutputMode, OutputOptions, OverrideInput, OverrideMockOptions, OverrideOutput, OverrideOutputContentType, PackageJson, ParamsSerializerOptions, PreferredContentType, PropertySortOrder, QueryOptions, ReadonlyRequestBodiesMode, RefComponentSuffix, RefInfo, ResReqTypesValue, ResolverValue, ResponseTypeCategory, ScalarValue, SchemaGenerationType, SchemaOptions, SchemaType, SupportedFormatter, SwrOptions, TEMPLATE_TAG_REGEX, TsConfigTarget, Tsconfig, URL_REGEX, VERBS_WITH_BODY, Verbs, WriteModeProps, WriteSpecBuilder, ZodCoerceType, ZodDateTimeOptions, ZodOptions, ZodTimeOptions, addDependency, asyncReduce, camel, collectReferencedComponents, combineSchemas, compareVersions, conventionName, count, createDebugger, createLogger, createSuccessMessage, createTypeAliasIfNeeded, dedupeUnionType, dynamicImport, escape, escapeRegExp, filterByContentType, filteredVerbs, fixCrossDirectoryImports, fixRegularSchemaImports, generalJSTypes, generalJSTypesWithArray, generateAxiosOptions, generateBodyMutatorConfig, generateBodyOptions, generateComponentDefinition, generateDependencyImports, generateFormDataAndUrlEncodedFunction, generateImports, generateModelInline, generateModelsInline, generateMutator, generateMutatorConfig, generateMutatorImports, generateMutatorRequestOptions, generateOptions, generateParameterDefinition, generateQueryParamsAxiosConfig, generateSchemasDefinition, generateTarget, generateTargetForTags, generateVerbImports, generateVerbOptions, generateVerbsOptions, getAngularFilteredParamsCallExpression, getAngularFilteredParamsExpression, getAngularFilteredParamsHelperBody, getArray, getBaseUrlRuntimeImports, getBodiesByContentType, getBody, getCombinedEnumValue, getDefaultContentType, getEnum, getEnumDescriptions, getEnumImplementation, getEnumNames, getEnumUnionFromSchema, getExtension, getFileInfo, getFormDataFieldFileType, getFullRoute, getIsBodyVerb, getKey, getMockFileExtensionByTypeName, getNumberWord, getObject, getOperationId, getOrvalGeneratedTypes, getParameters, getParams, getParamsInPath, getPropertySafe, getProps, getQueryParams, getRefInfo, getResReqTypes, getResponse, getResponseTypeCategory, getRoute, getRouteAsArray, getScalar, getSuccessResponseType, getTypedResponse, getWarningCount, isBinaryContentType, isBoolean, isDirectory, isFunction, isModule, isNullish, isNumber, isNumeric, isObject, isReference, isSchema, isString, isStringLike, isSyntheticDefaultImportsAllow, isUrl, isVerb, isVerbose, jsDoc, jsStringEscape, kebab, keyValuePairsToJsDoc, log, logError, logVerbose, logWarning, mergeDeep, mismatchArgsMessage, pascal, removeFilesAndEmptyFolders, resetWarnings, resolveDiscriminators, resolveExampleRefs, resolveInstalledVersion, resolveInstalledVersions, resolveObject, resolveRef, resolveValue, sanitize, setVerbose, snake, sortByPriority, splitSchemasByType, startMessage, stringify, toObjectString, path_d_exports as upath, upper, writeModelInline, writeModelsInline, writeSchema, writeSchemas, writeSingleMode, writeSplitMode, writeSplitTagsMode, writeTagsMode };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -279,7 +279,11 @@ function compareVersions(firstVersion, secondVersions, operator = ">=") {
 }
 //#endregion
 //#region src/utils/content-type.ts
-const binaryApplicationTypes = new Set(["application/octet-stream", "application/pdf"]);
+const binaryApplicationTypes = new Set([
+	"application/octet-stream",
+	"application/pdf",
+	"application/zip"
+]);
 /**
 * Determine if a content type is binary.
 * Only known binary types return true. Unknown types default to false (non-binary)
@@ -1034,12 +1038,20 @@ function replaceSpecialCharacters(key) {
 function getEnumNames(schemaObject) {
 	const names = schemaObject?.["x-enumNames"] ?? schemaObject?.["x-enumnames"] ?? schemaObject?.["x-enum-varnames"];
 	if (!names) return;
-	return names.map((name) => jsStringEscape(name));
+	if (Array.isArray(names)) return names.map((name) => jsStringEscape(name));
+	if (typeof names === "object") return (schemaObject?.enum ?? []).map((enumVal) => {
+		const key = String(enumVal);
+		return key in names ? jsStringEscape(names[key]) : void 0;
+	});
 }
 function getEnumDescriptions(schemaObject) {
 	const descriptions = schemaObject?.["x-enumDescriptions"] ?? schemaObject?.["x-enumdescriptions"] ?? schemaObject?.["x-enum-descriptions"];
 	if (!descriptions) return;
-	return descriptions.map((description) => jsStringEscape(description));
+	if (Array.isArray(descriptions)) return descriptions.map((description) => jsStringEscape(description));
+	if (typeof descriptions === "object") return (schemaObject?.enum ?? []).map((enumVal) => {
+		const key = String(enumVal);
+		return key in descriptions ? jsStringEscape(descriptions[key]) : void 0;
+	});
 }
 function getEnum(value, enumName, names, enumGenerationType, descriptions, enumNamingConvention) {
 	if (enumGenerationType === EnumGeneration.CONST) return getTypeConstEnum(value, enumName, names, descriptions, enumNamingConvention);
@@ -1633,7 +1645,7 @@ function getResReqTypes(responsesOrRequests, name, context, defaultType = "unkno
 				name,
 				schemaObject: mediaType.schema,
 				context,
-				isRequestBodyOptional: "required" in bodySchema && bodySchema.required === false,
+				isRequestBodyOptional: bodySchema.required !== true,
 				isRef: true,
 				encoding: mediaType.encoding
 			}) : void 0;
@@ -1641,7 +1653,7 @@ function getResReqTypes(responsesOrRequests, name, context, defaultType = "unkno
 				name,
 				schemaObject: mediaType.schema,
 				context,
-				isRequestBodyOptional: "required" in bodySchema && bodySchema.required === false,
+				isRequestBodyOptional: bodySchema.required !== true,
 				isUrlEncoded: true,
 				isRef: true,
 				encoding: mediaType.encoding
@@ -1674,11 +1686,13 @@ function getResReqTypes(responsesOrRequests, name, context, defaultType = "unkno
 		if (res.content) return Object.entries(res.content).map(([contentType, mediaType], index, arr) => {
 			let propName = key ? pascal(name) + pascal(key) : void 0;
 			if (propName && arr.length > 1) propName = propName + pascal(getNumberWord(index + 1));
+			const isFormData = formDataContentTypes.has(contentType);
+			const isFormUrlEncoded = formUrlEncodedContentTypes.has(contentType);
 			let effectivePropName = propName;
 			if (mediaType.schema && isReference(mediaType.schema)) {
 				const { imports } = resolveSchemaRef(mediaType.schema, context);
 				if (imports[0]?.name) effectivePropName = imports[0].name;
-			} else if (mediaType.schema) {
+			} else if ((isFormData || isFormUrlEncoded) && mediaType.schema) {
 				const combinedRefs = getSchemaOneOf(mediaType.schema) ?? getSchemaAnyOf(mediaType.schema);
 				if (combinedRefs) {
 					const names = [];
@@ -1690,7 +1704,6 @@ function getResReqTypes(responsesOrRequests, name, context, defaultType = "unkno
 					if (names.length > 0) effectivePropName = names.join("");
 				}
 			}
-			const isFormData = formDataContentTypes.has(contentType);
 			const resolvedValue = getResReqContentTypes({
 				mediaType,
 				propName: effectivePropName,
@@ -1712,7 +1725,6 @@ function getResReqTypes(responsesOrRequests, name, context, defaultType = "unkno
 				};
 				return;
 			}
-			const isFormUrlEncoded = formUrlEncodedContentTypes.has(contentType);
 			if (!isFormData && !isFormUrlEncoded || !effectivePropName || !mediaType.schema) return {
 				...resolvedValue,
 				imports: resolvedValue.imports,
@@ -1725,7 +1737,7 @@ function getResReqTypes(responsesOrRequests, name, context, defaultType = "unkno
 				name: effectivePropName,
 				schemaObject: mediaType.schema,
 				context,
-				isRequestBodyOptional: "required" in res && res.required === false,
+				isRequestBodyOptional: res.required !== true,
 				isRef: true,
 				encoding: mediaType.encoding
 			}) : void 0;
@@ -1734,7 +1746,7 @@ function getResReqTypes(responsesOrRequests, name, context, defaultType = "unkno
 				schemaObject: mediaType.schema,
 				context,
 				isUrlEncoded: true,
-				isRequestBodyOptional: "required" in res && res.required === false,
+				isRequestBodyOptional: res.required !== true,
 				isRef: true,
 				encoding: mediaType.encoding
 			}) : void 0;
@@ -1923,7 +1935,7 @@ function resolveSchemaPropertiesToFormData({ schema, variableName, propName, con
 			keyPrefix: `${keyPrefix}${key}.`,
 			depth: depth + 1,
 			encoding
-		}) : partContentType ? `${variableName}.append(\`${keyPrefix}${key}\`, new Blob([JSON.stringify(${nonOptionalValueKey})], { type: '${partContentType}' }));\n` : `${variableName}.append(\`${keyPrefix}${key}\`, JSON.stringify(${nonOptionalValueKey}));\n`;
+		}) : `${variableName}.append(\`${keyPrefix}${key}\`, JSON.stringify(${nonOptionalValueKey}));\n`;
 		else if (property.type === "array") {
 			let valueStr = "value";
 			let hasNonPrimitiveChild = false;
@@ -2013,8 +2025,8 @@ function buildBody(filteredBodyTypes, requestBody, operationName, context) {
 		});
 		if (isReference(requestBody)) {
 			const { schema: bodySchema } = resolveRef(requestBody, context);
-			if (bodySchema.required !== void 0) isOptional = !bodySchema.required;
-		} else if (requestBody.required !== void 0) isOptional = !requestBody.required;
+			isOptional = bodySchema.required !== true;
+		} else isOptional = requestBody.required !== true;
 	}
 	return {
 		originalSchema: requestBody,
@@ -2269,6 +2281,8 @@ function getObject({ item, name, context, nullable, formDataContext }) {
 						const keyType = getIndexSignatureKey(schemaItem);
 						acc.value += `\n  [key: ${keyType}]: ${resolvedValue.value};\n}`;
 					}
+					acc.imports.push(...resolvedValue.imports);
+					acc.schemas.push(...resolvedValue.schemas);
 					acc.dependencies.push(...resolvedValue.dependencies);
 				}
 				else acc.value += "\n}";
@@ -3270,18 +3284,18 @@ function addDependency({ implementation, exports, dependency, projectName, isAll
 		});
 		if (types.length > 0) {
 			let uniqueTypes = types;
-			if (values.length > 0) {
-				uniqueTypes = types.filter((t) => !values.some((v) => v.name === t.name && (v.alias ?? "") === (t.alias ?? "")));
-				dep += "\n";
+			if (values.length > 0) uniqueTypes = types.filter((t) => !values.some((v) => v.name === t.name && (v.alias ?? "") === (t.alias ?? "")));
+			if (uniqueTypes.length > 0) {
+				if (values.length > 0) dep += "\n";
+				dep += generateDependency({
+					deps: uniqueTypes,
+					isAllowSyntheticDefaultImports,
+					dependency,
+					projectName,
+					key,
+					onlyTypes: true
+				});
 			}
-			dep += generateDependency({
-				deps: uniqueTypes,
-				isAllowSyntheticDefaultImports,
-				dependency,
-				projectName,
-				key,
-				onlyTypes: true
-			});
 		}
 		return dep;
 	}).join("\n") + "\n";
@@ -3326,6 +3340,70 @@ function generateVerbImports({ response, body, queryParams, props, headers, para
 	});
 }
 //#endregion
+//#region src/generators/input-filters.ts
+const COMPONENT_TYPES = [
+	"schemas",
+	"responses",
+	"parameters",
+	"requestBodies"
+];
+function filteredVerbs(verbs, filters) {
+	if (filters?.tags === void 0) return Object.entries(verbs);
+	const filterTags = filters.tags;
+	const filterMode = filters.mode ?? "include";
+	return Object.entries(verbs).filter(([, operation]) => {
+		const isMatch = (operation.tags ?? []).some((tag) => filterTags.some((filterTag) => filterTag instanceof RegExp ? filterTag.test(tag) : filterTag === tag));
+		return filterMode === "exclude" ? !isMatch : isMatch;
+	});
+}
+function findRefs(value) {
+	if (!value || typeof value !== "object") return [];
+	if (Array.isArray(value)) return value.flatMap((item) => findRefs(item));
+	const obj = value;
+	if (typeof obj.$ref === "string") return [obj.$ref];
+	return Object.values(obj).flatMap((val) => findRefs(val));
+}
+function parseComponentRef(ref) {
+	const parts = ref.split("/");
+	if (parts[0] !== "#" || parts[1] !== "components" || parts.length < 4) return;
+	const type = parts[2];
+	const name = parts[3];
+	if (!COMPONENT_TYPES.includes(type)) return;
+	return {
+		type,
+		name
+	};
+}
+function getComponentNames(refs, spec) {
+	return refs.map((ref) => parseComponentRef(ref)).filter((parsed) => !!parsed && !!spec.components?.[parsed.type]?.[parsed.name]);
+}
+function resolveReferencedComponents(refs, spec, resolved) {
+	const newComponents = getComponentNames(refs, spec).filter(({ type, name }) => !resolved[type].includes(name));
+	if (newComponents.length === 0) return resolved;
+	const nextResolved = {
+		schemas: [...resolved.schemas],
+		responses: [...resolved.responses],
+		parameters: [...resolved.parameters],
+		requestBodies: [...resolved.requestBodies]
+	};
+	for (const { type, name } of newComponents) nextResolved[type].push(name);
+	return resolveReferencedComponents(newComponents.flatMap(({ type, name }) => findRefs(spec.components?.[type]?.[name])), spec, nextResolved);
+}
+const collectReferencedComponents = (spec, tags, mode) => {
+	const filters = {
+		tags,
+		mode
+	};
+	return resolveReferencedComponents(Object.values(spec.paths ?? {}).filter((pathItem) => !!pathItem).flatMap((pathItem) => {
+		return [...filteredVerbs(pathItem, filters).flatMap(([, operation]) => findRefs(operation)), ...findRefs(pathItem.parameters)];
+	}), spec, {
+		schemas: [],
+		responses: [],
+		parameters: [],
+		requestBodies: []
+	});
+};
+//#endregion
 //#region src/generators/models-inline.ts
 function generateModelInline(acc, model) {
 	return acc + `${model}\n`;
@@ -3678,7 +3756,8 @@ function generateQueryParamsAxiosConfig(response, isVue, isAngular, requiredNull
 function generateMutatorConfig({ route, body, headers, queryParams, response, verb, isFormData, isFormUrlEncoded, hasSignal, hasSignalParam = false, isExactOptionalPropertyTypes, isVue, isAngular }) {
 	const bodyOptions = getIsBodyVerb(verb) ? generateBodyMutatorConfig(body, isFormData, isFormUrlEncoded) : "";
 	const queryParamsOptions = generateQueryParamsAxiosConfig(response, isVue ?? false, isAngular ?? false, queryParams?.requiredNullableKeys, queryParams);
-	const headerOptions = body.contentType && !["multipart/form-data"].includes(body.contentType) ? `,\n      headers: {'Content-Type': '${body.contentType}', ${headers ? "...headers" : ""}}` : headers ? ",\n      headers" : "";
+	const ignoreContentTypes = isAngular ? ["multipart/form-data"] : [];
+	const headerOptions = body.contentType && !ignoreContentTypes.includes(body.contentType) ? `,\n      headers: {'Content-Type': '${body.contentType}', ${headers ? "...headers" : ""}}` : headers ? ",\n      headers" : "";
 	const signalVar = hasSignalParam ? "querySignal" : "signal";
 	const signalProp = hasSignalParam ? `signal: ${signalVar}` : "signal";
 	return `{url: \`${route}\`, method: '${verb.toUpperCase()}'${headerOptions}${bodyOptions}${queryParamsOptions}${hasSignal ? `, ${isExactOptionalPropertyTypes ? `...(${signalVar} ? { ${signalProp} }: {})` : signalProp}` : ""}\n    }`;
@@ -4086,7 +4165,7 @@ async function generateVerbOptions({ verb, output, operation, route, pathRoute,
 	})];
 }
 function generateVerbsOptions({ verbs, input, output, route, pathRoute, context }) {
-	return asyncReduce(_filteredVerbs(verbs, input.filters), async (acc, [verb, operation]) => {
+	return asyncReduce(filteredVerbs(verbs, input.filters), async (acc, [verb, operation]) => {
 		if (isVerb(verb)) {
 			const verbOptions = await generateVerbOptions({
 				verb,
@@ -4102,15 +4181,6 @@ function generateVerbsOptions({ verbs, input, output, route, pathRoute, context
 		return acc;
 	}, []);
 }
-function _filteredVerbs(verbs, filters) {
-	if (filters?.tags === void 0) return Object.entries(verbs);
-	const filterTags = filters.tags;
-	const filterMode = filters.mode ?? "include";
-	return Object.entries(verbs).filter(([, operation]) => {
-		const isMatch = (operation.tags ?? []).some((tag) => filterTags.some((filterTag) => filterTag instanceof RegExp ? filterTag.test(tag) : filterTag === tag));
-		return filterMode === "exclude" ? !isMatch : isMatch;
-	});
-}
 //#endregion
 //#region src/writers/file.ts
 const TRAILING_WHITESPACE_RE = /[^\S\r\n]+$/gm;
@@ -4584,8 +4654,8 @@ async function writeSplitMode({ builder, output, projectName, header, needSchema
 			isAllowSyntheticDefaultImports,
 			options: isFunction(output.mock) ? void 0 : output.mock
 		});
-		const schemasPath = output.schemas ? void 0 : nodePath.join(dirname, filename + ".schemas" + extension);
-		if (schemasPath && needSchema) await writeGeneratedFile(schemasPath, generateSchemasInline ? header + generateSchemasInline() : header + generateModelsInline(builder.schemas));
+		const schemasPath = !output.schemas && needSchema ? nodePath.join(dirname, filename + ".schemas" + extension) : void 0;
+		if (schemasPath) await writeGeneratedFile(schemasPath, generateSchemasInline ? header + generateSchemasInline() : header + generateModelsInline(builder.schemas));
 		if (mutators) implementationData += generateMutatorImports({
 			mutators,
 			implementation
@@ -4793,8 +4863,8 @@ async function writeSplitTagsMode({ builder, output, projectName, header, needSc
 				isAllowSyntheticDefaultImports,
 				options: isFunction(output.mock) ? void 0 : output.mock
 			});
-			const schemasPath = output.schemas ? void 0 : nodePath.join(dirname, filename + ".schemas" + extension);
-			if (schemasPath && needSchema) await writeGeneratedFile(schemasPath, generateSchemasInline ? header + generateSchemasInline() : header + generateModelsInline(builder.schemas));
+			const schemasPath = !output.schemas && needSchema ? nodePath.join(dirname, filename + ".schemas" + extension) : void 0;
+			if (schemasPath) await writeGeneratedFile(schemasPath, generateSchemasInline ? header + generateSchemasInline() : header + generateModelsInline(builder.schemas));
 			if (mutators) implementationData += generateMutatorImports({
 				mutators,
 				implementation,
@@ -4902,8 +4972,8 @@ async function writeTagsMode({ builder, output, projectName, header, needSchema,
 					options: isFunction(output.mock) ? void 0 : output.mock
 				});
 			}
-			const schemasPath = output.schemas ? void 0 : nodePath.join(dirname, filename + ".schemas" + extension);
-			if (schemasPath && needSchema) await writeGeneratedFile(schemasPath, generateSchemasInline ? header + generateSchemasInline() : header + generateModelsInline(builder.schemas));
+			const schemasPath = !output.schemas && needSchema ? nodePath.join(dirname, filename + ".schemas" + extension) : void 0;
+			if (schemasPath) await writeGeneratedFile(schemasPath, generateSchemasInline ? header + generateSchemasInline() : header + generateModelsInline(builder.schemas));
 			if (mutators) data += generateMutatorImports({
 				mutators,
 				implementation
@@ -4936,6 +5006,6 @@ async function writeTagsMode({ builder, output, projectName, header, needSchema,
 	}))).flat();
 }
 //#endregion
-export { BODY_TYPE_NAME, EnumGeneration, ErrorWithTag, FormDataArrayHandling, GetterPropType, LogLevels, NamingConvention, OutputClient, OutputHttpClient, OutputMockType, OutputMode, PropertySortOrder, RefComponentSuffix, SchemaType, SupportedFormatter, TEMPLATE_TAG_REGEX, URL_REGEX, VERBS_WITH_BODY, Verbs, _filteredVerbs, addDependency, asyncReduce, camel, combineSchemas, compareVersions, conventionName, count, createDebugger, createLogger, createSuccessMessage, createTypeAliasIfNeeded, dedupeUnionType, dynamicImport, escape, escapeRegExp, filterByContentType, fixCrossDirectoryImports, fixRegularSchemaImports, generalJSTypes, generalJSTypesWithArray, generateAxiosOptions, generateBodyMutatorConfig, generateBodyOptions, generateComponentDefinition, generateDependencyImports, generateFormDataAndUrlEncodedFunction, generateImports, generateModelInline, generateModelsInline, generateMutator, generateMutatorConfig, generateMutatorImports, generateMutatorRequestOptions, generateOptions, generateParameterDefinition, generateQueryParamsAxiosConfig, generateSchemasDefinition, generateTarget, generateTargetForTags, generateVerbImports, generateVerbOptions, generateVerbsOptions, getAngularFilteredParamsCallExpression, getAngularFilteredParamsExpression, getAngularFilteredParamsHelperBody, getArray, getBaseUrlRuntimeImports, getBodiesByContentType, getBody, getCombinedEnumValue, getDefaultContentType, getEnum, getEnumDescriptions, getEnumImplementation, getEnumNames, getEnumUnionFromSchema, getExtension, getFileInfo, getFormDataFieldFileType, getFullRoute, getIsBodyVerb, getKey, getMockFileExtensionByTypeName, getNumberWord, getObject, getOperationId, getOrvalGeneratedTypes, getParameters, getParams, getParamsInPath, getPropertySafe, getProps, getQueryParams, getRefInfo, getResReqTypes, getResponse, getResponseTypeCategory, getRoute, getRouteAsArray, getScalar, getSuccessResponseType, getTypedResponse, getWarningCount, isBinaryContentType, isBoolean, isDirectory, isFunction, isModule, isNullish, isNumber, isNumeric, isObject, isReference, isSchema, isString, isStringLike, isSyntheticDefaultImportsAllow, isUrl, isVerb, isVerbose, jsDoc, jsStringEscape, kebab, keyValuePairsToJsDoc, log, logError, logVerbose, logWarning, mergeDeep, mismatchArgsMessage, pascal, removeFilesAndEmptyFolders, resetWarnings, resolveDiscriminators, resolveExampleRefs, resolveInstalledVersion, resolveInstalledVersions, resolveObject, resolveRef, resolveValue, sanitize, setVerbose, snake, sortByPriority, splitSchemasByType, startMessage, stringify, toObjectString, path_exports as upath, upper, writeModelInline, writeModelsInline, writeSchema, writeSchemas, writeSingleMode, writeSplitMode, writeSplitTagsMode, writeTagsMode };
+export { BODY_TYPE_NAME, EnumGeneration, ErrorWithTag, FormDataArrayHandling, GetterPropType, LogLevels, NamingConvention, OutputClient, OutputHttpClient, OutputMockType, OutputMode, PropertySortOrder, RefComponentSuffix, SchemaType, SupportedFormatter, TEMPLATE_TAG_REGEX, URL_REGEX, VERBS_WITH_BODY, Verbs, addDependency, asyncReduce, camel, collectReferencedComponents, combineSchemas, compareVersions, conventionName, count, createDebugger, createLogger, createSuccessMessage, createTypeAliasIfNeeded, dedupeUnionType, dynamicImport, escape, escapeRegExp, filterByContentType, filteredVerbs, fixCrossDirectoryImports, fixRegularSchemaImports, generalJSTypes, generalJSTypesWithArray, generateAxiosOptions, generateBodyMutatorConfig, generateBodyOptions, generateComponentDefinition, generateDependencyImports, generateFormDataAndUrlEncodedFunction, generateImports, generateModelInline, generateModelsInline, generateMutator, generateMutatorConfig, generateMutatorImports, generateMutatorRequestOptions, generateOptions, generateParameterDefinition, generateQueryParamsAxiosConfig, generateSchemasDefinition, generateTarget, generateTargetForTags, generateVerbImports, generateVerbOptions, generateVerbsOptions, getAngularFilteredParamsCallExpression, getAngularFilteredParamsExpression, getAngularFilteredParamsHelperBody, getArray, getBaseUrlRuntimeImports, getBodiesByContentType, getBody, getCombinedEnumValue, getDefaultContentType, getEnum, getEnumDescriptions, getEnumImplementation, getEnumNames, getEnumUnionFromSchema, getExtension, getFileInfo, getFormDataFieldFileType, getFullRoute, getIsBodyVerb, getKey, getMockFileExtensionByTypeName, getNumberWord, getObject, getOperationId, getOrvalGeneratedTypes, getParameters, getParams, getParamsInPath, getPropertySafe, getProps, getQueryParams, getRefInfo, getResReqTypes, getResponse, getResponseTypeCategory, getRoute, getRouteAsArray, getScalar, getSuccessResponseType, getTypedResponse, getWarningCount, isBinaryContentType, isBoolean, isDirectory, isFunction, isModule, isNullish, isNumber, isNumeric, isObject, isReference, isSchema, isString, isStringLike, isSyntheticDefaultImportsAllow, isUrl, isVerb, isVerbose, jsDoc, jsStringEscape, kebab, keyValuePairsToJsDoc, log, logError, logVerbose, logWarning, mergeDeep, mismatchArgsMessage, pascal, removeFilesAndEmptyFolders, resetWarnings, resolveDiscriminators, resolveExampleRefs, resolveInstalledVersion, resolveInstalledVersions, resolveObject, resolveRef, resolveValue, sanitize, setVerbose, snake, sortByPriority, splitSchemasByType, startMessage, stringify, toObjectString, path_exports as upath, upper, writeModelInline, writeModelsInline, writeSchema, writeSchemas, writeSingleMode, writeSplitMode, writeSplitTagsMode, writeTagsMode };
 
 //# sourceMappingURL=index.mjs.map