create-automatic-runtime.js

/**
 * @typedef {import('hast').Element} Element
 * @typedef {import('hast').Root} Root
 *
 * @typedef {import('./create-h.js').Child} Child
 * @typedef {import('./create-h.js').Properties} Properties
 * @typedef {import('./create-h.js').PropertyValue} PropertyValue
 * @typedef {import('./create-h.js').Result} Result
 * @typedef {import('./create-h.js').Style} Style
 * @typedef {import('./create-h.js').createH} CreateH
 *
 * @typedef {Record<string, Child | PropertyValue | Style>} JSXProps
 */

// Make VS code see references to above symbols.
''

/**
 * Create an automatic runtime.
 *
 * @param {ReturnType<CreateH>} f
 *   `h` function.
 * @returns
 *   Automatic JSX runtime.
 */
export function createAutomaticRuntime(f) {
  /**
   * @overload
   * @param {null} type
   * @param {{children?: Child}} props
   * @param {string} [key]
   * @returns {Root}
   *
   * @overload
   * @param {string} type
   * @param {JSXProps} props
   * @param {string} [key]
   * @returns {Element}
   *
   * @param {string | null} type
   *   Element name or `null` to get a root.
   * @param {Properties & {children?: Child}} props
   *   Properties.
   * @returns {Result}
   *   Result.
   */
  function jsx(type, props) {
    const {children, ...properties} = props
    const result =
      // @ts-ignore: `children` is fine: TS has a recursion problem which
      // sometimes generates broken types.
      type === null ? f(null, children) : f(type, properties, children)
    return result
  }

  return {Fragment: null, jsx, jsxDEV: jsx, jsxs: jsx}
}