Skip to content

[Toolkit] Add added-in-version property to Recipe manifests#3532

Closed
Amoifr wants to merge 1 commit into
symfony:2.xfrom
Amoifr:feature/toolkit-recipe-added-in-version
Closed

[Toolkit] Add added-in-version property to Recipe manifests#3532
Amoifr wants to merge 1 commit into
symfony:2.xfrom
Amoifr:feature/toolkit-recipe-added-in-version

Conversation

@Amoifr
Copy link
Copy Markdown
Contributor

@Amoifr Amoifr commented May 11, 2026

Q A
Bug fix? no
New feature? yes
Issues Refs #3509
License MIT

Following @Kocal's suggestion in #3509, this PR introduces an optional added-in-version property in the Recipe manifest schema. It exposes the value as RecipeManifest::$addedInVersion, ready to be consumed by ux.symfony.com to advertise the minimum UX Toolkit version required for each recipe.

Changes

  • schema-kit-recipe-v1.json: declare the optional added-in-version property.
  • Recipe/RecipeManifest.php: new constructor argument + parsing with validation (null or non-empty string).
  • Tests/Recipe/RecipeManifestTest.php: three new tests (with value, with empty string, with non-string).

Scope

Intentionally minimal. Existing manifests are not touched — the field is purely additive and they remain valid. The follow-up effort (populating added-in-version on the 51 existing recipes) is more delicate, since several recipes were renamed/restructured (e.g. #3107) and the introduction version doesn't always match the file's git creation date. That part is better driven by the maintainers who know the history, or split into smaller PRs per kit.

cc @Kocal — happy to take a stab at the manifest-population follow-up too once this foundation lands, if you'd like.

Adds an optional `added-in-version` property to the Recipe manifest
schema, exposed as `RecipeManifest::$addedInVersion`. This unblocks
displaying the minimum UX Toolkit version required for each Kit recipe
on ux.symfony.com (per the discussion in symfony#3509).

The property is purely additive — existing manifests remain valid. A
follow-up PR can populate the field on existing recipes once the
introduction version of each is identified.

Refs symfony#3509
@Kocal
Copy link
Copy Markdown
Member

Kocal commented May 11, 2026

Thanks for your contribution, but @MrYamous already opened #3531 ~16 hours ago and, naturally, I'd prefer to merge his PR (first come, first served 😄)

Thank you anyway!

@Kocal Kocal closed this May 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Feature New Feature Status: Needs Review Needs to be reviewed Toolkit

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants