dsh-quick-toc 0.8.0 → 0.8.2

package/CHANGELOG.en.md

@@ -2,6 +2,19 @@
 
 All notable changes to **dsh-quick-toc** are documented here. Chinese version: [CHANGELOG.md](CHANGELOG.md).
 
+## [0.8.2] - 2026-09-29
+
+### Changed
+- **DSH 0.2.0-rc.2 support**: no code changed; the new prerelease is registered in the compatibility declaration. An isolated environment was exercised point by point (the host starts without a warning, the Plugins page entry and its configuration card, the card's write landing in the settings document, the outline panel's hover and pin, a clean console).
+
+## [0.8.1] - 2026-09-29
+
+### Fixed
+- **The pin on the hover preview could not be clicked**: moving from an outline row towards the card started the fade first, so the card was gone before the pin was reached. Leaving a row now only arms the close, and reaching the card cancels it.
+
+### Changed
+- **The collapsed handle took room from the text in a narrow window**: below a 760-pixel conversation column the collapsed side handle slides back into the divider; the droplet above stays as the way into the outline, and the side handle returns when the window widens.
+
 ## [0.8.0] - 2026-09-29
 
 ### Changed

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 **dsh-quick-toc** 的重要变更都记录在这里。英文版见 [CHANGELOG.en.md](CHANGELOG.en.md)。
 
+## [0.8.2] - 2026-09-29
+
+### 变更
+- **支持 DSH 0.2.0-rc.2**：插件代码未改动，兼容性声明里登记了新的预发布版本；隔离环境里逐项实测通过（宿主启动无告警、插件页条目与配置卡片、卡片写入落到设置文档、大纲面板的悬停与钉住、控制台无错误）。
+
+## [0.8.1] - 2026-09-29
+
+### 修复
+- **悬停预览卡上的图钉无法点击**：鼠标从大纲行移向卡片时会先开始淡出，卡片在图钉被点到之前就已经消失。现在离开行只是预备关闭，指针落到卡片上即取消。
+
+### 变更
+- **窄窗口下折叠把手占用正文**：对话区域宽度不足 760 像素时，折叠态的侧边把手滑回分隔线内；顶部的水滴把手保留，作为打开大纲的入口，窗口变宽后侧边把手自动回来。
+
 ## [0.8.0] - 2026-09-29
 
 ### 变更

package/README.en.md

@@ -42,8 +42,8 @@ A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/
 
 | Plugin | Supported DSH |
 | --- | --- |
-| **0.8.x** (latest, 0.8.0) | 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.2.0-rc.1 |
-| 0.7.x (0.7.14) | 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.2.0-rc.1 |
+| **0.8.x** (latest, 0.8.2) | 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.2.0-rc.1, 0.2.0-rc.2 |
+| 0.7.x (0.7.14) | 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.2.0-rc.1, 0.2.0-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,8 +42,8 @@
 
 | 插件版本 | 支持的 DSH 版本 |
 | --- | --- |
-| **0.8.x**（最新，0.8.0） | 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.2.0-rc.1 |
-| 0.7.x（0.7.14） | 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.2.0-rc.1 |
+| **0.8.x**（最新，0.8.2） | 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.2.0-rc.1、0.2.0-rc.2 |
+| 0.7.x（0.7.14） | 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.2.0-rc.1、0.2.0-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

