@tutti-os/workbench-surface 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,717 @@
+import { WorkbenchFrame as WorkbenchFrame$1, WorkbenchSnapshotDisplayModeV1, WorkbenchSnapshot, WorkbenchSnapshotNode } from '@tutti-os/workbench-snapshot';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { HTMLAttributes, ReactNode } from 'react';
+import { I18nRuntime } from '@tutti-os/ui-i18n-runtime';
+import { c as WorkbenchWindowChromeI18nRuntime } from './workbenchHostI18n-5xMPPBkf.js';
+export { b as WorkbenchWindowChromeI18nKey, d as createWorkbenchHostI18nRuntime, e as createWorkbenchWindowChromeI18nRuntime, f as workbenchHostI18nResources, g as workbenchWindowChromeI18nNamespace, h as workbenchWindowChromeI18nResources } from './workbenchHostI18n-5xMPPBkf.js';
+
+interface WorkbenchSize {
+    width: number;
+    height: number;
+}
+type WorkbenchFrame = WorkbenchFrame$1;
+interface WorkbenchSafeArea {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+type WorkbenchDisplayMode = WorkbenchSnapshotDisplayModeV1;
+type WorkbenchSnapTarget = "left" | "right" | "top" | null;
+type WorkbenchQuickLayoutTarget = "left" | "right" | "top" | "bottom";
+type WorkbenchLayoutPreset = {
+    kind: "balanced";
+} | {
+    kind: "row";
+} | {
+    kind: "column";
+};
+interface WorkbenchNode<TData = unknown> {
+    id: string;
+    kind: string;
+    title: string;
+    frame: WorkbenchFrame;
+    displayMode: WorkbenchDisplayMode;
+    restoreFrame: WorkbenchFrame | null;
+    isMinimized: boolean;
+    minimizedAtUnixMs?: number | null;
+    sizeConstraints?: WorkbenchNodeSizeConstraints | null;
+    data: TData;
+}
+interface WorkbenchNodeSizeConstraints {
+    minWidth?: number;
+    minHeight?: number;
+}
+interface WorkbenchState<TData = unknown> {
+    nodes: WorkbenchNode<TData>[];
+    nodeStack: string[];
+    activeDragNodeId: string | null;
+    activeResizeNodeId: string | null;
+    activeSnapTarget: WorkbenchSnapTarget;
+    surfaceSize: WorkbenchSize;
+    layoutConstraints: WorkbenchLayoutConstraints;
+}
+interface WorkbenchLayoutConstraints {
+    minWidth: number;
+    minHeight: number;
+    surfacePadding: number;
+    safeArea: WorkbenchSafeArea;
+}
+interface WorkbenchLayoutConstraintsInput extends Partial<Omit<WorkbenchLayoutConstraints, "safeArea">> {
+    safeArea?: Partial<WorkbenchSafeArea>;
+}
+
+type WorkbenchAction<TData = unknown> = {
+    type: "replaceState";
+    state: Partial<WorkbenchState<TData>>;
+} | {
+    type: "replaceNodes";
+    nodes: WorkbenchNode<TData>[];
+} | {
+    type: "openNode";
+    node: WorkbenchNode<TData>;
+} | {
+    type: "closeNode";
+    nodeID: string;
+} | {
+    type: "focusNode";
+    nodeID: string;
+} | {
+    type: "minimizeNode";
+    nodeID: string;
+} | {
+    type: "restoreNode";
+    nodeID: string;
+} | {
+    type: "enterFullscreen";
+    nodeID: string;
+} | {
+    type: "exitFullscreen";
+    nodeID: string;
+} | {
+    type: "applyQuickLayout";
+    nodeID: string;
+    target: WorkbenchQuickLayoutTarget;
+} | {
+    type: "applyLayoutPreset";
+    nodeIDs: string[];
+    preset: WorkbenchLayoutPreset;
+} | {
+    type: "applyActiveSnapTarget";
+    nodeID: string;
+} | {
+    type: "applySnapTarget";
+    nodeID: string;
+    snapTarget: WorkbenchSnapTarget;
+} | {
+    type: "dragNode";
+    nodeID: string;
+    frame: WorkbenchFrame;
+} | {
+    type: "moveNode";
+    nodeID: string;
+    frame: WorkbenchFrame;
+} | {
+    type: "resizeNode";
+    nodeID: string;
+    frame: WorkbenchFrame;
+} | {
+    type: "setActiveDragNode";
+    nodeID: string | null;
+} | {
+    type: "setActiveResizeNode";
+    nodeID: string | null;
+} | {
+    type: "setActiveSnapTarget";
+    snapTarget: WorkbenchSnapTarget;
+} | {
+    type: "setSurfaceSize";
+    size: WorkbenchSize;
+} | {
+    type: "setLayoutConstraints";
+    constraints: WorkbenchLayoutConstraintsInput;
+} | {
+    type: "setNodeSizeConstraints";
+    nodeID: string;
+    sizeConstraints: WorkbenchNodeSizeConstraints | null;
+};
+
+interface WorkbenchCommands<TData = unknown> {
+    replaceState(state: Partial<WorkbenchState<TData>>): void;
+    replaceNodes(nodes: WorkbenchNode<TData>[]): void;
+    openNode(node: WorkbenchNode<TData>): void;
+    closeNode(nodeID: string): void;
+    focusNode(nodeID: string): void;
+    minimizeNode(nodeID: string): void;
+    restoreNode(nodeID: string): void;
+    enterFullscreen(nodeID: string): void;
+    exitFullscreen(nodeID: string): void;
+    applyQuickLayout(nodeID: string, target: WorkbenchQuickLayoutTarget): void;
+    applyLayoutPreset(nodeIDs: string[], preset: WorkbenchLayoutPreset): void;
+    applyActiveSnapTarget(nodeID: string): void;
+    applySnapTarget(nodeID: string, snapTarget: WorkbenchSnapTarget): void;
+    dragNode(nodeID: string, frame: WorkbenchFrame): void;
+    moveNode(nodeID: string, frame: WorkbenchFrame): void;
+    resizeNode(nodeID: string, frame: WorkbenchFrame): void;
+    setActiveDragNode(nodeID: string | null): void;
+    setActiveResizeNode(nodeID: string | null): void;
+    setActiveSnapTarget(snapTarget: WorkbenchSnapTarget): void;
+    setSurfaceSize(size: WorkbenchSize): void;
+    setLayoutConstraints(constraints: WorkbenchLayoutConstraintsInput): void;
+    setNodeSizeConstraints(nodeID: string, sizeConstraints: WorkbenchNodeSizeConstraints | null): void;
+}
+
+type WorkbenchListener = () => void;
+type WorkbenchUnsubscribe = () => void;
+interface WorkbenchDebugDiagnostics {
+    isEnabled(): boolean;
+    log?(input: {
+        details?: Record<string, unknown>;
+        event: string;
+        level?: "debug" | "info" | "warn" | "error";
+        source: string;
+        workspaceId?: string | null;
+    }): Promise<void> | void;
+}
+interface WorkbenchStore<TData = unknown> {
+    getSnapshot(): WorkbenchState<TData>;
+    subscribe(listener: WorkbenchListener): WorkbenchUnsubscribe;
+    dispatch(action: WorkbenchAction<TData>): void;
+}
+interface WorkbenchController<TData = unknown> extends WorkbenchStore<TData> {
+    readonly commands: WorkbenchCommands<TData>;
+}
+
+declare function createWorkbenchController<TData = unknown>(initialState?: Partial<WorkbenchState<TData>>, options?: {
+    debugDiagnostics?: WorkbenchDebugDiagnostics;
+}): WorkbenchController<TData>;
+
+type WorkbenchMissionControlMode = "activate" | "layout";
+interface WorkbenchMissionControlSnapshot<TData = unknown> {
+    layoutConstraints: WorkbenchLayoutConstraints;
+    surfaceSize: WorkbenchSize;
+    visibleNodes: readonly WorkbenchNode<TData>[];
+}
+interface WorkbenchMissionControlAdapter<TData = unknown> {
+    applyLayoutPreset(nodeIds: string[], preset: WorkbenchLayoutPreset): void;
+    focusNode(nodeId: string): void;
+    getSnapshot(): WorkbenchMissionControlSnapshot<TData>;
+    subscribe(listener: () => void): () => void;
+}
+
+interface WorkbenchNodeRenderFrame {
+    frame: WorkbenchFrame;
+    zIndex: number;
+    isFocused: boolean;
+    presentation?: WorkbenchSurfacePresentation | null;
+}
+interface WorkbenchSurfacePresentation {
+    frameByNodeId: ReadonlyMap<string, WorkbenchFrame>;
+    interaction?: WorkbenchSurfacePresentationInteraction | null;
+    mode: "mission-control";
+}
+interface WorkbenchSurfacePresentationInteraction {
+    mode: "activate" | "layout";
+    onBackdropPress: () => void;
+    onNodePress(nodeId: string): void;
+    selectedNodeIds: ReadonlySet<string>;
+}
+interface WorkbenchRenderNodeContext<TData = unknown> {
+    node: WorkbenchNode<TData>;
+    layout: WorkbenchNodeRenderFrame;
+    controller: WorkbenchController<TData>;
+}
+interface WorkbenchDockContext<TData = unknown> {
+    focusedNodeId: string | null;
+    minimizedNodes: readonly WorkbenchNode<TData>[];
+    nodes: readonly WorkbenchNode<TData>[];
+    controller: WorkbenchController<TData>;
+    genie: {
+        launchNodeFromAnchor(anchorKey: string, nodeID: string, launch: () => void): void;
+        registerDockAnchor(anchorKey: string, element: HTMLElement | null): void;
+    };
+}
+type WorkbenchDockPlacement = "bottom" | "left";
+interface WorkbenchWindowActionContext<TData = unknown> {
+    node: WorkbenchNode<TData>;
+    controller: WorkbenchController<TData>;
+    genie: {
+        minimizeNodeToAnchor(nodeID: string, minimize?: () => void): void;
+    };
+}
+type WorkbenchWindowChromeMode = "system" | "custom-header";
+type WorkbenchFullscreenHeaderMode = "persistent" | "reveal";
+interface WorkbenchResolveWindowChromeModeContext<TData = unknown> {
+    node: WorkbenchNode<TData>;
+    controller: WorkbenchController<TData>;
+}
+type WorkbenchResolveWindowChromeMode<TData = unknown> = (context: WorkbenchResolveWindowChromeModeContext<TData>) => WorkbenchWindowChromeMode;
+type WorkbenchResolveFullscreenHeaderMode<TData = unknown> = (context: WorkbenchResolveWindowChromeModeContext<TData>) => WorkbenchFullscreenHeaderMode | undefined;
+type WorkbenchKeepMinimizedNodeMounted<TData = unknown> = (node: WorkbenchNode<TData>) => boolean;
+interface WorkbenchWindowHeaderDragHandleProps {
+    "data-workbench-drag-handle": "true";
+    onDoubleClick: HTMLAttributes<HTMLElement>["onDoubleClick"];
+    onPointerDown: HTMLAttributes<HTMLElement>["onPointerDown"];
+}
+interface WorkbenchWindowHeaderContext<TData = unknown> {
+    node: WorkbenchNode<TData>;
+    controller: WorkbenchController<TData>;
+    surfaceSize: WorkbenchSize;
+    genie: {
+        minimizeNodeToAnchor(nodeID: string, minimize?: () => void): void;
+    };
+    defaultActions: ReactNode;
+    dragHandleProps: WorkbenchWindowHeaderDragHandleProps;
+}
+type WorkbenchRenderNode<TData = unknown> = (context: WorkbenchRenderNodeContext<TData>) => ReactNode;
+type WorkbenchRenderWindowActions<TData = unknown> = (context: WorkbenchWindowActionContext<TData>) => ReactNode;
+type WorkbenchRenderWindowHeader<TData = unknown> = (context: WorkbenchWindowHeaderContext<TData>) => ReactNode;
+
+interface WorkbenchDockPreviewCacheKey {
+    instanceId: string;
+    instanceKey?: string | null;
+    nodeId: string;
+    typeId: string;
+    workspaceId: string;
+}
+interface WorkbenchDockPreviewCache {
+    read(key: WorkbenchDockPreviewCacheKey): Promise<string | null>;
+    write(input: {
+        key: WorkbenchDockPreviewCacheKey;
+        previewImageUrl: string;
+    }): void;
+}
+type WorkbenchDockPreviewCacheKeyResolver<TData = unknown> = (node: WorkbenchNode<TData>) => WorkbenchDockPreviewCacheKey | null;
+
+interface WorkbenchSurfaceProps<TData = unknown> {
+    captureNodePreviewImage?: (node: WorkbenchNode<TData>) => Promise<string | null> | string | null;
+    className?: string;
+    controller: WorkbenchController<TData>;
+    dockPreviewCache?: WorkbenchDockPreviewCache;
+    dockPlacement?: WorkbenchDockPlacement;
+    interactive?: boolean;
+    layoutConstraints?: WorkbenchLayoutConstraintsInput;
+    missionControlPhase?: "closed" | "entering" | "open" | "closing";
+    presentation?: WorkbenchSurfacePresentation | null;
+    renderBackdrop?: () => ReactNode;
+    renderBottomChrome?: () => ReactNode;
+    renderDock?: (context: WorkbenchDockContext<TData>) => ReactNode;
+    renderNode: WorkbenchRenderNode<TData>;
+    renderOverlay?: () => ReactNode;
+    renderTopChrome?: () => ReactNode;
+    renderWindowActions?: WorkbenchRenderWindowActions<TData>;
+    renderWindowHeader?: WorkbenchRenderWindowHeader<TData>;
+    shouldKeepMinimizedNodeMounted?: WorkbenchKeepMinimizedNodeMounted<TData>;
+    resolveFullscreenHeaderMode?: WorkbenchResolveFullscreenHeaderMode<TData>;
+    resolveDockAnchorKey?: (node: WorkbenchNode<TData>) => string;
+    resolveDockPreviewCacheKey?: WorkbenchDockPreviewCacheKeyResolver<TData>;
+    shortcutsEnabled?: boolean;
+    wallpaper?: WorkbenchSurfaceWallpaper;
+    windowChromeMode?: WorkbenchWindowChromeMode | WorkbenchResolveWindowChromeMode<TData>;
+    windowChromeI18n?: WorkbenchWindowChromeI18nRuntime;
+}
+type WorkbenchSurfaceWallpaperFit = "contain" | "cover" | "stretch" | "center";
+interface WorkbenchSurfaceWallpaper {
+    appearance?: "dark" | "light";
+    fit?: WorkbenchSurfaceWallpaperFit;
+    position?: string;
+    url: string;
+}
+declare function WorkbenchSurface<TData>({ captureNodePreviewImage, className, controller, dockPreviewCache, dockPlacement, interactive, layoutConstraints, missionControlPhase, presentation, renderBackdrop, renderBottomChrome, renderDock, renderNode, renderOverlay, renderTopChrome, renderWindowActions, renderWindowHeader, shouldKeepMinimizedNodeMounted, resolveFullscreenHeaderMode, resolveDockAnchorKey, resolveDockPreviewCacheKey, shortcutsEnabled, wallpaper, windowChromeMode, windowChromeI18n }: WorkbenchSurfaceProps<TData>): react_jsx_runtime.JSX.Element;
+
+interface WorkbenchHostActivation<TPayload = unknown> {
+    payload?: TPayload;
+    sequence: number;
+    type: string;
+}
+interface WorkbenchHostNodeData {
+    activation?: WorkbenchHostActivation | null;
+    dockEntryId?: string | null;
+    instanceId: string;
+    instanceKey?: string | null;
+    isProjected?: boolean;
+    launchSource?: string | null;
+    projectionSubject?: WorkbenchHostProjectedNodeSubject | null;
+    runtimeNodeState?: unknown;
+    snapshotNodeState?: unknown;
+    typeId: string;
+}
+interface WorkbenchHostProjectedNodeSubject {
+    id: string;
+    type: string;
+}
+interface WorkbenchHostProjectedNode {
+    dockEntryId?: string | null;
+    defaultFrame?: WorkbenchFrame;
+    instanceId: string;
+    instanceKey?: string | null;
+    sizeConstraints?: WorkbenchNodeSizeConstraints | null;
+    subject?: WorkbenchHostProjectedNodeSubject | null;
+    title: string;
+    typeId: string;
+}
+interface WorkbenchHostExternalStateLookupInput {
+    instanceId: string;
+    instanceKey?: string | null;
+    nodeId: string;
+    subject?: WorkbenchHostProjectedNodeSubject | null;
+    typeId: string;
+    workspaceId: string;
+}
+interface WorkbenchHostExternalStateSource<TNodeState = unknown, TWorkspaceState = unknown> {
+    getNodeState(input: WorkbenchHostExternalStateLookupInput): TNodeState;
+    getSnapshotNodeState?(input: WorkbenchHostExternalStateLookupInput): unknown;
+    getWorkspaceState(input: {
+        workspaceId: string;
+    }): TWorkspaceState;
+    subscribe?(listener: () => void): () => void;
+}
+type WorkbenchHostNodeCloseDecision = "close" | "keep-open";
+type WorkbenchHostCloseDialogScope = "node" | "window";
+type WorkbenchHostCloseDialogVariant = "default" | "destructive";
+interface WorkbenchHostCloseDialogRequest {
+    cancelLabel: string;
+    confirmLabel: string;
+    description: string;
+    details?: string | null;
+    scope: WorkbenchHostCloseDialogScope;
+    title: string;
+    variant?: WorkbenchHostCloseDialogVariant;
+}
+interface WorkbenchHostCloseEffect {
+    description?: string | null;
+    nodeId: string;
+    title: string;
+    typeId: string;
+}
+interface WorkbenchHostNodeCloseRequest {
+    instanceId: string;
+    instanceKey?: string | null;
+    isProjected: boolean;
+    nodeId: string;
+    subject?: WorkbenchHostProjectedNodeSubject | null;
+    typeId: string;
+    workspaceId: string;
+}
+type WorkbenchHostLaunchReason = "command" | "dock" | "host" | "launchpad" | "shortcut";
+interface WorkbenchHostLaunchInput {
+    dockEntryId?: string;
+    launchSource?: string;
+    payload?: unknown;
+    reason: WorkbenchHostLaunchReason;
+    typeId: string;
+}
+interface WorkbenchHostLaunchRequest extends WorkbenchHostLaunchInput {
+    workspaceId: string;
+}
+type WorkbenchHostLaunchFramePolicy = "absolute" | "cascade" | "cascade-same-type-centered";
+interface WorkbenchHostLaunchResult {
+    activation?: {
+        payload?: unknown;
+        type: string;
+    } | null;
+    defaultFrame?: WorkbenchFrame;
+    displayMode?: WorkbenchDisplayMode;
+    dockEntryId?: string;
+    framePolicy: WorkbenchHostLaunchFramePolicy;
+    instanceId: string;
+    instanceKey?: string | null;
+    launchSource?: string | null;
+    reuseDockEntryNode?: boolean;
+    sizeConstraints?: WorkbenchNodeSizeConstraints | null;
+    title?: string;
+    typeId: string;
+}
+type WorkbenchHostDockEntryVisibility = "always" | "when-open" | "never";
+type WorkbenchHostDockEntryLaunchBehavior = "enabled" | "disabled";
+type WorkbenchHostDockEntryStateKind = "enabled" | "disabled" | "loading" | "unavailable";
+interface WorkbenchHostDockEntryState {
+    kind: WorkbenchHostDockEntryStateKind;
+    reason?: string;
+}
+type WorkbenchHostDockEntryBadge = {
+    kind: "count";
+    value: number;
+} | {
+    kind: "status";
+    status: "running" | "completed" | "failed" | "warning";
+} | {
+    content: ReactNode;
+    kind: "custom";
+};
+interface WorkbenchHostDockEntryAction {
+    disabled?: boolean;
+    id: string;
+    label: string;
+    pendingLabel?: string;
+}
+interface WorkbenchHostDockPopupItemInput {
+    externalNodeState?: unknown;
+    isFocused: boolean;
+    isMinimized: boolean;
+    node: WorkbenchNode<WorkbenchHostNodeData>;
+}
+type WorkbenchHostNodePreviewCapture = (input: WorkbenchHostDockPopupItemInput) => Promise<string | null> | string | null;
+interface WorkbenchHostDockPopupItemDescriptor {
+    previewImageUrl?: string | null;
+    subtitle?: string | null;
+    title?: string | null;
+}
+type WorkbenchHostDockPopupCardLabelMode = "hidden" | "hover-overlay";
+interface WorkbenchHostDockEntry {
+    anchorKey?: string;
+    attentionToken?: number | string | null;
+    badge?: WorkbenchHostDockEntryBadge;
+    capturePopupItemPreview?: WorkbenchHostNodePreviewCapture;
+    clickActionId?: string;
+    hoverActions?: readonly WorkbenchHostDockEntryAction[];
+    icon: ReactNode;
+    iconSize?: "default" | "large";
+    id: string;
+    label: string;
+    instanceMode?: WorkbenchHostNodeInstanceStrategy["mode"];
+    launchBehavior?: WorkbenchHostDockEntryLaunchBehavior;
+    launchPayload?: unknown;
+    matchNode?: (node: WorkbenchNode<WorkbenchHostNodeData>) => boolean;
+    order?: number;
+    popupCardLabelMode?: WorkbenchHostDockPopupCardLabelMode;
+    resolvePopupItem?: (input: WorkbenchHostDockPopupItemInput) => WorkbenchHostDockPopupItemDescriptor;
+    separatorAfter?: boolean;
+    sectionId?: string;
+    state?: WorkbenchHostDockEntryState;
+    typeId: string;
+    visibility?: WorkbenchHostDockEntryVisibility;
+}
+type WorkbenchHostDockEntryDynamicState = Partial<Pick<WorkbenchHostDockEntry, "attentionToken" | "badge" | "hoverActions" | "launchBehavior" | "order" | "state" | "visibility">>;
+interface WorkbenchHostDockEntryStateSource {
+    getEntryState(entryId: string): WorkbenchHostDockEntryDynamicState | null | undefined;
+    subscribe(listener: () => void): () => void;
+}
+interface WorkbenchHostNodeWindowCapabilities {
+    closable?: boolean;
+    defaultOpen?: boolean;
+    fullscreenHeaderMode?: "persistent" | "reveal";
+    fullscreenable?: boolean;
+    keepMountedWhenMinimized?: boolean | ((node: WorkbenchNode<WorkbenchHostNodeData>) => boolean);
+    minimizable?: boolean;
+    minimizedDock?: WorkbenchHostNodeMinimizedDockCapability;
+    persists?: boolean;
+    restoreOnLoad?: boolean;
+}
+interface WorkbenchHostNodeMinimizedDockCapability {
+    capturePreview?: WorkbenchHostNodePreviewCapture;
+    kind: "snapshot";
+}
+interface WorkbenchHostSingleInstanceStrategy {
+    mode?: "single";
+}
+interface WorkbenchHostMultiInstanceStrategy {
+    mode: "multi";
+}
+type WorkbenchHostNodeInstanceStrategy = WorkbenchHostSingleInstanceStrategy | WorkbenchHostMultiInstanceStrategy;
+interface WorkbenchHostNodeBodyContext<TExternalNodeState = unknown, TExternalWorkspaceState = unknown> {
+    activation: WorkbenchHostActivation | null;
+    displayMode: WorkbenchNode<WorkbenchHostNodeData>["displayMode"];
+    externalNodeState: TExternalNodeState;
+    externalWorkspaceState: TExternalWorkspaceState;
+    focus(): void;
+    host: WorkbenchHostHandle;
+    instanceId: string;
+    instanceKey?: string | null;
+    isFocused: boolean;
+    node: WorkbenchNode<WorkbenchHostNodeData>;
+    setNodeRuntimeState(state: unknown): void;
+    setSnapshotNodeState(state: unknown): void;
+}
+interface WorkbenchHostWindowCloseEffectContext<TExternalNodeState = unknown, TExternalWorkspaceState = unknown> {
+    externalNodeState: TExternalNodeState;
+    externalWorkspaceState: TExternalWorkspaceState;
+    instanceId: string;
+    instanceKey?: string | null;
+    node: WorkbenchNode<WorkbenchHostNodeData>;
+    workspaceId: string;
+}
+interface WorkbenchHostNodeLeaseHandle {
+    release(): void;
+}
+interface WorkbenchHostNodeLeaseContext {
+    node: WorkbenchNode<WorkbenchHostNodeData>;
+    workspaceId: string;
+}
+interface WorkbenchHostNodeHeaderWindowActions {
+    applyQuickLayout(target: WorkbenchQuickLayoutTarget): void;
+    close(): void;
+    focus(): void;
+    minimize(): void;
+    resize(frame: WorkbenchFrame): void;
+    toggleDisplayMode(): void;
+}
+interface WorkbenchHostNodeHeaderContext<TExternalNodeState = unknown, TExternalWorkspaceState = unknown> {
+    activation: WorkbenchHostActivation | null;
+    defaultActions: ReactNode;
+    displayMode: WorkbenchNode<WorkbenchHostNodeData>["displayMode"];
+    dragHandleProps: WorkbenchWindowHeaderDragHandleProps;
+    externalNodeState: TExternalNodeState;
+    externalWorkspaceState: TExternalWorkspaceState;
+    instanceId: string;
+    instanceKey?: string | null;
+    isFocused: boolean;
+    node: WorkbenchNode<WorkbenchHostNodeData>;
+    surfaceSize: WorkbenchSize;
+    windowActions: WorkbenchHostNodeHeaderWindowActions;
+}
+type WorkbenchHostMissionControlMode = WorkbenchMissionControlMode;
+type WorkbenchHostBodyRenderer<TExternalNodeState = unknown, TExternalWorkspaceState = unknown> = {
+    bivarianceHack(context: WorkbenchHostNodeBodyContext<TExternalNodeState, TExternalWorkspaceState>): ReactNode;
+}["bivarianceHack"];
+type WorkbenchHostHeaderRenderer<TExternalNodeState = unknown, TExternalWorkspaceState = unknown> = {
+    bivarianceHack(context: WorkbenchHostNodeHeaderContext<TExternalNodeState, TExternalWorkspaceState>): ReactNode;
+}["bivarianceHack"];
+type WorkbenchHostWindowCloseEffectResolver<TExternalNodeState = unknown, TExternalWorkspaceState = unknown> = {
+    bivarianceHack(context: WorkbenchHostWindowCloseEffectContext<TExternalNodeState, TExternalWorkspaceState>): Promise<WorkbenchHostCloseEffect | null | void> | WorkbenchHostCloseEffect | null | void;
+}["bivarianceHack"];
+interface WorkbenchHostNodeDefinition<TExternalNodeState = unknown, TExternalWorkspaceState = unknown> {
+    createLease?: (context: WorkbenchHostNodeLeaseContext) => WorkbenchHostNodeLeaseHandle | null | void;
+    description?: string;
+    frame: WorkbenchFrame;
+    getWindowCloseEffect?: WorkbenchHostWindowCloseEffectResolver<TExternalNodeState, TExternalWorkspaceState>;
+    instance?: WorkbenchHostNodeInstanceStrategy;
+    renderBody: WorkbenchHostBodyRenderer<TExternalNodeState, TExternalWorkspaceState>;
+    renderHeader?: WorkbenchHostHeaderRenderer<TExternalNodeState, TExternalWorkspaceState>;
+    sizeConstraints?: WorkbenchNodeSizeConstraints | null;
+    title: string;
+    typeId: string;
+    window?: WorkbenchHostNodeWindowCapabilities;
+}
+interface WorkbenchHostSnapshotRepository {
+    hasLoaded?(workspaceId: string): boolean;
+    load(workspaceId: string): Promise<WorkbenchSnapshot | null>;
+    readCached?(workspaceId: string): WorkbenchSnapshot | null;
+    save(workspaceId: string, snapshot: WorkbenchSnapshot): Promise<WorkbenchSnapshot> | WorkbenchSnapshot;
+}
+type WorkbenchHostActivationTarget = {
+    nodeId: string;
+} | {
+    instanceId?: string;
+    typeId: string;
+};
+interface WorkbenchHostHandle {
+    activateNode(target: WorkbenchHostActivationTarget, activation: {
+        payload?: unknown;
+        type: string;
+    }): void;
+    clearNodeActivation?(nodeId: string, sequence: number): void;
+    closeNode(nodeId: string): void;
+    collectWindowCloseEffects(): Promise<readonly WorkbenchHostCloseEffect[]>;
+    dispose(): void;
+    exitFullscreenNode(nodeId: string): void;
+    focusNode(nodeId: string): void;
+    getSnapshot(): WorkbenchState<WorkbenchHostNodeData>;
+    isHydrating?(): boolean;
+    launchNode(input: WorkbenchHostLaunchInput): Promise<string | null>;
+    load(): Promise<void>;
+    requestNodeClose(nodeId: string): void;
+    reconcileProjectedNodes(projectedNodes: readonly WorkbenchHostProjectedNode[]): void;
+    setNodeRuntimeState(nodeId: string, state: unknown): void;
+    setNodeSizeConstraints(nodeId: string, sizeConstraints: WorkbenchNodeSizeConstraints | null): void;
+    setSnapshotNodeState(nodeId: string, state: unknown): void;
+    setNodeTitle(nodeId: string, title: string): void;
+}
+interface WorkbenchHostChromeRenderContext {
+    controller: WorkbenchController<WorkbenchHostNodeData>;
+    activateNode: WorkbenchHostHandle["activateNode"];
+    focusNode: WorkbenchHostHandle["focusNode"];
+    launchNode: WorkbenchHostHandle["launchNode"];
+}
+interface WorkbenchHostMissionControlProps {
+    mode: WorkbenchMissionControlMode | null;
+    onRequestClose: () => void;
+}
+interface WorkbenchHostClosePreparationContext {
+    host: WorkbenchHostHandle;
+    workspaceId: string;
+}
+type WorkbenchHostClosePreparer = (context: WorkbenchHostClosePreparationContext) => Promise<boolean> | boolean;
+interface WorkbenchContribution {
+    dockEntries?: readonly WorkbenchHostDockEntry[];
+    externalStateSource?: WorkbenchHostExternalStateSource;
+    id: string;
+    nodes?: readonly WorkbenchHostNodeDefinition[];
+    onLaunchRequest?: (request: WorkbenchHostLaunchRequest) => Promise<WorkbenchHostLaunchResult | null | void> | WorkbenchHostLaunchResult | null | void;
+    onNodeCloseRequest?: (request: WorkbenchHostNodeCloseRequest) => Promise<WorkbenchHostNodeCloseDecision | void> | WorkbenchHostNodeCloseDecision | void;
+    prepareHostClose?: WorkbenchHostClosePreparer;
+}
+interface WorkbenchHostProps {
+    className?: string;
+    contributions?: readonly WorkbenchContribution[];
+    debugDiagnostics?: WorkbenchDebugDiagnostics;
+    dockPreviewCache?: WorkbenchDockPreviewCache;
+    dockPlacement?: WorkbenchDockPlacement;
+    dockEntries?: readonly WorkbenchHostDockEntry[];
+    dockStateSource?: WorkbenchHostDockEntryStateSource;
+    externalStateSource?: WorkbenchHostExternalStateSource;
+    i18n?: I18nRuntime<string>;
+    layoutConstraints?: WorkbenchLayoutConstraintsInput;
+    missionControl?: WorkbenchHostMissionControlProps;
+    nodes?: readonly WorkbenchHostNodeDefinition[];
+    onDockEntryAction?: (input: {
+        actionId: string;
+        entryId: string;
+        host: WorkbenchHostHandle;
+    }) => Promise<void> | void;
+    onDockEntryClick?: (input: {
+        entryId: string;
+        host: WorkbenchHostHandle;
+        nodeId?: string;
+    }) => Promise<void> | void;
+    onLaunchRequest?: (request: WorkbenchHostLaunchRequest) => Promise<WorkbenchHostLaunchResult | null | void> | WorkbenchHostLaunchResult | null | void;
+    onMissionControlAdapterReady?: (adapter: WorkbenchMissionControlAdapter<WorkbenchHostNodeData> | null) => void;
+    onNodeCloseRequest?: (request: WorkbenchHostNodeCloseRequest) => Promise<WorkbenchHostNodeCloseDecision | void> | WorkbenchHostNodeCloseDecision | void;
+    onHandleReady?: (handle: WorkbenchHostHandle | null) => void;
+    projectedNodes?: readonly WorkbenchHostProjectedNode[];
+    renderBottomChrome?: (context: WorkbenchHostChromeRenderContext) => ReactNode;
+    renderTopChrome?: (context: WorkbenchHostChromeRenderContext) => ReactNode;
+    snapshotRepository: WorkbenchHostSnapshotRepository;
+    shortcutsEnabled?: boolean;
+    wallpaper?: WorkbenchSurfaceWallpaper;
+    workspaceId: string;
+}
+
+declare function WorkbenchHost({ className, contributions, debugDiagnostics, dockPreviewCache, dockPlacement, dockEntries, dockStateSource, externalStateSource, i18n, layoutConstraints, missionControl, nodes, onDockEntryAction, onDockEntryClick, onHandleReady, onLaunchRequest, onMissionControlAdapterReady, onNodeCloseRequest, projectedNodes, renderBottomChrome, renderTopChrome, snapshotRepository, shortcutsEnabled, wallpaper, workspaceId }: WorkbenchHostProps): react_jsx_runtime.JSX.Element;
+
+declare function resolveWorkbenchHostPrepareClose(contributions: readonly WorkbenchContribution[]): WorkbenchHostClosePreparer | undefined;
+
+declare const workbenchFocusInputActivationType = "focus-input";
+
+interface CreateWorkbenchNodeInput<TData = unknown> {
+    data: TData;
+    displayMode?: WorkbenchNode<TData>["displayMode"];
+    frame: WorkbenchNode<TData>["frame"];
+    id: string;
+    isMinimized?: boolean;
+    kind: string;
+    minimizedAtUnixMs?: WorkbenchNode<TData>["minimizedAtUnixMs"];
+    restoreFrame?: WorkbenchNode<TData>["restoreFrame"];
+    sizeConstraints?: WorkbenchNode<TData>["sizeConstraints"];
+    title: string;
+}
+interface CreateWorkbenchSnapshotFromStateOptions {
+    activeSpaceId?: WorkbenchSnapshot["activeSpaceId"];
+    metadata?: WorkbenchSnapshot["metadata"];
+    spaces?: WorkbenchSnapshot["spaces"];
+}
+declare function createWorkbenchNode<TData = unknown>(input: CreateWorkbenchNodeInput<TData>): WorkbenchNode<TData>;
+declare function createWorkbenchNodeFromSnapshot<TData = unknown>(snapshotNode: WorkbenchSnapshotNode): WorkbenchNode<TData>;
+declare function createWorkbenchStateFromSnapshot<TData = unknown>(snapshot: WorkbenchSnapshot): Pick<WorkbenchState<TData>, "nodeStack" | "nodes">;
+declare function createWorkbenchSnapshotFromState<TData = unknown>(state: Pick<WorkbenchState<TData>, "nodeStack" | "nodes">, options?: CreateWorkbenchSnapshotFromStateOptions): WorkbenchSnapshot;
+
+interface WorkbenchHostNodeIdentityInput {
+    instanceId: string;
+    typeId: string;
+}
+declare function createWorkbenchHostProjectedNodeId(input: WorkbenchHostNodeIdentityInput): string;
+declare function createWorkbenchHostLaunchedNodeId(input: WorkbenchHostNodeIdentityInput): string;
+
+declare function useWorkbenchSelector<TData, TResult>(selector: (state: WorkbenchState<TData>) => TResult): TResult;
+
+export { type CreateWorkbenchNodeInput, type CreateWorkbenchSnapshotFromStateOptions, type WorkbenchContribution, type WorkbenchController, type WorkbenchDebugDiagnostics, type WorkbenchDisplayMode, type WorkbenchDockContext, type WorkbenchDockPlacement, type WorkbenchDockPreviewCache, type WorkbenchDockPreviewCacheKey, type WorkbenchDockPreviewCacheKeyResolver, 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, createWorkbenchController, createWorkbenchHostLaunchedNodeId, createWorkbenchHostProjectedNodeId, createWorkbenchNode, createWorkbenchNodeFromSnapshot, createWorkbenchSnapshotFromState, createWorkbenchStateFromSnapshot, resolveWorkbenchHostPrepareClose, useWorkbenchSelector, workbenchFocusInputActivationType };