@12-apps/ui 6.25.0 → 6.27.0

package/dist/types-native/components/data-display/Alert/Alert.base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Alert.base.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Alert/Alert.base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5F;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,GAC9D;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;IAE7C;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAEjC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE3B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,YAAY,CAAC"}
+{"version":3,"file":"Alert.base.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Alert/Alert.base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5F;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,GAC9D;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAElC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;IAE7C;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAEjC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE3B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,YAAY,CAAC"}

package/dist/types-native/components/data-display/Alert/Alert.helpers.d.ts

@@ -12,6 +12,45 @@ export type ResolvedAlertProps<P extends AlertBaseFields> = P & Required<Pick<Al
 export declare const resolveAlertProps: <P extends AlertBaseFields>(props: P) => ResolvedAlertProps<P>;
 /** `danger` announces itself; everything else waits its turn. */
 export declare const defaultAriaLive: (variant: AlertVariant) => "polite" | "assertive";
+/**
+ * The ARIA role each `announce` level is spelled with.
+ *
+ * Both roles carry an IMPLICIT live setting, and that implicit one is what
+ * assistive tech acts on — `alert` is assertive, `status` is polite. Pairing
+ * them here is what stops `role` and `aria-live` from contradicting each
+ * other, which they do by default: every alert is `role="alert"` regardless of
+ * variant, so an `info` alert asks to be polite in one attribute and to
+ * interrupt in the other.
+ */
+export declare const ANNOUNCE_ROLE: Record<NonNullable<AlertBaseFields['announce']>, string>;
+/**
+ * The two attributes that decide whether an alert interrupts, resolved TOGETHER.
+ *
+ * Both renderers therefore let `role` and `announce` leave their destructure
+ * unused (`_role`, `_announce`) and call this instead — the first because the
+ * defaults have already answered it, the second because it must never reach
+ * the DOM.
+ *
+ * Reads the caller's own props rather than the defaulted ones, because the
+ * whole question is which of them the caller actually spelled:
+ * {@link ALERT_DEFAULTS} supplies `role: 'alert'` for everything, so after the
+ * merge there is no longer any difference between an alert that asked to
+ * interrupt and one that never mentioned it.
+ *
+ * Precedence, most specific first — an explicit `role` or `aria-live` beats
+ * `announce`, so a call site that already spells either by hand is untouched:
+ *
+ *  1. `role` / `aria-live` as given;
+ *  2. {@link AlertBaseFields.announce}, which supplies both;
+ *  3. today's behaviour — `ALERT_DEFAULTS.role` and {@link defaultAriaLive}.
+ *
+ * With none of the three named, the result is byte-for-byte what it was before
+ * `announce` existed.
+ */
+export declare const resolveAnnouncement: (props: Pick<AlertBaseFields, "announce" | "role" | "aria-live">, variant: AlertVariant) => {
+    role: string;
+    "aria-live": "polite" | "assertive" | "off";
+};
 export declare const testIdFor: (base: string | undefined, suffix: string) => string;
 /**
  * The glyph each semantic variant carries, by the shared icon set's name.

package/dist/types-native/components/data-display/Alert/Alert.helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Alert.helpers.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Alert/Alert.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,KAAK,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;AAEzG,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAA;CASnG,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,GAC3D,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAYtD,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,eAAe,EAAE,OAAO,CAAC,KAAG,kBAAkB,CAAC,CAAC,CACP,CAAC;AAEtF,iEAAiE;AACjE,eAAO,MAAM,eAAe,GAAI,SAAS,YAAY,KAAG,QAAQ,GAAG,WACpB,CAAC;AAEhD,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG,SAAS,EAAE,QAAQ,MAAM,KAAG,MACrB,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAKhE,CAAC"}
+{"version":3,"file":"Alert.helpers.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Alert/Alert.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,KAAK,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;AAEzG,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAA;CASnG,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,GAC3D,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAYtD,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,eAAe,EAAE,OAAO,CAAC,KAAG,kBAAkB,CAAC,CAAC,CACP,CAAC;AAEtF,iEAAiE;AACjE,eAAO,MAAM,eAAe,GAAI,SAAS,YAAY,KAAG,QAAQ,GAAG,WACpB,CAAC;AAEhD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAGlF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,MAAM,GAAG,WAAW,CAAC,EAC/D,SAAS,YAAY,KACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAA;CAM7D,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG,SAAS,EAAE,QAAQ,MAAM,KAAG,MACrB,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAKhE,CAAC"}

package/dist/types-native/components/data-display/Alert/Alert.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Alert.native.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Alert/Alert.native.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EASL,IAAI,EAEL,MAAM,cAAc,CAAC;AActB,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,sBAAsB,CAAC;AA4KrE,eAAO,MAAM,KAAK,yEAsChB,CAAC"}
+{"version":3,"file":"Alert.native.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Alert/Alert.native.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EASL,IAAI,EAEL,MAAM,cAAc,CAAC;AActB,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,sBAAsB,CAAC;AA4KrE,eAAO,MAAM,KAAK,yEA0ChB,CAAC"}

package/dist/types-native/components/form/Switch/Switch.look.native.d.ts

@@ -32,8 +32,32 @@ export type SwitchPaint = Pick<SwitchBaseProps, SwitchFlagKeys>;
  * gradient fill — and `glass` its paper wash without the blur.
  */
 export declare function trackStyle(theme: UiTheme, paint: SwitchPaint, palette: SwitchPalette, geometry: SwitchGeometry, look: SwitchLook, state: SwitchState): ViewStyle;
