关键节点

editor/include/XCEditor/Panels/UIEditorHostedPanelDispatch.h

@@ -0,0 +1,40 @@
+#pragma once
+
+#include <XCEditor/Panels/UIEditorPanelContentHost.h>
+#include <XCEditor/Panels/UIEditorPanelHostLifecycle.h>
+
+#include <string>
+#include <string_view>
+#include <vector>
+
+namespace XCEngine::UI::Editor {
+
+struct UIEditorHostedPanelDispatchEntry {
+    std::string panelId = {};
+    UIEditorPanelPresentationKind presentationKind =
+        UIEditorPanelPresentationKind::Placeholder;
+    bool mounted = false;
+    ::XCEngine::UI::UIRect bounds = {};
+    bool allowInteraction = false;
+    bool attached = false;
+    bool visible = false;
+    bool active = false;
+    bool focused = false;
+    bool focusGained = false;
+    bool focusLost = false;
+};
+
+struct UIEditorHostedPanelDispatchFrame {
+    std::vector<UIEditorHostedPanelDispatchEntry> entries = {};
+};
+
+const UIEditorHostedPanelDispatchEntry* FindUIEditorHostedPanelDispatchEntry(
+    const UIEditorHostedPanelDispatchFrame& frame,
+    std::string_view panelId);
+
+UIEditorHostedPanelDispatchFrame BuildUIEditorHostedPanelDispatchFrame(
+    const UIEditorPanelContentHostFrame& contentHostFrame,
+    const UIEditorPanelHostLifecycleFrame& lifecycleFrame,
+    bool allowInteraction);
+
+} // namespace XCEngine::UI::Editor

editor/include/XCEditor/Panels/UIEditorPanelContentHost.h

@@ -0,0 +1,85 @@
+#pragma once
+
+#include <XCEditor/Panels/UIEditorPanelRegistry.h>
+#include <XCEditor/Docking/UIEditorDockHost.h>
+
+#include <cstdint>
+#include <string>
+#include <string_view>
+#include <vector>
+
+namespace XCEngine::UI::Editor {
+
+enum class UIEditorPanelContentHostEventKind : std::uint8_t {
+    Mounted = 0,
+    Unmounted,
+    BoundsChanged
+};
+
+std::string_view GetUIEditorPanelContentHostEventKindName(
+    UIEditorPanelContentHostEventKind kind);
+
+bool IsUIEditorPanelPresentationExternallyHosted(UIEditorPanelPresentationKind kind);
+
+struct UIEditorPanelContentHostMountRequest {
+    std::string panelId = {};
+    UIEditorPanelPresentationKind kind = UIEditorPanelPresentationKind::Placeholder;
+    ::XCEngine::UI::UIRect bounds = {};
+};
+
+struct UIEditorPanelContentHostRequest {
+    std::vector<UIEditorPanelContentHostMountRequest> mountRequests = {};
+};
+
+struct UIEditorPanelContentHostPanelState {
+    std::string panelId = {};
+    UIEditorPanelPresentationKind kind = UIEditorPanelPresentationKind::Placeholder;
+    bool mounted = false;
+    ::XCEngine::UI::UIRect bounds = {};
+};
+
+struct UIEditorPanelContentHostState {
+    std::vector<UIEditorPanelContentHostPanelState> panelStates = {};
+};
+
+struct UIEditorPanelContentHostEvent {
+    UIEditorPanelContentHostEventKind kind = UIEditorPanelContentHostEventKind::Mounted;
+    std::string panelId = {};
+    UIEditorPanelPresentationKind presentationKind = UIEditorPanelPresentationKind::Placeholder;
+    ::XCEngine::UI::UIRect bounds = {};
+};
+
+struct UIEditorPanelContentHostFrame {
+    std::vector<UIEditorPanelContentHostPanelState> panelStates = {};
+    std::vector<UIEditorPanelContentHostEvent> events = {};
+};
+
+const UIEditorPanelContentHostMountRequest* FindUIEditorPanelContentHostMountRequest(
+    const UIEditorPanelContentHostRequest& request,
+    std::string_view panelId);
+
+const UIEditorPanelContentHostPanelState* FindUIEditorPanelContentHostPanelState(
+    const UIEditorPanelContentHostState& state,
+    std::string_view panelId);
+
+const UIEditorPanelContentHostPanelState* FindUIEditorPanelContentHostPanelState(
+    const UIEditorPanelContentHostFrame& frame,
+    std::string_view panelId);
+
+UIEditorPanelContentHostRequest ResolveUIEditorPanelContentHostRequest(
+    const Widgets::UIEditorDockHostLayout& dockHostLayout,
+    const UIEditorPanelRegistry& panelRegistry);
+
+UIEditorPanelContentHostFrame BuildUIEditorPanelContentHostFrame(
+    const UIEditorPanelContentHostRequest& request,
+    const UIEditorPanelRegistry& panelRegistry);
+
+UIEditorPanelContentHostFrame UpdateUIEditorPanelContentHost(
+    UIEditorPanelContentHostState& state,
+    const UIEditorPanelContentHostRequest& request,
+    const UIEditorPanelRegistry& panelRegistry);
+
+std::vector<std::string> CollectMountedUIEditorPanelContentHostPanelIds(
+    const UIEditorPanelContentHostFrame& frame);
+
+} // namespace XCEngine::UI::Editor

