@wot-ui/vitepress-theme 2.0.0-alpha.10

package/README.md

@@ -0,0 +1,153 @@
+# @wot-ui/vitepress-theme
+
+这是一个为 [Wot UI](https://github.com/wot-ui/wot-ui) 文档量身定制的 VitePress 共享主题包。
+该主题包内聚了 VitePress 运行时配置、自定义 Vue 组件、Markdown 增强插件以及常用的业务配置（如顶部通栏、广告、赞助商等），通过配置工厂的形式暴露，支持通过选项灵活开启、关闭或定制各模块能力，使得组织内其他项目能够快速复用一致的文档风格。
+
+## 安装
+
+由于本包主要供组织内文档站点使用，推荐通过工作区 (workspace) 的方式引入：
+
+```bash
+pnpm add @wot-ui/vitepress-theme -D
+```
+
+## 使用方式
+
+### 1. 配置 VitePress (`config.mts`)
+
+在 `.vitepress/config.mts` 中，使用 `createWotVitePressConfig` 来包装你的 VitePress 配置。该工厂函数将自动注入主题所需的别名、SSR 处理和必要的 Vite/Markdown 插件。
+
+```typescript
+import { createWotVitePressConfig } from '@wot-ui/vitepress-theme/config'
+import { fileURLToPath, URL } from 'node:url'
+
+export default createWotVitePressConfig({
+  title: 'My Project',
+  description: '项目描述',
+  markdown: {
+    // 组件源码与 Demo 的链接追加
+    componentLinks: {
+      repoUrl: 'https://github.com/my-org/my-repo/tree/master',
+      demoSourceRoot: 'src/subPages',
+      componentSourceRoot: 'src/components',
+    },
+    // SCSS 变量解析插件配置
+    scssVars: {
+      componentScssRoot: fileURLToPath(new URL('../../src/components', import.meta.url)),
+      componentMap: {
+        // 自定义你的组件别名映射
+        table: ['my-table', 'my-table-column']
+      }
+    },
+    versionBadge: true, // 开启 `^(x.y.z)` 转换为 Badge 标签
+    virtualVersionData: {
+      docsRoot: fileURLToPath(new URL('../', import.meta.url))
+    }
+  },
+  features: {
+    // 是否开启大语言模型文档生成插件
+    llms: {
+      ignoreFiles: ['reward/*'],
+      domain: 'https://my-docs-domain.com'
+    },
+    compression: {} // 是否开启产物压缩
+  },
+  // 你原有的 VitePress 配置...
+  themeConfig: {
+    logo: '/logo.svg',
+    // nav, sidebar, locales ...
+  }
+})
+```
+
+### 2. 主题运行时入口 (`theme/index.ts`)
+
+在 `.vitepress/theme/index.ts` 中，使用 `createWotVitePressTheme` 创建并导出默认主题。可以在这里传入 UI 层面的业务数据（广告、赞助商、案例等）URL 列表。
+
+```typescript
+import { createWotVitePressTheme } from '@wot-ui/vitepress-theme'
+
+export default createWotVitePressTheme({
+  // 开启百度统计路由监听
+  analytics: {
+    trackBaiduRoute: true
+  },
+  // 移动端模拟器（右侧手机Iframe）配置
+  demoIframe: {
+    assetBase: '/wxqrcode' // 静态二维码图片前缀
+  },
+  // 以下是各业务组件的数据源配置
+  // 不传或传 false 则代表关闭该模块
+  banner: {
+    urls: ['https://api.example.com/banner.json']
+  },
+  sponsors: {
+    urls: ['https://api.example.com/sponsors.json']
+  },
+  ads: {
+    wwadsId: '372', // 万维广告 ID
+    urls: ['https://api.example.com/ads.json']
+  },
+  team: {
+    urls: ['https://api.example.com/team.json']
+  },
+  friendly: {
+    urls: ['https://api.example.com/friendly.json']
+  },
+  cases: {
+    urls: ['https://api.example.com/cases.json']
+  }
+})
+```
+
+### 3. 在 Markdown 中使用业务组件数据
+
+我们提供了一系列配套的 Vue Composables 供你在特定的 Markdown 页面（如赞助页、案例页）中渲染数据。直接从包名引入即可：
+
+```vue
+<script setup>
+import { useCaseData, useSponsor, useTeam, useFriendly } from '@wot-ui/vitepress-theme'
+
+const { data: cases } = useCaseData()
+const { data: sponsors } = useSponsor()
+</script>
+
+<div v-for="item in cases" :key="item.name">
+  {{ item.name }}
+</div>
+```
+
+## 配置项说明
+
+### Markdown 增强插件 (`markdown`)
+- `componentLinks`: 是否在组件文档末尾追加 `源代码 | 文档 | 组件` 的 GitHub 外部链接。传入 `false` 可关闭。
+- `scssVars`: 是否在组件文档的 `## 主题定制` 下方自动解析并渲染 SCSS 变量表。传入 `false` 可关闭。
+- `versionBadge`: 是否将 `^(1.2.3)` 文本自动转换为深色 `<Badge>` 标签。
+- `virtualVersionData`: 从文档中扫描版本变更，提供虚拟模块供组件侧边栏显示 `New` 或 `Update` 徽标。
+
+### 基础设施特性 (`features`)
+- `llms`: 通过 `@vitepress-plugin-llms` 生成用于大语言模型的文本产物（`llms.txt`）。
+- `compression`: 通过 `vite-plugin-compression` 生成 gzip 压缩文件。
+
+### 主题 UI 特性 (传给 `createWotVitePressTheme`)
+所有选项均遵循 `false | Options` 的形式。如果不传入或传入 `false`，相关 UI 模块将会自动隐藏。
+
+- `analytics.trackBaiduRoute`: 开启后，在路由变化时调用 `_hmt.push(['_trackPageview'])`。
+- `demoIframe`: 配置右侧手机模拟器相关选项。
+- `banner` / `sponsors` / `ads` / `team` / `friendly` / `cases`: 提供给对应功能模块的请求地址数组（支持多线路重试）。
+
+## 构建要求
+
+如果你需要修改本包的源码，请确保在根目录执行依赖安装。
+开发模式下，VitePress 站点直接引用本包的编译后产物（通过 `pnpm build` 或根目录统筹的 `pnpm dev:docs` 触发 `esbuild` 实时输出到 `dist`）。
+
+```bash
+pnpm --filter @wot-ui/vitepress-theme build
+```
+
+## 发版与发布规范
+
+`@wot-ui/vitepress-theme` 作为 Wot Design Uni 项目的官方周边共享包，它的版本号与主仓库 `wot-ui` 强绑定。
+
+1. **版本同步**：当你在根目录执行 `pnpm release-tag` 时，发版脚本会自动将最新的版本号同步写入 `packages/vitepress-theme/package.json`。
+2. **自动化构建发布**：我们已经在主仓库的 `.github/workflows/release.yml` 中集成了此主题包的自动构建与 npm 发布流。只要带有 `v*` 的 Tag 被推送到主分支，GitHub Action 会在发布 `wot-ui` 的同时，自动进入 `packages/vitepress-theme` 执行 `npm publish` 将最新版本的主题包发布至 npm 官方镜像。

package/dist/config.js

@@ -0,0 +1,118 @@
+import { defineConfig } from "vitepress";
+import viteCompression from "vite-plugin-compression";
+import llmstxt from "vitepress-plugin-llms";
+import { fileURLToPath, URL } from "node:url";
+import { mdScssVarsPlugin } from "./plugins/md-scss-vars.js";
+import { mdComponentLinksPlugin } from "./plugins/md-component-links.js";
+import { mdVersionBadgePlugin } from "./plugins/md-version-badge.js";
+import { virtualVersionDataPlugin } from "./plugins/virtual-version-data.js";
+function normalizeAlias(alias) {
+  if (!alias)
+    return [];
+  return Array.isArray(alias) ? alias : Object.entries(alias).map(([find, replacement]) => ({ find, replacement }));
+}
+function normalizePlugins(plugins) {
+  return (plugins ?? []).filter(Boolean);
+}
+function createLlmsPlugin(options) {
+  if (!options)
+    return null;
+  return llmstxt({
+    domain: options.domain,
+    ignoreFiles: options.ignoreFiles ?? []
+  });
+}
+function createCompressionPlugin(options) {
+  if (options === false)
+    return null;
+  return viteCompression({
+    verbose: true,
+    disable: false,
+    threshold: 10240,
+    algorithm: "gzip",
+    ext: ".gz",
+    ...options ?? {}
+  });
+}
+function createInternalAliases() {
+  return [
+    {
+      find: /^.*\/VPSidebar\.vue$/,
+      replacement: fileURLToPath(new URL("./theme/components/VPSidebar.vue", import.meta.url))
+    },
+    {
+      find: /^.*\/VPContent\.vue$/,
+      replacement: fileURLToPath(new URL("./theme/components/VPContent.vue", import.meta.url))
+    },
+    {
+      find: /^.*\/VPDoc\.vue$/,
+      replacement: fileURLToPath(new URL("./theme/components/VPDoc.vue", import.meta.url))
+    },
+    {
+      find: /^.*\/VPLocalNav\.vue$/,
+      replacement: fileURLToPath(new URL("./theme/components/VPLocalNav.vue", import.meta.url))
+    },
+    {
+      find: /^.*\/VPNavBar\.vue$/,
+      replacement: fileURLToPath(new URL("./theme/components/VPNavBar.vue", import.meta.url))
+    },
+    {
+      find: /^.*\/VPSidebarItem\.vue$/,
+      replacement: fileURLToPath(new URL("./theme/components/VPSidebarItem.vue", import.meta.url))
+    }
+  ];
+}
+function mergeNoExternal(existing) {
+  const merged = /* @__PURE__ */ new Set(["element-plus"]);
+  const noExternal = existing?.noExternal;
+  if (Array.isArray(noExternal)) {
+    noExternal.forEach((item) => {
+      if (typeof item === "string") {
+        merged.add(item);
+      }
+    });
+  }
+  return {
+    ...existing,
+    noExternal: Array.from(merged)
+  };
+}
+function createWotVitePressConfig(options) {
+  const userVite = options.vite ?? {};
+  const internalPlugins = [
+    createLlmsPlugin(options.features?.llms),
+    options.markdown.scssVars !== false ? mdScssVarsPlugin({
+      componentScssRoot: options.markdown.scssVars?.componentScssRoot ?? "",
+      componentMap: options.markdown.scssVars?.componentMap
+    }) : null,
+    options.markdown.componentLinks !== false ? mdComponentLinksPlugin({
+      repoUrl: options.markdown.componentLinks?.repoUrl ?? "",
+      demoSourceRoot: options.markdown.componentLinks?.demoSourceRoot ?? "",
+      componentSourceRoot: options.markdown.componentLinks?.componentSourceRoot ?? ""
+    }) : null,
+    options.markdown.versionBadge !== false ? mdVersionBadgePlugin() : null,
+    options.markdown.virtualVersionData !== false ? virtualVersionDataPlugin({
+      docsRoot: options.markdown.virtualVersionData?.docsRoot
+    }) : null,
+    createCompressionPlugin(options.features?.compression)
+  ].filter(Boolean);
+  return defineConfig({
+    title: options.title,
+    description: options.description,
+    head: options.head,
+    locales: options.locales,
+    themeConfig: options.themeConfig,
+    vite: {
+      ...userVite,
+      plugins: [...internalPlugins, ...normalizePlugins(userVite.plugins)],
+      ssr: mergeNoExternal(userVite.ssr),
+      resolve: {
+        ...userVite.resolve,
+        alias: [...createInternalAliases(), ...normalizeAlias(userVite.resolve?.alias)]
+      }
+    }
+  });
+}
+export {
+  createWotVitePressConfig
+};

package/dist/index.js

@@ -0,0 +1,68 @@
+import DefaultTheme, { VPBadge } from "vitepress/theme";
+import ElementPlus from "element-plus";
+import "element-plus/dist/index.css";
+import "element-plus/theme-chalk/dark/css-vars.css";
+import Layout from "./theme/Layout.vue";
+import ExternalLink from "./theme/components/ExternalLink.vue";
+import SvgImage from "./theme/components/SvgImage.vue";
+import { wotThemeOptionsKey } from "./theme/options.js";
+import "./theme/styles/vars.css";
+import "./theme/styles/custom.css";
+function resolveThemeOptions(options = {}) {
+  return {
+    analytics: {
+      trackBaiduRoute: options.analytics !== false && options.analytics?.trackBaiduRoute !== false
+    },
+    banner: options.banner ?? false,
+    sponsors: options.sponsors ?? false,
+    ads: options.ads ?? false,
+    team: options.team ?? false,
+    friendly: options.friendly ?? false,
+    cases: options.cases ?? false,
+    demoIframe: options.demoIframe ?? false
+  };
+}
+function enhanceAppWithOptions(ctx, options) {
+  const { app, router } = ctx;
+  app.component("SvgImage", SvgImage);
+  app.component("ExternalLink", ExternalLink);
+  app.component("Badge", VPBadge);
+  app.use(ElementPlus);
+  app.provide(wotThemeOptionsKey, options);
+  if (!options.analytics.trackBaiduRoute || typeof window === "undefined") {
+    return;
+  }
+  const trackPageView = (path) => {
+    if (window._hmt) {
+      window._hmt.push(["_trackPageview", path]);
+    }
+  };
+  router.onAfterRouteChange = (to) => {
+    setTimeout(() => {
+      trackPageView(to);
+    }, 100);
+  };
+}
+function createWotVitePressTheme(options = {}) {
+  const resolvedOptions = resolveThemeOptions(options);
+  return {
+    extends: DefaultTheme,
+    Layout,
+    enhanceApp(ctx) {
+      enhanceAppWithOptions(ctx, resolvedOptions);
+    }
+  };
+}
+const theme = createWotVitePressTheme();
+var src_default = theme;
+export * from "./types.js";
+export * from "./theme/composables/team.js";
+export * from "./theme/composables/sponsor.js";
+export * from "./theme/composables/adsData.js";
+export * from "./theme/composables/banner.js";
+export * from "./theme/composables/cases.js";
+export * from "./theme/composables/friendly.js";
+export {
+  createWotVitePressTheme,
+  src_default as default
+};

package/dist/locales/md-component-links.js

@@ -0,0 +1,15 @@
+var md_component_links_default = {
+  "zh-CN": {
+    sourceCode: "\u6E90\u4EE3\u7801",
+    document: "\u6587\u6863",
+    component: "\u7EC4\u4EF6"
+  },
+  "en-US": {
+    sourceCode: "Source Code",
+    document: "Documentation",
+    component: "Component"
+  }
+};
+export {
+  md_component_links_default as default
+};

package/dist/plugins/md-component-links.js

@@ -0,0 +1,34 @@
+import path from "path";
+import i18n from "../locales/md-component-links.js";
+function kebabToCamelCase(value) {
+  return value.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+function mdComponentLinksPlugin(options) {
+  return {
+    name: "md-component-links",
+    enforce: "pre",
+    async transform(code, id) {
+      if (!id.endsWith(".md"))
+        return;
+      if (!id.includes("/component"))
+        return;
+      if (id.includes("/use-"))
+        return;
+      const componentId = path.basename(id, ".md");
+      const componentName = `wd-${componentId}`;
+      const camelComponentId = kebabToCamelCase(componentId);
+      const demoUrl = `${options.repoUrl.replace(/\/$/, "")}/${options.demoSourceRoot.replace(/^\/+/, "").replace(/\/$/, "")}/${camelComponentId}`;
+      const componentUrl = `${options.repoUrl.replace(/\/$/, "")}/${options.componentSourceRoot.replace(/^\/+/, "").replace(/\/$/, "")}/${componentName}`;
+      const lang = id.includes("/en-US/") ? "en-US" : "zh-CN";
+      const { sourceCode, document, component } = i18n[lang];
+      return {
+        code: `${code}
+## ${sourceCode}
+<ExternalLink href=${demoUrl}>${document}</ExternalLink> \u2022 <ExternalLink href=${componentUrl}>${component}</ExternalLink>`
+      };
+    }
+  };
+}
+export {
+  mdComponentLinksPlugin
+};

package/dist/plugins/md-scss-vars.js

@@ -0,0 +1,73 @@
+import fs from "fs";
+import path from "path";
+const COMPONENT_MAP = {
+  table: ["wd-table", "wd-table-column"],
+  radio: ["wd-radio", "wd-radio-group"],
+  checkbox: ["wd-checkbox", "wd-checkbox-group"],
+  collapse: ["wd-collapse", "wd-collapse-item"],
+  "swipe-action": ["wd-swipe-action", "wd-swipe-action-item"],
+  grid: ["wd-grid", "wd-grid-item"],
+  tabs: ["wd-tabs", "wd-tab"],
+  steps: ["wd-steps", "wd-step"],
+  sidebar: ["wd-sidebar", "wd-sidebar-item"],
+  "index-bar": ["wd-index-bar", "wd-index-anchor"],
+  form: ["wd-form", "wd-form-item"]
+};
+function parseScssVariables(scssContent) {
+  const SCSS_VAR_REGEX = /(?:\/\/\s*(.*)\n)?\$([a-zA-Z0-9-]+):\s*var\(--wot-([a-zA-Z0-9-]+),\s*(.+)\)(?:\s*!default)?\s*;/g;
+  const variables = [];
+  let match;
+  while ((match = SCSS_VAR_REGEX.exec(scssContent)) !== null) {
+    variables.push({
+      desc: match[1] ? match[1].trim() : "-",
+      name: `--wot-${match[3]}`,
+      defaultValue: match[4].trim()
+    });
+  }
+  return variables;
+}
+function mdScssVarsPlugin(options) {
+  const componentMap = options.componentMap || COMPONENT_MAP;
+  return {
+    name: "md-scss-vars",
+    enforce: "pre",
+    async transform(code, id) {
+      if (!id.endsWith(".md"))
+        return;
+      if (!id.includes("/component/"))
+        return;
+      if (id.includes("/use-"))
+        return;
+      const componentId = path.basename(id, ".md");
+      const targetComponents = componentMap[componentId] || [`wd-${componentId}`];
+      let allVariables = [];
+      for (const comp of targetComponents) {
+        const scssPath = path.resolve(options.componentScssRoot, comp, "index.scss");
+        if (fs.existsSync(scssPath)) {
+          const scssContent = fs.readFileSync(scssPath, "utf8");
+          const vars = parseScssVariables(scssContent);
+          allVariables = allVariables.concat(vars);
+        }
+      }
+      if (allVariables.length === 0) {
+        return { code };
+      }
+      let tableMd = "\n## \u4E3B\u9898\u5B9A\u5236\n\n### CSS \u53D8\u91CF\n\n\u7EC4\u4EF6\u63D0\u4F9B\u4E86\u4E0B\u5217 CSS \u53D8\u91CF\uFF0C\u53EF\u7528\u4E8E\u81EA\u5B9A\u4E49\u6837\u5F0F\uFF0C\u4F7F\u7528\u65B9\u6CD5\u8BF7\u53C2\u8003 [ConfigProvider \u5168\u5C40\u914D\u7F6E](/component/config-provider)\u3002\n\n| \u540D\u79F0 | \u9ED8\u8BA4\u503C | \u63CF\u8FF0 |\n| --- | --- | --- |\n";
+      for (const v of allVariables) {
+        tableMd += `| ${v.name} | ${v.defaultValue} | ${v.desc} |
+`;
+      }
+      const themeSectionRegex = /\n*##\s+主题定制[\s\S]*?(?=\n##\s+|$)/;
+      let newCode = code;
+      if (themeSectionRegex.test(code)) {
+        newCode = code.replace(themeSectionRegex, tableMd);
+      } else {
+        newCode = `${code}${tableMd}`;
+      }
+      return { code: newCode };
+    }
+  };
+}
+export {
+  mdScssVarsPlugin
+};

package/dist/plugins/md-version-badge.js

@@ -0,0 +1,51 @@
+const VERSION_MARK_RE = /\^\((\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?)\)/g;
+const INLINE_CODE_RE = /`[^`]*`/g;
+function replaceVersionMarkerOutsideInlineCode(line) {
+  const ranges = [];
+  for (const match of line.matchAll(INLINE_CODE_RE)) {
+    ranges.push({
+      start: match.index || 0,
+      end: (match.index || 0) + match[0].length
+    });
+  }
+  return line.replace(VERSION_MARK_RE, (full, version, offset) => {
+    const insideInlineCode = ranges.some((range) => offset >= range.start && offset < range.end);
+    if (insideInlineCode)
+      return full;
+    return `<Badge type="tip" text="v${version}" />`;
+  });
+}
+function mdVersionBadgePlugin() {
+  return {
+    name: "md-version-badge",
+    enforce: "pre",
+    async transform(code, id) {
+      if (!id.endsWith(".md"))
+        return;
+      if (!id.includes("/docs/"))
+        return;
+      if (!/\^\([^)]+\)/.test(code))
+        return;
+      const lines = code.split("\n");
+      let inFence = false;
+      const transformed = lines.map((line) => {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("```")) {
+          inFence = !inFence;
+          return line;
+        }
+        if (inFence)
+          return line;
+        if (line.includes("<Badge"))
+          return line;
+        return replaceVersionMarkerOutsideInlineCode(line);
+      });
+      return {
+        code: transformed.join("\n")
+      };
+    }
+  };
+}
+export {
+  mdVersionBadgePlugin
+};

