vitepress-plugin-toolkit 0.1.0

package/dist/client/styles/loading.css

@@ -0,0 +1,18 @@
+.vp-loading {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 36px;
+  color: currentcolor;
+  background-color: inherit;
+  transition: background-color 0.3s ease-in-out;
+}
+
+.vp-loading.absolute {
+  position: absolute;
+  top: 0;
+  right: 0;
+  bottom: 0;
+  left: 0;
+  z-index: 2;
+}

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

@@ -0,0 +1,25 @@
+@import url("./vars.css");
+
+:root {
+  --transition-fade-in-down-offset: -10px;
+}
+
+.fade-in-down-enter-from,
+.fade-in-down-leave-to {
+  opacity: 0 !important;
+  transform: translateY(var(--transition-fade-in-down-offset)) !important;
+}
+
+.fade-in-down-enter-to,
+.fade-in-down-leave-from {
+  opacity: 1;
+  transform: translateY(0) !important;
+}
+
+.fade-in-down-leave-active {
+  transition: opacity var(--transition-leave-duration) var(--transition-ease-in-out), transform var(--transition-leave-duration) var(--transition-ease-in-out) !important;
+}
+
+.fade-in-down-enter-active {
+  transition: opacity var(--transition-enter-duration) var(--transition-ease-in-out), transform var(--transition-enter-duration) var(--transition-ease-in-out) !important;
+}

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

@@ -0,0 +1,25 @@
+@import url("./vars.css");
+
+.fade-in-height-expand-leave-from,
+.fade-in-height-expand-enter-to {
+  opacity: 1;
+}
+
+.fade-in-height-expand-leave-to,
+.fade-in-height-expand-enter-from {
+  padding-top: 0 !important;
+  padding-bottom: 0 !important;
+  margin-top: 0 !important;
+  margin-bottom: 0 !important;
+  opacity: 0 !important;
+}
+
+.fade-in-height-expand-leave-active {
+  overflow: hidden !important;
+  transition: max-height var(--transition-slow-duration) var(--transition-ease-in-out), opacity var(--transition-leave-duration) var(--transition-ease-out), margin-top var(--transition-slow-duration) var(--transition-ease-in-out), margin-bottom var(--transition-slow-duration) var(--transition-ease-in-out), padding-top var(--transition-slow-duration) var(--transition-ease-in-out), padding-bottom var(--transition-slow-duration) var(--transition-ease-in-out) !important;
+}
+
+.fade-in-height-expand-enter-active {
+  overflow: hidden !important;
+  transition: max-height var(--transition-slow-duration) var(--transition-ease-in-out), opacity var(--transition-enter-duration) var(--transition-ease-in), margin-top var(--transition-slow-duration) var(--transition-ease-in-out), margin-bottom var(--transition-slow-duration) var(--transition-ease-in-out), padding-top var(--transition-slow-duration) var(--transition-ease-in-out), padding-bottom var(--transition-slow-duration) var(--transition-ease-in-out) !important;
+}

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

@@ -0,0 +1,25 @@
+@import url("./vars.css");
+
+:root {
+  --transition-fade-in-left-offset: 10px;
+}
+
+.fade-in-left-enter-from,
+.fade-in-left-leave-to {
+  opacity: 0 !important;
+  transform: translateX(var(--transition-fade-in-left-offset)) !important;
+}
+
+.fade-in-left-enter-to,
+.fade-in-left-leave-from {
+  opacity: 1;
+  transform: translateX(0) !important;
+}
+
+.fade-in-left-leave-active {
+  transition: opacity var(--transition-leave-duration) var(--transition-ease-in-out), transform var(--transition-leave-duration) var(--transition-ease-in-out) !important;
+}
+
+.fade-in-left-enter-active {
+  transition: opacity var(--transition-enter-duration) var(--transition-ease-in-out), transform var(--transition-enter-duration) var(--transition-ease-in-out) !important;
+}

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

