@orval/core 8.0.2 → 8.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -99,6 +99,11 @@ type NormalizedOverrideOutput = {
99
99
  suppressReadonlyModifier?: boolean;
100
100
  jsDoc: NormalizedJsDocOptions;
101
101
  aliasCombinedTypes: boolean;
102
+ /**
103
+ * When enabled, optional properties will be typed as `T | null` instead of just `T`.
104
+ * @default false
105
+ */
106
+ useNullForOptional?: boolean;
102
107
  };
103
108
  type NormalizedMutator = {
104
109
  path: string;
@@ -386,6 +391,11 @@ type OverrideOutput = {
386
391
  suppressReadonlyModifier?: boolean;
387
392
  jsDoc?: JsDocOptions;
388
393
  aliasCombinedTypes?: boolean;
394
+ /**
395
+ * When enabled, optional properties will be typed as `T | null` instead of just `T`.
396
+ * @default false
397
+ */
398
+ useNullForOptional?: boolean;
389
399
  };
390
400
  type JsDocOptions = {
391
401
  filter?: (schema: Record<string, any>) => {
@@ -654,6 +664,8 @@ interface PackageJson {
654
664
  dependencies?: Record<string, string>;
655
665
  devDependencies?: Record<string, string>;
656
666
  peerDependencies?: Record<string, string>;
667
+ catalog?: Record<string, string>;
668
+ catalogs?: Record<string, Record<string, string>>;
657
669
  }
658
670
  type GeneratorSchema = {
659
671
  name: string;
@@ -924,6 +936,7 @@ declare const SchemaType: {
924
936
  };
925
937
  type ScalarValue = {
926
938
  value: string;
939
+ useTypeAlias?: boolean;
927
940
  isEnum: boolean;
928
941
  hasReadonlyProps: boolean;
929
942
  type: SchemaType;
@@ -1160,6 +1173,7 @@ interface GenerateAxiosOptions {
1160
1173
  headers?: GeneratorSchema;
1161
1174
  requestOptions?: object | boolean;
1162
1175
  hasSignal: boolean;
1176
+ hasSignalParam?: boolean;
1163
1177
  isVue: boolean;
1164
1178
  isAngular: boolean;
1165
1179
  paramsSerializer?: GeneratorMutator;
@@ -1172,6 +1186,7 @@ declare function generateAxiosOptions({
1172
1186
  headers,
1173
1187
  requestOptions,
1174
1188
  hasSignal,
1189
+ hasSignalParam,
1175
1190
  isVue,
1176
1191
  isAngular,
1177
1192
  paramsSerializer,
@@ -1190,6 +1205,7 @@ interface GenerateOptionsOptions {
1190
1205
  isAngular?: boolean;
1191
1206
  isExactOptionalPropertyTypes: boolean;
1192
1207
  hasSignal: boolean;
1208
+ hasSignalParam?: boolean;
1193
1209
  isVue?: boolean;
1194
1210
  paramsSerializer?: GeneratorMutator;
1195
1211
  paramsSerializerOptions?: ParamsSerializerOptions;
@@ -1207,6 +1223,7 @@ declare function generateOptions({
1207
1223
  isAngular,
1208
1224
  isExactOptionalPropertyTypes,
1209
1225
  hasSignal,
1226
+ hasSignalParam,
1210
1227
  isVue,
1211
1228
  paramsSerializer,
1212
1229
  paramsSerializerOptions
@@ -1223,6 +1240,7 @@ interface GenerateMutatorConfigOptions {
1223
1240
  isFormData: boolean;
1224
1241
  isFormUrlEncoded: boolean;
1225
1242
  hasSignal: boolean;
1243
+ hasSignalParam?: boolean;
1226
1244
  isExactOptionalPropertyTypes: boolean;
1227
1245
  isVue?: boolean;
1228
1246
  }
@@ -1236,6 +1254,7 @@ declare function generateMutatorConfig({
1236
1254
  isFormData,
1237
1255
  isFormUrlEncoded,
1238
1256
  hasSignal,
1257
+ hasSignalParam,
1239
1258
  isExactOptionalPropertyTypes,
1240
1259
  isVue
1241
1260
  }: GenerateMutatorConfigOptions): string;
@@ -1350,6 +1369,18 @@ declare function getEnumNames(schemaObject: OpenApiSchemaObject | undefined): st
1350
1369
  declare function getEnumDescriptions(schemaObject: OpenApiSchemaObject | undefined): string[] | undefined;
1351
1370
  declare function getEnum(value: string, enumName: string, names: string[] | undefined, enumGenerationType: EnumGeneration, descriptions?: string[], enumNamingConvention?: NamingConvention): string;
1352
1371
  declare function getEnumImplementation(value: string, names?: string[], descriptions?: string[], enumNamingConvention?: NamingConvention): string;
1372
+ type CombinedEnumInput = {
1373
+ value: string;
1374
+ isRef: boolean;
1375
+ schema: OpenApiSchemaObject | undefined;
1376
+ };
1377
+ type CombinedEnumValue = {
1378
+ value: string;
1379
+ valueImports: string[];
1380
+ hasNull: boolean;
1381
+ };
1382
+ declare function getEnumUnionFromSchema(schema: OpenApiSchemaObject | undefined): any;
1383
+ declare function getCombinedEnumValue(inputs: CombinedEnumInput[]): CombinedEnumValue;
1353
1384
  //#endregion
1354
1385
  //#region src/getters/keys.d.ts
1355
1386
  declare function getKey(key: string): string;
@@ -1854,6 +1885,11 @@ declare function escape(str: string | null, char?: string): string | undefined;
1854
1885
  * @param input String to escape
1855
1886
  */
1856
1887
  declare function jsStringEscape(input: string): string;
1888
+ /**
1889
+ * Deduplicates a TypeScript union type string.
1890
+ * Handles types like "A | B | B" → "A | B" and "null | null" → "null".
1891
+ */
1892
+ declare function dedupeUnionType(unionType: string): string;
1857
1893
  //#endregion
1858
1894
  //#region src/utils/tsconfig.d.ts
1859
1895
  declare function isSyntheticDefaultImportsAllow(config?: Tsconfig): boolean;
@@ -1957,5 +1993,5 @@ declare function generateTargetForTags(builder: WriteSpecBuilder, options: Norma
1957
1993
  declare function getOrvalGeneratedTypes(): string;
1958
1994
  declare function getTypedResponse(): string;
1959
1995
  //#endregion
1960
- export { AngularOptions, BODY_TYPE_NAME, BaseUrlFromConstant, BaseUrlFromSpec, ClientBuilder, ClientDependenciesBuilder, ClientExtraFilesBuilder, ClientFileBuilder, ClientFooterBuilder, ClientGeneratorsBuilder, ClientHeaderBuilder, ClientMockBuilder, ClientMockGeneratorBuilder, ClientMockGeneratorImplementation, ClientTitleBuilder, Config, ConfigExternal, ConfigFn, ContextSpec, DeepNonNullable, EnumGeneration, ErrorWithTag, FetchOptions, FormDataArrayHandling, 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, JsDocOptions, LogLevel, LogLevels, LogOptions, LogType, Logger, LoggerOptions, MockData, MockDataArray, MockDataArrayFn, MockDataObject, MockDataObjectFn, MockOptions, MockProperties, MockPropertiesObject, MockPropertiesObjectFn, MutationInvalidatesConfig, MutationInvalidatesRule, Mutator, MutatorObject, NamingConvention, NormalizedConfig, NormalizedFetchOptions, NormalizedFormDataType, NormalizedHonoOptions, NormalizedHookCommand, NormalizedHookOptions, NormalizedInputOptions, NormalizedJsDocOptions, 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, PropertySortOrder, QueryOptions, RefComponentSuffix, RefInfo, ResReqTypesValue, ResolverValue, ResponseTypeCategory, ScalarValue, SchemaGenerationType, SchemaOptions, SchemaType, 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, dynamicImport, escape, 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, getArray, getBody, getDefaultContentType, getEnum, getEnumDescriptions, getEnumImplementation, getEnumNames, getExtension, getFileInfo, getFormDataFieldFileType, getFullRoute, getIsBodyVerb, getKey, getMockFileExtensionByTypeName, getNumberWord, getObject, getOperationId, getOrvalGeneratedTypes, getParameters, getParams, getParamsInPath, getPropertySafe, getProps, getQueryParams, getRefInfo, getResReqTypes, getResponse, getResponseTypeCategory, getRoute, getRouteAsArray, getScalar, getTypedResponse, isBinaryContentType, isBoolean, isDirectory, isFunction, isModule, isNull, isNumber, isNumeric, isObject, isReference, isSchema, isString, isSyntheticDefaultImportsAllow, isUndefined, isUrl, isVerb, jsDoc, jsStringEscape, kebab, keyValuePairsToJsDoc, log, logError, mergeDeep, mismatchArgsMessage, pascal, removeFilesAndEmptyFolders, resolveDiscriminators, resolveExampleRefs, resolveObject, resolveRef, resolveValue, sanitize, snake, sortByPriority, splitSchemasByType, startMessage, stringify, toObjectString, path_d_exports as upath, upper, writeModelInline, writeModelsInline, writeSchema, writeSchemas, writeSingleMode, writeSplitMode, writeSplitTagsMode, writeTagsMode };
1996
+ export { AngularOptions, BODY_TYPE_NAME, BaseUrlFromConstant, BaseUrlFromSpec, ClientBuilder, ClientDependenciesBuilder, ClientExtraFilesBuilder, ClientFileBuilder, ClientFooterBuilder, ClientGeneratorsBuilder, ClientHeaderBuilder, ClientMockBuilder, ClientMockGeneratorBuilder, ClientMockGeneratorImplementation, ClientTitleBuilder, Config, ConfigExternal, ConfigFn, ContextSpec, DeepNonNullable, EnumGeneration, ErrorWithTag, FetchOptions, FormDataArrayHandling, 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, JsDocOptions, LogLevel, LogLevels, LogOptions, LogType, Logger, LoggerOptions, MockData, MockDataArray, MockDataArrayFn, MockDataObject, MockDataObjectFn, MockOptions, MockProperties, MockPropertiesObject, MockPropertiesObjectFn, MutationInvalidatesConfig, MutationInvalidatesRule, Mutator, MutatorObject, NamingConvention, NormalizedConfig, NormalizedFetchOptions, NormalizedFormDataType, NormalizedHonoOptions, NormalizedHookCommand, NormalizedHookOptions, NormalizedInputOptions, NormalizedJsDocOptions, 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, PropertySortOrder, QueryOptions, RefComponentSuffix, RefInfo, ResReqTypesValue, ResolverValue, ResponseTypeCategory, ScalarValue, SchemaGenerationType, SchemaOptions, SchemaType, 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, 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, getArray, 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, getTypedResponse, isBinaryContentType, isBoolean, isDirectory, isFunction, isModule, isNull, isNumber, isNumeric, isObject, isReference, isSchema, isString, isSyntheticDefaultImportsAllow, isUndefined, isUrl, isVerb, jsDoc, jsStringEscape, kebab, keyValuePairsToJsDoc, log, logError, mergeDeep, mismatchArgsMessage, pascal, removeFilesAndEmptyFolders, resolveDiscriminators, resolveExampleRefs, resolveObject, resolveRef, resolveValue, sanitize, snake, sortByPriority, splitSchemasByType, startMessage, stringify, toObjectString, path_d_exports as upath, upper, writeModelInline, writeModelsInline, writeSchema, writeSchemas, writeSingleMode, writeSplitMode, writeSplitTagsMode, writeTagsMode };
1961
1997
  //# sourceMappingURL=index.d.mts.map