dsh-quick-toc 0.7.7 → 0.7.9

package/CHANGELOG.en.md

@@ -2,11 +2,24 @@
 
 All notable changes to **dsh-quick-toc** are documented here. Chinese version: [CHANGELOG.md](CHANGELOG.md).
 
+## [0.7.9] - 2026-09-28
+
+### Fixed
+- **The curtain had no drop or retract animation while the system asked for reduced motion (Windows' "animation effects" switched off)**: it appeared and vanished with no movement at all. The curtain now always plays the two, while the rest of the plugin's motion still follows that system setting.
+
+## [0.7.8] - 2026-09-27
+
+### Changed
+- **DSH 0.1.7-rc.2 is supported**: it shares the whole plugin interface with rc.1 (the configuration card still registers into `plugins.item`, `plugins.bundle.config` and the rc line's `settings.plugin.item`, the settings service is still `configForms`, and the Plugins page's slot contract is byte-for-byte rc.1's), so no code change was needed; it was exercised point by point in an isolated environment (host boot, plugin status, the Plugins page's entry and card, a card write landing in the settings document, sessions, panel and curtain).
+
+### Fixed
+- **Opening the curtain's search column no longer re-lays out the outline every frame**: the column used to transition its own width, and because the outline is the flex item next to it, every frame re-laid out the whole rendered list (measured on a 34-row list: one width step per frame, ~18ms frames and a 76ms first hitch; the cost grows with the list). The layout now flips once and the movement rides on a transform (the column slides in from off the right edge while the outline is flipped back to where it sat and released), which measured under 32ms for the first frame, with the resting geometry unchanged.
+
 ## [0.7.7] - 2026-09-27
 
 ### Fixed
-- **On the 0.1.7 line the settings card had disappeared**: 0.1.7 removed the whole Settings → Plugins → Plugin configuration page (that line has only the sidebar's Plugins page), and the card was registered on the bundle page alone, so the Plugins page's Official group had nothing to click. The plugin now has its own entry there (`plugins.item`, titled after the panel), and opening it shows the card already expanded; the card on the bundle page is unchanged.
-- **On a long session the curtain's drop could be over before it was ever seen**: opening the curtain re-lays out the whole list at the curtain's width, and on a long session that commit is a long task in itself, so an animation clock started inside it had already run its 0.46s before the first frame painted. The animation is now re-armed once the open state is in the DOM (paying that layout first, then starting the clock).
+- **On the 0.1.7 line the Plugins page had no configuration entry for this plugin**: 0.1.7 removed the whole Settings → Plugins → Plugin configuration page, leaving the configuration card on the bundle page alone (`plugins.bundle.config`, keyed on the npm package name), with no entry for this plugin in the Plugins page's Official group — the settings were unreachable from there. The package now also registers `plugins.item` (`id` `quick-toc`, `order` 50, titled after the panel), and opening that entry shows the card already expanded (both 0.1.7 seats render it with a `view`, so the card starts open there; the rc line's Plugin configuration cell passes no props and keeps the collapsed card list).
+- **Opening the curtain could play its whole drop animation before any of it was seen**: opening the curtain re-lays out the list at the curtain's width, and on a long session that commit is itself a long task, so an animation clock started together with it had already run its 0.46s by the first painted frame (0.7.4 fixed another cause of the same failure: the auto-loader pulling the whole session in at once). The animation is now re-armed once the open state is in the DOM — that layout finishes first, the clock starts after it.
 
 ## [0.7.6] - 2026-09-24
 

package/CHANGELOG.md

@@ -2,11 +2,24 @@
 
 **dsh-quick-toc** 的重要变更都记录在这里。英文版见 [CHANGELOG.en.md](CHANGELOG.en.md)。
 
+## [0.7.9] - 2026-09-28
+
+### 修复
+- **系统开启「减少动态效果」（Windows 的「动画效果」）时，幕布的展开与收起没有动画**：幕布会直接出现、直接收回，读者看不到展开与收起的过程。现在幕布始终播放展开与收起这两段动画，插件其余动效仍遵循该系统设置。
+
+## [0.7.8] - 2026-09-27
+
+### 变更
+- **支持 DSH 0.1.7-rc.2**：与 rc.1 共用同一套插件接口（配置卡片仍挂在 `plugins.item`、`plugins.bundle.config` 与 rc 线的 `settings.plugin.item` 上，设置服务仍是 `configForms`，插件管理页的槽位契约与 rc.1 逐字节相同），代码无需改动；隔离环境里逐项实测通过（宿主启动、插件运行状态、插件页条目与卡片、卡片写入落到设置文档、会话、面板与幕布）。
+
+### 修复
+- **幕布打开搜索栏时不再逐帧重排大纲**：搜索栏原本过渡自己的宽度，而大纲是与它同行的伸缩项，于是每一帧都要重排整个已渲染列表（34 行的列表实测：每帧一次宽度步进、约 18ms 一帧、首帧卡顿 76ms；列表越长越重）。现在布局只翻转一次，位移交给 transform（搜索栏从右缘外滑入，大纲反向翻转回原位置再释放），实测首帧卡顿降到 32ms 以内，静止时的几何与之前完全一致。
+
 ## [0.7.7] - 2026-09-27
 
 ### 修复
-- **0.1.7 线上设置卡片不见了**：0.1.7 把「设置 → 插件 → 插件配置」整块从宿主里去掉（那条线上只有侧边栏「插件」页），卡片原本只挂在 bundle 页上，读者在插件页的「官方」分组里找不到它。现在插件在那里有自己的条目（`plugins.item`，标题取面板名），点进去卡片直接展开；bundle 页上的卡片照旧。
-- **长会话里幕布的展开动画可能整段跑完才被看到**：打开幕布会让列表按幕布的宽度整体重排，这一次提交本身就是一段长任务，动画时钟若从这次提交里开始计时，0.46 秒会在首帧画出来之前走完。现在动画在打开状态写入 DOM 之后重新点火一次（先付掉这次布局，再开始计时）。
+- **0.1.7 线上插件页缺少本插件的配置入口**：0.1.7 移除了「设置 → 插件 → 插件配置」整页，配置卡片只剩组合包页面上的 `plugins.bundle.config`（以 npm 包名为键）一处，插件页「官方」分组里没有本插件的条目，读者在那里找不到设置入口。现在同时注册 `plugins.item`（`id` 为 `quick-toc`、`order` 50、标题取面板名），点开该条目即见已展开的卡片（0.1.7 的两处座位渲染时都带 `view`，卡片因此默认展开；rc 线「插件配置」里那处不带 props，仍是收拢的卡片列表）。
+- **打开幕布时展开动画可能整段播完才被看到**：打开幕布会让列表按幕布的宽度整体重排，长会话里这次提交本身就是一段长任务，动画时钟若与这次提交同时开始，0.46 秒会在首帧绘制之前走完（0.7.4 修的是同一类问题的另一种成因：当时是自动加载把整段会话一次性拉了进来）。现在动画在打开状态写入 DOM 之后重新点火一次，先完成这次布局再开始计时。
 
 ## [0.7.6] - 2026-09-24
 

package/README.en.md

@@ -42,7 +42,7 @@ A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/
 
 | Plugin | Supported DSH |
 | --- | --- |
-| **0.7.x** (latest, 0.7.7) | 0.1.5-rc.3, 0.1.7-alpha.1, 0.1.7-alpha.2, 0.1.7-rc.1 |
+| **0.7.x** (latest, 0.7.9) | 0.1.5-rc.3, 0.1.7-alpha.1, 0.1.7-alpha.2, 0.1.7-rc.1, 0.1.7-rc.2 |
 | 0.6.x (0.6.3) | 0.1.5-rc.1, 0.1.5-rc.2 |
 | 0.5.x (0.5.1) | 0.1.5-rc.1, 0.1.5-rc.2 |
 | 0.4.x (0.4.1) | 0.1.5-rc.1, 0.1.5-rc.2 |

package/README.md

@@ -42,7 +42,7 @@
 
 | 插件版本 | 支持的 DSH 版本 |
 | --- | --- |
-| **0.7.x**（最新，0.7.7） | 0.1.5-rc.3、0.1.7-alpha.1、0.1.7-alpha.2、0.1.7-rc.1 |
+| **0.7.x**（最新，0.7.9） | 0.1.5-rc.3、0.1.7-alpha.1、0.1.7-alpha.2、0.1.7-rc.1、0.1.7-rc.2 |
 | 0.6.x（0.6.3） | 0.1.5-rc.1、0.1.5-rc.2 |
 | 0.5.x（0.5.1） | 0.1.5-rc.1、0.1.5-rc.2 |
 | 0.4.x（0.4.1） | 0.1.5-rc.1、0.1.5-rc.2 |

package/lib/client.js

@@ -2414,6 +2414,75 @@ window.__ModuleLoader__.load({
         try { searchRef.current.focus({ preventScroll: true }); }
         catch (e) { searchRef.current.focus(); }
       }, [searchOpen]);
+      // ---- the curtain's search column: its own box, and the motion that moves it --------
+      // `sheetColW` is how much of the curtain's row the search column claims, and it is
+      // computed HERE (not where the column is built) so the flip effect below keeps a stable
+      // hook list on an empty conversation too — the panel bails out further down, and a hook
+      // added after that point would change the hook count between renders (React #310).
+      var searchColRef = react.useRef(null);
+      var searchGeomRef = react.useRef(null);
+      var sheetColW = (searchOpen || searchAnim === "out") ? SHEET_SEARCH_W : 0;
+      // The column used to animate its own WIDTH, and because the outline is the flex sibling
+      // that grows into the rest of the row, every frame of that re-laid out every rendered row
+      // (measured on a 34-row list: a width step per frame, ~18ms frames and a 76ms first hitch;
+      // the cost grows with the list, which is what made opening search on a long session feel
+      // stuck). The layout now flips in ONE commit — that single reflow is unavoidable, the text
+      // has to re-wrap — and the movement rides on transforms, which the compositor owns:
+      //   * opening: the column starts parked off the right edge and slides home, while the list
+      //     is flipped back to where it sat before the flip and released, so the outline still
+      //     travels left into place instead of jumping there;
+      //   * closing: the column keeps its box for the exit and slides off first (the box only
+      //     collapses when the exit state ends), then the list is flipped back to full width the
+      //     same way.
+      // Both elements are measured, never derived: the flip is the previous box minus the new one.
+      react.useLayoutEffect(function () {
+        var list = listRef.current;
+        var col = searchColRef.current;
+        if (!sheetOpen || !list || !col) { searchGeomRef.current = null; return undefined; }
+        // `offsetLeft` is the box's own position: layout, never a transform. A rect here would
+        // read back the very transform this effect applies, and the next commit would "flip"
+        // from the parked position it just created (measured: the list swung 110px past its
+        // resting spot and eased back).
+        var layoutLeft = list.offsetLeft;
+        var colLayout = sheetColW > 0;                       // the layout currently on screen
+        var wantOpen = !!searchOpen && searchAnim !== "out"; // "out" is the exit in flight
+        var colWidth = col.getBoundingClientRect().width;
+        var prev = searchGeomRef.current;
+        if (prev && prev.colLayout !== colLayout) {
+          // the layout flipped under the reader: put the list back where it was, then release it
+          var dx = prev.layoutLeft - layoutLeft;
+          if (dx !== 0) {
+            list.style.transition = "none";
+            list.style.transform = "translateX(" + dx + "px)";
+            requestAnimationFrame(function () {
+              list.style.transition = "transform 0.24s " + EASE;
+              list.style.transform = "";
+              setTimeout(function () { list.style.transition = ""; }, 320);
+            });
+          }
+        }
+        if (prev && prev.wantOpen !== wantOpen) {
+          if (wantOpen) {
+            // parked just off the row's right edge, then slid home by the transition
+            col.style.transition = "none";
+            col.style.transform = "translateX(" + (colWidth || SHEET_SEARCH_W) + "px)";
+            requestAnimationFrame(function () {
+              col.style.transition = "transform 0.24s " + EASE;
+              col.style.transform = "";
+            });
+          } else {
+            // out it goes while its box is still there; the box collapses when the exit ends
+            col.style.transition = "transform 0.24s " + EASE;
+            col.style.transform = "translateX(" + (colWidth || SHEET_SEARCH_W) + "px)";
+          }
+        }
+        if (colWidth === 0) {
+          col.style.transition = "none";
+          col.style.transform = "";
+        }
+        searchGeomRef.current = { colLayout: colLayout, layoutLeft: layoutLeft, wantOpen: wantOpen };
+        return undefined;
+      }, [sheetOpen, sheetColW, searchOpen, searchAnim]);
       var onQueryChange = function (v) {
         setQuery(v);
         setMatchIdx(0);
@@ -5536,12 +5605,11 @@ window.__ModuleLoader__.load({
       });
       // ---- curtain search column: pushed in from the right edge -----------------
       // The panel's own search box and its two buttons, then the hits below them.
-      // Only the column's WIDTH animates (0 <-> 360) so the outline is pushed left
-      // instead of jumped; an inner box keeps the full width so the content never
-      // squashes while the column narrows, and the column is always mounted while the
-      // curtain is up so both directions animate.
-      var sheetColW = (searchOpen || searchAnim === "out") ? SHEET_SEARCH_W : 0;
+      // The column's WIDTH is what makes room (see `sheetColW` above), an inner box keeps the
+      // full width so the content never squashes while the column narrows, and the column is
+      // always mounted while the curtain is up so both directions animate.
       var sheetSearchColEl = sheetOpen ? react_jsx_runtime.jsx("div", {
+        ref: searchColRef,
         className: "dqt-sheet-search",
         "data-sheet-search": sheetColW > 0 ? "on" : undefined,
         style: {
@@ -5549,8 +5617,7 @@ window.__ModuleLoader__.load({
           width: sheetColW,
           overflow: "hidden",
           minHeight: 0,
-          borderLeft: sheetColW > 0 ? "1px solid " + C.panelBorder : "none",
-          transition: "width 0.24s " + EASE + ", border-color 0.24s " + EASE
+          borderLeft: sheetColW > 0 ? "1px solid " + C.panelBorder : "none"
         },
         children: react_jsx_runtime.jsx("div", {
           style: { width: SHEET_SEARCH_W, height: "100%", display: "flex", flexDirection: "column", minHeight: 0 },
@@ -7535,7 +7602,12 @@ window.__ModuleLoader__.load({
         "@keyframes dqt-sheet-out{from{transform:translateY(0)}to{transform:translateY(-100%)}}" +
         ".dqt-sheet-open{animation:dqt-sheet-in 0.46s cubic-bezier(0.22, 0.9, 0.3, 1) both;will-change:transform}" +
         ".dqt-sheet-closing{animation:dqt-sheet-out 0.3s cubic-bezier(0.4, 0, 1, 1) both;pointer-events:none;will-change:transform}" +
-        "@media (prefers-reduced-motion: reduce){.dqt-sheet-open,.dqt-sheet-closing{animation:none}}" +
+        // The curtain's own drop and retract are deliberately NOT gated on
+        // `prefers-reduced-motion`: with the host system's animations switched off (Windows
+        // "animation effects", which is what Chromium reports as reduce) the curtain used to
+        // appear and vanish with no motion at all — reported three times, and the reader wants
+        // the movement itself. Every other animation this plugin owns still honours the
+        // preference (see the droplet and the mode cross-fade below).
         // The curtain handle is a droplet resting on the view-tab strip's lower line:
         // its silhouette flares into two concave fillets at the line (surface tension,
         // not a detached pill). It grows out of the line when it appears — after a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-quick-toc",
-  "version": "0.7.7",
+  "version": "0.7.9",
   "description": "Conversation TOC for DeepSeek Harness (DSH): a whole-session, turn-grouped Markdown outline with hover previews, a level filter, a full-width curtain, jump-to-end buttons, title/full-text/cross-session search and a Chinese/English interface.",
   "type": "module",
   "main": "lib/index.js",
@@ -38,7 +38,8 @@
         "0.1.5-rc.3": "compatible",
         "0.1.7-alpha.1": "compatible",
         "0.1.7-alpha.2": "compatible",
-        "0.1.7-rc.1": "compatible"
+        "0.1.7-rc.1": "compatible",
+        "0.1.7-rc.2": "compatible"
       }
     }
   },