@titan-design/react-ui 0.2.6 → 0.3.0

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React from 'react';
+import React, { ReactNode } from 'react';
 import { ViewProps, PressableProps, View, TextInputProps, TextInput, ImageSourcePropType, ModalProps as ModalProps$1, TextProps } from 'react-native';
 import { ElevationLevel, GlowIntensity } from './theme/index.js';
-export { ComponentType, ElevationConfig, ShadowIntensity, ShadowSurface, ThemeConfig, ThemeMode, ThemePreset, ThemePresetColors, ThemePresetFonts, ThemePresetRadii, ThemePresetShadows, applyThemePreset, audiobookPreset, buttonSizes, componentElevationRanges, createFlatShadow, createPressedHoverShadow, createPressedShadow, createRaisedHoverShadow, createRaisedShadow, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, elevationSystem, getBaseSurfaceColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, hexToRgb, hsvToRgb, isDark, lightThemeCSSVars, lighten, neumorphicShadows, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveShadows, primitiveSpacing, primitiveTypography, primitiveZIndex, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, shadowColors } from './theme/index.js';
+export { ComponentType, CssPropertyEntry, CssPropertyManifest, ElevationConfig, ManifestValidationResult, ShadowIntensity, ShadowSurface, ThemeConfig, ThemeMode, ThemePreset, ThemePresetColors, ThemePresetFonts, ThemePresetRadii, ThemePresetShadows, VariantAxes, VariantOverride, applyThemePreset, audiobookPreset, buttonSizes, componentElevationRanges, createFlatShadow, createPressedHoverShadow, createPressedShadow, createRaisedHoverShadow, createRaisedShadow, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, elevationSystem, getBaseSurfaceColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, hexToRgb, hsvToRgb, isCssPropertyManifest, isDark, lightThemeCSSVars, lighten, neumorphicShadows, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveShadows, primitiveSpacing, primitiveTypography, primitiveZIndex, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, shadowColors, validateCssPropertyManifest } from './theme/index.js';
+import { M as MesoStatusCardProps } from './bodymap-BhG55xHM.js';
+export { B as BodyMapData, a as BodyMapDetailPanelProps, b as BodyMapProps, C as ContributingExercise, c as MesoStatusBadge, d as MesoStatusBadgeVariant, e as MesoStatusCard, f as MesoStatusCoaching, g as MesoStatusGauge, h as MesoStatusMetric, i as MesoStatusNextTarget, j as MovementCategory, k as MuscleGroup, S as SimpleMuscleGroup, T as TrainingStatusMuscle, l as TrainingStatusPageProps, m as TrainingStatusSummary, U as UpcomingExercise, V as VolumeLandmarks } from './bodymap-BhG55xHM.js';
 import { ClassValue } from 'clsx';
 
 type AlertStatus = 'success' | 'info' | 'warning' | 'error';
@@ -2497,6 +2499,216 @@ interface MetricGroupProps extends ViewProps {
 }
 declare function MetricGroup({ className, children, ...props }: MetricGroupProps): react_jsx_runtime.JSX.Element;
 
