chore: stage and commit all changes, update changelog for shared components

Author: ashleyshaw

.github/prompts/scan-mustache-registry.prompt.md

@@ -0,0 +1,46 @@
+---
+title: "Initiate Mustache Variable Registry Scan"
+description: "Prompt for running a new scan and updating the mustache variable registry with wizard support."
+category: "registry"
+date: 2025-12-18
+---
+
+# Mustache Variable Registry Scan Wizard
+
+You are about to run a full scan of the repository for mustache template variables.
+
+**This process will:**
+
+- Discover all `{{mustache}}` placeholders in source, config, and docs.
+- Compare results to the current registry.
+- Identify undocumented, unused, or changed variables.
+- Guide you through reviewing and updating the registry.
+
+## Steps
+
+1. **Scan**: Run the scan to auto-discover all variables.
+2. **Review**: For each new or changed variable, the wizard will prompt you to:
+   - Confirm or edit the variable name.
+   - Assign a type and category.
+   - Add a description and example value.
+3. **Validate**: The wizard will validate the updated registry against the schema.
+4. **Diff & Report**: Optionally, generate a diff/markdown report for review or PRs.
+5. **Save**: Confirm and write the updated registry.
+
+## Usage
+
+Run:
+
+```sh
+npm run scan:mustache-registry
+```
+
+Or, for wizard mode:
+
+```sh
+npm run scan:mustache-registry -- --wizard
+```
+
+---
+
+**Tip:** Use the wizard to ensure all variables are well-documented and categorized for future maintainers.

CONTRIBUTING.md

@@ -78,11 +78,11 @@ We welcome various types of contributions:
 
 ```bash
 # Fork the repository on GitHub, then clone your fork
-git clone https://github.com/YOUR-USERNAME/{{slug}}.git
-cd {{slug}}
+git clone https://github.com/YOUR-USERNAME/{{plugin_slug}}.git
+cd {{plugin_slug}}
 
 # Add upstream remote
-git remote add upstream https://github.com/{{author}}/{{slug}}.git
+git remote add upstream https://github.com/{{author}}/{{plugin_slug}}.git
 ```
 
 ### 2. Install Dependencies