editor/include/XCEditor/Panels/UIEditorPanelFrame.h

@@ -0,0 +1,160 @@
+#pragma once
+
+#include <XCEngine/UI/DrawData.h>
+
+#include <cstdint>
+#include <string_view>
+
+namespace XCEngine::UI::Editor::Widgets {
+
+enum class UIEditorPanelFrameAction : std::uint8_t {
+    None = 0,
+    Pin,
+    Close
+};
+
+enum class UIEditorPanelFrameHitTarget : std::uint8_t {
+    None = 0,
+    Header,
+    Body,
+    Footer,
+    PinButton,
+    CloseButton
+};
+
+struct UIEditorPanelFrameState {
+    bool active = false;
+    bool hovered = false;
+    bool focused = false;
+    bool pinned = false;
+    bool closable = true;
+    bool pinnable = true;
+    bool showFooter = false;
+    bool pinHovered = false;
+    bool closeHovered = false;
+};
+
+struct UIEditorPanelFrameText {
+    std::string_view title = {};
+    std::string_view subtitle = {};
+    std::string_view footer = {};
+};
+
+struct UIEditorPanelFrameMetrics {
+    float cornerRounding = 0.0f;
+    float headerHeight = 28.0f;
+    float footerHeight = 18.0f;
+    float contentPadding = 8.0f;
+    float titleInsetX = 9.0f;
+    float titleInsetY = 6.0f;
+    float subtitleInsetY = 16.0f;
+    float footerInsetX = 9.0f;
+    float footerInsetY = 3.0f;
+    float actionButtonExtent = 14.0f;
+    float actionInsetX = 8.0f;
+    float actionGap = 4.0f;
+    float baseBorderThickness = 1.0f;
+    float hoveredBorderThickness = 1.0f;
+    float activeBorderThickness = 1.0f;
+    float focusedBorderThickness = 1.0f;
+};
+
+struct UIEditorPanelFramePalette {
+    ::XCEngine::UI::UIColor surfaceColor =
+        ::XCEngine::UI::UIColor(0.10f, 0.10f, 0.10f, 1.0f);
+    ::XCEngine::UI::UIColor headerColor =
+        ::XCEngine::UI::UIColor(0.11f, 0.11f, 0.11f, 1.0f);
+    ::XCEngine::UI::UIColor footerColor =
+        ::XCEngine::UI::UIColor(0.10f, 0.10f, 0.10f, 1.0f);
+    ::XCEngine::UI::UIColor borderColor =
+        ::XCEngine::UI::UIColor(0.15f, 0.15f, 0.15f, 1.0f);
+    ::XCEngine::UI::UIColor hoveredBorderColor =
+        ::XCEngine::UI::UIColor(0.17f, 0.17f, 0.17f, 1.0f);
+    ::XCEngine::UI::UIColor activeBorderColor =
+        ::XCEngine::UI::UIColor(0.19f, 0.19f, 0.19f, 1.0f);
+    ::XCEngine::UI::UIColor focusedBorderColor =
+        ::XCEngine::UI::UIColor(0.19f, 0.19f, 0.19f, 1.0f);
+    ::XCEngine::UI::UIColor textPrimary =
+        ::XCEngine::UI::UIColor(0.92f, 0.92f, 0.92f, 1.0f);
+    ::XCEngine::UI::UIColor textSecondary =
+        ::XCEngine::UI::UIColor(0.72f, 0.72f, 0.72f, 1.0f);
+    ::XCEngine::UI::UIColor textMuted =
+        ::XCEngine::UI::UIColor(0.62f, 0.62f, 0.62f, 1.0f);
+    ::XCEngine::UI::UIColor actionButtonColor =
+        ::XCEngine::UI::UIColor(0.11f, 0.11f, 0.11f, 1.0f);
+    ::XCEngine::UI::UIColor actionButtonHoveredColor =
+        ::XCEngine::UI::UIColor(0.14f, 0.14f, 0.14f, 1.0f);
+    ::XCEngine::UI::UIColor actionButtonSelectedColor =
+        ::XCEngine::UI::UIColor(0.17f, 0.17f, 0.17f, 1.0f);
+    ::XCEngine::UI::UIColor actionButtonBorderColor =
+        ::XCEngine::UI::UIColor(0.15f, 0.15f, 0.15f, 1.0f);
+    ::XCEngine::UI::UIColor actionGlyphColor =
+        ::XCEngine::UI::UIColor(0.86f, 0.86f, 0.86f, 1.0f);
+};
+
+struct UIEditorPanelFrameLayout {
+    ::XCEngine::UI::UIRect frameRect = {};
+    ::XCEngine::UI::UIRect headerRect = {};
+    ::XCEngine::UI::UIRect bodyRect = {};
+    ::XCEngine::UI::UIRect footerRect = {};
+    ::XCEngine::UI::UIRect pinButtonRect = {};
+    ::XCEngine::UI::UIRect closeButtonRect = {};
+    bool hasFooter = false;
+    bool showPinButton = false;
+    bool showCloseButton = false;
+};
+
+bool IsUIEditorPanelFramePointInside(
+    const ::XCEngine::UI::UIRect& rect,
+    const ::XCEngine::UI::UIPoint& point);
+
+bool IsUIEditorPanelFramePinButtonVisible(const UIEditorPanelFrameState& state);
+bool IsUIEditorPanelFrameCloseButtonVisible(const UIEditorPanelFrameState& state);
+
+UIEditorPanelFrameLayout BuildUIEditorPanelFrameLayout(
+    const ::XCEngine::UI::UIRect& frameRect,
+    const UIEditorPanelFrameState& state,
+    const UIEditorPanelFrameMetrics& metrics = {});
+
+::XCEngine::UI::UIColor ResolveUIEditorPanelFrameBorderColor(
+    const UIEditorPanelFrameState& state,
+    const UIEditorPanelFramePalette& palette = {});
+
+float ResolveUIEditorPanelFrameBorderThickness(
+    const UIEditorPanelFrameState& state,
+    const UIEditorPanelFrameMetrics& metrics = {});
+
+UIEditorPanelFrameAction HitTestUIEditorPanelFrameAction(
+    const UIEditorPanelFrameLayout& layout,
+    const UIEditorPanelFrameState& state,
+    const ::XCEngine::UI::UIPoint& point);
+
+UIEditorPanelFrameHitTarget HitTestUIEditorPanelFrame(
+    const UIEditorPanelFrameLayout& layout,
+    const UIEditorPanelFrameState& state,
+    const ::XCEngine::UI::UIPoint& point);
+
+void AppendUIEditorPanelFrameBackground(
+    ::XCEngine::UI::UIDrawList& drawList,
+    const UIEditorPanelFrameLayout& layout,
+    const UIEditorPanelFrameState& state,
+    const UIEditorPanelFramePalette& palette = {},
+    const UIEditorPanelFrameMetrics& metrics = {});
+
+void AppendUIEditorPanelFrameForeground(
+    ::XCEngine::UI::UIDrawList& drawList,
+    const UIEditorPanelFrameLayout& layout,
+    const UIEditorPanelFrameState& state,
+    const UIEditorPanelFrameText& text,
+    const UIEditorPanelFramePalette& palette = {},
+    const UIEditorPanelFrameMetrics& metrics = {});
+
+void AppendUIEditorPanelFrame(
+    ::XCEngine::UI::UIDrawList& drawList,
+    const ::XCEngine::UI::UIRect& frameRect,
+    const UIEditorPanelFrameState& state,
+    const UIEditorPanelFrameText& text,
+    const UIEditorPanelFramePalette& palette = {},
+    const UIEditorPanelFrameMetrics& metrics = {});
+
+} // namespace XCEngine::UI::Editor::Widgets

