@kubb/renderer-jsx 5.0.0-beta.5 → 5.0.0-beta.51

package/dist/types-nAFMiWFw.d.ts

@@ -1,168 +0,0 @@
-import { n as __name } from "./chunk-Bb7HlUDG.js";
-import { ArrowFunctionNode, ConstNode, ExportNode, FileNode, FunctionNode, ImportNode, SourceNode, TypeNode } from "@kubb/ast";
-import React, { JSX, ReactNode } from "react";
-
-//#region src/types.d.ts
-/**
- * Unique identifier for a React element in lists or conditional renders.
- */
-type Key = string | number | bigint;
-/**
- * Custom element names recognized by the Kubb JSX renderer.
- * Each name maps to a corresponding AST node type in the generated code.
- */
-type ElementNames = 'br' | 'div' | 'indent' | 'dedent' | 'kubb-jsx' | 'kubb-text' | 'kubb-file' | 'kubb-source' | 'kubb-import' | 'kubb-export' | 'kubb-function' | 'kubb-arrow-function' | 'kubb-const' | 'kubb-type' | 'kubb-root' | 'kubb-app';
-type Node = {
-  parentNode: DOMElement | undefined;
-  internal_static?: boolean;
-};
-/**
- * Allowed attribute value types for DOM elements.
- */
-type DOMNodeAttribute = boolean | string | number | Record<string, unknown> | Array<unknown>;
-type TextName = '#text';
-/**
- * Leaf DOM node containing raw text.
- */
-type TextNode = {
-  nodeName: TextName;
-  nodeValue: string;
-} & Node;
-/**
- * Virtual DOM node — either a text node or a named element.
- */
-type DOMNode<T = {
-  nodeName: NodeNames;
-}> = T extends {
-  nodeName: infer U;
-} ? U extends '#text' ? TextNode : DOMElement : never;
-type OutputTransformer = (s: string, index: number) => string;
-/**
- * Named element in the Kubb virtual DOM tree.
- * Stores attributes, child nodes, and lifecycle callbacks for rendering.
- */
-type DOMElement = {
-  nodeName: ElementNames;
-  /**
-   * Key/value attributes passed as JSX props to this element.
-   */
-  attributes: Map<string, DOMNodeAttribute>;
-  /**
-   * Ordered list of child nodes attached to this element.
-   */
-  childNodes: DOMNode[];
-  internal_transform?: OutputTransformer;
-  isStaticDirty?: boolean;
-  staticNode?: DOMElement;
-  onComputeLayout?: () => void;
-  onRender?: () => void;
-  onImmediateRender?: () => void;
-} & Node;
-type NodeNames = ElementNames | TextName;
-/**
- * React node type for Kubb JSX components.
- */
-type KubbReactNode = ReactNode;
-/**
- * React element type returned by Kubb JSX components.
- */
-type KubbReactElement = JSX.Element;
-/**
- * Props for the `<kubb-jsx>` element.
- * Embeds a raw JSX string verbatim in generated output.
- */
-type KubbJsxProps = {
-  children?: string;
-};
-/**
- * Props for the `<kubb-text>` element.
- * Wraps React children as plain text in the output.
- */
-type KubbTextProps = {
-  children?: KubbReactNode;
-};
-/**
- * Props for the `<kubb-file>` element.
- * Represents a generated file.
- */
-type KubbFileProps = {
-  id?: string;
-  children?: KubbReactNode;
-  baseName: string;
-  path: string;
-  override?: boolean;
-  meta?: FileNode['meta'];
-};
-/**
- * Props for the `<kubb-source>` element.
- * Marks a block of source text associated with a file.
- */
-type KubbSourceProps = Omit<SourceNode, 'kind'> & {
-  children?: KubbReactNode;
-};
-/**
- * Props for the `<kubb-import>` element.
- * Declares an import statement in the generated file.
- */
-type KubbImportProps = Omit<ImportNode, 'kind'> & {};
-/**
- * Props for the `<kubb-export>` element.
- * Declares an export statement in the generated file.
- */
-type KubbExportProps = Omit<ExportNode, 'kind'> & {};
-/**
- * Props for the `<kubb-function>` element.
- * Generates a function declaration.
- */
-type KubbFunctionProps = Omit<FunctionNode, 'kind'> & {
-  children?: KubbReactNode;
-};
-/**
- * Props for the `<kubb-arrow-function>` element.
- * Generates an arrow function declaration.
- */
-type KubbArrowFunctionProps = Omit<ArrowFunctionNode, 'kind'> & {
-  children?: KubbReactNode;
-};
-/**
- * Props for the `<kubb-const>` element.
- * Generates a constant declaration.
- */
-type KubbConstProps = Omit<ConstNode, 'kind'> & {
-  children?: KubbReactNode;
-};
-/**
- * Props for the `<kubb-type>` element.
- * Generates a TypeScript type alias declaration.
- */
-type KubbTypeProps = Omit<TypeNode, 'kind'> & {
-  children?: KubbReactNode;
-};
-/**
- * Props for the HTML `<br>` element.
- */
-type LineBreakProps = React.DetailedHTMLProps<React.HTMLAttributes<HTMLBRElement>, HTMLBRElement>;
-/**
- * JSDoc comment block to attach to a generated declaration.
- * Each string in `comments` becomes one line inside the `/** … *\/` block.
- *
- * @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>;
-};
-//#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-nAFMiWFw.d.ts.map

package/src/Renderer.ts

@@ -1,184 +0,0 @@
-import { createContext } from 'react'
-import Reconciler, { type ReactContext } from 'react-reconciler'
-import { DefaultEventPriority, NoEventPriority } from 'react-reconciler/constants.js'
-import { appendChildNode, createNode, createTextNode, insertBeforeNode, removeChildNode, setAttribute, setTextNodeValue } from './dom.ts'
-import type { KubbReactNode } from './types'
-import type { DOMElement, DOMNodeAttribute, ElementNames, TextNode } from './types.ts'
-
-declare module 'react-reconciler' {
-  // @ts-expect-error custom override
-  interface Reconciler {
-    updateContainerSync(element: KubbReactNode, container: unknown, parentComponent: any, callback?: null | (() => void)): void
-    flushSyncWork(): void
-    createContainer(
-      containerInfo: unknown,
-      tag: Reconciler.RootTag,
-      hydrationCallbacks: null | Reconciler.SuspenseHydrationCallbacks<any>,
-      isStrictMode: boolean,
-      concurrentUpdatesByDefaultOverride: null | boolean,
-      identifierPrefix: string,
-      onUncaughtError: (error: Error) => void,
-      onCaughtError: (error: Error) => void,
-      onRecoverableError: (error: Error) => void,
-      transitionCallbacks: null | Reconciler.TransitionTracingCallbacks,
-    ): Reconciler.OpaqueRoot
-  }
-}
-
-type Props = Record<string, unknown>
-
-type HostContext = {
-  type: ElementNames
-  isFile: boolean
-  isSource: boolean
-}
-
-let currentUpdatePriority = NoEventPriority
-
-/**
- * @link https://www.npmjs.com/package/react-devtools-inline
- * @link https://github.com/nitin42/Making-a-custom-React-renderer/blob/master/part-one.md
- * @link https://github.com/facebook/react/tree/main/packages/react-reconciler#practical-examples
- * @link https://github.com/vadimdemedes/ink
- * @link https://github.com/pixijs/pixi-react/tree/main/packages
- * @link https://github.com/diegomura/react-pdf/blob/master/packages/reconciler/src/reconciler-31.ts
- */
-export const Renderer = Reconciler({
-  getRootHostContext: () => ({
-    type: 'kubb-root',
-    isFile: false,
-    isSource: false,
-  }),
-  prepareForCommit: () => {
-    return null
-  },
-  preparePortalMount: () => null,
-  clearContainer: () => false,
-  resetAfterCommit(rootNode: DOMElement) {
-    if (typeof rootNode.onRender === 'function') {
-      rootNode.onRender()
-    }
-  },
-  getChildHostContext(parentHostContext: HostContext, type: ElementNames) {
-    const isInsideText = type === 'kubb-text'
-    const isFile = type === 'kubb-file' || parentHostContext.isFile
-    const isSource = type === 'kubb-source' || parentHostContext.isSource
-
-    return { isInsideText, isFile, isSource, type }
-  },
-  shouldSetTextContent: () => false,
-  createInstance(originalType: ElementNames, newProps: Props, _root: DOMElement) {
-    const node = createNode(originalType)
-
-    for (const [key, value] of Object.entries(newProps)) {
-      if (key === 'children') {
-        continue
-      }
-
-      // Skip undefined values to match React's behavior
-      if (value !== undefined) {
-        setAttribute(node, key, value as DOMNodeAttribute)
-      }
-    }
-
-    return node
-  },
-  createTextInstance(text: string, _root: DOMElement, hostContext: HostContext) {
-    if (hostContext.isFile && !hostContext.isSource) {
-      throw new Error(`[react] '${text}' should be part of <File.Source> component when using the <File/> component`)
-    }
-
-    return createTextNode(text)
-  },
-  resetTextContent() {},
-  hideTextInstance(node: TextNode) {
-    setTextNodeValue(node, '')
-  },
-  unhideTextInstance(node: TextNode, text: string) {
-    setTextNodeValue(node, text)
-  },
-  getPublicInstance: (instance) => instance,
-  appendInitialChild: appendChildNode,
-  appendChild: appendChildNode,
-  insertBefore: insertBeforeNode,
-  finalizeInitialChildren(_node, _type, _props, _rootNode) {
-    return false
-  },
-  supportsMutation: true,
-  isPrimaryRenderer: true,
-  supportsPersistence: false,
-  supportsHydration: false,
-  scheduleTimeout: setTimeout,
-  cancelTimeout: clearTimeout,
-  noTimeout: -1,
-  beforeActiveInstanceBlur() {},
-  afterActiveInstanceBlur() {},
-  detachDeletedInstance() {},
-  getInstanceFromNode: () => null,
-  prepareScopeUpdate() {},
-  getInstanceFromScope: () => null,
-  appendChildToContainer: appendChildNode,
-  insertInContainerBefore: insertBeforeNode,
-  removeChildFromContainer(node: DOMElement, removeNode: TextNode) {
-    removeChildNode(node, removeNode)
-  },
-  commitMount() {},
-  commitUpdate(node: DOMElement, _payload, _type, _oldProps: Props, newProps: Props) {
-    const { props } = newProps
-
-    if (props) {
-      for (const [key, value] of Object.entries(props)) {
-        // Skip undefined values to match React's behavior
-        if (value !== undefined) {
-          setAttribute(node, key, value as DOMNodeAttribute)
-        }
-      }
-    }
-  },
-  commitTextUpdate(node: TextNode, _oldText, newText) {
-    setTextNodeValue(node, newText)
-  },
-  removeChild(node: DOMElement, removeNode: TextNode) {
-    removeChildNode(node, removeNode)
-  },
-  setCurrentUpdatePriority: (newPriority: number) => {
-    currentUpdatePriority = newPriority
-  },
-  getCurrentUpdatePriority: () => currentUpdatePriority,
-  resolveUpdatePriority() {
-    if (currentUpdatePriority !== NoEventPriority) {
-      return currentUpdatePriority
-    }
-
-    return DefaultEventPriority
-  },
-  maySuspendCommit() {
-    return false
-  },
-  // eslint-disable-next-line @typescript-eslint/naming-convention
-  NotPendingTransition: undefined,
-  // eslint-disable-next-line @typescript-eslint/naming-convention
-  HostTransitionContext: createContext(null) as unknown as ReactContext<unknown>,
-  resetFormInstance() {},
-  requestPostPaintCallback() {},
-  shouldAttemptEagerTransition() {
-    return false
-  },
-  trackSchedulerEvent() {},
-  resolveEventType() {
-    return null
-  },
-  resolveEventTimeStamp() {
-    return -1.1
-  },
-  preloadInstance() {
-    return true
-  },
-  startSuspendingCommit() {},
-  suspendInstance() {},
-  waitForCommitToBeReady() {
-    return null
-  },
-})
-
-export type { FiberRoot } from 'react-reconciler'

