@12-apps/ui 6.27.1 → 6.28.0

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

@@ -1,3 +1,5 @@
+import { contrastText, inkOver } from './ink-over';
+export { contrastText, inkOver };
 import { type HeadingLevel } from './heading-scale';
 import type { SizeValue } from './vocabulary';
 /**
@@ -137,50 +139,6 @@ export declare const DEFAULT_BRAND: Record<UiThemeMode, {
     primary: string;
     secondary: string;
 }>;
-/**
- * MUI's `getContrastText`: white where white reads at 3:1 on the colour, the
- * light mode's dark ink otherwise. (MUI's source spells the white as the DARK
- * 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":"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"}

package/dist/typography/Heading.js

@@ -1,13 +1,14 @@
 import "../chunk-6GP2DOOO.js";
 import {
   Heading
-} from "../chunk-DW6GBMLQ.js";
-import "../chunk-LV4UTYAD.js";
-import "../chunk-ERX4XIYC.js";
+} from "../chunk-SLMA4UQS.js";
+import "../chunk-XYDW5RQB.js";
+import "../chunk-EUKYQXYU.js";
 import "../chunk-TYJR4GOF.js";
 import "../chunk-PT6TCWIW.js";
-import "../chunk-QLI7ES7Z.js";
+import "../chunk-SONWG2RT.js";
 import "../chunk-AG66JBNH.js";
+import "../chunk-2BYKTBDL.js";
 import "../chunk-6JAIFIPW.js";
 import "../chunk-FZXKH2ZT.js";
 import "../chunk-PZ5AY32C.js";

package/dist/typography/Paragraph.js

@@ -1,10 +1,11 @@
 import {
   Paragraph
-} from "../chunk-GTLJYAEG.js";
+} from "../chunk-NWQWUYOV.js";
 import "../chunk-QKLGH3RZ.js";
 import "../chunk-TYJR4GOF.js";
-import "../chunk-QLI7ES7Z.js";
+import "../chunk-SONWG2RT.js";
 import "../chunk-AG66JBNH.js";
+import "../chunk-2BYKTBDL.js";
 import "../chunk-6JAIFIPW.js";
 import "../chunk-FZXKH2ZT.js";
 import "../chunk-PZ5AY32C.js";

package/dist/typography/Text.js

@@ -1,11 +1,12 @@
 import "../chunk-VUHLNYAE.js";
 import {
   Text
-} from "../chunk-PENJBKPH.js";
-import "../chunk-ZAJO2B75.js";
+} from "../chunk-YTYROOLY.js";
+import "../chunk-EPRA5QLB.js";
 import "../chunk-TYJR4GOF.js";
-import "../chunk-QLI7ES7Z.js";
+import "../chunk-SONWG2RT.js";
 import "../chunk-AG66JBNH.js";
+import "../chunk-2BYKTBDL.js";
 import "../chunk-6JAIFIPW.js";
 import "../chunk-FZXKH2ZT.js";
 import "../chunk-PZ5AY32C.js";

package/dist/user-avatar.js

@@ -1,30 +1,31 @@
 import {
   UserAvatar,
   UserMenu
-} from "./chunk-QE2C35TO.js";
+} from "./chunk-ALAJBLBE.js";
 import "./chunk-UDQSIRAP.js";
-import "./chunk-JD3D6Y4U.js";
-import "./chunk-SZETT7QV.js";
-import "./chunk-XRMZMBE3.js";
-import "./chunk-FAITHWIO.js";
+import "./chunk-THOPGHTY.js";
 import "./chunk-3ZVUNSFF.js";
+import "./chunk-HS2OJI6L.js";
+import "./chunk-FAITHWIO.js";
+import "./chunk-XRMZMBE3.js";
 import "./chunk-VUHLNYAE.js";
 import "./chunk-2GSIEDGN.js";
-import "./chunk-AIRWM7KK.js";
+import "./chunk-AVI3XHRQ.js";
+import "./chunk-FKUYRQSP.js";
 import "./chunk-BEBLRL5D.js";
 import "./chunk-6Q6T3FW5.js";
-import "./chunk-FKUYRQSP.js";
 import "./chunk-BA4RHQ3B.js";
-import "./chunk-77DF5LKI.js";
-import "./chunk-2LSCK45B.js";
+import "./chunk-GJUIZ5FN.js";
+import "./chunk-TSEWUY4V.js";
 import "./chunk-5LQ7PKMW.js";
 import "./chunk-TAMIZE4Q.js";
 import "./chunk-73BEVJCS.js";
-import "./chunk-PENJBKPH.js";
-import "./chunk-ZAJO2B75.js";
+import "./chunk-YTYROOLY.js";
+import "./chunk-EPRA5QLB.js";
 import "./chunk-TYJR4GOF.js";
-import "./chunk-QLI7ES7Z.js";
+import "./chunk-SONWG2RT.js";
 import "./chunk-AG66JBNH.js";
+import "./chunk-2BYKTBDL.js";
 import "./chunk-6JAIFIPW.js";
 import "./chunk-FZXKH2ZT.js";
 import "./chunk-PZ5AY32C.js";

package/package.json

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

package/src/components/data-display/DataGrid/DataGrid.cells.tsx

@@ -166,6 +166,7 @@ export interface GridRowProps<T extends Record<string, unknown>> {
 
 /** The leading checkbox / chevron cells, which exist only for enabled features. */
 function RowControls<T extends Record<string, unknown>>({
+  row,
   index,
   rowId,
   isSelected,
@@ -187,13 +188,26 @@ function RowControls<T extends Record<string, unknown>>({
       )}
       {expansion && (
         <TableCell padding="checkbox">
-          <IconButton
-            size="small"
-            onClick={() => model.onToggleExpansion(rowId)}
-            aria-label={isExpanded ? 'Collapse row' : 'Expand row'}
-          >
-            {isExpanded ? <ExpandLess /> : <ExpandMore />}
-          </IconButton>
+          {expansion.isRowExpandable?.(row) === false ? null : (
+            <IconButton
+              size="small"
+              // Stopped so a host that opens the record on a row click does not
+              // ALSO open it here: the chevron is its own control.
+              onClick={(event) => {
+                event.stopPropagation();
+                model.onToggleExpansion(rowId);
+              }}
+              aria-expanded={isExpanded}
+              aria-label={
+                isExpanded
+                  ? (expansion.collapseLabel ?? 'Collapse row')
+                  : (expansion.expandLabel ?? 'Expand row')
+              }
+              data-slot="expand-toggle"
+            >
+              {isExpanded ? <ExpandLess /> : <ExpandMore />}
+            </IconButton>
+          )}
         </TableCell>
       )}
     </>
@@ -234,8 +248,8 @@ export function GridRow<T extends Record<string, unknown>>(
           />
         ))}
       </TableRow>
