@fps-games/editor 0.1.6-beta.1 → 0.1.7-beta.1

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

@@ -1,9 +1,11 @@
 import { createLocalEditorHierarchyBlankMenu, createLocalEditorHierarchyCopyShortcutAction, createLocalEditorHierarchyDeleteShortcutAction, createLocalEditorHierarchyDuplicateShortcutAction, createLocalEditorHierarchyNodeMenu, createLocalEditorHierarchyPasteShortcutAction, createLocalEditorHierarchySelectAllShortcutAction, } from './local-editor-ui-hierarchy-actions.js';
-import { canLocalEditorHierarchyNodeHaveChildren, createLocalEditorHierarchyTreeModel, isLocalEditorHierarchyNodeSelectable, isLocalEditorHierarchyNodeMovable, } from './local-editor-ui-hierarchy-tree.js';
+import { canLocalEditorHierarchyNodeHaveChildren, canLocalEditorHierarchyNodeRename, canLocalEditorHierarchyNodeToggleEnabled, createLocalEditorHierarchyTreeModel, isLocalEditorHierarchyNodeSelectable, isLocalEditorHierarchyNodeMovable, } from './local-editor-ui-hierarchy-tree.js';
 import { resolveLocalEditorHierarchyDragOperation, } from './local-editor-ui-hierarchy-drag-policy.js';
 import { resolveLocalEditorHierarchyAutoScroll, } from './local-editor-ui-hierarchy-auto-scroll.js';
 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 { 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';
 const HIERARCHY_DRAG_INDENT_WIDTH = 16;
@@ -14,7 +16,8 @@ export function resolveLocalEditorHierarchyCreateMarkerParentId(activeNode) {
 }
 export function createLocalEditorHierarchyController(options) {
     const { doc, panel, callbacks, inputRouter, contextMenu, getState, requestRender } = options;
-    const collapsedIds = new Set();
+    const collapsedIdsByScope = new Map();
+    const hierarchySearchByScope = new Map();
     let hierarchyRename = null;
     let hierarchyDrag = null;
     let hierarchyDrop = null;
@@ -22,10 +25,10 @@ export function createLocalEditorHierarchyController(options) {
     const hierarchyDragSession = createLocalEditorStructuredDragSession();
     let hierarchyShortcutScopeActive = false;
     let hierarchyClipboard = null;
-    let hierarchySearch = '';
     let hierarchySearchComposing = false;
     let currentModel = null;
     let lastRenderedActiveId;
+    let lastRenderedScopeId;
     let pendingHierarchyScrollId = null;
     let hierarchySelectionAnchorId = null;
     const attachDialog = createLocalEditorHierarchyAttachDialog({
@@ -45,15 +48,18 @@ export function createLocalEditorHierarchyController(options) {
         return currentModel;
     };
     const render = (state) => {
-        if (hierarchyRename && !state.hierarchy.some(item => item.id === hierarchyRename?.id))
+        const scope = resolveScope(state);
+        const commandAdapter = resolveHierarchyCommandAdapter(scope);
+        if (hierarchyRename && !scope.nodes.some(item => item.id === hierarchyRename?.id))
             hierarchyRename = null;
-        const activeIdChanged = state.activeId !== lastRenderedActiveId;
+        const scopeChanged = scope.scopeId !== lastRenderedScopeId;
+        const activeIdChanged = scope.activeId !== lastRenderedActiveId || scopeChanged;
         const treeScrollSnapshot = treeViewportReveal.captureScrollSnapshot();
         if (activeIdChanged) {
             pendingHierarchyScrollId = null;
-            expandActiveHierarchyPath(state);
+            expandActiveHierarchyPath(state, scope);
         }
-        currentModel = createModel(state);
+        currentModel = createModel(state, scope);
         if (hierarchySelectionAnchorId && !currentModel.getNode(hierarchySelectionAnchorId)) {
             hierarchySelectionAnchorId = null;
         }
@@ -63,16 +69,21 @@ export function createLocalEditorHierarchyController(options) {
             drop: hierarchyDrop,
             dropPreview: hierarchyDragSession.preview,
             rootDrop: hierarchyRootDrop,
-            searchQuery: hierarchySearch,
+            searchQuery: getScopeSearch(scope.scopeId),
+            title: scope.title,
+            searchPlaceholder: scope.searchPlaceholder,
+            showCreateGroup: commandAdapter.showCreateGroupToolbar,
+            showCreateMarker: commandAdapter.kind === 'scene',
         });
         treeViewportReveal.restoreScrollSnapshot(treeScrollSnapshot);
-        const suppressActiveScroll = state.activeId
-            ? treeViewportReveal.consumeRevealSuppression(state.activeId, { clearWhenDifferent: activeIdChanged })
+        const suppressActiveScroll = scope.activeId
+            ? treeViewportReveal.consumeRevealSuppression(scope.activeId, { clearWhenDifferent: activeIdChanged })
             : false;
-        if (activeIdChanged && state.activeId && !suppressActiveScroll && shouldAutoScrollActiveHierarchyNode()) {
-            scheduleActiveHierarchyScroll(state.activeId);
+        if (activeIdChanged && scope.activeId && !suppressActiveScroll && shouldAutoScrollActiveHierarchyNode()) {
+            scheduleActiveHierarchyScroll(scope.activeId);
         }
-        lastRenderedActiveId = state.activeId;
+        lastRenderedActiveId = scope.activeId;
+        lastRenderedScopeId = scope.scopeId;
     };
     const onClick = (event) => {
         const target = event.target instanceof HTMLElement ? event.target : null;
@@ -100,7 +111,9 @@ export function createLocalEditorHierarchyController(options) {
         const createGroupButton = target?.closest('[data-editor-hierarchy-create-group]');
         if (createGroupButton) {
             const state = getState();
-            const parentId = state?.activeId ?? null;
+            if (!state || resolveScope(state).commandSurface !== 'scene-graph')
+                return;
+            const parentId = state.activeId ?? null;
             if (parentId)
                 expandNode(parentId);
             callbacks.onSceneGraphCreateGroup?.({
@@ -131,7 +144,7 @@ export function createLocalEditorHierarchyController(options) {
         if (shouldClearSelectionFromBlankClick(event, target)) {
             event.preventDefault();
             hierarchySelectionAnchorId = null;
-            submitSelectionCommand({ type: 'selection.clear', label: 'Clear Selection' });
+            submitSelectionCommand({ type: 'selection.clear', label: 'Clear Selection' }, getState() ?? undefined);
         }
     };
     const onContextMenu = (event) => {
@@ -154,13 +167,15 @@ export function createLocalEditorHierarchyController(options) {
         event.preventDefault();
         event.stopPropagation();
         hierarchySelectionAnchorId = id;
-        callbacks.onSelectHierarchyItem?.({ id, additive: false, toggle: false });
-        callbacks.onFocusSelection?.();
+        selectSingleHierarchyItem(id);
+        if (resolveScopeForCurrentState()?.kind === 'scene')
+            callbacks.onFocusSelection?.();
     };
     const onInput = (event) => {
         const input = event.target instanceof HTMLInputElement ? event.target : null;
         if (input?.dataset.editorHierarchySearch != null) {
-            hierarchySearch = input.value;
+            const scopeId = resolveScopeForCurrentState()?.scopeId ?? 'scene';
+            hierarchySearchByScope.set(scopeId, input.value);
             if (!hierarchySearchComposing && !isComposingInputEvent(event))
                 requestRender();
             return;
@@ -177,10 +192,11 @@ export function createLocalEditorHierarchyController(options) {
         if (input?.dataset.editorHierarchySearch != null) {
             if (event.isComposing || hierarchySearchComposing)
                 return;
-            if (event.key !== 'Escape' || hierarchySearch.length === 0)
+            const scopeId = resolveScopeForCurrentState()?.scopeId ?? 'scene';
+            if (event.key !== 'Escape' || getScopeSearch(scopeId).length === 0)
                 return;
             event.preventDefault();
-            hierarchySearch = '';
+            hierarchySearchByScope.set(scopeId, '');
             requestRender();
             return;
         }
@@ -208,7 +224,8 @@ export function createLocalEditorHierarchyController(options) {
         if (input?.dataset.editorHierarchySearch == null)
             return;
         hierarchySearchComposing = false;
-        hierarchySearch = input.value;
+        const scopeId = resolveScopeForCurrentState()?.scopeId ?? 'scene';
+        hierarchySearchByScope.set(scopeId, input.value);
         requestRender();
     };
     const onFocusOut = (event) => {
@@ -224,6 +241,10 @@ export function createLocalEditorHierarchyController(options) {
         const id = button?.dataset.editorHierarchyId;
         if (!id || !state)
             return;
+        if (!resolveHierarchyCommandAdapter(resolveScope(state)).menuCapabilities.hasMoveHandler) {
+            event.preventDefault();
+            return;
+        }
         const model = getModel(state);
         const node = model.getNode(id);
         if (!isLocalEditorHierarchyNodeMovable(node)) {
@@ -244,6 +265,10 @@ export function createLocalEditorHierarchyController(options) {
             clearHierarchyDragFeedbackAndRender();
             return;
         }
+        if (!resolveHierarchyCommandAdapter(resolveScope(state)).menuCapabilities.hasMoveHandler) {
+            clearHierarchyDragFeedbackAndRender();
+            return;
+        }
         const model = getModel(state);
         if (!isInsideHierarchyTreeViewport(target)) {
             clearHierarchyDragFeedbackAndRender();
@@ -309,6 +334,11 @@ export function createLocalEditorHierarchyController(options) {
             clearHierarchyDragFeedbackAndRender();
             return;
         }
+        const scope = resolveScope(state);
+        if (!resolveHierarchyCommandAdapter(scope).menuCapabilities.hasMoveHandler) {
+            clearHierarchyDragFeedbackAndRender();
+            return;
+        }
         const model = getModel(state);
         if (!isInsideHierarchyTreeViewport(target)) {
             clearHierarchyDragFeedbackAndRender();
@@ -323,6 +353,10 @@ export function createLocalEditorHierarchyController(options) {
         hierarchyDrag = null;
         clearHierarchyDragFeedback();
         if (operation.slot.placement === 'root') {
+            if (scope.commandSurface === 'prefab-composition') {
+                requestRender();
+                return;
+            }
             submitResolvedRootDrop(operation.resolution);
             return;
         }
@@ -332,6 +366,15 @@ export function createLocalEditorHierarchyController(options) {
             return;
         }
         expandDropParent(operation.resolution);
+        if (scope.commandSurface === 'prefab-composition') {
+            if (operation.slot.placement !== 'inside') {
+                requestRender();
+                return;
+            }
+            submitPrefabNodeReparent(scope, operation.resolution.draggedIds[0] ?? draggedIds[0], targetId);
+            requestRender();
+            return;
+        }
         submitResolvedDrop(operation.resolution, targetId, operation.slot.placement, draggedIds);
     };
     panel.addEventListener('click', onClick);
@@ -381,11 +424,14 @@ export function createLocalEditorHierarchyController(options) {
         const state = getState();
         if (!state)
             return false;
+        const scope = resolveScope(state);
+        if (scope.kind !== 'scene')
+            return false;
+        const commandAdapter = resolveHierarchyCommandAdapter(scope);
         const action = createLocalEditorHierarchyDeleteShortcutAction({
             state,
             model: getModel(state),
-            hasDuplicateHandler: hasDuplicateHandler(),
-            hasGroupSelectionHandler: typeof callbacks.onSceneGraphGroupSelection === 'function',
+            ...commandAdapter.menuCapabilities,
         });
         if (!action)
             return false;
@@ -404,13 +450,16 @@ export function createLocalEditorHierarchyController(options) {
         const state = getState();
         if (!state)
             return false;
+        const scope = resolveScope(state);
+        if (scope.kind !== 'scene')
+            return false;
+        const commandAdapter = resolveHierarchyCommandAdapter(scope);
         const input = {
             state,
             model: getModel(state),
             clipboardIds: hierarchyClipboard?.ids ?? null,
             clipboardActiveId: hierarchyClipboard?.activeId ?? null,
-            hasDuplicateHandler: hasDuplicateHandler(),
-            hasGroupSelectionHandler: typeof callbacks.onSceneGraphGroupSelection === 'function',
+            ...commandAdapter.menuCapabilities,
         };
         const action = key === 'd'
             ? createLocalEditorHierarchyDuplicateShortcutAction(input)
@@ -430,13 +479,34 @@ export function createLocalEditorHierarchyController(options) {
     function isComposingInputEvent(event) {
         return event.isComposing === true;
     }
-    function createModel(state) {
-        return createLocalEditorHierarchyTreeModel(state.hierarchy, state.selectedIds, state.activeId, {
-            collapsedIds,
+    function resolveScope(state) {
+        return createLocalEditorActiveHierarchyScope(state);
+    }
+    function resolveScopeForCurrentState() {
+        const state = getState();
+        return state ? resolveScope(state) : null;
+    }
+    function getScopeCollapsedIds(scopeId) {
+        const existing = collapsedIdsByScope.get(scopeId);
+        if (existing)
+            return existing;
+        const created = new Set();
+        collapsedIdsByScope.set(scopeId, created);
+        return created;
+    }
+    function getScopeSearch(scopeId) {
+        return hierarchySearchByScope.get(scopeId) ?? '';
+    }
+    function createModel(state, scope = resolveScope(state)) {
+        return createLocalEditorHierarchyTreeModel(scope.nodes, scope.selectedIds, scope.activeId, {
+            collapsedIds: getScopeCollapsedIds(scope.scopeId),
             defaultExpanded: true,
         });
     }
     function selectHierarchyItemFromClick(id, event) {
+        const scope = resolveScopeForCurrentState();
+        if (!scope)
+            return;
         const toggle = event.metaKey || event.ctrlKey;
         const range = event.shiftKey && !toggle;
         if (range) {
@@ -444,11 +514,10 @@ export function createLocalEditorHierarchyController(options) {
             return;
         }
         hierarchySelectionAnchorId = id;
-        callbacks.onSelectHierarchyItem?.({
-            id,
-            additive: false,
-            toggle,
-        });
+        if (scope.kind === 'prefab-stage')
+            callbacks.onSelectPrefabStageItem?.(id);
+        else
+            callbacks.onSelectHierarchyItem?.({ id, additive: false, toggle });
     }
     function toggleHierarchyItemEnabled(id, toggle) {
         if (toggle.dataset.editorHierarchyEnabledToggleDisabled === 'true')
@@ -456,10 +525,10 @@ export function createLocalEditorHierarchyController(options) {
         const state = getState();
         if (!state)
             return;
-        const node = getModel(state).getNode(id);
-        if (!node || typeof node.item.enabled !== 'boolean')
+        if (resolveScope(state).commandSurface !== 'scene-graph')
             return;
-        if (node.item.canToggleEnabled === false || node.item.locked === true || node.protected)
+        const node = getModel(state).getNode(id);
+        if (!node || !canLocalEditorHierarchyNodeToggleEnabled(node))
             return;
         const directEnabled = typeof node.item.directEnabled === 'boolean'
             ? node.item.directEnabled
@@ -472,16 +541,22 @@ export function createLocalEditorHierarchyController(options) {
     function selectHierarchyVisibleRange(targetId) {
         const state = getState();
         if (!state) {
-            callbacks.onSelectHierarchyItem?.({ id: targetId, additive: false, toggle: false });
+            selectSingleHierarchyItem(targetId);
             hierarchySelectionAnchorId = targetId;
             return;
         }
+        const scope = resolveScope(state);
+        if (scope.kind !== 'scene') {
+            hierarchySelectionAnchorId = targetId;
+            callbacks.onSelectPrefabStageItem?.(targetId);
+            return;
+        }
         const model = getModel(state);
-        const anchorId = hierarchySelectionAnchorId ?? state.activeId ?? targetId;
+        const anchorId = hierarchySelectionAnchorId ?? scope.activeId ?? targetId;
         const selectedIds = model.getVisibleRangeSelection(anchorId, targetId);
         if (selectedIds.length === 0) {
             hierarchySelectionAnchorId = targetId;
-            callbacks.onSelectHierarchyItem?.({ id: targetId, additive: false, toggle: false });
+            selectSingleHierarchyItem(targetId);
             return;
         }
         const activeId = selectedIds.includes(targetId)
@@ -492,10 +567,11 @@ export function createLocalEditorHierarchyController(options) {
             label: 'Select Hierarchy Range',
             selectedIds,
             activeId,
-        });
+        }, state);
     }
     function resolveDraggedIds(state, model, draggedId) {
-        const selectedIds = state.selectedIds.includes(draggedId) ? state.selectedIds : [draggedId];
+        const scope = resolveScope(state);
+        const selectedIds = scope.selectedIds.includes(draggedId) ? scope.selectedIds : [draggedId];
         return model.getTopLevelSelection(selectedIds);
     }
     function readDraggedIds(event) {
@@ -515,6 +591,8 @@ export function createLocalEditorHierarchyController(options) {
         requestRender();
     }
     function toggleExpanded(id) {
+        const scope = resolveScopeForCurrentState();
+        const collapsedIds = getScopeCollapsedIds(scope?.scopeId ?? 'scene');
         if (collapsedIds.has(id))
             collapsedIds.delete(id);
         else
@@ -524,15 +602,17 @@ export function createLocalEditorHierarchyController(options) {
     function expandNode(id) {
         if (!id)
             return;
-        collapsedIds.delete(id);
+        const scope = resolveScopeForCurrentState();
+        getScopeCollapsedIds(scope?.scopeId ?? 'scene').delete(id);
     }
-    function expandActiveHierarchyPath(state) {
-        if (!state.activeId)
+    function expandActiveHierarchyPath(state, scope = resolveScope(state)) {
+        if (!scope.activeId)
             return;
-        const model = createModel(state);
-        if (!model.getNode(state.activeId))
+        const model = createModel(state, scope);
+        if (!model.getNode(scope.activeId))
             return;
-        for (const ancestor of model.getAncestors(state.activeId)) {
+        const collapsedIds = getScopeCollapsedIds(scope.scopeId);
+        for (const ancestor of model.getAncestors(scope.activeId)) {
             collapsedIds.delete(ancestor.id);
         }
     }
@@ -710,10 +790,19 @@ export function createLocalEditorHierarchyController(options) {
             return;
         const trimmed = value.trim();
         const state = getState();
-        const item = state?.hierarchy.find(candidate => candidate.id === id) ?? null;
+        const scope = state ? resolveScope(state) : null;
+        const item = scope?.nodes.find(candidate => candidate.id === id) ?? null;
         hierarchyRename = null;
-        if (trimmed && item && trimmed !== item.label)
-            callbacks.onSceneGraphRename?.({ id, name: trimmed });
+        if (trimmed && item && trimmed !== item.label) {
+            if (scope?.commandSurface === 'scene-graph') {
+                callbacks.onSceneGraphRename?.({ id, name: trimmed });
+            }
+            else if (scope?.commandSurface === 'prefab-composition') {
+                callbacks.onAssetAction?.(createPrefabNodeAssetAction(scope, 'prefab.node.rename', resolvePrefabCommandTargetId(scope, id), {
+                    value: trimmed,
+                }));
+            }
+        }
         requestRender();
     }
     function openHierarchyContextMenu(event) {
@@ -732,42 +821,55 @@ export function createLocalEditorHierarchyController(options) {
                 requestRender();
             return;
         }
-        event.preventDefault();
-        event.stopPropagation();
-        options.onBeforeOpenContextMenu?.();
+        const scope = resolveScope(state);
+        const commandAdapter = resolveHierarchyCommandAdapter(scope);
         const model = getModel(state);
         const hierarchyButton = target.closest('[data-editor-hierarchy-id]');
         const node = model.getNode(hierarchyButton?.dataset.editorHierarchyId);
-        if (node && !state.selectedIds.includes(node.id) && isLocalEditorHierarchyNodeSelectable(node)) {
+        if (node && !scope.selectedIds.includes(node.id) && isLocalEditorHierarchyNodeSelectable(node)) {
             hierarchySelectionAnchorId = node.id;
-            callbacks.onSelectHierarchyItem?.({ id: node.id, additive: false, toggle: false });
+            if (scope.kind === 'prefab-stage')
+                callbacks.onSelectPrefabStageItem?.(node.id);
+            else
+                callbacks.onSelectHierarchyItem?.({ id: node.id, additive: false, toggle: false });
+        }
+        if (!commandAdapter.canOpenContextMenu) {
+            if (hadHierarchyFeedback)
+                requestRender();
+            return;
         }
+        event.preventDefault();
+        event.stopPropagation();
+        options.onBeforeOpenContextMenu?.();
+        const menuState = createScopedHierarchyMenuState(state, scope);
         const menu = node
             ? createLocalEditorHierarchyNodeMenu({
-                state,
+                state: menuState,
                 model,
                 node,
                 clipboardIds: hierarchyClipboard?.ids ?? null,
                 clipboardActiveId: hierarchyClipboard?.activeId ?? null,
-                hasDuplicateHandler: hasDuplicateHandler(),
-                hasMoveHandler: typeof callbacks.onSceneGraphMove === 'function',
-                hasGroupSelectionHandler: typeof callbacks.onSceneGraphGroupSelection === 'function',
+                ...commandAdapter.menuCapabilities,
                 contextActions: options.contextActions,
             })
             : createLocalEditorHierarchyBlankMenu({
-                state,
+                state: menuState,
                 model,
                 clipboardIds: hierarchyClipboard?.ids ?? null,
                 clipboardActiveId: hierarchyClipboard?.activeId ?? null,
-                hasDuplicateHandler: hasDuplicateHandler(),
-                hasMoveHandler: typeof callbacks.onSceneGraphMove === 'function',
-                hasGroupSelectionHandler: typeof callbacks.onSceneGraphGroupSelection === 'function',
+                ...commandAdapter.menuCapabilities,
                 contextActions: options.contextActions,
             });
+        const menuItems = commandAdapter.filterMenuItems(menu.items);
+        if (menuItems.length === 0) {
+            if (hadHierarchyFeedback)
+                requestRender();
+            return;
+        }
         contextMenu.open({
             x: event.clientX,
             y: event.clientY,
-            items: menu.items,
+            items: menuItems,
             onAction(item) {
                 const action = menu.actions.get(item.id);
                 if (action)
@@ -821,13 +923,25 @@ export function createLocalEditorHierarchyController(options) {
         }
         submitHierarchyContextAction(action.action);
     }
-    function submitSelectionCommand(command) {
+    function createScopedHierarchyMenuState(state, scope) {
+        return {
+            ...state,
+            hierarchy: scope.nodes,
+            selectedIds: scope.selectedIds,
+            activeId: scope.activeId,
+        };
+    }
+    function submitSelectionCommand(command, state = getState() ?? undefined) {
+        if (state && resolveScope(state).kind !== 'scene')
+            return;
         callbacks.onSelectionCommand?.(command);
     }
     function openAttachPicker(targetIds, activeId) {
         const state = getState();
         if (!state || state.mode !== 'editor' || state.busy || targetIds.length === 0)
             return;
+        if (!resolveHierarchyCommandAdapter(resolveScope(state)).menuCapabilities.hasMoveHandler)
+            return;
         attachDialog.open({
             model: getModel(state),
             targetIds,
@@ -838,6 +952,11 @@ export function createLocalEditorHierarchyController(options) {
         const state = getState();
         if (!state || 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 !== 'scene-graph')
+            return { ok: false, reason: 'Hierarchy move pipeline is not connected yet.' };
         const ids = selection.resolution.draggedIds;
         if (ids.length === 0)
             return { ok: false, reason: 'Select one or more movable nodes first.' };
@@ -867,6 +986,31 @@ export function createLocalEditorHierarchyController(options) {
         requestRender();
         return result;
     }
+    function submitPrefabAttachSelection(scope, selection) {
+        const ids = selection.resolution.draggedIds;
+        if (ids.length !== 1)
+            return { ok: false, reason: 'Move one prefab node at a time.' };
+        if (selection.placement !== 'inside')
+            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)) {
+            return { ok: false, reason: 'Select valid prefab nodes first.' };
+        }
+        expandNode(selection.targetId);
+        requestRender();
+        return { ok: true };
+    }
+    function submitPrefabNodeReparent(scope, hierarchyId, parentHierarchyId) {
+        const nodeId = resolvePrefabCommandTargetId(scope, hierarchyId);
+        const parentNodeId = resolvePrefabCommandTargetId(scope, parentHierarchyId);
+        if (!nodeId || !parentNodeId)
+            return false;
+        callbacks.onAssetAction?.(createPrefabNodeAssetAction(scope, 'prefab.node.reparent', nodeId, {
+            parentNodeId,
+        }));
+        return true;
+    }
     function normalizeAttachSceneGraphMoveResult(result) {
         if (typeof result === 'boolean')
             return { ok: result };
@@ -884,16 +1028,19 @@ export function createLocalEditorHierarchyController(options) {
         if (hierarchyRename || hierarchyDrag || hasHierarchyDragFeedback())
             return false;
         const state = getState();
-        return (state?.selectedIds.length ?? 0) > 0;
+        if (!state)
+            return false;
+        const scope = resolveScope(state);
+        return scope.kind === 'scene' && scope.selectedIds.length > 0;
     }
     function clearSelectionFromSearchClick(event) {
         if (event.button !== 0 || event.shiftKey || event.metaKey || event.ctrlKey || event.altKey)
             return;
         const state = getState();
-        if ((state?.selectedIds.length ?? 0) === 0)
+        if (!state || resolveScope(state).kind !== 'scene' || state.selectedIds.length === 0)
             return;
         hierarchySelectionAnchorId = null;
-        submitSelectionCommand({ type: 'selection.clear', label: 'Clear Selection' });
+        submitSelectionCommand({ type: 'selection.clear', label: 'Clear Selection' }, state);
     }
     function isHierarchyShortcutScope(event) {
         const target = event.target instanceof Node ? event.target : null;
@@ -909,6 +1056,13 @@ export function createLocalEditorHierarchyController(options) {
     function submitHierarchyContextAction(action) {
         if (action.action === 'rename')
             return;
+        const scope = resolveScopeForCurrentState();
+        if (scope?.commandSurface === 'prefab-composition') {
+            submitPrefabHierarchyContextAction(scope, action);
+            return;
+        }
+        if (scope?.commandSurface !== 'scene-graph')
+            return;
         if (action.action === 'create-group' || action.action === 'create-primitive' || action.action === 'create-marker') {
             expandNode(action.parentId);
         }
@@ -960,8 +1114,64 @@ export function createLocalEditorHierarchyController(options) {
             });
         }
     }
-    function hasDuplicateHandler() {
-        return typeof callbacks.onSceneGraphDuplicate === 'function';
+    function submitPrefabHierarchyContextAction(scope, action) {
+        if (action.action === 'focus') {
+            const targetId = action.activeId ?? action.targetIds[0] ?? null;
+            if (targetId)
+                callbacks.onSelectPrefabStageItem?.(targetId);
+            return;
+        }
+        if (action.action === 'create-primitive') {
+            if (action.parentId)
+                expandNode(action.parentId);
+            callbacks.onAssetAction?.(createPrefabNodeAssetAction(scope, 'prefab.node.createPrimitive', resolvePrefabCommandTargetId(scope, action.parentId ?? scope.activeId), {
+                primitiveShape: action.shape,
+            }));
+            return;
+        }
+        if (action.action === 'create-group') {
+            if (action.parentId)
+                expandNode(action.parentId);
+            callbacks.onAssetAction?.(createPrefabNodeAssetAction(scope, 'prefab.node.createGroup', resolvePrefabCommandTargetId(scope, action.parentId ?? scope.activeId), {
+                value: { name: 'Empty' },
+            }));
+            return;
+        }
+        if (action.action === 'delete') {
+            const nodeId = action.activeId && action.targetIds.includes(action.activeId)
+                ? action.activeId
+                : action.targetIds[0] ?? null;
+            if (!nodeId)
+                return;
+            callbacks.onAssetAction?.(createPrefabNodeAssetAction(scope, 'prefab.node.delete', resolvePrefabCommandTargetId(scope, nodeId)));
+        }
+    }
+    function resolvePrefabCommandTargetId(scope, hierarchyId) {
+        if (!hierarchyId)
+            return null;
+        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)
+            : undefined;
+        return {
+            actionId,
+            assetId: stageAssetId,
+            browserAssetId: stageAssetId ? `prefab:${stageAssetId}` : undefined,
+            assetKind: 'prefab',
+            targetPrefabAssetId: stageAssetId,
+            ...(nodeId ? { nodeId, parentNodeId: nodeId } : {}),
+            ...extra,
+        };
+    }
+    function resolveHierarchyCommandAdapter(scope) {
+        return resolveLocalEditorHierarchyCommandAdapter(scope, {
+            hasDuplicateHandler: typeof callbacks.onSceneGraphDuplicate === 'function',
+            hasMoveHandler: typeof callbacks.onSceneGraphMove === 'function',
+            hasGroupSelectionHandler: typeof callbacks.onSceneGraphGroupSelection === 'function',
+        });
     }
     function resolveActiveTheme() {
         const themed = panel.closest('.fps-editor-workbench[data-fps-editor-theme]');
@@ -972,11 +1182,18 @@ export function createLocalEditorHierarchyController(options) {
         const state = getState();
         const model = state ? getModel(state) : null;
         const node = model?.getNode(id) ?? null;
-        if (!node || node.protected || node.item.locked || node.item.renamable === false)
+        if (!node || !canLocalEditorHierarchyNodeRename(node))
             return;
         hierarchyRename = { id, value: node.label };
         requestRender();
     }
+    function selectSingleHierarchyItem(id) {
+        const scope = resolveScopeForCurrentState();
+        if (scope?.kind === 'prefab-stage')
+            callbacks.onSelectPrefabStageItem?.(id);
+        else
+            callbacks.onSelectHierarchyItem?.({ id, additive: false, toggle: false });
+    }
     function submitResolvedDrop(resolved, targetId, placement, draggedIds) {
         if (callbacks.onSceneGraphMove) {
             callbacks.onSceneGraphMove({