@kubb/renderer-jsx 5.5.6 → 5.6.0

package/dist/index.js

@@ -1,5 +1,5 @@
 import "./rolldown-runtime-C0LytTxp.js";
-import { Fragment, jsx } from "./jsx-runtime.js";
+import { Fragment, isKubbElement, jsx } from "./jsx-runtime.js";
 import { stringify } from "yaml";
 import { ast } from "@kubb/kit";
 //#region src/components/md/Callout.tsx
@@ -36,7 +36,6 @@ function Callout({ type, title, children }) {
 		children: `${header}\n${quoted}`
 	});
 }
-Callout.displayName = "Callout";
 //#endregion
 //#region src/components/js/Const.tsx
 /**
@@ -57,8 +56,7 @@ Callout.displayName = "Callout";
 * </Const>
 * ```
 */
-function Const({ children, ...props }) {
-	const { name, export: canExport, type, JSDoc, asConst } = props;
+function Const({ children, name, export: canExport, type, JSDoc, asConst }) {
 	return /* @__PURE__ */ jsx("kubb-const", {
 		name,
 		type,
@@ -68,7 +66,6 @@ function Const({ children, ...props }) {
 		children
 	});
 }
-Const.displayName = "Const";
 //#endregion
 //#region src/components/File.tsx
 /**
@@ -88,14 +85,12 @@ Const.displayName = "Const";
 * ```
 */
 function File({ children, ...props }) {
-	const { baseName, path } = props;
-	if (!baseName || !path) return /* @__PURE__ */ jsx(Fragment, { children });
+	if (!props.baseName || !props.path) return /* @__PURE__ */ jsx(Fragment, { children });
 	return /* @__PURE__ */ jsx("kubb-file", {
 		...props,
 		children
 	});
 }
-File.displayName = "File";
 /**
 * Marks a block of source text to be associated with the enclosing {@link File}.
 *
@@ -117,16 +112,11 @@ File.displayName = "File";
 * ```
 */
 function FileSource({ children, ...props }) {
-	const { name, isExportable, isIndexable, isTypeOnly } = props;
 	return /* @__PURE__ */ jsx("kubb-source", {
-		name,
-		isTypeOnly,
-		isExportable,
-		isIndexable,
+		...props,
 		children
 	});
 }
-FileSource.displayName = "FileSource";
 /**
 * Declares an export entry for the enclosing {@link File}.
 *
@@ -145,15 +135,8 @@ FileSource.displayName = "FileSource";
 * ```
 */
 function FileExport(props) {
-	const { name, path, isTypeOnly, asAlias } = props;
-	return /* @__PURE__ */ jsx("kubb-export", {
-		name,
-		path,
-		isTypeOnly,
-		asAlias
-	});
+	return /* @__PURE__ */ jsx("kubb-export", { ...props });
 }
-FileExport.displayName = "FileExport";
 /**
 * Declares an import entry for the enclosing {@link File}.
 *
@@ -178,16 +161,8 @@ FileExport.displayName = "FileExport";
 * ```
 */
 function FileImport(props) {
-	const { name, root, path, isTypeOnly, isNameSpace } = props;
-	return /* @__PURE__ */ jsx("kubb-import", {
-		name,
-		root,
-		path,
-		isNameSpace,
-		isTypeOnly
-	});
+	return /* @__PURE__ */ jsx("kubb-import", { ...props });
 }
-FileImport.displayName = "FileImport";
 File.Export = FileExport;
 File.Import = FileImport;
 File.Source = FileSource;
@@ -217,7 +192,6 @@ function Frontmatter({ data }) {
 		children: envelope
 	});
 }
-Frontmatter.displayName = "Frontmatter";
 //#endregion
 //#region src/components/js/Function.tsx
 /**
@@ -233,8 +207,7 @@ Frontmatter.displayName = "Frontmatter";
 * // }
 * ```
 */
