<?php
namespace Zadex\Frontend;

defined('ABSPATH') || exit;

/**
 * Media value helpers for widget render.php files.
 *
 * A media setting is `{id, url, alt, width?, height?, sizes?: {name: {url, width, height}}}`. The editor's
 * media picker stores the WordPress image sizes of the attachment (T216) so the canvas can preview the
 * "Image size" select. On the frontend a library image (id > 0) is still rendered through
 * wp_get_attachment_image() (srcset, current size files); this class supplies the fallback used when that
 * returns nothing (attachment deleted, external URL): the stored size URL first, then the original URL.
 */
final class Media
{
    /**
     * Fallback image URL for `$size`: `sizes[$size].url`, else `url`, else ''.
     *
     * @param array<string, mixed> $image
     */
    public static function fallback_url(array $image, string $size): string
    {
        $sizes = isset($image['sizes']) && is_array($image['sizes']) ? $image['sizes'] : [];
        $entry = isset($sizes[$size]) && is_array($sizes[$size]) ? $sizes[$size] : [];
        if (isset($entry['url']) && is_string($entry['url']) && $entry['url'] !== '') {
            return $entry['url'];
        }
        return isset($image['url']) && is_string($image['url']) ? $image['url'] : '';
    }
}