@pwf-dev/core 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,3833 @@
+/**
+ * Portable Workout Format v1 schema for validating plan documents
+ */
+interface PWFPlanV1 {
+    /**
+     * Specification version (must be 1)
+     */
+    plan_version: 1;
+    meta?: Meta;
+    /**
+     * Term definitions for exercises and concepts used in this plan
+     */
+    glossary?: {
+        [k: string]: string;
+    };
+    cycle: Cycle;
+}
+/**
+ * Plan metadata for display and organization
+ */
+interface Meta {
+    /**
+     * Unique plan identifier
+     */
+    id?: string;
+    /**
+     * Plan display name
+     */
+    title: string;
+    /**
+     * Brief plan description
+     */
+    description?: string;
+    /**
+     * Coach or creator name
+     */
+    author?: string;
+    /**
+     * Plan status
+     */
+    status?: "draft" | "active" | "completed" | "archived";
+    /**
+     * ISO 8601 timestamp when plan was activated
+     */
+    activated_at?: string;
+    /**
+     * ISO 8601 timestamp when plan was completed
+     */
+    completed_at?: string;
+    /**
+     * Required equipment tags
+     */
+    equipment?: string[];
+    /**
+     * Intended training frequency
+     */
+    daysPerWeek?: number;
+    /**
+     * Suggest as starter plan
+     */
+    recommendedFirst?: boolean;
+    /**
+     * Searchable tags
+     */
+    tags?: string[];
+    athlete_profile?: AthleteProfile;
+}
+/**
+ * Athlete metrics for endurance training
+ */
+interface AthleteProfile {
+    /**
+     * Functional Threshold Power in watts
+     */
+    ftp_watts?: number;
+    /**
+     * Threshold heart rate in BPM
+     */
+    threshold_hr_bpm?: number;
+    /**
+     * Maximum heart rate in BPM
+     */
+    max_hr_bpm?: number;
+    /**
+     * Threshold pace in seconds per kilometer
+     */
+    threshold_pace_sec_per_km?: number;
+    /**
+     * Athlete weight in kilograms
+     */
+    weight_kg?: number;
+}
+/**
+ * Training cycle containing workout days
+ */
+interface Cycle {
+    /**
+     * ISO 8601 date (YYYY-MM-DD)
+     */
+    start_date?: string;
+    /**
+     * Cycle-level coaching notes
+     */
+    notes?: string;
+    /**
+     * Training days in this cycle
+     *
+     * @minItems 1
+     */
+    days: [Day, ...Day[]];
+}
+/**
+ * Single training day
+ */
+interface Day {
+    /**
+     * Unique day identifier
+     */
+    id?: string;
+    /**
+     * Day sequence (0-indexed)
+     */
+    order?: number;
+    /**
+     * Training focus or theme
+     */
+    focus?: string;
+    /**
+     * Day-level coaching notes
+     */
+    notes?: string;
+    /**
+     * Planned workout date
+     */
+    scheduled_date?: string;
+    /**
+     * Expected duration in minutes
+     */
+    target_session_length_min?: number;
+    /**
+     * Exercises in this day
+     *
+     * @minItems 1
+     */
+    exercises: [Exercise, ...Exercise[]];
+}
+/**
+ * Single exercise definition
+ */
+interface Exercise {
+    /**
+     * Unique exercise identifier
+     */
+    id?: string;
+    /**
+     * Exercise name
+     */
+    name?: string;
+    /**
+     * Exercise type
+     */
+    modality: "strength" | "countdown" | "stopwatch" | "interval" | "cycling" | "running" | "rowing" | "swimming";
+    /**
+     * Target number of sets
+     */
+    target_sets?: number;
+    /**
+     * Target reps per set
+     */
+    target_reps?: number;
+    /**
+     * Target duration in seconds
+     */
+    target_duration_sec?: number;
+    /**
+     * Target distance in meters
+     */
+    target_distance_meters?: number;
+    /**
+     * Loading guidance (weight, RPE, %1RM)
+     */
+    target_load?: string;
+    /**
+     * Target weight as percentage of reference max (requires percent_of)
+     */
+    target_weight_percent?: number;
+    /**
+     * Reference max for percentage calculation (requires target_weight_percent)
+     */
+    percent_of?: "1rm" | "3rm" | "5rm" | "10rm";
+    /**
+     * Reference another exercise's max for percentage calculation
+     */
+    reference_exercise?: string;
+    /**
+     * Form cues (alias for target_notes)
+     */
+    cues?: string;
+    /**
+     * Coaching notes for this exercise
+     */
+    target_notes?: string;
+    /**
+     * Tutorial URL (HTTPS only)
+     */
+    link?: string;
+    /**
+     * Demo image URL (HTTPS only)
+     */
+    image?: string;
+    /**
+     * Group identifier for supersets/circuits (alphanumeric, hyphens, underscores only)
+     */
+    group?: string;
+    /**
+     * Type of exercise grouping
+     */
+    group_type?: "superset" | "circuit";
+    /**
+     * Rest period in seconds between sets
+     */
+    rest_between_sets_sec?: number;
+    /**
+     * Rest period in seconds after completing all sets
+     */
+    rest_after_sec?: number;
+    /**
+     * Training zones for endurance workouts
+     *
+     * @minItems 1
+     */
+    zones?: [TrainingZone, ...TrainingZone[]];
+    ramp?: RampConfig;
+    /**
+     * Structured interval phases for complex endurance workouts
+     *
+     * @minItems 1
+     */
+    interval_phases?: [IntervalPhase, ...IntervalPhase[]];
+}
+/**
+ * Training zone specification
+ */
+interface TrainingZone {
+    /**
+     * Training zone number (1-7)
+     */
+    zone: number;
+    /**
+     * Duration in this zone (seconds)
+     */
+    duration_sec?: number;
+    /**
+     * Target power in watts
+     */
+    target_power_watts?: number;
+    /**
+     * Target heart rate in BPM
+     */
+    target_hr_bpm?: number;
+    /**
+     * Target pace in seconds per kilometer
+     */
+    target_pace_sec_per_km?: number;
+}
+/**
+ * Ramp configuration for gradual intensity changes
+ */
+interface RampConfig {
+    /**
+     * Starting power in watts
+     */
+    start_power_watts: number;
+    /**
+     * Ending power in watts
+     */
+    end_power_watts: number;
+    /**
+     * Ramp duration in seconds
+     */
+    duration_sec: number;
+    /**
+     * Duration of each step in seconds
+     */
+    step_duration_sec?: number;
+}
+/**
+ * Phase in a structured interval workout
+ */
+interface IntervalPhase {
+    /**
+     * Phase name (e.g., 'warmup', 'work', 'recovery')
+     */
+    name: string;
+    /**
+     * Phase duration in seconds
+     */
+    duration_sec: number;
+    /**
+     * Target power in watts
+     */
+    target_power_watts?: number;
+    /**
+     * Target heart rate in BPM
+     */
+    target_hr_bpm?: number;
+    /**
+     * Target pace in seconds per kilometer
+     */
+    target_pace_sec_per_km?: number;
+    /**
+     * Target cadence in RPM
+     */
+    cadence_rpm?: number;
+}
+
+/**
+ * Swimming stroke type for pool and open water swimming
+ */
+type StrokeType = "freestyle" | "backstroke" | "breaststroke" | "butterfly" | "drill" | "mixed" | "im";
+/**
+ * Schema for validating PWF workout history exports
+ */
+interface PWFHistoryExportV1 {
+    /**
+     * Specification version (must be 1)
+     */
+    history_version: 1;
+    /**
+     * ISO 8601 datetime when export was created
+     */
+    exported_at: string;
+    export_source?: ExportSource;
+    units?: Units1;
+    /**
+     * Completed workout sessions
+     */
+    workouts: Workout[];
+    /**
+     * Personal records achieved
+     */
+    personal_records?: PersonalRecord[];
+    /**
+     * Body measurements recorded
+     */
+    body_measurements?: BodyMeasurement[];
+}
+interface ExportSource {
+    /**
+     * Application name
+     */
+    app_name?: string;
+    /**
+     * Application version
+     */
+    app_version?: string;
+    /**
+     * Platform
+     */
+    platform?: "ios" | "android" | "web" | "desktop";
+    preferred_units?: Units;
+}
+/**
+ * User's preferred units
+ */
+interface Units {
+    weight?: "kg" | "lb";
+    distance?: "meters" | "kilometers" | "miles" | "feet" | "yards";
+}
+interface Units1 {
+    weight?: "kg" | "lb";
+    distance?: "meters" | "kilometers" | "miles" | "feet" | "yards";
+}
+interface Workout {
+    /**
+     * Unique workout identifier
+     */
+    id?: string;
+    /**
+     * Workout date (YYYY-MM-DD)
+     */
+    date: string;
+    /**
+     * Start timestamp
+     */
+    started_at?: string;
+    /**
+     * End timestamp
+     */
+    ended_at?: string;
+    /**
+     * Total duration in seconds
+     */
+    duration_sec?: number;
+    /**
+     * Workout title
+     */
+    title?: string;
+    /**
+     * Workout notes
+     */
+    notes?: string;
+    /**
+     * Reference to PWF plan
+     */
+    plan_id?: string;
+    /**
+     * Reference to plan day
+     */
+    plan_day_id?: string;
+    /**
+     * Exercises performed
+     */
+    exercises: CompletedExercise[];
+    telemetry?: WorkoutTelemetry;
+    /**
+     * Devices used during workout (PWF v2)
+     */
+    devices?: DeviceInfo[];
+    /**
+     * Primary sport for this workout (PWF v2.1)
+     */
+    sport?: "swimming" | "cycling" | "running" | "rowing" | "transition" | "strength" | "strength-training" | "hiking" | "walking" | "yoga" | "pilates" | "cross-fit" | "calisthenics" | "cardio" | "cross-country-skiing" | "downhill-skiing" | "snowboarding" | "stand-up-paddling" | "kayaking" | "elliptical" | "stair-climbing" | "other";
+    /**
+     * Sport segments for multi-sport workouts like triathlon (PWF v2.1)
+     */
+    sport_segments?: SportSegment[];
+}
+interface CompletedExercise {
+    /**
+     * Unique exercise identifier
+     */
+    id?: string;
+    /**
+     * Exercise name
+     */
+    name: string;
+    /**
+     * Exercise modality
+     */
+    modality?: "strength" | "countdown" | "stopwatch" | "interval" | "swimming";
+    /**
+     * Exercise-level notes
+     */
+    notes?: string;
+    /**
+     * Completed sets
+     */
+    sets: CompletedSet[];
+    pool_config?: PoolConfig;
+    /**
+     * Sport classification for this exercise (PWF v2.1)
+     */
+    sport?: "swimming" | "cycling" | "running" | "rowing" | "transition" | "strength" | "strength-training" | "hiking" | "walking" | "yoga" | "pilates" | "cross-fit" | "calisthenics" | "cardio" | "cross-country-skiing" | "downhill-skiing" | "snowboarding" | "stand-up-paddling" | "kayaking" | "elliptical" | "stair-climbing" | "other";
+}
+interface CompletedSet {
+    /**
+     * Set order (1-indexed)
+     */
+    set_number?: number;
+    /**
+     * Type of set
+     */
+    set_type?: "working" | "warmup" | "dropset" | "failure" | "amrap";
+    /**
+     * Repetitions completed
+     */
+    reps?: number;
+    /**
+     * Weight in kilograms
+     */
+    weight_kg?: number;
+    /**
+     * Weight in pounds
+     */
+    weight_lb?: number;
+    /**
+     * Duration in seconds
+     */
+    duration_sec?: number;
+    /**
+     * Distance in meters
+     */
+    distance_meters?: number;
+    /**
+     * Rate of Perceived Exertion (1-10 scale)
+     */
+    rpe?: number;
+    /**
+     * Reps in Reserve (alternative to RPE)
+     */
+    rir?: number;
+    /**
+     * Set-level notes
+     */
+    notes?: string;
+    /**
+     * Whether this set was a personal record
+     */
+    is_pr?: boolean;
+    /**
+     * When set was completed
+     */
+    completed_at?: string;
+    telemetry?: SetTelemetry;
+    swimming?: SwimmingSetData;
+}
+/**
+ * Telemetry metrics for this set (PWF v2)
+ */
+interface SetTelemetry {
+    /**
+     * Average heart rate (bpm)
+     */
+    heart_rate_avg?: number;
+    /**
+     * Maximum heart rate (bpm)
+     */
+    heart_rate_max?: number;
+    /**
+     * Minimum heart rate (bpm)
+     */
+    heart_rate_min?: number;
+    /**
+     * Average power (watts)
+     */
+    power_avg?: number;
+    /**
+     * Maximum power (watts)
+     */
+    power_max?: number;
+    /**
+     * Minimum power (watts)
+     */
+    power_min?: number;
+    /**
+     * Elevation gain in meters
+     */
+    elevation_gain_m?: number;
+    /**
+     * Elevation gain in feet
+     */
+    elevation_gain_ft?: number;
+    /**
+     * Elevation loss in meters
+     */
+    elevation_loss_m?: number;
+    /**
+     * Elevation loss in feet
+     */
+    elevation_loss_ft?: number;
+    /**
+     * Average speed in m/s
+     */
+    speed_avg_mps?: number;
+    /**
+     * Average speed in km/h
+     */
+    speed_avg_kph?: number;
+    /**
+     * Average speed in mph
+     */
+    speed_avg_mph?: number;
+    /**
+     * Maximum speed in m/s
+     */
+    speed_max_mps?: number;
+    /**
+     * Maximum speed in km/h
+     */
+    speed_max_kph?: number;
+    /**
+     * Maximum speed in mph
+     */
+    speed_max_mph?: number;
+    /**
+     * Average pace in seconds per km
+     */
+    pace_avg_sec_per_km?: number;
+    /**
+     * Average pace in seconds per mile
+     */
+    pace_avg_sec_per_mi?: number;
+    /**
+     * Average cadence (RPM or SPM)
+     */
+    cadence_avg?: number;
+    /**
+     * Maximum cadence (RPM or SPM)
+     */
+    cadence_max?: number;
+    /**
+     * Temperature in Celsius
+     */
+    temperature_c?: number;
+    /**
+     * Temperature in Fahrenheit
+     */
+    temperature_f?: number;
+    /**
+     * Humidity percentage
+     */
+    humidity_percent?: number;
+    /**
+     * Calories burned in this set
+     */
+    calories?: number;
+    /**
+     * Stroke rate for swimming/rowing (strokes per minute)
+     */
+    stroke_rate?: number;
+    /**
+     * GPS route identifier
+     */
+    gps_route_id?: string;
+    time_series?: TimeSeriesData;
+}
+/**
+ * Second-by-second time-series data (PWF v2.1)
+ */
+interface TimeSeriesData {
+    /**
+     * Timestamps for each record (ISO 8601). All other arrays must match this length.
+     */
+    timestamps: string[];
+    /**
+     * Elapsed time in seconds since start
+     */
+    elapsed_sec?: number[];
+    /**
+     * Heart rate readings (bpm)
+     */
+    heart_rate?: number[];
+    /**
+     * Power readings (watts)
+     */
+    power?: number[];
+    /**
+     * Cadence readings (RPM for cycling, SPM for running/swimming)
+     */
+    cadence?: number[];
+    /**
+     * Speed readings (meters per second)
+     */
+    speed_mps?: number[];
+    /**
+     * Distance readings (cumulative meters)
+     */
+    distance_m?: number[];
+    /**
+     * Elevation/altitude readings (meters)
+     */
+    elevation_m?: number[];
+    /**
+     * Temperature readings (Celsius)
+     */
+    temperature_c?: number[];
+    /**
+     * Latitude readings (decimal degrees)
+     */
+    latitude?: number[];
+    /**
+     * Longitude readings (decimal degrees)
+     */
+    longitude?: number[];
+    /**
+     * Grade/slope readings (percentage)
+     */
+    grade_percent?: number[];
+    /**
+     * Respiration rate (breaths per minute)
+     */
+    respiration_rate?: number[];
+    /**
+     * Core body temperature (Celsius)
+     */
+    core_temperature_c?: number[];
+    /**
+     * Muscle oxygen saturation (percentage)
+     */
+    muscle_oxygen_percent?: number[];
+    /**
+     * Left/right power balance (percentage left)
+     */
+    power_balance?: number[];
+    /**
+     * Left pedal smoothness (percentage)
+     */
+    left_pedal_smoothness?: number[];
+    /**
+     * Right pedal smoothness (percentage)
+     */
+    right_pedal_smoothness?: number[];
+    /**
+     * Left torque effectiveness (percentage)
+     */
+    left_torque_effectiveness?: number[];
+    /**
+     * Right torque effectiveness (percentage)
+     */
+    right_torque_effectiveness?: number[];
+    /**
+     * Running stride length (meters)
+     */
+    stride_length_m?: number[];
+    /**
+     * Running vertical oscillation (centimeters)
+     */
+    vertical_oscillation_cm?: number[];
+    /**
+     * Running ground contact time (milliseconds)
+     */
+    ground_contact_time_ms?: number[];
+    /**
+     * Running ground contact balance (percentage left)
+     */
+    ground_contact_balance?: number[];
+    /**
+     * Swimming stroke rate (strokes per minute)
+     */
+    stroke_rate?: number[];
+    /**
+     * Swimming stroke count (cumulative)
+     */
+    stroke_count?: number[];
+    /**
+     * Swimming SWOLF score
+     */
+    swolf?: number[];
+    /**
+     * Swimming stroke type at each point
+     */
+    stroke_type?: StrokeType[];
+}
+/**
+ * Swimming-specific data for this set (PWF v2.1)
+ */
+interface SwimmingSetData {
+    /**
+     * Individual lengths within this set/lap
+     */
+    lengths?: SwimmingLength[];
+    /**
+     * Swimming stroke type for pool and open water swimming
+     */
+    stroke_type?: "freestyle" | "backstroke" | "breaststroke" | "butterfly" | "drill" | "mixed" | "im";
+    /**
+     * Total number of lengths in this set
+     */
+    total_lengths?: number;
+    /**
+     * Number of active lengths (excludes rest at wall)
+     */
+    active_lengths?: number;
+    /**
+     * Average SWOLF across all lengths in this set
+     */
+    swolf_avg?: number;
+    /**
+     * Whether this set was drill work (technique focus)
+     */
+    drill_mode?: boolean;
+}
+/**
+ * A single length (one pool length) within a swimming set/lap (PWF v2.1)
+ */
+interface SwimmingLength {
+    /**
+     * Length number within the set (1-indexed)
+     */
+    length_number: number;
+    /**
+     * Swimming stroke type for pool and open water swimming
+     */
+    stroke_type: "freestyle" | "backstroke" | "breaststroke" | "butterfly" | "drill" | "mixed" | "im";
+    /**
+     * Duration of this length in seconds
+     */
+    duration_sec: number;
+    /**
+     * Number of strokes taken during this length
+     */
+    stroke_count?: number;
+    /**
+     * SWOLF score (duration + stroke_count) - lower is better
+     */
+    swolf?: number;
+    /**
+     * Timestamp when this length started (ISO 8601)
+     */
+    started_at?: string;
+    /**
+     * Whether this was an active length (vs. rest at wall)
+     */
+    active?: boolean;
+}
+/**
+ * Pool configuration for swimming exercises (PWF v2.1)
+ */
+interface PoolConfig {
+    /**
+     * Length of the pool in the specified units
+     */
+    pool_length: number;
+    /**
+     * Unit for pool length (meters or yards)
+     */
+    pool_length_unit?: "meters" | "yards";
+}
+/**
+ * Telemetry metrics for entire workout session (PWF v2)
+ */
+interface WorkoutTelemetry {
+    /**
+     * Average heart rate (bpm)
+     */
+    heart_rate_avg?: number;
+    /**
+     * Maximum heart rate (bpm)
+     */
+    heart_rate_max?: number;
+    /**
+     * Minimum heart rate (bpm)
+     */
+    heart_rate_min?: number;
+    /**
+     * Average power (watts)
+     */
+    power_avg?: number;
+    /**
+     * Maximum power (watts)
+     */
+    power_max?: number;
+    /**
+     * Total distance in meters
+     */
+    total_distance_m?: number;
+    /**
+     * Total distance in kilometers
+     */
+    total_distance_km?: number;
+    /**
+     * Total distance in miles
+     */
+    total_distance_mi?: number;
+    /**
+     * Total elevation gain in meters
+     */
+    total_elevation_gain_m?: number;
+    /**
+     * Total elevation gain in feet
+     */
+    total_elevation_gain_ft?: number;
+    /**
+     * Total elevation loss in meters
+     */
+    total_elevation_loss_m?: number;
+    /**
+     * Total elevation loss in feet
+     */
+    total_elevation_loss_ft?: number;
+    /**
+     * Average speed in km/h
+     */
+    speed_avg_kph?: number;
+    /**
+     * Average speed in mph
+     */
+    speed_avg_mph?: number;
+    /**
+     * Maximum speed in km/h
+     */
+    speed_max_kph?: number;
+    /**
+     * Maximum speed in mph
+     */
+    speed_max_mph?: number;
+    /**
+     * Average pace in seconds per km
+     */
+    pace_avg_sec_per_km?: number;
+    /**
+     * Average pace in seconds per mile
+     */
+    pace_avg_sec_per_mi?: number;
+    /**
+     * Average cadence (RPM or SPM)
+     */
+    cadence_avg?: number;
+    /**
+     * Temperature in Celsius
+     */
+    temperature_c?: number;
+    /**
+     * Temperature in Fahrenheit
+     */
+    temperature_f?: number;
+    /**
+     * Humidity percentage
+     */
+    humidity_percent?: number;
+    /**
+     * Total calories burned
+     */
+    total_calories?: number;
+    /**
+     * GPS route identifier
+     */
+    gps_route_id?: string;
+    gps_route?: GpsRoute;
+    advanced_metrics?: AdvancedMetrics;
+    power_metrics?: PowerMetrics;
+    time_in_zones?: TimeInZones;
+}
+/**
+ * Full GPS route data (PWF v2.1)
+ */
+interface GpsRoute {
+    /**
+     * Unique identifier for this route
+     */
+    route_id: string;
+    /**
+     * Human-readable route name
+     */
+    name?: string;
+    /**
+     * GPS positions in chronological order
+     */
+    positions: GpsPosition[];
+    /**
+     * Total distance calculated from GPS (meters)
+     */
+    total_distance_m?: number;
+    /**
+     * Total elevation gain (meters)
+     */
+    total_ascent_m?: number;
+    /**
+     * Total elevation loss (meters)
+     */
+    total_descent_m?: number;
+    /**
+     * Minimum elevation on route (meters)
+     */
+    min_elevation_m?: number;
+    /**
+     * Maximum elevation on route (meters)
+     */
+    max_elevation_m?: number;
+    /**
+     * Bounding box - southwest corner latitude
+     */
+    bbox_sw_lat?: number;
+    /**
+     * Bounding box - southwest corner longitude
+     */
+    bbox_sw_lng?: number;
+    /**
+     * Bounding box - northeast corner latitude
+     */
+    bbox_ne_lat?: number;
+    /**
+     * Bounding box - northeast corner longitude
+     */
+    bbox_ne_lng?: number;
+    /**
+     * Recording mode (e.g., auto, smart, 1s, gps_only)
+     */
+    recording_mode?: string;
+    /**
+     * GPS fix quality indicator
+     */
+    gps_fix?: "none" | "fix_2d" | "fix_3d" | "dgps" | "unknown";
+}
+/**
+ * A single GPS position/waypoint with timestamp (PWF v2.1)
+ */
+interface GpsPosition {
+    /**
+     * Latitude in decimal degrees (WGS84)
+     */
+    latitude_deg: number;
+    /**
+     * Longitude in decimal degrees (WGS84)
+     */
+    longitude_deg: number;
+    /**
+     * Timestamp when position was recorded (ISO 8601)
+     */
+    timestamp: string;
+    /**
+     * Elevation/altitude above sea level (meters)
+     */
+    elevation_m?: number;
+    /**
+     * Horizontal accuracy/uncertainty (meters)
+     */
+    accuracy_m?: number;
+    /**
+     * Speed at this point (meters per second)
+     */
+    speed_mps?: number;
+    /**
+     * Heading/bearing (degrees from north, 0-360)
+     */
+    heading_deg?: number;
+    /**
+     * Heart rate at this position (bpm)
+     */
+    heart_rate_bpm?: number;
+    /**
+     * Power at this position (watts)
+     */
+    power_watts?: number;
+    /**
+     * Cadence at this position (RPM or SPM)
+     */
+    cadence?: number;
+    /**
+     * Temperature at this position (Celsius)
+     */
+    temperature_c?: number;
+}
+/**
+ * Advanced physiological metrics (PWF v2.1)
+ */
+interface AdvancedMetrics {
+    /**
+     * Aerobic Training Effect score (0.0-5.0)
+     */
+    training_effect?: number;
+    /**
+     * Anaerobic Training Effect score (0.0-5.0)
+     */
+    anaerobic_training_effect?: number;
+    /**
+     * Recommended recovery time in hours
+     */
+    recovery_time_hours?: number;
+    /**
+     * VO2 Max estimate in ml/kg/min
+     */
+    vo2_max_estimate?: number;
+    lactate_threshold?: LactateThreshold;
+    /**
+     * Real-time performance assessment (-20 to +20)
+     */
+    performance_condition?: number;
+    /**
+     * Cumulative training stress (0-1000+)
+     */
+    training_load?: number;
+    /**
+     * Training status assessment
+     */
+    training_status?: "detraining" | "recovery" | "maintaining" | "productive" | "peaking" | "overreaching" | "unknown";
+}
+/**
+ * Lactate threshold data
+ */
+interface LactateThreshold {
+    /**
+     * Heart rate at lactate threshold (bpm)
+     */
+    heart_rate_bpm?: number;
+    /**
+     * Speed at lactate threshold (m/s)
+     */
+    speed_mps?: number;
+    /**
+     * Power at lactate threshold (watts, for cycling)
+     */
+    power_watts?: number;
+    /**
+     * When threshold was detected/calculated
+     */
+    detected_at?: string;
+}
+/**
+ * Power-based cycling metrics (PWF v2.1)
+ */
+interface PowerMetrics {
+    /**
+     * Normalized Power (NP) - weighted average accounting for variability
+     */
+    normalized_power?: number;
+    /**
+     * Training Stress Score (TSS) - quantifies training load
+     */
+    training_stress_score?: number;
+    /**
+     * Intensity Factor (IF) - ratio of NP to FTP
+     */
+    intensity_factor?: number;
+    /**
+     * Variability Index (VI) - ratio of NP to average power
+     */
+    variability_index?: number;
+    /**
+     * Functional Threshold Power used for calculations (watts)
+     */
+    ftp_watts?: number;
+    /**
+     * Total work in kilojoules
+     */
+    total_work_kj?: number;
+    /**
+     * Left/right power balance (percentage left)
+     */
+    left_right_balance?: number;
+    /**
+     * Average left pedal smoothness (percentage)
+     */
+    left_pedal_smoothness?: number;
+    /**
+     * Average right pedal smoothness (percentage)
+     */
+    right_pedal_smoothness?: number;
+    /**
+     * Average left torque effectiveness (percentage)
+     */
+    left_torque_effectiveness?: number;
+    /**
+     * Average right torque effectiveness (percentage)
+     */
+    right_torque_effectiveness?: number;
+}
+/**
+ * Time in HR/power zones (PWF v2.1)
+ */
+interface TimeInZones {
+    /**
+     * Time in each HR zone (seconds per zone)
+     */
+    hr_zones_sec?: number[];
+    /**
+     * Time in each power zone (seconds per zone)
+     */
+    power_zones_sec?: number[];
+    /**
+     * HR zone boundaries in bpm
+     */
+    hr_zone_boundaries?: number[];
+    /**
+     * Power zone boundaries in watts
+     */
+    power_zone_boundaries?: number[];
+    /**
+     * Time in each pace zone (seconds per zone)
+     */
+    pace_zones_sec?: number[];
+    /**
+     * Pace zone boundaries (seconds per km)
+     */
+    pace_zone_boundaries?: number[];
+}
+/**
+ * Information about a device used during the workout (PWF v2)
+ */
+interface DeviceInfo {
+    /**
+     * Device index for multi-device workouts (e.g., 0=watch, 1=HRM, 2=power meter)
+     */
+    device_index?: number;
+    /**
+     * Type of device
+     */
+    device_type: "watch" | "bike_computer" | "heart_rate_monitor" | "power_meter" | "speed_sensor" | "cadence_sensor" | "speed_cadence_sensor" | "foot_pod" | "smart_trainer" | "camera" | "phone" | "other";
+    /**
+     * Device manufacturer (can be a known manufacturer or custom string)
+     */
+    manufacturer: string;
+    /**
+     * Specific product/model name
+     */
+    product?: string;
+    /**
+     * Unique device serial number
+     */
+    serial_number?: string;
+    /**
+     * Software/firmware version
+     */
+    software_version?: string;
+    /**
+     * Hardware version
+     */
+    hardware_version?: string;
+    battery?: BatteryInfo;
+    /**
+     * Cumulative operating time in hours
+     */
+    cumulative_operating_time_hours?: number;
+    connection?: ConnectionInfo;
+    calibration?: CalibrationInfo;
+}
+/**
+ * Battery information
+ */
+interface BatteryInfo {
+    /**
+     * Battery level at start of workout (percentage)
+     */
+    start_percent?: number;
+    /**
+     * Battery level at end of workout (percentage)
+     */
+    end_percent?: number;
+    /**
+     * Battery voltage
+     */
+    voltage?: number;
+    /**
+     * Battery status indicator
+     */
+    status?: "good" | "low" | "critical" | "charging" | "unknown";
+}
+/**
+ * Connection information for sensors
+ */
+interface ConnectionInfo {
+    /**
+     * Type of connection
+     */
+    connection_type: "local" | "ant_plus" | "bluetooth_le" | "bluetooth" | "wifi" | "usb" | "unknown";
+    /**
+     * ANT+ device number (for ANT+ sensors)
+     */
+    ant_device_number?: number;
+    /**
+     * Bluetooth MAC address or identifier
+     */
+    bluetooth_id?: string;
+}
+/**
+ * Calibration information for sensors
+ */
+interface CalibrationInfo {
+    /**
+     * Calibration factor or zero offset
+     */
+    calibration_factor?: number;
+    /**
+     * Timestamp of last calibration
+     */
+    last_calibrated?: string;
+    /**
+     * Auto-zero setting (for power meters)
+     */
+    auto_zero_enabled?: boolean;
+}
+/**
+ * A segment within a multi-sport workout (PWF v2.1)
+ */
+interface SportSegment {
+    /**
+     * Segment identifier
+     */
+    segment_id: string;
+    /**
+     * Sport for this segment
+     */
+    sport: "swimming" | "cycling" | "running" | "rowing" | "transition" | "strength" | "strength-training" | "hiking" | "walking" | "yoga" | "pilates" | "cross-fit" | "calisthenics" | "cardio" | "cross-country-skiing" | "downhill-skiing" | "snowboarding" | "stand-up-paddling" | "kayaking" | "elliptical" | "stair-climbing" | "other";
+    /**
+     * Segment number in sequence (0-indexed)
+     */
+    segment_index: number;
+    /**
+     * When segment started (ISO 8601)
+     */
+    started_at?: string;
+    /**
+     * Segment duration in seconds
+     */
+    duration_sec?: number;
+    /**
+     * Distance covered in this segment (meters)
+     */
+    distance_m?: number;
+    /**
+     * Exercises/sets completed during this segment
+     */
+    exercise_ids?: string[];
+    telemetry?: WorkoutTelemetry1;
+    transition?: TransitionData;
+    /**
+     * Notes specific to this segment
+     */
+    notes?: string;
+}
+/**
+ * Telemetry specific to this segment
+ */
+interface WorkoutTelemetry1 {
+    /**
+     * Average heart rate (bpm)
+     */
+    heart_rate_avg?: number;
+    /**
+     * Maximum heart rate (bpm)
+     */
+    heart_rate_max?: number;
+    /**
+     * Minimum heart rate (bpm)
+     */
+    heart_rate_min?: number;
+    /**
+     * Average power (watts)
+     */
+    power_avg?: number;
+    /**
+     * Maximum power (watts)
+     */
+    power_max?: number;
+    /**
+     * Total distance in meters
+     */
+    total_distance_m?: number;
+    /**
+     * Total distance in kilometers
+     */
+    total_distance_km?: number;
+    /**
+     * Total distance in miles
+     */
+    total_distance_mi?: number;
+    /**
+     * Total elevation gain in meters
+     */
+    total_elevation_gain_m?: number;
+    /**
+     * Total elevation gain in feet
+     */
+    total_elevation_gain_ft?: number;
+    /**
+     * Total elevation loss in meters
+     */
+    total_elevation_loss_m?: number;
+    /**
+     * Total elevation loss in feet
+     */
+    total_elevation_loss_ft?: number;
+    /**
+     * Average speed in km/h
+     */
+    speed_avg_kph?: number;
+    /**
+     * Average speed in mph
+     */
+    speed_avg_mph?: number;
+    /**
+     * Maximum speed in km/h
+     */
+    speed_max_kph?: number;
+    /**
+     * Maximum speed in mph
+     */
+    speed_max_mph?: number;
+    /**
+     * Average pace in seconds per km
+     */
+    pace_avg_sec_per_km?: number;
+    /**
+     * Average pace in seconds per mile
+     */
+    pace_avg_sec_per_mi?: number;
+    /**
+     * Average cadence (RPM or SPM)
+     */
+    cadence_avg?: number;
+    /**
+     * Temperature in Celsius
+     */
+    temperature_c?: number;
+    /**
+     * Temperature in Fahrenheit
+     */
+    temperature_f?: number;
+    /**
+     * Humidity percentage
+     */
+    humidity_percent?: number;
+    /**
+     * Total calories burned
+     */
+    total_calories?: number;
+    /**
+     * GPS route identifier
+     */
+    gps_route_id?: string;
+    gps_route?: GpsRoute;
+    advanced_metrics?: AdvancedMetrics;
+    power_metrics?: PowerMetrics;
+    time_in_zones?: TimeInZones;
+}
+/**
+ * Transition data after this segment
+ */
+interface TransitionData {
+    /**
+     * Transition identifier (e.g., T1, T2)
+     */
+    transition_id: string;
+    /**
+     * From which sport
+     */
+    from_sport: "swimming" | "cycling" | "running" | "rowing" | "transition" | "strength" | "strength-training" | "hiking" | "walking" | "yoga" | "pilates" | "cross-fit" | "calisthenics" | "cardio" | "cross-country-skiing" | "downhill-skiing" | "snowboarding" | "stand-up-paddling" | "kayaking" | "elliptical" | "stair-climbing" | "other";
+    /**
+     * To which sport
+     */
+    to_sport: "swimming" | "cycling" | "running" | "rowing" | "transition" | "strength" | "strength-training" | "hiking" | "walking" | "yoga" | "pilates" | "cross-fit" | "calisthenics" | "cardio" | "cross-country-skiing" | "downhill-skiing" | "snowboarding" | "stand-up-paddling" | "kayaking" | "elliptical" | "stair-climbing" | "other";
+    /**
+     * Transition duration in seconds
+     */
+    duration_sec?: number;
+    /**
+     * When transition started (ISO 8601)
+     */
+    started_at?: string;
+    /**
+     * Average heart rate during transition
+     */
+    heart_rate_avg?: number;
+    /**
+     * Notes about transition (e.g., equipment changes)
+     */
+    notes?: string;
+}
+interface PersonalRecord {
+    /**
+     * Exercise name
+     */
+    exercise_name: string;
+    /**
+     * Type of record
+     */
+    record_type: "1rm" | "max_weight_3rm" | "max_weight_5rm" | "max_weight_8rm" | "max_weight_10rm" | "max_weight" | "max_reps" | "max_volume" | "max_duration" | "max_distance" | "fastest_time";
+    /**
+     * Record value
+     */
+    value: number;
+    /**
+     * Unit for the value
+     */
+    unit?: string;
+    /**
+     * Date achieved
+     */
+    achieved_at: string;
+    /**
+     * Reference to workout
+     */
+    workout_id?: string;
+    /**
+     * Additional notes
+     */
+    notes?: string;
+}
+interface BodyMeasurement {
+    /**
+     * Measurement date
+     */
+    date: string;
+    /**
+     * Exact timestamp
+     */
+    recorded_at?: string;
+    /**
+     * Body weight in kg
+     */
+    weight_kg?: number;
+    /**
+     * Body weight in lb
+     */
+    weight_lb?: number;
+    /**
+     * Body fat percentage
+     */
+    body_fat_percent?: number;
+    /**
+     * Notes
+     */
+    notes?: string;
+    measurements?: BodyDimensions;
+}
+interface BodyDimensions {
+    neck_cm?: number;
+    shoulders_cm?: number;
+    chest_cm?: number;
+    waist_cm?: number;
+    hips_cm?: number;
+    bicep_left_cm?: number;
+    bicep_right_cm?: number;
+    forearm_left_cm?: number;
+    forearm_right_cm?: number;
+    thigh_left_cm?: number;
+    thigh_right_cm?: number;
+    calf_left_cm?: number;
+    calf_right_cm?: number;
+}
+
+type Severity = 'error' | 'warning';
+interface ValidationIssue {
+    path: string;
+    message: string;
+    severity: Severity;
+    code?: string;
+}
+type ValidationError = ValidationIssue;
+type ValidationWarning = ValidationIssue;
+interface ValidationOptions {
+    strict?: boolean;
+}
+interface ParseOptions extends ValidationOptions {
+}
+type PlanMeta = Meta;
+type PlanExercise = Exercise;
+type PlanDay = Day;
+type PlanCycle = Cycle;
+type PwfPlan = PWFPlanV1;
+type Modality = PlanExercise['modality'];
+interface PlanDocument extends PwfPlan {
+    toYAML(): string;
+}
+type HistoryExercise = CompletedExercise;
+type HistoryWorkout = Workout;
+type PwfHistory = PWFHistoryExportV1;
+
+declare function parsePlan(text: string, options?: ParseOptions): PwfPlan | ValidationIssue[];
+declare function parseHistory(text: string, options?: ParseOptions): PwfHistory | ValidationIssue[];
+declare function isValidationIssueList(value: unknown): value is ValidationIssue[];
+declare function toYAML(value: unknown): string;
+declare function fromYAML<T>(text: string): T;
+
+declare function validatePlan(plan: unknown, _options?: ValidationOptions): ValidationIssue[];
+declare function validateHistory(history: unknown, _options?: ValidationOptions): ValidationIssue[];
+
+type PlanDayDraft = Omit<NonNullable<PwfPlan['cycle']>['days'][number], 'exercises'> & {
+    exercises?: PlanExercise[];
+};
+declare class PlanBuilder {
+    private plan;
+    private currentDayIndex;
+    constructor();
+    version(version: PwfPlan['plan_version']): this;
+    meta(meta: PlanMeta): this;
+    glossary(glossary: Record<string, string>): this;
+    addDay(focus?: string, dayOverrides?: Partial<PlanDayDraft>): this;
+    addExercise(name: string, exercise: Omit<PlanExercise, 'name'>): this;
+    toYAML(): string;
+    build(): PlanDocument;
+}
+
+var $schema$1 = "http://json-schema.org/draft-07/schema#";
+var $id$1 = "https://pwf.dev/schema/v1/plan.json";
+var title$1 = "PWF Plan v1";
+var description$1 = "Portable Workout Format v1 schema for validating plan documents";
+var type$1 = "object";
+var required$1 = [
+	"plan_version",
+	"cycle"
+];
+var additionalProperties$1 = false;
+var properties$1 = {
+	plan_version: {
+		type: "integer",
+		"const": 1,
+		description: "Specification version (must be 1)"
+	},
+	meta: {
+		$ref: "#/$defs/Meta"
+	},
+	glossary: {
+		type: "object",
+		description: "Term definitions for exercises and concepts used in this plan",
+		maxProperties: 100,
+		additionalProperties: {
+			type: "string",
+			minLength: 1,
+			maxLength: 500
+		},
+		propertyNames: {
+			pattern: "^[a-zA-Z0-9\\s\\-']+$",
+			minLength: 1,
+			maxLength: 50
+		}
+	},
+	cycle: {
+		$ref: "#/$defs/Cycle"
+	}
+};
+var $defs$1 = {
+	Meta: {
+		type: "object",
+		description: "Plan metadata for display and organization",
+		additionalProperties: false,
+		required: [
+			"title"
+		],
+		properties: {
+			id: {
+				type: "string",
+				description: "Unique plan identifier"
+			},
+			title: {
+				type: "string",
+				maxLength: 80,
+				minLength: 1,
+				description: "Plan display name"
+			},
+			description: {
+				type: "string",
+				description: "Brief plan description"
+			},
+			author: {
+				type: "string",
+				description: "Coach or creator name"
+			},
+			status: {
+				type: "string",
+				"enum": [
+					"draft",
+					"active",
+					"completed",
+					"archived"
+				],
+				"default": "draft",
+				description: "Plan status"
+			},
+			activated_at: {
+				type: "string",
+				format: "date-time",
+				pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(Z|[+-]\\d{2}:\\d{2})$",
+				description: "ISO 8601 timestamp when plan was activated"
+			},
+			completed_at: {
+				type: "string",
+				format: "date-time",
+				pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(Z|[+-]\\d{2}:\\d{2})$",
+				description: "ISO 8601 timestamp when plan was completed"
+			},
+			equipment: {
+				type: "array",
+				items: {
+					type: "string"
+				},
+				uniqueItems: true,
+				description: "Required equipment tags"
+			},
+			daysPerWeek: {
+				type: "integer",
+				minimum: 1,
+				maximum: 7,
+				description: "Intended training frequency"
+			},
+			recommendedFirst: {
+				type: "boolean",
+				"default": false,
+				description: "Suggest as starter plan"
+			},
+			tags: {
+				type: "array",
+				items: {
+					type: "string"
+				},
+				description: "Searchable tags"
+			},
+			athlete_profile: {
+				$ref: "#/$defs/AthleteProfile"
+			}
+		}
+	},
+	AthleteProfile: {
+		type: "object",
+		description: "Athlete metrics for endurance training",
+		additionalProperties: false,
+		properties: {
+			ftp_watts: {
+				type: "integer",
+				minimum: 0,
+				description: "Functional Threshold Power in watts"
+			},
+			threshold_hr_bpm: {
+				type: "integer",
+				minimum: 0,
+				maximum: 250,
+				description: "Threshold heart rate in BPM"
+			},
+			max_hr_bpm: {
+				type: "integer",
+				minimum: 0,
+				maximum: 250,
+				description: "Maximum heart rate in BPM"
+			},
+			threshold_pace_sec_per_km: {
+				type: "integer",
+				minimum: 0,
+				description: "Threshold pace in seconds per kilometer"
+			},
+			weight_kg: {
+				type: "number",
+				minimum: 0,
+				description: "Athlete weight in kilograms"
+			}
+		}
+	},
+	Cycle: {
+		type: "object",
+		description: "Training cycle containing workout days",
+		additionalProperties: false,
+		required: [
+			"days"
+		],
+		properties: {
+			start_date: {
+				type: "string",
+				format: "date",
+				pattern: "^\\d{4}-\\d{2}-\\d{2}$",
+				description: "ISO 8601 date (YYYY-MM-DD)"
+			},
+			notes: {
+				type: "string",
+				description: "Cycle-level coaching notes"
+			},
+			days: {
+				type: "array",
+				minItems: 1,
+				items: {
+					$ref: "#/$defs/Day"
+				},
+				description: "Training days in this cycle"
+			}
+		}
+	},
+	Day: {
+		type: "object",
+		description: "Single training day",
+		additionalProperties: false,
+		required: [
+			"exercises"
+		],
+		properties: {
+			id: {
+				type: "string",
+				description: "Unique day identifier"
+			},
+			order: {
+				type: "integer",
+				minimum: 0,
+				description: "Day sequence (0-indexed)"
+			},
+			focus: {
+				type: "string",
+				description: "Training focus or theme"
+			},
+			notes: {
+				type: "string",
+				description: "Day-level coaching notes"
+			},
+			scheduled_date: {
+				type: "string",
+				format: "date",
+				pattern: "^\\d{4}-\\d{2}-\\d{2}$",
+				description: "Planned workout date"
+			},
+			target_session_length_min: {
+				type: "integer",
+				minimum: 1,
+				description: "Expected duration in minutes"
+			},
+			exercises: {
+				type: "array",
+				minItems: 1,
+				items: {
+					$ref: "#/$defs/Exercise"
+				},
+				description: "Exercises in this day"
+			}
+		}
+	},
+	Exercise: {
+		type: "object",
+		description: "Single exercise definition",
+		additionalProperties: false,
+		required: [
+			"modality"
+		],
+		properties: {
+			id: {
+				type: "string",
+				description: "Unique exercise identifier"
+			},
+			name: {
+				type: "string",
+				description: "Exercise name"
+			},
+			modality: {
+				type: "string",
+				"enum": [
+					"strength",
+					"countdown",
+					"stopwatch",
+					"interval",
+					"cycling",
+					"running",
+					"rowing",
+					"swimming"
+				],
+				description: "Exercise type"
+			},
+			target_sets: {
+				type: "integer",
+				minimum: 1,
+				description: "Target number of sets"
+			},
+			target_reps: {
+				type: "integer",
+				minimum: 1,
+				description: "Target reps per set"
+			},
+			target_duration_sec: {
+				type: "integer",
+				minimum: 1,
+				description: "Target duration in seconds"
+			},
+			target_distance_meters: {
+				type: "number",
+				minimum: 0,
+				description: "Target distance in meters"
+			},
+			target_load: {
+				type: "string",
+				description: "Loading guidance (weight, RPE, %1RM)"
+			},
+			target_weight_percent: {
+				type: "number",
+				minimum: 0,
+				maximum: 200,
+				description: "Target weight as percentage of reference max (requires percent_of)"
+			},
+			percent_of: {
+				type: "string",
+				"enum": [
+					"1rm",
+					"3rm",
+					"5rm",
+					"10rm"
+				],
+				description: "Reference max for percentage calculation (requires target_weight_percent)"
+			},
+			reference_exercise: {
+				type: "string",
+				description: "Reference another exercise's max for percentage calculation"
+			},
+			cues: {
+				type: "string",
+				description: "Form cues (alias for target_notes)"
+			},
+			target_notes: {
+				type: "string",
+				description: "Coaching notes for this exercise"
+			},
+			link: {
+				type: "string",
+				format: "uri",
+				pattern: "^https://",
+				description: "Tutorial URL (HTTPS only)"
+			},
+			image: {
+				type: "string",
+				format: "uri",
+				pattern: "^https://",
+				description: "Demo image URL (HTTPS only)"
+			},
+			group: {
+				type: "string",
+				minLength: 1,
+				maxLength: 50,
+				pattern: "^[a-zA-Z0-9_-]+$",
+				description: "Group identifier for supersets/circuits (alphanumeric, hyphens, underscores only)"
+			},
+			group_type: {
+				type: "string",
+				"enum": [
+					"superset",
+					"circuit"
+				],
+				description: "Type of exercise grouping"
+			},
+			rest_between_sets_sec: {
+				type: "integer",
+				minimum: 0,
+				description: "Rest period in seconds between sets"
+			},
+			rest_after_sec: {
+				type: "integer",
+				minimum: 0,
+				description: "Rest period in seconds after completing all sets"
+			},
+			zones: {
+				type: "array",
+				minItems: 1,
+				items: {
+					$ref: "#/$defs/TrainingZone"
+				},
+				description: "Training zones for endurance workouts"
+			},
+			ramp: {
+				$ref: "#/$defs/RampConfig"
+			},
+			interval_phases: {
+				type: "array",
+				minItems: 1,
+				items: {
+					$ref: "#/$defs/IntervalPhase"
+				},
+				description: "Structured interval phases for complex endurance workouts"
+			}
+		}
+	},
+	TrainingZone: {
+		type: "object",
+		description: "Training zone specification",
+		additionalProperties: false,
+		required: [
+			"zone"
+		],
+		properties: {
+			zone: {
+				type: "integer",
+				minimum: 1,
+				maximum: 7,
+				description: "Training zone number (1-7)"
+			},
+			duration_sec: {
+				type: "integer",
+				minimum: 0,
+				description: "Duration in this zone (seconds)"
+			},
+			target_power_watts: {
+				type: "integer",
+				minimum: 0,
+				description: "Target power in watts"
+			},
+			target_hr_bpm: {
+				type: "integer",
+				minimum: 0,
+				maximum: 250,
+				description: "Target heart rate in BPM"
+			},
+			target_pace_sec_per_km: {
+				type: "integer",
+				minimum: 0,
+				description: "Target pace in seconds per kilometer"
+			}
+		}
+	},
+	RampConfig: {
+		type: "object",
+		description: "Ramp configuration for gradual intensity changes",
+		additionalProperties: false,
+		required: [
+			"start_power_watts",
+			"end_power_watts",
+			"duration_sec"
+		],
+		properties: {
+			start_power_watts: {
+				type: "integer",
+				minimum: 0,
+				description: "Starting power in watts"
+			},
+			end_power_watts: {
+				type: "integer",
+				minimum: 0,
+				description: "Ending power in watts"
+			},
+			duration_sec: {
+				type: "integer",
+				minimum: 1,
+				description: "Ramp duration in seconds"
+			},
+			step_duration_sec: {
+				type: "integer",
+				minimum: 1,
+				description: "Duration of each step in seconds"
+			}
+		}
+	},
+	IntervalPhase: {
+		type: "object",
+		description: "Phase in a structured interval workout",
+		additionalProperties: false,
+		required: [
+			"name",
+			"duration_sec"
+		],
+		properties: {
+			name: {
+				type: "string",
+				minLength: 1,
+				description: "Phase name (e.g., 'warmup', 'work', 'recovery')"
+			},
+			duration_sec: {
+				type: "integer",
+				minimum: 1,
+				description: "Phase duration in seconds"
+			},
+			target_power_watts: {
+				type: "integer",
+				minimum: 0,
+				description: "Target power in watts"
+			},
+			target_hr_bpm: {
+				type: "integer",
+				minimum: 0,
+				maximum: 250,
+				description: "Target heart rate in BPM"
+			},
+			target_pace_sec_per_km: {
+				type: "integer",
+				minimum: 0,
+				description: "Target pace in seconds per kilometer"
+			},
+			cadence_rpm: {
+				type: "integer",
+				minimum: 0,
+				description: "Target cadence in RPM"
+			}
+		}
+	}
+};
+var pwfV1 = {
+	$schema: $schema$1,
+	$id: $id$1,
+	title: title$1,
+	description: description$1,
+	type: type$1,
+	required: required$1,
+	additionalProperties: additionalProperties$1,
+	properties: properties$1,
+	$defs: $defs$1
+};
+
+var $schema = "http://json-schema.org/draft-07/schema#";
+var $id = "https://pwf.dev/schema/v1/history.json";
+var title = "PWF History Export v1";
+var description = "Schema for validating PWF workout history exports";
+var type = "object";
+var required = [
+	"history_version",
+	"exported_at",
+	"workouts"
+];
+var additionalProperties = false;
+var properties = {
+	history_version: {
+		type: "integer",
+		"const": 1,
+		description: "Specification version (must be 1)"
+	},
+	exported_at: {
+		type: "string",
+		format: "date-time",
+		description: "ISO 8601 datetime when export was created"
+	},
+	export_source: {
+		$ref: "#/$defs/ExportSource"
+	},
+	units: {
+		$ref: "#/$defs/Units"
+	},
+	workouts: {
+		type: "array",
+		items: {
+			$ref: "#/$defs/Workout"
+		},
+		description: "Completed workout sessions"
+	},
+	personal_records: {
+		type: "array",
+		items: {
+			$ref: "#/$defs/PersonalRecord"
+		},
+		description: "Personal records achieved"
+	},
+	body_measurements: {
+		type: "array",
+		items: {
+			$ref: "#/$defs/BodyMeasurement"
+		},
+		description: "Body measurements recorded"
+	}
+};
+var $defs = {
+	ExportSource: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			app_name: {
+				type: "string",
+				description: "Application name"
+			},
+			app_version: {
+				type: "string",
+				description: "Application version"
+			},
+			platform: {
+				type: "string",
+				"enum": [
+					"ios",
+					"android",
+					"web",
+					"desktop"
+				],
+				description: "Platform"
+			},
+			preferred_units: {
+				$ref: "#/$defs/Units",
+				description: "User's preferred units"
+			}
+		}
+	},
+	Units: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			weight: {
+				type: "string",
+				"enum": [
+					"kg",
+					"lb"
+				],
+				"default": "kg"
+			},
+			distance: {
+				type: "string",
+				"enum": [
+					"meters",
+					"kilometers",
+					"miles",
+					"feet",
+					"yards"
+				],
+				"default": "meters"
+			}
+		}
+	},
+	Workout: {
+		type: "object",
+		required: [
+			"date",
+			"exercises"
+		],
+		additionalProperties: false,
+		properties: {
+			id: {
+				type: "string",
+				description: "Unique workout identifier"
+			},
+			date: {
+				type: "string",
+				format: "date",
+				description: "Workout date (YYYY-MM-DD)"
+			},
+			started_at: {
+				type: "string",
+				format: "date-time",
+				description: "Start timestamp"
+			},
+			ended_at: {
+				type: "string",
+				format: "date-time",
+				description: "End timestamp"
+			},
+			duration_sec: {
+				type: "integer",
+				minimum: 0,
+				description: "Total duration in seconds"
+			},
+			title: {
+				type: "string",
+				description: "Workout title"
+			},
+			notes: {
+				type: "string",
+				description: "Workout notes"
+			},
+			plan_id: {
+				type: "string",
+				description: "Reference to PWF plan"
+			},
+			plan_day_id: {
+				type: "string",
+				description: "Reference to plan day"
+			},
+			exercises: {
+				type: "array",
+				items: {
+					$ref: "#/$defs/CompletedExercise"
+				},
+				description: "Exercises performed"
+			},
+			telemetry: {
+				$ref: "#/$defs/WorkoutTelemetry",
+				description: "Telemetry metrics for entire workout session (PWF v2)"
+			},
+			devices: {
+				type: "array",
+				items: {
+					$ref: "#/$defs/DeviceInfo"
+				},
+				description: "Devices used during workout (PWF v2)"
+			},
+			sport: {
+				$ref: "#/$defs/Sport",
+				description: "Primary sport for this workout (PWF v2.1)"
+			},
+			sport_segments: {
+				type: "array",
+				items: {
+					$ref: "#/$defs/SportSegment"
+				},
+				description: "Sport segments for multi-sport workouts like triathlon (PWF v2.1)"
+			}
+		}
+	},
+	CompletedExercise: {
+		type: "object",
+		required: [
+			"name",
+			"sets"
+		],
+		additionalProperties: false,
+		properties: {
+			id: {
+				type: "string",
+				description: "Unique exercise identifier"
+			},
+			name: {
+				type: "string",
+				minLength: 1,
+				description: "Exercise name"
+			},
+			modality: {
+				type: "string",
+				"enum": [
+					"strength",
+					"countdown",
+					"stopwatch",
+					"interval",
+					"swimming"
+				],
+				description: "Exercise modality"
+			},
+			notes: {
+				type: "string",
+				description: "Exercise-level notes"
+			},
+			sets: {
+				type: "array",
+				items: {
+					$ref: "#/$defs/CompletedSet"
+				},
+				description: "Completed sets"
+			},
+			pool_config: {
+				$ref: "#/$defs/PoolConfig",
+				description: "Pool configuration for swimming exercises (PWF v2.1)"
+			},
+			sport: {
+				$ref: "#/$defs/Sport",
+				description: "Sport classification for this exercise (PWF v2.1)"
+			}
+		}
+	},
+	CompletedSet: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			set_number: {
+				type: "integer",
+				minimum: 1,
+				description: "Set order (1-indexed)"
+			},
+			set_type: {
+				type: "string",
+				"enum": [
+					"working",
+					"warmup",
+					"dropset",
+					"failure",
+					"amrap"
+				],
+				"default": "working",
+				description: "Type of set"
+			},
+			reps: {
+				type: "integer",
+				minimum: 0,
+				description: "Repetitions completed"
+			},
+			weight_kg: {
+				type: "number",
+				minimum: 0,
+				description: "Weight in kilograms"
+			},
+			weight_lb: {
+				type: "number",
+				minimum: 0,
+				description: "Weight in pounds"
+			},
+			duration_sec: {
+				type: "integer",
+				minimum: 0,
+				description: "Duration in seconds"
+			},
+			distance_meters: {
+				type: "number",
+				minimum: 0,
+				description: "Distance in meters"
+			},
+			rpe: {
+				type: "number",
+				minimum: 0,
+				maximum: 10,
+				description: "Rate of Perceived Exertion (1-10 scale)"
+			},
+			rir: {
+				type: "integer",
+				minimum: 0,
+				maximum: 10,
+				description: "Reps in Reserve (alternative to RPE)"
+			},
+			notes: {
+				type: "string",
+				description: "Set-level notes"
+			},
+			is_pr: {
+				type: "boolean",
+				description: "Whether this set was a personal record"
+			},
+			completed_at: {
+				type: "string",
+				format: "date-time",
+				description: "When set was completed"
+			},
+			telemetry: {
+				$ref: "#/$defs/SetTelemetry",
+				description: "Telemetry metrics for this set (PWF v2)"
+			},
+			swimming: {
+				$ref: "#/$defs/SwimmingSetData",
+				description: "Swimming-specific data for this set (PWF v2.1)"
+			}
+		}
+	},
+	PersonalRecord: {
+		type: "object",
+		required: [
+			"exercise_name",
+			"record_type",
+			"value",
+			"achieved_at"
+		],
+		additionalProperties: false,
+		properties: {
+			exercise_name: {
+				type: "string",
+				minLength: 1,
+				description: "Exercise name"
+			},
+			record_type: {
+				type: "string",
+				"enum": [
+					"1rm",
+					"max_weight_3rm",
+					"max_weight_5rm",
+					"max_weight_8rm",
+					"max_weight_10rm",
+					"max_weight",
+					"max_reps",
+					"max_volume",
+					"max_duration",
+					"max_distance",
+					"fastest_time"
+				],
+				description: "Type of record"
+			},
+			value: {
+				type: "number",
+				description: "Record value"
+			},
+			unit: {
+				type: "string",
+				description: "Unit for the value"
+			},
+			achieved_at: {
+				type: "string",
+				format: "date",
+				description: "Date achieved"
+			},
+			workout_id: {
+				type: "string",
+				description: "Reference to workout"
+			},
+			notes: {
+				type: "string",
+				description: "Additional notes"
+			}
+		}
+	},
+	BodyMeasurement: {
+		type: "object",
+		required: [
+			"date"
+		],
+		additionalProperties: false,
+		properties: {
+			date: {
+				type: "string",
+				format: "date",
+				description: "Measurement date"
+			},
+			recorded_at: {
+				type: "string",
+				format: "date-time",
+				description: "Exact timestamp"
+			},
+			weight_kg: {
+				type: "number",
+				minimum: 0,
+				description: "Body weight in kg"
+			},
+			weight_lb: {
+				type: "number",
+				minimum: 0,
+				description: "Body weight in lb"
+			},
+			body_fat_percent: {
+				type: "number",
+				minimum: 0,
+				maximum: 100,
+				description: "Body fat percentage"
+			},
+			notes: {
+				type: "string",
+				description: "Notes"
+			},
+			measurements: {
+				$ref: "#/$defs/BodyDimensions"
+			}
+		}
+	},
+	BodyDimensions: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			neck_cm: {
+				type: "number",
+				minimum: 0
+			},
+			shoulders_cm: {
+				type: "number",
+				minimum: 0
+			},
+			chest_cm: {
+				type: "number",
+				minimum: 0
+			},
+			waist_cm: {
+				type: "number",
+				minimum: 0
+			},
+			hips_cm: {
+				type: "number",
+				minimum: 0
+			},
+			bicep_left_cm: {
+				type: "number",
+				minimum: 0
+			},
+			bicep_right_cm: {
+				type: "number",
+				minimum: 0
+			},
+			forearm_left_cm: {
+				type: "number",
+				minimum: 0
+			},
+			forearm_right_cm: {
+				type: "number",
+				minimum: 0
+			},
+			thigh_left_cm: {
+				type: "number",
+				minimum: 0
+			},
+			thigh_right_cm: {
+				type: "number",
+				minimum: 0
+			},
+			calf_left_cm: {
+				type: "number",
+				minimum: 0
+			},
+			calf_right_cm: {
+				type: "number",
+				minimum: 0
+			}
+		}
+	},
+	Sport: {
+		type: "string",
+		"enum": [
+			"swimming",
+			"cycling",
+			"running",
+			"rowing",
+			"transition",
+			"strength",
+			"strength-training",
+			"hiking",
+			"walking",
+			"yoga",
+			"pilates",
+			"cross-fit",
+			"calisthenics",
+			"cardio",
+			"cross-country-skiing",
+			"downhill-skiing",
+			"snowboarding",
+			"stand-up-paddling",
+			"kayaking",
+			"elliptical",
+			"stair-climbing",
+			"other"
+		],
+		description: "Sport classification (PWF v2.1)"
+	},
+	WorkoutTelemetry: {
+		type: "object",
+		additionalProperties: false,
+		description: "Telemetry metrics for entire workout session (PWF v2)",
+		properties: {
+			heart_rate_avg: {
+				type: "integer",
+				minimum: 0,
+				description: "Average heart rate (bpm)"
+			},
+			heart_rate_max: {
+				type: "integer",
+				minimum: 0,
+				description: "Maximum heart rate (bpm)"
+			},
+			heart_rate_min: {
+				type: "integer",
+				minimum: 0,
+				description: "Minimum heart rate (bpm)"
+			},
+			power_avg: {
+				type: "integer",
+				minimum: 0,
+				description: "Average power (watts)"
+			},
+			power_max: {
+				type: "integer",
+				minimum: 0,
+				description: "Maximum power (watts)"
+			},
+			total_distance_m: {
+				type: "number",
+				minimum: 0,
+				description: "Total distance in meters"
+			},
+			total_distance_km: {
+				type: "number",
+				minimum: 0,
+				description: "Total distance in kilometers"
+			},
+			total_distance_mi: {
+				type: "number",
+				minimum: 0,
+				description: "Total distance in miles"
+			},
+			total_elevation_gain_m: {
+				type: "number",
+				description: "Total elevation gain in meters"
+			},
+			total_elevation_gain_ft: {
+				type: "number",
+				description: "Total elevation gain in feet"
+			},
+			total_elevation_loss_m: {
+				type: "number",
+				description: "Total elevation loss in meters"
+			},
+			total_elevation_loss_ft: {
+				type: "number",
+				description: "Total elevation loss in feet"
+			},
+			speed_avg_kph: {
+				type: "number",
+				minimum: 0,
+				description: "Average speed in km/h"
+			},
+			speed_avg_mph: {
+				type: "number",
+				minimum: 0,
+				description: "Average speed in mph"
+			},
+			speed_max_kph: {
+				type: "number",
+				minimum: 0,
+				description: "Maximum speed in km/h"
+			},
+			speed_max_mph: {
+				type: "number",
+				minimum: 0,
+				description: "Maximum speed in mph"
+			},
+			pace_avg_sec_per_km: {
+				type: "integer",
+				minimum: 0,
+				description: "Average pace in seconds per km"
+			},
+			pace_avg_sec_per_mi: {
+				type: "integer",
+				minimum: 0,
+				description: "Average pace in seconds per mile"
+			},
+			cadence_avg: {
+				type: "integer",
+				minimum: 0,
+				description: "Average cadence (RPM or SPM)"
+			},
+			temperature_c: {
+				type: "number",
+				description: "Temperature in Celsius"
+			},
+			temperature_f: {
+				type: "number",
+				description: "Temperature in Fahrenheit"
+			},
+			humidity_percent: {
+				type: "number",
+				minimum: 0,
+				maximum: 100,
+				description: "Humidity percentage"
+			},
+			total_calories: {
+				type: "integer",
+				minimum: 0,
+				description: "Total calories burned"
+			},
+			gps_route_id: {
+				type: "string",
+				description: "GPS route identifier"
+			},
+			gps_route: {
+				$ref: "#/$defs/GpsRoute",
+				description: "Full GPS route data (PWF v2.1)"
+			},
+			advanced_metrics: {
+				$ref: "#/$defs/AdvancedMetrics",
+				description: "Advanced physiological metrics (PWF v2.1)"
+			},
+			power_metrics: {
+				$ref: "#/$defs/PowerMetrics",
+				description: "Power-based cycling metrics (PWF v2.1)"
+			},
+			time_in_zones: {
+				$ref: "#/$defs/TimeInZones",
+				description: "Time in HR/power zones (PWF v2.1)"
+			}
+		}
+	},
+	SetTelemetry: {
+		type: "object",
+		additionalProperties: false,
+		description: "Telemetry metrics for a completed set (PWF v2)",
+		properties: {
+			heart_rate_avg: {
+				type: "integer",
+				minimum: 0,
+				description: "Average heart rate (bpm)"
+			},
+			heart_rate_max: {
+				type: "integer",
+				minimum: 0,
+				description: "Maximum heart rate (bpm)"
+			},
+			heart_rate_min: {
+				type: "integer",
+				minimum: 0,
+				description: "Minimum heart rate (bpm)"
+			},
+			power_avg: {
+				type: "integer",
+				minimum: 0,
+				description: "Average power (watts)"
+			},
+			power_max: {
+				type: "integer",
+				minimum: 0,
+				description: "Maximum power (watts)"
+			},
+			power_min: {
+				type: "integer",
+				minimum: 0,
+				description: "Minimum power (watts)"
+			},
+			elevation_gain_m: {
+				type: "number",
+				description: "Elevation gain in meters"
+			},
+			elevation_gain_ft: {
+				type: "number",
+				description: "Elevation gain in feet"
+			},
+			elevation_loss_m: {
+				type: "number",
+				description: "Elevation loss in meters"
+			},
+			elevation_loss_ft: {
+				type: "number",
+				description: "Elevation loss in feet"
+			},
+			speed_avg_mps: {
+				type: "number",
+				minimum: 0,
+				description: "Average speed in m/s"
+			},
+			speed_avg_kph: {
+				type: "number",
+				minimum: 0,
+				description: "Average speed in km/h"
+			},
+			speed_avg_mph: {
+				type: "number",
+				minimum: 0,
+				description: "Average speed in mph"
+			},
+			speed_max_mps: {
+				type: "number",
+				minimum: 0,
+				description: "Maximum speed in m/s"
+			},
+			speed_max_kph: {
+				type: "number",
+				minimum: 0,
+				description: "Maximum speed in km/h"
+			},
+			speed_max_mph: {
+				type: "number",
+				minimum: 0,
+				description: "Maximum speed in mph"
+			},
+			pace_avg_sec_per_km: {
+				type: "integer",
+				minimum: 0,
+				description: "Average pace in seconds per km"
+			},
+			pace_avg_sec_per_mi: {
+				type: "integer",
+				minimum: 0,
+				description: "Average pace in seconds per mile"
+			},
+			cadence_avg: {
+				type: "integer",
+				minimum: 0,
+				description: "Average cadence (RPM or SPM)"
+			},
+			cadence_max: {
+				type: "integer",
+				minimum: 0,
+				description: "Maximum cadence (RPM or SPM)"
+			},
+			temperature_c: {
+				type: "number",
+				description: "Temperature in Celsius"
+			},
+			temperature_f: {
+				type: "number",
+				description: "Temperature in Fahrenheit"
+			},
+			humidity_percent: {
+				type: "number",
+				minimum: 0,
+				maximum: 100,
+				description: "Humidity percentage"
+			},
+			calories: {
+				type: "integer",
+				minimum: 0,
+				description: "Calories burned in this set"
+			},
+			stroke_rate: {
+				type: "integer",
+				minimum: 0,
+				description: "Stroke rate for swimming/rowing (strokes per minute)"
+			},
+			gps_route_id: {
+				type: "string",
+				description: "GPS route identifier"
+			},
+			time_series: {
+				$ref: "#/$defs/TimeSeriesData",
+				description: "Second-by-second time-series data (PWF v2.1)"
+			}
+		}
+	},
+	AdvancedMetrics: {
+		type: "object",
+		additionalProperties: false,
+		description: "Advanced physiological and performance metrics (PWF v2.1)",
+		properties: {
+			training_effect: {
+				type: "number",
+				minimum: 0,
+				maximum: 5,
+				description: "Aerobic Training Effect score (0.0-5.0)"
+			},
+			anaerobic_training_effect: {
+				type: "number",
+				minimum: 0,
+				maximum: 5,
+				description: "Anaerobic Training Effect score (0.0-5.0)"
+			},
+			recovery_time_hours: {
+				type: "integer",
+				minimum: 0,
+				description: "Recommended recovery time in hours"
+			},
+			vo2_max_estimate: {
+				type: "number",
+				minimum: 0,
+				description: "VO2 Max estimate in ml/kg/min"
+			},
+			lactate_threshold: {
+				$ref: "#/$defs/LactateThreshold",
+				description: "Lactate threshold data"
+			},
+			performance_condition: {
+				type: "integer",
+				minimum: -20,
+				maximum: 20,
+				description: "Real-time performance assessment (-20 to +20)"
+			},
+			training_load: {
+				type: "integer",
+				minimum: 0,
+				description: "Cumulative training stress (0-1000+)"
+			},
+			training_status: {
+				$ref: "#/$defs/TrainingStatus",
+				description: "Training status assessment"
+			}
+		}
+	},
+	LactateThreshold: {
+		type: "object",
+		additionalProperties: false,
+		description: "Lactate threshold tracking",
+		properties: {
+			heart_rate_bpm: {
+				type: "integer",
+				minimum: 0,
+				description: "Heart rate at lactate threshold (bpm)"
+			},
+			speed_mps: {
+				type: "number",
+				minimum: 0,
+				description: "Speed at lactate threshold (m/s)"
+			},
+			power_watts: {
+				type: "integer",
+				minimum: 0,
+				description: "Power at lactate threshold (watts, for cycling)"
+			},
+			detected_at: {
+				type: "string",
+				format: "date-time",
+				description: "When threshold was detected/calculated"
+			}
+		}
+	},
+	TrainingStatus: {
+		type: "string",
+		"enum": [
+			"detraining",
+			"recovery",
+			"maintaining",
+			"productive",
+			"peaking",
+			"overreaching",
+			"unknown"
+		],
+		description: "Training status classification"
+	},
+	PowerMetrics: {
+		type: "object",
+		additionalProperties: false,
+		description: "Power-based cycling metrics (PWF v2.1)",
+		properties: {
+			normalized_power: {
+				type: "integer",
+				minimum: 0,
+				description: "Normalized Power (NP) - weighted average accounting for variability"
+			},
+			training_stress_score: {
+				type: "number",
+				minimum: 0,
+				description: "Training Stress Score (TSS) - quantifies training load"
+			},
+			intensity_factor: {
+				type: "number",
+				minimum: 0,
+				description: "Intensity Factor (IF) - ratio of NP to FTP"
+			},
+			variability_index: {
+				type: "number",
+				minimum: 0,
+				description: "Variability Index (VI) - ratio of NP to average power"
+			},
+			ftp_watts: {
+				type: "integer",
+				minimum: 0,
+				description: "Functional Threshold Power used for calculations (watts)"
+			},
+			total_work_kj: {
+				type: "number",
+				minimum: 0,
+				description: "Total work in kilojoules"
+			},
+			left_right_balance: {
+				type: "number",
+				minimum: 0,
+				maximum: 100,
+				description: "Left/right power balance (percentage left)"
+			},
+			left_pedal_smoothness: {
+				type: "number",
+				minimum: 0,
+				maximum: 100,
+				description: "Average left pedal smoothness (percentage)"
+			},
+			right_pedal_smoothness: {
+				type: "number",
+				minimum: 0,
+				maximum: 100,
+				description: "Average right pedal smoothness (percentage)"
+			},
+			left_torque_effectiveness: {
+				type: "number",
+				minimum: 0,
+				maximum: 100,
+				description: "Average left torque effectiveness (percentage)"
+			},
+			right_torque_effectiveness: {
+				type: "number",
+				minimum: 0,
+				maximum: 100,
+				description: "Average right torque effectiveness (percentage)"
+			}
+		}
+	},
+	TimeInZones: {
+		type: "object",
+		additionalProperties: false,
+		description: "Time spent in heart rate and power zones (PWF v2.1)",
+		properties: {
+			hr_zones_sec: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Time in each HR zone (seconds per zone)"
+			},
+			power_zones_sec: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Time in each power zone (seconds per zone)"
+			},
+			hr_zone_boundaries: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "HR zone boundaries in bpm"
+			},
+			power_zone_boundaries: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Power zone boundaries in watts"
+			},
+			pace_zones_sec: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Time in each pace zone (seconds per zone)"
+			},
+			pace_zone_boundaries: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Pace zone boundaries (seconds per km)"
+			}
+		}
+	},
+	SportSegment: {
+		type: "object",
+		required: [
+			"segment_id",
+			"sport",
+			"segment_index"
+		],
+		additionalProperties: false,
+		description: "A segment within a multi-sport workout (PWF v2.1)",
+		properties: {
+			segment_id: {
+				type: "string",
+				description: "Segment identifier"
+			},
+			sport: {
+				$ref: "#/$defs/Sport",
+				description: "Sport for this segment"
+			},
+			segment_index: {
+				type: "integer",
+				minimum: 0,
+				description: "Segment number in sequence (0-indexed)"
+			},
+			started_at: {
+				type: "string",
+				format: "date-time",
+				description: "When segment started (ISO 8601)"
+			},
+			duration_sec: {
+				type: "integer",
+				minimum: 0,
+				description: "Segment duration in seconds"
+			},
+			distance_m: {
+				type: "number",
+				minimum: 0,
+				description: "Distance covered in this segment (meters)"
+			},
+			exercise_ids: {
+				type: "array",
+				items: {
+					type: "string"
+				},
+				description: "Exercises/sets completed during this segment"
+			},
+			telemetry: {
+				$ref: "#/$defs/WorkoutTelemetry",
+				description: "Telemetry specific to this segment"
+			},
+			transition: {
+				$ref: "#/$defs/TransitionData",
+				description: "Transition data after this segment"
+			},
+			notes: {
+				type: "string",
+				description: "Notes specific to this segment"
+			}
+		}
+	},
+	TransitionData: {
+		type: "object",
+		required: [
+			"transition_id",
+			"from_sport",
+			"to_sport"
+		],
+		additionalProperties: false,
+		description: "Transition between sports in a multi-sport event (PWF v2.1)",
+		properties: {
+			transition_id: {
+				type: "string",
+				description: "Transition identifier (e.g., T1, T2)"
+			},
+			from_sport: {
+				$ref: "#/$defs/Sport",
+				description: "From which sport"
+			},
+			to_sport: {
+				$ref: "#/$defs/Sport",
+				description: "To which sport"
+			},
+			duration_sec: {
+				type: "integer",
+				minimum: 0,
+				description: "Transition duration in seconds"
+			},
+			started_at: {
+				type: "string",
+				format: "date-time",
+				description: "When transition started (ISO 8601)"
+			},
+			heart_rate_avg: {
+				type: "integer",
+				minimum: 0,
+				description: "Average heart rate during transition"
+			},
+			notes: {
+				type: "string",
+				description: "Notes about transition (e.g., equipment changes)"
+			}
+		}
+	},
+	GpsRoute: {
+		type: "object",
+		required: [
+			"route_id",
+			"positions"
+		],
+		additionalProperties: false,
+		description: "A GPS route/track containing multiple positions (PWF v2.1)",
+		properties: {
+			route_id: {
+				type: "string",
+				description: "Unique identifier for this route"
+			},
+			name: {
+				type: "string",
+				description: "Human-readable route name"
+			},
+			positions: {
+				type: "array",
+				items: {
+					$ref: "#/$defs/GpsPosition"
+				},
+				description: "GPS positions in chronological order"
+			},
+			total_distance_m: {
+				type: "number",
+				minimum: 0,
+				description: "Total distance calculated from GPS (meters)"
+			},
+			total_ascent_m: {
+				type: "number",
+				minimum: 0,
+				description: "Total elevation gain (meters)"
+			},
+			total_descent_m: {
+				type: "number",
+				minimum: 0,
+				description: "Total elevation loss (meters)"
+			},
+			min_elevation_m: {
+				type: "number",
+				description: "Minimum elevation on route (meters)"
+			},
+			max_elevation_m: {
+				type: "number",
+				description: "Maximum elevation on route (meters)"
+			},
+			bbox_sw_lat: {
+				type: "number",
+				minimum: -90,
+				maximum: 90,
+				description: "Bounding box - southwest corner latitude"
+			},
+			bbox_sw_lng: {
+				type: "number",
+				minimum: -180,
+				maximum: 180,
+				description: "Bounding box - southwest corner longitude"
+			},
+			bbox_ne_lat: {
+				type: "number",
+				minimum: -90,
+				maximum: 90,
+				description: "Bounding box - northeast corner latitude"
+			},
+			bbox_ne_lng: {
+				type: "number",
+				minimum: -180,
+				maximum: 180,
+				description: "Bounding box - northeast corner longitude"
+			},
+			recording_mode: {
+				type: "string",
+				description: "Recording mode (e.g., auto, smart, 1s, gps_only)"
+			},
+			gps_fix: {
+				$ref: "#/$defs/GpsFix",
+				description: "GPS fix quality indicator"
+			}
+		}
+	},
+	GpsPosition: {
+		type: "object",
+		required: [
+			"latitude_deg",
+			"longitude_deg",
+			"timestamp"
+		],
+		additionalProperties: false,
+		description: "A single GPS position/waypoint with timestamp (PWF v2.1)",
+		properties: {
+			latitude_deg: {
+				type: "number",
+				minimum: -90,
+				maximum: 90,
+				description: "Latitude in decimal degrees (WGS84)"
+			},
+			longitude_deg: {
+				type: "number",
+				minimum: -180,
+				maximum: 180,
+				description: "Longitude in decimal degrees (WGS84)"
+			},
+			timestamp: {
+				type: "string",
+				format: "date-time",
+				description: "Timestamp when position was recorded (ISO 8601)"
+			},
+			elevation_m: {
+				type: "number",
+				description: "Elevation/altitude above sea level (meters)"
+			},
+			accuracy_m: {
+				type: "number",
+				minimum: 0,
+				description: "Horizontal accuracy/uncertainty (meters)"
+			},
+			speed_mps: {
+				type: "number",
+				minimum: 0,
+				description: "Speed at this point (meters per second)"
+			},
+			heading_deg: {
+				type: "number",
+				minimum: 0,
+				maximum: 360,
+				description: "Heading/bearing (degrees from north, 0-360)"
+			},
+			heart_rate_bpm: {
+				type: "integer",
+				minimum: 0,
+				description: "Heart rate at this position (bpm)"
+			},
+			power_watts: {
+				type: "integer",
+				minimum: 0,
+				description: "Power at this position (watts)"
+			},
+			cadence: {
+				type: "integer",
+				minimum: 0,
+				description: "Cadence at this position (RPM or SPM)"
+			},
+			temperature_c: {
+				type: "number",
+				description: "Temperature at this position (Celsius)"
+			}
+		}
+	},
+	GpsFix: {
+		type: "string",
+		"enum": [
+			"none",
+			"fix_2d",
+			"fix_3d",
+			"dgps",
+			"unknown"
+		],
+		description: "GPS fix quality indicator"
+	},
+	TimeSeriesData: {
+		type: "object",
+		required: [
+			"timestamps"
+		],
+		additionalProperties: false,
+		description: "Columnar time-series data for second-by-second telemetry (PWF v2.1)",
+		properties: {
+			timestamps: {
+				type: "array",
+				items: {
+					type: "string",
+					format: "date-time"
+				},
+				description: "Timestamps for each record (ISO 8601). All other arrays must match this length."
+			},
+			elapsed_sec: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Elapsed time in seconds since start"
+			},
+			heart_rate: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Heart rate readings (bpm)"
+			},
+			power: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Power readings (watts)"
+			},
+			cadence: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Cadence readings (RPM for cycling, SPM for running/swimming)"
+			},
+			speed_mps: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: 0
+				},
+				description: "Speed readings (meters per second)"
+			},
+			distance_m: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: 0
+				},
+				description: "Distance readings (cumulative meters)"
+			},
+			elevation_m: {
+				type: "array",
+				items: {
+					type: "number"
+				},
+				description: "Elevation/altitude readings (meters)"
+			},
+			temperature_c: {
+				type: "array",
+				items: {
+					type: "number"
+				},
+				description: "Temperature readings (Celsius)"
+			},
+			latitude: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: -90,
+					maximum: 90
+				},
+				description: "Latitude readings (decimal degrees)"
+			},
+			longitude: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: -180,
+					maximum: 180
+				},
+				description: "Longitude readings (decimal degrees)"
+			},
+			grade_percent: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: -100,
+					maximum: 100
+				},
+				description: "Grade/slope readings (percentage)"
+			},
+			respiration_rate: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Respiration rate (breaths per minute)"
+			},
+			core_temperature_c: {
+				type: "array",
+				items: {
+					type: "number"
+				},
+				description: "Core body temperature (Celsius)"
+			},
+			muscle_oxygen_percent: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: 0,
+					maximum: 100
+				},
+				description: "Muscle oxygen saturation (percentage)"
+			},
+			power_balance: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: 0,
+					maximum: 100
+				},
+				description: "Left/right power balance (percentage left)"
+			},
+			left_pedal_smoothness: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: 0,
+					maximum: 100
+				},
+				description: "Left pedal smoothness (percentage)"
+			},
+			right_pedal_smoothness: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: 0,
+					maximum: 100
+				},
+				description: "Right pedal smoothness (percentage)"
+			},
+			left_torque_effectiveness: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: 0,
+					maximum: 100
+				},
+				description: "Left torque effectiveness (percentage)"
+			},
+			right_torque_effectiveness: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: 0,
+					maximum: 100
+				},
+				description: "Right torque effectiveness (percentage)"
+			},
+			stride_length_m: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: 0
+				},
+				description: "Running stride length (meters)"
+			},
+			vertical_oscillation_cm: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: 0
+				},
+				description: "Running vertical oscillation (centimeters)"
+			},
+			ground_contact_time_ms: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Running ground contact time (milliseconds)"
+			},
+			ground_contact_balance: {
+				type: "array",
+				items: {
+					type: "number",
+					minimum: 0,
+					maximum: 100
+				},
+				description: "Running ground contact balance (percentage left)"
+			},
+			stroke_rate: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Swimming stroke rate (strokes per minute)"
+			},
+			stroke_count: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Swimming stroke count (cumulative)"
+			},
+			swolf: {
+				type: "array",
+				items: {
+					type: "integer",
+					minimum: 0
+				},
+				description: "Swimming SWOLF score"
+			},
+			stroke_type: {
+				type: "array",
+				items: {
+					$ref: "#/$defs/StrokeType"
+				},
+				description: "Swimming stroke type at each point"
+			}
+		}
+	},
+	PoolConfig: {
+		type: "object",
+		required: [
+			"pool_length"
+		],
+		additionalProperties: false,
+		description: "Pool configuration for swimming workouts (PWF v2.1)",
+		properties: {
+			pool_length: {
+				type: "number",
+				minimum: 0,
+				description: "Length of the pool in the specified units"
+			},
+			pool_length_unit: {
+				$ref: "#/$defs/PoolLengthUnit",
+				description: "Unit for pool length (meters or yards)"
+			}
+		}
+	},
+	PoolLengthUnit: {
+		type: "string",
+		"enum": [
+			"meters",
+			"yards"
+		],
+		"default": "meters",
+		description: "Unit for pool length measurement"
+	},
+	SwimmingSetData: {
+		type: "object",
+		additionalProperties: false,
+		description: "Swimming-specific data for a completed set (PWF v2.1)",
+		properties: {
+			lengths: {
+				type: "array",
+				items: {
+					$ref: "#/$defs/SwimmingLength"
+				},
+				description: "Individual lengths within this set/lap"
+			},
+			stroke_type: {
+				$ref: "#/$defs/StrokeType",
+				description: "Primary stroke type for the set (if all lengths same stroke)"
+			},
+			total_lengths: {
+				type: "integer",
+				minimum: 0,
+				description: "Total number of lengths in this set"
+			},
+			active_lengths: {
+				type: "integer",
+				minimum: 0,
+				description: "Number of active lengths (excludes rest at wall)"
+			},
+			swolf_avg: {
+				type: "integer",
+				minimum: 0,
+				description: "Average SWOLF across all lengths in this set"
+			},
+			drill_mode: {
+				type: "boolean",
+				description: "Whether this set was drill work (technique focus)"
+			}
+		}
+	},
+	SwimmingLength: {
+		type: "object",
+		required: [
+			"length_number",
+			"stroke_type",
+			"duration_sec"
+		],
+		additionalProperties: false,
+		description: "A single length (one pool length) within a swimming set/lap (PWF v2.1)",
+		properties: {
+			length_number: {
+				type: "integer",
+				minimum: 1,
+				description: "Length number within the set (1-indexed)"
+			},
+			stroke_type: {
+				$ref: "#/$defs/StrokeType",
+				description: "Stroke type used for this length"
+			},
+			duration_sec: {
+				type: "integer",
+				minimum: 0,
+				description: "Duration of this length in seconds"
+			},
+			stroke_count: {
+				type: "integer",
+				minimum: 0,
+				description: "Number of strokes taken during this length"
+			},
+			swolf: {
+				type: "integer",
+				minimum: 0,
+				description: "SWOLF score (duration + stroke_count) - lower is better"
+			},
+			started_at: {
+				type: "string",
+				format: "date-time",
+				description: "Timestamp when this length started (ISO 8601)"
+			},
+			active: {
+				type: "boolean",
+				description: "Whether this was an active length (vs. rest at wall)"
+			}
+		}
+	},
+	StrokeType: {
+		type: "string",
+		"enum": [
+			"freestyle",
+			"backstroke",
+			"breaststroke",
+			"butterfly",
+			"drill",
+			"mixed",
+			"im"
+		],
+		description: "Swimming stroke type for pool and open water swimming"
+	},
+	DeviceInfo: {
+		type: "object",
+		required: [
+			"device_type",
+			"manufacturer"
+		],
+		additionalProperties: false,
+		description: "Information about a device used during the workout (PWF v2)",
+		properties: {
+			device_index: {
+				type: "integer",
+				minimum: 0,
+				maximum: 255,
+				description: "Device index for multi-device workouts (e.g., 0=watch, 1=HRM, 2=power meter)"
+			},
+			device_type: {
+				$ref: "#/$defs/DeviceType",
+				description: "Type of device"
+			},
+			manufacturer: {
+				type: "string",
+				description: "Device manufacturer (can be a known manufacturer or custom string)"
+			},
+			product: {
+				type: "string",
+				description: "Specific product/model name"
+			},
+			serial_number: {
+				type: "string",
+				description: "Unique device serial number"
+			},
+			software_version: {
+				type: "string",
+				description: "Software/firmware version"
+			},
+			hardware_version: {
+				type: "string",
+				description: "Hardware version"
+			},
+			battery: {
+				$ref: "#/$defs/BatteryInfo",
+				description: "Battery information"
+			},
+			cumulative_operating_time_hours: {
+				type: "number",
+				minimum: 0,
+				description: "Cumulative operating time in hours"
+			},
+			connection: {
+				$ref: "#/$defs/ConnectionInfo",
+				description: "Connection information for sensors"
+			},
+			calibration: {
+				$ref: "#/$defs/CalibrationInfo",
+				description: "Calibration information for sensors"
+			}
+		}
+	},
+	DeviceType: {
+		type: "string",
+		"enum": [
+			"watch",
+			"bike_computer",
+			"heart_rate_monitor",
+			"power_meter",
+			"speed_sensor",
+			"cadence_sensor",
+			"speed_cadence_sensor",
+			"foot_pod",
+			"smart_trainer",
+			"camera",
+			"phone",
+			"other"
+		],
+		description: "Type of device"
+	},
+	BatteryInfo: {
+		type: "object",
+		additionalProperties: false,
+		description: "Battery information for a device",
+		properties: {
+			start_percent: {
+				type: "integer",
+				minimum: 0,
+				maximum: 100,
+				description: "Battery level at start of workout (percentage)"
+			},
+			end_percent: {
+				type: "integer",
+				minimum: 0,
+				maximum: 100,
+				description: "Battery level at end of workout (percentage)"
+			},
+			voltage: {
+				type: "number",
+				minimum: 0,
+				description: "Battery voltage"
+			},
+			status: {
+				$ref: "#/$defs/BatteryStatus",
+				description: "Battery status indicator"
+			}
+		}
+	},
+	BatteryStatus: {
+		type: "string",
+		"enum": [
+			"good",
+			"low",
+			"critical",
+			"charging",
+			"unknown"
+		],
+		description: "Battery status indicator"
+	},
+	ConnectionInfo: {
+		type: "object",
+		required: [
+			"connection_type"
+		],
+		additionalProperties: false,
+		description: "Connection information for wireless sensors",
+		properties: {
+			connection_type: {
+				$ref: "#/$defs/ConnectionType",
+				description: "Type of connection"
+			},
+			ant_device_number: {
+				type: "integer",
+				minimum: 0,
+				description: "ANT+ device number (for ANT+ sensors)"
+			},
+			bluetooth_id: {
+				type: "string",
+				description: "Bluetooth MAC address or identifier"
+			}
+		}
+	},
+	ConnectionType: {
+		type: "string",
+		"enum": [
+			"local",
+			"ant_plus",
+			"bluetooth_le",
+			"bluetooth",
+			"wifi",
+			"usb",
+			"unknown"
+		],
+		description: "Type of device connection"
+	},
+	CalibrationInfo: {
+		type: "object",
+		additionalProperties: false,
+		description: "Calibration information for sensors (e.g., power meters)",
+		properties: {
+			calibration_factor: {
+				type: "number",
+				description: "Calibration factor or zero offset"
+			},
+			last_calibrated: {
+				type: "string",
+				format: "date-time",
+				description: "Timestamp of last calibration"
+			},
+			auto_zero_enabled: {
+				type: "boolean",
+				description: "Auto-zero setting (for power meters)"
+			}
+		}
+	}
+};
+var pwfHistoryV1 = {
+	$schema: $schema,
+	$id: $id,
+	title: title,
+	description: description,
+	type: type,
+	required: required,
+	additionalProperties: additionalProperties,
+	properties: properties,
+	$defs: $defs
+};
+
+export { type AdvancedMetrics, type AthleteProfile, type BatteryInfo, type BodyDimensions, type BodyMeasurement, type CalibrationInfo, type CompletedExercise, type CompletedSet, type ConnectionInfo, type Cycle, type Day, type DeviceInfo, type Exercise, type ExportSource, type GpsPosition, type GpsRoute, type HistoryExercise, type HistoryWorkout, type IntervalPhase, type LactateThreshold, type Meta, type Modality, type PWFHistoryExportV1, type PWFPlanV1, type ParseOptions, type PersonalRecord, PlanBuilder, type PlanCycle, type PlanDay, type PlanDocument, type PlanExercise, type PlanMeta, type PoolConfig, type PowerMetrics, type PwfHistory, type PwfPlan, type RampConfig, type SetTelemetry, type Severity, type SportSegment, type StrokeType, type SwimmingLength, type SwimmingSetData, type TimeInZones, type TimeSeriesData, type TrainingZone, type TransitionData, type Units, type Units1, type ValidationError, type ValidationIssue, type ValidationOptions, type ValidationWarning, type Workout, type WorkoutTelemetry, type WorkoutTelemetry1, fromYAML, pwfHistoryV1 as historySchema, isValidationIssueList, parseHistory, parsePlan, pwfV1 as planSchema, toYAML, validateHistory, validatePlan };