valaxy-theme-yun 0.28.9 → 0.28.11

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "valaxy-theme-yun",
   "type": "module",
-  "version": "0.28.9",
+  "version": "0.28.11",
+  "description": "Default theme (Yun) for Valaxy — a Vite & Vue powered static blog generator",
   "author": {
     "email": "me@yunyoujun.cn",
     "name": "YunYouJun",
@@ -11,8 +12,15 @@
   "homepage": "https://yun.valaxy.site",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/YunYouJun/valaxy/tree/main/packages/valaxy-theme-yun.git"
+    "url": "git+https://github.com/YunYouJun/valaxy.git",
+    "directory": "packages/valaxy-theme-yun"
   },
+  "keywords": [
+    "valaxy",
+    "valaxy-theme",
+    "theme",
+    "blog"
+  ],
   "exports": {
     "./client": "./client/index.ts",
     "./theme": "./types/index.d.ts",
@@ -33,8 +41,8 @@
   },
   "devDependencies": {
     "@types/animejs": "^3.1.13",
-    "valaxy-addon-waline": "0.2.1",
-    "valaxy": "0.28.9"
+    "valaxy": "0.28.11",
+    "valaxy-addon-waline": "0.2.1"
   },
   "scripts": {
     "release": "bumpp && pnpm publish"

package/.codebuddy/memory/2026-03-17.md

@@ -1,21 +0,0 @@
-# 2026-03-17
-
-## 修复：从 post 返回首页时 prologue 和 banner 动画同时播放
-
-**问题**：从文章页返回首页时，prologue 和 banner 动画同时播放，而不是 banner 先播完再播 prologue。
-
-**根因**：`bannerAnimationDone` 是 Pinia store 中的 `ref(false)`（单例），首次进入首页后被设为 `true`。SPA 导航回首页时 `YunBanner` 重新挂载，但 store 中 `bannerAnimationDone` 仍为 `true`，导致 `home.vue` 的 `v-if` 条件立即满足，prologue 直接渲染。
-
-**修复**：在 `YunBanner.vue` 的 `onMounted` 开始时重置 `yun.bannerAnimationDone = false`，确保每次 banner 组件挂载时动画序列从头开始。
-
-**改动文件**：`packages/valaxy-theme-yun/components/YunBanner.vue`
-
-## 修复：E2E banner 测试在 nimbo 模式下失败
-
-**问题**：`e2e/theme-yun/index.spec.ts` 中的 banner 测试 `.char-box` 断言超时（expected 6, received 0）。
-
-**根因**：nimbo 模式下 `YunBannerCharContainer` 是短暂存在的（~1s 后 animationStatus 从 'banner' 变为 'prologue' 时被移除）。原测试 `waitForSelector('#yun-banner')` 只等待容器出现，但 `.char-box` 可能在 ClientOnly hydration 延迟 + 动画窗口结束后已被移除。
-
-**修复**：将 `waitForSelector('#yun-banner')` 改为 `waitForSelector('.char-box', { timeout: 15000 })`，直接等待断言目标元素出现。
-
-**改动文件**：`e2e/theme-yun/index.spec.ts`

package/bump.config.ts

@@ -1,7 +0,0 @@
-import { defineConfig } from 'bumpp'
-
-export default defineConfig({
-  commit: false,
-  tag: false,
-  push: false,
-})

package/docs/README.md

@@ -1,5 +0,0 @@
-# Docs for valaxy-theme-yun
-
-📖 Full documentation: [valaxy.site/themes/yun](https://valaxy.site/themes/yun)
-
-[English](./en-US/) | [中文](./zh-CN/)

package/docs/en-US/README.md

@@ -1,3 +0,0 @@
-# valaxy-theme-yun Docs
-
-📖 Full documentation: [valaxy.site/themes/yun](https://valaxy.site/themes/yun)

package/docs/zh-CN/README.md

@@ -1,15 +0,0 @@
-# valaxy-theme-yun 文档
-
-📖 完整文档请参见：[valaxy.site/themes/yun](https://valaxy.site/themes/yun)
-
-## 配置
-
-### 主题配置
-
-主题特殊配制请参见 [主题配置](./config.md)。
-
-### 通用配置
-
-如「作者头像」、「站点名称」等属于通用信息，请在 `site.config.ts` 中配置。
-
-可参见 [Site Config | Valaxy Docs](https://valaxy.site/guide/config/#site-config)。

package/docs/zh-CN/config.md

@@ -1,140 +0,0 @@
----
-title: 主题配置
----
-
-> 📖 完整文档请参见：[valaxy.site/themes/yun](https://valaxy.site/themes/yun)
-
-配置 `valaxy.config.ts` 中的 `themeConfig` 字段，类型可直接参考 [valaxy-theme-yun/types/index.d.ts](https://github.com/YunYouJun/valaxy/blob/main/packages/valaxy-theme-yun/types/index.d.ts)。
-
-如您需要更详细的描述/示例，再阅读下方内容。
-
-## 主题类型 {#theme-type}
-
-Yun 主题支持两种布局类型，通过 `themeConfig.type` 进行切换。
-
-- `nimbo`（雨云）：默认布局。顶部导航栏 + 首页 Banner 动画 + 全屏菜单（移动端）。
-- `strato`（层云）：经典布局。左侧边栏 + 顶部导航栏，类似传统博客风格。
-
-```ts
-import type { ThemeConfig } from 'valaxy-theme-yun'
-import { defineConfig } from 'valaxy'
-
-export default defineConfig<ThemeConfig>({
-  theme: 'yun',
-
-  themeConfig: {
-    // 'nimbo'（默认）或 'strato'
-    type: 'strato',
-  }
-})
-```
-
-::: tip
-`strato` 对应 v1 版本的布局风格，`nimbo` 对应 v2 版本的布局风格。
-
-在未来，Yun 主题的不同布局变更将以不同云的名称命名（如 cirro 卷云、cumulo 积云等）。
-:::
-
-## 首页
-
-### 标语动画
-
-首页的垂直交错排列文字效果。默认开启。
-
-- `enable`: 是否开启
-- `title`: 设置文字内容
-- `cloud`: 在首页下方显示流动的云
-  - `enable`: 是否开启
-
-```ts
-import type { ThemeConfig } from 'valaxy-theme-yun'
-import { defineConfig } from 'valaxy'
-
-export default defineConfig<ThemeConfig>({
-  theme: 'yun',
-
-  themeConfig: {
-    banner: {
-      enable: true,
-      title: '云游君的小站',
-      // 手动分割
-      // title: ['云游君的', '小站'],
-    },
-  }
-})
-```
-
-> 如果您想要更改云的色彩，请更改 `var(--yun-c-cloud)` 的值
-
-```scss
-// 新建 styles/vars.css 文件
-:root {
-  --yun-c-cloud: red;
-}
-```
-
-新建 `styles/index.ts` 文件，引入 `vars.css`。
-
-```ts
-import './vars.css'
-```
-
-## 自定义友情链接
-
-新建 `pages/links/index.md` 文件。
-
-您可以在 `frontmatter` 编写链接信息。
-
-- `links`: 友情链接信息（可以是 YAML 数组形式，也可以是一个 JSON 文件链接）
-- `random`: 是否随机展示
-- `errorImg`: 图片加载失败时的图片链接
-
-譬如：
-
-```md
----
-title: 我的小伙伴们
-keywords: 链接
-description: 云游的小伙伴们
-links:
-  - url: https://www.yunyoujun.cn
-    avatar: https://www.yunyoujun.cn/images/avatar.jpg
-    name: 云游君
-    blog: 云游君的小站
-    desc: 希望能成为一个有趣的人。
-    email: me@yunyoujun.cn
-    color: "#0078e7"
-  - url: https://valaxy.site
-    avatar: https://valaxy.site/favicon.svg
-    name: Valaxy Org
-    blog: Valaxy Site
-    desc: 下一代静态博客框架
-    email: i@valaxy.site
-    color: "#6058d9"
-# 也可以是一个 JSON 链接
-# links: https://friends.yunyoujun.cn/links.json
-random: true
----
-
-<YunLinks :links="frontmatter.links" :random="frontmatter.random" errorImg="https://cdn.yunyoujun.cn/img/avatar/none.jpg" />
-```
-
-## 样式
-
-### 覆盖背景、侧边栏图片
-
-您可以新建样式文件并引入，以覆盖默认 CSS 变量。
-
-```ts [styles/index.ts]
-import './vars.scss'
-```
-
-```scss
-// styles/vars.scss
-:root {
-  /* 背景图片 */
-  --yun-bg-img: url("https://cdn.yunyoujun.cn/img/bg/stars-timing-0-blur-30px.jpg");
-  /* 侧边栏背景图片 */
-  --yun-sidebar-bg-img: url("https://cdn.yunyoujun.cn/img/bg/alpha-stars-timing-1.webp");
-}
-```

package/tsconfig.json

@@ -1,26 +0,0 @@
-{
-  // we need tsconfig.json to compile without
-  // error: This is likely not portable. A type annotation is necessary.
-  "compilerOptions": {
-    "target": "ESNext",
-    "jsx": "preserve",
-    "lib": ["DOM", "ESNext"],
-    "baseUrl": ".",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "resolveJsonModule": true,
-    "types": [
-      "valaxy/client",
-      "vite/client",
-      "vite-plugin-vue-layouts-next/client"
-    ],
-    "allowJs": true,
-    "strict": true,
-    "strictNullChecks": true,
-    "noUnusedLocals": true,
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true,
-    "skipLibCheck": true
-  },
-  "exclude": ["**/dist/**", "node_modules"]
-}