<?php
/**
 * Rooster admin chrome: the loader every product requires.
 *
 * The one chrome of the Rooster ecosystem (the brand bar, the menu bar with its pinnable destinations, the Home page,
 * the Ctrl+K palette, the settings renderer), built once in `source\rooster-admin` and deployed into each product
 * (`lib/rooster-admin/` of the theme, Rooster One and Rooster LMS; tools/deploy.ps1). Several copies may be on one
 * site: each one calls rooster_admin_register() with its version and folder, and the newest copy boots once, on
 * `init`, in the admin only (the pattern of Action Scheduler and WooCommerce's packages).
 *
 * A product requires this file on `plugins_loaded` (a theme on `after_setup_theme`), inside `if ( is_admin() )`:
 *
 *     if ( is_admin() ) {
 *         require_once __DIR__ . '/lib/rooster-admin/rooster-admin.php';
 *         rooster_admin_register( __DIR__ . '/lib/rooster-admin' );
 *         add_action( 'rooster/admin/register', 'my_product_register' );
 *     }
 *
 * Front-end cost: none. Without `is_admin()` the loader registers nothing: no hook, no file, no option, no cookie.
 *
 * @package RoosterAdmin
 */

defined( 'ABSPATH' ) || exit;

if ( ! function_exists( 'rooster_admin_register' ) ) {
	/**
	 * Registers a copy of the library. The copy with the highest version boots on `init` (priority 5), in the admin
	 * only. Calls after `init` are ignored.
	 *
	 * @param string $dir     The copy's folder (holds rooster-admin.php, version.php, includes/, assets/, data/).
	 * @param string $version The copy's version; read from the folder's version.php when ''.
	 * @param string $url     The copy's URL (a plugin: plugins_url( 'lib/rooster-admin', __FILE__ ); a theme:
	 *                        get_template_directory_uri() . '/lib/rooster-admin'); '' = worked out from the folder.
	 */
	function rooster_admin_register( string $dir, string $version = '', string $url = '' ): void {
		// Every copy is noted, whatever the request (0.63.0): a passive list, no hook, read only when a table asks for the
		// builders outside a chrome screen (rooster_admin_builders(): a remote table's route, a storefront table).
		$noted = rtrim( str_replace( '\\', '/', $dir ), '/' );
		if ( is_file( $noted . '/includes/Library.php' ) ) {
			$read   = '' === $version && is_file( $noted . '/version.php' ) ? include $noted . '/version.php' : $version;
			$copies = is_array( $GLOBALS['rooster_admin_copies'] ?? null ) ? $GLOBALS['rooster_admin_copies'] : array();
			if ( is_string( $read ) && 1 === preg_match( '/^\d+\.\d+\.\d+/', $read ) ) {
				$copies[ $noted ]                = array( $read, $url );
				$GLOBALS['rooster_admin_copies'] = $copies; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- the loader's own global.
			}
		}
		// A consumer's REST context loads during `rest_api_init` (after `init`): the copy is recorded for the
		// preferences route, which the newest copy registers at the end of that action, for signed-in users only.
		$rest = doing_action( 'rest_api_init' );
		if ( ! $rest && ( ! is_admin() || did_action( 'init' ) ) ) {
			return;
		}
		$dir = rtrim( str_replace( '\\', '/', $dir ), '/' );
		if ( ! is_file( $dir . '/includes/Library.php' ) ) {
			return;
		}
		if ( '' === $version && is_file( $dir . '/version.php' ) ) {
			$read    = include $dir . '/version.php';
			$version = is_string( $read ) ? $read : '';
		}
		if ( 1 !== preg_match( '/^\d+\.\d+\.\d+/', $version ) ) {
			return;
		}
		$candidates = $GLOBALS['rooster_admin_candidates'] ?? array();
		if ( ! is_array( $candidates ) ) {
			$candidates = array();
		}
		$candidates[ $dir ]                   = $version;
		$GLOBALS['rooster_admin_candidates'] = $candidates; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- the loader's own global.
		if ( '' !== $url ) {
			$urls                           = $GLOBALS['rooster_admin_urls'] ?? array();
			$urls[ $dir ]                   = $url;
			$GLOBALS['rooster_admin_urls'] = $urls; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- the loader's own global.
		}
		if ( $rest ) {
			if ( ! has_action( 'rest_api_init', 'rooster_admin_rest' ) ) {
				add_action( 'rest_api_init', 'rooster_admin_rest', 99 );
			}
			return;
		}
		if ( ! has_action( 'init', 'rooster_admin_boot' ) ) {
			add_action( 'init', 'rooster_admin_boot', 5 );
		}
	}
}

