@tutti-os/workbench-surface 0.0.147 → 0.0.149

package/README.md

@@ -61,6 +61,13 @@ Entries may also provide host-owned popup metadata through
 `resolvePopupItem(...)` and `capturePopupItemPreview(...)`, plus custom badge
 content when the default count or status shapes are not enough.
 
+Presentation-only changes to merged Dock entries belong in
+`dockEntryPresentationOverrides`. `WorkbenchHost` applies these overrides by
+entry id after contributions and explicit entries are merged, preserving Dock
+order without changing contribution nodes or rebuilding the host session. Use
+this seam for host-owned visibility and retention presentation; keep product
+preference persistence in the consuming host.
+
 Dock, shortcut, and command opens flow through `launchNode(...)` and the
 optional `onLaunchRequest(...)` callback. The host may create a business
 instance asynchronously, then return the shell identity, title, default frame,

package/dist/index.d.ts

@@ -622,6 +622,8 @@ interface WorkbenchHostDockEntry {
     typeId: string;
     visibility?: WorkbenchHostDockEntryVisibility;
 }
+type WorkbenchHostDockEntryPresentationOverride = Readonly<Partial<Pick<WorkbenchHostDockEntry, "dockRetention" | "visibility">>>;
+type WorkbenchHostDockEntryPresentationOverrides = Readonly<Record<string, WorkbenchHostDockEntryPresentationOverride>>;
 type WorkbenchHostDockEntryDynamicState = Partial<Pick<WorkbenchHostDockEntry, "attentionToken" | "badge" | "diagnostics" | "dockRetention" | "hoverActions" | "launchBehavior" | "order" | "state" | "visibility">>;
 interface WorkbenchHostDockEntryStateSource {
     getEntryState(entryId: string): WorkbenchHostDockEntryDynamicState | null | undefined;
@@ -812,6 +814,7 @@ interface WorkbenchHostProps {
     dockPreviewCache?: WorkbenchDockPreviewCache;
     dockPlacement?: WorkbenchDockPlacement;
     dockEntries?: readonly WorkbenchHostDockEntry[];
+    dockEntryPresentationOverrides?: WorkbenchHostDockEntryPresentationOverrides;
     dockStateSource?: WorkbenchHostDockEntryStateSource;
     externalStateSource?: WorkbenchHostExternalStateSource;
     i18n?: I18nRuntime<string>;
@@ -844,7 +847,7 @@ interface WorkbenchHostProps {
     workspaceId: string;
 }
 
-declare function WorkbenchHost({ captureNodePreviewImage, className, contributions, debugDiagnostics, dockPreviewCache, dockPlacement, dockEntries, dockStateSource, externalStateSource, i18n, layoutConstraints, missionControl, minimizeAnimation, nodes, onDockEntryAction, onDockEntryClick, onHandleReady, onLaunchRequest, onMissionControlAdapterReady, onMissionControlRequestOpen, onNodeCloseRequest, projectedNodes, renderBottomChrome, renderTopChrome, snapshotRepository, shortcutsEnabled, wallpaper, windowManagement, workspaceId }: WorkbenchHostProps): react_jsx_runtime.JSX.Element;
+declare function WorkbenchHost({ captureNodePreviewImage, className, contributions, debugDiagnostics, dockPreviewCache, dockPlacement, dockEntryPresentationOverrides, dockEntries, dockStateSource, externalStateSource, i18n, layoutConstraints, missionControl, minimizeAnimation, nodes, onDockEntryAction, onDockEntryClick, onHandleReady, onLaunchRequest, onMissionControlAdapterReady, onMissionControlRequestOpen, onNodeCloseRequest, projectedNodes, renderBottomChrome, renderTopChrome, snapshotRepository, shortcutsEnabled, wallpaper, windowManagement, workspaceId }: WorkbenchHostProps): react_jsx_runtime.JSX.Element;
 
 declare function resolveWorkbenchHostPrepareClose(contributions: readonly WorkbenchContribution[]): WorkbenchHostClosePreparer | undefined;
 
@@ -885,4 +888,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, 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 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, 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 };

package/dist/index.js

@@ -5644,11 +5644,19 @@ function resolveWorkbenchSurfaceWallpaperBackgroundSize(fit) {
 // src/host/hostConfig.ts
 function resolveWorkbenchHostDockEntries(props) {
   const contributions = props.contributions ?? [];
-  return mergeByKey(
+  const mergedEntries = mergeByKey(
     contributions.flatMap((contribution) => contribution.dockEntries ?? []),
     props.dockEntries ?? [],
     (entry) => entry.id
   );
+  const presentationOverrides = props.dockEntryPresentationOverrides;
+  if (!presentationOverrides) {
+    return mergedEntries;
+  }
+  return mergedEntries.map((entry) => {
+    const presentationOverride = presentationOverrides[entry.id];
+    return presentationOverride ? { ...entry, ...presentationOverride } : entry;
+  });
 }
 function resolveWorkbenchHostRuntimeConfig(props) {
   const contributions = props.contributions ?? [];
@@ -13846,6 +13854,7 @@ function WorkbenchHost({
   debugDiagnostics,
   dockPreviewCache,
   dockPlacement,
+  dockEntryPresentationOverrides,
   dockEntries,
   dockStateSource,
   externalStateSource,
@@ -13889,9 +13898,10 @@ function WorkbenchHost({
   const hostDockEntries = useMemo8(
     () => resolveWorkbenchHostDockEntries({
       contributions,
+      dockEntryPresentationOverrides,
       dockEntries
     }),
-    [contributions, dockEntries]
+    [contributions, dockEntries, dockEntryPresentationOverrides]
   );
   const missionControlMode = missionControl?.mode ?? null;
   const missionControlNodeIds = missionControl?.nodeIds;