🎉 initiate project *astro_rewrite*

node_modules/estree-util-to-js/lib/index.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Serialize an estree as JavaScript.
+ *
+ * @param tree
+ *   Estree (esast).
+ * @param options
+ *   Configuration (optional).
+ * @returns
+ *   Result, optionally with source map.
+ */
+export const toJs: ((
+  value: Program,
+  options: OptionsWithSourceMapGenerator
+) => ResultWithSourceMapGenerator) &
+  ((
+    value: Program,
+    options: OptionsWithMaybeMapGenerator
+  ) => ResultMaybeSourceMapGenerator) &
+  ((
+    value: Program,
+    options?: OptionsWithoutSourceMapGenerator | null | undefined
+  ) => ResultWithoutSourceMapGenerator)
+export type Program = import('estree-jsx').Program
+export type SourceMapGenerator = typeof import('source-map').SourceMapGenerator
+export type Map = import('source-map').RawSourceMap
+export type Handlers = import('./types.js').Handlers
+export type BaseFields = {
+  /**
+   * Object mapping node types to functions handling the corresponding nodes.
+   */
+  handlers?: Handlers | null | undefined
+}
+export type SourceMapFieldsWithoutSourceMapGenerator = {
+  /**
+   * Generate a source map by passing a `SourceMapGenerator` from `source-map`
+   * in.
+   * This works if there is positional info on nodes.
+   */
+  SourceMapGenerator?: null | undefined
+  /**
+   * Path to input file.
+   * Only used in source map.
+   */
+  filePath?: null | undefined
+}
+export type SourceMapFieldsWithSourceMapGenerator = {
+  /**
+   * Generate a source map by passing a `SourceMapGenerator` from `source-map`
+   * in.
+   * This works if there is positional info on nodes.
+   */
+  SourceMapGenerator: SourceMapGenerator
+  /**
+   * Path to input file.
+   * Only used in source map.
+   */
+  filePath?: string | null | undefined
+}
+export type SourceMapFieldsMaybeSourceMapGenerator = {
+  /**
+   * Generate a source map by passing a `SourceMapGenerator` from `source-map`
+   * in.
+   * This works if there is positional info on nodes.
+   */
+  SourceMapGenerator: SourceMapGenerator | null | undefined
+  /**
+   * Path to input file.
+   * Only used in source map.
+   */
+  filePath?: string | null | undefined
+}
+export type OptionsWithoutSourceMapGenerator = BaseFields &
+  SourceMapFieldsWithoutSourceMapGenerator
+export type OptionsWithSourceMapGenerator = BaseFields &
+  SourceMapFieldsWithSourceMapGenerator
+export type OptionsWithMaybeMapGenerator = BaseFields &
+  SourceMapFieldsMaybeSourceMapGenerator
+/**
+ * Configuration (optional).
+ */
+export type Options = OptionsWithMaybeMapGenerator
+export type BaseResultFields = {
+  /**
+   * Serialized JavaScript.
+   */
+  value: string
+}
+export type ResultFieldsWithoutSourceMapGenerator = {
+  /**
+   * Source map as (parsed) JSON, if `SourceMapGenerator` is passed.
+   */
+  map: undefined
+}
+export type ResultFieldsWithSourceMapGenerator = {
+  /**
+   * Source map as (parsed) JSON, if `SourceMapGenerator` is not passed.
+   */
+  map: Map
+}
+export type ResultFieldsMaybeSourceMapGenerator = {
+  /**
+   * Source map as (parsed) JSON, if `SourceMapGenerator` might be passed.
+   */
+  map: Map | undefined
+}
+export type ResultWithoutSourceMapGenerator = BaseResultFields &
+  ResultFieldsWithoutSourceMapGenerator
+export type ResultWithSourceMapGenerator = BaseResultFields &
+  ResultFieldsWithSourceMapGenerator
+export type ResultMaybeSourceMapGenerator = BaseResultFields &
+  ResultFieldsMaybeSourceMapGenerator
+export type Result = ResultMaybeSourceMapGenerator

node_modules/estree-util-to-js/lib/index.js

