@kubb/ast 5.0.0-alpha.31 → 5.0.0-alpha.33

package/dist/index.js

@@ -1,9 +1,30 @@
 import "./chunk--u3MIqq1.js";
+import { createHash } from "node:crypto";
+import path from "node:path";
 //#region src/constants.ts
 const visitorDepths = {
 	shallow: "shallow",
 	deep: "deep"
 };
+const nodeKinds = {
+	input: "Input",
+	output: "Output",
+	operation: "Operation",
+	schema: "Schema",
+	property: "Property",
+	parameter: "Parameter",
+	response: "Response",
+	functionParameter: "FunctionParameter",
+	parameterGroup: "ParameterGroup",
+	functionParameters: "FunctionParameters",
+	type: "Type",
+	file: "File",
+	import: "Import",
+	export: "Export",
+	source: "Source",
+	text: "Text",
+	break: "Break"
+};
 /**
 * Canonical schema type strings used by AST schema nodes.
 *
@@ -91,1302 +112,1809 @@ const mediaTypes = {
 	videoMp4: "video/mp4"
 };
 //#endregion
-//#region src/factory.ts
+//#region ../../internals/utils/src/casing.ts
 /**
-* Syncs property/parameter schema optionality flags from `required` and `schema.nullable`.
+* Shared implementation for camelCase and PascalCase conversion.
+* Splits on common word boundaries (spaces, hyphens, underscores, dots, slashes, colons)
+* and capitalizes each word according to `pascal`.
 *
-* - `optional` is set for non-required, non-nullable schemas.
-* - `nullish` is set for non-required, nullable schemas.
+* When `pascal` is `true` the first word is also capitalized (PascalCase), otherwise only subsequent words are.
 */
