@pstdio/workbench 0.4.0 → 0.6.0

package/dist/layout-types-DMoZz38-.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout-types-DMoZz38-.js","sources":["../src/core/registries/layout/widget-id.ts","../src/core/registries/layout/layout-types.ts"],"sourcesContent":["export const resolveUniqueWidgetId = (\n  widgetIds: ReadonlySet<string>,\n  contributionId: string,\n  preferredId = contributionId,\n) => {\n  if (!widgetIds.has(preferredId)) return preferredId;\n\n  let suffix = 1;\n  while (widgetIds.has(`${contributionId}:${suffix}`)) suffix += 1;\n  return `${contributionId}:${suffix}`;\n};\n","import type { ContributionSource, RegisteredContributionMetadata } from \"../../shared/contributions/metadata\";\nimport type { ResourceRef } from \"../resources/resource-registry\";\nimport { resolveUniqueWidgetId } from \"./widget-id\";\n\nexport const workbenchRegions = [\n  \"nav\",\n  \"activity\",\n  \"sidenav-header\",\n  \"sidenav\",\n  \"main-header\",\n  \"main-left-menu\",\n  \"main\",\n  \"main-right-menu\",\n  \"secondary-header\",\n  \"secondary-left-menu\",\n  \"secondary\",\n  \"secondary-right-menu\",\n  \"side-header\",\n  \"side-left-menu\",\n  \"side\",\n  \"side-right-menu\",\n  \"status\",\n  \"overlay\",\n] as const;\n\nexport type WorkbenchRegion = (typeof workbenchRegions)[number];\n\nexport const workbenchPanelRegions = [\"main\", \"secondary\", \"side\"] as const satisfies readonly WorkbenchRegion[];\n\nexport type WorkbenchPanelRegion = (typeof workbenchPanelRegions)[number];\n\nexport type WorkbenchPanelMenuSide = \"left\" | \"right\";\n\nexport const workbenchPanelMenuRegions = {\n  main: { left: \"main-left-menu\", right: \"main-right-menu\" },\n  secondary: { left: \"secondary-left-menu\", right: \"secondary-right-menu\" },\n  side: { left: \"side-left-menu\", right: \"side-right-menu\" },\n} as const satisfies Record<WorkbenchPanelRegion, Record<WorkbenchPanelMenuSide, WorkbenchRegion>>;\n\nexport type WorkbenchPanelMenuRegion = (typeof workbenchPanelMenuRegions)[WorkbenchPanelRegion][WorkbenchPanelMenuSide];\n\nconst workbenchPanelByMenuRegion = {\n  \"main-left-menu\": \"main\",\n  \"main-right-menu\": \"main\",\n  \"secondary-left-menu\": \"secondary\",\n  \"secondary-right-menu\": \"secondary\",\n  \"side-left-menu\": \"side\",\n  \"side-right-menu\": \"side\",\n} as const satisfies Record<WorkbenchPanelMenuRegion, WorkbenchPanelRegion>;\n\nexport const getWorkbenchPanelForMenuRegion = (region: WorkbenchPanelMenuRegion) => workbenchPanelByMenuRegion[region];\n\nexport interface WorkbenchRegionSize {\n  defaultPx?: number;\n  minPx?: number;\n  maxPx?: number;\n}\n\nexport type WidgetReusePolicy = \"resource\" | \"none\";\n\nexport type WidgetMountStrategy = \"active\" | \"keep-mounted\";\n\nexport type WorkbenchPanelReusePolicy = WidgetReusePolicy;\n\nexport type WorkbenchPanelMountStrategy = WidgetMountStrategy;\n\nexport type WorkbenchFloatingPanelVisibility = \"visible\" | \"hidden\";\n\nexport type WorkbenchWidgetRole = \"content\" | \"location\" | \"sub-panel\" | \"panel-menu\";\n\nexport type WorkbenchTabRetention = \"preview\" | \"persistent\";\n\nexport type WorkbenchTabPosition = \"start\" | \"end\" | { beforeWidgetId: string } | { afterWidgetId: string };\n\nexport interface WorkbenchLocationEligibility {\n  modeIds?: string[];\n  resourceKinds?: string[];\n  resourceIds?: string[];\n  canOpen?(resource: ResourceRef): boolean;\n}\n\nexport type WorkbenchPanelMenuOwner =\n  | { level: \"panel\"; contributionId?: string }\n  | { level: \"sub-panel\"; contributionId: string };\n\nexport interface WorkbenchWidgetTab {\n  contentRendererId?: string;\n  /** Custom actions shown when the user activates an already-active tab. */\n  customMenuRendererId?: string;\n}\n\nexport type WorkbenchPanelTab = WorkbenchWidgetTab;\n\nexport interface WidgetContribution {\n  id: string;\n  title: string;\n  icon?: string;\n  region: WorkbenchRegion;\n  fallbackRegion?: WorkbenchRegion;\n  singleton?: boolean;\n  reuse?: WidgetReusePolicy;\n  mountStrategy?: WidgetMountStrategy;\n  closable?: boolean;\n  // Non-closeable widgets opt into the tab visibility menu; closeable widgets\n  // ignore this and use the X button for dismissal.\n  hiddenByDefault?: boolean;\n  regionSize?: WorkbenchRegionSize;\n  regionCollapsible?: boolean;\n  headerBorderBottom?: boolean;\n  floatingPanels?: WorkbenchFloatingPanelVisibility;\n  resourceKinds?: string[];\n  priority?: number;\n  rendererId: string;\n  openCommandId?: string;\n  role?: WorkbenchWidgetRole;\n  eligibleLocations?: WorkbenchLocationEligibility;\n  panelMenuOwner?: WorkbenchPanelMenuOwner;\n  tab?: WorkbenchWidgetTab;\n  config?: unknown;\n  canOpen?(resource: ResourceRef): boolean;\n}\n\nexport interface WorkbenchPanelMenuDefinition {\n  id: string;\n  title: string;\n  icon?: string;\n  side: WorkbenchPanelMenuSide;\n  singleton?: boolean;\n  reuse?: WorkbenchPanelReusePolicy;\n  mountStrategy?: WorkbenchPanelMountStrategy;\n  hiddenByDefault?: boolean;\n  regionSize?: WorkbenchRegionSize;\n  regionCollapsible?: boolean;\n  headerBorderBottom?: boolean;\n  rendererId: string;\n  priority?: number;\n  config?: unknown;\n}\n\ninterface WorkbenchPanelMenusContribution {\n  panelMenus?: readonly WorkbenchPanelMenuDefinition[];\n}\n\nexport interface WorkbenchPanelContribution {\n  id: string;\n  title: string;\n  icon?: string;\n  region: WorkbenchRegion;\n  fallbackRegion?: WorkbenchRegion;\n  rendererId: string;\n  closable: boolean;\n  singleton?: boolean;\n  reuse?: WorkbenchPanelReusePolicy;\n  mountStrategy?: WorkbenchPanelMountStrategy;\n  hiddenByDefault?: boolean;\n  regionSize?: WorkbenchRegionSize;\n  regionCollapsible?: boolean;\n  headerBorderBottom?: boolean;\n  floatingPanels?: WorkbenchFloatingPanelVisibility;\n  resourceKinds?: string[];\n  eligibleLocations?: WorkbenchLocationEligibility;\n  priority?: number;\n  openCommandId?: string;\n  tab?: WorkbenchPanelTab;\n  config?: unknown;\n  canOpen?(resource: ResourceRef): boolean;\n  ownerId?: string;\n  source?: ContributionSource;\n  panelMenus?: readonly WorkbenchPanelMenuDefinition[];\n}\n\nexport type WorkbenchLocationContribution = Omit<WidgetContribution, \"role\"> & WorkbenchPanelMenusContribution;\n\nexport type WorkbenchSubPanelContribution = Omit<WidgetContribution, \"region\" | \"fallbackRegion\" | \"role\"> & {\n  region: WorkbenchPanelRegion;\n  fallbackRegion?: WorkbenchPanelRegion;\n} & WorkbenchPanelMenusContribution;\n\nexport type WorkbenchPanelMenuContribution = Omit<WidgetContribution, \"region\" | \"fallbackRegion\" | \"role\"> & {\n  region: WorkbenchPanelMenuRegion;\n  fallbackRegion?: WorkbenchPanelMenuRegion;\n};\n\nexport type RegisteredWidgetContribution = Omit<WidgetContribution, \"priority\" | \"singleton\" | \"reuse\"> & {\n  ownedPanelMenuIds?: readonly string[];\n  singleton: boolean;\n  reuse: WidgetReusePolicy;\n  role: WorkbenchWidgetRole;\n} & RegisteredContributionMetadata;\n\nexport interface PlaceholderContribution {\n  id: string;\n  title: string;\n  region: WorkbenchRegion;\n  rendererId: string;\n  regionSize?: WorkbenchRegionSize;\n  regionCollapsible?: boolean;\n  config?: unknown;\n  priority?: number;\n}\n\nexport type RegisteredPlaceholderContribution = Omit<PlaceholderContribution, \"priority\"> &\n  RegisteredContributionMetadata;\n\nexport interface WorkbenchWidgetPlacement {\n  widgetId: string;\n  contributionId: string;\n  ownerId?: string;\n  source?: ContributionSource;\n  resource?: ResourceRef;\n  resourceUri?: string;\n  ownerResourceUri?: string;\n  title?: string;\n  pinned?: boolean;\n  closable?: boolean;\n  mountStrategy?: WidgetMountStrategy;\n  hiddenByDefault?: boolean;\n  tabRetention?: WorkbenchTabRetention;\n  tab?: WorkbenchWidgetTab;\n  role?: WorkbenchWidgetRole;\n}\n\nexport interface WorkbenchPanelInstance {\n  instanceId: string;\n  panelId: string;\n  ownerId?: string;\n  source?: ContributionSource;\n  resource?: ResourceRef;\n  resourceUri?: string;\n  ownerResourceUri?: string;\n  title?: string;\n  pinned?: boolean;\n  closable: boolean;\n  mountStrategy?: WorkbenchPanelMountStrategy;\n  hiddenByDefault?: boolean;\n  tabRetention?: WorkbenchTabRetention;\n  tab?: WorkbenchPanelTab;\n}\n\nexport interface WorkbenchRegionState {\n  id: WorkbenchRegion;\n  visible: boolean;\n  size?: number;\n  widgets: WorkbenchWidgetPlacement[];\n  activeWidgetId?: string;\n}\n\nexport interface WorkbenchLayout {\n  regions: Record<WorkbenchRegion, WorkbenchRegionState>;\n  locationSubPanelSelections?: Record<string, Partial<Record<WorkbenchPanelRegion, string>>>;\n  activeWidgetId?: string;\n  activeLocationWidgetId?: string;\n  activeResourceUri?: string;\n}\n\nexport interface WorkbenchLayoutStoreState {\n  layout: WorkbenchLayout;\n  widgets: Record<string, RegisteredWidgetContribution>;\n  placeholders: Partial<Record<WorkbenchRegion, RegisteredPlaceholderContribution>>;\n}\n\nexport interface OpenWidgetInput {\n  resource?: ResourceRef;\n  title?: string;\n  region?: WorkbenchRegion;\n  ownerId?: string;\n  source?: ContributionSource;\n  pinned?: boolean;\n  closable?: boolean;\n  mountStrategy?: WidgetMountStrategy;\n  hiddenByDefault?: boolean;\n  tabRetention?: WorkbenchTabRetention;\n  tabPosition?: WorkbenchTabPosition;\n  tab?: WorkbenchWidgetTab;\n  replaceActive?: boolean;\n  replaceWidgetId?: string;\n}\n\nexport type WorkbenchPanelOpenStrategy =\n  | { kind: \"activate-or-open\"; position?: WorkbenchTabPosition }\n  | { kind: \"replace-active\" }\n  | { kind: \"replace-panel\"; instanceId: string }\n  | { kind: \"preview\"; position?: WorkbenchTabPosition };\n\nexport interface OpenWorkbenchPanelInput {\n  resource?: ResourceRef;\n  title?: string;\n  region?: WorkbenchRegion;\n  pinned?: boolean;\n  mountStrategy?: WorkbenchPanelMountStrategy;\n  hiddenByDefault?: boolean;\n  tab?: WorkbenchPanelTab;\n  strategy?: WorkbenchPanelOpenStrategy;\n}\n\nconst createRegionState = (id: WorkbenchRegion, visible: boolean): WorkbenchRegionState => ({\n  id,\n  visible,\n  widgets: [],\n});\n\nexport const createDefaultWorkbenchLayout = (\n  regionVisibility: Partial<Record<WorkbenchRegion, boolean>> = {},\n): WorkbenchLayout => {\n  const createRegion = (id: WorkbenchRegion) => createRegionState(id, regionVisibility[id] ?? true);\n\n  return {\n    regions: {\n      nav: createRegion(\"nav\"),\n      activity: createRegion(\"activity\"),\n      \"sidenav-header\": createRegion(\"sidenav-header\"),\n      sidenav: createRegion(\"sidenav\"),\n      \"main-header\": createRegion(\"main-header\"),\n      \"main-left-menu\": createRegion(\"main-left-menu\"),\n      main: createRegion(\"main\"),\n      \"main-right-menu\": createRegion(\"main-right-menu\"),\n      \"secondary-header\": createRegion(\"secondary-header\"),\n      \"secondary-left-menu\": createRegion(\"secondary-left-menu\"),\n      secondary: createRegion(\"secondary\"),\n      \"secondary-right-menu\": createRegion(\"secondary-right-menu\"),\n      \"side-header\": createRegion(\"side-header\"),\n      \"side-left-menu\": createRegion(\"side-left-menu\"),\n      side: createRegion(\"side\"),\n      \"side-right-menu\": createRegion(\"side-right-menu\"),\n      status: createRegion(\"status\"),\n      overlay: createRegion(\"overlay\"),\n    },\n  };\n};\n\nconst findLastWidgetIndex = (widgets: WorkbenchWidgetPlacement[], widgetId: string) => {\n  for (let index = widgets.length - 1; index >= 0; index -= 1) {\n    if (widgets[index]?.widgetId === widgetId) return index;\n  }\n  return -1;\n};\n\nconst normalizeWidgetIds = (layout: WorkbenchLayout) => {\n  const widgetIds = new Set<string>();\n  const regions = {} as WorkbenchLayout[\"regions\"];\n  let activeWidgetId = layout.activeWidgetId;\n  let activeResourceUri = layout.activeResourceUri;\n\n  for (const [id, region] of Object.entries(layout.regions) as [WorkbenchRegion, WorkbenchRegionState][]) {\n    const originalActiveWidgetId = region.activeWidgetId;\n    const activeIndex = originalActiveWidgetId ? findLastWidgetIndex(region.widgets, originalActiveWidgetId) : -1;\n    const widgets = region.widgets.map((placement) => {\n      const widgetId = resolveUniqueWidgetId(widgetIds, placement.contributionId, placement.widgetId);\n      widgetIds.add(widgetId);\n      return widgetId === placement.widgetId ? placement : { ...placement, widgetId };\n    });\n    const normalizedActiveWidgetId = activeIndex >= 0 ? widgets[activeIndex]?.widgetId : originalActiveWidgetId;\n    regions[id] = { ...region, widgets, activeWidgetId: normalizedActiveWidgetId };\n\n    if (originalActiveWidgetId && layout.activeWidgetId === originalActiveWidgetId && activeIndex >= 0) {\n      activeWidgetId = normalizedActiveWidgetId;\n      activeResourceUri = widgets[activeIndex]?.resourceUri;\n    }\n  }\n\n  return { ...layout, regions, activeWidgetId, activeResourceUri };\n};\n\nexport const mergeWithDefaultRegions = (\n  persisted: WorkbenchLayout,\n  regionVisibility: Partial<Record<WorkbenchRegion, boolean>> = {},\n): WorkbenchLayout => {\n  const defaults = createDefaultWorkbenchLayout(regionVisibility);\n  return normalizeWidgetIds({\n    ...persisted,\n    regions: { ...defaults.regions, ...persisted.regions },\n  });\n};\n"],"names":["resolveUniqueWidgetId","widgetIds","contributionId","preferredId","has","suffix","workbenchRegions","workbenchPanelRegions","workbenchPanelMenuRegions","main","left","right","secondary","side","workbenchPanelByMenuRegion","getWorkbenchPanelForMenuRegion","region","createRegionState","id","visible","widgets","createDefaultWorkbenchLayout","regionVisibility","createRegion","regions","nav","activity","sidenav","status","overlay","findLastWidgetIndex","widgetId","index","length","normalizeWidgetIds","layout","Set","activeWidgetId","activeResourceUri","Object","entries","originalActiveWidgetId","activeIndex","map","placement","add","normalizedActiveWidgetId","resourceUri","mergeWithDefaultRegions","persisted","defaults"],"mappings":"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"}
+{"version":3,"file":"layout-types-DMoZz38-.js","sources":["../src/core/registries/layout/widget-id.ts","../src/core/registries/layout/layout-types.ts"],"sourcesContent":["export const resolveUniqueWidgetId = (\n  widgetIds: ReadonlySet<string>,\n  contributionId: string,\n  preferredId = contributionId,\n) => {\n  if (!widgetIds.has(preferredId)) return preferredId;\n\n  let suffix = 1;\n  while (widgetIds.has(`${contributionId}:${suffix}`)) suffix += 1;\n  return `${contributionId}:${suffix}`;\n};\n","import type { ContributionSource, RegisteredContributionMetadata } from \"../../shared/contributions/metadata\";\nimport type { ResourceRef } from \"../resources/resource-registry\";\nimport { resolveUniqueWidgetId } from \"./widget-id\";\n\nexport const workbenchRegions = [\n  \"nav\",\n  \"activity\",\n  \"sidenav-header\",\n  \"sidenav\",\n  \"main-header\",\n  \"main-left-menu\",\n  \"main\",\n  \"main-right-menu\",\n  \"secondary-header\",\n  \"secondary-left-menu\",\n  \"secondary\",\n  \"secondary-right-menu\",\n  \"side-header\",\n  \"side-left-menu\",\n  \"side\",\n  \"side-right-menu\",\n  \"status\",\n  \"overlay\",\n] as const;\n\nexport type WorkbenchRegion = (typeof workbenchRegions)[number];\n\nexport const workbenchPanelRegions = [\"main\", \"secondary\", \"side\"] as const satisfies readonly WorkbenchRegion[];\n\nexport type WorkbenchPanelRegion = (typeof workbenchPanelRegions)[number];\n\nexport type WorkbenchPanelMenuSide = \"left\" | \"right\";\n\nexport const workbenchPanelMenuRegions = {\n  main: { left: \"main-left-menu\", right: \"main-right-menu\" },\n  secondary: { left: \"secondary-left-menu\", right: \"secondary-right-menu\" },\n  side: { left: \"side-left-menu\", right: \"side-right-menu\" },\n} as const satisfies Record<WorkbenchPanelRegion, Record<WorkbenchPanelMenuSide, WorkbenchRegion>>;\n\nexport type WorkbenchPanelMenuRegion = (typeof workbenchPanelMenuRegions)[WorkbenchPanelRegion][WorkbenchPanelMenuSide];\n\nconst workbenchPanelByMenuRegion = {\n  \"main-left-menu\": \"main\",\n  \"main-right-menu\": \"main\",\n  \"secondary-left-menu\": \"secondary\",\n  \"secondary-right-menu\": \"secondary\",\n  \"side-left-menu\": \"side\",\n  \"side-right-menu\": \"side\",\n} as const satisfies Record<WorkbenchPanelMenuRegion, WorkbenchPanelRegion>;\n\nexport const getWorkbenchPanelForMenuRegion = (region: WorkbenchPanelMenuRegion) => workbenchPanelByMenuRegion[region];\n\nexport interface WorkbenchRegionSize {\n  defaultPx?: number;\n  minPx?: number;\n  maxPx?: number;\n}\n\nexport type WidgetReusePolicy = \"resource\" | \"none\";\n\nexport type WidgetMountStrategy = \"active\" | \"keep-mounted\";\n\nexport type WorkbenchPanelReusePolicy = WidgetReusePolicy;\n\nexport type WorkbenchPanelMountStrategy = WidgetMountStrategy;\n\nexport type WorkbenchFloatingPanelVisibility = \"visible\" | \"hidden\";\n\nexport type WorkbenchWidgetRole = \"content\" | \"location\" | \"sub-panel\" | \"panel-menu\";\n\nexport type WorkbenchTabRetention = \"preview\" | \"persistent\";\n\nexport type WorkbenchTabPosition = \"start\" | \"end\" | { beforeWidgetId: string } | { afterWidgetId: string };\n\nexport interface WorkbenchLocationEligibility {\n  modeIds?: string[];\n  resourceKinds?: string[];\n  resourceIds?: string[];\n  canOpen?(resource: ResourceRef): boolean;\n}\n\nexport type WorkbenchPanelMenuOwner =\n  | { level: \"panel\"; contributionId?: string }\n  | { level: \"sub-panel\"; contributionId: string };\n\nexport interface WorkbenchWidgetTab {\n  contentRendererId?: string;\n  /** Custom actions shown when the user activates an already-active tab. */\n  customMenuRendererId?: string;\n}\n\nexport type WorkbenchPanelTab = WorkbenchWidgetTab;\n\nexport interface WidgetContribution {\n  id: string;\n  title: string;\n  icon?: string;\n  region: WorkbenchRegion;\n  fallbackRegion?: WorkbenchRegion;\n  singleton?: boolean;\n  reuse?: WidgetReusePolicy;\n  mountStrategy?: WidgetMountStrategy;\n  closable?: boolean;\n  // Non-closeable widgets opt into the tab visibility menu; closeable widgets\n  // ignore this and use the X button for dismissal.\n  hiddenByDefault?: boolean;\n  // A Location that presents only its Sub Panels: it renders no tab and no\n  // content of its own — establishing it activates its first Sub Panel.\n  subPanelsOnly?: boolean;\n  regionSize?: WorkbenchRegionSize;\n  regionCollapsible?: boolean;\n  headerBorderBottom?: boolean;\n  floatingPanels?: WorkbenchFloatingPanelVisibility;\n  resourceKinds?: string[];\n  priority?: number;\n  rendererId: string;\n  openCommandId?: string;\n  eligibleLocations?: WorkbenchLocationEligibility;\n  panelMenuOwner?: WorkbenchPanelMenuOwner;\n  tab?: WorkbenchWidgetTab;\n  config?: unknown;\n  canOpen?(resource: ResourceRef): boolean;\n}\n\nexport interface WorkbenchPanelMenuDefinition {\n  id: string;\n  title: string;\n  icon?: string;\n  side: WorkbenchPanelMenuSide;\n  singleton?: boolean;\n  reuse?: WorkbenchPanelReusePolicy;\n  mountStrategy?: WorkbenchPanelMountStrategy;\n  hiddenByDefault?: boolean;\n  regionSize?: WorkbenchRegionSize;\n  regionCollapsible?: boolean;\n  headerBorderBottom?: boolean;\n  rendererId: string;\n  priority?: number;\n  config?: unknown;\n}\n\ninterface WorkbenchPanelMenusContribution {\n  panelMenus?: readonly WorkbenchPanelMenuDefinition[];\n}\n\nexport interface WorkbenchPanelContribution {\n  id: string;\n  title: string;\n  icon?: string;\n  region: WorkbenchRegion;\n  fallbackRegion?: WorkbenchRegion;\n  rendererId: string;\n  singleton?: boolean;\n  reuse?: WorkbenchPanelReusePolicy;\n  mountStrategy?: WorkbenchPanelMountStrategy;\n  hiddenByDefault?: boolean;\n  subPanelsOnly?: boolean;\n  regionSize?: WorkbenchRegionSize;\n  regionCollapsible?: boolean;\n  headerBorderBottom?: boolean;\n  floatingPanels?: WorkbenchFloatingPanelVisibility;\n  resourceKinds?: string[];\n  eligibleLocations?: WorkbenchLocationEligibility;\n  priority?: number;\n  openCommandId?: string;\n  tab?: WorkbenchPanelTab;\n  config?: unknown;\n  canOpen?(resource: ResourceRef): boolean;\n  ownerId?: string;\n  source?: ContributionSource;\n  panelMenus?: readonly WorkbenchPanelMenuDefinition[];\n}\n\nexport type WorkbenchLocationContribution = WidgetContribution & WorkbenchPanelMenusContribution;\n\nexport type WorkbenchSubPanelContribution = Omit<WidgetContribution, \"region\" | \"fallbackRegion\"> & {\n  region: WorkbenchPanelRegion;\n  fallbackRegion?: WorkbenchPanelRegion;\n} & WorkbenchPanelMenusContribution;\n\nexport type WorkbenchPanelMenuContribution = Omit<WidgetContribution, \"region\" | \"fallbackRegion\"> & {\n  region: WorkbenchPanelMenuRegion;\n  fallbackRegion?: WorkbenchPanelMenuRegion;\n};\n\nexport type RegisteredWidgetContribution = Omit<WidgetContribution, \"priority\" | \"singleton\" | \"reuse\"> & {\n  ownedPanelMenuIds?: readonly string[];\n  singleton: boolean;\n  reuse: WidgetReusePolicy;\n} & RegisteredContributionMetadata;\n\nexport interface PlaceholderContribution {\n  id: string;\n  title: string;\n  region: WorkbenchRegion;\n  rendererId: string;\n  regionSize?: WorkbenchRegionSize;\n  regionCollapsible?: boolean;\n  config?: unknown;\n  priority?: number;\n}\n\nexport type RegisteredPlaceholderContribution = Omit<PlaceholderContribution, \"priority\"> &\n  RegisteredContributionMetadata;\n\nexport interface WorkbenchWidgetPlacement {\n  widgetId: string;\n  contributionId: string;\n  ownerId?: string;\n  source?: ContributionSource;\n  resource?: ResourceRef;\n  resourceUri?: string;\n  ownerResourceUri?: string;\n  title?: string;\n  pinned?: boolean;\n  closable?: boolean;\n  mountStrategy?: WidgetMountStrategy;\n  hiddenByDefault?: boolean;\n  tabRetention?: WorkbenchTabRetention;\n  tab?: WorkbenchWidgetTab;\n  role?: WorkbenchWidgetRole;\n}\n\nexport interface WorkbenchPanelInstance {\n  instanceId: string;\n  panelId: string;\n  ownerId?: string;\n  source?: ContributionSource;\n  resource?: ResourceRef;\n  resourceUri?: string;\n  ownerResourceUri?: string;\n  title?: string;\n  pinned?: boolean;\n  closable: boolean;\n  mountStrategy?: WorkbenchPanelMountStrategy;\n  hiddenByDefault?: boolean;\n  tabRetention?: WorkbenchTabRetention;\n  tab?: WorkbenchPanelTab;\n}\n\nexport interface WorkbenchRegionState {\n  id: WorkbenchRegion;\n  visible: boolean;\n  size?: number;\n  widgets: WorkbenchWidgetPlacement[];\n  activeWidgetId?: string;\n}\n\nexport interface WorkbenchLayout {\n  regions: Record<WorkbenchRegion, WorkbenchRegionState>;\n  locationSubPanelSelections?: Record<string, Partial<Record<WorkbenchPanelRegion, string>>>;\n  activeWidgetId?: string;\n  activeLocationWidgetId?: string;\n  activeResourceUri?: string;\n}\n\nexport interface WorkbenchLayoutStoreState {\n  layout: WorkbenchLayout;\n  widgets: Record<string, RegisteredWidgetContribution>;\n  placeholders: Partial<Record<WorkbenchRegion, RegisteredPlaceholderContribution>>;\n}\n\nexport interface OpenWidgetInput {\n  resource?: ResourceRef;\n  title?: string;\n  region?: WorkbenchRegion;\n  // The role this placement takes, when the caller knows it better than the widget\n  // does. A panel is a Location in main and a Sub Panel elsewhere, so a placement made\n  // by the composition resolver carries the role its region implies.\n  role?: WorkbenchWidgetRole;\n  ownerId?: string;\n  source?: ContributionSource;\n  pinned?: boolean;\n  closable?: boolean;\n  mountStrategy?: WidgetMountStrategy;\n  hiddenByDefault?: boolean;\n  tabRetention?: WorkbenchTabRetention;\n  tabPosition?: WorkbenchTabPosition;\n  tab?: WorkbenchWidgetTab;\n  replaceActive?: boolean;\n  replaceWidgetId?: string;\n}\n\nexport type WorkbenchPanelOpenStrategy =\n  | { kind: \"persistent\"; position?: WorkbenchTabPosition }\n  | { kind: \"replace-active\" }\n  | { kind: \"replace-panel\"; instanceId: string; retention?: WorkbenchTabRetention }\n  | { kind: \"preview\"; position?: WorkbenchTabPosition };\n\nexport interface OpenWorkbenchPanelInput {\n  resource?: ResourceRef;\n  title?: string;\n  region?: WorkbenchRegion;\n  role?: WorkbenchWidgetRole;\n  pinned?: boolean;\n  closable?: boolean;\n  mountStrategy?: WorkbenchPanelMountStrategy;\n  hiddenByDefault?: boolean;\n  tab?: WorkbenchPanelTab;\n  strategy?: WorkbenchPanelOpenStrategy;\n}\n\nconst createRegionState = (id: WorkbenchRegion, visible: boolean): WorkbenchRegionState => ({\n  id,\n  visible,\n  widgets: [],\n});\n\nexport const createDefaultWorkbenchLayout = (\n  regionVisibility: Partial<Record<WorkbenchRegion, boolean>> = {},\n): WorkbenchLayout => {\n  const createRegion = (id: WorkbenchRegion) => createRegionState(id, regionVisibility[id] ?? true);\n\n  return {\n    regions: {\n      nav: createRegion(\"nav\"),\n      activity: createRegion(\"activity\"),\n      \"sidenav-header\": createRegion(\"sidenav-header\"),\n      sidenav: createRegion(\"sidenav\"),\n      \"main-header\": createRegion(\"main-header\"),\n      \"main-left-menu\": createRegion(\"main-left-menu\"),\n      main: createRegion(\"main\"),\n      \"main-right-menu\": createRegion(\"main-right-menu\"),\n      \"secondary-header\": createRegion(\"secondary-header\"),\n      \"secondary-left-menu\": createRegion(\"secondary-left-menu\"),\n      secondary: createRegion(\"secondary\"),\n      \"secondary-right-menu\": createRegion(\"secondary-right-menu\"),\n      \"side-header\": createRegion(\"side-header\"),\n      \"side-left-menu\": createRegion(\"side-left-menu\"),\n      side: createRegion(\"side\"),\n      \"side-right-menu\": createRegion(\"side-right-menu\"),\n      status: createRegion(\"status\"),\n      overlay: createRegion(\"overlay\"),\n    },\n  };\n};\n\nconst findLastWidgetIndex = (widgets: WorkbenchWidgetPlacement[], widgetId: string) => {\n  for (let index = widgets.length - 1; index >= 0; index -= 1) {\n    if (widgets[index]?.widgetId === widgetId) return index;\n  }\n  return -1;\n};\n\nconst normalizeWidgetIds = (layout: WorkbenchLayout) => {\n  const widgetIds = new Set<string>();\n  const regions = {} as WorkbenchLayout[\"regions\"];\n  let activeWidgetId = layout.activeWidgetId;\n  let activeResourceUri = layout.activeResourceUri;\n\n  for (const [id, region] of Object.entries(layout.regions) as [WorkbenchRegion, WorkbenchRegionState][]) {\n    const originalActiveWidgetId = region.activeWidgetId;\n    const activeIndex = originalActiveWidgetId ? findLastWidgetIndex(region.widgets, originalActiveWidgetId) : -1;\n    const widgets = region.widgets.map((placement) => {\n      const widgetId = resolveUniqueWidgetId(widgetIds, placement.contributionId, placement.widgetId);\n      widgetIds.add(widgetId);\n      return widgetId === placement.widgetId ? placement : { ...placement, widgetId };\n    });\n    const normalizedActiveWidgetId = activeIndex >= 0 ? widgets[activeIndex]?.widgetId : originalActiveWidgetId;\n    regions[id] = { ...region, widgets, activeWidgetId: normalizedActiveWidgetId };\n\n    if (originalActiveWidgetId && layout.activeWidgetId === originalActiveWidgetId && activeIndex >= 0) {\n      activeWidgetId = normalizedActiveWidgetId;\n      activeResourceUri = widgets[activeIndex]?.resourceUri;\n    }\n  }\n\n  return { ...layout, regions, activeWidgetId, activeResourceUri };\n};\n\nexport const mergeWithDefaultRegions = (\n  persisted: WorkbenchLayout,\n  regionVisibility: Partial<Record<WorkbenchRegion, boolean>> = {},\n): WorkbenchLayout => {\n  const defaults = createDefaultWorkbenchLayout(regionVisibility);\n  return normalizeWidgetIds({\n    ...persisted,\n    regions: { ...defaults.regions, ...persisted.regions },\n  });\n};\n"],"names":["resolveUniqueWidgetId","widgetIds","contributionId","preferredId","has","suffix","workbenchRegions","workbenchPanelRegions","workbenchPanelMenuRegions","main","left","right","secondary","side","workbenchPanelByMenuRegion","getWorkbenchPanelForMenuRegion","region","createRegionState","id","visible","widgets","createDefaultWorkbenchLayout","regionVisibility","createRegion","regions","nav","activity","sidenav","status","overlay","findLastWidgetIndex","widgetId","index","length","normalizeWidgetIds","layout","Set","activeWidgetId","activeResourceUri","Object","entries","originalActiveWidgetId","activeIndex","map","placement","add","normalizedActiveWidgetId","resourceUri","mergeWithDefaultRegions","persisted","defaults"],"mappings":"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"}

