dsh-turn-navigator 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.4.1] - 2026-09-03
+
+### Fixed
+
+- **Rail tooltip/aria now show the TRUE turn number** — the "第 N 轮" label previously used `entry.index` (the position within each source's own subset: every history page starts at 1, and window-only extras start at 1 too), so a merged long session could read "第 38 轮" followed by "第 2 轮". The label now comes from `entry.turn` (absolute, consistent with the "正在定位第 N 轮" bubble), and the merged list re-derives `index` purely as its sorted list position — `src/client/TurnNavRail.tsx`, `src/client/turns.ts`.
+- **Rail viewport follows the active turn** — the rail is capped at 30vh with an internal scrollbar, so in a long session the current turn's capsule sat outside the visible band on open/scroll. A new effect scrolls the active capsule into the rail's viewport (centered) whenever it leaves it, with a pointer-over guard so a user browsing the rail is never yanked — `src/client/TurnNavRail.tsx`.
+- **Compile/runtime hardening on dsh 0.1.2+** — the newer `ClientContext` type surface dropped `connection.api` (the 0.1.2+ journal channel replaced the RPC); the browser side now reads it structurally (`(connection as { api?: HistoryApi })?.api`) so both older and newer hosts compile and run — `src/client/index.ts`.
+
 ## [0.4.0] - 2026-08-29
 
 ### Added

package/lib/client.js

@@ -442,10 +442,10 @@ window.__ModuleLoader__.load({
 		function clampFeedbackY(y) {
 			return Math.max(24, Math.min(y, window.innerHeight - 24));
 		}
-		/** Tooltip body for one turn: index, time, full summary. */
+		/** Tooltip body for one turn: turn number, time, full summary. */
 		function tooltipText(entry, t) {
 			const time = formatTime(entry.startTime);
-			const label = t("turnLabel", { n: String(entry.index) });
+			const label = t("turnLabel", { n: String(entry.turn) });
 			const body = entry.fullText || entry.summary || t("noSummary");
 			const lines = [label];
 			if (time !== "") lines.push(time);
@@ -480,6 +480,7 @@ window.__ModuleLoader__.load({
 			const railRef = (0, react.useRef)(null);
 			const tipRef = (0, react.useRef)(null);
 			const hoverScrollRef = (0, react.useRef)(null);
+			const pointerOverRailRef = (0, react.useRef)(false);
 			(0, react.useEffect)(() => {
 				let timer = null;
 				const check = () => {
@@ -545,7 +546,10 @@ window.__ModuleLoader__.load({
 				if (historyTurns.length === 0) return windowTurns;
 				const historySet = new Set(historyTurns.map((entry) => entry.turn));
 				const extras = windowTurns.filter((entry) => !historySet.has(entry.turn));
-				return [...historyTurns, ...extras].sort((a, b) => a.turn - b.turn);
+				return [...historyTurns, ...extras].sort((a, b) => a.turn - b.turn).map((entry, i) => ({
+					...entry,
+					index: i + 1
+				}));
 			}, [historyTurns, windowTurns]);
 			const [activeTurn, setActiveTurn] = (0, react.useState)(null);
 			(0, react.useEffect)(() => {
@@ -582,6 +586,19 @@ window.__ModuleLoader__.load({
 					if (frame !== null) cancelAnimationFrame(frame);
 				};
 			}, [turns.length]);
+			(0, react.useEffect)(() => {
+				if (activeTurn === null || pointerOverRailRef.current) return;
+				const index = turns.findIndex((entry) => entry.turn === activeTurn);
+				if (index < 0) return;
+				const rail = railRef.current;
+				if (rail === null) return;
+				const btn = rail.querySelectorAll(".tn-cap-btn")[index];
+				if (btn === void 0) return;
+				const railRect = rail.getBoundingClientRect();
+				const btnRect = btn.getBoundingClientRect();
+				if (btnRect.top >= railRect.top && btnRect.bottom <= railRect.bottom) return;
+				centerCapsule(index);
+			}, [activeTurn, turns]);
 			(0, react.useEffect)(() => {
 				const rail = railRef.current;
 				if (rail === null) return;
@@ -741,7 +758,11 @@ window.__ModuleLoader__.load({
 				className: `tn-wrap${officialRail ? " tn-nudge" : ""}`,
 				role: "navigation",
 				"aria-label": t("rail"),
+				onMouseEnter: () => {
+					pointerOverRailRef.current = true;
+				},
 				onMouseLeave: () => {
+					pointerOverRailRef.current = false;
 					setHoverIndex(-1);
 					stopHoverScroll();
 				},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-turn-navigator",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "DSH Smoothly Turn Nav (DSH STN): full-history piano-key turn rail for DeepSeek Harness (dsh) web conversations — see every turn at a glance, hover to preview, click to jump anywhere, and replace the official (non-disableable) turn rail.",
   "type": "module",
   "main": "lib/index.js",