@orval/core 8.6.1 → 8.7.0

package/dist/index.d.mts

@@ -6,6 +6,12 @@ import { OpenAPIV3_1 } from "@scalar/openapi-types";
 import { TypeDocOptions } from "typedoc";
 
 //#region src/types.d.ts
+declare const SupportedFormatter: {
+  readonly PRETTIER: "prettier";
+  readonly BIOME: "biome";
+  readonly OXFMT: "oxfmt";
+};
+type SupportedFormatter = (typeof SupportedFormatter)[keyof typeof SupportedFormatter];
 interface Options {
   output?: string | OutputOptions;
   input?: string | string[] | InputOptions;
@@ -36,13 +42,12 @@ interface NormalizedOutputOptions {
   httpClient: OutputHttpClient;
   clean: boolean | string[];
   docs: boolean | OutputDocsOptions;
-  prettier: boolean;
-  biome: boolean;
+  formatter?: SupportedFormatter;
   tsconfig?: Tsconfig;
   packageJson?: PackageJson;
   headers: boolean;
   indexFiles: boolean;
-  baseUrl?: string | BaseUrlFromSpec | BaseUrlFromConstant;
+  baseUrl?: string | BaseUrlFromSpec | BaseUrlFromConstant | BaseUrlRuntime;
   allParamsOptional: boolean;
   urlEncodeParameters: boolean;
   unionAddMissingProperties: boolean;
@@ -125,6 +130,23 @@ interface NormalizedOverrideOutput {
    * intentionally immutable and should remain readonly in generated types.
    */
   preserveReadonlyRequestBodies?: ReadonlyRequestBodiesMode;
+  /**
+   * When enabled, operations with multiple request body content-types
+   * (e.g. both `multipart/form-data` and `application/json`) will generate
+   * separate functions for each content type instead of a single function
+   * with a union type parameter.
+   *
+   * @example
+   * // With splitByContentType: true
+   * updateProfileWithFormData(body: FormDataType) => { ... }
+   * updateProfileWithJson(body: JsonType) => { ... }
+   *
+   * // With splitByContentType: false (default)
+   * updateProfile(body: FormDataType | JsonType) => { ... }
+   *
+   * @default false
+   */
+  splitByContentType: boolean;
   jsDoc: NormalizedJsDocOptions;
   aliasCombinedTypes: boolean;
   /**
@@ -184,6 +206,17 @@ interface BaseUrlFromConstant {
   index?: never;
   baseUrl: string;
 }
+/**
+ * Embed a runtime JavaScript expression into generated URL template literals
+ * (e.g. `process.env.API_BASE_URL`) so the same build can target different hosts at runtime.
+ */
+interface BaseUrlRuntime {
+  runtime: string;
+  /** Named imports for symbols used in `runtime` (e.g. `{ name: 'apiBase', importPath: '../config' }`). */
+  imports?: GeneratorImport[];
+  getBaseUrlFromSpecification?: never;
+  baseUrl?: never;
+}
 declare const PropertySortOrder: {
   readonly ALPHABETICAL: "Alphabetical";
   readonly SPECIFICATION: "Specification";
@@ -230,13 +263,12 @@ interface OutputOptions {
   httpClient?: OutputHttpClient;
   clean?: boolean | string[];
   docs?: boolean | OutputDocsOptions;
-  prettier?: boolean;
-  biome?: boolean;
+  formatter?: SupportedFormatter;
   tsconfig?: string | Tsconfig;
   packageJson?: string;
   headers?: boolean;
   indexFiles?: boolean;
-  baseUrl?: string | BaseUrlFromSpec | BaseUrlFromConstant;
+  baseUrl?: string | BaseUrlFromSpec | BaseUrlFromConstant | BaseUrlRuntime;
   allParamsOptional?: boolean;
   urlEncodeParameters?: boolean;
   unionAddMissingProperties?: boolean;
@@ -427,6 +459,15 @@ interface OverrideOutput {
    * intentionally immutable and should remain readonly in generated types.
    */
   preserveReadonlyRequestBodies?: ReadonlyRequestBodiesMode;
+  /**
+   * When enabled, operations with multiple request body content-types
+   * (e.g. both `multipart/form-data` and `application/json`) will generate
+   * separate functions for each content type instead of a single function
+   * with a union type parameter.
+   *
+   * @default false
+   */
+  splitByContentType?: boolean;
   jsDoc?: JsDocOptions;
   aliasCombinedTypes?: boolean;
   /**
@@ -497,6 +538,7 @@ interface ZodOptions {
   dateTimeOptions?: ZodDateTimeOptions;
   timeOptions?: ZodTimeOptions;
   generateEachHttpStatus?: boolean;
+  useBrandedTypes?: boolean;
 }
 type ZodCoerceType = 'string' | 'number' | 'boolean' | 'bigint' | 'date';
 interface NormalizedZodOptions {
@@ -529,6 +571,7 @@ interface NormalizedZodOptions {
     response?: NormalizedMutator;
   };
   generateEachHttpStatus: boolean;
+  useBrandedTypes: boolean;
   dateTimeOptions: ZodDateTimeOptions;
   timeOptions: ZodTimeOptions;
 }
@@ -558,6 +601,8 @@ interface NormalizedQueryOptions {
   useInfiniteQueryParam?: string;
   usePrefetch?: boolean;
   useInvalidate?: boolean;
+  useSetQueryData?: boolean;
+  useGetQueryData?: boolean;
   options?: Record<string, unknown>;
   queryKey?: NormalizedMutator;
   queryOptions?: NormalizedMutator;
@@ -581,6 +626,8 @@ interface QueryOptions {
   useInfiniteQueryParam?: string;
   usePrefetch?: boolean;
   useInvalidate?: boolean;
+  useSetQueryData?: boolean;
+  useGetQueryData?: boolean;
   options?: Record<string, unknown>;
   queryKey?: Mutator;
   queryOptions?: Mutator;
@@ -659,12 +706,14 @@ interface NormalizedFetchOptions {
   forceSuccessResponse: boolean;
   jsonReviver?: Mutator;
   runtimeValidation: boolean;
+  useRuntimeFetcher: boolean;
 }
 interface FetchOptions {
   includeHttpResponseReturnType?: boolean;
   forceSuccessResponse?: boolean;
   jsonReviver?: Mutator;
   runtimeValidation?: boolean;
+  useRuntimeFetcher?: boolean;
 }
 type InputTransformerFn = (spec: OpenApiDocument) => OpenApiDocument;
 type InputTransformer = string | InputTransformerFn;
@@ -728,8 +777,7 @@ interface GlobalOptions {
   watch?: boolean | string | string[];
   verbose?: boolean;
   clean?: boolean | string[];
-  prettier?: boolean;
-  biome?: boolean;
+  formatter?: SupportedFormatter;
   mock?: boolean | GlobalMockOptions;
   client?: OutputClient;
   httpClient?: OutputHttpClient;
@@ -738,6 +786,7 @@ interface GlobalOptions {
   packageJson?: string;
   input?: string | string[];
   output?: string;
+  failOnWarnings?: boolean;
 }
 interface Tsconfig {
   baseUrl?: string;
@@ -1072,6 +1121,7 @@ interface WriteModeProps {
   projectName?: string;
   header: string;
   needSchema: boolean;
+  generateSchemasInline?: () => string;
 }
 interface GeneratorApiOperations {
   verbOptions: Record<string, GeneratorVerbOptions>;
@@ -1415,7 +1465,7 @@ declare function generateVerbOptions({
   pathRoute,
   verbParameters,
   context
-}: GenerateVerbOptionsParams): Promise<GeneratorVerbOptions>;
+}: GenerateVerbOptionsParams): Promise<GeneratorVerbOptions[]>;
 interface GenerateVerbsOptionsParams {
   verbs: OpenApiPathItemObject;
   input: NormalizedInputOptions;
@@ -1515,6 +1565,18 @@ declare function getBody({
   context,
   contentType
 }: GetBodyOptions): GetterBody;
+/**
+ * Returns per-content-type bodies when `splitByContentType` is enabled.
+ * Each entry includes a `contentTypeSuffix` for generating distinct function names.
+ */
+declare function getBodiesByContentType({
+  requestBody,
+  operationName,
+  context,
+  contentType
+}: GetBodyOptions): (GetterBody & {
+  contentTypeSuffix: string;
+})[];
 //#endregion
 //#region src/getters/combine.d.ts
 type Separator = 'allOf' | 'anyOf' | 'oneOf';
@@ -1696,7 +1758,11 @@ declare function getResponse({
 //#endregion
 //#region src/getters/route.d.ts
 declare function getRoute(route: string): string;
-declare function getFullRoute(route: string, servers: OpenApiServerObject[] | undefined, baseUrl: string | BaseUrlFromConstant | BaseUrlFromSpec | undefined): string;
+declare function getFullRoute(route: string, servers: OpenApiServerObject[] | undefined, baseUrl: string | BaseUrlFromConstant | BaseUrlFromSpec | BaseUrlRuntime | undefined): string;
+/**
+ * Returns `GeneratorImport` entries for {@link BaseUrlRuntime.imports} when `baseUrl` is a runtime config.
+ */
+declare function getBaseUrlRuntimeImports(baseUrl?: NormalizedOutputOptions['baseUrl']): GeneratorImport[];
 declare function getRouteAsArray(route: string): string;
 //#endregion
 //#region src/getters/scalar.d.ts
@@ -1815,7 +1881,9 @@ declare function compareVersions(firstVersion: string, secondVersions: string, o
 //#endregion
 //#region src/utils/content-type.d.ts
 /**
- * Determine if a content type is binary (vs text-based).
+ * Determine if a content type is binary.
+ * Only known binary types return true. Unknown types default to false (non-binary)
+ * so that schema type information is preserved rather than being overridden with Blob.
  */
 declare function isBinaryContentType(contentType: string): boolean;
 /**
@@ -1941,6 +2009,9 @@ declare function getIsBodyVerb(verb: Verbs): boolean;
 //#endregion
 //#region src/utils/logger.d.ts
 declare const log: (message?: any, ...optionalParams: any[]) => void;
+declare function logWarning(message: string): void;
+declare function getWarningCount(): number;
+declare function resetWarnings(): void;
 declare function setVerbose(v: boolean): void;
 declare function isVerbose(): boolean;
 declare const logVerbose: typeof console.log;
@@ -2200,7 +2271,8 @@ declare function writeSingleMode({
   output,
   projectName,
   header,
-  needSchema
+  needSchema,
+  generateSchemasInline
 }: WriteModeProps): Promise<string[]>;
 //#endregion
 //#region src/writers/split-mode.d.ts
@@ -2209,7 +2281,8 @@ declare function writeSplitMode({
   output,
   projectName,
   header,
-  needSchema
+  needSchema,
+  generateSchemasInline
 }: WriteModeProps): Promise<string[]>;
 //#endregion
 //#region src/writers/split-tags-mode.d.ts
@@ -2218,7 +2291,8 @@ declare function writeSplitTagsMode({
   output,
   projectName,
   header,
-  needSchema
+  needSchema,
+  generateSchemasInline
 }: WriteModeProps): Promise<string[]>;
 //#endregion
 //#region src/writers/tags-mode.d.ts
@@ -2227,7 +2301,8 @@ declare function writeTagsMode({
   output,
   projectName,
   header,
-  needSchema
+  needSchema,
+  generateSchemasInline
 }: WriteModeProps): Promise<string[]>;
 //#endregion
 //#region src/writers/target.d.ts
@@ -2240,5 +2315,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, 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, JsDocOptions, LogLevel, LogLevels, LogOptions, LogType, Logger, LoggerOptions, MockData, MockDataArray, MockDataArrayFn, MockDataObject, MockDataObjectFn, MockOptions, MockProperties, MockPropertiesObject, MockPropertiesObjectFn, MutationInvalidatesConfig, MutationInvalidatesRule, Mutator, MutatorObject, NamingConvention, NormalizedAngularOptions, 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, PreferredContentType, PropertySortOrder, QueryOptions, ReadonlyRequestBodiesMode, 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, 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, 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, isBinaryContentType, isBoolean, isDirectory, isFunction, isModule, isNullish, isNumber, isNumeric, isObject, isReference, isSchema, isString, isStringLike, isSyntheticDefaultImportsAllow, isUrl, isVerb, isVerbose, jsDoc, jsStringEscape, kebab, keyValuePairsToJsDoc, log, logError, logVerbose, mergeDeep, mismatchArgsMessage, pascal, removeFilesAndEmptyFolders, 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, JsDocOptions, LogLevel, LogLevels, LogOptions, LogType, Logger, LoggerOptions, MockData, MockDataArray, MockDataArrayFn, MockDataObject, MockDataObjectFn, MockOptions, MockProperties, MockPropertiesObject, MockPropertiesObjectFn, MutationInvalidatesConfig, MutationInvalidatesRule, Mutator, MutatorObject, NamingConvention, NormalizedAngularOptions, 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, 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 };
 //# sourceMappingURL=index.d.mts.map