Refactor code-style

*   Add more docs to JSDoc

Author: wooorm

index.js

@@ -1,6 +1,10 @@
 /**
  * @typedef {import('hast').Root} Root
- * @typedef {Root['children'][number]|Root} Node
+ * @typedef {import('hast').Content} Content
+ */
+
+/**
+ * @typedef {Root | Content} Node
  */
 
 import {hasProperty} from 'hast-util-has-property'
@@ -18,8 +22,23 @@ const alwaysInteractive = new Set([
 ])
 
 /**
+ * Check if the given value is *interactive content*.
+ *
  * @param {Node} node
+ *   Node to check.
  * @returns {boolean}
+ *   Whether `node` is an `Element` that is classified as *interactive
+ *   content*.
+ *
+ *   The following elements are interactive:
+ *
+ *   * `a` with `href`
+ *   * `audio` or `video` with `controls`
+ *   * `img` or `object` with `useMap`
+ *   * `input` without `hidden`
+ *   * any element with a `tabIndex`
+ *   * the elements `button`, `details`, `embed`, `iframe`, `keygen`, `label`,
+ *      `select`, and `textarea`
  */
 export function interactive(node) {
   if (!node || typeof node !== 'object' || node.type !== 'element') {

readme.md

@@ -100,8 +100,18 @@ Check if the given value is [*interactive*][spec].
 
 ###### Returns
 
-Whether `node` is an [`Element`][element] categorised as [*interactive*][spec]
-(`boolean`).
+Whether `node` is an [`Element`][element] that is classified as *interactive
+content* (`boolean`).
+
+The following elements are interactive:
+
+*   `a` with `href`
+*   `audio` or `video` with `controls`
+*   `img` or `object` with `useMap`
+*   `input` without `hidden`
+*   any element with a `tabIndex`
+*   the elements `button`, `details`, `embed`, `iframe`, `keygen`, `label`,
+    `select`, and `textarea`
 
 ## Types
 
@@ -221,6 +231,6 @@ abide by its terms.
 
 [element]: https://github.com/syntax-tree/hast#element
 
-[spec]: https://html.spec.whatwg.org/#interactive-content
+[spec]: https://html.spec.whatwg.org/multipage/dom.html#interactive-content
 
 [xss]: https://en.wikipedia.org/wiki/Cross-site_scripting