@pstdio/workbench 0.7.1 → 0.9.0

package/dist/react.d.ts

@@ -1,24 +1,43 @@
 import { BoxProps } from '@chakra-ui/react';
 import { ComponentType } from 'react';
-import { Context } from 'react';
+import { ControlsQueryResult } from '@pstdio/sdk/extensions';
+import { ControlValue } from '@pstdio/sdk/extensions';
+import { ControlValueMap } from '@pstdio/sdk/extensions';
+import { DockedWorkbenchRegion } from '@pstdio/sdk/extensions';
 import { FileIconThemePreferenceOption as FileIconThemePreferenceOption_2 } from '@pstdio/ui';
+import { FileRendererSectionTarget } from '@pstdio/sdk/extensions';
 import { FileUploadValue } from '@pstdio/ui';
 import { IconProps } from '@chakra-ui/react';
 import { JSX } from 'react/jsx-runtime';
 import { JSXElementConstructor } from 'react';
+import { KanbanRendererAttributeDisplay } from '@pstdio/sdk/extensions';
 import { ListRowActionMenuItem } from '@pstdio/ui';
+import { Localizable } from '@pstdio/sdk/extensions';
+import { ModeRegionSettings } from '@pstdio/sdk/extensions';
+import { NavigationTargetPage as NavigationTargetPage_2 } from '@pstdio/sdk/extensions';
+import { NavigationTargetPanel as NavigationTargetPanel_2 } from '@pstdio/sdk/extensions';
+import { PageLocation } from '@pstdio/sdk/extensions';
+import { PageMain } from '@pstdio/sdk/extensions';
+import { PageOpenIntent } from '@pstdio/sdk/extensions';
+import { PageRef } from '@pstdio/sdk/extensions';
+import { PageSlot } from '@pstdio/sdk/extensions';
 import { Param } from '@pstdio/ui';
 import { ParamEditorProps } from '@pstdio/ui';
 import { ParamValue } from '@pstdio/ui';
+import { PlacementIdentity } from '@pstdio/sdk/extensions';
+import { PlacementItem } from '@pstdio/sdk/extensions';
+import { PlacementRef } from '@pstdio/sdk/extensions';
 import { ReactElement } from 'react';
 import { ReactNode } from 'react';
 import { ReactPortal } from 'react';
+import { ResourceConstraint } from '@pstdio/sdk/extensions';
 import { ResourceContextAction as ResourceContextAction_2 } from '@pstdio/ui';
+import { ResourceRef } from '@pstdio/sdk/extensions';
 import { TerminalBridge } from '@pstdio/ui/terminal';
-import { ThemePreference as ThemePreference_3 } from '@pstdio/ui';
-import { ThemePreferenceOption as ThemePreferenceOption_3 } from '@pstdio/ui';
+import { ThemePreference as ThemePreference_2 } from '@pstdio/ui';
+import { ThemePreferenceOption as ThemePreferenceOption_2 } from '@pstdio/ui';
 
