<?php
/**
 * The library's boot: the hooks of the chrome, the Home pages, the settings screens, the palette, the preferences
 * handler and the ecosystem toolbar node. Booted once by rooster_admin_boot() on `init`, in the admin only; every hook
 * below runs for admin screens and admin-ajax requests only, never for a visitor (the loader never registers outside
 * `is_admin()`).
 *
 * @package RoosterAdmin
 */

namespace Rooster\Admin;

defined( 'ABSPATH' ) || exit;

/**
 * Static boot.
 */
final class Library {

	/**
	 * This copy's version. Bump it with every change: the newest copy on a site wins (rooster-admin.php).
	 */
	public const VERSION = '0.89.3';

	/**
	 * The style and script handle of the chrome.
	 */
	public const HANDLE = 'rooster-admin-chrome';

	/**
	 * The view nonce's script (0.69.0, assets/view.js), on every admin screen.
	 */
	public const VIEW_HANDLE = 'rooster-admin-view';

	/**
	 * The booted copy's folder (no trailing slash).
	 *
	 * @var string
	 */
	private static string $dir = '';

	/**
	 * The booted copy's URL (no trailing slash).
	 *
	 * @var string
	 */
	private static string $url = '';

	/**
	 * The registry.
	 *
	 * @var Registry|null
	 */
	private static ?Registry $registry = null;

	/**
	 * Boots the library from a folder: loads the classes, collects the products, adds the hooks.
	 *
	 * @param string $dir The copy's folder.
	 * @param string $url The copy's URL ('' = worked out from the folder, url_of()).
	 */
	public static function boot( string $dir, string $url = '' ): void {
		// A visitor's admin-ajax request draws no chrome (the loader's rooster_admin_skips_boot()); checked here too,
		// for a consumer whose older loader copy defined rooster_admin_boot() first.
		if ( null !== self::$registry || ( wp_doing_ajax() && ! is_user_logged_in() ) ) {
			return;
		}
		self::registry_boot( $dir, $url );
		add_action( 'admin_menu', array( HomePage::class, 'admin_menu' ), 9 );
		add_action( 'admin_menu', array( SettingsScreen::class, 'admin_menu' ), 9 );
		add_action( 'admin_enqueue_scripts', array( HomePage::class, 'enqueue_menu_css' ) ); // the side menu's wordmarks and icon colours, on every admin screen
		add_filter( 'custom_menu_order', array( HomePage::class, 'custom_menu_order' ) );
		add_filter( 'menu_order', array( HomePage::class, 'menu_order' ), 100 ); // a Home under the item it names (home.after); late, after the products' own reordering (the LMS's runs at 20)
		add_action( 'admin_head', array( self::class, 'early_scheme' ), 0 ); // the dark canvas before the first paint (0.44.0)
		add_action( 'in_admin_header', array( Chrome::class, 'print' ) );
		add_action( 'admin_enqueue_scripts', array( self::class, 'enqueue' ), 20 );
		add_action( 'admin_footer', array( Chrome::class, 'palette' ) );
		add_action( 'admin_footer', array( Chrome::class, 'dialogs' ) ); // the feedback dialog and the welcome (0.20.0)
		add_action( 'admin_footer', array( Chrome::class, 'speculation_rules' ) );
		add_action( 'admin_footer', array( Icons::class, 'print_sprite' ), 99 ); // after every icon of the page was asked for
		add_filter( 'admin_body_class', array( self::class, 'body_class' ) );
		add_action( 'admin_bar_menu', array( Toolbar::class, 'add' ), 41 );
		add_action( 'admin_enqueue_scripts', array( Toolbar::class, 'style' ) ); // the node's icon on the toolbar's line (0.89.1)
		foreach ( array( 'activated_plugin', 'deactivated_plugin', 'switch_theme' ) as $hook ) { // the products may have changed
			add_action( $hook, array( Toolbar::class, 'forget' ) );
		}
		add_filter( 'admin_body_class', array( Guidance::class, 'body_class' ) ); // the guidance level (0.61.0)
		add_action( 'admin_enqueue_scripts', array( Guidance::class, 'enqueue' ), 21 );
		foreach ( array( 'admin_notices', 'network_admin_notices', 'user_admin_notices' ) as $hook ) { // the notices where the scripts would move them (0.86.0)
			add_action( $hook, array( Notices::class, 'hold' ), PHP_INT_MIN );
		}
		add_action( 'all_admin_notices', array( Notices::class, 'hold' ), PHP_INT_MAX );
		add_action( 'in_admin_footer', array( Notices::class, 'finish' ), PHP_INT_MIN );
	}

