feat: add portal-vue to module replacements (#271)

* Add portal-vue to module replacements

* chore: move to .md

* chore: minor formatting changes

* chore: sort manifests

---------

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

Author: joaopedrodcf

docs/modules/README.md

@@ -63,6 +63,7 @@ ESLint plugin.
 - [`object-hash`](./object-hash.md)
 - [`ora`](./ora.md)
 - [`path-exists`](./path-exists.md)
+- [`portal-vue`](./portal-vue.md)
 - [`pkg-dir`](./pkg-dir.md)
 - [`qs`](./qs.md)
 - [`read-pkg`](./read-pkg.md)

docs/modules/portal-vue.md

@@ -0,0 +1,28 @@
+---
+description: Modern alternatives to the `portal-vue` package for making portals in Vue applications
+---
+
+# Replacements for `portal-vue`
+
+## Vue `Teleport` API
+
+Since Vue 3, the [Teleport](https://vuejs.org/guide/built-ins/teleport.html) component has been introduced which replaces portal-vue for most use cases, especially modals and overlays.
+
+`<Teleport>` only moves DOM nodes to an existing target — it does not manage destinations, layouts, or component structure.
+
+```html
+<!-- Using a modal -->
+<div class="outer">
+  <h3>Vue Teleport Example</h3>
+  <div>
+    <MyModal />
+  </div>
+</div>
+```
+
+```html
+<!-- MyModal.vue -->
+  <Teleport to="body">
+    <p>The content inside of Teleport will render in html body</p>
+  </Teleport>
+```

manifests/preferred.json

@@ -2280,6 +2280,12 @@
       "docPath": "find-up",
       "category": "preferred"
     },
+    {
+      "type": "documented",
+      "moduleName": "portal-vue",
+      "docPath": "portal-vue",
+      "category": "preferred"
+    },
     {
       "type": "documented",
       "moduleName": "q",