@pstdio/workbench 0.7.0 → 0.8.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  // 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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"}
+{"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  canOpenLocation?(location: { resource?: ResourceRef; viewId?: string }): 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  viewId?: 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  viewId?: 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  viewId?: string | null;\n  resource?: ResourceRef | null;\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  /** Set by the view registry. Low-level layout callers should leave this undefined. */\n  viewId?: string | null;\n  /** `null` explicitly clears an existing singleton placement's resource binding. */\n  resource?: ResourceRef | null;\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

@@ -178,6 +178,7 @@ declare interface CommandParamDescriptor {
     accept?: string;
     multiple?: boolean;
     metadata?: Record<string, unknown>;
+    resolvedFrom?: "resource";
 }
 
 export declare interface CommandParamEntry extends CommandParamDescriptor {
@@ -271,6 +272,7 @@ declare type ContributionSource = "module" | "extension";
 declare type ContributionSource_2 = "module" | "extension";
 
 declare interface ControllerTerminalBridgeOptions {
+    getBindingId?: () => string | undefined;
     getResource?: () => ResourceRef | undefined;
     getTitle?: () => string | undefined;
 }
@@ -670,6 +672,7 @@ declare interface HistoryController {
     restore(): HistoryEntry | undefined;
     flush(): void;
     clear(): void;
+    migrateState(transform: (state: HistoryStoreState) => HistoryStoreState): void;
 }
 
 declare type HistoryEntry = WorkbenchNavigationEntry;
@@ -1009,7 +1012,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";
@@ -1023,6 +1031,12 @@ declare interface NavigationTargetResource {
     input?: OpenResourceInput;
 }
 
+declare interface NavigationTargetView {
+    kind: "view";
+    viewId: string;
+    input?: OpenWorkbenchViewInput;
+}
+
 declare const NO_GROUPING = "none";
 
 export declare const normalizeWorkbenchKeybinding: (keybinding: KeybindingSequence) => KeybindingSequence;
@@ -1041,7 +1055,8 @@ declare interface OpenResourceInput {
 }
 
 declare interface OpenWidgetInput {
-    resource?: ResourceRef;
+    viewId?: string | null;
+    resource?: ResourceRef | null;
     title?: string;
     region?: WorkbenchRegion_2;
     role?: WorkbenchWidgetRole;
@@ -1059,7 +1074,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_2;
     role?: WorkbenchWidgetRole;
@@ -1079,6 +1097,8 @@ declare type OpenWorkbenchTerminalOptions = OpenWorkbenchTerminalInput & {
     reveal?: boolean;
 };
 
+declare type OpenWorkbenchViewInput = Omit<OpenWorkbenchPanelInput, "viewId">;
+
 declare type ParamValue_2 = Parameters<NonNullable<ParamEditorProps["onChange"]>>[1];
 
 export declare const paramValueToPreference: (schema: PreferencePropertySchema, value: ParamValue_2) => PreferenceValue;
@@ -1214,6 +1234,10 @@ declare interface RegisteredWorkbenchNotification extends RegisteredContribution
     metadata?: Record<string, unknown>;
 }
 
+declare type RegisteredWorkbenchStatusSet = WorkbenchStatusSetContribution & RegisteredContributionMetadata;
+
+declare type RegisteredWorkbenchView = WorkbenchViewContribution & RegisteredContributionMetadata;
+
 declare type ResolvedResourceHierarchyProvider = Required<ResourceHierarchyProvider>;
 
 declare type ResolvedResourcePresenter = Omit<ResourcePresenter, "priority"> & {
@@ -1242,7 +1266,7 @@ declare interface ResourceContextAction {
 
 declare interface ResourceHierarchyCycle {
     code: typeof resourceHierarchyCycleCode;
-    path: ResourceRef[];
+    path: WorkbenchHierarchyNode[];
     repeatedUri: string;
 }
 
@@ -1252,7 +1276,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 {
@@ -1320,7 +1344,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>;
@@ -1816,6 +1840,7 @@ declare interface WorkbenchCompositionRegionPanels {
 
 declare interface WorkbenchCore extends WorkbenchCoreContributionContext {
     host: WorkbenchHost;
+    layout: WorkbenchLayoutModel;
     registerModule(module: WorkbenchModuleContribution): Disposable_2;
     unregisterModule(moduleId: string): void;
 }
@@ -1831,7 +1856,7 @@ declare interface WorkbenchCoreContributionContext {
     history: HistoryController;
     keybindings: KeybindingRegistry;
     lastResource: WorkbenchLastResourceController;
-    layout: WorkbenchLayoutModel;
+    layout: WorkbenchModuleLayoutModel;
     modes: WorkbenchModeRegistry;
     navigation: NavigationRegistry;
     navigator: WorkbenchNavigator;
@@ -1840,7 +1865,10 @@ declare interface WorkbenchCoreContributionContext {
     preferences: PreferenceRegistry;
     renderers: WorkbenchRenderers;
     resources: ResourceRegistry;
+    views: WorkbenchViewRegistry;
     settings: SettingsRegistry;
+    statusBar: WorkbenchStatusBarRegistry;
+    statuses: WorkbenchStatusRegistry;
     shell: WorkbenchShellController;
     sidePanel: WorkbenchSidePanelController;
     terminal: WorkbenchTerminalController;
@@ -1902,6 +1930,8 @@ declare interface WorkbenchHeaderActionsProps {
     controlSize?: "2xs" | "xs";
 }
 
+declare type WorkbenchHierarchyNode = ResourceRef | WorkbenchViewHierarchyNode;
+
 declare interface WorkbenchHost {
     getSnapshot(): WorkbenchSnapshot;
     restoreSnapshot(snapshot: WorkbenchSnapshot): void;
@@ -1969,11 +1999,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;
@@ -2074,6 +2109,8 @@ export declare interface WorkbenchModuleHostRegistration {
     disposable: Disposable_2;
 }
 
+declare type WorkbenchModuleLayoutModel = Omit<WorkbenchLayoutModel, "registerWidget">;
+
 declare interface WorkbenchNavigationCommit {
     modeId: string | undefined;
     resource: ResourceRef | undefined;
@@ -2087,9 +2124,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;
@@ -2240,6 +2278,7 @@ declare interface WorkbenchPanelContribution {
 declare interface WorkbenchPanelInstance {
     instanceId: string;
     panelId: string;
+    viewId?: string;
     ownerId?: string;
     source?: ContributionSource;
     resource?: ResourceRef;
@@ -2257,6 +2296,7 @@ declare interface WorkbenchPanelInstance {
 declare interface WorkbenchPanelInstance_2 {
     instanceId: string;
     panelId: string;
+    viewId?: string;
     ownerId?: string;
     source?: ContributionSource_2;
     resource?: ResourceRef_2;
@@ -2513,6 +2553,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;
@@ -2557,6 +2643,7 @@ declare interface WorkbenchTerminalController {
     setSessionOpener(opener: WorkbenchTerminalSessionOpener | null): void;
     /** Opens a session; the live adapter stays host-side and only the id is returned. */
     open(input: {
+        bindingId?: string;
         request: WorkbenchTerminalSessionRequest;
         title?: string;
     }): Promise<{
@@ -2575,6 +2662,7 @@ declare interface WorkbenchTerminalController {
         sessionId: string;
         signal?: string;
     }): Promise<void>;
+    killBinding(bindingId: string): Promise<void>;
     subscribe(sessionId: string, sink: WorkbenchTerminalSessionSink): () => void;
     getSession(sessionId: string): WorkbenchTerminalSessionModel | undefined;
     listSessions(): WorkbenchTerminalSessionModel[];
@@ -2586,8 +2674,8 @@ declare interface WorkbenchTerminalController {
  * Body of the host-owned terminal panel. Chrome (tab, title, close action,
  * resize) comes from the workbench `secondary` region; this component only mounts
  * the terminal bound to the workbench terminal controller. Collapsing the panel
- * keeps the terminal mounted. Closing its tab unmounts the terminal and kills
- * its session (close = kill).
+ * keeps the terminal mounted. Scope changes keep the session alive; the terminal
+ * module ends it when its tab is explicitly closed.
  */
 export declare const WorkbenchTerminalPanel: (props: WorkbenchTerminalPanelProps) => JSX.Element;
 
@@ -2678,6 +2766,54 @@ declare interface WorkbenchTreeViewProps {
     onSidenavContextActionsChange?: (actions: ResourceContextAction_2[]) => void;
 }
 
+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>;
+}
+
 export declare const WorkbenchWidgetHost: (props: WorkbenchWidgetHostProps) => JSX.Element;
 
 declare interface WorkbenchWidgetHostProps {
@@ -2689,6 +2825,7 @@ declare interface WorkbenchWidgetHostProps {
 declare interface WorkbenchWidgetPlacement {
     widgetId: string;
     contributionId: string;
+    viewId?: string;
     ownerId?: string;
     source?: ContributionSource;
     resource?: ResourceRef;
@@ -2718,4 +2855,35 @@ 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 declare const WorkflowStatusSettings: (props: WorkflowStatusSettingsProps) => JSX.Element;
+
+declare interface WorkflowStatusSettingsProps {
+    workbench: {
+        statuses: WorkbenchStatusRegistry;
+    };
+}
+
 export { }