dsh-quick-toc 0.10.0 → 0.10.2

package/CHANGELOG.en.md

@@ -2,6 +2,29 @@
 
 All notable changes to **dsh-quick-toc** are documented here. Chinese version: [CHANGELOG.md](CHANGELOG.md).
 
+## [0.10.2] - 2026-10-22
+
+### Added
+- **A bookmarks panel on the curtain**: the curtain's toolbar has a bookmarks button on the left, beside the settings button; it slides in from the right in the same drawer the search uses, and the outline stays where it is instead of being replaced.
+
+### Changed
+- **The theme colour reaches more places**: hovering an entry paints its hierarchy guide in the theme colour, the search box takes it as a focus border, the hover preview card carries a theme-coloured bar on its reading side, and a pinned card's ring gets a filled core in the same colour.
+
+### Fixed
+- **The theme colour came out black in a light theme**: with blue chosen, the plugin borrowed the host's accent colour, which is near-black ink in a light theme — so the guides, the search border, the card's bar and the pin's core all turned black. All six colours now use values of the plugin's own.
+- **The curtain's landing bounce opened an unblurred seam along its top edge**: the settle now stretches downward from the top edge, so the top never leaves the line it hangs from.
+
+## [0.10.1] - 2026-10-21
+
+### Fixed
+- **Collapsing and expanding used to land on different spots**: the place the panel came to rest and the place it reappeared from differed slightly; both now sit on the same line.
+- **A narrow window left a strip of the panel behind**: on a narrow window the collapsed panel kept a visible edge; it now clears away completely.
+- **The collapsed handle did not line up with the panel's edge**: the handle sat a little to one side of the panel edge; the two now share a line.
+- **On the right dock the outer shadow arrived before the content**: while expanding, the halo around the panel showed before the content underneath it; both are now clipped together, and the halo settles once the slide is done.
+
+### Changed
+- **A panel wider than the space available now narrows instead**: when the window cannot hold the width that was chosen, the panel narrows sideways and stays against the conversation area's edge rather than being pushed away from it; a wider window brings the chosen width back.
+
 ## [0.10.0] - 2026-10-19
 
 ### Added

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 **dsh-quick-toc** 的重要变更都记录在这里。英文版见 [CHANGELOG.en.md](CHANGELOG.en.md)。
 
+## [0.10.2] - 2026-10-22
+
+### 新增
+- **幕布的书签栏**：幕布的工具行左侧（设置按钮右边）新增一个书签按钮，点开后书签从右侧滑出，与搜索共用同一个抽屉；大纲原地保留，不再被整块替换。
+
+### 变更
+- **主题色覆盖更多位置**：悬停条目时它的层级引导线转为主题色，搜索框聚焦时边框转为主题色，悬停预览卡片的左侧有一条主题色竖条，钉住后的圆环核心也是主题色。
+
+### 修复
+- **浅色主题下主题色显示为黑色**：主题色选蓝色时，插件取用的是宿主界面的强调色，而浅色主题里那个值是近黑色，于是引导线、搜索框描边、卡片竖条与钉住圆环都变黑了；现在六种颜色都使用插件自己的色值。
+- **幕布落下回弹时顶部露出一条没有模糊的缝隙**：回弹改为从顶边向下伸展，顶部不再离开它悬挂的那条线。
+
+## [0.10.1] - 2026-10-21
+
+### 修复
+- **收起与展开的落点不一致**：收起后停下的位置与再次展开时出现的位置略有偏差，现在两者落在同一条线上。
+- **窄窗口下收起后残留一条面板**：窗口较窄时，面板收起后仍会留下一条边，现在完全收起。
+- **收起后的把手与面板边缘未对齐**：收起时把手比面板边缘偏一点，现在两者对齐。
+- **右停靠展开时外框先于内容出现**：展开过程中，面板外圈的阴影会先于内容出现；现在阴影与内容一起裁切，展开完成后再自然铺开。
+
+### 变更
+- **面板宽度超出可用空间时改为收窄**：窗口放不下设定的宽度时，面板会横向收窄并继续贴着对话区边缘，不再被推离边缘；窗口变宽后恢复设定的宽度。
+
 ## [0.10.0] - 2026-10-19
 
 ### 新增

package/README.en.md

@@ -2,7 +2,7 @@
 
 > **English** | [中文](README.md)
 
-A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH): it turns the Markdown headings (H1–H6) of AI replies into a navigable outline — the same list as a side panel or as a full-width curtain — grouped by conversation turn and covering the whole session (including turns that are not loaded yet), with title/prompts/full-text/cross-session search, hover previews, several ways to jump (a heading, a turn header, the end of a section), and a reading position that both follows and is remembered.
+A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH): it turns the Markdown headings (H1–H6) of AI replies into a navigable outline — the same list as a side panel or as a full-width curtain — grouped by conversation turn and covering the whole session (including turns that are not loaded yet), with title/prompts/full-text/cross-session search, hover previews, a right-click menu for jumping and copying, bookmarks with a bookmarks-only view, six theme colours and a translucent material, and a reading position that both follows and is remembered.
 
 ## Features
 
@@ -44,7 +44,7 @@ A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/
 
 | Plugin | Supported DSH |
 | --- | --- |
