"""Direct prompt-only MiniMax H3 T2V shape and latent helpers."""

import torch


FPS = 24
AUDIO_LATENT_FPS = 40


def align_frame_count(frames: int) -> int:
    """Snap to H3's valid 17k+5 temporal grid."""
    frames = max(5, frames)
    return frames + (5 - frames) % 17


def temporal_shape(frames: int) -> tuple[int, int, int]:
    """Return output frames, video-latent frames, and joint audio-latent steps."""
    frames = align_frame_count(frames)
    video_steps = 2 if frames <= 5 else ((frames - 5) // 17) * 5 + 2
    return frames, video_steps, round(frames / FPS * AUDIO_LATENT_FPS)


def empty_av_latents(width: int, height: int, frames: int, *, device: torch.device | str = "cuda") -> tuple[torch.Tensor, torch.Tensor, int]:
    """Allocate H3's joint video/audio sampling state without ComfyUI objects."""
    if width % 32 or height % 32:
        raise ValueError("H3 T2V dimensions must be multiples of 32.")
    frames, video_steps, audio_steps = temporal_shape(frames)
    video = torch.zeros((1, 24, video_steps, height // 16, width // 16), device=device)
    audio = torch.zeros((1, 32, 2, audio_steps), device=device)
    return video, audio, frames