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

package/dist/src/theme/composables/adSponsor.d.ts

@@ -0,0 +1,30 @@
+export type GridSize = 'xmini' | 'mini' | 'small' | 'medium' | 'big';
+export interface Sponsor {
+    name: string;
+    img: string;
+    url: string;
+}
+export interface Sponsors {
+    tier?: string;
+    size?: GridSize;
+    items: Sponsor[];
+}
+export declare function useAdSponsor(): {
+    data: import("vue").Ref<{
+        tier?: string;
+        size?: GridSize;
+        items: {
+            name: string;
+            img: string;
+            url: string;
+        }[];
+    }[], Sponsors[] | {
+        tier?: string;
+        size?: GridSize;
+        items: {
+            name: string;
+            img: string;
+            url: string;
+        }[];
+    }[]>;
+};

package/dist/src/theme/composables/adsData.d.ts

@@ -0,0 +1,16 @@
+export type AdData = {
+    image: string;
+    title?: string;
+    link?: string;
+};
+export declare function useAds(): {
+    data: import("vue").Ref<{
+        image: string;
+        title?: string;
+        link?: string;
+    }[], AdData[] | {
+        image: string;
+        title?: string;
+        link?: string;
+    }[]>;
+};

package/dist/src/theme/composables/banner.d.ts

@@ -0,0 +1,16 @@
+export type BannerData = {
+    action: string;
+    title: string;
+    link: string;
+};
+export declare function useBanner(): {
+    data: import("vue").Ref<{
+        action: string;
+        title: string;
+        link: string;
+    }[], BannerData[] | {
+        action: string;
+        title: string;
+        link: string;
+    }[]>;
+};

package/dist/src/theme/composables/cases.d.ts

@@ -0,0 +1,16 @@
+export type CaseData = {
+    name: string;
+    image: string;
+    description?: string;
+};
+export declare function useCaseData(): {
+    data: import("vue").Ref<{
+        name: string;
+        image: string;
+        description?: string;
+    }[], CaseData[] | {
+        name: string;
+        image: string;
+        description?: string;
+    }[]>;
+};

package/dist/src/theme/composables/friendly.d.ts

@@ -0,0 +1,19 @@
+export type FriendlyLink = {
+    icon: string;
+    title: string;
+    details: string;
+    link: string;
+};
+export declare function useFriendly(): {
+    data: import("vue").Ref<{
+        icon: string;
+        title: string;
+        details: string;
+        link: string;
+    }[], FriendlyLink[] | {
+        icon: string;
+        title: string;
+        details: string;
+        link: string;
+    }[]>;
+};

package/dist/src/theme/composables/sponsor.d.ts

@@ -0,0 +1,3 @@
+export declare function useSponsor(): {
+    data: import("vue").Ref<any, any>;
+};

package/dist/src/theme/composables/team.d.ts

@@ -0,0 +1,28 @@
+export type TeamMember = {
+    avatar: string;
+    name: string;
+    title: string;
+    tags?: string[];
+    desc?: string;
+    github?: string;
+    twitter?: string;
+};
+export declare function useTeam(): {
+    data: import("vue").Ref<{
+        avatar: string;
+        name: string;
+        title: string;
+        tags?: string[];
+        desc?: string;
+        github?: string;
+        twitter?: string;
+    }[], TeamMember[] | {
+        avatar: string;
+        name: string;
+        title: string;
+        tags?: string[];
+        desc?: string;
+        github?: string;
+        twitter?: string;
+    }[]>;
+};

package/dist/src/theme/options.d.ts

@@ -0,0 +1,3 @@
+import type { InjectionKey } from 'vue';
+import type { WotResolvedThemeOptions } from '../types';
+export declare const wotThemeOptionsKey: InjectionKey<WotResolvedThemeOptions>;

package/dist/src/types.d.ts

