@multiplatform.one/theme 7.69.2 → 7.71.0

package/src/theme/oneThemeEngine.spec.ts

@@ -0,0 +1,192 @@
+/**
+ * LC-160 ONE-THEME-ENGINE. Every MPO app builds its themes through
+ * `createDefaultThemeConfig`; it adds tokens through `builderOptions`,
+ * palettes through `additionalThemes` and looks through presets, never by
+ * handing Tamagui prebuilt themes.
+ */
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it, vi } from "vitest";
+
+vi.mock("tamagui", () => ({
+  createTamagui: vi.fn((config: Record<string, unknown>) => config),
+}));
+vi.mock("./animations/index", () => ({ animations: {} }));
+
+import {
+  assertNoPrebuiltThemes,
+  createDefaultThemeConfig,
+  type CreateDefaultThemeConfigOptions,
+} from "./createDefaultThemeConfig";
+import { createThemesBuilder } from "./createThemes";
+import { contrastRatio, normalizeToHex, relativeLuminance } from "./colorRules";
+import { resolveAllThemes } from "./dedupeInherited";
+import { defaultAccentTheme, defaultBaseTheme, defaultBuilderOptions } from "./defaults";
+import { consolePreset, defaultPreset, storefrontPreset } from "./presets";
+import { v5ScaleInputs } from "./scale/scaleInputs";
+import { v3TokenRoles } from "./v3TokenRoles";
+
+type Themes = Record<string, Record<string, unknown>>;
+
+const repoRoot = join(dirname(fileURLToPath(import.meta.url)), "../../../..");
+
+describe("LC-160 the engine refuses prebuilt themes", () => {
+  it("throws when a consumer passes tamagui.themes", () => {
+    const { light, dark } = createThemesBuilder(
+      defaultBaseTheme,
+      defaultAccentTheme,
+      defaultBuilderOptions,
+    ).themes();
+    const prebuilt = { tamagui: { themes: { light, dark } } } as CreateDefaultThemeConfigOptions;
+    expect(() => createDefaultThemeConfig(prebuilt)).toThrow(/LC-160/);
+    expect(() => assertNoPrebuiltThemes(prebuilt)).toThrow(/builderOptions/);
+  });
+
+  it("accepts every supported way to add to the matrix", () => {
+    expect(() =>
+      createDefaultThemeConfig({
+        additionalThemes: { brand: defaultAccentTheme },
+        builderOptions: { getTheme: () => ({ brandInk: "#123456" }) },
+        presets: { console: consolePreset },
+        subset: { components: ["Button"], tints: ["accent"] },
+        tamagui: { settings: {} },
+      }),
+    ).not.toThrow();
+  });
+
+  // The repo half: an app config that bypasses the builder fails here with
+  // its path, before it ships a matrix without the holds.
+  it("no MPO app or package hands Tamagui prebuilt themes", () => {
+    const skip = new Set([
+      "node_modules",
+      "dist",
+      "types",
+      "ios",
+      "android",
+      "build",
+      "target",
+      ".git",
+      ".tamagui",
+      ".turbo",
+      ".expo",
+      ".lostpixel",
+      "storybook-static",
+    ]);
+    const offenders: string[] = [];
+    const walk = (dir: string) => {
+      for (const entry of readdirSync(dir)) {
+        if (skip.has(entry)) continue;
+        const path = join(dir, entry);
+        if (statSync(path).isDirectory()) {
+          walk(path);
+          continue;
+        }
+        if (!/\.(ts|tsx|mts|js|mjs|cjs)$/.test(entry) || /\.(spec|test)\./.test(entry)) continue;
+        const source = readFileSync(path, "utf8");
+        const rel = relative(repoRoot, path);
+        if (/createDefaultThemeConfig\([\s\S]*?tamagui\s*:\s*\{[^}]*\bthemes\b/.test(source)) {
+          offenders.push(`${rel}: tamagui.themes`);
+        }
+        if (/\bcreateThemesBuilder\s*\(/.test(source) && !rel.startsWith("public/theme/")) {
+          offenders.push(`${rel}: createThemesBuilder`);
+        }
+      }
+    };
+    for (const top of ["apps", "packages", "public"]) walk(join(repoRoot, top));
+    expect(offenders).toEqual([]);
+  });
+});
+
+describe("LC-160 additive tokens ride builderOptions", () => {
+  // The SHC springboard palette's shape: keys MPO has no role for, written
+  // on the two root schemes only.
+  const springboard = { light: "#f2f0ff", dark: "#1c1830" };
+  const config = createDefaultThemeConfig({
+    builderOptions: {
+      getTheme: ({ name }) =>
+        name === "light" || name === "dark" ? { springboardTile: springboard[name] } : {},
+    },
+  });
+  const themes = config.tamagui.themes as unknown as Themes;
+
+  it("declares the key once per scheme and every theme resolves it", () => {
+    const declaring = Object.entries(themes)
+      .filter(([, theme]) => "springboardTile" in theme)
+      .map(([name]) => name);
+    expect(declaring.sort()).toEqual(["dark", "light"]);
+    for (const [name, theme] of Object.entries(resolveAllThemes(themes))) {
+      expect(theme.springboardTile, name).toBe(springboard[name.split("_")[0] as "light" | "dark"]);
+    }
+  });
+
+  it("keeps the house derivations beside it", () => {
+    const resolved = resolveAllThemes(themes);
+    expect(resolved.light?.outlineColor).toBeTruthy();
+    expect(resolved.dark_Button?.textMuted).toBeTruthy();
+  });
+});
+
+describe("LC-160 the SHC v3 tokens map to MPO roles", () => {
+  const resolved = resolveAllThemes(createDefaultThemeConfig().tamagui.themes as unknown as Themes);
+
+  it("names a role for every v3 key the console writes", () => {
+    expect(Object.keys(v3TokenRoles)).toHaveLength(35);
+  });
+
+  it("resolves every non-springboard role in every root and component theme", () => {
+    const missing: string[] = [];
+    for (const [token, role] of Object.entries(v3TokenRoles)) {
+      if (role === "springboard") continue;
+      for (const name of ["light", "dark", "light_Button", "dark_Card", "light_accent"]) {
+        if (typeof resolved[name]?.[role] !== "string") missing.push(`${token} -> ${name}.${role}`);
+      }
+    }
+    expect(missing).toEqual([]);
+  });
+});
+
+describe("LC-160 $textSubtle is an ink, as the console's v3 roles need", () => {
+  const resolved = resolveAllThemes(createDefaultThemeConfig().tamagui.themes as unknown as Themes);
+  const hex = (raw: unknown) => {
+    const value = normalizeToHex(String(raw));
+    if (!value) throw new Error(`not an opaque colour: ${String(raw)}`);
+    return value;
+  };
+  for (const scheme of ["light", "dark"] as const) {
+    for (const surface of ["color1", "color2"] as const) {
+      it(`${scheme} $textSubtle clears AA on $${surface}`, () => {
+        const theme = resolved[scheme] ?? {};
+        const ratio = contrastRatio(
+          relativeLuminance(hex(theme.textSubtle)),
+          relativeLuminance(hex(theme[surface])),
+        );
+        expect(ratio).toBeGreaterThanOrEqual(4.5);
+      });
+    }
+  }
+});
+
+describe("LC-160 console and storefront presets", () => {
+  it("console: the house knobs on v5's scale, fills on the console's violet (purple)", () => {
+    expect(consolePreset.theme).toBe("purple");
+    expect(consolePreset.knobs).toEqual(defaultPreset.knobs);
+    expect(consolePreset.tints).toEqual(defaultPreset.tints);
+    expect(consolePreset.scale).toEqual(v5ScaleInputs);
+  });
+
+  it("storefront: v5's scale, HIG blue fills, no decorative tints", () => {
+    expect(storefrontPreset.theme).toBe("blue");
+    expect(storefrontPreset.scale).toEqual(v5ScaleInputs);
+    expect(storefrontPreset.tints).toEqual([]);
+    expect(storefrontPreset.knobs).toEqual(defaultPreset.knobs);
+  });
+
+  it("paints both from a theme the default matrix builds", () => {
+    const themes = createDefaultThemeConfig().tamagui.themes as unknown as Themes;
+    for (const scheme of ["light", "dark"]) {
+      expect(themes).toHaveProperty(`${scheme}_${consolePreset.theme}`);
+      expect(themes).toHaveProperty(`${scheme}_${storefrontPreset.theme}`);
+    }
+  });
+});

package/src/theme/presets.ts

@@ -1,10 +1,16 @@
 import type { ThemeName } from "@tamagui/web";
 import { defaultIntents } from "./intents";
 import type { Preset } from "./preset.types";
-import { defaultScaleInputs } from "./scale/scaleInputs";
+import { defaultScaleInputs, v5ScaleInputs } from "./scale/scaleInputs";
 
+/**
+ * The house look. Its accent is Apple's system tint, MPO's `blue` scope, held
+ * by the engine to a white label that clears APCA Lc 60: the neutral inverse
+ * painted black fills in light and white in dark (LC-172), and every filled
+ * or selected control takes its colour from the theme's accent.
+ */
 export const defaultPreset: Preset = {
-  theme: "" as ThemeName,
+  theme: "blue" as ThemeName,
   knobs: {
     fillStyle: "filled",
     borderRadius: "medium",
@@ -100,3 +106,32 @@ export const roomyPreset: Preset = {
   ...defaultPreset,
   scale: { control: 48, type: 16 },
 };
+
+/**
+ * The SHC console's look on the house engine (LC-160, FZ-7970). The console
+ * paints MPO's house ramp and knobs (SHC-953) on Tamagui's own 44/18/9 tokens
+ * (`shc/packages/themes/buildMatrix.ts` `houseTokens`), so the preset sits on
+ * v5's 44/15 scale. Its fills take the console's one interaction accent, the
+ * springboard violet (`SPRINGBOARD_ACCENT`), as MPO's `purple` scope: a black
+ * filled control or chart series on the white ground breaks LC-172.
+ * Identifiers on a console page set `fontFamily="$mono"`, IBM Plex Mono.
+ */
+export const consolePreset: Preset = {
+  ...defaultPreset,
+  theme: "purple" as ThemeName,
+  scale: v5ScaleInputs,
+};
+
+/**
+ * The SHC storefront's look (LC-160, FZ-7970): Tamagui v5's own scale
+ * (44 px controls, 15 px body) and no decorative hue tints, so nested regions
+ * stay on the neutral ramp. The SHC storefront has no accent of its own and a
+ * grey fill breaks LC-172, so its fills take Apple's system tint, MPO's `blue`
+ * scope, held by the engine to a white label that clears APCA Lc 60.
+ */
+export const storefrontPreset: Preset = {
+  ...defaultPreset,
+  theme: "blue" as ThemeName,
+  tints: [],
+  scale: v5ScaleInputs,
+};

package/src/theme/selectedState.spec.ts

@@ -105,7 +105,7 @@ describe("LC-131 SELECTED-STATE: one selected recipe in the theme", () => {
           cells.push(`${presetName}/${name}`);
         }
       }
-      expect(cells).toHaveLength(Object.keys(presets).length * 9 + 1);
+      expect(cells).toHaveLength(Object.keys(presets).length * 10);
     });
   }
 
@@ -137,3 +137,21 @@ describe("LC-131 SELECTED-STATE: one selected recipe in the theme", () => {
     });
   }
 });
