@hey-api/openapi-ts 0.93.1 → 0.94.0

package/dist/{init-CuDouDN2.mjs → init-PHWYaLgi.mjs}

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 import { StructureModel, detectInteractiveSession, fromRef, isNode, isRef, isSymbol, loadConfigFile, log, nodeBrand, ref, refs } from "@hey-api/codegen-core";
-import { ConfigError, OperationPath, OperationStrategy, applyNaming, childContext, createOperationKey, createSchemaProcessor, createSchemaWalker, deduplicateSchema, definePluginConfig, dependencyFactory, ensureDirSync, escapeComment, findTsConfigPath, getInput, getLogs, getParser, hasOperationDataRequired, hasParameterGroupObjectRequired, loadTsConfig, mappers, operationPagination, operationResponsesMap, parseUrl, pathToJsonPointer, pathToName, refToName, resolveSource, satisfies, statusCodeToGroup, toCase, valueToObject } from "@hey-api/shared";
+import { ConfigError, OperationPath, OperationStrategy, applyNaming, childContext, createOperationKey, createSchemaProcessor, createSchemaWalker, deduplicateSchema, definePluginConfig, dependencyFactory, ensureDirSync, escapeComment, findTsConfigPath, getInput, getLogs, getParser, hasOperationDataRequired, hasParameterGroupObjectRequired, loadTsConfig, mappers, operationPagination, operationResponsesMap, outputHeaderToPrefix, parseUrl, pathToJsonPointer, pathToName, refToName, resolveSource, satisfies, statusCodeToGroup, toCase, valueToObject } from "@hey-api/shared";
 import colors from "ansi-colors";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -723,24 +723,51 @@ const regexp = {
 //#region src/ts-dsl/utils/keywords.ts
 const browserGlobals = [
 	"document",
+	"fetch",
 	"history",
 	"location",
 	"navigator",
-	"window"
+	"window",
+	"AbortController",
+	"AbortSignal",
+	"Blob",
+	"CustomEvent",
+	"Event",
+	"EventTarget",
+	"File",
+	"FileList",
+	"FileReader",
+	"FormData",
+	"Headers",
+	"Request",
+	"Response",
+	"TextDecoder",
+	"TextEncoder",
+	"URL",
+	"URLSearchParams"
 ];
 const javaScriptGlobals = [
 	"console",
 	"Array",
+	"ArrayBuffer",
+	"BigInt",
+	"Boolean",
+	"DataView",
 	"Date",
 	"Error",
 	"Function",
 	"JSON",
 	"Map",
 	"Math",
+	"Number",
 	"Object",
 	"Promise",
+	"Proxy",
+	"Reflect",
 	"RegExp",
 	"Set",
+	"String",
+	"Symbol",
 	"WeakMap",
 	"WeakSet"
 ];
@@ -797,8 +824,13 @@ const javaScriptKeywords = [
 	"yield"
 ];
 const nodeGlobals = [
+	"__dirname",
+	"__filename",
+	"exports",
 	"global",
+	"module",
 	"process",
+	"require",
 	"Buffer"
 ];
 const typeScriptKeywords = [
@@ -887,21 +919,26 @@ const safePropName = (name) => {
 	if (regexp.typeScriptIdentifier.test(name)) return new IdTsDsl(name);
 	return new LiteralTsDsl(name);
 };
+const validTypeScriptChar = /^[\u200c\u200d\p{ID_Continue}]$/u;
 const safeName = (name, reserved$1) => {
 	let sanitized = "";
 	let index;
 	const first = name[0] ?? "";
 	regexp.illegalStartCharacters.lastIndex = 0;
-	if (regexp.illegalStartCharacters.test(first)) {
+	if (regexp.illegalStartCharacters.test(first)) if (validTypeScriptChar.test(first)) {
 		sanitized += "_";
 		index = 0;
 	} else {
+		sanitized += "_";
+		index = 1;
+	}
+	else {
 		sanitized += first;
 		index = 1;
 	}
 	while (index < name.length) {
 		const char = name[index] ?? "";
-		sanitized += /^[\u200c\u200d\p{ID_Continue}]$/u.test(char) ? char : "_";
+		sanitized += validTypeScriptChar.test(char) ? char : "_";
 		index += 1;
 	}
 	if (reserved$1["~values"].has(sanitized)) sanitized = `${sanitized}_`;
@@ -5241,7 +5278,7 @@ const handler$11 = ({ plugin }) => {
 
 //#endregion
 //#region src/plugins/@angular/common/config.ts
-const defaultConfig$23 = {
+const defaultConfig$24 = {
 	config: {
 		comments: true,
 		includeInEntry: false
@@ -5257,7 +5294,7 @@ const defaultConfig$23 = {
 /**
 * Type helper for `@angular/common` plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$23 = definePluginConfig(defaultConfig$23);
+const defineConfig$24 = definePluginConfig(defaultConfig$24);
 
 //#endregion
 //#region src/plugins/@faker-js/faker/api.ts
@@ -5268,7 +5305,7 @@ var Api$4 = class {
 
 //#endregion
 //#region src/plugins/@faker-js/faker/config.ts
-const defaultConfig$22 = {
+const defaultConfig$23 = {
 	api: new Api$4(),
 	config: {
 		case: "camelCase",
@@ -5292,7 +5329,7 @@ const defaultConfig$22 = {
 /**
 * Type helper for Faker plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$22 = definePluginConfig(defaultConfig$22);
+const defineConfig$23 = definePluginConfig(defaultConfig$23);
 
 //#endregion
 //#region src/plugins/@hey-api/client-core/config.ts
@@ -5311,13 +5348,10 @@ const clientDefaultMeta = {
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 /**
-* Dev mode: 'src' appears after 'dist' (or dist doesn't exist), and 'generate' follows 'src'
+* Dev mode: determined by OPENAPI_TS_DEV_MODE environment variable
 */
 function isDevMode() {
-	const normalized = __dirname.split(path.sep);
-	const srcIndex = normalized.lastIndexOf("src");
-	const distIndex = normalized.lastIndexOf("dist");
-	return srcIndex !== -1 && srcIndex > distIndex && srcIndex === normalized.length - 2 && normalized[srcIndex + 1] === "generate";
+	return process.env.OPENAPI_TS_DEV_MODE === "true" || process.env.OPENAPI_TS_DEV_MODE === "1";
 }
 /**
 * Returns paths to client bundle files based on execution context
@@ -5337,16 +5371,6 @@ function getClientBundlePaths(pluginName) {
 	};
 }
 /**
-* Converts an {@link OutputHeader} value to a string prefix for file content.
-* Returns an empty string when the header is null, undefined, or a function
-* (functions require a render context which is not available for bundled files).
-*/
-function outputHeaderToPrefix(header) {
-	if (header == null || typeof header === "function") return "";
-	const content = (typeof header === "string" ? header.split(/\r?\n/) : header.flatMap((line) => line.split(/\r?\n/))).join("\n");
-	return content ? `${content}\n\n` : "";
-}
-/**
 * Returns absolute path to the client folder. This is hard-coded for now.
 */
 function clientFolderAbsolutePath(config) {
@@ -5405,7 +5429,7 @@ function replaceImports({ filePath, header, isDevMode: isDevMode$1, meta, rename
 function generateClientBundle({ header, meta, outputPath, plugin, project }) {
 	const renamed = /* @__PURE__ */ new Map();
 	const devMode = isDevMode();
-	const headerPrefix = outputHeaderToPrefix(header);
+	const headerPrefix = outputHeaderToPrefix(header, project);
 	if (plugin.name.startsWith("@hey-api/client-")) {
 		const { clientPath, corePath } = getClientBundlePaths(plugin.name);
 		const coreOutputPath = path.resolve(outputPath, "core");
@@ -5499,7 +5523,7 @@ const createClient = ({ plugin }) => {
 	if ("throwOnError" in plugin.config && plugin.config.throwOnError) defaultVals.prop("throwOnError", $.literal(true));
 	const createConfigParameters = [$(symbolCreateConfig).call(defaultVals.hasProps() ? defaultVals : void 0).generic(symbolClientOptions)];
 	const symbolClient = plugin.symbol("client", { meta: { category: "client" } });
-	const statement = $.const(symbolClient).export().assign($(symbolCreateClient).$if(symbolCreateClientConfig, (c, s) => c.call($.await($(s).call(...createConfigParameters))), (c) => c.call(...createConfigParameters)));
+	const statement = $.const(symbolClient).export().assign($(symbolCreateClient).$if(symbolCreateClientConfig, (c, s) => c.call($(s).call(...createConfigParameters)), (c) => c.call(...createConfigParameters)));
 	plugin.node(statement);
 };
 
@@ -5528,7 +5552,7 @@ const createClientConfigType = ({ plugin }) => {
 		"You may want to initialize your client this way instead of calling",
 		"`setConfig()`. This is useful for example if you're using Next.js",
 		"to ensure your client always has the correct values."
-	]).generic("T", (g) => g.extends(symbolDefaultClientOptions).default(symbolClientOptions)).type($.type.func().param("override", (p) => p.optional().type($.type(symbolConfig).generic($.type.and(symbolDefaultClientOptions, "T")))).returns($.type.or($.type(symbolConfig).generic($.type.and($.type("Required").generic(symbolDefaultClientOptions), "T")), $.type("Promise").generic($.type(symbolConfig).generic($.type.and($.type("Required").generic(symbolDefaultClientOptions), "T"))))));
+	]).generic("T", (g) => g.extends(symbolDefaultClientOptions).default(symbolClientOptions)).type($.type.func().param("override", (p) => p.optional().type($.type(symbolConfig).generic($.type.and(symbolDefaultClientOptions, "T")))).returns($.type(symbolConfig).generic($.type.and($.type("Required").generic(symbolDefaultClientOptions), "T"))));
 	plugin.node(typeCreateClientConfig);
 };
 
@@ -5541,7 +5565,7 @@ const clientPluginHandler = ({ plugin }) => {
 
 //#endregion
 //#region src/plugins/@hey-api/client-angular/config.ts
-const defaultConfig$21 = {
+const defaultConfig$22 = {
 	...clientDefaultMeta,
 	config: {
 		...clientDefaultConfig,
@@ -5553,11 +5577,11 @@ const defaultConfig$21 = {
 /**
 * Type helper for `@hey-api/client-angular` plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$21 = definePluginConfig(defaultConfig$21);
+const defineConfig$22 = definePluginConfig(defaultConfig$22);
 
 //#endregion
 //#region src/plugins/@hey-api/client-axios/config.ts
-const defaultConfig$20 = {
+const defaultConfig$21 = {
 	...clientDefaultMeta,
 	config: {
 		...clientDefaultConfig,
@@ -5569,11 +5593,11 @@ const defaultConfig$20 = {
 /**
 * Type helper for `@hey-api/client-axios` plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$20 = definePluginConfig(defaultConfig$20);
+const defineConfig$21 = definePluginConfig(defaultConfig$21);
 
 //#endregion
 //#region src/plugins/@hey-api/client-fetch/config.ts
-const defaultConfig$19 = {
+const defaultConfig$20 = {
 	...clientDefaultMeta,
 	config: {
 		...clientDefaultConfig,
@@ -5585,11 +5609,11 @@ const defaultConfig$19 = {
 /**
 * Type helper for `@hey-api/client-fetch` plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$19 = definePluginConfig(defaultConfig$19);
+const defineConfig$20 = definePluginConfig(defaultConfig$20);
 
 //#endregion
 //#region src/plugins/@hey-api/client-ky/config.ts
-const defaultConfig$18 = {
+const defaultConfig$19 = {
 	...clientDefaultMeta,
 	config: {
 		...clientDefaultConfig,
@@ -5601,11 +5625,11 @@ const defaultConfig$18 = {
 /**
 * Type helper for `@hey-api/client-ky` plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$18 = definePluginConfig(defaultConfig$18);
+const defineConfig$19 = definePluginConfig(defaultConfig$19);
 
 //#endregion
 //#region src/plugins/@hey-api/client-next/config.ts
-const defaultConfig$17 = {
+const defaultConfig$18 = {
 	...clientDefaultMeta,
 	config: {
 		...clientDefaultConfig,
@@ -5617,11 +5641,11 @@ const defaultConfig$17 = {
 /**
 * Type helper for `@hey-api/client-next` plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$17 = definePluginConfig(defaultConfig$17);
+const defineConfig$18 = definePluginConfig(defaultConfig$18);
 
 //#endregion
 //#region src/plugins/@hey-api/client-nuxt/config.ts
-const defaultConfig$16 = {
+const defaultConfig$17 = {
 	...clientDefaultMeta,
 	config: clientDefaultConfig,
 	handler: clientPluginHandler,
@@ -5630,11 +5654,11 @@ const defaultConfig$16 = {
 /**
 * Type helper for `@hey-api/client-nuxt` plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$16 = definePluginConfig(defaultConfig$16);
+const defineConfig$17 = definePluginConfig(defaultConfig$17);
 
 //#endregion
 //#region src/plugins/@hey-api/client-ofetch/config.ts
-const defaultConfig$15 = {
+const defaultConfig$16 = {
 	...clientDefaultMeta,
 	config: {
 		...clientDefaultConfig,
@@ -5646,7 +5670,7 @@ const defaultConfig$15 = {
 /**
 * Type helper for `@hey-api/client-ofetch` plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$15 = definePluginConfig(defaultConfig$15);
+const defineConfig$16 = definePluginConfig(defaultConfig$16);
 
 //#endregion
 //#region src/plugins/@hey-api/schemas/plugin.ts
@@ -5904,7 +5928,7 @@ const handler$10 = ({ plugin }) => {
 
 //#endregion
 //#region src/plugins/@hey-api/schemas/config.ts
-const defaultConfig$14 = {
+const defaultConfig$15 = {
 	config: {
 		includeInEntry: false,
 		nameBuilder: (name) => `${name}Schema`,
@@ -5916,7 +5940,7 @@ const defaultConfig$14 = {
 /**
 * Type helper for `@hey-api/schemas` plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$14 = definePluginConfig(defaultConfig$14);
+const defineConfig$15 = definePluginConfig(defaultConfig$15);
 
 //#endregion
 //#region src/plugins/@hey-api/sdk/examples/config.ts
@@ -6212,7 +6236,7 @@ const handler$9 = (args) => handlerV1$2(args);
 
 //#endregion
 //#region src/plugins/@hey-api/sdk/config.ts
-const defaultConfig$13 = {
+const defaultConfig$14 = {
 	config: {
 		auth: true,
 		client: true,
@@ -6255,7 +6279,7 @@ const defaultConfig$13 = {
 /**
 * Type helper for `@hey-api/sdk` plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$13 = definePluginConfig(defaultConfig$13);
+const defineConfig$14 = definePluginConfig(defaultConfig$14);
 
 //#endregion
 //#region src/plugins/@hey-api/transformers/expressions.ts
@@ -6439,7 +6463,7 @@ const handler$8 = ({ plugin }) => {
 
 //#endregion
 //#region src/plugins/@hey-api/transformers/config.ts
-const defaultConfig$12 = {
+const defaultConfig$13 = {
 	config: {
 		bigInt: true,
 		dates: true,
@@ -6460,7 +6484,7 @@ const defaultConfig$12 = {
 /**
 * Type helper for `@hey-api/transformers`, returns {@link Plugin.Config} object
 */
-const defineConfig$12 = definePluginConfig(defaultConfig$12);
+const defineConfig$13 = definePluginConfig(defaultConfig$13);
 
 //#endregion
 //#region src/plugins/@hey-api/typescript/shared/clientOptions.ts
@@ -6571,7 +6595,7 @@ const exportType = ({ plugin, schema, state, type }) => {
 				tags: fromRef(state.tags),
 				tool: "typescript"
 			} });
-			const node$1 = $.type.alias(symbol$1).export().$if(plugin.config.comments && createSchemaComment(schema), (t, v) => t.doc(v)).type($.type(symbol$1).idx($.type(symbol$1).typeofType().keyof()).typeofType());
+			const node$1 = $.type.alias(symbol$1).export().$if(plugin.config.comments && createSchemaComment(schema), (t, v) => t.doc(v)).type($.type(symbolObject).idx($.type(symbolObject).typeofType().keyof()).typeofType());
 			plugin.node(node$1);
 			return;
 		} else if (plugin.config.enums.mode === "typescript" || plugin.config.enums.mode === "typescript-const") {
@@ -7235,7 +7259,7 @@ const handler$7 = (args) => handlerV1$1(args);
 
 //#endregion
 //#region src/plugins/@hey-api/typescript/config.ts
-const defaultConfig$11 = {
+const defaultConfig$12 = {
 	api: new Api$3(),
 	config: {
 		case: "PascalCase",
@@ -7322,7 +7346,7 @@ const defaultConfig$11 = {
 /**
 * Type helper for `@hey-api/typescript` plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$11 = definePluginConfig(defaultConfig$11);
+const defineConfig$12 = definePluginConfig(defaultConfig$12);
 
 //#endregion
 //#region src/plugins/@pinia/colada/meta.ts
@@ -7540,7 +7564,13 @@ const createQueryOptions$1 = ({ operation, plugin }) => {
 		tool: plugin.name
 	} });
 	const symbolDefineQueryOptions = plugin.external(`${plugin.name}.defineQueryOptions`);
-	const statement = $.const(symbolQueryOptionsFn).export().$if(plugin.config.comments && createOperationComment(operation), (c, v) => c.doc(v)).assign($(symbolDefineQueryOptions).call($.func().param(optionsParamName$2, (p) => p.required(isRequiredOptions).type(typeData)).do($.return(queryOpts))));
+	const statement = $.const(symbolQueryOptionsFn).export().$if(plugin.config.comments && createOperationComment(operation), (c, v) => c.doc(v)).assign($(symbolDefineQueryOptions).call($.func().param(optionsParamName$2, (p) => p.required(isRequiredOptions).type(typeData)).do($.return(queryOpts))).generics(typeData, useTypeResponse$1({
+		operation,
+		plugin
+	}), useTypeError$1({
+		operation,
+		plugin
+	})));
 	plugin.node(statement);
 };
 
@@ -7608,7 +7638,7 @@ const handler$6 = (args) => handlerV0(args);
 
 //#endregion
 //#region src/plugins/@pinia/colada/config.ts
-const defaultConfig$10 = {
+const defaultConfig$11 = {
 	config: {
 		case: "camelCase",
 		comments: true,
@@ -7651,7 +7681,7 @@ const defaultConfig$10 = {
 /**
 * Type helper for `@pinia/colada` plugin, returns {@link Plugin.Config} object
 */
-const defineConfig$10 = definePluginConfig(defaultConfig$10);
+const defineConfig$11 = definePluginConfig(defaultConfig$11);
 
 //#endregion
 //#region src/plugins/@tanstack/query-core/shared/useType.ts
@@ -7877,7 +7907,7 @@ const createMutationOptions = ({ operation, plugin }) => {
 		role: "mutationOptions",
 		tool: plugin.name
 	} });
-	const statement = $.const(symbolMutationOptions).export().$if(plugin.config.comments && createOperationComment(operation), (c, v) => c.doc(v)).assign($.func().param("options", (p) => p.optional().type($.type("Partial").generic(typeData))).returns(mutationType).do($.const(mutationOptionsFn).type(mutationType).assign($.object().pretty().prop("mutationFn", $.func().async().param(fnOptions$1).do(...statements)).$if(handleMeta(plugin, operation, "mutationOptions"), (c, v) => c.prop("meta", v))), $(mutationOptionsFn).return()));
+	const statement = $.const(symbolMutationOptions).export(plugin.config.mutationOptions.exported).$if(plugin.config.comments && createOperationComment(operation), (c, v) => c.doc(v)).assign($.func().param("options", (p) => p.optional().type($.type("Partial").generic(typeData))).returns(mutationType).do($.const(mutationOptionsFn).type(mutationType).assign($.object().pretty().prop("mutationFn", $.func().async().param(fnOptions$1).do(...statements)).$if(handleMeta(plugin, operation, "mutationOptions"), (c, v) => c.prop("meta", v))), $(mutationOptionsFn).return()));
 	plugin.node(statement);
 };
 
@@ -7937,6 +7967,38 @@ const createQueryOptions = ({ operation, plugin }) => {
 	plugin.node(statement);
 };
 
+//#endregion
+//#region src/plugins/@tanstack/query-core/v5/useMutation.ts
+const mutationOptionsParamName = "mutationOptions";
+const createUseMutation = ({ operation, plugin }) => {
+	if (!("useMutation" in plugin.config)) return;
+	const symbolUseMutationFn = plugin.symbol(applyNaming(operation.id, plugin.config.useMutation));
+	const symbolUseMutation = plugin.external(`${plugin.name}.useMutation`);
+	const typeData = useTypeData({
+		operation,
+		plugin
+	});
+	const symbolMutationOptionsType = plugin.external(`${plugin.name}.MutationOptions`);
+	const mutationType = $.type(symbolMutationOptionsType).generic(useTypeResponse({
+		operation,
+		plugin
+	})).generic(useTypeError({
+		operation,
+		plugin
+	})).generic(typeData);
+	const symbolMutationOptionsFn = plugin.referenceSymbol({
+		category: "hook",
+		resource: "operation",
+		resourceId: operation.id,
+		role: "mutationOptions",
+		tool: plugin.name
+	});
+	const func = $.func().param(mutationOptionsParamName, (p) => p.optional().type($.type("Partial").generic($.type("Omit", (t) => t.generics(mutationType, $.type.literal("mutationFn"))))));
+	func.do($(symbolUseMutation).call($.object().spread($(symbolMutationOptionsFn).call()).spread(mutationOptionsParamName)).return());
+	const statement = $.const(symbolUseMutationFn).export().$if(plugin.config.comments && createOperationComment(operation), (c, v) => c.doc(v)).assign(func);
+	plugin.node(statement);
+};
+
 //#endregion
 //#region src/plugins/@tanstack/query-core/v5/useQuery.ts
 const optionsParamName = "options";
@@ -8006,6 +8068,13 @@ const handlerV5 = ({ plugin }) => {
 			resource: `${plugin.name}.queryOptions`
 		}
 	});
+	plugin.symbol("useMutation", {
+		external: plugin.name,
+		meta: {
+			category: "external",
+			resource: `${plugin.name}.useMutation`
+		}
+	});
 	plugin.symbol("useQuery", {
 		external: plugin.name,
 		meta: {
@@ -8041,6 +8110,10 @@ const handlerV5 = ({ plugin }) => {
 				operation,
 				plugin
 			});
+			if ("useMutation" in plugin.config && plugin.config.useMutation.enabled) createUseMutation({
+				operation,
+				plugin
+			});
 		}
 	}, { order: "declarations" });
 };
@@ -8051,7 +8124,7 @@ const handler$5 = (args) => handlerV5(args);
 
 //#endregion
 //#region src/plugins/@tanstack/angular-query-experimental/config.ts
-const defaultConfig$9 = {
+const defaultConfig$10 = {
 	config: {
 		case: "camelCase",
 		comments: true,
@@ -8084,6 +8157,7 @@ const defaultConfig$9 = {
 			defaultValue: {
 				case: plugin.config.case ?? "camelCase",
 				enabled: true,
+				exported: true,
 				name: "{{name}}Mutation"
 			},
 			mappers,
@@ -8114,6 +8188,132 @@ const defaultConfig$9 = {
 /**
 * Type helper for `@tanstack/angular-query-experimental` plugin, returns {@link Plugin.Config} object
 */
+const defineConfig$10 = definePluginConfig(defaultConfig$10);
+
+//#endregion
+//#region src/plugins/@tanstack/preact-query/config.ts
+const defaultConfig$9 = {
+	config: {
+		case: "camelCase",
+		comments: true,
+		includeInEntry: false
+	},
+	dependencies: ["@hey-api/sdk", "@hey-api/typescript"],
+	handler: handler$5,
+	name: "@tanstack/preact-query",
+	resolveConfig: (plugin, context) => {
+		plugin.config.infiniteQueryKeys = context.valueToObject({
+			defaultValue: {
+				case: plugin.config.case ?? "camelCase",
+				enabled: true,
+				name: "{{name}}InfiniteQueryKey",
+				tags: false
+			},
+			mappers,
+			value: plugin.config.infiniteQueryKeys
+		});
+		plugin.config.infiniteQueryOptions = context.valueToObject({
+			defaultValue: {
+				case: plugin.config.case ?? "camelCase",
+				enabled: true,
+				name: "{{name}}InfiniteOptions"
+			},
+			mappers,
+			value: plugin.config.infiniteQueryOptions
+		});
+		plugin.config.mutationOptions = context.valueToObject({
+			defaultValue: {
+				case: plugin.config.case ?? "camelCase",
+				enabled: true,
+				exported: true,
+				name: "{{name}}Mutation"
+			},
+			mappers,
+			value: plugin.config.mutationOptions
+		});
+		plugin.config.queryKeys = context.valueToObject({
+			defaultValue: {
+				case: plugin.config.case ?? "camelCase",
+				enabled: true,
+				name: "{{name}}QueryKey",
+				tags: false
+			},
+			mappers,
+			value: plugin.config.queryKeys
+		});
+		plugin.config.queryOptions = context.valueToObject({
+			defaultValue: {
+				case: plugin.config.case ?? "camelCase",
+				enabled: true,
+				exported: true,
+				name: "{{name}}Options"
+			},
+			mappers,
+			value: plugin.config.queryOptions
+		});
+		plugin.config.useMutation = context.valueToObject({
+			defaultValue: {
+				case: plugin.config.case ?? "camelCase",
+				enabled: false,
+				name: "use{{name}}Mutation"
+			},
+			mappers: {
+				boolean: (enabled) => ({ enabled }),
+				function: (name) => ({
+					enabled: true,
+					name
+				}),
+				object: (fields) => ({
+					enabled: true,
+					...fields
+				}),
+				string: (name) => ({
+					enabled: true,
+					name
+				})
+			},
+			value: plugin.config.useMutation
+		});
+		plugin.config.useQuery = context.valueToObject({
+			defaultValue: {
+				case: plugin.config.case ?? "camelCase",
+				enabled: false,
+				name: "use{{name}}Query"
+			},
+			mappers: {
+				boolean: (enabled) => ({ enabled }),
+				function: (name) => ({
+					enabled: true,
+					name
+				}),
+				object: (fields) => ({
+					enabled: true,
+					...fields
+				}),
+				string: (name) => ({
+					enabled: true,
+					name
+				})
+			},
+			value: plugin.config.useQuery
+		});
+		if (plugin.config.useMutation.enabled) {
+			if (!plugin.config.mutationOptions.enabled) {
+				plugin.config.mutationOptions.enabled = true;
+				plugin.config.mutationOptions.exported = false;
+			}
+		}
+		if (plugin.config.useQuery.enabled) {
+			if (!plugin.config.queryOptions.enabled) {
+				plugin.config.queryOptions.enabled = true;
+				plugin.config.queryOptions.exported = false;
+			}
+		}
+	}
+};
+/**
+* Type helper for `@tanstack/preact-query` plugin, returns {@link Plugin.Config} object
+*/
 const defineConfig$9 = definePluginConfig(defaultConfig$9);
 
 //#endregion
@@ -8151,6 +8351,7 @@ const defaultConfig$8 = {
 			defaultValue: {
 				case: plugin.config.case ?? "camelCase",
 				enabled: true,
+				exported: true,
 				name: "{{name}}Mutation"
 			},
 			mappers,
@@ -8176,6 +8377,29 @@ const defaultConfig$8 = {
 			mappers,
 			value: plugin.config.queryOptions
 		});
+		plugin.config.useMutation = context.valueToObject({
+			defaultValue: {
+				case: plugin.config.case ?? "camelCase",
+				enabled: false,
+				name: "use{{name}}Mutation"
+			},
+			mappers: {
+				boolean: (enabled) => ({ enabled }),
+				function: (name) => ({
+					enabled: true,
+					name
+				}),
+				object: (fields) => ({
+					enabled: true,
+					...fields
+				}),
+				string: (name) => ({
+					enabled: true,
+					name
+				})
+			},
+			value: plugin.config.useMutation
+		});
 		plugin.config.useQuery = context.valueToObject({
 			defaultValue: {
 				case: plugin.config.case ?? "camelCase",
@@ -8199,6 +8423,12 @@ const defaultConfig$8 = {
 			},
 			value: plugin.config.useQuery
 		});
+		if (plugin.config.useMutation.enabled) {
+			if (!plugin.config.mutationOptions.enabled) {
+				plugin.config.mutationOptions.enabled = true;
+				plugin.config.mutationOptions.exported = false;
+			}
+		}
 		if (plugin.config.useQuery.enabled) {
 			if (!plugin.config.queryOptions.enabled) {
 				plugin.config.queryOptions.enabled = true;
@@ -8247,6 +8477,7 @@ const defaultConfig$7 = {
 			defaultValue: {
 				case: plugin.config.case ?? "camelCase",
 				enabled: true,
+				exported: true,
 				name: "{{name}}Mutation"
 			},
 			mappers,
@@ -8314,6 +8545,7 @@ const defaultConfig$6 = {
 			defaultValue: {
 				case: plugin.config.case ?? "camelCase",
 				enabled: true,
+				exported: true,
 				name: "{{name}}Mutation"
 			},
 			mappers,
@@ -8381,6 +8613,7 @@ const defaultConfig$5 = {
 			defaultValue: {
 				case: plugin.config.case ?? "camelCase",
 				enabled: true,
+				exported: true,
 				name: "{{name}}Mutation"
 			},
 			mappers,
@@ -10368,14 +10601,21 @@ function createVisitor$3(config) {
 			};
 		},
 		postProcess(result, schema, ctx$1) {
-			if (ctx$1.plugin.config.metadata && schema.description) {
-				const metadataExpr = $(ctx$1.plugin.external("valibot.v")).attr(identifiers$1.actions.metadata).call($.object().prop("description", $.literal(schema.description)));
-				return {
-					meta: result.meta,
-					pipes: [...result.pipes, metadataExpr]
-				};
-			}
-			return result;
+			const metadata = ctx$1.plugin.config.metadata;
+			if (!metadata) return result;
+			const node = $.object();
+			if (typeof metadata === "function") metadata({
+				$,
+				node,
+				schema
+			});
+			else if (schema.description) node.prop("description", $.literal(schema.description));
+			if (node.isEmpty) return result;
+			const metadataExpr = $(ctx$1.plugin.external("valibot.v")).attr(identifiers$1.actions.metadata).call(node);
+			return {
+				meta: result.meta,
+				pipes: [...result.pipes, metadataExpr]
+			};
 		},
 		reference($ref, schema, ctx$1) {
 			const v = ctx$1.plugin.external("valibot.v");
@@ -10490,10 +10730,10 @@ function createVisitor$3(config) {
 //#region src/plugins/valibot/v1/processor.ts
 function createProcessor$3(plugin) {
 	const processor = createSchemaProcessor();
-	const hooks = [plugin.config["~hooks"]?.schemas, plugin.context.config.parser.hooks.schemas];
+	const extractorHooks = [plugin.config["~hooks"]?.schemas?.shouldExtract, plugin.context.config.parser.hooks.schemas?.shouldExtract];
 	function extractor(ctx$1) {
 		if (processor.hasEmitted(ctx$1.path)) return ctx$1.schema;
-		for (const hook of hooks) if (hook?.shouldExtract?.(ctx$1)) {
+		for (const hook of extractorHooks) if (hook?.(ctx$1)) {
 			process$1({
 				namingAnchor: processor.context.anchor,
 				tags: processor.context.tags,
@@ -11708,14 +11948,21 @@ function createVisitor$2(config) {
 			};
 		},
 		postProcess(result, schema, ctx$1) {
-			if (ctx$1.plugin.config.metadata && schema.description) {
-				const z = ctx$1.plugin.external("zod.z");
-				return {
-					...result,
-					expression: { expression: result.expression.expression.attr(identifiers.register).call($(z).attr(identifiers.globalRegistry), $.object().pretty().prop("description", $.literal(schema.description))) }
-				};
-			}
-			return result;
+			const metadata = ctx$1.plugin.config.metadata;
+			if (!metadata) return result;
+			const node = $.object();
+			if (typeof metadata === "function") metadata({
+				$,
+				node,
+				schema
+			});
+			else if (schema.description) node.pretty().prop("description", $.literal(schema.description));
+			if (node.isEmpty) return result;
+			const z = ctx$1.plugin.external("zod.z");
+			return {
+				...result,
+				expression: { expression: result.expression.expression.attr(identifiers.register).call($(z).attr(identifiers.globalRegistry), node) }
+			};
 		},
 		reference($ref, schema, ctx$1) {
 			const z = ctx$1.plugin.external("zod.z");
@@ -13431,14 +13678,21 @@ function createVisitor(config) {
 			};
 		},
 		postProcess(result, schema, ctx$1) {
-			if (ctx$1.plugin.config.metadata && schema.description) {
-				const z = ctx$1.plugin.external("zod.z");
-				return {
-					...result,
-					expression: { expression: result.expression.expression.attr(identifiers.register).call($(z).attr(identifiers.globalRegistry), $.object().pretty().prop("description", $.literal(schema.description))) }
-				};
-			}
-			return result;
+			const metadata = ctx$1.plugin.config.metadata;
+			if (!metadata) return result;
+			const node = $.object();
+			if (typeof metadata === "function") metadata({
+				$,
+				node,
+				schema
+			});
+			else if (schema.description) node.pretty().prop("description", $.literal(schema.description));
+			if (node.isEmpty) return result;
+			const z = ctx$1.plugin.external("zod.z");
+			return {
+				...result,
+				expression: { expression: result.expression.expression.attr(identifiers.register).call($(z).attr(identifiers.globalRegistry), node) }
+			};
 		},
 		reference($ref, schema, ctx$1) {
 			const z = ctx$1.plugin.external("zod.z");
@@ -13919,21 +14173,22 @@ const defineConfig = definePluginConfig(defaultConfig);
 //#endregion
 //#region src/plugins/config.ts
 const defaultPluginConfigs = {
-	"@angular/common": defaultConfig$23,
-	"@faker-js/faker": defaultConfig$22,
-	"@hey-api/client-angular": defaultConfig$21,
-	"@hey-api/client-axios": defaultConfig$20,
-	"@hey-api/client-fetch": defaultConfig$19,
-	"@hey-api/client-ky": defaultConfig$18,
-	"@hey-api/client-next": defaultConfig$17,
-	"@hey-api/client-nuxt": defaultConfig$16,
-	"@hey-api/client-ofetch": defaultConfig$15,
-	"@hey-api/schemas": defaultConfig$14,
-	"@hey-api/sdk": defaultConfig$13,
-	"@hey-api/transformers": defaultConfig$12,
-	"@hey-api/typescript": defaultConfig$11,
-	"@pinia/colada": defaultConfig$10,
-	"@tanstack/angular-query-experimental": defaultConfig$9,
+	"@angular/common": defaultConfig$24,
+	"@faker-js/faker": defaultConfig$23,
+	"@hey-api/client-angular": defaultConfig$22,
+	"@hey-api/client-axios": defaultConfig$21,
+	"@hey-api/client-fetch": defaultConfig$20,
+	"@hey-api/client-ky": defaultConfig$19,
+	"@hey-api/client-next": defaultConfig$18,
+	"@hey-api/client-nuxt": defaultConfig$17,
+	"@hey-api/client-ofetch": defaultConfig$16,
+	"@hey-api/schemas": defaultConfig$15,
+	"@hey-api/sdk": defaultConfig$14,
+	"@hey-api/transformers": defaultConfig$13,
+	"@hey-api/typescript": defaultConfig$12,
+	"@pinia/colada": defaultConfig$11,
+	"@tanstack/angular-query-experimental": defaultConfig$10,
+	"@tanstack/preact-query": defaultConfig$9,
 	"@tanstack/react-query": defaultConfig$8,
 	"@tanstack/solid-query": defaultConfig$7,
 	"@tanstack/svelte-query": defaultConfig$6,
@@ -13977,12 +14232,12 @@ function getPluginsConfig({ dependencies, userPlugins, userPluginsConfig }) {
 				pluginByTag: (tag, props = {}) => {
 					const { defaultPlugin: defaultPlugin$1, errorMessage } = props;
 					for (const userPlugin$1 of userPlugins) {
-						const defaultConfig$24 = defaultPluginConfigs[userPlugin$1] || userPluginsConfig[userPlugin$1];
-						if (defaultConfig$24 && defaultConfig$24.tags?.includes(tag) && userPlugin$1 !== name) return userPlugin$1;
+						const defaultConfig$25 = defaultPluginConfigs[userPlugin$1] || userPluginsConfig[userPlugin$1];
+						if (defaultConfig$25 && defaultConfig$25.tags?.includes(tag) && userPlugin$1 !== name) return userPlugin$1;
 					}
 					if (defaultPlugin$1) {
-						const defaultConfig$24 = defaultPluginConfigs[defaultPlugin$1] || userPluginsConfig[defaultPlugin$1];
-						if (defaultConfig$24 && defaultConfig$24.tags?.includes(tag) && defaultPlugin$1 !== name) return defaultPlugin$1;
+						const defaultConfig$25 = defaultPluginConfigs[defaultPlugin$1] || userPluginsConfig[defaultPlugin$1];
+						if (defaultConfig$25 && defaultConfig$25.tags?.includes(tag) && defaultPlugin$1 !== name) return defaultPlugin$1;
 					}
 					throw new Error(errorMessage || `missing plugin - no plugin with tag "${tag}" found`);
 				},
@@ -14124,4 +14379,4 @@ async function resolveJobs({ logger, userConfigs }) {
 
 //#endregion
 export { postProcessors as _, clientDefaultConfig as a, TypeScriptRenderer as c, reserved as d, keywords as f, getTypedConfig as g, getClientPlugin as h, generateClientBundle as i, TsDslContext as l, TsDsl as m, defaultPlugins as n, clientDefaultMeta as o, regexp as p, clientPluginHandler as r, $ as s, resolveJobs as t, ctx as u };
-//# sourceMappingURL=init-CuDouDN2.mjs.map
+//# sourceMappingURL=init-PHWYaLgi.mjs.map