vuepress-plugin-md-power 1.0.0-rc.106 → 1.0.0-rc.107

package/lib/node/index.d.ts

@@ -81,6 +81,11 @@ interface JSFiddleTokenMeta extends SizeOptions {
     tab?: string;
 }
 
+type NpmToPackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun' | 'deno';
+type NpmToOptions = NpmToPackageManager[] | {
+    tabs?: NpmToPackageManager[];
+};
+
 type PDFEmbedType = 'iframe' | 'embed' | 'pdfjs';
 interface PDFTokenMeta extends SizeOptions {
     page?: number;
@@ -151,6 +156,10 @@ interface MarkdownPowerPluginOptions {
      * 配置代码块分组
      */
     codeTabs?: CodeTabsOptions;
+    /**
+     * 是否启用 npm-to 容器
+     */
+    npmTo?: boolean | NpmToOptions;
     /**
      * 是否启用 PDF 嵌入语法
      *
@@ -295,4 +304,4 @@ declare function resolveImageSize(app: App, url: string, remote?: boolean): Prom
 
 declare function markdownPowerPlugin(options?: MarkdownPowerPluginOptions): Plugin;
 
-export { type BilibiliTokenMeta, type CanIUseMode, type CanIUseOptions, type CanIUseTokenMeta, type CodeSandboxTokenMeta, type CodeTabsOptions, type CodepenTokenMeta, type FileTreeIconMode, type FileTreeOptions, type IconsOptions, type JSFiddleTokenMeta, type MarkdownPowerPluginOptions, type PDFEmbedType, type PDFOptions, type PDFTokenMeta, type PlotOptions, type ReplEditorData, type ReplOptions, type ReplitTokenMeta, type SizeOptions, type ThemeOptions, type VideoOptions, type YoutubeTokenMeta, markdownPowerPlugin, resolveImageSize };
+export { type BilibiliTokenMeta, type CanIUseMode, type CanIUseOptions, type CanIUseTokenMeta, type CodeSandboxTokenMeta, type CodeTabsOptions, type CodepenTokenMeta, type FileTreeIconMode, type FileTreeOptions, type IconsOptions, type JSFiddleTokenMeta, type MarkdownPowerPluginOptions, type NpmToOptions, type NpmToPackageManager, type PDFEmbedType, type PDFOptions, type PDFTokenMeta, type PlotOptions, type ReplEditorData, type ReplOptions, type ReplitTokenMeta, type SizeOptions, type ThemeOptions, type VideoOptions, type YoutubeTokenMeta, markdownPowerPlugin, resolveImageSize };

package/lib/node/index.js

@@ -1369,6 +1369,346 @@ async function read(file) {
   return void 0;
 }
 
+// src/node/container/npmTo.ts
+import { isArray } from "@vuepress/helper";
+import container4 from "markdown-it-container";
+var ALLOW_LIST = ["npm", "pnpm", "yarn", "bun", "deno"];
+var BOOL_FLAGS = ["--no-save", "-B", "--save-bundle", "--save-dev", "-D", "--save-prod", "-P", "--save-peer", "-O", "--save-optional", "-E", "--save-exact", "-y", "--yes", "-g", "--global"];
+var DEFAULT_TABS = ["npm", "pnpm", "yarn"];
+var MANAGERS_CONFIG = {
+  install: {
+    pattern: /(?:^|\s)npm\s+(?:install|i)$/,
+    pnpm: { cli: "pnpm install" },
+    yarn: { cli: "yarn" },
+    bun: { cli: "bun install" },
+    deno: { cli: "deno install" }
+  },
+  add: {
+    pattern: /(?:^|\s)npm\s+(?:install|i|add)(?:\s|$)/,
+    pnpm: {
+      cli: "pnpm add",
+      flags: {
+        "--no-save": "",
+        // unsupported
+        "-B": "",
+        // unsupported
+        "--save-bundle": ""
+        // unsupported
+      }
+    },
+    yarn: {
+      cli: "yarn add",
+      flags: {
+        "--save-dev": "--dev",
+        "--save-prod": "--prod",
+        "-P": "",
+        // in npm, `-P` same as `--save-prod`. but in yarn, `-P` same as `--peer`
+        "--save-peer": "--peer",
+        "--save-optional": "--optional",
+        "--no-save": "",
+        // unsupported
+        "--save-exact": "--exact",
+        "-B": "",
+        // unsupported
+        "--save-bundle": ""
+        // unsupported
+      }
+    },
+    bun: {
+      cli: "bun add",
+      flags: {
+        "--save-dev": "--development",
+        "-P": "",
+        // it's default
+        "--save-prod": "",
+        // it's default
+        "--save-peer": "",
+        // unsupported
+        "-O": "--optional",
+        "--save-optional": "--optional",
+        "--no-save": "",
+        // unsupported
+        "--save-exact": "--exact",
+        "-B": "",
+        // unsupported
+        "--save-bundle": ""
+        // unsupported
+      }
+    },
+    deno: {
+      cli: "deno add",
+      flags: {
+        "-g": "",
+        // unsupported
+        "--global": "",
+        // unsupported
+        "--save-dev": "--dev",
+        "-P": "",
+        // unsupported
+        "--save-prod": "",
+        // unsupported
+        "--save-peer": "",
+        // unsupported
+        "-O": "",
+        // unsupported
+        "--save-optional": "",
+        // unsupported
+        "--no-save": "",
+        // unsupported
+        "-E": "",
+        // unsupported
+        "--save-exact": "",
+        // unsupported
+        "-B": "",
+        // unsupported
+        "--save-bundle": ""
+        // unsupported
+      }
+    }
+  },
+  run: {
+    pattern: /(?:^|\s)npm\s+(?:run|run-script|rum|urn)(?:\s|$)/,
+    pnpm: {
+      cli: "pnpm",
+      flags: {
+        "-w": "-F",
+        // same as `--workspace`
+        "--workspace": "--filter",
+        // filter by workspaces
+        "--": ""
+        // scripts flags
+      }
+    },
+    yarn: {
+      cli: "yarn",
+      flags: {
+        "-w": "",
+        // unsupported
+        "--workspace": ""
+        // unsupported
+      }
+    },
+    bun: {
+      cli: "bun run",
+      flags: {
+        "-w": "--filter",
+        // same as `--workspace`
+        "--workspace": "--filter"
+        // filter by workspaces
+      }
+    },
+    deno: {
+      cli: "deno run",
+      flags: {
+        "-w": "",
+        // unsupported
+        "--workspace": ""
+        // unsupported
+      }
+    }
+  },
+  create: {
+    pattern: /(?:^|\s)npm\s+create\s/,
+    pnpm: { cli: "pnpm create", flags: { "-y": "", "--yes": "" } },
+    yarn: { cli: "yarn create", flags: { "-y": "", "--yes": "" } },
+    bun: { cli: "bun create", flags: { "-y": "", "--yes": "" } },
+    deno: { cli: "deno run -A ", flags: { "-y": "", "--yes": "" } }
+  },
+  init: {
+    pattern: /(?:^|\s)npm\s+init/,
+    pnpm: { cli: "pnpm init", flags: { "-y": "", "--yes": "" } },
+    yarn: { cli: "yarn init", flags: { "-y": "", "--yes": "" } },
+    bun: { cli: "bun init", flags: { "-y": "", "--yes": "" } },
+    deno: { cli: "deno init", flags: { "-y": "", "--yes": "" } }
+  },
+  npx: {
+    pattern: /(?:^|\s)npx\s+/,
+    pnpm: { cli: "pnpm dlx" },
+    yarn: { cli: "yarn dlx" },
+    bun: { cli: "bunx" },
+    deno: { cli: "deno run -A" }
+  },
+  remove: {
+    pattern: /(?:^|\s)npm\s+(?:uninstall|r|rm|remove|unlink|un)(?:\s|$)/,
+    pnpm: {
+      cli: "pnpm remove",
+      flags: { "--no-save": "", "--save": "", "-S": "" }
+    },
+    yarn: {
+      cli: "yarn remove",
+      flags: { "--save-dev": "--dev", "--save": "", "-S": "", "-g": "", "--global": "" }
+    },
+    bun: {
+      cli: "bun remove",
+      flags: { "--save-dev": "--development", "--save": "", "-S": "", "-g": "", "--global": "" }
+    },
+    deno: {
+      cli: "deno uninstall",
+      flags: { "--save-dev": "--dev", "--save": "", "-S": "" }
+    }
+  },
+  ci: {
+    pattern: /(?:^|\s)npm\s+ci$/,
+    pnpm: { cli: "pnpm install --frozen-lockfile" },
+    yarn: { cli: "yarn install --immutable" },
+    bun: { cli: "bun install --frozen-lockfile" },
+    deno: { cli: "deno install --frozen" }
+  }
+};
+function npmToPlugins(md, options) {
+  const type2 = "npm-to";
+  const validate = (info) => info.trim().startsWith(type2);
+  const opt = isArray(options) ? { tabs: options } : options;
+  const defaultTabs = opt.tabs?.length ? opt.tabs : DEFAULT_TABS;
+  const render = (tokens, idx) => {
+    const { attrs: attrs2 } = resolveAttrs(tokens[idx].info.slice(type2.length - 1));
+    const tabs2 = attrs2.tabs ? attrs2.tabs.split(/,\s*/) : defaultTabs;
+    if (tokens[idx].nesting === 1) {
+      const token = tokens[idx + 1];
+      const info = token.info.trim();
+      if (token.type === "fence" && (info.startsWith("sh") || info.startsWith("bash") || info.startsWith("shell"))) {
+        const content = token.content;
+        token.hidden = true;
+        token.type = "text";
+        token.content = "";
+        const lines = content.split(/(\n|\s*&&\s*)/);
+        return md.render(resolveNpmTo(lines, info, idx, tabs2), {});
+      }
+    }
+    return "";
+  };
+  md.use(container4, type2, { validate, render });
+}
+function resolveNpmTo(lines, info, idx, tabs2) {
+  tabs2 = validateTabs(tabs2);
+  const res = [];
+  const map = {};
+  for (const tab3 of tabs2) {
+    const newLines = [];
+    for (const line of lines) {
+      const config = findConfig(line);
+      if (config && config[tab3]) {
+        const parsed = map[line] ??= parseLine(line);
+        const { cli, flags } = config[tab3];
+        if (parsed) {
+          let newLine = `${parsed.env ? `${parsed.env} ` : ""}${cli}`;
+          if (parsed.args && flags) {
+            let args = parsed.args;
+            for (const [key, value] of Object.entries(flags)) {
+              args = args.replaceAll(key, value);
+            }
+            newLine += ` ${args.replace(/\s+-/g, " -").trim()}`;
+          }
+          if (parsed.cmd)
+            newLine += ` ${parsed.cmd}`;
+          if (parsed.scriptArgs)
+            newLine += ` ${parsed.scriptArgs}`;
+          newLines.push(newLine.trim());
+        }
+      } else {
+        newLines.push(line);
+      }
+    }
+    res.push(`@tab ${tab3}
+\`\`\`${info}
+${newLines.join("")}
+\`\`\``);
+  }
+  return `:::code-tabs#npm-to-${idx}
+${res.join("\n")}
+:::`;
+}
+function findConfig(line) {
+  for (const { pattern, ...config } of Object.values(MANAGERS_CONFIG)) {
+    if (pattern.test(line)) {
+      return config;
+    }
+  }
+  return void 0;
+}
+function validateTabs(tabs2) {
+  if (tabs2.length === 0) {
+    return DEFAULT_TABS;
+  }
+  return tabs2.filter((tab3) => ALLOW_LIST.includes(tab3));
+}
+var LINE_REG = /(.*)(npm|npx)\s+(.*)/;
+function parseLine(line) {
+  const match = line.match(LINE_REG);
+  if (!match)
+    return false;
+  const [, env, cli, rest] = match;
+  if (cli === "npx")
+    return { env, cli, cmd: "", scriptArgs: rest?.trim() };
+  const idx = rest.indexOf(" ");
+  if (idx === -1)
+    return { env, cli: `${cli} ${rest.trim()}`, cmd: "" };
+  return { env, cli: `${cli} ${rest.slice(0, idx)}`, ...parseArgs(rest.slice(idx + 1)) };
+}
+function parseArgs(line) {
+  line = line?.trim();
+  if (!line)
+    return { cmd: "" };
+  const [npmArgs, scriptArgs] = line.split(/\s+--\s+/);
+  let cmd = "";
+  let args = "";
+  if (npmArgs[0] !== "-") {
+    if (npmArgs[0] === '"' || npmArgs[0] === "'") {
+      const idx = npmArgs.slice(1).indexOf(npmArgs[0]);
+      cmd = npmArgs.slice(0, idx);
+      args = npmArgs.slice(idx + 1);
+    } else {
+      const idx = npmArgs.indexOf(" ");
+      if (idx === -1) {
+        cmd = npmArgs;
+      } else {
+        cmd = npmArgs.slice(0, idx);
+        args = npmArgs.slice(idx + 1);
+      }
+    }
+  } else {
+    let newLine = "";
+    let value = "";
+    let isQuote = false;
+    let isBool = false;
+    let isNextValue = false;
+    let quote = "";
+    for (let i = 0; i < npmArgs.length; i++) {
+      const v = npmArgs[i];
+      if (!isQuote && (v === '"' || v === "'")) {
+        quote = v;
+        isQuote = true;
+        value += v;
+      } else if (isQuote && v === quote) {
+        isQuote = false;
+        value += v;
+      } else if ((v === " " || v === "=" || i === npmArgs.length - 1) && !isQuote && value) {
+        if (i === npmArgs.length - 1) {
+          value += v;
+        }
+        const isKey = value[0] === "-";
+        if (isKey) {
+          isBool = BOOL_FLAGS.includes(value);
+          isNextValue = !isBool;
+        }
+        if (!isKey && !isNextValue) {
+          cmd += `${value} `;
+        } else {
+          newLine += `${value}${v || ""}`;
+          if (!isKey && isNextValue) {
+            isNextValue = false;
+          }
+        }
+        value = "";
+      } else {
+        value += v;
+      }
+    }
+    args = newLine;
+  }
+  return { cmd, args: args.trim(), scriptArgs };
+}
+
 // src/node/container/tabs.ts
 import { tab as tab2 } from "@mdit/plugin-tab";
 var tabs = (md) => {
@@ -1397,6 +1737,9 @@ async function containerPlugin(app, md, options) {
   alignPlugin(md);
   tabs(md);
   codeTabs(md, options.codeTabs);
+  if (options.npmTo) {
+    npmToPlugins(md, typeof options.npmTo === "boolean" ? {} : options.npmTo);
+  }
   if (options.repl)
     await langReplPlugin(app, md, options.repl);
   if (options.fileTree) {
@@ -1405,7 +1748,7 @@ async function containerPlugin(app, md, options) {
 }
 
 // src/node/embed/caniuse.ts
-import container4 from "markdown-it-container";
+import container5 from "markdown-it-container";
 import { customAlphabet } from "nanoid";
 
 // src/node/embed/createEmbedRuleBlock.ts
@@ -1487,7 +1830,7 @@ function legacyCaniuse(md, { mode = "embed" } = {}) {
       return "";
     }
   };
-  md.use(container4, type2, { validate, render });
+  md.use(container5, type2, { validate, render });
 }
 function resolveCanIUse({ feature, mode, versions }) {
   if (!feature)

package/lib/shared/index.d.ts

@@ -79,6 +79,11 @@ interface JSFiddleTokenMeta extends SizeOptions {
     tab?: string;
 }
 
+type NpmToPackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun' | 'deno';
+type NpmToOptions = NpmToPackageManager[] | {
+    tabs?: NpmToPackageManager[];
+};
+
 type PDFEmbedType = 'iframe' | 'embed' | 'pdfjs';
 interface PDFTokenMeta extends SizeOptions {
     page?: number;
@@ -149,6 +154,10 @@ interface MarkdownPowerPluginOptions {
      * 配置代码块分组
      */
     codeTabs?: CodeTabsOptions;
+    /**
+     * 是否启用 npm-to 容器
+     */
+    npmTo?: boolean | NpmToOptions;
     /**
      * 是否启用 PDF 嵌入语法
      *
@@ -285,4 +294,4 @@ interface YoutubeTokenMeta extends SizeOptions {
     end?: string | number;
 }
 
-export type { BilibiliTokenMeta, CanIUseMode, CanIUseOptions, CanIUseTokenMeta, CodeSandboxTokenMeta, CodeTabsOptions, CodepenTokenMeta, FileTreeIconMode, FileTreeOptions, IconsOptions, JSFiddleTokenMeta, MarkdownPowerPluginOptions, PDFEmbedType, PDFOptions, PDFTokenMeta, PlotOptions, ReplEditorData, ReplOptions, ReplitTokenMeta, SizeOptions, ThemeOptions, VideoOptions, YoutubeTokenMeta };
+export type { BilibiliTokenMeta, CanIUseMode, CanIUseOptions, CanIUseTokenMeta, CodeSandboxTokenMeta, CodeTabsOptions, CodepenTokenMeta, FileTreeIconMode, FileTreeOptions, IconsOptions, JSFiddleTokenMeta, MarkdownPowerPluginOptions, NpmToOptions, NpmToPackageManager, PDFEmbedType, PDFOptions, PDFTokenMeta, PlotOptions, ReplEditorData, ReplOptions, ReplitTokenMeta, SizeOptions, ThemeOptions, VideoOptions, YoutubeTokenMeta };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vuepress-plugin-md-power",
   "type": "module",
-  "version": "1.0.0-rc.106",
+  "version": "1.0.0-rc.107",
   "description": "The Plugin for VuePress 2 - markdown power",
   "author": "pengzhanbo <volodymyr@foxmail.com>",
   "license": "MIT",
@@ -31,8 +31,14 @@
     "lib"
   ],
   "peerDependencies": {
+    "markdown-it": "^14.0.0",
     "vuepress": "2.0.0-rc.17"
   },
+  "peerDependenciesMeta": {
+    "markdown-it": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "@mdit/plugin-attrs": "^0.13.1",
     "@mdit/plugin-footnote": "^0.13.1",
@@ -46,10 +52,10 @@
     "image-size": "^1.1.1",
     "markdown-it-container": "^4.0.0",
     "nanoid": "^5.0.7",
-    "shiki": "^1.21.0",
-    "tm-grammars": "^1.17.28",
-    "tm-themes": "^1.8.6",
-    "vue": "^3.5.10"
+    "shiki": "^1.22.0",
+    "tm-grammars": "^1.18.0",
+    "tm-themes": "^1.8.7",
+    "vue": "^3.5.11"
   },
   "devDependencies": {
     "@types/markdown-it": "^14.1.2"