+
+describe("LC-05 ONE-EMPHASIS: the selected row separates from its page", () => {
+  for (const scheme of ["light", "dark"] as const)
+    it(`${scheme}: $color4 clears 1.15:1 on $background in the scheme and every colour theme`, () => {
+      for (const name of [scheme, ...colourThemes.map((colour) => `${scheme}_${colour}`)]) {
+        const surface = paint(scheme, name, "$color4");
+        const page = paint(scheme, name, "$background");
+        expect(ratio(surface, page), name).toBeGreaterThanOrEqual(1.15);
+        expect(ratio(surface, page), name).toBeLessThanOrEqual(1.7);
+      }
+    });
+
+  it("repaints the list row and card under the house blue page", () => {
+    const scope = paint("light", "light_blue", "$color4");
+    for (const child of ["light_blue_ListItem", "light_blue_Card"])
+      expect(paint("light", child, "$color4"), child).toBe(scope);
+  });
+});

package/src/theme/switchThumb.spec.ts

@@ -1,7 +1,14 @@
 import { configWithoutAnimations } from "@tamagui/config";
 import { createTamagui } from "tamagui";
 import { describe, expect, it } from "vitest";
-import { contrastRatio, minContrastRatio, normalizeToHex, relativeLuminance } from "./colorRules";
+import {
+  contrastRatio,
+  inSwitchOffBand,
+  isLightGround,
+  normalizeToHex,
+  plateContrastRatio,
+  relativeLuminance,
+} from "./colorRules";
 import { createThemesBuilder } from "./createThemes";
 import { defaultAccentTheme } from "./defaults/accent";
 import { defaultBaseTheme } from "./defaults/base";