+type BaseBadgeVariant = 'plain' | 'pr';
+type BaseBadgeSize = 'sm' | 'md' | 'lg';
+interface BaseBadgeProps extends ViewProps {
+    /** Visual variant — plain (neutral) or pr (brand-primary-subtle) */
+    variant?: BaseBadgeVariant;
+    /** Size variant */
+    size?: BaseBadgeSize;
+    /** Optional icon rendered left of children; hidden from a11y tree */
+    icon?: ReactNode;
+    onPress?: () => void;
+    className?: string;
+    children?: ReactNode;
+}
+declare function BaseBadge({ variant, size, icon, onPress, className, children, ...props }: BaseBadgeProps): react_jsx_runtime.JSX.Element;
+
+type WeightBadgeSize = BaseBadgeSize;
+interface WeightBadgeProps extends Omit<BaseBadgeProps, 'variant' | 'icon' | 'children'> {
+    value: number;
+    unit?: 'lbs' | 'kg';
+    /**
+     * When given, this is an N-rep max (e.g. "5RM"). When omitted, it is an
+     * estimated 1RM / e1RM.
+     */
+    reps?: number;
+    /** Percentage delta from previous mesocycle */
+    delta?: number;
+    isPr?: boolean;
+    /** Show the weight icon */
+    showIcon?: boolean;
+    size?: WeightBadgeSize;
+    onPress?: () => void;
+    className?: string;
+}
+declare function WeightBadge({ value, unit, reps, delta, isPr, showIcon, size, onPress, className, ...props }: WeightBadgeProps): react_jsx_runtime.JSX.Element;
+
+type PRType = 'e1rm' | 'weight' | 'reps' | 'volume' | 'velocity';
+interface PrBadgeProps extends ViewProps {
+    /** PR type determines auto-generated label */
+    type?: PRType;
+    /** Display label (e.g., "PR e1RM", "PR 5RM"). Auto-generated from type if omitted. */
+    label?: string;
+    /** Show only the star icon, no text label */
+    compact?: boolean;
+    /** Trigger pop animation on mount */
+    animate?: boolean;
+    className?: string;
+}
+declare function PrBadge({ type, label: labelProp, compact, animate, className, ...props }: PrBadgeProps): react_jsx_runtime.JSX.Element;
+
+type StatusDotVariant = 'success' | 'warning' | 'error' | 'neutral' | 'on-track' | 'deviation' | 'future';
+interface StatusDotProps extends ViewProps {
+    variant: StatusDotVariant;
+    /** Center glyph. Only rendered at size="md"; the 8px "sm" dot is too small to fit one. */
+    icon?: 'check' | 'exclamation' | 'dash';
+    size?: 'sm' | 'md';
+    /** Adds a subtle glow effect in the variant color */
+    glow?: boolean;
+    label?: string;
+    className?: string;
+}
+declare function StatusDot({ variant, icon, size, glow, label, className, ...props }: StatusDotProps): react_jsx_runtime.JSX.Element;
+
+interface PlaceholderStripProps extends ViewProps {
+    width?: number | string;
+    /** Render as single solid strip or segmented mini-strip */
+    mode?: 'single' | 'segmented';
+    /** Number of segments when mode is 'segmented' */
+    segments?: number;
+    className?: string;
+}
+declare function PlaceholderStrip({ mode, segments, ...props }: PlaceholderStripProps): react_jsx_runtime.JSX.Element;
+
+interface TempoDisplayProps extends ViewProps {
+    /** Tempo values: [eccentric, pauseBottom, concentric, pauseTop] in seconds */
+    tempo: [number, number, number, number];
+    size?: 'sm' | 'md';
+    /** Colored phases or mono (all gray) */
+    colored?: boolean;
+    /** Show info tooltip on press */
+    showInfo?: boolean;
+    onPress?: () => void;
+    className?: string;
+}
+declare function TempoDisplay({ tempo, size, colored, showInfo, onPress, className, ...props }: TempoDisplayProps): react_jsx_runtime.JSX.Element;
+
+interface DeviationBarProps extends ViewProps {
+    deviation: number;
+    width?: number;
+    className?: string;
+}
+declare function DeviationBar({ deviation, width, className, ...props }: DeviationBarProps): react_jsx_runtime.JSX.Element;
+
+type IntensityBarOrientation = 'vertical' | 'horizontal';
+interface IntensityBarProps extends ViewProps {
+    /** Current intensity level 0-1 */
+    level: number;
+    /** MRV/overexertion threshold position 0-1 */
+    threshold?: number;
+    /** Orientation */
+    orientation?: IntensityBarOrientation;
+    /** Height for vertical (default 24px) or width for horizontal */
+    size?: number;
+    /** Width for vertical (default 6px) or height for horizontal */
+    thickness?: number;
+    /** Show threshold label ("MRV") */
+    showThresholdLabel?: boolean;
+    className?: string;
+}
+declare function IntensityBar({ level, threshold, orientation, size, thickness, showThresholdLabel, className, ...props }: IntensityBarProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Spec statuses: completed | current | upcoming | deload.
+ * `next` and `missed` are additive extras supported by this implementation.
+ */
+type WorkoutPillStatus = 'completed' | 'current' | 'upcoming' | 'deload' | 'next' | 'missed';
+interface WorkoutPillProps extends ViewProps {
+    name: string;
+    status: WorkoutPillStatus;
+    /** Force pulsing animation. Defaults to pulsing only on `current` status. */
+    pulse?: boolean;
+    onPress?: () => void;
+    highlighted?: boolean;
+    className?: string;
+}
+declare function WorkoutPill({ name, status, pulse, onPress, highlighted, className, ...props }: WorkoutPillProps): react_jsx_runtime.JSX.Element;
+
+interface VelocityStripProps extends ViewProps {
+    velocities: number[];
+    expanded?: boolean;
+    onToggle?: () => void;
+    onRepPress?: (index: number, velocity: number) => void;
+    variant?: 'full' | 'mini';
+    showInfo?: boolean;
+    className?: string;
+}
+declare function getVelocityZoneColor(velocity: number): string;
+declare function getVelocityZoneName(velocity: number): string;
+declare function calculateVelocityLoss(velocities: number[]): number;
+declare function calculateMeanVelocity(velocities: number[]): number;
+declare function VelocityStrip({ velocities, expanded, onToggle, onRepPress, variant, showInfo, className, ...props }: VelocityStripProps): react_jsx_runtime.JSX.Element;
+
+type VolumeStatus = 'untrained' | 'behind' | 'ontrack' | 'target' | 'over';
+interface MuscleGroupChipProps extends ViewProps {
+    name: string;
+    volumeStatus?: VolumeStatus;
+    onPress?: () => void;
+    className?: string;
+}
+declare function MuscleGroupChip({ name, volumeStatus, onPress, className, ...props }: MuscleGroupChipProps): react_jsx_runtime.JSX.Element;
+
+interface SparklineProps extends ViewProps {
+    data: number[];
+    width?: number;
+    height?: number;
+    color?: string;
+    showDots?: boolean;
+    referenceLines?: Array<{
+        value: number;
+        color: string;
+        dashed?: boolean;
+        label?: string;
+    }>;
+    highlightLast?: boolean;
+    className?: string;
+}
+declare function Sparkline({ data, width, height, color, showDots, referenceLines, highlightLast, className, ...props }: SparklineProps): react_jsx_runtime.JSX.Element;
+
+type SetRowMode = 'active' | 'completed' | 'history';
+interface SetRowProps {
+    mode: SetRowMode;
+    setNumber: number;
+    previous?: {
+        reps: number;
+        weight: number;
+    } | null;
+    reps: number | null;
+    weight: number | null;
+    rpe?: number | null;
+    unit: 'lbs' | 'kg';
+    velocities?: number[];
+    velocityExpanded?: boolean;
+    onVelocityToggle?: () => void;
+    setType?: string;
+    prBadges?: Array<{
+        type: PRType;
+        label: string;
+    }>;
+    isNextSet?: boolean;
+    targets?: {
+        reps: number;
+        weight: number;
+    };
+}
+declare function SetRow({ mode, setNumber, previous, reps, weight, rpe, unit, velocities, velocityExpanded, onVelocityToggle, setType, prBadges, isNextSet, targets, }: SetRowProps): react_jsx_runtime.JSX.Element;
+
+interface InputBarProps {
+    exerciseName: string;
+    setNumber: number;
+    totalSets: number | null;
+    reps: string;
+    weight: string;
+    unit: 'lbs' | 'kg';
+    onRepsChange: (value: string) => void;
+    onWeightChange: (value: string) => void;
+    onRecord: () => void;
+    canRecord: boolean;
+    visible: boolean;
+}
+declare function InputBar({ exerciseName, setNumber, totalSets, reps, weight, unit, onRepsChange, onWeightChange, onRecord, canRecord, visible, }: InputBarProps): react_jsx_runtime.JSX.Element | null;
+
 interface RestTimerProps {
     totalSeconds: number;
     elapsedMs: number;
@@ -2507,14 +2719,889 @@ interface RestTimerProps {
 }
 declare function RestTimer({ totalSeconds, elapsedMs, onSkip, onAddTime, nextSetInfo, visible, }: RestTimerProps): react_jsx_runtime.JSX.Element | null;
 
+type ExerciseCardState = 'collapsed' | 'expanded' | 'upcoming';
+interface ExerciseCardProps {
+    name: string;
+    state: ExerciseCardState;
+    onToggle: () => void;
+    onNavigateDetail?: () => void;
+    summary?: {
+        sets: number;
+        reps: number | string;
+        weight: number;
+        unit: 'lbs' | 'kg';
+    };
+    e1rm?: {
+        value: number;
+        unit: 'lbs' | 'kg';
+    };
+    isPR?: boolean;
+    setVelocities?: number[][];
+    totalPlannedSets?: number;
+    sets?: SetRowProps[];
+    tempo?: [number, number, number, number];
+    prescription?: string;
+    previousBest?: string;
+    supersetPosition?: 'first' | 'last' | 'middle' | null;
+    supersetColor?: string;
+}
+declare function ExerciseCard(props: ExerciseCardProps): react_jsx_runtime.JSX.Element;
+
 interface SupersetWrapperProps {
     label?: string;
     color?: string;
     children: React.ReactNode;
-    syncExpansion?: boolean;
 }
 declare function SupersetWrapper({ label, color, children, }: SupersetWrapperProps): react_jsx_runtime.JSX.Element;
 
+type MesoStatus = 'completed' | 'current' | 'upcoming';
+interface Meso {
+    id: string;
+    name: string;
+    weekCount: number;
+    status: MesoStatus;
+    /**
+     * 1-based week index of progress within a `current` meso.
+     * Drives the solid fill width. Ignored for non-current mesos.
+     */
+    currentWeek?: number;
+}
+interface MesoProgressBarProps extends ViewProps {
+    mesos: Meso[];
+    activeMesoId: string | null;
+    onMesoPress: (mesoId: string) => void;
+    className?: string;
+}
+/**
+ * Segmented horizontal bar of mesocycles. Each segment is tappable and its
+ * flex width is proportional to the meso's `weekCount`. The active segment is
+ * highlighted with a 2px brand border to stay in sync with MesoCard selection.
+ *
+ * @example
+ * <MesoProgressBar
+ *   mesos={[
+ *     { id: 'm1', name: 'Accumulation', weekCount: 4, status: 'completed' },
+ *     { id: 'm2', name: 'Intensification', weekCount: 3, status: 'current', currentWeek: 2 },
+ *     { id: 'm3', name: 'Peak', weekCount: 2, status: 'upcoming' },
+ *   ]}
+ *   activeMesoId="m2"
+ *   onMesoPress={(id) => console.log(id)}
+ * />
+ */
+declare function MesoProgressBar({ mesos, activeMesoId, onMesoPress, className, ...props }: MesoProgressBarProps): react_jsx_runtime.JSX.Element;
+
+interface WeekRowWorkout {
+    name: string;
+    status: WorkoutPillStatus;
+    onPress?: () => void;
+}
+interface WeekRowProps extends ViewProps {
+    /** Week index within the mesocycle (1-based) */
+    weekNumber: number;
+    /** Total weeks in the mesocycle */
+    totalWeeks: number;
+    /** Workouts scheduled for this week */
+    workouts: WeekRowWorkout[];
+    /** Planned intensity for the week, 0-1 */
+    intensityLevel: number;
+    /** Optional MRV/overexertion threshold, 0-1 */
+    intensityThreshold?: number;
+    /** Highlights this row as the active week */
+    isCurrent?: boolean;
+    /** Renders this row as a deload week (purple tint, deload pills) */
+    isDeload?: boolean;
+    className?: string;
+}
+/**
+ * A single week within a mesocycle, showing the week number, its workout pills,
+ * and a right-aligned vertical intensity indicator.
+ *
+ * @example
+ * <WeekRow
+ *   weekNumber={1}
+ *   totalWeeks={4}
+ *   workouts={[
+ *     { name: 'Upper', status: 'completed' },
+ *     { name: 'Lower', status: 'current' },
+ *   ]}
+ *   intensityLevel={0.55}
+ *   intensityThreshold={0.8}
+ *   isCurrent
+ * />
+ */
+declare function WeekRow({ weekNumber, totalWeeks, workouts, intensityLevel, intensityThreshold, isCurrent, isDeload, className, ...props }: WeekRowProps): react_jsx_runtime.JSX.Element;
+
+type WorkoutStatus = 'completed' | 'today' | 'upcoming';
+/** Spec volume-status vocabulary; mapped to MuscleGroupChip's VolumeStatus internally. */
+type WorkoutMuscleVolumeStatus = 'under' | 'maintenance' | 'productive' | 'over';
+interface WorkoutMuscleGroup {
+    /** Muscle group identifier (free-form to match plan data). */
+    group: string;
+    /** Display label, may be abbreviated. */
+    label: string;
+    /** Volume status relative to landmarks. */
+    volumeStatus?: WorkoutMuscleVolumeStatus;
+}
+interface WorkoutCardProps extends ViewProps {
+    name: string;
+    date: string;
+    /** e.g. "45 min" */
+    duration?: string;
+    status: WorkoutStatus;
+    muscleGroups: WorkoutMuscleGroup[];
+    totalSets: number;
+    /** Total lbs/kg moved across the workout. */
+    totalVolume?: number;
+    unit: 'lbs' | 'kg';
+    exercises?: ExerciseCardProps[];
+    expanded?: boolean;
+    onToggle?: () => void;
+    className?: string;
+}
+/**
+ * A workout within a week: name, date, duration, muscle-group pills, and a
+ * stats summary. When expandable it renders contained ExerciseCards on expand.
+ * Status drives a colored left border, today adds a brand tint, and upcoming
+ * is dimmed.
+ *
+ * @example
+ * <WorkoutCard
+ *   name="Upper A"
+ *   date="Mon, Jun 23"
+ *   duration="45 min"
+ *   status="today"
+ *   muscleGroups={[{ group: 'chest', label: 'Chest', volumeStatus: 'productive' }]}
+ *   totalSets={18}
+ *   totalVolume={12450}
+ *   unit="lbs"
+ *   expanded
+ *   onToggle={() => {}}
+ *   exercises={exercises}
+ * />
+ */
+declare function WorkoutCard({ name, date, duration, status, muscleGroups, totalSets, totalVolume, unit, exercises, expanded, onToggle, className, ...props }: WorkoutCardProps): react_jsx_runtime.JSX.Element;
+
+interface MesoVolumeHeatmapEntry {
+    /** Muscle group identifier (free-form to match plan data). */
+    group: string;
+    /** Planned volume intensity for the group, 0-100. */
+    percentage: number;
+}
+interface MesoCardProps extends ViewProps {
+    /** Mesocycle name, e.g. "Accumulation". */
+    name: string;
+    /** Training goal, e.g. "Hypertrophy", "Strength", "Peaking". */
+    goal: string;
+    /** Training split, e.g. "Upper/Lower", "Push/Pull/Legs". */
+    split: string;
+    /** Week range label, e.g. "Weeks 1-4". */
+    weekRange: string;
+    /** Current week within the mesocycle (1-based). */
+    currentWeek?: number;
+    /** Total weeks in the mesocycle. */
+    totalWeeks: number;
+    /** Weeks rendered as a WeekRow list when expanded. */
+    weeks: WeekRowProps[];
+    /** Whether the card is expanded to reveal the week list. */
+    expanded?: boolean;
+    /** Toggles expansion; makes the header a button when provided. */
+    onToggle?: () => void;
+    /** Whether this meso is highlighted in the MesoProgressBar. */
+    highlighted?: boolean;
+    /** Volume heatmap data per muscle group for the meso. */
+    volumeHeatmap?: MesoVolumeHeatmapEntry[];
+    className?: string;
+}
+/**
+ * A mesocycle card with name, goal, split, week range, an optional volume
+ * heatmap strip, and an expandable WeekRow list. Highlighting animates the
+ * border toward brand-primary with a subtle glow to stay in sync with the
+ * MesoProgressBar.
+ *
+ * @example
+ * <MesoCard
+ *   name="Accumulation"
+ *   goal="Hypertrophy"
+ *   split="Upper/Lower"
+ *   weekRange="Weeks 1-4"
+ *   currentWeek={2}
+ *   totalWeeks={4}
+ *   weeks={weeks}
+ *   volumeHeatmap={[{ group: 'chest', percentage: 80 }]}
+ *   expanded
+ *   onToggle={() => {}}
+ *   highlighted
+ * />
+ */
+declare function MesoCard({ name, goal, split, weekRange, currentWeek, totalWeeks, weeks, expanded, onToggle, highlighted, volumeHeatmap, className, ...props }: MesoCardProps): react_jsx_runtime.JSX.Element;
+
+type PrRecordType = 'e1rm' | 'weight' | 'reps' | 'volume' | 'velocity';
+interface PrRecord {
+    /** PR category, drives the row label and ordering grouping. */
+    type: PrRecordType;
+    /** Numeric magnitude (paired with `unit`) or a pre-formatted display string. */
+    value: string | number;
+    /** Unit suffix appended to numeric values, e.g. "lbs" or "kg". */
+    unit?: 'lbs' | 'kg';
+    /** Display date for when the record was set, e.g. "Mar 14" or "2 weeks ago". */
+    date: string;
+    /** Marks the record as recently set; adds a subtle amber glow highlight. */
+    isRecent?: boolean;
+}
+interface PrHistoryModalProps extends ViewProps {
+    /** Identifier of the exercise whose PR history is shown. */
+    exerciseId: string;
+    /** Human-readable exercise name for the title and a11y label; falls back to `exerciseId`. */
+    exerciseName?: string;
+    /** PR records to display, expected newest-first. */
+    records: PrRecord[];
+    /** Whether the bottom sheet is visible. */
+    isOpen?: boolean;
+    /** Alias for `isOpen` (spec wording: "isOpen/visible"). `isOpen` wins when both are set. */
+    visible?: boolean;
+    /** Invoked when the sheet requests to close (backdrop, close button, or back gesture). */
+    onClose: () => void;
+}
+/**
+ * Bottom-sheet modal listing an exercise's personal-record history. Each row
+ * shows the PR type, value, and date; recent records get a subtle amber glow.
+ * Built on the titan `Drawer` primitive (bottom placement) so it inherits
+ * backdrop dismissal, the back gesture, and `role="dialog"` semantics.
+ *
+ * Typically triggered by tapping a `WeightBadge`, but the modal itself is
+ * controlled — the trigger lives in the consumer.
+ *
+ * @example
+ * <PrHistoryModal
+ *   exerciseId="bench-press"
+ *   exerciseName="Bench Press"
+ *   isOpen={open}
+ *   onClose={() => setOpen(false)}
+ *   records={[
+ *     { type: 'e1rm', value: 245, unit: 'lbs', date: 'Mar 14', isRecent: true },
+ *     { type: 'reps', value: '8 @ 185 lbs', date: 'Feb 28' },
+ *   ]}
+ * />
+ */
+declare function PrHistoryModal({ exerciseId, exerciseName, records, isOpen, visible, onClose, ...props }: PrHistoryModalProps): react_jsx_runtime.JSX.Element;
+
+type WarmUpStatus = 'good' | 'moderate' | 'caution';
+interface ReadinessFactor {
+    /** Stable identifier; also used to pick the emoji set (sleep/soreness/motivation/stress). */
+    id: string;
+    /** Human label, e.g. "Sleep". */
+    label: string;
+    /** Selected level, 1-5. */
+    value: number;
+    /** Called with the new 1-5 level when an emoji is tapped. */
+    onChange: (value: number) => void;
+}
+interface WarmUpValidation {
+    /** Percent below the 14-day rolling velocity average. */
+    velocityDeficit: number;
+    /** Short human recommendation, e.g. "Velocity on target — proceed as planned". */
+    recommendation: string;
+    /** Severity of the deficit. */
+    status: WarmUpStatus;
+}
+interface ReadinessCheckProps {
+    /** Subjective readiness factors (Sleep, Soreness, Motivation, Stress). */
+    factors: ReadinessFactor[];
+    /** Computed overall readiness score, 0-100. */
+    score: number;
+    /** VBT warm-up validation result, shown once the warm-up set is performed. */
+    warmUpValidation?: WarmUpValidation;
+    /** Whether the VBT warm-up has been performed. */
+    warmUpCompleted: boolean;
+    /** Called when the assessment is confirmed and the workout can begin. */
+    onConfirm: () => void;
+    className?: string;
+}
+/**
+ * Pre-workout readiness assessment combining subjective emoji sliders with an
+ * objective VBT warm-up validation and a computed readiness score.
+ *
+ * @example
+ * <ReadinessCheck
+ *   factors={[{ id: 'sleep', label: 'Sleep', value: 4, onChange: setSleep }]}
+ *   score={78}
+ *   warmUpCompleted
+ *   warmUpValidation={{ velocityDeficit: 4, recommendation: 'On target', status: 'good' }}
+ *   onConfirm={start}
+ * />
+ */
+declare function ReadinessCheck({ factors, score, warmUpValidation, warmUpCompleted, onConfirm, className, }: ReadinessCheckProps): react_jsx_runtime.JSX.Element;
+
+interface StrengthTrendDataPoint {
+    /** ISO date string for the session. */
+    date: string;
+    /** Estimated one-rep max in the chart's unit. */
+    e1rm: number;
+    /** Marks a personal-record session (rendered with a star). */
+    isPR?: boolean;
+    /** Optional human label shown in the tooltip instead of the raw date. */
+    sessionLabel?: string;
+}
+interface StrengthTrendChartMesoBoundary {
+    /** ISO date where the mesocycle boundary falls. */
+    date: string;
+    /** Short label, e.g. "Hypertrophy". */
+    label: string;
+}
+interface StrengthTrendChartProps extends ViewProps {
+    /** Actual e1RM data points, chronological. */
+    data: StrengthTrendDataPoint[];
+    /** Projected/planned e1RM trajectory, drawn as a dashed line. */
+    projection?: StrengthTrendDataPoint[];
+    /** Chart plot width in pixels. */
+    width: number;
+    /** Chart plot height in pixels (120-160 for the compact variant). */
+    height: number;
+    /** Mesocycle boundary markers (vertical guides + labels). */
+    mesoBoundaries?: StrengthTrendChartMesoBoundary[];
+    /** Called when an actual data point is tapped. */
+    onPointPress?: (point: StrengthTrendDataPoint) => void;
+    /** Unit for display and labels. */
+    unit: 'lbs' | 'kg';
+    /** Animate the left-to-right line draw on mount (default true). */
+    animateOnMount?: boolean;
+    className?: string;
+}
+/**
+ * Estimated-1RM line chart over time with an optional dashed plan-projection
+ * line and PR star markers. Rendered entirely with absolutely-positioned
+ * Views (no SVG), following the Sparkline approach. Tapping an actual point
+ * opens a tooltip and fires `onPointPress`. A trend pill below the chart
+ * summarizes the percentage change for the current mesocycle.
+ *
+ * @example
+ * <StrengthTrendChart
+ *   data={[{ date: '2026-01-01', e1rm: 225 }, { date: '2026-02-01', e1rm: 245, isPR: true }]}
+ *   projection={[{ date: '2026-02-01', e1rm: 245 }, { date: '2026-03-01', e1rm: 260 }]}
+ *   width={320}
+ *   height={150}
+ *   unit="lbs"
+ * />
+ */
+declare function StrengthTrendChart({ data, projection, width, height, mesoBoundaries, onPointPress, unit, animateOnMount, className, ...props }: StrengthTrendChartProps): react_jsx_runtime.JSX.Element;
+
+type WorkoutDotStatus = 'within' | 'above' | 'below';
+interface CapacityBandDataPoint {
+    /** ISO-ish date string (e.g. "2026-06-01"). */
+    date: string;
+    /** Lower bound of the capacity band (MEV equivalent). */
+    bandLow: number;
+    /** Upper bound of the capacity band (MRV equivalent). */
+    bandHigh: number;
+}
+interface WorkoutDot {
+    date: string;
+    /** Actual session load score. */
+    load: number;
+    /** Position of the session relative to the band. */
+    status: WorkoutDotStatus;
+}
+interface CapacityBandProjection {
+    /** Band shape over the next days if training continues (rises). */
+    withTraining: CapacityBandDataPoint[];
+    /** Band shape over the next days if resting (drops). */
+    withRest: CapacityBandDataPoint[];
+}
+interface CapacityBandChartProps extends ViewProps {
+    /** Capacity band shape over time. */
+    band: CapacityBandDataPoint[];
+    /** Workout sessions plotted as dots. */
+    workouts: WorkoutDot[];
+    /** Optional forward projection (next few days). */
+    projection?: CapacityBandProjection;
+    /** Chart width in px. */
+    width: number;
+    /** Chart height in px. */
+    height: number;
+    /** Called when a workout dot is tapped. */
+    onWorkoutPress?: (workout: WorkoutDot) => void;
+    className?: string;
+}
+/**
+ * Gentler-Streak-inspired fatigue visualization. Renders a shaded capacity
+ * band (between a rolling MEV/MRV estimate), workout sessions as colored dots
+ * positioned by load, and an optional dashed forward projection that diverges
+ * for "keep training" (rises) versus "rest" (drops). View-based, no SVG:
+ * the band fill is a run of vertical columns and the edges/projection are
+ * rotated line Views (same technique as Sparkline).
+ *
+ * @example
+ * <CapacityBandChart
+ *   band={band}
+ *   workouts={workouts}
+ *   projection={{ withTraining, withRest }}
+ *   width={320}
+ *   height={180}
+ *   onWorkoutPress={(w) => openSession(w)}
+ * />
+ */
+declare function CapacityBandChart({ band, workouts, projection, width, height, onWorkoutPress, className, ...props }: CapacityBandChartProps): react_jsx_runtime.JSX.Element;
+
+/** A single workout within a planned week, plus its exercise breakdown. */
+interface PlanWorkout {
+    /** Stable identifier used for drill-down selection. */
+    id: string;
+    name: string;
+    date: string;
+    duration?: string;
+    status: WorkoutStatus;
+    muscleGroups: WorkoutMuscleGroup[];
+    totalSets: number;
+    totalVolume?: number;
+    unit: 'lbs' | 'kg';
+    /** Exercises revealed when the workout is opened. */
+    exercises: ExerciseCardProps[];
+}
+/** A training week inside a mesocycle. */
+interface PlanWeek {
+    /** 1-based week index within the mesocycle. */
+    weekNumber: number;
+    /** Planned intensity for the week, 0-1. */
+    intensityLevel: number;
+    /** Optional MRV/overexertion threshold, 0-1. */
+    intensityThreshold?: number;
+    isDeload?: boolean;
+    isCurrent?: boolean;
+    workouts: PlanWorkout[];
+}
+/** A mesocycle: the top level of the drill-down. */
+interface PlanMeso {
+    id: string;
+    name: string;
+    goal: string;
+    split: string;
+    weekRange: string;
+    weekCount: number;
+    currentWeek?: number;
+    status: MesoStatus;
+    volumeHeatmap?: MesoVolumeHeatmapEntry[];
+    weeks: PlanWeek[];
+}
+/** Current depth of the meso -> week -> workout drill-down. */
+type ProgramNavLevel = 'meso' | 'week' | 'workout';
+/** The navigation cursor within the active mesocycle. */
+interface ProgramSelection {
+    weekNumber: number | null;
+    workoutId: string | null;
+}
+/** One tappable step in the breadcrumb trail. */
+interface ProgramBreadcrumb {
+    key: string;
+    label: string;
+    level: ProgramNavLevel;
+}
+interface ProgramPlanningPageProps extends ViewProps {
+    /** Page heading. */
+    title?: string;
+    /** Mesocycles that make up the program. */
+    mesos: PlanMeso[];
+    className?: string;
+}
+/** Derive the current drill-down level from the selection cursor (pure). */
+declare function deriveNavLevel(selection: ProgramSelection): ProgramNavLevel;
+/** Project the mesocycles onto MesoProgressBar segment data (pure). */
+declare function toProgressBarMesos(mesos: PlanMeso[]): Meso[];
+/** Look up a meso by id, or null. */
+declare function findMeso(mesos: PlanMeso[], id: string | null): PlanMeso | null;
+/** Look up a week within a meso, or null. */
+declare function findWeek(meso: PlanMeso | null, weekNumber: number | null): PlanWeek | null;
+/** Look up a workout within a week, or null. */
+declare function findWorkout(week: PlanWeek | null, workoutId: string | null): PlanWorkout | null;
+/** Build the breadcrumb trail for the active drill path (pure). */
+declare function buildBreadcrumbs(meso: PlanMeso, weekNumber: number | null, workout: PlanWorkout | null): ProgramBreadcrumb[];
+/**
+ * ProgramPlanningPage — a meso -> week -> workout drill-down over an entire
+ * training program. A `MesoProgressBar` pins the mesocycle timeline to the top;
+ * the body swaps between three levels: expandable `MesoCard`s (with inline
+ * `WeekRow`s), a week's `WorkoutCard` list, and a single opened `WorkoutCard`
+ * with inline `ExerciseCard` expansion. A breadcrumb trail tracks and rewinds
+ * the drill path. Selection is page-level state; children keep their own styles.
+ *
+ * @example
+ * <ProgramPlanningPage mesos={mesos} />
+ */
+declare function ProgramPlanningPage({ title, mesos, className, ...props }: ProgramPlanningPageProps): react_jsx_runtime.JSX.Element;
+
+/** Which tab of the exercise detail view is showing. */
+type ExerciseDetailTab = 'progress' | 'history' | 'advanced';
+/** Tabs in display order. */
+declare const EXERCISE_DETAIL_TABS: Array<{
+    key: ExerciseDetailTab;
+    label: string;
+}>;
+/** Identity + headline stats for the exercise being inspected. */
+interface ExerciseDetailHeader {
+    /** Exercise name, e.g. "Barbell Bench Press". */
+    name: string;
+    /** Context line, e.g. "Chest · Barbell". */
+    subtitle: string;
+    /** Unit used across the page. */
+    unit: 'lbs' | 'kg';
+    /** Current estimated one-rep max, shown as a header pill. */
+    currentE1rm?: number;
+}
+/**
+ * A single expandable entry — one progression week or one logged session.
+ * Projected onto an `ExerciseCard`, so it collapses to a summary and expands
+ * to its `SetRow` breakdown.
+ */
+interface ExerciseDetailEntry {
+    /** Stable id for inline-expansion selection. */
+    id: string;
+    /** Row title, e.g. "Week 3" or "Mon, Jun 16". */
+    title: string;
+    /** Collapsed summary (sets × reps @ weight). */
+    summary?: ExerciseCardProps['summary'];
+    /** Estimated one-rep max badge. */
+    e1rm?: ExerciseCardProps['e1rm'];
+    /** Flags a personal-record entry. */
+    isPR?: boolean;
+    /** Prescribed tempo, revealed when expanded. */
+    tempo?: ExerciseCardProps['tempo'];
+    /** Per-set breakdown revealed when expanded. */
+    sets: SetRowProps[];
+}
+/** Strength-trend inputs for the Progress tab chart. */
+interface ExerciseTrend {
+    /** Measured e1RM data points, chronological. */
+    data: StrengthTrendDataPoint[];
+    /** Planned/projected trajectory (dashed line). */
+    projection?: StrengthTrendDataPoint[];
+    /** Mesocycle boundary guides. */
+    mesoBoundaries?: StrengthTrendChartMesoBoundary[];
+}
+/** One set's velocity trace for the Advanced tab breakdown. */
+interface ExerciseVbtSet {
+    /** Row label, e.g. "Set 1". */
+    label: string;
+    /** Per-rep mean concentric velocities (m/s). */
+    velocities: number[];
+}
+/** Velocity-based-training inputs for the Advanced tab. */
+interface ExerciseVbt {
+    /** Capacity band shape over time. */
+    band: CapacityBandDataPoint[];
+    /** Sessions plotted against the band. */
+    workouts: WorkoutDot[];
+    /** Optional forward band projection. */
+    projection?: CapacityBandProjection;
+    /** Per-set velocity traces for the most recent session. */
+    sets: ExerciseVbtSet[];
+}
+/** Page-level roll-up of the logged sessions. */
+interface ExerciseDetailStats {
+    /** Number of logged sessions. */
+    sessions: number;
+    /** Best estimated one-rep max seen, or null if none recorded. */
+    bestE1rm: number | null;
+    /** Count of PR entries. */
+    prCount: number;
+}
+/** Aggregate velocity readout for the Advanced tab. */
+interface VbtSummary {
+    /** Mean concentric velocity across every logged rep. */
+    meanVelocity: number;
+    /** Worst within-set velocity loss (%), i.e. the most-fatigued set. */
+    velocityLoss: number;
+}
+interface ExerciseDetailPageProps extends ViewProps {
+    /** Exercise identity + headline stats. */
+    exercise: ExerciseDetailHeader;
+    /** Mesocycle context banner (Progress tab). */
+    meso: MesoStatusCardProps;
+    /** Strength trend inputs (Progress tab). */
+    trend: ExerciseTrend;
+    /** Week-by-week progression entries (Progress tab). */
+    progression: ExerciseDetailEntry[];
+    /** All logged sessions (History tab). */
+    history: ExerciseDetailEntry[];
+    /** Velocity-based-training inputs (Advanced tab). */
+    vbt: ExerciseVbt;
+    className?: string;
+}
+/** Roll up logged sessions into the page summary (pure, testable). */
+declare function deriveExerciseStats(entries: ExerciseDetailEntry[]): ExerciseDetailStats;
+/** Project an entry onto ExerciseCard props, wiring inline expansion (pure). */
+declare function toExerciseCardProps(entry: ExerciseDetailEntry, expanded: boolean, onToggle: () => void): ExerciseCardProps;
+/** Aggregate per-set velocity traces into the Advanced readout (pure). */
+declare function summarizeVbt(sets: ExerciseVbtSet[]): VbtSummary;
+/**
+ * ExerciseDetailPage — a tabbed per-exercise view. A shared header (name,
+ * context line, current e1RM pill) sits above a Progress / History / Advanced
+ * tab bar. Progress composes the `MesoStatusCard` context banner, a stats
+ * strip, a `StrengthTrendChart`, and a week-by-week progression list with
+ * inline `ExerciseCard` expansion. History lists every logged session with the
+ * same inline expansion. Advanced surfaces VBT data via a `CapacityBandChart`,
+ * a velocity summary, and a per-set `VelocityStrip` breakdown. Tab and
+ * per-list expansion are page-level state; children keep their own styles.
+ *
+ * @example
+ * <ExerciseDetailPage
+ *   exercise={exercise}
+ *   meso={meso}
+ *   trend={trend}
+ *   progression={progression}
+ *   history={history}
+ *   vbt={vbt}
+ * />
+ */
+declare function ExerciseDetailPage({ exercise, meso, trend, progression, history, vbt, className, ...props }: ExerciseDetailPageProps): react_jsx_runtime.JSX.Element;
+
+/** Where an exercise sits in the during-workout flow. */
+type ActiveExerciseStatus = 'completed' | 'active' | 'upcoming';
+/**
+ * One exercise in the running workout. Projected onto an `ExerciseCard`, whose
+ * visual state is driven by `status` and the page's zoom focus: completed and
+ * active exercises collapse/expand, upcoming ones stay dimmed.
+ */
+interface ActiveWorkoutExercise {
+    /** Stable id for zoom-focus selection. */
+    id: string;
+    /** Exercise name, e.g. "Barbell Bench Press". */
+    name: string;
+    /** Position in the workout flow. */
+    status: ActiveExerciseStatus;
+    /** Unit used for this exercise's loads. */
+    unit: 'lbs' | 'kg';
+    /** Total sets prescribed for this exercise. */
+    totalPlannedSets: number;
+    /** Collapsed summary (sets × reps @ weight) for a completed exercise. */
+    summary?: ExerciseCardProps['summary'];
+    /** Estimated one-rep max badge. */
+    e1rm?: ExerciseCardProps['e1rm'];
+    /** Flags a personal-record exercise. */
+    isPR?: boolean;
+    /** Prescribed tempo, revealed when expanded. */
+    tempo?: ExerciseCardProps['tempo'];
+    /** Per-rep velocities for each logged set (drives collapsed strips + set count). */
+    setVelocities?: number[][];
+    /** Per-set breakdown revealed when expanded. */
+    sets?: SetRowProps[];
+    /** One-line prescription for an upcoming exercise. */
+    prescription?: string;
+    /** Previous-best hint for an upcoming exercise. */
+    previousBest?: string;
+    /** Groups consecutive exercises under a shared `SupersetWrapper`. */
+    supersetId?: string;
+}
+/** A superset grouping consecutive exercises that share its id. */
+interface ActiveWorkoutSuperset {
+    /** Matches `ActiveWorkoutExercise.supersetId`. */
+    id: string;
+    /** Corner badge label, e.g. "SS1". */
+    label: string;
+    /** Accent color for the wrapper rail + label. */
+    color?: string;
+}
+/** Live-set inputs shown in the bottom `InputBar`. */
+interface ActiveWorkoutInput {
+    /** Current reps field value. */
+    reps: string;
+    /** Current weight field value. */
+    weight: string;
+}
+/** Rest-timer inputs shown in the bottom `RestTimer`. */
+interface ActiveWorkoutRest {
+    /** Prescribed rest length, seconds. */
+    totalSeconds: number;
+    /** Elapsed rest, milliseconds. */
+    elapsedMs: number;
+    /** Next-set hint, e.g. "Set 3 · 8 × 195 lbs". */
+    nextSetInfo?: string;
+}
+/** Derived, page-level roll-up of workout progress. */
+interface WorkoutProgress {
+    /** Number of exercises marked completed. */
+    completedExercises: number;
+    /** Total exercises in the workout. */
+    totalExercises: number;
+    /** Sets logged so far across all exercises. */
+    completedSets: number;
+    /** Total sets prescribed across all exercises. */
+    totalSets: number;
+    /** Fraction of prescribed sets logged, 0-1. */
+    fraction: number;
+}
+/** An ordered render group: a lone exercise or a superset of exercises. */
+type WorkoutGroup = {
+    type: 'single';
+    exercise: ActiveWorkoutExercise;
+} | {
+    type: 'superset';
+    superset: ActiveWorkoutSuperset;
+    exercises: ActiveWorkoutExercise[];
+};
+interface ActiveWorkoutPageProps extends ViewProps {
+    /** Workout name shown in the header. */
+    title?: string;
+    /** Context line under the title, e.g. "Push Day A · Week 6". */
+    subtitle?: string;
+    /** Exercises in flow order. */
+    exercises: ActiveWorkoutExercise[];
+    /** Superset groupings referenced by `exercise.supersetId`. */
+    supersets?: ActiveWorkoutSuperset[];
+    /** Seed reps/weight for the live `InputBar`. */
+    input?: ActiveWorkoutInput;
+    /** Rest-timer state; when resting, the timer replaces the input bar. */
+    rest?: ActiveWorkoutRest;
+    /** Start the page in the resting state (timer showing). */
+    initialResting?: boolean;
+    className?: string;
+}
+/** Count the sets logged for an exercise (pure). */
+declare function countCompletedSets(exercise: ActiveWorkoutExercise): number;
+/** Roll up the exercises into the header progress readout (pure, testable). */
+declare function deriveWorkoutProgress(exercises: ActiveWorkoutExercise[]): WorkoutProgress;
+/** The active exercise anchors the bottom bar; find it, or null (pure). */
+declare function findActiveExercise(exercises: ActiveWorkoutExercise[]): ActiveWorkoutExercise | null;
+/** Map an exercise's status + focus onto an `ExerciseCard` visual state (pure). */
+declare function statusToCardState(status: ActiveExerciseStatus, focused: boolean): ExerciseCardState;
+/** Project an exercise onto ExerciseCard props, wiring zoom focus (pure). */
+declare function toActiveCardProps(exercise: ActiveWorkoutExercise, focused: boolean, onToggle: () => void, supersetPosition?: ExerciseCardProps['supersetPosition'], supersetColor?: string): ExerciseCardProps;
+/** Fold consecutive same-superset exercises into render groups (pure). */
+declare function groupExercises(exercises: ActiveWorkoutExercise[], supersets: ActiveWorkoutSuperset[]): WorkoutGroup[];
+/**
+ * ActiveWorkoutPage — the during-workout screen, built as a zoom hierarchy over
+ * `ExerciseCard`s. A header progress bar rolls up completed sets; the flow list
+ * dims upcoming exercises, collapses finished ones to their velocity strips, and
+ * expands exactly one focused exercise to its `SetRow` breakdown. Consecutive
+ * superset exercises stitch together inside a `SupersetWrapper`. A pinned bottom
+ * bar toggles between the live `InputBar` (log the next set) and the `RestTimer`.
+ * Focus and rest are page-level state; children keep their own styles.
+ *
+ * @example
+ * <ActiveWorkoutPage title="Push Day A" exercises={exercises} />
+ */
+declare function ActiveWorkoutPage({ title, subtitle, exercises, supersets, input, rest, initialResting, className, ...props }: ActiveWorkoutPageProps): react_jsx_runtime.JSX.Element;
+
+interface TreemapDatum {
+    /** Stable identity — returned by onPress and used as the React key. */
+    id: string;
+    /** Area weight (e.g. size, count, severity). Non-positive values are dropped. */
+    value: number;
+    /** Tile fill color. Falls back to a built-in categorical palette by index. */
+    color?: string;
+    /** Optional label rendered inside sufficiently large tiles. */
+    label?: string;
+}
+type TreemapScale = 'linear' | 'sqrt' | 'log';
+interface TreemapProps extends Omit<ViewProps, 'children'> {
+    data: TreemapDatum[];
+    /** Layout box. Required — the treemap fills exactly this area. */
+    width: number;
+    height: number;
+    /**
+     * Area scale. Real-world weights are often heavy-tailed, where one outlier
+     * under a `linear` scale swallows the whole canvas. `sqrt` (default) damps
+     * that while preserving order; `log` compresses hardest.
+     */
+    scale?: TreemapScale;
+    /** Show at most N tiles; the remainder collapse into one "+M more" tile. */
+    maxTiles?: number;
+    /** Fires with a tile's id on press (never for the "+M more" tile). */
+    onPress?: (id: string) => void;
+    /** Draws a highlight border on the matching tile. */
+    selectedId?: string;
+    className?: string;
+}
+/**
+ * Squarified treemap. SVG-free (absolutely-positioned tiles) so it renders
+ * identically on web (react-native-web) and native. Layout is computed from
+ * `value`; color and labels are caller-supplied.
+ */
+declare function Treemap({ data, width, height, scale, maxTiles, onPress, selectedId, className, ...props }: TreemapProps): react_jsx_runtime.JSX.Element;
+
+interface ScatterDatum {
+    /** Stable identity — returned by onPress and used as the React key. */
+    id: string;
+    /** Horizontal position in data space. */
+    x: number;
+    /** Vertical position in data space. */
+    y: number;
+    /** Bubble radius in px. Falls back to a fixed default when omitted. */
+    r?: number;
+    /** Bubble fill color. Falls back to a built-in categorical palette by index. */
+    color?: string;
+    /** Optional label shown for large or selected points. */
+    label?: string;
+}
+interface ScatterAxis {
+    xLabel?: string;
+    yLabel?: string;
+    /** Domain overrides. Any omitted bound is derived from the data. */
+    xMin?: number;
+    xMax?: number;
+    yMin?: number;
+    yMax?: number;
+}
+interface ScatterProps extends Omit<ViewProps, 'children'> {
+    data: ScatterDatum[];
+    /** Layout box. Required — the plot fills exactly this area. */
+    width: number;
+    height: number;
+    /** Axis labels and optional domain overrides. */
+    axis?: ScatterAxis;
+    /**
+     * Draw the y = 1 − x "main sequence" reference line (NDepend idiom, where
+     * distance from the diagonal measures the zone of pain / zone of uselessness).
+     */
+    diagonal?: boolean;
+    /** Fires with a point's id on press. */
+    onPress?: (id: string) => void;
+    /** Draws a highlight ring on the matching point. */
+    selectedId?: string;
+    className?: string;
+}
+/**
+ * SVG-free scatter / bubble plot (absolutely-positioned Views), matching the
+ * codebase's chart convention so it renders identically on web and native. Used
+ * for "main-sequence" plots (instability × abstractness) via the `diagonal`
+ * reference line, or any two metrics. Positions and bubble sizes are computed
+ * from the data; color and labels are caller-supplied.
+ */
+declare function Scatter({ data, width, height, axis, diagonal, onPress, selectedId, className, ...props }: ScatterProps): react_jsx_runtime.JSX.Element;
+
+interface GaugeThreshold {
+    /** Band start, in the gauge's value units. */
+    value: number;
+    /** Color applied to filled segments at or above this band. */
+    color: string;
+}
+interface GaugeProps extends Omit<ViewProps, 'children'> {
+    /** Current value. Clamped to [min, max]. */
+    value: number;
+    min?: number;
+    max?: number;
+    /** Diameter in px. */
+    size?: number;
+    /** Caption under the big number. */
+    label?: string;
+    /** Unit suffix beside the big number (e.g. "%"). */
+    unit?: string;
+    /**
+     * Band coloring, ascending by `value`. A filled segment takes the color of
+     * the highest band whose `value` it reaches. Defaults to Titan status tokens
+     * (red < 60, amber < 80, green ≥ 80 on a 0–100 scale).
+     */
+    thresholds?: GaugeThreshold[];
+    /** Single-color override for filled segments (ignores `thresholds`). */
+    color?: string;
+    className?: string;
+}
+/**
+ * SVG-free radial gauge (absolutely-positioned segment Views), matching the
+ * codebase's chart convention so it renders identically on web and native. The
+ * 270° arc fills with band colors as the value rises; the center reuses the
+ * Metric visual language (large bold value + unit + caption). Ideal for a 0–100
+ * health / quality score.
+ */
+declare function Gauge({ value, min, max, size, label, unit, thresholds, color, className, ...props }: GaugeProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Utility function to merge Tailwind CSS classes with proper conflict resolution.
  * Combines clsx for conditional classes with tailwind-merge for deduplication.
@@ -2683,4 +3770,44 @@ type FormErrors<T extends FormValues> = Partial<Record<keyof T, string>>;
  */
 type FormTouched<T extends FormValues> = Partial<Record<keyof T, boolean>>;
 
-export { Accordion, AccordionButton, type AccordionButtonProps, AccordionItem, type AccordionItemProps, AccordionPanel, type AccordionPanelProps, type AccordionProps, Alert, AlertDescription, type AlertDescriptionProps, type AlertProps, type AlertStatus, AlertTitle, type AlertTitleProps, type AlertVariant, Autocomplete, type AutocompleteOption, type AutocompleteProps, Avatar, AvatarBadge, type AvatarBadgeProps, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, Badge, type BadgeColor, type BadgeProps, type BadgeSize, BadgeText, type BadgeTextProps, type BadgeVariant, BreadcrumbItem, type BreadcrumbItemProps, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonColor, ButtonIcon, type ButtonIconProps, type ButtonProps, type ButtonSize, ButtonSpinner, type ButtonSpinnerProps, ButtonText, type ButtonTextProps, type ButtonVariant, Caption, type CaptionProps, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, type CardElevation, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardSkeleton, type CardSkeletonProps, CardTitle, type CardTitleProps, type CardVariant, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, Chip, type ChipColor, type ChipProps, type ChipSize, type ChipVariant, CircularProgress, type CircularProgressProps, Collapse, CollapseButton, type CollapseButtonProps, CollapseContent, type CollapseContentProps, type CollapseProps, DataRow, type DataRowProps, DateTime, type DateTimeFormat, type DateTimeProps, Divider, type DividerOrientation, type DividerProps, Drawer, DrawerBody, type DrawerBodyProps, DrawerFooter, type DrawerFooterProps, DrawerHeader, type DrawerHeaderProps, type DrawerPlacement, type DrawerProps, type DrawerSize, ElevationLevel, EmptyState, type EmptyStateProps, type FieldState, type FieldWrapperProps, FormActions, type FormActionsProps, type FormErrors, FormField, type FormFieldProps, FormRow, type FormRowProps, FormSection, type FormSectionProps, type FormTouched, type FormValues, GlowIntensity, HStack, Heading, type HeadingProps, HelpTip, type HelpTipIcon, type HelpTipPlacement, type HelpTipProps, type HelpTipSize, IconBox, type IconBoxProps, Indicator, type IndicatorColor, type IndicatorProps, type IndicatorSize, Input, InputGroup, type InputGroupProps, type InputProps, type InputSize, type InputVariant, Label, type LabelProps, LabelWithHelp, type LabelWithHelpProps, Link, type LinkColor, type LinkProps, type LinkUnderline, ListItem, ListItemContent, type ListItemContentProps, ListItemDivider, type ListItemDividerProps, ListItemIcon, type ListItemIconProps, type ListItemProps, ListItemTrailing, type ListItemTrailingProps, Menu, MenuDivider, type MenuDividerProps, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemProps, MenuList, type MenuListProps, type MenuProps, MenuTrigger, type MenuTriggerProps, Metric, MetricGroup, type MetricGroupProps, type MetricProps, type MetricTrend, Modal, ModalBody, type ModalBodyProps, ModalCloseButton, type ModalCloseButtonProps, ModalContent, type ModalContentProps, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, type ModalProps, type ModalSize, ModalTitle, type ModalTitleProps, Overline, type OverlineProps, Paragraph, type ParagraphProps, PasswordInput, type PasswordInputProps, Pill, type PillColor, type PillProps, type PillSize, type PillVariant, Popover, PopoverCloseButton, type PopoverCloseButtonProps, PopoverContent, type PopoverContentProps, type PopoverPlacement, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, Progress, type ProgressColor, type ProgressProps, type ProgressSize, ProgressSteps, type ProgressStepsProps, type ProgressVariant, Radio, type RadioColor, RadioGroup, type RadioGroupProps, type RadioProps, type RadioSize, RestTimer, type RestTimerProps, type ResultType, Section, SectionContent, type SectionContentProps, SectionHeader, type SectionHeaderProps, type SectionProps, Select, type SelectOption, type SelectProps, Sidebar, SidebarContent, type SidebarContentProps, SidebarDivider, type SidebarDividerProps, SidebarFooter, type SidebarFooterProps, SidebarHeader, type SidebarHeaderProps, SidebarItem, type SidebarItemProps, type SidebarProps, SidebarSection, type SidebarSectionProps, Skeleton, type SkeletonAnimation, SkeletonCard, type SkeletonCardProps, SkeletonCircle, type SkeletonCircleProps, SkeletonListItem, type SkeletonListItemProps, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SkeletonVariant, type SortDirection, Spinner, type SpinnerColor, type SpinnerProps, type SpinnerSize, Stack, type StackProps, type StatusType, StepContent, type StepContentProps, StepIndicator, type StepIndicatorProps, StepLabel, type StepLabelProps, type StepStatus, Stepper, type StepperOrientation, type StepperProps, Step as StepperStep, type StepProps as StepperStepProps, SupersetWrapper, type SupersetWrapperProps, Surface, type SurfaceProps, Switch, type SwitchProps, type SwitchSize, Tab, TabList, type TabListProps, TabPanel, type TabPanelProps, TabPanels, type TabPanelsProps, type TabProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHeader, TableHeaderCell, type TableHeaderCellProps, type TableHeaderProps, TablePagination, type TablePaginationProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsOrientation, type TabsProps, type TabsVariant, Toast, type ToastConfig, type ToastPosition, type ToastProps, ToastProvider, type ToastProviderProps, type ToastStatus, ToolbarButton, ToolbarButtonGroup, type ToolbarButtonGroupProps, type ToolbarButtonProps, type ToolbarButtonSize, type ToolbarButtonVariant, Tooltip, type TooltipPlacement, type TooltipProps, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, type UseTableOptions, type UseTableReturn, VStack, alpha, cn, composeValidators, createFieldId, formatDateTime, getContrastText, getFieldAriaProps, getFieldValidationProps, getLuminance, getResultColor, getStatusColor, hasMaxLength, hasMinLength, isEmpty, isValidEmail, useTable, useToast, useToolbarButton, validationRules };
+/**
+ * Presentation helpers for workout metrics.
+ *
+ * The data layer (`@voltras/workout-analytics` view-model derivations) supplies
+ * EXACT, unrounded values; these turn them into the rounded / banded / formatted
+ * forms a view renders. Keeping display munging here — in the design system, not
+ * the analytics layer — is the render half of the model↔render split: one view
+ * can round while another (or a hover) shows the exact value from the same real
+ * data. Workout components consume these so the rules live in one place.
+ */
+/** Round an exact RPE onto its conventional 0.5 granularity for display. */
+declare function roundRpe(rpe: number): number;
+/**
+ * Color band for an RPE on the canonical performance scale. Higher RPE = harder
+ * = red (direction inverted vs velocity, which shares the same scale). Bands:
+ * `<7` green, `7–8.5` yellow, `8.5–9.5` orange, `≥9.5` red.
+ */
+declare function rpeColor(rpe: number): string;
+/** Round a weight or e1RM to a whole unit for compact display. */
+declare function roundWeight(weight: number): number;
+/** Format an exact velocity (m/s) to the 2-dp string shown on the velocity strip. */
+declare function formatVelocity(velocity: number): string;
+/** Round an exact tempo tuple (seconds) to 1 dp per phase for display. */
+declare function roundTempo(tempo: [number, number, number, number]): [number, number, number, number];
+/** Signed percentage label for a deviation ratio, e.g. `+9%` / `-5%` / `0%`. */
+declare function formatSignedPct(ratio: number): string;
+/** Structured prescription for the active exercise (from the plan). */
+interface PrescriptionInput {
+    repsLow?: number;
+    repsHigh?: number;
+    weightLbs?: number;
+    rpe?: number;
+}
+/**
+ * Human prescription string, e.g. `"8–10 @ 62 lb · RPE 8"`. `null` when there is
+ * nothing to show. Presentation-only: the plan supplies the numbers, this shapes
+ * the label.
+ */
+declare function formatPrescription(p: PrescriptionInput | null | undefined): string | null;
+
+export { Accordion, AccordionButton, type AccordionButtonProps, AccordionItem, type AccordionItemProps, AccordionPanel, type AccordionPanelProps, type AccordionProps, type ActiveExerciseStatus, type ActiveWorkoutExercise, type ActiveWorkoutInput, ActiveWorkoutPage, type ActiveWorkoutPageProps, type ActiveWorkoutRest, type ActiveWorkoutSuperset, Alert, AlertDescription, type AlertDescriptionProps, type AlertProps, type AlertStatus, AlertTitle, type AlertTitleProps, type AlertVariant, Autocomplete, type AutocompleteOption, type AutocompleteProps, Avatar, AvatarBadge, type AvatarBadgeProps, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, Badge, type BadgeColor, type BadgeProps, type BadgeSize, BadgeText, type BadgeTextProps, type BadgeVariant, BaseBadge, type BaseBadgeProps, type BaseBadgeSize, type BaseBadgeVariant, BreadcrumbItem, type BreadcrumbItemProps, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonColor, ButtonIcon, type ButtonIconProps, type ButtonProps, type ButtonSize, ButtonSpinner, type ButtonSpinnerProps, ButtonText, type ButtonTextProps, type ButtonVariant, CapacityBandChart, type CapacityBandChartProps, type CapacityBandDataPoint, type CapacityBandProjection, Caption, type CaptionProps, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, type CardElevation, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardSkeleton, type CardSkeletonProps, CardTitle, type CardTitleProps, type CardVariant, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, Chip, type ChipColor, type ChipProps, type ChipSize, type ChipVariant, CircularProgress, type CircularProgressProps, Collapse, CollapseButton, type CollapseButtonProps, CollapseContent, type CollapseContentProps, type CollapseProps, DataRow, type DataRowProps, DateTime, type DateTimeFormat, type DateTimeProps, DeviationBar, type DeviationBarProps, Divider, type DividerOrientation, type DividerProps, Drawer, DrawerBody, type DrawerBodyProps, DrawerFooter, type DrawerFooterProps, DrawerHeader, type DrawerHeaderProps, type DrawerPlacement, type DrawerProps, type DrawerSize, EXERCISE_DETAIL_TABS, ElevationLevel, EmptyState, type EmptyStateProps, ExerciseCard, type ExerciseCardProps, type ExerciseCardState, type ExerciseDetailEntry, type ExerciseDetailHeader, ExerciseDetailPage, type ExerciseDetailPageProps, type ExerciseDetailStats, type ExerciseDetailTab, type ExerciseTrend, type ExerciseVbt, type ExerciseVbtSet, type FieldState, type FieldWrapperProps, FormActions, type FormActionsProps, type FormErrors, FormField, type FormFieldProps, FormRow, type FormRowProps, FormSection, type FormSectionProps, type FormTouched, type FormValues, Gauge, type GaugeProps, type GaugeThreshold, GlowIntensity, HStack, Heading, type HeadingProps, HelpTip, type HelpTipIcon, type HelpTipPlacement, type HelpTipProps, type HelpTipSize, IconBox, type IconBoxProps, Indicator, type IndicatorColor, type IndicatorProps, type IndicatorSize, Input, InputBar, type InputBarProps, InputGroup, type InputGroupProps, type InputProps, type InputSize, type InputVariant, IntensityBar, type IntensityBarProps, Label, type LabelProps, LabelWithHelp, type LabelWithHelpProps, Link, type LinkColor, type LinkProps, type LinkUnderline, ListItem, ListItemContent, type ListItemContentProps, ListItemDivider, type ListItemDividerProps, ListItemIcon, type ListItemIconProps, type ListItemProps, ListItemTrailing, type ListItemTrailingProps, Menu, MenuDivider, type MenuDividerProps, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemProps, MenuList, type MenuListProps, type MenuProps, MenuTrigger, type MenuTriggerProps, type Meso, MesoCard, type MesoCardProps, MesoProgressBar, type MesoProgressBarProps, type MesoStatus, MesoStatusCardProps, type MesoVolumeHeatmapEntry, Metric, MetricGroup, type MetricGroupProps, type MetricProps, type MetricTrend, Modal, ModalBody, type ModalBodyProps, ModalCloseButton, type ModalCloseButtonProps, ModalContent, type ModalContentProps, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, type ModalProps, type ModalSize, ModalTitle, type ModalTitleProps, MuscleGroupChip, type MuscleGroupChipProps, Overline, type OverlineProps, type PRType, Paragraph, type ParagraphProps, PasswordInput, type PasswordInputProps, Pill, type PillColor, type PillProps, type PillSize, type PillVariant, PlaceholderStrip, type PlaceholderStripProps, type PlanMeso, type PlanWeek, type PlanWorkout, Popover, PopoverCloseButton, type PopoverCloseButtonProps, PopoverContent, type PopoverContentProps, type PopoverPlacement, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, PrBadge, type PrBadgeProps, PrHistoryModal, type PrHistoryModalProps, type PrRecord, type PrRecordType, type PrescriptionInput, type ProgramBreadcrumb, type ProgramNavLevel, ProgramPlanningPage, type ProgramPlanningPageProps, type ProgramSelection, Progress, type ProgressColor, type ProgressProps, type ProgressSize, ProgressSteps, type ProgressStepsProps, type ProgressVariant, Radio, type RadioColor, RadioGroup, type RadioGroupProps, type RadioProps, type RadioSize, ReadinessCheck, type ReadinessCheckProps, type ReadinessFactor, RestTimer, type RestTimerProps, type ResultType, Scatter, type ScatterAxis, type ScatterDatum, type ScatterProps, Section, SectionContent, type SectionContentProps, SectionHeader, type SectionHeaderProps, type SectionProps, Select, type SelectOption, type SelectProps, SetRow, type SetRowMode, type SetRowProps, Sidebar, SidebarContent, type SidebarContentProps, SidebarDivider, type SidebarDividerProps, SidebarFooter, type SidebarFooterProps, SidebarHeader, type SidebarHeaderProps, SidebarItem, type SidebarItemProps, type SidebarProps, SidebarSection, type SidebarSectionProps, Skeleton, type SkeletonAnimation, SkeletonCard, type SkeletonCardProps, SkeletonCircle, type SkeletonCircleProps, SkeletonListItem, type SkeletonListItemProps, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SkeletonVariant, type SortDirection, Sparkline, type SparklineProps, Spinner, type SpinnerColor, type SpinnerProps, type SpinnerSize, Stack, type StackProps, StatusDot, type StatusDotProps, type StatusDotVariant, type StatusType, StepContent, type StepContentProps, StepIndicator, type StepIndicatorProps, StepLabel, type StepLabelProps, type StepStatus, Stepper, type StepperOrientation, type StepperProps, Step as StepperStep, type StepProps as StepperStepProps, StrengthTrendChart, type StrengthTrendChartMesoBoundary, type StrengthTrendChartProps, type StrengthTrendDataPoint, SupersetWrapper, type SupersetWrapperProps, Surface, type SurfaceProps, Switch, type SwitchProps, type SwitchSize, Tab, TabList, type TabListProps, TabPanel, type TabPanelProps, TabPanels, type TabPanelsProps, type TabProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHeader, TableHeaderCell, type TableHeaderCellProps, type TableHeaderProps, TablePagination, type TablePaginationProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsOrientation, type TabsProps, type TabsVariant, TempoDisplay, type TempoDisplayProps, Toast, type ToastConfig, type ToastPosition, type ToastProps, ToastProvider, type ToastProviderProps, type ToastStatus, ToolbarButton, ToolbarButtonGroup, type ToolbarButtonGroupProps, type ToolbarButtonProps, type ToolbarButtonSize, type ToolbarButtonVariant, Tooltip, type TooltipPlacement, type TooltipProps, Treemap, type TreemapDatum, type TreemapProps, type TreemapScale, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, type UseTableOptions, type UseTableReturn, VStack, type VbtSummary, VelocityStrip, type VelocityStripProps, type VolumeStatus, type WarmUpStatus, type WarmUpValidation, WeekRow, type WeekRowProps, type WeekRowWorkout, WeightBadge, type WeightBadgeProps, type WeightBadgeSize, WorkoutCard, type WorkoutCardProps, type WorkoutDot, type WorkoutDotStatus, type WorkoutGroup, type WorkoutMuscleGroup, type WorkoutMuscleVolumeStatus, WorkoutPill, type WorkoutPillProps, type WorkoutPillStatus, type WorkoutProgress, type WorkoutStatus, alpha, buildBreadcrumbs, calculateMeanVelocity, calculateVelocityLoss, cn, composeValidators, countCompletedSets, createFieldId, deriveExerciseStats, deriveNavLevel, deriveWorkoutProgress, findActiveExercise, findMeso, findWeek, findWorkout, formatDateTime, formatPrescription, formatSignedPct, formatVelocity, getContrastText, getFieldAriaProps, getFieldValidationProps, getLuminance, getResultColor, getStatusColor, getVelocityZoneColor, getVelocityZoneName, groupExercises, hasMaxLength, hasMinLength, isEmpty, isValidEmail, roundRpe, roundTempo, roundWeight, rpeColor, statusToCardState, summarizeVbt, toActiveCardProps, toExerciseCardProps, toProgressBarMesos, useTable, useToast, useToolbarButton, validationRules };