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
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Fixed

- The `worst-case` initials fix skips a generational suffix, so `Christopher Alexander Montgomery III` no longer still yields `CI`, and a field with no limit is reported as "no limit found", which says what the search showed.
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
bump: patch
---

### Fixed

- The theming reference no longer says the iOS status-bar style tag shares the manifest's theme color decision: that tag takes a style keyword, not a color, per Apple's meta tag reference.
- The choreography rules no longer describe a guard that holds input until a buildup finishes, which contradicted the rule that motion never blocks input.
- The glossary's perceptual duration entry reads as a definition.
78 changes: 41 additions & 37 deletions docs/upstream/emilkowalski-skills.md

Large diffs are not rendered by default.

8 changes: 4 additions & 4 deletions plugins/testing/skills/run-e2e/context/worst-case.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,8 @@ the dirty-file refusal, the revert proof or `--keep`; report it under What broke

1. **Plausible or schema-backed, never random.** Each value is something a real user could produce,
or the actual limit from the validation schema, database column or API contract. A field with
no limit anywhere is a finding: say "unbounded" and test something long but believable. Never
use strings of one repeated character.
no limit anywhere is a finding: say "no limit found" and test something long but believable.
Never use strings of one repeated character.
2. **Change the data, not the component.** The worst case enters through the same boundary the demo
data does. Never edit markup or styles to produce a break.
3. **One dataset, many failures.** Spread different failures across the first rows on screen, as
Expand Down Expand Up @@ -60,7 +60,7 @@ List every value the target renders with its source, type, limit and whether it
| Field | Source | Type | Limit | Optional |
|---|---|---|---|---|
| `name` | `member.name` | string | 255 (`schema:14`) | no |
| `count` | `workspace.memberCount` | integer | unbounded | no |
| `count` | `workspace.memberCount` | integer | no limit found | no |

Include the values people forget: counts in headings, relative times, badge and status text,
labels that come from data, tooltips, images, and the list itself (its length is a value). Read
Expand Down Expand Up @@ -200,7 +200,7 @@ equivalents instead of applying these fixes.
| An avatar adrift beside a three-line name | rows of varying height centered | top-align once text can wrap |
| The last row cut mid-glyph | a fixed-height box with no scroll affordance | a visible scrollbar or a fade, and intended overflow |
| A heading breaks mid-word | break-all word breaking | break only when needed |
| Wrong initials | splitting on the first space and taking a code unit | initials from grapheme clusters, first and last word, a fallback icon |
| Wrong initials | splitting on the first space and taking a code unit | initials from grapheme clusters, first and last word with a generational suffix (Jr, III) skipped, a fallback icon |
| An orphaned dash where an optional field was | a placeholder for a missing value | omit the line or reserve its height on purpose |
| "1 members" | a hardcoded plural | locale plural rules or separate strings |
| Numbers jitter as they update | proportional figures | tabular figures |
Expand Down
4 changes: 2 additions & 2 deletions plugins/user-interface/reference/animation/catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -432,8 +432,8 @@ moving parts, then run what is left in parallel unless the order means something
once, with no reverse stagger, along the path it entered by (`exit` in behaviors.md).
9. **Interruption.** A re-trigger mid-sequence stops every animation still running before starting
the next; never stack them. Anything that resumes afterwards (an idle loop) waits until every
reset animation has finished. A guard that only gates input (the buildup has finished) is not
rendered state. Rapid switching must never leave two views mounted.
reset animation has finished. Input is never held until a buildup finishes (`stagger`
above). Rapid switching must never leave two views mounted.
10. **Attention loops.** An idle hint that invites interaction holds off for several seconds at
first, repeats rarely, stops during interaction, and restarts once the reset completes.
11. **Reduced motion collapses the choreography**: no delays, no movement, the group appears
Expand Down
15 changes: 10 additions & 5 deletions plugins/user-interface/reference/types/web/theming.md
Original file line number Diff line number Diff line change
Expand Up @@ -253,8 +253,9 @@ mode gets a dark bar or dark mode gets a white one. Give each scheme its own:
Match the value to the color at the very top of your page: the header background, not the brand
color. In Next.js set it through the `viewport` export (`themeColor: [{ media, color }]`). If the
app switches theme with a class rather than the OS setting, update the tag from JavaScript on
toggle. For an installed PWA, `apple-mobile-web-app-status-bar-style` and the manifest's
`theme_color`/`background_color` are the same decision. Read the colors from the project's tokens.
toggle. For an installed PWA, the manifest's `theme_color`/`background_color` are the same
decision. `apple-mobile-web-app-status-bar-style` takes a style keyword, not a color; Apple's meta
tag reference below lists them. Read the colors from the project's tokens.
Never invent them.

The `color-scheme` line in that block is for a two-theme app; a single-theme app follows section 2.
Expand All @@ -269,11 +270,15 @@ fix the theme depends on; which browsers apply it is in the MDN pointer below.
manifest `theme_color` and the meta tag that overrides it per scheme,
<https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/theme_color#description>;
Apple, Safari Web Content Guide, "Changing the Status Bar Appearance",
<https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariWebContent/ConfiguringWebApplications/ConfiguringWebApplications.html#//apple_ref/doc/uid/TP40002051-CH3-SW1>
- **As of**: 2026-10-29
<https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariWebContent/ConfiguringWebApplications/ConfiguringWebApplications.html#//apple_ref/doc/uid/TP40002051-CH3-SW1>;
Apple, Safari HTML Reference, "Supported Meta Tags", the
`apple-mobile-web-app-status-bar-style` entry,
<https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariHTMLRef/Articles/MetaTags.html>
- **As of**: 2026-11-16
- **Recheck trigger**: MDN's page changes its Baseline status or what `media` does, Next.js renames
the `themeColor` field, the manifest page gains a per-scheme `theme_color`, or Apple retires the
archived guide.
archived guide or the Safari HTML Reference's meta tag page, or changes the status-bar style
keywords that page lists.

Autofilled inputs get the browser's pale yellow or blue background regardless of theme; if that
breaks a dark form, override it:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -125,7 +125,7 @@ parameter, which platforms express differently.

### Perceptual duration

How long a spring feels finished, though it keeps micro-settling.
How long until a spring looks done, though it keeps settling by tiny amounts after that.

**Versus:** a duration ends an eased animation exactly; a spring's perceptual duration is when it
looks done.
Expand Down
Loading