Update readmes

packages/hast-util-from-string/readme.md

@@ -16,12 +16,19 @@ The given node is returned.
 
 ## Install
 
+This package is [ESM only][esm]:
+Node 12+ is needed to use it and it must be `imported`ed instead of `required`d.
+
 [npm][]:
 
 ```sh
 npm install hast-util-from-string
 ```
 
+This package exports the following identifiers:
+`fromString`.
+There is no default export.
+
 ## Use
 
 ```js
@@ -90,6 +97,8 @@ abide by its terms.
 
 [chat]: https://github.com/rehypejs/rehype/discussions
 
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
 [npm]: https://docs.npmjs.com/cli/install
 
 [health]: https://github.com/rehypejs/.github

packages/hast-util-is-body-ok-link/readme.md

@@ -14,12 +14,19 @@ Check if a `link` element is “Body OK”.
 
 ## Install
 
+This package is [ESM only][esm]:
+Node 12+ is needed to use it and it must be `imported`ed instead of `required`d.
+
 [npm][]:
 
 ```sh
 npm install hast-util-is-body-ok-link
 ```
 
+This package exports the following identifiers:
+`isBodyOkLink`.
+There is no default export.
+
 ## Use
 
 ```js
@@ -79,6 +86,8 @@ abide by its terms.
 
 [chat]: https://github.com/rehypejs/rehype/discussions
 
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
 [npm]: https://docs.npmjs.com/cli/install
 
 [health]: https://github.com/rehypejs/.github

packages/hast-util-is-conditional-comment/readme.md

@@ -14,12 +14,19 @@ Check if a node is a conditional comment.
 
 ## Install
 
+This package is [ESM only][esm]:
+Node 12+ is needed to use it and it must be `imported`ed instead of `required`d.
+
 [npm][]:
 
 ```sh
 npm install hast-util-is-conditional-comment
 ```
 
+This package exports the following identifiers:
+`isConditionalComment`.
+There is no default export.
+
 ## Use
 
 ```js
@@ -78,6 +85,8 @@ abide by its terms.
 
 [chat]: https://github.com/rehypejs/rehype/discussions
 
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
 [npm]: https://docs.npmjs.com/cli/install
 
 [health]: https://github.com/rehypejs/.github

packages/hast-util-is-css-link/index.js

@@ -15,7 +15,7 @@
  *
  *   ## API
  *
- *   ### `isCSSLink(node)`
+ *   ### `isCssLink(node)`
  *
  *   Return `true` if `node` is a `<link>` element with a `rel` list that
  *   contains `'stylesheet'` and has no `type`, an empty `type`, or `'text/css'`

packages/hast-util-is-css-link/readme.md

@@ -14,12 +14,19 @@ Check if an element is a CSS link.
 
 ## Install
 
+This package is [ESM only][esm]:
+Node 12+ is needed to use it and it must be `imported`ed instead of `required`d.
+
 [npm][]:
 
 ```sh
 npm install hast-util-is-css-link
 ```
 
+This package exports the following identifiers:
+`isCssLink`.
+There is no default export.
+
 ## Use
 
 ```js
@@ -33,7 +40,7 @@ isCssLink(h('link', {rel: ['stylesheet'], type: 'text/foo'})) //=> false
 
 ## API
 
-### `isCSSLink(node)`
+### `isCssLink(node)`
 
 Return `true` if `node` is a `<link>` element with a `rel` list that
 contains `'stylesheet'` and has no `type`, an empty `type`, or `'text/css'`
@@ -79,6 +86,8 @@ abide by its terms.
 
 [chat]: https://github.com/rehypejs/rehype/discussions
 
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
 [npm]: https://docs.npmjs.com/cli/install
 
 [health]: https://github.com/rehypejs/.github

packages/hast-util-is-css-style/readme.md

@@ -14,12 +14,19 @@ Check if an element is a CSS `<style>` element.
 
 ## Install
 
+This package is [ESM only][esm]:
+Node 12+ is needed to use it and it must be `imported`ed instead of `required`d.
+
 [npm][]:
 
 ```sh
 npm install hast-util-is-css-style
 ```
 
+This package exports the following identifiers:
+`isCssStyle`.
+There is no default export.
+
 ## Use
 
 ```js
@@ -78,6 +85,8 @@ abide by its terms.
 
 [chat]: https://github.com/rehypejs/rehype/discussions
 
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
 [npm]: https://docs.npmjs.com/cli/install
 
 [health]: https://github.com/rehypejs/.github

packages/hast-util-is-event-handler/readme.md

@@ -14,12 +14,19 @@ Check if a property is an event handler.
 
 ## Install
 
+This package is [ESM only][esm]:
+Node 12+ is needed to use it and it must be `imported`ed instead of `required`d.
+
 [npm][]:
 
 ```sh
 npm install hast-util-is-event-handler
 ```
 
+This package exports the following identifiers:
+`isEventHandler`.
+There is no default export.
+
 ## Use
 
 ```js
@@ -78,6 +85,8 @@ abide by its terms.
 
 [chat]: https://github.com/rehypejs/rehype/discussions
 
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
 [npm]: https://docs.npmjs.com/cli/install
 
 [health]: https://github.com/rehypejs/.github

packages/hast-util-is-javascript/readme.md

@@ -14,12 +14,19 @@ Check if an element is a JavaScript script.
 
 ## Install
 
+This package is [ESM only][esm]:
+Node 12+ is needed to use it and it must be `imported`ed instead of `required`d.
+
 [npm][]:
 
 ```sh
 npm install hast-util-is-javascript
 ```
 
+This package exports the following identifiers:
+`isJavaScript`.
+There is no default export.
+
 ## Use
 
 ```js
@@ -80,6 +87,8 @@ abide by its terms.
 
 [chat]: https://github.com/rehypejs/rehype/discussions
 
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
 [npm]: https://docs.npmjs.com/cli/install
 
 [health]: https://github.com/rehypejs/.github

packages/hast-util-to-string/readme.md

@@ -14,12 +14,19 @@ Get the plain-text value of a hast node.
 
 ## Install
 
+This package is [ESM only][esm]:
+Node 12+ is needed to use it and it must be `imported`ed instead of `required`d.
+
 [npm][]:
 
 ```sh
 npm install hast-util-to-string
 ```
 
+This package exports the following identifiers:
+`toString`.
+There is no default export.
+
 ## Use
 
 ```js
@@ -78,6 +85,8 @@ abide by its terms.
 
 [chat]: https://github.com/rehypejs/rehype/discussions
 
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
 [npm]: https://docs.npmjs.com/cli/install
 
 [health]: https://github.com/rehypejs/.github

packages/html-url-attributes/index.js

@@ -1,3 +1,25 @@
+/**
+ * @fileoverview
+ *   Map of URL attributes in HTML
+ * @longdescription
+ *   ## Use
+ *
+ *   ```js
+ *   import {urlAttributes} from 'html-url-attributes'
+ *
+ *   urlAttributes.formAction
+ *   //=> ['button', 'input']
+ *   urlAttributes.href
+ *   //=> ['a', 'area', 'base', 'link']
+ *   ```
+ *
+ *   ## API
+ *
+ *   ### `urlAttributes`
+ *
+ *   Map of URL attributes in HTML (`Record<string, string[]>`).
+ */
+
 export const urlAttributes = {
   action: ['form'],
   cite: ['blockquote', 'del', 'ins', 'q'],

packages/html-url-attributes/readme.md

@@ -14,12 +14,36 @@ Map of URL attributes in HTML.
 
 ## Install
 
+This package is [ESM only][esm]:
+Node 12+ is needed to use it and it must be `imported`ed instead of `required`d.
+
 [npm][]:
 
 ```sh
 npm install html-url-attributes
 ```
 
+This package exports the following identifiers:
+`urlAttributes`.
+There is no default export.
+
+## Use
+
+```js
+import {urlAttributes} from 'html-url-attributes'
+
+urlAttributes.formAction
+//=> ['button', 'input']
+urlAttributes.href
+//=> ['a', 'area', 'base', 'link']
+```
+
+## API
+
+### `urlAttributes`
+
+Map of URL attributes in HTML (`Record<string, string[]>`).
+
 ## Contribute
 
 See [`contributing.md`][contributing] in [`rehypejs/.github`][health] for ways
@@ -60,6 +84,8 @@ abide by its terms.
 
 [chat]: https://github.com/rehypejs/rehype/discussions
 
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
 [npm]: https://docs.npmjs.com/cli/install
 
 [health]: https://github.com/rehypejs/.github

packages/html-whitespace-sensitive-tag-names/index.js

@@ -1,3 +1,23 @@
+/**
+ * @fileoverview
+ *   List of whitespace sensitive HTML tag names
+ * @longdescription
+ *   ## Use
+ *
+ *   ```js
+ *   import {whitespaceSensitiveTagNames} from 'html-whitespace-sensitive-tag-names'
+ *
+ *   whitespaceSensitiveTagNames
+ *   //=> ['pre', 'script', 'style', 'textarea']
+ *   ```
+ *
+ *   ## API
+ *
+ *   ### `whitespaceSensitiveTagNames`
+ *
+ *   List of whitespace sensitive HTML tag names (`string[]`).
+ */
+
 export const whitespaceSensitiveTagNames = [
   'pre',
   'script',

packages/html-whitespace-sensitive-tag-names/readme.md

@@ -14,12 +14,34 @@ List of whitespace sensitive HTML tag names.
 
 ## Install
 
+This package is [ESM only][esm]:
+Node 12+ is needed to use it and it must be `imported`ed instead of `required`d.
+
 [npm][]:
 
 ```sh
 npm install html-whitespace-sensitive-tag-names
 ```
 
+This package exports the following identifiers:
+`whitespaceSensitiveTagNames`.
+There is no default export.
+
+## Use
+
+```js
+import {whitespaceSensitiveTagNames} from 'html-whitespace-sensitive-tag-names'
+
+whitespaceSensitiveTagNames
+//=> ['pre', 'script', 'style', 'textarea']
+```
+
+## API
+
+### `whitespaceSensitiveTagNames`
+
+List of whitespace sensitive HTML tag names (`string[]`).
+
 ## Contribute
 
 See [`contributing.md`][contributing] in [`rehypejs/.github`][health] for ways
@@ -60,6 +82,8 @@ abide by its terms.
 
 [chat]: https://github.com/rehypejs/rehype/discussions
 
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
 [npm]: https://docs.npmjs.com/cli/install
 
 [health]: https://github.com/rehypejs/.github