<?php
/**
 * TurtleFramework integration for locally built WordPress admin assets.
 *
 * @package TurtleReport
 */

namespace TurtleReport\TurtleFramework;

defined( 'ABSPATH' ) || exit;

/** Reads the production build manifest; never contacts a development server. */
final class AdminAssets {

	/**
	 * Enqueues a built entry and its declared Core dependencies.
	 *
	 * @param string   $entry        Build entry name.
	 * @param string   $handle       WordPress script handle.
	 * @param string[] $dependencies Additional screen dependencies.
	 * @return bool Whether the entry was available.
	 */
	public static function enqueue( $entry, $handle, array $dependencies = array() ) {
		$path = TURTLEREPORT_DIR . 'assets/build/manifest.json';
		if ( ! is_readable( $path ) ) {
			return false;
		}
		// phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents -- Reads a trusted local build manifest; never a remote URL.
		$manifest = json_decode( (string) file_get_contents( $path ), true );
		$item     = is_array( $manifest ) && isset( $manifest[ $entry ] ) ? $manifest[ $entry ] : null;
		if ( ! is_array( $item ) || ! isset( $item['file'], $item['version'], $item['dependencies'] ) || ! self::valid_file( $item['file'], 'js' ) || ! is_array( $item['dependencies'] ) ) {
			return false;
		}
		$allowed = array( 'react', 'wp-element', 'wp-api-fetch', 'wp-i18n', 'wp-url' );
		foreach ( $item['dependencies'] as $dependency ) {
			if ( ! is_string( $dependency ) || ! in_array( $dependency, $allowed, true ) ) {
				return false;
			}
		}
		$styles = isset( $item['css'] ) && is_array( $item['css'] ) ? $item['css'] : array();
		foreach ( $styles as $css ) {
			if ( ! self::valid_file( $css, 'css' ) ) {
				return false;
			}
		}
		foreach ( $styles as $i => $css ) {
			wp_enqueue_style( $handle . '-' . $i, TURTLEREPORT_URL . 'assets/build/' . $css, array( 'turtlereport-shell' ), (string) $item['version'] );
		}
		wp_enqueue_script( $handle, TURTLEREPORT_URL . 'assets/build/' . $item['file'], array_values( array_unique( array_merge( $dependencies, $item['dependencies'] ) ) ), (string) $item['version'], true );
		wp_set_script_translations( $handle, 'turtlereport', TURTLEREPORT_DIR . 'languages' );
		return true;
	}

	/**
	 * Accepts generated files directly under the build directory only.
	 *
	 * @param mixed  $file      Manifest path.
	 * @param string $extension Expected extension.
	 * @return bool
	 */
	private static function valid_file( $file, $extension ) {
		return is_string( $file ) && preg_match( '/^[a-z0-9][a-z0-9._-]*\.' . $extension . '$/iD', $file ) && is_file( TURTLEREPORT_DIR . 'assets/build/' . $file ) && ! is_link( TURTLEREPORT_DIR . 'assets/build/' . $file );
	}
}