generator-chisel 2.1.2 → 2.2.0

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

@@ -5,16 +5,16 @@ namespace Chisel\WP;
 use Chisel\Interfaces\InstanceInterface;
 use Chisel\Interfaces\HooksInterface;
 use Chisel\Traits\Singleton;
-use Chisel\Helper\ThemeHelpers;
-use Chisel\Helper\AjaxHelpers;
-use Chisel\Helper\AssetsHelpers;
+use Chisel\Helpers\ThemeHelpers;
+use Chisel\Helpers\AjaxHelpers;
+use Chisel\Helpers\AssetsHelpers;
 
 /**
  * Class for enqueuing scripts and styles.
  *
  * @package Chisel
  */
-class Assets implements InstanceInterface, HooksInterface {
+final class Assets implements InstanceInterface, HooksInterface {
 
 	use Singleton;
 
@@ -23,70 +23,70 @@ class Assets implements InstanceInterface, HooksInterface {
 	 *
 	 * @var array
 	 */
-	private $frontend_styles = array();
+	private array $frontend_styles = array();
 
 	/**
 	 * Front-end styles to be registered and enqueued in footer.
 	 *
 	 * @var array
 	 */
-	private $frontend_footer_styles = array();
+	private array $frontend_footer_styles = array();
 
 	/**
 	 * Front-end scripts to be registered and enqueued.
 	 *
 	 * @var array
 	 */
-	private $frontend_scripts = array();
+	private array $frontend_scripts = array();
 
 	/**
 	 * Admin styles to be registered and enqueued.
 	 *
 	 * @var array
 	 */
-	private $admin_styles = array();
+	private array $admin_styles = array();
 
 	/**
 	 * Admin scripts to be registered and enqueued.
 	 *
 	 * @var array
 	 */
-	private $admin_scripts = array();
+	private array $admin_scripts = array();
 
 	/**
 	 * Editor styles to be registered and enqueued.
 	 *
 	 * @var array
 	 */
-	private $editor_styles = array();
+	private array $editor_styles = array();
 
 	/**
 	 * Editor scripts to be registered and enqueued.
 	 *
 	 * @var array
 	 */
-	private $editor_scripts = array();
+	private array $editor_scripts = array();
 
 	/**
 	 * Login page styles to be registered and enqueued.
 	 *
 	 * @var array
 	 */
-	private $login_styles = array();
+	private array $login_styles = array();
 
 	/**
 	 * Login page scripts to be registered and enqueued.
 	 *
 	 * @var array
 	 */
-	private $login_scripts = array();
+	private array $login_scripts = array();
 
 	/**
 	 * WP React Refresh runtime dependency.
 	 *
 	 * @var string
 	 */
-	private $refresh_runtime_dependency = 'wp-react-refresh-runtime';
+	private string $refresh_runtime_dependency = 'wp-react-refresh-runtime';
 
 	/**
 	 * Class constructor.
@@ -101,15 +101,13 @@ class Assets implements InstanceInterface, HooksInterface {
 	/**
 	 * Set properties.
 	 */
-	public function set_properties() {
+	public function set_properties(): void {
 		// This is a required script for React Refresh. It is generated by Webpack and only exists in development mode.
 		$runtime_script = array(
 			'src'       => get_template_directory_uri() . '/build/runtime.js',
 			'deps'      => array( $this->refresh_runtime_dependency ),
 			'strategy'  => false,
-			'condition' => function () {
-				return ThemeHelpers::is_fast_refresh();
-			},
+			'condition' => array( ThemeHelpers::class, 'is_fast_refresh' ),
 		);
 
 		if ( ! is_admin() ) {
@@ -192,9 +190,8 @@ class Assets implements InstanceInterface, HooksInterface {
 	/**
 	 * Register action hooks.
 	 */
-	public function action_hooks() {
+	public function action_hooks(): void {
 		add_action( 'init', array( $this, 'register_assets' ) );
-		add_action( 'init', array( $this, 'move_scripts_to_footer' ), 2 );
 
 		add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_frontend_assets' ), 99 ); // Higher priority, overwrite plugins if needed.
 		add_action( 'wp_footer', array( $this, 'enqueue_frontend_assets_in_footer' ), 11 ); // Higher priority, overwrite plugins if needed.
@@ -209,32 +206,16 @@ class Assets implements InstanceInterface, HooksInterface {
 	/**
 	 * Register filter hooks.
 	 */
-	public function filter_hooks() {
+	public function filter_hooks(): void {
 		add_filter( 'script_loader_tag', array( $this, 'async_script' ), 99, 2 );
 		add_filter( 'script_loader_tag', array( $this, 'defer_script' ), 99, 2 );
 		add_filter( 'style_loader_tag', array( $this, 'preload_styles' ), 99, 2 );
 	}
 
-	/**
-	 * Move all scripts to footer
-	 *
-	 * @return void
-	 */
-	public function move_scripts_to_footer() {
-		if ( ! is_admin() ) {
-			remove_action( 'wp_head', 'wp_print_scripts' );
-			remove_action( 'wp_head', 'wp_print_head_scripts', 9 );
-			remove_action( 'wp_head', 'print_emoji_detection_script', 7 );
-
-			add_action( 'wp_footer', 'wp_print_scripts', 5 );
-			add_action( 'wp_footer', 'wp_print_head_scripts', 5 );
-		}
-	}
-
 	/**
 	 * Register assets.
 	 */
-	public function register_assets() {
+	public function register_assets(): void {
 		if ( ! is_admin() ) {
 			$this->frontend_styles        = apply_filters( 'chisel_frontend_styles', $this->frontend_styles );
 			$this->frontend_footer_styles = apply_filters( 'chisel_frontend_footer_styles', $this->frontend_footer_styles );
@@ -314,7 +295,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	/**
 	 * Enqueue front-end assets.
 	 */
-	public function enqueue_frontend_assets() {
+	public function enqueue_frontend_assets(): void {
 		$this->frontend_styles  = apply_filters( 'chisel_pre_enqueue_frontend_styles', $this->frontend_styles );
 		$this->frontend_scripts = apply_filters( 'chisel_pre_enqueue_frontend_scripts', $this->frontend_scripts );
 
@@ -347,7 +328,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	/**
 	 * Enqueue front-end styles in footer, ie. Gravity Forms custom styles.
 	 */
-	public function enqueue_frontend_assets_in_footer() {
+	public function enqueue_frontend_assets_in_footer(): void {
 		$this->frontend_footer_styles = apply_filters( 'chisel_pre_enqueue_frontend_footer_styles', $this->frontend_footer_styles );
 
 		if ( $this->frontend_footer_styles ) {
@@ -368,7 +349,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	/**
 	 * Enqueue admin assets.
 	 */
-	public function enqueue_admin_assets() {
+	public function enqueue_admin_assets(): void {
 		$this->admin_styles  = apply_filters( 'chisel_pre_enqueue_admin_styles', $this->admin_styles );
 		$this->admin_scripts = apply_filters( 'chisel_pre_enqueue_admin_scripts', $this->admin_scripts );
 
@@ -401,7 +382,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	/**
 	 * Enqueue editor scripts.
 	 */
-	public function enqueue_editor_scripts() {
+	public function enqueue_editor_scripts(): void {
 		$this->editor_styles  = apply_filters( 'chisel_pre_enqueue_editor_styles', $this->editor_styles );
 		$this->editor_scripts = apply_filters( 'chisel_pre_enqueue_editor_scripts', $this->editor_scripts );
 
@@ -434,7 +415,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	/**
 	 * Enqueue login page scripts.
 	 */
-	public function enqueue_login_page_assets() {
+	public function enqueue_login_page_assets(): void {
 		$stylesheet = wp_get_global_stylesheet();
 
 		if ( empty( $stylesheet ) ) {
@@ -481,7 +462,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	 *
 	 * @return string
 	 */
-	public function async_script( $tag, $handle ) {
+	public function async_script( string $tag, string $handle ): string {
 		if ( is_admin() ) {
 			return $tag;
 		}
@@ -507,20 +488,13 @@ class Assets implements InstanceInterface, HooksInterface {
 	 *
 	 * @return string
 	 */
-	public function defer_script( $tag, $handle ) {
-		if ( is_admin() ) {
+	public function defer_script( string $tag, string $handle ): string {
+		if ( is_admin() || is_login() ) {
 			return $tag;
 		}
 
 		$scripts = array();
 
-		// Defer all wp scripts.
-		if ( strpos( $handle, 'wp' ) === false ) {
-			if ( strpos( $handle, 'defer' ) === false ) {
-				$tag = str_replace( ' src', ' defer src', $tag );
-			}
-		}
-
 		if ( $scripts ) {
 			foreach ( $scripts as $script_handle ) {
 				if ( $handle === $script_handle ) {
@@ -540,7 +514,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	 *
 	 * @return string
 	 */
-	public function preload_styles( $tag, $handle ) {
+	public function preload_styles( string $tag, string $handle ): string {
 		if ( is_admin() ) {
 			return $tag;
 		}
@@ -580,7 +554,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	 *
 	 * @return string
 	 */
-	private function preload_style( $tag ) {
+	private function preload_style( string $tag ): string {
 		$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 );
 
@@ -594,9 +568,9 @@ class Assets implements InstanceInterface, HooksInterface {
 	 * @param string $file_name
 	 * @param array  $args
 	 *
-	 * @return void
+	 * @return ?array
 	 */
-	private function register_style( $handle, $file_name, $args ) {
+	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 );
@@ -612,7 +586,7 @@ class Assets implements InstanceInterface, HooksInterface {
 			}
 
 			if ( ! $condition ) {
-				return;
+				return null;
 			}
 		}
 
@@ -651,7 +625,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	 *
 	 * @return array
 	 */
-	private function enqueue_style( $handle, $args ) {
+	private function enqueue_style( string $handle, array $args ): array {
 		$inline = isset( $args['inline'] ) ? $args['inline'] : '';
 
 		if ( $inline ) {
@@ -672,9 +646,9 @@ class Assets implements InstanceInterface, HooksInterface {
 	 * @param string $file_name
 	 * @param array  $args
 	 *
-	 * @return void
+	 * @return ?array
 	 */
-	private function register_script( $handle, $file_name, $args ) {
+	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 );
@@ -693,7 +667,7 @@ class Assets implements InstanceInterface, HooksInterface {
 			}
 
 			if ( ! $condition ) {
-				return;
+				return null;
 			}
 		}
 
@@ -721,7 +695,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	 *
 	 * @return array
 	 */
-	private function enqueue_script( $handle, $args ) {
+	private function enqueue_script( string $handle, array $args ): array {
 		$localize = isset( $args['localize'] ) ? $args['localize'] : array();
 		$inline   = isset( $args['inline'] ) ? $args['inline'] : '';
 
@@ -750,7 +724,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	 *
 	 * @return void
 	 */
-	private function set_script_translations( $handle, $args ) {
+	private function set_script_translations( string $handle, array $args ): void {
 		if ( isset( $args['deps'] ) && in_array( 'wp-i18n', $args['deps'], true ) ) {
 			wp_set_script_translations( AssetsHelpers::get_final_handle( $handle ), 'chisel', get_template_directory() . '/languages' );
 		}
@@ -763,7 +737,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	 *
 	 * @return void
 	 */
-	private function enqueue_style_js_for_dev( $handle ) {
+	private function enqueue_style_js_for_dev( string $handle ): void {
 		if ( ThemeHelpers::is_fast_refresh() ) {
 			wp_enqueue_script( 'style-' . AssetsHelpers::get_final_handle( $handle ) );
 		}
@@ -776,7 +750,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	 *
 	 * @return string
 	 */
-	private function get_script_src( $file_name ) {
+	private function get_script_src( string $file_name ): string {
 		return get_template_directory_uri() . '/build/scripts/' . $file_name . '.js';
 	}
 
@@ -788,7 +762,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	 *
 	 * @return string
 	 */
-	private function get_style_src( $file_name, $refresh_script = false ) {
+	private function get_style_src( string $file_name, bool $refresh_script = false ): string {
 		if ( $refresh_script ) {
 			return get_template_directory_uri() . '/build/styles/' . $file_name . '.js';
 		}
@@ -804,7 +778,7 @@ class Assets implements InstanceInterface, HooksInterface {
 	 *
 	 * @return array
 	 */
-	private function get_asset( $file_name, $type ) {
+	private function get_asset( string $file_name, string $type ): array {
 		if ( $type === 'css' ) {
 			$asset_path = get_template_directory() . '/build/styles/' . $file_name . '.asset.php';
 		} else {

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

@@ -7,9 +7,9 @@ use Timber\Timber;
 use Chisel\Interfaces\InstanceInterface;
 use Chisel\Interfaces\HooksInterface;
 use Chisel\Traits\Singleton;
-use Chisel\Factory\RegisterBlocks;
-use Chisel\Helper\BlocksHelpers;
-use Chisel\Helper\ThemeHelpers;
+use Chisel\Factories\RegisterBlocks;
+use Chisel\Helpers\BlocksHelpers;
+use Chisel\Helpers\ThemeHelpers;
 use Chisel\Traits\PageBlocks;
 
 /**
@@ -17,7 +17,7 @@ use Chisel\Traits\PageBlocks;
  *
  * @package Chisel
  */
-class Blocks implements InstanceInterface, HooksInterface {
+final class Blocks implements InstanceInterface, HooksInterface {
 
 	use Singleton;
 	use PageBlocks;
@@ -27,21 +27,21 @@ class Blocks implements InstanceInterface, HooksInterface {
 	 *
 	 * @var RegisterBlocks
 	 */
-	private $register_blocks_factory;
+	private RegisterBlocks $register_blocks_factory;
 
 	/**
 	 * Blocks.
 	 *
 	 * @var array
 	 */
-	private $blocks = array();
+	private array $blocks = array();
 
 	/**
 	 * Chisel blocks category.
 	 *
 	 * @var string
 	 */
-	private $blocks_category;
+	private string $blocks_category = '';
 
 
 	/**
@@ -49,14 +49,14 @@ class Blocks implements InstanceInterface, HooksInterface {
 	 *
 	 * @var array
 	 */
-	private $block_patterns_categories = array();
+	private array $block_patterns_categories = array();
 
 	/**
 	 * Blocks twig file base path.
 	 *
 	 * @var string
 	 */
-	private $blocks_twig_base_path = 'build/blocks/';
+	private string $blocks_twig_base_path = 'build/blocks/';
 
 	/**
 	 * Class constructor.
@@ -74,7 +74,7 @@ class Blocks implements InstanceInterface, HooksInterface {
 	/**
 	 * Set properties.
 	 */
-	public function set_properties() {
+	public function set_properties(): void {
 		$this->blocks_category           = 'chisel-blocks';
 		$this->block_patterns_categories = array(
 			'cta' => array(
@@ -87,7 +87,7 @@ class Blocks implements InstanceInterface, HooksInterface {
 	/**
 	 * Register action hooks.
 	 */
-	public function action_hooks() {
+	public function action_hooks(): void {
 		add_action( 'init', array( $this, 'register_blocks' ) );
 		add_action( 'after_setup_theme', array( $this, 'blocks_theme_supports' ) );
 		add_action( 'init', array( $this, 'register_block_patterns_categories' ) );
@@ -97,7 +97,7 @@ class Blocks implements InstanceInterface, HooksInterface {
 	/**
 	 * Register filter hooks.
 	 */
-	public function filter_hooks() {
+	public function filter_hooks(): void {
 		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 );
@@ -110,14 +110,14 @@ class Blocks implements InstanceInterface, HooksInterface {
 	/**
 	 * Register blocks and their assets.
 	 */
-	public function register_blocks() {
+	public function register_blocks(): void {
 		$this->register_blocks_factory->register_custom_blocks();
 	}
 
 	/**
 	 * Set up theme supports for blocks.
 	 */
-	public function blocks_theme_supports() {
+	public function blocks_theme_supports(): void {
 		add_theme_support( 'wp-block-styles' ); // extra core blocks styles.
 
 		remove_theme_support( 'core-block-patterns' ); // remove default wp patterns and use only custom ones.
@@ -131,7 +131,7 @@ class Blocks implements InstanceInterface, HooksInterface {
 	 *
 	 * @return array
 	 */
-	public function block_categories( $categories ) {
+	public function block_categories( array $categories ): array {
 		$include = true;
 
 		foreach ( $categories as $category ) {
@@ -160,7 +160,7 @@ class Blocks implements InstanceInterface, HooksInterface {
 	 *
 	 * @return void
 	 */
-	public function register_block_patterns_categories() {
+	public function register_block_patterns_categories(): void {
 		if ( ! $this->block_patterns_categories || ! function_exists( 'register_block_pattern_category' ) ) {
 			return;
 		}
@@ -177,7 +177,7 @@ class Blocks implements InstanceInterface, HooksInterface {
 	 * @param array $locations The locations.
 	 * @return array
 	 */
-	public function tiwg_files_locations( $locations ) {
+	public function tiwg_files_locations( array $locations ): array {
 		if ( ! is_array( $this->blocks ) || ! $this->blocks ) {
 			return $locations;
 		}
@@ -198,7 +198,7 @@ class Blocks implements InstanceInterface, HooksInterface {
 	 *
 	 * @return string
 	 */
-	public function render_block( $block_content, $block, $block_instance ) {
+	public function render_block( string $block_content, array $block, object $block_instance ): string {
 		if ( is_admin() || wp_doing_ajax() || wp_doing_cron() ) {
 			return $block_content;
 		}
@@ -237,7 +237,7 @@ class Blocks implements InstanceInterface, HooksInterface {
 	 *
 	 * @return int
 	 */
-	public function styles_inline_size_limit( $limit ) {
+	public function styles_inline_size_limit( int $limit ): int {
 		$limit = apply_filters( 'chisel_styles_inline_size_limit', 10000 );
 
 		return $limit;
@@ -250,7 +250,7 @@ class Blocks implements InstanceInterface, HooksInterface {
 	 *
 	 * @return bool
 	 */
-	public function should_load_separate_core_block_assets( $load ) {
+	public function should_load_separate_core_block_assets( bool $load ): bool {
 		$load = apply_filters( 'chisel_load_separate_core_block_assets', false );
 
 		return $load;
@@ -263,7 +263,7 @@ class Blocks implements InstanceInterface, HooksInterface {
 	 *
 	 * @return array
 	 */
-	public function blocks_alignment_data( $editor_scripts_data ) {
+	public function blocks_alignment_data( array $editor_scripts_data ): array {
 		$editor_scripts_data['editor']['localize']['data']['blocksDefaultAlignment'] = array(
 			'chisel/slider' => 'full',
 		);
@@ -276,7 +276,7 @@ class Blocks implements InstanceInterface, HooksInterface {
 	 *
 	 * @return void
 	 */
-	public function dequeue_blocks_styles() {
+	public function dequeue_blocks_styles(): void {
 		if ( is_admin() ) {
 			return;
 		}
@@ -284,7 +284,7 @@ class Blocks implements InstanceInterface, HooksInterface {
 		$blocks_used_on_page = $this->get_content_blocks_names();
 		$blocks              = $this->blocks;
 
-		if ( $blocks ) {
+		if ( ! empty( $blocks ) ) {
 			$blocks_path = $this->register_blocks_factory->get_blocks_path();
 			$blocks_url  = $this->register_blocks_factory->get_blocks_url();
 

package/lib/commands/create/creators/app/chisel-starter-theme/inc/WP/Cache.php

@@ -7,14 +7,14 @@ use Timber\Loader;
 use Chisel\Interfaces\InstanceInterface;
 use Chisel\Interfaces\HooksInterface;
 use Chisel\Traits\Singleton;
-use Chisel\Helper\ThemeHelpers;
+use Chisel\Helpers\ThemeHelpers;
 
 /**
  * Cache related functionalities.
  *
  * @package Chisel
  */
-class Cache implements InstanceInterface, HooksInterface {
+final class Cache implements InstanceInterface, HooksInterface {
 
 	use Singleton;
 
@@ -23,21 +23,21 @@ class Cache implements InstanceInterface, HooksInterface {
 	 *
 	 * @var int
 	 */
-	public $cache_expiry = HOUR_IN_SECONDS;
+	public int $cache_expiry = HOUR_IN_SECONDS;
 
 	/**
 	 * Cache everything mode. The whole template you render and its data will be cached.
 	 *
 	 * @var int
 	 */
-	public $cache_everything = false;
+	public bool $cache_everything = false;
 
 	/**
 	 * Environment cache.
 	 *
 	 * @var int
 	 */
-	private $environment_cache = false;
+	private bool $environment_cache = false;
 
 	/**
 	 * Class constructor.
@@ -52,7 +52,7 @@ class Cache implements InstanceInterface, HooksInterface {
 	/**
 	 * Set properties.
 	 */
-	public function set_properties() {
+	public function set_properties(): void {
 		$this->cache_expiry      = apply_filters( 'chisel_cache_expiry', $this->cache_expiry );
 		$this->cache_everything  = apply_filters( 'chisel_cache_everything', $this->cache_everything );
 		$this->environment_cache = apply_filters( 'chisel_environment_cache', $this->environment_cache );
@@ -61,13 +61,12 @@ class Cache implements InstanceInterface, HooksInterface {
 	/**
 	 * Register action hooks.
 	 */
-	public function action_hooks() {
-	}
+	public function action_hooks(): void {}
 
 	/**
 	 * Register filter hooks.
 	 */
-	public function filter_hooks() {
+	public function filter_hooks(): void {
 		add_filter( 'timber/cache/mode', array( $this, 'cache_mode' ) );
 		add_filter( 'timber/twig/environment/options', array( $this, 'environment_cache' ) );
 	}
@@ -79,7 +78,7 @@ class Cache implements InstanceInterface, HooksInterface {
 	 *
 	 * @return string
 	 */
-	public function cache_mode( $cache_mode ) {
+	public function cache_mode( string $cache_mode ): string {
 		// Available cache modes: 'CACHE_NONE', 'CACHE_OBJECT' (WP Object Cache), 'CACHE_TRANSIENT', 'CACHE_SITE_TRANSIENT', 'CACHE_USE_DEFAULT'.
 		$cache_mode = Loader::CACHE_USE_DEFAULT;
 
@@ -93,7 +92,7 @@ class Cache implements InstanceInterface, HooksInterface {
 	 *
 	 * @return array
 	 */
-	public function environment_cache( $options ) {
+	public function environment_cache( array $options ): array {
 		$options['cache']       = $this->environment_cache;
 		$options['auto_reload'] = ThemeHelpers::is_dev_env();
 		$options['debug']       = ThemeHelpers::is_dev_env();

package/lib/commands/create/creators/app/chisel-starter-theme/inc/WP/ChiselImage.php

@@ -16,9 +16,10 @@ class ChiselImage extends TimberImage {
 	 *
 	 * @param string $size Thumbnail size.
 	 * @param array  $attrs Image attributes.
-	 * @return html
+	 *
+	 * @return string The responsive <img> HTML.
 	 */
-	public function responsive( $size = 'medium', $attrs = array() ) {
+	public function responsive( string $size = 'medium', array $attrs = array() ): string {
 		return wp_get_attachment_image( $this->ID, $size, false, $attrs );
 	}
 }

package/lib/commands/create/creators/app/chisel-starter-theme/inc/WP/ChiselPost.php

@@ -4,7 +4,7 @@ namespace Chisel\WP;
 
 use Timber\Post as TimberPost;
 use Timber\Timber;
-use Chisel\Helper\ImageHelpers;
+use Chisel\Helpers\ImageHelpers;
 
 /**
  * Extend Timber Post class with custom functionality.
@@ -16,19 +16,25 @@ class ChiselPost extends TimberPost {
 	/**
 	 * Post thumbnail.
 	 *
-	 * @var html
+	 * @var ?string
 	 */
-	public $thumbnail_html;
+	public ?string $thumbnail_html = null;
 
 	/**
 	 * Get the post thumbnail. Returns the thumbnail responsive image html.
 	 *
 	 * @param string $size Thumbnail size.
-	 * @return html
+	 *
+	 * @return string Responsive <img> HTML, or empty string.
 	 */
-	public function get_thumbnail( $size = 'medium' ) {
-		if ( ! $this->thumbnail_html ) {
-			$this->thumbnail_html = has_post_thumbnail( $this->ID ) ? ImageHelpers::get_responsive_image( get_post_thumbnail_id( $this->ID ), $size ) : '';
+	public function get_thumbnail( string $size = 'medium' ): string {
+		if ( $this->thumbnail_html === null ) {
+			$this->thumbnail_html = '';
+
+			if ( has_post_thumbnail( $this->ID ) ) {
+				$thumbnail_id         = get_post_thumbnail_id( $this->ID );
+				$this->thumbnail_html = ImageHelpers::get_responsive_image( $thumbnail_id, $size );
+			}
 		}
 
 		return $this->thumbnail_html;