@kubb/renderer-jsx 5.0.0-beta.7 → 5.0.0-beta.71

package/dist/index.d.ts

@@ -1,51 +1,57 @@
-import { n as __name } from "./chunk-Bb7HlUDG.js";
-import { a as JSDoc, h as KubbReactNode, m as KubbReactElement, o as Key } from "./types-nAFMiWFw.js";
+import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
+import { d as KubbReactNode, n as Key, t as JSDoc, u as KubbReactElement } from "./types-OZ23urxc.js";
 import { ExportNode, FileNode, ImportNode, SourceNode } from "@kubb/ast";
-import * as _$react from "react";
 
-//#region ../../internals/utils/src/context.d.ts
-/**
- * Context type that carries type information about its value
- * This is a branded symbol type that enables type-safe context usage
- */
-type Context<T> = symbol & {
-  readonly __type: T;
+//#region src/components/Callout.d.ts
+declare const CALLOUT_LABEL: {
+  readonly tip: "TIP";
+  readonly note: "NOTE";
+  readonly important: "IMPORTANT";
+  readonly warning: "WARNING";
+  readonly caution: "CAUTION";
+};
+type CalloutType = keyof typeof CALLOUT_LABEL;
+type Props$7 = {
+  key?: Key;
+  /**
+   * Callout kind. Maps to the uppercase label inside the `> [!TYPE]` marker.
+   */
+  type: CalloutType;
+  /**
+   * Optional title rendered on the same line as the marker.
+   */
+  title?: string | null;
+  /**
+   * Body text. Each line is quoted with `> ` so multi-line content stays
+   * inside the callout block.
+   */
+  children: string;
 };
 /**
- * Provides a value to descendant components (Vue 3 style)
+ * Renders a GitHub-style alert callout using the `> [!TYPE]` blockquote syntax.
  *
- * @example
- * ```ts
- * const ThemeKey = Symbol('theme')
- * provide(ThemeKey, { color: 'blue' })
- * ```
- */
-declare function provide<T>(key: symbol | Context<T>, value: T): void;
-/**
- * Injects a value provided by an ancestor component (Vue 3 style)
+ * Emits a `<File.Source>` block containing `> [!TYPE] Title` followed by the
+ * body with every line prefixed by `> `.
  *
  * @example
- * ```ts
- * const theme = inject(ThemeKey, { color: 'default' })
- * ```
- */
-declare function inject<T>(key: symbol | Context<T>, defaultValue?: T): T;
-/**
- * Removes a provided value from the context stack (for cleanup)
- * @internal
- */
-declare function unprovide<T>(key: symbol | Context<T>): void;
-/**
- * Creates a context key with a default value (React-style compatibility)
+ * ```tsx
+ * <Callout type="tip">Run `kubb start --watch` to keep the generator hot.</Callout>
+ * // > [!TIP]
+ * // > Run `kubb start --watch` to keep the generator hot.
  *
- * @example
- * ```ts
- * const ThemeContext = createContext({ color: 'blue' })
- * // ThemeContext is now typed as Context<{ color: string }>
- * const theme = useContext(ThemeContext) // theme is { color: string }
+ * <Callout type="warning" title="Heads up">Breaking change in v6.</Callout>
+ * // > [!WARNING] Heads up
+ * // > Breaking change in v6.
  * ```
  */
-declare function createContext<T>(defaultValue: T): Context<T>;
+declare function Callout({
+  type,
+  title,
+  children
+}: Props$7): KubbReactElement;
+declare namespace Callout {
+  var displayName: string;
+}
 //#endregion
 //#region src/components/Const.d.ts
 type ConstProps = {
@@ -61,30 +67,28 @@ type ConstProps = {
    * Emit the `export` keyword before the `const` declaration.
    * - `true` generates `export const name = …`
    * - `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.
+   * Append `as const` after the initializer, 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.
+   * Child nodes rendered as the initializer expression of the constant.
    */
   children?: KubbReactNode;
 };
@@ -138,26 +142,34 @@ type BasePropsWithoutBaseName = {
   baseName?: never;
   /**
    * Fully qualified path to the generated file.
-   * Optional when `baseName` is omitted — the component renders its children inline.
+   * 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 & {
+type Props$6<TMeta> = BaseProps & {
   key?: Key;
   /**
-   * Arbitrary metadata attached to the file node.
-   * Used by plugins for barrel generation and custom post-processing.
+   * Arbitrary metadata attached to the file node for plugins to read.
    */
-  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.
    */
-  banner?: string;
+  banner?: string | null;
   /**
    * Text appended to the generated file content after all source blocks.
+   * Accepts `null` so `resolver.resolveFooter()` results can be passed directly.
+   */
+  footer?: string | null;
+  /**
+   * Absolute on-disk path to copy verbatim into the output, bypassing the parser. Use to emit a
+   * real source file shipped inside a package (a template) into the generated folder. Only
+   * `banner`/`footer` are applied around the copied content; child source blocks are ignored for
+   * output but still drive barrel generation.
    */
-  footer?: string;
+  copy?: string | null;
   /**
    * Child nodes rendered as the content of this file (source blocks, imports, exports).
    */
@@ -182,7 +194,7 @@ type Props$2<TMeta> = BaseProps & {
 declare function File<TMeta extends object = object>({
   children,
   ...props
-}: Props$2<TMeta>): KubbReactElement;
+}: Props$6<TMeta>): KubbReactElement;
 declare namespace File {
   var displayName: string;
   var Export: typeof FileExport;
@@ -199,8 +211,8 @@ type FileSourceProps = Omit<SourceNode, 'kind' | 'value'> & {
 /**
  * Marks a block of source text to be associated with the enclosing {@link File}.
  *
- * Children are treated as the source string. When `isExportable` is `true` the
- * `name` is used for deduplication and barrel generation.
+ * Children are treated as the source string. `isExportable` prepends the `export` keyword,
+ * `isIndexable` includes the source in barrel/index generation, and `name` keys deduplication.
  *
  * @example Exportable, indexable source block
  * ```tsx
@@ -278,8 +290,43 @@ declare namespace FileImport {
   var displayName: string;
 }
 //#endregion
+//#region src/components/Frontmatter.d.ts
+type Props$5 = {
+  key?: Key;
+  /**
+   * Plain object serialized as YAML between `---` fences.
+   *
+   * @example
+   * `{ title: 'Pets', layout: 'doc' }`
+   */
+  data: Record<string, unknown>;
+};
+/**
+ * Emits a YAML frontmatter envelope at the top of a generated markdown file.
+ *
+ * Renders a `<File.Source>` block containing `---\n<yaml>\n---`. Place it as
+ * the first child of `<File>` so it appears at the top of the output. Pair with
+ * `parserMd` to write `.md` files whose frontmatter downstream tooling can read.
+ *
+ * @example Page frontmatter at the top of a generated markdown file
+ * ```tsx
+ * <File baseName="pets.md" path="src/pets.md">
+ *   <Frontmatter data={{ title: 'Pets', layout: 'doc' }} />
+ *   <File.Source>
+ *     {'# Pets\n\nList of pets.'}
+ *   </File.Source>
+ * </File>
+ * ```
+ */
+declare function Frontmatter({
+  data
+}: Props$5): KubbReactElement;
+declare namespace Frontmatter {
+  var displayName: string;
+}
+//#endregion
 //#region src/components/Function.d.ts
-type Props$1 = {
+type Props$4 = {
   key?: Key;
   /**
    * Identifier of the generated function declaration.
@@ -291,30 +338,27 @@ type Props$1 = {
   /**
    * Emit `default` after the `export` keyword, making this the module's default export.
    * 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.
@@ -325,7 +369,7 @@ type Props$1 = {
    * @example Multiple generics
    * `generics: ['TData', 'TError = unknown']`
    */
-  generics?: string | string[];
+  generics?: string | Array<string> | null;
   /**
    * TypeScript return type annotation written verbatim after `:`.
    * When `async` is `true`, the value is automatically wrapped in `Promise<…>`.
@@ -333,12 +377,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.
    */
@@ -360,19 +404,18 @@ type Props$1 = {
 declare function Function({
   children,
   ...props
-}: Props$1): KubbReactElement;
+}: Props$4): KubbReactElement;
 declare namespace Function {
   var displayName: string;
   var Arrow: typeof ArrowFunction;
 }
-type ArrowFunctionProps = Props$1 & {
+type ArrowFunctionProps = Props$4 & {
   /**
    * Render the arrow function as a single-line expression (no braces around the body).
    * - `true` generates `const name = (…) => expression`
    * - `false` generates `const name = (…) => { … }`
-   * @default false
    */
-  singleLine?: boolean;
+  singleLine?: boolean | null;
 };
 /**
  * Generates an arrow function expression assigned to a `const`.
@@ -390,16 +433,51 @@ type ArrowFunctionProps = Props$1 & {
 declare function ArrowFunction({
   children,
   ...props
-}: ArrowFunctionProps): _$react.JSX.Element;
+}: ArrowFunctionProps): any;
 declare namespace ArrowFunction {
   var displayName: string;
 }
 //#endregion
+//#region src/components/Heading.d.ts
+type Level = 1 | 2 | 3 | 4 | 5 | 6;
+type Props$3 = {
+  key?: Key;
+  /**
+   * Heading depth, `1` through `6`. Matches the number of `#` characters
+   * prefixed to the heading text.
+   */
+  level: Level;
+  /**
+   * Heading text. Inline markdown (links, emphasis) is passed through verbatim.
+   */
+  children: string;
+};
+/**
+ * Renders an ATX-style markdown heading.
+ *
+ * Emits a `<File.Source>` block containing `${'#'.repeat(level)} ${children}`.
+ * Use inside a `<File>` rendered by `parserMd`.
+ *
+ * @example
+ * ```tsx
+ * <Heading level={2}>Installation</Heading>
+ * // ## Installation
+ * ```
+ */
+declare function Heading({
+  level,
+  children
+}: Props$3): KubbReactElement;
+declare namespace Heading {
+  var displayName: string;
+}
+//#endregion
 //#region src/components/Jsx.d.ts
-type Props = {
+type Props$2 = {
   /**
-   * Raw JSX string to embed verbatim in the generated code.
-   * Supports JSX fragments (`<>…</>`), elements, and any valid JSX syntax.
+   * Raw JSX string embedded verbatim in the generated code, including
+   * fragments (`<>…</>`).
+   *
    * @example
    * ```tsx
    * <Jsx>{'<>\n  <a href={href}>Open</a>\n</>'}</Jsx>
@@ -410,10 +488,10 @@ type Props = {
 /**
  * Embeds a raw JSX string verbatim in the generated source code.
  *
- * Use this component when you need to include JSX markup (including fragments
- * `<>…</>`) in the body of a generated function or component. The `children`
- * prop must be a plain string — expression attributes that reference runtime
- * values should be written as template literals.
+ * Use this component to include JSX markup (including fragments `<>…</>`) in the
+ * body of a generated function or component. The `children` prop must be a plain
+ * string. Write expression attributes that reference runtime values as template
+ * literals.
  *
  * @example
  * ```tsx
@@ -424,40 +502,76 @@ type Props = {
  */
 declare function Jsx({
   children
-}: Props): KubbReactElement;
+}: Props$2): KubbReactElement;
 declare namespace Jsx {
   var displayName: string;
 }
 //#endregion
-//#region src/components/Root.d.ts
-type RootProps = {
+//#region src/components/List.d.ts
+type Props$1 = {
+  key?: Key;
   /**
-   * Callback invoked to unmount the entire renderer tree.
-   * Called with an `Error` when the exit is caused by a render error,
-   * or with `undefined` for a clean shutdown.
+   * When `true`, emits a numbered list (`1. …`). When `false` or omitted,
+   * emits a bullet list (`- …`).
+   *
+   * @default false
    */
-  onExit: (error?: Error) => void;
+  ordered?: boolean | null;
   /**
-   * Callback invoked whenever a render error is caught by the error boundary.
-   * Use this to propagate errors up to the caller of {@link createRenderer}.
+   * One entry per line. Inline markdown is passed through verbatim.
    */
-  onError: (error: Error) => void;
+  items: ReadonlyArray<string>;
+};
+/**
+ * Renders a markdown list.
+ *
+ * Emits a `<File.Source>` block containing one entry per line, prefixed with
+ * `1.` / `2.` … when `ordered`, or `-` otherwise.
+ *
+ * @example
+ * ```tsx
+ * <List items={['Add the parser', 'Render the page']} />
+ * // - Add the parser
+ * // - Render the page
+ *
+ * <List ordered items={['First', 'Second']} />
+ * // 1. First
+ * // 2. Second
+ * ```
+ */
+declare function List({
+  ordered,
+  items
+}: Props$1): KubbReactElement;
+declare namespace List {
+  var displayName: string;
+}
+//#endregion
+//#region src/components/Paragraph.d.ts
+type Props = {
+  key?: Key;
   /**
-   * Child nodes rendered inside the error boundary.
+   * Paragraph text. Inline markdown (links, emphasis, code spans) is passed
+   * through verbatim.
    */
-  children?: KubbReactNode;
+  children: string;
 };
 /**
- * Root component for the Kubb renderer tree.
+ * Renders a markdown paragraph.
  *
- * Wraps all children in an `ErrorBoundary` so that render errors are caught
- * and forwarded to `onError` rather than crashing the process.
+ * Emits a `<File.Source>` block containing the text as-is. Paragraphs are
+ * separated from surrounding blocks by blank lines via the parser's source
+ * joining.
+ *
+ * @example
+ * ```tsx
+ * <Paragraph>{'A pet object with `id` and `name` fields.'}</Paragraph>
+ * ```
  */
-declare function Root({
-  onError,
+declare function Paragraph({
   children
-}: RootProps): KubbReactElement;
-declare namespace Root {
+}: Props): KubbReactElement;
+declare namespace Paragraph {
   var displayName: string;
 }
 //#endregion
@@ -476,14 +590,13 @@ type TypeProps = {
    * Emit the `export` keyword before the type alias declaration.
    * - `true` generates `export type Name = …`
    * - `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.
    */
@@ -492,7 +605,7 @@ type TypeProps = {
 /**
  * Generates a TypeScript type alias declaration.
  *
- * Throws if `name` does not start with an uppercase letter — TypeScript type aliases
+ * Throws if `name` does not start with an uppercase letter. TypeScript type aliases
  * should follow PascalCase naming conventions.
  *
  * @example Simple exported type alias
@@ -519,78 +632,48 @@ declare namespace Type {
 }
 //#endregion
 //#region src/createRenderer.d.ts
-type Options = {
-  /**
-   * Print each render result to the console for debugging.
-   * Useful when diagnosing output differences between renders.
-   * @default false
-   */
-  debug?: boolean;
-};
-/**
- * The renderer instance returned by {@link createRenderer}.
- */
-type Renderer = {
-  /**
-   * Render a JSX element tree and collect the resulting {@link FileNode} entries.
-   * Resolves once all synchronous render work (including React's flush) is done.
-   */
-  render(Element: KubbReactElement): Promise<void>;
-  /**
-   * Tear down the renderer and release all React resources.
-   * Pass an `Error` to signal an abnormal shutdown.
-   */
-  unmount(error?: Error | number | null): void;
-  /**
-   * The {@link FileNode} entries collected from the most recent `render` call.
-   */
-  files: Array<FileNode>;
-};
 /**
- * Create a Kubb JSX renderer.
- *
- * The renderer converts a React JSX element tree — built from the components in this
- * package — into an array of {@link FileNode} entries representing the generated files.
- *
- * @example Basic usage
- * ```ts
- * import { createRenderer, File } from '@kubb/renderer-jsx'
- *
- * const renderer = createRenderer()
- * await renderer.render(
- *   <File baseName="pet.ts" path="src/models/pet.ts">
- *     <File.Source name="Pet" isExportable isIndexable>
- *       {`export type Pet = { id: number; name: string }`}
- *     </File.Source>
- *   </File>
- * )
- * console.log(renderer.files) // [FileNode]
- * renderer.unmount()
- * ```
- */
-declare function createRenderer(options?: Options): Renderer;
-/**
- * A renderer factory for generators that produce JSX output.
+ * 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`.
  *
- * Pass this as the `renderer` property of a `defineGenerator` call so that
- * core can render the JSX element tree returned by your generator methods
- * without a hard dependency on `@kubb/renderer-jsx`.
+ * Every component must be a pure function. Hooks, suspense, and class
+ * components are not supported. The returned renderer also exposes `stream()`
+ * for incremental file emission.
  *
- * @example
- * ```ts
- * import { jsxRenderer } from '@kubb/renderer-jsx'
+ * @example Wire up a JSX generator
+ * ```tsx
  * import { defineGenerator } from '@kubb/core'
+ * import { jsxRenderer } from '@kubb/renderer-jsx'
  *
  * export const myGenerator = defineGenerator<PluginTs>({
- *   name: 'my-generator',
+ *   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>
+ *     )
  *   },
  * })
  * ```
+ *
+ * @example Stream files as they are produced
+ * ```tsx
+ * const renderer = jsxRenderer()
+ * for (const file of renderer.stream(element)) {
+ *   await writeFile(file.path, file.sources[0])
+ * }
+ * ```
  */
-declare const jsxRenderer: () => Renderer;
+declare const jsxRenderer: () => {
+  render(element: KubbReactElement): Promise<void>;
+  readonly files: FileNode[];
+  stream(element: KubbReactElement): Generator<FileNode>;
+  [Symbol.dispose](): void;
+};
 //#endregion
-export { Const, File, Function, Jsx, Root, Type, createContext, createRenderer, inject, jsxRenderer, provide, unprovide };
+export { Callout, Const, File, Frontmatter, Function, Heading, Jsx, List, Paragraph, Type, jsxRenderer };
 //# sourceMappingURL=index.d.ts.map