<?php
namespace Akram;

defined( 'ABSPATH' ) || exit;

/**
 * Server-rendered widgets (inner HTML; the editor engine renders the root element).
 */
final class Widgets {

	/** Widgets rendered on the server: widget type => the method that renders it. Nothing else can be called. */
	const RENDERERS = array(
		'posts'               => 'w_posts',
		'nav-menu'            => 'w_nav_menu',
		'site-logo'           => 'w_site_logo',
		'site-title'          => 'w_site_title',
		'breadcrumbs'         => 'w_breadcrumbs',
		'shortcode'           => 'w_shortcode',
		'sitemap'             => 'w_sitemap',
		'login'               => 'w_login',
		'post-title'          => 'w_post_title',
		'post-content'        => 'w_post_content',
		'post-excerpt'        => 'w_post_excerpt',
		'featured-image'      => 'w_featured_image',
		'post-meta'           => 'w_post_meta',
		'author-box'          => 'w_author_box',
		'post-nav'            => 'w_post_nav',
		'comments'            => 'w_comments',
		'archive-title'       => 'w_archive_title',
		'archive-desc'        => 'w_archive_desc',
		'terms'               => 'w_terms',
		'products'            => 'w_products',
		'product-related'     => 'w_product_related',
		'product-categories'  => 'w_product_categories',
		'product-title'       => 'w_product_title',
		'product-price'       => 'w_product_price',
		'product-atc'         => 'w_product_atc',
		'product-gallery'     => 'w_product_gallery',
		'product-rating'      => 'w_product_rating',
		'product-stock'       => 'w_product_stock',
		'product-meta'        => 'w_product_meta',
		'product-short'       => 'w_product_short',
		'product-tabs'        => 'w_product_tabs',
		'cart-icon'           => 'w_cart_icon',
		'wc-page'             => 'w_wc_page',
		'product-filter'      => 'w_product_filter',
		'news-ticker'         => 'w_news_ticker',
		'sidebar'             => 'w_sidebar',
		'terms-list'          => 'w_terms_list',
		'social-feed'         => 'w_social_feed',
		'google-reviews'      => 'w_google_reviews',
		'wc-notices'          => 'w_wc_notices',
	);

	private static $ctx_backup = null;
	/** Last loop render pieces (used by the AJAX endpoint). */
	private static $parts = array();

	// ------------------------------------------------------------------
	// Context for editor previews
	// ------------------------------------------------------------------
	public static function setup_context( $post_id, $preview = null ) {
		global $post, $wp_query;
		self::$ctx_backup = array(
			'post'  => $post,
			'query' => $wp_query,
		);
		$target = (int) $post_id;
		if ( $target && 'akram_template' === get_post_type( $target ) ) {
			$type   = Post_Types::template_type( $target );
			$chosen = $preview ? (int) $preview : (int) get_post_meta( $target, '_akram_preview', true );
			if ( in_array( $type, array( 'archive', 'search', 'loop' ), true ) || ! $chosen ) {
				$q = new \WP_Query( array(
					'post_type'      => 'post',
					'posts_per_page' => (int) get_option( 'posts_per_page', 10 ),
					'post_status'    => 'publish',
				) );
				if ( 'search' === $type ) {
					$q->set( 's', 'a' );
				}
				$wp_query = $q;
				$GLOBALS['wp_the_query'] = $q;
			}
			if ( ! $chosen && in_array( $type, array( 'single', 'loop', 'header', 'footer', 'popup', 'section', 'component' ), true ) ) {
				$latest = get_posts( array(
					'post_type'      => 'post',
					'posts_per_page' => 1,
					'fields'         => 'ids',
				) );
				$chosen = $latest ? (int) $latest[0] : 0;
			}
			$target = $chosen;
		}
		if ( $target ) {
			$post = get_post( $target );
			if ( $post ) {
				setup_postdata( $post );
				if ( function_exists( 'wc_get_product' ) && 'product' === $post->post_type ) {
					$GLOBALS['product'] = wc_get_product( $post->ID ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited, WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound -- WooCommerce's own global product, needed by its template functions.
				}
			}
		}
	}

	public static function reset_context() {
		global $post, $wp_query;
		if ( self::$ctx_backup ) {
			$post     = self::$ctx_backup['post'];
			$wp_query = self::$ctx_backup['query'];
			$GLOBALS['wp_the_query'] = $wp_query;
			if ( $post ) {
				setup_postdata( $post );
			}
		}
		self::$ctx_backup = null;
	}

	// ------------------------------------------------------------------
	public static function render( $type, array $s, $id, $post_id, $preview = false ) {
		$method = self::RENDERERS[ $type ] ?? '';
		if ( '' === $method ) {
			return (string) apply_filters( 'akram_render_widget', '', $type, $s, $id, $post_id );
		}
		try {
			$html = (string) self::$method( $s, $id, (int) $post_id, $preview );
		} catch ( \Throwable $e ) {
			$html = $preview ? '<div class="nx-placeholder">' . esc_html( $e->getMessage() ) . '</div>' : '';
		}
		if ( $preview && '' === trim( $html ) ) {
			$html = '<div class="nx-placeholder"><b>'
				. esc_html( ucwords( str_replace( '-', ' ', $type ) ) ) . '</b><span>'
				. esc_html__( 'Nothing to show in this preview context.', 'akram' ) . '</span></div>';
		}
		return $html;
	}

	private static function v( $s, $k, $d = '' ) {
		if ( ! isset( $s[ $k ] ) || '' === $s[ $k ] || null === $s[ $k ] ) {
			return $d;
		}
		return $s[ $k ];
	}

	private static function icon( $name ) {
		static $icons = array(
			'chevron'  => '<path d="m6 9 6 6 6-6"/>',
			'plus'     => '<path d="M5 12h14M12 5v14"/>',
			'arrow'    => '<path d="M5 12h14M12 5l7 7-7 7"/>',
			'calendar' => '<rect x="3" y="4" width="18" height="18" rx="2"/><path d="M16 2v4M8 2v4M3 10h18"/>',
			'user'     => '<circle cx="12" cy="8" r="4"/><path d="M20 21a8 8 0 0 0-16 0"/>',
			'folder'   => '<path d="M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z"/>',
			'comment'  => '<path d="M7.9 20A9 9 0 1 0 4 16.1L2 22Z"/>',
			'clock'    => '<circle cx="12" cy="12" r="10"/><path d="M12 6v6l4 2"/>',
			'tag'      => '<path d="M12.6 2.6A2 2 0 0 0 11.2 2H4a2 2 0 0 0-2 2v7.2a2 2 0 0 0 .6 1.4l8.7 8.7a2.4 2.4 0 0 0 3.4 0l6.6-6.6a2.4 2.4 0 0 0 0-3.4z"/><circle cx="7.5" cy="7.5" r=".5"/>',
			'cart'     => '<circle cx="8" cy="21" r="1"/><circle cx="19" cy="21" r="1"/><path d="M2.05 2.05h2l2.66 12.42a2 2 0 0 0 2 1.58h9.78a2 2 0 0 0 1.95-1.57l1.65-7.43H5.12"/>',
			'x'        => '<path d="M18 6 6 18M6 6l12 12"/>',
			'left'     => '<path d="m15 18-6-6 6-6"/>',
			'right'    => '<path d="m9 18 6-6-6-6"/>',
			'heart'    => '<path d="M19 14c1.49-1.46 3-3.21 3-5.5A5.5 5.5 0 0 0 16.5 3c-1.76 0-3 .5-4.5 2-1.5-1.5-2.74-2-4.5-2A5.5 5.5 0 0 0 2 8.5c0 2.3 1.5 4.05 3 5.5l7 7Z"/>',
			'eye'      => '<path d="M2.06 12.35a1 1 0 0 1 0-.7 10.75 10.75 0 0 1 19.88 0 1 1 0 0 1 0 .7 10.75 10.75 0 0 1-19.88 0"/><circle cx="12" cy="12" r="3"/>',
			'compare'  => '<path d="m16 3 4 4-4 4M20 7H4m4 14-4-4 4-4m-4 4h16"/>',
			'filter'   => '<path d="M22 3H2l8 9.46V19l4 2v-8.54L22 3z"/>',
			'star'     => '<path d="M11.5 2.3a.5.5 0 0 1 1 0l2.3 4.7a2 2 0 0 0 1.6 1.2l5.2.7a.5.5 0 0 1 .3.9l-3.8 3.7a2 2 0 0 0-.6 1.8l.9 5.2a.5.5 0 0 1-.8.5l-4.6-2.4a2 2 0 0 0-2 0l-4.6 2.4a.5.5 0 0 1-.8-.5l.9-5.2a2 2 0 0 0-.6-1.8L2.2 9.8a.5.5 0 0 1 .3-.9l5.2-.7a2 2 0 0 0 1.6-1.2z"/>',
		);
		return '<svg class="nx-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">'
			. ( $icons[ $name ] ?? '' ) . '</svg>';
	}

	// ------------------------------------------------------------------
	// Posts / Loop grid
	// ------------------------------------------------------------------
	public static function loop_query_args( array $s, $page = 1, $term = '', $ctx = array() ) {
		$source = (string) self::v( $s, 'source', 'post' );
		$count  = max( 1, min( 100, (int) self::v( $s, 'count', 6 ) ) );
		$args   = array(
			'posts_per_page'      => $count,
			'paged'               => max( 1, (int) $page ),
			'post_status'         => 'publish',
			'ignore_sticky_posts' => (bool) self::v( $s, 'sticky', true ),
			'orderby'             => sanitize_key( self::v( $s, 'orderby', 'date' ) ),
			'order'               => 'ASC' === self::v( $s, 'order', 'DESC' ) ? 'ASC' : 'DESC',
		);
		if ( 'meta_value_num' === $args['orderby'] ) {
			$args['meta_key'] = sanitize_text_field( self::v( $s, 'metaKey', '' ) ); // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- bounded query on a builder meta key.
		}
		$offset = (int) self::v( $s, 'offset', 0 );
		if ( $offset ) {
			$args['offset'] = $offset + ( $args['paged'] - 1 ) * $count;
		}
		$current = get_the_ID();
		if ( 'current' === $source ) {
			global $wp_query;
			$qv = $ctx && is_array( $ctx ) ? $ctx : (array) $wp_query->query;
			$allowed = array( 'cat', 'category_name', 'tag', 'tag_id', 's', 'post_type', 'taxonomy', 'term', 'author', 'author_name', 'year', 'monthnum', 'day', 'product_cat', 'product_tag' );
			foreach ( $allowed as $k ) {
				if ( isset( $qv[ $k ] ) && '' !== $qv[ $k ] ) {
					$args[ $k ] = is_array( $qv[ $k ] ) ? array_map( 'sanitize_text_field', $qv[ $k ] ) : sanitize_text_field( (string) $qv[ $k ] );
				}
			}
			// The context can come from a visitor's request (AJAX pagination): only publicly viewable types are allowed.
			if ( ! empty( $args['post_type'] ) ) {
				$types = array_filter( (array) $args['post_type'], static function ( $t ) {
					return 'any' === $t || ( post_type_exists( $t ) && is_post_type_viewable( $t ) && 0 !== strpos( $t, 'akram_' ) );
				} );
				$args['post_type'] = $types ? array_values( $types ) : 'post';
			}
			if ( ! empty( $args['taxonomy'] ) && ! ( taxonomy_exists( $args['taxonomy'] ) && is_taxonomy_viewable( $args['taxonomy'] ) ) ) {
				unset( $args['taxonomy'], $args['term'] );
			}
			if ( empty( $args['post_type'] ) ) {
				$args['post_type'] = isset( $args['s'] ) ? 'any' : 'post';
			}
			$args['posts_per_page'] = $count ?: (int) get_option( 'posts_per_page' );
		} elseif ( 'related' === $source ) {
			$args['post_type'] = get_post_type( $current ) ?: 'post';
			$terms             = wp_get_post_terms( $current, 'post' === $args['post_type'] ? 'category' : ( 'product' === $args['post_type'] ? 'product_cat' : 'category' ), array( 'fields' => 'ids' ) );
			if ( $terms && ! is_wp_error( $terms ) ) {
				$args['tax_query'] = array( // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_tax_query -- bounded query on a builder meta key.
					array(
						'taxonomy' => 'product' === $args['post_type'] ? 'product_cat' : 'category',
						'terms'    => $terms,
					),
				);
			}
			$args['post__not_in'] = array( $current ); // phpcs:ignore WordPressVIPMinimum.Performance.WPQueryParams.PostNotIn_post__not_in -- excludes only the post being viewed from its related posts.
		} elseif ( 'manual' === $source ) {
			$ids               = array_filter( array_map( 'absint', is_array( $s['ids'] ?? null ) ? $s['ids'] : explode( ',', (string) self::v( $s, 'ids', '' ) ) ) );
			$args['post_type'] = 'any';
			$args['post__in']  = $ids ?: array( 0 );
			$args['orderby']   = 'post__in';
		} else {
			$args['post_type'] = post_type_exists( $source ) ? $source : 'post';
		}
		$tax = array();
		foreach ( array(
			'terms'   => 'IN',
			'exTerms' => 'NOT IN',
		) as $key => $op ) {
			$ids = array_filter( array_map( 'absint', is_array( $s[ $key ] ?? null ) ? $s[ $key ] : explode( ',', (string) ( $s[ $key ] ?? '' ) ) ) );
			$by_tax = array();
			foreach ( $ids as $tid ) {
				$t = get_term( $tid );
				if ( $t && ! is_wp_error( $t ) ) {
					$by_tax[ $t->taxonomy ][] = $tid;
				}
			}
			foreach ( $by_tax as $taxonomy => $tids ) {
				$tax[] = array(
					'taxonomy' => $taxonomy,
					'terms'    => $tids,
					'operator' => $op,
				);
			}
		}
		if ( $term ) {
			$t = is_numeric( $term ) ? get_term( (int) $term ) : null;
			if ( $t && ! is_wp_error( $t ) ) {
				$tax[] = array(
					'taxonomy' => $t->taxonomy,
					'terms'    => array( $t->term_id ),
				);
			}
		}
		if ( $tax ) {
			$args['tax_query'] = array_merge( array( 'relation' => 'AND' ), $tax, $args['tax_query'] ?? array() ); // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_tax_query -- bounded query on a builder meta key.
		}
		$author = trim( (string) self::v( $s, 'author', '' ) );
		if ( $author ) {
			$args['author__in'] = array_map( 'absint', explode( ',', $author ) );
		}
		if ( self::v( $s, 'exCurrent', true ) && $current && 'manual' !== $source ) {
			$args['post__not_in'] = array_unique( array_merge( $args['post__not_in'] ?? array(), array( $current ) ) ); // phpcs:ignore WordPressVIPMinimum.Performance.WPQueryParams.PostNotIn_post__not_in -- excludes only the post being viewed.
		}
		return apply_filters( 'akram_loop_query_args', $args, $s );
	}

	private static function w_posts( array $s, $id, $post_id, $preview, $page = null, $term = '', $ctx = null ) {
		$page = $page ?: max( 1, isset( $_GET['nxp'] ) ? (int) $_GET['nxp'] : 1 ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only request value; it changes nothing and is sanitised.
		global $wp_query;
		$is_current = 'current' === self::v( $s, 'source', 'post' );
		$ctx        = null !== $ctx ? $ctx : ( $is_current ? array_intersect_key( (array) $wp_query->query, array_flip( array( 'cat', 'category_name', 'tag', 's', 'post_type', 'taxonomy', 'term', 'author', 'author_name', 'year', 'monthnum', 'day', 'product_cat', 'product_tag' ) ) ) : array() );
		$q          = new \WP_Query( self::loop_query_args( $s, $page, $term, $ctx ) );
		$items      = self::loop_items( $q, $s );
		$layout     = (string) self::v( $s, 'layout', 'grid' );
		$pager      = (string) self::v( $s, 'pager', 'none' );
		$tpl        = (int) self::v( $s, 'tpl', 0 );
		if ( ! $q->have_posts() ) {
			return '<div class="nx-loop"><p class="nx-loop-empty">' . esc_html( self::v( $s, 'empty', __( 'Nothing found.', 'akram' ) ) ) . '</p></div>';
		}
		$filter = '';
		$ftax   = sanitize_key( (string) self::v( $s, 'filter', '' ) );
		if ( $ftax && taxonomy_exists( $ftax ) ) {
			$terms = get_terms( array(
				'taxonomy'   => $ftax,
				'hide_empty' => true,
				'number'     => 20,
			) );
			if ( $terms && ! is_wp_error( $terms ) ) {
				$filter = '<div class="nx-loop-f" role="toolbar"><button type="button" class="is-active" data-term="">' . esc_html__( 'All', 'akram' ) . '</button>';
				foreach ( $terms as $t ) {
					$filter .= '<button type="button" data-term="' . (int) $t->term_id . '">' . esc_html( $t->name ) . '</button>';
				}
				$filter .= '</div>';
			}
		}
		if ( 'carousel' === $layout ) {
			$cfg  = array(
				'auto'   => (float) self::v( $s, 'auto', 0 ),
				'loop'   => (bool) self::v( $s, 'loop', true ),
				'pause'  => true,
				'center' => (bool) self::v( $s, 'center', false ),
				'fx'     => 'slide',
			);
			$body = '<div class="nx-slider" data-nx-slider="' . esc_attr( wp_json_encode( $cfg ) )
				. '"><div class="nx-sl-viewport"><div class="nx-track nx-loop-g">'
				. preg_replace( '/<article class="nx-loop-i/', '<article class="nx-slide nx-loop-i', $items )
				. '</div></div>'
				. ( self::v( $s, 'arrows', true )
					? '<button type="button" class="nx-sl-arrow is-prev" aria-label="' . esc_attr__( 'Previous', 'akram' ) . '">' . self::icon( 'left' ) . '</button>'
						. '<button type="button" class="nx-sl-arrow is-next" aria-label="' . esc_attr__( 'Next', 'akram' ) . '">' . self::icon( 'right' ) . '</button>'
					: '' )
				. ( 'none' !== self::v( $s, 'dots', 'dots' ) ? '<div class="nx-sl-dots is-' . esc_attr( self::v( $s, 'dots', 'dots' ) ) . '"></div>' : '' ) . '</div>';
			Frontend::add_module( 'slider' );
		} else {
			$body = '<div class="nx-loop-g">' . $items . '</div>';
		}
		$pg = self::pager( $q, $pager, $page, $s );
		self::$parts = array(
			'items' => 'carousel' === $layout ? preg_replace( '/<article class="nx-loop-i/', '<article class="nx-slide nx-loop-i', $items ) : $items,
			'max'   => (int) $q->max_num_pages,
			'pager' => $pg,
		);
		$data = array(
			'post'  => (int) $post_id,
			'el'    => $id,
			'pager' => $pager,
			'max'   => (int) $q->max_num_pages,
			'page'  => $page,
			'ctx'   => $ctx,
		);
		wp_reset_postdata();
		return '<div class="nx-loop l-' . esc_attr( $layout )
			. ( $tpl ? ' has-tpl' : ' sk-' . esc_attr( self::v( $s, 'skin', 'card' ) ) ) . '" data-nx-loop="'
			. esc_attr( wp_json_encode( $data ) ) . '">' . $filter . $body . $pg . '</div>';
	}

	private static function pager( \WP_Query $q, $type, $page, $s ) {
		if ( 'none' === $type || $q->max_num_pages < 2 ) {
			return '';
		}
		if ( 'more' === $type || 'infinite' === $type ) {
			return 'more' === $type ? '<div class="nx-loop-more"><button type="button" class="nx-btn v-outline">'
				. esc_html( self::v( $s, 'moreLabel', __( 'Load more', 'akram' ) ) ) . '</button></div>' : '';
		}
		$base = remove_query_arg( 'nxp' );
		if ( 'prevnext' === $type ) {
			$out = '<nav class="nx-pager" aria-label="' . esc_attr__( 'Pagination', 'akram' ) . '">';
			if ( $page > 1 ) {
				$out .= '<a href="' . esc_url( add_query_arg( 'nxp', $page - 1, $base ) )
					. '" data-page="' . ( $page - 1 ) . '">' . esc_html__( '← Previous', 'akram' ) . '</a>';
			}
			if ( $page < $q->max_num_pages ) {
				$out .= '<a href="' . esc_url( add_query_arg( 'nxp', $page + 1, $base ) )
					. '" data-page="' . ( $page + 1 ) . '">' . esc_html__( 'Next →', 'akram' ) . '</a>';
			}
			return $out . '</nav>';
		}
		$out = '<nav class="nx-pager" aria-label="' . esc_attr__( 'Pagination', 'akram' ) . '">';
		for ( $i = 1; $i <= $q->max_num_pages; $i++ ) {
			if ( $q->max_num_pages > 9 && abs( $i - $page ) > 2 && 1 !== $i && (int) $q->max_num_pages !== $i ) {
				if ( 3 === abs( $i - $page ) ) {
					$out .= '<span class="dots">…</span>';
				}
				continue;
			}
			$out .= $i === (int) $page ? '<span class="current" aria-current="page">' . $i
				. '</span>' : '<a href="' . esc_url( add_query_arg( 'nxp', $i, $base ) ) . '" data-page="'
				. $i . '">' . $i . '</a>';
		}
		return $out . '</nav>';
	}

	private static function loop_items( \WP_Query $q, array $s ) {
		$tpl   = (int) self::v( $s, 'tpl', 0 );
		$html  = '';
		$meta  = (array) self::v( $s, 'meta', array( 'date', 'read' ) );
		$size  = sanitize_key( self::v( $s, 'imgSize', 'medium_large' ) );
		$tag   = in_array( self::v( $s, 'titleTag', 'h3' ), array( 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'p', 'div', 'span' ), true ) ? self::v( $s, 'titleTag', 'h3' ) : 'h3';
		$words = (int) self::v( $s, 'excerpt', 18 );
		while ( $q->have_posts() ) {
			$q->the_post();
			$pid = get_the_ID();
			if ( $tpl ) {
				$html .= '<article class="nx-loop-i">' . Frontend::render_post( $tpl ) . '</article>';
				continue;
			}
			$link  = get_permalink();
			$title = get_the_title();
			$img   = '';
			if ( self::v( $s, 'showImg', true ) && has_post_thumbnail() ) {
				$badge = '';
				if ( self::v( $s, 'showBadge', true ) ) {
					$cats = get_the_terms( $pid, 'product' === get_post_type() ? 'product_cat' : 'category' );
					if ( $cats && ! is_wp_error( $cats ) ) {
						$badge = '<span class="nx-pc-badge">' . esc_html( $cats[0]->name ) . '</span>';
					}
				}
				$img = '<a class="nx-pc-img" href="' . esc_url( $link ) . '" tabindex="-1" aria-hidden="true">' . get_the_post_thumbnail( $pid, $size, array(
					'loading'  => 'lazy',
					'decoding' => 'async',
				) ) . $badge . '</a>';
			}
			$m = array();
			foreach ( $meta as $key ) {
				switch ( $key ) {
					case 'author':
						$m[] = '<span>' . esc_html( get_the_author() ) . '</span>';
						break;
					case 'date':
						$m[] = '<time datetime="' . esc_attr( get_the_date( 'c' ) ) . '">' . esc_html( get_the_date() ) . '</time>';
						break;
					case 'cats':
						$c = get_the_category_list( ', ' );
						if ( $c ) {
							$m[] = '<span>' . wp_kses_post( $c ) . '</span>';
						}
						break;
					case 'comments':
						/* translators: %d: comment count */
						$m[] = '<span>' . esc_html( sprintf( _n( '%d comment', '%d comments', get_comments_number(), 'akram' ), get_comments_number() ) ) . '</span>';
						break;
					case 'read':
						$m[] = '<span>' . esc_html( Dynamic::value( 'reading_time', array() ) ) . '</span>';
						break;
					case 'price':
						if ( function_exists( 'wc_get_product' ) && 'product' === get_post_type() ) {
							$p = wc_get_product( $pid );
							$m[] = '<span class="price">' . wp_kses_post( $p ? $p->get_price_html() : '' ) . '</span>';
						}
						break;
				}
			}
			$excerpt = $words > 0 ? '<p class="nx-pc-x">' . esc_html( wp_trim_words( get_the_excerpt(), $words ) ) . '</p>' : '';
			$more    = self::v( $s, 'more', '' ) ? '<a class="nx-pc-more" href="' . esc_url( $link )
				. '" aria-label="' . esc_attr( self::v( $s, 'more' ) . ': ' . wp_strip_all_tags( $title ) )
				. '">' . esc_html( self::v( $s, 'more' ) ) . self::icon( 'arrow' ) . '</a>' : '';
			$html   .= '<article class="nx-loop-i"><div class="nx-pc">' . $img . '<div class="nx-pc-b">'
				. ( $m ? '<div class="nx-pc-m">' . implode( '<span aria-hidden="true">·</span>', $m ) . '</div>' : '' )
				. '<' . $tag . ' class="nx-pc-t"><a href="' . esc_url( $link ) . '">'
				. esc_html( wp_strip_all_tags( $title ) ) . '</a></' . $tag . '>' . $excerpt . $more
				. '</div></div></article>';
		}
		return $html;
	}

	/** Public AJAX endpoint for pagination / load more / filters. */
	public static function rest_loop( \WP_REST_Request $r ) {
		$p    = $r->get_json_params();
		$post = (int) ( $p['post'] ?? 0 );
		$el   = sanitize_key( (string) ( $p['el'] ?? '' ) );
		$status = get_post_status( $post );
		if ( ! $post || ! $el || ( 'publish' !== $status && ! current_user_can( 'edit_post', $post ) ) ) {
			return new \WP_Error( 'akram_missing', 'Not found', array( 'status' => 404 ) );
		}
		$out = Document::get_out( $post );
		$d   = $out['dyn'][ $el ] ?? null;
		if ( ! $d || ! in_array( $d['t'], array( 'posts', 'products' ), true ) ) {
			return new \WP_Error( 'akram_missing', 'Not found', array( 'status' => 404 ) );
		}
		$s    = (array) $d['s'];
		$page = max( 1, (int) ( $p['page'] ?? 1 ) );
		$term = (string) ( $p['term'] ?? '' );
		$ctx  = is_array( $p['ctx'] ?? null ) ? $p['ctx'] : array();
		self::$parts = array(
			'items' => '',
			'max'   => 1,
			'pager' => '',
		);
		if ( 'products' === $d['t'] ) {
			self::w_products( $s, $el, $post, false, $page, $term );
		} else {
			self::w_posts( $s, $el, $post, false, $page, $term, $ctx );
		}
		return self::$parts;

	}

	// ------------------------------------------------------------------
	// Navigation & site
	// ------------------------------------------------------------------
	private static function w_nav_menu( array $s, $id, $post_id, $preview ) {
		$menu = (int) self::v( $s, 'menu', 0 );
		if ( ! $menu ) {
			$menus = wp_get_nav_menus();
			$locs  = get_nav_menu_locations();
			$menu  = $locs ? (int) reset( $locs ) : ( $menus ? (int) $menus[0]->term_id : 0 );
		}
		$args = array(
			'container'   => false,
			'menu_class'  => 'nx-menu',
			'echo'        => false,
			'fallback_cb' => '__return_empty_string',
			'walker'      => new Nav_Walker( self::v( $s, 'indicator', 'chevron' ) ),
			'depth'       => 4,
		);
		if ( $menu ) {
			$args['menu'] = $menu;
		}
		$list = wp_nav_menu( $args );
		if ( ! $list ) {
			$pages = wp_list_pages( array(
				'echo'     => false,
				'title_li' => '',
				'depth'    => 2,
				'number'   => 6,
			) );
			$list  = '<ul class="nx-menu">' . $pages . '</ul>';
		}
		$label = $menu ? wp_get_nav_menu_object( $menu ) : null;
		$bp    = self::v( $s, 'bp', 't' );
		$logo  = '';
		if ( self::v( $s, 'mLogo', true ) ) {
			$lid  = (int) get_theme_mod( 'custom_logo' );
			$logo = $lid ? wp_get_attachment_image( $lid, 'medium', false, array( 'loading' => 'lazy' ) ) : '<b>' . esc_html( get_bloginfo( 'name' ) ) . '</b>';
		}
		$cta = self::v( $s, 'mCta', '' ) ? '<a class="nx-nav-cta nx-btn v-primary" href="'
			. esc_url( self::v( $s, 'mCtaUrl', '#' ) ) . '">' . esc_html( self::v( $s, 'mCta' ) )
			. '</a>' : '';
		$cls = 'nx-nav is-' . esc_attr( self::v( $s, 'layout', 'horizontal' ) ) . ' j-'
			. esc_attr( self::v( $s, 'just', 'start' ) ) . ' p-'
			. esc_attr( self::v( $s, 'pointer', 'underline' ) ) . ' dd-'
			. esc_attr( self::v( $s, 'dropAnim', 'fade-up' ) ) . ' m-'
			. esc_attr( self::v( $s, 'mStyle', 'offcanvas' ) ) . ( 'none' !== $bp ? ' bp-coll' : '' );
		return '<nav class="' . $cls . '" aria-label="' . esc_attr( $label ? $label->name : __( 'Main menu', 'akram' ) ) . '">'
			. ( 'none' !== $bp ? '<button type="button" class="nx-nav-tg" aria-expanded="false" aria-label="' . esc_attr__( 'Open menu', 'akram' ) . '"><i></i><i></i><i></i></button><div class="nx-nav-scrim"></div>' : '' )
			. '<div class="nx-nav-panel">'
				. ( 'none' !== $bp
					? '<div class="nx-nav-panel-h">' . $logo
						. '<button type="button" class="nx-nav-close nx-nav-tg-x" aria-label="'
							. esc_attr__( 'Close menu', 'akram' )
							. '" style="border:0;background:none;cursor:pointer;color:inherit;padding:8px">'
						. self::icon( 'x' ) . '</button></div>'
					: '' )
				. $list . $cta . '</div></nav>';
	}

	private static function w_site_logo( array $s ) {
		$img   = $s['image'] ?? null;
		$stuck = $s['stuck'] ?? null;
		$html  = '';
		if ( ! empty( $img['url'] ) ) {
			$html = '<img src="' . esc_url( $img['url'] ) . '" alt="' . esc_attr( get_bloginfo( 'name' ) )
				. '"'
				. ( ! empty( $img['w'] ) ? ' width="' . (int) $img['w'] . '" height="' . (int) $img['h'] . '"' : '' )
				. ' fetchpriority="high">';
		} else {
			$lid = (int) get_theme_mod( 'custom_logo' );
			if ( $lid ) {
				$html = wp_get_attachment_image( $lid, 'full', false, array(
					'alt'           => get_bloginfo( 'name' ),
					'fetchpriority' => 'high',
					'loading'       => 'eager',
				) );
			} elseif ( 'title' === self::v( $s, 'fallback', 'title' ) ) {
				$html = '<span>' . esc_html( get_bloginfo( 'name' ) ) . '</span>';
			}
		}
		if ( ! empty( $stuck['url'] ) ) {
			$html .= '<img class="is-stuck" src="' . esc_url( $stuck['url'] ) . '" alt="" aria-hidden="true">';
		}
		$cls = 'nx-logo' . ( ! empty( $stuck['url'] ) ? ' has-stuck' : '' );
		return self::v( $s, 'link', true ) ? '<a class="' . $cls . '" href="' . esc_url( home_url( '/' ) )
			. '" rel="home">' . $html . '</a>' : '<span class="' . $cls . '">' . $html . '</span>';
	}

	private static function w_site_title( array $s ) {
		$tag  = in_array( self::v( $s, 'tag', 'div' ), array( 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'p', 'div', 'span' ), true ) ? self::v( $s, 'tag', 'div' ) : 'div';
		$text = esc_html( get_bloginfo( self::v( $s, 'tagline', false ) ? 'description' : 'name' ) );
		return '<' . $tag . ' class="nx-site-title">'
			. ( self::v( $s, 'link', true ) ? '<a href="' . esc_url( home_url( '/' ) ) . '" rel="home">' . $text . '</a>' : $text )
			. '</' . $tag . '>';
	}

	private static function w_breadcrumbs( array $s ) {
		$sep   = array(
			'chevron' => '›',
			'slash'   => '/',
			'arrow'   => '→',
			'dot'     => '•',
		)[ self::v( $s, 'sep', 'chevron' ) ] ?? '›';
		$items = array( array( self::v( $s, 'home', __( 'Home', 'akram' ) ), home_url( '/' ) ) );
		if ( is_singular() ) {
			$p = get_queried_object();
			if ( $p && 'page' !== $p->post_type ) {
				$pto = get_post_type_object( $p->post_type );
				if ( 'post' === $p->post_type ) {
					$blog = (int) get_option( 'page_for_posts' );
					if ( $blog ) {
						$items[] = array( get_the_title( $blog ), get_permalink( $blog ) );
					}
					$cats = get_the_category( $p->ID );
					if ( $cats ) {
						foreach ( array_reverse( get_ancestors( $cats[0]->term_id, 'category' ) ) as $a ) {
							$items[] = array( get_cat_name( $a ), get_category_link( $a ) );
						}
						$items[] = array( $cats[0]->name, get_category_link( $cats[0] ) );
					}
				} elseif ( $pto && $pto->has_archive ) {
					$items[] = array( $pto->labels->name, get_post_type_archive_link( $p->post_type ) );
				}
			}
			if ( $p ) {
				foreach ( array_reverse( get_post_ancestors( $p ) ) as $a ) {
					$items[] = array( get_the_title( $a ), get_permalink( $a ) );
				}
				$items[] = array( get_the_title( $p ), '' );
			}
		} elseif ( is_category() || is_tag() || is_tax() ) {
			$t = get_queried_object();
			foreach ( array_reverse( get_ancestors( $t->term_id, $t->taxonomy ) ) as $a ) {
				$at      = get_term( $a, $t->taxonomy );
				$items[] = array( $at->name, get_term_link( $at ) );
			}
			$items[] = array( $t->name, '' );
		} elseif ( is_search() ) {
			/* translators: %s: search query */
			$items[] = array( sprintf( __( 'Search: %s', 'akram' ), get_search_query() ), '' );
		} elseif ( is_404() ) {
			$items[] = array( __( 'Page not found', 'akram' ), '' );
		} elseif ( is_post_type_archive() ) {
			$items[] = array( post_type_archive_title( '', false ), '' );
		} elseif ( is_author() ) {
			$items[] = array( get_the_author_meta( 'display_name', get_queried_object_id() ), '' );
		} elseif ( is_archive() ) {
			$items[] = array( wp_strip_all_tags( get_the_archive_title() ), '' );
		} elseif ( is_home() && ! is_front_page() ) {
			$items[] = array( get_the_title( (int) get_option( 'page_for_posts' ) ), '' );
		}
		if ( ! self::v( $s, 'current', true ) && count( $items ) > 1 ) {
			array_pop( $items );
		}
		$html = '<nav class="nx-bc" aria-label="' . esc_attr__( 'Breadcrumb', 'akram' ) . '"><ol>';
		$ld   = array();
		foreach ( $items as $i => $it ) {
			if ( $i ) {
				$html .= '<li class="sep" aria-hidden="true">' . esc_html( $sep ) . '</li>';
			}
			$html .= '<li>'
				. ( $it[1] ? '<a href="' . esc_url( $it[1] ) . '">' . esc_html( $it[0] ) . '</a>' : '<span aria-current="page">' . esc_html( $it[0] ) . '</span>' )
				. '</li>';
			$ld[]  = array(
				'@type'    => 'ListItem',
				'position' => $i + 1,
				'name'     => wp_strip_all_tags( $it[0] ),
				'item'     => $it[1] ?: null,
			);
		}
		$html .= '</ol></nav>';
		if ( self::v( $s, 'schema', true ) ) {
			$html .= wp_get_inline_script_tag( wp_json_encode( array(
				'@context'        => 'https://schema.org',
				'@type'           => 'BreadcrumbList',
				'itemListElement' => $ld,
			), JSON_HEX_TAG | JSON_HEX_AMP | JSON_UNESCAPED_SLASHES ), array( 'type' => 'application/ld+json' ) );
		}
		return $html;
	}

	private static function w_shortcode( array $s ) {
		return do_shortcode( (string) self::v( $s, 'code', '' ) );
	}

	private static function w_sitemap( array $s ) {
		$out = '<div class="nx-smap">';
		foreach ( array_filter( array_map( 'trim', explode( ',', (string) self::v( $s, 'types', 'page,post' ) ) ) ) as $type ) {
			if ( ! post_type_exists( $type ) ) {
				continue;
			}
			$out .= '<div><h4>' . esc_html( get_post_type_object( $type )->labels->name ) . '</h4><ul>';
			if ( is_post_type_hierarchical( $type ) ) {
				$out .= wp_list_pages( array(
					'post_type' => $type,
					'title_li'  => '',
					'echo'      => false,
				) );
			} else {
				foreach ( get_posts( array(
					'post_type'      => $type,
					'posts_per_page' => 100,
				) ) as $p ) {
					$out .= '<li><a href="' . esc_url( get_permalink( $p ) ) . '">' . esc_html( get_the_title( $p ) ) . '</a></li>';
				}
			}
			$out .= '</ul></div>';
		}
		return $out . '</div>';
	}

	private static function w_login( array $s ) {
		if ( is_user_logged_in() ) {
			$u = wp_get_current_user();
			return '<div class="nx-login"><p>'
				. esc_html( str_replace( '{name}', $u->display_name, self::v( $s, 'loggedIn', __( 'You are logged in as {name}.', 'akram' ) ) ) )
				. ' <a href="' . esc_url( wp_logout_url( get_permalink() ) ) . '">'
				. esc_html__( 'Log out', 'akram' ) . '</a></p></div>';
		}
		$form  = wp_login_form( array(
			'echo'     => false,
			'redirect' => self::v( $s, 'redirect', '' ) ? esc_url_raw( self::v( $s, 'redirect' ) ) : ( is_singular() ? get_permalink() : home_url( '/' ) ),
			'remember' => (bool) self::v( $s, 'remember', true ),
		) );
		$links = array();
		if ( self::v( $s, 'lost', true ) ) {
			$links[] = '<a href="' . esc_url( wp_lostpassword_url() ) . '">' . esc_html__( 'Lost your password?', 'akram' ) . '</a>';
		}
		if ( self::v( $s, 'register', false ) && get_option( 'users_can_register' ) ) {
			$links[] = '<a href="' . esc_url( wp_registration_url() ) . '">' . esc_html__( 'Create an account', 'akram' ) . '</a>';
		}
		return '<div class="nx-login">' . $form . ( $links ? '<div class="nx-login-links">' . implode( '', $links ) . '</div>' : '' ) . '</div>';
	}

	// ------------------------------------------------------------------
	// Single post parts
	// ------------------------------------------------------------------
	private static function w_post_title( array $s ) {
		$tag   = in_array( self::v( $s, 'tag', 'h1' ), array( 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'p', 'div', 'span' ), true ) ? self::v( $s, 'tag', 'h1' ) : 'h1';
		$title = esc_html( wp_strip_all_tags( get_the_title() ) );
		return '<' . $tag . ' class="nx-h">'
			. ( self::v( $s, 'link', false ) ? '<a href="' . esc_url( get_permalink() ) . '">' . $title . '</a>' : $title )
			. '</' . $tag . '>';
	}

	private static function w_post_content( array $s, $id, $post_id ) {
		$pid = get_the_ID();
		if ( ! $pid ) {
			return '';
		}
		if ( in_array( $pid, Frontend::current_stack(), true ) ) {
			return '';
		}
		$content = get_the_content( null, false, $pid );
		return '<div class="nx-post-content entry-content">' . apply_filters( 'the_content', $content ) . '</div>'; // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- reviewed.
	}

	private static function w_post_excerpt( array $s ) {
		return '<p class="nx-excerpt">' . esc_html( wp_trim_words( get_the_excerpt(), (int) self::v( $s, 'len', 40 ) ) ) . '</p>';
	}

	private static function w_featured_image( array $s ) {
		$tid = get_post_thumbnail_id();
		if ( ! $tid ) {
			$fb = $s['fallback'] ?? null;
			return ! empty( $fb['url'] ) ? '<figure class="nx-fi"><img src="' . esc_url( $fb['url'] ) . '" alt=""></figure>' : '';
		}
		$cap = self::v( $s, 'caption', false ) ? wp_get_attachment_caption( $tid ) : '';
		return '<figure class="nx-fi">' . wp_get_attachment_image( $tid, sanitize_key( self::v( $s, 'size', 'large' ) ), false, array(
			'loading'       => 'eager',
			'fetchpriority' => 'high',
		) ) . ( $cap ? '<figcaption>' . esc_html( $cap ) . '</figcaption>' : '' ) . '</figure>';
	}

	private static function w_post_meta( array $s ) {
		$items = (array) self::v( $s, 'items', array( 'author', 'date', 'cats', 'read' ) );
		$ic    = self::v( $s, 'icons', false );
		$out   = array();
		foreach ( $items as $k ) {
			switch ( $k ) {
				case 'avatar':
					$out[] = get_avatar( get_the_author_meta( 'ID' ), 28 );
					break;
				case 'author':
					$out[] = ( $ic ? self::icon( 'user' ) : '' ) . '<a href="'
						. esc_url( get_author_posts_url( get_the_author_meta( 'ID' ) ) ) . '">'
						. esc_html( get_the_author() ) . '</a>';
					break;
				case 'date':
					$out[] = ( $ic ? self::icon( 'calendar' ) : '' ) . '<time datetime="' . esc_attr( get_the_date( 'c' ) ) . '">' . esc_html( get_the_date() ) . '</time>';
					break;
				case 'modified':
					/* translators: %s: date */
					$out[] = ( $ic ? self::icon( 'clock' ) : '' ) . esc_html( sprintf( __( 'Updated %s', 'akram' ), get_the_modified_date() ) );
					break;
				case 'cats':
					$c = get_the_category_list( ', ' );
					if ( $c ) {
						$out[] = ( $ic ? self::icon( 'folder' ) : '' ) . wp_kses_post( $c );
					}
					break;
				case 'tags':
					$t = get_the_tag_list( '', ', ' );
					if ( $t && ! is_wp_error( $t ) ) {
						$out[] = ( $ic ? self::icon( 'tag' ) : '' ) . wp_kses_post( $t );
					}
					break;
				case 'comments':
					$out[] = ( $ic ? self::icon( 'comment' ) : '' )
						. esc_html( sprintf( /* translators: %d: comment count */ _n( '%d comment', '%d comments', get_comments_number(), 'akram' ), get_comments_number() ) );
					break;
				case 'read':
					$out[] = ( $ic ? self::icon( 'clock' ) : '' ) . esc_html( Dynamic::value( 'reading_time', array() ) );
					break;
			}
		}
		return '<div class="nx-pmeta">'
			. implode( '<span aria-hidden="true">' . esc_html( self::v( $s, 'sep', '·' ) ) . '</span>', array_map( static function ( $x ) {
			return '<span>' . $x . '</span>';
		}, $out ) ) . '</div>';
	}

	private static function w_author_box( array $s ) {
		$a = (int) get_post_field( 'post_author', get_the_ID() );
		if ( ! $a ) {
			return '';
		}
		$name = esc_html( get_the_author_meta( 'display_name', $a ) );
		if ( self::v( $s, 'link', true ) ) {
			$name = '<a href="' . esc_url( get_author_posts_url( $a ) ) . '">' . $name . '</a>';
		}
		return '<div class="nx-author l-' . esc_attr( self::v( $s, 'layout', 'row' ) ) . '">'
			. ( self::v( $s, 'avatar', true ) ? get_avatar( $a, 144 ) : '' ) . '<div><h4>' . $name . '</h4>'
			. ( self::v( $s, 'bio', true ) ? '<p>' . esc_html( get_the_author_meta( 'description', $a ) ) . '</p>' : '' )
			. '</div></div>';
	}

	private static function w_post_nav( array $s ) {
		$same = (bool) self::v( $s, 'sameTerm', false );
		$prev = get_previous_post( $same );
		$next = get_next_post( $same );
		$mk   = static function ( $p, $label, $cls ) use ( $s ) {
			if ( ! $p ) {
				return '';
			}
			$thumb = self::v( $s, 'thumbs', false ) ? get_the_post_thumbnail( $p, 'thumbnail' ) : '';
			$text  = ( self::v( $s, 'labels', true ) ? '<small>' . esc_html( $label ) . '</small>' : '' )
				. ( self::v( $s, 'titles', true ) ? '<b>' . esc_html( get_the_title( $p ) ) . '</b>' : '' );
			return '<a class="' . $cls . '" href="' . esc_url( get_permalink( $p ) ) . '" rel="'
				. ( 'is-prev' === $cls ? 'prev' : 'next' ) . '">'
				. ( 'is-prev' === $cls ? $thumb . '<span>' . $text . '</span>' : '<span>' . $text . '</span>' . $thumb )
				. '</a>';
		};
		return '<nav class="nx-pnav" aria-label="' . esc_attr__( 'Post navigation', 'akram' ) . '">'
			. $mk( $prev, __( 'Previous', 'akram' ), 'is-prev' )
			. $mk( $next, __( 'Next', 'akram' ), 'is-next' ) . '</nav>';
	}

	private static function w_comments( array $s, $id, $post_id, $preview ) {
		if ( $preview ) {
			return '<div class="nx-placeholder"><b>' . esc_html__( 'Comments', 'akram' ) . '</b><span>'
				. esc_html__( 'The comment list and form render on the live page.', 'akram' )
				. '</span></div>';
		}
		if ( ! comments_open() && ! get_comments_number() ) {
			return '';
		}
		ob_start();
		comments_template();
		return ob_get_clean();
	}

	private static function w_archive_title( array $s ) {
		$tag = in_array( self::v( $s, 'tag', 'h1' ), array( 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'p', 'div', 'span' ), true ) ? self::v( $s, 'tag', 'h1' ) : 'h1';
		if ( ! self::v( $s, 'prefix', false ) ) {
			add_filter( 'get_the_archive_title_prefix', '__return_empty_string', 99 );
		}
		$title = is_search() ? sprintf( /* translators: %s: query */ __( 'Results for “%s”', 'akram' ), get_search_query() ) : ( is_home() ? get_the_title( (int) get_option( 'page_for_posts' ) ) : get_the_archive_title() );
		remove_filter( 'get_the_archive_title_prefix', '__return_empty_string', 99 );
		return '<' . $tag . ' class="nx-h">' . wp_kses_post( $title ?: __( 'Blog', 'akram' ) ) . '</' . $tag . '>';
	}

	private static function w_archive_desc() {
		return '<div class="nx-archive-desc">' . wp_kses_post( get_the_archive_description() ) . '</div>';
	}

	private static function w_terms( array $s ) {
		$tax   = sanitize_key( self::v( $s, 'tax', 'category' ) );
		$terms = get_the_terms( get_the_ID(), $tax );
		if ( ! $terms || is_wp_error( $terms ) ) {
			return '';
		}
		$links = array_map( static function ( $t ) {
			return '<a href="' . esc_url( get_term_link( $t ) ) . '" rel="tag">' . esc_html( $t->name ) . '</a>';
		}, $terms );
		return '<div class="nx-terms s-' . esc_attr( self::v( $s, 'style', 'pills' ) ) . '">'
			. implode( 'text' === self::v( $s, 'style', 'pills' ) ? ', ' : '', $links ) . '</div>';
	}

	// ------------------------------------------------------------------
	// WooCommerce
	// ------------------------------------------------------------------
	private static function product() {
		if ( ! function_exists( 'wc_get_product' ) ) {
			return null;
		}
		global $product;
		$p = wc_get_product( get_the_ID() );
		if ( $p ) {
			$product = $p; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited, WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound -- WooCommerce's own global product, needed by its template functions.
		}
		return $p;
	}

	private static function w_products( array $s, $id, $post_id, $preview = false, $page = null, $term = '' ) {
		if ( ! function_exists( 'wc_get_product' ) ) {
			return $preview ? '<div class="nx-placeholder">' . esc_html__( 'WooCommerce is not active.', 'akram' ) . '</div>' : '';
		}
		$page  = $page ?: max( 1, isset( $_GET['nxp'] ) ? (int) $_GET['nxp'] : 1 ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only request value; it changes nothing and is sanitised.
		$count = max( 1, (int) self::v( $s, 'count', 8 ) );
		$args  = array(
			'post_type'      => 'product',
			'post_status'    => 'publish',
			'posts_per_page' => $count,
			'paged'          => $page,
		);
		$ob    = self::v( $s, 'orderby', 'date' );
		$order = 'ASC' === self::v( $s, 'order', 'DESC' ) ? 'ASC' : 'DESC';
		$ordering = WC()->query->get_catalog_ordering_args( 'popularity' === $ob ? 'popularity' : ( 'rating' === $ob ? 'rating' : ( 'price' === $ob ? 'price' : $ob ) ), $order );
		$args  = array_merge( $args, array(
			'orderby' => $ordering['orderby'],
			'order'   => $ordering['order'],
		) );
		if ( ! empty( $ordering['meta_key'] ) ) {
			$args['meta_key'] = $ordering['meta_key']; // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- bounded query on a builder meta key.
		}
		$tax  = array( 'relation' => 'AND' );
		$meta = array();
		switch ( self::v( $s, 'query', 'recent' ) ) {
			case 'featured':
				$tax[] = array(
					'taxonomy' => 'product_visibility',
					'field'    => 'name',
					'terms'    => 'featured',
				);
				break;
			case 'sale':
				$args['post__in'] = array_merge( array( 0 ), wc_get_product_ids_on_sale() );
				break;
			case 'best':
				$args['meta_key'] = 'total_sales'; // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- bounded query on a builder meta key.
				$args['orderby']  = 'meta_value_num';
				break;
			case 'rated':
				$args['meta_key'] = '_wc_average_rating'; // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- bounded query on a builder meta key.
				$args['orderby']  = 'meta_value_num';
				break;
			case 'related':
				$args['post__in'] = array_merge( array( 0 ), wc_get_related_products( get_the_ID(), $count ) );
				break;
			case 'upsell':
				$p                = self::product();
				$args['post__in'] = array_merge( array( 0 ), $p ? $p->get_upsell_ids() : array() );
				break;
			case 'cross':
				$args['post__in'] = array_merge( array( 0 ), WC()->cart ? WC()->cart->get_cross_sells() : array() );
				break;
			case 'manual':
				$args['post__in'] = array_merge( array( 0 ), array_map( 'absint', explode( ',', (string) self::v( $s, 'ids', '' ) ) ) );
				$args['orderby']  = 'post__in';
				break;
			case 'current':
				global $wp_query;
				foreach ( array( 'product_cat', 'product_tag', 's' ) as $k ) {
					if ( ! empty( $wp_query->query[ $k ] ) ) {
						$args[ $k ] = sanitize_text_field( $wp_query->query[ $k ] );
					}
				}
				break;
		}
		$cats = array_filter( array_map( 'trim', explode( ',', (string) self::v( $s, 'cats', '' ) ) ) );
		if ( $cats ) {
			$tax[] = array(
				'taxonomy' => 'product_cat',
				'field'    => 'slug',
				'terms'    => $cats,
			);
		}
		if ( ! in_array( self::v( $s, 'query', 'recent' ), array( 'related', 'upsell', 'cross', 'manual' ), true ) && ! self::v( $s, 'ignoreFilters', false ) ) {
			self::apply_product_filters( $args, $tax, $meta );
		}
		if ( $term ) {
			$tax[] = array(
				'taxonomy' => 'product_cat',
				'terms'    => array( (int) $term ),
			);
		}
		if ( self::v( $s, 'hideOos', false ) ) {
			$tax[] = array(
				'taxonomy' => 'product_visibility',
				'field'    => 'name',
				'terms'    => 'outofstock',
				'operator' => 'NOT IN',
			);
		}
		$tax[] = array(
			'taxonomy' => 'product_visibility',
			'field'    => 'name',
			'terms'    => array( 'exclude-from-catalog' ),
			'operator' => 'NOT IN',
		);
		$args['tax_query'] = $tax; // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_tax_query -- bounded query on a builder meta key.
		$q     = new \WP_Query( $args );
		$show  = (array) self::v( $s, 'show', array( 'cat', 'rating', 'price', 'atc', 'sale' ) );
		$items = '';
		while ( $q->have_posts() ) {
			$q->the_post();
			$p = wc_get_product( get_the_ID() );
			if ( ! $p ) {
				continue;
			}
			$GLOBALS['product'] = $p; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited, WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound -- WooCommerce's own global product, needed by its template functions.
			$img  = $p->get_image( 'woocommerce_thumbnail', array( 'loading' => 'lazy' ) );
			$gal  = $p->get_gallery_image_ids();
			$alt  = self::v( $s, 'swap', true ) && $gal ? wp_get_attachment_image( $gal[0], 'woocommerce_thumbnail', false, array(
				'class'   => 'is-alt',
				'loading' => 'lazy',
				'alt'     => '',
			) ) : '';
			$sale = in_array( 'sale', $show, true ) && $p->is_on_sale() ? '<span class="nx-prod-sale">'
				. esc_html( Dynamic::value( 'woo_sale_badge', array() ) ?: __( 'Sale', 'akram' ) )
				. '</span>' : '';
			$cat  = '';
			if ( in_array( 'cat', $show, true ) ) {
				$terms = get_the_terms( $p->get_id(), 'product_cat' );
				$cat   = $terms && ! is_wp_error( $terms ) ? '<span class="nx-prod-cat">' . esc_html( $terms[0]->name ) . '</span>' : '';
			}
			$atc = '';
			if ( in_array( 'atc', $show, true ) ) {
				ob_start();
				woocommerce_template_loop_add_to_cart();
				$atc = '<div class="nx-prod-atc">' . ob_get_clean() . '</div>';
			}
			$acts = '';
			foreach ( array(
				'wish'    => array( 'heart', __( 'Add to wishlist', 'akram' ) ),
				'quick'   => array( 'eye', __( 'Quick view', 'akram' ) ),
				'compare' => array( 'compare', __( 'Compare', 'akram' ) ),
			) as $k => $a ) {
				if ( in_array( $k, $show, true ) ) {
					$acts .= '<button type="button" class="nx-pa nx-pa-' . $k . '" data-nx-' . $k . '="'
						. (int) $p->get_id() . '" aria-label="' . esc_attr( $a[1] )
						. '" aria-pressed="false">' . self::icon( $a[0] ) . '</button>';
				}
			}
			if ( $acts ) {
				Frontend::add_module( 'shop' );
				$acts = '<div class="nx-prod-acts">' . $acts . '</div>';
			}
			$items .= '<li class="nx-prod"' . ( $acts ? ' data-pid="' . (int) $p->get_id() . '"' : '' )
				. '>' . $acts . '<a class="nx-prod-img" href="' . esc_url( $p->get_permalink() ) . '">'
				. $sale . $img . $alt . '</a>' . $cat . '<h3 class="nx-prod-t"><a href="'
				. esc_url( $p->get_permalink() ) . '">' . esc_html( $p->get_name() ) . '</a></h3>'
				. ( in_array( 'rating', $show, true ) ? wc_get_rating_html( (float) $p->get_average_rating() ) : '' )
				. ( in_array( 'price', $show, true ) ? '<span class="price">' . $p->get_price_html() . '</span>' : '' ) . $atc . '</li>';
		}
		wp_reset_postdata();
		if ( ! $items ) {
			return $preview ? '<div class="nx-placeholder">' . esc_html__( 'No products match this query yet.', 'akram' ) . '</div>' : '';
		}
		$sorting = '';
		if ( self::v( $s, 'sorting', false ) && ! $preview ) {
			ob_start();
			woocommerce_result_count();
			woocommerce_catalog_ordering();
			$sorting = '<div class="nx-prods-bar" style="display:flex;justify-content:space-between;align-items:center;margin-bottom:20px">' . ob_get_clean() . '</div>';
		}
		$pager = self::pager( $q, self::v( $s, 'pager', 'none' ), $page, $s );
		self::$parts = array(
			'items' => $items,
			'max'   => (int) $q->max_num_pages,
			'pager' => $pager,
		);
		$data  = array(
			'post'  => (int) $post_id,
			'el'    => $id,
			'pager' => self::v( $s, 'pager', 'none' ),
			'max'   => (int) $q->max_num_pages,
			'page'  => $page,
		);
		return '<div class="nx-woo nx-prods" data-nx-loop="' . esc_attr( wp_json_encode( $data ) ) . '">'
			. $sorting . '<ul class="nx-prods-g">' . $items . '</ul>' . $pager . '</div>';
	}

	private static function w_product_related( array $s, $id, $post_id, $preview ) {
		$s['query'] = 'related';
		return self::w_products( $s, $id, $post_id, $preview );
	}

	private static function w_product_categories( array $s ) {
		$parent = self::v( $s, 'parent', 'top' );
		$args   = array(
			'taxonomy'   => 'product_cat',
			'hide_empty' => (bool) self::v( $s, 'hideEmpty', true ),
			'number'     => (int) self::v( $s, 'count', 8 ),
		);
		if ( 'top' === $parent ) {
			$args['parent'] = 0;
		} elseif ( 'current' === $parent && is_tax( 'product_cat' ) ) {
			$args['parent'] = get_queried_object_id();
		}
		$terms = get_terms( $args );
		if ( ! $terms || is_wp_error( $terms ) ) {
			return '';
		}
		$out = '<div class="nx-woo nx-pcats">';
		foreach ( $terms as $t ) {
			if ( 'uncategorized' === $t->slug ) {
				continue;
			}
			$thumb = (int) get_term_meta( $t->term_id, 'thumbnail_id', true );
			$out .= '<a class="nx-pcat" href="' . esc_url( get_term_link( $t ) ) . '">'
				. ( $thumb ? wp_get_attachment_image( $thumb, 'woocommerce_thumbnail', false, array( 'loading' => 'lazy' ) ) : '' )
				. '<span>' . esc_html( $t->name )
				. ( self::v( $s, 'showCount', true ) ? '<small>' . esc_html( sprintf( /* translators: %d: number of products */ _n( '%d product', '%d products', $t->count, 'akram' ), $t->count ) ) . '</small>' : '' )
				. '</span></a>';
		}
		return $out . '</div>';
	}

	/** Output of a WooCommerce product part; $cb is a closure from the widget renderers below. */
	private static function woo_part( \Closure $cb ) {
		$p = self::product();
		if ( ! $p ) {
			return '';
		}
		ob_start();
		$cb( $p );
		return '<div class="nx-woo">' . ob_get_clean() . '</div>';
	}

	private static function w_product_title( array $s ) {
		$p   = self::product();
		$tag = in_array( self::v( $s, 'tag', 'h1' ), array( 'h1', 'h2', 'h3', 'div' ), true ) ? self::v( $s, 'tag', 'h1' ) : 'h1';
		return $p ? '<' . $tag . ' class="nx-h product_title">' . esc_html( $p->get_name() ) . '</' . $tag . '>' : '';
	}
	private static function w_product_price() {
		return self::woo_part( static function ( $p ) {
			echo '<p class="price">' . wp_kses_post( $p->get_price_html() ) . '</p>';
		} );
	}
	private static function w_product_atc( array $s ) {
		$pid = (int) self::v( $s, 'product', 0 );
		if ( $pid && function_exists( 'wc_get_product' ) ) {
			$p = wc_get_product( $pid );
			if ( ! $p ) {
				return '';
			}
			$text = self::v( $s, 'text', '' ) ?: $p->add_to_cart_text();
			return '<div class="nx-woo nx-woo-atc"><a href="' . esc_url( $p->add_to_cart_url() )
				. '" data-quantity="1" data-product_id="' . (int) $pid
				. '" class="button add_to_cart_button ajax_add_to_cart" rel="nofollow">' . esc_html( $text )
				. '</a></div>';
		}
		return self::woo_part( static function () {
			echo '<div class="nx-woo-atc">';
			woocommerce_template_single_add_to_cart();
			echo '</div>';
		} );
	}
	private static function w_product_gallery() {
		return self::woo_part( static function () {
			wp_enqueue_script( 'wc-single-product' );
			woocommerce_show_product_images();
		} );
	}
	private static function w_product_rating( array $s ) {
		return self::woo_part( static function ( $p ) use ( $s ) {
			echo wp_kses_post( wc_get_rating_html( (float) $p->get_average_rating(), $p->get_rating_count() ) );
			if ( self::v( $s, 'count', true ) && $p->get_review_count() ) {
				echo ' <a href="#reviews" class="woocommerce-review-link">'
					. esc_html( sprintf( /* translators: %d: reviews */ _n( '(%d review)', '(%d reviews)', $p->get_review_count(), 'akram' ), $p->get_review_count() ) )
					. '</a>';
			}
		} );
	}
	private static function w_product_stock() {
		return self::woo_part( static function ( $p ) {
			echo wp_kses_post( wc_get_stock_html( $p ) ?: '<p class="stock in-stock">' . esc_html__( 'In stock', 'akram' ) . '</p>' );
		} );
	}
	private static function w_product_meta( array $s ) {
		return self::woo_part( static function ( $p ) use ( $s ) {
			$items = (array) self::v( $s, 'items', array( 'sku', 'cats', 'tags' ) );
			echo '<div class="product_meta">';
			if ( in_array( 'sku', $items, true ) && $p->get_sku() ) {
				echo '<span class="sku_wrapper">' . esc_html__( 'SKU:', 'akram' ) . ' <span class="sku">' . esc_html( $p->get_sku() ) . '</span></span> ';
			}
			if ( in_array( 'cats', $items, true ) ) {
				echo wp_kses_post( wc_get_product_category_list( $p->get_id(), ', ', '<span class="posted_in">' . esc_html__( 'Category:', 'akram' ) . ' ', '</span> ' ) );
			}
			if ( in_array( 'tags', $items, true ) ) {
				echo wp_kses_post( wc_get_product_tag_list( $p->get_id(), ', ', '<span class="tagged_as">' . esc_html__( 'Tags:', 'akram' ) . ' ', '</span>' ) );
			}
			echo '</div>';
		} );
	}
	private static function w_product_short() {
		return self::woo_part( static function ( $p ) {
			echo '<div class="woocommerce-product-details__short-description">' . wp_kses_post( apply_filters( 'woocommerce_short_description', $p->get_short_description() ) ) . '</div>'; // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- core or third-party hook.
		} );
	}
	private static function w_product_tabs() {
		return self::woo_part( static function () {
			woocommerce_output_product_data_tabs();
		} );
	}
	private static function w_cart_icon( array $s ) {
		if ( ! function_exists( 'WC' ) || ! WC()->cart ) {
			return '<a class="nx-cart-ic" href="#">' . self::icon( 'cart' ) . '<span class="nx-cart-n">0</span></a>';
		}
		$n = WC()->cart->get_cart_contents_count();
		return '<a class="nx-cart-ic nx-woo" href="' . esc_url( wc_get_cart_url() ) . '" aria-label="'
			. esc_attr__( 'Cart', 'akram' ) . '">' . self::icon( 'cart' ) . '<span class="nx-cart-n"'
			. ( ! $n && self::v( $s, 'hideEmpty', false ) ? ' hidden' : '' ) . '>' . (int) $n . '</span>'
			. ( self::v( $s, 'total', true ) ? '<span class="nx-cart-total">' . wp_kses_post( WC()->cart->get_cart_total() ) . '</span>' : '' )
			. '</a>';
	}
	private static function w_wc_page( array $s, $id, $post_id, $preview ) {
		$map = array(
			'cart'     => 'woocommerce_cart',
			'checkout' => 'woocommerce_checkout',
			'account'  => 'woocommerce_my_account',
			'tracking' => 'woocommerce_order_tracking',
		);
		$sc  = $map[ self::v( $s, 'page', 'cart' ) ] ?? 'woocommerce_cart';
		if ( $preview && 'woocommerce_checkout' === $sc ) {
			return '<div class="nx-placeholder"><b>' . esc_html__( 'Checkout', 'akram' ) . '</b><span>'
				. esc_html__( 'The checkout form renders on the live page.', 'akram' ) . '</span></div>';
		}
		return '<div class="nx-woo woocommerce">' . do_shortcode( '[' . $sc . ']' ) . '</div>';
	}
	/** Apply Product Filter widget parameters (same names WooCommerce uses) to a product query. */
	private static function apply_product_filters( array &$args, array &$tax, array &$meta ) {
		// phpcs:disable WordPress.Security.NonceVerification.Recommended
		if ( ! empty( $_GET['product_cat'] ) ) {
			$tax[] = array(
				'taxonomy' => 'product_cat',
				'field'    => 'slug',
				'terms'    => array_map( 'sanitize_title', explode( ',', sanitize_text_field( wp_unslash( $_GET['product_cat'] ) ) ) ),
			);
		}
		foreach ( $_GET as $key => $val ) {
			if ( 0 !== strpos( (string) $key, 'filter_' ) || ! is_string( $val ) || '' === $val ) {
				continue;
			}
			$taxonomy = 'pa_' . sanitize_title( substr( $key, 7 ) );
			if ( taxonomy_exists( $taxonomy ) ) {
				$tax[] = array(
					'taxonomy' => $taxonomy,
					'field'    => 'slug',
					'terms'    => array_map( 'sanitize_title', explode( ',', sanitize_text_field( wp_unslash( $val ) ) ) ),
					'operator' => 'IN',
				);
			}
		}
		$min = isset( $_GET['min_price'] ) && '' !== $_GET['min_price'] ? (float) $_GET['min_price'] : null;
		$max = isset( $_GET['max_price'] ) && '' !== $_GET['max_price'] ? (float) $_GET['max_price'] : null;
		if ( null !== $min || null !== $max ) {
			$meta[] = array(
				'key'     => '_price',
				'value'   => array( null === $min ? 0 : $min, null === $max ? PHP_INT_MAX : $max ),
				'compare' => 'BETWEEN',
				'type'    => 'DECIMAL(10,2)',
			);
			$args['meta_query'] = array_merge( (array) ( $args['meta_query'] ?? array() ), $meta ); // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_query -- bounded query on a builder meta key.
		}
		if ( ! empty( $_GET['rating_filter'] ) ) {
			$ratings = array_filter( array_map( 'absint', explode( ',', sanitize_text_field( wp_unslash( $_GET['rating_filter'] ) ) ) ) );
			if ( $ratings ) {
				$tax[] = array(
					'taxonomy' => 'product_visibility',
					'field'    => 'name',
					'terms'    => array_map( static function ( $r ) { return 'rated-' . min( 5, $r ); }, $ratings ),
				);
			}
		}
		if ( ! empty( $_GET['nx_sale'] ) ) {
			$args['post__in'] = array_merge( array( 0 ), isset( $args['post__in'] ) ? array_intersect( $args['post__in'], wc_get_product_ids_on_sale() ) : wc_get_product_ids_on_sale() );
		}
		if ( ! empty( $_GET['nx_stock'] ) ) {
			$tax[] = array(
				'taxonomy' => 'product_visibility',
				'field'    => 'name',
				'terms'    => 'outofstock',
				'operator' => 'NOT IN',
			);
		}
		if ( ! empty( $_GET['orderby'] ) && in_array( $_GET['orderby'], array( 'price', 'price-desc', 'popularity', 'rating', 'date' ), true ) ) {
			$ob       = sanitize_key( $_GET['orderby'] );
			$ordering = WC()->query->get_catalog_ordering_args( 'price-desc' === $ob ? 'price' : $ob, 'price-desc' === $ob ? 'DESC' : ( 'price' === $ob ? 'ASC' : 'DESC' ) );
			$args     = array_merge( $args, array(
				'orderby' => $ordering['orderby'],
				'order'   => $ordering['order'],
			) );
			if ( ! empty( $ordering['meta_key'] ) ) {
				$args['meta_key'] = $ordering['meta_key']; // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- bounded query on a builder meta key.
			}
		}
		// phpcs:enable
	}

	private static function w_product_filter( array $s, $id, $post_id, $preview ) {
		if ( ! function_exists( 'wc_get_product' ) ) {
			return $preview ? '<div class="nx-placeholder">' . esc_html__( 'WooCommerce is not active.', 'akram' ) . '</div>' : '';
		}
		// phpcs:disable WordPress.Security.NonceVerification.Recommended
		$get    = static function ( $k ) {
			return isset( $_GET[ $k ] ) ? sanitize_text_field( wp_unslash( $_GET[ $k ] ) ) : '';
		};
		$parts  = (array) self::v( $s, 'parts', array( 'cats', 'price', 'attrs', 'rating', 'sale', 'stock', 'sort' ) );
		$open   = self::v( $s, 'collapsed', false ) ? '' : ' open';
		$groups = '';
		if ( in_array( 'cats', $parts, true ) ) {
			$sel   = array_filter( explode( ',', $get( 'product_cat' ) ) );
			$terms = get_terms( array(
				'taxonomy'   => 'product_cat',
				'hide_empty' => true,
				'number'     => 40,
			) );
			$list  = '';
			foreach ( is_array( $terms ) ? $terms : array() as $t ) {
				if ( 'uncategorized' === $t->slug ) {
					continue;
				}
				$list .= '<label class="nx-pf-o"><input type="checkbox" data-k="product_cat" value="'
					. esc_attr( $t->slug ) . '"' . checked( in_array( $t->slug, $sel, true ), true, false )
					. '><span>' . esc_html( $t->name ) . '</span><small>' . (int) $t->count
					. '</small></label>';
			}
			if ( $list ) {
				$groups .= '<details class="nx-pf-g"' . $open . '><summary>'
					. esc_html__( 'Categories', 'akram' ) . self::icon( 'chevron' )
					. '</summary><div class="nx-pf-l">' . $list . '</div></details>';
			}
		}
		if ( in_array( 'price', $parts, true ) ) {
			global $wpdb;
			// The store's price range in one query (no WordPress API aggregates meta); it takes no user input.
			// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
			$range = $wpdb->get_row(
				"SELECT MIN(CAST(meta_value AS DECIMAL(10,2))) AS lo, MAX(CAST(meta_value AS DECIMAL(10,2))) AS hi
				FROM {$wpdb->postmeta} WHERE meta_key = '_price' AND meta_value <> ''"
			);
			$lo    = $range ? floor( (float) $range->lo ) : 0;
			$hi    = $range ? ceil( (float) $range->hi ) : 1000;
			$cur   = get_woocommerce_currency_symbol();
			$groups .= '<details class="nx-pf-g"' . $open . '><summary>' . esc_html__( 'Price', 'akram' )
				. self::icon( 'chevron' ) . '</summary><div class="nx-pf-price" data-lo="' . esc_attr( $lo )
				. '" data-hi="' . esc_attr( $hi ) . '"><div class="nx-pf-range"><input type="range" min="'
				. esc_attr( $lo ) . '" max="' . esc_attr( $hi ) . '" value="'
				. esc_attr( '' !== $get( 'min_price' ) ? $get( 'min_price' ) : $lo )
				. '" data-r="min" aria-label="' . esc_attr__( 'Minimum price', 'akram' )
				. '"><input type="range" min="' . esc_attr( $lo ) . '" max="' . esc_attr( $hi ) . '" value="'
				. esc_attr( '' !== $get( 'max_price' ) ? $get( 'max_price' ) : $hi )
				. '" data-r="max" aria-label="' . esc_attr__( 'Maximum price', 'akram' )
				. '"></div><div class="nx-pf-pv"><label>' . esc_html( $cur )
				. '<input type="number" data-k="min_price" min="0" placeholder="' . esc_attr( $lo )
				. '" value="' . esc_attr( $get( 'min_price' ) ) . '"></label><span>–</span><label>'
				. esc_html( $cur ) . '<input type="number" data-k="max_price" min="0" placeholder="'
				. esc_attr( $hi ) . '" value="' . esc_attr( $get( 'max_price' ) )
				. '"></label></div></div></details>';
		}
		if ( in_array( 'attrs', $parts, true ) && function_exists( 'wc_get_attribute_taxonomies' ) ) {
			foreach ( wc_get_attribute_taxonomies() as $a ) {
				$tx    = wc_attribute_taxonomy_name( $a->attribute_name );
				$terms = get_terms( array(
					'taxonomy'   => $tx,
					'hide_empty' => true,
				) );
				if ( ! $terms || is_wp_error( $terms ) ) {
					continue;
				}
				$key   = 'filter_' . $a->attribute_name;
				$sel   = array_filter( explode( ',', $get( $key ) ) );
				$color = in_array( strtolower( $a->attribute_name ), array( 'color', 'colour' ), true );
				$list  = '';
				foreach ( $terms as $t ) {
					$sw    = $color ? '<i class="nx-pf-sw" style="background:'
						. esc_attr( sanitize_hex_color( (string) get_term_meta( $t->term_id, 'color', true ) ) ?: $t->slug )
						. '"></i>' : '';
					$list .= '<label class="nx-pf-o' . ( $color ? ' is-sw' : ' is-chip' )
						. '"><input type="checkbox" data-k="' . esc_attr( $key ) . '" value="'
						. esc_attr( $t->slug ) . '"'
						. checked( in_array( $t->slug, $sel, true ), true, false ) . '>' . $sw . '<span>'
						. esc_html( $t->name ) . '</span></label>';
				}
				$groups .= '<details class="nx-pf-g"' . $open . '><summary>'
					. esc_html( $a->attribute_label ) . self::icon( 'chevron' )
					. '</summary><div class="nx-pf-l' . ( $color ? ' is-sws' : ' is-chips' ) . '">' . $list
					. '</div></details>';
			}
		}
		if ( in_array( 'rating', $parts, true ) ) {
			$sel  = array_filter( explode( ',', $get( 'rating_filter' ) ) );
			$list = '';
			for ( $r = 5; $r >= 1; $r-- ) {
				$list .= '<label class="nx-pf-o"><input type="checkbox" data-k="rating_filter" value="'
					. $r . '"' . checked( in_array( (string) $r, $sel, true ), true, false )
					. '><span class="nx-pf-stars" aria-label="'
					. esc_attr( sprintf( /* translators: %d: stars */ __( '%d stars', 'akram' ), $r ) ) . '">'
					. str_repeat( self::icon( 'star' ), $r ) . '</span></label>';
			}
			$groups .= '<details class="nx-pf-g"' . $open . '><summary>' . esc_html__( 'Rating', 'akram' )
				. self::icon( 'chevron' ) . '</summary><div class="nx-pf-l">' . $list . '</div></details>';
		}
		$toggles = '';
		if ( in_array( 'sale', $parts, true ) ) {
			$toggles .= '<label class="nx-pf-t"><input type="checkbox" data-k="nx_sale" value="1"'
				. checked( '1', $get( 'nx_sale' ), false ) . '><span>' . esc_html__( 'On sale', 'akram' )
				. '</span></label>';
		}
		if ( in_array( 'stock', $parts, true ) ) {
			$toggles .= '<label class="nx-pf-t"><input type="checkbox" data-k="nx_stock" value="1"'
				. checked( '1', $get( 'nx_stock' ), false ) . '><span>'
				. esc_html__( 'In stock only', 'akram' ) . '</span></label>';
		}
		$sort = '';
		if ( in_array( 'sort', $parts, true ) ) {
			$opts = array(
				''           => __( 'Default sorting', 'akram' ),
				'popularity' => __( 'Popularity', 'akram' ),
				'rating'     => __( 'Average rating', 'akram' ),
				'date'       => __( 'Latest', 'akram' ),
				'price'      => __( 'Price: low to high', 'akram' ),
				'price-desc' => __( 'Price: high to low', 'akram' ),
			);
			$sort = '<select data-k="orderby" class="nx-pf-sort" aria-label="' . esc_attr__( 'Sort products', 'akram' ) . '">';
			foreach ( $opts as $k => $l ) {
				$sort .= '<option value="' . esc_attr( $k ) . '"' . selected( $k, $get( 'orderby' ), false ) . '>' . esc_html( $l ) . '</option>';
			}
			$sort .= '</select>';
		}
		// phpcs:enable
		$cfg = array(
			'ajax' => (bool) self::v( $s, 'ajax', true ),
			'auto' => (bool) self::v( $s, 'auto', true ),
		);
		return '<form class="nx-woo nx-pf l-' . esc_attr( self::v( $s, 'layout', 'sidebar' ) )
			. '" method="get" data-nx-pf="' . esc_attr( wp_json_encode( $cfg ) ) . '"><div class="nx-pf-h">'
			. self::icon( 'filter' ) . '<b>'
			. esc_html( self::v( $s, 'title', __( 'Filter products', 'akram' ) ) )
			. '</b><button type="reset" class="nx-pf-clear">' . esc_html__( 'Clear all', 'akram' )
			. '</button></div>' . $sort . $toggles . $groups
			. ( $cfg['auto'] ? '' : '<button type="submit" class="nx-pf-go">' . esc_html__( 'Apply filters', 'akram' ) . '</button>' )
			. '</form>';
	}

	private static function w_news_ticker( array $s ) {
		$items = array();
		if ( 'posts' === self::v( $s, 'source', 'posts' ) ) {
			$q = new \WP_Query( array(
				'post_type'           => post_type_exists( (string) self::v( $s, 'postType', 'post' ) ) ? self::v( $s, 'postType', 'post' ) : 'post',
				'posts_per_page'      => max( 1, min( 30, (int) self::v( $s, 'count', 8 ) ) ),
				'post_status'         => 'publish',
				'ignore_sticky_posts' => true,
				'no_found_rows'       => true,
			) );
			foreach ( $q->posts as $p ) {
				$items[] = '<a href="' . esc_url( get_permalink( $p ) ) . '">'
					. esc_html( get_the_title( $p ) ) . '</a>'
					. ( self::v( $s, 'date', true ) ? ' <time datetime="' . esc_attr( get_the_date( 'c', $p ) ) . '">' . esc_html( get_the_date( '', $p ) ) . '</time>' : '' );
			}
		} else {
			foreach ( preg_split( '/\r?\n/', (string) self::v( $s, 'lines', '' ) ) as $line ) {
				$line = trim( $line );
				if ( '' === $line ) {
					continue;
				}
				$parts   = array_map( 'trim', explode( '|', $line, 2 ) );
				$items[] = ! empty( $parts[1] ) ? '<a href="' . esc_url( $parts[1] ) . '">' . esc_html( $parts[0] ) . '</a>' : '<span>' . esc_html( $parts[0] ) . '</span>';
			}
		}
		if ( ! $items ) {
			return '';
		}
		$fx    = self::v( $s, 'fx', 'marquee' );
		$label = self::v( $s, 'label', __( 'Breaking', 'akram' ) );
		$list  = '<li>' . implode( '</li><li>', $items ) . '</li>';
		if ( 'marquee' === $fx ) {
			$track = '<div class="nx-nt-m"><ul>' . $list . '</ul><ul aria-hidden="true">' . $list . '</ul></div>';
		} else {
			Frontend::add_module( 'ticker' );
			$track = '<ul class="nx-nt-r" data-nx-ticker="' . esc_attr( wp_json_encode( array(
				'fx'    => $fx,
				'pause' => (int) self::v( $s, 'pause', 4 ),
			) ) ) . '">' . $list . '</ul>';
		}
		return '<div class="nx-nt fx-' . esc_attr( $fx ) . '">'
			. ( $label ? '<span class="nx-nt-l"><i></i>' . esc_html( $label ) . '</span>' : '' )
			. '<div class="nx-nt-w">' . $track . '</div></div>';
	}

	private static function w_sidebar( array $s ) {
		$id = sanitize_key( self::v( $s, 'area', 'sidebar-1' ) );
		if ( ! is_active_sidebar( $id ) ) {
			return '';
		}
		ob_start();
		dynamic_sidebar( $id );
		return '<div class="nx-sidebar">' . ob_get_clean() . '</div>';
	}

	private static function w_terms_list( array $s ) {
		$tax = sanitize_key( self::v( $s, 'tax', 'category' ) );
		if ( ! taxonomy_exists( $tax ) ) {
			return '';
		}
		$terms = get_terms( array(
			'taxonomy'   => $tax,
			'hide_empty' => (bool) self::v( $s, 'hideEmpty', true ),
			'number'     => max( 1, (int) self::v( $s, 'count', 20 ) ),
			'orderby'    => 'cloud' === self::v( $s, 'style', 'list' ) || 'count' === self::v( $s, 'orderby', 'name' ) ? 'count' : 'name',
			'order'      => 'count' === self::v( $s, 'orderby', 'name' ) ? 'DESC' : 'ASC',
			'parent'     => self::v( $s, 'top', false ) ? 0 : '',
		) );
		if ( ! $terms || is_wp_error( $terms ) ) {
			return '';
		}
		$style = self::v( $s, 'style', 'list' );
		$max   = max( 1, max( wp_list_pluck( $terms, 'count' ) ) );
		$cur   = is_tax() || is_category() || is_tag() ? get_queried_object_id() : 0;
		$out   = '';
		foreach ( $terms as $t ) {
			$size = 'cloud' === $style ? ' style="font-size:' . round( 0.85 + ( $t->count / $max ) * 0.9, 2 ) . 'em"' : '';
			$out .= '<li><a href="' . esc_url( get_term_link( $t ) ) . '"' . $size
				. ( $cur === $t->term_id ? ' aria-current="page"' : '' ) . '><span>' . esc_html( $t->name )
				. '</span>'
				. ( self::v( $s, 'counts', true ) && 'cloud' !== $style ? '<small>' . (int) $t->count . '</small>' : '' )
				. '</a></li>';
		}
		return '<ul class="nx-tl s-' . esc_attr( $style ) . '">' . $out . '</ul>';
	}

	private static function w_social_feed( array $s, $id, $post_id, $preview ) {
		$source = (string) self::v( $s, 'source', 'rss' );
		$items  = Feeds::items( $source, 'youtube' === $source ? self::v( $s, 'channel', '' ) : self::v( $s, 'url', '' ), (int) self::v( $s, 'count', 6 ) );
		if ( is_wp_error( $items ) ) {
			return $preview ? '<div class="nx-placeholder"><b>' . esc_html__( 'Social feed', 'akram' )
				. '</b><span>' . esc_html( $items->get_error_message() ) . '</span></div>' : '';
		}
		$show  = (array) self::v( $s, 'show', array( 'image', 'title', 'date' ) );
		$blank = self::v( $s, 'newTab', true ) ? ' target="_blank" rel="noopener"' : '';
		$out   = '';
		foreach ( $items as $it ) {
			$play  = 'youtube' === $source ? '<span class="nx-sf-play" aria-hidden="true"><svg viewBox="0 0 24 24"><path d="M8 5v14l11-7z" fill="currentColor"/></svg></span>' : '';
			$img   = in_array( 'image', $show, true ) && $it['image'] ? '<span class="nx-sf-m"><img src="'
				. esc_url( $it['image'] ) . '" alt="" loading="lazy" decoding="async">' . $play
				. '</span>' : '';
			$title = in_array( 'title', $show, true ) && $it['title'] ? '<b class="nx-sf-t">' . esc_html( $it['title'] ) . '</b>' : '';
			$text  = in_array( 'text', $show, true ) && $it['text'] ? '<span class="nx-sf-x">' . esc_html( $it['text'] ) . '</span>' : '';
			$date  = in_array( 'date', $show, true ) && $it['date'] ? '<time datetime="'
				. esc_attr( gmdate( 'c', $it['date'] ) ) . '">'
				. esc_html( date_i18n( get_option( 'date_format' ), $it['date'] ) ) . '</time>' : '';
			$out  .= '<li><a class="nx-sf-i" href="' . esc_url( $it['url'] ) . '"' . $blank . '>' . $img
				. ( $title || $text || $date ? '<span class="nx-sf-b">' . $title . $text . $date . '</span>' : '' )
				. '</a></li>';
		}
		return '<ul class="nx-sf s-' . esc_attr( $source ) . ' l-' . esc_attr( self::v( $s, 'layout', 'grid' ) ) . '">' . $out . '</ul>';
	}

	private static function w_google_reviews( array $s, $id, $post_id, $preview ) {
		$d = Feeds::google_reviews( self::v( $s, 'place', '' ) );
		if ( is_wp_error( $d ) ) {
			return $preview ? '<div class="nx-placeholder"><b>' . esc_html__( 'Google reviews', 'akram' )
				. '</b><span>' . esc_html( $d->get_error_message() ) . '</span></div>' : '';
		}
		$min   = (int) self::v( $s, 'min', 4 );
		$star  = static function ( $n ) {
			$o = '';
			for ( $i = 1; $i <= 5; $i++ ) {
				$o .= '<i class="' . ( $i <= round( $n ) ? 'is-on' : '' ) . '">★</i>';
			}
			$label = sprintf( /* translators: %s: rating */ __( '%s out of 5 stars', 'akram' ), number_format_i18n( $n, 1 ) );
			return '<span class="nx-gr-st" aria-label="' . esc_attr( $label ) . '">' . $o . '</span>';
		};
		$cards = '';
		foreach ( array_slice( $d['reviews'], 0, (int) self::v( $s, 'count', 5 ) ) as $r ) {
			if ( $r['rating'] < $min || '' === trim( $r['text'] ) ) {
				continue;
			}
			$cards .= '<figure class="nx-gr-c"><figcaption>'
				. ( $r['photo'] ? '<img src="' . esc_url( $r['photo'] ) . '" alt="" loading="lazy" width="40" height="40">' : '' )
				. '<b>' . esc_html( $r['author'] ) . '</b><small>' . esc_html( $r['time'] )
				. '</small></figcaption>' . $star( $r['rating'] ) . '<blockquote>'
				. esc_html( wp_trim_words( $r['text'], (int) self::v( $s, 'words', 45 ) ) )
				. '</blockquote></figure>';
		}
		$head = self::v( $s, 'summary', true ) ? '<div class="nx-gr-h"><b>'
			. esc_html( number_format_i18n( $d['rating'], 1 ) ) . '</b>' . $star( $d['rating'] ) . '<span>'
			. esc_html( sprintf( /* translators: %s: count */ _n( '%s review on Google', '%s reviews on Google', $d['total'], 'akram' ), number_format_i18n( $d['total'] ) ) )
			. '</span>'
			. ( $d['url'] ? '<a href="' . esc_url( $d['url'] ) . '" target="_blank" rel="noopener">' . esc_html__( 'Write a review', 'akram' ) . '</a>' : '' )
			. '</div>' : '';
		$schema = '';
		if ( self::v( $s, 'schema', false ) && $d['total'] ) {
			$schema = wp_get_inline_script_tag( wp_json_encode( array(
				'@context'        => 'https://schema.org',
				'@type'           => 'LocalBusiness',
				'name'            => $d['name'],
				'aggregateRating' => array(
					'@type'       => 'AggregateRating',
					'ratingValue' => $d['rating'],
					'reviewCount' => $d['total'],
				),
			), JSON_HEX_TAG | JSON_HEX_AMP | JSON_UNESCAPED_SLASHES ), array( 'type' => 'application/ld+json' ) );
		}
		return '<div class="nx-gr">' . $head . '<div class="nx-gr-g">' . $cards . '</div>' . $schema . '</div>';
	}

	private static function w_wc_notices() {
		if ( ! function_exists( 'wc_print_notices' ) ) {
			return '';
		}
		ob_start();
		wc_print_notices();
		return '<div class="nx-woo woocommerce-notices-wrapper">' . ob_get_clean() . '</div>';
	}
}

/**
 * Menu walker: submenu indicators and mega-menu panels.
 */
class Nav_Walker extends \Walker_Nav_Menu {
	private $indicator;
	public function __construct( $indicator = 'chevron' ) {
		$this->indicator = $indicator;
	}
	public function start_el( &$output, $item, $depth = 0, $args = null, $id = 0 ) {
		$mega = (int) get_post_meta( $item->ID, '_akram_mega', true );
		if ( $mega && 0 === $depth ) {
			$item->classes[] = 'nx-mega';
		}
		parent::start_el( $output, $item, $depth, $args, $id );
		$has = in_array( 'menu-item-has-children', (array) $item->classes, true ) || ( $mega && 0 === $depth );
		if ( $has && 'none' !== $this->indicator ) {
			$icon   = 'plus' === $this->indicator ? '<path d="M5 12h14M12 5v14"/>' : '<path d="m6 9 6 6 6-6"/>';
			$output = preg_replace( '/<\/a>$/', '<span class="nx-nav-ind" aria-hidden="true"><svg class="nx-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">' . $icon . '</svg></span></a>', $output );
		}
		if ( $mega && 0 === $depth ) {
			$output .= '<div class="nx-mega-panel">' . Runtime::template( $mega ) . '</div>';
		}
	}
}