@deepseek-ai/dsh-client-ui-settings-general 0.0.1-rc.1 → 0.0.1-rc.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/ui-settings-general/README.md
-README.md: ab27e073dc76335efc619f56365d1705007f7ef2
-README.zh.md: 16ff5604bee5425569b783e27a29699344f630e3
+README.md: 0cdffdfaad20784535a7ed010ad4b71d63a0a2c1
+README.zh.md: 0b72b3db96b335f0c288758b3f7a8b56441ee88c

package/README.md

@@ -2,11 +2,13 @@
 
 English | [中文](README.zh.md)
 
-Settings ownerless-copy and product-onboarding plugin: registers everything on the Settings surface that belongs to no single feature — the shell's trigger/header/close chrome content, the local configuration-file action, the General section and its `settings.general.item` slot, the `settings` dictionaries, and the first ordered welcome step. Feature-owned rows (Permission, Language, Appearance), sections (Models), and conditional onboarding steps stay with their feature packages.
+Settings shell, ownerless-copy, and product-onboarding plugin. It occupies `sidebar.settings` with the trigger chrome and modal settings panel, projects the `settings.section` ledger into the navigation and the `settings.onboarding` ledger into one mounted page at a time, and registers everything on the Settings pages that belongs to no single feature — the trigger/header/close chrome content, the local configuration-file action, the General section and its `settings.general.item` slot, the `settings` dictionaries, and the first ordered welcome step. The slot types it renders into belong to ui-settings, the settings domain base; only the shell's own contract types live here, because they reference ui-sidebar's slot type and the base layer must depend on no `ui-*` package. Feature-owned rows (Permission, Language, Appearance), sections (Models), and conditional onboarding steps stay with their feature packages.
+
+The shell ships no copy of its own — all text arrives from registrants. Nav labels may be locale-following thunks, so the nav projection resolves them through `resolveSlotLabel` and re-renders on the section ledger bump or the locale revision (an optional `ctx.get('locale')` read; no hard locale dependency). The onboarding ledger projects in ascending order and mounts exactly one page at a time; the takeover chrome (body-level stage, mask, app-root `inert`) belongs to the step itself through ui-primitives' `OnboardingSurface`, so a mounted step still resolving its private facts renders null and neither paints nor blocks anything — the shell shows no empty stage while a step decides. The active registrant receives its id, `complete()`, and an `openSection(id)` callback; completing or skipping transfers ownership to the next entry. Registrants own durable completion, capability readiness, copy, mutations, and the surface wrap, so independently registered flows cannot stack and the shell does not become a second configuration fact source.
 
 A loopback browser loads the provider's `hasDocument` capability through `settings.describe` and renders **Open configuration file** only when the Host confirms that a provider-owned local document can be prepared. The action sends the pathless, loopback-only `settings.openDocument` request; the Host resolves the provider path again, materializes an absent document, and hands it to a native text editor (`open -t` on macOS, bypassing a browser file association; the desktop file association on Linux and Windows; Windows association after `wslpath -w` translation on WSL). Open failures keep the action available and render a localized error. Reopening the dialog or reconnecting refreshes availability after a transient read failure or Host topology change. Remote browsers never register the action and never issue the privileged settings read.
 
-`src/onboarding-copy.ts` is the single editable owner of the complete notice plus `WELCOME_NOTICE_VERSION`; both supported GUI locales intentionally render the same Chinese copy. The Host half registers `ui-onboarding` in the user-settings seam. A loopback browser compares `welcomeNoticeVersion` for exact equality and writes the current value only after Continue succeeds. The path mutation is idempotent across tabs and preserves sibling settings, while `host/settings-changed` makes an externally acknowledged notice advance without a reload. A non-loopback browser cannot access the privileged settings API: it still presents the notice, but Continue advances only the current browser process and a reload presents the notice again. A different version deliberately presents the notice again. The welcome page preserves every authored paragraph, gives the requested clause in the final paragraph the sole emphasis, initially focuses the title, and has no close, Escape, mask-click, or secondary path. None of its copy or acknowledgement enters a Session log or model request. The notice identifies `DSH_TELEMETRY_DISABLED=1` as the telemetry opt-out.
+`src/onboarding-copy.ts` is the single editable owner of the complete notice plus `WELCOME_NOTICE_VERSION`; both supported GUI locales intentionally render the same Chinese copy. The Host half registers `ui-onboarding` in the user-settings seam. A loopback browser compares `welcomeNoticeVersion` for exact equality and writes the current value only after Continue succeeds. The path mutation is idempotent across tabs and preserves sibling settings, while the forwarded `settings/document-updated` event makes an externally acknowledged notice advance without a reload. A non-loopback browser cannot access the privileged settings API: it still presents the notice, but Continue advances only the current browser process and a reload presents the notice again. A different version deliberately presents the notice again. The welcome page preserves every authored paragraph, gives the requested clause in the final paragraph the sole emphasis, initially focuses the title, and has no close, Escape, mask-click, or secondary path. None of its copy or acknowledgement enters a Session log or model request. The notice identifies `DSH_TELEMETRY_DISABLED=1` as the telemetry opt-out.
 
 ## Model Experience
 

