@neut/ui 0.0.17 → 0.0.18

package/dist/components/message-scroller/useMessageScrollerEngine.js

@@ -1,6 +1,11 @@
-import { createEffect as e, createSignal as t, onCleanup as n } from "solid-js";
+import { createDomMeasure as e } from "./message-scroller.dom-measure.js";
+import { createAnchoring as t } from "./message-scroller.anchoring.js";
+import { createScrollCommands as n } from "./message-scroller.commands.js";
+import { createScrollState as r } from "./message-scroller.scroll-state.js";
+import { createVisibility as i } from "./message-scroller.visibility.js";
+import { createEffect as a, createSignal as o, onCleanup as s } from "solid-js";
 //#region src/components/message-scroller/useMessageScrollerEngine.ts
-var r = .5, i = 180, a = /* @__PURE__ */ new Set([
+var c = /* @__PURE__ */ new Set([
 	"ArrowDown",
 	"ArrowUp",
 	"End",
@@ -9,364 +14,109 @@ var r = .5, i = 180, a = /* @__PURE__ */ new Set([
 	"PageUp",
 	" "
 ]);
-function o(e) {
-	let t = Number.parseFloat(e);
-	return Number.isFinite(t) ? t : 0;
-}
-function s(e) {
-	let t = window.getComputedStyle(e);
-	return {
-		start: o(t.paddingBlockStart || t.paddingTop),
-		end: o(t.paddingBlockEnd || t.paddingBottom)
-	};
-}
-function c(e) {
-	if (!e) return 0;
-	let t = window.getComputedStyle(e);
-	return o(t.rowGap === "normal" ? t.gap : t.rowGap);
-}
-function l(o) {
-	let [l, ee] = t(), [u, te] = t(), [d, ne] = t(), [f, re] = t(!0), [ie, ae] = t(!1), [oe, se] = t(!1), [p, m] = t(!1), [ce, h] = t(o().defaultScrollPosition !== "start"), [le, g] = t(null), [ue, _] = t([]), v = /* @__PURE__ */ new Map(), y = /* @__PURE__ */ new Set(), b = /* @__PURE__ */ new WeakSet(), x = o().autoScroll ? "following-bottom" : "free-scrolling", S = 0, C = 0, w = null, T = !1, E = null, D = null, O = null, k = 0, A = 0, j = null, M = null, N = null, P = null, F = null, I = 0, L = () => {
-		let e = u(), t = d();
-		return e ? Array.from(e.children).filter((e) => e instanceof HTMLElement && e !== t) : [];
-	}, R = (e) => {
-		let t = l();
-		return t ? e.getBoundingClientRect().top - t.getBoundingClientRect().top + t.scrollTop : 0;
-	}, z = (e) => {
-		let t = l();
-		return t ? e.getBoundingClientRect().top - t.getBoundingClientRect().top : 0;
-	}, B = () => {
-		let e = l(), t = u();
-		if (!e || !t) return 0;
-		let n = s(t), r = e.getBoundingClientRect(), i = n.start + n.end;
-		for (let t of L()) {
-			let a = t.getBoundingClientRect();
-			i = Math.max(i, a.bottom - r.top + e.scrollTop + n.end);
-		}
-		return i;
-	}, de = () => {
-		let e = l();
-		return e ? Math.max(0, e.scrollHeight - e.clientHeight) : 0;
-	}, V = (e) => {
-		let t = d();
-		if (!t) return;
-		let n = Math.max(0, Math.ceil(e));
-		k !== n && (k = n, t.hidden = n === 0, t.style.height = `${n}px`, t.style.marginTop = n > 0 ? `${-A}px` : "");
-	}, fe = () => {
-		let e = l(), t = u();
-		if (!e || !t) return {
-			start: !1,
-			end: !1
-		};
-		let n = o().scrollEdgeThreshold, r = B();
-		return {
-			start: e.scrollTop > n,
-			end: r - e.scrollTop - e.clientHeight > n
-		};
-	}, pe = (e) => {
-		let t = l();
-		if (!t) return;
-		let n = t.scrollTop, i = n < S - r;
-		S = n, o().autoScroll && !e.end && x !== "settling-jump" && x !== "anchored-to-message" ? x = "following-bottom" : x === "following-bottom" && e.end && i && !p() && (x = "free-scrolling");
-	}, H = () => {
-		let e = fe();
-		pe(e);
-		let t = x === "following-bottom" ? {
-			...e,
-			end: !1
-		} : e;
-		ae(t.start), se(t.end);
-	}, U = () => {
-		M === null && (M = window.requestAnimationFrame(() => {
-			M = null, H();
-		}));
-	}, W = () => {
-		N === null && (N = window.requestAnimationFrame(() => {
-			N = null, I > 0 && Ee();
-		}));
-	}, G = (e) => {
-		j !== null && (window.clearTimeout(j), j = null), p() !== e && (m(e), H()), e && (j = window.setTimeout(() => {
-			j = null, m(!1), H();
-		}, i));
-	}, K = (e, { behavior: t = "auto", auto: n = !1 } = {}) => {
-		let i = l();
-		if (!i) return;
-		let a = Math.max(0, e);
-		if (Math.abs(i.scrollTop - a) <= r) {
-			i.scrollTop = a, H();
-			return;
-		}
-		n && G(!0), i.scrollTo({
-			top: a,
-			behavior: t
-		}), U();
-	}, q = (e) => l() ? (V(0), E = null, x = "free-scrolling", K(0, { behavior: e?.behavior ?? "auto" }), W(), !0) : !1, J = (e) => l() ? (V(0), E = null, x = o().autoScroll ? "following-bottom" : "free-scrolling", K(de(), {
-		behavior: e?.behavior ?? "auto",
-		auto: !0
-	}), W(), !0) : !1, me = (e, t, n) => {
-		let r = l();
-		if (!r) return 0;
-		let i = u() ? s(u()) : {
-			start: 0,
-			end: 0
-		}, a = R(e), o = e.getBoundingClientRect().height;
-		switch (t?.align ?? "start") {
-			case "center": {
-				let e = Math.max(0, r.clientHeight - i.start - i.end);
-				return a - i.start - (e - o) / 2 - n;
-			}
-			case "end": return a - r.clientHeight + o + i.end + n;
-			case "nearest": {
-				let e = a + o, t = r.scrollTop + i.start, s = r.scrollTop + r.clientHeight - i.end;
-				return a >= t && e <= s ? r.scrollTop : a < t ? a - i.start - n : e - r.clientHeight + i.end + n;
-			}
-			default: return a - i.start - n;
-		}
-	}, Y = (e, t, { keepPreviousPeek: n = !1 } = {}) => {
-		let r = l(), i = u();
-		if (!r || !i?.contains(e)) return !1;
-		let a = (t?.scrollMargin ?? o().scrollMargin) + (n ? o().scrollPreviousItemPeek : 0), s = me(e, t, a);
-		return V(Math.max(0, s + r.clientHeight - B())), O = {
-			element: e,
-			viewportTop: z(e)
-		}, x = n ? "anchored-to-message" : "settling-jump", E = n ? e : null, K(s, { behavior: t?.behavior ?? "auto" }), W(), !0;
-	}, he = () => {
-		let e = E;
-		return !e?.isConnected || x !== "anchored-to-message" ? !1 : Y(e, { align: "start" }, { keepPreviousPeek: !0 });
-	}, ge = () => {
-		let e = l();
-		if (!e || T || C === 0) return !1;
-		let t = o().defaultScrollPosition, n = !1;
-		if (t === "last-anchor") {
-			let t = [...L()].reverse().find((e) => e.dataset.scrollAnchor === "true") ?? null;
-			n = t ? B() - R(t) <= e.clientHeight ? J({ behavior: "auto" }) : Y(t, { align: "start" }, { keepPreviousPeek: !0 }) : J({ behavior: "auto" });
-		} else n = t === "end" ? J({ behavior: "auto" }) : q({ behavior: "auto" });
-		return n && (T = !0, h(!1)), n;
-	}, X = () => {
-		let e = D;
-		if (!e) return !1;
-		let t = v.get(e.id);
-		return !t || !Y(t, e.options) ? !1 : (D = null, T = !0, h(!1), !0);
-	}, _e = () => {
-		P === null && (P = window.requestAnimationFrame(() => {
-			P = null, X() && Z();
-		}));
-	}, ve = (e, t) => {
-		let n = v.get(e);
-		return n ? Y(n, t) ? (D = null, !0) : (D = {
-			id: e,
-			options: t
-		}, !0) : C === 0 && (D = {
-			id: e,
-			options: t
-		}, h(!1), !0);
-	}, Z = () => {
-		let e = l();
-		if (!e) {
-			O = null;
-			return;
-		}
-		let t = e.getBoundingClientRect(), n = L().find((e) => {
-			if (!e.dataset.messageId) return !1;
-			let n = e.getBoundingClientRect();
-			return n.bottom > t.top && n.top < t.bottom;
-		}) ?? null;
-		O = n ? {
-			element: n,
-			viewportTop: z(n)
-		} : null;
-	}, ye = () => {
-		let e = O, t = l();
-		if (!e || !t || !e.element.isConnected) return !1;
-		let n = z(e.element) - e.viewportTop;
-		return Math.abs(n) <= r ? !1 : (t.scrollTop += n, e.viewportTop = z(e.element), U(), W(), !0);
-	}, be = (e, t) => {
-		for (let n = t; n < e.length; n += 1) {
-			let t = e[n];
-			if (t?.dataset.scrollAnchor === "true") return t;
-		}
-		return null;
-	}, xe = (e) => e.find((e) => e.dataset.scrollAnchor === "true" && !b.has(e)) ?? null, Se = (e, t) => {
-		let n = 0;
-		for (let r = t; r < e.length; r += 1) if (e[r]?.dataset.scrollAnchor === "true" && (n += 1, n > 1)) return !0;
-		return !1;
-	}, Q = () => {
-		if (!u()) return;
-		let e = L(), t = C, n = w;
-		if (C = e.length, w = e[0] ?? null, e.length === 0 && h(!1), X()) {
-			Z();
-			return;
-		}
-		if (t === 0) {
-			for (let t of e) t.dataset.scrollAnchor === "true" && b.add(t);
-			if (ge()) {
-				Z();
-				return;
-			}
-			if (e.length > 0 && o().autoScroll && J({ behavior: "auto" })) {
-				Z();
-				return;
-			}
-			H(), W(), Z();
-			return;
-		}
-		let r = n ? e.indexOf(n) : -1;
-		if (f() && r > 0) {
-			ye(), Z();
-			return;
-		}
-		if (e.length > t) {
-			let n = be(e, t);
-			if (n) {
-				if (o().autoScroll && x === "following-bottom" && Se(e, t)) {
-					J({ behavior: "auto" }), Z();
-					return;
-				}
-				Y(n, { align: "start" }, { keepPreviousPeek: !0 }), b.add(n), Z();
-				return;
-			}
-		}
-		if (e.length === t) {
-			let t = xe(e);
-			if (t) {
-				Y(t, { align: "start" }, { keepPreviousPeek: !0 }), b.add(t), Z();
-				return;
-			}
-		}
-		x === "following-bottom" && o().autoScroll ? J({ behavior: "auto" }) : (H(), W()), Z();
-	}, Ce = () => {
-		if (x === "following-bottom" && o().autoScroll) {
-			J({ behavior: "auto" });
-			return;
-		}
-		let e = k;
-		if (he()) {
-			o().autoScroll && e > 0 && k === 0 && J({ behavior: "auto" });
-			return;
-		}
-		U(), W();
-	}, we = () => {
-		H(), W(), Z();
-	}, Te = () => {
-		(x === "following-bottom" || x === "anchored-to-message" || x === "settling-jump") && (G(!1), x = "free-scrolling");
-	}, Ee = () => {
-		let e = l(), t = u();
-		if (!e || !t) {
-			_([]), g(null);
-			return;
-		}
-		let n = e.getBoundingClientRect(), i = n.top + o().scrollMargin + o().scrollPreviousItemPeek, a = typeof IntersectionObserver > "u", s = [], c = null;
-		for (let e of L()) {
-			let t = e.dataset.messageId;
-			if (!t) continue;
-			let o = e.dataset.scrollAnchor === "true", l = o || a ? e.getBoundingClientRect() : null;
-			(a && l ? l.bottom > i && l.top < n.bottom : y.has(t)) && s.push(t), o && l && l.top <= i + r && (c = t);
-		}
-		if (s.length === 0 && c === null) {
-			_([]), g(null);
-			return;
-		}
-		_(s), g(c);
-	}, De = () => {
-		if (typeof IntersectionObserver > "u") {
-			W();
-			return;
-		}
-		let e = l();
-		!F && e && (F = new IntersectionObserver((e) => {
-			for (let t of e) {
-				let e = t.target.dataset.messageId;
-				e && (t.isIntersecting ? y.add(e) : y.delete(e));
-			}
-			W();
-		}, {
-			root: e,
-			rootMargin: `${-(o().scrollMargin + o().scrollPreviousItemPeek)}px 0px 0px 0px`,
-			threshold: [
-				0,
-				.01,
-				.5,
-				1
-			]
-		}));
-		for (let e of v.values()) F?.observe(e);
-		W();
-	}, Oe = () => {
-		N !== null && (window.cancelAnimationFrame(N), N = null), F?.disconnect(), F = null, y.clear(), _([]), g(null);
-	}, ke = () => {
-		I += 1, I === 1 && De(), W();
-		let e = !1;
-		return () => {
-			e || (e = !0, --I, I === 0 && Oe());
-		};
-	}, $ = (e, t, n) => {
+function l(l) {
+	let [u, d] = o(), [f, p] = o(), [m, h] = o(), [g, _] = o(!0), v = /* @__PURE__ */ new Map(), y = e({
+		viewport: u,
+		content: f,
+		spacer: m
+	}), { items: b, contentBottom: x } = y, S = i({
+		viewport: u,
+		content: f,
+		items: b,
+		options: l,
+		registeredElements: () => v.values()
+	}), { currentAnchorId: C, visibleMessageIds: w, schedule: T } = S, E = r({
+		viewport: u,
+		options: l,
+		contentBottom: x
+	}), { scrollableStart: D, scrollableEnd: O, autoscrolling: k, commit: A, schedule: j, releaseFollow: M } = E, N = n({
+		viewport: u,
+		content: f,
+		spacer: m,
+		options: l,
+		measure: y,
+		state: E,
+		scheduleVisibility: T
+	}), P = t({
+		viewport: u,
+		content: f,
+		options: l,
+		measure: y,
+		commands: N,
+		state: E,
+		scheduleState: j,
+		commitState: A,
+		scheduleVisibility: T,
+		preserveScrollOnPrepend: g,
+		getMessageElement: (e) => v.get(e)
+	}), { pendingScroll: F, scrollToStart: I, scrollToEnd: L, scrollToMessage: R, handleContentChange: z, handleResize: B, syncAfterScroll: V } = P, H = (e, t, n) => {
 		if (t) {
-			v.set(e, t), F?.observe(t), W(), D?.id === e && _e();
+			v.set(e, t), S.observe(t), T(), P.notifyMessageRegistered(e);
 			return;
 		}
-		n && v.get(e) === n && (v.delete(e), y.delete(e), F?.unobserve(n), W());
+		n && v.get(e) === n && (v.delete(e), S.unobserve(e, n), T());
 	};
-	return e(() => {
-		let e = u();
+	return a(() => {
+		let e = f();
 		if (!e) return;
-		Q();
-		let t = typeof MutationObserver < "u" ? new MutationObserver(() => Q()) : null;
+		z();
+		let t = typeof MutationObserver < "u" ? new MutationObserver(() => z()) : null;
 		t?.observe(e, { childList: !0 });
-		let r = typeof MutationObserver < "u" ? new MutationObserver(() => Q()) : null;
-		r?.observe(e, {
+		let n = typeof MutationObserver < "u" ? new MutationObserver(() => z()) : null;
+		n?.observe(e, {
 			attributes: !0,
 			attributeFilter: ["data-scroll-anchor"],
 			subtree: !0
 		});
-		let i = 0, a = typeof ResizeObserver < "u" ? new ResizeObserver(() => {
-			window.cancelAnimationFrame(i), i = window.requestAnimationFrame(Ce);
+		let r = 0, i = typeof ResizeObserver < "u" ? new ResizeObserver(() => {
+			window.cancelAnimationFrame(r), r = window.requestAnimationFrame(B);
 		}) : null;
-		a?.observe(e), n(() => {
-			t?.disconnect(), r?.disconnect(), a?.disconnect(), window.cancelAnimationFrame(i);
+		i?.observe(e), s(() => {
+			t?.disconnect(), n?.disconnect(), i?.disconnect(), window.cancelAnimationFrame(r);
 		});
-	}), e(() => {
-		let e = l();
+	}), a(() => {
+		let e = u();
 		if (!e) return;
-		I > 0 && !F && De();
-		let t = () => we(), r = () => Te(), i = (e) => {
-			a.has(e.key) && Te();
+		S.ensureObserver();
+		let t = () => V(), n = () => M(), r = (e) => {
+			c.has(e.key) && M();
 		};
-		e.addEventListener("scroll", t, { passive: !0 }), e.addEventListener("wheel", r, { passive: !0 }), e.addEventListener("touchmove", r, { passive: !0 }), e.addEventListener("keydown", i);
-		let o = 0, s = typeof ResizeObserver < "u" ? new ResizeObserver(() => {
-			window.cancelAnimationFrame(o), o = window.requestAnimationFrame(Ce);
+		e.addEventListener("scroll", t, { passive: !0 }), e.addEventListener("wheel", n, { passive: !0 }), e.addEventListener("touchmove", n, { passive: !0 }), e.addEventListener("keydown", r);
+		let i = 0, a = typeof ResizeObserver < "u" ? new ResizeObserver(() => {
+			window.cancelAnimationFrame(i), i = window.requestAnimationFrame(B);
 		}) : null;
-		s?.observe(e), n(() => {
-			e.removeEventListener("scroll", t), e.removeEventListener("wheel", r), e.removeEventListener("touchmove", r), e.removeEventListener("keydown", i), s?.disconnect(), window.cancelAnimationFrame(o);
+		a?.observe(e), s(() => {
+			e.removeEventListener("scroll", t), e.removeEventListener("wheel", n), e.removeEventListener("touchmove", n), e.removeEventListener("keydown", r), a?.disconnect(), window.cancelAnimationFrame(i);
 		});
-	}), n(() => {
-		j !== null && window.clearTimeout(j), M !== null && window.cancelAnimationFrame(M), P !== null && window.cancelAnimationFrame(P), N !== null && window.cancelAnimationFrame(N), F?.disconnect(), F = null;
+	}), s(() => {
+		P.dispose(), E.dispose(), S.dispose();
 	}), {
-		viewport: l,
-		setViewport: ee,
-		content: u,
-		setContent: te,
+		viewport: u,
+		setViewport: d,
+		content: f,
+		setContent: p,
 		setSpacer: (e) => {
-			ne(e), A = c(e?.parentElement ?? null);
+			h(e);
 		},
 		registerItem: (e) => {
 			let t = e.id;
-			return t && $(t, e.element), () => {
-				t && $(t, void 0, e.element);
+			return t && H(t, e.element), () => {
+				t && H(t, void 0, e.element);
 			};
 		},
-		preserveScrollOnPrepend: f,
-		setPreserveScrollOnPrepend: re,
-		scrollableStart: ie,
-		scrollableEnd: oe,
-		autoscrolling: p,
-		pendingScroll: ce,
-		scrollToStart: q,
-		scrollToEnd: J,
-		scrollToMessage: ve,
-		currentAnchorId: le,
-		visibleMessageIds: ue,
-		subscribeVisibility: ke,
-		options: o
+		preserveScrollOnPrepend: g,
+		setPreserveScrollOnPrepend: _,
+		scrollableStart: D,
+		scrollableEnd: O,
+		autoscrolling: k,
+		pendingScroll: F,
+		scrollToStart: I,
+		scrollToEnd: L,
+		scrollToMessage: R,
+		currentAnchorId: C,
+		visibleMessageIds: w,
+		subscribeVisibility: S.subscribe,
+		options: l
 	};
 }
 //#endregion

package/dist/components/message-scroller/useMessageScrollerEngine.js.map

@@ -1 +1 @@
-{"version":3,"file":"useMessageScrollerEngine.js","names":["AT_EDGE_TOLERANCE","AUTO_SCROLLING_TIMEOUT_MS","NAV_KEYS","parsePx","parsed","value","paddingBox","style","element","rowGap","useMessageScrollerEngine","viewport","setViewport","createSignal","content","setContent","spacer","setSpacer","preserveScrollOnPrepend","setPreserveScrollOnPrepend","scrollableStart","setScrollableStart","scrollableEnd","setScrollableEnd","autoscrolling","setAutoscrolling","pendingScroll","setPendingScroll","options","currentAnchorId","setCurrentAnchorId","visibleMessageIds","setVisibleMessageIds","messageElements","visibleIds","handledScrollAnchors","mode","lastScrollTop","itemCount","firstItem","defaultApplied","streamingTurn","pendingMessage","prependAnchor","spacerHeight","spacerGap","autoscrollingTimer","stateFrame","visibilityFrame","pendingFrame","observer","visibilitySubscribers","items","root","sp","child","itemOffsetTop","vp","itemTopInViewport","contentBottom","pad","vpRect","bottom","item","rect","maxScrollTop","setSpacerHeight","next","height","computeScrollable","threshold","updateModeFromScroll","top","movedUp","state","commitScrollState","exposed","scheduleStateCommit","scheduleVisibilitySync","computeVisibility","applyAutoscrolling","setScrollTop","auto","scrollToStart","command","scrollToEnd","targetTopFor","itemTop","visible","margin","vTop","vBottom","scrollToElement","keepPreviousPeek","target","reanchorToAnchoredMessage","el","applyDefaultScrollPosition","position","applied","lastAnchor","flushPendingScrollToMessage","pending","schedulePendingFlush","capturePrependAnchor","scrollToMessage","messageId","firstVisible","restorePrependAnchor","anchor","delta","firstAnchorFrom","index","from","list","firstUnhandledAnchor","hasMultipleAnchorsFrom","count","handleContentChange","previousCount","previousFirst","previousFirstIndex","firstNewAnchor","unhandled","handleResize","before","syncAfterScroll","releaseFollow","readingLine","hasObserver","anchorId","id","isAnchor","startVisibilityObserver","entry","entries","stopVisibilityObserver","subscribeVisibility","released","registerMessage","previous","createEffect","mutation","anchorMutation","frame","resize","onCleanup","onScroll","onIntent","onKeyDown","event"],"sources":["../../../src/components/message-scroller/useMessageScrollerEngine.ts"],"sourcesContent":["import { createEffect, createSignal, onCleanup } from \"solid-js\";\nimport type {\n  MessageScrollerContextValue,\n  MessageScrollerItemEntry,\n  MessageScrollerProviderProps,\n  MessageScrollerScrollOptions,\n} from \"./message-scroller.types\";\n\n/** 滚动位置比较容差（0.5px），对应上游的 `J` */\nconst AT_EDGE_TOLERANCE = 0.5;\n/** 「滚动到最新」后 data-autoscrolling 的持续时间 */\nconst AUTO_SCROLLING_TIMEOUT_MS = 180;\n/** 会让界面「让位」的键盘滚动键 */\nconst NAV_KEYS = new Set([\n  \"ArrowDown\",\n  \"ArrowUp\",\n  \"End\",\n  \"Home\",\n  \"PageDown\",\n  \"PageUp\",\n  \" \",\n]);\n\ntype Mode =\n  | \"following-bottom\"\n  | \"free-scrolling\"\n  | \"anchored-to-message\"\n  | \"settling-jump\";\n\ninterface ScrollState {\n  start: boolean;\n  end: boolean;\n}\n\ninterface PaddingBox {\n  start: number;\n  end: number;\n}\n\nfunction parsePx(value: string): number {\n  const parsed = Number.parseFloat(value);\n  return Number.isFinite(parsed) ? parsed : 0;\n}\n\nfunction paddingBox(element: HTMLElement): PaddingBox {\n  const style = window.getComputedStyle(element);\n  return {\n    start: parsePx(style.paddingBlockStart || style.paddingTop),\n    end: parsePx(style.paddingBlockEnd || style.paddingBottom),\n  };\n}\n\nfunction rowGap(element: HTMLElement | null): number {\n  if (!element) return 0;\n  const style = window.getComputedStyle(element);\n  return parsePx(style.rowGap === \"normal\" ? style.gap : style.rowGap);\n}\n\n/**\n * MessageScroller 的滚动引擎（headless，行为对齐 `@shadcn/react`）：\n * - 滚动状态（能否向上/下）由 content 的**非 spacer** 内容底部计算，spacer 不计入；\n * - `autoScroll` 只在模式为 `following-bottom` 时跟随；滚轮/触摸/键盘滚动与显式跳转\n *   都会立刻让位（`free-scrolling`）；\n * - 新回合锚定：新增 scrollAnchor 行时用 `scrollToElement(keepPreviousPeek)` 将其放到\n *   顶部并保留上一项；同时把该行记为 `streamingTurn`，回复生长时原地重锚定；\n * - `scrollToElement` 会按需设置尾部 spacer，让目标行即使靠近会话末尾也能滚到顶部；\n * - `defaultScrollPosition`：首次非空渲染定位一次；`last-anchor` 无锚点或放得下时回退 end；\n * - `preserveScrollOnPrepend`：记录首个可见行及其视口位置，上方插入历史后按差值补偿；\n * - 可见性：IntersectionObserver 按需订阅（rootMargin 用 scrollMargin + peek），无 IO 时退化为\n *   逐帧测量；`currentAnchorId` 是阅读行之上最后一个锚点。\n */\nexport function useMessageScrollerEngine(\n  options: () => Required<Omit<MessageScrollerProviderProps, \"children\">>,\n): MessageScrollerContextValue {\n  const [viewport, setViewport] = createSignal<HTMLElement>();\n  const [content, setContent] = createSignal<HTMLElement>();\n  const [spacer, setSpacer] = createSignal<HTMLElement>();\n  const [preserveScrollOnPrepend, setPreserveScrollOnPrepend] =\n    createSignal(true);\n  const [scrollableStart, setScrollableStart] = createSignal(false);\n  const [scrollableEnd, setScrollableEnd] = createSignal(false);\n  const [autoscrolling, setAutoscrolling] = createSignal(false);\n  const [pendingScroll, setPendingScroll] = createSignal(\n    options().defaultScrollPosition !== \"start\",\n  );\n  const [currentAnchorId, setCurrentAnchorId] = createSignal<string | null>(\n    null,\n  );\n  const [visibleMessageIds, setVisibleMessageIds] = createSignal<string[]>([]);\n\n  const messageElements = new Map<string, HTMLElement>();\n  const visibleIds = new Set<string>();\n  const handledScrollAnchors = new WeakSet<HTMLElement>();\n\n  let mode: Mode = options().autoScroll ? \"following-bottom\" : \"free-scrolling\";\n  let lastScrollTop = 0;\n  let itemCount = 0;\n  let firstItem: HTMLElement | null = null;\n  let defaultApplied = false;\n  let streamingTurn: HTMLElement | null = null;\n  let pendingMessage: {\n    id: string;\n    options?: MessageScrollerScrollOptions;\n  } | null = null;\n  let prependAnchor: { element: HTMLElement; viewportTop: number } | null =\n    null;\n  let spacerHeight = 0;\n  let spacerGap = 0;\n  let autoscrollingTimer: number | null = null;\n  let stateFrame: number | null = null;\n  let visibilityFrame: number | null = null;\n  let pendingFrame: number | null = null;\n  let observer: IntersectionObserver | null = null;\n  let visibilitySubscribers = 0;\n\n  /** content 的直接子元素，排除内部 spacer */\n  const items = (): HTMLElement[] => {\n    const root = content();\n    const sp = spacer();\n    if (!root) return [];\n    return Array.from(root.children).filter(\n      (child): child is HTMLElement =>\n        child instanceof HTMLElement && child !== sp,\n    );\n  };\n\n  /** 行相对滚动容器内容顶部的偏移（用测量，避免 offsetParent 不确定） */\n  const itemOffsetTop = (element: HTMLElement) => {\n    const vp = viewport();\n    if (!vp) return 0;\n    return (\n      element.getBoundingClientRect().top -\n      vp.getBoundingClientRect().top +\n      vp.scrollTop\n    );\n  };\n\n  const itemTopInViewport = (element: HTMLElement) => {\n    const vp = viewport();\n    if (!vp) return 0;\n    return element.getBoundingClientRect().top - vp.getBoundingClientRect().top;\n  };\n\n  /** 内容底部（不含 spacer），即内容真实滚动高度 */\n  const contentBottom = () => {\n    const vp = viewport();\n    const root = content();\n    if (!vp || !root) return 0;\n    const pad = paddingBox(root);\n    const vpRect = vp.getBoundingClientRect();\n    let bottom = pad.start + pad.end;\n    for (const item of items()) {\n      const rect = item.getBoundingClientRect();\n      bottom = Math.max(\n        bottom,\n        rect.bottom - vpRect.top + vp.scrollTop + pad.end,\n      );\n    }\n    return bottom;\n  };\n\n  const maxScrollTop = () => {\n    const vp = viewport();\n    return vp ? Math.max(0, vp.scrollHeight - vp.clientHeight) : 0;\n  };\n\n  /** 设置尾部 spacer：让目标行有空间滚到指定位置；0 时隐藏 */\n  const setSpacerHeight = (height: number) => {\n    const sp = spacer();\n    if (!sp) return;\n    const next = Math.max(0, Math.ceil(height));\n    if (spacerHeight === next) return;\n    spacerHeight = next;\n    sp.hidden = next === 0;\n    sp.style.height = `${next}px`;\n    sp.style.marginTop = next > 0 ? `${-spacerGap}px` : \"\";\n  };\n\n  const computeScrollable = (): ScrollState => {\n    const vp = viewport();\n    const root = content();\n    if (!vp || !root) return { start: false, end: false };\n    const threshold = options().scrollEdgeThreshold;\n    const bottom = contentBottom();\n    return {\n      start: vp.scrollTop > threshold,\n      end: bottom - vp.scrollTop - vp.clientHeight > threshold,\n    };\n  };\n\n  const updateModeFromScroll = (state: ScrollState) => {\n    const vp = viewport();\n    if (!vp) return;\n    const top = vp.scrollTop;\n    const movedUp = top < lastScrollTop - AT_EDGE_TOLERANCE;\n    lastScrollTop = top;\n    if (\n      options().autoScroll &&\n      !state.end &&\n      mode !== \"settling-jump\" &&\n      mode !== \"anchored-to-message\"\n    ) {\n      mode = \"following-bottom\";\n    } else if (\n      mode === \"following-bottom\" &&\n      state.end &&\n      movedUp &&\n      !autoscrolling()\n    ) {\n      mode = \"free-scrolling\";\n    }\n  };\n\n  const commitScrollState = () => {\n    const state = computeScrollable();\n    updateModeFromScroll(state);\n    // 跟随输出时对 UI 隐藏「还能向下滚」——按钮不出现，直到读者回到实时边缘\n    const exposed =\n      mode === \"following-bottom\" ? { ...state, end: false } : state;\n    setScrollableStart(exposed.start);\n    setScrollableEnd(exposed.end);\n  };\n\n  const scheduleStateCommit = () => {\n    if (stateFrame !== null) return;\n    stateFrame = window.requestAnimationFrame(() => {\n      stateFrame = null;\n      commitScrollState();\n    });\n  };\n\n  const scheduleVisibilitySync = () => {\n    if (visibilityFrame !== null) return;\n    visibilityFrame = window.requestAnimationFrame(() => {\n      visibilityFrame = null;\n      if (visibilitySubscribers > 0) computeVisibility();\n    });\n  };\n\n  const applyAutoscrolling = (next: boolean) => {\n    if (autoscrollingTimer !== null) {\n      window.clearTimeout(autoscrollingTimer);\n      autoscrollingTimer = null;\n    }\n    if (autoscrolling() !== next) {\n      setAutoscrolling(next);\n      commitScrollState();\n    }\n    if (next) {\n      autoscrollingTimer = window.setTimeout(() => {\n        autoscrollingTimer = null;\n        setAutoscrolling(false);\n        commitScrollState();\n      }, AUTO_SCROLLING_TIMEOUT_MS);\n    }\n  };\n\n  const setScrollTop = (\n    top: number,\n    {\n      behavior = \"auto\" as ScrollBehavior,\n      auto = false,\n    }: { behavior?: ScrollBehavior; auto?: boolean } = {},\n  ) => {\n    const vp = viewport();\n    if (!vp) return;\n    const next = Math.max(0, top);\n    if (Math.abs(vp.scrollTop - next) <= AT_EDGE_TOLERANCE) {\n      vp.scrollTop = next;\n      commitScrollState();\n      return;\n    }\n    if (auto) applyAutoscrolling(true);\n    vp.scrollTo({ top: next, behavior });\n    scheduleStateCommit();\n  };\n\n  const scrollToStart = (command?: MessageScrollerScrollOptions) => {\n    if (!viewport()) return false;\n    setSpacerHeight(0);\n    streamingTurn = null;\n    mode = \"free-scrolling\";\n    setScrollTop(0, { behavior: command?.behavior ?? \"auto\" });\n    scheduleVisibilitySync();\n    return true;\n  };\n\n  const scrollToEnd = (command?: MessageScrollerScrollOptions) => {\n    if (!viewport()) return false;\n    setSpacerHeight(0);\n    streamingTurn = null;\n    mode = options().autoScroll ? \"following-bottom\" : \"free-scrolling\";\n    setScrollTop(maxScrollTop(), {\n      behavior: command?.behavior ?? \"auto\",\n      auto: true,\n    });\n    scheduleVisibilitySync();\n    return true;\n  };\n\n  const targetTopFor = (\n    element: HTMLElement,\n    command: MessageScrollerScrollOptions | undefined,\n    margin: number,\n  ) => {\n    const vp = viewport();\n    if (!vp) return 0;\n    const pad = content() ? paddingBox(content()!) : { start: 0, end: 0 };\n    const itemTop = itemOffsetTop(element);\n    const height = element.getBoundingClientRect().height;\n    switch (command?.align ?? \"start\") {\n      case \"center\": {\n        const visible = Math.max(0, vp.clientHeight - pad.start - pad.end);\n        return itemTop - pad.start - (visible - height) / 2 - margin;\n      }\n      case \"end\":\n        return itemTop - vp.clientHeight + height + pad.end + margin;\n      case \"nearest\": {\n        const bottom = itemTop + height;\n        const vTop = vp.scrollTop + pad.start;\n        const vBottom = vp.scrollTop + vp.clientHeight - pad.end;\n        if (itemTop >= vTop && bottom <= vBottom) return vp.scrollTop;\n        if (itemTop < vTop) return itemTop - pad.start - margin;\n        return bottom - vp.clientHeight + pad.end + margin;\n      }\n      default:\n        return itemTop - pad.start - margin;\n    }\n  };\n\n  const scrollToElement = (\n    element: HTMLElement,\n    command?: MessageScrollerScrollOptions,\n    { keepPreviousPeek = false }: { keepPreviousPeek?: boolean } = {},\n  ) => {\n    const vp = viewport();\n    const root = content();\n    if (!vp || !root?.contains(element)) return false;\n    const margin =\n      (command?.scrollMargin ?? options().scrollMargin) +\n      (keepPreviousPeek ? options().scrollPreviousItemPeek : 0);\n    const target = targetTopFor(element, command, margin);\n    setSpacerHeight(Math.max(0, target + vp.clientHeight - contentBottom()));\n    prependAnchor = { element, viewportTop: itemTopInViewport(element) };\n    mode = keepPreviousPeek ? \"anchored-to-message\" : \"settling-jump\";\n    streamingTurn = keepPreviousPeek ? element : null;\n    setScrollTop(target, { behavior: command?.behavior ?? \"auto\" });\n    scheduleVisibilitySync();\n    return true;\n  };\n\n  const reanchorToAnchoredMessage = () => {\n    const el = streamingTurn;\n    if (!el?.isConnected || mode !== \"anchored-to-message\") return false;\n    return scrollToElement(el, { align: \"start\" }, { keepPreviousPeek: true });\n  };\n\n  const applyDefaultScrollPosition = () => {\n    const vp = viewport();\n    if (!vp || defaultApplied || itemCount === 0) return false;\n    const position = options().defaultScrollPosition;\n    let applied = false;\n    if (position === \"last-anchor\") {\n      const list = items();\n      const lastAnchor =\n        [...list].reverse().find((el) => el.dataset.scrollAnchor === \"true\") ??\n        null;\n      if (!lastAnchor) {\n        applied = scrollToEnd({ behavior: \"auto\" });\n      } else if (\n        contentBottom() - itemOffsetTop(lastAnchor) <=\n        vp.clientHeight\n      ) {\n        // 该回合完全放得下 → 直接到底\n        applied = scrollToEnd({ behavior: \"auto\" });\n      } else {\n        applied = scrollToElement(\n          lastAnchor,\n          { align: \"start\" },\n          { keepPreviousPeek: true },\n        );\n      }\n    } else if (position === \"end\") {\n      applied = scrollToEnd({ behavior: \"auto\" });\n    } else {\n      applied = scrollToStart({ behavior: \"auto\" });\n    }\n    if (applied) {\n      defaultApplied = true;\n      setPendingScroll(false);\n    }\n    return applied;\n  };\n\n  const flushPendingScrollToMessage = () => {\n    const pending = pendingMessage;\n    if (!pending) return false;\n    const element = messageElements.get(pending.id);\n    if (!element || !scrollToElement(element, pending.options)) return false;\n    pendingMessage = null;\n    defaultApplied = true;\n    setPendingScroll(false);\n    return true;\n  };\n\n  const schedulePendingFlush = () => {\n    if (pendingFrame !== null) return;\n    pendingFrame = window.requestAnimationFrame(() => {\n      pendingFrame = null;\n      if (flushPendingScrollToMessage()) capturePrependAnchor();\n    });\n  };\n\n  const scrollToMessage = (\n    messageId: string,\n    command?: MessageScrollerScrollOptions,\n  ) => {\n    const element = messageElements.get(messageId);\n    if (element) {\n      if (scrollToElement(element, command)) {\n        pendingMessage = null;\n        return true;\n      }\n      pendingMessage = { id: messageId, options: command };\n      return true;\n    }\n    // 会话尚未挂载任何行时可排队（客户端解析永久链接）；已挂载但缺失则返回 false\n    if (itemCount === 0) {\n      pendingMessage = { id: messageId, options: command };\n      setPendingScroll(false);\n      return true;\n    }\n    return false;\n  };\n\n  const capturePrependAnchor = () => {\n    const vp = viewport();\n    if (!vp) {\n      prependAnchor = null;\n      return;\n    }\n    const vpRect = vp.getBoundingClientRect();\n    const firstVisible =\n      items().find((el) => {\n        if (!el.dataset.messageId) return false;\n        const rect = el.getBoundingClientRect();\n        return rect.bottom > vpRect.top && rect.top < vpRect.bottom;\n      }) ?? null;\n    prependAnchor = firstVisible\n      ? { element: firstVisible, viewportTop: itemTopInViewport(firstVisible) }\n      : null;\n  };\n\n  const restorePrependAnchor = () => {\n    const anchor = prependAnchor;\n    const vp = viewport();\n    if (!anchor || !vp || !anchor.element.isConnected) return false;\n    const delta = itemTopInViewport(anchor.element) - anchor.viewportTop;\n    if (Math.abs(delta) <= AT_EDGE_TOLERANCE) return false;\n    vp.scrollTop += delta;\n    anchor.viewportTop = itemTopInViewport(anchor.element);\n    scheduleStateCommit();\n    scheduleVisibilitySync();\n    return true;\n  };\n\n  const firstAnchorFrom = (list: HTMLElement[], from: number) => {\n    for (let index = from; index < list.length; index += 1) {\n      const el = list[index];\n      if (el?.dataset.scrollAnchor === \"true\") return el;\n    }\n    return null;\n  };\n\n  const firstUnhandledAnchor = (list: HTMLElement[]) =>\n    list.find(\n      (el) =>\n        el.dataset.scrollAnchor === \"true\" && !handledScrollAnchors.has(el),\n    ) ?? null;\n\n  const hasMultipleAnchorsFrom = (list: HTMLElement[], from: number) => {\n    let count = 0;\n    for (let index = from; index < list.length; index += 1) {\n      if (list[index]?.dataset.scrollAnchor === \"true\") {\n        count += 1;\n        if (count > 1) return true;\n      }\n    }\n    return false;\n  };\n\n  const handleContentChange = () => {\n    const root = content();\n    if (!root) return;\n    const list = items();\n    const previousCount = itemCount;\n    const previousFirst = firstItem;\n    itemCount = list.length;\n    firstItem = list[0] ?? null;\n\n    // 空会话不隐藏视口（data-pending-scroll 跳过）\n    if (list.length === 0) setPendingScroll(false);\n\n    if (flushPendingScrollToMessage()) {\n      capturePrependAnchor();\n      return;\n    }\n\n    if (previousCount === 0) {\n      // 初次定位时把已存在的锚点标记为已处理，避免后续 resize/属性变化误触发重锚定\n      for (const el of list) {\n        if (el.dataset.scrollAnchor === \"true\") handledScrollAnchors.add(el);\n      }\n      if (applyDefaultScrollPosition()) {\n        capturePrependAnchor();\n        return;\n      }\n      if (\n        list.length > 0 &&\n        options().autoScroll &&\n        scrollToEnd({ behavior: \"auto\" })\n      ) {\n        capturePrependAnchor();\n        return;\n      }\n      commitScrollState();\n      scheduleVisibilitySync();\n      capturePrependAnchor();\n      return;\n    }\n\n    const previousFirstIndex = previousFirst ? list.indexOf(previousFirst) : -1;\n    if (preserveScrollOnPrepend() && previousFirstIndex > 0) {\n      restorePrependAnchor();\n      capturePrependAnchor();\n      return;\n    }\n\n    if (list.length > previousCount) {\n      const firstNewAnchor = firstAnchorFrom(list, previousCount);\n      if (firstNewAnchor) {\n        // 同批新增多个锚点：跟随底部，避免在多个锚点间跳来跳去\n        if (\n          options().autoScroll &&\n          mode === \"following-bottom\" &&\n          hasMultipleAnchorsFrom(list, previousCount)\n        ) {\n          scrollToEnd({ behavior: \"auto\" });\n          capturePrependAnchor();\n          return;\n        }\n        scrollToElement(\n          firstNewAnchor,\n          { align: \"start\" },\n          { keepPreviousPeek: true },\n        );\n        handledScrollAnchors.add(firstNewAnchor);\n        capturePrependAnchor();\n        return;\n      }\n    }\n\n    // 行数没变但出现了未处理的新锚点（例如给已有行打开 scrollAnchor）\n    if (list.length === previousCount) {\n      const unhandled = firstUnhandledAnchor(list);\n      if (unhandled) {\n        scrollToElement(\n          unhandled,\n          { align: \"start\" },\n          { keepPreviousPeek: true },\n        );\n        handledScrollAnchors.add(unhandled);\n        capturePrependAnchor();\n        return;\n      }\n    }\n\n    if (mode === \"following-bottom\" && options().autoScroll) {\n      scrollToEnd({ behavior: \"auto\" });\n    } else {\n      commitScrollState();\n      scheduleVisibilitySync();\n    }\n    capturePrependAnchor();\n  };\n\n  const handleResize = () => {\n    if (mode === \"following-bottom\" && options().autoScroll) {\n      scrollToEnd({ behavior: \"auto\" });\n      return;\n    }\n    const before = spacerHeight;\n    if (reanchorToAnchoredMessage()) {\n      if (options().autoScroll && before > 0 && spacerHeight === 0) {\n        scrollToEnd({ behavior: \"auto\" });\n      }\n      return;\n    }\n    scheduleStateCommit();\n    scheduleVisibilitySync();\n  };\n\n  const syncAfterScroll = () => {\n    commitScrollState();\n    scheduleVisibilitySync();\n    capturePrependAnchor();\n  };\n\n  /** 滚轮/触摸/键盘滚动：立刻放弃跟随，把位置交还读者 */\n  const releaseFollow = () => {\n    if (\n      mode === \"following-bottom\" ||\n      mode === \"anchored-to-message\" ||\n      mode === \"settling-jump\"\n    ) {\n      applyAutoscrolling(false);\n      mode = \"free-scrolling\";\n    }\n  };\n\n  const computeVisibility = () => {\n    const vp = viewport();\n    const root = content();\n    if (!vp || !root) {\n      setVisibleMessageIds([]);\n      setCurrentAnchorId(null);\n      return;\n    }\n    const vpRect = vp.getBoundingClientRect();\n    const readingLine =\n      vpRect.top + options().scrollMargin + options().scrollPreviousItemPeek;\n    const hasObserver = typeof IntersectionObserver === \"undefined\";\n    const visible: string[] = [];\n    let anchorId: string | null = null;\n    for (const item of items()) {\n      const id = item.dataset.messageId;\n      if (!id) continue;\n      const isAnchor = item.dataset.scrollAnchor === \"true\";\n      const rect =\n        isAnchor || hasObserver ? item.getBoundingClientRect() : null;\n      const isVisible =\n        hasObserver && rect\n          ? rect.bottom > readingLine && rect.top < vpRect.bottom\n          : visibleIds.has(id);\n      if (isVisible) visible.push(id);\n      if (isAnchor && rect && rect.top <= readingLine + AT_EDGE_TOLERANCE) {\n        anchorId = id;\n      }\n    }\n    if (visible.length === 0 && anchorId === null) {\n      setVisibleMessageIds([]);\n      setCurrentAnchorId(null);\n      return;\n    }\n    setVisibleMessageIds(visible);\n    setCurrentAnchorId(anchorId);\n  };\n\n  const startVisibilityObserver = () => {\n    if (typeof IntersectionObserver === \"undefined\") {\n      scheduleVisibilitySync();\n      return;\n    }\n    const vp = viewport();\n    if (!observer && vp) {\n      observer = new IntersectionObserver(\n        (entries) => {\n          for (const entry of entries) {\n            const id = (entry.target as HTMLElement).dataset.messageId;\n            if (!id) continue;\n            if (entry.isIntersecting) visibleIds.add(id);\n            else visibleIds.delete(id);\n          }\n          scheduleVisibilitySync();\n        },\n        {\n          root: vp,\n          rootMargin: `${-(options().scrollMargin + options().scrollPreviousItemPeek)}px 0px 0px 0px`,\n          threshold: [0, 0.01, 0.5, 1],\n        },\n      );\n    }\n    for (const element of messageElements.values()) observer?.observe(element);\n    scheduleVisibilitySync();\n  };\n\n  const stopVisibilityObserver = () => {\n    if (visibilityFrame !== null) {\n      window.cancelAnimationFrame(visibilityFrame);\n      visibilityFrame = null;\n    }\n    observer?.disconnect();\n    observer = null;\n    visibleIds.clear();\n    setVisibleMessageIds([]);\n    setCurrentAnchorId(null);\n  };\n\n  const subscribeVisibility = () => {\n    visibilitySubscribers += 1;\n    if (visibilitySubscribers === 1) startVisibilityObserver();\n    scheduleVisibilitySync();\n    let released = false;\n    return () => {\n      if (released) return;\n      released = true;\n      visibilitySubscribers -= 1;\n      if (visibilitySubscribers === 0) stopVisibilityObserver();\n    };\n  };\n\n  const registerMessage = (\n    id: string,\n    element: HTMLElement | undefined,\n    previous?: HTMLElement,\n  ) => {\n    if (element) {\n      messageElements.set(id, element);\n      observer?.observe(element);\n      scheduleVisibilitySync();\n      if (pendingMessage?.id === id) schedulePendingFlush();\n      return;\n    }\n    if (previous && messageElements.get(id) === previous) {\n      messageElements.delete(id);\n      visibleIds.delete(id);\n      observer?.unobserve(previous);\n      scheduleVisibilitySync();\n    }\n  };\n\n  const registerItem = (entry: MessageScrollerItemEntry) => {\n    const id = entry.id;\n    if (id) registerMessage(id, entry.element);\n    return () => {\n      if (id) registerMessage(id, undefined, entry.element);\n    };\n  };\n\n  const setSpacerElement = (element: HTMLElement | undefined) => {\n    setSpacer(element);\n    spacerGap = rowGap(element?.parentElement ?? null);\n  };\n\n  // 内容观察：初次定位 / prepend 保位 / 新回合锚定 / 跟随 / 尺寸\n  createEffect(() => {\n    const root = content();\n    if (!root) return;\n    handleContentChange();\n\n    const mutation =\n      typeof MutationObserver !== \"undefined\"\n        ? new MutationObserver(() => handleContentChange())\n        : null;\n    mutation?.observe(root, { childList: true });\n\n    // 已有行切换 scrollAnchor（dataset 变化）也要重新锚定\n    const anchorMutation =\n      typeof MutationObserver !== \"undefined\"\n        ? new MutationObserver(() => handleContentChange())\n        : null;\n    anchorMutation?.observe(root, {\n      attributes: true,\n      attributeFilter: [\"data-scroll-anchor\"],\n      subtree: true,\n    });\n\n    let frame = 0;\n    const resize =\n      typeof ResizeObserver !== \"undefined\"\n        ? new ResizeObserver(() => {\n            window.cancelAnimationFrame(frame);\n            frame = window.requestAnimationFrame(handleResize);\n          })\n        : null;\n    resize?.observe(root);\n\n    onCleanup(() => {\n      mutation?.disconnect();\n      anchorMutation?.disconnect();\n      resize?.disconnect();\n      window.cancelAnimationFrame(frame);\n    });\n  });\n\n  // 视口：scroll / 用户滚动意图 / 尺寸\n  createEffect(() => {\n    const vp = viewport();\n    if (!vp) return;\n    if (visibilitySubscribers > 0 && !observer) startVisibilityObserver();\n\n    const onScroll = () => syncAfterScroll();\n    const onIntent = () => releaseFollow();\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (NAV_KEYS.has(event.key)) releaseFollow();\n    };\n    vp.addEventListener(\"scroll\", onScroll, { passive: true });\n    vp.addEventListener(\"wheel\", onIntent, { passive: true });\n    vp.addEventListener(\"touchmove\", onIntent, { passive: true });\n    vp.addEventListener(\"keydown\", onKeyDown);\n\n    let frame = 0;\n    const resize =\n      typeof ResizeObserver !== \"undefined\"\n        ? new ResizeObserver(() => {\n            window.cancelAnimationFrame(frame);\n            frame = window.requestAnimationFrame(handleResize);\n          })\n        : null;\n    resize?.observe(vp);\n\n    onCleanup(() => {\n      vp.removeEventListener(\"scroll\", onScroll);\n      vp.removeEventListener(\"wheel\", onIntent);\n      vp.removeEventListener(\"touchmove\", onIntent);\n      vp.removeEventListener(\"keydown\", onKeyDown);\n      resize?.disconnect();\n      window.cancelAnimationFrame(frame);\n    });\n  });\n\n  onCleanup(() => {\n    if (autoscrollingTimer !== null) window.clearTimeout(autoscrollingTimer);\n    if (stateFrame !== null) window.cancelAnimationFrame(stateFrame);\n    if (pendingFrame !== null) window.cancelAnimationFrame(pendingFrame);\n    if (visibilityFrame !== null) window.cancelAnimationFrame(visibilityFrame);\n    observer?.disconnect();\n    observer = null;\n  });\n\n  return {\n    viewport,\n    setViewport,\n    content,\n    setContent,\n    setSpacer: setSpacerElement,\n    registerItem,\n    preserveScrollOnPrepend,\n    setPreserveScrollOnPrepend,\n    scrollableStart,\n    scrollableEnd,\n    autoscrolling,\n    pendingScroll,\n    scrollToStart,\n    scrollToEnd,\n    scrollToMessage,\n    currentAnchorId,\n    visibleMessageIds,\n    subscribeVisibility,\n    options,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"useMessageScrollerEngine.js","names":["NAV_KEYS","useMessageScrollerEngine","viewport","setViewport","createSignal","content","setContent","spacer","setSpacerSignal","preserveScrollOnPrepend","setPreserveScrollOnPrepend","messageElements","measure","createDomMeasure","visibility","createVisibility","scheduleVisibilitySync","scrollState","createScrollState","commitScrollState","scheduleStateCommit","commands","createScrollCommands","anchoring","createAnchoring","id","registerMessage","element","previous","createEffect","root","mutation","handleContentChange","anchorMutation","frame","resize","handleResize","onCleanup","vp","onScroll","syncAfterScroll","onIntent","releaseFollow","onKeyDown","event","entry"],"sources":["../../../src/components/message-scroller/useMessageScrollerEngine.ts"],"sourcesContent":["import { createEffect, createSignal, onCleanup } from \"solid-js\";\nimport type {\n  MessageScrollerContextValue,\n  MessageScrollerItemEntry,\n  MessageScrollerProviderProps,\n} from \"./message-scroller.types\";\nimport { createDomMeasure } from \"./message-scroller.dom-measure\";\nimport { createAnchoring } from \"./message-scroller.anchoring\";\nimport { createScrollCommands } from \"./message-scroller.commands\";\nimport { createScrollState } from \"./message-scroller.scroll-state\";\nimport { createVisibility } from \"./message-scroller.visibility\";\n\n/** 会让界面「让位」的键盘滚动键 */\nconst NAV_KEYS = new Set([\n  \"ArrowDown\",\n  \"ArrowUp\",\n  \"End\",\n  \"Home\",\n  \"PageDown\",\n  \"PageUp\",\n  \" \",\n]);\n\n/**\n * MessageScroller 的滚动引擎（headless，行为对齐 `@shadcn/react`）：\n * - 滚动状态（能否向上/下）由 content 的**非 spacer** 内容底部计算，spacer 不计入；\n * - `autoScroll` 只在模式为 `following-bottom` 时跟随；滚轮/触摸/键盘滚动与显式跳转\n *   都会立刻让位（`free-scrolling`）；\n * - 新回合锚定：新增 scrollAnchor 行时用 `scrollToElement(keepPreviousPeek)` 将其放到\n *   顶部并保留上一项；同时把该行记为 `streamingTurn`，回复生长时原地重锚定；\n * - `scrollToElement` 会按需设置尾部 spacer，让目标行即使靠近会话末尾也能滚到顶部；\n * - `defaultScrollPosition`：首次非空渲染定位一次；`last-anchor` 无锚点或放得下时回退 end；\n * - `preserveScrollOnPrepend`：记录首个可见行及其视口位置，上方插入历史后按差值补偿；\n * - 可见性：IntersectionObserver 按需订阅（rootMargin 用 scrollMargin + peek），无 IO 时退化为\n *   逐帧测量；`currentAnchorId` 是阅读行之上最后一个锚点。\n */\nexport function useMessageScrollerEngine(\n  options: () => Required<Omit<MessageScrollerProviderProps, \"children\">>,\n): MessageScrollerContextValue {\n  const [viewport, setViewport] = createSignal<HTMLElement>();\n  const [content, setContent] = createSignal<HTMLElement>();\n  const [spacer, setSpacerSignal] = createSignal<HTMLElement>();\n  const [preserveScrollOnPrepend, setPreserveScrollOnPrepend] =\n    createSignal(true);\n\n  const messageElements = new Map<string, HTMLElement>();\n\n  const measure = createDomMeasure({ viewport, content, spacer });\n  const { items, contentBottom } = measure;\n\n  const visibility = createVisibility({\n    viewport,\n    content,\n    items,\n    options,\n    registeredElements: () => messageElements.values(),\n  });\n  const {\n    currentAnchorId,\n    visibleMessageIds,\n    schedule: scheduleVisibilitySync,\n  } = visibility;\n\n  const scrollState = createScrollState({ viewport, options, contentBottom });\n  const {\n    scrollableStart,\n    scrollableEnd,\n    autoscrolling,\n    commit: commitScrollState,\n    schedule: scheduleStateCommit,\n    releaseFollow,\n  } = scrollState;\n\n  const commands = createScrollCommands({\n    viewport,\n    content,\n    spacer,\n    options,\n    measure,\n    state: scrollState,\n    scheduleVisibility: scheduleVisibilitySync,\n  });\n\n  const anchoring = createAnchoring({\n    viewport,\n    content,\n    options,\n    measure,\n    commands,\n    state: scrollState,\n    scheduleState: scheduleStateCommit,\n    commitState: commitScrollState,\n    scheduleVisibility: scheduleVisibilitySync,\n    preserveScrollOnPrepend,\n    getMessageElement: (id) => messageElements.get(id),\n  });\n  const {\n    pendingScroll,\n    scrollToStart,\n    scrollToEnd,\n    scrollToMessage,\n    handleContentChange,\n    handleResize,\n    syncAfterScroll,\n  } = anchoring;\n\n  const registerMessage = (\n    id: string,\n    element: HTMLElement | undefined,\n    previous?: HTMLElement,\n  ) => {\n    if (element) {\n      messageElements.set(id, element);\n      visibility.observe(element);\n      scheduleVisibilitySync();\n      anchoring.notifyMessageRegistered(id);\n      return;\n    }\n    if (previous && messageElements.get(id) === previous) {\n      messageElements.delete(id);\n      visibility.unobserve(id, previous);\n      scheduleVisibilitySync();\n    }\n  };\n\n  const registerItem = (entry: MessageScrollerItemEntry) => {\n    const id = entry.id;\n    if (id) registerMessage(id, entry.element);\n    return () => {\n      if (id) registerMessage(id, undefined, entry.element);\n    };\n  };\n\n  /** 公共入口：挂上尾部 spacer 元素（行间距在真正写高度时才惰性读取） */\n  const attachSpacer = (element: HTMLElement | undefined) => {\n    setSpacerSignal(element);\n  };\n\n  // 内容观察：初次定位 / prepend 保位 / 新回合锚定 / 跟随 / 尺寸\n  createEffect(() => {\n    const root = content();\n    if (!root) return;\n    handleContentChange();\n\n    const mutation =\n      typeof MutationObserver !== \"undefined\"\n        ? new MutationObserver(() => handleContentChange())\n        : null;\n    mutation?.observe(root, { childList: true });\n\n    // 已有行切换 scrollAnchor（dataset 变化）也要重新锚定\n    const anchorMutation =\n      typeof MutationObserver !== \"undefined\"\n        ? new MutationObserver(() => handleContentChange())\n        : null;\n    anchorMutation?.observe(root, {\n      attributes: true,\n      attributeFilter: [\"data-scroll-anchor\"],\n      subtree: true,\n    });\n\n    let frame = 0;\n    const resize =\n      typeof ResizeObserver !== \"undefined\"\n        ? new ResizeObserver(() => {\n            window.cancelAnimationFrame(frame);\n            frame = window.requestAnimationFrame(handleResize);\n          })\n        : null;\n    resize?.observe(root);\n\n    onCleanup(() => {\n      mutation?.disconnect();\n      anchorMutation?.disconnect();\n      resize?.disconnect();\n      window.cancelAnimationFrame(frame);\n    });\n  });\n\n  // 视口：scroll / 用户滚动意图 / 尺寸\n  createEffect(() => {\n    const vp = viewport();\n    if (!vp) return;\n    visibility.ensureObserver();\n\n    const onScroll = () => syncAfterScroll();\n    const onIntent = () => releaseFollow();\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (NAV_KEYS.has(event.key)) releaseFollow();\n    };\n    vp.addEventListener(\"scroll\", onScroll, { passive: true });\n    vp.addEventListener(\"wheel\", onIntent, { passive: true });\n    vp.addEventListener(\"touchmove\", onIntent, { passive: true });\n    vp.addEventListener(\"keydown\", onKeyDown);\n\n    let frame = 0;\n    const resize =\n      typeof ResizeObserver !== \"undefined\"\n        ? new ResizeObserver(() => {\n            window.cancelAnimationFrame(frame);\n            frame = window.requestAnimationFrame(handleResize);\n          })\n        : null;\n    resize?.observe(vp);\n\n    onCleanup(() => {\n      vp.removeEventListener(\"scroll\", onScroll);\n      vp.removeEventListener(\"wheel\", onIntent);\n      vp.removeEventListener(\"touchmove\", onIntent);\n      vp.removeEventListener(\"keydown\", onKeyDown);\n      resize?.disconnect();\n      window.cancelAnimationFrame(frame);\n    });\n  });\n\n  onCleanup(() => {\n    anchoring.dispose();\n    scrollState.dispose();\n    visibility.dispose();\n  });\n\n  return {\n    viewport,\n    setViewport,\n    content,\n    setContent,\n    setSpacer: attachSpacer,\n    registerItem,\n    preserveScrollOnPrepend,\n    setPreserveScrollOnPrepend,\n    scrollableStart,\n    scrollableEnd,\n    autoscrolling,\n    pendingScroll,\n    scrollToStart,\n    scrollToEnd,\n    scrollToMessage,\n    currentAnchorId,\n    visibleMessageIds,\n    subscribeVisibility: visibility.subscribe,\n    options,\n  };\n}\n"],"mappings":"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"}