add configurable gift menu overlays

Add tenant-scoped gift menu settings, catalog-backed triggers, infinite OBS rendering, and guard assets. Normalize legacy and protobuf gift values for blind-box, battery-tier, and transaction-aware matching.
2026-07-21 19:41:49 -07:00
parent c4eca7b8bf
commit 716c6f3f2f
29 changed files with 2764 additions and 91 deletions
@@ -18,20 +18,22 @@ Vite 在 Docker build stage 编译本目录，最终静态文件由 Rust 同域

 ## 文件职责

-| 文件                  | 职责                                                 |
-| --------------------- | ---------------------------------------------------- |
-| `src/api.ts`          | same-origin fetch、错误模型和兼容性 normalizer       |
-| `src/auth.tsx`        | passwordless login、TOTP QR 与恢复码                 |
-| `src/control.tsx`     | tenant component studio 和 system-admin 邀请码页面   |
-| `src/stream.ts`       | 通用组件 WebSocket 鉴权、重连和 renderer 分流        |
-| `src/overlay.tsx`     | 弹幕、礼物/表情和 OBS 自适应渲染                     |
-| `src/songOverlay.tsx` | 点歌快照 reducer、revision 校验与往返滚动            |
-| `src/giftEffect.tsx`  | 礼物流星、大航海全屏庆祝与视口自适应渲染             |
-| `src/giftThemes.ts`   | 可扩展礼物特效主题注册表与 CSS 变量                  |
-| `src/pwa.tsx`         | install prompt、离线状态、显式更新和敏感状态 blocker |
-| `src/i18n.tsx`        | TOML 语言资源、浏览器回退和运行时切换                |
-| `src/types.ts`        | sanitized API view model 与 overlay settings         |
-| `pwa/control-sw.js`   | `/control/` 静态壳层的缓存策略                       |
+| 文件                    | 职责                                                 |
+| ----------------------- | ---------------------------------------------------- |
+| `src/api.ts`            | same-origin fetch、错误模型和兼容性 normalizer       |
+| `src/auth.tsx`          | passwordless login、TOTP QR 与恢复码                 |
+| `src/control.tsx`       | tenant component studio 和 system-admin 邀请码页面   |
+| `src/stream.ts`         | 通用组件 WebSocket 鉴权、重连和 renderer 分流        |
+| `src/overlay.tsx`       | 弹幕、礼物/表情和 OBS 自适应渲染                     |
+| `src/songOverlay.tsx`   | 点歌快照 reducer、revision 校验与往返滚动            |
+| `src/giftEffect.tsx`    | 礼物流星、大航海全屏庆祝与视口自适应渲染             |
+| `src/giftThemes.ts`     | 可扩展礼物特效主题注册表与 CSS 变量                  |
+| `src/giftMenu.tsx`      | 礼物菜单无限循环、触发定位与高亮 reducer             |
+| `src/giftMenuThemes.ts` | 可扩展礼物菜单主题注册表                             |
+| `src/pwa.tsx`           | install prompt、离线状态、显式更新和敏感状态 blocker |
+| `src/i18n.tsx`          | TOML 语言资源、浏览器回退和运行时切换                |
+| `src/types.ts`          | sanitized API view model 与 overlay settings         |
+| `pwa/control-sw.js`     | `/control/` 静态壳层的缓存策略                       |

 ## Secret 与状态

@@ -73,3 +75,4 @@ YAML 和项目文档。
 - [弹幕姬组件](../../docs/components/danmaku-overlay.md)
 - [点歌姬组件](../../docs/components/song-request.md)
 - [全屏礼物特效](../../docs/components/gift-effect.md)
+- [礼物菜单组件](../../docs/components/gift-menu.md)