include/rive/shapes/shape_paint_container.hpp

#ifndef _RIVE_SHAPE_PAINT_CONTAINER_HPP_
#define _RIVE_SHAPE_PAINT_CONTAINER_HPP_
#include "rive/refcnt.hpp"
#include "rive/shapes/path_flags.hpp"
#include "rive/shapes/shape_paint_path.hpp"
#include "rive/math/mat2d.hpp"
#include <vector>

namespace rive
{
class Artboard;
class ShapePaint;
class Component;

class CommandPath;

class ShapePaintContainer
{
    friend class ShapePaint;

protected:
    // Need this to access our artboard. We are treated as a mixin, either
    // as a Shape or Artboard, so both of those will override this.
    virtual Artboard* getArtboard() = 0;

    PathFlags m_pathFlags = PathFlags::none;
    std::vector<ShapePaint*> m_ShapePaints;
    void addPaint(ShapePaint* paint);

public:
    static ShapePaintContainer* from(Component* component);

#ifdef WITH_RIVE_EDITOR
    // Editor-only removal companion to `addPaint` — fired from
    // `ShapePaint::editorParentChanged` when the paint is reparented
    // away (or about to be freed) so the container's typed list
    // doesn't dangle. Runtime build assumes immutable hierarchy and
    // never reaches this. Body in `component_parent_editor.cpp`.
    void removePaintForEditor(ShapePaint* paint);

    // Editor-only re-sort of `m_ShapePaints` by sibling
    // `FractionalIndex`. Runtime build never reorders ShapePaints
    // after hydration; editor builds need this hook so the
    // inspector's drag-reorder actually changes the rendered draw
    // order (the runtime renders by walking `m_ShapePaints` in
    // vector order). Mirrors `Path::sortVerticesForEditor`.
    void sortShapePaintsForEditor();

    // Editor-only read-only view of `m_ShapePaints` for diagnostics
    // (dispatcher debug, inspector introspection). The runtime
    // build uses `TESTING`-gated `shapePaints()` for the same.
    const std::vector<ShapePaint*>& shapePaintsForEditor() const
    {
        return m_ShapePaints;
    }
#endif

    /// The component that's responsible for path building, helpful for adding
    /// dependencies after the paths are built.
    virtual Component* pathBuilder() = 0;

    virtual ~ShapePaintContainer() {}

    PathFlags pathFlags() const;

    void invalidateStrokeEffects();

    void propagateOpacity(float opacity);

    virtual const Mat2D& shapeWorldTransform() const = 0;

    const std::vector<ShapePaint*>& shapePaints() const
    {
        return m_ShapePaints;
    }

    virtual ShapePaintPath* worldPath() { return nullptr; }
    virtual ShapePaintPath* localPath() { return nullptr; }
    virtual ShapePaintPath* localClockwisePath() { return nullptr; }
};
} // namespace rive

#endif