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

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-import { $ as StatusCode, At as FunctionParametersNode, Bt as FunctionNode, Ct as TimeSchemaNode, Dt as FunctionNodeType, Et as PropertyNode, Ft as ImportNode, G as InputMeta, Gt as NodeKind, H as InferSchemaNode, Ht as TypeDeclarationNode, It as SourceNode, J as HttpMethod, K as InputNode, Lt as ArrowFunctionNode, Mt as ParamsTypeNode, Nt as ExportNode, Ot as FunctionParamNode, Pt as FileNode, Q as MediaType, Rt as CodeNode, St as StringSchemaNode, Tt as UrlSchemaNode, U as ParserOptions, Ut as TypeNode, V as InferSchema, Vt as JSDocNode, W as Node, Wt as BaseNode, X as ResponseNode, Y as OperationNode, Z as HttpStatusCode, _ as PrinterPartial, _t as ScalarSchemaType, a as TransformOptions, at as DatetimeSchemaNode, b as DistributiveOmit, bt as SchemaType, c as WalkOptions, ct as FormatStringSchemaNode, dt as Ipv6SchemaNode, et as ParameterLocation, ft as NumberSchemaNode, g as PrinterFactoryOptions, gt as ScalarSchemaNode, h as Printer, ht as RefSchemaNode, i as ParentOf, it as DateSchemaNode, jt as ParameterGroupNode, kt as FunctionParameterNode, lt as IntersectionSchemaNode, mt as PrimitiveSchemaType, n as CollectOptions, nt as ArraySchemaNode, o as Visitor, ot as EnumSchemaNode, p as RefMap, pt as ObjectSchemaNode, q as OutputNode, qt as VisitorDepth, r as CollectVisitor, rt as ComplexSchemaType, s as VisitorContext, st as EnumValueNode, t as AsyncVisitor, tt as ParameterNode, ut as Ipv4SchemaNode, vt as SchemaNode, wt as UnionSchemaNode, xt as SpecialSchemaType, yt as SchemaNodeByType, zt as ConstNode } from "./visitor-DysNCWvh.js";
-export { type ArraySchemaNode, type ArrowFunctionNode, type AsyncVisitor, type BaseNode, type CodeNode, type CollectOptions, type CollectVisitor, type ComplexSchemaType, type ConstNode, type DateSchemaNode, type DatetimeSchemaNode, type DistributiveOmit, type EnumSchemaNode, type EnumValueNode, type ExportNode, type FileNode, type FormatStringSchemaNode, type FunctionNode, type FunctionNodeType, type FunctionParamNode, type FunctionParameterNode, type FunctionParametersNode, type HttpMethod, type HttpStatusCode, type ImportNode, type InferSchema, type InferSchemaNode, type InputMeta, type InputNode, type IntersectionSchemaNode, type Ipv4SchemaNode, type Ipv6SchemaNode, type JSDocNode, type MediaType, type Node, type NodeKind, type NumberSchemaNode, type ObjectSchemaNode, type OperationNode, type OutputNode, type ParameterGroupNode, type ParameterLocation, type ParameterNode, type ParamsTypeNode, type ParentOf, type ParserOptions, type PrimitiveSchemaType, type Printer, type PrinterFactoryOptions, type PrinterPartial, type PropertyNode, type RefMap, type RefSchemaNode, type ResponseNode, type ScalarSchemaNode, type ScalarSchemaType, type SchemaNode, type SchemaNodeByType, type SchemaType, type SourceNode, type SpecialSchemaType, type StatusCode, type StringSchemaNode, type TimeSchemaNode, type TransformOptions, type TypeDeclarationNode, type TypeNode, type UnionSchemaNode, type UrlSchemaNode, type Visitor, type VisitorContext, type VisitorDepth, type WalkOptions };
+import { $ as ResponseNode, $t as VisitorDepth, At as FunctionNodeType, Bt as ArrowFunctionNode, Ct as SchemaType, Dt as UnionSchemaNode, Et as TimeSchemaNode, Ft as ParamsTypeNode, G as InferSchemaNode, Gt as JSDocNode, Ht as CodeNode, It as ExportNode, J as InputMeta, Jt as TypeDeclarationNode, K as ParserOptions, Kt as JsxNode, Lt as FileNode, Mt as FunctionParameterNode, Nt as FunctionParametersNode, Ot as UrlSchemaNode, Pt as ParameterGroupNode, Q as OperationNode, Rt as ImportNode, St as SchemaNodeByType, Tt as StringSchemaNode, Ut as ConstNode, Vt as BreakNode, W as InferSchema, Wt as FunctionNode, X as OutputNode, Xt as BaseNode, Y as InputNode, Yt as TypeNode, Z as HttpMethod, Zt as NodeKind, _ as PrinterPartial, _t as PrimitiveSchemaType, a as TransformOptions, at as ArraySchemaNode, b as DistributiveOmit, bt as ScalarSchemaType, c as WalkOptions, ct as DatetimeSchemaNode, dt as FormatStringSchemaNode, et as HttpStatusCode, ft as IntersectionSchemaNode, g as PrinterFactoryOptions, gt as ObjectSchemaNode, h as Printer, ht as NumberSchemaNode, i as ParentOf, it as ParameterNode, jt as FunctionParamNode, kt as PropertyNode, lt as EnumSchemaNode, mt as Ipv6SchemaNode, n as CollectOptions, nt as StatusCode, o as Visitor, ot as ComplexSchemaType, p as RefMap, pt as Ipv4SchemaNode, q as Node, qt as TextNode, r as CollectVisitor, rt as ParameterLocation, s as VisitorContext, st as DateSchemaNode, t as AsyncVisitor, tt as MediaType, ut as EnumValueNode, vt as RefSchemaNode, wt as SpecialSchemaType, xt as SchemaNode, yt as ScalarSchemaNode, zt as SourceNode } from "./visitor-CJMIoAE3.js";
+export { type ArraySchemaNode, type ArrowFunctionNode, type AsyncVisitor, type BaseNode, type BreakNode, type CodeNode, type CollectOptions, type CollectVisitor, type ComplexSchemaType, type ConstNode, type DateSchemaNode, type DatetimeSchemaNode, type DistributiveOmit, type EnumSchemaNode, type EnumValueNode, type ExportNode, type FileNode, type FormatStringSchemaNode, type FunctionNode, type FunctionNodeType, type FunctionParamNode, type FunctionParameterNode, type FunctionParametersNode, type HttpMethod, type HttpStatusCode, type ImportNode, type InferSchema, type InferSchemaNode, type InputMeta, type InputNode, type IntersectionSchemaNode, type Ipv4SchemaNode, type Ipv6SchemaNode, type JSDocNode, type JsxNode, type MediaType, type Node, type NodeKind, type NumberSchemaNode, type ObjectSchemaNode, type OperationNode, type OutputNode, type ParameterGroupNode, type ParameterLocation, type ParameterNode, type ParamsTypeNode, type ParentOf, type ParserOptions, type PrimitiveSchemaType, type Printer, type PrinterFactoryOptions, type PrinterPartial, type PropertyNode, type RefMap, type RefSchemaNode, type ResponseNode, type ScalarSchemaNode, type ScalarSchemaType, type SchemaNode, type SchemaNodeByType, type SchemaType, type SourceNode, type SpecialSchemaType, type StatusCode, type StringSchemaNode, type TextNode, type TimeSchemaNode, type TransformOptions, type TypeDeclarationNode, type TypeNode, type UnionSchemaNode, type UrlSchemaNode, type Visitor, type VisitorContext, type VisitorDepth, type WalkOptions };

