@azerion/bunosaurus-remark-plugin-npm2yarn 0.0.0-stage → 4.0.0

package/README.md

@@ -1,3 +1,93 @@
-# Temporary Holding Version
+# `@docusaurus/remark-plugin-npm2yarn`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+## Motivation:
+
+Transforms npm bash command code blocks to Docusaurus tabs:
+
+The following (remove the `//`):
+
+````bash
+// ```bash npm2yarn
+// npm run build
+// ```
+````
+
+Becomes:
+
+![npm2yarn tabs example](./example.png)
+
+**Note**: it only works when used with Docusaurus themes that have the `Tabs` and `TabItems` components.
+
+## Install
+
+```bash
+npm install @docusaurus/remark-plugin-npm2yarn
+```
+
+It is a Remark plugin, **not a Docusaurus plugin**, so you have to install it as a Remark plugin in the config of your Docusaurus plugins.
+
+```js
+module.exports = {
+  presets: [
+    [
+      '@docusaurus/preset-classic',
+      {
+        docs: {
+          // ...
+          remarkPlugins: [
+            [require('@docusaurus/remark-plugin-npm2yarn'), {sync: true}],
+          ],
+        },
+        blog: {
+          // ...
+          remarkPlugins: [
+            [require('@docusaurus/remark-plugin-npm2yarn'), {sync: true}],
+          ],
+        },
+        pages: {
+          // ...
+          remarkPlugins: [
+            [require('@docusaurus/remark-plugin-npm2yarn'), {sync: true}],
+          ],
+        },
+        // ...
+      },
+    ],
+  ],
+  // ...
+};
+```
+
+## Options
+
+| 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', 'bun']` | 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`, `pnpm` or `bun`, 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',
+          'bun',
+          ['Turbo', (code) => code.replace(/npm/g, 'turbo')],
+        ],
+      },
+    ],
+  ];
+}
+```

package/lib/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { Plugin } from 'unified';
+type KnownConverter = 'yarn' | 'pnpm' | 'bun';
+type CustomConverter = [name: string, cb: (npmCode: string) => string];
+type Converter = CustomConverter | KnownConverter;
+type PluginOptions = {
+    sync?: boolean;
+    converters?: Converter[];
+};
+declare const plugin: Plugin<[PluginOptions?]>;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAc,MAAM,EAAC,MAAM,SAAS,CAAC;AAEjD,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9C,KAAK,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAEvE,KAAK,SAAS,GAAG,eAAe,GAAG,cAAc,CAAC;AAElD,KAAK,aAAa,GAAG;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B,CAAC;AAuJF,QAAA,MAAM,MAAM,EAAE,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,CA+BpC,CAAC;eAEa,MAAM"}

package/lib/index.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const unist_util_visit_1 = require("unist-util-visit");
+const npm_to_yarn_1 = tslib_1.__importDefault(require("npm-to-yarn"));
+function createAttribute(attributeName, attributeValue) {
+    return {
+        type: 'mdxJsxAttribute',
+        name: attributeName,
+        value: attributeValue,
+    };
+}
+function createTabItem({ code, node, value, label, }) {
+    return {
+        type: 'mdxJsxFlowElement',
+        name: 'TabItem',
+        attributes: [
+            createAttribute('value', value),
+            label && createAttribute('label', label),
+        ].filter((attr) => Boolean(attr)),
+        children: [
+            {
+                type: node.type,
+                lang: node.lang,
+                value: code,
+            },
+        ],
+    };
+}
+const transformNode = (node, isSync, converters) => {
+    const groupIdProp = isSync
+        ? {
+            type: 'mdxJsxAttribute',
+            name: 'groupId',
+            value: 'npm2yarn',
+        }
+        : undefined;
+    const npmCode = node.value;
+    function createConvertedTabItem(converter) {
+        if (typeof converter === 'string') {
+            return createTabItem({
+                code: (0, npm_to_yarn_1.default)(npmCode, converter),
+                node,
+                value: converter,
+                label: getLabelForConverter(converter),
+            });
+        }
+        const [converterName, converterFn] = converter;
+        return createTabItem({
+            code: converterFn(npmCode),
+            node,
+            value: converterName,
+        });
+    }
+    function getLabelForConverter(converter) {
+        switch (converter) {
+            case 'yarn':
+                return 'Yarn';
+            case 'bun':
+                return 'Bun';
+            default:
+                return converter;
+        }
+    }
+    return [
+        {
+            type: 'mdxJsxFlowElement',
+            name: 'Tabs',
+            attributes: [groupIdProp].filter(Boolean),
+            children: [
+                createTabItem({ code: npmCode, node, value: 'npm' }),
+                ...converters.flatMap(createConvertedTabItem),
+            ],
+        },
+    ];
+};
+const isMdxEsmLiteral = (node) => node.type === 'mdxjsEsm';
+// TODO legacy approximation, good-enough for now but not 100% accurate
+const isTabsImport = (node) => isMdxEsmLiteral(node) && node.value.includes('@theme/Tabs');
+const isParent = (node) => Array.isArray(node.children);
+const isNpm2Yarn = (node) => node.type === 'code' && node.meta === 'npm2yarn';
+function createImportNode() {
+    return {
+        type: 'mdxjsEsm',
+        value: "import Tabs from '@theme/Tabs'\nimport TabItem from '@theme/TabItem'",
+        data: {
+            estree: {
+                type: 'Program',
+                body: [
+                    {
+                        type: 'ImportDeclaration',
+                        specifiers: [
+                            {
+                                type: 'ImportDefaultSpecifier',
+                                local: { type: 'Identifier', name: 'Tabs' },
+                            },
+                        ],
+                        source: {
+                            type: 'Literal',
+                            value: '@theme/Tabs',
+                            raw: "'@theme/Tabs'",
+                        },
+                    },
+                    {
+                        type: 'ImportDeclaration',
+                        specifiers: [
+                            {
+                                type: 'ImportDefaultSpecifier',
+                                local: { type: 'Identifier', name: 'TabItem' },
+                            },
+                        ],
+                        source: {
+                            type: 'Literal',
+                            value: '@theme/TabItem',
+                            raw: "'@theme/TabItem'",
+                        },
+                    },
+                ],
+                sourceType: 'module',
+            },
+        },
+    };
+}
+const plugin = (options = {}) => {
+    const { sync = false, converters = ['yarn', 'pnpm', 'bun'] } = options;
+    return (root) => {
+        let transformed = false;
+        let alreadyImported = false;
+        (0, unist_util_visit_1.visit)(root, (node) => {
+            if (isTabsImport(node)) {
+                alreadyImported = true;
+            }
+            if (isParent(node)) {
+                let index = 0;
+                while (index < node.children.length) {
+                    const child = node.children[index];
+                    if (isNpm2Yarn(child)) {
+                        const result = transformNode(child, sync, converters);
+                        node.children.splice(index, 1, ...result);
+                        index += result.length;
+                        transformed = true;
+                    }
+                    else {
+                        index += 1;
+                    }
+                }
+            }
+        });
+        if (transformed && !alreadyImported) {
+            root.children.unshift(createImportNode());
+        }
+    };
+};
+exports.default = plugin;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@azerion/bunosaurus-remark-plugin-npm2yarn",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "4.0.0",
+  "description": "Remark plugin for converting npm commands to Yarn commands as tabs.",
+  "main": "lib/index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/azerion/bunosaurus.git",
+    "directory": "packages/docusaurus-remark-plugin-npm2yarn"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "mdast-util-mdx": "^3.0.0",
+    "npm-to-yarn": "^3.2.0",
+    "tslib": "^2.8.1",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.1.0"
+  },
+  "devDependencies": {
+    "@types/mdast": "^4.0.4",
+    "@types/unist": "^3.0.3",
+    "dedent": "^1.7.2",
+    "remark": "^15.0.1",
+    "remark-mdx": "^3.1.1",
+    "to-vfile": "^8.0.0"
+  },
+  "engines": {
+    "bun": ">=1.4.1"
+  }
+}

package/src/index.ts

@@ -0,0 +1,208 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import {visit} from 'unist-util-visit';
+import npmToYarn from 'npm-to-yarn';
+import type {Code, Literal} from 'mdast';
+import type {MdxJsxFlowElement, MdxJsxAttribute} from 'mdast-util-mdx';
+import type {Node, Parent} from 'unist';
+import type {Transformer, Plugin} from 'unified';
+
+type KnownConverter = 'yarn' | 'pnpm' | 'bun';
+
+type CustomConverter = [name: string, cb: (npmCode: string) => string];
+
+type Converter = CustomConverter | KnownConverter;
+
+type PluginOptions = {
+  sync?: boolean;
+  converters?: Converter[];
+};
+
+function createAttribute(
+  attributeName: string,
+  attributeValue: MdxJsxAttribute['value'],
+): MdxJsxAttribute {
+  return {
+    type: 'mdxJsxAttribute',
+    name: attributeName,
+    value: attributeValue,
+  };
+}
+
+function createTabItem({
+  code,
+  node,
+  value,
+  label,
+}: {
+  code: string;
+  node: Code;
+  value: string;
+  label?: string;
+}): MdxJsxFlowElement {
+  return {
+    type: 'mdxJsxFlowElement',
+    name: 'TabItem',
+    attributes: [
+      createAttribute('value', value),
+      label && createAttribute('label', label),
+    ].filter((attr): attr is MdxJsxAttribute => Boolean(attr)),
+    children: [
+      {
+        type: node.type,
+        lang: node.lang,
+        value: code,
+      },
+    ],
+  };
+}
+
+const transformNode = (
+  node: Code,
+  isSync: boolean,
+  converters: Converter[],
+) => {
+  const groupIdProp = isSync
+    ? {
+        type: 'mdxJsxAttribute',
+        name: 'groupId',
+        value: 'npm2yarn',
+      }
+    : undefined;
+  const npmCode = node.value;
+
+  function createConvertedTabItem(converter: Converter) {
+    if (typeof converter === 'string') {
+      return createTabItem({
+        code: npmToYarn(npmCode, converter),
+        node,
+        value: converter,
+        label: getLabelForConverter(converter),
+      });
+    }
+    const [converterName, converterFn] = converter;
+    return createTabItem({
+      code: converterFn(npmCode),
+      node,
+      value: converterName,
+    });
+  }
+
+  function getLabelForConverter(converter: KnownConverter) {
+    switch (converter) {
+      case 'yarn':
+        return 'Yarn';
+      case 'bun':
+        return 'Bun';
+      default:
+        return converter;
+    }
+  }
+
+  return [
+    {
+      type: 'mdxJsxFlowElement',
+      name: 'Tabs',
+      attributes: [groupIdProp].filter(Boolean),
+      children: [
+        createTabItem({code: npmCode, node, value: 'npm'}),
+        ...converters.flatMap(createConvertedTabItem),
+      ],
+    },
+  ] as any[];
+};
+
+const isMdxEsmLiteral = (node: Node): node is Literal =>
+  node.type === 'mdxjsEsm';
+// TODO legacy approximation, good-enough for now but not 100% accurate
+const isTabsImport = (node: Node): boolean =>
+  isMdxEsmLiteral(node) && node.value.includes('@theme/Tabs');
+
+const isParent = (node: Node): node is Parent =>
+  Array.isArray((node as Parent).children);
+const isNpm2Yarn = (node: Node): node is Code =>
+  node.type === 'code' && (node as Code).meta === 'npm2yarn';
+
+function createImportNode() {
+  return {
+    type: 'mdxjsEsm',
+    value:
+      "import Tabs from '@theme/Tabs'\nimport TabItem from '@theme/TabItem'",
+    data: {
+      estree: {
+        type: 'Program',
+        body: [
+          {
+            type: 'ImportDeclaration',
+            specifiers: [
+              {
+                type: 'ImportDefaultSpecifier',
+                local: {type: 'Identifier', name: 'Tabs'},
+              },
+            ],
+            source: {
+              type: 'Literal',
+              value: '@theme/Tabs',
+              raw: "'@theme/Tabs'",
+            },
+          },
+          {
+            type: 'ImportDeclaration',
+            specifiers: [
+              {
+                type: 'ImportDefaultSpecifier',
+                local: {type: 'Identifier', name: 'TabItem'},
+              },
+            ],
+            source: {
+              type: 'Literal',
+              value: '@theme/TabItem',
+              raw: "'@theme/TabItem'",
+            },
+          },
+        ],
+        sourceType: 'module',
+      },
+    },
+  };
+}
+
+const plugin: Plugin<[PluginOptions?]> = (options = {}): Transformer => {
+  const {sync = false, converters = ['yarn', 'pnpm', 'bun']} = options;
+  return (root) => {
+    let transformed = false;
+    let alreadyImported = false;
+
+    visit(root, (node: Node) => {
+      if (isTabsImport(node)) {
+        alreadyImported = true;
+      }
+
+      if (isParent(node)) {
+        let index = 0;
+        while (index < node.children.length) {
+          const child = node.children[index]!;
+          if (isNpm2Yarn(child)) {
+            const result = transformNode(child, sync, converters);
+            node.children.splice(index, 1, ...result);
+            index += result.length;
+            transformed = true;
+          } else {
+            index += 1;
+          }
+        }
+      }
+    });
+
+    if (transformed && !alreadyImported) {
+      (root as Parent).children.unshift(createImportNode());
+    }
+  };
+};
+
+export default plugin;