[Blueprints] Type Blueprint v2 theme collision handling - #3867
Merged
Conversation
adamziel
force-pushed
the
type/blueprint-v2-theme-if-already-installed
branch
from
July 2, 2026 16:54
2bff584 to
72fa845
Compare
adamziel
added a commit
that referenced
this pull request
Jul 2, 2026
## What? Allows Blueprint v2 WXR content definitions to type `source` as either one file reference or a list of file references. ## Why? Other content import types already accept source lists. WXR imports can also be split across multiple files, and TypeScript consumers should be able to declare that without falling out of the v2 declaration type. ## Scope This is type-only. It does not change import execution, author mapping, URL rewriting, or runner behavior. ## Stack Base: #3867 ## Testing - `npm run format:uncommitted` - `git diff --check` - `npm exec nx run playground-blueprints:typecheck` - `npm exec nx run playground-blueprints:lint` - `npm exec nx run playground-blueprints:test:vite -- --testFiles=packages/playground/blueprints/src/tests/v2/blueprint-v2-declaration.spec.ts`
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What?
Types the Blueprint v2 theme
ifAlreadyInstalledpolicy asoverwrite | skip | error.Why?
Plugin installs already expose the collision policy in the v2 declaration type. Theme installs use the same policy shape, and typing it lets TypeScript consumers catch invalid values before a Blueprint reaches a runner.
Scope
This is type-only. It does not change the Blueprint v2 runner or theme install behavior.
Stack
Base: #3866
Testing
npm run format:uncommittedgit diff --checknpm exec nx run playground-blueprints:typechecknpm exec nx run playground-blueprints:lintnpm exec nx run playground-blueprints:test:vite -- --testFiles=packages/playground/blueprints/src/tests/v2/blueprint-v2-declaration.spec.tsPart of #2592.