@nonamelego/dsh-catppuccin 0.6.6 → 0.7.0

package/README.en.md

@@ -224,9 +224,14 @@ installing, launch `dsh --profile dsh-tui` and pick the theme with `/theme` —
 2. Open **Settings** and pick **Catppuccin** in the left nav (its own section, after the official ones).
 3. Under **Theme**, pick a flavour:
    **Latte** (light), **Frappé**, **Macchiato** or **Mocha** (dark).
-4. Choosing **Follow system** reverts to the official theme — it restores the preference
+4. Turn on **Follow system light/dark**: Latte on light, your chosen flavour (Mocha by default)
+   on dark, switching with the Windows light/dark setting — the native title bar and window
+   buttons follow too. The dark end is picked separately (Frappé / Macchiato / Mocha).
+5. Choosing **Turn off (official theme)** reverts to the official theme — it restores the preference
    you had before enabling Catppuccin (light / dark / follow system) instead of forcing a reset.
 
+> "Follow system" used to name step 5; since 0.7.0 the two are separate controls, as above.
+
 > **Second entrance**: open this plugin's own card on the **Plugins** page and the middle of
 > its detail page shows the **same settings** (Catppuccin theme / Glass / Check for updates /
 > Feedback & support) — both read and write one set of preferences, so either place works.