@@ -0,0 +1,86 @@
+import type { DefaultTheme, HeadConfig, UserConfig } from 'vitepress';
+import type { PluginOption } from 'vite';
+export interface WotThemeAnalyticsOptions {
+    trackBaiduRoute?: boolean;
+}
+export interface WotThemeBannerOptions {
+    urls: string[];
+}
+export interface WotThemeSponsorOptions {
+    urls: string[];
+}
+export interface WotThemeAdsOptions {
+    wwadsId?: string;
+    urls?: string[];
+}
+export interface WotThemeTeamOptions {
+    urls: string[];
+}
+export interface WotThemeFriendlyOptions {
+    urls: string[];
+}
+export interface WotThemeCasesOptions {
+    urls: string[];
+}
+export interface WotThemeDemoIframeOptions {
+    assetBase?: string;
+}
+export interface WotVitePressThemeOptions {
+    analytics?: false | WotThemeAnalyticsOptions;
+    banner?: false | WotThemeBannerOptions;
+    sponsors?: false | WotThemeSponsorOptions;
+    ads?: false | WotThemeAdsOptions;
+    team?: false | WotThemeTeamOptions;
+    friendly?: false | WotThemeFriendlyOptions;
+    cases?: false | WotThemeCasesOptions;
+    demoIframe?: false | WotThemeDemoIframeOptions;
+}
+export interface WotLlmsFeatureOptions {
+    domain: string;
+    ignoreFiles?: string[];
+}
+export interface WotMdComponentLinksOptions {
+    repoUrl: string;
+    demoSourceRoot: string;
+    componentSourceRoot: string;
+}
+export interface WotMdScssVarsOptions {
+    componentScssRoot: string;
+    componentMap?: Record<string, string[]>;
+}
+export interface WotVirtualVersionDataOptions {
+    docsRoot?: string;
+}
+export interface WotMarkdownSourceOptions {
+    componentLinks?: false | WotMdComponentLinksOptions;
+    scssVars?: false | WotMdScssVarsOptions;
+    versionBadge?: boolean;
+    virtualVersionData?: false | WotVirtualVersionDataOptions;
+}
+export interface WotVitePressFeatureOptions {
+    llms?: false | WotLlmsFeatureOptions;
+    compression?: false | Record<string, unknown>;
+}
+export interface WotVitePressConfigOptions {
+    title: string;
+    description: string;
+    head?: HeadConfig[];
+    locales?: UserConfig['locales'];
+    themeConfig?: DefaultTheme.Config;
+    vite?: UserConfig['vite'];
+    markdown: WotMarkdownSourceOptions;
+    features?: WotVitePressFeatureOptions;
+}
+export interface WotResolvedThemeOptions {
+    analytics: {
+        trackBaiduRoute: boolean;
+    };
+    banner: false | WotThemeBannerOptions;
+    sponsors: false | WotThemeSponsorOptions;
+    ads: false | WotThemeAdsOptions;
+    team: false | WotThemeTeamOptions;
+    friendly: false | WotThemeFriendlyOptions;
+    cases: false | WotThemeCasesOptions;
+    demoIframe: false | WotThemeDemoIframeOptions;
+}
+export type WotVitePlugin = Exclude<PluginOption, null | false | undefined>;

package/dist/theme/Layout.vue

@@ -0,0 +1,45 @@
+<script setup lang="ts">
+import DefaultTheme from 'vitepress/theme'
+import Banner from './components/Banner.vue'
+import SpecialSponsor from './components/SpecialSponsor.vue'
+import HomeFriendly from './components/HomeFriendly.vue'
+import HomeTeam from './components/HomeTeam.vue'
+import CustomFooter from './components/CustomFooter.vue'
+import WwAds from './components/WwAds.vue'
+
+const { Layout } = DefaultTheme
+</script>
+
+<template>
+  <Layout>
+    <!-- 全局顶部横幅（Banner 通知条） -->
+    <template #layout-top>
+      <Banner />
+    </template>
+
+    <!-- 首页 Hero 区域下方，展示特别赞助商 -->
+    <template #home-hero-after>
+      <SpecialSponsor />
+    </template>
+
+    <!-- 首页 Features 区域下方，展示团队成员、用户案例与友好链接 -->
+    <template #home-features-after>
+      <HomeTeam />
+      <!-- <HomeCases /> -->
+      <HomeFriendly />
+    </template>
+
+    <!-- 导航栏 Logo 右侧，品牌标题后缀 -->
+    <template #nav-bar-title-after></template>
+
+    <!-- 文档页侧边栏大纲下方，展示广告位 -->
+    <template #aside-outline-after>
+      <WwAds />
+    </template>
+
+    <!-- 全局底部页脚 -->
+    <template #layout-bottom>
+      <CustomFooter />
+    </template>
+  </Layout>
+</template>

package/dist/theme/components/AsideSponsors.vue