@@ -41,25 +48,29 @@ describe("switch thumb", () => {
   });
 
   it.each(tintedSchemes)(
-    "%s: the off track holds 3:1 under the thumb and stays apart from the on track",
+    "%s: the off track is HIG's light system fill, holds the plate floor on dark's raised ground and stays apart from the on track",
     (name) => {
       const theme = config.themes[name] as Record<string, { val: string }>;
       const scheme = name.split("_")[0] as "light" | "dark";
       const off = theme.switchTrackOff.val;
-      // FZ-7715: a hue scope's own fill can move its off track off the root's step.
-      const step = Array.from({ length: 10 }, (_, i) => i + 3).find(
-        (n) => theme[`gray${n}`].val === off,
-      )!;
-      if (name === scheme) expect(step).toBe(scheme === "light" ? 10 : 7);
-      expect(theme.switchTrackOffHover.val).toBe(theme[`gray${step - 1}`].val);
-      expect(theme.switchTrackOffPress.val).toBe(theme[`gray${Math.min(step + 1, 12)}`].val);
-      expect(ratio(off, theme.switchThumb.val)).toBeGreaterThanOrEqual(minContrastRatio);
-      expect(ratio(off, theme.accentBackground.val)).toBeGreaterThanOrEqual(1.5);
+      expect(isLightGround(theme.background.val)).toBe(scheme === "light");
+      expect(inSwitchOffBand(off, theme.background.val)).toBe(true);
       if (scheme === "light") {
-        for (const against of [theme.background.val, theme.color3.val]) {
-          expect(ratio(off, against)).toBeGreaterThanOrEqual(minContrastRatio);
-        }
+        const step = Array.from({ length: 12 }, (_, i) => i + 1).find(
+          (n) => theme[`gray${n}`].val === off,
+        )!;
+        expect(step).toBeDefined();
+        if (name === scheme) expect(step).toBe(5);
+        expect(step).toBeLessThanOrEqual(5);
+        expect(theme.switchTrackOffHover.val).toBe(theme[`gray${Math.max(step - 1, 1)}`].val);
+        expect(theme.switchTrackOffPress.val).toBe(theme[`gray${Math.min(step + 1, 12)}`].val);
+      } else {
+        expect(ratio(off, theme.color4.val)).toBeGreaterThanOrEqual(plateContrastRatio);
+        const lum = (color: string) => relativeLuminance(normalizeToHex(color) as string);
+        expect(lum(theme.switchTrackOffHover.val)).toBeLessThan(lum(off));
+        expect(lum(theme.switchTrackOffPress.val)).toBeGreaterThan(lum(off));
       }
+      expect(ratio(off, theme.accentBackground.val)).toBeGreaterThanOrEqual(1.5);
     },
   );
 