package/dist/{visitor-DysNCWvh.d.ts → visitor-CJMIoAE3.d.ts}

@@ -21,6 +21,8 @@ declare const nodeKinds: {
   readonly import: "Import";
   readonly export: "Export";
   readonly source: "Source";
+  readonly text: "Text";
+  readonly break: "Break";
 };
 /**
  * Canonical schema type strings used by AST schema nodes.
@@ -185,7 +187,7 @@ declare const mediaTypes: {
  * const kind: NodeKind = 'Schema'
  * ```
  */
-type NodeKind = 'Input' | 'Output' | 'Operation' | 'Schema' | 'Property' | 'Parameter' | 'Response' | 'FunctionParameter' | 'ParameterGroup' | 'FunctionParameters' | 'Type' | 'ParamsType' | 'File' | 'Import' | 'Export' | 'Source' | 'Const' | 'Function' | 'ArrowFunction';
+type NodeKind = 'Input' | 'Output' | 'Operation' | 'Schema' | 'Property' | 'Parameter' | 'Response' | 'FunctionParameter' | 'ParameterGroup' | 'FunctionParameters' | 'Type' | 'ParamsType' | 'File' | 'Import' | 'Export' | 'Source' | 'Const' | 'Function' | 'ArrowFunction' | 'Text' | 'Break' | 'Jsx';
 /**
  * Base shape shared by all AST nodes.
  *
@@ -215,7 +217,7 @@ type JSDocNode = {
 /**
  * AST node representing a TypeScript `const` declaration.
  *
- * Mirrors the props of the `Const` component from `@kubb/react-fabric`.
+ * Mirrors the props of the `Const` component from `@kubb/renderer-jsx`.
  * The `children` prop of the component is represented as `nodes`.
  *
  * @example
@@ -254,14 +256,14 @@ type ConstNode = BaseNode & {
   asConst?: boolean;
   /**
    * Child nodes representing the value of the constant (children of the `Const` component).
-   * Each entry is either a structured {@link CodeNode} or a raw string expression.
+   * Each entry is a {@link CodeNode}; use {@link TextNode} for raw string content.
    */