	/**
	 * A REST request (the loader's rooster_admin_rest(), on `rest_api_init` at 99, for a signed-in user): the
	 * preferences and feedback routes alone, two small classes (the feedback handler boots the registry); the registry boots the first time a request reaches the route
	 * (ensure_registry()), never on `rest_api_init` itself. No URL is worked out: a REST request serves no asset.
	 *
	 * @param string $dir The copy's folder.
	 * @param string $url The copy's URL ('' = none).
	 */
	public static function rest( string $dir, string $url = '' ): void {
		self::$dir = rtrim( str_replace( '\\', '/', $dir ), '/' );
		self::$url = rtrim( $url, '/' );
		require_once self::$dir . '/includes/Prefs.php';
		require_once self::$dir . '/includes/Rest.php';
		Rest::routes();
	}

	/**
	 * The builders alone (0.63.0, rooster_admin_builders()): the classes a table, a field or a state needs, without the
	 * registry or the chrome, for a remote table's route and a storefront table; on the storefront, the sprite of the
	 * icons drawn, in the footer.
	 *
	 * @param string $dir The copy's folder.
	 * @param string $url The copy's URL ('' = worked out from the folder).
	 */
	public static function builders( string $dir, string $url = '' ): void {
		if ( '' === self::$dir ) {
			self::$dir = rtrim( str_replace( '\\', '/', $dir ), '/' );
			self::$url = '' !== $url ? rtrim( $url, '/' ) : self::url_of( self::$dir );
		}
		// 0.76.1: Export too, so a path that loads the builders alone (WP-CLI, a route that never boots the registry) finds
		// the export's writer (Rooster One's report export, 2 Nov 2026).
		foreach ( array( 'Colour', 'Markup', 'Icons', 'Prefs', 'Request', 'Ui', 'Fields', 'States', 'Guidance', 'Filters', 'Export' ) as $class ) {
			require_once self::$dir . '/includes/' . $class . '.php';
		}
		self::front_sprite();
	}

	/**
	 * On the storefront, the sprite of the icons the theme lacks, once, in the footer (0.63.0: a table asked; 0.75.0:
	 * the front application entry asks too, for a screen whose builders were loaded earlier in the request).
	 */
	public static function front_sprite(): void {
		if ( Icons::storefront() && ! has_action( 'wp_footer', array( Icons::class, 'print_front_sprite' ) ) ) {
			add_action( 'wp_footer', array( Icons::class, 'print_front_sprite' ), 99 );
		}
	}

	/**
	 * The registry, booted now when it is not yet (a REST handler): the classes, the products' registrations.
	 */
	public static function ensure_registry(): Registry {
		if ( null === self::$registry ) {
			self::registry_boot( self::$dir, self::$url );
		}
		return self::$registry;
	}

