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

package/README.i18n.yaml

@@ -1,6 +1,40 @@
-# 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-dockkit/README.md
-README.md: 613cdbcb105108eb848160f1cb6bc8ee28d39fac
-README.zh.md: 77b256f01dd46aea5144e9f8da644fd39330f187
+/:
+  en: 93fc2e9e86fc50f8
+  zh: 61c7c38a66935ad6
+/deepseek-ai-dsh-client-ui-dockkit:
+  en: 9d34bd85fc9e76b4
+  zh: 615d1d2eab451c87
+/deepseek-ai-dsh-client-ui-dockkit/summary:
+  en: 3ee4584a73215ef4
+  zh: 051170a6d0993fa5
+/deepseek-ai-dsh-client-ui-dockkit/table-of-contents:
+  en: 42038fdc402b9c2a
+  zh: 99890f8f908624ce
+/deepseek-ai-dsh-client-ui-dockkit/the-two-layers:
+  en: ea872ff2c2089037
+  zh: b3ec3a218eacd5c8
+/deepseek-ai-dsh-client-ui-dockkit/embedding-it:
+  en: 789c879dd83f463a
+  zh: 37f2dc45f9588810
+/deepseek-ai-dsh-client-ui-dockkit/interaction-rules-worth-keeping:
+  en: 7e5c1e9a9f9f244f
+  zh: 7e3a8fcef86bc7dd
+/deepseek-ai-dsh-client-ui-dockkit/build-shape:
+  en: 21216ba5798d7f5f
+  zh: ac505fdcd5c114d4
+/deepseek-ai-dsh-client-ui-dockkit/model-experience:
+  en: cdebb91645623401
+  zh: fe262db316714fa8
+/deepseek-ai-dsh-client-ui-dockkit/model-experience/kv-cache-effect:
+  en: ca75c51c89c2c9b0
+  zh: f57cc48a1b5cbfa9
+/deepseek-ai-dsh-client-ui-dockkit/known-limitations-and-deferred-work:
+  en: 4323810ca5a87e6c
+  zh: 3a24af2ea4467ab7
+/deepseek-ai-dsh-client-ui-dockkit/known-limitations-and-deferred-work/dev-note:
+  en: 9eda9e1ea3785ca7
+  zh: b734eb644b27e474

package/README.md

@@ -39,6 +39,8 @@ A docking layout kit: a split tree of tabbed panes with invertible operations, a
 
 **The components** render a layout snapshot and report settled intents — one per gesture, never a drag frame. A drag previews in local state while the gesture's own facts stay in its closure; on release the net result leaves through one `DockIntents` call — a strip release reports the caret slot as drawn, the dragged chip counted, and `planPlaceTab` turns that into the reorder or the move. That is what lets an embedder record exactly one history entry per gesture. The strip follows the WAI-ARIA tabs pattern with manual activation: the selected chip is in the tab order; Left and Right (wrapping), Home, and End move focus between chips without selecting; Enter or Space selects the focused chip through the same intent as a click. A chip is a capsule carrying one control, its close; the context menu (a secondary press on the chip) carries the same close plus the embedder's items — a menu that would hold no item at all never shows — and renders in a portal positioned against the chip because the chip box clips its overflow on purpose (see below). After the chips sits the add control, which asks the embedder (`DockIntents.addTab`) to seat its seeded tab; the embedder's `canAddTab(paneId)` decides per pane whether the control is drawn at all. Copying a tab has no kit control — it is the embedder's API — and floating is the drag released clear of the surface.
 
+Tab context menus show the close action name without a shortcut hint: they act on the clicked tab, while shortcuts can target another focused pane. An unmodified Escape dismisses the foreground tab menu without closing the tab and returns focus from a menu item to its tab without drawing a focus outline. Tab and arrow navigation retain the tab’s visible focus indicator. Composition and held-key repeats do not dismiss it.
+
 <a id="embedding-it"></a>
 ## Embedding it
 
