@kubb/renderer-jsx 5.0.0-beta.22 → 5.0.0-beta.23

package/dist/index.cjs

@@ -18382,19 +18382,29 @@ var SyncRuntime = class {
 //#endregion
 //#region src/createRenderer.tsx
 /**
-* Renderer factory for generators that produce JSX output.
+* Renderer factory that turns the JSX produced by a generator into
+* `FileNode`s using React's reconciler under the hood. Pass as the `renderer`
+* property on `defineGenerator`. Kubb core stays generic, with no hard
+* dependency on `@kubb/renderer-jsx`.
 *
-* Pass as the `renderer` property of `defineGenerator`. Core drives rendering
-* without a hard dependency on `@kubb/renderer-jsx`.
+* Use this when generators rely on React features (hooks, suspense, context).
+* For pure-function components, see {@link jsxRendererSync} for ~2-4× faster
+* rendering.
 *
-* @example
-* ```ts
+* @example Wire up a JSX generator
+* ```tsx
+* import { defineGenerator } from '@kubb/core'
 * import { jsxRenderer } from '@kubb/renderer-jsx'
 *
 * export const myGenerator = defineGenerator<PluginTs>({
+*   name: 'types',
 *   renderer: jsxRenderer,
-*   schema(node, options) {
-*     return <File baseName="output.ts" path="src/output.ts">...</File>
+*   schema(node, ctx) {
+*     return (
+*       <File baseName="output.ts" path={`${ctx.root}/output.ts`}>
+*         <Type node={node} resolver={ctx.resolver} />
+*       </File>
+*     )
 *   },
 * })
 * ```
@@ -18420,28 +18430,40 @@ const jsxRenderer = () => {
 	};
 };
 /**
-* Lightweight renderer factory with no React fiber, scheduler, or work loop.
+* Lightweight renderer that walks the JSX tree in a single recursive pass —
+* no React reconciler, no scheduler. Drop-in replacement for
+* {@link jsxRenderer} at roughly 2–4× the throughput.
 *
-* Walks the JSX element tree in a single recursive pass. All components must be
-* pure functions; hooks and class components are not supported. Drop-in
-* replacement for {@link jsxRenderer} at approximately 2–4× the speed.
+* Constraints: every component must be a pure function. Hooks, suspense, and
+* class components are not supported.
 *
-* @example Drop-in replacement
-* ```ts
+* Use this for generators that produce large amounts of output and do not need
+* React's runtime features. It also exposes `stream()` for incremental file
+* emission.
+*
+* @example Drop-in faster renderer
+* ```tsx
+* import { defineGenerator } from '@kubb/core'
 * import { jsxRendererSync } from '@kubb/renderer-jsx'
 *
 * export const myGenerator = defineGenerator<PluginTs>({
+*   name: 'types',
 *   renderer: jsxRendererSync,
-*   schema(node, options) {
-*     return <File baseName="output.ts" path="src/output.ts">...</File>
+*   schema(node, ctx) {
+*     return (
+*       <File baseName="output.ts" path={`${ctx.root}/output.ts`}>
+*         <Type node={node} resolver={ctx.resolver} />
+*       </File>
+*     )
 *   },
 * })
 * ```
 *
 * @example Stream files as they are produced
-* ```ts
-* for await (const file of jsxRendererSync().stream(element)) {
-*   await writeFile(file)
+* ```tsx
+* const renderer = jsxRendererSync()
+* for (const file of renderer.stream(element)) {
+*   await writeFile(file.path, file.sources[0])
 * }
 * ```
 */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { n as __name } from "./chunk-Bb7HlUDG.js";
-import { a as JSDoc, h as KubbReactNode, m as KubbReactElement, o as Key } from "./types-D3-ni438.js";
+import { a as JSDoc, h as KubbReactNode, m as KubbReactElement, o as Key } from "./types-ChkUbtyQ.js";
 import { ExportNode, FileNode, ImportNode, SourceNode } from "@kubb/ast";
 import * as _$react from "react";
 
@@ -63,26 +63,26 @@ type ConstProps = {
    * - `false` generates `const name = …`
    * @default false
    */
-  export?: boolean;
+  export?: boolean | null;
   /**
    * TypeScript type annotation for the constant, written verbatim after `const name:`.
    *
    * @example
    * `type: 'Pet'` → `const pet: Pet = …`
    */
-  type?: string;
+  type?: string | null;
   /**
    * JSDoc block to prepend to the constant declaration.
    * Each entry in `comments` becomes one line inside the emitted `/** … *\/` block.
    */
-  JSDoc?: JSDoc;
+  JSDoc?: JSDoc | null;
   /**
    * Append `as const` after the initialiser, enabling TypeScript const assertions.
    * - `true` generates `const name = … as const`
    * - `false` generates `const name = …`
    * @default false
    */
-  asConst?: boolean;
+  asConst?: boolean | null;
   /**
    * Child nodes rendered as the initialiser expression of the constant.
    */
@@ -140,7 +140,7 @@ type BasePropsWithoutBaseName = {
    * Fully qualified path to the generated file.
    * Optional when `baseName` is omitted — the component renders its children inline.
    */
-  path?: string;
+  path?: string | null;
 };
 type BaseProps = BasePropsWithBaseName | BasePropsWithoutBaseName;
 type Props$2<TMeta> = BaseProps & {
@@ -149,7 +149,7 @@ type Props$2<TMeta> = BaseProps & {
    * Arbitrary metadata attached to the file node.
    * Used by plugins for barrel generation and custom post-processing.
    */
-  meta?: TMeta;
+  meta?: TMeta | null;
   /**
    * Text prepended to the generated file content before any source blocks.
    * Accepts `null` so `resolver.resolveBanner()` results can be passed directly.
@@ -295,28 +295,28 @@ type Props$1 = {
    * Requires `export` to also be `true`.
    * @default false
    */
-  default?: boolean;
+  default?: boolean | null;
   /**
    * Parameter list written verbatim between the function's parentheses.
    *
    * @example
    * `params: 'petId: string, options?: RequestOptions'`
    */
-  params?: string;
+  params?: string | null;
   /**
    * Emit the `export` keyword before the function declaration.
    * - `true` generates `export function name(…) { … }`
    * - `false` generates `function name(…) { … }`
    * @default false
    */
-  export?: boolean;
+  export?: boolean | null;
   /**
    * Emit the `async` keyword, making this an async function.
    * The return type is automatically wrapped in `Promise<returnType>` when both
    * `async` and `returnType` are set.
    * @default false
    */
-  async?: boolean;
+  async?: boolean | null;
   /**
    * TypeScript generic type parameters written verbatim between `<` and `>`.
    * Pass an array to emit multiple parameters separated by commas.
@@ -327,7 +327,7 @@ type Props$1 = {
    * @example Multiple generics
    * `generics: ['TData', 'TError = unknown']`
    */
-  generics?: string | string[];
+  generics?: string | string[] | null;
   /**
    * TypeScript return type annotation written verbatim after `:`.
    * When `async` is `true`, the value is automatically wrapped in `Promise<…>`.
@@ -335,12 +335,12 @@ type Props$1 = {
    * @example
    * `returnType: 'Pet'`
    */
-  returnType?: string;
+  returnType?: string | null;
   /**
    * JSDoc block to prepend to the function declaration.
    * Each entry in `comments` becomes one line inside the emitted `/** … *\/` block.
    */
-  JSDoc?: JSDoc;
+  JSDoc?: JSDoc | null;
   /**
    * Child nodes rendered as the body of the function.
    */
@@ -374,7 +374,7 @@ type ArrowFunctionProps = Props$1 & {
    * - `false` generates `const name = (…) => { … }`
    * @default false
    */
-  singleLine?: boolean;
+  singleLine?: boolean | null;
 };
 /**
  * Generates an arrow function expression assigned to a `const`.
@@ -480,12 +480,12 @@ type TypeProps = {
    * - `false` generates `type Name = …`
    * @default false
    */
-  export?: boolean;
+  export?: boolean | null;
   /**
    * JSDoc block to prepend to the type alias declaration.
    * Each entry in `comments` becomes one line inside the emitted `/** … *\/` block.
    */
-  JSDoc?: JSDoc;
+  JSDoc?: JSDoc | null;
   /**
    * Child nodes rendered as the type expression on the right-hand side of the alias.
    */
@@ -522,19 +522,29 @@ declare namespace Type {
 //#endregion
 //#region src/createRenderer.d.ts
 /**
- * Renderer factory for generators that produce JSX output.
+ * Renderer factory that turns the JSX produced by a generator into
+ * `FileNode`s using React's reconciler under the hood. Pass as the `renderer`
+ * property on `defineGenerator`. Kubb core stays generic, with no hard
+ * dependency on `@kubb/renderer-jsx`.
  *
- * Pass as the `renderer` property of `defineGenerator`. Core drives rendering
- * without a hard dependency on `@kubb/renderer-jsx`.
+ * Use this when generators rely on React features (hooks, suspense, context).
+ * For pure-function components, see {@link jsxRendererSync} for ~2-4× faster
+ * rendering.
  *
- * @example
- * ```ts
+ * @example Wire up a JSX generator
+ * ```tsx
+ * import { defineGenerator } from '@kubb/core'
  * import { jsxRenderer } from '@kubb/renderer-jsx'
  *
  * export const myGenerator = defineGenerator<PluginTs>({
+ *   name: 'types',
  *   renderer: jsxRenderer,
- *   schema(node, options) {
- *     return <File baseName="output.ts" path="src/output.ts">...</File>
+ *   schema(node, ctx) {
+ *     return (
+ *       <File baseName="output.ts" path={`${ctx.root}/output.ts`}>
+ *         <Type node={node} resolver={ctx.resolver} />
+ *       </File>
+ *     )
  *   },
  * })
  * ```
@@ -547,28 +557,40 @@ declare const jsxRenderer: () => {
   [Symbol.dispose](): void;
 };
 /**
- * Lightweight renderer factory with no React fiber, scheduler, or work loop.
+ * Lightweight renderer that walks the JSX tree in a single recursive pass —
+ * no React reconciler, no scheduler. Drop-in replacement for
+ * {@link jsxRenderer} at roughly 2–4× the throughput.
  *
- * Walks the JSX element tree in a single recursive pass. All components must be
- * pure functions; hooks and class components are not supported. Drop-in
- * replacement for {@link jsxRenderer} at approximately 2–4× the speed.
+ * Constraints: every component must be a pure function. Hooks, suspense, and
+ * class components are not supported.
  *
- * @example Drop-in replacement
- * ```ts
+ * Use this for generators that produce large amounts of output and do not need
+ * React's runtime features. It also exposes `stream()` for incremental file
+ * emission.
+ *
+ * @example Drop-in faster renderer
+ * ```tsx
+ * import { defineGenerator } from '@kubb/core'
  * import { jsxRendererSync } from '@kubb/renderer-jsx'
  *
  * export const myGenerator = defineGenerator<PluginTs>({
+ *   name: 'types',
  *   renderer: jsxRendererSync,
- *   schema(node, options) {
- *     return <File baseName="output.ts" path="src/output.ts">...</File>
+ *   schema(node, ctx) {
+ *     return (
+ *       <File baseName="output.ts" path={`${ctx.root}/output.ts`}>
+ *         <Type node={node} resolver={ctx.resolver} />
+ *       </File>
+ *     )
  *   },
  * })
  * ```
  *
  * @example Stream files as they are produced
- * ```ts
- * for await (const file of jsxRendererSync().stream(element)) {
- *   await writeFile(file)
+ * ```tsx
+ * const renderer = jsxRendererSync()
+ * for (const file of renderer.stream(element)) {
+ *   await writeFile(file.path, file.sources[0])
  * }
  * ```
  */

package/dist/index.js

@@ -18379,19 +18379,29 @@ var SyncRuntime = class {
 //#endregion
 //#region src/createRenderer.tsx
 /**
-* Renderer factory for generators that produce JSX output.
+* Renderer factory that turns the JSX produced by a generator into
+* `FileNode`s using React's reconciler under the hood. Pass as the `renderer`
+* property on `defineGenerator`. Kubb core stays generic, with no hard
+* dependency on `@kubb/renderer-jsx`.
 *
-* Pass as the `renderer` property of `defineGenerator`. Core drives rendering
-* without a hard dependency on `@kubb/renderer-jsx`.
+* Use this when generators rely on React features (hooks, suspense, context).
+* For pure-function components, see {@link jsxRendererSync} for ~2-4× faster
+* rendering.
 *
-* @example
-* ```ts
+* @example Wire up a JSX generator
+* ```tsx
+* import { defineGenerator } from '@kubb/core'
 * import { jsxRenderer } from '@kubb/renderer-jsx'
 *
 * export const myGenerator = defineGenerator<PluginTs>({
+*   name: 'types',
 *   renderer: jsxRenderer,
-*   schema(node, options) {
-*     return <File baseName="output.ts" path="src/output.ts">...</File>
+*   schema(node, ctx) {
+*     return (
+*       <File baseName="output.ts" path={`${ctx.root}/output.ts`}>
+*         <Type node={node} resolver={ctx.resolver} />
+*       </File>
+*     )
 *   },
 * })
 * ```
@@ -18417,28 +18427,40 @@ const jsxRenderer = () => {
 	};
 };
 /**
-* Lightweight renderer factory with no React fiber, scheduler, or work loop.
+* Lightweight renderer that walks the JSX tree in a single recursive pass —
+* no React reconciler, no scheduler. Drop-in replacement for
+* {@link jsxRenderer} at roughly 2–4× the throughput.
 *
-* Walks the JSX element tree in a single recursive pass. All components must be
-* pure functions; hooks and class components are not supported. Drop-in
-* replacement for {@link jsxRenderer} at approximately 2–4× the speed.
+* Constraints: every component must be a pure function. Hooks, suspense, and
+* class components are not supported.
 *
-* @example Drop-in replacement
-* ```ts
+* Use this for generators that produce large amounts of output and do not need
+* React's runtime features. It also exposes `stream()` for incremental file
+* emission.
+*
+* @example Drop-in faster renderer
+* ```tsx
+* import { defineGenerator } from '@kubb/core'
 * import { jsxRendererSync } from '@kubb/renderer-jsx'
 *
 * export const myGenerator = defineGenerator<PluginTs>({
+*   name: 'types',
 *   renderer: jsxRendererSync,
-*   schema(node, options) {
-*     return <File baseName="output.ts" path="src/output.ts">...</File>
+*   schema(node, ctx) {
+*     return (
+*       <File baseName="output.ts" path={`${ctx.root}/output.ts`}>
+*         <Type node={node} resolver={ctx.resolver} />
+*       </File>
+*     )
 *   },
 * })
 * ```
 *
 * @example Stream files as they are produced
-* ```ts
-* for await (const file of jsxRendererSync().stream(element)) {
-*   await writeFile(file)
+* ```tsx
+* const renderer = jsxRendererSync()
+* for (const file of renderer.stream(element)) {
+*   await writeFile(file.path, file.sources[0])
 * }
 * ```
 */

package/dist/jsx-dev-runtime.d.ts

@@ -1,6 +1,6 @@
 import { n as __name } from "./chunk-Bb7HlUDG.js";
-import { h as KubbReactNode, m as KubbReactElement } from "./types-D3-ni438.js";
-import { t as JSX } from "./jsx-namespace-C7dcxEyT.js";
+import { h as KubbReactNode, m as KubbReactElement } from "./types-ChkUbtyQ.js";
+import { t as JSX } from "./jsx-namespace-BW3LepJB.js";
 import * as _$react from "react";
 import * as React$1 from "react/jsx-runtime";
 

package/dist/{jsx-namespace-C7dcxEyT.d.ts → jsx-namespace-BW3LepJB.d.ts}

@@ -1,5 +1,5 @@
 import { n as __name } from "./chunk-Bb7HlUDG.js";
-import { _ as KubbTextProps, c as KubbConstProps, d as KubbFunctionProps, f as KubbImportProps, g as KubbSourceProps, h as KubbReactNode, l as KubbExportProps, m as KubbReactElement, p as KubbJsxProps, s as KubbArrowFunctionProps, u as KubbFileProps, v as KubbTypeProps, y as LineBreakProps } from "./types-D3-ni438.js";
+import { _ as KubbTextProps, c as KubbConstProps, d as KubbFunctionProps, f as KubbImportProps, g as KubbSourceProps, h as KubbReactNode, l as KubbExportProps, m as KubbReactElement, p as KubbJsxProps, s as KubbArrowFunctionProps, u as KubbFileProps, v as KubbTypeProps, y as LineBreakProps } from "./types-ChkUbtyQ.js";
 import React from "react";
 
 //#region src/jsx-namespace.d.ts
@@ -36,4 +36,4 @@ declare namespace JSX$1 {
 }
 //#endregion
 export { JSX$1 as t };
-//# sourceMappingURL=jsx-namespace-C7dcxEyT.d.ts.map
+//# sourceMappingURL=jsx-namespace-BW3LepJB.d.ts.map

package/dist/jsx-runtime.d.ts

@@ -1,6 +1,6 @@
 import { n as __name } from "./chunk-Bb7HlUDG.js";
-import { h as KubbReactNode, m as KubbReactElement } from "./types-D3-ni438.js";
-import { t as JSX } from "./jsx-namespace-C7dcxEyT.js";
+import { h as KubbReactNode, m as KubbReactElement } from "./types-ChkUbtyQ.js";
+import { t as JSX } from "./jsx-namespace-BW3LepJB.js";
 import * as _$react from "react";
 import * as React$1 from "react/jsx-runtime";
 

package/dist/{types-D3-ni438.d.ts → types-ChkUbtyQ.d.ts}

@@ -18,8 +18,9 @@ type Node = {
 };
 /**
  * Allowed attribute value types for DOM elements.
+ * `null` signals intentionally empty — the prop was explicitly cleared.
  */
-type DOMNodeAttribute = boolean | string | number | Record<string, unknown> | Array<unknown>;
+type DOMNodeAttribute = boolean | string | number | null | Record<string, unknown> | Array<unknown>;
 type TextName = '#text';
 /**
  * Leaf DOM node containing raw text.
@@ -86,12 +87,12 @@ type KubbTextProps = {
  * Represents a generated file.
  */
 type KubbFileProps = {
-  id?: string;
+  id?: string | null;
   children?: KubbReactNode;
   baseName: string;
   path: string;
-  override?: boolean;
-  meta?: FileNode['meta'];
+  override?: boolean | null;
+  meta?: FileNode['meta'] | null;
 };
 /**
  * Props for the `<kubb-source>` element.
@@ -165,4 +166,4 @@ type JSDoc = {
 };
 //#endregion
 export { KubbTextProps as _, JSDoc as a, TextNode as b, KubbConstProps as c, KubbFunctionProps as d, KubbImportProps as f, KubbSourceProps as g, KubbReactNode as h, ElementNames as i, KubbExportProps as l, KubbReactElement as m, DOMNode as n, Key as o, KubbJsxProps as p, DOMNodeAttribute as r, KubbArrowFunctionProps as s, DOMElement as t, KubbFileProps as u, KubbTypeProps as v, LineBreakProps as y };
-//# sourceMappingURL=types-D3-ni438.d.ts.map
+//# sourceMappingURL=types-ChkUbtyQ.d.ts.map

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-import { _ as KubbTextProps, a as JSDoc, b as TextNode, c as KubbConstProps, d as KubbFunctionProps, f as KubbImportProps, g as KubbSourceProps, h as KubbReactNode, i as ElementNames, l as KubbExportProps, m as KubbReactElement, n as DOMNode, o as Key, p as KubbJsxProps, r as DOMNodeAttribute, s as KubbArrowFunctionProps, t as DOMElement, u as KubbFileProps, v as KubbTypeProps, y as LineBreakProps } from "./types-D3-ni438.js";
+import { _ as KubbTextProps, a as JSDoc, b as TextNode, c as KubbConstProps, d as KubbFunctionProps, f as KubbImportProps, g as KubbSourceProps, h as KubbReactNode, i as ElementNames, l as KubbExportProps, m as KubbReactElement, n as DOMNode, o as Key, p as KubbJsxProps, r as DOMNodeAttribute, s as KubbArrowFunctionProps, t as DOMElement, u as KubbFileProps, v as KubbTypeProps, y as LineBreakProps } from "./types-ChkUbtyQ.js";
 export { DOMElement, DOMNode, DOMNodeAttribute, ElementNames, JSDoc, Key, KubbArrowFunctionProps, KubbConstProps, KubbExportProps, KubbFileProps, KubbFunctionProps, KubbImportProps, KubbJsxProps, KubbReactElement, KubbReactNode, KubbSourceProps, KubbTextProps, KubbTypeProps, LineBreakProps, TextNode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/renderer-jsx",
-  "version": "5.0.0-beta.22",
+  "version": "5.0.0-beta.23",
   "description": "JSX-based renderer for Kubb. Provides a custom React runtime, reconciler, and built-in components (File, Function, Type, Const) for component-based, type-safe code generation.",
   "keywords": [
     "codegen",
@@ -75,7 +75,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/ast": "5.0.0-beta.22"
+    "@kubb/ast": "5.0.0-beta.23"
   },
   "devDependencies": {
     "@types/react": "^19.2.14",

package/src/SyncRuntime.tsx

@@ -99,13 +99,13 @@ function resolveCodeNode(type: string, props: Record<string, unknown>, nodes: Co
     nodes.push(
       createFunction({
         name: props['name'] as string,
-        params: props['params'] as string | undefined,
-        export: props['export'] as boolean | undefined,
-        default: props['default'] as boolean | undefined,
-        async: props['async'] as boolean | undefined,
-        generics: props['generics'] as string | undefined,
-        returnType: props['returnType'] as string | undefined,
-        JSDoc: props['JSDoc'] as JSDocNode | undefined,
+        params: props['params'] as string | null | undefined,
+        export: props['export'] as boolean | null | undefined,
+        default: props['default'] as boolean | null | undefined,
+        async: props['async'] as boolean | null | undefined,
+        generics: props['generics'] as string | string[] | null | undefined,
+        returnType: props['returnType'] as string | null | undefined,
+        JSDoc: props['JSDoc'] as JSDocNode | null | undefined,
         nodes: collectCodeNodes(props),
       }),
     )
@@ -116,14 +116,14 @@ function resolveCodeNode(type: string, props: Record<string, unknown>, nodes: Co
     nodes.push(
       createArrowFunction({
         name: props['name'] as string,
-        params: props['params'] as string | undefined,
-        export: props['export'] as boolean | undefined,
-        default: props['default'] as boolean | undefined,
-        async: props['async'] as boolean | undefined,
-        generics: props['generics'] as string | undefined,
-        returnType: props['returnType'] as string | undefined,
-        singleLine: props['singleLine'] as boolean | undefined,
-        JSDoc: props['JSDoc'] as JSDocNode | undefined,
+        params: props['params'] as string | null | undefined,
+        export: props['export'] as boolean | null | undefined,
+        default: props['default'] as boolean | null | undefined,
+        async: props['async'] as boolean | null | undefined,
+        generics: props['generics'] as string | string[] | null | undefined,
+        returnType: props['returnType'] as string | null | undefined,
+        singleLine: props['singleLine'] as boolean | null | undefined,
+        JSDoc: props['JSDoc'] as JSDocNode | null | undefined,
         nodes: collectCodeNodes(props),
       } as Omit<ArrowFunctionNode, 'kind'>),
     )
@@ -134,10 +134,10 @@ function resolveCodeNode(type: string, props: Record<string, unknown>, nodes: Co
     nodes.push(
       createConst({
         name: props['name'] as string,
-        type: props['type'] as string | undefined,
-        export: props['export'] as boolean | undefined,
-        asConst: props['asConst'] as boolean | undefined,
-        JSDoc: props['JSDoc'] as JSDocNode | undefined,
+        type: props['type'] as string | null | undefined,
+        export: props['export'] as boolean | null | undefined,
+        asConst: props['asConst'] as boolean | null | undefined,
+        JSDoc: props['JSDoc'] as JSDocNode | null | undefined,
         nodes: collectCodeNodes(props),
       }),
     )
@@ -148,8 +148,8 @@ function resolveCodeNode(type: string, props: Record<string, unknown>, nodes: Co
     nodes.push(
       createType({
         name: props['name'] as string,
-        export: props['export'] as boolean | undefined,
-        JSDoc: props['JSDoc'] as JSDocNode | undefined,
+        export: props['export'] as boolean | null | undefined,
+        JSDoc: props['JSDoc'] as JSDocNode | null | undefined,
         nodes: collectCodeNodes(props),
       }),
     )
@@ -202,7 +202,7 @@ function collectFileChildren(element: unknown): FileChildren {
           createImport({
             name: props['name'] as ImportNode['name'],
             path: props['path'] as string,
-            root: props['root'] as string | undefined,
+            root: props['root'] as string | null | undefined,
             isTypeOnly: toBool(props['isTypeOnly']),
             isNameSpace: toBool(props['isNameSpace']),
           }),

package/src/components/Const.tsx

@@ -15,26 +15,26 @@ type ConstProps = {
    * - `false` generates `const name = …`
    * @default false
    */
-  export?: boolean
+  export?: boolean | null
   /**
    * TypeScript type annotation for the constant, written verbatim after `const name:`.
    *
    * @example
    * `type: 'Pet'` → `const pet: Pet = …`
    */
-  type?: string
+  type?: string | null
   /**
    * JSDoc block to prepend to the constant declaration.
    * Each entry in `comments` becomes one line inside the emitted `/** … *\/` block.
    */
-  JSDoc?: JSDoc
+  JSDoc?: JSDoc | null
   /**
    * Append `as const` after the initialiser, enabling TypeScript const assertions.
    * - `true` generates `const name = … as const`
    * - `false` generates `const name = …`
    * @default false
    */
-  asConst?: boolean
+  asConst?: boolean | null
   /**
    * Child nodes rendered as the initialiser expression of the constant.
    */

package/src/components/File.tsx

@@ -27,7 +27,7 @@ type BasePropsWithoutBaseName = {
    * Fully qualified path to the generated file.
    * Optional when `baseName` is omitted — the component renders its children inline.
    */
-  path?: string
+  path?: string | null
 }
 
 type BaseProps = BasePropsWithBaseName | BasePropsWithoutBaseName
@@ -38,7 +38,7 @@ type Props<TMeta> = BaseProps & {
    * Arbitrary metadata attached to the file node.
    * Used by plugins for barrel generation and custom post-processing.
    */
-  meta?: TMeta
+  meta?: TMeta | null
   /**
    * Text prepended to the generated file content before any source blocks.
    * Accepts `null` so `resolver.resolveBanner()` results can be passed directly.

package/src/components/Function.tsx

@@ -14,28 +14,28 @@ type Props = {
    * Requires `export` to also be `true`.
    * @default false
    */
-  default?: boolean
+  default?: boolean | null
   /**
    * Parameter list written verbatim between the function's parentheses.
    *
    * @example
    * `params: 'petId: string, options?: RequestOptions'`
    */
-  params?: string
+  params?: string | null
   /**
    * Emit the `export` keyword before the function declaration.
    * - `true` generates `export function name(…) { … }`
    * - `false` generates `function name(…) { … }`
    * @default false
    */
-  export?: boolean
+  export?: boolean | null
   /**
    * Emit the `async` keyword, making this an async function.
    * The return type is automatically wrapped in `Promise<returnType>` when both
    * `async` and `returnType` are set.
    * @default false
    */
-  async?: boolean
+  async?: boolean | null
   /**
    * TypeScript generic type parameters written verbatim between `<` and `>`.
    * Pass an array to emit multiple parameters separated by commas.
@@ -46,7 +46,7 @@ type Props = {
    * @example Multiple generics
    * `generics: ['TData', 'TError = unknown']`
    */
-  generics?: string | string[]
+  generics?: string | string[] | null
   /**
    * TypeScript return type annotation written verbatim after `:`.
    * When `async` is `true`, the value is automatically wrapped in `Promise<…>`.
@@ -54,12 +54,12 @@ type Props = {
    * @example
    * `returnType: 'Pet'`
    */
-  returnType?: string
+  returnType?: string | null
   /**
    * JSDoc block to prepend to the function declaration.
    * Each entry in `comments` becomes one line inside the emitted `/** … *\/` block.
    */
-  JSDoc?: JSDoc
+  JSDoc?: JSDoc | null
   /**
    * Child nodes rendered as the body of the function.
    */
@@ -110,7 +110,7 @@ type ArrowFunctionProps = Props & {
    * - `false` generates `const name = (…) => { … }`
    * @default false
    */
-  singleLine?: boolean
+  singleLine?: boolean | null
 }
 
 /**

package/src/components/Type.tsx

@@ -16,12 +16,12 @@ type TypeProps = {
    * - `false` generates `type Name = …`
    * @default false
    */
-  export?: boolean
+  export?: boolean | null
   /**
    * JSDoc block to prepend to the type alias declaration.
    * Each entry in `comments` becomes one line inside the emitted `/** … *\/` block.
    */
-  JSDoc?: JSDoc
+  JSDoc?: JSDoc | null
   /**
    * Child nodes rendered as the type expression on the right-hand side of the alias.
    */

package/src/createRenderer.tsx

@@ -4,19 +4,29 @@ import { SyncRuntime } from './SyncRuntime.tsx'
 import type { KubbReactElement } from './types.ts'
 
 /**
- * Renderer factory for generators that produce JSX output.
+ * Renderer factory that turns the JSX produced by a generator into
+ * `FileNode`s using React's reconciler under the hood. Pass as the `renderer`
+ * property on `defineGenerator`. Kubb core stays generic, with no hard
+ * dependency on `@kubb/renderer-jsx`.
  *
- * Pass as the `renderer` property of `defineGenerator`. Core drives rendering
- * without a hard dependency on `@kubb/renderer-jsx`.
+ * Use this when generators rely on React features (hooks, suspense, context).
+ * For pure-function components, see {@link jsxRendererSync} for ~2-4× faster
+ * rendering.
  *
- * @example
- * ```ts
+ * @example Wire up a JSX generator
+ * ```tsx
+ * import { defineGenerator } from '@kubb/core'
  * import { jsxRenderer } from '@kubb/renderer-jsx'
  *
  * export const myGenerator = defineGenerator<PluginTs>({
+ *   name: 'types',
  *   renderer: jsxRenderer,
- *   schema(node, options) {
- *     return <File baseName="output.ts" path="src/output.ts">...</File>
+ *   schema(node, ctx) {
+ *     return (
+ *       <File baseName="output.ts" path={`${ctx.root}/output.ts`}>
+ *         <Type node={node} resolver={ctx.resolver} />
+ *       </File>
+ *     )
  *   },
  * })
  * ```
@@ -43,28 +53,40 @@ export const jsxRenderer = () => {
 }
 
 /**
- * Lightweight renderer factory with no React fiber, scheduler, or work loop.
+ * Lightweight renderer that walks the JSX tree in a single recursive pass —
+ * no React reconciler, no scheduler. Drop-in replacement for
+ * {@link jsxRenderer} at roughly 2–4× the throughput.
  *
- * Walks the JSX element tree in a single recursive pass. All components must be
- * pure functions; hooks and class components are not supported. Drop-in
- * replacement for {@link jsxRenderer} at approximately 2–4× the speed.
+ * Constraints: every component must be a pure function. Hooks, suspense, and
+ * class components are not supported.
  *
- * @example Drop-in replacement
- * ```ts
+ * Use this for generators that produce large amounts of output and do not need
+ * React's runtime features. It also exposes `stream()` for incremental file
+ * emission.
+ *
+ * @example Drop-in faster renderer
+ * ```tsx
+ * import { defineGenerator } from '@kubb/core'
  * import { jsxRendererSync } from '@kubb/renderer-jsx'
  *
  * export const myGenerator = defineGenerator<PluginTs>({
+ *   name: 'types',
  *   renderer: jsxRendererSync,
- *   schema(node, options) {
- *     return <File baseName="output.ts" path="src/output.ts">...</File>
+ *   schema(node, ctx) {
+ *     return (
+ *       <File baseName="output.ts" path={`${ctx.root}/output.ts`}>
+ *         <Type node={node} resolver={ctx.resolver} />
+ *       </File>
+ *     )
  *   },
  * })
  * ```
  *
  * @example Stream files as they are produced
- * ```ts
- * for await (const file of jsxRendererSync().stream(element)) {
- *   await writeFile(file)
+ * ```tsx
+ * const renderer = jsxRendererSync()
+ * for (const file of renderer.stream(element)) {
+ *   await writeFile(file.path, file.sources[0])
  * }
  * ```
  */

package/src/types.ts

@@ -36,8 +36,9 @@ type Node = {
 
 /**
  * Allowed attribute value types for DOM elements.
+ * `null` signals intentionally empty — the prop was explicitly cleared.
  */
-export type DOMNodeAttribute = boolean | string | number | Record<string, unknown> | Array<unknown>
+export type DOMNodeAttribute = boolean | string | number | null | Record<string, unknown> | Array<unknown>
 
 type TextName = '#text'
 
@@ -119,12 +120,12 @@ export type KubbTextProps = {
  * Represents a generated file.
  */
 export type KubbFileProps = {
-  id?: string
+  id?: string | null
   children?: KubbReactNode
   baseName: string
   path: string
-  override?: boolean
-  meta?: FileNode['meta']
+  override?: boolean | null
+  meta?: FileNode['meta'] | null
 }
 
 /**

package/src/utils.ts

@@ -59,13 +59,13 @@ function collectCodeNodes(element: DOMElement): CodeNode[] {
       result.push(
         createFunction({
           name: attrs['name'] as string,
-          params: attrs['params'] as string | undefined,
-          export: attrs['export'] as boolean | undefined,
-          default: attrs['default'] as boolean | undefined,
-          async: attrs['async'] as boolean | undefined,
-          generics: attrs['generics'] as string | undefined,
-          returnType: attrs['returnType'] as string | undefined,
-          JSDoc: attrs['JSDoc'] as JSDocNode | undefined,
+          params: attrs['params'] as string | null | undefined,
+          export: attrs['export'] as boolean | null | undefined,
+          default: attrs['default'] as boolean | null | undefined,
+          async: attrs['async'] as boolean | null | undefined,
+          generics: attrs['generics'] as string | string[] | null | undefined,
+          returnType: attrs['returnType'] as string | null | undefined,
+          JSDoc: attrs['JSDoc'] as JSDocNode | null | undefined,
           nodes: collectCodeNodes(child),
         }),
       )
@@ -77,14 +77,14 @@ function collectCodeNodes(element: DOMElement): CodeNode[] {
       result.push(
         createArrowFunction({
           name: attrs['name'] as string,
-          params: attrs['params'] as string | undefined,
-          export: attrs['export'] as boolean | undefined,
-          default: attrs['default'] as boolean | undefined,
-          async: attrs['async'] as boolean | undefined,
-          generics: attrs['generics'] as string | undefined,
-          returnType: attrs['returnType'] as string | undefined,
-          singleLine: attrs['singleLine'] as boolean | undefined,
-          JSDoc: attrs['JSDoc'] as JSDocNode | undefined,
+          params: attrs['params'] as string | null | undefined,
+          export: attrs['export'] as boolean | null | undefined,
+          default: attrs['default'] as boolean | null | undefined,
+          async: attrs['async'] as boolean | null | undefined,
+          generics: attrs['generics'] as string | string[] | null | undefined,
+          returnType: attrs['returnType'] as string | null | undefined,
+          singleLine: attrs['singleLine'] as boolean | null | undefined,
+          JSDoc: attrs['JSDoc'] as JSDocNode | null | undefined,
           nodes: collectCodeNodes(child),
         } as Omit<ArrowFunctionNode, 'kind'>),
       )
@@ -96,10 +96,10 @@ function collectCodeNodes(element: DOMElement): CodeNode[] {
       result.push(
         createConst({
           name: attrs['name'] as string,
-          type: attrs['type'] as string | undefined,
-          export: attrs['export'] as boolean | undefined,
-          asConst: attrs['asConst'] as boolean | undefined,
-          JSDoc: attrs['JSDoc'] as JSDocNode | undefined,
+          type: attrs['type'] as string | null | undefined,
+          export: attrs['export'] as boolean | null | undefined,
+          asConst: attrs['asConst'] as boolean | null | undefined,
+          JSDoc: attrs['JSDoc'] as JSDocNode | null | undefined,
           nodes: collectCodeNodes(child),
         }),
       )
@@ -111,8 +111,8 @@ function collectCodeNodes(element: DOMElement): CodeNode[] {
       result.push(
         createType({
           name: attrs['name'] as string,
-          export: attrs['export'] as boolean | undefined,
-          JSDoc: attrs['JSDoc'] as JSDocNode | undefined,
+          export: attrs['export'] as boolean | null | undefined,
+          JSDoc: attrs['JSDoc'] as JSDocNode | null | undefined,
           nodes: collectCodeNodes(child),
         }),
       )
@@ -168,7 +168,7 @@ function* collectFileEntries(node: DOMElement): Generator<SourceNode | ExportNod
       yield createImport({
         name: child.attributes['name'] as ImportNode['name'],
         path: child.attributes['path'] as string,
-        root: child.attributes['root'] as string | undefined,
+        root: child.attributes['root'] as string | null | undefined,
         isTypeOnly: toBool(child.attributes['isTypeOnly']),
         isNameSpace: toBool(child.attributes['isNameSpace']),
       })