@titan-design/react-ui 0.4.0 → 0.5.0

package/dist/MesoStatusCard-CQk71hSi.d.mts

@@ -0,0 +1,77 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ViewProps } from 'react-native';
+
+type MesoStatusBadgeVariant = 'success' | 'warning' | 'error';
+interface MesoStatusBadge {
+    /** Short status label, e.g. "On Track". */
+    label: string;
+    /** Color treatment for the badge. */
+    variant: MesoStatusBadgeVariant;
+}
+interface MesoStatusMetric {
+    /** Cell label, e.g. "Prescribed". */
+    label: string;
+    /** Cell value, e.g. "3×8 @ RPE 8". */
+    value: string;
+}
+interface MesoStatusGauge {
+    /** Gauge label, e.g. "Intensity". */
+    label: string;
+    /** Fill position 0-1; the 14px marker sits at this level. */
+    level: number;
+    /** Optional right-aligned sublabel, e.g. "Prescribed". */
+    sublabel?: string;
+}
+interface MesoStatusCoaching {
+    /** Coaching recommendation copy. */
+    text: string;
+    /** Substrings within `text` to render in bold. */
+    highlights?: string[];
+}
+interface MesoStatusNextTarget {
+    /** Leading glyph/emoji, e.g. "→" or "🎯". */
+    icon: string;
+    /** Next-session target copy. */
+    text: string;
+}
+interface MesoStatusCardProps extends ViewProps {
+    /** Mesocycle name, e.g. "Hypertrophy Block". */
+    mesoName: string;
+    /** Context line, e.g. "Week 6 of 8 · Upper/Lower". */
+    mesoSubtitle: string;
+    /** Status pill in the header. */
+    statusBadge: MesoStatusBadge;
+    /** Prescription-vs-actual metrics rendered as a 2x2 grid. */
+    metrics: MesoStatusMetric[];
+    /** Intensity / volume gauges stacked vertically. */
+    gauges: MesoStatusGauge[];
+    /** Optional coaching recommendation box. */
+    coaching?: MesoStatusCoaching;
+    /** Optional next-session target box. */
+    nextTarget?: MesoStatusNextTarget;
+    className?: string;
+}
+/**
+ * Mesocycle context card for a specific exercise: prescription vs actual
+ * metrics, intensity/volume gauges, and coaching guidance. Composes the titan
+ * `Card` plus the Workout `StatusDot`, and renders the §25 gauge (8px track,
+ * 50% center line, 14px marker) inline since that visual differs from the
+ * IntensityBar/DeviationBar primitives.
+ *
+ * @example
+ * <MesoStatusCard
+ *   mesoName="Hypertrophy Block"
+ *   mesoSubtitle="Week 6 of 8 · Upper/Lower"
+ *   statusBadge={{ label: 'On Track', variant: 'success' }}
+ *   metrics={[
+ *     { label: 'Prescribed', value: '3×8 @ RPE 8' },
+ *     { label: 'Actual', value: '3×8 @ 185 lbs' },
+ *   ]}
+ *   gauges={[{ label: 'Intensity', level: 0.7, sublabel: 'Actual' }]}
+ *   coaching={{ text: 'Add load next session.', highlights: ['Add load'] }}
+ *   nextTarget={{ icon: '→', text: '190 lbs × 8' }}
+ * />
+ */
+declare function MesoStatusCard({ mesoName, mesoSubtitle, statusBadge, metrics, gauges, coaching, nextTarget, className, ...props }: MesoStatusCardProps): react_jsx_runtime.JSX.Element;
+
+export { type MesoStatusBadge as M, type MesoStatusBadgeVariant as a, MesoStatusCard as b, type MesoStatusCardProps as c, type MesoStatusCoaching as d, type MesoStatusGauge as e, type MesoStatusMetric as f, type MesoStatusNextTarget as g };

package/dist/MesoStatusCard-CQk71hSi.d.ts

