@antdv-next/docs-plugins 0.0.1

package/dist/demo/types.d.ts

@@ -0,0 +1,23 @@
+//#region src/demo/types.d.ts
+interface DemoLocale {
+  html?: string;
+  title?: string;
+}
+interface DemoExtraFile {
+  name: string;
+  lang: string;
+  code: string;
+}
+interface DemoSourceData {
+  source: string;
+  jsSource: string;
+  extraFiles: DemoExtraFile[];
+}
+interface DemoModule {
+  component?: () => Promise<unknown>;
+  locales?: Record<string, DemoLocale>;
+  sourceVersion: number;
+  loadSource: (signal?: AbortSignal) => Promise<DemoSourceData>;
+}
+//#endregion
+export { DemoExtraFile, DemoLocale, DemoModule, DemoSourceData };

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { JsFormatter, tsToJs } from "./demo/tsToJs.js";
+import { OxfmtStyleOptions, createOxfmtJsFormatter } from "./demo/formatter.js";
+import { getDemoId } from "./demo/get-demo-id.js";
+import { DemoPluginOptions, demoPlugin, toRelativePath } from "./demo/index.js";
+import { DemoExtraFile, DemoLocale, DemoModule, DemoSourceData } from "./demo/types.js";
+import { postcssIsolateStyles } from "./isolate-styles.js";
+import { DemoMarkdownPluginOptions, demoMarkdownPlugin, replaceSrcPath } from "./plugins/demo.js";
+import { CreateMarkdownOptions, createMarkdown, loadBaseMd, loadShiki, useMarkdown } from "./markdown.js";
+import { addScriptSetup, checkPkgImport, formatPageData, md2Vue, md2VuePlugin } from "./md2vue.js";
+import { DocsPluginsOptions, mdPlugin } from "./md-plugin.js";
+import { Options, extractTitle, getAdaptiveThemeMarker, preWrapperPlugin } from "./plugins/pre-wrapper.js";
+import { ContainerOptions, containerPlugin } from "./plugins/container.js";
+import { gitHubAlertsPlugin } from "./plugins/github-alerts.js";
+import { ImagePluginOptions, imagePlugin } from "./plugins/image.js";
+import { linkPlugin } from "./plugins/link.js";
+import { stackblitzPlugin } from "./plugins/stackblitz.js";
+import { tablePlugin } from "./plugins/table.js";
+import { DOCS_REGEX, EXTERNAL_URL_RE, SCRIPT_REGEX, STYLE_REGEX } from "./shared.js";
+import { shortHash } from "./utils/short-hash.js";
+export { ContainerOptions, CreateMarkdownOptions, DOCS_REGEX, DemoExtraFile, DemoLocale, DemoMarkdownPluginOptions, DemoModule, DemoPluginOptions, DemoSourceData, DocsPluginsOptions, EXTERNAL_URL_RE, ImagePluginOptions, JsFormatter, Options, OxfmtStyleOptions, SCRIPT_REGEX, STYLE_REGEX, addScriptSetup, checkPkgImport, containerPlugin, createMarkdown, createOxfmtJsFormatter, demoMarkdownPlugin, demoPlugin, extractTitle, formatPageData, getAdaptiveThemeMarker, getDemoId, gitHubAlertsPlugin, imagePlugin, linkPlugin, loadBaseMd, loadShiki, md2Vue, md2VuePlugin, mdPlugin, postcssIsolateStyles, preWrapperPlugin, replaceSrcPath, shortHash, stackblitzPlugin, tablePlugin, toRelativePath, tsToJs, useMarkdown };

package/dist/index.js

