@huaqiu/dsh-tool-plugin-update 0.0.0-stage → 0.5.21

package/lib/client.js

@@ -0,0 +1,1006 @@
+window.__ModuleLoader__.load({
+	id: "@huaqiu/dsh-tool-plugin-update",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		//#region ../dsh-sidebar-entry/lib/index.mjs
+		/** Find the sidebar shell root element, or undefined while not yet mounted. */
+		function sidebarRoot() {
+			const column = document.querySelector("[data-pane=\"sidebar\"], [class*=\"sidebarCol\"]");
+			if (column === null) return void 0;
+			return column.querySelector("[class*=\"logoRow\"]")?.parentElement ?? column.firstElementChild;
+		}
+		/** The New Session button: nested in the logo row on current shells, a direct child on legacy shells. */
+		function newSessionButton(root) {
+			const nested = root.querySelector("button[class*=\"newSession\"]");
+			if (nested !== null) return nested;
+			for (const child of root.children) if (child.tagName === "BUTTON") return child;
+		}
+		/** Build the entry row (a detached button; insert once the shell is up). */
+		function createEntry(options) {
+			const entry = document.createElement("button");
+			entry.type = "button";
+			entry.setAttribute(options.rowAttribute, "");
+			if (options.plugin !== void 0) {
+				entry.setAttribute("data-dsh-plugin", options.plugin);
+				entry.setAttribute("data-dsh-part", "sidebar-entry");
+			}
+			entry.className = options.css["entry"] ?? "";
+			const labelSpan = document.createElement("span");
+			labelSpan.className = options.css["entryLabel"] ?? "";
+			const iconSpan = document.createElement("span");
+			iconSpan.className = options.css["entryIcon"] ?? "";
+			iconSpan.innerHTML = options.icon;
+			entry.append(iconSpan, labelSpan);
+			let badgeSpan = null;
+			const applyBadge = () => {
+				if (options.badge === void 0) return;
+				const count = options.badge.count();
+				if (count <= 0) {
+					badgeSpan?.remove();
+					badgeSpan = null;
+					return;
+				}
+				if (badgeSpan === null) {
+					badgeSpan = document.createElement("span");
+					badgeSpan.className = options.css["entryBadge"] ?? "";
+					entry.append(badgeSpan);
+				}
+				badgeSpan.textContent = String(count);
+				entry.setAttribute("data-has-badge", "");
+			};
+			const applyLabel = () => {
+				entry.setAttribute("aria-label", options.label());
+				if (options.tooltip !== void 0) entry.setAttribute("title", options.tooltip());
+				labelSpan.textContent = options.label();
+			};
+			applyLabel();
+			applyBadge();
+			entry.addEventListener("click", options.onToggle);
+			return {
+				entry,
+				applyLabel,
+				applyBadge
+			};
+		}
+		/** Re-insert the entry after the New Session row (before the browser region). */
+		function placeEntry(root, entry, options) {
+			const button = newSessionButton(root);
+			if (button === void 0) return false;
+			if (entry.parentElement !== root) {
+				const row = button.closest("[class*=\"logoRow\"]");
+				const base = row !== null && row.parentElement === root ? row : button;
+				const family = Array.from(root.children).filter((el) => el instanceof HTMLElement && el.matches(options.familySelectors.join(", ")));
+				const anchor = options.position === "before" ? family.length > 0 ? family[0] : base.nextElementSibling : family.length > 0 ? family[family.length - 1].nextElementSibling : base.nextElementSibling;
+				root.insertBefore(entry, anchor ?? null);
+			}
+			return true;
+		}
+		/**
+		* Mount the sidebar entry, waiting for the shell to render and self-healing
+		* on later React re-renders.
+		* @param options - the row's attribute/icon/copy/action/ordering configuration.
+		* @returns disposer removing the entry and its observers.
+		*/
+		function mountSidebarEntry(options) {
+			if (typeof document !== "undefined" && document.querySelector(options.rowSelector) !== null) return () => {};
+			const { entry, applyLabel, applyBadge } = createEntry(options);
+			let root;
+			let placed = false;
+			let unsubscribeRefresh;
+			if (options.refresh !== void 0) try {
+				unsubscribeRefresh = options.refresh.subscribe(applyLabel);
+			} catch {}
+			let unsubscribeBadge;
+			if (options.badge !== void 0) try {
+				unsubscribeBadge = options.badge.subscribe(applyBadge);
+			} catch {}
+			const tryPlace = () => {
+				if (root !== void 0 && !root.isConnected) {
+					rootObserver.disconnect();
+					root = void 0;
+					placed = false;
+				}
+				if (placed) {
+					if (document.body.contains(entry)) return;
+					rootObserver.disconnect();
+					root = void 0;
+					placed = false;
+				}
+				root ??= sidebarRoot();
+				if (root === void 0) return;
+				placed = placeEntry(root, entry, options);
+				if (placed) rootObserver.observe(root, {
+					childList: true,
+					subtree: true
+				});
+			};
+			const waitObserver = new MutationObserver(() => {
+				tryPlace();
+			});
+			waitObserver.observe(document.body, {
+				childList: true,
+				subtree: true
+			});
+			const rootObserver = new MutationObserver(() => {
+				if (root === void 0 || !root.isConnected) {
+					placed = false;
+					tryPlace();
+					return;
+				}
+				if (!root.contains(entry)) placed = placeEntry(root, entry, options);
+			});
+			options.active === void 0 || (() => {
+				const syncActive = () => {
+					if (options.active.isOpen()) entry.dataset.active = "true";
+					else delete entry.dataset.active;
+				};
+				const unsubscribe = options.active.subscribe(syncActive);
+				syncActive();
+				return unsubscribe;
+			})();
+			tryPlace();
+			return () => {
+				waitObserver.disconnect();
+				rootObserver.disconnect();
+				unsubscribeRefresh?.();
+				unsubscribeBadge?.();
+				entry.remove();
+			};
+		}
+		/**
+		* Every row selector in the Huaqiu sidebar family, in intended visual order.
+		*
+		* Family ordering is only stable when every participating plugin passes the
+		* SAME list to {@link mountSidebarEntry} — the core positions a row relative to
+		* the family block, never relative to transient shell geometry. Adding a new
+		* family row means adding its selector here (and to no plugin-local list).
+		*/
+		const HUAQIU_SIDEBAR_ENTRY_FAMILY = [
+			"[data-hqcg-footprint-entry]",
+			"[data-hqcg-symbol-entry]",
+			"[data-hqcg-schematic-entry]",
+			"[data-hq-plugin-update-entry]"
+		];
+		/**
+		* Read the host UI language from `<html lang>`.
+		*
+		* `dsh-client-locale` rewrites the attribute on every language change (dsh
+		* web) and HQ Edge mirrors it, so this is the one source every family plugin
+		* can read without importing a `locale` service.
+		* @returns 'zh' / 'en', or undefined when the tag is absent or unsupported
+		*   (callers fall back to their own default).
+		*/
+		function detectHostLocale() {
+			if (typeof document === "undefined") return void 0;
+			const tag = document.documentElement?.getAttribute("lang");
+			if (tag === null || tag === void 0 || tag === "") return void 0;
+			const primary = tag.toLowerCase().split("-")[0];
+			return primary === "zh" || primary === "en" ? primary : void 0;
+		}
+		/**
+		* Watch `<html lang>` and report every resolved change.
+		*
+		* Idempotent-safe: repeated calls share one observer and each caller gets its
+		* own disposer; the observer disconnects when the last listener leaves.
+		* @param listener - called with the newly resolved language.
+		* @returns disposer removing this listener.
+		*/
+		/** Shared observer/listener set backing {@link observeHostLocale}. */
+		const localeListeners = /* @__PURE__ */ new Set();
+		let localeObserver = null;
+		function observeHostLocale(listener) {
+			if (typeof document === "undefined" || typeof MutationObserver === "undefined" || document.documentElement === null) return () => {};
+			let current = detectHostLocale();
+			const listeners = localeListeners;
+			listeners.add(listener);
+			if (localeObserver === null) {
+				localeObserver = new MutationObserver(() => {
+					const next = detectHostLocale();
+					if (next === current) return;
+					current = next;
+					for (const fn of [...listeners]) try {
+						fn(next);
+					} catch {}
+				});
+				localeObserver.observe(document.documentElement, {
+					attributes: true,
+					attributeFilter: ["lang"]
+				});
+			}
+			return () => {
+				listeners.delete(listener);
+				if (listeners.size === 0 && localeObserver !== null) {
+					localeObserver.disconnect();
+					localeObserver = null;
+				}
+			};
+		}
+		//#endregion
+		//#region src/client/api.ts
+		/**
+		* Plugin-update API client (browser half).
+		*
+		* Every call is a same-origin fetch against the DSH webServer prefix route
+		* (`/api/v1/huaqiu/plugin-update/…`) which the node half forwards to hq-edge.
+		* Response shapes mirror hq-edge `apps/server/src/routes/plugin-updates.ts`.
+		*
+		* @module
+		*/
+		const UPDATE_BASE = "/api/v1/huaqiu/plugin-update";
+		async function request(path, init) {
+			const res = await fetch(`${UPDATE_BASE}${path}`, {
+				cache: "no-store",
+				...init,
+				headers: {
+					"content-type": "application/json; charset=utf-8",
+					...init?.headers ?? {}
+				}
+			});
+			const body = await res.json().catch(() => null);
+			if (!res.ok) {
+				const err = body?.error ?? `HTTP ${res.status}`;
+				throw new Error(err);
+			}
+			if (body === null) throw new Error("empty response");
+			return body;
+		}
+		/** GET the cached (or empty-shell) plugin-update report. */
+		function fetchReport() {
+			return request("/report");
+		}
+		/** POST an explicit refresh; returns the freshly computed report. */
+		function checkUpdates() {
+			return request("/check", { method: "POST" });
+		}
+		/** POST the install transaction for the confirmed set version. */
+		function installSet(setVersion) {
+			return request("/install", {
+				method: "POST",
+				body: JSON.stringify({ setVersion })
+			});
+		}
+		/** POST unignore for the set version (reverses an ignore). */
+		function unignoreOffer(setVersion) {
+			return request("/unignore", {
+				method: "POST",
+				body: JSON.stringify({ setVersion })
+			});
+		}
+		const COPY = {
+			zh: {
+				entryLabel: "插件更新",
+				entryTooltip: "查看可用的插件更新",
+				viewTitle: "插件更新",
+				refresh: "刷新",
+				close: "关闭",
+				empty: "没有可用的插件更新",
+				checkFailed: "检查更新失败",
+				manifestVersion: "插件集",
+				ignoredOffer: "已忽略当前插件集更新",
+				unignore: "恢复提醒",
+				installAll: (count) => `安装 ${count} 项更新`,
+				installing: "安装中…（DSH 将自动重启）",
+				state: {
+					current: "当前",
+					update: "可更新",
+					install: "待安装",
+					ignored: "已忽略",
+					blocked: "被阻止"
+				},
+				blockedReason: {
+					host: "不适用于当前 EDA 主机",
+					"hq-edge-version": "当前 HQ Edge 版本不兼容",
+					"runtime-unknown": "HQ Edge 版本未知，无法校验"
+				},
+				runtime: {
+					title: "HQ Edge 运行时",
+					updateAvailable: (version) => `发现新版本 ${version}`,
+					current: (version) => `当前版本 ${version}`,
+					unknown: "版本未知",
+					notConfigured: "未配置更新源",
+					note: "运行时更新由 EDA 安装器处理"
+				},
+				lastError: "上次检查失败",
+				fetchedAt: "检查时间",
+				installError: "安装失败",
+				installSuccess: "更新已安装，正在重启 DSH…"
+			},
+			en: {
+				entryLabel: "Plugin Updates",
+				entryTooltip: "Review available plugin updates",
+				viewTitle: "Plugin Updates",
+				refresh: "Refresh",
+				close: "Close",
+				empty: "No plugin updates available",
+				checkFailed: "Failed to check for updates",
+				manifestVersion: "Plugin set",
+				ignoredOffer: "The current plugin-set update is ignored",
+				unignore: "Show again",
+				installAll: (count) => `Install ${count} update${count === 1 ? "" : "s"}`,
+				installing: "Installing… (DSH will restart)",
+				state: {
+					current: "Current",
+					update: "Update",
+					install: "Install",
+					ignored: "Ignored",
+					blocked: "Blocked"
+				},
+				blockedReason: {
+					host: "Not applicable to the current EDA host",
+					"hq-edge-version": "Incompatible with the current HQ Edge version",
+					"runtime-unknown": "HQ Edge version unknown — cannot verify"
+				},
+				runtime: {
+					title: "HQ Edge Runtime",
+					updateAvailable: (version) => `New version ${version} available`,
+					current: (version) => `Current version ${version}`,
+					unknown: "Version unknown",
+					notConfigured: "No update source configured",
+					note: "Runtime updates are handled by the EDA installer"
+				},
+				lastError: "Last check failed",
+				fetchedAt: "Checked at",
+				installError: "Install failed",
+				installSuccess: "Update installed — restarting DSH…"
+			}
+		};
+		//#endregion
+		//#region src/client/update-view.ts
+		/**
+		* Plugin-update review modal (browser half).
+		*
+		* Plain-DOM modal (no React tree) so it can never disturb the DSH shell's
+		* reconciliation — same rule as the sidebar entry rows. Rendered content:
+		*
+		*   - header: title + refresh
+		*   - plugin list (name, current → available, state badge, blocked reason)
+		*   - ignored-offer banner + reversible "show again"
+		*   - install action (disabled while installing / nothing actionable / offer
+		*     ignored); after install the UI keeps polling the backend state instead
+		*     of trusting the HTTP response alone, because activating a set restarts
+		*     DSH (spec §7.1: never report success on the 200/202 alone).
+		*   - independent HQ Edge runtime section (read-only report; the actual
+		*     upgrade is owned by the EDA installer).
+		*
+		* @module
+		*/
+		function el(tag, className, text) {
+			const node = document.createElement(tag);
+			node.className = className;
+			if (text !== void 0) node.textContent = text;
+			return node;
+		}
+		function stateLabel(item, copy) {
+			switch (item.state) {
+				case "current": return copy.state.current;
+				case "update": return copy.state.update;
+				case "install": return copy.state.install;
+				case "ignored": return copy.state.ignored;
+				case "blocked": return copy.state.blocked;
+			}
+		}
+		function blockedReason(item, copy) {
+			const by = item.blockedBy ?? [];
+			if (by.includes("host")) return copy.blockedReason.host;
+			if (by.includes("hq-edge-version")) return copy.blockedReason["hq-edge-version"];
+			if (by.includes("runtime-unknown")) return copy.blockedReason["runtime-unknown"];
+			return by.length > 0 ? by.join(", ") : void 0;
+		}
+		/**
+		* Open (or focus) the update modal. Re-renders from the store; when the store
+		* is stale the modal first refreshes the report.
+		*/
+		function openUpdateView(store, copy) {
+			const existing = document.querySelector("[data-hq-plugin-update-view]");
+			if (existing !== null) {
+				existing.style.display = "";
+				return;
+			}
+			const overlay = el("div", "hqpu-overlay");
+			overlay.setAttribute("data-hq-plugin-update-view", "");
+			const panel = el("div", "hqpu-panel");
+			const header = el("div", "hqpu-header");
+			header.append(el("div", "hqpu-title", copy.viewTitle));
+			const refreshBtn = el("button", "hqpu-btn", copy.refresh);
+			header.append(refreshBtn);
+			const closeBtn = el("button", "hqpu-btn hqpu-btn-ghost", copy.close);
+			header.append(closeBtn);
+			const body = el("div", "hqpu-body");
+			const listSection = el("div", "hqpu-section");
+			const runtimeSection = el("div", "hqpu-section hqpu-runtime");
+			const actionBar = el("div", "hqpu-actions");
+			panel.append(header, body);
+			body.append(listSection, runtimeSection, actionBar);
+			overlay.append(panel);
+			document.body.appendChild(overlay);
+			const disposers = [];
+			const render = () => {
+				const report = store.report();
+				const installing = store.installing();
+				renderList(listSection, report, copy, installing, store);
+				renderRuntime(runtimeSection, report, copy);
+				renderActions(actionBar, report, copy, store, installing);
+			};
+			const unsubscribe = store.subscribe(render);
+			disposers.push(unsubscribe);
+			store.refresh().then(() => {});
+			const onClose = () => {
+				for (const dispose of disposers) try {
+					dispose();
+				} catch {}
+				overlay.remove();
+			};
+			closeBtn.addEventListener("click", onClose);
+			overlay.addEventListener("click", (ev) => {
+				if (ev.target === overlay) onClose();
+			});
+			refreshBtn.addEventListener("click", () => {
+				store.refresh();
+			});
+			disposers.push(() => {
+				closeBtn.removeEventListener("click", onClose);
+				overlay.removeEventListener("click", onClose);
+				refreshBtn.removeEventListener("click", () => {});
+			});
+			render();
+		}
+		function renderList(section, report, copy, installing, store) {
+			section.textContent = "";
+			if (report === null) {
+				section.append(el("div", "hqpu-empty", copy.checkFailed));
+				return;
+			}
+			if (report.items.length === 0) {
+				section.append(el("div", "hqpu-empty", copy.empty));
+				return;
+			}
+			const manifestRow = el("div", "hqpu-manifest");
+			manifestRow.append(el("span", "hqpu-manifest-label", `${copy.manifestVersion}`), el("span", "hqpu-manifest-value", report.manifestVersion));
+			section.append(manifestRow);
+			if (report.ignoredSet) {
+				const banner = el("div", "hqpu-ignored-banner", copy.ignoredOffer);
+				const unignore = el("button", "hqpu-btn hqpu-btn-small", copy.unignore);
+				unignore.addEventListener("click", () => {
+					unignoreOffer(report.manifestVersion).then(() => store.refresh()).catch(() => void 0);
+				});
+				banner.append(unignore);
+				section.append(banner);
+			}
+			const list = el("ul", "hqpu-list");
+			for (const item of report.items) {
+				const row = el("li", `hqpu-item hqpu-item-${item.state}`);
+				const name = el("span", "hqpu-item-name", item.name);
+				const version = el("span", "hqpu-item-version", item.state === "current" ? item.currentVersion : `${item.currentVersion} → ${item.availableVersion}`);
+				const state = el("span", `hqpu-item-state hqpu-state-${item.state}`, stateLabel(item, copy));
+				row.append(name, version, state);
+				const reason = blockedReason(item, copy);
+				if (reason !== void 0) row.append(el("span", "hqpu-item-reason", reason));
+				list.append(row);
+			}
+			section.append(list);
+		}
+		function renderRuntime(section, report, copy) {
+			section.textContent = "";
+			const title = el("div", "hqpu-runtime-title", copy.runtime.title);
+			section.append(title);
+			const runtime = report?.runtime;
+			if (runtime === void 0 || runtime.configured === false) {
+				section.append(el("div", "hqpu-runtime-line", copy.runtime.notConfigured));
+				return;
+			}
+			if (runtime.updateAvailable && runtime.latest !== void 0) section.append(el("div", "hqpu-runtime-line", copy.runtime.updateAvailable(runtime.latest)));
+			else if (runtime.currentVersion !== void 0) section.append(el("div", "hqpu-runtime-line", copy.runtime.current(runtime.currentVersion)));
+			else section.append(el("div", "hqpu-runtime-line", copy.runtime.unknown));
+			section.append(el("div", "hqpu-runtime-note", copy.runtime.note));
+			if (runtime.lastError !== void 0 && runtime.lastError.length > 0) section.append(el("div", "hqpu-runtime-error", `${copy.lastError}: ${runtime.lastError}`));
+		}
+		function renderActions(bar, report, copy, store, installing) {
+			bar.textContent = "";
+			if (report === null) return;
+			if (installing) {
+				bar.append(el("span", "hqpu-installing", copy.installing));
+				return;
+			}
+			const actionable = report.items.filter((item) => item.state === "update" || item.state === "install").length;
+			const installBtn = el("button", "hqpu-btn hqpu-btn-primary", actionable > 0 ? copy.installAll(actionable) : copy.state.current);
+			installBtn.disabled = actionable === 0 || report.ignoredSet;
+			installBtn.addEventListener("click", () => {
+				installSet(report.manifestVersion).then((result) => {
+					if (result.error !== void 0) {
+						bar.textContent = "";
+						bar.append(el("div", "hqpu-error", `${copy.installError}: ${result.error}`));
+						return;
+					}
+					bar.textContent = "";
+					bar.append(el("span", "hqpu-installing", copy.installSuccess));
+					pollUntilSettled(store, report.manifestVersion);
+				}).catch((err) => {
+					bar.textContent = "";
+					bar.append(el("div", "hqpu-error", `${copy.installError}: ${err instanceof Error ? err.message : String(err)}`));
+				});
+			});
+			bar.append(installBtn);
+		}
+		/** After an install, poll the backend until the update report settles
+		*  (installing flag clears or DSH restarts under us — the next load re-reads
+		*  the fresh state). */
+		function pollUntilSettled(store, setVersion) {
+			let attempts = 0;
+			const tick = () => {
+				store.refresh().then((report) => {
+					if (store.installing()) return;
+					if (report !== null && report.ignoredSet === false && attempts >= 2) return;
+				}).catch(() => void 0).finally(() => {
+					attempts += 1;
+					if (attempts < 10) window.setTimeout(tick, 2e3);
+				});
+			};
+			tick();
+		}
+		//#endregion
+		//#region src/client/index.ts
+		/**
+		* `@huaqiu/dsh-tool-plugin-update` — browser half.
+		*
+		* Mounts one sidebar toolbutton in the Huaqiu family block ("插件更新") with a
+		* numeric badge equal to the actionable plugin-update count (spec §6.3/§7.1:
+		* only compatible `update` + `install` items after host/HQ-Edge filtering and
+		* after excluding the ignored offer; runtime updates are NOT counted). Click
+		* opens the review/confirm/ignore modal.
+		*
+		* The authoritative state is the hq-edge report fetched through the plugin's
+		* same-origin forwarding routes. A tiny in-memory store owns the latest report
+		* + installing flag; the sidebar badge and the modal subscribe to it. No
+		* timers beyond the install-poll and an idle 60 s refresh.
+		*
+		* @module
+		*/
+		/** Stable data attributes identifying the injected entry row. */
+		const UPDATE_ENTRY_SELECTOR = "[data-hq-plugin-update-entry]";
+		const UPDATE_ENTRY_ATTRIBUTE = "data-hq-plugin-update-entry";
+		/** L2 semantic plugin id: rows carry data-dsh-plugin + data-dsh-part. */
+		const PLUGIN_ID = "huaqiu-plugin-update";
+		/** Row class names (defined by {@link ENTRY_CSS_TEXT}). */
+		const ENTRY_CSS = {
+			entry: "hqpu-sidebar-entry",
+			entryIcon: "hqpu-sidebar-entry__icon",
+			entryLabel: "hqpu-sidebar-entry__label",
+			entryBadge: "hqpu-sidebar-entry__badge"
+		};
+		/** Localized row copy: zh is the fallback, matching the family convention. */
+		function entryCopy(lang) {
+			return lang === "en" ? {
+				label: COPY.en.entryLabel,
+				tooltip: COPY.en.entryTooltip
+			} : {
+				label: COPY.zh.entryLabel,
+				tooltip: COPY.zh.entryTooltip
+			};
+		}
+		/** Inline update glyph — `currentColor`, 16×16 like the shell's nav glyphs. */
+		const UPDATE_ICON = `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16">
+    <g fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round">
+        <path d="M2.5 8a5.5 5.5 0 1 1 1.61 3.89" />
+        <path d="M2.5 8V4.75M2.5 8h3.25" />
+    </g>
+</svg>`;
+		/** Sidebar entry styles — matched to the family rows (same inset/padding/gap
+		*  as the shell's own Plugins entry). The badge is a 16px rounded pill. */
+		const ENTRY_CSS_TEXT = `
+.hqpu-sidebar-entry {
+  box-sizing: border-box;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+  margin: 0 2px;
+  min-height: 36px;
+  padding: 7px 8px;
+  background: transparent;
+  border: none;
+  border-radius: 12px;
+  color: var(--dsw-alias-label-primary);
+  cursor: pointer;
+  font: inherit;
+  line-height: 22px;
+  text-align: left;
+  white-space: nowrap;
+}
+.hqpu-sidebar-entry:hover {
+  background: var(--dsw-alias-interactive-bg-hover);
+}
+.hqpu-sidebar-entry[data-active] {
+  background: var(--dsw-alias-interactive-bg-hover);
+  color: var(--dsw-alias-label-primary);
+}
+.hqpu-sidebar-entry__icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: none;
+}
+.hqpu-sidebar-entry__icon svg {
+  display: block;
+  width: 16px;
+  height: 16px;
+}
+.hqpu-sidebar-entry__label {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  flex: 1;
+}
+.hqpu-sidebar-entry__badge {
+  flex: none;
+  min-width: 16px;
+  height: 16px;
+  padding: 0 5px;
+  border-radius: 8px;
+  background: var(--dsw-alias-bg-badge, #e5484d);
+  color: #fff;
+  font-size: 11px;
+  line-height: 16px;
+  text-align: center;
+}
+/* Collapsed rail: icon-only, centered — same 36px square the shell uses. */
+[data-sidebar-collapsed] .hqpu-sidebar-entry {
+  justify-content: center;
+  width: 36px;
+  height: 36px;
+  margin: 0;
+  padding: 0;
+}
+[data-sidebar-collapsed] .hqpu-sidebar-entry__icon svg {
+  width: 18px;
+  height: 18px;
+}
+[data-sidebar-collapsed] .hqpu-sidebar-entry__label,
+[data-sidebar-collapsed] .hqpu-sidebar-entry__badge {
+  display: none;
+}
+`;
+		/** Modal styles (hqpu-*). Plain overlay + panel, aligned to the shell's
+		*  dark/light aliases. */
+		const VIEW_CSS_TEXT = `
+.hqpu-overlay {
+  position: fixed;
+  inset: 0;
+  z-index: 1000;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: rgba(0, 0, 0, 0.45);
+}
+.hqpu-panel {
+  box-sizing: border-box;
+  width: min(640px, calc(100vw - 48px));
+  max-height: min(80vh, 720px);
+  display: flex;
+  flex-direction: column;
+  border-radius: 16px;
+  background: var(--dsw-alias-bg-surface, #fff);
+  color: var(--dsw-alias-label-primary, #1f2329);
+  box-shadow: 0 24px 64px rgba(0, 0, 0, 0.24);
+  overflow: hidden;
+}
+.hqpu-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 14px 16px;
+  border-bottom: 1px solid var(--dsw-alias-line-border, rgba(0,0,0,.08));
+}
+.hqpu-title {
+  flex: 1;
+  font-size: 15px;
+  font-weight: 600;
+}
+.hqpu-body {
+  overflow: auto;
+  padding: 16px;
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+}
+.hqpu-section {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.hqpu-manifest {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 12px;
+  color: var(--dsw-alias-label-secondary, #646a73);
+}
+.hqpu-manifest-value {
+  font-weight: 600;
+  color: var(--dsw-alias-label-primary, #1f2329);
+}
+.hqpu-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+.hqpu-item {
+  display: grid;
+  grid-template-columns: 1fr auto auto;
+  gap: 8px;
+  align-items: center;
+  padding: 8px 10px;
+  border-radius: 10px;
+  background: var(--dsw-alias-interactive-bg-hover, rgba(0,0,0,.04));
+  font-size: 13px;
+}
+.hqpu-item-name {
+  font-weight: 500;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.hqpu-item-version {
+  color: var(--dsw-alias-label-secondary, #646a73);
+  font-variant-numeric: tabular-nums;
+}
+.hqpu-item-state {
+  padding: 1px 8px;
+  border-radius: 999px;
+  font-size: 11px;
+  line-height: 18px;
+}
+.hqpu-state-current { background: rgba(0,0,0,.06); color: var(--dsw-alias-label-secondary, #646a73); }
+.hqpu-state-update, .hqpu-state-install { background: rgba(229,72,77,.12); color: #d92d33; }
+.hqpu-state-ignored { background: rgba(0,0,0,.06); color: var(--dsw-alias-label-secondary, #646a73); }
+.hqpu-state-blocked { background: rgba(229,72,77,.12); color: #d92d33; }
+.hqpu-item-reason {
+  grid-column: 1 / -1;
+  font-size: 12px;
+  color: var(--dsw-alias-label-tertiary, #8f959e);
+}
+.hqpu-ignored-banner {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 10px;
+  border-radius: 10px;
+  background: rgba(120,120,120,.1);
+  font-size: 12px;
+  color: var(--dsw-alias-label-secondary, #646a73);
+}
+.hqpu-empty {
+  padding: 24px 0;
+  text-align: center;
+  color: var(--dsw-alias-label-tertiary, #8f959e);
+  font-size: 13px;
+}
+.hqpu-runtime {
+  border-top: 1px solid var(--dsw-alias-line-border, rgba(0,0,0,.08));
+  padding-top: 12px;
+}
+.hqpu-runtime-title {
+  font-size: 13px;
+  font-weight: 600;
+}
+.hqpu-runtime-line {
+  font-size: 12px;
+  color: var(--dsw-alias-label-secondary, #646a73);
+}
+.hqpu-runtime-note {
+  font-size: 11px;
+  color: var(--dsw-alias-label-tertiary, #8f959e);
+}
+.hqpu-runtime-error {
+  font-size: 12px;
+  color: #d92d33;
+}
+.hqpu-actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.hqpu-btn {
+  box-sizing: border-box;
+  padding: 6px 14px;
+  border-radius: 8px;
+  border: 1px solid transparent;
+  background: var(--dsw-alias-interactive-bg-hover, rgba(0,0,0,.06));
+  color: var(--dsw-alias-label-primary, #1f2329);
+  font: inherit;
+  font-size: 13px;
+  cursor: pointer;
+}
+.hqpu-btn-primary {
+  background: #e5484d;
+  color: #fff;
+}
+.hqpu-btn-primary:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+.hqpu-btn-ghost {
+  background: transparent;
+  border-color: var(--dsw-alias-line-border, rgba(0,0,0,.12));
+}
+.hqpu-btn-small {
+  padding: 2px 10px;
+  font-size: 12px;
+}
+.hqpu-installing {
+  font-size: 13px;
+  color: var(--dsw-alias-label-secondary, #646a73);
+}
+.hqpu-error {
+  font-size: 13px;
+  color: #d92d33;
+}
+`;
+		const STYLE_TAG_ID = "data-plugin-css=\"huaqiu-plugin-update\"";
+		/** Inject styles once (idempotent). */
+		function injectUpdateStyles() {
+			if (typeof document === "undefined") return;
+			if (document.querySelector(`style[${STYLE_TAG_ID}]`) !== null) return;
+			const tag = document.createElement("style");
+			tag.dataset.pluginCss = "huaqiu-plugin-update";
+			tag.textContent = `${ENTRY_CSS_TEXT}\n${VIEW_CSS_TEXT}`;
+			document.head.appendChild(tag);
+		}
+		/** In-memory update-report store shared by the badge and the modal. */
+		var UpdateStore = class {
+			current = null;
+			installingFlag = false;
+			listeners = /* @__PURE__ */ new Set();
+			refreshTimer = null;
+			report() {
+				return this.current;
+			}
+			installing() {
+				return this.installingFlag;
+			}
+			subscribe(listener) {
+				this.listeners.add(listener);
+				return () => {
+					this.listeners.delete(listener);
+				};
+			}
+			/** Badge count per spec §6.3: actionable `update` + `install`, excluding the
+			*  ignored offer (the server already folds ignore into item states; keep the
+			*  client-side filter as a defensive second pass). */
+			badgeCount() {
+				const report = this.current;
+				if (report === null) return 0;
+				return report.items.filter((item) => item.state === "update" || item.state === "install").length;
+			}
+			emit() {
+				for (const listener of [...this.listeners]) try {
+					listener();
+				} catch {}
+			}
+			async refresh() {
+				try {
+					const report = await fetchReport();
+					this.current = report;
+					this.emit();
+					return report;
+				} catch {
+					return this.current;
+				}
+			}
+			async check() {
+				try {
+					const report = await checkUpdates();
+					this.current = report;
+					this.emit();
+					return report;
+				} catch {
+					return this.current;
+				}
+			}
+			/** Mark the set as installing (set by the modal before the restart). */
+			setInstalling(flag) {
+				this.installingFlag = flag;
+				this.emit();
+			}
+			/** Idle refresh while mounted (60 s) — no overlapping poll loop. */
+			startIdleRefresh() {
+				if (this.refreshTimer !== null) return;
+				this.refreshTimer = window.setInterval(() => {
+					this.refresh();
+				}, 6e4);
+			}
+			stop() {
+				if (this.refreshTimer !== null) {
+					window.clearInterval(this.refreshTimer);
+					this.refreshTimer = null;
+				}
+				this.listeners.clear();
+			}
+		};
+		/**
+		* Client cordis inject: no service dependencies — the plugin reads the
+		* hq-edge report purely through same-origin fetch (forwarded by its own node
+		* half). `inject` stays empty so the loader never waits on another service.
+		*/
+		const inject = [];
+		/**
+		* Client plugin body — mount the sidebar toolbutton + review modal.
+		* @param ctx - real cordis client context.
+		* @returns disposer removing the row and all subscriptions.
+		*/
+		function apply(ctx) {
+			if (typeof document === "undefined") return () => {};
+			injectUpdateStyles();
+			const store = new UpdateStore();
+			const copy = {
+				zh: COPY.zh,
+				en: COPY.en
+			};
+			const copyFor = () => locale === "en" ? copy.en : copy.zh;
+			let locale = detectHostLocale();
+			const localeSubscribers = /* @__PURE__ */ new Set();
+			const refreshSubscribe = (listener) => {
+				localeSubscribers.add(listener);
+				return () => {
+					localeSubscribers.delete(listener);
+				};
+			};
+			const unsubscribeLocale = observeHostLocale((next) => {
+				locale = next;
+				for (const fn of [...localeSubscribers]) try {
+					fn();
+				} catch {}
+			});
+			const labelState = {
+				label: entryCopy(locale).label,
+				tooltip: entryCopy(locale).tooltip
+			};
+			const openView = () => {
+				store.check().then((report) => {
+					if (report !== null) openUpdateView(store, copyFor());
+				});
+			};
+			const disposeEntry = mountSidebarEntry({
+				rowAttribute: UPDATE_ENTRY_ATTRIBUTE,
+				rowSelector: UPDATE_ENTRY_SELECTOR,
+				plugin: PLUGIN_ID,
+				icon: UPDATE_ICON,
+				css: ENTRY_CSS,
+				label: () => labelState.label,
+				tooltip: () => labelState.tooltip,
+				refresh: { subscribe: refreshSubscribe },
+				badge: {
+					subscribe: (listener) => store.subscribe(listener),
+					count: () => store.badgeCount()
+				},
+				onToggle: openView,
+				position: "after",
+				familySelectors: HUAQIU_SIDEBAR_ENTRY_FAMILY
+			});
+			store.startIdleRefresh();
+			store.refresh();
+			const dispose = () => {
+				try {
+					disposeEntry();
+				} catch {}
+				unsubscribeLocale();
+				store.stop();
+			};
+			if (typeof ctx.effect === "function") ctx.effect(dispose, "plugin-update");
+			return dispose;
+		}
+		//#endregion
+		exports.UPDATE_ENTRY_ATTRIBUTE = UPDATE_ENTRY_ATTRIBUTE;
+		exports.UPDATE_ENTRY_SELECTOR = UPDATE_ENTRY_SELECTOR;
+		exports.UPDATE_ICON = UPDATE_ICON;
+		exports.apply = apply;
+		exports.inject = inject;
+		exports.injectUpdateStyles = injectUpdateStyles;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map