deploy: v0.12 fix 存档key名

node_modules/micromark-extension-mdx-expression/dev/index.d.ts

@@ -0,0 +1,63 @@
+import type {Program} from 'estree'
+import type {Acorn, AcornOptions} from 'micromark-util-events-to-acorn'
+
+export {mdxExpression} from './lib/syntax.js'
+
+/**
+ * Configuration (optional).
+ */
+export interface Options {
+  /**
+   * Acorn parser to use (optional).
+   */
+  acorn?: Acorn | null | undefined
+  /**
+   * Configuration for acorn (default: `{ecmaVersion: 2024, locations: true,
+   * sourceType: 'module'}`).
+   *
+   * All fields except `locations` can be set.
+   */
+  acornOptions?: AcornOptions | null | undefined
+  /**
+   * Whether to add `estree` fields to tokens with results from acorn (default:
+   * `false`).
+   */
+  addResult?: boolean | null | undefined
+  /**
+   * Undocumented option to parse only a spread (used by
+   * `micromark-extension-mdx-jsx` to parse spread attributes) (default:
+   * `false`).
+   */
+  spread?: boolean | null | undefined
+  /**
+   * Undocumented option to disallow empty attributes (used by
+   * `micromark-extension-mdx-jsx` to prohobit empty attribute values)
+   * (default: `false`).
+   */
+  allowEmpty?: boolean | null | undefined
+}
+
+/**
+ * Augment types.
+ */
+declare module 'micromark-util-types' {
+  /**
+   * Token fields.
+   */
+  interface Token {
+    estree?: Program
+  }
+
+  /**
+   * Token types.
+   */
+  interface TokenTypeMap {
+    mdxFlowExpression: 'mdxFlowExpression'
+    mdxFlowExpressionMarker: 'mdxFlowExpressionMarker'
+    mdxFlowExpressionChunk: 'mdxFlowExpressionChunk'
+
+    mdxTextExpression: 'mdxTextExpression'
+    mdxTextExpressionMarker: 'mdxTextExpressionMarker'
+    mdxTextExpressionChunk: 'mdxTextExpressionChunk'
+  }
+}

node_modules/micromark-extension-mdx-expression/dev/index.js

@@ -0,0 +1,2 @@
+// Note: types exposed from `index.d.ts`.
+export {mdxExpression} from './lib/syntax.js'

node_modules/micromark-extension-mdx-expression/dev/lib/syntax.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Create an extension for `micromark` to enable MDX expression syntax.
+ *
+ * @param {Options | null | undefined} [options]
+ *   Configuration (optional).
+ * @returns {Extension}
+ *   Extension for `micromark` that can be passed in `extensions` to enable MDX
+ *   expression syntax.
+ */
+export function mdxExpression(options?: Options | null | undefined): Extension;
+import type { Options } from 'micromark-extension-mdx-expression';
+import type { Extension } from 'micromark-util-types';
+//# sourceMappingURL=syntax.d.ts.map

node_modules/micromark-extension-mdx-expression/dev/lib/syntax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.d.ts","sourceRoot":"","sources":["syntax.js"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AACH,wCANW,OAAO,GAAG,IAAI,GAAG,SAAS,GAExB,SAAS,CAqOrB;6BArPyB,oCAAoC;+BAEC,sBAAsB"}

node_modules/micromark-extension-mdx-expression/dev/lib/syntax.js

