@yugoo-design/dsh-design-studio-dsh 0.1.0-beta.1 → 0.1.0-beta.3

package/README.md

@@ -11,4 +11,18 @@ explicit `kitSources` mode remains available with its strict startup validation.
 
 The Remote exposes exactly four read methods: `workspace`, `readKitWorkspace` (exact `name@version` pin required; a diverging response identity diagnoses), `readBundleWorkspace`, and `readBundleFile`. The catalog snapshot projects `ctx.design.listKits()`. Bundle source reads run through `ctx.fs`: the `kitSources` config lists installed content packages (`packageName`, resolved like the Design Core kit-loader) or absolute directories (`root`); every path resolves through the filesystem capability and must stay canonically contained in a configured root, so traversal and symlink escapes never read outside the authored trees and non-UTF-8 content diagnoses as binary. Invalid or ambiguous configuration — a missing root, a root without `mindset.md`, a relative path, a duplicate root, or one Kit/Bundle name declared by two roots — fails loud at startup. Without `kitSources` the catalog stays readable and Bundle reads diagnose `studio.source_not_configured`. Disposal rejects new work and drains admitted calls.
 
-The Settings surface presents the read-only Studio's scope and opens the plugin-owned same-origin route `/design-studio/` through a standard `rel="noopener noreferrer"` anchor. G/R/A loops publish independently and therefore expose no atomic-set size preference here. The route is registered through the public `webServer.register` seam (exact slash-less redirect plus prefix) and withdrawn on disposal. It serves one HTML shell and one self-contained page bundle. That bundle calls only the session-free `studioManagement` read methods through a narrow same-origin `/api` adapter; it does not start the DSH SPA module loader, client plugin runtime, connection registry, commands, or goals. The adapter validates the gateway response and the generated Typert result before rendering the unchanged shared `StudioWorkspace`. Page disposal only unmounts the rendered root. A future Codex or Claude Code companion server serves the same page bundle and implements the same JSON read methods rather than introducing another Studio format.
+Strict codecs follow the current Typert `create(): TypertSchema` factory contract.
+The existing Zod validators supply that parser capability; both Host registration
+and the same-origin page transport consume the same descriptor. Only the two
+optional Bundle-version parameters permit omitted wire fields; required fields,
+invalid types and strict result validation retain their original constraints.
+
+The Settings surface presents the read-only Studio's scope and opens the plugin-owned same-origin route `/design-studio/`. HTTP(S) Web uses a separate `target="_blank" rel="noopener noreferrer"` page and retains the conversation tab. On the official Desktop application's exact `dsh-app://app` authority, the launcher navigates in the current window: Desktop rejects new windows on its application protocol. The Desktop Studio page adds a compact **Back to conversation / 返回对话** link to the same-origin application root `/`, without changing the shared `StudioWorkspace`. It never consumes a `returnTo` parameter, referrer, private boot API, backend port, or copied credentials. The host owns conversation and Panel restoration when its application reloads; source and adapter tests do not establish that native round trip.
+
+G/R/A loops publish independently and therefore expose no atomic-set size preference here. The route is registered through the public `webServer.register` seam (exact slash-less redirect plus prefix) and withdrawn on disposal. It serves one HTML shell and one self-contained page bundle. That bundle calls only the session-free `studioManagement` read methods through a narrow same-origin `/api` adapter; on Desktop, requests remain on `dsh-app://app` even when the custom scheme reports an opaque (`null`) origin, using the host's existing protocol proxy. It does not start the DSH SPA module loader, client plugin runtime, connection registry, commands, or goals. The adapter validates the gateway response and the generated Typert result before rendering the unchanged shared `StudioWorkspace`. Page disposal only unmounts the rendered root. A future Codex or Claude Code companion server serves the same page bundle and implements the same JSON read methods rather than introducing another Studio format.
+
+The standalone page bundles its React runtime and fails the build on unresolved
+dependencies or remaining static/dynamic module imports. Its page-route test also
+checks the emitted JavaScript with the shared loader analyzer and exercises real
+bundler rejection cases. These checks establish browser module closure; rendered
+Host interaction remains a separate integration check.

package/lib/client-adapter.d.ts

@@ -1,4 +1,4 @@
-import { t as STUDIO_PAGE_BASE } from "./page-path-Nt6gFiV-.js";
+import { t as STUDIO_PAGE_BASE } from "./page-path-wn8e_fid.js";
 import { ReactElement } from "react";
 import { SettingsSectionOwnerProps } from "@deepseek-ai/dsh-client-ui-settings/client";
 import { StudioManagementClient } from "@yugoo-design/dsh-design-studio-ui";
@@ -38,15 +38,16 @@ interface DshStudioRemote {
 /** Build the shared client over DSH's generated Remote namespace. */
 declare function createDshStudioClient(remote: DshStudioRemote): StudioManagementClient;
 /**
- * Settings-shell launcher for the full-page Studio workspace. The link is a
- * standard noopener anchor, so it is always clickable and copyable, never
- * hands the host window to the Studio page, and needs no popup inference.
+ * Settings-shell launcher for the full-page Studio workspace. Web opens a
+ * separate noopener page; Desktop follows its existing same-window app route.
  * @param actions - Settings owner affordances.
  * @returns the launcher element.
  */
 declare function renderStudioLauncher(actions: {
   close(): void;
-}, zh?: boolean): ReactElement;
+}, zh?: boolean, locationHref?: string): ReactElement;
+/** Compact Desktop page navigation, independent of the shared Studio workspace. */
+declare function renderStudioReturnNavigation(zh?: boolean, locationHref?: string): ReactElement | null;
 /** Design Studio settings page with the launcher only. */
 declare function DshStudioSettingsSection(props: DshStudioSettingsSectionProps): ReactElement;
 /** Minimal slot face required to install the Studio Settings contribution. */
@@ -59,4 +60,4 @@ declare function registerDshStudioSettings(host: {
   readonly slots: DshStudioSlots;
 } & DshStudioSettingsRuntime): void;
 //#endregion
-export { DshRemoteResult, DshStudioRemote, DshStudioSettingsRuntime, DshStudioSettingsSection, DshStudioSlots, STUDIO_PAGE_BASE as STUDIO_PAGE_URL, createDshStudioClient, registerDshStudioSettings, renderStudioLauncher };
+export { DshRemoteResult, DshStudioRemote, DshStudioSettingsRuntime, DshStudioSettingsSection, DshStudioSlots, STUDIO_PAGE_BASE as STUDIO_PAGE_URL, createDshStudioClient, registerDshStudioSettings, renderStudioLauncher, renderStudioReturnNavigation };

package/lib/client-adapter.js

@@ -1,4 +1,4 @@
-import { STUDIO_PAGE_BASE } from "./page-path.js";
+import { STUDIO_PAGE_BASE, isDshDesktopLocation, studioConversationReturnPath } from "./page-path.js";
 import { useSyncExternalStore } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/client-adapter.tsx
