Cohensive\OEmbed\HtmlBuilder

Complexity

Total Complexity

44

Size/Duplication

Total Lines	257
Duplicated Lines	0 %

Importance

Changes	3
Bugs	0	Features	0

17 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	5	1
A	type()	0	3	1
A	toArray()	0	5	1
A	script()	0	3	1
A	video()	0	27	6
A	getTypeOptions()	0	7	2
A	iframe()	0	11	3
A	src()	0	17	4
A	ampHtml()	0	3	1
A	html()	0	16	4
A	applyAutoplay()	0	17	3
A	applyManualDimensions()	0	11	3
A	applyAspectRatioDimensions()	0	8	4
A	hasNumericDimensions()	0	5	3
A	applyDimensions()	0	12	4
A	addUrlParam()	0	4	2
A	applyOptions()	0	11	1

<?php
namespace Cohensive\OEmbed;

class HtmlBuilder
{
    const TYPE_RAW = 'raw';
    const TYPE_IFRAME = 'iframe';
    const TYPE_VIDEO = 'video';

    public function __construct(
        protected string $type,
        protected string | array $html,
        protected ?string $script = null
    ) {
    }

    /**
     * Returns current type.
     */
    public function type(): string
    {
        return $this->type;
    }

    /**
     * Returns HTML code for media provider.
     */
    public function html(array $options = [], array $globalOptions = [], bool $amp = false): string
    {
        if (is_array($this->html)) {
            $attrs = $this->applyOptions($this->html, $options, $globalOptions);

            if ($this->type === self::TYPE_IFRAME) {
                return $this->iframe($attrs, $amp);
            }

            if ($this->type === self::TYPE_VIDEO) {
                return $this->video($attrs, $amp);
            }

            return '';
        } else {
            return $this->html;
        }
    }

    /**
     * Return AMP-friendly HTML for media provider.
     */
    public function ampHtml(array $options = [], array $globalOptions = []): string
    {
        return $this->html($options, $globalOptions, true);
    }

    /**
     * Returns URL for a given media provider embed. Returned url type depends on embed type:
     * iframe - string
     * video - string[]
     * raw - null
     */
    public function src(array $options = [], array $globalOptions = []): mixed
    {
        if (is_array($this->html)) {
            $attrs = $this->applyOptions($this->html, $options, $globalOptions);

            if ($this->type === self::TYPE_IFRAME) {
                return $attrs['src'] ?? null;
            }

            if ($this->type === self::TYPE_VIDEO) {
                return array_map(function ($source) {
                    return $source['src'];
                }, $attrs['source']);
            }
        }

        return null;
    }

    /**
     * Constructs <iframe> HTML-element based on array of provider attributes.
     */
    protected function iframe(array $attrs, bool $amp = false): string
    {
        $tag = $amp ? 'amp-iframe' : 'iframe';

        $html = "<$tag";
        foreach ($attrs as $attr => $val) {
            $html .= sprintf(' %s="%s"', $attr, $val);
        }
        $html .= "></$tag>";

        return $html;
    }

    /**
     * Constructs <video> HTML-element based on an array of provider attributes.
     */
    protected function video(array $attrs, bool $amp = false): string
    {
        $tag = $amp ? 'amp-video' : 'video';

        $inner = '';

        $html = "<$tag";
        foreach ($attrs as $attr => $val) {
            if (is_array($val)) {
                foreach ($val as $child) {
                    $inner .= "<$attr";
                    foreach ($child as $iattr => $ival) {
                        $inner .= sprintf(' %s="%s"', $iattr, $ival);
                    }
                    $inner .= ">";
                }
            } else {
                $html .= sprintf(' %s="%s"', $attr, $val);
            }
        }
        $html .= ">";

        $html .= $inner;

        $html .= "</$tag>";

        return $html;
    }

    /**
     * Returns script source if available.
     */
    public function script(): ?string
    {
        return $this->script;
    }

    /**
     * Converts class to an array.
     */
    public function toArray(): array
    {
        return [
            'type' => $this->type,
            'html' => $this->html,
        ];
    }

    /**
     * Extracts and returns an array of options for a current HTML element type.
     */
    protected function getTypeOptions(array $options): array
    {
        if (isset($options['html'])) {
            return $options['html'][$this->type] ?? [];
        }

        return [];
    }

    /**
     * Merge and apply local and global options to the provider attributes.
     */
    protected function applyOptions(array $attrs, array $options, array $globalOptions): array
    {
        $mergedOptions = array_merge($globalOptions['attributes'] ?? [], $options);
        $attrs = $this->applyDimensions($attrs, $mergedOptions);
        $attrs = $this->applyAutoplay($attrs, $mergedOptions);

        $typeOptions = $this->getTypeOptions($globalOptions);

        return array_filter(
            array_merge($typeOptions, $mergedOptions, $attrs),
            fn($value) => $value !== null
        );
    }

    /**
     * Apply width and height dimensions with aspect ratio calculations.
     */
    protected function applyDimensions(array $attrs, array $options): array
    {
        $width = $options['width'] ?? null;
        $height = $options['height'] ?? null;

        if ($this->hasNumericDimensions($attrs)) {
            $attrs = $this->applyAspectRatioDimensions($attrs, $width, $height);
        } elseif ($width || $height) {
            $attrs = $this->applyManualDimensions($attrs, $width, $height);
        }

        return $attrs;
    }

    /**
     * Check if attributes have numeric width and height values.
     */
    protected function hasNumericDimensions(array $attrs): bool
    {
        return isset($attrs['width'], $attrs['height'])
            && is_numeric($attrs['width'])
            && is_numeric($attrs['height']);
    }

    /**
     * Apply dimensions while maintaining aspect ratio.
     */
    protected function applyAspectRatioDimensions(array $attrs, mixed $width, mixed $height): array
    {
        $ratio = $attrs['width'] / $attrs['height'];

        $attrs['width'] = $width ?: round(($height ?: $attrs['height']) * $ratio);
        $attrs['height'] = $height ?: round($attrs['width'] / $ratio);

        return $attrs;
    }

    /**
     * Apply dimensions without aspect ratio calculations.
     */
    protected function applyManualDimensions(array $attrs, mixed $width, mixed $height): array
    {
        if ($width) {
            $attrs['width'] = $width;
        }

        if ($height) {
            $attrs['height'] = $height;
        }

        return $attrs;
    }

    /**
     * Handle autoplay functionality, especially for iframe embeds.
     */
    protected function applyAutoplay(array $attrs, array &$options): array
    {
        if (! ($options['autoplay'] ?? false)) {
            return $attrs;
        }

        if ($this->type === self::TYPE_IFRAME) {
            $attrs['src'] = $this->addUrlParam(
                $attrs['src'],
                sprintf('autoplay=%s', $options['autoplay'])
            );
            unset($options['autoplay']);
        } else {
            $attrs['autoplay'] = $options['autoplay'];
        }

        return $attrs;
    }

    /**
     * Append custom parameter to the end of the url.
     */
    protected function addUrlParam(string $url, string $param): string
    {
        $operator = strpos($url, '?') >= 0 ? '&' : '?';
        return $url . $operator . $param;
    }
}