@@ -264,7 +269,9 @@ The **Glass** section lives on the **Settings → Catppuccin** page:
   **off by default** — they do not follow the panes, so each pane transmits a different slice
   of them and the top-left corner brightens visibly when on. Once on, a **glow strength** knob
   (0–200%, `100%` = that look and the default; the ceiling is a conservative
-  contrast budget on Latte, see `docs/issue-32-glow-tuning.md`) scales the two glows only — the wash is never touched, and at either end of the
+  contrast budget on Latte, see `docs/issue-32-glow-tuning.md`) and a **glow spread**
+  knob (100–250%, `100%` = the shipped radii; it only enlarges, so the light stops
+  piling up in one corner) scale the two glows only — the wash is never touched, and at either end of the
   brightness knob the ambience collapses and the glows fade out with it.
 - **In-place previews**: a **ground sample strip** in the glass section (drag brightness or
   toggle the glows and it changes on the spot — it is painted by the page ground's own rule);
@@ -333,7 +340,7 @@ matches are exactly these:
 | Composer card | `[data-composer-card]` (the material is painted on its `::before`, see issue #19) |
 | Menus | `[data-menu-material='translucent']` (the host MenuSurface's own material hook — the recipe overrides the `--dsw-menu-surface-fill` / `--dsw-menu-backdrop-filter` its material plane reads) plus the hand-rolled-menu fallback `[role='menu']:not([data-menu-material]):not([data-menu-material] *)` |
 | Popovers | `[class*='popover']` / `[class*='dropdown']` (still substrings) |
-| Modal dialogs | `[role='dialog'][aria-modal='true']` |
+| Modal dialogs | `[role='presentation'] > [role='dialog'][aria-modal='true']` (**seat guard**: only a panel seated under `[role='presentation']`; a body-level full-screen layer is not one — see issue #34) |
 | Host right sidebar (open state only) | `[data-sidebar-right-panel][data-sidebar-right-open]` |
 
 **A new class name in a third-party plugin can still be misread.** When you hit one, work through three

package/README.md

@@ -197,9 +197,14 @@ dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-th
 2. 打开 **设置**，在左侧导航里点 **Catppuccin**（官方各节之后的独立分区）。
 3. 在 **主题** 区域选择风味：
    **Latte**（浅色）、**Frappé**、**Macchiato** 或 **Mocha**（深色）。
-4. 选择 **跟随系统** 则回退到官方主题——会还原你启用 Catppuccin 之前
+4. 打开 **跟随系统深色/浅色**：浅色时用 **Latte**、深色时用你选的风味（默认 **Mocha**），
+   随 Windows 的深浅色设置自动切换——原生标题栏和窗口按钮也会一起变。
+   深色端可单独选 Frappé / Macchiato / Mocha。
+5. 选择 **关闭（官方主题）** 则回退到官方主题——会还原你启用 Catppuccin 之前
    的官方偏好（浅色 / 深色 / 跟随系统），而不是强制重置。
 
+> 「跟随系统」一词以前指第 5 步的「关闭」，0.7.0 起两个功能分开命名，见上。
+
 > **另一处入口**：在 **插件页**（Plugins）点开本插件自己的卡片，中间会出现**同一组设置**
 > （Catppuccin 主题 / 玻璃质感 / 检查更新 / 反馈与支持）——两处读写的是同一份偏好，改哪边都一样。
 > 该区域由宿主（≥ `0.2.0-rc.2` 的插件详情页）提供，更旧的版本上没有。
@@ -235,7 +240,8 @@ dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-th
 - **地面光斑**：在地面渐变上叠两枚**固定于屏幕**的柔光斑（`0.6.3` 的观感），**默认关**——
   光斑不跟面板走，每块玻璃透出的是它的不同部位，打开后左上角会明显偏亮。
   打开后还有 **光斑强度**（0–200%，`100%` 就是上述观感，默认值；上限是**保守值**，按 Latte 上文字的
-  对比度预算定，见 `docs/issue-32-glow-tuning.md`）——
+  对比度预算定，见 `docs/issue-32-glow-tuning.md`）和 **光斑范围**（100–250%，`100%` = 出厂的两枚半径；
+  只放大，用来把光摊平、别堆在角落里）——
   强度只放大两枚光斑，**不动**洗底渐变；背景亮度拉到两端时氛围归零，光斑随之淡出。
 - **就地预览**：玻璃区里有一条**地面样本条**（拖亮度或切光斑，它当场变化——取的就是页面地面那套色）；
   代码高亮下方有**代码样本**（直接读 `--shiki-token-*`，切「柔和注释」即刻变色）；
@@ -295,7 +301,7 @@ dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-th
 | 输入框卡片 | `[data-composer-card]`（材质画在它的 `::before` 上，见 issue #19） |
 | 菜单 | `[data-menu-material='translucent']`（宿主 MenuSurface 的材质钩子；配方覆写它自带材质面读的 `--dsw-menu-surface-fill` / `--dsw-menu-backdrop-filter`）+ 手写菜单兜底 `[role='menu']:not([data-menu-material]):not([data-menu-material] *)` |
 | 弹出层 | `[class*='popover']` / `[class*='dropdown']`（仍是子串） |
-| 模态框 | `[role='dialog'][aria-modal='true']` |
+| 模态框 | `[role='presentation'] > [role='dialog'][aria-modal='true']`（**座位守卫**：只命中挂在 `[role='presentation']` 下面的面板；body 直挂的全屏浮层不算，见 issue #34） |
 | 宿主右侧栏（仅展开态） | `[data-sidebar-right-panel][data-sidebar-right-open]` |
 
 **第三方插件里新出现的类名仍可能被误命中**。遇到时走三步：**① 只读取证**（一段粘进控制台的探针脚本，
@@ -339,11 +345,14 @@ console.table({ backdropFilter: cs.backdropFilter, background: cs.backgroundColo
 | DSH | `>=0.1.7-rc.1`（设置页消费官方 `dsh-client-ui-primitives` 的 `SegmentedControl`，该导出自 `0.1.7-alpha.1` 起才有；旧的 `settingsScope` 通道代码保留，但 0.1.5 / 0.1.6 宿主不再声明支持） |
 | Node.js | `>=20` |
 | Profile | `web`（Web GUI 与两个桌面壳都启动 web 界面，共用本插件）；桌面端默认 profile 名为 `desktop`（已声明） |
-| 已验证的具体版本 | `0.2.1-rc.2`：官方桌面壳真机验收——插件正常启动、token 逐项生效、玻璃配方完整，**改设置真写回 `cordis.patch.yml`（修复前不写）**、重启后从文档采纳回来（[审计](docs/desktop-0.2.1-adaptation-audit.md)）；`0.2.0-rc.2`：官方桌面壳自带运行时的启动级 e2e（19/19）、真机桌面窗口像素与标题栏取色链路、`configForms` 落盘（[审计](docs/desktop-0.2.0-adaptation-audit.md)）；`0.1.7-rc.1`：真实 profile 上完成安装、启动、改设置落盘与重启恢复（[证据](docs/issue-15-settings-seam-0.1.7.md)）；`0.1.7-rc.2`：启动级 e2e 与玻璃层的真页采样（issue #16 / #17）；`0.1.5-rc.1`：按 CI 口径复跑的启动级 e2e（**历史记录**，已低于当前兼容下限） |
-
-`package.json` 的 `dsh.compatibility`（`dsh` / `dshReleases` / `dshOperations`）**只声明当前支持的三条**：
-`0.1.7-rc.1` / `0.2.0-rc.2` / `0.2.1-rc.2`（兼容下限 `>=0.1.7-rc.1`）；更早的 `0.1.5-rc.*`
-与 `0.1.7-alpha.*` 是**当时**的验证记录，不在声明内。
+| 已验证的具体版本 | `0.2.1-rc.5`：官方桌面壳真机验收——启动正常、token 逐项生效、玻璃配方完整（顶栏 / 输入卡 / dock / 菜单 / 设置壳逐面实测），`--dsw-*` 全表与前端构建产物**逐字节不变**（[审计](docs/issue-0.2.1-rc.5-adaptation-audit.md)）；`0.2.1-rc.3`：三个新 More 菜单自动继承玻璃、视图标签行与 `-95/107` 滚动补偿不冲突（[审计](docs/issue-0.2.1-rc.3-adaptation-audit.md)）；`0.2.1-rc.2`：官方桌面壳真机验收——插件正常启动、token 逐项生效、玻璃配方完整，**改设置真写回 `cordis.patch.yml`（修复前不写）**、重启后从文档采纳回来（[审计](docs/desktop-0.2.1-adaptation-audit.md)）；`0.2.0-rc.2`：官方桌面壳自带运行时的启动级 e2e（19/19）、真机桌面窗口像素与标题栏取色链路、`configForms` 落盘（[审计](docs/desktop-0.2.0-adaptation-audit.md)）；`0.1.7-rc.1`：真实 profile 上完成安装、启动、改设置落盘与重启恢复（[证据](docs/issue-15-settings-seam-0.1.7.md)）；`0.1.7-rc.2`：启动级 e2e 与玻璃层的真页采样（issue #16 / #17）；`0.1.5-rc.1`：按 CI 口径复跑的启动级 e2e（**历史记录**，已低于当前兼容下限） |
+
+`package.json` 的 `dsh.compatibility`（`dsh` / `dshReleases` / `dshOperations`）声明清单以文件为准，
+当前是 `0.1.7-rc.1` / `0.2.0-rc.2` / `0.2.1-rc.2` / `0.2.1-rc.3` / `0.2.1-rc.5`（兼容下限 `>=0.1.7-rc.1`）；
+更早的 `0.1.5-rc.*` 与 `0.1.7-alpha.*` 是**当时**的验证记录，不在声明内。
+⚠️ 商铺按「上游最新三版」窗口判定（`latest` / `next` / `alpha` 里版本号最高的那个往下数三版），
+**窗口内至少命中一条**才不会显示「兼容未声明」——所以上游每发一版都要跟，见
+`docs/issue-0.2.1-rc.5-adaptation-audit.md` §6.1。
 
 色彩覆盖以 `dsh-v0.2.0-rc.2` 的 `design-platform.css` 为基线：每方案 190 个 `--dsw-*` token（static 77 /
 alias 101 / specific 11 / 非三族 1）全覆盖，含 0.2.0 新增的 17 个 alias。