<?php
/**
 * The helpers functions file houses any necessary PHP functions for the theme.
 *
 * @author    Nathan Wallace
 * @copyright Copyright (c) 2023, Nathan Wallace
 * @license   https://www.gnu.org/licenses/gpl-2.0.html GPL-2.0-or-later
 * @link      https://wallacecreative.agency
 */

namespace Anselm;

use Anselm\Contracts\Bootable;

/**
 * Mini container used to reference the various theme components. Bootstraps the
 * theme on first call by executing each component's `boot()` method. The
 * `theme()` function acts as the single instance of the theme, and devs can
 * access any class/component by passing in its reference via the `$component`
 * parameter (useful for accessing hooks within classes).
 *
 * @since  1.0.0
 * @return mixed
 * @todo   Add `mixed` return type declaration with PHP 8-only support.
 */
function theme( string $component = '' )
{
	static $bindings = [];

	// If there are no bound components, register and boot them.
	if ( [] === $bindings ) {

		// Bind instances of the theme's component classes that need to
		// be booted when the theme launches.
		$bindings = apply_filters( 'anselm/features/components', [
			'assets'         => new Assets(),
			'patterns'       => new Patterns(),
			'template-parts' => new TemplateParts(),
			'templates'      => new Templates(),
			'image-sizes'    => new ImageSizes(),
			'theme-config'   => new ThemeConfig()
		] );

		// Boot each of the components.
		foreach ( $bindings as $binding ) {
			if ( $binding instanceof Bootable ) {
				$binding->boot();
			}
		}
	}

	return '' === $component ? $bindings : $bindings[ $component ];
}