<?php

namespace App\Core\Contracts\Ai;

/**
 * توليد صور عبر مزود خارجي (OpenAI DALL·E وما شابه).
 */
interface AiImageGenerationPort
{
    /**
     * @param  string  $prompt  الوصف المحسّن (enhanced_prompt)
     * @return array{image_url: string, provider: string, external_id: string|null, model: string}
     */
    public function generate(
        string $prompt,
        ?string $aspectRatio = null,
        ?string $quality = null,
        ?string $model = null,
    ): array;
}
