Release/WDSBT v1.4

[khleomix]

Release: WDS-BT 1.4.0

Description

1.4 features (product)

• Block Showcase – Admin-only tool to discover, preview, and inspect all registered blocks with their attributes.
• Template-specific style loading – Template and CPT CSS built separately and enqueued only when the request matches (404, search, archive, page templates, CPTs). Auto-discovered from build/css/templates/; no PHP config. Reduces unused CSS for better Lighthouse scores.
• Automatic cache versioning – All theme-built CSS/JS use file modification time as the ver query string; caches update after each build without manual version bumps.
• Lighthouse script – npm run lighthouse for Performance, Accessibility, Best Practices, and SEO (mobile + desktop); scores in terminal only. URL via prompt or CLI arg.
• Dominant Color Images – Automatic dominant color calculation and storage for uploads; used as placeholders while images load.
• Image Prioritizer – Adds fetchpriority="high" to above-the-fold images for improved LCP.
• WebP Uploads – Automatically generates WebP versions of uploaded JPEG/PNG for better compression and loading.
• ESLint 9 – Migrated to ESLint 9 with flat config.

---

Strict linting and no-verify policy

• PHP (PHPCS) – Warnings treated as failures (--runtime-set ignore_warnings_on_exit 0 in run-phpcs.sh). WPCS set to ^3.3 in composer.json.
• JavaScript (ESLint) – --max-warnings 0 in npm run lint:js and in Lefthook pre-commit.
• CSS/SCSS (Stylelint) – --max-warnings 0 in npm run lint:css and in Lefthook pre-commit.
• Fix-on-commit – Lefthook runs auto-fix (PHPCBF, Prettier, Stylelint --fix, ESLint --fix), re-stages changed files, then runs strict lint. Documented in README and docs.
• No-verify – Use of git commit --no-verify / git push --no-verify is prohibited; documented in README and CONTRIBUTING; CI runs the same checks on PRs.

---

Documentation refactor

• docs/ folder – Full content moved into focused guides: development.md, fonts.md, version-management.md, linting-and-hooks.md, performance.md, block-showcase.md, customizations.md, accessibility-and-quality.md. docs/README.md is the index.
• Main README – Slimmed to an overview: feature table, requirements, getting started, short “Documentation” section with links to docs/, and brief summaries per topic with links to the relevant doc.
• Links – All internal README and docs links verified (files and anchors).
• Lefthook/consistency – “Lefthook” (not “LeftHook”) used consistently; “Fixes on commit” and no-verify policy clearly stated.

Post-merge release steps

• Tag release: git tag -a v1.4.0 -m "Release 1.4.0"
• Push tag: git push origin v1.4.0
• Create GitHub release from tag

Mobile & Desktop Screenshots/Recordings

WDS-BT-Theme.5.mp4

Added to documentation?

• 📜 README.md (and docs/)
• 📓 ClickUp
• 🙅 No documentation needed

Added tests?

• 👍 Yes
• 🙅 No, because they aren't needed
• 🙋 No, because I need help

Testing Instructions

1. Check out this branch and run npm run setup.
2. Run npm run build and confirm build completes; note cache version in output.
3. Run npm run lint and npm run a11y (with a test URL) – all should pass.
4. In WordPress admin, create a new Page, assign Block Showcase template, publish – confirm blocks list and preview.
5. Run npm run lighthouse (optional) – confirm scores for mobile/desktop.
6. Confirm theme version 1.4.0 in style.css and package.json.

---

Reviewer's Testing Checklist

• Visual / regression – No negative impact on existing front-end or editor.
• Cross-browser – Test on Chrome, Firefox, Safari as needed.
• Linting – PHPCS, ESLint, Stylelint pass (CI).
• Accessibility – npm run a11y passes or known issues documented.
• Security – Security workflow passes.
• Documentation – README and docs/ are accurate and linked correctly.
• Version – 1.4.0 reflected in style.css, package.json, composer.json, README.

[optional] Additional Reviewer Notes or Considerations?

• Lefthook runs fix + strict lint on commit; contributors must not use --no-verify.
• WPCS dependency set to ^3.3 in composer.json for latest WordPress standards.

[thatmitchcanter]

Looks great - approved @khleomix as best as I can (it's a large PR)