generator-chisel 2.4.2 → 2.4.4

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 <!-- INSERT-NEW-ENTRIES-HERE -->
 
+## <small>2.4.4 (2026-03-20)</small>
+
+- Update readme, fix husky overwrite ([a24f08f](https://github.com/xfiveco/generator-chisel/commit/a24f08f))
+- Update theme version ([41ab516](https://github.com/xfiveco/generator-chisel/commit/41ab516))
+
+## <small>2.4.3 (2026-03-04)</small>
+
+- fix conditional enqueue, add filre hooks for defer, async, preload, add phcbf ([3befdb5](https://github.com/xfiveco/generator-chisel/commit/3befdb5))
+- update theme version ([7292b1a](https://github.com/xfiveco/generator-chisel/commit/7292b1a))
+
 ## <small>2.4.2 (2026-02-11)</small>
 
 - Blocks and patterns cache and render fixes ([576fbe9](https://github.com/xfiveco/generator-chisel/commit/576fbe9))

package/lib/commands/create/creators/app/chisel-starter-theme/README.md

@@ -1,8 +1,8 @@
 # Chisel WordPress Theme
 
-## WordPress Starter Theme based on Timber library
+A WordPress starter theme built on [Timber](https://timber.github.io/docs/) (Twig templating), Webpack, and ITCSS. Part of the [Chisel](https://getchisel.co/) development framework — scaffolded automatically via `npx generator-chisel`.
 
-Chisel is a custom WordPress development framework we built to make developers’ lives easier. It streamlines theme development with a modern stack — Webpack, Timber, and ITCSS — ensuring faster coding, cleaner structure, and more maintainable projects.
+For full documentation visit [getchisel.co](https://getchisel.co/).
 
 ## Installation
 

package/lib/commands/create/creators/app/chisel-starter-theme/core/WP/Assets.php

@@ -455,7 +455,7 @@ final class Assets {
 			return $tag;
 		}
 
-		$scripts = array();
+		$scripts = apply_filters( 'chisel_async_scripts', array() );
 
 		if ( $scripts ) {
 			foreach ( $scripts as $script_handle ) {
@@ -481,7 +481,7 @@ final class Assets {
 			return $tag;
 		}
 
-		$scripts = array();
+		$scripts = apply_filters( 'chisel_defer_scripts', array() );
 
 		if ( $scripts ) {
 			foreach ( $scripts as $script_handle ) {
@@ -507,13 +507,19 @@ final class Assets {
 			return $tag;
 		}
 
-		$styles_handles = array(
-			'wp-block-library',
+		$styles_handles = apply_filters(
+			'chisel_preload_styles',
+			array(
+				'wp-block-library',
+			)
 		);
 
-		$styles_handles_start_with = array(
-			'gform_',
-			'block',
+		$styles_handles_start_with = apply_filters(
+			'chisel_preload_styles_start_with',
+			array(
+				'gform_',
+				'block',
+			)
 		);
 
 		if ( $styles_handles ) {
@@ -546,7 +552,7 @@ final class Assets {
 		$preload_tag = str_replace( "rel='stylesheet'", "rel='preload' as='style'", $tag );
 		$tag         = $preload_tag . str_replace( "media='all'", "media='print' onload='this.media=\"all\"'", $tag );
 
-		return $tag;
+		return apply_filters( 'chisel_preload_style', $tag );
 	}
 
 	/**
@@ -561,22 +567,10 @@ final class Assets {
 	private function register_style( string $handle, string $file_name, array $args ): ?array {
 		$asset_data = $this->get_asset( $file_name, 'css' );
 
-		$src       = isset( $args['src'] ) ? $args['src'] : $this->get_style_src( $file_name );
-		$deps      = isset( $args['deps'] ) ? $args['deps'] : array();
-		$ver       = isset( $args['ver'] ) ? $args['ver'] : $asset_data['version'];
-		$media     = isset( $args['media'] ) ? $args['media'] : 'all';
-		$condition = isset( $args['condition'] ) ? $args['condition'] : null;
-
-		// Use condition to determine if the style should be registered. It can be either a boolean or a function.
-		if ( $condition !== null ) {
-			if ( is_callable( $condition ) ) {
-				$condition = call_user_func( $condition );
-			}
-
-			if ( ! $condition ) {
-				return null;
-			}
-		}
+		$src   = isset( $args['src'] ) ? $args['src'] : $this->get_style_src( $file_name );
+		$deps  = isset( $args['deps'] ) ? $args['deps'] : array();
+		$ver   = isset( $args['ver'] ) ? $args['ver'] : $asset_data['version'];
+		$media = isset( $args['media'] ) ? $args['media'] : 'all';
 
 		if ( $asset_data['dependencies'] ) {
 			$deps = wp_parse_args( $asset_data['dependencies'], $deps );
@@ -596,12 +590,11 @@ final class Assets {
 		}
 
 		return array(
-			'src'       => $src,
-			'deps'      => $deps,
-			'ver'       => $ver,
-			'media'     => $media,
-			'condition' => $condition,
-			'handle'    => $handle,
+			'src'    => $src,
+			'deps'   => $deps,
+			'ver'    => $ver,
+			'media'  => $media,
+			'handle' => $handle,
 		);
 	}
 
@@ -611,10 +604,22 @@ final class Assets {
 	 * @param string $handle - full script handle.
 	 * @param array  $args
 	 *
-	 * @return array
+	 * @return ?array
 	 */
-	private function enqueue_style( string $handle, array $args ): array {
-		$inline = isset( $args['inline'] ) ? $args['inline'] : '';
+	private function enqueue_style( string $handle, array $args ): ?array {
+		$condition = isset( $args['condition'] ) ? $args['condition'] : null;
+		$inline    = isset( $args['inline'] ) ? $args['inline'] : '';
+
+		// Use condition to determine if the style should be enqueued. It can be either a boolean or a function.
+		if ( $condition !== null ) {
+			if ( is_callable( $condition ) ) {
+				$condition = call_user_func( $condition );
+			}
+
+			if ( ! $condition ) {
+				return null;
+			}
+		}
 
 		if ( $inline ) {
 			wp_add_inline_style( $handle, $inline['data'] );
@@ -623,7 +628,8 @@ final class Assets {
 		wp_enqueue_style( $handle );
 
 		return array(
-			'handle' => $handle,
+			'handle'    => $handle,
+			'condition' => $condition,
 		);
 	}
 
@@ -639,25 +645,13 @@ final class Assets {
 	private function register_script( string $handle, string $file_name, array $args ): ?array {
 		$asset_data = $this->get_asset( $file_name, 'js' );
 
-		$src       = isset( $args['src'] ) ? $args['src'] : $this->get_script_src( $file_name );
-		$deps      = isset( $args['deps'] ) ? $args['deps'] : array();
-		$ver       = isset( $args['ver'] ) ? $args['ver'] : $asset_data['version'];
-		$strategy  = isset( $args['strategy'] ) ? $args['strategy'] : array(
+		$src      = isset( $args['src'] ) ? $args['src'] : $this->get_script_src( $file_name );
+		$deps     = isset( $args['deps'] ) ? $args['deps'] : array();
+		$ver      = isset( $args['ver'] ) ? $args['ver'] : $asset_data['version'];
+		$strategy = isset( $args['strategy'] ) ? $args['strategy'] : array(
 			'in_footer' => true,
 			'strategy'  => 'defer',
 		); // Strategy can be a boolean, which determines if the script should be enqueued in the footer, or an array with the following keys: 'in_footer':boolean and 'strategy':string (defer or async).
-		$condition = isset( $args['condition'] ) ? $args['condition'] : null;
-
-		// Use condition to determine if the script should be registered. It can be either a boolean or a function.
-		if ( $condition !== null ) {
-			if ( is_callable( $condition ) ) {
-				$condition = call_user_func( $condition );
-			}
-
-			if ( ! $condition ) {
-				return null;
-			}
-		}
 
 		if ( $asset_data['dependencies'] ) {
 			$deps = wp_parse_args( $asset_data['dependencies'], $deps );
@@ -666,12 +660,11 @@ final class Assets {
 		wp_register_script( $handle, $src, $deps, $ver, $strategy );
 
 		return array(
-			'src'       => $src,
-			'deps'      => $deps,
-			'ver'       => $ver,
-			'strategy'  => $strategy,
-			'condition' => $condition,
-			'handle'    => $handle,
+			'src'      => $src,
+			'deps'     => $deps,
+			'ver'      => $ver,
+			'strategy' => $strategy,
+			'handle'   => $handle,
 		);
 	}
 
@@ -681,11 +674,23 @@ final class Assets {
 	 * @param string $handle - full script handle.
 	 * @param array  $args
 	 *
-	 * @return array
+	 * @return ?array
 	 */
-	private function enqueue_script( string $handle, array $args ): array {
-		$localize = isset( $args['localize'] ) ? $args['localize'] : array();
-		$inline   = isset( $args['inline'] ) ? $args['inline'] : '';
+	private function enqueue_script( string $handle, array $args ): ?array {
+		$localize  = isset( $args['localize'] ) ? $args['localize'] : array();
+		$inline    = isset( $args['inline'] ) ? $args['inline'] : '';
+		$condition = isset( $args['condition'] ) ? $args['condition'] : null;
+
+		// Use condition to determine if the script should be registered. It can be either a boolean or a function.
+		if ( $condition !== null ) {
+			if ( is_callable( $condition ) ) {
+				$condition = call_user_func( $condition );
+			}
+
+			if ( ! $condition ) {
+				return null;
+			}
+		}
 
 		if ( $localize ) {
 			wp_localize_script( $handle, $localize['name'], $localize['data'] );
@@ -699,8 +704,9 @@ final class Assets {
 		$this->set_script_translations( $handle, $args );
 
 		return array(
-			'localize' => $localize,
-			'handle'   => $handle,
+			'localize'  => $localize,
+			'condition' => $condition,
+			'handle'    => $handle,
 		);
 	}
 
@@ -727,7 +733,24 @@ final class Assets {
 	 */
 	private function enqueue_style_js_for_dev( string $handle ): void {
 		if ( ThemeHelpers::is_fast_refresh() ) {
-			wp_enqueue_script( 'style-' . AssetsHelpers::get_final_handle( $handle ) );
+			$enqueue = true;
+
+			if ( $args ) {
+				$src = isset( $args['src'] ) ? $args['src'] : '';
+
+				if ( $src ) {
+					$theme      = wp_get_theme();
+					$theme_name = $theme->get_stylesheet();
+
+					if ( strpos( $src, $theme_name ) === false ) {
+						$enqueue = false;
+					}
+				}
+			}
+
+			if ( $enqueue ) {
+				wp_enqueue_script( 'style-' . AssetsHelpers::get_final_handle( $handle ) );
+			}
 		}
 	}
 

package/lib/commands/create/creators/app/chisel-starter-theme/core/WP/Blocks.php

@@ -161,6 +161,7 @@ final class Blocks {
 		add_filter( 'block_categories_all', array( $this, 'block_categories' ) );
 		add_filter( 'timber/locations', array( $this, 'tiwg_files_locations' ) );
 		add_filter( 'render_block', array( $this, 'render_block' ), 10, 3 );
+		add_filter( 'register_block_type_args', array( $this, 'register_block_type_args' ), 10, 2 );
 
 		add_filter( 'should_load_separate_core_block_assets', array( $this, 'should_load_separate_core_block_assets' ) );
 		add_filter( 'styles_inline_size_limit', array( $this, 'styles_inline_size_limit' ) );
@@ -292,6 +293,36 @@ final class Blocks {
 		return $block_content;
 	}
 
+	/**
+	 * Extend server-registered block attributes with editor-added custom attributes.
+	 *
+	 * This keeps REST block renderer validation in sync with JS filters that add
+	 * custom attributes (e.g. disableBottomMargin in editor mods).
+	 *
+	 * @param array  $args       Block type args.
+	 * @param string $block_name Registered block name.
+	 *
+	 * @return array
+	 */
+	public function register_block_type_args( array $args, string $block_name ): array {
+		if ( strpos( $block_name, 'core/' ) !== 0 && strpos( $block_name, 'chisel/' ) !== 0 ) {
+			return $args;
+		}
+
+		if ( ! isset( $args['attributes'] ) || ! is_array( $args['attributes'] ) ) {
+			$args['attributes'] = array();
+		}
+
+		if ( ! isset( $args['attributes']['disableBottomMargin'] ) ) {
+			$args['attributes']['disableBottomMargin'] = array(
+				'type'    => 'boolean',
+				'default' => false,
+			);
+		}
+
+		return $args;
+	}
+
 	/**
 	 * Set inline size limit for the styles. Default wp limit is 20000.
 	 *

package/lib/commands/create/creators/app/chisel-starter-theme/package.chisel-tpl.json

@@ -1,6 +1,6 @@
 {
   "name": "<%= app.nameSlug %>",
-  "version": "2.4.1",
+  "version": "2.4.3",
   "private": true,
   "license": "UNLICENSED",
   "author": "<%= app.author %>",
@@ -17,11 +17,11 @@
     "build": "npm run build-scripts && npm run lint && npm run phpcs && npm run twigcs && npm run check-update",
     "add-page": "chisel-scripts add-page",
     "create-block": "chisel-scripts create-block --category=chisel-blocks --namespace=chisel",
-    "create-dynamic-block": "npm run create-block --variant=dynamic",
     "wp": "chisel-scripts wp",
     "composer": "chisel-scripts composer",
     "wp-config": "chisel-scripts wp-config",
     "phpcs": "cross-env vendor/bin/phpcs --extensions=php --exclude=Generic.PHP.Syntax",
+    "phpcbf": "cross-env vendor/bin/phpcbf --extensions=php --exclude=Generic.PHP.Syntax",
     "twigcs": "cross-env vendor/bin/twigcs --config=twig_cs.php",
     "check-update": "chisel-scripts check-chisel-update",
     "update-chisel": "chisel-scripts chisel-update",

package/lib/commands/create/creators/app/chisel-starter-theme/src/design/tools/_screen-readers.scss

@@ -8,7 +8,7 @@
   height: 1px;
   padding: 0;
   overflow: hidden;
-  clip: rect(0, 0, 0, 0);
+  clip-path: inset(50%);
   white-space: nowrap;
   border: 0;
 }
@@ -24,7 +24,7 @@
     width: auto;
     height: auto;
     overflow: visible;
-    clip: auto;
+    clip-path: none;
     white-space: normal;
   }
 }

package/lib/commands/create/creators/app/chisel-starter-theme/style.chisel-tpl.css

@@ -3,7 +3,7 @@
  * Theme URI: https://www.getchisel.co/
  * Author: <%= app.author %>
  * Description: Chisel Wordpress Starter Theme based on Timber library.
- * Version: 2.4.2
+ * Version: 2.4.4
  * License: GNU General Public License v2 or later
  * License URI: http://www.gnu.org/licenses/gpl-2.0.html
  * Tags: chisel, custom, starter, theme, WordPress

package/lib/commands/create/creators/app/index.js

@@ -108,6 +108,14 @@ module.exports = async (api) => {
       { cwd: api.resolve(app.themePath) },
     );
 
+    // Restore prepare script after coding-standards may have overwritten it
+    {
+      const themePkgPath = api.resolve(app.themePath, 'package.json');
+      const themePkg = JSON.parse(await fs.readFile(themePkgPath, 'utf8'));
+      themePkg.scripts.prepare = 'chisel-scripts husky-init || node -e ""';
+      await fs.writeFile(themePkgPath, JSON.stringify(themePkg, null, 2) + '\n');
+    }
+
     await api.modifyFile(
       '.devcontainer/devcontainer.json',
       async (body) => {

package/lib/commands/create/packages-versions.js

@@ -1,5 +1,5 @@
 module.exports = {
   'chisel-scripts': '2.2.1',
   'chisel-shared-utils': '2.0.0-alpha.1',
-  'generator-chisel': '2.4.2',
+  'generator-chisel': '2.4.4',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generator-chisel",
-  "version": "2.4.2",
+  "version": "2.4.4",
   "description": "A generator for scaffolding front-end and WordPress projects",
   "bin": {
     "chisel": "bin/chisel.js"
@@ -37,5 +37,5 @@
     "tinyqueue": "^2.0.3",
     "update-notifier": "^4.1.0"
   },
-  "gitHead": "ee5dc88ef9d1987e2bbd786e99a6c41aaed5c922"
+  "gitHead": "7cb8498dbf9e63b07393c46d9f1b92a7f721f4e9"
 }