@@ -0,0 +1,105 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import { useAdSponsor } from '../composables/adSponsor'
+
+const { data } = useAdSponsor()
+
+// 分离超级赞助和金牌赞助
+const superSponsors = computed(() => {
+  return data.value?.find((sponsor) => sponsor.tier === 'Platinum')
+})
+
+const goldSponsors = computed(() => {
+  return data.value?.find((sponsor) => sponsor.tier === 'Gold')
+})
+
+// 判断金牌赞助数量是否为奇数
+const isGoldSponsorsOdd = computed(() => {
+  return (goldSponsors.value?.items?.length || 0) % 2 === 1
+})
+</script>
+
+<template>
+  <div class="VPDocAsideSponsors">
+    <a class="sponsors-aside-text" href="/reward/sponsor">赞助位</a>
+    <div class="VPSponsors vp-sponsor aside">
+      <!-- 超级赞助：一行一个 -->
+      <section class="vp-sponsor-section" v-if="superSponsors?.items.length">
+        <div class="VPSponsorsGrid vp-sponsor-grid mini" data-vp-grid="1">
+          <div class="vp-sponsor-grid-item" v-for="sponsor in superSponsors.items" :key="sponsor.name">
+            <a class="vp-sponsor-grid-link" :href="sponsor.url" target="_blank" rel="sponsored noopener">
+              <article class="vp-sponsor-grid-box">
+                <h4 class="visually-hidden">{{ sponsor.url }}</h4>
+                <img v-if="sponsor.img" class="vp-sponsor-grid-image" :src="sponsor.img" :alt="sponsor.name" />
+                <span v-else class="vp-sponsor-grid-text">{{ sponsor.name }}</span>
+              </article>
+            </a>
+          </div>
+        </div>
+      </section>
+
+      <!-- 金牌赞助：一行两个 -->
+      <section class="vp-sponsor-section" v-if="goldSponsors?.items.length">
+        <div class="VPSponsorsGrid vp-sponsor-grid xmini" data-vp-grid="2">
+          <div class="vp-sponsor-grid-item" v-for="sponsor in goldSponsors.items" :key="sponsor.name">
+            <a class="vp-sponsor-grid-link" :href="sponsor.url" target="_blank" rel="sponsored noopener">
+              <article class="vp-sponsor-grid-box">
+                <h4 class="visually-hidden">{{ sponsor.name }}</h4>
+                <img v-if="sponsor.img" class="vp-sponsor-grid-image" :src="sponsor.img" :alt="sponsor.name" />
+                <span v-else class="vp-sponsor-grid-text">{{ sponsor.name }}</span>
+              </article>
+            </a>
+          </div>
+          <!-- 当金牌赞助为奇数时，默认赞助位填补到金牌赞助位置 -->
+          <div class="vp-sponsor-grid-item" v-if="isGoldSponsorsOdd">
+            <a class="vp-sponsor-grid-link" href="/reward/sponsor" rel="sponsored noopener">
+              <article class="vp-sponsor-grid-box">
+                <span class="vp-sponsor-grid-text">成为赞助商</span>
+              </article>
+            </a>
+          </div>
+        </div>
+      </section>
+
+      <!-- 当金牌赞助为偶数或没有金牌赞助时，默认赞助位占据一整行 -->
+      <section class="vp-sponsor-section" v-if="!isGoldSponsorsOdd || !goldSponsors?.items.length">
+        <div class="VPSponsorsGrid vp-sponsor-grid xmini" data-vp-grid="1">
+          <div class="vp-sponsor-grid-item">
+            <a class="vp-sponsor-grid-link" href="/reward/sponsor" rel="sponsored noopener">
+              <article class="vp-sponsor-grid-box">
+                <span class="vp-sponsor-grid-text">成为赞助商</span>
+              </article>
+            </a>
+          </div>
+        </div>
+      </section>
+    </div>
+  </div>
+</template>
+
+<style>
+.vp-sponsor-grid-text {
+  color: var(--vp-c-text-2);
+  font-size: 12px;
+}
+
+.dark .vp-sponsor-grid-text {
+  color: var(--vp-c-gray-1);
+}
+
+.vp-sponsor-grid-image {
+  max-width: 120px;
+  max-height: 72px !important;
+  filter: none !important;
+}
+
+a.sponsors-aside-text {
+  color: var(--vp-c-text-3);
+  display: block;
+  margin: 2em 0 1em;
+  font-weight: 700;
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 0.4px;
+}
+</style>