deepseek-harness-background 0.4.0 → 0.4.1

package/lib/client.js

@@ -75,7 +75,13 @@ window.__ModuleLoader__.load({
 		*
 		* Selectors target authored attributes (`data-dsh-bg`, `data-composer-card`,
 		* `data-terminal`…), the `:global` `.md-code-block` anchor, and CSS-module
-		* SUFFIX conventions (`_bubble`, `_newSession`…) audited for collisions:
+		* SUFFIX conventions (`_bubble`, `_newSession`…) audited for collisions.
+		*
+		* MAINTENANCE NOTE: the suffix anchors are the host's only stable-enough
+		* integration surface today, but a host restyle that renames them silently
+		* drops the glass. Upgrade path: once the host ships stable data-* anchors
+		* for these surfaces, swap the selector lists below to them and delete the
+		* suffix entries.
 		* `_bubble` excludes `role="tooltip"` (Tooltip.module.css shares the suffix),
 		* `_add` is scoped under `[data-composer-card]` (DiffBlock line markers share
 		* it), `_newSession` excludes `Label` (the button's inner label span) and
@@ -440,6 +446,8 @@ window.__ModuleLoader__.load({
 			observer;
 			active = false;
 			settings;
+			/** Whether the current section resolves to an actual image source. */
+			hasSource = false;
 			savedTokens = /* @__PURE__ */ new Map();
 			savedVars = /* @__PURE__ */ new Map();
 			/** Remember + hijack a property only once so dispose restores the original. */
@@ -468,6 +476,7 @@ window.__ModuleLoader__.load({
 					this.restoreFrameTokens();
 					this.applySurfaceGlass(settings, true);
 					this.active = false;
+					this.hasSource = false;
 					this.removeLayers();
 					document.body.removeAttribute(ACTIVE_ATTR);
 					return;
@@ -483,10 +492,20 @@ window.__ModuleLoader__.load({
 					this.img.className = IMAGE_CLASS;
 					this.img.alt = "";
 					this.img.referrerPolicy = "no-referrer";
+					this.img.onerror = () => {
+						if (this.img === null || this.img.dataset.failed === "1") return;
+						this.img.dataset.failed = "1";
+						this.img.style.visibility = "hidden";
+						console.warn("[deepseek-harness-background] wallpaper image failed to load:", this.img.getAttribute("src"));
+					};
 					this.layer.appendChild(this.img);
 					document.body.appendChild(this.layer);
 				}
-				if (this.img && this.img.getAttribute("src") !== url) this.img.src = url;
+				if (this.img && this.img.getAttribute("src") !== url) {
+					delete this.img.dataset.failed;
+					this.img.style.visibility = "";
+					this.img.src = url;
+				}
 				if (!this.scrim) {
 					this.scrim = document.createElement("div");
 					this.scrim.className = SCRIM_CLASS;
@@ -494,6 +513,7 @@ window.__ModuleLoader__.load({
 				}
 				document.body.setAttribute(ACTIVE_ATTR, "on");
 				this.active = true;
+				this.hasSource = true;
 				document.body.style;
 				this.setVar("--bg-object-fit", settings.fit);
 				this.setVar("--bg-opacity", String(settings.opacity));
@@ -546,6 +566,15 @@ window.__ModuleLoader__.load({
 					case "scrim":
 						this.setVar("--bg-scrim", String(value));
 						break;
+					case "panelOpacity": {
+						const next = {
+							...this.settings,
+							panelOpacity: Number(value)
+						};
+						this.settings = next;
+						this.applySurfaceGlass(next, !this.hasSource);
+						break;
+					}
 					case "blur":
 						this.setVar("--bg-glass-blur", `${value}px`);
 						this.setVar("--bg-glass-saturate", String(glassSaturate(Number(value))));
@@ -696,14 +725,22 @@ window.__ModuleLoader__.load({
 		const REGISTRY_CSS_TAG = "deepseek-harness-background/glass-registry";
 		/** Plugin identity stamped onto the registry <style> element. */
 		const PLUGIN_ID = "deepseek-harness-background";
-		/** Characters whose presence would let a selector escape its rule context. */
+		/**
+		* Characters whose presence would let a selector escape its rule context.
+		* ',' is refused too: inside the generated rule body
+		* (`body[gate] <selector> { … }`) a comma lets one registration broaden the
+		* rule to ARBITRARY extra subjects (`.x, html body`) — an unintended
+		* widening of the glass sheet beyond the registered surface. Multiple
+		* surfaces stay supported through the selectors ARRAY.
+		*/
 		const FORBIDDEN_SELECTOR_CHARS = [
 			"{",
 			"}",
 			";",
 			"@",
 			"<",
-			">"
+			">",
+			","
 		];
 		/** Hard cap on one selector's length (diagnostics-friendly, abuse-proof). */
 		const MAX_SELECTOR_LENGTH = 500;
@@ -916,7 +953,8 @@ window.__ModuleLoader__.load({
 			"timeline.marksOnly": "★ 只看标记",
 			"timeline.mark": "标记为重点",
 			"timeline.unmark": "取消重点标记",
-			"timeline.noMarks": "还没有标记的重点"
+			"timeline.noMarks": "还没有标记的重点",
+			"timeline.cannotJump": "无法跳转：这条历史消息缺少定位信息"
 		};
 		/** English copy. */
 		const en = {
@@ -952,7 +990,8 @@ window.__ModuleLoader__.load({
 			"timeline.marksOnly": "★ Marked only",
 			"timeline.mark": "Mark as key point",
 			"timeline.unmark": "Unmark key point",
-			"timeline.noMarks": "No marked key points"
+			"timeline.noMarks": "No marked key points",
+			"timeline.cannotJump": "Cannot jump: this history message lacks position info"
 		};
 		//#endregion
 		//#region node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
@@ -1087,41 +1126,41 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var SettingsRow_module_css_default = {
-			"switch": "-ozqdq_switch",
+			"row": "-ozqdq_row",
+			"segBtn": "-ozqdq_segBtn",
 			"preview": "-ozqdq_preview",
-			"sliderLabel": "-ozqdq_sliderLabel",
-			"segRow": "-ozqdq_segRow",
 			"urlRow": "-ozqdq_urlRow",
+			"sliderValue": "-ozqdq_sliderValue",
+			"titleRow": "-ozqdq_titleRow",
+			"clearBtn": "-ozqdq_clearBtn",
+			"segRow": "-ozqdq_segRow",
+			"enabledBadge": "-ozqdq_enabledBadge",
+			"title": "-ozqdq_title",
 			"previewImg": "-ozqdq_previewImg",
-			"previewGlass": "-ozqdq_previewGlass",
-			"hint": "-ozqdq_hint",
 			"header": "-ozqdq_header",
+			"previewGlass": "-ozqdq_previewGlass",
+			"sliderRow": "-ozqdq_sliderRow",
+			"previewGlassText": "-ozqdq_previewGlassText",
 			"slider": "-ozqdq_slider",
-			"title": "-ozqdq_title",
-			"segLabel": "-ozqdq_segLabel",
-			"urlInput": "-ozqdq_urlInput",
+			"switch": "-ozqdq_switch",
+			"sourceRow": "-ozqdq_sourceRow",
+			"clearRow": "-ozqdq_clearRow",
 			"error": "-ozqdq_error",
-			"enabledBadge": "-ozqdq_enabledBadge",
-			"btnPrimary": "-ozqdq_btnPrimary",
-			"clearBtn": "-ozqdq_clearBtn",
-			"sectionLabel": "-ozqdq_sectionLabel",
-			"switchKnob": "-ozqdq_switchKnob",
-			"section": "-ozqdq_section",
-			"sliderValue": "-ozqdq_sliderValue",
-			"row": "-ozqdq_row",
+			"sliderLabel": "-ozqdq_sliderLabel",
 			"previewScrim": "-ozqdq_previewScrim",
+			"urlInput": "-ozqdq_urlInput",
 			"desc": "-ozqdq_desc",
+			"previewEmpty": "-ozqdq_previewEmpty",
+			"section": "-ozqdq_section",
+			"hint": "-ozqdq_hint",
+			"btn": "-ozqdq_btn",
 			"segGroup": "-ozqdq_segGroup",
-			"clearRow": "-ozqdq_clearRow",
+			"segLabel": "-ozqdq_segLabel",
+			"sectionLabel": "-ozqdq_sectionLabel",
+			"btnPrimary": "-ozqdq_btnPrimary",
 			"segActive": "-ozqdq_segActive",
-			"sliderRow": "-ozqdq_sliderRow",
-			"btn": "-ozqdq_btn",
-			"titleRow": "-ozqdq_titleRow",
-			"btnDanger": "-ozqdq_btnDanger",
-			"previewGlassText": "-ozqdq_previewGlassText",
-			"sourceRow": "-ozqdq_sourceRow",
-			"segBtn": "-ozqdq_segBtn",
-			"previewEmpty": "-ozqdq_previewEmpty"
+			"switchKnob": "-ozqdq_switchKnob",
+			"btnDanger": "-ozqdq_btnDanger"
 		};
 		//#endregion
 		//#region src/client/SettingsRow.tsx
@@ -1320,8 +1359,7 @@ window.__ModuleLoader__.load({
 				};
 				draftRef.current = next;
 				markEditing();
-				if (key === "panelOpacity") paintBackground(next);
-				else paintBackgroundKnob(key, value);
+				paintBackgroundKnob(key, value);
 				if (previewRef.current) paintPreviewSurface(previewRef.current, next);
 			}, [markEditing]);
 			/** Persist one section through the host route and adopt it on success. */
@@ -1329,6 +1367,7 @@ window.__ModuleLoader__.load({
 				dirtyRef.current = true;
 				const result = await settingsClient.save(next);
 				if (result === "failed") {
+					dirtyRef.current = false;
 					setError(t("background.saveFailed"));
 					return;
 				}
@@ -1877,6 +1916,8 @@ window.__ModuleLoader__.load({
     display: flex; align-items: center; justify-content: flex-end;
   }
   .dsbt-jump:focus-visible { outline: 1px solid currentColor; outline-offset: -1px; border-radius: 6px; }
+  .dsbt-jump:disabled { cursor: default; opacity: .55; }
+  .dsbt-jump:disabled .dsbt-title { text-decoration: line-through; text-decoration-color: currentColor; }
   .dsbt-item:hover { color: var(--dsw-alias-label-primary, rgba(0, 0, 0, .95)); }
   body[data-ds-dark-theme] .dsbt-item { color: rgba(255, 255, 255, .65); }
   body[data-ds-dark-theme] .dsbt-item:hover { color: rgba(255, 255, 255, .95); }
@@ -2175,6 +2216,19 @@ window.__ModuleLoader__.load({
 			out.sort((a, b) => a.seq - b.seq);
 			return out;
 		}
+		/**
+		* Count the user messages the loaded window holds WITHOUT collecting or
+		* sorting them — the fast gate railMessages uses to skip the merge path on
+		* the streaming hot path (see there).
+		* @param chat - the loaded chat snapshot.
+		*/
+		function countWindowUserMessages(chat) {
+			const nodes = chat?.nodes;
+			if (nodes === void 0 || typeof nodes.values !== "function") return 0;
+			let count = 0;
+			for (const node of nodes.values()) if (node !== null && typeof node === "object" && node.kind === "user") count += 1;
+			return count;
+		}
 		/** Resolve the DOM anchor key of one entry (direct key form only). */
 		function resolveAnchorKey(m) {
 			return typeof m.key === "string" && m.key !== "" ? m.key : void 0;
@@ -2219,24 +2273,44 @@ window.__ModuleLoader__.load({
 			return out;
 		}
 		/**
-		* Rail messages with the fastest source first: the host projection covers the
-		* WHOLE session (and already excludes rewind cuts), so it wins whenever it
-		* has anything; otherwise fall back to the loaded chat-node window. The
-		* projection path still applies locally-known rewind hiding so a cut lands
-		* instantly even before the next projection push arrives.
-		* @param snapshot - the session conversation snapshot (node fallback).
+		* Rail messages: the host projection (whole-session index) MERGED with the
+		* loaded chat-node window. The projection normally wins outright, but a
+		* projection that lost its baseline (e.g. the plugin was hot-reloaded after
+		* the session's tail page seeded the client store) can miss early entries —
+		* the window fills those gaps whenever it holds them, and window entries
+		* lend their real anchor key to projected entries whose durable id was
+		* absent (early events without one). Locally-known rewind hiding applies to
+		* the merged list so a cut lands instantly, before the next projection push.
+		* @param snapshot - the session conversation snapshot (node window).
 		* @param projected - the raw bgTimeline projection value.
 		*/
 		function railMessages(snapshot, projected) {
 			const projectedMessages = normalizeProjectedTimeline(projected);
-			if (projectedMessages.length > 0) {
-				const chat = snapshot?.chat;
-				const hidden = rewindHiddenSeqsOfChat(chat);
-				const spans = rewindSpansOfChat(chat);
-				if (hidden.size === 0 && spans.length === 0) return projectedMessages;
-				return projectedMessages.filter((m) => !hidden.has(m.seq) && !spans.some((span) => m.seq >= span.start && m.seq <= span.end));
+			const chat = snapshot?.chat;
+			const hidden = rewindHiddenSeqsOfChat(chat);
+			const spans = rewindSpansOfChat(chat);
+			const isHidden = (seq) => hidden.has(seq) || spans.some((span) => seq >= span.start && seq <= span.end);
+			if (projectedMessages.length === 0) return collectMessages(snapshot);
+			const windowUserCount = countWindowUserMessages(chat);
+			const projectionLacksKeys = projectedMessages.some((m) => m.key === void 0);
+			if (windowUserCount <= projectedMessages.length && !projectionLacksKeys) return hidden.size === 0 && spans.length === 0 ? projectedMessages : projectedMessages.filter((m) => !isHidden(m.seq));
+			const windowMessages = collectMessages(snapshot);
+			const bySeq = /* @__PURE__ */ new Map();
+			for (const m of projectedMessages) if (!isHidden(m.seq)) bySeq.set(m.seq, m);
+			for (const m of windowMessages) {
+				if (isHidden(m.seq)) continue;
+				const existing = bySeq.get(m.seq);
+				if (existing === void 0) {
+					bySeq.set(m.seq, m);
+					continue;
+				}
+				if (existing.key === void 0 && m.key !== void 0) bySeq.set(m.seq, {
+					...existing,
+					key: m.key,
+					...existing.text === "" && m.text !== "" ? { text: m.text } : {}
+				});
 			}
-			return collectMessages(snapshot);
+			return [...bySeq.values()].sort((a, b) => a.seq - b.seq);
 		}
 		/**
 		* Outer rail height for a message count: rows + breathing room, clamped so
@@ -2270,26 +2344,70 @@ window.__ModuleLoader__.load({
 			}
 			return Math.round(Math.max(RAIL_MIN_WIDTH, Math.min(RAIL_MAX_WIDTH, widest + 6 + 24 + 16 + 12)));
 		}
-		/** Ensure the target node is loaded, then scroll its row into view. */
-		async function jumpToMessage(sessionsService, sessionId, key) {
+		/** How long one jump may keep paging older history before giving up. */
+		const JUMP_PAGE_DEADLINE_MS = 3e4;
+		/** How long to wait for the chat view to commit the target row. */
+		const JUMP_ROW_WAIT_MS = 3e3;
+		/**
+		* Poll the conversation DOM until the target row is committed. The session
+		* store updates BEFORE React renders the prepended page, so the old one-shot
+		* query right after loadOlder() resolved could miss the row and silently
+		* give up — the reported "click does nothing until the conversation is
+		* nudged (scroll/click)" behavior.
+		* @param key - chat anchor key to look for.
+		* @param timeoutMs - polling budget.
+		*/
+		async function waitForChatRow(key, timeoutMs) {
+			const scrollports = Array.from(document.querySelectorAll("[data-conversation-scroll]"));
+			if (scrollports.length === 0) return null;
+			const selector = `[data-chat-anchor-key="${CSS.escape(key)}"]`;
+			const deadline = Date.now() + timeoutMs;
+			for (;;) {
+				for (const scrollport of scrollports) {
+					const row = scrollport.querySelector(selector);
+					if (row !== null) return row;
+				}
+				if (Date.now() >= deadline) return null;
+				await delay(40);
+			}
+		}
+		/**
+		* Ensure the target node is loaded, wait for the chat view to commit its row
+		* into the DOM, then scroll it into view. Paging uses a time budget instead
+		* of the old fixed 120-iteration guard (each in-flight page burned 50ms of
+		* that guard, so slow history could exhaust it and silently fail).
+		*/
+		async function jumpToMessage(sessionsService, sessionId, key, rowWaitMs = JUMP_ROW_WAIT_MS) {
 			const session = sessionsService.binding(sessionId)?.session;
 			if (session === void 0) return false;
-			let guard = 0;
-			while (guard++ < 120) {
+			const deadline = Date.now() + JUMP_PAGE_DEADLINE_MS;
+			for (;;) {
 				const snapshot = session.getSnapshot();
 				if (snapshot?.chat?.nodes?.get(key) !== void 0) break;
-				if (snapshot?.hasMore !== true) return false;
+				if (snapshot?.hasMore !== true) break;
+				if (Date.now() >= deadline) break;
 				if (snapshot.loadingOlder === true) {
 					await delay(50);
 					continue;
 				}
+				if (snapshot.openState !== void 0 && snapshot.openState !== "open") {
+					await delay(100);
+					continue;
+				}
 				await session.loadOlder();
 			}
-			const row = document.querySelector("[data-conversation-scroll]")?.querySelector(`[data-chat-anchor-key="${CSS.escape(key)}"]`) ?? null;
-			if (row === null) return false;
+			const row = await waitForChatRow(key, rowWaitMs);
+			if (row === null) {
+				console.warn(`[deepseek-harness-background] timeline jump target never rendered: ${key}`);
+				return false;
+			}
 			const reducedMotion = typeof window.matchMedia === "function" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
 			row.scrollIntoView({
-				behavior: reducedMotion ? "auto" : "smooth",
+				behavior: "auto",
+				block: "center"
+			});
+			if (!reducedMotion) row.scrollIntoView({
+				behavior: "smooth",
 				block: "center"
 			});
 			return true;
@@ -2578,8 +2696,9 @@ window.__ModuleLoader__.load({
 											type: "button",
 											className: "dsbt-jump",
 											ref: isActive ? activeItemRef : void 0,
-											title: `${marked ? "★ " : ""}${m.text === "" ? t("timeline.noText") : m.text}`,
-											"aria-label": `${marked ? "★ " : ""}${t("timeline.roleUser")}: ${m.text.slice(0, 60) || t("timeline.noText")}`,
+											disabled: key === void 0,
+											title: key === void 0 ? t("timeline.cannotJump") : `${marked ? "★ " : ""}${m.text === "" ? t("timeline.noText") : m.text}`,
+											"aria-label": key === void 0 ? `${marked ? "★ " : ""}${t("timeline.roleUser")}: ${t("timeline.cannotJump")}` : `${marked ? "★ " : ""}${t("timeline.roleUser")}: ${m.text.slice(0, 60) || t("timeline.noText")}`,
 											"aria-current": isActive ? "location" : void 0,
 											onClick: () => {
 												if (key === void 0) return;