@deepseek-ai/dsh-client-ui-settings-general 0.1.5-rc.2 → 0.1.6-alpha.1

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: 845d9c48dce2264d478f0ac854ef85a480828a14
-README.zh.md: 4a96e78a13dd8e6aefd759926f6e2cb153f0b259
+README.md: af68c42ad111f74e68037436e18a5be57195a64b
+README.zh.md: f929df66a13cde7beb63721922f2a3f4aa90ba43

package/README.md

@@ -25,7 +25,7 @@ Use this package to give the dsh web client a Settings panel, connection-recover
 <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. In both the expanded sidebar and collapsed rail, the control exposes the localized Settings label as its accessible name. A pale-yellow **Disconnected** action beside Settings indicates browser offline suspension. Automatic recovery shows **Reconnecting** with one to three dots advancing every 500ms. Hover or keyboard focus changes either yellow label to **Reconnect now** without changing its background; press feedback stays within the warning palette, and selecting it starts retry 1 immediately. Recovery changes the region to pale-green **Connected** for two seconds before it disappears. The icon, left-aligned text origin, height, and width remain fixed across every visible state. Initial startup and uninterrupted healthy operation remain silent. The shell renders the modal panel, the navigation built from `settings.section` entries, and exactly one mounted onboarding step at a time.
+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. In both the expanded sidebar and collapsed rail, the control exposes the localized Settings label as its accessible name. A pale-yellow **Disconnected** action beside Settings indicates browser offline suspension; its permanent retry glyph marks the retry action, which the Chinese outage copy also names (连接异常，刷新重试). Every recovery attempt shows a spinner beside **Reconnecting** with one to three dots advancing every 500ms, and an attempt stays visible for at least 800ms so brief retries do not flicker. Selecting either yellow state starts an immediate retry; press feedback stays within the warning palette. Recovery changes the region to pale-green **Connected** for two seconds from the moment the green pill becomes visible. The pill fades in on appearance, fades out over 150ms on removal, and sizes to its current label. Initial startup and uninterrupted healthy operation remain silent. 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
 
@@ -55,7 +55,7 @@ The navigation is a projection of the `settings.section` ledger; nav labels may
 
 ### Connection recovery
 
-The shell is an explicit recovery consumer, so it injects Connection directly rather than adding lifecycle controls to `ctx.remote`. Its private hooks compartment binds `ctx.connection.state`, while the component receives only the selected state and an injected callback for `ctx.connection.reconnect()`. `ConnectionIndicator` owns the inline presentation and receives all visible and accessible copy from the `settings` locale namespace; the shell owns the two-second recovered-state timer.
+The shell is an explicit recovery consumer, so it injects Connection directly rather than adding lifecycle controls to `ctx.remote`. Its private hooks compartment binds `ctx.connection.state`, while the component receives only the selected state and an injected callback for `ctx.connection.reconnect()`. `ConnectionIndicator` owns the inline presentation and receives all visible and accessible copy from the `settings` locale namespace; the shell owns the 800ms minimum-visible hold for the connecting state and the two-second recovered-state timer, which starts when the recovered pill becomes visible after the hold.
 
 ### Document availability
 

package/README.zh.md

@@ -25,7 +25,7 @@ kind: "package-reference"
 <a id="use-this-package"></a>
 ## 使用本包
 
-用户通过侧边栏底部的 Settings 控件进入外壳；功能插件通过本外壳所投影的 slot 账本贡献自己的页面与引导步骤。在展开侧边栏和收起轨道中，该控件都会把本地化的 Settings 文案作为其可访问名称。Settings 右侧浅黄色的**连接异常**操作表示浏览器离线暂停；自动恢复期间显示**自动重连中**，其后一至三个点每 500ms 前进一次。鼠标悬浮或键盘聚焦任一黄色状态时，只有文案变为**立即重连**，背景保持不变；按压反馈留在黄色色阶内，选中后立即从 retry 1 开始。恢复后该区域变为浅绿色的**连接成功**，驻留 2 秒再消失。所有可见状态的文字都左对齐，且图标、文字起点、高度和宽度保持固定。首次启动与未曾中断的健康连接保持静默。外壳渲染模态面板、由 `settings.section` 条目构建的导航，以及每次只挂载一个的引导步骤。
+用户通过侧边栏底部的 Settings 控件进入外壳；功能插件通过本外壳所投影的 slot 账本贡献自己的页面与引导步骤。在展开侧边栏和收起轨道中，该控件都会把本地化的 Settings 文案作为其可访问名称。Settings 右侧浅黄色的**连接异常**操作表示浏览器离线暂停；其常驻重试图形与中文文案「连接异常，刷新重试」都指明重试动作。每次恢复尝试都显示 spinner 加**重新连接中**，其后一至三个点每 500ms 前进一次，且每次尝试至少可见 800ms，短暂重试不会闪动。选中任一黄色状态都会立即发起重试；按压反馈留在黄色色阶内。恢复后该区域变为浅绿色的**连接成功**，从绿色药丸可见起驻留 2 秒再消失。药丸出现时淡入、移除时以 150ms 淡出，宽度随当前文案自适应。首次启动与未曾中断的健康连接保持静默。外壳渲染模态面板、由 `settings.section` 条目构建的导航，以及每次只挂载一个的引导步骤。
 
 ### 「通用」分区
 
