@pstdio/workbench 0.2.1 → 0.4.0

package/dist/core.d.ts

@@ -1,1885 +0,0 @@
-import { ComponentType } from 'react';
-import { NamedSet } from 'zustand/middleware';
-import { ReactNode } from 'react';
-import { StoreApi } from 'zustand/vanilla';
-
-declare type AnchorCandidates = "global" | "scoped";
-
-export declare type AnchorId = "primary" | "secondary" | "attached";
-
-declare type AnchorPersistence = "primary" | "derived" | "detached";
-
-export declare type AnchorReadId = "primary" | "attached";
-
-export declare type AnchorReconcileAction = {
-    area: WorkbenchArea;
-    action: "keep" | "clear";
-};
-
-declare interface AnchorSurface {
-    role: "anchor";
-    anchor: AnchorId;
-    persistence: AnchorPersistence;
-    candidates: AnchorCandidates;
-}
-
-export declare interface AttributeDescriptor {
-    id: string;
-    label: string;
-    type: AttributeType;
-    filterable?: boolean;
-    groupable?: boolean;
-    sortable?: boolean;
-    displayable?: boolean;
-    editable?: boolean;
-    display?: AttributeDisplayDescriptor;
-    render?: (value: unknown, row: DataRendererRow) => ReactNode;
-    compare?: (a: unknown, b: unknown) => number;
-}
-
-export declare type AttributeDisplayDescriptor = {
-    kind: "workspace-badge";
-    itemsAttributeId: string;
-};
-
-export declare type AttributeKind = AttributeType["kind"];
-
-/**
- * Reactive source for an entire attribute schema. Lets a contribution
- * add/remove/edit attributes at runtime without re-registering.
- */
-export declare interface AttributesSource {
-    subscribe: (listener: () => void) => () => void;
-    getSnapshot: () => AttributeDescriptor[];
-}
-
-export declare type AttributeType = {
-    kind: "enum";
-    options: EnumOptions;
-} | {
-    kind: "enum-multi";
-    options: EnumOptions;
-} | {
-    kind: "string";
-} | {
-    kind: "date";
-} | {
-    kind: "number";
-} | {
-    kind: "user";
-};
-
-export declare interface BoardColumnAction {
-    id: string;
-    label: string;
-    icon: ComponentType<{
-        size?: number | string;
-    }>;
-}
-
-/** Board-column behavior and menu configuration for a resolved column group. */
-export declare interface BoardColumnConfig {
-    /** Color palette token used for the column header and group badges. */
-    color?: string;
-    canDragIn?: boolean;
-    canDragOut?: boolean;
-    canCreate?: boolean;
-    actions?: BoardColumnAction[];
-}
-
-declare interface ChromeSurface {
-    role: "chrome";
-}
-
-/**
- * A data-driven list of items, each opening a contributor-supplied editor. The
- * framework knows nothing about what an item is — it only calls these hooks.
- */
-export declare interface CollectionSettingsPanel<TItem = unknown> extends SettingsPanelBase {
-    kind: "collection";
-    items(): TItem[] | Promise<TItem[]>;
-    itemId(item: TItem): string;
-    itemLabel(item: TItem): string;
-    itemIcon?(item: TItem): string | undefined;
-    groupBy?: SettingsCollectionGroupBy<TItem>;
-    renderItem(item: TItem, input: WorkbenchWidgetRenderInput): unknown;
-    actions?: SettingsAction[];
-}
-
-export declare interface Command {
-    id: string;
-    label: string;
-    category?: string;
-    description?: string;
-    icon?: string;
-    when?: string;
-    params?: CommandParamSchema;
-}
-
-export declare interface CommandHandler<TArgs = unknown, TResult = unknown> {
-    execute(args: TArgs, context?: WorkbenchCommandExecutionContext): TResult | Promise<TResult>;
-    isEnabled?(args: TArgs): boolean;
-    isVisible?(args: TArgs): boolean;
-    isToggled?(args: TArgs): boolean;
-}
-
-export declare interface CommandPaletteResourceProvider {
-    id: string;
-    title: string;
-    refreshEventIds?: string[];
-    query(context: CommandPaletteResourceQueryContext): Promise<readonly CommandPaletteResourceResult[]>;
-}
-
-export declare interface CommandPaletteResourceProviderResult {
-    providerId: string;
-    title: string;
-    results: readonly CommandPaletteResourceResult[];
-}
-
-export declare interface CommandPaletteResourceQueryContext {
-    query: string;
-    limit: number;
-}
-
-export declare interface CommandPaletteResourceRegistry {
-    store: WorkbenchStore<CommandPaletteResourceRegistryStoreState>;
-    registerProvider(provider: CommandPaletteResourceProvider): Disposable_2;
-    listProviders(): CommandPaletteResourceProvider[];
-    queryProviders(context: CommandPaletteResourceQueryContext): Promise<CommandPaletteResourceProviderResult[]>;
-    refresh(): void;
-}
-
-declare interface CommandPaletteResourceRegistryStoreState {
-    providers: Record<string, CommandPaletteResourceProvider>;
-    refreshToken: number;
-}
-
-export declare interface CommandPaletteResourceResult {
-    id: string;
-    label: string;
-    description?: string;
-    icon?: string;
-    keywords?: string[];
-    group?: string;
-    activate(): void | Promise<void>;
-}
-
-export declare interface CommandParamDescriptor {
-    type: string;
-    label?: string;
-    description?: string;
-    required?: boolean;
-    defaultValue?: unknown;
-    options?: CommandParamOption[];
-    templateType?: string;
-    resourceType?: string;
-    metadata?: Record<string, unknown>;
-}
-
-export declare interface CommandParamOption {
-    label: string;
-    value: string;
-}
-
-export declare type CommandParamSchema = Record<string, CommandParamDescriptor>;
-
-export declare interface CommandRegistry {
-    store: WorkbenchStore<CommandRegistryStoreState>;
-    registerCommand<TArgs = unknown, TResult = unknown>(command: Command, handler: CommandHandler<TArgs, TResult>, metadata?: ContributionMetadata): Disposable_2;
-    getCommand(id: string): RegisteredCommand | undefined;
-    listCommands(): RegisteredCommand[];
-    isCommandEnabled(id: string, args?: unknown): boolean;
-    isCommandVisible(id: string, args?: unknown): boolean;
-    isCommandToggled(id: string, args?: unknown): boolean;
-    executeCommand(id: string, args?: unknown, context?: WorkbenchCommandExecutionContext): Promise<unknown>;
-    onDidExecuteError(listener: WorkbenchCommandExecutionErrorListener): Disposable_2;
-}
-
-declare interface CommandRegistryStoreState {
-    commands: Record<string, RegisteredCommand>;
-}
-
-export declare interface ContextKeyScope extends Disposable_2 {
-    ownerId: string;
-    set(key: string, value: ContextKeyValue): void;
-    get(key: string): ContextKeyValue;
-    delete(key: string): void;
-}
-
-export declare interface ContextKeyService {
-    store: WorkbenchStore<ContextKeyStoreState>;
-    set(key: string, value: ContextKeyValue): void;
-    get(key: string): ContextKeyValue;
-    delete(key: string): void;
-    createScope(ownerId: string): ContextKeyScope;
-    deleteOwner(ownerId: string): void;
-    snapshot(): Record<string, ContextKeyValue>;
-    matches(expression?: string): boolean;
-}
-
-declare interface ContextKeyStoreState {
-    values: Record<string, ContextKeyValue>;
-}
-
-export declare type ContextKeyValue = boolean | number | string | undefined;
-
-export declare interface ContributionMetadata {
-    source?: ContributionSource;
-    ownerId?: string;
-    priority?: number;
-}
-
-export declare type ContributionSource = "module" | "extension";
-
-export declare interface ControlsApplyInput {
-    values: Record<string, unknown>;
-    resource?: ResourceRef;
-}
-
-export declare interface ControlsQueryResult {
-    params?: unknown[];
-    groups?: unknown[];
-    values?: Record<string, unknown>;
-    readOnly?: boolean;
-}
-
-declare type ControlsRendererArea = "main-right" | "secondary" | "overlay";
-
-export declare interface ControlsRendererContribution {
-    id: string;
-    title: string;
-    resourceKind?: string;
-    emptyTitle?: string;
-    emptyDescription?: string;
-    layout?: ControlsRendererLayout;
-    defaultValues?: Record<string, unknown>;
-    /** Load the control declarations + current values for the active resource. */
-    executeQuery(resource?: ResourceRef): Promise<ControlsQueryResult> | ControlsQueryResult;
-    /** Live-save a single control edit. Omit for explicit-apply or read-only panels. */
-    updateValue?(input: ControlsUpdateValueInput): Promise<void> | void;
-    /** Commit the full value map from a sticky footer. */
-    apply?(input: ControlsApplyInput): Promise<void> | void;
-    /** Reset some or all controls to their defaults. */
-    reset?(input: ControlsResetInput): Promise<void> | void;
-    subscribe?: (listener: () => void) => Disposable_2 | (() => void);
-}
-
-export declare type ControlsRendererImplementation = (input: WorkbenchWidgetRenderInput & {
-    controlsRendererId: string;
-}) => unknown;
-
-export declare interface ControlsRendererLayout {
-    area?: ControlsRendererArea;
-    defaultPx?: number;
-    minPx?: number;
-    maxPx?: number;
-}
-
-export declare interface ControlsRendererRefreshEvent {
-    controlsRendererId: string;
-}
-
-declare type ControlsRendererRefreshListener = (event: ControlsRendererRefreshEvent) => void;
-
-export declare interface ControlsRendererRegistry {
-    controlsStore: WorkbenchStore<ControlsRendererStoreState>;
-    registerControlsRenderer(contribution: ControlsRendererContribution, metadata?: ContributionMetadata): Disposable_2;
-    setControlsRendererImplementation(impl: ControlsRendererImplementation): void;
-    getControlsRenderer(id: string): RegisteredControlsRendererContribution | undefined;
-    listControlsRenderers(): RegisteredControlsRendererContribution[];
-    refreshControlsRenderer(id: string): void;
-    onDidRefreshControlsRenderer(listener: ControlsRendererRefreshListener): Disposable_2;
-}
-
-export declare interface ControlsRendererStoreState {
-    renderers: Record<string, RegisteredControlsRendererContribution>;
-}
-
-export declare interface ControlsResetInput {
-    controlIds?: string[];
-    resource?: ResourceRef;
-}
-
-export declare interface ControlsUpdateValueInput {
-    controlId: string;
-    value: unknown;
-    values: Record<string, unknown>;
-    resource?: ResourceRef;
-}
-
-export declare const createCommandPaletteResourceRegistry: () => CommandPaletteResourceRegistry;
-
-export declare const createCommandRegistry: (input?: CreateCommandRegistryInput) => CommandRegistry;
-
-declare interface CreateCommandRegistryInput {
-    context?: ContextKeyService;
-}
-
-export declare const createContextKeyService: () => ContextKeyService;
-
-export declare const createControlsRendererRegistry: (input: CreateControlsRendererRegistryInput) => ControlsRendererRegistry;
-
-export declare interface CreateControlsRendererRegistryInput {
-    rendererRegistry: WorkbenchRendererRegistry;
-}
-
-export declare const createDataRendererRegistry: (input: CreateDataRendererRegistryInput) => DataRendererRegistry;
-
-export declare interface CreateDataRendererRegistryInput {
-    rendererRegistry: WorkbenchRendererRegistry;
-}
-
-export declare const createDefaultWorkbenchLayout: () => WorkbenchLayout;
-
-export declare const createFileIconThemeRegistry: () => FileIconThemeRegistry;
-
-export declare const createFileRendererRegistry: (input: CreateFileRendererRegistryInput) => FileRendererRegistry;
-
-export declare interface CreateFileRendererRegistryInput {
-    rendererRegistry: WorkbenchRendererRegistry;
-}
-
-export declare const createHistoryController: (input: CreateHistoryControllerInput) => HistoryController;
-
-export declare interface CreateHistoryControllerInput {
-    layout: LayoutModel;
-    modes?: Pick<WorkbenchModeRegistry, "getActiveModeId" | "getMode" | "onDidChangeActive" | "setActiveMode">;
-    resources: ResourceRegistry;
-    maxEntries?: number;
-}
-
-export declare const createKeybindingRegistry: (deps: KeybindingRegistryDeps) => KeybindingRegistry;
-
-export declare const createLayoutModel: (input?: CreateLayoutModelInput) => LayoutModel;
-
-export declare interface CreateLayoutModelInput {
-    persistence?: LayoutPersistenceAdapter;
-}
-
-export declare const createMenuRegistry: (deps: MenuRegistryDeps) => MenuRegistry;
-
-export declare const createNavigationRegistry: (input?: CreateNavigationRegistryInput) => NavigationRegistry;
-
-export declare interface CreateNavigationRegistryInput {
-    resolveDispatcher?(): NavigationDispatcherContext;
-}
-
-export declare const createNotificationRegistry: () => NotificationRegistry;
-
-export declare const createPreferenceRegistry: (input?: CreatePreferenceRegistryInput) => PreferenceRegistry;
-
-export declare interface CreatePreferenceRegistryInput {
-    persistence?: PreferencePersistenceAdapter;
-}
-
-export declare const createResourceRegistry: (input?: CreateResourceRegistryInput) => ResourceRegistry;
-
-export declare interface CreateResourceRegistryInput {
-    getPrimary?: () => ResourceRef | undefined;
-}
-
-export declare const createSettingsRegistry: () => SettingsRegistry;
-
-export declare const createThemeRegistry: () => ThemeRegistry;
-
-export declare const createTreeRendererRegistry: (input: CreateTreeRendererRegistryInput) => TreeRendererRegistry;
-
-export declare interface CreateTreeRendererRegistryInput {
-    rendererRegistry: WorkbenchRendererRegistry;
-    persistence?: TreeRendererPersistenceAdapter;
-}
-
-export declare const createWorkbenchBreadcrumbController: () => WorkbenchBreadcrumbController;
-
-export declare const createWorkbenchCommandPaletteController: (input?: CreateWorkbenchCommandPaletteControllerInput) => WorkbenchCommandPaletteController;
-
-export declare interface CreateWorkbenchCommandPaletteControllerInput {
-    initialOpen?: boolean;
-}
-
-export declare const createWorkbenchCore: (input?: CreateWorkbenchCoreInput) => WorkbenchCore;
-
-export declare interface CreateWorkbenchCoreInput {
-    isInScope?: (resource: ResourceRef, primary: ResourceRef | undefined) => boolean;
-    layoutPersistence?: LayoutPersistenceAdapter;
-    preferencePersistence?: PreferencePersistenceAdapter;
-    treePersistence?: TreeRendererPersistenceAdapter;
-    panelsPersistence?: WorkbenchPanelsPersistenceAdapter;
-    lastResourcePersistence?: LastResourcePersistenceAdapter;
-    initialSessionPanelMode?: WorkbenchSessionPanelMode;
-    renderers?: CreateWorkbenchRendererRegistryInput;
-}
-
-export declare const createWorkbenchFocusController: (input: CreateWorkbenchFocusControllerInput) => WorkbenchFocusController;
-
-export declare interface CreateWorkbenchFocusControllerInput {
-    context: ContextKeyService;
-}
-
-export declare const createWorkbenchLastResourceController: (input: CreateWorkbenchLastResourceControllerInput) => WorkbenchLastResourceController;
-
-export declare interface CreateWorkbenchLastResourceControllerInput {
-    persistence?: LastResourcePersistenceAdapter;
-    openResource(resource: ResourceRef): Promise<unknown>;
-}
-
-export declare const createWorkbenchModeRegistry: (input: CreateWorkbenchModeRegistryInput) => WorkbenchModeRegistry;
-
-declare interface CreateWorkbenchModeRegistryInput {
-    resolveContext(): WorkbenchModeActivationContext;
-}
-
-export declare const createWorkbenchPanelsController: (input?: CreateWorkbenchPanelsControllerInput) => WorkbenchPanelsController;
-
-export declare interface CreateWorkbenchPanelsControllerInput {
-    persistence?: WorkbenchPanelsPersistenceAdapter;
-}
-
-export declare const createWorkbenchRendererRegistry: (input?: CreateWorkbenchRendererRegistryInput) => WorkbenchRendererRegistry;
-
-export declare interface CreateWorkbenchRendererRegistryInput {
-    initialRenderers?: WorkbenchRendererRegistration[];
-    createHost?: () => HTMLElement;
-}
-
-export declare const createWorkbenchResourceContextValues: (resource: ResourceRef | undefined) => Record<string, ContextKeyValue>;
-
-export declare const createWorkbenchSelectionResourceMetadata: (resource: Pick<ResourceRef, "uri">) => {
-    "workbench.selectionResourceUri": string;
-};
-
-export declare const createWorkbenchSessionPanelController: (input?: CreateWorkbenchSessionPanelControllerInput) => WorkbenchSessionPanelController;
-
-export declare interface CreateWorkbenchSessionPanelControllerInput {
-    initialMode?: WorkbenchSessionPanelMode;
-}
-
-export declare const createWorkbenchStore: <TState>(input: CreateWorkbenchStoreInput<TState>) => InternalWorkbenchStore<TState>;
-
-export declare interface CreateWorkbenchStoreInput<TState> {
-    name?: string;
-    initialState: TState;
-}
-
-export declare const createWorkbenchTerminalController: () => WorkbenchTerminalController;
-
-/**
- * Renders its own page. `render` returns `unknown` so core stays React-free — the
- * React layer treats the result as a node, exactly like WorkbenchRendererRegistration.
- */
-export declare interface CustomSettingsPanel extends SettingsPanelBase {
-    kind: "custom";
-    render(input: WorkbenchWidgetRenderInput): unknown;
-}
-
-export declare interface DataRendererContribution<TRow extends DataRendererRow = DataRendererRow> {
-    id: string;
-    title: string;
-    resourceKind?: string;
-    /**
-     * Declarative attribute schema. The renderer dispatches filter / group /
-     * sort / display / inline-edit behavior on each descriptor's `type.kind`.
-     *
-     * Pass an `AttributesSource` ({ subscribe, getSnapshot }) instead of a
-     * static array to let the contribution mutate its schema at runtime —
-     * `WorkbenchDataView` subscribes so additions / removals / kind changes
-     * propagate live without re-registering the renderer.
-     */
-    attributes: AttributeDescriptor[] | AttributesSource;
-    /** Per-board-column overrides (color, drag/create rules, custom actions). */
-    getBoardColumnConfig?: (groupKey: string) => BoardColumnConfig;
-    hideToolbar?: boolean;
-    emptyTitle?: string;
-    emptyDescription?: string;
-    /** Initial settings/filters applied when the data renderer mounts. */
-    defaultSettings?: Partial<DataRendererSettings>;
-    defaultFilters?: DataRendererFilterState;
-    /**
-     * Data source. Receives the current display state so backends can paginate
-     * / filter / sort. The renderer re-applies filter / sort / group locally,
-     * so this can return unfiltered rows in simple cases.
-     */
-    executeQuery(state: DataRendererQueryState): Promise<TRow[]> | TRow[];
-    subscribe?: (listener: () => void) => Disposable_2 | (() => void);
-    /** Row interactions surfaced by the renderer (mirrored from <DataRenderer>). */
-    onRowClick?: (row: TRow) => void;
-    /** Per-row right-click context menu actions (mirrored from <DataRenderer>). */
-    getRowContextMenuActions?: (row: TRow) => ResourceContextAction[];
-    /**
-     * Fires for inline attribute edits AND for cross-column drag-to-reorder on
-     * the board (the renderer passes the grouping attribute id + the target
-     * column value).
-     */
-    onAttributeChange?: (rowId: string, attributeId: string, value: unknown) => Promise<void> | void;
-    /** Manual within-column reorder (only fires when ordering is manual). */
-    onReorder?: (rowId: string, beforeRowId?: string) => Promise<void> | void;
-    onCreateRow?: (columnId: string) => void;
-    onColumnAction?: (columnId: string, actionId: string) => Promise<void> | void;
-}
-
-export declare type DataRendererFilterState = Record<string, string[]>;
-
-export declare type DataRendererImplementation = (input: WorkbenchWidgetRenderInput & {
-    dataRendererId: string;
-}) => unknown;
-
-export declare interface DataRendererOrdering {
-    attributeId: string | typeof MANUAL_ORDERING;
-    direction: SortDirection;
-}
-
-export declare interface DataRendererQueryState {
-    settings: DataRendererSettings;
-    filters: DataRendererFilterState;
-}
-
-declare interface DataRendererRefreshEvent {
-    dataRendererId: string;
-}
-
-declare type DataRendererRefreshListener = (event: DataRendererRefreshEvent) => void;
-
-export declare interface DataRendererRegistry {
-    dataStore: WorkbenchStore<DataRendererStoreState>;
-    registerDataRenderer<TRow extends DataRendererRow = DataRendererRow>(contribution: DataRendererContribution<TRow>, metadata?: ContributionMetadata): Disposable_2;
-    setDataRendererImplementation(impl: DataRendererImplementation): void;
-    getDataRenderer(id: string): RegisteredDataRendererContribution | undefined;
-    listDataRenderers(): RegisteredDataRendererContribution[];
-    refreshDataRenderer(id: string): void;
-    onDidRefreshDataRenderer(listener: DataRendererRefreshListener): Disposable_2;
-}
-
-export declare interface DataRendererRow {
-    id: string;
-    title: string;
-    /**
-     * Optional navigation handle. When set, the renderer's default click handler
-     * routes through the contribution's onRowClick (which typically opens the
-     * resource via the workbench).
-     */
-    resource?: unknown;
-    attributes: Record<string, unknown>;
-}
-
-export declare interface DataRendererSettings {
-    viewMode: ViewMode;
-    columnGrouping: string | typeof NO_GROUPING;
-    rowGrouping: string | typeof NO_GROUPING;
-    ordering: DataRendererOrdering;
-    displayProperties: string[];
-}
-
-export declare interface DataRendererStoreState {
-    renderers: Record<string, RegisteredDataRendererContribution>;
-}
-
-declare interface Disposable_2 {
-    dispose(): void;
-}
-export { Disposable_2 as Disposable }
-
-export declare interface EnumOption {
-    value: string;
-    label: string;
-    color?: string;
-    icon?: string | null;
-}
-
-export declare type EnumOptions = EnumOption[] | EnumOptionsSource;
-
-/**
- * Reactive options source for enum / enum-multi attributes. Mirrors React's
- * useSyncExternalStore contract so a contribution can hand its options off as
- * a live collection instead of a frozen array.
- */
-export declare interface EnumOptionsSource {
-    subscribe: (listener: () => void) => () => void;
-    getSnapshot: () => EnumOption[];
-}
-
-/**
- * Core-owned contract for file icon theme registrations. Structurally identical
- * to @pstdio/ui's FileIconThemePreferenceOption; the React layer bridges the two
- * so core does not depend on UI package ownership.
- */
-export declare interface FileIconThemeFont {
-    fontFamily: string;
-    src: {
-        url: string;
-        format?: string;
-    }[];
-    weight?: string;
-    style?: string;
-}
-
-export declare interface FileIconThemePreferenceOption {
-    id: string;
-    title?: string;
-    definitions: Record<string, unknown>;
-    fileExtensions: Record<string, string>;
-    fileNames: Record<string, string>;
-    defaults: {
-        file?: string;
-        folder?: string;
-    };
-    fonts: FileIconThemeFont[];
-}
-
-export declare interface FileIconThemeRegistry {
-    store: WorkbenchStore<WorkbenchFileIconThemeStoreState>;
-    register(themes: readonly FileIconThemePreferenceOption[]): Disposable_2;
-    listThemes(): readonly FileIconThemePreferenceOption[];
-}
-
-export declare interface FileRendererContent {
-    fileName?: string;
-    mimeType?: string;
-    content?: string;
-    dataUrl?: string;
-    placeholder?: string;
-}
-
-export declare interface FileRendererContribution {
-    id: string;
-    title: string;
-    resourceKind?: string;
-    /** 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;
-}
-
-export declare type FileRendererImplementation = (input: WorkbenchWidgetRenderInput & {
-    fileRendererId: string;
-}) => unknown;
-
-declare interface FileRendererRefreshEvent {
-    fileRendererId: string;
-}
-
-declare type FileRendererRefreshListener = (event: FileRendererRefreshEvent) => void;
-
-export declare interface FileRendererRegistry {
-    fileRendererStore: WorkbenchStore<FileRendererStoreState>;
-    registerFileRenderer(contribution: FileRendererContribution, metadata?: ContributionMetadata): Disposable_2;
-    setFileRendererImplementation(impl: FileRendererImplementation): void;
-    getFileRenderer(id: string): RegisteredFileRendererContribution | undefined;
-    listFileRenderers(): RegisteredFileRendererContribution[];
-    refreshFileRenderer(id: string): void;
-    onDidRefreshFileRenderer(listener: FileRendererRefreshListener): Disposable_2;
-}
-
-export declare interface FileRendererStoreState {
-    renderers: Record<string, RegisteredFileRendererContribution>;
-}
-
-export declare const getAnchorResource: (layout: WorkbenchLayout, anchorId: AnchorId) => ResourceRef | undefined;
-
-export declare const getKeybindingSteps: (keybinding: KeybindingSequence) => string[];
-
-export declare const getSurface: (area: WorkbenchArea) => SurfaceDescriptor;
-
-export declare const getWorkbenchSelectionResourceUris: (resource: ResourceRef | undefined) => string[];
-
-export declare const headerLeadingMenuPath: (area: string) => MenuPath;
-
-export declare const headerTrailingMenuPath: (area: string) => MenuPath;
-
-export declare interface HistoryController {
-    store: WorkbenchStore<HistoryStoreState>;
-    goBack(): HistoryEntry | undefined;
-    goForward(): HistoryEntry | undefined;
-    goPrevious(): HistoryEntry | undefined;
-    recentlyClosed(): readonly HistoryEntry[];
-    reopenLastClosed(): HistoryEntry | undefined;
-    clear(): void;
-}
-
-export declare interface HistoryEntry {
-    entryId: string;
-    recordedAt: number;
-    kind: "resource" | "widget" | "mode";
-    modeId?: string;
-    resource?: ResourceRef;
-    widgetId?: string;
-    contributionId?: string;
-    title?: string;
-}
-
-export declare interface HistoryStoreState {
-    entries: readonly HistoryEntry[];
-    cursor: number;
-    recentlyClosed: readonly HistoryEntry[];
-}
-
-declare interface InternalWorkbenchStore<TState> extends WorkbenchStore<TState> {
-    setState: NamedSet<TState>;
-    api: StoreApi<TState>;
-}
-
-export declare interface Keybinding {
-    commandId: string;
-    keybinding: KeybindingSequence;
-    when?: string;
-    args?: unknown;
-}
-
-export declare interface KeybindingRegistry {
-    store: WorkbenchStore<KeybindingRegistryStoreState>;
-    registerKeybinding(keybinding: Keybinding, metadata?: ContributionMetadata): Disposable_2;
-    listKeybindings(): RegisteredKeybinding[];
-    listActiveKeybindings(): RegisteredKeybinding[];
-}
-
-declare interface KeybindingRegistryDeps {
-    commands: CommandRegistry;
-    context: ContextKeyService;
-}
-
-declare interface KeybindingRegistryStoreState {
-    keybindings: RegisteredKeybinding[];
-}
-
-export declare type KeybindingSequence = string | string[];
-
-export declare interface LastResourcePersistenceAdapter {
-    getLastResource(): ResourceRef | undefined;
-    setLastResource(resource: ResourceRef | undefined): void;
-}
-
-export declare interface LayoutModel {
-    store: WorkbenchStore<WorkbenchLayoutStoreState>;
-    registerPlaceholder(placeholder: PlaceholderContribution, metadata?: ContributionMetadata): {
-        dispose(): void;
-    };
-    registerWidget(widget: WidgetContribution, metadata?: ContributionMetadata): {
-        dispose(): void;
-    };
-    unregisterWidget(id: string, options?: {
-        removePlacements?: boolean;
-        persist?: boolean;
-    }): void;
-    getPlaceholder(areaId: WorkbenchArea): RegisteredPlaceholderContribution | undefined;
-    getWidget(id: string): RegisteredWidgetContribution | undefined;
-    getAreaSize(areaId: WorkbenchArea): WorkbenchAreaSize | undefined;
-    getAreaCollapsible(areaId: WorkbenchArea): boolean;
-    getAreaHeaderBorderBottom(areaId: WorkbenchArea): boolean;
-    setAreaVisible(areaId: WorkbenchArea, visible: boolean): void;
-    setAreaSize(areaId: WorkbenchArea, size: number): void;
-    listPlaceholders(): RegisteredPlaceholderContribution[];
-    listWidgets(): RegisteredWidgetContribution[];
-    openWidget(id: string, input?: OpenWidgetInput): WorkbenchWidgetPlacement;
-    updateWidgetPlacement(widgetId: string, input: OpenWidgetInput): WorkbenchWidgetPlacement;
-    activateWidget(widgetId: string): WorkbenchWidgetPlacement;
-    closeWidget(widgetId: string): WorkbenchWidgetPlacement | undefined;
-    removeWidgetPlacement(widgetId: string): WorkbenchWidgetPlacement | undefined;
-    clearArea(areaId: WorkbenchArea): void;
-    resetAreas(): void;
-    getLayout(): WorkbenchLayout;
-    restoreLayout(layout: WorkbenchLayout): void;
-    setPersistenceScope(scope: LayoutScope | undefined): void;
-    getPersistenceScope(): LayoutScope | undefined;
-    onDidChangePersistenceScope(listener: (scope: LayoutScope | undefined) => void): {
-        dispose(): void;
-    };
-}
-
-export declare interface LayoutPersistenceAdapter {
-    getLayout(scope?: LayoutScope): WorkbenchLayout | undefined;
-    setLayout(layout: WorkbenchLayout, scope?: LayoutScope): void;
-}
-
-export declare type LayoutScope = string;
-
-export declare const listAnchorAreas: () => ("status" | "secondary" | "main" | "nav" | "activity" | "left-header" | "left" | "main-header" | "main-left" | "main-right" | "secondary-header" | "overlay" | "floating-header" | "floating")[];
-
-export declare const listProjectionAreas: () => ("status" | "secondary" | "main" | "nav" | "activity" | "left-header" | "left" | "main-header" | "main-left" | "main-right" | "secondary-header" | "overlay" | "floating-header" | "floating")[];
-
-export declare const listProjectionsReading: (anchorId: AnchorReadId) => ("status" | "secondary" | "main" | "nav" | "activity" | "left-header" | "left" | "main-header" | "main-left" | "main-right" | "secondary-header" | "overlay" | "floating-header" | "floating")[];
-
-declare const MANUAL_ORDERING = "manual";
-
-export declare const matchesContextExpression: (values: Record<string, ContextKeyValue>, expression?: string) => boolean;
-
-export declare interface MenuItem {
-    commandId: string;
-    label?: string;
-    description?: string;
-    icon?: string;
-    iconSrc?: string;
-    overflowLabel?: string;
-    when?: string;
-    group?: string;
-    order?: number;
-    args?: unknown;
-    readOnly?: boolean;
-    /** Marks a menu action that navigates outside the app, rendered with a trailing external-link icon. */
-    external?: boolean;
-}
-
-export declare type MenuPath = readonly string[];
-
-export declare interface MenuRegistry {
-    menuStore: WorkbenchStore<MenuRegistryStoreState>;
-    registerMenuItem(path: MenuPath, item: MenuItem, metadata?: ContributionMetadata): Disposable_2;
-    listMenuItems(path: MenuPath): RegisteredMenuItem[];
-}
-
-declare interface MenuRegistryDeps {
-    commands: CommandRegistry;
-}
-
-declare interface MenuRegistryStoreState {
-    itemsByPath: Record<string, RegisteredMenuItem[]>;
-}
-
-export declare interface NavigationDispatcherContext {
-    canOpenResource?(resource: ResourceRef): boolean;
-    canOpenWidget?(widgetId: string): boolean;
-    canExecuteCommand?(commandId: string): boolean;
-    createCheckpoint?(): undefined | (() => void);
-    openResource(resource: ResourceRef, input?: OpenResourceInput): Promise<unknown>;
-    openWidget(widgetId: string, input?: OpenWidgetInput): unknown;
-    executeCommand(commandId: string, args?: unknown): Promise<unknown> | unknown;
-}
-
-export declare interface NavigationParser {
-    id: string;
-    priority?: number;
-    canParse(location: string): boolean;
-    parse(location: string): NavigationTarget;
-}
-
-export declare interface NavigationRegistry {
-    store: WorkbenchStore<NavigationRegistryStoreState>;
-    registerParser(parser: NavigationParser, metadata?: ContributionMetadata): Disposable_2;
-    listParsers(): RegisteredNavigationParser[];
-    resolveLocation(location: string): NavigationTarget;
-    openTarget(target: NavigationTarget): Promise<readonly unknown[]>;
-    navigate(location: string): Promise<readonly unknown[]>;
-    registerNavigator(navigator: ResourceNavigator, metadata?: ContributionMetadata): Disposable_2;
-    listNavigators(): RegisteredResourceNavigator[];
-    createHref(resource: ResourceRef): string;
-    navigateResource(resource: ResourceRef): Promise<unknown>;
-}
-
-declare interface NavigationRegistryStoreState {
-    parsers: Record<string, RegisteredNavigationParser>;
-    navigators: Record<string, RegisteredResourceNavigator>;
-}
-
-export declare type NavigationTarget = NavigationTargetItem | NavigationTargetCompound;
-
-export declare interface NavigationTargetCommand {
-    kind: "command";
-    commandId: string;
-    args?: unknown;
-}
-
-export declare interface NavigationTargetCompound {
-    kind: "compound";
-    targets: readonly NavigationTargetItem[];
-}
-
-export declare type NavigationTargetItem = NavigationTargetResource | NavigationTargetView | NavigationTargetCommand;
-
-export declare interface NavigationTargetResource {
-    kind: "resource";
-    resource: ResourceRef;
-    input?: OpenResourceInput;
-}
-
-export declare interface NavigationTargetView {
-    kind: "view";
-    widgetId: string;
-    input?: OpenWidgetInput;
-}
-
-declare const NO_GROUPING = "none";
-
-export declare interface NotificationRegistry {
-    store: WorkbenchStore<WorkbenchNotificationStoreState>;
-    show(notification: WorkbenchNotification, metadata?: ContributionMetadata): RegisteredWorkbenchNotification;
-    dismiss(id: string): boolean;
-    clear(): void;
-    listNotifications(): RegisteredWorkbenchNotification[];
-    subscribe(listener: WorkbenchNotificationListener): Disposable_2;
-}
-
-export declare interface OpenResourceInput {
-    replaceActive?: boolean;
-}
-
-declare interface OpenWidgetInput {
-    resource?: ResourceRef;
-    title?: string;
-    area?: WorkbenchArea;
-    ownerId?: string;
-    source?: ContributionSource;
-    pinned?: boolean;
-    closable?: boolean;
-    mountStrategy?: WidgetMountStrategy;
-    hiddenByDefault?: boolean;
-    replaceActive?: boolean;
-}
-
-export declare interface PersistedTreeRendererStates {
-    statesByTreeId: Record<string, TreeRendererState>;
-}
-
-export declare interface PersistedWorkbenchPanels {
-    openByAreaId: Record<string, boolean>;
-}
-
-export declare interface PlaceholderContribution {
-    id: string;
-    title: string;
-    area: WorkbenchArea;
-    rendererId: string;
-    areaSize?: WorkbenchAreaSize;
-    areaCollapsible?: boolean;
-    config?: unknown;
-    priority?: number;
-}
-
-export declare interface PreferencePersistenceAdapter {
-    getValue(name: string, scope: PreferenceScopeRef): PreferenceValue | undefined;
-    setValue(name: string, value: PreferenceValue, scope: PreferenceScopeRef): void;
-}
-
-export declare interface PreferencePropertySchema {
-    type: "boolean" | "number" | "string" | "array" | "object";
-    enum?: PreferenceValue[];
-    default?: PreferenceValue;
-    scope: PreferenceScope;
-    description?: string;
-}
-
-export declare interface PreferenceRegistry {
-    store: WorkbenchStore<PreferenceRegistryStoreState>;
-    registerSchema(schema: PreferenceSchemaContribution, metadata?: ContributionMetadata): Disposable_2;
-    getSchema(name: string): RegisteredPreferenceSchema | undefined;
-    setValue(name: string, value: PreferenceValue, scope: PreferenceScopeRef): void;
-    getValue(name: string, scope?: PreferenceScopeRef): PreferenceValue | undefined;
-}
-
-declare interface PreferenceRegistryStoreState {
-    schemas: Record<string, RegisteredPreferenceSchema>;
-}
-
-export declare interface PreferenceSchemaContribution {
-    properties: Record<string, PreferencePropertySchema>;
-}
-
-export declare type PreferenceScope = "default" | "user" | "project" | "repo" | "workspace" | "extension" | "session";
-
-export declare interface PreferenceScopeRef {
-    scope: PreferenceScope;
-    scopeId?: string;
-}
-
-export declare type PreferenceValue = boolean | number | string | string[] | number[] | boolean[] | Record<string, unknown>;
-
-declare interface ProjectionSurface {
-    role: "projection";
-    reads: AnchorReadId[];
-    navigator?: boolean;
-}
-
-export declare const reconcileAnchors: ({ layout, primary, isInScope }: ReconcileAnchorsInput) => AnchorReconcileAction[];
-
-export declare interface ReconcileAnchorsInput {
-    layout: WorkbenchLayout;
-    primary: ResourceRef | undefined;
-    isInScope: (resource: ResourceRef, primary: ResourceRef | undefined) => boolean;
-}
-
-export declare interface RegisteredCommand extends RegisteredContributionMetadata {
-    command: Command;
-    handler: CommandHandler;
-}
-
-export declare interface RegisteredContributionMetadata {
-    source: ContributionSource;
-    ownerId: string;
-    priority: number;
-}
-
-export declare interface RegisteredControlsRendererContribution extends ControlsRendererContribution, RegisteredContributionMetadata {
-}
-
-export declare interface RegisteredDataRendererContribution<TRow extends DataRendererRow = DataRendererRow> extends DataRendererContribution<TRow>, RegisteredContributionMetadata {
-}
-
-export declare interface RegisteredFileRendererContribution extends FileRendererContribution, RegisteredContributionMetadata {
-}
-
-export declare interface RegisteredKeepAliveHost {
-    rendererId: string;
-    host: HTMLElement;
-    attachedTo?: HTMLElement;
-}
-
-export declare interface RegisteredKeybinding extends Keybinding, RegisteredContributionMetadata {
-}
-
-export declare interface RegisteredMenuItem extends MenuItem, RegisteredContributionMetadata {
-    path: MenuPath;
-}
-
-export declare type RegisteredNavigationParser = Omit<NavigationParser, "priority"> & RegisteredContributionMetadata;
-
-export declare type RegisteredPlaceholderContribution = Omit<PlaceholderContribution, "priority"> & RegisteredContributionMetadata;
-
-declare type RegisteredPreferenceSchema = PreferencePropertySchema & {
-    ownerId: string;
-    source: string;
-};
-
-export declare interface RegisteredResourceKind extends ResourceKindContribution, RegisteredContributionMetadata {
-}
-
-export declare type RegisteredResourceNavigator = Omit<ResourceNavigator, "priority"> & RegisteredContributionMetadata;
-
-export declare type RegisteredSettingsPanel = SettingsPanelContribution & RegisteredContributionMetadata;
-
-export declare type RegisteredSettingsSection = SettingsSectionContribution & RegisteredContributionMetadata;
-
-export declare interface RegisteredTreeRendererContribution extends TreeRendererContribution, RegisteredContributionMetadata {
-}
-
-export declare type RegisteredWidgetContribution = Omit<WidgetContribution, "priority" | "singleton" | "reuse"> & {
-    singleton: boolean;
-    reuse: WidgetReusePolicy;
-} & RegisteredContributionMetadata;
-
-export declare interface RegisteredWorkbenchNotification extends RegisteredContributionMetadata {
-    id: string;
-    level: WorkbenchNotificationLevel;
-    title: string;
-    message?: string;
-    createdAt: string;
-    resource?: ResourceRef;
-    actions?: WorkbenchNotificationAction[];
-    metadata?: Record<string, unknown>;
-}
-
-export declare const resolveAnchorArea: (anchorId: AnchorId) => "status" | "secondary" | "main" | "nav" | "activity" | "left-header" | "left" | "main-header" | "main-left" | "main-right" | "secondary-header" | "overlay" | "floating-header" | "floating";
-
-declare type ResolvedResourceOpener = Required<ResourceOpener>;
-
-export declare interface ResourceBrowseEntry {
-    resource: ResourceRef;
-    searchText?: string;
-    description?: string;
-    group?: string;
-    order?: number;
-    activate?: (resource: ResourceRef) => unknown | Promise<unknown>;
-}
-
-/** Row-level context menu action surfaced by the renderer. */
-export declare interface ResourceContextAction {
-    key: string;
-    label: string;
-    onClick: () => Promise<void> | void;
-    isDisabled?: boolean;
-    icon?: ReactNode;
-    endContent?: ReactNode;
-    separatorBefore?: boolean;
-}
-
-export declare const resourceContextMenuPath: (resourceKind: string) => MenuPath;
-
-export declare interface ResourceKindContribution {
-    kind: string;
-    label: string;
-    icon?: string;
-    surface?: ResourceSurface;
-    paletteOpenInput?: OpenResourceInput;
-}
-
-export declare interface ResourceListContext {
-    primary?: ResourceRef;
-}
-
-export declare interface ResourceNavigator<TResult = unknown> {
-    id: string;
-    priority?: number;
-    canNavigate(resource: ResourceRef): boolean;
-    createHref?(resource: ResourceRef): string;
-    navigate(resource: ResourceRef): TResult | Promise<TResult>;
-}
-
-export declare interface ResourceOpener<TResult = unknown> {
-    id: string;
-    priority?: number;
-    canOpen(resource: ResourceRef): boolean;
-    open(resource: ResourceRef, input: OpenResourceInput): TResult | Promise<TResult>;
-}
-
-export declare interface ResourceProvider {
-    id: string;
-    kind: string;
-    list(query: string, context: ResourceListContext): readonly ResourceBrowseEntry[];
-}
-
-export declare interface ResourceRef {
-    kind: string;
-    uri: string;
-    id?: string;
-    label?: string;
-    icon?: string;
-    metadata?: Record<string, unknown>;
-}
-
-export declare interface ResourceRegistry {
-    store: WorkbenchStore<ResourceRegistryStoreState>;
-    registerKind(kind: ResourceKindContribution, metadata?: ContributionMetadata): Disposable_2;
-    getKind(kind: string): RegisteredResourceKind | undefined;
-    getSurface(resource: ResourceRef): ResourceSurface | undefined;
-    listKinds(): RegisteredResourceKind[];
-    registerOpener(opener: ResourceOpener): Disposable_2;
-    listOpeners(): ResolvedResourceOpener[];
-    registerProvider(provider: ResourceProvider): Disposable_2;
-    listProviders(): ResourceProvider[];
-    listResources(query: string): readonly ResourceBrowseEntry[];
-    openResource(resource: ResourceRef, input?: OpenResourceInput): Promise<unknown>;
-    onDidOpenResource(listener: (resource: ResourceRef) => void): Disposable_2;
-}
-
-declare interface ResourceRegistryStoreState {
-    kinds: Record<string, RegisteredResourceKind>;
-    openers: Record<string, ResolvedResourceOpener>;
-    providers: Record<string, ResourceProvider>;
-}
-
-export declare type ResourceSurface = "primary" | "secondary" | "attached";
-
-/** Auto-rendered as a param editor from the registered preference schema. */
-export declare interface SchemaSettingsPanel extends SettingsPanelBase {
-    kind: "schema";
-    preferences: SettingsPanelPreference[];
-    /** "live" persists on change (default); "apply" stages edits behind Save/Discard. */
-    save?: "live" | "apply";
-}
-
-/** A "+ create"-style action surfaced on a section or a collection's parent node. */
-export declare interface SettingsAction {
-    id: string;
-    label: string;
-    icon?: string;
-    run(): void | Promise<void>;
-}
-
-export declare interface SettingsCollectionGroupBy<TItem> {
-    key(item: TItem): string;
-    order?: string[];
-    label(key: string): string;
-    icon?(key: string): string | undefined;
-}
-
-export declare interface SettingsPanelBase {
-    id: string;
-    title: string;
-    description?: string;
-    /** Section id this panel belongs to. */
-    section?: string;
-    icon?: string;
-    /** Lower sorts first; ties fall back to contribution priority then registration order. */
-    order?: number;
-    scope?: SettingsScope;
-    when?: string;
-}
-
-export declare type SettingsPanelContribution = SchemaSettingsPanel | CustomSettingsPanel | CollectionSettingsPanel;
-
-/** A preference this panel edits; a bare string uses the preference name as its label. */
-export declare type SettingsPanelPreference = string | {
-    name: string;
-    label?: string;
-};
-
-export declare interface SettingsRegistry {
-    store: WorkbenchStore<SettingsRegistryStoreState>;
-    registerSection(section: SettingsSectionContribution, metadata?: ContributionMetadata): Disposable_2;
-    registerPanel<TItem = unknown>(panel: SchemaSettingsPanel | CustomSettingsPanel | CollectionSettingsPanel<TItem>, metadata?: ContributionMetadata): Disposable_2;
-    getSection(id: string): RegisteredSettingsSection | undefined;
-    getPanel(id: string): RegisteredSettingsPanel | undefined;
-    listSections(): RegisteredSettingsSection[];
-    listPanels(): RegisteredSettingsPanel[];
-    /** Signal that a collection's backing data changed so the surface refreshes. */
-    refresh(): void;
-}
-
-export declare interface SettingsRegistryStoreState {
-    sections: Record<string, RegisteredSettingsSection>;
-    panels: Record<string, RegisteredSettingsPanel>;
-    /** Bumped by refresh() so the surface re-reads collection items() after backing data changes. */
-    revision: number;
-}
-
-/** Settings are stored either per-user (global) or per-project. Projectless surfaces show only global entries. */
-export declare type SettingsScope = "global" | "project";
-
-/** An ordered sidebar container. Headerless when `title` is omitted. */
-export declare interface SettingsSectionContribution {
-    id: string;
-    title?: string;
-    order?: number;
-    scope?: SettingsScope;
-    actions?: SettingsAction[];
-}
-
-export declare type SortDirection = "asc" | "desc";
-
-export declare type StandardResourceIcon = (typeof standardResourceIcons)[keyof typeof standardResourceIcons];
-
-export declare const standardResourceIcons: {
-    readonly project: "folder-root";
-    readonly workspace: "computer";
-    readonly worktree: "git-pull-request-draft";
-    readonly settings: "settings";
-    readonly dataRenderer: "table-properties";
-};
-
-export declare type SurfaceDescriptor = AnchorSurface | ProjectionSurface | ChromeSurface | TransientSurface;
-
-export declare const surfaceMap: Record<WorkbenchArea, SurfaceDescriptor>;
-
-/**
- * Core-owned contract for theme registrations. Structurally identical to
- * @pstdio/ui's ThemePreferenceOption; the React layer bridges the two so core
- * does not depend on UI package ownership.
- */
-export declare type ThemePreference = string;
-
-export declare type ThemePreferenceMode = "light" | "dark";
-
-export declare interface ThemePreferenceOption {
-    id: ThemePreference;
-    title?: string;
-    mode: ThemePreferenceMode;
-    tokens?: ThemePreferenceTokens;
-    monacoTheme?: unknown;
-}
-
-export declare type ThemePreferenceTokens = Record<string, string>;
-
-export declare interface ThemeRegistry {
-    store: WorkbenchStore<WorkbenchThemeStoreState>;
-    register(themes: readonly ThemePreferenceOption[]): Disposable_2;
-    listThemes(): readonly ThemePreferenceOption[];
-}
-
-declare interface TransientSurface {
-    role: "transient";
-}
-
-export declare interface TreeAction {
-    id: string;
-    label?: string;
-    icon?: string;
-    commandId?: string;
-    args?: unknown;
-    params?: CommandParamSchema;
-    submitLabel?: string;
-    when?: string;
-    disabled?: boolean;
-    run?(args?: unknown): Promise<void> | void;
-}
-
-export declare interface TreeContext {
-    filter?: string;
-    resource?: ResourceRef;
-    /** Widget/view contribution id for trees rendered through a view-backed widget. */
-    viewId?: string;
-}
-
-export declare interface TreeNode {
-    id: string;
-    label: string;
-    icon?: string;
-    iconElement?: unknown;
-    iconColor?: string;
-    iconTooltip?: string;
-    endContent?: unknown;
-    commandId?: string;
-    resource?: ResourceRef;
-    target?: NavigationTarget;
-    /** Visual row variant for non-data rows such as placeholders. */
-    rowVariant?: TreeNodeRowVariant;
-    actions?: TreeAction[];
-    contextMenuActions?: TreeAction[];
-    contextMenuPath?: MenuPath;
-    menuPath?: MenuPath;
-    menuPlacement?: "top-start" | "top-end" | "bottom-start" | "bottom-end" | "right-start" | "left-start";
-    collapsible?: boolean;
-    disabled?: boolean;
-    children?: TreeNode[];
-    description?: string;
-    contextValue?: string;
-    hiddenByDefault?: boolean;
-    /** When true, the node (e.g. a header/footer row) opts in to the tree's hide/show customization menu. */
-    canHide?: boolean;
-}
-
-declare type TreeNodeRowVariant = "empty-state";
-
-export declare interface TreeRendererContribution {
-    id: string;
-    title: string;
-    icon?: string;
-    when?: string;
-    defaultExpandedSectionIds?: string[];
-    defaultExpandedNodeIds?: string[];
-    getBody(ctx: TreeContext): Promise<TreeViewSection[]> | TreeViewSection[];
-    getHeader?(ctx: TreeContext): Promise<TreeNode[]> | TreeNode[];
-    getFooter?(ctx: TreeContext): Promise<TreeNode[]> | TreeNode[];
-    getChildren(node: TreeNode, ctx: TreeContext): Promise<TreeNode[]> | TreeNode[];
-}
-
-export declare type TreeRendererImplementation = (input: WorkbenchWidgetRenderInput & {
-    treeId: string;
-}) => unknown;
-
-export declare interface TreeRendererPersistenceAdapter {
-    getTreeStates(): PersistedTreeRendererStates | undefined;
-    setTreeStates(states: PersistedTreeRendererStates): void;
-}
-
-export declare interface TreeRendererRefreshEvent {
-    treeId: string;
-}
-
-declare type TreeRendererRefreshListener = (event: TreeRendererRefreshEvent) => void;
-
-export declare interface TreeRendererRegistry {
-    treeStore: WorkbenchStore<TreeRendererStoreState>;
-    registerTreeRenderer(view: TreeRendererContribution, metadata?: ContributionMetadata): Disposable_2;
-    setTreeRendererImplementation(impl: TreeRendererImplementation): void;
-    getTreeRenderer(id: string): RegisteredTreeRendererContribution | undefined;
-    listTreeRenderers(): RegisteredTreeRendererContribution[];
-    getBody(id: string, ctx?: TreeContext): Promise<TreeViewSection[]>;
-    getHeader(id: string, ctx?: TreeContext): Promise<TreeNode[]>;
-    getFooter(id: string, ctx?: TreeContext): Promise<TreeNode[]>;
-    getChildren(id: string, node: TreeNode, ctx?: TreeContext): Promise<TreeNode[]>;
-    getTreeState(id: string): TreeRendererState;
-    setNodeExpanded(id: string, nodeId: string, expanded: boolean): void;
-    setSectionExpanded(id: string, sectionId: string, expanded: boolean): void;
-    setSelectedNode(id: string, nodeId: string | undefined): void;
-    setLoading(id: string, loading: boolean): void;
-    refresh(id: string): void;
-    onDidRefresh(listener: TreeRendererRefreshListener): Disposable_2;
-}
-
-export declare interface TreeRendererState {
-    expandedNodeIds: string[];
-    expandedSectionIds: string[];
-    selectedNodeId?: string;
-    loading?: boolean;
-}
-
-export declare interface TreeRendererStoreState {
-    trees: Record<string, RegisteredTreeRendererContribution>;
-    statesByTreeId: Record<string, TreeRendererState>;
-    refreshKeysByTreeId: Record<string, number>;
-}
-
-declare interface TreeSectionEmptyState {
-    title: string;
-    description?: string;
-    icon?: string;
-}
-
-export declare interface TreeViewSection {
-    id: string;
-    label?: string;
-    actions?: TreeAction[];
-    collapsible?: boolean;
-    emptyState?: TreeSectionEmptyState;
-    nodes: TreeNode[];
-    hiddenByDefault?: boolean;
-    /** When true, the section (category) opts in to the tree's hide/show customization menu. */
-    canHide?: boolean;
-}
-
-/**
- * Core-owned contracts for data renderer contributions. @pstdio/ui's
- * DataRenderer props are structurally identical; the React layer bridges the
- * two, so drift surfaces as a compile error there instead of coupling core's
- * API shape to UI package ownership.
- */
-export declare type ViewMode = "board" | "list";
-
-export declare interface WidgetContribution {
-    id: string;
-    title: string;
-    area: WorkbenchArea;
-    fallbackArea?: WorkbenchArea;
-    singleton?: boolean;
-    reuse?: WidgetReusePolicy;
-    mountStrategy?: WidgetMountStrategy;
-    closable?: boolean;
-    hiddenByDefault?: boolean;
-    areaSize?: WorkbenchAreaSize;
-    areaCollapsible?: boolean;
-    headerBorderBottom?: boolean;
-    resourceKinds?: string[];
-    priority?: number;
-    rendererId: string;
-    config?: unknown;
-    canOpen?(resource: ResourceRef): boolean;
-}
-
-export declare type WidgetMountStrategy = "active" | "keep-mounted";
-
-export declare type WidgetReusePolicy = "resource" | "none";
-
-export declare type WorkbenchArea = (typeof workbenchAreas)[number];
-
-export declare const workbenchAreas: readonly ["nav", "activity", "left-header", "left", "main-header", "main-left", "main", "main-right", "secondary-header", "secondary", "status", "overlay", "floating-header", "floating"];
-
-export declare interface WorkbenchAreaSize {
-    defaultPx?: number;
-    minPx?: number;
-    maxPx?: number;
-}
-
-export declare interface WorkbenchAreaState {
-    id: WorkbenchArea;
-    visible: boolean;
-    size?: number;
-    widgets: WorkbenchWidgetPlacement[];
-    activeWidgetId?: string;
-}
-
-export declare const workbenchAreaTabLeadingMenuPath: (area: string) => MenuPath;
-
-export declare type WorkbenchBreadcrumbChangeListener = () => void;
-
-export declare interface WorkbenchBreadcrumbController {
-    store: WorkbenchStore<WorkbenchBreadcrumbState>;
-    setItems(items: WorkbenchBreadcrumbItem[]): Disposable_2;
-    clearItems(): void;
-    getItems(): WorkbenchBreadcrumbItem[] | undefined;
-    onDidChange(listener: WorkbenchBreadcrumbChangeListener): Disposable_2;
-}
-
-export declare interface WorkbenchBreadcrumbItem {
-    title: unknown;
-    icon?: string;
-    url?: string;
-    onClick?: () => void;
-    resource?: ResourceRef;
-}
-
-declare interface WorkbenchBreadcrumbState {
-    items: WorkbenchBreadcrumbItem[] | undefined;
-}
-
-export declare interface WorkbenchCommandExecutionContext {
-    resource?: ResourceRef;
-}
-
-export declare interface WorkbenchCommandExecutionError {
-    commandId: string;
-    args: unknown;
-    error: unknown;
-}
-
-export declare type WorkbenchCommandExecutionErrorListener = (event: WorkbenchCommandExecutionError) => void;
-
-export declare type WorkbenchCommandPaletteChangeListener = (open: boolean) => void;
-
-export declare interface WorkbenchCommandPaletteController {
-    store: WorkbenchStore<WorkbenchCommandPaletteState>;
-    isOpen(): boolean;
-    getView(): WorkbenchCommandPaletteView;
-    getInitialQuery(): string;
-    getParamsRequest(): WorkbenchCommandParamsRequest | null;
-    open(input?: WorkbenchCommandPaletteOpenInput): void;
-    close(): void;
-    toggle(): void;
-    requestParams(request: WorkbenchCommandParamsRequest): void;
-    clearParams(): void;
-    onDidChange(listener: WorkbenchCommandPaletteChangeListener): Disposable_2;
-}
-
-export declare const workbenchCommandPaletteMenuPath: readonly ["workbench", "commandPalette"];
-
-export declare interface WorkbenchCommandPaletteOpenInput {
-    view?: WorkbenchCommandPaletteView;
-    initialQuery?: string;
-}
-
-export declare interface WorkbenchCommandPaletteState {
-    open: boolean;
-    view: WorkbenchCommandPaletteView;
-    initialQuery: string;
-    paramsRequest: WorkbenchCommandParamsRequest | null;
-}
-
-export declare type WorkbenchCommandPaletteView = "main" | "theme" | "mode";
-
-declare interface WorkbenchCommandParamsRequest {
-    record: {
-        command: {
-            id: string;
-            label: string;
-            params?: CommandParamSchema;
-        };
-    };
-    label: string;
-    args?: unknown;
-    context?: WorkbenchCommandExecutionContext;
-}
-
-export declare interface WorkbenchCore extends WorkbenchCoreContributionContext {
-    registerModule(module: WorkbenchModuleContribution): Disposable_2;
-    unregisterModule(moduleId: string): void;
-}
-
-export declare interface WorkbenchCoreContributionContext {
-    breadcrumbs: WorkbenchBreadcrumbController;
-    commandPalette: WorkbenchCommandPaletteController;
-    commandPaletteResources: CommandPaletteResourceRegistry;
-    commands: CommandRegistry;
-    context: ContextKeyService;
-    focus: WorkbenchFocusController;
-    history: HistoryController;
-    keybindings: KeybindingRegistry;
-    lastResource: WorkbenchLastResourceController;
-    layout: WorkbenchLayoutModel;
-    modes: WorkbenchModeRegistry;
-    navigation: NavigationRegistry;
-    notifications: NotificationRegistry;
-    panels: WorkbenchPanelsController;
-    preferences: PreferenceRegistry;
-    renderers: WorkbenchRenderers;
-    resources: ResourceRegistry;
-    settings: SettingsRegistry;
-    sessionPanel: WorkbenchSessionPanelController;
-    terminal: WorkbenchTerminalController;
-    themes: ThemeRegistry;
-    fileIconThemes: FileIconThemeRegistry;
-    getPrimaryResource(): ResourceRef | undefined;
-    onDidChangePrimaryResource(listener: (resource: ResourceRef | undefined) => void): Disposable_2;
-    getActiveResource(): ResourceRef | undefined;
-    onDidChangeActiveResource(listener: (resource: ResourceRef | undefined) => void): Disposable_2;
-}
-
-export declare interface WorkbenchFileIconThemeStoreState {
-    themes: readonly FileIconThemePreferenceOption[];
-}
-
-export declare type WorkbenchFocusArea = (typeof workbenchFocusAreas)[number];
-
-export declare const workbenchFocusAreas: readonly ["activityBar", "sideBar", "main", "panel", "statusBar"];
-
-export declare type WorkbenchFocusChangeListener = (area: WorkbenchFocusArea | undefined) => void;
-
-export declare interface WorkbenchFocusController {
-    store: WorkbenchStore<WorkbenchFocusState>;
-    setActiveArea(area: WorkbenchFocusArea): void;
-    clearFocus(): void;
-    getActiveArea(): WorkbenchFocusArea | undefined;
-    onDidChange(listener: WorkbenchFocusChangeListener): Disposable_2;
-}
-
-export declare interface WorkbenchFocusState {
-    activeArea: WorkbenchFocusArea | undefined;
-}
-
-export declare interface WorkbenchLastResourceController {
-    get(): ResourceRef | undefined;
-    set(resource: ResourceRef | undefined): void;
-    restore(): Promise<boolean>;
-}
-
-export declare interface WorkbenchLayout {
-    areas: Record<WorkbenchArea, WorkbenchAreaState>;
-    activeWidgetId?: string;
-    activeResourceUri?: string;
-}
-
-export declare type WorkbenchLayoutModel = LayoutModel & MenuRegistry;
-
-export declare interface WorkbenchLayoutStoreState {
-    layout: WorkbenchLayout;
-    widgets: Record<string, RegisteredWidgetContribution>;
-    placeholders: Partial<Record<WorkbenchArea, RegisteredPlaceholderContribution>>;
-}
-
-export declare type WorkbenchModeActivationContext = WorkbenchCoreContributionContext;
-
-export declare type WorkbenchModeActivationResult = Disposable_2 | readonly Disposable_2[] | undefined;
-
-declare type WorkbenchModeChangeListener = () => void;
-
-export declare interface WorkbenchModeContribution {
-    id: string;
-    label?: string;
-    activate(ctx: WorkbenchModeActivationContext): WorkbenchModeActivationResult;
-}
-
-export declare interface WorkbenchModeRegistry {
-    store: WorkbenchStore<WorkbenchModeStoreState>;
-    registerMode(mode: WorkbenchModeContribution): Disposable_2;
-    getMode(id: string): WorkbenchModeContribution | undefined;
-    listModes(): WorkbenchModeContribution[];
-    getActiveModeId(): string | undefined;
-    setActiveMode(id: string | undefined): void;
-    onDidChangeActive(listener: WorkbenchModeChangeListener): Disposable_2;
-}
-
-declare interface WorkbenchModeStoreState {
-    modes: Record<string, WorkbenchModeContribution>;
-    activeModeId: string | undefined;
-}
-
-declare type WorkbenchModuleActivationResult = Disposable_2 | readonly Disposable_2[] | undefined;
-
-export declare interface WorkbenchModuleContribution {
-    id: string;
-    source?: ContributionSource;
-    ownerId?: string;
-    activate(ctx: WorkbenchModuleContributionContext): WorkbenchModuleActivationResult;
-}
-
-export declare type WorkbenchModuleContributionContext = WorkbenchCoreContributionContext;
-
-export declare interface WorkbenchNotification {
-    id?: string;
-    level: WorkbenchNotificationLevel;
-    title: string;
-    message?: string;
-    createdAt?: string;
-    resource?: ResourceRef;
-    actions?: WorkbenchNotificationAction[];
-    metadata?: Record<string, unknown>;
-}
-
-export declare interface WorkbenchNotificationAction {
-    commandId: string;
-    title: string;
-    args?: unknown;
-}
-
-export declare type WorkbenchNotificationEvent = {
-    type: "show";
-    id: string;
-    notification: RegisteredWorkbenchNotification;
-} | {
-    type: "dismiss";
-    id: string;
-};
-
-export declare type WorkbenchNotificationLevel = "info" | "success" | "warning" | "error";
-
-declare type WorkbenchNotificationListener = (event: WorkbenchNotificationEvent) => void;
-
-declare interface WorkbenchNotificationStoreState {
-    notifications: Record<string, RegisteredWorkbenchNotification>;
-}
-
-export declare type WorkbenchPanelsChangeListener = (state: WorkbenchPanelsState) => void;
-
-export declare interface WorkbenchPanelsController {
-    store: WorkbenchStore<WorkbenchPanelsState>;
-    isOpen(areaId: string): boolean;
-    setOpen(areaId: string, open: boolean): void;
-    toggle(areaId: string): void;
-    onDidChange(listener: WorkbenchPanelsChangeListener): Disposable_2;
-}
-
-export declare interface WorkbenchPanelsPersistenceAdapter {
-    getPanelStates(): PersistedWorkbenchPanels | undefined;
-    setPanelStates(state: PersistedWorkbenchPanels): void;
-}
-
-export declare interface WorkbenchPanelsState {
-    openByAreaId: Record<string, boolean>;
-}
-
-declare type WorkbenchRendererChangeListener = () => void;
-
-export declare type WorkbenchRendererRegistration = {
-    id: string;
-    keepAlive?: false;
-    render: (input: WorkbenchWidgetRenderInput) => unknown;
-} | {
-    id: string;
-    keepAlive: true;
-    render: () => unknown;
-};
-
-export declare interface WorkbenchRendererRegistry {
-    store: WorkbenchStore<WorkbenchRendererStoreState>;
-    registerRenderer(renderer: WorkbenchRendererRegistration): Disposable_2;
-    getRenderer(id: string): WorkbenchRendererRegistration | undefined;
-    listRenderers(): WorkbenchRendererRegistration[];
-    onDidChange(listener: WorkbenchRendererChangeListener): Disposable_2;
-    claim(rendererId: string, slot: HTMLElement, input: WorkbenchWidgetRenderInput): Disposable_2;
-    getHost(rendererId: string): HTMLElement | undefined;
-    getClaim(rendererId: string): WorkbenchWidgetRenderInput | undefined;
-}
-
-export declare type WorkbenchRenderers = WorkbenchRendererRegistry & TreeRendererRegistry & DataRendererRegistry & FileRendererRegistry & ControlsRendererRegistry;
-
-export declare interface WorkbenchRendererStoreState {
-    renderers: Record<string, WorkbenchRendererRegistration>;
-    hosts: Record<string, RegisteredKeepAliveHost>;
-    claims: Record<string, WorkbenchWidgetRenderInput>;
-}
-
-export declare const workbenchResourceIdContextKey = "workbench.resource.id";
-
-export declare const workbenchResourceKindContextKey = "workbench.resource.kind";
-
-export declare const workbenchResourceMetadataContextKey: (key: string) => string;
-
-export declare const workbenchSelectionResourceUriMetadataKey = "workbench.selectionResourceUri";
-
-export declare type WorkbenchSessionPanelChangeListener = (mode: WorkbenchSessionPanelMode) => void;
-
-export declare interface WorkbenchSessionPanelController {
-    store: WorkbenchStore<WorkbenchSessionPanelState>;
-    getMode(): WorkbenchSessionPanelMode;
-    setMode(mode: WorkbenchSessionPanelMode): void;
-    onDidChange(listener: WorkbenchSessionPanelChangeListener): Disposable_2;
-}
-
-export declare type WorkbenchSessionPanelMode = "bubble" | "closed" | "attached";
-
-export declare interface WorkbenchSessionPanelState {
-    mode: WorkbenchSessionPanelMode;
-}
-
-export declare interface WorkbenchStore<TState> {
-    getState(): TState;
-    getInitialState(): TState;
-    subscribe(listener: WorkbenchStoreListener<TState>): () => void;
-    subscribeSelector<TValue>(selector: WorkbenchStoreSelector<TState, TValue>, listener: WorkbenchStoreSelectorListener<TValue>, options?: {
-        equalityFn?: (left: TValue, right: TValue) => boolean;
-        fireImmediately?: boolean;
-    }): () => void;
-}
-
-export declare type WorkbenchStoreListener<TState> = (state: TState, previousState: TState) => void;
-
-export declare type WorkbenchStoreSelector<TState, TValue> = (state: TState) => TValue;
-
-export declare type WorkbenchStoreSelectorListener<TValue> = (value: TValue, previousValue: TValue) => void;
-
-export declare interface WorkbenchTerminalController {
-    store: WorkbenchStore<WorkbenchTerminalState>;
-    /** True once the host injected a session opener. */
-    isAvailable(): boolean;
-    setSessionOpener(opener: WorkbenchTerminalSessionOpener | null): void;
-    /** Opens a session; the live adapter stays host-side and only the id is returned. */
-    open(input: {
-        request: WorkbenchTerminalSessionRequest;
-        title?: string;
-    }): Promise<{
-        sessionId: string;
-    }>;
-    write(input: {
-        sessionId: string;
-        data: string | Uint8Array;
-    }): void;
-    resize(input: {
-        sessionId: string;
-        cols: number;
-        rows: number;
-    }): void;
-    kill(input: {
-        sessionId: string;
-        signal?: string;
-    }): Promise<void>;
-    subscribe(sessionId: string, sink: WorkbenchTerminalSessionSink): () => void;
-    getSession(sessionId: string): WorkbenchTerminalSessionModel | undefined;
-    listSessions(): WorkbenchTerminalSessionModel[];
-    /** Kills every live session. Called when the owning workbench is torn down. */
-    dispose(): Promise<void>;
-}
-
-export declare interface WorkbenchTerminalSessionAdapter {
-    readonly id: string;
-    write(data: string | Uint8Array): void;
-    resize(cols: number, rows: number): void;
-    kill(signal?: string): Promise<void> | void;
-    onData(handler: (chunk: Uint8Array) => void): () => void;
-    /** Foreground process name updates, when the opener can report them (real PTYs). */
-    onTitle?(handler: (title: string) => void): () => void;
-    onExit(handler: (exit: WorkbenchTerminalSessionExit) => void): () => void;
-    onError(handler: (error: WorkbenchTerminalSessionError) => void): () => void;
-}
-
-export declare interface WorkbenchTerminalSessionError {
-    message: string;
-}
-
-export declare interface WorkbenchTerminalSessionExit {
-    code: number | null;
-    signal: string | null;
-}
-
-export declare interface WorkbenchTerminalSessionModel {
-    id: string;
-    title: string;
-    status: WorkbenchTerminalSessionStatus;
-    exit?: WorkbenchTerminalSessionExit;
-}
-
-export declare type WorkbenchTerminalSessionOpener = (request: WorkbenchTerminalSessionRequest) => Promise<WorkbenchTerminalSessionAdapter>;
-
-export declare interface WorkbenchTerminalSessionRequest {
-    command?: string[];
-    cwd?: string;
-    env?: Record<string, string>;
-    cols: number;
-    rows: number;
-}
-
-export declare interface WorkbenchTerminalSessionSink {
-    onData?(chunk: Uint8Array): void;
-    onExit?(exit: WorkbenchTerminalSessionExit): void;
-    onError?(error: WorkbenchTerminalSessionError): void;
-}
-
-export declare type WorkbenchTerminalSessionStatus = "running" | "exited" | "killed";
-
-export declare interface WorkbenchTerminalState {
-    sessionsById: Record<string, WorkbenchTerminalSessionModel>;
-}
-
-export declare interface WorkbenchThemeStoreState {
-    themes: readonly ThemePreferenceOption[];
-}
-
-export declare const workbenchTopHeaderLeadingMenuPath: MenuPath;
-
-export declare const workbenchTopHeaderTrailingMenuPath: MenuPath;
-
-export declare interface WorkbenchWidgetPlacement {
-    widgetId: string;
-    contributionId: string;
-    ownerId?: string;
-    source?: ContributionSource;
-    resource?: ResourceRef;
-    resourceUri?: string;
-    title?: string;
-    pinned?: boolean;
-    closable?: boolean;
-    mountStrategy?: WidgetMountStrategy;
-    hiddenByDefault?: boolean;
-}
-
-export declare interface WorkbenchWidgetRenderInput {
-    workbench: WorkbenchCore;
-    widget: RegisteredWidgetContribution | RegisteredPlaceholderContribution;
-    placement: WorkbenchWidgetPlacement;
-    refresh: () => void;
-}
-
-export { }