Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ sources and run `npm run generate`.

## The check loop

CI picks the checks a change needs (D-031); `release-gate` is the only required
CI picks the checks a change needs (D-031, `docs/ci.md`); `release-gate` is the only required
check and passes when every selected check passed. See the plan before you
push:

Expand Down
16 changes: 16 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,22 @@

## [Unreleased]

- **`focus.ring-contrast`** (D-040): the 1px dashed control ring in
`interaction.focus.ring-container`, for controls on a fill and invalid
fields beside the danger border. Twelve components use it instead of the
written-out ring; rendering is unchanged. Every port classifies it.
- **Code and terminal backgrounds** (D-039). `surface.code` and
`surface.terminal` describe what a code block or terminal pane sits on;
`code.bg` and `terminal.bg` the inside of an editor and a terminal grid.
Values are unchanged.
- **Hover popups stay reachable.** The token inspector and the tooltip keep
their popup open while the pointer crosses to it, so a long inspector can be
scrolled; leaving both closes it after 300 ms, never while keyboard focus
is on its trigger or inside it (WCAG 1.4.13). The passive hex preview is
unchanged.
- **Specs.** A loading indicator's label is always visible. The progress spec
no longer suggests a track that fails 3:1. CI selection rules moved from
D-031 to `docs/ci.md`.
- **Display and title type sizes** (D-037): `font.size.display` 32/40 and
`font.size.title` 24/32 with their line heights, for page heroes, metric
figures and page titles.
Expand Down
31 changes: 31 additions & 0 deletions docs/ci.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# CI

How CI picks the checks a change runs (D-031). `scripts/ci/select.mjs`
computes the plan; run it before you push:

```
node scripts/ci/select.mjs --event pull_request --base origin/main --head HEAD
```

CI is `select` → checks → `release-gate`.

- `select` reads the changed paths and `scripts/ci/proofs.json`; a path gets
cheaper only when a rule claims it. Unclaimed paths and control files
(workflows, the selector and registry, `package.json`, the lockfile, the
Playwright configs) run every check. On a pull request the base commit's
control list also applies, so a change cannot make itself cheaper. A file a
browser spec imports runs that spec and counts as a site change.
- A pull request runs only the selected checks, unit tests and build in
parallel; browser subsets write no evidence (D-028).
- A push to `main` that changes the site runs the whole matrix in shards
(desktop in four parts; projects read from the Playwright config), with
packed consumers in parallel. Blob reports merge once into the evidence
reporter, which refuses a missing shard or configured test; then the
verification report and deployment. No site change, no deployment. Changed
paths count from the last commit that reached Pages.
- `release-gate`, the only required check, recomputes the plan from Git with
the same code and checks each job ran as planned and passed.
- `fullyParallel`, two workers per CI job, zero retries. The page axe scan is
two tests (colour contrast; every other rule) covering exactly the tagged
rules. Only an unnarrowed `playwright test`, or the merge of every shard,
writes evidence.
2 changes: 1 addition & 1 deletion exports/components/admin-form.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/admin-form.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/alert.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/alert.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/avatar.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/avatar.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/badge.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/badge.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/breadcrumbs.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/breadcrumbs.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/button-group.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/button-group.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/button.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/button.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/card.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/card.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/chart.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/chart.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/checkbox.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/checkbox.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/chip.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/chip.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/code-editor.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/code-editor.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/combobox.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/combobox.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/command-palette.brief.txt

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion exports/components/command-palette.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading
Loading