if ( ! function_exists( 'rooster_admin_loaded' ) ) {
	/**
	 * The folder of the copy whose classes this process already holds ('' before any is loaded), as it was registered.
	 * Once a copy's Library.php is in, that copy serves every later call of the request, whatever copy registers after
	 * it: WooCommerce's dashboard serves a REST request inside the admin request (rest_do_request), where a plugin's
	 * REST context registered a newer copy after the admin's older one had booted, and loading the newer copy's classes
	 * too declared the library twice (0.75.2, 31 Oct 2026).
	 */
	function rooster_admin_loaded(): string {
		if ( ! class_exists( '\Rooster\Admin\Library', false ) ) {
			return '';
		}
		$file = (string) ( new \ReflectionClass( '\Rooster\Admin\Library' ) )->getFileName();
		// Library.php sits in the copy's includes/ folder: the copy's folder is cut from that path as a string (a
		// wordpress.org review gate rejects a dirname() that climbs levels, 1 Nov 2026).
		$dir = rtrim( str_replace( '\\', '/', dirname( $file ) ), '/' );
		if ( str_ends_with( $dir, '/includes' ) ) {
			$dir = substr( $dir, 0, -9 );
		}
		$real = rtrim( str_replace( '\\', '/', (string) realpath( $dir ) ), '/' );
		// The registered folder may reach the copy through a junction or a symbolic link while PHP names the included
		// file by its real path: the two are compared as real paths, and the registered spelling is what is returned
		// (the URLs are keyed by it).
		foreach ( array( 'rooster_admin_candidates', 'rooster_admin_copies' ) as $list ) {
			$known = is_array( $GLOBALS[ $list ] ?? null ) ? array_keys( $GLOBALS[ $list ] ) : array();
			foreach ( $known as $registered ) {
				$spelled = rtrim( str_replace( '\\', '/', (string) $registered ), '/' );
				if ( $spelled === $dir || ( '' !== $real && rtrim( str_replace( '\\', '/', (string) realpath( $spelled ) ), '/' ) === $real ) ) {
					return (string) $registered;
				}
			}
		}
		return $dir;
	}
}

if ( ! function_exists( 'rooster_admin_rest' ) ) {
	/**
	 * Hook rest_api_init (99): the newest registered copy registers the preferences route, for a signed-in user only,
	 * unless a copy is already in this process (rooster_admin_loaded()), which then serves it. A visitor's REST request
	 * registers nothing; a page never reaches this.
	 */
	function rooster_admin_rest(): void {
		if ( ! is_user_logged_in() ) {
			return;
		}
		$dir = rooster_admin_loaded();
		if ( '' === $dir ) {
			$candidates = $GLOBALS['rooster_admin_candidates'] ?? array();
			$dir        = is_array( $candidates ) ? rooster_admin_newest( $candidates ) : '';
			if ( '' === $dir ) {
				return;
			}
			require_once $dir . '/includes/Library.php';
		}
		$urls = $GLOBALS['rooster_admin_urls'] ?? array();
		\Rooster\Admin\Library::rest( $dir, is_array( $urls ) && is_string( $urls[ $dir ] ?? null ) ? $urls[ $dir ] : '' );
	}
}

if ( ! function_exists( 'rooster_admin_builders' ) ) {
	/**
	 * The library's builders outside a chrome screen (0.63.0, CONTRACT §8.2): Ui::table(), Ui::rows(), Ui::answer(), the
	 * fields and the states, for a remote table's route (REST, admin-ajax) and a storefront table. The newest noted copy
	 * loads its builder classes on demand; nothing else boots (no registry, no chrome). On the storefront the icons the
	 * table drew get their sprite in the footer. A storefront table's scripts are rooster_table_engine()'s.
	 *
	 * @return bool Whether the builders are there (false: no copy of the library is registered).
	 */
	function rooster_admin_builders(): bool {
		if ( class_exists( '\\Rooster\\Admin\\Ui', false ) ) {
			return true;
		}
		$copies = is_array( $GLOBALS['rooster_admin_copies'] ?? null ) ? $GLOBALS['rooster_admin_copies'] : array();
		$dir    = rooster_admin_loaded();
		if ( '' === $dir ) {
			$dir = rooster_admin_newest( array_map( static fn( array $copy ): string => (string) $copy[0], $copies ) );
			if ( '' === $dir ) {
				return false;
			}
			require_once $dir . '/includes/Library.php';
		}
		\Rooster\Admin\Library::builders( $dir, (string) ( $copies[ $dir ][1] ?? '' ) );
		return true;
	}
}

