<?php

/**

 * BackPress Scripts enqueue

 *

 * Classes were refactored from the WP_Scripts and WordPress script enqueue API.

 *

 * @since BackPress r74

 *

 * @package BackPress

 * @uses _WP_Dependency

 * @since r74

 */

class WP_Dependencies {

	/**

	 * An array of registered handle objects.

	 *

	 * @access public

	 * @since 2.6.8

	 * @var array

	 */

	var $registered = array();

	/**

	 * An array of queued _WP_Dependency handle objects.

	 *

	 * @access public

	 * @since 2.6.8

	 * @var array

	 */

	var $queue = array();

	/**

	 * An array of _WP_Dependency handle objects to queue.

	 *

	 * @access public

	 * @since 2.6.0

	 * @var array

	 */

	var $to_do = array();

	/**

	 * An array of _WP_Dependency handle objects already queued.

	 *

	 * @access public

	 * @since 2.6.0

	 * @var array

	 */

	var $done = array();

	/**

	 * An array of additional arguments passed when a handle is registered.

	 *

	 * Arguments are appended to the item query string.

	 *

	 * @access public

	 * @since 2.6.0

	 * @var array

	 */

	var $args = array();

	/**

	 * An array of handle groups to enqueue.

	 *

	 * @access public

	 * @since 2.8.0

	 * @var array

	 */

	var $groups = array();

	/**

	 * A handle group to enqueue.

	 *

	 * @access public

	 * @since 2.8.0

	 * @var int

	 */

	var $group = 0;

	/**

	 * Process the items and dependencies.

	 *

	 * Processes the items passed to it or the queue, and their dependencies.

	 *

	 * @access public

	 * @since 2.1.0

	 *

	 * @param mixed $handles Optional. Items to be processed: Process queue (false), process item (string), process items (array of strings).

	 * @param mixed $group   Group level: level (int), no groups (false).

	 * @return array Handles of items that have been processed.

	 */

	public function do_items( $handles = false, $group = false ) {

		/**

		 * If nothing is passed, print the queue. If a string is passed,

		 * print that item. If an array is passed, print those items.

		 */

		$handles = false === $handles ? $this->queue : (array) $handles;

		$this->all_deps( $handles );

		foreach( $this->to_do as $key => $handle ) {

			if ( !in_array($handle, $this->done, true) && isset($this->registered[$handle]) ) {

				/**

				 * A single item may alias a set of items, by having dependencies,

				 * but no source. Queuing the item queues the dependencies.

				 *

				 * Example: The extending class WP_Scripts is used to register 'scriptaculous' as a set of registered handles:

				 *   <code>add( 'scriptaculous', false, array( 'scriptaculous-dragdrop', 'scriptaculous-slider', 'scriptaculous-controls' ) );</code>

				 *

				 * The src property is false.

				**/

				if ( ! $this->registered[$handle]->src ) {

					$this->done[] = $handle;

					continue;

				}

				/**

				 * Attempt to process the item. If successful,

				 * add the handle to the done array.

				 *

				 * Unset the item from the to_do array.

				 */

				if ( $this->do_item( $handle, $group ) )

					$this->done[] = $handle;

				unset( $this->to_do[$key] );

			}

		}

		return $this->done;

	}

	/**

	 * Process a dependency.

	 *

	 * @access public

	 * @since 2.6.0

	 *

	 * @param string $handle Name of the item. Should be unique.

	 * @return bool True on success, false if not set.

	 */

	public function do_item( $handle ) {

		return isset($this->registered[$handle]);

	}

	/**

	 * Determine dependencies.

	 *

	 * Recursively builds an array of items to process taking

	 * dependencies into account. Does NOT catch infinite loops.

	 *

	 * @access public

	 * @since 2.1.0

	 *

	 * @param mixed $handles   Item handle and argument (string) or item handles and arguments (array of strings).

	 * @param bool  $recursion Internal flag that function is calling itself.

	 * @param mixed $group     Group level: (int) level, (false) no groups.

	 * @return bool True on success, false on failure.

	 */

