v1.4.7: block-editor font fixes, weight normalization & housekeeping

- Fonts: render custom @font-face inside the block editor canvas via the
  editor styles channel (WP 6.3+/7.x iframe); when body/heading assignment
  is enabled, inject .editor-styles-wrapper font-family CSS with a system
  fallback so the canvas matches the front end
- Fonts: normalize out-of-range variable weight axes (1 900 -> 100 900) in
  build_css() and theme.json so WordPress no longer silently drops the face
  and its font-picker entry
- Components: route editor CSS through block_editor_settings_all, removing
  the iframe-fragile src-less inline fallback
- Remove dead admin_head font print; document a single source-of-truth
  font-loading matrix in the class header
- Drop stale per-file @Version docblocks across feature classes
- readme.txt: 1.4.7 changelog + Stable tag bump; README.md version

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: wpgaurav

.gitignore

@@ -26,8 +26,9 @@ yarn-error.log*
 /build/
 /dist/
 
-# AI assistant guidelines (keep local)
+# AI assistant guidelines / working notes (keep local)
 CLAUDE.md
+IMPROVEMENTS.md
 
 # Local release builds
 releases/

README.md

@@ -2,7 +2,7 @@
 
 All-in-one WordPress optimization toolkit with 15+ modules for performance, security, SEO, and content management. Built with modern WordPress coding standards and a clean module-based dashboard. Optimized for performance with lazy-loading, static property caching, and intelligent transients.
 
-**Version:** 1.4.5
+**Version:** 1.4.7
 **License:** GPL-2.0-or-later
 **Text Domain:** `functionalities`
 **Pricing:** Free

functionalities.php

@@ -3,7 +3,7 @@
  * Plugin Name:       Dynamic Functionalities
  * Plugin URI:        https://functionalities.dev
  * Description:       All-in-one WordPress optimization toolkit. 15+ modules for performance, security, SEO, and content management.
- * Version:           1.4.6
+ * Version:           1.4.7
  * Author:            Gaurav Tiwari
  * Author URI:        https://gauravtiwari.org
  * License:           GPL-2.0-or-later
@@ -19,7 +19,7 @@
 
 // Define constants.
 if (!defined('FUNCTIONALITIES_VERSION')) {
-	define('FUNCTIONALITIES_VERSION', '1.4.6');
+	define('FUNCTIONALITIES_VERSION', '1.4.7');
 }
 if (!defined('FUNCTIONALITIES_FILE')) {
 	define('FUNCTIONALITIES_FILE', __FILE__);

includes/features/class-assumption-detection.php

@@ -18,7 +18,6 @@
  *
  * @package Functionalities\Features
  * @since 0.9.0
- * @version 0.9.5
  */
 
 namespace Functionalities\Features;

includes/features/class-block-cleanup.php

@@ -8,7 +8,6 @@
  * @package    Functionalities
  * @subpackage Features
  * @since      0.2.0
- * @version    0.9.2
  */
 
 namespace Functionalities\Features;

includes/features/class-components.php

@@ -8,7 +8,6 @@
  * @package    Functionalities
  * @subpackage Features
  * @since      0.3.0
- * @version    0.8.0
  */
 
 namespace Functionalities\Features;
@@ -108,7 +107,10 @@ public static function init() : void {
 		// Output CSS in footer (both frontend and admin).
 		\add_action( 'wp_footer', array( __CLASS__, 'print_footer_link' ), 90 );
 		\add_action( 'admin_footer', array( __CLASS__, 'print_footer_link' ), 90 );
-		\add_action( 'enqueue_block_assets', array( __CLASS__, 'enqueue_editor_components' ) );
+
+		// Serve the block editor canvas (an iframe) via the editor `styles`
+		// setting — the only channel guaranteed to reach the iframe.
+		\add_filter( 'block_editor_settings_all', array( __CLASS__, 'add_editor_settings_components' ) );
 
 		// Regenerate CSS file when settings are updated.
 		\add_action( 'update_option_functionalities_components', array( __CLASS__, 'on_option_update' ), 10, 2 );
@@ -156,38 +158,49 @@ protected static function get_options() : array {
 	}
 
 	/**
-	 * Enqueue components CSS in the block editor iframe for WP 7 compatibility.
+	 * Inject component CSS into the block editor's style settings.
 	 *
-	 * @since 1.3.0
-	 * @return void
+	 * The editor canvas is iframed (WP 6.3+/7.x). Feeding CSS through the editor
+	 * `styles` setting — the channel add_editor_style() and the Font Library use —
+	 * is the reliable way into that iframe: WordPress copies it in verbatim and
+	 * scopes the selectors to the content wrapper.
+	 *
+	 * This replaces an enqueue_block_assets path that only reached the iframe when
+	 * a generated CSS file existed; its inline fallback used a src-less style handle
+	 * (wp_register_style( $h, false ) + wp_add_inline_style) that does NOT cross
+	 * into the iframe, so component CSS silently vanished in the editor whenever the
+	 * uploads file could not be written.
+	 *
+	 * @since 1.4.7
+	 *
+	 * @param array $settings Block editor settings (from block_editor_settings_all).
+	 * @return array Modified settings.
 	 */
-	public static function enqueue_editor_components() : void {
-		if ( ! \is_admin() ) {
-			return;
-		}
-
+	public static function add_editor_settings_components( $settings ) {
 		$opts = self::get_options();
 
 		if ( ! \apply_filters( 'functionalities_components_enabled', ! empty( $opts['enabled'] ) ) ) {
-			return;
+			return $settings;
 		}
 
 		if ( empty( $opts['items'] ) || ! is_array( $opts['items'] ) ) {
-			return;
+			return $settings;
 		}
 
 		$items = \apply_filters( 'functionalities_components_items', $opts['items'] );
-		$css   = self::build_css( $items );
-		$file  = self::ensure_css_file( $css );
+		$css   = self::sanitize_css( self::build_css( $items ) );
 
-		if ( $file && isset( $file['url'], $file['ver'] ) ) {
-			\wp_enqueue_style( 'functionalities-components', $file['url'], array(), $file['ver'] );
-			return;
+		if ( $css === '' ) {
+			return $settings;
 		}
 
-		\wp_register_style( 'functionalities-components', false, array(), FUNCTIONALITIES_VERSION );
-		\wp_enqueue_style( 'functionalities-components' );
-		\wp_add_inline_style( 'functionalities-components', self::sanitize_css( $css ) );
+		if ( empty( $settings['styles'] ) || ! is_array( $settings['styles'] ) ) {
+			$settings['styles'] = array();
+		}
+
+		$settings['styles'][] = array( 'css' => $css );
+
+		return $settings;
 	}
 
 	/**

includes/features/class-editor-links.php

@@ -8,7 +8,6 @@
  * @package    Functionalities
  * @subpackage Features
  * @since      0.2.0
- * @version    0.8.0
  */
 
 namespace Functionalities\Features;