package/dist/plugins/virtual-version-data.js

@@ -0,0 +1,83 @@
+import { readFileSync, existsSync, readdirSync, statSync } from "fs";
+import { resolve, relative, sep } from "path";
+const VERSION_DATA_ID = "virtual:wot-vitepress-theme/version-data";
+const RESOLVED_VERSION_DATA_ID = "\0virtual:wot-vitepress-theme/version-data";
+function extractVersionFromMarkdown(filePath) {
+  if (!existsSync(filePath))
+    return null;
+  try {
+    const content = readFileSync(filePath, "utf-8");
+    const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
+    if (frontmatterMatch) {
+      const frontmatter = frontmatterMatch[1];
+      const versionMatch = frontmatter.match(/version:\s*(['"]?)([^'"\n]+)\1/);
+      if (versionMatch) {
+        return versionMatch[2].trim();
+      }
+    }
+  } catch (e) {
+    console.warn(`Failed to read file ${filePath}:`, e);
+  }
+  return null;
+}
+function scanAllVersions(docsRoot) {
+  const versionData = {};
+  const docsDir = resolve(docsRoot);
+  if (!existsSync(docsDir)) {
+    console.warn("Docs directory not found:", docsDir);
+    return versionData;
+  }
+  function traverse(currentDir) {
+    try {
+      const files = readdirSync(currentDir);
+      files.forEach((file) => {
+        if (file.startsWith(".") || file === "public" || file === "node_modules")
+          return;
+        const fullPath = resolve(currentDir, file);
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+          traverse(fullPath);
+        } else if (file.endsWith(".md")) {
+          const version = extractVersionFromMarkdown(fullPath);
+          if (version) {
+            const relPath = relative(docsDir, fullPath);
+            const normalizedPath = "/" + relPath.split(sep).join("/").replace(/\.md$/, "");
+            versionData[normalizedPath] = version;
+            console.log(`\u2705 Found version info in ${normalizedPath}:`, version);
+          }
+        }
+      });
+    } catch (e) {
+      console.warn(`Failed to scan directory ${currentDir}:`, e);
+    }
+  }
+  traverse(docsDir);
+  return versionData;
+}
+function virtualVersionDataPlugin(options = {}) {
+  let versionData = {};
+  return {
+    name: "virtual-version-data",
+    resolveId(id) {
+      if (id === VERSION_DATA_ID) {
+        return RESOLVED_VERSION_DATA_ID;
+      }
+    },
+    load(id) {
+      if (id === RESOLVED_VERSION_DATA_ID) {
+        return `export const versionData = ${JSON.stringify(versionData, null, 2)}`;
+      }
+    },
+    configResolved() {
+      try {
+        versionData = scanAllVersions(options.docsRoot ?? process.cwd());
+        console.log("\u2705 Version data generated successfully");
+      } catch (e) {
+        console.error("\u274C Failed to generate version data:", e);
+      }
+    }
+  };
+}
+export {
+  virtualVersionDataPlugin
+};

package/dist/src/config.d.ts

@@ -0,0 +1,3 @@
+import type { WotVitePressConfigOptions } from './types.js';
+export declare function createWotVitePressConfig(options: WotVitePressConfigOptions): import("vitepress").UserConfig<NoInfer<import("vitepress").DefaultTheme.Config>>;
+export type { WotVitePressConfigOptions } from './types.js';

package/dist/src/index.d.ts

@@ -0,0 +1,21 @@
+import type { Theme } from 'vitepress';
+import 'element-plus/dist/index.css';
+import 'element-plus/theme-chalk/dark/css-vars.css';
+import type { WotVitePressThemeOptions } from './types.js';
+import './theme/styles/vars.css';
+import './theme/styles/custom.css';
+declare global {
+    interface Window {
+        _hmt: any[];
+    }
+}
+export declare function createWotVitePressTheme(options?: WotVitePressThemeOptions): Theme;
+declare const theme: Theme;
+export default theme;
+export * from './types';
+export * from './theme/composables/team.js';
+export * from './theme/composables/sponsor.js';
+export * from './theme/composables/adsData.js';
+export * from './theme/composables/banner.js';
+export * from './theme/composables/cases.js';
+export * from './theme/composables/friendly.js';

package/dist/src/locales/md-component-links.d.ts

@@ -0,0 +1,13 @@
+declare const _default: {
+    'zh-CN': {
+        sourceCode: string;
+        document: string;
+        component: string;
+    };
+    'en-US': {
+        sourceCode: string;
+        document: string;
+        component: string;
+    };
+};
+export default _default;

package/dist/src/plugins/md-component-links.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from 'vite';
+import type { WotMdComponentLinksOptions } from '../types.js';
+export declare function mdComponentLinksPlugin(options: WotMdComponentLinksOptions): Plugin;

package/dist/src/plugins/md-scss-vars.d.ts

@@ -0,0 +1,3 @@
+import { type Plugin } from 'vite';
+import type { WotMdScssVarsOptions } from '../types.js';
+export declare function mdScssVarsPlugin(options: WotMdScssVarsOptions): Plugin;

package/dist/src/plugins/md-version-badge.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 将 docs 目录下 Markdown 中形如 ^(1.2.3) 的版本标记转换为 VitePress Badge 组件。
+ * 仅处理普通文本内容，跳过代码块、行内代码，以及已经手写了 <Badge> 的行。
+ */
+import { type Plugin } from 'vite';
+export declare function mdVersionBadgePlugin(): Plugin;

package/dist/src/plugins/virtual-version-data.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from 'vite';
+import type { WotVirtualVersionDataOptions } from '../types.js';
+export declare function virtualVersionDataPlugin(options?: WotVirtualVersionDataOptions): Plugin;