	public function all_deps( $handles, $recursion = false, $group = false ) {

		if ( !$handles = (array) $handles )

			return false;

		foreach ( $handles as $handle ) {

			$handle_parts = explode('?', $handle);

			$handle = $handle_parts[0];

			$queued = in_array($handle, $this->to_do, true);

			if ( in_array($handle, $this->done, true) ) // Already done

				continue;

			$moved = $this->set_group( $handle, $recursion, $group );

			if ( $queued && !$moved ) // already queued and in the right group

				continue;

			$keep_going = true;

			if ( !isset($this->registered[$handle]) )

				$keep_going = false; // Item doesn't exist.

			elseif ( $this->registered[$handle]->deps && array_diff($this->registered[$handle]->deps, array_keys($this->registered)) )

				$keep_going = false; // Item requires dependencies that don't exist.

			elseif ( $this->registered[$handle]->deps && !$this->all_deps( $this->registered[$handle]->deps, true, $group ) )

				$keep_going = false; // Item requires dependencies that don't exist.

			if ( ! $keep_going ) { // Either item or its dependencies don't exist.

				if ( $recursion )

					return false; // Abort this branch.

				else

					continue; // We're at the top level. Move on to the next one.

			}

			if ( $queued ) // Already grabbed it and its dependencies.

				continue;

			if ( isset($handle_parts[1]) )

				$this->args[$handle] = $handle_parts[1];

			$this->to_do[] = $handle;

		}

		return true;

	}

	/**

	 * Register an item.

	 *

	 * Registers the item if no item of that name already exists.

	 *

	 * @access public

	 * @since 2.1.0

	 *

	 * @param string $handle Unique item name.

	 * @param string $src    The item url.

	 * @param array  $deps   Optional. An array of item handle strings on which this item depends.

	 * @param string $ver    Optional. Version (used for cache busting).

	 * @param mixed  $args   Optional. Custom property of the item. NOT the class property $args. Examples: $media, $in_footer.

	 * @return bool True on success, false on failure.

	 */

	public function add( $handle, $src, $deps = array(), $ver = false, $args = null ) {

		if ( isset($this->registered[$handle]) )

			return false;

		$this->registered[$handle] = new _WP_Dependency( $handle, $src, $deps, $ver, $args );

		return true;

	}

	/**

	 * Add extra item data.

	 *

	 * Adds data to a registered item.

	 *

	 * @access public

	 * @since 2.6.0

	 *

	 * @param string $handle Name of the item. Should be unique.

	 * @param string $key    The data key.

	 * @param mixed  $value  The data value.

	 * @return bool True on success, false on failure.

	 */

	public function add_data( $handle, $key, $value ) {

		if ( !isset( $this->registered[$handle] ) )

			return false;

		return $this->registered[$handle]->add_data( $key, $value );

	}

	/**

	 * Get extra item data.

	 *

	 * Gets data associated with a registered item.

	 *

	 * @access public

	 * @since 3.3.0

	 *

	 * @param string $handle Name of the item. Should be unique.

	 * @param string $key    The data key.

	 * @return mixed Extra item data (string), false otherwise.

	 */

	public function get_data( $handle, $key ) {

		if ( !isset( $this->registered[$handle] ) )

			return false;

		if ( !isset( $this->registered[$handle]->extra[$key] ) )

			return false;

		return $this->registered[$handle]->extra[$key];

	}

	/**

	 * Un-register an item or items.

	 *

	 * @access public

	 * @since 2.1.0

	 *

	 * @param mixed $handles Item handle and argument (string) or item handles and arguments (array of strings).

	 * @return void

	 */

	public function remove( $handles ) {

		foreach ( (array) $handles as $handle )

			unset($this->registered[$handle]);

	}

