@khorsheed/dsh-message-timeline 0.2.7 → 0.2.8

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # 变更记录
 
+## 0.2.8（2026-10-27）
+
+- **修复会话底部的消息点击后无法选中**：点击最新一条或底部可视区内的后续消息时，浏览器可能已把滚动位置钳制在最大值，原先高亮因此回退到第一条可见消息。现在跳转会保留实际点击落点；真正滚动、目标行移除或会话重绑后再恢复普通阅读位置跟踪。
+
 ## 0.2.7（2026-10-26）
 
 - **README 重写**：改为面向用户的简短说明。无功能变更。

package/lib/client.js

@@ -201,18 +201,12 @@ window.__ModuleLoader__.load({
 			}
 			return lastAbove;
 		}
-		/**
-		* Scroll one user-message row to the top of the transcript scrollport.
-		* @param scrollport - the official conversation scrollport element.
-		* @param key - the target node's anchor key.
-		* @returns whether the row was found and scrolled.
-		*/
-		function jumpRow(scrollport, key) {
+		function jumpTarget(scrollport, key) {
 			const row = scrollport.querySelector(`[data-chat-anchor-key=${JSON.stringify(key)}]`);
-			if (row === null) return false;
+			if (row === null) return null;
 			const target = row.getBoundingClientRect().top - scrollport.getBoundingClientRect().top + scrollport.scrollTop - JUMP_OFFSET;
 			scrollport.scrollTop = Math.max(0, target);
-			return true;
+			return row;
 		}
 		/**
 		* Install the rail tracker: bind the current session's scrollport, publish
@@ -228,6 +222,7 @@ window.__ModuleLoader__.load({
 			let state = IDLE;
 			let activeSession;
 			let scrollport = null;
+			let landing = null;
 			let resizeObserver;
 			let rafPending = false;
 			let warned = false;
@@ -244,6 +239,7 @@ window.__ModuleLoader__.load({
 			const attach = (el) => {
 				if (scrollport !== null) scrollport.removeEventListener("scroll", onScroll);
 				resizeObserver?.disconnect();
+				landing = null;
 				scrollport = el;
 				scrollport.addEventListener("scroll", onScroll, { passive: true });
 				if (typeof ResizeObserver === "function") {
@@ -264,6 +260,7 @@ window.__ModuleLoader__.load({
 				}
 				const geometry = measureGeometry(el);
 				if (geometry === null) return;
+				if (landing !== null && (landing.top !== el.scrollTop || !el.contains(landing.row))) landing = null;
 				publish({
 					sessionId: activeSession,
 					ready: true,
@@ -272,7 +269,7 @@ window.__ModuleLoader__.load({
 					height: geometry.height,
 					scrollportWidth: geometry.width,
 					flowLeft: flowLeftX(el),
-					activeKey: activeRowKey(el, includeSteering),
+					activeKey: landing?.key ?? activeRowKey(el, includeSteering),
 					chatView: el.querySelector("[data-chat-flow]") !== null
 				});
 			};
@@ -291,6 +288,7 @@ window.__ModuleLoader__.load({
 				bindToken++;
 				if (scrollport !== null) scrollport.removeEventListener("scroll", onScroll);
 				scrollport = null;
+				landing = null;
 				resizeObserver?.disconnect();
 				resizeObserver = void 0;
 				rafPending = false;
@@ -347,7 +345,22 @@ window.__ModuleLoader__.load({
 						};
 					}
 				},
-				jumpTo: (key) => scrollport !== null && jumpRow(scrollport, key),
+				jumpTo: (key) => {
+					const el = scrollport;
+					if (el === null) return false;
+					const row = jumpTarget(el, key);
+					if (row === null) return false;
+					landing = {
+						key,
+						row,
+						top: el.scrollTop
+					};
+					publish({
+						...state,
+						activeKey: key
+					});
+					return true;
+				},
 				dispose: () => {
 					stopList();
 					stopProvide?.();
@@ -561,16 +574,16 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var TimelineRail_module_css_default = {
-			"itemFocused": "_8u17xW_itemFocused",
-			"itemText": "_8u17xW_itemText",
-			"railPending": "_8u17xW_railPending",
-			"tick": "_8u17xW_tick",
 			"panel": "_8u17xW_panel",
-			"itemCurrent": "_8u17xW_itemCurrent",
 			"itemPending": "_8u17xW_itemPending",
+			"railPending": "_8u17xW_railPending",
+			"item": "_8u17xW_item",
 			"panelNarrow": "_8u17xW_panelNarrow",
+			"tick": "_8u17xW_tick",
+			"itemCurrent": "_8u17xW_itemCurrent",
 			"tickCurrent": "_8u17xW_tickCurrent",
-			"item": "_8u17xW_item"
+			"itemText": "_8u17xW_itemText",
+			"itemFocused": "_8u17xW_itemFocused"
 		};
 		//#endregion
 		//#region src/client/TimelineRail.tsx

package/lib/types/client/rail-tracker.d.ts

@@ -79,8 +79,9 @@ export interface RailTracker {
     /** Live rail geometry and active marker for the current session. */
     readonly state: HostObservable<TimelineRailState>;
     /**
-     * Scroll the transcript to the message addressed by `key`.
-     * @returns whether the row was found and scrolled (false while unbound).
+     * Scroll to the message addressed by `key` and keep that landing active
+     * until the reading position moves or the row disappears.
+     * @returns whether the target row was found (false while unbound or missing).
      */
     jumpTo(key: string): boolean;
     /** Unbind every listener and observer. */

package/lib/types/client/rail-tracker.js

@@ -131,6 +131,15 @@ export function activeRowKey(scrollport, includeSteering) {
     }
     return lastAbove;
 }