	/**
	 * The classes, the registry and the products' registrations, for the admin and a REST handler alike.
	 *
	 * @param string $dir The copy's folder.
	 * @param string $url The copy's URL ('' = worked out from the folder, url_of()).
	 */
	private static function registry_boot( string $dir, string $url ): void {
		self::$dir = rtrim( str_replace( '\\', '/', $dir ), '/' );
		self::$url = '' !== $url ? rtrim( $url, '/' ) : self::url_of( self::$dir );
		foreach ( array( 'Colour', 'Markup', 'Icons', 'Prefs', 'Request', 'Personas', 'Registry', 'Chrome', 'HomePage', 'SettingsScreen', 'Toolbar', 'Rest', 'Feedback', 'Welcome', 'Ui', 'Board', 'Fields', 'States', 'Guidance', 'Filters', 'Export', 'Notices' ) as $class ) { // 0.76.0: Export, a table's export (admin-post and admin-ajax handlers run here); 0.86.0: Notices
			require_once self::$dir . '/includes/' . $class . '.php';
		}
		require_once self::$dir . '/includes/helpers.php';
		require_once self::$dir . '/includes/adapters/RoosterLms.php';
		require_once self::$dir . '/includes/adapters/RoosterOne.php';
		Adapters\RoosterLms::register(); // the bridges to the LMS's data until the LMS consumes the library (E); Rooster One's adapter waits for D
		self::$registry = new Registry();
		/**
		 * Fires once the library is ready: each product registers itself, its catalogue entries, its settings screens
		 * and its Home cards (docs/CONTRACT.md).
		 *
		 * @since 0.1.0
		 *
		 * @param Registry $registry The registry.
		 */
		do_action( 'rooster/admin/register', self::$registry );
		// The catalogue is validated on its first read (Registry::ready()): a screen without the chrome never pays.
	}

	/**
	 * The registry (null before boot).
	 */
	public static function registry(): ?Registry {
		return self::$registry;
	}

	/**
	 * The product a storefront screen belongs to (0.75.0, rooster_admin_front()'s `product`).
	 *
	 * @var string
	 */
	private static string $front_product = '';

	/**
	 * Names the storefront screen's product (0.75.0): the slug a preference kept per product (a board's arrangement, a
	 * layout's windows) is read and saved under where no registry is booted.
	 *
	 * @param string $slug The product's slug ('' for none).
	 */
	public static function front_product( string $slug ): void {
		self::$front_product = sanitize_key( $slug );
	}

	/**
	 * The product of this request (0.75.0): the registry's current product in the admin (the screen's), else the one the
	 * front entry named on the storefront (where no registry boots; a registry that names no product, a REST context's,
	 * defers to it too), else ''. Board::saved() and Ui::windows() read their preferences under it.
	 */
	public static function product(): string {
		$product = null !== self::$registry ? self::$registry->current_product() : '';
		return '' !== $product ? $product : self::$front_product;
	}

	/**
	 * A fresh registry, the products registered again (a consumer's tests, after they changed what their product
	 * registers: the LMS's fixtures add rows to its own registry and forget it). Null before boot.
	 *
	 * @internal Tests.
	 */
	public static function rebuild(): ?Registry {
		if ( null === self::$registry ) {
			return null;
		}
		self::$registry = new Registry();
		do_action( 'rooster/admin/register', self::$registry );
		Prefs::forget();
		return self::$registry;
	}

	/**
	 * Whether boot() ran.
	 */
	public static function booted(): bool {
		return null !== self::$registry;
	}

	/**
	 * The booted copy's folder.
	 */
	public static function dir(): string {
		return self::$dir;
	}

	/**
	 * The booted copy's URL.
	 */
	public static function url(): string {
		return self::$url;
	}

	/**
	 * The URL of an asset of the booted copy.
	 *
	 * @param string $path Path under the copy's folder ('assets/chrome.css').
	 */
	public static function asset( string $path ): string {
		return self::$url . '/' . ltrim( $path, '/' );
	}

