@wordpress/build 0.2.1-next.2f1c7c01b.0 → 0.3.0

package/templates/page.php.template

@@ -0,0 +1,311 @@
+<?php
+/**
+ * Page: {{PAGE_SLUG}}
+ * Auto-generated by build process.
+ * Do not edit this file manually.
+ *
+ * @package {{PREFIX}}
+ */
+
+// Global storage for {{PAGE_SLUG}} routes and menu items
+global ${{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_routes, ${{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_menu_items;
+${{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_routes = array();
+${{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_menu_items = array();
+
+if ( ! function_exists( 'register_{{PAGE_SLUG_UNDERSCORE}}_route' ) ) {
+	/**
+	 * Register a route for the {{PAGE_SLUG}} page.
+	 *
+	 * @param string      $path           Route path (e.g., '/types/$type/edit/$id').
+	 * @param string|null $content_module Script module ID for content (stage/inspector).
+	 * @param string|null $route_module   Script module ID for route lifecycle hooks.
+	 */
+	function register_{{PAGE_SLUG_UNDERSCORE}}_route( $path, $content_module = null, $route_module = null ) {
+		global ${{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_routes;
+
+		$route = array( 'path' => $path );
+		if ( ! empty( $content_module ) ) {
+			$route['content_module'] = $content_module;
+		}
+		if ( ! empty( $route_module ) ) {
+			$route['route_module'] = $route_module;
+		}
+
+		${{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_routes[] = $route;
+	}
+}
+
+if ( ! function_exists( 'register_{{PAGE_SLUG_UNDERSCORE}}_menu_item' ) ) {
+	/**
+	 * Register a menu item for the {{PAGE_SLUG}} page.
+	 *
+	 * @param string $id        Menu item ID.
+	 * @param string $label     Display label.
+	 * @param string $to        Route path to navigate to.
+	 * @param string $parent_id Optional. Parent menu item ID.
+	 */
+	function register_{{PAGE_SLUG_UNDERSCORE}}_menu_item( $id, $label, $to, $parent_id = '' ) {
+		global ${{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_menu_items;
+
+		$menu_item = array(
+			'id'    => $id,
+			'label' => $label,
+			'to'    => $to,
+		);
+
+		if ( ! empty( $parent_id ) ) {
+			$menu_item['parent'] = $parent_id;
+		}
+
+		${{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_menu_items[] = $menu_item;
+	}
+}
+
+if ( ! function_exists( 'get_{{PAGE_SLUG_UNDERSCORE}}_routes' ) ) {
+	/**
+	 * Get all registered routes for the {{PAGE_SLUG}} page.
+	 *
+	 * @return array Array of route objects.
+	 */
+	function get_{{PAGE_SLUG_UNDERSCORE}}_routes() {
+		global ${{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_routes;
+		return ${{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_routes ?? array();
+	}
+}
+
+if ( ! function_exists( 'get_{{PAGE_SLUG_UNDERSCORE}}_menu_items' ) ) {
+	/**
+	 * Get all registered menu items for the {{PAGE_SLUG}} page.
+	 *
+	 * @return array Array of menu item objects.
+	 */
+	function get_{{PAGE_SLUG_UNDERSCORE}}_menu_items() {
+		global ${{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_menu_items;
+		return ${{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_menu_items ?? array();
+	}
+}
+
+if ( ! function_exists( '{{PAGE_SLUG_UNDERSCORE}}_preload_data' ) ) {
+	/**
+	 * Preload REST API data for the {{PAGE_SLUG}} page.
+	 * Automatically called during page rendering.
+	 */
+	function {{PAGE_SLUG_UNDERSCORE}}_preload_data() {
+		// Define paths to preload - same for all pages
+		$preload_paths = array(
+			'/?_fields=description,gmt_offset,home,name,site_icon,site_icon_url,site_logo,timezone_string,url,page_for_posts,page_on_front,show_on_front',
+			array( '/wp/v2/settings', 'OPTIONS' ),
+		);
+
+		// Use rest_preload_api_request to gather the preloaded data
+		$preload_data = array_reduce(
+			$preload_paths,
+			'rest_preload_api_request',
+			array()
+		);
+
+		// Register the preloading middleware with wp-api-fetch
+		wp_add_inline_script(
+			'wp-api-fetch',
+			sprintf(
+				'wp.apiFetch.use( wp.apiFetch.createPreloadingMiddleware( %s ) );',
+				wp_json_encode( $preload_data )
+			),
+			'after'
+		);
+	}
+}
+
+if ( ! function_exists( '{{PAGE_SLUG_UNDERSCORE}}_render_page' ) ) {
+	/**
+	 * Render the {{PAGE_SLUG}} page.
+	 * Call this function from add_menu_page or add_submenu_page.
+	 */
+	function {{PAGE_SLUG_UNDERSCORE}}_render_page() {
+		// Set current screen
+		set_current_screen();
+
+		// Remove unwanted deprecated handler
+		remove_action( 'admin_head', 'wp_admin_bar_header' );
+
+		// Remove unwanted scripts and styles that were enqueued during `admin_init`
+		foreach ( wp_scripts()->queue as $script ) {
+			wp_dequeue_script( $script );
+		}
+		foreach ( wp_styles()->queue as $style ) {
+			wp_dequeue_style( $style );
+		}
+
+		// Fire init action for extensions to register routes and menu items
+		do_action( '{{PAGE_SLUG}}_init' );
+
+		// Preload REST API data
+		{{PAGE_SLUG_UNDERSCORE}}_preload_data();
+
+		// Get all registered routes and menu items
+		$menu_items = get_{{PAGE_SLUG_UNDERSCORE}}_menu_items();
+		$routes = get_{{PAGE_SLUG_UNDERSCORE}}_routes();
+
+		// Get boot module asset file for dependencies
+		$asset_file = plugin_dir_path( __FILE__ ) . '../../modules/boot/index.min.asset.php';
+		if ( file_exists( $asset_file ) ) {
+			$asset = require $asset_file;
+
+			// This script serves two purposes:
+			// 1. It ensures all the globals that are made available to the modules are loaded.
+			// 2. It initializes the boot module as an inline script.
+			wp_register_script( '{{PAGE_SLUG}}-prerequisites', '', $asset['dependencies'], $asset['version'], true );
+
+			// Add inline script to initialize the app
+			wp_add_inline_script(
+				'{{PAGE_SLUG}}-prerequisites',
+				sprintf(
+					'import("@wordpress/boot").then(mod => mod.init({mountId: "%s", menuItems: %s, routes: %s}));',
+					'{{PAGE_SLUG}}-app',
+					wp_json_encode( $menu_items, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ),
+					wp_json_encode( $routes, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES )
+				)
+			);
+
+			// Register prerequisites style by filtering script dependencies to find registered styles
+			$style_dependencies = array_filter(
+				$asset['dependencies'],
+				function ( $handle ) {
+					return wp_style_is( $handle, 'registered' );
+				}
+			);
+			wp_register_style( '{{PAGE_SLUG}}-prerequisites', false, $style_dependencies, $asset['version'] );
+
+			// Build dependencies for {{PAGE_SLUG}} module
+			$boot_dependencies = array(
+				array(
+					'import' => 'static',
+					'id'     => '@wordpress/boot',
+				),
+			);
+
+			// Add all registered routes as dependencies
+			foreach ( $routes as $route ) {
+				if ( isset( $route['route_module'] ) ) {
+					$boot_dependencies[] = array(
+						'import' => 'static',
+						'id'     => $route['route_module'],
+					);
+				}
+				if ( isset( $route['content_module'] ) ) {
+					$boot_dependencies[] = array(
+						'import' => 'dynamic',
+						'id'     => $route['content_module'],
+					);
+				}
+			}
+
+			// Dummy script module to ensure dependencies are loaded
+			wp_register_script_module(
+				'{{PAGE_SLUG}}',
+				plugin_dir_url( __FILE__ ) . 'loader.js',
+				$boot_dependencies
+			);
+
+			// Enqueue the boot scripts and styles
+			wp_enqueue_script( '{{PAGE_SLUG}}-prerequisites' );
+			wp_enqueue_script_module( '{{PAGE_SLUG}}' );
+			wp_enqueue_style( '{{PAGE_SLUG}}-prerequisites' );
+		}
+
+		// Output the HTML
+		?>
+		<!DOCTYPE html>
+		<html <?php language_attributes(); ?>>
+		<head>
+			<meta charset="<?php bloginfo( 'charset' ); ?>">
+			<meta name="viewport" content="width=device-width, initial-scale=1">
+			<title><?php echo esc_html( get_admin_page_title() ); ?></title>
+			<style>
+				html {
+					background: #f1f1f1;
+					color: #444;
+					font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen-Sans, Ubuntu, Cantarell, "Helvetica Neue", sans-serif;
+					font-size: 13px;
+					line-height: 1.4em;
+				}
+				body {
+					margin: 0;
+				}
+				#wpadminbar { display: none; }
+			</style>
+		<?php
+		global $hook_suffix;
+		// phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
+		$hook_suffix = '{{PAGE_SLUG}}';
+
+		// BEGIN see wp-admin/admin-header.php
+		print_admin_styles();
+		print_head_scripts();
+
+		/**
+		 * Fires in head section for a specific admin page.
+		 *
+		 * @since 2.1.0
+		 */
+		do_action( "admin_head-{$hook_suffix}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
+
+		/**
+		 * Fires in head section for all admin pages.
+		 *
+		 * @since 2.1.0
+		 */
+		do_action( 'admin_head' );
+		// END see wp-admin/admin-header.php
+		?>
+		</head>
+		<body class="{{PAGE_SLUG}}">
+			<div id="{{PAGE_SLUG}}-app" style="height: 100vh; box-sizing: border-box;"></div>
+		<?php
+		// BEGIN see wp-admin/admin-footer.php
+
+		/**
+		 * Prints scripts or data before the default footer scripts.
+		 *
+		 * @since 1.2.0
+		 */
+		do_action( 'admin_footer', '' );
+
+		// Print import map first so it's available for inline scripts
+		wp_script_modules()->print_import_map();
+		print_footer_scripts();
+		wp_script_modules()->print_enqueued_script_modules();
+		wp_script_modules()->print_script_module_preloads();
+		wp_script_modules()->print_script_module_data();
+
+		/**
+		 * Prints scripts or data after the default footer scripts.
+		 *
+		 * @since 2.8.0
+		 */
+		do_action( "admin_footer-{$hook_suffix}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
+		// END see wp-admin/admin-footer.php
+		?>
+		</body>
+		</html>
+		<?php
+		exit;
+	}
+}
+
+if ( ! function_exists( '{{PAGE_SLUG_UNDERSCORE}}_intercept_render' ) ) {
+	/**
+	 * Intercept admin_init to render the page early.
+	 * This bypasses the default WordPress admin template.
+	 */
+	function {{PAGE_SLUG_UNDERSCORE}}_intercept_render() {
+		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
+		if ( isset( $_GET['page'] ) && '{{PAGE_SLUG}}' === $_GET['page'] ) {
+			{{PAGE_SLUG_UNDERSCORE}}_render_page();
+			exit;
+		}
+	}
+}
+
+// Hook the interceptor to admin_init
+add_action( 'admin_init', '{{PAGE_SLUG_UNDERSCORE}}_intercept_render' );

package/templates/pages.php.template

@@ -0,0 +1,9 @@
+<?php
+/**
+ * Pages loader - Auto-generated by build process.
+ * Do not edit this file manually.
+ *
+ * @package {{PREFIX}}
+ */
+
+{{PAGE_INCLUDES}}

package/templates/routes-registration.php.template

@@ -0,0 +1,90 @@
+<?php
+/**
+ * Routes registration - Auto-generated by build process.
+ * Registers all routes on their respective page init hooks.
+ * Do not edit this file manually.
+ *
+ * @package {{PREFIX}}
+ */
+
+// Load routes registry
+$routes_file = __DIR__ . '/routes/index.php';
+if ( ! file_exists( $routes_file ) ) {
+	return;
+}
+
+$routes = require $routes_file;
+
+// Group routes by page
+$routes_by_page = array();
+foreach ( $routes as $route ) {
+	$page_slug = $route['page'];
+	if ( ! isset( $routes_by_page[ $page_slug ] ) ) {
+		$routes_by_page[ $page_slug ] = array();
+	}
+	$routes_by_page[ $page_slug ][] = $route;
+}
+
+// Helper function to register routes for a page
+$register_routes_callback = function ( $page_routes, $page_slug_underscore, $register_function_name ) {
+	return function () use ( $page_routes, $page_slug_underscore, $register_function_name ) {
+		foreach ( $page_routes as $route ) {
+			$content_handle = null;
+			$route_handle = null;
+
+			// Register content module if exists
+			if ( $route['has_content'] ) {
+				$content_asset_path = __DIR__ . "/routes/{$route['name']}/content.min.asset.php";
+				if ( file_exists( $content_asset_path ) ) {
+					$content_asset = require $content_asset_path;
+					$content_handle = '{{HANDLE_PREFIX}}/routes/' . $route['name'] . '/content';
+					$extension = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '.js' : '.min.js';
+					wp_register_script_module(
+						$content_handle,
+						plugins_url( 'build/routes/' . $route['name'] . '/content' . $extension, dirname( __FILE__ ) ),
+						$content_asset['module_dependencies'] ?? array(),
+						$content_asset['version'] ?? false
+					);
+				}
+			}
+
+			// Register route module if exists
+			if ( $route['has_route'] ) {
+				$route_asset_path = __DIR__ . "/routes/{$route['name']}/route.min.asset.php";
+				if ( file_exists( $route_asset_path ) ) {
+					$route_asset = require $route_asset_path;
+					$route_handle = '{{HANDLE_PREFIX}}/routes/' . $route['name'] . '/route';
+					$extension = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '.js' : '.min.js';
+					wp_register_script_module(
+						$route_handle,
+						plugins_url( 'build/routes/' . $route['name'] . '/route' . $extension, dirname( __FILE__ ) ),
+						$route_asset['module_dependencies'] ?? array(),
+						$route_asset['version'] ?? false
+					);
+				}
+			}
+
+			// Register route with page
+			if ( function_exists( $register_function_name ) ) {
+				call_user_func( $register_function_name, $route['path'], $content_handle, $route_handle );
+			}
+		}
+	};
+};
+
+// Register hooks for both full-page and wp-admin modes
+foreach ( $routes_by_page as $page_slug => $page_routes ) {
+	$page_slug_underscore = str_replace( '-', '_', $page_slug );
+
+	// Register all routes for full-page mode (page.php)
+	add_action(
+		"{$page_slug}_init",
+		$register_routes_callback( $page_routes, $page_slug_underscore, "register_{$page_slug_underscore}_route" )
+	);
+
+	// Register all routes for wp-admin mode (page-wp-admin.php)
+	add_action(
+		"{$page_slug}-wp-admin_init",
+		$register_routes_callback( $page_routes, $page_slug_underscore, "register_{$page_slug_underscore}_wp_admin_route" )
+	);
+}

package/templates/routes.php.template

@@ -1,66 +0,0 @@
-<?php
-/**
- * Routes registration - Auto-generated by build process.
- * Do not edit this file manually.
- *
- * @package {{PREFIX}}
- */
-
-if ( ! function_exists( '{{NAMESPACE}}_register_routes' ) ) {
-	/**
-	 * Register all routes with WordPress.
-	 */
-	function {{NAMESPACE}}_register_routes() {
-		$routes_dir  = __DIR__ . '/routes';
-		$routes_file = $routes_dir . '/index.php';
-
-		if ( ! file_exists( $routes_file ) ) {
-			return;
-		}
-
-		$routes    = require $routes_file;
-		$base_url  = plugins_url( 'build/routes/', dirname( __FILE__ ) );
-		$extension = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '.js' : '.min.js';
-
-		foreach ( $routes as $route ) {
-			// Register content module
-			$content_asset_path = $routes_dir . '/' . $route['name'] . '/content.min.asset.php';
-			$content_asset      = file_exists( $content_asset_path ) ? require $content_asset_path : array();
-			$content_handle     = '{{HANDLE_PREFIX}}/routes/' . $route['name'] . '/content';
-
-			wp_register_script_module(
-				$content_handle,
-				$base_url . $route['name'] . '/content' . $extension,
-				$content_asset['module_dependencies'] ?? array(),
-				$content_asset['version'] ?? false
-			);
-
-			$route_handle = null;
-
-			// Register route module if it exists
-			if ( isset( $route['has_route'] ) && $route['has_route'] ) {
-				$route_asset_path = $routes_dir . '/' . $route['name'] . '/route.min.asset.php';
-				$route_asset      = file_exists( $route_asset_path ) ? require $route_asset_path : array();
-				$route_handle     = '{{HANDLE_PREFIX}}/routes/' . $route['name'] . '/route';
-
-				wp_register_script_module(
-					$route_handle,
-					$base_url . $route['name'] . '/route' . $extension,
-					$route_asset['module_dependencies'] ?? array(),
-					$route_asset['version'] ?? false
-				);
-			}
-
-			// Register the route with boot
-			if ( function_exists( 'gutenberg_register_boot_route' ) ) {
-				gutenberg_register_boot_route(
-					$route['path'],
-					$content_handle,
-					$route_handle
-				);
-			}
-		}
-	}
-
-	add_action( 'gutenberg_boot_init', '{{NAMESPACE}}_register_routes', 10 );
-}