package/README.zh.md

@@ -2,11 +2,13 @@
 
 [English](README.md) | 中文
 
-设置界面无特定功能归属的文案与产品引导插件：在设置界面注册所有不属于单一功能的内容，包括外壳的触发器、标题栏与关闭控件内容、本地配置文件操作，「通用」分区及其 `settings.general.item` slot、`settings` 字典，以及第一个有序欢迎步骤。归具体功能所有的行（「权限」、「语言」、「外观」）、分区（「模型」）和条件式首次使用引导步骤仍由各自的功能包提供。
+设置外壳、无特定功能归属文案与产品引导插件。它以触发控件和模态设置面板占用 `sidebar.settings`，把 `settings.section` 账本投影成导航、把 `settings.onboarding` 账本投影成每次只挂载一页的引导流程，并在设置页面上注册所有不属于单一功能的内容：触发器、标题栏与关闭控件内容、本地配置文件操作，「通用」分区及其 `settings.general.item` slot、`settings` 字典，以及第一个有序欢迎步骤。它渲染进的那些 slot 类型归 ui-settings——设置领域底座——所有；只有外壳自身的契约类型放在这里，因为它们引用 ui-sidebar 的 slot 类型，而底座不得依赖任何 `ui-*` 包。归具体功能所有的行（「权限」、「语言」、「外观」）、分区（「模型」）和条件式首次使用引导步骤仍由各自的功能包提供。
+
+外壳不自带文案：所有文本都来自注册方。导航 label 可以是跟随语言的 thunk，因此导航投影经 `resolveSlotLabel` 解析，并在分区账本更新或 locale revision 变化时重新渲染（`ctx.get('locale')` 可选读取，无硬 locale 依赖）。首次使用引导记录按升序投影，每次只挂载一个页面；接管界面框架（body 层级的展示层、遮罩、应用根节点 `inert`）经 ui-primitives 的 `OnboardingSurface` 由步骤自身持有，因此已挂载但仍在判定私有事实的步骤渲染 null 时不绘制也不阻塞任何内容——步骤判定期间外壳不会露出空白展示层。当前注册方会收到该条目的 id、`complete()` 和 `openSection(id)` 回调；完成或跳过当前页面后，所有权转交给下一项。持久化完成状态、能力就绪状态、文案、变更操作以及展示层包装均由注册方持有，因此独立注册的流程无法堆叠，外壳也不会成为第二个配置事实来源。
 
 回环浏览器通过 `settings.describe` 加载提供方的 `hasDocument` 能力，且只有在 Host 确认可准备好一份由提供方持有的本地文档时才渲染**打开配置文件**。该操作发送无路径参数且仅限回环访问的 `settings.openDocument` 请求；Host 会再次解析提供方路径、在文档缺失时将其创建出来，并交给原生文本编辑器（macOS 上使用 `open -t`，绕过浏览器文件关联；Linux 和 Windows 上使用桌面文件关联；WSL 上经 `wslpath -w` 转换后使用 Windows 文件关联）。打开失败时该操作仍可使用，并渲染本地化错误。临时读取失败或 Host 拓扑变化后，重新打开对话框或重新连接会刷新可用性。远程浏览器从不注册该操作，也从不发起这项特权设置读取。
 