@@ -0,0 +1,118 @@
+/**
+ * @typedef {import('estree-jsx').Program} Program
+ * @typedef {typeof import('source-map').SourceMapGenerator} SourceMapGenerator
+ * @typedef {import('source-map').RawSourceMap} Map
+ * @typedef {import('./types.js').Handlers} Handlers
+ */
+
+/**
+ * @typedef BaseFields
+ * @property {Handlers | null | undefined} [handlers]
+ *   Object mapping node types to functions handling the corresponding nodes.
+ *
+ * @typedef SourceMapFieldsWithoutSourceMapGenerator
+ * @property {null | undefined} [SourceMapGenerator]
+ *   Generate a source map by passing a `SourceMapGenerator` from `source-map`
+ *   in.
+ *   This works if there is positional info on nodes.
+ * @property {null | undefined} [filePath]
+ *   Path to input file.
+ *   Only used in source map.
+ *
+ * @typedef SourceMapFieldsWithSourceMapGenerator
+ * @property {SourceMapGenerator} SourceMapGenerator
+ *   Generate a source map by passing a `SourceMapGenerator` from `source-map`
+ *   in.
+ *   This works if there is positional info on nodes.
+ * @property {string | null | undefined} [filePath]
+ *   Path to input file.
+ *   Only used in source map.
+ *
+ * @typedef SourceMapFieldsMaybeSourceMapGenerator
+ * @property {SourceMapGenerator | null | undefined} SourceMapGenerator
+ *   Generate a source map by passing a `SourceMapGenerator` from `source-map`
+ *   in.
+ *   This works if there is positional info on nodes.
+ * @property {string | null | undefined} [filePath]
+ *   Path to input file.
+ *   Only used in source map.
+ *
+ * @typedef {BaseFields & SourceMapFieldsWithoutSourceMapGenerator} OptionsWithoutSourceMapGenerator
+ * @typedef {BaseFields & SourceMapFieldsWithSourceMapGenerator} OptionsWithSourceMapGenerator
+ * @typedef {BaseFields & SourceMapFieldsMaybeSourceMapGenerator} OptionsWithMaybeMapGenerator
+ *
+ * @typedef {OptionsWithMaybeMapGenerator} Options
+ *   Configuration (optional).
+ *
+ * @typedef BaseResultFields
+ * @property {string} value
+ *   Serialized JavaScript.
+ *
+ * @typedef ResultFieldsWithoutSourceMapGenerator
+ * @property {undefined} map
+ *   Source map as (parsed) JSON, if `SourceMapGenerator` is passed.
+ *
+ * @typedef ResultFieldsWithSourceMapGenerator
+ * @property {Map} map
+ *   Source map as (parsed) JSON, if `SourceMapGenerator` is not passed.
+ *
+ * @typedef ResultFieldsMaybeSourceMapGenerator
+ * @property {Map | undefined} map
+ *   Source map as (parsed) JSON, if `SourceMapGenerator` might be passed.
+ *
+ * @typedef {BaseResultFields & ResultFieldsWithoutSourceMapGenerator} ResultWithoutSourceMapGenerator
+ * @typedef {BaseResultFields & ResultFieldsWithSourceMapGenerator} ResultWithSourceMapGenerator
+ * @typedef {BaseResultFields & ResultFieldsMaybeSourceMapGenerator} ResultMaybeSourceMapGenerator
+ *
+ * @typedef {ResultMaybeSourceMapGenerator} Result
+ */
+
+// @ts-expect-error: `astring` has broken types.
+import * as astring from 'astring'
+
+/** @type {Handlers} */
+const GENERATOR = astring.GENERATOR
+
+/** @type {(node: Program, options: unknown) => string} */
+const generate = astring.generate
+
+/**
+ * Serialize an estree as JavaScript.
+ *
+ * @param tree
+ *   Estree (esast).
+ * @param options
+ *   Configuration (optional).
+ * @returns
+ *   Result, optionally with source map.
+ */
+export const toJs =
+  /**
+   * @type {(
+   *   ((value: Program, options: OptionsWithSourceMapGenerator) => ResultWithSourceMapGenerator) &
+   *   ((value: Program, options: OptionsWithMaybeMapGenerator) => ResultMaybeSourceMapGenerator) &
+   *   ((value: Program, options?: OptionsWithoutSourceMapGenerator | null | undefined) => ResultWithoutSourceMapGenerator)
+   * )}
+   */
+  (
+    /**
+     * @param {Program} tree
+     * @param {Options | null | undefined} [options]
+     * @returns {Result}
+     */
+    function (tree, options) {
+      const {SourceMapGenerator, filePath, handlers} = options || {}
+      const sourceMap = SourceMapGenerator
+        ? new SourceMapGenerator({file: filePath || '<unknown>.js'})
+        : undefined
+
+      const value = generate(tree, {
+        comments: true,
+        generator: {...GENERATOR, ...handlers},
+        sourceMap
+      })
+      const map = sourceMap ? sourceMap.toJSON() : undefined
+
+      return {value, map}
+    }
+  )

