@nonamelego/dsh-catppuccin 0.5.1 → 0.5.2

package/README.en.md

@@ -30,9 +30,9 @@
 - [💝 Credits](#-credits)
 
 <p align="center">
-	<img src="assets/previews/combined.png" width="100%" alt="DeepSeek Harness under the four Catppuccin flavours"/>
+	<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/combined.png" width="100%" alt="DeepSeek Harness under the four Catppuccin flavours"/>
 	<br/><br/>
-	<img src="assets/previews/glass-combined.png" width="100%" alt="Glass skin · Latte & Mocha"/>
+	<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/glass-combined.png" width="100%" alt="Glass skin · Latte & Mocha"/>
 </p>
 
 ## Introduction
@@ -58,7 +58,9 @@ Catppuccin theme automatically.
 - 🧩 Registered into the official theme system, on a par with the built-in light / dark / system themes
 - 🎯 Full-UI colour coverage — not just one or two accent colours
 - ⚙️ One-click switch in Settings, persisted and restored across restarts
-- 🌐 Bilingual UI (Chinese / English, follows the system language)
+- 🔧 **Custom token overrides**: override individual colour tokens with `--dsw-* var: value` pairs (e.g. turn comments blue); persisted alongside the selected flavour
+- 🖍️ **Code-block highlight style**: default / italic-comments shiki themes
+- 🌐 Seven UI languages (Chinese / English / Japanese / Korean / Spanish / French / German, follows the system language)
 - 🪟 **Glass skin**: frosted glass for the top bar / sidebar / composer / stats line /
   trajectory view / chat bubbles / new-session button, one-click toggle in Settings;
   mica & compatibility modes, adjustable blur, frost and backdrop brightness
@@ -68,7 +70,8 @@ Catppuccin theme automatically.
   content softens as it scrolls under the panes
 - 🎨 Glass colours follow the current Catppuccin theme
 - 🔄 **Update check**: one-click "Check for updates" in Settings compares the latest npm
-  version and gives you a copyable upgrade command
+  version and gives you a copyable upgrade command; **auto-check is on by default** (once at
+  startup, then every 6 hours) and the release channel switches between stable and beta
 - 💻 **dsh-TUI terminal themes**: one command installs into dsh-TUI; the four themes sync to
   `~/.dsh-tui/themes/` automatically (see [Installation · dsh-TUI](#dsh-tui-terminal-themes))
 
@@ -78,19 +81,19 @@ Actual screenshots from a local GUI (the header image is a diagonal blend of the
 
 <details>
 <summary>🌻 Latte (light)</summary>
-<img src="assets/previews/latte.png"/>
+<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/latte.png"/>
 </details>
 <details>
 <summary>🪴 Frappé (dark)</summary>
-<img src="assets/previews/frappe.png"/>
+<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/frappe.png"/>
 </details>
 <details>
 <summary>🌺 Macchiato (dark)</summary>
-<img src="assets/previews/macchiato.png"/>
+<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/macchiato.png"/>
 </details>
 <details>
 <summary>🌿 Mocha (dark)</summary>
-<img src="assets/previews/mocha.png"/>
+<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/mocha.png"/>
 </details>
 
 ### Glass skin (Mica mode)
@@ -101,11 +104,11 @@ past the page edges; the background is the theme's solid base colour:
 
 <details>
 <summary>🌻 Latte (light glass)</summary>
-<img src="assets/previews/glass-latte.png"/>
+<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/glass-latte.png"/>
 </details>
 <details>
 <summary>🌿 Mocha (dark glass)</summary>
-<img src="assets/previews/glass-mocha.png"/>
+<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/glass-mocha.png"/>
 </details>
 
 ## Installation
@@ -146,8 +149,13 @@ The same package covers the TUI. Install it into the dsh-tui profile:
 dsh plugin --profile dsh-tui add @nonamelego/dsh-catppuccin
 ```
 
-Installing from the repository works the same way (use the git form while the npm release
-is pending). The package ships a tiny theme-sync plugin row
+Installing from the repository works the same way:
+
+```sh
+dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-theme
+```
+
+The package ships a tiny theme-sync plugin row
 (`dsh-catppuccin-tui-themes`, no service dependencies): on every dsh-TUI start it syncs the
 four theme JSONs to `~/.dsh-tui/themes/`, so upgrades pick up the new palettes. After
 installing, launch `dsh --profile dsh-tui` and pick the theme with `/theme` —
@@ -178,6 +186,15 @@ installing, launch `dsh --profile dsh-tui` and pick the theme with `/theme` —
 4. Choosing **Follow system** reverts to the official theme — it restores the preference
    you had before enabling Catppuccin (light / dark / follow system) instead of forcing a reset.
 
+### Other options in the Catppuccin row
+
+- **Code highlight style**: default / **italic comments** — affects only the shiki colours used
+  in code blocks and diffs.
+- **Custom overrides** (collapsible; the button shows the entry count): override individual tokens
+  with `--dsw-* var: value` pairs, e.g. `--dsw-static-blue-500` → `#89b4fa`. The **key** commits on
+  blur and must start with `--` (otherwise the entry is dropped); the **value** applies as you type,
+  and an **empty value deletes the entry**; ✕ removes the row. Overrides persist with the flavour.
+
 ### Glass skin
 
 Right below the **Catppuccin theme** row in **Settings → General** you'll find the **Glass** row:
@@ -201,6 +218,8 @@ In **Settings → General**, right below the **Glass** row:
 - Clicking **Check for updates** compares the latest npm version with the installed one:
   up to date → shows the current version; newer → shows the new version plus a copyable
   upgrade command (the profile name is detected automatically, falling back to `web`).
+- **Auto-check**: on by default — once after startup, then every 6 hours (switch it off on this row);
+  the **Channel** picks **Stable** (follows `latest` only) or **Beta** (prereleases too).
 - Locally linked / source installs (`link:` / `file:` / git) don't show an npm upgrade
   command — you'll be told to `git pull` or rebuild instead.
 - Channel policy: stable builds follow the `latest` tag; prereleases follow both `latest`
@@ -233,9 +252,10 @@ What this plugin does:
 
 ```sh
 pnpm install
-pnpm typecheck   # tsc --noEmit type check
-pnpm test        # vitest palette-coverage tests
-pnpm build       # tsdown build -> lib/index.js (host) + lib/client.js (browser)
+pnpm typecheck       # tsc --noEmit: type check for src
+pnpm typecheck:tests # tsc --noEmit: type check for the specs (vitest transpiles, it never type checks)
+pnpm test            # vitest palette-coverage tests
+pnpm build           # tsdown build -> lib/index.js (host) + lib/client.js (browser)
 ```
 
 Palettes are produced by a generator script — after editing
@@ -253,6 +273,17 @@ pnpm changelog:gen            # print the draft since the last tag
 pnpm changelog:gen -- --write # write it into the [Unreleased] section
 ```
 
+TypeDoc docs for the public API (`./client`, `./tui-themes` subpath exports) are generated
+locally on demand into `docs/api/` (that directory is **not** committed — it's in
+`.gitignore`; wire up CI Pages publishing later if an online copy is ever wanted):
+
+```sh
+pnpm docs:api
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the contribution guide and
+[docs/state-migrations.md](docs/state-migrations.md) for the state versioning contract.
+
 ### Local link debugging
 
 Clone the repo, link it into a profile and add it to the bundles (use your own paths):
@@ -301,4 +332,8 @@ Then add `@nonamelego/dsh-catppuccin` to the profile's `package.json`
 
 <p align="center">
 	Copyright &copy; 2021-present <a href="https://github.com/catppuccin/catppuccin" target="_blank">Catppuccin Org</a>
+</p>
+
+<p align="center">
+	<a href="https://github.com/catppuccin/catppuccin/blob/main/LICENSE"><img src="https://img.shields.io/static/v1.svg?style=for-the-badge&label=License&message=MIT&logoColor=d9e0ee&colorA=363a4f&colorB=b7bdf8"/></a>
 </p>

package/README.md

@@ -28,9 +28,9 @@
 - [💝 致谢](#致谢)
 
 <p align="center">
-	<img src="assets/previews/combined.png" width="100%" alt="Catppuccin 四主题下的 DeepSeek Harness"/>
+	<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/combined.png" width="100%" alt="Catppuccin 四主题下的 DeepSeek Harness"/>
 	<br/><br/>
-	<img src="assets/previews/glass-combined.png" width="100%" alt="玻璃质感 · Latte & Mocha"/>
+	<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/glass-combined.png" width="100%" alt="玻璃质感 · Latte & Mocha"/>
 </p>
 
 ## 简介
@@ -55,6 +55,8 @@ Catppuccin 主题。
 - 🧩 接入官方主题系统，与内置浅色 / 深色 / 跟随系统主题平级
 - 🎯 全界面配色覆盖，不只是一两个强调色
 - ⚙️ 设置页一行切换，选择自动保存、重启自动恢复
+- 🔧 **自定义 token 覆盖**：按「`--dsw-* 变量: 值`」逐条覆盖单个配色 token（例如把注释色换成蓝色），与所选风味一起持久保存
+- 🖍️ **代码块高亮风格**：默认 / 注释斜体（italic-comments）两套 shiki 风格可选
 - 🌐 中 / 英 / 日 / 韩 / 西 / 法 / 德七语文案（跟随系统语言）
 - 🪟 **玻璃质感**：顶栏 / 侧边栏 / 输入框 / 统计行 / 轨迹视图 / 聊天气泡 /
   新会话按钮磨砂玻璃效果，设置里一键开关；云母 / 兼容双模式，模糊度、磨砂度、
@@ -62,7 +64,7 @@ Catppuccin 主题。
 - 🌫️ **玻璃拟态细节**：页面上下边缘渐变模糊、折叠侧边栏悬浮玻璃、
   纯色背景跟随主题底色——内容滚入视口边缘时柔化穿过，层次更立体
 - 🎨 玻璃配色自动跟随当前 Catppuccin 主题
-- 🔄 **检查 Catppuccin 插件更新**：设置页一键检测本插件（dsh-catppuccin）在 npm 上的最新版本，发现新版直接给出可复制的升级命令
+- 🔄 **检查 Catppuccin 插件更新**：设置页一键检测本插件（dsh-catppuccin）在 npm 上的最新版本，发现新版直接给出可复制的升级命令；**默认开启自动检查**（启动后一次 + 每 6 小时），更新渠道可选稳定版 / Beta
 - 💻 **dsh-TUI 终端主题**：一条安装命令装进 dsh-TUI，四套主题自动同步到 `~/.dsh-tui/themes/`，见[安装 · dsh-TUI](#dsh-tui-终端版主题)
 
 ## 预览
@@ -71,19 +73,19 @@ Catppuccin 主题。
 
 <details>
 <summary>🌻 Latte（浅色）</summary>
-<img src="assets/previews/latte.png"/>
+<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/latte.png"/>
 </details>
 <details>
 <summary>🪴 Frappé（深色）</summary>
-<img src="assets/previews/frappe.png"/>
+<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/frappe.png"/>
 </details>
 <details>
 <summary>🌺 Macchiato（深色）</summary>
-<img src="assets/previews/macchiato.png"/>
+<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/macchiato.png"/>
 </details>
 <details>
 <summary>🌿 Mocha（深色）</summary>
-<img src="assets/previews/mocha.png"/>
+<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/mocha.png"/>
 </details>
 
 ### 玻璃质感（Mica 云母模式）
@@ -92,16 +94,13 @@ Catppuccin 主题。
 聊天气泡、输入框与统计行都是玻璃卡片，消息滚过页面边缘时被柔化，
 背景为主题底色的纯色（截图来自本地 GUI）：
 
-<p align="center">
-</p>
-
 <details>
 <summary>🌻 Latte（浅色玻璃）</summary>
-<img src="assets/previews/glass-latte.png"/>
+<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/glass-latte.png"/>
 </details>
 <details>
 <summary>🌿 Mocha（深色玻璃）</summary>
-<img src="assets/previews/glass-mocha.png"/>
+<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/glass-mocha.png"/>
 </details>
 
 ## 安装
@@ -143,7 +142,7 @@ dsh plugin --profile web add https://github.com/NoNameLeGo/dsh-catppuccin-theme
 dsh plugin --profile dsh-tui add @nonamelego/dsh-catppuccin
 ```
 
-从仓库安装同理（npm 版尚未发版时可用 git 形式，效果一致）：
+从仓库安装同理（也可用 git 形式，效果一致）：
 
 ```sh
 dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-theme
@@ -171,6 +170,13 @@ dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-th
 4. 选择 **跟随系统** 则回退到官方主题——会还原你启用 Catppuccin 之前
    的官方偏好（浅色 / 深色 / 跟随系统），而不是强制重置。
 
+### Catppuccin 行里的其它选项
+
+- **代码高亮风格**：默认 / **注释斜体**（italic-comments）——只影响代码块与 diff 的 shiki 高亮配色。
+- **自定义覆盖**（折叠区，按钮上显示已有条数）：按「`--dsw-* 变量: 值`」逐条覆盖单个 token，
+  例如 `--dsw-static-blue-500` → `#89b4fa`。**键名**失焦生效（必须以 `--` 开头，否则该条会被丢弃）；
+  **值**输入即生效、**清空值即删除该条**；✕ 删除整行。覆盖持久保存，与所选风味一起生效。
+
 ### 玻璃质感
 
 在 **设置 → 常规** 的 **Catppuccin 主题** 正下方找到 **玻璃质感** 行：
@@ -196,6 +202,8 @@ dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-th
 - 点击 **检查更新** 即对比 npm 上的最新版与当前版本：已是最新 → 显示当前
   版本号；发现新版 → 显示新版本号并给出可复制的升级命令（命令中的 profile
   名自动探测，无需手动替换；探测失败才回退为 `web`）。
+- **自动检查**：默认开启——启动后检查一次、之后每 6 小时一次（该行可关闭）；
+  **渠道**可选 **稳定版**（只跟 `latest`）或 **Beta 版**（连预发布一起跟）。
 - 本插件为本地链接 / 源码安装（`link:` / `file:` / git）时不显示 npm 升级
   命令，会提示改用 `git pull` 或重新构建。
 - 通道策略：正式版只跟随 `latest` 标签；预发布版同时跟随 `beta`（升级命令
@@ -224,9 +232,10 @@ dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-th
 
 ```sh
 pnpm install
-pnpm typecheck   # tsc --noEmit 类型检查
-pnpm test        # vitest 跑配色表 / 契约 / e2e 覆盖测试
-pnpm build       # tsdown 构建 -> lib/index.js（服务端）+ lib/client.js（浏览器）
+pnpm typecheck       # tsc --noEmit：src 的类型检查
+pnpm typecheck:tests # tsc --noEmit：tests 的类型检查（vitest 跑 esbuild，不做类型检查）
+pnpm test            # vitest 跑配色表 / 契约 / e2e 覆盖测试
+pnpm build           # tsdown 构建 -> lib/index.js（服务端）+ lib/client.js（浏览器）
 ```
 
 配色表由生成器脚本产出——修改 `scripts/generate-palettes.mjs` 后重跑
@@ -237,8 +246,15 @@ pnpm build       # tsdown 构建 -> lib/index.js（服务端）+ lib/client.js
 node scripts/generate-palettes.mjs [--pin <upstream-sha>]
 ```
 
-对外 API（`./client`、`./tui-themes` 子路径导出）的 typedoc 文档生成到
-`docs/api/`（GitHub Pages 发布交给 maintainer）：
+CHANGELOG 草稿由 conventional 提交生成（提交正文里的 `EN:` 行会被渲染成英文摘要）：
+
+```sh
+pnpm changelog:gen            # 打印上一 tag 之后的草稿
+pnpm changelog:gen -- --write # 直接写入 [Unreleased] 节
+```
+
+对外 API（`./client`、`./tui-themes` 子路径导出）的 typedoc 文档**按需本地生成**到
+`docs/api/`（该目录不入库、已进 `.gitignore`；哪天真需要在线版本再接 CI 发布）：
 
 ```sh
 pnpm docs:api

package/lib/client.js

@@ -134,8 +134,9 @@ window.__ModuleLoader__.load({
 			const style = (0, react.useSyncExternalStore)(subscribePrefs, shikiStyle);
 			const [overridesOpen, setOverridesOpen] = (0, react.useState)(false);
 			const [draftRows, setDraftRows] = (0, react.useState)([]);
+			const isTokenKey = (key) => key.trim().startsWith("--");
 			const commitDraft = (index, key, value) => {
-				if (key.trim() !== "" && value.trim() !== "") {
+				if (isTokenKey(key) && value.trim() !== "") {
 					setOverrides({
 						...overrideMap,
 						[key.trim()]: value
@@ -146,11 +147,15 @@ window.__ModuleLoader__.load({
 					value
 				} : row));
 			};
+			/** Rename (or, with an empty/invalid key, delete) a persisted override. The
+			*  key input is uncontrolled and commits on blur: writing on every keystroke
+			*  repersisted the entry under each intermediate key, and an intermediate
+			*  key that is not a `--` token made the row delete itself mid-typing. */
 			const commitPersistedKey = (oldKey, newKey) => {
 				if (newKey === oldKey) return;
 				const next = { ...overrideMap };
 				delete next[oldKey];
-				if (newKey.trim() !== "") next[newKey.trim()] = overrideMap[oldKey];
+				if (isTokenKey(newKey)) next[newKey.trim()] = overrideMap[oldKey];
 				setOverrides(next);
 			};
 			const commitPersistedValue = (key, value) => {
@@ -334,8 +339,8 @@ window.__ModuleLoader__.load({
 										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 											type: "text",
 											"aria-label": t("row.overridesKey"),
-											value: key,
-											onChange: (e) => {
+											defaultValue: key,
+											onBlur: (e) => {
 												commitPersistedKey(key, e.target.value);
 											},
 											placeholder: "--dsw-static-blue-500",
@@ -1198,7 +1203,7 @@ window.__ModuleLoader__.load({
 					"--dsw-static-amber-400": "color-mix(in srgb, #ef9f76 70%, #303446)",
 					"--dsw-static-amber-500": "#ef9f76",
 					"--dsw-static-amber-600": "#ef9f76",
-					"--dsw-static-amber-900": "color-mix(in srgb, #ef9f76 32%, #303446)",
+					"--dsw-static-amber-900": "color-mix(in srgb, #ef9f76 18%, #232634)",
 					"--dsw-static-blue-100": "color-mix(in srgb, #8caaee 24%, #303446)",
 					"--dsw-static-blue-300": "color-mix(in srgb, #8caaee 50%, #303446)",
 					"--dsw-static-blue-400": "color-mix(in srgb, #8caaee 66%, #303446)",
@@ -1225,7 +1230,7 @@ window.__ModuleLoader__.load({
 					"--dsw-static-green-100": "color-mix(in srgb, #a6d189 18%, #303446)",
 					"--dsw-static-green-400": "color-mix(in srgb, #a6d189 80%, #303446)",
 					"--dsw-static-green-500": "#a6d189",
-					"--dsw-static-green-900": "color-mix(in srgb, #a6d189 30%, #303446)",
+					"--dsw-static-green-900": "color-mix(in srgb, #a6d189 18%, #232634)",
 					"--dsw-static-neutral-00": "#c6d0f5",
 					"--dsw-static-neutral-1000": "#232634",
 					"--dsw-static-neutral-100": "#a5adce",
@@ -1368,7 +1373,7 @@ window.__ModuleLoader__.load({
 					"--dsw-static-amber-400": "color-mix(in srgb, #f5a97f 70%, #24273a)",
 					"--dsw-static-amber-500": "#f5a97f",
 					"--dsw-static-amber-600": "#f5a97f",
-					"--dsw-static-amber-900": "color-mix(in srgb, #f5a97f 32%, #24273a)",
+					"--dsw-static-amber-900": "color-mix(in srgb, #f5a97f 18%, #181926)",
 					"--dsw-static-blue-100": "color-mix(in srgb, #8aadf4 24%, #24273a)",
 					"--dsw-static-blue-300": "color-mix(in srgb, #8aadf4 50%, #24273a)",
 					"--dsw-static-blue-400": "color-mix(in srgb, #8aadf4 66%, #24273a)",
@@ -1395,7 +1400,7 @@ window.__ModuleLoader__.load({
 					"--dsw-static-green-100": "color-mix(in srgb, #a6da95 18%, #24273a)",
 					"--dsw-static-green-400": "color-mix(in srgb, #a6da95 80%, #24273a)",
 					"--dsw-static-green-500": "#a6da95",
-					"--dsw-static-green-900": "color-mix(in srgb, #a6da95 30%, #24273a)",
+					"--dsw-static-green-900": "color-mix(in srgb, #a6da95 18%, #181926)",
 					"--dsw-static-neutral-00": "#cad3f5",
 					"--dsw-static-neutral-1000": "#181926",
 					"--dsw-static-neutral-100": "#a5adcb",
@@ -1538,7 +1543,7 @@ window.__ModuleLoader__.load({
 					"--dsw-static-amber-400": "color-mix(in srgb, #fab387 70%, #1e1e2e)",
 					"--dsw-static-amber-500": "#fab387",
 					"--dsw-static-amber-600": "#fab387",
-					"--dsw-static-amber-900": "color-mix(in srgb, #fab387 32%, #1e1e2e)",
+					"--dsw-static-amber-900": "color-mix(in srgb, #fab387 18%, #11111b)",
 					"--dsw-static-blue-100": "color-mix(in srgb, #89b4fa 24%, #1e1e2e)",
 					"--dsw-static-blue-300": "color-mix(in srgb, #89b4fa 50%, #1e1e2e)",
 					"--dsw-static-blue-400": "color-mix(in srgb, #89b4fa 66%, #1e1e2e)",
@@ -1565,7 +1570,7 @@ window.__ModuleLoader__.load({
 					"--dsw-static-green-100": "color-mix(in srgb, #a6e3a1 18%, #1e1e2e)",
 					"--dsw-static-green-400": "color-mix(in srgb, #a6e3a1 80%, #1e1e2e)",
 					"--dsw-static-green-500": "#a6e3a1",
-					"--dsw-static-green-900": "color-mix(in srgb, #a6e3a1 30%, #1e1e2e)",
+					"--dsw-static-green-900": "color-mix(in srgb, #a6e3a1 18%, #11111b)",
 					"--dsw-static-neutral-00": "#cdd6f4",
 					"--dsw-static-neutral-1000": "#11111b",
 					"--dsw-static-neutral-100": "#a6adc8",
@@ -1847,7 +1852,7 @@ window.__ModuleLoader__.load({
 			},
 			{
 				attribute: "data-dsh-glass-settings",
-				selector: "[class*=\"VOzbGW_overlay\"]"
+				selector: ":has(> [role=\"dialog\"][aria-modal=\"true\"])"
 			}
 		];
 		function stamp(seam) {
@@ -1879,6 +1884,7 @@ window.__ModuleLoader__.load({
 			stampAll();
 			let frame;
 			let dirty = false;
+			let disposed = false;
 			const stampFrame = () => {
 				frame = void 0;
 				if (!dirty) return;
@@ -1886,6 +1892,7 @@ window.__ModuleLoader__.load({
 				stampAll();
 			};
 			const schedule = () => {
+				if (disposed) return;
 				dirty = true;
 				if (frame !== void 0) return;
 				frame = requestAnimationFrame(stampFrame);
@@ -1896,6 +1903,7 @@ window.__ModuleLoader__.load({
 				subtree: true
 			});
 			return () => {
+				disposed = true;
 				observer.disconnect();
 				if (frame !== void 0) cancelAnimationFrame(frame);
 				frame = void 0;
@@ -2415,6 +2423,7 @@ window.__ModuleLoader__.load({
 						max,
 						step,
 						value,
+						"aria-valuetext": `${value}${unit}`,
 						onChange: (e) => {
 							onChange(clamp(Number(e.target.value)));
 						}
@@ -2792,13 +2801,23 @@ window.__ModuleLoader__.load({
 			const [dismissedConflicts, setDismissedConflicts] = (0, react.useState)(0);
 			const [retryRemaining, setRetryRemaining] = (0, react.useState)(null);
 			const retryTimer = (0, react.useRef)(void 0);
+			const tickerTimer = (0, react.useRef)(void 0);
+			const retriesUsed = (0, react.useRef)(0);
 			const mounted = (0, react.useRef)(true);
-			const runCheck = async (withChannel = channelValue) => {
+			/** Drop a pending auto-retry (its timeout and its countdown ticker). */
+			const cancelRetry = () => {
 				if (retryTimer.current !== void 0) {
 					window.clearTimeout(retryTimer.current);
 					retryTimer.current = void 0;
-					setRetryRemaining(null);
 				}
+				if (tickerTimer.current !== void 0) {
+					window.clearInterval(tickerTimer.current);
+					tickerTimer.current = void 0;
+				}
+				setRetryRemaining(null);
+			};
+			const runCheck = async (withChannel = channelValue) => {
+				cancelRetry();
 				setPhase("checking");
 				setCopied(false);
 				let next;
@@ -2813,27 +2832,36 @@ window.__ModuleLoader__.load({
 				}
 				setPayload(next);
 				setPhase("done");
-				if (!next.ok) {
+				if (!next.ok && retriesUsed.current === 0) {
+					retriesUsed.current = 1;
 					const target = Date.now() + UPDATE_RETRY_AFTER_MS;
 					setRetryRemaining(UPDATE_RETRY_AFTER_MS / 1e3);
 					const ticker = window.setInterval(() => {
 						const remaining = Math.max(0, Math.ceil((target - Date.now()) / 1e3));
 						setRetryRemaining(remaining);
-						if (remaining <= 0) window.clearInterval(ticker);
+						if (remaining <= 0) {
+							window.clearInterval(ticker);
+							tickerTimer.current = void 0;
+						}
 					}, 1e3);
+					tickerTimer.current = ticker;
 					retryTimer.current = window.setTimeout(() => {
-						window.clearInterval(ticker);
-						retryTimer.current = void 0;
-						setRetryRemaining(null);
 						if (mounted.current) runCheck();
+						else cancelRetry();
 					}, UPDATE_RETRY_AFTER_MS);
 				}
 			};
+			/** A user-initiated check: re-arms the one auto-retry budget (item V). */
+			const runManualCheck = () => {
+				retriesUsed.current = 0;
+				runCheck();
+			};
 			(0, react.useEffect)(() => {
 				mounted.current = true;
 				return () => {
 					mounted.current = false;
 					if (retryTimer.current !== void 0) window.clearTimeout(retryTimer.current);
+					if (tickerTimer.current !== void 0) window.clearInterval(tickerTimer.current);
 				};
 			}, []);
 			const autoResult = lastAutoResult();
@@ -3035,7 +3063,7 @@ window.__ModuleLoader__.load({
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
 									disabled: phase === "checking",
-									onClick: () => void runCheck(),
+									onClick: runManualCheck,
 									style: {
 										...buttonStyle,
 										cursor: phase === "checking" ? "default" : "pointer",
@@ -3178,7 +3206,7 @@ window.__ModuleLoader__.load({
 									}),
 									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 										type: "button",
-										onClick: () => void runCheck(),
+										onClick: runManualCheck,
 										style: {
 											...buttonStyle,
 											cursor: "pointer"
@@ -3432,13 +3460,19 @@ window.__ModuleLoader__.load({
 				localStorage.setItem(UPDATE_CHANNEL_KEY, value);
 			} catch {}
 		}
-		/** Read the persisted token overrides (unparseable/absent → empty map). */
+		/** Read the persisted token overrides (unparseable/absent → empty map).
+		*
+		* Sanitized on read (`sanitizeOverrides`, the same guard the settings document
+		* goes through) so localStorage and the durable section always have the SAME
+		* shape. Without it a key that is not a `--` token (e.g. `dsw-static-blue-500`
+		* typed without the dashes) lives in localStorage only: the hydration compares
+		* the two shapes, sees a difference, and "the document wins" overwrites the
+		* entry — the user's row vanished a debounce-beat after it was typed. */
 		function readOverrides() {
 			try {
 				const raw = localStorage.getItem(OVERRIDES_KEY);
 				if (raw === null) return {};
-				const parsed = JSON.parse(raw);
-				return typeof parsed === "object" && parsed !== null ? parsed : {};
+				return sanitizeOverrides(JSON.parse(raw));
 			} catch {
 				return {};
 			}