@@ -63,6 +65,8 @@ A tab's `kind` is an opaque string. Seeded tabs are factories (`DockControllerOp
 <a id="interaction-rules-worth-keeping"></a>
 ## Interaction rules worth keeping
 
+The split control accepts localized tooltip text, separate effective keys through `splitPaneKeys`, and an ARIA combination from its embedder. Close controls receive their keys through `closeTabKeys`. A disabled control has a keyboard-focusable wrapper that explains the pane-budget or width restriction. Docked and floating pane containers can receive programmatic focus without entering the normal tab sequence or drawing a focus outline; their controls retain their own keyboard focus indicators. Tab navigation and selection use unmodified keys and leave composition input to its owner.
+
 These are not stylistic; each one fixes a defect found in a real browser.
 
 - **Capture the pointer** when a gesture starts. Without it any scroll container the pointer crosses can claim the gesture, which the browser reports as a cancelled pointer and an abandoned drag. Capture is hardening — the window listeners carry the gesture either way, so an environment without the API still works.
@@ -99,11 +103,15 @@ None; this package neither assembles nor sends a provider request.
 <a id="dev-note"></a>
 ### Dev Note
 
+Menus use the shared `MenuSurface` material, including the macOS backing for background blur; custom content follows the [menu rules](../../../docs/web-styling.md#component-rules).
+
 <details>
 <summary>Working context for maintainers — click to expand</summary>
 
 None.
 
+The embedder supplies effective close keycaps and ARIA combinations for tab and floating close controls. Close controls expose the same tooltip on hover and keyboard focus. Tab close tooltips stay hidden while their pane's context menu is open.
+
 </details>
 
 **Runtime invariant:** No companion is published. The engine is pure functions over plain data and the components report intents only; the operation sequence's invertibility and the settle rule are asserted directly by this package's engine specs, and no cordis service is provided or observed.

package/README.zh.md

@@ -39,6 +39,8 @@ kind: "package-reference"
 
 **组件**渲染布局快照并上报已落定的意图——每次手势一条，绝不上报拖动帧。拖动过程中在本地状态里预览，手势自身的事实留在它的闭包里；松手时净结果通过一次 `DockIntents` 调用离开——在标签条上松手上报的是按绘制顺序数出的插入槽位（被拖的 chip 也计入），由 `planPlaceTab` 换算成重排或移动。正是这一点让嵌入方能为每次手势记录恰好一条历史。标签条遵循 WAI-ARIA tabs 模式的手动激活：选中的 chip 在 Tab 键序里；左右方向键（循环）、Home、End 只在 chip 之间移动焦点而不选中；Enter 或空格选中当前聚焦的 chip，走与点击相同的意图。chip 是一个胶囊，携带唯一的控件——它的关闭按钮；上下文菜单（在 chip 上的次键按下）携带同样的关闭项加上嵌入方的条目——一个连一项都没有的菜单绝不展示——并渲染在按 chip 定位的 portal 里，因为 chip 盒会故意裁掉溢出（见下文）。chip 之后是添加控件，它请嵌入方（`DockIntents.addTab`）安放其种子 tab；嵌入方的 `canAddTab(paneId)` 按格决定是否绘制该控件。复制 tab 没有套件控件——那是嵌入方的 API——而浮出就是把拖动松手在停靠区之外。
 
+标签上下文菜单只显示关闭操作名，不显示快捷键：菜单操作针对被点击的标签，快捷键则可能作用于其他焦点分栏。无修饰键的 Esc 关闭前台标签菜单而不关闭标签，并将菜单项的焦点交还标签，不绘制焦点外轮廓线。Tab 和方向键导航保留标签页的可见焦点提示。输入法组合输入和长按重复事件不关闭菜单。
+
 <a id="embedding-it"></a>
 ## 如何嵌入
 
@@ -63,6 +65,8 @@ Sidebar 使用的 `DockLayout` 在选中项变化、跨格移动与浮动期间
 <a id="interaction-rules-worth-keeping"></a>
 ## 值得保留的交互规则
 
+分栏控件接收嵌入方传入的本地化提示文本、`splitPaneKeys` 独立按键及 ARIA 组合。关闭控件通过 `closeTabKeys` 接收按键。禁用控件由可键盘聚焦的容器承载，说明分栏数量或宽度限制。停靠与浮动面板容器支持程序设置焦点，不进入正常 Tab 顺序，也不绘制焦点外框；内部控件保留各自的键盘焦点提示。标签导航和选择只使用无修饰键组合，输入法按键交回其所属输入区域。
+
 这些不是风格偏好；每一条都修复了在真实浏览器里发现的缺陷。
 
 - **手势开始时捕获指针。** 不捕获的话，指针经过的任何滚动容器都可能接管手势，浏览器会将其报告为指针取消和拖动中止。捕获是加固——无论如何都由 window 监听器承载手势，所以没有该 API 的环境照样可用。
@@ -99,11 +103,15 @@ Sidebar 使用的 `DockLayout` 在选中项变化、跨格移动与浮动期间
 <a id="dev-note"></a>
 ### 开发备注
 
+菜单采用共享 `MenuSurface` 材质，包括用于背景模糊的 macOS 底层；自定义内容遵循[菜单规则](../../../docs/web-styling.zh.md#component-rules)。
+
 <details>
 <summary>维护者工作上下文——点击展开</summary>
 
 无。
 
+嵌入方为标签和浮动面板的关闭控件提供有效关闭键帽及 ARIA 组合。关闭控件在悬停和键盘聚焦时显示相同 Tooltip。分栏的上下文菜单打开时，该分栏的标签关闭 Tooltip 保持隐藏。
+
 </details>
 
 **运行时不变量：** 不发布 companion。引擎是作用于纯数据的纯函数，组件只上报意图；操作序列的可逆性与 settle 规则由本包的引擎 spec 直接断言，不提供也不观察任何 Cordis 服务。

package/lib/components/dockkit.module.css

@@ -215,6 +215,11 @@
   overflow: hidden;
 }
 
+.pane:focus,
+.float:focus {
+  outline: none;
+}
+
 /* A 38px row whose 28px content band sits at its bottom: chips fill the band,
    so they end flush with the strip's bottom edge, and the 28px add control, the
    28px split control, and the embedder's 28px chrome centre on the band's one
@@ -297,16 +302,17 @@
   margin-left: 4px;
 }
 
-/* macOS desktop: an embedder may pin this surface under the window's top drag
-   band (ui-layout .leadingBand — full-window geometry that Electron composes
-   in DOM order, not by stacking). The chip run, the strip-end chrome, the
-   pane body, and the split divider subtract their whole boxes so tabs,
-   controls, content, and the resize grab stay usable even where they overlap
-   the band; the strip's blank fill and top inset keep the band's drag, so the
-   row moves the window like a native tab bar. The divider must be named here:
-   it is a plain div, so ui-web base.css's interactive-element subtraction
-   never matches it. Hidden surfaces contribute nothing: Blink skips
-   non-visible boxes when it collects draggable regions. */
+/* macOS desktop: an embedder may pin this surface at the window's top edge (the
+   right sidebar does, in both presentations). The strip row is marked
+   `data-window-drag` in markup (TabPanel), so ui-web base.css's single darwin
+   rule drags it over its own box; the chip run, the strip-end chrome, the pane
+   body, and the split divider subtract their whole boxes so tabs, controls,
+   content, and the resize grab stay usable wherever they overlap that row. The
+   divider must be named here: it is a plain div, so ui-web base.css's
+   interactive-element subtraction never matches it. A floating pane subtracts its
+   own box the same way, so the strip row never drags the window over it. Hidden
+   surfaces contribute nothing: Blink skips non-visible boxes when it collects
+   draggable regions. */
 :global(html[data-platform='darwin']) .stripTabs,
 :global(html[data-platform='darwin']) .stripChrome,
 :global(html[data-platform='darwin']) .paneBody,
@@ -334,8 +340,8 @@
   background: var(--dsw-alias-border-l4);
 }
 
-/* The active chip is a filled capsule and needs no rule against it: the two
-   slots beside it go blank, so the row reads as the capsule between bare
+/* The active chip is a filled tab and needs no rule against it: the two
+   slots beside it go blank, so the row reads as the tab between bare
    chips. A caret in either slot still draws. */
 .tabActive + .slot:not(.slotCaret)::before,
 .slot:not(.slotCaret):has(+ .tabActive)::before {
@@ -348,7 +354,7 @@
   background: var(--dsw-alias-brand-primary-new-colorprimary-new-color);
 }
 
-/* The chip: a 28px capsule whose title runs to the right inset. The close
+/* The chip: a 28px tab whose title runs to the right inset. The close
    control is not in the flow — it sits over the title's last 14px and shows
    while the chip is active, hovered, or holds focus — so a chip is the same
    width with and without it and nothing shifts on hover. */
@@ -365,7 +371,7 @@
   font-size: var(--dsh-content-font-size-secondary, 13px);
   line-height: 1;
   white-space: nowrap;
-  border-radius: 12px;
+  border-radius: var(--dsw-radius-sm);
   cursor: pointer;
   touch-action: none;
   user-select: none;
@@ -422,7 +428,7 @@
   line-height: 1;
   background: transparent;
   border: none;
-  border-radius: 20px;
+  border-radius: var(--dsw-radius-sm);
   cursor: pointer;
   opacity: 0;
   /* Hidden means untouchable too: without this a touch press on the chip's
@@ -439,7 +445,7 @@
   pointer-events: auto;
 }
 
-/* The chip's height and corner, so it reads as one more capsule in the row. */
+/* The chip's height and corner, so it reads as one more tab in the row. */
 .addTab {
   display: flex;
   flex: none;
@@ -452,7 +458,7 @@
   line-height: 1;
   background: transparent;
   border: none;
-  border-radius: 12px;
+  border-radius: var(--dsw-radius-sm);
   cursor: pointer;
 }
 