package/src/theme/v3TokenRoles.ts

@@ -0,0 +1,51 @@
+/**
+ * The SHC console's v3 named tokens (`shc/packages/themes/
+ * consoleBuilderOptions.ts`) and the MPO role each one becomes (LC-160,
+ * FZ-7970). A role is a key every MPO theme carries. The console switch
+ * (FZ-7970 lane 9) rewrites each `$good` read as `$green9` and so on, so the
+ * value comes from whatever theme the screen sits in and the holds (accent
+ * floor, named ink, hairline) reach it.
+ *
+ * `springboard` marks the keys with no MPO role: the home-screen wall and
+ * plate colours. They stay console-only, written as additive
+ * `builderOptions.getTheme` keys on the two root schemes.
+ */
+export const v3TokenRoles = {
+  backgroundChrome: "background",
+  backgroundStrong: "color3",
+  backgroundSunk: "color3",
+  backgroundScrim: "shadow6",
+  hairline: "borderColorHairline",
+  hairlineStrong: "borderColor",
+  colorSubtle: "textMuted",
+  colorMuted: "textMuted",
+  colorInverse: "color1",
+  grabColor: "color8",
+  good: "green9",
+  goodSoft: "green3",
+  warning: "yellow9",
+  warningSoft: "yellow3",
+  critical: "red9",
+  criticalSoft: "red3",
+  info: "blue9",
+  idle: "textMuted",
+  accentSoft: "selectedBackground",
+  accentOn: "accentColor",
+  accentText: "selectedColor",
+  accentBorder: "accentBackground",
+  spark: "accentBackground",
+  wall1: "springboard",
+  wall2: "springboard",
+  wall3: "springboard",
+  wall4: "springboard",
+  plate: "springboard",
+  plateBorder: "springboard",
+  plateInk: "springboard",
+  platePaper: "springboard",
+  platePewter: "springboard",
+  plateRingHi: "springboard",
+  plateRingLo: "springboard",
+  stoppedWash: "springboard",
+} as const;
+
+export type V3Token = keyof typeof v3TokenRoles;

