Module theme 

主题（浅色 / 深色 / 跟随系统）管理。

三态模型：

• Theme::Light / Theme::Dark：用户显式选择，持久化到 localStorage。
• Theme::System：跟随系统偏好。移除 localStorage 持久化，首屏防闪烁 脚本因此自动回退到 prefers-color-scheme 分支；运行时监听 matchMedia('(prefers-color-scheme: dark)') 的 change 事件，系统切换 主题时实时同步 .dark class 与下游（CodeMirror 等）。

SSR 与客户端 hydration 都从 Theme::System 开始；挂载后再读取 localStorage 恢复用户选择。首屏配色和图标均由 ThemePreload 提前设置， 不依赖 WASM 加载速度或服务端无法读取的浏览器偏好。

下游消费者（CodeMirror、SVG 图标判定）应读 ResolvedTheme（实际生效明暗）， 而非 Theme（用户意图），这样 System 模式下系统偏好变化能自动传播。

Structs

ThemePreloadProps

Props for the ThemePreload component.

ThemeToggleProps

Props for the ThemeToggle component.

Enums

ResolvedTheme

实际生效的明暗主题（用户选择经 resolve() 解析后的结果）。

Theme

用户选择的主题意图（三态）。

Constants

THEME_PRELOAD_SCRIPT 🔒

THEME_SEGMENT_STYLE 🔒

Functions

ThemePreload

首屏主题预加载脚本组件（放在外壳 <head> 里，只由 SSR 输出）。

ThemeToggle

主题切换：浅色 / 深色 / 跟随系统三段式分段控件，基于 SegmentedControl（Radio）。

choose_theme

切换到指定外观：只有实际明暗翻转时才以 origin（视口坐标）为圆心做圆形扩散。

mode_label 🔒

主题意图的中文标签，用于 aria-label / title。

provide_theme

提供主题上下文，在 App 根部调用一次。

read_system_dark 🔒

读取当前系统是否为深色偏好。

use_resolved_theme

读取实际生效明暗主题。

use_theme

读取当前主题意图 Signal。

viewport_center 🔒

视口中心：键盘切换外观时，圆形扩散以此为圆心。