@kubb/renderer-jsx 5.5.6 → 5.6.0

package/dist/index.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, t as JSDoc } from "./types-seYG0czS.js";
+import { i as KubbReactNode, n as Key, r as KubbReactElement, t as JSDoc } from "./types-BbP7RtaT.js";
 import { ast } from "@kubb/kit";
 //#region src/components/md/Callout.d.ts
 declare const CALLOUT_LABEL: {
@@ -44,9 +44,6 @@ type Props$7 = {
  * ```
  */
 export declare function Callout({ type, title, children }: Props$7): KubbReactElement;
-export declare namespace Callout {
-  var displayName: string;
-}
 //#endregion
 //#region src/components/js/Const.d.ts
 type ConstProps = {
@@ -105,10 +102,7 @@ type ConstProps = {
  * </Const>
  * ```
  */
-export declare function Const({ children, ...props }: ConstProps): KubbReactElement;
-export declare namespace Const {
-  var displayName: string;
-}
+export declare function Const({ children, name, export: canExport, type, JSDoc, asConst }: ConstProps): KubbReactElement;
 //#endregion
 //#region src/components/File.d.ts
 type BasePropsWithBaseName = {
@@ -184,7 +178,6 @@ type Props$6<TMeta> = BaseProps & {
  */
 export declare function File<TMeta extends object = object>({ children, ...props }: Props$6<TMeta>): KubbReactElement;
 export declare namespace File {
-  var displayName: string;
   var Export: typeof FileExport;
   var Import: typeof FileImport;
   var Source: typeof FileSource;
@@ -217,9 +210,6 @@ type FileSourceProps = Omit<ast.SourceNode, 'kind' | 'value'> & {
  * ```
  */
 declare function FileSource({ children, ...props }: FileSourceProps): KubbReactElement;
-declare namespace FileSource {
-  var displayName: string;
-}
 type FileExportProps = Omit<ast.ExportNode, 'kind'> & {
   key?: Key;
 };
@@ -241,9 +231,6 @@ type FileExportProps = Omit<ast.ExportNode, 'kind'> & {
  * ```
  */
 declare function FileExport(props: FileExportProps): KubbReactElement;
-declare namespace FileExport {
-  var displayName: string;
-}
 type FileImportProps = Omit<ast.ImportNode, 'kind'> & {
   key?: Key;
 };
@@ -271,9 +258,6 @@ type FileImportProps = Omit<ast.ImportNode, 'kind'> & {
  * ```
  */
 declare function FileImport(props: FileImportProps): KubbReactElement;
-declare namespace FileImport {
-  var displayName: string;
-}
 //#endregion
 //#region src/components/md/Frontmatter.d.ts
 type Props$5 = {
@@ -304,9 +288,6 @@ type Props$5 = {
  * ```
  */
 export declare function Frontmatter({ data }: Props$5): KubbReactElement;
-export declare namespace Frontmatter {
-  var displayName: string;
-}
 //#endregion
 //#region src/components/js/Function.d.ts
 type Props$4 = {
@@ -384,9 +365,8 @@ type Props$4 = {
  * // }
  * ```
  */
-export declare function Function({ children, ...props }: Props$4): KubbReactElement;
+export declare function Function({ children, name, default: isDefault, export: canExport, async: isAsync, generics, params, returnType, JSDoc }: Props$4): KubbReactElement;
 export declare namespace Function {
-  var displayName: string;
   var Arrow: typeof ArrowFunction;
 }
 type ArrowFunctionProps = Props$4 & {
@@ -410,10 +390,7 @@ type ArrowFunctionProps = Props$4 & {
  * // export const double = (n: number): number => n * 2
  * ```
  */
-declare function ArrowFunction({ children, ...props }: ArrowFunctionProps): any;
-declare namespace ArrowFunction {
-  var displayName: string;
-}
+declare function ArrowFunction({ children, name, default: isDefault, export: canExport, async, generics, params, returnType, JSDoc, singleLine }: ArrowFunctionProps): any;
 //#endregion
 //#region src/components/md/Heading.d.ts
 type Level = 1 | 2 | 3 | 4 | 5 | 6;
@@ -442,12 +419,10 @@ type Props$3 = {
  * ```
  */
 export declare function Heading({ level, children }: Props$3): KubbReactElement;
-export declare namespace Heading {
-  var displayName: string;
-}
 //#endregion
 //#region src/components/jsx/Jsx.d.ts
 type Props$2 = {
+  key?: Key;
   /**
    * Raw JSX string embedded verbatim in the generated code, including
    * fragments (`<>…</>`).
@@ -475,9 +450,6 @@ type Props$2 = {
  * ```
  */
 export declare function Jsx({ children }: Props$2): KubbReactElement;
-export declare namespace Jsx {
-  var displayName: string;
-}
 //#endregion
 //#region src/components/md/List.d.ts
 type Props$1 = {
@@ -512,9 +484,6 @@ type Props$1 = {
  * ```
  */
 export declare function List({ ordered, items }: Props$1): KubbReactElement;
-export declare namespace List {
-  var displayName: string;
-}
 //#endregion
 //#region src/components/md/Paragraph.d.ts
 type Props = {
@@ -538,9 +507,6 @@ type Props = {
  * ```
  */
 export declare function Paragraph({ children }: Props): KubbReactElement;
-export declare namespace Paragraph {
-  var displayName: string;
-}
 //#endregion
 //#region src/components/js/Type.d.ts
 type TypeProps = {
@@ -590,521 +556,15 @@ type TypeProps = {
  * </Type>
  * ```
  */
-export declare function Type({ children, ...props }: TypeProps): KubbReactElement;
-export declare namespace Type {
-  var displayName: string;
-}
-//#endregion
-//#region ../ast/src/nodes/base.d.ts
-/**
- * `kind` values used by AST nodes.
- *
- * @example
- * ```ts
- * const kind: NodeKind = 'Schema'
- * ```
- */
-type NodeKind = 'Input' | 'Output' | 'Operation' | 'Schema' | 'Property' | 'Parameter' | 'Response' | 'RequestBody' | 'Content' | 'Type' | 'File' | 'Import' | 'Export' | 'Source' | 'Const' | 'Function' | 'ArrowFunction' | 'Text' | 'Break' | 'Jsx';
-/**
- * Base shape shared by all AST nodes.
- *
- * @example
- * ```ts
- * const base: BaseNode = { kind: 'Input' }
- * ```
- */
-type BaseNode = {
-  /**
-   * Node discriminator.
-   */
-  kind: NodeKind;
-};
-//#endregion
-//#region ../ast/src/nodes/code.d.ts
-/**
- * JSDoc documentation metadata attached to code declarations.
- */
-type JSDocNode = {
-  /**
-   * JSDoc comment lines. `undefined` entries are filtered out during rendering.
-   *
-   * @example
-   * ```ts
-   * ['@description A pet resource', '@deprecated']
-   * ```
-   */
-  comments?: Array<string | undefined>;
-};
-/**
- * AST node representing a TypeScript `const` declaration.
- *
- * Mirrors the props of the `Const` component from `@kubb/renderer-jsx`.
- * The `children` prop of the component is represented as `nodes`.
- *
- * @example
- * ```ts
- * createConst({ name: 'pet', export: true, asConst: true })
- * // export const pet = ... as const
- * ```
- */
-type ConstNode = BaseNode & {
-  kind: 'Const';
-  /**
-   * Name of the constant declaration.
-   */
-  name: string;
-  /**
-   * Whether the declaration should be exported.
-   */
-  export?: boolean | null;
-  /**
-   * Explicit type annotation.
-   *
-   * @example Type reference
-   * `'Pet'`
-   */
-  type?: string | null;
-  /**
-   * JSDoc documentation metadata.
-   */
-  JSDoc?: JSDocNode | null;
-  /**
-   * Whether to append `as const` to the declaration.
-   */
-  asConst?: boolean | null;
-  /**
-   * Child nodes representing the value of the constant (children of the `Const` component).
-   * Each entry is a {@link CodeNode}. Use {@link TextNode} for raw string content.
-   */
-  nodes?: Array<CodeNode>;
-};
-/**
- * AST node representing a TypeScript `type` alias declaration.
- *
- * Mirrors the props of the `Type` component from `@kubb/renderer-jsx`.
- * The `children` prop of the component is represented as `nodes`.
- *
- * @example
- * ```ts
- * createType({ name: 'Pet', export: true })
- * // export type Pet = ...
- * ```
- */
-type TypeNode = BaseNode & {
-  kind: 'Type';
-  /**
-   * Name of the type alias.
-   */
-  name: string;
-  /**
-   * Whether the declaration should be exported.
-   */
-  export?: boolean | null;
-  /**
-   * JSDoc documentation metadata.
-   */
-  JSDoc?: JSDocNode | null;
-  /**
-   * Child nodes representing the type body (children of the `Type` component).
-   * Each entry is a {@link CodeNode}. Use {@link TextNode} for raw string content.
-   */
-  nodes?: Array<CodeNode>;
-};
-/**
- * AST node representing a TypeScript `function` declaration.
- *
- * Mirrors the props of the `Function` component from `@kubb/renderer-jsx`.
- * The `children` prop of the component is represented as `nodes`.
- *
- * @example
- * ```ts
- * createFunction({ name: 'getPet', export: true, async: true, returnType: 'Pet' })
- * // export async function getPet(): Promise<Pet> { ... }
- * ```
- */
-type FunctionNode = BaseNode & {
-  kind: 'Function';
-  /**
-   * Name of the function.
-   */
-  name: string;
-  /**
-   * Whether the function is a default export.
-   */
-  default?: boolean | null;
-  /**
-   * Function parameter list as a pre-rendered string, written verbatim between the parentheses.
-   *
-   * @example
-   * `'id: string, config: Config = {}'`
-   */
-  params?: string | null;
-  /**
-   * Whether the function should be exported.
-   */
-  export?: boolean | null;
-  /**
-   * Whether the function is async. When `true`, the return type is wrapped in `Promise<>`.
-   */
-  async?: boolean | null;
-  /**
-   * TypeScript generic type parameters.
-   *
-   * @example Constrained generics
-   * `['T', 'U extends string']`
-   */
-  generics?: string | Array<string> | null;
-  /**
-   * Return type annotation.
-   *
-   * @example Type reference
-   * `'Pet'`
-   */
-  returnType?: string | null;
-  /**
-   * JSDoc documentation metadata.
-   */
-  JSDoc?: JSDocNode | null;
-  /**
-   * Child nodes representing the function body (children of the `Function` component).
-   * Each entry is a {@link CodeNode}. Use {@link TextNode} for raw string content.
-   */
-  nodes?: Array<CodeNode>;
-};
-/**
- * AST node representing a TypeScript arrow function (`const name = () => { ... }`).
- *
- * Mirrors the props of the `Function.Arrow` component from `@kubb/renderer-jsx`.
- * The `children` prop of the component is represented as `nodes`.
- *
- * @example
- * ```ts
- * createArrowFunction({ name: 'getPet', export: true, singleLine: true })
- * // export const getPet = () => ...
- * ```
- */
-type ArrowFunctionNode = Omit<FunctionNode, 'kind'> & {
-  kind: 'ArrowFunction';
-  /**
-   * Render the arrow function body as a single-line expression.
-   */
-  singleLine?: boolean | null;
-};
-/**
- * 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 & {
-  kind: 'Text';
-  /**
-   * The raw string content.
-   */
-  value: string;
-};
-/**
- * AST node representing a blank line in the source output.
- *
- * Corresponds to `<br/>` in JSX components. `printNodes` turns a `Break` between two
- * statements into one blank line. Consecutive breaks, and breaks at the start or end of
- * the list, are folded away, so a `Break` never produces more than one blank line.
- *
- * @example
- * ```ts
- * createBreak()
- * // { kind: 'Break' }
- * ```
- */
-type BreakNode = BaseNode & {
-  kind: 'Break';
-};
-/**
- * AST node representing a raw JSX fragment in the source output.
- *
- * Mirrors the `Jsx` component from `@kubb/renderer-jsx`. Embeds 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 & {
-  kind: 'Jsx';
-  /**
-   * The raw JSX string content.
-   */
-  value: string;
-};
-/**
- * Union of all code-generation AST nodes.
- *
- * 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 | TextNode | BreakNode | JsxNode;
-//#endregion
-//#region ../ast/src/nodes/file.d.ts
-/**
- * Supported file extensions.
- */
-type Extname = '.ts' | '.js' | '.tsx' | '.json' | `.${string}`;
-type ImportName = string | Array<string | {
-  propertyName: string;
-  name?: string;
-}>;
-/**
- * Represents a language-agnostic import/dependency declaration.
- *
- * @example Named import (TypeScript: `import { useState } from 'react'`)
- * ```ts
- * createImport({ name: ['useState'], path: 'react' })
- * ```
- *
- * @example Default import (TypeScript: `import React from 'react'`)
- * ```ts
- * createImport({ name: 'React', path: 'react' })
- * ```
- *
- * @example Type-only import (TypeScript: `import type { FC } from 'react'`)
- * ```ts
- * createImport({ name: ['FC'], path: 'react', isTypeOnly: true })
- * ```
- *
- * @example Namespace import (TypeScript: `import * as React from 'react'`)
- * ```ts
- * createImport({ name: 'React', path: 'react', isNameSpace: true })
- * ```
- */
-type ImportNode = BaseNode & {
-  kind: 'Import';
-  /**
-   * Import name(s) to be used.
-   *
-   * @example Named imports
-   * `['useState']`
-   *
-   * @example Default import
-   * `'React'`
-   */
-  name: ImportName;
-  /**
-   * Path for the import.
-   *
-   * @example
-   * `'@kubb/core'`
-   */
-  path: string;
-  /**
-   * Add a type-only import prefix.
-   * - `true` generates `import type { Type } from './path'`
-   * - `false` generates `import { Type } from './path'`
-   */
-  isTypeOnly?: boolean | null;
-  /**
-   * Import the entire module as a namespace.
-   * - `true` generates `import * as Name from './path'`
-   * - `false` generates a standard import
-   */
-  isNameSpace?: boolean | null;
-  /**
-   * When set, the import path is resolved relative to this root.
-   */
-  root?: string | null;
-};
-/**
- * Represents a language-agnostic export/public API declaration.
- *
- * @example Named export (TypeScript: `export { Pets } from './Pets'`)
- * ```ts
- * createExport({ name: ['Pets'], path: './Pets' })
- * ```
- *
- * @example Type-only export (TypeScript: `export type { Pet } from './Pet'`)
- * ```ts
- * createExport({ name: ['Pet'], path: './Pet', isTypeOnly: true })
- * ```
- *
- * @example Wildcard export (TypeScript: `export * from './utils'`)
- * ```ts
- * createExport({ path: './utils' })
- * ```
- *
- * @example Namespace alias (TypeScript: `export * as utils from './utils'`)
- * ```ts
- * createExport({ name: 'utils', path: './utils', asAlias: true })
- * ```
- */
-type ExportNode = BaseNode & {
-  kind: 'Export';
-  /**
-   * Export name(s) to be used. When omitted, generates a wildcard export.
-   *
-   * @example Named exports
-   * `['useState']`
-   *
-   * @example Single export
-   * `'React'`
-   */
-  name?: string | Array<string> | null;
-  /**
-   * Path for the export.
-   *
-   * @example
-   * `'@kubb/core'`
-   */
-  path: string;
-  /**
-   * Add a type-only export prefix.
-   * - `true` generates `export type { Type } from './path'`
-   * - `false` generates `export { Type } from './path'`
-   */
-  isTypeOnly?: boolean | null;
-  /**
-   * Export as an aliased namespace.
-   * - `true` generates `export * as aliasName from './path'`
-   * - `false` generates a standard export
-   */
-  asAlias?: boolean | null;
-};
-/**
- * Represents a fragment of source code within a file.
- *
- * @example Named exportable source
- * ```ts
- * createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')], isExportable: true, isIndexable: true })
- * ```
- *
- * @example Inline unnamed code block
- * ```ts
- * createSource({ nodes: [createText('const x = 1')] })
- * ```
- */
-type SourceNode = BaseNode & {
-  kind: 'Source';
-  /**
-   * Optional name identifying this source (used for deduplication and barrel generation).
-   */
-  name?: string | null;
-  /**
-   * Mark this source as a type-only export.
-   */
-  isTypeOnly?: boolean | null;
-  /**
-   * Include the `export` keyword in the generated source.
-   */
-  isExportable?: boolean | null;
-  /**
-   * Include this source in barrel/index file generation.
-   */
-  isIndexable?: boolean | null;
-  /**
-   * Child nodes that make up this source fragment, in DOM order.
-   * Use a {@link TextNode} for raw string content.
-   */
-  nodes?: Array<CodeNode>;
-};
-/**
- * Represents a fully resolved file in the AST.
- *
- * Created via `createFile()`, which computes the `id`, `name`, and `extname` from the input
- * and deduplicates `imports`, `exports`, and `sources`.
- *
- * @example
- * ```ts
- * const file = createFile({
- *   baseName: 'petStore.ts',
- *   path: 'src/models/petStore.ts',
- *   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' })],
- * })
- * // file.id   = SHA256 hash of the path
- * // file.name = 'petStore'
- * // file.extname = '.ts'
- * ```
- */
-type FileNode<TMeta extends object = object> = BaseNode & {
-  kind: 'File';
-  /**
-   * Unique identifier derived from a SHA256 hash of the file path. `createFile`
-   * computes it, so callers do not need to provide it.
-   */
-  id: string;
-  /**
-   * File name without extension, derived from `baseName`.
-   *
-   * @see https://nodejs.org/api/path.html#pathformatpathobject
-   */
-  name: string;
-  /**
-   * File base name, including extension, shaped like `${name}${extname}`.
-   *
-   * @see https://nodejs.org/api/path.html#pathbasenamepath-suffix
-   */
-  baseName: `${string}.${string}`;
-  /**
-   * Full qualified path to the file.
-   */
-  path: string;
-  /**
-   * File extension extracted from `baseName`.
-   */
-  extname: Extname;
-  /**
-   * Deduplicated list of source code fragments.
-   */
-  sources: Array<SourceNode>;
-  /**
-   * Deduplicated list of import declarations.
-   */
-  imports: Array<ImportNode>;
-  /**
-   * Deduplicated list of export declarations.
-   */
-  exports: Array<ExportNode>;
-  /**
-   * Optional metadata attached to this file, read by plugins during barrel generation.
-   */
-  meta?: TMeta;
-  /**
-   * Optional banner prepended to the generated file content.
-   * Accepts `null` so `resolver.default.banner()` results can be passed directly.
-   */
-  banner?: string | null;
-  /**
-   * Optional footer appended to the generated file content.
-   * Accepts `null` so `resolver.default.footer()` results can be passed directly.
-   */
-  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. When set, `copy` provides the file content and any `sources` nodes are ignored for
-   * output; `sources` may still carry `name`/`isExportable`/`isIndexable` so barrel generation
-   * treats the file the same as a rendered one.
-   */
-  copy?: string | null;
-};
+export declare function Type({ children, name, export: canExport, JSDoc }: TypeProps): KubbReactElement;
 //#endregion
 //#region src/jsxRenderer.d.ts
 /**
  * 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
@@ -1126,7 +586,7 @@ type FileNode<TMeta extends object = object> = BaseNode & {
  */
 export declare const jsxRenderer: () => {
   render(element: KubbReactElement): Promise<void>;
-  readonly files: FileNode[];
+  readonly files: ast.FileNode[];
   [Symbol.dispose](): void;
 };
 //#endregion