if ( ! function_exists( 'rooster_admin_newest' ) ) {
	/**
	 * The folder of the newest registered copy ('' without any): the highest version; of equal versions, the first
	 * registered.
	 *
	 * @param array<string, string> $candidates Folder => version.
	 */
	function rooster_admin_newest( array $candidates ): string {
		$best    = '';
		$version = '';
		foreach ( $candidates as $dir => $candidate ) {
			if ( '' === $best || version_compare( (string) $candidate, $version, '>' ) ) {
				$best    = (string) $dir;
				$version = (string) $candidate;
			}
		}
		return $best;
	}
}

if ( ! function_exists( 'rooster_admin_skips_boot' ) ) {
	/**
	 * Whether an admin request boots no chrome: a visitor's admin-ajax request (a cart add, a booking widget) never
	 * draws it, and the boot cost each one 30 to 34 ms (rooster-one-72, 29 Oct 2026). A signed-in user's AJAX keeps the
	 * boot (the admin's screens call back); a table a visitor's request renders asks for rooster_admin_builders(), which
	 * needs no boot.
	 */
	function rooster_admin_skips_boot(): bool {
		return wp_doing_ajax() && ! is_user_logged_in();
	}
}

if ( ! function_exists( 'rooster_admin_boot' ) ) {
	/**
	 * Hook init (5): boots the newest registered copy once, unless the request draws no chrome
	 * (rooster_admin_skips_boot()).
	 */
	function rooster_admin_boot(): void {
		if ( rooster_admin_skips_boot() ) {
			return;
		}
		if ( class_exists( '\Rooster\Admin\Library', false ) && \Rooster\Admin\Library::booted() ) {
			return;
		}
		$dir = rooster_admin_loaded();
		if ( '' === $dir ) {
			$candidates = $GLOBALS['rooster_admin_candidates'] ?? array();
			$dir        = is_array( $candidates ) ? rooster_admin_newest( $candidates ) : '';
			if ( '' === $dir ) {
				return;
			}
			require_once $dir . '/includes/Library.php';
		}
		$urls = $GLOBALS['rooster_admin_urls'] ?? array();
		\Rooster\Admin\Library::boot( $dir, is_array( $urls ) && is_string( $urls[ $dir ] ?? null ) ? $urls[ $dir ] : '' );
	}
}

/*
 * The view nonce (0.69.0, the wordpress.org review: every read of a request argument is in a function that checks a
 * nonce). A Rooster screen's view arguments (its tab, filters, search, sort, page number, the object it shows) are
 * read only when the address carries `rooster_view`, a nonce of the action `rooster_admin_view`, one for every screen of
 * every product; without it the screen shows its default view. These two names are the contract (docs/CONTRACT.md):
 * a product that builds a link to a Rooster screen where the library is not loaded computes the same nonce itself.
 */
if ( ! function_exists( 'rooster_admin_view_url' ) ) {
	/**
	 * $url with the current user's view nonce (added, or put in place of an older one), the rest of the address as it
	 * was: appended before the fragment, never through add_query_arg(), which would re-encode a template's `%d`.
	 *
	 * @param string $url An admin address (not escaped: the caller escapes it where it prints it).
	 */
	function rooster_admin_view_url( string $url ): string {
		$hash     = strpos( $url, '#' );
		$fragment = false === $hash ? '' : substr( $url, $hash );
		$url      = false === $hash ? $url : substr( $url, 0, $hash );
		$url      = rtrim( (string) preg_replace( '/([?&])rooster_view=[^&]*(?:&|$)/', '$1', $url ), '?&' );
		return $url . ( str_contains( $url, '?' ) ? '&' : '?' ) . 'rooster_view=' . rawurlencode( wp_create_nonce( 'rooster_admin_view' ) ) . $fragment;
	}
}

if ( ! function_exists( 'rooster_admin_view_field' ) ) {
	/**
	 * The hidden field that carries the view nonce in a GET form to a Rooster screen (a filter bar, a search box).
	 */
	function rooster_admin_view_field(): string {
		return '<input type="hidden" name="rooster_view" value="' . esc_attr( wp_create_nonce( 'rooster_admin_view' ) ) . '" />';
	}
}

if ( ! function_exists( 'rooster_admin' ) ) {
	/**
	 * The booted library's registry, or null before `init` or outside the admin.
	 *
	 * @return \Rooster\Admin\Registry|null
	 */
	function rooster_admin(): ?\Rooster\Admin\Registry {
		return class_exists( '\Rooster\Admin\Library', false ) ? \Rooster\Admin\Library::registry() : null;
	}
}