-/** The knob: white, round for iOS and the default, squarer for Android and Material. */
-export declare function thumbStyle(theme: UiTheme, paint: SwitchPaint, geometry: SwitchGeometry, look: SwitchLook, state: SwitchState): ViewStyle;
+/**
+ * The ink on the CHECKED track — the thumb, and the `on` wording (FUT-1924).
+ *
+ * Both halves of the component had a stated `#fff` here, and the checked track
+ * is the one surface a tenant chooses: a pale brand got a white knob on a pale
+ * bar, which reads as OFF while it is on.
+ *
+ * **The fills are THIS renderer's, not the web's, and they differ.** The web
+ * paints a real three-stop gradient and hands `checkedInk` all three
+ * (`Switch.styles.ts`); React Native has no gradient without a dependency, so
+ * `trackStyle` shows `gradientFirstStop` — `palette.light`, FLAT — and
+ * `NATIVE-NOTES.md` records that as a known divergence. Passing the web's set
+ * here would judge the ink against two fills native never draws, and the two
+ * renderers then disagree on the same palette: measured on `#00897b`, the web
+ * answers white and this answered dark ink, because `main` and `dark` were in
+ * the list and only `light` is on screen.
+ *
+ * So the gradient case is ONE fill, which is the one it paints.
+ */
+export declare function checkedInk(paint: SwitchPaint, palette: SwitchPalette): string;
+/**
+ * The knob: round for iOS and the default, squarer for Android and Material.
+ * White while resting, the checked track's own ink once on — see
+ * {@link RESTING_THUMB} and {@link checkedInk}.
+ */
+export declare function thumbStyle(theme: UiTheme, paint: SwitchPaint, palette: SwitchPalette, geometry: SwitchGeometry, look: SwitchLook, state: SwitchState): ViewStyle;
 /** MUI's `body2` at 500, in the error hue when the row is in error. */
 export declare function labelTextStyle(theme: UiTheme, error: boolean): TextStyle;
 /** MUI's `caption`, 4px under the label. */

package/dist/types-native/components/form/Switch/Switch.look.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Switch.look.native.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.look.native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAkBL,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,aAAa,CAgB9E;AAED,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AACjF,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,WAAW,GACjB,SAAS,CA4BX;AAgBD,wFAAwF;AACxF,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,WAAW,GACjB,SAAS,CAmBX;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,CAQxE;AAED,4CAA4C;AAC5C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,CAQ9E;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,CAQzE"}
+{"version":3,"file":"Switch.look.native.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.look.native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAmBL,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,aAAa,CAgB9E;AAED,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AACjF,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,WAAW,GACjB,SAAS,CA4BX;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAI7E;AA2BD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,WAAW,GACjB,SAAS,CAmBX;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,CAQxE;AAED,4CAA4C;AAC5C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,CAQ9E;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,CAQzE"}

