@workbench-kit/react 0.0.2-prototype.0.1.2 → 0.0.2-prototype.0.2.2

package/src/workbench/shell.ts

@@ -1,7 +1,36 @@
-export { ActivityBar } from './ActivityBar';
+export { ActivityBar, ACTIVITY_BAR_DRAG_DATA_TYPE } from './ActivityBar';
+export {
+  hasWorkbenchSidebarViewPlacementDrag,
+  readWorkbenchSidebarViewPlacementDrag,
+  resetWorkbenchSidebarViewPlacementDragSession,
+  subscribeWorkbenchSidebarViewPlacementDragSessionEnd,
+  writeWorkbenchSidebarViewPlacementDrag,
+  WORKBENCH_SIDEBAR_VIEW_PLACEMENT_DRAG_DATA_TYPE,
+} from './sidebarViewPlacementDnd';
+export {
+  mergeWorkbenchSidebarViewPlacementDropZoneProps,
+  useWorkbenchSidebarViewPlacementDropZone,
+} from './useWorkbenchSidebarViewPlacementDropZone';
+export type {
+  UseWorkbenchSidebarViewPlacementDropZoneOptions,
+  WorkbenchSidebarViewPlacementDropZoneProps,
+} from './useWorkbenchSidebarViewPlacementDropZone';
+export { useWorkbenchSidebarActionBarDnd } from './useWorkbenchSidebarActionBarDnd';
+export type {
+  UseWorkbenchSidebarActionBarDndOptions,
+  UseWorkbenchSidebarActionBarDndResult,
+  WorkbenchSidebarActionBarDropTarget,
+  WorkbenchSidebarActionBarItemDragHandlers,
+} from './useWorkbenchSidebarActionBarDnd';
 export type { ActivityBarItem, ActivityBarProps } from './ActivityBar';
+export { WorkbenchArtifactModeControls, WorkbenchArtifactShell } from './ArtifactShell';
+export type {
+  WorkbenchArtifactDescriptor,
+  WorkbenchArtifactMode,
+  WorkbenchArtifactShellProps,
+} from './ArtifactShell';
 export { SplitView } from './SplitView';