-| **0.10.x** (latest, 0.10.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.2.0-rc.2, 0.2.1-alpha.1, 0.2.1-alpha.2, 0.2.1-alpha.3, 0.2.1-alpha.4, 0.2.1-alpha.5, 0.2.1-rc.1, 0.2.1-rc.2 |
+| **0.10.x** (latest, 0.10.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.2.1-alpha.1, 0.2.1-alpha.2, 0.2.1-alpha.3, 0.2.1-alpha.4, 0.2.1-alpha.5, 0.2.1-rc.1, 0.2.1-rc.2 |
 | **0.9.x** (0.9.5) | 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.2.1-alpha.1, 0.2.1-alpha.2, 0.2.1-alpha.3, 0.2.1-alpha.4, 0.2.1-alpha.5 |
 | 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 |

package/README.md

@@ -2,7 +2,7 @@
 
 > [English](README.en.md) | **中文**
 
-**DeepSeek Harness（DSH）对话大纲插件**：把 AI 回复中的 Markdown 标题（H1–H6）提取成可导航的大纲——侧边面板与全屏幕布两种大纲视图，按对话回合分组、覆盖整段会话（含尚未加载进窗口的回合），支持标题/提问/全文/跨会话四档检索、悬停预览、多种跳转（点标题、点组头、跳到本节末尾），阅读位置自动跟随并可记住。
+**DeepSeek Harness（DSH）对话大纲插件**：把 AI 回复中的 Markdown 标题（H1–H6）提取成可导航的大纲——侧边面板与全屏幕布两种视图，按对话回合分组、覆盖整段会话（含尚未加载进窗口的回合）。支持标题/提问/全文/跨会话四档检索、悬停预览、右键跳转与复制、书签与「只看书签」视图，六种主题色与半透明材质，阅读位置自动跟随并可记住。
 
 ## 功能
 
@@ -44,7 +44,7 @@
 
 | 插件版本 | 支持的 DSH 版本 |
 | --- | --- |
-| **0.10.x**（最新，0.10.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.2.0-rc.2、0.2.1-alpha.1、0.2.1-alpha.2、0.2.1-alpha.3、0.2.1-alpha.4、0.2.1-alpha.5、0.2.1-rc.1、0.2.1-rc.2 |
+| **0.10.x**（最新，0.10.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.2.1-alpha.1、0.2.1-alpha.2、0.2.1-alpha.3、0.2.1-alpha.4、0.2.1-alpha.5、0.2.1-rc.1、0.2.1-rc.2 |
 | **0.9.x**（0.9.5） | 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.2.1-alpha.1、0.2.1-alpha.2、0.2.1-alpha.3、0.2.1-alpha.4、0.2.1-alpha.5 |
 | 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 |

package/lib/client.js

@@ -179,6 +179,8 @@ window.__ModuleLoader__.load({
         "marks.tip.only": "只看书签（{n}）",
         "marks.tip.all": "显示全部大纲（书签 {n}）",
         "marks.empty": "还没有书签。右键任意条目，选「加入书签」即可。",
+        "marks.title": "书签",
+        "marks.tip.col": "书签栏（{n}）",
         "menu.goto": "跳到这一节",
         "menu.mark": "加入书签",
         "menu.unmark": "移出书签",
@@ -309,6 +311,8 @@ window.__ModuleLoader__.load({
         "marks.tip.only": "Show bookmarks only ({n})",
         "marks.tip.all": "Show the whole outline ({n} bookmarked)",
         "marks.empty": "No bookmarks yet. Right-click any entry and choose \u201cAdd bookmark\u201d.",
+        "marks.title": "Bookmarks",
+        "marks.tip.col": "Bookmarks panel ({n})",
         "menu.goto": "Jump to this section",
         "menu.mark": "Add bookmark",
         "menu.unmark": "Remove bookmark",
@@ -470,7 +474,12 @@ window.__ModuleLoader__.load({
     // triplet with a solid that stays legible on both light and dark surfaces
     // (the dot shows the vivid hue; the solid is the readable one).
     var ACCENTS = {
-      blue: { rgb: "79, 140, 255", solid: null, dot: "#4f8cff" },
+      // Every option is SELF-CONTAINED, blue included. Blue used to borrow the host's
+      // `--dsw-alias-brand-primary`; in a light theme that token is near-black ink, so
+      // picking "blue" painted the hierarchy guides, the search ring, the preview
+      // card's bar and the pin's core BLACK. The theme colour is the plugin's own
+      // decision, so it does not defer to the host's brand token at all.
+      blue: { rgb: "79, 140, 255", solid: "#4F8CFF", dot: "#4f8cff" },
       red: { rgb: "245, 72, 77", solid: "#F5484D", dot: "#F5484D" },
       yellow: { rgb: "232, 162, 12", solid: "#D99300", dot: "#FFB020" },
       green: { rgb: "48, 164, 108", solid: "#2FA36B", dot: "#2FA36B" },
@@ -496,10 +505,13 @@ window.__ModuleLoader__.load({
     // injected base, which keeps today's values as its fallback.
     var accentCssText = function (id) {
       var t = ACCENTS[normAccent(id)] || ACCENTS.blue;
-      var solid = t.solid || "var(--dsw-alias-brand-primary, #4f8cff)";
+      var solid = t.solid || "#4F8CFF";
       return ".dqt-nav{box-shadow:inset 0 0 0 1px " + solid + ";background:rgba(" + t.rgb + ",0.10)}"
         + ".dqt-phead:focus-visible{outline-color:" + solid + "}"
-        + ".dqt-slider{accent-color:" + solid + "}";
+        + ".dqt-slider{accent-color:" + solid + "}"
+        // the search pill takes the theme colour the moment the caret is in it, so the
+        // box and the hit marks below it agree on which search is running
+        + ".dqt-search-pill:focus-within{background:rgba(" + t.rgb + ",0.12);box-shadow:inset 0 0 0 1px " + solid + "}";
     };
     var applyAccentCss = function (id) {
       if (typeof document === "undefined") return;
@@ -2165,7 +2177,10 @@ window.__ModuleLoader__.load({
       panelBorder: "var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.25))",
       text: "var(--dsw-alias-label-primary, #e8eaee)",
       muted: "var(--dsw-alias-label-secondary, #9aa0ab)",
-      accent: "var(--dsw-alias-brand-primary, #4f8cff)",
+      // the plugin's own blue, NOT the host's brand token: that token is near-black
+      // in light themes, and every accent piece (guides, search ring, preview bar,
+      // pin core) turned black with it
+      accent: "#4F8CFF",
       // the selection triplet, for callers that paint their own alphas (search
       // hit marks): same hue as every tint above, in one place
       accentRgb: "79,140,255",
@@ -3160,6 +3175,21 @@ window.__ModuleLoader__.load({
       var _sAside = react.useState(null);
       var panelAside = _sAside[0];
       var setPanelAside = _sAside[1];
+      // The outer halo may only relax to its full bleed once a slide has LANDED. Riding
+      // the same transition let the shadow reach past the panel's own (still clipped)
+      // edge during an expansion, which reads as a frame appearing before the surface.
+      // Declared up here with the other hooks so an early "nothing to show" return never
+      // changes the hook count.
+      var lastLineRef = react.useRef(null);
+      var _sShadowSettled = react.useState(true);
+      var shadowSettled = _sShadowSettled[0];
+      var setShadowSettled = _sShadowSettled[1];
+      var geoOpenNow = open && !panelAside;
+      react.useEffect(function () {
+        if (!geoOpenNow) { setShadowSettled(false); return undefined; }
+        var t = setTimeout(function () { setShadowSettled(true); }, 640);
+        return function () { clearTimeout(t); };
+      }, [geoOpenNow]);
       // The curtain hangs from just BELOW the centre column's view tabs (对话 / 轨迹 /
       // 上下文), not from the top of the scroll container: when those tabs live inside
       // that container, viewport.top sits above them and the curtain would cover them.
@@ -3220,6 +3250,8 @@ window.__ModuleLoader__.load({
         sheetTimerRef.current = setTimeout(function () {
           sheetTimerRef.current = null;
           setSheetOpen(false);
+          // the column only exists across the curtain: a later drop starts closed
+          setMarksCol(false);
           // the panel was open before the curtain: slide it back in instead of
           // letting it pop into place (the reader saw that pop as a flash)
           if (open) setPanelAside("return");
@@ -3643,9 +3675,24 @@ window.__ModuleLoader__.load({
         return function () { clearTimeout(timer); };
       }, [dock, panelY, panelW, panelH, levels, fuzzy]);
 
+      // ---- the curtain's bookmarks column --------------------------------------
+      // ONE drawer, two tenants. The search column is measured and slid from the
+      // right edge (see the flip effect above); the bookmarks ride the very same box,
+      // motion and width, so the curtain needs no second mechanism. Opening either
+      // tenant takes the other's place, and the docked panel keeps its star button
+      // and full-view overlay — there the outline has no column to share.
+      var _sMarksCol = react.useState(false);
+      var marksCol = _sMarksCol[0];
+      var setMarksCol = _sMarksCol[1];
+      var toggleMarksCol = function () {
+        if (marksCol) { setMarksCol(false); return; }
+        setMarksCol(true);
+        if (searchOpen) closeSearch();
+      };
       var openSearch = function () {
         setSearchOpen(true);
         setSearchAnim("enter");
+        if (marksCol) setMarksCol(false);
       };
       var closeSearch = function () {
         setSearchAnim("out");
@@ -3677,7 +3724,7 @@ window.__ModuleLoader__.load({
       // 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;
+      var sheetColW = (searchOpen || marksCol || 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;
@@ -3701,7 +3748,7 @@ window.__ModuleLoader__.load({
         // 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 wantOpen = (!!searchOpen && searchAnim !== "out") || !!marksCol; // "out" is the exit in flight
         var colWidth = col.getBoundingClientRect().width;
         var prev = searchGeomRef.current;
         if (prev && prev.colLayout !== colLayout) {
@@ -3738,7 +3785,7 @@ window.__ModuleLoader__.load({
         }
         searchGeomRef.current = { colLayout: colLayout, layoutLeft: layoutLeft, wantOpen: wantOpen };
         return undefined;
-      }, [sheetOpen, sheetColW, searchOpen, searchAnim]);
+      }, [sheetOpen, sheetColW, searchOpen, searchAnim, marksCol]);
       var onQueryChange = function (v) {
         setQuery(v);
         setMatchIdx(0);
@@ -5421,18 +5468,33 @@ window.__ModuleLoader__.load({
       // (The collapsed panel is parked deliberately outside the area and is hidden
       // by its own clip, so only the open position is clamped.)
       var clampLeft = function (x) {
-        return Math.max(8, Math.min(Math.max(8, window.innerWidth - panelW - 8), x));
+        // clamp against the width the panel will actually be drawn at (geoW, below):
+        // the stored preference can exceed the window, and clamping to THAT put the
+        // open edge in the wrong place
+        return Math.max(8, Math.min(Math.max(8, window.innerWidth - geoW - 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 transform/clip transition that
       // serves open/collapse also serves the handoff: no teleport, no flash.
       var geoOpen = open && !panelAside;
-      var anchorLeft = viewport ? viewport.left - panelW - 8 : -(panelW + 48);
+      // The panel is docked AT the area's edge. When the stored width cannot fit beside
+      // it, the WIDTH gives way for this render — never the position. Moving the open
+      // panel inwards (the old fallback, via clampLeft) both covered the sidebar and
+      // shortened the collapse below the panel's own width, so the tuck line stopped
+      // agreeing with the line the panel came back out of: the panel appeared to close
+      // to one place and reopen from another. The stored preference is untouched, so a
+      // wider window brings the chosen width back.
+      var geoW = Math.max(120, Math.min(panelW,
+        dockRight
+          ? (window.innerWidth - (viewport ? viewport.right + 48 : 60)) - 8
+          : window.innerWidth - (viewport ? viewport.left : 0) - 16));
+      // Parked against the area, one panel width further out.
+      var anchorLeft = viewport ? viewport.left - geoW - 8 : -(geoW + 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;
+        var openRight = window.innerWidth - (viewport ? viewport.right + 48 : 60) - geoW;
         openLeft = clampLeft(openRight);
       } else {
         // LEFT dock open (left dock is the confirmed-correct reference — untouched)
@@ -5455,15 +5517,35 @@ window.__ModuleLoader__.load({
         geoOpenRef.current = geoOpen;
         geoHoldRef.current = geoOpen ? 0 : Date.now() + COLLAPSE_HOLD_MS;
         geoSnapRef.current = geoOpen ? null : { anchorLeft: anchorLeft, openLeft: openLeft, dock: dock };
+        // remember the line it is going into, so the next expansion can come back out
+        // of exactly that line (see below)
+        if (!geoOpen) lastLineRef.current = { openLeft: openLeft, dock: dock, w: window.innerWidth, h: window.innerHeight };
       }
       var geoFrozen = geoSnapRef.current !== null && geoSnapRef.current.dock === dock
         && Date.now() < geoHoldRef.current;
       if (geoFrozen) {
         anchorLeft = geoSnapRef.current.anchorLeft;
         openLeft = geoSnapRef.current.openLeft;
+      } else {
+        // The host re-measures its area between the two legs (a slow beat), and a few
+        // pixels of drift there is what made the panel reopen slightly to the RIGHT of
+        // the place it had tucked into. While the drift is small the line it went into
+        // wins — over BOTH legs, so the tuck line and the open line are the same
+        // number. A larger difference means the reader really moved something (the
+        // sidebar, the window), and the fresh measurement wins instead.
+        var lastLine = lastLineRef.current;
+        if (lastLine && lastLine.dock === dock
+            && lastLine.w === window.innerWidth && lastLine.h === window.innerHeight
+            && Math.abs(lastLine.openLeft - openLeft) <= 24
+            && lastLine.openLeft !== openLeft) {
+          openLeft = lastLine.openLeft;
+          // travel becomes geoW + 16 again, so `anchorLeft + clip` (the tuck line)
+          // evaluates to this same line
+          anchorLeft = openLeft - geoW - 16;
+        }
       }
       var openOffset = openLeft - anchorLeft;
-      var parkedOffset = dockRight ? (openLeft + panelW) - anchorLeft : 0;
+      var parkedOffset = dockRight ? (openLeft + geoW) - anchorLeft : 0;
       var panelLeft = anchorLeft;
       var panelOffset = geoOpen ? openOffset : parkedOffset;
       var panelTransform = panelOffset === 0 ? "none" : "translateX(" + zLen(panelOffset) + ")";
@@ -6272,12 +6354,26 @@ window.__ModuleLoader__.load({
       // the wipe edge drift 24px through the slide); the shadow lives on the panel's
       // twin element instead.
       var panelClip = "inset(0 0 0 0px)";
+      // ONE line, and that is a geometric necessity rather than a taste: the visible
+      // edge of a clipped box can never be left of the box's own left edge, so the
+      // only way the tuck line and the open line can both sit somewhere is for the
+      // wipe to equal the travel. Any other value makes the edge sweep between two
+      // lines through the animation (pull it 8px back and the panel visibly slides
+      // 8px further left as it vanishes, then reappears from the open line instead).
+      //
+      // It can never be SHORTER than the box it hides either: `clampLeft` pulls the
+      // open position inwards when the window is narrow relative to the panel, which
+      // shortened the travel below the panel width and left a strip of the parked
+      // panel standing on the workspace (measured at 284px on a 13" screen). (The
+      // right dock needs no guard — its travel is one panel width by construction.)
+      // The halo twin reads the same number, so the two are clipped by one wipe.
+      var clipWipe = Math.max(travelPx, geoW + 2);
       if (!geoOpen) {
         if (dockRight) {
           // mirror of LEFT: clip the RIGHT side (panel flies right, shrinking from its right)
           panelClip = "inset(0 " + zLen(travelPx) + " 0 0)";
         } else {
-          panelClip = "inset(0 0 0 " + zLen(travelPx) + ")";
+          panelClip = "inset(0 0 0 " + zLen(clipWipe) + ")";
         }
       }
       // faded out entirely while another center-column view is active
@@ -6460,6 +6556,23 @@ window.__ModuleLoader__.load({
       // twenty-pixel star, and a squeezed digit is worse than none). The count lives
       // in the tooltip a moment later, where it has a line of its own.
       var markCount = marks.length > 99 ? "99+" : String(marks.length);
+      // the star, drawn once: the docked header's 15px face and the curtain's larger
+      // one are the same glyph at two sizes
+      var starIcon = function (size) {
+        return react_jsx_runtime.jsx("svg", {
+          width: size, height: size, viewBox: "0 0 24 24",
+          style: { display: "block" },
+          children: react_jsx_runtime.jsx("path", {
+            // rounded joins (a stroke in the same colour as the fill) soften the
+            // five points; without it the star reads as a spiky asterisk at this size
+            d: "M12 3.1l2.72 5.52 6.09.89-4.4 4.29 1.04 6.06L12 16.9l-5.45 2.86 1.04-6.06-4.4-4.29 6.09-.89z",
+            fill: "currentColor",
+            stroke: "currentColor",
+            strokeWidth: 2.4,
+            strokeLinejoin: "round"
+          })
+        });
+      };
       var marksTip = onlyMarks
         ? Tp("marks.tip.all", { n: markCount })
         : Tp("marks.tip.only", { n: markCount });
@@ -6484,21 +6597,14 @@ window.__ModuleLoader__.load({
           padding: 0,
           transition: "background 0.18s ease, color 0.18s ease"
         },
-        children: react_jsx_runtime.jsx("svg", {
-          key: "star",
-          width: 15, height: 15, viewBox: "0 0 24 24",
-          style: { display: "block" },
-          children: react_jsx_runtime.jsx("path", {
-            // rounded joins (a stroke in the same colour as the fill) soften the
-            // five points; without it the star reads as a spiky asterisk at this size
-            d: "M12 3.1l2.72 5.52 6.09.89-4.4 4.29 1.04 6.06L12 16.9l-5.45 2.86 1.04-6.06-4.4-4.29 6.09-.89z",
-            fill: "currentColor",
-            stroke: "currentColor",
-            strokeWidth: 2.4,
-            strokeLinejoin: "round"
-          })
-        })
+        children: starIcon(15)
       }, "marks-btn");
+      // the curtain's way into the bookmarks: the docked header's star, at the
+      // curtain's own scale (toolBtn), sliding the drawer in from the right exactly
+      // like the magnifier does. It sits in the LEFT pair, right of the settings
+      // button (the docked header's arrangement), not next to the search
+      var sheetMarksBtnEl = toolBtn("marks", "dqt-sheet-marks-btn", toggleMarksCol,
+        Tp("marks.tip.col", { n: markCount }), marksCol, false, starIcon(tbIconLg));
       // the curtain keeps its own entry point: the water-drop handle on the top
       // edge (sheet.openHandle). The toolbar's curtain button is gone — the header
       // is four controls now.
@@ -6520,8 +6626,10 @@ window.__ModuleLoader__.load({
           cursor: "pointer"
         },
         onMouseEnter: function (e) {
-          e.currentTarget.style.background = "var(--dsw-alias-interactive-bg-active, rgba(79,140,255,0.24))";
-          e.currentTarget.style.color = "var(--dsw-alias-brand-primary, #4f8cff)";
+          // C.chip / C.accent, not the host's brand variables: this button used to stay
+          // blue whatever theme colour the reader picked
+          e.currentTarget.style.background = C.chip;
+          e.currentTarget.style.color = C.accent;
         },
         onMouseLeave: function (e) {
           e.currentTarget.style.background = "var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.16))";
@@ -6634,7 +6742,10 @@ window.__ModuleLoader__.load({
         children: [
           react_jsx_runtime.jsx("div", {
             style: { position: "relative", display: "flex", alignItems: "center", gap: 8, flex: "none" },
-            children: [settingsBtnEl]
+            // settings first, then the bookmarks: the LEFT pair is "what the outline
+            // holds", the right pair is "how you look through it" (search) and the way
+            // out — the same split the docked header uses
+            children: [settingsBtnEl, sheetMarksBtnEl]
           }),
           react_jsx_runtime.jsx("div", { style: { flex: "1 1 auto", minWidth: 0 } }),
           searchBtnEl,
@@ -6742,6 +6853,7 @@ window.__ModuleLoader__.load({
               // input with a custom animated placeholder: the box stays static,
               // only the placeholder text fades when the scope switches
               react_jsx_runtime.jsx("div", {
+                className: "dqt-search-pill",
                 style: {
                   position: "relative",
                   flex: 1,
@@ -6953,7 +7065,7 @@ window.__ModuleLoader__.load({
       // target lookup, the keyboard cursor, the follow). A saved place needs a label
       // and a click — nothing else.
       var markRowsEl = null;
-      if (onlyMarks && !resultsEl) {
+      if ((onlyMarks || marksCol) && !resultsEl) {
         // `dense` is a local of the row renderers, not of this component: read the
         // preference here instead (referencing the other one threw and took the
         // whole panel down with it).
@@ -7047,7 +7159,7 @@ window.__ModuleLoader__.load({
       // the moment the shorter list rendered, and putting the offset back afterwards
       // was a race the browser usually won.
       var marksOverlayEl = null;
-      if (onlyMarks && !resultsEl) {
+      if (onlyMarks && !resultsEl && !marksCol) {
         marksOverlayEl = react_jsx_runtime.jsx("div", {
           className: "dqt-marks-overlay",
           style: {
@@ -7081,8 +7193,9 @@ window.__ModuleLoader__.load({
         "aria-label": T("a11y.list"),
         style: {
           // hidden rather than unmounted while the bookmark view is up (see above):
-          // it keeps its height and therefore its scroll offset
-          visibility: onlyMarks && !resultsEl ? "hidden" : undefined,
+          // it keeps its height and therefore its scroll offset. In the curtain the
+          // bookmarks live in their own column, so the outline stays visible.
+          visibility: onlyMarks && !resultsEl && !marksCol ? "hidden" : undefined,
           overflowY: "auto",
           // We are the only thing that holds the reader's place in this list (see the
           // paging block): the browser's own scroll anchoring would also adjust
@@ -7139,6 +7252,7 @@ window.__ModuleLoader__.load({
         ref: searchColRef,
         className: "dqt-sheet-search",
         "data-sheet-search": sheetColW > 0 ? "on" : undefined,
+        "data-sheet-marks": marksCol ? "on" : undefined,
         style: {
           flex: "none",
           width: sheetColW,
@@ -7148,14 +7262,45 @@ window.__ModuleLoader__.load({
         },
         children: react_jsx_runtime.jsx("div", {
           style: { width: SHEET_SEARCH_W, height: "100%", display: "flex", flexDirection: "column", minHeight: 0 },
-          children: [
+          children: marksCol ? [
+            // the same column, the other tenant: a quiet title line with the count,
+            // then the saved rows. No controls — the star in the chrome closes it.
+            react_jsx_runtime.jsx("div", {
+              key: "col-marks-head",
+              style: {
+                flex: "none",
+                display: "flex",
+                alignItems: "center",
+                gap: 8,
+                padding: "10px 12px 9px",
+                borderBottom: "1px solid " + C.panelBorder,
+                fontSize: 12.5,
+                fontWeight: 600,
+                color: C.text
+              },
+              children: [
+                react_jsx_runtime.jsx("span", { key: "t", children: T("marks.title") }, "mh-t"),
+                react_jsx_runtime.jsx("span", {
+                  key: "n",
+                  style: { fontSize: 11, fontWeight: 400, color: C.muted },
+                  children: markCount
+                }, "mh-n")
+              ]
+            }),
+            react_jsx_runtime.jsx("div", {
+              key: "col-marks-body",
+              className: "dqt-sheet-marks-body",
+              style: { flex: "1 1 auto", minHeight: 0, overflowY: "auto", padding: "2px 6px 8px" },
+              children: markRowsEl
+            })
+          ] : [
             searchRowEl,
             // empty until something is typed — no placeholder note in the way
             react_jsx_runtime.jsx("div", {
               className: "dqt-sheet-results",
               style: { flex: "1 1 auto", minHeight: 0, overflowY: "auto", padding: "0 8px 8px", direction: "ltr" },
               children: resultsEl
-            })
+            }, "col-results")
           ]
         })
       }) : null;
@@ -7208,7 +7353,7 @@ window.__ModuleLoader__.load({
         position: "fixed",
         top: zLen(baseTopPx),
         left: zLen(panelLeft),
-        width: zLen(panelW),
+        width: zLen(geoW),
         maxHeight: zLen(vMaxH),
         height: panelH > 0 ? zLen(panelH) : undefined,
         zoom: zoom === 1 ? undefined : zoom,
@@ -7234,20 +7379,35 @@ window.__ModuleLoader__.load({
       // One halo on ALL four sides — evenly, corners included (a card lifted off
       // the conversation; no downward bias, or the top corners stay bare). Dark
       // scheme gets a WHITE one — the theme's own raised language.
-      // the wipe side's cut sits exactly on the seam the panel tucks behind: past
-      // that line there is nothing to see — panel or halo — the clip decides,
-      // never a fade
+      //
+      // SHADOW_REACH: how far the edge OPPOSITE the wipe is pulled in while the panel
+      // is parked, so the twin's halo cannot spill past the tuck line once the panel
+      // body has been clipped away.
+      // SHADOW_BLEED: how far all four sides bleed while the panel is at rest — the
+      // deepest reach of the halo (15px below with the offset, more at the corners).
       var SHADOW_REACH = 8;
       var SHADOW_BLEED = 24;
-      var shadowWipe = geoOpen ? 0 : travelPx;
+      // The WIPE side is the one the panel slides through. It is clipped by exactly the
+      // same wipe as the panel while anything is moving — zero reach, so the halo is
+      // never drawn where the panel itself is still hidden (any reach there reads as an
+      // outer frame arriving before the surface). The halo the reader wants lives on the
+      // OTHER three sides during the slide, and on this side only once the slide has
+      // LANDED, when it relaxes to the full bleed.
+      //
+      // The relaxation waits for `shadowSettled` (set by the timer in the hook block
+      // above) instead of riding the same transition: transitioning it together was
+      // what let the halo lead the panel's clipped edge.
+      var shadowDockSide = (geoOpen && shadowSettled)
+        ? -SHADOW_BLEED
+        : (geoOpen ? 0 : (dockRight ? travelPx : clipWipe));
       // Keep the four-sided halo while open. During a tuck, move the wipe edge
       // with the panel AND bring the opposite horizontal clip edge inward to meet
       // it at the parked position. Leaving that edge at -24px let the shadow twin
       // paint a visible strip after the panel body had been clipped away (wider on
       // the right dock, a thin sliver on the left dock).
       var shadowClip = dockRight
-        ? "inset(" + zLen(-SHADOW_BLEED) + " " + zLen(shadowWipe - SHADOW_REACH) + " " + zLen(-SHADOW_BLEED) + " " + zLen(geoOpen ? -SHADOW_BLEED : SHADOW_REACH) + ")"
-        : "inset(" + zLen(-SHADOW_BLEED) + " " + zLen(geoOpen ? -SHADOW_BLEED : -SHADOW_REACH) + " " + zLen(-SHADOW_BLEED) + " " + zLen(shadowWipe - SHADOW_REACH) + ")";
+        ? "inset(" + zLen(-SHADOW_BLEED) + " " + zLen(shadowDockSide) + " " + zLen(-SHADOW_BLEED) + " " + zLen(geoOpen ? -SHADOW_BLEED : SHADOW_REACH) + ")"
+        : "inset(" + zLen(-SHADOW_BLEED) + " " + zLen(geoOpen ? -SHADOW_BLEED : -SHADOW_REACH) + " " + zLen(-SHADOW_BLEED) + " " + zLen(shadowDockSide) + ")";
       // The panel's blur lives OUTSIDE the clipping wrapper (see the portal list):
       // inside it, any backdrop-filter promotes a layer in that subtree and the
       // panel drops beneath the conversation. As a body-level twin with the same
@@ -7313,6 +7473,10 @@ window.__ModuleLoader__.load({
       });
       var panelEl = react_jsx_runtime.jsx("div", {
         ref: panelRootRef,
+        // a marker for the reader's own console checks (and for support): the panel
+        // root used to have no attribute at all, so a lookup by class silently
+        // returned null and read as "the panel is gone"
+        "data-dqt-panel": "1",
         // the panel takes focus on any click inside it (except into a text field), so
         // ↑/↓/Enter/Esc keep working right after a mouse interaction instead of only
         // when the user tabs into the widget first
@@ -7614,8 +7778,17 @@ window.__ModuleLoader__.load({
       // 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
+      // The pill is 12px centred in the 26px box, so its edge sits 7px inside the box
+      // edge. Left dock: the panel opens at `area + 8`, so parking the box 1px out puts
+      // the pill's left edge exactly on the panel's own left edge — one line.
+      //
+      // Right dock: deliberately NOT aligned. The panel is held 48px clear of the
+      // area's right edge (the milestone rail lives there), so the pill — which hangs
+      // on that edge — is 11px inside the panel's right edge by construction. Pulling
+      // it out to meet the panel would push the pill into the rail, which is worse
+      // than two lines nobody sees at the same time.
+      var edgeLineLeft = (viewport ? viewport.left : 0) + 1;
+      var edgeLineRight = (viewport ? viewport.right + 52 : 60);   // clear of the milestone rail
       var edgeEl = (!open || !edgeGone) ? react_jsx_runtime.jsx("div", {
         style: {
           position: "fixed",
@@ -7882,7 +8055,30 @@ window.__ModuleLoader__.load({
                   fontSize: 11,
                   lineHeight: "20px"
                 },
-                children: opts.pinned ? "\u25c9" : "\u25cb"
+                // A ring with a FILLED core, drawn rather than typed: the ◉/○ glyphs
+                // could only be one colour, and the pin's filled state is exactly the
+                // place the theme colour should show. Outline only when it is not pinned.
+                children: [react_jsx_runtime.jsx("svg", {
+                  key: "pin-ico",
+                  width: 13,
+                  height: 13,
+                  viewBox: "0 0 16 16",
+                  style: { display: "block" },
+                  fill: "none",
+                  children: [
+                    react_jsx_runtime.jsx("circle", {
+                      key: "ring",
+                      cx: 8, cy: 8, r: 5.4,
+                      stroke: "currentColor",
+                      strokeWidth: 1.4
+                    }),
+                    opts.pinned ? react_jsx_runtime.jsx("circle", {
+                      key: "core",
+                      cx: 8, cy: 8, r: 2.9,
+                      fill: P.accent
+                    }) : null
+                  ]
+                })]
               }, "hc-pin")
             ]
           }, "hc-head")
@@ -7931,7 +8127,12 @@ window.__ModuleLoader__.load({
             WebkitBackdropFilter: P.glassOn ? P.panelBlur : undefined,
             color: P.text,
             border: "1px solid " + P.panelBorder,
-            boxShadow: P.glassOn ? rimInset() + ", 0 8px 24px rgba(0,0,0,0.28)" : "0 8px 24px rgba(0,0,0,0.28)",
+            // An inset accent bar on the reading side says "this card belongs to that
+            // row" without a second border: a shadow cannot move the box, and it
+            // respects the corner radius. It stays while the card is pinned — that is
+            // when the link matters most.
+            boxShadow: "inset 2px 0 0 " + P.accent
+              + (P.glassOn ? ", " + rimInset() + ", 0 8px 24px rgba(0,0,0,0.28)" : ", 0 8px 24px rgba(0,0,0,0.28)"),
             // 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),
@@ -8212,6 +8413,10 @@ window.__ModuleLoader__.load({
             // old content-box the bottom pair sat below it and the clip cut them
             // away, which is why the bottom edge had no visible line
             boxSizing: "border-box",
+            // the landing sag stretches the box DOWNWARD only, so its top edge never
+            // leaves the clip it hangs from (see the dqt-sheet-in keyframes: a
+            // translated top edge opened a slit that showed the transcript unblurred)
+            transformOrigin: "top center",
             display: "flex",
             flexDirection: "column",
             // The curtain is the transient surface (Windows' "Acrylic" case): the
@@ -8517,7 +8722,9 @@ window.__ModuleLoader__.load({
             // that the text never looks like it jumped
             e.currentTarget.style.transform = "translateX(1px)";
             var gd = e.currentTarget.querySelector("[data-dqt-guide]");
-            if (gd) gd.style.transform = "translateX(-1px)";
+            // the guide column takes the theme colour while its row is the one being
+            // read: a hairline's worth of colour is enough to say "these belong here"
+            if (gd) { gd.style.transform = "translateX(-1px)"; gd.style.background = C.accent; }
             if (extra && extra.hoverStart) extra.hoverStart(hoverInfo, e.currentTarget);
           },
           onMouseLeave: function (e) {
@@ -8527,7 +8734,7 @@ window.__ModuleLoader__.load({
             if (b) b.style.opacity = "0";
             e.currentTarget.style.transform = "translateX(0)";
             var gd2 = e.currentTarget.querySelector("[data-dqt-guide]");
-            if (gd2) gd2.style.transform = "translateX(0)";
+            if (gd2) { gd2.style.transform = "translateX(0)"; gd2.style.background = C.panelBorder; }
             if (extra && extra.hoverEnd) extra.hoverEnd();
           },
           onContextMenu: function (e) {
@@ -9881,7 +10088,7 @@ window.__ModuleLoader__.load({
         // ease-out is fast at a segment's start, it read as a snap back into place.
         // At the turning point the velocity is zero, so that leg eases IN as well as
         // out — that is what makes it a settle instead of a bounce.
-        "@keyframes dqt-sheet-in{from{transform:translateY(calc(-100% - 24px));animation-timing-function:cubic-bezier(0.22, 0.9, 0.3, 1)}62%{transform:translateY(4px);animation-timing-function:cubic-bezier(0.45, 0, 0.25, 1)}to{transform:translateY(0)}}" +
+        "@keyframes dqt-sheet-in{from{transform:translateY(calc(-100% - 24px));animation-timing-function:cubic-bezier(0.22, 0.9, 0.3, 1)}62%{transform:translateY(0) scaleY(1.014);animation-timing-function:cubic-bezier(0.45, 0, 0.25, 1)}to{transform:translateY(0) scaleY(1)}}" +
         // The retract has to clear the shadow too, not just the sheet: the sheet is
         // 24px shorter than its shell (that strip is where the drop shadow lands),
         // so `translateY(-100%)` parked its own shadow exactly at the shell's top
@@ -9921,7 +10128,7 @@ window.__ModuleLoader__.load({
         // keyboard cursor: an INSET outline plus a whisper of fill, so it never
         // reflows the row and stays distinct from the reading position's blue box
         // (which keeps the 3px left accent bar and the pastel fill)
-        ".dqt-nav{box-shadow:inset 0 0 0 1px var(--dsw-alias-brand-primary, #4f8cff);background:rgba(79,140,255,0.10);border-radius:6px}" +
+        ".dqt-nav{box-shadow:inset 0 0 0 1px #4F8CFF;background:rgba(79,140,255,0.10);border-radius:6px}" +
         ".dqt-nav:focus{outline:none}" +
         // the list itself never draws a focus ring — the cursor row is the indicator
         ".dqt-list:focus-visible{outline:none}" +
@@ -9953,7 +10160,7 @@ window.__ModuleLoader__.load({
         ".dqt-pcard:hover{border-color:var(--dsw-alias-label-dimmed)}" +
         ".dqt-pcardOpen{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}" +
         ".dqt-phead{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:12px;align-items:center;gap:12px;padding:14px 16px;display:flex}" +
-        ".dqt-phead:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:-2px}" +
+        ".dqt-phead:focus-visible{outline:2px solid #4F8CFF;outline-offset:-2px}" +
         ".dqt-pheadText{flex-direction:column;flex:1;gap:4px;min-width:0;display:flex}" +
         ".dqt-pname{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4}" +
         ".dqt-pdesc{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}" +
@@ -9987,7 +10194,7 @@ window.__ModuleLoader__.load({
         ".dqt-segOn{color:var(--dsw-alias-label-primary);background:var(--dsw-specific-sidebar-nav-item-active)}" +
         // scale slider — the fonttune card's slider shape (track, readout, end labels)
         ".dqt-sliderRow{align-items:center;gap:10px;margin-top:10px;display:flex}" +
-        ".dqt-slider{flex:1;min-width:0;height:20px;accent-color:var(--dsw-alias-brand-primary)}" +
+        ".dqt-slider{flex:1;min-width:0;height:20px;accent-color:#4F8CFF}" +
         ".dqt-slider:disabled{opacity:.4;cursor:default}" +
         ".dqt-sliderValue{flex:none;min-width:56px;text-align:right;color:var(--dsw-alias-label-primary);font-size:13px;line-height:20px;font-variant-numeric:tabular-nums}" +
         ".dqt-sliderScale{color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px;display:flex;justify-content:space-between}";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-quick-toc",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "Conversation TOC for DeepSeek Harness (DSH): a whole-session, turn-grouped Markdown outline with hover previews, heading-level preferences, a full-width curtain, jump-to-end buttons, title/prompts/full-text/cross-session search and a Chinese/English interface.",
   "icon": "./icon.svg",
   "type": "module",