@12-apps/ui 6.25.0 → 6.27.0

package/dist/native/provider.js

@@ -1,10 +1,10 @@
 import {
   UiThemeContext,
   useUiTheme
-} from "./chunks/chunk-GWGIWQO7.js";
+} from "./chunks/chunk-XI7HTAVN.js";
 import {
   createUiTheme
-} from "./chunks/chunk-LEMMXZFN.js";
+} from "./chunks/chunk-MP3UDWTT.js";
 
 // src/provider/UiProvider.native.tsx
 import * as React from "react";

package/dist/native/tokens.js

@@ -27,10 +27,11 @@ import {
   getLuminance,
   hexToRgb,
   hslToRgb,
+  inkOver,
   lighten,
   px,
   recomposeColor
-} from "./chunks/chunk-LEMMXZFN.js";
+} from "./chunks/chunk-MP3UDWTT.js";
 export {
   COLOR_VALUES,
   DEFAULT_BRAND,
@@ -55,6 +56,7 @@ export {
   getLuminance,
   hexToRgb,
   hslToRgb,
+  inkOver,
   lighten,
   muiColor,
   muiSize,

package/dist/native/typography/Heading.js

@@ -4,11 +4,11 @@ import {
 } from "../chunks/chunk-AR5O4BEY.js";
 import {
   useUiTheme
-} from "../chunks/chunk-GWGIWQO7.js";
+} from "../chunks/chunk-XI7HTAVN.js";
 import {
   FONT_WEIGHTS,
   HEADING_SCALE
-} from "../chunks/chunk-LEMMXZFN.js";
+} from "../chunks/chunk-MP3UDWTT.js";
 
 // src/components/typography/Heading/Heading.native.tsx
 import * as React from "react";

package/dist/native/typography/Paragraph.js

@@ -4,8 +4,8 @@ import {
 } from "../chunks/chunk-AR5O4BEY.js";
 import {
   useUiTheme
-} from "../chunks/chunk-GWGIWQO7.js";
-import "../chunks/chunk-LEMMXZFN.js";
+} from "../chunks/chunk-XI7HTAVN.js";
+import "../chunks/chunk-MP3UDWTT.js";
 
 // src/components/typography/Paragraph/Paragraph.native.tsx
 import * as React from "react";

package/dist/native/typography/Text.js

@@ -4,12 +4,12 @@ import {
 } from "../chunks/chunk-AR5O4BEY.js";
 import {
   useUiTheme
-} from "../chunks/chunk-GWGIWQO7.js";
+} from "../chunks/chunk-XI7HTAVN.js";
 import {
   FONT_WEIGHTS,
   TYPE_SIZES,
   alpha
-} from "../chunks/chunk-LEMMXZFN.js";
+} from "../chunks/chunk-MP3UDWTT.js";
 
 // src/components/typography/Text/Text.native.tsx
 import * as React from "react";

package/dist/navigation/AppHeader.js

@@ -12,25 +12,25 @@ import {
 } from "../chunk-H37GIAAM.js";
 import {
   AppHeaderDetails
-} from "../chunk-JO6BBSGY.js";
+} from "../chunk-DWJBOR47.js";
 import {
   brandGradient,
   highlightOf,
   initialsOf
 } from "../chunk-IQU4HKND.js";
-import "../chunk-4J5EN4FQ.js";
+import "../chunk-GBX5ACPF.js";
+import "../chunk-OLZTGVBT.js";
+import "../chunk-CRN4KKNI.js";
 import "../chunk-JBMBFYFA.js";
 import "../chunk-7MR2JCJW.js";
 import "../chunk-U437KFDI.js";
-import "../chunk-OLZTGVBT.js";
-import "../chunk-CRN4KKNI.js";
 import "../chunk-F52N6ACD.js";
 import "../chunk-YANLN6HP.js";
 import "../chunk-5KEMPCW4.js";
 import "../chunk-VM3HRSAU.js";
 import "../chunk-GYXUCS37.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";
