@ryuu-64/dsh-find-all 0.1.4 → 0.1.5

package/lib/client.js

@@ -32,8 +32,8 @@
 //   * Highlights use the CSS Custom Highlight API (CSS.highlights + Highlight)
 //     which paints ranges WITHOUT mutating the DOM — React keeps full
 //     ownership of the tree. Chromium/Electron support this since 105.
-//   * When the API is unavailable, the bar degrades to the legacy
-//     window.find() calls (no count, still functional).
+//   * Without CSS Highlights, navigation still scrolls only scoped ranges.
+//     Browser-wide window.find() is deliberately never used.
 //
 // Keyboard:
 //   Cmd/Ctrl+F  open (prefilled with the current selection)
@@ -43,7 +43,7 @@
 
 window.__ModuleLoader__.load({
 	id: "@ryuu-64/dsh-find-all",
-	factory: () => {
+	factory: (require) => {
 		var module = { exports: {} };
 		var exports = module.exports;
 
@@ -76,7 +76,11 @@ window.__ModuleLoader__.load({
 			capped: "已到加载上限（{n} 页），停止加载",
 			stalled: "没有更早的历史了",
 			stopTip: "点击停止加载",
-			noService: "取不到会话接口，只能搜当前页面"
+			noService: "会话接口不可用，仅保留已显示的部分结果",
+			noTarget: "请先选择可见的会话，再打开查找",
+			noRoot: "当前会话的搜索范围不可用",
+			incomplete: "历史尚未搜完，保留部分结果",
+			find: "查找会话"
 		} : {
 			placeholder: "Find in conversation…",
 			prev: "Previous match",
@@ -92,7 +96,11 @@ window.__ModuleLoader__.load({
 			capped: "Page cap reached ({n}), stopped loading",
 			stalled: "No earlier history",
 			stopTip: "Click to stop loading",
-			noService: "Session service unavailable — rendered page only"
+			noService: "Session service unavailable; rendered results only",
+			noTarget: "Select a visible conversation before opening find",
+			noRoot: "Search scope unavailable for this conversation",
+			incomplete: "History search incomplete; partial results retained",
+			find: "Find in conversation"
 		};
 
 		//#region pure helpers (exported for tests)
@@ -121,7 +129,7 @@ window.__ModuleLoader__.load({
 				if (meta && (key === "f" || key === "F")) {
 					event.preventDefault();
 					event.stopPropagation();
-					ops.open();
+					ops.open(event.target);
 					return;
 				}
 				if (!ops.isOpen()) return;
@@ -239,10 +247,10 @@ window.__ModuleLoader__.load({
 			return into;
 		}
 
-		function collectRanges(query) {
+		function collectRanges(query, root) {
 			var ranges = [];
-			if (!query || typeof document === "undefined" || document.body === null) return ranges;
-			var nodes = collectTextNodes(document.body, []);
+			if (!query || !root || typeof document === "undefined") return ranges;
+			var nodes = collectTextNodes(root, []);
 			for (var i = 0; i < nodes.length && ranges.length < MAX_MATCHES; i++) {
 				var node = nodes[i];
 				var indices = findIndices(node.data, query);
@@ -270,48 +278,195 @@ window.__ModuleLoader__.load({
 			}
 		}
 
-		/** Cheap proxy for "how much history is rendered" — used to notice a page landing. */
-		function domSignature() {
-			if (typeof document === "undefined" || document.body === null) return 0;
-			return collectTextNodes(document.body, []).length;
+		//#region host adapter
+		// Official session-scoped header utility props supply identity. DOM selectors
+		// are intentionally isolated here: see docs/compatibility.md for tag sources.
+		// No global current-session state and no page-wide search fallback.
+		function visible(element) {
+			if (!element || !element.isConnected || !element.getClientRects().length) return false;
+			for (var node = element; node; node = node.parentElement) {
+				if (node.hidden || node.getAttribute("aria-hidden") === "true") return false;
+				var css = window.getComputedStyle(node);
+				if (css.display === "none" || css.visibility === "hidden" || css.visibility === "collapse" || css.opacity === "0") return false;
+			}
+			return true;
+		}
+
+		function conversationPanel(element) {
+			// The host composer has its own unrelated data-phase. A conversation
+			// root additionally owns the scrollport (official startup fixture).
+			for (var node = element; node && node !== document.body; node = node.parentElement) {
+				if (!node.hasAttribute || !node.hasAttribute("data-phase")) continue;
+				var phase = node.getAttribute("data-phase");
+				// Preserve even a broken declared panel boundary; never walk through
+				// it to a different ancestor conversation because its scroll is absent.
+				if (phase === "active" || phase === "hero" || phase === "settling" || node.querySelector('[data-conversation-scroll]')) return node;
+			}
+			return null;
+		}
+
+		function resolveScope(anchor, sessionId) {
+			if (!anchor || typeof sessionId !== "string" || !sessionId || !visible(anchor)) return null;
+			var panel = conversationPanel(anchor);
+			if (!panel || panel.getAttribute("data-phase") !== "active" || panel === document.documentElement) return null;
+			var anchors = panel.querySelectorAll('[data-find-all-session]');
+			if (anchors.length !== 1 || anchors[0] !== anchor) return null;
+			var scrolls = panel.querySelectorAll('[data-conversation-scroll]');
+			if (scrolls.length !== 1) return null;
+			var content = scrolls[0].closest('[data-conversation-content]');
+			// 0.1.6-alpha.2 has the content wrapper but no identity attribute.
+			// Identity still comes from the unique session-scoped header anchor.
+			if (content && content.hasAttribute('data-conversation-session') && content.getAttribute('data-conversation-session') !== sessionId) return null;
+			var flows = scrolls[0].querySelectorAll('[data-chat-flow]');
+			if (flows.length !== 1 || !visible(flows[0])) return null;
+			return { panel: panel, root: flows[0] };
+		}
+
+		function createHostAdapter(ctx, changed) {
+			var entries = new Map();
+			var scopeUnavailable = false;
+			// Only a never-selected adapter may discover an initial neutral context.
+			// Explicit rejection or loss of a selection must never select a substitute.
+			var selectionState = "pristine";
+			function candidates() {
+				var out = [];
+				entries.forEach(function (id, anchor) {
+					// Keep unsupported/invisible instances in the identity roster. Dropping
+					// them before routing could silently choose a different valid session.
+					out.push({ id: id, anchor: anchor, panel: conversationPanel(anchor), scope: resolveScope(anchor, id) });
+				});
+				return out;
+			}
+			function choose(entry) {
+				if (!entry) return null;
+				if (!entry.scope) { selectionState = "rejected"; scopeUnavailable = true; return null; }
+				selectionState = "selected";
+				return { id: entry.id, anchor: entry.anchor, panel: entry.scope.panel, root: entry.scope.root };
+			}
+
+			function visibleEntry(entry) {
+				var container = entry.panel || entry.anchor.closest('[data-phase], [data-conversation-content]');
+				return visible(entry.anchor) || visible(container);
+			}
+
+			function discoverInitial(all) {
+				var shown = all.filter(visibleEntry);
+				var nodes = Array.prototype.filter.call(document.querySelectorAll('[data-phase], [data-conversation-content], [data-conversation-scroll], [data-chat-flow]'), visible);
+				scopeUnavailable = false;
+				if (shown.length === 0) {
+					// An empty resident Hero is not a session choice. A known active
+					// or identified but unregistered view is unavailable, not pristine.
+					if (nodes.some(function (node) { return node.getAttribute('data-phase') === 'active' || node.getAttribute('data-content-phase') === 'active' || node.hasAttribute('data-conversation-session') || node.hasAttribute('data-chat-flow'); })) {
+						selectionState = "rejected"; scopeUnavailable = true;
+					}
+					return null;
+				}
+				if (shown.length !== 1) { selectionState = "rejected"; return null; }
+				var entry = shown[0], scope = entry.scope;
+				if (!scope) return choose(entry);
+				var content = scope.root.closest('[data-conversation-content]');
+				var scroll = scope.root.closest('[data-conversation-scroll]');
+				// One main panel and its own content/scroll/flow count as one view.
+				// Any other visible known container, including a headerless embedded
+				// sidebar, makes neutral discovery ambiguous even if unsupported.
+				var other = nodes.some(function (node) {
+					if (node.hasAttribute('data-conversation-content') && node !== content) return true;
+					if (node.hasAttribute('data-conversation-scroll') && node !== scroll) return true;
+					if (node.hasAttribute('data-chat-flow') && node !== scope.root) return true;
+					return node.hasAttribute('data-phase') && conversationPanel(node) === node && node !== scope.panel;
+				});
+				if (other) { selectionState = "rejected"; return null; }
+				return choose(entry);
+			}
+
+			function refresh(entry) {
+				if (!entry) return null;
+				// Passive checks and repeated shortcuts may only retain this exact
+				// registered instance and identity. They never discover a substitute.
+				if (entries.get(entry.anchor) !== entry.id) { selectionState = "rejected"; scopeUnavailable = true; return null; }
+				scopeUnavailable = false;
+				return choose({ id: entry.id, anchor: entry.anchor, scope: resolveScope(entry.anchor, entry.id) });
+			}
+
+			return {
+				mount: function (anchor, id) {
+					entries.set(anchor, id);
+					changed();
+					return function () { entries.delete(anchor); changed(); };
+				},
+				refresh: refresh,
+				select: function (target, previous, retainNeutral) {
+					var all = candidates();
+					if (!target || !target.nodeType) target = document.activeElement;
+					if (target && state.bar && state.bar.contains(target)) return refresh(previous);
+					if (retainNeutral && (target === document.body || target === document.documentElement)) {
+						if (previous || selectionState !== "pristine") return refresh(previous);
+						return discoverInitial(all);
+					}
+					scopeUnavailable = false;
+					var direct = all.filter(function (entry) { return target && entry.anchor.contains(target); });
+					if (direct.length === 1) return choose(direct[0]);
+					var content = target && target.closest ? target.closest('[data-conversation-content]') : null;
+					var panel = conversationPanel(target) || content;
+					var hit = all.filter(function (entry) { return panel && entry.panel === panel; });
+					if (hit.length === 1) {
+						if (content && hit[0].scope && hit[0].scope.root.closest('[data-conversation-content]') !== content) {
+							selectionState = "rejected"; scopeUnavailable = true; return null;
+						}
+						return choose(hit[0]);
+					}
+					if (panel) {
+						// Before any session is selected, focus in the resident unbound
+						// Hero/settling composer is not a rejected conversation choice.
+						var phase = panel.getAttribute('data-phase') || panel.getAttribute('data-content-phase');
+						var unbound = !panel.hasAttribute('data-conversation-session') && !panel.querySelector('[data-conversation-session]');
+						if (selectionState === "pristine" && !previous && unbound && !all.some(visibleEntry) && (phase === "hero" || phase === "settling")) return null;
+						selectionState = "rejected"; scopeUnavailable = true; return null;
+					}
+					if (previous) selectionState = "rejected";
+					return null;
+				},
+				scopeUnavailable: function () { return scopeUnavailable; },
+				valid: function (entry) {
+					if (!entry || entries.get(entry.anchor) !== entry.id) return false;
+					var scope = resolveScope(entry.anchor, entry.id);
+					return !!scope && scope.root === entry.root;
+				},
+				face: function (entry) {
+					try {
+						if (!this.valid(entry) || !ctx.sessions || typeof ctx.sessions.binding !== "function") return null;
+						var binding = ctx.sessions.binding(entry.id);
+						var face = binding && binding.session;
+						return face && typeof face.loadOlder === "function" ? face : null;
+					} catch (error) { return null; }
+				},
+				clear: function () { entries.clear(); }
+			};
 		}
 
-		/** Resolve once the rendered history differs from `before`, or the page times out. */
-		function waitForChange(before) {
+		function domSignature(root) {
+			return root ? collectTextNodes(root, []).length : 0;
+		}
+
+		function waitForChange(before, root, token) {
 			return new Promise(function (resolve) {
 				var started = Date.now();
+				function finish(value) {
+					clearTimeout(state.settleTimer);
+					state.settleTimer = 0;
+					state.settleCancel = null;
+					resolve(value);
+				}
+				state.settleCancel = function () { finish(false); };
 				(function poll() {
-					if (domSignature() !== before) { resolve(true); return; }
-					if (Date.now() - started >= PAGE_SETTLE_MS) { resolve(false); return; }
-					setTimeout(poll, PAGE_POLL_MS);
+					if (token !== state.pageToken || !state.adapter.valid(state.target)) { finish(false); return; }
+					if (domSignature(root) !== before) { finish(true); return; }
+					if (Date.now() - started >= PAGE_SETTLE_MS) { finish(false); return; }
+					state.settleTimer = setTimeout(poll, PAGE_POLL_MS);
 				})();
 			});
 		}
 
-		//#region session bridge
-		//
-		// The `sessions` client service is provided by
-		// @deepseek-ai/dsh-api-session-controller; the per-session face it binds
-		// exposes loadOlder() plus a snapshot carrying hasMore/loadingOlder.
-		// Everything here is defensive: a host that changes shape must degrade to
-		// page-only search, never break the bar.
-
-		function resolveFace(ctx) {
-			try {
-				var sessions = ctx && ctx.sessions;
-				if (!sessions || !sessions.list || typeof sessions.list.getSnapshot !== "function") return null;
-				var id = sessions.list.getSnapshot().current;
-				if (!id) return null;
-				if (typeof sessions.binding !== "function") return null;
-				var binding = sessions.binding(id);
-				var face = binding && binding.session ? binding.session : null;
-				if (!face || typeof face.loadOlder !== "function") return null;
-				return { id: id, face: face };
-			} catch (error) {
-				return null;
-			}
-		}
-
 		function faceHasMore(face) {
 			try {
 				if (typeof face.getSnapshot !== "function") return null;
@@ -327,6 +482,10 @@ window.__ModuleLoader__.load({
 
 		var state = {
 			ctx: null,
+			adapter: null,
+			target: null,
+			settleTimer: 0,
+			settleCancel: null,
 			bar: null,
 			input: null,
 			count: null,
@@ -384,32 +543,29 @@ window.__ModuleLoader__.load({
 			else state.scopeBtn.removeAttribute("data-whole");
 		}
 
+		function unavailableStatus() {
+			return state.target || (state.adapter && state.adapter.scopeUnavailable()) ? L.noRoot : L.noTarget;
+		}
+
 		function runSearch(keepIndex) {
-			state.ranges = collectRanges(state.query);
+			var valid = state.adapter && state.adapter.valid(state.target);
+			state.ranges = valid ? collectRanges(state.query, state.target.root) : [];
+			if (!valid) setStatus(unavailableStatus(), false);
 			state.capped = state.ranges.length >= MAX_MATCHES;
 			if (!keepIndex || state.index >= state.ranges.length) state.index = state.ranges.length > 0 ? 0 : -1;
 			paint();
 			updateCount();
-			if (state.index >= 0 && !highlightsSupported()) legacyFind(state.query, false);
+
 		}
 
 		function goTo(delta) {
+			if (!state.adapter || !state.adapter.valid(state.target)) { runSearch(false); return; }
 			var n = state.ranges.length;
 			if (n === 0) return;
-			if (highlightsSupported()) {
-				state.index = ((state.index + delta) % n + n) % n;
-				paint();
-				updateCount();
-				scrollToRange(state.ranges[state.index]);
-			} else {
-				legacyFind(state.query, delta < 0);
-			}
-		}
-
-		function legacyFind(query, backwards) {
-			if (typeof window.find === "function") {
-				try { window.find(query, false, backwards, true); } catch (error) {}
-			}
+			state.index = ((state.index + delta) % n + n) % n;
+			paint();
+			updateCount();
+			scrollToRange(state.ranges[state.index]);
 		}
 
 		function scheduleRescan() {
@@ -418,14 +574,14 @@ window.__ModuleLoader__.load({
 			if (state.paging) return;
 			clearTimeout(state.debounce);
 			state.debounce = setTimeout(function () {
-				if (state.bar) runSearch(true);
+				if (isOpen()) runSearch(true);
 			}, 250);
 		}
 
 		function startObserver() {
-			if (state.observer || typeof MutationObserver === "undefined") return;
+			if (state.observer || !state.target || typeof MutationObserver === "undefined") return;
 			state.observer = new MutationObserver(scheduleRescan);
-			state.observer.observe(document.documentElement, { childList: true, subtree: true, characterData: true });
+			state.observer.observe(state.target.root, { childList: true, subtree: true, characterData: true });
 		}
 
 		function stopObserver() {
@@ -438,6 +594,8 @@ window.__ModuleLoader__.load({
 
 		function cancelPageIn() {
 			state.pageToken += 1;
+			if (state.settleCancel) state.settleCancel();
+			clearTimeout(state.settleTimer);
 			clearTimeout(state.pageTimer);
 			state.pageTimer = 0;
 			state.paging = false;
@@ -454,13 +612,18 @@ window.__ModuleLoader__.load({
 		function startPageIn() {
 			if (state.scope !== "whole" || !state.query || !isOpen()) return;
 			var token = ++state.pageToken;
-			var resolved = resolveFace(state.ctx);
-			if (!resolved) {
+			var target = state.target;
+			if (!state.adapter || !state.adapter.valid(target)) {
+				setStatus(unavailableStatus(), false);
+				return;
+			}
+			var face = state.adapter.face(target);
+			if (!face) {
 				setStatus(L.noService, false);
 				return;
 			}
-			state.sessionId = resolved.id;
-			if (faceHasMore(resolved.face) === false) {
+			state.sessionId = target.id;
+			if (faceHasMore(face) === false) {
 				setStatus(L.allLoaded, false);
 				return;
 			}
@@ -469,11 +632,11 @@ window.__ModuleLoader__.load({
 			setStatus(L.loading.replace("{n}", "0"), true);
 			runPageIn({
 				maxPages: MAX_PAGES,
-				isCancelled: function () { return token !== state.pageToken || !isOpen(); },
-				hasMore: function () { return faceHasMore(resolved.face); },
-				loadOlder: function () { return Promise.resolve(resolved.face.loadOlder()); },
-				signature: domSignature,
-				waitChange: waitForChange,
+				isCancelled: function () { return token !== state.pageToken || !isOpen() || !state.adapter.valid(target); },
+				hasMore: function () { return faceHasMore(face); },
+				loadOlder: function () { return Promise.resolve(face.loadOlder()); },
+				signature: function () { return domSignature(target.root); },
+				waitChange: function (before) { return waitForChange(before, target.root, token); },
 				onProgress: function (pages) {
 					if (token !== state.pageToken) return;
 					state.pages = pages;
@@ -485,25 +648,35 @@ window.__ModuleLoader__.load({
 				state.paging = false;
 				state.pages = result.pages;
 				if (result.reason === "capped") setStatus(L.capped.replace("{n}", String(result.pages)), false);
-				else if (result.reason === "stalled" || result.reason === "error") setStatus(L.stalled, false);
+				else if (result.reason !== "done") setStatus(L.incomplete, false);
 				else setStatus(result.pages > 0 ? L.allLoaded : "", false);
 				runSearch(true);
 			});
 		}
 
-		/** Drop everything paged for the previous session when the user switches. */
+		function syncTarget(target, passive, retainNeutral) {
+			if (!state.adapter) return;
+			var selected = passive ? state.adapter.refresh(state.target) : state.adapter.select(target || document.activeElement, state.target, retainNeutral);
+			if (selected && state.target && selected.id === state.target.id && selected.anchor === state.target.anchor && selected.root === state.target.root) return;
+			if (!selected && !state.target) {
+				if (isOpen()) runSearch(false);
+				return;
+			}
+			cancelPageIn();
+			stopObserver();
+			state.target = selected;
+			state.sessionId = selected ? selected.id : null;
+			if (!isOpen()) return;
+			setStatus(selected ? "" : unavailableStatus(), false);
+			runSearch(false);
+			startObserver();
+			if (selected && state.scope === "whole" && state.query) schedulePageIn();
+		}
+
 		function watchSession() {
 			clearInterval(state.sessionTimer);
 			state.sessionTimer = setInterval(function () {
-				if (!isOpen()) return;
-				var resolved = resolveFace(state.ctx);
-				var id = resolved ? resolved.id : null;
-				if (id === state.sessionId) return;
-				state.sessionId = id;
-				cancelPageIn();
-				setStatus("", false);
-				runSearch(false);
-				if (state.scope === "whole" && state.query) schedulePageIn();
+				if (isOpen()) syncTarget(null, true);
 			}, SESSION_POLL_MS);
 		}
 
@@ -582,7 +755,7 @@ window.__ModuleLoader__.load({
 			status.addEventListener("click", function () {
 				if (!state.paging) return;
 				cancelPageIn();
-				setStatus(L.stalled, false);
+				setStatus(L.incomplete, false);
 			});
 
 			bar.appendChild(input);
@@ -602,13 +775,14 @@ window.__ModuleLoader__.load({
 			document.body.appendChild(bar);
 		}
 
-		function open() {
+		function open(target) {
 			if (typeof document === "undefined" || document.body === null) return;
+			syncTarget(target || document.activeElement, false, true);
 			if (!state.bar) buildBar();
 			state.bar.style.display = "flex";
 			var selection = "";
 			try { selection = String(window.getSelection()).trim(); } catch (error) {}
-			if (selection && selection.length <= 200 && selection !== state.query) {
+			if (state.target && selection && selection.length <= 200 && selection !== state.query) {
 				state.input.value = selection;
 				state.query = selection;
 			}
@@ -625,6 +799,7 @@ window.__ModuleLoader__.load({
 			stopWatchingSession();
 			if (state.bar) state.bar.style.display = "none";
 			state.query = "";
+			if (state.input) state.input.value = "";
 			state.ranges = [];
 			state.index = -1;
 			setStatus("", false);
@@ -638,20 +813,57 @@ window.__ModuleLoader__.load({
 		}
 
 		function apply(ctx) {
+			var react = require("react");
 			state.ctx = ctx;
-			injectCss();
-			var ops = {
-				open: open,
-				close: close,
-				goTo: goTo,
-				isOpen: isOpen,
-				isBarInput: function (target) { return target === state.input; }
-			};
-			window.addEventListener("keydown", createHandlers(ops), true);
+			state.adapter = createHostAdapter(ctx, function () {
+				syncTarget(null, true);
+			});
+			function SessionFind(props) {
+				var anchor = react.useRef(null);
+				react.useEffect(function () {
+					if (!anchor.current || !props.sessionId) return;
+					return state.adapter.mount(anchor.current, props.sessionId);
+				}, [props.sessionId]);
+				return react.createElement("button", {
+					ref: anchor, type: "button", title: L.find, "aria-label": L.find,
+					"data-find-all-session": props.sessionId,
+					onClick: function (event) { open(event.currentTarget); }
+				}, "⌕");
+			}
+			ctx.slots.inject("conversation.session.header.utilities", function () {
+				return ctx.slots.register({ name: "conversation.session.header.utilities", id: "dsh-find-all" }, SessionFind);
+			});
+			ctx.effect(function () {
+				injectCss();
+				var handler = createHandlers({
+					open: open, close: close, goTo: goTo, isOpen: isOpen,
+					isBarInput: function (target) { return target === state.input; }
+				});
+				function focus(event) {
+					if (!state.bar || !state.bar.contains(event.target)) syncTarget(event.target);
+				}
+				window.addEventListener("keydown", handler, true);
+				window.addEventListener("focusin", focus, true);
+				window.addEventListener("pointerdown", focus, true);
+				return function () {
+					window.removeEventListener("keydown", handler, true);
+					window.removeEventListener("focusin", focus, true);
+					window.removeEventListener("pointerdown", focus, true);
+					close();
+					if (state.bar) state.bar.remove();
+					var style = document.querySelector('style[data-plugin-css="dsh-find-all/bar.css"]');
+					if (style) style.remove();
+					state.bar = state.input = state.count = state.status = state.scopeBtn = null;
+					state.adapter.clear();
+					state.target = state.ctx = null;
+				};
+			}, "find-all: browser lifecycle");
 		}
 
 		exports.apply = apply;
-		exports.inject = ["sessions"];
+		exports.inject = ["sessions", "slots"];
+		exports.resolveScope = resolveScope;
+		exports.createHostAdapter = createHostAdapter;
 		exports.findIndices = findIndices;         // for tests
 		exports.createHandlers = createHandlers;   // for tests
 		exports.runPageIn = runPageIn;             // for tests