@spec aspect_ratio(integer(), integer()) :: {:ok, String.t()} | {:error, atom()}

Returns the reduced aspect ratio for valid positive integer dimensions.

iex> ImageBriefValidator.aspect_ratio(1920, 1080)
{:ok, "16:9"}

@spec validate(map()) :: {:ok, map()} | {:error, keyword()}

Validates a brief and returns either the original brief or all detected errors.

Examples

iex> ImageBriefValidator.validate(%{prompt: "A studio product photo", width: 1200, height: 800})
{:ok, %{prompt: "A studio product photo", width: 1200, height: 800}}

iex> ImageBriefValidator.validate(%{prompt: "", width: 0, height: 800})
{:error, [prompt: :must_be_present, width: :must_be_a_positive_integer]}

@spec validate_all(map()) :: keyword()

Returns all structural errors as a keyword list.

String and atom keys are both accepted. Optional style values are limited to the documented presets, and references must be a list of non-empty strings.