feat(rules): add button-width-classes rule (v2.2.3)

Detect wp:button blocks where "width":N is set in JSON but the outer
<div> is missing has-custom-width / wp-block-button__width-{N} classes,
or the inner <a> still carries width:{N}% inline style.

WordPress core/button save() expresses percentage width via CSS classes
on the outer div — not inline style — so any mismatch causes a block
validation failure in the editor. Caught by this rule before deployment.

Also bump bin/pt-cli application version from 2.0.0 to 2.2.3.

Author: jasperf

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.3] - 2026-05-13
+
+### Added
+
+- **`button-width-classes` rule** (`BaseRules`) — detects `wp:button` blocks that have `"width":N` in their JSON but whose HTML outer `<div>` is missing the `has-custom-width` and/or `wp-block-button__width-{N}` classes, or where the inner `<a>` still carries a `width:{N}%` inline style. WordPress's `core/button` save function expresses percentage width via CSS classes on the outer div — not inline style — so any mismatch causes a block validation failure in the editor.
+
 ## [2.2.2] - 2026-05-12
 
 ### Added

bin/pt-cli

@@ -21,7 +21,7 @@ use Imagewize\PtCli\Commands\Scaffold\StyleCreateCommand;
 use Imagewize\PtCli\Commands\TemplateCheckCommand;
 use Symfony\Component\Console\Application;
 
-$application = new Application('pt-cli', '2.0.0');
+$application = new Application('pt-cli', '2.2.3');
 $application->add(new CheckCommand());
 $application->add(new TemplateCheckCommand());
 $application->add(new PatternCreateCommand());

src/Compliance/Rules/BaseRules.php

@@ -61,6 +61,7 @@ public function check(string $filePath): array
         $violations = array_merge($violations, $this->checkExternalUrls($content));
         $violations = array_merge($violations, $this->checkButtonRootFontSize($content));
         $violations = array_merge($violations, $this->checkButtonClassNameOrder($content));
+        $violations = array_merge($violations, $this->checkButtonWidthClasses($content));
         $violations = array_merge($violations, $this->checkCoverBlockMinHeight($content));
         $violations = array_merge($violations, $this->checkEmptyBorderSideObjects($content));
         $violations = array_merge($violations, $this->checkBorderColorRawSlug($content));
@@ -246,6 +247,44 @@ private function checkButtonClassNameOrder(string $content): array
         return [];
     }
 
+    private function checkButtonWidthClasses(string $content): array
+    {
+        // When wp:button has "width":N, the save() function emits:
+        //   <div class="wp-block-button has-custom-width wp-block-button__width-{N} ...">
+        // and does NOT put width:{N}% in the <a> inline style.
+        // Patterns that instead use is-width-full + inline width:100% will fail validation.
+        $lines = explode("\n", $content);
+        $total = count($lines);
+        for ($i = 0; $i < $total; $i++) {
+            $line = $lines[$i];
+            if (!str_contains($line, '<!-- wp:button') || !preg_match('/"width"\s*:\s*(\d+)/', $line, $m)) {
+                continue;
+            }
+            $pct = (int) $m[1];
+            // Scan current line and the next two for the HTML div.
+            for ($j = $i; $j <= $i + 2 && $j < $total; $j++) {
+                $html = $lines[$j];
+                if (!str_contains($html, 'wp-block-button')) {
+                    continue;
+                }
+                if (!str_contains($html, 'has-custom-width') || !str_contains($html, "wp-block-button__width-{$pct}")) {
+                    return [$this->violation(
+                        'button-width-classes',
+                        "wp:button has \"width\":{$pct} but the outer <div> is missing has-custom-width and/or wp-block-button__width-{$pct} — add both classes and remove width:{$pct}% from the <a> inline style to match core/button save() output"
+                    )];
+                }
+                if (str_contains($html, "width:{$pct}%")) {
+                    return [$this->violation(
+                        'button-width-classes',
+                        "wp:button has \"width\":{$pct} but the <a> still has width:{$pct}% inline style — remove it (save() expresses width via has-custom-width + wp-block-button__width-{$pct} classes on the outer div, not inline style)"
+                    )];
+                }
+                break;
+            }
+        }
+        return [];
+    }
+
     private function checkCoverBlockMinHeight(string $content): array
     {
         foreach (explode("\n", $content) as $line) {