@rydr/game-sdk 8.21.0 → 8.22.0

package/dist/training/model.js

@@ -0,0 +1,261 @@
+/**
+ * The workout data model.
+ *
+ * A workout is an ordered list of **segments**, and every power in it is a
+ * percentage of FTP — never watts. That is the whole reason a workout written by
+ * one rider is rideable by another: 88% FTP is sweet spot for a 180 W rider and
+ * for a 340 W rider, where "160 W" is a different session for each of them.
+ * Watts appear exactly once, at the last moment, in `compile.ts`.
+ *
+ * Three segment kinds cover the structured-training vocabulary:
+ * a steady block, a repeating interval set, and a linear ramp. Ported from the
+ * legacy RYDR app (`src/types/workout.ts`), which had earned this shape.
+ */
+export const CATEGORY_LABELS = {
+    recovery: "Recovery",
+    endurance: "Endurance",
+    tempo: "Tempo",
+    sweetSpot: "Sweet Spot",
+    threshold: "Threshold",
+    aerobicPower: "Aerobic Power",
+    shortBursts: "Short Bursts",
+    sprint: "Sprint",
+};
+/**
+ * Which power zone each category *reads* as, for tinting a pill or a badge.
+ *
+ * Purely presentational — a category is descriptive (see above) and never drives
+ * execution, so this is only ever asked for a colour. It exists so a category
+ * pill and the chart underneath it agree about what "Threshold" looks like; the
+ * colour itself still comes from `zoneByNumber` in `./zones`, which stays the
+ * one place a zone colour is written down.
+ *
+ * Two of the eight straddle a boundary and are pinned to the lower zone, which
+ * is the legacy app's choice and worth keeping: sweet spot lives between Z3 and
+ * Z4, short bursts between Z5 and Z6, and picking the higher zone in each case
+ * made them read as harder than the sessions actually are.
+ */
+export const CATEGORY_ZONE = {
+    recovery: 1,
+    endurance: 2,
+    tempo: 3,
+    sweetSpot: 3,
+    threshold: 4,
+    aerobicPower: 5,
+    shortBursts: 5,
+    sprint: 7,
+};
+/** Display order for pickers and filters — easiest to hardest. */
+export const CATEGORY_ORDER = [
+    "recovery",
+    "endurance",
+    "tempo",
+    "sweetSpot",
+    "threshold",
+    "aerobicPower",
+    "shortBursts",
+    "sprint",
+];
+// ============================================================================
+// Factories
+// ============================================================================
+function uid(prefix) {
+    return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+export function generateSegmentId() {
+    return uid("seg");
+}
+export function generatePlacedTrackId() {
+    return uid("cue");
+}
+export function generateWorkoutId() {
+    return uid("wk");
+}
+export function createFixedZoneSegment(overrides) {
+    return {
+        id: generateSegmentId(),
+        type: "fixed",
+        duration: 300,
+        power: 75,
+        ...overrides,
+    };
+}
+export function createIntervalSetSegment(overrides) {
+    return {
+        id: generateSegmentId(),
+        type: "intervals",
+        sets: 3,
+        reps: 10,
+        workDuration: 30,
+        workPower: 120,
+        recoveryDuration: 15,
+        recoveryPower: 50,
+        restBetweenSets: 120,
+        restPower: 50,
+        ...overrides,
+    };
+}
+export function createRampSegment(overrides) {
+    return {
+        id: generateSegmentId(),
+        type: "ramp",
+        duration: 300,
+        startPower: 50,
+        endPower: 100,
+        ...overrides,
+    };
+}
+export function createWorkout(overrides) {
+    const now = Date.now();
+    return {
+        id: generateWorkoutId(),
+        name: "",
+        description: "",
+        category: "threshold",
+        segments: [],
+        createdAt: now,
+        updatedAt: now,
+        ...overrides,
+    };
+}
+/** A deep copy under a fresh id — for "duplicate", and for editing a preset. */
+export function cloneWorkout(workout, name) {
+    const now = Date.now();
+    return {
+        ...structuredClone(workout),
+        id: generateWorkoutId(),
+        name: name ?? `${workout.name} (copy)`,
+        segments: workout.segments.map((seg) => ({ ...seg, id: generateSegmentId() })),
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+// ============================================================================
+// Durations
+// ============================================================================
+/** Seconds a segment occupies on the timeline. */
+export function segmentDuration(segment) {
+    if (segment.type === "fixed" || segment.type === "ramp")
+        return segment.duration;
+    // An interval set is (work + recovery) per rep, times reps, times sets, plus
+    // the rests BETWEEN sets — there is no rest after the final one.
+    const perRep = segment.workDuration + segment.recoveryDuration;
+    const perSet = perRep * segment.reps;
+    const rests = segment.restBetweenSets * Math.max(0, segment.sets - 1);
+    return perSet * segment.sets + rests;
+}
+/** Total seconds of a whole workout. */
+export function workoutDuration(workout) {
+    return workout.segments.reduce((total, seg) => total + segmentDuration(seg), 0);
+}
+/** How many work efforts the rider will actually do. */
+export function workoutIntervalCount(workout) {
+    return workout.segments.reduce((total, seg) => (seg.type === "intervals" ? total + seg.sets * seg.reps : total), 0);
+}
+// ============================================================================
+// Flattening
+// ============================================================================
+/**
+ * Explode an interval set into the individual blocks it stands for.
+ *
+ * The timeline editor places blocks one at a time, so a workout imported from
+ * ZWO — or authored in the card editor — has to be flattened before it can be
+ * dragged around. `3x13x30/15` becomes 78 blocks plus 2 rests.
+ *
+ * **This is deliberately lossy in exactly one way and lossless in every other.**
+ * Gone is the shorthand: nothing afterwards knows those 78 blocks were once
+ * three sets, so `describeSegment` stops saying `"3x13x30/15"` and ZWO export
+ * writes a run of `<SteadyState>` rather than an `<IntervalsT>`. Kept is
+ * everything the *ride* reads — each block carries its {@link PhaseType}, so the
+ * compiled timeline has the same phases, the same efforts count, the same
+ * `set`/`rep` numbering and the same fast start it had before. `compileWorkout`
+ * of a flattened workout equals `compileWorkout` of the original, which is
+ * asserted in `test/flatten.test.ts` and is the whole licence for doing this.
+ *
+ * Mirrors `compileWorkout`'s expansion step for step, including its two edge
+ * rules: a rep with no recovery emits no recovery block, and the rest goes
+ * BETWEEN sets and never after the last one.
+ */
+export function flattenSegment(segment) {
+    if (segment.type !== "intervals")
+        return [segment];
+    const out = [];
+    for (let set = 1; set <= segment.sets; set++) {
+        for (let rep = 1; rep <= segment.reps; rep++) {
+            out.push(createFixedZoneSegment({
+                duration: segment.workDuration,
+                power: segment.workPower,
+                phase: "work",
+            }));
+            // A rep can have no recovery (a set of one long effort), and a zero-length
+            // block would be an un-addressable hole in the timeline.
+            if (segment.recoveryDuration > 0) {
+                out.push(createFixedZoneSegment({
+                    duration: segment.recoveryDuration,
+                    power: segment.recoveryPower,
+                    phase: "recovery",
+                }));
+            }
+        }
+        if (set < segment.sets && segment.restBetweenSets > 0) {
+            out.push(createFixedZoneSegment({
+                duration: segment.restBetweenSets,
+                power: segment.restPower,
+                phase: "rest",
+            }));
+        }
+    }
+    return out;
+}
+/** Every segment flattened, in order. What the timeline editor opens a workout as. */
+export function flattenSegments(segments) {
+    return segments.flatMap(flattenSegment);
+}
+/** Whether anything here would change shape under {@link flattenSegments}. */
+export function hasCompositeSegments(workout) {
+    return workout.segments.some((seg) => seg.type === "intervals");
+}
+/** Whether somebody scored this session by hand — see {@link WorkoutMusic}. */
+export function hasAuthoredMusic(workout) {
+    return (workout.music?.tracks.length ?? 0) > 0;
+}
+// ============================================================================
+// Formatting
+// ============================================================================
+/** `90` → `"1:30"`, `3725` → `"1:02:05"`. For clocks and countdowns. */
+export function formatClock(totalSeconds) {
+    const s = Math.max(0, Math.round(totalSeconds));
+    const hours = Math.floor(s / 3600);
+    const minutes = Math.floor((s % 3600) / 60);
+    const seconds = s % 60;
+    const mm = hours > 0 ? String(minutes).padStart(2, "0") : String(minutes);
+    return hours > 0
+        ? `${hours}:${mm}:${String(seconds).padStart(2, "0")}`
+        : `${mm}:${String(seconds).padStart(2, "0")}`;
+}
+/** `2700` → `"45min"`, `90` → `"1min 30s"`, `45` → `"45s"`. For labels, not clocks. */
+export function formatDuration(totalSeconds) {
+    const s = Math.max(0, Math.round(totalSeconds));
+    const minutes = Math.floor(s / 60);
+    const seconds = s % 60;
+    if (minutes === 0)
+        return `${seconds}s`;
+    if (seconds === 0)
+        return `${minutes}min`;
+    return `${minutes}min ${seconds}s`;
+}
+/** The one-line shorthand a cyclist would actually say out loud. */
+export function describeSegment(segment) {
+    if (segment.type === "fixed") {
+        return `${formatDuration(segment.duration)} @ ${segment.power}% FTP`;
+    }
+    if (segment.type === "ramp") {
+        return `${formatDuration(segment.duration)} ${segment.startPower}→${segment.endPower}% FTP`;
+    }
+    const { sets, reps, workDuration, recoveryDuration, restBetweenSets, workPower } = segment;
+    // "3x13x30/15" — sets × reps × work/recovery, the standard notation.
+    const core = sets > 1 ? `${sets}x${reps}x` : `${reps}x`;
+    const rest = restBetweenSets > 0 && sets > 1 ? ` + ${Math.round(restBetweenSets / 60)}' rest` : "";
+    return `${core}${workDuration}/${recoveryDuration} @ ${workPower}% FTP${rest}`;
+}
+//# sourceMappingURL=model.js.map

package/dist/training/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/training/model.ts"],"names":[],"mappings":"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"}

package/dist/training/protocol.d.ts

@@ -0,0 +1,60 @@
+/** Training is platform-owned; games consume snapshots and actual hardware watts. */
+import type { EngineState } from "./state.js";
+import type { Workout } from "./model.js";
+import type { FlatSegment } from "./compile.js";
+/** Trainer preference, independent of game rules and power normalization. */
+export type EffortMode = "steady" | "dynamic";
+/** Complete immutable plan, sent on attachment or revision, never every tick. */
+export interface WorkoutPlan {
+    id: string;
+    revision: number;
+    workout: Workout;
+    timeline: readonly FlatSegment[];
+}
+/** Live authoritative position. Seconds use the platform's single workout clock. */
+export type WorkoutProgress = Omit<EngineState, "workout" | "timeline">;
+/** Atomic state: a null workout means no structured training is attached. */
+export interface TrainingSnapshot {
+    effort: EffortMode;
+    baseTargetWatts: number;
+    ergActive: boolean;
+    workout: {
+        plan: WorkoutPlan;
+        progress: WorkoutProgress;
+    } | null;
+}
+/** Transport omits unchanged plans; revision guards reject stale progress. */
+export interface TrainingUpdate {
+    effort: EffortMode;
+    baseTargetWatts: number;
+    ergActive: boolean;
+    workout: {
+        id: string;
+        revision: number;
+        plan?: WorkoutPlan;
+        progress: WorkoutProgress;
+    } | null;
+}
+/** Read-only workout state plus a game's chosen effort preference. */
+export interface TrainingSession {
+    readonly supported: boolean;
+    readonly current: TrainingSnapshot | null;
+    subscribe(listener: (state: TrainingSnapshot) => void): () => void;
+    setEffort(mode: EffortMode): void;
+}
+export interface TrainingSource {
+    current(): TrainingSnapshot;
+    subscribe(listener: (state: TrainingSnapshot) => void): () => void;
+    setEffort(mode: EffortMode): void;
+}
+export interface TrainingStateMessage {
+    rydr: true;
+    type: "rydr/training.state";
+    state: TrainingUpdate;
+}
+export interface TrainingEffortMessage {
+    rydr: true;
+    type: "rydr/training.effort";
+    mode: EffortMode;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/training/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/training/protocol.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC9C,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;CAClC;AACD,oFAAoF;AACpF,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;AACxE,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI,CAAC;CAClE;AACD,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI,CAAC;CACjG;AACD,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnE,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CACnC;AACD,MAAM,WAAW,cAAc;IAC7B,OAAO,IAAI,gBAAgB,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnE,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CACnC;AACD,MAAM,WAAW,oBAAoB;IAAG,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,qBAAqB,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE;AACxG,MAAM,WAAW,qBAAqB;IAAG,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,sBAAsB,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE"}

package/dist/training/protocol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/training/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/training/protocol.ts"],"names":[],"mappings":""}

package/dist/training/state.d.ts

@@ -0,0 +1,201 @@
+/**
+ * The engine's vocabulary: its phases, the numbers it measures, and the events
+ * it emits. Deliberately free of anything to do with rendering — see `engine.ts`
+ * on why the engine has no idea what's drawing it.
+ */
+import type { FlatSegment } from "./compile.js";
+import type { Workout } from "./model.js";
+/**
+ * Where the ride is in its lifecycle.
+ *
+ * - `ready` — compiled and waiting for the rider's first pedal stroke.
+ * - `active` — running.
+ * - `paused` — stopped, by choice or because the rider stopped pedalling.
+ * - `cooldown` — the timeline is finished, the rider keeps spinning easy. Not
+ *   the end: they decide when to end the ride, so a cool-down is never cut off
+ *   by a clock.
+ * - `complete` — finished and scored. Terminal.
+ */
+export type EnginePhase = "ready" | "active" | "paused" | "cooldown" | "complete";
+/** Why the ride is paused. `stopped` is the engine's own doing, not the rider's. */
+export type PauseReason = "rider" | "stopped";
+/** What the rider actually did in one effort, against what was asked. */
+export interface EffortResult {
+    /** Index into the compiled timeline. */
+    index: number;
+    set: number;
+    rep: number;
+    /** What was asked, watts. */
+    targetPower: number;
+    /** What was produced, watts. */
+    averagePower: number;
+    peakPower: number;
+    /** Seconds actually ridden — less than planned if skipped, more if extended. */
+    duration: number;
+    /** Share of the effort spent inside the target band, 0–100. */
+    timeInZonePercent: number;
+    /** How it went. See `classifyEffort`. */
+    quality: EffortQuality;
+    /** bpm at the start of the effort, 0 without a monitor. */
+    startHeartRate: number;
+    /** bpm at the end, 0 without a monitor. */
+    endHeartRate: number;
+    /** True when the rider jumped past this effort rather than riding it. */
+    skipped: boolean;
+}
+/**
+ * How an effort went, relative to the target band.
+ *
+ * Four levels rather than pass/fail because "just under" and "nowhere near" are
+ * different sessions, and a rider deciding whether to add a set needs to know
+ * which one they're having.
+ */
+export type EffortQuality = "excellent" | "onTarget" | "close" | "missed";
+/** Power and heart rate over one timeline entry, for the results breakdown. */
+export interface SegmentStats {
+    index: number;
+    averagePower: number;
+    peakPower: number;
+    averageHeartRate: number;
+    peakHeartRate: number;
+    sampleCount: number;
+}
+/** A stretch of timeline the rider jumped over, so the chart can show the gap. */
+export interface SkipZone {
+    from: number;
+    to: number;
+}
+/** An FTP change made mid-ride, and where on the timeline it happened. */
+export interface FtpChange {
+    ftp: number;
+    atPosition: number;
+}
+/**
+ * Everything a renderer needs, as one immutable snapshot per frame.
+ *
+ * A single object rather than a set of getters so a renderer can't read half of
+ * one frame and half of the next, and so a future 3D view gets exactly the same
+ * information as the chart with no new engine API.
+ */
+export interface EngineState {
+    phase: EnginePhase;
+    pauseReason: PauseReason | null;
+    /** Position on the workout timeline, seconds. This drives the chart cursor. */
+    position: number;
+    /** Wall-clock seconds since the ride began — excludes skipped time. */
+    elapsed: number;
+    /** Total seconds of the compiled timeline. */
+    totalDuration: number;
+    /** Seconds left in the current entry. */
+    segmentRemaining: number;
+    /** Seconds left in the whole workout. */
+    totalRemaining: number;
+    /** What the rider should be doing right now, watts. Correct in every phase. */
+    targetPower: number;
+    /** Whether the boost portion of a fast-start effort is live. */
+    inFastStart: boolean;
+    segment: FlatSegment | null;
+    /** The next entry, so a renderer can warn what's coming. */
+    nextSegment: FlatSegment | null;
+    timeline: readonly FlatSegment[];
+    /** 1-based, 0 outside an interval set. */
+    set: number;
+    /** 1-based, 0 outside an interval set. */
+    rep: number;
+    /** Total efforts in the workout, for "rep 12 of 39". */
+    totalReps: number;
+    /** Mean power so far in the current entry, watts. */
+    segmentAveragePower: number;
+    /** Share of the current entry spent in the target band, 0–100. */
+    segmentTimeInZone: number;
+    results: readonly EffortResult[];
+    segmentStats: readonly SegmentStats[];
+    skipZones: readonly SkipZone[];
+    /** Whether the game currently holds the trainer in ERG. */
+    ergActive: boolean;
+    /** Whether the trainer could do ERG at all. */
+    ergAvailable: boolean;
+    /** The FTP the timeline is compiled against — the rider can change it mid-ride. */
+    ftp: number;
+    ftpHistory: readonly FtpChange[];
+    /** Seconds spent in cool-down, once the timeline has finished. */
+    cooldownElapsed: number;
+    workout: Workout;
+}
+/** The finished ride, as the results screen and the run record see it. */
+export interface RideSummary {
+    workout: Workout;
+    ftp: number;
+    /** Seconds actually ridden. */
+    elapsed: number;
+    results: readonly EffortResult[];
+    segmentStats: readonly SegmentStats[];
+    /** Mean power across the ride, watts. */
+    averagePower: number;
+    /** Normalized power of what was ridden, watts. */
+    normalizedPower: number;
+    intensityFactor: number;
+    tss: number;
+    kilojoules: number;
+    averageHeartRate: number;
+    peakHeartRate: number;
+    peakPower: number;
+    averageCadence: number;
+    /** Share of the whole ride spent inside the target band, 0–100. */
+    compliancePercent: number;
+    /** How many of the planned efforts were actually ridden. */
+    effortsCompleted: number;
+    effortsPlanned: number;
+}
+/** One effort finished — for a cue, a chart mark, a readout. */
+export interface EffortCompleteEvent {
+    result: EffortResult;
+    /** Last effort of its set. */
+    lastInSet: boolean;
+    /** Last effort of the whole workout. */
+    lastInWorkout: boolean;
+}
+/**
+ * What the engine announces. A renderer subscribes to what it cares about and
+ * reads {@link EngineState} for everything else.
+ */
+export interface EngineEvents {
+    /** Every frame. The bread and butter of any renderer. */
+    tick: EngineState;
+    /** The phase changed — worth a screen change, not just a repaint. */
+    phase: EngineState;
+    /** The timeline moved to a new entry. */
+    segment: EngineState;
+    effort: EffortCompleteEvent;
+    /** The timeline ran out; the rider is spinning down and hasn't ended yet. */
+    finished: EngineState;
+    /** The rider ended the ride. Terminal — the summary is final. */
+    complete: RideSummary;
+}
+export type EngineEventName = keyof EngineEvents;
+/**
+ * How far off target still counts as on target: 5% of the target, but never
+ * tighter than 15 W.
+ *
+ * The floor is what makes this usable. At a 100 W recovery target a pure 5% band
+ * is ±5 W, which no human holds and no trainer reports that precisely, so a rider
+ * spinning perfectly well would be scored as missing. Carried over from the
+ * legacy app, where it was tuned against real rides.
+ */
+export declare function zoneHalfWidth(targetPower: number): number;
+export declare function zoneBounds(targetPower: number): {
+    lower: number;
+    upper: number;
+};
+export declare function isInZone(power: number, targetPower: number): boolean;
+/**
+ * Grade an effort by its average power.
+ *
+ * Over the band is `excellent` rather than an error: this app prescribes a target
+ * but doesn't police it, and a rider who went harder did more work, not the wrong
+ * work. `close` reaches one further band-width below, which is the difference
+ * between fading at the end of a rep and abandoning it.
+ */
+export declare function classifyEffort(averagePower: number, targetPower: number): EffortQuality;
+export declare const QUALITY_LABELS: Record<EffortQuality, string>;
+//# sourceMappingURL=state.d.ts.map

package/dist/training/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/training/state.ts"],"names":[],"mappings":"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"}

package/dist/training/state.js

@@ -0,0 +1,55 @@
+/**
+ * The engine's vocabulary: its phases, the numbers it measures, and the events
+ * it emits. Deliberately free of anything to do with rendering — see `engine.ts`
+ * on why the engine has no idea what's drawing it.
+ */
+// ============================================================================
+// The target band
+// ============================================================================
+/**
+ * How far off target still counts as on target: 5% of the target, but never
+ * tighter than 15 W.
+ *
+ * The floor is what makes this usable. At a 100 W recovery target a pure 5% band
+ * is ±5 W, which no human holds and no trainer reports that precisely, so a rider
+ * spinning perfectly well would be scored as missing. Carried over from the
+ * legacy app, where it was tuned against real rides.
+ */
+export function zoneHalfWidth(targetPower) {
+    return Math.max(targetPower * 0.05, 15);
+}
+export function zoneBounds(targetPower) {
+    const half = zoneHalfWidth(targetPower);
+    return { lower: Math.round(targetPower - half), upper: Math.round(targetPower + half) };
+}
+export function isInZone(power, targetPower) {
+    const { lower, upper } = zoneBounds(targetPower);
+    return power >= lower && power <= upper;
+}
+/**
+ * Grade an effort by its average power.
+ *
+ * Over the band is `excellent` rather than an error: this app prescribes a target
+ * but doesn't police it, and a rider who went harder did more work, not the wrong
+ * work. `close` reaches one further band-width below, which is the difference
+ * between fading at the end of a rep and abandoning it.
+ */
+export function classifyEffort(averagePower, targetPower) {
+    if (targetPower <= 0)
+        return "onTarget";
+    const { lower, upper } = zoneBounds(targetPower);
+    if (averagePower > upper)
+        return "excellent";
+    if (averagePower >= lower)
+        return "onTarget";
+    if (averagePower >= targetPower - zoneHalfWidth(targetPower) * 2)
+        return "close";
+    return "missed";
+}
+export const QUALITY_LABELS = {
+    excellent: "Over target",
+    onTarget: "On target",
+    close: "Just under",
+    missed: "Missed",
+};
+//# sourceMappingURL=state.js.map

package/dist/training/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/training/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmNH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IACxC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,WAAmB;IACzD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACjD,OAAO,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,CAAC;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB,EAAE,WAAmB;IACtE,IAAI,WAAW,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC;IACxC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACjD,IAAI,YAAY,GAAG,KAAK;QAAE,OAAO,WAAW,CAAC;IAC7C,IAAI,YAAY,IAAI,KAAK;QAAE,OAAO,UAAU,CAAC;IAC7C,IAAI,YAAY,IAAI,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IACjF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAkC;IAC3D,SAAS,EAAE,aAAa;IACxB,QAAQ,EAAE,WAAW;IACrB,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,QAAQ;CACjB,CAAC"}

package/dist/training/zones.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Coggan's seven power zones — the single source of truth for zone boundaries
+ * and colours in this app.
+ *
+ * These are a *coaching* convention, not a platform scale, which is why they live
+ * here and not in `@rydr/game-sdk`. (The platform's own ladder — the 1→50 rider
+ * difficulty level — is a different thing entirely and comes from
+ * `@rydr/game-sdk/difficulty`; never mix the two.)
+ *
+ * Nothing outside this file should hardcode a zone colour: a chart, a badge and a
+ * live readout showing the same effort in three different colours is exactly the
+ * bug this module exists to prevent.
+ */
+export interface PowerZone {
+    /** 1–7. */
+    zone: number;
+    /** "Threshold". */
+    name: string;
+    /** "Z4". */
+    shortName: string;
+    /** Lower bound as a fraction of FTP, inclusive. 0 for Z1. */
+    minFtp: number;
+    /** Upper bound as a fraction of FTP, exclusive. Infinity for Z7. */
+    maxFtp: number;
+    /** Solid colour — strokes, text, badges. */
+    color: string;
+    /** Translucent variant — fills and backgrounds. */
+    colorLight: string;
+}
+export declare const POWER_ZONES: readonly PowerZone[];
+/**
+ * The zone for a power expressed as a **percentage of FTP** (120 = 120% FTP).
+ *
+ * Prefer this over {@link zoneForWatts} wherever the authored percentage is still
+ * in hand — a segment's colour then can't drift when the rider's FTP changes, and
+ * two segments authored at the same percentage always draw identically.
+ */
+export declare function zoneForPercent(percent: number): PowerZone;
+/** The zone for a live power reading in watts against an FTP in watts. */
+export declare function zoneForWatts(watts: number, ftp: number): PowerZone;
+/**
+ * The zone with a given number, 1–7.
+ *
+ * For the places that already hold a zone *number* — a time-in-zone tally, a
+ * legend row — and need its colour or name back. Without this they end up
+ * re-listing the colours locally, which is how a chart and its own legend come to
+ * disagree.
+ */
+export declare function zoneByNumber(zone: number): PowerZone;
+//# sourceMappingURL=zones.d.ts.map