@@ -0,0 +1,25 @@
+@import url("./vars.css");
+
+:root {
+  --transition-fade-in-right-offset: -10px;
+}
+
+.fade-in-right-enter-from,
+.fade-in-right-leave-to {
+  opacity: 0 !important;
+  transform: translateX(var(--transition-fade-in-right-offset)) !important;
+}
+
+.fade-in-right-enter-to,
+.fade-in-right-leave-from {
+  opacity: 1;
+  transform: translateX(0) !important;
+}
+
+.fade-in-right-leave-active {
+  transition: opacity var(--transition-leave-duration) var(--transition-ease-in-out), transform var(--transition-leave-duration) var(--transition-ease-in-out) !important;
+}
+
+.fade-in-right-enter-active {
+  transition: opacity var(--transition-enter-duration) var(--transition-ease-in-out), transform var(--transition-enter-duration) var(--transition-ease-in-out) !important;
+}

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

@@ -0,0 +1,29 @@
+@import url("./vars.css");
+
+:root {
+  --transition-fade-in-scale-up-scale: 0.9;
+  --transition-fade-in-scale-up-duration: var(--transition-duration);
+  --transition-fade-in-scale-up-origin: inherit;
+}
+
+.fade-in-scale-up-leave-active {
+  transition: opacity var(--transition-fade-in-scale-up-duration) var(--transition-ease-in), transform var(--transition-fade-in-scale-up-duration) var(--transition-ease-in) !important;
+  transform-origin: var(--transition-fade-in-scale-up-origin) !important;
+}
+
+.fade-in-scale-up-enter-active {
+  transition: opacity var(--transition-fade-in-scale-up-duration) var(--transition-ease-out), transform var(--transition-fade-in-scale-up-duration) var(--transition-ease-out) !important;
+  transform-origin: var(--transition-fade-in-scale-up-origin) !important;
+}
+
+.fade-in-scale-up-enter-from,
+.fade-in-scale-up-leave-to {
+  opacity: 0 !important;
+  transform: scale(var(--transition-fade-in-scale-up-scale)) !important;
+}
+
+.fade-in-scale-up-leave-from,
+.fade-in-scale-up-enter-to {
+  opacity: 1;
+  transform: scale(1) !important;
+}

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

@@ -0,0 +1,25 @@
+@import url("./vars.css");
+
+:root {
+  --transition-fade-in-up-offset: 10px;
+}
+
+.fade-in-up-enter-from,
+.fade-in-up-leave-to {
+  opacity: 0 !important;
+  transform: translateY(var(--transition-fade-in-up-offset)) !important;
+}
+
+.fade-in-up-enter-to,
+.fade-in-up-leave-from {
+  opacity: 1;
+  transform: translateY(0) !important;
+}
+
+.fade-in-up-leave-active {
+  transition: opacity var(--transition-leave-duration) var(--transition-ease-in-out), transform var(--transition-leave-duration) var(--transition-ease-in-out) !important;
+}
+
+.fade-in-up-enter-active {
+  transition: opacity var(--transition-enter-duration) var(--transition-ease-in-out), transform var(--transition-enter-duration) var(--transition-ease-in-out) !important;
+}

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

@@ -0,0 +1,23 @@
+@import url("./vars.css");
+
+.fade-in-width-expand-leave-from,
+.fade-in-width-expand-enter-to {
+  opacity: 1;
+}
+
+.fade-in-width-expand-leave-to,
+.fade-in-width-expand-enter-from {
+  margin-right: 0 !important;
+  margin-left: 0 !important;
+  opacity: 0 !important;
+}
+
+.fade-in-width-expand-leave-active {
+  overflow: hidden !important;
+  transition: max-width var(--transition-leave-duration) var(--transition-ease-in-out) var(--transition-delay), opacity var(--transition-leave-duration) var(--transition-ease-in-out), margin-right var(--transition-leave-duration) var(--transition-ease-in-out) var(--transition-delay), margin-left var(--transition-duration) var(--transition-ease-in-out) var(--transition-delay) !important;
+}
+
+.fade-in-width-expand-enter-active {
+  overflow: hidden !important;
+  transition: max-width var(--transition-enter-duration) var(--transition-ease-in-out), opacity var(--transition-leave-duration) var(--transition-ease-in-out) var(--transition-delay), margin-right var(--transition-enter-duration) var(--transition-ease-in-out), margin-left var(--transition-enter-duration) var(--transition-ease-in-out) !important;
+}

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