	/**
	 * The URL of a copy's folder, by the folder's path, as WordPress's own functions give it (wordpress.org review 4: no
	 * folder constant): a copy in the active theme or its parent from get_stylesheet_directory_uri() /
	 * get_template_directory_uri() (the theme folder's real path too, a junction or symlink on a development site); a
	 * copy in a plugin or a must-use plugin from plugins_url() with the copy's own loader file, which follows a symlinked
	 * plugin folder through WordPress's registered real paths. A consumer that knows its URL passes it to
	 * rooster_admin_register() instead.
	 *
	 * @param string $dir Folder.
	 */
	public static function url_of( string $dir ): string {
		$dir    = rtrim( wp_normalize_path( $dir ), '/' );
		$real   = rtrim( wp_normalize_path( (string) realpath( $dir ) ), '/' );
		$themes = array(
			array( get_stylesheet_directory(), get_stylesheet_directory_uri() ),
			array( get_template_directory(), get_template_directory_uri() ),
		);
		foreach ( $themes as [ $root, $url ] ) {
			$url = rtrim( $url, '/' );
			foreach ( array_unique( array( rtrim( wp_normalize_path( $root ), '/' ), rtrim( wp_normalize_path( (string) realpath( $root ) ), '/' ) ) ) as $candidate ) {
				foreach ( array( $dir, $real ) as $path ) {
					if ( '' !== $candidate && '' !== $path && str_starts_with( $path . '/', $candidate . '/' ) ) {
						return $url . substr( $path, strlen( $candidate ) );
					}
				}
			}
		}
		return rtrim( plugins_url( '', $dir . '/rooster-admin.php' ), '/' );
	}

	/**
	 * Filter admin_body_class: a class on the chrome's screens (the chrome's spacing), with the product's slug.
	 *
	 * @param mixed $classes Space-separated classes.
	 */
	public static function body_class( $classes ): string {
		$classes = is_string( $classes ) ? $classes : '';
		$product = self::$registry ? self::$registry->current_product() : '';
		if ( '' === $product ) {
			return $classes;
		}
		$theme = Prefs::theme( get_current_user_id() ); // the scheme (0.24.0): light by default, the dark class, or the device's
		return $classes . ' rooster-admin-has-chrome rooster-admin-product-' . sanitize_html_class( $product ) . ( 'dark' === $theme ? ' rooster-admin-dark' : ( 'auto' === $theme ? ' rooster-admin-scheme-auto' : '' ) );
	}

	/**
	 * Hook admin_head (0): on a chrome screen whose user chose the dark scheme (or the device's), the document's
	 * colour scheme, so a page load never flashes a white canvas between two dark screens (0.44.0; the owner: "the whole
	 * page flickers on reload"). Nothing on a light screen, nothing off the chrome. The canvas's own colour is
	 * scheme_css(), the chrome stylesheet's inline style (0.81.0, the wordpress.org review: no style element echoed).
	 */
	public static function early_scheme(): void {
		if ( null === self::$registry || '' === self::$registry->current_product() ) {
			return;
		}
		$theme = Prefs::theme( get_current_user_id() );
		if ( 'dark' === $theme || 'auto' === $theme ) {
			printf( '<meta name="color-scheme" content="%s" />' . "\n", esc_attr( 'dark' === $theme ? 'dark' : 'light dark' ) );
		}
	}

	/**
	 * The dark canvas of a scheme (0.81.0): the document's background before the chrome's own rules paint the page, for
	 * the dark scheme, or for the device's when it is dark; '' for the light one.
	 *
	 * @param string $theme Prefs::theme(): light, dark or auto.
	 */
	public static function scheme_css( string $theme ): string {
		if ( 'dark' === $theme ) {
			return 'html{background:#09090b}';
		}
		return 'auto' === $theme ? '@media (prefers-color-scheme: dark){html{background:#09090b}}' : '';
	}

