Update @types/hast, utilities

Author: wooorm

lib/index.js

@@ -1,13 +1,10 @@
-/**
- * @typedef {import('hast').Element} Element
- */
-
 import {convertElement} from 'hast-util-is-element'
 
+const names = new Set(['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'hgroup'])
+
 /**
  * Check if the given value is a *heading content* element.
  *
- * @type {import('hast-util-is-element').AssertPredicate<Element & {tagName: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'hgroup'}>}
  * @param node
  *   Thing to check (typically `Node`).
  * @returns
@@ -16,13 +13,12 @@ import {convertElement} from 'hast-util-is-element'
  *   The elements `h1`, `h2`, `h3`, `h4`, `h5`, `h6`, and `hgroup` are
  *   heading content.
  */
-// @ts-expect-error Sure, the assertion matches.
-export const heading = convertElement([
-  'h1',
-  'h2',
-  'h3',
-  'h4',
-  'h5',
-  'h6',
-  'hgroup'
-])
+export const heading = convertElement(
+  /**
+   * @param element
+   * @returns {element is {tagName: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'hgroup'}}
+   */
+  function (element) {
+    return names.has(element.tagName)
+  }
+)

package.json

@@ -33,8 +33,8 @@
     "index.js"
   ],
   "dependencies": {
-    "@types/hast": "^2.0.0",
-    "hast-util-is-element": "^2.0.0"
+    "@types/hast": "^3.0.0",
+    "hast-util-is-element": "^3.0.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

test.js

@@ -10,6 +10,7 @@ test('heading', () => {
     'should expose the public api'
   )
 
+  // @ts-expect-error: check how a missing `node` is handled.
   assert.equal(heading(), false, 'should return `false` without node')
 
   assert.equal(heading(null), false, 'should return `false` with `null`')