@@ -50,13 +50,13 @@ function createDshStudioClient(remote) {
 	});
 }
 /**
-* Settings-shell launcher for the full-page Studio workspace. The link is a
-* standard noopener anchor, so it is always clickable and copyable, never
-* hands the host window to the Studio page, and needs no popup inference.
+* Settings-shell launcher for the full-page Studio workspace. Web opens a
+* separate noopener page; Desktop follows its existing same-window app route.
 * @param actions - Settings owner affordances.
 * @returns the launcher element.
 */
-function renderStudioLauncher(actions, zh = false) {
+function renderStudioLauncher(actions, zh = false, locationHref = globalThis.location?.href) {
+	const desktop = isDshDesktopLocation(locationHref);
 	return /* @__PURE__ */ jsxs("div", {
 		className: "ygd-studio-launcher",
 		style: cardStyle,
@@ -79,7 +79,7 @@ function renderStudioLauncher(actions, zh = false) {
 					...secondaryTextStyle,
 					margin: "6px 0 0"
 				},
-				children: zh ? "在独立页面中查看预制 Kit、Mindset、挂载的 Bundles 及其源文件。打开 Studio 不会中断当前对话。" : "Inspect shipped Kits, Mindsets, mounted Bundles, and their source files in a dedicated workspace. Opening Studio leaves this conversation untouched."
+				children: desktop ? zh ? "在当前窗口中查看预制 Kit、Mindset、挂载的 Bundles 及其源文件。查看后可点击「返回对话」。" : "Inspect shipped Kits, Mindsets, mounted Bundles, and their source files in this window. Use “Back to conversation” to return." : zh ? "在独立页面中查看预制 Kit、Mindset、挂载的 Bundles 及其源文件。打开 Studio 不会中断当前对话。" : "Inspect shipped Kits, Mindsets, mounted Bundles, and their source files in a dedicated workspace. Opening Studio leaves this conversation untouched."
 			})] }), /* @__PURE__ */ jsx("span", {
 				style: {
 					flex: "0 0 auto",
@@ -102,8 +102,8 @@ function renderStudioLauncher(actions, zh = false) {
 			children: [/* @__PURE__ */ jsx("a", {
 				className: "ygd-studio-launch-link",
 				href: STUDIO_PAGE_BASE,
-				target: "_blank",
-				rel: "noopener noreferrer",
+				target: desktop ? "_self" : "_blank",
+				rel: desktop ? void 0 : "noopener noreferrer",
 				onClick: () => actions.close(),
 				style: {
 					display: "inline-flex",
@@ -130,6 +130,43 @@ function renderStudioLauncher(actions, zh = false) {
 		})]
 	});
 }
+/** Compact Desktop page navigation, independent of the shared Studio workspace. */
+function renderStudioReturnNavigation(zh = false, locationHref = globalThis.location?.href) {
+	const returnPath = studioConversationReturnPath(locationHref);
+	if (returnPath === void 0) return null;
+	return /* @__PURE__ */ jsx("nav", {
+		"aria-label": zh ? "应用导航" : "Application navigation",
+		className: "ygd-studio-return-navigation",
+		style: {
+			display: "flex",
+			alignItems: "center",
+			flex: "0 0 auto",
+			padding: "8px 12px",
+			borderBottom: "1px solid var(--dsw-alias-border-l1, #E8E8E8)",
+			background: "var(--dsw-alias-bg-layer-1, #FFFFFF)",
+			fontFamily: "'PingFang SC', -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Microsoft YaHei', sans-serif"
+		},
+		children: /* @__PURE__ */ jsxs("a", {
+			href: returnPath,
+			target: "_self",
+			style: {
+				display: "inline-flex",
+				alignItems: "center",
+				gap: 6,
+				minHeight: 32,
+				padding: "0 8px",
+				borderRadius: 6,
+				color: "var(--dsw-alias-label-primary, #272727)",
+				fontSize: 13,
+				textDecoration: "none"
+			},
+			children: [/* @__PURE__ */ jsx("span", {
+				"aria-hidden": "true",
+				children: "←"
+			}), zh ? "返回对话" : "Back to conversation"]
+		})
+	});
+}
 /** Design Studio settings page with the launcher only. */
 function DshStudioSettingsSection(props) {
 	const zh = useSyncExternalStore((listener) => props.locale.subscribe(listener), () => props.locale.getSnapshot(), () => props.locale.getSnapshot()).active === "zh";
@@ -167,4 +204,4 @@ function registerDshStudioSettings(host) {
 	}, Section));
 }
 //#endregion
-export { DshStudioSettingsSection, STUDIO_PAGE_BASE as STUDIO_PAGE_URL, createDshStudioClient, registerDshStudioSettings, renderStudioLauncher };
+export { DshStudioSettingsSection, STUDIO_PAGE_BASE as STUDIO_PAGE_URL, createDshStudioClient, registerDshStudioSettings, renderStudioLauncher, renderStudioReturnNavigation };

package/lib/client.js

@@ -10,6 +10,16 @@ window.__ModuleLoader__.load({
 		/** Browser-safe path constants shared by the host route and the launcher. */
 		/** Base path owned by the Studio page route. */
 		const STUDIO_PAGE_BASE = "/design-studio/";
+		/** Recognize only the official Desktop application authority, not a redirect hint. */
+		function isDshDesktopLocation(href = globalThis.location?.href) {
+			if (href === void 0) return false;
+			try {
+				const url = new URL(href);
+				return url.protocol === "dsh-app:" && url.host === "app" && url.username === "" && url.password === "";
+			} catch {
+				return false;
+			}
+		}
 		//#endregion
 		//#region src/client-adapter.tsx
 		/** Shared DSH browser adapter values, independently testable from client boot. */
@@ -32,13 +42,13 @@ window.__ModuleLoader__.load({
 			lineHeight: 1.55
 		};
 		/**
-		* Settings-shell launcher for the full-page Studio workspace. The link is a
-		* standard noopener anchor, so it is always clickable and copyable, never
-		* hands the host window to the Studio page, and needs no popup inference.
+		* Settings-shell launcher for the full-page Studio workspace. Web opens a
+		* separate noopener page; Desktop follows its existing same-window app route.
 		* @param actions - Settings owner affordances.
 		* @returns the launcher element.
 		*/
-		function renderStudioLauncher(actions, zh = false) {
+		function renderStudioLauncher(actions, zh = false, locationHref = globalThis.location?.href) {
+			const desktop = isDshDesktopLocation(locationHref);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "ygd-studio-launcher",
 				style: cardStyle,
@@ -61,7 +71,7 @@ window.__ModuleLoader__.load({
 							...secondaryTextStyle,
 							margin: "6px 0 0"
 						},
-						children: zh ? "在独立页面中查看预制 Kit、Mindset、挂载的 Bundles 及其源文件。打开 Studio 不会中断当前对话。" : "Inspect shipped Kits, Mindsets, mounted Bundles, and their source files in a dedicated workspace. Opening Studio leaves this conversation untouched."
+						children: desktop ? zh ? "在当前窗口中查看预制 Kit、Mindset、挂载的 Bundles 及其源文件。查看后可点击「返回对话」。" : "Inspect shipped Kits, Mindsets, mounted Bundles, and their source files in this window. Use “Back to conversation” to return." : zh ? "在独立页面中查看预制 Kit、Mindset、挂载的 Bundles 及其源文件。打开 Studio 不会中断当前对话。" : "Inspect shipped Kits, Mindsets, mounted Bundles, and their source files in a dedicated workspace. Opening Studio leaves this conversation untouched."
 					})] }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 						style: {
 							flex: "0 0 auto",
@@ -84,8 +94,8 @@ window.__ModuleLoader__.load({
 					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
 						className: "ygd-studio-launch-link",
 						href: STUDIO_PAGE_BASE,
-						target: "_blank",
-						rel: "noopener noreferrer",
+						target: desktop ? "_self" : "_blank",
+						rel: desktop ? void 0 : "noopener noreferrer",
 						onClick: () => actions.close(),
 						style: {
 							display: "inline-flex",

package/lib/page-client.js

@@ -1,7 +1,7 @@
 //#region \0rolldown/runtime.js
 var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 //#endregion
-//#region ../../node_modules/.pnpm/react@18.3.1/node_modules/react/cjs/react.production.min.js
+//#region ../../../cx1-web-rc2-upgrade-20261014/node_modules/.pnpm/react@18.3.1/node_modules/react/cjs/react.production.min.js
 /**
 * @license React
 * react.production.min.js
@@ -343,12 +343,12 @@ var require_react_production_min = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.version = "18.3.1";
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/react@18.3.1/node_modules/react/index.js
+//#region ../../../cx1-web-rc2-upgrade-20261014/node_modules/.pnpm/react@18.3.1/node_modules/react/index.js
 var require_react = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = require_react_production_min();
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/scheduler@0.23.2/node_modules/scheduler/cjs/scheduler.production.min.js
+//#region ../../../cx1-web-rc2-upgrade-20261014/node_modules/.pnpm/scheduler@0.23.2/node_modules/scheduler/cjs/scheduler.production.min.js
 /**
 * @license React
 * scheduler.production.min.js
@@ -603,12 +603,12 @@ var require_scheduler_production_min = /* @__PURE__ */ __commonJSMin(((exports)
 	};
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/scheduler@0.23.2/node_modules/scheduler/index.js
+//#region ../../../cx1-web-rc2-upgrade-20261014/node_modules/.pnpm/scheduler@0.23.2/node_modules/scheduler/index.js
 var require_scheduler = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = require_scheduler_production_min();
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom.production.min.js
+//#region ../../../cx1-web-rc2-upgrade-20261014/node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom.production.min.js
 /**
 * @license React
 * react-dom.production.min.js
@@ -7465,7 +7465,7 @@ var require_react_dom_production_min = /* @__PURE__ */ __commonJSMin(((exports)
 	exports.version = "18.3.1-next-f1338f8080-20240426";
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/index.js
+//#region ../../../cx1-web-rc2-upgrade-20261014/node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/index.js
 var require_react_dom = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	function checkDCE() {
 		if (typeof __REACT_DEVTOOLS_GLOBAL_HOOK__ === "undefined" || typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE !== "function") return;
@@ -7479,14 +7479,14 @@ var require_react_dom = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = require_react_dom_production_min();
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/client.js
+//#region ../../../cx1-web-rc2-upgrade-20261014/node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/client.js
 var require_client = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var m = require_react_dom();
 	exports.createRoot = m.createRoot;
 	exports.hydrateRoot = m.hydrateRoot;
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/react@18.3.1/node_modules/react/cjs/react-jsx-runtime.production.min.js
+//#region ../../../cx1-web-rc2-upgrade-20261014/node_modules/.pnpm/react@18.3.1/node_modules/react/cjs/react-jsx-runtime.production.min.js
 /**
 * @license React
 * react-jsx-runtime.production.min.js
@@ -7529,7 +7529,7 @@ var require_react_jsx_runtime_production_min = /* @__PURE__ */ __commonJSMin(((e
 	exports.jsxs = q;
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/react@18.3.1/node_modules/react/jsx-runtime.js
+//#region ../../../cx1-web-rc2-upgrade-20261014/node_modules/.pnpm/react@18.3.1/node_modules/react/jsx-runtime.js
 var require_jsx_runtime = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = require_react_jsx_runtime_production_min();
 }));
@@ -8582,6 +8582,9 @@ const STUDIO_WORKSPACE_CSS = `
 /* Responsive */
 /* Demo geometry, Yugoo brand tokens: one hero, one document toolbar, one body. */
 .ygd-studio-content-header .ygd-studio-btn-primary,.ygd-studio-content-header .ygd-studio-btn-link{margin:0}
+.ygd-studio-content-header .ygd-studio-catalog-link{display:inline-flex;align-items:center;gap:6px;min-height:32px;max-width:100%;margin:0 0 0 auto;color:var(--ds-primary-dark);text-decoration:none;overflow-wrap:anywhere}
+.ygd-studio-catalog-link svg{flex-shrink:0}
+.ygd-studio-catalog-link:focus-visible{outline:2px solid var(--ds-primary);outline-offset:2px}
 .ygd-studio-sidebar-nav{padding:0}
 .ygd-studio-sidebar-item{display:flex;align-items:center;gap:10px}
 .ygd-studio-sidebar-item .ygd-studio-kitmark{width:18px;height:18px;background:none;color:inherit;border-radius:0}
@@ -11830,6 +11833,7 @@ function ContentArchiveWorkbench({ client, installedKit, locale, canAdoptKit, on
 /** Reusable host-neutral React workspace for the read-only Kit-first Studio surface. */
 const KIT_TABS = ["mindset", "mounts"];
 const TABPANEL_ID = "ygd-studio-kit-tabpanel";
+const OFFICIAL_KITS_URL = "https://github.com/alibaba-damo-academy/yugoo-design/blob/main/docs/wiki/kit-sharing.md#official-kits";
 const displayName = (name) => name.replace(/[_-]+/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
 function InlineMindset(props) {
 	const [initialId] = (0, import_react.useState)(props.initialId);
@@ -11849,6 +11853,8 @@ const STRINGS = {
 		kitsTitle: "Kits",
 		kitsContext: "Studio 1.0 · Kits",
 		kitsSubtitle: "Manage domain methods and mounted Bundles.",
+		browseOfficialKits: "Browse official kits",
+		officialKitsHelp: "Browse official kits: descriptions and acquisition guidance (opens in a new tab)",
 		bundlesTitle: "Bundles",
 		bundlesContext: "Studio 1.0 · Bundles",
 		bundlesSubtitle: "Installed Bundles, read-only inspection",
@@ -11899,6 +11905,8 @@ const STRINGS = {
 		kitsTitle: "设计套件",
 		kitsContext: "Studio 1.0 · 设计套件",
 		kitsSubtitle: "管理领域方法与技能包挂载。",
+		browseOfficialKits: "浏览官方设计套件",
+		officialKitsHelp: "浏览官方设计套件：简介和获取指引（在新标签页打开）",
 		bundlesTitle: "技能包",
 		bundlesContext: "Studio 1.0 · 技能包",
 		bundlesSubtitle: "只读查看已安装技能包",
@@ -12910,16 +12918,37 @@ function StudioWorkspace({ client, controller: supplied, authoring, kitAuthoring
 		className: "ygd-studio-main",
 		children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("header", {
 			className: "ygd-studio-content-header",
-			children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
-				className: "ygd-studio-header-title-group",
-				children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h1", {
-					className: "ygd-studio-page-title",
-					children: t.kitsTitle
+			children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+				/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+					className: "ygd-studio-header-title-group",
+					children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h1", {
+						className: "ygd-studio-page-title",
+						children: t.kitsTitle
+					})
+				}),
+				/* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", {
+					className: "ygd-studio-subtitle",
+					children: t.kitsSubtitle
+				}),
+				/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("a", {
+					className: "ygd-studio-btn-link ygd-studio-catalog-link",
+					href: OFFICIAL_KITS_URL,
+					target: "_blank",
+					rel: "noopener noreferrer",
+					title: t.officialKitsHelp,
+					"aria-label": t.officialKitsHelp,
+					children: [t.browseOfficialKits, /* @__PURE__ */ (0, import_jsx_runtime.jsx)("svg", {
+						width: "14",
+						height: "14",
+						viewBox: "0 0 24 24",
+						fill: "none",
+						stroke: "currentColor",
+						strokeWidth: "1.7",
+						"aria-hidden": "true",
+						children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "M14 3h7v7M10 14 21 3M21 14v6a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h6" })
+					})]
 				})
-			}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", {
-				className: "ygd-studio-subtitle",
-				children: t.kitsSubtitle
-			})] })
+			] })
 		}), /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
 			className: "ygd-studio-content-body",
 			children: [
@@ -13454,6 +13483,22 @@ function StudioWorkspace({ client, controller: supplied, authoring, kitAuthoring
 		]
 	});
 }
+/** Recognize only the official Desktop application authority, not a redirect hint. */
+function isDshDesktopLocation(href = globalThis.location?.href) {
+	if (href === void 0) return false;
+	try {
+		const url = new URL(href);
+		return url.protocol === "dsh-app:" && url.host === "app" && url.username === "" && url.password === "";
+	} catch {
+		return false;
+	}
+}
+/** Desktop returns through the known application root; no caller-controlled redirect. */
+function studioConversationReturnPath(href = globalThis.location?.href) {
+	if (!isDshDesktopLocation(href)) return void 0;
+	const { pathname } = new URL(href);
+	return pathname === "/design-studio/" || pathname === "/design-studio" ? "/" : void 0;
+}
 //#endregion
 //#region src/client-adapter.tsx
 /** Shared DSH browser adapter values, independently testable from client boot. */
@@ -13485,8 +13530,45 @@ function createDshStudioClient(remote) {
 		readBundleFile: (input) => unwrap("readBundleFile", remote.readBundleFile(input.name, input.path, input.version))
 	});
 }
+/** Compact Desktop page navigation, independent of the shared Studio workspace. */
+function renderStudioReturnNavigation(zh = false, locationHref = globalThis.location?.href) {
+	const returnPath = studioConversationReturnPath(locationHref);
+	if (returnPath === void 0) return null;
+	return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("nav", {
+		"aria-label": zh ? "应用导航" : "Application navigation",
+		className: "ygd-studio-return-navigation",
+		style: {
+			display: "flex",
+			alignItems: "center",
+			flex: "0 0 auto",
+			padding: "8px 12px",
+			borderBottom: "1px solid var(--dsw-alias-border-l1, #E8E8E8)",
+			background: "var(--dsw-alias-bg-layer-1, #FFFFFF)",
+			fontFamily: "'PingFang SC', -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Microsoft YaHei', sans-serif"
+		},
+		children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("a", {
+			href: returnPath,
+			target: "_self",
+			style: {
+				display: "inline-flex",
+				alignItems: "center",
+				gap: 6,
+				minHeight: 32,
+				padding: "0 8px",
+				borderRadius: 6,
+				color: "var(--dsw-alias-label-primary, #272727)",
+				fontSize: 13,
+				textDecoration: "none"
+			},
+			children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+				"aria-hidden": "true",
+				children: "←"
+			}), zh ? "返回对话" : "Back to conversation"]
+		})
+	});
+}
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/core.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/core.js
 var _a$1;
 function $constructor(name, initializer, params) {
 	function init(inst, def) {
@@ -13545,7 +13627,7 @@ function config(newConfig) {
 	return globalConfig;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/util.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/util.js
 function getEnumValues(entries) {
 	const numericValues = Object.values(entries).filter((v) => typeof v === "number");
 	return Object.entries(entries).filter(([k, _]) => numericValues.indexOf(+k) === -1).map(([_, v]) => v);
@@ -13859,7 +13941,7 @@ function issue(...args) {
 	return { ...iss };
 }
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/errors.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/errors.js
 const initializer$1 = (inst, def) => {
 	inst.name = "$ZodError";
 	Object.defineProperty(inst, "_zod", {
@@ -13919,7 +14001,7 @@ function formatError(error, mapper = (issue) => issue.message) {
 	return fieldErrors;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/parse.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/parse.js
 const _parse = (_Err) => (schema, value, _ctx, _params) => {
 	const ctx = _ctx ? {
 		..._ctx,
@@ -14033,7 +14115,7 @@ const _safeDecodeAsync = (_Err) => async (schema, value, _ctx) => {
 	return _safeParseAsync(_Err)(schema, value, _ctx);
 };
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/regexes.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/regexes.js
 /**
 * @deprecated CUID v1 is deprecated by its authors due to information leakage
 * (timestamps embedded in the id). Use {@link cuid2} instead.
@@ -14097,7 +14179,7 @@ const boolean$1 = /^(?:true|false)$/i;
 const lowercase = /^[^A-Z]*$/;
 const uppercase = /^[^a-z]*$/;
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/checks.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/checks.js
 const $ZodCheck = /*@__PURE__*/ $constructor("$ZodCheck", (inst, def) => {
 	var _a;
 	inst._zod ?? (inst._zod = {});
@@ -14459,7 +14541,7 @@ const $ZodCheckOverwrite = /*@__PURE__*/ $constructor("$ZodCheckOverwrite", (ins
 	};
 });
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/doc.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/doc.js
 var Doc = class {
 	constructor(args = []) {
 		this.content = [];
@@ -14490,14 +14572,14 @@ var Doc = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/versions.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/versions.js
 const version = {
 	major: 4,
 	minor: 4,
 	patch: 3
 };
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/schemas.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/schemas.js
 const $ZodType = /*@__PURE__*/ $constructor("$ZodType", (inst, def) => {
 	var _a;
 	inst ?? (inst = {});
@@ -15727,7 +15809,7 @@ function handleRefineResult(result, payload, input, inst) {
 	}
 }
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/registries.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/registries.js
 var _a;
 var $ZodRegistry = class {
 	constructor() {
@@ -15774,7 +15856,7 @@ function registry() {
 (_a = globalThis).__zod_globalRegistry ?? (_a.__zod_globalRegistry = registry());
 const globalRegistry = globalThis.__zod_globalRegistry;
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/api.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/api.js
 // @__NO_SIDE_EFFECTS__
 function _string(Class, params) {
 	return new Class({
@@ -16279,7 +16361,7 @@ function _check(fn, params) {
 	return ch;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/to-json-schema.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/to-json-schema.js
 function initializeContext(params) {
 	let target = params?.target ?? "draft-2020-12";
 	if (target === "draft-4") target = "draft-04";
@@ -16574,7 +16656,7 @@ const createStandardJSONSchemaMethod = (schema, io, processors = {}) => (params)
 	return finalize(ctx, schema);
 };
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/json-schema-processors.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/json-schema-processors.js
 const formatMap = {
 	guid: "uuid",
 	url: "uri",
@@ -16839,7 +16921,7 @@ const optionalProcessor = (schema, ctx, _json, params) => {
 	seen.ref = def.innerType;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/iso.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/iso.js
 const ZodISODateTime = /*@__PURE__*/ $constructor("ZodISODateTime", (inst, def) => {
 	$ZodISODateTime.init(inst, def);
 	ZodStringFormat.init(inst, def);
@@ -16869,7 +16951,7 @@ function duration(params) {
 	return /* @__PURE__ */ _isoDuration(ZodISODuration, params);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/errors.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/errors.js
 const initializer = (inst, issues) => {
 	$ZodError.init(inst, issues);
 	inst.name = "ZodError";
@@ -16891,7 +16973,7 @@ const initializer = (inst, issues) => {
 };
 const ZodRealError = /*@__PURE__*/ $constructor("ZodError", initializer, { Parent: Error });
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/parse.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/parse.js
 const parse = /* @__PURE__ */ _parse(ZodRealError);
 const parseAsync = /* @__PURE__ */ _parseAsync(ZodRealError);
 const safeParse = /* @__PURE__ */ _safeParse(ZodRealError);
@@ -16905,7 +16987,7 @@ const safeDecode = /* @__PURE__ */ _safeDecode(ZodRealError);
 const safeEncodeAsync = /* @__PURE__ */ _safeEncodeAsync(ZodRealError);
 const safeDecodeAsync = /* @__PURE__ */ _safeDecodeAsync(ZodRealError);
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/schemas.js
+//#region ../../../cx3-git-library-20261016/node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/schemas.js
 const _installedGroups = /* @__PURE__ */ new WeakMap();
 function _installLazyMethods(inst, group, methods) {
 	const proto = Object.getPrototypeOf(inst);
@@ -17711,12 +17793,20 @@ const diagnostic = object({
 	message: string(),
 	subject: string().optional()
 }).strict();
+const relationText = object({
+	zh: string(),
+	en: string()
+}).strict();
 const kitView = object({
 	name: string(),
-	version: string()
+	version: string(),
+	description: string().optional(),
+	displayDescription: relationText.optional()
 }).strict();
 const bundleView = pin.extend({
 	description: string(),
+	title: relationText.optional(),
+	displayDescription: relationText.optional(),
 	usedBy: array(kitView)
 }).strict();
 const workspace = object({
@@ -17726,16 +17816,14 @@ const workspace = object({
 }).strict();
 const mountView = pin.extend({
 	description: string(),
+	title: relationText.optional(),
+	displayDescription: relationText.optional(),
 	mountedBy: array(kitView)
 }).strict();
 const resourceView = object({
 	path: string(),
 	bytes: number().int().nonnegative()
 }).strict();
-const relationText = object({
-	zh: string(),
-	en: string()
-}).strict();
 const relationView = object({
 	type: string(),
 	meaning: string(),
@@ -17766,6 +17854,7 @@ const kitWorkspaceResult = object({
 		name: string(),
 		version: string(),
 		description: string(),
+		displayDescription: relationText.optional(),
 		mindsetSource: string(),
 		mounts: array(mountView),
 		resources: array(resourceView),
@@ -17791,6 +17880,7 @@ const bundleWorkspaceResult = object({
 		version: string(),
 		kit: string().optional(),
 		description: string(),
+		displayDescription: relationText.optional(),
 		files: array(bundleFileRef),
 		manifest: record(string(), unknown()).optional(),
 		schema: record(string(), unknown()).optional(),
@@ -17807,20 +17897,21 @@ const bundleFileResult = object({
 	diagnostics: array(diagnostic)
 }).strict();
 const direct = { kind: "direct" };
-const json = (name, schema) => ({
+const json = (name, schema, acceptsUndefined = false) => ({
 	name,
 	wire: name,
 	source: "json",
+	...acceptsUndefined ? { acceptsUndefined: true } : {},
 	codec: {
 		mode: "strict",
 		typeSymbol: `dsh-design-studio-dsh#${name}`,
-		schema
+		create: () => schema
 	}
 });
 const result = (name, schema) => ({
 	mode: "strict",
 	typeSymbol: `dsh-design-studio-dsh#${name}`,
-	schema
+	create: () => schema
 });
 /** The `studioManagement` namespace contribution mounted by the browser adapter. */
 const TYPERT_REMOTE = {
@@ -17850,7 +17941,7 @@ const TYPERT_REMOTE = {
 			namespace: "studioManagement",
 			method: "readBundleWorkspace",
 			invocation: direct,
-			parameters: [json("name", string()), json("version", string().optional())],
+			parameters: [json("name", string()), json("version", string().optional(), true)],
 			result: result("readBundleWorkspaceResult", bundleWorkspaceResult)
 		},
 		{
@@ -17862,7 +17953,7 @@ const TYPERT_REMOTE = {
 			parameters: [
 				json("name", string()),
 				json("path", string()),
-				json("version", string().optional())
+				json("version", string().optional(), true)
 			],
 			result: result("readBundleFileResult", bundleFileResult)
 		}
@@ -17891,6 +17982,7 @@ const serverResponseSchema = object({
 }).strict();
 function resolveBase() {
 	const location = globalThis.location;
+	if (isDshDesktopLocation(location?.href)) return "dsh-app://app/";
 	return location?.origin !== void 0 && location.origin !== "null" ? location.origin : "http://dsh.internal";
 }
 /**
@@ -17930,7 +18022,7 @@ async function callStudioManagement(method, args, doFetch) {
 	};
 	return {
 		ok: true,
-		value: descriptor.result.schema.parse(envelope.result.value)
+		value: descriptor.result.create().parse(envelope.result.value)
 	};
 }
 /**
@@ -17960,13 +18052,35 @@ function createSameOriginStudioRemote(doFetch = (input, init) => globalThis.fetc
 //#endregion
 //#region src/page-client.tsx
 /** Standalone Design Studio page: thin same-origin RPC over the shared UI. */
+/** Only Desktop needs a return affordance; locale follows the shared UI's public props. */
+function DesktopStudioPage({ client }) {
+	const [locale, setLocale] = (0, import_react.useState)(() => (document.documentElement.lang || navigator.language || "zh").toLowerCase().startsWith("en") ? "en" : "zh");
+	return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+		style: {
+			display: "flex",
+			flexDirection: "column",
+			height: "100%"
+		},
+		children: [renderStudioReturnNavigation(locale === "zh"), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+			style: {
+				flex: "1 1 auto",
+				minHeight: 0
+			},
+			children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(StudioWorkspace, {
+				client,
+				locale,
+				onLocaleChange: setLocale
+			})
+		})]
+	});
+}
 /** Render the shared workspace over the host /api transport; no DSH client plugin boots. */
 function main() {
 	const container = document.getElementById("root");
 	if (container === null) throw new Error("design studio page: #root mount point is missing");
 	const client = createDshStudioClient(createSameOriginStudioRemote());
 	const root = (0, import_client.createRoot)(container);
-	root.render(/* @__PURE__ */ (0, import_jsx_runtime.jsx)(StudioWorkspace, { client }));
+	root.render(studioConversationReturnPath() === void 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(StudioWorkspace, { client }) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)(DesktopStudioPage, { client }));
 	window.addEventListener("pagehide", () => {
 		root.unmount();
 	}, { once: true });

package/lib/page-path-wn8e_fid.d.ts

@@ -0,0 +1,14 @@
+//#region src/page-path.d.ts
+/** Browser-safe path constants shared by the host route and the launcher. */
+/** Base path owned by the Studio page route. */
+declare const STUDIO_PAGE_BASE = "/design-studio/";
+/** Slash-less route that redirects to the base path. */
+declare const STUDIO_PAGE_PATH = "/design-studio";
+/** Bundle file name served below the base path. */
+declare const STUDIO_PAGE_BUNDLE = "page-client.js";
+/** Recognize only the official Desktop application authority, not a redirect hint. */
+declare function isDshDesktopLocation(href?: string | undefined): boolean;
+/** Desktop returns through the known application root; no caller-controlled redirect. */
+declare function studioConversationReturnPath(href?: string | undefined): '/' | undefined;
+//#endregion
+export { studioConversationReturnPath as a, isDshDesktopLocation as i, STUDIO_PAGE_BUNDLE as n, STUDIO_PAGE_PATH as r, STUDIO_PAGE_BASE as t };

package/lib/page-path.d.ts

@@ -1,2 +1,2 @@
-import { n as STUDIO_PAGE_BUNDLE, r as STUDIO_PAGE_PATH, t as STUDIO_PAGE_BASE } from "./page-path-Nt6gFiV-.js";
-export { STUDIO_PAGE_BASE, STUDIO_PAGE_BUNDLE, STUDIO_PAGE_PATH };
+import { a as studioConversationReturnPath, i as isDshDesktopLocation, n as STUDIO_PAGE_BUNDLE, r as STUDIO_PAGE_PATH, t as STUDIO_PAGE_BASE } from "./page-path-wn8e_fid.js";
+export { STUDIO_PAGE_BASE, STUDIO_PAGE_BUNDLE, STUDIO_PAGE_PATH, isDshDesktopLocation, studioConversationReturnPath };

package/lib/page-path.js

@@ -6,5 +6,21 @@ const STUDIO_PAGE_BASE = "/design-studio/";
 const STUDIO_PAGE_PATH = "/design-studio";
 /** Bundle file name served below the base path. */
 const STUDIO_PAGE_BUNDLE = "page-client.js";
+/** Recognize only the official Desktop application authority, not a redirect hint. */
+function isDshDesktopLocation(href = globalThis.location?.href) {
+	if (href === void 0) return false;
+	try {
+		const url = new URL(href);
+		return url.protocol === "dsh-app:" && url.host === "app" && url.username === "" && url.password === "";
+	} catch {
+		return false;
+	}
+}
+/** Desktop returns through the known application root; no caller-controlled redirect. */
+function studioConversationReturnPath(href = globalThis.location?.href) {
+	if (!isDshDesktopLocation(href)) return void 0;
+	const { pathname } = new URL(href);
+	return pathname === "/design-studio/" || pathname === "/design-studio" ? "/" : void 0;
+}
 //#endregion
-export { STUDIO_PAGE_BASE, STUDIO_PAGE_BUNDLE, STUDIO_PAGE_PATH };
+export { STUDIO_PAGE_BASE, STUDIO_PAGE_BUNDLE, STUDIO_PAGE_PATH, isDshDesktopLocation, studioConversationReturnPath };

package/lib/page-rpc.js

@@ -1,3 +1,4 @@
+import { isDshDesktopLocation } from "./page-path.js";
 import { TYPERT_REMOTE } from "./typert.remote-client.js";
 import { z } from "zod";
 //#region src/page-rpc.ts
@@ -22,6 +23,7 @@ const serverResponseSchema = z.object({
 }).strict();
 function resolveBase() {
 	const location = globalThis.location;
+	if (isDshDesktopLocation(location?.href)) return "dsh-app://app/";
 	return location?.origin !== void 0 && location.origin !== "null" ? location.origin : "http://dsh.internal";
 }
 /**
@@ -61,7 +63,7 @@ async function callStudioManagement(method, args, doFetch) {
 	};
 	return {
 		ok: true,
-		value: descriptor.result.schema.parse(envelope.result.value)
+		value: descriptor.result.create().parse(envelope.result.value)
 	};
 }
 /**

package/lib/page.d.ts

@@ -1,4 +1,4 @@
-import { r as STUDIO_PAGE_PATH, t as STUDIO_PAGE_BASE } from "./page-path-Nt6gFiV-.js";
+import { r as STUDIO_PAGE_PATH, t as STUDIO_PAGE_BASE } from "./page-path-wn8e_fid.js";
 //#region src/page.d.ts
 /** Minimal WebServer surface consumed by this plugin. */
 interface StudioPageWebServer {

package/lib/typert.remote-client.d.ts

@@ -1,5 +1,13 @@
 //#region src/typert.remote-client.d.ts
-/** Runtime descriptor fields consumed opaquely by DSH's Remote registry. */
+/** Strict factory contract; the Host requires a parser, not a validator library. */
+interface StudioStrictCodec {
+  readonly mode: 'strict';
+  readonly typeSymbol: string;
+  readonly create: () => {
+    parse(value: unknown): unknown;
+  };
+}
+/** Runtime descriptor fields consumed by DSH's Remote registry and page transport. */
 interface StudioRemoteDescriptor {
   readonly id: string;
   readonly service: string;
@@ -9,8 +17,14 @@ interface StudioRemoteDescriptor {
     readonly kind: 'direct';
   };
   readonly scope?: never;
-  readonly parameters: readonly unknown[];
-  readonly result: unknown;
+  readonly parameters: readonly {
+    readonly name: string;
+    readonly wire: string;
+    readonly source: 'json';
+    readonly acceptsUndefined?: true;
+    readonly codec: StudioStrictCodec;
+  }[];
+  readonly result: StudioStrictCodec;
 }
 /** Browser/Host contribution without leaking the validator library's types. */
 interface StudioRemoteContribution {
@@ -20,4 +34,4 @@ interface StudioRemoteContribution {
 /** The `studioManagement` namespace contribution mounted by the browser adapter. */
 declare const TYPERT_REMOTE: StudioRemoteContribution;
 //#endregion
-export { StudioRemoteContribution, StudioRemoteDescriptor, TYPERT_REMOTE, TYPERT_REMOTE as default };
+export { StudioRemoteContribution, StudioRemoteDescriptor, StudioStrictCodec, TYPERT_REMOTE, TYPERT_REMOTE as default };

package/lib/typert.remote-client.js

@@ -10,12 +10,20 @@ const diagnostic = z.object({
 	message: z.string(),
 	subject: z.string().optional()
 }).strict();
+const relationText = z.object({
+	zh: z.string(),
+	en: z.string()
+}).strict();
 const kitView = z.object({
 	name: z.string(),
-	version: z.string()
+	version: z.string(),
+	description: z.string().optional(),
+	displayDescription: relationText.optional()
 }).strict();
 const bundleView = pin.extend({
 	description: z.string(),
+	title: relationText.optional(),
+	displayDescription: relationText.optional(),
 	usedBy: z.array(kitView)
 }).strict();
 const workspace = z.object({
@@ -25,16 +33,14 @@ const workspace = z.object({
 }).strict();
 const mountView = pin.extend({
 	description: z.string(),
+	title: relationText.optional(),
+	displayDescription: relationText.optional(),
 	mountedBy: z.array(kitView)
 }).strict();
 const resourceView = z.object({
 	path: z.string(),
 	bytes: z.number().int().nonnegative()
 }).strict();
-const relationText = z.object({
-	zh: z.string(),
-	en: z.string()
-}).strict();
 const relationView = z.object({
 	type: z.string(),
 	meaning: z.string(),
@@ -64,6 +70,7 @@ const kitWorkspaceView = z.object({
 	name: z.string(),
 	version: z.string(),
 	description: z.string(),
+	displayDescription: relationText.optional(),
 	mindsetSource: z.string(),
 	mounts: z.array(mountView),
 	resources: z.array(resourceView),
@@ -90,6 +97,7 @@ const bundleWorkspaceView = z.object({
 	version: z.string(),
 	kit: z.string().optional(),
 	description: z.string(),
+	displayDescription: relationText.optional(),
 	files: z.array(bundleFileRef),
 	manifest: z.record(z.string(), z.unknown()).optional(),
 	schema: z.record(z.string(), z.unknown()).optional(),
@@ -109,20 +117,21 @@ const bundleFileResult = z.object({
 	diagnostics: z.array(diagnostic)
 }).strict();
 const direct = { kind: "direct" };
-const json = (name, schema) => ({
+const json = (name, schema, acceptsUndefined = false) => ({
 	name,
 	wire: name,
 	source: "json",
+	...acceptsUndefined ? { acceptsUndefined: true } : {},
 	codec: {
 		mode: "strict",
 		typeSymbol: `dsh-design-studio-dsh#${name}`,
-		schema
+		create: () => schema
 	}
 });
 const result = (name, schema) => ({
 	mode: "strict",
 	typeSymbol: `dsh-design-studio-dsh#${name}`,
-	schema
+	create: () => schema
 });
 /** The `studioManagement` namespace contribution mounted by the browser adapter. */
 const TYPERT_REMOTE = {
@@ -152,7 +161,7 @@ const TYPERT_REMOTE = {
 			namespace: "studioManagement",
 			method: "readBundleWorkspace",
 			invocation: direct,
-			parameters: [json("name", z.string()), json("version", z.string().optional())],
+			parameters: [json("name", z.string()), json("version", z.string().optional(), true)],
 			result: result("readBundleWorkspaceResult", bundleWorkspaceResult)
 		},
 		{
@@ -164,7 +173,7 @@ const TYPERT_REMOTE = {
 			parameters: [
 				json("name", z.string()),
 				json("path", z.string()),
-				json("version", z.string().optional())
+				json("version", z.string().optional(), true)
 			],
 			result: result("readBundleFileResult", bundleFileResult)
 		}

package/licenses/dsh-distribution.json

@@ -2,27 +2,27 @@
   "schemaVersion": 1,
   "package": "@yugoo-design/dsh-design-studio-dsh",
   "scope": "observed-current-dsh-output-and-selected-original-materials",
-  "sourceArchiveObserved": null,
+  "sourceArchiveObserved": "fdc620419b7827987500d6dc3ad8ae1504a5970942827868c7a823bc543822c7",
   "outputSha256": {
-    "lib/client-adapter.js": "87f090f76c404668cbe5811ac875a9585131cb0c0332f2ad75f0b194b5aadb36",
-    "lib/client.js": "1969fe0923e047b360447d78493c4e3759740fe5a5b4a4c5bedbe0f9c6115c3b",
+    "lib/client-adapter.js": "84c342631d8aefebad8a316a259c43f62ceb67c66c629b69b29c5c7fbff97836",
+    "lib/client.js": "d3e35a45aafee5140176c1e519c8210b0e5a0aee47fa8ceb654046b33478091b",
     "lib/index.js": "4f85243fed85ecefbc894bc14bf33d598afae7488489cc37c3a289df0774f23f",
-    "lib/page-client.js": "6f7a567968352d9037c109d35823b1140704ef2cf6a342badd331e96a0f29abf",
-    "lib/page-path.js": "731eb601ffd7bff9c47511ebd3b5b03fa44270919605164588511d6e6e49b44f",
-    "lib/page-rpc.js": "32f9e7e6736df2910bcb140878dec6ce9a977f9080028d21bb221d02b2f1ed97",
+    "lib/page-client.js": "c0d1407b10df0ebb18f550341dd413c22eee9e3224353f8cdb0dd932b4ae9242",
+    "lib/page-path.js": "30b04bda77901e33e2d627d525cb19c9f4c103798234f1adc153a34e3608ccd1",
+    "lib/page-rpc.js": "a2e0f435924148febbffa560a162545de6c29a2bfa455be3ca4c655052b06fc4",
     "lib/page.js": "c0fbd159525dba9223dcc147fa6b4a6ad7a7b59005950d63565346da1ee49939",
     "lib/typert.host.js": "ef9f99c997c98b9ce63ee4f2aaa2efba0bc6a609a5b6b51eccb578f2a5f3a715",
-    "lib/typert.remote-client.js": "2f2d11f64f1780a7083696f95d2b019db6c1e7950a120b0a9fc6edf78522bf37"
+    "lib/typert.remote-client.js": "881e503e2d9239408b852d9c5fa97a217b4aa3234176a26c771490e07c6f108d"
   },
   "normalBuildMaps": [
     {
       "output": "lib/client.js",
-      "mapSha256": "1db724db4faebfa3a87d4c3ec7ce38dc22a2bc5700baf7d3ac4a0ba3bdfe541a",
+      "mapSha256": "42c8cf2de38fc57b645af4ee6c87fbb79bc50e5f71c35ec0f174199765b85bfc",
       "sourceCount": 3,
-      "normalOutputSha256": "2b30aa64a6e40f4a6c2c7005161922f8c2f9f4442ae08170d0230dfe7037c4cf",
-      "packedOutputSha256": "1969fe0923e047b360447d78493c4e3759740fe5a5b4a4c5bedbe0f9c6115c3b",
+      "normalOutputSha256": "eb3f9c1f36fd3be55641a251d44041519ee99fa8d167776341eb3f28e49a9efb",
+      "packedOutputSha256": "d3e35a45aafee5140176c1e519c8210b0e5a0aee47fa8ceb654046b33478091b",
       "actualArchiveOutputBindingVerified": false,
-      "binding": "Current normal-build output projected by existing projectDistributionCode; archive output binding is pending actual pack verification."
+      "binding": "Fixed normal output adapted by existing projectDistributionCode and byte-verified against reviewed staging; no new archive has been packed or observed. Root must verify actual archive members separately."
     }
   ],
   "components": [
@@ -103,12 +103,15 @@
   },
   "externalPeers": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.1-rc.2 <0.2.0 || 0.1.2-rc.1 || 0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.5 <0.2.0 || 0.1.2-rc.1 || 0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.5 <0.2.0 || 0.1.2-rc.1 || 0.2.0-rc.2",
-    "@deepseek-ai/dsh-fs": ">=0.1.0-rc.5 <0.2.0 || 0.1.2-rc.1 || 0.2.0-rc.2",
-    "@deepseek-ai/dsh-host-webserver": ">=0.1.1-rc.2 <0.2.0 || 0.1.2-rc.1 || 0.2.0-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.0-rc.5 <0.2.0 || 0.1.2-rc.1 || 0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-fs": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.0-rc.2",
+    "@yugoo-design/dsh-design-core": "0.1.0-beta.3",
+    "@yugoo-design/dsh-design-studio": "0.1.0-beta.3",
+    "@yugoo-design/dsh-design-studio-ui": "0.1.0-beta.3",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
@@ -122,7 +125,8 @@
     "This component list is scoped to retained maps whose output was compared to actual adapted archive bytes, and emitted source-region IDs; no complete coverage claim for generated/unmapped code.",
     "External npm dependencies and peer host services are separate artifacts, even where other modules from that package are embedded.",
     "Shared Radix/upstream attribution records keep their original historical-source limitations.",
-    "Existing embedded/font/native source obligations and rendering checks remain distinct from delivery of original license text."
+    "Existing embedded/font/native source obligations and rendering checks remain distinct from delivery of original license text.",
+    "This refreshed observation covers the fixed 1b304cc staging only; no new archive, installed Desktop round trip, complete bundled inventory or license acceptance is inferred."
   ],
   "completeBundledInventoryVerified": false,
   "releaseLicenseAcceptance": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yugoo-design/dsh-design-studio-dsh",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.3",
   "license": "Apache-2.0",
   "type": "module",
   "description": "DSH lifecycle, Remote, source, and Settings adapter for the read-only Design Studio.",
@@ -46,15 +46,15 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.1-rc.2 <0.2.0 || 0.1.2-rc.1 || 0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.5 <0.2.0 || 0.1.2-rc.1 || 0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.5 <0.2.0 || 0.1.2-rc.1 || 0.2.0-rc.2",
-    "@deepseek-ai/dsh-fs": ">=0.1.0-rc.5 <0.2.0 || 0.1.2-rc.1 || 0.2.0-rc.2",
-    "@deepseek-ai/dsh-host-webserver": ">=0.1.1-rc.2 <0.2.0 || 0.1.2-rc.1 || 0.2.0-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.0-rc.5 <0.2.0 || 0.1.2-rc.1 || 0.2.0-rc.2",
-    "@yugoo-design/dsh-design-core": "0.1.0-beta.1",
-    "@yugoo-design/dsh-design-studio": "0.1.0-beta.1",
-    "@yugoo-design/dsh-design-studio-ui": "0.1.0-beta.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-fs": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.0-rc.2",
+    "@yugoo-design/dsh-design-core": "0.1.0-beta.3",
+    "@yugoo-design/dsh-design-studio": "0.1.0-beta.3",
+    "@yugoo-design/dsh-design-studio-ui": "0.1.0-beta.3",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },

package/lib/page-path-Nt6gFiV-.d.ts

@@ -1,10 +0,0 @@
-//#region src/page-path.d.ts
-/** Browser-safe path constants shared by the host route and the launcher. */
-/** Base path owned by the Studio page route. */
-declare const STUDIO_PAGE_BASE = "/design-studio/";
-/** Slash-less route that redirects to the base path. */
-declare const STUDIO_PAGE_PATH = "/design-studio";
-/** Bundle file name served below the base path. */
-declare const STUDIO_PAGE_BUNDLE = "page-client.js";
-//#endregion
-export { STUDIO_PAGE_BUNDLE as n, STUDIO_PAGE_PATH as r, STUDIO_PAGE_BASE as t };