+function jumpTarget(scrollport, key) {
+    const row = scrollport.querySelector(`[data-chat-anchor-key=${JSON.stringify(key)}]`);
+    if (row === null)
+        return null;
+    const target = row.getBoundingClientRect().top - scrollport.getBoundingClientRect().top
+        + scrollport.scrollTop - JUMP_OFFSET;
+    scrollport.scrollTop = Math.max(0, target);
+    return row;
+}
 /**
  * Scroll one user-message row to the top of the transcript scrollport.
  * @param scrollport - the official conversation scrollport element.
@@ -138,13 +147,7 @@ export function activeRowKey(scrollport, includeSteering) {
  * @returns whether the row was found and scrolled.
  */
 export function jumpRow(scrollport, key) {
-    const row = scrollport.querySelector(`[data-chat-anchor-key=${JSON.stringify(key)}]`);
-    if (row === null)
-        return false;
-    const target = row.getBoundingClientRect().top - scrollport.getBoundingClientRect().top
-        + scrollport.scrollTop - JUMP_OFFSET;
-    scrollport.scrollTop = Math.max(0, target);
-    return true;
+    return jumpTarget(scrollport, key) !== null;
 }
 /**
  * Install the rail tracker: bind the current session's scrollport, publish
@@ -160,6 +163,7 @@ export function installRailTracker(ctx, includeSteering) {
     let state = IDLE;
     let activeSession;
     let scrollport = null;
+    let landing = null;
     let resizeObserver;
     let rafPending = false;
     let warned = false;
@@ -189,6 +193,7 @@ export function installRailTracker(ctx, includeSteering) {
         if (scrollport !== null)
             scrollport.removeEventListener('scroll', onScroll);
         resizeObserver?.disconnect();
+        landing = null;
         scrollport = el;
         scrollport.addEventListener('scroll', onScroll, { passive: true });
         if (typeof ResizeObserver === 'function') {
@@ -218,6 +223,8 @@ export function installRailTracker(ctx, includeSteering) {
         const geometry = measureGeometry(el);
         if (geometry === null)
             return;
+        if (landing !== null && (landing.top !== el.scrollTop || !el.contains(landing.row)))
+            landing = null;
         publish({
             sessionId: activeSession,
             ready: true,
@@ -226,7 +233,7 @@ export function installRailTracker(ctx, includeSteering) {
             height: geometry.height,
             scrollportWidth: geometry.width,
             flowLeft: flowLeftX(el),
-            activeKey: activeRowKey(el, includeSteering),
+            activeKey: landing?.key ?? activeRowKey(el, includeSteering),
             chatView: el.querySelector('[data-chat-flow]') !== null,
         });
     };
@@ -245,6 +252,7 @@ export function installRailTracker(ctx, includeSteering) {
         if (scrollport !== null)
             scrollport.removeEventListener('scroll', onScroll);
         scrollport = null;
+        landing = null;
         resizeObserver?.disconnect();
         resizeObserver = undefined;
         rafPending = false;
@@ -314,7 +322,17 @@ export function installRailTracker(ctx, includeSteering) {
                 return () => { listeners.delete(fn); };
             },
         },
-        jumpTo: (key) => scrollport !== null && jumpRow(scrollport, key),
+        jumpTo: (key) => {
+            const el = scrollport;
+            if (el === null)
+                return false;
+            const row = jumpTarget(el, key);
+            if (row === null)
+                return false;
+            landing = { key, row, top: el.scrollTop };
+            publish({ ...state, activeKey: key });
+            return true;
+        },
         dispose: () => {
             stopList();
             stopProvide?.();

package/lib/types/client/slots.d.ts

@@ -58,8 +58,9 @@ export interface TimelineRailInjected {
      */
     loadThrough: ISession['loadThrough'];
     /**
-     * Scroll the transcript to the user message row addressed by `key`.
-     * @returns whether the row was found and scrolled.
+     * Scroll to the user message addressed by `key` and keep that landing active
+     * until the reading position moves or the row disappears.
+     * @returns whether the target row was found (false while unbound or missing).
      */
     jumpTo: (key: string) => boolean;
     hooks: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@khorsheed/dsh-message-timeline",
   "description": "Message timeline: a flat floating list over the conversation scrollport that jumps to any user message, with a tick-only rest state",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",