Fix types for TypeScript 4.9

Author: wooorm

lib/handlers/a.js

@@ -1,15 +1,20 @@
 /**
- * @typedef {import('../types.js').Handle} Handle
+ * @typedef {import('../types.js').H} H
  * @typedef {import('../types.js').Element} Element
  * @typedef {import('../types.js').Properties} Properties
+ * @typedef {import('../types.js').MdastNode} Content
  */
 
 import {all} from '../all.js'
 import {resolve} from '../util/resolve.js'
 
 /**
- * @type {Handle}
+ * @param {H} h
+ *   Context.
  * @param {Element} node
+ *   hast element to transform.
+ * @returns {Content}
+ *   mdast node.
  */
 export function a(h, node) {
   /** @type {Properties} */

lib/handlers/base.js

@@ -1,11 +1,15 @@
 /**
- * @typedef {import('../types.js').Handle} Handle
+ * @typedef {import('../types.js').H} H
  * @typedef {import('../types.js').Element} Element
  */
 
 /**
- * @type {Handle}
+ * @param {H} h
+ *   Context.
  * @param {Element} node
+ *   hast element to transform.
+ * @returns {void}
+ *   Nothing
  */
 export function base(h, node) {
   if (!h.baseFound) {

lib/handlers/blockquote.js

@@ -1,13 +1,18 @@
 /**
- * @typedef {import('../types.js').Handle} Handle
+ * @typedef {import('../types.js').H} H
  * @typedef {import('../types.js').Element} Element
+ * @typedef {import('../types.js').MdastNode} Content
  */
 
 import {wrapChildren} from '../util/wrap-children.js'
 
 /**
- * @type {Handle}
+ * @param {H} h
+ *   Context.
  * @param {Element} node
+ *   hast element to transform.
+ * @returns {Content}
+ *   mdast node.
  */
 export function blockquote(h, node) {
   return h(node, 'blockquote', wrapChildren(h, node))

lib/handlers/br.js

@@ -1,11 +1,16 @@
 /**
- * @typedef {import('../types.js').Handle} Handle
+ * @typedef {import('../types.js').H} H
  * @typedef {import('../types.js').Element} Element
+ * @typedef {import('../types.js').MdastNode} Content
  */
 
 /**
- * @type {Handle}
+ * @param {H} h
+ *   Context.
  * @param {Element} node
+ *   hast element to transform.
+ * @returns {Content}
+ *   mdast node.
  */
 export function br(h, node) {
   return h.wrapText ? h(node, 'break') : h(node, 'text', ' ')

lib/handlers/code.js

@@ -1,7 +1,7 @@
 /**
- * @typedef {import('../types.js').Handle} Handle
+ * @typedef {import('../types.js').H} H
  * @typedef {import('../types.js').Element} Element
- * @typedef {import('../types.js').ElementChild} ElementChild
+ * @typedef {import('../types.js').MdastNode} Content
  */
 
 import {convertElement} from 'hast-util-is-element'
@@ -15,8 +15,12 @@ const pre = convertElement('pre')
 const isCode = convertElement('code')
 
 /**
- * @type {Handle}
+ * @param {H} h
+ *   Context.
  * @param {Element} node
+ *   hast element to transform.
+ * @returns {Content}
+ *   mdast node.
  */
 export function code(h, node) {
   const children = node.children

lib/handlers/comment.js

@@ -1,12 +1,18 @@
 /**
- * @typedef {import('../types.js').Handle} Handle
+ * @typedef {import('../types.js').H} H
  * @typedef {import('../types.js').Comment} Comment
+ * @typedef {import('../types.js').MdastNode} Content
  */
+
 import {wrapText} from '../util/wrap-text.js'
 
 /**
- * @type {Handle}
+ * @param {H} h
+ *   Context.
  * @param {Comment} node
+ *   hast element to transform.
+ * @returns {Content}
+ *   mdast node.
  */
 export function comment(h, node) {
   return h(node, 'html', '<!--' + wrapText(h, node.value) + '-->')

lib/handlers/del.js

@@ -1,13 +1,18 @@
 /**
- * @typedef {import('../types.js').Handle} Handle
+ * @typedef {import('../types.js').H} H
  * @typedef {import('../types.js').Element} Element
+ * @typedef {import('../types.js').MdastNode} Content
  */
 
 import {all} from '../all.js'
 
 /**
- * @type {Handle}
+ * @param {H} h
+ *   Context.
  * @param {Element} node
+ *   hast element to transform.
+ * @returns {Content}
+ *   mdast node.
  */
 export function del(h, node) {
   return h(node, 'delete', all(h, node))

lib/handlers/dl.js

@@ -1,9 +1,8 @@
 /**
  * @typedef {import('../types.js').H} H
- * @typedef {import('../types.js').Handle} Handle
  * @typedef {import('../types.js').Element} Element
+ * @typedef {import('../types.js').MdastNode} Content
  * @typedef {import('../types.js').ElementChild} ElementChild
- * @typedef {import('../types.js').MdastNode} MdastNode
  * @typedef {import('../types.js').MdastListContent} MdastListContent
  * @typedef {import('../types.js').MdastBlockContent} MdastBlockContent
  * @typedef {import('../types.js').MdastDefinitionContent} MdastDefinitionContent
@@ -22,8 +21,12 @@ const dt = convertElement('dt')
 const dd = convertElement('dd')
 
 /**
- * @type {Handle}
+ * @param {H} h
+ *   Context.
  * @param {Element} node
+ *   hast element to transform.
+ * @returns {Content | undefined}
+ *   mdast node.
  */
 export function dl(h, node) {
   const children = node.children

lib/handlers/em.js

@@ -1,13 +1,18 @@
 /**
- * @typedef {import('../types.js').Handle} Handle
+ * @typedef {import('../types.js').H} H
  * @typedef {import('../types.js').Element} Element
+ * @typedef {import('../types.js').MdastNode} Content
  */
 
 import {all} from '../all.js'
 
 /**
- * @type {Handle}
+ * @param {H} h
+ *   Context.
  * @param {Element} node
+ *   hast element to transform.
+ * @returns {Content}
+ *   mdast node.
  */
 export function em(h, node) {
   return h(node, 'emphasis', all(h, node))

lib/handlers/heading.js

@@ -1,14 +1,18 @@
 /**
- * @typedef {import('../types.js').Handle} Handle
+ * @typedef {import('../types.js').H} H
  * @typedef {import('../types.js').Element} Element
- * @typedef {import('../types.js').MdastNode} MdastNode
+ * @typedef {import('../types.js').MdastNode} Content
  */
 
 import {all} from '../all.js'
 
 /**
- * @type {Handle}
+ * @param {H} h
+ *   Context.
  * @param {Element} node
+ *   hast element to transform.
+ * @returns {Content}
+ *   mdast node.
  */
 export function heading(h, node) {
   // `else` shouldn’t happen, of course…