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

package/node_modules/@fps-games/editor-browser/dist/local-editor-ui-hierarchy-controller.js

@@ -5,6 +5,7 @@ import { resolveLocalEditorHierarchyAutoScroll, } from './local-editor-ui-hierar
 import { clearLocalEditorStructuredDragSession, createLocalEditorStructuredDragSession, hasLocalEditorStructuredDragSessionFeedback, } from './local-editor-ui-structured-drag-session.js';
 import { renderLocalEditorHierarchyPanel, syncLocalEditorHierarchyDropPreview, } from './local-editor-ui-hierarchy-view.js';
 import { createLocalEditorActiveHierarchyScope, } from './local-editor-ui-hierarchy-scope.js';
+import { createLocalEditorHierarchyProjection, isLocalEditorHierarchyProjectionCurrent, } from './local-editor-ui-hierarchy-projection.js';
 import { resolveLocalEditorHierarchyCommandAdapter, } from './local-editor-ui-hierarchy-command-adapter.js';
 import { createLocalEditorViewportRevealController, } from './local-editor-ui-dock-panel.js';
 import { createLocalEditorHierarchyAttachDialog, } from './local-editor-ui-hierarchy-attach-dialog.js';
@@ -14,6 +15,11 @@ export function resolveLocalEditorHierarchyCreateMarkerParentId(activeNode) {
         ? activeNode.id
         : null;
 }