package/src/Runtime.tsx

@@ -1,170 +0,0 @@
-import { onProcessExit } from '@internals/utils'
-import type { FileNode } from '@kubb/ast'
-import { ConcurrentRoot } from 'react-reconciler/constants.js'
-import { Root } from './components/Root.tsx'
-import { createNode } from './dom.ts'
-import type { FiberRoot } from './Renderer.ts'
-import { Renderer } from './Renderer.ts'
-import type { DOMElement, KubbReactElement } from './types.ts'
-import { processFiles } from './utils.ts'
-
-type Options = {
-  /**
-   * Set this to true to always see the result of the render in the console(line per render)
-   */
-  debug?: boolean
-}
-
-export class Runtime {
-  readonly #options: Options
-  #isUnmounted: boolean
-  #renderError?: Error
-
-  exitPromise?: Promise<void>
-
-  nodes: FileNode[] = []
-  readonly #container: FiberRoot
-  readonly #rootNode: DOMElement
-
-  constructor(options: Options) {
-    this.#options = options
-    this.#rootNode = createNode('kubb-root')
-    this.#rootNode.onRender = this.onRender
-    this.#rootNode.onImmediateRender = this.onRender
-    this.#isUnmounted = false
-    this.unmount.bind(this)
-
-    // Intercept noisy React errors
-    console.error = (data: string | Error) => {
-      const message = typeof data === 'string' ? data : data?.message
-      if (
-        message?.match(/Encountered two children with the same key/gi) ||
-        message?.match(/React will try to recreat/gi) ||
-        message?.match(/Each child in a list should have a unique/gi) ||
-        message?.match(/The above error occurred in the <KubbErrorBoundary/gi) ||
-        message?.match(/A React Element from an older version of React was render/gi)
-      ) {
-        return
-      }
-      console.log(data)
-    }
-
-    const logRecoverableError = typeof reportError === 'function' ? reportError : console.error
-
-    const rootTag = ConcurrentRoot
-    this.#container = Renderer.createContainer(
-      this.#rootNode,
-      rootTag,
-      null,
-      false,
-      false,
-      'id',
-      logRecoverableError,
-      logRecoverableError,
-      logRecoverableError,
-      null,
-    )
-
-    // Unmount when process exits
-    this.unsubscribeExit = onProcessExit((code) => {
-      this.unmount(code)
-    })
-  }
-
-  #renderPromise: Promise<void> = Promise.resolve()
-  resolveExitPromise: () => void = () => {}
-  rejectExitPromise: (reason?: Error) => void = () => {}
-  unsubscribeExit: () => void = () => {}
-
-  onRender: () => Promise<void> = () => {
-    const previous = this.#renderPromise
-
-    const task = previous
-      .catch(() => {})
-      .then(() => {
-        if (this.#isUnmounted) {
-          return
-        }
-
-        const files = processFiles(this.#rootNode)
-
-        this.nodes.push(...files)
-
-        if (!this.#options?.debug) {
-          return
-        }
-      })
-
-    this.#renderPromise = task.catch((error) => {
-      this.onError(error as Error)
-    })
-
-    return this.#renderPromise
-  }
-
-  onError(error: Error): void {
-    // Store the error to be thrown after render completes
-    this.#renderError = error
-  }
-
-  onExit(error?: Error): void {
-    setTimeout(() => {
-      this.unmount(error)
-    }, 0)
-  }
-
-  async render(node: KubbReactElement): Promise<void> {
-    const props = {
-      onExit: this.onExit.bind(this),
-      onError: this.onError.bind(this),
-    }
-
-    const element = <Root {...props}>{node}</Root>
-
-    Renderer.updateContainerSync(element, this.#container, null, null)
-    Renderer.flushSyncWork()
-    await this.#renderPromise
-
-    // Throw any errors that occurred during rendering
-    if (this.#renderError) {
-      const error = this.#renderError
-      this.#renderError = undefined
-      throw error
-    }
-  }
-
-  unmount(error?: Error | number | null): void {
-    if (this.#isUnmounted) {
-      return
-    }
-
-    if (this.#options?.debug) {
-      console.log('Unmount', error)
-    }
-
-    this.onRender()
-    this.unsubscribeExit()
-
-    this.#isUnmounted = true
-
-    Renderer.updateContainerSync(null, this.#container, null, null)
-
-    if (error instanceof Error) {
-      this.rejectExitPromise(error)
-      return
-    }
-
-    this.resolveExitPromise()
-  }
-
-  async waitUntilExit(): Promise<void> {
-    if (!this.exitPromise) {
-      this.exitPromise = new Promise((resolve, reject) => {
-        this.resolveExitPromise = resolve
-        this.rejectExitPromise = reject
-      })
-    }
-
-    return this.exitPromise
-  }
-}

package/src/components/Root.tsx

@@ -1,70 +0,0 @@
-import { Component } from 'react'
-import type { KubbReactElement, KubbReactNode } from '../types.ts'
-
-type ErrorBoundaryProps = {
-  onError: (error: Error) => void
-  children?: KubbReactNode
-}
-
-class ErrorBoundary extends Component<{
-  onError: ErrorBoundaryProps['onError']
-  children?: KubbReactNode
-}> {
-  state = { hasError: false }
-
-  static displayName = 'ErrorBoundary'
-  static getDerivedStateFromError(_error: Error) {
-    return { hasError: true }
-  }
-
-  componentDidCatch(error: Error) {
-    if (error) {
-      this.props.onError(error)
-    }
-  }
-
-  render() {
-    if (this.state.hasError) {
-      return null
-    }
-    return this.props.children
-  }
-}
-
-type RootProps = {
-  /**
-   * 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.
-   */
-  onExit: (error?: Error) => void
-  /**
-   * Callback invoked whenever a render error is caught by the error boundary.
-   * Use this to propagate errors up to the caller of {@link createRenderer}.
-   */
-  onError: (error: Error) => void
-  /**
-   * Child nodes rendered inside the error boundary.
-   */
-  children?: KubbReactNode
-}
-
-/**
- * Root component for the Kubb renderer tree.
- *
- * Wraps all children in an `ErrorBoundary` so that render errors are caught
- * and forwarded to `onError` rather than crashing the process.
- */
-export function Root({ onError, children }: RootProps): KubbReactElement {
-  return (
-    <ErrorBoundary
-      onError={(error) => {
-        onError(error)
-      }}
-    >
-      {children}
-    </ErrorBoundary>
-  )
-}
-
-Root.displayName = 'Root'

package/src/dom.ts

@@ -1,105 +0,0 @@
-import { TEXT_NODE_NAME } from './constants.ts'
-import type { DOMElement, DOMNode, DOMNodeAttribute, TextNode } from './types.ts'
-
-/**
- * Create a new, empty {@link DOMElement} with the given node name.
- * The element has no attributes, no children, and no parent.
- */
-export const createNode = (nodeName: string): DOMElement => {
-  const node: DOMElement = {
-    nodeName: nodeName as DOMElement['nodeName'],
-    attributes: new Map(),
-    childNodes: [],
-    parentNode: undefined,
-  }
-
-  return node
-}
-
-/**
- * Append `childNode` as the last child of `node`.
- *
- * If `childNode` already has a parent, it is removed from that parent first
- * (matching standard DOM move semantics).
- * Text nodes (`nodeName === '#text'`) are silently ignored.
- */
-export const appendChildNode = (node: DOMNode, childNode: DOMElement | DOMNode): void => {
-  if (childNode.parentNode) {
-    removeChildNode(childNode.parentNode, childNode)
-  }
-
-  if (node.nodeName !== TEXT_NODE_NAME) {
-    childNode.parentNode = node
-    node.childNodes.push(childNode)
-  }
-}
-
-/**
- * Insert `newChildNode` before `beforeChildNode` in `node`'s child list.
- *
- * If `newChildNode` already has a parent, it is removed from that parent first.
- * If `beforeChildNode` is not found, `newChildNode` is appended at the end.
- */
-export const insertBeforeNode = (node: DOMElement, newChildNode: DOMNode, beforeChildNode: DOMNode): void => {
-  if (newChildNode.parentNode) {
-    removeChildNode(newChildNode.parentNode, newChildNode)
-  }
-
-  newChildNode.parentNode = node
-
-  const index = node.childNodes.indexOf(beforeChildNode)
-  if (index >= 0) {
-    node.childNodes.splice(index, 0, newChildNode)
-
-    return
-  }
-
-  node.childNodes.push(newChildNode)
-}
-
-/**
- * Remove `removeNode` from `node`'s child list and clear its `parentNode` reference.
- * Does nothing if `removeNode` is not a direct child of `node`.
- */
-export const removeChildNode = (node: DOMElement, removeNode: DOMNode): void => {
-  removeNode.parentNode = undefined
-
-  const index = node.childNodes.indexOf(removeNode)
-  if (index >= 0) {
-    node.childNodes.splice(index, 1)
-  }
-}
-
-/**
- * Set an attribute on `node`, storing it in the node's `attributes` map.
- */
-export const setAttribute = (node: DOMElement, key: string, value: DOMNodeAttribute): void => {
-  node.attributes.set(key, value)
-}
-
-/**
- * Create a new {@link TextNode} with the given text value.
- */
-export const createTextNode = (text: string): TextNode => {
-  const node: TextNode = {
-    nodeName: TEXT_NODE_NAME,
-    nodeValue: text,
-    parentNode: undefined,
-  }
-
-  setTextNodeValue(node, text)
-
-  return node
-}
-
-/**
- * Update the `nodeValue` of an existing {@link TextNode}.
- * Non-string values are coerced to strings via `String(text)`.
- */
-export const setTextNodeValue = (node: TextNode, text: string): void => {
-  if (typeof text !== 'string') {
-    text = String(text)
-  }
-
-  node.nodeValue = text
-}