@kubb/parser-ts 5.0.0-beta.21 → 5.0.0-beta.23

package/dist/index.cjs

@@ -356,7 +356,9 @@ function printSource(node) {
 	for (const child of nodes) parts.push(printCodeNode(child));
 	return parts.join("\n");
 }
-function createImport({ name, path, root, isTypeOnly = false, isNameSpace = false }) {
+function createImport({ name, path, root, isTypeOnly: isTypeOnlyRaw = false, isNameSpace: isNameSpaceRaw = false }) {
+	const isTypeOnly = isTypeOnlyRaw ?? false;
+	const isNameSpace = isNameSpaceRaw ?? 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);
@@ -371,7 +373,9 @@ function createImport({ name, path, root, isTypeOnly = false, isNameSpace = fals
 	});
 	return factory.createImportDeclaration(void 0, factory.createImportClause(isTypeOnly, void 0, factory.createNamedImports(specifiers)), factory.createStringLiteral(resolvePath), void 0);
 }
-function createExport({ path, asAlias, isTypeOnly = false, name }) {
+function createExport({ path, asAlias: asAliasRaw, isTypeOnly: isTypeOnlyRaw = false, name }) {
+	const asAlias = asAliasRaw ?? false;
+	const isTypeOnly = isTypeOnlyRaw ?? false;
 	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;
@@ -382,10 +386,28 @@ function createExport({ path, asAlias, isTypeOnly = false, name }) {
 //#endregion
 //#region src/parserTs.ts
 /**
-* Parser that converts `.ts` and `.js` files to strings using the TypeScript
-* compiler. Handles import/export statement generation from file metadata.
+* 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.
 *
-* @default Used automatically when no `parsers` option is set in `defineConfig`.
+* 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",
@@ -425,13 +447,26 @@ 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 this parser to the `parsers` option in `defineConfig` when generating `.tsx`/`.jsx` files.
+* Add to the `parsers` array on `defineConfig` when generating components for
+* React (or any framework that emits JSX).
 *
-* @default extname '.tsx'
+* @example
+* ```ts
+* import { defineConfig } from 'kubb'
+* import { adapterOas } from '@kubb/adapter-oas'
+* import { parserTsx } from '@kubb/parser-ts'
+*
+* export default defineConfig({
+*   input: { path: './petStore.yaml' },
+*   output: { path: './src/gen' },
+*   adapter: adapterOas(),
+*   parsers: [parserTsx],
+*   plugins: [],
+* })
+* ```
 */
 const parserTsx = (0, _kubb_core.defineParser)({
 	name: "tsx",

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["ts"],"sources":["../src/constants.ts","../src/utils.ts","../src/parserTs.ts","../src/parserTsx.ts"],"sourcesContent":["/**\n * Number of spaces used to indent a nested block when pretty-printing.\n */\nexport const INDENT_SIZE = 2 as const\n\n/**\n * Matches the trailing `.<ext>` segment of a path (keeps segments like `foo.bar.ts`\n * intact by only trimming the last run of non-`/`/`.` characters).\n */\nexport const FILE_EXTENSION_PATTERN = /\\.[^/.]+$/\n\n/**\n * Matches Windows-style backslash path separators.\n */\nexport const WINDOWS_PATH_SEPARATOR = /\\\\/g\n\n/**\n * Matches `*\\/` in free-form text so JSDoc bodies can neutralize premature\n * comment terminators (`*\\/` → `* /`).\n */\nexport const JSDOC_TERMINATOR_PATTERN = /\\*\\//g\n\n/**\n * Matches carriage returns for normalizing CRLF/CR line endings to LF.\n */\nexport const CARRIAGE_RETURN_PATTERN = /\\r/g\n\n/**\n * Matches CRLF sequences used when normalizing TypeScript printer output.\n */\nexport const CRLF_PATTERN = /\\r\\n/g\n\n/**\n * Matches an identifier that starts with a digit — JavaScript disallows this\n * so the printer prefixes such names with `_`.\n */\nexport const LEADING_DIGIT_PATTERN = /^\\d/\n\n/**\n * Relative path prefix used to detect traversal segments (`../`).\n */\nexport const PARENT_DIRECTORY_PREFIX = '../' as const\n\n/**\n * Relative path prefix used when resolving imports within the output root.\n */\nexport const CURRENT_DIRECTORY_PREFIX = './' as const\n","import { normalize, relative } from 'node:path'\nimport type { ArrowFunctionNode, CodeNode, ConstNode, FunctionNode, JSDocNode, JsxNode, SourceNode, TextNode, TypeNode } from '@kubb/ast'\nimport ts from 'typescript'\nimport {\n  CARRIAGE_RETURN_PATTERN,\n  CRLF_PATTERN,\n  CURRENT_DIRECTORY_PREFIX,\n  FILE_EXTENSION_PATTERN,\n  INDENT_SIZE,\n  JSDOC_TERMINATOR_PATTERN,\n  LEADING_DIGIT_PATTERN,\n  PARENT_DIRECTORY_PREFIX,\n  WINDOWS_PATH_SEPARATOR,\n} from './constants.ts'\n\nconst { factory } = ts\n\n/**\n * Normalizes a file-system path to POSIX separators and strips any leading `../` segment.\n */\nexport function slash(path: string): string {\n  return normalize(path).replaceAll(WINDOWS_PATH_SEPARATOR, '/').replace(PARENT_DIRECTORY_PREFIX, '')\n}\n\n/**\n * Resolves `filePath` relative to `rootDir` and returns a POSIX-style path\n * prefixed with `./` when the target sits inside the root, or `../` when it escapes it.\n */\nexport function getRelativePath(rootDir: string, filePath: string): string {\n  const rel = relative(rootDir, filePath)\n  const slashed = slash(rel)\n  return slashed.startsWith(PARENT_DIRECTORY_PREFIX) ? slashed : `${CURRENT_DIRECTORY_PREFIX}${slashed}`\n}\n\n/**\n * Strips the trailing file extension (for example `.ts`) from a path.\n * Preserves intermediate dots like `foo.bar.ts` → `foo.bar`.\n */\nexport function trimExtName(text: string): string {\n  return text.replace(FILE_EXTENSION_PATTERN, '')\n}\n\n/**\n * Rewrites an import/export path so its extension matches the caller-supplied\n * `options.extname`. When the source path has no extension the original is kept,\n * so virtual/module-only paths flow through unchanged.\n */\nexport function resolveOutputPath(path: string, options: { extname?: string } | undefined, rootAware: boolean): string {\n  const hasExtname = FILE_EXTENSION_PATTERN.test(path)\n  if (options?.extname && hasExtname) {\n    return `${trimExtName(path)}${options.extname}`\n  }\n  return rootAware ? trimExtName(path) : path\n}\n\n/**\n * Serializes the body / value content from a `nodes` array.\n *\n * Each element is either a raw string or a structured {@link CodeNode}\n * (recursively converted via {@link printCodeNode}).\n * Elements are joined with `\\n`.\n */\nexport function printNodes(nodes: Array<CodeNode> | undefined): string {\n  if (!nodes || nodes.length === 0) return ''\n\n  const parts: string[] = []\n\n  for (const node of nodes) {\n    parts.push(printCodeNode(node))\n  }\n\n  return parts.join('\\n')\n}\n\n/**\n * Indents every non-empty line of `text` by `spaces` spaces.\n */\nexport function indentLines(text: string, spaces: number = INDENT_SIZE): string {\n  if (!text) return ''\n  const pad = ' '.repeat(spaces)\n  return text\n    .split('\\n')\n    .map((line) => (line.trim() ? `${pad}${line}` : ''))\n    .join('\\n')\n}\n\n/**\n * Renders the generic clause (`<T, U>`) shared by function and arrow-function nodes.\n * Accepts either a raw string (rendered verbatim) or an array of type-parameter names.\n */\nexport function formatGenerics(generics: FunctionNode['generics'] | ArrowFunctionNode['generics']): string {\n  if (!generics) return ''\n  return `<${Array.isArray(generics) ? generics.join(', ') : generics}>`\n}\n\n/**\n * Renders the return-type suffix (`: T` or `: Promise<T>` when `isAsync` is true).\n * Returns an empty string when no return type is provided.\n */\nexport function formatReturnType(returnType: string | undefined, isAsync: boolean | undefined): string {\n  if (!returnType) return ''\n  return isAsync ? `: Promise<${returnType}>` : `: ${returnType}`\n}\n\n/**\n * Validates TypeScript AST nodes before printing.\n * Throws an error if any node has SyntaxKind.Unknown which would cause the\n * TypeScript printer to crash.\n */\nexport function validateNodes(...nodes: ts.Node[]): void {\n  for (const node of nodes) {\n    if (!node) {\n      throw new Error('Attempted to print undefined or null TypeScript node')\n    }\n    if (node.kind === ts.SyntaxKind.Unknown) {\n      throw new Error(\n        'Invalid TypeScript AST node detected with SyntaxKind.Unknown. ' +\n          'This typically indicates a schema pattern that could not be properly converted to TypeScript. ' +\n          `Node: ${JSON.stringify(node, null, 2)}`,\n      )\n    }\n  }\n}\n\n/**\n * Module-scoped TypeScript printer instance. `ts.createPrinter()` is stateless across calls\n * (it does not mutate the source file) so a single instance can be safely reused for every\n * `print()` call. Hoisting it out of `print()` avoids re-running the printer initialization\n * for each file's import/export section.\n */\nconst TS_PRINTER = ts.createPrinter({\n  omitTrailingSemicolon: true,\n  newLine: ts.NewLineKind.LineFeed,\n  removeComments: false,\n  noEmitHelpers: true,\n})\n\n/**\n * Module-scoped source file used as the print target. `printList` only reads the source\n * file's compiler options / language version; it never mutates it.\n */\nconst PRINT_SOURCE_FILE = ts.createSourceFile('print.tsx', '', ts.ScriptTarget.ES2022, true, ts.ScriptKind.TSX)\n\n// Pre-warm the printer at module load. The first `printList` call lazily initializes\n// the printer's internal string-builder and identifier tables; doing it once at import\n// time keeps that cost off the critical path for short-lived CLI builds.\nTS_PRINTER.printList(ts.ListFormat.MultiLine, factory.createNodeArray([]), PRINT_SOURCE_FILE)\n\n/**\n * Converts TypeScript/TSX AST nodes to a string using the TypeScript printer.\n */\nexport function print(...elements: Array<ts.Node>): string {\n  const filtered = elements.filter(Boolean)\n  if (filtered.length === 0) return ''\n\n  const output = TS_PRINTER.printList(ts.ListFormat.MultiLine, factory.createNodeArray(filtered), PRINT_SOURCE_FILE)\n\n  return output.replace(CRLF_PATTERN, '\\n')\n}\n\n/**\n * Like `print` but validates nodes first to surface issues early.\n */\nexport function safePrint(...elements: Array<ts.Node>): string {\n  validateNodes(...elements)\n  return print(...elements)\n}\n\n/**\n * Converts a {@link JSDocNode} to a JSDoc comment block string.\n *\n * @example\n * ```ts\n * printJSDoc({ comments: ['@description A pet', '@deprecated'] })\n * // /**\n * //  * @description A pet\n * //  * @deprecated\n * //  *\\/\n * ```\n */\nexport function printJSDoc(jsDoc: JSDocNode): string {\n  const comments = (jsDoc.comments ?? []).filter((c) => c != null)\n  if (comments.length === 0) return ''\n\n  const lines = comments\n    .flatMap((c) => c.split(/\\r?\\n/))\n    .map((l) => l.replace(JSDOC_TERMINATOR_PATTERN, '* /').replace(CARRIAGE_RETURN_PATTERN, ''))\n    .filter((l) => l.trim().length > 0)\n\n  if (lines.length === 0) return ''\n\n  return ['/**', ...lines.map((l) => ` * ${l}`), ' */'].join('\\n')\n}\n\n/**\n * Converts a {@link ConstNode} to a TypeScript `const` declaration string.\n *\n * Mirrors the `Const` component from `@kubb/renderer-jsx`.\n *\n * @example\n * ```ts\n * printConst(createConst({ name: 'pet', export: true, nodes: ['{}'] }))\n * // 'export const pet = {}'\n * ```\n *\n * @example With type and `as const`\n * ```ts\n * printConst(createConst({ name: 'pets', export: true, type: 'Pet[]', asConst: true, nodes: ['[]'] }))\n * // 'export const pets: Pet[] = [] as const'\n * ```\n */\nexport function printConst(node: ConstNode): string {\n  const { name, export: canExport, type, JSDoc, asConst, nodes } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  parts.push('const ')\n  parts.push(name)\n  if (type) {\n    parts.push(`: ${type}`)\n  }\n  parts.push(' = ')\n  parts.push(body)\n  if (asConst) parts.push(' as const')\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts a {@link TypeNode} to a TypeScript `type` alias declaration string.\n *\n * Mirrors the `Type` component from `@kubb/renderer-jsx`.\n *\n * @example\n * ```ts\n * printType(createType({ name: 'Pet', export: true, nodes: ['{ id: number }'] }))\n * // 'export type Pet = { id: number }'\n * ```\n */\nexport function printType(node: TypeNode): string {\n  const { name, export: canExport, JSDoc, nodes } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  parts.push('type ')\n  parts.push(name)\n  parts.push(' = ')\n  parts.push(body)\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts a {@link FunctionNode} to a TypeScript `function` declaration string.\n *\n * Mirrors the `Function` component from `@kubb/renderer-jsx`.\n *\n * @example\n * ```ts\n * printFunction(createFunction({ name: 'getPet', export: true, params: 'id: string', returnType: 'Pet', nodes: ['return fetch(id)'] }))\n * // 'export function getPet(id: string): Pet {\\n  return fetch(id)\\n}'\n * ```\n *\n * @example Async with generics\n * ```ts\n * printFunction(createFunction({ name: 'fetchPet', export: true, async: true, generics: ['T'], params: 'id: string', returnType: 'T' }))\n * // 'export async function fetchPet<T>(id: string): Promise<T> {\\n}'\n * ```\n */\nexport function printFunction(node: FunctionNode): string {\n  const { name, default: isDefault, export: canExport, async: isAsync, generics, params, returnType, JSDoc, nodes } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n  const indented = body ? indentLines(body) : ''\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  if (isDefault) parts.push('default ')\n  if (isAsync) parts.push('async ')\n  parts.push('function ')\n  parts.push(name)\n  parts.push(formatGenerics(generics))\n  parts.push(`(${params ?? ''})`)\n  parts.push(formatReturnType(returnType, isAsync))\n  parts.push(' {')\n  if (indented) {\n    parts.push(`\\n${indented}\\n`)\n  }\n  parts.push('}')\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts an {@link ArrowFunctionNode} to a TypeScript arrow function declaration string.\n *\n * Mirrors the `Function.Arrow` component from `@kubb/renderer-jsx`.\n *\n * @example Multi-line arrow function\n * ```ts\n * printArrowFunction(createArrowFunction({ name: 'getPet', export: true, params: 'id: string', nodes: ['return fetch(id)'] }))\n * // 'export const getPet = (id: string) => {\\n  return fetch(id)\\n}'\n * ```\n *\n * @example Single-line arrow function\n * ```ts\n * printArrowFunction(createArrowFunction({ name: 'double', params: 'n: number', singleLine: true, nodes: ['n * 2'] }))\n * // 'const double = (n: number) => n * 2'\n * ```\n */\nexport function printArrowFunction(node: ArrowFunctionNode): string {\n  const { name, default: isDefault, export: canExport, async: isAsync, generics, params, returnType, JSDoc, nodes, singleLine } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n  const arrowBody = singleLine ? ` => ${body}` : body ? ` => {\\n${indentLines(body)}\\n}` : ' => {}'\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  if (isDefault) parts.push('default ')\n  parts.push('const ')\n  parts.push(name)\n  parts.push(' = ')\n  if (isAsync) parts.push('async ')\n  parts.push(formatGenerics(generics))\n  parts.push(`(${params ?? ''})`)\n  parts.push(formatReturnType(returnType, isAsync))\n  parts.push(arrowBody)\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts a {@link CodeNode} to its TypeScript string representation.\n *\n * Dispatches to the appropriate printer based on the node's `kind`.\n *\n * @example\n * ```ts\n * printCodeNode(createConst({ name: 'x', nodes: ['1'] }))\n * // 'const x = 1'\n * ```\n */\nexport function printCodeNode(node: CodeNode): string {\n  if (node.kind === 'Break') return ''\n  if (node.kind === 'Text') return (node as TextNode).value\n  if (node.kind === 'Jsx') return (node as JsxNode).value\n  if (node.kind === 'Const') return printConst(node)\n  if (node.kind === 'Type') return printType(node)\n  if (node.kind === 'Function') return printFunction(node)\n  if (node.kind === 'ArrowFunction') return printArrowFunction(node)\n  return ''\n}\n\n/**\n * Converts a {@link SourceNode} to its TypeScript string representation.\n *\n * Iterates `nodes` in DOM order, rendering each {@link CodeNode} via\n * {@link printCodeNode}.\n *\n * @example From nodes\n * ```ts\n * printSource({ kind: 'Source', nodes: [createConst({ name: 'x', nodes: [createText('1')] }), createText('x.toString()')] })\n * // 'const x = 1\\nx.toString()'\n * ```\n */\nexport function printSource(node: SourceNode): string {\n  const nodes = node.nodes\n\n  if (!nodes || nodes.length === 0) return ''\n  const parts: string[] = []\n\n  for (const child of nodes) {\n    parts.push(printCodeNode(child as CodeNode))\n  }\n\n  return parts.join('\\n')\n}\n\nexport function createImport({\n  name,\n  path,\n  root,\n  isTypeOnly = false,\n  isNameSpace = false,\n}: {\n  name: string | Array<string | { propertyName: string; name?: string }>\n  path: string\n  root?: string\n  /** @default false */\n  isTypeOnly?: boolean\n  /** @default false */\n  isNameSpace?: boolean\n}): ts.ImportDeclaration {\n  const resolvePath = root ? getRelativePath(root, path) : path\n\n  if (!Array.isArray(name)) {\n    if (isNameSpace) {\n      return factory.createImportDeclaration(\n        undefined,\n        factory.createImportClause(isTypeOnly, undefined, factory.createNamespaceImport(factory.createIdentifier(name))),\n        factory.createStringLiteral(resolvePath),\n        undefined,\n      )\n    }\n\n    return factory.createImportDeclaration(\n      undefined,\n      factory.createImportClause(isTypeOnly, factory.createIdentifier(name), undefined),\n      factory.createStringLiteral(resolvePath),\n      undefined,\n    )\n  }\n\n  const specifiers = name.map((item) => {\n    if (typeof item === 'object') {\n      const { propertyName, name: alias } = item\n      return factory.createImportSpecifier(false, alias ? factory.createIdentifier(propertyName) : undefined, factory.createIdentifier(alias ?? propertyName))\n    }\n    return factory.createImportSpecifier(false, undefined, factory.createIdentifier(item))\n  })\n\n  return factory.createImportDeclaration(\n    undefined,\n    factory.createImportClause(isTypeOnly, undefined, factory.createNamedImports(specifiers)),\n    factory.createStringLiteral(resolvePath),\n    undefined,\n  )\n}\n\nexport function createExport({\n  path,\n  asAlias,\n  isTypeOnly = false,\n  name,\n}: {\n  path: string\n  /** @default false */\n  asAlias?: boolean\n  /** @default false */\n  isTypeOnly?: boolean\n  name?: string | Array<ts.Identifier | string>\n}): ts.ExportDeclaration {\n  if (name && !Array.isArray(name) && !asAlias) {\n    console.warn(`When using name as string, asAlias should be true: ${name}`)\n  }\n\n  if (!Array.isArray(name)) {\n    const parsedName = name && LEADING_DIGIT_PATTERN.test(name) ? `_${name.slice(1)}` : name\n\n    return factory.createExportDeclaration(\n      undefined,\n      isTypeOnly,\n      asAlias && parsedName ? factory.createNamespaceExport(factory.createIdentifier(parsedName)) : undefined,\n      factory.createStringLiteral(path),\n      undefined,\n    )\n  }\n\n  return factory.createExportDeclaration(\n    undefined,\n    isTypeOnly,\n    factory.createNamedExports(\n      name.map((propertyName) =>\n        factory.createExportSpecifier(false, undefined, typeof propertyName === 'string' ? factory.createIdentifier(propertyName) : propertyName),\n      ),\n    ),\n    factory.createStringLiteral(path),\n    undefined,\n  )\n}\n","import type { FileNode, SourceNode } from '@kubb/ast'\nimport type { Parser } from '@kubb/core'\nimport { defineParser } from '@kubb/core'\nimport type * as ts from 'typescript'\nimport { createExport, createImport, getRelativePath, print, printSource, resolveOutputPath } from './utils.ts'\n\nexport { createExport, createImport, print, safePrint, validateNodes } from './utils.ts'\n\nexport { printArrowFunction, printCodeNode, printConst, printFunction, printJSDoc, printSource, printType } from './utils.ts'\n\n/**\n * Parser that converts `.ts` and `.js` files to strings using the TypeScript\n * compiler. Handles import/export statement generation from file metadata.\n *\n * @default Used automatically when no `parsers` option is set in `defineConfig`.\n */\nexport const parserTs: Parser = defineParser({\n  name: 'typescript',\n  extNames: ['.ts', '.js'],\n  parse(file, options = { extname: '.ts' }) {\n    const sourceParts: Array<string> = []\n    for (const item of file.sources) {\n      const sourceStr = printSource(item as SourceNode)\n      if (sourceStr) {\n        sourceParts.push(sourceStr.trimEnd())\n      }\n    }\n    const source = sourceParts.join('\\n\\n')\n\n    const importNodes: Array<ts.ImportDeclaration> = []\n    for (const item of (file as FileNode).imports) {\n      const importPath = item.root ? getRelativePath(item.root, item.path) : item.path\n      importNodes.push(\n        createImport({\n          name: item.name as string | Array<string | { propertyName: string; name?: string }>,\n          path: resolveOutputPath(importPath, options, Boolean(item.root)),\n          isTypeOnly: item.isTypeOnly,\n          isNameSpace: item.isNameSpace,\n        }),\n      )\n    }\n\n    const exportNodes: Array<ts.ExportDeclaration> = []\n    for (const item of (file as FileNode).exports) {\n      exportNodes.push(\n        createExport({\n          name: item.name as string | Array<ts.Identifier | string> | undefined,\n          path: resolveOutputPath(item.path, options, true),\n          isTypeOnly: item.isTypeOnly,\n          asAlias: item.asAlias,\n        }),\n      )\n    }\n\n    const parts = [file.banner, print(...importNodes, ...exportNodes), source, file.footer]\n      .filter((segment): segment is string => Boolean(segment))\n      .map((s) => s.trimEnd())\n    return parts.join('\\n\\n')\n  },\n})\n","import type { Parser } from '@kubb/core'\nimport { defineParser } from '@kubb/core'\nimport { parserTs } from './parserTs.ts'\n\n/**\n * Parser that converts `.tsx` and `.jsx` files to strings.\n * Delegates to `typescriptParser` since the TypeScript compiler natively\n * supports JSX/TSX syntax via `ScriptKind.TSX`.\n *\n * Add this parser to the `parsers` option in `defineConfig` when generating `.tsx`/`.jsx` files.\n *\n * @default extname '.tsx'\n */\nexport const parserTsx: Parser = defineParser({\n  name: 'tsx',\n  extNames: ['.tsx', '.jsx'],\n  parse(file, options = { extname: '.tsx' }) {\n    return parserTs.parse(file, options)\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,MAAa,yBAAyB;;;;AAKtC,MAAa,yBAAyB;;;;;AAMtC,MAAa,2BAA2B;;;;AAKxC,MAAa,0BAA0B;;;;AAKvC,MAAa,eAAe;;;;;AAM5B,MAAa,wBAAwB;;;ACrBrC,MAAM,EAAE,YAAYA,WAAAA;;;;AAKpB,SAAgB,MAAM,MAAsB;CAC1C,QAAA,GAAA,UAAA,WAAiB,KAAK,CAAC,WAAW,wBAAwB,IAAI,CAAC,QAAA,OAAiC,GAAG;;;;;;AAOrG,SAAgB,gBAAgB,SAAiB,UAA0B;CAEzE,MAAM,UAAU,OAAA,GAAA,UAAA,UADK,SAAS,SACL,CAAC;CAC1B,OAAO,QAAQ,WAAA,MAAmC,GAAG,UAAU,KAA8B;;;;;;AAO/F,SAAgB,YAAY,MAAsB;CAChD,OAAO,KAAK,QAAQ,wBAAwB,GAAG;;;;;;;AAQjD,SAAgB,kBAAkB,MAAc,SAA2C,WAA4B;CACrH,MAAM,aAAa,uBAAuB,KAAK,KAAK;CACpD,IAAI,SAAS,WAAW,YACtB,OAAO,GAAG,YAAY,KAAK,GAAG,QAAQ;CAExC,OAAO,YAAY,YAAY,KAAK,GAAG;;;;;;;;;AAUzC,SAAgB,WAAW,OAA4C;CACrE,IAAI,CAAC,SAAS,MAAM,WAAW,GAAG,OAAO;CAEzC,MAAM,QAAkB,EAAE;CAE1B,KAAK,MAAM,QAAQ,OACjB,MAAM,KAAK,cAAc,KAAK,CAAC;CAGjC,OAAO,MAAM,KAAK,KAAK;;;;;AAMzB,SAAgB,YAAY,MAAc,SAAA,GAAsC;CAC9E,IAAI,CAAC,MAAM,OAAO;CAClB,MAAM,MAAM,IAAI,OAAO,OAAO;CAC9B,OAAO,KACJ,MAAM,KAAK,CACX,KAAK,SAAU,KAAK,MAAM,GAAG,GAAG,MAAM,SAAS,GAAI,CACnD,KAAK,KAAK;;;;;;AAOf,SAAgB,eAAe,UAA4E;CACzG,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO,IAAI,MAAM,QAAQ,SAAS,GAAG,SAAS,KAAK,KAAK,GAAG,SAAS;;;;;;AAOtE,SAAgB,iBAAiB,YAAgC,SAAsC;CACrG,IAAI,CAAC,YAAY,OAAO;CACxB,OAAO,UAAU,aAAa,WAAW,KAAK,KAAK;;;;;;;AAQrD,SAAgB,cAAc,GAAG,OAAwB;CACvD,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,uDAAuD;EAEzE,IAAI,KAAK,SAASA,WAAAA,QAAG,WAAW,SAC9B,MAAM,IAAI,MACR,qKAEW,KAAK,UAAU,MAAM,MAAM,EAAE,GACzC;;;;;;;;;AAWP,MAAM,aAAaA,WAAAA,QAAG,cAAc;CAClC,uBAAuB;CACvB,SAASA,WAAAA,QAAG,YAAY;CACxB,gBAAgB;CAChB,eAAe;CAChB,CAAC;;;;;AAMF,MAAM,oBAAoBA,WAAAA,QAAG,iBAAiB,aAAa,IAAIA,WAAAA,QAAG,aAAa,QAAQ,MAAMA,WAAAA,QAAG,WAAW,IAAI;AAK/G,WAAW,UAAUA,WAAAA,QAAG,WAAW,WAAW,QAAQ,gBAAgB,EAAE,CAAC,EAAE,kBAAkB;;;;AAK7F,SAAgB,MAAM,GAAG,UAAkC;CACzD,MAAM,WAAW,SAAS,OAAO,QAAQ;CACzC,IAAI,SAAS,WAAW,GAAG,OAAO;CAIlC,OAFe,WAAW,UAAUA,WAAAA,QAAG,WAAW,WAAW,QAAQ,gBAAgB,SAAS,EAAE,kBAEnF,CAAC,QAAQ,cAAc,KAAK;;;;;AAM3C,SAAgB,UAAU,GAAG,UAAkC;CAC7D,cAAc,GAAG,SAAS;CAC1B,OAAO,MAAM,GAAG,SAAS;;;;;;;;;;;;;;AAe3B,SAAgB,WAAW,OAA0B;CACnD,MAAM,YAAY,MAAM,YAAY,EAAE,EAAE,QAAQ,MAAM,KAAK,KAAK;CAChE,IAAI,SAAS,WAAW,GAAG,OAAO;CAElC,MAAM,QAAQ,SACX,SAAS,MAAM,EAAE,MAAM,QAAQ,CAAC,CAChC,KAAK,MAAM,EAAE,QAAQ,0BAA0B,MAAM,CAAC,QAAQ,yBAAyB,GAAG,CAAC,CAC3F,QAAQ,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE;CAErC,IAAI,MAAM,WAAW,GAAG,OAAO;CAE/B,OAAO;EAAC;EAAO,GAAG,MAAM,KAAK,MAAM,MAAM,IAAI;EAAE;EAAM,CAAC,KAAK,KAAK;;;;;;;;;;;;;;;;;;;AAoBlE,SAAgB,WAAW,MAAyB;CAClD,MAAM,EAAE,MAAM,QAAQ,WAAW,MAAM,OAAO,SAAS,UAAU;CAEjE,MAAM,WAAW,QAAQ,WAAW,MAAM,GAAG;CAC7C,MAAM,OAAO,WAAW,MAAM;CAE9B,MAAM,QAAkB,EAAE;CAC1B,IAAI,WAAW,MAAM,KAAK,UAAU;CACpC,MAAM,KAAK,SAAS;CACpB,MAAM,KAAK,KAAK;CAChB,IAAI,MACF,MAAM,KAAK,KAAK,OAAO;CAEzB,MAAM,KAAK,MAAM;CACjB,MAAM,KAAK,KAAK;CAChB,IAAI,SAAS,MAAM,KAAK,YAAY;CAGpC,OAAO,CAAC,UADY,MAAM,KAAK,GACF,CAAC,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK;;;;;;;;;;;;;AAc3D,SAAgB,UAAU,MAAwB;CAChD,MAAM,EAAE,MAAM,QAAQ,WAAW,OAAO,UAAU;CAElD,MAAM,WAAW,QAAQ,WAAW,MAAM,GAAG;CAC7C,MAAM,OAAO,WAAW,MAAM;CAE9B,MAAM,QAAkB,EAAE;CAC1B,IAAI,WAAW,MAAM,KAAK,UAAU;CACpC,MAAM,KAAK,QAAQ;CACnB,MAAM,KAAK,KAAK;CAChB,MAAM,KAAK,MAAM;CACjB,MAAM,KAAK,KAAK;CAGhB,OAAO,CAAC,UADY,MAAM,KAAK,GACF,CAAC,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK;;;;;;;;;;;;;;;;;;;AAoB3D,SAAgB,cAAc,MAA4B;CACxD,MAAM,EAAE,MAAM,SAAS,WAAW,QAAQ,WAAW,OAAO,SAAS,UAAU,QAAQ,YAAY,OAAO,UAAU;CAEpH,MAAM,WAAW,QAAQ,WAAW,MAAM,GAAG;CAC7C,MAAM,OAAO,WAAW,MAAM;CAC9B,MAAM,WAAW,OAAO,YAAY,KAAK,GAAG;CAE5C,MAAM,QAAkB,EAAE;CAC1B,IAAI,WAAW,MAAM,KAAK,UAAU;CACpC,IAAI,WAAW,MAAM,KAAK,WAAW;CACrC,IAAI,SAAS,MAAM,KAAK,SAAS;CACjC,MAAM,KAAK,YAAY;CACvB,MAAM,KAAK,KAAK;CAChB,MAAM,KAAK,eAAe,SAAS,CAAC;CACpC,MAAM,KAAK,IAAI,UAAU,GAAG,GAAG;CAC/B,MAAM,KAAK,iBAAiB,YAAY,QAAQ,CAAC;CACjD,MAAM,KAAK,KAAK;CAChB,IAAI,UACF,MAAM,KAAK,KAAK,SAAS,IAAI;CAE/B,MAAM,KAAK,IAAI;CAGf,OAAO,CAAC,UADY,MAAM,KAAK,GACF,CAAC,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK;;;;;;;;;;;;;;;;;;;AAoB3D,SAAgB,mBAAmB,MAAiC;CAClE,MAAM,EAAE,MAAM,SAAS,WAAW,QAAQ,WAAW,OAAO,SAAS,UAAU,QAAQ,YAAY,OAAO,OAAO,eAAe;CAEhI,MAAM,WAAW,QAAQ,WAAW,MAAM,GAAG;CAC7C,MAAM,OAAO,WAAW,MAAM;CAC9B,MAAM,YAAY,aAAa,OAAO,SAAS,OAAO,UAAU,YAAY,KAAK,CAAC,OAAO;CAEzF,MAAM,QAAkB,EAAE;CAC1B,IAAI,WAAW,MAAM,KAAK,UAAU;CACpC,IAAI,WAAW,MAAM,KAAK,WAAW;CACrC,MAAM,KAAK,SAAS;CACpB,MAAM,KAAK,KAAK;CAChB,MAAM,KAAK,MAAM;CACjB,IAAI,SAAS,MAAM,KAAK,SAAS;CACjC,MAAM,KAAK,eAAe,SAAS,CAAC;CACpC,MAAM,KAAK,IAAI,UAAU,GAAG,GAAG;CAC/B,MAAM,KAAK,iBAAiB,YAAY,QAAQ,CAAC;CACjD,MAAM,KAAK,UAAU;CAGrB,OAAO,CAAC,UADY,MAAM,KAAK,GACF,CAAC,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK;;;;;;;;;;;;;AAc3D,SAAgB,cAAc,MAAwB;CACpD,IAAI,KAAK,SAAS,SAAS,OAAO;CAClC,IAAI,KAAK,SAAS,QAAQ,OAAQ,KAAkB;CACpD,IAAI,KAAK,SAAS,OAAO,OAAQ,KAAiB;CAClD,IAAI,KAAK,SAAS,SAAS,OAAO,WAAW,KAAK;CAClD,IAAI,KAAK,SAAS,QAAQ,OAAO,UAAU,KAAK;CAChD,IAAI,KAAK,SAAS,YAAY,OAAO,cAAc,KAAK;CACxD,IAAI,KAAK,SAAS,iBAAiB,OAAO,mBAAmB,KAAK;CAClE,OAAO;;;;;;;;;;;;;;AAeT,SAAgB,YAAY,MAA0B;CACpD,MAAM,QAAQ,KAAK;CAEnB,IAAI,CAAC,SAAS,MAAM,WAAW,GAAG,OAAO;CACzC,MAAM,QAAkB,EAAE;CAE1B,KAAK,MAAM,SAAS,OAClB,MAAM,KAAK,cAAc,MAAkB,CAAC;CAG9C,OAAO,MAAM,KAAK,KAAK;;AAGzB,SAAgB,aAAa,EAC3B,MACA,MACA,MACA,aAAa,OACb,cAAc,SASS;CACvB,MAAM,cAAc,OAAO,gBAAgB,MAAM,KAAK,GAAG;CAEzD,IAAI,CAAC,MAAM,QAAQ,KAAK,EAAE;EACxB,IAAI,aACF,OAAO,QAAQ,wBACb,KAAA,GACA,QAAQ,mBAAmB,YAAY,KAAA,GAAW,QAAQ,sBAAsB,QAAQ,iBAAiB,KAAK,CAAC,CAAC,EAChH,QAAQ,oBAAoB,YAAY,EACxC,KAAA,EACD;EAGH,OAAO,QAAQ,wBACb,KAAA,GACA,QAAQ,mBAAmB,YAAY,QAAQ,iBAAiB,KAAK,EAAE,KAAA,EAAU,EACjF,QAAQ,oBAAoB,YAAY,EACxC,KAAA,EACD;;CAGH,MAAM,aAAa,KAAK,KAAK,SAAS;EACpC,IAAI,OAAO,SAAS,UAAU;GAC5B,MAAM,EAAE,cAAc,MAAM,UAAU;GACtC,OAAO,QAAQ,sBAAsB,OAAO,QAAQ,QAAQ,iBAAiB,aAAa,GAAG,KAAA,GAAW,QAAQ,iBAAiB,SAAS,aAAa,CAAC;;EAE1J,OAAO,QAAQ,sBAAsB,OAAO,KAAA,GAAW,QAAQ,iBAAiB,KAAK,CAAC;GACtF;CAEF,OAAO,QAAQ,wBACb,KAAA,GACA,QAAQ,mBAAmB,YAAY,KAAA,GAAW,QAAQ,mBAAmB,WAAW,CAAC,EACzF,QAAQ,oBAAoB,YAAY,EACxC,KAAA,EACD;;AAGH,SAAgB,aAAa,EAC3B,MACA,SACA,aAAa,OACb,QAQuB;CACvB,IAAI,QAAQ,CAAC,MAAM,QAAQ,KAAK,IAAI,CAAC,SACnC,QAAQ,KAAK,sDAAsD,OAAO;CAG5E,IAAI,CAAC,MAAM,QAAQ,KAAK,EAAE;EACxB,MAAM,aAAa,QAAQ,sBAAsB,KAAK,KAAK,GAAG,IAAI,KAAK,MAAM,EAAE,KAAK;EAEpF,OAAO,QAAQ,wBACb,KAAA,GACA,YACA,WAAW,aAAa,QAAQ,sBAAsB,QAAQ,iBAAiB,WAAW,CAAC,GAAG,KAAA,GAC9F,QAAQ,oBAAoB,KAAK,EACjC,KAAA,EACD;;CAGH,OAAO,QAAQ,wBACb,KAAA,GACA,YACA,QAAQ,mBACN,KAAK,KAAK,iBACR,QAAQ,sBAAsB,OAAO,KAAA,GAAW,OAAO,iBAAiB,WAAW,QAAQ,iBAAiB,aAAa,GAAG,aAAa,CAC1I,CACF,EACD,QAAQ,oBAAoB,KAAK,EACjC,KAAA,EACD;;;;;;;;;;AChdH,MAAa,YAAA,GAAA,WAAA,cAAgC;CAC3C,MAAM;CACN,UAAU,CAAC,OAAO,MAAM;CACxB,MAAM,MAAM,UAAU,EAAE,SAAS,OAAO,EAAE;EACxC,MAAM,cAA6B,EAAE;EACrC,KAAK,MAAM,QAAQ,KAAK,SAAS;GAC/B,MAAM,YAAY,YAAY,KAAmB;GACjD,IAAI,WACF,YAAY,KAAK,UAAU,SAAS,CAAC;;EAGzC,MAAM,SAAS,YAAY,KAAK,OAAO;EAEvC,MAAM,cAA2C,EAAE;EACnD,KAAK,MAAM,QAAS,KAAkB,SAAS;GAC7C,MAAM,aAAa,KAAK,OAAO,gBAAgB,KAAK,MAAM,KAAK,KAAK,GAAG,KAAK;GAC5E,YAAY,KACV,aAAa;IACX,MAAM,KAAK;IACX,MAAM,kBAAkB,YAAY,SAAS,QAAQ,KAAK,KAAK,CAAC;IAChE,YAAY,KAAK;IACjB,aAAa,KAAK;IACnB,CAAC,CACH;;EAGH,MAAM,cAA2C,EAAE;EACnD,KAAK,MAAM,QAAS,KAAkB,SACpC,YAAY,KACV,aAAa;GACX,MAAM,KAAK;GACX,MAAM,kBAAkB,KAAK,MAAM,SAAS,KAAK;GACjD,YAAY,KAAK;GACjB,SAAS,KAAK;GACf,CAAC,CACH;EAMH,OAHc;GAAC,KAAK;GAAQ,MAAM,GAAG,aAAa,GAAG,YAAY;GAAE;GAAQ,KAAK;GAAO,CACpF,QAAQ,YAA+B,QAAQ,QAAQ,CAAC,CACxD,KAAK,MAAM,EAAE,SAAS,CACb,CAAC,KAAK,OAAO;;CAE5B,CAAC;;;;;;;;;;;;AC9CF,MAAa,aAAA,GAAA,WAAA,cAAiC;CAC5C,MAAM;CACN,UAAU,CAAC,QAAQ,OAAO;CAC1B,MAAM,MAAM,UAAU,EAAE,SAAS,QAAQ,EAAE;EACzC,OAAO,SAAS,MAAM,MAAM,QAAQ;;CAEvC,CAAC"}
+{"version":3,"file":"index.cjs","names":["ts"],"sources":["../src/constants.ts","../src/utils.ts","../src/parserTs.ts","../src/parserTsx.ts"],"sourcesContent":["/**\n * Number of spaces used to indent a nested block when pretty-printing.\n */\nexport const INDENT_SIZE = 2 as const\n\n/**\n * Matches the trailing `.<ext>` segment of a path (keeps segments like `foo.bar.ts`\n * intact by only trimming the last run of non-`/`/`.` characters).\n */\nexport const FILE_EXTENSION_PATTERN = /\\.[^/.]+$/\n\n/**\n * Matches Windows-style backslash path separators.\n */\nexport const WINDOWS_PATH_SEPARATOR = /\\\\/g\n\n/**\n * Matches `*\\/` in free-form text so JSDoc bodies can neutralize premature\n * comment terminators (`*\\/` → `* /`).\n */\nexport const JSDOC_TERMINATOR_PATTERN = /\\*\\//g\n\n/**\n * Matches carriage returns for normalizing CRLF/CR line endings to LF.\n */\nexport const CARRIAGE_RETURN_PATTERN = /\\r/g\n\n/**\n * Matches CRLF sequences used when normalizing TypeScript printer output.\n */\nexport const CRLF_PATTERN = /\\r\\n/g\n\n/**\n * Matches an identifier that starts with a digit — JavaScript disallows this\n * so the printer prefixes such names with `_`.\n */\nexport const LEADING_DIGIT_PATTERN = /^\\d/\n\n/**\n * Relative path prefix used to detect traversal segments (`../`).\n */\nexport const PARENT_DIRECTORY_PREFIX = '../' as const\n\n/**\n * Relative path prefix used when resolving imports within the output root.\n */\nexport const CURRENT_DIRECTORY_PREFIX = './' as const\n","import { normalize, relative } from 'node:path'\nimport type { ArrowFunctionNode, CodeNode, ConstNode, FunctionNode, JSDocNode, JsxNode, SourceNode, TextNode, TypeNode } from '@kubb/ast'\nimport ts from 'typescript'\nimport {\n  CARRIAGE_RETURN_PATTERN,\n  CRLF_PATTERN,\n  CURRENT_DIRECTORY_PREFIX,\n  FILE_EXTENSION_PATTERN,\n  INDENT_SIZE,\n  JSDOC_TERMINATOR_PATTERN,\n  LEADING_DIGIT_PATTERN,\n  PARENT_DIRECTORY_PREFIX,\n  WINDOWS_PATH_SEPARATOR,\n} from './constants.ts'\n\nconst { factory } = ts\n\n/**\n * Normalizes a file-system path to POSIX separators and strips any leading `../` segment.\n */\nexport function slash(path: string): string {\n  return normalize(path).replaceAll(WINDOWS_PATH_SEPARATOR, '/').replace(PARENT_DIRECTORY_PREFIX, '')\n}\n\n/**\n * Resolves `filePath` relative to `rootDir` and returns a POSIX-style path\n * prefixed with `./` when the target sits inside the root, or `../` when it escapes it.\n */\nexport function getRelativePath(rootDir: string, filePath: string): string {\n  const rel = relative(rootDir, filePath)\n  const slashed = slash(rel)\n  return slashed.startsWith(PARENT_DIRECTORY_PREFIX) ? slashed : `${CURRENT_DIRECTORY_PREFIX}${slashed}`\n}\n\n/**\n * Strips the trailing file extension (for example `.ts`) from a path.\n * Preserves intermediate dots like `foo.bar.ts` → `foo.bar`.\n */\nexport function trimExtName(text: string): string {\n  return text.replace(FILE_EXTENSION_PATTERN, '')\n}\n\n/**\n * Rewrites an import/export path so its extension matches the caller-supplied\n * `options.extname`. When the source path has no extension the original is kept,\n * so virtual/module-only paths flow through unchanged.\n */\nexport function resolveOutputPath(path: string, options: { extname?: string } | undefined, rootAware: boolean): string {\n  const hasExtname = FILE_EXTENSION_PATTERN.test(path)\n  if (options?.extname && hasExtname) {\n    return `${trimExtName(path)}${options.extname}`\n  }\n  return rootAware ? trimExtName(path) : path\n}\n\n/**\n * Serializes the body / value content from a `nodes` array.\n *\n * Each element is either a raw string or a structured {@link CodeNode}\n * (recursively converted via {@link printCodeNode}).\n * Elements are joined with `\\n`.\n */\nexport function printNodes(nodes: Array<CodeNode> | undefined): string {\n  if (!nodes || nodes.length === 0) return ''\n\n  const parts: string[] = []\n\n  for (const node of nodes) {\n    parts.push(printCodeNode(node))\n  }\n\n  return parts.join('\\n')\n}\n\n/**\n * Indents every non-empty line of `text` by `spaces` spaces.\n */\nexport function indentLines(text: string, spaces: number = INDENT_SIZE): string {\n  if (!text) return ''\n  const pad = ' '.repeat(spaces)\n  return text\n    .split('\\n')\n    .map((line) => (line.trim() ? `${pad}${line}` : ''))\n    .join('\\n')\n}\n\n/**\n * Renders the generic clause (`<T, U>`) shared by function and arrow-function nodes.\n * Accepts either a raw string (rendered verbatim) or an array of type-parameter names.\n */\nexport function formatGenerics(generics: FunctionNode['generics'] | ArrowFunctionNode['generics']): string {\n  if (!generics) return ''\n  return `<${Array.isArray(generics) ? generics.join(', ') : generics}>`\n}\n\n/**\n * Renders the return-type suffix (`: T` or `: Promise<T>` when `isAsync` is true).\n * Returns an empty string when no return type is provided.\n */\nexport function formatReturnType(returnType: string | null | undefined, isAsync: boolean | null | undefined): string {\n  if (!returnType) return ''\n  return isAsync ? `: Promise<${returnType}>` : `: ${returnType}`\n}\n\n/**\n * Validates TypeScript AST nodes before printing.\n * Throws an error if any node has SyntaxKind.Unknown which would cause the\n * TypeScript printer to crash.\n */\nexport function validateNodes(...nodes: ts.Node[]): void {\n  for (const node of nodes) {\n    if (!node) {\n      throw new Error('Attempted to print undefined or null TypeScript node')\n    }\n    if (node.kind === ts.SyntaxKind.Unknown) {\n      throw new Error(\n        'Invalid TypeScript AST node detected with SyntaxKind.Unknown. ' +\n          'This typically indicates a schema pattern that could not be properly converted to TypeScript. ' +\n          `Node: ${JSON.stringify(node, null, 2)}`,\n      )\n    }\n  }\n}\n\n/**\n * Module-scoped TypeScript printer instance. `ts.createPrinter()` is stateless across calls\n * (it does not mutate the source file) so a single instance can be safely reused for every\n * `print()` call. Hoisting it out of `print()` avoids re-running the printer initialization\n * for each file's import/export section.\n */\nconst TS_PRINTER = ts.createPrinter({\n  omitTrailingSemicolon: true,\n  newLine: ts.NewLineKind.LineFeed,\n  removeComments: false,\n  noEmitHelpers: true,\n})\n\n/**\n * Module-scoped source file used as the print target. `printList` only reads the source\n * file's compiler options / language version; it never mutates it.\n */\nconst PRINT_SOURCE_FILE = ts.createSourceFile('print.tsx', '', ts.ScriptTarget.ES2022, true, ts.ScriptKind.TSX)\n\n// Pre-warm the printer at module load. The first `printList` call lazily initializes\n// the printer's internal string-builder and identifier tables; doing it once at import\n// time keeps that cost off the critical path for short-lived CLI builds.\nTS_PRINTER.printList(ts.ListFormat.MultiLine, factory.createNodeArray([]), PRINT_SOURCE_FILE)\n\n/**\n * Converts TypeScript/TSX AST nodes to a string using the TypeScript printer.\n */\nexport function print(...elements: Array<ts.Node>): string {\n  const filtered = elements.filter(Boolean)\n  if (filtered.length === 0) return ''\n\n  const output = TS_PRINTER.printList(ts.ListFormat.MultiLine, factory.createNodeArray(filtered), PRINT_SOURCE_FILE)\n\n  return output.replace(CRLF_PATTERN, '\\n')\n}\n\n/**\n * Like `print` but validates nodes first to surface issues early.\n */\nexport function safePrint(...elements: Array<ts.Node>): string {\n  validateNodes(...elements)\n  return print(...elements)\n}\n\n/**\n * Converts a {@link JSDocNode} to a JSDoc comment block string.\n *\n * @example\n * ```ts\n * printJSDoc({ comments: ['@description A pet', '@deprecated'] })\n * // /**\n * //  * @description A pet\n * //  * @deprecated\n * //  *\\/\n * ```\n */\nexport function printJSDoc(jsDoc: JSDocNode): string {\n  const comments = (jsDoc.comments ?? []).filter((c) => c != null)\n  if (comments.length === 0) return ''\n\n  const lines = comments\n    .flatMap((c) => c.split(/\\r?\\n/))\n    .map((l) => l.replace(JSDOC_TERMINATOR_PATTERN, '* /').replace(CARRIAGE_RETURN_PATTERN, ''))\n    .filter((l) => l.trim().length > 0)\n\n  if (lines.length === 0) return ''\n\n  return ['/**', ...lines.map((l) => ` * ${l}`), ' */'].join('\\n')\n}\n\n/**\n * Converts a {@link ConstNode} to a TypeScript `const` declaration string.\n *\n * Mirrors the `Const` component from `@kubb/renderer-jsx`.\n *\n * @example\n * ```ts\n * printConst(createConst({ name: 'pet', export: true, nodes: ['{}'] }))\n * // 'export const pet = {}'\n * ```\n *\n * @example With type and `as const`\n * ```ts\n * printConst(createConst({ name: 'pets', export: true, type: 'Pet[]', asConst: true, nodes: ['[]'] }))\n * // 'export const pets: Pet[] = [] as const'\n * ```\n */\nexport function printConst(node: ConstNode): string {\n  const { name, export: canExport, type, JSDoc, asConst, nodes } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  parts.push('const ')\n  parts.push(name)\n  if (type) {\n    parts.push(`: ${type}`)\n  }\n  parts.push(' = ')\n  parts.push(body)\n  if (asConst) parts.push(' as const')\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts a {@link TypeNode} to a TypeScript `type` alias declaration string.\n *\n * Mirrors the `Type` component from `@kubb/renderer-jsx`.\n *\n * @example\n * ```ts\n * printType(createType({ name: 'Pet', export: true, nodes: ['{ id: number }'] }))\n * // 'export type Pet = { id: number }'\n * ```\n */\nexport function printType(node: TypeNode): string {\n  const { name, export: canExport, JSDoc, nodes } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  parts.push('type ')\n  parts.push(name)\n  parts.push(' = ')\n  parts.push(body)\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts a {@link FunctionNode} to a TypeScript `function` declaration string.\n *\n * Mirrors the `Function` component from `@kubb/renderer-jsx`.\n *\n * @example\n * ```ts\n * printFunction(createFunction({ name: 'getPet', export: true, params: 'id: string', returnType: 'Pet', nodes: ['return fetch(id)'] }))\n * // 'export function getPet(id: string): Pet {\\n  return fetch(id)\\n}'\n * ```\n *\n * @example Async with generics\n * ```ts\n * printFunction(createFunction({ name: 'fetchPet', export: true, async: true, generics: ['T'], params: 'id: string', returnType: 'T' }))\n * // 'export async function fetchPet<T>(id: string): Promise<T> {\\n}'\n * ```\n */\nexport function printFunction(node: FunctionNode): string {\n  const { name, default: isDefault, export: canExport, async: isAsync, generics, params, returnType, JSDoc, nodes } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n  const indented = body ? indentLines(body) : ''\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  if (isDefault) parts.push('default ')\n  if (isAsync) parts.push('async ')\n  parts.push('function ')\n  parts.push(name)\n  parts.push(formatGenerics(generics))\n  parts.push(`(${params ?? ''})`)\n  parts.push(formatReturnType(returnType, isAsync))\n  parts.push(' {')\n  if (indented) {\n    parts.push(`\\n${indented}\\n`)\n  }\n  parts.push('}')\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts an {@link ArrowFunctionNode} to a TypeScript arrow function declaration string.\n *\n * Mirrors the `Function.Arrow` component from `@kubb/renderer-jsx`.\n *\n * @example Multi-line arrow function\n * ```ts\n * printArrowFunction(createArrowFunction({ name: 'getPet', export: true, params: 'id: string', nodes: ['return fetch(id)'] }))\n * // 'export const getPet = (id: string) => {\\n  return fetch(id)\\n}'\n * ```\n *\n * @example Single-line arrow function\n * ```ts\n * printArrowFunction(createArrowFunction({ name: 'double', params: 'n: number', singleLine: true, nodes: ['n * 2'] }))\n * // 'const double = (n: number) => n * 2'\n * ```\n */\nexport function printArrowFunction(node: ArrowFunctionNode): string {\n  const { name, default: isDefault, export: canExport, async: isAsync, generics, params, returnType, JSDoc, nodes, singleLine } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n  const arrowBody = singleLine ? ` => ${body}` : body ? ` => {\\n${indentLines(body)}\\n}` : ' => {}'\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  if (isDefault) parts.push('default ')\n  parts.push('const ')\n  parts.push(name)\n  parts.push(' = ')\n  if (isAsync) parts.push('async ')\n  parts.push(formatGenerics(generics))\n  parts.push(`(${params ?? ''})`)\n  parts.push(formatReturnType(returnType, isAsync))\n  parts.push(arrowBody)\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts a {@link CodeNode} to its TypeScript string representation.\n *\n * Dispatches to the appropriate printer based on the node's `kind`.\n *\n * @example\n * ```ts\n * printCodeNode(createConst({ name: 'x', nodes: ['1'] }))\n * // 'const x = 1'\n * ```\n */\nexport function printCodeNode(node: CodeNode): string {\n  if (node.kind === 'Break') return ''\n  if (node.kind === 'Text') return (node as TextNode).value\n  if (node.kind === 'Jsx') return (node as JsxNode).value\n  if (node.kind === 'Const') return printConst(node)\n  if (node.kind === 'Type') return printType(node)\n  if (node.kind === 'Function') return printFunction(node)\n  if (node.kind === 'ArrowFunction') return printArrowFunction(node)\n  return ''\n}\n\n/**\n * Converts a {@link SourceNode} to its TypeScript string representation.\n *\n * Iterates `nodes` in DOM order, rendering each {@link CodeNode} via\n * {@link printCodeNode}.\n *\n * @example From nodes\n * ```ts\n * printSource({ kind: 'Source', nodes: [createConst({ name: 'x', nodes: [createText('1')] }), createText('x.toString()')] })\n * // 'const x = 1\\nx.toString()'\n * ```\n */\nexport function printSource(node: SourceNode): string {\n  const nodes = node.nodes\n\n  if (!nodes || nodes.length === 0) return ''\n  const parts: string[] = []\n\n  for (const child of nodes) {\n    parts.push(printCodeNode(child as CodeNode))\n  }\n\n  return parts.join('\\n')\n}\n\nexport function createImport({\n  name,\n  path,\n  root,\n  isTypeOnly: isTypeOnlyRaw = false,\n  isNameSpace: isNameSpaceRaw = false,\n}: {\n  name: string | Array<string | { propertyName: string; name?: string }>\n  path: string\n  root?: string | null\n  /** @default false */\n  isTypeOnly?: boolean | null\n  /** @default false */\n  isNameSpace?: boolean | null\n}): ts.ImportDeclaration {\n  const isTypeOnly = isTypeOnlyRaw ?? false\n  const isNameSpace = isNameSpaceRaw ?? false\n  const resolvePath = root ? getRelativePath(root, path) : path\n\n  if (!Array.isArray(name)) {\n    if (isNameSpace) {\n      return factory.createImportDeclaration(\n        undefined,\n        factory.createImportClause(isTypeOnly, undefined, factory.createNamespaceImport(factory.createIdentifier(name))),\n        factory.createStringLiteral(resolvePath),\n        undefined,\n      )\n    }\n\n    return factory.createImportDeclaration(\n      undefined,\n      factory.createImportClause(isTypeOnly, factory.createIdentifier(name), undefined),\n      factory.createStringLiteral(resolvePath),\n      undefined,\n    )\n  }\n\n  const specifiers = name.map((item) => {\n    if (typeof item === 'object') {\n      const { propertyName, name: alias } = item\n      return factory.createImportSpecifier(false, alias ? factory.createIdentifier(propertyName) : undefined, factory.createIdentifier(alias ?? propertyName))\n    }\n    return factory.createImportSpecifier(false, undefined, factory.createIdentifier(item))\n  })\n\n  return factory.createImportDeclaration(\n    undefined,\n    factory.createImportClause(isTypeOnly, undefined, factory.createNamedImports(specifiers)),\n    factory.createStringLiteral(resolvePath),\n    undefined,\n  )\n}\n\nexport function createExport({\n  path,\n  asAlias: asAliasRaw,\n  isTypeOnly: isTypeOnlyRaw = false,\n  name,\n}: {\n  path: string\n  /** @default false */\n  asAlias?: boolean | null\n  /** @default false */\n  isTypeOnly?: boolean | null\n  name?: string | Array<ts.Identifier | string> | null\n}): ts.ExportDeclaration {\n  const asAlias = asAliasRaw ?? false\n  const isTypeOnly = isTypeOnlyRaw ?? false\n  if (name && !Array.isArray(name) && !asAlias) {\n    console.warn(`When using name as string, asAlias should be true: ${name}`)\n  }\n\n  if (!Array.isArray(name)) {\n    const parsedName = name && LEADING_DIGIT_PATTERN.test(name) ? `_${name.slice(1)}` : name\n\n    return factory.createExportDeclaration(\n      undefined,\n      isTypeOnly,\n      asAlias && parsedName ? factory.createNamespaceExport(factory.createIdentifier(parsedName)) : undefined,\n      factory.createStringLiteral(path),\n      undefined,\n    )\n  }\n\n  return factory.createExportDeclaration(\n    undefined,\n    isTypeOnly,\n    factory.createNamedExports(\n      name.map((propertyName) =>\n        factory.createExportSpecifier(false, undefined, typeof propertyName === 'string' ? factory.createIdentifier(propertyName) : propertyName),\n      ),\n    ),\n    factory.createStringLiteral(path),\n    undefined,\n  )\n}\n","import type { FileNode, SourceNode } from '@kubb/ast'\nimport type { Parser } from '@kubb/core'\nimport { defineParser } from '@kubb/core'\nimport type * as ts from 'typescript'\nimport { createExport, createImport, getRelativePath, print, printSource, resolveOutputPath } from './utils.ts'\n\nexport { createExport, createImport, print, safePrint, validateNodes } from './utils.ts'\n\nexport { printArrowFunction, printCodeNode, printConst, printFunction, printJSDoc, printSource, printType } from './utils.ts'\n\n/**\n * Default Kubb parser for `.ts` and `.js` files. Takes the universal AST\n * produced by an adapter and prints it as TypeScript source using the official\n * TypeScript compiler. Imports and exports are rewritten based on each file's\n * metadata.\n *\n * Used automatically when no `parsers` option is set on `defineConfig`. Use\n * `parserTsx` instead for React projects that emit JSX.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { adapterOas } from '@kubb/adapter-oas'\n * import { parserTs } from '@kubb/parser-ts'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   adapter: adapterOas(),\n *   parsers: [parserTs],\n *   plugins: [],\n * })\n * ```\n */\nexport const parserTs: Parser = defineParser({\n  name: 'typescript',\n  extNames: ['.ts', '.js'],\n  parse(file, options = { extname: '.ts' }) {\n    const sourceParts: Array<string> = []\n    for (const item of file.sources) {\n      const sourceStr = printSource(item as SourceNode)\n      if (sourceStr) {\n        sourceParts.push(sourceStr.trimEnd())\n      }\n    }\n    const source = sourceParts.join('\\n\\n')\n\n    const importNodes: Array<ts.ImportDeclaration> = []\n    for (const item of (file as FileNode).imports) {\n      const importPath = item.root ? getRelativePath(item.root, item.path) : item.path\n      importNodes.push(\n        createImport({\n          name: item.name as string | Array<string | { propertyName: string; name?: string }>,\n          path: resolveOutputPath(importPath, options, Boolean(item.root)),\n          isTypeOnly: item.isTypeOnly,\n          isNameSpace: item.isNameSpace,\n        }),\n      )\n    }\n\n    const exportNodes: Array<ts.ExportDeclaration> = []\n    for (const item of (file as FileNode).exports) {\n      exportNodes.push(\n        createExport({\n          name: item.name as string | Array<ts.Identifier | string> | null | undefined,\n          path: resolveOutputPath(item.path, options, true),\n          isTypeOnly: item.isTypeOnly,\n          asAlias: item.asAlias,\n        }),\n      )\n    }\n\n    const parts = [file.banner, print(...importNodes, ...exportNodes), source, file.footer]\n      .filter((segment): segment is string => Boolean(segment))\n      .map((s) => s.trimEnd())\n    return parts.join('\\n\\n')\n  },\n})\n","import type { Parser } from '@kubb/core'\nimport { defineParser } from '@kubb/core'\nimport { parserTs } from './parserTs.ts'\n\n/**\n * Kubb parser for `.tsx` and `.jsx` files. Delegates to `parserTs` because the\n * TypeScript compiler handles JSX natively via `ScriptKind.TSX`.\n *\n * Add to the `parsers` array on `defineConfig` when generating components for\n * React (or any framework that emits JSX).\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { adapterOas } from '@kubb/adapter-oas'\n * import { parserTsx } from '@kubb/parser-ts'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   adapter: adapterOas(),\n *   parsers: [parserTsx],\n *   plugins: [],\n * })\n * ```\n */\nexport const parserTsx: Parser = defineParser({\n  name: 'tsx',\n  extNames: ['.tsx', '.jsx'],\n  parse(file, options = { extname: '.tsx' }) {\n    return parserTs.parse(file, options)\n  },\n})\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -20,48 +20,79 @@ declare function createImport({
   name,
   path,
   root,
-  isTypeOnly,
-  isNameSpace
+  isTypeOnly: isTypeOnlyRaw,
+  isNameSpace: isNameSpaceRaw
 }: {
   name: string | Array<string | {
     propertyName: string;
     name?: string;
   }>;
   path: string;
-  root?: string; /** @default false */
-  isTypeOnly?: boolean; /** @default false */
-  isNameSpace?: boolean;
+  root?: string | null; /** @default false */
+  isTypeOnly?: boolean | null; /** @default false */
+  isNameSpace?: boolean | null;
 }): ts.ImportDeclaration;
 declare function createExport({
   path,
-  asAlias,
-  isTypeOnly,
+  asAlias: asAliasRaw,
+  isTypeOnly: isTypeOnlyRaw,
   name
 }: {
   path: string; /** @default false */
-  asAlias?: boolean; /** @default false */
-  isTypeOnly?: boolean;
-  name?: string | Array<ts.Identifier | string>;
+  asAlias?: boolean | null; /** @default false */
+  isTypeOnly?: boolean | null;
+  name?: string | Array<ts.Identifier | string> | null;
 }): ts.ExportDeclaration;
 //#endregion
 //#region src/parserTs.d.ts
 /**
- * Parser that converts `.ts` and `.js` files to strings using the TypeScript
- * compiler. Handles import/export statement generation from file metadata.
+ * 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.
  *
- * @default Used automatically when no `parsers` option is set in `defineConfig`.
+ * 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: [],
+ * })
+ * ```
  */
 declare const parserTs: Parser;
 //#endregion
 //#region src/parserTsx.d.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: [],
+ * })
+ * ```
  */
 declare const parserTsx: Parser;
 //#endregion

package/dist/index.js

@@ -333,7 +333,9 @@ function printSource(node) {
 	for (const child of nodes) parts.push(printCodeNode(child));
 	return parts.join("\n");
 }
-function createImport({ name, path, root, isTypeOnly = false, isNameSpace = false }) {
+function createImport({ name, path, root, isTypeOnly: isTypeOnlyRaw = false, isNameSpace: isNameSpaceRaw = false }) {
+	const isTypeOnly = isTypeOnlyRaw ?? false;
+	const isNameSpace = isNameSpaceRaw ?? 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);
@@ -348,7 +350,9 @@ function createImport({ name, path, root, isTypeOnly = false, isNameSpace = fals
 	});
 	return factory.createImportDeclaration(void 0, factory.createImportClause(isTypeOnly, void 0, factory.createNamedImports(specifiers)), factory.createStringLiteral(resolvePath), void 0);
 }
-function createExport({ path, asAlias, isTypeOnly = false, name }) {
+function createExport({ path, asAlias: asAliasRaw, isTypeOnly: isTypeOnlyRaw = false, name }) {
+	const asAlias = asAliasRaw ?? false;
+	const isTypeOnly = isTypeOnlyRaw ?? false;
 	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;
@@ -359,10 +363,28 @@ function createExport({ path, asAlias, isTypeOnly = false, name }) {
 //#endregion
 //#region src/parserTs.ts
 /**
-* Parser that converts `.ts` and `.js` files to strings using the TypeScript
-* compiler. Handles import/export statement generation from file metadata.
+* 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.
 *
-* @default Used automatically when no `parsers` option is set in `defineConfig`.
+* 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 = defineParser({
 	name: "typescript",
@@ -402,13 +424,26 @@ const parserTs = 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 this parser to the `parsers` option in `defineConfig` when generating `.tsx`/`.jsx` files.
+* Add to the `parsers` array on `defineConfig` when generating components for
+* React (or any framework that emits JSX).
 *
-* @default extname '.tsx'
+* @example
+* ```ts
+* import { defineConfig } from 'kubb'
+* import { adapterOas } from '@kubb/adapter-oas'
+* import { parserTsx } from '@kubb/parser-ts'
+*
+* export default defineConfig({
+*   input: { path: './petStore.yaml' },
+*   output: { path: './src/gen' },
+*   adapter: adapterOas(),
+*   parsers: [parserTsx],
+*   plugins: [],
+* })
+* ```
 */
 const parserTsx = defineParser({
 	name: "tsx",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/constants.ts","../src/utils.ts","../src/parserTs.ts","../src/parserTsx.ts"],"sourcesContent":["/**\n * Number of spaces used to indent a nested block when pretty-printing.\n */\nexport const INDENT_SIZE = 2 as const\n\n/**\n * Matches the trailing `.<ext>` segment of a path (keeps segments like `foo.bar.ts`\n * intact by only trimming the last run of non-`/`/`.` characters).\n */\nexport const FILE_EXTENSION_PATTERN = /\\.[^/.]+$/\n\n/**\n * Matches Windows-style backslash path separators.\n */\nexport const WINDOWS_PATH_SEPARATOR = /\\\\/g\n\n/**\n * Matches `*\\/` in free-form text so JSDoc bodies can neutralize premature\n * comment terminators (`*\\/` → `* /`).\n */\nexport const JSDOC_TERMINATOR_PATTERN = /\\*\\//g\n\n/**\n * Matches carriage returns for normalizing CRLF/CR line endings to LF.\n */\nexport const CARRIAGE_RETURN_PATTERN = /\\r/g\n\n/**\n * Matches CRLF sequences used when normalizing TypeScript printer output.\n */\nexport const CRLF_PATTERN = /\\r\\n/g\n\n/**\n * Matches an identifier that starts with a digit — JavaScript disallows this\n * so the printer prefixes such names with `_`.\n */\nexport const LEADING_DIGIT_PATTERN = /^\\d/\n\n/**\n * Relative path prefix used to detect traversal segments (`../`).\n */\nexport const PARENT_DIRECTORY_PREFIX = '../' as const\n\n/**\n * Relative path prefix used when resolving imports within the output root.\n */\nexport const CURRENT_DIRECTORY_PREFIX = './' as const\n","import { normalize, relative } from 'node:path'\nimport type { ArrowFunctionNode, CodeNode, ConstNode, FunctionNode, JSDocNode, JsxNode, SourceNode, TextNode, TypeNode } from '@kubb/ast'\nimport ts from 'typescript'\nimport {\n  CARRIAGE_RETURN_PATTERN,\n  CRLF_PATTERN,\n  CURRENT_DIRECTORY_PREFIX,\n  FILE_EXTENSION_PATTERN,\n  INDENT_SIZE,\n  JSDOC_TERMINATOR_PATTERN,\n  LEADING_DIGIT_PATTERN,\n  PARENT_DIRECTORY_PREFIX,\n  WINDOWS_PATH_SEPARATOR,\n} from './constants.ts'\n\nconst { factory } = ts\n\n/**\n * Normalizes a file-system path to POSIX separators and strips any leading `../` segment.\n */\nexport function slash(path: string): string {\n  return normalize(path).replaceAll(WINDOWS_PATH_SEPARATOR, '/').replace(PARENT_DIRECTORY_PREFIX, '')\n}\n\n/**\n * Resolves `filePath` relative to `rootDir` and returns a POSIX-style path\n * prefixed with `./` when the target sits inside the root, or `../` when it escapes it.\n */\nexport function getRelativePath(rootDir: string, filePath: string): string {\n  const rel = relative(rootDir, filePath)\n  const slashed = slash(rel)\n  return slashed.startsWith(PARENT_DIRECTORY_PREFIX) ? slashed : `${CURRENT_DIRECTORY_PREFIX}${slashed}`\n}\n\n/**\n * Strips the trailing file extension (for example `.ts`) from a path.\n * Preserves intermediate dots like `foo.bar.ts` → `foo.bar`.\n */\nexport function trimExtName(text: string): string {\n  return text.replace(FILE_EXTENSION_PATTERN, '')\n}\n\n/**\n * Rewrites an import/export path so its extension matches the caller-supplied\n * `options.extname`. When the source path has no extension the original is kept,\n * so virtual/module-only paths flow through unchanged.\n */\nexport function resolveOutputPath(path: string, options: { extname?: string } | undefined, rootAware: boolean): string {\n  const hasExtname = FILE_EXTENSION_PATTERN.test(path)\n  if (options?.extname && hasExtname) {\n    return `${trimExtName(path)}${options.extname}`\n  }\n  return rootAware ? trimExtName(path) : path\n}\n\n/**\n * Serializes the body / value content from a `nodes` array.\n *\n * Each element is either a raw string or a structured {@link CodeNode}\n * (recursively converted via {@link printCodeNode}).\n * Elements are joined with `\\n`.\n */\nexport function printNodes(nodes: Array<CodeNode> | undefined): string {\n  if (!nodes || nodes.length === 0) return ''\n\n  const parts: string[] = []\n\n  for (const node of nodes) {\n    parts.push(printCodeNode(node))\n  }\n\n  return parts.join('\\n')\n}\n\n/**\n * Indents every non-empty line of `text` by `spaces` spaces.\n */\nexport function indentLines(text: string, spaces: number = INDENT_SIZE): string {\n  if (!text) return ''\n  const pad = ' '.repeat(spaces)\n  return text\n    .split('\\n')\n    .map((line) => (line.trim() ? `${pad}${line}` : ''))\n    .join('\\n')\n}\n\n/**\n * Renders the generic clause (`<T, U>`) shared by function and arrow-function nodes.\n * Accepts either a raw string (rendered verbatim) or an array of type-parameter names.\n */\nexport function formatGenerics(generics: FunctionNode['generics'] | ArrowFunctionNode['generics']): string {\n  if (!generics) return ''\n  return `<${Array.isArray(generics) ? generics.join(', ') : generics}>`\n}\n\n/**\n * Renders the return-type suffix (`: T` or `: Promise<T>` when `isAsync` is true).\n * Returns an empty string when no return type is provided.\n */\nexport function formatReturnType(returnType: string | undefined, isAsync: boolean | undefined): string {\n  if (!returnType) return ''\n  return isAsync ? `: Promise<${returnType}>` : `: ${returnType}`\n}\n\n/**\n * Validates TypeScript AST nodes before printing.\n * Throws an error if any node has SyntaxKind.Unknown which would cause the\n * TypeScript printer to crash.\n */\nexport function validateNodes(...nodes: ts.Node[]): void {\n  for (const node of nodes) {\n    if (!node) {\n      throw new Error('Attempted to print undefined or null TypeScript node')\n    }\n    if (node.kind === ts.SyntaxKind.Unknown) {\n      throw new Error(\n        'Invalid TypeScript AST node detected with SyntaxKind.Unknown. ' +\n          'This typically indicates a schema pattern that could not be properly converted to TypeScript. ' +\n          `Node: ${JSON.stringify(node, null, 2)}`,\n      )\n    }\n  }\n}\n\n/**\n * Module-scoped TypeScript printer instance. `ts.createPrinter()` is stateless across calls\n * (it does not mutate the source file) so a single instance can be safely reused for every\n * `print()` call. Hoisting it out of `print()` avoids re-running the printer initialization\n * for each file's import/export section.\n */\nconst TS_PRINTER = ts.createPrinter({\n  omitTrailingSemicolon: true,\n  newLine: ts.NewLineKind.LineFeed,\n  removeComments: false,\n  noEmitHelpers: true,\n})\n\n/**\n * Module-scoped source file used as the print target. `printList` only reads the source\n * file's compiler options / language version; it never mutates it.\n */\nconst PRINT_SOURCE_FILE = ts.createSourceFile('print.tsx', '', ts.ScriptTarget.ES2022, true, ts.ScriptKind.TSX)\n\n// Pre-warm the printer at module load. The first `printList` call lazily initializes\n// the printer's internal string-builder and identifier tables; doing it once at import\n// time keeps that cost off the critical path for short-lived CLI builds.\nTS_PRINTER.printList(ts.ListFormat.MultiLine, factory.createNodeArray([]), PRINT_SOURCE_FILE)\n\n/**\n * Converts TypeScript/TSX AST nodes to a string using the TypeScript printer.\n */\nexport function print(...elements: Array<ts.Node>): string {\n  const filtered = elements.filter(Boolean)\n  if (filtered.length === 0) return ''\n\n  const output = TS_PRINTER.printList(ts.ListFormat.MultiLine, factory.createNodeArray(filtered), PRINT_SOURCE_FILE)\n\n  return output.replace(CRLF_PATTERN, '\\n')\n}\n\n/**\n * Like `print` but validates nodes first to surface issues early.\n */\nexport function safePrint(...elements: Array<ts.Node>): string {\n  validateNodes(...elements)\n  return print(...elements)\n}\n\n/**\n * Converts a {@link JSDocNode} to a JSDoc comment block string.\n *\n * @example\n * ```ts\n * printJSDoc({ comments: ['@description A pet', '@deprecated'] })\n * // /**\n * //  * @description A pet\n * //  * @deprecated\n * //  *\\/\n * ```\n */\nexport function printJSDoc(jsDoc: JSDocNode): string {\n  const comments = (jsDoc.comments ?? []).filter((c) => c != null)\n  if (comments.length === 0) return ''\n\n  const lines = comments\n    .flatMap((c) => c.split(/\\r?\\n/))\n    .map((l) => l.replace(JSDOC_TERMINATOR_PATTERN, '* /').replace(CARRIAGE_RETURN_PATTERN, ''))\n    .filter((l) => l.trim().length > 0)\n\n  if (lines.length === 0) return ''\n\n  return ['/**', ...lines.map((l) => ` * ${l}`), ' */'].join('\\n')\n}\n\n/**\n * Converts a {@link ConstNode} to a TypeScript `const` declaration string.\n *\n * Mirrors the `Const` component from `@kubb/renderer-jsx`.\n *\n * @example\n * ```ts\n * printConst(createConst({ name: 'pet', export: true, nodes: ['{}'] }))\n * // 'export const pet = {}'\n * ```\n *\n * @example With type and `as const`\n * ```ts\n * printConst(createConst({ name: 'pets', export: true, type: 'Pet[]', asConst: true, nodes: ['[]'] }))\n * // 'export const pets: Pet[] = [] as const'\n * ```\n */\nexport function printConst(node: ConstNode): string {\n  const { name, export: canExport, type, JSDoc, asConst, nodes } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  parts.push('const ')\n  parts.push(name)\n  if (type) {\n    parts.push(`: ${type}`)\n  }\n  parts.push(' = ')\n  parts.push(body)\n  if (asConst) parts.push(' as const')\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts a {@link TypeNode} to a TypeScript `type` alias declaration string.\n *\n * Mirrors the `Type` component from `@kubb/renderer-jsx`.\n *\n * @example\n * ```ts\n * printType(createType({ name: 'Pet', export: true, nodes: ['{ id: number }'] }))\n * // 'export type Pet = { id: number }'\n * ```\n */\nexport function printType(node: TypeNode): string {\n  const { name, export: canExport, JSDoc, nodes } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  parts.push('type ')\n  parts.push(name)\n  parts.push(' = ')\n  parts.push(body)\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts a {@link FunctionNode} to a TypeScript `function` declaration string.\n *\n * Mirrors the `Function` component from `@kubb/renderer-jsx`.\n *\n * @example\n * ```ts\n * printFunction(createFunction({ name: 'getPet', export: true, params: 'id: string', returnType: 'Pet', nodes: ['return fetch(id)'] }))\n * // 'export function getPet(id: string): Pet {\\n  return fetch(id)\\n}'\n * ```\n *\n * @example Async with generics\n * ```ts\n * printFunction(createFunction({ name: 'fetchPet', export: true, async: true, generics: ['T'], params: 'id: string', returnType: 'T' }))\n * // 'export async function fetchPet<T>(id: string): Promise<T> {\\n}'\n * ```\n */\nexport function printFunction(node: FunctionNode): string {\n  const { name, default: isDefault, export: canExport, async: isAsync, generics, params, returnType, JSDoc, nodes } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n  const indented = body ? indentLines(body) : ''\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  if (isDefault) parts.push('default ')\n  if (isAsync) parts.push('async ')\n  parts.push('function ')\n  parts.push(name)\n  parts.push(formatGenerics(generics))\n  parts.push(`(${params ?? ''})`)\n  parts.push(formatReturnType(returnType, isAsync))\n  parts.push(' {')\n  if (indented) {\n    parts.push(`\\n${indented}\\n`)\n  }\n  parts.push('}')\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts an {@link ArrowFunctionNode} to a TypeScript arrow function declaration string.\n *\n * Mirrors the `Function.Arrow` component from `@kubb/renderer-jsx`.\n *\n * @example Multi-line arrow function\n * ```ts\n * printArrowFunction(createArrowFunction({ name: 'getPet', export: true, params: 'id: string', nodes: ['return fetch(id)'] }))\n * // 'export const getPet = (id: string) => {\\n  return fetch(id)\\n}'\n * ```\n *\n * @example Single-line arrow function\n * ```ts\n * printArrowFunction(createArrowFunction({ name: 'double', params: 'n: number', singleLine: true, nodes: ['n * 2'] }))\n * // 'const double = (n: number) => n * 2'\n * ```\n */\nexport function printArrowFunction(node: ArrowFunctionNode): string {\n  const { name, default: isDefault, export: canExport, async: isAsync, generics, params, returnType, JSDoc, nodes, singleLine } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n  const arrowBody = singleLine ? ` => ${body}` : body ? ` => {\\n${indentLines(body)}\\n}` : ' => {}'\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  if (isDefault) parts.push('default ')\n  parts.push('const ')\n  parts.push(name)\n  parts.push(' = ')\n  if (isAsync) parts.push('async ')\n  parts.push(formatGenerics(generics))\n  parts.push(`(${params ?? ''})`)\n  parts.push(formatReturnType(returnType, isAsync))\n  parts.push(arrowBody)\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts a {@link CodeNode} to its TypeScript string representation.\n *\n * Dispatches to the appropriate printer based on the node's `kind`.\n *\n * @example\n * ```ts\n * printCodeNode(createConst({ name: 'x', nodes: ['1'] }))\n * // 'const x = 1'\n * ```\n */\nexport function printCodeNode(node: CodeNode): string {\n  if (node.kind === 'Break') return ''\n  if (node.kind === 'Text') return (node as TextNode).value\n  if (node.kind === 'Jsx') return (node as JsxNode).value\n  if (node.kind === 'Const') return printConst(node)\n  if (node.kind === 'Type') return printType(node)\n  if (node.kind === 'Function') return printFunction(node)\n  if (node.kind === 'ArrowFunction') return printArrowFunction(node)\n  return ''\n}\n\n/**\n * Converts a {@link SourceNode} to its TypeScript string representation.\n *\n * Iterates `nodes` in DOM order, rendering each {@link CodeNode} via\n * {@link printCodeNode}.\n *\n * @example From nodes\n * ```ts\n * printSource({ kind: 'Source', nodes: [createConst({ name: 'x', nodes: [createText('1')] }), createText('x.toString()')] })\n * // 'const x = 1\\nx.toString()'\n * ```\n */\nexport function printSource(node: SourceNode): string {\n  const nodes = node.nodes\n\n  if (!nodes || nodes.length === 0) return ''\n  const parts: string[] = []\n\n  for (const child of nodes) {\n    parts.push(printCodeNode(child as CodeNode))\n  }\n\n  return parts.join('\\n')\n}\n\nexport function createImport({\n  name,\n  path,\n  root,\n  isTypeOnly = false,\n  isNameSpace = false,\n}: {\n  name: string | Array<string | { propertyName: string; name?: string }>\n  path: string\n  root?: string\n  /** @default false */\n  isTypeOnly?: boolean\n  /** @default false */\n  isNameSpace?: boolean\n}): ts.ImportDeclaration {\n  const resolvePath = root ? getRelativePath(root, path) : path\n\n  if (!Array.isArray(name)) {\n    if (isNameSpace) {\n      return factory.createImportDeclaration(\n        undefined,\n        factory.createImportClause(isTypeOnly, undefined, factory.createNamespaceImport(factory.createIdentifier(name))),\n        factory.createStringLiteral(resolvePath),\n        undefined,\n      )\n    }\n\n    return factory.createImportDeclaration(\n      undefined,\n      factory.createImportClause(isTypeOnly, factory.createIdentifier(name), undefined),\n      factory.createStringLiteral(resolvePath),\n      undefined,\n    )\n  }\n\n  const specifiers = name.map((item) => {\n    if (typeof item === 'object') {\n      const { propertyName, name: alias } = item\n      return factory.createImportSpecifier(false, alias ? factory.createIdentifier(propertyName) : undefined, factory.createIdentifier(alias ?? propertyName))\n    }\n    return factory.createImportSpecifier(false, undefined, factory.createIdentifier(item))\n  })\n\n  return factory.createImportDeclaration(\n    undefined,\n    factory.createImportClause(isTypeOnly, undefined, factory.createNamedImports(specifiers)),\n    factory.createStringLiteral(resolvePath),\n    undefined,\n  )\n}\n\nexport function createExport({\n  path,\n  asAlias,\n  isTypeOnly = false,\n  name,\n}: {\n  path: string\n  /** @default false */\n  asAlias?: boolean\n  /** @default false */\n  isTypeOnly?: boolean\n  name?: string | Array<ts.Identifier | string>\n}): ts.ExportDeclaration {\n  if (name && !Array.isArray(name) && !asAlias) {\n    console.warn(`When using name as string, asAlias should be true: ${name}`)\n  }\n\n  if (!Array.isArray(name)) {\n    const parsedName = name && LEADING_DIGIT_PATTERN.test(name) ? `_${name.slice(1)}` : name\n\n    return factory.createExportDeclaration(\n      undefined,\n      isTypeOnly,\n      asAlias && parsedName ? factory.createNamespaceExport(factory.createIdentifier(parsedName)) : undefined,\n      factory.createStringLiteral(path),\n      undefined,\n    )\n  }\n\n  return factory.createExportDeclaration(\n    undefined,\n    isTypeOnly,\n    factory.createNamedExports(\n      name.map((propertyName) =>\n        factory.createExportSpecifier(false, undefined, typeof propertyName === 'string' ? factory.createIdentifier(propertyName) : propertyName),\n      ),\n    ),\n    factory.createStringLiteral(path),\n    undefined,\n  )\n}\n","import type { FileNode, SourceNode } from '@kubb/ast'\nimport type { Parser } from '@kubb/core'\nimport { defineParser } from '@kubb/core'\nimport type * as ts from 'typescript'\nimport { createExport, createImport, getRelativePath, print, printSource, resolveOutputPath } from './utils.ts'\n\nexport { createExport, createImport, print, safePrint, validateNodes } from './utils.ts'\n\nexport { printArrowFunction, printCodeNode, printConst, printFunction, printJSDoc, printSource, printType } from './utils.ts'\n\n/**\n * Parser that converts `.ts` and `.js` files to strings using the TypeScript\n * compiler. Handles import/export statement generation from file metadata.\n *\n * @default Used automatically when no `parsers` option is set in `defineConfig`.\n */\nexport const parserTs: Parser = defineParser({\n  name: 'typescript',\n  extNames: ['.ts', '.js'],\n  parse(file, options = { extname: '.ts' }) {\n    const sourceParts: Array<string> = []\n    for (const item of file.sources) {\n      const sourceStr = printSource(item as SourceNode)\n      if (sourceStr) {\n        sourceParts.push(sourceStr.trimEnd())\n      }\n    }\n    const source = sourceParts.join('\\n\\n')\n\n    const importNodes: Array<ts.ImportDeclaration> = []\n    for (const item of (file as FileNode).imports) {\n      const importPath = item.root ? getRelativePath(item.root, item.path) : item.path\n      importNodes.push(\n        createImport({\n          name: item.name as string | Array<string | { propertyName: string; name?: string }>,\n          path: resolveOutputPath(importPath, options, Boolean(item.root)),\n          isTypeOnly: item.isTypeOnly,\n          isNameSpace: item.isNameSpace,\n        }),\n      )\n    }\n\n    const exportNodes: Array<ts.ExportDeclaration> = []\n    for (const item of (file as FileNode).exports) {\n      exportNodes.push(\n        createExport({\n          name: item.name as string | Array<ts.Identifier | string> | undefined,\n          path: resolveOutputPath(item.path, options, true),\n          isTypeOnly: item.isTypeOnly,\n          asAlias: item.asAlias,\n        }),\n      )\n    }\n\n    const parts = [file.banner, print(...importNodes, ...exportNodes), source, file.footer]\n      .filter((segment): segment is string => Boolean(segment))\n      .map((s) => s.trimEnd())\n    return parts.join('\\n\\n')\n  },\n})\n","import type { Parser } from '@kubb/core'\nimport { defineParser } from '@kubb/core'\nimport { parserTs } from './parserTs.ts'\n\n/**\n * Parser that converts `.tsx` and `.jsx` files to strings.\n * Delegates to `typescriptParser` since the TypeScript compiler natively\n * supports JSX/TSX syntax via `ScriptKind.TSX`.\n *\n * Add this parser to the `parsers` option in `defineConfig` when generating `.tsx`/`.jsx` files.\n *\n * @default extname '.tsx'\n */\nexport const parserTsx: Parser = defineParser({\n  name: 'tsx',\n  extNames: ['.tsx', '.jsx'],\n  parse(file, options = { extname: '.tsx' }) {\n    return parserTs.parse(file, options)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/constants.ts","../src/utils.ts","../src/parserTs.ts","../src/parserTsx.ts"],"sourcesContent":["/**\n * Number of spaces used to indent a nested block when pretty-printing.\n */\nexport const INDENT_SIZE = 2 as const\n\n/**\n * Matches the trailing `.<ext>` segment of a path (keeps segments like `foo.bar.ts`\n * intact by only trimming the last run of non-`/`/`.` characters).\n */\nexport const FILE_EXTENSION_PATTERN = /\\.[^/.]+$/\n\n/**\n * Matches Windows-style backslash path separators.\n */\nexport const WINDOWS_PATH_SEPARATOR = /\\\\/g\n\n/**\n * Matches `*\\/` in free-form text so JSDoc bodies can neutralize premature\n * comment terminators (`*\\/` → `* /`).\n */\nexport const JSDOC_TERMINATOR_PATTERN = /\\*\\//g\n\n/**\n * Matches carriage returns for normalizing CRLF/CR line endings to LF.\n */\nexport const CARRIAGE_RETURN_PATTERN = /\\r/g\n\n/**\n * Matches CRLF sequences used when normalizing TypeScript printer output.\n */\nexport const CRLF_PATTERN = /\\r\\n/g\n\n/**\n * Matches an identifier that starts with a digit — JavaScript disallows this\n * so the printer prefixes such names with `_`.\n */\nexport const LEADING_DIGIT_PATTERN = /^\\d/\n\n/**\n * Relative path prefix used to detect traversal segments (`../`).\n */\nexport const PARENT_DIRECTORY_PREFIX = '../' as const\n\n/**\n * Relative path prefix used when resolving imports within the output root.\n */\nexport const CURRENT_DIRECTORY_PREFIX = './' as const\n","import { normalize, relative } from 'node:path'\nimport type { ArrowFunctionNode, CodeNode, ConstNode, FunctionNode, JSDocNode, JsxNode, SourceNode, TextNode, TypeNode } from '@kubb/ast'\nimport ts from 'typescript'\nimport {\n  CARRIAGE_RETURN_PATTERN,\n  CRLF_PATTERN,\n  CURRENT_DIRECTORY_PREFIX,\n  FILE_EXTENSION_PATTERN,\n  INDENT_SIZE,\n  JSDOC_TERMINATOR_PATTERN,\n  LEADING_DIGIT_PATTERN,\n  PARENT_DIRECTORY_PREFIX,\n  WINDOWS_PATH_SEPARATOR,\n} from './constants.ts'\n\nconst { factory } = ts\n\n/**\n * Normalizes a file-system path to POSIX separators and strips any leading `../` segment.\n */\nexport function slash(path: string): string {\n  return normalize(path).replaceAll(WINDOWS_PATH_SEPARATOR, '/').replace(PARENT_DIRECTORY_PREFIX, '')\n}\n\n/**\n * Resolves `filePath` relative to `rootDir` and returns a POSIX-style path\n * prefixed with `./` when the target sits inside the root, or `../` when it escapes it.\n */\nexport function getRelativePath(rootDir: string, filePath: string): string {\n  const rel = relative(rootDir, filePath)\n  const slashed = slash(rel)\n  return slashed.startsWith(PARENT_DIRECTORY_PREFIX) ? slashed : `${CURRENT_DIRECTORY_PREFIX}${slashed}`\n}\n\n/**\n * Strips the trailing file extension (for example `.ts`) from a path.\n * Preserves intermediate dots like `foo.bar.ts` → `foo.bar`.\n */\nexport function trimExtName(text: string): string {\n  return text.replace(FILE_EXTENSION_PATTERN, '')\n}\n\n/**\n * Rewrites an import/export path so its extension matches the caller-supplied\n * `options.extname`. When the source path has no extension the original is kept,\n * so virtual/module-only paths flow through unchanged.\n */\nexport function resolveOutputPath(path: string, options: { extname?: string } | undefined, rootAware: boolean): string {\n  const hasExtname = FILE_EXTENSION_PATTERN.test(path)\n  if (options?.extname && hasExtname) {\n    return `${trimExtName(path)}${options.extname}`\n  }\n  return rootAware ? trimExtName(path) : path\n}\n\n/**\n * Serializes the body / value content from a `nodes` array.\n *\n * Each element is either a raw string or a structured {@link CodeNode}\n * (recursively converted via {@link printCodeNode}).\n * Elements are joined with `\\n`.\n */\nexport function printNodes(nodes: Array<CodeNode> | undefined): string {\n  if (!nodes || nodes.length === 0) return ''\n\n  const parts: string[] = []\n\n  for (const node of nodes) {\n    parts.push(printCodeNode(node))\n  }\n\n  return parts.join('\\n')\n}\n\n/**\n * Indents every non-empty line of `text` by `spaces` spaces.\n */\nexport function indentLines(text: string, spaces: number = INDENT_SIZE): string {\n  if (!text) return ''\n  const pad = ' '.repeat(spaces)\n  return text\n    .split('\\n')\n    .map((line) => (line.trim() ? `${pad}${line}` : ''))\n    .join('\\n')\n}\n\n/**\n * Renders the generic clause (`<T, U>`) shared by function and arrow-function nodes.\n * Accepts either a raw string (rendered verbatim) or an array of type-parameter names.\n */\nexport function formatGenerics(generics: FunctionNode['generics'] | ArrowFunctionNode['generics']): string {\n  if (!generics) return ''\n  return `<${Array.isArray(generics) ? generics.join(', ') : generics}>`\n}\n\n/**\n * Renders the return-type suffix (`: T` or `: Promise<T>` when `isAsync` is true).\n * Returns an empty string when no return type is provided.\n */\nexport function formatReturnType(returnType: string | null | undefined, isAsync: boolean | null | undefined): string {\n  if (!returnType) return ''\n  return isAsync ? `: Promise<${returnType}>` : `: ${returnType}`\n}\n\n/**\n * Validates TypeScript AST nodes before printing.\n * Throws an error if any node has SyntaxKind.Unknown which would cause the\n * TypeScript printer to crash.\n */\nexport function validateNodes(...nodes: ts.Node[]): void {\n  for (const node of nodes) {\n    if (!node) {\n      throw new Error('Attempted to print undefined or null TypeScript node')\n    }\n    if (node.kind === ts.SyntaxKind.Unknown) {\n      throw new Error(\n        'Invalid TypeScript AST node detected with SyntaxKind.Unknown. ' +\n          'This typically indicates a schema pattern that could not be properly converted to TypeScript. ' +\n          `Node: ${JSON.stringify(node, null, 2)}`,\n      )\n    }\n  }\n}\n\n/**\n * Module-scoped TypeScript printer instance. `ts.createPrinter()` is stateless across calls\n * (it does not mutate the source file) so a single instance can be safely reused for every\n * `print()` call. Hoisting it out of `print()` avoids re-running the printer initialization\n * for each file's import/export section.\n */\nconst TS_PRINTER = ts.createPrinter({\n  omitTrailingSemicolon: true,\n  newLine: ts.NewLineKind.LineFeed,\n  removeComments: false,\n  noEmitHelpers: true,\n})\n\n/**\n * Module-scoped source file used as the print target. `printList` only reads the source\n * file's compiler options / language version; it never mutates it.\n */\nconst PRINT_SOURCE_FILE = ts.createSourceFile('print.tsx', '', ts.ScriptTarget.ES2022, true, ts.ScriptKind.TSX)\n\n// Pre-warm the printer at module load. The first `printList` call lazily initializes\n// the printer's internal string-builder and identifier tables; doing it once at import\n// time keeps that cost off the critical path for short-lived CLI builds.\nTS_PRINTER.printList(ts.ListFormat.MultiLine, factory.createNodeArray([]), PRINT_SOURCE_FILE)\n\n/**\n * Converts TypeScript/TSX AST nodes to a string using the TypeScript printer.\n */\nexport function print(...elements: Array<ts.Node>): string {\n  const filtered = elements.filter(Boolean)\n  if (filtered.length === 0) return ''\n\n  const output = TS_PRINTER.printList(ts.ListFormat.MultiLine, factory.createNodeArray(filtered), PRINT_SOURCE_FILE)\n\n  return output.replace(CRLF_PATTERN, '\\n')\n}\n\n/**\n * Like `print` but validates nodes first to surface issues early.\n */\nexport function safePrint(...elements: Array<ts.Node>): string {\n  validateNodes(...elements)\n  return print(...elements)\n}\n\n/**\n * Converts a {@link JSDocNode} to a JSDoc comment block string.\n *\n * @example\n * ```ts\n * printJSDoc({ comments: ['@description A pet', '@deprecated'] })\n * // /**\n * //  * @description A pet\n * //  * @deprecated\n * //  *\\/\n * ```\n */\nexport function printJSDoc(jsDoc: JSDocNode): string {\n  const comments = (jsDoc.comments ?? []).filter((c) => c != null)\n  if (comments.length === 0) return ''\n\n  const lines = comments\n    .flatMap((c) => c.split(/\\r?\\n/))\n    .map((l) => l.replace(JSDOC_TERMINATOR_PATTERN, '* /').replace(CARRIAGE_RETURN_PATTERN, ''))\n    .filter((l) => l.trim().length > 0)\n\n  if (lines.length === 0) return ''\n\n  return ['/**', ...lines.map((l) => ` * ${l}`), ' */'].join('\\n')\n}\n\n/**\n * Converts a {@link ConstNode} to a TypeScript `const` declaration string.\n *\n * Mirrors the `Const` component from `@kubb/renderer-jsx`.\n *\n * @example\n * ```ts\n * printConst(createConst({ name: 'pet', export: true, nodes: ['{}'] }))\n * // 'export const pet = {}'\n * ```\n *\n * @example With type and `as const`\n * ```ts\n * printConst(createConst({ name: 'pets', export: true, type: 'Pet[]', asConst: true, nodes: ['[]'] }))\n * // 'export const pets: Pet[] = [] as const'\n * ```\n */\nexport function printConst(node: ConstNode): string {\n  const { name, export: canExport, type, JSDoc, asConst, nodes } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  parts.push('const ')\n  parts.push(name)\n  if (type) {\n    parts.push(`: ${type}`)\n  }\n  parts.push(' = ')\n  parts.push(body)\n  if (asConst) parts.push(' as const')\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts a {@link TypeNode} to a TypeScript `type` alias declaration string.\n *\n * Mirrors the `Type` component from `@kubb/renderer-jsx`.\n *\n * @example\n * ```ts\n * printType(createType({ name: 'Pet', export: true, nodes: ['{ id: number }'] }))\n * // 'export type Pet = { id: number }'\n * ```\n */\nexport function printType(node: TypeNode): string {\n  const { name, export: canExport, JSDoc, nodes } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  parts.push('type ')\n  parts.push(name)\n  parts.push(' = ')\n  parts.push(body)\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts a {@link FunctionNode} to a TypeScript `function` declaration string.\n *\n * Mirrors the `Function` component from `@kubb/renderer-jsx`.\n *\n * @example\n * ```ts\n * printFunction(createFunction({ name: 'getPet', export: true, params: 'id: string', returnType: 'Pet', nodes: ['return fetch(id)'] }))\n * // 'export function getPet(id: string): Pet {\\n  return fetch(id)\\n}'\n * ```\n *\n * @example Async with generics\n * ```ts\n * printFunction(createFunction({ name: 'fetchPet', export: true, async: true, generics: ['T'], params: 'id: string', returnType: 'T' }))\n * // 'export async function fetchPet<T>(id: string): Promise<T> {\\n}'\n * ```\n */\nexport function printFunction(node: FunctionNode): string {\n  const { name, default: isDefault, export: canExport, async: isAsync, generics, params, returnType, JSDoc, nodes } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n  const indented = body ? indentLines(body) : ''\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  if (isDefault) parts.push('default ')\n  if (isAsync) parts.push('async ')\n  parts.push('function ')\n  parts.push(name)\n  parts.push(formatGenerics(generics))\n  parts.push(`(${params ?? ''})`)\n  parts.push(formatReturnType(returnType, isAsync))\n  parts.push(' {')\n  if (indented) {\n    parts.push(`\\n${indented}\\n`)\n  }\n  parts.push('}')\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts an {@link ArrowFunctionNode} to a TypeScript arrow function declaration string.\n *\n * Mirrors the `Function.Arrow` component from `@kubb/renderer-jsx`.\n *\n * @example Multi-line arrow function\n * ```ts\n * printArrowFunction(createArrowFunction({ name: 'getPet', export: true, params: 'id: string', nodes: ['return fetch(id)'] }))\n * // 'export const getPet = (id: string) => {\\n  return fetch(id)\\n}'\n * ```\n *\n * @example Single-line arrow function\n * ```ts\n * printArrowFunction(createArrowFunction({ name: 'double', params: 'n: number', singleLine: true, nodes: ['n * 2'] }))\n * // 'const double = (n: number) => n * 2'\n * ```\n */\nexport function printArrowFunction(node: ArrowFunctionNode): string {\n  const { name, default: isDefault, export: canExport, async: isAsync, generics, params, returnType, JSDoc, nodes, singleLine } = node\n\n  const jsDocStr = JSDoc ? printJSDoc(JSDoc) : ''\n  const body = printNodes(nodes)\n  const arrowBody = singleLine ? ` => ${body}` : body ? ` => {\\n${indentLines(body)}\\n}` : ' => {}'\n\n  const parts: string[] = []\n  if (canExport) parts.push('export ')\n  if (isDefault) parts.push('default ')\n  parts.push('const ')\n  parts.push(name)\n  parts.push(' = ')\n  if (isAsync) parts.push('async ')\n  parts.push(formatGenerics(generics))\n  parts.push(`(${params ?? ''})`)\n  parts.push(formatReturnType(returnType, isAsync))\n  parts.push(arrowBody)\n\n  const declaration = parts.join('')\n  return [jsDocStr, declaration].filter(Boolean).join('\\n')\n}\n\n/**\n * Converts a {@link CodeNode} to its TypeScript string representation.\n *\n * Dispatches to the appropriate printer based on the node's `kind`.\n *\n * @example\n * ```ts\n * printCodeNode(createConst({ name: 'x', nodes: ['1'] }))\n * // 'const x = 1'\n * ```\n */\nexport function printCodeNode(node: CodeNode): string {\n  if (node.kind === 'Break') return ''\n  if (node.kind === 'Text') return (node as TextNode).value\n  if (node.kind === 'Jsx') return (node as JsxNode).value\n  if (node.kind === 'Const') return printConst(node)\n  if (node.kind === 'Type') return printType(node)\n  if (node.kind === 'Function') return printFunction(node)\n  if (node.kind === 'ArrowFunction') return printArrowFunction(node)\n  return ''\n}\n\n/**\n * Converts a {@link SourceNode} to its TypeScript string representation.\n *\n * Iterates `nodes` in DOM order, rendering each {@link CodeNode} via\n * {@link printCodeNode}.\n *\n * @example From nodes\n * ```ts\n * printSource({ kind: 'Source', nodes: [createConst({ name: 'x', nodes: [createText('1')] }), createText('x.toString()')] })\n * // 'const x = 1\\nx.toString()'\n * ```\n */\nexport function printSource(node: SourceNode): string {\n  const nodes = node.nodes\n\n  if (!nodes || nodes.length === 0) return ''\n  const parts: string[] = []\n\n  for (const child of nodes) {\n    parts.push(printCodeNode(child as CodeNode))\n  }\n\n  return parts.join('\\n')\n}\n\nexport function createImport({\n  name,\n  path,\n  root,\n  isTypeOnly: isTypeOnlyRaw = false,\n  isNameSpace: isNameSpaceRaw = false,\n}: {\n  name: string | Array<string | { propertyName: string; name?: string }>\n  path: string\n  root?: string | null\n  /** @default false */\n  isTypeOnly?: boolean | null\n  /** @default false */\n  isNameSpace?: boolean | null\n}): ts.ImportDeclaration {\n  const isTypeOnly = isTypeOnlyRaw ?? false\n  const isNameSpace = isNameSpaceRaw ?? false\n  const resolvePath = root ? getRelativePath(root, path) : path\n\n  if (!Array.isArray(name)) {\n    if (isNameSpace) {\n      return factory.createImportDeclaration(\n        undefined,\n        factory.createImportClause(isTypeOnly, undefined, factory.createNamespaceImport(factory.createIdentifier(name))),\n        factory.createStringLiteral(resolvePath),\n        undefined,\n      )\n    }\n\n    return factory.createImportDeclaration(\n      undefined,\n      factory.createImportClause(isTypeOnly, factory.createIdentifier(name), undefined),\n      factory.createStringLiteral(resolvePath),\n      undefined,\n    )\n  }\n\n  const specifiers = name.map((item) => {\n    if (typeof item === 'object') {\n      const { propertyName, name: alias } = item\n      return factory.createImportSpecifier(false, alias ? factory.createIdentifier(propertyName) : undefined, factory.createIdentifier(alias ?? propertyName))\n    }\n    return factory.createImportSpecifier(false, undefined, factory.createIdentifier(item))\n  })\n\n  return factory.createImportDeclaration(\n    undefined,\n    factory.createImportClause(isTypeOnly, undefined, factory.createNamedImports(specifiers)),\n    factory.createStringLiteral(resolvePath),\n    undefined,\n  )\n}\n\nexport function createExport({\n  path,\n  asAlias: asAliasRaw,\n  isTypeOnly: isTypeOnlyRaw = false,\n  name,\n}: {\n  path: string\n  /** @default false */\n  asAlias?: boolean | null\n  /** @default false */\n  isTypeOnly?: boolean | null\n  name?: string | Array<ts.Identifier | string> | null\n}): ts.ExportDeclaration {\n  const asAlias = asAliasRaw ?? false\n  const isTypeOnly = isTypeOnlyRaw ?? false\n  if (name && !Array.isArray(name) && !asAlias) {\n    console.warn(`When using name as string, asAlias should be true: ${name}`)\n  }\n\n  if (!Array.isArray(name)) {\n    const parsedName = name && LEADING_DIGIT_PATTERN.test(name) ? `_${name.slice(1)}` : name\n\n    return factory.createExportDeclaration(\n      undefined,\n      isTypeOnly,\n      asAlias && parsedName ? factory.createNamespaceExport(factory.createIdentifier(parsedName)) : undefined,\n      factory.createStringLiteral(path),\n      undefined,\n    )\n  }\n\n  return factory.createExportDeclaration(\n    undefined,\n    isTypeOnly,\n    factory.createNamedExports(\n      name.map((propertyName) =>\n        factory.createExportSpecifier(false, undefined, typeof propertyName === 'string' ? factory.createIdentifier(propertyName) : propertyName),\n      ),\n    ),\n    factory.createStringLiteral(path),\n    undefined,\n  )\n}\n","import type { FileNode, SourceNode } from '@kubb/ast'\nimport type { Parser } from '@kubb/core'\nimport { defineParser } from '@kubb/core'\nimport type * as ts from 'typescript'\nimport { createExport, createImport, getRelativePath, print, printSource, resolveOutputPath } from './utils.ts'\n\nexport { createExport, createImport, print, safePrint, validateNodes } from './utils.ts'\n\nexport { printArrowFunction, printCodeNode, printConst, printFunction, printJSDoc, printSource, printType } from './utils.ts'\n\n/**\n * Default Kubb parser for `.ts` and `.js` files. Takes the universal AST\n * produced by an adapter and prints it as TypeScript source using the official\n * TypeScript compiler. Imports and exports are rewritten based on each file's\n * metadata.\n *\n * Used automatically when no `parsers` option is set on `defineConfig`. Use\n * `parserTsx` instead for React projects that emit JSX.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { adapterOas } from '@kubb/adapter-oas'\n * import { parserTs } from '@kubb/parser-ts'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   adapter: adapterOas(),\n *   parsers: [parserTs],\n *   plugins: [],\n * })\n * ```\n */\nexport const parserTs: Parser = defineParser({\n  name: 'typescript',\n  extNames: ['.ts', '.js'],\n  parse(file, options = { extname: '.ts' }) {\n    const sourceParts: Array<string> = []\n    for (const item of file.sources) {\n      const sourceStr = printSource(item as SourceNode)\n      if (sourceStr) {\n        sourceParts.push(sourceStr.trimEnd())\n      }\n    }\n    const source = sourceParts.join('\\n\\n')\n\n    const importNodes: Array<ts.ImportDeclaration> = []\n    for (const item of (file as FileNode).imports) {\n      const importPath = item.root ? getRelativePath(item.root, item.path) : item.path\n      importNodes.push(\n        createImport({\n          name: item.name as string | Array<string | { propertyName: string; name?: string }>,\n          path: resolveOutputPath(importPath, options, Boolean(item.root)),\n          isTypeOnly: item.isTypeOnly,\n          isNameSpace: item.isNameSpace,\n        }),\n      )\n    }\n\n    const exportNodes: Array<ts.ExportDeclaration> = []\n    for (const item of (file as FileNode).exports) {\n      exportNodes.push(\n        createExport({\n          name: item.name as string | Array<ts.Identifier | string> | null | undefined,\n          path: resolveOutputPath(item.path, options, true),\n          isTypeOnly: item.isTypeOnly,\n          asAlias: item.asAlias,\n        }),\n      )\n    }\n\n    const parts = [file.banner, print(...importNodes, ...exportNodes), source, file.footer]\n      .filter((segment): segment is string => Boolean(segment))\n      .map((s) => s.trimEnd())\n    return parts.join('\\n\\n')\n  },\n})\n","import type { Parser } from '@kubb/core'\nimport { defineParser } from '@kubb/core'\nimport { parserTs } from './parserTs.ts'\n\n/**\n * Kubb parser for `.tsx` and `.jsx` files. Delegates to `parserTs` because the\n * TypeScript compiler handles JSX natively via `ScriptKind.TSX`.\n *\n * Add to the `parsers` array on `defineConfig` when generating components for\n * React (or any framework that emits JSX).\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { adapterOas } from '@kubb/adapter-oas'\n * import { parserTsx } from '@kubb/parser-ts'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   adapter: adapterOas(),\n *   parsers: [parserTsx],\n *   plugins: [],\n * })\n * ```\n */\nexport const parserTsx: Parser = defineParser({\n  name: 'tsx',\n  extNames: ['.tsx', '.jsx'],\n  parse(file, options = { extname: '.tsx' }) {\n    return parserTs.parse(file, options)\n  },\n})\n"],"mappings":"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"}

package/extension.yaml

@@ -2,7 +2,7 @@ $schema: https://kubb.dev/schemas/extension.json
 kind: parser
 id: parser-ts
 name: TypeScript
-description: TypeScript and TSX file parser for Kubb. Converts the universal AST to `.ts`/`.tsx` source code using the official TypeScript compiler.
+description: Default file parser for Kubb. Converts the universal AST to `.ts`/`.tsx` source using the official TypeScript compiler.
 category: typescript
 type: official
 npmPackage: '@kubb/parser-ts'
@@ -29,23 +29,23 @@ featured: true
 icon:
   light: https://kubb.dev/feature/typescript.svg
 intro: |-
-  The TypeScript parser is the default file parser used by Kubb when no `parsers` option is set in `defineConfig`. It converts Kubb's universal AST into `.ts` and `.tsx` source code using the official [TypeScript compiler](https://www.typescriptlang.org/).
+  `@kubb/parser-ts` is the default file parser used by Kubb when no `parsers` option is provided in `defineConfig`. It takes the universal AST produced by your adapter and prints `.ts`/`.tsx` source code using the official [TypeScript compiler](https://www.typescriptlang.org/).
 
   Two parser instances are exported:
 
-  - `parserTs` — handles `.ts` and `.js` files
-  - `parserTsx` — handles `.tsx` and `.jsx` files
+  - `parserTs` — handles `.ts` and `.js` files.
+  - `parserTsx` — handles `.tsx` and `.jsx` files. Use this for React projects so JSX in generated components is preserved.
 
-  Both are configured globally in `defineConfig` and apply to every file produced by every plugin.
+  Configure once on `defineConfig`. The choice applies to every file every plugin produces.
 options:
   - name: extname
     type: "'.ts' | '.js' | '.tsx' | '.jsx' | string"
     required: false
     default: "'.ts'"
     description: |-
-      File extension used when rewriting relative import paths. Set to `.js` for ESM-friendly emit, `.tsx` for React projects, or leave unset to keep TypeScript's default behaviour.
+      File extension the parser writes when emitting code. Pick `.js` for an ESM-friendly emit you can publish to npm, `.tsx` for React projects, or leave unset for the standard TypeScript default.
 
-      Extension rewriting is configured via `output.extension` in `defineConfig`, not as a parser argument.
+      For rewriting relative import specifiers (`./foo` → `./foo.js`), set `output.extension` on `defineConfig` — not on the parser itself.
     codeBlock:
       lang: typescript
       title: kubb.config.ts
@@ -56,10 +56,11 @@ options:
         import { parserTs } from '@kubb/parser-ts'
 
         export default defineConfig({
-          input: { path: './petstore.yaml' },
+          input: { path: './petStore.yaml' },
           output: { path: './src/gen', extension: { '.ts': '.js' } },
           adapter: adapterOas(),
           parsers: [parserTs],
+          plugins: [],
         })
 examples:
   - name: TypeScript (default)
@@ -73,10 +74,11 @@ examples:
           import { parserTs } from '@kubb/parser-ts'
 
           export default defineConfig({
-            input: { path: './petstore.yaml' },
+            input: { path: './petStore.yaml' },
             output: { path: './src/gen' },
             adapter: adapterOas(),
             parsers: [parserTs],
+            plugins: [],
           })
   - name: TSX (React)
     files:
@@ -89,12 +91,13 @@ examples:
           import { parserTsx } from '@kubb/parser-ts'
 
           export default defineConfig({
-            input: { path: './petstore.yaml' },
+            input: { path: './petStore.yaml' },
             output: { path: './src/gen' },
             adapter: adapterOas(),
             parsers: [parserTsx],
+            plugins: [],
           })
 notes:
   - type: tip
     body: |-
-      `parser-ts` is bundled with Kubb and used automatically when no `parsers` option is provided. You only need to install it explicitly when combining it with other parsers or providing a fully custom parsers list.
+      `parser-ts` is bundled with Kubb and used automatically when no `parsers` option is set. Install it explicitly only when you need to combine it with other parsers or provide a fully custom parser list.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/parser-ts",
-  "version": "5.0.0-beta.21",
+  "version": "5.0.0-beta.23",
   "description": "TypeScript and TSX source file parser for Kubb. Converts AST nodes and raw TypeScript code into formatted source strings using the TypeScript compiler API.",
   "keywords": [
     "codegen",
@@ -42,11 +42,11 @@
   },
   "dependencies": {
     "typescript": "^6.0.3",
-    "@kubb/core": "5.0.0-beta.21"
+    "@kubb/core": "5.0.0-beta.23"
   },
   "devDependencies": {
     "@internals/utils": "0.0.0",
-    "@kubb/ast": "5.0.0-beta.21"
+    "@kubb/ast": "5.0.0-beta.23"
   },
   "engines": {
     "node": ">=22"

package/src/parserTs.ts

@@ -9,10 +9,28 @@ export { createExport, createImport, print, safePrint, validateNodes } from './u
 export { printArrowFunction, printCodeNode, printConst, printFunction, printJSDoc, printSource, printType } from './utils.ts'
 
 /**
- * Parser that converts `.ts` and `.js` files to strings using the TypeScript
- * compiler. Handles import/export statement generation from file metadata.
+ * 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.
  *
- * @default Used automatically when no `parsers` option is set in `defineConfig`.
+ * 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: [],
+ * })
+ * ```
  */
 export const parserTs: Parser = defineParser({
   name: 'typescript',
@@ -44,7 +62,7 @@ export const parserTs: Parser = defineParser({
     for (const item of (file as FileNode).exports) {
       exportNodes.push(
         createExport({
-          name: item.name as string | Array<ts.Identifier | string> | undefined,
+          name: item.name as string | Array<ts.Identifier | string> | null | undefined,
           path: resolveOutputPath(item.path, options, true),
           isTypeOnly: item.isTypeOnly,
           asAlias: item.asAlias,

package/src/parserTsx.ts

@@ -3,13 +3,26 @@ import { defineParser } from '@kubb/core'
 import { parserTs } from './parserTs.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 this parser to the `parsers` option in `defineConfig` when generating `.tsx`/`.jsx` files.
+ * Add to the `parsers` array on `defineConfig` when generating components for
+ * React (or any framework that emits JSX).
  *
- * @default extname '.tsx'
+ * @example
+ * ```ts
+ * import { defineConfig } from 'kubb'
+ * import { adapterOas } from '@kubb/adapter-oas'
+ * import { parserTsx } from '@kubb/parser-ts'
+ *
+ * export default defineConfig({
+ *   input: { path: './petStore.yaml' },
+ *   output: { path: './src/gen' },
+ *   adapter: adapterOas(),
+ *   parsers: [parserTsx],
+ *   plugins: [],
+ * })
+ * ```
  */
 export const parserTsx: Parser = defineParser({
   name: 'tsx',

package/src/utils.ts

@@ -97,7 +97,7 @@ export function formatGenerics(generics: FunctionNode['generics'] | ArrowFunctio
  * Renders the return-type suffix (`: T` or `: Promise<T>` when `isAsync` is true).
  * Returns an empty string when no return type is provided.
  */
-export function formatReturnType(returnType: string | undefined, isAsync: boolean | undefined): string {
+export function formatReturnType(returnType: string | null | undefined, isAsync: boolean | null | undefined): string {
   if (!returnType) return ''
   return isAsync ? `: Promise<${returnType}>` : `: ${returnType}`
 }
@@ -392,17 +392,19 @@ export function createImport({
   name,
   path,
   root,
-  isTypeOnly = false,
-  isNameSpace = false,
+  isTypeOnly: isTypeOnlyRaw = false,
+  isNameSpace: isNameSpaceRaw = false,
 }: {
   name: string | Array<string | { propertyName: string; name?: string }>
   path: string
-  root?: string
+  root?: string | null
   /** @default false */
-  isTypeOnly?: boolean
+  isTypeOnly?: boolean | null
   /** @default false */
-  isNameSpace?: boolean
+  isNameSpace?: boolean | null
 }): ts.ImportDeclaration {
+  const isTypeOnly = isTypeOnlyRaw ?? false
+  const isNameSpace = isNameSpaceRaw ?? false
   const resolvePath = root ? getRelativePath(root, path) : path
 
   if (!Array.isArray(name)) {
@@ -441,17 +443,19 @@ export function createImport({
 
 export function createExport({
   path,
-  asAlias,
-  isTypeOnly = false,
+  asAlias: asAliasRaw,
+  isTypeOnly: isTypeOnlyRaw = false,
   name,
 }: {
   path: string
   /** @default false */
-  asAlias?: boolean
+  asAlias?: boolean | null
   /** @default false */
-  isTypeOnly?: boolean
-  name?: string | Array<ts.Identifier | string>
+  isTypeOnly?: boolean | null
+  name?: string | Array<ts.Identifier | string> | null
 }): ts.ExportDeclaration {
+  const asAlias = asAliasRaw ?? false
+  const isTypeOnly = isTypeOnlyRaw ?? false
   if (name && !Array.isArray(name) && !asAlias) {
     console.warn(`When using name as string, asAlias should be true: ${name}`)
   }