release: theme-elementary v2 🚀

[aryanjasala]

🎉 Theme Elementary v2 rebuilds the starter on rtCamp's shared WordPress stack: runtime code comes from rtcamp/wp-primitives, and setup, scaffolding, releases and lint configs come from @rtcamp/wp-tooling and the @rtcamp npm packages. Merging this makes v2 what main ships.

✨ What's new

🏗️ Architecture

• PSR-4 PHP under inc/ with a Main bootstrap and a graceful Autoloader: Core/ for theme-wide services, Modules/ for feature areas, Abstracts/ and Helpers/. Strict types throughout. Replaces v1's inc/classes, inc/helpers and inc/traits.
• Built on rtcamp/wp-primitives ^2.0, with theme-owned adapters for its services: asset loading (AssetLoader), components (ComponentLoader), template parts (TemplateLoader), runtime feature flags (FeatureSelector), logging (Logger) and encryption (Encryptor).
• Runtime feature flags under Settings → Features turn retained features on and off without deleting code.

🚀 Setup and scaffolding

• npm run init turns the starter into your theme: name, namespace, text domain and prefixes, which example sets to keep, and which optional features to enable. Run it again later to manage features.
• npx wp-tooling add generates features (custom post types, blocks, REST controllers, WP-CLI commands, settings pages and more) together with their tests.
• Optional development features, on or off at any time:
  • ⚡ HMR: BrowserSync live reload for the frontend, and React Fast Refresh for blocks in the editor.
  • 🌊 Tailwind CSS v4, with theme tokens generated from theme.json.
  • 🛠️ Dev Tools: Query Monitor, the MCP Adapter and rtcamp/wp-dev-tools runtime telemetry in the local wp-env site.

🎨 Assets

• Sources live in src/ (components, CSS, JS, fonts, images) and build to assets/build/, with blocks under assets/build/blocks/. Builds use @wordpress/scripts 36.
• Example components (button, card) show the PHP, JS and SCSS pattern for reusable pieces.

✅ Quality

• PHPUnit suite (101 tests, about 88% line coverage) and Jest suite (59 tests).
• PHPCS with the rtCamp standard (rtcamp/wp-phpcs), PHPStan (rtcamp/wp-phpstan), and ESLint and Stylelint from @rtcamp/eslint-config and @rtcamp/stylelint-config.
• CI through rtCamp/wp-shared-workflows: lint, Jest, build, and PHPUnit across PHP 8.2 to 8.4 and WordPress 6.5 to 7.0.
• No open npm or Composer security advisories.

🤖 AI tooling

• Shared conventions in AGENTS.md, Claude Code skills (/init, /scaffold, /setup), and GitHub Copilot prompts and instructions synced from wp-primitives.
• A committed knowledge graph (graphify-out/) so assistants can query the codebase's structure instead of reading every file.

📚 Docs

• Guides for getting started, initialization, local development, included features, scaffolding, the asset pipeline, HMR and Tailwind, published as a docs site.

⚠️ Breaking changes from v1

v2 is a new starter, not an in-place upgrade. Existing v1-based themes keep working as they are.

• Requires PHP 8.2+, WordPress 6.6+ and Node.js 22.19+.
• New directory layout and namespaces (rtCamp\Theme\Elementary\…); v1's classes, helpers and traits are removed.
• The Composer package is now rtcamp/theme-elementary.
• Build output paths changed (assets/build/…).

🧪 Testing

• CI on this PR: lint, Jest, build, and the PHPUnit matrix
• Locally, on the merged v2: npm ci on npm 10 and 11, lint:all, Jest, build:prod, PHPCS, PHPStan, PHPUnit through wp-env, block HMR and BrowserSync against a running site, and npm run init on a fresh copy