-function Function({ children, ...props }) {
-	const { name, default: isDefault, export: canExport, async: isAsync, generics, params, returnType, JSDoc } = props;
+function Function({ children, name, default: isDefault, export: canExport, async: isAsync, generics, params, returnType, JSDoc }) {
 	const genericsString = Array.isArray(generics) ? generics.join(", ").trim() : generics;
 	return /* @__PURE__ */ jsx("kubb-function", {
 		name,
@@ -248,7 +221,6 @@ function Function({ children, ...props }) {
 		children
 	});
 }
-Function.displayName = "Function";
 /**
 * Generates an arrow function expression assigned to a `const`.
 * Supports the same flags as {@link Function}.
@@ -262,8 +234,7 @@ Function.displayName = "Function";
 * // export const double = (n: number): number => n * 2
 * ```
 */
-function ArrowFunction({ children, ...props }) {
-	const { name, default: isDefault, export: canExport, async, generics, params, returnType, JSDoc, singleLine } = props;
+function ArrowFunction({ children, name, default: isDefault, export: canExport, async, generics, params, returnType, JSDoc, singleLine }) {
 	const genericsString = Array.isArray(generics) ? generics.join(", ").trim() : generics;
 	return /* @__PURE__ */ jsx("kubb-arrow-function", {
 		name,
@@ -278,7 +249,6 @@ function ArrowFunction({ children, ...props }) {
 		children
 	});
 }
-ArrowFunction.displayName = "ArrowFunction";
 Function.Arrow = ArrowFunction;
 //#endregion
 //#region src/components/md/Heading.tsx
@@ -300,7 +270,6 @@ function Heading({ level, children }) {
 		children: `${"#".repeat(level)} ${children}`
 	});
 }
-Heading.displayName = "Heading";
 //#endregion
 //#region src/components/jsx/Jsx.tsx
 /**
@@ -321,7 +290,6 @@ Heading.displayName = "Heading";
 function Jsx({ children }) {
 	return /* @__PURE__ */ jsx("kubb-jsx", { children });
 }
-Jsx.displayName = "Jsx";
 //#endregion
 //#region src/components/md/List.tsx
 /**
@@ -348,7 +316,6 @@ function List({ ordered, items }) {
 		children: body
 	});
 }
-List.displayName = "List";
 //#endregion
 //#region src/components/md/Paragraph.tsx
 /**
@@ -369,7 +336,6 @@ function Paragraph({ children }) {
 		children
 	});
 }
-Paragraph.displayName = "Paragraph";
 //#endregion
 //#region src/components/js/Type.tsx
 /**
@@ -393,8 +359,7 @@ Paragraph.displayName = "Paragraph";
 * </Type>
 * ```
 */
-function Type({ children, ...props }) {
-	const { name, export: canExport, JSDoc } = props;
+function Type({ children, name, export: canExport, JSDoc }) {
 	if (name.charAt(0).toUpperCase() !== name.charAt(0)) throw new Error("Name should start with a capital letter(see TypeScript types)");
 	return /* @__PURE__ */ jsx("kubb-type", {
 		name,
@@ -403,15 +368,9 @@ function Type({ children, ...props }) {
 		children
 	});
 }
-Type.displayName = "Type";
 //#endregion
-//#region src/Runtime.tsx
-/**
-* Walks `element`, resolving arrays, Fragments, and function components, then
-* calls `onText` for primitive values and `onHost` for each host element.
-* Function components are called synchronously. Hooks and class components are
-* not supported.
-*/
+//#region src/jsxRenderer.ts
+/** Walks `element` through arrays, Fragments and function components, calling `onText` and `onHost`. */
 function walkElement(element, onText, onHost) {
 	if (element == null || typeof element === "boolean") return;
 	if (typeof element === "string" || typeof element === "number" || typeof element === "bigint") {
@@ -422,10 +381,9 @@ function walkElement(element, onText, onHost) {
 		for (const child of element) walkElement(child, onText, onHost);
 		return;
 	}
-	if (typeof element === "object" && "$$typeof" in element) {
-		const el = element;
-		const { type } = el;
-		const props = el.props;
+	if (isKubbElement(element)) {
+		const { type } = element;
+		const props = element.props;
 		if (type === Fragment) {
 			walkElement(props["children"], onText, onHost);
 			return;
@@ -434,81 +392,52 @@ function walkElement(element, onText, onHost) {
 			walkElement(type(props), onText, onHost);
 			return;
 		}
-		if (typeof type === "string") onHost(type, props);
+		if (typeof type === "string") onHost({
+			type,
+			props
+		});
 	}
 }
-function collectCodeNodes(props) {
-	const nodes = [];
-	collectCode(props["children"], nodes);
-	return nodes;
+/** Returns the `children` prop of a host element, or `undefined` for tags without one. */
+function childrenOf(host) {
+	return "children" in host.props ? host.props.children : void 0;
+}
+const codeFactories = {
+	"kubb-function": ast.factory.createFunction,
+	"kubb-arrow-function": ast.factory.createArrowFunction,
+	"kubb-const": ast.factory.createConst,
+	"kubb-type": ast.factory.createType
+};
+function isCodeHost(host) {
+	return host.type in codeFactories;
 }
-function collectCode(element, nodes) {
+function createCodeNode(type, props) {
+	const { children, ...rest } = props;
+	return codeFactories[type]({
+		...rest,
+		nodes: collectCodeNodes(children)
+	});
+}
+function collectCodeNodes(element) {
+	const nodes = [];
 	walkElement(element, (text) => {
 		if (text.trim()) nodes.push(ast.factory.createText(text));
-	}, (type, props) => resolveCodeNode(type, props, nodes));
-}
-function resolveCodeNode(type, props, nodes) {
-	if (type === "br") {
-		nodes.push(ast.factory.createBreak());
-		return;
-	}
-	if (type === "kubb-jsx") {
-		let value = "";
-		walkElement(props["children"], (t) => {
-			value += t;
-		}, () => {});
-		if (value) nodes.push(ast.factory.createJsx(value));
-		return;
-	}
-	if (type === "kubb-function") {
-		nodes.push(ast.factory.createFunction({
-			name: props["name"],
-			params: props["params"],
-			export: props["export"],
-			default: props["default"],
-			async: props["async"],
-			generics: props["generics"],
-			returnType: props["returnType"],
-			JSDoc: props["JSDoc"],
-			nodes: collectCodeNodes(props)
-		}));
-		return;
-	}
-	if (type === "kubb-arrow-function") {
-		nodes.push(ast.factory.createArrowFunction({
-			name: props["name"],
-			params: props["params"],
-			export: props["export"],
-			default: props["default"],
-			async: props["async"],
-			generics: props["generics"],
-			returnType: props["returnType"],
-			singleLine: props["singleLine"],
-			JSDoc: props["JSDoc"],
-			nodes: collectCodeNodes(props)
-		}));
-		return;
-	}
-	if (type === "kubb-const") {
-		nodes.push(ast.factory.createConst({
-			name: props["name"],
-			type: props["type"],
-			export: props["export"],
-			asConst: props["asConst"],
-			JSDoc: props["JSDoc"],
-			nodes: collectCodeNodes(props)
-		}));
-		return;
-	}
-	if (type === "kubb-type") {
-		nodes.push(ast.factory.createType({
-			name: props["name"],
-			export: props["export"],
-			JSDoc: props["JSDoc"],
-			nodes: collectCodeNodes(props)
-		}));
-		return;
-	}
+	}, (host) => {
+		if (host.type === "br") {
+			nodes.push(ast.factory.createBreak());
+			return;
+		}
+		if (host.type === "kubb-jsx") {
+			let value = "";
+			walkElement(host.props.children, (t) => {
+				value += t;
+			}, () => {});
+			if (value) nodes.push(ast.factory.createJsx(value));
+			return;
+		}
+		if (isCodeHost(host)) nodes.push(createCodeNode(host.type, host.props));
+	});
+	return nodes;
 }
 function collectFileChildren(element) {
 	const sources = [];
@@ -516,37 +445,40 @@ function collectFileChildren(element) {
 	const imports = [];
 	walkElement(element, (text) => {
 		if (text.trim()) throw new Error(`[jsx] '${text}' should be part of <File.Source> component when using the <File/> component`);
-	}, (type, props) => {
-		if (type === "kubb-source") {
+	}, (host) => {
+		if (host.type === "kubb-source") {
+			const { name, isTypeOnly, isExportable, isIndexable, children } = host.props;
 			sources.push(ast.factory.createSource({
-				name: props["name"]?.toString(),
-				isTypeOnly: !!props["isTypeOnly"],
-				isExportable: !!props["isExportable"],
-				isIndexable: !!props["isIndexable"],
-				nodes: collectCodeNodes(props)
+				name: name?.toString(),
+				isTypeOnly: !!isTypeOnly,
+				isExportable: !!isExportable,
+				isIndexable: !!isIndexable,
+				nodes: collectCodeNodes(children)
 			}));
 			return;
 		}
-		if (type === "kubb-export") {
+		if (host.type === "kubb-export") {
+			const { name, path, isTypeOnly, asAlias } = host.props;
 			exports.push(ast.factory.createExport({
-				name: props["name"],
-				path: props["path"],
-				isTypeOnly: !!props["isTypeOnly"],
-				asAlias: !!props["asAlias"]
+				name,
+				path,
+				isTypeOnly: !!isTypeOnly,
+				asAlias: !!asAlias
 			}));
 			return;
 		}
-		if (type === "kubb-import") {
+		if (host.type === "kubb-import") {
+			const { name, path, root, isTypeOnly, isNameSpace } = host.props;
 			imports.push(ast.factory.createImport({
-				name: props["name"],
-				path: props["path"],
-				root: props["root"],
-				isTypeOnly: !!props["isTypeOnly"],
-				isNameSpace: !!props["isNameSpace"]
+				name,
+				path,
+				root,
+				isTypeOnly: !!isTypeOnly,
+				isNameSpace: !!isNameSpace
 			}));
 			return;
 		}
-		const nested = collectFileChildren(props["children"]);
+		const nested = collectFileChildren(childrenOf(host));
 		sources.push(...nested.sources);
 		exports.push(...nested.exports);
 		imports.push(...nested.imports);
@@ -557,75 +489,26 @@ function collectFileChildren(element) {
 		imports
 	};
 }
-function* walkFiles(element) {
-	if (element == null || typeof element === "boolean") return;
-	if (typeof element === "string" || typeof element === "number" || typeof element === "bigint") return;
-	if (Array.isArray(element)) {
-		for (const child of element) yield* walkFiles(child);
-		return;
-	}
-	if (typeof element === "object" && "$$typeof" in element) {
-		const el = element;
-		const { type } = el;
-		const props = el.props;
-		if (type === Fragment) {
-			yield* walkFiles(props["children"]);
-			return;
-		}
-		if (typeof type === "function") {
-			yield* walkFiles(type(props));
-			return;
-		}
-		if (typeof type === "string") {
-			if (type === "kubb-file" && props["baseName"] !== void 0 && props["path"] !== void 0) {
-				const { sources, exports, imports } = collectFileChildren(props["children"]);
-				yield {
-					baseName: props["baseName"],
-					path: props["path"],
-					meta: props["meta"] || {},
-					footer: props["footer"],
-					banner: props["banner"],
-					copy: props["copy"],
-					sources,
-					exports,
-					imports
-				};
-			} else yield* walkFiles(props["children"]);
-		}
-	}
+function createFileNode(props) {
+	const { sources, exports, imports } = collectFileChildren(props.children);
+	return {
+		baseName: props.baseName,
+		path: props.path,
+		meta: props.meta || {},
+		footer: props.footer,
+		banner: props.banner,
+		copy: props.copy,
+		sources,
+		exports,
+		imports
+	};
 }
 /**
-* Synchronous JSX renderer that walks the element tree in a single pass,
-* producing {@link ast.FileNode} objects directly without an intermediate virtual
-* DOM. No React fiber, scheduler, or work loop is involved.
-*
-* All components must be pure functions. Hooks and class components are not
-* supported.
-*/
-var Runtime = class {
-	/**
-	* Accumulated {@link ast.FileNode} results from every {@link render} call.
-	*/
-	nodes = [];
-	/**
-	* Walks `element` synchronously, converts every `<kubb-file>` subtree into
-	* a {@link ast.FileNode} with no intermediate virtual DOM, and appends the results
-	* to {@link nodes}.
-	*/
-	render(element) {
-		for (const file of walkFiles(element)) this.nodes.push(file);
-	}
-};
-//#endregion
-//#region src/jsxRenderer.tsx
-/**
 * Factory for a renderer that walks the JSX tree in a single recursive pass,
 * with no React reconciler or scheduler. Pass it as the `renderer` property on
 * `defineGenerator`. Kubb core calls the factory once per render cycle and stays
-* generic, with no hard dependency on `@kubb/renderer-jsx`.
-*
-* Every component must be a pure function. Hooks, suspense, and class
-* components are not supported.
+* generic, with no hard dependency on `@kubb/renderer-jsx`. Every component must be a pure
+* function. Hooks, suspense and class components are not supported.
 *
 * @example Wire up a JSX generator
 * ```tsx
@@ -646,13 +529,22 @@ var Runtime = class {
 * ```
 */
 const jsxRenderer = () => {
-	const runtime = new Runtime();
+	const files = [];
+	function collectFiles(element) {
+		walkElement(element, () => {}, (host) => {
+			if (host.type === "kubb-file") {
+				files.push(createFileNode(host.props));
+				return;
+			}
+			collectFiles(childrenOf(host));
+		});
+	}
 	return {
 		async render(element) {
-			runtime.render(element);
+			collectFiles(element);
 		},
 		get files() {
-			return runtime.nodes;
+			return files;
 		},
 		[Symbol.dispose]() {}
 	};

package/dist/jsx-runtime.cjs

@@ -21,11 +21,18 @@ function createElement(type, props, key) {
 		props: props ?? {}
 	};
 }
+/**
+* Returns `true` when `value` is an element this runtime created.
+*/
+function isKubbElement(value) {
+	return typeof value === "object" && value !== null && value.$$typeof === KUBB_ELEMENT;
+}
 const jsx = createElement;
 const jsxs = createElement;
 const jsxDEV = createElement;
 //#endregion
 exports.Fragment = Fragment;
+exports.isKubbElement = isKubbElement;
 exports.jsx = jsx;
 exports.jsxDEV = jsxDEV;
 exports.jsxs = jsxs;

package/dist/jsx-runtime.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { i as KubbReactNode, n as Key, r as KubbReactElement } from "./types-seYG0czS.js";
+import { i as KubbReactNode, n as Key, r as KubbReactElement } from "./types-BbP7RtaT.js";
 import { ast } from "@kubb/kit";
 //#region src/jsx-namespace.d.ts
 /**
@@ -10,23 +10,14 @@ import { ast } from "@kubb/kit";
  * the HTML element and class-component machinery from `@types/react` is not needed.
  */
 declare namespace JSX {
-  type ElementType = string | ((props: any) => KubbReactNode);
+  type ElementType = string | ((props: never) => KubbReactNode);
   type Element = KubbReactElement;
-  interface ElementClass {
-    render(): KubbReactNode;
-  }
-  interface ElementAttributesProperty {
-    props: {};
-  }
   interface ElementChildrenAttribute {
     children: {};
   }
   interface IntrinsicAttributes {
     key?: Key | null;
   }
-  interface IntrinsicClassAttributes<T> {
-    key?: Key | null;
-  }
   interface IntrinsicElements {
     ['kubb-jsx']: {
       children?: string;
@@ -34,8 +25,10 @@ declare namespace JSX {
     ['kubb-file']: {
       id?: string | null;
       children?: KubbReactNode;
-      baseName: string;
+      baseName: ast.FileNode['baseName'];
       path: string;
+      banner?: string | null;
+      footer?: string | null;
       /**
        * Absolute on-disk path to copy into the output, through the parser's `copy` hook when it has
        * one. Use to emit a real source file shipped inside a package (a template) into the generated folder.
@@ -62,7 +55,6 @@ declare namespace JSX {
     };
     br: {};
   }
-  type LibraryManagedAttributes<C, P> = P;
 }
 //#endregion
 //#region src/jsx-runtime.d.ts
@@ -78,6 +70,10 @@ export declare const Fragment: unique symbol;
  * `props`.
  */
 declare function createElement(type: unknown, props: Record<string, unknown> | null, key?: Key | null): KubbReactElement;
+/**
+ * Returns `true` when `value` is an element this runtime created.
+ */
+export declare function isKubbElement(value: unknown): value is KubbReactElement;
 export declare const jsx: typeof createElement;
 export declare const jsxs: typeof createElement;
 export declare const jsxDEV: typeof createElement;

package/dist/jsx-runtime.js

@@ -20,10 +20,16 @@ function createElement(type, props, key) {
 		props: props ?? {}
 	};
 }
+/**
+* Returns `true` when `value` is an element this runtime created.
+*/
+function isKubbElement(value) {
+	return typeof value === "object" && value !== null && value.$$typeof === KUBB_ELEMENT;
+}
 const jsx = createElement;
 const jsxs = createElement;
 const jsxDEV = createElement;
 //#endregion
-export { Fragment, jsx, jsxDEV, jsxs };
+export { Fragment, isKubbElement, jsx, jsxDEV, jsxs };
 
 //# sourceMappingURL=jsx-runtime.js.map

package/dist/{types-seYG0czS.d.ts → types-BbP7RtaT.d.ts}

@@ -1,4 +1,5 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
+import { ast } from "@kubb/kit";
 //#region src/types.d.ts
 /**
  * Unique key for a Kubb JSX element in lists or conditional renders.
@@ -9,15 +10,19 @@ type Key = string | number | bigint;
  * so the fields stay opaque to type-checking.
  */
 type KubbReactElement = {
+  /**
+   * Brand set by the JSX runtime, so the renderer only walks elements it created.
+   */
+  $$typeof: symbol;
   type: unknown;
   props: unknown;
   key: Key | null;
 };
 /**
  * Anything a Kubb JSX component accepts as children: an element, a primitive
- * rendered as text, a nullish value that is skipped, or an iterable of nodes.
+ * rendered as text, a nullish value that is skipped, or an array of nodes.
  */
-type KubbReactNode = KubbReactElement | string | number | bigint | boolean | null | undefined | Iterable<KubbReactNode>;
+type KubbReactNode = KubbReactElement | string | number | bigint | boolean | null | undefined | ReadonlyArray<KubbReactNode>;
 /**
  * JSDoc comment block to attach to a generated declaration.
  * Each string in `comments` becomes one line inside the `/** … *\/` block.
@@ -25,20 +30,9 @@ type KubbReactNode = KubbReactElement | string | number | bigint | boolean | nul
  * @example
  * ```ts
  * { comments: ['@description A pet object.', '@deprecated Use PetV2 instead.'] }
- * // Emits:
- * // /**
- * //  * @description A pet object.
- * //  * @deprecated Use PetV2 instead.
- * //  *\/
  * ```
  */
-type JSDoc = {
-  /**
-   * Lines to emit inside the JSDoc block, in source order.
-   * Use standard JSDoc tags such as `@description`, `@deprecated`, `@see`, etc.
-   */
-  comments: Array<string>;
-};
+type JSDoc = ast.JSDocNode;
 //#endregion
 export { KubbReactNode as i, Key as n, KubbReactElement as r, JSDoc as t };
-//# sourceMappingURL=types-seYG0czS.d.ts.map
+//# sourceMappingURL=types-BbP7RtaT.d.ts.map

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-import { i as KubbReactNode, n as Key, r as KubbReactElement, t as JSDoc } from "./types-seYG0czS.js";
+import { i as KubbReactNode, n as Key, r as KubbReactElement, t as JSDoc } from "./types-BbP7RtaT.js";
 export { JSDoc, Key, KubbReactElement, KubbReactNode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/renderer-jsx",
-  "version": "5.5.6",
+  "version": "5.6.0",
   "description": "Self-contained synchronous JSX renderer for Kubb. Turns JSX into FileNodes with built-in components (File, Function, Type, Const). An alternative for the ast.factory syntax.",
   "keywords": [
     "codegen",
@@ -87,7 +87,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/kit": "5.5.6",
+    "@kubb/kit": "5.6.0",
     "yaml": "^2.9.1"
   },
   "engines": {