@@ -0,0 +1,247 @@
+/**
+ * @import {Options} from 'micromark-extension-mdx-expression'
+ * @import {AcornOptions} from 'micromark-util-events-to-acorn'
+ * @import {Extension, State, TokenizeContext, Tokenizer} from 'micromark-util-types'
+ */
+
+import {ok as assert} from 'devlop'
+import {factoryMdxExpression} from 'micromark-factory-mdx-expression'
+import {factorySpace} from 'micromark-factory-space'
+import {markdownLineEnding, markdownSpace} from 'micromark-util-character'
+import {codes, types} from 'micromark-util-symbol'
+
+/**
+ * Create an extension for `micromark` to enable MDX expression syntax.
+ *
+ * @param {Options | null | undefined} [options]
+ *   Configuration (optional).
+ * @returns {Extension}
+ *   Extension for `micromark` that can be passed in `extensions` to enable MDX
+ *   expression syntax.
+ */
+export function mdxExpression(options) {
+  const options_ = options || {}
+  const addResult = options_.addResult
+  const acorn = options_.acorn
+  // Hidden: `micromark-extension-mdx-jsx` supports expressions in tags,
+  // and one of them is only “spread” elements.
+  // It also has expressions that are not allowed to be empty (`<x y={}/>`).
+  // Instead of duplicating code there, this are two small hidden feature here
+  // to test that behavior.
+  const spread = options_.spread
+  let allowEmpty = options_.allowEmpty
+  /** @type {AcornOptions} */
+  let acornOptions
+
+  if (allowEmpty === null || allowEmpty === undefined) {
+    allowEmpty = true
+  }
+
+  if (acorn) {
+    if (!acorn.parseExpressionAt) {
+      throw new Error(
+        'Expected a proper `acorn` instance passed in as `options.acorn`'
+      )
+    }
+
+    acornOptions = Object.assign(
+      {ecmaVersion: 2024, sourceType: 'module'},
+      options_.acornOptions
+    )
+  } else if (options_.acornOptions || options_.addResult) {
+    throw new Error('Expected an `acorn` instance passed in as `options.acorn`')
+  }
+
+  return {
+    flow: {
+      [codes.leftCurlyBrace]: {
+        name: 'mdxFlowExpression',
+        tokenize: tokenizeFlowExpression,
+        concrete: true
+      }
+    },
+    text: {
+      [codes.leftCurlyBrace]: {
+        name: 'mdxTextExpression',
+        tokenize: tokenizeTextExpression
+      }
+    }
+  }
+
+  /**
+   * MDX expression (flow).
+   *
+   * ```markdown
+   * > | {Math.PI}
+   *     ^^^^^^^^^
+   * ```
+   *
+   * @this {TokenizeContext}
+   * @type {Tokenizer}
+   */
+  function tokenizeFlowExpression(effects, ok, nok) {
+    const self = this
+
+    return start
+
+    /**
+     * Start of an MDX expression (flow).
+     *
+     * ```markdown
+     * > | {Math.PI}
+     *     ^
+     * ```
+     *
+     * @type {State}
+     */
+    function start(code) {
+      // To do: in `markdown-rs`, constructs need to parse the indent themselves.
+      // This should also be introduced in `micromark-js`.
+      assert(code === codes.leftCurlyBrace, 'expected `{`')
+      return before(code)
+    }
+
+    /**
+     * After optional whitespace, before expression.
+     *
+     * ```markdown
+     * > | {Math.PI}
+     *     ^
+     * ```
+     *
+     * @type {State}
+     */
+    function before(code) {
+      return factoryMdxExpression.call(
+        self,
+        effects,
+        after,
+        'mdxFlowExpression',
+        'mdxFlowExpressionMarker',
+        'mdxFlowExpressionChunk',
+        acorn,
+        acornOptions,
+        addResult,
+        spread,
+        allowEmpty
+      )(code)
+    }
+
+    /**
+     * After expression.
+     *
+     * ```markdown
+     * > | {Math.PI}
+     *              ^
+     * ```
+     *
+     * @type {State}
+     */
+    function after(code) {
+      return markdownSpace(code)
+        ? factorySpace(effects, end, types.whitespace)(code)
+        : end(code)
+    }
+
+    /**
+     * After expression, after optional whitespace.
+     *
+     * ```markdown
+     * > | {Math.PI}␠␊
+     *               ^
+     * ```
+     *
+     * @type {State}
+     */
+    function end(code) {
+      // We want to allow tags directly after expressions.
+      //
+      // This case is useful:
+      //
+      // ```mdx
+      // <a>{b}</a>
+      // ```
+      //
+      // This case is not (very?) useful:
+      //
+      // ```mdx
+      // {a}<b/>
+      // ```
+      //
+      // …but it would be tougher than needed to disallow.
+      //
+      // To allow that, here we call the flow construct of
+      // `micromark-extension-mdx-jsx`, and there we call this one.
+      //
+      // It would introduce a cyclical interdependency if we test JSX and
+      // expressions here.
+      // Because the JSX extension already uses parts of this monorepo, we
+      // instead test it there.
+      const lessThanValue = self.parser.constructs.flow[codes.lessThan]
+      const constructs = Array.isArray(lessThanValue)
+        ? lessThanValue
+        : /* c8 ignore next 3 -- always a list when normalized. */
+          lessThanValue
+          ? [lessThanValue]
+          : []
+      const jsxTag = constructs.find(function (d) {
+        return d.name === 'mdxJsxFlowTag'
+      })
+
+      /* c8 ignore next 3 -- this is tested in `micromark-extension-mdx-jsx` */
+      if (code === codes.lessThan && jsxTag) {
+        return effects.attempt(jsxTag, end, nok)(code)
+      }
+
+      return code === codes.eof || markdownLineEnding(code)
+        ? ok(code)
+        : nok(code)
+    }
+  }
+
+  /**
+   * MDX expression (text).
+   *
+   * ```markdown
+   * > | a {Math.PI} c.
+   *       ^^^^^^^^^
+   * ```
+   *
+   * @this {TokenizeContext}
+   * @type {Tokenizer}
+   */
+  function tokenizeTextExpression(effects, ok) {
+    const self = this
+
+    return start
+
+    /**
+     * Start of an MDX expression (text).
+     *
+     * ```markdown
+     * > | a {Math.PI} c.
+     *       ^
+     * ```
+     *
+     *
+     * @type {State}
+     */
+    function start(code) {
+      assert(code === codes.leftCurlyBrace, 'expected `{`')
+      return factoryMdxExpression.call(
+        self,
+        effects,
+        ok,
+        'mdxTextExpression',
+        'mdxTextExpressionMarker',
+        'mdxTextExpressionChunk',
+        acorn,
+        acornOptions,
+        addResult,
+        spread,
+        allowEmpty,
+        true
+      )(code)
+    }
+  }
+}