-`src/onboarding-copy.ts` 是完整通知文案和 `WELCOME_NOTICE_VERSION` 的唯一可编辑来源；GUI 支持的两种 locale 都有意渲染同一份中文文案。宿主端在用户设置 seam 中注册 `ui-onboarding`。回环浏览器会比较 `welcomeNoticeVersion` 是否精确相等，仅在「继续」操作成功后写入当前值。该路径变更在不同标签页间幂等，并会保留同级设置；`host/settings-changed` 则让页面在通知被外部确认后，无需重新加载即可推进。非回环浏览器不能访问受保护的设置 API：它仍会显示通知，但「继续」只推进当前浏览器进程，重新加载后会再次显示通知。版本不同时，系统也会有意重新显示通知。欢迎页保留原文的每个段落，仅强调最后一段中指定的句段，初始焦点落在标题上，并且没有关闭操作、Escape、点击遮罩或次要操作路径。其文案和确认状态均不会进入会话日志或模型请求。通知明确以 `DSH_TELEMETRY_DISABLED=1` 作为遥测关闭方式。
+`src/onboarding-copy.ts` 是完整通知文案和 `WELCOME_NOTICE_VERSION` 的唯一可编辑来源；GUI 支持的两种 locale 都有意渲染同一份中文文案。宿主端在用户设置 seam 中注册 `ui-onboarding`。回环浏览器会比较 `welcomeNoticeVersion` 是否精确相等，仅在「继续」操作成功后写入当前值。该路径变更在不同标签页间幂等，并会保留同级设置；转发的 `settings/document-updated` 事件则让页面在通知被外部确认后，无需重新加载即可推进。非回环浏览器不能访问受保护的设置 API：它仍会显示通知，但「继续」只推进当前浏览器进程，重新加载后会再次显示通知。版本不同时，系统也会有意重新显示通知。欢迎页保留原文的每个段落，仅强调最后一段中指定的句段，初始焦点落在标题上，并且没有关闭操作、Escape、点击遮罩或次要操作路径。其文案和确认状态均不会进入会话日志或模型请求。通知明确以 `DSH_TELEMETRY_DISABLED=1` 作为遥测关闭方式。
 
 ## 模型体验
 

package/lib/client.js

