@tutti-os/workbench-surface 0.0.237 → 0.0.238

package/dist/index.js

@@ -1572,7 +1572,7 @@ function createWorkbenchController(initialState = {}, options = {}) {
 }
 
 // src/host/WorkbenchHost.tsx
-import { useMemo as useMemo11 } from "react";
+import { useMemo as useMemo12 } from "react";
 
 // src/mission-control/WorkbenchMissionControlOverlay.tsx
 import {
@@ -2308,7 +2308,8 @@ function useWorkbenchMissionControlState({
 // src/react/WorkbenchSurface.tsx
 import {
   useCallback as useCallback8,
-  useEffect as useEffect5
+  useEffect as useEffect5,
+  useMemo as useMemo7
 } from "react";
 
 // src/react/WorkbenchDockFrame.tsx
@@ -2541,7 +2542,7 @@ function WorkbenchLockedSlotLayer() {
 }
 
 // src/react/WorkbenchNodeLayer.tsx
-import { Fragment as Fragment3, memo, useMemo as useMemo5 } from "react";
+import { memo, useMemo as useMemo5, useSyncExternalStore as useSyncExternalStore2 } from "react";
 import { createPortal } from "react-dom";
 
 // src/react/WorkbenchWindowFrame.tsx
@@ -2923,9 +2924,27 @@ var defaultWindowChromeI18n = createWorkbenchWindowChromeI18nRuntime(
   })
 );
 var WorkbenchWindowPresentationVisibilityContext = createContext2(true);
+var noWorkbenchNodeIDs = /* @__PURE__ */ new Set();
+var defaultWorkbenchVisualOcclusionPresentation = {
+  hiddenNodeIDs: noWorkbenchNodeIDs,
+  nonOccludingNodeIDs: noWorkbenchNodeIDs,
+  topLayerNodeIDs: []
+};
+var WorkbenchVisualOcclusionPresentationContext = createContext2(
+  defaultWorkbenchVisualOcclusionPresentation
+);
 function useWorkbenchWindowPresentationVisibility() {
   return useContext2(WorkbenchWindowPresentationVisibilityContext);
 }
+function useWorkbenchVisualOcclusionPresentation() {
+  return useContext2(WorkbenchVisualOcclusionPresentationContext);
+}
+function WorkbenchVisualOcclusionPresentationProvider({
+  children,
+  presentation
+}) {
+  return /* @__PURE__ */ jsx7(WorkbenchVisualOcclusionPresentationContext.Provider, { value: presentation, children });
+}
 function resolveWorkbenchNodeLaunchSource(data) {
   if (data && typeof data === "object" && "launchSource" in data && typeof data.launchSource === "string" && data.launchSource.length > 0) {
     return data.launchSource;
@@ -2938,6 +2957,15 @@ function resolveWorkbenchNodeTypeId(data) {
   }
   return void 0;
 }
+function workbenchFramesEqual(left, right) {
+  return left.x === right.x && left.y === right.y && left.width === right.width && left.height === right.height;
+}
+function isWorkbenchFrameTransitionProperty(propertyName) {
+  return propertyName === "translate" || propertyName === "width" || propertyName === "height";
+}
+function shouldReduceWorkbenchMotion() {
+  return window.matchMedia?.("(prefers-reduced-motion: reduce)").matches === true;
+}
 function WorkbenchWindowFrame({
   children,
   edgeSnapEnabled = false,
@@ -2946,6 +2974,7 @@ function WorkbenchWindowFrame({
   interactive = true,
   minimizeNodeToAnchor: minimizeNodeToAnchorProp,
   node,
+  nodePresentationTransitions,
   presentation = null,
   renderActions,
   renderHeader,
@@ -2954,6 +2983,7 @@ function WorkbenchWindowFrame({
   windowHeaderPresentation,
   windowChromeI18n
 }) {
+  const shellRef = useRef3(null);
   const controller = useWorkbenchController();
   const baseZIndex = useWorkbenchSelector(
     (state) => selectWorkbenchNodeZIndex(state, node.id)
@@ -2992,6 +3022,86 @@ function WorkbenchWindowFrame({
     readGenieVisibility,
     readGenieVisibility
   );
+  const launchSource = resolveWorkbenchNodeLaunchSource(node.data);
+  const presentationMode = presentation?.mode ?? null;
+  const previousFrameRef = useRef3(node.frame);
+  useLayoutEffect3(() => {
+    const previousFrame = previousFrameRef.current;
+    previousFrameRef.current = node.frame;
+    if (workbenchFramesEqual(previousFrame, node.frame)) {
+      return;
+    }
+    nodePresentationTransitions.setActive(
+      node.id,
+      "frame",
+      !hiddenMounted && !isGenieHidden && !isDragging && !isResizing && presentationMode === null
+    );
+  }, [
+    hiddenMounted,
+    isDragging,
+    isGenieHidden,
+    isResizing,
+    node.frame.height,
+    node.frame.width,
+    node.frame.x,
+    node.frame.y,
+    node.id,
+    nodePresentationTransitions,
+    presentationMode
+  ]);
+  useLayoutEffect3(() => {
+    const shell = shellRef.current;
+    if (!shell) {
+      return;
+    }
+    const activeFrameProperties = /* @__PURE__ */ new Set();
+    const handleTransitionEvent = (event) => {
+      if (event.target !== shell || !isWorkbenchFrameTransitionProperty(event.propertyName)) {
+        return;
+      }
+      if (event.type === "transitionrun") {
+        if (shell.dataset.windowDragState !== "dragging" && shell.dataset.windowResizeState !== "resizing" && shell.dataset.presentationMode === "default") {
+          activeFrameProperties.add(event.propertyName);
+          nodePresentationTransitions.setActive(node.id, "frame", true);
+        }
+        return;
+      }
+      activeFrameProperties.delete(event.propertyName);
+      nodePresentationTransitions.setActive(
+        node.id,
+        "frame",
+        activeFrameProperties.size > 0
+      );
+    };
+    const handleAnimationEvent = (event) => {
+      if (event.animationName !== "workbench-shell-enter" || !(event.target instanceof HTMLElement) || event.target.parentElement !== shell) {
+        return;
+      }
+      nodePresentationTransitions.setActive(
+        node.id,
+        "onboarding-entry",
+        event.type === "animationstart"
+      );
+    };
+    shell.addEventListener("transitionrun", handleTransitionEvent);
+    shell.addEventListener("transitionend", handleTransitionEvent);
+    shell.addEventListener("transitioncancel", handleTransitionEvent);
+    shell.addEventListener("animationstart", handleAnimationEvent);
+    shell.addEventListener("animationend", handleAnimationEvent);
+    shell.addEventListener("animationcancel", handleAnimationEvent);
+    if (launchSource === "onboarding-auto" && !shouldReduceWorkbenchMotion()) {
+      nodePresentationTransitions.setActive(node.id, "onboarding-entry", true);
+    }
+    return () => {
+      shell.removeEventListener("transitionrun", handleTransitionEvent);
+      shell.removeEventListener("transitionend", handleTransitionEvent);
+      shell.removeEventListener("transitioncancel", handleTransitionEvent);
+      shell.removeEventListener("animationstart", handleAnimationEvent);
+      shell.removeEventListener("animationend", handleAnimationEvent);
+      shell.removeEventListener("animationcancel", handleAnimationEvent);
+      nodePresentationTransitions.clearNode(node.id);
+    };
+  }, [launchSource, node.id, nodePresentationTransitions]);
   const minimizeNodeToAnchorRef = useRef3(minimizeNodeToAnchorProp);
   useLayoutEffect3(() => {
     minimizeNodeToAnchorRef.current = minimizeNodeToAnchorProp;
@@ -3061,7 +3171,6 @@ function WorkbenchWindowFrame({
   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;
   const presentationFrame = presentation?.frameByNodeId.get(node.id) ?? null;
   const isPresentationHidden = presentationMode === "mission-control" && !presentation?.visibleNodeIds.has(node.id);
   const isWindowPresentationVisible = !hiddenMounted && !isGenieHidden && presentationMode === null;
@@ -3083,12 +3192,13 @@ function WorkbenchWindowFrame({
   return /* @__PURE__ */ jsxs4(
     "section",
     {
+      ref: shellRef,
       "aria-hidden": hiddenMounted || isPresentationHidden ? true : void 0,
       className: "workbench-window-shell",
       "data-focused": isFocused ? "true" : "false",
       "data-display-mode": node.displayMode,
       "data-genie-state": isGenieHidden ? "hidden" : "visible",
-      "data-launch-source": resolveWorkbenchNodeLaunchSource(node.data),
+      "data-launch-source": launchSource,
       "data-minimized-mount": hiddenMounted ? "hidden" : "visible",
       "data-presentation-mode": presentationMode ?? "default",
       "data-presentation-visibility": isPresentationHidden ? "hidden" : "visible",
@@ -3276,6 +3386,7 @@ function WorkbenchNodeLayer({
   genie,
   edgeSnapEnabled = false,
   interactive = true,
+  nodePresentationTransitions,
   presentation,
   renderNode,
   shouldKeepMinimizedNodeMounted,
@@ -3303,6 +3414,40 @@ function WorkbenchNodeLayer({
   const { defaultNodeIDs, dialogPopoverNodeIDs } = useWorkbenchSelector(
     selectNodeLayerNodeIDs
   );
+  const genieHiddenNodeIDs = useSyncExternalStore2(
+    genie.nodeVisibility.subscribeAll,
+    genie.nodeVisibility.getHiddenNodeIDsSnapshot,
+    genie.nodeVisibility.getHiddenNodeIDsSnapshot
+  );
+  const pendingMinimizedNodeID = genie.pendingMinimizedNode?.id ?? null;
+  const visuallyHiddenNodeIDs = useMemo5(() => {
+    if (pendingMinimizedNodeID === null || genieHiddenNodeIDs.has(pendingMinimizedNodeID)) {
+      return genieHiddenNodeIDs;
+    }
+    return /* @__PURE__ */ new Set([...genieHiddenNodeIDs, pendingMinimizedNodeID]);
+  }, [genieHiddenNodeIDs, pendingMinimizedNodeID]);
+  const presentationTransitionNodeIDs = useSyncExternalStore2(
+    nodePresentationTransitions.subscribe,
+    nodePresentationTransitions.getSnapshot,
+    nodePresentationTransitions.getSnapshot
+  );
+  const nonOccludingNodeIDs = useMemo5(() => {
+    if (presentationTransitionNodeIDs.size === 0) {
+      return visuallyHiddenNodeIDs;
+    }
+    return /* @__PURE__ */ new Set([
+      ...visuallyHiddenNodeIDs,
+      ...presentationTransitionNodeIDs
+    ]);
+  }, [presentationTransitionNodeIDs, visuallyHiddenNodeIDs]);
+  const visualOcclusionPresentation = useMemo5(
+    () => ({
+      hiddenNodeIDs: visuallyHiddenNodeIDs,
+      nonOccludingNodeIDs,
+      topLayerNodeIDs: dialogPopoverNodeIDs
+    }),
+    [dialogPopoverNodeIDs, nonOccludingNodeIDs, visuallyHiddenNodeIDs]
+  );
   const snapPreviewRect = useWorkbenchSelector(selectWorkbenchSnapPreviewRect);
   const presentationInteraction = interactive && presentation?.mode === "mission-control" ? presentation.interaction ?? null : null;
   const dialogPopoverLayer = dialogPopoverNodeIDs.length > 0 ? /* @__PURE__ */ jsx8(
@@ -3314,6 +3459,7 @@ function WorkbenchNodeLayer({
       genieNodeVisibility: genie.nodeVisibility,
       interactive,
       minimizeNodeToAnchor: genie.minimizeNodeToAnchor,
+      nodePresentationTransitions,
       nodeIDs: dialogPopoverNodeIDs,
       presentation,
       renderNode,
@@ -3325,31 +3471,38 @@ function WorkbenchNodeLayer({
       windowChromeMode
     }
   ) : null;
-  return /* @__PURE__ */ jsxs5(Fragment3, { children: [
-    /* @__PURE__ */ jsx8(
-      MemoizedWorkbenchNodeLayerGroup,
-      {
-        className: "workbench-node-layer",
-        edgeSnapEnabled,
-        fullscreenHeaderMode: resolveFullscreenHeaderMode,
-        genieNodeVisibility: genie.nodeVisibility,
-        interactive,
-        minimizeNodeToAnchor: genie.minimizeNodeToAnchor,
-        nodeIDs: defaultNodeIDs,
-        onBackdropPress: presentationInteraction?.onBackdropPress,
-        presentation,
-        renderNode,
-        renderWindowActions,
-        renderWindowHeader,
-        resolveWindowHeaderPresentation,
-        resolveWindowZIndex,
-        snapPreviewRect,
-        windowChromeI18n,
-        windowChromeMode
-      }
-    ),
-    typeof document === "undefined" ? dialogPopoverLayer : dialogPopoverLayer ? createPortal(dialogPopoverLayer, document.body) : null
-  ] });
+  return /* @__PURE__ */ jsxs5(
+    WorkbenchVisualOcclusionPresentationProvider,
+    {
+      presentation: visualOcclusionPresentation,
+      children: [
+        /* @__PURE__ */ jsx8(
+          MemoizedWorkbenchNodeLayerGroup,
+          {
+            className: "workbench-node-layer",
+            edgeSnapEnabled,
+            fullscreenHeaderMode: resolveFullscreenHeaderMode,
+            genieNodeVisibility: genie.nodeVisibility,
+            interactive,
+            minimizeNodeToAnchor: genie.minimizeNodeToAnchor,
+            nodePresentationTransitions,
+            nodeIDs: defaultNodeIDs,
+            onBackdropPress: presentationInteraction?.onBackdropPress,
+            presentation,
+            renderNode,
+            renderWindowActions,
+            renderWindowHeader,
+            resolveWindowHeaderPresentation,
+            resolveWindowZIndex,
+            snapPreviewRect,
+            windowChromeI18n,
+            windowChromeMode
+          }
+        ),
+        typeof document === "undefined" ? dialogPopoverLayer : dialogPopoverLayer ? createPortal(dialogPopoverLayer, document.body) : null
+      ]
+    }
+  );
 }
 function WorkbenchNodeLayerGroup({
   className,
@@ -3358,6 +3511,7 @@ function WorkbenchNodeLayerGroup({
   genieNodeVisibility,
   interactive,
   minimizeNodeToAnchor,
+  nodePresentationTransitions,
   nodeIDs,
   onBackdropPress,
   presentation,
@@ -3402,6 +3556,7 @@ function WorkbenchNodeLayerGroup({
             edgeSnapEnabled,
             interactive,
             minimizeNodeToAnchor,
+            nodePresentationTransitions,
             nodeID,
             presentation,
             renderNode,
@@ -3427,6 +3582,7 @@ function WorkbenchNodeLayerItem({
   edgeSnapEnabled,
   interactive,
   minimizeNodeToAnchor,
+  nodePresentationTransitions,
   nodeID,
   presentation,
   renderNode,
@@ -3466,6 +3622,7 @@ function WorkbenchNodeLayerItem({
       node,
       genieNodeVisibility,
       minimizeNodeToAnchor,
+      nodePresentationTransitions,
       resolveWindowZIndex,
       fullscreenHeaderMode: fullscreenHeaderMode?.({
         controller,
@@ -4176,21 +4333,27 @@ function pruneWorkbenchGenieTextureCache(cache, limits) {
 
 // src/react/genieNodeVisibility.ts
 function createWorkbenchGenieNodeVisibilityStore() {
-  const hiddenNodeIDs = /* @__PURE__ */ new Set();
+  let hiddenNodeIDs = /* @__PURE__ */ new Set();
   const hiddenTokenByNodeID = /* @__PURE__ */ new Map();
   const listenersByNodeID = /* @__PURE__ */ new Map();
+  const allListeners = /* @__PURE__ */ new Set();
   const setHidden = (nodeID, hidden) => {
     if (hiddenNodeIDs.has(nodeID) === hidden) {
       return;
     }
+    const nextHiddenNodeIDs = new Set(hiddenNodeIDs);
     if (hidden) {
-      hiddenNodeIDs.add(nodeID);
+      nextHiddenNodeIDs.add(nodeID);
     } else {
-      hiddenNodeIDs.delete(nodeID);
+      nextHiddenNodeIDs.delete(nodeID);
     }
+    hiddenNodeIDs = nextHiddenNodeIDs;
     for (const listener of listenersByNodeID.get(nodeID) ?? []) {
       listener();
     }
+    for (const listener of allListeners) {
+      listener();
+    }
   };
   const hide = (nodeID) => {
     const token = Symbol(nodeID);
@@ -4208,9 +4371,13 @@ function createWorkbenchGenieNodeVisibilityStore() {
   };
   return {
     dispose() {
-      hiddenNodeIDs.clear();
+      hiddenNodeIDs = /* @__PURE__ */ new Set();
       hiddenTokenByNodeID.clear();
       listenersByNodeID.clear();
+      allListeners.clear();
+    },
+    getHiddenNodeIDsSnapshot() {
+      return hiddenNodeIDs;
     },
     getSnapshot(nodeID) {
       return hiddenNodeIDs.has(nodeID);
@@ -4223,6 +4390,12 @@ function createWorkbenchGenieNodeVisibilityStore() {
         show(nodeID);
       }
     },
+    subscribeAll(listener) {
+      allListeners.add(listener);
+      return () => {
+        allListeners.delete(listener);
+      };
+    },
     show,
     subscribe(nodeID, listener) {
       const listeners = listenersByNodeID.get(nodeID) ?? /* @__PURE__ */ new Set();
@@ -4353,7 +4526,7 @@ async function resolveNativeFirstGenieTexture({
 }
 
 // src/react/useWorkbenchGenieAnimation.tsx
-import { Fragment as Fragment4, jsx as jsx9, jsxs as jsxs6 } from "react/jsx-runtime";
+import { Fragment as Fragment3, jsx as jsx9, jsxs as jsxs6 } from "react/jsx-runtime";
 var genieDurationMs = 400;
 var previewCaptureRaceTimeoutMs = 120;
 var scaleMinimizeDurationMs = 220;
@@ -4817,6 +4990,7 @@ function useWorkbenchGenieAnimation({
   debugDiagnostics,
   dockPreviewCache,
   minimizeAnimation = "genie",
+  nodePresentationTransitions,
   renderNodeGeniePreview,
   resolveDockAnchorKey,
   resolveDockPreviewCacheKey: resolveDockPreviewCacheKey2,
@@ -5325,6 +5499,7 @@ function useWorkbenchGenieAnimation({
           return;
         }
         flushSync(() => {
+          nodePresentationTransitions.setActive(nodeID, "scale-restore", true);
           showNodeForGenie(nodeID);
         });
         runScaleWindowAnimation({
@@ -5334,12 +5509,22 @@ function useWorkbenchGenieAnimation({
           onCancel: () => {
             flushSync(() => {
               showNodeForGenie(nodeID);
+              nodePresentationTransitions.setActive(
+                nodeID,
+                "scale-restore",
+                false
+              );
             });
             clearMinimizedGenieTexture(nodeID);
           },
           onComplete: () => {
             flushSync(() => {
               showNodeForGenie(nodeID);
+              nodePresentationTransitions.setActive(
+                nodeID,
+                "scale-restore",
+                false
+              );
             });
             clearMinimizedGenieTexture(nodeID);
           }
@@ -5404,6 +5589,7 @@ function useWorkbenchGenieAnimation({
       clearCanvas,
       clearMinimizedGenieTexture,
       minimizeAnimation,
+      nodePresentationTransitions,
       readMinimizedGenieTexture,
       requestRenderedGeniePreviewTexture,
       resolveDockAnchorRect,
@@ -6072,7 +6258,7 @@ function useWorkbenchGenieAnimation({
   );
   const genieLayer = useMemo6(
     () => typeof document === "undefined" ? null : createPortal2(
-      /* @__PURE__ */ jsxs6(Fragment4, { children: [
+      /* @__PURE__ */ jsxs6(Fragment3, { children: [
         /* @__PURE__ */ jsx9(
           "canvas",
           {
@@ -6131,6 +6317,71 @@ function useWorkbenchGenieAnimation({
   );
 }
 
+// src/react/nodePresentationTransitions.ts
+function createWorkbenchNodePresentationTransitionStore() {
+  let activeNodeIDs = /* @__PURE__ */ new Set();
+  const activeTransitionsByNodeID = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  const publish = (nodeID, active) => {
+    if (activeNodeIDs.has(nodeID) === active) {
+      return;
+    }
+    const nextActiveNodeIDs = new Set(activeNodeIDs);
+    if (active) {
+      nextActiveNodeIDs.add(nodeID);
+    } else {
+      nextActiveNodeIDs.delete(nodeID);
+    }
+    activeNodeIDs = nextActiveNodeIDs;
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const clearNode = (nodeID) => {
+    if (!activeTransitionsByNodeID.delete(nodeID)) {
+      return;
+    }
+    publish(nodeID, false);
+  };
+  return {
+    clearNode,
+    dispose() {
+      activeNodeIDs = /* @__PURE__ */ new Set();
+      activeTransitionsByNodeID.clear();
+      listeners.clear();
+    },
+    getSnapshot() {
+      return activeNodeIDs;
+    },
+    setActive(nodeID, transition, active) {
+      const activeTransitions = activeTransitionsByNodeID.get(nodeID) ?? /* @__PURE__ */ new Set();
+      if (active) {
+        if (activeTransitions.has(transition)) {
+          return;
+        }
+        activeTransitions.add(transition);
+        activeTransitionsByNodeID.set(nodeID, activeTransitions);
+        publish(nodeID, true);
+        return;
+      }
+      if (!activeTransitions.delete(transition)) {
+        return;
+      }
+      if (activeTransitions.size > 0) {
+        return;
+      }
+      activeTransitionsByNodeID.delete(nodeID);
+      publish(nodeID, false);
+    },
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+}
+
 // src/react/WorkbenchSurface.tsx
 import { jsx as jsx10, jsxs as jsxs7 } from "react/jsx-runtime";
 function WorkbenchSurface({
@@ -6251,6 +6502,10 @@ function WorkbenchSurfaceInner({
     [controller]
   );
   const ref = useWorkbenchSurfaceSize(onSizeChange);
+  const nodePresentationTransitions = useMemo7(
+    createWorkbenchNodePresentationTransitionStore,
+    []
+  );
   const genie = useWorkbenchGenieAnimation({
     captureNodePreviewImage,
     captureNodePreviewImages,
@@ -6258,11 +6513,16 @@ function WorkbenchSurfaceInner({
     debugDiagnostics,
     dockPreviewCache,
     minimizeAnimation,
+    nodePresentationTransitions,
     renderNodeGeniePreview,
     resolveDockAnchorKey,
     resolveDockPreviewCacheKey: resolveDockPreviewCacheKey2,
     shouldCaptureNodePreviewImage
   });
+  useEffect5(
+    () => () => nodePresentationTransitions.dispose(),
+    [nodePresentationTransitions]
+  );
   useWorkbenchShortcuts({
     enabled: (shortcutsEnabled ?? true) && interactive,
     windowManagementShortcutPreset: windowManagement?.shortcutPreset ?? null
@@ -6305,6 +6565,7 @@ function WorkbenchSurfaceInner({
           {
             genie,
             interactive,
+            nodePresentationTransitions,
             presentation,
             renderNode,
             edgeSnapEnabled: windowManagement?.edgeSnapEnabled === true,
@@ -6509,7 +6770,7 @@ function resolveHostClosePreparer(contributions) {
 }
 
 // src/host/useWorkbenchHostRuntime.ts
-import { useEffect as useEffect6, useMemo as useMemo8, useState as useState5 } from "react";
+import { useEffect as useEffect6, useMemo as useMemo9, useState as useState5 } from "react";
 
 // src/store/createDerivedSnapshotGetter.ts
 function createDerivedSnapshotGetter(input) {
@@ -7525,7 +7786,7 @@ function nullableRectsEqual(left, right) {
 }
 
 // src/host/externalState.ts
-import { useCallback as useCallback9, useMemo as useMemo7, useSyncExternalStore as useSyncExternalStore2 } from "react";
+import { useCallback as useCallback9, useMemo as useMemo8, useSyncExternalStore as useSyncExternalStore3 } from "react";
 var noopSubscribe = () => () => {
 };
 function createWorkbenchHostExternalStateLookupInput(input) {
@@ -7539,14 +7800,14 @@ function createWorkbenchHostExternalStateLookupInput(input) {
   };
 }
 function useWorkbenchHostExternalState(input) {
-  const lookupInput = useMemo7(
+  const lookupInput = useMemo8(
     () => createWorkbenchHostExternalStateLookupInput({
       node: input.node,
       workspaceId: input.workspaceId
     }),
     [input.node, input.workspaceId]
   );
-  const workspaceInput = useMemo7(
+  const workspaceInput = useMemo8(
     () => ({ workspaceId: input.workspaceId }),
     [input.workspaceId]
   );
@@ -7570,12 +7831,12 @@ function useWorkbenchHostExternalState(input) {
     [input.externalStateSource, workspaceInput]
   );
   return {
-    externalNodeState: useSyncExternalStore2(
+    externalNodeState: useSyncExternalStore3(
       subscribeNodeState,
       getNodeState,
       getNodeState
     ),
-    externalWorkspaceState: useSyncExternalStore2(
+    externalWorkspaceState: useSyncExternalStore3(
       subscribeWorkspaceState,
       getWorkspaceState,
       getWorkspaceState
@@ -8663,7 +8924,7 @@ function useWorkbenchHostRuntime({
   workspaceId
 }) {
   const [, bumpHydrationRevision] = useState5(0);
-  const hostSession = useMemo8(() => {
+  const hostSession = useMemo9(() => {
     logWorkbenchHostDebug("create-session", debugDiagnostics, {
       nodeTypeIDs: nodes.map((node) => node.typeId),
       projectedNodeCount: projectedNodes?.length ?? 0,
@@ -8688,32 +8949,32 @@ function useWorkbenchHostRuntime({
     snapshotRepository,
     workspaceId
   ]);
-  const hostI18n = useMemo8(() => createWorkbenchHostI18nRuntime(i18n), [i18n]);
-  const missionControlI18n = useMemo8(
+  const hostI18n = useMemo9(() => createWorkbenchHostI18nRuntime(i18n), [i18n]);
+  const missionControlI18n = useMemo9(
     () => createWorkbenchMissionControlI18nRuntime(i18n),
     [i18n]
   );
-  const windowChromeI18n = useMemo8(
+  const windowChromeI18n = useMemo9(
     () => createWorkbenchWindowChromeI18nRuntime(i18n),
     [i18n]
   );
-  const nodeDefinitionByType = useMemo8(
+  const nodeDefinitionByType = useMemo9(
     () => new Map(nodes.map((definition) => [definition.typeId, definition])),
     [nodes]
   );
   const isHydrating = hostSession.isHydrating?.() ?? false;
-  const missionControlAdapter = useMemo8(
+  const missionControlAdapter = useMemo9(
     () => missionControlEnabled && !isHydrating ? createWorkbenchHostMissionControlAdapter({
       activateNode: hostSession.activateNode.bind(hostSession),
       controller: hostSession.controller
     }) : null,
     [hostSession.controller, isHydrating, missionControlEnabled]
   );
-  const chromeController = useMemo8(
+  const chromeController = useMemo9(
     () => isHydrating ? createReadOnlyWorkbenchController(hostSession.controller) : hostSession.controller,
     [hostSession.controller, isHydrating]
   );
-  const chromeContext = useMemo8(
+  const chromeContext = useMemo9(
     () => ({
       activateNode: hostSession.activateNode.bind(hostSession),
       controller: chromeController,
@@ -8802,14 +9063,14 @@ function logWorkbenchHostDebug(event, debugDiagnostics, payload) {
 }
 
 // src/host/useWorkbenchHostSurfaceRenderers.tsx
-import { Component, memo as memo3, useCallback as useCallback13, useMemo as useMemo10 } from "react";
+import { Component, memo as memo3, useCallback as useCallback13, useMemo as useMemo11 } from "react";
 
 // src/host/WorkbenchHostDock.tsx
 import {
   useCallback as useCallback12,
   useEffect as useEffect10,
   useLayoutEffect as useLayoutEffect7,
-  useMemo as useMemo9,
+  useMemo as useMemo10,
   useRef as useRef9,
   useState as useState8
 } from "react";
@@ -10213,7 +10474,7 @@ function resolveDockPopupVerticalClampOffsetPx(input) {
 }
 
 // src/host/WorkbenchHostDockPopup.tsx
-import { Fragment as Fragment5, jsx as jsx11, jsxs as jsxs8 } from "react/jsx-runtime";
+import { Fragment as Fragment4, jsx as jsx11, jsxs as jsxs8 } from "react/jsx-runtime";
 var dockPopupCardWidthPx = 165;
 var dockPopupCardHeightPx = 103;
 var dockPopupPreviewInsetPx = 4;
@@ -10854,7 +11115,7 @@ function WorkbenchHostDockPopup({
               showAllWindowsLabel,
               showOpen: showOpen === true
             }
-          ) : /* @__PURE__ */ jsxs8(Fragment5, { children: [
+          ) : /* @__PURE__ */ jsxs8(Fragment4, { children: [
             /* @__PURE__ */ jsx11("div", { className: "mb-2.5 flex items-center justify-between", children: /* @__PURE__ */ jsx11("span", { className: "min-w-0 truncate text-sm font-semibold", children: label }) }),
             isMinimizedStack ? /* @__PURE__ */ jsx11(
               "div",
@@ -11002,7 +11263,7 @@ function WorkbenchHostDockContextMenu({
       "data-desktop-dock-context-menu": "true",
       role: "menu",
       children: [
-        hasOpenWindows ? /* @__PURE__ */ jsx11(Fragment5, { children: /* @__PURE__ */ jsx11("div", { className: "max-h-48 min-w-0 overflow-auto overscroll-contain", children: items.map((item) => /* @__PURE__ */ jsx11(
+        hasOpenWindows ? /* @__PURE__ */ jsx11(Fragment4, { children: /* @__PURE__ */ jsx11("div", { className: "max-h-48 min-w-0 overflow-auto overscroll-contain", children: items.map((item) => /* @__PURE__ */ jsx11(
           WorkbenchHostDockContextMenuItem,
           {
             checked: !item.isMinimized,
@@ -11046,7 +11307,7 @@ function WorkbenchHostDockContextMenu({
             onSelect: onCreateNew
           }
         ) : null,
-        hasOpenWindows ? /* @__PURE__ */ jsxs8(Fragment5, { children: [
+        hasOpenWindows ? /* @__PURE__ */ jsxs8(Fragment4, { children: [
           hasDockActionGroup ? /* @__PURE__ */ jsx11(WorkbenchHostDockContextMenuSeparator, {}) : null,
           canShowAllWindows && onShowAllWindows ? /* @__PURE__ */ jsx11(
             WorkbenchHostDockContextMenuItem,
@@ -11452,7 +11713,7 @@ function WorkbenchHostDock({
   onMissionControlRequestOpen,
   workspaceId
 }) {
-  const minimizedNodeIDs = useMemo9(
+  const minimizedNodeIDs = useMemo10(
     () => new Set(context.minimizedNodes.map((node) => node.id)),
     [context.minimizedNodes]
   );
@@ -11640,14 +11901,14 @@ function WorkbenchHostDock({
       setDockStateRevision((revision) => revision + 1);
     });
   }, [dockStateSource]);
-  const renderedDockEntries = useMemo9(
+  const renderedDockEntries = useMemo10(
     () => dockEntries.map((entry) => {
       const dynamicState = dockStateSource?.getEntryState(entry.id);
       return dynamicState ? { ...entry, ...dynamicState } : entry;
     }),
     [dockEntries, dockStateRevision, dockStateSource]
   );
-  const resolvedEntries = useMemo9(
+  const resolvedEntries = useMemo10(
     () => resolveWorkbenchDockEntries({
       dockEntries: renderedDockEntries,
       minimizedNodeIds: minimizedNodeIDs,
@@ -11655,7 +11916,7 @@ function WorkbenchHostDock({
     }),
     [context.nodes, minimizedNodeIDs, renderedDockEntries]
   );
-  const minimizedDockSlots = useMemo9(
+  const minimizedDockSlots = useMemo10(
     () => resolveWorkbenchMinimizedDockSlots({
       nodeDefinitions,
       nodes: context.minimizedNodes
@@ -11663,7 +11924,7 @@ function WorkbenchHostDock({
     [context.minimizedNodes, nodeDefinitions]
   );
   const { promotedNodeId, stackDispatching } = useMinimizedDockStackPromotion(minimizedDockSlots);
-  const dockItems = useMemo9(
+  const dockItems = useMemo10(
     () => createWorkbenchHostDockItems({
       minimizedDockSlots,
       resolvedEntries
@@ -11674,7 +11935,7 @@ function WorkbenchHostDock({
     dockItems,
     (nodeId) => context.genie.shouldAnimateMinimizedDockEnter(nodeId)
   );
-  const presentDockItemKeys = useMemo9(
+  const presentDockItemKeys = useMemo10(
     () => presentDockItems.map((item) => item.key).join("\n"),
     [presentDockItems]
   );
@@ -11683,7 +11944,7 @@ function WorkbenchHostDock({
     elementRefs: wallpaperToneElementRefs,
     itemKeys: presentDockItemKeys
   });
-  const dockWidth = useMemo9(
+  const dockWidth = useMemo10(
     () => resolveWorkbenchHostDockItemsWidth(dockItems),
     [dockItems]
   );
@@ -14533,7 +14794,7 @@ function WorkbenchHostWindowActions({
 // src/host/useWorkbenchHostSurfaceRenderers.tsx
 import { jsx as jsx14, jsxs as jsxs10 } from "react/jsx-runtime";
 function useWorkbenchHostSurfaceRenderers(input) {
-  const renderBottomChrome = useMemo10(() => {
+  const renderBottomChrome = useMemo11(() => {
     const renderChrome = input.renderBottomChrome;
     return renderChrome ? () => /* @__PURE__ */ jsx14(
       WorkbenchHostSurfaceRenderErrorBoundary,
@@ -14561,7 +14822,7 @@ function useWorkbenchHostSurfaceRenderers(input) {
     input.renderBottomChrome,
     input.workspaceId
   ]);
-  const renderTopChrome = useMemo10(() => {
+  const renderTopChrome = useMemo11(() => {
     const renderChrome = input.renderTopChrome;
     return renderChrome ? () => /* @__PURE__ */ jsx14(
       WorkbenchHostSurfaceRenderErrorBoundary,
@@ -14912,7 +15173,7 @@ function WorkbenchHostNodeRenderer(input) {
     isVisible,
     workspaceId: input.workspaceId
   });
-  const resetKey = useMemo10(
+  const resetKey = useMemo11(
     () => [
       input.context.node.id,
       input.context.node.data.typeId,
@@ -15202,7 +15463,7 @@ function WorkbenchHost({
   windowManagement,
   workspaceId
 }) {
-  const hostRuntimeConfig = useMemo11(
+  const hostRuntimeConfig = useMemo12(
     () => resolveWorkbenchHostRuntimeConfig({
       contributions,
       externalStateSource,
@@ -15218,7 +15479,7 @@ function WorkbenchHost({
       onNodeCloseRequest
     ]
   );
-  const hostDockEntries = useMemo11(
+  const hostDockEntries = useMemo12(
     () => resolveWorkbenchHostDockEntries({
       contributions,
       dockEntryPresentationOverrides,
@@ -15393,21 +15654,43 @@ function WorkbenchDockComponentPreviewFrame({
 }
 
 // src/core/visualOcclusion.ts
+var noNodeIDs = /* @__PURE__ */ new Set();
+var defaultVisualOcclusionPresentation = {
+  hiddenNodeIDs: noNodeIDs,
+  nonOccludingNodeIDs: noNodeIDs,
+  topLayerNodeIDs: []
+};
 var exposedNodeIDsByState = /* @__PURE__ */ new WeakMap();
-function selectVisuallyExposedWorkbenchNodeIDs(state) {
-  const cached = exposedNodeIDsByState.get(state);
-  if (cached) {
-    return cached;
+var exposedNodeIDsByNodeStack = /* @__PURE__ */ new WeakMap();
+function selectVisuallyExposedWorkbenchNodeIDs(state, presentation = defaultVisualOcclusionPresentation) {
+  const cachedByState = exposedNodeIDsByState.get(state);
+  if (cachedByState?.presentation === presentation) {
+    return cachedByState.exposedNodeIDs;
+  }
+  const cachedByGeometry = exposedNodeIDsByNodeStack.get(state.nodeStack);
+  if (cachedByGeometry && cachedByGeometry.presentation === presentation && hasEquivalentVisualOcclusionGeometry(cachedByGeometry, state)) {
+    cachedByGeometry.nodes = state.nodes;
+    cachedByGeometry.surfaceSize = state.surfaceSize;
+    exposedNodeIDsByState.set(state, {
+      exposedNodeIDs: cachedByGeometry.exposedNodeIDs,
+      presentation
+    });
+    return cachedByGeometry.exposedNodeIDs;
   }
   const nodeByID = new Map(state.nodes.map((node) => [node.id, node]));
   const stackedIDs = new Set(state.nodeStack);
-  const orderedNodes = [
+  const stackOrderedNodes = [
     ...state.nodes.filter((node) => !stackedIDs.has(node.id)),
     ...state.nodeStack.flatMap((nodeID) => {
       const node = nodeByID.get(nodeID);
       return node ? [node] : [];
     })
   ];
+  const topLayerNodeIDs = new Set(presentation.topLayerNodeIDs);
+  const orderedNodes = topLayerNodeIDs.size === 0 ? stackOrderedNodes : [
+    ...stackOrderedNodes.filter((node) => !topLayerNodeIDs.has(node.id)),
+    ...stackOrderedNodes.filter((node) => topLayerNodeIDs.has(node.id))
+  ];
   const surfaceFrame = {
     x: 0,
     y: 0,
@@ -15416,7 +15699,7 @@ function selectVisuallyExposedWorkbenchNodeIDs(state) {
   };
   const exposedNodeIDs = /* @__PURE__ */ new Set();
   orderedNodes.forEach((node, nodeIndex) => {
-    if (node.isMinimized) {
+    if (node.isMinimized || presentation.hiddenNodeIDs.has(node.id)) {
       return;
     }
     const visibleFrame = intersectFrames(node.frame, surfaceFrame);
@@ -15426,7 +15709,7 @@ function selectVisuallyExposedWorkbenchNodeIDs(state) {
     let uncoveredFrames = [visibleFrame];
     for (let occluderIndex = nodeIndex + 1; occluderIndex < orderedNodes.length && uncoveredFrames.length > 0; occluderIndex += 1) {
       const occluder = orderedNodes[occluderIndex];
-      if (!occluder || occluder.isMinimized) {
+      if (!occluder || occluder.isMinimized || presentation.hiddenNodeIDs.has(occluder.id) || presentation.nonOccludingNodeIDs.has(occluder.id)) {
         continue;
       }
       uncoveredFrames = uncoveredFrames.flatMap(
@@ -15437,11 +15720,20 @@ function selectVisuallyExposedWorkbenchNodeIDs(state) {
       exposedNodeIDs.add(node.id);
     }
   });
-  exposedNodeIDsByState.set(state, exposedNodeIDs);
+  exposedNodeIDsByState.set(state, {
+    exposedNodeIDs,
+    presentation
+  });
+  exposedNodeIDsByNodeStack.set(state.nodeStack, {
+    exposedNodeIDs,
+    nodes: state.nodes,
+    presentation,
+    surfaceSize: state.surfaceSize
+  });
   return exposedNodeIDs;
 }
-function selectWorkbenchNodeIsVisuallyExposed(state, nodeID) {
-  return selectVisuallyExposedWorkbenchNodeIDs(state).has(nodeID);
+function selectWorkbenchNodeIsVisuallyExposed(state, nodeID, presentation) {
+  return selectVisuallyExposedWorkbenchNodeIDs(state, presentation).has(nodeID);
 }
 function intersectFrames(left, right) {
   const x = Math.max(left.x, right.x);
@@ -15505,6 +15797,18 @@ function pushFrame(frames, frame) {
     frames.push(frame);
   }
 }
+function hasEquivalentVisualOcclusionGeometry(cached, state) {
+  if (cached.surfaceSize.width !== state.surfaceSize.width || cached.surfaceSize.height !== state.surfaceSize.height || cached.nodes.length !== state.nodes.length) {
+    return false;
+  }
+  if (cached.nodes === state.nodes) {
+    return true;
+  }
+  return cached.nodes.every((cachedNode, index) => {
+    const node = state.nodes[index];
+    return node !== void 0 && cachedNode.id === node.id && cachedNode.isMinimized === node.isMinimized && cachedNode.frame.x === node.frame.x && cachedNode.frame.y === node.frame.y && cachedNode.frame.width === node.frame.width && cachedNode.frame.height === node.frame.height;
+  });
+}
 export {
   WorkbenchDockComponentPreviewFrame,
   WorkbenchHost,
@@ -15534,6 +15838,7 @@ export {
   selectVisuallyExposedWorkbenchNodeIDs,
   selectWorkbenchNodeIsVisuallyExposed,
   useWorkbenchSelector,
+  useWorkbenchVisualOcclusionPresentation,
   workbenchFocusInputActivationType,
   workbenchHostI18nResources,
   workbenchWindowChromeI18nNamespace,