@tutti-os/workbench-surface 0.0.201 → 0.0.203

package/dist/index.d.ts

@@ -300,11 +300,18 @@ interface WorkbenchWindowActionContext<TData = unknown> {
 }
 type WorkbenchWindowChromeMode = "system" | "custom-header";
 type WorkbenchFullscreenHeaderMode = "persistent";
+interface WorkbenchWindowHeaderPresentation {
+    border?: "none";
+    heightPx?: number;
+    layout?: "overlay";
+    overflow?: "visible";
+}
 interface WorkbenchResolveWindowChromeModeContext<TData = unknown> {
     node: WorkbenchNode<TData>;
     controller: WorkbenchController<TData>;
 }
 type WorkbenchResolveWindowChromeMode<TData = unknown> = (context: WorkbenchResolveWindowChromeModeContext<TData>) => WorkbenchWindowChromeMode;
+type WorkbenchResolveWindowHeaderPresentation<TData = unknown> = (context: WorkbenchResolveWindowChromeModeContext<TData>) => WorkbenchWindowHeaderPresentation | undefined;
 type WorkbenchWindowSurfaceLayer = "default" | "dialog-popover";
 interface WorkbenchResolveWindowSurfaceLayerContext<TData = unknown> {
     node: WorkbenchNode<TData>;
@@ -388,6 +395,7 @@ interface WorkbenchSurfaceProps<TData = unknown> {
     renderWindowHeader?: WorkbenchRenderWindowHeader<TData>;
     shouldKeepMinimizedNodeMounted?: WorkbenchKeepMinimizedNodeMounted<TData>;
     resolveFullscreenHeaderMode?: WorkbenchResolveFullscreenHeaderMode<TData>;
+    resolveWindowHeaderPresentation?: WorkbenchResolveWindowHeaderPresentation<TData>;
     resolveWindowSurfaceLayer?: WorkbenchResolveWindowSurfaceLayer<TData>;
     resolveWindowZIndex?: WorkbenchResolveWindowZIndex<TData>;
     resolveDockAnchorKey?: (node: WorkbenchNode<TData>) => string;
@@ -410,7 +418,7 @@ interface WorkbenchSurfaceWallpaper {
     position?: string;
     url: string;
 }
-declare function WorkbenchSurface<TData>({ captureNodePreviewImage, className, controller, debugDiagnostics, dockPreviewCache, dockPlacement, interactive, layoutConstraints, missionControlPhase, minimizeAnimation, presentation, renderBackdrop, renderBottomChrome, renderDock, renderNode, renderNodeGeniePreview, renderOverlay, renderTopChrome, renderWindowActions, renderWindowHeader, shouldKeepMinimizedNodeMounted, resolveFullscreenHeaderMode, resolveWindowSurfaceLayer, resolveWindowZIndex, resolveDockAnchorKey, resolveDockPreviewCacheKey, shortcutsEnabled, shouldCaptureNodePreviewImage, wallpaper, windowManagement, windowChromeMode, windowChromeI18n }: WorkbenchSurfaceProps<TData>): react_jsx_runtime.JSX.Element;
+declare function WorkbenchSurface<TData>({ captureNodePreviewImage, className, controller, debugDiagnostics, dockPreviewCache, dockPlacement, interactive, layoutConstraints, missionControlPhase, minimizeAnimation, presentation, renderBackdrop, renderBottomChrome, renderDock, renderNode, renderNodeGeniePreview, renderOverlay, renderTopChrome, renderWindowActions, renderWindowHeader, shouldKeepMinimizedNodeMounted, resolveFullscreenHeaderMode, resolveWindowHeaderPresentation, resolveWindowSurfaceLayer, resolveWindowZIndex, resolveDockAnchorKey, resolveDockPreviewCacheKey, shortcutsEnabled, shouldCaptureNodePreviewImage, wallpaper, windowManagement, windowChromeMode, windowChromeI18n }: WorkbenchSurfaceProps<TData>): react_jsx_runtime.JSX.Element;
 
 interface WorkbenchHostActivation<TPayload = unknown> {
     payload?: TPayload;
@@ -656,6 +664,7 @@ interface WorkbenchHostNodeWindowCapabilities {
     defaultOpen?: boolean;
     fullscreenHeaderMode?: "persistent";
     fullscreenable?: boolean;
+    header?: WorkbenchWindowHeaderPresentation;
     keepMountedWhenMinimized?: boolean | ((node: WorkbenchNode<WorkbenchHostNodeData>) => boolean);
     minimizable?: boolean;
     minimizedDock?: WorkbenchHostNodeMinimizedDockCapability;
@@ -971,4 +980,4 @@ interface CreateMultiInstanceDockEntryOptionsInput {
 declare function createMultiInstanceDockEntryOptions(launchPayload?: unknown, input?: CreateMultiInstanceDockEntryOptionsInput): Pick<WorkbenchHostDockEntry, "allowNewWindowInDockPopup" | "instanceMode" | "launchBehavior" | "launchPayload" | "newWindowLaunchPayload">;
 declare function resolveWorkbenchDockCountBadge(activeNodeCount: number): WorkbenchHostDockEntry["badge"];
 
-export { type CreateWorkbenchNodeInput, type CreateWorkbenchSnapshotFromStateOptions, type ResolvedWorkbenchHostDockEntry, type WorkbenchContribution, type WorkbenchController, type WorkbenchDebugDiagnostics, type WorkbenchDisplayMode, WorkbenchDockComponentPreviewFrame, type WorkbenchDockComponentPreviewFrameProps, type WorkbenchDockContext, type WorkbenchDockPlacement, type WorkbenchDockPreviewCache, type WorkbenchDockPreviewCacheKey, type WorkbenchDockPreviewCacheKeyResolver, type WorkbenchDockPreviewContent, type WorkbenchFrame, type WorkbenchFullscreenHeaderMode, WorkbenchHost, type WorkbenchHostActivation, type WorkbenchHostActivationTarget, type WorkbenchHostChromeRenderContext, type WorkbenchHostCloseDialogRequest, type WorkbenchHostCloseDialogScope, type WorkbenchHostCloseDialogVariant, type WorkbenchHostCloseEffect, type WorkbenchHostClosePreparationContext, type WorkbenchHostClosePreparer, type WorkbenchHostDockClickResolution, type WorkbenchHostDockEntry, type WorkbenchHostDockEntryAction, type WorkbenchHostDockEntryBadge, type WorkbenchHostDockEntryDynamicState, type WorkbenchHostDockEntryLaunchBehavior, type WorkbenchHostDockEntryPresentationOverride, type WorkbenchHostDockEntryPresentationOverrides, type WorkbenchHostDockEntryState, type WorkbenchHostDockEntryStateKind, type WorkbenchHostDockEntryStateSource, type WorkbenchHostDockEntryVisibility, type WorkbenchHostDockNodeState, type WorkbenchHostDockPopupItemDescriptor, type WorkbenchHostDockPopupItemInput, type WorkbenchHostExternalStateLookupInput, type WorkbenchHostExternalStateSource, type WorkbenchHostHandle, type WorkbenchHostLaunchFramePolicy, type WorkbenchHostLaunchInput, type WorkbenchHostLaunchReason, type WorkbenchHostLaunchRequest, type WorkbenchHostLaunchResult, type WorkbenchHostMissionControlMode, type WorkbenchHostMissionControlProps, type WorkbenchHostMultiInstanceStrategy, type WorkbenchHostNodeBodyContext, type WorkbenchHostNodeCloseDecision, type WorkbenchHostNodeCloseRequest, type WorkbenchHostNodeData, type WorkbenchHostNodeDefinition, type WorkbenchHostNodeHeaderContext, type WorkbenchHostNodeHeaderFrameRenderKey, type WorkbenchHostNodeHeaderWindowActions, type WorkbenchHostNodeIdentityInput, type WorkbenchHostNodeInstanceStrategy, type WorkbenchHostNodeMinimizedDockCapability, type WorkbenchHostNodeWindowCapabilities, type WorkbenchHostProjectedNode, type WorkbenchHostProjectedNodeSubject, type WorkbenchHostProps, type WorkbenchHostSingleInstanceStrategy, type WorkbenchHostSnapshotRepository, type WorkbenchHostWindowCloseEffectContext, type WorkbenchLayoutConstraints, type WorkbenchLayoutConstraintsInput, type WorkbenchLayoutPreset, type WorkbenchMissionControlAdapter, type WorkbenchMissionControlMode, type WorkbenchMissionControlSnapshot, type WorkbenchNode, type WorkbenchNodeRenderFrame, type WorkbenchNodeSizeConstraints, type WorkbenchQuickLayoutTarget, type WorkbenchRenderNode, type WorkbenchRenderNodeContext, type WorkbenchRenderWindowActions, type WorkbenchRenderWindowHeader, type WorkbenchResolveFullscreenHeaderMode, type WorkbenchResolveWindowChromeMode, type WorkbenchResolveWindowChromeModeContext, type WorkbenchSafeArea, type WorkbenchSize, type WorkbenchState, WorkbenchSurface, type WorkbenchSurfacePresentation, type WorkbenchSurfaceProps, type WorkbenchSurfaceWallpaper, type WorkbenchSurfaceWallpaperFit, type WorkbenchWindowActionContext, WorkbenchWindowChromeI18nRuntime, type WorkbenchWindowChromeMode, type WorkbenchWindowHeaderContext, type WorkbenchWindowManagementConfig, canCreateNewWindow, canCreateNewWindowInDockPopup, createDockNewWindowLaunchPayload, createMultiInstanceDockEntryOptions, createWorkbenchController, createWorkbenchHostLaunchedNodeId, createWorkbenchHostProjectedNodeId, createWorkbenchNode, createWorkbenchNodeFromSnapshot, createWorkbenchSnapshotFromState, createWorkbenchStateFromSnapshot, getWorkbenchLayoutFrame, isEditableShortcutTarget, matchWorkbenchDockEntryNode, resolveWorkbenchDockCountBadge, resolveWorkbenchDockEntries, resolveWorkbenchDockEntryClick, resolveWorkbenchHostPrepareClose, selectFocusedWorkbenchNode, useWorkbenchSelector, workbenchFocusInputActivationType };
+export { type CreateWorkbenchNodeInput, type CreateWorkbenchSnapshotFromStateOptions, type ResolvedWorkbenchHostDockEntry, type WorkbenchContribution, type WorkbenchController, type WorkbenchDebugDiagnostics, type WorkbenchDisplayMode, WorkbenchDockComponentPreviewFrame, type WorkbenchDockComponentPreviewFrameProps, type WorkbenchDockContext, type WorkbenchDockPlacement, type WorkbenchDockPreviewCache, type WorkbenchDockPreviewCacheKey, type WorkbenchDockPreviewCacheKeyResolver, type WorkbenchDockPreviewContent, type WorkbenchFrame, type WorkbenchFullscreenHeaderMode, WorkbenchHost, type WorkbenchHostActivation, type WorkbenchHostActivationTarget, type WorkbenchHostChromeRenderContext, type WorkbenchHostCloseDialogRequest, type WorkbenchHostCloseDialogScope, type WorkbenchHostCloseDialogVariant, type WorkbenchHostCloseEffect, type WorkbenchHostClosePreparationContext, type WorkbenchHostClosePreparer, type WorkbenchHostDockClickResolution, type WorkbenchHostDockEntry, type WorkbenchHostDockEntryAction, type WorkbenchHostDockEntryBadge, type WorkbenchHostDockEntryDynamicState, type WorkbenchHostDockEntryLaunchBehavior, type WorkbenchHostDockEntryPresentationOverride, type WorkbenchHostDockEntryPresentationOverrides, type WorkbenchHostDockEntryState, type WorkbenchHostDockEntryStateKind, type WorkbenchHostDockEntryStateSource, type WorkbenchHostDockEntryVisibility, type WorkbenchHostDockNodeState, type WorkbenchHostDockPopupItemDescriptor, type WorkbenchHostDockPopupItemInput, type WorkbenchHostExternalStateLookupInput, type WorkbenchHostExternalStateSource, type WorkbenchHostHandle, type WorkbenchHostLaunchFramePolicy, type WorkbenchHostLaunchInput, type WorkbenchHostLaunchReason, type WorkbenchHostLaunchRequest, type WorkbenchHostLaunchResult, type WorkbenchHostMissionControlMode, type WorkbenchHostMissionControlProps, type WorkbenchHostMultiInstanceStrategy, type WorkbenchHostNodeBodyContext, type WorkbenchHostNodeCloseDecision, type WorkbenchHostNodeCloseRequest, type WorkbenchHostNodeData, type WorkbenchHostNodeDefinition, type WorkbenchHostNodeHeaderContext, type WorkbenchHostNodeHeaderFrameRenderKey, type WorkbenchHostNodeHeaderWindowActions, type WorkbenchHostNodeIdentityInput, type WorkbenchHostNodeInstanceStrategy, type WorkbenchHostNodeMinimizedDockCapability, type WorkbenchHostNodeWindowCapabilities, type WorkbenchHostProjectedNode, type WorkbenchHostProjectedNodeSubject, type WorkbenchHostProps, type WorkbenchHostSingleInstanceStrategy, type WorkbenchHostSnapshotRepository, type WorkbenchHostWindowCloseEffectContext, type WorkbenchLayoutConstraints, type WorkbenchLayoutConstraintsInput, type WorkbenchLayoutPreset, type WorkbenchMissionControlAdapter, type WorkbenchMissionControlMode, type WorkbenchMissionControlSnapshot, type WorkbenchNode, type WorkbenchNodeRenderFrame, type WorkbenchNodeSizeConstraints, type WorkbenchQuickLayoutTarget, type WorkbenchRenderNode, type WorkbenchRenderNodeContext, type WorkbenchRenderWindowActions, type WorkbenchRenderWindowHeader, type WorkbenchResolveFullscreenHeaderMode, type WorkbenchResolveWindowChromeMode, type WorkbenchResolveWindowChromeModeContext, type WorkbenchResolveWindowHeaderPresentation, type WorkbenchSafeArea, type WorkbenchSize, type WorkbenchState, WorkbenchSurface, type WorkbenchSurfacePresentation, type WorkbenchSurfaceProps, type WorkbenchSurfaceWallpaper, type WorkbenchSurfaceWallpaperFit, type WorkbenchWindowActionContext, WorkbenchWindowChromeI18nRuntime, type WorkbenchWindowChromeMode, type WorkbenchWindowHeaderContext, type WorkbenchWindowHeaderPresentation, type WorkbenchWindowManagementConfig, canCreateNewWindow, canCreateNewWindowInDockPopup, createDockNewWindowLaunchPayload, createMultiInstanceDockEntryOptions, createWorkbenchController, createWorkbenchHostLaunchedNodeId, createWorkbenchHostProjectedNodeId, createWorkbenchNode, createWorkbenchNodeFromSnapshot, createWorkbenchSnapshotFromState, createWorkbenchStateFromSnapshot, getWorkbenchLayoutFrame, isEditableShortcutTarget, matchWorkbenchDockEntryNode, resolveWorkbenchDockCountBadge, resolveWorkbenchDockEntries, resolveWorkbenchDockEntryClick, resolveWorkbenchHostPrepareClose, selectFocusedWorkbenchNode, useWorkbenchSelector, workbenchFocusInputActivationType };

package/dist/index.js

@@ -2931,6 +2931,7 @@ function WorkbenchWindowFrame({
   renderHeader,
   resolveWindowZIndex,
   windowChromeMode = "system",
+  windowHeaderPresentation,
   windowChromeI18n
 }) {
   const controller = useWorkbenchController();
@@ -3024,6 +3025,7 @@ function WorkbenchWindowFrame({
     renderRevision: headerRenderRevision,
     windowChromeMode
   });
+  const windowHeaderHeightPx = typeof windowHeaderPresentation?.heightPx === "number" && Number.isFinite(windowHeaderPresentation.heightPx) && windowHeaderPresentation.heightPx > 0 ? windowHeaderPresentation.heightPx : null;
   const shouldRenderCustomHeader = resolvedHeader.windowChromeMode === "custom-header";
   const resolvedFullscreenHeaderMode = "persistent";
   const presentationMode = presentation?.mode ?? null;
@@ -3081,9 +3083,15 @@ function WorkbenchWindowFrame({
               "data-display-mode": node.displayMode,
               "data-fullscreen-header-mode": resolvedFullscreenHeaderMode,
               "data-window-chrome-mode": resolvedHeader.windowChromeMode,
+              "data-window-header-border": windowHeaderPresentation?.border,
+              "data-window-header-layout": windowHeaderPresentation?.layout,
+              "data-window-header-overflow": windowHeaderPresentation?.overflow,
               "data-workbench-window-capture": "true",
               "data-window-drag-state": isDragging ? "dragging" : "idle",
               "data-window-resize-state": isResizing ? "resizing" : "idle",
+              style: windowHeaderHeightPx !== null ? {
+                "--workbench-header-height": `${windowHeaderHeightPx}px`
+              } : void 0,
               children: [
                 /* @__PURE__ */ jsx7(
                   "div",
@@ -3184,6 +3192,7 @@ function WorkbenchNodeLayer({
   renderWindowActions,
   renderWindowHeader,
   resolveFullscreenHeaderMode,
+  resolveWindowHeaderPresentation,
   resolveWindowSurfaceLayer,
   resolveWindowZIndex,
   windowChromeMode,
@@ -3234,6 +3243,7 @@ function WorkbenchNodeLayer({
       renderNode,
       renderWindowActions,
       renderWindowHeader,
+      resolveWindowHeaderPresentation,
       resolveWindowZIndex,
       windowChromeI18n,
       windowChromeMode
@@ -3254,6 +3264,7 @@ function WorkbenchNodeLayer({
         renderNode,
         renderWindowActions,
         renderWindowHeader,
+        resolveWindowHeaderPresentation,
         resolveWindowZIndex,
         snapPreviewRect,
         windowChromeI18n,
@@ -3275,6 +3286,7 @@ function WorkbenchNodeLayerGroup({
   renderNode,
   renderWindowActions,
   renderWindowHeader,
+  resolveWindowHeaderPresentation,
   resolveWindowZIndex,
   snapPreviewRect,
   windowChromeI18n,
@@ -3316,6 +3328,7 @@ function WorkbenchNodeLayerGroup({
             renderNode,
             renderWindowActions,
             renderWindowHeader,
+            resolveWindowHeaderPresentation,
             resolveWindowZIndex,
             windowChromeI18n,
             windowChromeMode
@@ -3336,6 +3349,7 @@ function WorkbenchNodeLayerItem({
   renderNode,
   renderWindowActions,
   renderWindowHeader,
+  resolveWindowHeaderPresentation,
   resolveWindowZIndex,
   windowChromeI18n,
   windowChromeMode
@@ -3375,6 +3389,10 @@ function WorkbenchNodeLayerItem({
       }),
       renderActions: renderWindowActions,
       renderHeader: renderWindowHeader,
+      windowHeaderPresentation: resolveWindowHeaderPresentation?.({
+        controller,
+        node
+      }),
       windowChromeI18n,
       windowChromeMode: resolveWorkbenchWindowChromeMode({
         controller,
@@ -5531,6 +5549,7 @@ function WorkbenchSurface({
   renderWindowHeader,
   shouldKeepMinimizedNodeMounted,
   resolveFullscreenHeaderMode,
+  resolveWindowHeaderPresentation,
   resolveWindowSurfaceLayer,
   resolveWindowZIndex,
   resolveDockAnchorKey,
@@ -5566,6 +5585,7 @@ function WorkbenchSurface({
       renderWindowHeader,
       shouldKeepMinimizedNodeMounted,
       resolveFullscreenHeaderMode,
+      resolveWindowHeaderPresentation,
       resolveWindowSurfaceLayer,
       resolveWindowZIndex,
       resolveDockAnchorKey,
@@ -5601,6 +5621,7 @@ function WorkbenchSurfaceInner({
   renderWindowHeader,
   shouldKeepMinimizedNodeMounted,
   resolveFullscreenHeaderMode,
+  resolveWindowHeaderPresentation,
   resolveWindowSurfaceLayer,
   resolveWindowZIndex,
   resolveDockAnchorKey,
@@ -5680,6 +5701,7 @@ function WorkbenchSurfaceInner({
             renderWindowHeader,
             shouldKeepMinimizedNodeMounted,
             resolveFullscreenHeaderMode,
+            resolveWindowHeaderPresentation,
             resolveWindowSurfaceLayer,
             resolveWindowZIndex,
             windowChromeMode,
@@ -8453,6 +8475,7 @@ function isPointNearDockViewport({
   return clientX >= viewportRect.left - horizontalPadding && clientX <= viewportRect.right + horizontalPadding && clientY >= viewportRect.top - verticalPadding && clientY <= viewportRect.bottom + verticalPadding;
 }
 function useDockMagnification({
+  dockPlateRef,
   dockPlacement,
   dockRootRef,
   dockViewportRef,
@@ -8486,12 +8509,14 @@ function useDockMagnification({
       }
       magnifyActiveRef.current = active;
       if (active) {
+        dockPlateRef.current?.setAttribute("data-dock-pointer-active", "true");
         dockRootRef.current?.setAttribute("data-dock-pointer-active", "true");
       } else {
+        dockPlateRef.current?.removeAttribute("data-dock-pointer-active");
         dockRootRef.current?.removeAttribute("data-dock-pointer-active");
       }
     },
-    [dockRootRef]
+    [dockPlateRef, dockRootRef]
   );
   const stopAnimation = useCallback10(() => {
     if (animationFrameRef.current !== null) {
@@ -10518,6 +10543,7 @@ function WorkbenchHostDock({
     () => new Set(context.minimizedNodes.map((node) => node.id)),
     [context.minimizedNodes]
   );
+  const dockPlateRef = useRef9(null);
   const dockMeasureRef = useRef9(null);
   const dockItemsRef = useRef9(null);
   const hoverPanelRef = useRef9(null);
@@ -10755,6 +10781,7 @@ function WorkbenchHostDock({
     pauseMagnification: pauseDockMagnification,
     resetMagnification: resetDockMagnification
   } = useDockMagnification({
+    dockPlateRef,
     dockPlacement,
     dockRootRef: dockMeasureRef,
     dockViewportRef: dockItemsRef,
@@ -11526,7 +11553,9 @@ function WorkbenchHostDock({
         /* @__PURE__ */ jsx12(
           "div",
           {
+            ref: dockPlateRef,
             className: "desktop-dock-plate",
+            "data-dock-placement": dockPlacement,
             style: dockFrameSize === null ? void 0 : {
               "--desktop-dock-frame-size": `${dockFrameSize}px`
             },
@@ -13864,6 +13893,10 @@ function useWorkbenchHostSurfaceRenderers(input) {
     ({ node }) => input.nodeDefinitionByType.get(node.data.typeId)?.window?.fullscreenHeaderMode,
     [input.nodeDefinitionByType]
   );
+  const resolveWindowHeaderPresentation = useCallback13(
+    ({ node }) => input.nodeDefinitionByType.get(node.data.typeId)?.window?.header,
+    [input.nodeDefinitionByType]
+  );
   return {
     captureNodePreviewImage,
     renderBottomChrome,
@@ -13878,6 +13911,7 @@ function useWorkbenchHostSurfaceRenderers(input) {
     resolveDockAnchorKey,
     resolveDockPreviewCacheKey: resolveDockPreviewCacheKey2,
     resolveFullscreenHeaderMode,
+    resolveWindowHeaderPresentation,
     resolveWindowSurfaceLayer,
     resolveWindowZIndex,
     windowChromeMode
@@ -14311,6 +14345,7 @@ function WorkbenchHost({
       shouldKeepMinimizedNodeMounted: surfaceRenderers.shouldKeepMinimizedNodeMounted,
       resolveDockPreviewCacheKey: surfaceRenderers.resolveDockPreviewCacheKey,
       resolveFullscreenHeaderMode: surfaceRenderers.resolveFullscreenHeaderMode,
+      resolveWindowHeaderPresentation: surfaceRenderers.resolveWindowHeaderPresentation,
       resolveWindowSurfaceLayer: surfaceRenderers.resolveWindowSurfaceLayer,
       resolveWindowZIndex: surfaceRenderers.resolveWindowZIndex,
       resolveDockAnchorKey: surfaceRenderers.resolveDockAnchorKey,