@@ -55,11 +55,11 @@ kind: "package-reference"
 
 ### 连接恢复
 
-外壳是明确的恢复功能消费方，因此直接注入 Connection，而不把生命周期控制放进 `ctx.remote`。它的私有 hooks compartment 绑定 `ctx.connection.state`，组件只接收选出的状态与调用 `ctx.connection.reconnect()` 的注入回调。`ConnectionIndicator` 拥有内联展示并从 `settings` locale namespace 接收全部可见与无障碍文案；2 秒恢复状态计时器归外壳所有。
+外壳是明确的恢复功能消费方，因此直接注入 Connection，而不把生命周期控制放进 `ctx.remote`。它的私有 hooks compartment 绑定 `ctx.connection.state`，组件只接收选出的状态与调用 `ctx.connection.reconnect()` 的注入回调。`ConnectionIndicator` 拥有内联展示并从 `settings` locale namespace 接收全部可见与无障碍文案；连接中状态的 800ms 最短可见驻留与 2 秒恢复确认计时器归外壳所有；恢复计时从驻留结束、恢复药丸实际可见时开始。
 
 ### 文档可用性
 
-在 loopback 页面上，Client 通过 `settings/describe` 加载提供方的 `hasDocument` 能力，且只有在 Host 确认可准备好一份由提供方持有的本地文档时才渲染配置文件操作。该操作调用无路径参数且经浏览器认证的 `settings/openSettingsDocument` Remote；Host 会再次解析提供方路径、在文档缺失时将其创建出来，并交给原生文本编辑器（macOS 上使用 `open -t`，绕过浏览器文件关联；Linux 和 Windows 上使用桌面文件关联；WSL 上经 `wslpath -w` 转换后使用 Windows 文件关联）。打开失败时该操作仍可使用，并渲染本地化错误。临时读取失败或 Host 拓扑变化后，重新打开对话框或重新连接会刷新可用性。非 loopback 页面保留 Client 策略，不提供该原生操作及其 settings 读取。
+在 loopback 页面上，Client 通过 `settings/describe` 加载提供方的 `hasDocument` 能力，且只有在 Host 确认可准备好一份由提供方持有的本地文档时才渲染**打开配置文件**操作。该操作调用无路径参数且经浏览器认证的 `settings/openSettingsDocument` Remote；Host 会再次解析提供方路径、在文档缺失时将其创建出来，并交给原生文本编辑器（macOS 上使用 `open -t`，绕过浏览器文件关联；Linux 和 Windows 上使用桌面文件关联；WSL 上经 `wslpath -w` 转换后使用 Windows 文件关联）。打开失败时该操作仍可使用，并渲染本地化错误。临时读取失败或 Host 拓扑变化后，重新打开对话框或重新连接会刷新可用性。非 loopback 页面保留 Client 策略，不提供该原生操作及其 settings 读取。
 
 ### 宿主端
 

package/lib/client.js

