@pstdio/workbench 0.7.1 → 0.8.0

package/dist/extensions.d.ts

@@ -1,20 +1,35 @@
 import { CommandExecuteRequest } from '@pstdio/sdk/api';
 import { CommandExecuteResponse } from '@pstdio/sdk/api';
 import { ComponentType } from 'react';
+import { ExtensionActivityItemRecord } from 'pstdio-api-contracts';
 import { ExtensionCommandPaletteContribution } from '@pstdio/sdk/api';
-import { ExtensionMenuContribution } from '@pstdio/sdk/api';
+import { ExtensionKeybindingRecord } from 'pstdio-api-contracts';
+import { ExtensionMenuContribution } from 'pstdio-api-contracts';
+import { ExtensionMenuContribution as ExtensionMenuContribution_2 } from '@pstdio/sdk/api';
+import { ExtensionModeRecord } from 'pstdio-api-contracts';
+import { ExtensionResourceKindRecord } from 'pstdio-api-contracts';
+import { ExtensionResourcePanelRecord } from 'pstdio-api-contracts';
+import { ExtensionSettingDefinitionRecord } from 'pstdio-api-contracts';
+import { ExtensionSettingsSectionRecord } from 'pstdio-api-contracts';
+import { ExtensionTreeItemContribution } from 'pstdio-api-contracts';
 import { HostCapability } from 'pstdio-extensions/bridge/contract';
 import { HostCapabilityRegistry } from 'pstdio-extensions/bridge/contract';
 import { HostEventPublisher } from 'pstdio-extensions/bridge/host';
 import { JSX } from 'react/jsx-runtime';
 import { Localizable } from '@pstdio/sdk/extensions';
+import { NavigationTarget as NavigationTarget_2 } from '@pstdio/sdk/extensions';
 import { ReactNode } from 'react';
 import { ThemePreference as ThemePreference_2 } from 'pstdio-extensions/bridge/contract';
 import { WorkbenchExtensionCommandPaletteResourceRecord } from '@pstdio/sdk/api';
-import { WorkbenchExtensionControlsRendererRecord } from '@pstdio/sdk/api';
+import { WorkbenchExtensionCommandPaletteResourceRecord as WorkbenchExtensionCommandPaletteResourceRecord_2 } from 'pstdio-api-contracts';
+import { WorkbenchExtensionControlsRendererRecord } from 'pstdio-api-contracts';
 import { WorkbenchExtensionDataTableRendererRecord } from 'pstdio-api-contracts';
-import { WorkbenchExtensionKanbanRendererRecord } from '@pstdio/sdk/api';
+import { WorkbenchExtensionFileRendererRecord } from 'pstdio-api-contracts';
+import { WorkbenchExtensionKanbanRendererRecord } from 'pstdio-api-contracts';
 import { WorkbenchExtensionMetadata } from '@pstdio/sdk/api';
