@multiplatform.one/theme 7.63.3 → 7.64.0

package/src/theme/motion.ts

@@ -9,9 +9,12 @@ export type MotionRoleName = "control" | "overlay" | "scrim" | "reveal" | "slide
 
 export interface MotionRole {
   transition: TransitionProp | undefined;
+  exit?: TransitionProp | undefined;
   animateOnly: readonly string[];
 }
 
+export const motionExitFactor = 2 / 3;
+
 export const motionRoleProperties = {
   control: ["backgroundColor", "borderColor", "color", "opacity", "transform"],
   overlay: ["opacity", "transform"],
@@ -22,8 +25,8 @@ export const motionRoleProperties = {
 
 const nonBouncyStops = motionStops.filter((stop) => stop !== "superBouncy" && stop !== "bouncy");
 
-function nearestStop(duration: number): MotionStop {
-  return nonBouncyStops.reduce((nearest, candidate) =>
+function nearestStop(duration: number, stops: readonly MotionStop[] = nonBouncyStops): MotionStop {
+  return stops.reduce((nearest, candidate) =>
     Math.abs(animationDurations[candidate] - duration) <
     Math.abs(animationDurations[nearest] - duration)
       ? candidate
@@ -31,18 +34,28 @@ function nearestStop(duration: number): MotionStop {
   );
 }
 
+function exitStop(enter: MotionStop): MotionStop {
+  const enterMs = animationDurations[enter];
+  const shorter = nonBouncyStops.filter((stop) => animationDurations[stop] < enterMs);
+  return shorter.length === 0 ? enter : nearestStop(enterMs * motionExitFactor, shorter);
+}
+
 export function motionFor(stop: Animation): Record<MotionRoleName, MotionRole> {
   const transition = stop === "none" ? undefined : stop;
   const duration = motionDurationMs(transition);
-  const role = (name: MotionRoleName, factor: number): MotionRole => ({
-    transition:
+  const role = (name: MotionRoleName, factor: number): MotionRole => {
+    const enter =
       transition === undefined
         ? undefined
         : name === "control"
           ? transition
-          : nearestStop(duration * factor),
-    animateOnly: motionRoleProperties[name],
-  });
+          : nearestStop(duration * factor);
+    return {
+      transition: enter,
+      exit: enter === undefined ? undefined : exitStop(enter),
+      animateOnly: motionRoleProperties[name],
+    };
+  };
   return {
     control: role("control", 1),
     overlay: role("overlay", 0.8),

package/src/theme/mpo19Proof.spec.ts

@@ -208,9 +208,9 @@ describe("MPO-19 X5/X6 — surfaces address semantic tokens, so sub-themes work"
 });
 
 describe("MPO-19 X7 — the focus ring is inset only where a clip demands it", () => {
-  it("the default sits on the border-box edge, as Tamagui paints it", () => {
-    expect(FOCUS_VISIBLE_RING.outlineOffset).toBe(0);
-    expect(ensureFocusVisibleRing().outlineOffset).toBe(0);
+  it("the default sits 2px clear of the border box (FZ-7944 round 2)", () => {
+    expect(FOCUS_VISIBLE_RING.outlineOffset).toBe(2);
+    expect(ensureFocusVisibleRing().outlineOffset).toBe(2);
   });
 
   it("the ring shape itself is unchanged — 2px solid, non-removable", () => {

package/src/theme/overlaySurfaces.tsx

@@ -1,3 +1,4 @@
+import { focusOnOpen, wasKeyboardFocus } from "../keyboardFocusRing";
 import { transitionProps } from "./transitionProps";
 import { Surface } from "./Surface";
 import { useResolvedKnobs } from "./useResolvedKnobs";
@@ -40,7 +41,9 @@ const overlayFrameFocusStyle = {
 // tamagui's deferred path still runs. Dialog content sits in a native
 // <dialog> whose show() puts focus inside before the check in browsers,
 // so there FocusScope never calls the handler; useDialogShowFocus does
-// when show() left focus on something that is not a tab stop (MPO-470).
+// when show() left focus on something that is not a tab stop (MPO-470), or
+// on any control after a non-keyboard open, which Chromium would ring
+// (LC-71, FZ-7944).
 
 function isTabbableWithin(node: HTMLElement, container: HTMLElement): boolean {
   if (node.tabIndex < 0 || node.hidden || node.tagName === "A") return false;
@@ -67,8 +70,10 @@ function focusFirstTabbableOnOpen(event: Event): void {
   );
   if (!first) return;
   event.preventDefault();
-  first.focus({ preventScroll: true });
-  if (typeof HTMLInputElement !== "undefined" && first instanceof HTMLInputElement) first.select();
+  const focused = focusOnOpen(first, container);
+  if (typeof HTMLInputElement !== "undefined" && focused instanceof HTMLInputElement) {
+    focused.select();
+  }
 }
 
 type OpenAutoFocus = (event: Event) => void;
@@ -100,7 +105,7 @@ function useDialogShowFocus(onOpenAutoFocus: OpenAutoFocus): void {
     const content = document.getElementById(contentId);
     const focused = document.activeElement;
     if (!content || typeof HTMLElement === "undefined" || !(focused instanceof HTMLElement)) return;
-    if (!content.contains(focused) || focused.tabIndex >= 0) return;
+    if (!content.contains(focused) || (focused.tabIndex >= 0 && wasKeyboardFocus())) return;
     content.addEventListener(DIALOG_SHOW_FOCUS_EVENT, onOpenAutoFocus, { once: true });
     content.dispatchEvent(new CustomEvent(DIALOG_SHOW_FOCUS_EVENT, { cancelable: true }));
   }, [open, contentId]);

package/src/theme/recipes.ts

@@ -69,6 +69,15 @@ export interface ElevationChromeProps extends ElevationPaintProps {
   elevation?: number;
 }
 
+/**
+ * A content card's lift (LC-151): an explicit shadow plus Android dp under
+ * `elevationAndroid`. Not `elevation`: on native that key is Tamagui's stack
+ * variant, which replaces the shadow with its own size-formula one.
+ */
+export interface CardLiftProps extends ElevationPaintProps {
+  elevationAndroid?: number;
+}
+
 // ── Disabled state recipe (LC-40 DISABLED-VISIBLE) ───────────────────────
 
 /** Text-bearing control chrome (Button, Chip, Input.Box): muted fill/border, no opacity. */
@@ -228,7 +237,7 @@ export interface KnobProps {
     borderWidth?: number;
     borderRadius: string | number;
     padding: string;
-  } & ElevationChromeProps &
+  } & CardLiftProps &
     CornerSmoothingCarrier;
   /** Elevated/overlay tier (popovers, dropdowns): border + elevation. */
   elevatedSurface: {

package/src/theme/resolveKnobs.spec.ts

@@ -30,6 +30,7 @@ import {
   resolveKnobs,
   resolvePageTitleScale,
   spacingRoles,
+  cardLift,
   sizedElevation,
 } from "./resolveKnobs";
 import { getActiveScaleTokens, setActiveScaleTokens } from "./scale/activeScale";
@@ -314,7 +315,7 @@ describe("resolveKnobs", () => {
             scheme === "dark" ? "$color4" : "$background",
           );
           expect(knobProps.elevatedSurface.borderColor).toBe(
-            scheme === "dark" ? "$color6" : "$borderColor",
+            scheme === "dark" ? "transparent" : "$borderColor",
           );
           if (!key) {
             expect(knobProps.elevationChrome).toEqual({});
@@ -362,7 +363,7 @@ describe("resolveKnobs", () => {
   });
 
   describe("elevation knob (native)", () => {
-    it("returns active scale numbers with the same paint in both schemes", async () => {
+    it("returns active scale numbers, and every shadow carries its alpha as shadowOpacity on an opaque ink", async () => {
       vi.resetModules();
       vi.doMock("@multiplatform.one/platform", () => ({
         isWeb: false,
@@ -407,15 +408,33 @@ describe("resolveKnobs", () => {
               if (key) {
                 const metrics = sizedElevation(active.getActiveScaleTokens().size[key]);
                 expect(knobProps.elevationChrome).toEqual({
-                  shadowColor: "$shadowColor",
-                  shadowOpacity: 1,
+                  shadowColor: "rgb(0,0,0)",
+                  shadowOpacity: 0.12,
                   shadowOffset: { width: 0, height: metrics.offsetY },
                   shadowRadius: metrics.radius,
                   elevation: metrics.android,
                 });
               } else expect(knobProps.elevationChrome).toEqual({});
               expect(knobProps.thumbShadow.style).toBeUndefined();
-              expect(knobProps.thumbShadow.shadowColor).toBe("$shadowColor");
+              expect(knobProps.thumbShadow.shadowOpacity).toBe(0.12);
+              const card = knobProps.cardSurface;
+              if (scheme === "dark" || stop === "none") {
+                expect(card).not.toHaveProperty("shadowColor");
+              } else {
+                expect(card.shadowColor).toBe("rgb(0,0,0)");
+                expect(card.shadowOpacity).toBe(0.08);
+                expect(card.style).toBeUndefined();
+              }
+              expect(knobProps.featureSurface.shadowOpacity).toBeLessThanOrEqual(0.08);
+              for (const fragment of [
+                knobProps.elevationChrome,
+                knobProps.thumbShadow,
+                card,
+                knobProps.elevatedSurface,
+                knobProps.featureSurface,
+              ]) {
+                if ("shadowOpacity" in fragment) expect(fragment.shadowOpacity).toBeLessThan(0.5);
+              }
             }
           }
         }
@@ -668,23 +687,41 @@ describe("resolveKnobs", () => {
   // ── surface tiers ─────────────────────────────────────────
 
   describe("surface tier recipes", () => {
-    it("cardSurface = grouped fill + hairline edge + a hair of lift (LC-151)", () => {
+    it("cardSurface = grouped fill + hairline edge + a natural lift (LC-151)", () => {
       const { knobProps } = resolveKnobs(defaultKnobs);
-      const { offsetY, radius, android } = sizedElevation(getActiveScaleTokens().size["$0.25"]);
+      const { offsetY, radius, android } = cardLift(getActiveScaleTokens().size["$0.25"]);
       expect(knobProps.cardSurface).toEqual({
         backgroundColor: "$background",
         borderColor: edgeColorAt("$borderColor", "small"),
         borderWidth: hairlineBorderWidth,
         borderRadius: "$6",
         padding: "$4",
-        shadowColor: "$shadowColor",
+        shadowColor: "$shadow2",
         shadowOffset: { width: 0, height: offsetY },
         shadowOpacity: 1,
         shadowRadius: radius,
-        elevation: android,
-        style: { boxShadow: `0px ${offsetY}px ${radius}px var(--shadowColor)` },
+        elevationAndroid: android,
+        style: {
+          boxShadow: `0px 1px 2px var(--shadow1), 0px ${offsetY}px ${radius * 2}px var(--shadow2)`,
+        },
       });
-      expect(offsetY).toBeLessThanOrEqual(2);
+    });
+
+    it("card lift: the blur is three times the drop, and no `elevation` key for Tamagui's variant to replace it", () => {
+      for (const elevation of ["small", "medium", "large"] as const) {
+        const card = resolveKnobs(knobsWith({ elevation })).knobProps.cardSurface;
+        expect(card.shadowRadius! / card.shadowOffset!.height, elevation).toBeGreaterThanOrEqual(
+          2.5,
+        );
+        expect(card.shadowRadius! / card.shadowOffset!.height, elevation).toBeLessThanOrEqual(3.5);
+        expect(card, elevation).not.toHaveProperty("elevation");
+      }
+    });
+
+    it("card lift is off in dark: the lighter card fill carries the step", () => {
+      const card = resolveKnobs(defaultKnobs, undefined, "dark").knobProps.cardSurface;
+      expect(card).not.toHaveProperty("shadowColor");
+      expect(card).not.toHaveProperty("elevationAndroid");
     });
 
     it("cardSurface lift is lower than every overlay stop and gone at elevation none", () => {

package/src/theme/resolveKnobs.ts

@@ -21,6 +21,7 @@ import { SIZE_KEYS, type SizeKey } from "./scale/scaleInputs";
 import type {
   ControlStateProps,
   DisabledRecipe,
+  CardLiftProps,
   ElevationChromeProps,
   ElevationPaintProps,
   ElevationStateProps,
@@ -395,6 +396,15 @@ export function sizedElevation(px: number): { offsetY: number; radius: number; a
   return { offsetY, radius: Math.round(px / 2 + 2), android: 2 * offsetY };
 }
 
+// Native: Tamagui's normalizeShadow repaints shadowColor at full alpha and
+// keeps only shadowOpacity, so a translucent shadow token at shadowOpacity 1
+// draws solid black. Native gets an opaque ink and the token's alpha.
+function shadowInk(token: string, alpha: number): { shadowColor: string; shadowOpacity: number } {
+  return isWeb
+    ? { shadowColor: token, shadowOpacity: 1 }
+    : { shadowColor: "rgb(0,0,0)", shadowOpacity: alpha };
+}
+
 function platformElevation(key: SizeKey | undefined): string | number | undefined {
   return key && (isWeb ? key : getActiveScaleTokens().size[key]);
 }
@@ -403,14 +413,41 @@ function elevationPaint(key: SizeKey | undefined): ElevationPaintProps {
   if (!key) return {};
   const { offsetY, radius } = sizedElevation(getActiveScaleTokens().size[key]);
   return {
-    shadowColor: "$shadowColor",
+    ...shadowInk("$shadowColor", 0.12),
     shadowOffset: { width: 0, height: offsetY },
-    shadowOpacity: 1,
     shadowRadius: radius,
     ...(isWeb ? { style: { boxShadow: `0px ${offsetY}px ${radius}px var(--shadowColor)` } } : {}),
   };
 }
 
+// LC-151 card lift, a natural shadow: the blur three times the drop, a faint
+// ink, and on web a tight contact layer under the ambient one. Dark lets the
+// card's lighter fill carry the step; a black shadow on a black page reads as
+// a smudge.
+export function cardLift(px: number): { offsetY: number; radius: number; android: number } {
+  const radius = Math.round(8 + px * 2);
+  const offsetY = Math.round(radius / 3);
+  return { offsetY, radius, android: Math.max(1, Math.round(offsetY / 2)) };
+}
+
+function cardLiftFor(key: SizeKey | undefined, scheme: ColorScheme): CardLiftProps {
+  if (!key || scheme === "dark") return {};
+  const { offsetY, radius, android } = cardLift(getActiveScaleTokens().size[key]);
+  return {
+    ...shadowInk("$shadow2", 0.08),
+    shadowOffset: { width: 0, height: offsetY },
+    shadowRadius: radius,
+    elevationAndroid: android,
+    ...(isWeb
+      ? {
+          style: {
+            boxShadow: `0px 1px 2px var(--shadow1), 0px ${offsetY}px ${radius * 2}px var(--shadow2)`,
+          },
+        }
+      : {}),
+  };
+}
+
 function elevationChromeFor(key: SizeKey | undefined): ElevationChromeProps {
   if (!key) return {};
   return {
@@ -419,10 +456,10 @@ function elevationChromeFor(key: SizeKey | undefined): ElevationChromeProps {
   };
 }
 
-// v5's surface2 template steps: fill and edge two palette steps above the
-// base `$background`/`$borderColor` (color2/color4), one above Card's surface1.
-// The fill alone would land on the base edge step and erase the border.
-const surface2 = { fill: "$color4", edge: "$color6" } as const;
+// v5's surface2 template step: the fill two palette steps above the base
+// `$background` (color2), one above Card's surface1. A dark overlay separates
+// by this lighter fill and its shadow, with no light edge (HIG, FZ-7944).
+const surface2 = { fill: "$color4" } as const;
 
 // `$textMuted` is the theme's secondary ink (LC-152): the most muted ramp
 // step that clears 7:1 on the page and every card tier in its own scheme. A
@@ -750,7 +787,7 @@ export function resolveKnobs(
           borderWidth: knobs.borderWidth === "none" ? 0 : borderWidthMap.small,
           borderRadius: containerRadiusValue,
           padding: paddingToken,
-          ...elevationChromeFor(cardElevationMap[knobs.elevation]),
+          ...cardLiftFor(cardElevationMap[knobs.elevation], scheme),
           ...containerSmoothing,
         },
     elevatedSurface: painted
@@ -764,7 +801,7 @@ export function resolveKnobs(
         }
       : {
           backgroundColor: scheme === "dark" ? surface2.fill : "$background",
-          borderColor: edge(scheme === "dark" ? surface2.edge : "$borderColor", borderWidthValue),
+          borderColor: scheme === "dark" ? "transparent" : edge("$borderColor", borderWidthValue),
           borderWidth: borderWidthValue,
           borderRadius: radiusToken,
           elevation: platformElevation(overlayElevationToken),
@@ -777,9 +814,8 @@ export function resolveKnobs(
       padding: spacingRoles.featurePadding,
       // Bento marketing/auth card shadow: ~0px 9px 12px rgba(0,0,0,0.02) —
       // softer/wider than any elevationMap token, so explicit shadow props.
-      shadowColor: "rgba(0,0,0,0.02)",
+      ...shadowInk("rgba(0,0,0,0.02)", 0.02),
       shadowOffset: { width: 0, height: 9 },
-      shadowOpacity: 1,
       shadowRadius: 12,
       ...containerSmoothing,
     },

package/src/theme/transitionProps.native.ts

@@ -1,5 +1,6 @@
 import type { MotionRole } from "./motion";
 import type { TransitionProp } from "tamagui";
+import { animationConfig as nativeAnimationConfig } from "./animations/reactNative";
 
 /**
  * Native twin of `transitionProps.ts`.
@@ -23,12 +24,26 @@ export function transitionProps(
   const properties = [...role.animateOnly, ...extra].flatMap(
     (property) => nativeLonghands[property] ?? [property],
   );
+  if (typeof transition !== "string") return { transition, animateOnly: properties };
+  const exit = typeof role.exit === "string" && role.exit !== transition ? role.exit : undefined;
+  const clamp = isSpring(transition) && !presetBounce.has(transition);
+  if (!exit && !clamp) return { transition, animateOnly: properties };
   return {
-    transition,
+    transition: [
+      transition,
+      { ...(clamp ? { overshootClamping: true } : {}), ...(exit ? { exit } : {}) },
+    ],
     animateOnly: properties,
   };
 }
 
+function isSpring(stop: string): boolean {
+  const config = nativeAnimationConfig[stop as keyof typeof nativeAnimationConfig] as
+    | { type?: string }
+    | undefined;
+  return config !== undefined && config.type !== "timing";
+}
+
 /**
  * FZ-7919: tamagui expands `borderColor` into its four sides before the React
  * Native driver sees the style, and the driver matches `animateOnly` by exact
@@ -36,6 +51,8 @@ export function transitionProps(
  * (the bubbled focus of a field's text input) animated them. The animated
  * copy outranked the static one and held the previous focus or theme colour.
  */
+const presetBounce = new Set(["bouncy", "superBouncy"]);
+
 const nativeLonghands: Record<string, readonly string[]> = {
   borderColor: [
     "borderColor",

package/src/theme/transitionProps.spec.ts

@@ -24,7 +24,7 @@ describe("role property scopes", () => {
   });
   it("hyphenates the control scope and additional properties", () => {
     expect(transitionProps(motionFor("quick").control, ["maxHeight", "left"])).toEqual({
-      transition: "quick",
+      transition: ["quick", { exit: "quickerLessBouncy" }],
       animateOnly: [
         "background-color",
         "border-color",
@@ -41,7 +41,7 @@ describe("role property scopes", () => {
     expect(nativeTransitionProps(undefined)).toEqual({});
     expect(nativeTransitionProps("quick")).toEqual({ transition: "quick" });
     expect(nativeTransitionProps(motionFor("quick").control, ["maxHeight"])).toEqual({
-      transition: "quick",
+      transition: ["quick", { overshootClamping: true, exit: "quickerLessBouncy" }],
       animateOnly: [
         "backgroundColor",
         "borderColor",

package/src/theme/transitionProps.ts

@@ -22,13 +22,23 @@ export function transitionProps(
   if (!isRole) return { transition };
   const properties = [...role.animateOnly, ...extra];
   return {
-    transition,
+    transition: withExit(transition, role.exit),
     animateOnly: properties.map((property) =>
       property.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`),
     ),
   };
 }
 
+function withExit(
+  transition: TransitionProp | undefined,
+  exit: TransitionProp | undefined,
+): TransitionProp | undefined {
+  if (typeof transition !== "string" || typeof exit !== "string" || exit === transition) {
+    return transition;
+  }
+  return [transition, { exit }];
+}
+
 function isMotionRole(value: MotionRole | TransitionProp | undefined): value is MotionRole {
   return (
     typeof value === "object" &&

package/types/keyboardFocusRing.d.ts

@@ -22,6 +22,17 @@ export declare function ensureKeyboardModalityTracking(): void;
  * false) and during SSR.
  */
 export declare function wasKeyboardFocus(): boolean;
+/**
+ * An overlay's open focus (LC-71, FZ-7944). Only a keyboard open lands on a
+ * control and rings it. Any other open (pointer, touch, mounted open) lands on
+ * the frame, which paints no ring: Chromium ignores `focusVisible: false` and
+ * rings a control focused before any input. A mouse open still puts the caret
+ * in a first text field, which shows LC-133's border; a touch open does not,
+ * so the keyboard does not rise over a sheet the user only looked at. A frame
+ * without a tabindex gets -1, or its focus() is a no-op and the browser's
+ * own pick stays. Returns the node that took focus.
+ */
+export declare function focusOnOpen(target: HTMLElement | null, frame: HTMLElement): HTMLElement;
 /**
  * Standard manual ring props — the INSET ring geometry
  * (`FOCUS_VISIBLE_RING_INSET`: 2px solid `$outlineColor`, offset −2), spread

package/types/keyboardFocusRing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyboardFocusRing.d.ts","sourceRoot":"","sources":["../src/keyboardFocusRing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;;;GAIG;AACH,wBAAgB,8BAA8B,SAK7C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAID;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB;;;;;CAEzB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,8uCA+BhC,CAAC;AAIH,uEAAuE;AACvE,wBAAgB,wBAAwB,IAAI,IAAI,CAO/C"}
+{"version":3,"file":"keyboardFocusRing.d.ts","sourceRoot":"","sources":["../src/keyboardFocusRing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;;;GAIG;AACH,wBAAgB,8BAA8B,SAY7C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAWD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,WAAW,GAAG,WAAW,CAQvF;AAID;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB;;;;;CAEzB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,8uCA+BhC,CAAC;AAIH,uEAAuE;AACvE,wBAAgB,wBAAwB,IAAI,IAAI,CAO/C"}

package/types/theme/createThemes.d.ts.map

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

package/types/theme/focusState.d.ts

@@ -16,26 +16,21 @@ export declare const FOCUS_RING_MIN_CONTRAST = 3;
 export declare function focusRingColorMeetsContrast(ringColor: string, surfaceColor: string): boolean;
 /**
  * ONE ring geometry (DG-A11Y-01 / LC-71 §4): 2px solid `$outlineColor` at
- * offset **0** — the band hugs the border box and paints OUTSIDE it, on the
- * surface behind the control (reference §10; board F1 verify pass: offset 0,
- * not −2 and not +2). Offset 0 is what makes the ≥3:1 floor computable: the
- * ring contrasts against the page ground, not the control's own fill. The
- * old flat inset (−2) painted the band INSIDE solid intent fills and sank to
- * 1.17–1.31:1 (light accent 1.27, light error 1.17, dark error 1.31) where
- * the same ring on the page ground clears 5.78–6.50:1 (MPO-41 / MPO-19 X7).
+ * offset **+2**, a band clear of the border box with a 2px gap, painted on the
+ * surface behind the control. FZ-7944 round 2 moved the default from 0 to +2
+ * (the macOS and iPadOS keyboard ring); the ≥3:1 floor stays computable
+ * because the band still paints on the page ground, never inside a fill. The
+ * old flat inset (−2) painted INSIDE solid intent fills and sank to
+ * 1.17–1.31:1 (MPO-41 / MPO-19 X7).
  *
- * The inset did not die — it moved to `FOCUS_VISIBLE_RING_INSET`, an
- * explicit per-call-site carve-out for clipping ancestors. MPO-19 X7 names
- * the same offset `FOCUS_RING_CLIPPED_OFFSET` so call sites do not type `-2`.
- *
- * MPO-92 ratified a second, shape-scoped carve-out on the other side:
- * `FOCUS_VISIBLE_RING_HALO` (+2) for pill/circular thumbs and inline text
- * links. The F1 "not +2" reading was about the DEFAULT — a blanket +2 on
- * every control — and it stands. The halo is a named carve-out with a written
- * shape scope, exactly as the inset is; `SANCTIONED_FOCUS_RING_OFFSETS` below
- * is the closed set of all three.
+ * Two carve-outs stay named: `FOCUS_VISIBLE_RING_INSET` (−2) for clipping
+ * ancestors, and `FOCUS_RING_FLUSH_OFFSET` (0) for rows and cells that sit
+ * edge to edge inside a padded overlay, where a gapped band would collide
+ * with the neighbour. `SANCTIONED_FOCUS_RING_OFFSETS` is the closed set.
  */
 export declare const FOCUS_RING_CLIPPED_OFFSET = -2;
+export declare const FOCUS_RING_FLUSH_OFFSET = 0;
+export declare const FOCUS_RING_HALO_OFFSET = 2;
 export declare const FOCUS_VISIBLE_RING: {
     outlineWidth: number;
     outlineStyle: "solid";
@@ -62,29 +57,10 @@ export declare const FOCUS_VISIBLE_RING_INSET: {
     outlineColor: string;
 };
 /**
- * The LC-71 §4 halo carve-out (MPO-92, ratified 2026-09-02): the SAME ring,
- * pushed 2px clear of the border box, for the two shapes where a band hugging
- * the edge reads as part of the glyph instead of around it.
- *
- * Scope is by SHAPE, not by instance, and it is closed at two:
- *   - **pill / circular thumbs** — a round handle the user drags (Slider
- *     thumb, Rating star, TimeRangeScrubber handle). At offset 0 the band is
- *     concentric with the glyph's own edge and reads as a thicker glyph.
- *   - **inline text links** — a link inside a run of prose (markdown/mdx
- *     `Link`, ErrorSummary's summary link, backoffice "View All"). At offset 0
- *     the band crosses the line box and collides with ascenders/descenders of
- *     the surrounding text.
- *
- * NOT for standalone rectangles on the page ground — cards, tiles, rows,
- * fields. Those are the default `FOCUS_VISIBLE_RING` (offset 0), which is
- * what makes the Axiom 12 ≥3:1 floor computable against the page ground.
- *
- * Contrast is unaffected: like offset 0 the halo paints OUTSIDE the border
- * box, on the surface behind the control, so it measures against the same
- * page ground the default does — the 1.17–1.31:1 failures MPO-41 retired were
- * the INSET painting inside solid intent fills, a defect the halo cannot have.
+ * The halo (MPO-92): pill and circular thumbs and inline text links. Since
+ * FZ-7944 round 2 it equals the default ring; the name stays so those call
+ * sites keep saying why they hold +2 if the default ever moves again.
  */
-export declare const FOCUS_RING_HALO_OFFSET = 2;
 export declare const FOCUS_VISIBLE_RING_HALO: {
     outlineOffset: number;
     outlineWidth: number;
@@ -93,13 +69,13 @@ export declare const FOCUS_VISIBLE_RING_HALO: {
 };
 /**
  * The CLOSED set of sanctioned focus-ring offsets (LC-71 §4). Three, and only
- * three: the default 0, the clipping inset −2, the shape halo +2. A call site
+ * three: the clipping inset −2, the flush 0, the default +2. A call site
  * that wants any other number is a rule gap, not a preference — file it and
  * amend §4, do not type the number. `focusState.spec.ts` asserts this set is
  * exactly what the repo paints, so a fourth offset fails a test instead of
  * shipping (MPO-92 AC-3).
  */
-export declare const SANCTIONED_FOCUS_RING_OFFSETS: readonly [-2, number, 2];
+export declare const SANCTIONED_FOCUS_RING_OFFSETS: readonly [-2, 0, number];
 /** True when `offset` is one of the three offsets LC-71 §4 sanctions. */
 export declare function isSanctionedFocusRingOffset(offset: number): boolean;
 /**

package/types/theme/focusState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focusState.d.ts","sourceRoot":"","sources":["../../src/theme/focusState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAuBzC;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAO5F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,kBAAkB;;;;;CAKF,CAAC;AAE9B;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB;;;;;CAGR,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,uBAAuB;;;;;CAGP,CAAC;AAE9B;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,0BAIhC,CAAC;AAEX,yEAAyE;AACzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;CAED,CAAC;AAE9B,eAAO,MAAM,iBAAiB;;CAED,CAAC;AAE9B;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,iBAAiB,EAChE,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAC,GAAG,IAAI,GACxC,CAAC,GAAG,iBAAiB,CAyBvB;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,iBAAiB,GACvB,iBAAiB,CAKnB"}
+{"version":3,"file":"focusState.d.ts","sourceRoot":"","sources":["../../src/theme/focusState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAuBzC;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAO5F;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,kBAAkB;;;;;CAKF,CAAC;AAE9B;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB;;;;;CAGR,CAAC;AAE9B;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;CAGP,CAAC;AAE9B;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,0BAIhC,CAAC;AAEX,yEAAyE;AACzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;CAED,CAAC;AAE9B,eAAO,MAAM,iBAAiB;;CAED,CAAC;AAE9B;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,iBAAiB,EAChE,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAC,GAAG,IAAI,GACxC,CAAC,GAAG,iBAAiB,CAyBvB;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,iBAAiB,GACvB,iBAAiB,CAKnB"}

package/types/theme/motion.d.ts

@@ -4,8 +4,10 @@ export { motionDurationMs, motionHideDelayMs, motionSeconds, motionSettleMs } fr
 export type MotionRoleName = "control" | "overlay" | "scrim" | "reveal" | "slide";
 export interface MotionRole {
     transition: TransitionProp | undefined;
+    exit?: TransitionProp | undefined;
     animateOnly: readonly string[];
 }
+export declare const motionExitFactor: number;
 export declare const motionRoleProperties: {
     readonly control: readonly ["backgroundColor", "borderColor", "color", "opacity", "transform"];
     readonly overlay: readonly ["opacity", "transform"];

package/types/theme/motion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../src/theme/motion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIzC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpG,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElF,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,cAAc,GAAG,SAAS,CAAC;IACvC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,eAAO,MAAM,oBAAoB;;;;;;CAM6B,CAAC;AAa/D,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC,cAAc,EAAE,UAAU,CAAC,CAmB7E"}
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../src/theme/motion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIzC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpG,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElF,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,cAAc,GAAG,SAAS,CAAC;IACvC,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAClC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC,eAAO,MAAM,oBAAoB;;;;;;CAM6B,CAAC;AAmB/D,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC,cAAc,EAAE,UAAU,CAAC,CAuB7E"}

package/types/theme/overlaySurfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlaySurfaces.d.ts","sourceRoot":"","sources":["../../src/theme/overlaySurfaces.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAML,KAAK,kBAAkB,IAAI,yBAAyB,EAEpD,KAAK,UAAU,EACf,KAAK,cAAc,EAEpB,MAAM,SAAS,CAAC;AAyDjB,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAmC5C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,eAAe,EAAE,EAAE;IAAE,eAAe,CAAC,EAAE,aAAa,CAAA;CAAE,GAAG,IAAI,CAG9F;AAID,MAAM,WAAW,wBAAwB;IACvC,4EAA4E;IAC5E,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,mDAE9B,CAAC;AAEH,wBAAgB,sBAAsB,IAAI,wBAAwB,CAEjE;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAQD,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,yBAAyB,EAAE,MAAM,CAAC,GAAG;IACzE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,aAAa;eAJb,SAAS;WACb,UAAU;kDAcjB,CAAC;AA0CH;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;;;;;eAEiB,SAAS;kDAelD,CAAC;AAOH,eAAO,MAAM,kBAAkB;eAxFlB,SAAS;WACb,UAAU;kDAiGlB,CAAC;AAgCF,eAAO,MAAM,kBAAkB;;;;;;;;eAEY,SAAS;kDAelD,CAAC;AAiBH,eAAO,MAAM,cAAc;eALd,SAAS;IACpB,iEAAiE;sBAC/C,aAAa;kDA0BhC,CAAC"}
+{"version":3,"file":"overlaySurfaces.d.ts","sourceRoot":"","sources":["../../src/theme/overlaySurfaces.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAML,KAAK,kBAAkB,IAAI,yBAAyB,EAEpD,KAAK,UAAU,EACf,KAAK,cAAc,EAEpB,MAAM,SAAS,CAAC;AA6DjB,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAmC5C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,eAAe,EAAE,EAAE;IAAE,eAAe,CAAC,EAAE,aAAa,CAAA;CAAE,GAAG,IAAI,CAG9F;AAID,MAAM,WAAW,wBAAwB;IACvC,4EAA4E;IAC5E,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,mDAE9B,CAAC;AAEH,wBAAgB,sBAAsB,IAAI,wBAAwB,CAEjE;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAQD,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,yBAAyB,EAAE,MAAM,CAAC,GAAG;IACzE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,aAAa;eAJb,SAAS;WACb,UAAU;kDAcjB,CAAC;AA0CH;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;;;;;eAEiB,SAAS;kDAelD,CAAC;AAOH,eAAO,MAAM,kBAAkB;eAxFlB,SAAS;WACb,UAAU;kDAiGlB,CAAC;AAgCF,eAAO,MAAM,kBAAkB;;;;;;;;eAEY,SAAS;kDAelD,CAAC;AAiBH,eAAO,MAAM,cAAc;eALd,SAAS;IACpB,iEAAiE;sBAC/C,aAAa;kDA0BhC,CAAC"}

package/types/theme/recipes.d.ts

@@ -59,6 +59,14 @@ export interface ElevationChromeProps extends ElevationPaintProps {
     /** Android dp is twice the size-formula offsetY. */
     elevation?: number;
 }
+/**
+ * A content card's lift (LC-151): an explicit shadow plus Android dp under
+ * `elevationAndroid`. Not `elevation`: on native that key is Tamagui's stack
+ * variant, which replaces the shadow with its own size-formula one.
+ */
+export interface CardLiftProps extends ElevationPaintProps {
+    elevationAndroid?: number;
+}
 /** Text-bearing control chrome (Button, Chip, Input.Box): muted fill/border, no opacity. */
 export interface DisabledSurfaceProps {
     backgroundColor?: string;
@@ -224,7 +232,7 @@ export interface KnobProps {
         borderWidth?: number;
         borderRadius: string | number;
         padding: string;
-    } & ElevationChromeProps & CornerSmoothingCarrier;
+    } & CardLiftProps & CornerSmoothingCarrier;
     /** Elevated/overlay tier (popovers, dropdowns): border + elevation. */
     elevatedSurface: {
         backgroundColor: string;