<?php
defined( 'ABSPATH' ) || exit;

/**
 * Schema Manager - 80+ schema types, all free.
 *
 * Types with a real builder (see AWBSEO_Schema_Fields::type_groups()) take
 * their details from the "Schema details" panel and output everything Google
 * needs for rich results. The rest use the generic builder (name, url,
 * description), which is valid schema but not rich-result eligible.
 */
class AWBSEO_Schema_Manager {

    public static function get_schema_types() {
        return [
            // Content
            'Article'             => 'Article',
            'NewsArticle'         => 'News Article',
            'BlogPosting'         => 'Blog Post',
            'TechArticle'         => 'Tech Article',
            'ScholarlyArticle'    => 'Scholarly Article',
            'SatiricalArticle'    => 'Satirical Article',
            'AnalysisNewsArticle' => 'Analysis News Article',
            'OpinionNewsArticle'  => 'Opinion News Article',
            'ReviewNewsArticle'   => 'Review News Article',
            // Business
            'LocalBusiness'       => 'Local Business',
            'Restaurant'          => 'Restaurant',
            'Store'               => 'Store',
            'Hotel'               => 'Hotel',
            'MedicalBusiness'     => 'Medical Business',
            'LegalService'        => 'Legal Service',
            'FinancialService'    => 'Financial Service',
            'AutoDealer'          => 'Auto Dealer',
            'RealEstateAgent'     => 'Real Estate Agent',
            'ProfessionalService' => 'Professional Service',
            'CafeOrCoffeeShop'    => 'Café or Coffee Shop',
            'Bakery'              => 'Bakery',
            'MedicalClinic'       => 'Medical Clinic',
            'Dentist'             => 'Dentist',
            'Pharmacy'            => 'Pharmacy',
            'BeautySalon'         => 'Beauty Salon',
            'TravelAgency'        => 'Travel Agency',
            'Service'             => 'Service',
            // Creative
            'Book'                => 'Book',
            'Movie'               => 'Movie',
            'MusicAlbum'          => 'Music Album',
            'MusicRecording'      => 'Music Recording',
            'VideoObject'         => 'Video',
            'Podcast'             => 'Podcast',
            'PodcastEpisode'      => 'Podcast Episode',
            'Course'              => 'Course',
            'SoftwareApplication' => 'Software Application',
            'MobileApplication'   => 'Mobile App',
            'WebApplication'      => 'Web App',
            // People / Org
            'Person'              => 'Person',
            'Organization'        => 'Organization',
            'NGO'                 => 'NGO',
            'Corporation'         => 'Corporation',
            'EducationalOrganization' => 'Educational Organization',
            'GovernmentOrganization'  => 'Government Organization',
            // Products / Commerce
            'Product'             => 'Product',
            'ProductGroup'        => 'Product Group',
            'Offer'               => 'Offer',
            'AggregateOffer'      => 'Aggregate Offer',
            'ItemList'            => 'Item List',
            // Events
            'Event'               => 'Event',
            'BusinessEvent'       => 'Business Event',
            'MusicEvent'          => 'Music Event',
            'SportsEvent'         => 'Sports Event',
            'FoodEvent'           => 'Food Event',
            'EducationEvent'      => 'Education Event',
            'OnlineEvent'         => 'Online Event',
            // Review & Rating
            'Review'              => 'Review',
            'AggregateRating'     => 'Aggregate Rating',
            // QA & How-To
            'FAQPage'             => 'FAQ Page',
            'HowTo'               => 'How-To',
            'QAPage'              => 'Q&A Page',
            // Recipe & Food
            'Recipe'              => 'Recipe',
            'NutritionInformation' => 'Nutrition Information',
            // Place
            'Place'               => 'Place',
            'LandmarksOrHistoricalBuildings' => 'Landmark',
            // Job
            'JobPosting'          => 'Job Posting',
            // Medical
            'MedicalCondition'    => 'Medical Condition',
            'Drug'                => 'Drug',
            'MedicalProcedure'    => 'Medical Procedure',
            // Breadcrumb / Site
            'BreadcrumbList'      => 'Breadcrumb',
            'WebPage'             => 'Web Page',
            'WebSite'             => 'Website',
            'SearchAction'        => 'Sitelinks Searchbox',
            // Misc
            'Dataset'             => 'Dataset',
            'Table'               => 'Table',
            'DefinedTerm'         => 'Defined Term',
            'Speakable'           => 'Speakable',
        ];
    }

    /**
     * Build the JSON-LD array for a given post.
     */
    public static function build( $post_id ) {
        // Custom / pasted schema markup - if Schema Data already looks like a
        // complete schema.org object (has its own @type), use it verbatim
        // instead of running it through a per-type builder. This is what lets
        // someone paste a full <script type="application/ld+json"> block
        // (e.g. from a generator or testing tool) and have it used as-is.
        $custom = self::get_custom_schema( $post_id );
        if ( $custom ) {
            return $custom;
        }

        $type = AWBSEO_Meta_Manager::get( $post_id, 'schema_type' );
        if ( ! $type ) {
            $type = self::infer_type( $post_id );
        }

        // Types with structured fields (Event, Course, Review, LocalBusiness
        // family, etc.) - one builder per group, see AWBSEO_Schema_Fields.
        $groups       = class_exists( 'AWBSEO_Schema_Fields' ) ? AWBSEO_Schema_Fields::type_groups() : [];
        $group_method = isset( $groups[ $type ] ) ? 'build_group_' . $groups[ $type ] : '';
        $method       = 'build_' . strtolower( $type );

        if ( $group_method && method_exists( __CLASS__, $group_method ) ) {
            $schema = call_user_func( [ __CLASS__, $group_method ], $post_id, $type );
        } elseif ( method_exists( __CLASS__, $method ) ) {
            $schema = call_user_func( [ __CLASS__, $method ], $post_id );
        } else {
            $schema = self::build_generic( $post_id, $type );
        }

        $schema = self::add_language_hygiene( $schema, $post_id, $type );
        // Drop empty values at every level so half-filled objects (an Offer
        // with no price, an address with no street) never reach the page as
        // invalid markup.
        $schema = self::prune( $schema );
        return apply_filters( 'awbseo_schema_output', $schema, $post_id );
    }

    /**
     * Language of a page for schema purposes ('ar' for Arabic content,
     * otherwise the site language). Shared with Local SEO so location
     * names and addresses follow the page language.
     */
    public static function page_language( $post_id ) {
        return $post_id ? self::detect_in_language( $post_id ) : ( get_bloginfo( 'language' ) ?: 'en' );
    }

    public static function page_is_arabic( $post_id ) {
        return 0 === strpos( (string) self::page_language( $post_id ), 'ar' );
    }

    /**
     * Fills in two fields every generated (non-custom-pasted) schema should
     * carry, without overriding anything a builder already set explicitly:
     *
     *   - inLanguage: the actual language of THIS page. Multilingual sites
     *     (WPML/Polylang) already filter get_bloginfo('language') correctly
     *     per translation, but a great many CitedSEO sites run no
     *     multilingual plugin at all and just publish individual posts in
     *     Arabic on an otherwise English-locale install - for those,
     *     get_bloginfo('language') would wrongly say "en-US" on an Arabic
     *     post, so the post's own content is checked directly.
     *   - @id: a stable, unique identifier for this specific schema node.
     *     Because it's built from get_permalink() it's automatically
     *     distinct per language version whenever different languages live
     *     at different URLs (the normal case), rather than every
     *     translation of a page accidentally sharing one @id - a mistake
     *     that blurs entity identity for Google and for AI answer engines.
     */
    private static function add_language_hygiene( array $schema, $post_id, $type ) {
        // inLanguage only exists on creative works and events - not on
        // organizations, people, places, products, services, or jobs.
        $groups   = class_exists( 'AWBSEO_Schema_Fields' ) ? AWBSEO_Schema_Fields::type_groups() : [];
        $no_lang  = [ 'organization', 'person', 'localbusiness', 'product', 'service', 'job' ];
        if ( isset( $groups[ $type ] ) && in_array( $groups[ $type ], $no_lang, true ) ) {
            if ( empty( $schema['@id'] ) && ( $permalink = get_permalink( $post_id ) ) ) {
                $schema['@id'] = trailingslashit( $permalink ) . '#' . strtolower( $type );
            }
            return $schema;
        }
        if ( empty( $schema['inLanguage'] ) ) {
            $schema['inLanguage'] = self::detect_in_language( $post_id );
        }
        if ( empty( $schema['@id'] ) ) {
            $permalink = get_permalink( $post_id );
            if ( $permalink ) {
                $schema['@id'] = trailingslashit( $permalink ) . '#' . strtolower( $type );
            }
        }
        return $schema;
    }

    private static function detect_in_language( $post_id ) {
        $site_lang = get_bloginfo( 'language' );

        $post = get_post( $post_id );
        if ( $post ) {
            $sample = wp_strip_all_tags( $post->post_title . ' ' . $post->post_content );
            if ( self::looks_arabic( $sample ) ) {
                return 'ar';
            }
        }

        return $site_lang ?: 'en';
    }

    /**
     * Same >30%-of-letters-are-Arabic heuristic as the on-page analyzer's
     * is_arabic() - duplicated here rather than shared because that method
     * is private to its own class, and this check is small and stable
     * enough that the duplication is cheaper than introducing a
     * cross-class dependency for it.
     */
    private static function looks_arabic( $text ) {
        $text = (string) $text;
        if ( '' === trim( $text ) ) return false;
        preg_match_all( '/\p{L}/u', $text, $all );
        $total = count( $all[0] );
        if ( 0 === $total ) return false;
        preg_match_all( '/[\x{0600}-\x{06FF}\x{0750}-\x{077F}\x{08A0}-\x{08FF}]/u', $text, $ar );
        return ( count( $ar[0] ) / $total ) > 0.30;
    }

    /**
     * Returns the decoded schema_data array if it's a complete schema.org
     * document on its own (i.e. it has an @type), null otherwise. A plain
     * set of structured fields (e.g. FAQ {question,answer} pairs, or a flat
     * {price,brand} object for Product) won't have @type and falls through
     * to the normal build_* methods below.
     */
    private static function get_custom_schema( $post_id ) {
        $raw = AWBSEO_Meta_Manager::get( $post_id, 'schema_data' );
        if ( ! $raw ) return null;

        $decoded = json_decode( $raw, true );
        if ( ! is_array( $decoded ) ) return null;

        // Accept both the flat pattern (@type at root) and the @graph pattern
        // (@context + @graph at root, no top-level @type) - the latter is what
        // RankMath, Schema.org generators, and Google's own testing tool produce.
        if ( ! empty( $decoded['@type'] ) || ! empty( $decoded['@graph'] ) ) {
            return $decoded;
        }
        return null;
    }

    private static function infer_type( $post_id ) {
        $post = get_post( $post_id );
        if ( $post->post_type === 'product' ) return 'Product';
        if ( $post->post_type === 'page' )    return 'WebPage';
        return 'BlogPosting';
    }

    private static function base( $post_id ) {
        return [
            'url'         => get_permalink( $post_id ),
            'name'        => AWBSEO_Meta_Manager::get_title( $post_id ),
            'description' => AWBSEO_Meta_Manager::get_description( $post_id ),
            'image'       => AWBSEO_Meta_Manager::get( $post_id, 'og_image', '' ) ?: '',
            'keywords'    => self::build_keywords( $post_id ),
            'datePublished'  => get_the_date( 'c', $post_id ),
            'dateModified'   => get_the_modified_date( 'c', $post_id ),
        ];
    }

    /**
     * Comma-separated schema.org `keywords` value built from the focus
     * keyword and, when set, its Arabizi/transliterated variant - so search
     * crawlers and AI answer engines see both the Arabic-script and
     * code-switched forms of the same term rather than only whichever one
     * happens to appear in the body text. Empty when no focus keyword is
     * set, which array_filter() in class-schema-output.php then strips from
     * the final JSON-LD, same as any other empty field here.
     */
    private static function build_keywords( $post_id ) {
        $keyword = AWBSEO_Meta_Manager::get( $post_id, 'focus_keyword' );
        if ( ! $keyword ) {
            return '';
        }
        $arabizi = AWBSEO_Meta_Manager::get( $post_id, 'focus_keyword_arabizi' );
        return $arabizi ? $keyword . ', ' . $arabizi : $keyword;
    }

    private static function build_generic( $post_id, $type ) {
        return array_merge( [ '@type' => $type ], self::base( $post_id ) );
    }

    private static function build_blogposting( $post_id ) {
        $post = get_post( $post_id );
        // Real E-E-A-T-bearing Person block (credentials, sameAs, knowsAbout,
        // and the correct Arabic/Latin name ordering for this post's actual
        // language) instead of a bare name - see class-author-eeat.php. Falls
        // back gracefully to just the display name when none of those extra
        // profile fields are filled in.
        $author_is_arabic = self::looks_arabic( wp_strip_all_tags( $post->post_title . ' ' . $post->post_content ) );
        $author_schema     = class_exists( 'AWBSEO_Author_EEAT' )
            ? AWBSEO_Author_EEAT::get_author_schema( $post->post_author, $author_is_arabic )
            : [ '@type' => 'Person', 'name' => get_the_author_meta( 'display_name', $post->post_author ) ];

        $site_logo = get_site_icon_url();
        return array_merge( self::base( $post_id ), [
            '@type'  => 'BlogPosting',
            'author' => $author_schema,
            'publisher' => [
                '@type' => 'Organization',
                'name'  => get_bloginfo( 'name' ),
                'logo'  => [ '@type' => 'ImageObject', 'url' => $site_logo ?: '' ],
            ],
            'headline'  => get_the_title( $post_id ),
            'wordCount' => str_word_count( wp_strip_all_tags( $post->post_content ) ),
        ] );
    }

    // Delegate article/newsarticle to blogposting builder with correct type.
    private static function build_article( $post_id )     { $s = self::build_blogposting( $post_id ); $s['@type'] = 'Article';     return $s; }
    private static function build_newsarticle( $post_id ) { $s = self::build_blogposting( $post_id ); $s['@type'] = 'NewsArticle'; return $s; }
    private static function build_webpage( $post_id )     { return array_merge( self::base( $post_id ), [ '@type' => 'WebPage' ] ); }

    // ── Field helpers ────────────────────────────────────────────────────────

    /**
     * Structured values for a post: legacy flat Schema Data JSON (e.g.
     * {"price":"10","sku":"A1"}) merged with the newer Schema Details panel
     * values, the panel winning where both set the same key.
     */
    public static function fields( $post_id ) {
        $legacy = json_decode( (string) AWBSEO_Meta_Manager::get( $post_id, 'schema_data' ), true );
        $legacy = ( is_array( $legacy ) && ! isset( $legacy[0] ) && empty( $legacy['@type'] ) && empty( $legacy['@graph'] ) ) ? $legacy : [];
        $panel  = class_exists( 'AWBSEO_Schema_Fields' ) ? AWBSEO_Schema_Fields::get( $post_id ) : [];
        return array_merge( $legacy, array_filter( $panel, fn( $v ) => '' !== $v && [] !== $v && null !== $v ) );
    }

    /** Field value as trimmed string. */
    private static function f( $f, $key, $default = '' ) {
        $v = $f[ $key ] ?? '';
        return is_scalar( $v ) && '' !== trim( (string) $v ) ? trim( (string) $v ) : $default;
    }

    /**
     * Numeric string from user input, accepting Arabic-Indic (٠-٩) and
     * Persian (۰-۹) digits, the Arabic decimal separator (٫) and thousands
     * separators, so "١٥٠٫٥٠" and "1,250" both come out as valid numbers.
     */
    public static function num( $value ) {
        $value = (string) $value;
        if ( '' === trim( $value ) ) return '';
        $value = strtr( $value, [
            '٠' => '0', '١' => '1', '٢' => '2', '٣' => '3', '٤' => '4', '٥' => '5', '٦' => '6', '٧' => '7', '٨' => '8', '٩' => '9',
            '۰' => '0', '۱' => '1', '۲' => '2', '۳' => '3', '۴' => '4', '۵' => '5', '۶' => '6', '۷' => '7', '۸' => '8', '۹' => '9',
            '٫' => '.', '٬' => '', ',' => '', ' ' => '',
        ] );
        $value = preg_replace( '/[^0-9.\-]/', '', $value );
        return is_numeric( $value ) ? (string) ( $value + 0 ) : '';
    }

    /** One-per-line (or comma/Arabic-comma separated when $split_commas) text or array → clean list. */
    private static function lines( $value, $split_commas = false ) {
        if ( is_array( $value ) ) {
            $items = $value;
        } else {
            $pattern = $split_commas ? '/[\r\n,،]+/u' : '/[\r\n]+/';
            $items   = preg_split( $pattern, (string) $value );
        }
        return array_values( array_filter( array_map( fn( $i ) => is_scalar( $i ) ? trim( (string) $i ) : '', $items ), 'strlen' ) );
    }

    /** "2026-10-05T19:30" in the site timezone → ISO 8601 with offset. Date-only stays a date. */
    private static function iso_date( $value ) {
        $value = trim( (string) $value );
        if ( '' === $value ) return '';
        if ( preg_match( '/^\d{4}-\d{2}-\d{2}$/', $value ) ) return $value;
        try {
            $dt = new DateTime( $value, wp_timezone() );
            return $dt->format( 'c' );
        } catch ( Exception $e ) {
            return '';
        }
    }

    /** Minutes (+ seconds) → ISO 8601 duration, e.g. 95 → PT1H35M. */
    private static function iso_duration( $minutes, $seconds = 0 ) {
        $total = (int) round( (float) self::num( $minutes ) * 60 ) + (int) self::num( $seconds );
        if ( $total <= 0 ) return '';
        $h = intdiv( $total, 3600 );
        $m = intdiv( $total % 3600, 60 );
        $s = $total % 60;
        return 'PT' . ( $h ? $h . 'H' : '' ) . ( $m ? $m . 'M' : '' ) . ( $s ? $s . 'S' : '' );
    }

    private static function featured_image( $post_id ) {
        $img = get_the_post_thumbnail_url( $post_id, 'full' );
        return $img ?: ( AWBSEO_Meta_Manager::get( $post_id, 'og_image' ) ?: '' );
    }

    private static function site_logo() {
        $logo_id = get_theme_mod( 'custom_logo' );
        $logo    = $logo_id ? wp_get_attachment_image_url( $logo_id, 'full' ) : '';
        return $logo ?: ( get_site_icon_url() ?: '' );
    }

    private static function site_org() {
        return [
            '@type' => 'Organization',
            '@id'   => home_url( '/#organization' ),
            'name'  => get_bloginfo( 'name' ),
            'url'   => home_url( '/' ),
            'logo'  => self::site_logo(),
        ];
    }

    private static function offer( $f, $url = '' ) {
        $price = self::num( $f['price'] ?? '' );
        if ( '' === $price ) return null;
        return [
            '@type'         => 'Offer',
            'price'         => $price,
            'priceCurrency' => self::f( $f, 'currency', 'USD' ),
            'url'           => $url,
        ];
    }

    private static function rating( $f ) {
        $value = self::num( $f['rating_value'] ?? '' );
        $count = self::num( $f['rating_count'] ?? ( $f['review_count'] ?? '' ) );
        if ( '' === $value || '' === $count ) return null;
        return [ '@type' => 'AggregateRating', 'ratingValue' => $value, 'ratingCount' => $count ];
    }

    private static function address( $f ) {
        return [
            '@type'           => 'PostalAddress',
            'streetAddress'   => self::f( $f, 'street' ),
            'addressLocality' => self::f( $f, 'city' ),
            'addressRegion'   => self::f( $f, 'region' ),
            'postalCode'      => self::f( $f, 'zip' ),
            'addressCountry'  => strtoupper( self::f( $f, 'country' ) ),
        ];
    }

    /** [ name, alternateName ] ordered for the page language when an Arabic name exists. */
    private static function bilingual_name( $name, $name_ar, $post_id ) {
        $name_ar = trim( (string) $name_ar );
        if ( '' === $name_ar || $name_ar === $name ) return [ $name, '' ];
        return self::page_is_arabic( $post_id ) ? [ $name_ar, $name ] : [ $name, $name_ar ];
    }

    /** Recursively drop '', null and [] values, and objects left with nothing but an @type. */
    public static function prune( $value ) {
        if ( ! is_array( $value ) ) return $value;
        $is_list = array_keys( $value ) === range( 0, count( $value ) - 1 );
        $out     = [];
        foreach ( $value as $k => $v ) {
            $v = self::prune( $v );
            if ( null === $v || '' === $v || [] === $v ) continue;
            $out[ $k ] = $v;
        }
        if ( ! $is_list && isset( $out['@type'] ) && 1 === count( $out ) ) return null;
        return $is_list ? array_values( $out ) : $out;
    }

    // ── Group builders ───────────────────────────────────────────────────────

    private static function build_group_event( $post_id, $type ) {
        $f     = self::fields( $post_id );
        $mode  = self::f( $f, 'attendance_mode', 'OnlineEvent' === $type ? 'online' : 'offline' );
        $modes = [ 'offline' => 'OfflineEventAttendanceMode', 'online' => 'OnlineEventAttendanceMode', 'mixed' => 'MixedEventAttendanceMode' ];

        $locations = [];
        if ( 'online' !== $mode ) {
            $venue = null;
            $loc   = (int) self::num( $f['venue_location'] ?? '' ) ? AWBSEO_Local_SEO::get_location( (int) self::num( $f['venue_location'] ) ) : null;
            if ( $loc ) {
                $venue = AWBSEO_Local_SEO::place_schema( $loc, $post_id );
            } elseif ( self::f( $f, 'venue_name' ) || self::f( $f, 'city' ) ) {
                $venue = [ '@type' => 'Place', 'name' => self::f( $f, 'venue_name' ), 'address' => self::address( $f ) ];
            }
            if ( $venue ) $locations[] = $venue;
        }
        if ( 'offline' !== $mode && self::f( $f, 'online_url' ) ) {
            $locations[] = [ '@type' => 'VirtualLocation', 'url' => esc_url_raw( self::f( $f, 'online_url' ) ) ];
        }

        $offer = self::offer( $f, esc_url_raw( self::f( $f, 'ticket_url' ) ) ?: get_permalink( $post_id ) );
        if ( $offer ) {
            $offer['availability'] = 'https://schema.org/' . self::f( $f, 'availability', 'InStock' );
        }

        return array_merge( self::base( $post_id ), [
            '@type'               => 'OnlineEvent' === $type ? 'Event' : $type, // OnlineEvent isn't a schema.org type - it's Event + online attendance.
            'name'                => get_the_title( $post_id ),
            'image'               => self::featured_image( $post_id ),
            'startDate'           => self::iso_date( $f['start_date'] ?? '' ),
            'endDate'             => self::iso_date( $f['end_date'] ?? '' ),
            'eventAttendanceMode' => 'https://schema.org/' . ( $modes[ $mode ] ?? $modes['offline'] ),
            'eventStatus'         => 'https://schema.org/' . self::f( $f, 'status', 'EventScheduled' ),
            'location'            => 1 === count( $locations ) ? $locations[0] : $locations,
            'organizer'           => [
                '@type' => 'Organization',
                'name'  => self::f( $f, 'organizer_name', get_bloginfo( 'name' ) ),
                'url'   => esc_url_raw( self::f( $f, 'organizer_url', home_url( '/' ) ) ),
            ],
            'performer'           => self::f( $f, 'performer' ) ? [ '@type' => 'Person', 'name' => self::f( $f, 'performer' ) ] : null,
            'offers'              => $offer,
            'datePublished'       => null,
            'dateModified'        => null,
            'keywords'            => null,
        ] );
    }

    private static function build_group_course( $post_id, $type ) {
        $f        = self::fields( $post_id );
        $instance = [
            '@type'          => 'CourseInstance',
            'courseMode'     => self::f( $f, 'course_mode' ),
            'courseWorkload' => self::iso_duration( (float) self::num( $f['workload_hours'] ?? '' ) * 60 ),
            'startDate'      => self::iso_date( $f['start_date'] ?? '' ),
            'endDate'        => self::iso_date( $f['end_date'] ?? '' ),
        ];
        $offer = self::offer( $f, get_permalink( $post_id ) );
        if ( $offer ) {
            $offer['category'] = '0' === $offer['price'] ? 'Free' : 'Paid';
        }
        return array_merge( self::base( $post_id ), [
            '@type'             => 'Course',
            'name'              => get_the_title( $post_id ),
            'courseCode'        => self::f( $f, 'course_code' ),
            'provider'          => [
                '@type'  => 'Organization',
                'name'   => self::f( $f, 'provider_name', get_bloginfo( 'name' ) ),
                'sameAs' => esc_url_raw( self::f( $f, 'provider_url', home_url( '/' ) ) ),
            ],
            'hasCourseInstance' => count( array_filter( $instance ) ) > 1 ? [ $instance ] : null,
            'offers'            => $offer ? [ $offer ] : null,
            'datePublished'     => null,
            'dateModified'      => null,
        ] );
    }

    private static function build_group_review( $post_id, $type ) {
        $f    = self::fields( $post_id );
        $post = get_post( $post_id );
        return [
            '@type'         => 'Review',
            'name'          => get_the_title( $post_id ),
            'url'           => get_permalink( $post_id ),
            'itemReviewed'  => [ '@type' => self::f( $f, 'item_type', 'Product' ), 'name' => self::f( $f, 'item_name' ) ],
            'reviewRating'  => '' !== self::num( $f['rating_value'] ?? '' ) ? [
                '@type'       => 'Rating',
                'ratingValue' => self::num( $f['rating_value'] ),
                'bestRating'  => self::num( $f['best_rating'] ?? '' ) ?: '5',
                'worstRating' => '1',
            ] : null,
            'author'        => [ '@type' => 'Person', 'name' => self::f( $f, 'author_name', get_the_author_meta( 'display_name', $post->post_author ) ) ],
            'datePublished' => get_the_date( 'c', $post_id ),
            'reviewBody'    => AWBSEO_Meta_Manager::get_description( $post_id ),
            'publisher'     => self::site_org(),
        ];
    }

    /** First YouTube/Vimeo video in the content → [ embedUrl, thumbnail ]. */
    private static function detect_video( $content ) {
        if ( preg_match( '~(?:youtube\.com/(?:watch\?v=|embed/|shorts/)|youtu\.be/)([A-Za-z0-9_-]{11})~', $content, $m ) ) {
            return [ 'https://www.youtube.com/embed/' . $m[1], 'https://i.ytimg.com/vi/' . $m[1] . '/hqdefault.jpg' ];
        }
        if ( preg_match( '~vimeo\.com/(?:video/)?(\d+)~', $content, $m ) ) {
            return [ 'https://player.vimeo.com/video/' . $m[1], '' ];
        }
        return [ '', '' ];
    }

