@deepseek-ai/dsh-client-ui-settings 0.1.7-alpha.2 → 0.1.7-rc.2

package/README.i18n.yaml

@@ -1,6 +1,58 @@
-# 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:
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/ui-settings/README.md
-README.md: 67b094993acbff92917594aafd0731818b5daa1b
-README.zh.md: eec972705e9113594b06aca0ee5b8b149b5c62ca
+/:
+  en: a68df653048eed14
+  zh: 2b117acaec0165a8
+/deepseek-ai-dsh-client-ui-settings:
+  en: 720600abd76a4a91
+  zh: 822bda08efbfc3e4
+/deepseek-ai-dsh-client-ui-settings/summary:
+  en: 0404ff8b4ec867e0
+  zh: 9c3f03dfd1306cc9
+/deepseek-ai-dsh-client-ui-settings/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 09388d293f9be9cb
+/deepseek-ai-dsh-client-ui-settings/use-this-package:
+  en: 2417d8409aad6ca7
+  zh: 449eee623a2f334b
+/deepseek-ai-dsh-client-ui-settings/use-this-package/configuration-forms:
+  en: 5bda0401a6a4f158
+  zh: 6778a64d3e2a7453
+/deepseek-ai-dsh-client-ui-settings/use-this-package/following-served-namespaces:
+  en: 2edd420502bebce1
+  zh: 6624abe01110c012
+/deepseek-ai-dsh-client-ui-settings/use-this-package/filling-the-settings-slots:
+  en: 28e4230a0675edf8
+  zh: b91c095ec2c0dd42
+/deepseek-ai-dsh-client-ui-settings/use-this-package/observable-success-and-failures:
+  en: 9767f17ca0f02ae3
+  zh: 8e475d6d3d670702
+/deepseek-ai-dsh-client-ui-settings/understand-the-implementation:
+  en: d756fe51d9456fb4
+  zh: 41de582aace7332f
+/deepseek-ai-dsh-client-ui-settings/understand-the-implementation/the-describe-mirror:
+  en: ea274a9480884a7f
+  zh: bbaf650e04646c04
+/deepseek-ai-dsh-client-ui-settings/understand-the-implementation/shared-entry-writes:
+  en: 11a73ab8e9280b81
+  zh: f0e72a05959e3f32
+/deepseek-ai-dsh-client-ui-settings/understand-the-implementation/schema-service:
+  en: 34872bda24dc50c6
+  zh: dcccef423906c408
+/deepseek-ai-dsh-client-ui-settings/further-exploration:
+  en: 57e3fe18940ecc83
+  zh: 165bd696250de5dc
+/deepseek-ai-dsh-client-ui-settings/model-experience:
+  en: 3120df665299c634
+  zh: 1d9f365d091d0d2a
+/deepseek-ai-dsh-client-ui-settings/model-experience/kv-cache-effect:
+  en: ca75c51c89c2c9b0
+  zh: de54f3467ef3b9be
+/deepseek-ai-dsh-client-ui-settings/known-limitations-and-deferred-work:
+  en: d8ef5c4f3a48e05f
+  zh: 7c335dc8543249c6
+/deepseek-ai-dsh-client-ui-settings/known-limitations-and-deferred-work/dev-note:
+  en: 26f0b742de49074e
+  zh: ee7321bad1101bf1

package/README.md

@@ -29,7 +29,7 @@ Feature plugins use this package to store and edit their preferences without re-
 
 ### Configuration forms
 
-`ctx.configForms.developerTools` owns the shared Web and desktop preference `ui-settings.enabled`, defaulting to `true`. Its `enabled` observable publishes accepted choices and `setEnabled` uses the same ordered settings writes. Desktop and loopback Web persist to the Host document; remote Web keeps this choice in one browser-local observable until reload without issuing Host writes. This controls presentation and HTML preview permissions, not Host authorization or Session recording. Host-backed clients keep developer features disabled until the first accepted schema-resolved value arrives; missing or failed initial responses do not enable them. Later refreshes retain the last accepted choice.
+`ctx.configForms.developerTools` owns the Coding Tools switch and the shared Web and desktop preference `ui-settings.enabled`, defaulting to `true`. Its `enabled` observable publishes accepted choices and `setEnabled` uses the same ordered settings writes. Desktop and loopback Web persist to the Host document; remote Web keeps this choice in one browser-local observable until reload without issuing Host writes. This controls presentation and HTML preview permissions, not Host authorization or Session recording. Host-backed clients keep developer features disabled until the first accepted schema-resolved value arrives; missing or failed initial responses do not enable them. Later refreshes retain the last accepted choice.
 
 Feature adapters use `ctx.configForms.get(entryId)` to obtain accepted values and a write queue shared by every editor of that Host entry. Snapshots contain resolved `value`, inherited `base`, raw `user`, revision, writability, and persistence mode. `set` and `unset` submit one operation; `mutate` submits one atomic operation list. Staged editors pass the revision read before editing; conflicts preserve their drafts. Unsetting removes the override and restores inheritance.
 
@@ -50,7 +50,7 @@ A committed write folds its answer into the shared mirror. Refused writes refres
 <a id="understand-the-implementation"></a>
 ## Understand the implementation
 
-The optional settings.launcher contribution receives wide and openSettings to supply a sidebar account menu; the shell retains its plain Settings trigger when no launcher is registered.
+The optional `settings.launcher` contribution receives sidebar geometry, whether the open Settings panel covers the sidebar, the settings navigation callbacks, and the effective Settings key labels and accessible combination. The shell omits shortcut presentation for an unbound command and retains its plain Settings trigger when no launcher is registered.
 
 <details>
 <summary>Implementation internals — click to expand</summary>