node_modules/micromark-extension-mdx-expression/index.d.ts

@@ -0,0 +1,63 @@
+import type {Program} from 'estree'
+import type {Acorn, AcornOptions} from 'micromark-util-events-to-acorn'
+
+export {mdxExpression} from './lib/syntax.js'
+
+/**
+ * Configuration (optional).
+ */
+export interface Options {
+  /**
+   * Acorn parser to use (optional).
+   */
+  acorn?: Acorn | null | undefined
+  /**
+   * Configuration for acorn (default: `{ecmaVersion: 2024, locations: true,
+   * sourceType: 'module'}`).
+   *
+   * All fields except `locations` can be set.
+   */
+  acornOptions?: AcornOptions | null | undefined
+  /**
+   * Whether to add `estree` fields to tokens with results from acorn (default:
+   * `false`).
+   */
+  addResult?: boolean | null | undefined
+  /**
+   * Undocumented option to parse only a spread (used by
+   * `micromark-extension-mdx-jsx` to parse spread attributes) (default:
+   * `false`).
+   */
+  spread?: boolean | null | undefined
+  /**
+   * Undocumented option to disallow empty attributes (used by
+   * `micromark-extension-mdx-jsx` to prohobit empty attribute values)
+   * (default: `false`).
+   */
+  allowEmpty?: boolean | null | undefined
+}
+
+/**
+ * Augment types.
+ */
+declare module 'micromark-util-types' {
+  /**
+   * Token fields.
+   */
+  interface Token {
+    estree?: Program
+  }
+
+  /**
+   * Token types.
+   */
+  interface TokenTypeMap {
+    mdxFlowExpression: 'mdxFlowExpression'
+    mdxFlowExpressionMarker: 'mdxFlowExpressionMarker'
+    mdxFlowExpressionChunk: 'mdxFlowExpressionChunk'
+
+    mdxTextExpression: 'mdxTextExpression'
+    mdxTextExpressionMarker: 'mdxTextExpressionMarker'
+    mdxTextExpressionChunk: 'mdxTextExpressionChunk'
+  }
+}

node_modules/micromark-extension-mdx-expression/index.js

@@ -0,0 +1,2 @@
+// Note: types exposed from `index.d.ts`.
+export { mdxExpression } from './lib/syntax.js';

node_modules/micromark-extension-mdx-expression/lib/syntax.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Create an extension for `micromark` to enable MDX expression syntax.
+ *
+ * @param {Options | null | undefined} [options]
+ *   Configuration (optional).
+ * @returns {Extension}
+ *   Extension for `micromark` that can be passed in `extensions` to enable MDX
+ *   expression syntax.
+ */
+export function mdxExpression(options?: Options | null | undefined): Extension;
+import type { Options } from 'micromark-extension-mdx-expression';
+import type { Extension } from 'micromark-util-types';
+//# sourceMappingURL=syntax.d.ts.map

node_modules/micromark-extension-mdx-expression/lib/syntax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.d.ts","sourceRoot":"","sources":["syntax.js"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AACH,wCANW,OAAO,GAAG,IAAI,GAAG,SAAS,GAExB,SAAS,CAqOrB;6BArPyB,oCAAoC;+BAEC,sBAAsB"}

node_modules/micromark-extension-mdx-expression/lib/syntax.js