@@ -0,0 +1,77 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ViewProps } from 'react-native';
+
+type MesoStatusBadgeVariant = 'success' | 'warning' | 'error';
+interface MesoStatusBadge {
+    /** Short status label, e.g. "On Track". */
+    label: string;
+    /** Color treatment for the badge. */
+    variant: MesoStatusBadgeVariant;
+}
+interface MesoStatusMetric {
+    /** Cell label, e.g. "Prescribed". */
+    label: string;
+    /** Cell value, e.g. "3×8 @ RPE 8". */
+    value: string;
+}
+interface MesoStatusGauge {
+    /** Gauge label, e.g. "Intensity". */
+    label: string;
+    /** Fill position 0-1; the 14px marker sits at this level. */
+    level: number;
+    /** Optional right-aligned sublabel, e.g. "Prescribed". */
+    sublabel?: string;
+}
+interface MesoStatusCoaching {
+    /** Coaching recommendation copy. */
+    text: string;
+    /** Substrings within `text` to render in bold. */
+    highlights?: string[];
+}
+interface MesoStatusNextTarget {
+    /** Leading glyph/emoji, e.g. "→" or "🎯". */
+    icon: string;
+    /** Next-session target copy. */
+    text: string;
+}
+interface MesoStatusCardProps extends ViewProps {
+    /** Mesocycle name, e.g. "Hypertrophy Block". */
+    mesoName: string;
+    /** Context line, e.g. "Week 6 of 8 · Upper/Lower". */
+    mesoSubtitle: string;
+    /** Status pill in the header. */
+    statusBadge: MesoStatusBadge;
+    /** Prescription-vs-actual metrics rendered as a 2x2 grid. */
+    metrics: MesoStatusMetric[];
+    /** Intensity / volume gauges stacked vertically. */
+    gauges: MesoStatusGauge[];
+    /** Optional coaching recommendation box. */
+    coaching?: MesoStatusCoaching;
+    /** Optional next-session target box. */
+    nextTarget?: MesoStatusNextTarget;
+    className?: string;
+}
+/**
+ * Mesocycle context card for a specific exercise: prescription vs actual
+ * metrics, intensity/volume gauges, and coaching guidance. Composes the titan
+ * `Card` plus the Workout `StatusDot`, and renders the §25 gauge (8px track,
+ * 50% center line, 14px marker) inline since that visual differs from the
+ * IntensityBar/DeviationBar primitives.
+ *
+ * @example
+ * <MesoStatusCard
+ *   mesoName="Hypertrophy Block"
+ *   mesoSubtitle="Week 6 of 8 · Upper/Lower"
+ *   statusBadge={{ label: 'On Track', variant: 'success' }}
+ *   metrics={[
+ *     { label: 'Prescribed', value: '3×8 @ RPE 8' },
+ *     { label: 'Actual', value: '3×8 @ 185 lbs' },
+ *   ]}
+ *   gauges={[{ label: 'Intensity', level: 0.7, sublabel: 'Actual' }]}
+ *   coaching={{ text: 'Add load next session.', highlights: ['Add load'] }}
+ *   nextTarget={{ icon: '→', text: '190 lbs × 8' }}
+ * />
+ */
+declare function MesoStatusCard({ mesoName, mesoSubtitle, statusBadge, metrics, gauges, coaching, nextTarget, className, ...props }: MesoStatusCardProps): react_jsx_runtime.JSX.Element;
+
+export { type MesoStatusBadge as M, type MesoStatusBadgeVariant as a, MesoStatusCard as b, type MesoStatusCardProps as c, type MesoStatusCoaching as d, type MesoStatusGauge as e, type MesoStatusMetric as f, type MesoStatusNextTarget as g };

package/dist/bodymap.d.mts

