@fps-games/editor 0.2.0-beta.4 → 0.2.1-beta.2

package/node_modules/@fps-games/editor-browser/dist/local-editor-ui-types.d.ts

@@ -1,6 +1,9 @@
-import type { EditorPlacementMode, EditorTransformAction, EditorTransformConstraint, EditorTransformHandleDescriptor, EditorTransformOperationSettings, EditorTransformSpace, EditorTransformTool, EditorTransformToolDescriptor, EditorViewportGroundMeasurement, EditorViewportOverlaySettings, EditorViewportProjectionMode, EditorViewportSpatialOverlayState, EditorViewportToolState, EditorViewportUtilityTool, EditorViewportViewPreset, SceneGraphPrimitiveShape, SelectionCommand } from '@fps-games/editor-core';
+import type { EditorPlacementMode, EditorTransformAction, EditorTransformConstraint, EditorTransformHandleDescriptor, EditorTransformOperationSettings, EditorTransformSpace, EditorTransformTool, EditorTransformToolDescriptor, EditorViewportGroundMeasurement, EditorViewportOverlaySettings, EditorViewportProjectionMode, EditorViewportSpatialOverlayState, EditorViewportToolState, EditorViewportUtilityTool, EditorViewportViewPreset, InspectorCommitMode, InspectorControlKind, InspectorEditPayload, InspectorEffectMode, InspectorEnumOption, InspectorObject, InspectorPersistenceMode, InspectorProperty, InspectorSection, InspectorSelectionContext, SceneGraphPrimitiveShape } from '@fps-games/editor-core';
+import type { CapabilityAvailability, EditorContextActionPresentation, EditorToolPresentation } from '@fps-games/editor-core/tools';
+import type { EditorDiagnostic, EditorDiagnosticPhase, EditorDiagnosticSeverity } from '@fps-games/editor-protocol';
 import type { LocalEditorThemeName } from './local-editor-ui-theme';
