@deepseek-ai/dsh-client-ui-sidebar-files 0.1.5-rc.2 → 0.1.6-alpha.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-sidebar-files/README.md
-README.md: 28e052b5a6739118c691431aad88964a8f6d19cd
-README.zh.md: f9724c159e358658b0cf6d342b26e80e8c59cf01
+README.md: efaf0a584e0e8617d0cb97442f9ebb5fa1fe7b59
+README.zh.md: a0d0abffcd6e9f4e979d9a6548537745d0a74ba6

package/README.md

@@ -43,7 +43,7 @@ The root is the session's working directory, read from `useSessions().byId[sessi
 
 A level cut by the endpoint's entry cap ends with a marker; an empty level says so; a level that failed shows one line per code — `workspace-file/not-found`, `outside-workspace`, `not-directory` — and the transport's own message otherwise. Reload drops every listed level and asks again for the expanded ones; collapsed levels are fetched again when they next open. A session without a working directory shows a single line instead of a tree.
 
-State lives in the type's own store, bucketed by tab id: `root`, `levels` (loading / ready / failed per absolute path), and `expanded`. The owner's `signal` ends a bucket: on abort the tab is forgotten and a listing that settles afterwards writes nothing.
+State lives in the type's own store, bucketed by tab id: `root`, `levels` (loading / ready / failed per absolute path), `expanded`, and `scrollTop`, which the body tracks locally while scrolling and commits once when it unmounts. Because the store outlives the body, switching to another sidebar tab and back remounts the tree with its levels intact and its scroll offset restored. The owner's `signal` ends a bucket: on abort the tab is forgotten, and neither a listing that settles afterwards nor the unmount's offset commit writes anything.
 
 <a id="model-experience"></a>
 ## Model Experience

package/README.zh.md

@@ -1,5 +1,5 @@
 ---
-description: "dsh Web 客户端右侧 Sidebar 的文件树 tab 类型：逐层经线上列出会话工作区根目录，按资源地址把文件打开到 Sidebar。"
+description: "dsh Web 客户端右侧 Sidebar 的文件树 tab 类型：通过网络逐层列出会话工作区根目录，按资源地址把文件打开到 Sidebar。"
 kind: "package-reference"
 ---
 
@@ -25,25 +25,25 @@ kind: "package-reference"
 ## 注册了什么
 
 - **类型**：`ctx.sidebarRightTabs.register(...)`，kind 为 `files`，id 为 `@deepseek-ai/dsh-client-ui-sidebar-files`，档位 `builtin`，没有 patterns，另有一个打开该类型的引导页入口（order 10，标题与描述取自 `sidebarFiles` 命名空间，图标是共享的文件夹图标）。
-- **正文**：以该 id 为键的 `sidebar.right.pane.tab` 坑位：strip 下的一行标题行，然后是树。标题行与文档预览（`ui-sidebar-documentpreview`）的相同：根路径，目录部分灰色、最后一段正色，从不省略号截断（比行宽的路径保留末尾、淡出开头），右端是它唯一的控件、重新读取。这一行是复制而非共享，因为插件 bundle 只经平台模块共享运行时代码；待 artifact 与各 slot 的形态定下来后，可以在 `ui-primitives` 放一份供每个 pane 标题行使用。
-- **标签页标题**：以该 id 为键的 `sidebar.right.pane.tab.title` 坑位：类型标签前的一枚 16px 共享 `FileTypeIcon` 文件夹图标。树本身的行不画这枚图标。
+- **正文**：以该 id 为键的 `sidebar.right.pane.tab` slot：strip 下的一行标题行，然后是树。标题行与文档预览（`ui-sidebar-documentpreview`）的相同：根路径，目录部分灰色、最后一段正色，从不省略号截断（比行宽的路径保留末尾、淡出开头），右端是它唯一的控件、重新读取。这一行是复制而非共享，因为插件 bundle 只经平台模块共享运行时代码；待 artifact 与各 slot 的形态定下来后，可以在 `ui-primitives` 放一份供每个 pane 标题行使用。
+- **标签页标题**：以该 id 为键的 `sidebar.right.pane.tab.title` slot：类型标签前的一枚 16px 共享 `FileTypeIcon` 文件夹图标。树本身的行不画这枚图标。
 
 `src/client/` 下七个源文件：`definition.tsx`（类型是什么）、`store.ts`（它保存什么）、`face.ts`（它如何列目录，含 Remote 绑定）、`FilesBody.tsx`（它画什么，含排序与失败行两个辅助函数）、`FilesTitle.tsx`（标签页标题）、`locales.ts`（它说什么）、`index.ts`（接线）。
 
 <a id="the-tree"></a>
 ## 树
 
