"""Shared capability gate for MiniMax H3 masked-target operations."""

from __future__ import annotations


def require_h3_mask_support(operation: str = "masked target generation"):
    """Prefer native H3 AV masks and install only missing compatibility.

    The node pack already targets the native Add Guide / MultiRef generation
    of MiniMax H3.  Keeping that baseline here prevents a legacy guide wrapper
    and the newer per-row mask engine from being combined accidentally.
    """
    from .patch_layout import native_guides_available

    if not native_guides_available():
        raise RuntimeError(
            "h3_masking: %s requires the native MiniMax H3 Add Guide / "
            "MultiRef core from ComfyUI PR #15439. Update ComfyUI before "
            "using this path." % operation
        )

    from .h3_mask_compat import ensure_h3_mask_compat, is_ready
    from .h3_mask_payload_compat import ensure_av_mask_payload_compat

    ensure_h3_mask_compat()
    ensure_av_mask_payload_compat()

    if not is_ready():
        raise RuntimeError(
            "h3_masking: H3 per-stream AV mask support could not be enabled. "
            "Check the ComfyUI console capability report."
        )
    return True