@@ -103,7 +103,7 @@ None; this package neither assembles nor sends a provider request.
 
 These limits define where the settings transport cannot reach; they are current package constraints.
 
-- **Non-loopback pages get no durable settings** — this Client keeps Host persistence disabled there, so a form starts `unavailable` and never crosses the wire; form writes are inert even though Connection authentication covers the API. The shared Developer tools preference instead provides browser-local changes.
+- **Non-loopback pages get no durable settings** — this Client keeps Host persistence disabled there, so a form starts `unavailable` and never crosses the wire; form writes are inert even though Connection authentication covers the API. The shared Coding Tools preference instead provides browser-local changes.
 
 <a id="dev-note"></a>
 ### Dev Note

package/README.zh.md

@@ -29,7 +29,7 @@ kind: "package-reference"
 
 ### 配置表单
 
-`ctx.configForms.developerTools` 管理 Web 和桌面端共享的偏好 `ui-settings.enabled`，默认为 `true`。其 `enabled` 可观察值发布已接受的选择，`setEnabled` 使用相同的有序设置写入。桌面端和回环 Web 将设置持久化到 Host 文档；远程 Web 将此选择保存在单个浏览器本地可观察值中，刷新后重置，不发送 Host 写入。此设置控制界面展示和 HTML 预览权限，不控制 Host 授权或 Session 记录。 使用 Host 偏好的客户端在首个经过 schema 解析并接受的值到达前保持开发者功能关闭；首次响应缺失或失败不会启用它们。后续刷新保留已接受的选择。
+`ctx.configForms.developerTools` 管理代码工作工具开关与 Web 和桌面端共享的偏好 `ui-settings.enabled`，默认为 `true`。其 `enabled` 可观察值发布已接受的选择，`setEnabled` 使用相同的有序设置写入。桌面端和回环 Web 将设置持久化到 Host 文档；远程 Web 将此选择保存在单个浏览器本地可观察值中，刷新后重置，不发送 Host 写入。此设置控制界面展示和 HTML 预览权限，不控制 Host 授权或 Session 记录。 使用 Host 偏好的客户端在首个经过 schema 解析并接受的值到达前保持开发者功能关闭；首次响应缺失或失败不会启用它们。后续刷新保留已接受的选择。
 
 功能适配器使用 `ctx.configForms.get(entryId)` 获取该 Host 条目所有编辑器共享的已接受值和写入队列。快照包含解析后的 `value`、继承 `base`、原始 `user`、修订号、可写性和持久化模式。`set` 与 `unset` 提交单个操作，`mutate` 提交一个原子操作列表。暂存编辑器传入编辑前读取的修订号；冲突时保留草稿。清除操作移除覆盖并恢复继承。
 
@@ -50,7 +50,7 @@ kind: "package-reference"
 <a id="understand-the-implementation"></a>
 ## 理解实现
 
-可选的 settings.launcher 贡献接收 wide 和 openSettings，以提供侧边栏账号菜单；未注册时，外壳保留普通设置按钮。
+可选的 `settings.launcher` 贡献接收侧栏布局、设置面板是否覆盖侧栏、设置导航回调，以及有效的设置键位标签和无障碍组合。命令未绑定时，外壳不传快捷键展示信息；未注册入口时，外壳保留普通设置按钮。
 
 <details>
 <summary>实现细节——点击展开</summary>
@@ -103,7 +103,7 @@ kind: "package-reference"
 
 这些限制说明设置传输层够不到的地方；它们是当前包约束。
 
-- **非 loopback 页面没有持久化设置**：本 Client 在那里禁用 Host 持久化，因此 表单以 `unavailable` 起步且从不跨线路；尽管 Connection 认证覆盖 API，表单写入仍在那里无效。共享的开发者工具偏好单独提供浏览器本地变更。
+- **非 loopback 页面没有持久化设置**：本 Client 在那里禁用 Host 持久化，因此 表单以 `unavailable` 起步且从不跨线路；尽管 Connection 认证覆盖 API，表单写入仍在那里无效。共享的代码工作工具偏好单独提供浏览器本地变更。
 
 <a id="dev-note"></a>
 ### 开发备注

package/lib/types/client/contract/slots.d.ts

@@ -170,6 +170,13 @@ export interface SettingsOnboardingOwnerProps {
 export interface SettingsLauncherOwnerProps {
     /** Whether the sidebar shows labels. */
     wide: boolean;
+    /** Whether the settings dialog covers the sidebar; a launcher may treat a false-to-true edge as one Settings entry. */
+    settingsOpen: boolean;
+    /** Effective Settings key labels and accessible combination; omitted when unbound. */
+    settingsShortcut?: {
+        readonly keys: readonly string[];
+        readonly aria?: string | undefined;
+    };
     /** Open the settings panel. */
     openSettings: () => void;
     /** @param id - registered onboarding editor to open explicitly. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-settings",
   "description": "Settings domain base plugin: shared configuration forms and the canonical settings slot-type contract",
-  "version": "0.1.7-alpha.2",
+  "version": "0.1.7-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -41,12 +41,12 @@
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-store": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-util-values": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-settings": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-util-values": "0.1.7-rc.2"
   },
   "files": [
     "lib/index.js",