-根是会话的工作目录，读自 `useSessions().byId[sessionId].cwd`，标题行里的拆分由 `@deepseek-ai/dsh-util-workspace-path` 的 `pathPartsOf` 给出。每一层以绝对路径为键；子路径是父路径以 `/` 拼上条目名。一层在首次展开时经 `@deepseek-ai/dsh-api-workspace-files` 命名空间的 `remote.workspaceFiles.list(sessionId, absolutePath)` 列出；适配层保留列表的条目与截断标志，丢弃其工作区相对路径。行序为目录优先，其后按自然序、不分大小写的名称排列；dotfiles 与其他条目一样显示。
+根是会话的工作目录，读自 `useSessions().byId[sessionId].cwd`，标题行里的拆分由 `@deepseek-ai/dsh-util-workspace-path` 的 `pathPartsOf` 给出。每一层以绝对路径为键；子路径是父路径以 `/` 拼上条目名。一层在首次展开时经 `@deepseek-ai/dsh-api-workspace-files` 命名空间的 `remote.workspaceFiles.list(sessionId, absolutePath)` 列出；适配器保留列表的条目与截断标志，丢弃其工作区相对路径。行序为目录优先，其后按自然序、不分大小写的名称排列；dotfiles 与其他条目一样显示。
 
 | 条目类型 | 行 |
 |---|---|
 | `directory` | 切换展开与折叠；该层在首次打开时拉取，折叠期间保留。 |
 | `file` | 经 `useTabInfo().tab.actions.openResource` 打开 `dsh-resource://file/session/<sessionId>/<encoded path relative to the root>`，地址由 `@deepseek-ai/dsh-util-workspace-path` 的 `fileAddressFor` 从条目的绝对路径与树的根生成，落在该 tab 自己的 pane 里。 |
-| `other` | 灰显且不可点击，使目录被完整报告。 |
+| `other` | 灰显且不可点击，从而完整呈现目录内容。 |
 
 被端点条目上限截断的层以一条标记收尾；空层如实说明；失败的层按错误码各显示一行（`workspace-file/not-found`、`outside-workspace`、`not-directory`），其他情况显示传输层自己的消息。重新读取丢弃所有已列出的层并只对展开中的层重新请求；折叠的层在下次打开时重新拉取。没有工作目录的会话只显示一行说明，而不是树。
 
-状态住在类型自己的存储里，按 tab id 分桶：`root`、`levels`（每个绝对路径的 loading / ready / failed）与 `expanded`。owner 的 `signal` 终结一个桶：中止时忘掉该 tab，其后才结算的列表什么也不写。
+状态保存在类型自己的存储里，按 tab id 分桶：`root`、`levels`（每个绝对路径的 loading / ready / failed）、`expanded` 与 `scrollTop`——滚动期间偏移由正文自己记录，卸载时一次性写入。存储比 body 活得久，切到其他侧栏 tab 再切回来时树带着已加载的层重新挂载，滚动位置也随之恢复。owner 的 `signal` 终结一个桶：中止时忘掉该 tab，其后才结算的列表与卸载时的偏移提交都什么也不写。
 
 <a id="model-experience"></a>
 ## 模型体验

package/lib/client.js

