vitepress-plugin-toolkit 0.5.0 → 0.7.0

package/dist/client/browser/index.js

@@ -49,7 +49,7 @@ function isExternal(path) {
 * URL_PROTOCOL_RE.test('mailto:foo@example.com') // true
 * URL_PROTOCOL_RE.test('//cdn.example.com/lib.js') // false
 */
-const URL_PROTOCOL_RE = /^[a-z][a-z0-9+.-]*:/;
+const URL_PROTOCOL_RE = /^[a-z][a-z0-9+.-]*:/i;
 /**
 * Checks whether the given link contains a URL protocol scheme or is a
 * protocol-relative URL.

package/dist/client/ssr/index.js

@@ -50,7 +50,7 @@ function isExternal(path) {
 * URL_PROTOCOL_RE.test('mailto:foo@example.com') // true
 * URL_PROTOCOL_RE.test('//cdn.example.com/lib.js') // false
 */
-const URL_PROTOCOL_RE = /^[a-z][a-z0-9+.-]*:/;
+const URL_PROTOCOL_RE = /^[a-z][a-z0-9+.-]*:/i;
 /**
 * Checks whether the given link contains a URL protocol scheme or is a
 * protocol-relative URL.

package/dist/client/styles/transition/fade-in.css

@@ -2,7 +2,7 @@
 
 .fade-in-enter-active,
 .fade-in-leave-active {
-  transition: all var(--transition-duration) var(--transition-ease-in-out) !important;
+  transition: opacity var(--transition-duration) var(--transition-ease-in-out) !important;
 }
 
 .fade-in-enter-from,

package/dist/node/index.d.ts

@@ -1,7 +1,7 @@
 import { Matcher } from "picomatch";
+import { MarkdownEnv, Plugin, SiteConfig } from "vitepress";
 import MarkdownIt from "markdown-it";
 import { RenderRule } from "markdown-it/lib/renderer.mjs";
-import { MarkdownEnv, Plugin, SiteConfig } from "vitepress";
 
 //#region src/shared/link.d.ts
 /**
@@ -126,6 +126,58 @@ interface SizeOptions {
   ratio?: number | string;
 }
 //#endregion
+//#region src/node/markdown/clean-markdown-env.d.ts
+/**
+ * Clean Markdown Environment
+ *
+ * 清理后的 Markdown 环境
+ */
+interface CleanMarkdownEnv extends MarkdownEnv {
+  /**
+   * References
+   *
+   * 引用链接
+   */
+  references?: unknown;
+  /**
+   * Abbreviations
+   *
+   * 缩写词
+   */
+  abbreviations?: unknown;
+  /**
+   * Annotations
+   *
+   * 注释
+   */
+  annotations?: unknown;
+}
+declare const WHITE_KEYS_LIST: readonly ["cleanUrls", "path", "realPath", "relativePath", "localeIndex", "references", "abbreviations", "annotations"];
+type WhiteKeysListUnion = (typeof WHITE_KEYS_LIST)[number];
+/**
+ * Clean markdown environment for inline rendering.
+ *
+ * 清理 markdown 环境以用于行内渲染。
+ *
+ * When using `md.renderInline()` in custom renderers, some environment properties
+ * may cause issues. This function creates a clean environment object with only
+ * the necessary properties preserved.
+ *
+ * 在自定义渲染器中使用 `md.renderInline()` 时，某些环境属性可能会导致问题。
+ * 该函数创建一个只保留必要属性的干净环境对象。
+ *
+ * @param env - Markdown environment / Markdown 环境
+ * @param exclude - Keys to exclude / 要排除的键
+ * @returns Cleaned environment / 清理后的环境
+ *
+ * @example
+ * ```ts
+ * const cleanEnv = cleanMarkdownEnv(env)
+ * const rendered = md.renderInline(content, cleanEnv)
+ * ```
+ */
+declare function cleanMarkdownEnv(env: MarkdownEnv, exclude?: WhiteKeysListUnion[]): CleanMarkdownEnv;
+//#endregion
 //#region src/node/markdown/container.d.ts
 /**
  * Type for getting RenderRule parameters
@@ -309,7 +361,7 @@ declare const EXTENSION_AUDIOS: string[];
  * @param exclude - Patterns to exclude, can be string or array / 要排除的模式，可以是字符串或数组
  * @returns Matcher instance / 匹配器实例
  */
-declare function createMatcher(include?: string | string[], exclude?: string | string[]): Matcher | undefined;
+declare function createMatcher(include?: string | string[], exclude?: string | string[]): Matcher;
 /**
  * Resolve include and exclude patterns into pattern and ignore arrays.
  * Converts various pattern formats into a standardized format for matching.
@@ -716,4 +768,4 @@ declare function getVitepressConfig(): SiteConfig;
  */
 declare function resolveRouteLink(url: string, env: MarkdownEnv): string;
 //#endregion
-export { BuiltinLocale, BuiltinLocales, ContainerOptions, EXTENSION_AUDIOS, EXTENSION_IMAGES, EXTENSION_VIDEOS, EXTERNAL_URL_RE, EmbedRuleBlockOptions, LogLevel, LogType, Logger, SizeOptions, URL_PROTOCOL_RE, createContainerPlugin, createContainerSyntaxPlugin, createEmbedRuleBlock, createLocales, createLogger, createMatcher, genHash, getLocaleWithPath, getVitepressConfig, iconPlugin, isBuild, isDev, isExternal, isLinkWithProtocol, logLevels, parseRect, resolveAttr, resolveAttrs, resolveMatcherPattern, resolveRouteLink, slugify, stringifyAttrs, treatAsHtml };
+export { BuiltinLocale, BuiltinLocales, CleanMarkdownEnv, ContainerOptions, EXTENSION_AUDIOS, EXTENSION_IMAGES, EXTENSION_VIDEOS, EXTERNAL_URL_RE, EmbedRuleBlockOptions, LogLevel, LogType, Logger, SizeOptions, URL_PROTOCOL_RE, cleanMarkdownEnv, createContainerPlugin, createContainerSyntaxPlugin, createEmbedRuleBlock, createLocales, createLogger, createMatcher, genHash, getLocaleWithPath, getVitepressConfig, iconPlugin, isBuild, isDev, isExternal, isLinkWithProtocol, logLevels, parseRect, resolveAttr, resolveAttrs, resolveMatcherPattern, resolveRouteLink, slugify, stringifyAttrs, treatAsHtml };

package/dist/node/index.js

@@ -1,5 +1,5 @@
 import container from "markdown-it-container";
-import { LRUCache, camelCase, deepMerge, isArray, isBoolean, isNull, isNumber, isPrimitive, isString, isUndefined, kebabCase, objectEntries, objectKeys, omit, slash, toArray, uniq } from "@pengzhanbo/utils";
+import { LRUCache, attempt, camelCase, deepMerge, isArray, isBoolean, isNull, isNumber, isPrimitive, isString, isUndefined, kebabCase, objectEntries, objectKeys, omit, removeTrailingSlash, slash, toArray, uniq } from "@pengzhanbo/utils";
 import ansis from "ansis";
 import process from "node:process";
 import picomatch from "picomatch";
@@ -53,7 +53,7 @@ function isExternal(path) {
 * URL_PROTOCOL_RE.test('mailto:foo@example.com') // true
 * URL_PROTOCOL_RE.test('//cdn.example.com/lib.js') // false
 */
-const URL_PROTOCOL_RE = /^[a-z][a-z0-9+.-]*:/;
+const URL_PROTOCOL_RE = /^[a-z][a-z0-9+.-]*:/i;
 /**
 * Checks whether the given link contains a URL protocol scheme or is a
 * protocol-relative URL.
@@ -79,6 +79,48 @@ function isLinkWithProtocol(link) {
 	return URL_PROTOCOL_RE.test(link) || link.startsWith("//");
 }
 //#endregion
+//#region src/node/markdown/clean-markdown-env.ts
+const WHITE_KEYS_LIST = [
+	"cleanUrls",
+	"path",
+	"realPath",
+	"relativePath",
+	"localeIndex",
+	"references",
+	"abbreviations",
+	"annotations"
+];
+/**
+* Clean markdown environment for inline rendering.
+*
+* 清理 markdown 环境以用于行内渲染。
+*
+* When using `md.renderInline()` in custom renderers, some environment properties
+* may cause issues. This function creates a clean environment object with only
+* the necessary properties preserved.
+*
+* 在自定义渲染器中使用 `md.renderInline()` 时，某些环境属性可能会导致问题。
+* 该函数创建一个只保留必要属性的干净环境对象。
+*
+* @param env - Markdown environment / Markdown 环境
+* @param exclude - Keys to exclude / 要排除的键
+* @returns Cleaned environment / 清理后的环境
+*
+* @example
+* ```ts
+* const cleanEnv = cleanMarkdownEnv(env)
+* const rendered = md.renderInline(content, cleanEnv)
+* ```
+*/
+function cleanMarkdownEnv(env, exclude = []) {
+	const result = {};
+	for (const key of WHITE_KEYS_LIST) {
+		if (exclude.includes(key)) continue;
+		result[key] = env[key];
+	}
+	return result;
+}
+//#endregion
 //#region src/node/utils/resolve-attrs.ts
 /**
 * Regular expression for matching attribute values
@@ -453,7 +495,7 @@ function resolveMatcherPattern(include, exclude) {
 	};
 }
 function normalize(arr) {
-	return isArray(arr) ? arr.sort((a, b) => a.localeCompare(b)) : arr;
+	return isArray(arr) ? [...arr].sort((a, b) => a.localeCompare(b)) : arr;
 }
 //#endregion
 //#region src/node/utils/logger.ts
@@ -534,6 +576,7 @@ function createLogger(prefix, defaultLevel = "info") {
 * ```
 */
 function parseRect(str, unit = "px") {
+	str = str.trim();
 	if (Number.parseFloat(str) === Number(str)) return `${str}${unit}`;
 	return str;
 }
@@ -788,7 +831,7 @@ function createLocales(builtinLocales, userLocales = {}) {
 		locales[key] = localeData;
 		break;
 	}
-	if (!locales.root) locales.root = builtinLocales[0][1];
+	if (!locales.root) locales.root = builtinLocales[0]?.[1] || {};
 	deepMerge(locales, userLocales);
 	return locales;
 }
@@ -817,7 +860,7 @@ function createLocales(builtinLocales, userLocales = {}) {
 */
 function getLocaleWithPath(path) {
 	const locales = getVitepressConfig().userConfig?.locales || {};
-	const keys = objectKeys(locales);
+	const keys = objectKeys(locales).sort((a, b) => b.length - a.length);
 	const key = keys.find((locale) => path.startsWith(locale)) || keys[0] || "";
 	if (!key || !locales[key]) return {
 		lang: "",
@@ -864,10 +907,12 @@ const indexRE = /(^|.*\/)index.md(.*)$/i;
 function resolveRouteLink(url, env) {
 	if (isExternal(url)) return url;
 	const config = getVitepressConfig();
-	if (url.startsWith("/")) return slash(config.site.base + url);
-	if (url.startsWith("#")) return decodeURI(normalizeHash(url));
-	const { pathname, protocol } = new URL(url, "http://a.com");
-	if (!url.startsWith("#") && protocol.startsWith("http") && treatAsHtml(pathname)) {
+	if (url.startsWith("/")) return slash(removeTrailingSlash(config.site.base) + url);
+	if (url.startsWith("#")) return normalizeHash(url);
+	const [error, data] = attempt(() => new URL(url, "http://a.com"));
+	if (error) return url;
+	const { pathname, protocol } = data;
+	if (protocol.startsWith("http") && treatAsHtml(pathname)) {
 		const indexMatch = url.match(indexRE);
 		if (indexMatch) {
 			const [, path, hash] = indexMatch;
@@ -895,4 +940,4 @@ function normalizeHash(str) {
 	return str ? encodeURI(`#${slugify(decodeURI(str).slice(1))}`) : "";
 }
 //#endregion
-export { EXTENSION_AUDIOS, EXTENSION_IMAGES, EXTENSION_VIDEOS, EXTERNAL_URL_RE, URL_PROTOCOL_RE, createContainerPlugin, createContainerSyntaxPlugin, createEmbedRuleBlock, createLocales, createLogger, createMatcher, genHash, getLocaleWithPath, getVitepressConfig, iconPlugin, isBuild, isDev, isExternal, isLinkWithProtocol, logLevels, parseRect, resolveAttr, resolveAttrs, resolveMatcherPattern, resolveRouteLink, slugify, stringifyAttrs, treatAsHtml };
+export { EXTENSION_AUDIOS, EXTENSION_IMAGES, EXTENSION_VIDEOS, EXTERNAL_URL_RE, URL_PROTOCOL_RE, cleanMarkdownEnv, createContainerPlugin, createContainerSyntaxPlugin, createEmbedRuleBlock, createLocales, createLogger, createMatcher, genHash, getLocaleWithPath, getVitepressConfig, iconPlugin, isBuild, isDev, isExternal, isLinkWithProtocol, logLevels, parseRect, resolveAttr, resolveAttrs, resolveMatcherPattern, resolveRouteLink, slugify, stringifyAttrs, treatAsHtml };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vitepress-plugin-toolkit",
   "type": "module",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Development toolkit for vitepress plugins",
   "author": "pengzhanbo <q942450674@outlook.com> (https://github.com/pengzhanbo/)",
   "license": "MIT",