<?php
/**
 * CP Spinners - Spinner List Definitions
 *
 * Provides the dictionary of available frontend loaders used by the admin
 * preview UI and public loading overlay.
 *
 * @package AeroSpin_CSS_Loading_Spinners
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit; // Exit if accessed directly to prevent direct file execution.
}

/*
|--------------------------------------------------------------------------
| SECTION 1: Spinner Registry Class
|--------------------------------------------------------------------------
|
| This class provides the spinner registry, normalizes filterable spinner
| data, sanitizes keys, and keeps spinner markup constrained to the narrow
| allowlist supplied by acls-helpers.php.
|
| Important:
| - This file must be saved as UTF-8 without BOM.
| - This file must not echo, print, var_dump, or close with a PHP closing tag.
| - Any unexpected output here can trigger WordPress activation/header warnings.
|
*/

if ( ! class_exists( 'AeroSpin_CSS_Loading_Spinners_List' ) ) {

	/**
	 * Static spinner registry provider.
	 *
	 * @since 1.0.0
	 */
	final class ACLS_Spinners_List {

		/**
		 * Runtime cache for normalized spinner definitions.
		 *
		 * @since 1.1.4
		 *
		 * @var array|null
		 */
		private static $spinners_cache = null;

		/**
		 * Runtime cache for categories.
		 *
		 * @since 1.0.0
		 *
		 * @var array|null
		 */
		private static $categories_cache = null;

		/**
		 * Prevent instantiation.
		 *
		 * @since 1.0.0
		 */
		private function __construct() {
			// Escaped the translation string to comply with strict PHPCS output escaping rules.
			_doing_it_wrong(
				__FUNCTION__,
				esc_html__( 'This is a static utility class and cannot be instantiated.', 'aerospin-css-loading-spinners' ),
				'1.0.0'
			);
		}

		/**
		 * Prevent cloning.
		 *
		 * @since 1.0.0
		 *
		 * @return void
		 */
		private function __clone() {
			// Escaped the translation string to comply with strict PHPCS output escaping rules.
			_doing_it_wrong(
				__FUNCTION__,
				esc_html__( 'Cloning this spinner registry is forbidden.', 'aerospin-css-loading-spinners' ),
				'1.0.0'
			);
		}

		/**
		 * Prevent unserializing.
		 *
		 * @since 1.0.0
		 *
		 * @return void
		 */
		public function __wakeup() {
			// Escaped the translation string to comply with strict PHPCS output escaping rules.
			_doing_it_wrong(
				__FUNCTION__,
				esc_html__( 'Unserializing instances of this spinner registry is forbidden.', 'aerospin-css-loading-spinners' ),
				'1.0.0'
			);
		}

		/*
		|--------------------------------------------------------------------------
		| SECTION 2: Spinner Definitions
		|--------------------------------------------------------------------------
		*/

		/**
		 * Retrieve all available spinners.
		 *
		 * Registry text values are intentionally translated with __() and
		 * escaped only when output. Spinner markup is sanitized after filters
		 * with a narrow allowlist instead of broad wp_kses_post().
		 *
		 * @since 1.0.0
		 *
		 * @return array
		 */
		public static function get_spinners() {
			// Serve from runtime cache if available to reduce overhead.
			if ( null !== self::$spinners_cache ) {
				return self::$spinners_cache;
			}

			$spinners = self::get_default_spinners();

			/**
			 * Filter registered AeroSpin CSS Loading Spinners.
			 *
			 * Add-ons may register custom spinners here. Filtered data is
			 * normalized before return, so invalid keys or unsafe markup are
			 * discarded.
			 *
			 * Updated prefix to match plugin slug for WPCS compliance.
			 *
			 * @since 1.0.0
			 *
			 * @param array $spinners Spinner definitions.
			 */
			$spinners = apply_filters( 'aerospin_css_loading_spinners_registered_spinners', $spinners );
			$spinners = apply_filters( 'pure_css_spinners_registered_spinners', $spinners );

			// Ensure third-party additions conform to expected structural limits.
			$normalized_spinners = self::normalize_spinners( $spinners );

			// Fallback to defaults if filters completely broke the registry.
			if ( empty( $normalized_spinners ) ) {
				$normalized_spinners = self::normalize_spinners( self::get_default_spinners() );
			}

			self::$spinners_cache = $normalized_spinners;

			return self::$spinners_cache;
		}

		/**
		 * Retrieve one spinner definition by key.
		 *
		 * @since 1.1.4
		 *
		 * @param mixed  $key           Spinner key.
		 * @param string $default_value Default spinner key.
		 * @return array
		 */
		public static function get_spinner( $key, $default_value = 'ring' ) {
			$spinners = self::get_spinners();

			// Sanitize input values rigorously.
			$key           = sanitize_key( self::safe_scalar( $key ) );
			$default_value = sanitize_key( self::safe_scalar( $default_value ) );

			if ( '' === $default_value ) {
				$default_value = 'ring';
			}

			if ( '' !== $key && isset( $spinners[ $key ] ) ) {
				return $spinners[ $key ];
			}

			return isset( $spinners[ $default_value ] ) ? $spinners[ $default_value ] : array();
		}

		/**
		 * Get default spinner definitions.
		 *
		 * Note: HTML classes use `acls-` with backwards-compatibility styling support,
		 * and PHP hooks and functions use the `acls_` prefix.
		 *
		 * @since 1.1.4
		 *
		 * @return array
		 */
		private static function get_default_spinners() {
			return array(
				'ring'                   => array(
					'label'       => __( 'Ring', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A clean rotating ring, the classic loading indicator.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-ring"><div></div><div></div><div></div><div></div></div>',
				),
				'dual-ring'              => array(
					'label'       => __( 'Dual Ring', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Two concentric rings rotating in opposite directions.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-dual-ring"></div>',
				),
				'circle'                 => array(
					'label'       => __( 'Circle', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A segmented circle that spins smoothly.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-circle"><div class="acls-circle1 acls-c"></div><div class="acls-circle2 acls-c"></div><div class="acls-circle3 acls-c"></div><div class="acls-circle4 acls-c"></div><div class="acls-circle5 acls-c"></div><div class="acls-circle6 acls-c"></div><div class="acls-circle7 acls-c"></div><div class="acls-circle8 acls-c"></div><div class="acls-circle9 acls-c"></div><div class="acls-circle10 acls-c"></div><div class="acls-circle11 acls-c"></div><div class="acls-circle12 acls-c"></div></div>',
				),
				'dots'                   => array(
					'label'       => __( 'Bouncing Dots', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Three dots that bounce in sequence.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Dots', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-dots"><div></div><div></div><div></div></div>',
				),
				'pulse-dots'             => array(
					'label'       => __( 'Pulse Dots', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Three dots that pulse with a wave effect.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Dots', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-pulse-dots"><span></span><span></span><span></span></div>',
				),
				'dot-spin'               => array(
					'label'       => __( 'Dot Spin', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Dots orbiting around a center point.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Dots', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-dot-spin"><div class="acls-ds-circle1 acls-ds-circle"></div><div class="acls-ds-circle2 acls-ds-circle"></div><div class="acls-ds-circle3 acls-ds-circle"></div><div class="acls-ds-circle4 acls-ds-circle"></div><div class="acls-ds-circle5 acls-ds-circle"></div><div class="acls-ds-circle6 acls-ds-circle"></div><div class="acls-ds-circle7 acls-ds-circle"></div><div class="acls-ds-circle8 acls-ds-circle"></div></div>',
				),
				'bars'                   => array(
					'label'       => __( 'Bars', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Five bars that animate in a wave pattern.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Bars', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-bars"><div></div><div></div><div></div><div></div><div></div></div>',
				),
				'equalizer'              => array(
					'label'       => __( 'Equalizer', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Bars that animate like an audio equalizer.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Bars', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-equalizer"><span></span><span></span><span></span><span></span><span></span></div>',
				),
				'ripple'                 => array(
					'label'       => __( 'Ripple', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Expanding ripple rings radiating outward.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-ripple"><div></div><div></div></div>',
				),
				'roller'                 => array(
					'label'       => __( 'Roller', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Dots rolling along a circular track.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-roller"><div></div><div></div><div></div><div></div><div></div><div></div><div></div><div></div></div>',
				),
				'hourglass'              => array(
					'label'       => __( 'Hourglass', 'aerospin-css-loading-spinners' ),
					'description' => __( 'An hourglass shape that rotates continuously.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-hourglass"></div>',
				),
				'heart'                  => array(
					'label'       => __( 'Heart', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A pulsing heart shape.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-heart"><div></div></div>',
				),
				'square-spin'            => array(
					'label'       => __( 'Square Spin', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A square that flips in 3D.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-square-spin"><div></div></div>',
				),
				'fold'                   => array(
					'label'       => __( 'Fold', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Four squares that fold in sequence.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-fold"><div class="acls-fold1 acls-f"></div><div class="acls-fold2 acls-f"></div><div class="acls-fold4 acls-f"></div><div class="acls-fold3 acls-f"></div></div>',
				),
				'wave-dots'              => array(
					'label'       => __( 'Wave Dots', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A wave of expanding dots.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Dots', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-wave-dots"><div></div><div></div><div></div><div></div><div></div></div>',
				),
				'orbit'                  => array(
					'label'       => __( 'Orbit', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A dot orbiting a central sphere.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-orbit"><div class="acls-orbit-inner"></div></div>',
				),
				'flip'                   => array(
					'label'       => __( 'Flip', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A square that flips on both axes.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-flip"></div>',
				),
				'bounce'                 => array(
					'label'       => __( 'Bounce', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Two balls that bounce and cross paths.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-bounce"><div></div><div></div></div>',
				),
				'gradient-ring'          => array(
					'label'       => __( 'Gradient Ring', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A ring with a smooth gradient sweep.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-gradient-ring"></div>',
				),
				'chase'                  => array(
					'label'       => __( 'Chase', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Dots chasing each other in a circle.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Dots', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-chase"><div class="acls-chase-dot"></div><div class="acls-chase-dot"></div><div class="acls-chase-dot"></div><div class="acls-chase-dot"></div><div class="acls-chase-dot"></div><div class="acls-chase-dot"></div></div>',
				),
				'text-blink'             => array(
					'label'       => __( 'Text: Blinking Dots', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Classic loading text with blinking ellipsis.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Text', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-text-blink">' . esc_html__( 'Loading', 'aerospin-css-loading-spinners' ) . '<span>.</span><span>.</span><span>.</span></div>',
				),
				'text-wave'              => array(
					'label'       => __( 'Text: Wave', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Individual letters jumping in a wave sequence.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Text', 'aerospin-css-loading-spinners' ),
					'html'        => self::get_text_wave_html( __( 'Loading', 'aerospin-css-loading-spinners' ) ),
				),
				'text-glow'              => array(
					'label'       => __( 'Text: Neon Glow', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Text that pulses with a bright neon outline.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Text', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-text-glow">' . esc_html__( 'Loading', 'aerospin-css-loading-spinners' ) . '</div>',
				),
				'rainbow-circle'         => array(
					'label'       => __( 'Rainbow Circle', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A spinning circle cycling through vivid colors.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Colorful', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-rainbow-circle"></div>',
				),
				'rainbow-dots'           => array(
					'label'       => __( 'Rainbow Dots', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Bouncing dots, each assigned a different vibrant color.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Colorful', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-rainbow-dots"><div></div><div></div><div></div><div></div></div>',
				),
				'rainbow-bar'            => array(
					'label'       => __( 'Rainbow Progress Bar', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A horizontal bar smoothly sweeping through the color spectrum.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Colorful', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-rainbow-bar"></div>',
				),
				'color-pulse'            => array(
					'label'       => __( 'Color Pulse', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A radiating circle that changes color on every beat.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Colorful', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-color-pulse"></div>',
				),
				'color-wheel'            => array(
					'label'       => __( 'Color Wheel', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A multicolored segmented wheel rotating.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Colorful', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-color-wheel"></div>',
				),
				'cube-grid'              => array(
					'label'       => __( 'Cube Grid', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A 3x3 grid of cubes pulsing diagonally.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-cube-grid"><div></div><div></div><div></div><div></div><div></div><div></div><div></div><div></div><div></div></div>',
				),
				'diamond-fold'           => array(
					'label'       => __( 'Diamond Fold', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Four diamonds converging and unfolding.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-diamond-fold"><div></div><div></div><div></div><div></div></div>',
				),
				'gear'                   => array(
					'label'       => __( 'Gear', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A mechanical cog slowly turning.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-gear"></div>',
				),
				'sun'                    => array(
					'label'       => __( 'Sunburst', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A central circle with rotating outer rays.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-sun"><div></div><div></div><div></div><div></div></div>',
				),
				'clock'                  => array(
					'label'       => __( 'Clock', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A clock face with rapidly spinning hour and minute hands.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-clock"></div>',
				),
				'target'                 => array(
					'label'       => __( 'Target Rings', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Concentric rings collapsing inward.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-target"><div></div><div></div><div></div></div>',
				),
				'radar'                  => array(
					'label'       => __( 'Radar Sweep', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A scanner sweeping across a circular radar.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-radar"><div></div></div>',
				),
				'wifi'                   => array(
					'label'       => __( 'Wi-Fi Signal', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Curved arcs broadcasting outward.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-wifi"><div></div><div></div><div></div></div>',
				),
				'heartbeat'              => array(
					'label'       => __( 'Heartbeat EKG', 'aerospin-css-loading-spinners' ),
					'description' => __( 'An animated EKG line drawing back and forth.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-heartbeat"></div>',
				),
				'battery'                => array(
					'label'       => __( 'Battery Charge', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A battery outline filling with energy blocks.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-battery"><div></div></div>',
				),
				'music-bars'             => array(
					'label'       => __( 'Multicolor EQ', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Audio equalizer bars that feature distinct colors.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-music-bars"><span></span><span></span><span></span><span></span></div>',
				),
				'hourglass-color'        => array(
					'label'       => __( 'Sand Timer', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A solid sand timer that drains and flips.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-hourglass-color"></div>',
				),
				'infinity'               => array(
					'label'       => __( 'Infinity Loop', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A continuous figure-eight path pulsing in smooth motion.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-infinity"><div></div><div></div></div>',
				),
				'atom'                   => array(
					'label'       => __( 'Atom', 'aerospin-css-loading-spinners' ),
					'description' => __( 'An atomic nucleus orbited by three 3D elliptical electron rings.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-atom"><div class="acls-atom-core"></div><div class="acls-atom-orbit acls-atom-orbit1"></div><div class="acls-atom-orbit acls-atom-orbit2"></div><div class="acls-atom-orbit acls-atom-orbit3"></div></div>',
				),
				'dna'                    => array(
					'label'       => __( 'DNA Helix', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Intertwined strands undulating in a double-helix wave sequence.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Dots', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-dna"><div></div><div></div><div></div><div></div><div></div><div></div></div>',
				),
				'hexagon'                => array(
					'label'       => __( 'Hexagon', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Geometric concentric hexagons pulsing and morphing inward.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-hexagon"><div></div><div></div><div></div></div>',
				),
				'gyroscope'              => array(
					'label'       => __( 'Gyroscope', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Concentric rings rotating smoothly on multi-axis gimbals.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-gyroscope"><div></div><div></div><div></div></div>',
				),
				'soundwave'              => array(
					'label'       => __( 'Soundwave', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Dynamic audio frequency bars pulsing outward in stereo symmetry.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Bars', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-soundwave"><span></span><span></span><span></span><span></span><span></span></div>',
				),
				'pulsar'                 => array(
					'label'       => __( 'Pulsar', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A luminous core projecting synchronized acoustic ripples.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-pulsar"><div class="acls-pulsar-core"></div><div class="acls-pulsar-ring"></div><div class="acls-pulsar-ring"></div></div>',
				),
				'meteor'                 => array(
					'label'       => __( 'Meteor', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A bright celestial spark orbiting with a smooth glowing trail.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-meteor"><div></div></div>',
				),
				'matrix'                 => array(
					'label'       => __( 'Digital Matrix', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Cascading cyber data blocks streaming downward in parallel.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-matrix"><div></div><div></div><div></div><div></div></div>',
				),
				'gem'                    => array(
					'label'       => __( 'Crystal Gem', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A faceted polygonal gem rotating with shimmering refractions.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-gem"><div></div><div></div></div>',
				),
				'newtons-cradle'         => array(
					'label'       => __( "Newton's Cradle", 'aerospin-css-loading-spinners' ),
					'description' => __( 'Four suspended spheres striking and transferring momentum.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-newtons-cradle"><div></div><div></div><div></div><div></div></div>',
				),
				'droplet'                => array(
					'label'       => __( 'Water Droplet', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A liquid droplet descending and generating fluid ripples.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-droplet"><div class="acls-drop"></div><div class="acls-droplet-ripple"></div></div>',
				),
				'infinity-dots'          => array(
					'label'       => __( 'Infinity Dots', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Sequential dots orbiting along a lemniscate curve.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Dots', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-infinity-dots"><div></div><div></div><div></div><div></div><div></div></div>',
				),
				'eclipse'                => array(
					'label'       => __( 'Solar Eclipse', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A dark celestial body passing across a radiant stellar corona.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-eclipse"><div class="acls-eclipse-sun"></div><div class="acls-eclipse-moon"></div></div>',
				),
				'vortex'                 => array(
					'label'       => __( 'Spiral Vortex', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Swirling logarithmic vortex rings converging inward.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-vortex"><div></div><div></div><div></div></div>',
				),
				'sonar'                  => array(
					'label'       => __( 'Sonar Ping', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Submarine acoustic sweep detecting pulsating radar blips.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-sonar"><div class="acls-sonar-ring"></div><div class="acls-sonar-sweep"></div><div class="acls-sonar-blip"></div></div>',
				),
				'prism'                  => array(
					'label'       => __( 'Prism Light', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Light refracting through a triangular prism into rainbow dispersion.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Colorful', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-prism"><div class="acls-prism-triangle"></div><div class="acls-prism-rays"></div></div>',
				),
				'hypercube'              => array(
					'label'       => __( 'Tesseract Hypercube', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A four-dimensional hypercube folding through isometric space.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-hypercube"><div class="acls-cube-outer"></div><div class="acls-cube-inner"></div></div>',
				),
				'signal-beacon'          => array(
					'label'       => __( 'Signal Beacon', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Transmission antenna broadcasting rhythmic radio waves.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-signal-beacon"><div class="acls-beacon-mast"></div><div class="acls-beacon-arc acls-arc1"></div><div class="acls-beacon-arc acls-arc2"></div><div class="acls-beacon-arc acls-arc3"></div></div>',
				),
				'sandflow'               => array(
					'label'       => __( 'Sandflow', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Hourglass chamber with a continuous stream of falling sand.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-sandflow"><div class="acls-sf-top"></div><div class="acls-sf-stream"></div><div class="acls-sf-bottom"></div></div>',
				),
				'text-typewriter'        => array(
					'label'       => __( 'Text: Typewriter', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Loading text typing out letter by letter with a flashing cursor.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Text', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-text-typewriter"><span class="acls-type-text">' . esc_html__( 'Loading', 'aerospin-css-loading-spinners' ) . '</span><span class="acls-type-cursor">_</span></div>',
				),
				'pendulum'               => array(
					'label'       => __( 'Pendulum Wave', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Harmonic pendulums oscillating smoothly in phase-delayed arc motion.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-pendulum"><div></div><div></div><div></div></div>',
				),
				'kaleidoscope'           => array(
					'label'       => __( 'Kaleidoscope', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Mandala petals shifting through kaleidoscopic color symmetry.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Colorful', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-kaleidoscope"><div></div><div></div><div></div><div></div></div>',
				),
				'neon-ring'              => array(
					'label'       => __( 'Neon Ring', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A glowing neon ring spinning with vivid hue-shifting bloom.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-neon-ring"><div></div></div>',
				),
				'crosshair'              => array(
					'label'       => __( 'Crosshair Lock', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Precision targeting reticle rotating with pulsing lock-on crosshairs.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-crosshair"><div class="acls-ch-circle"></div><div class="acls-ch-lines"></div></div>',
				),
				'glitch'                 => array(
					'label'       => __( 'Cyber Glitch', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Futuristic digital HUD box with chromatic aberration glitches.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-glitch"><div></div><div></div><div></div></div>',
				),
				'pinwheel'               => array(
					'label'       => __( 'Origami Pinwheel', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Folded paper-craft wind blades spinning in circular rotation.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-pinwheel"><div></div><div></div><div></div><div></div></div>',
				),
				'staircase'              => array(
					'label'       => __( 'Staircase Bars', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Ascending steps animating with alternating rhythmic wave scaling.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Bars', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-staircase"><span></span><span></span><span></span><span></span><span></span></div>',
				),
				'planetary'              => array(
					'label'       => __( 'Planetary Rings', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A celestial sphere encircled by tilted, sweeping orbital rings.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-planetary"><div class="acls-planet-sphere"></div><div class="acls-planet-ring"></div></div>',
				),
				'hive'                   => array(
					'label'       => __( 'Honeycomb Hive', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A cluster of seven hexagonal cells pulsing in a radial wave.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-hive"><div></div><div></div><div></div><div></div><div></div><div></div><div></div></div>',
				),
				'black-hole'             => array(
					'label'       => __( 'Black Hole', 'aerospin-css-loading-spinners' ),
					'description' => __( 'A gravitational singularity warped by a swirling accretion disk.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-black-hole"><div class="acls-bh-core"></div><div class="acls-bh-disk"></div></div>',
				),
				'yin-yang'               => array(
					'label'       => __( 'Yin Yang', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Complementary swirling forces rotating in harmonious equilibrium.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-yin-yang"><div class="acls-yy-dot1"></div><div class="acls-yy-dot2"></div></div>',
				),
				'quantum-orbit'          => array(
					'label'       => __( 'Quantum Orbit', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Three elliptical orbital rings spinning with quantum electron particles at varying inclinations.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-quantum-orbit"><div class="acls-qo-ring1"><span></span></div><div class="acls-qo-ring2"><span></span></div><div class="acls-qo-ring3"><span></span></div></div>',
				),
				'cyber-hexagon'          => array(
					'label'       => __( 'Cyber Hexagon', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Concentric rotating cyberpunk hexagon rings with glowing node accents.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-cyber-hexagon"><div class="acls-chx-outer"></div><div class="acls-chx-inner"></div><div class="acls-chx-core"></div></div>',
				),
				'galaxy-spiral'          => array(
					'label'       => __( 'Galaxy Spiral', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Two spiral arms revolving around a dense luminous galactic core.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-galaxy-spiral"><div class="acls-gal-core"></div><div class="acls-gal-arm1"></div><div class="acls-gal-arm2"></div></div>',
				),
				'portal-vortex'          => array(
					'label'       => __( 'Portal Vortex', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Multi-layered interdimensional gateway rotating with pulsating gradient horizons.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Colorful', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-portal-vortex"><div class="acls-pv-ring1"></div><div class="acls-pv-ring2"></div><div class="acls-pv-ring3"></div><div class="acls-pv-center"></div></div>',
				),
				'metronome'              => array(
					'label'       => __( 'Metronome Tick', 'aerospin-css-loading-spinners' ),
					'description' => __( 'An inverted tempo needle swinging rhythmically with pendulum weight physics.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-metronome"><div class="acls-metro-arm"><div class="acls-metro-weight"></div></div><div class="acls-metro-base"></div></div>',
				),
				'dna-cascade'            => array(
					'label'       => __( 'Chromatic Helix', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Color-shifting nucleotide rungs spiraling in an illuminated 3D ladder.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Colorful', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-dna-cascade"><span></span><span></span><span></span><span></span><span></span><span></span><span></span><span></span></div>',
				),
				'liquid-bubble'          => array(
					'label'       => __( 'Liquid Bubbles', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Organic buoyant liquid bubbles rising and coalescing in fluid suspension.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-liquid-bubble"><div class="acls-lb-drop1"></div><div class="acls-lb-drop2"></div><div class="acls-lb-drop3"></div><div class="acls-lb-drop4"></div></div>',
				),
				'origami-crane'          => array(
					'label'       => __( 'Origami Crane', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Geometric folded paper wings flapping in synchronized polyhedral origami motion.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-origami-crane"><div class="acls-oc-wing-left"></div><div class="acls-oc-body"></div><div class="acls-oc-wing-right"></div></div>',
				),
				'compass-rose'           => array(
					'label'       => __( 'Compass Rose', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Navigational mariner compass dial searching and calibrating magnetic north.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-compass-rose"><div class="acls-cr-dial"></div><div class="acls-cr-needle"></div><div class="acls-cr-pivot"></div></div>',
				),
				'hyper-tunnel'           => array(
					'label'       => __( 'Hyper Tunnel', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Consecutive geometric squares zooming infinitely towards the observer in warp speed.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-hyper-tunnel"><div></div><div></div><div></div><div></div></div>',
				),
				'sound-equalizer-radial' => array(
					'label'       => __( 'Radial Equalizer', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Circular arrangement of audio VU spectrum bars pulsing outward from the center.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Bars', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-sound-equalizer-radial"><span></span><span></span><span></span><span></span><span></span><span></span><span></span><span></span></div>',
				),
				'shuriken'               => array(
					'label'       => __( 'Ninja Shuriken', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Four-bladed curved ninja star spinning at high velocity with metallic luster.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-shuriken"><div class="acls-sh-blade1"></div><div class="acls-sh-blade2"></div><div class="acls-sh-blade3"></div><div class="acls-sh-blade4"></div><div class="acls-sh-hub"></div></div>',
				),
				'firefly-swarm'          => array(
					'label'       => __( 'Firefly Swarm', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Bioluminescent fireflies flickering and floating in randomized organic orbits.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Dots', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-firefly-swarm"><div></div><div></div><div></div><div></div><div></div></div>',
				),
				'cube-flip-3d'           => array(
					'label'       => __( 'Isometric Cube', 'aerospin-css-loading-spinners' ),
					'description' => __( '3D isometric cube rotating across isometric axes with illuminated faces.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-cube-flip-3d"><div class="acls-cf-top"></div><div class="acls-cf-left"></div><div class="acls-cf-right"></div></div>',
				),
				'solar-flare'            => array(
					'label'       => __( 'Solar Flare', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Radiant chromatic sun with corona plasma arcs expanding and dissipating.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Colorful', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-solar-flare"><div class="acls-sf-sun"></div><div class="acls-sf-flare1"></div><div class="acls-sf-flare2"></div></div>',
				),
				'biohazard'              => array(
					'label'       => __( 'Biohazard Sign', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Stylized tripartite hazard bio-rings interlocked and turning in warning sequence.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-biohazard"><div class="acls-bio-ring1"></div><div class="acls-bio-ring2"></div><div class="acls-bio-ring3"></div><div class="acls-bio-center"></div></div>',
				),
				'text-shimmer'           => array(
					'label'       => __( 'Text: Shimmer Stream', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Typography with a continuous luminous beam sweeping across the text.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Text', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-text-shimmer">' . esc_html__( 'Loading', 'aerospin-css-loading-spinners' ) . '</div>',
				),
				'text-flip'              => array(
					'label'       => __( 'Text: 3D Flip', 'aerospin-css-loading-spinners' ),
					'description' => __( '3D perspective tumbling loading text with depth and backface shadows.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Text', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-text-flip">' . esc_html__( 'Loading', 'aerospin-css-loading-spinners' ) . '</div>',
				),
				'orbiting-moons'         => array(
					'label'       => __( 'Lunar Orbiters', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Two celestial satellites circling around a planet on counter-rotating orbital planes.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-orbiting-moons"><div class="acls-om-planet"></div><div class="acls-om-track1"><div class="acls-om-moon1"></div></div><div class="acls-om-track2"><div class="acls-om-moon2"></div></div></div>',
				),
				'infinity-gear'          => array(
					'label'       => __( 'Dual Synchro Gears', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Two interlocking meshed mechanical cogs counter-rotating in synchronicity.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-infinity-gear"><div class="acls-ig-gear1"></div><div class="acls-ig-gear2"></div></div>',
				),
				'digital-clockwork'      => array(
					'label'       => __( 'Digital Chrono', 'aerospin-css-loading-spinners' ),
					'description' => __( 'High-tech stopwatch HUD dial with rapid second ticks and sweeping millisecond arc.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-digital-clockwork"><div class="acls-dc-dial"></div><div class="acls-dc-arc"></div><div class="acls-dc-hand"></div></div>',
				),
				'neon-hex'               => array(
					'label'       => __( 'Neon Cyber Ring', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Vivid neon gradient polygon pulsing with laser scan line animations.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Colorful', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-neon-hex"><div class="acls-nh-hex1"></div><div class="acls-nh-hex2"></div><div class="acls-nh-beam"></div></div>',
				),
				'ripple-matrix'          => array(
					'label'       => __( 'Dot Matrix Wave', 'aerospin-css-loading-spinners' ),
					'description' => __( '3x3 matrix grid of dots undulating in a diagonal 2D ripple matrix.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Dots', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-ripple-matrix"><div></div><div></div><div></div><div></div><div></div><div></div><div></div><div></div><div></div></div>',
				),
				'constellation'          => array(
					'label'       => __( 'Star Constellation', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Interconnected stellar nodes drawing shimmering astral geometric lines.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Animated', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-constellation"><div class="acls-st-star1"></div><div class="acls-st-star2"></div><div class="acls-st-star3"></div><div class="acls-st-star4"></div><div class="acls-st-line1"></div><div class="acls-st-line2"></div></div>',
				),
				'plasma-ball'            => array(
					'label'       => __( 'Tesla Plasma Ball', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Glowing electromagnetic sphere with discharging electrical plasma arcs.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Colorful', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-plasma-ball"><div class="acls-pb-core"></div><div class="acls-pb-spark1"></div><div class="acls-pb-spark2"></div><div class="acls-pb-shell"></div></div>',
				),
				'satellite-dish'         => array(
					'label'       => __( 'Orbital Satellite', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Space telemetry dish tracking satellite pulses across orbital radar beams.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Indicators', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-satellite-dish"><div class="acls-sat-dish"></div><div class="acls-sat-beam1"></div><div class="acls-sat-beam2"></div><div class="acls-sat-signal"></div></div>',
				),
				'card-shuffle'           => array(
					'label'       => __( 'Card Stack Shuffle', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Stack of isometric deck cards smoothly sliding and fanning in cardistry loop.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Shapes', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-card-shuffle"><div class="acls-cs-card1"></div><div class="acls-cs-card2"></div><div class="acls-cs-card3"></div></div>',
				),
				'cascade-rings'          => array(
					'label'       => __( 'Cascading Halos', 'aerospin-css-loading-spinners' ),
					'description' => __( 'Triple concentric glowing halo rings expanding and collapsing in harmonic cascade.', 'aerospin-css-loading-spinners' ),
					'category'    => __( 'Classic', 'aerospin-css-loading-spinners' ),
					'html'        => '<div class="acls-spinner acls-cascade-rings"><div></div><div></div><div></div></div>',
				),
			);
		}

		/**
		 * Build translated text wave spinner markup.
		 *
		 * @since 1.1.4
		 *
		 * @param string $text Loading text.
		 * @return string
		 */
		private static function get_text_wave_html( $text ) {
			$text       = is_string( $text ) ? $text : '';
			$characters = preg_split( '//u', $text, -1, PREG_SPLIT_NO_EMPTY );
			$html       = '<div class="acls-spinner acls-text-wave">';

			// Provide fallback array if splitting fails.
			if ( false === $characters || empty( $characters ) || ! is_array( $characters ) ) {
				$characters = str_split( 'Loading' );
			}

			// Iterate over characters and safely escape each piece.
			foreach ( $characters as $character ) {
				$html .= '<span>' . esc_html( $character ) . '</span>';
			}

			$html .= '</div>';

			return $html;
		}

		/*
		|--------------------------------------------------------------------------
		| SECTION 3: Registry Normalization
		|--------------------------------------------------------------------------
		*/

		/**
		 * Normalize spinner definitions after filtering.
		 *
		 * @since 1.1.4
		 *
		 * @param mixed $spinners Raw spinner definitions.
		 * @return array
		 */
		private static function normalize_spinners( $spinners ) {
			if ( ! is_array( $spinners ) ) {
				return array();
			}

			$normalized = array();

			// Cleanse structure and values of user-provided configurations.
			foreach ( $spinners as $key => $spinner ) {
				$key = sanitize_key( self::safe_scalar( $key ) );

				if ( '' === $key || ! is_array( $spinner ) ) {
					continue;
				}

				$label       = isset( $spinner['label'] ) ? sanitize_text_field( self::safe_scalar( $spinner['label'] ) ) : '';
				$description = isset( $spinner['description'] ) ? sanitize_text_field( self::safe_scalar( $spinner['description'] ) ) : '';
				$category    = isset( $spinner['category'] ) ? sanitize_text_field( self::safe_scalar( $spinner['category'] ) ) : '';
				$html        = isset( $spinner['html'] ) ? self::sanitize_spinner_html( $spinner['html'] ) : '';

				if ( '' === $label ) {
					$label = ucwords( str_replace( '-', ' ', $key ) );
				}

				if ( '' === $category ) {
					$category = __( 'Custom', 'aerospin-css-loading-spinners' );
				}

				if ( '' === $html ) {
					continue;
				}

				$normalized[ $key ] = array(
					'label'       => $label,
					'description' => $description,
					'category'    => $category,
					'html'        => $html,
				);
			}

			return $normalized;
		}

		/**
		 * Safely cast scalar values.
		 *
		 * This prevents warnings if third-party filters provide arrays, objects,
		 * or unexpected values for labels, descriptions, categories, or keys.
		 *
		 * @since 1.1.4
		 *
		 * @param mixed $value Raw value.
		 * @return string
		 */
		private static function safe_scalar( $value ) {
			if ( is_array( $value ) || is_object( $value ) ) {
				return '';
			}

			return is_string( $value ) ? $value : (string) $value;
		}

		/**
		 * Sanitize spinner HTML.
		 *
		 * @since 1.1.4
		 *
		 * @param mixed $html Raw spinner markup.
		 * @return string
		 */
		private static function sanitize_spinner_html( $html ) {
			if ( ! is_string( $html ) || '' === $html ) {
				return '';
			}

			// Updated function call to strictly use the updated correct prefix.
			if ( function_exists( 'aerospin_css_loading_spinners_kses_spinner_html' ) ) {
				return aerospin_css_loading_spinners_kses_spinner_html( $html );
			} elseif ( function_exists( 'Pure_CSS_Spinners_kses_spinner_html' ) ) {
				return Pure_CSS_Spinners_kses_spinner_html( $html );
			}

			if (
				( class_exists( 'AeroSpin_CSS_Loading_Spinners_Helpers' ) && is_callable( array( 'AeroSpin_CSS_Loading_Spinners_Helpers', 'kses_spinner_html' ) ) ) || class_exists( 'Pure_CSS_Spinners_Helpers' )
				&& is_callable( array( 'Pure_CSS_Spinners_Helpers', 'kses_spinner_html' ) )
			) {
				return Pure_CSS_Spinners_Helpers::kses_spinner_html( $html );
			}

			// Failsafe kses pass guaranteeing tight control over tags/attributes.
			return wp_kses(
				$html,
				array(
					'div'  => array(
						'aria-hidden' => true,
						'class'       => true,
						'role'        => true,
					),
					'span' => array(
						'aria-hidden' => true,
						'class'       => true,
						'role'        => true,
					),
				)
			);
		}

		/*
		|--------------------------------------------------------------------------
		| SECTION 4: Category Extraction
		|--------------------------------------------------------------------------
		*/

		/**
		 * Retrieve a unique list of spinner categories.
		 *
		 * @since 1.0.0
		 *
		 * @return array
		 */
		public static function get_categories() {
			if ( null !== self::$categories_cache ) {
				return self::$categories_cache;
			}

			// Serve from persistent transient cache if available.
			$cached_transient = get_transient( 'acls_spinner_categories' );
			if ( ! is_array( $cached_transient ) || empty( $cached_transient ) ) {
				$cached_transient = get_transient( 'Pure_CSS_Spinners_spinner_categories' );
			}
			if ( is_array( $cached_transient ) && ! empty( $cached_transient ) ) {
				self::$categories_cache = $cached_transient;
				return self::$categories_cache;
			}

			$spinners   = self::get_spinners();
			$categories = array();

			// Gather distinct categories into an array.
			foreach ( $spinners as $spinner ) {
				if ( empty( $spinner['category'] ) ) {
					continue;
				}

				$category = sanitize_text_field( self::safe_scalar( $spinner['category'] ) );

				if ( '' !== $category && ! in_array( $category, $categories, true ) ) {
					$categories[] = $category;
				}
			}

			// Organize alphabetically.
			sort( $categories, SORT_NATURAL | SORT_FLAG_CASE );

			self::$categories_cache = $categories;

			// Store in persistent transient cache (24 hours TTL as verified in diagnostics).
			set_transient( 'acls_spinner_categories', self::$categories_cache, 24 * HOUR_IN_SECONDS );
			set_transient( 'Pure_CSS_Spinners_spinner_categories', self::$categories_cache, 24 * HOUR_IN_SECONDS );

			return self::$categories_cache;
		}

		/**
		 * Clear spinner registry and category caches.
		 *
		 * @since 1.1.4
		 *
		 * @return void
		 */
		public static function clear_cache() {
			self::$spinners_cache   = null;
			self::$categories_cache = null;

			// Safe cleanup for both modern and legacy database transient records.
			delete_transient( 'acls_spinner_categories' );
			delete_transient( 'AeroSpin_CSS_Loading_Spinners_spinner_categories' );
			delete_transient( 'Pure_CSS_Spinners_spinner_categories' );
			delete_transient( 'cp_spinners_spinner_categories' );
		}
	}
}

if ( ! class_exists( 'AeroSpin_CSS_Loading_Spinners_List' ) ) {
	class_alias( 'ACLS_Spinners_List', 'AeroSpin_CSS_Loading_Spinners_List' );
}
if ( ! class_exists( 'Pure_CSS_Spinners_List' ) ) {
	class_alias( 'ACLS_Spinners_List', 'Pure_CSS_Spinners_List' );
}
if ( ! class_exists( 'AreoSpin_Css_Loading_Spinners_List' ) ) {
	class_alias( 'ACLS_Spinners_List', 'AreoSpin_Css_Loading_Spinners_List' );
}

/*
|--------------------------------------------------------------------------
| SECTION 5: Procedural Standard Wrappers
|--------------------------------------------------------------------------
|
| These functions provide procedural access to AeroSpin CSS Loading Spinners list methods,
| adhering strictly to WordPress.org prefixing requirements.
|
*/

if ( ! function_exists( 'aerospin_css_loading_spinners_get_spinners' ) ) {
	function aerospin_css_loading_spinners_get_spinners() {
		return ACLS_Spinners_List::get_spinners();
	}
}

if ( ! function_exists( 'aerospin_css_loading_spinners_get_spinner' ) ) {
	function aerospin_css_loading_spinners_get_spinner( $key, $default_value = 'ring' ) {
		return ACLS_Spinners_List::get_spinner( $key, $default_value );
	}
}

if ( ! function_exists( 'aerospin_css_loading_spinners_get_categories' ) ) {
	function aerospin_css_loading_spinners_get_categories() {
		return ACLS_Spinners_List::get_categories();
	}
}

if ( ! function_exists( 'aerospin_css_loading_spinners_clear_spinner_cache' ) ) {
	function aerospin_css_loading_spinners_clear_spinner_cache() {
		ACLS_Spinners_List::clear_cache();
	}
}

// Backward-compatibility wrappers for legacy pure_css_spinners_* functions
if ( ! function_exists( 'pure_css_spinners_get_spinners' ) ) {
	function pure_css_spinners_get_spinners() {
		return aerospin_css_loading_spinners_get_spinners();
	}
}

if ( ! function_exists( 'pure_css_spinners_get_spinner' ) ) {
	function pure_css_spinners_get_spinner( $key, $default_value = 'ring' ) {
		return aerospin_css_loading_spinners_get_spinner( $key, $default_value );
	}
}

if ( ! function_exists( 'pure_css_spinners_get_categories' ) ) {
	function pure_css_spinners_get_categories() {
		return aerospin_css_loading_spinners_get_categories();
	}
}

if ( ! function_exists( 'pure_css_spinners_clear_spinner_cache' ) ) {
	function pure_css_spinners_clear_spinner_cache() {
		aerospin_css_loading_spinners_clear_spinner_cache();
	}
}