|
| 1 | +# CSS contract refresh, 2026-11-01 |
| 2 | + |
| 3 | +## Refresh {#refresh} |
| 4 | + |
| 5 | +The committed snapshot dated from `095ce731d` and no longer matched `rc`. This refresh records the output of `rc` at `76b80ebb9` plus the follow-up commits on `design/followups`. It was approved in the 2026-11-01 refactor session ("全做"). |
| 6 | + |
| 7 | +### Drift already on rc (`095ce731d` → `76b80ebb9`) |
| 8 | + |
| 9 | +Nine commits since the old snapshot changed site output: |
| 10 | + |
| 11 | +- `dacbf69eb` rebuilt the Reference as structured sheets. |
| 12 | +- `85f210253` consolidated the Guide into task pages. |
| 13 | +- `acac92606` made fixed values static utilities and renamed the gap axes. |
| 14 | +- `d58b586e4` shared the typed Manifest v6 model. |
| 15 | +- The rest were site polish and tooling commits: `d782e8f91`, `9e6842f95`, `5571a4496`, `4206fd97e` and `d962c7452`. |
| 16 | + |
| 17 | +| Change | Count | |
| 18 | +| --- | --- | |
| 19 | +| Routes removed (mostly consolidated `/guide/installation/*`, `/tw/guide/*` and `/tw/reference/*` pages) | 148 | |
| 20 | +| Routes added (Reference sheets and consolidated guides) | 24 | |
| 21 | +| Shared routes with a different CSS contract | 221 | |
| 22 | + |
| 23 | +The project manifest also changed for the same reasons: `radius-pill` became the static `pill` utility, and the spacing and direct-value families moved. |
| 24 | + |
| 25 | +### This change set |
| 26 | + |
| 27 | +Compared against a build of `76b80ebb9` with the same toolchain, the delta is fully attributed. Preset shadow values were substituted before comparing. |
| 28 | + |
| 29 | +- Four delivered CSS segments that hold preset `--shadow-*` values now carry the converged shadows. |
| 30 | +- `/design-system/review/comparison` and `/design-system/review/label` (and their `/tw` copies) list every shadow token. They gain `--shadow-inset` and `.shadow-inset`. |
| 31 | +- The manifest gains the converged shadow values, `--shadow-inset` and eleven `--max-*` custom media. Keyframe ids change their file-hash prefix because `theme.css` changed; their offsets are unchanged. |
| 32 | +- `@max-md` and the new lint examples appear only in documentation code, not in delivered site CSS. |
| 33 | + |
| 34 | +### Visual check |
| 35 | + |
| 36 | +The routes below were captured from the static build at 1280px in light and dark: |
| 37 | + |
| 38 | +- `/` |
| 39 | +- `/guide/introduction` |
| 40 | +- `/guide/responsive-design` |
| 41 | +- `/guide/code-linting` |
| 42 | +- `/reference/tokens/shadow`: Values lists `shadow-inset`, and the Usage preview shows the converged `shadow-xs` and `shadow-lg`. |
| 43 | +- `/reference/tokens/breakpoints`: the new "Below viewport widths" group. |
| 44 | +- `/design-system/review/comparison` |
| 45 | + |
| 46 | +No layout regressions were seen. The rc drift above was reviewed by its own commits; it is recorded here, not re-reviewed page by page. |
0 commit comments