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

package/lib/types/components/DockSurface.d.ts

@@ -2,6 +2,7 @@ import type { ReactNode } from 'react';
 import type { DockIntents, DockLabels, TabMenuExtras, TabRenderer } from '../contract/adapter.ts';
 import type { LayoutState, PaneId, TabId } from '../contract/types.ts';
 import type { HalvesFit } from '../engine/geometry.ts';
+import { type TabRetention } from './TabLayout.tsx';
 /** What the docked surface needs: the layout, its limits, and the outward contracts. */
 export interface DockSurfaceProps {
     readonly state: LayoutState;
@@ -55,6 +56,14 @@ export interface DockSurfaceProps {
      */
     readonly onRoom?: (fits: ReadonlyMap<PaneId, HalvesFit>) => void;
 }
-/** The split tree and the gestures over it. */
-export declare function DockSurface({ state, canSplit, canAddTab, canCloseTab, intents, labels, renderTab, renderTabTitle, renderTabMenuItems, chrome, onRoom, dropZones, minPaneFraction, hideSplitWhenBlocked, }: DockSurfaceProps): ReactNode;
+/** Recursive docked layout; floating content is rendered separately by FloatLayer. */
+export declare function DockSurface(props: DockSurfaceProps): ReactNode;
+/** Horizontal Sidebar layout with stable tab containers across docking and floating. */
+export type DockLayoutProps = DockSurfaceProps & TabRetention;
+/**
+ * Render one pane or two horizontal panes, and their floats, in one stable content tree.
+ * @param props - layout, gestures and lazy body-retention policy.
+ * @returns the layout; the containing ancestors must not clip or establish a fixed-position containing block.
+ */
+export declare function DockLayout(props: DockLayoutProps): ReactNode;
 //# sourceMappingURL=DockSurface.d.ts.map

package/lib/types/components/FloatLayer.d.ts

@@ -1,6 +1,6 @@
-import type { ReactNode } from 'react';
+import type { PointerEvent as ReactPointerEvent, ReactNode } from 'react';
 import type { DockIntents, DockLabels, TabRenderer } from '../contract/adapter.ts';
-import type { LayoutState, TabId } from '../contract/types.ts';
+import type { FloatRect, LayoutState, PaneId, TabId, TabRecord } from '../contract/types.ts';
 /** The layout whose `floats` this layer draws. */
 export interface FloatLayerProps {
     readonly state: LayoutState;
@@ -12,6 +12,34 @@ export interface FloatLayerProps {
     /** The panel header's title content; omit to show the record's `title` text (see `DockSurfaceProps`). */
     readonly renderTabTitle?: TabRenderer;
 }
+/**
+ * Shared move/resize gestures; changing layout mode never owns the content DOM.
+ * @param state - committed layout and float stacking order.
+ * @param intents - gesture settlements.
+ * @returns the current preview and focus/gesture callbacks.
+ */
+export declare function useFloatGestures(state: LayoutState, intents: DockIntents): {
+    preview: {
+        paneId: PaneId;
+        rect: FloatRect;
+    } | undefined;
+    raise: (paneId: PaneId) => void;
+    drag: (mode: "move" | "resize", paneId: PaneId, event: ReactPointerEvent<HTMLElement>) => void;
+};
+/**
+ * Header-only controls, usable above either retained or visibility-mounted bodies.
+ * @param props - owning pane/tab, localized labels and gesture callbacks.
+ * @returns the float header without a content container.
+ */
+export declare function FloatHeader({ paneId, tab, labels, intents, renderTabTitle, canCloseTab, drag }: {
+    readonly paneId: PaneId;
+    readonly tab: TabRecord;
+    readonly labels: DockLabels;
+    readonly intents: DockIntents;
+    readonly renderTabTitle: TabRenderer | undefined;
+    readonly canCloseTab: ((id: TabId) => boolean) | undefined;
+    readonly drag: ReturnType<typeof useFloatGestures>['drag'];
+}): ReactNode;
 /** Every floating panel, in z order. */
 export declare function FloatLayer({ state, intents, labels, renderTab, renderTabTitle, canCloseTab }: FloatLayerProps): ReactNode;
 //# sourceMappingURL=FloatLayer.d.ts.map

package/lib/types/components/TabLayout.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from 'react';
+import type { DockIntents } from '../contract/adapter.ts';
+import type { LayoutState, TabRecord } from '../contract/types.ts';
+import type { SizePreview } from './PaneTree.tsx';
+import type { PaneCallbacks } from './render.ts';
+/** Host policy for lazily retaining a tab body without reparenting it. */
+export interface TabRetention {
+    /** Whether a visited body survives hiding; omitted means visibility-mounted. */
+    readonly keepMounted?: (tab: TabRecord) => boolean;
+    /** Whether this layout's Session is on screen; defaults to true. */
+    readonly active?: boolean;
+}
+interface LayoutProps extends TabRetention {
+    readonly state: LayoutState;
+    readonly callbacks: PaneCallbacks;
+    readonly preview: SizePreview | undefined;
+    readonly intents: DockIntents;
+}
+/**
+ * One or two horizontal panes; CSS resolves content sizes from track fractions.
+ * @param props - committed layout, gesture preview and body retention policy.
+ * @returns stable tab containers, including floating tabs.
+ * @throws if the docked tree is not one pane or two horizontal panes.
+ */
+export declare function TabLayout(props: LayoutProps): ReactNode;
+export {};
+//# sourceMappingURL=TabLayout.d.ts.map

package/lib/types/components/TabPanel.d.ts

@@ -7,6 +7,10 @@ export interface TabPanelProps {
     readonly pane: PaneNode;
     readonly callbacks: PaneCallbacks;
 }
-/** The pane's tab strip, split control, and body. */
+/** @param props - pane state and gestures. @returns its tab strip without a content container. */
+export declare function TabStrip({ state, pane, callbacks }: TabPanelProps): ReactNode;
+/** @param props - target pane and drag preview. @returns body-local drop feedback, or nothing. */
+export declare function PaneDropHints({ pane, callbacks }: Pick<TabPanelProps, 'pane' | 'callbacks'>): ReactNode;
+/** @param props - pane state and gestures. @returns one pane in the recursive, visibility-mounted layout. */
 export declare function TabPanel({ state, pane, callbacks }: TabPanelProps): ReactNode;
 //# sourceMappingURL=TabPanel.d.ts.map

package/lib/types/index.d.ts

@@ -35,4 +35,6 @@ export { DockSurface } from './components/DockSurface.tsx';
 export type { DockSurfaceProps } from './components/DockSurface.tsx';
 export { FloatLayer } from './components/FloatLayer.tsx';
 export type { FloatLayerProps } from './components/FloatLayer.tsx';
+export { DockLayout } from './components/DockSurface.tsx';
+export type { DockLayoutProps } from './components/DockSurface.tsx';
 //# sourceMappingURL=index.d.ts.map

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.6-alpha.2",
+  "version": "0.1.7-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -29,9 +29,9 @@
     "react-dom": "^18.2.0",
     "react": "^18.2.0",
     "clsx": "^2.0.0",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.2"
+    "@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"
   },
   "files": [
     "lib/index.js",
@@ -39,6 +39,6 @@
     "lib/types/**/*.d.ts"
   ],
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "~4.0.4"
   }
 }