GroveEngine/modules/UIModule/UIModule.h
StillHammer 579cadeae8 feat: Complete UIModule Phase 7 - ScrollPanel & Tooltips
This commit implements Phase 7 of the UIModule, adding advanced features
that make the UI system production-ready.

## Phase 7.1 - UIScrollPanel

New scrollable container widget with:
- Vertical and horizontal scrolling (configurable)
- Mouse wheel support with smooth scrolling
- Drag-to-scroll functionality (drag content or scrollbar)
- Interactive scrollbar with proportional thumb
- Automatic content size calculation
- Visibility culling for performance
- Full styling support (colors, borders, scrollbar)

Files added:
- modules/UIModule/Widgets/UIScrollPanel.h
- modules/UIModule/Widgets/UIScrollPanel.cpp
- modules/UIModule/Core/UIContext.h (added mouseWheelDelta)
- modules/UIModule/UIModule.cpp (mouse wheel event routing)

## Phase 7.2 - Tooltips

Smart tooltip system with:
- Hover delay (500ms default)
- Automatic positioning with edge avoidance
- Semi-transparent background with border
- Per-widget tooltip text via JSON
- Tooltip property on all UIWidget types
- Renders on top of all UI elements

Files added:
- modules/UIModule/Core/UITooltip.h
- modules/UIModule/Core/UITooltip.cpp
- modules/UIModule/Core/UIWidget.h (added tooltip property)
- modules/UIModule/Core/UITree.cpp (tooltip parsing)

## Tests

Added comprehensive visual tests:
- test_28_ui_scroll.cpp - ScrollPanel with 35+ items
- test_29_ui_advanced.cpp - Tooltips on various widgets
- assets/ui/test_scroll.json - ScrollPanel layout
- assets/ui/test_tooltips.json - Tooltips layout

## Documentation

- docs/UI_MODULE_PHASE7_COMPLETE.md - Complete Phase 7 docs
- docs/PROMPT_UI_MODULE_PHASE6.md - Phase 6 & 7 prompt
- Updated CMakeLists.txt for new files and tests

## UIModule Status

UIModule is now feature-complete with:
 9 widget types (Panel, Label, Button, Image, Slider, Checkbox,
   ProgressBar, TextInput, ScrollPanel)
 Flexible layout system (vertical, horizontal, stack, absolute)
 Theme and style system
 Complete event system
 Tooltips with smart positioning
 Hot-reload support
 Comprehensive tests (Phases 1-7)

🚀 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-29 07:13:13 +08:00

76 lines
2.0 KiB
C++

#pragma once
#include <grove/IModule.h>
#include <grove/IIO.h>
#include <grove/JsonDataNode.h>
#include <memory>
#include <spdlog/logger.h>
namespace grove {
class UIContext;
class UITree;
class UIRenderer;
class UIWidget;
class UITooltipManager;
/**
* @brief UI Module - Declarative UI system with JSON configuration
*
* Provides a retained-mode UI system with:
* - JSON-based layout definition
* - Widget hierarchy (Panel, Label, Button, etc.)
* - Rendering via IIO topics (render:sprite, render:text)
* - Input handling via IIO (input:mouse, input:keyboard)
*/
class UIModule : public IModule {
public:
UIModule();
~UIModule() override;
// IModule interface
void process(const IDataNode& input) override;
void setConfiguration(const IDataNode& configNode, IIO* io, ITaskScheduler* scheduler) override;
const IDataNode& getConfiguration() override;
std::unique_ptr<IDataNode> getHealthStatus() override;
void shutdown() override;
std::unique_ptr<IDataNode> getState() override;
void setState(const IDataNode& state) override;
std::string getType() const override { return "UIModule"; }
bool isIdle() const override { return true; }
private:
IIO* m_io = nullptr;
std::shared_ptr<spdlog::logger> m_logger;
// UI subsystems
std::unique_ptr<UIContext> m_context;
std::unique_ptr<UITree> m_tree;
std::unique_ptr<UIRenderer> m_renderer;
std::unique_ptr<UITooltipManager> m_tooltipManager;
std::unique_ptr<UIWidget> m_root;
// Configuration cache
std::unique_ptr<JsonDataNode> m_configCache;
// Stats
uint64_t m_frameCount = 0;
// Load layout from file path
bool loadLayout(const std::string& layoutPath);
// Load layout from inline JSON data
bool loadLayoutData(const IDataNode& layoutData);
// Process input from IIO
void processInput();
// Update UI state
void updateUI(float deltaTime);
// Render UI
void renderUI();
};
} // namespace grove