feature/design-tokens-module

.cspell.json

@@ -1,11 +1,16 @@
 {
     "version": "0.2",
+    "ignoreRegExpList": [
+        "github:[\\w.@/#-]+"
+    ],
     "ignorePaths": [
+        "AGENTS.md",
         "package-lock.json",
         "bun.lock",
         "bun.lockb",
         "composer.lock",
         "composer.json",
+        "phpstan-baseline.neon",
         "build/**",
         "**/*.min.js",
         "**/*.asset.php",
@@ -16,10 +21,14 @@
         "**/*.svg"
     ],
     "words": [
+        "absint",
         "ABSPATH",
         "advancedbtn",
         "advancedgallery",
         "advancedheading",
+        "advbtn",
+        "affordance",
+        "affordances",
         "algoliasearch",
         "alignleft",
         "alignright",
@@ -28,46 +37,76 @@
         "blocksy",
         "bloginfo",
         "britner",
+        "btnbg",
+        "btnbghover",
+        "btncolor",
+        "btncolorhover",
         "bunfig",
         "bunx",
+        "centralise",
         "changelogger",
+        "Checkboard",
+        "codecept",
         "codeception",
         "colapse",
         "commoditize",
+        "Consolas",
         "crawlable",
         "curlopt",
         "customizer",
+        "dashicon",
+        "dashicons",
+        "describedby",
         "designlibrary",
         "diffcs",
         "distignore",
         "dotlottie",
         "dotstyle",
+        "DTCG",
         "earlybird",
+        "Extralargeheadingsizewrapped",
         "exwide",
+        "figcaption",
         "flexwrap",
         "fluentcrm",
         "fluidcarousel",
+        "formalises",
+        "Fullwidth",
         "gfont",
         "gfonts",
         "ghernkadence",
+        "glightbox",
+        "grecaptcha",
         "gridvisualizer",
         "gslide",
         "gulpfile",
         "haspopup",
         "hcaptcha",
         "headerfunction",
+        "hoverable",
         "httpheader",
         "iconlist",
+        "iframed",
         "inbetween",
         "infobox",
         "innerblocks",
+        "Inno",
         "ithemes",
         "kadence",
         "kadenceblocks",
         "kadencewp",
+        "kbcss",
         "kbcustom",
         "kbcustomicons",
+        "ktanimate",
+        "ktanimateadd",
+        "ktanimatepreview",
+        "ktanimatereveal",
+        "ktanimateswipe",
+        "ktdynamic",
+        "ktgooglefonts",
         "lightbox",
+        "LONGTEXT",
         "lottieanimation",
         "lottiefiles",
         "lucatume",
@@ -76,6 +115,9 @@
         "markformat",
         "mbstring",
         "memize",
+        "Menlo",
+        "menuitemcheckbox",
+        "menuitemradio",
         "multisite",
         "multisites",
         "navigations",
@@ -85,22 +127,41 @@
         "oakesjosh",
         "pagenow",
         "patchstack",
+        "PCRE",
         "pexels",
         "phar",
         "phpcs",
         "phpstan",
+        "pickable",
         "postfields",
         "progressbar",
         "puprc",
         "recaptcha",
+        "recognised",
+        "renameable",
+        "repointed",
+        "Reselecting",
+        "resends",
         "resizer",
+        "retarget",
+        "retargeted",
+        "retargets",
         "returntransfer",
+        "Ritner",
         "rowlayout",
+        "rrggbb",
+        "rrggbbaa",
+        "Sabberworm",
         "scroller",
         "shivammathur",
         "singlebtn",
         "slic",
         "slidy",
+        "slugified",
+        "slugifies",
+        "slugify",
+        "slugifying",
+        "snackbars",
         "solidwp",
         "splide",
         "splidejs",
@@ -109,12 +170,18 @@
         "stellarwp",
         "subteam",
         "sunsetting",
+        "syncable",
         "tabindex",
         "tableofcontents",
+        "textcolor",
         "thumbslider",
         "trailingslashit",
         "uncollapsed",
         "undefed",
+        "unitless",
+        "unrecognised",
+        "unrepresentable",
+        "unslash",
         "userrole",
         "videopopup",
         "vsdesk",
@@ -124,9 +191,14 @@
         "webp",
         "woocommerce",
         "woodardmc",
+        "worktrees",
+        "wpbody",
+        "wpcontent",
         "wpdb",
+        "wpfooter",
         "wpml",
         "wpunit",
-        "writefunction"
+        "writefunction",
+        "xlarge"
     ]
 }

.eslintrc.js

@@ -132,6 +132,18 @@ const eslintConfig = {
 				'no-var': 'off',
 			},
 		},
+		{
+			// The design-token surfaces rely on hook-shaped helpers; keep the hook rules on here so a
+			// conditional hook call can't land silently while the repo-wide rule stays off.
+			files: [
+				'src/extension/variant-picker/**',
+				'src/extension/token-indicators/**',
+				'src/extension/design-tokens/**',
+			],
+			rules: {
+				'react-hooks/rules-of-hooks': 'error',
+			},
+		},
 	],
 	ignorePatterns: [],
 };

.github/workflows/phpcs.yml

@@ -34,12 +34,33 @@ jobs:
       - uses: ramsey/composer-install@v3
 
       - name: Run PHPCS on changed lines
+        env:
+          GH_TOKEN: ${{ secrets.GH_BOT_TOKEN }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
         run: |
           # On a pull_request the base is the PR's target branch; fall back to
           # master for a manual workflow_dispatch run.
           BASE_REF="${GITHUB_BASE_REF:-master}"
 
           git remote set-branches origin "$BASE_REF"
-          git fetch origin --depth=1
+          if ! git fetch origin --depth=1; then
+            # A re-run can replay a stale event payload: if the PR's base
+            # branch was renamed after this run was first queued,
+            # GITHUB_BASE_REF still names the old, now-deleted branch. Ask
+            # the API for the PR's current base and retry once before
+            # giving up.
+            if [ -z "$PR_NUMBER" ]; then
+              exit 1
+            fi
+
+            BASE_REF="$(gh pr view "$PR_NUMBER" --repo "$GITHUB_REPOSITORY" --json baseRefName --jq .baseRefName)"
+
+            if [ -z "$BASE_REF" ]; then
+              exit 1
+            fi
+
+            git remote set-branches origin "$BASE_REF"
+            git fetch origin --depth=1
+          fi
 
           composer phpcs-ci "origin/$BASE_REF"

.github/workflows/tests.yml

@@ -110,6 +110,9 @@ jobs:
             - name: Run acceptance tests
               run: ${SLIC_BIN} run acceptance --ext DotReporter
 
+            - name: Run snapshot tests
+              run: ${SLIC_BIN} run snapshot --ext DotReporter
+
             - name: Upload codeception output
               if: ${{ failure() }}
               uses: actions/upload-artifact@v6

.gitignore

@@ -17,7 +17,10 @@ bin/wp-cli.phar
 /.kadence-packages-root
 phpstan-cache/
 package-lock.json
-# Artifacts generated by dev_scripts/partial-phpcs.sh
+# Artifacts generated by dev_scripts/bin/partial-phpcs.sh
 /diff.txt
 /diffcs.txt
 /phpcs.json
+
+# Scratch workspace for subagent-driven-development runs.
+.superpowers/