@titan-design/react-ui 0.2.7 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. package/dist/bodymap-BhG55xHM.d.mts +318 -0
  2. package/dist/bodymap-BhG55xHM.d.ts +318 -0
  3. package/dist/bodymap.d.mts +3 -0
  4. package/dist/bodymap.d.ts +3 -0
  5. package/dist/bodymap.js +2670 -0
  6. package/dist/bodymap.js.map +1 -0
  7. package/dist/bodymap.mjs +1101 -0
  8. package/dist/bodymap.mjs.map +1 -0
  9. package/dist/{chunk-5SSKGS6E.mjs → chunk-7XPB4NAO.mjs} +124 -4
  10. package/dist/chunk-7XPB4NAO.mjs.map +1 -0
  11. package/dist/{chunk-3VLOBS6O.mjs → chunk-P7TSQUN6.mjs} +3 -3
  12. package/dist/{chunk-3VLOBS6O.mjs.map → chunk-P7TSQUN6.mjs.map} +1 -1
  13. package/dist/chunk-TOD2WQBG.mjs +1048 -0
  14. package/dist/chunk-TOD2WQBG.mjs.map +1 -0
  15. package/dist/index.d.mts +375 -249
  16. package/dist/index.d.ts +375 -249
  17. package/dist/index.js +1259 -918
  18. package/dist/index.js.map +1 -1
  19. package/dist/index.mjs +1314 -2107
  20. package/dist/index.mjs.map +1 -1
  21. package/dist/theme/index.d.mts +260 -0
  22. package/dist/theme/index.d.ts +260 -0
  23. package/dist/theme/index.js +122 -2
  24. package/dist/theme/index.js.map +1 -1
  25. package/dist/theme/index.mjs +2 -2
  26. package/dist/theme/tokens-css.d.mts +5 -3
  27. package/dist/theme/tokens-css.d.ts +5 -3
  28. package/dist/theme/tokens-css.js +318 -9
  29. package/dist/theme/tokens-css.js.map +1 -1
  30. package/dist/theme/tokens-css.mjs +1 -1
  31. package/dist/theme/tokens-css.mjs.map +1 -1
  32. package/package.json +10 -1
  33. package/src/bodymap.ts +37 -0
  34. package/src/components/custom/Table/Table.test.tsx +27 -0
  35. package/src/components/custom/Table/Table.tsx +33 -17
  36. package/src/components/custom/Workout/ActiveWorkoutPage.stories.tsx +118 -0
  37. package/src/components/custom/Workout/ActiveWorkoutPage.test.tsx +171 -0
  38. package/src/components/custom/Workout/ActiveWorkoutPage.tsx +447 -0
  39. package/src/components/custom/Workout/BodyMap.tsx +5 -6
  40. package/src/components/custom/Workout/BodyMapDetailPanel.tsx +7 -8
  41. package/src/components/custom/Workout/CapacityBandChart.tsx +1 -1
  42. package/src/components/custom/Workout/ExerciseCard.test.tsx +24 -0
  43. package/src/components/custom/Workout/ExerciseCard.tsx +28 -15
  44. package/src/components/custom/Workout/ExerciseDetailPage.stories.tsx +225 -0
  45. package/src/components/custom/Workout/ExerciseDetailPage.test.tsx +128 -0
  46. package/src/components/custom/Workout/ExerciseDetailPage.tsx +630 -0
  47. package/src/components/custom/Workout/InputBar.tsx +6 -7
  48. package/src/components/custom/Workout/MesoCard.tsx +4 -2
  49. package/src/components/custom/Workout/MesoProgressBar.test.tsx +12 -0
  50. package/src/components/custom/Workout/MesoProgressBar.tsx +5 -1
  51. package/src/components/custom/Workout/MesoStatusCard.tsx +5 -5
  52. package/src/components/custom/Workout/PlaceholderStrip.tsx +2 -3
  53. package/src/components/custom/Workout/PrHistoryModal.tsx +5 -5
  54. package/src/components/custom/Workout/ProgramPlanningPage.stories.tsx +257 -0
  55. package/src/components/custom/Workout/ProgramPlanningPage.test.tsx +142 -0
  56. package/src/components/custom/Workout/ProgramPlanningPage.tsx +422 -0
  57. package/src/components/custom/Workout/ReadinessCheck.tsx +7 -8
  58. package/src/components/custom/Workout/RestTimer.test.tsx +10 -0
  59. package/src/components/custom/Workout/RestTimer.tsx +11 -9
  60. package/src/components/custom/Workout/SetRow.tsx +13 -19
  61. package/src/components/custom/Workout/StatusDot.tsx +1 -0
  62. package/src/components/custom/Workout/StrengthTrendChart.tsx +5 -5
  63. package/src/components/custom/Workout/TempoDisplay.tsx +3 -1
  64. package/src/components/custom/Workout/TrainingStatusPage.stories.tsx +212 -0
  65. package/src/components/custom/Workout/TrainingStatusPage.test.tsx +131 -0
  66. package/src/components/custom/Workout/TrainingStatusPage.tsx +321 -0
  67. package/src/components/custom/Workout/VelocityStrip.test.tsx +10 -0
  68. package/src/components/custom/Workout/VelocityStrip.tsx +16 -15
  69. package/src/components/custom/Workout/WeekRow.tsx +1 -1
  70. package/src/components/custom/Workout/WorkoutCard.tsx +5 -3
  71. package/src/components/custom/Workout/index.ts +71 -32
  72. package/src/theme/config.completeness.test.ts +77 -0
  73. package/src/theme/config.ts +151 -0
  74. package/src/theme/manifest/design-freeze.test.ts +155 -0
  75. package/src/theme/manifest/extract-css-properties.fixture.html +29 -0
  76. package/src/theme/manifest/extract-css-properties.test.ts +112 -0
  77. package/src/theme/tokens-css.ts +5 -3
  78. package/src/theme/workout-tokens.ts +12 -14
  79. package/src/utils/index.ts +10 -0
  80. package/src/utils/workout-format.test.ts +81 -0
  81. package/src/utils/workout-format.ts +83 -0
  82. package/dist/chunk-5SSKGS6E.mjs.map +0 -1