-function syncOptionality(schema, required) {
-	const nullable = schema.nullable ?? false;
-	return {
-		...schema,
-		optional: !required && !nullable ? true : void 0,
-		nullish: !required && nullable ? true : void 0
-	};
+function toCamelOrPascal(text, pascal) {
+	return text.trim().replace(/([a-z\d])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/(\d)([a-z])/g, "$1 $2").split(/[\s\-_./\\:]+/).filter(Boolean).map((word, i) => {
+		if (word.length > 1 && word === word.toUpperCase()) return word;
+		if (i === 0 && !pascal) return word.charAt(0).toLowerCase() + word.slice(1);
+		return word.charAt(0).toUpperCase() + word.slice(1);
+	}).join("").replace(/[^a-zA-Z0-9]/g, "");
 }
 /**
-* Creates a `RootNode` with stable defaults for `schemas` and `operations`.
-*
-* @example
-* ```ts
-* const root = createRoot()
-* // { kind: 'Root', schemas: [], operations: [] }
-* ```
+* Splits `text` on `.` and applies `transformPart` to each segment.
+* The last segment receives `isLast = true`, all earlier segments receive `false`.
+* Segments are joined with `/` to form a file path.
 *
-* @example
-* ```ts
-* const root = createRoot({ schemas: [petSchema] })
-* // keeps default operations: []
-* ```
+* Only splits on dots followed by a letter so that version numbers
+* embedded in operationIds (e.g. `v2025.0`) are kept intact.
 */
-function createRoot(overrides = {}) {
-	return {
-		schemas: [],
-		operations: [],
-		...overrides,
-		kind: "Root"
-	};
+function applyToFileParts(text, transformPart) {
+	const parts = text.split(/\.(?=[a-zA-Z])/);
+	return parts.map((part, i) => transformPart(part, i === parts.length - 1)).join("/");
 }
 /**
-* Creates an `OperationNode` with default empty arrays for `tags`, `parameters`, and `responses`.
+* Converts `text` to camelCase.
+* When `isFile` is `true`, dot-separated segments are each cased independently and joined with `/`.
 *
 * @example
-* ```ts
-* const operation = createOperation({
-*   operationId: 'getPetById',
-*   method: 'GET',
-*   path: '/pet/{petId}',
-* })
-* // tags, parameters, and responses are []
-* ```
+* camelCase('hello-world')                   // 'helloWorld'
+* camelCase('pet.petId', { isFile: true })   // 'pet/petId'
+*/
+function camelCase(text, { isFile, prefix = "", suffix = "" } = {}) {
+	if (isFile) return applyToFileParts(text, (part, isLast) => camelCase(part, isLast ? {
+		prefix,
+		suffix
+	} : {}));
+	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, false);
+}
+/**
+* Converts `text` to PascalCase.
+* When `isFile` is `true`, the last dot-separated segment is PascalCased and earlier segments are camelCased.
 *
 * @example
-* ```ts
-* const operation = createOperation({
-*   operationId: 'findPets',
-*   method: 'GET',
-*   path: '/pet/findByStatus',
-*   tags: ['pet'],
-* })
-* ```
+* pascalCase('hello-world')                  // 'HelloWorld'
+* pascalCase('pet.petId', { isFile: true })  // 'pet/PetId'
 */
-function createOperation(props) {
-	return {
-		tags: [],
-		parameters: [],
-		responses: [],
-		...props,
-		kind: "Operation"
-	};
+function pascalCase(text, { isFile, prefix = "", suffix = "" } = {}) {
+	if (isFile) return applyToFileParts(text, (part, isLast) => isLast ? pascalCase(part, {
+		prefix,
+		suffix
+	}) : camelCase(part));
+	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, true);
 }
+//#endregion
+//#region ../../internals/utils/src/string.ts
 /**
-* Maps schema `type` to its underlying `primitive`.
-* Primitive types map to themselves; special string formats map to `'string'`.
-* Complex types (`ref`, `enum`, `union`, `intersection`, `tuple`, `blob`) are left unset.
+* Strips the file extension from a path or file name.
+* Only removes the last `.ext` segment when the dot is not part of a directory name.
+*
+* @example
+* trimExtName('petStore.ts')             // 'petStore'
+* trimExtName('/src/models/pet.ts')      // '/src/models/pet'
+* trimExtName('/project.v2/gen/pet.ts')  // '/project.v2/gen/pet'
+* trimExtName('noExtension')             // 'noExtension'
 */
-const TYPE_TO_PRIMITIVE = {
-	string: "string",
-	number: "number",
-	integer: "integer",
-	bigint: "bigint",
-	boolean: "boolean",
-	null: "null",
-	any: "any",
-	unknown: "unknown",
-	void: "void",
-	never: "never",
-	object: "object",
-	array: "array",
-	date: "date",
-	uuid: "string",
-	email: "string",
-	url: "string",
-	datetime: "string",
-	time: "string"
-};
-function createSchema(props) {
-	const inferredPrimitive = TYPE_TO_PRIMITIVE[props.type];
-	if (props["type"] === "object") return {
-		properties: [],
-		primitive: "object",
-		...props,
-		kind: "Schema"
-	};
-	return {
-		primitive: inferredPrimitive,
-		...props,
-		kind: "Schema"
-	};
+function trimExtName(text) {
+	const dotIndex = text.lastIndexOf(".");
+	if (dotIndex > 0 && !text.includes("/", dotIndex)) return text.slice(0, dotIndex);
+	return text;
 }
+//#endregion
+//#region ../../internals/utils/src/reserved.ts
 /**
-* Creates a `PropertyNode`.
-*
-* `required` defaults to `false`.
-* `schema.optional` and `schema.nullish` are derived from `required` and `schema.nullable`.
+* Returns `true` when `name` is a syntactically valid JavaScript variable name.
 *
 * @example
 * ```ts
-* const property = createProperty({
-*   name: 'status',
-*   schema: createSchema({ type: 'string' }),
-* })
-* // required=false, schema.optional=true
+* isValidVarName('status')  // true
+* isValidVarName('class')   // false (reserved word)
+* isValidVarName('42foo')   // false (starts with digit)
 * ```
+*/
+function isValidVarName(name) {
+	try {
+		new Function(`var ${name}`);
+	} catch {
+		return false;
+	}
+	return true;
+}
+//#endregion
+//#region src/guards.ts
+/**
+* Narrows a `SchemaNode` to the variant that matches `type`.
 *
 * @example
 * ```ts
-* const property = createProperty({
-*   name: 'status',
-*   required: true,
-*   schema: createSchema({ type: 'string', nullable: true }),
-* })
-* // required=true, no optional/nullish
+* const schema = createSchema({ type: 'string' })
+* const stringNode = narrowSchema(schema, 'string') // StringSchemaNode | undefined
 * ```
 */
-function createProperty(props) {
-	const required = props.required ?? false;
-	return {
-		...props,
-		kind: "Property",
-		required,
-		schema: syncOptionality(props.schema, required)
-	};
+function narrowSchema(node, type) {
+	return node?.type === type ? node : void 0;
+}
+function isKind(kind) {
+	return (node) => node.kind === kind;
 }
 /**
-* Creates a `ParameterNode`.
-*
-* `required` defaults to `false`.
-* Nested schema flags are set from `required` and `schema.nullable`.
+* Returns `true` when the input is an `InputNode`.
 *
 * @example
 * ```ts
-* const param = createParameter({
-*   name: 'petId',
-*   in: 'path',
-*   required: true,
-*   schema: createSchema({ type: 'string' }),
-* })
+* if (isInputNode(node)) {
+*   console.log(node.schemas.length)
+* }
 * ```
+*/
+const isInputNode = isKind("Input");
+/**
+* Returns `true` when the input is an `OutputNode`.
 *
 * @example
 * ```ts
-* const param = createParameter({
-*   name: 'status',
-*   in: 'query',
-*   schema: createSchema({ type: 'string', nullable: true }),
-* })
-* // required=false, schema.nullish=true
+* if (isOutputNode(node)) {
+*   console.log(node.files.length)
+* }
 * ```
 */
-function createParameter(props) {
-	const required = props.required ?? false;
-	return {
-		...props,
-		kind: "Parameter",
-		required,
-		schema: syncOptionality(props.schema, required)
-	};
-}
+const isOutputNode = isKind("Output");
 /**
-* Creates a `ResponseNode`.
+* Returns `true` when the input is an `OperationNode`.
 *
 * @example
 * ```ts
-* const response = createResponse({
-*   statusCode: '200',
-*   description: 'Success',
-*   schema: createSchema({ type: 'object', properties: [] }),
-* })
+* if (isOperationNode(node)) {
+*   console.log(node.operationId)
+* }
 * ```
 */
-function createResponse(props) {
-	return {
-		...props,
-		kind: "Response"
-	};
-}
+const isOperationNode = isKind("Operation");
 /**
-* Creates a `FunctionParameterNode`.
-*
-* `optional` defaults to `false`.
-*
-* @example Required typed param
-* ```ts
-* createFunctionParameter({ name: 'petId', type: createTypeNode({ variant: 'reference', name: 'string' }) })
-* // → petId: string
-* ```
-*
-* @example Optional param
-* ```ts
-* createFunctionParameter({ name: 'params', type: createTypeNode({ variant: 'reference', name: 'QueryParams' }), optional: true })
-* // → params?: QueryParams
-* ```
+* Returns `true` when the input is a `SchemaNode`.
 *
-* @example Param with default (implicitly optional; cannot combine with `optional: true`)
+* @example
 * ```ts
-* createFunctionParameter({ name: 'config', type: createTypeNode({ variant: 'reference', name: 'RequestConfig' }), default: '{}' })
-* // → config: RequestConfig = {}
+* if (isSchemaNode(node)) {
+*   console.log(node.type)
+* }
 * ```
 */
-function createFunctionParameter(props) {
-	return {
-		optional: false,
-		...props,
-		kind: "FunctionParameter"
-	};
-}
-/**
-* Creates a {@link TypeNode} representing a language-agnostic structured type expression.
-*
-* Use `variant: 'struct'` for inline anonymous types and `variant: 'member'` for a single
-* named field accessed from a group type. Each language's printer renders the variant
-* into its own syntax (TypeScript, Python, C#, Kotlin, …).
-*
-* @example Reference type (TypeScript: `QueryParams`)
-* ```ts
-* createTypeNode({ variant: 'reference', name: 'QueryParams' })
-* ```
+const isSchemaNode = isKind("Schema");
+isKind("Property");
+isKind("Parameter");
+isKind("Response");
+isKind("FunctionParameter");
+isKind("ParameterGroup");
+isKind("FunctionParameters");
+//#endregion
+//#region src/utils.ts
+const plainStringTypes = new Set([
+	"string",
+	"uuid",
+	"email",
+	"url",
+	"datetime"
+]);
+/**
+* Returns a merged schema view for a ref node, combining the resolved `node.schema`
+* (base from the referenced definition) with any usage-site sibling fields set directly
+* on the ref node (description, readOnly, nullable, deprecated, etc.).
 *
-* @example Struct type (TypeScript: `{ petId: string }`)
-* ```ts
-* createTypeNode({ variant: 'struct', properties: [{ name: 'petId', optional: false, type: createTypeNode({ variant: 'reference', name: 'string' }) }] })
-* ```
+* Usage-site fields take precedence over the resolved schema's own fields when both are defined.
 *
-* @example Member type (TypeScript: `DeletePetPathParams['petId']`)
-* ```ts
-* createTypeNode({ variant: 'member', base: 'DeletePetPathParams', key: 'petId' })
-* ```
+* For non-ref nodes the node itself is returned unchanged.
 */
-function createTypeNode(props) {
-	return {
-		...props,
-		kind: "Type"
-	};
+function syncSchemaRef(node) {
+	const ref = narrowSchema(node, "ref");
+	if (!ref) return node;
+	if (!ref.schema) return node;
+	const { kind: _kind, type: _type, name: _name, ref: _ref, schema: _schema, ...overrides } = ref;
+	const definedOverrides = Object.fromEntries(Object.entries(overrides).filter(([, v]) => v !== void 0));
+	return createSchema({
+		...ref.schema,
+		...definedOverrides
+	});
 }
 /**
-* Creates a `ParameterGroupNode` representing a group of related parameters treated as a unit.
+* Returns `true` when a schema is emitted as a plain `string` type.
 *
-* @example Grouped param (TypeScript declaration)
-* ```ts
-* createParameterGroup({
-*   properties: [
-*     createFunctionParameter({ name: 'id', type: createTypeNode({ variant: 'reference', name: 'string' }), optional: false }),
-*     createFunctionParameter({ name: 'name', type: createTypeNode({ variant: 'reference', name: 'string' }), optional: true }),
-*   ],
-*   default: '{}',
-* })
-* // declaration → { id, name? }: { id: string; name?: string } = {}
-* // call        → { id, name }
-* ```
+* - `string`, `uuid`, `email`, `url`, `datetime` are always plain strings.
+* - `date` and `time` are plain strings when their `representation` is `'string'` rather than `'date'`.
 *
-* @example Inline (spread) — children emitted as individual top-level parameters
+* @example
 * ```ts
-* createParameterGroup({
-*   properties: [createFunctionParameter({ name: 'petId', type: createTypeNode({ variant: 'reference', name: 'string' }), optional: false })],
-*   inline: true,
-* })
-* // declaration → petId: string
-* // call        → petId
+* isStringType(createSchema({ type: 'uuid' }))                          // true
+* isStringType(createSchema({ type: 'date', representation: 'date' }))  // false
 * ```
 */
-function createParameterGroup(props) {
-	return {
-		...props,
-		kind: "ParameterGroup"
-	};
+function isStringType(node) {
+	if (plainStringTypes.has(node.type)) return true;
+	const temporal = narrowSchema(node, "date") ?? narrowSchema(node, "time");
+	if (temporal) return temporal.representation !== "date";
+	return false;
 }
 /**
-* Creates a `FunctionParametersNode` from an ordered list of parameters.
+* Applies casing rules to parameter names and returns a new parameter array.
 *
-* @example
-* ```ts
-* createFunctionParameters({
-*   params: [
-*     createFunctionParameter({ name: 'petId', type: createTypeNode({ variant: 'reference', name: 'string' }), optional: false }),
-*     createFunctionParameter({ name: 'config', type: createTypeNode({ variant: 'reference', name: 'RequestConfig' }), optional: false, default: '{}' }),
-*   ],
-* })
-* ```
+* The input array is not mutated.
+* If `casing` is not set, the original array is returned unchanged.
+*
+* Use this before passing parameters to schema builders so that property keys
+* in generated output match the desired casing while preserving
+* `OperationNode.parameters` for other consumers.
 *
 * @example
 * ```ts
-* const empty = createFunctionParameters()
-* // { kind: 'FunctionParameters', params: [] }
+* const params = [createParameter({ name: 'pet_id', in: 'query', schema: createSchema({ type: 'string' }) })]
+* const cased = caseParams(params, 'camelcase')
+* // cased[0].name === 'petId'
 * ```
 */
-function createFunctionParameters(props = {}) {
-	return {
-		params: [],
-		...props,
-		kind: "FunctionParameters"
-	};
+function caseParams(params, casing) {
+	if (!casing) return params;
+	return params.map((param) => {
+		const transformed = casing === "camelcase" || !isValidVarName(param.name) ? camelCase(param.name) : param.name;
+		return {
+			...param,
+			name: transformed
+		};
+	});
 }
-//#endregion
-//#region src/guards.ts
 /**
-* Narrows a `SchemaNode` to the variant that matches `type`.
+* Creates a single-property object schema used as a discriminator literal.
 *
 * @example
 * ```ts
-* const schema = createSchema({ type: 'string' })
-* const stringNode = narrowSchema(schema, 'string') // StringSchemaNode | undefined
+* createDiscriminantNode({ propertyName: 'type', value: 'dog' })
+* // -> { type: 'object', properties: [{ name: 'type', required: true, schema: enum('dog') }] }
 * ```
 */
-function narrowSchema(node, type) {
-	return node?.type === type ? node : void 0;
+function createDiscriminantNode({ propertyName, value }) {
+	return createSchema({
+		type: "object",
+		primitive: "object",
+		properties: [createProperty({
+			name: propertyName,
+			schema: createSchema({
+				type: "enum",
+				primitive: "string",
+				enumValues: [value]
+			}),
+			required: true
+		})]
+	});
 }
-function isKind(kind) {
-	return (node) => node.kind === kind;
+function resolveParamsType({ node, param, resolver }) {
+	if (!resolver) return createParamsType({
+		variant: "reference",
+		name: param.schema.primitive ?? "unknown"
+	});
+	const individualName = resolver.resolveParamName(node, param);
+	const groupLocation = param.in === "path" || param.in === "query" || param.in === "header" ? param.in : void 0;
+	const groupResolvers = {
+		path: resolver.resolvePathParamsName,
+		query: resolver.resolveQueryParamsName,
+		header: resolver.resolveHeaderParamsName
+	};
+	const groupName = groupLocation ? groupResolvers[groupLocation].call(resolver, node, param) : void 0;
+	if (groupName && groupName !== individualName) return createParamsType({
+		variant: "member",
+		base: groupName,
+		key: param.name
+	});
+	return createParamsType({
+		variant: "reference",
+		name: individualName
+	});
 }
-isKind("Root");
-/**
-* Returns `true` when the input is an `OperationNode`.
-*
-* @example
-* ```ts
-* if (isOperationNode(node)) {
-*   console.log(node.operationId)
-* }
-* ```
-*/
-const isOperationNode = isKind("Operation");
-/**
-* Returns `true` when the input is a `SchemaNode`.
-*
-* @example
-* ```ts
-* if (isSchemaNode(node)) {
-*   console.log(node.type)
-* }
-* ```
-*/
-const isSchemaNode = isKind("Schema");
-isKind("Property");
-isKind("Parameter");
-isKind("Response");
-isKind("FunctionParameter");
-isKind("ParameterGroup");
-isKind("FunctionParameters");
-//#endregion
-//#region src/printer.ts
 /**
-* Creates a schema printer factory.
-*
-* This function wraps a builder and makes options optional at call sites.
-*
-* The builder receives resolved options and returns:
-* - `name` — a unique identifier for the printer
-* - `options` — options stored on the returned printer instance
-* - `nodes` — a map of `SchemaType` → handler functions that convert a `SchemaNode` to `TOutput`
-* - `print` _(optional)_ — top-level override exposed as `printer.print`
-*   - Inside this function, use `this.transform(node)` to dispatch to the `nodes` map
-*   - This keeps recursion safe and avoids self-calls
-*
-* When no `print` override is provided, `printer.print` falls back to `printer.transform` (the node-level dispatcher).
+* Converts an {@link OperationNode} into a {@link FunctionParametersNode}.
 *
-* @example Basic usage — Zod schema printer
-* ```ts
-* type PrinterZod = PrinterFactoryOptions<'zod', { strict?: boolean }, string>
+* Centralizes the per-plugin `getParams()` pattern. Provide a `resolver` for
+* type resolution and `extraParams` for plugin-specific trailing parameters.
 *
-* export const zodPrinter = definePrinter<PrinterZod>((options) => ({
-*   name: 'zod',
-*   options: { strict: options.strict ?? true },
-*   nodes: {
-*     string: () => 'z.string()',
-*     object(node) {
-*       const props = node.properties.map(p => `${p.name}: ${this.transform(p.schema)}`).join(', ')
-*       return `z.object({ ${props} })`
-*     },
-*   },
-* }))
-* ```
-*/
-function definePrinter(build) {
-	return createPrinterFactory((node) => node.type)(build);
-}
-/**
-* Generic printer-factory function used by `definePrinter` and `defineFunctionPrinter`.
-**
 * @example
 * ```ts
-* export const defineFunctionPrinter = createPrinterFactory<FunctionNode, FunctionNodeType, FunctionNodeByType>(
-*   (node) => kindToHandlerKey[node.kind],
-* )
+* const params = createOperationParams(node, {
+*   paramsType: 'inline',
+*   pathParamsType: 'inline',
+*   resolver: tsResolver,
+*   extraParams: [createFunctionParameter({ name: 'options', type: createParamsType({ variant: 'reference', name: 'Partial<RequestOptions>' }), default: '{}' })],
+* })
 * ```
 */
-function createPrinterFactory(getKey) {
-	return function(build) {
-		return (options) => {
-			const { name, options: resolvedOptions, nodes, print: printOverride } = build(options ?? {});
-			const context = {
-				options: resolvedOptions,
-				transform: (node) => {
-					const key = getKey(node);
-					if (key === void 0) return null;
-					const handler = nodes[key];
-					if (!handler) return null;
-					return handler.call(context, node);
-				}
-			};
-			return {
-				name,
-				options: resolvedOptions,
-				transform: context.transform,
-				print: printOverride ? printOverride.bind(context) : context.transform
-			};
-		};
-	};
+function createOperationParams(node, options) {
+	const { paramsType, pathParamsType, paramsCasing, resolver, pathParamsDefault, extraParams = [], paramNames, typeWrapper } = options;
+	const dataName = paramNames?.data ?? "data";
+	const paramsName = paramNames?.params ?? "params";
+	const headersName = paramNames?.headers ?? "headers";
+	const pathName = paramNames?.path ?? "pathParams";
+	const wrapType = (type) => createParamsType({
+		variant: "reference",
+		name: typeWrapper ? typeWrapper(type) : type
+	});
+	const wrapTypeNode = (type) => type.kind === "ParamsType" && type.variant === "reference" ? wrapType(type.name) : type;
+	const casedParams = caseParams(node.parameters, paramsCasing);
+	const pathParams = casedParams.filter((p) => p.in === "path");
+	const queryParams = casedParams.filter((p) => p.in === "query");
+	const headerParams = casedParams.filter((p) => p.in === "header");
+	const bodyType = node.requestBody?.schema ? wrapType(resolver?.resolveDataName(node) ?? "unknown") : void 0;
+	const bodyRequired = node.requestBody?.required ?? false;
+	const queryGroupType = resolver ? resolveGroupType({
+		node,
+		params: queryParams,
+		groupMethod: resolver.resolveQueryParamsName,
+		resolver
+	}) : void 0;
+	const headerGroupType = resolver ? resolveGroupType({
+		node,
+		params: headerParams,
+		groupMethod: resolver.resolveHeaderParamsName,
+		resolver
+	}) : void 0;
+	const params = [];
+	if (paramsType === "object") {
+		const children = [
+			...pathParams.map((p) => {
+				const type = resolveParamsType({
+					node,
+					param: p,
+					resolver
+				});
+				return createFunctionParameter({
+					name: p.name,
+					type: wrapTypeNode(type),
+					optional: !p.required
+				});
+			}),
+			...bodyType ? [createFunctionParameter({
+				name: dataName,
+				type: bodyType,
+				optional: !bodyRequired
+			})] : [],
+			...buildGroupParam({
+				name: paramsName,
+				node,
+				params: queryParams,
+				groupType: queryGroupType,
+				resolver,
+				wrapType
+			}),
+			...buildGroupParam({
+				name: headersName,
+				node,
+				params: headerParams,
+				groupType: headerGroupType,
+				resolver,
+				wrapType
+			})
+		];
+		if (children.length) params.push(createParameterGroup({
+			properties: children,
+			default: children.every((c) => c.optional) ? "{}" : void 0
+		}));
+	} else {
+		if (pathParams.length) if (pathParamsType === "inlineSpread") {
+			const spreadType = resolver?.resolvePathParamsName(node, pathParams[0]) ?? void 0;
+			params.push(createFunctionParameter({
+				name: pathName,
+				type: spreadType ? wrapType(spreadType) : void 0,
+				rest: true
+			}));
+		} else {
+			const pathChildren = pathParams.map((p) => {
+				const type = resolveParamsType({
+					node,
+					param: p,
+					resolver
+				});
+				return createFunctionParameter({
+					name: p.name,
+					type: wrapTypeNode(type),
+					optional: !p.required
+				});
+			});
+			params.push(createParameterGroup({
+				properties: pathChildren,
+				inline: pathParamsType === "inline",
+				default: pathParamsDefault ?? (pathChildren.every((c) => c.optional) ? "{}" : void 0)
+			}));
+		}
+		if (bodyType) params.push(createFunctionParameter({
+			name: dataName,
+			type: bodyType,
+			optional: !bodyRequired
+		}));
+		params.push(...buildGroupParam({
+			name: paramsName,
+			node,
+			params: queryParams,
+			groupType: queryGroupType,
+			resolver,
+			wrapType
+		}));
+		params.push(...buildGroupParam({
+			name: headersName,
+			node,
+			params: headerParams,
+			groupType: headerGroupType,
+			resolver,
+			wrapType
+		}));
+	}
+	params.push(...extraParams);
+	return createFunctionParameters({ params });
 }
-//#endregion
-//#region src/refs.ts
 /**
-* Returns the last path segment of a reference string.
-*
-* Example: `#/components/schemas/Pet` becomes `Pet`.
+* Builds a single {@link FunctionParameterNode} for a query or header group.
+* Returns an empty array when there are no params to emit.
 *
-* @example
-* ```ts
-* extractRefName('#/components/schemas/Pet') // 'Pet'
-* ```
+* If a pre-resolved `groupType` is provided it emits `name: GroupType`.
+* Otherwise, it builds an inline struct from the individual params.
 */
-function extractRefName(ref) {
-	return ref.split("/").at(-1) ?? ref;
+function buildGroupParam({ name, node, params, groupType, resolver, wrapType }) {
+	if (groupType) return [createFunctionParameter({
+		name,
+		type: groupType.type.kind === "ParamsType" && groupType.type.variant === "reference" ? wrapType(groupType.type.name) : groupType.type,
+		optional: groupType.optional
+	})];
+	if (params.length) return [createFunctionParameter({
+		name,
+		type: toStructType({
+			node,
+			params,
+			resolver
+		}),
+		optional: params.every((p) => !p.required)
+	})];
+	return [];
 }
-//#endregion
-//#region ../../internals/utils/src/casing.ts
 /**
-* Shared implementation for camelCase and PascalCase conversion.
-* Splits on common word boundaries (spaces, hyphens, underscores, dots, slashes, colons)
-* and capitalizes each word according to `pascal`.
-*
-* When `pascal` is `true` the first word is also capitalized (PascalCase), otherwise only subsequent words are.
+* Derives a {@link ParamGroupType} from the resolver's group method.
+* Returns `undefined` when the group name equals the individual param name (no real group).
 */
-function toCamelOrPascal(text, pascal) {
-	return text.trim().replace(/([a-z\d])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/(\d)([a-z])/g, "$1 $2").split(/[\s\-_./\\:]+/).filter(Boolean).map((word, i) => {
-		if (word.length > 1 && word === word.toUpperCase()) return word;
-		if (i === 0 && !pascal) return word.charAt(0).toLowerCase() + word.slice(1);
-		return word.charAt(0).toUpperCase() + word.slice(1);
-	}).join("").replace(/[^a-zA-Z0-9]/g, "");
+function resolveGroupType({ node, params, groupMethod, resolver }) {
+	if (!params.length) return;
+	const firstParam = params[0];
+	const groupName = groupMethod.call(resolver, node, firstParam);
+	if (groupName === resolver.resolveParamName(node, firstParam)) return;
+	const allOptional = params.every((p) => !p.required);
+	return {
+		type: createParamsType({
+			variant: "reference",
+			name: groupName
+		}),
+		optional: allOptional
+	};
 }
 /**
-* Splits `text` on `.` and applies `transformPart` to each segment.
-* The last segment receives `isLast = true`, all earlier segments receive `false`.
-* Segments are joined with `/` to form a file path.
+* Builds a {@link TypeNode} with `variant: 'struct'` for an inline anonymous type grouping named fields.
 *
-* Only splits on dots followed by a letter so that version numbers
-* embedded in operationIds (e.g. `v2025.0`) are kept intact.
+* Used when query or header parameters have no dedicated group type name.
+* Each language printer renders this appropriately (TypeScript: `{ petId: string; name?: string }`).
 */
-function applyToFileParts(text, transformPart) {
-	const parts = text.split(/\.(?=[a-zA-Z])/);
-	return parts.map((part, i) => transformPart(part, i === parts.length - 1)).join("/");
+function toStructType({ node, params, resolver }) {
+	return createParamsType({
+		variant: "struct",
+		properties: params.map((p) => ({
+			name: p.name,
+			optional: !p.required,
+			type: resolveParamsType({
+				node,
+				param: p,
+				resolver
+			})
+		}))
+	});
+}
+function sourceKey(source) {
+	return `${source.name ?? extractStringsFromNodes(source.nodes)}:${source.isExportable ?? false}:${source.isTypeOnly ?? false}`;
+}
+function pathTypeKey(path, isTypeOnly) {
+	return `${path}:${isTypeOnly ?? false}`;
+}
+function exportKey(path, name, isTypeOnly, asAlias) {
+	return `${path}:${name ?? ""}:${isTypeOnly ?? false}:${asAlias ?? ""}`;
+}
+function importKey(path, name, isTypeOnly) {
+	return `${path}:${name ?? ""}:${isTypeOnly ?? false}`;
 }
 /**
-* Converts `text` to camelCase.
-* When `isFile` is `true`, dot-separated segments are each cased independently and joined with `/`.
-*
-* @example
-* camelCase('hello-world')                   // 'helloWorld'
-* camelCase('pet.petId', { isFile: true })   // 'pet/petId'
+* Computes a multi-level sort key for exports and imports:
+* non-array names first (wildcards/namespace aliases); type-only before value; alphabetical path; unnamed before named.
 */
-function camelCase(text, { isFile, prefix = "", suffix = "" } = {}) {
-	if (isFile) return applyToFileParts(text, (part, isLast) => camelCase(part, isLast ? {
-		prefix,
-		suffix
-	} : {}));
-	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, false);
+function sortKey(node) {
+	const isArray = Array.isArray(node.name) ? "1" : "0";
+	const typeOnly = node.isTypeOnly ? "0" : "1";
+	const hasName = node.name != null ? "1" : "0";
+	const name = Array.isArray(node.name) ? [...node.name].sort().join("\0") : node.name ?? "";
+	return `${isArray}:${typeOnly}:${node.path}:${hasName}:${name}`;
 }
 /**
-* Converts `text` to PascalCase.
-* When `isFile` is `true`, the last dot-separated segment is PascalCased and earlier segments are camelCased.
-*
-* @example
-* pascalCase('hello-world')                  // 'HelloWorld'
-* pascalCase('pet.petId', { isFile: true })  // 'pet/PetId'
+* Deduplicates an array of `SourceNode` objects.
+* Named sources are deduplicated by `name + isExportable + isTypeOnly`.
+* Unnamed sources are deduplicated by object reference.
 */
-function pascalCase(text, { isFile, prefix = "", suffix = "" } = {}) {
-	if (isFile) return applyToFileParts(text, (part, isLast) => isLast ? pascalCase(part, {
-		prefix,
-		suffix
-	}) : camelCase(part));
-	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, true);
+function combineSources(sources) {
+	const seen = /* @__PURE__ */ new Map();
+	for (const source of sources) {
+		const key = sourceKey(source);
+		if (!seen.has(key)) seen.set(key, source);
+	}
+	return [...seen.values()];
 }
-//#endregion
-//#region ../../internals/utils/src/reserved.ts
 /**
-* Returns `true` when `name` is a syntactically valid JavaScript variable name.
-*
-* @example
-* ```ts
-* isValidVarName('status')  // true
-* isValidVarName('class')   // false (reserved word)
-* isValidVarName('42foo')   // false (starts with digit)
-* ```
+* Deduplicates and merges an array of `ExportNode` objects.
+* Exports with the same path and `isTypeOnly` flag have their names merged.
 */
-function isValidVarName(name) {
-	try {
-		new Function(`var ${name}`);
-	} catch {
-		return false;
+function combineExports(exports) {
+	const result = [];
+	const namedByPath = /* @__PURE__ */ new Map();
+	const seen = /* @__PURE__ */ new Set();
+	for (const curr of [...exports].sort((a, b) => {
+		const ka = sortKey(a);
+		const kb = sortKey(b);
+		return ka < kb ? -1 : ka > kb ? 1 : 0;
+	})) {
+		const { name, path, isTypeOnly, asAlias } = curr;
+		if (Array.isArray(name)) {
+			if (!name.length) continue;
+			const key = pathTypeKey(path, isTypeOnly);
+			const existing = namedByPath.get(key);
+			if (existing && Array.isArray(existing.name)) existing.name = [...new Set([...existing.name, ...name])];
+			else {
+				const newItem = {
+					...curr,
+					name: [...new Set(name)]
+				};
+				result.push(newItem);
+				namedByPath.set(key, newItem);
+			}
+		} else {
+			const key = exportKey(path, name, isTypeOnly, asAlias);
+			if (!seen.has(key)) {
+				result.push(curr);
+				seen.add(key);
+			}
+		}
 	}
-	return true;
+	return result;
 }
-//#endregion
-//#region src/visitor.ts
 /**
-* Creates a small async concurrency limiter.
-*
-* At most `concurrency` tasks are in flight at once. Extra tasks are queued.
-*
-* @example
-* ```ts
-* const limit = createLimit(2)
-* for (const task of [taskA, taskB, taskC]) {
-*   await limit(() => task())
-* }
-* // only 2 tasks run at the same time
-* ```
+* Deduplicates and merges an array of `ImportNode` objects.
+* Filters out unused imports (names not referenced in `source` or re-exported).
+* Imports with the same path and `isTypeOnly` flag have their names merged.
 */
-function createLimit(concurrency) {
-	let active = 0;
-	const queue = [];
-	function next() {
-		if (active < concurrency && queue.length > 0) {
-			active++;
-			queue.shift()();
+function combineImports(imports, exports, source) {
+	const exportedNames = new Set(exports.flatMap((e) => Array.isArray(e.name) ? e.name : e.name ? [e.name] : []));
+	const isUsed = (importName) => !source || source.includes(importName) || exportedNames.has(importName);
+	const result = [];
+	const namedByPath = /* @__PURE__ */ new Map();
+	const seen = /* @__PURE__ */ new Set();
+	for (const curr of [...imports].sort((a, b) => {
+		const ka = sortKey(a);
+		const kb = sortKey(b);
+		return ka < kb ? -1 : ka > kb ? 1 : 0;
+	})) {
+		if (curr.path === curr.root) continue;
+		const { path, isTypeOnly } = curr;
+		let { name } = curr;
+		if (Array.isArray(name)) {
+			name = [...new Set(name)].filter((item) => typeof item === "string" ? isUsed(item) : isUsed(item.propertyName));
+			if (!name.length) continue;
+			const key = pathTypeKey(path, isTypeOnly);
+			const existing = namedByPath.get(key);
+			if (existing && Array.isArray(existing.name)) existing.name = [...new Set([...existing.name, ...name])];
+			else {
+				const newItem = {
+					...curr,
+					name
+				};
+				result.push(newItem);
+				namedByPath.set(key, newItem);
+			}
+		} else {
+			if (name && !isUsed(name)) continue;
+			const key = importKey(path, name, isTypeOnly);
+			if (!seen.has(key)) {
+				result.push(curr);
+				seen.add(key);
+			}
 		}
 	}
-	return function limit(fn) {
-		return new Promise((resolve, reject) => {
-			queue.push(() => {
-				Promise.resolve(fn()).then(resolve, reject).finally(() => {
-					active--;
-					next();
-				});
-			});
-			next();
-		});
-	};
+	return result;
 }
 /**
-* Returns the immediate traversable children of `node`.
+* Recursively extracts all string content embedded in a {@link CodeNode} tree.
 *
-* For `Schema` nodes, children (`properties`, `items`, `members`, and non-boolean
-* `additionalProperties`) are only included
-* when `recurse` is `true`; shallow mode skips them.
+* Includes text node values, and string attribute fields (`params`, `generics`,
+* `returnType`, `type`) that may reference identifiers needing imports.
+* Used by `createFile` to build the full source string for import filtering.
+*/
+function extractStringsFromNodes(nodes) {
+	if (!nodes?.length) return "";
+	return nodes.map((node) => {
+		if (typeof node === "string") return node;
+		if (node.kind === "Text") return node.value;
+		if (node.kind === "Break") return "";
+		if (node.kind === "Jsx") return node.value;
+		const parts = [];
+		if ("params" in node && node.params) parts.push(node.params);
+		if ("generics" in node && node.generics) parts.push(Array.isArray(node.generics) ? node.generics.join(", ") : node.generics);
+		if ("returnType" in node && node.returnType) parts.push(node.returnType);
+		if ("type" in node && typeof node.type === "string") parts.push(node.type);
+		const nested = extractStringsFromNodes(node.nodes);
+		if (nested) parts.push(nested);
+		return parts.join("\n");
+	}).filter(Boolean).join("\n");
+}
+//#endregion
+//#region src/factory.ts
+/**
+* Syncs property/parameter schema optionality flags from `required` and `schema.nullable`.
 *
-* @example
-* ```ts
-* const children = getChildren(operationNode, true)
-* // returns parameters, requestBody schema (if present), and responses
-* ```
+* - `optional` is set for non-required, non-nullable schemas.
+* - `nullish` is set for non-required, nullable schemas.
 */
-function getChildren(node, recurse) {
-	switch (node.kind) {
-		case "Root": return [...node.schemas, ...node.operations];
-		case "Operation": return [
-			...node.parameters,
-			...node.requestBody?.schema ? [node.requestBody.schema] : [],
-			...node.responses
-		];
-		case "Schema": {
-			const children = [];
-			if (!recurse) return [];
-			if ("properties" in node && node.properties.length > 0) children.push(...node.properties);
-			if ("items" in node && node.items) children.push(...node.items);
-			if ("members" in node && node.members) children.push(...node.members);
-			if ("additionalProperties" in node && node.additionalProperties && node.additionalProperties !== true) children.push(node.additionalProperties);
-			return children;
-		}
-		case "Property": return [node.schema];
-		case "Parameter": return [node.schema];
-		case "Response": return node.schema ? [node.schema] : [];
-		case "FunctionParameter":
-		case "ParameterGroup":
-		case "FunctionParameters":
-		case "Type": return [];
-	}
+function syncOptionality(schema, required) {
+	const nullable = schema.nullable ?? false;
+	return {
+		...schema,
+		optional: !required && !nullable ? true : void 0,
+		nullish: !required && nullable ? true : void 0
+	};
 }
 /**
-* Depth-first traversal for side effects. Visitor return values are ignored.
-* Sibling nodes at each level are visited concurrently up to `options.concurrency`
-* (default: `WALK_CONCURRENCY`).
+* Creates an `InputNode` with stable defaults for `schemas` and `operations`.
 *
 * @example
 * ```ts
-* await walk(root, {
-*   operation(node) {
-*     console.log(node.operationId)
-*   },
-* })
+* const input = createInput()
+* // { kind: 'Input', schemas: [], operations: [] }
 * ```
 *
 * @example
 * ```ts
-* // Visit only the current node
-* await walk(root, { depth: 'shallow', root: () => {} })
+* const input = createInput({ schemas: [petSchema] })
+* // keeps default operations: []
 * ```
 */
-async function walk(node, options) {
-	return _walk(node, options, (options.depth ?? visitorDepths.deep) === visitorDepths.deep, createLimit(options.concurrency ?? 30), void 0);
-}
-async function _walk(node, visitor, recurse, limit, parent) {
-	switch (node.kind) {
-		case "Root":
-			await limit(() => visitor.root?.(node, { parent }));
-			break;
-		case "Operation":
-			await limit(() => visitor.operation?.(node, { parent }));
-			break;
-		case "Schema":
-			await limit(() => visitor.schema?.(node, { parent }));
-			break;
-		case "Property":
-			await limit(() => visitor.property?.(node, { parent }));
-			break;
-		case "Parameter":
-			await limit(() => visitor.parameter?.(node, { parent }));
-			break;
-		case "Response":
-			await limit(() => visitor.response?.(node, { parent }));
-			break;
-		case "FunctionParameter":
-		case "ParameterGroup":
-		case "FunctionParameters": break;
-	}
-	const children = getChildren(node, recurse);
-	for (const child of children) await _walk(child, visitor, recurse, limit, node);
-}
-function transform(node, options) {
-	const { depth, parent, ...visitor } = options;
-	const recurse = (depth ?? visitorDepths.deep) === visitorDepths.deep;
-	switch (node.kind) {
-		case "Root": {
-			let root = node;
-			const replaced = visitor.root?.(root, { parent });
-			if (replaced) root = replaced;
-			return {
-				...root,
-				schemas: root.schemas.map((s) => transform(s, {
-					...options,
-					parent: root
-				})),
-				operations: root.operations.map((op) => transform(op, {
-					...options,
-					parent: root
-				}))
-			};
-		}
-		case "Operation": {
-			let op = node;
-			const replaced = visitor.operation?.(op, { parent });
-			if (replaced) op = replaced;
-			return {
-				...op,
-				parameters: op.parameters.map((p) => transform(p, {
-					...options,
-					parent: op
-				})),
-				requestBody: op.requestBody ? {
-					...op.requestBody,
-					schema: op.requestBody.schema ? transform(op.requestBody.schema, {
-						...options,
-						parent: op
-					}) : void 0
-				} : void 0,
-				responses: op.responses.map((r) => transform(r, {
-					...options,
-					parent: op
-				}))
-			};
-		}
-		case "Schema": {
-			let schema = node;
-			const replaced = visitor.schema?.(schema, { parent });
-			if (replaced) schema = replaced;
-			const childOptions = {
-				...options,
-				parent: schema
-			};
-			return {
-				...schema,
-				..."properties" in schema && recurse ? { properties: schema.properties.map((p) => transform(p, childOptions)) } : {},
-				..."items" in schema && recurse ? { items: schema.items?.map((i) => transform(i, childOptions)) } : {},
-				..."members" in schema && recurse ? { members: schema.members?.map((m) => transform(m, childOptions)) } : {},
-				..."additionalProperties" in schema && recurse && schema.additionalProperties && schema.additionalProperties !== true ? { additionalProperties: transform(schema.additionalProperties, childOptions) } : {}
-			};
-		}
-		case "Property": {
-			let prop = node;
-			const replaced = visitor.property?.(prop, { parent });
-			if (replaced) prop = replaced;
-			return createProperty({
-				...prop,
-				schema: transform(prop.schema, {
-					...options,
-					parent: prop
-				})
-			});
-		}
-		case "Parameter": {
-			let param = node;
-			const replaced = visitor.parameter?.(param, { parent });
-			if (replaced) param = replaced;
-			return createParameter({
-				...param,
-				schema: transform(param.schema, {
-					...options,
-					parent: param
-				})
-			});
-		}
-		case "Response": {
-			let response = node;
-			const replaced = visitor.response?.(response, { parent });
-			if (replaced) response = replaced;
-			return {
-				...response,
-				schema: transform(response.schema, {
-					...options,
-					parent: response
-				})
-			};
-		}
-		case "FunctionParameter":
-		case "ParameterGroup":
-		case "FunctionParameters":
-		case "Type": return node;
-	}
+function createInput(overrides = {}) {
+	return {
+		schemas: [],
+		operations: [],
+		...overrides,
+		kind: "Input"
+	};
 }
 /**
-* Composes multiple visitors into one visitor, applied left to right.
+* Creates an `OutputNode` with a stable default for `files`.
 *
-* For each node kind, output from one visitor is input to the next.
-* If a visitor returns `undefined`, the previous node value is kept.
+* @example
+* ```ts
+* const output = createOutput()
+* // { kind: 'Output', files: [] }
+* ```
 *
 * @example
 * ```ts
-* const visitor = composeTransformers(
-*   { operation: (node) => ({ ...node, operationId: `a_${node.operationId}` }) },
-*   { operation: (node) => ({ ...node, operationId: `b_${node.operationId}` }) },
-* )
+* const output = createOutput({ files: [petFile] })
 * ```
 */
-function composeTransformers(...visitors) {
+function createOutput(overrides = {}) {
 	return {
-		root(node, context) {
-			return visitors.reduce((acc, v) => v.root?.(acc, context) ?? acc, node);
-		},
-		operation(node, context) {
-			return visitors.reduce((acc, v) => v.operation?.(acc, context) ?? acc, node);
-		},
-		schema(node, context) {
-			return visitors.reduce((acc, v) => v.schema?.(acc, context) ?? acc, node);
-		},
-		property(node, context) {
-			return visitors.reduce((acc, v) => v.property?.(acc, context) ?? acc, node);
-		},
-		parameter(node, context) {
-			return visitors.reduce((acc, v) => v.parameter?.(acc, context) ?? acc, node);
-		},
-		response(node, context) {
-			return visitors.reduce((acc, v) => v.response?.(acc, context) ?? acc, node);
-		}
+		files: [],
+		...overrides,
+		kind: "Output"
 	};
 }
 /**
-* Runs a depth-first synchronous collection pass.
-*
-* Non-`undefined` values returned by visitor callbacks are appended to the result.
+* Creates an `OperationNode` with default empty arrays for `tags`, `parameters`, and `responses`.
 *
 * @example
 * ```ts
-* const ids = collect(root, {
-*   operation(node) {
-*     return node.operationId
-*   },
+* const operation = createOperation({
+*   operationId: 'getPetById',
+*   method: 'GET',
+*   path: '/pet/{petId}',
 * })
+* // tags, parameters, and responses are []
 * ```
 *
 * @example
 * ```ts
-* // Collect from only the current node
-* const values = collect(root, { depth: 'shallow', root: () => 'root' })
-* ```
-*/
-function collect(node, options) {
-	const { depth, parent, ...visitor } = options;
-	const recurse = (depth ?? visitorDepths.deep) === visitorDepths.deep;
-	const results = [];
-	let v;
-	switch (node.kind) {
-		case "Root":
-			v = visitor.root?.(node, { parent });
-			break;
-		case "Operation":
-			v = visitor.operation?.(node, { parent });
-			break;
-		case "Schema":
-			v = visitor.schema?.(node, { parent });
-			break;
-		case "Property":
-			v = visitor.property?.(node, { parent });
-			break;
-		case "Parameter":
-			v = visitor.parameter?.(node, { parent });
-			break;
-		case "Response":
-			v = visitor.response?.(node, { parent });
-			break;
-		case "FunctionParameter":
-		case "ParameterGroup":
-		case "FunctionParameters": break;
-	}
-	if (v !== void 0) results.push(v);
-	for (const child of getChildren(node, recurse)) for (const item of collect(child, {
-		...options,
-		parent: node
-	})) results.push(item);
-	return results;
-}
-//#endregion
-//#region src/resolvers.ts
-function findDiscriminator(mapping, ref) {
-	if (!mapping || !ref) return null;
-	return Object.entries(mapping).find(([, value]) => value === ref)?.[0] ?? null;
-}
-function childName(parentName, propName) {
-	return parentName ? pascalCase([parentName, propName].join(" ")) : null;
-}
-function enumPropName(parentName, propName, enumSuffix) {
-	return pascalCase([
-		parentName,
-		propName,
-		enumSuffix
-	].filter(Boolean).join(" "));
+* const operation = createOperation({
+*   operationId: 'findPets',
+*   method: 'GET',
+*   path: '/pet/findByStatus',
+*   tags: ['pet'],
+* })
+* ```
+*/
+function createOperation(props) {
+	return {
+		tags: [],
+		parameters: [],
+		responses: [],
+		...props,
+		kind: "Operation"
+	};
 }
 /**
-* Collects import entries for all `ref` schema nodes in `node`.
+* Maps schema `type` to its underlying `primitive`.
+* Primitive types map to themselves; special string formats map to `'string'`.
+* Complex types (`ref`, `enum`, `union`, `intersection`, `tuple`, `blob`) are left unset.
 */
-function collectImports({ node, nameMapping, resolve }) {
-	return collect(node, { schema(schemaNode) {
-		const schemaRef = narrowSchema(schemaNode, "ref");
-		if (!schemaRef?.ref) return;
-		const rawName = extractRefName(schemaRef.ref);
-		const result = resolve(nameMapping.get(rawName) ?? rawName);
-		if (!result) return;
-		return result;
-	} });
+const TYPE_TO_PRIMITIVE = {
+	string: "string",
+	number: "number",
+	integer: "integer",
+	bigint: "bigint",
+	boolean: "boolean",
+	null: "null",
+	any: "any",
+	unknown: "unknown",
+	void: "void",
+	never: "never",
+	object: "object",
+	array: "array",
+	date: "date",
+	uuid: "string",
+	email: "string",
+	url: "string",
+	datetime: "string",
+	time: "string"
+};
+function createSchema(props) {
+	const inferredPrimitive = TYPE_TO_PRIMITIVE[props.type];
+	if (props["type"] === "object") return {
+		properties: [],
+		primitive: "object",
+		...props,
+		kind: "Schema"
+	};
+	return {
+		primitive: inferredPrimitive,
+		...props,
+		kind: "Schema"
+	};
 }
-//#endregion
-//#region src/transformers.ts
 /**
-* Replaces a discriminator property's schema with a string enum of allowed values.
+* Creates a `PropertyNode`.
 *
-* If `node` is not an object schema, or if the property does not exist, the input
-* node is returned as-is.
+* `required` defaults to `false`.
+* `schema.optional` and `schema.nullish` are derived from `required` and `schema.nullable`.
 *
 * @example
 * ```ts
-* const schema = createSchema({
-*   type: 'object',
-*   properties: [createProperty({ name: 'type', required: true, schema: createSchema({ type: 'string' }) })],
+* const property = createProperty({
+*   name: 'status',
+*   schema: createSchema({ type: 'string' }),
 * })
-* const result = setDiscriminatorEnum({ node: schema, propertyName: 'type', values: ['dog', 'cat'] })
+* // required=false, schema.optional=true
+* ```
+*
+* @example
+* ```ts
+* const property = createProperty({
+*   name: 'status',
+*   required: true,
+*   schema: createSchema({ type: 'string', nullable: true }),
+* })
+* // required=true, no optional/nullish
 * ```
 */
-function setDiscriminatorEnum({ node, propertyName, values, enumName }) {
-	const objectNode = narrowSchema(node, "object");
-	if (!objectNode?.properties?.length) return node;
-	if (!objectNode.properties.some((prop) => prop.name === propertyName)) return node;
-	return createSchema({
-		...objectNode,
-		properties: objectNode.properties.map((prop) => {
-			if (prop.name !== propertyName) return prop;
-			return createProperty({
-				...prop,
-				schema: createSchema({
-					type: "enum",
-					primitive: "string",
-					enumValues: values,
-					name: enumName,
-					readOnly: prop.schema.readOnly,
-					writeOnly: prop.schema.writeOnly
-				})
-			});
-		})
-	});
+function createProperty(props) {
+	const required = props.required ?? false;
+	return {
+		...props,
+		kind: "Property",
+		required,
+		schema: syncOptionality(props.schema, required)
+	};
 }
 /**
-* Merges adjacent anonymous object members into a single anonymous object member.
+* Creates a `ParameterNode`.
+*
+* `required` defaults to `false`.
+* Nested schema flags are set from `required` and `schema.nullable`.
 *
 * @example
 * ```ts
-* const merged = mergeAdjacentObjects([
-*   createSchema({ type: 'object', properties: [createProperty({ name: 'a', schema: createSchema({ type: 'string' }) })] }),
-*   createSchema({ type: 'object', properties: [createProperty({ name: 'b', schema: createSchema({ type: 'number' }) })] }),
-* ])
+* const param = createParameter({
+*   name: 'petId',
+*   in: 'path',
+*   required: true,
+*   schema: createSchema({ type: 'string' }),
+* })
+* ```
+*
+* @example
+* ```ts
+* const param = createParameter({
+*   name: 'status',
+*   in: 'query',
+*   schema: createSchema({ type: 'string', nullable: true }),
+* })
+* // required=false, schema.nullish=true
 * ```
 */
-function mergeAdjacentObjects(members) {
-	return members.reduce((acc, member) => {
-		const objectMember = narrowSchema(member, "object");
-		if (objectMember && !objectMember.name) {
-			const previous = acc.at(-1);
-			const previousObject = previous ? narrowSchema(previous, "object") : void 0;
-			if (previousObject && !previousObject.name) {
-				acc[acc.length - 1] = createSchema({
-					...previousObject,
-					properties: [...previousObject.properties ?? [], ...objectMember.properties ?? []]
-				});
-				return acc;
-			}
-		}
-		acc.push(member);
-		return acc;
-	}, []);
+function createParameter(props) {
+	const required = props.required ?? false;
+	return {
+		...props,
+		kind: "Parameter",
+		required,
+		schema: syncOptionality(props.schema, required)
+	};
 }
 /**
-* Removes enum members that are covered by broader scalar primitives in the same union.
+* Creates a `ResponseNode`.
 *
 * @example
 * ```ts
-* const simplified = simplifyUnion([
-*   createSchema({ type: 'enum', primitive: 'string', enumValues: ['active'] }),
-*   createSchema({ type: 'string' }),
-* ])
-* // keeps only string member
+* const response = createResponse({
+*   statusCode: '200',
+*   description: 'Success',
+*   schema: createSchema({ type: 'object', properties: [] }),
+* })
 * ```
 */
-function simplifyUnion(members) {
-	const scalarPrimitives = new Set(members.filter((member) => isScalarPrimitive(member.type)).map((m) => m.type));
-	if (!scalarPrimitives.size) return members;
-	return members.filter((member) => {
-		const enumNode = narrowSchema(member, "enum");
-		if (!enumNode) return true;
-		const primitive = enumNode.primitive;
-		if (!primitive) return true;
-		if ((enumNode.namedEnumValues?.length ?? enumNode.enumValues?.length ?? 0) <= 1) return true;
-		if (scalarPrimitives.has(primitive)) return false;
-		if ((primitive === "integer" || primitive === "number") && (scalarPrimitives.has("integer") || scalarPrimitives.has("number"))) return false;
-		return true;
-	});
-}
-function setEnumName(propNode, parentName, propName, enumSuffix) {
-	const enumNode = narrowSchema(propNode, "enum");
-	if (enumNode?.primitive === "boolean") return {
-		...propNode,
-		name: void 0
-	};
-	if (enumNode) return {
-		...propNode,
-		name: enumPropName(parentName, propName, enumSuffix)
+function createResponse(props) {
+	return {
+		...props,
+		kind: "Response"
 	};
-	return propNode;
 }
-//#endregion
-//#region src/utils.ts
-const plainStringTypes = new Set([
-	"string",
-	"uuid",
-	"email",
-	"url",
-	"datetime"
-]);
 /**
-* Returns a merged schema view for a ref node, combining the resolved `node.schema`
-* (base from the referenced definition) with any usage-site sibling fields set directly
-* on the ref node (description, readOnly, nullable, deprecated, etc.).
+* Creates a `FunctionParameterNode`.
 *
-* Usage-site fields take precedence over the resolved schema's own fields when both are defined.
+* `optional` defaults to `false`.
 *
-* For non-ref nodes the node itself is returned unchanged.
+* @example Required typed param
+* ```ts
+* createFunctionParameter({ name: 'petId', type: createParamsType({ variant: 'reference', name: 'string' }) })
+* // → petId: string
+* ```
+*
+* @example Optional param
+* ```ts
+* createFunctionParameter({ name: 'params', type: createParamsType({ variant: 'reference', name: 'QueryParams' }), optional: true })
+* // → params?: QueryParams
+* ```
+*
+* @example Param with default (implicitly optional; cannot combine with `optional: true`)
+* ```ts
+* createFunctionParameter({ name: 'config', type: createParamsType({ variant: 'reference', name: 'RequestConfig' }), default: '{}' })
+* // → config: RequestConfig = {}
+* ```
 */
-function syncSchemaRef(node) {
-	const ref = narrowSchema(node, "ref");
-	if (!ref) return node;
-	if (!ref.schema) return node;
-	const { kind: _kind, type: _type, name: _name, ref: _ref, schema: _schema, ...overrides } = ref;
-	const definedOverrides = Object.fromEntries(Object.entries(overrides).filter(([, v]) => v !== void 0));
-	return createSchema({
-		...ref.schema,
-		...definedOverrides
-	});
+function createFunctionParameter(props) {
+	return {
+		optional: false,
+		...props,
+		kind: "FunctionParameter"
+	};
 }
 /**
-* Returns `true` when a schema is emitted as a plain `string` type.
+* Creates a {@link TypeNode} representing a language-agnostic structured type expression.
 *
-* - `string`, `uuid`, `email`, `url`, `datetime` are always plain strings.
-* - `date` and `time` are plain strings when their `representation` is `'string'` rather than `'date'`.
+* Use `variant: 'struct'` for inline anonymous types and `variant: 'member'` for a single
+* named field accessed from a group type. Each language's printer renders the variant
+* into its own syntax (TypeScript, Python, C#, Kotlin, …).
+*
+* @example Reference type (TypeScript: `QueryParams`)
+* ```ts
+* createParamsType({ variant: 'reference', name: 'QueryParams' })
+* ```
+*
+* @example Struct type (TypeScript: `{ petId: string }`)
+* ```ts
+* createParamsType({ variant: 'struct', properties: [{ name: 'petId', optional: false, type: createParamsType({ variant: 'reference', name: 'string' }) }] })
+* ```
+*
+* @example Member type (TypeScript: `DeletePetPathParams['petId']`)
+* ```ts
+* createParamsType({ variant: 'member', base: 'DeletePetPathParams', key: 'petId' })
+* ```
+*/
+function createParamsType(props) {
+	return {
+		...props,
+		kind: "ParamsType"
+	};
+}
+/**
+* Creates a `ParameterGroupNode` representing a group of related parameters treated as a unit.
+*
+* @example Grouped param (TypeScript declaration)
+* ```ts
+* createParameterGroup({
+*   properties: [
+*     createFunctionParameter({ name: 'id', type: createParamsType({ variant: 'reference', name: 'string' }), optional: false }),
+*     createFunctionParameter({ name: 'name', type: createParamsType({ variant: 'reference', name: 'string' }), optional: true }),
+*   ],
+*   default: '{}',
+* })
+* // declaration → { id, name? }: { id: string; name?: string } = {}
+* // call        → { id, name }
+* ```
+*
+* @example Inline (spread) — children emitted as individual top-level parameters
+* ```ts
+* createParameterGroup({
+*   properties: [createFunctionParameter({ name: 'petId', type: createParamsType({ variant: 'reference', name: 'string' }), optional: false })],
+*   inline: true,
+* })
+* // declaration → petId: string
+* // call        → petId
+* ```
+*/
+function createParameterGroup(props) {
+	return {
+		...props,
+		kind: "ParameterGroup"
+	};
+}
+/**
+* Creates a `FunctionParametersNode` from an ordered list of parameters.
 *
 * @example
 * ```ts
-* isStringType(createSchema({ type: 'uuid' }))                          // true
-* isStringType(createSchema({ type: 'date', representation: 'date' }))  // false
+* createFunctionParameters({
+*   params: [
+*     createFunctionParameter({ name: 'petId', type: createParamsType({ variant: 'reference', name: 'string' }), optional: false }),
+*     createFunctionParameter({ name: 'config', type: createParamsType({ variant: 'reference', name: 'RequestConfig' }), optional: false, default: '{}' }),
+*   ],
+* })
+* ```
+*
+* @example
+* ```ts
+* const empty = createFunctionParameters()
+* // { kind: 'FunctionParameters', params: [] }
 * ```
 */
-function isStringType(node) {
-	if (plainStringTypes.has(node.type)) return true;
-	const temporal = narrowSchema(node, "date") ?? narrowSchema(node, "time");
-	if (temporal) return temporal.representation !== "date";
-	return false;
+function createFunctionParameters(props = {}) {
+	return {
+		params: [],
+		...props,
+		kind: "FunctionParameters"
+	};
 }
 /**
-* Applies casing rules to parameter names and returns a new parameter array.
+* Creates an `ImportNode` representing a language-agnostic import/dependency declaration.
 *
-* The input array is not mutated.
-* If `casing` is not set, the original array is returned unchanged.
+* @example Named import
+* ```ts
+* createImport({ name: ['useState'], path: 'react' })
+* // import { useState } from 'react'
+* ```
 *
-* Use this before passing parameters to schema builders so that property keys
-* in generated output match the desired casing while preserving
-* `OperationNode.parameters` for other consumers.
+* @example Type-only import
+* ```ts
+* createImport({ name: ['FC'], path: 'react', isTypeOnly: true })
+* // import type { FC } from 'react'
+* ```
+*/
+function createImport(props) {
+	return {
+		...props,
+		kind: "Import"
+	};
+}
+/**
+* Creates an `ExportNode` representing a language-agnostic export/public API declaration.
+*
+* @example Named export
+* ```ts
+* createExport({ name: ['Pet'], path: './Pet' })
+* // export { Pet } from './Pet'
+* ```
+*
+* @example Wildcard export
+* ```ts
+* createExport({ path: './utils' })
+* // export * from './utils'
+* ```
+*/
+function createExport(props) {
+	return {
+		...props,
+		kind: "Export"
+	};
+}
+/**
+* Creates a `SourceNode` representing a fragment of source code within a file.
 *
 * @example
 * ```ts
-* const params = [createParameter({ name: 'pet_id', in: 'query', schema: createSchema({ type: 'string' }) })]
-* const cased = caseParams(params, 'camelcase')
-* // cased[0].name === 'petId'
+* createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')], isExportable: true })
 * ```
 */
-function caseParams(params, casing) {
-	if (!casing) return params;
-	return params.map((param) => {
-		const transformed = casing === "camelcase" || !isValidVarName(param.name) ? camelCase(param.name) : param.name;
-		return {
-			...param,
-			name: transformed
-		};
-	});
+function createSource(props) {
+	return {
+		...props,
+		kind: "Source"
+	};
 }
 /**
-* Creates a single-property object schema used as a discriminator literal.
+* Creates a fully resolved `FileNode` from a file input descriptor.
+*
+* Computes:
+* - `id` — SHA256 hash of the file path
+* - `name` — `baseName` without extension
+* - `extname` — extension extracted from `baseName`
+*
+* Deduplicates:
+* - `sources` via `combineSources`
+* - `exports` via `combineExports`
+* - `imports` via `combineImports` (also filters unused imports)
+*
+* @throws {Error} when `baseName` has no extension.
 *
 * @example
 * ```ts
-* createDiscriminantNode({ propertyName: 'type', value: 'dog' })
-* // -> { type: 'object', properties: [{ name: 'type', required: true, schema: enum('dog') }] }
+* const file = createFile({
+*   baseName: 'petStore.ts',
+*   path: 'src/models/petStore.ts',
+*   sources: [createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')] })],
+*   imports: [createImport({ name: ['z'], path: 'zod' })],
+*   exports: [createExport({ name: ['Pet'], path: './petStore' })],
+* })
+* // file.id      = SHA256 hash of 'src/models/petStore.ts'
+* // file.name    = 'petStore'
+* // file.extname = '.ts'
 * ```
 */
-function createDiscriminantNode({ propertyName, value }) {
-	return createSchema({
-		type: "object",
-		primitive: "object",
-		properties: [createProperty({
-			name: propertyName,
-			schema: createSchema({
-				type: "enum",
-				primitive: "string",
-				enumValues: [value]
-			}),
-			required: true
-		})]
-	});
+function createFile(input) {
+	const extname = path.extname(input.baseName) || (input.baseName.startsWith(".") ? input.baseName : "");
+	if (!extname) throw new Error(`No extname found for ${input.baseName}`);
+	const source = (input.sources ?? []).flatMap((item) => item.nodes ?? []).map((node) => extractStringsFromNodes([node])).filter(Boolean).join("\n\n");
+	const resolvedExports = input.exports?.length ? combineExports(input.exports) : [];
+	const resolvedImports = input.imports?.length ? combineImports(input.imports, resolvedExports, source || void 0) : [];
+	const resolvedSources = input.sources?.length ? combineSources(input.sources) : [];
+	return {
+		kind: "File",
+		...input,
+		id: createHash("sha256").update(input.path).digest("hex"),
+		name: trimExtName(input.baseName),
+		extname,
+		imports: resolvedImports,
+		exports: resolvedExports,
+		sources: resolvedSources,
+		meta: input.meta ?? {}
+	};
 }
-function resolveType({ node, param, resolver }) {
-	if (!resolver) return createTypeNode({
-		variant: "reference",
-		name: param.schema.primitive ?? "unknown"
-	});
-	const individualName = resolver.resolveParamName(node, param);
-	const groupLocation = param.in === "path" || param.in === "query" || param.in === "header" ? param.in : void 0;
-	const groupResolvers = {
-		path: resolver.resolvePathParamsName,
-		query: resolver.resolveQueryParamsName,
-		header: resolver.resolveHeaderParamsName
+/**
+* Creates a `ConstNode` representing a TypeScript `const` declaration.
+*
+* Mirrors the `Const` component from `@kubb/renderer-jsx`.
+* The component's `children` are represented as `nodes`.
+*
+* @example Simple constant
+* ```ts
+* createConst({ name: 'pet' })
+* // const pet = ...
+* ```
+*
+* @example Exported constant with type and `as const`
+* ```ts
+* createConst({ name: 'pets', export: true, type: 'Pet[]', asConst: true })
+* // export const pets: Pet[] = ... as const
+* ```
+*
+* @example With JSDoc and child nodes
+* ```ts
+* createConst({
+*   name: 'config',
+*   export: true,
+*   JSDoc: { comments: ['@description App configuration'] },
+*   nodes: [],
+* })
+* ```
+*/
+function createConst(props) {
+	return {
+		...props,
+		kind: "Const"
 	};
-	const groupName = groupLocation ? groupResolvers[groupLocation].call(resolver, node, param) : void 0;
-	if (groupName && groupName !== individualName) return createTypeNode({
-		variant: "member",
-		base: groupName,
-		key: param.name
-	});
-	return createTypeNode({
-		variant: "reference",
-		name: individualName
-	});
 }
 /**
-* Converts an {@link OperationNode} into a {@link FunctionParametersNode}.
+* Creates a `TypeNode` representing a TypeScript `type` alias declaration.
 *
-* Centralizes the per-plugin `getParams()` pattern. Provide a `resolver` for
-* type resolution and `extraParams` for plugin-specific trailing parameters.
+* Mirrors the `Type` component from `@kubb/renderer-jsx`.
+* The component's `children` are represented as `nodes`.
 *
-* @example
+* @example Simple type alias
 * ```ts
-* const params = createOperationParams(node, {
-*   paramsType: 'inline',
-*   pathParamsType: 'inline',
-*   resolver: tsResolver,
-*   extraParams: [createFunctionParameter({ name: 'options', type: createTypeNode({ variant: 'reference', name: 'Partial<RequestOptions>' }), default: '{}' })],
+* createType({ name: 'Pet' })
+* // type Pet = ...
+* ```
+*
+* @example Exported type with JSDoc
+* ```ts
+* createType({
+*   name: 'PetStatus',
+*   export: true,
+*   JSDoc: { comments: ['@description Status of a pet'] },
 * })
+* // export type PetStatus = ...
 * ```
 */
-function createOperationParams(node, options) {
-	const { paramsType, pathParamsType, paramsCasing, resolver, pathParamsDefault, extraParams = [], paramNames, typeWrapper } = options;
-	const dataName = paramNames?.data ?? "data";
-	const paramsName = paramNames?.params ?? "params";
-	const headersName = paramNames?.headers ?? "headers";
-	const pathName = paramNames?.path ?? "pathParams";
-	const wrapType = (type) => createTypeNode({
-		variant: "reference",
-		name: typeWrapper ? typeWrapper(type) : type
-	});
-	const wrapTypeNode = (type) => type.variant === "reference" ? wrapType(type.name) : type;
-	const casedParams = caseParams(node.parameters, paramsCasing);
-	const pathParams = casedParams.filter((p) => p.in === "path");
-	const queryParams = casedParams.filter((p) => p.in === "query");
-	const headerParams = casedParams.filter((p) => p.in === "header");
-	const bodyType = node.requestBody?.schema ? wrapType(resolver?.resolveDataName(node) ?? "unknown") : void 0;
-	const bodyRequired = node.requestBody?.required ?? false;
-	const queryGroupType = resolver ? resolveGroupType({
-		node,
-		params: queryParams,
-		groupMethod: resolver.resolveQueryParamsName,
-		resolver
-	}) : void 0;
-	const headerGroupType = resolver ? resolveGroupType({
-		node,
-		params: headerParams,
-		groupMethod: resolver.resolveHeaderParamsName,
-		resolver
-	}) : void 0;
-	const params = [];
-	if (paramsType === "object") {
-		const children = [
-			...pathParams.map((p) => {
-				const type = resolveType({
-					node,
-					param: p,
-					resolver
-				});
-				return createFunctionParameter({
-					name: p.name,
-					type: wrapTypeNode(type),
-					optional: !p.required
+function createType(props) {
+	return {
+		...props,
+		kind: "Type"
+	};
+}
+/**
+* Creates a `FunctionNode` representing a TypeScript `function` declaration.
+*
+* Mirrors the `Function` component from `@kubb/renderer-jsx`.
+* The component's `children` are represented as `nodes`.
+*
+* @example Simple function
+* ```ts
+* createFunction({ name: 'getPet' })
+* // function getPet() { ... }
+* ```
+*
+* @example Exported async function with return type
+* ```ts
+* createFunction({ name: 'fetchPet', export: true, async: true, returnType: 'Pet' })
+* // export async function fetchPet(): Promise<Pet> { ... }
+* ```
+*
+* @example Function with generics and params
+* ```ts
+* createFunction({
+*   name: 'identity',
+*   export: true,
+*   generics: ['T'],
+*   params: 'value: T',
+*   returnType: 'T',
+* })
+* // export function identity<T>(value: T): T { ... }
+* ```
+*/
+function createFunction(props) {
+	return {
+		...props,
+		kind: "Function"
+	};
+}
+/**
+* Creates an `ArrowFunctionNode` representing a TypeScript arrow function.
+*
+* Mirrors the `Function.Arrow` component from `@kubb/renderer-jsx`.
+* The component's `children` are represented as `nodes`.
+*
+* @example Simple arrow function
+* ```ts
+* createArrowFunction({ name: 'getPet' })
+* // const getPet = () => { ... }
+* ```
+*
+* @example Single-line exported arrow function
+* ```ts
+* createArrowFunction({ name: 'double', export: true, params: 'n: number', singleLine: true })
+* // export const double = (n: number) => ...
+* ```
+*
+* @example Async arrow function with generics
+* ```ts
+* createArrowFunction({
+*   name: 'fetchPet',
+*   export: true,
+*   async: true,
+*   generics: ['T'],
+*   params: 'id: string',
+*   returnType: 'T',
+* })
+* // export const fetchPet = async <T>(id: string): Promise<T> => { ... }
+* ```
+*/
+function createArrowFunction(props) {
+	return {
+		...props,
+		kind: "ArrowFunction"
+	};
+}
+/**
+* Creates a {@link TextNode} representing a raw string fragment in the source output.
+*
+* Use this instead of bare strings when building `nodes` arrays so that every
+* entry in the array is a typed {@link CodeNode}.
+*
+* @example
+* ```ts
+* createText('return fetch(id)')
+* // { kind: 'Text', value: 'return fetch(id)' }
+* ```
+*/
+function createText(value) {
+	return {
+		value,
+		kind: "Text"
+	};
+}
+/**
+* Creates a {@link BreakNode} representing a line break in the source output.
+*
+* Corresponds to `<br/>` in JSX components. Prints as an empty string which,
+* when joined with `\n` by `printNodes`, produces a blank line.
+*
+* @example
+* ```ts
+* createBreak()
+* // { kind: 'Break' }
+* ```
+*/
+function createBreak() {
+	return { kind: "Break" };
+}
+/**
+* Creates a {@link JsxNode} representing a raw JSX fragment in the source output.
+*
+* Use this to embed JSX markup (including fragments `<>…</>`) directly in generated code.
+*
+* @example
+* ```ts
+* createJsx('<>\n  <a href={href}>Open</a>\n</>')
+* // { kind: 'Jsx', value: '<>\n  <a href={href}>Open</a>\n</>' }
+* ```
+*/
+function createJsx(value) {
+	return {
+		value,
+		kind: "Jsx"
+	};
+}
+//#endregion
+//#region src/printer.ts
+/**
+* Creates a schema printer factory.
+*
+* This function wraps a builder and makes options optional at call sites.
+*
+* The builder receives resolved options and returns:
+* - `name` — a unique identifier for the printer
+* - `options` — options stored on the returned printer instance
+* - `nodes` — a map of `SchemaType` → handler functions that convert a `SchemaNode` to `TOutput`
+* - `print` _(optional)_ — top-level override exposed as `printer.print`
+*   - Inside this function, use `this.transform(node)` to dispatch to the `nodes` map
+*   - This keeps recursion safe and avoids self-calls
+*
+* When no `print` override is provided, `printer.print` falls back to `printer.transform` (the node-level dispatcher).
+*
+* @example Basic usage — Zod schema printer
+* ```ts
+* type PrinterZod = PrinterFactoryOptions<'zod', { strict?: boolean }, string>
+*
+* export const zodPrinter = definePrinter<PrinterZod>((options) => ({
+*   name: 'zod',
+*   options: { strict: options.strict ?? true },
+*   nodes: {
+*     string: () => 'z.string()',
+*     object(node) {
+*       const props = node.properties.map(p => `${p.name}: ${this.transform(p.schema)}`).join(', ')
+*       return `z.object({ ${props} })`
+*     },
+*   },
+* }))
+* ```
+*/
+function definePrinter(build) {
+	return createPrinterFactory((node) => node.type)(build);
+}
+/**
+* Generic printer-factory function used by `definePrinter` and `defineFunctionPrinter`.
+**
+* @example
+* ```ts
+* export const defineFunctionPrinter = createPrinterFactory<FunctionNode, FunctionNodeType, FunctionNodeByType>(
+*   (node) => kindToHandlerKey[node.kind],
+* )
+* ```
+*/
+function createPrinterFactory(getKey) {
+	return function(build) {
+		return (options) => {
+			const { name, options: resolvedOptions, nodes, print: printOverride } = build(options ?? {});
+			const context = {
+				options: resolvedOptions,
+				transform: (node) => {
+					const key = getKey(node);
+					if (key === void 0) return null;
+					const handler = nodes[key];
+					if (!handler) return null;
+					return handler.call(context, node);
+				}
+			};
+			return {
+				name,
+				options: resolvedOptions,
+				transform: context.transform,
+				print: printOverride ? printOverride.bind(context) : context.transform
+			};
+		};
+	};
+}
+//#endregion
+//#region src/refs.ts
+/**
+* Returns the last path segment of a reference string.
+*
+* Example: `#/components/schemas/Pet` becomes `Pet`.
+*
+* @example
+* ```ts
+* extractRefName('#/components/schemas/Pet') // 'Pet'
+* ```
+*/
+function extractRefName(ref) {
+	return ref.split("/").at(-1) ?? ref;
+}
+//#endregion
+//#region src/visitor.ts
+/**
+* Creates a small async concurrency limiter.
+*
+* At most `concurrency` tasks are in flight at once. Extra tasks are queued.
+*
+* @example
+* ```ts
+* const limit = createLimit(2)
+* for (const task of [taskA, taskB, taskC]) {
+*   await limit(() => task())
+* }
+* // only 2 tasks run at the same time
+* ```
+*/
+function createLimit(concurrency) {
+	let active = 0;
+	const queue = [];
+	function next() {
+		if (active < concurrency && queue.length > 0) {
+			active++;
+			queue.shift()();
+		}
+	}
+	return function limit(fn) {
+		return new Promise((resolve, reject) => {
+			queue.push(() => {
+				Promise.resolve(fn()).then(resolve, reject).finally(() => {
+					active--;
+					next();
 				});
-			}),
-			...bodyType ? [createFunctionParameter({
-				name: dataName,
-				type: bodyType,
-				optional: !bodyRequired
-			})] : [],
-			...buildGroupParam({
-				name: paramsName,
-				node,
-				params: queryParams,
-				groupType: queryGroupType,
-				resolver,
-				wrapType
-			}),
-			...buildGroupParam({
-				name: headersName,
-				node,
-				params: headerParams,
-				groupType: headerGroupType,
-				resolver,
-				wrapType
-			})
+			});
+			next();
+		});
+	};
+}
+/**
+* Returns the immediate traversable children of `node`.
+*
+* For `Schema` nodes, children (`properties`, `items`, `members`, and non-boolean
+* `additionalProperties`) are only included
+* when `recurse` is `true`; shallow mode skips them.
+*
+* @example
+* ```ts
+* const children = getChildren(operationNode, true)
+* // returns parameters, requestBody schema (if present), and responses
+* ```
+*/
+function getChildren(node, recurse) {
+	switch (node.kind) {
+		case "Input": return [...node.schemas, ...node.operations];
+		case "Output": return [];
+		case "Operation": return [
+			...node.parameters,
+			...node.requestBody?.schema ? [node.requestBody.schema] : [],
+			...node.responses
 		];
-		if (children.length) params.push(createParameterGroup({
-			properties: children,
-			default: children.every((c) => c.optional) ? "{}" : void 0
-		}));
-	} else {
-		if (pathParams.length) if (pathParamsType === "inlineSpread") {
-			const spreadType = resolver?.resolvePathParamsName(node, pathParams[0]) ?? void 0;
-			params.push(createFunctionParameter({
-				name: pathName,
-				type: spreadType ? wrapType(spreadType) : void 0,
-				rest: true
-			}));
-		} else {
-			const pathChildren = pathParams.map((p) => {
-				const type = resolveType({
-					node,
-					param: p,
-					resolver
-				});
-				return createFunctionParameter({
-					name: p.name,
-					type: wrapTypeNode(type),
-					optional: !p.required
-				});
+		case "Schema": {
+			const children = [];
+			if (!recurse) return [];
+			if ("properties" in node && node.properties.length > 0) children.push(...node.properties);
+			if ("items" in node && node.items) children.push(...node.items);
+			if ("members" in node && node.members) children.push(...node.members);
+			if ("additionalProperties" in node && node.additionalProperties && node.additionalProperties !== true) children.push(node.additionalProperties);
+			return children;
+		}
+		case "Property": return [node.schema];
+		case "Parameter": return [node.schema];
+		case "Response": return node.schema ? [node.schema] : [];
+		case "FunctionParameter":
+		case "ParameterGroup":
+		case "FunctionParameters":
+		case "Type": return [];
+		default: return [];
+	}
+}
+/**
+* Depth-first traversal for side effects. Visitor return values are ignored.
+* Sibling nodes at each level are visited concurrently up to `options.concurrency`
+* (default: `WALK_CONCURRENCY`).
+*
+* @example
+* ```ts
+* await walk(root, {
+*   operation(node) {
+*     console.log(node.operationId)
+*   },
+* })
+* ```
+*
+* @example
+* ```ts
+* // Visit only the current node
+* await walk(root, { depth: 'shallow', root: () => {} })
+* ```
+*/
+async function walk(node, options) {
+	return _walk(node, options, (options.depth ?? visitorDepths.deep) === visitorDepths.deep, createLimit(options.concurrency ?? 30), void 0);
+}
+async function _walk(node, visitor, recurse, limit, parent) {
+	switch (node.kind) {
+		case "Input":
+			await limit(() => visitor.input?.(node, { parent }));
+			break;
+		case "Output":
+			await limit(() => visitor.output?.(node, { parent }));
+			break;
+		case "Operation":
+			await limit(() => visitor.operation?.(node, { parent }));
+			break;
+		case "Schema":
+			await limit(() => visitor.schema?.(node, { parent }));
+			break;
+		case "Property":
+			await limit(() => visitor.property?.(node, { parent }));
+			break;
+		case "Parameter":
+			await limit(() => visitor.parameter?.(node, { parent }));
+			break;
+		case "Response":
+			await limit(() => visitor.response?.(node, { parent }));
+			break;
+		case "FunctionParameter":
+		case "ParameterGroup":
+		case "FunctionParameters": break;
+	}
+	const children = getChildren(node, recurse);
+	for (const child of children) await _walk(child, visitor, recurse, limit, node);
+}
+function transform(node, options) {
+	const { depth, parent, ...visitor } = options;
+	const recurse = (depth ?? visitorDepths.deep) === visitorDepths.deep;
+	switch (node.kind) {
+		case "Input": {
+			let input = node;
+			const replaced = visitor.input?.(input, { parent });
+			if (replaced) input = replaced;
+			return {
+				...input,
+				schemas: input.schemas.map((s) => transform(s, {
+					...options,
+					parent: input
+				})),
+				operations: input.operations.map((op) => transform(op, {
+					...options,
+					parent: input
+				}))
+			};
+		}
+		case "Output": {
+			let output = node;
+			const replaced = visitor.output?.(output, { parent });
+			if (replaced) output = replaced;
+			return output;
+		}
+		case "Operation": {
+			let op = node;
+			const replaced = visitor.operation?.(op, { parent });
+			if (replaced) op = replaced;
+			return {
+				...op,
+				parameters: op.parameters.map((p) => transform(p, {
+					...options,
+					parent: op
+				})),
+				requestBody: op.requestBody ? {
+					...op.requestBody,
+					schema: op.requestBody.schema ? transform(op.requestBody.schema, {
+						...options,
+						parent: op
+					}) : void 0
+				} : void 0,
+				responses: op.responses.map((r) => transform(r, {
+					...options,
+					parent: op
+				}))
+			};
+		}
+		case "Schema": {
+			let schema = node;
+			const replaced = visitor.schema?.(schema, { parent });
+			if (replaced) schema = replaced;
+			const childOptions = {
+				...options,
+				parent: schema
+			};
+			return {
+				...schema,
+				..."properties" in schema && recurse ? { properties: schema.properties.map((p) => transform(p, childOptions)) } : {},
+				..."items" in schema && recurse ? { items: schema.items?.map((i) => transform(i, childOptions)) } : {},
+				..."members" in schema && recurse ? { members: schema.members?.map((m) => transform(m, childOptions)) } : {},
+				..."additionalProperties" in schema && recurse && schema.additionalProperties && schema.additionalProperties !== true ? { additionalProperties: transform(schema.additionalProperties, childOptions) } : {}
+			};
+		}
+		case "Property": {
+			let prop = node;
+			const replaced = visitor.property?.(prop, { parent });
+			if (replaced) prop = replaced;
+			return createProperty({
+				...prop,
+				schema: transform(prop.schema, {
+					...options,
+					parent: prop
+				})
 			});
-			params.push(createParameterGroup({
-				properties: pathChildren,
-				inline: pathParamsType === "inline",
-				default: pathParamsDefault ?? (pathChildren.every((c) => c.optional) ? "{}" : void 0)
-			}));
 		}
-		if (bodyType) params.push(createFunctionParameter({
-			name: dataName,
-			type: bodyType,
-			optional: !bodyRequired
-		}));
-		params.push(...buildGroupParam({
-			name: paramsName,
-			node,
-			params: queryParams,
-			groupType: queryGroupType,
-			resolver,
-			wrapType
-		}));
-		params.push(...buildGroupParam({
-			name: headersName,
-			node,
-			params: headerParams,
-			groupType: headerGroupType,
-			resolver,
-			wrapType
-		}));
+		case "Parameter": {
+			let param = node;
+			const replaced = visitor.parameter?.(param, { parent });
+			if (replaced) param = replaced;
+			return createParameter({
+				...param,
+				schema: transform(param.schema, {
+					...options,
+					parent: param
+				})
+			});
+		}
+		case "Response": {
+			let response = node;
+			const replaced = visitor.response?.(response, { parent });
+			if (replaced) response = replaced;
+			return {
+				...response,
+				schema: transform(response.schema, {
+					...options,
+					parent: response
+				})
+			};
+		}
+		case "FunctionParameter":
+		case "ParameterGroup":
+		case "FunctionParameters":
+		case "Type": return node;
+		default: return node;
+	}
+}
+/**
+* Composes multiple visitors into one visitor, applied left to right.
+*
+* For each node kind, output from one visitor is input to the next.
+* If a visitor returns `undefined`, the previous node value is kept.
+*
+* @example
+* ```ts
+* const visitor = composeTransformers(
+*   { operation: (node) => ({ ...node, operationId: `a_${node.operationId}` }) },
+*   { operation: (node) => ({ ...node, operationId: `b_${node.operationId}` }) },
+* )
+* ```
+*/
+function composeTransformers(...visitors) {
+	return {
+		input(node, context) {
+			return visitors.reduce((acc, v) => v.input?.(acc, context) ?? acc, node);
+		},
+		output(node, context) {
+			return visitors.reduce((acc, v) => v.output?.(acc, context) ?? acc, node);
+		},
+		operation(node, context) {
+			return visitors.reduce((acc, v) => v.operation?.(acc, context) ?? acc, node);
+		},
+		schema(node, context) {
+			return visitors.reduce((acc, v) => v.schema?.(acc, context) ?? acc, node);
+		},
+		property(node, context) {
+			return visitors.reduce((acc, v) => v.property?.(acc, context) ?? acc, node);
+		},
+		parameter(node, context) {
+			return visitors.reduce((acc, v) => v.parameter?.(acc, context) ?? acc, node);
+		},
+		response(node, context) {
+			return visitors.reduce((acc, v) => v.response?.(acc, context) ?? acc, node);
+		}
+	};
+}
+/**
+* Runs a depth-first synchronous collection pass.
+*
+* Non-`undefined` values returned by visitor callbacks are appended to the result.
+*
+* @example
+* ```ts
+* const ids = collect(root, {
+*   operation(node) {
+*     return node.operationId
+*   },
+* })
+* ```
+*
+* @example
+* ```ts
+* // Collect from only the current node
+* const values = collect(root, { depth: 'shallow', root: () => 'root' })
+* ```
+*/
+function collect(node, options) {
+	const { depth, parent, ...visitor } = options;
+	const recurse = (depth ?? visitorDepths.deep) === visitorDepths.deep;
+	const results = [];
+	let v;
+	switch (node.kind) {
+		case "Input":
+			v = visitor.input?.(node, { parent });
+			break;
+		case "Output":
+			v = visitor.output?.(node, { parent });
+			break;
+		case "Operation":
+			v = visitor.operation?.(node, { parent });
+			break;
+		case "Schema":
+			v = visitor.schema?.(node, { parent });
+			break;
+		case "Property":
+			v = visitor.property?.(node, { parent });
+			break;
+		case "Parameter":
+			v = visitor.parameter?.(node, { parent });
+			break;
+		case "Response":
+			v = visitor.response?.(node, { parent });
+			break;
+		case "FunctionParameter":
+		case "ParameterGroup":
+		case "FunctionParameters": break;
 	}
-	params.push(...extraParams);
-	return createFunctionParameters({ params });
+	if (v !== void 0) results.push(v);
+	for (const child of getChildren(node, recurse)) for (const item of collect(child, {
+		...options,
+		parent: node
+	})) results.push(item);
+	return results;
+}
+//#endregion
+//#region src/resolvers.ts
+function findDiscriminator(mapping, ref) {
+	if (!mapping || !ref) return null;
+	return Object.entries(mapping).find(([, value]) => value === ref)?.[0] ?? null;
+}
+function childName(parentName, propName) {
+	return parentName ? pascalCase([parentName, propName].join(" ")) : null;
+}
+function enumPropName(parentName, propName, enumSuffix) {
+	return pascalCase([
+		parentName,
+		propName,
+		enumSuffix
+	].filter(Boolean).join(" "));
 }
 /**
-* Builds a single {@link FunctionParameterNode} for a query or header group.
-* Returns an empty array when there are no params to emit.
+* Collects import entries for all `ref` schema nodes in `node`.
+*/
+function collectImports({ node, nameMapping, resolve }) {
+	return collect(node, { schema(schemaNode) {
+		const schemaRef = narrowSchema(schemaNode, "ref");
+		if (!schemaRef?.ref) return;
+		const rawName = extractRefName(schemaRef.ref);
+		const result = resolve(nameMapping.get(rawName) ?? rawName);
+		if (!result) return;
+		return result;
+	} });
+}
+//#endregion
+//#region src/transformers.ts
+/**
+* Replaces a discriminator property's schema with a string enum of allowed values.
 *
-* If a pre-resolved `groupType` is provided it emits `name: GroupType`.
-* Otherwise, it builds an inline struct from the individual params.
+* If `node` is not an object schema, or if the property does not exist, the input
+* node is returned as-is.
+*
+* @example
+* ```ts
+* const schema = createSchema({
+*   type: 'object',
+*   properties: [createProperty({ name: 'type', required: true, schema: createSchema({ type: 'string' }) })],
+* })
+* const result = setDiscriminatorEnum({ node: schema, propertyName: 'type', values: ['dog', 'cat'] })
+* ```
 */
-function buildGroupParam({ name, node, params, groupType, resolver, wrapType }) {
-	if (groupType) return [createFunctionParameter({
-		name,
-		type: groupType.type.variant === "reference" ? wrapType(groupType.type.name) : groupType.type,
-		optional: groupType.optional
-	})];
-	if (params.length) return [createFunctionParameter({
-		name,
-		type: toStructType({
-			node,
-			params,
-			resolver
-		}),
-		optional: params.every((p) => !p.required)
-	})];
-	return [];
+function setDiscriminatorEnum({ node, propertyName, values, enumName }) {
+	const objectNode = narrowSchema(node, "object");
+	if (!objectNode?.properties?.length) return node;
+	if (!objectNode.properties.some((prop) => prop.name === propertyName)) return node;
+	return createSchema({
+		...objectNode,
+		properties: objectNode.properties.map((prop) => {
+			if (prop.name !== propertyName) return prop;
+			return createProperty({
+				...prop,
+				schema: createSchema({
+					type: "enum",
+					primitive: "string",
+					enumValues: values,
+					name: enumName,
+					readOnly: prop.schema.readOnly,
+					writeOnly: prop.schema.writeOnly
+				})
+			});
+		})
+	});
 }
 /**
-* Derives a {@link ParamGroupType} from the resolver's group method.
-* Returns `undefined` when the group name equals the individual param name (no real group).
+* Merges adjacent anonymous object members into a single anonymous object member.
+*
+* @example
+* ```ts
+* const merged = mergeAdjacentObjects([
+*   createSchema({ type: 'object', properties: [createProperty({ name: 'a', schema: createSchema({ type: 'string' }) })] }),
+*   createSchema({ type: 'object', properties: [createProperty({ name: 'b', schema: createSchema({ type: 'number' }) })] }),
+* ])
+* ```
 */
-function resolveGroupType({ node, params, groupMethod, resolver }) {
-	if (!params.length) return;
-	const firstParam = params[0];
-	const groupName = groupMethod.call(resolver, node, firstParam);
-	if (groupName === resolver.resolveParamName(node, firstParam)) return;
-	const allOptional = params.every((p) => !p.required);
-	return {
-		type: createTypeNode({
-			variant: "reference",
-			name: groupName
-		}),
-		optional: allOptional
-	};
+function mergeAdjacentObjects(members) {
+	return members.reduce((acc, member) => {
+		const objectMember = narrowSchema(member, "object");
+		if (objectMember && !objectMember.name) {
+			const previous = acc.at(-1);
+			const previousObject = previous ? narrowSchema(previous, "object") : void 0;
+			if (previousObject && !previousObject.name) {
+				acc[acc.length - 1] = createSchema({
+					...previousObject,
+					properties: [...previousObject.properties ?? [], ...objectMember.properties ?? []]
+				});
+				return acc;
+			}
+		}
+		acc.push(member);
+		return acc;
+	}, []);
 }
 /**
-* Builds a {@link TypeNode} with `variant: 'struct'` for an inline anonymous type grouping named fields.
+* Removes enum members that are covered by broader scalar primitives in the same union.
 *
-* Used when query or header parameters have no dedicated group type name.
-* Each language printer renders this appropriately (TypeScript: `{ petId: string; name?: string }`).
+* @example
+* ```ts
+* const simplified = simplifyUnion([
+*   createSchema({ type: 'enum', primitive: 'string', enumValues: ['active'] }),
+*   createSchema({ type: 'string' }),
+* ])
+* // keeps only string member
+* ```
 */
-function toStructType({ node, params, resolver }) {
-	return createTypeNode({
-		variant: "struct",
-		properties: params.map((p) => ({
-			name: p.name,
-			optional: !p.required,
-			type: resolveType({
-				node,
-				param: p,
-				resolver
-			})
-		}))
+function simplifyUnion(members) {
+	const scalarPrimitives = new Set(members.filter((member) => isScalarPrimitive(member.type)).map((m) => m.type));
+	if (!scalarPrimitives.size) return members;
+	return members.filter((member) => {
+		const enumNode = narrowSchema(member, "enum");
+		if (!enumNode) return true;
+		const primitive = enumNode.primitive;
+		if (!primitive) return true;
+		if ((enumNode.namedEnumValues?.length ?? enumNode.enumValues?.length ?? 0) <= 1) return true;
+		if (scalarPrimitives.has(primitive)) return false;
+		if ((primitive === "integer" || primitive === "number") && (scalarPrimitives.has("integer") || scalarPrimitives.has("number"))) return false;
+		return true;
 	});
 }
+function setEnumName(propNode, parentName, propName, enumSuffix) {
+	const enumNode = narrowSchema(propNode, "enum");
+	if (enumNode?.primitive === "boolean") return {
+		...propNode,
+		name: void 0
+	};
+	if (enumNode) return {
+		...propNode,
+		name: enumPropName(parentName, propName, enumSuffix)
+	};
+	return propNode;
+}
 //#endregion
-export { caseParams, childName, collect, collectImports, composeTransformers, createDiscriminantNode, createFunctionParameter, createFunctionParameters, createOperation, createOperationParams, createParameter, createParameterGroup, createPrinterFactory, createProperty, createResponse, createRoot, createSchema, createTypeNode, definePrinter, enumPropName, extractRefName, findDiscriminator, httpMethods, isOperationNode, isScalarPrimitive, isSchemaNode, isStringType, mediaTypes, mergeAdjacentObjects, narrowSchema, schemaTypes, setDiscriminatorEnum, setEnumName, simplifyUnion, syncOptionality, syncSchemaRef, transform, walk };
+export { caseParams, childName, collect, collectImports, composeTransformers, createArrowFunction, createBreak, createConst, createDiscriminantNode, createExport, createFile, createFunction, createFunctionParameter, createFunctionParameters, createImport, createInput, createJsx, createOperation, createOperationParams, createOutput, createParameter, createParameterGroup, createParamsType, createPrinterFactory, createProperty, createResponse, createSchema, createSource, createText, createType, definePrinter, enumPropName, extractRefName, extractStringsFromNodes, findDiscriminator, httpMethods, isInputNode, isOperationNode, isOutputNode, isScalarPrimitive, isSchemaNode, isStringType, mediaTypes, mergeAdjacentObjects, narrowSchema, nodeKinds, schemaTypes, setDiscriminatorEnum, setEnumName, simplifyUnion, syncOptionality, syncSchemaRef, transform, walk };
 
 //# sourceMappingURL=index.js.map