@titan-design/react-ui 0.11.0 → 0.12.0

package/dist/index.d.mts

@@ -3,7 +3,7 @@ import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
 import { ViewProps, PressableProps, View, TextInputProps, TextInput, ImageSourcePropType, ModalProps as ModalProps$1, TextProps } from 'react-native';
 import { ThemeMode, ElevationLevel, GlowIntensity } from './theme/index.mjs';
-export { CATEGORICAL_CVD_SAFE_MAX, CategoricalVariant, ComponentType, CssPropertyEntry, CssPropertyManifest, ElevationConfig, GradientStyle, ManifestValidationResult, PRESSED_ELEVATION_LEVEL, ShadowIntensity, ShadowSurface, ThemeConfig, ThemePreset, ThemePresetColors, ThemePresetFonts, ThemePresetRadii, ThemePresetShadows, ThemeProviderMode, ThemeProviderProps, VariantAxes, VariantOverride, applyThemePreset, audiobookPreset, backgroundFrameDark, bestTextColor, buttonSizes, categoricalPalette, componentElevationRanges, createFlatShadow, createPressedHoverShadow, createPressedShadow, createRaisedHoverShadow, createRaisedShadow, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, divergingScale, elevationSystem, getBaseSurfaceColor, getCategoricalColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getPressedRecessShadow, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, hexToRgb, hsvToRgb, isCssPropertyManifest, isDark, lightThemeCSSVars, lighten, linearGradient, neumorphicShadows, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveRamps, primitiveShadows, primitiveSpacing, primitiveTypography, primitiveZIndex, resolveColor, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, sequentialEffort, shadowColors, surfaceGradient, surfaceRampDark, validateCssPropertyManifest } from './theme/index.mjs';
+export { CATEGORICAL_CVD_SAFE_MAX, CategoricalVariant, ComponentType, CssPropertyEntry, CssPropertyManifest, ElevationConfig, FLOATING_ELEVATION_MIN, GradientStyle, ManifestValidationResult, PRESSED_ELEVATION_LEVEL, SURFACE_PLANE_STEPS, ShadowIntensity, ThemeConfig, ThemePreset, ThemePresetColors, ThemePresetFonts, ThemePresetRadii, ThemePresetShadows, ThemeProviderMode, ThemeProviderProps, VariantAxes, VariantOverride, applyThemePreset, audiobookPreset, barPaper, bestTextColor, buttonSizes, categoricalPalette, componentElevationRanges, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, divergingScale, elevationSystem, getBaseSurfaceColor, getCategoricalColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getPressedRecessShadow, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, grainForTone, grainOpacityForTone, greyRamp, hexToRgb, hsvToRgb, insetWell, isCssPropertyManifest, isDark, lightThemeCSSVars, lighten, linearGradient, paperSheet, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveRamps, primitiveSpacing, primitiveTypography, primitiveZIndex, resolveColor, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, sequentialEffort, surfaceGradient, validateCssPropertyManifest } from './theme/index.mjs';
 import { S as SetStripSet, E as ExerciseIndicatorKind, a as SetRowProps } from './pages-CvsFqNtx.mjs';
 export { A as ActiveExerciseStatus, b as ActiveWorkoutExercise, c as ActiveWorkoutInput, d as ActiveWorkoutPageProps, e as ActiveWorkoutRest, f as ActiveWorkoutSuperset, C as CapacityBandChart, g as CapacityBandChartProps, h as CapacityBandDataPoint, i as CapacityBandProjection, D as DualVelocityStream, j as DualVelocityStrip, k as DualVelocityStripProps, l as ExerciseCard, m as ExerciseCardProps, n as ExerciseDetailEntry, o as ExerciseDetailHeader, p as ExerciseDetailPageProps, q as ExerciseDetailStats, r as ExerciseDetailTab, s as ExerciseIndicator, t as ExerciseIndicatorProps, u as ExerciseTrend, v as ExerciseVbt, w as ExerciseVbtSet, I as INDICATOR_PRECEDENCE, M as Meso, x as MesoCard, y as MesoCardProps, z as MesoProgressBar, B as MesoProgressBarProps, F as MesoStatus, G as MesoVolumeHeatmapEntry, P as PlanMeso, H as PlanWeek, J as PlanWorkout, K as ProgramBreadcrumb, L as ProgramNavLevel, N as ProgramPlanningPageProps, O as ProgramSelection, Q as SET_STRIP_VARIABLE_COLOR, R as SET_STRIP_ZONES, T as SetBar, U as SetBarProps, V as SetRow, W as SetRowState, X as SetRowUnit, Y as StrengthTrendChart, Z as StrengthTrendChartMesoBoundary, _ as StrengthTrendChartProps, $ as StrengthTrendDataPoint, a0 as VbtSummary, a1 as VelocitySet, a2 as VelocityStrip, a3 as VelocityStripProps, a4 as VelocityZoneBandProp, a5 as WeekRow, a6 as WeekRowProps, a7 as WeekRowWorkout, a8 as WorkoutCard, a9 as WorkoutCardProps, aa as WorkoutDot, ab as WorkoutDotStatus, ac as WorkoutGroup, ad as WorkoutMuscleGroup, ae as WorkoutMuscleVolumeStatus, af as WorkoutPill, ag as WorkoutPillProps, ah as WorkoutPillStatus, ai as WorkoutProgress, aj as WorkoutStatus, ak as calculateMeanVelocity, al as calculateVelocityLoss, am as getVelocityZoneColor, an as getVelocityZoneName, ao as resolveIndicator, ap as velocityZoneColor } from './pages-CvsFqNtx.mjs';
 export { M as MesoStatusBadge, a as MesoStatusBadgeVariant, b as MesoStatusCard, c as MesoStatusCardProps, d as MesoStatusCoaching, e as MesoStatusGauge, f as MesoStatusMetric, g as MesoStatusNextTarget } from './MesoStatusCard-CQk71hSi.mjs';
