@tutti-os/workbench-surface 0.0.168 → 0.0.170

package/README.md

@@ -43,12 +43,20 @@ When a node body or header needs host-owned business state, pass an
 `externalNodeState` and `externalWorkspaceState`. If the source exposes
 `subscribe(...)`, the host re-renders when that subscription notifies.
 
-Node body context also exposes `isDragging` and `isResizing`. The Workbench
+Node body and header contexts expose `isDragging` and `isResizing`. The Workbench
 shell continues applying live frame geometry during direct manipulation, while
 an expensive body adapter may use these flags to suppress frame-only renders
 until the interaction settles. The adapter must still observe both interaction
 transitions so the final committed frame reaches responsive body layout.
 
+Headers keep live frame renders by default. A definition may provide
+`getHeaderFrameRenderKey(context)` when several intermediate frames produce the
+same visible header layout. During drag or resize, equal primitive keys skip
+`renderHeader`; changes to node data, external state, focus, or interaction
+state still render. Call `context.windowActions.getFrame()` inside actions that
+need execution-time geometry instead of closing over a frame omitted from the
+key.
+
 Host-owned business instances are represented with `projectedNodes`. A
 projected node tells the workbench that a shell should currently exist for a
 host-owned instance; the workbench reconciles that presence with snapshot

package/dist/index.d.ts

@@ -326,11 +326,16 @@ interface WorkbenchWindowHeaderContext<TData = unknown> {
     node: WorkbenchNode<TData>;
     controller: WorkbenchController<TData>;
     surfaceSize: WorkbenchSize;
+    isDragging: boolean;
+    isFocused: boolean;
+    isResizing: boolean;
     genie: {
         minimizeNodeToAnchor(nodeID: string, minimize?: () => void): void;
     };
     defaultActions: ReactNode;
     dragHandleProps: WorkbenchWindowHeaderDragHandleProps;
+    /** Stable while the non-node inputs used to build header chrome are unchanged. */
+    renderRevision: object;
 }
 type WorkbenchRenderNode<TData = unknown> = (context: WorkbenchRenderNodeContext<TData>) => ReactNode;
 type WorkbenchRenderWindowActions<TData = unknown> = (context: WorkbenchWindowActionContext<TData>) => ReactNode;