@@ -0,0 +1,16 @@
+@import url("./vars.css");
+
+.fade-in-enter-active,
+.fade-in-leave-active {
+  transition: all var(--transition-duration) var(--transition-ease-in-out) !important;
+}
+
+.fade-in-enter-from,
+.fade-in-leave-to {
+  opacity: 0 !important;
+}
+
+.fade-in-leave-from,
+.fade-in-enter-to {
+  opacity: 1;
+}

package/dist/client/styles/transition/slide-in-down.css

@@ -0,0 +1,23 @@
+@import url("./vars.css");
+
+:root {
+  --transition-slide-in-down-offset: -100%;
+}
+
+.slide-in-down-leave-active {
+  transition: transform var(--transition-leave-duration) var(--transition-ease-in) !important;
+}
+
+.slide-in-down-enter-active {
+  transition: transform var(--transition-enter-duration) var(--transition-ease-out) !important;
+}
+
+.slide-in-down-enter-to,
+.slide-in-down-leave-from {
+  transform: translateY(0) !important;
+}
+
+.slide-in-down-enter-from,
+.slide-in-down-leave-to {
+  transform: translateY(var(--transition-slide-in-down-offset)) !important;
+}

package/dist/client/styles/transition/slide-in-left.css

@@ -0,0 +1,23 @@
+@import url("./vars.css");
+
+:root {
+  --transition-slide-in-left-offset: 100%;
+}
+
+.slide-in-left-leave-active {
+  transition: transform var(--transition-leave-duration) var(--transition-ease-in) !important;
+}
+
+.slide-in-left-enter-active {
+  transition: transform var(--transition-enter-duration) var(--transition-ease-out) !important;
+}
+
+.slide-in-left-enter-to,
+.slide-in-left-leave-from {
+  transform: translateX(0) !important;
+}
+
+.slide-in-left-enter-from,
+.slide-in-left-leave-to {
+  transform: translateX(var(--transition-slide-in-left-offset)) !important;
+}

package/dist/client/styles/transition/slide-in-right.css

@@ -0,0 +1,23 @@
+@import url("./vars.css");
+
+:root {
+  --transition-slide-in-right-offset: -100%;
+}
+
+.slide-in-right-leave-active {
+  transition: transform var(--transition-leave-duration) var(--transition-ease-in) !important;
+}
+
+.slide-in-right-enter-active {
+  transition: transform var(--transition-enter-duration) var(--transition-ease-out) !important;
+}
+
+.slide-in-right-enter-to,
+.slide-in-right-leave-from {
+  transform: translateX(0) !important;
+}
+
+.slide-in-right-enter-from,
+.slide-in-right-leave-to {
+  transform: translateX(var(--transition-slide-in-right-offset)) !important;
+}

package/dist/client/styles/transition/slide-in-up.css

@@ -0,0 +1,23 @@
+@import url("./vars.css");
+
+:root {
+  --transition-slide-in-up-offset: 100%;
+}
+
+.slide-in-up-leave-active {
+  transition: transform var(--transition-leave-duration) var(--transition-ease-in) !important;
+}
+
+.slide-in-up-enter-active {
+  transition: transform var(--transition-enter-duration) var(--transition-ease-out) !important;
+}
+
+.slide-in-up-enter-to,
+.slide-in-up-leave-from {
+  transform: translateY(0) !important;
+}
+
+.slide-in-up-enter-from,
+.slide-in-up-leave-to {
+  transform: translateY(var(--transition-slide-in-up-offset)) !important;
+}

