@kubb/parser-ts 5.0.0-beta.5 → 5.0.0-beta.50

package/LICENSE

@@ -1,14 +1,21 @@
-Copyright (c) 2026 Stijn Van Hulle
-
-This repository contains software under two licenses:
+MIT License
 
-1. Most of the code in this repository is licensed under the
-   MIT License — see licenses/LICENSE-MIT for the full license text.
+Copyright (c) 2026 Stijn Van Hulle
 
-2. The following components are licensed under the
-   GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later)
-   — see licenses/LICENSE-AGPL-3.0 for the full license text:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-   - packages/agent (published as @kubb/agent)
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-Each package's own LICENSE file or package.json specifies its applicable license.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+<div align="center">
+  <a href="https://kubb.dev" target="_blank" rel="noopener noreferrer">
+    <img src="https://kubb.dev/og.png" alt="Kubb banner">
+  </a>
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![Stars][stars-src]][stars-href]
+[![License][license-src]][license-href]
+[![Node][node-src]][node-href]
+
+<h4>
+<a href="https://kubb.dev" target="_blank">Documentation</a>
+<span> · </span>
+<a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Report Bug</a>
+<span> · </span>
+<a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Request Feature</a>
+</h4>
+</div>
+
+<br />
+
+# @kubb/parser-ts
+
+### TypeScript source file parser for Kubb
+
+Converts AST nodes and raw TypeScript code into formatted source strings using the TypeScript compiler API. Handles both `.ts` and `.tsx` output.
+
+## Installation
+
+```bash
+bun add @kubb/parser-ts
+# or
+pnpm add @kubb/parser-ts
+# or
+npm install @kubb/parser-ts
+```
+
+## Usage
+
+```typescript
+import { defineConfig } from 'kubb'
+import { parserTs, parserTsx } from '@kubb/parser-ts'
+
+export default defineConfig({
+  input: { path: './petstore.yaml' },
+  output: { path: './src/gen' },
+  parsers: [parserTs, parserTsx],
+})
+```
+
+To render compiler AST nodes to source text from inside a plugin, call `print` on the parser instance:
+
+```typescript
+import { parserTs } from '@kubb/parser-ts'
+import ts from 'typescript'
+
+const source = parserTs.print(
+  ts.factory.createVariableStatement(
+    [ts.factory.createModifier(ts.SyntaxKind.ExportKeyword)],
+    ts.factory.createVariableDeclarationList(
+      [ts.factory.createVariableDeclaration('hello', undefined, undefined, ts.factory.createStringLiteral('world'))],
+      ts.NodeFlags.Const,
+    ),
+  ),
+)
+// → export const hello = 'world'
+```
+
+## API
+
+### `parserTs`
+
+Parser instance for `.ts` and `.js` files. Pass to `defineConfig({ parsers: [...] })` to emit TypeScript source files.
+
+- `parserTs.parse(file, options?)` — serialize a `FileNode` to TypeScript source.
+- `parserTs.print(...nodes)` — convert TypeScript compiler `Node` instances to a formatted source string.
+
+### `parserTsx`
+
+Parser instance for `.tsx` and `.jsx` files. Same API as `parserTs` with JSX support.
+
+## Supporting Kubb
+
+Kubb is an open source project, and its development is funded entirely by sponsors. If you would like to become a sponsor, please consider:
+
+- [Become a Sponsor on GitHub](https://github.com/sponsors/stijnvanhulle)
+- [See sponsorship tiers and our sponsors](https://kubb.dev/sponsors)
+
+<p align="center">
+  <a href="https://github.com/sponsors/stijnvanhulle">
+    <img src="https://raw.githubusercontent.com/stijnvanhulle/sponsors/main/sponsors.svg" alt="My sponsors" />
+  </a>
+</p>
+
+## License
+
+[MIT](https://github.com/kubb-labs/kubb/blob/main/licenses/LICENSE-MIT)
+
+<!-- Badges -->
+
+[npm-version-src]: https://shieldcn.dev/npm/v/@kubb/parser-ts.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[npm-version-href]: https://npmx.dev/package/@kubb/parser-ts
+[npm-downloads-src]: https://shieldcn.dev/npm/dm/@kubb/parser-ts.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[npm-downloads-href]: https://npmx.dev/package/@kubb/parser-ts
+[stars-src]: https://shieldcn.dev/github/stars/kubb-labs/kubb.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[stars-href]: https://github.com/kubb-labs/kubb
+[license-src]: https://shieldcn.dev/npm/license/@kubb/parser-ts.svg?variant=secondary&size=xs&theme=zinc
+[license-href]: https://github.com/kubb-labs/kubb/blob/main/LICENSE
+[node-src]: https://shieldcn.dev/npm/node/@kubb/parser-ts.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[node-href]: https://npmx.dev/package/@kubb/parser-ts

package/dist/index.cjs

@@ -21,11 +21,14 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-let node_path = require("node:path");
 let _kubb_core = require("@kubb/core");
+let node_path = require("node:path");
 let typescript = require("typescript");
 typescript = __toESM(typescript, 1);
-//#region src/constants.ts
+/**
+* Indentation unit prepended once per nesting level when pretty-printing.
+*/
+const INDENT = " ".repeat(2);
 /**
 * Matches the trailing `.<ext>` segment of a path (keeps segments like `foo.bar.ts`
 * intact by only trimming the last run of non-`/`/`.` characters).
@@ -36,26 +39,29 @@ const FILE_EXTENSION_PATTERN = /\.[^/.]+$/;
 */
 const WINDOWS_PATH_SEPARATOR = /\\/g;
 /**
-* Matches `*\/` in free-form text so JSDoc bodies can neutralise premature
+* Matches `*\/` in free-form text so JSDoc bodies can neutralize premature
 * comment terminators (`*\/` → `* /`).
 */
 const JSDOC_TERMINATOR_PATTERN = /\*\//g;
 /**
-* Matches carriage returns for normalising CRLF/CR line endings to LF.
+* Matches carriage returns for normalizing CRLF/CR line endings to LF.
 */
 const CARRIAGE_RETURN_PATTERN = /\r/g;
 /**
-* Matches CRLF sequences used when normalising TypeScript printer output.
+* Matches CRLF sequences used when normalizing TypeScript printer output.
 */
 const CRLF_PATTERN = /\r\n/g;
 /**
-* Matches an identifier that starts with a digit — JavaScript disallows this
+* Matches an identifier that starts with a digit. JavaScript disallows this,
 * so the printer prefixes such names with `_`.
 */
 const LEADING_DIGIT_PATTERN = /^\d/;
 //#endregion
-//#region src/parserTs.ts
+//#region src/utils.ts
 const { factory } = typescript.default;
+/**
+* Normalizes a file-system path to POSIX separators and strips any leading `../` segment.
+*/
 function slash(path) {
 	return (0, node_path.normalize)(path).replaceAll(WINDOWS_PATH_SEPARATOR, "/").replace("../", "");
 }
@@ -85,57 +91,104 @@ function resolveOutputPath(path, options, rootAware) {
 	return rootAware ? trimExtName(path) : path;
 }
 /**
-* Validates TypeScript AST nodes before printing.
-* Throws an error if any node has SyntaxKind.Unknown which would cause the
-* TypeScript printer to crash.
+* Serializes a `nodes` array into source text. Each entry is rendered via {@link printCodeNode}
+* and joined with a single newline; a `Break` node (`<br/>`) inserts one blank line between
+* statements. Consecutive breaks, and breaks at the very start or end, are folded into the
+* separator, so a double `<br/>` never emits more than one blank line.
 */
-function validateNodes(...nodes) {
+function printNodes(nodes) {
+	if (!nodes || nodes.length === 0) return "";
+	let result = "";
+	let hasContent = false;
+	let pendingBreak = false;
 	for (const node of nodes) {
-		if (!node) throw new Error("Attempted to print undefined or null TypeScript node");
-		if (node.kind === typescript.default.SyntaxKind.Unknown) throw new Error(`Invalid TypeScript AST node detected with SyntaxKind.Unknown. This typically indicates a schema pattern that could not be properly converted to TypeScript. Node: ${JSON.stringify(node, null, 2)}`);
+		if (node.kind === "Break") {
+			if (hasContent) pendingBreak = true;
+			continue;
+		}
+		const text = printCodeNode(node);
+		if (!text) continue;
+		if (hasContent) result += pendingBreak ? "\n\n" : "\n";
+		result += text;
+		hasContent = true;
+		pendingBreak = false;
 	}
+	return result;
 }
 /**
-* Converts TypeScript/TSX AST nodes to a string using the TypeScript printer.
+* Indents every non-empty line of `text` by one indent unit. Pass a number to repeat
+* {@link INDENT_CHAR} that many times, or a string to use as the indent verbatim.
 */
-function print(...elements) {
-	const sourceFile = typescript.default.createSourceFile("print.tsx", "", typescript.default.ScriptTarget.ES2022, true, typescript.default.ScriptKind.TSX);
-	return typescript.default.createPrinter({
-		omitTrailingSemicolon: true,
-		newLine: typescript.default.NewLineKind.LineFeed,
-		removeComments: false,
-		noEmitHelpers: true
-	}).printList(typescript.default.ListFormat.MultiLine, factory.createNodeArray(elements.filter(Boolean)), sourceFile).replace(CRLF_PATTERN, "\n");
+function indentLines(text, indent = INDENT) {
+	if (!text) return "";
+	const pad = typeof indent === "string" ? indent : " ".repeat(indent);
+	return text.split("\n").map((line) => line.trim() ? `${pad}${line}` : "").join("\n");
 }
 /**
-* Like `print` but validates nodes first to surface issues early.
+* Removes the common leading whitespace shared by every non-blank line and trims
+* surrounding blank lines, normalizing multi-line content authored inside an
+* indented template literal back to a column-zero baseline. Leading whitespace is
+* counted by character, so N tabs and N spaces are treated as the same depth.
+*
+* @example
+* ```ts
+* dedent('\n    foo\n      bar\n    ')
+* // 'foo\n  bar'
+* ```
 */
-function safePrint(...elements) {
-	validateNodes(...elements);
-	return print(...elements);
+function dedent(text) {
+	if (!text) return "";
+	const lines = text.split("\n");
+	const isBlank = (line) => line.trim() === "";
+	const start = lines.findIndex((line) => !isBlank(line));
+	if (start === -1) return "";
+	const end = lines.findLastIndex((line) => !isBlank(line));
+	const trimmed = lines.slice(start, end + 1);
+	const indents = trimmed.filter((line) => !isBlank(line)).map((line) => line.match(/^\s*/)?.[0].length ?? 0);
+	const min = indents.length ? Math.min(...indents) : 0;
+	return trimmed.map((line) => isBlank(line) ? "" : line.slice(min)).join("\n");
 }
-function createImport({ name, path, root, isTypeOnly = false, isNameSpace = false }) {
-	const resolvePath = root ? getRelativePath(root, path) : path;
-	if (!Array.isArray(name)) {
-		if (isNameSpace) return factory.createImportDeclaration(void 0, factory.createImportClause(isTypeOnly, void 0, factory.createNamespaceImport(factory.createIdentifier(name))), factory.createStringLiteral(resolvePath), void 0);
-		return factory.createImportDeclaration(void 0, factory.createImportClause(isTypeOnly, factory.createIdentifier(name), void 0), factory.createStringLiteral(resolvePath), void 0);
-	}
-	const specifiers = name.map((item) => {
-		if (typeof item === "object") {
-			const { propertyName, name: alias } = item;
-			return factory.createImportSpecifier(false, alias ? factory.createIdentifier(propertyName) : void 0, factory.createIdentifier(alias ?? propertyName));
-		}
-		return factory.createImportSpecifier(false, void 0, factory.createIdentifier(item));
-	});
-	return factory.createImportDeclaration(void 0, factory.createImportClause(isTypeOnly, void 0, factory.createNamedImports(specifiers)), factory.createStringLiteral(resolvePath), void 0);
+/**
+* Renders the generic clause (`<T, U>`) shared by function and arrow-function nodes.
+* Accepts either a raw string (rendered verbatim) or an array of type-parameter names.
+*/
+function formatGenerics(generics) {
+	if (!generics) return "";
+	return `<${Array.isArray(generics) ? generics.join(", ") : generics}>`;
 }
-function createExport({ path, asAlias, isTypeOnly = false, name }) {
-	if (name && !Array.isArray(name) && !asAlias) console.warn(`When using name as string, asAlias should be true: ${name}`);
-	if (!Array.isArray(name)) {
-		const parsedName = name && LEADING_DIGIT_PATTERN.test(name) ? `_${name.slice(1)}` : name;
-		return factory.createExportDeclaration(void 0, isTypeOnly, asAlias && parsedName ? factory.createNamespaceExport(factory.createIdentifier(parsedName)) : void 0, factory.createStringLiteral(path), void 0);
-	}
-	return factory.createExportDeclaration(void 0, isTypeOnly, factory.createNamedExports(name.map((propertyName) => factory.createExportSpecifier(false, void 0, typeof propertyName === "string" ? factory.createIdentifier(propertyName) : propertyName))), factory.createStringLiteral(path), void 0);
+/**
+* Renders the return-type suffix (`: T` or `: Promise<T>` when `isAsync` is true).
+* Returns an empty string when no return type is provided.
+*/
+function formatReturnType(returnType, isAsync) {
+	if (!returnType) return "";
+	return isAsync ? `: Promise<${returnType}>` : `: ${returnType}`;
+}
+/**
+* Module-scoped TypeScript printer instance. `ts.createPrinter()` is stateless across calls
+* (it does not mutate the source file) so a single instance can be safely reused for every
+* `print()` call. Hoisting it out of `print()` avoids re-running the printer initialization
+* for each file's import/export section.
+*/
+const TS_PRINTER = typescript.default.createPrinter({
+	omitTrailingSemicolon: true,
+	newLine: typescript.default.NewLineKind.LineFeed,
+	removeComments: false,
+	noEmitHelpers: true
+});
+/**
+* Module-scoped source file used as the print target. `printList` only reads the source
+* file's compiler options / language version. It never mutates it.
+*/
+const PRINT_SOURCE_FILE = typescript.default.createSourceFile("print.tsx", "", typescript.default.ScriptTarget.ES2022, true, typescript.default.ScriptKind.TSX);
+TS_PRINTER.printList(typescript.default.ListFormat.MultiLine, factory.createNodeArray([]), PRINT_SOURCE_FILE);
+/**
+* Converts TypeScript/TSX AST nodes to a string using the TypeScript printer.
+*/
+function print(...elements) {
+	const filtered = elements.filter(Boolean);
+	if (filtered.length === 0) return "";
+	return TS_PRINTER.printList(typescript.default.ListFormat.MultiLine, factory.createNodeArray(filtered), PRINT_SOURCE_FILE).replace(CRLF_PATTERN, "\n");
 }
 /**
 * Converts a {@link JSDocNode} to a JSDoc comment block string.
@@ -161,41 +214,6 @@ function printJSDoc(jsDoc) {
 	].join("\n");
 }
 /**
-* Serializes the body / value content from a `nodes` array.
-*
-* Each element is either a raw string or a structured {@link CodeNode}
-* (recursively converted via {@link printCodeNode}).
-* Elements are joined with `\n`.
-*/
-function printNodes(nodes) {
-	if (!nodes || nodes.length === 0) return "";
-	return nodes.map(printCodeNode).join("\n");
-}
-/**
-* Indents every non-empty line of `text` by `spaces` spaces.
-*/
-function indentLines(text, spaces = 2) {
-	if (!text) return "";
-	const pad = " ".repeat(spaces);
-	return text.split("\n").map((line) => line.trim() ? `${pad}${line}` : "").join("\n");
-}
-/**
-* Renders the generic clause (`<T, U>`) shared by function and arrow-function nodes.
-* Accepts either a raw string (rendered verbatim) or an array of type-parameter names.
-*/
-function formatGenerics(generics) {
-	if (!generics) return "";
-	return `<${Array.isArray(generics) ? generics.join(", ") : generics}>`;
-}
-/**
-* Renders the return-type suffix (`: T` or `: Promise<T>` when `isAsync` is true).
-* Returns an empty string when no return type is provided.
-*/
-function formatReturnType(returnType, isAsync) {
-	if (!returnType) return "";
-	return isAsync ? `: Promise<${returnType}>` : `: ${returnType}`;
-}
-/**
 * Converts a {@link ConstNode} to a TypeScript `const` declaration string.
 *
 * Mirrors the `Const` component from `@kubb/renderer-jsx`.
@@ -332,15 +350,14 @@ function printArrowFunction(node) {
 * ```
 */
 function printCodeNode(node) {
-	switch (node.kind) {
-		case "Break": return "";
-		case "Text": return node.value;
-		case "Jsx": return node.value;
-		case "Const": return printConst(node);
-		case "Type": return printType(node);
-		case "Function": return printFunction(node);
-		case "ArrowFunction": return printArrowFunction(node);
-	}
+	if (node.kind === "Break") return "";
+	if (node.kind === "Text") return dedent(node.value);
+	if (node.kind === "Jsx") return dedent(node.value);
+	if (node.kind === "Const") return printConst(node);
+	if (node.kind === "Type") return printType(node);
+	if (node.kind === "Function") return printFunction(node);
+	if (node.kind === "ArrowFunction") return printArrowFunction(node);
+	return "";
 }
 /**
 * Converts a {@link SourceNode} to its TypeScript string representation.
@@ -348,52 +365,129 @@ function printCodeNode(node) {
 * Iterates `nodes` in DOM order, rendering each {@link CodeNode} via
 * {@link printCodeNode}.
 *
+* Top-level declarations are separated by a blank line so the source reads
+* cleanly without an external formatter.
+*
 * @example From nodes
 * ```ts
 * printSource({ kind: 'Source', nodes: [createConst({ name: 'x', nodes: [createText('1')] }), createText('x.toString()')] })
-* // 'const x = 1\nx.toString()'
+* // 'const x = 1\n\nx.toString()'
 * ```
 */
 function printSource(node) {
-	if (node.nodes && node.nodes.length > 0) return node.nodes.map(printCodeNode).join("\n");
-	return "";
+	const nodes = node.nodes;
+	if (!nodes || nodes.length === 0) return "";
+	return nodes.map((child) => printCodeNode(child)).filter(Boolean).join("\n\n");
+}
+/**
+* Wraps a module specifier in single quotes, escaping any embedded backslash or quote so the emitted
+* statement stays valid even for unusual paths.
+*/
+function quoteModulePath(path) {
+	return `'${path.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
 }
 /**
-* Parser that converts `.ts` and `.js` files to strings using the TypeScript
-* compiler. Handles import/export statement generation from file metadata.
+* Renders an import declaration string in the repo style (single quotes, no semicolons), mirroring
+* the shapes that {@link createImport} builds: default, namespace (`* as`), and named imports with
+* `{ a as b }` aliases, each optionally `type`-only. `path` is used verbatim, so resolve it first.
 *
-* @default Used automatically when no `parsers` option is set in `defineConfig`.
+* @example
+* ```ts
+* printImport({ name: ['z'], path: './zod.ts' })
+* // "import { z } from './zod.ts'"
+* ```
+*/
+function printImport({ name, path, isTypeOnly = false, isNameSpace = false }) {
+	const typePrefix = isTypeOnly ? "type " : "";
+	const from = quoteModulePath(path);
+	if (!Array.isArray(name)) {
+		if (isNameSpace) return `import ${typePrefix}* as ${name} from ${from}`;
+		return `import ${typePrefix}${name} from ${from}`;
+	}
+	return `import ${typePrefix}{ ${name.map((item) => {
+		if (typeof item === "object") return item.name ? `${item.propertyName} as ${item.name}` : item.propertyName;
+		return item;
+	}).join(", ")} } from ${from}`;
+}
+/**
+* Renders an export declaration string in the repo style (single quotes, no semicolons), mirroring
+* the shapes that {@link createExport} builds: named re-exports, namespace alias (`* as name`), and
+* wildcard, each optionally `type`-only. `path` is used verbatim, so resolve it first.
+*
+* @example
+* ```ts
+* printExport({ name: ['Pet', 'Order'], path: './models.ts' })
+* // "export { Pet, Order } from './models.ts'"
+* ```
+*/
+function printExport({ path, name, isTypeOnly = false, asAlias = false }) {
+	const typePrefix = isTypeOnly ? "type " : "";
+	const from = quoteModulePath(path);
+	if (Array.isArray(name)) return `export ${typePrefix}{ ${name.map((item) => typeof item === "string" ? item : item.text).join(", ")} } from ${from}`;
+	if (asAlias && name) return `export ${typePrefix}* as ${LEADING_DIGIT_PATTERN.test(name) ? `_${name.slice(1)}` : name} from ${from}`;
+	if (name) console.warn(`When using name as string, asAlias should be true: ${name}`);
+	return `export ${typePrefix}* from ${from}`;
+}
+//#endregion
+//#region src/parserTs.ts
+/**
+* Default Kubb parser for `.ts` and `.js` files. Takes the universal AST
+* produced by an adapter and prints it as TypeScript source using the official
+* TypeScript compiler. Imports and exports are rewritten based on each file's
+* metadata.
+*
+* Used automatically when no `parsers` option is set on `defineConfig`. Use
+* `parserTsx` instead for React projects that emit JSX.
+*
+* @example
+* ```ts
+* import { defineConfig } from 'kubb'
+* import { adapterOas } from '@kubb/adapter-oas'
+* import { parserTs } from '@kubb/parser-ts'
+*
+* export default defineConfig({
+*   input: { path: './petStore.yaml' },
+*   output: { path: './src/gen' },
+*   adapter: adapterOas(),
+*   parsers: [parserTs],
+*   plugins: [],
+* })
+* ```
 */
 const parserTs = (0, _kubb_core.defineParser)({
 	name: "typescript",
 	extNames: [".ts", ".js"],
-	async parse(file, options = { extname: ".ts" }) {
+	print(...nodes) {
+		return print(...nodes);
+	},
+	parse(file, options = { extname: ".ts" }) {
 		const sourceParts = [];
 		for (const item of file.sources) {
 			const sourceStr = printSource(item);
 			if (sourceStr) sourceParts.push(sourceStr.trimEnd());
 		}
 		const source = sourceParts.join("\n\n");
-		const importNodes = [];
+		const importLines = [];
 		for (const item of file.imports) {
 			const importPath = item.root ? getRelativePath(item.root, item.path) : item.path;
-			importNodes.push(createImport({
+			importLines.push(printImport({
 				name: item.name,
 				path: resolveOutputPath(importPath, options, Boolean(item.root)),
 				isTypeOnly: item.isTypeOnly,
 				isNameSpace: item.isNameSpace
 			}));
 		}
-		const exportNodes = [];
-		for (const item of file.exports) exportNodes.push(createExport({
+		const exportLines = [];
+		for (const item of file.exports) exportLines.push(printExport({
 			name: item.name,
 			path: resolveOutputPath(item.path, options, true),
 			isTypeOnly: item.isTypeOnly,
 			asAlias: item.asAlias
 		}));
+		const importExportBlock = [...importLines, ...exportLines].join("\n");
 		return [
 			file.banner,
-			print(...importNodes, ...exportNodes),
+			importExportBlock,
 			source,
 			file.footer
 		].filter((segment) => Boolean(segment)).map((s) => s.trimEnd()).join("\n\n");
@@ -402,28 +496,39 @@ const parserTs = (0, _kubb_core.defineParser)({
 //#endregion
 //#region src/parserTsx.ts
 /**
-* Parser that converts `.tsx` and `.jsx` files to strings.
-* Delegates to `typescriptParser` since the TypeScript compiler natively
-* supports JSX/TSX syntax via `ScriptKind.TSX`.
+* Kubb parser for `.tsx` and `.jsx` files. Delegates to `parserTs` because the
+* TypeScript compiler handles JSX natively via `ScriptKind.TSX`.
+*
+* Add to the `parsers` array on `defineConfig` when generating components for
+* React (or any framework that emits JSX).
 *
-* Add this parser to the `parsers` option in `defineConfig` when generating `.tsx`/`.jsx` files.
+* @example
+* ```ts
+* import { defineConfig } from 'kubb'
+* import { adapterOas } from '@kubb/adapter-oas'
+* import { parserTsx } from '@kubb/parser-ts'
 *
-* @default extname '.tsx'
+* export default defineConfig({
+*   input: { path: './petStore.yaml' },
+*   output: { path: './src/gen' },
+*   adapter: adapterOas(),
+*   parsers: [parserTsx],
+*   plugins: [],
+* })
+* ```
 */
 const parserTsx = (0, _kubb_core.defineParser)({
 	name: "tsx",
 	extNames: [".tsx", ".jsx"],
-	async parse(file, options = { extname: ".tsx" }) {
+	print(...nodes) {
+		return print(...nodes);
+	},
+	parse(file, options = { extname: ".tsx" }) {
 		return parserTs.parse(file, options);
 	}
 });
 //#endregion
-exports.createExport = createExport;
-exports.createImport = createImport;
 exports.parserTs = parserTs;
 exports.parserTsx = parserTsx;
-exports.print = print;
-exports.safePrint = safePrint;
-exports.validateNodes = validateNodes;
 
 //# sourceMappingURL=index.cjs.map