@@ -707,6 +712,7 @@ interface WorkbenchHostNodeHeaderWindowActions {
     applyQuickLayout(target: WorkbenchQuickLayoutTarget): void;
     close(): void;
     focus(): void;
+    getFrame(): WorkbenchFrame;
     minimize(): void;
     resize(frame: WorkbenchFrame): void;
     toggleDisplayMode(): void;
@@ -720,7 +726,9 @@ interface WorkbenchHostNodeHeaderContext<TExternalNodeState = unknown, TExternal
     externalWorkspaceState: TExternalWorkspaceState;
     instanceId: string;
     instanceKey?: string | null;
+    isDragging: boolean;
     isFocused: boolean;
+    isResizing: boolean;
     node: WorkbenchNode<WorkbenchHostNodeData>;
     surfaceSize: WorkbenchSize;
     windowActions: WorkbenchHostNodeHeaderWindowActions;
@@ -732,6 +740,10 @@ type WorkbenchHostBodyRenderer<TExternalNodeState = unknown, TExternalWorkspaceS
 type WorkbenchHostHeaderRenderer<TExternalNodeState = unknown, TExternalWorkspaceState = unknown> = {
     bivarianceHack(context: WorkbenchHostNodeHeaderContext<TExternalNodeState, TExternalWorkspaceState>): ReactNode;
 }["bivarianceHack"];
+type WorkbenchHostNodeHeaderFrameRenderKey = boolean | number | string | null;
+type WorkbenchHostHeaderFrameRenderKeyResolver<TExternalNodeState = unknown, TExternalWorkspaceState = unknown> = {
+    bivarianceHack(context: WorkbenchHostNodeHeaderContext<TExternalNodeState, TExternalWorkspaceState>): WorkbenchHostNodeHeaderFrameRenderKey;
+}["bivarianceHack"];
 type WorkbenchHostWindowCloseEffectResolver<TExternalNodeState = unknown, TExternalWorkspaceState = unknown> = {
     bivarianceHack(context: WorkbenchHostWindowCloseEffectContext<TExternalNodeState, TExternalWorkspaceState>): Promise<WorkbenchHostCloseEffect | null | void> | WorkbenchHostCloseEffect | null | void;
 }["bivarianceHack"];
@@ -740,6 +752,11 @@ interface WorkbenchHostNodeDefinition<TExternalNodeState = unknown, TExternalWor
     description?: string;
     frame: WorkbenchFrame;
     getWindowCloseEffect?: WorkbenchHostWindowCloseEffectResolver<TExternalNodeState, TExternalWorkspaceState>;
+    /**
+     * Projects frame-derived header presentation during direct manipulation.
+     * Equal keys skip renderHeader; omitted definitions keep live frame renders.
+     */
+    getHeaderFrameRenderKey?: WorkbenchHostHeaderFrameRenderKeyResolver<TExternalNodeState, TExternalWorkspaceState>;
     instance?: WorkbenchHostNodeInstanceStrategy;
     onBodyRenderErrorChange?: (input: {
         hasError: boolean;
@@ -906,4 +923,4 @@ declare function getWorkbenchLayoutFrame(surfaceSize: WorkbenchSize, constraints
 
 declare function selectFocusedWorkbenchNode<TData>(state: WorkbenchState<TData>): WorkbenchNode<TData> | null;
 
-export { type CreateWorkbenchNodeInput, type CreateWorkbenchSnapshotFromStateOptions, 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 WorkbenchHostDockEntry, type WorkbenchHostDockEntryAction, type WorkbenchHostDockEntryBadge, type WorkbenchHostDockEntryDynamicState, type WorkbenchHostDockEntryLaunchBehavior, type WorkbenchHostDockEntryPresentationOverride, type WorkbenchHostDockEntryPresentationOverrides, type WorkbenchHostDockEntryState, type WorkbenchHostDockEntryStateKind, type WorkbenchHostDockEntryStateSource, type WorkbenchHostDockEntryVisibility, 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 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, createWorkbenchController, createWorkbenchHostLaunchedNodeId, createWorkbenchHostProjectedNodeId, createWorkbenchNode, createWorkbenchNodeFromSnapshot, createWorkbenchSnapshotFromState, createWorkbenchStateFromSnapshot, getWorkbenchLayoutFrame, isEditableShortcutTarget, resolveWorkbenchHostPrepareClose, selectFocusedWorkbenchNode, useWorkbenchSelector, workbenchFocusInputActivationType };
+export { type CreateWorkbenchNodeInput, type CreateWorkbenchSnapshotFromStateOptions, 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 WorkbenchHostDockEntry, type WorkbenchHostDockEntryAction, type WorkbenchHostDockEntryBadge, type WorkbenchHostDockEntryDynamicState, type WorkbenchHostDockEntryLaunchBehavior, type WorkbenchHostDockEntryPresentationOverride, type WorkbenchHostDockEntryPresentationOverrides, type WorkbenchHostDockEntryState, type WorkbenchHostDockEntryStateKind, type WorkbenchHostDockEntryStateSource, type WorkbenchHostDockEntryVisibility, 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, createWorkbenchController, createWorkbenchHostLaunchedNodeId, createWorkbenchHostProjectedNodeId, createWorkbenchNode, createWorkbenchNodeFromSnapshot, createWorkbenchSnapshotFromState, createWorkbenchStateFromSnapshot, getWorkbenchLayoutFrame, isEditableShortcutTarget, resolveWorkbenchHostPrepareClose, selectFocusedWorkbenchNode, useWorkbenchSelector, workbenchFocusInputActivationType };