@@ -0,0 +1,201 @@
+/**
+ * @import {Options} from 'micromark-extension-mdx-expression'
+ * @import {AcornOptions} from 'micromark-util-events-to-acorn'
+ * @import {Extension, State, TokenizeContext, Tokenizer} from 'micromark-util-types'
+ */
+
+import { factoryMdxExpression } from 'micromark-factory-mdx-expression';
+import { factorySpace } from 'micromark-factory-space';
+import { markdownLineEnding, markdownSpace } from 'micromark-util-character';
+/**
+ * Create an extension for `micromark` to enable MDX expression syntax.
+ *
+ * @param {Options | null | undefined} [options]
+ *   Configuration (optional).
+ * @returns {Extension}
+ *   Extension for `micromark` that can be passed in `extensions` to enable MDX
+ *   expression syntax.
+ */
+export function mdxExpression(options) {
+  const options_ = options || {};
+  const addResult = options_.addResult;
+  const acorn = options_.acorn;
+  // Hidden: `micromark-extension-mdx-jsx` supports expressions in tags,
+  // and one of them is only “spread” elements.
+  // It also has expressions that are not allowed to be empty (`<x y={}/>`).
+  // Instead of duplicating code there, this are two small hidden feature here
+  // to test that behavior.
+  const spread = options_.spread;
+  let allowEmpty = options_.allowEmpty;
+  /** @type {AcornOptions} */
+  let acornOptions;
+  if (allowEmpty === null || allowEmpty === undefined) {
+    allowEmpty = true;
+  }
+  if (acorn) {
+    if (!acorn.parseExpressionAt) {
+      throw new Error('Expected a proper `acorn` instance passed in as `options.acorn`');
+    }
+    acornOptions = Object.assign({
+      ecmaVersion: 2024,
+      sourceType: 'module'
+    }, options_.acornOptions);
+  } else if (options_.acornOptions || options_.addResult) {
+    throw new Error('Expected an `acorn` instance passed in as `options.acorn`');
+  }
+  return {
+    flow: {
+      [123]: {
+        name: 'mdxFlowExpression',
+        tokenize: tokenizeFlowExpression,
+        concrete: true
+      }
+    },
+    text: {
+      [123]: {
+        name: 'mdxTextExpression',
+        tokenize: tokenizeTextExpression
+      }
+    }
+  };
+
+  /**
+   * MDX expression (flow).
+   *
+   * ```markdown
+   * > | {Math.PI}
+   *     ^^^^^^^^^
+   * ```
+   *
+   * @this {TokenizeContext}
+   * @type {Tokenizer}
+   */
+  function tokenizeFlowExpression(effects, ok, nok) {
+    const self = this;
+    return start;
+
+    /**
+     * Start of an MDX expression (flow).
+     *
+     * ```markdown
+     * > | {Math.PI}
+     *     ^
+     * ```
+     *
+     * @type {State}
+     */
+    function start(code) {
+      // To do: in `markdown-rs`, constructs need to parse the indent themselves.
+      // This should also be introduced in `micromark-js`.
+
+      return before(code);
+    }
+
+    /**
+     * After optional whitespace, before expression.
+     *
+     * ```markdown
+     * > | {Math.PI}
+     *     ^
+     * ```
+     *
+     * @type {State}
+     */
+    function before(code) {
+      return factoryMdxExpression.call(self, effects, after, 'mdxFlowExpression', 'mdxFlowExpressionMarker', 'mdxFlowExpressionChunk', acorn, acornOptions, addResult, spread, allowEmpty)(code);
+    }
+
+    /**
+     * After expression.
+     *
+     * ```markdown
+     * > | {Math.PI}
+     *              ^
+     * ```
+     *
+     * @type {State}
+     */
+    function after(code) {
+      return markdownSpace(code) ? factorySpace(effects, end, "whitespace")(code) : end(code);
+    }
+
+    /**
+     * After expression, after optional whitespace.
+     *
+     * ```markdown
+     * > | {Math.PI}␠␊
+     *               ^
+     * ```
+     *
+     * @type {State}
+     */
+    function end(code) {
+      // We want to allow tags directly after expressions.
+      //
+      // This case is useful:
+      //
+      // ```mdx
+      // <a>{b}</a>
+      // ```
+      //
+      // This case is not (very?) useful:
+      //
+      // ```mdx
+      // {a}<b/>
+      // ```
+      //
+      // …but it would be tougher than needed to disallow.
+      //
+      // To allow that, here we call the flow construct of
+      // `micromark-extension-mdx-jsx`, and there we call this one.
+      //
+      // It would introduce a cyclical interdependency if we test JSX and
+      // expressions here.
+      // Because the JSX extension already uses parts of this monorepo, we
+      // instead test it there.
+      const lessThanValue = self.parser.constructs.flow[60];
+      const constructs = Array.isArray(lessThanValue) ? lessThanValue : /* c8 ignore next 3 -- always a list when normalized. */
+      lessThanValue ? [lessThanValue] : [];
+      const jsxTag = constructs.find(function (d) {
+        return d.name === 'mdxJsxFlowTag';
+      });
+
+      /* c8 ignore next 3 -- this is tested in `micromark-extension-mdx-jsx` */
+      if (code === 60 && jsxTag) {
+        return effects.attempt(jsxTag, end, nok)(code);
+      }
+      return code === null || markdownLineEnding(code) ? ok(code) : nok(code);
+    }
+  }
+
+  /**
+   * MDX expression (text).
+   *
+   * ```markdown
+   * > | a {Math.PI} c.
+   *       ^^^^^^^^^
+   * ```
+   *
+   * @this {TokenizeContext}
+   * @type {Tokenizer}
+   */
+  function tokenizeTextExpression(effects, ok) {
+    const self = this;
+    return start;
+
+    /**
+     * Start of an MDX expression (text).
+     *
+     * ```markdown
+     * > | a {Math.PI} c.
+     *       ^
+     * ```
+     *
+     *
+     * @type {State}
+     */
+    function start(code) {
+      return factoryMdxExpression.call(self, effects, ok, 'mdxTextExpression', 'mdxTextExpressionMarker', 'mdxTextExpressionChunk', acorn, acornOptions, addResult, spread, allowEmpty, true)(code);
+    }
+  }
+}