-      {expansion && isExpanded && (
-        <TableRow>
+      {expansion && isExpanded && expansion.isRowExpandable?.(row) !== false && (
+        <TableRow data-slot="row-detail">
           <TableCell colSpan={totalColumns}>{expansion.render(row, index)}</TableCell>
         </TableRow>
       )}

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

@@ -105,6 +105,11 @@ export interface GridRowExpansion<T = any> {
   defaultExpandedRowIds?: Array<string | number>;
   /** Row id equality uses `getRowId` */
   onChangeExpanded?: (ids: Array<string | number>) => void;
+  /** Which rows have a detail; omitted, every row does. Refused rows keep an empty cell. */
+  isRowExpandable?: (row: T) => boolean;
+  /** Accessible names for the chevron (defaults "Expand row" / "Collapse row"). */
+  expandLabel?: string;
+  collapseLabel?: string;
 }
 
 export interface GridSelection {
@@ -254,6 +259,9 @@ export interface DataGridProps<T = any> extends React.HTMLAttributes<HTMLElement
 
 - **Expansion**:
   - Row expand/collapse before/after row; expanded region must be focusable and labelled.
+  - `isRowExpandable` withholds the chevron per row (the cell stays, so columns align).
+  - The chevron's click does not reach the row's cells, so it never also fires a cell's
+    `onClick` (a row-click that opens the record).
 
 ## 6) Styling Contract (data attributes & slots)
 

package/src/components/data-display/DataGrid/DataGrid.types.ts

@@ -73,6 +73,16 @@ export interface GridRowExpansion<T = Record<string, unknown>> {
   defaultExpandedRowIds?: Array<string | number>;
   /** Row id equality uses `getRowId` */
   onChangeExpanded?: (ids: Array<string | number>) => void;
+  /**
+   * Which rows HAVE a detail. Omitted, every row does. A row it refuses keeps
+   * the (empty) chevron cell, so the columns still line up, but offers no
+   * toggle — a chevron that opens onto nothing is a promise the row cannot keep.
+   */
+  isRowExpandable?: (row: T) => boolean;
+  /** The chevron's accessible name while the row is collapsed. Default "Expand row". */
+  expandLabel?: string;
+  /** The chevron's accessible name while the row is expanded. Default "Collapse row". */
+  collapseLabel?: string;
 }
 
 export interface GridSelection {

package/src/components/data-display/DataViews/DataViewsGrid.tsx

@@ -22,6 +22,7 @@ import {
   type RangeFieldConfig,
   type RowAction,
 } from "./data-views-types";
+import type { DataViewRowDetail } from "./data-views-row-detail";
 import { useDataViewsState } from "./use-data-views-state";
 
 interface DataViewsGridProps<T extends Record<string, unknown>> {
@@ -116,6 +117,11 @@ interface DataViewsGridProps<T extends Record<string, unknown>> {
    * `rowActions`/`bulkActions` still drive the multi-row bulk menu.
    */
   renderRowMenu?: (row: T) => React.ReactNode;
+  /**
+   * Opt-in expandable rows (table layout only): a chevron in a leading column
+   * opens `render(row)` under the row. See {@link DataViewRowDetail}.
+   */
+  rowDetail?: DataViewRowDetail<T>;
   /**
    * Opt-in "Grade" (cards) layout. When provided, a Grade/Tabela toggle appears in
    * the toolbar and the cards body renders each visible row via this function

package/src/components/data-display/DataViews/DataViewsTableBase.tsx

@@ -12,6 +12,7 @@ import { DeleteViewDialog } from "./DeleteViewDialog";
 import type { BoardConfig } from "./DataViewsBoard";
 import type { DataViewExport } from "./data-views-export";
 import type { ScopeConfig } from "./data-views-scopes";
+import type { DataViewRowDetail } from "./data-views-row-detail";
 import { ViewDialogs, ViewMutationErrorAlert } from "./data-views-table-parts";
 import {
   useSavedViewsController,
@@ -81,6 +82,8 @@ export interface DataViewsTableBaseProps<T extends Record<string, unknown>> {
   selectionExtra?: SelectionExtraRender<T>;
   /** Bespoke per-row menu (an entity's self-contained 3-dots menu) instead of the auto kebab. */
   renderRowMenu?: (row: T) => React.ReactNode;
+  /** Opt-in expandable rows (table layout only) — see {@link DataViewRowDetail}. */
+  rowDetail?: DataViewRowDetail<T>;
   /** Opt-in "Grade" (cards) layout — a card renderer per row; adds a Grade/Tabela toggle. */
   renderCard?: (row: T, selection: DataViewCardSelection) => React.ReactNode;
   /** Opt-in "Quadro" (board) layout — the loaded page as columns of one field. Needs `renderCard`. */

package/src/components/data-display/DataViews/data-views-grid-bodies.tsx

@@ -18,6 +18,7 @@ import { DataViewsBoard, type BoardConfig } from "./DataViewsBoard";
 import { SelectAllStrip } from "./data-views-select-all-strip";
 import { ListCardGroup, type ListGroupConfig } from "./list-card-rails";
 import type { DataViewCardSelection } from "./data-views-types";
+import { toGridExpansion, type DataViewRowDetail } from "./data-views-row-detail";
 import type { DataViewsController } from "./use-data-views-state";
 import { useDataViewsCopy } from "./data-views-copy-context";
 
@@ -35,6 +36,7 @@ interface GridBodyProps<T extends Record<string, unknown>> {
   sortMode: "client" | "server";
   /** Vertical cell padding, from the density preference. */
   rowPadding: number;
+  rowDetail?: DataViewRowDetail<T>;
   dataTestId?: string;
   emptyState?: React.ReactNode;
 }
@@ -50,6 +52,7 @@ function GridBody<T extends Record<string, unknown>>({
   onChangeSortBy,
   sortMode,
   rowPadding,
+  rowDetail,
   dataTestId,
   emptyState,
 }: GridBodyProps<T>): React.JSX.Element {
@@ -77,6 +80,7 @@ function GridBody<T extends Record<string, unknown>>({
         headerHeight={36}
         selection={{ mode: "multi", selectedRowIds: selectedIds, onChangeSelected }}
         sorting={{ mode: sortMode, sortBy, onChangeSortBy }}
+        expansion={toGridExpansion(rowDetail, copy)}
         data-testid={dataTestId}
         emptyState={emptyState}
         emptyText={copy.grid.emptyFilteredTitle}
@@ -260,6 +264,8 @@ interface GridMainProps<T extends Record<string, unknown>> {
   listGroup?: ListGroupConfig<T>;
   /** Opt-in "Quadro" (board) layout — needs `renderCard`, since it reuses the card. */
   board?: BoardConfig<T>;
+  /** Opt-in expandable rows — the TABLE only; the headerless layouts ignore it. */
+  rowDetail?: DataViewRowDetail<T>;
   dataTestId?: string;
   emptyState?: React.ReactNode;
   testIdPrefix: string;
@@ -382,6 +388,7 @@ export function GridMain<T extends Record<string, unknown>>(props: GridMainProps
       onChangeSortBy={(next: GridSort[]) => c.patch({ sortBy: next })}
       sortMode={c.serverMode ? "server" : "client"}
       rowPadding={DENSITY_ROW_PADDING[layoutState.density]}
+      rowDetail={props.rowDetail}
       dataTestId={dataTestId}
       emptyState={emptyState}
     />

package/src/components/data-display/DataViews/data-views-grid-parts.tsx

@@ -34,6 +34,7 @@ import type {
   RangeValue,
   RowAction,
 } from "./data-views-types";
+import type { DataViewRowDetail } from "./data-views-row-detail";
 import type { DataViewsController } from "./use-data-views-state";
 
 /* ── Layout ⇄ view-state mirror ──────────────────────────────────────────── */
@@ -197,6 +198,8 @@ interface GridShellProps<T extends Record<string, unknown>> {
   renderListRow?: (row: T, selection: DataViewCardSelection) => React.ReactNode;
   /** The Lista's shared columns, so its rows line up by construction. */
   listGroup?: ListGroupConfig<T>;
+  /** Opt-in expandable rows, drawn by the table layout only. */
+  rowDetail?: DataViewRowDetail<T>;
   /** The page-level partition rendered as tabs under the toolbar. */
   scopes?: ScopeConfig[];
   /**
@@ -300,6 +303,7 @@ function ShellStack<T extends Record<string, unknown>>({
               renderListRow={props.renderListRow}
               listGroup={props.listGroup}
               board={props.board}
+              rowDetail={props.rowDetail}
               dataTestId={dataTestId}
               testIdPrefix={testIdPrefix}
               emptyState={body}

package/src/components/data-display/DataViews/data-views-row-detail.ts

@@ -0,0 +1,40 @@
+import type React from "react";
+
+import type { GridRowExpansion } from "../DataGrid";
+import type { DataViewsCopy } from "./data-views-copy";
+
+/**
+ * A detail that opens UNDER a table row — a sub-table, say — behind a chevron
+ * in its own leading column.
+ *
+ * TABLE layout only. The cards, the list and the board draw no chevron: each is
+ * an entity-rendered surface with its own way of showing more, and a second
+ * disclosure beside that one would compete with it.
+ */
+export interface DataViewRowDetail<T> {
+  /** The detail for one row. Rendered only while that row is expanded. */
+  render: (row: T) => React.ReactNode;
+  /**
+   * Which rows HAVE a detail. Omitted, every row does. A refused row keeps an
+   * empty chevron cell, so the columns stay aligned, but offers nothing to open.
+   */
+  isExpandable?: (row: T) => boolean;
+}
+
+/**
+ * The DataGrid `expansion` a `rowDetail` becomes. The chevron speaks the SAME
+ * words the list card's disclosure does, so the two layouts name the one
+ * gesture identically in every locale.
+ */
+export function toGridExpansion<T extends Record<string, unknown>>(
+  rowDetail: DataViewRowDetail<T> | undefined,
+  copy: DataViewsCopy,
+): GridRowExpansion<T> | undefined {
+  if (!rowDetail) return undefined;
+  return {
+    render: (row) => rowDetail.render(row),
+    isRowExpandable: rowDetail.isExpandable,
+    expandLabel: copy.selection.expandRow,
+    collapseLabel: copy.selection.collapseRow,
+  };
+}

package/src/components/data-display/DataViews/index.ts

@@ -95,3 +95,4 @@ export type {
   DataViewsNavCopy,
   DataViewsSearchCopy,
 } from "./data-views-copy";
+export type { DataViewRowDetail } from "./data-views-row-detail";

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

@@ -200,9 +200,35 @@ const switchBaseSx = (
       color: checkedInk(flags, palette),
       '& .MuiSwitch-thumb': {
         animation: flags.loading ? 'none' : `${bounceAnimation} ${seconds(SWITCH_TRANSITION.ms)} ease-out`,
-        // `glass` draws its own translucent thumb and means to show the track
-        // through it, so it keeps the fill it chose.
-        ...(flags.glass ? {} : { backgroundColor: checkedInk(flags, palette) }),
+        /*
+          GLASS KEEPS ITS WASH AND GAINS AN OUTLINE (FUT-2067).
+
+          It used to keep the wash and nothing else, on the argument that a
+          translucent thumb MEANS to show the track through itself, so painting
+          it opaque would be repainting the variant rather than fixing it. The
+          first half of that is still true and this still does not touch the
+          fill. The second half was doing more work than the number supports:
+          `SWITCH_GLASS.thumbAlpha` is **0.9**, so nine parts in ten of the knob
+          are `background.paper` and one part is the track. On a pale brand that
+          composites to within about 1.1:1 of the bar it is sitting on — the
+          same "reads as OFF while it is on" state FUT-1924 exists for, in the
+          one variant whose own argument points AT the tenant-controlled
+          surface.
+
+          So the separation moves to the EDGE, which is the thing a glass
+          surface is allowed to have. The colour is {@link checkedInk} — the
+          same derivation the opaque thumb gets, so there is one rule for "what
+          reads on this track" rather than two — at full strength rather than
+          the `divider` hairline at `borderAlpha` 0.2 the resting thumb wears,
+          which on a pale track is not an outline at all.
+
+          Checked only. The resting track is `action.disabled` washed over the
+          page, which no tenant chooses, so the quiet hairline stays right
+          there — the same split {@link checkedInk}'s own docblock makes.
+        */
+        ...(flags.glass
+          ? { borderColor: checkedInk(flags, palette) }
+          : { backgroundColor: checkedInk(flags, palette) }),
       },
       '& + .MuiSwitch-track': checkedTrack(flags, palette),
       '&.Mui-disabled + .MuiSwitch-track': { opacity: DISABLED.checkedTrackOpacity },

package/src/tokens/ink-over.ts

@@ -0,0 +1,142 @@
+/**
+ * THE PRODUCT'S TWO INKS, AND THE TWO RULES FOR CHOOSING BETWEEN THEM.
+ *
+ * Split out of `theme.ts` when that file reached the 400-line cap, and the seam
+ * is a real one rather than a place the knife happened to land: everything here
+ * answers one question — given a surface, which of the two inks goes on it —
+ * and nothing here builds a palette. `theme.ts` keeps the tables and the
+ * factories and imports the answers.
+ *
+ * Both functions stay exported from `theme.ts` as well, because both were
+ * published from there and a caller should not have to learn about this file.
+ */
+import { getContrastRatio } from './color';
+
+/** MUI's `createPalette` contrast defaults, exactly. */
+export const CONTRAST_THRESHOLD = 3;
+export const DARK_TEXT_PRIMARY = 'rgba(0, 0, 0, 0.87)';
+export const LIGHT_TEXT_PRIMARY = '#fff';
+
+/**
+ * MUI's `getContrastText`: white where white reads at 3:1 on the colour, the
+ * light mode's dark ink otherwise. (MUI's source spells the white as the DARK
+ * palette's `text.primary`, which is what made it easy to read backwards.)
+ */
+export function contrastText(background: string): string {
+  return getContrastRatio(background, LIGHT_TEXT_PRIMARY) >= CONTRAST_THRESHOLD
+    ? LIGHT_TEXT_PRIMARY
+    : DARK_TEXT_PRIMARY;
+}
+
+/**
+ * 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.
+ *
+ * **It no longer takes the better ink for free (FUT-2066).** "Better worst
+ * case" decides WHICH ink wins; {@link INK_CHANGE_MARGIN} decides whether the
+ * win is big enough to repaint a brand over. The two rows that moved when this
+ * function landed were `warning` — 2.16:1 white on an orange, the defect — and
+ * `danger`, bought for a quarter of a point. Only the first survives the
+ * margin, which is the whole point: one of them was a fix and the other was
+ * churn, and nothing in the old rule could tell them apart.
+ *
+ * `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.
+ *
+ * `incumbent` is the palette's own `contrastText` for this role — what both
+ * call sites already passed, under the name `fallback`. It is still 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), so nothing about that path changed; it has simply
+ * stopped being only a last resort.
+ */
+/**
+ * HOW MUCH BETTER THE OTHER INK HAS TO BE BEFORE A BRAND IS REPAINTED (FUT-2066).
+ *
+ * Half a contrast point. The rule this guards is "take the better worst case",
+ * and on MUI's own stock palette that rule repainted `danger`'s gradient button
+ * from white-on-red to black-on-red for **0.25 of a point** — 3.49 against 3.74,
+ * with neither ink clearing AA either way. A rule that churns a brand for a
+ * rounding difference will churn it again on the next palette tweak, and the
+ * consumer who has to explain why their destructive button changed colour has
+ * no better answer than "it rounded the other way".
+ *
+ * The number sits in a wide measured band rather than on a cliff. Walking the
+ * five gradient pairs `Button.styles.ts` paints, the only two gaps that exist
+ * are `danger`'s **0.25** — the churn — and `warning`'s **3.38**, white at
+ * 2.16:1 on an orange against dark ink at 5.54:1, which is the defect FUT-1924
+ * exists for. Anything in `[0.3, 3.38]` separates them; 0.5 is the round number
+ * nearest the bottom of that band, so the next palette move has to be
+ * substantially larger than a rounding difference before this fires.
+ *
+ * FUT-2066 recorded this as undecidable, on a measurement that turns out to be
+ * wrong: it reports the incumbent for `success` as DARK ink and concludes that
+ * a margin would hold it at 2.66 where the current rule gets 2.78. The gradient
+ * runs `success.light → success.dark`, but `contrastText` answers for
+ * `success.MAIN` — `#2e7d32`, not the `#4caf50` the table names — and white on
+ * `#2e7d32` is 5.7:1, so the incumbent is white and a margin leaves that row
+ * exactly where it is. With that row corrected the objection goes away and the
+ * shape the ticket proposed is simply right.
+ */
+const INK_CHANGE_MARGIN = 0.5;
+
+/**
+ * The contrast below which the incumbent is not worth keeping at any margin.
+ *
+ * MUI's own `contrastThreshold`, and the same number for the same reason: below
+ * 3:1 an ink is not a brand decision, it is text nobody can read. `warning` is
+ * caught by this AND by {@link INK_CHANGE_MARGIN} — white sits at 2.16:1 on
+ * that orange — which is deliberate: the one row that has to move should not
+ * depend on which clause fires.
+ */
+const INK_CHANGE_FLOOR = CONTRAST_THRESHOLD;
+
+export function inkOver(fills: readonly string[], incumbent: string): string {
+  try {
+    const worstCase = (ink: string): number =>
+      Math.min(...fills.map((fill) => getContrastRatio(ink, fill)));
+
+    const better =
+      worstCase(LIGHT_TEXT_PRIMARY) >= worstCase(DARK_TEXT_PRIMARY)
+        ? LIGHT_TEXT_PRIMARY
+        : DARK_TEXT_PRIMARY;
+
+    // The incumbent is the palette's OWN answer for this role, which is what
+    // makes "keep it unless the gain is material" a statement about churn
+    // rather than about arithmetic. It arrives as the same argument that used
+    // to be the parse-failure fallback, because it always was `contrastText`
+    // at both call sites — the parameter has stopped being a last resort and
+    // started being the thing being defended.
+    const held = worstCase(incumbent);
+    const gain = worstCase(better) - held;
+    return gain >= INK_CHANGE_MARGIN || held < INK_CHANGE_FLOOR ? better : incumbent;
+  } catch {
+    return incumbent;
+  }
+}