dsh-quick-toc 0.7.3 → 0.7.4

package/CHANGELOG.en.md

@@ -2,6 +2,14 @@
 
 All notable changes to **dsh-quick-toc** are documented here. Chinese version: [CHANGELOG.md](CHANGELOG.md).
 
+## [0.7.4] - 2026-09-23
+
+### Fixed
+- **Opening the curtain had no animation on a long session**: opening the curtain made the outline's own auto-loader pull the whole session in at once (measured: DOM nodes 1365 to 46150, single long tasks of 275-897ms), so the curtain's 0.46s drop was over before a frame of it could paint. Automatic loading now requires a real reader gesture (a wheel tick on the list, a key on the panel, a press on the list); a geometric coincidence (a short list that happens to fit, a freshly opened curtain, a resized window) is no longer treated as a load request.
+- **Switching the dock made the panel disappear on one side and slide in from the other**: the switch moved `left`, which is not in the transition list, so the box teleported while only the offset was tweened. The panel now always sits on one fixed anchor, and its open, collapsed, either-dock and curtain-handoff positions are all offsets on that anchor, so a dock switch is a pure translate animation.
+- **The collapsed panel came to rest left of the position it opens from (8px on the left dock)**: the collapse clip was a fixed panel width (plus 8px on the left dock) while the box actually travelled a panel width plus 16px, so the visible edge drifted. The clip now matches the travel, which keeps the visible edge on the panel's own open edge line all the way out, the same on both docks.
+- **A collapse occasionally came to rest in the wrong place**: the host re-measures the conversation area while the collapse is running, which moves the line the panel aims at (measured: the tuck-in landed at 1396 instead of 1526). The open-to-closed step now freezes the geometry that collapse started with; the next open reads the area afresh.
+
 ## [0.7.3] - 2026-09-23
 
 ### Changed

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 **dsh-quick-toc** 的重要变更都记录在这里。英文版见 [CHANGELOG.en.md](CHANGELOG.en.md)。
 
+## [0.7.4] - 2026-09-23
+
+### 修复
+- **长会话里打开幕布没有展开动画**：打开幕布时，本插件自己的自动加载把整段会话一次性拉了进来（实测 DOM 节点 1365 → 46150、单帧长任务 275–897ms），0.46 秒的展开动画在第一帧画出来之前就播完了。自动加载现在必须由读者的真实操作触发（列表上的滚轮、面板上的按键、在列表上按下），几何上的巧合（短列表恰好装得下、刚打开幕布、窗口改变尺寸）不再被当成加载请求。
+- **切换停靠边时面板先消失、再从另一边滑出来**：切换原本移动 `left`，而 `left` 不在过渡列表里——盒子瞬移，只有位移在补间。面板现在始终停在一个固定锚点上，展开、收起、两个停靠边、交给幕布这四个位置都是锚点上的位移，切换停靠边是一段纯位移动画。
+- **收起后停的位置比展开位置偏左（左停靠实测 8px）**：收起的裁剪量原本是面板宽度（左停靠另加 8px），与盒子真正滑动的距离（左停靠为面板宽度 + 16px）不相等，可见边一路漂移。裁剪量改为与实际滑动距离一致后，可见边全程钉在面板自己那条开合线上，左右停靠对称。
+- **收起时偶尔收偏**：宿主会在收起动画途中重新测量会话区，目标线随之改变（实测收进去的位置从 1526 跑到 1396）。收起开始的那一步现在冻结本次动画使用的几何，之后再展开才读取新几何。
+
 ## [0.7.3] - 2026-09-23
 
 ### 变更

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.3) | 0.1.5-rc.1, 0.1.5-rc.2, 0.1.5-rc.3, 0.1.7-alpha.1, 0.1.7-alpha.2 |
+| **0.7.x** (latest, 0.7.4) | 0.1.5-rc.1, 0.1.5-rc.2, 0.1.5-rc.3, 0.1.7-alpha.1, 0.1.7-alpha.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.3） | 0.1.5-rc.1、0.1.5-rc.2、0.1.5-rc.3、0.1.7-alpha.1、0.1.7-alpha.2 |
+| **0.7.x**（最新，0.7.4） | 0.1.5-rc.1、0.1.5-rc.2、0.1.5-rc.3、0.1.7-alpha.1、0.1.7-alpha.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