+import { WorkbenchExtensionPanelRecord } from 'pstdio-api-contracts';
+import { WorkbenchExtensionSettingsPanelRecord } from 'pstdio-api-contracts';
+import { WorkbenchExtensionTreeRendererRecord } from 'pstdio-api-contracts';
 
 declare interface AttributeDescriptor {
     id: string;
@@ -97,24 +112,22 @@ export declare interface BridgeWebviewRenderContext {
 }
 
 export declare const buildWorkbenchExtensionCommandPaletteRegistrations: (input: {
-    metadata: WorkbenchExtensionMetadata;
+    metadata: CommandContributionMetadata;
     createCommandId?: (contribution: ExtensionCommandPaletteContribution) => string;
     resolveString?: WorkbenchExtensionStringResolver;
 }) => WorkbenchExtensionCommandPaletteRegistration[];
 
 export declare const buildWorkbenchExtensionMenuRegistrations: (input: {
-    metadata: WorkbenchExtensionMetadata;
+    metadata: CommandContributionMetadata;
     menuSlotsById: ReadonlyMap<string, WorkbenchExtensionMenuSlotConfig>;
     menuTargetsById?: ReadonlyMap<string, WorkbenchExtensionMenuSlotConfig>;
-    createCommandId?: (contribution: ExtensionMenuContribution) => string;
+    createCommandId?: (contribution: ExtensionMenuContribution_2) => string;
     createWhenExpression?: WorkbenchExtensionMenuWhenBuilder;
     resolveString?: WorkbenchExtensionStringResolver;
-}) => WorkbenchExtensionMenuRegistration[];
-
-export declare const buildWorkbenchExtensionRouteEntries: (input: {
-    metadata: WorkbenchExtensionMetadata | undefined;
-    createResource: (resourceInput: WorkbenchExtensionRouteResourceInput) => ResourceRef;
-}) => any;
+}) => {
+    registrations: WorkbenchExtensionMenuRegistration[];
+    unresolved: UnresolvedWorkbenchExtensionMenuContribution[];
+};
 
 /**
  * A data-driven list of items, each opening a contributor-supplied editor. The
@@ -141,6 +154,8 @@ declare interface Command {
     params?: CommandParamSchema;
 }
 
+declare type CommandContributionMetadata = Pick<WorkbenchExtensionMetadata, "commands" | "commandPaletteContributions" | "menuContributions">;
+
 declare interface CommandHandler<TArgs = unknown, TResult = unknown> {
     prepareArgs?(args: TArgs, context?: WorkbenchCommandExecutionContext, onArgsChange?: (args: TArgs) => void): TArgs | Promise<TArgs>;
     execute(args: TArgs, context?: WorkbenchCommandExecutionContext): TResult | Promise<TResult>;
@@ -202,6 +217,7 @@ declare interface CommandParamDescriptor {
     accept?: string;
     multiple?: boolean;
     metadata?: Record<string, unknown>;
+    resolvedFrom?: "resource";
 }
 
 declare interface CommandParamOption {
@@ -236,6 +252,8 @@ declare interface CompositionDiagnostic {
     slot?: string;
 }
 
+declare type CompositionLayout = Pick<LayoutModel, "getLayout" | "openWidget" | "reconcilePanelMenus" | "setRegionActiveWidget" | "updateWidgetPlacement">;
+
 declare interface CompositionModeDefinition {
     id: string;
     extensionId?: string;
@@ -269,7 +287,7 @@ declare interface CompositionPlacementPolicy {
 }
 
 declare interface CompositionReconcileContext {
-    layout: LayoutModel;
+    layout: CompositionLayout;
     notifications: NotificationRegistry;
 }
 
@@ -405,7 +423,7 @@ declare interface ControlsUpdateValueInput {
     resource?: ResourceRef;
 }
 
-declare type ControlsViewRecord = WorkbenchExtensionMetadata["panels"][number];
+declare type ControlsViewRecord = InternalWorkbenchExtensionMetadata["panels"][number];
 
 export declare type CreateBridgeWebviewHostCapabilities = (context: BridgeWebviewRenderContext) => HostCapabilityRegistry;
 
@@ -584,7 +602,7 @@ declare interface DataTableRendererThemeColor {
     };
 }
 
-declare type DataTableViewRecord = WorkbenchExtensionMetadata["panels"][number];
+declare type DataTableViewRecord = InternalWorkbenchExtensionMetadata["panels"][number];
 
 declare interface DeclaredPanelPlacement {
     for?: string;
@@ -628,11 +646,15 @@ declare interface EnumOptionsSource {
     getSnapshot: () => EnumOption[];
 }
 
-declare type ExtensionPanelRecord = WorkbenchExtensionMetadata["panels"][number];
+declare interface ExtensionNavigationSourcePlacement {
+    instanceId: string;
+}
+
+declare type ExtensionPanelRecord = InternalWorkbenchExtensionMetadata["panels"][number];
 
-declare type ExtensionResourcePanels = WorkbenchExtensionMetadata["resourcePanels"];
+declare type ExtensionResourcePanels = InternalWorkbenchExtensionMetadata["resourcePanels"];
 
-declare type ExtensionTreeRendererRecord = NonNullable<WorkbenchExtensionMetadata["treeRenderers"]>[number];
+declare type ExtensionTreeRendererRecord = NonNullable<InternalWorkbenchExtensionMetadata["treeRenderers"]>[number];
 
 declare interface ExtensionTreeResource {
     type: string;
@@ -641,7 +663,7 @@ declare interface ExtensionTreeResource {
     metadata?: Record<string, unknown>;
 }
 
-declare type ExtensionTreeViewRecord = WorkbenchExtensionMetadata["panels"][number] | NonNullable<WorkbenchExtensionMetadata["panels"][number]["panelMenus"]>[number];
+declare type ExtensionTreeViewRecord = InternalWorkbenchExtensionMetadata["panels"][number] | NonNullable<InternalWorkbenchExtensionMetadata["panels"][number]["panelMenus"]>[number];
 
 export declare interface ExtensionWebviewFileCapabilities {
     delete(params: unknown): Promise<unknown> | unknown;
@@ -770,6 +792,7 @@ declare interface HistoryController {
     restore(): HistoryEntry | undefined;
     flush(): void;
     clear(): void;
+    migrateState(transform: (state: HistoryStoreState) => HistoryStoreState): void;
 }
 
 declare type HistoryEntry = WorkbenchNavigationEntry;
@@ -789,6 +812,53 @@ declare interface HostTreeDefaultNodesInput {
 
 declare type HostTreeDefaultNodesResolver = (input: HostTreeDefaultNodesInput) => Promise<TreeNode[]> | TreeNode[];
 
+declare interface InternalWorkbenchExtensionMetadata {
+    extensions: WorkbenchExtensionMetadata["extensions"];
+    commands: WorkbenchExtensionMetadata["commands"];
+    menuContributions: ExtensionMenuContribution[];
+    commandPaletteContributions: WorkbenchExtensionMetadata["commandPaletteContributions"];
+    modes: ExtensionModeRecord[];
+    panels: WorkbenchExtensionPanelRecord[];
+    resourceKinds: ExtensionResourceKindRecord[];
+    resourcePanels: ExtensionResourcePanelRecord[];
+    resourceHierarchyProviders: Array<{
+        id: string;
+        extensionId: string;
+        resourceKind: string;
+    }>;
+    routes: [];
+    treeItems: ExtensionTreeItemContribution[];
+    activityItems: ExtensionActivityItemRecord[];
+    settingsSections: ExtensionSettingsSectionRecord[];
+    settingsPanels: WorkbenchExtensionSettingsPanelRecord[];
+    kanbanRenderers: WorkbenchExtensionKanbanRendererRecord[];
+    dataTableRenderers: WorkbenchExtensionDataTableRendererRecord[];
+    commandPaletteResources: WorkbenchExtensionCommandPaletteResourceRecord_2[];
+    treeRenderers: WorkbenchExtensionTreeRendererRecord[];
+    fileRenderers: WorkbenchExtensionFileRendererRecord[];
+    controlsRenderers: WorkbenchExtensionControlsRendererRecord[];
+    keybindings: ExtensionKeybindingRecord[];
+    settingsDefinitions: ExtensionSettingDefinitionRecord[];
+    statuses: WorkbenchExtensionMetadata["statuses"];
+    statusBarItems: Array<{
+        id: string;
+        extensionId: string;
+        viewId: string;
+        slot: "leading" | "trailing";
+        order?: number;
+        when?: {
+            mode?: string | string[];
+            source?: string[];
+            viewId?: string | string[];
+            resourceType?: string[];
+            metadata?: Record<string, unknown>;
+        };
+    }>;
+    diagnostics: WorkbenchExtensionMetadata["diagnostics"];
+}
+
+export declare const isExtensionNavigationTarget: (value: unknown) => value is NavigationTarget_2;
+
 declare interface KanbanRendererContribution<TRow extends KanbanRendererRow = KanbanRendererRow> {
     id: string;
     title: string;
@@ -1122,7 +1192,12 @@ declare interface NavigationTargetCompound {
     targets: readonly NavigationTargetItem[];
 }
 
-declare type NavigationTargetItem = NavigationTargetResource | NavigationTargetPanel | NavigationTargetCommand;
+declare interface NavigationTargetHref {
+    kind: "href";
+    href: string;
+}
+
+declare type NavigationTargetItem = NavigationTargetResource | NavigationTargetView | NavigationTargetPanel | NavigationTargetCommand | NavigationTargetHref;
 
 declare interface NavigationTargetPanel {
     kind: "panel";
@@ -1136,6 +1211,12 @@ declare interface NavigationTargetResource {
     input?: OpenResourceInput;
 }
 
+declare interface NavigationTargetView {
+    kind: "view";
+    viewId: string;
+    input?: OpenWorkbenchViewInput;
+}
+
 declare const NO_GROUPING = "none";
 
 declare interface NotificationRegistry {
@@ -1152,7 +1233,8 @@ declare interface OpenResourceInput {
 }
 
 declare interface OpenWidgetInput {
-    resource?: ResourceRef;
+    viewId?: string | null;
+    resource?: ResourceRef | null;
     title?: string;
     region?: WorkbenchRegion;
     role?: WorkbenchWidgetRole;
@@ -1170,7 +1252,10 @@ declare interface OpenWidgetInput {
 }
 
 declare interface OpenWorkbenchPanelInput {
-    resource?: ResourceRef;
+    /** 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;
     role?: WorkbenchWidgetRole;
@@ -1182,6 +1267,8 @@ declare interface OpenWorkbenchPanelInput {
     strategy?: WorkbenchPanelOpenStrategy;
 }
 
+declare type OpenWorkbenchViewInput = Omit<OpenWorkbenchPanelInput, "viewId">;
+
 export declare const panelMenuDeclarationOffsets: <T extends {
     panelMenus?: readonly unknown[];
 }>(panels: readonly T[]) => number[];
@@ -1315,36 +1402,47 @@ declare interface RegisteredWorkbenchNotification extends RegisteredContribution
     metadata?: Record<string, unknown>;
 }
 
+declare type RegisteredWorkbenchStatusSet = WorkbenchStatusSetContribution & RegisteredContributionMetadata;
+
+declare type RegisteredWorkbenchView = WorkbenchViewContribution & RegisteredContributionMetadata;
+
 export declare const registerWorkbenchExtensionCommandPaletteResources: (context: WorkbenchExtensionCommandContext, records: readonly WorkbenchExtensionCommandPaletteResourceRecord[]) => {
     dispose(): void;
 };
 
-export declare const registerWorkbenchExtensionContributions: (input: RegisterWorkbenchExtensionContributionsInput) => {
+export declare const registerWorkbenchExtensionContributions: (sourceInput: RegisterWorkbenchExtensionContributionsInput) => {
     dispose(): void;
 };
 
 export declare interface RegisterWorkbenchExtensionContributionsInput {
+    createKeybindingWhenExpression?: (when: ExtensionKeybindingRecord["when"]) => string | undefined;
     createMenuWhenExpression?: WorkbenchExtensionMenuWhenBuilder;
     createWebviewHostCapabilities?: CreateBridgeWebviewHostCapabilities;
     createWebviewHostCapabilityOverrides?: CreateBridgeWebviewHostCapabilities;
     createWebviewProps?: CreateBridgeWebviewProps;
     createWebviewTheme?: CreateBridgeWebviewTheme;
     executeCommand(commandId: string, body: CommandExecuteRequest): Promise<unknown> | unknown;
+    kanbanAdapter?: WorkbenchExtensionKanbanRendererAdapter;
     menuSlotsById?: ReadonlyMap<string, WorkbenchExtensionMenuSlotConfig>;
     menuTargetsById?: ReadonlyMap<string, WorkbenchExtensionMenuSlotConfig>;
+    menuRegistrations?: readonly WorkbenchExtensionHostMenuRegistration[];
     metadata: WorkbenchExtensionMetadata;
     openHref?: (href: string) => unknown;
+    prepareCommandArgs?(commandId: string, args: unknown, context?: WorkbenchCommandExecutionContext, onArgsChange?: (args: unknown) => void): Promise<unknown> | unknown;
+    prepareResource?: (resource: ResourceRef) => void;
     projectId: string;
-    routeResourceKind?: string;
+    resolveViewInput?: WorkbenchExtensionViewInputResolver;
+    resolveTreeNodeResource?: RegisterWorkbenchExtensionTreeRenderersInput["resolveNodeResource"];
     settingsSectionId?: string;
     settingsSectionTitle?: string;
+    subscribeRefreshEvents?: (listener: (event: WorkbenchExtensionRefreshEvent) => void) => Disposable_2;
     webviewFiles?: ExtensionWebviewFileCapabilities;
     workbench: WorkbenchModuleContext;
 }
 
-export declare const registerWorkbenchExtensionControlsRenderers: (context: WorkbenchExtensionCommandContext, records: WorkbenchExtensionControlsRendererRecord[], panels: ControlsViewRecord[], adapter?: WorkbenchExtensionControlsAdapter, resourcePanels?: WorkbenchExtensionMetadata["resourcePanels"]) => Disposable_2;
+export declare const registerWorkbenchExtensionControlsRenderers: (context: WorkbenchExtensionCommandContext, records: WorkbenchExtensionControlsRendererRecord[], panels: ControlsViewRecord[], adapter?: WorkbenchExtensionControlsAdapter, resourcePanels?: InternalWorkbenchExtensionMetadata["resourcePanels"]) => Disposable_2;
 
-export declare const registerWorkbenchExtensionDataTableRenderers: (context: WorkbenchExtensionCommandContext, records: WorkbenchExtensionDataTableRendererRecord[], panels: DataTableViewRecord[], resourcePanels?: WorkbenchExtensionMetadata["resourcePanels"]) => Disposable_2;
+export declare const registerWorkbenchExtensionDataTableRenderers: (context: WorkbenchExtensionCommandContext, records: WorkbenchExtensionDataTableRendererRecord[], panels: DataTableViewRecord[], resourcePanels?: InternalWorkbenchExtensionMetadata["resourcePanels"], resolveViewInput?: WorkbenchExtensionViewInputResolver) => Disposable_2;
 
 export declare const registerWorkbenchExtensionFileRenderers: (input: RegisterWorkbenchExtensionFileRenderersInput) => {
     dispose(): void;
@@ -1352,12 +1450,13 @@ export declare const registerWorkbenchExtensionFileRenderers: (input: RegisterWo
 
 export declare interface RegisterWorkbenchExtensionFileRenderersInput {
     executeCommand(commandId: string, body: CommandExecuteRequest): Promise<unknown> | unknown;
-    metadata: WorkbenchExtensionMetadata;
+    metadata: InternalWorkbenchExtensionMetadata;
     projectId: string;
+    resolveViewInput?: WorkbenchExtensionViewInputResolver;
     workbench: WorkbenchModuleContext;
 }
 
-export declare const registerWorkbenchExtensionKanbanRenderers: (context: WorkbenchExtensionCommandContext, records: readonly WorkbenchExtensionKanbanRendererRecord[], adapter?: WorkbenchExtensionKanbanRendererAdapter, panels?: WorkbenchExtensionMetadata["panels"], resourcePanels?: WorkbenchExtensionMetadata["resourcePanels"]) => {
+export declare const registerWorkbenchExtensionKanbanRenderers: (context: WorkbenchExtensionCommandContext, records: readonly WorkbenchExtensionKanbanRendererRecord[], adapter?: WorkbenchExtensionKanbanRendererAdapter, panels?: InternalWorkbenchExtensionMetadata["panels"], resourcePanels?: InternalWorkbenchExtensionMetadata["resourcePanels"]) => {
     dispose(): void;
 };
 
@@ -1365,6 +1464,9 @@ export declare const registerWorkbenchExtensionPanel: (input: RegisterWorkbenchE
 
 export declare interface RegisterWorkbenchExtensionPanelInput {
     contribution: WorkbenchPanelContribution;
+    path?: string;
+    aliases?: readonly string[];
+    resolveInput?: WorkbenchViewContribution["resolveInput"];
     workbench: WorkbenchModuleContext;
 }
 
@@ -1384,7 +1486,7 @@ export declare interface RegisterWorkbenchExtensionTreeRenderersInput {
     executeCommand(commandId: string, body: CommandExecuteRequest): Promise<unknown> | unknown;
     getHostTreeFooterNodes?: HostTreeDefaultNodesResolver;
     getHostTreeHeaderNodes?: HostTreeDefaultNodesResolver;
-    metadata: WorkbenchExtensionMetadata;
+    metadata: InternalWorkbenchExtensionMetadata;
     projectId: string;
     /**
      * Host canonicalization for node resources. A host that gives extension
@@ -1393,6 +1495,7 @@ export declare interface RegisterWorkbenchExtensionTreeRenderersInput {
      * gets a second identity when opened from a tree.
      */
     resolveNodeResource?: (resource: ExtensionTreeResource) => ResourceRef;
