unravel-editor-panel

name	unravel-editor-panel
description	Develops UnravelEngine editor UI: ImGui panels, menu bars, dockspace, gizmos, inspectors, undo/redo, and viewport overlays. Use for editor panels, hub integration, selection, editing actions, or ImGui layout bugs.
disable-model-invocation	true

Unravel Editor Panel

Start here

Purpose	Path
Editor entry	editor/editor/editor.h
Hub orchestrator	editor/editor/hub/hub.cpp
Panel definitions	editor/editor/hub/panels/panels_defs.h
Scene viewport	editor/editor/hub/panels/scene_panel/
Game view	editor/editor/hub/panels/game_panel/
Inspector	editor/editor/hub/panels/inspector_panel/
Hierarchy	editor/editor/hub/panels/hierarchy_panel/
Content browser	editor/editor/hub/panels/content_browser_panel/
Profiler	editor/editor/hub/panels/profiler_panel/
Header / play controls	editor/editor/hub/panels/header_panel/
ImGui integration	editor/editor/imgui/integration/
Editing core	editor/editor/editing/editing_manager.h
Undo/redo	editor/editor/editing/undo_redo_stack.h

Panel lifecycle

1. Panels registered in hub / imgui_panels
2. View names from panels_defs.h (e.g. SCENE_VIEW, INSPECTOR_VIEW)
3. Frame callbacks: on_frame_ui_render in editor mirrors engine events
4. Docking via ImGui dockspace; layouts in layout_panel/, layout_manager

Selection and editing

• editing_manager — active selection, snap settings, grid, gizmo state
• Selection is entt::handle based
• Undo via editing_action_t derivatives in editor/editor/editing/actions/
• Property changes should go through undo actions when user-visible

Inspector system

• inspector_registry auto-discovers inspector subclasses
• Component icons in inspector_entity.cpp → get_component_icon<T>()
• Property drawing uses EnTT meta reflection
• Prefab overrides: prefab_property_override with pretty + serialization paths

Use unravel-add-inspector for custom type inspectors.

Gizmos

editor/editor/hub/panels/scene_panel/gizmos/:

• Transform, physics shape, character controller gizmos
• ImGuizmo integration in scene panel
• Gizmo shaders in editor_data/data/shaders/

ImGui conventions

• Custom widgets: deps/3rdparty/imgui/imgui_widgets/, editor/editor/imgui/
• Icons: Material Design Icons via icons_material_design_icons.h
• ImGui::AlignedItem() for horizontal alignment — include FramePadding in item width for buttons/menu items
• ImGui::SetItemTooltipEx() for tooltips (project wrapper)
• Menu bar items: account for FramePadding and ItemSpacing when right-aligning

Menu bars

Scene and game panels have draw_menubar():

• scene_panel.cpp → draw_menubar
• game_panel.cpp → draw_menubar
• Stats toggle: viewport_stats_overlay::draw_stats_toggle

Menu bar uses horizontal MenuItem layout — width exceeds CalcTextSize label.

Play mode UI

• Header panel play controls: header_panel.cpp
• Game panel visibility toggled from scene panel
• Editor chrome remains during play; game view shows runtime output
• Use unravel-play-mode-change when behavior differs edit vs play

Verification checklist

• Panel docks and persists in saved layout
• Selection syncs across scene/hierarchy/inspector
• Undo/redo works for the change
• Play mode enter/exit preserves panel state
• No ImGui ID collisions (use ## prefixes for hidden IDs)
• Tooltips and icons match surrounding panels
• Right-aligned menu items not clipped at viewport edge

Common mistakes

• Raw ImGui IDs causing state bleed between panels
• Editing without undo action (user cannot revert)
• Engine code in editor target only — keep editor logic in editor/
• Forgetting ImGui::SameLine() spacing when aligning items
• Using label text width only for AlignedItem on interactive widgets

Deep reference

See reference.md for panel map and editing patterns.