<?php
/**
 * EPPRO_Elementor_Helper
 *
 * Small helpers shared by the AJAX handlers, renderers and widgets:
 *   - Look up a widget saved in an Elementor document, so AJAX handlers use
 *     the settings stored on the server instead of values sent by the browser.
 *   - Render an Elementor template safely (permission check + recursion guard).
 *
 * @package AdMoreWidgetsSuite
 * @since   1.0.4
 */

if ( ! defined( 'ABSPATH' ) ) exit;

final class EPPRO_Elementor_Helper {

    /** @var int[] Template IDs currently being rendered (recursion guard). */
    private static array $rendering = [];

    // =========================================================================
    // Documents & widgets
    // =========================================================================

    /**
     * ID of the Elementor document being rendered right now — the page, popup
     * or template that contains the current widget. Falls back to the loop post.
     */
    public static function current_document_id(): int {
        if ( class_exists( '\Elementor\Plugin' ) && isset( \Elementor\Plugin::$instance->documents ) ) {
            $document = \Elementor\Plugin::$instance->documents->get_current();
            if ( $document ) {
                return (int) $document->get_main_id();
            }
        }
        return (int) get_the_ID();
    }

    /**
     * Instance of the widget $widget_id (of type $widget_type) saved in the
     * Elementor document $post_id, with its saved settings applied.
     *
     * Returns null when the document is not published (unless the current
     * user may edit it), the widget does not exist or has another type.
     */
    public static function get_widget( int $post_id, string $widget_id, string $widget_type ): ?\Elementor\Widget_Base {
        if ( ! $post_id || '' === $widget_id || ! class_exists( '\Elementor\Plugin' ) ) return null;

        $status = get_post_status( $post_id );
        if ( ! $status ) return null;
        if ( 'publish' !== $status && ! current_user_can( 'edit_post', $post_id ) ) return null;
        if ( post_password_required( $post_id ) && ! current_user_can( 'edit_post', $post_id ) ) return null;

        $elementor = \Elementor\Plugin::$instance;
        if ( ! isset( $elementor->documents, $elementor->elements_manager ) ) return null;

        $document = $elementor->documents->get( $post_id );
        if ( ! $document ) return null;

        $element = self::find_element( (array) $document->get_elements_data(), $widget_id );

        // Elementor Pro "Global Widget": the real widget lives in a library template.
        if ( $element && 'global' === ( $element['widgetType'] ?? '' ) && ! empty( $element['templateID'] ) ) {
            $template = $elementor->documents->get( absint( $element['templateID'] ) );
            $data     = $template ? (array) $template->get_elements_data() : [];
            $element  = isset( $data[0] ) && is_array( $data[0] ) ? $data[0] : null;
        }

        if ( ! $element || 'widget' !== ( $element['elType'] ?? '' ) || $widget_type !== ( $element['widgetType'] ?? '' ) ) {
            return null;
        }

        try {
            $widget = $elementor->elements_manager->create_element_instance( $element );
        } catch ( \Throwable $e ) {
            eppro_log( 'EPP widget lookup error: ' . $e->getMessage() );
            return null;
        }

        return $widget instanceof \Elementor\Widget_Base ? $widget : null;
    }

    /** Depth-first search for an element by ID in Elementor element data. */
    private static function find_element( array $elements, string $id ): ?array {
        foreach ( $elements as $element ) {
            if ( ! is_array( $element ) ) continue;
            if ( isset( $element['id'] ) && (string) $element['id'] === $id ) {
                return $element;
            }
            if ( ! empty( $element['elements'] ) && is_array( $element['elements'] ) ) {
                $found = self::find_element( $element['elements'], $id );
                if ( $found ) return $found;
            }
        }
        return null;
    }

    // =========================================================================
    // Template rendering
    // =========================================================================

    /**
     * Whether the current visitor may see the content of post $id when it is
     * embedded somewhere (template picker, shortcode, popup…): it must be
     * published and not password-protected, unless the user can edit it.
     */
    public static function can_render( int $id ): bool {
        $post = get_post( $id );
        if ( ! $post ) return false;
        if ( current_user_can( 'edit_post', $id ) ) return true;
        return 'publish' === $post->post_status && ! post_password_required( $post );
    }

    /**
     * HTML of an Elementor template/page, or '' when it may not be shown.
     *
     * The markup is produced by Elementor, which escapes every widget's
     * output; running it through wp_kses_post() would strip SVG icons, form
     * inputs, iframes and inline <style> (leaving the CSS as visible text).
     *
     * @param int  $id       Post ID of the template.
     * @param bool $with_css Print the template CSS inline — use when the CSS
     *                       was not enqueued in <head> beforehand.
     */
    public static function get_template_content( int $id, bool $with_css = true ): string {
        if ( ! $id || ! class_exists( '\Elementor\Plugin' ) ) return '';
        if ( ! self::can_render( $id ) ) return '';
        if ( in_array( $id, self::$rendering, true ) ) return ''; // A template that (indirectly) contains itself.

        $frontend = \Elementor\Plugin::$instance->frontend ?? null;
        if ( ! $frontend ) return '';

        self::$rendering[] = $id;
        try {
            $content = (string) $frontend->get_builder_content_for_display( $id, $with_css );
        } finally {
            array_pop( self::$rendering );
        }

        return $content;
    }

    /** Echo get_template_content(). */
    public static function print_template_content( int $id, bool $with_css = true ): void {
        echo self::get_template_content( $id, $with_css ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Elementor builder output; every widget escapes its own markup.
    }

    // =========================================================================
    // Editor panel
    // =========================================================================

    /**
     * Section label with the plugin badge, used for every control section the
     * plugin adds to the Elementor panel so they all look the same.
     * The badge is styled by EPPRO_Asset_Manager::enqueue_editor_badge().
     */
    public static function panel_label( string $label ): string {
        return esc_html( $label ) . ' <span class="eppro-panel-badge">EPP</span>';
    }
}