vuepress-plugin-md-power 1.0.0-rc.152 → 1.0.0-rc.154

package/lib/node/index.js

@@ -6,10 +6,10 @@ import http from "node:https";
 import { URL, URLSearchParams } from "node:url";
 import { camelCase, isBoolean, isEmptyObject, isNull, isNumber, isPlainObject as isPlainObject$1, isString, isUndefined, kebabCase, notNullish, omit, toArray, uniqueBy, withTimeout } from "@pengzhanbo/utils";
 import imageSize from "image-size";
-import { colors, fs, getDirname, logger, path } from "vuepress/utils";
+import { colors, fs, getDirname, logger, ora, path } from "vuepress/utils";
 import path$1 from "node:path";
 import { globSync } from "tinyglobby";
-import { isLinkHttp as isLinkHttp$1, removeEndingSlash, removeLeadingSlash } from "vuepress/shared";
+import { isLinkHttp as isLinkHttp$1, isLinkWithProtocol, removeEndingSlash, removeLeadingSlash } from "vuepress/shared";
 import fs$1, { promises } from "node:fs";
 import process from "node:process";
 import container from "markdown-it-container";
@@ -908,7 +908,7 @@ const codeTabs = (md, options = {}) => {
 	const getIcon = createCodeTabIconGetter(options);
 	tab(md, {
 		name: "code-tabs",
-		tabsOpenRenderer: ({ active, data }, tokens, index, _, env) => {
+		openRender: ({ active, data }, tokens, index, _, env) => {
 			const { meta } = tokens[index];
 			const titles = data.map(({ title }) => md.renderInline(title, cleanMarkdownEnv(env)));
 			const tabsData = data.map((item, dataIndex) => {
@@ -921,8 +921,8 @@ const codeTabs = (md, options = {}) => {
 			}).join("");
 			return `<CodeTabs id="${index}" :data='${stringifyProp(tabsData)}'${active === -1 ? "" : ` :active="${active}"`}${meta.id ? ` tab-id="${meta.id}"` : ""}>${titlesContent}`;
 		},
-		tabsCloseRenderer: () => `</CodeTabs>`,
-		tabOpenRenderer: ({ index }, tokens, tokenIndex) => {
+		closeRender: () => `</CodeTabs>`,
+		tabOpenRender: ({ index }, tokens, tokenIndex) => {
 			let foundFence = false;
 			for (let i = tokenIndex; i < tokens.length; i++) {
 				const { type } = tokens[i];
@@ -936,7 +936,7 @@ const codeTabs = (md, options = {}) => {
 			}
 			return `<template #tab${index}="{ value, isActive }">`;
 		},
-		tabCloseRenderer: () => `</template>`
+		tabCloseRender: () => `</template>`
 	});
 };
 
@@ -985,7 +985,7 @@ const BADGE_LIST = [
 	"https://forthebadge.com",
 	"https://vercel.com/button"
 ];
-const cache$1 = new Map();
+const cache$1 = /* @__PURE__ */ new Map();
 async function imageSizePlugin(app, md, type = false) {
 	if (!app.env.isBuild || !type) return;
 	if (type === "all") {
@@ -1113,18 +1113,25 @@ function fetchImageSize(src) {
 			for await (const chunk of stream) {
 				chunks.push(chunk);
 				try {
-					const { width: width$1, height: height$1 } = imageSize(Buffer.concat(chunks));
-					if (width$1 && height$1) return resolve({
-						width: width$1,
-						height: height$1
+					const { width, height } = imageSize(Buffer.concat(chunks));
+					if (width && height) return resolve({
+						width,
+						height
 					});
 				} catch {}
 			}
-			const { width, height } = imageSize(Buffer.concat(chunks));
-			resolve({
-				width,
-				height
-			});
+			try {
+				const { width, height } = imageSize(Buffer.concat(chunks));
+				resolve({
+					width,
+					height
+				});
+			} catch {
+				resolve({
+					width: 0,
+					height: 0
+				});
+			}
 		}).on("error", () => resolve({
 			width: 0,
 			height: 0
@@ -1249,6 +1256,15 @@ function stringifyAttrs(attrs$1, withUndefined = false) {
 
 //#endregion
 //#region src/node/container/createContainer.ts
+/**
+* 创建 markdown-it 的自定义容器插件。
+*
+* @param md markdown-it 实例
+* @param type 容器类型（如 'tip', 'warning' 等）
+* @param options 可选的 before/after 渲染钩子
+* @param options.before 渲染容器起始标签时的回调函数
+* @param options.after 渲染容器结束标签时的回调函数
+*/
 function createContainerPlugin(md, type, { before, after } = {}) {
 	const render = (tokens, index, options, env) => {
 		const token = tokens[index];
@@ -1278,6 +1294,14 @@ function createContainerPlugin(md, type, { before, after } = {}) {
 function createContainerSyntaxPlugin(md, type, render) {
 	const maker = ":";
 	const markerMinLen = 3;
+	/**
+	* 自定义容器的 block 规则定义。
+	* @param state 当前 block 状态
+	* @param startLine 起始行
+	* @param endLine 结束行
+	* @param silent 是否为静默模式
+	* @returns 是否匹配到自定义容器
+	*/
 	function defineContainer(state, startLine, endLine, silent) {
 		const start = state.bMarks[startLine] + state.tShift[startLine];
 		const max = state.eMarks[startLine];
@@ -1340,6 +1364,11 @@ const UNSUPPORTED_FILE_TYPES = [
 	"xls",
 	"xlsx"
 ];
+/**
+* 将文件路径数组解析为文件树节点结构
+* @param files 文件路径数组
+* @returns 文件树节点数组
+*/
 function parseFileNodes(files) {
 	const nodes = [];
 	for (const file of files) {
@@ -1363,12 +1392,24 @@ function parseFileNodes(files) {
 	}
 	return nodes;
 }
+/**
+* 注册 code-tree 容器和嵌入语法的 markdown 插件
+* @param md markdown-it 实例
+* @param app vuepress app 实例
+* @param options code-tree 配置项
+*/
 function codeTreePlugin(md, app, options = {}) {
+	/**
+	* 获取文件或文件夹的图标
+	*/
 	const getIcon = (filename, type, mode) => {
 		mode ||= options.icon || "colored";
 		if (mode === "simple") return type === "folder" ? defaultFolder : defaultFile;
 		return getFileIcon(filename, type);
 	};
+	/**
+	* 渲染文件树节点为组件字符串
+	*/
 	function renderFileTree(nodes, mode) {
 		return nodes.map((node) => {
 			const props = {
@@ -1457,6 +1498,10 @@ function codeTreePlugin(md, app, options = {}) {
 		}
 	});
 }
+/**
+* 扩展页面依赖，将 codeTreeFiles 添加到页面依赖中
+* @param page vuepress 页面对象
+*/
 function extendsPageWithCodeTree(page) {
 	const markdownEnv = page.markdownEnv;
 	const codeTreeFiles = markdownEnv.codeTreeFiles ?? [];
@@ -1465,13 +1510,13 @@ function extendsPageWithCodeTree(page) {
 
 //#endregion
 //#region src/node/container/align.ts
-const alignList = [
-	"left",
-	"center",
-	"right",
-	"justify"
-];
 function alignPlugin(md) {
+	const alignList = [
+		"left",
+		"center",
+		"right",
+		"justify"
+	];
 	for (const name of alignList) createContainerPlugin(md, name, { before: () => `<div style="text-align:${name}">` });
 	createContainerPlugin(md, "flex", { before: (info) => {
 		const { attrs: attrs$1 } = resolveAttrs(info);
@@ -1723,6 +1768,11 @@ function fieldPlugin(md) {
 
 //#endregion
 //#region src/node/container/fileTree.ts
+/**
+* 解析原始文件树内容为节点树结构
+* @param content 文件树的原始文本内容
+* @returns 文件树节点数组
+*/
 function parseFileTreeRawContent(content) {
 	const root = {
 		info: "",
@@ -1749,6 +1799,11 @@ function parseFileTreeRawContent(content) {
 	return root.children;
 }
 const RE_FOCUS = /^\*\*(.*)\*\*(?:$|\s+)/;
+/**
+* 解析单个节点的 info 字符串，提取文件名、注释、类型等属性
+* @param info 节点描述字符串
+* @returns 文件树节点属性
+*/
 function parseFileTreeNodeInfo(info) {
 	let filename = "";
 	let comment = "";
@@ -1788,12 +1843,23 @@ function parseFileTreeNodeInfo(info) {
 		diff
 	};
 }
+/**
+* 文件树 markdown 插件主函数
+* @param md markdown 实例
+* @param options 文件树渲染选项
+*/
 function fileTreePlugin(md, options = {}) {
+	/**
+	* 获取文件或文件夹的图标
+	*/
 	const getIcon = (filename, type, mode) => {
 		mode ||= options.icon || "colored";
 		if (mode === "simple") return type === "folder" ? defaultFolder : defaultFile;
 		return getFileIcon(filename, type);
 	};
+	/**
+	* 递归渲染文件树节点
+	*/
 	const renderFileTree = (nodes, meta) => nodes.map((node) => {
 		const { info, level, children } = node;
 		const { filename, comment, focus, expanded, type, diff } = parseFileTreeNodeInfo(info);
@@ -1828,7 +1894,7 @@ ${renderedIcon}${renderedComment}${children.length > 0 ? renderFileTree(children
 
 //#endregion
 //#region src/node/container/langRepl.ts
-async function langReplPlugin(app, md, { theme, go = false, kotlin = false, rust = false }) {
+async function langReplPlugin(app, md, { theme, go = false, kotlin = false, rust = false, python = false }) {
 	const container$1 = (lang) => createContainerPlugin(md, `${lang}-repl`, {
 		before(info) {
 			const { attrs: attrs$1 } = resolveAttrs(info);
@@ -1843,6 +1909,7 @@ async function langReplPlugin(app, md, { theme, go = false, kotlin = false, rust
 	if (kotlin) container$1("kotlin");
 	if (go) container$1("go");
 	if (rust) container$1("rust");
+	if (python) container$1("python");
 	theme ??= {
 		light: "github-light",
 		dark: "github-dark"
@@ -1861,6 +1928,7 @@ async function langReplPlugin(app, md, { theme, go = false, kotlin = false, rust
 		if (kotlin) data.grammars.kotlin = await readGrammar("kotlin");
 		if (go) data.grammars.go = await readGrammar("go");
 		if (rust) data.grammars.rust = await readGrammar("rust");
+		if (python) data.grammars.python = await readGrammar("python");
 	} catch {
 		/* istanbul ignore next -- @preserve */
 		logger.error("[vuepress-plugin-md-power]", `Failed to load packages: ${colors.green("tm-themes")}, ${colors.green("tm-grammars")}, Please install them manually.`);
@@ -1875,6 +1943,59 @@ async function read(file) {
 	return void 0;
 }
 
+//#endregion
+//#region src/node/utils/logger.ts
+/**
+* Logger utils
+*/
+var Logger = class {
+	constructor(name = "") {
+		this.name = name;
+	}
+	init(subname, text) {
+		return ora({
+			prefixText: colors.blue(`${this.name}${subname ? `:${subname}` : ""}: `),
+			text
+		});
+	}
+	/**
+	* Create a loading spinner with text
+	*/
+	load(subname, msg) {
+		const instance = this.init(subname, msg);
+		return {
+			succeed: (text) => instance.succeed(text),
+			fail: (text) => instance.succeed(text)
+		};
+	}
+	info(subname, text = "", ...args) {
+		this.init(subname, colors.blue(text)).info();
+		if (args.length) console.info(...args);
+	}
+	/**
+	* Log success msg
+	*/
+	succeed(subname, text = "", ...args) {
+		this.init(subname, colors.green(text)).succeed();
+		if (args.length) console.log(...args);
+	}
+	/**
+	* Log warning msg
+	*/
+	warn(subname, text = "", ...args) {
+		this.init(subname, colors.yellow(text)).warn();
+		if (args.length) console.warn(...args);
+	}
+	/**
+	* Log error msg
+	*/
+	error(subname, text = "", ...args) {
+		this.init(subname, colors.red(text)).fail();
+		if (args.length) console.error(...args);
+	}
+};
+const logger$1 = new Logger("vuepress-plugin-md-power");
+
 //#endregion
 //#region src/node/container/npmToPreset.ts
 const ALLOW_LIST = [
@@ -2124,6 +2245,9 @@ const MANAGERS_CONFIG = {
 
 //#endregion
 //#region src/node/container/npmTo.ts
+/**
+* 注册 npm-to 容器插件，将 npm 代码块自动转换为多包管理器命令分组
+*/
 function npmToPlugins(md, options = {}) {
 	const opt = isArray(options) ? { tabs: options } : options;
 	const defaultTabs = opt.tabs?.length ? opt.tabs : DEFAULT_TABS;
@@ -2140,12 +2264,19 @@ function npmToPlugins(md, options = {}) {
 				const lines = content.split(/(\n|\s*&&\s*)/);
 				return md.render(resolveNpmTo(lines, token.info.trim(), idx, tabs$1), cleanMarkdownEnv(env));
 			}
-			console.warn(`${colors.yellow("[vuepress-plugin-md-power]")} Invalid npm-to container in ${colors.gray(env.filePathRelative || env.filePath)}`);
+			logger$1.warn("npm-to", `Invalid npm-to container in ${colors.gray(env.filePathRelative || env.filePath)}`);
 			return "";
 		},
 		after: () => ""
 	});
 }
+/**
+* 将 npm 命令转换为各包管理器命令分组
+* @param lines 命令行数组
+* @param info 代码块类型
+* @param idx token 索引
+* @param tabs 需要支持的包管理器
+*/
 function resolveNpmTo(lines, info, idx, tabs$1) {
 	tabs$1 = validateTabs(tabs$1);
 	const res = [];
@@ -2172,16 +2303,25 @@ function resolveNpmTo(lines, info, idx, tabs$1) {
 	}
 	return `:::code-tabs#npm-to-${tabs$1.join("-")}\n${res.join("\n")}\n:::`;
 }
+/**
+* 根据命令行内容查找对应的包管理器配置
+*/
 function findConfig(line) {
 	for (const { pattern,...config } of Object.values(MANAGERS_CONFIG)) if (pattern.test(line)) return config;
 	return void 0;
 }
+/**
+* 校验 tabs 合法性，返回允许的包管理器列表
+*/
 function validateTabs(tabs$1) {
 	tabs$1 = tabs$1.filter((tab$1) => ALLOW_LIST.includes(tab$1));
 	if (tabs$1.length === 0) return DEFAULT_TABS;
 	return tabs$1;
 }
 const LINE_REG = /(.*)(npm|npx)\s+(.*)/;
+/**
+* 解析一行 npm/npx 命令，拆分出环境变量、命令、参数等
+*/
 function parseLine(line) {
 	const match = line.match(LINE_REG);
 	if (!match) return false;
@@ -2212,6 +2352,9 @@ function parseLine(line) {
 		...parseArgs(rest.slice(idx + 1))
 	};
 }
+/**
+* 解析 npm 命令参数，区分命令、参数、脚本参数
+*/
 function parseArgs(line) {
 	line = line?.trim();
 	const [npmArgs, scriptArgs] = line.split(/\s+--\s+/);
@@ -2289,7 +2432,7 @@ function stepsPlugin(md) {
 const tabs = (md) => {
 	tab(md, {
 		name: "tabs",
-		tabsOpenRenderer: ({ active, data }, tokens, index, _, env) => {
+		openRender: ({ active, data }, tokens, index, _, env) => {
 			const { meta } = tokens[index];
 			const titles = data.map(({ title }) => md.renderInline(title, cleanMarkdownEnv(env)));
 			const tabsData = data.map((item, dataIndex) => {
@@ -2299,9 +2442,9 @@ const tabs = (md) => {
 			return `<Tabs id="${index}" :data='${stringifyProp(tabsData)}'${active === -1 ? "" : ` :active="${active}"`}${meta.id ? ` tab-id="${meta.id}"` : ""}>
 ${titles.map((title, titleIndex) => `<template #title${titleIndex}="{ value, isActive }">${title}</template>`).join("")}`;
 		},
-		tabsCloseRenderer: () => `</Tabs>`,
-		tabOpenRenderer: ({ index }) => `<template #tab${index}="{ value, isActive }">`,
-		tabCloseRenderer: () => `</template>`
+		closeRender: () => `</Tabs>`,
+		tabOpenRender: ({ index }) => `<template #tab${index}="{ value, isActive }">`,
+		tabCloseRender: () => `</template>`
 	});
 };
 
@@ -2417,7 +2560,7 @@ function markdownEmbed(app, md, env, { url, title, desc, codeSetting = "", expan
 	const filepath$1 = findFile(app, env, url);
 	const code = readFileSync(filepath$1);
 	if (code === false) {
-		console.warn("[vuepress-plugin-md-power] Cannot read markdown file:", filepath$1);
+		logger$1.warn("demo-markdown", `Cannot read markdown file: ${colors.gray(filepath$1)}\n  at: ${colors.gray(env.filePathRelative || "")}`);
 		return "";
 	}
 	const demo = {
@@ -2692,7 +2835,7 @@ async function compileCode(code, output) {
 		if (code.css) res.css = await compileStyle(code.css.trim(), code.cssType);
 		if (code.html) res.html = code.html.trim();
 	} catch (e) {
-		console.error("[vuepress-plugin-md-power] demo parse error: \n", e);
+		logger$1.error("demo-normal", "demo parse error: \n", e);
 	}
 	writeFileSync(output, `import { ref } from "vue"\nexport default ref(${JSON.stringify(res, null, 2)})`);
 	checkDemoRender();
@@ -2701,7 +2844,7 @@ function normalEmbed(app, md, env, { url, title, desc, codeSetting = "", expande
 	const filepath$1 = findFile(app, env, url);
 	const code = readFileSync(filepath$1);
 	if (code === false) {
-		console.warn("[vuepress-plugin-md-power] Cannot read demo file:", filepath$1);
+		logger$1.warn("demo-normal", `Cannot read demo file: ${colors.gray(filepath$1)}\n  at: ${colors.gray(env.filePathRelative || "")}`);
 		return "";
 	}
 	const source = parseEmbedCode(code);
@@ -2830,7 +2973,7 @@ function vueEmbed(app, md, env, { url, title, desc, codeSetting = "", expanded =
 	const filepath$1 = findFile(app, env, url);
 	const code = readFileSync(filepath$1);
 	if (code === false) {
-		console.warn("[vuepress-plugin-md-power] Cannot read vue file:", filepath$1);
+		logger$1.warn("demo-vue", `Cannot read vue demo file: ${colors.gray(filepath$1)}\n  at: ${colors.gray(env.filePathRelative || "")}`);
 		return "";
 	}
 	const basename = path$1.basename(filepath$1).replace(/-|\./g, "_");
@@ -2947,6 +3090,15 @@ function transformStyle(code) {
 
 //#endregion
 //#region src/node/demo/demo.ts
+const embedMap = {
+	vue: vueEmbed,
+	normal: normalEmbed,
+	markdown: markdownEmbed
+};
+/**
+* 嵌入语法
+* @[demo type info](url)
+*/
 function demoEmbed(app, md) {
 	createEmbedRuleBlock(md, {
 		type: "demo",
@@ -2959,12 +3111,10 @@ function demoEmbed(app, md) {
 		content: (meta, content, env) => {
 			const { url, type } = meta;
 			if (!url) {
-				console.warn("[vuepress-plugin-md-power] Invalid demo url: ", url);
+				logger$1.warn("demo-vue", `Invalid filepath: ${colors.gray(url)}`);
 				return content;
 			}
-			if (type === "vue") return vueEmbed(app, md, env, meta);
-			if (type === "normal") return normalEmbed(app, md, env, meta);
-			if (type === "markdown") return markdownEmbed(app, md, env, meta);
+			if (embedMap[type]) return embedMap[type](app, md, env, meta);
 			return content;
 		}
 	});
@@ -3074,7 +3224,7 @@ const audioReader = (state, silent) => {
 };
 const audioReaderPlugin = (md) => {
 	md.renderer.rules.audio_reader = (tokens, idx) => {
-		const meta = tokens[idx].meta ?? {};
+		const meta = tokens[idx].meta;
 		if (meta.startTime) meta.startTime = Number(meta.startTime);
 		if (meta.endTime) meta.endTime = Number(meta.endTime);
 		if (meta.volume) meta.volume = Number(meta.volume);
@@ -3355,10 +3505,10 @@ function checkSupportType(type) {
 				break;
 		}
 		/* istanbul ignore if -- @preserve */
-		if (name) console.warn(`${colors.yellow("[vuepress-plugin-md-power] artPlayer: ")} ${colors.cyan(name)} is not installed, please install it via npm or yarn or pnpm`);
+		if (name) logger$1.warn("artPlayer", `${colors.cyan(name)} is not installed, please install it via npm or yarn or pnpm`);
 	} else
  /* istanbul ignore next -- @preserve */
-	console.warn(`${colors.yellow("[vuepress-plugin-md-power] artPlayer: ")} unsupported video type: ${colors.cyan(type)}`);
+	logger$1.warn("artPlayer", `unsupported video type: ${colors.cyan(type)}`);
 }
 
 //#endregion
@@ -3520,6 +3670,46 @@ function parseSource(source) {
 	}
 }
 
+//#endregion
+//#region src/node/enhance/links.ts
+function linksPlugin(md) {
+	const externalAttrs = {
+		target: "_blank",
+		rel: "noopener noreferrer"
+	};
+	let hasOpenInternalLink = false;
+	const internalTag = "VPLink";
+	function handleLinkOpen(tokens, idx) {
+		hasOpenInternalLink = false;
+		const token = tokens[idx];
+		const hrefIndex = token.attrIndex("href");
+		/* istanbul ignore if -- @preserve */
+		if (hrefIndex < 0) return;
+		const hrefAttr = token.attrs[hrefIndex];
+		const hrefLink = hrefAttr[1];
+		if (isLinkWithProtocol(hrefLink)) {
+			Object.entries(externalAttrs).forEach(([key, val]) => {
+				token.attrSet(key, val);
+			});
+			return;
+		}
+		if (hrefLink[0] === "#") return;
+		hasOpenInternalLink = true;
+		token.tag = internalTag;
+	}
+	md.renderer.rules.link_open = (tokens, idx, opts, env, self) => {
+		handleLinkOpen(tokens, idx);
+		return self.renderToken(tokens, idx, opts);
+	};
+	md.renderer.rules.link_close = (tokens, idx, opts, _env, self) => {
+		if (hasOpenInternalLink) {
+			hasOpenInternalLink = false;
+			tokens[idx].tag = internalTag;
+		}
+		return self.renderToken(tokens, idx, opts);
+	};
+}
+
 //#endregion
 //#region src/node/icon/createIconRule.ts
 function createIconRule([l1, l2, r1, r2], deprecated) {
@@ -3636,7 +3826,7 @@ const iconPlugin = (md, options = {}) => {
 			const [name, opt = ""] = content.split(" ");
 			const [size, color] = opt.trim().split("/");
 			icon = `${name}${size ? ` =${size}` : ""}${color ? ` /${color}` : ""}`;
-			console.warn(`The icon syntax of \`${colors.yellow(`:[${content}]:`)}\` is deprecated, please use \`${colors.green(`::${icon}::`)}\` instead. (${colors.gray(env.filePathRelative || env.filePath)})`);
+			logger$1.warn("icon", `The icon syntax of \`${colors.yellow(`:[${content}]:`)}\` is deprecated, please use \`${colors.green(`::${icon}::`)}\` instead. (${colors.gray(env.filePathRelative || env.filePath)})`);
 		}
 		return iconRender(icon, options);
 	};
@@ -3689,7 +3879,7 @@ function normalizeAsset(asset, provide) {
 		link,
 		provide
 	};
-	console.error(`[vuepress:icon] Can not recognize icon link: "${asset}"`);
+	logger$1.error("icon", `Can not recognize icon link: "${asset}"`);
 	return null;
 }
 function normalizeLink(link) {
@@ -3881,18 +4071,18 @@ const plotDef = (state, silent) => {
 	const content = state.src.slice(start + 2, state.pos);
 	state.posMax = state.pos;
 	state.pos = start + 2;
-	const token = state.push("plot_inline", "Plot", 0);
-	token.markup = "!!";
-	token.content = content;
+	const openToken = state.push("plot_inline_open", "Plot", 1);
+	openToken.markup = "!!";
+	openToken.content = content;
+	const contentToken = state.push("text", "", 0);
+	contentToken.content = content;
+	const closeToken = state.push("plot_inline_close", "Plot", -1);
+	closeToken.markup = "!!";
 	state.pos = state.posMax + 2;
 	state.posMax = max;
 	return true;
 };
 const plotPlugin = (md) => {
-	md.renderer.rules.plot_inline = (tokens, idx) => {
-		const token = tokens[idx];
-		return `<Plot>${token.content}</Plot>`;
-	};
 	md.inline.ruler.before("emphasis", "plot", plotDef);
 };
 
@@ -3928,8 +4118,8 @@ const { url: filepath } = import.meta;
 const __dirname = getDirname(filepath);
 const CLIENT_FOLDER = ensureEndingSlash(path.resolve(__dirname, "../client"));
 async function prepareConfigFile(app, options) {
-	const imports = new Set();
-	const enhances = new Set();
+	const imports = /* @__PURE__ */ new Set();
+	const enhances = /* @__PURE__ */ new Set();
 	imports.add(`import Tabs from '${CLIENT_FOLDER}components/Tabs.vue'`);
 	enhances.add(`app.component('Tabs', Tabs)`);
 	imports.add(`import CodeTabs from '${CLIENT_FOLDER}components/CodeTabs.vue'`);
@@ -4065,11 +4255,14 @@ function markdownPowerPlugin(options = {}) {
 		clientConfigFile: (app) => prepareConfigFile(app, options),
 		define: provideData(options),
 		extendsBundlerOptions(bundlerOptions, app) {
-			if (options.repl) addViteOptimizeDepsInclude(bundlerOptions, app, [
-				"shiki/core",
-				"shiki/wasm",
-				"shiki/engine/oniguruma"
-			]);
+			if (options.repl) {
+				addViteOptimizeDepsInclude(bundlerOptions, app, [
+					"shiki/core",
+					"shiki/wasm",
+					"shiki/engine/oniguruma"
+				]);
+				if (options.repl.python) addViteOptimizeDepsInclude(bundlerOptions, app, ["pyodide"]);
+			}
 			if (options.artPlayer) addViteOptimizeDepsInclude(bundlerOptions, app, [
 				"artplayer",
 				"dashjs",
@@ -4078,6 +4271,7 @@ function markdownPowerPlugin(options = {}) {
 			]);
 		},
 		extendsMarkdown: async (md, app) => {
+			linksPlugin(md);
 			docsTitlePlugin(md);
 			embedSyntaxPlugin(md, options);
 			inlineSyntaxPlugin(md, options);