package/dist/types-native/components/form/Switch/Switch.metrics.d.ts

@@ -159,6 +159,14 @@ export declare const LABEL_GAP_UNITS: {
     readonly beside: 2;
     readonly stacked: 1;
 };
+/**
+ * The minimum height of a touch target, in px (FUT-1905).
+ *
+ * No entry in {@link SWITCH_SIZES} reaches it — `xl`, the largest, is 34px tall
+ * and `md` is 26 — so a consumer cannot buy a legal target by passing a bigger
+ * `size`. The label is what clears it: see `SwitchLabel` in `Switch.parts.tsx`.
+ */
+export declare const TAP_TARGET_MIN = 40;
 /**
  * `neutral`'s three greys, and the literals the web falls back to for a theme
  * whose grey ramp omits a step. Same three steps `Button` draws its neutral
@@ -175,6 +183,17 @@ export declare const NEUTRAL_FALLBACK: {
     readonly light: "#9e9e9e";
 };
 export declare const NEUTRAL_CONTRAST = "#fff";
+/**
+ * The RESTING thumb — the knob while the switch is off (FUT-1924).
+ *
+ * It stays white, and the reason is worth stating because the checked thumb no
+ * longer is: the resting track is `theme.palette.action.disabled` washed over
+ * the page, which no tenant picks, and a white knob on it is the conventional
+ * look in both modes. The CHECKED track is `palette.main`, a colour the tenant
+ * does pick, and that is where a stated white was a defect. See `checkedInk`
+ * in `Switch.styles.ts` and its native twin.
+ */
+export declare const RESTING_THUMB = "#fff";
 /** Hover: the thumb lifts a shade and takes a halo of the hue. */
 export declare const SWITCH_HOVER: {
     readonly thumbScale: 1.05;

package/dist/types-native/components/form/Switch/Switch.metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Switch.metrics.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.metrics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Switch.metrics.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.metrics.ts"],"names":[],"mappings":"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"}

package/dist/types-native/components/form/Switch/Switch.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Switch.native.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.native.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAQL,IAAI,EACJ,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AA+PtB;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM;;;;;;;8BA4DjB,CAAC"}
+{"version":3,"file":"Switch.native.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.native.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAQL,IAAI,EACJ,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AA4QtB;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM;;;;;;;8BA4DjB,CAAC"}

package/dist/types-native/tokens/theme.d.ts

@@ -143,6 +143,44 @@ export declare const DEFAULT_BRAND: Record<UiThemeMode, {
  * palette's `text.primary`, which is what made it easy to read backwards.)
  */
 export declare function contrastText(background: string): string;
+/**
+ * The ink that reads on EVERY one of these fills (FUT-1924).
+ *
+ * {@link contrastText} answers for one fill, which is all MUI's `augmentColor`
+ * ever needs: a solid button is a single flat colour. Two components paint the
+ * label over something that is not one colour — `Button`'s `gradient` variant
+ * runs between two stops, and `Switch`'s thumb travels the whole length of a
+ * checked track — and both of them stated `#fff` outright instead, which is
+ * white-on-pale the moment a white-labelled host hands the library a pale
+ * brand. Audited across the library, those two were the only places a hardcoded
+ * white sat over a surface the TENANT chooses.
+ *
+ * **This deliberately does not follow `contrastText`'s rule.** MUI's is a
+ * threshold that PREFERS white — white wherever white clears 3:1 — which is a
+ * brand-feel decision, and it is kept for every existing caller so nothing
+ * already legible moves. Here the fills can disagree: over MUI's own success
+ * pair white is 2.78:1 on `#4caf50` and dark ink 2.66:1 on `#1b5e20`, so
+ * neither meets any threshold and asking whether one does is the wrong
+ * question. The answer is whichever ink has the better WORST case across the
+ * fills — which is also not what either fill says on its own, since
+ * `contrastText('#4caf50')` is dark ink.
+ *
+ * A gradient wide enough that neither ink clears 4.5:1 anywhere is a palette
+ * problem this cannot fix — it returns the less bad ink and does not pretend
+ * otherwise.
+ *
+ * `Math.min` is the claim, and it is worth knowing that no test can prove it
+ * against `Math.max` today: the two candidate inks sit at opposite ends of the
+ * luminance range, so ranking them by their best fill and by their worst gives
+ * the same winner for every possible pair (checked exhaustively). Worst case is
+ * still what this MEANS, and the moment a third ink or one that is not an
+ * extreme is offered, the two stop agreeing.
+ *
+ * `fallback` is returned when a fill cannot be decomposed: {@link getContrastRatio}
+ * throws on a format it does not know, and a throw inside an emotion style
+ * function takes the render down with it.
+ */
+export declare function inkOver(fills: readonly string[], fallback: string): string;
 /**
  * MUI's `augmentColor` for a custom colour: derive whatever shade the seed
  * left out. `light` is one tonal offset up, `dark` one and a half down.

package/dist/types-native/tokens/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/tokens/theme.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/tokens/theme.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAElF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,cAAc,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE/E,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC;IACnB,iFAAiF;IACjF,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,UAAU,EAAE,YAAY,CAAC;IACzB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9F;AAED,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,aAAa,CAAC;QACvB,SAAS,EAAE,aAAa,CAAC;QACzB,OAAO,EAAE,aAAa,CAAC;QACvB,OAAO,EAAE,aAAa,CAAC;QACvB,IAAI,EAAE,aAAa,CAAC;QACpB,MAAM,EAAE,aAAa,CAAC;QACtB,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;KAC9C,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,+DAA+D;AAC/D,eAAO,MAAM,EAAE,GAAI,OAAO,MAAM,KAAG,MAAsC,CAAC;AAQ1E,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAW3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAGrF,CAAC;AAqDF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW1E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAYhE;AAQD,yFAAyF;AACzF,eAAO,MAAM,OAAO,EAAE,cAKrB,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,CAMpD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAMrD,CAAC;AAgBF,eAAO,MAAM,eAAe,qDAA+C,CAAC;AAC5E,eAAO,MAAM,yBAAyB,+DAA2D,CAAC;AAElG;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAsCnE;AAED,wDAAwD;AACxD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3G,eAAO,MAAM,gBAAgB,EAAE,OAAyB,CAAC"}

package/dist/typography/Heading.js

@@ -1,12 +1,12 @@
 import "../chunk-6GP2DOOO.js";
 import {
   Heading
-} from "../chunk-MESRKY67.js";
-import "../chunk-PWR7K5OP.js";
-import "../chunk-3N6EK6K5.js";
+} from "../chunk-DW6GBMLQ.js";
+import "../chunk-LV4UTYAD.js";
+import "../chunk-ERX4XIYC.js";
 import "../chunk-TYJR4GOF.js";
 import "../chunk-PT6TCWIW.js";
-import "../chunk-NQN5Z36J.js";
+import "../chunk-QLI7ES7Z.js";
 import "../chunk-AG66JBNH.js";
 import "../chunk-6JAIFIPW.js";
 import "../chunk-FZXKH2ZT.js";

package/dist/typography/Paragraph.js

@@ -1,9 +1,9 @@
 import {
   Paragraph
-} from "../chunk-HFXTAEYY.js";
+} from "../chunk-GTLJYAEG.js";
 import "../chunk-QKLGH3RZ.js";
 import "../chunk-TYJR4GOF.js";
-import "../chunk-NQN5Z36J.js";
+import "../chunk-QLI7ES7Z.js";
 import "../chunk-AG66JBNH.js";
 import "../chunk-6JAIFIPW.js";
 import "../chunk-FZXKH2ZT.js";

package/dist/typography/Text.js

@@ -1,10 +1,10 @@
 import "../chunk-VUHLNYAE.js";
 import {
   Text
-} from "../chunk-343TTIHD.js";
-import "../chunk-V3PLFYKO.js";
+} from "../chunk-PENJBKPH.js";
+import "../chunk-ZAJO2B75.js";
 import "../chunk-TYJR4GOF.js";
-import "../chunk-NQN5Z36J.js";
+import "../chunk-QLI7ES7Z.js";
 import "../chunk-AG66JBNH.js";
 import "../chunk-6JAIFIPW.js";
 import "../chunk-FZXKH2ZT.js";

package/dist/user-avatar.js

@@ -1,10 +1,10 @@
 import {
   UserAvatar,
   UserMenu
-} from "./chunk-GGI7GM5O.js";
+} from "./chunk-QE2C35TO.js";
 import "./chunk-UDQSIRAP.js";
-import "./chunk-JUHUKZGU.js";
-import "./chunk-NA7MIEG6.js";
+import "./chunk-JD3D6Y4U.js";
+import "./chunk-SZETT7QV.js";
 import "./chunk-XRMZMBE3.js";
 import "./chunk-FAITHWIO.js";
 import "./chunk-3ZVUNSFF.js";
@@ -15,15 +15,15 @@ import "./chunk-BEBLRL5D.js";
 import "./chunk-6Q6T3FW5.js";
 import "./chunk-FKUYRQSP.js";
 import "./chunk-BA4RHQ3B.js";
-import "./chunk-SLVQ33AN.js";
-import "./chunk-BB2OUERT.js";
+import "./chunk-77DF5LKI.js";
+import "./chunk-2LSCK45B.js";
 import "./chunk-5LQ7PKMW.js";
 import "./chunk-TAMIZE4Q.js";
 import "./chunk-73BEVJCS.js";
-import "./chunk-343TTIHD.js";
-import "./chunk-V3PLFYKO.js";
+import "./chunk-PENJBKPH.js";
+import "./chunk-ZAJO2B75.js";
 import "./chunk-TYJR4GOF.js";
-import "./chunk-NQN5Z36J.js";
+import "./chunk-QLI7ES7Z.js";
 import "./chunk-AG66JBNH.js";
 import "./chunk-6JAIFIPW.js";
 import "./chunk-FZXKH2ZT.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/ui",
-  "version": "6.25.0",
+  "version": "6.27.0",
   "license": "MIT",
   "packageManager": "pnpm@10.34.5",
   "type": "module",

package/src/components/data-display/Alert/Alert.base.ts

@@ -76,12 +76,39 @@ export interface AlertBaseFields {
   animate?: boolean;
 
   /**
-   * ARIA role for the alert
+   * Whether this alert INTERRUPTS a screen reader, or waits its turn.
+   *
+   * Sets `role` and `aria-live` together, which is the whole point of it:
+   * those two disagree by default and the disagreement is invisible. An alert
+   * gets `role="alert"` from {@link ALERT_DEFAULTS} whatever its variant, and
+   * `role="alert"` is IMPLICITLY an assertive live region — so a `polite`
+   * `aria-live` beside it is contradicted rather than honoured, and several
+   * screen readers interrupt anyway. A caller who wants a quiet announcement
+   * has to know that the trick is `role="status"`, which is implicitly polite.
+   *
+   * `announce` is that knowledge, spelled once:
+   *
+   * | value | `role` | `aria-live` |
+   * |---|---|---|
+   * | `'assertive'` | `alert` | `assertive` |
+   * | `'polite'` | `status` | `polite` |
+   *
+   * Unset, nothing changes: the role stays `alert` and the live setting is
+   * still derived from the variant ({@link defaultAriaLive}). An explicit
+   * `role` or `aria-live` still wins over both, so an existing call site that
+   * spells either by hand keeps exactly what it spelled.
+   */
+  announce?: 'polite' | 'assertive';
+
+  /**
+   * ARIA role for the alert. Prefer {@link AlertBaseFields.announce}, which
+   * keeps this and `aria-live` consistent; this overrides it.
    */
   role?: string;
 
   /**
-   * ARIA live region setting
+   * ARIA live region setting. Prefer {@link AlertBaseFields.announce}, which
+   * keeps this and `role` consistent; this overrides it.
    */
   'aria-live'?: 'polite' | 'assertive' | 'off';
 

package/src/components/data-display/Alert/Alert.helpers.ts

@@ -38,6 +38,56 @@ export const resolveAlertProps = <P extends AlertBaseFields>(props: P): Resolved
 export const defaultAriaLive = (variant: AlertVariant): 'polite' | 'assertive' =>
   variant === 'danger' ? 'assertive' : 'polite';
 
+/**
+ * The ARIA role each `announce` level is spelled with.
+ *
+ * Both roles carry an IMPLICIT live setting, and that implicit one is what
+ * assistive tech acts on — `alert` is assertive, `status` is polite. Pairing
+ * them here is what stops `role` and `aria-live` from contradicting each
+ * other, which they do by default: every alert is `role="alert"` regardless of
+ * variant, so an `info` alert asks to be polite in one attribute and to
+ * interrupt in the other.
+ */
+export const ANNOUNCE_ROLE: Record<NonNullable<AlertBaseFields['announce']>, string> = {
+  assertive: 'alert',
+  polite: 'status',
+};
+
+/**
+ * The two attributes that decide whether an alert interrupts, resolved TOGETHER.
+ *
+ * Both renderers therefore let `role` and `announce` leave their destructure
+ * unused (`_role`, `_announce`) and call this instead — the first because the
+ * defaults have already answered it, the second because it must never reach
+ * the DOM.
+ *
+ * Reads the caller's own props rather than the defaulted ones, because the
+ * whole question is which of them the caller actually spelled:
+ * {@link ALERT_DEFAULTS} supplies `role: 'alert'` for everything, so after the
+ * merge there is no longer any difference between an alert that asked to
+ * interrupt and one that never mentioned it.
+ *
+ * Precedence, most specific first — an explicit `role` or `aria-live` beats
+ * `announce`, so a call site that already spells either by hand is untouched:
+ *
+ *  1. `role` / `aria-live` as given;
+ *  2. {@link AlertBaseFields.announce}, which supplies both;
+ *  3. today's behaviour — `ALERT_DEFAULTS.role` and {@link defaultAriaLive}.
+ *
+ * With none of the three named, the result is byte-for-byte what it was before
+ * `announce` existed.
+ */
+export const resolveAnnouncement = (
+  props: Pick<AlertBaseFields, 'announce' | 'role' | 'aria-live'>,
+  variant: AlertVariant,
+): { role: string; 'aria-live': 'polite' | 'assertive' | 'off' } => {
+  const announce = props.announce;
+  return {
+    role: props.role ?? (announce === undefined ? ALERT_DEFAULTS.role : ANNOUNCE_ROLE[announce]),
+    'aria-live': props['aria-live'] ?? announce ?? defaultAriaLive(variant),
+  };
+};
+
 export const testIdFor = (base: string | undefined, suffix: string): string =>
   base ? `${base}-${suffix}` : `alert-${suffix}`;
 

package/src/components/data-display/Alert/Alert.md

@@ -33,6 +33,7 @@ A beautiful and versatile Alert component with multiple variants, animations, an
 | `glow` | `boolean` | `false` | Add a glowing shadow effect |
 | `pulse` | `boolean` | `false` | Add a pulsing animation effect |
 | `animate` | `boolean` | `true` | Whether to animate the alert on mount |
+| `announce` | `'polite' \| 'assertive'` | - | Sets `role` and `aria-live` together — see [Accessibility](#accessibility) |
 | `className` | `string` | - | Additional CSS classes |
 
 ## Usage Examples
@@ -136,12 +137,39 @@ import Star from '@mui/icons-material/Star';
 The Alert component implements comprehensive accessibility features:
 
 - Uses `role="alert"` for immediate screen reader announcement
-- Implements `aria-live` regions (polite for info/success, assertive for warning/danger)
+- Derives `aria-live` from the variant: **assertive for `danger`, polite for
+  every other variant** (`defaultAriaLive`)
 - Proper focus management for closable alerts
 - Keyboard navigation support (Enter/Space to close)
 - High contrast colors meeting WCAG guidelines
 - Screen reader compatible content structure
 
+### `announce` — whether the alert interrupts
+
+`role` and `aria-live` are two attributes with one meaning between them, and by
+default they disagree. Every alert gets `role="alert"`, whatever its variant,
+and `role="alert"` is **implicitly an assertive live region** — so an `info`
+alert ships `aria-live="polite"` and an implicitly-assertive role together, and
+a reader that honours the role interrupts anyway. The escape is that
+`role="status"` is implicitly polite, which is knowledge a call site should not
+have to carry.
+
+`announce` carries it:
+
+| `announce` | `role` | `aria-live` |
+|---|---|---|
+| `'assertive'` | `alert` | `assertive` |
+| `'polite'` | `status` | `polite` |
+| unset | `alert` | from the variant, as above |
+
+```tsx
+// A sentence worth hearing, that is not worth interrupting for.
+<Alert variant="info" announce="polite" description="Mais 1 pessoa está nesta mesa agora." showIcon={false} />
+```
+
+An explicit `role` or `aria-live` still wins over `announce`, so a call site
+that already spells either by hand keeps exactly what it spelled.
+
 ## Best Practices
 
 1. Use appropriate variants for message severity

package/src/components/data-display/Alert/Alert.native.tsx

@@ -12,7 +12,7 @@ import {
   type ViewStyle,
 } from 'react-native';
 
-import { defaultAriaLive, resolveAlertProps, testIdFor, VARIANT_ICON } from './Alert.helpers';
+import { resolveAlertProps, resolveAnnouncement, testIdFor, VARIANT_ICON } from './Alert.helpers';
 import {
   actionSlotStyle,
   alertLook,
@@ -198,7 +198,10 @@ function useDismiss(onClose: (() => void) | undefined): { open: boolean; gone: b
 
 export const Alert = React.forwardRef<View, AlertProps>((alertProps, ref) => {
   const {
-    variant, color, glow, pulse, icon, showIcon, onClose, title, description, children, animate, role,
+    variant, color, glow, pulse, icon, showIcon, onClose, title, description, children, animate,
+    // `role`, `announce` and `aria-live` all leave here and are resolved
+    // TOGETHER below, off `alertProps` — see `resolveAnnouncement`.
+    role: _role, announce: _announce,
     'aria-atomic': ariaAtomic, 'aria-live': _ariaLive, closable, closeLabel, style, ...others
   } = resolveAlertProps(alertProps);
   const theme = useUiTheme();
@@ -207,14 +210,15 @@ export const Alert = React.forwardRef<View, AlertProps>((alertProps, ref) => {
   const look = alertLook(theme, { variant, color, glow, pulse });
   const fadeIn = useFadeIn(animate);
   const dismiss = useDismiss(onClose);
+  const announcement = resolveAnnouncement(alertProps, variant);
 
   if (dismiss.gone) return null;
   return (
     <Collapse open={dismiss.open} onCollapsed={dismiss.onCollapsed}>
       <Animated.View
         ref={ref}
-        role={role as Role}
-        aria-live={alertProps['aria-live'] ?? defaultAriaLive(variant)}
+        role={announcement.role as Role}
+        aria-live={announcement['aria-live']}
         {...webAria({ 'aria-atomic': ariaAtomic })}
         tabIndex={0}
         testID={testId}

package/src/components/data-display/Alert/Alert.tsx

@@ -8,7 +8,7 @@ import { alpha, styled } from '@mui/material/styles/index.js';
 import type { Theme } from '@mui/material/styles/index.js';
 import React from 'react';
 
-import { defaultAriaLive, resolveAlertProps, testIdFor } from './Alert.helpers';
+import { resolveAlertProps, resolveAnnouncement, testIdFor } from './Alert.helpers';
 import type { AlertPalette } from './Alert.metrics';
 import {
   ACTIVE,
@@ -301,7 +301,7 @@ export const Alert = React.forwardRef<HTMLDivElement, AlertProps>((alertProps, r
     description,
     children,
     animate,
-    role,
+    role: _role, announce: _announce, // resolved from `alertProps` — see `resolveAnnouncement`
     'aria-atomic': ariaAtomic,
     ...others
   } = resolveAlertProps(alertProps);
@@ -316,7 +316,7 @@ export const Alert = React.forwardRef<HTMLDivElement, AlertProps>((alertProps, r
   const props = withoutAlertOnlyProps(withoutTestIdProps(others));
 
   // Depends on `variant`, so it cannot live in the static defaults above.
-  const ariaLive = alertProps['aria-live'] ?? defaultAriaLive(variant);
+  const announcement = resolveAnnouncement(alertProps, variant);
   const [open, setOpen] = React.useState(true);
   const [isClosing, setIsClosing] = React.useState(false);
 
@@ -356,8 +356,8 @@ export const Alert = React.forwardRef<HTMLDivElement, AlertProps>((alertProps, r
         pulse={pulse}
         animate={animate}
         icon={displayIcon}
-        role={role}
-        aria-live={ariaLive}
+        role={announcement.role}
+        aria-live={announcement['aria-live']}
         aria-atomic={ariaAtomic}
         tabIndex={0}
         action={dismissButton(alertProps, dataTestId, handleClose)}

package/src/components/form/Button/Button.md

@@ -151,6 +151,14 @@ Gradient background with smooth color transitions.
 <Button variant="gradient">Gradient Button</Button>
 ```
 
+Its label takes the ink the palette implies, judged across BOTH ends of the
+gradient rather than against `main` — `primary` runs `primary.main →
+secondary.main`, and an ink that reads on the first says nothing about the
+second. So a pale brand gets dark ink here exactly as it does on `solid`, and
+a palette whose two ends disagree gets whichever ink survives the worse of
+them. It used to be a stated `#fff`, which made this the one button in the
+library a pale-branded store could not read.
+
 ## Accessibility
 
 The Button component follows WCAG 2.1 AA guidelines:

package/src/components/form/Button/Button.styles.ts

@@ -2,7 +2,7 @@ import { alpha, darken, keyframes, lighten } from '@mui/material/styles/index.js
 import type { CSSObject, Theme } from '@mui/material/styles/index.js';
 
 import { BUTTON_SIZES, ICON_ONLY_PADDING as ICON_ONLY_PADDING_PX } from './Button.metrics';
-import { px } from '../../../tokens/theme';
+import { inkOver, px } from '../../../tokens/theme';
 
 // Define pulse animation globally
 const pulseAnimation = keyframes`
@@ -141,11 +141,32 @@ const GRADIENT_PAIRS: Record<string, (theme: Theme) => [string, string]> = {
   danger: (theme) => [theme.palette.error.light, theme.palette.error.dark],
 };
 
+const gradientStops = (theme: Theme, color: string, palette: ColorPalette): [string, string] =>
+  GRADIENT_PAIRS[color]?.(theme) ?? [palette.main, palette.dark];
+
 const gradientFor = (theme: Theme, color: string, palette: ColorPalette): string => {
-  const [from, to] = GRADIENT_PAIRS[color]?.(theme) ?? [palette.main, palette.dark];
+  const [from, to] = gradientStops(theme, color, palette);
   return `linear-gradient(135deg, ${from} 0%, ${to} 100%)`;
 };
 
+/**
+ * The label colour for `gradient`, which used to be `#fff` outright (FUT-1924).
+ *
+ * Every other filled variant reads `palette.contrastText`, derived from `main`
+ * — so a white-labelled host handing the library a pale brand got dark ink on
+ * its solid buttons and white ink on its gradient one. That store had exactly
+ * one button in the library whose label it could not read, in LIGHT mode,
+ * before dark mode existed anywhere.
+ *
+ * `contrastText` is still not the right thing to read, and that is why this
+ * goes through {@link inkOver}: a gradient is TWO fills, the named pairs run
+ * light-to-dark, and an ink chosen against `main` says nothing about the end
+ * the gradient actually reaches. Both stops go in, and the ink has to survive
+ * the worse of them.
+ */
+const gradientInk = (theme: Theme, color: string, palette: ColorPalette): string =>
+  inkOver(gradientStops(theme, color, palette), palette.contrastText || '#fff');
+
 /**
  * The label colour for the two variants that paint no background of their own.
  *
@@ -218,7 +239,7 @@ const VARIANT_STYLES: Record<
   }),
   gradient: (theme, palette, color) => ({
     background: gradientFor(theme, color, palette),
-    color: '#fff',
+    color: gradientInk(theme, color, palette),
     '&:hover': {
       filter: 'brightness(1.1)',
       transform: 'translateY(-2px)',