-import type { LocalEditorModalDialogInput } from './local-editor-ui-modal-dialog';
+import type { LocalEditorModalDialogChoiceInput, LocalEditorModalDialogInput } from './local-editor-ui-modal-dialog';
+import type { HierarchyOperationResult, HierarchyKernel, HierarchySurfaceContribution } from '@fps-games/plugin-hierarchy';
 export type LocalEditorBrowserSerializedValueType = 'string' | 'number' | 'boolean' | 'enum' | 'asset' | 'object' | 'unknown';
 export interface LocalEditorBrowserSerializedProperty<TDocument = unknown> {
     path: string;
@@ -24,148 +27,24 @@ export interface LocalEditorBrowserSerializedMultiObject<TDocument = unknown> {
     properties: LocalEditorBrowserSerializedProperty<TDocument>[];
     document?: TDocument;
 }
-export type LocalEditorBrowserInspectorPersistenceMode = 'document' | 'runtime' | 'readonly';
-export type LocalEditorBrowserInspectorControlKind = 'readonly' | 'string' | 'number' | 'boolean' | 'enum' | 'vec2' | 'vec3' | 'color' | 'asset' | 'object' | 'custom';
-export type LocalEditorBrowserInspectorCommitMode = 'live' | 'blur' | 'change' | 'immediate';
-export type LocalEditorBrowserInspectorEffectMode = 'active' | 'default' | 'derived' | 'runtime' | 'unsupported';
-export type LocalEditorBrowserInspectorEditSource = 'input' | 'toggle' | 'select' | 'color' | 'asset' | 'custom';
-export interface LocalEditorBrowserInspectorEnumOption<TValue = string | number | boolean | null> {
-    label: string;
-    value: TValue;
-    disabled?: boolean;
-    batchCompatibility?: 'include' | 'ignore';
-}
-export interface LocalEditorBrowserInspectorSelectionContext<TDocument = unknown> {
-    targetIds: string[];
-    activeId: string | null;
-    targetKind?: string;
-    document?: TDocument;
-    runtimeTarget?: unknown;
-    capabilities?: readonly string[];
-}
-export interface LocalEditorBrowserInspectorProperty<TDocument = unknown> {
-    id?: string;
-    path: string;
-    label: string;
-    valueType: LocalEditorBrowserSerializedValueType | 'color' | 'vec2' | 'vec3';
-    control: LocalEditorBrowserInspectorControlKind;
-    customControl?: string;
-    controlOptions?: Record<string, unknown>;
-    value: unknown;
-    mixed?: boolean;
-    batchEdit?: boolean | 'auto';
-    readOnly: boolean;
-    persistence: LocalEditorBrowserInspectorPersistenceMode;
-    commitMode: LocalEditorBrowserInspectorCommitMode;
-    order?: number;
-    tags?: readonly string[];
-    tooltip?: string;
-    effect?: LocalEditorBrowserInspectorEffectMode;
-    disabledReason?: string;
-    placeholder?: string;
-    min?: number;
-    max?: number;
-    step?: number;
-    options?: readonly LocalEditorBrowserInspectorEnumOption[];
-    document?: TDocument;
-}
-export interface LocalEditorBrowserInspectorSection<TDocument = unknown> {
-    id: string;
-    title: string;
-    summary?: string;
-    order?: number;
-    placement?: 'summary' | 'body';
-    collapsedByDefault?: boolean;
-    persistence?: LocalEditorBrowserInspectorPersistenceMode;
-    runtimeOnly?: boolean;
-    effect?: LocalEditorBrowserInspectorEffectMode;
-    disabledReason?: string;
-    tags?: readonly string[];
-    properties: LocalEditorBrowserInspectorProperty<TDocument>[];
-}
-export interface LocalEditorBrowserInspectorObject<TDocument = unknown> {
-    targetIds: string[];
-    activeId: string | null;
-    label?: string;
-    selection: LocalEditorBrowserInspectorSelectionContext<TDocument>;
-    sections: LocalEditorBrowserInspectorSection<TDocument>[];
-    document?: TDocument;
-}
-export interface LocalEditorBrowserUiHierarchyItem {
-    id: string;
-    label: string;
-    parentId?: string | null;
-    depth?: number;
-    role?: 'root' | 'group' | 'object' | 'marker';
-    icon?: string;
-    selectable?: boolean;
-    enabled?: boolean;
-    directEnabled?: boolean;
-    canToggleEnabled?: boolean;
-    enableToggleDisabledReason?: string;
-    locked?: boolean;
-    protected?: boolean;
-    canHaveChildren?: boolean;
-    renamable?: boolean;
-    deletable?: boolean;
-    draggable?: boolean;
-}
-export type LocalEditorBrowserHierarchyScopeKind = 'scene' | 'prefab-stage';
-export type LocalEditorBrowserHierarchyCommandSurface = 'scene-graph' | 'prefab-composition' | 'readonly';
-export interface LocalEditorBrowserHierarchyScopeNode extends LocalEditorBrowserUiHierarchyItem {
-    scopeId?: string;
-    sourceKind?: string;
-    commandTargetId?: string;
-    commandable?: boolean;
-}
-export type LocalEditorBrowserStatusDiagnosticSeverity = 'warning' | 'error';
-export interface LocalEditorBrowserStatusDiagnostic {
-    code: string;
-    severity: LocalEditorBrowserStatusDiagnosticSeverity;
-    source: string;
-    message: string;
+export type LocalEditorBrowserInspectorPersistenceMode = InspectorPersistenceMode;
+export type LocalEditorBrowserInspectorControlKind = InspectorControlKind;
+export type LocalEditorBrowserInspectorCommitMode = InspectorCommitMode;
+export type LocalEditorBrowserInspectorEffectMode = InspectorEffectMode;
+export type LocalEditorBrowserInspectorEditSource = NonNullable<InspectorEditPayload['source']>;
+export type LocalEditorBrowserInspectorEnumOption<TValue = string | number | boolean | null> = InspectorEnumOption<TValue>;
+export type LocalEditorBrowserInspectorSelectionContext<TDocument = unknown> = InspectorSelectionContext<TDocument>;
+export type LocalEditorBrowserInspectorProperty<TDocument = unknown> = InspectorProperty<TDocument>;
+export type LocalEditorBrowserInspectorSection<TDocument = unknown> = InspectorSection<TDocument>;
+export type LocalEditorBrowserInspectorObject<TDocument = unknown> = InspectorObject<TDocument>;
+export type LocalEditorBrowserStatusDiagnosticSeverity = EditorDiagnosticSeverity;
+export type LocalEditorBrowserStatusDiagnosticPhase = EditorDiagnosticPhase;
+export interface LocalEditorBrowserStatusDiagnostic extends Omit<EditorDiagnostic, 'phase' | 'producer'> {
+    phase?: LocalEditorBrowserStatusDiagnosticPhase;
+    producer?: string;
     scopeId?: string;
     documentRevision?: number;
     projectionRevision?: number;
-    rowId?: string;
-    targetId?: string;
-    details?: Record<string, unknown>;
-}
-export interface LocalEditorBrowserHierarchyProjectionTarget {
-    rowId: string;
-    targetId: string;
-    targetKind: string;
-}
-export interface LocalEditorBrowserHierarchyProjectionState {
-    scopeId: string;
-    scopeKind: LocalEditorBrowserHierarchyScopeKind;
-    documentRevision: number;
-    projectionRevision: number;
-    health: 'healthy' | 'warning' | 'error';
-    interactive: boolean;
-    nodes: LocalEditorBrowserHierarchyScopeNode[];
-    selectedIds: string[];
-    activeId: string | null;
-    targets: LocalEditorBrowserHierarchyProjectionTarget[];
-    diagnostics: LocalEditorBrowserStatusDiagnostic[];
-}
-export interface LocalEditorBrowserHierarchyCommandPrecondition {
-    scopeId: string;
-    documentRevision: number;
-    projectionRevision: number;
-}
-export interface LocalEditorBrowserHierarchyScope {
-    scopeId: string;
-    kind: LocalEditorBrowserHierarchyScopeKind;
-    title: string;
-    searchPlaceholder: string;
-    nodes: LocalEditorBrowserHierarchyScopeNode[];
-    selectedIds: string[];
-    activeId: string | null;
-    readonly: boolean;
-    commandSurface: LocalEditorBrowserHierarchyCommandSurface;
-    documentRevision: number;
-    projectionRevision: number;
 }
 export type LocalEditorBrowserPreviewScopeKind = 'scene' | 'prefab-stage';
 export type LocalEditorBrowserPreviewCommandSurface = 'scene-graph' | 'prefab-composition' | 'readonly';
@@ -213,6 +92,16 @@ export type LocalEditorBrowserAssetPreview = {
     emissionIntensity?: number;
     textureUrl?: string;
 };
+export type LocalEditorBrowserMaterialAssetPreview = Extract<LocalEditorBrowserAssetPreview, {
+    kind: 'material-sphere';
+}>;
+export interface LocalEditorBrowserMaterialPreviewSource {
+    id: string;
+    name: string;
+    materialKind?: 'pbr' | 'standard' | string;
+    preview: LocalEditorBrowserMaterialAssetPreview;
+}
+export type LocalEditorBrowserMaterialPreviewCleanup = () => void | Promise<void>;
 export interface LocalEditorBrowserMaterialTextureRef {
     url?: string;
     textureAssetId?: string;
@@ -263,7 +152,7 @@ export interface LocalEditorBrowserPrefabAssetEditorData {
     sourceAssetGuid?: string;
     readonly?: boolean;
 }
-export type LocalEditorBrowserPrefabStageStructureItemKind = 'root' | 'source' | 'group' | 'model' | 'primitive' | 'light' | 'prefabInstance' | 'collision' | 'mesh' | 'material' | 'texture' | 'animation' | 'info';
+export type LocalEditorBrowserPrefabStageStructureItemKind = 'root' | 'source' | 'group' | 'model' | 'primitive' | 'light' | 'marker' | 'prefabInstance' | 'collision' | 'mesh' | 'material' | 'texture' | 'animation' | 'info';
 export interface LocalEditorBrowserPrefabStageStructureItem {
     id: string;
     label: string;
@@ -279,6 +168,7 @@ export interface LocalEditorBrowserPrefabStageStructureItem {
     childPrefabId?: string;
     transform?: unknown;
     primitive?: Record<string, unknown>;
+    marker?: Record<string, unknown>;
     defaults?: Record<string, unknown>;
     overrides?: Record<string, unknown>;
     slotId?: string;
@@ -303,31 +193,6 @@ export interface LocalEditorBrowserPrefabStageImportStats {
     textureCount: number;
     animationCount: number;
 }
-export type LocalEditorBrowserPrefabStageComparisonPreviewMode = 'meshClone' | 'instancedMesh';
-export type LocalEditorBrowserPrefabStageComparisonPreviewStatus = 'loading' | 'ready' | 'unavailable';
-export interface LocalEditorBrowserPrefabStageComparisonPreview {
-    id: string;
-    label: string;
-    mode: LocalEditorBrowserPrefabStageComparisonPreviewMode;
-    projectionNodeId: string;
-    status: LocalEditorBrowserPrefabStageComparisonPreviewStatus;
-}
-export interface LocalEditorBrowserPrefabComparisonPreviewSurface {
-    previewId: string;
-    projectionNodeId: string;
-    element: HTMLElement;
-    rect: DOMRect;
-}
-export type LocalEditorBrowserPrefabComparisonPreviewInteraction = {
-    kind: 'orbit';
-    previewId: string;
-    deltaX: number;
-    deltaY: number;
-} | {
-    kind: 'zoom';
-    previewId: string;
-    deltaY: number;
-};
 export interface LocalEditorBrowserPrefabStageState<TDocument = unknown> {
     assetId: string;
     browserAssetId?: string;
@@ -335,13 +200,17 @@ export interface LocalEditorBrowserPrefabStageState<TDocument = unknown> {
     sourceAssetId?: string;
     sourceAssetGuid?: string;
     readonly?: boolean;
+    dirty: boolean;
+    documentDirty: boolean;
+    canSave: boolean;
+    canDiscard: boolean;
     selectedItemId?: string | null;
+    selectedItemIds?: readonly string[];
     structureItems: LocalEditorBrowserPrefabStageStructureItem[];
     inspectorObject?: LocalEditorBrowserInspectorObject<TDocument> | null;
     importStructureReady?: boolean;
     importStats?: LocalEditorBrowserPrefabStageImportStats | null;
     previewNodeId?: string;
-    comparisonPreviews?: LocalEditorBrowserPrefabStageComparisonPreview[];
 }
 export interface LocalEditorBrowserInspectorAssetPickerOption {
     label: string;
@@ -353,6 +222,7 @@ export interface LocalEditorBrowserInspectorAssetPickerOption {
 export interface LocalEditorBrowserUiAssetItem {
     id: string;
     label: string;
+    relativePath?: string;
     guid?: string;
     assetId?: string;
     kind?: string;
@@ -364,6 +234,7 @@ export interface LocalEditorBrowserUiAssetItem {
     };
     origin?: string;
     dedupeKey?: string;
+    contentHash?: string;
     placeable?: boolean;
     preview?: LocalEditorBrowserAssetPreview;
     material?: LocalEditorBrowserMaterialAssetEditorData;
@@ -371,6 +242,45 @@ export interface LocalEditorBrowserUiAssetItem {
     meta?: string;
     disabled?: boolean;
 }
+export interface LocalEditorBrowserProjectFileItem {
+    path: string;
+    name: string;
+    parentPath: string | null;
+    kind: 'directory' | 'file';
+    extension?: string;
+}
+export interface LocalEditorBrowserProjectFileSnapshot {
+    rootName: string;
+    entries: LocalEditorBrowserProjectFileItem[];
+    truncated: boolean;
+}
+export interface LocalEditorBrowserProjectFileContent {
+    path: string;
+    name: string;
+    extension: string;
+    language: string;
+    text: string;
+    size: number;
+    truncated: boolean;
+}
+export interface LocalEditorBrowserProjectEntryAgentInput {
+    path: string;
+    name: string;
+    entryKind: 'file' | 'directory';
+    extension?: string;
+    assetId?: string;
+    assetKind?: string;
+}
+export interface LocalEditorBrowserProjectMediaSource {
+    path: string;
+    name: string;
+    extension: string;
+    kind: 'image' | 'model' | 'audio';
+    mimeType: string;
+    url: string;
+}
+export type LocalEditorBrowserProjectModelPreviewCleanup = () => void | Promise<void>;
+export type LocalEditorBrowserProjectModelThumbnail = string | null;
 export type LocalEditorBrowserTransformTool = EditorTransformTool;
 export type LocalEditorBrowserTransformSpace = EditorTransformSpace;
 export type LocalEditorBrowserTransformConstraint = EditorTransformConstraint;
@@ -398,7 +308,9 @@ export type LocalEditorBrowserViewportViewPreset = EditorViewportViewPreset;
 export type LocalEditorBrowserViewportProjectionMode = EditorViewportProjectionMode;
 export type LocalEditorBrowserViewportUtilityTool = EditorViewportUtilityTool;
 export type LocalEditorBrowserViewportOverlaySettings = EditorViewportOverlaySettings;
-export type LocalEditorBrowserViewportToolState = EditorViewportToolState;
+export interface LocalEditorBrowserViewportToolState extends EditorViewportToolState {
+    showAllPrefabMarkers: boolean;
+}
 export type LocalEditorBrowserViewportMeasurementState = EditorViewportGroundMeasurement;
 export type LocalEditorBrowserViewportSpatialOverlayState = EditorViewportSpatialOverlayState;
 export interface LocalEditorBrowserHistoryEntry {
@@ -633,20 +545,19 @@ export interface LocalEditorBrowserUiState<TDocument = unknown> {
     summary?: string;
     assetFilter: string;
     assets: LocalEditorBrowserUiAssetItem[];
+    projectFiles?: LocalEditorBrowserProjectFileSnapshot;
     selectedAssetId?: string | null;
     assetCountLabel?: string;
-    hierarchy: LocalEditorBrowserUiHierarchyItem[];
     selectedIds: string[];
     activeId: string | null;
     documentRevision?: number;
-    hierarchyProjectionRevision?: number;
-    hierarchyProjection?: LocalEditorBrowserHierarchyProjectionState | null;
     selectionSummary?: {
         count: number;
         activeId: string | null;
     } | null;
     inspectorObject?: LocalEditorBrowserInspectorObject<TDocument> | null;
     inspectorMultiObject?: LocalEditorBrowserInspectorObject<TDocument> | null;
+    inspectorPending?: boolean;
     renderingPanel?: LocalEditorBrowserRenderingPanelState | null;
     markerPanel?: LocalEditorBrowserMarkerPanelState | null;
     pluginPanel?: LocalEditorBrowserPluginPanelState | null;
@@ -658,6 +569,10 @@ export interface LocalEditorBrowserUiState<TDocument = unknown> {
         height: number;
     } | null;
     coordinateAxes?: LocalEditorBrowserCoordinateAxesState | null;
+    capabilities?: Readonly<Record<string, CapabilityAvailability>>;
+    tools?: readonly EditorToolPresentation[];
+    activeToolId?: string | null;
+    contextActions?: readonly EditorContextActionPresentation[];
     transformTool?: LocalEditorBrowserTransformToolState | null;
     transformOperations?: LocalEditorBrowserTransformOperationState | null;
     viewportTools?: LocalEditorBrowserViewportToolState | null;
@@ -857,7 +772,11 @@ export interface LocalEditorBrowserInspectorControlRenderContext<TDocument = unk
     property: LocalEditorBrowserInspectorProperty<TDocument>;
     bindInput(element: HTMLInputElement | HTMLSelectElement, options?: LocalEditorBrowserInspectorControlBindingOptions): void;
 }
-export type LocalEditorBrowserInspectorControlRenderer<TDocument = unknown> = (context: LocalEditorBrowserInspectorControlRenderContext<TDocument>) => HTMLElement;
+export interface LocalEditorBrowserInspectorControlMount {
+    element: HTMLElement;
+    dispose(): void;
+}
+export type LocalEditorBrowserInspectorControlRenderer<TDocument = unknown> = (context: LocalEditorBrowserInspectorControlRenderContext<TDocument>) => HTMLElement | LocalEditorBrowserInspectorControlMount;
 export interface LocalEditorBrowserInspectorControlRegistration<TDocument = unknown> {
     id: string;
     order?: number;
@@ -870,75 +789,11 @@ export interface LocalEditorBrowserInspectorOptions<TDocument = unknown> {
     controls?: readonly LocalEditorBrowserInspectorControlRegistration<TDocument>[];
     controlConflict?: LocalEditorBrowserInspectorConflictStrategy;
 }
-export interface LocalEditorBrowserHierarchySelectionInput {
-    id: string;
-    additive: boolean;
-    toggle: boolean;
-}
-export interface LocalEditorBrowserHierarchyEnabledChangeInput {
-    id: string;
-    enabled: boolean;
-}
-export type LocalEditorBrowserSceneGraphDropPlacement = 'inside' | 'before' | 'after';
-export type LocalEditorBrowserSceneGraphMovePlacement = LocalEditorBrowserSceneGraphDropPlacement | 'root';
-export interface LocalEditorBrowserSceneGraphRenameIntent {
-    id: string;
-    name: string;
-}
-export interface LocalEditorBrowserSceneGraphCreateGroupIntent {
-    parentId?: string | null;
-    activeId?: string | null;
-    name?: string;
-}
 export type LocalEditorBrowserPrimitiveShape = SceneGraphPrimitiveShape;
-export interface LocalEditorBrowserSceneGraphCreatePrimitiveIntent {
-    parentId?: string | null;
-    activeId?: string | null;
-    shape: LocalEditorBrowserPrimitiveShape;
-    name?: string;
-}
-export interface LocalEditorBrowserSceneGraphCreateMarkerIntent {
-    markerType?: string;
-    parentId?: string | null;
-    activeId?: string | null;
-    name?: string;
-}
-export interface LocalEditorBrowserSceneGraphDeleteIntent {
-    ids: string[];
-    activeId?: string | null;
-}
-export interface LocalEditorBrowserSceneGraphDuplicateIntent {
-    targetIds: string[];
-    activeId?: string | null;
-}
-export interface LocalEditorBrowserSceneGraphDropIntent {
-    draggedId: string;
-    targetId: string;
-    placement: LocalEditorBrowserSceneGraphDropPlacement;
-    preserveWorldTransform?: boolean;
-}
-export interface LocalEditorBrowserSceneGraphMoveIntent {
-    ids: string[];
-    targetId?: string | null;
-    placement: LocalEditorBrowserSceneGraphMovePlacement;
-    parentId?: string | null;
-    beforeId?: string | null;
-    afterId?: string | null;
-    preserveWorldTransform?: boolean;
-}
 export interface LocalEditorBrowserSceneGraphActionResult {
     ok: boolean;
     reason?: string;
 }
-export type LocalEditorBrowserSceneGraphActionResponse = LocalEditorBrowserSceneGraphActionResult | boolean | string | void;
-export interface LocalEditorBrowserSceneGraphGroupSelectionIntent {
-    ids: string[];
-    parentId?: string | null;
-    insertBeforeId?: string | null;
-    name?: string;
-    pivot?: 'selection-center' | 'active' | 'parent-origin';
-    preserveWorldTransform?: boolean;
-}
 export interface LocalEditorContextMenuItem {
     id: string;
     label: string;
@@ -949,88 +804,6 @@ export interface LocalEditorContextMenuItem {
     separatorBefore?: boolean;
     children?: LocalEditorContextMenuItem[];
 }
-export interface LocalEditorBrowserHierarchyContextActionContext<TDocument = unknown> {
-    state: LocalEditorBrowserUiState<TDocument>;
-    menuKind: 'node' | 'blank';
-    node: LocalEditorBrowserUiHierarchyItem | null;
-    contextNodeId: string | null;
-    targetIds: string[];
-    activeId: string | null;
-}
-export type LocalEditorBrowserHierarchyContextActionPlacement = 'top' | 'after-primary' | 'after-create' | 'after-edit' | 'after-clipboard' | 'bottom';
-export interface LocalEditorBrowserHierarchyContextActionChildRegistration<TDocument = unknown> {
-    id: string;
-    label: string;
-    shortcut?: string;
-    danger?: boolean;
-    disabled?(context: LocalEditorBrowserHierarchyContextActionContext<TDocument>): boolean | string;
-    payload?(context: LocalEditorBrowserHierarchyContextActionContext<TDocument>): Record<string, unknown> | undefined;
-}
-export interface LocalEditorBrowserHierarchyContextActionRegistration<TDocument = unknown> {
-    id: string;
-    commandId?: string;
-    label: string;
-    shortcut?: string;
-    danger?: boolean;
-    placement?: LocalEditorBrowserHierarchyContextActionPlacement;
-    separatorBefore?: boolean;
-    children?: readonly LocalEditorBrowserHierarchyContextActionChildRegistration<TDocument>[] | ((context: LocalEditorBrowserHierarchyContextActionContext<TDocument>) => readonly LocalEditorBrowserHierarchyContextActionChildRegistration<TDocument>[]);
-    visible?(context: LocalEditorBrowserHierarchyContextActionContext<TDocument>): boolean;
-    disabled?(context: LocalEditorBrowserHierarchyContextActionContext<TDocument>): boolean | string;
-    payload?(context: LocalEditorBrowserHierarchyContextActionContext<TDocument>): Record<string, unknown> | undefined;
-}
-export type LocalEditorContextAction = {
-    region: 'hierarchy';
-    action: 'focus';
-    targetIds: string[];
-    activeId: string | null;
-} | {
-    region: 'hierarchy';
-    action: 'rename';
-    targetId: string;
-} | {
-    region: 'hierarchy';
-    action: 'create-group';
-    parentId?: string | null;
-    activeId?: string | null;
-} | {
-    region: 'hierarchy';
-    action: 'create-primitive';
-    parentId?: string | null;
-    activeId?: string | null;
-    shape: LocalEditorBrowserPrimitiveShape;
-    name?: string;
-} | {
-    region: 'hierarchy';
-    action: 'create-marker';
-    parentId?: string | null;
-    activeId?: string | null;
-    markerType?: string;
-    name?: string;
-} | {
-    region: 'hierarchy';
-    action: 'delete';
-    targetIds: string[];
-    activeId?: string | null;
-} | {
-    region: 'hierarchy';
-    action: 'duplicate';
-    targetIds: string[];
-    activeId?: string | null;
-} | {
-    region: 'hierarchy';
-    action: 'paste';
-    sourceIds: string[];
-    activeId?: string | null;
-} | {
-    region: 'hierarchy';
-    action: 'custom';
-    id: string;
-    contextNodeId: string | null;
-    targetIds: string[];
-    activeId: string | null;
-    payload?: Record<string, unknown>;
-};
 export interface LocalEditorBrowserAssetActionInput {
     actionId: string;
     assetId?: string;
@@ -1039,10 +812,12 @@ export interface LocalEditorBrowserAssetActionInput {
     targetPrefabAssetId?: string;
     nodeId?: string;
     parentNodeId?: string;
+    placement?: 'inside' | 'before' | 'after' | 'root';
+    beforeNodeId?: string | null;
+    afterNodeId?: string | null;
     primitiveShape?: string;
     fieldPath?: string;
     value?: unknown;
-    hierarchyPrecondition?: LocalEditorBrowserHierarchyCommandPrecondition;
 }
 export interface LocalEditorBrowserUiCallbacks {
     onEnterEditor?: () => void;
@@ -1051,22 +826,26 @@ export interface LocalEditorBrowserUiCallbacks {
     onDiscardAndRunGame?: () => void;
     onUndo?: () => void;
     onRedo?: () => void;
-    onSelectHierarchyItem?: (input: LocalEditorBrowserHierarchySelectionInput, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
-    onHierarchyItemEnabledChange?: (input: LocalEditorBrowserHierarchyEnabledChangeInput, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
-    onSelectionCommand?: (command: SelectionCommand, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
+    onStatusDiagnosticLocate?: (diagnostic: LocalEditorBrowserStatusDiagnostic) => boolean | void | Promise<boolean | void>;
     onCreateFromAsset?: (assetId: string) => void;
     onSelectAsset?: (assetId: string) => void;
     onAssetAction?: (input: LocalEditorBrowserAssetActionInput) => void;
-    onExitPrefabStage?: () => void;
-    onSelectPrefabStageItem?: (itemId: string, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
     onAssetFilterChange?: (value: string) => void;
+    onAssetBrowserRefresh?: () => void | Promise<void>;
+    onProjectFileRead?: (path: string) => Promise<LocalEditorBrowserProjectFileContent>;
+    onProjectEntrySendToAgent?: (input: LocalEditorBrowserProjectEntryAgentInput) => void | Promise<void>;
+    onProjectMediaResolve?: (path: string) => LocalEditorBrowserProjectMediaSource | null | Promise<LocalEditorBrowserProjectMediaSource | null>;
+    onProjectModelPreviewMount?: (source: LocalEditorBrowserProjectMediaSource, canvas: HTMLCanvasElement, signal?: AbortSignal) => LocalEditorBrowserProjectModelPreviewCleanup | Promise<LocalEditorBrowserProjectModelPreviewCleanup>;
+    onProjectModelThumbnailResolve?: (source: LocalEditorBrowserProjectMediaSource, signal?: AbortSignal) => LocalEditorBrowserProjectModelThumbnail | Promise<LocalEditorBrowserProjectModelThumbnail>;
+    onMaterialPreviewMount?: (source: LocalEditorBrowserMaterialPreviewSource, canvas: HTMLCanvasElement) => LocalEditorBrowserMaterialPreviewCleanup | Promise<LocalEditorBrowserMaterialPreviewCleanup>;
     onPropertyInput?: (input: LocalEditorBrowserUiPropertyInput) => void;
     onInspectorAction?: (input: LocalEditorBrowserInspectorActionInput) => void;
     onRenderingPropertyChange?: (input: LocalEditorBrowserRenderingPropertyChangeInput) => void;
     onRenderingAction?: (input: LocalEditorBrowserRenderingActionInput) => void;
     onMarkerTypeAction?: (input: LocalEditorBrowserMarkerTypeActionInput) => void;
     onMarkerRelationAction?: (input: LocalEditorBrowserMarkerRelationActionInput) => void;
-    onTransformToolChange?: (tool: LocalEditorBrowserTransformTool) => void;
+    onToolActivate?: (toolId: string) => void;
+    onContextAction?: (actionId: string) => void;
     onTransformSpaceChange?: (space: LocalEditorBrowserTransformSpace) => void;
     onTransformConstraintChange?: (constraint: LocalEditorBrowserTransformConstraint) => void;
     onTransformSnapEnabledChange?: (enabled: boolean) => void;
@@ -1083,47 +862,39 @@ export interface LocalEditorBrowserUiCallbacks {
     onViewportMeasurementClear?: () => void;
     onSceneCameraPreviewToggle?: (enabled: boolean) => void;
     onMarkerViewportVisibilityChange?: (visible: boolean) => void;
+    onShowAllPrefabMarkersChange?: (visible: boolean) => void;
     onGridVisibleChange?: (visible: boolean) => void;
     onPerformanceMonitorOpenChange?: (open: boolean) => void;
-    onPrefabComparisonPreviewLayoutChange?: () => void;
-    onPrefabComparisonPreviewInteraction?: (input: LocalEditorBrowserPrefabComparisonPreviewInteraction) => void;
     onFocusSelection?: () => void;
     onCancelEditorIntent?: () => void;
     onCancelActiveOperation?: () => void;
-    onSceneGraphRename?: (intent: LocalEditorBrowserSceneGraphRenameIntent, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
-    onSceneGraphCreateGroup?: (intent: LocalEditorBrowserSceneGraphCreateGroupIntent, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
-    onSceneGraphCreatePrimitive?: (intent: LocalEditorBrowserSceneGraphCreatePrimitiveIntent, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
-    onSceneGraphCreateMarker?: (intent: LocalEditorBrowserSceneGraphCreateMarkerIntent, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
-    onSceneGraphDelete?: (intent: LocalEditorBrowserSceneGraphDeleteIntent, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
-    onSceneGraphDuplicate?: (intent: LocalEditorBrowserSceneGraphDuplicateIntent, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
-    onSceneGraphDrop?: (intent: LocalEditorBrowserSceneGraphDropIntent, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
-    onSceneGraphMove?: (intent: LocalEditorBrowserSceneGraphMoveIntent, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => LocalEditorBrowserSceneGraphActionResponse;
-    onSceneGraphGroupSelection?: (intent: LocalEditorBrowserSceneGraphGroupSelectionIntent, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
-    onContextAction?: (action: LocalEditorContextAction, precondition: LocalEditorBrowserHierarchyCommandPrecondition) => void;
 }
 export interface LocalEditorBrowserUiOptions<TDocument = unknown> {
     root?: HTMLElement;
     document?: Document;
     theme?: LocalEditorThemeName;
     localTestActions?: boolean;
+    gameModeEntryVisible?: boolean;
     input?: {
         isShortcutReserved?: (event: KeyboardEvent) => boolean;
     };
     callbacks?: LocalEditorBrowserUiCallbacks;
     inspector?: LocalEditorBrowserInspectorOptions<TDocument>;
     hierarchy?: {
-        contextActions?: readonly LocalEditorBrowserHierarchyContextActionRegistration<TDocument>[];
+        surface: HierarchySurfaceContribution;
+        kernel?: HierarchyKernel;
+        onOperationResult?: (result: HierarchyOperationResult) => void;
     };
 }
-export type LocalEditorBrowserUiPreviewState<TDocument = unknown> = Partial<Pick<LocalEditorBrowserUiState<TDocument>, 'status' | 'statusTone' | 'statusDetails' | 'inspectorObject' | 'inspectorMultiObject' | 'boxSelection' | 'coordinateAxes' | 'transformTool' | 'transformOperations' | 'viewportTools' | 'viewportMeasurement' | 'viewportSpatialOverlay' | 'sceneFrameStats' | 'performanceStats'>>;
+export type LocalEditorBrowserUiPreviewState<TDocument = unknown> = Partial<Pick<LocalEditorBrowserUiState<TDocument>, 'status' | 'statusTone' | 'statusDetails' | 'selectedIds' | 'activeId' | 'selectionSummary' | 'inspectorObject' | 'inspectorMultiObject' | 'inspectorPending' | 'boxSelection' | 'coordinateAxes' | 'tools' | 'activeToolId' | 'transformTool' | 'transformOperations' | 'viewportTools' | 'viewportMeasurement' | 'viewportSpatialOverlay' | 'sceneFrameStats' | 'performanceStats' | 'prefabStage'>>;
 export interface LocalEditorBrowserUi<TDocument = unknown> {
     update(state: LocalEditorBrowserUiState<TDocument>): void;
     updatePreview?(state: LocalEditorBrowserUiPreviewState<TDocument>): void;
     updateSceneFrameStats?(stats: LocalEditorBrowserSceneFrameStats | null): void;
     updatePerformanceStats?(stats: LocalEditorBrowserPerformanceStats | null): void;
-    getPrefabComparisonPreviewSurfaces?(): LocalEditorBrowserPrefabComparisonPreviewSurface[];
     alert(input: LocalEditorModalDialogInput): Promise<void>;
     confirm(input: LocalEditorModalDialogInput): Promise<boolean>;
+    choose(input: LocalEditorModalDialogChoiceInput): Promise<string | null>;
     setTheme?(theme: LocalEditorThemeName): void;
     getTheme?(): LocalEditorThemeName;
     dispose(): void;
@@ -1134,10 +905,10 @@ export interface LocalEditorThemeController {
 }
 export type LocalEditorBottomDockTab = 'assets' | 'history';
 export type LocalEditorRightDockTab = 'inspector' | 'rendering' | 'markers' | 'plugins';
-export type LocalEditorAssetBrowserTab = 'all' | 'models' | 'prefabs' | 'materials' | 'textures';
+export type LocalEditorAssetBrowserTab = 'all' | 'models' | 'prefabs' | 'materials' | 'textures' | 'audio';
 export type LocalEditorWorkbenchDockArea = 'left' | 'right' | 'bottom';
 export type LocalEditorWorkbenchPanelId = 'hierarchy' | LocalEditorRightDockTab | LocalEditorBottomDockTab;
-export type LocalEditorWorkbenchRegionId = 'top-app-bar' | 'left-dock' | 'scene-view' | 'scene-header' | 'right-dock' | 'bottom-dock';
+export type LocalEditorWorkbenchRegionId = 'top-app-bar' | 'left-dock' | 'scene-view' | 'scene-header' | 'right-dock' | 'bottom-dock' | 'bottom-console';
 export interface LocalEditorWorkbenchRegionDescriptor {
     id: LocalEditorWorkbenchRegionId;
     label: string;