+export function resolveLocalEditorHierarchyToolbarActiveId(scope) {
+    return scope.activeId && scope.nodes.some(node => node.id === scope.activeId)
+        ? scope.activeId
+        : null;
+}
 export function createLocalEditorHierarchyController(options) {
     const { doc, panel, callbacks, inputRouter, contextMenu, getState, requestRender } = options;
     const collapsedIdsByScope = new Map();
@@ -29,6 +35,10 @@ export function createLocalEditorHierarchyController(options) {
     let currentModel = null;
     let lastRenderedActiveId;
     let lastRenderedScopeId;
+    let lastRenderedDocumentRevision = null;
+    let lastRenderedProjectionRevision = null;
+    let lastRenderedCommandPrecondition = null;
+    let attachDialogPrecondition = null;
     let pendingHierarchyScrollId = null;
     let hierarchySelectionAnchorId = null;
     const attachDialog = createLocalEditorHierarchyAttachDialog({
@@ -48,7 +58,23 @@ export function createLocalEditorHierarchyController(options) {
         return currentModel;
     };
     const render = (state) => {
-        const scope = resolveScope(state);
+        const rawScope = resolveScope(state);
+        const projection = isLocalEditorHierarchyProjectionCurrent(state.hierarchyProjection, rawScope)
+            ? state.hierarchyProjection
+            : createLocalEditorHierarchyProjection(rawScope);
+        const scope = {
+            ...rawScope,
+            nodes: projection.nodes,
+            selectedIds: projection.selectedIds,
+            activeId: projection.activeId,
+            readonly: rawScope.readonly || !projection.interactive,
+            commandSurface: projection.interactive ? rawScope.commandSurface : 'readonly',
+        };
+        const projectionChanged = lastRenderedScopeId != null && (scope.scopeId !== lastRenderedScopeId
+            || scope.documentRevision !== lastRenderedDocumentRevision
+            || scope.projectionRevision !== lastRenderedProjectionRevision);
+        if (projectionChanged)
+            resetHierarchyTransientState();
         const commandAdapter = resolveHierarchyCommandAdapter(scope);
         if (hierarchyRename && !scope.nodes.some(item => item.id === hierarchyRename?.id))
             hierarchyRename = null;
@@ -84,6 +110,9 @@ export function createLocalEditorHierarchyController(options) {
         }
         lastRenderedActiveId = scope.activeId;
         lastRenderedScopeId = scope.scopeId;
+        lastRenderedDocumentRevision = scope.documentRevision;
+        lastRenderedProjectionRevision = scope.projectionRevision;
+        lastRenderedCommandPrecondition = createHierarchyCommandPrecondition(scope);
     };
     const onClick = (event) => {
         const target = event.target instanceof HTMLElement ? event.target : null;
@@ -111,16 +140,22 @@ export function createLocalEditorHierarchyController(options) {
         const createGroupButton = target?.closest('[data-editor-hierarchy-create-group]');
         if (createGroupButton) {
             const state = getState();
-            if (!state || resolveScope(state).commandSurface !== 'scene-graph')
+            if (!state)
+                return;
+            const scope = resolveScope(state);
+            if (hasCurrentHierarchyProjection(scope) && scope.commandSurface !== 'scene-graph')
                 return;
-            const parentId = state.activeId ?? null;
+            const parentId = resolveLocalEditorHierarchyToolbarActiveId(scope);
             if (parentId)
                 expandNode(parentId);
+            const precondition = lastRenderedCommandPrecondition;
+            if (!precondition)
+                return;
             callbacks.onSceneGraphCreateGroup?.({
                 parentId,
                 activeId: parentId,
                 name: 'Empty',
-            });
+            }, precondition);
             return;
         }
         const createMarkerButton = target?.closest('[data-editor-hierarchy-create-marker]');
@@ -185,6 +220,9 @@ export function createLocalEditorHierarchyController(options) {
         hierarchyRename = {
             id: input.dataset.editorHierarchyRenameInput,
             value: input.value,
+            initialValue: hierarchyRename.initialValue,
+            commandTargetId: hierarchyRename.commandTargetId,
+            precondition: hierarchyRename.precondition,
         };
     };
     const onKeyDown = (event) => {
@@ -251,7 +289,12 @@ export function createLocalEditorHierarchyController(options) {
             event.preventDefault();
             return;
         }
-        hierarchyDrag = { id };
+        const precondition = lastRenderedCommandPrecondition;
+        if (!precondition) {
+            event.preventDefault();
+            return;
+        }
+        hierarchyDrag = { id, precondition };
         const draggedIds = resolveDraggedIds(state, model, id);
         event.dataTransfer?.setData('text/plain', draggedIds.join(','));
         if (event.dataTransfer)
@@ -329,8 +372,9 @@ export function createLocalEditorHierarchyController(options) {
     const onDrop = (event) => {
         const state = getState();
         const target = event.target instanceof HTMLElement ? event.target : null;
+        const activeDrag = hierarchyDrag;
         const draggedIds = readDraggedIds(event);
-        if (!state || draggedIds.length === 0) {
+        if (!state || !activeDrag || draggedIds.length === 0) {
             clearHierarchyDragFeedbackAndRender();
             return;
         }
@@ -350,6 +394,7 @@ export function createLocalEditorHierarchyController(options) {
             return;
         }
         event.preventDefault();
+        const dropPrecondition = activeDrag.precondition;
         hierarchyDrag = null;
         clearHierarchyDragFeedback();
         if (operation.slot.placement === 'root') {
@@ -357,7 +402,7 @@ export function createLocalEditorHierarchyController(options) {
                 requestRender();
                 return;
             }
-            submitResolvedRootDrop(operation.resolution);
+            submitResolvedRootDrop(operation.resolution, dropPrecondition);
             return;
         }
         const targetId = operation.slot.targetId;
@@ -371,11 +416,13 @@ export function createLocalEditorHierarchyController(options) {
                 requestRender();
                 return;
             }
-            submitPrefabNodeReparent(scope, operation.resolution.draggedIds[0] ?? draggedIds[0], targetId);
+            if (dropPrecondition) {
+                submitPrefabNodeReparent(scope, operation.resolution.draggedIds[0] ?? draggedIds[0], targetId, dropPrecondition);
+            }
             requestRender();
             return;
         }
-        submitResolvedDrop(operation.resolution, targetId, operation.slot.placement, draggedIds);
+        submitResolvedDrop(operation.resolution, targetId, operation.slot.placement, draggedIds, dropPrecondition);
     };
     panel.addEventListener('click', onClick);
     panel.addEventListener('contextmenu', onContextMenu);
@@ -436,7 +483,10 @@ export function createLocalEditorHierarchyController(options) {
         if (!action)
             return false;
         event.preventDefault();
-        submitHierarchyAction(action);
+        const precondition = lastRenderedCommandPrecondition;
+        if (!precondition)
+            return false;
+        submitHierarchyAction(action, precondition);
         return true;
     }
     function handleEditShortcut(event) {
@@ -473,14 +523,33 @@ export function createLocalEditorHierarchyController(options) {
         if (!action)
             return false;
         event.preventDefault();
-        submitHierarchyAction(action);
+        const precondition = lastRenderedCommandPrecondition;
+        if (!precondition)
+            return false;
+        submitHierarchyAction(action, precondition);
         return true;
     }
     function isComposingInputEvent(event) {
         return event.isComposing === true;
     }
     function resolveScope(state) {
-        return createLocalEditorActiveHierarchyScope(state);
+        const scope = createLocalEditorActiveHierarchyScope(state);
+        const projection = isLocalEditorHierarchyProjectionCurrent(state.hierarchyProjection, scope)
+            ? state.hierarchyProjection
+            : createLocalEditorHierarchyProjection(scope);
+        return {
+            ...scope,
+            nodes: projection.nodes,
+            selectedIds: projection.selectedIds,
+            activeId: projection.activeId,
+            readonly: scope.readonly || !projection.interactive,
+            commandSurface: projection.interactive ? scope.commandSurface : 'readonly',
+        };
+    }
+    function hasCurrentHierarchyProjection(scope) {
+        return scope.scopeId === lastRenderedScopeId
+            && scope.documentRevision === lastRenderedDocumentRevision
+            && scope.projectionRevision === lastRenderedProjectionRevision;
     }
     function resolveScopeForCurrentState() {
         const state = getState();
@@ -505,7 +574,10 @@ export function createLocalEditorHierarchyController(options) {
     }
     function selectHierarchyItemFromClick(id, event) {
         const scope = resolveScopeForCurrentState();
-        if (!scope)
+        const precondition = lastRenderedCommandPrecondition;
+        if (!scope || !precondition)
+            return;
+        if (hasCurrentHierarchyProjection(scope) && scope.commandSurface === 'readonly')
             return;
         const toggle = event.metaKey || event.ctrlKey;
         const range = event.shiftKey && !toggle;
@@ -514,10 +586,10 @@ export function createLocalEditorHierarchyController(options) {
             return;
         }
         hierarchySelectionAnchorId = id;
-        if (scope.kind === 'prefab-stage')
-            callbacks.onSelectPrefabStageItem?.(id);
+        if (precondition.scopeId.startsWith('prefab-stage:'))
+            callbacks.onSelectPrefabStageItem?.(id, precondition);
         else
-            callbacks.onSelectHierarchyItem?.({ id, additive: false, toggle });
+            callbacks.onSelectHierarchyItem?.({ id, additive: false, toggle }, precondition);
     }
     function toggleHierarchyItemEnabled(id, toggle) {
         if (toggle.dataset.editorHierarchyEnabledToggleDisabled === 'true')
@@ -525,7 +597,8 @@ export function createLocalEditorHierarchyController(options) {
         const state = getState();
         if (!state)
             return;
-        if (resolveScope(state).commandSurface !== 'scene-graph')
+        const scope = resolveScope(state);
+        if (hasCurrentHierarchyProjection(scope) && scope.commandSurface !== 'scene-graph')
             return;
         const node = getModel(state).getNode(id);
         if (!node || !canLocalEditorHierarchyNodeToggleEnabled(node))
@@ -533,10 +606,13 @@ export function createLocalEditorHierarchyController(options) {
         const directEnabled = typeof node.item.directEnabled === 'boolean'
             ? node.item.directEnabled
             : node.item.enabled;
+        const precondition = lastRenderedCommandPrecondition;
+        if (!precondition)
+            return;
         callbacks.onHierarchyItemEnabledChange?.({
             id,
             enabled: directEnabled === false,
-        });
+        }, precondition);
     }
     function selectHierarchyVisibleRange(targetId) {
         const state = getState();
@@ -548,7 +624,10 @@ export function createLocalEditorHierarchyController(options) {
         const scope = resolveScope(state);
         if (scope.kind !== 'scene') {
             hierarchySelectionAnchorId = targetId;
-            callbacks.onSelectPrefabStageItem?.(targetId);
+            const precondition = lastRenderedCommandPrecondition;
+            if (!precondition)
+                return;
+            callbacks.onSelectPrefabStageItem?.(targetId, precondition);
             return;
         }
         const model = getModel(state);
@@ -581,13 +660,21 @@ export function createLocalEditorHierarchyController(options) {
             .filter(Boolean) ?? [];
         return dataTransferIds.length > 0 ? dataTransferIds : hierarchyDrag?.id ? [hierarchyDrag.id] : [];
     }
-    function submitResolvedRootDrop(resolved) {
+    function submitResolvedRootDrop(resolved, precondition) {
+        const state = getState();
+        if (!state)
+            return;
+        const scope = resolveScope(state);
+        if (hasCurrentHierarchyProjection(scope) && scope.commandSurface !== 'scene-graph')
+            return;
+        if (!precondition)
+            return;
         callbacks.onSceneGraphMove?.({
             ids: resolved.draggedIds,
             targetId: null,
             placement: 'root',
             preserveWorldTransform: true,
-        });
+        }, precondition);
         requestRender();
     }
     function toggleExpanded(id) {
@@ -671,6 +758,18 @@ export function createLocalEditorHierarchyController(options) {
         stopHierarchyAutoScroll();
         clearLocalEditorStructuredDragSession(hierarchyDragSession);
     }
+    function resetHierarchyTransientState() {
+        hierarchyRename = null;
+        hierarchyDrag = null;
+        hierarchySelectionAnchorId = null;
+        hierarchyClipboard = null;
+        hierarchySearchComposing = false;
+        pendingHierarchyScrollId = null;
+        attachDialogPrecondition = null;
+        clearHierarchyDragFeedback();
+        attachDialog.close();
+        contextMenu.close();
+    }
     function hasHierarchyDragFeedback() {
         return hierarchyDrop !== null
             || hierarchyRootDrop
@@ -788,58 +887,71 @@ export function createLocalEditorHierarchyController(options) {
     function commitHierarchyRename(id, value) {
         if (!hierarchyRename || hierarchyRename.id !== id)
             return;
+        const precondition = hierarchyRename.precondition;
+        const initialValue = hierarchyRename.initialValue;
+        const commandTargetId = hierarchyRename.commandTargetId;
         const trimmed = value.trim();
         const state = getState();
         const scope = state ? resolveScope(state) : null;
-        const item = scope?.nodes.find(candidate => candidate.id === id) ?? null;
         hierarchyRename = null;
-        if (trimmed && item && trimmed !== item.label) {
-            if (scope?.commandSurface === 'scene-graph') {
-                callbacks.onSceneGraphRename?.({ id, name: trimmed });
+        if (trimmed && trimmed !== initialValue) {
+            if (!precondition.scopeId.startsWith('prefab-stage:')) {
+                callbacks.onSceneGraphRename?.({ id, name: trimmed }, precondition);
             }
-            else if (scope?.commandSurface === 'prefab-composition') {
-                callbacks.onAssetAction?.(createPrefabNodeAssetAction(scope, 'prefab.node.rename', resolvePrefabCommandTargetId(scope, id), {
+            else if (scope) {
+                callbacks.onAssetAction?.(createPrefabNodeAssetAction(scope, 'prefab.node.rename', commandTargetId, {
                     value: trimmed,
-                }));
+                }, precondition));
             }
         }
         requestRender();
     }
     function openHierarchyContextMenu(event) {
+        const target = inputRouter.claimContextMenu(event);
         const hadHierarchyFeedback = hasHierarchyDragFeedback();
         hierarchyDrag = null;
         clearHierarchyDragFeedback();
-        const target = event.target instanceof HTMLElement ? event.target : null;
-        if (!target || inputRouter.isEditableTarget(target)) {
+        if (!target) {
             if (hadHierarchyFeedback)
                 requestRender();
             return;
         }
-        const state = getState();
-        if (!state || state.mode !== 'editor' || state.busy) {
+        const initialState = getState();
+        if (!initialState || initialState.mode !== 'editor' || initialState.busy) {
             if (hadHierarchyFeedback)
                 requestRender();
             return;
         }
-        const scope = resolveScope(state);
-        const commandAdapter = resolveHierarchyCommandAdapter(scope);
-        const model = getModel(state);
+        const initialScope = resolveScope(initialState);
+        const initialPrecondition = lastRenderedCommandPrecondition;
+        if (!initialPrecondition)
+            return;
+        const initialModel = getModel(initialState);
         const hierarchyButton = target.closest('[data-editor-hierarchy-id]');
-        const node = model.getNode(hierarchyButton?.dataset.editorHierarchyId);
-        if (node && !scope.selectedIds.includes(node.id) && isLocalEditorHierarchyNodeSelectable(node)) {
-            hierarchySelectionAnchorId = node.id;
-            if (scope.kind === 'prefab-stage')
-                callbacks.onSelectPrefabStageItem?.(node.id);
+        const requestedNodeId = hierarchyButton?.dataset.editorHierarchyId;
+        const initialNode = initialModel.getNode(requestedNodeId);
+        if (initialNode && !initialScope.selectedIds.includes(initialNode.id) && isLocalEditorHierarchyNodeSelectable(initialNode)) {
+            hierarchySelectionAnchorId = initialNode.id;
+            if (initialScope.kind === 'prefab-stage')
+                callbacks.onSelectPrefabStageItem?.(initialNode.id, initialPrecondition);
             else
-                callbacks.onSelectHierarchyItem?.({ id: node.id, additive: false, toggle: false });
+                callbacks.onSelectHierarchyItem?.({ id: initialNode.id, additive: false, toggle: false }, initialPrecondition);
         }
+        const state = getState();
+        if (!state || state.mode !== 'editor' || state.busy)
+            return;
+        const scope = resolveScope(state);
+        const precondition = lastRenderedCommandPrecondition;
+        if (!precondition)
+            return;
+        const commandAdapter = resolveHierarchyCommandAdapter(scope);
+        const model = getModel(state);
+        const node = model.getNode(requestedNodeId);
         if (!commandAdapter.canOpenContextMenu) {
             if (hadHierarchyFeedback)
                 requestRender();
             return;
         }
-        event.preventDefault();
-        event.stopPropagation();
         options.onBeforeOpenContextMenu?.();
         const menuState = createScopedHierarchyMenuState(state, scope);
         const menu = node
@@ -873,7 +985,7 @@ export function createLocalEditorHierarchyController(options) {
             onAction(item) {
                 const action = menu.actions.get(item.id);
                 if (action)
-                    submitHierarchyAction(action);
+                    submitHierarchyAction(action, precondition);
             },
         });
         if (hadHierarchyFeedback)
@@ -883,21 +995,34 @@ export function createLocalEditorHierarchyController(options) {
         const state = getState();
         if (!state || state.mode !== 'editor' || state.busy)
             return;
+        const scope = resolveScope(state);
+        if (hasCurrentHierarchyProjection(scope) && scope.commandSurface !== 'scene-graph')
+            return;
+        const precondition = lastRenderedCommandPrecondition;
+        if (!precondition)
+            return;
         const model = getModel(state);
-        const activeNode = model.getNode(state.activeId);
+        const toolbarActiveId = resolveLocalEditorHierarchyToolbarActiveId(scope);
+        const activeNode = model.getNode(toolbarActiveId);
         const parentId = resolveLocalEditorHierarchyCreateMarkerParentId(activeNode);
         if (parentId)
             expandNode(parentId);
         callbacks.onSceneGraphCreateMarker?.({
             parentId,
-            activeId: parentId ?? state.activeId ?? null,
+            activeId: parentId ?? toolbarActiveId,
             name: 'Marker',
-        });
+        }, precondition);
         requestRender();
     }
-    function submitHierarchyAction(action) {
+    function submitHierarchyAction(action, precondition) {
+        const state = getState();
+        if (!state || !precondition)
+            return;
+        const scope = resolveScope(state);
+        if (hasCurrentHierarchyProjection(scope) && scope.commandSurface === 'readonly')
+            return;
         if (action.kind === 'begin-rename') {
-            beginHierarchyRename(action.targetId);
+            beginHierarchyRename(action.targetId, precondition);
             return;
         }
         if (action.kind === 'copy-selection') {
@@ -910,18 +1035,18 @@ export function createLocalEditorHierarchyController(options) {
             return;
         }
         if (action.kind === 'group-selection') {
-            callbacks.onSceneGraphGroupSelection?.(action.intent);
+            callbacks.onSceneGraphGroupSelection?.(action.intent, precondition);
             return;
         }
         if (action.kind === 'open-attach-picker') {
-            openAttachPicker(action.targetIds, action.activeId);
+            openAttachPicker(action.targetIds, action.activeId, precondition);
             return;
         }
         if (action.kind === 'selection-command') {
-            submitSelectionCommand(action.command);
+            submitSelectionCommand(action.command, state, precondition);
             return;
         }
-        submitHierarchyContextAction(action.action);
+        submitHierarchyContextAction(action.action, precondition);
     }
     function createScopedHierarchyMenuState(state, scope) {
         return {
@@ -931,17 +1056,23 @@ export function createLocalEditorHierarchyController(options) {
             activeId: scope.activeId,
         };
     }
-    function submitSelectionCommand(command, state = getState() ?? undefined) {
-        if (state && resolveScope(state).kind !== 'scene')
+    function submitSelectionCommand(command, state = getState() ?? undefined, precondition = lastRenderedCommandPrecondition) {
+        if (!state)
+            return;
+        const scope = resolveScope(state);
+        if (!precondition)
+            return;
+        if (hasCurrentHierarchyProjection(scope) && scope.kind !== 'scene')
             return;
-        callbacks.onSelectionCommand?.(command);
+        callbacks.onSelectionCommand?.(command, precondition);
     }
-    function openAttachPicker(targetIds, activeId) {
+    function openAttachPicker(targetIds, activeId, precondition = lastRenderedCommandPrecondition) {
         const state = getState();
-        if (!state || state.mode !== 'editor' || state.busy || targetIds.length === 0)
+        if (!state || !precondition || state.mode !== 'editor' || state.busy || targetIds.length === 0)
             return;
         if (!resolveHierarchyCommandAdapter(resolveScope(state)).menuCapabilities.hasMoveHandler)
             return;
+        attachDialogPrecondition = precondition;
         attachDialog.open({
             model: getModel(state),
             targetIds,
@@ -950,11 +1081,14 @@ export function createLocalEditorHierarchyController(options) {
     }
     function submitAttachSelection(selection) {
         const state = getState();
-        if (!state || state.mode !== 'editor' || state.busy)
+        const precondition = attachDialogPrecondition;
+        attachDialogPrecondition = null;
+        if (!state || !precondition || state.mode !== 'editor' || state.busy)
             return { ok: false, reason: 'Editor is not ready.' };
         const scope = resolveScope(state);
-        if (scope.commandSurface === 'prefab-composition')
-            return submitPrefabAttachSelection(scope, selection);
+        if (scope.commandSurface === 'prefab-composition') {
+            return submitPrefabAttachSelection(scope, selection, precondition);
+        }
         if (scope.commandSurface !== 'scene-graph')
             return { ok: false, reason: 'Hierarchy move pipeline is not connected yet.' };
         const ids = selection.resolution.draggedIds;
@@ -967,7 +1101,7 @@ export function createLocalEditorHierarchyController(options) {
                 ids,
                 placement: 'root',
                 preserveWorldTransform: true,
-            }));
+            }, precondition));
             requestRender();
             return result;
         }
@@ -982,11 +1116,11 @@ export function createLocalEditorHierarchyController(options) {
             beforeId: selection.resolution.beforeId,
             afterId: selection.resolution.afterId,
             preserveWorldTransform: true,
-        }));
+        }, precondition));
         requestRender();
         return result;
     }
-    function submitPrefabAttachSelection(scope, selection) {
+    function submitPrefabAttachSelection(scope, selection, precondition) {
         const ids = selection.resolution.draggedIds;
         if (ids.length !== 1)
             return { ok: false, reason: 'Move one prefab node at a time.' };
@@ -994,21 +1128,21 @@ export function createLocalEditorHierarchyController(options) {
             return { ok: false, reason: 'Prefab node reparent supports inside placement only.' };
         if (!selection.targetId)
             return { ok: false, reason: 'Select a valid prefab parent first.' };
-        if (!submitPrefabNodeReparent(scope, ids[0], selection.targetId)) {
+        if (!submitPrefabNodeReparent(scope, ids[0], selection.targetId, precondition)) {
             return { ok: false, reason: 'Select valid prefab nodes first.' };
         }
         expandNode(selection.targetId);
         requestRender();
         return { ok: true };
     }
-    function submitPrefabNodeReparent(scope, hierarchyId, parentHierarchyId) {
+    function submitPrefabNodeReparent(scope, hierarchyId, parentHierarchyId, precondition) {
         const nodeId = resolvePrefabCommandTargetId(scope, hierarchyId);
         const parentNodeId = resolvePrefabCommandTargetId(scope, parentHierarchyId);
         if (!nodeId || !parentNodeId)
             return false;
         callbacks.onAssetAction?.(createPrefabNodeAssetAction(scope, 'prefab.node.reparent', nodeId, {
             parentNodeId,
-        }));
+        }, precondition));
         return true;
     }
     function normalizeAttachSceneGraphMoveResult(result) {
@@ -1053,21 +1187,26 @@ export function createLocalEditorHierarchyController(options) {
         const target = event.target instanceof Node ? event.target : null;
         return target !== null && panel.contains(target);
     }
-    function submitHierarchyContextAction(action) {
+    function submitHierarchyContextAction(action, precondition) {
         if (action.action === 'rename')
             return;
         const scope = resolveScopeForCurrentState();
-        if (scope?.commandSurface === 'prefab-composition') {
-            submitPrefabHierarchyContextAction(scope, action);
+        if (!scope)
+            return;
+        const current = hasCurrentHierarchyProjection(scope);
+        if (precondition.scopeId.startsWith('prefab-stage:')) {
+            if (current && scope.commandSurface !== 'prefab-composition')
+                return;
+            submitPrefabHierarchyContextAction(scope, action, precondition);
             return;
         }
-        if (scope?.commandSurface !== 'scene-graph')
+        if (current && scope.commandSurface !== 'scene-graph')
             return;
         if (action.action === 'create-group' || action.action === 'create-primitive' || action.action === 'create-marker') {
             expandNode(action.parentId);
         }
         if (callbacks.onContextAction) {
-            callbacks.onContextAction(action);
+            callbacks.onContextAction(action, precondition);
             return;
         }
         if (action.action === 'focus')
@@ -1076,20 +1215,20 @@ export function createLocalEditorHierarchyController(options) {
             callbacks.onSceneGraphDuplicate?.({
                 targetIds: action.targetIds,
                 activeId: action.activeId ?? null,
-            });
+            }, precondition);
         }
         else if (action.action === 'paste') {
             callbacks.onSceneGraphDuplicate?.({
                 targetIds: action.sourceIds,
                 activeId: action.activeId ?? null,
-            });
+            }, precondition);
         }
         else if (action.action === 'create-group') {
             callbacks.onSceneGraphCreateGroup?.({
                 parentId: action.parentId ?? null,
                 activeId: action.activeId ?? null,
                 name: 'Empty',
-            });
+            }, precondition);
         }
         else if (action.action === 'create-marker') {
             callbacks.onSceneGraphCreateMarker?.({
@@ -1097,7 +1236,7 @@ export function createLocalEditorHierarchyController(options) {
                 activeId: action.activeId ?? null,
                 markerType: action.markerType,
                 name: action.name,
-            });
+            }, precondition);
         }
         else if (action.action === 'create-primitive') {
             callbacks.onSceneGraphCreatePrimitive?.({
@@ -1105,20 +1244,20 @@ export function createLocalEditorHierarchyController(options) {
                 activeId: action.activeId ?? null,
                 shape: action.shape,
                 name: action.name,
-            });
+            }, precondition);
         }
         else if (action.action === 'delete') {
             callbacks.onSceneGraphDelete?.({
                 ids: action.targetIds,
                 activeId: action.activeId ?? null,
-            });
+            }, precondition);
         }
     }
-    function submitPrefabHierarchyContextAction(scope, action) {
+    function submitPrefabHierarchyContextAction(scope, action, precondition) {
         if (action.action === 'focus') {
             const targetId = action.activeId ?? action.targetIds[0] ?? null;
             if (targetId)
-                callbacks.onSelectPrefabStageItem?.(targetId);
+                callbacks.onSelectPrefabStageItem?.(targetId, precondition);
             return;
         }
         if (action.action === 'create-primitive') {
@@ -1126,7 +1265,7 @@ export function createLocalEditorHierarchyController(options) {
                 expandNode(action.parentId);
             callbacks.onAssetAction?.(createPrefabNodeAssetAction(scope, 'prefab.node.createPrimitive', resolvePrefabCommandTargetId(scope, action.parentId ?? scope.activeId), {
                 primitiveShape: action.shape,
-            }));
+            }, precondition));
             return;
         }
         if (action.action === 'create-group') {
@@ -1134,7 +1273,7 @@ export function createLocalEditorHierarchyController(options) {
                 expandNode(action.parentId);
             callbacks.onAssetAction?.(createPrefabNodeAssetAction(scope, 'prefab.node.createGroup', resolvePrefabCommandTargetId(scope, action.parentId ?? scope.activeId), {
                 value: { name: 'Empty' },
-            }));
+            }, precondition));
             return;
         }
         if (action.action === 'delete') {
@@ -1143,7 +1282,7 @@ export function createLocalEditorHierarchyController(options) {
                 : action.targetIds[0] ?? null;
             if (!nodeId)
                 return;
-            callbacks.onAssetAction?.(createPrefabNodeAssetAction(scope, 'prefab.node.delete', resolvePrefabCommandTargetId(scope, nodeId)));
+            callbacks.onAssetAction?.(createPrefabNodeAssetAction(scope, 'prefab.node.delete', resolvePrefabCommandTargetId(scope, nodeId), {}, precondition));
         }
     }
     function resolvePrefabCommandTargetId(scope, hierarchyId) {
@@ -1152,9 +1291,9 @@ export function createLocalEditorHierarchyController(options) {
         const node = scope.nodes.find(candidate => candidate.id === hierarchyId);
         return node?.commandTargetId ?? hierarchyId;
     }
-    function createPrefabNodeAssetAction(scope, actionId, nodeId, extra = {}) {
-        const stageAssetId = scope.scopeId.startsWith('prefab-stage:')
-            ? scope.scopeId.slice('prefab-stage:'.length)
+    function createPrefabNodeAssetAction(scope, actionId, nodeId, extra = {}, precondition) {
+        const stageAssetId = precondition.scopeId.startsWith('prefab-stage:')
+            ? precondition.scopeId.slice('prefab-stage:'.length)
             : undefined;
         return {
             actionId,
@@ -1162,6 +1301,7 @@ export function createLocalEditorHierarchyController(options) {
             browserAssetId: stageAssetId ? `prefab:${stageAssetId}` : undefined,
             assetKind: 'prefab',
             targetPrefabAssetId: stageAssetId,
+            hierarchyPrecondition: precondition,
             ...(nodeId ? { nodeId, parentNodeId: nodeId } : {}),
             ...extra,
         };
@@ -1178,23 +1318,42 @@ export function createLocalEditorHierarchyController(options) {
         const theme = themed?.dataset.fpsEditorTheme;
         return theme === 'light' || theme === 'dark' ? theme : undefined;
     }
-    function beginHierarchyRename(id) {
+    function beginHierarchyRename(id, precondition) {
         const state = getState();
+        const scope = state ? resolveScope(state) : null;
         const model = state ? getModel(state) : null;
         const node = model?.getNode(id) ?? null;
         if (!node || !canLocalEditorHierarchyNodeRename(node))
             return;
-        hierarchyRename = { id, value: node.label };
+        hierarchyRename = {
+            id,
+            value: node.label,
+            initialValue: node.label,
+            commandTargetId: scope?.nodes.find(candidate => candidate.id === id)?.commandTargetId ?? id,
+            precondition,
+        };
         requestRender();
     }
     function selectSingleHierarchyItem(id) {
         const scope = resolveScopeForCurrentState();
-        if (scope?.kind === 'prefab-stage')
-            callbacks.onSelectPrefabStageItem?.(id);
+        const precondition = lastRenderedCommandPrecondition;
+        if (!scope || !precondition)
+            return;
+        if (hasCurrentHierarchyProjection(scope) && scope.commandSurface === 'readonly')
+            return;
+        if (precondition.scopeId.startsWith('prefab-stage:'))
+            callbacks.onSelectPrefabStageItem?.(id, precondition);
         else
-            callbacks.onSelectHierarchyItem?.({ id, additive: false, toggle: false });
+            callbacks.onSelectHierarchyItem?.({ id, additive: false, toggle: false }, precondition);
     }
-    function submitResolvedDrop(resolved, targetId, placement, draggedIds) {
+    function submitResolvedDrop(resolved, targetId, placement, draggedIds, precondition) {
+        const scope = resolveScopeForCurrentState();
+        if (!scope)
+            return;
+        if (hasCurrentHierarchyProjection(scope) && scope.commandSurface !== 'scene-graph')
+            return;
+        if (!precondition)
+            return;
         if (callbacks.onSceneGraphMove) {
             callbacks.onSceneGraphMove({
                 ids: resolved.draggedIds,
@@ -1204,7 +1363,7 @@ export function createLocalEditorHierarchyController(options) {
                 beforeId: resolved.beforeId,
                 afterId: resolved.afterId,
                 preserveWorldTransform: true,
-            });
+            }, precondition);
         }
         else if (placement === 'inside') {
             callbacks.onSceneGraphDrop?.({
@@ -1212,11 +1371,18 @@ export function createLocalEditorHierarchyController(options) {
                 targetId,
                 placement,
                 preserveWorldTransform: true,
-            });
+            }, precondition);
         }
         else {
             requestRender();
         }
     }
+    function createHierarchyCommandPrecondition(scope) {
+        return {
+            scopeId: scope.scopeId,
+            documentRevision: scope.documentRevision,
+            projectionRevision: scope.projectionRevision,
+        };
+    }
 }
 //# sourceMappingURL=local-editor-ui-hierarchy-controller.js.map