@@ -51,6 +51,10 @@ window.__ModuleLoader__.load({
     // panel's own collapse duration (0.28s) plus a hair, so the curtain's drop only
     // starts once the panel has actually finished travelling.
     var PANEL_TUCK_MS = 300;
+    // How long a collapse keeps the edge it started from (see the geometry block): the
+    // panel's collapse takes 0.28s, and the host can re-measure the conversation area at
+    // any point while it runs, so the freeze outlives the motion by a frame or two.
+    var COLLAPSE_HOLD_MS = 420;
     // The row-end control ("jump to the end of this section") lives in the last 24px
     // of a row (a 20px button inset 4px). Every box a row can paint — the hover
     // highlight, a group header's hover label, the right-aligned context text — stops
@@ -1719,8 +1723,16 @@ window.__ModuleLoader__.load({
       var autoWatchRef = react.useRef(null);   // did the pull we started actually land? (fallback click)
       var autoProbeRef = react.useRef(0);      // throttle for the on-scroll approach probe
       var autoStampRef = react.useRef(0);
+      var autoGestureRef = react.useRef(0);    // last REAL reader gesture on the outline list
       var autoLoadRef = react.useRef(true);
       var panelVisibleRef = react.useRef(true);
+      // A collapse keeps the geometry it started with: the host re-measures the
+      // conversation area while our panel is sliding away, and reading the new numbers
+      // live moves the line the panel tucks into — it then settles somewhere other than
+      // the line it slid out from. While a collapse runs, the edge it aims at is frozen.
+      var geoOpenRef = react.useRef(null);
+      var geoHoldRef = react.useRef(0);
+      var geoSnapRef = react.useRef(null);
       // The reader's place in the outline: sampled by the scroll handler and right
       // before any change of our own, restored in a LAYOUT effect (see the paging
       // block). `anchorHintRef` remembers where the visible boundary was, so finding it
@@ -2586,6 +2598,15 @@ window.__ModuleLoader__.load({
       var AUTO_WAIT_MS = 40;         // beat while a page is in flight: the host is the limit
       var AUTO_BURST_MAX = 60;       // runaway guard only: a long gap must stay walkable
       var AUTO_BURST_IDLE_MS = 3000; // quiet this long and the budget is fresh again
+      // Loading is something the READER asks for, so every automatic pull must be
+      // answered by a real gesture (a wheel tick, a press, a key) within this window.
+      // Purely geometric triggers — a freshly laid out list whose few rows all fit the
+      // box, a panel/curtain opened, a window resized — look exactly like "an unloaded
+      // turn is in view" without anyone having asked: opening the curtain once made this
+      // loader call `loadThrough` on the first ghost it found, which materialised the
+      // rest of the session (46k nodes, 300–900ms long tasks) before the curtain's own
+      // 0.46s drop animation could paint. A gesture-gated loader cannot do that.
+      var AUTO_GESTURE_MS = 1500;
       var ghostInView = function (el) {
         var ghosts = el.querySelectorAll("[data-ghost-turn]");
         if (ghosts.length === 0) return null;
@@ -2728,6 +2749,10 @@ window.__ModuleLoader__.load({
           return true;
         }
         if (historyExhausted(face)) return false;
+        // Nothing the reader did — no wheel, no press, no key — since the window above:
+        // a geometric coincidence (a fresh list that happens to fit, a newly opened
+        // curtain, a resized window) is not a request to load history.
+        if (Date.now() - autoGestureRef.current > AUTO_GESTURE_MS) return false;
         // A ghost the reader can actually see, or the gap coming up on them.
         if (ghostTurn !== null || frontierApproaching(el)) {
           // ARRIVED at an unloaded turn: cover it in one host call (`loadThrough`), which is
@@ -2815,6 +2840,7 @@ window.__ModuleLoader__.load({
       // always refreshes older turns, even without a visible scrollbar
       var onListWheel = function (e) {
         outlineTouchRef.current = Date.now();
+        autoGestureRef.current = Date.now();   // a wheel tick is a reader gesture
         var el = listRef.current;
         if (!el) return;
         hoverEnd();
@@ -3964,9 +3990,23 @@ window.__ModuleLoader__.load({
       // ---- nothing to show without headings ----
       if (groups.length === 0) return null;
 
-      // ---- geometry: always position by `left` (px) so dock-switch & slide share one animated transition
-      // (The scale preference leaves all of this alone: it acts on the panel's inner
-      // box, so the panel itself keeps the width and height the reader dragged.)
+      // ---- geometry: ONE parked anchor; the dock side lives in the transform --------------
+      // The box is parked at a single spot — off-area to the LEFT of the conversation — and
+      // every position the panel takes (open, collapsed on either dock, handed to the
+      // curtain) is a `transform` offset from there. Two reasons:
+      //  * a dock switch then animates the TRANSFORM alone, so the panel travels across the
+      //    screen on the compositor. Docking used to move `left` (which is not in the
+      //    transition list): the box teleported to the other side while only the transform
+      //    animated, so the panel vanished on one side and slid in from the other.
+      //  * `left` must never be animated: it re-lays out the whole panel — header, toolbar
+      //    and every rendered row — on every frame, and with a long session loaded that
+      //    layout cannot keep up (the wipe ran while the slide stalled, and the panel
+      //    flickered). Adding `left` to the transition for a dock switch was measured as
+      //    "very laggy and flashing" for exactly this reason.
+      // The COLLAPSED spot is per dock (left: the anchor itself; right: one panel width past
+      // the open position), which is what makes the collapse fly out toward its own edge.
+      // (The scale preference leaves all of this alone: it acts on the panel's inner box,
+      // so the panel itself keeps the width and height the reader dragged.)
       var dockRight = dock === "right";
       // Keep the OPEN panel inside the window whatever the conversation area does.
       // The area is the host's to move: its transcript width grips rewrite the
@@ -3980,27 +4020,48 @@ window.__ModuleLoader__.load({
         return Math.max(8, Math.min(Math.max(8, window.innerWidth - panelW - 8), x));
       };
       // While the panel is being handed over to (or back from) the curtain it is
-      // rendered at its COLLAPSED geometry, so the same left/clip transition that
+      // rendered at its COLLAPSED geometry, so the same transform/clip transition that
       // serves open/collapse also serves the handoff: no teleport, no flash.
       var geoOpen = open && !panelAside;
-      // The box is always PARKED at its collapsed spot and the open state is a transform
-      // offset on top of it (see panelTransition): same visual geometry as before, but the
-      // slide is compositable. `openLeft` is the clamped open position, `parkedLeft` the
-      // off-area spot the collapsed panel occupies.
-      var openLeft, parkedLeft;
+      var anchorLeft = viewport ? viewport.left - panelW - 8 : -(panelW + 48);
+      var openLeft;
       if (dockRight) {
         // RIGHT dock: keep the panel's VISIBLE right edge pinned at the SAME
         // line when collapsed as when expanded (the expand edge is correct).
         var openRight = window.innerWidth - (viewport ? viewport.right + 48 : 60) - panelW;
         openLeft = clampLeft(openRight);
-        parkedLeft = openRight + panelW;
       } else {
         // LEFT dock open (left dock is the confirmed-correct reference — untouched)
         openLeft = clampLeft(viewport ? viewport.left + 8 : 8);
-        parkedLeft = (viewport ? viewport.left - panelW - 8 : -(panelW + 48));
       }
-      var panelLeft = parkedLeft;
-      var panelOffset = geoOpen ? (openLeft - parkedLeft) : 0;
+      // A collapse finishes at the line it started from. The area we park against can be
+      // re-measured while the panel is still sliding away — the host rewrites it when the
+      // transcript lays out, and the window itself can change — and aiming at the new
+      // numbers mid-flight lands the panel somewhere other than the edge it came out of
+      // (measured: with the area re-measured during the collapse, the last visible strip
+      // sat at 1396 instead of the 1526 line the panel had slid out from). So the
+      // open -> closed step freezes the edge the collapse heads for, and the next open —
+      // which reads the area afresh — picks up the new geometry. A dock switch cancels the
+      // freeze: that is the reader asking for the other side, not a re-measure. The first
+      // render arms nothing: a panel that was never open has no edge to hold, and pinning
+      // the pre-measurement fallback would leave the closed box where no such panel goes.
+      if (geoOpenRef.current === null) {
+        geoOpenRef.current = geoOpen;
+      } else if (geoOpenRef.current !== geoOpen) {
+        geoOpenRef.current = geoOpen;
+        geoHoldRef.current = geoOpen ? 0 : Date.now() + COLLAPSE_HOLD_MS;
+        geoSnapRef.current = geoOpen ? null : { anchorLeft: anchorLeft, openLeft: openLeft, dock: dock };
+      }
+      var geoFrozen = geoSnapRef.current !== null && geoSnapRef.current.dock === dock
+        && Date.now() < geoHoldRef.current;
+      if (geoFrozen) {
+        anchorLeft = geoSnapRef.current.anchorLeft;
+        openLeft = geoSnapRef.current.openLeft;
+      }
+      var openOffset = openLeft - anchorLeft;
+      var parkedOffset = dockRight ? (openLeft + panelW) - anchorLeft : 0;
+      var panelLeft = anchorLeft;
+      var panelOffset = geoOpen ? openOffset : parkedOffset;
       var panelTransform = panelOffset === 0 ? "none" : "translateX(" + zLen(panelOffset) + ")";
       var vMaxH = viewport ? Math.max(200, viewport.height - 28) : "72vh";
       // same reasoning vertically: the draggable offset is stored in localStorage
@@ -4653,6 +4714,8 @@ window.__ModuleLoader__.load({
         // the search box owns its own keys (it stops propagation for the ones it uses)
         if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT" || (target && target.isContentEditable)) return;
         if (e.altKey || e.ctrlKey || e.metaKey) return;
+        // a key on the panel is a reader gesture: the auto-loader may act on it
+        autoGestureRef.current = Date.now();
         var key = e.key;
         if (key === "ArrowDown" || key === "ArrowUp") {
           swallow(e);
@@ -4752,13 +4815,22 @@ window.__ModuleLoader__.load({
       //  right dock -> clipped from the right at the screen/sidebar line
       // LEFT dock keeps its original clip (collapse left). RIGHT dock clips the
       // LEFT side so the panel closes toward its right (dock) edge in place.
+      //
+      // The inset is the distance the box actually TRAVELS, not the panel's width. The
+      // visible edge of the panel is the clip edge, and that edge is `box.left + inset`
+      // (left dock) / `box.right - inset` (right dock) while the box slides; matching the
+      // inset to the travel makes the two move at the same rate, so the edge stays pinned
+      // on the panel's OWN open edge line the whole way out. With a fixed `panelW + 8`
+      // against a `panelW + 16` travel the edge drifted 8px past that line, which the
+      // reader saw as the panel tucking in slightly left of where it comes back out.
+      var travelPx = Math.abs(openOffset - parkedOffset);
       var panelClip = "inset(0 0 0 0px)";
       if (!geoOpen) {
         if (dockRight) {
           // mirror of LEFT: clip the RIGHT side (panel flies right, shrinking from its right)
-          panelClip = "inset(0 " + zLen(panelW) + " 0 0)";
+          panelClip = "inset(0 " + zLen(travelPx) + " 0 0)";
         } else {
-          panelClip = "inset(0 0 0 " + zLen(panelW + 8) + ")";
+          panelClip = "inset(0 0 0 " + zLen(travelPx) + ")";
         }
       }
       // faded out entirely while another center-column view is active
@@ -5434,6 +5506,9 @@ window.__ModuleLoader__.load({
         },
         onScroll: onListScroll,
         onWheel: onListWheel,
+        // a press on a row (or on the list) is a reader gesture too: click-to-load an
+        // unloaded row and drag-scrolling must both keep working
+        onPointerDown: function () { autoGestureRef.current = Date.now(); },
         children: react_jsx_runtime.jsx("div", {
           // the two-phase cross-fade of the questions-only switch rides on this
           // wrapper (classes, never inline animation: React rewrites inline styles

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-quick-toc",
-  "version": "0.7.3",
+  "version": "0.7.4",
   "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",