Refactor docs

Author: wooorm

readme.md

@@ -62,7 +62,7 @@ internals away.
 ## Install
 
 This package is [ESM only][esm].
-In Node.js (version 14.14+ and 16.0+), install with [npm][]:
+In Node.js (version 16+), install with [npm][]:
 
 ```sh
 npm install mdast-util-mdx-expression
@@ -99,10 +99,10 @@ b {true}.
 ```js
 import fs from 'node:fs/promises'
 import * as acorn from 'acorn'
-import {fromMarkdown} from 'mdast-util-from-markdown'
-import {toMarkdown} from 'mdast-util-to-markdown'
 import {mdxExpression} from 'micromark-extension-mdx-expression'
+import {fromMarkdown} from 'mdast-util-from-markdown'
 import {mdxExpressionFromMarkdown, mdxExpressionToMarkdown} from 'mdast-util-mdx-expression'
+import {toMarkdown} from 'mdast-util-to-markdown'
 
 const doc = await fs.readFile('example.mdx')
 
@@ -208,11 +208,15 @@ MDX expression node, occurring in flow (block) (TypeScript type).
 
 ```ts
 import type {Program} from 'estree-jsx'
-import type {Literal} from 'mdast'
+import type {Data, Literal} from 'mdast'
 
 interface MdxFlowExpression extends Literal {
   type: 'mdxFlowExpression'
-  data?: {estree?: Program | null | undefined} & Literal['data']
+  data?: MdxFlowExpressionData | undefined
+}
+
+interface MdxFlowExpressionData extends Data {
+  estree?: Program | null | undefined
 }
 ```
 
@@ -224,11 +228,15 @@ MDX expression node, occurring in text (block) (TypeScript type).
 
 ```ts
 import type {Program} from 'estree-jsx'
-import type {Literal} from 'mdast'
+import type {Data, Literal} from 'mdast'
 
 interface MdxTextExpression extends Literal {
   type: 'mdxTextExpression'
-  data?: {estree?: Program | null | undefined} & Literal['data']
+  data?: MdxTextExpressionData | undefined
+}
+
+interface MdxTextExpressionData extends Data {
+  estree?: Program | null | undefined
 }
 ```
 
@@ -241,11 +249,15 @@ Same as [`MdxFlowExpression`][api-mdx-flow-expression], but registered with
 
 ```ts
 import type {Program} from 'estree-jsx'
-import type {Literal} from 'hast'
+import type {Data, Literal} from 'hast'
 
 interface MdxFlowExpressionHast extends Literal {
   type: 'mdxFlowExpression'
-  data?: {estree?: Program | null | undefined} & Literal['data']
+  data?: MdxFlowExpressionData | undefined
+}
+
+interface MdxFlowExpressionData extends Data {
+  estree?: Program | null | undefined
 }
 ```
 
@@ -258,11 +270,15 @@ Same as [`MdxTextExpression`][api-mdx-text-expression], but registered with
 
 ```ts
 import type {Program} from 'estree-jsx'
-import type {Literal} from 'hast'
+import type {Data, Literal} from 'hast'
 
 interface MdxTextExpressionHast extends Literal {
   type: 'mdxTextExpression'
-  data?: {estree?: Program | null | undefined} & Literal['data']
+  data?: MdxTextExpressionData | undefined
+}
+
+interface MdxTextExpressionData extends Data {
+  estree?: Program | null | undefined
 }
 ```
 
@@ -288,7 +304,7 @@ The following interfaces are added to **[mdast][]** by this utility.
 
 ```idl
 interface MdxFlowExpression <: Literal {
-  type: "mdxFlowExpression"
+  type: 'mdxFlowExpression'
 }
 ```
 
@@ -315,7 +331,7 @@ Yields:
 
 ```idl
 interface MdxTextExpression <: Literal {
-  type: "mdxTextExpression"
+  type: 'mdxTextExpression"
 }
 ```
 
@@ -379,12 +395,15 @@ visit(tree, function (node) {
 
 ## Compatibility
 
-Projects maintained by the unified collective are compatible with all maintained
+Projects maintained by the unified collective are compatible with maintained
 versions of Node.js.
-As of now, that is Node.js 14.14+ and 16.0+.
-Our projects sometimes work with older versions, but this is not guaranteed.
 
-This plugin works with `mdast-util-from-markdown` version 1+ and
+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,
+`mdast-util-mdx-expression@^1`, compatible with Node.js 12.
+
+This utility works with `mdast-util-from-markdown` version 1+ and
 `mdast-util-to-markdown` version 1+.
 
 ## Related
@@ -424,9 +443,9 @@ abide by its terms.
 
 [downloads]: https://www.npmjs.com/package/mdast-util-mdx-expression
 
-[size-badge]: https://img.shields.io/bundlephobia/minzip/mdast-util-mdx-expression.svg
+[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=mdast-util-mdx-expression
 
-[size]: https://bundlephobia.com/result?p=mdast-util-mdx-expression
+[size]: https://bundlejs.com/?q=mdast-util-mdx-expression
 
 [sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg