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

package/lib/client/components/CodeEditor.vue

@@ -11,7 +11,7 @@ let container: HTMLPreElement | null = null
 let lineNumbers: HTMLDivElement | null = null
 const { grammars, theme } = editorData
 
-const lang = ref<'go' | 'rust' | 'kotlin'>()
+const lang = ref<'go' | 'rust' | 'kotlin' | 'python'>()
 
 const editorEl = shallowRef<HTMLDivElement>()
 const textAreaEl = shallowRef<HTMLTextAreaElement>()

package/lib/client/composables/audio.d.ts

@@ -36,5 +36,6 @@ interface UseAudioPlayerResult {
   setVolume: (volume: number) => void;
   destroy: () => void;
 }
-declare function useAudioPlayer(source: MaybeRef<string>, options?: AudioPlayerOptions): UseAudioPlayerResult; //#endregion
+declare function useAudioPlayer(source: MaybeRef<string>, options?: AudioPlayerOptions): UseAudioPlayerResult;
+//#endregion
 export { AudioPlayerOptions, BufferedRange, useAudioPlayer };

package/lib/client/composables/codeRepl.d.ts

@@ -1,7 +1,7 @@
 import { Ref } from "vue";
 
 //#region src/client/composables/codeRepl.d.ts
-type Lang = "kotlin" | "go" | "rust";
+type Lang = "kotlin" | "go" | "rust" | "python";
 declare function resolveCode(el: HTMLElement): string;
 declare function resolveCodeInfo(el: HTMLDivElement): {
   lang: Lang;
@@ -20,6 +20,5 @@ interface UseCodeReplResult {
   onRunCode: () => Promise<void>;
 }
 declare function useCodeRepl(el: Ref<HTMLDivElement | null>): UseCodeReplResult;
-
 //#endregion
 export { resolveCode, resolveCodeInfo, useCodeRepl };

package/lib/client/composables/codeRepl.js

@@ -10,17 +10,21 @@ const api = {
 	go: "https://api.pengzhanbo.cn/repl/golang/run",
 	kotlin: "https://api.pengzhanbo.cn/repl/kotlin/run"
 };
+let pyodide = null;
 const langAlias = {
 	kt: "kotlin",
 	kotlin: "kotlin",
 	go: "go",
 	rust: "rust",
-	rs: "rust"
+	rs: "rust",
+	py: "python",
+	python: "python"
 };
 const supportLang = [
 	"kotlin",
 	"go",
-	"rust"
+	"rust",
+	"python"
 ];
 function resolveLang(lang) {
 	return lang ? langAlias[lang] || lang : "";
@@ -59,7 +63,8 @@ function useCodeRepl(el) {
 	const executeMap = {
 		kotlin: executeKotlin,
 		go: executeGolang,
-		rust: executeRust
+		rust: executeRust,
+		python: executePython
 	};
 	function onCleanRun() {
 		loaded.value = false;
@@ -142,6 +147,24 @@ function useCodeRepl(el) {
 			}
 		});
 	}
+	async function executePython(code) {
+		loaded.value = false;
+		finished.value = false;
+		if (pyodide === null) {
+			const { loadPyodide, version } = await import(
+			/* webpackChunkName: "pyodide" */
+			"pyodide");
+			pyodide = await loadPyodide({ indexURL: `https://cdn.jsdelivr.net/pyodide/v${version}/full/` });
+		}
+		pyodide.setStdout({ batched: (msg) => stdout.value.push(msg) });
+		try {
+			stdout.value.push(pyodide.runPython(code));
+		} catch (e) {
+			stderr.value.push(String(e));
+		}
+		loaded.value = true;
+		finished.value = true;
+	}
 	return {
 		onRunCode,
 		onCleanRun,

package/lib/client/composables/demo.d.ts

@@ -36,6 +36,5 @@ declare function useNormalDemo(draw: ShallowRef<HTMLIFrameElement | null>, title
   height: Ref<string>;
 };
 declare function parseData(data: any): any;
-
 //#endregion
 export { DemoConfig, parseData, useExpand, useFence, useNormalDemo, useResources };

package/lib/client/composables/rustRepl.d.ts

@@ -13,6 +13,5 @@ interface RustExecuteOptions {
   onEnd?: () => void;
   onError?: (message: string) => void;
 }
-
 //#endregion
 export { rustExecute };

package/lib/client/composables/size.d.ts

@@ -11,6 +11,5 @@ interface SizeInfo<T extends HTMLElement> {
   resize: () => void;
 }
 declare function useSize<T extends HTMLElement>(options: ToRefs<SizeOptions>, extraHeight?: MaybeRef$1<number>): SizeInfo<T>;
-
 //#endregion
 export { SizeInfo, useSize };

package/lib/client/options.d.ts

@@ -9,5 +9,6 @@ declare const installed: {
 };
 declare const ART_PLAYER_SUPPORTED_VIDEO_TYPES: string[];
 declare const INJECT_TIMELINE_KEY: symbol;
-declare const INJECT_COLLAPSE_KEY: symbol; //#endregion
+declare const INJECT_COLLAPSE_KEY: symbol;
+//#endregion
 export { ART_PLAYER_SUPPORTED_VIDEO_TYPES, INJECT_COLLAPSE_KEY, INJECT_TIMELINE_KEY, installed, pluginOptions };

package/lib/client/utils/http.d.ts

@@ -3,6 +3,5 @@ declare const http: {
   get: <T extends object = object, R = any>(url: string, query?: T) => Promise<R>;
   post: <T extends object = object, R = any>(url: string, data?: T) => Promise<R>;
 };
-
 //#endregion
 export { http };

package/lib/client/utils/link.d.ts

@@ -1,5 +1,4 @@
 //#region src/client/utils/link.d.ts
 declare function normalizeLink(url: string): string;
-
 //#endregion
 export { normalizeLink };

package/lib/client/utils/sleep.d.ts

@@ -1,5 +1,4 @@
 //#region src/client/utils/sleep.d.ts
 declare function sleep(ms: number): Promise<void>;
-
 //#endregion
 export { sleep };

package/lib/node/index.d.ts

@@ -23,14 +23,14 @@ interface CanIUseOptions {
   * @default 'embed'
   */
   mode?: CanIUseMode;
-} //#endregion
+}
+//#endregion
 //#region src/shared/size.d.ts
 interface SizeOptions {
   width?: string;
   height?: string;
   ratio?: number | string;
 }
-
 //#endregion
 //#region src/shared/codepen.d.ts
 interface CodepenTokenMeta extends SizeOptions {
@@ -42,7 +42,6 @@ interface CodepenTokenMeta extends SizeOptions {
   preview?: boolean;
   editable?: boolean;
 }
-
 //#endregion
 //#region src/shared/codeSandbox.d.ts
 interface CodeSandboxTokenMeta extends SizeOptions {
@@ -55,7 +54,6 @@ interface CodeSandboxTokenMeta extends SizeOptions {
   navbar?: boolean;
   console?: boolean;
 }
-
 //#endregion
 //#region src/shared/codeTabs.d.ts
 interface CodeTabsOptions {
@@ -64,7 +62,6 @@ interface CodeTabsOptions {
     extensions?: false | string[];
   };
 }
-
 //#endregion
 //#region src/shared/demo.d.ts
 interface DemoFile {
@@ -89,14 +86,12 @@ interface DemoContainerRender {
   after: () => string;
   token?: (token: Token, tokens: Token[], index: number) => void;
 }
-
 //#endregion
 //#region src/shared/fileTree.d.ts
 type FileTreeIconMode = "simple" | "colored";
 interface FileTreeOptions {
   icon?: FileTreeIconMode;
 }
-
 //#endregion
 //#region src/shared/icon.d.ts
 type IconOptions = IconifyProvider | IconFontProvider | FontAwesomeProvider;
@@ -159,7 +154,6 @@ type IconifyPrefix = "material-symbols" | "material-symbols-light" | "ic" | "mdi
 type LiteralUnion<Union extends Base, Base = string> = Union | (Base & {
   zz_IGNORE_ME?: never;
 });
-
 //#endregion
 //#region src/shared/jsfiddle.d.ts
 interface JSFiddleTokenMeta extends SizeOptions {
@@ -168,14 +162,12 @@ interface JSFiddleTokenMeta extends SizeOptions {
   theme?: string;
   tab?: string;
 }
-
 //#endregion
 //#region src/shared/npmTo.d.ts
 type NpmToPackageManager = "npm" | "pnpm" | "yarn" | "bun" | "deno";
 type NpmToOptions = NpmToPackageManager[] | {
   tabs?: NpmToPackageManager[];
 };
-
 //#endregion
 //#region src/shared/pdf.d.ts
 type PDFEmbedType = "iframe" | "embed" | "pdfjs";
@@ -192,7 +184,6 @@ interface PDFOptions {
   */
   pdfjsUrl?: string;
 }
-
 //#endregion
 //#region src/shared/plot.d.ts
 interface PlotOptions {
@@ -222,14 +213,12 @@ interface PlotOptions {
   */
   trigger?: "hover" | "click";
 }
-
 //#endregion
 //#region src/shared/codeTree.d.ts
 interface CodeTreeOptions {
   icon?: FileTreeIconMode;
   height?: string | number;
 }
-
 //#endregion
 //#region src/shared/repl.d.ts
 type ThemeOptions = BuiltinTheme | {
@@ -241,19 +230,20 @@ interface ReplOptions {
   go?: boolean;
   kotlin?: boolean;
   rust?: boolean;
+  python?: boolean;
 }
 interface ReplEditorData {
   grammars: {
     go?: any;
     kotlin?: any;
     rust?: any;
+    python?: any;
   };
   theme: ThemeRegistration | {
     light: ThemeRegistration;
     dark: ThemeRegistration;
   };
 }
-
 //#endregion
 //#region src/shared/plugin.d.ts
 interface MarkdownPowerPluginOptions {
@@ -482,14 +472,14 @@ interface MarkdownPowerPluginOptions {
   * @default false
   */
   imageSize?: boolean | "local" | "all";
-} //#endregion
+}
+//#endregion
 //#region src/shared/replit.d.ts
 interface ReplitTokenMeta extends SizeOptions {
   title?: string;
   source?: string;
   theme?: string;
 }
-
 //#endregion
 //#region src/shared/video.d.ts
 interface VideoOptions {
@@ -523,11 +513,9 @@ interface ArtPlayerTokenMeta extends SizeOptions {
   url: string;
   type?: string;
 }
-
 //#endregion
 //#region src/node/container/codeTabs.d.ts
 declare function createCodeTabIconGetter(options?: CodeTabsOptions): (filename: string) => string | void;
-
 //#endregion
 //#region src/node/enhance/imageSize.d.ts
 interface ImgSize {
@@ -535,10 +523,8 @@ interface ImgSize {
   height: number;
 }
 declare function resolveImageSize(app: App, url: string, remote?: boolean): Promise<ImgSize>;
-
 //#endregion
 //#region src/node/plugin.d.ts
 declare function markdownPowerPlugin(options?: MarkdownPowerPluginOptions): Plugin;
-
 //#endregion
 export { ArtPlayerTokenMeta, BilibiliTokenMeta, CanIUseMode, CanIUseOptions, CanIUseTokenMeta, CodeSandboxTokenMeta, CodeTabsOptions, CodepenTokenMeta, DemoContainerRender, DemoFile, DemoMeta, FileTreeIconMode, FileTreeOptions, FontAwesomeAssetBuiltIn, FontAwesomePrefix, FontAwesomeProvider, IconAssetLink, IconFontProvider, IconOptions, IconProviderBase, IconifyPrefix, IconifyProvider, JSFiddleTokenMeta, LiteralUnion, MarkdownDemoEnv, MarkdownPowerPluginOptions, NpmToOptions, NpmToPackageManager, PDFEmbedType, PDFOptions, PDFTokenMeta, PlotOptions, ReplEditorData, ReplOptions, ReplitTokenMeta, SizeOptions, ThemeOptions, VideoOptions, YoutubeTokenMeta, createCodeTabIconGetter, markdownPowerPlugin, resolveImageSize };

package/lib/node/index.js

@@ -6,7 +6,7 @@ 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";
@@ -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") {
@@ -1249,6 +1249,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 +1287,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 +1357,11 @@ const UNSUPPORTED_FILE_TYPES = [
 	"xls",
 	"xlsx"
 ];
+/**
+* 将文件路径数组解析为文件树节点结构
+* @param files 文件路径数组
+* @returns 文件树节点数组
+*/
 function parseFileNodes(files) {
 	const nodes = [];
 	for (const file of files) {
@@ -1363,12 +1385,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 +1491,10 @@ function codeTreePlugin(md, app, options = {}) {
 		}
 	});
 }
+/**
+* 扩展页面依赖，将 codeTreeFiles 添加到页面依赖中
+* @param page vuepress 页面对象
+*/
 function extendsPageWithCodeTree(page) {
 	const markdownEnv = page.markdownEnv;
 	const codeTreeFiles = markdownEnv.codeTreeFiles ?? [];
@@ -1465,13 +1503,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 +1761,11 @@ function fieldPlugin(md) {
 
 //#endregion
 //#region src/node/container/fileTree.ts
+/**
+* 解析原始文件树内容为节点树结构
+* @param content 文件树的原始文本内容
+* @returns 文件树节点数组
+*/
 function parseFileTreeRawContent(content) {
 	const root = {
 		info: "",
@@ -1749,6 +1792,11 @@ function parseFileTreeRawContent(content) {
 	return root.children;
 }
 const RE_FOCUS = /^\*\*(.*)\*\*(?:$|\s+)/;
+/**
+* 解析单个节点的 info 字符串，提取文件名、注释、类型等属性
+* @param info 节点描述字符串
+* @returns 文件树节点属性
+*/
 function parseFileTreeNodeInfo(info) {
 	let filename = "";
 	let comment = "";
@@ -1788,12 +1836,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 +1887,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 +1902,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 +1921,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 +1936,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 +2238,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 +2257,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 +2296,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 +2345,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 +2425,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 +2435,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 +2553,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 +2828,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 +2837,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 +2966,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 +3083,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 +3104,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 +3217,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 +3498,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
@@ -3636,7 +3779,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 +3832,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) {
@@ -3928,8 +4071,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 +4208,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",

package/lib/shared/index.d.ts

@@ -21,14 +21,14 @@ interface CanIUseOptions {
   * @default 'embed'
   */
   mode?: CanIUseMode;
-} //#endregion
+}
+//#endregion
 //#region src/shared/size.d.ts
 interface SizeOptions {
   width?: string;
   height?: string;
   ratio?: number | string;
 }
-
 //#endregion
 //#region src/shared/codepen.d.ts
 interface CodepenTokenMeta extends SizeOptions {
@@ -40,7 +40,6 @@ interface CodepenTokenMeta extends SizeOptions {
   preview?: boolean;
   editable?: boolean;
 }
-
 //#endregion
 //#region src/shared/codeSandbox.d.ts
 interface CodeSandboxTokenMeta extends SizeOptions {
@@ -53,7 +52,6 @@ interface CodeSandboxTokenMeta extends SizeOptions {
   navbar?: boolean;
   console?: boolean;
 }
-
 //#endregion
 //#region src/shared/codeTabs.d.ts
 interface CodeTabsOptions {
@@ -62,7 +60,6 @@ interface CodeTabsOptions {
     extensions?: false | string[];
   };
 }
-
 //#endregion
 //#region src/shared/demo.d.ts
 interface DemoFile {
@@ -87,14 +84,12 @@ interface DemoContainerRender {
   after: () => string;
   token?: (token: Token, tokens: Token[], index: number) => void;
 }
-
 //#endregion
 //#region src/shared/fileTree.d.ts
 type FileTreeIconMode = "simple" | "colored";
 interface FileTreeOptions {
   icon?: FileTreeIconMode;
 }
-
 //#endregion
 //#region src/shared/icon.d.ts
 type IconOptions = IconifyProvider | IconFontProvider | FontAwesomeProvider;
@@ -157,7 +152,6 @@ type IconifyPrefix = "material-symbols" | "material-symbols-light" | "ic" | "mdi
 type LiteralUnion<Union extends Base, Base = string> = Union | (Base & {
   zz_IGNORE_ME?: never;
 });
-
 //#endregion
 //#region src/shared/jsfiddle.d.ts
 interface JSFiddleTokenMeta extends SizeOptions {
@@ -166,14 +160,12 @@ interface JSFiddleTokenMeta extends SizeOptions {
   theme?: string;
   tab?: string;
 }
-
 //#endregion
 //#region src/shared/npmTo.d.ts
 type NpmToPackageManager = "npm" | "pnpm" | "yarn" | "bun" | "deno";
 type NpmToOptions = NpmToPackageManager[] | {
   tabs?: NpmToPackageManager[];
 };
-
 //#endregion
 //#region src/shared/pdf.d.ts
 type PDFEmbedType = "iframe" | "embed" | "pdfjs";
@@ -190,7 +182,6 @@ interface PDFOptions {
   */
   pdfjsUrl?: string;
 }
-
 //#endregion
 //#region src/shared/plot.d.ts
 interface PlotOptions {
@@ -220,14 +211,12 @@ interface PlotOptions {
   */
   trigger?: "hover" | "click";
 }
-
 //#endregion
 //#region src/shared/codeTree.d.ts
 interface CodeTreeOptions {
   icon?: FileTreeIconMode;
   height?: string | number;
 }
-
 //#endregion
 //#region src/shared/repl.d.ts
 type ThemeOptions = BuiltinTheme | {
@@ -239,19 +228,20 @@ interface ReplOptions {
   go?: boolean;
   kotlin?: boolean;
   rust?: boolean;
+  python?: boolean;
 }
 interface ReplEditorData {
   grammars: {
     go?: any;
     kotlin?: any;
     rust?: any;
+    python?: any;
   };
   theme: ThemeRegistration | {
     light: ThemeRegistration;
     dark: ThemeRegistration;
   };
 }
-
 //#endregion
 //#region src/shared/plugin.d.ts
 interface MarkdownPowerPluginOptions {
@@ -480,14 +470,14 @@ interface MarkdownPowerPluginOptions {
   * @default false
   */
   imageSize?: boolean | "local" | "all";
-} //#endregion
+}
+//#endregion
 //#region src/shared/replit.d.ts
 interface ReplitTokenMeta extends SizeOptions {
   title?: string;
   source?: string;
   theme?: string;
 }
-
 //#endregion
 //#region src/shared/video.d.ts
 interface VideoOptions {
@@ -521,6 +511,5 @@ interface ArtPlayerTokenMeta extends SizeOptions {
   url: string;
   type?: string;
 }
-
 //#endregion
 export { ArtPlayerTokenMeta, BilibiliTokenMeta, CanIUseMode, CanIUseOptions, CanIUseTokenMeta, CodeSandboxTokenMeta, CodeTabsOptions, CodepenTokenMeta, DemoContainerRender, DemoFile, DemoMeta, FileTreeIconMode, FileTreeOptions, FontAwesomeAssetBuiltIn, FontAwesomePrefix, FontAwesomeProvider, IconAssetLink, IconFontProvider, IconOptions, IconProviderBase, IconifyPrefix, IconifyProvider, JSFiddleTokenMeta, LiteralUnion, MarkdownDemoEnv, 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.152",
+  "version": "1.0.0-rc.153",
   "description": "The Plugin for VuePress 2 - markdown power",
   "author": "pengzhanbo <volodymyr@foxmail.com>",
   "license": "MIT",
@@ -32,14 +32,15 @@
   ],
   "peerDependencies": {
     "artplayer": "^5.2.3",
-    "dashjs": "^5.0.2",
+    "dashjs": "^5.0.3",
     "esbuild": "^0.25.5",
-    "hls.js": "^1.6.2",
+    "hls.js": "^1.6.5",
     "less": "^4.3.0",
     "markdown-it": "^14.1.0",
     "mpegts.js": "^1.7.3",
-    "sass": "^1.89.0",
-    "sass-embedded": "^1.89.0",
+    "pyodide": "^0.27.7",
+    "sass": "^1.89.1",
+    "sass-embedded": "^1.89.1",
     "stylus": "^0.64.0",
     "vuepress": "2.0.0-rc.23"
   },
@@ -58,18 +59,21 @@
     },
     "mpegts.js": {
       "optional": true
+    },
+    "pyodide": {
+      "optional": true
     }
   },
   "dependencies": {
-    "@mdit/plugin-attrs": "^0.19.0",
-    "@mdit/plugin-footnote": "^0.19.0",
-    "@mdit/plugin-mark": "^0.19.0",
-    "@mdit/plugin-sub": "^0.19.0",
-    "@mdit/plugin-sup": "^0.19.0",
-    "@mdit/plugin-tab": "^0.19.0",
-    "@mdit/plugin-tasklist": "^0.19.0",
+    "@mdit/plugin-attrs": "^0.21.0",
+    "@mdit/plugin-footnote": "^0.21.0",
+    "@mdit/plugin-mark": "^0.21.0",
+    "@mdit/plugin-sub": "^0.21.0",
+    "@mdit/plugin-sup": "^0.21.0",
+    "@mdit/plugin-tab": "^0.21.0",
+    "@mdit/plugin-tasklist": "^0.21.0",
     "@pengzhanbo/utils": "^2.1.0",
-    "@vuepress/helper": "2.0.0-rc.106",
+    "@vuepress/helper": "2.0.0-rc.108",
     "@vueuse/core": "^13.3.0",
     "chokidar": "3.6.0",
     "image-size": "^2.0.2",
@@ -77,17 +81,17 @@
     "lru-cache": "^11.1.0",
     "markdown-it-container": "^4.0.0",
     "nanoid": "^5.1.5",
-    "shiki": "^3.4.2",
+    "shiki": "^3.6.0",
     "tinyglobby": "0.2.13",
-    "tm-grammars": "^1.23.24",
+    "tm-grammars": "^1.23.26",
     "tm-themes": "^1.10.6",
-    "vue": "^3.5.15"
+    "vue": "^3.5.16"
   },
   "devDependencies": {
     "@types/markdown-it": "^14.1.2",
     "artplayer": "^5.2.3",
-    "dashjs": "^5.0.2",
-    "hls.js": "^1.6.2",
+    "dashjs": "^5.0.3",
+    "hls.js": "^1.6.5",
     "mpegts.js": "1.7.3"
   },
   "publishConfig": {