@huaweidevtools/aishell-dsh-brand 0.0.1-beta.0 → 0.0.1-beta.2

package/README.md

@@ -1,6 +1,6 @@
 # @huaweidevtools/aishell-dsh-brand
 
-AI Shell brand reskin for DSH web. Replaces the default DeepSeek fish mark in the sidebar and blank-session hero with the AI Shell icon and wordmark.
+AI Shell brand reskin for DSH web. Replaces the default DeepSeek fish mark in the sidebar and blank-session hero with the AI Shell icon and wordmark, and shadows the browser/window product title at runtime.
 
 ## How it works
 
@@ -14,6 +14,12 @@ All three are `kind: 'single'` slots, so this plugin replaces whatever occupied
 
 SVG assets are inlined as CSS `background-image` data URIs via lightningcss CSS Modules — no runtime fetch, no flash of missing image.
 
+## Window title shadow
+
+The product title "DeepSeek Harness" is baked into the dsh tree at build time (`DSH_CLIENT_TITLE` → both the served `dsh-web-frontend/dist/index.html` and the ui-layout `DocumentTitle` component), and that tree is covered by the desktop-runtime digest — the asar shell-layer swap cannot reach it. The plugin therefore shadows the title at runtime (`src/client/title-shadow.ts`): an own `title` property on the document intercepts every write and rewrites the product name to "AI Shell" in flight, covering both the initial page title and the repeated writes `DocumentTitle` performs on each session/panel change. The Electron main process never calls `setTitle` on the main window, so the window title follows `document.title` and this single seam covers both.
+
+Shadowing is a default, not a force: the effect's disposer removes the own property and restores the official title, so disabling the plugin returns the shell to its official behavior.
+
 ## Install
 
 ```sh
@@ -26,8 +32,9 @@ dsh plugin --profile <name> add @huaweidevtools/aishell-dsh-base
 
 ## What it does NOT touch
 
-- Navigation, settings, panels, conversation — only the three brand slots.
+- Navigation, settings, panels, conversation — only the three brand slots and the product title.
 - DSH default plugins — no rows disabled.
+- Session titles in the browser title — the part before the product name passes through unchanged.
 
 ## License
 

package/lib/client.js

@@ -180,7 +180,7 @@ function AishellBrandName() {
 		"aria-label": "AI Shell",
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 			className: brand_module_css_default.version,
-			children: "0.0.1-beta.0"
+			children: "0.0.1-beta.2"
 		})
 	});
 }
@@ -231,6 +231,89 @@ function injectPoweredBy() {
 }
 injectPoweredBy();
 
+//#endregion
+//#region src/client/title-shadow.ts
+/**
+* Runtime window-title shadowing for the branded distribution.
+*
+* The official product title is baked into the dsh tree at build time
+* (`DSH_CLIENT_TITLE` → "DeepSeek Harness" in both the served
+* dsh-web-frontend dist index.html and the ui-layout DocumentTitle
+* component), and that tree is covered by the desktop-runtime digest —
+* the asar shell-layer swap cannot reach it. The plugin side therefore
+* shadows the title at runtime: this module intercepts every
+* `document.title` write in the renderer and rewrites the product name
+* to "AI Shell" in flight. The Electron main process never calls
+* setTitle on the main window, so the window title follows
+* document.title and this single seam covers both.
+*
+* Shadowing is a default, not a force (plan §2.2): install() and the
+* disposer it returns are symmetric, so disabling the plugin restores
+* the official title behavior exactly.
+*
+* @module @huaweidevtools/aishell-dsh-brand/client
+*/
+/** The official product title, baked into the digest-protected dsh tree. */
+const OFFICIAL_TITLE = "DeepSeek Harness";
+/** The branded product title that shadows it. */
+const BRANDED_TITLE = "AI Shell";
+/**
+* Rewrite the product name inside a title write.
+* Anything else in the value (the session-title prefix ui-layout adds)
+* passes through untouched, and a value without the product name is
+* returned as-is — the shadow never invents content.
+*/
+function rebrandTitle(value) {
+	return value.split(OFFICIAL_TITLE).join(BRANDED_TITLE);
+}
+/**
+* Find the `title` property descriptor on the prototype chain.
+*
+* `document.title` is a WebIDL accessor on Document.prototype — the
+* instance itself has no own property to describe, so the descriptor
+* must be located by walking up the chain.
+*/
+function findTitleDescriptor(target) {
+	let proto = target;
+	while (proto !== null) {
+		const desc = Object.getOwnPropertyDescriptor(proto, "title");
+		if (desc !== void 0) return desc;
+		proto = Object.getPrototypeOf(proto);
+	}
+	return void 0;
+}
+/**
+* Install the title shadow on the document.
+*
+* Defines an own `title` property on the instance (shadowing the
+* prototype accessor) whose setter rewrites each write, then rewrites
+* the current title once so the page's initial <title> from the served
+* dist is covered too. Returns the disposer: it removes the own
+* property (the prototype accessor takes over again) and rewrites the
+* live value back to its official form, so an unload leaves the shell
+* exactly as it was found.
+*/
+function installTitleShadow(target) {
+	const original = findTitleDescriptor(target);
+	if (original === void 0 || original.configurable !== true || typeof original.set !== "function") return () => {};
+	const nativeSet = original.set;
+	const shadow = {
+		configurable: true,
+		enumerable: original.enumerable ?? false,
+		...original.get !== void 0 ? { get: original.get } : {},
+		set(value) {
+			nativeSet.call(this, typeof value === "string" ? rebrandTitle(value) : value);
+		}
+	};
+	Object.defineProperty(target, "title", shadow);
+	const initial = target.title;
+	target.title = initial;
+	return () => {
+		delete target.title;
+		target.title = target.title.split(BRANDED_TITLE).join(OFFICIAL_TITLE);
+	};
+}
+
 //#endregion
 //#region src/client/index.ts
 /** Required service: the UI slot registry. */
@@ -248,6 +331,7 @@ function apply(ctx) {
 		name: "conversation.hero.brand.mark",
 		priority: -1
 	}, AishellHeroBrandMark));
+	if (typeof document !== "undefined") ctx.effect(() => installTitleShadow(document), "aishell-brand: window title shadow");
 }
 
 //#endregion

package/lib/types/client/title-shadow.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Runtime window-title shadowing for the branded distribution.
+ *
+ * The official product title is baked into the dsh tree at build time
+ * (`DSH_CLIENT_TITLE` → "DeepSeek Harness" in both the served
+ * dsh-web-frontend dist index.html and the ui-layout DocumentTitle
+ * component), and that tree is covered by the desktop-runtime digest —
+ * the asar shell-layer swap cannot reach it. The plugin side therefore
+ * shadows the title at runtime: this module intercepts every
+ * `document.title` write in the renderer and rewrites the product name
+ * to "AI Shell" in flight. The Electron main process never calls
+ * setTitle on the main window, so the window title follows
+ * document.title and this single seam covers both.
+ *
+ * Shadowing is a default, not a force (plan §2.2): install() and the
+ * disposer it returns are symmetric, so disabling the plugin restores
+ * the official title behavior exactly.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client
+ */
+/**
+ * Rewrite the product name inside a title write.
+ * Anything else in the value (the session-title prefix ui-layout adds)
+ * passes through untouched, and a value without the product name is
+ * returned as-is — the shadow never invents content.
+ */
+export declare function rebrandTitle(value: string): string;
+/** The disposer restores the official title behavior; a no-op install returns this. */
+export type TitleShadowDisposer = () => void;
+/**
+ * Install the title shadow on the document.
+ *
+ * Defines an own `title` property on the instance (shadowing the
+ * prototype accessor) whose setter rewrites each write, then rewrites
+ * the current title once so the page's initial <title> from the served
+ * dist is covered too. Returns the disposer: it removes the own
+ * property (the prototype accessor takes over again) and rewrites the
+ * live value back to its official form, so an unload leaves the shell
+ * exactly as it was found.
+ */
+export declare function installTitleShadow(target: Document): TitleShadowDisposer;
+//# sourceMappingURL=title-shadow.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@huaweidevtools/aishell-dsh-brand",
   "description": "AI Shell brand reskin for DSH web — replaces sidebar and hero brand marks with AI Shell SVG",
-  "version": "0.0.1-beta.0",
+  "version": "0.0.1-beta.2",
   "publishConfig": {
     "access": "public"
   },
@@ -44,10 +44,10 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.2.0-0 <0.3.0-0",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.2.0-0 <0.3.0-0",
+    "@deepseek-ai/dsh-client-ui-sidebar": ">=0.2.0-0 <0.3.0-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.2.0-0 <0.3.0-0",
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
     "tsdown": "^0.10.0",