editor/include/XCEditor/Panels/UIEditorPanelHostLifecycle.h

@@ -0,0 +1,68 @@
+#pragma once
+
+#include <XCEditor/Panels/UIEditorPanelRegistry.h>
+#include <XCEditor/Workspace/UIEditorWorkspaceSession.h>
+
+#include <cstdint>
+#include <string>
+#include <string_view>
+#include <vector>
+
+namespace XCEngine::UI::Editor {
+
+enum class UIEditorPanelHostLifecycleEventKind : std::uint8_t {
+    Attached = 0,
+    Detached,
+    Shown,
+    Hidden,
+    Activated,
+    Deactivated,
+    FocusGained,
+    FocusLost
+};
+
+std::string_view GetUIEditorPanelHostLifecycleEventKindName(
+    UIEditorPanelHostLifecycleEventKind kind);
+
+struct UIEditorPanelHostState {
+    std::string panelId = {};
+    bool attached = false;
+    bool visible = false;
+    bool active = false;
+    bool focused = false;
+};
+
+struct UIEditorPanelHostLifecycleEvent {
+    UIEditorPanelHostLifecycleEventKind kind = UIEditorPanelHostLifecycleEventKind::Attached;
+    std::string panelId = {};
+};
+
+struct UIEditorPanelHostLifecycleState {
+    std::vector<UIEditorPanelHostState> panelStates = {};
+};
+
+struct UIEditorPanelHostLifecycleRequest {
+    std::string focusedPanelId = {};
+};
+
+struct UIEditorPanelHostLifecycleFrame {
+    std::vector<UIEditorPanelHostState> panelStates = {};
+    std::vector<UIEditorPanelHostLifecycleEvent> events = {};
+};
+
+const UIEditorPanelHostState* FindUIEditorPanelHostState(
+    const UIEditorPanelHostLifecycleState& state,
+    std::string_view panelId);
+
+const UIEditorPanelHostState* FindUIEditorPanelHostState(
+    const UIEditorPanelHostLifecycleFrame& frame,
+    std::string_view panelId);
+
+UIEditorPanelHostLifecycleFrame UpdateUIEditorPanelHostLifecycle(
+    UIEditorPanelHostLifecycleState& state,
+    const UIEditorPanelRegistry& panelRegistry,
+    const UIEditorWorkspaceModel& workspace,
+    const UIEditorWorkspaceSession& session,
+    const UIEditorPanelHostLifecycleRequest& request = {});
+
+} // namespace XCEngine::UI::Editor

