Skip to content

Add mobile-ui version labels to the docs - #544

Merged
simonhamp merged 1 commit into
mainfrom
mobile-ui-docs-versions
Sep 30, 2026
Merged

simonhamp merged 1 commit into
mainfrom
mobile-ui-docs-versions

Conversation

@simonhamp

Copy link
Copy Markdown
Member

The EDGE components ship in nativephp/mobile-ui, which has its own release line (0.1 to 0.7). The docs version badge only understood NativePHP for Mobile versions, so there was no way to say a component or prop needs a newer mobile-ui.

<x-docs.version-badge> now takes a package attribute:

<x-docs.version-badge package="mobile-ui" since="0.6" />

For a whole page, use package: mobile-ui and since: "0.6" in the front matter. The pill reads "mobile-ui 0.6", the tooltip names nativephp/mobile-ui, and it links to a new "mobile-ui labels" section on the versioning page. That section also covers the upgrade catch: Composer's ^0.5 never installs 0.6, so you have to raise the constraint and rebuild.

Package details live in a new docs.packages config entry. Labels at or below 0.3 don't render, because 0.3 was current when mobile 4.0.0 shipped. That mirrors how x.0 never renders for core labels.

Labels added

20 labels across 7 pages. Each one was traced to the code at the mobile-ui tags, because the GitHub release notes turned out to be unreliable for this.

  • Accordion page: 0.4. Pager page: 0.5.
  • Text input: selection events and per-platform icons (0.4), autocapitalize and the capitalization rules (0.5).
  • Per-platform icons on button, chip and tab row: 0.4.
  • native:font: changed in 0.4, when its options were reworked, plus the three options it gained.

Nothing documented needed a 0.6 or 0.7 label. Those releases were bug fixes or features that aren't documented yet.

Tests

The guard test now checks package labels against the package's own released versions and flags unknown packages. It also rejects unquoted versions in front matter. YAML reads since: 0.10 as the number 0.1, and the old check accepted that.

Things to check

  • When a new mobile-ui version ships, add it to docs.packages.mobile-ui.released_versions before using it in a label, or the guard test fails.
  • The "Centering short content" pattern on the scroll view page only works from 0.5. It came in as a bug fix, so it's left unlabelled. Easy to add if we'd rather flag it.

🤖 Generated with Claude Code

The EDGE components ship in nativephp/mobile-ui, which has its own
release line, so the docs version badge had no way to say a feature
needs a newer mobile-ui. The badge now takes a package attribute,
backed by a docs.packages config entry, and 20 labels mark what
arrived after 0.3, the release current when mobile 4.0.0 shipped.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@simonhamp
simonhamp marked this pull request as ready for review September 30, 2026 16:56
@simonhamp
simonhamp merged commit 9d30e0d into main Sep 30, 2026
3 checks passed
@simonhamp
simonhamp deleted the mobile-ui-docs-versions branch September 30, 2026 17:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant