@roidmc/vitepress-uni-icons 0.0.1

package/dist/index.mjs

@@ -0,0 +1,718 @@
+import { createRequire } from "node:module";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { encodeSvgForCss, getIconData, iconToHTML, iconToSVG } from "@iconify/utils";
+import { fileURLToPath } from "node:url";
+//#region src/matcher.ts
+/**
+* 图标匹配器 - 负责将标签匹配到图标
+*/
+var IconMatcher = class {
+	constructor(iconMap) {
+		this.iconMap = iconMap;
+		this.sortedKeys = Object.keys(iconMap).sort((a, b) => b.length - a.length);
+	}
+	/**
+	* 从标签集合中匹配图标
+	*/
+	match(labels) {
+		const matched = /* @__PURE__ */ new Map();
+		for (const label of labels) {
+			const icon = this.matchOne(label);
+			if (icon) this.addMatch(matched, icon, label);
+		}
+		return Array.from(matched.values());
+	}
+	/**
+	* 匹配单个标签
+	*/
+	matchOne(label) {
+		const normalizedLabel = label.toLowerCase();
+		if (this.iconMap[label]) return this.iconMap[label];
+		for (const key of this.sortedKeys) if (key.startsWith(".")) {
+			if (normalizedLabel.endsWith(key) || normalizedLabel.includes(key.slice(1))) return this.iconMap[key];
+		}
+		for (const key of this.sortedKeys) {
+			const normalizedKey = key.toLowerCase();
+			if (new RegExp(`\\b${normalizedKey}\\b`, "i").test(normalizedLabel)) return this.iconMap[key];
+		}
+		for (const key of this.sortedKeys) {
+			const normalizedKey = key.toLowerCase();
+			if (normalizedLabel.startsWith(normalizedKey)) return this.iconMap[key];
+		}
+		return null;
+	}
+	/**
+	* 添加匹配结果
+	*/
+	addMatch(matched, icon, label) {
+		const key = this.getIconKey(icon);
+		const existing = matched.get(key);
+		if (existing) existing.labels.push(label);
+		else matched.set(key, {
+			icon,
+			labels: [label]
+		});
+	}
+	/**
+	* 获取图标唯一键
+	*/
+	getIconKey(icon) {
+		return typeof icon === "string" ? icon : `light:${icon.light},dark:${icon.dark}`;
+	}
+};
+//#endregion
+//#region src/resolver.ts
+/**
+* 图标解析器 - 负责将图标标识符转换为SVG内容
+*/
+var IconResolver = class {
+	constructor() {
+		this.cache = /* @__PURE__ */ new Map();
+		this.apiEndpoint = "https://api.iconify.design";
+	}
+	/**
+	* 设置API端点
+	*/
+	setApiEndpoint(endpoint) {
+		this.apiEndpoint = endpoint;
+	}
+	/**
+	* 设置开发服务器
+	*/
+	setDevServer(server) {
+		this.devServer = server;
+		this.publicDir = server.config.publicDir;
+	}
+	/**
+	* 解析图标值并返回SVG内容
+	*/
+	async resolve(icon) {
+		if (typeof icon !== "string") return this.resolve(icon.light);
+		const cached = this.cache.get(icon);
+		if (cached) return {
+			svg: cached,
+			success: true
+		};
+		try {
+			let svg = "";
+			if (icon.startsWith("<svg")) svg = encodeSvgForCss(icon);
+			else if (icon.startsWith("http://") || icon.startsWith("https://")) svg = await this.fetchIcon(icon);
+			else if (icon.startsWith("/")) svg = await this.fetchPublicIcon(icon);
+			else if (icon.includes(":")) svg = await this.resolveIconify(icon);
+			else return {
+				svg: "",
+				success: false,
+				error: `Invalid icon format: ${icon}`
+			};
+			if (svg) this.cache.set(icon, svg);
+			return {
+				svg,
+				success: true
+			};
+		} catch (error) {
+			return {
+				svg: "",
+				success: false,
+				error: `Failed to resolve icon: ${icon}, ${error}`
+			};
+		}
+	}
+	/**
+	* 解析Iconify图标 - 支持本地包和API
+	*/
+	async resolveIconify(icon) {
+		const [collection, iconName] = icon.split(":");
+		if (!collection || !iconName) throw new Error("Invalid iconify icon format");
+		try {
+			const { icons } = createRequire(import.meta.url)(`@iconify-json/${collection}`);
+			const iconData = getIconData(icons, iconName);
+			if (iconData) {
+				const { attributes, body } = iconToSVG(iconData);
+				return encodeSvgForCss(iconToHTML(body, attributes));
+			}
+		} catch {}
+		try {
+			return await this.fetchFromAPI(collection, iconName);
+		} catch (error) {
+			throw new Error(`Failed to load icon: ${icon}. Please install @iconify-json/${collection} or check API availability`);
+		}
+	}
+	/**
+	* 从Iconify API获取图标
+	*/
+	async fetchFromAPI(collection, iconName) {
+		const url = `${this.apiEndpoint}/${collection}.json?icons=${iconName}`;
+		try {
+			const data = await (await fetch(url)).json();
+			if (!data || !data.icons || !data.icons[iconName]) throw new Error(`Icon not found in API: ${collection}:${iconName}`);
+			const iconData = data.icons[iconName];
+			const { attributes, body } = iconToSVG({
+				body: iconData.body,
+				width: iconData.width || data.width || 24,
+				height: iconData.height || data.height || 24
+			});
+			return encodeSvgForCss(iconToHTML(body, attributes));
+		} catch (error) {
+			throw new Error(`Failed to fetch from Iconify API: ${url}`);
+		}
+	}
+	/**
+	* 从URL获取图标
+	*/
+	async fetchIcon(url) {
+		try {
+			return encodeSvgForCss(await (await fetch(url)).text());
+		} catch (error) {
+			throw new Error(`Failed to fetch icon from: ${url}`);
+		}
+	}
+	/**
+	* 从public目录获取图标
+	*/
+	async fetchPublicIcon(publicPath) {
+		const isBrowser = typeof window !== "undefined";
+		try {
+			if (isBrowser) return encodeSvgForCss(await (await fetch(publicPath)).text());
+			if (this.publicDir) {
+				const filePath = join(this.publicDir, publicPath);
+				if (existsSync(filePath)) return encodeSvgForCss(readFileSync(filePath, "utf-8"));
+			}
+			if (this.devServer) {
+				const port = this.devServer.config.server.port || 5173;
+				const response = await fetch(`http://localhost:${port}${publicPath}`);
+				if (response.ok) return encodeSvgForCss(await response.text());
+			}
+			return `__PUBLIC_ICON__:${publicPath}`;
+		} catch (error) {
+			return `__PUBLIC_ICON__:${publicPath}`;
+		}
+	}
+	/**
+	* 清除缓存
+	*/
+	clearCache() {
+		this.cache.clear();
+	}
+};
+//#endregion
+//#region src/generator.ts
+/**
+* CSS生成器 - 负责生成图标样式
+*/
+var CSSGenerator = class {
+	constructor(options = {}) {
+		this.resolver = new IconResolver();
+		this.options = options;
+	}
+	/**
+	* 设置开发服务器
+	*/
+	setDevServer(server) {
+		this.resolver.setDevServer(server);
+	}
+	/**
+	* 生成完整的CSS
+	*/
+	async generate(matchedIcons) {
+		return this.generateBaseCSS() + await this.generateIconCSS(matchedIcons);
+	}
+	/**
+	* 生成基础CSS样式
+	*/
+	generateBaseCSS() {
+		const style = this.options.style || {};
+		const iconSize = style.iconSize || "1em";
+		const iconMarginRight = style.iconMarginRight || "0.5em";
+		const iconMarginBottom = style.iconMarginBottom || "-0.2em";
+		const titleBarFontSize = style.titleBarFontSize || "14px";
+		const titleBarLineHeight = style.titleBarLineHeight || "48px";
+		const titleBarPadding = style.titleBarPadding || "0 12px";
+		return `
+/* VitePress Uni Icons - Base Styles */
+.vp-code-block-title [data-title]::before,
+.vp-code-group [data-title]::before {
+  display: inline-block;
+  width: ${iconSize};
+  height: ${iconSize};
+  margin-right: ${iconMarginRight};
+  margin-bottom: ${iconMarginBottom};
+  background: var(--icon) no-repeat center / contain;
+}
+
+.vp-code-block-title-bar {
+  position: relative;
+  margin: 16px -24px 0 -24px;
+  background-color: var(--vp-code-block-bg);
+  overflow-x: auto;
+  font-size: ${titleBarFontSize};
+  font-weight: 500;
+  color: var(--vp-code-tab-text-color);
+  white-space: nowrap;
+  transition: background-color 0.5s;
+  border-radius: 8px 8px 0 0;
+  padding: ${titleBarPadding};
+  box-shadow: inset 0 -1px var(--vp-code-tab-divider);
+}
+
+.custom-block .vp-code-block-title-bar {
+  margin: 16px 0 0 0;
+}
+
+@media (min-width: 640px) {
+  .vp-code-block-title-bar {
+    margin: 16px 0 0 0;
+  }
+}
+
+.vp-code-block-title-text {
+  padding: ${titleBarPadding};
+  line-height: ${titleBarLineHeight};
+}
+
+.vp-code-block-title div[class*=language-] {
+  margin-top: 0 !important;
+  border-top-left-radius: 0 !important;
+  border-top-right-radius: 0 !important;
+}
+`;
+	}
+	/**
+	* 生成图标CSS
+	*/
+	async generateIconCSS(matchedIcons) {
+		return (await Promise.all(matchedIcons.map(({ icon, labels }) => this.generateOneIconCSS(icon, labels)))).filter(Boolean).join("\n");
+	}
+	/**
+	* 生成单个图标的CSS
+	*/
+	async generateOneIconCSS(icon, labels) {
+		const selectors = labels.map((label) => `[data-title='${label}']::before`);
+		if (typeof icon !== "string") return this.generateThemedIconCSS(icon, selectors);
+		const result = await this.resolver.resolve(icon);
+		if (!result.success) {
+			if (this.options.debug) console.warn(`[vitepress-uni-icons] ${result.error}`);
+			return "";
+		}
+		if (result.svg.startsWith("__PUBLIC_ICON__:")) {
+			const publicPath = result.svg.replace("__PUBLIC_ICON__:", "");
+			return this.generatePublicIconRule(selectors, publicPath);
+		}
+		return this.generateIconRule(selectors, result.svg);
+	}
+	/**
+	* 生成public图标CSS规则(运行时加载)
+	*/
+	generatePublicIconRule(selectors, publicPath) {
+		return `
+${selectors.join(",")} {
+  content: '';
+  --icon: url("${publicPath}");
+}`;
+	}
+	/**
+	* 生成主题图标CSS
+	*/
+	async generateThemedIconCSS(icon, selectors) {
+		const parts = [];
+		const lightResult = await this.resolver.resolve(icon.light);
+		if (lightResult.success) parts.push(this.generateIconRule(selectors, lightResult.svg));
+		const darkResult = await this.resolver.resolve(icon.dark);
+		if (darkResult.success) parts.push(this.generateIconRule(selectors, darkResult.svg, "html.dark"));
+		return parts.join("\n");
+	}
+	/**
+	* 生成CSS规则
+	*/
+	generateIconRule(selectors, svg, prefix) {
+		return `
+${prefix ? selectors.map((s) => `${prefix} ${s}`).join(",") : selectors.join(",")} {
+  content: '';
+  --icon: url("data:image/svg+xml,${svg}");
+}`;
+	}
+};
+//#endregion
+//#region src/builtin.ts
+/**
+* 内置图标映射表
+*/
+var builtinIcons = {
+	pnpm: {
+		light: "vscode-icons:file-type-light-pnpm",
+		dark: "vscode-icons:file-type-pnpm"
+	},
+	npm: "vscode-icons:file-type-npm",
+	yarn: "vscode-icons:file-type-yarn",
+	bun: "vscode-icons:file-type-bun",
+	deno: "vscode-icons:file-type-deno",
+	vitepress: "vscode-icons:file-type-vitepress",
+	vue: "vscode-icons:file-type-vue",
+	svelte: "vscode-icons:file-type-svelte",
+	angular: "vscode-icons:file-type-angular",
+	react: "vscode-icons:file-type-reactjs",
+	solid: "logos:solidjs-icon",
+	marko: "vscode-icons:file-type-marko",
+	next: {
+		light: "vscode-icons:file-type-light-next",
+		dark: "vscode-icons:file-type-next"
+	},
+	nuxt: "vscode-icons:file-type-nuxt",
+	astro: {
+		light: "vscode-icons:file-type-light-astro",
+		dark: "vscode-icons:file-type-astro"
+	},
+	qwik: "logos:qwik-icon",
+	ember: "vscode-icons:file-type-ember",
+	vitest: {
+		light: "vscode-icons:file-type-light-vitest",
+		dark: "vscode-icons:file-type-vitest"
+	},
+	rollup: "vscode-icons:file-type-rollup",
+	webpack: "vscode-icons:file-type-webpack",
+	vite: {
+		light: "vscode-icons:file-type-light-vite",
+		dark: "vscode-icons:file-type-vite"
+	},
+	esbuild: "vscode-icons:file-type-esbuild",
+	rolldown: {
+		light: "vscode-icons:file-type-light-rolldown",
+		dark: "vscode-icons:file-type-rolldown"
+	},
+	"package.json": "vscode-icons:file-type-node",
+	"tsconfig.json": "vscode-icons:file-type-tsconfig",
+	".npmrc": "vscode-icons:file-type-npm",
+	".editorconfig": "vscode-icons:file-type-editorconfig",
+	".eslintrc": "vscode-icons:file-type-eslint",
+	".eslintignore": "vscode-icons:file-type-eslint",
+	"eslint.config": "vscode-icons:file-type-eslint",
+	".gitignore": "vscode-icons:file-type-git",
+	".gitattributes": "vscode-icons:file-type-git",
+	".env": "vscode-icons:file-type-dotenv",
+	".env.example": "vscode-icons:file-type-dotenv",
+	".vscode": "vscode-icons:file-type-vscode",
+	"tailwind.config": "vscode-icons:file-type-tailwind",
+	"uno.config": "vscode-icons:file-type-unocss",
+	"unocss.config": "vscode-icons:file-type-unocss",
+	"vue.config": "vscode-icons:file-type-vueconfig",
+	".mts": "vscode-icons:file-type-typescript",
+	".cts": "vscode-icons:file-type-typescript",
+	".ts": "vscode-icons:file-type-typescript",
+	".tsx": "vscode-icons:file-type-typescript",
+	".mjs": "vscode-icons:file-type-js",
+	".cjs": "vscode-icons:file-type-js",
+	".json": "vscode-icons:file-type-json",
+	".js": "vscode-icons:file-type-js",
+	".jsx": "vscode-icons:file-type-js",
+	".md": "vscode-icons:file-type-markdown",
+	".py": "vscode-icons:file-type-python",
+	".ico": "vscode-icons:file-type-favicon",
+	".html": "vscode-icons:file-type-html",
+	".css": "vscode-icons:file-type-css",
+	".scss": "vscode-icons:file-type-scss",
+	".yml": {
+		light: "vscode-icons:file-type-light-yaml",
+		dark: "vscode-icons:file-type-yaml"
+	},
+	".yaml": {
+		light: "vscode-icons:file-type-light-yaml",
+		dark: "vscode-icons:file-type-yaml"
+	},
+	".php": "vscode-icons:file-type-php",
+	".gjs": "vscode-icons:file-type-glimmer",
+	".gts": "vscode-icons:file-type-glimmer",
+	oxlint: {
+		light: "vscode-icons:file-type-light-oxc",
+		dark: "vscode-icons:file-type-oxc"
+	},
+	oxc: {
+		light: "vscode-icons:file-type-light-oxc",
+		dark: "vscode-icons:file-type-oxc"
+	},
+	oxfmt: {
+		light: "vscode-icons:file-type-light-oxc",
+		dark: "vscode-icons:file-type-oxc"
+	}
+};
+//#endregion
+//#region src/scanner.ts
+/**
+* 图标扫描器 - 自动扫描已安装的iconify图标集
+*/
+var IconScanner = class {
+	/**
+	* 扫描已安装的图标集并生成图标映射
+	* @param iconSets 用户配置的图标集
+	*/
+	scan(iconSets) {
+		const result = {};
+		if (iconSets && iconSets.length > 0) for (const iconSet of iconSets) this.scanIconSet(result, iconSet);
+		this.scanVSCodeIcons(result);
+		this.scanLogos(result);
+		return result;
+	}
+	/**
+	* 扫描用户配置的图标集
+	*/
+	scanIconSet(result, config) {
+		if (config.icons) {
+			const iconsData = config.icons.icons || config.icons;
+			this.scanIconData(result, config.name, iconsData, config.scan);
+			return;
+		}
+		try {
+			const module = createRequire(import.meta.url)(`@iconify-json/${config.name}`);
+			const icons = module.icons || module;
+			if (icons && typeof icons === "object") this.scanIconData(result, config.name, icons, config.scan);
+		} catch (e) {}
+	}
+	/**
+	* 扫描图标数据
+	*/
+	scanIconData(result, collectionName, icons, scanConfig) {
+		if (!icons || typeof icons !== "object") return;
+		const prefix = scanConfig?.prefix;
+		const suffix = scanConfig?.suffix;
+		const theme = scanConfig?.theme;
+		const custom = scanConfig?.custom;
+		for (const iconName of Object.keys(icons)) {
+			if (custom) {
+				const mapped = custom(iconName, icons[iconName]);
+				if (mapped) {
+					const [key, value] = mapped;
+					if (!result[key]) result[key] = value;
+				}
+				continue;
+			}
+			let key = iconName;
+			if (prefix && iconName.startsWith(prefix)) key = iconName.slice(prefix.length);
+			if (suffix && iconName.endsWith(suffix)) key = iconName.slice(0, -suffix.length);
+			if (theme && key.startsWith("light-")) {
+				const baseName = key.slice(6);
+				if (baseName && !result[baseName]) {
+					const darkIcon = `${collectionName}:${prefix || ""}${baseName}`;
+					if (icons[`${prefix || ""}${baseName}`]) result[baseName] = {
+						light: `${collectionName}:${iconName}`,
+						dark: darkIcon
+					};
+				}
+				continue;
+			}
+			if (key && !result[key]) result[key] = `${collectionName}:${iconName}`;
+		}
+	}
+	/**
+	* 扫描 vscode-icons 图标集
+	*/
+	scanVSCodeIcons(result) {
+		try {
+			const module = createRequire(import.meta.url)("@iconify-json/vscode-icons");
+			const icons = module.icons?.icons || module.icons;
+			if (icons && typeof icons === "object") {
+				for (const iconName of Object.keys(icons)) if (iconName.startsWith("file-type-")) {
+					const suffix = iconName.slice(10);
+					if (suffix) {
+						if (suffix.startsWith("light-")) {
+							const baseName = suffix.slice(6);
+							if (baseName && !result[baseName]) {
+								const darkIcon = `vscode-icons:file-type-${baseName}`;
+								if (icons[`file-type-${baseName}`]) result[baseName] = {
+									light: `vscode-icons:${iconName}`,
+									dark: darkIcon
+								};
+							}
+						} else if (!result[suffix]) result[suffix] = `vscode-icons:${iconName}`;
+					}
+				}
+			}
+		} catch (e) {}
+	}
+	/**
+	* 扫描 logos 图标集
+	*/
+	scanLogos(result) {
+		try {
+			const module = createRequire(import.meta.url)("@iconify-json/logos");
+			const icons = module.icons?.icons || module.icons;
+			if (icons && typeof icons === "object") {
+				for (const iconName of Object.keys(icons)) if (iconName.endsWith("-icon")) {
+					const framework = iconName.slice(0, -5);
+					if (framework && !result[framework]) result[framework] = `logos:${iconName}`;
+				} else if (!result[iconName]) result[iconName] = `logos:${iconName}`;
+			}
+		} catch (e) {}
+	}
+};
+//#endregion
+//#region src/plugin.ts
+/**
+* Vite插件 - 核心功能
+*/
+function createPlugin(options = {}) {
+	const virtualCSSId = "virtual:uni-icons.css";
+	const resolvedCSSId = `\0${virtualCSSId}`;
+	const matcher = new IconMatcher({
+		...new IconScanner().scan(options.iconSets),
+		...options.disableBuiltin ? {} : builtinIcons,
+		...options.customIcons
+	});
+	const generator = new CSSGenerator(options);
+	const matchedLabels = /* @__PURE__ */ new Set();
+	let previousLabels = null;
+	let server;
+	/**
+	* 检查标签是否变化
+	*/
+	function hasLabelsChanged() {
+		if (!previousLabels) return true;
+		if (matchedLabels.size !== previousLabels.size) return true;
+		for (const label of matchedLabels) if (!previousLabels.has(label)) return true;
+		return false;
+	}
+	/**
+	* 触发CSS模块更新
+	*/
+	function triggerUpdate() {
+		if (!server) return;
+		const mod = server.moduleGraph.getModuleById(resolvedCSSId);
+		if (mod) {
+			server.moduleGraph.invalidateModule(mod);
+			server.reloadModule(mod);
+		}
+	}
+	return {
+		name: "vitepress-uni-icons",
+		enforce: "post",
+		resolveId(id) {
+			if (id === virtualCSSId) return resolvedCSSId;
+			return null;
+		},
+		configureServer(_server) {
+			server = _server;
+			generator.setDevServer(_server);
+		},
+		async load(id) {
+			if (id !== resolvedCSSId) return null;
+			const allLabels = new Set([...matchedLabels, ...options.defaultLabels || []]);
+			const matchedIcons = matcher.match(allLabels);
+			const css = await generator.generate(matchedIcons);
+			previousLabels = new Set(matchedLabels);
+			return css;
+		},
+		transform: {
+			filter: { id: /\.(md|md\?vue|md\?v=)$/ },
+			handler(code) {
+				const regex = /\bdata-title=\\"([^"]*)\\"|\bdata-title="([^"]*)"|"data-title":\s*"([^"]*)"/g;
+				let match;
+				while ((match = regex.exec(code)) !== null) {
+					const label = match[1] || match[2] || match[3];
+					if (label) matchedLabels.add(label);
+				}
+				if (hasLabelsChanged()) triggerUpdate();
+				return null;
+			}
+		}
+	};
+}
+//#endregion
+//#region src/markdown.ts
+/**
+* Markdown插件 - 处理代码组和代码块
+*/
+function createMarkdownPlugin(md, options = {}) {
+	const titleBarOptions = options.titleBar || {};
+	processCodeGroup(md);
+	processCodeBlock(md, titleBarOptions);
+}
+/**
+* 处理代码组
+*/
+function processCodeGroup(md) {
+	const labelRE = /<label\b(?![^>]+\bdata-title\b)[^>]*>(.*?)<\/label>/g;
+	const originalRule = md.renderer.rules["container_code-group_open"];
+	if (!originalRule) return;
+	md.renderer.rules["container_code-group_open"] = (...args) => {
+		return originalRule(...args).replace(labelRE, (match, label) => `<label data-title="${md.utils.escapeHtml(label)}"${match.slice(6)}`);
+	};
+}
+/**
+* 处理代码块标题
+*/
+function processCodeBlock(md, options) {
+	const originalRule = md.renderer.rules.fence;
+	if (!originalRule) return;
+	md.renderer.rules.fence = (...args) => {
+		const [tokens, idx] = args;
+		const token = tokens[idx];
+		if (checkIfInCodeGroup(tokens, idx)) return originalRule(...args);
+		const titleMatch = token.info.match(/\[((?:[^[\]]|\[[^[\]]*\])*)\]/);
+		if (!titleMatch) return originalRule(...args);
+		if (token.src && !options.includeSnippet) return originalRule(...args);
+		const title = titleMatch[1];
+		return `
+<div class="vp-code-block-title">
+  <div class="vp-code-block-title-bar">
+    <span class="vp-code-block-title-text" data-title="${md.utils.escapeHtml(title)}">${title}</span>
+  </div>
+  ${originalRule(...args)}
+</div>
+`;
+	};
+}
+/**
+* 检查当前token是否在代码组内
+*/
+function checkIfInCodeGroup(tokens, currentIndex) {
+	for (let i = currentIndex - 1; i >= 0; i--) {
+		if (tokens[i].type === "container_code-group_open") return true;
+		if (tokens[i].type === "container_code-group_close") return false;
+	}
+	return false;
+}
+//#endregion
+//#region src/loader.ts
+/**
+* 本地图标加载器 - 从相对路径加载SVG文件
+* 
+* @param url - import.meta.url (当前模块的URL)
+* @param relativePath - 相对于当前模块的SVG文件路径
+* @returns SVG字符串
+* 
+* @example
+* // 从assets目录加载
+* 'vitepress': localIconLoader(import.meta.url, '../assets/vitepress.svg')
+* 
+* // 从同目录加载
+* 'my-icon': localIconLoader(import.meta.url, './my-icon.svg')
+*/
+function localIconLoader(url, relativePath) {
+	try {
+		return readFileSync(resolve(dirname(fileURLToPath(url)), relativePath), "utf-8");
+	} catch (error) {
+		console.warn(`[vitepress-uni-icons] Failed to load icon from: ${relativePath}`, error);
+		return "";
+	}
+}
+/**
+* Public图标加载器 - 从VitePress的public目录加载
+* 注意: 这个函数返回的是public路径,需要在运行时通过fetch加载
+* 
+* @param publicPath - public目录下的文件路径
+* @returns Public路径标识(以 / 开头)
+* 
+* @example
+* // 从public目录加载
+* 'my-framework': publicIconLoader('icons/git.svg')
+* 
+* // 简写形式
+* 'my-framework': publicIconLoader('git.svg')  // 对应 public/git.svg
+*/
+function publicIconLoader(publicPath) {
+	return publicPath.startsWith("/") ? publicPath : `/${publicPath}`;
+}
+//#endregion
+//#region src/index.ts
+var uniIconsPlugin = createPlugin;
+var uniIconsMarkdown = createMarkdownPlugin;
+//#endregion
+export { CSSGenerator, IconMatcher, IconResolver, IconScanner, builtinIcons, localIconLoader, publicIconLoader, uniIconsMarkdown, uniIconsPlugin };