Summary

This PR improves the PropertyLayer visualization API by allowing users to pass a PropertyLayerStyle instance directly to draw_propertylayer. This removes the need to wrap the style in a function for simple, uniform styling cases.

issue #2923

Background / Problem

Previously, even the simplest styling required a callable, like:

def propertylayer_portrayal(layer):
return PropertyLayerStyle(colormap="viridis", colorbar=True)

For cases where the style is the same across all layers, this wrapper didn't add any value and made the API feel unnecessarily verbose.
This PR addresses feedback suggesting the API should accept both:

• a direct PropertyLayerStyle instance (for uniform styling)

• a callable (for conditional or per-layer styling)

This makes the API more intuitive and aligns with common Python patterns.

Implementation

Changes in mesa/visualization/space_renderer.py:

• Updated draw_propertylayer to detect when propertylayer_portrayal is a PropertyLayerStyle instance.

• When an instance is provided, it's automatically wrapped in a small lambda so the existing backend logic continues to work without modification.

• Updated type hints to reflect that the argument may now be either a callable or a style instance.

Testing

• Added a dedicated test case: test_property_layer_style_instance in tests/test_space_renderer.py to confirm that passing a PropertyLayerStyle instance works correctly.

• Ran the existing test suite (pytest tests/test_space_renderer.py) to ensure no regressions — all 16 tests passed.

Additional Notes

This change reduces boilerplate for the common simple-use scenario while still supporting the more flexible function-based approach for complex styling. It should make the API easier and more pleasant to use without breaking any existing behavior.