dsh-quick-toc 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+All notable changes to **dsh-quick-toc** are documented here.
+
+## [0.3.2] - 2026-09-08
+
+### Changed
+- Documentation pass: the compatibility matrix and feature list in the READMEs are refreshed, and the npm package description now mentions keyword search and in-chat highlighting.
+
+## [0.3.1] - 2026-09-08
+
+### Fixed
+- Panel and collapsed edge handle no longer float above DSH modals: the base z-index is now 500 (above app popovers at z 100 and the transcript width handles at z 8, but below DSH's modal layer at z 1000), so opening Settings covers the outline instead of the outline sitting on top of it.
+- Circular controls are true circles again on DSH 0.1.5-rc.1: the theme applies `corner-shape: superellipse(1.5)` to every element, which turned `border-radius: 50%` into a squircle. The icon buttons, search-scope toggle, top drag bar and edge handle now declare `corner-shape: round`.
+
+### Changed
+- Compatibility declaration also lists DSH `0.1.5-rc.1` (verified compatible; `engines.dsh` stays `>=0.1.2-rc.1`).
+
+## [0.3.0] - 2026-08-24
+
+### Fixed
+- **DSH 0.1.2-rc.1 compatibility**: the removed `@deepseek-ai/dsh-client-runtime` package no longer breaks plugin loading (externals drift). Runtime hooks now arrive as session-scope slot props.
+- Conversation data access moved from `useSession(s => s.chat.*)` to the session-scope `useChat` hook (`ChatSnapshot.order` + `nodes` map, contributed by `dsh-client-ui-chat`). Node shape unchanged (`kind: user/assistant-step`, `location.turn`, `data.blocks`), so grouping / search / highlight / jump logic is untouched.
+- Panel mount moved into the session-scoped `conversation.input.overlay` slot. In 0.1.2-rc.1 session-scoped hooks only reach a declared *session* slot; a frame-floating `shell.overlay` occupant's `SessionProvider` binds to the root binding (no session id) and rendered the panel slot empty. The panel still draws its own fixed, frame-floating dock (position: fixed), so the overlay seat is only the hook source.
+
+### Changed
+- `dsh.client.inject` now lists `dsh-client-ui-chat` / `dsh-client-ui-conversation` / `dsh-client-ui-layout` instead of the removed runtime package.
+- Dropped the unused `sessions` service from the client inject list.
+
+### Added
+- Version guard: `dsh.compatibility.dshReleases` declares `0.1.2-rc.1: compatible` and `engines.dsh: ">=0.1.2-rc.1"` (dshmarket install-time host-compat preflight); peerDependencies pin `dsh-client-ui-chat` / `dsh-client-ui-conversation` `>=0.1.2-rc.1`. The panel degrades gracefully with a console warning when the `chat` hook is unavailable (older hosts).
+
+## [0.2.2] - 2026-08-24
+
+### Added
+- Keyword search: header magnifier button opens a search box; Enter cycles through matches (n/N counter); Escape or the magnifier toggles it closed
+- Search scope toggle: 标题 (heading titles only) or 全文 (also user messages and AI reply texts)
+- In-chat match highlighting: matched keywords are highlighted in the conversation; the current match gets a distinct highlight and is scrolled to the upper-middle of the viewport
+- Every occurrence counts toward n/N (multiple hits in one message = multiple matches)
+- Heading-less turns get a standalone time entry; all group headers show the turn's first-line preview next to the time (click to jump)
+
+### Changed
+- Panel collapse animation unified for both docks: clip-path hides the panel at the sidebar/screen edge (shadow removed to avoid clipping artifacts)
+- Inactive outline groups dimmed to 0.6 opacity
+
+## [0.1.1] - 2026-08-17
+
+### Changed
+- Release workflow also uploads a stable-named tarball (`dsh-quick-toc.tgz`) so `/releases/latest/download/` always resolves to the newest release
+
+## [0.1.0] - 2026-08-17
+
+### Added
+- Turn-grouped outline: each user message + its AI replies form one group, with the group's end time as the header
+- Auto-follow highlight: turns visible in the conversation viewport light up in the outline (multiple at once); the outline auto-loads and scrolls to keep them visible
+- Smooth jump: clicking a heading glides to the exact heading position in the conversation (with a small top offset)
+- Dock left/right with a draggable top bar, resizable from the edges/corner, collapsible into a draggable edge handle
+- Scrollbar follows the dock side (left when docked left, right when docked right)
+- Paged rendering: latest groups first; scrolling the outline to the top loads older groups
+- Auto "load older": when the outline reaches the top with everything loaded, it clicks the conversation's own load-more button
+- Header time jump: clicking a group's time label jumps to that turn's start
+- Markdown-aware titles: `**bold**`, `*italic*`, `` `code` ``, `[links](url)`, `~~strike~~` stripped from heading text
+- Persisted panel state (dock side, position, size) with automatic migration from older key names
+- Auto-hides when the conversation has no headings; light/dark theme support
+
+### Published
+- npm: `dsh-quick-toc@0.1.0`
+- GitHub: `LyaxZ/dsh-quick-toc` with auto-release workflow (tag push -> npm pack -> release asset)

package/README.en.md

@@ -20,8 +20,9 @@ A quick conversation TOC plugin for [DeepSeek Harness](https://github.com/deepse
 
 | Plugin | DSH |
 | --- | --- |
-| **0.3.0** | **≥ 0.1.2-rc.1** (new slot architecture) |
-| 0.2.2 | DSH versions before 0.1.2-rc.1 |
+| **0.3.2** (latest) | **≥ 0.1.2-rc.1** (verified on 0.1.2-rc.1 / 0.1.5-rc.1) |
+| 0.3.0 – 0.3.1 | same |
+| 0.2.2 | DSH versions before 0.1.2-rc.1 (install as `dsh-quick-toc@legacy`) |
 
 0.3.0 re-targeted the host integration (new slot architecture + `useChat` session data) and **only supports DSH 0.1.2-rc.1 and above**; for older DSH builds install 0.2.2. On install/update the DSH market pre-flights host compatibility from `dsh.compatibility.dshReleases` and `peerDependencies` in package.json and warns on a mismatch.
 

package/README.md

@@ -20,8 +20,9 @@
 
 | 插件版本 | DSH 版本 |
 | --- | --- |
-| **0.3.0** | **≥ 0.1.2-rc.1**（新 slot 架构） |
-| 0.2.2 | 0.1.2-rc.1 之前的旧版 DSH |
+| **0.3.2**（最新） | **≥ 0.1.2-rc.1**（已在 0.1.2-rc.1 / 0.1.5-rc.1 验证） |
+| 0.3.0 – 0.3.1 | 同上 |
+| 0.2.2 | 0.1.2-rc.1 之前的旧版 DSH（npm 上 `dsh-quick-toc@legacy`） |
 
 0.3.0 重写了与宿主的对接（新版 slot 架构 + `useChat` 会话数据），**只支持 DSH 0.1.2-rc.1 及以上**；旧版 DSH 请安装 0.2.2。安装/更新时 DSH 市场会根据 package.json 的 `dsh.compatibility.dshReleases` 与 `peerDependencies` 做 host 兼容预检，版本不符会给出提示。
 

package/lib/client.js

@@ -15,7 +15,10 @@ window.__ModuleLoader__.load({
     var PANEL_WIDTH = 288;
     // Very high base so the portal-rendered panel (top-level stacking context)
     // always sits above DSH content and its transcript width handles.
-    var Z_BASE = 2200;
+    // Panel layer: above the app's popovers (z 100) and the transcript width
+    // handles (z 8), but BELOW DSH's modal layer (settings/image viewer, z 1000)
+    // so opening settings covers the panel instead of the panel floating on top.
+    var Z_BASE = 500;
     var EASE = "cubic-bezier(0.22, 0.9, 0.3, 1)"; // smooth non-linear slide
 
     // ---------- markdown helpers ----------
@@ -960,6 +963,7 @@ window.__ModuleLoader__.load({
             alignItems: "center",
             justifyContent: "center",
             borderRadius: "50%",
+            cornerShape: "round",
             background: "var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.16))",
             border: "none",
             color: C.muted,
@@ -1073,6 +1077,7 @@ window.__ModuleLoader__.load({
                   width: 56,
                   height: 5,
                   borderRadius: 999,
+                  cornerShape: "round",
                   background: "var(--dsw-alias-border-l2, rgba(128,128,128,0.55))",
                   opacity: 0.35,
                   transition: "opacity 0.2s ease",
@@ -1121,6 +1126,7 @@ window.__ModuleLoader__.load({
                           alignItems: "center",
                           justifyContent: "center",
                           borderRadius: "50%",
+                          cornerShape: "round",
                           background: "var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.16))",
                           border: "none",
                           color: C.muted,
@@ -1164,6 +1170,7 @@ window.__ModuleLoader__.load({
                           alignItems: "center",
                           justifyContent: "center",
                           borderRadius: "50%",
+                          cornerShape: "round",
                           background: "var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.16))",
                           border: "none",
                           color: C.muted,
@@ -1234,6 +1241,7 @@ window.__ModuleLoader__.load({
                   alignItems: "center",
                   background: "var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.14))",
                   borderRadius: 999,
+                  cornerShape: "round",
                   padding: "6px 12px"
                 },
                 children: [
@@ -1320,6 +1328,7 @@ window.__ModuleLoader__.load({
                   alignItems: "center",
                   justifyContent: "center",
                   borderRadius: "50%",
+                  cornerShape: "round",
                   fontSize: 11,
                   color: searchScope === "full" ? "var(--dsw-alias-brand-primary, #4f8cff)" : C.muted,
                   background: searchScope === "full" ? "rgba(79,140,255,0.18)" : "var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.14))",
@@ -1442,6 +1451,7 @@ window.__ModuleLoader__.load({
             width: 12,
             height: 80,
             borderRadius: 999,
+            cornerShape: "round",
             background: "var(--dsw-alias-border-l2, rgba(160,160,160,0.55))",
             opacity: handleShown ? 0.5 : 0,
             transition: "opacity 0.35s ease, background 0.25s ease",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-quick-toc",
-  "version": "0.3.0",
-  "description": "Quick conversation TOC for DeepSeek Harness: markdown heading outline grouped by turn, with auto-follow highlight and smooth jump navigation",
+  "version": "0.3.2",
+  "description": "Conversation TOC for DeepSeek Harness (DSH): turn-grouped Markdown heading outline with keyword search (title/full-text scope), in-chat match highlighting, auto-follow and smooth jump navigation",
   "type": "module",
   "main": "lib/index.js",
   "files": [
@@ -9,6 +9,7 @@
     "cordis.patch.yml",
     "README.md",
     "README.en.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "engines": {
@@ -33,7 +34,8 @@
     },
     "compatibility": {
       "dshReleases": {
-        "0.1.2-rc.1": "compatible"
+        "0.1.2-rc.1": "compatible",
+        "0.1.5-rc.1": "compatible"
       }
     }
   },