package/dist/react.d.ts

@@ -8,6 +8,7 @@ import { JSXElementConstructor } from 'react';
 import { ListRowActionMenuItem } from '@pstdio/ui';
 import { Param } from '@pstdio/ui';
 import { ParamEditorProps } from '@pstdio/ui';
+import { ParamValue } from '@pstdio/ui';
 import { ReactElement } from 'react';
 import { ReactNode } from 'react';
 import { ReactPortal } from 'react';
@@ -185,9 +186,13 @@ export declare interface CommandParamFieldProps {
 
 export declare type CommandParamFieldRenderer = (props: CommandParamFieldProps) => ReactNode;
 
+/** Required params carry the marker in their name — the editor has no required state. */
+export declare const commandParamName: (entry: CommandParamEntry) => string;
+
 declare interface CommandParamOption {
     label: string;
     value: string;
+    icon?: string;
 }
 
 declare type CommandParamSchema = Record<string, CommandParamDescriptor>;
@@ -443,7 +448,7 @@ 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;
 }
 
 declare type DataTableRendererImplementation = (input: WorkbenchPanelRenderInput & {
@@ -574,6 +579,8 @@ declare interface FileRendererContent {
     content?: string;
     dataUrl?: string;
     placeholder?: string;
+    /** Ordered backing-store revision when one is available. */
+    revision?: string;
 }
 
 declare interface FileRendererContribution {
@@ -583,35 +590,53 @@ 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;
 }
 
 declare type FileRendererImplementation = (input: WorkbenchPanelRenderInput & {
     fileRendererId: string;
 }) => unknown;
 
-declare interface FileRendererRefreshEvent {
+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): void;
+    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;
@@ -639,6 +664,8 @@ declare interface KanbanRendererContribution<TRow extends KanbanRendererRow = Ka
     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`.
@@ -666,8 +693,8 @@ declare interface KanbanRendererContribution<TRow extends KanbanRendererRow = Ka
      */
     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[];
     /**
@@ -761,7 +788,7 @@ 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;
@@ -866,6 +893,16 @@ declare interface LayoutModel {
         carryRegionState?: readonly WorkbenchRegion_2[];
     }): 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;
     };
@@ -982,6 +1019,7 @@ declare interface OpenWidgetInput {
     resource?: ResourceRef;
     title?: string;
     region?: WorkbenchRegion_2;
+    role?: WorkbenchWidgetRole;
     ownerId?: string;
     source?: ContributionSource;
     pinned?: boolean;
@@ -999,7 +1037,9 @@ declare interface OpenWorkbenchPanelInput {
     resource?: ResourceRef;
     title?: string;
     region?: WorkbenchRegion_2;
+    role?: WorkbenchWidgetRole;
     pinned?: boolean;
+    closable?: boolean;
     mountStrategy?: WorkbenchPanelMountStrategy;
     hiddenByDefault?: boolean;
     tab?: WorkbenchPanelTab;
@@ -1014,9 +1054,9 @@ declare type OpenWorkbenchTerminalOptions = OpenWorkbenchTerminalInput & {
     reveal?: boolean;
 };
 
-declare type ParamValue = Parameters<NonNullable<ParamEditorProps["onChange"]>>[1];
+declare type ParamValue_2 = Parameters<NonNullable<ParamEditorProps["onChange"]>>[1];
 
-export declare const paramValueToPreference: (schema: PreferencePropertySchema, value: ParamValue) => PreferenceValue;
+export declare const paramValueToPreference: (schema: PreferencePropertySchema, value: ParamValue_2) => PreferenceValue;
 
 declare interface PlaceholderContribution {
     id: string;
@@ -1072,6 +1112,9 @@ declare interface PreferenceScopeRef {
 
 declare type PreferenceValue = boolean | number | string | string[] | number[] | boolean[] | Record<string, unknown>;
 
+/** Narrows an editor value back to what a command param can carry. */
+export declare const readCommandParamValue: (value: ParamValue) => CommandParamValue;
+
 declare interface RegisteredCommand extends RegisteredContributionMetadata {
     command: Command;
     handler: CommandHandler;
@@ -1133,7 +1176,6 @@ declare type RegisteredWidgetContribution = Omit<WidgetContribution, "priority"
     ownedPanelMenuIds?: readonly string[];
     singleton: boolean;
     reuse: WidgetReusePolicy;
-    role: WorkbenchWidgetRole;
 } & RegisteredContributionMetadata;
 
 declare interface RegisteredWorkbenchNotification extends RegisteredContributionMetadata {
@@ -1171,6 +1213,14 @@ declare interface ResourceContextAction {
     separatorBefore?: boolean;
 }
 
+declare interface ResourceHierarchyCycle {
+    code: typeof resourceHierarchyCycleCode;
+    path: ResourceRef[];
+    repeatedUri: string;
+}
+
+declare const resourceHierarchyCycleCode = "resource_hierarchy_cycle";
+
 declare interface ResourceHierarchyProvider {
     id: string;
     priority?: number;
@@ -1243,6 +1293,7 @@ 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;
@@ -1559,6 +1610,7 @@ declare interface WidgetContribution {
     mountStrategy?: WidgetMountStrategy;
     closable?: boolean;
     hiddenByDefault?: boolean;
+    subPanelsOnly?: boolean;
     regionSize?: WorkbenchRegionSize;
     regionCollapsible?: boolean;
     headerBorderBottom?: boolean;
@@ -1567,7 +1619,6 @@ declare interface WidgetContribution {
     priority?: number;
     rendererId: string;
     openCommandId?: string;
-    role?: WorkbenchWidgetRole;
     eligibleLocations?: WorkbenchLocationEligibility;
     panelMenuOwner?: WorkbenchPanelMenuOwner;
     tab?: WorkbenchWidgetTab;
@@ -1704,6 +1755,20 @@ declare interface WorkbenchCommandParamsRequest {
     context?: WorkbenchCommandExecutionContext;
 }
 
+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[];
+}
+
 declare interface WorkbenchCore extends WorkbenchCoreContributionContext {
     host: WorkbenchHost;
     registerModule(module: WorkbenchModuleContribution): Disposable_2;
@@ -1715,6 +1780,7 @@ declare interface WorkbenchCoreContributionContext {
     commandPalette: WorkbenchCommandPaletteController;
     commandPaletteResources: CommandPaletteResourceRegistry;
     commands: CommandRegistry;
+    composition: WorkbenchCompositionController;
     context: ContextKeyService;
     focus: WorkbenchFocusController;
     history: HistoryController;
@@ -1723,6 +1789,7 @@ declare interface WorkbenchCoreContributionContext {
     layout: WorkbenchLayoutModel;
     modes: WorkbenchModeRegistry;
     navigation: NavigationRegistry;
+    navigator: WorkbenchNavigator;
     notifications: NotificationRegistry;
     panels: WorkbenchPanelsController;
     preferences: PreferenceRegistry;
@@ -1850,7 +1917,7 @@ declare interface WorkbenchLayoutStoreState {
     placeholders: Partial<Record<WorkbenchRegion_2, RegisteredPlaceholderContribution>>;
 }
 
-declare type WorkbenchLocationContribution = Omit<WidgetContribution, "role"> & WorkbenchPanelMenusContribution;
+declare type WorkbenchLocationContribution = WidgetContribution & WorkbenchPanelMenusContribution;
 
 declare interface WorkbenchLocationEligibility {
     modeIds?: string[];
@@ -1891,15 +1958,31 @@ declare type WorkbenchModeActivationContext = WorkbenchCoreContributionContext;
 
 declare type WorkbenchModeActivationResult = Disposable_2 | readonly Disposable_2[] | undefined;
 
+declare interface WorkbenchModeAddablePanel {
+    panelId: string;
+    region: WorkbenchPanelRegion;
+    allowedRegions?: readonly WorkbenchRegion_2[];
+    pinned?: boolean;
+}
+
+declare interface WorkbenchModeAddablePanelContext {
+    layout: WorkbenchLayout;
+    resource?: ResourceRef;
+}
+
 declare type WorkbenchModeChangeListener = () => void;
 
 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;
 }
 
 declare interface WorkbenchModeRegistry {
@@ -1946,6 +2029,14 @@ 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;
@@ -1960,6 +2051,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;
+}
+
 declare interface WorkbenchNotification {
     id?: string;
     level: WorkbenchNotificationLevel;
@@ -2020,6 +2158,8 @@ export declare interface WorkbenchOverlayWidgetConfig {
     contentHeight?: string;
     contentMaxHeight?: string;
     contentMinHeight?: string;
+    contentWidth?: string;
+    contentMaxWidth?: string;
     closeTriggerTop?: string;
 }
 
@@ -2030,11 +2170,11 @@ declare interface WorkbenchPanelContribution {
     region: WorkbenchRegion_2;
     fallbackRegion?: WorkbenchRegion_2;
     rendererId: string;
-    closable: boolean;
     singleton?: boolean;
     reuse?: WorkbenchPanelReusePolicy;
     mountStrategy?: WorkbenchPanelMountStrategy;
     hiddenByDefault?: boolean;
+    subPanelsOnly?: boolean;
     regionSize?: WorkbenchRegionSize;
     regionCollapsible?: boolean;
     headerBorderBottom?: boolean;
@@ -2085,7 +2225,7 @@ declare interface WorkbenchPanelInstance_2 {
     tab?: WorkbenchPanelTab_2;
 }
 
-declare type WorkbenchPanelMenuContribution = Omit<WidgetContribution, "region" | "fallbackRegion" | "role"> & {
+declare type WorkbenchPanelMenuContribution = Omit<WidgetContribution, "region" | "fallbackRegion"> & {
     region: WorkbenchPanelMenuRegion;
     fallbackRegion?: WorkbenchPanelMenuRegion;
 };
@@ -2143,13 +2283,14 @@ declare type WorkbenchPanelMountStrategy = WidgetMountStrategy;
 declare type WorkbenchPanelMountStrategy_2 = WidgetMountStrategy_2;
 
 declare type WorkbenchPanelOpenStrategy = {
-    kind: "activate-or-open";
+    kind: "persistent";
     position?: WorkbenchTabPosition;
 } | {
     kind: "replace-active";
 } | {
     kind: "replace-panel";
     instanceId: string;
+    retention?: WorkbenchTabRetention;
 } | {
     kind: "preview";
     position?: WorkbenchTabPosition;
@@ -2342,7 +2483,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;