plugin_meta = {
    "schema_version": 1,
    "name": "mypkg.vision.explanation",
    "version": "0.1.0",
    "provider": "author/org",
    "capabilities": ["explanation:factual"],
    "trusted": False,
    # ADR-033 required for non-tabular:
    "data_modalities": ("image",),     # normalised canonical name(s)
    "plugin_api_version": "1.0",       # "MAJOR.MINOR" — must match CE contract
}

# src/calibrated_explanations/vision.py
"""Thin shim for image/vision modality extensions (ADR-033)."""
from __future__ import annotations

try:
    from ce_vision import _register_vision_plugin  # first-party extension package
except ImportError:
    def __getattr__(name: str):  # noqa: ANN001
        from calibrated_explanations.utils.exceptions import MissingExtensionError
        raise MissingExtensionError(
            f"calibrated_explanations.vision.{name} requires the 'ce-vision' package. "
            "Install it with: pip install ce-vision"
        )

calibrated-explanations/        ← core package (this repo)
ce-vision/                      ← separate package, independent versioning
  pyproject.toml                   version = "0.1.0"
  src/ce_vision/
    plugins.py                     VisionExplanationPlugin
    preprocessing.py               image → tabular feature extraction
    tests/
      test_packaging_smoke.py      entry-point discovery + import smoke test

# ce-vision/pyproject.toml
[project.entry-points."calibrated_explanations.plugins"]
ce_vision = "ce_vision.plugins:VisionExplanationPlugin"

# tests/unit/plugins/test_modality_contract.py
import pytest
from calibrated_explanations.plugins.base import validate_plugin_meta


DUMMY_VISION_META = {
    "schema_version": 1,
    "name": "test.vision.dummy",
    "version": "0.1.0",
    "provider": "test-author",
    "capabilities": ["explanation:factual"],
    "trusted": False,
    "data_modalities": ("image",),
    "plugin_api_version": "1.0",
}

def test_should_pass_meta_validation_when_vision_plugin_meta_is_valid():
    validate_plugin_meta(DUMMY_VISION_META)  # no exception


def test_should_raise_on_major_version_mismatch_when_plugin_api_version_incompatible():
    from calibrated_explanations.plugins.registry import _check_plugin_api_compat
    import pytest
    with pytest.raises(Exception, match="major"):
        _check_plugin_api_compat(required="1.0", provided="2.0")