@pstdio/workbench 0.5.0 → 0.7.0

package/dist/file-section-navigation-CfYqVObc.js

@@ -0,0 +1,30 @@
+const c = "pstdio.fileSectionNavigation", i = (t) => {
+  if (!t || typeof t != "object") return !1;
+  const e = t, r = e.occurrence === void 0 || typeof e.occurrence == "number" && Number.isInteger(e.occurrence) && e.occurrence >= 0;
+  return typeof e.id == "string" && typeof e.heading == "string" && r;
+}, s = (t) => {
+  const e = t?.metadata?.[c];
+  if (!e || typeof e != "object") return;
+  const r = e;
+  if (!(typeof r.treeId != "string" || typeof r.targetNodeId != "string") && !(!Array.isArray(r.anchors) || !r.anchors.every(i)))
+    return {
+      treeId: r.treeId,
+      targetNodeId: r.targetNodeId,
+      anchors: r.anchors
+    };
+}, a = (t, e) => e && t.anchors.some((r) => r.id === e) ? e : t.targetNodeId, d = (t) => {
+  const {
+    previous: e,
+    current: r,
+    currentResourceUri: n,
+    selectedNodeId: o
+  } = t;
+  return !e || !o || !e.anchorIds.includes(o) || r?.targetNodeId === o ? !1 : !r || e.treeId !== r.treeId || e.resourceUri !== n;
+};
+export {
+  c as F,
+  s as g,
+  a as r,
+  d as s
+};
+//# sourceMappingURL=file-section-navigation-CfYqVObc.js.map