node_modules/micromark-extension-mdx-expression/license

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) Titus Wormer <tituswormer@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

node_modules/micromark-extension-mdx-expression/package.json

@@ -0,0 +1,96 @@
+{
+  "author": "Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)",
+  "bugs": "https://github.com/micromark/micromark-extension-mdx-expression/issues",
+  "contributors": [
+    "Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)"
+  ],
+  "dependencies": {
+    "@types/estree": "^1.0.0",
+    "devlop": "^1.0.0",
+    "micromark-factory-mdx-expression": "^2.0.0",
+    "micromark-factory-space": "^2.0.0",
+    "micromark-util-character": "^2.0.0",
+    "micromark-util-events-to-acorn": "^2.0.0",
+    "micromark-util-symbol": "^2.0.0",
+    "micromark-util-types": "^2.0.0"
+  },
+  "description": "micromark extension to support MDX or MDX JS expressions",
+  "exports": {
+    "development": "./dev/index.js",
+    "default": "./index.js"
+  },
+  "files": [
+    "dev/",
+    "index.d.ts",
+    "index.js",
+    "lib/"
+  ],
+  "funding": [
+    {
+      "type": "GitHub Sponsors",
+      "url": "https://github.com/sponsors/unifiedjs"
+    },
+    {
+      "type": "OpenCollective",
+      "url": "https://opencollective.com/unified"
+    }
+  ],
+  "keywords": [
+    "ecmascript",
+    "es",
+    "expression",
+    "javascript",
+    "js",
+    "markdown",
+    "mdxjs",
+    "mdx",
+    "micromark-extension",
+    "micromark",
+    "unified"
+  ],
+  "license": "MIT",
+  "name": "micromark-extension-mdx-expression",
+  "repository": "https://github.com/micromark/micromark-extension-mdx-expression/tree/main/packages/micromark-extension-mdx-expression",
+  "scripts": {
+    "build": "micromark-build"
+  },
+  "sideEffects": false,
+  "typeCoverage": {
+    "atLeast": 100,
+    "strict": true
+  },
+  "type": "module",
+  "version": "3.0.1",
+  "xo": {
+    "overrides": [
+      {
+        "files": [
+          "**/*.d.ts"
+        ],
+        "rules": {
+          "@typescript-eslint/array-type": [
+            "error",
+            {
+              "default": "generic"
+            }
+          ],
+          "@typescript-eslint/ban-types": [
+            "error",
+            {
+              "extendDefaults": true
+            }
+          ],
+          "@typescript-eslint/consistent-type-definitions": [
+            "error",
+            "interface"
+          ]
+        }
+      }
+    ],
+    "prettier": true,
+    "rules": {
+      "logical-assignment-operators": "off",
+      "unicorn/no-this-assignment": "off"
+    }
+  }
+}

node_modules/micromark-extension-mdx-expression/readme.md