package/dist/index.d.mts CHANGED
@@ -3,6 +3,8 @@ import React, { ReactNode } from 'react';
3
3
  import { ViewProps, PressableProps, View, TextInputProps, TextInput, ImageSourcePropType, ModalProps as ModalProps$1, TextProps } from 'react-native';
4
4
  import { ElevationLevel, GlowIntensity } from './theme/index.mjs';
5
5
  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.mjs';
6
+ import { M as MesoStatusCardProps } from './bodymap-BhG55xHM.mjs';
7
+ 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.mjs';
6
8
  import { ClassValue } from 'clsx';
7
9
 
8
10
  type AlertStatus = 'success' | 'info' | 'warning' | 'error';
@@ -2549,6 +2551,7 @@ declare function PrBadge({ type, label: labelProp, compact, animate, className,
2549
2551
  type StatusDotVariant = 'success' | 'warning' | 'error' | 'neutral' | 'on-track' | 'deviation' | 'future';
2550
2552
  interface StatusDotProps extends ViewProps {
2551
2553
  variant: StatusDotVariant;
2554
+ /** Center glyph. Only rendered at size="md"; the 8px "sm" dot is too small to fit one. */
2552
2555
  icon?: 'check' | 'exclamation' | 'dash';
2553
2556
  size?: 'sm' | 'md';
2554
2557
  /** Adds a subtle glow effect in the variant color */
@@ -2637,10 +2640,10 @@ declare function calculateVelocityLoss(velocities: number[]): number;
2637
2640
  declare function calculateMeanVelocity(velocities: number[]): number;
2638
2641
  declare function VelocityStrip({ velocities, expanded, onToggle, onRepPress, variant, showInfo, className, ...props }: VelocityStripProps): react_jsx_runtime.JSX.Element;
2639
2642
 
2640
- type VolumeStatus$1 = 'untrained' | 'behind' | 'ontrack' | 'target' | 'over';
2643
+ type VolumeStatus = 'untrained' | 'behind' | 'ontrack' | 'target' | 'over';
2641
2644
  interface MuscleGroupChipProps extends ViewProps {
2642
2645
  name: string;
2643
- volumeStatus?: VolumeStatus$1;
2646
+ volumeStatus?: VolumeStatus;
2644
2647
  onPress?: () => void;
2645
2648
  className?: string;
2646
2649
  }
@@ -3029,79 +3032,6 @@ interface ReadinessCheckProps {
3029
3032
  */
3030
3033
  declare function ReadinessCheck({ factors, score, warmUpValidation, warmUpCompleted, onConfirm, className, }: ReadinessCheckProps): react_jsx_runtime.JSX.Element;
3031
3034
 
3032
- type MesoStatusBadgeVariant = 'success' | 'warning' | 'error';
3033
- interface MesoStatusBadge {
3034
- /** Short status label, e.g. "On Track". */
3035
- label: string;
3036
- /** Color treatment for the badge. */
3037
- variant: MesoStatusBadgeVariant;
3038
- }
3039
- interface MesoStatusMetric {
3040
- /** Cell label, e.g. "Prescribed". */
3041
- label: string;
3042
- /** Cell value, e.g. "3×8 @ RPE 8". */
3043
- value: string;
3044
- }
3045
- interface MesoStatusGauge {
3046
- /** Gauge label, e.g. "Intensity". */
3047
- label: string;
3048
- /** Fill position 0-1; the 14px marker sits at this level. */
3049
- level: number;
3050
- /** Optional right-aligned sublabel, e.g. "Prescribed". */
3051
- sublabel?: string;
3052
- }
3053
- interface MesoStatusCoaching {
3054
- /** Coaching recommendation copy. */
3055
- text: string;
3056
- /** Substrings within `text` to render in bold. */
3057
- highlights?: string[];
3058
- }
3059
- interface MesoStatusNextTarget {
3060
- /** Leading glyph/emoji, e.g. "→" or "🎯". */
3061
- icon: string;
3062
- /** Next-session target copy. */
3063
- text: string;
3064
- }
3065
- interface MesoStatusCardProps extends ViewProps {
3066
- /** Mesocycle name, e.g. "Hypertrophy Block". */
3067
- mesoName: string;
3068
- /** Context line, e.g. "Week 6 of 8 · Upper/Lower". */
3069
- mesoSubtitle: string;
3070
- /** Status pill in the header. */
3071
- statusBadge: MesoStatusBadge;
3072
- /** Prescription-vs-actual metrics rendered as a 2x2 grid. */
3073
- metrics: MesoStatusMetric[];
3074
- /** Intensity / volume gauges stacked vertically. */
3075
- gauges: MesoStatusGauge[];
3076
- /** Optional coaching recommendation box. */
3077
- coaching?: MesoStatusCoaching;
3078
- /** Optional next-session target box. */
3079
- nextTarget?: MesoStatusNextTarget;
3080
- className?: string;
3081
- }
3082
- /**
3083
- * Mesocycle context card for a specific exercise: prescription vs actual
3084
- * metrics, intensity/volume gauges, and coaching guidance. Composes the titan
3085
- * `Card` plus the Workout `StatusDot`, and renders the §25 gauge (8px track,
3086
- * 50% center line, 14px marker) inline since that visual differs from the
3087
- * IntensityBar/DeviationBar primitives.
3088
- *
3089
- * @example
3090
- * <MesoStatusCard
3091
- * mesoName="Hypertrophy Block"
3092
- * mesoSubtitle="Week 6 of 8 · Upper/Lower"
3093
- * statusBadge={{ label: 'On Track', variant: 'success' }}
3094
- * metrics={[
3095
- * { label: 'Prescribed', value: '3×8 @ RPE 8' },
3096
- * { label: 'Actual', value: '3×8 @ 185 lbs' },
3097
- * ]}
3098
- * gauges={[{ label: 'Intensity', level: 0.7, sublabel: 'Actual' }]}
3099
- * coaching={{ text: 'Add load next session.', highlights: ['Add load'] }}
3100
- * nextTarget={{ icon: '→', text: '190 lbs × 8' }}
3101
- * />
3102
- */
3103
- declare function MesoStatusCard({ mesoName, mesoSubtitle, statusBadge, metrics, gauges, coaching, nextTarget, className, ...props }: MesoStatusCardProps): react_jsx_runtime.JSX.Element;
3104
-
3105
3035
  interface StrengthTrendDataPoint {
3106
3036
  /** ISO date string for the session. */
3107
3037
  date: string;
@@ -3212,186 +3142,342 @@ interface CapacityBandChartProps extends ViewProps {
3212
3142
  */
3213
3143
  declare function CapacityBandChart({ band, workouts, projection, width, height, onWorkoutPress, className, ...props }: CapacityBandChartProps): react_jsx_runtime.JSX.Element;
3214
3144
 
3215
- /**
3216
- * Full muscle group taxonomy for volume tracking and exercise mapping.
3217
- * 15 groups — the primary unit for volume accounting.
3218
- */
3219
- declare enum MuscleGroup {
3220
- CHEST = "chest",
3221
- FRONT_DELTS = "front_delts",
3222
- SIDE_DELTS = "side_delts",
3223
- TRICEPS = "triceps",
3224
- LATS = "lats",
3225
- UPPER_BACK = "upper_back",
3226
- REAR_DELTS = "rear_delts",
3227
- BICEPS = "biceps",
3228
- FOREARMS = "forearms",
3229
- QUADS = "quads",
3230
- HAMSTRINGS = "hamstrings",
3231
- GLUTES = "glutes",
3232
- CALVES = "calves",
3233
- ABS = "abs",
3234
- OBLIQUES = "obliques"
3235
- }
3236
- /**
3237
- * Simplified muscle group view for beginners. Maps to one or more MuscleGroup.
3238
- */
3239
- declare enum SimpleMuscleGroup {
3240
- CHEST = "chest",
3241
- BACK = "back",
3242
- SHOULDERS = "shoulders",
3243
- BICEPS = "biceps",
3244
- TRICEPS = "triceps",
3245
- LEGS = "legs",
3246
- CORE = "core",
3247
- FOREARMS = "forearms"
3248
- }
3249
- /** Mapping from simplified groups to the full taxonomy. */
3250
- declare const SIMPLE_TO_DETAILED: Record<SimpleMuscleGroup, MuscleGroup[]>;
3251
- /** Reverse map: detailed MuscleGroup -> its SimpleMuscleGroup. */
3252
- declare const DETAILED_TO_SIMPLE: Record<MuscleGroup, SimpleMuscleGroup>;
3253
- /** Movement category for training split organization. */
3254
- type MovementCategory = 'push' | 'pull' | 'legs' | 'core';
3255
- declare const MUSCLE_TO_CATEGORY: Record<MuscleGroup, MovementCategory>;
3256
- /**
3257
- * react-native-body-highlighter slug(s) per muscle group. Phase 1 uses the
3258
- * closest available slug; deltoids share one path and lats/upper-back share
3259
- * `upper-back` (see doc Level 4 "Recommended approach").
3260
- */
3261
- declare const MUSCLE_TO_SVG_SLUGS: Record<MuscleGroup, string[]>;
3262
- /** Human-readable name per muscle group (used in a11y labels). */
3263
- declare const MUSCLE_DISPLAY_NAMES: Record<MuscleGroup, string>;
3264
- /** Human-readable name per simple group. */
3265
- declare const SIMPLE_DISPLAY_NAMES: Record<SimpleMuscleGroup, string>;
3266
- /** Volume landmarks per muscle group (weekly working sets). */
3267
- interface VolumeLandmarks {
3268
- mev: number;
3269
- mav: number;
3270
- mrv: number;
3271
- }
3272
- declare const DEFAULT_VOLUME_LANDMARKS: Record<MuscleGroup, VolumeLandmarks>;
3273
- /** Weekly-volume status relative to MEV/MAV/MRV landmarks. */
3274
- type VolumeStatus = 'under' | 'maintenance' | 'productive' | 'over';
3275
- /** Readable label per status for a11y descriptions. */
3276
- declare const VOLUME_STATUS_LABELS: Record<VolumeStatus, string>;
3277
- /**
3278
- * Maps a volume status (and intensity, 0-1) to a heatmap fill color. The
3279
- * `approaching` token is used when a productive muscle nears its MRV.
3280
- */
3281
- declare function getHeatmapColor(status: VolumeStatus | null | undefined, intensity?: number): string;
3282
-
3283
- interface BodyMapData {
3284
- muscleGroup: MuscleGroup;
3285
- /** Intensity 0-1 for heatmap color. */
3286
- intensity: number;
3287
- /** Volume status for tooltip / heatmap token. */
3288
- volumeStatus: VolumeStatus;
3289
- /** Weekly effective sets. */
3290
- weeklySets: number;
3291
- }
3292
- interface BodyMapProps extends ViewProps {
3293
- /** Muscle group intensity data. */
3294
- data: BodyMapData[];
3295
- /** Which view to show. */
3296
- view: 'front' | 'back';
3297
- /** Toggle between front/back. */
3298
- onViewChange?: (view: 'front' | 'back') => void;
3299
- /** Called when a muscle group is tapped. */
3300
- onMusclePress?: (muscleGroup: MuscleGroup) => void;
3301
- /** Currently highlighted muscle (from external selection). */
3302
- highlightedMuscle?: MuscleGroup | null;
3303
- /** Show simplified (8 groups) or detailed (15 groups). */
3304
- mode?: 'simple' | 'detailed';
3305
- className?: string;
3306
- }
3307
- /**
3308
- * Interactive SVG body map with tappable muscle groups and a volume heatmap.
3309
- * Renders the front or back view (toggle via onViewChange), colors each muscle
3310
- * by its weekly-volume status, and exposes an accessible muscle legend wired to
3311
- * onMusclePress. Phase 1 uses react-native-body-highlighter's combined slugs
3312
- * (deltoids as one path, lats/upper-back shared); swipe between views and the
3313
- * delt/lat SVG split are follow-ups.
3314
- *
3315
- * @example
3316
- * <BodyMap
3317
- * data={[{ muscleGroup: MuscleGroup.CHEST, intensity: 0.7, volumeStatus: 'productive', weeklySets: 12 }]}
3318
- * view="front"
3319
- * onViewChange={setView}
3320
- * onMusclePress={setSelected}
3321
- * highlightedMuscle={selected}
3322
- * />
3323
- */
3324
- declare function BodyMap({ data, view, onViewChange, onMusclePress, highlightedMuscle, mode, className, ...props }: BodyMapProps): react_jsx_runtime.JSX.Element;
3325
-
3326
- interface ContributingExercise {
3327
- /** Exercise name. */
3145
+ /** A single workout within a planned week, plus its exercise breakdown. */
3146
+ interface PlanWorkout {
3147
+ /** Stable identifier used for drill-down selection. */
3148
+ id: string;
3149
+ name: string;
3150
+ date: string;
3151
+ duration?: string;
3152
+ status: WorkoutStatus;
3153
+ muscleGroups: WorkoutMuscleGroup[];
3154
+ totalSets: number;
3155
+ totalVolume?: number;
3156
+ unit: 'lbs' | 'kg';
3157
+ /** Exercises revealed when the workout is opened. */
3158
+ exercises: ExerciseCardProps[];
3159
+ }
3160
+ /** A training week inside a mesocycle. */
3161
+ interface PlanWeek {
3162
+ /** 1-based week index within the mesocycle. */
3163
+ weekNumber: number;
3164
+ /** Planned intensity for the week, 0-1. */
3165
+ intensityLevel: number;
3166
+ /** Optional MRV/overexertion threshold, 0-1. */
3167
+ intensityThreshold?: number;
3168
+ isDeload?: boolean;
3169
+ isCurrent?: boolean;
3170
+ workouts: PlanWorkout[];
3171
+ }
3172
+ /** A mesocycle: the top level of the drill-down. */
3173
+ interface PlanMeso {
3174
+ id: string;
3328
3175
  name: string;
3329
- /** Working sets contributed this week. */
3330
- sets: number;
3331
- /** Effective-set multiplier toward this muscle (0-1). */
3332
- contributionWeight: number;
3176
+ goal: string;
3177
+ split: string;
3178
+ weekRange: string;
3179
+ weekCount: number;
3180
+ currentWeek?: number;
3181
+ status: MesoStatus;
3182
+ volumeHeatmap?: MesoVolumeHeatmapEntry[];
3183
+ weeks: PlanWeek[];
3184
+ }
3185
+ /** Current depth of the meso -> week -> workout drill-down. */
3186
+ type ProgramNavLevel = 'meso' | 'week' | 'workout';
3187
+ /** The navigation cursor within the active mesocycle. */
3188
+ interface ProgramSelection {
3189
+ weekNumber: number | null;
3190
+ workoutId: string | null;
3191
+ }
3192
+ /** One tappable step in the breadcrumb trail. */
3193
+ interface ProgramBreadcrumb {
3194
+ key: string;
3195
+ label: string;
3196
+ level: ProgramNavLevel;
3333
3197
  }
3334
- interface UpcomingExercise {
3335
- /** Exercise name. */
3198
+ interface ProgramPlanningPageProps extends ViewProps {
3199
+ /** Page heading. */
3200
+ title?: string;
3201
+ /** Mesocycles that make up the program. */
3202
+ mesos: PlanMeso[];
3203
+ className?: string;
3204
+ }
3205
+ /** Derive the current drill-down level from the selection cursor (pure). */
3206
+ declare function deriveNavLevel(selection: ProgramSelection): ProgramNavLevel;
3207
+ /** Project the mesocycles onto MesoProgressBar segment data (pure). */
3208
+ declare function toProgressBarMesos(mesos: PlanMeso[]): Meso[];
3209
+ /** Look up a meso by id, or null. */
3210
+ declare function findMeso(mesos: PlanMeso[], id: string | null): PlanMeso | null;
3211
+ /** Look up a week within a meso, or null. */
3212
+ declare function findWeek(meso: PlanMeso | null, weekNumber: number | null): PlanWeek | null;
3213
+ /** Look up a workout within a week, or null. */
3214
+ declare function findWorkout(week: PlanWeek | null, workoutId: string | null): PlanWorkout | null;
3215
+ /** Build the breadcrumb trail for the active drill path (pure). */
3216
+ declare function buildBreadcrumbs(meso: PlanMeso, weekNumber: number | null, workout: PlanWorkout | null): ProgramBreadcrumb[];
3217
+ /**
3218
+ * ProgramPlanningPage — a meso -> week -> workout drill-down over an entire
3219
+ * training program. A `MesoProgressBar` pins the mesocycle timeline to the top;
3220
+ * the body swaps between three levels: expandable `MesoCard`s (with inline
3221
+ * `WeekRow`s), a week's `WorkoutCard` list, and a single opened `WorkoutCard`
3222
+ * with inline `ExerciseCard` expansion. A breadcrumb trail tracks and rewinds
3223
+ * the drill path. Selection is page-level state; children keep their own styles.
3224
+ *
3225
+ * @example
3226
+ * <ProgramPlanningPage mesos={mesos} />
3227
+ */
3228
+ declare function ProgramPlanningPage({ title, mesos, className, ...props }: ProgramPlanningPageProps): react_jsx_runtime.JSX.Element;
3229
+
3230
+ /** Which tab of the exercise detail view is showing. */
3231
+ type ExerciseDetailTab = 'progress' | 'history' | 'advanced';
3232
+ /** Tabs in display order. */
3233
+ declare const EXERCISE_DETAIL_TABS: Array<{
3234
+ key: ExerciseDetailTab;
3235
+ label: string;
3236
+ }>;
3237
+ /** Identity + headline stats for the exercise being inspected. */
3238
+ interface ExerciseDetailHeader {
3239
+ /** Exercise name, e.g. "Barbell Bench Press". */
3336
3240
  name: string;
3337
- /** Workout the exercise belongs to. */
3338
- workoutName: string;
3339
- /** Planned sets. */
3340
- sets: number;
3341
- }
3342
- interface BodyMapDetailPanelProps extends ViewProps {
3343
- /** Muscle group whose volume detail is shown. */
3344
- muscleGroup: MuscleGroup;
3345
- /** Human-readable muscle name for the title and a11y label. */
3346
- displayName: string;
3347
- /** Weekly effective sets logged for this muscle. */
3348
- weeklySets: number;
3349
- /** Volume landmarks (weekly working sets). */
3350
- landmarks: VolumeLandmarks;
3351
- /** Weekly-volume status relative to the landmarks. */
3352
- volumeStatus: VolumeStatus;
3353
- /** Last trained label, e.g. "2 days ago". */
3354
- lastTrained?: string;
3355
- /** Volume sparkline data (last 4-8 weeks). */
3356
- weeklyHistory?: number[];
3357
- /** Exercises contributing to this muscle's volume. */
3358
- contributingExercises?: ContributingExercise[];
3359
- /** Upcoming exercises targeting this muscle. */
3360
- upcomingExercises?: UpcomingExercise[];
3361
- /** Whether the bottom sheet is visible. */
3362
- isOpen?: boolean;
3363
- /** Alias for `isOpen` (spec wording: "isOpen/visible"). `isOpen` wins when both are set. */
3364
- visible?: boolean;
3365
- /** Dismiss the panel (backdrop, handle, or close button). */
3366
- onClose: () => void;
3367
- /** Navigate to a filtered exercise list. */
3368
- onViewExercises?: () => void;
3241
+ /** Context line, e.g. "Chest · Barbell". */
3242
+ subtitle: string;
3243
+ /** Unit used across the page. */
3244
+ unit: 'lbs' | 'kg';
3245
+ /** Current estimated one-rep max, shown as a header pill. */
3246
+ currentE1rm?: number;
3369
3247
  }
3370
3248
  /**
3371
- * Slide-up bottom-sheet panel with detailed weekly-volume info for a tapped
3372
- * muscle group: a MEV|current|MRV gradient progress bar, the big weekly set
3373
- * count against MRV, an optional volume sparkline, and the contributing /
3374
- * upcoming exercise lists. Composes the titan `Badge` and Workout `Sparkline`.
3375
- *
3376
- * Controlled via `isOpen` (or the `visible` alias); renders nothing when closed
3377
- * and animates in on open — sheet translateY 400->0 (400ms ease-out) and a
3378
- * backdrop fade 0->0.4 (RN Animated, useNativeDriver:false). Backdrop, handle,
3379
- * and the header close button all call `onClose`.
3380
- *
3381
- * @example
3382
- * <BodyMapDetailPanel
3383
- * muscleGroup={MuscleGroup.CHEST}
3384
- * displayName="Chest"
3385
- * weeklySets={14}
3386
- * landmarks={{ mev: 8, mav: 14, mrv: 20 }}
3387
- * volumeStatus="productive"
3388
- * lastTrained="2 days ago"
3389
- * weeklyHistory={[8, 10, 12, 14]}
3390
- * isOpen={open}
3391
- * onClose={() => setOpen(false)}
3249
+ * A single expandable entry one progression week or one logged session.
3250
+ * Projected onto an `ExerciseCard`, so it collapses to a summary and expands
3251
+ * to its `SetRow` breakdown.
3252
+ */
3253
+ interface ExerciseDetailEntry {
3254
+ /** Stable id for inline-expansion selection. */
3255
+ id: string;
3256
+ /** Row title, e.g. "Week 3" or "Mon, Jun 16". */
3257
+ title: string;
3258
+ /** Collapsed summary (sets × reps @ weight). */
3259
+ summary?: ExerciseCardProps['summary'];
3260
+ /** Estimated one-rep max badge. */
3261
+ e1rm?: ExerciseCardProps['e1rm'];
3262
+ /** Flags a personal-record entry. */
3263
+ isPR?: boolean;
3264
+ /** Prescribed tempo, revealed when expanded. */
3265
+ tempo?: ExerciseCardProps['tempo'];
3266
+ /** Per-set breakdown revealed when expanded. */
3267
+ sets: SetRowProps[];
3268
+ }
3269
+ /** Strength-trend inputs for the Progress tab chart. */
3270
+ interface ExerciseTrend {
3271
+ /** Measured e1RM data points, chronological. */
3272
+ data: StrengthTrendDataPoint[];
3273
+ /** Planned/projected trajectory (dashed line). */
3274
+ projection?: StrengthTrendDataPoint[];
3275
+ /** Mesocycle boundary guides. */
3276
+ mesoBoundaries?: StrengthTrendChartMesoBoundary[];
3277
+ }
3278
+ /** One set's velocity trace for the Advanced tab breakdown. */
3279
+ interface ExerciseVbtSet {
3280
+ /** Row label, e.g. "Set 1". */
3281
+ label: string;
3282
+ /** Per-rep mean concentric velocities (m/s). */
3283
+ velocities: number[];
3284
+ }
3285
+ /** Velocity-based-training inputs for the Advanced tab. */
3286
+ interface ExerciseVbt {
3287
+ /** Capacity band shape over time. */
3288
+ band: CapacityBandDataPoint[];
3289
+ /** Sessions plotted against the band. */
3290
+ workouts: WorkoutDot[];
3291
+ /** Optional forward band projection. */
3292
+ projection?: CapacityBandProjection;
3293
+ /** Per-set velocity traces for the most recent session. */
3294
+ sets: ExerciseVbtSet[];
3295
+ }
3296
+ /** Page-level roll-up of the logged sessions. */
3297
+ interface ExerciseDetailStats {
3298
+ /** Number of logged sessions. */
3299
+ sessions: number;
3300
+ /** Best estimated one-rep max seen, or null if none recorded. */
3301
+ bestE1rm: number | null;
3302
+ /** Count of PR entries. */
3303
+ prCount: number;
3304
+ }
3305
+ /** Aggregate velocity readout for the Advanced tab. */
3306
+ interface VbtSummary {
3307
+ /** Mean concentric velocity across every logged rep. */
3308
+ meanVelocity: number;
3309
+ /** Worst within-set velocity loss (%), i.e. the most-fatigued set. */
3310
+ velocityLoss: number;
3311
+ }
3312
+ interface ExerciseDetailPageProps extends ViewProps {
3313
+ /** Exercise identity + headline stats. */
3314
+ exercise: ExerciseDetailHeader;
3315
+ /** Mesocycle context banner (Progress tab). */
3316
+ meso: MesoStatusCardProps;
3317
+ /** Strength trend inputs (Progress tab). */
3318
+ trend: ExerciseTrend;
3319
+ /** Week-by-week progression entries (Progress tab). */
3320
+ progression: ExerciseDetailEntry[];
3321
+ /** All logged sessions (History tab). */
3322
+ history: ExerciseDetailEntry[];
3323
+ /** Velocity-based-training inputs (Advanced tab). */
3324
+ vbt: ExerciseVbt;
3325
+ className?: string;
3326
+ }
3327
+ /** Roll up logged sessions into the page summary (pure, testable). */
3328
+ declare function deriveExerciseStats(entries: ExerciseDetailEntry[]): ExerciseDetailStats;
3329
+ /** Project an entry onto ExerciseCard props, wiring inline expansion (pure). */
3330
+ declare function toExerciseCardProps(entry: ExerciseDetailEntry, expanded: boolean, onToggle: () => void): ExerciseCardProps;
3331
+ /** Aggregate per-set velocity traces into the Advanced readout (pure). */
3332
+ declare function summarizeVbt(sets: ExerciseVbtSet[]): VbtSummary;
3333
+ /**
3334
+ * ExerciseDetailPage — a tabbed per-exercise view. A shared header (name,
3335
+ * context line, current e1RM pill) sits above a Progress / History / Advanced
3336
+ * tab bar. Progress composes the `MesoStatusCard` context banner, a stats
3337
+ * strip, a `StrengthTrendChart`, and a week-by-week progression list with
3338
+ * inline `ExerciseCard` expansion. History lists every logged session with the
3339
+ * same inline expansion. Advanced surfaces VBT data via a `CapacityBandChart`,
3340
+ * a velocity summary, and a per-set `VelocityStrip` breakdown. Tab and
3341
+ * per-list expansion are page-level state; children keep their own styles.
3342
+ *
3343
+ * @example
3344
+ * <ExerciseDetailPage
3345
+ * exercise={exercise}
3346
+ * meso={meso}
3347
+ * trend={trend}
3348
+ * progression={progression}
3349
+ * history={history}
3350
+ * vbt={vbt}
3392
3351
  * />
3393
3352
  */
3394
- declare function BodyMapDetailPanel({ muscleGroup, displayName, weeklySets, landmarks, volumeStatus, lastTrained, weeklyHistory, contributingExercises, upcomingExercises, isOpen, visible, onClose, onViewExercises, ...props }: BodyMapDetailPanelProps): react_jsx_runtime.JSX.Element | null;
3353
+ declare function ExerciseDetailPage({ exercise, meso, trend, progression, history, vbt, className, ...props }: ExerciseDetailPageProps): react_jsx_runtime.JSX.Element;
3354
+
3355
+ /** Where an exercise sits in the during-workout flow. */
3356
+ type ActiveExerciseStatus = 'completed' | 'active' | 'upcoming';
3357
+ /**
3358
+ * One exercise in the running workout. Projected onto an `ExerciseCard`, whose
3359
+ * visual state is driven by `status` and the page's zoom focus: completed and
3360
+ * active exercises collapse/expand, upcoming ones stay dimmed.
3361
+ */
3362
+ interface ActiveWorkoutExercise {
3363
+ /** Stable id for zoom-focus selection. */
3364
+ id: string;
3365
+ /** Exercise name, e.g. "Barbell Bench Press". */
3366
+ name: string;
3367
+ /** Position in the workout flow. */
3368
+ status: ActiveExerciseStatus;
3369
+ /** Unit used for this exercise's loads. */
3370
+ unit: 'lbs' | 'kg';
3371
+ /** Total sets prescribed for this exercise. */
3372
+ totalPlannedSets: number;
3373
+ /** Collapsed summary (sets × reps @ weight) for a completed exercise. */
3374
+ summary?: ExerciseCardProps['summary'];
3375
+ /** Estimated one-rep max badge. */
3376
+ e1rm?: ExerciseCardProps['e1rm'];
3377
+ /** Flags a personal-record exercise. */
3378
+ isPR?: boolean;
3379
+ /** Prescribed tempo, revealed when expanded. */
3380
+ tempo?: ExerciseCardProps['tempo'];
3381
+ /** Per-rep velocities for each logged set (drives collapsed strips + set count). */
3382
+ setVelocities?: number[][];
3383
+ /** Per-set breakdown revealed when expanded. */
3384
+ sets?: SetRowProps[];
3385
+ /** One-line prescription for an upcoming exercise. */
3386
+ prescription?: string;
3387
+ /** Previous-best hint for an upcoming exercise. */
3388
+ previousBest?: string;
3389
+ /** Groups consecutive exercises under a shared `SupersetWrapper`. */
3390
+ supersetId?: string;
3391
+ }
3392
+ /** A superset grouping consecutive exercises that share its id. */
3393
+ interface ActiveWorkoutSuperset {
3394
+ /** Matches `ActiveWorkoutExercise.supersetId`. */
3395
+ id: string;
3396
+ /** Corner badge label, e.g. "SS1". */
3397
+ label: string;
3398
+ /** Accent color for the wrapper rail + label. */
3399
+ color?: string;
3400
+ }
3401
+ /** Live-set inputs shown in the bottom `InputBar`. */
3402
+ interface ActiveWorkoutInput {
3403
+ /** Current reps field value. */
3404
+ reps: string;
3405
+ /** Current weight field value. */
3406
+ weight: string;
3407
+ }
3408
+ /** Rest-timer inputs shown in the bottom `RestTimer`. */
3409
+ interface ActiveWorkoutRest {
3410
+ /** Prescribed rest length, seconds. */
3411
+ totalSeconds: number;
3412
+ /** Elapsed rest, milliseconds. */
3413
+ elapsedMs: number;
3414
+ /** Next-set hint, e.g. "Set 3 · 8 × 195 lbs". */
3415
+ nextSetInfo?: string;
3416
+ }
3417
+ /** Derived, page-level roll-up of workout progress. */
3418
+ interface WorkoutProgress {
3419
+ /** Number of exercises marked completed. */
3420
+ completedExercises: number;
3421
+ /** Total exercises in the workout. */
3422
+ totalExercises: number;
3423
+ /** Sets logged so far across all exercises. */
3424
+ completedSets: number;
3425
+ /** Total sets prescribed across all exercises. */
3426
+ totalSets: number;
3427
+ /** Fraction of prescribed sets logged, 0-1. */
3428
+ fraction: number;
3429
+ }
3430
+ /** An ordered render group: a lone exercise or a superset of exercises. */
3431
+ type WorkoutGroup = {
3432
+ type: 'single';
3433
+ exercise: ActiveWorkoutExercise;
3434
+ } | {
3435
+ type: 'superset';
3436
+ superset: ActiveWorkoutSuperset;
3437
+ exercises: ActiveWorkoutExercise[];
3438
+ };
3439
+ interface ActiveWorkoutPageProps extends ViewProps {
3440
+ /** Workout name shown in the header. */
3441
+ title?: string;
3442
+ /** Context line under the title, e.g. "Push Day A · Week 6". */
3443
+ subtitle?: string;
3444
+ /** Exercises in flow order. */
3445
+ exercises: ActiveWorkoutExercise[];
3446
+ /** Superset groupings referenced by `exercise.supersetId`. */
3447
+ supersets?: ActiveWorkoutSuperset[];
3448
+ /** Seed reps/weight for the live `InputBar`. */
3449
+ input?: ActiveWorkoutInput;
3450
+ /** Rest-timer state; when resting, the timer replaces the input bar. */
3451
+ rest?: ActiveWorkoutRest;
3452
+ /** Start the page in the resting state (timer showing). */
3453
+ initialResting?: boolean;
3454
+ className?: string;
3455
+ }
3456
+ /** Count the sets logged for an exercise (pure). */
3457
+ declare function countCompletedSets(exercise: ActiveWorkoutExercise): number;
3458
+ /** Roll up the exercises into the header progress readout (pure, testable). */
3459
+ declare function deriveWorkoutProgress(exercises: ActiveWorkoutExercise[]): WorkoutProgress;
3460
+ /** The active exercise anchors the bottom bar; find it, or null (pure). */
3461
+ declare function findActiveExercise(exercises: ActiveWorkoutExercise[]): ActiveWorkoutExercise | null;
3462
+ /** Map an exercise's status + focus onto an `ExerciseCard` visual state (pure). */
3463
+ declare function statusToCardState(status: ActiveExerciseStatus, focused: boolean): ExerciseCardState;
3464
+ /** Project an exercise onto ExerciseCard props, wiring zoom focus (pure). */
3465
+ declare function toActiveCardProps(exercise: ActiveWorkoutExercise, focused: boolean, onToggle: () => void, supersetPosition?: ExerciseCardProps['supersetPosition'], supersetColor?: string): ExerciseCardProps;
3466
+ /** Fold consecutive same-superset exercises into render groups (pure). */
3467
+ declare function groupExercises(exercises: ActiveWorkoutExercise[], supersets: ActiveWorkoutSuperset[]): WorkoutGroup[];
3468
+ /**
3469
+ * ActiveWorkoutPage — the during-workout screen, built as a zoom hierarchy over
3470
+ * `ExerciseCard`s. A header progress bar rolls up completed sets; the flow list
3471
+ * dims upcoming exercises, collapses finished ones to their velocity strips, and
3472
+ * expands exactly one focused exercise to its `SetRow` breakdown. Consecutive
3473
+ * superset exercises stitch together inside a `SupersetWrapper`. A pinned bottom
3474
+ * bar toggles between the live `InputBar` (log the next set) and the `RestTimer`.
3475
+ * Focus and rest are page-level state; children keep their own styles.
3476
+ *
3477
+ * @example
3478
+ * <ActiveWorkoutPage title="Push Day A" exercises={exercises} />
3479
+ */
3480
+ declare function ActiveWorkoutPage({ title, subtitle, exercises, supersets, input, rest, initialResting, className, ...props }: ActiveWorkoutPageProps): react_jsx_runtime.JSX.Element;
3395
3481
 
3396
3482
  interface TreemapDatum {
3397
3483
  /** Stable identity — returned by onPress and used as the React key. */
@@ -3684,4 +3770,44 @@ type FormErrors<T extends FormValues> = Partial<Record<keyof T, string>>;
3684
3770
  */
3685
3771
  type FormTouched<T extends FormValues> = Partial<Record<keyof T, boolean>>;
3686
3772
 
3687
- 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, BaseBadge, type BaseBadgeProps, type BaseBadgeSize, type BaseBadgeVariant, BodyMap, type BodyMapData, BodyMapDetailPanel, type BodyMapDetailPanelProps, type BodyMapProps, 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, type ContributingExercise, DEFAULT_VOLUME_LANDMARKS, DETAILED_TO_SIMPLE, 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, ElevationLevel, EmptyState, type EmptyStateProps, ExerciseCard, type ExerciseCardProps, type ExerciseCardState, 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, MUSCLE_DISPLAY_NAMES, MUSCLE_TO_CATEGORY, MUSCLE_TO_SVG_SLUGS, 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, type MesoStatusBadge, type MesoStatusBadgeVariant, MesoStatusCard, type MesoStatusCardProps, type MesoStatusCoaching, type MesoStatusGauge, type MesoStatusMetric, type MesoStatusNextTarget, 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, type MovementCategory, MuscleGroup, 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, Popover, PopoverCloseButton, type PopoverCloseButtonProps, PopoverContent, type PopoverContentProps, type PopoverPlacement, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, PrBadge, type PrBadgeProps, PrHistoryModal, type PrHistoryModalProps, type PrRecord, type PrRecordType, 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, SIMPLE_DISPLAY_NAMES, SIMPLE_TO_DETAILED, 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, SimpleMuscleGroup, 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 UpcomingExercise, type UseTableOptions, type UseTableReturn, VOLUME_STATUS_LABELS, VStack, VelocityStrip, type VelocityStripProps, type VolumeLandmarks, type VolumeStatus$1 as VolumeStatus, type WarmUpStatus, type WarmUpValidation, WeekRow, type WeekRowProps, type WeekRowWorkout, WeightBadge, type WeightBadgeProps, type WeightBadgeSize, WorkoutCard, type WorkoutCardProps, type WorkoutDot, type WorkoutDotStatus, type WorkoutMuscleGroup, type WorkoutMuscleVolumeStatus, WorkoutPill, type WorkoutPillProps, type WorkoutPillStatus, type WorkoutStatus, alpha, calculateMeanVelocity, calculateVelocityLoss, cn, composeValidators, createFieldId, formatDateTime, getContrastText, getFieldAriaProps, getFieldValidationProps, getHeatmapColor, getLuminance, getResultColor, getStatusColor, getVelocityZoneColor, getVelocityZoneName, hasMaxLength, hasMinLength, isEmpty, isValidEmail, useTable, useToast, useToolbarButton, validationRules };
3773
+ /**
3774
+ * Presentation helpers for workout metrics.
3775
+ *
3776
+ * The data layer (`@voltras/workout-analytics` view-model derivations) supplies
3777
+ * EXACT, unrounded values; these turn them into the rounded / banded / formatted
3778
+ * forms a view renders. Keeping display munging here — in the design system, not
3779
+ * the analytics layer — is the render half of the model↔render split: one view
3780
+ * can round while another (or a hover) shows the exact value from the same real
3781
+ * data. Workout components consume these so the rules live in one place.
3782
+ */
3783
+ /** Round an exact RPE onto its conventional 0.5 granularity for display. */
3784
+ declare function roundRpe(rpe: number): number;
3785
+ /**
3786
+ * Color band for an RPE on the canonical performance scale. Higher RPE = harder
3787
+ * = red (direction inverted vs velocity, which shares the same scale). Bands:
3788
+ * `<7` green, `7–8.5` yellow, `8.5–9.5` orange, `≥9.5` red.
3789
+ */
3790
+ declare function rpeColor(rpe: number): string;
3791
+ /** Round a weight or e1RM to a whole unit for compact display. */
3792
+ declare function roundWeight(weight: number): number;
3793
+ /** Format an exact velocity (m/s) to the 2-dp string shown on the velocity strip. */
3794
+ declare function formatVelocity(velocity: number): string;
3795
+ /** Round an exact tempo tuple (seconds) to 1 dp per phase for display. */
3796
+ declare function roundTempo(tempo: [number, number, number, number]): [number, number, number, number];
3797
+ /** Signed percentage label for a deviation ratio, e.g. `+9%` / `-5%` / `0%`. */
3798
+ declare function formatSignedPct(ratio: number): string;
3799
+ /** Structured prescription for the active exercise (from the plan). */
3800
+ interface PrescriptionInput {
3801
+ repsLow?: number;
3802
+ repsHigh?: number;
3803
+ weightLbs?: number;
3804
+ rpe?: number;
3805
+ }
3806
+ /**
3807
+ * Human prescription string, e.g. `"8–10 @ 62 lb · RPE 8"`. `null` when there is
3808
+ * nothing to show. Presentation-only: the plan supplies the numbers, this shapes
3809
+ * the label.
3810
+ */
3811
+ declare function formatPrescription(p: PrescriptionInput | null | undefined): string | null;
3812
+
3813
+ 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 };