package/types/audit/constraintAudit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constraintAudit.d.ts","sourceRoot":"","sources":["../../src/audit/constraintAudit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,mBAAmB,CAAC,EAAE,aAAa,CAAC;IACpC,oBAAoB,CAAC,EAAE,aAAa,CAAC;IACrC,uBAAuB,CAAC,EAAE,aAAa,CAAC;IACxC,sBAAsB,CAAC,EAAE,aAAa,CAAC;IACvC,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,uCAAuC;IACvC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AA+DD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAE9C,CAAC;AAmJF;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CAkwBrE"}
+{"version":3,"file":"constraintAudit.d.ts","sourceRoot":"","sources":["../../src/audit/constraintAudit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,mBAAmB,CAAC,EAAE,aAAa,CAAC;IACpC,oBAAoB,CAAC,EAAE,aAAa,CAAC;IACrC,uBAAuB,CAAC,EAAE,aAAa,CAAC;IACxC,sBAAsB,CAAC,EAAE,aAAa,CAAC;IACvC,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,uCAAuC;IACvC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AA+DD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAE9C,CAAC;AAoJF;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CAmwBrE"}

package/types/expo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expo.d.ts","sourceRoot":"","sources":["../src/expo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;AAE5F,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,GAAG;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IACnE,kBAAkB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACvC;AAUD,wBAAgB,qBAAqB,CAAC,EACpC,MAAkB,EAClB,OAAwB,EACxB,MAIU,EACV,kBAA4B,GAC7B,GAAE,qBAA0B;;;;;;;;;;EAuB5B"}
+{"version":3,"file":"expo.d.ts","sourceRoot":"","sources":["../src/expo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAWxE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;AAE5F,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,GAAG;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IACnE,kBAAkB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACvC;AAYD,wBAAgB,qBAAqB,CAAC,EACpC,MAAkB,EAClB,OAAwB,EACxB,MAIU,EACV,kBAA4B,GAC7B,GAAE,qBAA0B;;;;;;;;;;EAuB5B"}

package/types/theme/colorRules.d.ts

@@ -20,6 +20,45 @@ export declare function normalizeToHex(raw: string): string | null;
 export declare function relativeLuminance(hex: string): number;
 /** WCAG contrast ratio (always >= 1). */
 export declare function contrastRatio(l1: number, l2: number): number;
+/**
+ * APCA lightness contrast (SAPC 0.0.98G-4g) of `text` on `background`, as
+ * signed Lc: positive for dark text on a light fill, negative for light on
+ * dark. Callers compare the magnitude.
+ */
+export declare function apcaContrast(text: string, background: string): number;
+/** APCA |Lc| a label on a filled control must reach (LC-172). */
+export declare const fillLabelLc = 60;
+/**
+ * LC-172 / Apple HIG: the off Switch track is a system fill, rgb(120,120,128)
+ * laid over the ground at 0.16 alpha on a light ground and 0.32 on a dark one
+ * (what UISwitch paints). A ramp step may land anywhere from tertiary to
+ * systemFill on either side of that, the band below.
+ */
+export declare const switchOffFillAlpha: {
+    readonly light: 0.16;
+    readonly dark: 0.32;
+};
+export declare const switchOffFillBand: {
+    readonly light: readonly [0.08, 0.24];
+    readonly dark: readonly [0.18, 0.4];
+};
+/** A ground is light when its relative luminance is past the midpoint. */
+export declare function isLightGround(ground: string): boolean;
+/** HIG's system fill at `alpha` composited over `ground`, as an opaque hex colour. */
+export declare function systemFillHex(ground: string, alpha: number): string | null;
+/** HIG's system fill at `alpha` composited over `ground`, as relative luminance. */
+export declare function systemFillLuminance(ground: string, alpha: number): number | null;
+/**
+ * FZ-7944: a control's plate stays this far off the raised ground an overlay
+ * paints ($color4 in dark), so it never dissolves into a sheet or card.
+ */
+export declare const plateContrastRatio = 1.1;
+/**
+ * Whether `track` sits in the HIG system-fill band over `ground`: never
+ * darker than systemFill on a light ground (a dark off track reads as on),
+ * and on a dark ground lifted off it without passing systemFill.
+ */
+export declare function inSwitchOffBand(track: string, ground: string): boolean;
 export declare const minContrastRatio = 3;
 /** WCAG AA contrast floor for normal-size body/label text. */
 export declare const aaTextContrastRatio = 4.5;

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

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

package/types/theme/createDefaultThemeConfig.d.ts

@@ -37,8 +37,12 @@ export interface CreateDefaultThemeConfigOptions {
     builderOptions?: CreateThemesBuilderOptions;
     /** Override tamagui settings */
     settings?: Partial<NonNullable<CreateTamaguiProps["settings"]>>;
-    /** Override any top-level tamagui config property */
-    tamagui?: Partial<CreateTamaguiProps>;
+    /**
+     * Override any top-level tamagui config property except `themes` (LC-160:
+     * an app adds tokens through `builderOptions`, `additionalThemes` and
+     * presets, never prebuilt themes).
+     */
+    tamagui?: Partial<Omit<CreateTamaguiProps, "themes">>;
     /** Named theme presets for the preset system */
     presets?: Record<string, Preset>;
     /** Default preset name to use when no `mp.preset` cookie is set */
@@ -59,6 +63,13 @@ export interface CreateDefaultThemeConfigOptions {
      */
     subset?: ThemeSubset;
 }
+/**
+ * LC-160 ONE-THEME-ENGINE. Every theme an app paints comes out of this
+ * builder, so the holds (accent floor, selected state, named ink, hairline)
+ * reach it. A prebuilt `tamagui.themes` skips all of them, which is how the
+ * SHC console drifted onto its own matrix.
+ */
+export declare function assertNoPrebuiltThemes(options: CreateDefaultThemeConfigOptions): void;
 /**
  * Builds Tamagui's v5 grey ramp, inverted-base accent and colour themes,
  * with the house accessibility floors. Fonts include Inter heading/body

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;AAMxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,UAAU,CAAC;AAG/D,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,gBAAgB,CAAC;AAEhE;;;;;;;;;;;;;;GAcG;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,qFAAqF;IACrF,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;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzC;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAiCD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,WAAW,CAkEb"}
+{"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;AAMxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,UAAU,CAAC;AAG/D,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,gBAAgB,CAAC;AAGhE;;;;;;;;;;;;;;GAcG;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,qFAAqF;IACrF,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAC5C,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChE;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtD,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzC;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAiCD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,+BAA+B,GAAG,IAAI,CASrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,WAAW,CAoEb"}

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

@@ -1 +1 @@
-{"version":3,"file":"createThemes.d.ts","sourceRoot":"","sources":["../../src/theme/createThemes.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,YAAY,IAAI,mBAAmB,EACpC,MAAM,wBAAwB,CAAC;AAiEhC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAG1B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAevB,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;;;;;CAI3B,CAAC;AAEX,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB,CACrC,WAAW,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,EACvC,YAAY,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE;IAExC,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B,CACzC,WAAW,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,EACvC,YAAY,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,EACxC,WAAW,SAAS,OAAO,GAAG,OAAO,EACrC,YAAY,SAAS,OAAO,GAAG,OAAO,CACtC,SAAQ,sBAAsB,CAAC,WAAW,EAAE,YAAY,CAAC;IACzD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,eAAe,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC/E,mBAAmB,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACvF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACzF;AA8BD,eAAO,MAAM,YAAY,aA6BvB,CAAC;AAykBH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,0BAA0B,EACrC,WAAW,EAAE,sBAAsB,EACnC,OAAO,CAAC,EAAE,0BAA0B;;aAmFzB,CAAC,SAAS,MAAM,QAAQ,CAAC,SAAS,sBAAsB,GAuB1D,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE;;+BAAkC;EAG7E"}
+{"version":3,"file":"createThemes.d.ts","sourceRoot":"","sources":["../../src/theme/createThemes.ts"],"names":[],"mappings":"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"}

package/types/theme/dedupeInherited.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Drop theme values that another rule already puts on the element (LC-160).
+ *
+ * Ported from SHC (`shc/packages/themes/dedupeInherited.ts`), which measured
+ * every theme rule restating keys its parent chain carries. MPO's builder
+ * restates fewer of them, and SHC's rule is not safe on web as written, so
+ * this keeps the subset that cannot change a resolved value.
+ *
+ * JS and native are never at risk: `createTamagui` runs
+ * `proxyThemesToParents`, which `Object.assign`s every ancestor onto each
+ * theme before anything reads it. CSS is the consumer that needs care. A
+ * themed element carries its theme's whole hierarchy as classes
+ * (`light_blue_Button` puts `t_blue t_blue_Button` on the Button), so a key
+ * dropped from `light_blue_Button` and kept by `light_blue` is still declared
+ * on that same element. A key every non-root rule drops is different: it
+ * reaches the element by inheritance from the nearest ANCESTOR element that
+ * declares it, and that ancestor need not be in the theme's name chain. A
+ * Button inside a Card resolves `light_Button`, but its nearest ancestor is
+ * the Card's `light_Card`; nested schemes add `dark_*` rules that match the
+ * element through `.t_dark .t_X` selectors. SHC's parent-chain rule drops
+ * those keys anyway, which repaints a Button's root-valued key with its
+ * Card's.
+ *
+ * So a key is dropped from a non-root theme only when:
+ *
+ * - the nearest non-root theme in its own chain keeps the key with the same
+ *   value (declared on the same element), or
+ * - no non-root theme in either scheme gives the key a value other than its
+ *   scheme root's, so whatever ancestor the element inherits from, it reads
+ *   the root value, and no other rule declares it.
+ *
+ * Resolution reads the input and the already-pruned shallower themes, so the
+ * result does not depend on the record's iteration order.
+ */
+type ThemeValues = Record<string, unknown>;
+/**
+ * Ancestor names of `dark_blue_alt1_Button`, nearest last:
+ * `["dark", "dark_blue", "dark_blue_alt1"]`. The same walk as Tamagui's
+ * `proxyThemeToParents`; the two must agree or a dropped key would not come
+ * back on the JS side.
+ */
+export declare function parentThemeNames(name: string): string[];
+/** Each non-root theme without the values another rule already puts on its element. */
+export declare function dedupeInheritedThemeValues<T extends ThemeValues>(themes: Record<string, T>): Record<string, T>;
+/**
+ * One theme as Tamagui resolves it: every ancestor, then the theme itself.
+ * Use it to read a key off a deduped record; `getConfig().themes` and
+ * `themeConfig.tamagui.themes` come out of `createTamagui` already resolved.
+ */
+export declare function resolveThemeThroughParents<T extends ThemeValues>(themes: Record<string, T>, name: string): T;
+/** Every theme of a deduped record resolved through its parents. */
+export declare function resolveAllThemes<T extends ThemeValues>(themes: Record<string, T>): Record<string, T>;
+export {};
+//# sourceMappingURL=dedupeInherited.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dedupeInherited.d.ts","sourceRoot":"","sources":["../../src/theme/dedupeInherited.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKvD;AAeD,uFAAuF;AACvF,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,WAAW,EAC9D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GACxB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CA0BnB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,WAAW,EAC9D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EACzB,IAAI,EAAE,MAAM,GACX,CAAC,CAKH;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,EACpD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GACxB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAInB"}

package/types/theme/fillContrast.d.ts

@@ -0,0 +1,41 @@
+import { apcaContrast } from "./colorRules";
+export { apcaContrast };
+/**
+ * LC-172 FILL-CONTRAST. A preset's fills carry a hue: the filled accent
+ * control, the active toggle track and the first chart series are never grey
+ * or black on the grey and white grounds, and the label on the filled
+ * control passes APCA Lc 60. The off toggle track is HIG's light system fill,
+ * never a grey darker than systemFill on a light ground (`inSwitchOffBand`),
+ * and the on and off tracks sit at least `toggleStateFloor` apart in OKLab.
+ */
+/** sRGB chroma (max channel minus min channel, 0..1) under which a fill reads as grey or black. */
+export declare const fillChromaFloor = 0.1;
+/** APCA |Lc| the label on a filled control must reach. */
+export declare const fillLabelLcFloor = 60;
+/**
+ * OKLab distance the on and off toggle tracks must keep, so a Switch's state
+ * reads from its track and not only from the thumb's side. UIKit's least
+ * distinct pair, systemYellow on the light off fill, measures 0.19; the
+ * FZ-8117 default dark pair (an rgb 115 grey on an rgb 121 grey) measured 0.02.
+ */
+export declare const toggleStateFloor = 0.15;
+/** Björn Ottosson's OKLab of an opaque colour, or null when it does not parse. */
+export declare function oklab(color: string): [number, number, number] | null;
+/** Euclidean OKLab distance between two colours, 0 when either does not parse. */
+export declare function oklabDistance(a: string, b: string): number;
+/** sRGB chroma of an opaque colour, 0 for any grey. */
+export declare function srgbChroma(color: string): number;
+export interface FillContrastFinding {
+    preset: string;
+    scheme: "light" | "dark";
+    part: "accent fill" | "toggle" | "toggle off" | "toggle state" | "chart series" | "fill label";
+    detail: string;
+}
+type ResolvedThemes = Record<string, Record<string, unknown> | undefined>;
+/**
+ * Every LC-172 breach of one preset colour theme in `resolved` (themes run
+ * through `resolveAllThemes`). `theme` is the preset's colour theme, `""`
+ * for the house accent.
+ */
+export declare function auditPresetFills(preset: string, theme: string, resolved: ResolvedThemes): FillContrastFinding[];
+//# sourceMappingURL=fillContrast.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fillContrast.d.ts","sourceRoot":"","sources":["../../src/theme/fillContrast.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAgD,MAAM,cAAc,CAAC;AAG1F,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;;;;;;GAOG;AAEH,mGAAmG;AACnG,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,KAAc,CAAC;AAU5C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAKrC,kFAAkF;AAClF,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAYpE;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,YAAY,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,CAAC;IAC/F,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;AAI1E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,GACvB,mBAAmB,EAAE,CAuEvB"}

package/types/theme/index.d.ts

@@ -6,6 +6,7 @@ export * from "./cookies";
 export * from "./cornerSmoothing";
 export * from "./createDefaultThemeConfig";
 export * from "./createThemes";
+export * from "./dedupeInherited";
 export * from "./defaults/index";
 export * from "./devtools/ThemeDevtoolsPanel";
 export * from "./dynamicType";
@@ -49,6 +50,7 @@ export * from "./tileSizes";
 export * from "./transitionProps";
 export * from "./theme";
 export * from "./Tint";
+export * from "./v3TokenRoles";
 export * from "./useResolvedKnobs";
 export * from "./useTheme";
 export * from "./usePresetSwitch";