inspector.hpp

Go to the documentation of this file.

#pragma once
 
#include <pulp/view/view.hpp>
#include <pulp/view/tree_view.hpp>
#include <pulp/view/property_list.hpp>
#include <string>
#include <vector>
 
namespace pulp::view {
 
// Introspects a View tree and produces a JSON representation
// Used by the component inspector and for debugging
class ViewInspector {
public:
    // Serialize the entire view tree to formatted JSON
    static std::string to_json(const View& root);
 
    // Find a view by ID in the tree
    static View* find_by_id(View& root, const std::string& id);
 
    // Find a view by its design-import anchor id. Returns nullptr for an
    // empty anchor or when no view in the tree carries it. Used by the
    // inspector's source-jump resolver to map an anchor back to a live View*.
    static View* find_by_anchor(View& root, const std::string& anchor);
 
    // Count total views in the tree
    static size_t count_views(const View& root);
 
    // Get the type name of a view (e.g., "Knob", "Fader", "View")
    static std::string type_name(const View& view);
 
    // ── Inspector window helpers ────────────────────────────────────────

    static void populate_tree(TreeNode& parent, const View& root);

    static std::vector<PropertyList::Property> view_properties(const View& view);

    static Rect absolute_bounds(const View& view);
};
 
} // namespace pulp::view