@@ -1,3 +1,246 @@
-export { n as BodyMap, B as BodyMapData, o as BodyMapDetailPanel, a as BodyMapDetailPanelProps, b as BodyMapProps, C as ContributingExercise, D as DEFAULT_VOLUME_LANDMARKS, p as DETAILED_TO_SIMPLE, q as MUSCLE_DISPLAY_NAMES, r as MUSCLE_TO_CATEGORY, s as MUSCLE_TO_SVG_SLUGS, j as MovementCategory, k as MuscleGroup, t as SIMPLE_DISPLAY_NAMES, u as SIMPLE_TO_DETAILED, S as SimpleMuscleGroup, T as TrainingStatusMuscle, v as TrainingStatusPage, l as TrainingStatusPageProps, m as TrainingStatusSummary, U as UpcomingExercise, w as VOLUME_STATUS_LABELS, V as VolumeLandmarks, x as deriveTrainingSummary, y as getHeatmapColor, z as toBodyMapData } from './bodymap-BhG55xHM.mjs';
-import 'react/jsx-runtime';
-import 'react-native';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ViewProps } from 'react-native';
+import { c as MesoStatusCardProps } from './MesoStatusCard-CQk71hSi.mjs';
+
+/**
+ * Full muscle group taxonomy for volume tracking and exercise mapping.
+ * 15 groups — the primary unit for volume accounting.
+ */
+declare enum MuscleGroup {
+    CHEST = "chest",
+    FRONT_DELTS = "front_delts",
+    SIDE_DELTS = "side_delts",
+    TRICEPS = "triceps",
+    LATS = "lats",
+    UPPER_BACK = "upper_back",
+    REAR_DELTS = "rear_delts",
+    BICEPS = "biceps",
+    FOREARMS = "forearms",
+    QUADS = "quads",
+    HAMSTRINGS = "hamstrings",
+    GLUTES = "glutes",
+    CALVES = "calves",
+    ABS = "abs",
+    OBLIQUES = "obliques"
+}
+/**
+ * Simplified muscle group view for beginners. Maps to one or more MuscleGroup.
+ */
+declare enum SimpleMuscleGroup {
+    CHEST = "chest",
+    BACK = "back",
+    SHOULDERS = "shoulders",
+    BICEPS = "biceps",
+    TRICEPS = "triceps",
+    LEGS = "legs",
+    CORE = "core",
+    FOREARMS = "forearms"
+}
+/** Mapping from simplified groups to the full taxonomy. */
+declare const SIMPLE_TO_DETAILED: Record<SimpleMuscleGroup, MuscleGroup[]>;
+/** Reverse map: detailed MuscleGroup -> its SimpleMuscleGroup. */
+declare const DETAILED_TO_SIMPLE: Record<MuscleGroup, SimpleMuscleGroup>;
+/** Movement category for training split organization. */
+type MovementCategory = 'push' | 'pull' | 'legs' | 'core';
+declare const MUSCLE_TO_CATEGORY: Record<MuscleGroup, MovementCategory>;
+/**
+ * react-native-body-highlighter slug(s) per muscle group. Phase 1 uses the
+ * closest available slug; deltoids share one path and lats/upper-back share
+ * `upper-back` (see doc Level 4 "Recommended approach").
+ */
+declare const MUSCLE_TO_SVG_SLUGS: Record<MuscleGroup, string[]>;
+/** Human-readable name per muscle group (used in a11y labels). */
+declare const MUSCLE_DISPLAY_NAMES: Record<MuscleGroup, string>;
+/** Human-readable name per simple group. */
+declare const SIMPLE_DISPLAY_NAMES: Record<SimpleMuscleGroup, string>;
+/** Volume landmarks per muscle group (weekly working sets). */
+interface VolumeLandmarks {
+    mev: number;
+    mav: number;
+    mrv: number;
+}
+declare const DEFAULT_VOLUME_LANDMARKS: Record<MuscleGroup, VolumeLandmarks>;
+/** Weekly-volume status relative to MEV/MAV/MRV landmarks. */
+type VolumeStatus = 'under' | 'maintenance' | 'productive' | 'over';
+/** Readable label per status for a11y descriptions. */
+declare const VOLUME_STATUS_LABELS: Record<VolumeStatus, string>;
+/**
+ * Maps a volume status (and intensity, 0-1) to a heatmap fill color. The
+ * `approaching` token is used when a productive muscle nears its MRV.
+ */
+declare function getHeatmapColor(status: VolumeStatus | null | undefined, intensity?: number): string;
+
+interface BodyMapData {
+    muscleGroup: MuscleGroup;
+    /** Intensity 0-1 for heatmap color. */
+    intensity: number;
+    /** Volume status for tooltip / heatmap token. */
+    volumeStatus: VolumeStatus;
+    /** Weekly effective sets. */
+    weeklySets: number;
+}
+interface BodyMapProps extends ViewProps {
+    /** Muscle group intensity data. */
+    data: BodyMapData[];
+    /** Which view to show. */
+    view: 'front' | 'back';
+    /** Toggle between front/back. */
+    onViewChange?: (view: 'front' | 'back') => void;
+    /** Called when a muscle group is tapped. */
+    onMusclePress?: (muscleGroup: MuscleGroup) => void;
+    /** Currently highlighted muscle (from external selection). */
+    highlightedMuscle?: MuscleGroup | null;
+    /** Show simplified (8 groups) or detailed (15 groups). */
+    mode?: 'simple' | 'detailed';
+    className?: string;
+}
+/**
+ * Interactive SVG body map with tappable muscle groups and a volume heatmap.
+ * Renders the front or back view (toggle via onViewChange), colors each muscle
+ * by its weekly-volume status, and exposes an accessible muscle legend wired to
+ * onMusclePress. Phase 1 uses react-native-body-highlighter's combined slugs
+ * (deltoids as one path, lats/upper-back shared); swipe between views and the
+ * delt/lat SVG split are follow-ups.
+ *
+ * @example
+ * <BodyMap
+ *   data={[{ muscleGroup: MuscleGroup.CHEST, intensity: 0.7, volumeStatus: 'productive', weeklySets: 12 }]}
+ *   view="front"
+ *   onViewChange={setView}
+ *   onMusclePress={setSelected}
+ *   highlightedMuscle={selected}
+ * />
+ */
+declare function BodyMap({ data, view, onViewChange, onMusclePress, highlightedMuscle, mode, className, ...props }: BodyMapProps): react_jsx_runtime.JSX.Element;
+
+interface ContributingExercise {
+    /** Exercise name. */
+    name: string;
+    /** Working sets contributed this week. */
+    sets: number;
+    /** Effective-set multiplier toward this muscle (0-1). */
+    contributionWeight: number;
+}
+interface UpcomingExercise {
+    /** Exercise name. */
+    name: string;
+    /** Workout the exercise belongs to. */
+    workoutName: string;
+    /** Planned sets. */
+    sets: number;
+}
+interface BodyMapDetailPanelProps extends ViewProps {
+    /** Muscle group whose volume detail is shown. */
+    muscleGroup: MuscleGroup;
+    /** Human-readable muscle name for the title and a11y label. */
+    displayName: string;
+    /** Weekly effective sets logged for this muscle. */
+    weeklySets: number;
+    /** Volume landmarks (weekly working sets). */
+    landmarks: VolumeLandmarks;
+    /** Weekly-volume status relative to the landmarks. */
+    volumeStatus: VolumeStatus;
+    /** Last trained label, e.g. "2 days ago". */
+    lastTrained?: string;
+    /** Volume sparkline data (last 4-8 weeks). */
+    weeklyHistory?: number[];
+    /** Exercises contributing to this muscle's volume. */
+    contributingExercises?: ContributingExercise[];
+    /** Upcoming exercises targeting this muscle. */
+    upcomingExercises?: UpcomingExercise[];
+    /** Whether the bottom sheet is visible. */
+    isOpen?: boolean;
+    /** Alias for `isOpen` (spec wording: "isOpen/visible"). `isOpen` wins when both are set. */
+    visible?: boolean;
+    /** Dismiss the panel (backdrop, handle, or close button). */
+    onClose: () => void;
+    /** Navigate to a filtered exercise list. */
+    onViewExercises?: () => void;
+}
+/**
+ * Slide-up bottom-sheet panel with detailed weekly-volume info for a tapped
+ * muscle group: a MEV|current|MRV gradient progress bar, the big weekly set
+ * count against MRV, an optional volume sparkline, and the contributing /
+ * upcoming exercise lists. Composes the titan `Badge` and Workout `Sparkline`.
+ *
+ * Controlled via `isOpen` (or the `visible` alias); renders nothing when closed
+ * and animates in on open — sheet translateY 400->0 (400ms ease-out) and a
+ * backdrop fade 0->0.4 (RN Animated, useNativeDriver:false). Backdrop, handle,
+ * and the header close button all call `onClose`.
+ *
+ * @example
+ * <BodyMapDetailPanel
+ *   muscleGroup={MuscleGroup.CHEST}
+ *   displayName="Chest"
+ *   weeklySets={14}
+ *   landmarks={{ mev: 8, mav: 14, mrv: 20 }}
+ *   volumeStatus="productive"
+ *   lastTrained="2 days ago"
+ *   weeklyHistory={[8, 10, 12, 14]}
+ *   isOpen={open}
+ *   onClose={() => setOpen(false)}
+ * />
+ */
+declare function BodyMapDetailPanel({ muscleGroup, displayName, weeklySets, landmarks, volumeStatus, lastTrained, weeklyHistory, contributingExercises, upcomingExercises, isOpen, visible, onClose, onViewExercises, ...props }: BodyMapDetailPanelProps): react_jsx_runtime.JSX.Element | null;
+
+/** One muscle's full volume picture — feeds the body maps and the detail panel. */
+interface TrainingStatusMuscle {
+    /** Detailed muscle group (drives the SVG heatmap + panel identity). */
+    muscleGroup: MuscleGroup;
+    /** Human-readable name for the legend, summary, and panel title. */
+    displayName: string;
+    /** Which body-map view the muscle belongs to. */
+    side: 'front' | 'back';
+    /** Heatmap intensity 0-1. */
+    intensity: number;
+    /** Weekly-volume status relative to the landmarks. */
+    volumeStatus: VolumeStatus;
+    /** Weekly effective sets logged. */
+    weeklySets: number;
+    /** Volume landmarks (weekly working sets). */
+    landmarks: VolumeLandmarks;
+    /** Last trained label, e.g. "2 days ago". */
+    lastTrained?: string;
+    /** Weekly volume history for the panel sparkline. */
+    weeklyHistory?: number[];
+    /** Exercises contributing to this muscle's volume. */
+    contributingExercises?: ContributingExercise[];
+    /** Upcoming exercises targeting this muscle. */
+    upcomingExercises?: UpcomingExercise[];
+}
+/** Derived, page-level roll-up of the tracked muscles. */
+interface TrainingStatusSummary {
+    /** Total weekly effective sets across all tracked muscles. */
+    totalWeeklySets: number;
+    /** Number of muscles being tracked. */
+    trackedMuscles: number;
+    /** Count of muscles per volume status. */
+    statusCounts: Record<VolumeStatus, number>;
+}
+interface TrainingStatusPageProps extends ViewProps {
+    /** Page heading. */
+    title?: string;
+    /** Mesocycle context banner shown at the top. */
+    meso: MesoStatusCardProps;
+    /** Muscles tracked this week. */
+    muscles: TrainingStatusMuscle[];
+    className?: string;
+}
+/** Roll up per-muscle rows into the page summary (pure, testable). */
+declare function deriveTrainingSummary(muscles: TrainingStatusMuscle[]): TrainingStatusSummary;
+/** Project the muscle rows for one side into `BodyMap` heatmap data. */
+declare function toBodyMapData(muscles: TrainingStatusMuscle[], side: 'front' | 'back'): BodyMapData[];
+/**
+ * TrainingStatusPage — a body-map training dashboard that composes the
+ * mesocycle context banner (`MesoStatusCard`), side-by-side front/back
+ * `BodyMap`s with a shared heatmap legend, per-status summary cards, and a
+ * tap-to-detail `BodyMapDetailPanel`. Tapping any muscle (SVG or legend chip)
+ * opens the slide-up panel for that group; the summary is derived from the
+ * supplied muscle rows.
+ *
+ * @example
+ * <TrainingStatusPage meso={meso} muscles={muscles} />
+ */
+declare function TrainingStatusPage({ title, meso, muscles, className, ...props }: TrainingStatusPageProps): react_jsx_runtime.JSX.Element;
+
+export { BodyMap, type BodyMapData, BodyMapDetailPanel, type BodyMapDetailPanelProps, type BodyMapProps, type ContributingExercise, DEFAULT_VOLUME_LANDMARKS, DETAILED_TO_SIMPLE, MUSCLE_DISPLAY_NAMES, MUSCLE_TO_CATEGORY, MUSCLE_TO_SVG_SLUGS, type MovementCategory, MuscleGroup, SIMPLE_DISPLAY_NAMES, SIMPLE_TO_DETAILED, SimpleMuscleGroup, type TrainingStatusMuscle, TrainingStatusPage, type TrainingStatusPageProps, type TrainingStatusSummary, type UpcomingExercise, VOLUME_STATUS_LABELS, type VolumeLandmarks, deriveTrainingSummary, getHeatmapColor, toBodyMapData };