editor/include/XCEditor/Panels/UIEditorPanelRegistry.h

@@ -0,0 +1,57 @@
+#pragma once
+
+#include <XCEditor/Viewport/UIEditorViewportShell.h>
+#include <XCEngine/UI/Types.h>
+
+#include <cstdint>
+#include <string>
+#include <string_view>
+#include <vector>
+
+namespace XCEngine::UI::Editor {
+
+enum class UIEditorPanelPresentationKind : std::uint8_t {
+    Placeholder = 0,
+    ViewportShell,
+    HostedContent
+};
+
+struct UIEditorPanelDescriptor {
+    std::string panelId = {};
+    std::string defaultTitle = {};
+    UIEditorPanelPresentationKind presentationKind = UIEditorPanelPresentationKind::Placeholder;
+    bool placeholder = true;
+    bool canHide = true;
+    bool canClose = true;
+    ::XCEngine::UI::UISize minimumDetachedWindowSize = {};
+    UIEditorViewportShellSpec viewportShellSpec = {};
+};
+
+struct UIEditorPanelRegistry {
+    std::vector<UIEditorPanelDescriptor> panels = {};
+};
+
+enum class UIEditorPanelRegistryValidationCode : std::uint8_t {
+    None = 0,
+    EmptyPanelId,
+    EmptyDefaultTitle,
+    DuplicatePanelId
+};
+
+struct UIEditorPanelRegistryValidationResult {
+    UIEditorPanelRegistryValidationCode code = UIEditorPanelRegistryValidationCode::None;
+    std::string message = {};
+
+    [[nodiscard]] bool IsValid() const {
+        return code == UIEditorPanelRegistryValidationCode::None;
+    }
+};
+
+const UIEditorPanelDescriptor* FindUIEditorPanelDescriptor(
+    const UIEditorPanelRegistry& registry,
+    std::string_view panelId);
+
+UIEditorPanelRegistryValidationResult ValidateUIEditorPanelRegistry(
+    const UIEditorPanelRegistry& registry);
+
+} // namespace XCEngine::UI::Editor