package/dist/file-section-navigation-CfYqVObc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-section-navigation-CfYqVObc.js","sources":["../src/core/registries/renderers/file-section-navigation.ts"],"sourcesContent":["import type { ResourceRef } from \"../resources/resource-registry\";\n\nexport const FILE_SECTION_NAVIGATION_METADATA_KEY = \"pstdio.fileSectionNavigation\";\n\nexport interface FileSectionAnchor {\n  id: string;\n  heading: string;\n  occurrence?: number;\n}\n\nexport interface FileSectionNavigation {\n  treeId: string;\n  targetNodeId: string;\n  anchors: FileSectionAnchor[];\n}\n\nconst isAnchor = (value: unknown): value is FileSectionAnchor => {\n  if (!value || typeof value !== \"object\") return false;\n  const anchor = value as Record<string, unknown>;\n  const occurrenceIsValid =\n    anchor.occurrence === undefined ||\n    (typeof anchor.occurrence === \"number\" && Number.isInteger(anchor.occurrence) && anchor.occurrence >= 0);\n  return typeof anchor.id === \"string\" && typeof anchor.heading === \"string\" && occurrenceIsValid;\n};\n\nexport const getFileSectionNavigation = (resource: ResourceRef | undefined): FileSectionNavigation | undefined => {\n  const value = resource?.metadata?.[FILE_SECTION_NAVIGATION_METADATA_KEY];\n  if (!value || typeof value !== \"object\") return undefined;\n  const navigation = value as Record<string, unknown>;\n  if (typeof navigation.treeId !== \"string\" || typeof navigation.targetNodeId !== \"string\") return undefined;\n  if (!Array.isArray(navigation.anchors) || !navigation.anchors.every(isAnchor)) return undefined;\n\n  return {\n    treeId: navigation.treeId,\n    targetNodeId: navigation.targetNodeId,\n    anchors: navigation.anchors,\n  };\n};\n\nexport const resolveFileSectionTargetId = (navigation: FileSectionNavigation, selectedNodeId: string | undefined) => {\n  if (selectedNodeId && navigation.anchors.some((anchor) => anchor.id === selectedNodeId)) return selectedNodeId;\n  return navigation.targetNodeId;\n};\n\nexport interface PreviousFileSectionNavigation {\n  resourceUri?: string;\n  treeId: string;\n  anchorIds: string[];\n}\n\nexport const shouldClearFileSectionSelection = (input: {\n  previous: PreviousFileSectionNavigation | null;\n  current: FileSectionNavigation | undefined;\n  currentResourceUri?: string;\n  selectedNodeId?: string;\n}) => {\n  const { previous, current, currentResourceUri, selectedNodeId } = input;\n  if (!previous || !selectedNodeId || !previous.anchorIds.includes(selectedNodeId)) return false;\n  if (current?.targetNodeId === selectedNodeId) return false;\n\n  return !current || previous.treeId !== current.treeId || previous.resourceUri !== currentResourceUri;\n};\n"],"names":["FILE_SECTION_NAVIGATION_METADATA_KEY","isAnchor","value","anchor","occurrenceIsValid","occurrence","undefined","Number","isInteger","id","heading","getFileSectionNavigation","resource","metadata","navigation","treeId","targetNodeId","Array","isArray","anchors","every","resolveFileSectionTargetId","selectedNodeId","some","shouldClearFileSectionSelection","input","previous","current","currentResourceUri","anchorIds","includes","resourceUri"],"mappings":"AAEO,MAAMA,IAAuC,gCAc9CC,IAAWA,CAACC,MAA+C;AAC/D,MAAI,CAACA,KAAS,OAAOA,KAAU,SAAU,QAAO;AAChD,QAAMC,IAASD,GACTE,IACJD,EAAOE,eAAeC,UACrB,OAAOH,EAAOE,cAAe,YAAYE,OAAOC,UAAUL,EAAOE,UAAU,KAAKF,EAAOE,cAAc;AACxG,SAAO,OAAOF,EAAOM,MAAO,YAAY,OAAON,EAAOO,WAAY,YAAYN;AAChF,GAEaO,IAA2BA,CAACC,MAAyE;AAChH,QAAMV,IAAQU,GAAUC,WAAWb,CAAoC;AACvE,MAAI,CAACE,KAAS,OAAOA,KAAU,SAAU;AACzC,QAAMY,IAAaZ;AACnB,MAAI,SAAOY,EAAWC,UAAW,YAAY,OAAOD,EAAWE,gBAAiB,aAC5E,GAACC,MAAMC,QAAQJ,EAAWK,OAAO,KAAK,CAACL,EAAWK,QAAQC,MAAMnB,CAAQ;AAE5E,WAAO;AAAA,MACLc,QAAQD,EAAWC;AAAAA,MACnBC,cAAcF,EAAWE;AAAAA,MACzBG,SAASL,EAAWK;AAAAA,IAAAA;AAExB,GAEaE,IAA6BA,CAACP,GAAmCQ,MACxEA,KAAkBR,EAAWK,QAAQI,KAAMpB,OAAWA,EAAOM,OAAOa,CAAc,IAAUA,IACzFR,EAAWE,cASPQ,IAAkCA,CAACC,MAK1C;AACJ,QAAM;AAAA,IAAEC,UAAAA;AAAAA,IAAUC,SAAAA;AAAAA,IAASC,oBAAAA;AAAAA,IAAoBN,gBAAAA;AAAAA,EAAAA,IAAmBG;AAElE,SADI,CAACC,KAAY,CAACJ,KAAkB,CAACI,EAASG,UAAUC,SAASR,CAAc,KAC3EK,GAASX,iBAAiBM,IAAuB,KAE9C,CAACK,KAAWD,EAASX,WAAWY,EAAQZ,UAAUW,EAASK,gBAAgBH;AACpF;"}

package/dist/index.d.ts

@@ -93,6 +93,7 @@ export declare interface Command {
 }
 
 export 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>;
     isEnabled?(args: TArgs): boolean;
     isVisible?(args: TArgs): boolean;
@@ -149,6 +150,8 @@ export declare interface CommandParamDescriptor {
     options?: CommandParamOption[];
     templateType?: string;
     resourceType?: string;
+    accept?: string;
+    multiple?: boolean;
     metadata?: Record<string, unknown>;
 }
 
@@ -168,6 +171,7 @@ export declare interface CommandRegistry {
     isCommandEnabled(id: string, args?: unknown): boolean;
     isCommandVisible(id: string, args?: unknown): boolean;
     isCommandToggled(id: string, args?: unknown): boolean;
+    prepareCommandArgs(id: string, args: unknown, context?: WorkbenchCommandExecutionContext, onArgsChange?: (args: unknown) => void): Promise<unknown>;
     executeCommand(id: string, args?: unknown, context?: WorkbenchCommandExecutionContext): Promise<unknown>;
     onDidExecuteError(listener: WorkbenchCommandExecutionErrorListener): Disposable_2;
 }
@@ -176,6 +180,70 @@ declare interface CommandRegistryStoreState {
     commands: Record<string, RegisteredCommand>;
 }
 
+export declare interface CompositionDiagnostic {
+    code: "extension_resource_kind_missing" | "extension_resource_slot_missing" | "extension_resource_slot_closed" | "extension_panel_missing" | "extension_panel_placement_unresolvable" | "extension_mode_resource_unsupported" | "extension_placement_required_invalid" | "extension_resource_primary_invalid";
+    message: string;
+    panelId?: string;
+    slot?: string;
+}
+
+export declare interface CompositionModeDefinition {
+    id: string;
+    extensionId?: string;
+    resources?: Record<string, CompositionModeRecipe>;
+    modePanels?: Record<string, CompositionPlacementPolicy>;
+}
+
+export declare interface CompositionModeRecipe {
+    slots?: Record<string, CompositionPlacementPolicy>;
+    panels?: Record<string, CompositionPlacementPolicy>;
+}
+
+export declare interface CompositionPanelDefinition {
+    id: string;
+    extensionId: string;
+    title: string;
+    icon?: string;
+    show?: CompositionPanelPlacement | readonly CompositionPanelPlacement[];
+}
+
+declare interface CompositionPanelPlacement extends CompositionPlacementPolicy {
+    resourceKind?: string;
+}
+
+export declare interface CompositionPlacementPolicy {
+    region: DockedCompositionRegion;
+    allowedRegions?: readonly DockedCompositionRegion[];
+    required?: boolean;
+    defaultOpen?: boolean;
+    pinned?: boolean;
+}
+
+declare interface CompositionResolutionContext {
+    modeId: string;
+    resourceKind?: string;
+}
+
+export declare interface CompositionResourceKindDefinition {
+    id: string;
+    extensionId: string;
+    surface: "primary" | "secondary" | "attached";
+    slots: Record<string, CompositionSlotDefinition>;
+}
+
+export declare interface CompositionResourcePanelEdge {
+    id: string;
+    extensionId: string;
+    resourceKind: string;
+    panel: string;
+    slot: string;
+}
+
+export declare interface CompositionSlotDefinition {
+    cardinality: "one" | "many";
+    external: boolean;
+}
+
 export declare interface ContextKeyScope extends Disposable_2 {
     ownerId: string;
     set(key: string, value: ContextKeyValue): void;
@@ -373,7 +441,7 @@ export declare interface DataTableRendererContribution {
     emptyDescription?: string;
     executeQuery(context: DataTableRendererQueryContext): Promise<DataTableRendererQueryResult> | DataTableRendererQueryResult;
     subscribe?: (listener: () => void) => Disposable_2 | (() => void);
-    onRowClick?: (row: DataTableRendererRow) => void;
+    onRowActivate?: (row: DataTableRendererRow) => Promise<void> | void;
 }
 
 export declare type DataTableRendererImplementation = (input: WorkbenchPanelRenderInput & {
@@ -444,6 +512,10 @@ declare interface Disposable_2 {
 }
 export { Disposable_2 as Disposable }
 
+export declare type DockedCompositionRegion = (typeof dockedCompositionRegions)[number];
+
+export declare const dockedCompositionRegions: readonly ["sidenav", "main", "secondary", "side"];
+
 export declare interface EnumOption {
     value: string;
     label: string;
@@ -499,10 +571,23 @@ export declare interface FileIconThemeRegistry {
 
 export declare interface FileRendererContent {
     fileName?: string;
+    /** Workspace-relative path shown above the file preview. */
+    filePath?: string;
     mimeType?: string;
     content?: string;
     dataUrl?: string;
     placeholder?: string;
+    /** Override contribution-level save support for one loaded file. */
+    editable?: boolean;
+    /** Request Monaco for text that automatic dispatch would open as markdown. */
+    textRenderer?: "automatic" | "monaco";
+    /** Represent a deliberate no-file selection without an editable blank document. */
+    emptyState?: {
+        title: string;
+        description?: string;
+    };
+    /** Ordered backing-store revision when one is available. */
+    revision?: string;
 }
 
 export declare interface FileRendererContribution {
@@ -512,35 +597,53 @@ export declare interface FileRendererContribution {
     /** Resolve the file's content (and identity) for the bound resource. */
     load(resource: ResourceRef | undefined): Promise<FileRendererContent> | FileRendererContent;
     /** Persist edited text. Absent ⇒ read-only. Never called for images. */
-    save?(resource: ResourceRef | undefined, content: string): Promise<void> | void;
+    save?(resource: ResourceRef | undefined, content: string, origin?: FileRendererRefreshOrigin): Promise<FileRendererSaveResult | undefined> | FileRendererSaveResult | void;
 }
 
 export declare type FileRendererImplementation = (input: WorkbenchPanelRenderInput & {
     fileRendererId: string;
 }) => unknown;
 
-declare interface FileRendererRefreshEvent {
+export declare interface FileRendererRefreshEnvelope {
+    resourceUri?: string;
+    origin?: FileRendererRefreshOrigin;
+    revision?: string;
+}
+
+export declare interface FileRendererRefreshEvent extends FileRendererRefreshEnvelope {
     fileRendererId: string;
 }
 
 declare type FileRendererRefreshListener = (event: FileRendererRefreshEvent) => void;
 
+export declare interface FileRendererRefreshOrigin {
+    rendererId: string;
+    instanceId: string;
+    operationId: string;
+}
+
 export 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): void;
+    refreshFileRenderer(id: string, event?: FileRendererRefreshEnvelope): void;
     onDidRefreshFileRenderer(listener: FileRendererRefreshListener): Disposable_2;
 }
 
+export declare interface FileRendererSaveResult {
+    revision?: string;
+}
+
 declare interface FileRendererStoreState {
     renderers: Record<string, RegisteredFileRendererContribution>;
 }
 
 export declare const getKeybindingSteps: (keybinding: KeybindingSequence) => string[];
 
+export declare const getSwitchModeNavigationTargetModeId: (target: NavigationTarget) => string | undefined;
+
 export declare const getWorkbenchModePanelForRegion: (region: WorkbenchRegion) => "main" | "secondary" | "side" | undefined;
 
 export declare const getWorkbenchSelectionResourceUris: (resource: ResourceRef | undefined) => string[];
@@ -551,6 +654,8 @@ export declare const headerTrailingMenuPath: (region: string) => MenuPath;
 
 export 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;
@@ -578,6 +683,8 @@ export declare interface KanbanRendererContribution<TRow extends KanbanRendererR
     id: string;
     title: string;
     resourceKind?: string;
+    /** Host-owned scope for persisted display settings. */
+    storageScope?: string;
     /**
      * Declarative attribute schema. The renderer dispatches filter / group /
      * sort / display / inline-edit behavior on each descriptor's `type.kind`.
@@ -605,8 +712,8 @@ export declare interface KanbanRendererContribution<TRow extends KanbanRendererR
      */
     executeQuery(state: KanbanRendererQueryState): Promise<TRow[]> | TRow[];
     subscribe?: (listener: () => void) => Disposable_2 | (() => void);
-    /** Row interactions surfaced by the renderer (mirrored from <KanbanRenderer>). */
-    onRowClick?: (row: TRow) => void;
+    /** 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[];
     /**
@@ -700,7 +807,7 @@ export declare interface KanbanRendererRow {
     title: string;
     /**
      * Optional navigation handle. When set, the renderer's default click handler
-     * routes through the contribution's onRowClick (which typically opens the
+     * routes through the contribution's onRowActivate (which typically opens the
      * resource via the workbench).
      */
     resource?: unknown;
@@ -810,6 +917,16 @@ declare interface LayoutModel {
         carryRegionState?: readonly WorkbenchRegion[];
     }): void;
     getPersistenceScope(): LayoutScope | undefined;
+    /** True when the current persistence scope already stores a layout. A new scope returns false. */
+    /** Whether anything is stored for the active scope right now. */
+    hasPersistedLayout(): boolean;
+    /**
+     * Whether the active scope was entered with a layout the user already had. Unlike
+     * `hasPersistedLayout`, writes made while entering a mode do not change the answer.
+     */
+    enteredWithPersistedLayout(): boolean;
+    /** Moves owned panel menus beside their owner's current region and removes orphan menus. */
+    reconcilePanelMenus(): void;
     onWillChangePersistenceScope(listener: (scope: LayoutScope | undefined) => void): {
         dispose(): void;
     };
@@ -946,6 +1063,7 @@ declare interface OpenWidgetInput {
     resource?: ResourceRef;
     title?: string;
     region?: WorkbenchRegion;
+    role?: WorkbenchWidgetRole;
     ownerId?: string;
     source?: ContributionSource;
     pinned?: boolean;
@@ -963,13 +1081,24 @@ export declare interface OpenWorkbenchPanelInput {
     resource?: ResourceRef;
     title?: string;
     region?: WorkbenchRegion;
+    role?: WorkbenchWidgetRole;
     pinned?: boolean;
+    closable?: boolean;
     mountStrategy?: WorkbenchPanelMountStrategy;
     hiddenByDefault?: boolean;
     tab?: WorkbenchPanelTab;
     strategy?: WorkbenchPanelOpenStrategy;
 }
 
+export declare interface PersistedCompositionLayout {
+    regions: Partial<Record<DockedCompositionRegion, PersistedCompositionRegionState>>;
+}
+
+declare interface PersistedCompositionRegionState {
+    order: readonly string[];
+    activePanelId?: string;
+}
+
 export declare interface PersistedTreeRendererStates {
     statesByTreeId: Record<string, TreeRendererState>;
 }
@@ -1092,7 +1221,6 @@ declare type RegisteredWidgetContribution = Omit<WidgetContribution, "priority"
     ownedPanelMenuIds?: readonly string[];
     singleton: boolean;
     reuse: WidgetReusePolicy;
-    role: WorkbenchWidgetRole;
 } & RegisteredContributionMetadata;
 
 declare interface RegisteredWorkbenchNotification extends RegisteredContributionMetadata {
@@ -1108,9 +1236,49 @@ declare interface RegisteredWorkbenchNotification extends RegisteredContribution
 
 export declare const resolveAnchorRegion: (anchorId: AnchorId) => "status" | "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" | "overlay";
 
+export declare const resolveComposition: (input: ResolveCompositionInput) => ResolvedComposition;
+
+declare interface ResolveCompositionInput {
+    context: CompositionResolutionContext;
+    mode: CompositionModeDefinition;
+    composition: WorkbenchComposition;
+    persisted?: PersistedCompositionLayout;
+}
+
+export declare interface ResolvedComposition {
+    placements: readonly ResolvedCompositionPlacement[];
+    regionOrder: Partial<Record<DockedCompositionRegion, readonly string[]>>;
+    activePanelIds: Partial<Record<DockedCompositionRegion, string>>;
+    addablePanels: readonly ResolvedCompositionAddablePanel[];
+    diagnostics: readonly CompositionDiagnostic[];
+    requiredFallback?: {
+        panelId: string;
+    };
+}
+
+export declare interface ResolvedCompositionAddablePanel {
+    panelId: string;
+    region: DockedCompositionRegion;
+    allowedRegions: readonly DockedCompositionRegion[];
+    pinned?: boolean;
+}
+
+export declare interface ResolvedCompositionPlacement {
+    panelId: string;
+    region: DockedCompositionRegion;
+    slot?: string;
+    required: boolean;
+    defaultOpen: boolean;
+    pinned?: boolean;
+    allowedRegions: readonly DockedCompositionRegion[];
+    origin: "persisted" | "required" | "default";
+}
+
 declare type ResolvedResourceHierarchyProvider = Required<ResourceHierarchyProvider>;
 
-declare type ResolvedResourcePresenter = Required<ResourcePresenter>;
+declare type ResolvedResourcePresenter = Omit<ResourcePresenter, "priority"> & {
+    priority: number;
+};
 
 export declare interface ResourceBrowseEntry {
     resource: ResourceRef;
@@ -1134,6 +1302,14 @@ export declare interface ResourceContextAction {
 
 export declare const resourceContextMenuPath: (resourceKind: string) => MenuPath;
 
+export declare interface ResourceHierarchyCycle {
+    code: typeof resourceHierarchyCycleCode;
+    path: ResourceRef[];
+    repeatedUri: string;
+}
+
+export declare const resourceHierarchyCycleCode = "resource_hierarchy_cycle";
+
 export declare interface ResourceHierarchyProvider {
     id: string;
     priority?: number;
@@ -1166,6 +1342,7 @@ export declare interface ResourcePresenter {
     priority?: number;
     canOpen(resource: ResourceRef): boolean;
     open(resource: ResourceRef, input: OpenResourceInput): WorkbenchPanelInstance | Promise<WorkbenchPanelInstance>;
+    afterOpen?(resource: ResourceRef, instance: WorkbenchPanelInstance, input: OpenResourceInput): void;
 }
 
 export declare interface ResourceProvider {
@@ -1197,6 +1374,7 @@ export declare interface ResourceRegistry {
     registerHierarchyProvider(provider: ResourceHierarchyProvider): Disposable_2;
     listHierarchyProviders(): ResolvedResourceHierarchyProvider[];
     walkHierarchy(resource: ResourceRef | undefined): ResourceRef[];
+    onDidDetectHierarchyCycle(listener: (cycle: ResourceHierarchyCycle) => void): Disposable_2;
     isOpeningResource(): boolean;
     openResource(resource: ResourceRef, input?: OpenResourceInput): Promise<WorkbenchPanelInstance>;
     onDidOpenResource(listener: (resource: ResourceRef) => void): Disposable_2;
@@ -1356,11 +1534,13 @@ export declare interface TreeNode {
     target?: NavigationTarget;
     /** Visual row variant for non-data rows such as placeholders. */
     rowVariant?: TreeNodeRowVariant;
+    inlineInput?: TreeNodeInlineInput;
     actions?: TreeAction[];
     contextMenuActions?: TreeAction[];
     contextMenuPath?: MenuPath;
     menuPath?: MenuPath;
     menuPlacement?: "top-start" | "top-end" | "bottom-start" | "bottom-end" | "right-start" | "left-start";
+    showContextMenuTrigger?: boolean;
     collapsible?: boolean;
     disabled?: boolean;
     children?: TreeNode[];
@@ -1371,6 +1551,18 @@ export declare interface TreeNode {
     canHide?: boolean;
     /** When false, the node stays fixed within its Sidenav group. */
     canReorder?: boolean;
+    /** Allow this node to be moved to another tree location. */
+    canDrag?: boolean;
+    /** Allow movable nodes to be dropped on this node. */
+    canDrop?: boolean;
+}
+
+export declare interface TreeNodeInlineInput {
+    ariaLabel: string;
+    defaultValue?: string;
+    placeholder?: string;
+    onCommit(value: string): Promise<void> | void;
+    onCancel?(): void;
 }
 
 declare type TreeNodeRowVariant = "empty-state";
@@ -1379,6 +1571,8 @@ export declare interface TreeRendererContribution {
     id: string;
     title: string;
     icon?: string;
+    searchable?: boolean;
+    searchPlaceholder?: string;
     when?: string;
     defaultExpandedSectionIds?: string[];
     defaultExpandedNodeIds?: string[];
@@ -1386,6 +1580,7 @@ export declare interface TreeRendererContribution {
     getHeader?(ctx: TreeContext): Promise<TreeNode[]> | TreeNode[];
     getFooter?(ctx: TreeContext): Promise<TreeNode[]> | TreeNode[];
     getChildren(node: TreeNode, ctx: TreeContext): Promise<TreeNode[]> | TreeNode[];
+    moveNode?(source: TreeNode, target: TreeNode | undefined, ctx: TreeContext): Promise<void> | void;
 }
 
 export declare type TreeRendererImplementation = (input: WorkbenchPanelRenderInput & {
@@ -1483,7 +1678,6 @@ declare interface WidgetContribution {
     priority?: number;
     rendererId: string;
     openCommandId?: string;
-    role?: WorkbenchWidgetRole;
     eligibleLocations?: WorkbenchLocationEligibility;
     panelMenuOwner?: WorkbenchPanelMenuOwner;
     tab?: WorkbenchWidgetTab;
@@ -1583,6 +1777,26 @@ declare interface WorkbenchCommandParamsRequest {
     context?: WorkbenchCommandExecutionContext;
 }
 
+export declare interface WorkbenchComposition {
+    resourceKinds: readonly CompositionResourceKindDefinition[];
+    panels: readonly CompositionPanelDefinition[];
+    resourcePanels: readonly CompositionResourcePanelEdge[];
+}
+
+declare interface WorkbenchCompositionAddablePanel extends WorkbenchModeAddablePanel {
+    contribution: RegisteredWidgetContribution;
+}
+
+declare interface WorkbenchCompositionController {
+    panelsFor(region: WorkbenchPanelRegion): WorkbenchCompositionRegionPanels;
+}
+
+declare interface WorkbenchCompositionRegionPanels {
+    open: readonly WorkbenchWidgetPlacement[];
+    addable: readonly WorkbenchCompositionAddablePanel[];
+    closable: readonly string[];
+}
+
 export declare interface WorkbenchCore extends WorkbenchCoreContributionContext {
     host: WorkbenchHost;
     registerModule(module: WorkbenchModuleContribution): Disposable_2;
@@ -1594,6 +1808,7 @@ declare interface WorkbenchCoreContributionContext {
     commandPalette: WorkbenchCommandPaletteController;
     commandPaletteResources: CommandPaletteResourceRegistry;
     commands: CommandRegistry;
+    composition: WorkbenchCompositionController;
     context: ContextKeyService;
     focus: WorkbenchFocusController;
     history: HistoryController;
@@ -1602,6 +1817,7 @@ declare interface WorkbenchCoreContributionContext {
     layout: WorkbenchLayoutModel;
     modes: WorkbenchModeRegistry;
     navigation: NavigationRegistry;
+    navigator: WorkbenchNavigator;
     notifications: NotificationRegistry;
     panels: WorkbenchPanelsController;
     preferences: PreferenceRegistry;
@@ -1679,7 +1895,7 @@ declare interface WorkbenchLayoutStoreState {
     placeholders: Partial<Record<WorkbenchRegion, RegisteredPlaceholderContribution>>;
 }
 
-declare type WorkbenchLocationContribution = Omit<WidgetContribution, "role"> & WorkbenchPanelMenusContribution;
+declare type WorkbenchLocationContribution = WidgetContribution & WorkbenchPanelMenusContribution;
 
 export declare interface WorkbenchLocationEligibility {
     modeIds?: string[];
@@ -1701,15 +1917,31 @@ export declare type WorkbenchModeActivationContext = WorkbenchCoreContributionCo
 
 export declare type WorkbenchModeActivationResult = Disposable_2 | readonly Disposable_2[] | undefined;
 
+export declare interface WorkbenchModeAddablePanel {
+    panelId: string;
+    region: WorkbenchPanelRegion;
+    allowedRegions?: readonly WorkbenchRegion[];
+    pinned?: boolean;
+}
+
+export declare interface WorkbenchModeAddablePanelContext {
+    layout: WorkbenchLayout;
+    resource?: ResourceRef;
+}
+
 declare type WorkbenchModeChangeListener = () => void;
 
 export declare interface WorkbenchModeContribution {
     id: string;
     label?: string;
     panels?: readonly WorkbenchPanelRegion[];
+    resourceKinds?: readonly string[];
+    defaultResource?: ResourceRef | (() => Promise<ResourceRef | undefined> | ResourceRef | undefined);
+    listAddablePanels?(context: WorkbenchModeAddablePanelContext): readonly WorkbenchModeAddablePanel[];
     activate(ctx: WorkbenchModeActivationContext): WorkbenchModeActivationResult;
     seed?(ctx: WorkbenchModeActivationContext): void;
     enter?(ctx: WorkbenchModeActivationContext): WorkbenchModeActivationResult;
+    reconcile?(ctx: WorkbenchModeActivationContext): void;
 }
 
 export declare interface WorkbenchModeRegistry {
@@ -1745,6 +1977,14 @@ export declare interface WorkbenchModuleContribution {
 
 export declare type WorkbenchModuleContributionContext = WorkbenchModuleContext;
 
+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;
@@ -1759,6 +1999,53 @@ declare interface WorkbenchNavigationEntry {
     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;
+}
+
 export declare interface WorkbenchNotification {
     id?: string;
     level: WorkbenchNotificationLevel;
@@ -1800,7 +2087,6 @@ export declare interface WorkbenchPanelContribution {
     region: WorkbenchRegion;
     fallbackRegion?: WorkbenchRegion;
     rendererId: string;
-    closable: boolean;
     singleton?: boolean;
     reuse?: WorkbenchPanelReusePolicy;
     mountStrategy?: WorkbenchPanelMountStrategy;
@@ -1839,7 +2125,7 @@ export declare interface WorkbenchPanelInstance {
     tab?: WorkbenchPanelTab;
 }
 
-declare type WorkbenchPanelMenuContribution = Omit<WidgetContribution, "region" | "fallbackRegion" | "role"> & {
+declare type WorkbenchPanelMenuContribution = Omit<WidgetContribution, "region" | "fallbackRegion"> & {
     region: WorkbenchPanelMenuRegion;
     fallbackRegion?: WorkbenchPanelMenuRegion;
 };
@@ -1908,9 +2194,9 @@ export declare type WorkbenchPanelOpenStrategy = {
     position?: WorkbenchTabPosition;
 };
 
-declare type WorkbenchPanelRegion = (typeof workbenchPanelRegions)[number];
+export declare type WorkbenchPanelRegion = (typeof workbenchPanelRegions)[number];
 
-declare const workbenchPanelRegions: readonly ["main", "secondary", "side"];
+export declare const workbenchPanelRegions: readonly ["main", "secondary", "side"];
 
 export declare interface WorkbenchPanelRenderInput {
     workbench: WorkbenchCore;
@@ -1953,7 +2239,7 @@ export declare interface WorkbenchPersistenceAdapter {
 
 export declare type WorkbenchRegion = (typeof workbenchRegions)[number];
 
-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"];
+export 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"];
 
 export declare interface WorkbenchRegionSize {
     defaultPx?: number;
@@ -2070,7 +2356,7 @@ declare type WorkbenchStoreSelector<TState, TValue> = (state: TState) => TValue;
 
 declare type WorkbenchStoreSelectorListener<TValue> = (value: TValue, previousValue: TValue) => void;
 
-declare type WorkbenchSubPanelContribution = Omit<WidgetContribution, "region" | "fallbackRegion" | "role"> & {
+declare type WorkbenchSubPanelContribution = Omit<WidgetContribution, "region" | "fallbackRegion"> & {
     region: WorkbenchPanelRegion;
     fallbackRegion?: WorkbenchPanelRegion;
 } & WorkbenchPanelMenusContribution;
@@ -2081,6 +2367,8 @@ declare interface WorkbenchSubPanelRef {
     instanceKey?: string;
 }
 
+export declare const workbenchSwitchModeCommandId = "workbench.action.switchMode";
+
 export declare type WorkbenchTabPosition = "start" | "end" | {
     beforeWidgetId: string;
 } | {