@@ -0,0 +1,19 @@
+import { createOxfmtJsFormatter } from "./demo/formatter.js";
+import { getDemoId } from "./demo/get-demo-id.js";
+import { extractTitle, getAdaptiveThemeMarker, preWrapperPlugin } from "./plugins/pre-wrapper.js";
+import { containerPlugin } from "./plugins/container.js";
+import { demoMarkdownPlugin, replaceSrcPath } from "./plugins/demo.js";
+import { gitHubAlertsPlugin } from "./plugins/github-alerts.js";
+import { DOCS_REGEX, EXTERNAL_URL_RE, SCRIPT_REGEX, STYLE_REGEX } from "./shared.js";
+import { imagePlugin } from "./plugins/image.js";
+import { linkPlugin } from "./plugins/link.js";
+import { stackblitzPlugin } from "./plugins/stackblitz.js";
+import { tablePlugin } from "./plugins/table.js";
+import { createMarkdown, loadBaseMd, loadShiki, useMarkdown } from "./markdown.js";
+import { tsToJs } from "./demo/tsToJs.js";
+import { demoPlugin, toRelativePath } from "./demo/index.js";
+import { postcssIsolateStyles } from "./isolate-styles.js";
+import { shortHash } from "./utils/short-hash.js";
+import { addScriptSetup, checkPkgImport, formatPageData, md2Vue, md2VuePlugin } from "./md2vue.js";
+import { mdPlugin } from "./md-plugin.js";
+export { DOCS_REGEX, EXTERNAL_URL_RE, SCRIPT_REGEX, STYLE_REGEX, addScriptSetup, checkPkgImport, containerPlugin, createMarkdown, createOxfmtJsFormatter, demoMarkdownPlugin, demoPlugin, extractTitle, formatPageData, getAdaptiveThemeMarker, getDemoId, gitHubAlertsPlugin, imagePlugin, linkPlugin, loadBaseMd, loadShiki, md2Vue, md2VuePlugin, mdPlugin, postcssIsolateStyles, preWrapperPlugin, replaceSrcPath, shortHash, stackblitzPlugin, tablePlugin, toRelativePath, tsToJs, useMarkdown };

package/dist/isolate-styles.d.ts

@@ -0,0 +1,14 @@
+import { Plugin } from "postcss";
+//#region src/isolate-styles.d.ts
+interface Options {
+  includeFiles?: RegExp[];
+  ignoreFiles?: RegExp[];
+  prefix?: string;
+}
+/**
+ * PostCSS 插件：为 markdown 样式添加隔离前缀，
+ * 避免文档站点样式污染组件演示区（`.vp-raw` 内不做隔离）。
+ */
+declare function postcssIsolateStyles({ includeFiles, ignoreFiles, prefix }?: Options): Plugin;
+//#endregion
+export { postcssIsolateStyles };

package/dist/isolate-styles.js

@@ -0,0 +1,30 @@
+import selectorParser from "postcss-selector-parser";
+//#region src/isolate-styles.ts
+/**
+* PostCSS 插件：为 markdown 样式添加隔离前缀，
+* 避免文档站点样式污染组件演示区（`.vp-raw` 内不做隔离）。
+*/
+function postcssIsolateStyles({ includeFiles = [/styles\/markdown\/index\.css/], ignoreFiles, prefix = ":not(:where(.vp-raw, .vp-raw *))" } = {}) {
+	const prefixNodes = selectorParser().astSync(prefix).first.nodes;
+	return {
+		postcssPlugin: "postcss-isolate-styles",
+		Once(root) {
+			const file = root.source?.input.file;
+			if (file && includeFiles?.length && !includeFiles.some((re) => re.test(file))) return;
+			if (file && ignoreFiles?.length && ignoreFiles.some((re) => re.test(file))) return;
+			root.walkRules((rule) => {
+				if (!rule.selector || rule.selector.includes(prefix)) return;
+				if (rule.parent?.type === "atrule" && /\bkeyframes$/i.test(rule.parent.name)) return;
+				rule.selector = selectorParser((selectors) => {
+					selectors.each((sel) => {
+						if (!sel.nodes.length) return;
+						const insertionIndex = sel.nodes.findLastIndex((n) => n.type !== "pseudo") + 1;
+						sel.nodes.splice(insertionIndex, 0, ...prefixNodes.map((n) => n.clone()));
+					});
+				}).processSync(rule.selector);
+			});
+		}
+	};
+}
+//#endregion
+export { postcssIsolateStyles };

package/dist/markdown.d.ts

@@ -0,0 +1,39 @@
+import { DemoMarkdownPluginOptions } from "./plugins/demo.js";
+import { MarkdownItAsync } from "markdown-it-async";
+//#region src/markdown.d.ts
+interface CreateMarkdownOptions {
+  /**
+   * 是否加载插件
+   * @default true
+   */
+  withPlugin?: boolean;
+  /**
+   * 自定义插件前的钩子
+   */
+  preConfig?: (md: MarkdownItAsync) => void;
+  /**
+   * 自定义插件后的钩子
+   */
+  config?: (md: MarkdownItAsync) => void;
+  /**
+   * 资源路径配置
+   */
+  root?: string;
+  /**
+   * markdown-it 层 demo 插件选项
+   */
+  demo?: DemoMarkdownPluginOptions;
+  /**
+   * 外部链接在新标签页打开
+   * @default true
+   */
+  externalLink?: boolean;
+}
+declare function loadShiki(md: MarkdownItAsync, cls?: string): void;
+declare function loadBaseMd(md: MarkdownItAsync, options?: {
+  externalLink?: boolean;
+}): void;
+declare function createMarkdown(): (options?: CreateMarkdownOptions) => MarkdownItAsync;
+declare const useMarkdown: (options?: CreateMarkdownOptions) => MarkdownItAsync;
+//#endregion
+export { CreateMarkdownOptions, createMarkdown, loadBaseMd, loadShiki, useMarkdown };

package/dist/markdown.js

@@ -0,0 +1,115 @@
+import { preWrapperPlugin } from "./plugins/pre-wrapper.js";
+import { containerPlugin } from "./plugins/container.js";
+import { demoMarkdownPlugin } from "./plugins/demo.js";
+import { gitHubAlertsPlugin } from "./plugins/github-alerts.js";
+import { imagePlugin } from "./plugins/image.js";
+import { linkPlugin } from "./plugins/link.js";
+import { stackblitzPlugin } from "./plugins/stackblitz.js";
+import { tablePlugin } from "./plugins/table.js";
+import { frontmatterPlugin } from "@mdit-vue/plugin-frontmatter";
+import { headersPlugin } from "@mdit-vue/plugin-headers";
+import { titlePlugin } from "@mdit-vue/plugin-title";
+import { tocPlugin } from "@mdit-vue/plugin-toc";
+import { slugify } from "@mdit-vue/shared";
+import { fromAsyncCodeToHtml } from "@shikijs/markdown-it/async";
+import { transformerMetaHighlight, transformerMetaWordHighlight, transformerNotationDiff, transformerNotationErrorLevel, transformerNotationFocus, transformerNotationHighlight, transformerNotationWordHighlight } from "@shikijs/transformers";
+import anchorPlugin from "markdown-it-anchor";
+import MarkdownIt from "markdown-it-async";
+import attrsPlugin from "markdown-it-attrs";
+import { full } from "markdown-it-emoji";
+import { codeToHtml } from "shiki";
+//#region src/markdown.ts
+function loadShiki(md, cls = "ant-doc-code") {
+	md.use(fromAsyncCodeToHtml(codeToHtml, {
+		themes: {
+			light: "vitesse-light",
+			dark: "vitesse-dark"
+		},
+		defaultColor: false,
+		cssVariablePrefix: "--ant-doc-",
+		transformers: [
+			transformerMetaHighlight(),
+			transformerMetaWordHighlight(),
+			transformerNotationDiff(),
+			transformerNotationErrorLevel(),
+			transformerNotationFocus(),
+			transformerNotationHighlight(),
+			transformerNotationWordHighlight(),
+			{
+				name: "remove:clean-up",
+				code(element) {
+					if (element.tagName === "code" && element.properties.class) delete element.properties.class;
+				},
+				pre(element) {
+					delete element.properties.tabindex;
+					delete element.properties.style;
+					this.addClassToHast(element, cls);
+				}
+			}
+		]
+	}));
+}
+function loadBaseMd(md, options = {}) {
+	md.use(frontmatterPlugin);
+	md.use(headersPlugin, {
+		level: [
+			2,
+			3,
+			4,
+			5,
+			6
+		],
+		slugify
+	});
+	md.use(titlePlugin);
+	md.use(full);
+	md.use(attrsPlugin);
+	if (options.externalLink !== false) md.use(linkPlugin);
+	md.use(containerPlugin);
+	md.use(gitHubAlertsPlugin);
+}
+function withPlugins(md, options) {
+	md.use(demoMarkdownPlugin, {
+		root: options.root,
+		...options.demo
+	});
+	loadBaseMd(md, options);
+	md.use(tocPlugin);
+	md.use(anchorPlugin, {
+		slugify,
+		permalink: anchorPlugin.permalink.linkInsideHeader({
+			symbol: "​",
+			renderAttrs: (slug, state) => {
+				const idx = state.tokens.findIndex((token) => {
+					const id = token.attrs?.find((attr) => attr[0] === "id");
+					return id && slug === id[1];
+				});
+				return { "aria-label": `Permalink to "${state.tokens[idx + 1]?.content || ""}"` };
+			}
+		})
+	});
+	loadShiki(md);
+	md.use(imagePlugin);
+	md.use(preWrapperPlugin, { hasSingleTheme: false });
+	md.use(tablePlugin);
+	md.use(stackblitzPlugin);
+	md.linkify.set({ fuzzyLink: false });
+}
+function createMarkdown() {
+	let md;
+	return (options = {}) => {
+		if (md) return md;
+		md = MarkdownIt({
+			html: true,
+			linkify: true,
+			typographer: true
+		});
+		if (options.preConfig) options.preConfig(md);
+		if (options.withPlugin !== false) withPlugins(md, options);
+		if (options.config) options.config(md);
+		return md;
+	};
+}
+const useMarkdown = createMarkdown();
+//#endregion
+export { createMarkdown, loadBaseMd, loadShiki, useMarkdown };

package/dist/md-plugin.d.ts

@@ -0,0 +1,18 @@
+import { DemoPluginOptions } from "./demo/index.js";
+import { CreateMarkdownOptions } from "./markdown.js";
+import { PluginOption } from "vite";
+//#region src/md-plugin.d.ts
+interface DocsPluginsOptions {
+  /**
+   * markdown-it 渲染链路选项（传给 md2vue / createMarkdown）
+   */
+  markdown?: CreateMarkdownOptions;
+  /**
+   * vite demo 插件选项
+   */
+  demo?: DemoPluginOptions;
+}
+/** docs 站点默认的 markdown 处理插件组合 */
+declare function mdPlugin(options?: DocsPluginsOptions): PluginOption[];
+//#endregion
+export { DocsPluginsOptions, mdPlugin };

package/dist/md-plugin.js

@@ -0,0 +1,9 @@
+import { demoPlugin } from "./demo/index.js";
+import { md2VuePlugin } from "./md2vue.js";
+//#region src/md-plugin.ts
+/** docs 站点默认的 markdown 处理插件组合 */
+function mdPlugin(options = {}) {
+	return [md2VuePlugin(options.markdown), demoPlugin(options.demo)];
+}
+//#endregion
+export { mdPlugin };

package/dist/md2vue.d.ts

@@ -0,0 +1,16 @@
+import { CreateMarkdownOptions } from "./markdown.js";
+import { PluginOption } from "vite";
+import { MarkdownItEnv } from "@mdit-vue/types";
+//#region src/md2vue.d.ts
+declare function formatPageData(env: MarkdownItEnv): {
+  title: string;
+  frontmatter: Record<string, unknown>;
+  headers: import("@mdit-vue/types").MarkdownItHeader[];
+  description: string;
+};
+declare function checkPkgImport(findCode: string, pkg: string, importName: string): boolean;
+declare function addScriptSetup(scriptTags: RegExpMatchArray | null, env: MarkdownItEnv): string;
+declare function md2Vue(code: string, env: MarkdownItEnv): string;
+declare function md2VuePlugin(options?: CreateMarkdownOptions): PluginOption;
+//#endregion
+export { addScriptSetup, checkPkgImport, formatPageData, md2Vue, md2VuePlugin };

package/dist/md2vue.js

@@ -0,0 +1,106 @@
+import { SCRIPT_REGEX, STYLE_REGEX } from "./shared.js";
+import { useMarkdown } from "./markdown.js";
+import { shortHash } from "./utils/short-hash.js";
+import pathe from "pathe";
+import { LRUCache } from "lru-cache";
+import { findStaticImports } from "mlly";
+//#region src/md2vue.ts
+function formatPageData(env) {
+	const pageData = {
+		title: env.title ?? "",
+		frontmatter: env.frontmatter ?? {},
+		headers: env.headers ?? [],
+		description: ""
+	};
+	if (typeof env.frontmatter?.description === "string") pageData.description = env.frontmatter.description;
+	if (typeof env.frontmatter?.title === "string" && !env.title) pageData.title = env.frontmatter.title;
+	return pageData;
+}
+function checkPkgImport(findCode, pkg, importName) {
+	if (!findCode) return false;
+	return findStaticImports(findCode).some((item) => item.specifier === pkg && item.imports.includes(importName));
+}
+function addScriptSetup(scriptTags, env) {
+	const pageData = formatPageData(env);
+	const baseCode = `const __pageData = ${JSON.stringify(pageData)};\nconst frontmatter = ${JSON.stringify(env.frontmatter ?? {})};\n`;
+	const importsCode = `import { inject, provide, ref } from 'vue';\n`;
+	const injectedCode = `const __parentPageData = ref({});provide('__pageData__',(data)=>{__parentPageData.value=data});const __pageDataFunc__ = inject('__pageData__',null);if(__pageDataFunc__)__pageDataFunc__(__pageData);provide('__pageInfo__',__pageData);defineExpose({frontmatter,pageData:__pageData})`;
+	if (!scriptTags || !scriptTags.length) return `<script setup lang="ts">\n${importsCode}${baseCode}${injectedCode}\n<\/script>\n`;
+	const scriptSetupCode = scriptTags.find((v) => {
+		return /<script\b[^>]+\bsetup\b[^>]*>/i.test(v);
+	});
+	if (!scriptSetupCode) return `<script setup lang="ts">\n${importsCode}${baseCode}${injectedCode}\n<\/script>\n${scriptTags.join("\n")}\n`;
+	const restScriptTags = scriptTags.filter((v) => {
+		return v !== scriptSetupCode;
+	});
+	const scriptContent = scriptSetupCode ? scriptSetupCode.replace(/<script\b[^>]+\bsetup\b[^>]*>/i, "").replace(/<\/script>/i, "") : "";
+	const importArr = [];
+	if (!checkPkgImport(scriptContent, "vue", "provide")) importArr.push("provide");
+	if (!checkPkgImport(scriptContent, "vue", "inject")) importArr.push("inject");
+	if (!checkPkgImport(scriptContent, "vue", "ref")) importArr.push("ref");
+	return `<script setup lang="ts">\n${importArr.length ? `import { ${importArr.join(", ")} } from 'vue';\n` : ""}${scriptContent}${baseCode}${injectedCode}\n<\/script>\n${restScriptTags.join("\n")}\n`;
+}
+function md2Vue(code, env) {
+	code = code.replace(/<pre\b[^>]*>[\s\S]*?<\/pre>/gi, (match) => {
+		return match.replace(/\{/g, "&#123;").replace(/\}/g, "&#125;");
+	});
+	const scriptTags = code.match(SCRIPT_REGEX);
+	const styleTags = code.match(STYLE_REGEX);
+	const vueComponent = `<template>\n<div class="ant-doc vp-doc">${code.replace(SCRIPT_REGEX, "").replace(STYLE_REGEX, "")}</div>\n</template>\n`;
+	return `${addScriptSetup(scriptTags, env)}\n${vueComponent}\n${styleTags ? styleTags.join("\n") : ""}`;
+}
+function md2VuePlugin(options = {}) {
+	let md;
+	const cache = new LRUCache({
+		max: 500,
+		ttl: 6e5,
+		allowStale: true,
+		updateAgeOnGet: true
+	});
+	async function transform(code, id) {
+		const hash = shortHash(code);
+		const cached = cache.get(id);
+		if (cached && cached.hash === hash) return cached.code;
+		const env = { id };
+		const vueCode = md2Vue(await md.renderAsync(code, env), env);
+		cache.set(id, {
+			hash,
+			code: vueCode
+		});
+		return vueCode;
+	}
+	function shouldSkipTransform(id) {
+		if (id.includes("?vue")) return true;
+		const query = id.split("?")[1];
+		if (!query) return false;
+		const params = new URLSearchParams(query);
+		return params.has("raw") || params.has("url");
+	}
+	return {
+		enforce: "pre",
+		name: "vite:md2vue",
+		configResolved(config) {
+			md = useMarkdown({
+				root: pathe.resolve(config.root ?? process.cwd(), "."),
+				...options
+			});
+		},
+		transform: {
+			filter: { id: /\.md($|\?)/ },
+			async handler(code, id) {
+				if (shouldSkipTransform(id)) return null;
+				return transform(code, id);
+			}
+		},
+		handleHotUpdate(ctx) {
+			const { file, read } = ctx;
+			if (!file.endsWith(".md")) return;
+			const defaultRead = read;
+			ctx.read = async () => {
+				return transform(await defaultRead(), file);
+			};
+		}
+	};
+}
+//#endregion
+export { addScriptSetup, checkPkgImport, formatPageData, md2Vue, md2VuePlugin };

