@wordpress/create-block-interactive-template 2.42.0 → 2.43.0

package/README.md

@@ -12,6 +12,38 @@ npx @wordpress/create-block --template @wordpress/create-block-interactive-templ
 
 It requires at least WordPress 6.5 or Gutenberg 17.7.
 
+## Variants
+
+This template exposes three variants. Use the `--variant` flag to select one:
+
+### `default`
+
+The standard interactive block scaffold. Uses the Interactivity API to demonstrate reactive state, context, and DOM event handling.
+
+```bash
+npx @wordpress/create-block --template @wordpress/create-block-interactive-template --variant default
+```
+
+This is also the variant used when no `--variant` flag is provided.
+
+### `typescript`
+
+Same as `default` but the view script (`view.ts`) is written in TypeScript, with fully typed store state and context.
+
+```bash
+npx @wordpress/create-block --template @wordpress/create-block-interactive-template --variant typescript
+```
+
+### `client-side-navigation`
+
+Demonstrates client-side navigation powered by `@wordpress/interactivity-router`. The block renders a quote navigator whose Prev / Next links swap page content without a full reload. A client-side stopwatch running outside the router region proves that no full page reload occurred.
+
+```bash
+npx @wordpress/create-block --template @wordpress/create-block-interactive-template --variant client-side-navigation
+```
+
+This variant adds `@wordpress/interactivity-router` as an additional npm dependency.
+
 ## Contributing to this package
 
 This is an individual package that's part of the Gutenberg project. The project is organized as a monorepo. It's made up of multiple self-contained software packages, each with a specific purpose. The packages in this monorepo are published to [npm](https://www.npmjs.com/) and used by [WordPress](https://make.wordpress.org/core/) as well as other software projects.

package/index.js

@@ -18,9 +18,10 @@ module.exports = {
 		viewScriptModule: 'file:./view.js',
 		render: 'file:./render.php',
 		example: {},
+		folderName: './src/$slug',
 		customScripts: {
-			build: 'wp-scripts build --experimental-modules',
-			start: 'wp-scripts start --experimental-modules',
+			build: 'wp-scripts build --experimental-modules --blocks-manifest',
+			start: 'wp-scripts start --experimental-modules --blocks-manifest',
 		},
 	},
 	variants: {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/create-block-interactive-template",
-	"version": "2.42.0",
+	"version": "2.43.0",
 	"description": "Template for @wordpress/create-block to create interactive blocks with the Interactivity API.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -26,5 +26,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "c20787b1778ae64c2db65643b1c236309d68e6ba"
+	"gitHead": "2cea90674d11aa521ec3f71652fb3a6a4c383969"
 }

package/plugin-templates/$slug.php.mustache

@@ -37,15 +37,15 @@
 if ( ! defined( 'ABSPATH' ) ) {
 	exit; // Exit if accessed directly.
 }
-
 /**
- * Registers the block using the metadata loaded from the `block.json` file.
- * Behind the scenes, it registers also all assets so they can be enqueued
+ * Registers the block(s) metadata from the `blocks-manifest.php` and registers the block type(s)
+ * based on the registered block metadata. Behind the scenes, it registers also all assets so they can be enqueued
  * through the block editor in the corresponding context.
  *
- * @see https://developer.wordpress.org/reference/functions/register_block_type/
+ * @see https://make.wordpress.org/core/2025/03/13/more-efficient-block-type-registration-in-6-8/
+ * @see https://make.wordpress.org/core/2024/10/17/new-block-type-registration-apis-to-improve-performance-in-wordpress-6-7/
  */
 function {{namespaceSnakeCase}}_{{slugSnakeCase}}_block_init() {
-	register_block_type_from_metadata( __DIR__ . '/build' );
+	wp_register_block_types_from_metadata_collection( __DIR__ . '/build', __DIR__ . '/build/blocks-manifest.php' );
 }
 add_action( 'init', '{{namespaceSnakeCase}}_{{slugSnakeCase}}_block_init' );