	/**

	 * Queue an item or items.

	 *

	 * Decodes handles and arguments, then queues handles and stores

	 * arguments in the class property $args. For example in extending

	 * classes, $args is appended to the item url as a query string.

	 * Note $args is NOT the $args property of items in the $registered array.

	 *

	 * @access public

	 * @since 2.1.0

	 *

	 * @param mixed $handles Item handle and argument (string) or item handles and arguments (array of strings).

	 */

	public function enqueue( $handles ) {

		foreach ( (array) $handles as $handle ) {

			$handle = explode('?', $handle);

			if ( !in_array($handle[0], $this->queue) && isset($this->registered[$handle[0]]) ) {

				$this->queue[] = $handle[0];

				if ( isset($handle[1]) )

					$this->args[$handle[0]] = $handle[1];

			}

		}

	}

	/**

	 * Dequeue an item or items.

	 *

	 * Decodes handles and arguments, then dequeues handles

	 * and removes arguments from the class property $args.

	 *

	 * @access public

	 * @since 2.1.0

	 *

	 * @param mixed $handles Item handle and argument (string) or item handles and arguments (array of strings).

	 */

	public function dequeue( $handles ) {

		foreach ( (array) $handles as $handle ) {

			$handle = explode('?', $handle);

			$key = array_search($handle[0], $this->queue);

			if ( false !== $key ) {

				unset($this->queue[$key]);

				unset($this->args[$handle[0]]);

			}

		}

	}

	/**

	 * Query list for an item.

	 *

	 * @access public

	 * @since 2.1.0

	 *

	 * @param string $handle Name of the item. Should be unique.

	 * @param string $list   Property name of list array.

	 * @return bool Found, or object Item data.

	 */

	public function query( $handle, $list = 'registered' ) {

		switch ( $list ) {

			case 'registered' :

			case 'scripts': // back compat

				if ( isset( $this->registered[ $handle ] ) )

					return $this->registered[ $handle ];

				return false;

			case 'enqueued' :

			case 'queue' :

				return in_array( $handle, $this->queue );

			case 'to_do' :

			case 'to_print': // back compat

				return in_array( $handle, $this->to_do );

			case 'done' :

			case 'printed': // back compat

				return in_array( $handle, $this->done );

		}

		return false;

	}

	/**

	 * Set item group, unless already in a lower group.

	 *

	 * @access public

	 * @since 2.8.0

	 *

	 * @param string $handle    Name of the item. Should be unique.

	 * @param bool   $recursion Internal flag that calling function was called recursively.

	 * @param mixed  $group     Group level.

	 * @return bool Not already in the group or a lower group

	 */

	public function set_group( $handle, $recursion, $group ) {

		$group = (int) $group;

		if ( $recursion )

			$group = min($this->group, $group);

		else

			$this->group = $group;

		if ( isset($this->groups[$handle]) && $this->groups[$handle] <= $group )

			return false;

		$this->groups[$handle] = $group;

		return true;

	}

} // WP_Dependencies

/**

 * Class _WP_Dependency

 *

 * Helper class to register a handle and associated data.

 *

 * @access private

 * @since 2.6.0

 */

class _WP_Dependency {

	/**

	 * The handle name.

	 *

	 * @access public

	 * @since 2.6.0

	 * @var null

	 */

	var $handle;

	/**

	 * The handle source.

	 *

	 * @access public

	 * @since 2.6.0

	 * @var null

	 */

	var $src;

	/**

	 * An array of handle dependencies.

	 *

	 * @access public

	 * @since 2.6.0

	 * @var array

	 */

	var $deps = array();

	/**

	 * The handle version.

	 *

	 * Used for cache-busting.

	 *

	 * @access public

	 * @since 2.6.0

	 * @var bool|string

	 */

	var $ver = false;

	/**

	 * Additional arguments for the handle.

	 *

	 * @access public

	 * @since 2.6.0

	 * @var null

	 */

	var $args = null;  // Custom property, such as $in_footer or $media.

	/**

	 * Extra data to supply to the handle.

	 *

	 * @access public