package/dist/plugins/container.d.ts

@@ -0,0 +1,16 @@
+import { Options } from "./pre-wrapper.js";
+import MarkdownIt from "markdown-it";
+//#region src/plugins/container.d.ts
+declare function containerPlugin(md: MarkdownIt, options: Options, containerOptions?: ContainerOptions): void;
+interface ContainerOptions {
+  infoLabel?: string;
+  noteLabel?: string;
+  tipLabel?: string;
+  warningLabel?: string;
+  dangerLabel?: string;
+  detailsLabel?: string;
+  importantLabel?: string;
+  cautionLabel?: string;
+}
+//#endregion
+export { ContainerOptions, containerPlugin };

package/dist/plugins/container.js

@@ -0,0 +1,53 @@
+import { extractTitle, getAdaptiveThemeMarker } from "./pre-wrapper.js";
+import container from "markdown-it-container";
+import { nanoid } from "nanoid";
+//#region src/plugins/container.ts
+function containerPlugin(md, options, containerOptions) {
+	md.use(...createContainer("tip", containerOptions?.tipLabel || "TIP", md)).use(...createContainer("info", containerOptions?.infoLabel || "INFO", md)).use(...createContainer("warning", containerOptions?.warningLabel || "WARNING", md)).use(...createContainer("danger", containerOptions?.dangerLabel || "DANGER", md)).use(...createContainer("details", containerOptions?.detailsLabel || "Details", md)).use(container, "v-pre", { render: (tokens, idx) => tokens[idx].nesting === 1 ? `<div v-pre>\n` : `</div>\n` }).use(container, "raw", { render: (tokens, idx) => tokens[idx].nesting === 1 ? `<div class="vp-raw">\n` : `</div>\n` }).use(...createCodeGroup(options));
+}
+function createContainer(klass, defaultTitle, md) {
+	return [
+		container,
+		klass,
+		{ render(tokens, idx, _options, env) {
+			const token = tokens[idx];
+			const info = token.info.trim().slice(klass.length).trim();
+			const attrs = md.renderer.renderAttrs(token);
+			if (token.nesting === 1) {
+				const title = md.renderInline(info || defaultTitle, { references: env.references });
+				if (klass === "details") return `<details class="${klass} custom-block"${attrs}><summary>${title}</summary>\n`;
+				return `<div class="${klass} custom-block"${attrs}><p class="custom-block-title">${title}</p>\n`;
+			} else return klass === "details" ? `</details>\n` : `</div>\n`;
+		} }
+	];
+}
+function createCodeGroup(options) {
+	return [
+		container,
+		"code-group",
+		{ render(tokens, idx) {
+			if (tokens[idx].nesting === 1) {
+				const name = nanoid(5);
+				let tabs = "";
+				let checked = "checked=\"checked\"";
+				for (let i = idx + 1; !(tokens[i].nesting === -1 && tokens[i].type === "container_code-group_close"); ++i) {
+					const token = tokens[i];
+					const isHtml = token.type === "html_block";
+					if (token.type === "fence" && token.tag === "code" || isHtml) {
+						const title = extractTitle(isHtml ? token.content : token.info, isHtml);
+						if (title) {
+							const id = nanoid(7);
+							tabs += `<input type="radio" name="group-${name}" id="tab-${id}" ${checked}><label for="tab-${id}">${title}</label>`;
+							if (checked && !isHtml) token.info += " active";
+							checked = "";
+						}
+					}
+				}
+				return `<div class="vp-code-group${getAdaptiveThemeMarker(options)}"><div class="tabs">${tabs}</div><div class="blocks">\n`;
+			}
+			return `</div></div>\n`;
+		} }
+	];
+}
+//#endregion
+export { containerPlugin };

package/dist/plugins/demo.d.ts