-  nodes?: Array<CodeNode | string>;
+  nodes?: Array<CodeNode>;
 };
 /**
  * AST node representing a TypeScript `type` alias declaration.
  *
- * Mirrors the props of the `Type` component from `@kubb/react-fabric`.
+ * Mirrors the props of the `Type` component from `@kubb/renderer-jsx`.
  * The `children` prop of the component is represented as `nodes`.
  *
  * @example
@@ -290,9 +292,9 @@ type TypeNode = BaseNode & {
   JSDoc?: JSDocNode;
   /**
    * Child nodes representing the type body (children of the `Type` component).
-   * Each entry is either a structured {@link CodeNode} or a raw string expression.
+   * Each entry is a {@link CodeNode}; use {@link TextNode} for raw string content.
    */
-  nodes?: Array<CodeNode | string>;
+  nodes?: Array<CodeNode>;
 };
 /**
  * Convenience alias for {@link TypeNode}.
@@ -302,7 +304,7 @@ type TypeDeclarationNode = TypeNode;
 /**
  * AST node representing a TypeScript `function` declaration.
  *
- * Mirrors the props of the `Function` component from `@kubb/react-fabric`.
+ * Mirrors the props of the `Function` component from `@kubb/renderer-jsx`.
  * The `children` prop of the component is represented as `nodes`.
  *
  * @example
@@ -355,14 +357,14 @@ type FunctionNode = BaseNode & {
   JSDoc?: JSDocNode;
   /**
    * Child nodes representing the function body (children of the `Function` component).
-   * Each entry is either a structured {@link CodeNode} or a raw string statement.
+   * Each entry is a {@link CodeNode}; use {@link TextNode} for raw string content.
    */
-  nodes?: Array<CodeNode | string>;
+  nodes?: Array<CodeNode>;
 };
 /**
  * AST node representing a TypeScript arrow function (`const name = () => { ... }`).
  *
- * Mirrors the props of the `Function.Arrow` component from `@kubb/react-fabric`.
+ * Mirrors the props of the `Function.Arrow` component from `@kubb/renderer-jsx`.
  * The `children` prop of the component is represented as `nodes`.
  *
  * @example
@@ -420,17 +422,81 @@ type ArrowFunctionNode = BaseNode & {
   singleLine?: boolean;
   /**
    * Child nodes representing the function body (children of the `Function.Arrow` component).
-   * Each entry is either a structured {@link CodeNode} or a raw string statement.
+   * Each entry is a {@link CodeNode}; use {@link TextNode} for raw string content.
+   */
+  nodes?: Array<CodeNode>;
+};
+/**
+ * AST node representing a raw text/string fragment in the source output.
+ *
+ * Used instead of bare `string` values so that all entries in `nodes` arrays
+ * are typed `CodeNode` objects rather than a mixed `CodeNode | string` union.
+ *
+ * @example
+ * ```ts
+ * createText('return fetch(id)')
+ * // { kind: 'Text', value: 'return fetch(id)' }
+ * ```
+ */
+type TextNode = BaseNode & {
+  /**
+   * Node kind.
+   */
+  kind: 'Text';
+  /**
+   * The raw string content.
+   */
+  value: string;
+};
+/**
+ * AST node representing a line break in the source output.
+ *
+ * Corresponds to `<br/>` in JSX components. When printed, produces an empty
+ * string that — joined with `\n` by `printNodes` — creates a blank line
+ * between surrounding code nodes.
+ *
+ * @example
+ * ```ts
+ * createBreak()
+ * // { kind: 'Break' }
+ * // prints as '' → blank line when surrounded by other nodes
+ * ```
+ */
+type BreakNode = BaseNode & {
+  /**
+   * Node kind.
+   */
+  kind: 'Break';
+};
+/**
+ * AST node representing a raw JSX fragment in the source output.
+ *
+ * Mirrors the `Jsx` component from `@kubb/renderer-jsx`. Use this to embed raw
+ * JSX/TSX markup (including fragments `<>…</>`) directly in generated code.
+ *
+ * @example
+ * ```ts
+ * createJsx('<>\n  <a href={href}>Open</a>\n</>')
+ * // { kind: 'Jsx', value: '<>\n  <a href={href}>Open</a>\n</>' }
+ * ```
+ */
+type JsxNode = BaseNode & {
+  /**
+   * Node kind.
+   */
+  kind: 'Jsx';
+  /**
+   * The raw JSX string content.
    */
-  nodes?: Array<CodeNode | string>;
+  value: string;
 };
 /**
  * Union of all code-generation AST nodes.
  *
- * These nodes mirror the JSX components from `@kubb/react-fabric` and are used as
+ * These nodes mirror the JSX components from `@kubb/renderer-jsx` and are used as
  * structured children in {@link SourceNode.nodes}.
  */