	/**
	 * Whether this admin screen is a Rooster page (0.81.0): a screen of a registered product (the chrome's), or a page
	 * of one that draws without the chrome (its Home, a page a catalogue entry names). The library's assets that are not
	 * a table's (the side menu's colours, the view nonce's script) load there and nowhere else.
	 */
	public static function rooster_page(): bool {
		if ( null === self::$registry ) {
			return false;
		}
		if ( '' !== self::$registry->current_product() ) {
			return true;
		}
		$page = isset( $GLOBALS['plugin_page'] ) && is_string( $GLOBALS['plugin_page'] ) ? $GLOBALS['plugin_page'] : '';
		return '' !== $page && in_array( $page, Request::pages( self::$registry ), true );
	}

	/**
	 * The suffix of the shipped assets: the minified twins tools/build.mjs writes (`.min`, each with its sourcemap)
	 * unless SCRIPT_DEBUG asks for the readable files.
	 */
	public static function suffix(): string {
		return defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
	}

	/**
	 * Hook admin_enqueue_scripts (20): the chrome's style and script with its data, on the chrome's screens only
	 * (never on other admin screens, never in the block editor, never on the front end).
	 */
	public static function enqueue(): void {
		$registry = self::$registry;
		if ( null === $registry ) {
			return;
		}
		self::register_assets(); // 0.65.1: on every admin screen, registration only (a library table off the chrome brings what it needs)
		// 0.69.0: the view nonce on links and GET forms to a Rooster page: assets/view.js, 1 KB, with its data. 0.81.0 (the
		// wordpress.org review: a plugin's scripts only on the screens that need them): on a Rooster page, and on another
		// screen only when a product says its links into Rooster pages are there (rooster_admin_view_script).
		$view = Request::view_data( $registry );
		/**
		 * Filters whether this admin screen loads the view nonce's script (assets/view.js), which gives a link or a GET
		 * form to a Rooster page the person's view nonce when it is followed or sent. On by default on the Rooster pages
		 * themselves; a product turns it on for another screen where it prints links into its pages with view arguments
		 * that it did not sign with rooster_admin_view_url() (a row action on a WordPress list, a meta box).
		 *
		 * @since 0.81.0
		 *
		 * @param bool            $load   Whether to load it.
		 * @param \WP_Screen|null $screen The current screen.
		 */
		if ( (bool) apply_filters( 'rooster_admin_view_script', self::rooster_page(), function_exists( 'get_current_screen' ) ? get_current_screen() : null ) ) {
			wp_enqueue_script(
				self::VIEW_HANDLE,
				self::asset( 'assets/view' . self::suffix() . '.js' ),
				array(),
				self::VERSION,
				array(
					'in_footer' => true,
					'strategy'  => 'defer',
				)
			);
			wp_add_inline_script( self::VIEW_HANDLE, 'var roosterAdminView = ' . wp_json_encode( $view, JSON_HEX_TAG | JSON_HEX_AMP ) . ';', 'before' );
		}
		if ( '' === $registry->current_product() ) {
			return;
		}
		wp_enqueue_style( self::HANDLE, self::asset( 'assets/chrome' . self::suffix() . '.css' ), array(), self::VERSION );
		wp_add_inline_style( self::HANDLE, wp_strip_all_tags( Colour::css( $registry ) ) ); // every value checked where it enters the registry (Colour::hex(), the keys' pattern, esc_url_raw())
		$canvas = self::scheme_css( Prefs::theme( get_current_user_id() ) );
		if ( '' !== $canvas ) {
			wp_add_inline_style( self::HANDLE, $canvas ); // the dark canvas (early_scheme() prints its meta)
		}
		// The screen's product's adoption layer (its alias file, compiled on its own: 0.31.0), after the chrome; only that
		// one (0.45.4: every registered product's loaded on every chrome screen, Rooster One's 67 KB on an LMS screen).
		$slug = $registry->current_product();
		$file = 'assets/adopt-' . $slug . self::suffix() . '.css';
		if ( is_file( self::$dir . '/' . $file ) ) {
			wp_enqueue_style( self::HANDLE . '-' . $slug, self::asset( $file ), array( self::HANDLE ), self::VERSION );
		}
		if ( SettingsScreen::is_current() ) {
			wp_enqueue_style( 'wp-color-picker' );
			wp_enqueue_script( 'wp-color-picker' );
			$chrome = wp_scripts()->query( self::HANDLE ); // registered above for every screen: the colour picker comes first here
			if ( $chrome && ! in_array( 'wp-color-picker', $chrome->deps, true ) ) {
				$chrome->deps[] = 'wp-color-picker';
			}
		}
		wp_enqueue_script( self::HANDLE );
		wp_add_inline_script( self::HANDLE, 'var roosterAdminChrome = ' . wp_json_encode( Chrome::script_data( $registry ), JSON_HEX_TAG | JSON_HEX_AMP ) . ';', 'before' );
		// The local table (0.48.1): a product's table engine answers a filter change from the rows on the page.
		wp_enqueue_script( 'rooster-admin-table' );
		// The searchable select (0.36.0): every native select on a chrome screen becomes the kit's combobox.
		wp_enqueue_script(
			'rooster-admin-select',
			self::asset( 'assets/select' . self::suffix() . '.js' ),
			array( self::HANDLE ),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
	}

	/**
	 * The table's assets registered (0.65.1), on every admin screen: the chrome's stylesheet and script, the engine and
	 * what a table may ask for (its editor, its local glue, the filter controls, the board's moves, the field patterns).
	 * Registration prints nothing; a screen pays only for what a builder enqueues.
	 */
	private static function register_assets(): void {
		if ( wp_script_is( 'rooster-admin-table', 'registered' ) ) {
			return;
		}
		wp_register_style( self::HANDLE, self::asset( 'assets/chrome' . self::suffix() . '.css' ), array(), self::VERSION );
		wp_register_script(
			self::HANDLE,
			self::asset( 'assets/chrome' . self::suffix() . '.js' ),
			array(),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		wp_register_script(
			'rooster-admin-table',
			self::asset( 'assets/table' . self::suffix() . '.js' ),
			array(),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		// The table's script twin (0.74.0, TABLES-PLAN 1e): Ui::table() and Ui::rows() for a script, joining the kit's
		// twins (roosterAdmin.ui, the chrome's script); registered here, loaded by a screen whose script draws tables
		// (table_assets( array( 'twin' ) )), so the common path pays nothing for it.
		wp_register_script(
			'rooster-admin-table-twin',
			self::asset( 'assets/table-twin' . self::suffix() . '.js' ),
			array( self::HANDLE ),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		// Editable cells (0.52.0): the engine's editor, registered here and loaded by the first Ui::editable() a screen
		// prints, so a screen without an editable cell pays nothing for it.
		wp_register_script(
			'rooster-admin-table-edit',
			self::asset( 'assets/table-edit' . self::suffix() . '.js' ),
			array( 'rooster-admin-table' ),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		// The local table's glue (0.62.0): registered here and loaded by the first Ui::table() a screen prints with `local`.
		wp_register_script(
			'rooster-admin-table-local',
			self::asset( 'assets/table-local' . self::suffix() . '.js' ),
			array( 'rooster-admin-table' ),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		// A live table's totals row (0.65.7, out of the glue): after the glue, whose view event it follows; loaded by the
		// first Ui::table() a screen prints with totals and local or remote.
		wp_register_script(
			'rooster-admin-table-totals',
			self::asset( 'assets/table-totals' . self::suffix() . '.js' ),
			array( 'rooster-admin-table-local' ),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		// A declared filter's counts (0.65.6, Filters' `counts`): after the glue, whose events it follows; loaded by the
		// first filter a screen prints that counts, so a table without one pays nothing for it.
		wp_register_script(
			'rooster-admin-table-counts',
			self::asset( 'assets/table-counts' . self::suffix() . '.js' ),
			array( 'rooster-admin-table-local' ),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		// The filter controls (0.64.4, Filters): the calendar, the presets, the slider and the buckets; registered here and
		// loaded by the first one a screen prints. It depends on nothing: its twin on the front end is the same file.
		wp_register_style( Filters::HANDLE, self::asset( 'assets/filters' . self::suffix() . '.css' ), array( self::HANDLE ), self::VERSION ); // 0.65.0: its own stylesheet, with the script
		// A card per row (0.73.0, TABLES-PLAN 1d, Ui::table()'s `cards`): its own stylesheet, loaded by the first table that
		// asks for it (an opt-in for the lists that want it: the common path pays nothing).
		wp_register_style( 'rooster-admin-table-cards', self::asset( 'assets/table-cards' . self::suffix() . '.css' ), array( self::HANDLE ), self::VERSION );
		wp_register_script(
			Filters::HANDLE,
			self::asset( 'assets/filters' . self::suffix() . '.js' ),
			array(),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		// The page board's moves (0.58.0): registered here, enqueued by the first board a screen prints with something
		// to move (Board::html(), the Home's included), so a screen without one pays nothing for it.
		wp_register_script(
			'rooster-admin-board',
			self::asset( 'assets/board' . self::suffix() . '.js' ),
			array( self::HANDLE ),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		// A table's text size (0.68.0): one button cycles five sizes, kept per person and table; front-end safe (its twin
		// is rooster-table-size); loaded by the first button a screen prints, so a table without one pays nothing.
		wp_register_script(
			'rooster-admin-table-size',
			self::asset( 'assets/table-size' . self::suffix() . '.js' ),
			array(),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		// The side panel (0.46.0; its layouts since 0.67.0): docked at the start or the end, floating, folded; out of
		// chrome.js since 0.67.0, loaded by the first Ui::panel_open() a screen prints, so a screen without one pays nothing.
		wp_register_script(
			'rooster-admin-panel',
			self::asset( 'assets/panel' . self::suffix() . '.js' ),
			array( self::HANDLE ),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		// A page's windows (0.68.13, Ui::windows()): docked in their order, floating, folded; loaded by the first layout a
		// screen prints, so a screen without one pays nothing. Its rules decide the first paint, so they are chrome.css's.
		wp_register_script(
			'rooster-admin-windows',
			self::asset( 'assets/windows' . self::suffix() . '.js' ),
			array( self::HANDLE ),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		// A row's menu (0.79.0, Ui::row_menu()): its place and its keys, and its list's own stylesheet (the list is hidden
		// until opened, so it may come with the footer); loaded by the first menu a screen prints, or by table_assets(
		// array( 'row-menu' ) ) for a page whose rows come later. The script depends on nothing (off the chrome too).
		wp_register_style( 'rooster-admin-row-menu', self::asset( 'assets/row-menu' . self::suffix() . '.css' ), array( self::HANDLE ), self::VERSION );
		wp_register_script(
			'rooster-admin-row-menu',
			self::asset( 'assets/row-menu' . self::suffix() . '.js' ),
			array(),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		// The field patterns' behaviour (0.59.0, Fields): the colour field, the segmented switch's fallback, the secret's
		// Replace, the media picker; registered here, enqueued by the builder that prints one.
		wp_register_script(
			'rooster-admin-fields',
			self::asset( 'assets/fields' . self::suffix() . '.js' ),
			array( self::HANDLE ),
			self::VERSION,
			array(
				'in_footer' => true,
				'strategy'  => 'defer',
			)
		);
		require_once dirname( __DIR__ ) . '/table-engine.php'; // its words' function (functions only: nothing runs)
		wp_add_inline_script( 'rooster-admin-table-edit', 'window.roosterTableEditLabels = ' . wp_json_encode( rooster_table_edit_labels() ) . ';', 'before' );
	}

	/**
	 * Whether this request draws an admin screen without the chrome (0.65.1): a WooCommerce order, a post's editor, a
	 * core screen. A library table drawn there brings its own assets and sits in an island (Ui::table()).
	 */
	public static function off_chrome(): bool {
		return is_admin() && ! wp_doing_ajax() && did_action( 'admin_enqueue_scripts' ) > 0 && null !== self::$registry && '' === self::$registry->current_product();
	}

	/**
	 * A library table's assets on an admin screen without the chrome (0.65.1; rooster_admin_table_assets()): the
	 * chrome's stylesheet and the engine, with the parts named (local, edit, move, filters, counts, totals). Called on
	 * `admin_enqueue_scripts` for a screen that prints a table, they come in the head; a table that finds them missing
	 * enqueues them itself (printed with the page's footer then). On a chrome screen it adds only the parts.
	 *
	 * @param array<int, string> $parts local, edit, move, filters, counts (0.65.6), totals (0.65.7), cards (0.73.0: a
	 *                                  stylesheet alone, a list shown as a card per row), twin (0.74.0: the table's
	 *                                  script twin, roosterAdmin.ui.table(), for a screen whose script draws tables;
	 *                                  its own icons go into the page's sprite), row-menu (0.79.0: a row's
	 *                                  menu's script and stylesheet, for a page whose rows a script or a REST
	 *                                  answer draws later).
	 * @param array<int, string> $icons 0.74.0: the Lucide names a script's table draws (a cell's icon, an action's),
	 *                                  into the page's sprite (Icons::need()).
	 */
	public static function table_assets( array $parts = array(), array $icons = array() ): void {
		if ( ! self::island_style() ) {
			return;
		}
		wp_enqueue_script( 'rooster-admin-table' );
		$handles = array(
			'local'    => 'rooster-admin-table-local',
			'edit'     => 'rooster-admin-table-edit',
			'move'     => 'rooster-admin-board',
			'filters'  => Filters::HANDLE,
			'counts'   => 'rooster-admin-table-counts',
			'totals'   => 'rooster-admin-table-totals',
			'cards'    => 'rooster-admin-table-cards',
			'twin'     => 'rooster-admin-table-twin',
			'row-menu' => 'rooster-admin-row-menu',
		);
		foreach ( array_intersect_key( $handles, array_flip( $parts ) ) as $part => $handle ) {
			if ( 'cards' === $part ) {
				wp_enqueue_style( $handle ); // a stylesheet alone
				continue;
			}
			wp_enqueue_script( $handle );
			if ( 'filters' === $part || 'row-menu' === $part ) {
				wp_enqueue_style( $handle );
			}
		}
		if ( in_array( 'twin', $parts, true ) ) {
			Icons::need( array( 'chevron-down', 'check', 'minus' ) ); // the twin's own: a sort link's caret, a boolean's yes and no
		}
		if ( in_array( 'row-menu', $parts, true ) ) {
			Icons::need( array( 'ellipsis-vertical' ) ); // a row's menu's button, in rows drawn later
		}
		Icons::need( $icons );
		if ( in_array( 'move', $parts, true ) && '' === self::$registry->current_product() && ! self::$board_words ) {
			self::$board_words = true; // the chrome's data, which carries them, is not on this screen
			wp_add_inline_script( 'rooster-admin-board', 'window.roosterAdminBoardWords = ' . wp_json_encode( Chrome::board_words() ) . ';', 'before' );
		}
	}

	/**
	 * The chrome's stylesheet on an admin screen without the chrome (0.65.1): an island's tokens and recipes (a table,
	 * a box of facts). False outside the admin or before the library boots.
	 */
	public static function island_style(): bool {
		if ( null === self::$registry || ! is_admin() ) {
			return false;
		}
		self::register_assets();
		wp_enqueue_style( self::HANDLE );
		return true;
	}

	/**
	 * Whether the board's words were added for a screen without the chrome.
	 *
	 * @var bool
	 */
	private static bool $board_words = false;
}