@@ -470,13 +476,13 @@
   background: var(--dsw-alias-interactive-bg-hover);
 }
 
-/* The active chip is the filled capsule, in the tag fill; the rest are bare text. */
+/* The active chip is the filled tab, in the tag fill; the rest are bare text. */
 .tabActive {
   color: var(--dsw-alias-label-primary);
   background: var(--dsw-alias-markdown-tag);
 }
 
-/* A pane's lone unclosable chip is a label, not a choice: no capsule, no
+/* A pane's lone unclosable chip is a label, not a choice: no tab, no
    hover fill — the primary ink on the pane's own ground. Its title never
    yields to a close control, so it keeps the clipped fade alone. */
 .tab.tabQuiet,
@@ -514,7 +520,7 @@
   line-height: 1;
   background: transparent;
   border: none;
-  border-radius: 28px;
+  border-radius: var(--dsw-radius-sm);
   cursor: pointer;
 }
 
@@ -544,11 +550,8 @@
   display: flex;
   flex-direction: column;
   min-width: 96px;
-  padding: 3px;
-  background: var(--dsw-specific-menu);
-  backdrop-filter: var(--dsw-menu-backdrop-filter);
+  padding: 4px;
   border: 0.5px solid var(--dsw-alias-border-l2);
-  border-radius: 8px;
 }
 
 .menu:not(:has([role='menuitem'], [role='menuitemcheckbox'], [role='menuitemradio'])) {
@@ -562,7 +565,7 @@
   text-align: left;
   background: transparent;
   border: none;
-  border-radius: 5px;
+  border-radius: var(--dsw-radius-md);
   cursor: pointer;
 }
 
@@ -667,7 +670,7 @@
   overflow: hidden;
   color: var(--dsw-alias-label-tertiary);
   border: 1.5px dashed var(--dsw-alias-border-l2);
-  border-radius: 12px;
+  border-radius: var(--dsw-radius-lg);
   transition: color 120ms ease-out, background-color 120ms ease-out, border-color 120ms ease-out;
   animation: dockHintIn 140ms ease-out;
 }
@@ -744,7 +747,7 @@
      to its own corners. */
   overflow: hidden;
   background: var(--dsw-alias-bg-layer-2);