-type CodeNode = ConstNode | TypeNode | FunctionNode | ArrowFunctionNode;
+type CodeNode = ConstNode | TypeNode | FunctionNode | ArrowFunctionNode | TextNode | BreakNode | JsxNode;
 //#endregion
 //#region src/nodes/file.d.ts
 /**
@@ -552,12 +618,12 @@ type ExportNode = BaseNode & {
  *
  * @example Named exportable source
  * ```ts
- * createSource({ name: 'Pet', value: 'export type Pet = { id: number }', isExportable: true, isIndexable: true })
+ * createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')], isExportable: true, isIndexable: true })
  * ```
  *
  * @example Inline unnamed code block
  * ```ts
- * createSource({ value: 'const x = 1' })
+ * createSource({ nodes: [createText('const x = 1')] })
  * ```
  */
 type SourceNode = BaseNode & {
@@ -566,10 +632,6 @@ type SourceNode = BaseNode & {
    * Optional name identifying this source (used for deduplication and barrel generation).
    */
   name?: string;
-  /**
-   * The source code value.
-   */
-  value?: string;
   /**
    * Mark this source as a type-only export.
    * @default false
@@ -586,9 +648,8 @@ type SourceNode = BaseNode & {
    */
   isIndexable?: boolean;
   /**
-   * Structured child nodes representing the content of this source fragment.
-   * These correspond to the children of the `File.Source` component from `@kubb/react-fabric`
-   * (e.g. `ConstNode`, `TypeDeclarationNode`, `FunctionDeclarationNode`, `ArrowFunctionDeclarationNode`).
+   * Structured child nodes representing the content of this source fragment, in DOM order.
+   * Each entry is a {@link CodeNode}; use {@link TextNode} for raw string content.
    */
   nodes?: Array<CodeNode>;
 };
@@ -603,7 +664,7 @@ type SourceNode = BaseNode & {
  * const file = createFile({
  *   baseName: 'petStore.ts',
  *   path: 'src/models/petStore.ts',
- *   sources: [createSource({ name: 'Pet', value: 'export type Pet = { id: number }', isExportable: true })],
+ *   sources: [createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')], isExportable: true })],
  *   imports: [createImport({ name: ['z'], path: 'zod' })],
  *   exports: [createExport({ name: ['Pet'], path: './petStore' })],
  * })
@@ -2294,7 +2355,7 @@ declare function createExport(props: Omit<ExportNode, 'kind'>): ExportNode;
  *
  * @example
  * ```ts
- * createSource({ name: 'Pet', value: 'export type Pet = { id: number }', isExportable: true })
+ * createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')], isExportable: true })
  * ```
  */
 declare function createSource(props: Omit<SourceNode, 'kind'>): SourceNode;
@@ -2319,7 +2380,7 @@ type UserFileNode<TMeta extends object = object> = Omit<FileNode<TMeta>, 'kind'
  * const file = createFile({
  *   baseName: 'petStore.ts',
  *   path: 'src/models/petStore.ts',
- *   sources: [createSource({ name: 'Pet', value: 'export type Pet = { id: number }' })],
+ *   sources: [createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')] })],
  *   imports: [createImport({ name: ['z'], path: 'zod' })],
  *   exports: [createExport({ name: ['Pet'], path: './petStore' })],
  * })
@@ -2332,7 +2393,7 @@ declare function createFile<TMeta extends object = object>(input: UserFileNode<T
 /**
  * Creates a `ConstNode` representing a TypeScript `const` declaration.
  *
- * Mirrors the `Const` component from `@kubb/react-fabric`.
+ * Mirrors the `Const` component from `@kubb/renderer-jsx`.
  * The component's `children` are represented as `nodes`.
  *
  * @example Simple constant
@@ -2361,7 +2422,7 @@ declare function createConst(props: Omit<ConstNode, 'kind'>): ConstNode;
 /**
  * Creates a `TypeNode` representing a TypeScript `type` alias declaration.
  *
- * Mirrors the `Type` component from `@kubb/react-fabric`.
+ * Mirrors the `Type` component from `@kubb/renderer-jsx`.
  * The component's `children` are represented as `nodes`.
  *
  * @example Simple type alias
@@ -2384,7 +2445,7 @@ declare function createType(props: Omit<TypeNode, 'kind'>): TypeNode;
 /**
  * Creates a `FunctionNode` representing a TypeScript `function` declaration.
  *
- * Mirrors the `Function` component from `@kubb/react-fabric`.
+ * Mirrors the `Function` component from `@kubb/renderer-jsx`.
  * The component's `children` are represented as `nodes`.
  *
  * @example Simple function
@@ -2415,7 +2476,7 @@ declare function createFunction(props: Omit<FunctionNode, 'kind'>): FunctionNode
 /**
  * Creates an `ArrowFunctionNode` representing a TypeScript arrow function.
  *
- * Mirrors the `Function.Arrow` component from `@kubb/react-fabric`.
+ * Mirrors the `Function.Arrow` component from `@kubb/renderer-jsx`.
  * The component's `children` are represented as `nodes`.
  *
  * @example Simple arrow function
@@ -2444,6 +2505,44 @@ declare function createFunction(props: Omit<FunctionNode, 'kind'>): FunctionNode
  * ```
  */
 declare function createArrowFunction(props: Omit<ArrowFunctionNode, 'kind'>): ArrowFunctionNode;
+/**
+ * Creates a {@link TextNode} representing a raw string fragment in the source output.
+ *
+ * Use this instead of bare strings when building `nodes` arrays so that every
+ * entry in the array is a typed {@link CodeNode}.
+ *
+ * @example
+ * ```ts
+ * createText('return fetch(id)')
+ * // { kind: 'Text', value: 'return fetch(id)' }
+ * ```
+ */
+declare function createText(value: string): TextNode;
+/**
+ * Creates a {@link BreakNode} representing a line break in the source output.
+ *
+ * Corresponds to `<br/>` in JSX components. Prints as an empty string which,
+ * when joined with `\n` by `printNodes`, produces a blank line.
+ *
+ * @example
+ * ```ts
+ * createBreak()
+ * // { kind: 'Break' }
+ * ```
+ */
+declare function createBreak(): BreakNode;
+/**
+ * Creates a {@link JsxNode} representing a raw JSX fragment in the source output.
+ *
+ * Use this to embed JSX markup (including fragments `<>…</>`) directly in generated code.
+ *
+ * @example
+ * ```ts
+ * createJsx('<>\n  <a href={href}>Open</a>\n</>')
+ * // { kind: 'Jsx', value: '<>\n  <a href={href}>Open</a>\n</>' }
+ * ```
+ */
+declare function createJsx(value: string): JsxNode;
 //#endregion
 //#region src/printer.d.ts
 /**
@@ -2929,5 +3028,5 @@ declare function composeTransformers(...visitors: Array<Visitor>): Visitor;
  */
 declare function collect<T>(node: Node, options: CollectOptions<T>): Array<T>;
 //#endregion
-export { StatusCode as $, createOperation as A, FunctionParametersNode as At, syncOptionality as B, FunctionNode as Bt, createExport as C, TimeSchemaNode as Ct, createFunctionParameters as D, FunctionNodeType as Dt, createFunctionParameter as E, PropertyNode as Et, createProperty as F, ImportNode as Ft, InputMeta as G, NodeKind as Gt, InferSchemaNode as H, TypeDeclarationNode as Ht, createResponse as I, SourceNode as It, HttpMethod as J, httpMethods as Jt, InputNode as K, ScalarPrimitive as Kt, createSchema as L, ArrowFunctionNode as Lt, createParameter as M, ParamsTypeNode as Mt, createParameterGroup as N, ExportNode as Nt, createImport as O, FunctionParamNode as Ot, createParamsType as P, FileNode as Pt, MediaType as Q, schemaTypes as Qt, createSource as R, CodeNode as Rt, createConst as S, StringSchemaNode as St, createFunction as T, UrlSchemaNode as Tt, ParserOptions as U, TypeNode as Ut, InferSchema as V, JSDocNode as Vt, Node as W, BaseNode as Wt, ResponseNode as X, mediaTypes as Xt, OperationNode as Y, isScalarPrimitive as Yt, HttpStatusCode as Z, nodeKinds as Zt, PrinterPartial as _, ScalarSchemaType as _t, TransformOptions as a, DatetimeSchemaNode as at, DistributiveOmit as b, SchemaType as bt, WalkOptions as c, FormatStringSchemaNode as ct, transform as d, Ipv6SchemaNode as dt, ParameterLocation as et, walk as f, NumberSchemaNode as ft, PrinterFactoryOptions as g, ScalarSchemaNode as gt, Printer as h, RefSchemaNode as ht, ParentOf as i, DateSchemaNode as it, createOutput as j, ParameterGroupNode as jt, createInput as k, FunctionParameterNode as kt, collect as l, IntersectionSchemaNode as lt, extractRefName as m, PrimitiveSchemaType as mt, CollectOptions as n, ArraySchemaNode as nt, Visitor as o, EnumSchemaNode as ot, RefMap as p, ObjectSchemaNode as pt, OutputNode as q, VisitorDepth as qt, CollectVisitor as r, ComplexSchemaType as rt, VisitorContext as s, EnumValueNode as st, AsyncVisitor as t, ParameterNode as tt, composeTransformers as u, Ipv4SchemaNode as ut, createPrinterFactory as v, SchemaNode as vt, createFile as w, UnionSchemaNode as wt, createArrowFunction as x, SpecialSchemaType as xt, definePrinter as y, SchemaNodeByType as yt, createType as z, ConstNode as zt };
-//# sourceMappingURL=visitor-DysNCWvh.d.ts.map
+export { ResponseNode as $, VisitorDepth as $t, createInput as A, FunctionNodeType as At, createSource as B, ArrowFunctionNode as Bt, createConst as C, SchemaType as Ct, createFunctionParameter as D, UnionSchemaNode as Dt, createFunction as E, TimeSchemaNode as Et, createParameterGroup as F, ParamsTypeNode as Ft, InferSchemaNode as G, JSDocNode as Gt, createType as H, CodeNode as Ht, createParamsType as I, ExportNode as It, InputMeta as J, TypeDeclarationNode as Jt, ParserOptions as K, JsxNode as Kt, createProperty as L, FileNode as Lt, createOperation as M, FunctionParameterNode as Mt, createOutput as N, FunctionParametersNode as Nt, createFunctionParameters as O, UrlSchemaNode as Ot, createParameter as P, ParameterGroupNode as Pt, OperationNode as Q, ScalarPrimitive as Qt, createResponse as R, ImportNode as Rt, createBreak as S, SchemaNodeByType as St, createFile as T, StringSchemaNode as Tt, syncOptionality as U, ConstNode as Ut, createText as V, BreakNode as Vt, InferSchema as W, FunctionNode as Wt, OutputNode as X, BaseNode as Xt, InputNode as Y, TypeNode as Yt, HttpMethod as Z, NodeKind as Zt, PrinterPartial as _, PrimitiveSchemaType as _t, TransformOptions as a, ArraySchemaNode as at, DistributiveOmit as b, ScalarSchemaType as bt, WalkOptions as c, DatetimeSchemaNode as ct, transform as d, FormatStringSchemaNode as dt, httpMethods as en, HttpStatusCode as et, walk as f, IntersectionSchemaNode as ft, PrinterFactoryOptions as g, ObjectSchemaNode as gt, Printer as h, NumberSchemaNode as ht, ParentOf as i, schemaTypes as in, ParameterNode as it, createJsx as j, FunctionParamNode as jt, createImport as k, PropertyNode as kt, collect as l, EnumSchemaNode as lt, extractRefName as m, Ipv6SchemaNode as mt, CollectOptions as n, mediaTypes as nn, StatusCode as nt, Visitor as o, ComplexSchemaType as ot, RefMap as p, Ipv4SchemaNode as pt, Node as q, TextNode as qt, CollectVisitor as r, nodeKinds as rn, ParameterLocation as rt, VisitorContext as s, DateSchemaNode as st, AsyncVisitor as t, isScalarPrimitive as tn, MediaType as tt, composeTransformers as u, EnumValueNode as ut, createPrinterFactory as v, RefSchemaNode as vt, createExport as w, SpecialSchemaType as wt, createArrowFunction as x, SchemaNode as xt, definePrinter as y, ScalarSchemaNode as yt, createSchema as z, SourceNode as zt };
+//# sourceMappingURL=visitor-CJMIoAE3.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/ast",
-  "version": "5.0.0-alpha.32",
+  "version": "5.0.0-alpha.33",
   "description": "Spec-agnostic AST layer for Kubb. Defines nodes, visitor pattern, and factory functions used across codegen plugins.",
   "keywords": [
     "kubb",

package/src/constants.ts

@@ -30,6 +30,8 @@ export const nodeKinds = {
   import: 'Import',
   export: 'Export',
   source: 'Source',
+  text: 'Text',
+  break: 'Break',
 } as const satisfies Record<string, NodeKind>
 
 /**

package/src/factory.ts

@@ -4,6 +4,7 @@ import { trimExtName } from '@internals/utils'
 import type { InferSchemaNode } from './infer.ts'
 import type {
   ArrowFunctionNode,
+  BreakNode,
   ConstNode,
   ExportNode,
   FileNode,
@@ -12,6 +13,7 @@ import type {
   FunctionParametersNode,
   ImportNode,
   InputNode,
+  JsxNode,
   ObjectSchemaNode,
   OperationNode,
   OutputNode,
@@ -23,9 +25,10 @@ import type {
   ResponseNode,
   SchemaNode,
   SourceNode,
+  TextNode,
   TypeNode,
 } from './nodes/index.ts'
-import { combineExports, combineImports, combineSources } from './utils.ts'
+import { combineExports, combineImports, combineSources, extractStringsFromNodes } from './utils.ts'
 
 /**
  * Syncs property/parameter schema optionality flags from `required` and `schema.nullable`.
@@ -477,7 +480,7 @@ export function createExport(props: Omit<ExportNode, 'kind'>): ExportNode {
  *
  * @example
  * ```ts
- * createSource({ name: 'Pet', value: 'export type Pet = { id: number }', isExportable: true })
+ * createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')], isExportable: true })
  * ```
  */
 export function createSource(props: Omit<SourceNode, 'kind'>): SourceNode {
@@ -507,7 +510,7 @@ type UserFileNode<TMeta extends object = object> = Omit<FileNode<TMeta>, 'kind'
  * const file = createFile({
  *   baseName: 'petStore.ts',
  *   path: 'src/models/petStore.ts',
- *   sources: [createSource({ name: 'Pet', value: 'export type Pet = { id: number }' })],
+ *   sources: [createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')] })],
  *   imports: [createImport({ name: ['z'], path: 'zod' })],
  *   exports: [createExport({ name: ['Pet'], path: './petStore' })],
  * })
@@ -524,9 +527,13 @@ export function createFile<TMeta extends object = object>(input: UserFileNode<TM
     throw new Error(`No extname found for ${input.baseName}`)
   }
 
-  const source = (input.sources ?? []).map((item) => item.value).join('\n\n')
+  const source = (input.sources ?? [])
+    .flatMap((item) => item.nodes ?? [])
+    .map((node) => extractStringsFromNodes([node]))
+    .filter(Boolean)
+    .join('\n\n')
   const resolvedExports = input.exports?.length ? combineExports(input.exports) : []
-  const resolvedImports = input.imports?.length && source ? combineImports(input.imports, resolvedExports, source) : []
+  const resolvedImports = input.imports?.length ? combineImports(input.imports, resolvedExports, source || undefined) : []
   const resolvedSources = input.sources?.length ? combineSources(input.sources) : []
 
   return {
@@ -545,7 +552,7 @@ export function createFile<TMeta extends object = object>(input: UserFileNode<TM
 /**
  * Creates a `ConstNode` representing a TypeScript `const` declaration.
  *
- * Mirrors the `Const` component from `@kubb/react-fabric`.
+ * Mirrors the `Const` component from `@kubb/renderer-jsx`.
  * The component's `children` are represented as `nodes`.
  *
  * @example Simple constant
@@ -577,7 +584,7 @@ export function createConst(props: Omit<ConstNode, 'kind'>): ConstNode {
 /**
  * Creates a `TypeNode` representing a TypeScript `type` alias declaration.
  *
- * Mirrors the `Type` component from `@kubb/react-fabric`.
+ * Mirrors the `Type` component from `@kubb/renderer-jsx`.
  * The component's `children` are represented as `nodes`.
  *
  * @example Simple type alias
@@ -603,7 +610,7 @@ export function createType(props: Omit<TypeNode, 'kind'>): TypeNode {
 /**
  * Creates a `FunctionNode` representing a TypeScript `function` declaration.
  *
- * Mirrors the `Function` component from `@kubb/react-fabric`.
+ * Mirrors the `Function` component from `@kubb/renderer-jsx`.
  * The component's `children` are represented as `nodes`.
  *
  * @example Simple function
@@ -637,7 +644,7 @@ export function createFunction(props: Omit<FunctionNode, 'kind'>): FunctionNode
 /**
  * Creates an `ArrowFunctionNode` representing a TypeScript arrow function.
  *
- * Mirrors the `Function.Arrow` component from `@kubb/react-fabric`.
+ * Mirrors the `Function.Arrow` component from `@kubb/renderer-jsx`.
  * The component's `children` are represented as `nodes`.
  *
  * @example Simple arrow function
@@ -668,3 +675,50 @@ export function createFunction(props: Omit<FunctionNode, 'kind'>): FunctionNode
 export function createArrowFunction(props: Omit<ArrowFunctionNode, 'kind'>): ArrowFunctionNode {
   return { ...props, kind: 'ArrowFunction' }
 }
+
+/**
+ * Creates a {@link TextNode} representing a raw string fragment in the source output.
+ *
+ * Use this instead of bare strings when building `nodes` arrays so that every
+ * entry in the array is a typed {@link CodeNode}.
+ *
+ * @example
+ * ```ts
+ * createText('return fetch(id)')
+ * // { kind: 'Text', value: 'return fetch(id)' }
+ * ```
+ */
+export function createText(value: string): TextNode {
+  return { value, kind: 'Text' }
+}
+
+/**
+ * Creates a {@link BreakNode} representing a line break in the source output.
+ *
+ * Corresponds to `<br/>` in JSX components. Prints as an empty string which,
+ * when joined with `\n` by `printNodes`, produces a blank line.
+ *
+ * @example
+ * ```ts
+ * createBreak()
+ * // { kind: 'Break' }
+ * ```
+ */
+export function createBreak(): BreakNode {
+  return { kind: 'Break' }
+}
+
+/**
+ * Creates a {@link JsxNode} representing a raw JSX fragment in the source output.
+ *
+ * Use this to embed JSX markup (including fragments `<>…</>`) directly in generated code.
+ *
+ * @example
+ * ```ts
+ * createJsx('<>\n  <a href={href}>Open</a>\n</>')
+ * // { kind: 'Jsx', value: '<>\n  <a href={href}>Open</a>\n</>' }
+ * ```
+ */
+export function createJsx(value: string): JsxNode {
+  return { value, kind: 'Jsx' }
+}

package/src/index.ts

@@ -2,6 +2,7 @@ export type { ScalarPrimitive } from './constants.ts'
 export { httpMethods, isScalarPrimitive, mediaTypes, nodeKinds, schemaTypes } from './constants.ts'
 export {
   createArrowFunction,
+  createBreak,
   createConst,
   createExport,
   createFile,
@@ -10,6 +11,7 @@ export {
   createFunctionParameters,
   createImport,
   createInput,
+  createJsx,
   createOperation,
   createOutput,
   createParameter,
@@ -19,6 +21,7 @@ export {
   createResponse,
   createSchema,
   createSource,
+  createText,
   createType,
   syncOptionality,
 } from './factory.ts'
@@ -32,11 +35,9 @@ export { mergeAdjacentObjects, setDiscriminatorEnum, setEnumName, simplifyUnion
 export type { OperationParamsResolver } from './utils.ts'
 export {
   caseParams,
-  combineExports,
-  combineImports,
-  combineSources,
   createDiscriminantNode,
   createOperationParams,
+  extractStringsFromNodes,
   isStringType,
   syncSchemaRef,
 } from './utils.ts'

package/src/nodes/base.ts

@@ -26,6 +26,9 @@ export type NodeKind =
   | 'Const'
   | 'Function'
   | 'ArrowFunction'
+  | 'Text'
+  | 'Break'
+  | 'Jsx'
 
 /**
  * Base shape shared by all AST nodes.