@@ -4,11 +4,231 @@ window.__ModuleLoader__.load({
 		var module = { exports: {} };
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let _deepseek_ai_dsh_client_ui_slots = require("@deepseek-ai/dsh-client-ui-slots");
 		let _deepseek_ai_dsh_client_web_react = require("@deepseek-ai/dsh-client-web-react");
 		let react_jsx_runtime = require("react/jsx-runtime");
-		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let react = require("react");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let _deepseek_ai_dsh_client_runtime_client = require("@deepseek-ai/dsh-client-runtime/client");
+		//#region ../../../node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
+		function r(e) {
+			var t, f, n = "";
+			if ("string" == typeof e || "number" == typeof e) n += e;
+			else if ("object" == typeof e) if (Array.isArray(e)) {
+				var o = e.length;
+				for (t = 0; t < o; t++) e[t] && (f = r(e[t])) && (n && (n += " "), n += f);
+			} else for (f in e) e[f] && (n && (n += " "), n += f);
+			return n;
+		}
+		function clsx() {
+			for (var e, t, f = 0, n = "", o = arguments.length; f < o; f++) (e = arguments[f]) && (t = r(e)) && (n && (n += " "), n += t);
+			return n;
+		}
+		//#endregion
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-settings-general/src/client/SettingsRoot.module.css.mjs
+		const css$4 = ".VOzbGW_trigger{cursor:pointer;width:100%;height:49px;color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:12px;flex:none;align-items:center;gap:8px;margin:8px 0 0;padding:0 2px 0 6px;font-family:inherit;font-size:14px;display:flex;overflow:hidden}.VOzbGW_trigger:hover{background:var(--dsw-alias-interactive-bg-hover)}.VOzbGW_trigger.VOzbGW_rail{border-radius:50%;justify-content:center;gap:0;width:36px;height:36px;margin:18px 0 10px;padding:0}.VOzbGW_triggerLabel{white-space:nowrap;overflow:hidden}.VOzbGW_overlay{z-index:1000;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.VOzbGW_mask{background:var(--dsw-alias-bg-mask-1);backdrop-filter:var(--dsw-mask-blur);position:absolute;inset:0}.VOzbGW_panel{z-index:1;background:var(--dsw-alias-bg-layer-2);width:800px;max-width:calc(100vw - 48px);height:min(800px,100vh - 48px);box-shadow:var(--dsw-shadow-lv3);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border-radius:24px;display:flex;position:relative;overflow:hidden}.VOzbGW_nav{box-sizing:border-box;flex-direction:column;flex:none;gap:18px;width:188px;padding:22px 12px 0;display:flex}.VOzbGW_navTitle{color:var(--dsw-alias-label-primary);padding:0 12px;font-size:16px;font-weight:500;line-height:24px}.VOzbGW_navList{flex-direction:column;gap:4px;display:flex}.VOzbGW_navCell{box-sizing:border-box;cursor:pointer;height:40px;color:var(--dsw-alias-label-primary);text-align:left;background:0 0;border:none;border-radius:12px;align-items:center;gap:8px;padding:9px 16px 9px 12px;font-family:inherit;font-size:14px;font-weight:400;line-height:22px;display:flex}.VOzbGW_navCell:hover{background:var(--dsw-specific-sidebar-nav-item-hover)}.VOzbGW_navCell.VOzbGW_active{background:var(--dsw-specific-sidebar-nav-item-active)}.VOzbGW_navIcon{flex:none}.VOzbGW_navLabel{white-space:nowrap;text-overflow:ellipsis;flex:1;min-width:0;overflow:hidden}.VOzbGW_content{flex-direction:column;flex:1;min-width:0;display:flex}.VOzbGW_header{box-sizing:border-box;flex:none;justify-content:space-between;align-items:flex-start;gap:8px;height:54px;padding:20px 14px 8px 10px;display:flex}.VOzbGW_actions{justify-content:flex-end;align-items:center;gap:8px;min-width:0;margin-left:auto;display:flex}.VOzbGW_close{cursor:pointer;width:28px;height:28px;color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:28px;justify-content:center;align-items:center;padding:0;display:inline-flex}.VOzbGW_close:hover{background:var(--dsw-alias-interactive-bg-hover)}.VOzbGW_options{flex:1;min-height:0;padding:0 24px 24px;overflow-y:auto}.VOzbGW_hiddenLabel{clip:rect(0 0 0 0);white-space:nowrap;width:1px;height:1px;position:absolute;overflow:hidden}";
+		const tagId$4 = "@deepseek-ai/dsh-client-ui-settings-general/SettingsRoot.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$4) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-settings-general";
+			tag.dataset.pluginCss = tagId$4;
+			tag.textContent = css$4;
+			document.head.appendChild(tag);
+		}
+		var SettingsRoot_module_css_default = {
+			"triggerLabel": "VOzbGW_triggerLabel",
+			"panel": "VOzbGW_panel",
+			"trigger": "VOzbGW_trigger",
+			"overlay": "VOzbGW_overlay",
+			"navTitle": "VOzbGW_navTitle",
+			"close": "VOzbGW_close",
+			"hiddenLabel": "VOzbGW_hiddenLabel",
+			"nav": "VOzbGW_nav",
+			"rail": "VOzbGW_rail",
+			"mask": "VOzbGW_mask",
+			"actions": "VOzbGW_actions",
+			"active": "VOzbGW_active",
+			"navList": "VOzbGW_navList",
+			"options": "VOzbGW_options",
+			"navIcon": "VOzbGW_navIcon",
+			"header": "VOzbGW_header",
+			"content": "VOzbGW_content",
+			"navCell": "VOzbGW_navCell",
+			"navLabel": "VOzbGW_navLabel"
+		};
+		//#endregion
+		//#region lib/types/client/SettingsRoot.js
+		/**
+		* Settings shell root: the sidebar-foot trigger row plus the centered modal
+		* panel (figma 501:29947, 1080x700) with the section nav rail. The shell is
+		* a pure composition face — every piece of text (trigger label, panel title,
+		* close label, sections) arrives from registrants through slots; accessible
+		* names resolve to that content (trigger: its own text; dialog:
+		* aria-labelledby the title node; close: visually-hidden slot text). Modal
+		* open state and the active section id are component-local viewing state;
+		* the onboarding coordinator mounts exactly one ordered registrant while the
+		* sessions-derived empty-Hero fact is active — the takeover chrome
+		* (OnboardingSurface) belongs to the step, so a mounted-but-deciding step
+		* paints nothing here.
+		*/
+		/** Nav glyph by section id; unknown ids fall back to the settings gear. */
+		function navIcon(id) {
+			if (id === "models") return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconDataOutline16, {
+				className: SettingsRoot_module_css_default.navIcon,
+				size: 16
+			});
+			if (id === "agent-presets") return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconAgentPresetOutline16, {
+				className: SettingsRoot_module_css_default.navIcon,
+				size: 16
+			});
+			if (id === "plugins") return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPersonalizationOutline16, {
+				className: SettingsRoot_module_css_default.navIcon,
+				size: 16
+			});
+			return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSettingsOutline16, {
+				className: SettingsRoot_module_css_default.navIcon,
+				size: 16
+			});
+		}
+		/**
+		* The modal layer: full-viewport mask + centered panel. Close paths: the
+		* header button, a mask click, and document-level Escape (mounted only while
+		* open, so the listener lifetime is the panel's).
+		*/
+		function SettingsPanel({ rows, renderSlot, activeId, onSelect, onClose }) {
+			const active = rows.find((r) => r.id === activeId)?.id ?? rows[0]?.id;
+			const titleId = (0, react.useId)();
+			(0, react.useEffect)(() => {
+				const onKeyDown = (e) => {
+					if (e.key === "Escape") onClose();
+				};
+				document.addEventListener("keydown", onKeyDown);
+				return () => {
+					document.removeEventListener("keydown", onKeyDown);
+				};
+			}, [onClose]);
+			const closeButton = (0, react.useRef)(null);
+			(0, react.useEffect)(() => {
+				closeButton.current?.focus();
+			}, []);
+			return (0, react_jsx_runtime.jsxs)("div", {
+				className: SettingsRoot_module_css_default.overlay,
+				role: "presentation",
+				children: [(0, react_jsx_runtime.jsx)("div", {
+					className: SettingsRoot_module_css_default.mask,
+					"aria-hidden": "true",
+					onClick: onClose
+				}), (0, react_jsx_runtime.jsxs)("div", {
+					className: SettingsRoot_module_css_default.panel,
+					role: "dialog",
+					"aria-modal": "true",
+					"aria-labelledby": titleId,
+					children: [(0, react_jsx_runtime.jsxs)("nav", {
+						className: SettingsRoot_module_css_default.nav,
+						children: [(0, react_jsx_runtime.jsx)("div", {
+							className: SettingsRoot_module_css_default.navTitle,
+							id: titleId,
+							children: renderSlot("settings.header", {})
+						}), (0, react_jsx_runtime.jsx)("div", {
+							className: SettingsRoot_module_css_default.navList,
+							children: rows.map((row) => (0, react_jsx_runtime.jsxs)("button", {
+								type: "button",
+								className: clsx(SettingsRoot_module_css_default.navCell, row.id === active && SettingsRoot_module_css_default.active),
+								"aria-current": row.id === active ? "true" : void 0,
+								onClick: () => {
+									onSelect(row.id);
+								},
+								children: [navIcon(row.id), (0, react_jsx_runtime.jsx)("span", {
+									className: SettingsRoot_module_css_default.navLabel,
+									children: row.label
+								})]
+							}, row.id))
+						})]
+					}), (0, react_jsx_runtime.jsxs)("div", {
+						className: SettingsRoot_module_css_default.content,
+						children: [(0, react_jsx_runtime.jsxs)("div", {
+							className: SettingsRoot_module_css_default.header,
+							children: [(0, react_jsx_runtime.jsx)("div", {
+								className: SettingsRoot_module_css_default.actions,
+								children: renderSlot("settings.action", {})
+							}), (0, react_jsx_runtime.jsxs)("button", {
+								ref: closeButton,
+								type: "button",
+								className: SettingsRoot_module_css_default.close,
+								onClick: onClose,
+								children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseOutline16, { size: 14 }), (0, react_jsx_runtime.jsx)("span", {
+									className: SettingsRoot_module_css_default.hiddenLabel,
+									children: renderSlot("settings.close", {})
+								})]
+							})]
+						}), (0, react_jsx_runtime.jsx)("div", {
+							className: SettingsRoot_module_css_default.options,
+							children: active !== void 0 && renderSlot("settings.section", { close: onClose }, { only: active })
+						})]
+					})]
+				})]
+			});
+		}
+		/**
+		* Render the settings trigger and panel.
+		* @param props - composed slot props (contract/slots.ts).
+		* @returns the settings shell element tree.
+		*/
+		function SettingsRoot(props) {
+			const { wide, useSections, useOnboardingSteps, useSessions, renderSlot } = props;
+			const [open, setOpen] = (0, react.useState)(false);
+			const [activeId, setActiveId] = (0, react.useState)(void 0);
+			const [completedOnboarding, setCompletedOnboarding] = (0, react.useState)(() => /* @__PURE__ */ new Set());
+			const close = (0, react.useCallback)(() => {
+				setOpen(false);
+				setActiveId(void 0);
+			}, []);
+			const openSection = (0, react.useCallback)((id) => {
+				setActiveId(id);
+				setOpen(true);
+			}, []);
+			const rows = useSections((s) => s);
+			const onboardingSteps = useOnboardingSteps((s) => s);
+			const onboardingActive = useSessions((state) => state.phase === "ready" && (state.current === void 0 || state.byId[state.current]?.blank === true));
+			const onboardingStep = onboardingActive ? onboardingSteps.find((step) => !completedOnboarding.has(step.id)) : void 0;
+			(0, react.useEffect)(() => {
+				if (onboardingActive) return;
+				setCompletedOnboarding(/* @__PURE__ */ new Set());
+			}, [onboardingActive]);
+			const completeOnboardingStep = (0, react.useCallback)((id) => {
+				setCompletedOnboarding((previous) => {
+					if (previous.has(id)) return previous;
+					return new Set([...previous, id]);
+				});
+			}, []);
+			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				(0, react_jsx_runtime.jsx)("button", {
+					type: "button",
+					className: clsx(SettingsRoot_module_css_default.trigger, !wide && SettingsRoot_module_css_default.rail),
+					"aria-haspopup": "dialog",
+					"aria-expanded": open,
+					onClick: () => {
+						setOpen(true);
+					},
+					children: renderSlot("settings.trigger", { wide })
+				}),
+				open && (0, react_jsx_runtime.jsx)(SettingsPanel, {
+					rows,
+					renderSlot,
+					activeId,
+					onSelect: setActiveId,
+					onClose: close
+				}),
+				onboardingStep !== void 0 && renderSlot("settings.onboarding", {
+					stepId: onboardingStep.id,
+					complete: () => {
+						completeOnboardingStep(onboardingStep.id);
+					},
+					openSection
+				}, { only: onboardingStep.id })
+			] });
+		}
+		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-settings-general/src/client/chrome.module.css.mjs
 		const css$3 = ".UQsH_q_triggerLabel{white-space:nowrap;overflow:hidden}";
 		const tagId$3 = "@deepseek-ai/dsh-client-ui-settings-general/chrome.module.css";