@@ -44,6 +44,11 @@ window.__ModuleLoader__.load({
     var Z_PANEL = 14;  // the docked panel
     var Z_SHEET = 16;  // the curtain, which replaces the docked panel while it is up
     var Z_HOVER = 18;  // hover preview card: above both, still inside the free band
+    // A narrow conversation column has no room for a handle floating over the text: below
+    // NARROW_CONV_W the collapsed-panel handle slides back into the divider (its usual
+    // motion) while the droplet above the conversation stays as the way in. Nothing opens
+    // by itself — a resize never overrides the reader's own choice of surface.
+    var NARROW_CONV_W = 760;
     var Z_ERROR = 32;  // crash banner: above our layers and the app's chrome, below
                        // DSH's popovers (100) and modals (1000)
     var EASE = "cubic-bezier(0.22, 0.9, 0.3, 1)"; // smooth non-linear slide
@@ -1574,6 +1579,10 @@ window.__ModuleLoader__.load({
       var _s2 = react.useState(null);
       var viewport = _s2[0];
       var setViewport = _s2[1];
+      // how much room the conversation column itself has (the thing a docked panel
+      // squeezes); 0 while it has not been measured yet, which never counts as narrow
+      var convWidth = viewport ? Math.max(0, window.innerWidth - viewport.left - viewport.right) : 0;
+      var narrowWindow = convWidth > 0 && convWidth < NARROW_CONV_W;
       react.useEffect(function () {
         // Self-healing, because the layout AROUND the conversation can change without
         // a resize: the host's own controls move that column about (measured in a real
@@ -1818,7 +1827,7 @@ window.__ModuleLoader__.load({
       var scrollToBottom = function (e) {
         if (e && e.stopPropagation) e.stopPropagation();
         outlineTouchRef.current = Date.now();
-        hoverEnd();
+        hoverEnd(true);
         var el = listRef.current;
         if (!el) return;
         // optimistic: the list is on its way to the newest row, so the button starts
@@ -1904,7 +1913,7 @@ window.__ModuleLoader__.load({
       var backToBrowse = function (e) {
         if (e && e.stopPropagation) e.stopPropagation();
         outlineTouchRef.current = Date.now();
-        hoverEnd();
+        hoverEnd(true);
         var el = listRef.current;
         var tgt = liveTgt();
         if (!el || !tgt) return;
@@ -1970,6 +1979,17 @@ window.__ModuleLoader__.load({
       var setHoverClosing = _sHovOut[1];
       var hoverTimerRef = react.useRef(null);
       var hoverCloseTimerRef = react.useRef(null);
+      // The card carries the pin button, so the pointer has to be able to travel from the
+      // row onto the card without the card fading on the way. Leaving a row therefore only
+      // ARMS the close; the card's own mouseenter disarms it, and the fade starts after a
+      // grace period that a crossing pointer fits into.
+      var HOVER_GRACE_MS = 260;
+      var hoverGraceTimerRef = react.useRef(null);
+      var disarmHoverClose = function () {
+        if (hoverGraceTimerRef.current) { clearTimeout(hoverGraceTimerRef.current); hoverGraceTimerRef.current = null; }
+        if (hoverCloseTimerRef.current) { clearTimeout(hoverCloseTimerRef.current); hoverCloseTimerRef.current = null; }
+        setHoverClosing(false);
+      };
       var hoverStart = function (info, el) {
         // the hover card is a preference: off means it never opens (the outline rows
         // themselves keep their hover tint)
@@ -1978,11 +1998,7 @@ window.__ModuleLoader__.load({
         hoverTimerRef.current = setTimeout(function () {
           var r = el && el.getBoundingClientRect ? el.getBoundingClientRect() : null;
           if (!r || r.width <= 0) return;
-          if (hoverCloseTimerRef.current) {
-            clearTimeout(hoverCloseTimerRef.current);
-            hoverCloseTimerRef.current = null;
-          }
-          setHoverClosing(false);
+          disarmHoverClose();
           setHoverCard({
             title: info.title,
             sub: info.sub,
@@ -1998,16 +2014,23 @@ window.__ModuleLoader__.load({
           });
         }, 260);
       };
-      // leaving fades the card out instead of dropping it on the next frame
-      var hoverEnd = function () {
+      // leaving fades the card out instead of dropping it on the next frame — but only
+      // after a grace period, because the card carries the pin and the pointer has to be
+      // able to travel from the row onto it (an immediate fade made the pin unreachable).
+      var hoverEnd = function (immediate) {
         if (hoverTimerRef.current) clearTimeout(hoverTimerRef.current);
+        if (hoverGraceTimerRef.current) clearTimeout(hoverGraceTimerRef.current);
         if (hoverCloseTimerRef.current) clearTimeout(hoverCloseTimerRef.current);
-        setHoverClosing(true);
-        hoverCloseTimerRef.current = setTimeout(function () {
-          hoverCloseTimerRef.current = null;
-          setHoverCard(null);
-          setHoverClosing(false);
-        }, 240);
+        var grace = immediate ? 0 : HOVER_GRACE_MS;
+        hoverGraceTimerRef.current = setTimeout(function () {
+          hoverGraceTimerRef.current = null;
+          setHoverClosing(true);
+          hoverCloseTimerRef.current = setTimeout(function () {
+            hoverCloseTimerRef.current = null;
+            setHoverCard(null);
+            setHoverClosing(false);
+          }, 240);
+        }, grace);
       };
 
       // ---- pinned preview + the row menu (0.8.0) --------------------------------
@@ -3128,7 +3151,7 @@ window.__ModuleLoader__.load({
         autoGestureRef.current = Date.now();   // a wheel tick is a reader gesture
         var el = listRef.current;
         if (!el) return;
-        hoverEnd();
+        hoverEnd(true);
         if (e.deltaY >= 0) {
           // still scrolling down at the very end of the outline: say so. Outline
           // mode only — the search list has its own persistent hint line.
@@ -3165,7 +3188,7 @@ window.__ModuleLoader__.load({
         var upward = el.scrollTop < lastScrollTopRef.current - 2;
         if (upward) {
           if (hint === "more") setHint("");
-          if (hoverCard) hoverEnd();
+          if (hoverCard) hoverEnd(true);
         }
         lastScrollTopRef.current = el.scrollTop;
         syncBackBtn(el);   // reached the remembered place by hand? the button is done
@@ -6170,7 +6193,10 @@ window.__ModuleLoader__.load({
       // vanishing ON the divider line. `open` also drives it (fade + slide home) and
       // `edgeGone` keeps the element in the tree until that motion has played.
       var EDGE_W = 26;
-      var edgeShown = !open && handleShown && chatViewActive;
+      // a narrow conversation column leaves no room for a handle floating over the text:
+      // below the threshold it slides back into the divider (its usual motion), while the
+      // droplet above the conversation stays put as the way in
+      var edgeShown = !open && handleShown && chatViewActive && !narrowWindow;
       var edgeLineLeft = viewport ? viewport.left : 0;
       var edgeLineRight = viewport ? viewport.right + 52 : 60;   // clear of the milestone rail
       var edgeEl = (!open || !edgeGone) ? react_jsx_runtime.jsx("div", {
@@ -6455,8 +6481,7 @@ window.__ModuleLoader__.load({
           ref: opts.pinned ? pinnedRef : undefined,
           onMouseEnter: opts.pinned ? undefined : function () {
             // the pointer reached the card: keep it open so its pin can be clicked
-            if (hoverCloseTimerRef.current) { clearTimeout(hoverCloseTimerRef.current); hoverCloseTimerRef.current = null; }
-            setHoverClosing(false);
+            disarmHoverClose();
           },
           onMouseLeave: opts.pinned ? undefined : function () { hoverEnd(); },
           style: {
@@ -6474,9 +6499,10 @@ window.__ModuleLoader__.load({
             // above the panel and the curtain — it is a sibling of both in this
             // portal, and both sit below it in the layer band we claim
             zIndex: Z_HOVER + (opts.pinned ? 1 : 0),
-            // a fading card is inert: it must not swallow the click that dismissed it
-            // (and the pinned card is the only clickable one while it is up)
-            pointerEvents: opts.closing ? "none" : (opts.pinned ? "auto" : "none"),
+            // a fading card is inert: it must not swallow the click that dismissed it.
+            // While it is up the card IS clickable — it carries the pin, and the pointer
+            // has to be able to get there from the row.
+            pointerEvents: opts.closing ? "none" : "auto",
             userSelect: opts.pinned ? "text" : "none"
           },
           children: kids

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-quick-toc",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "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",
@@ -43,7 +43,8 @@
         "0.1.7-alpha.2": "compatible",
         "0.1.7-rc.1": "compatible",
         "0.1.7-rc.2": "compatible",
-        "0.2.0-rc.1": "compatible"
+        "0.2.0-rc.1": "compatible",
+        "0.2.0-rc.2": "compatible"
       }
     }
   },