-declare interface AttributeDescriptor {
+declare interface AttributeDescriptor<TNode = unknown> {
     id: string;
     label: string;
     type: AttributeType;
@@ -28,22 +47,19 @@ declare interface AttributeDescriptor {
     displayable?: boolean;
     editable?: boolean;
     display?: AttributeDisplayDescriptor;
-    render?: (value: unknown, row: KanbanRendererRow) => ReactNode;
+    render?: (value: unknown, row: KanbanRendererRow) => TNode;
     compare?: (a: unknown, b: unknown) => number;
 }
 
-declare type AttributeDisplayDescriptor = {
-    kind: "workspace-badge";
-    itemsAttributeId: string;
-};
+declare type AttributeDisplayDescriptor = KanbanRendererAttributeDisplay;
 
 /**
  * Reactive source for an entire attribute schema. Lets a contribution
  * add/remove/edit attributes at runtime without re-registering.
  */
-declare interface AttributesSource {
+declare interface AttributesSource<TNode = unknown> {
     subscribe: (listener: () => void) => () => void;
-    getSnapshot: () => AttributeDescriptor[];
+    getSnapshot: () => AttributeDescriptor<TNode>[];
 }
 
 declare type AttributeType = {
@@ -62,29 +78,20 @@ declare type AttributeType = {
     kind: "user";
 };
 
-declare interface BoardColumnAction {
+declare interface BoardColumnAction<TIcon = unknown> {
     id: string;
     label: string;
-    icon: ComponentType<{
-        size?: number | string;
-    }>;
+    icon: TIcon;
 }
 
 /** Board-column behavior and menu configuration for a resolved column group. */
-declare interface BoardColumnConfig {
+declare interface BoardColumnConfig<TIcon = unknown> {
     /** Color palette token used for the column header and group badges. */
     color?: string;
     canDragIn?: boolean;
     canDragOut?: boolean;
     canCreate?: boolean;
-    actions?: BoardColumnAction[];
-}
-
-export declare const buildSettingsTreeBody: (input: BuildSettingsTreeInput) => Promise<TreeViewSection[]>;
-
-export declare interface BuildSettingsTreeInput {
-    settings: SettingsRegistry;
-    hasProjectScope: boolean;
+    actions?: BoardColumnAction<TIcon>[];
 }
 
 /**
@@ -93,12 +100,12 @@ export declare interface BuildSettingsTreeInput {
  */
 declare interface CollectionSettingsPanel<TItem = unknown> extends SettingsPanelBase {
     kind: "collection";
+    viewId: string;
     items(): TItem[] | Promise<TItem[]>;
     itemId(item: TItem): string;
     itemLabel(item: TItem): string;
     itemIcon?(item: TItem): string | undefined;
     groupBy?: SettingsCollectionGroupBy<TItem>;
-    renderItem(item: TItem, input: WorkbenchPanelRenderInput): unknown;
     actions?: SettingsAction[];
 }
 
@@ -178,6 +185,7 @@ declare interface CommandParamDescriptor {
     accept?: string;
     multiple?: boolean;
     metadata?: Record<string, unknown>;
+    resolvedFrom?: "resource";
 }
 
 export declare interface CommandParamEntry extends CommandParamDescriptor {
@@ -268,25 +276,17 @@ declare interface ContributionMetadata {
 
 declare type ContributionSource = "module" | "extension";
 
-declare type ContributionSource_2 = "module" | "extension";
-
 declare interface ControllerTerminalBridgeOptions {
+    getBindingId?: () => string | undefined;
     getResource?: () => ResourceRef | undefined;
     getTitle?: () => string | undefined;
 }
 
 declare interface ControlsApplyInput {
-    values: Record<string, unknown>;
+    values: ControlValueMap;
     resource?: ResourceRef;
 }
 
-declare interface ControlsQueryResult {
-    params?: unknown[];
-    groups?: unknown[];
-    values?: Record<string, unknown>;
-    readOnly?: boolean;
-}
-
 declare interface ControlsRendererContribution {
     id: string;
     title: string;
@@ -294,7 +294,7 @@ declare interface ControlsRendererContribution {
     emptyTitle?: string;
     emptyDescription?: string;
     layout?: ControlsRendererLayout;
-    defaultValues?: Record<string, unknown>;
+    defaultValues?: ControlValueMap;
     /** Load the control declarations + current values for the active resource. */
     executeQuery(resource?: ResourceRef): Promise<ControlsQueryResult> | ControlsQueryResult;
     /** Live-save a single control edit. Omit for explicit-apply or read-only panels. */
@@ -306,10 +306,6 @@ declare interface ControlsRendererContribution {
     subscribe?: (listener: () => void) => Disposable_2 | (() => void);
 }
 
-declare type ControlsRendererImplementation = (input: WorkbenchPanelRenderInput & {
-    controlsRendererId: string;
-}) => unknown;
-
 declare interface ControlsRendererLayout {
     region?: ControlsRendererRegion;
     defaultPx?: number;
@@ -317,28 +313,8 @@ declare interface ControlsRendererLayout {
     maxPx?: number;
 }
 
-declare interface ControlsRendererRefreshEvent {
-    controlsRendererId: string;
-}
-
-declare type ControlsRendererRefreshListener = (event: ControlsRendererRefreshEvent) => void;
-
 declare type ControlsRendererRegion = "main-right-menu" | "secondary" | "overlay";
 
-declare interface ControlsRendererRegistry {
-    controlsStore: WorkbenchStore<ControlsRendererStoreState>;
-    registerControlsRenderer(contribution: ControlsRendererContribution, metadata?: ContributionMetadata): Disposable_2;
-    setControlsRendererImplementation(impl: ControlsRendererImplementation): void;
-    getControlsRenderer(id: string): RegisteredControlsRendererContribution | undefined;
-    listControlsRenderers(): RegisteredControlsRendererContribution[];
-    refreshControlsRenderer(id: string): void;
-    onDidRefreshControlsRenderer(listener: ControlsRendererRefreshListener): Disposable_2;
-}
-
-declare interface ControlsRendererStoreState {
-    renderers: Record<string, RegisteredControlsRendererContribution>;
-}
-
 declare interface ControlsResetInput {
     controlIds?: string[];
     resource?: ResourceRef;
@@ -346,8 +322,8 @@ declare interface ControlsResetInput {
 
 declare interface ControlsUpdateValueInput {
     controlId: string;
-    value: unknown;
-    values: Record<string, unknown>;
+    value: ControlValue;
+    values: ControlValueMap;
     resource?: ResourceRef;
 }
 
@@ -367,11 +343,11 @@ declare interface CreateTreeContextMenuItemsInput {
 }
 
 export declare const createWorkbenchHotkeyRegistrations: (input: CreateWorkbenchHotkeyRegistrationsInput) => {
-    commandId: string;
+    id: string;
     hotkey: KeybindingSequence;
     enabled: boolean;
     ignoreInputs: true;
-    execute: () => Promise<unknown>;
+    execute: () => Promise<readonly unknown[]>;
 }[];
 
 declare interface CreateWorkbenchHotkeyRegistrationsInput {
@@ -380,13 +356,6 @@ declare interface CreateWorkbenchHotkeyRegistrationsInput {
     commandIds?: readonly string[];
 }
 
-export declare const createWorkbenchRendererRegistry: (input?: CreateWorkbenchRendererRegistryInput) => WorkbenchRendererRegistry;
-
-declare interface CreateWorkbenchRendererRegistryInput {
-    initialRenderers?: WorkbenchRendererRegistration[];
-    createHost?: () => HTMLElement;
-}
-
 export declare const createWorkbenchResourceActions: (workbench: WorkbenchCoreContributionContext, resource: ResourceRef) => ResourceContextAction_2[];
 
 export declare const createWorkbenchSettingsModule: (options?: WorkbenchSettingsModuleOptions) => WorkbenchModuleContribution;
@@ -401,15 +370,6 @@ export declare const createWorkbenchSettingsModule: (options?: WorkbenchSettings
  */
 export declare const createWorkbenchTerminalModule: () => WorkbenchModuleContribution;
 
-/**
- * Renders its own page. `render` returns `unknown` so core stays React-free — the
- * React layer treats the result as a node, exactly like WorkbenchRendererRegistration.
- */
-declare interface CustomSettingsPanel extends SettingsPanelBase {
-    kind: "custom";
-    render(input: WorkbenchPanelRenderInput): unknown;
-}
-
 declare interface DataTableRendererColumn {
     id: string;
     label?: string;
@@ -463,10 +423,6 @@ declare interface DataTableRendererContribution {
     onRowActivate?: (row: DataTableRendererRow) => Promise<void> | void;
 }
 
-declare type DataTableRendererImplementation = (input: WorkbenchPanelRenderInput & {
-    dataTableRendererId: string;
-}) => unknown;
-
 declare interface DataTableRendererQueryContext {
     resource?: ResourceRef;
     modeId?: string;
@@ -477,20 +433,6 @@ declare interface DataTableRendererQueryResult {
     columns?: DataTableRendererColumn[];
 }
 
-declare interface DataTableRendererRefreshEvent {
-    dataTableRendererId: string;
-}
-
-declare interface DataTableRendererRegistry {
-    dataTableStore: WorkbenchStore<DataTableRendererStoreState>;
-    registerDataTableRenderer(contribution: DataTableRendererContribution, metadata?: ContributionMetadata): Disposable_2;
-    setDataTableRendererImplementation(implementation: DataTableRendererImplementation): void;
-    getDataTableRenderer(id: string): RegisteredDataTableRendererContribution | undefined;
-    listDataTableRenderers(): RegisteredDataTableRendererContribution[];
-    refreshDataTableRenderer(id: string): void;
-    onDidRefreshDataTableRenderer(listener: (event: DataTableRendererRefreshEvent) => void): Disposable_2;
-}
-
 declare interface DataTableRendererRow {
     id: string;
     values: Record<string, unknown>;
@@ -513,10 +455,6 @@ declare interface DataTableRendererSelectionAction {
     run(rows: DataTableRendererRow[]): Promise<void> | void;
 }
 
-declare interface DataTableRendererStoreState {
-    renderers: Record<string, RegisteredDataTableRendererContribution>;
-}
-
 declare interface DataTableRendererThemeColor {
     light: string;
     dark: string;
@@ -532,6 +470,8 @@ declare interface Disposable_2 {
 
 export declare const disposeWorkbenchModuleHostRegistrations: (registrations: Map<string, WorkbenchModuleHostRegistration>) => void;
 
+declare type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
+
 declare interface EnumOption {
     value: string;
     label: string;
@@ -616,76 +556,19 @@ declare interface FileRendererContribution {
     save?(resource: ResourceRef | undefined, content: string, origin?: FileRendererRefreshOrigin): Promise<FileRendererSaveResult | undefined> | FileRendererSaveResult | void;
 }
 
-declare type FileRendererImplementation = (input: WorkbenchPanelRenderInput & {
-    fileRendererId: string;
-}) => unknown;
-
-declare interface FileRendererRefreshEnvelope {
-    resourceUri?: string;
-    origin?: FileRendererRefreshOrigin;
-    revision?: string;
-}
-
-declare interface FileRendererRefreshEvent extends FileRendererRefreshEnvelope {
-    fileRendererId: string;
-}
-
-declare type FileRendererRefreshListener = (event: FileRendererRefreshEvent) => void;
-
 declare interface FileRendererRefreshOrigin {
     rendererId: string;
     instanceId: string;
     operationId: string;
 }
 
-declare interface FileRendererRegistry {
-    fileRendererStore: WorkbenchStore<FileRendererStoreState>;
-    registerFileRenderer(contribution: FileRendererContribution, metadata?: ContributionMetadata): Disposable_2;
-    setFileRendererImplementation(impl: FileRendererImplementation): void;
-    getFileRenderer(id: string): RegisteredFileRendererContribution | undefined;
-    listFileRenderers(): RegisteredFileRendererContribution[];
-    refreshFileRenderer(id: string, event?: FileRendererRefreshEnvelope): void;
-    onDidRefreshFileRenderer(listener: FileRendererRefreshListener): Disposable_2;
-}
-
 declare interface FileRendererSaveResult {
     revision?: string;
 }
 
-declare interface FileRendererStoreState {
-    renderers: Record<string, RegisteredFileRendererContribution>;
-}
-
-declare interface HistoryController {
-    store: WorkbenchStore<HistoryStoreState>;
-    /** Snapshot the history for a compound navigation; the returned function restores it. */
-    createCheckpoint(): () => void;
-    goBack(): HistoryEntry | undefined;
-    goForward(): HistoryEntry | undefined;
-    goPrevious(): HistoryEntry | undefined;
-    recentlyClosed(): readonly HistoryEntry[];
-    reopenLastClosed(): HistoryEntry | undefined;
-    setPersistenceScope(scope: string | undefined): void;
-    getPersistenceScope(): string | undefined;
-    restore(): HistoryEntry | undefined;
-    flush(): void;
-    clear(): void;
-}
-
-declare type HistoryEntry = WorkbenchNavigationEntry;
-
-declare interface HistoryStoreState {
-    entries: readonly WorkbenchNavigationEntry[];
-    cursor: number;
-    recentlyClosed: readonly WorkbenchNavigationEntry[];
-    hydrating: boolean;
-}
-
 export declare const isCommandFilesParamValue: (value: unknown) => value is CommandFilesParamValue;
 
-export declare const isSettingsScopeVisible: (scope: SettingsScope | undefined, hasProjectScope: boolean) => boolean;
-
-declare interface KanbanRendererContribution<TRow extends KanbanRendererRow = KanbanRendererRow> {
+declare interface KanbanRendererContribution<TRow extends KanbanRendererRow = KanbanRendererRow, TNode = unknown, TIcon = unknown> {
     id: string;
     title: string;
     resourceKind?: string;
@@ -700,9 +583,9 @@ declare interface KanbanRendererContribution<TRow extends KanbanRendererRow = Ka
      * `WorkbenchKanbanView` subscribes so additions / removals / kind changes
      * propagate live without re-registering the renderer.
      */
-    attributes: AttributeDescriptor[] | AttributesSource;
+    attributes: AttributeDescriptor<TNode>[] | AttributesSource<TNode>;
     /** Per-board-column overrides (color, drag/create rules, custom actions). */
-    getBoardColumnConfig?: (groupKey: string) => BoardColumnConfig;
+    getBoardColumnConfig?: (groupKey: string) => BoardColumnConfig<TIcon>;
     hideToolbar?: boolean;
     emptyTitle?: string;
     emptyDescription?: string;
@@ -721,7 +604,7 @@ declare interface KanbanRendererContribution<TRow extends KanbanRendererRow = Ka
     /** Row activation surfaced by the renderer (mirrored from <KanbanRenderer>). */
     onRowActivate?: (row: TRow) => Promise<void> | void;
     /** Per-row right-click context menu actions (mirrored from <KanbanRenderer>). */
-    getRowContextMenuActions?: (row: TRow) => ResourceContextAction[];
+    getRowContextMenuActions?: (row: TRow) => ResourceContextAction<TNode>[];
     /**
      * Fires for inline attribute edits AND for cross-column drag-to-reorder on
      * the board (the renderer passes the grouping attribute id + the target
@@ -778,10 +661,6 @@ declare interface KanbanRendererCreateSubmission {
 
 declare type KanbanRendererFilterState = Record<string, string[]>;
 
-declare type KanbanRendererImplementation = (input: WorkbenchPanelRenderInput & {
-    kanbanRendererId: string;
-}) => unknown;
-
 declare interface KanbanRendererOrdering {
     attributeId: string | typeof MANUAL_ORDERING;
     direction: SortDirection;
@@ -792,22 +671,6 @@ declare interface KanbanRendererQueryState {
     filters: KanbanRendererFilterState;
 }
 
-declare interface KanbanRendererRefreshEvent {
-    kanbanRendererId: string;
-}
-
-declare type KanbanRendererRefreshListener = (event: KanbanRendererRefreshEvent) => void;
-
-declare interface KanbanRendererRegistry {
-    dataStore: WorkbenchStore<KanbanRendererStoreState>;
-    registerKanbanRenderer<TRow extends KanbanRendererRow = KanbanRendererRow>(contribution: KanbanRendererContribution<TRow>, metadata?: ContributionMetadata): Disposable_2;
-    setKanbanRendererImplementation(impl: KanbanRendererImplementation): void;
-    getKanbanRenderer(id: string): RegisteredKanbanRendererContribution | undefined;
-    listKanbanRenderers(): RegisteredKanbanRendererContribution[];
-    refreshKanbanRenderer(id: string): void;
-    onDidRefreshKanbanRenderer(listener: KanbanRendererRefreshListener): Disposable_2;
-}
-
 declare interface KanbanRendererRow {
     id: string;
     title: string;
@@ -836,15 +699,11 @@ declare interface KanbanRendererSettings {
     displayProperties: string[];
 }
 
-declare interface KanbanRendererStoreState {
-    renderers: Record<string, RegisteredKanbanRendererContribution>;
-}
-
 declare interface Keybinding {
-    commandId: string;
+    /** Action the chord executes through the shared navigation executor. */
+    action: NavigationTarget;
     keybinding: KeybindingSequence;
     when?: string;
-    args?: unknown;
 }
 
 declare interface KeybindingRegistry {
@@ -852,6 +711,11 @@ declare interface KeybindingRegistry {
     registerKeybinding(keybinding: Keybinding, metadata?: ContributionMetadata): Disposable_2;
     listKeybindings(): RegisteredKeybinding[];
     listActiveKeybindings(): RegisteredKeybinding[];
+    /** Chords bound to plain command actions, for rendering shortcut hints beside commands. */
+    listCommandKeybindings(): {
+        commandId: string;
+        keybinding: KeybindingSequence;
+    }[];
 }
 
 declare interface KeybindingRegistryStoreState {
@@ -871,12 +735,6 @@ declare interface LayoutModel {
     registerWidget(widget: WidgetContribution, metadata?: ContributionMetadata): {
         dispose(): void;
     };
-    registerLocation(location: WorkbenchLocationContribution, metadata?: ContributionMetadata): {
-        dispose(): void;
-    };
-    registerSubPanel(subPanel: WorkbenchSubPanelContribution, metadata?: ContributionMetadata): {
-        dispose(): void;
-    };
     registerPanelMenu(panelMenu: WorkbenchPanelMenuContribution, metadata?: ContributionMetadata): {
         dispose(): void;
     };
@@ -888,6 +746,7 @@ declare interface LayoutModel {
     getWidget(id: string): RegisteredWidgetContribution | undefined;
     getPanel(id: string): WorkbenchPanelContribution | undefined;
     getRegionSize(regionId: WorkbenchRegion_2): WorkbenchRegionSize | undefined;
+    getRegionSettings(regionId: WorkbenchRegion_2): WorkbenchRegionSettings | undefined;
     getRegionCollapsible(regionId: WorkbenchRegion_2): boolean;
     getRegionHeaderBorderBottom(regionId: WorkbenchRegion_2): boolean;
     setRegionVisible(regionId: WorkbenchRegion_2, visible: boolean): void;
@@ -905,7 +764,7 @@ declare interface LayoutModel {
     closePanel(instanceId: string): WorkbenchPanelInstance | undefined;
     updateWidgetPlacement(widgetId: string, input: OpenWidgetInput): WorkbenchWidgetPlacement;
     reorderWidget(widgetId: string, position: WorkbenchTabPosition): void;
-    expirePreviewTabs(ownerResourceUri?: string): void;
+    expirePreviewTabs(ownerResourceKey?: string): void;
     activateWidget(widgetId: string): WorkbenchWidgetPlacement;
     setRegionActiveWidget(regionId: WorkbenchRegion_2, widgetId: string | undefined): void;
     closeWidget(widgetId: string): WorkbenchWidgetPlacement | undefined;
@@ -971,6 +830,10 @@ declare interface MenuRegistryStoreState {
     itemsByPath: Record<string, RegisteredMenuItem[]>;
 }
 
+declare type NativeViewBody<Kind extends string, Contribution> = {
+    kind: Kind;
+} & Omit<Contribution, "id" | "title" | "icon">;
+
 declare interface NavigationParser {
     id: string;
     priority?: number;
@@ -984,16 +847,15 @@ declare interface NavigationRegistry {
     listParsers(): RegisteredNavigationParser[];
     resolveLocation(location: string): NavigationTarget;
     openTarget(target: NavigationTarget): Promise<readonly unknown[]>;
+    /** Opens a page location through the shared executor. */
+    openPage(target: Omit<NavigationTargetPage, "kind">): Promise<readonly unknown[]>;
+    /** Opens or activates an owned panel through the shared executor. */
+    openPanel(target: DistributiveOmit<NavigationTargetPanel, "kind">): Promise<readonly unknown[]>;
     navigate(location: string): Promise<readonly unknown[]>;
-    registerNavigator(navigator: ResourceNavigator, metadata?: ContributionMetadata): Disposable_2;
-    listNavigators(): RegisteredResourceNavigator[];
-    createHref(resource: ResourceRef): string;
-    navigateResource(resource: ResourceRef): Promise<unknown>;
 }
 
 declare interface NavigationRegistryStoreState {
     parsers: Record<string, RegisteredNavigationParser>;
-    navigators: Record<string, RegisteredResourceNavigator>;
 }
 
 declare type NavigationTarget = NavigationTargetItem | NavigationTargetCompound;
@@ -1006,23 +868,63 @@ declare interface NavigationTargetCommand {
 
 declare interface NavigationTargetCompound {
     kind: "compound";
-    targets: readonly NavigationTargetItem[];
+    targets: readonly (NavigationTargetPage | NavigationTargetPanel)[];
 }
 
-declare type NavigationTargetItem = NavigationTargetResource | NavigationTargetPanel | NavigationTargetCommand;
+declare interface NavigationTargetHref {
+    kind: "href";
+    href: string;
+}
+
+declare type NavigationTargetItem = NavigationTargetPage | NavigationTargetPanel | NavigationTargetCommand | NavigationTargetHref;
+
+declare type NavigationTargetPage = NavigationTargetPage_2;
+
+declare type NavigationTargetPanel = NavigationTargetPanel_2 | NavigationTargetShellPanel;
 
-declare interface NavigationTargetPanel {
+declare interface NavigationTargetShellPanel {
     kind: "panel";
-    panelId: string;
-    input?: OpenWorkbenchPanelInput;
+    panel: ShellPlacementRef;
+    resource?: NavigationTargetPanel_2["resource"];
+    open?: NavigationTargetPanel_2["open"];
+    title?: string;
 }
 
-declare interface NavigationTargetResource {
-    kind: "resource";
-    resource: ResourceRef;
-    input?: OpenResourceInput;
+declare interface NavigationTreeContext {
+    resource?: ResourceRef;
+}
+
+declare interface NavigationTreeContribution {
+    id: string;
+    /** Prefix projected section and node ids when they come from an independent tree renderer. */
+    idScope?: string;
+    owner: NavigationTreeOwner;
+    sourceExtensionId: string;
+    declarationIndex: number;
+    slot?: NavigationTreeSlot;
+    viewId?: string;
+    defaultExpandedSectionIds?: string[];
+    getSections?(context: NavigationTreeContext): Promise<TreeViewSection[]> | TreeViewSection[];
+    getChildren?(node: TreeNode, context: NavigationTreeContext): Promise<TreeNode[]> | TreeNode[];
+}
+
+declare interface NavigationTreeOwner {
+    kind: "mode" | "page";
+    id: string;
+    extensionId: string;
 }
 
+declare interface NavigationTreeRegistry {
+    registerContribution(contribution: NavigationTreeContribution): Disposable_2;
+    resolveOwner(kind: NavigationTreeOwner["kind"], id: string): NavigationTreeOwner | undefined;
+    getSections(owner: NavigationTreeOwner, slot?: NavigationTreeSlot, context?: NavigationTreeContext): Promise<TreeViewSection[]>;
+    getChildren(node: TreeNode, context?: NavigationTreeContext): Promise<TreeNode[]>;
+    getDefaultExpandedSectionIds(owner: NavigationTreeOwner): string[];
+    onDidChange(listener: () => void): Disposable_2;
+}
+
+declare type NavigationTreeSlot = "header" | "content" | "footer";
+
 declare const NO_GROUPING = "none";
 
 export declare const normalizeWorkbenchKeybinding: (keybinding: KeybindingSequence) => KeybindingSequence;
@@ -1036,12 +938,15 @@ declare interface NotificationRegistry {
     subscribe(listener: WorkbenchNotificationListener): Disposable_2;
 }
 
-declare interface OpenResourceInput {
-    replaceActive?: boolean;
+declare interface OpenModePlacementTarget {
+    panel: PlacementRef;
+    resource?: ResourceRef;
+    open?: PageOpenIntent;
 }
 
 declare interface OpenWidgetInput {
-    resource?: ResourceRef;
+    viewId?: string | null;
+    resource?: ResourceRef | null;
     title?: string;
     region?: WorkbenchRegion_2;
     role?: WorkbenchWidgetRole;
@@ -1058,9 +963,17 @@ declare interface OpenWidgetInput {
     replaceWidgetId?: string;
 }
 
-declare interface OpenWorkbenchPanelInput {
+declare interface OpenWorkbenchOverlayInput {
     resource?: ResourceRef;
     title?: string;
+}
+
+declare interface OpenWorkbenchPanelInput {
+    /** Set by the view registry. Low-level layout callers should leave this undefined. */
+    viewId?: string | null;
+    /** `null` explicitly clears an existing singleton placement's resource binding. */
+    resource?: ResourceRef | null;
+    title?: string;
     region?: WorkbenchRegion_2;
     role?: WorkbenchWidgetRole;
     pinned?: boolean;
@@ -1071,13 +984,39 @@ declare interface OpenWorkbenchPanelInput {
     strategy?: WorkbenchPanelOpenStrategy;
 }
 
-export declare const openWorkbenchTerminal: (ctx: WorkbenchCoreContributionContext, input?: OpenWorkbenchTerminalOptions) => WorkbenchPanelInstance_2;
+declare interface OpenWorkbenchShellPlacementInput {
+    placementId: string;
+    resource?: ResourceRef;
+    open?: PageOpenIntent;
+    title?: string;
+}
 
-declare type OpenWorkbenchTerminalInput = NonNullable<Parameters<WorkbenchCoreContributionContext["layout"]["openWidget"]>[1]>;
+export declare const openWorkbenchTerminal: (ctx: WorkbenchCoreContributionContext, input?: OpenWorkbenchTerminalOptions) => WorkbenchPanelInstance;
 
-declare type OpenWorkbenchTerminalOptions = OpenWorkbenchTerminalInput & {
+declare interface OpenWorkbenchTerminalOptions {
+    resource?: ResourceRef;
     reveal?: boolean;
-};
+}
+
+declare interface OwnedPlacementLocationContext {
+    modeId: string;
+    pageId?: string;
+    projectId?: string;
+    location?: PageLocation;
+}
+
+declare interface OwnedPlacementReconciliation<Value> {
+    add: readonly ResolvedOwnedPlacement<Value>[];
+    retain: readonly ResolvedOwnedPlacement<Value>[];
+    update: readonly OwnedPlacementUpdate<Value>[];
+    activate: readonly ResolvedOwnedPlacement<Value>[];
+    remove: readonly ResolvedOwnedPlacement<Value>[];
+}
+
+declare interface OwnedPlacementUpdate<Value> {
+    current: ResolvedOwnedPlacement<Value>;
+    desired: ResolvedOwnedPlacement<Value>;
+}
 
 declare type ParamValue_2 = Parameters<NonNullable<ParamEditorProps["onChange"]>>[1];
 
@@ -1137,6 +1076,20 @@ declare interface PreferenceScopeRef {
 
 declare type PreferenceValue = boolean | number | string | string[] | number[] | boolean[] | Record<string, unknown>;
 
+export declare type ReactAttributeDescriptor = AttributeDescriptor<ReactNode>;
+
+export declare type ReactAttributesSource = AttributesSource<ReactNode>;
+
+export declare type ReactBoardColumnConfig = BoardColumnConfig<ReactColumnIcon>;
+
+declare type ReactColumnIcon = ComponentType<{
+    size?: number | string;
+}>;
+
+export declare type ReactKanbanRendererContribution<TRow extends KanbanRendererRow = KanbanRendererRow> = KanbanRendererContribution<TRow, ReactNode, ReactColumnIcon>;
+
+export declare type ReactResourceContextAction = ResourceContextAction<ReactNode>;
+
 /** Narrows an editor value back to what a command param can carry. */
 export declare const readCommandParamValue: (value: ParamValue, entry?: CommandParamEntry) => CommandParamValue;
 
@@ -1151,24 +1104,9 @@ declare interface RegisteredContributionMetadata {
     priority: number;
 }
 
-declare interface RegisteredControlsRendererContribution extends ControlsRendererContribution, RegisteredContributionMetadata {
-}
-
 declare interface RegisteredDataTableRendererContribution extends DataTableRendererContribution, RegisteredContributionMetadata {
 }
 
-declare interface RegisteredFileRendererContribution extends FileRendererContribution, RegisteredContributionMetadata {
-}
-
-declare interface RegisteredKanbanRendererContribution<TRow extends KanbanRendererRow = KanbanRendererRow> extends KanbanRendererContribution<TRow>, RegisteredContributionMetadata {
-}
-
-declare interface RegisteredKeepAliveHost {
-    rendererId: string;
-    host: HTMLElement;
-    attachedTo?: HTMLElement;
-}
-
 declare interface RegisteredKeybinding extends Keybinding, RegisteredContributionMetadata {
 }
 
@@ -1188,8 +1126,6 @@ declare type RegisteredPreferenceSchema = PreferencePropertySchema & {
 declare interface RegisteredResourceKind extends ResourceKindContribution, RegisteredContributionMetadata {
 }
 
-declare type RegisteredResourceNavigator = Omit<ResourceNavigator, "priority"> & RegisteredContributionMetadata;
-
 declare type RegisteredSettingsPanel = SettingsPanelContribution & RegisteredContributionMetadata;
 
 declare type RegisteredSettingsSection = SettingsSectionContribution & RegisteredContributionMetadata;
@@ -1214,11 +1150,18 @@ declare interface RegisteredWorkbenchNotification extends RegisteredContribution
     metadata?: Record<string, unknown>;
 }
 
-declare type ResolvedResourceHierarchyProvider = Required<ResourceHierarchyProvider>;
+declare type RegisteredWorkbenchStatusSet = WorkbenchStatusSetContribution & RegisteredContributionMetadata;
 
-declare type ResolvedResourcePresenter = Omit<ResourcePresenter, "priority"> & {
-    priority: number;
-};
+declare type RegisteredWorkbenchView = WorkbenchViewContribution & RegisteredContributionMetadata;
+
+declare interface ResolvedOwnedPlacement<Value = unknown> {
+    identity: PlacementIdentity;
+    region: WorkbenchRegion_2;
+    order: number;
+    value: Value;
+}
+
+declare type ResolvedResourceHierarchyProvider = Required<ResourceHierarchyProvider>;
 
 declare interface ResourceBrowseEntry {
     resource: ResourceRef;
@@ -1230,19 +1173,19 @@ declare interface ResourceBrowseEntry {
 }
 
 /** Row-level context menu action surfaced by the renderer. */
-declare interface ResourceContextAction {
+declare interface ResourceContextAction<TNode = unknown> {
     key: string;
     label: string;
     onClick: () => Promise<void> | void;
     isDisabled?: boolean;
-    icon?: ReactNode;
-    endContent?: ReactNode;
+    icon?: TNode;
+    endContent?: TNode;
     separatorBefore?: boolean;
 }
 
 declare interface ResourceHierarchyCycle {
     code: typeof resourceHierarchyCycleCode;
-    path: ResourceRef[];
+    path: WorkbenchHierarchyNode[];
     repeatedUri: string;
 }
 
@@ -1252,90 +1195,45 @@ declare interface ResourceHierarchyProvider {
     id: string;
     priority?: number;
     canResolve(resource: ResourceRef): boolean;
-    getParent(resource: ResourceRef): ResourceRef | undefined;
+    getParent(resource: ResourceRef): WorkbenchHierarchyNode | undefined;
 }
 
 declare interface ResourceKindContribution {
     kind: string;
     label: string;
     icon?: string;
-    surface?: ResourceSurface;
-    paletteOpenInput?: OpenResourceInput;
 }
 
 declare interface ResourceListContext {
     primary?: ResourceRef;
 }
 
-declare interface ResourceNavigator<TResult = unknown> {
-    id: string;
-    priority?: number;
-    canNavigate(resource: ResourceRef): boolean;
-    createHref?(resource: ResourceRef): string;
-    navigate(resource: ResourceRef): TResult | Promise<TResult>;
-}
-
-declare interface ResourcePresenter {
-    id: string;
-    priority?: number;
-    canOpen(resource: ResourceRef): boolean;
-    open(resource: ResourceRef, input: OpenResourceInput): WorkbenchPanelInstance | Promise<WorkbenchPanelInstance>;
-    afterOpen?(resource: ResourceRef, instance: WorkbenchPanelInstance, input: OpenResourceInput): void;
-}
-
 declare interface ResourceProvider {
     id: string;
     kind: string;
     list(query: string, context: ResourceListContext): readonly ResourceBrowseEntry[];
 }
 
-declare interface ResourceRef {
-    kind: string;
-    uri: string;
-    id?: string;
-    label?: string;
-    icon?: string;
-    metadata?: Record<string, unknown>;
-}
-
-declare interface ResourceRef_2 {
-    kind: string;
-    uri: string;
-    id?: string;
-    label?: string;
-    icon?: string;
-    metadata?: Record<string, unknown>;
-}
-
 declare interface ResourceRegistry {
     store: WorkbenchStore<ResourceRegistryStoreState>;
     registerKind(kind: ResourceKindContribution, metadata?: ContributionMetadata): Disposable_2;
     getKind(kind: string): RegisteredResourceKind | undefined;
-    getSurface(resource: ResourceRef): ResourceSurface | undefined;
     listKinds(): RegisteredResourceKind[];
-    registerPresenter(presenter: ResourcePresenter): Disposable_2;
-    listPresenters(): ResolvedResourcePresenter[];
     registerProvider(provider: ResourceProvider): Disposable_2;
     listProviders(): ResourceProvider[];
     listResources(query: string): readonly ResourceBrowseEntry[];
     registerHierarchyProvider(provider: ResourceHierarchyProvider): Disposable_2;
     listHierarchyProviders(): ResolvedResourceHierarchyProvider[];
-    walkHierarchy(resource: ResourceRef | undefined): ResourceRef[];
+    walkHierarchy(resource: ResourceRef | undefined): WorkbenchHierarchyNode[];
     onDidDetectHierarchyCycle(listener: (cycle: ResourceHierarchyCycle) => void): Disposable_2;
-    isOpeningResource(): boolean;
-    openResource(resource: ResourceRef, input?: OpenResourceInput): Promise<WorkbenchPanelInstance>;
-    onDidOpenResource(listener: (resource: ResourceRef) => void): Disposable_2;
 }
 
 declare interface ResourceRegistryStoreState {
     kinds: Record<string, RegisteredResourceKind>;
-    presenters: Record<string, ResolvedResourcePresenter>;
     providers: Record<string, ResourceProvider>;
     hierarchyProviders: Record<string, ResolvedResourceHierarchyProvider>;
 }
 
-declare type ResourceSurface = "primary" | "secondary" | "attached";
-
 /** Auto-rendered as a param editor from the registered preference schema. */
 declare interface SchemaSettingsPanel extends SettingsPanelBase {
     kind: "schema";
@@ -1344,8 +1242,6 @@ declare interface SchemaSettingsPanel extends SettingsPanelBase {
     save?: "live" | "apply";
 }
 
-export declare const SETTINGS_RESOURCE_KIND = "workbench-settings";
-
 /** A "+ create"-style action surfaced on a section or a collection's parent node. */
 declare interface SettingsAction {
     id: string;
@@ -1361,12 +1257,6 @@ declare interface SettingsCollectionGroupBy<TItem> {
     icon?(key: string): string | undefined;
 }
 
-export declare const settingsItemResource: (panelId: string, item: {
-    id: string;
-    label: string;
-    icon?: string;
-}) => ResourceRef;
-
 declare interface SettingsPanelBase {
     id: string;
     title: string;
@@ -1380,7 +1270,7 @@ declare interface SettingsPanelBase {
     when?: string;
 }
 
-declare type SettingsPanelContribution = SchemaSettingsPanel | CustomSettingsPanel | CollectionSettingsPanel;
+declare type SettingsPanelContribution = SchemaSettingsPanel | ViewSettingsPanel | CollectionSettingsPanel;
 
 /** A preference this panel edits; a bare string uses the preference name as its label. */
 declare type SettingsPanelPreference = string | {
@@ -1388,20 +1278,16 @@ declare type SettingsPanelPreference = string | {
     label?: string;
 };
 
-export declare const settingsPanelResource: (panel: {
-    id: string;
-    title: string;
-    icon?: string;
-}) => ResourceRef;
-
 declare interface SettingsRegistry {
     store: WorkbenchStore<SettingsRegistryStoreState>;
     registerSection(section: SettingsSectionContribution, metadata?: ContributionMetadata): Disposable_2;
-    registerPanel<TItem = unknown>(panel: SchemaSettingsPanel | CustomSettingsPanel | CollectionSettingsPanel<TItem>, metadata?: ContributionMetadata): Disposable_2;
+    registerPanel<TItem = unknown>(panel: SchemaSettingsPanel | ViewSettingsPanel | CollectionSettingsPanel<TItem>, metadata?: ContributionMetadata): Disposable_2;
     getSection(id: string): RegisteredSettingsSection | undefined;
     getPanel(id: string): RegisteredSettingsPanel | undefined;
     listSections(): RegisteredSettingsSection[];
     listPanels(): RegisteredSettingsPanel[];
+    resolveCollectionItem(panelId: string, itemId: string): Promise<unknown | undefined>;
+    getCollectionItem(panelId: string, itemId: string): unknown | undefined;
     /** Signal that a collection's backing data changed so the surface refreshes. */
     refresh(): void;
 }
@@ -1425,6 +1311,12 @@ declare interface SettingsSectionContribution {
     actions?: SettingsAction[];
 }
 
+/** Core-only panel ref for host-owned shell placements. Extensions cannot address them. */
+declare interface ShellPlacementRef {
+    kind: "shell-placement";
+    id: string;
+}
+
 declare type SortDirection = "asc" | "desc";
 
 export declare const syncWorkbenchModuleHostRegistrations: (workbench: WorkbenchCore, registrations: Map<string, WorkbenchModuleHostRegistration>, modules: readonly WorkbenchModuleContribution[]) => void;
@@ -1436,17 +1328,8 @@ export declare const syncWorkbenchModuleHostRegistrations: (workbench: Workbench
  */
 declare type ThemePreference = string;
 
-/**
- * Core-owned contract for theme registrations. Structurally identical to
- * @pstdio/ui's ThemePreferenceOption; the React layer bridges the two so core
- * does not depend on UI package ownership.
- */
-declare type ThemePreference_2 = string;
-
 declare type ThemePreferenceMode = "light" | "dark";
 
-declare type ThemePreferenceMode_2 = "light" | "dark";
-
 declare interface ThemePreferenceOption {
     id: ThemePreference;
     title?: string;
@@ -1455,18 +1338,8 @@ declare interface ThemePreferenceOption {
     monacoTheme?: unknown;
 }
 
-declare interface ThemePreferenceOption_2 {
-    id: ThemePreference_2;
-    title?: string;
-    mode: ThemePreferenceMode_2;
-    tokens?: ThemePreferenceTokens_2;
-    monacoTheme?: unknown;
-}
-
 declare type ThemePreferenceTokens = Record<string, string>;
 
-declare type ThemePreferenceTokens_2 = Record<string, string>;
-
 declare interface ThemeRegistry {
     store: WorkbenchStore<WorkbenchThemeStoreState>;
     register(themes: readonly ThemePreferenceOption[]): Disposable_2;
@@ -1491,15 +1364,29 @@ export declare interface TreeActionParamsRequest {
     run: (args: unknown) => Promise<void>;
 }
 
-declare interface TreeContext {
-    filter?: string;
-    resource?: ResourceRef;
-    /** Widget/view contribution id for trees rendered through a view-backed widget. */
-    viewId?: string;
+declare interface TreeContext extends TreeQueryContext {
+    state: Readonly<TreeRendererState>;
+    refresh(): void;
+    setSelectedNode(nodeId: string | undefined): void;
 }
 
+declare interface TreeMoveEndpoint {
+    kind: "section" | "node";
+    sectionId: string;
+    id: string;
+    moveScope?: string;
+}
+
+declare type TreeMovePolicy = (move: {
+    source: TreeMoveEndpoint;
+    destination: TreeMoveEndpoint;
+}) => boolean;
+
 declare interface TreeNode {
     id: string;
+    selected?: boolean;
+    /** Host-owned customization boundary. Extension callbacks cannot set it. */
+    moveScope?: string;
     label: string;
     icon?: string;
     iconElement?: unknown;
@@ -1544,6 +1431,13 @@ declare interface TreeNodeInlineInput {
 
 declare type TreeNodeRowVariant = "empty-state";
 
+declare interface TreeQueryContext {
+    filter?: string;
+    resource?: ResourceRef;
+    /** Widget/view contribution id for trees rendered through a view-backed widget. */
+    viewId?: string;
+}
+
 declare interface TreeRendererContribution {
     id: string;
     title: string;
@@ -1554,9 +1448,10 @@ declare interface TreeRendererContribution {
     defaultExpandedSectionIds?: string[];
     defaultExpandedNodeIds?: string[];
     getBody(ctx: TreeContext): Promise<TreeViewSection[]> | TreeViewSection[];
-    getHeader?(ctx: TreeContext): Promise<TreeNode[]> | TreeNode[];
-    getFooter?(ctx: TreeContext): Promise<TreeNode[]> | TreeNode[];
+    getHeader?(ctx: TreeContext): Promise<TreeViewSection[]> | TreeViewSection[];
+    getFooter?(ctx: TreeContext): Promise<TreeViewSection[]> | TreeViewSection[];
     getChildren(node: TreeNode, ctx: TreeContext): Promise<TreeNode[]> | TreeNode[];
+    canMove?: TreeMovePolicy;
     moveNode?(source: TreeNode, target: TreeNode | undefined, ctx: TreeContext): Promise<void> | void;
 }
 
@@ -1576,10 +1471,10 @@ declare interface TreeRendererRegistry {
     setTreeRendererImplementation(impl: TreeRendererImplementation): void;
     getTreeRenderer(id: string): RegisteredTreeRendererContribution | undefined;
     listTreeRenderers(): RegisteredTreeRendererContribution[];
-    getBody(id: string, ctx?: TreeContext): Promise<TreeViewSection[]>;
-    getHeader(id: string, ctx?: TreeContext): Promise<TreeNode[]>;
-    getFooter(id: string, ctx?: TreeContext): Promise<TreeNode[]>;
-    getChildren(id: string, node: TreeNode, ctx?: TreeContext): Promise<TreeNode[]>;
+    getBody(id: string, ctx?: TreeQueryContext): Promise<TreeViewSection[]>;
+    getHeader(id: string, ctx?: TreeQueryContext): Promise<TreeViewSection[]>;
+    getFooter(id: string, ctx?: TreeQueryContext): Promise<TreeViewSection[]>;
+    getChildren(id: string, node: TreeNode, ctx?: TreeQueryContext): Promise<TreeNode[]>;
     getTreeState(id: string): TreeRendererState;
     setNodeExpanded(id: string, nodeId: string, expanded: boolean): void;
     setSectionExpanded(id: string, sectionId: string, expanded: boolean): void;
@@ -1610,6 +1505,8 @@ declare interface TreeSectionEmptyState {
 
 declare interface TreeViewSection {
     id: string;
+    /** Host-owned customization boundary. Extension callbacks cannot set it. */
+    moveScope?: string;
     label?: string;
     actions?: TreeAction[];
     collapsible?: boolean;
@@ -1622,13 +1519,11 @@ declare interface TreeViewSection {
     canReorder?: boolean;
 }
 
-export declare const useWorkbenchClaim: () => WorkbenchPanelRenderInput | undefined;
-
 export declare const useWorkbenchResourceActionResolver: (workbench: WorkbenchCoreContributionContext) => (resource: ResourceRef) => ResourceContextAction_2[];
 
 export declare const useWorkbenchStore: <TState, TSlice>(store: WorkbenchStore<TState>, selector: (state: TState) => TSlice) => TSlice;
 
-export declare const useWorkbenchThemePreferences: (workbench: WorkbenchCore) => (ThemePreferenceOption_2 | {
+export declare const useWorkbenchThemePreferences: (workbench: WorkbenchCore) => (ThemePreferenceOption | {
     id: string;
     mode: "light";
 } | {
@@ -1644,6 +1539,11 @@ export declare const useWorkbenchThemePreferences: (workbench: WorkbenchCore) =>
  */
 declare type ViewMode = "board" | "list";
 
+declare interface ViewSettingsPanel extends SettingsPanelBase {
+    kind: "view";
+    viewId: string;
+}
+
 declare interface WidgetContribution {
     id: string;
     title: string;
@@ -1655,15 +1555,13 @@ declare interface WidgetContribution {
     mountStrategy?: WidgetMountStrategy;
     closable?: boolean;
     hiddenByDefault?: boolean;
-    subPanelsOnly?: boolean;
     regionSize?: WorkbenchRegionSize;
     regionCollapsible?: boolean;
     headerBorderBottom?: boolean;
-    floatingPanels?: WorkbenchFloatingPanelVisibility;
     resourceKinds?: string[];
     priority?: number;
     rendererId: string;
-    openCommandId?: string;
+    openCommand?: WorkbenchCommandTarget;
     eligibleLocations?: WorkbenchLocationEligibility;
     panelMenuOwner?: WorkbenchPanelMenuOwner;
     tab?: WorkbenchWidgetTab;
@@ -1673,8 +1571,6 @@ declare interface WidgetContribution {
 
 declare type WidgetMountStrategy = "active" | "keep-mounted";
 
-declare type WidgetMountStrategy_2 = "active" | "keep-mounted";
-
 declare type WidgetReusePolicy = "resource" | "none";
 
 export declare const Workbench: (props: WorkbenchProps) => JSX.Element;
@@ -1687,10 +1583,14 @@ export declare const WORKBENCH_SETTINGS_PANEL_WIDGET_ID = "workbench.settings.pa
 
 export declare const WORKBENCH_SETTINGS_WIDGET_ID = "workbench.settings";
 
-export declare const WORKBENCH_TERMINAL_LAUNCHER_WIDGET_ID = "workbench.terminal.launcher";
-
 export declare const WORKBENCH_TERMINAL_OPEN_COMMAND_ID = "workbench.terminal.open";
 
+/** Suggested secondary-region size for hosts that mount the terminal (createWorkbench regionSettings). */
+export declare const WORKBENCH_TERMINAL_PANEL_SIZE: {
+    defaultPx: number;
+    minPx: number;
+};
+
 export declare const WORKBENCH_TERMINAL_WIDGET_ID = "workbench.terminal";
 
 export declare const WorkbenchAttachedSidePanel: (props: WorkbenchSidePanelProps) => JSX.Element;
@@ -1724,15 +1624,6 @@ declare interface WorkbenchBreadcrumbViewProps {
     workbench: WorkbenchCore;
 }
 
-export declare const WorkbenchClaimContext: Context<WorkbenchPanelRenderInput | undefined>;
-
-declare interface WorkbenchClosedSubPanel {
-    region: WorkbenchPanelRegion;
-    reference: WorkbenchSubPanelRef;
-    resource?: ResourceRef;
-    title?: string;
-}
-
 declare interface WorkbenchCommandExecutionContext {
     resource?: ResourceRef;
     source?: "panel-add";
@@ -1785,7 +1676,7 @@ declare interface WorkbenchCommandPaletteState {
     paramsRequest: WorkbenchCommandParamsRequest | null;
 }
 
-declare type WorkbenchCommandPaletteView = "main" | "theme" | "mode";
+declare type WorkbenchCommandPaletteView = "main" | "theme";
 
 declare interface WorkbenchCommandParamsRequest {
     record: {
@@ -1800,8 +1691,14 @@ declare interface WorkbenchCommandParamsRequest {
     context?: WorkbenchCommandExecutionContext;
 }
 
+declare interface WorkbenchCommandTarget {
+    commandId: string;
+    args?: unknown;
+}
+
 declare interface WorkbenchCompositionAddablePanel extends WorkbenchModeAddablePanel {
     contribution: RegisteredWidgetContribution;
+    open?(resource?: ResourceRef): void;
 }
 
 declare interface WorkbenchCompositionController {
@@ -1816,11 +1713,14 @@ declare interface WorkbenchCompositionRegionPanels {
 
 declare interface WorkbenchCore extends WorkbenchCoreContributionContext {
     host: WorkbenchHost;
+    layout: WorkbenchLayoutModel;
     registerModule(module: WorkbenchModuleContribution): Disposable_2;
     unregisterModule(moduleId: string): void;
 }
 
 declare interface WorkbenchCoreContributionContext {
+    pinPlacement(identity: PlacementIdentity): void;
+    closePlacement(identity: PlacementIdentity): void;
     breadcrumbs: WorkbenchBreadcrumbController;
     commandPalette: WorkbenchCommandPaletteController;
     commandPaletteResources: CommandPaletteResourceRegistry;
@@ -1828,19 +1728,27 @@ declare interface WorkbenchCoreContributionContext {
     composition: WorkbenchCompositionController;
     context: ContextKeyService;
     focus: WorkbenchFocusController;
-    history: HistoryController;
     keybindings: KeybindingRegistry;
-    lastResource: WorkbenchLastResourceController;
-    layout: WorkbenchLayoutModel;
+    layout: WorkbenchModuleLayoutModel;
     modes: WorkbenchModeRegistry;
+    modePlacements: WorkbenchModePlacementRegistry;
+    shellPlacements: WorkbenchShellPlacementRegistry;
     navigation: NavigationRegistry;
-    navigator: WorkbenchNavigator;
+    navigationTrees: NavigationTreeRegistry;
     notifications: NotificationRegistry;
-    panels: WorkbenchPanelsController;
+    overlays: WorkbenchOverlayRegistry;
+    placeholders: WorkbenchPlaceholderRegistry;
+    pageLocations: WorkbenchPageLocationController;
+    pages: WorkbenchPageRegistry<WorkbenchWidgetPlacement>;
+    panelMenuState: WorkbenchPanelMenuStateController;
     preferences: PreferenceRegistry;
-    renderers: WorkbenchRenderers;
+    treeViews: WorkbenchTreeViews;
     resources: ResourceRegistry;
+    views: WorkbenchViewRegistry;
+    viewMenus: WorkbenchViewMenuRegistry;
     settings: SettingsRegistry;
+    statusBar: WorkbenchStatusBarRegistry;
+    statuses: WorkbenchStatusRegistry;
     shell: WorkbenchShellController;
     sidePanel: WorkbenchSidePanelController;
     terminal: WorkbenchTerminalController;
@@ -1850,6 +1758,7 @@ declare interface WorkbenchCoreContributionContext {
     onDidChangePrimaryResource(listener: (resource: ResourceRef | undefined) => void): Disposable_2;
     getActiveResource(): ResourceRef | undefined;
     onDidChangeActiveResource(listener: (resource: ResourceRef | undefined) => void): Disposable_2;
+    registerChildModule(module: WorkbenchModuleContribution): Disposable_2;
 }
 
 export declare const WorkbenchDataTableView: (props: WorkbenchDataTableViewProps) => JSX.Element;
@@ -1864,8 +1773,6 @@ declare interface WorkbenchFileIconThemeStoreState {
     themes: readonly FileIconThemePreferenceOption[];
 }
 
-declare type WorkbenchFloatingPanelVisibility = "visible" | "hidden";
-
 export declare const WorkbenchFloatingSidePanel: (props: WorkbenchSidePanelProps) => JSX.Element | null;
 
 declare type WorkbenchFocusChangeListener = (region: WorkbenchFocusRegionId | undefined) => void;
@@ -1902,6 +1809,8 @@ declare interface WorkbenchHeaderActionsProps {
     controlSize?: "2xs" | "xs";
 }
 
+declare type WorkbenchHierarchyNode = ResourceRef | WorkbenchViewHierarchyNode;
+
 declare interface WorkbenchHost {
     getSnapshot(): WorkbenchSnapshot;
     restoreSnapshot(snapshot: WorkbenchSnapshot): void;
@@ -1912,7 +1821,7 @@ declare interface WorkbenchHost {
 }
 
 export declare interface WorkbenchHotkeyRegistration {
-    commandId: string;
+    id: string;
     hotkey: KeybindingSequence;
     enabled: boolean;
     ignoreInputs: boolean;
@@ -1926,12 +1835,6 @@ declare interface WorkbenchIconProps extends Omit<IconProps, "as" | "size"> {
     size?: number | string;
 }
 
-export declare const WorkbenchKeepAliveLayer: (props: WorkbenchKeepAliveLayerProps) => JSX.Element;
-
-declare interface WorkbenchKeepAliveLayerProps {
-    workbench: WorkbenchCore;
-}
-
 export declare const WorkbenchKeybindingDispatcher: (props: WorkbenchKeybindingDispatcherProps) => null;
 
 declare interface WorkbenchKeybindingDispatcherProps {
@@ -1940,18 +1843,12 @@ declare interface WorkbenchKeybindingDispatcherProps {
     commandIds?: readonly string[];
 }
 
-declare interface WorkbenchLastResourceController {
-    get(): ResourceRef | undefined;
-    set(resource: ResourceRef | undefined): void;
-    restore(): Promise<boolean>;
-}
-
 declare interface WorkbenchLayout {
     regions: Record<WorkbenchRegion_2, WorkbenchRegionState>;
     locationSubPanelSelections?: Record<string, Partial<Record<WorkbenchPanelRegion, string>>>;
     activeWidgetId?: string;
     activeLocationWidgetId?: string;
-    activeResourceUri?: string;
+    activeResourceKey?: string;
 }
 
 declare type WorkbenchLayoutModel = LayoutModel & MenuRegistry;
@@ -1962,22 +1859,15 @@ declare interface WorkbenchLayoutStoreState {
     placeholders: Partial<Record<WorkbenchRegion_2, RegisteredPlaceholderContribution>>;
 }
 
-declare type WorkbenchLocationContribution = WidgetContribution & WorkbenchPanelMenusContribution;
-
 declare interface WorkbenchLocationEligibility {
     modeIds?: string[];
     resourceKinds?: string[];
     resourceIds?: string[];
     canOpen?(resource: ResourceRef): boolean;
-}
-
-declare interface WorkbenchLocationRef {
-    key: string;
-    modeId?: string;
-    resource?: ResourceRef;
-    contributionId?: string;
-    instanceKey?: string;
-    title?: string;
+    canOpenLocation?(location: {
+        resource?: ResourceRef;
+        viewId?: string;
+    }): boolean;
 }
 
 export declare interface WorkbenchMenuItem {
@@ -2020,7 +1910,12 @@ declare type WorkbenchModeChangeListener = () => void;
 declare interface WorkbenchModeContribution {
     id: string;
     label?: string;
+    defaultTheme?: string;
+    floatingPanels?: "visible" | "hidden";
+    chrome?: Partial<Record<"nav" | "sidenav" | "activity" | "status", string | false>>;
     panels?: readonly WorkbenchPanelRegion[];
+    /** Region-level layout policy while this mode is active. */
+    regionSettings?: Partial<Record<WorkbenchRegion_2, WorkbenchRegionSettings>>;
     resourceKinds?: readonly string[];
     defaultResource?: ResourceRef | (() => Promise<ResourceRef | undefined> | ResourceRef | undefined);
     listAddablePanels?(context: WorkbenchModeAddablePanelContext): readonly WorkbenchModeAddablePanel[];
@@ -2030,6 +1925,31 @@ declare interface WorkbenchModeContribution {
     reconcile?(ctx: WorkbenchModeActivationContext): void;
 }
 
+declare interface WorkbenchModePlacementContribution extends WorkbenchPlacementPresentation {
+    readonly id: string;
+    readonly ref: PlacementRef;
+    readonly modeId: string;
+    readonly item: WorkbenchOwnedPlacementItem;
+    readonly region: DockedWorkbenchRegion;
+    readonly order?: number;
+    readonly movableTo?: readonly DockedWorkbenchRegion[];
+}
+
+declare interface WorkbenchModePlacementRegistry {
+    registerPlacement(placement: WorkbenchModePlacementContribution): Disposable_2;
+    getPlacement(ref: PlacementRef): WorkbenchModePlacementContribution | undefined;
+    listPlacements(modeId?: string): WorkbenchModePlacementContribution[];
+    openPlacement(input: OpenModePlacementTarget): PlacementIdentity;
+    updatePlacement(identity: PlacementIdentity, input: {
+        resource?: ResourceRef;
+        title?: string;
+        open?: PageOpenIntent;
+    }): void;
+    closePlacement(identity: PlacementIdentity): void;
+    resolvePlacements(modeId: string, context?: OwnedPlacementLocationContext): readonly ResolvedOwnedPlacement<WorkbenchWidgetPlacement>[];
+    onDidChange(listener: () => void): Disposable_2;
+}
+
 declare interface WorkbenchModeRegistry {
     store: WorkbenchStore<WorkbenchModeStoreState>;
     dispose(): void;
@@ -2074,74 +1994,7 @@ export declare interface WorkbenchModuleHostRegistration {
     disposable: Disposable_2;
 }
 
-declare interface WorkbenchNavigationCommit {
-    modeId: string | undefined;
-    resource: ResourceRef | undefined;
-    replaceActive: boolean;
-}
-
-declare type WorkbenchNavigationDiagnosticCode = "navigation_mode_missing" | "navigation_resource_missing" | "navigation_resource_incompatible" | "navigation_default_missing" | "navigation_target_stale";
-
-declare interface WorkbenchNavigationEntry {
-    entryId: string;
-    recordedAt: number;
-    location: WorkbenchLocationRef;
-    selectedSubPanels: Partial<Record<WorkbenchPanelRegion, WorkbenchSubPanelRef>>;
-    kind: "resource" | "widget" | "mode";
-    modeId?: string;
-    resource?: ResourceRef;
-    widgetId?: string;
-    contributionId?: string;
-    title?: string;
-    closedSubPanel?: WorkbenchClosedSubPanel;
-}
-
-declare type WorkbenchNavigationResult = {
-    ok: true;
-    modeId: string | undefined;
-    resource: ResourceRef | undefined;
-} | {
-    ok: false;
-    code: WorkbenchNavigationDiagnosticCode;
-    message: string;
-};
-
-declare interface WorkbenchNavigationTarget {
-    modeId?: string;
-    resource?: ResourceRef;
-    replaceActive?: boolean;
-}
-
-declare interface WorkbenchNavigator {
-    configure(hooks: WorkbenchNavigatorHostHooks): void;
-    getSelectedResource(): ResourceRef | undefined;
-    open(target: WorkbenchNavigationTarget): Promise<WorkbenchNavigationResult>;
-    commitContext(input: WorkbenchNavigatorCommitInput): WorkbenchNavigationResult;
-    getLastResource(projectId: string | undefined, modeId: string): ResourceRef | undefined;
-    forgetResource(uri: string): void;
-    onDidCommit(listener: (commit: WorkbenchNavigationCommit) => void): {
-        dispose(): void;
-    };
-}
-
-declare interface WorkbenchNavigatorCommitInput {
-    modeId?: string | null;
-    resource?: ResourceRef | null;
-    replaceActive?: boolean;
-    present?: boolean;
-}
-
-declare interface WorkbenchNavigatorHostHooks {
-    getProjectId?(): string | undefined;
-    getSelectedResource?(): ResourceRef | undefined;
-    interpretSelection?(resource: ResourceRef): ResourceRef | undefined;
-    applySelection?(resource: ResourceRef | undefined): void;
-    applyScope?(commit: WorkbenchNavigationCommit): void;
-    applyBreadcrumb?(resource: ResourceRef | undefined): void;
-    presentResource?(resource: ResourceRef, input: {
-        replaceActive: boolean;
-    }): Promise<unknown> | unknown;
-}
+declare type WorkbenchModuleLayoutModel = Omit<WorkbenchLayoutModel, "registerPanel" | "registerWidget" | "openPanel" | "openWidget" | "registerPlaceholder" | "registerPanelMenu">;
 
 declare interface WorkbenchNotification {
     id?: string;
@@ -2183,12 +2036,26 @@ declare interface WorkbenchNotificationStoreState {
     notifications: Record<string, RegisteredWorkbenchNotification>;
 }
 
+declare interface WorkbenchOverlayContribution extends Omit<WorkbenchPlacementPresentation, "mountStrategy"> {
+    id: string;
+    viewId: string;
+    closable?: boolean;
+}
+
 export declare const WorkbenchOverlayLayer: (props: WorkbenchOverlayLayerProps) => JSX.Element | null;
 
 declare interface WorkbenchOverlayLayerProps {
     workbench: WorkbenchCore;
 }
 
+declare interface WorkbenchOverlayRegistry {
+    registerOverlay(overlay: WorkbenchOverlayContribution): Disposable_2;
+    getOverlay(id: string): WorkbenchOverlayContribution | undefined;
+    listOverlays(): WorkbenchOverlayContribution[];
+    openOverlay(id: string, input?: OpenWorkbenchOverlayInput): string;
+    closeOverlay(instanceId: string): void;
+}
+
 export declare interface WorkbenchOverlayWidgetConfig {
     size?: "xs" | "sm" | "md" | "lg" | "xl" | "cover" | "full";
     placement?: "center" | "top" | "bottom";
@@ -2209,6 +2076,107 @@ export declare interface WorkbenchOverlayWidgetConfig {
     closeTriggerTop?: string;
 }
 
+declare type WorkbenchOwnedPlacementItem = PlacementItem;
+
+declare interface WorkbenchPageContribution {
+    id: string;
+    ref: PageRef;
+    title?: Localizable<string>;
+    icon?: string;
+    path: string;
+    modeId: string;
+    parentId?: string;
+    resource?: ResourceConstraint;
+    main: WorkbenchPageMain;
+    slots: readonly WorkbenchPageSlot[];
+}
+
+declare interface WorkbenchPageLocationController {
+    historyStore: WorkbenchStore<WorkbenchPageLocationHistoryState>;
+    setProject(projectId: string): void;
+    clearProject(): void;
+    isCurrentProjectUrl(projectId: string): boolean;
+    hasCurrentPageUrl(projectId: string): boolean;
+    boot(projectId: string): WorkbenchPageNavigationResult;
+    switchProject(projectId: string): WorkbenchPageNavigationResult;
+    navigate(target: NavigationTargetPage_2): WorkbenchPageNavigationResult;
+    replay(location: PageLocation): WorkbenchPageNavigationResult;
+    navigateToParent(): WorkbenchPageNavigationResult;
+    closePlacement(identity: PlacementIdentity): WorkbenchPageNavigationResult;
+    goBack(): void;
+    goForward(): void;
+    dispose(): void;
+}
+
+declare interface WorkbenchPageLocationDiagnostic {
+    code: "page-location-unresolved";
+    source: "boot" | "history" | "navigation" | "project-switch";
+    message: string;
+}
+
+declare interface WorkbenchPageLocationHistoryState {
+    canGoBack: boolean;
+    canGoForward: boolean;
+}
+
+declare type WorkbenchPageMain = PageMain extends infer Main ? Main extends PageMain ? Omit<Main, "tab"> & {
+    readonly tab?: WorkbenchPlacementPresentation["tab"];
+} : never : never;
+
+declare type WorkbenchPageNavigationResult = {
+    ok: true;
+    location: PageLocation;
+} | {
+    ok: false;
+    diagnostic: WorkbenchPageLocationDiagnostic;
+};
+
+declare interface WorkbenchPageRegistry<Value> {
+    store: WorkbenchStore<WorkbenchPageRegistryStoreState<Value>>;
+    registerPage(page: WorkbenchPageContribution): {
+        dispose(): void;
+    };
+    getPage(pageId: string): WorkbenchPageContribution | undefined;
+    listPages(): WorkbenchPageContribution[];
+    pinPlacement(identity: PlacementIdentity): void;
+    openSlot(input: WorkbenchPageSlotOpenInput): void;
+}
+
+declare interface WorkbenchPageRegistryStoreState<Value> {
+    pages: Readonly<Record<string, WorkbenchPageContribution>>;
+    pageStates: Readonly<Record<string, WorkbenchPageRuntimeState>>;
+    projectId?: string;
+    location?: PageLocation;
+    activeModeId?: string;
+    activePageId?: string;
+    placements: readonly ResolvedOwnedPlacement<Value>[];
+    reconciliation: OwnedPlacementReconciliation<Value>;
+}
+
+declare interface WorkbenchPageRuntimeState {
+    openStaticSlotIds: readonly string[];
+    resourceInstances: Readonly<Record<string, readonly WorkbenchPageSlotInstance[]>>;
+    activePrimaryInstanceKey?: string;
+}
+
+declare interface WorkbenchPageSlot extends Omit<PageSlot, "tab"> {
+    readonly tab?: WorkbenchPlacementPresentation["tab"];
+}
+
+declare interface WorkbenchPageSlotInstance {
+    instanceKey: string;
+    resource: ResourceRef;
+    section?: FileRendererSectionTarget;
+    open?: PageOpenIntent;
+}
+
+declare interface WorkbenchPageSlotOpenInput {
+    pageId: string;
+    slotId: string;
+    resource?: ResourceRef;
+    open?: PageOpenIntent;
+}
+
 declare interface WorkbenchPanelContribution {
     id: string;
     title: string;
@@ -2219,16 +2187,15 @@ declare interface WorkbenchPanelContribution {
     singleton?: boolean;
     reuse?: WorkbenchPanelReusePolicy;
     mountStrategy?: WorkbenchPanelMountStrategy;
+    closable?: boolean;
     hiddenByDefault?: boolean;
-    subPanelsOnly?: boolean;
     regionSize?: WorkbenchRegionSize;
     regionCollapsible?: boolean;
     headerBorderBottom?: boolean;
-    floatingPanels?: WorkbenchFloatingPanelVisibility;
     resourceKinds?: string[];
     eligibleLocations?: WorkbenchLocationEligibility;
     priority?: number;
-    openCommandId?: string;
+    openCommand?: WorkbenchCommandTarget;
     tab?: WorkbenchPanelTab;
     config?: unknown;
     canOpen?(resource: ResourceRef): boolean;
@@ -2240,11 +2207,14 @@ declare interface WorkbenchPanelContribution {
 declare interface WorkbenchPanelInstance {
     instanceId: string;
     panelId: string;
+    placementIdentity?: PlacementIdentity;
+    viewId?: string;
     ownerId?: string;
     source?: ContributionSource;
     resource?: ResourceRef;
-    resourceUri?: string;
-    ownerResourceUri?: string;
+    section?: FileRendererSectionTarget;
+    resourceKey?: string;
+    ownerResourceKey?: string;
     title?: string;
     pinned?: boolean;
     closable: boolean;
@@ -2254,23 +2224,6 @@ declare interface WorkbenchPanelInstance {
     tab?: WorkbenchPanelTab;
 }
 
-declare interface WorkbenchPanelInstance_2 {
-    instanceId: string;
-    panelId: string;
-    ownerId?: string;
-    source?: ContributionSource_2;
-    resource?: ResourceRef_2;
-    resourceUri?: string;
-    ownerResourceUri?: string;
-    title?: string;
-    pinned?: boolean;
-    closable: boolean;
-    mountStrategy?: WorkbenchPanelMountStrategy_2;
-    hiddenByDefault?: boolean;
-    tabRetention?: WorkbenchTabRetention_2;
-    tab?: WorkbenchPanelTab_2;
-}
-
 declare type WorkbenchPanelMenuContribution = Omit<WidgetContribution, "region" | "fallbackRegion"> & {
     region: WorkbenchPanelMenuRegion;
     fallbackRegion?: WorkbenchPanelMenuRegion;
@@ -2318,15 +2271,25 @@ declare const workbenchPanelMenuRegions: {
     };
 };
 
-declare interface WorkbenchPanelMenusContribution {
-    panelMenus?: readonly WorkbenchPanelMenuDefinition[];
+declare type WorkbenchPanelMenuSide = "left" | "right";
+
+declare interface WorkbenchPanelMenuState {
+    openByMenuId: Record<string, boolean>;
 }
 
-declare type WorkbenchPanelMenuSide = "left" | "right";
+declare type WorkbenchPanelMenuStateChangeListener = (state: WorkbenchPanelMenuState) => void;
 
-declare type WorkbenchPanelMountStrategy = WidgetMountStrategy;
+declare interface WorkbenchPanelMenuStateController {
+    store: WorkbenchStore<WorkbenchPanelMenuState>;
+    isOpen(menuId: string): boolean;
+    setOpen(menuId: string, open: boolean): void;
+    toggle(menuId: string): void;
+    setPersistenceScope(scope: string | undefined): void;
+    getPersistenceScope(): string | undefined;
+    onDidChange(listener: WorkbenchPanelMenuStateChangeListener): Disposable_2;
+}
 
-declare type WorkbenchPanelMountStrategy_2 = WidgetMountStrategy_2;
+declare type WorkbenchPanelMountStrategy = WidgetMountStrategy;
 
 declare type WorkbenchPanelOpenStrategy = {
     kind: "persistent";
@@ -2355,25 +2318,29 @@ export declare interface WorkbenchPanelRenderInput {
 
 declare type WorkbenchPanelReusePolicy = WidgetReusePolicy;
 
-declare type WorkbenchPanelsChangeListener = (state: WorkbenchPanelsState) => void;
+declare type WorkbenchPanelTab = WorkbenchWidgetTab;
 
-declare interface WorkbenchPanelsController {
-    store: WorkbenchStore<WorkbenchPanelsState>;
-    isOpen(regionId: string): boolean;
-    setOpen(regionId: string, open: boolean): void;
-    toggle(regionId: string): void;
-    setPersistenceScope(scope: string | undefined): void;
-    getPersistenceScope(): string | undefined;
-    onDidChange(listener: WorkbenchPanelsChangeListener): Disposable_2;
+declare interface WorkbenchPlaceholderContribution {
+    id: string;
+    viewId: string;
+    title?: string;
+    region: WorkbenchRegion_2;
+    regionSize?: WorkbenchRegionSize;
+    regionCollapsible?: boolean;
+    config?: unknown;
 }
 
-declare interface WorkbenchPanelsState {
-    openByRegionId: Record<string, boolean>;
+declare interface WorkbenchPlaceholderRegistry {
+    registerPlaceholder(placeholder: WorkbenchPlaceholderContribution, metadata?: ContributionMetadata): Disposable_2;
 }
 
-declare type WorkbenchPanelTab = WorkbenchWidgetTab;
-
-declare type WorkbenchPanelTab_2 = WorkbenchWidgetTab_2;
+declare interface WorkbenchPlacementPresentation {
+    mountStrategy?: WidgetMountStrategy;
+    hiddenByDefault?: boolean;
+    headerBorderBottom?: boolean;
+    tab?: WorkbenchPanelTab;
+    config?: unknown;
+}
 
 export declare const WorkbenchPreferencesForm: (props: WorkbenchPreferencesFormProps) => JSX.Element;
 
@@ -2393,6 +2360,15 @@ export declare interface WorkbenchPreferencesFormProps {
 declare interface WorkbenchProps {
     workbench: WorkbenchCore;
     renderParamField?: CommandParamFieldRenderer;
+    /** Icon shown in the closed Side Panel's bubble launcher. */
+    sidePanelBubbleIcon?: ReactNode;
+    /** Host action for opening the closed Side Panel from its bubble launcher. */
+    onOpenSidePanel?: () => void;
+}
+
+declare interface WorkbenchReactViewBody {
+    kind: "react";
+    render: WorkbenchRendererRegistration["render"];
 }
 
 export declare const WorkbenchRegion: (props: WorkbenchRegionProps) => JSX.Element | null;
@@ -2407,7 +2383,10 @@ declare interface WorkbenchRegionProps {
     transparent?: boolean;
 }
 
-declare const workbenchRegions: readonly ["nav", "activity", "sidenav-header", "sidenav", "main-header", "main-left-menu", "main", "main-right-menu", "secondary-header", "secondary-left-menu", "secondary", "secondary-right-menu", "side-header", "side-left-menu", "side", "side-right-menu", "status", "overlay"];
+declare const workbenchRegions: readonly ["nav", "activity", "sidenav", "main-header", "main-left-menu", "main", "main-right-menu", "secondary-header", "secondary-left-menu", "secondary", "secondary-right-menu", "side-header", "side-left-menu", "side", "side-right-menu", "status", "overlay"];
+
+/** Region-level layout policy owned by the active mode or the host, never by a placement. */
+declare type WorkbenchRegionSettings = ModeRegionSettings;
 
 declare interface WorkbenchRegionSize {
     defaultPx?: number;
@@ -2431,35 +2410,9 @@ declare interface WorkbenchRegionTabsProps {
     visibilityStorageKey?: string;
 }
 
-declare type WorkbenchRendererChangeListener = () => void;
-
-export declare type WorkbenchRendererRegistration = {
+declare interface WorkbenchRendererRegistration {
     id: string;
-    keepAlive?: false;
     render: (input: WorkbenchPanelRenderInput) => unknown;
-} | {
-    id: string;
-    keepAlive: true;
-    render: () => unknown;
-};
-
-export declare interface WorkbenchRendererRegistry {
-    store: WorkbenchStore<WorkbenchRendererStoreState>;
-    registerRenderer(renderer: WorkbenchRendererRegistration): Disposable_2;
-    getRenderer(id: string): WorkbenchRendererRegistration | undefined;
-    listRenderers(): WorkbenchRendererRegistration[];
-    onDidChange(listener: WorkbenchRendererChangeListener): Disposable_2;
-    claim(rendererId: string, slot: HTMLElement, input: WorkbenchPanelRenderInput): Disposable_2;
-    getHost(rendererId: string): HTMLElement | undefined;
-    getClaim(rendererId: string): WorkbenchPanelRenderInput | undefined;
-}
-
-declare type WorkbenchRenderers = WorkbenchRendererRegistry & TreeRendererRegistry & KanbanRendererRegistry & DataTableRendererRegistry & FileRendererRegistry & ControlsRendererRegistry;
-
-declare interface WorkbenchRendererStoreState {
-    renderers: Record<string, WorkbenchRendererRegistration>;
-    hosts: Record<string, RegisteredKeepAliveHost>;
-    claims: Record<string, WorkbenchPanelRenderInput>;
 }
 
 export declare interface WorkbenchSettingsModuleOptions {
@@ -2478,7 +2431,29 @@ declare interface WorkbenchShellController {
     onDidChange(listener: () => void): Disposable_2;
 }
 
-declare type WorkbenchShellOpenRegion = "sidenav" | "secondary" | WorkbenchPanelMenuRegion;
+declare type WorkbenchShellOpenRegion = "sidenav" | "secondary" | "side";
+
+declare interface WorkbenchShellPlacementContribution extends WorkbenchPlacementPresentation {
+    readonly id: string;
+    readonly item: WorkbenchOwnedPlacementItem;
+    readonly region: WorkbenchRegion_2;
+    readonly order?: number;
+}
+
+declare interface WorkbenchShellPlacementRegistry {
+    registerPlacement(placement: WorkbenchShellPlacementContribution): Disposable_2;
+    getPlacement(placementId: string): WorkbenchShellPlacementContribution | undefined;
+    listPlacements(): WorkbenchShellPlacementContribution[];
+    openPlacement(input: OpenWorkbenchShellPlacementInput): PlacementIdentity;
+    updatePlacement(identity: PlacementIdentity, input: {
+        resource?: ResourceRef;
+        title?: string;
+        open?: PageOpenIntent;
+    }): void;
+    closePlacement(identity: PlacementIdentity): void;
+    resolvePlacements(context?: OwnedPlacementLocationContext): readonly ResolvedOwnedPlacement<WorkbenchWidgetPlacement>[];
+    onDidChange(listener: () => void): Disposable_2;
+}
 
 declare interface WorkbenchShellRegionState {
     open: boolean;
@@ -2488,6 +2463,7 @@ declare interface WorkbenchShellRegionState {
 declare type WorkbenchSidePanelChangeListener = (mode: WorkbenchSidePanelMode) => void;
 
 declare interface WorkbenchSidePanelController {
+    canFloat(): boolean;
     store: WorkbenchStore<WorkbenchSidePanelState>;
     getMode(): WorkbenchSidePanelMode;
     setMode(mode: WorkbenchSidePanelMode): void;
@@ -2503,6 +2479,8 @@ declare interface WorkbenchSidePanelProps {
     contentSlotRef: (node: HTMLDivElement | null) => void;
     bottomOffset?: string;
     header?: ReactNode;
+    bubbleIcon?: ReactNode;
+    onOpen?: () => void;
 }
 
 declare interface WorkbenchSidePanelState {
@@ -2513,6 +2491,52 @@ declare interface WorkbenchSnapshot {
     layout: WorkbenchLayout;
 }
 
+declare interface WorkbenchStatusBarItem {
+    id: string;
+    viewId: string;
+    slot: WorkbenchStatusBarSlot;
+    order?: number;
+    isVisible?(): boolean;
+}
+
+declare interface WorkbenchStatusBarRegistry {
+    store: WorkbenchStore<WorkbenchStatusBarRegistryState>;
+    registerItem(item: WorkbenchStatusBarItem): Disposable_2;
+    getItem(id: string): WorkbenchStatusBarItem | undefined;
+    listItems(): WorkbenchStatusBarItem[];
+    listVisibleItems(slot?: WorkbenchStatusBarSlot): WorkbenchStatusBarItem[];
+}
+
+declare interface WorkbenchStatusBarRegistryState {
+    items: Record<string, WorkbenchStatusBarItem>;
+}
+
+declare type WorkbenchStatusBarSlot = "leading" | "trailing";
+
+declare interface WorkbenchStatusRegistry {
+    store: WorkbenchStore<WorkbenchStatusRegistryState>;
+    registerStatusSet(contribution: WorkbenchStatusSetContribution, metadata?: ContributionMetadata): Disposable_2;
+    getStatusSet(id: string): RegisteredWorkbenchStatusSet | undefined;
+    listStatusSets(): RegisteredWorkbenchStatusSet[];
+    getStatuses(id: string): readonly WorkflowStatus[] | undefined;
+    load(id: string): Promise<readonly WorkflowStatus[]>;
+    query(id: string): Promise<readonly WorkflowStatus[]>;
+    save(id: string, statuses: readonly WorkflowStatus[]): Promise<readonly WorkflowStatus[]>;
+}
+
+declare interface WorkbenchStatusRegistryState {
+    statusSets: Record<string, RegisteredWorkbenchStatusSet>;
+    values: Record<string, readonly WorkflowStatus[]>;
+}
+
+declare interface WorkbenchStatusSetContribution {
+    id: string;
+    title: string;
+    actions?: readonly WorkflowStatusAction[];
+    query(): Promise<readonly WorkflowStatus[]> | readonly WorkflowStatus[];
+    save?(statuses: readonly WorkflowStatus[]): Promise<readonly WorkflowStatus[]> | readonly WorkflowStatus[];
+}
+
 declare interface WorkbenchStore<TState> {
     getState(): TState;
     getInitialState(): TState;
@@ -2529,15 +2553,26 @@ declare type WorkbenchStoreSelector<TState, TValue> = (state: TState) => TValue;
 
 declare type WorkbenchStoreSelectorListener<TValue> = (value: TValue, previousValue: TValue) => void;
 
-declare type WorkbenchSubPanelContribution = Omit<WidgetContribution, "region" | "fallbackRegion"> & {
-    region: WorkbenchPanelRegion;
-    fallbackRegion?: WorkbenchPanelRegion;
-} & WorkbenchPanelMenusContribution;
+declare type WorkbenchTabAction = ({
+    kind: "command";
+} & WorkbenchCommandTarget) | {
+    kind: "navigation";
+    target: NavigationTarget;
+};
 
-declare interface WorkbenchSubPanelRef {
-    contributionId: string;
-    resourceUri?: string;
-    instanceKey?: string;
+declare interface WorkbenchTabMenuGroup {
+    id: string;
+    rows: readonly WorkbenchTabMenuRow[];
+}
+
+declare interface WorkbenchTabMenuRow {
+    id: string;
+    label: string;
+    icon?: string;
+    iconColor?: string;
+    selected?: boolean;
+    disabled?: boolean;
+    action?: WorkbenchTabAction;
 }
 
 declare type WorkbenchTabPosition = "start" | "end" | {
@@ -2548,7 +2583,16 @@ declare type WorkbenchTabPosition = "start" | "end" | {
 
 declare type WorkbenchTabRetention = "preview" | "persistent";
 
-declare type WorkbenchTabRetention_2 = "preview" | "persistent";
+declare interface WorkbenchTabSnapshot {
+    label?: string;
+    icon?: string;
+    indicator?: {
+        icon: string;
+        color?: string;
+        label?: string;
+    };
+    menu?: readonly WorkbenchTabMenuGroup[];
+}
 
 declare interface WorkbenchTerminalController {
     store: WorkbenchStore<WorkbenchTerminalState>;
@@ -2557,6 +2601,7 @@ declare interface WorkbenchTerminalController {
     setSessionOpener(opener: WorkbenchTerminalSessionOpener | null): void;
     /** Opens a session; the live adapter stays host-side and only the id is returned. */
     open(input: {
+        bindingId?: string;
         request: WorkbenchTerminalSessionRequest;
         title?: string;
     }): Promise<{
@@ -2575,6 +2620,7 @@ declare interface WorkbenchTerminalController {
         sessionId: string;
         signal?: string;
     }): Promise<void>;
+    killBinding(bindingId: string): Promise<void>;
     subscribe(sessionId: string, sink: WorkbenchTerminalSessionSink): () => void;
     getSession(sessionId: string): WorkbenchTerminalSessionModel | undefined;
     listSessions(): WorkbenchTerminalSessionModel[];
@@ -2586,8 +2632,8 @@ declare interface WorkbenchTerminalController {
  * Body of the host-owned terminal panel. Chrome (tab, title, close action,
  * resize) comes from the workbench `secondary` region; this component only mounts
  * the terminal bound to the workbench terminal controller. Collapsing the panel
- * keeps the terminal mounted. Closing its tab unmounts the terminal and kills
- * its session (close = kill).
+ * keeps the terminal mounted. Scope changes keep the session alive; the terminal
+ * module ends it when its tab is explicitly closed.
  */
 export declare const WorkbenchTerminalPanel: (props: WorkbenchTerminalPanelProps) => JSX.Element;
 
@@ -2646,12 +2692,14 @@ declare interface WorkbenchTerminalState {
     sessionsById: Record<string, WorkbenchTerminalSessionModel>;
 }
 
-export declare const WorkbenchThemeProvider: (props: WorkbenchThemeProviderProps) => string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | ReactPortal | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | JSX.Element | null | undefined;
+export declare const WorkbenchThemeProvider: (props: WorkbenchThemeProviderProps) => string | number | bigint | boolean | JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | ReactPortal | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
 
 declare interface WorkbenchThemeProviderProps {
     children: ReactNode;
-    initialThemePreference?: ThemePreference_3;
-    themePreferences?: readonly ThemePreferenceOption_3[];
+    initialThemePreference?: ThemePreference_2;
+    defaultThemePreference?: ThemePreference_2;
+    preferenceScope?: string;
+    themePreferences?: readonly ThemePreferenceOption_2[];
     fileIconThemePreferences?: readonly FileIconThemePreferenceOption_2[];
 }
 
@@ -2678,22 +2726,77 @@ declare interface WorkbenchTreeViewProps {
     onSidenavContextActionsChange?: (actions: ResourceContextAction_2[]) => void;
 }
 
+declare type WorkbenchTreeViews = Pick<TreeRendererRegistry, "getTreeState" | "setNodeExpanded" | "setSectionExpanded" | "setSelectedNode">;
+
+declare type WorkbenchViewBody = WorkbenchReactViewBody | NativeViewBody<"tree", TreeRendererContribution> | NativeViewBody<"file", FileRendererContribution> | NativeViewBody<"controls", ControlsRendererContribution> | NativeViewBody<"kanban", KanbanRendererContribution> | NativeViewBody<"dataTable", DataTableRendererContribution>;
+
+declare interface WorkbenchViewContribution {
+    id: string;
+    title: string;
+    icon?: string;
+    body: WorkbenchViewBody;
+}
+
+declare interface WorkbenchViewHierarchyNode {
+    type: "view";
+    viewId: string;
+    label?: string;
+    icon?: string;
+}
+
+declare interface WorkbenchViewMenuContribution {
+    id: string;
+    ownerViewId: string;
+    viewId: string;
+    side: "left" | "right";
+    priority?: number;
+    mountStrategy?: "active" | "keep-mounted";
+    hiddenByDefault?: boolean;
+    regionSize?: WorkbenchRegionSize;
+    regionCollapsible?: boolean;
+    headerBorderBottom?: boolean;
+    config?: unknown;
+}
+
+declare interface WorkbenchViewMenuRegistry {
+    registerViewMenu(menu: WorkbenchViewMenuContribution): Disposable_2;
+    getViewMenu(id: string): WorkbenchViewMenuContribution | undefined;
+    listViewMenus(ownerViewId?: string): WorkbenchViewMenuContribution[];
+    definitionsFor(ownerViewId: string, placementId: string): readonly WorkbenchPanelMenuDefinition[];
+}
+
+declare interface WorkbenchViewRegistry {
+    store: WorkbenchStore<WorkbenchViewRegistryStoreState>;
+    registerView(view: WorkbenchViewContribution, metadata?: ContributionMetadata): Disposable_2;
+    getView(viewId: string): RegisteredWorkbenchView | undefined;
+    listViews(): RegisteredWorkbenchView[];
+    refreshView(viewId: string, input?: unknown): void;
+}
+
+declare interface WorkbenchViewRegistryStoreState {
+    views: Record<string, RegisteredWorkbenchView>;
+}
+
 export declare const WorkbenchWidgetHost: (props: WorkbenchWidgetHostProps) => JSX.Element;
 
 declare interface WorkbenchWidgetHostProps {
     workbench: WorkbenchCore;
     placement: WorkbenchWidgetPlacement;
     widget?: RegisteredWidgetContribution | RegisteredPlaceholderContribution;
+    region?: WorkbenchRegion_2;
 }
 
 declare interface WorkbenchWidgetPlacement {
     widgetId: string;
     contributionId: string;
+    placementIdentity?: PlacementIdentity;
+    viewId?: string;
     ownerId?: string;
     source?: ContributionSource;
     resource?: ResourceRef;
-    resourceUri?: string;
-    ownerResourceUri?: string;
+    section?: FileRendererSectionTarget;
+    resourceKey?: string;
+    ownerResourceKey?: string;
     title?: string;
     pinned?: boolean;
     closable?: boolean;
@@ -2707,15 +2810,35 @@ declare interface WorkbenchWidgetPlacement {
 declare type WorkbenchWidgetRole = "content" | "location" | "sub-panel" | "panel-menu";
 
 declare interface WorkbenchWidgetTab {
-    contentRendererId?: string;
-    /** Custom actions shown when the user activates an already-active tab. */
-    customMenuRendererId?: string;
+    getSnapshot(instance: WorkbenchPanelInstance): WorkbenchTabSnapshot;
+    subscribe?(listener: () => void): {
+        dispose(): void;
+    } | (() => void);
+    refreshEvents?: readonly string[];
 }
 
-declare interface WorkbenchWidgetTab_2 {
-    contentRendererId?: string;
-    /** Custom actions shown when the user activates an already-active tab. */
-    customMenuRendererId?: string;
+declare interface WorkflowStatus {
+    id: string;
+    label: string;
+    color: string;
+    icon?: string | null;
+    sortOrder: number;
+    isDefault?: boolean;
+    actions?: readonly string[];
+}
+
+declare interface WorkflowStatusAction {
+    id: string;
+    label: string;
+    icon?: string;
+}
+
+export declare const WorkflowStatusSettings: (props: WorkflowStatusSettingsProps) => JSX.Element;
+
+declare interface WorkflowStatusSettingsProps {
+    workbench: {
+        statuses: WorkbenchStatusRegistry;
+    };
 }
 
 export { }