@@ -0,0 +1,29 @@
+import { MarkdownItHeader } from "@mdit-vue/types";
+import MarkdownIt from "markdown-it";
+//#region src/plugins/demo.d.ts
+interface DemoMarkdownPluginOptions {
+  /** 包裹 demo 的标签名，默认 `demo` */
+  wrapper?: string;
+  /**
+   * demo 锚点归属模式：
+   * - `examples`：demo 统一挂到 slug 为 `examples` 的标题下（antdv-next 约定，默认）
+   * - `section`：demo 挂到当前所在章节标题下（跟随标题层级）
+   */
+  headerMode?: 'examples' | 'section';
+  /**
+   * 生产构建时跳过 `debug` demo 的目录收集
+   * @default true
+   */
+  debugDemo?: boolean;
+}
+declare module '@mdit-vue/types' {
+  interface MarkdownItEnv {
+    id?: string;
+  }
+}
+declare function replaceSrcPath(content: string, id: string, root: string, wrapper?: string, parentHeader?: MarkdownItHeader, skipDebugDemo?: boolean): string;
+declare function demoMarkdownPlugin(md: MarkdownIt, config?: {
+  root?: string;
+} & DemoMarkdownPluginOptions): void;
+//#endregion
+export { DemoMarkdownPluginOptions, demoMarkdownPlugin, replaceSrcPath };

package/dist/plugins/demo.js

@@ -0,0 +1,139 @@
+import { getDemoId } from "../demo/get-demo-id.js";
+import pathe from "pathe";
+//#region src/plugins/demo.ts
+const HEADING_LEVEL_RE = /^h([2-6])$/;
+const SRC_ATTR_RE = /(\s|^)src=(['"])(.*?)\2/gi;
+function checkWrapper(content, wrapper = "demo") {
+	return new RegExp(`<${wrapper}(\\s|>|/)`, "i").test(content);
+}
+function isProdDebugDemo(tag) {
+	if (process.env.NODE_ENV !== "production") return false;
+	const debugAttr = tag.match(/(?:^|\s)debug(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s/>]+)))?/i);
+	if (!debugAttr) return false;
+	const value = debugAttr[1] ?? debugAttr[2] ?? debugAttr[3];
+	return value === void 0 || value === "" || value === "true";
+}
+function flattenHeaders(headers = []) {
+	const headerMap = /* @__PURE__ */ new Map();
+	const visit = (items) => {
+		for (const item of items) {
+			headerMap.set(item.slug, item);
+			if (item.children?.length) visit(item.children);
+		}
+	};
+	visit(headers);
+	return headerMap;
+}
+function flattenHeadersInOrder(headers = []) {
+	const flat = [];
+	const visit = (items) => {
+		for (const item of items) {
+			flat.push(item);
+			if (item.children?.length) visit(item.children);
+		}
+	};
+	visit(headers);
+	return flat;
+}
+function getHeadingSlug(token) {
+	return token.attrs?.find((attr) => attr[0] === "id")?.[1];
+}
+function getHeadingTitle(token) {
+	if (token?.type !== "inline") return "";
+	return token.content?.trim() ?? "";
+}
+function getHeadingLevel(token) {
+	const match = token.tag?.match(HEADING_LEVEL_RE);
+	if (!match) return null;
+	return Number(match[1]);
+}
+function replaceSrcPath(content, id, root, wrapper = "demo", parentHeader, skipDebugDemo = false) {
+	function replaceSrcInTag(tagMatch, titleContent) {
+		return tagMatch.replace(SRC_ATTR_RE, (srcMatch, prefix, quote, srcValue) => {
+			if (!srcValue || srcValue.startsWith("/")) return srcMatch;
+			const dir = pathe.dirname(id);
+			const filePath = pathe.resolve(dir, srcValue);
+			const relative = pathe.relative(root, filePath);
+			if (parentHeader && titleContent && !(skipDebugDemo && isProdDebugDemo(tagMatch))) {
+				const slug = getDemoId(filePath);
+				const item = {
+					level: parentHeader.level + 1,
+					title: titleContent,
+					slug,
+					link: `#${slug}`,
+					children: []
+				};
+				if (parentHeader.children) parentHeader.children.push(item);
+				else parentHeader.children = [item];
+			}
+			return `${prefix}src=${quote}${relative.startsWith("/") ? relative : `/${relative}`}${quote}`;
+		});
+	}
+	const closedTag = new RegExp(`(<${wrapper}(?!-)\\b[^>]*>)([\\s\\S]*?)<\\/${wrapper}>`, "gi");
+	let result = content.replace(closedTag, (tagMatch, openTag, titleContent) => {
+		return tagMatch.replace(openTag, replaceSrcInTag(openTag, titleContent?.trim()));
+	});
+	const selfClosing = new RegExp(`<${wrapper}(?!-)\\b[^>]*/\\s*>`, "gi");
+	result = result.replace(selfClosing, (tagMatch) => replaceSrcInTag(tagMatch));
+	const openTag = new RegExp(`<${wrapper}(?!-)\\b[^>]*>`, "gi");
+	return result.replace(openTag, (tagMatch) => replaceSrcInTag(tagMatch));
+}
+function demoMarkdownPlugin(md, config = {}) {
+	const wrapper = config.wrapper ?? "demo";
+	const headerMode = config.headerMode ?? "examples";
+	const skipDebugDemo = config.debugDemo ?? true;
+	const originalRender = md.renderer.render.bind(md.renderer);
+	md.renderer.render = function render(tokens, options, env) {
+		const root = config.root ?? process.cwd();
+		const currentId = env.id || "";
+		const headers = env.headers;
+		const fixedHeader = headerMode === "examples" ? headers?.find((item) => item.slug === "examples") : void 0;
+		const headerMap = flattenHeaders(headers);
+		const orderedHeaders = flattenHeadersInOrder(headers);
+		const headerIndexBySlug = new Map(orderedHeaders.map((item, index) => [item.slug, index]));
+		const activeHeaders = /* @__PURE__ */ new Map();
+		let headerCursor = 0;
+		function getCurrentHeader() {
+			const nearestLevel = Array.from(activeHeaders.keys()).sort((left, right) => right - left)[0];
+			return nearestLevel ? activeHeaders.get(nearestLevel) : void 0;
+		}
+		function resolveHeading(headingLevel, headingSlug, headingTitle) {
+			if (headingSlug) {
+				const bySlug = headerMap.get(headingSlug);
+				if (bySlug) {
+					const index = headerIndexBySlug.get(headingSlug);
+					if (typeof index === "number") headerCursor = Math.max(headerCursor, index + 1);
+					return bySlug;
+				}
+			}
+			for (let index = headerCursor; index < orderedHeaders.length; index += 1) {
+				const header = orderedHeaders[index];
+				if (header.level !== headingLevel) continue;
+				if (headingTitle && header.title !== headingTitle) continue;
+				headerCursor = index + 1;
+				return header;
+			}
+		}
+		function processToken(token) {
+			const tokenType = token.type ?? "";
+			const tokenContent = token.content ?? "";
+			if ((tokenType === "html_block" || tokenType === "html_inline" || tokenType === "inline") && checkWrapper(tokenContent, wrapper)) token.content = replaceSrcPath(tokenContent, currentId, root, wrapper, headerMode === "examples" ? fixedHeader : getCurrentHeader(), skipDebugDemo);
+			if (token.children) for (const child of token.children) processToken(child);
+		}
+		const typedTokens = tokens;
+		typedTokens.forEach((token, index) => {
+			if (token.type === "heading_open") {
+				const headingLevel = getHeadingLevel(token);
+				if (headingLevel) {
+					for (const level of activeHeaders.keys()) if (level >= headingLevel) activeHeaders.delete(level);
+					const header = resolveHeading(headingLevel, getHeadingSlug(token), getHeadingTitle(typedTokens[index + 1]));
+					if (header) activeHeaders.set(headingLevel, header);
+				}
+			}
+			processToken(token);
+		});
+		return originalRender(tokens, options, env);
+	};
+}
+//#endregion
+export { demoMarkdownPlugin, replaceSrcPath };

package/dist/plugins/github-alerts.d.ts

@@ -0,0 +1,6 @@
+import { ContainerOptions } from "./container.js";
+import MarkdownIt from "markdown-it";
+//#region src/plugins/github-alerts.d.ts
+declare function gitHubAlertsPlugin(md: MarkdownIt, options?: ContainerOptions): void;
+//#endregion
+export { gitHubAlertsPlugin };