@@ -1295,7 +1295,7 @@ interface SelectProps<T = string> extends ViewProps {
  */
 declare function Select<T extends string = string>({ value, values, onChange, onChangeMulti, isMulti, placeholder, isDisabled, isInvalid, options, variant, className, ...props }: SelectProps<T>): react_jsx_runtime.JSX.Element;
 
-type ToolbarButtonVariant = 'default' | 'neumorphic';
+type ToolbarButtonVariant = 'default' | 'raised';
 type ToolbarButtonSize = 'sm' | 'md' | 'lg';
 interface ToolbarButtonContextType {
     isOpen: boolean;
@@ -2023,15 +2023,18 @@ declare function IconBox({ icon: Icon, color, size, className, ...props }: IconB
  * no new hexes. Darkest → lightest:
  *   inset (#13100D) < background (#1C1916) < base (#252321) < elevated (#2A2827) < raised (#2D2C2B) < overlay (#302F2E)
  *
- * `inset` is the ramp's deepest pit — the sub-shell well. It's the floor a
- * `<Surface pressed>` clamps at (see {@link pressedLevel}); it has no shipped
- * semantic token yet, so {@link surfaceBackground} resolves it from the
- * `surface-inset` token when present, else the `surfaceRampDark.inset` primitive.
+ * `frame` is the bezel the ramp sits inside — the top bar / side nav chrome —
+ * and the floor a `<Surface pressed>` clamps at (see {@link pressedLevel}).
+ *
+ * It replaced a separate `inset` level in TD-07.14. That level was RETIRED, not
+ * renamed: at ΔE 1.10 from the frame it was an imperceptible duplicate, which is
+ * exactly why pressed (surface − 1) kept collapsing into it.
  */
-type SurfaceLevel = 'inset' | 'background' | 'base' | 'elevated' | 'raised' | 'overlay';
+type SurfaceLevel = 'frame' | 'background' | 'base' | 'elevated' | 'raised' | 'overlay';
 /** On-surface neutral text roles, resolved for the current surface + theme. */
 type OnSurfaceRole = 'primary' | 'secondary' | 'tertiary';
 declare const SURFACE_LEVEL_TOKEN: {
+    readonly frame: "background-frame";
     readonly background: "background-base";
     readonly base: "surface-base";
     readonly elevated: "surface-elevated";
@@ -2063,9 +2066,9 @@ declare function surfaceBackground(level: SurfaceLevel, mode: ThemeMode): string
 /**
  * The level a `<Surface pressed>` resolves to: its parent's level stepped one
  * index DOWN the ramp — the symmetric twin of a raised surface stepping up —
- * clamped at the `inset` floor so a pressed surface never underflows the pit.
+ * clamped at the `frame` floor so a pressed surface never underflows the bezel.
  *   overlay→raised, raised→elevated, elevated→base, base→background,
- *   background→inset, inset→inset (clamped).
+ *   background→frame, frame→frame (clamped).
  * Pressed exposes ONE level of depth only (no pressed-2).
  */
 declare function pressedLevel(parent: SurfaceLevel): SurfaceLevel;
@@ -2078,7 +2081,7 @@ interface SurfaceProps extends ViewProps {
      */
     elevation?: ElevationLevel;
     /**
-     * Named charcoal plane (shell / rail / stage). Sets the background directly
+     * Named grey plane (shell / rail / stage). Sets the background directly
      * from a semantic surface token — reaching the darker nav/page planes the
      * lighten model can't — and drops the default rounding + auto shadow so the
      * plane reads full-bleed. Composable with `elevation`'s glow.
@@ -2110,7 +2113,7 @@ interface SurfaceProps extends ViewProps {
  * A container that OWNS its background and establishes an on-surface colour
  * context. Two grounded ways to pick the background:
  *  - `elevation` (numeric): the raised-card model — lighten-from-base + shadow.
- *  - `level` (named): a flat charcoal plane straight from a semantic token,
+ *  - `level` (named): a flat grey plane straight from a semantic token,
  *    for the shell / rail / stage backgrounds.
  * Either way, descendants read the surface via {@link useOnSurfaceColor} /
  * {@link useSurfaceMode} rather than hard-coding `getSemanticColors('dark')`.
@@ -3295,7 +3298,7 @@ interface SessionHeaderProps extends ViewProps {
  * done, coloured green/amber against the elapsed-vs-budget pace, with a live marker),
  * a mono `n/total sets` label and a ⏱ elapsed readout. Upcoming (`next` set), the tiles
  * become Date/Time/Until, the bar is the empty plan shape, and the readout shows the
- * planned duration. Rendered on the raised charcoal plane; presentational. Composes
+ * planned duration. Rendered on the raised grey plane; presentational. Composes
  * {@link MetricTiles} / {@link ScheduleTiles} + {@link SegmentedProgressBar} +
  * {@link TimerReadout}.
  */
@@ -3548,7 +3551,7 @@ interface ZoneTrackProps extends ViewProps {
     trackHeight?: number;
     /** How far a needle marker overhangs the track top + bottom, in px. Overrides the `size` default (6 default / 9 wall). */
     needleOverhang?: number;
-    /** Muted colour of the track behind / beyond the fill. Default a charcoal step. */
+    /** Muted colour of the track behind / beyond the fill. Default a grey step. */
     trackColor?: string;
     className?: string;
 }
@@ -3676,7 +3679,7 @@ interface LiveAuraFrameProps extends ViewProps {
 declare function liveAuraColor(category: LiveAuraCategory): string | null;
 /**
  * Full-surface color-flood frame tied to a coaching category. Wraps `children`
- * on a charcoal base and layers a radial wash (amber at threshold, red at stop)
+ * on a grey base and layers a radial wash (amber at threshold, red at stop)
  * as a decorative, pointer-transparent overlay. The wash uses a solid
  * `backgroundColor` fallback (native) plus a web-only `backgroundImage` radial
  * gradient; both derive from the same semantic token via `alpha()`.
@@ -4018,9 +4021,9 @@ declare const STATE_LABEL: Record<FatigueVerdictState, string>;
  * language: eccentric magenta, concentric cyan, hold and idle in the grey family.
  *
  * The idle grey has to read as BAND MATERIAL (a pause the lifter held), not as a
- * hole in the strip: at charcoal[300] it sat inside the surface-ramp's own value
+ * hole in the strip: at grey[300] it sat inside the surface-ramp's own value
  * range (`surface-raised` #31302F) so a short pause between ECC and CON read as a
- * gap. charcoal[200] clears every content plane while staying quieter than the two
+ * gap. grey[200] clears every content plane while staying quieter than the two
  * saturated phase tones, so the band reads contiguous and the phases still lead.
  *
  * `hold` stays GREY rather than taking a hue of its own. It was briefly amber, which
@@ -4032,15 +4035,15 @@ declare const STATE_LABEL: Record<FatigueVerdictState, string>;
  *
  * Hold and idle are separated by VALUE rather than hue, plus the `HOLD` label and the
  * fact that a hold PACES (it has a prescribed duration) while idle never fills:
- *   unfilled hold  charcoal[300]  — darker than idle
- *   idle           charcoal[200]
- *   filled hold    charcoal[100]  — brighter than idle
+ *   unfilled hold  grey[300]  — darker than idle
+ *   idle           grey[200]
+ *   filled hold    grey[100]  — brighter than idle
  * so a hold reads apart from dead time at any fill level, including the narrow runs
  * where the label drops out.
  */
 declare const PHASE_AXIS_COLOR: Record<SamplePhase, string>;
 /** On-track / at-or-above-working. */
-declare const SILVER: "#D1D5DB";
+declare const SILVER: "#D4D1CE";
 declare const RED_LIGHT: "#F77175";
 declare const RED_MID: "#D14343";
 declare const RED_DEEP: "#7E1002";
@@ -4049,7 +4052,7 @@ declare const GRIND_THRESHOLD = 0.35;
 /** A quiet grey the controlled line dims toward as it drifts (never a colour): a dimmed
  *  cool grey in the SAME neutral family as SILVER, so a fully-drifted line reads dim-silver
  *  rather than sinking toward black. Shared with the ROM chart. */
-declare const DRIFT_GREY: "#4B5563";
+declare const DRIFT_GREY: "#5A5958";
 /**
  * The ghost-spark current-line tint from the two control-aware signals — silver/red.
  *

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
 import { ViewProps, PressableProps, View, TextInputProps, TextInput, ImageSourcePropType, ModalProps as ModalProps$1, TextProps } from 'react-native';
 import { ThemeMode, ElevationLevel, GlowIntensity } from './theme/index.js';
-export { CATEGORICAL_CVD_SAFE_MAX, CategoricalVariant, ComponentType, CssPropertyEntry, CssPropertyManifest, ElevationConfig, GradientStyle, ManifestValidationResult, PRESSED_ELEVATION_LEVEL, ShadowIntensity, ShadowSurface, ThemeConfig, ThemePreset, ThemePresetColors, ThemePresetFonts, ThemePresetRadii, ThemePresetShadows, ThemeProviderMode, ThemeProviderProps, VariantAxes, VariantOverride, applyThemePreset, audiobookPreset, backgroundFrameDark, bestTextColor, buttonSizes, categoricalPalette, componentElevationRanges, createFlatShadow, createPressedHoverShadow, createPressedShadow, createRaisedHoverShadow, createRaisedShadow, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, divergingScale, elevationSystem, getBaseSurfaceColor, getCategoricalColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getPressedRecessShadow, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, hexToRgb, hsvToRgb, isCssPropertyManifest, isDark, lightThemeCSSVars, lighten, linearGradient, neumorphicShadows, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveRamps, primitiveShadows, primitiveSpacing, primitiveTypography, primitiveZIndex, resolveColor, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, sequentialEffort, shadowColors, surfaceGradient, surfaceRampDark, validateCssPropertyManifest } from './theme/index.js';
+export { CATEGORICAL_CVD_SAFE_MAX, CategoricalVariant, ComponentType, CssPropertyEntry, CssPropertyManifest, ElevationConfig, FLOATING_ELEVATION_MIN, GradientStyle, ManifestValidationResult, PRESSED_ELEVATION_LEVEL, SURFACE_PLANE_STEPS, ShadowIntensity, ThemeConfig, ThemePreset, ThemePresetColors, ThemePresetFonts, ThemePresetRadii, ThemePresetShadows, ThemeProviderMode, ThemeProviderProps, VariantAxes, VariantOverride, applyThemePreset, audiobookPreset, barPaper, bestTextColor, buttonSizes, categoricalPalette, componentElevationRanges, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, divergingScale, elevationSystem, getBaseSurfaceColor, getCategoricalColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getPressedRecessShadow, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, grainForTone, grainOpacityForTone, greyRamp, hexToRgb, hsvToRgb, insetWell, isCssPropertyManifest, isDark, lightThemeCSSVars, lighten, linearGradient, paperSheet, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveRamps, primitiveSpacing, primitiveTypography, primitiveZIndex, resolveColor, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, sequentialEffort, surfaceGradient, validateCssPropertyManifest } from './theme/index.js';
 import { S as SetStripSet, E as ExerciseIndicatorKind, a as SetRowProps } from './pages-B1hqnGIC.js';
 export { A as ActiveExerciseStatus, b as ActiveWorkoutExercise, c as ActiveWorkoutInput, d as ActiveWorkoutPageProps, e as ActiveWorkoutRest, f as ActiveWorkoutSuperset, C as CapacityBandChart, g as CapacityBandChartProps, h as CapacityBandDataPoint, i as CapacityBandProjection, D as DualVelocityStream, j as DualVelocityStrip, k as DualVelocityStripProps, l as ExerciseCard, m as ExerciseCardProps, n as ExerciseDetailEntry, o as ExerciseDetailHeader, p as ExerciseDetailPageProps, q as ExerciseDetailStats, r as ExerciseDetailTab, s as ExerciseIndicator, t as ExerciseIndicatorProps, u as ExerciseTrend, v as ExerciseVbt, w as ExerciseVbtSet, I as INDICATOR_PRECEDENCE, M as Meso, x as MesoCard, y as MesoCardProps, z as MesoProgressBar, B as MesoProgressBarProps, F as MesoStatus, G as MesoVolumeHeatmapEntry, P as PlanMeso, H as PlanWeek, J as PlanWorkout, K as ProgramBreadcrumb, L as ProgramNavLevel, N as ProgramPlanningPageProps, O as ProgramSelection, Q as SET_STRIP_VARIABLE_COLOR, R as SET_STRIP_ZONES, T as SetBar, U as SetBarProps, V as SetRow, W as SetRowState, X as SetRowUnit, Y as StrengthTrendChart, Z as StrengthTrendChartMesoBoundary, _ as StrengthTrendChartProps, $ as StrengthTrendDataPoint, a0 as VbtSummary, a1 as VelocitySet, a2 as VelocityStrip, a3 as VelocityStripProps, a4 as VelocityZoneBandProp, a5 as WeekRow, a6 as WeekRowProps, a7 as WeekRowWorkout, a8 as WorkoutCard, a9 as WorkoutCardProps, aa as WorkoutDot, ab as WorkoutDotStatus, ac as WorkoutGroup, ad as WorkoutMuscleGroup, ae as WorkoutMuscleVolumeStatus, af as WorkoutPill, ag as WorkoutPillProps, ah as WorkoutPillStatus, ai as WorkoutProgress, aj as WorkoutStatus, ak as calculateMeanVelocity, al as calculateVelocityLoss, am as getVelocityZoneColor, an as getVelocityZoneName, ao as resolveIndicator, ap as velocityZoneColor } from './pages-B1hqnGIC.js';
 export { M as MesoStatusBadge, a as MesoStatusBadgeVariant, b as MesoStatusCard, c as MesoStatusCardProps, d as MesoStatusCoaching, e as MesoStatusGauge, f as MesoStatusMetric, g as MesoStatusNextTarget } from './MesoStatusCard-CQk71hSi.js';
@@ -1295,7 +1295,7 @@ interface SelectProps<T = string> extends ViewProps {
  */
 declare function Select<T extends string = string>({ value, values, onChange, onChangeMulti, isMulti, placeholder, isDisabled, isInvalid, options, variant, className, ...props }: SelectProps<T>): react_jsx_runtime.JSX.Element;
 
-type ToolbarButtonVariant = 'default' | 'neumorphic';
+type ToolbarButtonVariant = 'default' | 'raised';
 type ToolbarButtonSize = 'sm' | 'md' | 'lg';
 interface ToolbarButtonContextType {
     isOpen: boolean;
@@ -2023,15 +2023,18 @@ declare function IconBox({ icon: Icon, color, size, className, ...props }: IconB
  * no new hexes. Darkest → lightest:
  *   inset (#13100D) < background (#1C1916) < base (#252321) < elevated (#2A2827) < raised (#2D2C2B) < overlay (#302F2E)
  *
- * `inset` is the ramp's deepest pit — the sub-shell well. It's the floor a
- * `<Surface pressed>` clamps at (see {@link pressedLevel}); it has no shipped
- * semantic token yet, so {@link surfaceBackground} resolves it from the
- * `surface-inset` token when present, else the `surfaceRampDark.inset` primitive.
+ * `frame` is the bezel the ramp sits inside — the top bar / side nav chrome —
+ * and the floor a `<Surface pressed>` clamps at (see {@link pressedLevel}).
+ *
+ * It replaced a separate `inset` level in TD-07.14. That level was RETIRED, not
+ * renamed: at ΔE 1.10 from the frame it was an imperceptible duplicate, which is
+ * exactly why pressed (surface − 1) kept collapsing into it.
  */
-type SurfaceLevel = 'inset' | 'background' | 'base' | 'elevated' | 'raised' | 'overlay';
+type SurfaceLevel = 'frame' | 'background' | 'base' | 'elevated' | 'raised' | 'overlay';
 /** On-surface neutral text roles, resolved for the current surface + theme. */
 type OnSurfaceRole = 'primary' | 'secondary' | 'tertiary';
 declare const SURFACE_LEVEL_TOKEN: {
+    readonly frame: "background-frame";
     readonly background: "background-base";
     readonly base: "surface-base";
     readonly elevated: "surface-elevated";
@@ -2063,9 +2066,9 @@ declare function surfaceBackground(level: SurfaceLevel, mode: ThemeMode): string
 /**
  * The level a `<Surface pressed>` resolves to: its parent's level stepped one
  * index DOWN the ramp — the symmetric twin of a raised surface stepping up —
- * clamped at the `inset` floor so a pressed surface never underflows the pit.
+ * clamped at the `frame` floor so a pressed surface never underflows the bezel.
  *   overlay→raised, raised→elevated, elevated→base, base→background,
- *   background→inset, inset→inset (clamped).
+ *   background→frame, frame→frame (clamped).
  * Pressed exposes ONE level of depth only (no pressed-2).
  */
 declare function pressedLevel(parent: SurfaceLevel): SurfaceLevel;
@@ -2078,7 +2081,7 @@ interface SurfaceProps extends ViewProps {
      */
     elevation?: ElevationLevel;
     /**
-     * Named charcoal plane (shell / rail / stage). Sets the background directly
+     * Named grey plane (shell / rail / stage). Sets the background directly
      * from a semantic surface token — reaching the darker nav/page planes the
      * lighten model can't — and drops the default rounding + auto shadow so the
      * plane reads full-bleed. Composable with `elevation`'s glow.
@@ -2110,7 +2113,7 @@ interface SurfaceProps extends ViewProps {
  * A container that OWNS its background and establishes an on-surface colour
  * context. Two grounded ways to pick the background:
  *  - `elevation` (numeric): the raised-card model — lighten-from-base + shadow.
- *  - `level` (named): a flat charcoal plane straight from a semantic token,
+ *  - `level` (named): a flat grey plane straight from a semantic token,
  *    for the shell / rail / stage backgrounds.
  * Either way, descendants read the surface via {@link useOnSurfaceColor} /
  * {@link useSurfaceMode} rather than hard-coding `getSemanticColors('dark')`.
@@ -3295,7 +3298,7 @@ interface SessionHeaderProps extends ViewProps {
  * done, coloured green/amber against the elapsed-vs-budget pace, with a live marker),
  * a mono `n/total sets` label and a ⏱ elapsed readout. Upcoming (`next` set), the tiles
  * become Date/Time/Until, the bar is the empty plan shape, and the readout shows the
- * planned duration. Rendered on the raised charcoal plane; presentational. Composes
+ * planned duration. Rendered on the raised grey plane; presentational. Composes
  * {@link MetricTiles} / {@link ScheduleTiles} + {@link SegmentedProgressBar} +
  * {@link TimerReadout}.
  */
@@ -3548,7 +3551,7 @@ interface ZoneTrackProps extends ViewProps {
     trackHeight?: number;
     /** How far a needle marker overhangs the track top + bottom, in px. Overrides the `size` default (6 default / 9 wall). */
     needleOverhang?: number;
-    /** Muted colour of the track behind / beyond the fill. Default a charcoal step. */
+    /** Muted colour of the track behind / beyond the fill. Default a grey step. */
     trackColor?: string;
     className?: string;
 }
@@ -3676,7 +3679,7 @@ interface LiveAuraFrameProps extends ViewProps {
 declare function liveAuraColor(category: LiveAuraCategory): string | null;
 /**
  * Full-surface color-flood frame tied to a coaching category. Wraps `children`
- * on a charcoal base and layers a radial wash (amber at threshold, red at stop)
+ * on a grey base and layers a radial wash (amber at threshold, red at stop)
  * as a decorative, pointer-transparent overlay. The wash uses a solid
  * `backgroundColor` fallback (native) plus a web-only `backgroundImage` radial
  * gradient; both derive from the same semantic token via `alpha()`.
@@ -4018,9 +4021,9 @@ declare const STATE_LABEL: Record<FatigueVerdictState, string>;
  * language: eccentric magenta, concentric cyan, hold and idle in the grey family.
  *
  * The idle grey has to read as BAND MATERIAL (a pause the lifter held), not as a
- * hole in the strip: at charcoal[300] it sat inside the surface-ramp's own value
+ * hole in the strip: at grey[300] it sat inside the surface-ramp's own value
  * range (`surface-raised` #31302F) so a short pause between ECC and CON read as a
- * gap. charcoal[200] clears every content plane while staying quieter than the two
+ * gap. grey[200] clears every content plane while staying quieter than the two
  * saturated phase tones, so the band reads contiguous and the phases still lead.
  *
  * `hold` stays GREY rather than taking a hue of its own. It was briefly amber, which
@@ -4032,15 +4035,15 @@ declare const STATE_LABEL: Record<FatigueVerdictState, string>;
  *
  * Hold and idle are separated by VALUE rather than hue, plus the `HOLD` label and the
  * fact that a hold PACES (it has a prescribed duration) while idle never fills:
- *   unfilled hold  charcoal[300]  — darker than idle
- *   idle           charcoal[200]
- *   filled hold    charcoal[100]  — brighter than idle
+ *   unfilled hold  grey[300]  — darker than idle
+ *   idle           grey[200]
+ *   filled hold    grey[100]  — brighter than idle
  * so a hold reads apart from dead time at any fill level, including the narrow runs
  * where the label drops out.
  */
 declare const PHASE_AXIS_COLOR: Record<SamplePhase, string>;
 /** On-track / at-or-above-working. */
-declare const SILVER: "#D1D5DB";
+declare const SILVER: "#D4D1CE";
 declare const RED_LIGHT: "#F77175";
 declare const RED_MID: "#D14343";
 declare const RED_DEEP: "#7E1002";
@@ -4049,7 +4052,7 @@ declare const GRIND_THRESHOLD = 0.35;
 /** A quiet grey the controlled line dims toward as it drifts (never a colour): a dimmed
  *  cool grey in the SAME neutral family as SILVER, so a fully-drifted line reads dim-silver
  *  rather than sinking toward black. Shared with the ROM chart. */
-declare const DRIFT_GREY: "#4B5563";
+declare const DRIFT_GREY: "#5A5958";
 /**
  * The ghost-spark current-line tint from the two control-aware signals — silver/red.
  *