@@ -33,6 +33,7 @@ window.__ModuleLoader__.load({
 				priority: "builtin",
 				title: () => t("type.label"),
 				guide: [{
+					id: "workspace",
 					order: 10,
 					title: () => t("guide.title"),
 					description: () => t("guide.description"),
@@ -422,7 +423,25 @@ window.__ModuleLoader__.load({
 			const state = useStore((store) => store.byTab[tab.id]);
 			const pathRef = (0, react.useRef)(null);
 			const pathTextRef = (0, react.useRef)(null);
+			const bodyRef = (0, react.useRef)(null);
+			const scrollTopRef = (0, react.useRef)(0);
 			usePathClipped(pathRef, pathTextRef, state?.root);
+			const seeded = state !== void 0;
+			(0, react.useLayoutEffect)(() => {
+				const body = bodyRef.current;
+				if (seeded && body !== null) {
+					body.scrollTop = state.scrollTop;
+					scrollTopRef.current = body.scrollTop;
+				}
+			}, [seeded]);
+			(0, react.useEffect)(() => () => {
+				if (seeded && !signal.aborted) actions.scrolled(tab.id, scrollTopRef.current);
+			}, [
+				seeded,
+				signal,
+				tab.id,
+				actions
+			]);
 			(0, react.useEffect)(() => {
 				if (state !== void 0 || cwd === void 0 || signal.aborted) return;
 				start(tab.id, cwd, signal);
@@ -489,7 +508,12 @@ window.__ModuleLoader__.load({
 						children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRefreshOutline16, {})
 					})]
 				}), (0, react_jsx_runtime.jsx)("div", {
+					ref: bodyRef,
 					className: FilesBody_module_css_default.body,
+					"data-files-body": true,
+					onScroll: (event) => {
+						scrollTopRef.current = event.currentTarget.scrollTop;
+					},
 					children: (0, react_jsx_runtime.jsx)("ul", {
 						className: FilesBody_module_css_default.level,
 						children: (0, react_jsx_runtime.jsx)(Level, {
@@ -552,8 +576,8 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region lib/types/client/store.js
 		/**
-		* The file tree's view state: which directories are expanded, and what each
-		* loaded level contains.
+		* The file tree's view state: which directories are expanded, what each
+		* loaded level contains, and where the body is scrolled to.
 		*
 		* The tree is not one resource. A directory listing per level, expanded lazily,
 		* is state the type owns — so it lives in a Slot-standard exclusive store
@@ -596,7 +620,8 @@ window.__ModuleLoader__.load({
 						d.byTab[tabId] = {
 							root,
 							levels: {},
-							expanded: [root]
+							expanded: [root],
+							scrollTop: 0
 						};
 					},
 					/**
@@ -649,6 +674,15 @@ window.__ModuleLoader__.load({
 						else state.expanded.push(path);
 					},
 					/**
+					* Record where one tab's body is scrolled to.
+					* @param d - draft state.
+					* @param tabId - the tab being drawn.
+					* @param scrollTop - the body's scroll offset, in px.
+					*/
+					scrolled: (d, tabId, scrollTop) => {
+						bucket(d, tabId).scrollTop = scrollTop;
+					},
+					/**
 					* Drop every loaded level, keeping what is expanded.
 					*
 					* This is the reload gesture's first half: the expanded set says which

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

@@ -1,6 +1,6 @@
 /**
- * The file tree's view state: which directories are expanded, and what each
- * loaded level contains.
+ * The file tree's view state: which directories are expanded, what each
+ * loaded level contains, and where the body is scrolled to.
  *
  * The tree is not one resource. A directory listing per level, expanded lazily,
  * is state the type owns — so it lives in a Slot-standard exclusive store
@@ -49,6 +49,8 @@ export interface FilesTabState {
     levels: Record<string, LevelState>;
     /** Expanded absolute directory paths, root included. */
     expanded: string[];
+    /** The body's scroll offset in px, so a remounted tree comes back where the reader was. */
+    scrollTop: number;
 }
 /** Every tab's tree, keyed by tab id. */
 export interface FilesState {
@@ -61,6 +63,7 @@ type FilesActions = {
     loaded: (draft: FilesState, tabId: TabId, path: string, level: DirLevel) => void;
     failed: (draft: FilesState, tabId: TabId, path: string, failure: RemoteFailure) => void;
     toggled: (draft: FilesState, tabId: TabId, path: string) => void;
+    scrolled: (draft: FilesState, tabId: TabId, scrollTop: number) => void;
     reset: (draft: FilesState, tabId: TabId) => void;
     forget: (draft: FilesState, tabId: TabId) => void;
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-sidebar-files",
   "description": "Workspace file tree tab type for the right Sidebar: lazy directory listing over the workspaceFiles Remote namespace, opening files into the Sidebar",
-  "version": "0.1.5-rc.2",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -48,19 +48,19 @@
     "clsx": "^2.0.0",
     "react-dom": "^18.2.0",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-api-workspace-files": "^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-dockkit": "^0.1.5-rc.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-sidebar-right": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-workspace-path": "^0.1.5-rc.2"
+    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-api-workspace-files": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-dockkit": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2"
   },
   "files": [
     "lib/index.js",