.

Author: wooorm

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

.github/workflows/bb.yml

@@ -0,0 +1,13 @@
+name: bb
+on:
+  issues:
+    types: [opened, reopened, edited, closed, labeled, unlabeled]
+  pull_request_target:
+    types: [opened, reopened, edited, closed, labeled, unlabeled]
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: unifiedjs/beep-boop-beta@main
+        with:
+          repo-token: ${{secrets.GITHUB_TOKEN}}

.github/workflows/main.yml

@@ -0,0 +1,21 @@
+name: main
+on:
+  - pull_request
+  - push
+jobs:
+  main:
+    name: ${{matrix.node}}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: dcodeIO/setup-node-nvm@master
+        with:
+          node-version: ${{matrix.node}}
+      - run: npm install
+      - run: npm test
+      - uses: codecov/codecov-action@v1
+    strategy:
+      matrix:
+        node:
+          - lts/erbium
+          - node

.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+*.d.ts
+*.log
+coverage/
+node_modules/
+yarn.lock

.npmrc

@@ -0,0 +1 @@
+package-lock=false

.prettierignore

@@ -0,0 +1,2 @@
+coverage/
+*.md

index.js

@@ -0,0 +1,9 @@
+/**
+ * @typedef {import('./lib/index.js').Options} Options
+ * @typedef {import('./lib/types.js').Handler} Handler
+ * @typedef {import('./lib/types.js').Handlers} Handlers
+ * @typedef {import('./lib/types.js').State} State
+ */
+
+export {toJs} from './lib/index.js'
+export {jsx} from './lib/jsx.js'

lib/index.js

@@ -0,0 +1,108 @@
+/**
+ * @typedef {import('estree-jsx').Program} Program
+ * @typedef {typeof import('source-map').SourceMapGenerator} SourceMapGenerator
+ * @typedef {import('./types.js').Handlers} Handlers
+ *
+ * @typedef BaseFields
+ * @property {Handlers} [handlers]
+ *   Object mapping node types to functions handling the corresponding nodes.
+ *
+ * @typedef SourceMapFieldsWithoutSourceMapGenerator
+ * @property {undefined} [SourceMapGenerator]
+ *   Generate a source map by passing a `SourceMapGenerator` from `source-map`
+ *   in.
+ * @property {undefined} [filePath]
+ *   Path to input file.
+ *
+ * @typedef SourceMapFieldsWithSourceMapGenerator
+ * @property {SourceMapGenerator} SourceMapGenerator
+ *   Generate a source map by passing a `SourceMapGenerator` from `source-map`
+ *   in.
+ * @property {string} [filePath]
+ *   Path to input file.
+ *
+ * @typedef {BaseFields & SourceMapFieldsWithoutSourceMapGenerator} OptionsWithoutSourceMapGenerator
+ * @typedef {BaseFields & SourceMapFieldsWithSourceMapGenerator} OptionsWithSourceMapGenerator
+ *
+ * @typedef {OptionsWithoutSourceMapGenerator|OptionsWithSourceMapGenerator} Options
+ *   Configuration (optional).
+ *
+ * @typedef Map
+ *   Raw source map, see:
+ *   <https://github.com/mozilla/source-map/blob/58819f0/source-map.d.ts#L15-L23>.
+ * @property {number} version
+ * @property {Array<string>} sources
+ * @property {Array<string>} names
+ * @property {string|undefined} [sourceRoot]
+ * @property {Array<string>|undefined} [sourcesContent]
+ * @property {string} mappings
+ * @property {string} file
+ *
+ * @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 passed.
+ *
+ * @typedef ResultFieldsRegardlessOfSourceMapGenerator
+ * @property {Map|undefined} map
+ *   Source map as (parsed) JSON, if `SourceMapGenerator` is passed.
+ *
+ * @typedef {BaseResultFields & ResultFieldsWithoutSourceMapGenerator} ResultWithoutSourceMapGenerator
+ * @typedef {BaseResultFields & ResultFieldsWithSourceMapGenerator} ResultWithSourceMapGenerator
+ * @typedef {BaseResultFields & ResultFieldsRegardlessOfSourceMapGenerator} ResultRegardlessOfSourceMapGenerator
+ *
+ * @typedef {ResultRegardlessOfSourceMapGenerator} Result
+ */
+
+import {GENERATOR, generate} from 'astring'
+
+/**
+ * Estree (and esast) utility to serialize estrees as JavaScript.
+ *
+ * @param value
+ *   Estree (esast).
+ * @param options
+ *   Configuration (optional).
+ * @returns
+ *   An object with two fields:
+ *   *   `value` (`string`) — serialized JavaScript
+ *   *   `map` (`Object?`) — source map as (parsed) JSON, if
+ *       `SourceMapGenerator` is passed
+ */
+export const toJs =
+  /**
+   * @type {(
+   *   ((value: Program, options: OptionsWithSourceMapGenerator) => ResultWithSourceMapGenerator) &
+   *   ((value: Program, options?: OptionsWithoutSourceMapGenerator) => ResultWithoutSourceMapGenerator)
+   * )}
+   */
+  (
+    /**
+     * @param {Program} tree
+     * @param {Options} [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,
+        // @ts-expect-error: `generator` is fine!
+        generator: {...GENERATOR, ...handlers},
+        sourceMap
+      })
+      const map = sourceMap ? sourceMap.toJSON() : undefined
+
+      return {value, map}
+    }
+  )