node_modules/estree-util-to-js/lib/jsx.d.ts

@@ -0,0 +1,265 @@
+export namespace jsx {
+  export {JSXAttribute}
+  export {JSXClosingElement}
+  export {JSXClosingFragment}
+  export {JSXElement}
+  export {JSXEmptyExpression}
+  export {JSXExpressionContainer}
+  export {JSXFragment}
+  export {JSXIdentifier}
+  export {JSXMemberExpression}
+  export {JSXNamespacedName}
+  export {JSXOpeningElement}
+  export {JSXOpeningFragment}
+  export {JSXSpreadAttribute}
+  export {JSXText}
+}
+export type JSXAttribute = import('estree-jsx').JSXAttribute
+export type JSXClosingElement = import('estree-jsx').JSXClosingElement
+export type JSXClosingFragment = import('estree-jsx').JSXClosingFragment
+export type JSXElement = import('estree-jsx').JSXElement
+export type JSXExpressionContainer = import('estree-jsx').JSXExpressionContainer
+export type JSXFragment = import('estree-jsx').JSXFragment
+export type JSXIdentifier = import('estree-jsx').JSXIdentifier
+export type JSXMemberExpression = import('estree-jsx').JSXMemberExpression
+export type JSXNamespacedName = import('estree-jsx').JSXNamespacedName
+export type JSXOpeningElement = import('estree-jsx').JSXOpeningElement
+export type JSXOpeningFragment = import('estree-jsx').JSXOpeningFragment
+export type JSXSpreadAttribute = import('estree-jsx').JSXSpreadAttribute
+export type JSXText = import('estree-jsx').JSXText
+export type Generator = import('./types.js').Generator
+export type State = import('./types.js').State
+/**
+ * `attr`
+ * `attr="something"`
+ * `attr={1}`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXAttribute} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXAttribute(
+  this: import('./types.js').Generator,
+  node: JSXAttribute,
+  state: State
+): void
+/**
+ * `</div>`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXClosingElement} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXClosingElement(
+  this: import('./types.js').Generator,
+  node: JSXClosingElement,
+  state: State
+): void
+/**
+ * `</>`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXClosingFragment} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXClosingFragment(
+  this: import('./types.js').Generator,
+  node: JSXClosingFragment,
+  state: State
+): void
+/**
+ * `<div />`
+ * `<div></div>`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXElement} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXElement(
+  this: import('./types.js').Generator,
+  node: JSXElement,
+  state: State
+): void
+/**
+ * `{}` (always in a `JSXExpressionContainer`, which does the curlies)
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXEmptyExpression(this: import('./types.js').Generator): void
+/**
+ * `{expression}`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXExpressionContainer} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXExpressionContainer(
+  this: import('./types.js').Generator,
+  node: JSXExpressionContainer,
+  state: State
+): void
+/**
+ * `<></>`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXFragment} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXFragment(
+  this: import('./types.js').Generator,
+  node: JSXFragment,
+  state: State
+): void
+/**
+ * `div`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXIdentifier} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXIdentifier(
+  this: import('./types.js').Generator,
+  node: JSXIdentifier,
+  state: State
+): void
+/**
+ * `member.expression`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXMemberExpression} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXMemberExpression(
+  this: import('./types.js').Generator,
+  node: JSXMemberExpression,
+  state: State
+): void
+/**
+ * `ns:name`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXNamespacedName} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXNamespacedName(
+  this: import('./types.js').Generator,
+  node: JSXNamespacedName,
+  state: State
+): void
+/**
+ * `<div>`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXOpeningElement} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXOpeningElement(
+  this: import('./types.js').Generator,
+  node: JSXOpeningElement,
+  state: State
+): void
+/**
+ * `<>`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXOpeningFragment} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXOpeningFragment(
+  this: import('./types.js').Generator,
+  node: JSXOpeningFragment,
+  state: State
+): void
+/**
+ * `{...argument}`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXSpreadAttribute} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXSpreadAttribute(
+  this: import('./types.js').Generator,
+  node: JSXSpreadAttribute,
+  state: State
+): void
+/**
+ * `!`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXText} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+declare function JSXText(
+  this: import('./types.js').Generator,
+  node: JSXText,
+  state: State
+): void
+export {}

node_modules/estree-util-to-js/lib/jsx.js

@@ -0,0 +1,360 @@
+/**
+ * @typedef {import('estree-jsx').JSXAttribute} JSXAttribute
+ * @typedef {import('estree-jsx').JSXClosingElement} JSXClosingElement
+ * @typedef {import('estree-jsx').JSXClosingFragment} JSXClosingFragment
+ * @typedef {import('estree-jsx').JSXElement} JSXElement
+ * @typedef {import('estree-jsx').JSXExpressionContainer} JSXExpressionContainer
+ * @typedef {import('estree-jsx').JSXFragment} JSXFragment
+ * @typedef {import('estree-jsx').JSXIdentifier} JSXIdentifier
+ * @typedef {import('estree-jsx').JSXMemberExpression} JSXMemberExpression
+ * @typedef {import('estree-jsx').JSXNamespacedName} JSXNamespacedName
+ * @typedef {import('estree-jsx').JSXOpeningElement} JSXOpeningElement
+ * @typedef {import('estree-jsx').JSXOpeningFragment} JSXOpeningFragment
+ * @typedef {import('estree-jsx').JSXSpreadAttribute} JSXSpreadAttribute
+ * @typedef {import('estree-jsx').JSXText} JSXText
+ * @typedef {import('./types.js').Generator} Generator
+ * @typedef {import('./types.js').State} State
+ */
+
+export const jsx = {
+  JSXAttribute,
+  JSXClosingElement,
+  JSXClosingFragment,
+  JSXElement,
+  JSXEmptyExpression,
+  JSXExpressionContainer,
+  JSXFragment,
+  JSXIdentifier,
+  JSXMemberExpression,
+  JSXNamespacedName,
+  JSXOpeningElement,
+  JSXOpeningFragment,
+  JSXSpreadAttribute,
+  JSXText
+}
+
+/**
+ * `attr`
+ * `attr="something"`
+ * `attr={1}`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXAttribute} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXAttribute(node, state) {
+  this[node.name.type](node.name, state)
+
+  if (node.value !== undefined && node.value !== null) {
+    state.write('=')
+
+    // Encode double quotes in attribute values.
+    if (node.value.type === 'Literal') {
+      state.write(
+        '"' + encodeJsx(String(node.value.value)).replace(/"/g, '"') + '"',
+        node
+      )
+    } else {
+      this[node.value.type](node.value, state)
+    }
+  }
+}
+
+/**
+ * `</div>`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXClosingElement} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXClosingElement(node, state) {
+  state.write('</')
+  this[node.name.type](node.name, state)
+  state.write('>')
+}
+
+/**
+ * `</>`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXClosingFragment} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXClosingFragment(node, state) {
+  state.write('</>', node)
+}
+
+/**
+ * `<div />`
+ * `<div></div>`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXElement} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXElement(node, state) {
+  let index = -1
+
+  this[node.openingElement.type](node.openingElement, state)
+
+  if (node.children) {
+    while (++index < node.children.length) {
+      const child = node.children[index]
+
+      // Supported in types but not by Acorn.
+      /* c8 ignore next 3 */
+      if (child.type === 'JSXSpreadChild') {
+        throw new Error('JSX spread children are not supported')
+      }
+
+      this[child.type](child, state)
+    }
+  }
+
+  if (node.closingElement) {
+    this[node.closingElement.type](node.closingElement, state)
+  }
+}
+
+/**
+ * `{}` (always in a `JSXExpressionContainer`, which does the curlies)
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXEmptyExpression() {}
+
+/**
+ * `{expression}`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXExpressionContainer} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXExpressionContainer(node, state) {
+  state.write('{')
+  this[node.expression.type](node.expression, state)
+  state.write('}')
+}
+
+/**
+ * `<></>`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXFragment} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXFragment(node, state) {
+  let index = -1
+
+  this[node.openingFragment.type](node.openingFragment, state)
+
+  if (node.children) {
+    while (++index < node.children.length) {
+      const child = node.children[index]
+
+      // Supported in types but not by Acorn.
+      /* c8 ignore next 3 */
+      if (child.type === 'JSXSpreadChild') {
+        throw new Error('JSX spread children are not supported')
+      }
+
+      this[child.type](child, state)
+    }
+  }
+
+  this[node.closingFragment.type](node.closingFragment, state)
+}
+
+/**
+ * `div`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXIdentifier} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXIdentifier(node, state) {
+  state.write(node.name, node)
+}
+
+/**
+ * `member.expression`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXMemberExpression} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXMemberExpression(node, state) {
+  this[node.object.type](node.object, state)
+  state.write('.')
+  this[node.property.type](node.property, state)
+}
+
+/**
+ * `ns:name`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXNamespacedName} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXNamespacedName(node, state) {
+  this[node.namespace.type](node.namespace, state)
+  state.write(':')
+  this[node.name.type](node.name, state)
+}
+
+/**
+ * `<div>`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXOpeningElement} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXOpeningElement(node, state) {
+  let index = -1
+
+  state.write('<')
+  this[node.name.type](node.name, state)
+
+  if (node.attributes) {
+    while (++index < node.attributes.length) {
+      state.write(' ')
+      this[node.attributes[index].type](node.attributes[index], state)
+    }
+  }
+
+  state.write(node.selfClosing ? ' />' : '>')
+}
+
+/**
+ * `<>`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXOpeningFragment} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXOpeningFragment(node, state) {
+  state.write('<>', node)
+}
+
+/**
+ * `{...argument}`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXSpreadAttribute} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXSpreadAttribute(node, state) {
+  state.write('{')
+  // eslint-disable-next-line new-cap
+  this.SpreadElement(node, state)
+  state.write('}')
+}
+
+/**
+ * `!`
+ *
+ * @this {Generator}
+ *   `astring` generator.
+ * @param {JSXText} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+function JSXText(node, state) {
+  state.write(
+    encodeJsx(node.value).replace(/[<>{}]/g, ($0) =>
+      $0 === '<'
+        ? '&lt;'
+        : $0 === '>'
+        ? '&gt;'
+        : $0 === '{'
+        ? '&#123;'
+        : '&#125;'
+    ),
+    node
+  )
+}
+
+/**
+ * Make sure that character references don’t pop up.
+ *
+ * For example, the text `&copy;` should stay that way, and not turn into `©`.
+ * We could encode all `&` (easy but verbose) or look for actual valid
+ * references (complex but cleanest output).
+ * Looking for the 2nd character gives us a middle ground.
+ * The `#` is for (decimal and hexadecimal) numeric references, the letters
+ * are for the named references.
+ *
+ * @param {string} value
+ *   Value to encode.
+ * @returns {string}
+ *   Encoded value.
+ */
+function encodeJsx(value) {
+  return value.replace(/&(?=[#a-z])/gi, '&amp;')
+}

node_modules/estree-util-to-js/lib/types.d.ts

@@ -0,0 +1,23 @@
+export type Node = import('estree-jsx').Node
+export type Mapping = import('source-map').Mapping
+export type State = {
+  output: string
+  write: (code: string, node?: Node) => void
+  writeComments: boolean
+  indent: string
+  lineEnd: string
+  indentLevel: number
+  line?: number | undefined
+  column?: number | undefined
+  lineEndSize?: number | undefined
+  mapping?: Mapping | undefined
+}
+export type Generator = Record<Node['type'], Handler>
+/**
+ * Handlers for different nodes.
+ */
+export type Handlers = Partial<Generator>
+/**
+ * Handle a particular node.
+ */
+export type Handler = (this: Generator, node: any, state: State) => void

node_modules/estree-util-to-js/lib/types.js

@@ -0,0 +1,40 @@
+/**
+ * @typedef {import('estree-jsx').Node} Node
+ * @typedef {import('source-map').Mapping} Mapping
+ */
+
+// To do: `astring` types are broken.
+// Either `import('astring').State` if everything is fixed, or:
+// `Omit<import('astring').State, 'write'> & {write: ((code: string, node?: Node) => void)}`
+/**
+ * @typedef State
+ * @property {string} output
+ * @property {(code: string, node?: Node) => void} write
+ * @property {boolean} writeComments
+ * @property {string} indent
+ * @property {string} lineEnd
+ * @property {number} indentLevel
+ * @property {number | undefined} [line]
+ * @property {number | undefined} [column]
+ * @property {number | undefined} [lineEndSize]
+ * @property {Mapping | undefined} [mapping]
+ */
+
+/**
+ * @typedef {Record<Node['type'], Handler>} Generator
+ * @typedef {Partial<Generator>} Handlers
+ *   Handlers for different nodes.
+ *
+ * @callback Handler
+ *  Handle a particular node.
+ * @param {Generator} this
+ *   `astring` generator.
+ * @param {any} node
+ *   Node to serialize.
+ * @param {State} state
+ *   Info passed around.
+ * @returns {void}
+ *   Nothing.
+ */
+
+export {}