@@ -0,0 +1,433 @@
+# micromark-extension-mdx-expression
+
+[![Build][build-badge]][build]
+[![Coverage][coverage-badge]][coverage]
+[![Downloads][downloads-badge]][downloads]
+[![Size][size-badge]][size]
+[![Sponsors][sponsors-badge]][collective]
+[![Backers][backers-badge]][collective]
+[![Chat][chat-badge]][chat]
+
+[micromark][] extension to support [MDX][mdxjs] expressions (`{Math.PI}`).
+
+## Contents
+
+* [What is this?](#what-is-this)
+* [When to use this](#when-to-use-this)
+* [Install](#install)
+* [Use](#use)
+* [API](#api)
+  * [`mdxExpression(options?)`](#mdxexpressionoptions)
+  * [Options](#options)
+* [Authoring](#authoring)
+* [Syntax](#syntax)
+* [Errors](#errors)
+  * [Unexpected end of file in expression, expected a corresponding closing brace for `{`](#unexpected-end-of-file-in-expression-expected-a-corresponding-closing-brace-for-)
+  * [Unexpected lazy line in expression in container, expected line to be prefixed…](#unexpected-lazy-line-in-expression-in-container-expected-line-to-be-prefixed)
+  * [Unexpected `$type` in code: expected an object spread (`{...spread}`)](#unexpected-type-in-code-expected-an-object-spread-spread)
+  * [Unexpected extra content in spread: only a single spread is supported](#unexpected-extra-content-in-spread-only-a-single-spread-is-supported)
+  * [Could not parse expression with acorn](#could-not-parse-expression-with-acorn)
+* [Tokens](#tokens)
+* [Types](#types)
+* [Compatibility](#compatibility)
+* [Security](#security)
+* [Related](#related)
+* [Contribute](#contribute)
+* [License](#license)
+
+## What is this?
+
+This package contains an extension that adds support for the expression syntax
+enabled by [MDX][mdxjs] to [`micromark`][micromark].
+These extensions are used inside MDX.
+
+This package can be made aware or unaware of JavaScript syntax.
+When unaware, expressions could include Rust or variables or whatnot.
+
+## When to use this
+
+This project is useful when you want to support expressions in markdown.
+
+You can use this extension when you are working with [`micromark`][micromark].
+To support all MDX features, use
+[`micromark-extension-mdxjs`][micromark-extension-mdxjs] instead.
+
+When you need a syntax tree, combine this package with
+[`mdast-util-mdx-expression`][mdast-util-mdx-expression].
+
+All these packages are used in [`remark-mdx`][remark-mdx], which focusses on
+making it easier to transform content by abstracting these internals away.
+
+When you are using [`mdx-js/mdx`][mdxjs], all of this is already included.
+
+## Install
+
+This package is [ESM only][esm].
+In Node.js (version 16+), install with [npm][]:
+
+```sh
+npm install micromark-extension-mdx-expression
+```
+
+In Deno with [`esm.sh`][esmsh]:
+
+```js
+import {mdxExpression} from 'https://esm.sh/micromark-extension-mdx-expression@2'
+```
+
+In browsers with [`esm.sh`][esmsh]:
+
+```html
+<script type="module">
+  import {mdxExpression} from 'https://esm.sh/micromark-extension-mdx-expression@2?bundle'
+</script>
+```
+
+## Use
+
+```js
+import {Parser} from 'acorn'
+import acornJsx from 'acorn-jsx'
+import {micromark} from 'micromark'
+import {mdxExpression} from 'micromark-extension-mdx-expression'
+
+// Unaware of JavaScript (“agnostic”) (balanced braces):
+const output = micromark('a {1 + 1} b', {extensions: [mdxExpression()]})
+
+console.log(output)
+
+// Aware of JavaScript:
+micromark('a {!} b', {extensions: [mdxExpression({acorn: Parser.extend(acornJsx())})]})
+```
+
+Yields:
+
+```html
+<p>a  b</p>
+```
+
+```text
+[1:5: Could not parse expression with acorn] {
+  ancestors: undefined,
+  cause: SyntaxError: Unexpected token
+      at pp$4.raise (file:///Users/tilde/Projects/oss/micromark-extension-mdx-expression/node_modules/acorn/dist/acorn.mjs:3547:13)
+      at pp$9.unexpected (file:///Users/tilde/Projects/oss/micromark-extension-mdx-expression/node_modules/acorn/dist/acorn.mjs:758:8)
+      …
+    pos: 4,
+    loc: { line: 1, column: 4 },
+    raisedAt: 1
+  },
+  column: 5,
+  fatal: undefined,
+  line: 1,
+  place: { line: 1, column: 5, offset: 4 },
+  reason: 'Could not parse expression with acorn',
+  ruleId: 'acorn',
+  source: 'micromark-extension-mdx-expression',
+  url: 'https://github.com/micromark/micromark-extension-mdx-expression/tree/main/packages/micromark-extension-mdx-expression#could-not-parse-expression-with-acorn'
+}
+```
+
+…which is useless: go to a syntax tree with
+[`mdast-util-from-markdown`][mdast-util-from-markdown] and
+[`mdast-util-mdx-expression`][mdast-util-mdx-expression] instead.
+
+## API
+
+This package exports the identifier [`mdxExpression`][api-mdx-expression].
+There is no default export.
+
+The export map supports the [`development` condition][development].
+Run `node --conditions development module.js` to get instrumented dev code.
+Without this condition, production code is loaded.
+
+### `mdxExpression(options?)`
+
+Create an extension for `micromark` to enable MDX expression syntax.
+
+###### Parameters
+
+* `options` ([`Options`][api-options], optional)
+  — configuration
+
+###### Returns
+
+Extension for `micromark` that can be passed in `extensions` to enable MDX
+expression syntax ([`Extension`][micromark-extension]).
+
+### Options
+
+Configuration (TypeScript type).
+
+###### Fields
+
+* `acorn` ([`Acorn`][acorn], optional)
+  — acorn parser to use
+* `acornOptions` ([`AcornOptions`][acorn-options], default:
+  `{ecmaVersion: 2024, locations: true, sourceType: 'module'}`)
+  — configuration for acorn; all fields except `locations` can be set
+* `addResult` (`boolean`, default: `false`)
+  — whether to add `estree` fields to tokens with results from acorn
+
+<!-- Note: `spread` and `allowEmpty` are intentionally not documented. -->
+
+## Authoring
+
+When authoring markdown with JavaScript, keep in mind that MDX is a whitespace
+sensitive and line-based language, while JavaScript is insensitive to
+whitespace.
+This affects how markdown and JavaScript interleave with eachother in MDX.
+For more info on how it works, see [§ Interleaving][mdxjs-interleaving] on the
+MDX site.
+
+## Syntax
+
+This extension supports MDX both aware and unaware to JavaScript (respectively
+gnostic and agnostic).
+Depending on whether acorn is passed, either valid JavaScript must be used in
+expressions, or arbitrary text (such as Rust code or so) can be used.
+
+There are two types of expressions: in text (inline, span) or in flow (block).
+They start with `{`.
+
+Depending on whether `acorn` is passed, expressions are either parsed in several
+tries until whole JavaScript is found (as in, nested curly braces depend on JS
+expression nesting), or they are counted and must be balanced.
+
+Expressions end with `}`.
+
+For flow (block) expressions, optionally markdown spaces (` ` or `\t`) can occur
+after the closing brace, and finally a markdown line ending (`\r`, `\n`) or the
+end of the file must follow.
+
+While markdown typically knows no errors, for MDX it is decided to instead
+throw on invalid syntax.
+
+```mdx
+Here is an expression in a heading:
+
+## Hello, {1 + 1}!
+
+In agnostic mode, balanced braces can occur: {a + {b} + c}.
+
+In gnostic mode, the value of the expression must be JavaScript, so
+this would fail: {!}.
+But, in gnostic mode, braces can be in comments, strings, or in other
+places: {1 /* { */ + 2}.
+
+The previous examples were text (inline, span) expressions, they can
+also be flow (block):
+
+{
+  1 + 1
+}
+
+This is incorrect, because there are further characters:
+
+{
+  1 + 1
+}!
+```
+
+```mdx-invalid
+Blank lines cannot occur in text, because markdown has already split them in
+separate constructs, so this is incorrect: {1 +
+
+1}
+```
+
+```mdx
+In flow, you can have blank lines:
+
+{
+  1 +
+
+  2
+}
+```
+
+## Errors
+
+### Unexpected end of file in expression, expected a corresponding closing brace for `{`
+
+This error occurs if a `{` was seen without a `}` (source:
+`micromark-extension-mdx-expression`, rule id: `unexpected-eof`).
+For example:
+
+```mdx-invalid
+a { b
+```
+
+### Unexpected lazy line in expression in container, expected line to be prefixed…
+
+This error occurs if a `{` was seen in a container which then has lazy content
+(source: `micromark-extension-mdx-expression`, rule id: `unexpected-lazy`).
+For example:
+
+```mdx-invalid
+> {a
+b}
+```
+
+### Unexpected `$type` in code: expected an object spread (`{...spread}`)
+
+This error occurs if a spread was expected but something else was found
+(source: `micromark-extension-mdx-expression`, rule id: `non-spread`).
+For example:
+
+```mdx-invalid
+<a {b=c}={} d>
+```
+
+### Unexpected extra content in spread: only a single spread is supported
+
+This error occurs if a spread was expected but more was found after it
+(source: `micromark-extension-mdx-expression`, rule id: `spread-extra`).
+For example:
+
+```mdx-invalid
+<a {...b,c} d>
+```
+
+### Could not parse expression with acorn
+
+This error occurs if acorn crashes or when there is more content after a JS
+expression (source: `micromark-extension-mdx-expression`, rule id: `acorn`).
+For example:
+
+```mdx-invalid
+a {"b" "c"} d
+```
+
+```mdx-invalid
+a {var b = "c"} d
+```
+
+## Tokens
+
+Two tokens are used, `mdxFlowExpression` and `mdxTextExpression`, to reflect
+flow and text expressions.
+
+They include:
+
+* `lineEnding` for the markdown line endings `\r`, `\n`, and `\r\n`
+* `mdxFlowExpressionMarker` and `mdxTextExpressionMarker` for the braces
+* `whitespace` for markdown spaces and tabs in blank lines
+* `mdxFlowExpressionChunk` and `mdxTextExpressionChunk` for chunks of
+  expression content
+
+## Types
+
+This package is fully typed with [TypeScript][].
+It exports the additional type [`Options`][api-options].
+
+## Compatibility
+
+Projects maintained by the unified collective are compatible with maintained
+versions of Node.js.
+
+When we cut a new major release, we drop support for unmaintained versions of
+Node.
+This means we try to keep the current release line,
+`micromark-extension-mdx-expression@^2`, compatible with Node.js 16.
+
+This package works with `micromark` version `3` and later.
+
+## Security
+
+This package is safe.
+
+## Related
+
+* [`micromark-extension-mdxjs`][micromark-extension-mdxjs]
+  — support all MDX syntax
+* [`mdast-util-mdx-expression`][mdast-util-mdx-expression]
+  — support MDX expressions in mdast
+* [`remark-mdx`][remark-mdx]
+  — support all MDX syntax in remark
+
+## Contribute
+
+See [`contributing.md` in `micromark/.github`][contributing] for ways to get
+started.
+See [`support.md`][support] for ways to get help.
+
+This project has a [code of conduct][coc].
+By interacting with this repository, organization, or community you agree to
+abide by its terms.
+
+## License
+
+[MIT][license] © [Titus Wormer][author]
+
+<!-- Definitions -->
+
+[acorn]: https://github.com/acornjs/acorn
+
+[acorn-options]: https://github.com/acornjs/acorn/blob/96c721dbf89d0ccc3a8c7f39e69ef2a6a3c04dfa/acorn/dist/acorn.d.ts#L16
+
+[api-mdx-expression]: #mdxexpressionoptions
+
+[api-options]: #options
+
+[author]: https://wooorm.com
+
+[backers-badge]: https://opencollective.com/unified/backers/badge.svg
+
+[build]: https://github.com/micromark/micromark-extension-mdx-expression/actions
+
+[build-badge]: https://github.com/micromark/micromark-extension-mdx-expression/workflows/main/badge.svg
+
+[chat]: https://github.com/micromark/micromark/discussions
+
+[chat-badge]: https://img.shields.io/badge/chat-discussions-success.svg
+
+[coc]: https://github.com/micromark/.github/blob/main/code-of-conduct.md
+
+[collective]: https://opencollective.com/unified
+
+[contributing]: https://github.com/micromark/.github/blob/main/contributing.md
+
+[coverage]: https://codecov.io/github/micromark/micromark-extension-mdx-expression
+
+[coverage-badge]: https://img.shields.io/codecov/c/github/micromark/micromark-extension-mdx-expression.svg
+
+[development]: https://nodejs.org/api/packages.html#packages_resolving_user_conditions
+
+[downloads]: https://www.npmjs.com/package/micromark-extension-mdx-expression
+
+[downloads-badge]: https://img.shields.io/npm/dm/micromark-extension-mdx-expression.svg
+
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
+[esmsh]: https://esm.sh
+
+[license]: https://github.com/micromark/micromark-extension-mdx-expression/blob/main/license
+
+[mdast-util-from-markdown]: https://github.com/syntax-tree/mdast-util-from-markdown
+
+[mdast-util-mdx-expression]: https://github.com/syntax-tree/mdast-util-mdx-expression
+
+[mdxjs]: https://mdxjs.com
+
+[mdxjs-interleaving]: https://mdxjs.com/docs/what-is-mdx/#interleaving
+
+[micromark]: https://github.com/micromark/micromark
+
+[micromark-extension]: https://github.com/micromark/micromark#syntaxextension
+
+[micromark-extension-mdxjs]: https://github.com/micromark/micromark-extension-mdxjs
+
+[npm]: https://docs.npmjs.com/cli/install
+
+[remark-mdx]: https://mdxjs.com/packages/remark-mdx/
+
+[size]: https://bundlejs.com/?q=micromark-extension-mdx-expression
+
+[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=micromark-extension-mdx-expression
+
+[sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg
+
+[support]: https://github.com/micromark/.github/blob/main/support.md
+
+[typescript]: https://www.typescriptlang.org