feat: add detect-package-manager to the docs and manifest (#275)

* feat: add `detect-package-manager` to the docs and manifest

* docs(detect-package-manager): replace maintenance info with ESM vs CJS note

* docs(detect-package-manager): use note admonition syntax

Co-authored-by: James Garbutt <[email protected]>

---------

Co-authored-by: James Garbutt <[email protected]>

Author: waldyrious

docs/modules/README.md

@@ -27,6 +27,7 @@ ESLint plugin.
 - [`crypto-js`](./crypto-js.md)
 - [`deep-equal`](./deep-equal.md)
 - [`depcheck`](./depcheck.md)
+- [`detect-package-manager`](./detect-package-manager.md)
 - [`dot-prop`](./dot-prop.md)
 - [`dotenv`](./dotenv.md)
 - [`emoji-regex`](./emoji-regex.md)

docs/modules/detect-package-manager.md

@@ -0,0 +1,31 @@
+---
+description: Lightweight alternative to detect-package-manager for detecting the package manager with zero subdependencies
+---
+
+# Replacements for `detect-package-manager`
+
+## `package-manager-detector`
+
+[`package-manager-detector`](https://www.npmjs.com/package/package-manager-detector) is a lightweight alternative for detecting the package manager being used in a project.
+
+### Key differences
+
+- **Zero subdependencies** compared to 16 in `detect-package-manager`
+- **ESM-only**, while `detect-package-manager` is primarily CJS (with ESM support)
+- **Smaller bundle size** due to the lack of dependencies
+
+### Migration example
+
+```ts
+import { detect } from 'detect-package-manager' // [!code --]
+import { detect } from 'package-manager-detector' // [!code ++]
+
+const pm = await detect() // [!code --]
+const result = await detect() // [!code ++]
+const pm = result?.name // [!code ++]
+```
+
+> [!NOTE]
+> `package-manager-detector` returns an object with `name` and `agent` properties, while `detect-package-manager` returns a string directly.
+
+Both packages can detect npm, yarn, pnpm, and bun package managers in your project by analyzing lock files. Additionally, `package-manager-detector` also supports deno.

manifests/preferred.json

@@ -96,6 +96,12 @@
       "docPath": "depcheck",
       "category": "preferred"
     },
+    {
+      "type": "documented",
+      "moduleName": "detect-package-manager",
+      "docPath": "detect-package-manager",
+      "category": "preferred"
+    },
     {
       "type": "documented",
       "moduleName": "dot-prop",