Skip to content

docs(changelog): amend 1.15.0 notes for the @base-ui/react 1.6.0 → 1.8.0 bump - #562

Merged
interacsean merged 4 commits into
mainfrom
docs/1945-base-ui-1.8-release-notes
Sep 30, 2026
Merged

interacsean merged 4 commits into
mainfrom
docs/1945-base-ui-1.8-release-notes

Conversation

@interacsean

Copy link
Copy Markdown
Contributor

Summary

@tailor-platform/app-shell@1.15.0 bumped @base-ui/react from 1.6.0 to 1.8.0 (#517, commit 6e4f783). Its release note said only that Base UI moved to 1.8.0. It gave no from-version and named no behaviour change, but two upstream changes break consumer tests:

  1. Select no longer renders its options into the DOM until it is opened, so unit tests that assert option text on a closed Select fail.
  2. Opening a Dialog/AlertDialog applies a scroll lock that shifts layout during a Playwright click, so a coordinate click can land on the backdrop and close the dialog.

This PR fixes the notes after the fact and adds a rule so the next UI-foundation bump documents this up front.

Changes

  • packages/core/CHANGELOG.md: amends only the 6e4f783 bullet in the 1.15.0 section. It now gives 1.6.0 → 1.8.0, lists both behaviour changes with the test-side fix, links to the migration entry, and ends with an italic note that the entry was amended after release. No other entry is touched.
  • docs/migrations.md: adds a 1.15.0 row and section (applies to / what breaks / how to detect / what to change). An app that changes nothing can still fail CI after upgrading, so it belongs on this page.
  • docs-manifest.json: hash refresh from pnpm docs:sync. docs/migrations.md is copied into the bundled skill, and the drift gate needs this.
  • .changeset/amber-owls-listen.md: patch changeset. The CHANGELOG inside the published 1.15.0 tarball can't change, so the next release's npm CHANGELOG carries a short pointer instead.
  • .agents/skills/create-changeset/SKILL.md: new summary rule. A changeset for a UI-foundation bump (@base-ui/react and similar) must give from→to versions and list the behaviour or test-visible changes found in the PR's snapshot diffs.

No package code or version changes.

Not in this PR: ticket action 6, the version policy question (should a Base UI minor bump be an app-shell minor?). That still needs a maintainer decision.

After merge

Update the GitHub release body for @tailor-platform/app-shell@1.15.0 with the amended section. The current body is the CHANGELOG's 1.15.0 section without its heading, so extract the same range from main:

git fetch origin main
git show origin/main:packages/core/CHANGELOG.md \
  | awk '/^## 1\.15\.0$/{f=1; next} /^## /{f=0} f' > /tmp/app-shell-1.15.0-notes.md
gh release edit "@tailor-platform/app-shell@1.15.0" \
  --repo tailor-platform/app-shell \
  --notes-file /tmp/app-shell-1.15.0-notes.md

The italic "amended after release" note is part of the extracted section, so the release body carries it too.

Checks

  • pnpm fmt:check: clean (CHANGELOG.md is excluded from oxfmt by .oxfmtrc.json)
  • pnpm docs:check: no blocking issues after pnpm docs:sync

🤖 Generated with Claude Code

…8.0 bump

The 1.15.0 entry for 6e4f783 said only that Base UI moved to 1.8.0. It did
not give the from-version or name the two upstream behaviour changes that
break consumer tests: closed `Select` no longer renders its options, and the
dialog scroll lock can move a button under a Playwright coordinate click.

- Amend the 1.15.0 CHANGELOG bullet with both changes and the test-side fix
- Add a 1.15.0 entry to docs/migrations.md (and resync docs-manifest.json)
- Add a patch changeset so the next npm CHANGELOG carries a pointer
- Require from→to versions and behaviour changes for UI-foundation bumps in
  the create-changeset skill

Refs tailor-inc/platform-planning#1945

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@interacsean
interacsean requested a review from a team as a code owner September 29, 2026 04:52
@github-actions

github-actions Bot commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

Code Metrics Report

main (c3e4b52) #562 (13954bc) +/-
Coverage 87.5% 87.5% 0.0%
Test Execution Time 2m20s 2m13s -7s
Details
  |                     | main (c3e4b52) | #562 (13954bc) | +/-  |
  |---------------------|----------------|----------------|------|
  | Coverage            |          87.5% |          87.5% | 0.0% |
  |   Files             |            206 |            206 |    0 |
  |   Lines             |           6082 |           6082 |    0 |
  |   Covered           |           5323 |           5323 |    0 |
+ | Test Execution Time |          2m20s |          2m13s |  -7s |

Reported by octocov

interacsean and others added 3 commits September 30, 2026 14:16
@interacsean
interacsean merged commit 486607c into main Sep 30, 2026
8 checks passed
@interacsean
interacsean deleted the docs/1945-base-ui-1.8-release-notes branch September 30, 2026 04:44
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.

2 participants