docs: add find-up and clones (#223)

Piles of libraries that are basically curried functions of the exact
same underlying logic.

Easily replaced these days.

Author: 43081j

docs/modules/README.md

@@ -35,6 +35,7 @@ ESLint plugin.
 - [`ezspawn`](./process-exec.md)
 - [`faker`](./faker.md)
 - [`fast-glob`](./glob.md)
+- [`find-up` and related](./find-up.md)
 - [`fs-extra`](./fs-extra.md)
 - [`glob`](./glob.md)
 - [`globby`](./glob.md)

docs/modules/find-up.md

@@ -0,0 +1,25 @@
+# find-up, read-package-up, read-package, etc.
+
+Many of these upwards traversal libraries are overly granular and non-generic.
+
+We can replace most of them with one upwards traversal library and, sometimes, one file reading library.
+
+# Alternatives
+
+## empathic
+
+`empathic` can be used to find _any_ file or directory upwards in the file system. It is very fast and very small.
+
+[Project Page](https://github.com/lukeed/empathic)
+
+[npm](https://www.npmjs.com/package/empathic)
+
+## pkg-types
+
+If you need to _read_ a `package.json` into a strong type, you can combine an upwards traversal library with `pkg-types`.
+
+This library contains functions for reading `package.json` files and returning them as a strong type.
+
+[Project Page](https://github.com/unjs/pkg-types/)
+
+[npm](https://www.npmjs.com/package/pkg-types)

manifests/preferred.json

@@ -156,6 +156,30 @@
       "docPath": "glob",
       "category": "preferred"
     },
+    {
+      "type": "documented",
+      "moduleName": "find-cache-dir",
+      "docPath": "find-up",
+      "category": "preferred"
+    },
+    {
+      "type": "documented",
+      "moduleName": "find-cache-directory",
+      "docPath": "find-up",
+      "category": "preferred"
+    },
+    {
+      "type": "documented",
+      "moduleName": "find-file-up",
+      "docPath": "find-up",
+      "category": "preferred"
+    },
+    {
+      "type": "documented",
+      "moduleName": "find-up",
+      "docPath": "find-up",
+      "category": "preferred"
+    },
     {
       "type": "documented",
       "moduleName": "fs-extra",
@@ -2196,12 +2220,24 @@
       "docPath": "ora",
       "category": "preferred"
     },
+    {
+      "type": "documented",
+      "moduleName": "package-up",
+      "docPath": "find-up",
+      "category": "preferred"
+    },
     {
       "type": "documented",
       "moduleName": "path-exists",
       "docPath": "path-exists",
       "category": "preferred"
     },
+    {
+      "type": "documented",
+      "moduleName": "pkg-up",
+      "docPath": "find-up",
+      "category": "preferred"
+    },
     {
       "type": "documented",
       "moduleName": "q",
@@ -2214,6 +2250,24 @@
       "docPath": "qs",
       "category": "preferred"
     },
+    {
+      "type": "documented",
+      "moduleName": "read-package-up",
+      "docPath": "find-up",
+      "category": "preferred"
+    },
+    {
+      "type": "documented",
+      "moduleName": "read-pkg",
+      "docPath": "find-up",
+      "category": "preferred"
+    },
+    {
+      "type": "documented",
+      "moduleName": "read-pkg-up",
+      "docPath": "find-up",
+      "category": "preferred"
+    },
     {
       "type": "documented",
       "moduleName": "readable-stream",