package/dist/client/styles/transition/vars.css

@@ -0,0 +1,10 @@
+:root {
+  --transition-ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
+  --transition-ease-out: cubic-bezier(0, 0, 0.2, 1);
+  --transition-ease-in: cubic-bezier(0.4, 0, 1, 1);
+  --transition-duration: 0.2s;
+  --transition-slow-duration: 0.3s;
+  --transition-enter-duration: var(--transition-duration);
+  --transition-leave-duration: var(--transition-duration);
+  --transition-delay: 0.1s;
+}

package/dist/node/index.d.ts

@@ -0,0 +1,331 @@
+import MarkdownIt from "markdown-it";
+import { RenderRule } from "markdown-it/lib/renderer.mjs";
+import { RuleOptions } from "markdown-it/lib/ruler.mjs";
+import { MarkdownEnv, SiteConfig } from "vitepress";
+
+//#region src/shared/link.d.ts
+declare const EXTERNAL_URL_RE: RegExp;
+declare function isExternal(path: string): boolean;
+declare const URL_PROTOCOL_RE: RegExp;
+declare function isLinkWithProtocol(link: string): boolean;
+//#endregion
+//#region src/shared/size.d.ts
+/**
+ * Size Options
+ *
+ * 尺寸选项
+ */
+interface SizeOptions {
+  /**
+   * Width
+   *
+   * 宽度
+   */
+  width?: string;
+  /**
+   * Height
+   *
+   * 高度
+   */
+  height?: string;
+  /**
+   * Aspect ratio
+   *
+   * 宽高比
+   */
+  ratio?: number | string;
+}
+//#endregion
+//#region src/node/markdown/container.d.ts
+/**
+ * Type for getting RenderRule parameters
+ *
+ * 获取 RenderRule 参数的类型
+ */
+type RenderRuleParams = Parameters<RenderRule> extends [...infer Args, infer _] ? Args : never;
+/**
+ * Container options
+ *
+ * 自定义容器的配置项
+ */
+interface ContainerOptions {
+  /**
+   * Callback for rendering container opening tag
+   *
+   * 渲染容器起始标签时的回调
+   */
+  before?: (info: string, ...args: RenderRuleParams) => string;
+  /**
+   * Callback for rendering container closing tag
+   *
+   * 渲染容器结束标签时的回调
+   */
+  after?: (info: string, ...args: RenderRuleParams) => string;
+}
+/**
+ * Create markdown-it custom container plugin
+ *
+ * 创建 markdown-it 的自定义容器插件
+ *
+ * @param md - Markdown-it instance / Markdown-it 实例
+ * @param type - Container type (e.g., 'tip', 'warning') / 容器类型（如 'tip', 'warning' 等）
+ * @param options - Optional before/after render hooks / 可选的 before/after 渲染钩子
+ * @param options.before - Callback for rendering container opening tag / 渲染容器起始标签时的回调函数
+ * @param options.after - Callback for rendering container closing tag / 渲染容器结束标签时的回调函数
+ */
+declare function createContainerPlugin(md: MarkdownIt, type: string, {
+  before,
+  after
+}?: ContainerOptions): void;
+/**
+ * Create a custom container rule where content is not processed by markdown-it
+ * Requires custom content processing logic
+ * ```md
+ * ::: type
+ *  xxxx    <-- content: this part will not be processed by markdown-it
+ * :::
+ * ```
+ *
+ * @example
+ * ```ts
+ * const example = createContainerSyntaxPlugin(md, 'example', (tokens, index, options, env) => {
+ *   const { content, meta } = tokens[index]
+ *   return `<div class="example">${meta.title} | ${content}</div>`
+ * })
+ * ```
+ *
+ * @param md - Markdown-it instance / Markdown-it 实例
+ * @param type - Container type / 容器类型
+ * @param render - Custom render rule / 自定义渲染规则
+ */
+declare function createContainerSyntaxPlugin(md: MarkdownIt, type: string, render?: RenderRule): void;
+//#endregion
+//#region src/node/markdown/embed.d.ts
+/**
+ * Embed rule block options
+ *
+ * 嵌入规则块选项
+ *
+ * @typeParam Meta - Metadata type / 元数据类型
+ */
+interface EmbedRuleBlockOptions<Meta extends Record<string, any>> {
+  /**
+   * Embed type syntax: @[type]()
+   *
+   * 嵌入类型语法：@[type]()
+   */
+  type: string;
+  /**
+   * Token name
+   *
+   * 令牌名称
+   */
+  name?: string;
+  /**
+   * Name of the rule to insert before
+   *
+   * 要插入在其前面的规则名称
+   */
+  beforeName?: string;
+  /**
+   * Syntax pattern regular expression
+   *
+   * 语法模式正则表达式
+   */
+  syntaxPattern: RegExp;
+  /**
+   * Rule options
+   *
+   * 规则选项
+   */
+  ruleOptions?: RuleOptions;
+  /**
+   * Extract metadata from match
+   *
+   * 从匹配中提取元数据
+   *
+   * @param match - RegExp match array / 正则表达式匹配数组
+   * @returns Metadata object / 元数据对象
+   */
+  meta: (match: RegExpMatchArray) => Meta;
+  /**
+   * Generate content from metadata
+   *
+   * 从元数据生成内容
+   *
+   * @param meta - Metadata / 元数据
+   * @param content - Original content / 原始内容
+   * @param env - Markdown environment / Markdown 环境
+   * @returns Generated content / 生成的内容
+   */
+  content: (meta: Meta, content: string, env: MarkdownEnv) => string;
+}
+/**
+ * Create embed rule block
+ *
+ * 创建嵌入规则块
+ *
+ * Syntax: \@\[name]()
+ *
+ * 语法：\@\[name]()
+ *
+ * @param md - Markdown instance / Markdown 实例
+ * @param {EmbedRuleBlockOptions} options - Embed rule block options / 嵌入规则块选项
+ * @typeParam Meta - Metadata type / 元数据类型
+ */
+declare function createEmbedRuleBlock<Meta extends Record<string, any> = Record<string, any>>(md: MarkdownIt, {
+  type,
+  name,
+  syntaxPattern,
+  beforeName,
+  ruleOptions,
+  meta,
+  content
+}: EmbedRuleBlockOptions<Meta>): void;
+//#endregion
+//#region src/node/utils/constants.d.ts
+/**
+ * 支持的视频文件名扩展名
+ */
+declare const EXTENSION_VIDEOS: string[];
+/**
+ * 支持的图片文件名扩展名
+ */
+declare const EXTENSION_IMAGES: string[];
+/**
+ * 支持的音频文件名扩展名
+ */
+declare const EXTENSION_AUDIOS: string[];
+//#endregion
+//#region src/node/utils/logger.d.ts
+type LogType = 'info' | 'warn' | 'error' | 'debug';
+type LogLevel = LogType | 'silent';
+/**
+ * Logger interface
+ *
+ * 日志接口
+ */
+interface Logger {
+  /**
+   * Debug log
+   *
+   * 调试日志
+   */
+  debug: (msg: string, level?: boolean | LogLevel) => void;
+  /**
+   * Info log
+   *
+   * 信息日志
+   */
+  info: (msg: string, level?: boolean | LogLevel) => void;
+  /**
+   * Warning log
+   *
+   * 警告日志
+   */
+  warn: (msg: string, level?: boolean | LogLevel) => void;
+  /**
+   * Error log
+   *
+   * 错误日志
+   */
+  error: (msg: string, level?: boolean | LogLevel) => void;
+}
+/**
+ * Log levels mapping
+ *
+ * 日志级别映射
+ */
+declare const logLevels: Record<LogLevel, number>;
+/**
+ * Create logger instance
+ *
+ * 创建日志实例
+ *
+ * @param prefix - Log prefix / 日志前缀
+ * @param defaultLevel - Default log level / 默认日志级别
+ * @returns Logger instance / 日志实例
+ */
+declare function createLogger(prefix: string, defaultLevel?: LogLevel): Logger;
+//#endregion
+//#region src/node/utils/parseRect.d.ts
+/**
+ * Parse rect size string, add unit if it's a number
+ *
+ * 解析矩形尺寸字符串，如果是数字则添加单位
+ *
+ * @param str - Size string / 尺寸字符串
+ * @param unit - Unit to append (default: 'px') / 要添加的单位（默认：'px'）
+ * @returns Size string with unit / 带单位的尺寸字符串
+ */
+declare function parseRect(str: string, unit?: string): string;
+//#endregion
+//#region src/node/utils/resolve-attrs.d.ts
+/**
+ * Resolve attribute string to object
+ *
+ * 将属性字符串解析为对象
+ *
+ * @param info - Attribute string / 属性字符串
+ * @returns Object with attrs and rawAttrs / 包含 attrs 和 rawAttrs 的对象
+ * @typeParam T - Attribute type / 属性类型
+ */
+declare function resolveAttrs<T extends Record<string, any> = Record<string, any>>(info: string): T;
+/**
+ * Resolve single attribute value from info string
+ *
+ * 从信息字符串中解析单个属性值
+ *
+ * @param info - Info string / 信息字符串
+ * @param key - Attribute key / 属性键
+ * @returns Attribute value or undefined / 属性值或 undefined
+ */
+declare function resolveAttr(info: string, key: string): string | undefined;
+//#endregion
+//#region src/node/utils/slugify.d.ts
+/**
+ * Default slugification function
+ */
+declare function slugify(str: string): string;
+//#endregion
+//#region src/node/utils/stringify-attrs.d.ts
+/**
+ * Stringify attributes object to HTML attribute string
+ *
+ * 将属性对象字符串化为 HTML 属性字符串
+ *
+ * @param attrs - Attributes object / 属性对象
+ * @param withUndefinedOrNull - Whether to include undefined/null values / 是否包含 undefined/null 值
+ * @param forceStringify - Keys to force stringify / 强制字符串化的键
+ * @returns HTML attribute string / HTML 属性字符串
+ * @typeParam T - Attribute type / 属性类型
+ */
+declare function stringifyAttrs<T extends object = object>(attrs: T, withUndefinedOrNull?: boolean, forceStringify?: (keyof T)[]): string;
+//#endregion
+//#region src/node/utils/treat-as-html.d.ts
+declare function treatAsHtml(filename: string): boolean;
+//#endregion
+//#region src/node/vitepress/createLocales.d.ts
+type BuiltinLocale<LocaleData extends Record<string, unknown>> = [langCodes: string[], localeData: LocaleData];
+type BuiltinLocales<LocaleData extends Record<string, unknown>> = BuiltinLocale<LocaleData>[];
+/**
+ * 创建 locales
+ * @param builtinLocales 内置的 locales
+ * @param userLocales 用户的 locales
+ * @returns locales
+ */
+declare function createLocales<LocaleData extends Record<string, unknown>>(builtinLocales: BuiltinLocales<LocaleData>, userLocales?: Record<string, LocaleData>): Record<string, LocaleData>;
+//#endregion
+//#region src/node/vitepress/get-locale-with-path.d.ts
+declare function getLocaleWithPath(path: string): {
+  lang: string;
+  locale: string;
+};
+//#endregion
+//#region src/node/vitepress/get-vitepress-config.d.ts
+declare function getVitepressConfig(): SiteConfig;
+//#endregion
+//#region src/node/vitepress/resolve-route-link.d.ts
+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, getLocaleWithPath, getVitepressConfig, isExternal, isLinkWithProtocol, logLevels, parseRect, resolveAttr, resolveAttrs, resolveRouteLink, slugify, stringifyAttrs, treatAsHtml };