[Blueprints] Compile Blueprint v2 declarations into an execution plan

[adamziel]

What it does

Extracts the compile-only part of the native TypeScript Blueprint v2 runner work from #3725. compileBlueprintV2() now turns a parsed v2 declaration into a typed BlueprintV2ExecutionPlan while preserving runtime metadata and applicationOptions.

The plan records the ordered work implied by v2 fields such as constants, siteOptions, muPlugins, themes, activeTheme, plugins, fonts, media, siteLanguage, roles, users, postTypes, content, and additionalStepsAfterExecution.

Rationale

This lets us review the v2 parser/compiler shape separately from execution. The current PR does not resolve resources, lower v2 data references into v1 resources, call v1 step handlers, or wire the plan into existing consumer data flows.

Non-empty v2 plans still fail at run() with an explicit UnsupportedBlueprintV2FeatureError, so callers cannot accidentally treat parsed-but-unwired v2 declarations as executed.

Implementation

Adds BlueprintV2ExecutionPlan and BlueprintV2ExecutionPlanItem types in lib/v2/compile.ts. createBlueprintV2ExecutionPlan() mirrors the ordering from the broader TypeScript runner work while keeping each item in v2-shaped data:

{ type: 'defineWpConfigConsts', consts }
{ type: 'setSiteOptions', options }
{ type: 'installPlugin', plugin, sourcePath: '/plugins/0' }
{ type: 'runStep', step, sourcePath: '/additionalStepsAfterExecution/0' }

Minimal v2 declarations still compile and run as a no-op. Declarations with planned work compile successfully but reject on run() until follow-up PRs wire individual plan items.

Testing instructions

npm run format:uncommitted
npm exec nx run playground-blueprints:test:vite -- --testFiles=packages/playground/blueprints/src/tests/compile.spec.ts
npm exec nx run playground-blueprints:typecheck
npm exec nx run playground-blueprints:lint
npm exec nx run playground-blueprints:build
npm exec nx run playground-blueprints:test:vite
git diff --check

Part of #2592.

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

This PR extracts the compile-only portion of the Blueprint v2 TypeScript runner by compiling parsed v2 declarations into a typed BlueprintV2ExecutionPlan, while preserving runtime metadata and applicationOptions, and ensuring non-empty plans still reject at run() until execution wiring lands.

Changes:

• Introduces BlueprintV2ExecutionPlan / BlueprintV2ExecutionPlanItem types and createBlueprintV2ExecutionPlan() to produce an ordered plan from v2 declaration fields.
• Updates compileBlueprintV2() to return { runtime, applicationOptions, plan } and to reject run() when the plan is non-empty.
• Expands test coverage to validate plan ordering/shape and the “not runnable yet” guard.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
packages/playground/blueprints/src/lib/v2/compile.ts	Adds execution plan types + compiler that produces an ordered plan and gates run() on plan emptiness.
packages/playground/blueprints/src/tests/compile.spec.ts	Adds tests for v2 plan compilation, ordering, metadata preservation, and runtime rejection behavior.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.