LayerInterface

enum class LayerReadyState : int {
    READY = 0,           // Layer is ready to render
    NOT_READY = 1,       // Layer is not yet ready
    ERROR = 2,           // Layer encountered an error
    TIMEOUT_ERROR = 3,   // Layer timed out while loading
};

// Create a custom layer implementation
class MyLayer : public LayerInterface {
public:
    void onAdded(const std::shared_ptr<MapInterface>& map, int32_t index) override {
        // Initialize layer resources
        mapInterface_ = map;
        layerIndex_ = index;
    }
    
    void onRemoved() override {
        // Clean up resources
        mapInterface_.reset();
    }
    
    void update() override {
        // Update layer state before rendering
    }
    
    std::vector<std::shared_ptr<RenderPassInterface>> buildRenderPasses() override {
        // Build and return render passes
        std::vector<std::shared_ptr<RenderPassInterface>> passes;
        // ... create passes
        return passes;
    }
    
    void setAlpha(float alpha) override {
        alpha_ = std::clamp(alpha, 0.0f, 1.0f);
    }
    
    // ... implement other methods
};

// Using a layer
auto layer = std::make_shared<MyLayer>();
layer->setAlpha(0.8f);
layer->enableAnimations(true);

map->addLayer(layer);

// Control visibility
layer->hide();
layer->show();

// Check ready state
if (layer->isReadyToRenderOffscreen() == LayerReadyState::READY) {
    // Layer is ready
}

// Remove layer
map->removeLayer(layer);