feat(npm-to-yarn): add support for PnPm and custom converters (#8690)

Co-authored-by: Ben Gubler <[email protected]>
Co-authored-by: sebastienlorber <[email protected]>

Author: 3 people

packages/docusaurus-remark-plugin-npm2yarn/README.md

@@ -63,3 +63,30 @@ module.exports = {
 | Property | Type | Default | Description |
 | --- | --- | --- | --- |
 | `sync` | `boolean` | `false` | Syncing tab choices (Yarn and npm). See https://docusaurus.io/docs/markdown-features/#syncing-tab-choices for details. |
+| `converters` | `array` | `'yarn'`, `'pnpm'` | The list of converters to use. The order of the converters is important, as the first converter will be used as the default choice. |
+
+## Custom converters
+
+In case you want to convert npm commands to something else than `yarn` or `pnpm`, you can use custom converters:
+
+```ts
+type CustomConverter = [name: string, cb: (npmCode: string) => string];
+```
+
+```ts
+{
+  remarkPlugins: [
+    [
+      require('@docusaurus/remark-plugin-npm2yarn'),
+      {
+        sync: true,
+        converters: [
+          'yarn',
+          'pnpm',
+          ['Turbo', (code) => code.replace(/npm/g, 'turbo')],
+        ],
+      },
+    ],
+  ];
+}
+```

packages/docusaurus-remark-plugin-npm2yarn/package.json

@@ -17,7 +17,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "npm-to-yarn": "^1.2.1",
+    "npm-to-yarn": "^2.0.0",
     "tslib": "^2.4.1",
     "unist-util-visit": "^2.0.3"
   },