@prettier-ai/dsh-client-ui-settings-general 0.1.2-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# 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: f0c4ab7c50798919d42ade0eac6a9a93c8a4df1c
+README.zh.md: 912ea0fb16c0d1d512ff846c8eda1e724664f1ea

package/README.md

@@ -0,0 +1,107 @@
+---
+description: "Settings shell, ownerless copy, and durable product-onboarding namespace for the dsh web client: the General section, trigger chrome, and onboarding ledger projection."
+kind: "package-reference"
+---
+
+# @deepseek-ai/dsh-client-ui-settings-general
+
+English | [中文](README.zh.md)
+
+## Summary
+
+`dsh-client-ui-settings-general` is the settings shell of the dsh web client: the Settings panel opens from the sidebar's bottom control with the trigger chrome and modal shell, the navigation is built from the sections features contribute, and first-run users are walked through one onboarding step at a time. It also 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, and the `settings` dictionaries. Feature-owned rows (Permission, Language, Appearance), sections (Models), and conditional onboarding steps stay with their feature packages; the shell itself ships no onboarding copy of its own.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Understand the implementation](#understand-the-implementation)
+- [Further Exploration](#further-exploration)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## Use this package
+
+Users reach the shell through the sidebar's bottom Settings control; feature plugins contribute their pages and onboarding steps through the slot ledgers this shell projects. The shell renders the modal panel, the navigation built from `settings.section` entries, and exactly one mounted onboarding step at a time.
+
+### The General section
+
+The General section holds rows registered into `settings.general.item` by feature packages — it has no built-in rows. Feature plugins own the row copy and behavior; the shell only provides the section and its slot. The Appearance row, for example, lives in ui-theme.
+
+### Opening the configuration file
+
+On a loopback browser, the shell renders **Open configuration file** only when the Host confirms that a provider-owned local document can be prepared. The action opens that document in the native text editor (bypassing the browser file association on macOS). Remote browsers never register the action and never issue the privileged settings read.
+
+### Onboarding steps
+
+The onboarding ledger projects in ascending order and mounts exactly one step at a time. Registrants own durable completion, capability readiness, copy, mutations, and their visible wrapper, so independently registered flows cannot stack and the shell does not become a second configuration fact source. Visible steps own their dialog chrome and app-root `inert` lifecycle.
+
+-----
+
+<a id="understand-the-implementation"></a>
+## Understand the implementation
+
+<details>
+<summary>Implementation internals — click to expand</summary>
+
+The shell owns the chrome and the projections; every piece of content and copy belongs to a registrant.
+
+### Ledger projections
+
+The navigation is a projection of the `settings.section` ledger; nav labels may be locale-following thunks, resolved through `resolveSlotLabel` and re-rendered 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; the active registrant receives its id, `complete()`, and an `openSection(id)` callback, and completing or skipping transfers ownership to the next entry.
+
+### Document availability
+
+On a loopback page, the Client 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 calls the pathless, browser-authenticated `settings/openSettingsDocument` Remote; 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. Non-loopback pages retain the Client policy that withholds this native action and its settings read.
+
+### Host half
+
+The Host half registers `ui-onboarding` in the user-settings seam. The welcome step contributed by ui-settings-models reads and writes its `welcomeNoticeVersion` through the existing public settings boundary; the shell itself remains policy-free.
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## Further Exploration
+
+These pages cover the settings surface family and the composition model.
+
+- [ui-settings](../ui-settings/README.md) — the domain base whose slot types and scope service this shell builds on.
+- [ui-sidebar](../ui-sidebar/README.md) — the sidebar shell hosting the `sidebar.settings` seat.
+- [ui-settings-models](../ui-settings-models/README.md) — the feature package contributing the DeepSeek onboarding step.
+- [settings](../../settings/README.md) — the durable user-settings seam and its file provider.
+- [Slot system standard](../../../.agents/notes/implemented/architecture/2026-07-22-slot-type-chain-implementation.md) — the composition model behind the ledgers.
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+None, as the package is a browser-side UI plugin layer that registers nothing model-facing.
+
+#### KV Cache effect
+
+None; this package neither assembles nor sends a provider request.
+
+## Known Limitations and Deferred Work
+
+<a id="known-limitations-and-deferred-work"></a>
+
+
+These limits define what the shell itself provides versus what features must supply; they are current package constraints.
+
+- **The General section has no built-in rows** — each row appears only when its owning feature plugin is mounted; the shell cannot fill the section alone.
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Working context for maintainers — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -0,0 +1,107 @@
+---
+description: "dsh Web 客户端的设置外壳、无特定功能归属文案与持久化产品引导命名空间：「通用」分区、触发控件界面框架与引导账本投影。"
+kind: "package-reference"
+---
+
+# @deepseek-ai/dsh-client-ui-settings-general
+
+[English](README.md) | 中文
+
+## 概述
+
+`dsh-client-ui-settings-general` 是 dsh Web 客户端的设置外壳：Settings 面板从侧边栏底部的控件打开，带触发控件与模态外壳；导航由各功能贡献的分区构建；首次运行的用户一次只走一个引导步骤。它还注册设置页面上所有不属于单一功能的内容：触发器、标题栏与关闭控件界面框架、「本地配置文件」操作、「通用」分区及其 `settings.general.item` slot，以及 `settings` 字典。归具体功能所有的行（「权限」、「语言」、「外观」）、分区（「模型」）与条件式首次使用引导步骤仍由各自的功能包提供；外壳本身不自带任何引导文案。
+
+## 目录
+
+- [使用本包](#use-this-package)
+- [理解实现](#understand-the-implementation)
+- [进一步探索](#further-exploration)
+- [模型体验](#model-experience)
+- [已知限制与延期工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## 使用本包
+
+用户通过侧边栏底部的 Settings 控件进入外壳；功能插件通过本外壳所投影的 slot 账本贡献自己的页面与引导步骤。外壳渲染模态面板、由 `settings.section` 条目构建的导航，以及每次只挂载一个的引导步骤。
+
+### 「通用」分区
+
+「通用」分区承载由功能包注册进 `settings.general.item` 的行——它没有内置行。功能插件拥有行文案与行为；外壳只提供分区及其 slot。例如「外观」行位于 ui-theme。
+
+### 打开配置文件
+
+在回环浏览器上，只有当宿主确认可准备好一份由提供方持有的本地文档时，外壳才渲染**打开配置文件**。该操作会在原生文本编辑器中打开该文档（macOS 上绕过浏览器文件关联）。远程浏览器从不注册该操作，也从不发起这项特权设置读取。
+
+### 引导步骤
+
+引导账本按升序投影，每次只挂载一个步骤。注册方持有持久化完成状态、能力就绪状态、文案、变更操作与可见包装，因此独立注册的流程无法堆叠，外壳也不会成为第二个配置事实来源。可见步骤自行持有弹窗框架与应用根节点 `inert` 生命周期。
+
+-----
+
+<a id="understand-the-implementation"></a>
+## 理解实现
+
+<details>
+<summary>实现细节——点击展开</summary>
+
+外壳拥有界面框架与投影；每段内容与文案都属于某个注册方。
+
+### 账本投影
+
+导航是 `settings.section` 账本的投影；导航 label 可以是跟随语言的 thunk，经 `resolveSlotLabel` 解析，并在分区账本更新或 locale revision 变化时重新渲染（`ctx.get('locale')` 可选读取，无硬 locale 依赖）。引导账本按升序投影；当前注册方会收到该条目的 id、`complete()` 与 `openSection(id)` 回调，完成或跳过当前步骤后，所有权转交给下一项。
+
+### 文档可用性
+
+在 loopback 页面上，Client 通过 `settings/describe` 加载提供方的 `hasDocument` 能力，且只有在 Host 确认可准备好一份由提供方持有的本地文档时才渲染配置文件操作。该操作调用无路径参数且经浏览器认证的 `settings/openSettingsDocument` Remote；Host 会再次解析提供方路径、在文档缺失时将其创建出来，并交给原生文本编辑器（macOS 上使用 `open -t`，绕过浏览器文件关联；Linux 和 Windows 上使用桌面文件关联；WSL 上经 `wslpath -w` 转换后使用 Windows 文件关联）。打开失败时该操作仍可使用，并渲染本地化错误。临时读取失败或 Host 拓扑变化后，重新打开对话框或重新连接会刷新可用性。非 loopback 页面保留 Client 策略，不提供该原生操作及其 settings 读取。
+
+### 宿主端
+
+宿主端在用户设置 seam 中注册 `ui-onboarding`。`ui-settings-models` 提供的欢迎步骤通过既有公开 settings 边界读写其中的 `welcomeNoticeVersion`；外壳本身仍不持有产品策略。
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## 进一步探索
+
+以下页面覆盖设置界面家族与组合模型。
+
+- [ui-settings](../ui-settings/README.zh.md)——本外壳所依赖 slot 类型与 scope 服务所在的领域底座。
+- [ui-sidebar](../ui-sidebar/README.zh.md)——承载 `sidebar.settings` 席位的侧边栏外壳。
+- [ui-settings-models](../ui-settings-models/README.zh.md)——贡献 DeepSeek 引导步骤的功能包。
+- [settings](../../settings/README.zh.md)——持久化用户设置 seam 及其文件提供方。
+- [slot 系统标准](../../../.agents/notes/implemented/architecture/2026-07-22-slot-type-chain-implementation.zh.md)——账本背后的组合模型。
+
+-----
+
+<a id="model-experience"></a>
+## 模型体验
+
+无。该包是浏览器端 UI 插件层，不注册任何面向模型的内容。
+
+#### KV Cache 影响
+
+无；该包既不组装也不发送提供方请求。
+
+## 已知限制与延期工作
+
+<a id="known-limitations-and-deferred-work"></a>
+
+
+这些限制说明外壳自身提供什么、功能包必须提供什么；它们是当前包约束。
+
+- **「通用」分区没有内置行**：每一行仅在其所属功能插件挂载时出现；外壳单独无法填满该分区。
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者的工作上下文——点击展开</summary>
+
+无。
+
+</details>

package/lib/client.js

@@ -0,0 +1,606 @@
+window.__ModuleLoader__.load({
+	id: "@prettier-ai/dsh-client-ui-settings-general",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let _prettier_ai_dsh_client_ui_slots = require("@prettier-ai/dsh-client-ui-slots");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		let react = require("react");
+		let _prettier_ai_dsh_client_ui_primitives = require("@prettier-ai/dsh-client-ui-primitives");
+		let _prettier_ai_dsh_client_store = require("@prettier-ai/dsh-client-store");
+		//#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/dsh-publisher/dsh-publisher/upstream/packages/client/ui-settings-general/src/client/SettingsRoot.module.css.mjs
+		const css$3 = ".eUC7PW_trigger{box-sizing:border-box;cursor:pointer;width:calc(100% + 4px);height:42px;color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:12px;flex:none;align-items:center;gap:8px;margin:4px -2px;padding:0 10px 0 8px;font-family:inherit;font-size:14px;line-height:22px;display:flex;overflow:hidden}.eUC7PW_trigger:hover{background:var(--dsw-alias-interactive-bg-hover)}.eUC7PW_trigger.eUC7PW_rail{border-radius:50%;justify-content:center;gap:0;width:36px;height:36px;margin:8px 0 10px;padding:0}.eUC7PW_triggerLabel{white-space:nowrap;overflow:hidden}.eUC7PW_overlay{z-index:1000;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.eUC7PW_mask{background:var(--dsw-alias-bg-mask-1);backdrop-filter:var(--dsw-mask-blur);position:absolute;inset:0}.eUC7PW_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}.eUC7PW_nav{box-sizing:border-box;flex-direction:column;flex:none;gap:18px;width:188px;padding:22px 12px 0;display:flex}.eUC7PW_navTitle{color:var(--dsw-alias-label-primary);padding:0 12px;font-size:16px;font-weight:500;line-height:24px}.eUC7PW_navList{flex-direction:column;gap:4px;display:flex}.eUC7PW_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}.eUC7PW_navCell:hover{background:var(--dsw-specific-sidebar-nav-item-hover)}.eUC7PW_navCell.eUC7PW_active{background:var(--dsw-specific-sidebar-nav-item-active)}.eUC7PW_navIcon{flex:none}.eUC7PW_navLabel{white-space:nowrap;text-overflow:ellipsis;flex:1;min-width:0;overflow:hidden}.eUC7PW_content{flex-direction:column;flex:1;min-width:0;display:flex}.eUC7PW_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}.eUC7PW_actions{justify-content:flex-end;align-items:center;gap:8px;min-width:0;margin-left:auto;display:flex}.eUC7PW_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}.eUC7PW_close:hover{background:var(--dsw-alias-interactive-bg-hover)}.eUC7PW_options{flex:1;min-height:0;padding:0 24px 24px;overflow-y:auto}.eUC7PW_hiddenLabel{clip:rect(0 0 0 0);white-space:nowrap;width:1px;height:1px;position:absolute;overflow:hidden}";
+		const tagId$3 = "@prettier-ai/dsh-client-ui-settings-general/SettingsRoot.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$3) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@prettier-ai/dsh-client-ui-settings-general";
+			tag.dataset.pluginCss = tagId$3;
+			tag.textContent = css$3;
+			document.head.appendChild(tag);
+		}
+		var SettingsRoot_module_css_default = {
+			"actions": "eUC7PW_actions",
+			"active": "eUC7PW_active",
+			"close": "eUC7PW_close",
+			"content": "eUC7PW_content",
+			"header": "eUC7PW_header",
+			"hiddenLabel": "eUC7PW_hiddenLabel",
+			"mask": "eUC7PW_mask",
+			"nav": "eUC7PW_nav",
+			"navCell": "eUC7PW_navCell",
+			"navIcon": "eUC7PW_navIcon",
+			"navLabel": "eUC7PW_navLabel",
+			"navList": "eUC7PW_navList",
+			"navTitle": "eUC7PW_navTitle",
+			"options": "eUC7PW_options",
+			"overlay": "eUC7PW_overlay",
+			"panel": "eUC7PW_panel",
+			"rail": "eUC7PW_rail",
+			"trigger": "eUC7PW_trigger",
+			"triggerLabel": "eUC7PW_triggerLabel"
+		};
+		//#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. Visible dialog chrome 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)(_prettier_ai_dsh_client_ui_primitives.IconDataOutline16, {
+				className: SettingsRoot_module_css_default.navIcon,
+				size: 16
+			});
+			if (id === "agent-presets") return (0, react_jsx_runtime.jsx)(_prettier_ai_dsh_client_ui_primitives.IconAgentPresetOutline16, {
+				className: SettingsRoot_module_css_default.navIcon,
+				size: 16
+			});
+			if (id === "plugins") return (0, react_jsx_runtime.jsx)(_prettier_ai_dsh_client_ui_primitives.IconPersonalizationOutline16, {
+				className: SettingsRoot_module_css_default.navIcon,
+				size: 16
+			});
+			return (0, react_jsx_runtime.jsx)(_prettier_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)(_prettier_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/dsh-publisher/dsh-publisher/upstream/packages/client/ui-settings-general/src/client/chrome.module.css.mjs
+		const css$2 = ".WL4-9a_triggerLabel{white-space:nowrap;overflow:hidden}";
+		const tagId$2 = "@prettier-ai/dsh-client-ui-settings-general/chrome.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$2) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@prettier-ai/dsh-client-ui-settings-general";
+			tag.dataset.pluginCss = tagId$2;
+			tag.textContent = css$2;
+			document.head.appendChild(tag);
+		}
+		var chrome_module_css_default = { "triggerLabel": "WL4-9a_triggerLabel" };
+		//#endregion
+		//#region lib/types/client/chrome.js
+		/**
+		* Shell chrome content registered into the shell's trigger/header seats: the
+		* trigger row icon + label (figma sidebar foot) and the panel title text.
+		* The shell renders the surrounding chrome (button, nav heading row) and
+		* reads each entry's `label` option for aria text.
+		*/
+		/**
+		* Render the trigger row content (icon; label only in the wide column).
+		* @param props - composed slot props.
+		* @returns the trigger content fragment.
+		*/
+		function TriggerContent({ wide, t }) {
+			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [wide ? (0, react_jsx_runtime.jsx)(_prettier_ai_dsh_client_ui_primitives.IconSettingsOutline16, { size: 16 }) : (0, react_jsx_runtime.jsx)(_prettier_ai_dsh_client_ui_primitives.IconSettingsOutline14, { size: 18 }), wide && (0, react_jsx_runtime.jsx)("span", {
+				className: chrome_module_css_default.triggerLabel,
+				children: t("trigger")
+			})] });
+		}
+		/**
+		* Render the panel title text.
+		* @param props - composed slot props.
+		* @returns the title text node.
+		*/
+		function HeaderContent({ t }) {
+			return (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: t("title") });
+		}
+		/**
+		* Render the close button's visually-hidden label text.
+		* @param props - composed slot props.
+		* @returns the label text node.
+		*/
+		function CloseLabel({ t }) {
+			return (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: t("close") });
+		}
+		//#endregion
+		//#region \0dsh-css:/home/runner/work/dsh-publisher/dsh-publisher/upstream/packages/client/ui-settings-general/src/client/GeneralSection.module.css.mjs
+		const css$1 = ".gxVjla_section{flex-direction:column;width:100%;display:flex}.gxVjla_section>[data-slot=\"settings.general.item\"]>:last-child{border-bottom:none}";
+		const tagId$1 = "@prettier-ai/dsh-client-ui-settings-general/GeneralSection.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@prettier-ai/dsh-client-ui-settings-general";
+			tag.dataset.pluginCss = tagId$1;
+			tag.textContent = css$1;
+			document.head.appendChild(tag);
+		}
+		var GeneralSection_module_css_default = { "section": "gxVjla_section" };
+		//#endregion
+		//#region lib/types/client/GeneralSection.js
+		/**
+		* Render the General section content column.
+		* @param props - composed slot props (contract/slots.ts).
+		* @returns the section element tree.
+		*/
+		function GeneralSection({ renderSlot }) {
+			return (0, react_jsx_runtime.jsx)("div", {
+				className: GeneralSection_module_css_default.section,
+				children: renderSlot("settings.general.item", {})
+			});
+		}
+		//#endregion
+		//#region \0dsh-css:/home/runner/work/dsh-publisher/dsh-publisher/upstream/packages/client/ui-settings-general/src/client/SettingsDocumentAction.module.css.mjs
+		const css = ".lkm8fG_action{align-items:center;gap:8px;min-width:0;display:flex}.lkm8fG_error{max-width:180px;color:var(--dsw-alias-state-error-primary);text-overflow:ellipsis;white-space:nowrap;font-size:12px;line-height:18px;overflow:hidden}";
+		const tagId = "@prettier-ai/dsh-client-ui-settings-general/SettingsDocumentAction.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@prettier-ai/dsh-client-ui-settings-general";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var SettingsDocumentAction_module_css_default = {
+			"action": "lkm8fG_action",
+			"error": "lkm8fG_error"
+		};
+		//#endregion
+		//#region lib/types/client/SettingsDocumentAction.js
+		/** Optional settings-header action for opening a file-backed Host document. */
+		/**
+		* Render the open-document action only after Host metadata confirms document availability.
+		* @param props - header owner props, localized copy, and injected document state.
+		* @returns the action, or null while unavailable or unresolved.
+		*/
+		function SettingsDocumentAction({ controller, useSnapshot, t }) {
+			const state = useSnapshot((snapshot) => snapshot);
+			(0, react.useEffect)(() => {
+				controller.load();
+			}, [controller]);
+			if (state.status !== "ready") return null;
+			return (0, react_jsx_runtime.jsxs)("div", {
+				className: SettingsDocumentAction_module_css_default.action,
+				children: [state.error === null ? null : (0, react_jsx_runtime.jsx)("span", {
+					className: SettingsDocumentAction_module_css_default.error,
+					role: "alert",
+					children: t("openDocument.error")
+				}), (0, react_jsx_runtime.jsx)(_prettier_ai_dsh_client_ui_primitives.Button, {
+					variant: "outline",
+					size: "sm",
+					disabled: state.opening,
+					onClick: () => {
+						controller.open();
+					},
+					children: t("openDocument")
+				})]
+			});
+		}
+		//#endregion
+		//#region lib/types/client/settings-document-store.js
+		/** State owner for the optional local settings-document action. */
+		function messageOf(error) {
+			return error instanceof Error ? error.message : String(error);
+		}
+		/** Derives local-document availability from the shared mirror and invokes the pathless Host-owned open operation. */
+		var SettingsDocumentStore = class {
+			remote;
+			describeFace;
+			/** uSES-safe state source shared by the registered header action. */
+			store = (0, _prettier_ai_dsh_client_store.createSnapshotStore)({
+				status: "idle",
+				opening: false,
+				error: null
+			});
+			following;
+			/**
+			* @param api - loopback settings wire face that opens the provider document.
+			* @param describeFace - the shared mirror's describe face (`hasDocument` source).
+			*/
+			constructor(remote, describeFace) {
+				this.remote = remote;
+				this.describeFace = describeFace;
+			}
+			/**
+			* Begin following the mirror (idempotent) and reflect whether the current
+			* provider owns a local document.
+			* @returns settlement once the snapshot reflects the mirror.
+			*/
+			async load() {
+				this.following ??= this.describeFace.subscribe(() => {
+					this.derive();
+				});
+				this.store.update((state) => {
+					state.status = "loading";
+					state.error = null;
+				});
+				await this.describeFace.ensure();
+				this.derive();
+			}
+			/**
+			* Open the loaded document once; concurrent gestures collapse behind the in-flight action.
+			* @returns after the native-open request settles, or immediately when unavailable/already opening.
+			*/
+			async open() {
+				const current = this.store.getSnapshot();
+				if (current.status !== "ready" || current.opening) return;
+				this.store.update((state) => {
+					state.opening = true;
+					state.error = null;
+				});
+				try {
+					const result = await this.remote.settings.openSettingsDocument();
+					if (!result.ok) throw new Error(result.error.message);
+				} catch (error) {
+					this.store.update((state) => {
+						state.error = messageOf(error);
+					});
+				} finally {
+					this.store.update((state) => {
+						state.opening = false;
+					});
+				}
+			}
+			/** Stop following the mirror. */
+			dispose() {
+				this.following?.();
+				this.following = void 0;
+			}
+			derive() {
+				const mirrored = this.describeFace.getSnapshot();
+				if (mirrored.view === void 0) {
+					if (mirrored.error !== null) this.store.update((state) => {
+						state.status = "unavailable";
+						state.error = mirrored.error;
+					});
+					return;
+				}
+				const { hasDocument } = mirrored.view;
+				this.store.update((state) => {
+					state.status = hasDocument ? "ready" : "unavailable";
+					state.error = null;
+				});
+			}
+		};
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** Shell chrome and General-nav dictionaries; feature rows own their copy. */
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"trigger": "设置",
+			"title": "设置",
+			"close": "关闭",
+			"openDocument": "打开配置文件",
+			"openDocument.error": "无法打开配置文件",
+			"general.nav": "通用设置"
+		};
+		/** English dictionary, checked complete against the zh key set. */
+		const en = {
+			"trigger": "Settings",
+			"title": "Settings",
+			"close": "Close",
+			"openDocument": "Open configuration file",
+			"openDocument.error": "Could not open configuration file",
+			"general.nav": "General"
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Dictionary namespace owned by this plugin (shell chrome + General copy). */
+		const NS = "settings";
+		/**
+		* Required services (cordis fiber inject). The target slots are declared by
+		* ui-settings' apply, whose activation order relative to this one is NOT
+		* constrained; registrations depend on their slots through `slots.inject()`.
+		*/
+		const inject = [
+			"slots",
+			"locale",
+			"connection",
+			"remote",
+			"remote.settings",
+			"settingsScope"
+		];
+		/**
+		* Register the `settings` dictionaries, the chrome content, and the General
+		* section, each once its slot declaration is on the ledger.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-settings-general: dictionaries");
+			const t = ctx.locale.bind(NS);
+			const documentController = ctx.get("connection").isLoopback ? new SettingsDocumentStore(ctx.remote, ctx.settingsScope.describe()) : void 0;
+			const documentInjected = documentController === void 0 ? void 0 : () => ({
+				controller: documentController,
+				hooks: { snapshot: documentController.store }
+			});
+			ctx.effect(() => () => {
+				documentController?.dispose();
+			}, "ui-settings-general: document action directory");
+			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, _prettier_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
+			}, TriggerContent));
+			ctx.slots.inject("settings.header", () => ctx.slots.register({
+				name: "settings.header",
+				locale: NS
+			}, HeaderContent));
+			if (documentInjected !== void 0) ctx.slots.inject("settings.action", () => ctx.slots.register({
+				name: "settings.action",
+				id: "open-document",
+				order: 0,
+				locale: NS,
+				inject: documentInjected
+			}, SettingsDocumentAction));
+			ctx.slots.inject("settings.close", () => ctx.slots.register({
+				name: "settings.close",
+				locale: NS
+			}, CloseLabel));
+			ctx.slots.inject("settings.section", () => ctx.slots.register({
+				name: "settings.section",
+				id: "general",
+				order: 0,
+				label: () => t("general.nav"),
+				locale: NS,
+				children: { "settings.general.item": {
+					kind: "list",
+					scope: "root"
+				} }
+			}, GeneralSection));
+		}
+		//#endregion
+		exports.SettingsDocumentStore = SettingsDocumentStore;
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,15 @@
+import z from "@prettier-ai/schemastery";
+import { settingsNamespace } from "@prettier-ai/dsh-settings";
+//#region lib/types/index.js
+/** Host loader entry for the browser implementation exported from `./client`. */
+/** Durable settings namespace for product-wide GUI onboarding facts. */
+const ONBOARDING_SETTINGS_NAMESPACE = "ui-onboarding";
+const OnboardingSettingsSchema = z.object({ welcomeNoticeVersion: z.string() });
+/** Register the durable GUI-onboarding section when a settings provider exists. */
+function apply(ctx) {
+	ctx.inject(["settings"], (settingsCtx) => {
+		settingsCtx.settings.register(settingsNamespace(ONBOARDING_SETTINGS_NAMESPACE), OnboardingSettingsSchema);
+	});
+}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,25 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@prettier-ai/dsh-client-ui-settings-general`.
+* @module @prettier-ai/dsh-client-ui-settings-general/invariant
+*/
+const PACKAGE_NAME = "@prettier-ai/dsh-client-ui-settings-general";
+/** Cordis companion plugin name. */
+const name = "client-ui-settings-general-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: the settings seam validates and publishes the durable
+* onboarding section, while slot conflicts fail loud in the slot core. The local
+* document action is browser state over typed RPC responses and is covered by
+* store/component tests rather than a Cordis runtime relationship.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,11 @@
+/** The General section: one column rendering feature-owned item contributions. */
+import type { PropsRenderSlots, PropsRuntime } from '@prettier-ai/dsh-client-ui-slots';
+/** Full component props: section owner share plus item render share. */
+export type GeneralSectionComponentProps = PropsRuntime<'settings.section'> & PropsRenderSlots<'settings.general.item'>;
+/**
+ * Render the General section content column.
+ * @param props - composed slot props (contract/slots.ts).
+ * @returns the section element tree.
+ */
+export declare function GeneralSection({ renderSlot }: GeneralSectionComponentProps): import("react").JSX.Element;
+//# sourceMappingURL=GeneralSection.d.ts.map

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

@@ -0,0 +1,22 @@
+/** Optional settings-header action for opening a file-backed Host document. */
+import type { ReactNode } from 'react';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@prettier-ai/dsh-client-ui-slots';
+import type { SettingsDocumentStore } from './settings-document-store.ts';
+/** Registrant-owned dependencies of {@link SettingsDocumentAction}. */
+export interface SettingsDocumentActionInjected {
+    /** Provider metadata and action state owner. */
+    controller: SettingsDocumentStore;
+    hooks: {
+        /** Controller snapshot bound by the UI renderer as useSnapshot. */
+        snapshot: SettingsDocumentStore['store'];
+    };
+}
+/** Header-action owner share, localized copy, and the registrant's state face. */
+export type SettingsDocumentActionProps = PropsRuntime<'settings.action'> & PropsLocale<'settings'> & InjectFace<SettingsDocumentActionInjected>;
+/**
+ * Render the open-document action only after Host metadata confirms document availability.
+ * @param props - header owner props, localized copy, and injected document state.
+ * @returns the action, or null while unavailable or unresolved.
+ */
+export declare function SettingsDocumentAction({ controller, useSnapshot, t }: SettingsDocumentActionProps): ReactNode;
+//# sourceMappingURL=SettingsDocumentAction.d.ts.map

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/chrome.d.ts

@@ -0,0 +1,26 @@
+import type { PropsLocale, PropsRuntime } from '@prettier-ai/dsh-client-ui-slots';
+/** Trigger content props: the sidebar column state + the standard locale seat. */
+export type TriggerContentProps = PropsRuntime<'settings.trigger'> & PropsLocale<'settings'>;
+/** Header content props: the standard locale seat only. */
+export type HeaderContentProps = PropsRuntime<'settings.header'> & PropsLocale<'settings'>;
+/**
+ * Render the trigger row content (icon; label only in the wide column).
+ * @param props - composed slot props.
+ * @returns the trigger content fragment.
+ */
+export declare function TriggerContent({ wide, t }: TriggerContentProps): import("react").JSX.Element;
+/**
+ * Render the panel title text.
+ * @param props - composed slot props.
+ * @returns the title text node.
+ */
+export declare function HeaderContent({ t }: HeaderContentProps): import("react").JSX.Element;
+/** Close-button label text props: the standard locale seat only. */
+export type CloseLabelProps = PropsRuntime<'settings.close'> & PropsLocale<'settings'>;
+/**
+ * Render the close button's visually-hidden label text.
+ * @param props - composed slot props.
+ * @returns the label text node.
+ */
+export declare function CloseLabel({ t }: CloseLabelProps): import("react").JSX.Element;
+//# sourceMappingURL=chrome.d.ts.map

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

@@ -0,0 +1,36 @@
+/**
+ * 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 { Context as ClientContext } from '@prettier-ai/cordis';
+import { type SettingsKey } from './locales.ts';
+export type { CloseLabelProps, HeaderContentProps, TriggerContentProps, } from './chrome.tsx';
+export type { GeneralSectionComponentProps, } from './GeneralSection.tsx';
+export type { SettingsDocumentActionInjected, SettingsDocumentActionProps } from './SettingsDocumentAction.tsx';
+export type { SettingsDocumentState } from './settings-document-store.ts';
+export { SettingsDocumentStore } from './settings-document-store.ts';
+export type { SettingsKey } from './locales.ts';
+declare module '@prettier-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Shell chrome + shell-owned General section copy. */
+        settings: SettingsKey;
+    }
+}
+/**
+ * Required services (cordis fiber inject). The target slots are declared by
+ * ui-settings' apply, whose activation order relative to this one is NOT
+ * constrained; registrations depend on their slots through `slots.inject()`.
+ */
+export declare const inject: string[];
+/**
+ * Register the `settings` dictionaries, the chrome content, and the General
+ * section, each once its slot declaration is on the ledger.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,22 @@
+/** Shell chrome and General-nav dictionaries; feature rows own their copy. */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    trigger: string;
+    title: string;
+    close: string;
+    openDocument: string;
+    'openDocument.error': string;
+    'general.nav': string;
+};
+/** The settings namespace key union. */
+export type SettingsKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    trigger: string;
+    title: string;
+    close: string;
+    openDocument: string;
+    'openDocument.error': string;
+    'general.nav': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/settings-document-store.d.ts

@@ -0,0 +1,41 @@
+/** State owner for the optional local settings-document action. */
+import type { ClientRemote } from '@prettier-ai/dsh-api-remotes/client';
+import { type SnapshotStore } from '@prettier-ai/dsh-client-store';
+import type { SettingsDescribeFace } from '@prettier-ai/dsh-client-ui-settings/client';
+/** Browser state of the Host-owned settings document. */
+export interface SettingsDocumentState {
+    /** Metadata-loading phase; unavailable means the provider has no local document or the read failed. */
+    status: 'idle' | 'loading' | 'ready' | 'unavailable';
+    /** Whether one native-open request is in flight. */
+    opening: boolean;
+    /** Last metadata/native-open diagnostic; UI exposes only localized copy. */
+    error: string | null;
+}
+/** Derives local-document availability from the shared mirror and invokes the pathless Host-owned open operation. */
+export declare class SettingsDocumentStore {
+    private readonly remote;
+    private readonly describeFace;
+    /** uSES-safe state source shared by the registered header action. */
+    readonly store: SnapshotStore<SettingsDocumentState>;
+    private following;
+    /**
+     * @param api - loopback settings wire face that opens the provider document.
+     * @param describeFace - the shared mirror's describe face (`hasDocument` source).
+     */
+    constructor(remote: Pick<ClientRemote, 'settings'>, describeFace: SettingsDescribeFace);
+    /**
+     * Begin following the mirror (idempotent) and reflect whether the current
+     * provider owns a local document.
+     * @returns settlement once the snapshot reflects the mirror.
+     */
+    load(): Promise<void>;
+    /**
+     * Open the loaded document once; concurrent gestures collapse behind the in-flight action.
+     * @returns after the native-open request settles, or immediately when unavailable/already opening.
+     */
+    open(): Promise<void>;
+    /** Stop following the mirror. */
+    dispose(): void;
+    private derive;
+}
+//# sourceMappingURL=settings-document-store.d.ts.map

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 '@prettier-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/lib/types/index.d.ts

@@ -0,0 +1,5 @@
+/** Host loader entry for the browser implementation exported from `./client`. */
+import type { Context } from '@prettier-ai/cordis';
+/** Register the durable GUI-onboarding section when a settings provider exists. */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@prettier-ai/dsh-client-ui-settings-general`.
+ * @module @prettier-ai/dsh-client-ui-settings-general/invariant
+ */
+import type { Context } from '@prettier-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-settings-general-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@prettier-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.1.2-alpha.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-settings-general"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@prettier-ai/dsh-client-ui-settings",
+        "@prettier-ai/dsh-client-locale",
+        "@prettier-ai/dsh-client-connection",
+        "@prettier-ai/dsh-api-remotes",
+        "@prettier-ai/dsh-client-ui-sidebar"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "dependencies": {
+    "clsx": "^2.0.0",
+    "@prettier-ai/schemastery": "^3.18.1"
+  },
+  "peerDependencies": {
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-settings": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-sidebar": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-settings": "^0.1.2-alpha.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-store": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-test-runtime": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-settings": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-primitives": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-slots": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-sidebar": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-settings": "^0.1.2-alpha.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}