@dofek/training 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Asher Cohen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# @dofek/training
+
+Framework-neutral TypeScript calculations for training load, cycling power,
+performance modeling, activity normalization, and workout recommendations.
+
+## Install
+
+```sh
+npm install @dofek/training
+```
+
+Requires Node.js 22.14 or newer.
+
+## Usage
+
+There is no root export; import the module subpath you need.
+
+```ts
+import {
+  computeHrTss,
+  computeTrimp,
+} from "@dofek/training/pmc";
+
+const durationMinutes = 60;
+const averageHeartRate = 150;
+const maximumHeartRate = 190;
+const restingHeartRate = 55;
+
+console.log({
+  trimp: computeTrimp(
+    durationMinutes,
+    averageHeartRate,
+    maximumHeartRate,
+    restingHeartRate,
+  ),
+  hrTss: computeHrTss(
+    durationMinutes,
+    averageHeartRate,
+    maximumHeartRate,
+    restingHeartRate,
+  ),
+});
+```
+
+## Public API
+
+Every public module is imported as `@dofek/training/<subpath>`.
+
+| Subpath | Purpose |
+| --- | --- |
+| `activity-icons` | Normalize activity names into framework-neutral icon categories |
+| `climbing-grades` | Parse V-scale and Yosemite Decimal System climbing grades |
+| `derived-cardio` | Cycling and submaximal walking/running VO2 max estimates and validation |
+| `endurance-types` | Endurance and indoor-cycling type guards |
+| `grade-adjusted-pace` | Grade cost factor and adjusted running pace |
+| `muscle-groups` | Muscle-group expansion, totals, intensities, and display colors |
+| `pmc` | TRIMP, heart-rate/power stress, FTP estimate, learned stress model, and performance-management calculations |
+| `power-analysis` | Power curves, normalized power, critical-power fit, regression, and duration constants |
+| `training` | Canonical activity types, provider normalization, and weekly-volume grouping |
+| `training-distribution` | [Karvonen](https://pubmed.ncbi.nlm.nih.gov/13470504/) and [Treff](https://www.frontiersin.org/journals/physiology/articles/10.3389/fphys.2019.00707/full) weekly intensity-distribution summaries |
+| `training-load` | `TrainingStressCalculator` stateful facade |
+| `workout-recommendation` | Workout recommendation types and calculation |
+
+## Model details
+
+### Workout recommendations
+
+`recommendNextWorkout` combines recent activity, readiness, workload ratio,
+muscle-group freshness, and intensity distribution. Its low/moderate/high
+distribution model is informed by the three-zone observations in
+[Seiler and Kjerland (2006)](https://pubmed.ncbi.nlm.nih.gov/16430681/);
+the exact readiness gates, recovery windows, and recommendation rules are Dofek
+product heuristics.
+
+### Training stress and performance
+
+- `computeTrimp` applies the package's exponential heart-rate-load formula.
+- `computeHrTss` normalizes that load to the package's one-hour threshold
+  reference.
+- Power stress uses duration, FTP, and normalized power.
+- Stress-model helpers fit a personal linear relationship from paired heart-rate
+  and power observations.
+- FTP estimation uses 95% of the best 20-minute average power, matching the
+  [TrainingPeaks threshold procedure](https://help.trainingpeaks.com/hc/en-us/articles/204071934-How-to-Calculate-Threshold-Values-for-Power-Heart-Rate-or-Pace).
+
+### Power and curve analysis
+
+- Power curves use prefix sums to find the best average power across the
+  package's standard durations.
+- Normalized power uses 30-second rolling averages and fourth-power weighting,
+  following the
+  [TrainingPeaks calculation](https://help.trainingpeaks.com/hc/en-us/articles/204071804-Normalized-Power).
+- Critical power fits the two-parameter relationship introduced by
+  [Monod and Scherrer (1965)](https://doi.org/10.1080/00140136508930810)
+  using efforts from 120 through 600 seconds.
+
+### Terrain adjustment
+
+Grade-adjusted pace uses a bounded approximation derived from the slope-cost
+work of
+[Minetti et al. (2002)](https://pubmed.ncbi.nlm.nih.gov/12183501/).
+It is an estimate, not a substitute for measured effort.
+
+### Activity normalization
+
+Canonical activity types map provider-specific labels into one vocabulary.
+Endurance filters and weekly-volume grouping keep downstream analysis
+provider-neutral.
+
+## Errors and configuration
+
+The package performs no network requests and requires no authentication or
+environment variables. Several calculations return zero or `null` when data is
+invalid or insufficient; callers should validate data at external boundaries
+and handle the nullable return types declared by each function. Training
+calculations are estimates and are not medical advice.
+
+## License and contributing
+
+[MIT](./LICENSE). Source is in the
+[Dofek repository](https://github.com/Asherlc/dofek/tree/main/packages/training).
+Please [open an issue](https://github.com/Asherlc/dofek/issues) for bugs or API
+proposals, or [submit a pull request](https://github.com/Asherlc/dofek/pulls).

package/dist/activity-icons.d.ts

@@ -0,0 +1,10 @@
+export type ActivityIconCategory = "cycling" | "running" | "swimming" | "walking" | "strength" | "yoga" | "hiit" | "elliptical" | "rowing" | "winter" | "climbing" | "water" | "team" | "dance" | "other";
+export interface ActivityIconInfo {
+    category: ActivityIconCategory;
+    emoji: string;
+    gradientFrom: string;
+    gradientTo: string;
+}
+export declare function resolveActivityIconCategory(activityType: string): ActivityIconCategory;
+export declare function getActivityIconInfo(activityType: string): ActivityIconInfo;
+//# sourceMappingURL=activity-icons.d.ts.map

package/dist/activity-icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-icons.d.ts","sourceRoot":"","sources":["../src/activity-icons.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,SAAS,GACT,UAAU,GACV,SAAS,GACT,UAAU,GACV,MAAM,GACN,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AA2BD,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,oBAAoB,CA4EtF;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAM1E"}

package/dist/activity-icons.js

@@ -0,0 +1,102 @@
+import { isCyclingActivity } from "./training.js";
+const CATEGORY_INFO = {
+    cycling: { emoji: "\u{1F6B4}", gradientFrom: "#2563eb", gradientTo: "#1d4ed8" },
+    running: { emoji: "\u{1F3C3}", gradientFrom: "#ea580c", gradientTo: "#c2410c" },
+    swimming: { emoji: "\u{1F3CA}", gradientFrom: "#0891b2", gradientTo: "#0e7490" },
+    walking: { emoji: "\u{1F6B6}", gradientFrom: "#16a34a", gradientTo: "#15803d" },
+    strength: { emoji: "\u{1F3CB}\u{FE0F}", gradientFrom: "#7c3aed", gradientTo: "#6d28d9" },
+    yoga: { emoji: "\u{1F9D8}", gradientFrom: "#db2777", gradientTo: "#be185d" },
+    hiit: { emoji: "\u{1F4A5}", gradientFrom: "#dc2626", gradientTo: "#b91c1c" },
+    elliptical: {
+        emoji: "\u{1F3C3}\u{200D}\u{2642}\u{FE0F}",
+        gradientFrom: "#059669",
+        gradientTo: "#047857",
+    },
+    rowing: { emoji: "\u{1F6A3}", gradientFrom: "#0284c7", gradientTo: "#0369a1" },
+    winter: { emoji: "\u{26F7}\u{FE0F}", gradientFrom: "#6366f1", gradientTo: "#4f46e5" },
+    climbing: { emoji: "\u{1F9D7}", gradientFrom: "#78716c", gradientTo: "#57534e" },
+    water: { emoji: "\u{1F3C4}", gradientFrom: "#06b6d4", gradientTo: "#0891b2" },
+    team: { emoji: "\u{26BD}", gradientFrom: "#65a30d", gradientTo: "#4d7c0f" },
+    dance: { emoji: "\u{1F483}", gradientFrom: "#d946ef", gradientTo: "#a21caf" },
+    other: { emoji: "\u{26A1}", gradientFrom: "#6b7280", gradientTo: "#4b5563" },
+};
+export function resolveActivityIconCategory(activityType) {
+    const lower = activityType.trim().toLowerCase();
+    if (isCyclingActivity(lower))
+        return "cycling";
+    if (lower.includes("run") || lower.includes("trail"))
+        return "running";
+    if (lower.includes("swim") || lower.includes("triathlon"))
+        return "swimming";
+    if (lower.includes("walk") || lower.includes("hiking") || lower.includes("stair"))
+        return "walking";
+    if (lower.includes("strength") ||
+        lower.includes("weight") ||
+        lower.includes("functional_fitness") ||
+        lower.includes("bootcamp") ||
+        lower.includes("core") ||
+        lower.includes("circuit") ||
+        lower.includes("box") ||
+        lower.includes("martial")) {
+        return "strength";
+    }
+    if (lower.includes("yoga") ||
+        lower.includes("pilates") ||
+        lower.includes("meditation") ||
+        lower.includes("mind") ||
+        lower.includes("stretch")) {
+        return "yoga";
+    }
+    if (lower.includes("hiit") || lower.includes("cross_training") || lower.includes("cardio")) {
+        return "hiit";
+    }
+    if (lower.includes("elliptical"))
+        return "elliptical";
+    if (lower.includes("rowing"))
+        return "rowing";
+    if (lower.includes("ski") ||
+        lower.includes("skating") ||
+        lower.includes("snow") ||
+        lower.includes("curling") ||
+        lower.includes("ice_hockey")) {
+        return "winter";
+    }
+    if (lower.includes("climb"))
+        return "climbing";
+    if (lower.includes("surf") ||
+        lower.includes("kayak") ||
+        lower.includes("paddle") ||
+        lower.includes("aqua") ||
+        lower.includes("water_polo")) {
+        return "water";
+    }
+    if (lower.includes("tennis") ||
+        lower.includes("basketball") ||
+        lower.includes("soccer") ||
+        lower.includes("football") ||
+        lower.includes("hockey") ||
+        lower.includes("ball") ||
+        lower.includes("golf") ||
+        lower.includes("pickleball") ||
+        lower.includes("badminton") ||
+        lower.includes("volleyball") ||
+        lower.includes("cricket") ||
+        lower.includes("rugby") ||
+        lower.includes("lacrosse") ||
+        lower.includes("handball") ||
+        lower.includes("baseball") ||
+        lower.includes("softball")) {
+        return "team";
+    }
+    if (lower === "dance" || lower === "dancing")
+        return "dance";
+    return "other";
+}
+export function getActivityIconInfo(activityType) {
+    const category = resolveActivityIconCategory(activityType);
+    return {
+        category,
+        ...CATEGORY_INFO[category],
+    };
+}
+//# sourceMappingURL=activity-icons.js.map

package/dist/activity-icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-icons.js","sourceRoot":"","sources":["../src/activity-icons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AA0BlD,MAAM,aAAa,GAGf;IACF,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IAC/E,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IAC/E,QAAQ,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IAChF,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IAC/E,QAAQ,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IACxF,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IAC5E,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IAC5E,UAAU,EAAE;QACV,KAAK,EAAE,mCAAmC;QAC1C,YAAY,EAAE,SAAS;QACvB,UAAU,EAAE,SAAS;KACtB;IACD,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IAC9E,MAAM,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IACrF,QAAQ,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IAChF,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IAC7E,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IAC3E,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;IAC7E,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;CAC7E,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,YAAoB;IAC9D,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEhD,IAAI,iBAAiB,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACvE,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,UAAU,CAAC;IAC7E,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC/E,OAAO,SAAS,CAAC;IACnB,IACE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC1B,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxB,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QACpC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC1B,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtB,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QACzB,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrB,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EACzB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IACE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtB,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QACzB,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC5B,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtB,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EACzB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3F,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,YAAY,CAAC;IACtD,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9C,IACE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrB,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QACzB,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtB,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QACzB,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAC5B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,UAAU,CAAC;IAC/C,IACE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtB,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QACvB,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxB,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtB,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAC5B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IACE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxB,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC5B,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxB,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC1B,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxB,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtB,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtB,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC5B,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC3B,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC5B,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QACzB,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QACvB,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC1B,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC1B,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC1B,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAC1B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAE7D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,MAAM,QAAQ,GAAG,2BAA2B,CAAC,YAAY,CAAC,CAAC;IAC3D,OAAO;QACL,QAAQ;QACR,GAAG,aAAa,CAAC,QAAQ,CAAC;KAC3B,CAAC;AACJ,CAAC"}

package/dist/climbing-grades.d.ts

@@ -0,0 +1,8 @@
+export type ClimbingGradeSystem = "v_scale" | "yds";
+export interface ParsedClimbingGrade {
+    gradeSystem: ClimbingGradeSystem;
+    grade: string;
+    sortValue: number;
+}
+export declare function parseClimbingGrade(input: string): ParsedClimbingGrade | null;
+//# sourceMappingURL=climbing-grades.d.ts.map

package/dist/climbing-grades.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"climbing-grades.d.ts","sourceRoot":"","sources":["../src/climbing-grades.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,KAAK,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,mBAAmB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAsGD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAE5E"}

package/dist/climbing-grades.js

@@ -0,0 +1,80 @@
+const vScalePattern = /^V(?<grade>B|0|[1-9]\d*)$/i;
+const yosemiteDecimalSystemPattern = /^5\.(?<majorGrade>\d{1,2})(?<modifier>[ABCD]|[+-])?$/i;
+const yosemiteLetterSortOffsets = new Map([
+    ["a", 1],
+    ["b", 2],
+    ["c", 3],
+    ["d", 4],
+]);
+class ClimbingGradeParser {
+    parse(input) {
+        const trimmedInput = input.trim();
+        return (this.#parseVScaleGrade(trimmedInput) ?? this.#parseYosemiteDecimalSystemGrade(trimmedInput));
+    }
+    #parseVScaleGrade(input) {
+        const match = vScalePattern.exec(input);
+        const matchedGrade = match?.groups?.grade;
+        if (!matchedGrade) {
+            return null;
+        }
+        if (matchedGrade.toUpperCase() === "B") {
+            return {
+                gradeSystem: "v_scale",
+                grade: "VB",
+                sortValue: -1,
+            };
+        }
+        const sortValue = Number.parseInt(matchedGrade, 10);
+        if (!Number.isSafeInteger(sortValue)) {
+            return null;
+        }
+        return {
+            gradeSystem: "v_scale",
+            grade: `V${sortValue}`,
+            sortValue,
+        };
+    }
+    #parseYosemiteDecimalSystemGrade(input) {
+        const match = yosemiteDecimalSystemPattern.exec(input);
+        const matchedMajorGrade = match?.groups?.majorGrade;
+        if (!matchedMajorGrade) {
+            return null;
+        }
+        const majorGrade = Number.parseInt(matchedMajorGrade, 10);
+        if (!Number.isInteger(majorGrade) || majorGrade < 0 || majorGrade > 15) {
+            return null;
+        }
+        const modifier = match.groups?.modifier?.toLowerCase();
+        const sortValue = this.#computeYosemiteDecimalSystemSortValue(majorGrade, modifier);
+        if (sortValue === null) {
+            return null;
+        }
+        return {
+            gradeSystem: "yds",
+            grade: `5.${majorGrade}${modifier ?? ""}`,
+            sortValue,
+        };
+    }
+    #computeYosemiteDecimalSystemSortValue(majorGrade, modifier) {
+        const baseSortValue = 5000 + majorGrade * 10;
+        if (!modifier) {
+            return baseSortValue;
+        }
+        if (modifier === "-") {
+            return baseSortValue - 3;
+        }
+        if (modifier === "+") {
+            return baseSortValue + 5;
+        }
+        const letterSortOffset = yosemiteLetterSortOffsets.get(modifier);
+        if (letterSortOffset === undefined) {
+            return null;
+        }
+        return baseSortValue + letterSortOffset;
+    }
+}
+const climbingGradeParser = new ClimbingGradeParser();
+export function parseClimbingGrade(input) {
+    return climbingGradeParser.parse(input);
+}
+//# sourceMappingURL=climbing-grades.js.map

package/dist/climbing-grades.js.map

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

package/dist/derived-cardio.d.ts

@@ -0,0 +1,17 @@
+export interface CyclingVo2MaxInput {
+    fiveMinutePowerWatts: number;
+    weightKg: number | null;
+}
+export interface AcsmVo2MaxInput {
+    speedMetersPerMinute: number;
+    gradeFraction: number;
+    averageHeartRate: number;
+    restingHeartRate: number;
+    maxHeartRate: number;
+}
+export declare function estimateCyclingVo2Max(input: CyclingVo2MaxInput): number | null;
+export declare function estimateSubmaximalAcsmVo2Max(input: AcsmVo2MaxInput): number | null;
+export declare function averageVo2MaxEstimates(estimates: readonly (number | null)[]): number | null;
+export declare function isValidVo2MaxEstimate(estimate: number | null): estimate is number;
+export declare function isSupportedOutdoorVo2MaxActivityType(activityType: string): boolean;
+//# sourceMappingURL=derived-cardio.d.ts.map

package/dist/derived-cardio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived-cardio.d.ts","sourceRoot":"","sources":["../src/derived-cardio.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAsBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAoB9E;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CA+ClF;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,MAAM,GAAG,IAAI,CAa3F;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,IAAI,MAAM,CAEjF;AAED,wBAAgB,oCAAoC,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAIlF"}

package/dist/derived-cardio.js

@@ -0,0 +1,84 @@
+const MIN_CYCLING_POWER_WATTS = 50;
+const MAX_CYCLING_POWER_WATTS = 700;
+const CYCLING_POWER_TO_OXYGEN_FACTOR = 10.8;
+const CYCLING_RESTING_OXYGEN_COST = 7;
+const MIN_ACSM_SPEED_METERS_PER_MINUTE = 40;
+const MAX_ACSM_SPEED_METERS_PER_MINUTE = 450;
+const MIN_ACSM_GRADE = -0.15;
+const MAX_ACSM_GRADE = 0.15;
+const RUNNING_SPEED_THRESHOLD_METERS_PER_MINUTE = 134;
+const MIN_HEART_RATE_RESERVE_FRACTION = 0.6;
+const MAX_HEART_RATE_RESERVE_FRACTION = 1;
+const SUPPORTED_OUTDOOR_VO2_MAX_ACTIVITY_TYPES = [
+    "running",
+    "trail_running",
+    "walking",
+    "hiking",
+];
+export function estimateCyclingVo2Max(input) {
+    if (!Number.isFinite(input.fiveMinutePowerWatts)) {
+        return null;
+    }
+    if (input.weightKg === null || !Number.isFinite(input.weightKg) || input.weightKg <= 0) {
+        return null;
+    }
+    if (input.fiveMinutePowerWatts < MIN_CYCLING_POWER_WATTS ||
+        input.fiveMinutePowerWatts > MAX_CYCLING_POWER_WATTS) {
+        return null;
+    }
+    return ((input.fiveMinutePowerWatts / input.weightKg) * CYCLING_POWER_TO_OXYGEN_FACTOR +
+        CYCLING_RESTING_OXYGEN_COST);
+}
+export function estimateSubmaximalAcsmVo2Max(input) {
+    if (!Number.isFinite(input.speedMetersPerMinute) ||
+        !Number.isFinite(input.gradeFraction) ||
+        !Number.isFinite(input.averageHeartRate) ||
+        !Number.isFinite(input.restingHeartRate) ||
+        !Number.isFinite(input.maxHeartRate)) {
+        return null;
+    }
+    if (input.speedMetersPerMinute < MIN_ACSM_SPEED_METERS_PER_MINUTE ||
+        input.speedMetersPerMinute > MAX_ACSM_SPEED_METERS_PER_MINUTE) {
+        return null;
+    }
+    if (input.gradeFraction < MIN_ACSM_GRADE || input.gradeFraction > MAX_ACSM_GRADE) {
+        return null;
+    }
+    const heartRateReserve = input.maxHeartRate - input.restingHeartRate;
+    if (heartRateReserve <= 0) {
+        return null;
+    }
+    const intensityFraction = (input.averageHeartRate - input.restingHeartRate) / heartRateReserve;
+    if (intensityFraction < MIN_HEART_RATE_RESERVE_FRACTION ||
+        intensityFraction >= MAX_HEART_RATE_RESERVE_FRACTION) {
+        return null;
+    }
+    const oxygenCost = input.speedMetersPerMinute >= RUNNING_SPEED_THRESHOLD_METERS_PER_MINUTE
+        ? getRunningOxygenCost(input.speedMetersPerMinute, input.gradeFraction)
+        : getWalkingOxygenCost(input.speedMetersPerMinute, input.gradeFraction);
+    if (oxygenCost <= 0 || !Number.isFinite(oxygenCost)) {
+        return null;
+    }
+    return oxygenCost / intensityFraction;
+}
+export function averageVo2MaxEstimates(estimates) {
+    const validEstimates = estimates.filter(isValidVo2MaxEstimate);
+    if (validEstimates.length === 0) {
+        return null;
+    }
+    const totalEstimate = validEstimates.reduce((runningTotal, estimate) => runningTotal + estimate, 0);
+    return totalEstimate / validEstimates.length;
+}
+export function isValidVo2MaxEstimate(estimate) {
+    return estimate !== null && Number.isFinite(estimate) && estimate > 0;
+}
+export function isSupportedOutdoorVo2MaxActivityType(activityType) {
+    return SUPPORTED_OUTDOOR_VO2_MAX_ACTIVITY_TYPES.some((supportedActivityType) => supportedActivityType === activityType);
+}
+function getWalkingOxygenCost(speedMetersPerMinute, gradeFraction) {
+    return 0.1 * speedMetersPerMinute + 1.8 * speedMetersPerMinute * gradeFraction + 3.5;
+}
+function getRunningOxygenCost(speedMetersPerMinute, gradeFraction) {
+    return 0.2 * speedMetersPerMinute + 0.9 * speedMetersPerMinute * gradeFraction + 3.5;
+}
+//# sourceMappingURL=derived-cardio.js.map

package/dist/derived-cardio.js.map

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

package/dist/endurance-types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Endurance activity type classification.
+ *
+ * Activity types considered "endurance" for training analysis.
+ * Used to filter training queries (HR zones, polarization, ramp rate, etc.)
+ * so that strength training, yoga, etc. don't skew intensity metrics.
+ */
+export declare const ENDURANCE_ACTIVITY_TYPES: readonly ["cycling", "road_cycling", "mountain_biking", "gravel_cycling", "indoor_cycling", "virtual_cycling", "e_bike_cycling", "cyclocross", "track_cycling", "bmx", "hand_cycling", "running", "swimming", "walking", "hiking"];
+export type EnduranceActivityType = (typeof ENDURANCE_ACTIVITY_TYPES)[number];
+/** Check whether an activity type is endurance (cardio). */
+export declare function isEnduranceActivity(activityType: string): activityType is EnduranceActivityType;
+/**
+ * Activity types that are performed on a stationary trainer / indoors.
+ * Speed and distance are not physically meaningful for these — the values
+ * are simulated by the device or platform.
+ */
+export declare const INDOOR_CYCLING_TYPES: readonly ["indoor_cycling", "virtual_cycling"];
+export type IndoorCyclingType = (typeof INDOOR_CYCLING_TYPES)[number];
+/** Check whether an activity type is indoor cycling (stationary trainer or virtual ride). */
+export declare function isIndoorCycling(activityType: string): activityType is IndoorCyclingType;
+//# sourceMappingURL=endurance-types.d.ts.map

package/dist/endurance-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endurance-types.d.ts","sourceRoot":"","sources":["../src/endurance-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,wBAAwB,oOAgB3B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,IAAI,qBAAqB,CAE/F;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,gDAAiD,CAAC;AAEnF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,IAAI,iBAAiB,CAEvF"}

package/dist/endurance-types.js

@@ -0,0 +1,39 @@
+/**
+ * Endurance activity type classification.
+ *
+ * Activity types considered "endurance" for training analysis.
+ * Used to filter training queries (HR zones, polarization, ramp rate, etc.)
+ * so that strength training, yoga, etc. don't skew intensity metrics.
+ */
+export const ENDURANCE_ACTIVITY_TYPES = [
+    "cycling",
+    "road_cycling",
+    "mountain_biking",
+    "gravel_cycling",
+    "indoor_cycling",
+    "virtual_cycling",
+    "e_bike_cycling",
+    "cyclocross",
+    "track_cycling",
+    "bmx",
+    "hand_cycling",
+    "running",
+    "swimming",
+    "walking",
+    "hiking",
+];
+/** Check whether an activity type is endurance (cardio). */
+export function isEnduranceActivity(activityType) {
+    return ENDURANCE_ACTIVITY_TYPES.some((t) => t === activityType);
+}
+/**
+ * Activity types that are performed on a stationary trainer / indoors.
+ * Speed and distance are not physically meaningful for these — the values
+ * are simulated by the device or platform.
+ */
+export const INDOOR_CYCLING_TYPES = ["indoor_cycling", "virtual_cycling"];
+/** Check whether an activity type is indoor cycling (stationary trainer or virtual ride). */
+export function isIndoorCycling(activityType) {
+    return INDOOR_CYCLING_TYPES.some((t) => t === activityType);
+}
+//# sourceMappingURL=endurance-types.js.map

package/dist/endurance-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endurance-types.js","sourceRoot":"","sources":["../src/endurance-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,SAAS;IACT,cAAc;IACd,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;IAChB,YAAY;IACZ,eAAe;IACf,KAAK;IACL,cAAc;IACd,SAAS;IACT,UAAU;IACV,SAAS;IACT,QAAQ;CACA,CAAC;AAIX,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,gBAAgB,EAAE,iBAAiB,CAAU,CAAC;AAInF,6FAA6F;AAC7F,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC;AAC9D,CAAC"}

package/dist/grade-adjusted-pace.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Minetti cost factor model for grade-adjusted pace.
+ *
+ * Normalizes walking/hiking/trail-running pace to account for terrain grade,
+ * allowing meaningful comparison between hilly and flat activities.
+ *
+ * Reference: Minetti et al. (2002) "Energy cost of walking and running at
+ * extreme uphill and downhill slopes"
+ */
+/**
+ * Compute the energy cost factor for a given terrain grade using a simplified
+ * Minetti model.
+ *
+ * - Uphill (grade > 0): cost increases linearly at 3.5× the grade fraction.
+ * - Downhill (grade < 0): cost decreases at 1.8× the grade fraction, floored
+ *   at 0.5 (steep downhill is still effortful due to braking forces).
+ * - Flat (grade = 0): cost factor is 1 (no adjustment).
+ *
+ * @param grade - Terrain grade as a decimal fraction (e.g. 0.10 = 10% grade).
+ */
+export declare function minettiCostFactor(grade: number): number;
+/**
+ * Compute grade-adjusted pace by dividing actual pace by the Minetti cost factor.
+ *
+ * A steep uphill activity with a slow actual pace will produce a faster
+ * grade-adjusted pace (the athlete was working harder than flat pace suggests).
+ * Conversely, a fast downhill pace will adjust slower.
+ *
+ * @param actualPaceMinPerKm - Actual pace in minutes per kilometer.
+ * @param grade - Terrain grade as a decimal fraction (e.g. 0.10 = 10% grade).
+ * @returns Grade-adjusted pace in minutes per kilometer.
+ */
+export declare function computeGradeAdjustedPace(actualPaceMinPerKm: number, grade: number): number;
+//# sourceMappingURL=grade-adjusted-pace.d.ts.map

package/dist/grade-adjusted-pace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade-adjusted-pace.d.ts","sourceRoot":"","sources":["../src/grade-adjusted-pace.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,kBAAkB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1F"}

package/dist/grade-adjusted-pace.js

@@ -0,0 +1,41 @@
+/**
+ * Minetti cost factor model for grade-adjusted pace.
+ *
+ * Normalizes walking/hiking/trail-running pace to account for terrain grade,
+ * allowing meaningful comparison between hilly and flat activities.
+ *
+ * Reference: Minetti et al. (2002) "Energy cost of walking and running at
+ * extreme uphill and downhill slopes"
+ */
+/**
+ * Compute the energy cost factor for a given terrain grade using a simplified
+ * Minetti model.
+ *
+ * - Uphill (grade > 0): cost increases linearly at 3.5× the grade fraction.
+ * - Downhill (grade < 0): cost decreases at 1.8× the grade fraction, floored
+ *   at 0.5 (steep downhill is still effortful due to braking forces).
+ * - Flat (grade = 0): cost factor is 1 (no adjustment).
+ *
+ * @param grade - Terrain grade as a decimal fraction (e.g. 0.10 = 10% grade).
+ */
+export function minettiCostFactor(grade) {
+    if (grade >= 0) {
+        return 1 + grade * 3.5;
+    }
+    return Math.max(0.5, 1 - Math.abs(grade) * 1.8);
+}
+/**
+ * Compute grade-adjusted pace by dividing actual pace by the Minetti cost factor.
+ *
+ * A steep uphill activity with a slow actual pace will produce a faster
+ * grade-adjusted pace (the athlete was working harder than flat pace suggests).
+ * Conversely, a fast downhill pace will adjust slower.
+ *
+ * @param actualPaceMinPerKm - Actual pace in minutes per kilometer.
+ * @param grade - Terrain grade as a decimal fraction (e.g. 0.10 = 10% grade).
+ * @returns Grade-adjusted pace in minutes per kilometer.
+ */
+export function computeGradeAdjustedPace(actualPaceMinPerKm, grade) {
+    return actualPaceMinPerKm / minettiCostFactor(grade);
+}
+//# sourceMappingURL=grade-adjusted-pace.js.map

package/dist/grade-adjusted-pace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade-adjusted-pace.js","sourceRoot":"","sources":["../src/grade-adjusted-pace.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,kBAA0B,EAAE,KAAa;IAChF,OAAO,kBAAkB,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC"}