-  border-radius: 20px;
+  border-radius: var(--dsw-radius-panel);
   /* The menu's shadow with the stroke rebound one step lighter than the
      default (l2): the panel reads as the same kind of raised surface, and the
      shadow's hairline outlines it, so the frame draws no border of its own. */
@@ -801,20 +804,18 @@
   touch-action: none;
 }
 
-/* The grip is a quarter arc concentric with the frame's 20px corner (16px
-   radius at a 4px inset), so it reads as part of the frame. It shows only
-   while the pointer is over the panel — an idle panel keeps a clean corner —
-   and `:active` keeps it lit while a drag holds the pointer capture. */
+/* The grip follows the floating panel's corner with a 4px inset. Pointer
+   hover and an active drag reveal it. */
 .floatResize::after {
   content: '';
   position: absolute;
   right: 4px;
   bottom: 4px;
-  width: 16px;
-  height: 16px;
+  width: calc(var(--dsw-radius-panel) - 4px);
+  height: calc(var(--dsw-radius-panel) - 4px);
   border-right: 1.5px solid var(--dsw-alias-label-caption);
   border-bottom: 1.5px solid var(--dsw-alias-label-caption);
-  border-bottom-right-radius: 16px;
+  border-bottom-right-radius: calc(var(--dsw-radius-panel) - 4px);
   opacity: 0;
   transition: opacity 120ms ease-out;
 }

package/lib/index.js

@@ -1,7 +1,7 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Children, Fragment as Fragment$1, useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
 import clsx from "clsx";
-import { IconCloseFillRegular, IconCloseOutlineRegular, IconPanelLeftOutlineRegular, IconPlusOutlineRegular, Tooltip } from "@deepseek-ai/dsh-client-ui-primitives";
+import { IconCloseFillRegular, IconCloseOutlineRegular, IconPanelLeftOutlineRegular, IconPlusOutlineRegular, MenuSurface, Tooltip, focusWithoutRing, modalSelector, observeComposition } from "@deepseek-ai/dsh-client-ui-primitives";
 import { createPortal } from "react-dom";
 import css from "./components/dockkit.module.css";
 //#region lib/types/engine/tree.js
@@ -2230,7 +2230,7 @@ function useGesture(reset) {
 * released clear of the surface. A menu that would hold no item at all renders
 * no popup, so a secondary press on a chip with nothing to offer shows nothing.
 * Presentational — it renders what its props supply and dismisses itself on
-* outside presses.
+* outside presses or an unmodified Escape, returning menu focus to its tab.
 *
 * It renders in a portal, positioned against the control that opened it. The tab
 * strip clips its overflow on purpose (so it never becomes a scroll container
@@ -2264,17 +2264,35 @@ function TabMenu({ labels, anchor, onClose, onDismiss, extras }) {
 		const menu = self.current;
 		/* v8 ignore next -- the ref is attached by effect time: the menu renders unconditionally. */
 		if (menu === null) return void 0;
+		const document = menu.ownerDocument;
+		const composition = observeComposition(document);
+		const onKeyDown = (event) => {
+			if (composition.guards(event) || event.defaultPrevented || event.key !== "Escape" || event.ctrlKey || event.altKey || event.metaKey || event.shiftKey) return;
+			if ([...document.querySelectorAll(modalSelector)].at(-1) !== menu) return;
+			event.preventDefault();
+			if (event.repeat) return;
+			const restoreFocus = menu.contains(document.activeElement);
+			onDismiss();
+			if (restoreFocus) focusWithoutRing(anchor);
+		};
+		document.addEventListener("keydown", onKeyDown, true);
 		const onPointerDown = (event) => {
 			if (event.target instanceof Node && menu.contains(event.target)) return;
 			onDismiss();
 		};
 		window.addEventListener("pointerdown", onPointerDown, true);
 		return () => {
+			composition.dispose();
+			document.removeEventListener("keydown", onKeyDown, true);
 			window.removeEventListener("pointerdown", onPointerDown, true);
 		};
-	}, [onDismiss, hasItems]);
+	}, [
+		anchor,
+		onDismiss,
+		hasItems
+	]);
 	if (!hasItems) return null;