@@ -225,16 +445,16 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var WelcomeNotice_module_css_default = {
-			"page": "k2cPoG_page",
 			"error": "k2cPoG_error",
 			"title": "k2cPoG_title",
-			"footer": "k2cPoG_footer",
-			"brand": "k2cPoG_brand",
-			"welcome-enter": "k2cPoG_welcome-enter",
 			"feedback": "k2cPoG_feedback",
-			"primary": "k2cPoG_primary",
 			"reflection": "k2cPoG_reflection",
-			"opening": "k2cPoG_opening"
+			"page": "k2cPoG_page",
+			"footer": "k2cPoG_footer",
+			"primary": "k2cPoG_primary",
+			"welcome-enter": "k2cPoG_welcome-enter",
+			"opening": "k2cPoG_opening",
+			"brand": "k2cPoG_brand"
 		};
 		//#endregion
 		//#region lib/types/client/WelcomeNotice.js
@@ -522,7 +742,8 @@ window.__ModuleLoader__.load({
 		const inject = [
 			"slots",
 			"locale",
-			"connection"
+			"connection",
+			"remote"
 		];
 		/**
 		* Register the `settings` dictionaries, the chrome content, and the General
@@ -551,11 +772,13 @@ window.__ModuleLoader__.load({
 				useSnapshot: useWelcomeSnapshot
 			});
 			ctx.effect(() => {
-				const refresh = (ns) => {
-					if (ns !== void 0 && ns !== "ui-onboarding") return;
+				const refresh = () => {
 					refreshWelcomeIfLoaded(welcomeController);
 				};
-				const disposers = [ctx.on("settings/changed", refresh), ctx.on("connection/reset", () => {
+				const disposers = [ctx.remote.$on("settings/document-updated", (ns) => {
+					if (ns !== "ui-onboarding") return;
+					refresh();
+				}), ctx.on("connection/reset", () => {
 					refresh();
 					refreshDocumentIfLoaded(documentController);
 				})];
@@ -563,6 +786,83 @@ window.__ModuleLoader__.load({
 					for (const dispose of disposers) dispose();
 				};
 			}, "ui-settings-general: metadata invalidations");
+			let rowsVersion = -1;
+			let rowsRevision = -1;
+			let rows = [];
+			let onboardingVersion = -1;
+			let onboardingSteps = [];
+			const shellInjected = () => ({ hooks: {
+				sections: {
+					getSnapshot: () => {
+						const version = ctx.slots.getVersion("settings.section");
+						const revision = ctx.locale.getSnapshot().revision;
+						if (version !== rowsVersion || revision !== rowsRevision) {
+							rowsVersion = version;
+							rowsRevision = revision;
+							rows = ctx.slots.entries("settings.section").map((e) => ({
+								/* v8 ignore next -- list-slot registration requires id (SlotCore rejects an entry without one) */
+								id: e.options.id ?? "",
+								order: e.options.order ?? 0,
+								label: (0, _deepseek_ai_dsh_client_ui_slots.resolveSlotLabel)(e.options.label) ?? ""
+							})).sort((a, b) => a.order - b.order);
+						}
+						return rows;
+					},
+					subscribe: (listener) => {
+						const offLedger = ctx.slots.subscribe("settings.section", listener);
+						const offLocale = ctx.locale.subscribe(listener);
+						return () => {
+							offLedger();
+							offLocale();
+						};
+					}
+				},
+				onboardingSteps: {
+					getSnapshot: () => {
+						const version = ctx.slots.getVersion("settings.onboarding");
+						if (version !== onboardingVersion) {
+							onboardingVersion = version;
+							onboardingSteps = ctx.slots.entries("settings.onboarding").map((e) => ({
+								/* v8 ignore next -- list-slot registration requires id */
+								id: e.options.id ?? "",
+								order: e.options.order ?? 0
+							})).sort((a, b) => a.order - b.order);
+						}
+						return onboardingSteps;
+					},
+					subscribe: (listener) => ctx.slots.subscribe("settings.onboarding", listener)
+				}
+			} });
+			ctx.slots.inject("sidebar.settings", () => ctx.slots.register({
+				name: "sidebar.settings",
+				children: {
+					"settings.trigger": {
+						kind: "single",
+						scope: "root"
+					},
+					"settings.header": {
+						kind: "single",
+						scope: "root"
+					},
+					"settings.action": {
+						kind: "list",
+						scope: "root"
+					},
+					"settings.close": {
+						kind: "single",
+						scope: "root"
+					},
+					"settings.section": {
+						kind: "list",
+						scope: "root"
+					},
+					"settings.onboarding": {
+						kind: "list",
+						scope: "root"
+					}
+				},
+				inject: shellInjected
+			}, SettingsRoot));
 			ctx.slots.inject("settings.trigger", () => ctx.slots.register({
 				name: "settings.trigger",
 				locale: NS

package/lib/types/client/SettingsRoot.d.ts

@@ -0,0 +1,8 @@
+import type { SettingsRootComponentProps } from './shell-contract.ts';
+/**
+ * Render the settings trigger and panel.
+ * @param props - composed slot props (contract/slots.ts).
+ * @returns the settings shell element tree.
+ */
+export declare function SettingsRoot(props: SettingsRootComponentProps): import("react").JSX.Element;
+//# sourceMappingURL=SettingsRoot.d.ts.map

package/lib/types/client/index.d.ts

@@ -1,8 +1,10 @@
 /**
- * Settings ownerless-copy plugin, browser half: registers everything on the
- * Settings surface that belongs to no single feature — the trigger/header
- * chrome content, local-document action, General section, and `settings`
- * dictionaries. Feature-owned rows and sections stay with their features.
+ * Settings shell and ownerless-copy plugin, browser half: renders the
+ * `sidebar.settings` occupant — panel chrome, section navigation, and the
+ * onboarding stage — and registers everything on the Settings pages that
+ * belongs to no single feature: the trigger/header chrome content,
+ * local-document action, General section, and `settings` dictionaries.
+ * Feature-owned rows and sections stay with their features.
  * Export discipline: packages/client/AGENTS.md.
  */
 import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';

package/lib/types/client/shell-contract.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Settings shell contract — the types of the `sidebar.settings` occupant this
+ * package renders. They live here rather than in ui-settings because they
+ * reference the sidebar's own slot type: ui-settings is the settings domain's
+ * base layer and must not depend on any `ui-*` presentation package, or the
+ * reference graph closes a cycle through ui-sidebar → ui-layout → ui-theme.
+ * The settings SLOT types (what registrants contribute) stay in ui-settings.
+ */
+import type { HostObservable, InjectFace, PropsRenderSlots, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/** One nav row projected from a settings.section registration's options. */
+export interface SettingsSectionRow {
+    id: string;
+    order: number;
+    label: string;
+}
+/** One ordered onboarding step projected from a slot registration. */
+export interface SettingsOnboardingStep {
+    id: string;
+    order: number;
+}
+/**
+ * Registrant-private injected share of the settings shell (assembled in
+ * apply): the ledger's nav-row projection as a hooks-compartment source —
+ * the shell reads no locale state and subscribes through the bound hook.
+ */
+export type SettingsRootInjected = {
+    hooks: {
+        /** settings.section ledger projected into ordered nav rows. */
+        sections: HostObservable<readonly SettingsSectionRow[]>;
+        /** settings.onboarding ledger projected into coordinator order. */
+        onboardingSteps: HostObservable<readonly SettingsOnboardingStep[]>;
+    };
+};
+/**
+ * Full component props of the settings shell root: the sidebar owner share
+ * (wide/rail state) plus the declared render shares and the injected face
+ * (hooks compartment bound to useSections). No store is registered — modal
+ * open state and active section id are component-local viewing state.
+ */
+export type SettingsRootComponentProps = PropsRuntime<'sidebar.settings'> & PropsRenderSlots<'settings.trigger' | 'settings.header' | 'settings.action' | 'settings.close' | 'settings.section' | 'settings.onboarding'> & InjectFace<SettingsRootInjected>;
+//# sourceMappingURL=shell-contract.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-settings-general",
   "description": "Settings ownerless-copy and product onboarding plugin: the General section, shell trigger/header chrome content, settings dictionaries, and the versioned welcome notice",
-  "version": "0.0.1-rc.1",
+  "version": "0.0.1-rc.2",
   "publishConfig": {
     "access": "restricted"
   },
@@ -35,41 +35,48 @@
         "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-connection"
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-sidebar"
       ],
       "platform": "web"
     }
   },
   "license": "BSD-3-Clause",
   "dependencies": {
-    "@deepseek-ai/dsh-settings": "^0.0.1-rc.1",
+    "clsx": "^2.0.0",
+    "@deepseek-ai/dsh-settings": "^0.0.1-rc.2",
     "@deepseek-ai/schemastery": "^3.18.1-rc.1"
   },
   "peerDependencies": {
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.1",
-    "@deepseek-ai/cordis": "^4.0.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1"
+    "@deepseek-ai/dsh-api-remotes": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
-    "@deepseek-ai/cordis": "^4.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1"
+    "@deepseek-ai/dsh-api-remotes": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
   },
   "files": [
     "lib/index.js",