@orval/core 8.18.0 → 8.20.0

package/dist/index.d.mts

@@ -31,7 +31,7 @@ interface NormalizedOptions {
 interface NormalizedOutputOptions {
   workspace?: string;
   target: string;
-  schemas?: string | SchemaOptions;
+  schemas?: string | NormalizedSchemaOptions;
   operationSchemas?: string;
   namingConvention: NamingConvention;
   fileExtension: string;
@@ -61,6 +61,8 @@ interface NormalizedOutputOptions {
   optionsParamRequired: boolean;
   propertySortOrder: PropertySortOrder;
   factoryMethods?: NormalizedFactoryMethodsOptions;
+  tagsSplitDeduplication: boolean;
+  commonTypesFileName: string;
 }
 interface NormalizedParamsSerializerOptions {
   qs?: Record<string, unknown>;
@@ -168,6 +170,7 @@ interface NormalizedOverrideOutput {
 }
 interface NormalizedMutator {
   path: string;
+  resolvedPath?: string;
   name?: string;
   default: boolean;
   alias?: Record<string, string>;
@@ -185,7 +188,7 @@ interface NormalizedOperationOptions {
   query?: NormalizedQueryOptions;
   angular?: NormalizedAngularOptions;
   swr?: SwrOptions;
-  zod?: NormalizedZodOptions;
+  zod?: NormalizedOperationZodOptions;
   effect?: NormalizedEffectOptions;
   operationName?: (operation: OpenApiOperationObject, route: string, verb: Verbs) => string;
   fetch?: FetchOptions;
@@ -267,11 +270,20 @@ interface SchemaOptions {
   path: string;
   type?: SchemaGenerationType;
   importPath?: string;
+  /**
+   * When `true`, schemas are organized into per-tag subdirectories instead of
+   * a single flat directory. Schemas referenced by multiple tags remain at the
+   * root of the schema directory.
+   *
+   * @default false
+   */
+  splitByTags?: boolean;
 }
 interface NormalizedSchemaOptions {
   path: string;
   type: SchemaGenerationType;
   importPath?: string;
+  splitByTags: boolean;
 }
 interface OutputOptions {
   workspace?: string;
@@ -312,6 +324,8 @@ interface OutputOptions {
   optionsParamRequired?: boolean;
   propertySortOrder?: PropertySortOrder;
   factoryMethods?: FactoryMethodsOptions;
+  tagsSplitDeduplication?: boolean;
+  commonTypesFileName?: string;
 }
 interface InputFiltersOptions {
   mode?: 'include' | 'exclude';
@@ -433,10 +447,13 @@ type OverrideMockOptions = Partial<GlobalMockOptions> & {
   required?: boolean;
   nonNullable?: boolean;
   properties?: MockProperties;
+  schemas?: Record<string, {
+    properties: MockProperties;
+  }>;
   format?: Record<string, unknown>;
   fractionDigits?: number;
 };
-type MockOptions = Omit<OverrideMockOptions, 'properties'> & {
+type MockOptions = Omit<OverrideMockOptions, 'properties' | 'schemas'> & {
   properties?: Record<string, unknown>;
   operations?: Record<string, {
     properties: Record<string, unknown>;
@@ -444,6 +461,9 @@ type MockOptions = Omit<OverrideMockOptions, 'properties'> & {
   tags?: Record<string, {
     properties: Record<string, unknown>;
   }>;
+  schemas?: Record<string, {
+    properties: Record<string, unknown>;
+  }>;
 };
 type MockPropertiesObject = Record<string, unknown>;
 type MockPropertiesObjectFn = (specs: OpenApiDocument) => MockPropertiesObject;
@@ -606,7 +626,20 @@ interface ZodDateTimeOptions {
 interface ZodTimeOptions {
   precision?: -1 | 0 | 1 | 2 | 3;
 }
-interface ZodOptions {
+/**
+ * Target Zod major version for generated output.
+ *
+ * - `4` — always emit Zod 4-style output (`z.strictObject`, `z.looseObject`,
+ *   `z.iso.datetime()`, `.meta()`, …) regardless of the installed `zod` version.
+ * - `3` — always emit Zod 3-compatible output (`.strict()`/`.passthrough()`,
+ *   `z.string().datetime()`, …) regardless of the installed `zod` version.
+ * - `'auto'` — infer the target from the `zod` version resolved in the output
+ *   project's `package.json`; when no `zod` package can be detected, fall back
+ *   to Zod 4 output.
+ */
+type ZodVersionOption = 3 | 4 | 'auto';
+type ZodVariantOption = 'classic' | 'mini';
+interface BaseZodOptions {
   strict?: {
     param?: boolean;
     query?: boolean;
@@ -647,10 +680,25 @@ interface ZodOptions {
    * location.
    */
   params?: Mutator;
+  useBrandedTypes?: boolean;
+}
+interface ZodOptions extends BaseZodOptions {
+  /**
+   * Select the generated Zod API style. `classic` imports from `zod`; `mini`
+   * imports from `zod/mini` and emits the functional/check-based Zod Mini API.
+   * Zod Mini requires a Zod 4 target.
+   */
+  variant?: ZodVariantOption;
+  /**
+   * Pin the Zod output target so generation is deterministic instead of
+   * inferred from the installed `zod` version. Defaults to `'auto'`, which
+   * infers from the detected package and otherwise falls back to Zod 4 output.
+   * See {@link ZodVersionOption}.
+   */
+  version?: ZodVersionOption;
   dateTimeOptions?: ZodDateTimeOptions;
   timeOptions?: ZodTimeOptions;
   generateEachHttpStatus?: boolean;
-  useBrandedTypes?: boolean;
   /**
    * When true, emits one reusable Zod schema per `#/components/schemas/*` `$ref`
    * (with `namingConvention` applied to the name) and references it everywhere
@@ -666,6 +714,13 @@ interface ZodOptions {
    */
   generateMeta?: boolean;
 }
+/**
+ * Per-operation/tag Zod overrides only include settings that are actually
+ * merged into the operation-specific generator path. Output-wide target and
+ * schema-layout settings belong on `override.zod`, not `override.operations.*`
+ * / `override.tags.*`.
+ */
+type OperationZodOptions = BaseZodOptions;
 interface EffectOptions {
   strict?: ZodOptions['strict'];
   generate?: ZodOptions['generate'];
@@ -674,6 +729,8 @@ interface EffectOptions {
 }
 type ZodCoerceType = 'string' | 'number' | 'boolean' | 'bigint' | 'date' | 'array';
 interface NormalizedZodOptions {
+  variant: ZodVariantOption;
+  version: ZodVersionOption;
   strict: {
     param: boolean;
     query: boolean;
@@ -710,6 +767,7 @@ interface NormalizedZodOptions {
   dateTimeOptions: ZodDateTimeOptions;
   timeOptions: ZodTimeOptions;
 }
+type NormalizedOperationZodOptions = Pick<NormalizedZodOptions, 'strict' | 'generate' | 'coerce' | 'preprocess' | 'params' | 'useBrandedTypes'>;
 interface NormalizedEffectOptions {
   strict: NormalizedZodOptions['strict'];
   generate: NormalizedZodOptions['generate'];
@@ -878,6 +936,15 @@ interface NormalizedFetchOptions {
   jsonReviver?: Mutator;
   runtimeValidation: boolean;
   useRuntimeFetcher: boolean;
+  /**
+   * Serialization format for array query parameters that do not have an explicit
+   * `explode` setting in the OpenAPI spec.
+   *
+   * - `repeat` — repeat the key for each value: `foo=1&foo=2`
+   * - `brackets` — append `[]` to the key: `foo[]=1&foo[]=2`
+   * - `comma` — join values with a comma: `foo=1,2`
+   */
+  arrayFormat?: 'repeat' | 'brackets' | 'comma';
 }
 interface FetchOptions {
   includeHttpResponseReturnType?: boolean;
@@ -885,6 +952,15 @@ interface FetchOptions {
   jsonReviver?: Mutator;
   runtimeValidation?: boolean;
   useRuntimeFetcher?: boolean;
+  /**
+   * Serialization format for array query parameters that do not have an explicit
+   * `explode` setting in the OpenAPI spec.
+   *
+   * - `repeat` — repeat the key for each value: `foo=1&foo=2`
+   * - `brackets` — append `[]` to the key: `foo[]=1&foo[]=2`
+   * - `comma` — join values with a comma: `foo=1,2`
+   */
+  arrayFormat?: 'repeat' | 'brackets' | 'comma';
 }
 type InputTransformerFn = (spec: OpenApiDocument) => OpenApiDocument | Promise<OpenApiDocument>;
 type InputTransformer = string | InputTransformerFn;
@@ -901,7 +977,7 @@ interface OperationOptions {
   query?: QueryOptions;
   angular?: AngularOptions;
   swr?: SwrOptions;
-  zod?: ZodOptions;
+  zod?: OperationZodOptions;
   effect?: EffectOptions;
   operationName?: (operation: OpenApiOperationObject, route: string, verb: Verbs) => string;
   fetch?: FetchOptions;
@@ -921,14 +997,15 @@ type HookCommand = string | HookFunction | HookOption | (string | HookFunction |
 type NormalizedHookCommand = HookCommand[];
 type HooksOptions<T = HookCommand | NormalizedHookCommand> = Partial<Record<Hook, T>>;
 type NormalizedHookOptions = HooksOptions<NormalizedHookCommand>;
-type Verbs = 'post' | 'put' | 'get' | 'patch' | 'delete' | 'head';
+type Verbs = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch';
 declare const Verbs: {
-  POST: Verbs;
-  PUT: Verbs;
   GET: Verbs;
-  PATCH: Verbs;
+  PUT: Verbs;
+  POST: Verbs;
   DELETE: Verbs;
+  OPTIONS: Verbs;
   HEAD: Verbs;
+  PATCH: Verbs;
 };
 /**
  * Canonical tag name used for the generated bucket that collects untagged operations.
@@ -954,6 +1031,14 @@ interface ContextSpec {
    * entries or generic parameter placeholders. Populated by `buildDynamicScope`.
    */
   dynamicScope?: Partial<Record<string, DynamicScopeEntry>>;
+  /**
+   * Lazily-built index of every `$dynamicAnchor` declared in
+   * `components.schemas`, used by the `resolveDynamicRef` fallback when an
+   * anchor is absent from {@link dynamicScope}. Memoized on first miss so the
+   * O(numSchemas) scan runs once per spec instead of once per `$dynamicRef`.
+   * Populated by `getDynamicAnchorIndex` in `resolvers/ref.ts`.
+   */
+  dynamicAnchorIndex?: Map<string, DynamicAnchorIndexEntry>;
   /**
    * Tracks array-item mock factory names already emitted per output file scope.
    * Populated by `@orval/mock` when `arrayItems: true` so shared `$ref` item
@@ -980,11 +1065,37 @@ interface ContextSpec {
  *   - `isParameter` — `true`, signals this is a generic type parameter
  *   - `name` — the `$dynamicAnchor` name used as the type parameter (e.g. `itemType`)
  *   - `schemaName` — same as `name` for parameters
+ *
+ * Inline entry (anonymous subschema overriding an anchor without a `$ref`):
+ *   - `inlineSchema` — the concrete schema object to resolve `$dynamicRef` against.
+ *     Takes precedence over the component lookup in `resolveDynamicRef`, so an
+ *     inline `$dynamicAnchor` (e.g. inside `allOf` / `items`) correctly shadows
+ *     the outer/global anchor. `schemaName` is the anchor name itself.
  */
 interface DynamicScopeEntry {
   name: string;
   schemaName: string;
   isParameter?: boolean;
+  inlineSchema?: OpenApiSchemaObject;
+}
+/**
+ * Compact per-anchor result of the single `$dynamicAnchor` index scan.
+ *
+ * Reproduces the precedence in `resolveDynamicRef`'s fallback without storing
+ * full match arrays:
+ *   - {@link exactName} — a schema whose key equals the anchor name. Always
+ *     wins when present (matches `matches.find(m => m === anchorName)`).
+ *   - {@link firstName} / {@link count} — non-exact matches. Only the first is
+ *     kept; `count` is capped at 2 because the resolution only distinguishes
+ *     "exactly one" from "ambiguous". Recording stops once `count >= 2`, which
+ *     is the safe form of "bail early when ambiguous" — a literal early-return
+ *     at `count === 2` would regress the exact-name rule when the exact schema
+ *     appears later in iteration order.
+ */
+interface DynamicAnchorIndexEntry {
+  exactName?: string;
+  firstName?: string;
+  count: number;
 }
 interface GlobalOptions {
   watch?: boolean | string | string[];
@@ -1105,6 +1216,7 @@ interface GeneratorTarget {
   paramsSerializer?: GeneratorMutator[];
   paramsFilter?: GeneratorMutator[];
   fetchReviver?: GeneratorMutator[];
+  sharedTypes?: SharedTypeDeclaration[];
 }
 interface GeneratorTargetFull {
   imports: GeneratorImport[];
@@ -1117,6 +1229,7 @@ interface GeneratorTargetFull {
   paramsSerializer?: GeneratorMutator[];
   paramsFilter?: GeneratorMutator[];
   fetchReviver?: GeneratorMutator[];
+  sharedTypes?: SharedTypeDeclaration[];
 }
 interface GeneratorOperation {
   imports: GeneratorImport[];
@@ -1197,6 +1310,15 @@ interface ClientFileBuilder {
   content: string;
 }
 type ClientExtraFilesBuilder = (verbOptions: Record<string, GeneratorVerbOptions>, output: NormalizedOutputOptions, context: ContextSpec) => Promise<ClientFileBuilder[]>;
+interface SharedTypeDeclaration {
+  name: string;
+  exported: boolean;
+  code: string;
+}
+type HeaderResult = {
+  implementation: string;
+  sharedTypes?: SharedTypeDeclaration[];
+};
 type ClientHeaderBuilder = (params: {
   title: string;
   isRequestOptions: boolean;
@@ -1210,7 +1332,7 @@ type ClientHeaderBuilder = (params: {
   tag?: string;
   isDefaultTagBucket?: boolean;
   clientImplementation: string;
-}) => string;
+}) => string | HeaderResult;
 type ClientFooterBuilder = (params: {
   noFunction?: boolean | undefined;
   operationNames: string[];
@@ -1395,6 +1517,7 @@ interface WriteModeProps {
   header: string;
   needSchema: boolean;
   generateSchemasInline?: () => string;
+  schemaTagMap?: Map<string, string>;
 }
 interface GeneratorApiOperations {
   verbOptions: Record<string, GeneratorVerbOptions>;
@@ -1404,6 +1527,7 @@ interface GeneratorApiOperations {
 interface GeneratorClientExtra {
   implementation: string;
   implementationMock: string;
+  sharedTypes?: SharedTypeDeclaration[];
 }
 type GeneratorClientTitle = (data: {
   outputClient?: OutputClient | OutputClientFunc;
@@ -1650,7 +1774,6 @@ interface GenerateAxiosOptions {
   requestOptions?: object | boolean;
   hasSignal: boolean;
   hasSignalParam?: boolean;
-  isVue: boolean;
   isAngular: boolean;
   paramsSerializer?: GeneratorMutator;
   paramsSerializerOptions?: ParamsSerializerOptions;
@@ -1668,7 +1791,6 @@ declare function generateAxiosOptions({
   requestOptions,
   hasSignal,
   hasSignalParam,
-  isVue,
   isAngular,
   paramsSerializer,
   paramsSerializerOptions,
@@ -1690,7 +1812,6 @@ interface GenerateOptionsOptions {
   isExactOptionalPropertyTypes: boolean;
   hasSignal: boolean;
   hasSignalParam?: boolean;
-  isVue?: boolean;
   paramsSerializer?: GeneratorMutator;
   paramsSerializerOptions?: ParamsSerializerOptions;
   paramsFilter?: GeneratorMutator;
@@ -1711,13 +1832,12 @@ declare function generateOptions({
   isExactOptionalPropertyTypes,
   hasSignal,
   hasSignalParam,
-  isVue,
   paramsSerializer,
   paramsSerializerOptions,
   paramsFilter
 }: GenerateOptionsOptions): string;
 declare function generateBodyMutatorConfig(body: GetterBody, isFormData: boolean, isFormUrlEncoded: boolean): string;
-declare function generateQueryParamsAxiosConfig(response: GetterResponse, isVue: boolean, isAngular: boolean, requiredNullableQueryParamKeys?: string[], queryParams?: GetterQueryParam, paramsFilter?: GeneratorMutator): string;
+declare function generateQueryParamsAxiosConfig(response: GetterResponse, isAngular: boolean, requiredNullableQueryParamKeys?: string[], queryParams?: GetterQueryParam, paramsFilter?: GeneratorMutator): string;
 interface GenerateMutatorConfigOptions {
   route: string;
   body: GetterBody;
@@ -1730,7 +1850,6 @@ interface GenerateMutatorConfigOptions {
   hasSignal: boolean;
   hasSignalParam?: boolean;
   isExactOptionalPropertyTypes: boolean;
-  isVue?: boolean;
   isAngular?: boolean;
   paramsFilter?: GeneratorMutator;
 }
@@ -1746,7 +1865,6 @@ declare function generateMutatorConfig({
   hasSignal,
   hasSignalParam,
   isExactOptionalPropertyTypes,
-  isVue,
   isAngular,
   paramsFilter
 }: GenerateMutatorConfigOptions): string;
@@ -2224,6 +2342,44 @@ declare function extractBoundAliasInfo(schema: OpenApiSchemaObject | OpenApiRefe
  * type entries for self-referential resolution, `$defs` bindings, and sibling anchors.
  */
 declare function buildDynamicScope(schemaName: string, schema: OpenApiSchemaObject, context: ContextSpec): Record<string, DynamicScopeEntry>;
+/**
+ * Build dynamic scope entries for an **anonymous inline** subschema that declares
+ * `$dynamicAnchor` without a `$ref` (e.g. inside `allOf`, `items`, nested props).
+ *
+ * Unlike {@link buildDynamicScope}, entries carry the concrete `inlineSchema` so
+ * that a descendant `$dynamicRef` resolves to the inline override rather than the
+ * outer/global component. Used when `dereference` enters a subschema without a
+ * named component `$ref`.
+ *
+ * Scope of handling (deliberate, see #3492):
+ *   - Direct `$dynamicAnchor` on the subschema → inline entry.
+ *   - `$defs` `$dynamicAnchor` *without* a `$ref` → inline entry. Note this
+ *     differs from `buildDynamicScope`, which treats unbound `$defs` anchors as
+ *     generic parameters (`isParameter`); inline subschemas are concrete
+ *     instances, so the anchor resolves to the inline schema object itself.
+ *   - `$defs` `$dynamicAnchor` *with* a `$ref` → intentionally NOT collected
+ *     here. Such anchors rely on `resolveDynamicRef`'s global fallback (which
+ *     finds them when the `$ref` target declares the same anchor). Fully
+ *     resolving them would duplicate `buildDynamicScope`'s `$defs` logic.
+ */
+declare function buildInlineDynamicScope(schema: OpenApiSchemaObject): Record<string, DynamicScopeEntry>;
+/**
+ * Lazily build and memoize the `$dynamicAnchor` index on the context.
+ *
+ * Scans `components.schemas` once per spec and stores, per anchor name, the
+ * compact match info required by the {@link resolveDynamicRef} fallback (see
+ * {@link DynamicAnchorIndexEntry}). Subsequent fallback lookups are O(1)
+ * instead of re-scanning every schema per `$dynamicRef`.
+ *
+ * Recording of non-exact matches stops once `count >= 2` — the fallback only
+ * distinguishes "exactly one non-exact" from "ambiguous", so further non-exact
+ * names are irrelevant. Iteration continues regardless because a later schema
+ * whose key equals the anchor name is still the definitive (`exactName`)
+ * winner. This is the safe form of "bail early when ambiguous": a literal
+ * early-return at `count === 2` would regress the exact-name rule when the
+ * exact schema appears later in iteration order.
+ */
+declare function getDynamicAnchorIndex(context: ContextSpec): Map<string, DynamicAnchorIndexEntry>;
 /**
  * Resolve a `$dynamicRef` anchor to its concrete type using the current dynamic scope.
  * Returns `{ schema: {}, resolvedTypeName: 'unknown' }` when no scope override exists.
@@ -2757,6 +2913,51 @@ declare function jsStringLiteralEscape(input: string): string;
  */
 declare function dedupeUnionType(unionType: string): string;
 //#endregion
+//#region src/utils/tags.d.ts
+/**
+ * Canonical bucket key for a single OpenAPI tag.
+ *
+ * In `tags` / `tags-split` mode operations are routed into files by their first
+ * tag. This function is the **single source of truth** for turning a tag (or a
+ * missing tag) into the key that identifies that file bucket. Every place that
+ * groups operations by tag, derives a per-tag file/directory name, or checks
+ * whether an operation belongs to a tag MUST go through here so that the
+ * "build the key" side and the "look the key up" side can never disagree.
+ *
+ * The result is `kebab`-cased. `kebab` is idempotent
+ * (`kebab(kebab(x)) === kebab(x)`), so it is always safe to call this on a value
+ * that is already a canonical key. Other case functions (`camel`, `pascal`) are
+ * NOT safe here: they do not round-trip through the bucket key for tags
+ * containing acronyms or spaces (e.g. `"AB Widget"`), which is exactly the class
+ * of bug this module exists to prevent.
+ *
+ * Missing or empty tags map to the implicit {@link DefaultTag} bucket.
+ */
+declare function getTagKey(tag?: string): string;
+/**
+ * Canonical bucket key for an operation, derived from its primary (first) tag.
+ *
+ * Untagged operations resolve to the {@link DefaultTag} bucket.
+ */
+declare function getOperationTagKey(operation: {
+  tags: string[];
+}): string;
+/**
+ * Whether an operation belongs to the given tag bucket.
+ *
+ * Both sides are normalised through {@link getTagKey}, so the comparison is
+ * correct regardless of how `tagKey` was spelled or cased by the caller. An
+ * absent (`undefined`) `tagKey` matches every operation (the "no tag filter"
+ * case); an empty/whitespace `tagKey` is normalised to the {@link DefaultTag}
+ * bucket like any other tag.
+ *
+ * Prefer this over hand-rolling `operation.tags[0] === tagKey`: a raw tag
+ * compared against a canonical key silently fails for multi-word/acronym tags.
+ */
+declare function isOperationInTagBucket(operation: {
+  tags: string[];
+}, tagKey?: string): boolean;
+//#endregion
 //#region src/utils/tsconfig.d.ts
 declare function isSyntheticDefaultImportsAllow(config?: Tsconfig): boolean;
 declare function getImportExtension(fileExtension: string, tsconfig?: Tsconfig): string;
@@ -2771,6 +2972,10 @@ declare function getImportExtension(fileExtension: string, tsconfig?: Tsconfig):
  */
 declare function writeGeneratedFile(filePath: string, content: string): Promise<void>;
 //#endregion
+//#region src/writers/schema-tag-mapper.d.ts
+declare const SHARED_DIR = ".";
+declare function buildSchemaTagMap(operations: ReadonlyArray<Pick<GeneratorOperation, 'imports' | 'tags'>>, schemas: GeneratorSchema[]): Map<string, string>;
+//#endregion
 //#region src/writers/schemas.d.ts
 /**
  * Split schemas into regular and operation types.
@@ -2830,6 +3035,35 @@ declare function writeSchemas({
   factoryOutputDirectory
 }: WriteSchemasOptions): Promise<void>;
 //#endregion
+//#region src/writers/schemas-tags-split.d.ts
+interface WriteSchemasTagsSplitOptions {
+  schemaPath: string;
+  schemas: GeneratorSchema[];
+  target: string;
+  namingConvention: NamingConvention;
+  fileExtension: string;
+  header: string;
+  indexFiles: boolean;
+  tsconfig?: Tsconfig;
+  factoryOutputDirectory?: string;
+  operations: ReadonlyArray<{
+    imports: GeneratorImport[];
+    tags: string[];
+  }>;
+}
+declare function writeSchemasTagsSplit({
+  schemaPath,
+  schemas,
+  target,
+  namingConvention,
+  fileExtension,
+  header,
+  indexFiles,
+  tsconfig,
+  factoryOutputDirectory,
+  operations
+}: WriteSchemasTagsSplitOptions): Promise<void>;
+//#endregion
 //#region src/writers/single-mode.d.ts
 declare function writeSingleMode({
   builder,
@@ -2837,7 +3071,8 @@ declare function writeSingleMode({
   projectName,
   header,
   needSchema,
-  generateSchemasInline
+  generateSchemasInline,
+  schemaTagMap
 }: WriteModeProps): Promise<string[]>;
 //#endregion
 //#region src/writers/split-mode.d.ts
@@ -2847,7 +3082,8 @@ declare function writeSplitMode({
   projectName,
   header,
   needSchema,
-  generateSchemasInline
+  generateSchemasInline,
+  schemaTagMap
 }: WriteModeProps): Promise<string[]>;
 //#endregion
 //#region src/writers/split-tags-mode.d.ts
@@ -2857,7 +3093,8 @@ declare function writeSplitTagsMode({
   projectName,
   header,
   needSchema,
-  generateSchemasInline
+  generateSchemasInline,
+  schemaTagMap
 }: WriteModeProps): Promise<string[]>;
 //#endregion
 //#region src/writers/tags-mode.d.ts
@@ -2867,7 +3104,8 @@ declare function writeTagsMode({
   projectName,
   header,
   needSchema,
-  generateSchemasInline
+  generateSchemasInline,
+  schemaTagMap
 }: WriteModeProps): Promise<string[]>;
 //#endregion
 //#region src/writers/target.d.ts
@@ -2880,5 +3118,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, BoundAliasInfo, ClientBuilder, ClientDependenciesBuilder, ClientExtraFilesBuilder, ClientFileBuilder, ClientFooterBuilder, ClientGeneratorsBuilder, ClientHeaderBuilder, ClientMockBuilder, ClientMockGeneratorBuilder, ClientMockGeneratorImplementation, ClientTitleBuilder, CommonMockOptions, Config, ConfigExternal, ConfigFn, ContentTypeFilter, ContextSpec, DeepNonNullable, DefaultTag, DynamicScopeEntry, EffectOptions, EnumGeneration, ErrorWithTag, FactoryMethodsMode, FactoryMethodsOptions, FakerMockOptions, FetchOptions, FinalizeMockImplementationOptions, FormDataArrayHandling, FormDataContext, FormDataType, GenerateMockImports, GenerateVerbOptionsParams, GenerateVerbsOptionsParams, GeneratorApiBuilder, GeneratorApiOperations, GeneratorApiResponse, GeneratorClient, GeneratorClientExtra, GeneratorClientFooter, GeneratorClientHeader, GeneratorClientImports, GeneratorClientTitle, GeneratorClients, GeneratorDependency, GeneratorImport, GeneratorMockOutput, GeneratorMockOutputFull, GeneratorMutator, GeneratorMutatorParsingInfo, GeneratorOperation, GeneratorOperations, GeneratorOptions, GeneratorSchema, GeneratorTarget, GeneratorTargetFull, GeneratorVerbOptions, GeneratorVerbsOptions, GetterBody, GetterParam, GetterParameters, GetterParams, GetterProp, GetterPropType, GetterProps, GetterQueryParam, GetterResponse, GlobalMockOptions, GlobalOptions, HonoHandlerStrategy, 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, MswMockOptions, MutationInvalidatesConfig, MutationInvalidatesRule, Mutator, MutatorObject, NAMED_COMPONENT_SECTIONS, NamingConvention, NormalizedAngularOptions, NormalizedConfig, NormalizedEffectOptions, NormalizedFactoryMethodsOptions, NormalizedFetchOptions, NormalizedFormDataType, NormalizedHonoOptions, NormalizedHookCommand, NormalizedHookOptions, NormalizedInputOptions, NormalizedJsDocOptions, NormalizedMcpOptions, NormalizedMcpServerOptions, NormalizedMocksConfig, NormalizedMutator, NormalizedOperationOptions, NormalizedOptions, NormalizedOutputOptions, NormalizedOverrideOutput, NormalizedParamsSerializerOptions, NormalizedQueryOptions, NormalizedSchemaOptions, NormalizedZodOptions, OpenApiComponentsObject, OpenApiDocument, OpenApiDynamicReferenceObject, 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, OutputMocksConfig, OutputMocksOption, OutputMode, OutputOptions, OverrideInput, OverrideMockOptions, OverrideOutput, OverrideOutputContentType, PackageJson, ParamsSerializerOptions, PreferredContentType, PropertySortOrder, QueryOptions, ReadonlyRequestBodiesMode, RefComponentSuffix, RefInfo, ResReqTypesValue, ResolverValue, ResponseTypeCategory, ScalarValue, SchemaGenerationType, SchemaOptionLike, SchemaOptions, SchemaType, StrictMockSchemaKind, SupportedFormatter, SwrOptions, TEMPLATE_TAG_REGEX, TsConfigModule, TsConfigModuleResolution, TsConfigTarget, Tsconfig, URL_REGEX, VERBS_WITH_BODY, Verbs, WriteModeProps, WriteSpecBuilder, ZodCoerceType, ZodDateTimeOptions, ZodOptions, ZodTimeOptions, addDependency, asyncReduce, buildAngularParamsFilterExpression, buildDynamicScope, camel, collectReferencedComponents, combineSchemas, compareVersions, conventionName, count, createDebugger, createLogger, createSuccessMessage, createTypeAliasIfNeeded, dedupeUnionType, dynamicAnchorToParamName, dynamicAnchorsToUniqueParamNames, dynamicImport, escape, escapeRegExp, extractBoundAliasInfo, filterByContentType, filteredVerbs, fixCrossDirectoryImports, fixRegularSchemaImports, generalJSTypes, generalJSTypesWithArray, generateAxiosOptions, generateBodyMutatorConfig, generateBodyOptions, generateComponentDefinition, generateDependencyImports, generateFactory, 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, getDynamicAnchorName, getEnum, getEnumDescriptions, getEnumImplementation, getEnumNames, getEnumUnionFromSchema, getExtension, getFileInfo, getFormDataFieldFileType, getFullRoute, getImportExtension, getIsBodyVerb, getKey, getMockFileExtensionByTypeName, getNumberWord, getObject, getOperationId, getOrvalGeneratedTypes, getParameters, getParams, getParamsInPath, getPropertySafe, getProps, getQueryParams, getRefInfo, getResReqTypes, getResponse, getResponseTypeCategory, getRoute, getRouteAsArray, getScalar, getSchemasImportPath, getSuccessResponseType, getTypedResponse, getWarningCount, isBinaryContentType, isBinaryScalarSchema, isBoolean, isComponentRef, isDirectory, isDynamicReference, isFakerMock, isFunction, isModule, isMswMock, isNullish, isNumber, isNumeric, isObject, isReference, isSchema, isString, isStringLike, isSyntheticDefaultImportsAllow, isUrl, isVerb, isVerbose, jsDoc, jsStringEscape, jsStringLiteralEscape, kebab, keyValuePairsToJsDoc, log, logError, logVerbose, logWarning, makeRouteSafe, mergeDeep, mismatchArgsMessage, pascal, removeFilesAndEmptyFolders, resetWarnings, resolveDiscriminators, resolveDynamicRef, resolveExampleRefs, resolveInstalledVersion, resolveInstalledVersions, resolveObject, resolveRef, resolveValue, sanitize, setVerbose, snake, sortByPriority, splitSchemasByType, startMessage, stringify, toObjectString, path_d_exports as upath, upper, wrapRouteParameters, writeGeneratedFile, writeModelInline, writeModelsInline, writeSchema, writeSchemas, writeSingleMode, writeSplitMode, writeSplitTagsMode, writeTagsMode };
+export { AngularHttpResourceOptions, AngularOptions, BODY_TYPE_NAME, BaseUrlFromConstant, BaseUrlFromSpec, BaseUrlRuntime, BoundAliasInfo, ClientBuilder, ClientDependenciesBuilder, ClientExtraFilesBuilder, ClientFileBuilder, ClientFooterBuilder, ClientGeneratorsBuilder, ClientHeaderBuilder, ClientMockBuilder, ClientMockGeneratorBuilder, ClientMockGeneratorImplementation, ClientTitleBuilder, CommonMockOptions, Config, ConfigExternal, ConfigFn, ContentTypeFilter, ContextSpec, DeepNonNullable, DefaultTag, DynamicAnchorIndexEntry, DynamicScopeEntry, EffectOptions, EnumGeneration, ErrorWithTag, FactoryMethodsMode, FactoryMethodsOptions, FakerMockOptions, FetchOptions, FinalizeMockImplementationOptions, FormDataArrayHandling, FormDataContext, FormDataType, GenerateMockImports, GenerateVerbOptionsParams, GenerateVerbsOptionsParams, GeneratorApiBuilder, GeneratorApiOperations, GeneratorApiResponse, GeneratorClient, GeneratorClientExtra, GeneratorClientFooter, GeneratorClientHeader, GeneratorClientImports, GeneratorClientTitle, GeneratorClients, GeneratorDependency, GeneratorImport, GeneratorMockOutput, GeneratorMockOutputFull, GeneratorMutator, GeneratorMutatorParsingInfo, GeneratorOperation, GeneratorOperations, GeneratorOptions, GeneratorSchema, GeneratorTarget, GeneratorTargetFull, GeneratorVerbOptions, GeneratorVerbsOptions, GetterBody, GetterParam, GetterParameters, GetterParams, GetterProp, GetterPropType, GetterProps, GetterQueryParam, GetterResponse, GlobalMockOptions, GlobalOptions, HeaderResult, HonoHandlerStrategy, 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, MswMockOptions, MutationInvalidatesConfig, MutationInvalidatesRule, Mutator, MutatorObject, NAMED_COMPONENT_SECTIONS, NamingConvention, NormalizedAngularOptions, NormalizedConfig, NormalizedEffectOptions, NormalizedFactoryMethodsOptions, NormalizedFetchOptions, NormalizedFormDataType, NormalizedHonoOptions, NormalizedHookCommand, NormalizedHookOptions, NormalizedInputOptions, NormalizedJsDocOptions, NormalizedMcpOptions, NormalizedMcpServerOptions, NormalizedMocksConfig, NormalizedMutator, NormalizedOperationOptions, NormalizedOperationZodOptions, NormalizedOptions, NormalizedOutputOptions, NormalizedOverrideOutput, NormalizedParamsSerializerOptions, NormalizedQueryOptions, NormalizedSchemaOptions, NormalizedZodOptions, OpenApiComponentsObject, OpenApiDocument, OpenApiDynamicReferenceObject, OpenApiEncodingObject, OpenApiExampleObject, OpenApiInfoObject, OpenApiMediaTypeObject, OpenApiOperationObject, OpenApiParameterObject, OpenApiPathItemObject, OpenApiPathsObject, OpenApiReferenceObject, OpenApiRequestBodyObject, OpenApiResponseObject, OpenApiResponsesObject, OpenApiSchemaObject, OpenApiSchemaObjectType, OpenApiSchemasObject, OpenApiServerObject, OperationOptions, OperationZodOptions, Options, OptionsExport, OptionsFn, OutputClient, OutputClientFunc, OutputDocsOptions, OutputHttpClient, OutputMockType, OutputMocksConfig, OutputMocksOption, OutputMode, OutputOptions, OverrideInput, OverrideMockOptions, OverrideOutput, OverrideOutputContentType, PackageJson, ParamsSerializerOptions, PreferredContentType, PropertySortOrder, QueryOptions, ReadonlyRequestBodiesMode, RefComponentSuffix, RefInfo, ResReqTypesValue, ResolverValue, ResponseTypeCategory, SHARED_DIR, ScalarValue, SchemaGenerationType, SchemaOptionLike, SchemaOptions, SchemaType, SharedTypeDeclaration, StrictMockSchemaKind, SupportedFormatter, SwrOptions, TEMPLATE_TAG_REGEX, TsConfigModule, TsConfigModuleResolution, TsConfigTarget, Tsconfig, URL_REGEX, VERBS_WITH_BODY, Verbs, WriteModeProps, WriteSpecBuilder, ZodCoerceType, ZodDateTimeOptions, ZodOptions, ZodTimeOptions, ZodVariantOption, ZodVersionOption, addDependency, asyncReduce, buildAngularParamsFilterExpression, buildDynamicScope, buildInlineDynamicScope, buildSchemaTagMap, camel, collectReferencedComponents, combineSchemas, compareVersions, conventionName, count, createDebugger, createLogger, createSuccessMessage, createTypeAliasIfNeeded, dedupeUnionType, dynamicAnchorToParamName, dynamicAnchorsToUniqueParamNames, dynamicImport, escape, escapeRegExp, extractBoundAliasInfo, filterByContentType, filteredVerbs, fixCrossDirectoryImports, fixRegularSchemaImports, generalJSTypes, generalJSTypesWithArray, generateAxiosOptions, generateBodyMutatorConfig, generateBodyOptions, generateComponentDefinition, generateDependencyImports, generateFactory, 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, getDynamicAnchorIndex, getDynamicAnchorName, getEnum, getEnumDescriptions, getEnumImplementation, getEnumNames, getEnumUnionFromSchema, getExtension, getFileInfo, getFormDataFieldFileType, getFullRoute, getImportExtension, getIsBodyVerb, getKey, getMockFileExtensionByTypeName, getNumberWord, getObject, getOperationId, getOperationTagKey, getOrvalGeneratedTypes, getParameters, getParams, getParamsInPath, getPropertySafe, getProps, getQueryParams, getRefInfo, getResReqTypes, getResponse, getResponseTypeCategory, getRoute, getRouteAsArray, getScalar, getSchemasImportPath, getSuccessResponseType, getTagKey, getTypedResponse, getWarningCount, isBinaryContentType, isBinaryScalarSchema, isBoolean, isComponentRef, isDirectory, isDynamicReference, isFakerMock, isFunction, isModule, isMswMock, isNullish, isNumber, isNumeric, isObject, isOperationInTagBucket, isReference, isSchema, isString, isStringLike, isSyntheticDefaultImportsAllow, isUrl, isVerb, isVerbose, jsDoc, jsStringEscape, jsStringLiteralEscape, kebab, keyValuePairsToJsDoc, log, logError, logVerbose, logWarning, makeRouteSafe, mergeDeep, mismatchArgsMessage, pascal, removeFilesAndEmptyFolders, resetWarnings, resolveDiscriminators, resolveDynamicRef, resolveExampleRefs, resolveInstalledVersion, resolveInstalledVersions, resolveObject, resolveRef, resolveValue, sanitize, setVerbose, snake, sortByPriority, splitSchemasByType, startMessage, stringify, toObjectString, path_d_exports as upath, upper, wrapRouteParameters, writeGeneratedFile, writeModelInline, writeModelsInline, writeSchema, writeSchemas, writeSchemasTagsSplit, writeSingleMode, writeSplitMode, writeSplitTagsMode, writeTagsMode };
 //# sourceMappingURL=index.d.mts.map