-	return createPortal(jsxs("div", {
+	return createPortal(jsxs(MenuSurface, {
 		className: css.menu,
 		ref: self,
 		role: "menu",
@@ -2565,6 +2583,7 @@ function TabStrip({ state, pane, callbacks }) {
 		className: css.tabStrip,
 		role: "tablist",
 		"data-dockkit-strip": pane.id,
+		"data-window-drag": state.floats.length === 0 ? true : void 0,
 		children: [
 			jsxs("div", {
 				ref: stripTabs,
@@ -2600,6 +2619,7 @@ function TabStrip({ state, pane, callbacks }) {
 						},
 						onKeyDown: (event) => {
 							if (event.target !== event.currentTarget) return;
+							if (event.altKey || event.ctrlKey || event.metaKey || event.shiftKey || event.nativeEvent.isComposing) return;
 							const next = chipToFocus(event.key, pane.tabs, tabId);
 							if (next !== void 0) {
 								event.preventDefault();
@@ -2621,19 +2641,27 @@ function TabStrip({ state, pane, callbacks }) {
 						},
 						children: [
 							jsx(TabTitle, { children: callbacks.renderTabTitle?.(tab) ?? tab.title }),
-							closable && jsx("button", {
-								type: "button",
-								className: css.tabClose,
-								"aria-label": callbacks.labels.closeTab,
-								"data-dockkit-tab-close": tabId,
-								onPointerDown: (event) => {
-									event.stopPropagation();
-								},
-								onClick: (event) => {
-									event.stopPropagation();
-									callbacks.onCloseTab(tabId);
-								},
-								children: jsx(IconCloseFillRegular, { size: 14 })
+							closable && jsx(Tooltip, {
+								disabled: menu !== void 0,
+								label: callbacks.labels.closeTab,
+								shortcutKeys: callbacks.labels.closeTabKeys,
+								side: "bottom",
+								delayMs: 500,
+								children: jsx("button", {
+									type: "button",
+									className: css.tabClose,
+									"aria-label": callbacks.labels.closeTab,
+									"aria-keyshortcuts": callbacks.labels.closeTabShortcut,
+									"data-dockkit-tab-close": tabId,
+									onPointerDown: (event) => {
+										event.stopPropagation();
+									},
+									onClick: (event) => {
+										event.stopPropagation();
+										callbacks.onCloseTab(tabId);
+									},
+									children: jsx(IconCloseFillRegular, { size: 14 })
+								})
 							}),
 							menu?.tabId === tabId && jsx(TabMenu, {
 								labels: callbacks.labels,
@@ -2677,23 +2705,27 @@ function TabStrip({ state, pane, callbacks }) {
 				"data-dockkit-strip-fill": true
 			}),
 			!(callbacks.hideSplitWhenBlocked && block !== void 0) && jsx(Tooltip, {
-				label: callbacks.labels.splitPane,
+				label: block === void 0 ? callbacks.labels.splitPane : splitBlockedTitle(callbacks.labels, block),
+				shortcutKeys: callbacks.labels.splitPaneKeys,
 				side: "bottom",
 				delayMs: 500,
-				disabled: block !== void 0,
-				children: jsx("button", {
-					type: "button",
-					className: css.iconButton,
-					"aria-label": callbacks.labels.splitPane,
-					title: block === void 0 ? void 0 : splitBlockedTitle(callbacks.labels, block),
-					disabled: block !== void 0,
-					"data-dockkit-split-button": pane.id,
-					"data-dockkit-split-blocked": block,
-					onClick: (event) => {
-						event.stopPropagation();
-						callbacks.onSplitPane(pane.id);
-					},
-					children: jsx(SplitGlyph, {})
+				children: jsx("span", {
+					tabIndex: block === void 0 ? void 0 : 0,
+					"aria-label": block === void 0 ? void 0 : splitBlockedTitle(callbacks.labels, block),
+					children: jsx("button", {
+						type: "button",
+						className: css.iconButton,
+						"aria-label": callbacks.labels.splitPane,
+						"aria-keyshortcuts": callbacks.labels.splitPaneShortcut,
+						disabled: block !== void 0,
+						"data-dockkit-split-button": pane.id,
+						"data-dockkit-split-blocked": block,
+						onClick: (event) => {
+							event.stopPropagation();
+							callbacks.onSplitPane(pane.id);
+						},
+						children: jsx(SplitGlyph, {})
+					})
 				})
 			}),
 			pane.id === callbacks.chromePaneId && callbacks.chrome !== void 0 && jsx("div", {
@@ -2735,6 +2767,7 @@ function TabPanel({ state, pane, callbacks }) {
 	return jsxs("section", {
 		className: css.pane,
 		"data-dockkit-pane": pane.id,
+		tabIndex: -1,
 		"data-dockkit-pane-active": state.activePaneId === pane.id || void 0,
 		onClick: () => {
 			if (state.activePaneId !== pane.id) callbacks.onFocusPane(pane.id);
@@ -2909,13 +2942,14 @@ function FloatHeader({ paneId, tab, labels, intents, renderTabTitle, canCloseTab
 				})
 			}),
 			(canCloseTab?.(tab.id) ?? true) && jsx(Tooltip, {
-				label: labels.closeFloat,
+				label: labels.closeTab,
+				shortcutKeys: labels.closeTabKeys,
 				side: "bottom",
 				delayMs: 500,
 				children: jsx("button", {
 					type: "button",
 					className: css.iconButton,
-					"aria-label": labels.closeFloat,
+					"aria-label": labels.closeTab,
 					"data-dockkit-float-close": paneId,
 					onPointerDown: (event) => {
 						event.stopPropagation();
@@ -2940,6 +2974,7 @@ function FloatLayer({ state, intents, labels, renderTab, renderTabTitle, canClos
 		return jsxs("div", {
 			className: css.float,
 			"data-dockkit-float": paneId,
+			tabIndex: -1,
 			"data-dockkit-float-active": state.activePaneId === paneId || void 0,
 			style: {
 				left: live.x,
@@ -3038,6 +3073,7 @@ function TabHost({ state, callbacks, intents, tab, pane, column, floats, focusRe
 		},
 		children: jsxs("section", {
 			ref: host,
+			tabIndex: -1,
 			className: clsx(css.tabHost, floating ? css.float : css.pane),
 			"aria-hidden": !visible || void 0,
 			"data-dockkit-content": tab.id,

package/lib/types/contract/adapter.d.ts

@@ -18,12 +18,20 @@ export interface DockLabels {
     readonly emptyPane: string;
     /** The split control, while splitting is allowed. */
     readonly splitPane: string;
+    /** ARIA combination from the effective binding, when bound. */
+    readonly splitPaneShortcut?: string | undefined;
+    /** Effective split keys shown as separate tooltip keycaps. */
+    readonly splitPaneKeys?: readonly string[] | undefined;
     /** The split control, once the pane budget is spent. */
     readonly splitPaneDisabled: string;
     /** The split control, while the pane is too narrow for two working halves. */
     readonly splitPaneNarrow: string;
     /** Destroy a tab: the chip's close control and the menu's close item. */
     readonly closeTab: string;
+    /** Effective close combination, when bound. */
+    readonly closeTabShortcut?: string | undefined;
+    /** Effective close keys shown as separate tooltip keycaps. */
+    readonly closeTabKeys?: readonly string[] | undefined;
     /** The strip's add control, which seats the embedder's seeded tab. */
     readonly addTab: string;
     /** Send a floating panel back into the docked tree. */

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-alpha.2",
+  "version": "0.1.7-rc.2",
   "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-alpha.2",
-    "@deepseek-ai/dsh-brand": "0.1.7-alpha.2",
-    "@deepseek-ai/cordis": "~4.0.4"
+    "@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"
   },
   "files": [
     "lib/index.js",