+    resolveViewInput?: WorkbenchExtensionViewInputResolver;
     workbench: WorkbenchModuleContext;
 }
 
@@ -1475,7 +1578,7 @@ declare interface ResourceContextAction {
 
 declare interface ResourceHierarchyCycle {
     code: typeof resourceHierarchyCycleCode;
-    path: ResourceRef[];
+    path: WorkbenchHierarchyNode[];
     repeatedUri: string;
 }
 
@@ -1485,7 +1588,7 @@ declare interface ResourceHierarchyProvider {
     id: string;
     priority?: number;
     canResolve(resource: ResourceRef): boolean;
-    getParent(resource: ResourceRef): ResourceRef | undefined;
+    getParent(resource: ResourceRef): WorkbenchHierarchyNode | undefined;
 }
 
 declare interface ResourceKindContribution {
@@ -1553,7 +1656,7 @@ declare interface ResourceRegistry {
     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>;
@@ -1684,6 +1787,34 @@ export declare const toWorkbenchCompositionPanelContribution: (input: {
     config?: WorkbenchPanelContribution["config"];
 }) => WorkbenchPanelContribution;
 
+export declare const toWorkbenchNavigationTarget: (target: NavigationTarget_2, input?: ToWorkbenchNavigationTargetInput) => NavigationTarget;
+
+export declare interface ToWorkbenchNavigationTargetInput {
+    commandIdOf?(command: Extract<NavigationTarget_2, {
+        kind: "command";
+    }>["target"]["command"]): string | undefined;
+    commandTargetOf?(target: Extract<NavigationTarget_2, {
+        kind: "command";
+    }>): NavigationTargetCommand;
+    extensionId?: string;
+    resourceOf?(resource: Parameters<typeof toWorkbenchResource>[0], target: Extract<NavigationTarget_2, {
+        kind: "resource";
+    }>): ResourceRef;
+    sourcePlacement?: ExtensionNavigationSourcePlacement;
+}
+
+export declare const toWorkbenchNavigationTargetResult: (value: unknown, input?: ToWorkbenchNavigationTargetInput) => NavigationTarget | undefined;
+
+declare const toWorkbenchResource: (resource: NonNullable<CommandExecuteRequest["resource"]>) => ResourceRef;
+
+export declare const toWorkbenchWhenExpression: (when: WorkbenchExtensionMetadata["navigationItems"][number]["when"] | WorkbenchExtensionMetadata["statusBarItems"][number]["when"]) => {
+    mode: string | string[] | undefined;
+    source: any;
+    viewId: string | string[] | undefined;
+    resourceType: any;
+    metadata: any;
+} | undefined;
+
 declare interface TreeAction {
     id: string;
     label?: string;
@@ -1828,6 +1959,11 @@ declare interface TreeViewSection {
     canReorder?: boolean;
 }
 
+declare interface UnresolvedWorkbenchExtensionMenuContribution {
+    contribution: ExtensionMenuContribution_2;
+    targetId: string;
+}
+
 /**
  * Core-owned contracts for kanban renderer contributions. @pstdio/ui's
  * KanbanRenderer props are structurally identical; the React layer bridges the
@@ -1986,6 +2122,7 @@ export declare interface WorkbenchCompositionRegistry {
 
 declare interface WorkbenchCore extends WorkbenchCoreContributionContext {
     host: WorkbenchHost;
+    layout: WorkbenchLayoutModel;
     registerModule(module: WorkbenchModuleContribution): Disposable_2;
     unregisterModule(moduleId: string): void;
 }
@@ -2001,7 +2138,7 @@ declare interface WorkbenchCoreContributionContext {
     history: HistoryController;
     keybindings: KeybindingRegistry;
     lastResource: WorkbenchLastResourceController;
-    layout: WorkbenchLayoutModel;
+    layout: WorkbenchModuleLayoutModel;
     modes: WorkbenchModeRegistry;
     navigation: NavigationRegistry;
     navigator: WorkbenchNavigator;
@@ -2010,7 +2147,10 @@ declare interface WorkbenchCoreContributionContext {
     preferences: PreferenceRegistry;
     renderers: WorkbenchRenderers;
     resources: ResourceRegistry;
+    views: WorkbenchViewRegistry;
     settings: SettingsRegistry;
+    statusBar: WorkbenchStatusBarRegistry;
+    statuses: WorkbenchStatusRegistry;
     shell: WorkbenchShellController;
     sidePanel: WorkbenchSidePanelController;
     terminal: WorkbenchTerminalController;
@@ -2024,6 +2164,7 @@ declare interface WorkbenchCoreContributionContext {
 
 export declare interface WorkbenchExtensionCommandContext {
     executeCommand(commandId: string, body: CommandExecuteRequest): Promise<unknown> | unknown;
+    prepareCommandArgs?(commandId: string, args: unknown, context?: WorkbenchCommandExecutionContext, onArgsChange?: (args: unknown) => void): Promise<unknown> | unknown;
     projectId: string;
     workbench: WorkbenchModuleContext;
 }
@@ -2038,9 +2179,19 @@ export declare interface WorkbenchExtensionCommandPaletteRegistration {
 export declare interface WorkbenchExtensionControlsAdapter {
     /** Supply a fallback resource when the widget placement carries none. */
     resolveResource?: (record: WorkbenchExtensionControlsRendererRecord) => ResourceRef | undefined;
+    resolveViewInput?: WorkbenchExtensionViewInputResolver;
+}
+
+export declare interface WorkbenchExtensionHostMenuRegistration extends Omit<WorkbenchExtensionMenuRegistration, "menuItem" | "menuPath"> {
+    menuItems: Array<{
+        menuItem: MenuItem;
+        menuPath: MenuPath;
+    }>;
 }
 
 export declare interface WorkbenchExtensionKanbanRendererAdapter {
+    /** Add host navigation state changes that must run before a panel view opens. */
+    resolveViewInput?: WorkbenchExtensionViewInputResolver;
     /** Override label resolution. Defaults to workbench's `text(value, fallback)`. */
     resolveLabel?: Localizer;
     /** Post-process an attribute descriptor (after localization). Defaults to identity. */
@@ -2098,7 +2249,7 @@ export declare interface WorkbenchExtensionKanbanRendererAdapter {
 
 export declare interface WorkbenchExtensionMenuRegistration {
     command: Command;
-    contribution: ExtensionMenuContribution;
+    contribution: ExtensionMenuContribution_2;
     menuItem: MenuItem;
     menuPath: MenuPath;
     targetCommandId: string;
@@ -2110,7 +2261,7 @@ export declare interface WorkbenchExtensionMenuSlotConfig {
     overflowLabel?: string;
 }
 
-export declare type WorkbenchExtensionMenuWhenBuilder = (contribution: ExtensionMenuContribution) => string | undefined;
+export declare type WorkbenchExtensionMenuWhenBuilder = (contribution: ExtensionMenuContribution_2) => string | undefined;
 
 export { WorkbenchExtensionMetadata }
 
@@ -2120,13 +2271,15 @@ declare interface WorkbenchExtensionRefreshEvent extends FileRendererRefreshEnve
 
 export declare type WorkbenchExtensionRendererKind = "tree" | "file" | "controls" | "dataTable" | "kanban";
 
-export declare type WorkbenchExtensionRoute = WorkbenchExtensionMetadata["routes"][number];
+declare type WorkbenchExtensionStringResolver = (value: Localizable<string> | undefined, extensionId: string) => string;
 
-export declare interface WorkbenchExtensionRouteResourceInput {
-    route: WorkbenchExtensionRoute;
+declare interface WorkbenchExtensionViewDescriptor {
+    id: string;
+    title: string;
+    icon?: string;
 }
 
-declare type WorkbenchExtensionStringResolver = (value: Localizable<string> | undefined, extensionId: string) => string;
+declare type WorkbenchExtensionViewInputResolver = (view: WorkbenchExtensionViewDescriptor) => WorkbenchViewContribution["resolveInput"];
 
 declare interface WorkbenchFileIconThemeStoreState {
     themes: readonly FileIconThemePreferenceOption[];
@@ -2152,6 +2305,8 @@ declare interface WorkbenchFocusState {
     activeRegion: WorkbenchFocusRegionId | undefined;
 }
 
+declare type WorkbenchHierarchyNode = ResourceRef | WorkbenchViewHierarchyNode;
+
 declare interface WorkbenchHost {
     getSnapshot(): WorkbenchSnapshot;
     restoreSnapshot(snapshot: WorkbenchSnapshot): void;
@@ -2190,11 +2345,16 @@ declare interface WorkbenchLocationEligibility {
     resourceKinds?: string[];
     resourceIds?: string[];
     canOpen?(resource: ResourceRef): boolean;
+    canOpenLocation?(location: {
+        resource?: ResourceRef;
+        viewId?: string;
+    }): boolean;
 }
 
 declare interface WorkbenchLocationRef {
     key: string;
     modeId?: string;
+    viewId?: string;
     resource?: ResourceRef;
     contributionId?: string;
     instanceKey?: string;
@@ -2265,6 +2425,8 @@ declare interface WorkbenchModuleContribution {
 
 declare type WorkbenchModuleContributionContext = WorkbenchModuleContext;
 
+declare type WorkbenchModuleLayoutModel = Omit<WorkbenchLayoutModel, "registerWidget">;
+
 declare interface WorkbenchNavigationCommit {
     modeId: string | undefined;
     resource: ResourceRef | undefined;
@@ -2278,9 +2440,10 @@ declare interface WorkbenchNavigationEntry {
     recordedAt: number;
     location: WorkbenchLocationRef;
     selectedSubPanels: Partial<Record<WorkbenchPanelRegion, WorkbenchSubPanelRef>>;
-    kind: "resource" | "widget" | "mode";
+    kind: "resource" | "view" | "widget" | "mode";
     modeId?: string;
     resource?: ResourceRef;
+    viewId?: string;
     widgetId?: string;
     contributionId?: string;
     title?: string;
@@ -2399,6 +2562,7 @@ declare interface WorkbenchPanelContribution {
 declare interface WorkbenchPanelInstance {
     instanceId: string;
     panelId: string;
+    viewId?: string;
     ownerId?: string;
     source?: ContributionSource;
     resource?: ResourceRef;
@@ -2416,6 +2580,7 @@ declare interface WorkbenchPanelInstance {
 declare interface WorkbenchPanelInstance_2 {
     instanceId: string;
     panelId: string;
+    viewId?: string;
     ownerId?: string;
     source?: ContributionSource_2;
     resource?: ResourceRef_2;
@@ -2620,6 +2785,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;
@@ -2664,6 +2875,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<{
@@ -2682,6 +2894,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[];
@@ -2743,9 +2956,58 @@ declare interface WorkbenchThemeStoreState {
     themes: readonly ThemePreferenceOption[];
 }
 
+declare interface WorkbenchViewContribution {
+    id: string;
+    panelId: string;
+    title?: string;
+    icon?: string;
+    path?: string;
+    pathAliases?: readonly string[];
+    aliases?: readonly string[];
+    resource?: ResourceRef;
+    canResolve?(): boolean;
+    resolveInput?(input: OpenWorkbenchViewInput): OpenWorkbenchPanelInput;
+}
+
+declare interface WorkbenchViewHierarchyNode {
+    type: "view";
+    viewId: string;
+    label?: string;
+    icon?: string;
+}
+
+declare interface WorkbenchViewOpenEvent {
+    viewId: string;
+    input: OpenWorkbenchViewInput;
+    instance: WorkbenchPanelInstance;
+}
+
+declare interface WorkbenchViewRegistry {
+    store: WorkbenchStore<WorkbenchViewRegistryStoreState>;
+    registerView(view: WorkbenchViewContribution, metadata?: ContributionMetadata): Disposable_2;
+    getView(viewId: string): RegisteredWorkbenchView | undefined;
+    listViews(): RegisteredWorkbenchView[];
+    resolveViewId(viewId: string): string | undefined;
+    resolvePath(path: string): {
+        kind: "view";
+        viewId: string;
+    } | undefined;
+    canResolveView(viewId: string): boolean;
+    isOpeningView(): boolean;
+    openView(viewId: string, input?: OpenWorkbenchViewInput): Promise<WorkbenchPanelInstance>;
+    onDidOpenView(listener: (event: WorkbenchViewOpenEvent) => void): Disposable_2;
+}
+
+declare interface WorkbenchViewRegistryStoreState {
+    views: Record<string, RegisteredWorkbenchView>;
+    aliases: Record<string, string>;
+    paths: Record<string, string>;
+}
+
 declare interface WorkbenchWidgetPlacement {
     widgetId: string;
     contributionId: string;
+    viewId?: string;
     ownerId?: string;
     source?: ContributionSource;
     resource?: ResourceRef;
@@ -2775,4 +3037,27 @@ declare interface WorkbenchWidgetTab_2 {
     customMenuRendererId?: string;
 }
 
+declare interface WorkflowStatus {
+    id: string;
+    label: string;
+    color: string;
+    icon?: string | null;
+    sortOrder: number;
+    isDefault?: boolean;
+    board?: WorkflowStatusBoardRules;
+}
+
+declare interface WorkflowStatusAction {
+    id: string;
+    label: string;
+    icon?: string;
+}
+
+declare interface WorkflowStatusBoardRules {
+    canCreate?: boolean;
+    canDragIn?: boolean;
+    canDragOut?: boolean;
+    actions?: readonly string[];
+}
+
 export { }