@deepseek-ai/dsh-client-ui-dockkit 0.1.7-rc.2 → 0.2.0-rc.1

package/README.i18n.yaml

@@ -18,8 +18,8 @@
   en: ea872ff2c2089037
   zh: b3ec3a218eacd5c8
 /deepseek-ai-dsh-client-ui-dockkit/embedding-it:
-  en: 789c879dd83f463a
-  zh: 37f2dc45f9588810
+  en: 47b9852393643b6a
+  zh: ce5f2ab60eec9564
 /deepseek-ai-dsh-client-ui-dockkit/interaction-rules-worth-keeping:
   en: 7e5c1e9a9f9f244f
   zh: 7e3a8fcef86bc7dd

package/README.md

@@ -60,7 +60,7 @@ A tab's `kind` is an opaque string. Seeded tabs are factories (`DockControllerOp
 
 `DockLayout`, used by the Sidebar, keeps each tab in a stable DOM cell across selection, pane moves and floating. It accepts one docked pane or two horizontal panes; CSS Grid resolves their widths. `keepMounted(tab)` retains visited bodies and `active` controls Session visibility without reparenting content.
 
-`DockSurface` is the docked area for the separate recursive renderer. Chrome around it — a rail, a collapsed presentation, any history controls — belongs to the embedder, which reads `state.expanded` and decides; the kit ships no undo/redo control of its own. Surface-wide controls the embedder does want on the surface go through the `chrome` prop, which the kit places at the far end of the top-right pane's tab strip (the last child of every row split, the first of every column split), so a surface needs no header row of its own. `FloatLayer` owns its own gestures and positions panels in viewport coordinates, so it may be mounted anywhere, including a portal.
+`DockSurface` is the docked area for the separate recursive renderer. Chrome around it — a rail, a collapsed presentation, any history controls — belongs to the embedder, which reads `state.expanded` and decides; the kit ships no undo/redo control of its own. Surface-wide controls the embedder does want on the surface go through the `chrome` prop, which the kit places at the far end of the top-right pane's tab strip (the last child of every row split, the first of every column split), so a surface needs no header row of its own. `FloatLayer` owns its own gestures and positions panels in viewport coordinates, so it may be mounted anywhere, including a portal. Both float renderers keep the header at least 20px below the Windows caption (20px below the viewport top in native fullscreen), including newly opened and restored panels. Dragging and resizing start at the displayed position.
 
 <a id="interaction-rules-worth-keeping"></a>
 ## Interaction rules worth keeping

package/README.zh.md

@@ -60,7 +60,7 @@ tab 的 `kind` 是不透明字符串。种子 tab 是工厂（`DockControllerOpt
 
 Sidebar 使用的 `DockLayout` 在选中项变化、跨格移动与浮动期间，把每个 tab 保留在稳定的 DOM 容器中。它接受一个停靠格或左右两个格，由 CSS Grid 计算宽度。`keepMounted(tab)` 保留已访问正文，`active` 控制 Session 可见性，不改变内容的父子关系。
 
-`DockSurface` 是独立递归渲染器的停靠区。它周围的 chrome——轨道、折叠形态、任何历史控件——属于嵌入方，由嵌入方读取 `state.expanded` 后自行决定；套件不自带撤销/重做控件。嵌入方确实想放到面上的整面控件通过 `chrome` prop 传入，套件把它放在右上格 tab 条的最末端（每个横向分裂的最后一个子节点、每个纵向分裂的第一个子节点），因此停靠面不需要自己的标题行。`FloatLayer` 拥有自己的手势并以视口坐标定位浮窗，因此可以挂在任何位置，包括 portal 里。
+`DockSurface` 是独立递归渲染器的停靠区。它周围的 chrome——轨道、折叠形态、任何历史控件——属于嵌入方，由嵌入方读取 `state.expanded` 后自行决定；套件不自带撤销/重做控件。嵌入方确实想放到面上的整面控件通过 `chrome` prop 传入，套件把它放在右上格 tab 条的最末端（每个横向分裂的最后一个子节点、每个纵向分裂的第一个子节点），因此停靠面不需要自己的标题行。`FloatLayer` 拥有自己的手势并以视口坐标定位浮窗，因此可以挂在任何位置，包括 portal 里。 两种浮窗渲染器都让标题栏与 Windows 顶栏至少间隔 20px（原生全屏时距视口顶部 20px），新建和恢复的浮窗均适用。拖动和调整大小从实际显示位置开始。
 
 <a id="interaction-rules-worth-keeping"></a>
 ## 值得保留的交互规则

package/lib/components/dockkit.module.css

@@ -739,6 +739,14 @@
   height: 40%;
 }
 
+:global(html[data-windows-titlebar]) .float {
+  --dsh-dockkit-float-top: calc(var(--dsh-windows-titlebar-height) + 20px);
+}
+
+:global(html[data-windows-titlebar][data-fullscreen]) .float {
+  --dsh-dockkit-float-top: 20px;
+}
+
 .float {
   position: fixed;
   display: flex;

package/lib/index.js

@@ -2877,11 +2877,19 @@ function useFloatGestures(state, intents) {
 	/** Start a move or resize from a press on the panel's grip or corner; a release that moved nothing is a click. */
 	const drag = (mode, paneId, event) => {
 		event.stopPropagation();
+		const root = document.documentElement;
+		const windows = root.hasAttribute("data-windows-titlebar");
+		const caption = windows && !root.hasAttribute("data-fullscreen") ? Number.parseFloat(root.style.getPropertyValue("--dsh-windows-titlebar-height")) : 0;
+		const saved = floatRect(getPane(state, paneId));
+		const rect = {
+			...saved,
+			y: Math.max(saved.y, windows ? caption + 20 : 0)
+		};
 		const start = {
 			mode,
 			originX: event.clientX,
 			originY: event.clientY,
-			rect: floatRect(getPane(state, paneId))
+			rect
 		};
 		begin(event.currentTarget, event.pointerId, {
 			move: (moved) => {
@@ -2978,7 +2986,7 @@ function FloatLayer({ state, intents, labels, renderTab, renderTabTitle, canClos
 			"data-dockkit-float-active": state.activePaneId === paneId || void 0,
 			style: {
 				left: live.x,
-				top: live.y,
+				top: `max(var(--dsh-dockkit-float-top, 0px), ${live.y}px)`,
 				width: live.width,
 				height: live.height,
 				zIndex: lifted === void 0 ? depth + 1 : state.floats.length + 1
@@ -3084,7 +3092,7 @@ function TabHost({ state, callbacks, intents, tab, pane, column, floats, focusRe
 			"data-dockkit-column": !floating ? column : void 0,
 			style: rect === void 0 ? void 0 : {
 				left: rect.x,
-				top: rect.y,
+				top: `max(var(--dsh-dockkit-float-top, 0px), ${rect.y}px)`,
 				width: rect.width,
 				height: rect.height
 			},

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-dockkit",
   "description": "Docking layout kit: split-tree engine with invertible operations, and the React components that render and drive it (zero cordis)",
-  "version": "0.1.7-rc.2",
+  "version": "0.2.0-rc.1",
   "publishConfig": {
     "access": "public"
   },
@@ -29,9 +29,9 @@
     "react-dom": "^18.2.0",
     "react": "^18.2.0",
     "clsx": "^2.0.0",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-brand": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-brand": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
+    "@deepseek-ai/cordis": "~4.0.4"
   },
   "files": [
     "lib/index.js",