package/dist/bodymap.d.ts

@@ -1,3 +1,246 @@
-export { n as BodyMap, B as BodyMapData, o as BodyMapDetailPanel, a as BodyMapDetailPanelProps, b as BodyMapProps, C as ContributingExercise, D as DEFAULT_VOLUME_LANDMARKS, p as DETAILED_TO_SIMPLE, q as MUSCLE_DISPLAY_NAMES, r as MUSCLE_TO_CATEGORY, s as MUSCLE_TO_SVG_SLUGS, j as MovementCategory, k as MuscleGroup, t as SIMPLE_DISPLAY_NAMES, u as SIMPLE_TO_DETAILED, S as SimpleMuscleGroup, T as TrainingStatusMuscle, v as TrainingStatusPage, l as TrainingStatusPageProps, m as TrainingStatusSummary, U as UpcomingExercise, w as VOLUME_STATUS_LABELS, V as VolumeLandmarks, x as deriveTrainingSummary, y as getHeatmapColor, z as toBodyMapData } from './bodymap-BhG55xHM.js';
-import 'react/jsx-runtime';
-import 'react-native';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ViewProps } from 'react-native';
+import { c as MesoStatusCardProps } from './MesoStatusCard-CQk71hSi.js';
+
+/**
+ * Full muscle group taxonomy for volume tracking and exercise mapping.
+ * 15 groups — the primary unit for volume accounting.
+ */
+declare enum MuscleGroup {
+    CHEST = "chest",
+    FRONT_DELTS = "front_delts",
+    SIDE_DELTS = "side_delts",
+    TRICEPS = "triceps",
+    LATS = "lats",
+    UPPER_BACK = "upper_back",
+    REAR_DELTS = "rear_delts",
+    BICEPS = "biceps",
+    FOREARMS = "forearms",
+    QUADS = "quads",
+    HAMSTRINGS = "hamstrings",
+    GLUTES = "glutes",
+    CALVES = "calves",
+    ABS = "abs",
+    OBLIQUES = "obliques"
+}
+/**
+ * Simplified muscle group view for beginners. Maps to one or more MuscleGroup.
+ */
+declare enum SimpleMuscleGroup {
+    CHEST = "chest",
+    BACK = "back",
+    SHOULDERS = "shoulders",
+    BICEPS = "biceps",
+    TRICEPS = "triceps",
+    LEGS = "legs",
+    CORE = "core",
+    FOREARMS = "forearms"
+}
+/** Mapping from simplified groups to the full taxonomy. */
+declare const SIMPLE_TO_DETAILED: Record<SimpleMuscleGroup, MuscleGroup[]>;
+/** Reverse map: detailed MuscleGroup -> its SimpleMuscleGroup. */
+declare const DETAILED_TO_SIMPLE: Record<MuscleGroup, SimpleMuscleGroup>;
+/** Movement category for training split organization. */
+type MovementCategory = 'push' | 'pull' | 'legs' | 'core';
+declare const MUSCLE_TO_CATEGORY: Record<MuscleGroup, MovementCategory>;
+/**
+ * react-native-body-highlighter slug(s) per muscle group. Phase 1 uses the
+ * closest available slug; deltoids share one path and lats/upper-back share
+ * `upper-back` (see doc Level 4 "Recommended approach").
+ */
+declare const MUSCLE_TO_SVG_SLUGS: Record<MuscleGroup, string[]>;
+/** Human-readable name per muscle group (used in a11y labels). */
+declare const MUSCLE_DISPLAY_NAMES: Record<MuscleGroup, string>;
+/** Human-readable name per simple group. */
+declare const SIMPLE_DISPLAY_NAMES: Record<SimpleMuscleGroup, string>;
+/** Volume landmarks per muscle group (weekly working sets). */
+interface VolumeLandmarks {
+    mev: number;
+    mav: number;
+    mrv: number;
+}
+declare const DEFAULT_VOLUME_LANDMARKS: Record<MuscleGroup, VolumeLandmarks>;
+/** Weekly-volume status relative to MEV/MAV/MRV landmarks. */
+type VolumeStatus = 'under' | 'maintenance' | 'productive' | 'over';
+/** Readable label per status for a11y descriptions. */
+declare const VOLUME_STATUS_LABELS: Record<VolumeStatus, string>;
+/**
+ * Maps a volume status (and intensity, 0-1) to a heatmap fill color. The
+ * `approaching` token is used when a productive muscle nears its MRV.
+ */
+declare function getHeatmapColor(status: VolumeStatus | null | undefined, intensity?: number): string;
+
+interface BodyMapData {
+    muscleGroup: MuscleGroup;
+    /** Intensity 0-1 for heatmap color. */
+    intensity: number;
+    /** Volume status for tooltip / heatmap token. */
+    volumeStatus: VolumeStatus;
+    /** Weekly effective sets. */
+    weeklySets: number;
+}
+interface BodyMapProps extends ViewProps {
+    /** Muscle group intensity data. */
+    data: BodyMapData[];
+    /** Which view to show. */
+    view: 'front' | 'back';
+    /** Toggle between front/back. */
+    onViewChange?: (view: 'front' | 'back') => void;
+    /** Called when a muscle group is tapped. */
+    onMusclePress?: (muscleGroup: MuscleGroup) => void;
+    /** Currently highlighted muscle (from external selection). */
+    highlightedMuscle?: MuscleGroup | null;
+    /** Show simplified (8 groups) or detailed (15 groups). */
+    mode?: 'simple' | 'detailed';
+    className?: string;
+}
+/**
+ * Interactive SVG body map with tappable muscle groups and a volume heatmap.
+ * Renders the front or back view (toggle via onViewChange), colors each muscle
+ * by its weekly-volume status, and exposes an accessible muscle legend wired to
+ * onMusclePress. Phase 1 uses react-native-body-highlighter's combined slugs
+ * (deltoids as one path, lats/upper-back shared); swipe between views and the
+ * delt/lat SVG split are follow-ups.
+ *
+ * @example
+ * <BodyMap
+ *   data={[{ muscleGroup: MuscleGroup.CHEST, intensity: 0.7, volumeStatus: 'productive', weeklySets: 12 }]}
+ *   view="front"
+ *   onViewChange={setView}
+ *   onMusclePress={setSelected}
+ *   highlightedMuscle={selected}
+ * />
+ */
+declare function BodyMap({ data, view, onViewChange, onMusclePress, highlightedMuscle, mode, className, ...props }: BodyMapProps): react_jsx_runtime.JSX.Element;
+
+interface ContributingExercise {
+    /** Exercise name. */
+    name: string;
+    /** Working sets contributed this week. */
+    sets: number;
+    /** Effective-set multiplier toward this muscle (0-1). */
+    contributionWeight: number;
+}
+interface UpcomingExercise {
+    /** Exercise name. */
+    name: string;
+    /** Workout the exercise belongs to. */
+    workoutName: string;
+    /** Planned sets. */
+    sets: number;
+}
+interface BodyMapDetailPanelProps extends ViewProps {
+    /** Muscle group whose volume detail is shown. */
+    muscleGroup: MuscleGroup;
+    /** Human-readable muscle name for the title and a11y label. */
+    displayName: string;
+    /** Weekly effective sets logged for this muscle. */
+    weeklySets: number;
+    /** Volume landmarks (weekly working sets). */
+    landmarks: VolumeLandmarks;
+    /** Weekly-volume status relative to the landmarks. */
+    volumeStatus: VolumeStatus;
+    /** Last trained label, e.g. "2 days ago". */
+    lastTrained?: string;
+    /** Volume sparkline data (last 4-8 weeks). */
+    weeklyHistory?: number[];
+    /** Exercises contributing to this muscle's volume. */
+    contributingExercises?: ContributingExercise[];
+    /** Upcoming exercises targeting this muscle. */
+    upcomingExercises?: UpcomingExercise[];
+    /** Whether the bottom sheet is visible. */
+    isOpen?: boolean;
+    /** Alias for `isOpen` (spec wording: "isOpen/visible"). `isOpen` wins when both are set. */
+    visible?: boolean;
+    /** Dismiss the panel (backdrop, handle, or close button). */
+    onClose: () => void;
+    /** Navigate to a filtered exercise list. */
+    onViewExercises?: () => void;
+}
+/**
+ * Slide-up bottom-sheet panel with detailed weekly-volume info for a tapped
+ * muscle group: a MEV|current|MRV gradient progress bar, the big weekly set
+ * count against MRV, an optional volume sparkline, and the contributing /
+ * upcoming exercise lists. Composes the titan `Badge` and Workout `Sparkline`.
+ *
+ * Controlled via `isOpen` (or the `visible` alias); renders nothing when closed
+ * and animates in on open — sheet translateY 400->0 (400ms ease-out) and a
+ * backdrop fade 0->0.4 (RN Animated, useNativeDriver:false). Backdrop, handle,
+ * and the header close button all call `onClose`.
+ *
+ * @example
+ * <BodyMapDetailPanel
+ *   muscleGroup={MuscleGroup.CHEST}
+ *   displayName="Chest"
+ *   weeklySets={14}
+ *   landmarks={{ mev: 8, mav: 14, mrv: 20 }}
+ *   volumeStatus="productive"
+ *   lastTrained="2 days ago"
+ *   weeklyHistory={[8, 10, 12, 14]}
+ *   isOpen={open}
+ *   onClose={() => setOpen(false)}
+ * />
+ */
+declare function BodyMapDetailPanel({ muscleGroup, displayName, weeklySets, landmarks, volumeStatus, lastTrained, weeklyHistory, contributingExercises, upcomingExercises, isOpen, visible, onClose, onViewExercises, ...props }: BodyMapDetailPanelProps): react_jsx_runtime.JSX.Element | null;
+
+/** One muscle's full volume picture — feeds the body maps and the detail panel. */
+interface TrainingStatusMuscle {
+    /** Detailed muscle group (drives the SVG heatmap + panel identity). */
+    muscleGroup: MuscleGroup;
+    /** Human-readable name for the legend, summary, and panel title. */
+    displayName: string;
+    /** Which body-map view the muscle belongs to. */
+    side: 'front' | 'back';
+    /** Heatmap intensity 0-1. */
+    intensity: number;
+    /** Weekly-volume status relative to the landmarks. */
+    volumeStatus: VolumeStatus;
+    /** Weekly effective sets logged. */
+    weeklySets: number;
+    /** Volume landmarks (weekly working sets). */
+    landmarks: VolumeLandmarks;
+    /** Last trained label, e.g. "2 days ago". */
+    lastTrained?: string;
+    /** Weekly volume history for the panel sparkline. */
+    weeklyHistory?: number[];
+    /** Exercises contributing to this muscle's volume. */
+    contributingExercises?: ContributingExercise[];
+    /** Upcoming exercises targeting this muscle. */
+    upcomingExercises?: UpcomingExercise[];
+}
+/** Derived, page-level roll-up of the tracked muscles. */
+interface TrainingStatusSummary {
+    /** Total weekly effective sets across all tracked muscles. */
+    totalWeeklySets: number;
+    /** Number of muscles being tracked. */
+    trackedMuscles: number;
+    /** Count of muscles per volume status. */
+    statusCounts: Record<VolumeStatus, number>;
+}
+interface TrainingStatusPageProps extends ViewProps {
+    /** Page heading. */
+    title?: string;
+    /** Mesocycle context banner shown at the top. */
+    meso: MesoStatusCardProps;
+    /** Muscles tracked this week. */
+    muscles: TrainingStatusMuscle[];
+    className?: string;
+}
+/** Roll up per-muscle rows into the page summary (pure, testable). */
+declare function deriveTrainingSummary(muscles: TrainingStatusMuscle[]): TrainingStatusSummary;
+/** Project the muscle rows for one side into `BodyMap` heatmap data. */
+declare function toBodyMapData(muscles: TrainingStatusMuscle[], side: 'front' | 'back'): BodyMapData[];
+/**
+ * TrainingStatusPage — a body-map training dashboard that composes the
+ * mesocycle context banner (`MesoStatusCard`), side-by-side front/back
+ * `BodyMap`s with a shared heatmap legend, per-status summary cards, and a
+ * tap-to-detail `BodyMapDetailPanel`. Tapping any muscle (SVG or legend chip)
+ * opens the slide-up panel for that group; the summary is derived from the
+ * supplied muscle rows.
+ *
+ * @example
+ * <TrainingStatusPage meso={meso} muscles={muscles} />
+ */
+declare function TrainingStatusPage({ title, meso, muscles, className, ...props }: TrainingStatusPageProps): react_jsx_runtime.JSX.Element;
+
+export { BodyMap, type BodyMapData, BodyMapDetailPanel, type BodyMapDetailPanelProps, type BodyMapProps, type ContributingExercise, DEFAULT_VOLUME_LANDMARKS, DETAILED_TO_SIMPLE, MUSCLE_DISPLAY_NAMES, MUSCLE_TO_CATEGORY, MUSCLE_TO_SVG_SLUGS, type MovementCategory, MuscleGroup, SIMPLE_DISPLAY_NAMES, SIMPLE_TO_DETAILED, SimpleMuscleGroup, type TrainingStatusMuscle, TrainingStatusPage, type TrainingStatusPageProps, type TrainingStatusSummary, type UpcomingExercise, VOLUME_STATUS_LABELS, type VolumeLandmarks, deriveTrainingSummary, getHeatmapColor, toBodyMapData };