register_block_script_module_id( array $metadata, string $field_name, int $index = 0 ): string|false

169function register_block_script_module_id( $metadata, $field_name, $index = 0 ) {170	if ( empty( $metadata[ $field_name ] ) ) {171		return false;172	}173 174	$module_id = $metadata[ $field_name ];175	if ( is_array( $module_id ) ) {176		if ( empty( $module_id[ $index ] ) ) {177			return false;178		}179		$module_id = $module_id[ $index ];180	}181 182	$module_path = remove_block_asset_path_prefix( $module_id );183	if ( $module_id === $module_path ) {184		return $module_id;185	}186 187	$path                  = dirname( $metadata['file'] );188	$module_asset_raw_path = $path . '/' . substr_replace( $module_path, '.asset.php', - strlen( '.js' ) );189	$module_id             = generate_block_asset_handle( $metadata['name'], $field_name, $index );190	$module_asset_path     = wp_normalize_path(191		realpath( $module_asset_raw_path )192	);193 194	$module_path_norm = wp_normalize_path( realpath( $path . '/' . $module_path ) );195	$module_uri       = get_block_asset_url( $module_path_norm );196 197	/** @var array{ dependencies?: list<non-falsy-string|array{id: non-falsy-string, import?: 'static'|'dynamic'}>, version?: string|false|null, ... } $module_asset */198	$module_asset        = ! empty( $module_asset_path ) ? require $module_asset_path : array();199	$module_dependencies = $module_asset['dependencies'] ?? array();200	$block_version       = $metadata['version'] ?? false;201	$module_version      = $module_asset['version'] ?? $block_version;202 203	$supports_interactivity_true = isset( $metadata['supports']['interactivity'] ) && true === $metadata['supports']['interactivity'];204	$is_interactive              = $supports_interactivity_true || ( isset( $metadata['supports']['interactivity']['interactive'] ) && true === $metadata['supports']['interactivity']['interactive'] );205	$supports_client_navigation  = $supports_interactivity_true || ( isset( $metadata['supports']['interactivity']['clientNavigation'] ) && true === $metadata['supports']['interactivity']['clientNavigation'] );206 207	$args = array();208 209	// Blocks using the Interactivity API are server-side rendered, so they are210	// by design not in the critical rendering path and should be deprioritized.211	if ( $is_interactive ) {212		$args['fetchpriority'] = 'low';213		$args['in_footer']     = true;214	}215 216	// Blocks using the Interactivity API that support client-side navigation217	// must be marked as such in their script modules.218	if ( $is_interactive && $supports_client_navigation ) {219		wp_interactivity()->add_client_navigation_support_to_script_module( $module_id );220	}221 222	wp_register_script_module(223		$module_id,224		$module_uri,225		$module_dependencies,226		$module_version,227		$args228	);229 230	return $module_id;231}