@astryxdesign/core 0.7.4 → 0.7.5-canary.0418c47

package/dist/theme/index.d.ts

@@ -10,35 +10,35 @@
  *   import { neutralTheme } from '@astryxdesign/theme-neutral';
  *   import { neutralTheme } from '@astryxdesign/theme-neutral';
  */
-export { Theme } from './Theme';
-export { MediaTheme } from './MediaTheme';
-export type { MediaThemeProps, MediaThemeMode } from './MediaTheme';
-export { defineTheme, generateThemeCSS, generateOnMediaCSS, generateAdaptationCSS, generateThemeRules, generateThemeRulesSplit, type ThemeCSSOutput, type ThemeRulesSplit, isDefinedTheme, tokenDefaults, } from './defineTheme';
-export { registerTheme, getRegisteredTheme, getRegisteredThemes, resetThemes, } from './themeRegistry';
-export type { DefineThemeInput, DefinedTheme, ResolvedDefinedTheme, CoreTokenName, TokenName, TokenValue, ComponentStyleMap, StyleOverrides, } from './defineTheme';
-export { DEFAULT_WIDTH_BREAKPOINTS, WIDTH_BREAKPOINT_NAMES, } from './themeAdaptations';
-export type { WidthBreakpointName, WidthBreakpoints, ThemeAdaptations, ThemeAdaptationCondition, ThemeAdaptationWidthCondition, ThemeAdaptationRule, ThemeAdaptationValue, ThemeAdaptationTypographyConfig, } from './themeAdaptations';
-export type { SyntaxTokenName, DomainTokenName, DataTokenName, } from './domainTokens';
-export { syntaxTokenDefaults, domainTokenDefaults, dataTokenDefaults, } from './domainTokens';
-export { defineSyntaxTheme } from './syntax';
-export type { SyntaxThemeDefinition, SyntaxThemeInput, SyntaxThemeTokenKey, SyntaxThemeTokenMap, SyntaxThemeTokenInput, SyntaxTokenValue, } from './syntax';
-export { SyntaxTheme, useSyntaxTheme } from './syntax';
-export type { UseSyntaxThemeReturn } from './syntax';
-export { expandTypeScale, generateTypeScaleComponents } from './expandTypeScale';
-export type { TypeScaleConfig, TypeScaleTokens } from './expandTypeScale';
-export { expandRadiusScale } from './expandRadiusScale';
-export type { RadiusScaleConfig, RadiusScaleTokens } from './expandRadiusScale';
-export { expandColorScale } from './expandColorScale';
-export type { ColorScaleConfig, ColorScaleTokens } from './expandColorScale';
-export { expandMotionScale } from './expandMotionScale';
-export type { MotionScaleConfig, MotionScaleTokens } from './expandMotionScale';
-export { colorDefaults, spacingDefaults, sizeDefaults, borderDefaults, focusDefaults, radiusDefaults, shadowDefaults, durationDefaults, easeDefaults, typographyDefaults, textSizeDefaults, fontWeightDefaults, typeScaleDefaults, colorVars, spacingVars, sizeVars, borderVars, focusVars, radiusVars, shadowVars, durationVars, easeVars, typographyVars, textSizeVars, fontWeightVars, typeScaleVars, } from './tokens.stylex';
-export type { ColorVarName, SpacingVarName, SizeVarName, BorderVarName, RadiusVarName, ShadowVarName, DurationVarName, EaseVarName, TypographyVarName, TextSizeVarName, FontWeightVarName, TypeScaleVarName, } from './tokens.stylex';
-export { useTheme, useThemeName, ThemeContext } from './useTheme';
-export type { UseThemeReturn, ThemeContextValue } from './useTheme';
-export type { IndicatorComponent, IndicatorFamily, IndicatorFamilyMap, IndicatorMap, IndicatorName, IndicatorNameOfFamily, IndicatorProps, IndicatorRegistry, IndicatorSize, IndicatorState, } from '../Indicator';
-export { resolveThemeToken, resolveThemeTokens, tokenVar, tokenVars, } from './tokens';
-export type { ResolveThemeTokenOptions, ResolveThemeTokensOptions, ResolvedThemeMode, } from './tokens';
-export type { TextColorMap } from '../Text';
-export type { ThemeMode, HeadingTag, TextType, BuiltinTextType, CustomTextTypes, TextSize, TextWeight, TextColor, BuiltinTextColor, TypographyConfig, TypographyRole, FontWeight, } from './types';
+export { Theme } from './Theme.js';
+export { MediaTheme } from './MediaTheme.js';
+export type { MediaThemeProps, MediaThemeMode } from './MediaTheme.js';
+export { defineTheme, generateThemeCSS, generateOnMediaCSS, generateAdaptationCSS, generateThemeRules, generateThemeRulesSplit, type ThemeCSSOutput, type ThemeRulesSplit, isDefinedTheme, tokenDefaults, } from './defineTheme.js';
+export { registerTheme, getRegisteredTheme, getRegisteredThemes, resetThemes, } from './themeRegistry.js';
+export type { DefineThemeInput, DefinedTheme, ResolvedDefinedTheme, CoreTokenName, TokenName, TokenValue, ComponentStyleMap, StyleOverrides, } from './defineTheme.js';
+export { DEFAULT_COMPACT_DEFINITION, DEFAULT_WIDTH_BREAKPOINTS, WIDTH_BREAKPOINT_NAMES, compactDefinition, } from './themeAdaptations.js';
+export type { CompactDefinition, WidthBreakpointName, WidthBreakpoints, ThemeAdaptations, ThemeAdaptationCondition, ThemeAdaptationWidthCondition, ThemeAdaptationRule, ThemeAdaptationValue, ThemeAdaptationTypographyConfig, } from './themeAdaptations.js';
+export type { SyntaxTokenName, DomainTokenName, DataTokenName, } from './domainTokens/index.js';
+export { syntaxTokenDefaults, domainTokenDefaults, dataTokenDefaults, } from './domainTokens/index.js';
+export { defineSyntaxTheme } from './syntax/index.js';
+export type { SyntaxThemeDefinition, SyntaxThemeInput, SyntaxThemeTokenKey, SyntaxThemeTokenMap, SyntaxThemeTokenInput, SyntaxTokenValue, } from './syntax/index.js';
+export { SyntaxTheme, useSyntaxTheme } from './syntax/index.js';
+export type { UseSyntaxThemeReturn } from './syntax/index.js';
+export { expandTypeScale, generateTypeScaleComponents } from './expandTypeScale.js';
+export type { TypeScaleConfig, TypeScaleTokens } from './expandTypeScale.js';
+export { expandRadiusScale } from './expandRadiusScale.js';
+export type { RadiusScaleConfig, RadiusScaleTokens } from './expandRadiusScale.js';
+export { expandColorScale } from './expandColorScale.js';
+export type { ColorScaleConfig, ColorScaleTokens } from './expandColorScale.js';
+export { expandMotionScale } from './expandMotionScale.js';
+export type { MotionScaleConfig, MotionScaleTokens } from './expandMotionScale.js';
+export { colorDefaults, spacingDefaults, sizeDefaults, borderDefaults, focusDefaults, radiusDefaults, shadowDefaults, durationDefaults, easeDefaults, typographyDefaults, textSizeDefaults, fontWeightDefaults, typeScaleDefaults, colorVars, spacingVars, sizeVars, borderVars, focusVars, radiusVars, shadowVars, durationVars, easeVars, typographyVars, textSizeVars, fontWeightVars, typeScaleVars, } from './tokens.stylex.js';
+export type { ColorVarName, SpacingVarName, SizeVarName, BorderVarName, RadiusVarName, ShadowVarName, DurationVarName, EaseVarName, TypographyVarName, TextSizeVarName, FontWeightVarName, TypeScaleVarName, } from './tokens.stylex.js';
+export { useTheme, useThemeName, ThemeContext } from './useTheme.js';
+export type { UseThemeReturn, ThemeContextValue } from './useTheme.js';
+export type { IndicatorComponent, IndicatorFamily, IndicatorFamilyMap, IndicatorMap, IndicatorName, IndicatorNameOfFamily, IndicatorProps, IndicatorRegistry, IndicatorSize, IndicatorState, } from '../Indicator/index.js';
+export { resolveThemeToken, resolveThemeTokens, tokenVar, tokenVars, } from './tokens.js';
+export type { ResolveThemeTokenOptions, ResolveThemeTokensOptions, ResolvedThemeMode, } from './tokens.js';
+export type { TextColorMap } from '../Text/index.js';
+export type { ThemeMode, HeadingTag, TextType, BuiltinTextType, CustomTextTypes, TextSize, TextWeight, TextColor, BuiltinTextColor, TypographyConfig, TypographyRole, FontWeight, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/theme/index.js

@@ -19,7 +19,7 @@ export { MediaTheme } from "./MediaTheme.js";
 export { defineTheme, generateThemeCSS, generateOnMediaCSS, generateAdaptationCSS, generateThemeRules, generateThemeRulesSplit, isDefinedTheme, tokenDefaults } from "./defineTheme.js";
 export { registerTheme, getRegisteredTheme, getRegisteredThemes, resetThemes } from "./themeRegistry.js";
 // Ordered environment-conditioned theme adaptations
-export { DEFAULT_WIDTH_BREAKPOINTS, WIDTH_BREAKPOINT_NAMES } from "./themeAdaptations.js";
+export { DEFAULT_COMPACT_DEFINITION, DEFAULT_WIDTH_BREAKPOINTS, WIDTH_BREAKPOINT_NAMES, compactDefinition } from "./themeAdaptations.js";
 export { syntaxTokenDefaults, domainTokenDefaults, dataTokenDefaults } from "./domainTokens/index.js";
 
 // Syntax theme API

package/dist/theme/localTokens.d.ts

@@ -5,7 +5,7 @@
  * @position Theme-local ownership boundary; final adaptation-cycle validation is
  *   performed after the reachable ordered cascade is assembled.
  */
-import type { DefinedTheme, TokenValue } from './defineTheme';
+import type { DefinedTheme, TokenValue } from './defineTheme.js';
 export interface ResolvedLocalTokenContract {
     localTokens: Record<string, string>;
     owners: Record<string, string>;

package/dist/theme/mergeComponents.d.ts

@@ -10,7 +10,7 @@
  * @output a merged ComponentStyleMap
  * @position packages/core/src/theme/mergeComponents.ts
  */
-import type { ComponentStyleMap } from './defineTheme';
+import type { ComponentStyleMap } from './defineTheme.js';
 /**
  * Deep-merge component style maps: `overrides` wins per style key, and every
  * component and key the base declared that the overrides do not mention is

package/dist/theme/onMediaTokens.d.ts

@@ -17,7 +17,7 @@
  * Themes can provide additional token and component overrides via the
  * `onDark`/`onLight` fields in `defineTheme()`.
  */
-import type { TokenValue, ComponentStyleMap } from './defineTheme';
+import type { TokenValue, ComponentStyleMap } from './defineTheme.js';
 /**
  * On-media theme overrides — same shape as the main theme but scoped
  * to a surface luminance context.

package/dist/theme/resolveThemeValues.d.ts

@@ -20,13 +20,13 @@
  * - /packages/core/src/theme/defineTheme.ts (its only other caller)
  * - /packages/core/src/theme/themeAdaptations.ts
  */
-import type { ComponentStyleMap, TokenName, TokenValue } from './defineTheme';
-import type { TypographyConfig, FontWeight } from './types';
-import type { SyntaxThemeDefinition } from './syntax';
-import { type TypeScaleConfig } from './expandTypeScale';
-import { type MotionScaleConfig } from './expandMotionScale';
-import { type RadiusScaleConfig } from './expandRadiusScale';
-import { type ColorScaleConfig } from './expandColorScale';
+import type { ComponentStyleMap, TokenName, TokenValue } from './defineTheme.js';
+import type { TypographyConfig, FontWeight } from './types.js';
+import type { SyntaxThemeDefinition } from './syntax/index.js';
+import { type TypeScaleConfig } from './expandTypeScale.js';
+import { type MotionScaleConfig } from './expandMotionScale.js';
+import { type RadiusScaleConfig } from './expandRadiusScale.js';
+import { type ColorScaleConfig } from './expandColorScale.js';
 /**
  * The value-bearing axes of a theme — everything that resolves to tokens or
  * component styles. Deliberately excludes identity (`name`), inheritance

package/dist/theme/statusColor.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file statusColor.ts
+ * @input Concrete sRGB colours (hex or rgb()) from resolved theme tokens
+ * @output Contrast, OKLCH, chroma, and lightness-solving helpers for status roles
+ * @position Pure colour maths shared by status-role derivation
+ *   (architecture:theme-compilation INV17) and the status contrast checks.
+ *
+ * Contrast follows WCAG 2.x relative luminance. Lightness adjustments move a
+ * colour along OKLCH lightness at its own hue, reducing chroma only as far as
+ * needed to stay inside sRGB, so a derived role keeps its status hue.
+ */
+import { type RGBA } from '../utils/color.js';
+export interface OKLCH {
+    l: number;
+    c: number;
+    h: number;
+}
+/** Composite a possibly translucent colour over an opaque backdrop. */
+export declare function composite(top: RGBA, under: RGBA): RGBA;
+/** WCAG relative luminance of an opaque colour. */
+export declare function relativeLuminance({ r, g, b }: RGBA): number;
+/** WCAG contrast ratio. A translucent foreground is composited over the background first. */
+export declare function contrastRatio(foreground: RGBA, background: RGBA): number;
+/** Convert opaque sRGB to OKLCH. */
+export declare function toOklch({ r, g, b }: RGBA): OKLCH;
+/** Convert OKLCH to sRGB, reducing chroma at the same lightness and hue until it fits. */
+export declare function fromOklch(color: OKLCH): RGBA;
+/** Lowest chroma and lightness band a status colour may occupy and still read as a hue. */
+export declare const STATUS_CHROMA_FLOOR = 0.03;
+export declare const STATUS_LIGHTNESS_RANGE: readonly [number, number];
+/**
+ * Whether a colour reads as a hue rather than a neutral grey, near-black, or
+ * near-white (architecture:theme-tokens INV11). Translucent colours are judged
+ * on their own channels.
+ */
+export declare function isChromatic(color: RGBA): boolean;
+/**
+ * Move `color` along OKLCH lightness, at its own hue, until it reaches
+ * `ratio` against every backdrop. Moves away from the backdrops' luminance;
+ * returns the colour unchanged when it already passes, or null when no
+ * lightness at that hue reaches the ratio.
+ */
+export declare function solveLightness(color: RGBA, backdrops: ReadonlyArray<RGBA>, ratio: number): RGBA | null;
+/** Parse a concrete colour, returning null for anything unresolved. */
+export declare function parseConcreteColor(value: string | undefined): RGBA | null;
+/** `#RRGGBB` or `#RRGGBBAA` for a colour. */
+export declare function toHex(color: RGBA): string;
+//# sourceMappingURL=statusColor.d.ts.map

package/dist/theme/statusColor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusColor.d.ts","sourceRoot":"","sources":["../../src/theme/statusColor.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,OAAO,EAAwB,KAAK,IAAI,EAAC,MAAM,gBAAgB,CAAC;AAEhE,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAYD,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAQtD;AAED,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,EAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAC,EAAE,IAAI,GAAG,MAAM,CAEzD;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,GAAG,MAAM,CASxE;AAED,oCAAoC;AACpC,wBAAgB,OAAO,CAAC,EAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAC,EAAE,IAAI,GAAG,KAAK,CAiB9C;AAeD,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAc5C;AAED,2FAA2F;AAC3F,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,sBAAsB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAe,CAAC;AAE7E;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAOhD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,IAAI,EACX,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,EAC9B,KAAK,EAAE,MAAM,GACZ,IAAI,GAAG,IAAI,CAgCb;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAEzE;AAED,6CAA6C;AAC7C,wBAAgB,KAAK,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAUzC"}

package/dist/theme/statusColor.js

@@ -0,0 +1,203 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file statusColor.ts
+ * @input Concrete sRGB colours (hex or rgb()) from resolved theme tokens
+ * @output Contrast, OKLCH, chroma, and lightness-solving helpers for status roles
+ * @position Pure colour maths shared by status-role derivation
+ *   (architecture:theme-compilation INV17) and the status contrast checks.
+ *
+ * Contrast follows WCAG 2.x relative luminance. Lightness adjustments move a
+ * colour along OKLCH lightness at its own hue, reducing chroma only as far as
+ * needed to stay inside sRGB, so a derived role keeps its status hue.
+ */
+
+import { formatHex, parseColor } from "../utils/color.js";
+const toLinear = v => {
+  const c = v / 255;
+  return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+};
+const fromLinear = v => {
+  const c = v <= 0.0031308 ? 12.92 * v : 1.055 * v ** (1 / 2.4) - 0.055;
+  return c * 255;
+};
+
+/** Composite a possibly translucent colour over an opaque backdrop. */
+export function composite(top, under) {
+  const a = top.a;
+  return {
+    r: top.r * a + under.r * (1 - a),
+    g: top.g * a + under.g * (1 - a),
+    b: top.b * a + under.b * (1 - a),
+    a: 1
+  };
+}
+
+/** WCAG relative luminance of an opaque colour. */
+export function relativeLuminance({
+  r,
+  g,
+  b
+}) {
+  return 0.2126 * toLinear(r) + 0.7152 * toLinear(g) + 0.0722 * toLinear(b);
+}
+
+/** WCAG contrast ratio. A translucent foreground is composited over the background first. */
+export function contrastRatio(foreground, background) {
+  const bg = background.a < 1 ? composite(background, {
+    r: 255,
+    g: 255,
+    b: 255,
+    a: 1
+  }) : background;
+  const fg = foreground.a < 1 ? composite(foreground, bg) : foreground;
+  const a = relativeLuminance(fg);
+  const b = relativeLuminance(bg);
+  return (Math.max(a, b) + 0.05) / (Math.min(a, b) + 0.05);
+}
+
+/** Convert opaque sRGB to OKLCH. */
+export function toOklch({
+  r,
+  g,
+  b
+}) {
+  const lr = toLinear(r);
+  const lg = toLinear(g);
+  const lb = toLinear(b);
+  const l = Math.cbrt(0.4122214708 * lr + 0.5363325363 * lg + 0.0514459929 * lb);
+  const m = Math.cbrt(0.2119034982 * lr + 0.6806995451 * lg + 0.1073969566 * lb);
+  const s = Math.cbrt(0.0883024619 * lr + 0.2817188376 * lg + 0.6299787005 * lb);
+  const L = 0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s;
+  const A = 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s;
+  const B = 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s;
+  return {
+    l: L,
+    c: Math.hypot(A, B),
+    h: Math.atan2(B, A)
+  };
+}
+function oklchToLinear({
+  l: L,
+  c,
+  h
+}) {
+  const A = c * Math.cos(h);
+  const B = c * Math.sin(h);
+  const l = (L + 0.3963377774 * A + 0.2158037573 * B) ** 3;
+  const m = (L - 0.1055613458 * A - 0.0638541728 * B) ** 3;
+  const s = (L - 0.0894841775 * A - 1.291485548 * B) ** 3;
+  return [4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s, -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s, -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s];
+}
+
+/** Convert OKLCH to sRGB, reducing chroma at the same lightness and hue until it fits. */
+export function fromOklch(color) {
+  let c = color.c;
+  for (let i = 0; i < 40; i++) {
+    const rgb = oklchToLinear({
+      ...color,
+      c
+    });
+    if (rgb.every(v => v >= -1e-4 && v <= 1 + 1e-4)) {
+      const [r, g, b] = rgb.map(v => fromLinear(Math.min(1, Math.max(0, v))));
+      return {
+        r,
+        g,
+        b,
+        a: 1
+      };
+    }
+    c *= 0.9;
+  }
+  const [r, g, b] = oklchToLinear({
+    ...color,
+    c: 0
+  }).map(v => fromLinear(Math.min(1, Math.max(0, v))));
+  return {
+    r,
+    g,
+    b,
+    a: 1
+  };
+}
+
+/** Lowest chroma and lightness band a status colour may occupy and still read as a hue. */
+export const STATUS_CHROMA_FLOOR = 0.03;
+export const STATUS_LIGHTNESS_RANGE = [0.2, 0.95];
+
+/**
+ * Whether a colour reads as a hue rather than a neutral grey, near-black, or
+ * near-white (architecture:theme-tokens INV11). Translucent colours are judged
+ * on their own channels.
+ */
+export function isChromatic(color) {
+  const {
+    l,
+    c
+  } = toOklch(color);
+  return c >= STATUS_CHROMA_FLOOR && l >= STATUS_LIGHTNESS_RANGE[0] && l <= STATUS_LIGHTNESS_RANGE[1];
+}
+
+/**
+ * Move `color` along OKLCH lightness, at its own hue, until it reaches
+ * `ratio` against every backdrop. Moves away from the backdrops' luminance;
+ * returns the colour unchanged when it already passes, or null when no
+ * lightness at that hue reaches the ratio.
+ */
+export function solveLightness(color, backdrops, ratio) {
+  const passes = candidate => backdrops.every(backdrop => contrastRatio(candidate, backdrop) >= ratio);
+  const opaque = {
+    ...color,
+    a: 1
+  };
+  if (passes(opaque)) {
+    return opaque;
+  }
+  const meanLuminance = backdrops.reduce((sum, b) => sum + relativeLuminance(b), 0) / backdrops.length;
+  const base = toOklch(opaque);
+  // Light backdrops need a darker colour; dark backdrops a lighter one.
+  const darker = meanLuminance > 0.18;
+  let lo = darker ? 0 : base.l;
+  let hi = darker ? base.l : 1;
+  const at = l => fromOklch({
+    ...base,
+    l
+  });
+  const target = darker ? at(0) : at(1);
+  if (!passes(target)) {
+    return null;
+  }
+  // Binary search for the passing lightness closest to the original.
+  for (let i = 0; i < 32; i++) {
+    const mid = (lo + hi) / 2;
+    const ok = passes(at(mid));
+    if (darker) {
+      if (ok) {
+        lo = mid;
+      } else {
+        hi = mid;
+      }
+    } else if (ok) {
+      hi = mid;
+    } else {
+      lo = mid;
+    }
+  }
+  const solved = at(darker ? lo : hi);
+  return passes(solved) ? solved : target;
+}
+
+/** Parse a concrete colour, returning null for anything unresolved. */
+export function parseConcreteColor(value) {
+  return value === undefined ? null : parseColor(value);
+}
+
+/** `#RRGGBB` or `#RRGGBBAA` for a colour. */
+export function toHex(color) {
+  const hex = formatHex(color.r, color.g, color.b);
+  if (color.a >= 1) {
+    return hex;
+  }
+  const alpha = Math.round(color.a * 255).toString(16).padStart(2, '0').toUpperCase();
+  return `${hex}${alpha}`;
+}

package/dist/theme/statusRoleDerivation.d.ts

@@ -0,0 +1,11 @@
+export declare const STATUS_NAMES: readonly ["info", "success", "warning", "error"];
+export type StatusName = (typeof STATUS_NAMES)[number];
+/** The strong fill of a status, the source its other roles derive from. */
+export declare function statusSourceToken(status: StatusName): string;
+/**
+ * Concrete `light-dark()` values for every status role a theme leaves unset
+ * while setting a colour that role is measured against. Authored roles are
+ * never overridden.
+ */
+export declare function deriveStatusRoleTokens(tokens: Record<string, string>, localTokens?: Record<string, string>): [string, string][];
+//# sourceMappingURL=statusRoleDerivation.d.ts.map

package/dist/theme/statusRoleDerivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusRoleDerivation.d.ts","sourceRoot":"","sources":["../../src/theme/statusRoleDerivation.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,YAAY,kDAAmD,CAAC;AAC7E,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AASvD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE5D;AAiMD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACvC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAwCpB"}

package/dist/theme/statusRoleDerivation.js

@@ -0,0 +1,236 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file statusRoleDerivation.ts
+ * @input A theme's portable and local token maps
+ * @output Concrete values for the status roles the theme does not set
+ * @position Theme generation step for architecture:theme-compilation INV17,
+ *   called by generateThemeRules for runtime and static output alike.
+ *
+ * Each status (`info`, `success`, `warning`, `error`) has one strong fill,
+ * `--color-<status>`. A theme that sets a fill, its content, its pale fill, or
+ * a surface gets the roles it leaves unset, computed against its own colours:
+ * - `--color-on-<status>`: the theme's light or dark content colour
+ *   (`--color-on-dark` or `--color-on-light`), whichever contrasts more with
+ *   the fill, or pure white or black when neither reaches 4.5:1;
+ * - `--color-text-<status>`: the fill's hue at 4.5:1 on surface and card;
+ * - `--color-on-<status>-muted`: the fill's hue at 4.5:1 on the pale fill over
+ *   the surface.
+ * Fills are never derived: a fill a theme does not set is Core's. Icon and
+ * border roles alias the text role through the scoped status-role aliases in
+ * generateThemeRules, so they are not computed here.
+ */
+
+import { colorDefaults } from "./tokens.stylex.js";
+import { composite, contrastRatio, isChromatic, parseConcreteColor, solveLightness, toHex } from "./statusColor.js";
+export const STATUS_NAMES = ['info', 'success', 'warning', 'error'];
+const TEXT_RATIO = 4.5;
+// Solve slightly above the floor so rounding to #RRGGBB never lands below it.
+const SOLVE_RATIO = TEXT_RATIO + 0.08;
+const MODES = ['light', 'dark'];
+
+/** The strong fill of a status, the source its other roles derive from. */
+export function statusSourceToken(status) {
+  return `--color-${status}`;
+}
+function splitTopLevel(input) {
+  const parts = [];
+  let depth = 0;
+  let current = '';
+  for (const ch of input) {
+    if (ch === '(') {
+      depth++;
+    }
+    if (ch === ')') {
+      depth--;
+    }
+    if (ch === ',' && depth === 0) {
+      parts.push(current.trim());
+      current = '';
+      continue;
+    }
+    current += ch;
+  }
+  parts.push(current.trim());
+  return parts;
+}
+
+/**
+ * Resolve one token to a concrete value for a mode, following `light-dark()`
+ * and `var()` through the theme's tokens and then Core's colour defaults.
+ * This stays local (rather than using tokens.ts) so theme generation does not
+ * import the runtime token helpers that themselves depend on defineTheme.
+ */
+function resolveToken(tokens, name, mode, seen = new Set()) {
+  if (seen.has(name)) {
+    return undefined;
+  }
+  const raw = tokens[name] ?? colorDefaults[name];
+  return resolveValue(tokens, raw, mode, new Set([...seen, name]));
+}
+function resolveValue(tokens, raw, mode, seen) {
+  if (Array.isArray(raw)) {
+    return resolveValue(tokens, raw[mode === 'light' ? 0 : 1], mode, seen);
+  }
+  if (typeof raw !== 'string') {
+    return undefined;
+  }
+  const value = raw.trim();
+  if (/^light-dark\(/i.test(value) && value.endsWith(')')) {
+    const [light, dark] = splitTopLevel(value.slice(value.indexOf('(') + 1, -1));
+    return resolveValue(tokens, mode === 'light' ? light : dark, mode, seen);
+  }
+  const ref = /^var\(\s*(--[\w-]+)\s*(?:,(.*))?\)$/s.exec(value);
+  if (ref) {
+    const resolved = resolveToken(tokens, ref[1], mode, seen);
+    return resolved ?? (ref[2] ? resolveValue(tokens, ref[2], mode, seen) : undefined);
+  }
+  return value;
+}
+const CORE_TOKENS = {};
+function resolveModes(tokens) {
+  const names = new Set([...Object.keys(colorDefaults), ...Object.keys(tokens)]);
+  const at = mode => {
+    const out = {};
+    for (const name of names) {
+      const value = resolveToken(tokens, name, mode);
+      if (value !== undefined) {
+        out[name] = value;
+      }
+    }
+    return out;
+  };
+  return {
+    light: at('light'),
+    dark: at('dark')
+  };
+}
+let coreCache;
+function core() {
+  coreCache ??= resolveModes(CORE_TOKENS);
+  return coreCache;
+}
+function statusHue(status, resolved, mode) {
+  const color = parseConcreteColor(resolved[statusSourceToken(status)]);
+  if (color !== null && isChromatic(color)) {
+    return {
+      ...color,
+      a: 1
+    };
+  }
+  // A grey source falls back to Core's own status hue, so derived text stays
+  // chromatic.
+  const fallback = parseConcreteColor(core()[mode][statusSourceToken(status)]);
+  return fallback === null ? null : {
+    ...fallback,
+    a: 1
+  };
+}
+function opaqueOver(color, under) {
+  return color.a < 1 ? composite(color, under) : color;
+}
+function deriveForMode(status, resolved, mode) {
+  // Every colour the computations measure must be concrete. When one is not
+  // (an oklch() value, an unknown reference), the status keeps its scoped
+  // aliases instead of a guess (architecture:theme-compilation INV17).
+  const source = parseConcreteColor(resolved[statusSourceToken(status)]);
+  const hue = statusHue(status, resolved, mode);
+  const surface = parseConcreteColor(resolved['--color-background-surface']);
+  const cardColor = parseConcreteColor(resolved['--color-background-card']);
+  const muted = parseConcreteColor(resolved[`--color-${status}-muted`]);
+  const onDark = parseConcreteColor(resolved['--color-on-dark']);
+  const onLight = parseConcreteColor(resolved['--color-on-light']);
+  if (source === null || hue === null || surface === null || cardColor === null || muted === null || onDark === null || onLight === null) {
+    return null;
+  }
+  const opaqueSurface = opaqueOver(surface, {
+    r: 255,
+    g: 255,
+    b: 255,
+    a: 1
+  });
+  const card = opaqueOver(cardColor, opaqueSurface);
+  const fill = opaqueOver(source, opaqueSurface);
+  const roles = {};
+  const lightInk = opaqueOver(onDark, fill);
+  const darkInk = opaqueOver(onLight, fill);
+  const themeInk = contrastRatio(lightInk, fill) >= contrastRatio(darkInk, fill) ? lightInk : darkInk;
+  // A theme's off-white and off-black content can both miss the floor on a
+  // mid-tone fill; pure white or black always reaches it.
+  const white = {
+    r: 255,
+    g: 255,
+    b: 255,
+    a: 1
+  };
+  const black = {
+    r: 0,
+    g: 0,
+    b: 0,
+    a: 1
+  };
+  roles.on = contrastRatio(themeInk, fill) >= TEXT_RATIO ? themeInk : contrastRatio(white, fill) >= contrastRatio(black, fill) ? white : black;
+  const text = solveLightness(hue, [opaqueSurface, card], SOLVE_RATIO);
+  if (text !== null) {
+    roles.text = text;
+  }
+  const pale = composite(muted.a < 1 ? muted : {
+    ...muted,
+    a: 1
+  }, opaqueSurface);
+  const onMuted = solveLightness(hue, [pale], SOLVE_RATIO);
+  if (onMuted !== null) {
+    roles.onMuted = onMuted;
+  }
+  return roles;
+}
+const ROLE_TOKENS = {
+  on: s => `--color-on-${s}`,
+  text: s => `--color-text-${s}`,
+  onMuted: s => `--color-on-${s}-muted`
+};
+
+/**
+ * Concrete `light-dark()` values for every status role a theme leaves unset
+ * while setting a colour that role is measured against. Authored roles are
+ * never overridden.
+ */
+export function deriveStatusRoleTokens(tokens, localTokens = {}) {
+  const authored = new Set(Object.keys(tokens));
+  const surfaceSet = authored.has('--color-background-surface') || authored.has('--color-background-card');
+  const inkSet = authored.has('--color-on-dark') || authored.has('--color-on-light');
+  const resolved = resolveModes({
+    ...localTokens,
+    ...tokens
+  });
+  const entries = [];
+  for (const status of STATUS_NAMES) {
+    const fillSet = authored.has(statusSourceToken(status));
+    const mutedSet = authored.has(`--color-${status}-muted`);
+    // Which roles this theme's own colours affect.
+    const affects = {
+      on: fillSet || inkSet,
+      text: fillSet || surfaceSet,
+      onMuted: fillSet || mutedSet || surfaceSet
+    };
+    if (!affects.on && !affects.text && !affects.onMuted) {
+      continue;
+    }
+    const perMode = MODES.map(mode => deriveForMode(status, resolved[mode], mode));
+    if (perMode.some(r => r === null)) {
+      continue;
+    }
+    for (const key of Object.keys(ROLE_TOKENS)) {
+      const token = ROLE_TOKENS[key](status);
+      if (!affects[key] || authored.has(token)) {
+        continue;
+      }
+      const [light, dark] = perMode.map(r => r?.[key]);
+      if (light === undefined || dark === undefined) {
+        continue;
+      }
+      entries.push([token, `light-dark(${toHex(light)}, ${toHex(dark)})`]);
+    }
+  }
+  return entries;
+}