Update @types/mdast

Author: wooorm

lib/index.js

@@ -1,25 +1,21 @@
 /**
- * @typedef {import('mdast').Parent} MdastParent
- * @typedef {import('mdast').Root} Root
- * @typedef {import('mdast').Content} Content
+ * @typedef {import('mdast').Nodes} Nodes
+ * @typedef {import('mdast').Parents} Parents
  * @typedef {import('mdast').PhrasingContent} PhrasingContent
+ * @typedef {import('mdast').Root} Root
  * @typedef {import('mdast').Text} Text
  * @typedef {import('unist-util-visit-parents').Test} Test
  * @typedef {import('unist-util-visit-parents').VisitorResult} VisitorResult
  */
 
 /**
- * @typedef {Content | Root} Node
- * @typedef {Extract<Node, MdastParent>} Parent
- * @typedef {Exclude<Parent, Root>} ContentParent
- *
  * @typedef RegExpMatchObject
  *   Info on the match.
  * @property {number} index
  *   The index of the search at which the result was found.
  * @property {string} input
  *   A copy of the search string in the text node.
- * @property {[Root, ...Array<ContentParent>, Text]} stack
+ * @property {[...Array<Parents>, Text]} stack
  *   All ancestors of the text node, where the last node is the text itself.
  *
  * @callback ReplaceFunction
@@ -90,18 +86,17 @@ const own = {}.hasOwnProperty
 export const findAndReplace =
   /**
    * @type {(
-   *   (<Tree extends Node>(tree: Tree, find: Find, replace?: Replace | null | undefined, options?: Options | null | undefined) => Tree) &
-   *   (<Tree extends Node>(tree: Tree, schema: FindAndReplaceSchema | FindAndReplaceList, options?: Options | null | undefined) => Tree)
+   *   ((tree: Nodes, find: Find, replace?: Replace | null | undefined, options?: Options | null | undefined) => undefined) &
+   *   ((tree: Nodes, schema: FindAndReplaceSchema | FindAndReplaceList, options?: Options | null | undefined) => undefined)
    * )}
    **/
   (
     /**
-     * @template {Node} Tree
-     * @param {Tree} tree
+     * @param {Nodes} tree
      * @param {Find | FindAndReplaceSchema | FindAndReplaceList} find
      * @param {Replace | Options | null | undefined} [replace]
      * @param {Options | null | undefined} [options]
-     * @returns {Tree}
+     * @returns {undefined}
      */
     function (tree, find, replace, options) {
       /** @type {Options | null | undefined} */
@@ -131,13 +126,13 @@ export const findAndReplace =
         visitParents(tree, 'text', visitor)
       }
 
-      // To do next major: don’t return the given tree.
+      // @ts-expect-error: To do: remove.
       return tree
 
-      /** @type {import('unist-util-visit-parents/complex-types.js').BuildVisitor<Root, 'text'>} */
+      /** @type {import('unist-util-visit-parents').BuildVisitor<Root, 'text'>} */
       function visitor(node, parents) {
         let index = -1
-        /** @type {Parent | undefined} */
+        /** @type {Parents | undefined} */
         let grandparent
 
         while (++index < parents.length) {
@@ -167,7 +162,7 @@ export const findAndReplace =
        *
        * @param {Text} node
        *   Text node.
-       * @param {Array<Parent>} parents
+       * @param {Array<Parents>} parents
        *   Parents.
        * @returns {VisitorResult}
        *   Result.
@@ -193,7 +188,6 @@ export const findAndReplace =
           const matchObject = {
             index: match.index,
             input: match.input,
-            // @ts-expect-error: stack is fine.
             stack: [...parents, node]
           }
           let value = replace(...match, matchObject)

package.json

@@ -33,10 +33,10 @@
     "index.js"
   ],
   "dependencies": {
-    "@types/mdast": "^3.0.0",
+    "@types/mdast": "^4.0.0",
     "escape-string-regexp": "^5.0.0",
-    "unist-util-is": "^5.0.0",
-    "unist-util-visit-parents": "^5.0.0"
+    "unist-util-is": "^6.0.0",
+    "unist-util-visit-parents": "^6.0.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -46,7 +46,7 @@
     "remark-preset-wooorm": "^9.0.0",
     "type-coverage": "^2.0.0",
     "typescript": "^5.0.0",
-    "unist-builder": "^3.0.0",
+    "unist-builder": "^4.0.0",
     "xo": "^0.54.0"
   },
   "scripts": {