@kubb/plugin-ts 5.0.0-alpha.8 → 5.0.0-beta.10

package/dist/index.js

@@ -1,2 +1,1488 @@
-import { n as pluginTsName, t as pluginTs } from "./plugin-D5NGPj0v.js";
-export { pluginTs, pluginTsName };
+import { t as __name } from "./chunk--u3MIqq1.js";
+import { safePrint } from "@kubb/parser-ts";
+import { File, jsxRenderer } from "@kubb/renderer-jsx";
+import { ast, defineGenerator, definePlugin, defineResolver } from "@kubb/core";
+import { isNumber } from "remeda";
+import ts from "typescript";
+import { Fragment, jsx, jsxs } from "@kubb/renderer-jsx/jsx-runtime";
+//#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.
+*/
+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, "");
+}
+/**
+* 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.
+*
+* Only splits on dots followed by a letter so that version numbers
+* embedded in operationIds (e.g. `v2025.0`) are kept intact.
+*/
+function applyToFileParts(text, transformPart) {
+	const parts = text.split(/\.(?=[a-zA-Z])/);
+	return parts.map((part, i) => transformPart(part, i === parts.length - 1)).join("/");
+}
+/**
+* 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'
+*/
+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
+* pascalCase('hello-world')                  // 'HelloWorld'
+* pascalCase('pet.petId', { isFile: true })  // 'pet/PetId'
+*/
+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);
+}
+/**
+* Converts `text` to snake_case.
+*
+* @example
+* snakeCase('helloWorld')  // 'hello_world'
+* snakeCase('Hello-World') // 'hello_world'
+*/
+function snakeCase(text, { prefix = "", suffix = "" } = {}) {
+	return `${prefix} ${text} ${suffix}`.trim().replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s\-.]+/g, "_").replace(/[^a-zA-Z0-9_]/g, "").toLowerCase().split("_").filter(Boolean).join("_");
+}
+/**
+* Converts `text` to SCREAMING_SNAKE_CASE.
+*
+* @example
+* screamingSnakeCase('helloWorld') // 'HELLO_WORLD'
+*/
+function screamingSnakeCase(text, { prefix = "", suffix = "" } = {}) {
+	return snakeCase(text, {
+		prefix,
+		suffix
+	}).toUpperCase();
+}
+//#endregion
+//#region ../../internals/utils/src/string.ts
+/**
+* Strips a single matching pair of `"..."`, `'...'`, or `` `...` `` from both ends of `text`.
+* Returns the string unchanged when no balanced quote pair is found.
+*
+* @example
+* trimQuotes('"hello"') // 'hello'
+* trimQuotes('hello')   // 'hello'
+*/
+function trimQuotes(text) {
+	if (text.length >= 2) {
+		const first = text[0];
+		const last = text[text.length - 1];
+		if (first === "\"" && last === "\"" || first === "'" && last === "'" || first === "`" && last === "`") return text.slice(1, -1);
+	}
+	return text;
+}
+/**
+* Escapes characters that are not allowed inside JS string literals.
+* Handles quotes, backslashes, and Unicode line terminators (U+2028 / U+2029).
+*
+* @see http://www.ecma-international.org/ecma-262/5.1/#sec-7.8.4
+*
+* @example
+* ```ts
+* jsStringEscape('say "hi"\nbye') // 'say \\"hi\\"\\nbye'
+* ```
+*/
+function jsStringEscape(input) {
+	return `${input}`.replace(/["'\\\n\r\u2028\u2029]/g, (character) => {
+		switch (character) {
+			case "\"":
+			case "'":
+			case "\\": return `\\${character}`;
+			case "\n": return "\\n";
+			case "\r": return "\\r";
+			case "\u2028": return "\\u2028";
+			case "\u2029": return "\\u2029";
+			default: return "";
+		}
+	});
+}
+//#endregion
+//#region ../../internals/utils/src/object.ts
+/**
+* Serializes a primitive value to a JSON string literal, stripping any surrounding quote characters first.
+*
+* @example
+* stringify('hello')   // '"hello"'
+* stringify('"hello"') // '"hello"'
+*/
+function stringify(value) {
+	if (value === void 0 || value === null) return "\"\"";
+	return JSON.stringify(trimQuotes(value.toString()));
+}
+//#endregion
+//#region src/constants.ts
+/**
+* `optionalType` values that cause a property's type to include `| undefined`.
+*/
+const OPTIONAL_ADDS_UNDEFINED = new Set(["undefined", "questionTokenAndUndefined"]);
+/**
+* `optionalType` values that render the property key with a `?` token.
+*/
+const OPTIONAL_ADDS_QUESTION_TOKEN = new Set(["questionToken", "questionTokenAndUndefined"]);
+/**
+* `enumType` values that append a `Key` suffix to the generated enum type alias.
+*/
+const ENUM_TYPES_WITH_KEY_SUFFIX = new Set(["asConst", "asPascalConst"]);
+/**
+* `enumType` values that require a runtime value declaration (object, enum, or literal).
+*/
+const ENUM_TYPES_WITH_RUNTIME_VALUE = new Set([
+	"enum",
+	"asConst",
+	"asPascalConst",
+	"constEnum",
+	"literal",
+	void 0
+]);
+/**
+* `enumType` values whose type declaration is type-only (no runtime value emitted for the type alias).
+*/
+const ENUM_TYPES_WITH_TYPE_ONLY = new Set([
+	"asConst",
+	"asPascalConst",
+	"literal",
+	void 0
+]);
+/**
+* Ordering priority for function parameters: lower = sorted earlier.
+*/
+const PARAM_RANK = {
+	required: 0,
+	optional: 1,
+	withDefault: 2,
+	rest: 3
+};
+//#endregion
+//#region src/factory.ts
+const { SyntaxKind, factory } = ts;
+/**
+* TypeScript AST modifiers for common keywords (async, export, const, static).
+*/
+const modifiers = {
+	async: factory.createModifier(ts.SyntaxKind.AsyncKeyword),
+	export: factory.createModifier(ts.SyntaxKind.ExportKeyword),
+	const: factory.createModifier(ts.SyntaxKind.ConstKeyword),
+	static: factory.createModifier(ts.SyntaxKind.StaticKeyword)
+};
+/**
+* TypeScript syntax kind constants for union, literal, and string types.
+*/
+const syntaxKind = {
+	union: SyntaxKind.UnionType,
+	literalType: SyntaxKind.LiteralType,
+	stringLiteral: SyntaxKind.StringLiteral
+};
+function isNonNullable$1(value) {
+	return value !== null && value !== void 0;
+}
+__name(isNonNullable$1, "isNonNullable");
+function isValidIdentifier(str) {
+	if (!str.length || str.trim() !== str) return false;
+	const node = ts.parseIsolatedEntityName(str, ts.ScriptTarget.Latest);
+	return !!node && node.kind === ts.SyntaxKind.Identifier && ts.identifierToKeywordKind(node.kind) === void 0;
+}
+function propertyName(name) {
+	if (typeof name === "string") return isValidIdentifier(name) ? factory.createIdentifier(name) : factory.createStringLiteral(name);
+	return name;
+}
+const questionToken = factory.createToken(ts.SyntaxKind.QuestionToken);
+/**
+* Creates a question token for optional type annotations.
+* Pass `true` to use the cached token, or provide a pre-created token.
+*/
+function createQuestionToken(token) {
+	if (!token) return;
+	if (token === true) return questionToken;
+	return token;
+}
+/**
+* Creates a TypeScript intersection type node from multiple type nodes.
+* Returns the single node if only one is provided, or wraps in parentheses if requested.
+*/
+function createIntersectionDeclaration({ nodes, withParentheses }) {
+	if (!nodes.length) return null;
+	if (nodes.length === 1) return nodes[0] || null;
+	const node = factory.createIntersectionTypeNode(nodes);
+	if (withParentheses) return factory.createParenthesizedType(node);
+	return node;
+}
+/**
+* Creates a TypeScript array type node.
+* Use `arrayType: 'array'` for bracket syntax (`T[]`), or `'generic'` for `Array<T>`.
+*
+* @example Array bracket syntax
+* `createArrayDeclaration({ nodes: [stringType], arrayType: 'array' }) // → string[]`
+*
+* @example Generic Array syntax
+* `createArrayDeclaration({ nodes: [stringType], arrayType: 'generic' }) // → Array<string>`
+*/
+function createArrayDeclaration({ nodes, arrayType = "array" }) {
+	if (!nodes.length) return factory.createTupleTypeNode([]);
+	if (nodes.length === 1) {
+		const node = nodes[0];
+		if (!node) return null;
+		if (arrayType === "generic") return factory.createTypeReferenceNode(factory.createIdentifier("Array"), [node]);
+		return factory.createArrayTypeNode(node);
+	}
+	const unionType = factory.createUnionTypeNode(nodes);
+	if (arrayType === "generic") return factory.createTypeReferenceNode(factory.createIdentifier("Array"), [unionType]);
+	return factory.createArrayTypeNode(factory.createParenthesizedType(unionType));
+}
+/**
+* Minimum nodes length of 2
+* @example Union type example
+* `string | number`
+*/
+function createUnionDeclaration({ nodes, withParentheses }) {
+	if (!nodes.length) return keywordTypeNodes.any;
+	if (nodes.length === 1) return nodes[0];
+	const node = factory.createUnionTypeNode(nodes);
+	if (withParentheses) return factory.createParenthesizedType(node);
+	return node;
+}
+/**
+* Creates a TypeScript property signature for object/interface members.
+* Supports optional markers, readonly modifiers, and type annotations.
+*/
+function createPropertySignature({ readOnly, modifiers = [], name, questionToken, type }) {
+	return factory.createPropertySignature([...modifiers, readOnly ? factory.createToken(ts.SyntaxKind.ReadonlyKeyword) : void 0].filter((modifier) => modifier !== void 0), propertyName(name), createQuestionToken(questionToken), type);
+}
+/**
+* Creates a function parameter declaration with optional markers, rest parameters, and type annotations.
+*/
+function createParameterSignature(name, { modifiers, dotDotDotToken, questionToken, type, initializer }) {
+	return factory.createParameterDeclaration(modifiers, dotDotDotToken, name, createQuestionToken(questionToken), type, initializer);
+}
+/**
+* Attaches JSDoc comments to an AST node as synthetic leading comments.
+* Filters out undefined comments before attaching.
+*
+* @see https://github.com/microsoft/TypeScript/issues/44151
+*/
+function appendJSDocToNode({ node, comments }) {
+	const filteredComments = comments.filter(Boolean);
+	if (!filteredComments.length) return node;
+	const text = filteredComments.reduce((acc = "", comment = "") => {
+		return `${acc}\n * ${comment.replaceAll("*/", "*\\/")}`;
+	}, "*");
+	return ts.addSyntheticLeadingComment(node, ts.SyntaxKind.MultiLineCommentTrivia, `${text || "*"}\n`, true);
+}
+/**
+* Creates a TypeScript index signature for dynamic property access.
+* Defines the key type (default: `string`) and value type on an object.
+*/
+function createIndexSignature(type, { modifiers, indexName = "key", indexType = factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword) } = {}) {
+	return factory.createIndexSignature(modifiers, [createParameterSignature(indexName, { type: indexType })], type);
+}
+/**
+* Creates a TypeScript type alias declaration with optional modifiers and type parameters.
+*/
+function createTypeAliasDeclaration({ modifiers, name, typeParameters, type }) {
+	return factory.createTypeAliasDeclaration(modifiers, name, typeParameters, type);
+}
+/**
+* Creates a TypeScript interface declaration with optional modifiers, type parameters, and members.
+*/
+function createInterfaceDeclaration({ modifiers, name, typeParameters, members }) {
+	return factory.createInterfaceDeclaration(modifiers, name, typeParameters, void 0, members);
+}
+/**
+* Creates a TypeScript type declaration as either a type alias or interface.
+* Intelligently selects the syntax based on the type structure and attaches JSDoc comments.
+*/
+function createTypeDeclaration({ syntax, isExportable, comments, name, type }) {
+	if (syntax === "interface" && "members" in type) return appendJSDocToNode({
+		node: createInterfaceDeclaration({
+			members: [...type.members],
+			modifiers: isExportable ? [modifiers.export] : [],
+			name,
+			typeParameters: void 0
+		}),
+		comments
+	});
+	return appendJSDocToNode({
+		node: createTypeAliasDeclaration({
+			type,
+			modifiers: isExportable ? [modifiers.export] : [],
+			name,
+			typeParameters: void 0
+		}),
+		comments
+	});
+}
+/**
+* Apply casing transformation to enum keys
+*/
+function applyEnumKeyCasing(key, casing = "none") {
+	if (casing === "none") return key;
+	if (casing === "screamingSnakeCase") return screamingSnakeCase(key);
+	if (casing === "snakeCase") return snakeCase(key);
+	if (casing === "pascalCase") return pascalCase(key);
+	if (casing === "camelCase") return camelCase(key);
+	return key;
+}
+/**
+* Creates a TypeScript enum declaration or equivalent construct in various formats.
+* Returns a tuple of [name node, type node] - name node may be undefined for certain types.
+*
+* @example
+* ```ts
+* const [name, type] = createEnumDeclaration({
+*   type: 'enum',
+*   name: 'petType',
+*   typeName: 'PetType',
+*   enums: [['cat', 'cat'], ['dog', 'dog']],
+* })
+* ```
+*/
+function createEnumDeclaration({ type = "enum", name, typeName, enums, enumKeyCasing = "none" }) {
+	if (type === "literal" || type === "inlineLiteral") return [void 0, factory.createTypeAliasDeclaration([factory.createToken(ts.SyntaxKind.ExportKeyword)], factory.createIdentifier(typeName), void 0, factory.createUnionTypeNode(enums.map(([_key, value]) => {
+		if (isNumber(value)) {
+			if (value < 0) return factory.createLiteralTypeNode(factory.createPrefixUnaryExpression(ts.SyntaxKind.MinusToken, factory.createNumericLiteral(Math.abs(value))));
+			return factory.createLiteralTypeNode(factory.createNumericLiteral(value?.toString()));
+		}
+		if (typeof value === "boolean") return factory.createLiteralTypeNode(value ? factory.createTrue() : factory.createFalse());
+		if (value) return factory.createLiteralTypeNode(factory.createStringLiteral(value.toString()));
+	}).filter((node) => node !== void 0)))];
+	if (type === "enum" || type === "constEnum") return [void 0, factory.createEnumDeclaration([factory.createToken(ts.SyntaxKind.ExportKeyword), type === "constEnum" ? factory.createToken(ts.SyntaxKind.ConstKeyword) : void 0].filter((modifier) => modifier !== void 0), factory.createIdentifier(typeName), enums.map(([key, value]) => {
+		let initializer = factory.createStringLiteral(value?.toString());
+		if (Number.parseInt(value.toString(), 10) === value && isNumber(Number.parseInt(value.toString(), 10))) if (value < 0) initializer = factory.createPrefixUnaryExpression(ts.SyntaxKind.MinusToken, factory.createNumericLiteral(Math.abs(value)));
+		else initializer = factory.createNumericLiteral(value);
+		if (typeof value === "boolean") initializer = value ? factory.createTrue() : factory.createFalse();
+		if (isNumber(Number.parseInt(key.toString(), 10))) {
+			const casingKey = applyEnumKeyCasing(`${typeName}_${key}`, enumKeyCasing);
+			return factory.createEnumMember(propertyName(casingKey), initializer);
+		}
+		if (key) {
+			const casingKey = applyEnumKeyCasing(key.toString(), enumKeyCasing);
+			return factory.createEnumMember(propertyName(casingKey), initializer);
+		}
+	}).filter((member) => member !== void 0))];
+	const identifierName = name;
+	if (enums.length === 0) return [void 0, factory.createTypeAliasDeclaration([factory.createToken(ts.SyntaxKind.ExportKeyword)], factory.createIdentifier(typeName), void 0, factory.createKeywordTypeNode(ts.SyntaxKind.NeverKeyword))];
+	return [factory.createVariableStatement([factory.createToken(ts.SyntaxKind.ExportKeyword)], factory.createVariableDeclarationList([factory.createVariableDeclaration(factory.createIdentifier(identifierName), void 0, void 0, factory.createAsExpression(factory.createObjectLiteralExpression(enums.map(([key, value]) => {
+		let initializer = factory.createStringLiteral(value?.toString());
+		if (isNumber(value)) if (value < 0) initializer = factory.createPrefixUnaryExpression(ts.SyntaxKind.MinusToken, factory.createNumericLiteral(Math.abs(value)));
+		else initializer = factory.createNumericLiteral(value);
+		if (typeof value === "boolean") initializer = value ? factory.createTrue() : factory.createFalse();
+		if (key) {
+			const casingKey = applyEnumKeyCasing(key.toString(), enumKeyCasing);
+			return factory.createPropertyAssignment(propertyName(casingKey), initializer);
+		}
+	}).filter((property) => property !== void 0), true), factory.createTypeReferenceNode(factory.createIdentifier("const"), void 0)))], ts.NodeFlags.Const)), factory.createTypeAliasDeclaration([factory.createToken(ts.SyntaxKind.ExportKeyword)], factory.createIdentifier(typeName), void 0, factory.createIndexedAccessTypeNode(factory.createParenthesizedType(factory.createTypeQueryNode(factory.createIdentifier(identifierName), void 0)), factory.createTypeOperatorNode(ts.SyntaxKind.KeyOfKeyword, factory.createTypeQueryNode(factory.createIdentifier(identifierName), void 0))))];
+}
+/**
+* Creates a TypeScript `Omit<T, Keys>` type reference node.
+* Optionally wraps the type in `NonNullable<T>` if `nonNullable` is true.
+*/
+function createOmitDeclaration({ keys, type, nonNullable }) {
+	const node = nonNullable ? factory.createTypeReferenceNode(factory.createIdentifier("NonNullable"), [type]) : type;
+	if (Array.isArray(keys)) return factory.createTypeReferenceNode(factory.createIdentifier("Omit"), [node, factory.createUnionTypeNode(keys.map((key) => {
+		return factory.createLiteralTypeNode(factory.createStringLiteral(key));
+	}))]);
+	return factory.createTypeReferenceNode(factory.createIdentifier("Omit"), [node, factory.createLiteralTypeNode(factory.createStringLiteral(keys))]);
+}
+/**
+* Pre-built TypeScript keyword type nodes for common primitive types.
+* Use these to avoid repeatedly creating the same type nodes.
+*/
+const keywordTypeNodes = {
+	any: factory.createKeywordTypeNode(ts.SyntaxKind.AnyKeyword),
+	unknown: factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword),
+	void: factory.createKeywordTypeNode(ts.SyntaxKind.VoidKeyword),
+	number: factory.createKeywordTypeNode(ts.SyntaxKind.NumberKeyword),
+	integer: factory.createKeywordTypeNode(ts.SyntaxKind.NumberKeyword),
+	bigint: factory.createKeywordTypeNode(ts.SyntaxKind.BigIntKeyword),
+	object: factory.createKeywordTypeNode(ts.SyntaxKind.ObjectKeyword),
+	string: factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword),
+	boolean: factory.createKeywordTypeNode(ts.SyntaxKind.BooleanKeyword),
+	undefined: factory.createKeywordTypeNode(ts.SyntaxKind.UndefinedKeyword),
+	null: factory.createLiteralTypeNode(factory.createToken(ts.SyntaxKind.NullKeyword)),
+	never: factory.createKeywordTypeNode(ts.SyntaxKind.NeverKeyword)
+};
+/**
+* Converts a path like '/pet/{petId}/uploadImage' to a template literal type
+* like `/pet/${string}/uploadImage`
+*/
+/**
+* Converts an OAS-style path (e.g. `/pets/{petId}`) or an Express-style path
+* (e.g. `/pets/:petId`) to a TypeScript template literal type
+* like `` `/pets/${string}` ``.
+*/
+function createUrlTemplateType(path) {
+	const normalized = path.replace(/:([^/]+)/g, "{$1}");
+	if (!normalized.includes("{")) return factory.createLiteralTypeNode(factory.createStringLiteral(normalized));
+	const segments = normalized.split(/(\{[^}]+\})/);
+	const parts = [];
+	const parameterIndices = [];
+	segments.forEach((segment) => {
+		if (segment.startsWith("{") && segment.endsWith("}")) {
+			parameterIndices.push(parts.length);
+			parts.push(segment);
+		} else if (segment) parts.push(segment);
+	});
+	const head = ts.factory.createTemplateHead(parts[0] || "");
+	const templateSpans = [];
+	parameterIndices.forEach((paramIndex, i) => {
+		const isLast = i === parameterIndices.length - 1;
+		const nextPart = parts[paramIndex + 1] || "";
+		const literal = isLast ? ts.factory.createTemplateTail(nextPart) : ts.factory.createTemplateMiddle(nextPart);
+		templateSpans.push(ts.factory.createTemplateLiteralTypeSpan(keywordTypeNodes.string, literal));
+	});
+	return ts.factory.createTemplateLiteralType(head, templateSpans);
+}
+/**
+* Creates a TypeScript type literal node (anonymous object type).
+*/
+const createTypeLiteralNode = factory.createTypeLiteralNode;
+/**
+* Creates a TypeScript type reference node (e.g., `Array<string>`, `Record<K, V>`).
+*/
+const createTypeReferenceNode = factory.createTypeReferenceNode;
+/**
+* Creates a numeric literal type node.
+*/
+const createNumericLiteral = factory.createNumericLiteral;
+/**
+* Creates a string literal type node.
+*/
+const createStringLiteral = factory.createStringLiteral;
+/**
+* Creates an array type node (e.g., `T[]`).
+*/
+const createArrayTypeNode = factory.createArrayTypeNode;
+factory.createParenthesizedType;
+/**
+* Creates a literal type node (e.g., `'hello'`, `42`, `true`).
+*/
+const createLiteralTypeNode = factory.createLiteralTypeNode;
+factory.createNull;
+/**
+* Creates an identifier node.
+*/
+const createIdentifier = factory.createIdentifier;
+/**
+* Creates an optional type node (e.g., `T | undefined`).
+*/
+const createOptionalTypeNode = factory.createOptionalTypeNode;
+/**
+* Creates a tuple type node (e.g., `[string, number]`).
+*/
+const createTupleTypeNode = factory.createTupleTypeNode;
+/**
+* Creates a rest type node for variadic tuple elements (e.g., `...T[]`).
+*/
+const createRestTypeNode = factory.createRestTypeNode;
+/**
+* Creates a boolean true literal type node.
+*/
+const createTrue = factory.createTrue;
+/**
+* Creates a boolean false literal type node.
+*/
+const createFalse = factory.createFalse;
+factory.createIndexedAccessTypeNode;
+factory.createTypeOperatorNode;
+/**
+* Creates a prefix unary expression (e.g., negative numbers, logical not).
+*/
+const createPrefixUnaryExpression = factory.createPrefixUnaryExpression;
+/**
+* Converts a primitive const value to a TypeScript literal type node.
+* Handles negative numbers via a prefix unary expression.
+*/
+function constToTypeNode(value, format) {
+	if (format === "boolean") return createLiteralTypeNode(value === true ? createTrue() : createFalse());
+	if (format === "number" && typeof value === "number") {
+		if (value < 0) return createLiteralTypeNode(createPrefixUnaryExpression(SyntaxKind.MinusToken, createNumericLiteral(Math.abs(value))));
+		return createLiteralTypeNode(createNumericLiteral(value));
+	}
+	return createLiteralTypeNode(createStringLiteral(String(value)));
+}
+/**
+* Returns a `Date` reference type node when `representation` is `'date'`, otherwise falls back to `string`.
+*/
+function dateOrStringNode(node) {
+	return node.representation === "date" ? createTypeReferenceNode(createIdentifier("Date")) : keywordTypeNodes.string;
+}
+/**
+* Maps an array of `SchemaNode`s through the printer, filtering out `null` and `undefined` results.
+*/
+function buildMemberNodes(members, print) {
+	return (members ?? []).map(print).filter(isNonNullable$1);
+}
+/**
+* Builds a TypeScript tuple type node from an array schema's `items`,
+* applying min/max slice and optional/rest element rules.
+*/
+function buildTupleNode(node, print) {
+	let items = (node.items ?? []).map(print).filter(isNonNullable$1);
+	const restNode = node.rest ? print(node.rest) ?? void 0 : void 0;
+	const { min, max } = node;
+	if (max !== void 0) {
+		items = items.slice(0, max);
+		if (items.length < max && restNode) items = [...items, ...Array(max - items.length).fill(restNode)];
+	}
+	if (min !== void 0) items = items.map((item, i) => i >= min ? createOptionalTypeNode(item) : item);
+	if (max === void 0 && restNode) items.push(createRestTypeNode(createArrayTypeNode(restNode)));
+	return createTupleTypeNode(items);
+}
+/**
+* Applies `nullable` and optional/nullish `| undefined` union modifiers to a property's resolved base type.
+*/
+function buildPropertyType(schema, baseType, optionalType) {
+	const addsUndefined = OPTIONAL_ADDS_UNDEFINED.has(optionalType);
+	const meta = ast.syncSchemaRef(schema);
+	let type = baseType;
+	if (meta.nullable) type = createUnionDeclaration({ nodes: [type, keywordTypeNodes.null] });
+	if ((meta.nullish || meta.optional) && addsUndefined) type = createUnionDeclaration({ nodes: [type, keywordTypeNodes.undefined] });
+	return type;
+}
+/**
+* Creates TypeScript index signatures for `additionalProperties` and `patternProperties` on an object schema node.
+*/
+function buildIndexSignatures(node, propertyCount, print) {
+	const elements = [];
+	if (node.additionalProperties && node.additionalProperties !== true) {
+		const additionalType = print(node.additionalProperties) ?? keywordTypeNodes.unknown;
+		elements.push(createIndexSignature(propertyCount > 0 ? keywordTypeNodes.unknown : additionalType));
+	} else if (node.additionalProperties === true) elements.push(createIndexSignature(keywordTypeNodes.unknown));
+	if (node.patternProperties) {
+		const first = Object.values(node.patternProperties)[0];
+		if (first) {
+			let patternType = print(first) ?? keywordTypeNodes.unknown;
+			if (first.nullable) patternType = createUnionDeclaration({ nodes: [patternType, keywordTypeNodes.null] });
+			elements.push(createIndexSignature(patternType));
+		}
+	}
+	return elements;
+}
+//#endregion
+//#region src/components/Enum.tsx
+/**
+* Resolves the runtime identifier name and the TypeScript type name for an enum schema node.
+*
+* The raw `node.name` may be a YAML key such as `"enumNames.Type"` which is not a
+* valid TypeScript identifier. The resolver normalizes it; for inline enum
+* properties the adapter already emits a PascalCase+suffix name so resolution is typically a no-op.
+*/
+function getEnumNames({ node, enumType, enumTypeSuffix, resolver }) {
+	const resolved = resolver.default(node.name, "type");
+	return {
+		enumName: enumType === "asPascalConst" ? resolved : camelCase(node.name),
+		typeName: ENUM_TYPES_WITH_KEY_SUFFIX.has(enumType) ? resolver.resolveEnumKeyName(node, enumTypeSuffix) : resolved
+	};
+}
+/**
+* Renders the enum declaration(s) for a single named `EnumSchemaNode`.
+*
+* Depending on `enumType` this may emit:
+* - A runtime object (`asConst` / `asPascalConst`) plus a `typeof` type alias
+* - A `const enum` or plain `enum` declaration (`constEnum` / `enum`)
+* - A union literal type alias (`literal`)
+*
+* The emitted `File.Source` nodes carry the resolved names so that the barrel
+* index picks up the correct export identifiers.
+*/
+function Enum({ node, enumType, enumTypeSuffix, enumKeyCasing, resolver }) {
+	const { enumName, typeName } = getEnumNames({
+		node,
+		enumType,
+		enumTypeSuffix,
+		resolver
+	});
+	const [nameNode, typeNode] = createEnumDeclaration({
+		name: enumName,
+		typeName,
+		enums: node.namedEnumValues?.map((v) => [trimQuotes(v.name.toString()), v.value]) ?? node.enumValues?.filter((v) => v !== null && v !== void 0).map((v) => [trimQuotes(v.toString()), v]) ?? [],
+		type: enumType,
+		enumKeyCasing
+	});
+	return /* @__PURE__ */ jsxs(Fragment, { children: [nameNode && /* @__PURE__ */ jsx(File.Source, {
+		name: enumName,
+		isExportable: true,
+		isIndexable: true,
+		isTypeOnly: false,
+		children: safePrint(nameNode)
+	}), /* @__PURE__ */ jsx(File.Source, {
+		name: typeName,
+		isIndexable: true,
+		isExportable: ENUM_TYPES_WITH_RUNTIME_VALUE.has(enumType),
+		isTypeOnly: ENUM_TYPES_WITH_TYPE_ONLY.has(enumType),
+		children: safePrint(typeNode)
+	})] });
+}
+//#endregion
+//#region src/components/Type.tsx
+function Type({ name, node, printer, enumType, enumTypeSuffix, enumKeyCasing, resolver }) {
+	const enumSchemaNodes = ast.collect(node, { schema(n) {
+		const enumNode = ast.narrowSchema(n, ast.schemaTypes.enum);
+		if (enumNode?.name) return enumNode;
+	} });
+	const output = printer.print(node);
+	if (!output) return;
+	const enums = [...new Map(enumSchemaNodes.map((n) => [n.name, n])).values()].map((node) => {
+		return {
+			node,
+			...getEnumNames({
+				node,
+				enumType,
+				enumTypeSuffix,
+				resolver
+			})
+		};
+	});
+	const shouldExportEnums = enumType !== "inlineLiteral";
+	const shouldExportType = enumType === "inlineLiteral" || enums.every((item) => item.typeName !== name);
+	return /* @__PURE__ */ jsxs(Fragment, { children: [shouldExportEnums && enums.map(({ node }) => /* @__PURE__ */ jsx(Enum, {
+		node,
+		enumType,
+		enumTypeSuffix,
+		enumKeyCasing,
+		resolver
+	}, node.name)), shouldExportType && /* @__PURE__ */ jsx(File.Source, {
+		name,
+		isTypeOnly: true,
+		isExportable: true,
+		isIndexable: true,
+		children: output
+	})] });
+}
+//#endregion
+//#region ../../internals/shared/src/operation.ts
+function getOperationParameters(node, options = {}) {
+	const params = ast.caseParams(node.parameters, options.paramsCasing);
+	return {
+		path: params.filter((param) => param.in === "path"),
+		query: params.filter((param) => param.in === "query"),
+		header: params.filter((param) => param.in === "header"),
+		cookie: params.filter((param) => param.in === "cookie")
+	};
+}
+//#endregion
+//#region src/utils.ts
+/**
+* Collects JSDoc annotation strings for a schema node.
+*
+* Only uses official JSDoc tags from https://jsdoc.app/: `@description`, `@deprecated`, `@default`, `@example`, `@type`.
+* Constraint metadata (min/max length, pattern, multipleOf, min/maxProperties) is emitted as plain-text lines.
+
+*/
+function buildPropertyJSDocComments(schema) {
+	const meta = ast.syncSchemaRef(schema);
+	const isArray = meta?.primitive === "array";
+	return [
+		meta && "description" in meta && meta.description ? `@description ${jsStringEscape(meta.description)}` : void 0,
+		meta && "deprecated" in meta && meta.deprecated ? "@deprecated" : void 0,
+		!isArray && meta && "min" in meta && meta.min !== void 0 ? `@minLength ${meta.min}` : void 0,
+		!isArray && meta && "max" in meta && meta.max !== void 0 ? `@maxLength ${meta.max}` : void 0,
+		meta && "pattern" in meta && meta.pattern ? `@pattern ${meta.pattern}` : void 0,
+		meta && "default" in meta && meta.default !== void 0 ? `@default ${"primitive" in meta && meta.primitive === "string" ? stringify(meta.default) : meta.default}` : void 0,
+		meta && "example" in meta && meta.example !== void 0 ? `@example ${meta.example}` : void 0,
+		meta && "primitive" in meta && meta.primitive ? [`@type ${meta.primitive}`, "optional" in schema && schema.optional ? " | undefined" : void 0].filter(Boolean).join("") : void 0
+	].filter(Boolean);
+}
+function buildParams(node, { params, resolver }) {
+	return ast.createSchema({
+		type: "object",
+		properties: params.map((param) => ast.createProperty({
+			name: param.name,
+			required: param.required,
+			schema: ast.createSchema({
+				type: "ref",
+				name: resolver.resolveParamName(node, param)
+			})
+		}))
+	});
+}
+function buildData(node, { resolver }) {
+	const { path: pathParams, query: queryParams, header: headerParams } = getOperationParameters(node);
+	return ast.createSchema({
+		type: "object",
+		deprecated: node.deprecated,
+		properties: [
+			ast.createProperty({
+				name: "data",
+				schema: node.requestBody?.content?.[0]?.schema ? ast.createSchema({
+					type: "ref",
+					name: resolver.resolveDataName(node),
+					optional: true
+				}) : ast.createSchema({
+					type: "never",
+					primitive: void 0,
+					optional: true
+				})
+			}),
+			ast.createProperty({
+				name: "pathParams",
+				required: pathParams.length > 0,
+				schema: pathParams.length > 0 ? buildParams(node, {
+					params: pathParams,
+					resolver
+				}) : ast.createSchema({
+					type: "never",
+					primitive: void 0
+				})
+			}),
+			ast.createProperty({
+				name: "queryParams",
+				schema: queryParams.length > 0 ? ast.createSchema({
+					...buildParams(node, {
+						params: queryParams,
+						resolver
+					}),
+					optional: true
+				}) : ast.createSchema({
+					type: "never",
+					primitive: void 0,
+					optional: true
+				})
+			}),
+			ast.createProperty({
+				name: "headerParams",
+				schema: headerParams.length > 0 ? ast.createSchema({
+					...buildParams(node, {
+						params: headerParams,
+						resolver
+					}),
+					optional: true
+				}) : ast.createSchema({
+					type: "never",
+					primitive: void 0,
+					optional: true
+				})
+			}),
+			ast.createProperty({
+				name: "url",
+				required: true,
+				schema: ast.createSchema({
+					type: "url",
+					path: node.path
+				})
+			})
+		]
+	});
+}
+function buildResponses(node, { resolver }) {
+	if (node.responses.length === 0) return null;
+	return ast.createSchema({
+		type: "object",
+		properties: node.responses.map((res) => ast.createProperty({
+			name: String(res.statusCode),
+			required: true,
+			schema: ast.createSchema({
+				type: "ref",
+				name: resolver.resolveResponseStatusName(node, res.statusCode)
+			})
+		}))
+	});
+}
+function buildResponseUnion(node, { resolver }) {
+	const responsesWithSchema = node.responses.filter((res) => res.schema);
+	if (responsesWithSchema.length === 0) return null;
+	return ast.createSchema({
+		type: "union",
+		members: responsesWithSchema.map((res) => ast.createSchema({
+			type: "ref",
+			name: resolver.resolveResponseStatusName(node, res.statusCode)
+		}))
+	});
+}
+//#endregion
+//#region src/printers/printerTs.ts
+function isNonNullable(value) {
+	return value !== null && value !== void 0;
+}
+/**
+* TypeScript type printer built with `definePrinter`.
+*
+* Converts a `SchemaNode` AST node into a TypeScript AST node:
+* - **`printer.print(node)`** — when `options.typeName` is set, returns a full
+*   `type Name = …` or `interface Name { … }` declaration (`ts.Node`).
+*   Without `typeName`, returns the raw `ts.TypeNode` for the schema.
+*
+* Dispatches on `node.type` to the appropriate handler in `nodes`. Options are closed
+* over per printer instance, so each call to `printerTs(options)` produces an independent printer.
+*
+* @example Raw type node (no `typeName`)
+* ```ts
+* const printer = printerTs({ optionalType: 'questionToken', arrayType: 'array', enumType: 'inlineLiteral' })
+* const typeNode = printer.print(schemaNode) // ts.TypeNode
+* ```
+*
+* @example Full declaration (with `typeName`)
+* ```ts
+* const printer = printerTs({ optionalType: 'questionToken', arrayType: 'array', enumType: 'inlineLiteral', typeName: 'MyType' })
+* const declaration = printer.print(schemaNode) // ts.TypeAliasDeclaration | ts.InterfaceDeclaration
+* ```
+*/
+const printerTs = ast.definePrinter((options) => {
+	const addsUndefined = OPTIONAL_ADDS_UNDEFINED.has(options.optionalType);
+	return {
+		name: "typescript",
+		options,
+		nodes: {
+			any: () => keywordTypeNodes.any,
+			unknown: () => keywordTypeNodes.unknown,
+			void: () => keywordTypeNodes.void,
+			never: () => keywordTypeNodes.never,
+			boolean: () => keywordTypeNodes.boolean,
+			null: () => keywordTypeNodes.null,
+			blob: () => createTypeReferenceNode("Blob", []),
+			string: () => keywordTypeNodes.string,
+			uuid: () => keywordTypeNodes.string,
+			email: () => keywordTypeNodes.string,
+			url: (node) => {
+				if (node.path) return createUrlTemplateType(node.path);
+				return keywordTypeNodes.string;
+			},
+			ipv4: () => keywordTypeNodes.string,
+			ipv6: () => keywordTypeNodes.string,
+			datetime: () => keywordTypeNodes.string,
+			number: () => keywordTypeNodes.number,
+			integer: () => keywordTypeNodes.number,
+			bigint: () => keywordTypeNodes.bigint,
+			date: dateOrStringNode,
+			time: dateOrStringNode,
+			ref(node) {
+				if (!node.name) return;
+				const refName = node.ref ? ast.extractRefName(node.ref) ?? node.name : node.name;
+				return createTypeReferenceNode(node.ref && ENUM_TYPES_WITH_KEY_SUFFIX.has(this.options.enumType) && this.options.enumTypeSuffix && this.options.enumSchemaNames?.has(refName) ? this.options.resolver.resolveEnumKeyName({ name: refName }, this.options.enumTypeSuffix) : node.ref ? this.options.resolver.default(refName, "type") : refName, void 0);
+			},
+			enum(node) {
+				const values = node.namedEnumValues?.map((v) => v.value) ?? node.enumValues ?? [];
+				if (this.options.enumType === "inlineLiteral" || !node.name) return createUnionDeclaration({
+					withParentheses: true,
+					nodes: values.filter((v) => v !== null && v !== void 0).map((value) => constToTypeNode(value, typeof value)).filter(isNonNullable)
+				}) ?? void 0;
+				return createTypeReferenceNode(ENUM_TYPES_WITH_KEY_SUFFIX.has(this.options.enumType) && this.options.enumTypeSuffix ? this.options.resolver.resolveEnumKeyName(node, this.options.enumTypeSuffix) : this.options.resolver.default(node.name, "type"), void 0);
+			},
+			union(node) {
+				const members = node.members ?? [];
+				const hasStringLiteral = members.some((m) => {
+					return ast.narrowSchema(m, ast.schemaTypes.enum)?.primitive === "string";
+				});
+				const hasPlainString = members.some((m) => ast.isStringType(m));
+				if (hasStringLiteral && hasPlainString) return createUnionDeclaration({
+					withParentheses: true,
+					nodes: members.map((m) => {
+						if (ast.isStringType(m)) return createIntersectionDeclaration({
+							nodes: [keywordTypeNodes.string, createTypeLiteralNode([])],
+							withParentheses: true
+						});
+						return this.transform(m);
+					}).filter(isNonNullable)
+				}) ?? void 0;
+				return createUnionDeclaration({
+					withParentheses: true,
+					nodes: buildMemberNodes(members, this.transform)
+				}) ?? void 0;
+			},
+			intersection(node) {
+				return createIntersectionDeclaration({
+					withParentheses: true,
+					nodes: buildMemberNodes(node.members, this.transform)
+				}) ?? void 0;
+			},
+			array(node) {
+				return createArrayDeclaration({
+					nodes: (node.items ?? []).map((item) => this.transform(item)).filter(isNonNullable),
+					arrayType: this.options.arrayType
+				}) ?? void 0;
+			},
+			tuple(node) {
+				return buildTupleNode(node, this.transform);
+			},
+			object(node) {
+				const { transform, options } = this;
+				const addsQuestionToken = OPTIONAL_ADDS_QUESTION_TOKEN.has(options.optionalType);
+				const propertyNodes = node.properties.map((prop) => {
+					const baseType = transform(prop.schema) ?? keywordTypeNodes.unknown;
+					const type = buildPropertyType(prop.schema, baseType, options.optionalType);
+					const propMeta = ast.syncSchemaRef(prop.schema);
+					return appendJSDocToNode({
+						node: createPropertySignature({
+							questionToken: prop.schema.optional || prop.schema.nullish ? addsQuestionToken : false,
+							name: prop.name,
+							type,
+							readOnly: propMeta?.readOnly
+						}),
+						comments: buildPropertyJSDocComments(prop.schema)
+					});
+				});
+				const allElements = [...propertyNodes, ...buildIndexSignatures(node, propertyNodes.length, transform)];
+				if (!allElements.length) return keywordTypeNodes.object;
+				return createTypeLiteralNode(allElements);
+			},
+			...options.nodes
+		},
+		print(node) {
+			const { name, syntaxType = "type", description, keysToOmit } = this.options;
+			let base = this.transform(node);
+			if (!base) return null;
+			const meta = ast.syncSchemaRef(node);
+			if (!name) {
+				if (meta.nullable) base = createUnionDeclaration({ nodes: [base, keywordTypeNodes.null] });
+				if ((meta.nullish || meta.optional) && addsUndefined) base = createUnionDeclaration({ nodes: [base, keywordTypeNodes.undefined] });
+				return safePrint(base);
+			}
+			let inner = keysToOmit?.length ? createOmitDeclaration({
+				keys: keysToOmit,
+				type: base,
+				nonNullable: true
+			}) : base;
+			if (meta.nullable) inner = createUnionDeclaration({ nodes: [inner, keywordTypeNodes.null] });
+			if (meta.nullish || meta.optional) inner = createUnionDeclaration({ nodes: [inner, keywordTypeNodes.undefined] });
+			const useTypeGeneration = syntaxType === "type" || inner.kind === syntaxKind.union || !!keysToOmit?.length;
+			return safePrint(createTypeDeclaration({
+				name,
+				isExportable: true,
+				type: inner,
+				syntax: useTypeGeneration ? "type" : "interface",
+				comments: buildPropertyJSDocComments({
+					...meta,
+					description
+				})
+			}));
+		}
+	};
+});
+//#endregion
+//#region src/generators/typeGenerator.tsx
+function getContentTypeSuffix(contentType) {
+	const baseType = contentType.split(";")[0].trim();
+	if (baseType === "application/json") return "Json";
+	if (baseType === "multipart/form-data") return "FormData";
+	if (baseType === "application/x-www-form-urlencoded") return "FormUrlEncoded";
+	const parts = (baseType.split("/").pop() ?? baseType).split(/[^a-zA-Z0-9]+/).filter(Boolean);
+	if (parts.length === 0) return "Unknown";
+	return parts.map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+}
+function getPerContentTypeName(dataName, suffix) {
+	if (dataName.endsWith("Data")) return suffix.endsWith("Data") ? dataName.slice(0, -4) + suffix : `${dataName.slice(0, -4)}${suffix}Data`;
+	return dataName + suffix;
+}
+const typeGenerator = defineGenerator({
+	name: "typescript",
+	renderer: jsxRenderer,
+	schema(node, ctx) {
+		const { enumType, enumTypeSuffix, enumKeyCasing, syntaxType, optionalType, arrayType, output, group, printer } = ctx.options;
+		const { adapter, config, resolver, root } = ctx;
+		if (!node.name) return;
+		const mode = ctx.getMode(output);
+		const enumSchemaNames = new Set((adapter.inputNode?.schemas ?? []).filter((s) => ast.narrowSchema(s, ast.schemaTypes.enum) && s.name).map((s) => s.name));
+		function resolveImportName(schemaName) {
+			if (ENUM_TYPES_WITH_KEY_SUFFIX.has(enumType) && enumTypeSuffix && enumSchemaNames.has(schemaName)) return resolver.resolveEnumKeyName({ name: schemaName }, enumTypeSuffix);
+			return resolver.resolveTypeName(schemaName);
+		}
+		const imports = adapter.getImports(node, (schemaName) => ({
+			name: resolveImportName(schemaName),
+			path: resolver.resolveFile({
+				name: schemaName,
+				extname: ".ts"
+			}, {
+				root,
+				output,
+				group
+			}).path
+		}));
+		const isEnumSchema = !!ast.narrowSchema(node, ast.schemaTypes.enum);
+		const meta = {
+			name: ENUM_TYPES_WITH_KEY_SUFFIX.has(enumType) && isEnumSchema ? resolver.resolveEnumKeyName(node, enumTypeSuffix) : resolver.resolveTypeName(node.name),
+			file: resolver.resolveFile({
+				name: node.name,
+				extname: ".ts"
+			}, {
+				root,
+				output,
+				group
+			})
+		};
+		const schemaPrinter = printerTs({
+			optionalType,
+			arrayType,
+			enumType,
+			enumTypeSuffix,
+			name: meta.name,
+			syntaxType,
+			description: node.description,
+			resolver,
+			enumSchemaNames,
+			nodes: printer?.nodes
+		});
+		return /* @__PURE__ */ jsxs(File, {
+			baseName: meta.file.baseName,
+			path: meta.file.path,
+			meta: meta.file.meta,
+			banner: resolver.resolveBanner(adapter.inputNode, {
+				output,
+				config
+			}),
+			footer: resolver.resolveFooter(adapter.inputNode, {
+				output,
+				config
+			}),
+			children: [mode === "split" && imports.map((imp) => /* @__PURE__ */ jsx(File.Import, {
+				root: meta.file.path,
+				path: imp.path,
+				name: imp.name,
+				isTypeOnly: true
+			}, [
+				node.name,
+				imp.path,
+				imp.isTypeOnly
+			].join("-"))), /* @__PURE__ */ jsx(Type, {
+				name: meta.name,
+				node,
+				enumType,
+				enumTypeSuffix,
+				enumKeyCasing,
+				resolver,
+				printer: schemaPrinter
+			})]
+		});
+	},
+	operation(node, ctx) {
+		const { enumType, enumTypeSuffix, enumKeyCasing, optionalType, arrayType, syntaxType, paramsCasing, group, output, printer } = ctx.options;
+		const { adapter, config, resolver, root } = ctx;
+		const mode = ctx.getMode(output);
+		const params = ast.caseParams(node.parameters, paramsCasing);
+		const meta = { file: resolver.resolveFile({
+			name: node.operationId,
+			extname: ".ts",
+			tag: node.tags[0] ?? "default",
+			path: node.path
+		}, {
+			root,
+			output,
+			group
+		}) };
+		const enumSchemaNames = new Set((adapter.inputNode?.schemas ?? []).filter((s) => ast.narrowSchema(s, ast.schemaTypes.enum) && s.name).map((s) => s.name));
+		function resolveImportName(schemaName) {
+			if (ENUM_TYPES_WITH_KEY_SUFFIX.has(enumType) && enumTypeSuffix && enumSchemaNames.has(schemaName)) return resolver.resolveEnumKeyName({ name: schemaName }, enumTypeSuffix);
+			return resolver.resolveTypeName(schemaName);
+		}
+		function renderSchemaType({ schema, name, keysToOmit }) {
+			if (!schema) return null;
+			const imports = adapter.getImports(schema, (schemaName) => ({
+				name: resolveImportName(schemaName),
+				path: resolver.resolveFile({
+					name: schemaName,
+					extname: ".ts"
+				}, {
+					root,
+					output,
+					group
+				}).path
+			}));
+			const schemaPrinter = printerTs({
+				optionalType,
+				arrayType,
+				enumType,
+				enumTypeSuffix,
+				name,
+				syntaxType,
+				description: schema.description,
+				keysToOmit,
+				resolver,
+				enumSchemaNames,
+				nodes: printer?.nodes
+			});
+			return /* @__PURE__ */ jsxs(Fragment, { children: [mode === "split" && imports.map((imp) => /* @__PURE__ */ jsx(File.Import, {
+				root: meta.file.path,
+				path: imp.path,
+				name: imp.name,
+				isTypeOnly: true
+			}, [
+				name,
+				imp.path,
+				imp.isTypeOnly
+			].join("-"))), /* @__PURE__ */ jsx(Type, {
+				name,
+				node: schema,
+				enumType,
+				enumTypeSuffix,
+				enumKeyCasing,
+				resolver,
+				printer: schemaPrinter
+			})] });
+		}
+		const paramTypes = params.map((param) => renderSchemaType({
+			schema: param.schema,
+			name: resolver.resolveParamName(node, param)
+		}));
+		const requestBodyContent = node.requestBody?.content ?? [];
+		function buildRequestType() {
+			if (requestBodyContent.length === 0) return null;
+			if (requestBodyContent.length === 1) {
+				const entry = requestBodyContent[0];
+				if (!entry.schema) return null;
+				return renderSchemaType({
+					schema: {
+						...entry.schema,
+						description: node.requestBody.description ?? entry.schema.description
+					},
+					name: resolver.resolveDataName(node),
+					keysToOmit: entry.keysToOmit
+				});
+			}
+			const dataName = resolver.resolveDataName(node);
+			const usedNames = /* @__PURE__ */ new Set();
+			const individualItems = requestBodyContent.filter((entry) => entry.schema).map((entry) => {
+				const baseSuffix = getContentTypeSuffix(entry.contentType);
+				let individualName = getPerContentTypeName(dataName, baseSuffix);
+				let counter = 2;
+				while (usedNames.has(individualName)) individualName = getPerContentTypeName(dataName, `${baseSuffix}${counter++}`);
+				usedNames.add(individualName);
+				return {
+					name: individualName,
+					rendered: renderSchemaType({
+						schema: {
+							...entry.schema,
+							description: node.requestBody.description ?? entry.schema.description
+						},
+						name: individualName,
+						keysToOmit: entry.keysToOmit
+					})
+				};
+			});
+			const unionType = renderSchemaType({
+				schema: ast.createSchema({
+					type: "union",
+					members: individualItems.map((item) => ast.createSchema({
+						type: "ref",
+						name: item.name
+					}))
+				}),
+				name: dataName
+			});
+			return /* @__PURE__ */ jsxs(Fragment, { children: [individualItems.map((item) => item.rendered), unionType] });
+		}
+		const requestType = buildRequestType();
+		const responseTypes = node.responses.map((res) => renderSchemaType({
+			schema: res.schema,
+			name: resolver.resolveResponseStatusName(node, res.statusCode),
+			keysToOmit: res.keysToOmit
+		}));
+		const dataType = renderSchemaType({
+			schema: buildData({
+				...node,
+				parameters: params
+			}, { resolver }),
+			name: resolver.resolveRequestConfigName(node)
+		});
+		const responsesType = renderSchemaType({
+			schema: buildResponses(node, { resolver }),
+			name: resolver.resolveResponsesName(node)
+		});
+		function buildResponseType() {
+			if (!node.responses.some((res) => res.schema)) return null;
+			const responseName = resolver.resolveResponseName(node);
+			const responsesWithSchema = node.responses.filter((res) => res.schema);
+			if (new Set(responsesWithSchema.flatMap((res) => res.schema ? adapter.getImports(res.schema, (schemaName) => ({
+				name: resolveImportName(schemaName),
+				path: ""
+			})).flatMap((imp) => Array.isArray(imp.name) ? imp.name : [imp.name]) : [])).has(responseName)) return null;
+			return renderSchemaType({
+				schema: {
+					...buildResponseUnion(node, { resolver }),
+					description: "Union of all possible responses"
+				},
+				name: responseName
+			});
+		}
+		const responseType = buildResponseType();
+		return /* @__PURE__ */ jsxs(File, {
+			baseName: meta.file.baseName,
+			path: meta.file.path,
+			meta: meta.file.meta,
+			banner: resolver.resolveBanner(adapter.inputNode, {
+				output,
+				config
+			}),
+			footer: resolver.resolveFooter(adapter.inputNode, {
+				output,
+				config
+			}),
+			children: [
+				paramTypes,
+				responseTypes,
+				requestType,
+				dataType,
+				responsesType,
+				responseType
+			]
+		});
+	}
+});
+//#endregion
+//#region src/resolvers/resolverTs.ts
+/**
+* Resolver for `@kubb/plugin-ts` that provides the default naming and path-resolution
+* helpers used by the plugin. Import this in other plugins to resolve the exact names and
+* paths that `plugin-ts` generates without hardcoding the conventions.
+*
+* The `default` method is automatically injected by `defineResolver` — it uses `camelCase`
+* for identifiers/files and `pascalCase` for type names.
+*
+* @example
+* ```ts
+* import { resolver } from '@kubb/plugin-ts'
+*
+* resolver.default('list pets', 'type')              // → 'ListPets'
+* resolver.resolveName('list pets status 200')        // → 'ListPetsStatus200'
+* resolver.resolvePathName('list pets', 'file')       // → 'listPets'
+* ```
+*/
+const resolverTs = defineResolver(() => {
+	return {
+		name: "default",
+		pluginName: "plugin-ts",
+		default(name, type) {
+			return pascalCase(name, { isFile: type === "file" });
+		},
+		resolveTypeName(name) {
+			return pascalCase(name);
+		},
+		resolvePathName(name, type) {
+			return pascalCase(name, { isFile: type === "file" });
+		},
+		resolveParamName(node, param) {
+			return this.resolveTypeName(`${node.operationId} ${param.in} ${param.name}`);
+		},
+		resolveResponseStatusName(node, statusCode) {
+			return this.resolveTypeName(`${node.operationId} Status ${statusCode}`);
+		},
+		resolveDataName(node) {
+			return this.resolveTypeName(`${node.operationId} Data`);
+		},
+		resolveRequestConfigName(node) {
+			return this.resolveTypeName(`${node.operationId} RequestConfig`);
+		},
+		resolveResponsesName(node) {
+			return this.resolveTypeName(`${node.operationId} Responses`);
+		},
+		resolveResponseName(node) {
+			return this.resolveTypeName(`${node.operationId} Response`);
+		},
+		resolveEnumKeyName(node, enumTypeSuffix = "key") {
+			return `${this.resolveTypeName(node.name ?? "")}${enumTypeSuffix}`;
+		},
+		resolvePathParamsName(node, param) {
+			return this.resolveParamName(node, param);
+		},
+		resolveQueryParamsName(node, param) {
+			return this.resolveParamName(node, param);
+		},
+		resolveHeaderParamsName(node, param) {
+			return this.resolveParamName(node, param);
+		}
+	};
+});
+//#endregion
+//#region src/plugin.ts
+/**
+* Canonical plugin name for `@kubb/plugin-ts`, used to identify the plugin in driver lookups and warnings.
+*/
+const pluginTsName = "plugin-ts";
+/**
+* The `@kubb/plugin-ts` plugin factory.
+*
+* Generates TypeScript type declarations from an OpenAPI/AST `RootNode`.
+* Walks schemas and operations, delegates rendering to the active generators,
+* and writes barrel files based on `output.barrelType`.
+*
+* @example
+* ```ts
+* import pluginTs from '@kubb/plugin-ts'
+*
+* export default defineConfig({
+*   plugins: [pluginTs({ output: { path: 'types' }, enumType: 'asConst' })],
+* })
+* ```
+*/
+const pluginTs = definePlugin((options) => {
+	const { output = {
+		path: "types",
+		barrelType: "named"
+	}, group, exclude = [], include, override = [], enumType = "asConst", enumTypeSuffix = "Key", enumKeyCasing = "none", optionalType = "questionToken", arrayType = "array", syntaxType = "type", paramsCasing, printer, resolver: userResolver, transformer: userTransformer, generators: userGenerators = [] } = options;
+	const groupConfig = group ? {
+		...group,
+		name: (ctx) => {
+			if (group.type === "path") return `${ctx.group.split("/")[1]}`;
+			return `${camelCase(ctx.group)}Controller`;
+		}
+	} : void 0;
+	return {
+		name: pluginTsName,
+		options,
+		hooks: { "kubb:plugin:setup"(ctx) {
+			ctx.setOptions({
+				output,
+				exclude,
+				include,
+				override,
+				optionalType,
+				group: groupConfig,
+				arrayType,
+				enumType,
+				enumTypeSuffix,
+				enumKeyCasing,
+				syntaxType,
+				paramsCasing,
+				printer
+			});
+			ctx.setResolver(userResolver ? {
+				...resolverTs,
+				...userResolver
+			} : resolverTs);
+			if (userTransformer) ctx.setTransformer(userTransformer);
+			ctx.addGenerator(typeGenerator);
+			for (const gen of userGenerators) ctx.addGenerator(gen);
+		} }
+	};
+});
+//#endregion
+//#region src/printers/functionPrinter.ts
+const kindToHandlerKey = {
+	FunctionParameter: "functionParameter",
+	ParameterGroup: "parameterGroup",
+	FunctionParameters: "functionParameters",
+	ParamsType: "paramsType"
+};
+/**
+* Creates a function-parameter printer factory.
+*
+* Uses `createPrinterFactory` and dispatches handlers by `node.kind`
+* (for function nodes) rather than by `node.type` (for schema nodes).
+*/
+const defineFunctionPrinter = ast.createPrinterFactory((node) => kindToHandlerKey[node.kind]);
+function rank(param) {
+	if (param.kind === "ParameterGroup") {
+		if (param.default) return PARAM_RANK.withDefault;
+		return param.optional ?? param.properties.every((p) => p.optional || p.default !== void 0) ? PARAM_RANK.optional : PARAM_RANK.required;
+	}
+	if (param.rest) return PARAM_RANK.rest;
+	if (param.default) return PARAM_RANK.withDefault;
+	return param.optional ? PARAM_RANK.optional : PARAM_RANK.required;
+}
+function sortParams(params) {
+	return [...params].sort((a, b) => rank(a) - rank(b));
+}
+function sortChildParams(params) {
+	return [...params].sort((a, b) => rank(a) - rank(b));
+}
+/**
+* Default function-signature printer.
+* Covers the four standard output modes used across Kubb plugins.
+*
+* @example
+* ```ts
+* const printer = functionPrinter({ mode: 'declaration' })
+*
+* const sig = createFunctionParameters({
+*   params: [
+*     createFunctionParameter({ name: 'petId', type: 'string', optional: false }),
+*     createFunctionParameter({ name: 'config', type: 'Config', optional: false, default: '{}' }),
+*   ],
+* })
+*
+* printer.print(sig)  // → "petId: string, config: Config = {}"
+* ```
+*/
+const functionPrinter = defineFunctionPrinter((options) => ({
+	name: "functionParameters",
+	options,
+	nodes: {
+		paramsType(node) {
+			if (node.kind !== "ParamsType") return null;
+			if (node.variant === "member") return `${node.base}['${node.key}']`;
+			if (node.variant === "struct") return `{ ${node.properties.map((p) => {
+				const typeStr = this.transform(p.type);
+				const key = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(p.name) ? p.name : JSON.stringify(p.name);
+				return p.optional ? `${key}?: ${typeStr}` : `${key}: ${typeStr}`;
+			}).join("; ")} }`;
+			if (node.variant === "reference") return node.name;
+			return null;
+		},
+		functionParameter(node) {
+			const { mode, transformName, transformType } = this.options;
+			const name = transformName ? transformName(node.name) : node.name;
+			const rawType = node.type ? this.transform(node.type) : void 0;
+			const type = rawType != null && transformType ? transformType(rawType) : rawType;
+			if (mode === "keys" || mode === "values") return node.rest ? `...${name}` : name;
+			if (mode === "call") return node.rest ? `...${name}` : name;
+			if (node.rest) return type ? `...${name}: ${type}` : `...${name}`;
+			if (type) {
+				if (node.optional) return `${name}?: ${type}`;
+				return node.default ? `${name}: ${type} = ${node.default}` : `${name}: ${type}`;
+			}
+			return node.default ? `${name} = ${node.default}` : name;
+		},
+		parameterGroup(node) {
+			const { mode, transformName, transformType } = this.options;
+			const sorted = sortChildParams(node.properties);
+			const isOptional = node.optional ?? sorted.every((p) => p.optional || p.default !== void 0);
+			if (node.inline) return sorted.map((p) => this.transform(p)).filter(Boolean).join(", ");
+			if (mode === "keys" || mode === "values") return `{ ${sorted.map((p) => p.name).join(", ")} }`;
+			if (mode === "call") return `{ ${sorted.map((p) => p.name).join(", ")} }`;
+			const names = sorted.map((p) => {
+				return transformName ? transformName(p.name) : p.name;
+			});
+			const nameStr = names.length ? `{ ${names.join(", ")} }` : void 0;
+			if (!nameStr) return null;
+			let typeAnnotation = node.type ? this.transform(node.type) ?? void 0 : void 0;
+			if (!typeAnnotation) {
+				const typeParts = sorted.filter((p) => p.type).map((p) => {
+					const rawT = p.type ? this.transform(p.type) : void 0;
+					const t = rawT != null && transformType ? transformType(rawT) : rawT;
+					return p.optional || p.default !== void 0 ? `${p.name}?: ${t}` : `${p.name}: ${t}`;
+				});
+				typeAnnotation = typeParts.length ? `{ ${typeParts.join("; ")} }` : void 0;
+			}
+			if (typeAnnotation) {
+				if (isOptional) return `${nameStr}: ${typeAnnotation} = ${node.default ?? "{}"}`;
+				return node.default ? `${nameStr}: ${typeAnnotation} = ${node.default}` : `${nameStr}: ${typeAnnotation}`;
+			}
+			return node.default ? `${nameStr} = ${node.default}` : nameStr;
+		},
+		functionParameters(node) {
+			return sortParams(node.params).map((p) => this.transform(p)).filter(Boolean).join(", ");
+		}
+	}
+}));
+//#endregion
+export { Enum, Type, pluginTs as default, pluginTs, functionPrinter, pluginTsName, printerTs, resolverTs, typeGenerator };
+
+//# sourceMappingURL=index.js.map