@@ -40,7 +40,7 @@ import "../chunk-HPK33ACY.js";
 import "../chunk-V5IOLAIS.js";
 import "../chunk-7ZPUN7TV.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/provider.js

@@ -1,18 +1,18 @@
 import {
   UiProvider
-} from "./chunk-7JXLGOM2.js";
+} from "./chunk-Y55ILY2F.js";
 import "./chunk-XZTRZ3HO.js";
 import {
   useUiTheme
-} from "./chunk-KLREH4X6.js";
+} from "./chunk-G2JPUHEJ.js";
 import {
   muiThemeOptionsFrom,
   uiThemeFromMui
-} from "./chunk-YMRI5QKG.js";
+} from "./chunk-IV5QQLCS.js";
 import "./chunk-V5IOLAIS.js";
 import "./chunk-7ZPUN7TV.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/social-login-button.js

@@ -4,12 +4,12 @@ import {
   GoogleIcon,
   SocialLoginButton,
   SocialLoginContainer
-} from "./chunk-OG2FP6SE.js";
+} from "./chunk-M4NFXC5R.js";
 import "./chunk-INGPH3YQ.js";
 import "./chunk-6GP2DOOO.js";
-import "./chunk-MESRKY67.js";
-import "./chunk-PWR7K5OP.js";
-import "./chunk-3N6EK6K5.js";
+import "./chunk-DW6GBMLQ.js";
+import "./chunk-LV4UTYAD.js";
+import "./chunk-ERX4XIYC.js";
 import "./chunk-CMMPGAMJ.js";
 import "./chunk-MCZ7536N.js";
 import "./chunk-IFPTVHYR.js";
@@ -20,16 +20,16 @@ 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-PT6TCWIW.js";
-import "./chunk-NQN5Z36J.js";
+import "./chunk-QLI7ES7Z.js";
 import "./chunk-AG66JBNH.js";
 import "./chunk-6JAIFIPW.js";
 import "./chunk-FZXKH2ZT.js";

package/dist/tokens.js

