feat: add portfinder to preferred manifest (#494)

* feat: add `portfinder` to preferred manifest

* Update docs/modules/portfinder.md

Co-authored-by: James Garbutt <43081j@users.noreply.github.com>

* Update docs/modules/README.md

Co-authored-by: Willow (GHOST) <ghostdevbusiness@gmail.com>

---------

Co-authored-by: James Garbutt <43081j@users.noreply.github.com>
Co-authored-by: Willow (GHOST) <ghostdevbusiness@gmail.com>

Author: 3 people

docs/modules/README.md

@@ -86,8 +86,9 @@ ESLint plugin.
 - [`ora`](./ora.md)
 - [`path-exists`](./path-exists.md)
 - [`pbkdf2`](./pbkdf2.md)
-- [`portal-vue`](./portal-vue.md)
 - [`pkg-dir`](./pkg-dir.md)
+- [`portal-vue`](./portal-vue.md)
+- [`portfinder`](./portfinder.md)
 - [`qs`](./qs.md)
 - [`react-helmet`](./react-helmet.md)
 - [`react-feather`](./feather.md)

docs/modules/portfinder.md

@@ -0,0 +1,19 @@
+---
+description: Modern alternatives to the portfinder package for finding an available port
+---
+
+# Replacements for `portfinder`
+
+## `get-port`
+
+[`get-port`](https://github.com/sindresorhus/get-port) is a lighter and more modern package for finding an available port.
+
+Example:
+
+```ts
+import portfinder from 'portfinder' // [!code --]
+import getPort from 'get-port' // [!code ++]
+
+const port = await portfinder.getPortPromise() // [!code --]
+const port = await getPort() // [!code ++]
+```

manifests/preferred.json

@@ -2508,6 +2508,12 @@
       "replacements": ["Teleport"],
       "url": {"type": "e18e", "id": "portal-vue"}
     },
+    "portfinder": {
+      "type": "module",
+      "moduleName": "portfinder",
+      "replacements": ["get-port"],
+      "url": {"type": "e18e", "id": "portfinder"}
+    },
     "preferred-pm": {
       "type": "module",
       "moduleName": "preferred-pm",
@@ -3188,6 +3194,12 @@
       },
       "url": {"type": "node", "id": "api/fs.html#fspromisesrmdirpath-options"}
     },
+    "get-port": {
+      "id": "get-port",
+      "type": "documented",
+      "url": {"type": "e18e", "id": "portfinder"},
+      "replacementModule": "get-port"
+    },
     "grammy": {
       "id": "grammy",
       "type": "documented",