@@ -72,6 +72,8 @@ window.__ModuleLoader__.load({
 		* to the step, so a mounted-but-deciding step paints nothing here.
 		*/
 		const RECOVERY_CONFIRMATION_MS = 2e3;
+		/** Minimum visible time for the connecting pill; shorter attempts read as flicker. */
+		const CONNECTING_MIN_VISIBLE_MS = 800;
 		/** 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, {
@@ -86,6 +88,10 @@ window.__ModuleLoader__.load({
 				className: SettingsRoot_module_css_default.navIcon,
 				size: 16
 			});
+			if (id === "archived-sessions") return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconArchiveOutline20, {
+				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
@@ -181,6 +187,8 @@ window.__ModuleLoader__.load({
 			const [activeId, setActiveId] = (0, react.useState)(void 0);
 			const [completedOnboarding, setCompletedOnboarding] = (0, react.useState)(() => /* @__PURE__ */ new Set());
 			const [showRecovery, setShowRecovery] = (0, react.useState)(false);
+			const [holdConnecting, setHoldConnecting] = (0, react.useState)(false);
+			const connectingShownAt = (0, react.useRef)(void 0);
 			const triggerButton = (0, react.useRef)(null);
 			const wasOpen = (0, react.useRef)(open);
 			const close = (0, react.useCallback)(() => {
@@ -214,12 +222,34 @@ window.__ModuleLoader__.load({
 				}
 				if (previous !== "disconnected" && previous !== "connecting") return;
 				setShowRecovery(true);
+			}, [connectionState]);
+			(0, react.useLayoutEffect)(() => {
+				if (!showRecovery || holdConnecting) return;
 				const timeout = window.setTimeout(() => {
 					setShowRecovery(false);
 				}, RECOVERY_CONFIRMATION_MS);
 				return () => {
 					window.clearTimeout(timeout);
 				};
+			}, [showRecovery, holdConnecting]);
+			(0, react.useLayoutEffect)(() => {
+				if (connectionState === "connecting") {
+					connectingShownAt.current = Date.now();
+					return;
+				}
+				const shownAt = connectingShownAt.current;
+				if (shownAt === void 0) return;
+				connectingShownAt.current = void 0;
+				const remaining = CONNECTING_MIN_VISIBLE_MS - (Date.now() - shownAt);
+				if (remaining <= 0) return;
+				setHoldConnecting(true);
+				const timeout = window.setTimeout(() => {
+					setHoldConnecting(false);
+				}, remaining);
+				return () => {
+					window.clearTimeout(timeout);
+					setHoldConnecting(false);
+				};
 			}, [connectionState]);
 			const completeOnboardingStep = (0, react.useCallback)((id) => {
 				setCompletedOnboarding((previous) => {
@@ -228,8 +258,8 @@ window.__ModuleLoader__.load({
 				});
 			}, []);
 			let connectionIndicator;
-			if (connectionState === "disconnected") connectionIndicator = "disconnected";
-			else if (connectionState === "connecting") connectionIndicator = "connecting";
+			if (connectionState === "connecting" || holdConnecting) connectionIndicator = "connecting";
+			else if (connectionState === "disconnected") connectionIndicator = "disconnected";
 			else if (showRecovery) connectionIndicator = "recovered";
 			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
 				(0, react_jsx_runtime.jsxs)("div", {
@@ -248,7 +278,6 @@ window.__ModuleLoader__.load({
 					}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.ConnectionIndicator, {
 						state: wide ? connectionIndicator : void 0,
 						disconnectedLabel: t("connection.error"),
-						reconnectLabel: t("connection.retry"),
 						connectingLabel: t("connection.connecting"),
 						recoveredLabel: t("connection.connected"),
 						reconnectActionLabel: t("connection.reconnect"),
@@ -486,12 +515,11 @@ window.__ModuleLoader__.load({
 			"openDocument": "打开配置文件",
 			"openDocument.error": "无法打开配置文件",
 			"general.nav": "通用设置",
-			"connection.error": "连接异常",
-			"connection.retry": "立即重连",
-			"connection.connecting": "自动重连中",
+			"connection.error": "连接异常，刷新重试",
+			"connection.connecting": "重新连接中",
 			"connection.connected": "连接成功",
 			"connection.reconnect": "连接异常，点击立即重连",
-			"connection.restart": "连接中断，正在自动重试，点击立即重连"
+			"connection.restart": "连接中断，正在重试，点击立即重连"
 		};
 		/** English dictionary, checked complete against the zh key set. */
 		const en = {
@@ -502,11 +530,10 @@ window.__ModuleLoader__.load({
 			"openDocument.error": "Could not open configuration file",
 			"general.nav": "General",
 			"connection.error": "Disconnected",
-			"connection.retry": "Reconnect now",
 			"connection.connecting": "Reconnecting",
 			"connection.connected": "Connected",
 			"connection.reconnect": "Disconnected, reconnect now",
-			"connection.restart": "Reconnecting automatically, reconnect now"
+			"connection.restart": "Reconnecting, reconnect now"
 		};
 		//#endregion
 		//#region lib/types/client/index.js

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

@@ -8,7 +8,6 @@ export declare const zh: {
     'openDocument.error': string;
     'general.nav': string;
     'connection.error': string;
-    'connection.retry': string;
     'connection.connecting': string;
     'connection.connected': string;
     'connection.reconnect': string;
@@ -25,7 +24,6 @@ export declare const en: {
     'openDocument.error': string;
     'general.nav': string;
     'connection.error': string;
-    'connection.retry': string;
     'connection.connecting': string;
     'connection.connected': string;
     'connection.reconnect': string;

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.1.5-rc.2",
+  "version": "0.1.6-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -46,21 +46,22 @@
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
-    "react": "^18.2.0",
     "clsx": "^2.0.0",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2",
+    "react": "^18.2.0",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2"
+    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-remote-mock": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.6-alpha.1"
   },
   "files": [
     "lib/index.js",