@multiplatform.one/theme 7.6.3 → 7.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/theme",
-  "version": "7.6.3",
+  "version": "7.7.1",
   "description": "Tamagui theme system for multiplatform.one",
   "keywords": [
     "multiplatform",
@@ -53,15 +53,14 @@
     "@tamagui/toast": "2.7.6",
     "@tamagui/web": "2.7.6",
     "react-cookie": "^8.1.2",
-    "@multiplatform.one/platform": "7.6.3",
-    "@multiplatform.one/store": "7.6.3"
+    "@multiplatform.one/platform": "7.7.1",
+    "@multiplatform.one/store": "7.7.1"
   },
   "devDependencies": {
     "@tamagui/animations-css": "2.7.6",
     "@tamagui/animations-reanimated": "2.7.6",
     "@tamagui/font-inter": "2.7.6",
     "@testing-library/react": "^16.3.2",
-    "@types/react": "~19.2.14",
     "@vitejs/plugin-react": "^6.0.1",
     "@vitest/coverage-v8": "^4.1.5",
     "react": "19.2.5",
@@ -69,8 +68,8 @@
     "tamagui": "2.7.6",
     "typescript": "~5.9.3",
     "vitest": "^4.1.5",
-    "@multiplatform.one/config": "7.6.3",
-    "@multiplatform.one/test-utils": "7.6.3"
+    "@multiplatform.one/config": "7.7.1",
+    "@multiplatform.one/test-utils": "7.7.1"
   },
   "peerDependencies": {
     "@tamagui/animations-css": "^2.0.0-rc",

package/src/theme/colorRules.spec.ts

@@ -12,6 +12,7 @@ import {
   resolveThemeContrast,
   $color,
   semanticGroups,
+  type ContrastPair,
 } from "./colorRules";
 import { createThemesBuilder } from "./createThemes";
 import { defaultAccentTheme } from "./defaults/accent";
@@ -339,7 +340,7 @@ describe("contrast floor on built themes (DG-A11Y-01 / DG-COL-01)", () => {
   ).themes() as Record<string, Record<string, string>>;
 
   it("base text tiers clear AA on page surfaces in both schemes", () => {
-    const pairs = [];
+    const pairs: ContrastPair[] = [];
     for (const scheme of ["light", "dark"] as const) {
       for (const foreground of ["color", "color11", "color12"]) {
         for (const background of ["background", "color1", "color2"]) {

package/src/theme/createDefaultThemeConfig.ts

@@ -16,6 +16,7 @@ import { defaultFonts } from "./defaults/fonts";
 import type { Preset } from "./preset.types";
 import { type SizeRecipeInputs } from "./recipeInputs";
 import { type ThemeConfig, createThemeConfig } from "./shared";
+import { assertResolvableThemeValues } from "./themeValue";
 import { getGeneratedSizeRecipes, getSizeRecipeInputs, setSizeRecipeInputs } from "./sizeRecipes";
 
 /**
@@ -87,7 +88,12 @@ function composeGetTheme(
   if (!custom) return base;
   return (props: GetThemeProps) => {
     const merged: Record<string, string | number> = { ...base(props) };
-    for (const [key, value] of Object.entries(custom(props))) {
+    const consumer = custom(props);
+    // MPO-23 / 10 B.3 item 3. Dropping nullish is not enough: a misspelled
+    // colour is not nullish, survives the merge, and resolves to nothing at
+    // paint. Fail here, while there is a stack that names the getTheme.
+    assertResolvableThemeValues(consumer, props.name);
+    for (const [key, value] of Object.entries(consumer)) {
       if (value != null) merged[key] = value;
     }
     return merged;

package/src/theme/focusState.spec.ts

@@ -1,3 +1,5 @@
+import fs from "node:fs";
+import path from "node:path";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { __resetDevWarnSeen, warnOutlineNone, warnPositiveTabIndex } from "../devWarn";
 import { compositeFocusRingCss, keyboardFocusRingProps } from "../keyboardFocusRing";
@@ -9,10 +11,15 @@ import { defaultBuilderOptions } from "./defaults/builderOptions";
 import {
   ensureFocusVisibleRing,
   focusRingColorMeetsContrast,
+  FOCUS_RING_CLIPPED_OFFSET,
+  FOCUS_RING_HALO_OFFSET,
   FOCUS_RING_MIN_CONTRAST,
   FOCUS_RING_MIN_WIDTH,
   FOCUS_VISIBLE_RING,
+  FOCUS_VISIBLE_RING_HALO,
   FOCUS_VISIBLE_RING_INSET,
+  isSanctionedFocusRingOffset,
+  SANCTIONED_FOCUS_RING_OFFSETS,
   STATE_LAYER_HOVER,
   STATE_LAYER_PRESS,
   withDefaultStateLayer,
@@ -290,3 +297,95 @@ describe("theme DEV warn (outline-none / positive-tabindex)", () => {
     expect(spy).toHaveBeenCalledTimes(1);
   });
 });
+
+/**
+ * MPO-92 AC-3 — the offset set is CLOSED, and a tenth site cannot open it.
+ *
+ * Two layers. The unit layer pins the three sanctioned numbers and the halo's
+ * geometry. The source layer is the one that actually bites: it walks every
+ * package's `src` and fails on any `outlineOffset` literal outside the set, so
+ * a new call site that invents `outlineOffset: 3` fails here rather than
+ * shipping and being found in a later audit.
+ */
+describe("LC-71 §4: the sanctioned focus-ring offset set is closed (MPO-92)", () => {
+  it("is exactly three offsets — clipping inset, default, shape halo", () => {
+    expect([...SANCTIONED_FOCUS_RING_OFFSETS]).toEqual([-2, 0, 2]);
+    expect(FOCUS_RING_CLIPPED_OFFSET).toBe(-2);
+    expect(FOCUS_VISIBLE_RING.outlineOffset).toBe(0);
+    expect(FOCUS_RING_HALO_OFFSET).toBe(2);
+  });
+
+  it("isSanctionedFocusRingOffset accepts the three and rejects everything else", () => {
+    for (const offset of SANCTIONED_FOCUS_RING_OFFSETS) {
+      expect(isSanctionedFocusRingOffset(offset)).toBe(true);
+    }
+    for (const offset of [-4, -3, -1, 1, 3, 4, 8]) {
+      expect(isSanctionedFocusRingOffset(offset)).toBe(false);
+    }
+  });
+
+  it("FOCUS_VISIBLE_RING_HALO is the same ring, pushed wholly outside the border box", () => {
+    expect(FOCUS_VISIBLE_RING_HALO).toMatchObject({
+      outlineWidth: FOCUS_RING_MIN_WIDTH,
+      outlineStyle: "solid",
+      outlineColor: "$outlineColor",
+      outlineOffset: FOCUS_RING_HALO_OFFSET,
+    });
+    // The band spans [outlineOffset, outlineOffset + outlineWidth] from the
+    // border edge — here [2, 4]. Inner edge ≥ 0 means it paints entirely on the
+    // surface BEHIND the control, exactly like the default offset 0, so it
+    // measures against the page ground and cannot reproduce the 1.17–1.31:1
+    // inside-the-fill failure MPO-41 retired.
+    expect(FOCUS_VISIBLE_RING_HALO.outlineOffset).toBeGreaterThanOrEqual(0);
+    expect(ensureFocusVisibleRing({ outlineOffset: FOCUS_RING_HALO_OFFSET }).outlineOffset).toBe(2);
+  });
+
+  it("no source file paints an outlineOffset outside the sanctioned set", () => {
+    // Scoped to the JS/TS object form (`outlineOffset:`), numeric or "Npx"
+    // string — that is the form every focus ring in the repo goes through, via
+    // FOCUS_VISIBLE_RING* / ensureFocusVisibleRing / keyboardFocusRingProps.
+    // Raw `outline-offset:` inside CSS template strings is deliberately out of
+    // scope: it also carries non-focus decoration (the forced-colors skeleton
+    // hairline at -1px), so folding it in would assert a rule §4 does not make.
+    const packagesDir = path.resolve(__dirname, "../../..");
+    const skipDirs = new Set(["node_modules", "dist", "build", ".turbo", "types", "__snapshots__"]);
+    const files: string[] = [];
+    const walk = (dir: string) => {
+      for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isDirectory()) {
+          if (skipDirs.has(entry.name)) continue;
+          walk(path.join(dir, entry.name));
+          continue;
+        }
+        const name = entry.name;
+        if (!/\.tsx?$/.test(name)) continue;
+        if (/\.(spec|test|stories)\./.test(name)) continue;
+        if (name.endsWith(".d.ts")) continue;
+        files.push(path.join(dir, name));
+      }
+    };
+    walk(packagesDir);
+    expect(files.length).toBeGreaterThan(200);
+
+    const violations: string[] = [];
+    const literal = /outlineOffset\s*:\s*(?:"(-?\d+)px"|'(-?\d+)px'|(-?\d+))\b/;
+    for (const file of files) {
+      const lines = fs.readFileSync(file, "utf-8").split("\n");
+      lines.forEach((line, index) => {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("//") || trimmed.startsWith("*")) return;
+        const match = literal.exec(line);
+        if (!match) return;
+        const value = Number.parseInt(match[1] ?? match[2] ?? match[3], 10);
+        if (isSanctionedFocusRingOffset(value)) return;
+        violations.push(
+          `${path.relative(packagesDir, file)}:${index + 1} paints outlineOffset ${value}`,
+        );
+      });
+    }
+    expect(
+      violations,
+      `unsanctioned focus-ring offsets (LC-71 §4 closes the set at -2/0/2):\n${violations.join("\n")}`,
+    ).toEqual([]);
+  });
+});

package/src/theme/focusState.ts

@@ -59,6 +59,13 @@ export function focusRingColorMeetsContrast(ringColor: string, surfaceColor: str
  * 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.
  */
 export const FOCUS_RING_CLIPPED_OFFSET = -2;
 export const FOCUS_VISIBLE_RING = {
@@ -86,6 +93,54 @@ export const FOCUS_VISIBLE_RING_INSET = {
   outlineOffset: FOCUS_RING_CLIPPED_OFFSET,
 } satisfies ControlStateProps;
 
+/**
+ * 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.
+ */
+export const FOCUS_RING_HALO_OFFSET = 2;
+export const FOCUS_VISIBLE_RING_HALO = {
+  ...FOCUS_VISIBLE_RING,
+  outlineOffset: FOCUS_RING_HALO_OFFSET,
+} satisfies ControlStateProps;
+
+/**
+ * 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
+ * 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 const SANCTIONED_FOCUS_RING_OFFSETS = [
+  FOCUS_RING_CLIPPED_OFFSET,
+  FOCUS_VISIBLE_RING.outlineOffset,
+  FOCUS_RING_HALO_OFFSET,
+] as const;
+
+/** True when `offset` is one of the three offsets LC-71 §4 sanctions. */
+export function isSanctionedFocusRingOffset(offset: number): boolean {
+  return (SANCTIONED_FOCUS_RING_OFFSETS as readonly number[]).includes(offset);
+}
+
 /**
  * DG-STATE-01 — Material-style state layers as theme tokens.
  * Ramp lives in `defaults/builderOptions` (hover/press background steps);

package/src/theme/index.ts

@@ -28,6 +28,7 @@ export * from "./readableColor";
 export * from "./recipes";
 export * from "./resolveKnobs";
 export * from "./shared";
+export * from "./themeValue";
 export * from "./sizeRecipes";
 export * from "./Surface";
 export * from "./tileSizes";

package/src/theme/readableColor.spec.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { resolveAccentTintedSurface } from "./readableColor";
+import { resolveAaSolidFill, resolveAccentTintedSurface } from "./readableColor";
 import { contrastRatio, normalizeToHex, relativeLuminance } from "./colorRules";
 
 // The stock accent ramp (defaults/accent.ts) as the theme resolves it.
@@ -113,3 +113,56 @@ describe("resolveAccentTintedSurface", () => {
     ).toBeUndefined();
   });
 });
+
+describe("resolveAaSolidFill", () => {
+  it("keeps the preferred solid when it already clears the text floor", () => {
+    const solids = lightAccent.slice(0, 10).map((value, i) => ({
+      token: `$accent${i + 1}`,
+      value,
+    }));
+    // Stock light accentBackground is the mid solid (step 3, 6.09:1 on paper).
+    expect(
+      resolveAaSolidFill({
+        preferred: { token: "$accentBackground", value: lightAccent[2] },
+        solids,
+        paper: lightPaper,
+        ink: lightInk,
+      }),
+    ).toBe("$accentBackground");
+  });
+
+  it("walks off the dark mid-solid that tops out at 4.02:1", () => {
+    const solids = darkAccent.slice(0, 10).map((value, i) => ({
+      token: `$accent${i + 1}`,
+      value,
+    }));
+    const token = resolveAaSolidFill({
+      preferred: { token: "$accentBackground", value: darkAccent[9] },
+      solids,
+      paper: darkPaper,
+      ink: darkInk,
+    });
+    expect(token).not.toBe("$accentBackground");
+    const picked = solids.find((s) => s.token === token);
+    expect(picked?.value).toBeTruthy();
+    const fillLum = lum(picked!.value!);
+    const best = Math.max(
+      contrastRatio(fillLum, lum(darkPaper)),
+      contrastRatio(fillLum, lum(darkInk)),
+    );
+    expect(best).toBeGreaterThanOrEqual(4.5);
+    // Nearest passing solid to the 60% mid is accent9 (57%, 4.60:1).
+    expect(token).toBe("$accent9");
+  });
+
+  it("returns the preferred token when anchors cannot be parsed", () => {
+    expect(
+      resolveAaSolidFill({
+        preferred: { token: "$accentBackground", value: darkAccent[9] },
+        solids: [],
+        paper: undefined,
+        ink: darkInk,
+      }),
+    ).toBe("$accentBackground");
+  });
+});

package/src/theme/readableColor.ts

@@ -161,3 +161,108 @@ export function useAccentTintedSurface(): string | undefined {
     [paper, ink, steps.join("|")],
   );
 }
+
+/**
+ * A named solid in the accent ramp. `token` is what a caller paints
+ * (`$accentBackground`, `$accent9`); `value` is the resolved color.
+ */
+export interface AaSolidCandidate {
+  token: string;
+  value: string | undefined;
+}
+
+export interface ResolveAaSolidFillInput {
+  /** The LC-05 selected solid, usually `$accentBackground`. */
+  preferred: AaSolidCandidate;
+  /**
+   * Accent solids (steps 1–10). Pale anchors 11–12 are tinted surfaces, not
+   * selection solids — they would pass AA as chips and fail LC-05 as marks.
+   */
+  solids: AaSolidCandidate[];
+  paper?: string;
+  ink?: string;
+  /** Defaults to {@link aaTextContrastRatio} (4.5). */
+  floor?: number;
+}
+
+function bestAnchorContrast(fill: string, paperLum: number, inkLum: number): number {
+  const hex = normalizeToHex(fill);
+  if (!hex) return 0;
+  const fillLum = relativeLuminance(hex);
+  return Math.max(contrastRatio(fillLum, paperLum), contrastRatio(fillLum, inkLum));
+}
+
+/**
+ * Pick an accent solid that can carry AA text (paper or ink ≥ 4.5).
+ *
+ * `$accentBackground` in the stock dark ramp is a mid-chroma solid whose
+ * better scheme-anchor pair measures 4.02:1 — over the graphic 3:1 tier and
+ * under the in-repo text floor. Walking to the nearest passing solid keeps
+ * the mark on the accent channel (LC-05) instead of dropping to ink or a
+ * tinted surface.
+ *
+ * Returns the preferred token when it already clears the floor, otherwise
+ * the solid token whose resolved luminance is closest to the preferred fill.
+ */
+export function resolveAaSolidFill({
+  preferred,
+  solids,
+  paper,
+  ink,
+  floor = aaTextContrastRatio,
+}: ResolveAaSolidFillInput): string {
+  const paperHex = paper ? normalizeToHex(paper) : null;
+  const inkHex = ink ? normalizeToHex(ink) : null;
+  if (!paperHex || !inkHex) return preferred.token;
+  const paperLum = relativeLuminance(paperHex);
+  const inkLum = relativeLuminance(inkHex);
+
+  if (preferred.value && bestAnchorContrast(preferred.value, paperLum, inkLum) >= floor) {
+    return preferred.token;
+  }
+
+  const preferredHex = preferred.value ? normalizeToHex(preferred.value) : null;
+  const preferredLum = preferredHex ? relativeLuminance(preferredHex) : undefined;
+  let bestToken: string | undefined;
+  let bestDist = Number.POSITIVE_INFINITY;
+  for (const { token, value } of solids) {
+    if (!value || bestAnchorContrast(value, paperLum, inkLum) < floor) continue;
+    const hex = normalizeToHex(value);
+    if (!hex) continue;
+    const dist = preferredLum === undefined ? 0 : Math.abs(relativeLuminance(hex) - preferredLum);
+    if (dist < bestDist) {
+      bestDist = dist;
+      bestToken = token;
+    }
+  }
+  return bestToken ?? preferred.token;
+}
+
+/**
+ * Token to paint as a selected/current solid so on-fill text clears AA.
+ * See {@link resolveAaSolidFill}.
+ */
+export function useAaSolidFill(preferredToken: string): string {
+  const theme = useTamaguiTheme() as unknown as Record<string, { val?: unknown } | undefined>;
+  const paper = resolveTokenValue(theme, "color1");
+  const ink = resolveTokenValue(theme, "color12");
+  const preferredValue = preferredToken.startsWith("$")
+    ? resolveTokenValue(theme, preferredToken)
+    : preferredToken;
+  const solids: AaSolidCandidate[] = [];
+  for (let i = 1; i <= 10; i++) {
+    solids.push({ token: `$accent${i}`, value: resolveTokenValue(theme, `accent${i}`) });
+  }
+  const solidsKey = solids.map((s) => s.value ?? "").join("|");
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  return useMemo(
+    () =>
+      resolveAaSolidFill({
+        preferred: { token: preferredToken, value: preferredValue },
+        solids,
+        paper,
+        ink,
+      }),
+    [preferredToken, preferredValue, paper, ink, solidsKey],
+  );
+}

package/src/theme/recipeInputs.ts

@@ -459,6 +459,33 @@ export function applyRadiusStop<T extends { gap: number }>(
   return { ...recipe, gap: SIZE_RECIPE_RADIUS_STOPS[stop] };
 }
 
+/** Knob fragment token → stop name. Default medium is `$4`. */
+export const SIZE_RECIPE_RADIUS_TOKEN_TO_STOP = {
+  $0: "none",
+  $2: "small",
+  $4: "medium",
+  $6: "large",
+  $12: "full",
+} as const;
+
+/**
+ * Painted control radius + inner gap.
+ *
+ * Default `medium` follows the size table (gap == radius at that token).
+ * Any other borderRadius knob stop is an override: both values become
+ * that stop's px so gap == radius there too (MPO-46).
+ */
+export function resolveControlRadius(
+  recipe: SizeRecipe,
+  stop: SizeRecipeRadiusStop = "medium",
+): { radius: number; gap: number } {
+  if (stop === "medium") {
+    return { radius: recipe.gap, gap: recipe.gap };
+  }
+  const px = SIZE_RECIPE_RADIUS_STOPS[stop];
+  return { radius: px, gap: px };
+}
+
 function generateTouchHeights(
   heights: Record<string, number>,
   inputs: SizeRecipeInputs,

package/src/theme/sizeLadder.spec.ts

@@ -15,6 +15,7 @@ import {
   applyRadiusStop,
   generateSizeRecipes,
   recipeFamilies,
+  resolveControlRadius,
   sizeRecipeForToken,
   sizeRecipes,
   type SizeRecipeRadiusStop,
@@ -82,3 +83,22 @@ describe("MPO-46 gap == radius", () => {
     }
   });
 });
+
+describe("MPO-46 resolveControlRadius", () => {
+  it("default medium follows the size table, not the 9px knob", () => {
+    const two = resolveControlRadius(sizeRecipeForToken("$2"), "medium");
+    expect(two.radius).toBe(5);
+    expect(two.gap).toBe(5);
+    const six = resolveControlRadius(sizeRecipeForToken("$6"), "medium");
+    expect(six.radius).toBe(16);
+    expect(six.gap).toBe(16);
+  });
+
+  it("non-medium knob stops retarget both radius and gap", () => {
+    const recipe = sizeRecipeForToken("$2");
+    expect(resolveControlRadius(recipe, "none")).toEqual({ radius: 0, gap: 0 });
+    expect(resolveControlRadius(recipe, "small")).toEqual({ radius: 5, gap: 5 });
+    expect(resolveControlRadius(recipe, "large")).toEqual({ radius: 16, gap: 16 });
+    expect(resolveControlRadius(recipe, "full")).toEqual({ radius: 50, gap: 50 });
+  });
+});

package/src/theme/sizeRecipes.ts

@@ -39,7 +39,9 @@ export {
   TAMAGUI_INPUT_PADX,
   TOUCH_HEIGHT_FLOOR,
   applyRadiusStop,
+  SIZE_RECIPE_RADIUS_TOKEN_TO_STOP,
   cloneSizeRecipeInputs,
+  resolveControlRadius,
   createRecipeFamilies,
   defaultRecipeInputs,
   defaultSizeFactors,

package/src/theme/themeValue.spec.ts

@@ -0,0 +1,98 @@
+/**
+ * MPO-23 / 10 B.3 item 3: a consumer `getTheme` that returns something CSS
+ * cannot resolve must fail at BUILD, not at paint.
+ *
+ * Two halves, and both are the acceptance criterion: a deliberate violation in
+ * a fixture fails, and the mpo tree's own defaults pass. A check that only
+ * does the first is a check nobody can keep.
+ */
+import { describe, expect, it, vi } from "vitest";
+
+vi.mock("tamagui", () => ({
+  createTamagui: vi.fn((config: Record<string, unknown>) => config),
+}));
+// The reanimated driver imports react-native, which has no Node build.
+vi.mock("./animations/index", () => ({ animations: {} }));
+
+import { createDefaultThemeConfig } from "./createDefaultThemeConfig";
+import { isResolvableThemeValue } from "./themeValue";
+
+describe("isResolvableThemeValue", () => {
+  it.each([
+    ["$color5", "token reference"],
+    ["#fff", "3-digit hex"],
+    ["#ff00aa", "6-digit hex"],
+    ["#ff00aa80", "8-digit hex"],
+    ["rgba(0, 0, 0, 0.5)", "rgba()"],
+    ["hsla(210, 50%, 40%, 0.2)", "hsla()"],
+    ["oklch(0.7 0.1 200)", "oklch()"],
+    ["color-mix(in srgb, red 50%, blue)", "color-mix()"],
+    ["var(--fb-wall)", "var()"],
+    ["transparent", "keyword"],
+    ["currentColor", "keyword"],
+    ["rebeccapurple", "named colour"],
+    [0.5, "number"],
+  ])("accepts %s (%s)", (value) => {
+    expect(isResolvableThemeValue(value)).toBe(true);
+  });
+
+  it.each([
+    ["", "empty string"],
+    ["   ", "whitespace"],
+    ["undefined", "the literal string undefined"],
+    ["vaR(--x)", "a misspelled function"],
+    ["reddish", "a word that is not a colour"],
+    ["bakcground", "a typo"],
+    ["$", "a bare dollar"],
+    [{}, "an object"],
+  ])("rejects %s (%s)", (value) => {
+    expect(isResolvableThemeValue(value)).toBe(false);
+  });
+
+  it("does not accept an arbitrary bare word — the typo case is the whole point", () => {
+    // A `/^[a-z]+$/` shortcut would pass all three of these.
+    expect(isResolvableThemeValue("backgroundd")).toBe(false);
+    expect(isResolvableThemeValue("greeen")).toBe(false);
+    expect(isResolvableThemeValue("green")).toBe(true);
+  });
+});
+
+describe("composeGetTheme validates at build (10 B.3 item 3)", () => {
+  it("throws on a deliberate fixture violation, naming theme, key and value", () => {
+    expect(() =>
+      createDefaultThemeConfig({
+        builderOptions: { getTheme: () => ({ borderColor: "vaR(--x)" }) },
+      }),
+    ).toThrow(/unresolvable value for "borderColor".*vaR\(--x\)/s);
+  });
+
+  it("throws on the literal string 'undefined', which nullish-dropping lets through", () => {
+    expect(() =>
+      createDefaultThemeConfig({
+        builderOptions: { getTheme: () => ({ backgroundPress: "undefined" }) },
+      }),
+    ).toThrow(/unresolvable value for "backgroundPress"/);
+  });
+
+  it("still drops nullish rather than failing on it (DF-03 is unchanged)", () => {
+    expect(() =>
+      createDefaultThemeConfig({
+        builderOptions: {
+          getTheme: () => ({ borderColor: undefined, outlineColor: undefined }),
+        },
+      }),
+    ).not.toThrow();
+  });
+
+  it("passes on a real consumer override", () => {
+    expect(() =>
+      createDefaultThemeConfig({
+        builderOptions: { getTheme: () => ({ borderColor: "#ff00aa" }) },
+      }),
+    ).not.toThrow();
+  });
+
+  it("passes on the mpo tree's own defaults, with no consumer getTheme", () => {
+    expect(() => createDefaultThemeConfig()).not.toThrow();
+  });
+});

package/src/theme/themeValue.ts

@@ -0,0 +1,108 @@
+/**
+ * Is a theme value one a renderer can actually resolve? (MPO-23, 10 B.3 item 3.)
+ *
+ * `composeGetTheme` drops nullish consumer entries so a partial override does
+ * not erase a framework derivation (DF-03). It did nothing else, so a consumer
+ * `getTheme` that returned a MISSPELLED colour handed the string straight to
+ * paint: `borderColor: "vaR(--x)"` is not nullish, survives the merge, reaches
+ * CSS, resolves to nothing, and the element falls back to `currentColor`.
+ * That is the same near-black-border failure DF-03's comment describes, only
+ * with a slower fuse — it surfaces in someone's browser rather than in a build.
+ *
+ * So: validate at build. The predicate is deliberately PERMISSIVE. A false
+ * negative here fails an app's whole theme construction, which is far worse
+ * than the paint bug it prevents, so anything CSS could plausibly resolve
+ * passes and only the clearly-unresolvable fails.
+ */
+
+/** Tamagui resolves a `$`-prefixed value against the token table, not CSS. */
+const TOKEN_REFERENCE = /^\$[\w.-]+$/;
+
+/** #rgb, #rgba, #rrggbb, #rrggbbaa. */
+const HEX = /^#(?:[0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+
+/**
+ * Every CSS colour FUNCTION, plus `var()`. Only the head is checked: the
+ * argument grammar is CSS's job and re-implementing it here would be a second
+ * parser to keep in step with the spec.
+ */
+const COLOR_FUNCTION = /^(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color|color-mix|light-dark|var)\(/;
+
+/** CSS-wide keywords plus the two the theme layer actually writes. */
+const KEYWORDS = new Set([
+  "transparent",
+  "currentColor",
+  "currentcolor",
+  "inherit",
+  "initial",
+  "revert",
+  "revert-layer",
+  "unset",
+  "none",
+]);
+
+/**
+ * The 148 CSS named colours. Spelled out rather than matched with `/^[a-z]+$/`
+ * on purpose: a bare-word pattern accepts `reddish` and `bakcground`, which are
+ * exactly the typos this check exists to catch.
+ */
+const NAMED_COLORS = new Set(
+  (
+    "aliceblue antiquewhite aqua aquamarine azure beige bisque black blanchedalmond blue " +
+    "blueviolet brown burlywood cadetblue chartreuse chocolate coral cornflowerblue cornsilk " +
+    "crimson cyan darkblue darkcyan darkgoldenrod darkgray darkgreen darkgrey darkkhaki " +
+    "darkmagenta darkolivegreen darkorange darkorchid darkred darksalmon darkseagreen " +
+    "darkslateblue darkslategray darkslategrey darkturquoise darkviolet deeppink deepskyblue " +
+    "dimgray dimgrey dodgerblue firebrick floralwhite forestgreen fuchsia gainsboro ghostwhite " +
+    "gold goldenrod gray green greenyellow grey honeydew hotpink indianred indigo ivory khaki " +
+    "lavender lavenderblush lawngreen lemonchiffon lightblue lightcoral lightcyan " +
+    "lightgoldenrodyellow lightgray lightgreen lightgrey lightpink lightsalmon lightseagreen " +
+    "lightskyblue lightslategray lightslategrey lightsteelblue lightyellow lime limegreen linen " +
+    "magenta maroon mediumaquamarine mediumblue mediumorchid mediumpurple mediumseagreen " +
+    "mediumslateblue mediumspringgreen mediumturquoise mediumvioletred midnightblue mintcream " +
+    "mistyrose moccasin navajowhite navy oldlace olive olivedrab orange orangered orchid " +
+    "palegoldenrod palegreen paleturquoise palevioletred papayawhip peachpuff peru pink plum " +
+    "powderblue purple rebeccapurple red rosybrown royalblue saddlebrown salmon sandybrown " +
+    "seagreen seashell sienna silver skyblue slateblue slategray slategrey snow springgreen " +
+    "steelblue tan teal thistle tomato turquoise violet wheat white whitesmoke yellow yellowgreen"
+  ).split(" "),
+);
+
+/**
+ * True when a renderer can resolve `value` to a colour.
+ *
+ * Numbers pass: a theme carries numeric values (z-index, opacity-ish steps)
+ * that are not colours at all and are not this check's business.
+ */
+export function isResolvableThemeValue(value: unknown): boolean {
+  if (typeof value === "number") return Number.isFinite(value);
+  if (typeof value !== "string") return false;
+  const text = value.trim();
+  if (text === "") return false;
+  if (TOKEN_REFERENCE.test(text)) return true;
+  if (HEX.test(text)) return true;
+  if (COLOR_FUNCTION.test(text)) return true;
+  if (KEYWORDS.has(text)) return true;
+  return NAMED_COLORS.has(text.toLowerCase());
+}
+
+/**
+ * Throw on the first unresolvable entry, naming the theme, the key and the
+ * value. The message has to carry all three: a `getTheme` runs once per theme
+ * name, so "bad value" alone leaves the author grepping.
+ */
+export function assertResolvableThemeValues(
+  entries: Record<string, unknown>,
+  themeName: string,
+): void {
+  for (const [key, value] of Object.entries(entries)) {
+    if (value == null) continue;
+    if (isResolvableThemeValue(value)) continue;
+    throw new Error(
+      `getTheme returned an unresolvable value for "${key}" in theme "${themeName}": ` +
+        `${JSON.stringify(value)}. A theme value must be a $token, a hex colour, a CSS ` +
+        `colour function, a CSS-wide keyword or a named colour — anything else resolves to ` +
+        `nothing at paint and the element falls back to currentColor (10 B.3 item 3, MPO-23).`,
+    );
+  }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"createDefaultThemeConfig.d.ts","sourceRoot":"","sources":["../../src/theme/createDefaultThemeConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE/D,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAE/B,KAAK,sBAAsB,EAE5B,MAAM,gBAAgB,CAAC;AAKxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,UAAU,CAAC;AAG/D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,EAAG,IAAa,CAAC;AACzC,sDAAsD;AACtD,eAAO,MAAM,UAAU,MAAc,CAAC;AAEtC,MAAM,WAAW,+BAA+B;IAC9C,oGAAoG;IACpG,IAAI,CAAC,EAAE,0BAA0B,CAAC;IAClC,mEAAmE;IACnE,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC1D,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,qEAAqE;IACrE,UAAU,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC9C,oEAAoE;IACpE,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAC5C,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChE,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtC,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC1C;AA6BD;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,WAAW,CA8Db"}
+{"version":3,"file":"createDefaultThemeConfig.d.ts","sourceRoot":"","sources":["../../src/theme/createDefaultThemeConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE/D,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAE/B,KAAK,sBAAsB,EAE5B,MAAM,gBAAgB,CAAC;AAKxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,UAAU,CAAC;AAI/D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,EAAG,IAAa,CAAC;AACzC,sDAAsD;AACtD,eAAO,MAAM,UAAU,MAAc,CAAC;AAEtC,MAAM,WAAW,+BAA+B;IAC9C,oGAAoG;IACpG,IAAI,CAAC,EAAE,0BAA0B,CAAC;IAClC,mEAAmE;IACnE,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC1D,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,qEAAqE;IACrE,UAAU,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC9C,oEAAoE;IACpE,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAC5C,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChE,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtC,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC1C;AAkCD;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,WAAW,CA8Db"}

package/types/theme/focusState.d.ts

@@ -27,6 +27,13 @@ export declare function focusRingColorMeetsContrast(ringColor: string, surfaceCo
  * 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.
  */
 export declare const FOCUS_RING_CLIPPED_OFFSET = -2;
 export declare const FOCUS_VISIBLE_RING: {
@@ -54,6 +61,47 @@ export declare const FOCUS_VISIBLE_RING_INSET: {
     outlineStyle: "solid";
     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.
+ */
+export declare const FOCUS_RING_HALO_OFFSET = 2;
+export declare const FOCUS_VISIBLE_RING_HALO: {
+    outlineOffset: number;
+    outlineWidth: number;
+    outlineStyle: "solid";
+    outlineColor: string;
+};
+/**
+ * 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
+ * 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];
+/** True when `offset` is one of the three offsets LC-71 §4 sanctions. */
+export declare function isSanctionedFocusRingOffset(offset: number): boolean;
 /**
  * DG-STATE-01 — Material-style state layers as theme tokens.
  * Ramp lives in `defaults/builderOptions` (hover/press background steps);

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;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,kBAAkB;;;;;CAKF,CAAC;AAE9B;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB;;;;;CAGR,CAAC;AAE9B;;;;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;;;;;;;;;;;;;;;;;;;;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"}

package/types/theme/index.d.ts

@@ -28,6 +28,7 @@ export * from "./readableColor";
 export * from "./recipes";
 export * from "./resolveKnobs";
 export * from "./shared";
+export * from "./themeValue";
 export * from "./sizeRecipes";
 export * from "./Surface";
 export * from "./tileSizes";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,YAAY,EAAE,MAAM,IAAI,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjF,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAE5B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,YAAY,EAAE,MAAM,IAAI,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjF,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAE5B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

package/types/theme/readableColor.d.ts

@@ -26,4 +26,43 @@ export interface ResolveAccentTintedSurfaceInput {
 /** Pure resolver behind {@link useAccentTintedSurface} — see its docs. */
 export declare function resolveAccentTintedSurface({ steps, paper, ink, }: ResolveAccentTintedSurfaceInput): string | undefined;
 export declare function useAccentTintedSurface(): string | undefined;
+/**
+ * A named solid in the accent ramp. `token` is what a caller paints
+ * (`$accentBackground`, `$accent9`); `value` is the resolved color.
+ */
+export interface AaSolidCandidate {
+    token: string;
+    value: string | undefined;
+}
+export interface ResolveAaSolidFillInput {
+    /** The LC-05 selected solid, usually `$accentBackground`. */
+    preferred: AaSolidCandidate;
+    /**
+     * Accent solids (steps 1–10). Pale anchors 11–12 are tinted surfaces, not
+     * selection solids — they would pass AA as chips and fail LC-05 as marks.
+     */
+    solids: AaSolidCandidate[];
+    paper?: string;
+    ink?: string;
+    /** Defaults to {@link aaTextContrastRatio} (4.5). */
+    floor?: number;
+}
+/**
+ * Pick an accent solid that can carry AA text (paper or ink ≥ 4.5).
+ *
+ * `$accentBackground` in the stock dark ramp is a mid-chroma solid whose
+ * better scheme-anchor pair measures 4.02:1 — over the graphic 3:1 tier and
+ * under the in-repo text floor. Walking to the nearest passing solid keeps
+ * the mark on the accent channel (LC-05) instead of dropping to ink or a
+ * tinted surface.
+ *
+ * Returns the preferred token when it already clears the floor, otherwise
+ * the solid token whose resolved luminance is closest to the preferred fill.
+ */
+export declare function resolveAaSolidFill({ preferred, solids, paper, ink, floor, }: ResolveAaSolidFillInput): string;
+/**
+ * Token to paint as a selected/current solid so on-fill text clears AA.
+ * See {@link resolveAaSolidFill}.
+ */
+export declare function useAaSolidFill(preferredToken: string): string;
 //# sourceMappingURL=readableColor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"readableColor.d.ts","sourceRoot":"","sources":["../../src/theme/readableColor.ts"],"names":[],"mappings":"AA4CA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAU/E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CA8B3C;AA0BD,MAAM,WAAW,+BAA+B;IAC9C,mEAAmE;IACnE,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAC9B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,EACzC,KAAK,EACL,KAAK,EACL,GAAG,GACJ,EAAE,+BAA+B,GAAG,MAAM,GAAG,SAAS,CAQtD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAW3D"}
+{"version":3,"file":"readableColor.d.ts","sourceRoot":"","sources":["../../src/theme/readableColor.ts"],"names":[],"mappings":"AA4CA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAU/E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CA8B3C;AA0BD,MAAM,WAAW,+BAA+B;IAC9C,mEAAmE;IACnE,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAC9B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,EACzC,KAAK,EACL,KAAK,EACL,GAAG,GACJ,EAAE,+BAA+B,GAAG,MAAM,GAAG,SAAS,CAQtD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAW3D;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,SAAS,EAAE,gBAAgB,CAAC;IAC5B;;;OAGG;IACH,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,SAAS,EACT,MAAM,EACN,KAAK,EACL,GAAG,EACH,KAA2B,GAC5B,EAAE,uBAAuB,GAAG,MAAM,CA0BlC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAuB7D"}

package/types/theme/recipeInputs.d.ts

@@ -185,6 +185,25 @@ export declare function recipeFromTokenChannels(height: number, channels: SizeRe
 export declare function applyRadiusStop<T extends {
     gap: number;
 }>(recipe: T, stop: SizeRecipeRadiusStop): T;
+/** Knob fragment token → stop name. Default medium is `$4`. */
+export declare const SIZE_RECIPE_RADIUS_TOKEN_TO_STOP: {
+    readonly $0: "none";
+    readonly $2: "small";
+    readonly $4: "medium";
+    readonly $6: "large";
+    readonly $12: "full";
+};
+/**
+ * Painted control radius + inner gap.
+ *
+ * Default `medium` follows the size table (gap == radius at that token).
+ * Any other borderRadius knob stop is an override: both values become
+ * that stop's px so gap == radius there too (MPO-46).
+ */
+export declare function resolveControlRadius(recipe: SizeRecipe, stop?: SizeRecipeRadiusStop): {
+    radius: number;
+    gap: number;
+};
 export declare function generateSizeRecipeTables(inputs: SizeRecipeInputs, ratios?: SizeRecipeRatios, table?: SizeRecipeTokenTable | undefined): SizeRecipeTables;
 export declare function createRecipeFamilies(inputs?: SizeRecipeInputs | Partial<SizeRecipeInputs>): RecipeFamilies;
 export declare function generateSizeRecipes(partial?: Partial<SizeRecipeInputs>): GeneratedSizeRecipes;

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

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

package/types/theme/sizeRecipes.d.ts

@@ -28,7 +28,7 @@
  * desktop table — runtime fragments carry the floor; consumers spread
  * `knobProps.control` after `size`.
  */
-export { DEFAULT_SIZE_RECIPE_INPUTS, SIZE_RECIPE_RADIUS_STOPS, SIZE_RECIPE_TOKENS, SIZE_TOKEN_EXPONENTS, TAMAGUI_COMPACT_SIZE_TABLE, TAMAGUI_CONTROL_SIZE_TABLE, TAMAGUI_INPUT_PADX, TOUCH_HEIGHT_FLOOR, applyRadiusStop, cloneSizeRecipeInputs, createRecipeFamilies, defaultRecipeInputs, defaultSizeFactors, generateSizeRecipeTables, generateSizeRecipes, mergeRecipeInputs, recipeFromTokenChannels, resolveSizeRecipeInputs, } from "./recipeInputs";
+export { DEFAULT_SIZE_RECIPE_INPUTS, SIZE_RECIPE_RADIUS_STOPS, SIZE_RECIPE_TOKENS, SIZE_TOKEN_EXPONENTS, TAMAGUI_COMPACT_SIZE_TABLE, TAMAGUI_CONTROL_SIZE_TABLE, TAMAGUI_INPUT_PADX, TOUCH_HEIGHT_FLOOR, applyRadiusStop, SIZE_RECIPE_RADIUS_TOKEN_TO_STOP, cloneSizeRecipeInputs, resolveControlRadius, createRecipeFamilies, defaultRecipeInputs, defaultSizeFactors, generateSizeRecipeTables, generateSizeRecipes, mergeRecipeInputs, recipeFromTokenChannels, resolveSizeRecipeInputs, } from "./recipeInputs";
 export type { GeneratedSizeRecipes, RecipeFamilies, RecipeFamilyName, RecipeInputs, SizeRecipe, SizeRecipeBoxVariant, SizeRecipeFamily, SizeRecipeFamilyName, SizeRecipeIconVariant, SizeRecipeInputs, SizeRecipeRadiusStop, SizeRecipeRatios, SizeRecipeTables, SizeRecipeToken, SizeRecipeTokenChannels, SizeRecipeTokenTable, SizeRecipeTypeVariant, } from "./recipeInputs";
 import { type GeneratedSizeRecipes, type RecipeFamilyName, type RecipeInputs, type SizeRecipe, type SizeRecipeFamily } from "./recipeInputs";
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"sizeRecipes.d.ts","sourceRoot":"","sources":["../../src/theme/sizeRecipes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,gBAAgB,EAEtB,MAAM,gBAAgB,CAAC;AA0BxB;;;GAGG;AACH,eAAO,MAAM,cAAc,yCAAmB,CAAC;AAE/C,oFAAoF;AACpF,eAAO,MAAM,WAAW,4BAAiC,CAAC;AAC1D,eAAO,MAAM,qBAAqB,+DAAqC,CAAC;AACxE,eAAO,MAAM,sBAAsB,gEAAsC,CAAC;AAC1E,eAAO,MAAM,sBAAsB,gEAAsC,CAAC;AAC1E,eAAO,MAAM,mBAAmB,wBAAiC,CAAC;AAClE,eAAO,MAAM,yBAAyB,wBAAsC,CAAC;AAC7E,eAAO,MAAM,iBAAiB,wBAA+B,CAAC;AAC9D,eAAO,MAAM,kBAAkB,2CAAgC,CAAC;AAChE,eAAO,MAAM,0BAA0B,2CAAuC,CAAC;AAE/E,eAAO,MAAM,wBAAwB,wCAAyC,CAAC;AAE/E;;;;GAIG;AACH,eAAO,MAAM,cAAc,sCAAgB,CAAC;AAE5C,wBAAgB,iBAAiB,IAAI,OAAO,cAAc,CAEzD;AAyBD,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,oBAAoB,CAE7F;AAED,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,gBAA4B,GAAG,gBAAgB,CAExF;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,YAAY,CAAC,QAAQ,CAAyB,GACrD,UAAU,CAEZ;AAOD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,GAC3C,UAAU,CAQZ;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAAA;CAAE,GAC1E,UAAU,CAKZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,mBAAmB,GAAG,UAAU,CAAC,GACpE,MAAM,CAER"}
+{"version":3,"file":"sizeRecipes.d.ts","sourceRoot":"","sources":["../../src/theme/sizeRecipes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,gCAAgC,EAChC,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,gBAAgB,EAEtB,MAAM,gBAAgB,CAAC;AA0BxB;;;GAGG;AACH,eAAO,MAAM,cAAc,yCAAmB,CAAC;AAE/C,oFAAoF;AACpF,eAAO,MAAM,WAAW,4BAAiC,CAAC;AAC1D,eAAO,MAAM,qBAAqB,+DAAqC,CAAC;AACxE,eAAO,MAAM,sBAAsB,gEAAsC,CAAC;AAC1E,eAAO,MAAM,sBAAsB,gEAAsC,CAAC;AAC1E,eAAO,MAAM,mBAAmB,wBAAiC,CAAC;AAClE,eAAO,MAAM,yBAAyB,wBAAsC,CAAC;AAC7E,eAAO,MAAM,iBAAiB,wBAA+B,CAAC;AAC9D,eAAO,MAAM,kBAAkB,2CAAgC,CAAC;AAChE,eAAO,MAAM,0BAA0B,2CAAuC,CAAC;AAE/E,eAAO,MAAM,wBAAwB,wCAAyC,CAAC;AAE/E;;;;GAIG;AACH,eAAO,MAAM,cAAc,sCAAgB,CAAC;AAE5C,wBAAgB,iBAAiB,IAAI,OAAO,cAAc,CAEzD;AAyBD,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,oBAAoB,CAE7F;AAED,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,gBAA4B,GAAG,gBAAgB,CAExF;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,YAAY,CAAC,QAAQ,CAAyB,GACrD,UAAU,CAEZ;AAOD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,GAC3C,UAAU,CAQZ;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAAA;CAAE,GAC1E,UAAU,CAKZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,mBAAmB,GAAG,UAAU,CAAC,GACpE,MAAM,CAER"}

package/types/theme/themeValue.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Is a theme value one a renderer can actually resolve? (MPO-23, 10 B.3 item 3.)
+ *
+ * `composeGetTheme` drops nullish consumer entries so a partial override does
+ * not erase a framework derivation (DF-03). It did nothing else, so a consumer
+ * `getTheme` that returned a MISSPELLED colour handed the string straight to
+ * paint: `borderColor: "vaR(--x)"` is not nullish, survives the merge, reaches
+ * CSS, resolves to nothing, and the element falls back to `currentColor`.
+ * That is the same near-black-border failure DF-03's comment describes, only
+ * with a slower fuse — it surfaces in someone's browser rather than in a build.
+ *
+ * So: validate at build. The predicate is deliberately PERMISSIVE. A false
+ * negative here fails an app's whole theme construction, which is far worse
+ * than the paint bug it prevents, so anything CSS could plausibly resolve
+ * passes and only the clearly-unresolvable fails.
+ */
+/**
+ * True when a renderer can resolve `value` to a colour.
+ *
+ * Numbers pass: a theme carries numeric values (z-index, opacity-ish steps)
+ * that are not colours at all and are not this check's business.
+ */
+export declare function isResolvableThemeValue(value: unknown): boolean;
+/**
+ * Throw on the first unresolvable entry, naming the theme, the key and the
+ * value. The message has to carry all three: a `getTheme` runs once per theme
+ * name, so "bad value" alone leaves the author grepping.
+ */
+export declare function assertResolvableThemeValues(entries: Record<string, unknown>, themeName: string): void;
+//# sourceMappingURL=themeValue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"themeValue.d.ts","sourceRoot":"","sources":["../../src/theme/themeValue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAuDH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU9D;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,EAAE,MAAM,GAChB,IAAI,CAWN"}