-export type { SplitViewProps } from './SplitView';
+export type { SplitViewLayoutMode, SplitViewProps } from './SplitView';
 export { StatusBar, StatusBarItem, StatusBarSection } from './StatusBar';
 export type {
   StatusBarItemModel,
@@ -13,3 +42,105 @@ export type {
 } from './StatusBar';
 export { WorkbenchShell } from './WorkbenchShell';
 export type { WorkbenchShellProps } from './WorkbenchShell';
+export {
+  createWorkbenchEditorTabsFromViewModel,
+  createWorkbenchShellActivityBarFromViewModel,
+  createWorkbenchViewSidebarFromViewModel,
+  createWorkbenchViewSidebarItemsFromViewModel,
+} from './shellViewModel';
+export type {
+  CreateWorkbenchEditorTabsFromViewModelInput,
+  CreateWorkbenchShellActivityBarFromViewModelInput,
+  CreateWorkbenchViewSidebarFromViewModelInput,
+  CreateWorkbenchViewSidebarItemsFromViewModelInput,
+  WorkbenchShellActivityBarViewModelProps,
+  WorkbenchViewSidebarViewModelProps,
+} from './shellViewModel';
+export { WorkbenchViewEditor } from './WorkbenchViewEditor';
+export type {
+  WorkbenchViewEditorDataAttributes,
+  WorkbenchViewEditorEmptyState,
+  WorkbenchViewEditorEmptyStateProps,
+  WorkbenchViewEditorEmptyStateSurfaceProps,
+  WorkbenchViewEditorProps,
+} from './WorkbenchViewEditor';
+export { WorkbenchEditorTabs } from './WorkbenchEditorTabs';
+export type { WorkbenchEditorTabsProps } from './WorkbenchEditorTabs';
+export {
+  createWorkbenchStandaloneEditorTabCommandContext,
+  createWorkbenchStandaloneEditorTabContextMenuItems,
+  isWorkbenchEditorTabClosable,
+} from './editorTabContextMenu';
+export type {
+  CreateWorkbenchStandaloneEditorTabCommandContextInput,
+  WorkbenchStandaloneEditorTabLike,
+} from './editorTabContextMenu';
+export { useWorkbenchEditorTabContextMenu } from './useWorkbenchEditorTabContextMenu';
+export type {
+  UseWorkbenchEditorTabContextMenuOptions,
+  UseWorkbenchEditorTabContextMenuResult,
+} from './useWorkbenchEditorTabContextMenu';
+export { WorkbenchViewSidebar } from './WorkbenchViewSidebar';
+export type { WorkbenchViewSidebarItem, WorkbenchViewSidebarProps } from './WorkbenchViewSidebar';
+export {
+  WorkbenchDesktopTitleBar,
+  WorkbenchDesktopWindowControls,
+} from './WorkbenchDesktopTitleBar';
+export type {
+  WorkbenchDesktopTitleBarProps,
+  WorkbenchDesktopWindowControlsProps,
+} from './WorkbenchDesktopTitleBar';
+export { WorkbenchPlatformProvider, useWorkbenchHostPlatform } from './WorkbenchPlatformContext';
+export type { WorkbenchPlatformProviderProps } from './WorkbenchPlatformContext';
+export {
+  resolveWorkbenchHostPlatform,
+  resolveWorkbenchWindowChromeDataAttributes,
+} from './workbenchPlatformChrome';
+export type { WorkbenchHostPlatform, WorkbenchWindowChromeMode } from './workbenchPlatformChrome';
+export {
+  WorkbenchWindowChromeControls,
+  shouldUseDarwinPlatformChrome,
+} from './WorkbenchWindowChromeControls';
+export type { WorkbenchWindowChromeControlsProps } from './WorkbenchWindowChromeControls';
+export { useWorkbenchModalViewState } from './workbenchModalViewState';
+export type {
+  UseWorkbenchModalViewStateOptions,
+  WorkbenchModalViewState,
+} from './workbenchModalViewState';
+export {
+  WorkbenchSidebarLayoutProvider,
+  useWorkbenchSidebarLayout,
+} from './useWorkbenchSidebarLayout';
+export type { WorkbenchSidebarLayoutProviderProps } from './useWorkbenchSidebarLayout';
+export type { WorkbenchSidebarLayoutContextValue } from './workbenchSidebarLayoutContext';
+export {
+  createWorkbenchStandaloneShellStateSnapshot,
+  useWorkbenchStandaloneShellContext,
+  type WorkbenchStandaloneShellStateChange,
+  type WorkbenchStandaloneShellStateChangeKind,
+  type WorkbenchStandaloneShellStateSnapshot,
+} from './workbenchStandaloneShellReactContext';
+export { useWorkbenchStandaloneShellStateSync } from './useWorkbenchStandaloneShellStateSync';
+export { WorkbenchShellTitleBarLayoutControls } from './WorkbenchShellTitleBarLayoutControls';
+export type { WorkbenchShellTitleBarLayoutControlsProps } from './WorkbenchShellTitleBarLayoutControls';
+export { useWorkbenchViewRouteState } from './workbenchViewRouteState';
+export type {
+  UseWorkbenchViewRouteStateOptions,
+  WorkbenchViewRouteBrowserWindow,
+  WorkbenchViewRouteCommitMode,
+  WorkbenchViewRouteState,
+} from './workbenchViewRouteState';
+export {
+  initializeWorkbenchShellState,
+  useWorkbenchShellState,
+  workbenchShellStateReducer,
+  DEFAULT_PRIMARY_SIDEBAR_SIZE_PX,
+  MAX_PRIMARY_SIDEBAR_SIZE_PX,
+  MIN_PRIMARY_SIDEBAR_SIZE_PX,
+} from './shellState';
+export type {
+  UseWorkbenchShellStateResult,
+  WorkbenchShellAction,
+  WorkbenchShellInitialState,
+  WorkbenchShellState,
+} from './shellState';

package/src/workbench/shellPresets.ts

@@ -0,0 +1,36 @@
+export interface WorkbenchShellPresetManifestEntry<TId extends string = string> {
+  readonly id: TId;
+  readonly label: string;
+}
+
+/** One manifest entry per CSS preset file under `@workbench-kit/tokens/src/shell/`. */
+export const SHELL_PRESET_MANIFEST = [
+  { id: 'default', label: 'Default' },
+  { id: 'workbench', label: 'Compact' },
+  { id: 'airy', label: 'Comfortable' },
+] as const satisfies readonly WorkbenchShellPresetManifestEntry[];
+
+export type ShellPresetId = (typeof SHELL_PRESET_MANIFEST)[number]['id'];
+
+export const DEFAULT_SHELL_PRESET: ShellPresetId = 'default';
+
+export interface WorkbenchShellPresetOption<TId extends string = string> {
+  id: TId;
+  label: string;
+}
+
+export const SHELL_PRESET_OPTIONS: WorkbenchShellPresetOption<ShellPresetId>[] =
+  SHELL_PRESET_MANIFEST.map((entry) => ({ id: entry.id, label: entry.label }));
+
+const SHELL_PRESET_IDS = new Set<string>(SHELL_PRESET_MANIFEST.map((entry) => entry.id));
+
+export function isShellPresetId(value: string | null | undefined): value is ShellPresetId {
+  return value != null && SHELL_PRESET_IDS.has(value);
+}
+
+/**
+ * Applies shell density preset to a DOM root (typically `document.documentElement` or `.ide-root`).
+ */
+export function applyWorkbenchShellAttributes(root: HTMLElement, shellPreset: string): void {
+  root.dataset.shellPreset = shellPreset;
+}

package/src/workbench/shellState.ts

@@ -7,7 +7,7 @@ export interface WorkbenchShellInitialState<
   activeActivityId: TActivityId;
   isPrimarySidebarVisible?: boolean;
   isSettingsOpen?: boolean;
-  primarySidebarSizePercent?: number;
+  primarySidebarSizePx?: number;
   settingsCategoryId?: string;
   settingsScopeId?: string;
   settingsSearchValue?: string;
@@ -21,7 +21,7 @@ export interface WorkbenchShellState<
   activeActivityId: TActivityId;
   isPrimarySidebarVisible: boolean;
   isSettingsOpen: boolean;
-  primarySidebarSizePercent: number;
+  primarySidebarSizePx: number;
   settingsCategoryId: string;
   settingsScopeId: string;
   settingsSearchValue: string;
@@ -35,7 +35,7 @@ export type WorkbenchShellAction<
   | { activityId: TActivityId; type: 'activate-activity' }
   | { activityId: TActivityId; type: 'show-activity' }
   | { isOpen: boolean; type: 'set-settings-open' }
-  | { percent: number; type: 'set-primary-sidebar-size' }
+  | { sizePx: number; type: 'set-primary-sidebar-size' }
   | { settingsCategoryId: string; type: 'set-settings-category' }
   | { settingsScopeId: string; type: 'set-settings-scope' }
   | { settingsSearchValue: string; type: 'set-settings-search' }
@@ -53,7 +53,7 @@ export interface UseWorkbenchShellStateResult<
   closeSettings: () => void;
   dispatch: (action: WorkbenchShellAction<TActivityId, TTheme>) => void;
   openSettings: () => void;
-  setPrimarySidebarSizePercent: (percent: number) => void;
+  setPrimarySidebarSizePx: (sizePx: number) => void;
   setPrimarySidebarVisible: (isVisible: boolean) => void;
   setSettingsCategoryId: (settingsCategoryId: string) => void;
   setSettingsOpen: (isOpen: boolean) => void;
@@ -65,23 +65,20 @@ export interface UseWorkbenchShellStateResult<
   togglePrimarySidebar: () => void;
 }
 
-export const DEFAULT_PRIMARY_SIDEBAR_SIZE_PERCENT = 20;
-const MIN_PRIMARY_SIDEBAR_SIZE_PERCENT = 10;
-const MAX_PRIMARY_SIDEBAR_SIZE_PERCENT = 90;
+export const DEFAULT_PRIMARY_SIDEBAR_SIZE_PX = 260;
+export const MIN_PRIMARY_SIDEBAR_SIZE_PX = 200;
+export const MAX_PRIMARY_SIDEBAR_SIZE_PX = 480;
 
-function clampPrimarySidebarSizePercent(percent: number, fallback: number) {
-  if (!Number.isFinite(percent)) return fallback;
-  return Math.min(
-    MAX_PRIMARY_SIDEBAR_SIZE_PERCENT,
-    Math.max(MIN_PRIMARY_SIDEBAR_SIZE_PERCENT, percent),
-  );
+function clampPrimarySidebarSizePx(sizePx: number, fallback: number) {
+  if (!Number.isFinite(sizePx)) return fallback;
+  return Math.min(MAX_PRIMARY_SIDEBAR_SIZE_PX, Math.max(MIN_PRIMARY_SIDEBAR_SIZE_PX, sizePx));
 }
 
 export function initializeWorkbenchShellState<TActivityId extends string, TTheme extends string>({
   activeActivityId,
   isPrimarySidebarVisible = true,
   isSettingsOpen = false,
-  primarySidebarSizePercent = DEFAULT_PRIMARY_SIDEBAR_SIZE_PERCENT,
+  primarySidebarSizePx = DEFAULT_PRIMARY_SIDEBAR_SIZE_PX,
   settingsCategoryId = '',
   settingsScopeId = '',
   settingsSearchValue = '',
@@ -91,9 +88,9 @@ export function initializeWorkbenchShellState<TActivityId extends string, TTheme
     activeActivityId,
     isPrimarySidebarVisible,
     isSettingsOpen,
-    primarySidebarSizePercent: clampPrimarySidebarSizePercent(
-      primarySidebarSizePercent,
-      DEFAULT_PRIMARY_SIDEBAR_SIZE_PERCENT,
+    primarySidebarSizePx: clampPrimarySidebarSizePx(
+      primarySidebarSizePx,
+      DEFAULT_PRIMARY_SIDEBAR_SIZE_PX,
     ),
     settingsCategoryId,
     settingsScopeId,
@@ -136,10 +133,7 @@ export function workbenchShellStateReducer<TActivityId extends string, TTheme ex
   if (action.type === 'set-primary-sidebar-size') {
     return {
       ...state,
-      primarySidebarSizePercent: clampPrimarySidebarSizePercent(
-        action.percent,
-        state.primarySidebarSizePercent,
-      ),
+      primarySidebarSizePx: clampPrimarySidebarSizePx(action.sizePx, state.primarySidebarSizePx),
     };
   }
 
@@ -184,8 +178,7 @@ export function useWorkbenchShellState<TActivityId extends string, TTheme extend
     closeSettings: () => dispatch({ type: 'close-settings' }),
     dispatch,
     openSettings: () => dispatch({ type: 'open-settings' }),
-    setPrimarySidebarSizePercent: (percent) =>
-      dispatch({ percent, type: 'set-primary-sidebar-size' }),
+    setPrimarySidebarSizePx: (sizePx) => dispatch({ sizePx, type: 'set-primary-sidebar-size' }),
     setPrimarySidebarVisible: (isVisible) =>
       dispatch({ isVisible, type: 'set-primary-sidebar-visible' }),
     setSettingsCategoryId: (settingsCategoryId) =>

package/src/workbench/shellViewModel.ts

@@ -0,0 +1,160 @@
+import type { ReactNode } from 'react';
+import type {
+  WorkbenchViewActivityBarItem,
+  WorkbenchViewActivityBarModel,
+  WorkbenchViewEditorTabItem,
+} from '@workbench-kit/platform';
+
+import type { EditorTab } from '../primitives/workbench-editor';
+import type { ActivityBarItem } from './ActivityBar';
+import type { WorkbenchShellProps } from './WorkbenchShell';
+import type { WorkbenchViewSidebarItem, WorkbenchViewSidebarProps } from './WorkbenchViewSidebar';
+
+export type WorkbenchShellActivityBarViewModelProps = Omit<
+  WorkbenchShellProps['activityBar'],
+  'items' | 'secondaryItems'
+>;
+
+export type WorkbenchViewSidebarViewModelProps<TViewId extends string, TIcon = unknown> = Omit<
+  WorkbenchViewSidebarProps<TViewId, TIcon>,
+  'items'
+>;
+
+export interface CreateWorkbenchShellActivityBarFromViewModelInput<
+  TViewId extends string,
+  TIcon = unknown,
+> {
+  readonly activeId?: TViewId | undefined;
+  readonly activityBarProps?: WorkbenchShellActivityBarViewModelProps | undefined;
+  readonly model: WorkbenchViewActivityBarModel<TViewId, TIcon>;
+  readonly onSelect?:
+    ((viewId: TViewId, item: WorkbenchViewActivityBarItem<TViewId, TIcon>) => void) | undefined;
+  readonly renderIcon: (
+    icon: TIcon,
+    item: WorkbenchViewActivityBarItem<TViewId, TIcon>,
+  ) => ReactNode;
+}
+
+export interface CreateWorkbenchEditorTabsFromViewModelInput<
+  TViewId extends string,
+  TIcon extends EditorTab['icon'] = EditorTab['icon'],
+> {
+  readonly items: ReadonlyArray<WorkbenchViewEditorTabItem<TViewId, TIcon>>;
+  readonly resolveTitle?:
+    ((item: WorkbenchViewEditorTabItem<TViewId, TIcon>) => string | undefined) | undefined;
+}
+
+export interface CreateWorkbenchViewSidebarItemsFromViewModelInput<
+  TViewId extends string,
+  TIcon = unknown,
+> {
+  readonly model: WorkbenchViewActivityBarModel<TViewId, TIcon>;
+}
+
+export interface CreateWorkbenchViewSidebarFromViewModelInput<
+  TViewId extends string,
+  TIcon = unknown,
+> extends WorkbenchViewSidebarViewModelProps<TViewId, TIcon> {
+  readonly model: WorkbenchViewActivityBarModel<TViewId, TIcon>;
+}
+
+export function createWorkbenchShellActivityBarFromViewModel<
+  TViewId extends string,
+  TIcon = unknown,
+>({
+  activeId,
+  activityBarProps,
+  model,
+  onSelect,
+  renderIcon,
+}: CreateWorkbenchShellActivityBarFromViewModelInput<
+  TViewId,
+  TIcon
+>): WorkbenchShellProps['activityBar'] {
+  const sourceItemsById = new Map<string, WorkbenchViewActivityBarItem<TViewId, TIcon>>();
+  const { onItemActivate, ...restActivityBarProps } = activityBarProps ?? {};
+
+  const toActivityBarItem = (
+    item: WorkbenchViewActivityBarItem<TViewId, TIcon>,
+  ): ActivityBarItem => {
+    sourceItemsById.set(item.id, item);
+
+    return {
+      active: item.id === activeId,
+      icon: renderIcon(item.icon, item),
+      id: item.id,
+      label: item.label,
+      title: item.label,
+    };
+  };
+
+  const items = model.items.map(toActivityBarItem);
+  const secondaryItems = model.footerItems.map(toActivityBarItem);
+  const activityBar: WorkbenchShellProps['activityBar'] = {
+    ...restActivityBarProps,
+    items,
+    secondaryItems,
+  };
+
+  if (onItemActivate !== undefined || onSelect !== undefined) {
+    activityBar.onItemActivate = (item) => {
+      onItemActivate?.(item);
+
+      const sourceItem = sourceItemsById.get(item.id);
+      if (sourceItem !== undefined) {
+        onSelect?.(sourceItem.id, sourceItem);
+      }
+    };
+  }
+
+  return activityBar;
+}
+
+export function createWorkbenchEditorTabsFromViewModel<
+  TViewId extends string,
+  TIcon extends EditorTab['icon'] = EditorTab['icon'],
+>({
+  items,
+  resolveTitle,
+}: CreateWorkbenchEditorTabsFromViewModelInput<TViewId, TIcon>): ReadonlyArray<EditorTab> {
+  return items.map((item): EditorTab => {
+    const title = resolveTitle?.(item) ?? item.label;
+
+    return {
+      closable: item.closable,
+      dirty: item.dirty,
+      icon: item.icon,
+      id: item.id,
+      label: item.label,
+      title,
+    };
+  });
+}
+
+export function createWorkbenchViewSidebarItemsFromViewModel<
+  TViewId extends string,
+  TIcon = unknown,
+>({
+  model,
+}: CreateWorkbenchViewSidebarItemsFromViewModelInput<TViewId, TIcon>): ReadonlyArray<
+  WorkbenchViewSidebarItem<TViewId, TIcon>
+> {
+  return [...model.items, ...model.footerItems].map((item) => ({
+    icon: item.icon,
+    id: item.id,
+    label: item.label,
+  }));
+}
+
+export function createWorkbenchViewSidebarFromViewModel<TViewId extends string, TIcon = unknown>({
+  model,
+  ...sidebarProps
+}: CreateWorkbenchViewSidebarFromViewModelInput<TViewId, TIcon>): WorkbenchViewSidebarProps<
+  TViewId,
+  TIcon
+> {
+  return {
+    ...sidebarProps,
+    items: createWorkbenchViewSidebarItemsFromViewModel({ model }),
+  };
+}

package/src/workbench/sidebarViewPlacementDnd.ts

@@ -0,0 +1,61 @@
+/** Shared drag payload for moving a view container between sidebar slots (activity bar or action bar). */
+export const WORKBENCH_SIDEBAR_VIEW_PLACEMENT_DRAG_DATA_TYPE =
+  'application/x-workbench-activity-bar-item';
+
+const WORKBENCH_SIDEBAR_VIEW_PLACEMENT_TEXT_PREFIX = 'workbench-sidebar-view:';
+
+let activeSidebarViewPlacementDragViewId: string | null = null;
+
+const dragSessionEndListeners = new Set<() => void>();
+
+function notifyWorkbenchSidebarViewPlacementDragSessionEnd(): void {
+  for (const listener of dragSessionEndListeners) {
+    listener();
+  }
+}
+
+export function subscribeWorkbenchSidebarViewPlacementDragSessionEnd(
+  listener: () => void,
+): () => void {
+  dragSessionEndListeners.add(listener);
+  return () => {
+    dragSessionEndListeners.delete(listener);
+  };
+}
+
+export function resetWorkbenchSidebarViewPlacementDragSession(): void {
+  activeSidebarViewPlacementDragViewId = null;
+  notifyWorkbenchSidebarViewPlacementDragSessionEnd();
+}
+
+export function hasWorkbenchSidebarViewPlacementDrag(dataTransfer: DataTransfer): boolean {
+  if (activeSidebarViewPlacementDragViewId !== null) {
+    return true;
+  }
+
+  return [...dataTransfer.types].includes(WORKBENCH_SIDEBAR_VIEW_PLACEMENT_DRAG_DATA_TYPE);
+}
+
+export function writeWorkbenchSidebarViewPlacementDrag(
+  dataTransfer: DataTransfer,
+  viewId: string,
+): void {
+  activeSidebarViewPlacementDragViewId = viewId;
+  dataTransfer.effectAllowed = 'move';
+  dataTransfer.setData(WORKBENCH_SIDEBAR_VIEW_PLACEMENT_DRAG_DATA_TYPE, viewId);
+  dataTransfer.setData('text/plain', `${WORKBENCH_SIDEBAR_VIEW_PLACEMENT_TEXT_PREFIX}${viewId}`);
+}
+
+export function readWorkbenchSidebarViewPlacementDrag(dataTransfer: DataTransfer): string {
+  const payload = dataTransfer.getData(WORKBENCH_SIDEBAR_VIEW_PLACEMENT_DRAG_DATA_TYPE);
+  if (payload.length > 0) {
+    return payload;
+  }
+
+  const plainTextPayload = dataTransfer.getData('text/plain');
+  if (plainTextPayload.startsWith(WORKBENCH_SIDEBAR_VIEW_PLACEMENT_TEXT_PREFIX)) {
+    return plainTextPayload.slice(WORKBENCH_SIDEBAR_VIEW_PLACEMENT_TEXT_PREFIX.length);
+  }
+
+  return activeSidebarViewPlacementDragViewId ?? '';
+}

package/src/workbench/standalone.ts

@@ -72,9 +72,9 @@ export interface WorkbenchShellContract<TActivityId extends string = string> {
 export interface WorkbenchStandaloneEntryState<TActivityId extends string = string> {
   activeActivityId: TActivityId;
   isPrimarySidebarVisible: boolean;
-  primarySidebarSizePercent: number;
-  primarySidebarMinPercent?: number;
-  primarySidebarMaxPercent?: number;
+  primarySidebarSizePx: number;
+  primarySidebarMinPx?: number;
+  primarySidebarMaxPx?: number;
   theme: WorkbenchTheme;
   isSettingsOpen?: boolean;
   settingsCategoryId?: string;
@@ -86,12 +86,12 @@ export interface WorkbenchStandaloneEntryState<TActivityId extends string = stri
 
 export interface WorkbenchStandaloneBootstrap<TActivityId extends string = string> {
   contract: WorkbenchShellContract<TActivityId>;
-  initialFiles: readonly WorkspaceFile[];
-  workspace: WorkbenchWorkspaceController;
-  chat: WorkbenchChatController;
-  patch: WorkbenchPatchController;
-  save: WorkbenchSaveController;
-  status: WorkbenchStatusController;
+  initialFiles?: readonly WorkspaceFile[];
+  workspace?: WorkbenchWorkspaceController;
+  chat?: WorkbenchChatController;
+  patch?: WorkbenchPatchController;
+  save?: WorkbenchSaveController;
+  status?: WorkbenchStatusController;
   initialState?: Partial<WorkbenchStandaloneEntryState<TActivityId>>;
 }
 

package/src/workbench/status.ts

@@ -3,18 +3,14 @@ export type WorkbenchStatus =
   | 'running'
   | 'completed'
   | 'failed'
+  | 'warning'
   | 'waiting'
   | 'cancelled'
   | 'disabled'
   | 'unavailable';
 
 export type WorkbenchStatusVariant =
-  | 'accent'
-  | 'danger'
-  | 'muted'
-  | 'neutral'
-  | 'success'
-  | 'warning';
+  'accent' | 'danger' | 'muted' | 'neutral' | 'success' | 'warning';
 
 export interface WorkbenchStatusDescriptor {
   busy: boolean;
@@ -58,6 +54,14 @@ const workbenchStatusDescriptors: Record<WorkbenchStatus, WorkbenchStatusDescrip
     unavailable: false,
     variant: 'danger',
   },
+  warning: {
+    busy: false,
+    disabled: false,
+    label: 'Warning',
+    status: 'warning',
+    unavailable: false,
+    variant: 'warning',
+  },
   idle: {
     busy: false,
     disabled: false,

package/src/workbench/theme.ts

@@ -6,12 +6,18 @@ export type ResolvedWorkbenchTheme = 'dark' | 'light';
 const LIGHT_QUERY = '(prefers-color-scheme: light)';
 
 function getSystemTheme(): ResolvedWorkbenchTheme {
-  if (typeof window === 'undefined') return 'dark';
+  if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') {
+    return 'dark';
+  }
+
   return window.matchMedia(LIGHT_QUERY).matches ? 'light' : 'dark';
 }
 
 function subscribeToSystemTheme(onChange: () => void): () => void {
-  if (typeof window === 'undefined') return () => undefined;
+  if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') {
+    return () => undefined;
+  }
+
   const mediaQuery = window.matchMedia(LIGHT_QUERY);
   mediaQuery.addEventListener('change', onChange);
   return () => mediaQuery.removeEventListener('change', onChange);