    private static function build_group_video( $post_id, $type ) {
        $f                  = self::fields( $post_id );
        $embed              = esc_url_raw( self::f( $f, 'embed_url' ) );
        [ $found, $thumb ]  = self::detect_video( $embed ?: (string) get_post_field( 'post_content', $post_id ) );
        $upload             = self::iso_date( $f['upload_date'] ?? '' );
        return [
            '@type'        => 'VideoObject',
            'name'         => get_the_title( $post_id ),
            'description'  => AWBSEO_Meta_Manager::get_description( $post_id ) ?: get_the_title( $post_id ),
            'thumbnailUrl' => esc_url_raw( self::f( $f, 'thumbnail_url' ) ) ?: ( $thumb ?: self::featured_image( $post_id ) ),
            'uploadDate'   => $upload ?: get_the_date( 'c', $post_id ),
            'duration'     => self::iso_duration( $f['duration_min'] ?? 0, $f['duration_sec'] ?? 0 ),
            'embedUrl'     => $found ?: $embed,
            'contentUrl'   => esc_url_raw( self::f( $f, 'content_url' ) ),
            'url'          => get_permalink( $post_id ),
            'publisher'    => self::site_org(),
        ];
    }

    private static function build_group_organization( $post_id, $type ) {
        $f               = self::fields( $post_id );
        [ $name, $alt ]  = self::bilingual_name( self::f( $f, 'name', get_bloginfo( 'name' ) ), self::f( $f, 'name_ar' ), $post_id );
        $phone           = self::f( $f, 'phone' );
        return [
            '@type'        => $type,
            '@id'          => home_url( '/#organization' ),
            'name'         => $name,
            'alternateName'=> $alt,
            'legalName'    => self::f( $f, 'legal_name' ),
            'url'          => home_url( '/' ),
            'logo'         => esc_url_raw( self::f( $f, 'logo' ) ) ?: self::site_logo(),
            'description'  => AWBSEO_Meta_Manager::get_description( $post_id ),
            'email'        => sanitize_email( self::f( $f, 'email' ) ),
            'telephone'    => $phone,
            'address'      => self::address( $f ),
            'foundingDate' => self::iso_date( $f['founding_date'] ?? '' ),
            'sameAs'       => array_map( 'esc_url_raw', self::lines( $f['same_as'] ?? '' ) ),
            'contactPoint' => $phone ? [
                '@type'             => 'ContactPoint',
                'telephone'         => $phone,
                'contactType'       => 'customer service',
                'availableLanguage' => self::lines( $f['languages'] ?? '', true ),
            ] : null,
        ];
    }

    private static function build_group_person( $post_id, $type ) {
        $f              = self::fields( $post_id );
        [ $name, $alt ] = self::bilingual_name( self::f( $f, 'name', get_the_title( $post_id ) ), self::f( $f, 'name_ar' ), $post_id );
        return [
            '@type'         => 'Person',
            '@id'           => trailingslashit( get_permalink( $post_id ) ) . '#person',
            'name'          => $name,
            'alternateName' => $alt,
            'url'           => get_permalink( $post_id ),
            'image'         => esc_url_raw( self::f( $f, 'image' ) ) ?: self::featured_image( $post_id ),
            'jobTitle'      => self::f( $f, 'job_title' ),
            'description'   => AWBSEO_Meta_Manager::get_description( $post_id ),
            'email'         => sanitize_email( self::f( $f, 'email' ) ),
            'worksFor'      => [ '@type' => 'Organization', 'name' => self::f( $f, 'works_for', get_bloginfo( 'name' ) ) ],
            'knowsAbout'    => self::lines( $f['knows_about'] ?? '' ),
            'sameAs'        => array_map( 'esc_url_raw', self::lines( $f['same_as'] ?? '' ) ),
        ];
    }

    private static function build_group_localbusiness( $post_id, $type ) {
        $f   = self::fields( $post_id );
        $id  = (int) self::num( $f['location_id'] ?? '' );
        $loc = $id ? AWBSEO_Local_SEO::get_location( $id ) : AWBSEO_Local_SEO::get_primary_location();
        if ( ! $loc ) {
            return self::build_generic( $post_id, $type );
        }
        $schema = AWBSEO_Local_SEO::build_schema( $loc, $post_id, $type );
        $extra  = [
            'servesCuisine'       => self::lines( $f['serves_cuisine'] ?? '', true ),
            'hasMenu'             => esc_url_raw( self::f( $f, 'menu_url' ) ),
            'acceptsReservations' => ! empty( $f['accepts_reservations'] ) ? 'True' : '',
            'starRating'          => self::num( $f['star_rating'] ?? '' ) ? [ '@type' => 'Rating', 'ratingValue' => self::num( $f['star_rating'] ) ] : null,
        ];
        return array_merge( $schema, $extra );
    }

    private static function build_group_software( $post_id, $type ) {
        $f = self::fields( $post_id );
        return array_merge( self::base( $post_id ), [
            '@type'               => $type,
            'name'                => get_the_title( $post_id ),
            'operatingSystem'     => self::f( $f, 'operating_system' ),
            'applicationCategory' => self::f( $f, 'category' ),
            'offers'              => self::offer( $f ),
            'aggregateRating'     => self::rating( $f ),
            'downloadUrl'         => esc_url_raw( self::f( $f, 'download_url' ) ),
            'softwareVersion'     => self::f( $f, 'version' ),
            'image'               => self::featured_image( $post_id ),
        ] );
    }

    private static function build_group_book( $post_id, $type ) {
        $f = self::fields( $post_id );
        return array_merge( self::base( $post_id ), [
            '@type'         => 'Book',
            'name'          => get_the_title( $post_id ),
            'image'         => self::featured_image( $post_id ),
            'author'        => self::f( $f, 'author_name' ) ? [ '@type' => 'Person', 'name' => self::f( $f, 'author_name' ) ] : null,
            'isbn'          => self::f( $f, 'isbn' ),
            'bookFormat'    => self::f( $f, 'book_format' ) ? 'https://schema.org/' . self::f( $f, 'book_format' ) : '',
            'publisher'     => self::f( $f, 'publisher' ) ? [ '@type' => 'Organization', 'name' => self::f( $f, 'publisher' ) ] : null,
            'datePublished' => self::iso_date( $f['date_published'] ?? '' ),
            'numberOfPages' => self::num( $f['pages'] ?? '' ),
            'inLanguage'    => self::page_language( $post_id ),
            'dateModified'  => null,
        ] );
    }

    private static function build_group_service( $post_id, $type ) {
        $f        = self::fields( $post_id );
        $loc_id   = (int) self::num( $f['location_id'] ?? '' );
        $loc      = $loc_id ? AWBSEO_Local_SEO::get_location( $loc_id ) : null;
        $provider = $loc ? AWBSEO_Local_SEO::build_schema( $loc, $post_id ) : self::site_org();
        return [
            '@type'       => 'Service',
            'name'        => get_the_title( $post_id ),
            'serviceType' => self::f( $f, 'service_type' ),
            'description' => AWBSEO_Meta_Manager::get_description( $post_id ),
            'url'         => get_permalink( $post_id ),
            'image'       => self::featured_image( $post_id ),
            'provider'    => $provider,
            'areaServed'  => self::lines( $f['area_served'] ?? '', true ),
            'offers'      => self::offer( $f, get_permalink( $post_id ) ),
        ];
    }

    private static function build_group_dataset( $post_id, $type ) {
        $f   = self::fields( $post_id );
        $url = esc_url_raw( self::f( $f, 'download_url' ) );
        return [
            '@type'              => 'Dataset',
            'name'               => get_the_title( $post_id ),
            'description'        => AWBSEO_Meta_Manager::get_description( $post_id ),
            'url'                => get_permalink( $post_id ),
            'creator'            => [ '@type' => 'Organization', 'name' => self::f( $f, 'creator', get_bloginfo( 'name' ) ) ],
            'license'            => esc_url_raw( self::f( $f, 'license' ) ),
            'keywords'           => self::lines( $f['keywords'] ?? '', true ),
            'temporalCoverage'   => self::f( $f, 'temporal' ),
            'spatialCoverage'    => self::f( $f, 'spatial' ),
            'distribution'       => $url ? [ [ '@type' => 'DataDownload', 'contentUrl' => $url, 'encodingFormat' => self::f( $f, 'file_format' ) ] ] : null,
            'isAccessibleForFree'=> true,
        ];
    }

    private static function build_group_product( $post_id, $type ) {
        $f     = self::fields( $post_id );
        $offer = self::offer( $f, get_permalink( $post_id ) );
        if ( $offer ) {
            $offer['availability']    = 'https://schema.org/' . self::f( $f, 'availability', 'InStock' );
            $offer['itemCondition']   = self::f( $f, 'condition' ) ? 'https://schema.org/' . self::f( $f, 'condition' ) : '';
            $offer['priceValidUntil'] = self::iso_date( $f['price_valid_until'] ?? '' );
        }
        return array_merge( self::base( $post_id ), [
            '@type'           => 'Product',
            'name'            => get_the_title( $post_id ),
            'image'           => self::featured_image( $post_id ),
            'sku'             => self::f( $f, 'sku' ),
            'gtin'            => self::f( $f, 'gtin' ),
            'mpn'             => self::f( $f, 'mpn' ),
            'brand'           => [ '@type' => 'Brand', 'name' => self::f( $f, 'brand', get_bloginfo( 'name' ) ) ],
            'offers'          => $offer,
            'aggregateRating' => self::rating( $f ),
            'datePublished'   => null,
            'dateModified'    => null,
        ] );
    }

    private static function build_group_job( $post_id, $type ) {
        $f       = self::fields( $post_id );
        $remote  = ! empty( $f['remote'] );
        $raw     = preg_replace( '#<(script|style)[^>]*>.*?</\\1>#is', '', strip_shortcodes( (string) get_post_field( 'post_content', $post_id ) ) );
        $content = wp_kses( $raw, [
            'p' => [], 'br' => [], 'ul' => [], 'ol' => [], 'li' => [], 'strong' => [], 'em' => [], 'b' => [], 'h2' => [], 'h3' => [], 'h4' => [],
        ] );
        $salary  = self::num( $f['salary'] ?? '' );
        $country = strtoupper( self::f( $f, 'country' ) );
        return [
            '@type'              => 'JobPosting',
            'title'              => get_the_title( $post_id ),
            'description'        => trim( $content ) ?: AWBSEO_Meta_Manager::get_description( $post_id ),
            'datePosted'         => get_the_date( 'c', $post_id ),
            'validThrough'       => self::iso_date( $f['validThrough'] ?? '' ),
            'employmentType'     => self::f( $f, 'employmentType', 'FULL_TIME' ),
            'hiringOrganization' => [
                '@type'  => 'Organization',
                'name'   => self::f( $f, 'company', get_bloginfo( 'name' ) ),
                'sameAs' => home_url( '/' ),
                'logo'   => self::site_logo(),
            ],
            'jobLocationType'    => $remote ? 'TELECOMMUTE' : '',
            'applicantLocationRequirements' => ( $remote && $country ) ? [ '@type' => 'Country', 'name' => $country ] : null,
            'jobLocation'        => $remote ? null : [ '@type' => 'Place', 'address' => self::address( $f ) ],
            'baseSalary'         => '' !== $salary ? [
                '@type'    => 'MonetaryAmount',
                'currency' => self::f( $f, 'currency', 'USD' ),
                'value'    => [ '@type' => 'QuantitativeValue', 'value' => $salary, 'unitText' => self::f( $f, 'salary_unit', 'YEAR' ) ],
            ] : null,
        ];
    }

    private static function build_group_faq( $post_id, $type ) {
        $f    = self::fields( $post_id );
        $faqs = $f['faqs'] ?? [];
        if ( ! $faqs ) {
            // Older posts: Schema Data holds a plain [{question, answer}] list.
            $legacy = json_decode( (string) AWBSEO_Meta_Manager::get( $post_id, 'schema_data' ), true );
            $faqs   = ( is_array( $legacy ) && isset( $legacy[0] ) ) ? $legacy : [];
        }
        $entities = [];
        foreach ( (array) $faqs as $faq ) {
            if ( empty( $faq['question'] ) || empty( $faq['answer'] ) ) continue;
            $entities[] = [
                '@type'          => 'Question',
                'name'           => sanitize_text_field( $faq['question'] ),
                'acceptedAnswer' => [ '@type' => 'Answer', 'text' => wp_kses_post( $faq['answer'] ) ],
            ];
        }
        return [
            '@type'      => 'FAQPage',
            'name'       => AWBSEO_Meta_Manager::get_title( $post_id ),
            'url'        => get_permalink( $post_id ),
            'mainEntity' => $entities,
        ];
    }

    private static function build_group_howto( $post_id, $type ) {
        $f     = self::fields( $post_id );
        $steps = [];
        foreach ( (array) ( $f['steps'] ?? [] ) as $i => $step ) {
            if ( ! is_array( $step ) || ( empty( $step['text'] ) && empty( $step['name'] ) ) ) continue;
            $steps[] = [
                '@type'    => 'HowToStep',
                'position' => count( $steps ) + 1,
                'name'     => $step['name'] ?? '',
                'text'     => $step['text'] ?? ( $step['name'] ?? '' ),
            ];
        }
        $cost = self::num( $f['cost'] ?? '' );
        return array_merge( self::base( $post_id ), [
            '@type'         => 'HowTo',
            'name'          => get_the_title( $post_id ),
            'image'         => self::featured_image( $post_id ),
            'totalTime'     => self::f( $f, 'totalTime' ) ?: self::iso_duration( $f['total_minutes'] ?? 0 ),
            'estimatedCost' => '' !== $cost ? [ '@type' => 'MonetaryAmount', 'currency' => self::f( $f, 'currency', 'USD' ), 'value' => $cost ] : null,
            'supply'        => array_map( fn( $s ) => [ '@type' => 'HowToSupply', 'name' => $s ], self::lines( $f['supplies'] ?? '' ) ),
            'tool'          => array_map( fn( $s ) => [ '@type' => 'HowToTool', 'name' => $s ], self::lines( $f['tools'] ?? '' ) ),
            'step'          => $steps,
        ] );
    }

    private static function build_group_recipe( $post_id, $type ) {
        $f    = self::fields( $post_id );
        $prep = self::f( $f, 'prepTime' ) ?: self::iso_duration( $f['prep_minutes'] ?? 0 );
        $cook = self::f( $f, 'cookTime' ) ?: self::iso_duration( $f['cook_minutes'] ?? 0 );
        $total_min = (float) self::num( $f['prep_minutes'] ?? '' ) + (float) self::num( $f['cook_minutes'] ?? '' );
        $post = get_post( $post_id );
        return array_merge( self::base( $post_id ), [
            '@type'              => 'Recipe',
            'name'               => get_the_title( $post_id ),
            'image'              => esc_url_raw( self::f( $f, 'image' ) ) ?: self::featured_image( $post_id ),
            'author'             => [ '@type' => 'Person', 'name' => get_the_author_meta( 'display_name', $post->post_author ) ],
            'recipeCuisine'      => self::f( $f, 'cuisine' ),
            'recipeCategory'     => self::f( $f, 'category' ),
            'prepTime'           => $prep,
            'cookTime'           => $cook,
            'totalTime'          => self::f( $f, 'totalTime' ) ?: ( $total_min ? self::iso_duration( $total_min ) : '' ),
            'recipeYield'        => self::f( $f, 'yield' ),
            'recipeIngredient'   => self::lines( $f['ingredients'] ?? '' ),
            'recipeInstructions' => array_map( fn( $s ) => [ '@type' => 'HowToStep', 'text' => $s ], self::lines( $f['instructions'] ?? '' ) ),
            'nutrition'          => '' !== self::num( $f['calories'] ?? '' ) ? [ '@type' => 'NutritionInformation', 'calories' => self::num( $f['calories'] ) . ' calories' ] : null,
            'aggregateRating'    => self::rating( $f ),
        ] );
    }
}