Refactor some types

Author: wooorm

lib/browser.js

@@ -1,21 +1,12 @@
 /**
- * @typedef {typeof import('./index.js').fromHtmlIsomorphic} FromHtmlIsomorphic
  * @typedef {import('hast').Root} Root
+ * @typedef {typeof import('./index.js').fromHtmlIsomorphic} FromHtmlIsomorphic
  */
 
 import {fromDom} from 'hast-util-from-dom'
 
 const parser = new DOMParser()
 
-/**
- * @param {string} value
- */
-function parseFragment(value) {
-  const template = document.createElement('template')
-  template.innerHTML = value
-  return template.content
-}
-
 /** @type {FromHtmlIsomorphic} */
 export function fromHtmlIsomorphic(value, options) {
   const node = options?.fragment
@@ -24,3 +15,15 @@ export function fromHtmlIsomorphic(value, options) {
 
   return /** @type {Root} */ (fromDom(node))
 }
+
+/**
+ * Parse as a fragment.
+ *
+ * @param {string} value
+ * @returns {DocumentFragment}
+ */
+function parseFragment(value) {
+  const template = document.createElement('template')
+  template.innerHTML = value
+  return template.content
+}

lib/index.js

@@ -7,12 +7,15 @@ import {fromHtml} from 'hast-util-from-html'
 import {removePosition} from 'unist-util-remove-position'
 
 /**
+ * Turn HTML into a syntax tree, using browser APIs when available, so it has
+ * a smaller bundle size there.
+ *
  * @param {string} value
  *   Serialized HTML to parse.
- * @param {Options} [options]
+ * @param {Options | null | undefined} [options]
  *   Configuration (optional).
- * @returns {import('hast').Root}
- *   Tree
+ * @returns {Root}
+ *   Tree.
  */
 export function fromHtmlIsomorphic(value, options) {
   const tree = fromHtml(value, options)