@@ -206,7 +206,7 @@ export default function Edit( { attributes, setAttributes } ) {
 Example:
 
 ```scss
-.wp-block-{{namespace}}-{{slug}} {
+.wp-block-{{namespace}}-{{block_slug}} {
     &__content {
         padding: var(--wp--preset--spacing--medium);
         border: 1px solid var(--wp--preset--color--border);
@@ -395,7 +395,7 @@ Outstanding contributors may be invited to become:
 
 ### Questions About Contributing
 
-- **General questions** - Use [GitHub Discussions](https://github.com/{{author}}/{{slug}}/discussions)
+- **General questions** - Use [GitHub Discussions](https://github.com/{{author}}/{{plugin_slug}}/discussions)
 - **Specific issues** - Comment on relevant GitHub issues
 - **Development help** - See [SUPPORT.md](SUPPORT.md) for channels
 - **Urgent matters** - Contact maintainers directly

DEVELOPMENT.md

@@ -23,8 +23,10 @@ This document provides comprehensive information for developers working on {{nam
 ### 1. Clone and Install
 
 ```bash
-git clone https://github.com/{{author}}/{{slug}}.git
-cd {{slug}}
+npm install
+composer install
+git clone https://github.com/{{author}}/{{plugin_slug}}.git
+cd {{plugin_slug}}
 npm install
 composer install
 ```
@@ -65,14 +67,14 @@ The plugin follows WordPress block development best practices with multiple bloc
 ```
 src/
 ├── index.js            # Main entry point - registers all blocks
-├── {{block-slug-1}}/   # First block
+├── {{block_slug}}/   # Block directory
 │   ├── block.json      # Block metadata and configuration
 │   ├── edit.js         # Editor component (React)
 │   ├── save.js         # Frontend save component
 │   ├── index.js        # Block registration
 │   ├── render.php      # Server-side render callback
 │   └── style.scss      # Block-specific styles
-├── {{block-slug-2}}/   # Second block
+├── {{block_slug}}/   # Another block
 │   └── ...
 └── shared/             # Shared between blocks
     ├── components/     # Shared React components
@@ -349,7 +351,7 @@ This updates version numbers in:
 
 - `package.json`
 - `composer.json`
-- `{{slug}}.php`
+- `{{plugin_slug}}.php`
 - `src/*/block.json`
 - `README.md`
 
@@ -451,7 +453,7 @@ define( 'SCRIPT_DEBUG', true );
 
 ### Getting Help
 
-1. Check existing [GitHub Issues](https://github.com/{{author}}/{{slug}}/issues)
+1. Check existing [GitHub Issues](https://github.com/{{author}}/{{plugin_slug}}/issues)
 2. Read [WordPress Block Editor Handbook](https://developer.wordpress.org/block-editor/)
 3. Join [WordPress Slack](https://wordpress.slack.com) #core-editor channel
 4. Review [LightSpeed Standards](https://github.com/lightspeedwp/.github)

SECURITY.md

@@ -132,7 +132,7 @@ We take the following types of vulnerabilities seriously:
 
 #### Preferred Method: Private GitHub Security Advisory
 
-1. Go to the [Security tab](https://github.com/{{author}}/{{slug}}/security) of our repository
+1. Go to the [Security tab](https://github.com/{{author}}/{{plugin_slug}}/security) of our repository
 2. Click "Report a vulnerability"
 3. Fill out the security advisory form with details
 4. Submit the report
@@ -322,7 +322,7 @@ The plugin complies with:
 ### Security Team
 
 * **Security Email**: security@{{author}}.com
-* **GitHub Security**: [Security Tab](https://github.com/{{author}}/{{slug}}/security)
+* **GitHub Security**: [Security Tab](https://github.com/{{author}}/{{plugin_slug}}/security)
 * **Maintainer**: [@{{author}}](https://github.com/{{author}})
 
 ### Security Resources

SUPPORT.md

@@ -48,7 +48,7 @@ Need help with {{name}}? This guide provides various support options and resourc
 
 **Best for**: Bug reports, feature requests, technical issues
 
-* **Create an issue**: [{{slug}} Issues](https://github.com/{{author}}/{{slug}}/issues)
+* **Create an issue**: [{{plugin_slug}} Issues](https://github.com/{{author}}/{{plugin_slug}}/issues)
 * **Search existing issues**: Check if your issue already exists
 * **Follow templates**: Use the provided issue templates
 * **Be specific**: Provide detailed information and reproduction steps
@@ -89,7 +89,7 @@ Any other context about the problem here.
 
 **Best for**: Questions, ideas, general discussion
 
-* **Ask questions**: [{{slug}} Discussions](https://github.com/{{author}}/{{slug}}/discussions)
+* **Ask questions**: [{{plugin_slug}} Discussions](https://github.com/{{author}}/{{plugin_slug}}/discussions)
 * **Share ideas**: Discuss potential features
 * **Community help**: Get help from other users
 * **Show and tell**: Share how you're using the plugin
@@ -98,7 +98,7 @@ Any other context about the problem here.
 
 **Best for**: General WordPress questions, plugin installation help
 
-* **Plugin support forum**: [WordPress.org {{slug}} Forum](https://wordpress.org/support/plugin/{{slug}}/)
+* **Plugin support forum**: [WordPress.org {{plugin_slug}} Forum](https://wordpress.org/support/plugin/{{plugin_slug}}/)
 * **Community driven**: Volunteers provide help
 * **Public archive**: Searchable for future users
 * **WordPress focused**: WordPress-specific issues
@@ -286,9 +286,9 @@ A: Deactivate the plugin immediately, then report the issue with your WordPress
 
 ### Project Links
 
-* **GitHub Repository**: [{{author}}/{{slug}}](https://github.com/{{author}}/{{slug}})
-* **WordPress.org Plugin**: [{{slug}}](https://wordpress.org/plugins/{{slug}}/)
-* **Documentation**: [GitHub Pages](https://{{author}}.github.io/{{slug}}/)
+* **GitHub Repository**: [{{author}}/{{plugin_slug}}](https://github.com/{{author}}/{{plugin_slug}})
+* **WordPress.org Plugin**: [{{plugin_slug}}](https://wordpress.org/plugins/{{plugin_slug}}/)
+* **Documentation**: [GitHub Pages](https://{{author}}.github.io/{{plugin_slug}}/)
 
 ## Contributing to Support
 

USAGE.md

@@ -15,21 +15,21 @@ This guide explains how to use the {{name}} in your WordPress site.
 
 ### From WordPress Admin
 
-1. Download the plugin ZIP file from the [releases page](https://github.com/{{author}}/{{slug}}/releases)
+1. Download the plugin ZIP file from the [releases page](https://github.com/{{author}}/{{plugin_slug}}/releases)
 2. In your WordPress admin, go to **Plugins > Add New**
 3. Click **Upload Plugin** and select the ZIP file
 4. Click **Install Now** and then **Activate**
 
 ### Manual Installation
 
 1. Download and extract the plugin files
-2. Upload the `{{slug}}` folder to `/wp-content/plugins/`
+2. Upload the `{{plugin_slug}}` folder to `/wp-content/plugins/`
 3. Activate the plugin through the **Plugins** menu in WordPress
 
 ### Via Composer
 
 ```bash
-composer require {{author}}/{{slug}}
+composer require {{author}}/{{plugin_slug}}
 ```
 
 ## Getting Started
@@ -100,17 +100,17 @@ You can add custom styles using WordPress's Additional CSS feature:
 
 ```css
 /* Target the block wrapper */
-.wp-block-{{namespace}}-{{block-slug}} {
+.wp-block-{{namespace}}-{{block_slug}} {
     /* Your custom styles */
 }
 
 /* Target the content area */
-.wp-block-{{namespace}}-{{block-slug}}__content {
+.wp-block-{{namespace}}-{{block_slug}}__content {
     /* Content-specific styles */
 }
 
 /* Alignment variations */
-.wp-block-{{namespace}}-{{block-slug}}.has-text-align-left {
+.wp-block-{{namespace}}-{{block_slug}}.has-text-align-left {
     /* Left-aligned styles */
 }
 ```
@@ -258,39 +258,39 @@ Yes! See [CONTRIBUTING.md](../CONTRIBUTING.md) for information on how to contrib
 ### Basic Usage
 
 ```html
-<!-- wp:{{namespace}}/{{block-slug}} {"content":"Hello World","alignment":"center"} -->
-<div class="wp-block-{{namespace}}-{{block-slug}} has-text-align-center">
-    <div class="wp-block-{{namespace}}-{{block-slug}}__content">
+<!-- wp:{{namespace}}/{{block_slug}} {"content":"Hello World","alignment":"center"} -->
+<div class="wp-block-{{namespace}}-{{block_slug}} has-text-align-center">
+    <div class="wp-block-{{namespace}}-{{block_slug}}__content">
         <p>Hello World</p>
     </div>
 </div>
-<!-- /wp:{{namespace}}/{{block-slug}} -->
+<!-- /wp:{{namespace}}/{{block_slug}} -->
 ```
 
 ### With Custom Colors
 
 ```html
-<!-- wp:{{namespace}}/{{block-slug}} {"content":"Styled content","textColor":"primary","backgroundColor":"secondary"} -->
-<div class="wp-block-{{namespace}}-{{block-slug}} has-primary-color has-secondary-background-color has-text-color has-background">
-    <div class="wp-block-{{namespace}}-{{block-slug}}__content">
+<!-- wp:{{namespace}}/{{block_slug}} {"content":"Styled content","textColor":"primary","backgroundColor":"secondary"} -->
+<div class="wp-block-{{namespace}}-{{block_slug}} has-primary-color has-secondary-background-color has-text-color has-background">
+    <div class="wp-block-{{namespace}}-{{block_slug}}__content">
         <p>Styled content</p>
     </div>
 </div>
-<!-- /wp:{{namespace}}/{{block-slug}} -->
+<!-- /wp:{{namespace}}/{{block_slug}} -->
 ```
 
 ### In a Pattern
 
 ```html
 <!-- wp:group {"layout":{"type":"constrained"}} -->
 <div class="wp-block-group">
-    <!-- wp:{{namespace}}/{{block-slug}} {"content":"Pattern Example","alignment":"center"} -->
-    <div class="wp-block-{{namespace}}-{{block-slug}} has-text-align-center">
-        <div class="wp-block-{{namespace}}-{{block-slug}}__content">
+    <!-- wp:{{namespace}}/{{block_slug}} {"content":"Pattern Example","alignment":"center"} -->
+    <div class="wp-block-{{namespace}}-{{block_slug}} has-text-align-center">
+        <div class="wp-block-{{namespace}}-{{block_slug}}__content">
             <p>Pattern Example</p>
         </div>
     </div>
-    <!-- /wp:{{namespace}}/{{block-slug}} -->
+    <!-- /wp:{{namespace}}/{{block_slug}} -->
 </div>
 <!-- /wp:group -->
 ```

inc/class-patterns.php

@@ -91,21 +91,25 @@ public function register_patterns() {
 	}
 
 	/**
-	 * Derive pattern slug from filename.
-	 *
-	 * Converts 'patterns/example-plugin-card.php' to 'example-plugin/card'
-	 *
-	 * @since 1.0.0
-	 * @param string $pattern_file Full path to pattern file.
-	 * @return string Pattern slug.
-	 */
-	private function get_pattern_slug_from_file( $pattern_file ) {
-		$filename = basename( $pattern_file, '.php' );
-
-		// Remove {{slug}}- prefix if present.
-		$pattern_name = str_replace( '{{slug}}-', '', $filename );
-
-		// Return namespaced slug.
-		return '{{slug}}/' . $pattern_name;
-	}
+	       * Derive pattern slug from filename.
+	       *
+	       * Converts 'patterns/{{slug}}-tour-card.php' to '{{slug}}/tour-card'
+	       *
+	       * @since 1.0.0
+	       * @param string $pattern_file Full path to pattern file.
+	       * @return string Pattern slug.
+	       */
+	      private function get_pattern_slug_from_file( $pattern_file ) {
+		      $filename = basename( $pattern_file, '.php' );
+
+		      // Remove '{{slug}}-' prefix if present, preserving post type and pattern purpose.
+		      if ( strpos( $filename, '{{slug}}-' ) === 0 ) {
+			      $pattern_name = substr( $filename, strlen( '{{slug}}-' ) );
+		      } else {
+			      $pattern_name = $filename;
+		      }
+
+		      // Return namespaced slug in the format '{{slug}}/{post_type}-{pattern}'.
+		      return '{{slug}}/' . $pattern_name;
+	      }
 }

languages/{{slug}}.pot

@@ -1,25 +1,26 @@
-# Copyright (C) Example Author
-# This file is distributed under the same license as the Example Plugin package.
+
+# Copyright (C) {{author}}
+# This file is distributed under the same license as the {{name}} package.
 msgid ""
 msgstr ""
-"Project-Id-Version: Example Plugin 1.0.0\n"
-"Report-Msgid-Bugs-To: https://github.com/Example Author/example-plugin/issues\n"
-"POT-Creation-Date: 2024-01-01 00:00:00+00:00\n"
+"Project-Id-Version: {{name}} {{version}}\n"
+"Report-Msgid-Bugs-To: https://github.com/{{author}}/{{slug}}/issues\n"
+"POT-Creation-Date: {{pot_date}}\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Language-Team: LANGUAGE <[email protected]>\n"
 "X-Generator: WP-CLI\n"
-"X-Domain: example-plugin\n"
+"X-Domain: {{textdomain}}\n"
 
 #. Plugin Name of the plugin
-msgid "Example Plugin"
+msgid "{{name}}"
 msgstr ""
 
 #. Description of the plugin
-msgid "A multi-block WordPress plugin scaffold example"
+msgid "{{description}}"
 msgstr ""
 
 #. Author of the plugin
-msgid "Example Author"
+msgid "{{author}}"
 msgstr ""