@@ -23,8 +23,9 @@ import {
   augmentColor,
   contrastText,
   createUiTheme,
+  inkOver,
   px
-} from "./chunk-NQN5Z36J.js";
+} from "./chunk-QLI7ES7Z.js";
 import "./chunk-AG66JBNH.js";
 import {
   alpha,
@@ -69,6 +70,7 @@ export {
   headingMetrics,
   hexToRgb,
   hslToRgb,
+  inkOver,
   lighten,
   muiColor,
   muiSize,

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

@@ -69,11 +69,37 @@ 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/dist/types/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/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/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/components/form/Button/Button.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Button/Button.styles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAqBtE,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAgBD,eAAO,MAAM,iBAAiB,GAAI,OAAO,KAAK,EAAE,OAAO,MAAM,KAAG,YAsB/D,CAAC;AAsCF,gFAAgF;AAChF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,UAAU,OAAO,KAAG,SACK,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,KAAK,KAAG,SAoBjD,CAAC;AAkGH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,KAAK,EACZ,SAAS,MAAM,GAAG,SAAS,EAC3B,SAAS,YAAY,EACrB,OAAO,MAAM,KACZ,SAAyE,CAAC;AAkC7E;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,YAAY,EACrB,OAAO,OAAO,EACd,QAAQ,OAAO,KACd,SAGD,CAAC"}
+{"version":3,"file":"Button.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Button/Button.styles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAqBtE,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAgBD,eAAO,MAAM,iBAAiB,GAAI,OAAO,KAAK,EAAE,OAAO,MAAM,KAAG,YAsB/D,CAAC;AAsCF,gFAAgF;AAChF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,UAAU,OAAO,KAAG,SACK,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,KAAK,KAAG,SAoBjD,CAAC;AAuHH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,KAAK,EACZ,SAAS,MAAM,GAAG,SAAS,EAC3B,SAAS,YAAY,EACrB,OAAO,MAAM,KACZ,SAAyE,CAAC;AAkC7E;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,YAAY,EACrB,OAAO,OAAO,EACd,QAAQ,OAAO,KACd,SAGD,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"Switch.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAW1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAmBlD,eAAO,MAAM,MAAM,oGAmEjB,CAAC"}
+{"version":3,"file":"Switch.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.tsx"],"names":[],"mappings":"AACA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAOjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAmBlD,eAAO,MAAM,MAAM,oGAyEjB,CAAC"}

package/dist/types/components/form/Switch/Switch.ids.d.ts

@@ -0,0 +1,42 @@
+import type { InputHTMLAttributes, ReactNode } from 'react';
+/** The ids the DOM `Switch` wires its label and its two descriptions with. */
+export interface SwitchIds {
+    /** The input's id. Always set — the label has to have something to point at. */
+    inputId: string;
+    descriptionId?: string;
+    helperId?: string;
+    /** Everything that DESCRIBES the control, the caller's own included. */
+    describedBy?: string;
+}
+export interface SwitchIdSource {
+    /** `useId()`'s value, passed in so this stays a pure function. */
+    generated: string;
+    id?: string;
+    inputProps?: InputHTMLAttributes<HTMLInputElement>;
+    description?: ReactNode;
+    helperText?: ReactNode;
+    callerDescribedBy?: unknown;
+}
+/**
+ * Derive every id one `Switch` needs, in one place (FUT-1905).
+ *
+ * The precedence is the point: an id the caller spelled — as `inputProps.id` or
+ * as `id` — wins, because a consumer that chose one is usually pointing its own
+ * `<label>` or a test at it. Only when there is none does the generated one
+ * apply, and it comes from `useId` rather than from the test id: two call sites
+ * sharing a `dataTestId` would otherwise share a `for`, and the second label
+ * would toggle the first control.
+ *
+ * `describedBy` APPENDS rather than replaces. The description and the helper
+ * line are the component's own, but a consumer that passed `aria-describedby`
+ * meant it, and dropping it to make room would trade one silent omission for
+ * another.
+ *
+ * It has TWO spellings and both count — top-level and inside `inputProps` —
+ * because that is a consumer's choice of spelling, not a choice of meaning.
+ * Reading only the first is how this shipped for one round: a caller writing
+ * `inputProps={{ 'aria-describedby': … }}` had it silently dropped, which is the
+ * omission the paragraph above says it must not trade for.
+ */
+export declare function switchIds({ generated, id, inputProps, description, helperText, callerDescribedBy, }: SwitchIdSource): SwitchIds;
+//# sourceMappingURL=Switch.ids.d.ts.map

package/dist/types/components/form/Switch/Switch.ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Switch.ids.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5D,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACnD,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,EAAE,EACF,UAAU,EACV,WAAW,EACX,UAAU,EACV,iBAAiB,GAClB,EAAE,cAAc,GAAG,SAAS,CAY5B"}

package/dist/types/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/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/components/form/Switch/Switch.parts.d.ts

@@ -1,15 +1,6 @@
 import React from 'react';
 import type { SwitchFlags } from './Switch.styles';
 import type { SwitchProps } from './Switch.types';
-/**
- * A plain wrapper over the styled row. Exporting the styled component itself
- * needs a @mui/system reference tsc calls unportable (TS2742).
- */
-export declare const LabelContainer: React.FC<{
-    labelPosition?: string;
-    error?: boolean;
-    children: React.ReactNode;
-}>;
 export interface SwitchIconProps {
     icon: React.ReactNode;
     /** True when this icon is the one the current state should show. */
@@ -17,6 +8,8 @@ export interface SwitchIconProps {
     animated: boolean;
     size: string;
     side: 'on' | 'off';
+    /** The ink for the ON icon, which sits on the brand-filled track (FUT-1924). */
+    onInk: string;
 }
 /**
  * One of the two icons overlaid on the track. The on icon slides to the left
@@ -33,19 +26,46 @@ export interface SwitchControlProps extends SwitchFlags {
     size: string;
     dataTestId?: string;
     switchRef?: React.Ref<HTMLButtonElement>;
+    /** The id the label points at — always set, so the input always has one. */
+    inputId: string;
+    /** The caller's own `inputProps`, merged rather than spread over (FUT-1905). */
+    inputProps?: React.InputHTMLAttributes<HTMLInputElement>;
+    /** The description's id, appended to whatever the caller described it by. */
+    describedBy?: string;
     rest: Record<string, unknown>;
 }
 /** The control itself: the track, and the two icons that may sit over it. */
 export declare const SwitchControl: React.FC<SwitchControlProps>;
+/**
+ * The helper line, which is where a validation message lands — so it is
+ * `aria-describedby`'d like the description (FUT-1905).
+ *
+ * It carried no `id` and nothing pointed at it, which means an `error` state
+ * announced as "checkbox, checked" and nothing else: the one sentence saying
+ * WHY was on screen and outside the accessibility tree.
+ */
 export declare const SwitchHelper: React.FC<{
     helperText?: React.ReactNode;
     error?: boolean;
     dataTestId?: string;
+    id?: string;
 }>;
-export declare const SwitchLabel: React.FC<{
-    label: React.ReactNode;
+/**
+ * The control and its label in one row, or the control alone.
+ *
+ * Lives here rather than inline in `Switch.tsx` because the two branches only
+ * differ in what surrounds the control — and the component that assembles them
+ * was long enough that the wiring got hard to see between them.
+ */
+export declare const SwitchRow: React.FC<{
+    label?: React.ReactNode;
     description?: React.ReactNode;
+    labelPosition?: string;
     error?: boolean;
     dataTestId?: string;
+    htmlFor: string;
+    descriptionId?: string;
+    disabled?: boolean;
+    control: React.ReactNode;
 }>;
 //# sourceMappingURL=Switch.parts.d.ts.map

package/dist/types/components/form/Switch/Switch.parts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Switch.parts.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.parts.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA0ClD;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAIA,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,GAAG,KAAK,CAAC;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAsBhD,CAAC;AAEF,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,6EAA6E;AAC7E,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAwDtD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;IAClC,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CASS,CAAC;AAEX,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;IACjC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAoBA,CAAC"}
+{"version":3,"file":"Switch.parts.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.parts.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAwDlD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,GAAG,KAAK,CAAC;IACnB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA6BhD,CAAC;AAEF,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACzC,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,UAAU,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACzD,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,6EAA6E;AAC7E,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA4EtD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;IAClC,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAUS,CAAC;AAoEX;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B,CA8BA,CAAC"}

package/dist/types/components/form/Switch/Switch.styles.d.ts

@@ -16,5 +16,11 @@ export interface SwitchFlags {
     ripple?: boolean;
     pulse?: boolean;
 }
+/**
+ * The same checked-track ink, for the two ICONS the control overlays on the
+ * track — which are drawn as components rather than styles, so they cannot
+ * reach {@link checkedInk} directly.
+ */
+export declare const onTrackInk: (theme: Theme, flags: SwitchFlags) => string;
 export declare const switchSx: (theme: Theme, flags: SwitchFlags) => CSSObject;
 //# sourceMappingURL=Switch.styles.d.ts.map

package/dist/types/components/form/Switch/Switch.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Switch.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.styles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAwCtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAiDxE,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAoMD,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,EAAE,OAAO,WAAW,KAAG,SAc3D,CAAC"}
+{"version":3,"file":"Switch.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.styles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAyCtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAiDxE,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAgPD;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,EAAE,OAAO,WAAW,KAAG,MACe,CAAC;AAE9E,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,EAAE,OAAO,WAAW,KAAG,SAc3D,CAAC"}

package/dist/types/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/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":"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"}

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

@@ -69,11 +69,37 @@ 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';
     /**