<h2>File Contents: /home/planet5/www/yanhuanghealthcare.co.uk/wp-includes/class-wp-script-modules.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/yanhuanghealthcare.co.uk/wp-includes/class-wp-script-modules.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Script Modules API: WP_Script_Modules class.
 *
 * Native support for ES Modules and Import Maps.
 *
 * @package WordPress
 * @subpackage Script Modules
 */

/**
 * Core class used to register script modules.
 *
 * @since 6.5.0
 */
class WP_Script_Modules {
	/**
	 * Holds the registered script modules, keyed by script module identifier.
	 *
	 * @since 6.5.0
	 * @var array[]
	 */
	private $registered = array();

	/**
	 * Holds the script module identifiers that were enqueued before registered.
	 *
	 * @since 6.5.0
	 * @var array&lt;string, true&gt;
	 */
	private $enqueued_before_registered = array();

	/**
	 * Tracks whether the @wordpress/a11y script module is available.
	 *
	 * Some additional HTML is required on the page for the module to work. Track
	 * whether it&#039;s available to print at the appropriate time.
	 *
	 * @since 6.7.0
	 * @var bool
	 */
	private $a11y_available = false;

	/**
	 * Registers the script module if no script module with that script module
	 * identifier has already been registered.
	 *
	 * @since 6.5.0
	 *
	 * @param string            $id       The identifier of the script module. Should be unique. It will be used in the
	 *                                    final import map.
	 * @param string            $src      Optional. Full URL of the script module, or path of the script module relative
	 *                                    to the WordPress root directory. If it is provided and the script module has
	 *                                    not been registered yet, it will be registered.
	 * @param array             $deps     {
	 *                                        Optional. List of dependencies.
	 *
	 *                                        @type string|array ...$0 {
	 *                                            An array of script module identifiers of the dependencies of this script
	 *                                            module. The dependencies can be strings or arrays. If they are arrays,
	 *                                            they need an `id` key with the script module identifier, and can contain
	 *                                            an `import` key with either `static` or `dynamic`. By default,
	 *                                            dependencies that don&#039;t contain an `import` key are considered static.
	 *
	 *                                            @type string $id     The script module identifier.
	 *                                            @type string $import Optional. Import type. May be either `static` or
	 *                                                                 `dynamic`. Defaults to `static`.
	 *                                        }
	 *                                    }
	 * @param string|false|null $version  Optional. String specifying the script module version number. Defaults to false.
	 *                                    It is added to the URL as a query string for cache busting purposes. If $version
	 *                                    is set to false, the version number is the currently installed WordPress version.
	 *                                    If $version is set to null, no version is added.
	 */
	public function register( string $id, string $src, array $deps = array(), $version = false ) {
		if ( ! isset( $this-&gt;registered[ $id ] ) ) {
			$dependencies = array();
			foreach ( $deps as $dependency ) {
				if ( is_array( $dependency ) ) {
					if ( ! isset( $dependency[&#039;id&#039;] ) ) {
						_doing_it_wrong( __METHOD__, __( &#039;Missing required id key in entry among dependencies array.&#039; ), &#039;6.5.0&#039; );
						continue;
					}
					$dependencies[] = array(
						&#039;id&#039;     =&gt; $dependency[&#039;id&#039;],
						&#039;import&#039; =&gt; isset( $dependency[&#039;import&#039;] ) &amp;&amp; &#039;dynamic&#039; === $dependency[&#039;import&#039;] ? &#039;dynamic&#039; : &#039;static&#039;,
					);
				} elseif ( is_string( $dependency ) ) {
					$dependencies[] = array(
						&#039;id&#039;     =&gt; $dependency,
						&#039;import&#039; =&gt; &#039;static&#039;,
					);
				} else {
					_doing_it_wrong( __METHOD__, __( &#039;Entries in dependencies array must be either strings or arrays with an id key.&#039; ), &#039;6.5.0&#039; );
				}
			}

			$this-&gt;registered[ $id ] = array(
				&#039;src&#039;          =&gt; $src,
				&#039;version&#039;      =&gt; $version,
				&#039;enqueue&#039;      =&gt; isset( $this-&gt;enqueued_before_registered[ $id ] ),
				&#039;dependencies&#039; =&gt; $dependencies,
			);
		}
	}

	/**
	 * Marks the script module to be enqueued in the page.
	 *
	 * If a src is provided and the script module has not been registered yet, it
	 * will be registered.
	 *
	 * @since 6.5.0
	 *
	 * @param string            $id       The identifier of the script module. Should be unique. It will be used in the
	 *                                    final import map.
	 * @param string            $src      Optional. Full URL of the script module, or path of the script module relative
	 *                                    to the WordPress root directory. If it is provided and the script module has
	 *                                    not been registered yet, it will be registered.
	 * @param array             $deps     {
	 *                                        Optional. List of dependencies.
	 *
	 *                                        @type string|array ...$0 {
	 *                                            An array of script module identifiers of the dependencies of this script
	 *                                            module. The dependencies can be strings or arrays. If they are arrays,
	 *                                            they need an `id` key with the script module identifier, and can contain
	 *                                            an `import` key with either `static` or `dynamic`. By default,
	 *                                            dependencies that don&#039;t contain an `import` key are considered static.
	 *
	 *                                            @type string $id     The script module identifier.
	 *                                            @type string $import Optional. Import type. May be either `static` or
	 *                                                                 `dynamic`. Defaults to `static`.
	 *                                        }
	 *                                    }
	 * @param string|false|null $version  Optional. String specifying the script module version number. Defaults to false.
	 *                                    It is added to the URL as a query string for cache busting purposes. If $version
	 *                                    is set to false, the version number is the currently installed WordPress version.
	 *                                    If $version is set to null, no version is added.
	 */
	public function enqueue( string $id, string $src = &#039;&#039;, array $deps = array(), $version = false ) {
		if ( isset( $this-&gt;registered[ $id ] ) ) {
			$this-&gt;registered[ $id ][&#039;enqueue&#039;] = true;
		} elseif ( $src ) {
			$this-&gt;register( $id, $src, $deps, $version );
			$this-&gt;registered[ $id ][&#039;enqueue&#039;] = true;
		} else {
			$this-&gt;enqueued_before_registered[ $id ] = true;
		}
	}

	/**
	 * Unmarks the script module so it will no longer be enqueued in the page.
	 *
	 * @since 6.5.0
	 *
	 * @param string $id The identifier of the script module.
	 */
	public function dequeue( string $id ) {
		if ( isset( $this-&gt;registered[ $id ] ) ) {
			$this-&gt;registered[ $id ][&#039;enqueue&#039;] = false;
		}
		unset( $this-&gt;enqueued_before_registered[ $id ] );
	}

	/**
	 * Removes a registered script module.
	 *
	 * @since 6.5.0
	 *
	 * @param string $id The identifier of the script module.
	 */
	public function deregister( string $id ) {
		unset( $this-&gt;registered[ $id ] );
		unset( $this-&gt;enqueued_before_registered[ $id ] );
	}

	/**
	 * Adds the hooks to print the import map, enqueued script modules and script
	 * module preloads.
	 *
	 * In classic themes, the script modules used by the blocks are not yet known
	 * when the `wp_head` actions is fired, so it needs to print everything in the
	 * footer.
	 *
	 * @since 6.5.0
	 */
	public function add_hooks() {
		$position = wp_is_block_theme() ? &#039;wp_head&#039; : &#039;wp_footer&#039;;
		add_action( $position, array( $this, &#039;print_import_map&#039; ) );
		add_action( $position, array( $this, &#039;print_enqueued_script_modules&#039; ) );
		add_action( $position, array( $this, &#039;print_script_module_preloads&#039; ) );

		add_action( &#039;admin_print_footer_scripts&#039;, array( $this, &#039;print_import_map&#039; ) );
		add_action( &#039;admin_print_footer_scripts&#039;, array( $this, &#039;print_enqueued_script_modules&#039; ) );
		add_action( &#039;admin_print_footer_scripts&#039;, array( $this, &#039;print_script_module_preloads&#039; ) );

		add_action( &#039;wp_footer&#039;, array( $this, &#039;print_script_module_data&#039; ) );
		add_action( &#039;admin_print_footer_scripts&#039;, array( $this, &#039;print_script_module_data&#039; ) );
		add_action( &#039;wp_footer&#039;, array( $this, &#039;print_a11y_script_module_html&#039; ), 20 );
		add_action( &#039;admin_print_footer_scripts&#039;, array( $this, &#039;print_a11y_script_module_html&#039; ), 20 );
	}

	/**
	 * Prints the enqueued script modules using script tags with type=&quot;module&quot;
	 * attributes.
	 *
	 * @since 6.5.0
	 */
	public function print_enqueued_script_modules() {
		foreach ( $this-&gt;get_marked_for_enqueue() as $id =&gt; $script_module ) {
			wp_print_script_tag(
				array(
					&#039;type&#039; =&gt; &#039;module&#039;,
					&#039;src&#039;  =&gt; $this-&gt;get_src( $id ),
					&#039;id&#039;   =&gt; $id . &#039;-js-module&#039;,
				)
			);
		}
	}

	/**
	 * Prints the the static dependencies of the enqueued script modules using
	 * link tags with rel=&quot;modulepreload&quot; attributes.
	 *
	 * If a script module is marked for enqueue, it will not be preloaded.
	 *
	 * @since 6.5.0
	 */
	public function print_script_module_preloads() {
		foreach ( $this-&gt;get_dependencies( array_keys( $this-&gt;get_marked_for_enqueue() ), array( &#039;static&#039; ) ) as $id =&gt; $script_module ) {
			// Don&#039;t preload if it&#039;s marked for enqueue.
			if ( true !== $script_module[&#039;enqueue&#039;] ) {
				echo sprintf(
					&#039;&lt;link rel=&quot;modulepreload&quot; href=&quot;%s&quot; id=&quot;%s&quot;&gt;&#039;,
					esc_url( $this-&gt;get_src( $id ) ),
					esc_attr( $id . &#039;-js-modulepreload&#039; )
				);
			}
		}
	}

	/**
	 * Prints the import map using a script tag with a type=&quot;importmap&quot; attribute.
	 *
	 * @since 6.5.0
	 */
	public function print_import_map() {
		$import_map = $this-&gt;get_import_map();
		if ( ! empty( $import_map[&#039;imports&#039;] ) ) {
			wp_print_inline_script_tag(
				wp_json_encode( $import_map, JSON_HEX_TAG | JSON_HEX_AMP ),
				array(
					&#039;type&#039; =&gt; &#039;importmap&#039;,
					&#039;id&#039;   =&gt; &#039;wp-importmap&#039;,
				)
			);
		}
	}

	/**
	 * Returns the import map array.
	 *
	 * @since 6.5.0
	 *
	 * @return array Array with an `imports` key mapping to an array of script module identifiers and their respective
	 *               URLs, including the version query.
	 */
	private function get_import_map(): array {
		$imports = array();
		foreach ( $this-&gt;get_dependencies( array_keys( $this-&gt;get_marked_for_enqueue() ) ) as $id =&gt; $script_module ) {
			$imports[ $id ] = $this-&gt;get_src( $id );
		}
		return array( &#039;imports&#039; =&gt; $imports );
	}

	/**
	 * Retrieves the list of script modules marked for enqueue.
	 *
	 * @since 6.5.0
	 *
	 * @return array[] Script modules marked for enqueue, keyed by script module identifier.
	 */
	private function get_marked_for_enqueue(): array {
		$enqueued = array();
		foreach ( $this-&gt;registered as $id =&gt; $script_module ) {
			if ( true === $script_module[&#039;enqueue&#039;] ) {
				$enqueued[ $id ] = $script_module;
			}
		}
		return $enqueued;
	}

	/**
	 * Retrieves all the dependencies for the given script module identifiers,
	 * filtered by import types.
	 *
	 * It will consolidate an array containing a set of unique dependencies based
	 * on the requested import types: &#039;static&#039;, &#039;dynamic&#039;, or both. This method is
	 * recursive and also retrieves dependencies of the dependencies.
	 *
	 * @since 6.5.0
	 *
	 * @param string[] $ids          The identifiers of the script modules for which to gather dependencies.
	 * @param string[] $import_types Optional. Import types of dependencies to retrieve: &#039;static&#039;, &#039;dynamic&#039;, or both.
	 *                               Default is both.
	 * @return array[] List of dependencies, keyed by script module identifier.
	 */
	private function get_dependencies( array $ids, array $import_types = array( &#039;static&#039;, &#039;dynamic&#039; ) ) {
		return array_reduce(
			$ids,
			function ( $dependency_script_modules, $id ) use ( $import_types ) {
				$dependencies = array();
				foreach ( $this-&gt;registered[ $id ][&#039;dependencies&#039;] as $dependency ) {
					if (
					in_array( $dependency[&#039;import&#039;], $import_types, true ) &amp;&amp;
					isset( $this-&gt;registered[ $dependency[&#039;id&#039;] ] ) &amp;&amp;
					! isset( $dependency_script_modules[ $dependency[&#039;id&#039;] ] )
					) {
						$dependencies[ $dependency[&#039;id&#039;] ] = $this-&gt;registered[ $dependency[&#039;id&#039;] ];
					}
				}
				return array_merge( $dependency_script_modules, $dependencies, $this-&gt;get_dependencies( array_keys( $dependencies ), $import_types ) );
			},
			array()
		);
	}

	/**
	 * Gets the versioned URL for a script module src.
	 *
	 * If $version is set to false, the version number is the currently installed
	 * WordPress version. If $version is set to null, no version is added.
	 * Otherwise, the string passed in $version is used.
	 *
	 * @since 6.5.0
	 *
	 * @param string $id The script module identifier.
	 * @return string The script module src with a version if relevant.
	 */
	private function get_src( string $id ): string {
		if ( ! isset( $this-&gt;registered[ $id ] ) ) {
			return &#039;&#039;;
		}

		$script_module = $this-&gt;registered[ $id ];
		$src           = $script_module[&#039;src&#039;];

		if ( false === $script_module[&#039;version&#039;] ) {
			$src = add_query_arg( &#039;ver&#039;, get_bloginfo( &#039;version&#039; ), $src );
		} elseif ( null !== $script_module[&#039;version&#039;] ) {
			$src = add_query_arg( &#039;ver&#039;, $script_module[&#039;version&#039;], $src );
		}

		/**
		 * Filters the script module source.
		 *
		 * @since 6.5.0
		 *
		 * @param string $src Module source URL.
		 * @param string $id  Module identifier.
		 */
		$src = apply_filters( &#039;script_module_loader_src&#039;, $src, $id );

		return $src;
	}

	/**
	 * Print data associated with Script Modules.
	 *
	 * The data will be embedded in the page HTML and can be read by Script Modules on page load.
	 *
	 * @since 6.7.0
	 *
	 * Data can be associated with a Script Module via the
	 * {@see &quot;script_module_data_{$module_id}&quot;} filter.
	 *
	 * The data for a Script Module will be serialized as JSON in a script tag with an ID of the
	 * form `wp-script-module-data-{$module_id}`.
	 */
	public function print_script_module_data(): void {
		$modules = array();
		foreach ( array_keys( $this-&gt;get_marked_for_enqueue() ) as $id ) {
			if ( &#039;@wordpress/a11y&#039; === $id ) {
				$this-&gt;a11y_available = true;
			}
			$modules[ $id ] = true;
		}
		foreach ( array_keys( $this-&gt;get_import_map()[&#039;imports&#039;] ) as $id ) {
			if ( &#039;@wordpress/a11y&#039; === $id ) {
				$this-&gt;a11y_available = true;
			}
			$modules[ $id ] = true;
		}

		foreach ( array_keys( $modules ) as $module_id ) {
			/**
			 * Filters data associated with a given Script Module.
			 *
			 * Script Modules may require data that is required for initialization or is essential
			 * to have immediately available on page load. These are suitable use cases for
			 * this data.
			 *
			 * The dynamic portion of the hook name, `$module_id`, refers to the Script Module ID
			 * that the data is associated with.
			 *
			 * This is best suited to pass essential data that must be available to the module for
			 * initialization or immediately on page load. It does not replace the REST API or
			 * fetching data from the client.
			 *
			 * Example:
			 *
			 *     add_filter(
			 *         &#039;script_module_data_MyScriptModuleID&#039;,
			 *         function ( array $data ): array {
			 *             $data[&#039;dataForClient&#039;] = &#039;ok&#039;;
			 *             return $data;
			 *         }
			 *     );
			 *
			 * If the filter returns no data (an empty array), nothing will be embedded in the page.
			 *
			 * The data for a given Script Module, if provided, will be JSON serialized in a script
			 * tag with an ID of the form `wp-script-module-data-{$module_id}`.
			 *
			 * The data can be read on the client with a pattern like this:
			 *
			 * Example:
			 *
			 *     const dataContainer = document.getElementById( &#039;wp-script-module-data-MyScriptModuleID&#039; );
			 *     let data = {};
			 *     if ( dataContainer ) {
			 *         try {
			 *             data = JSON.parse( dataContainer.textContent );
			 *         } catch {}
			 *     }
			 *     // data.dataForClient === &#039;ok&#039;;
			 *     initMyScriptModuleWithData( data );
			 *
			 * @since 6.7.0
			 *
			 * @param array $data The data associated with the Script Module.
			 */
			$data = apply_filters( &quot;script_module_data_{$module_id}&quot;, array() );

			if ( is_array( $data ) &amp;&amp; array() !== $data ) {
				/*
				 * This data will be printed as JSON inside a script tag like this:
				 *   &lt;script type=&quot;application/json&quot;&gt;&lt;/script&gt;
				 *
				 * A script tag must be closed by a sequence beginning with `&lt;/`. It&#039;s impossible to
				 * close a script tag without using `&lt;`. We ensure that `&lt;` is escaped and `/` can
				 * remain unescaped, so `&lt;/script&gt;` will be printed as `\u003C/script\u00E3`.
				 *
				 *   - JSON_HEX_TAG: All &lt; and &gt; are converted to \u003C and \u003E.
				 *   - JSON_UNESCAPED_SLASHES: Don&#039;t escape /.
				 *
				 * If the page will use UTF-8 encoding, it&#039;s safe to print unescaped unicode:
				 *
				 *   - JSON_UNESCAPED_UNICODE: Encode multibyte Unicode characters literally (instead of as `\uXXXX`).
				 *   - JSON_UNESCAPED_LINE_TERMINATORS: The line terminators are kept unescaped when
				 *     JSON_UNESCAPED_UNICODE is supplied. It uses the same behaviour as it was
				 *     before PHP 7.1 without this constant. Available as of PHP 7.1.0.
				 *
				 * The JSON specification requires encoding in UTF-8, so if the generated HTML page
				 * is not encoded in UTF-8 then it&#039;s not safe to include those literals. They must
				 * be escaped to avoid encoding issues.
				 *
				 * @see https://www.rfc-editor.org/rfc/rfc8259.html for details on encoding requirements.
				 * @see https://www.php.net/manual/en/json.constants.php for details on these constants.
				 * @see https://html.spec.whatwg.org/#script-data-state for details on script tag parsing.
				 */
				$json_encode_flags = JSON_HEX_TAG | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_LINE_TERMINATORS;
				if ( ! is_utf8_charset() ) {
					$json_encode_flags = JSON_HEX_TAG | JSON_UNESCAPED_SLASHES;
				}

				wp_print_inline_script_tag(
					wp_json_encode(
						$data,
						$json_encode_flags
					),
					array(
						&#039;type&#039; =&gt; &#039;application/json&#039;,
						&#039;id&#039;   =&gt; &quot;wp-script-module-data-{$module_id}&quot;,
					)
				);
			}
		}
	}

	/**
	 * @access private This is only intended to be called by the registered actions.
	 *
	 * @since 6.7.0
	 */
	public function print_a11y_script_module_html() {
		if ( ! $this-&gt;a11y_available ) {
			return;
		}
		echo &#039;&lt;div style=&quot;position:absolute;margin:-1px;padding:0;height:1px;width:1px;overflow:hidden;clip-path:inset(50%);border:0;word-wrap:normal !important;&quot;&gt;&#039;
			. &#039;&lt;p id=&quot;a11y-speak-intro-text&quot; class=&quot;a11y-speak-intro-text&quot; hidden&gt;&#039; . esc_html__( &#039;Notifications&#039; ) . &#039;&lt;/p&gt;&#039;
			. &#039;&lt;div id=&quot;a11y-speak-assertive&quot; class=&quot;a11y-speak-region&quot; aria-live=&quot;assertive&quot; aria-relevant=&quot;additions text&quot; aria-atomic=&quot;true&quot;&gt;&lt;/div&gt;&#039;
			. &#039;&lt;div id=&quot;a11y-speak-polite&quot; class=&quot;a11y-speak-region&quot; aria-live=&quot;polite&quot; aria-relevant=&quot;additions text&quot; aria-atomic=&quot;true&quot;&gt;&lt;/div&gt;&#039;
			. &#039;&lt;/div&gt;&#039;;
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fyanhuanghealthcare.co.uk%2Fwp-includes'>⬅ Back to Directory</a>