1 files changed, 166 insertions, 0 deletions

diff --git a/subprojects/docs/src/plugins/remarkPosix2Windows.ts b/subprojects/docs/src/plugins/remarkPosix2Windows.ts
new file mode 100644
index 00000000..66baca30
--- /dev/null
+++ b/subprojects/docs/src/plugins/remarkPosix2Windows.ts
@@ -0,0 +1,166 @@
+/*
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) 2024 The Refinery Authors
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * This file is based on
+ * https://github.com/facebook/docusaurus/blob/e4ecffe41878728acff55a8370bd7440706c02f7/packages/docusaurus-remark-plugin-npm2yarn/src/index.ts
+ * but was changed to conver shell commands to POSIX to Windows syntax.
+ */
+
+import type { Code, Literal } from 'mdast';
+import type { MdxjsEsm, MdxJsxFlowElement } from 'mdast-util-mdx';
+import type { Transformer } from 'unified';
+import type { Node, Parent } from 'unist';
+import { visit } from 'unist-util-visit';
+
+function isLiteral(node: Node): node is Literal {
+  return node.type === 'mdxjsEsm';
+}
+
+function isTabImport(node: Node): boolean {
+  return isLiteral(node) && node.value.includes('@theme/Tabs');
+}
+
+function isParent(node: Node): node is Parent {
+  return 'children' in node && Array.isArray(node.children);
+}
+
+function isCode(node: Node): node is Code {
+  return node.type === 'code';
+}
+
+function isPosix2Windows(node: Node): node is Code {
+  return isCode(node) && node.meta === 'posix2windows';
+}
+
+function createTabItem(
+  code: string,
+  node: Code,
+  value: string,
+  label: string,
+): MdxJsxFlowElement {
+  return {
+    type: 'mdxJsxFlowElement',
+    name: 'TabItem',
+    attributes: [
+      {
+        type: 'mdxJsxAttribute',
+        name: 'value',
+        value,
+      },
+      {
+        type: 'mdxJsxAttribute',
+        name: 'label',
+        value: label,
+      },
+    ],
+    children: [
+      {
+        type: node.type,
+        lang: node.lang,
+        value: code,
+      },
+    ],
+  };
+}
+
+function transformNode(node: Code): MdxJsxFlowElement[] {
+  const posixCode = node.value;
+  const windowsCode = posixCode.replaceAll(/(?<=^\w*)\.\//gm, '.\\');
+  return [
+    {
+      type: 'mdxJsxFlowElement',
+      name: 'Tabs',
+      attributes: [
+        {
+          type: 'mdxJsxAttribute',
+          name: 'groupId',
+          value: 'posix2windows',
+        },
+      ],
+      children: [
+        createTabItem(posixCode, node, 'posix', 'Linux or macOS'),
+        createTabItem(windowsCode, node, 'windows', 'Windows (PowerShell)'),
+      ],
+    },
+  ];
+}
+
+function createImportNode(): MdxjsEsm {
+  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',
+      },
+    },
+  };
+}
+
+export default function remarkPosix2Windows(): Transformer {
+  return (root) => {
+    let transformed = false;
+    let alreadyImported = false;
+    visit(root, (node) => {
+      if (isTabImport(node)) {
+        alreadyImported = true;
+      }
+      if (isParent(node)) {
+        let index = 0;
+        while (index < node.children.length) {
+          const child = node.children[index];
+          if (child !== undefined && isPosix2Windows(child)) {
+            const result = transformNode(child);
+            node.children.splice(index, 1, ...result);
+            index += result.length;
+            transformed = true;
+          } else {
+            index += 1;
+          }
+        }
+      }
+    });
+    if (transformed && !alreadyImported) {
+      if (isParent(root)) {
+        root.children.unshift(createImportNode());
+      } else {
+        throw new Error("Cannot import '@theme/Tabs'");
+      }
+    }
+  };
+}