@dgpholdings/greatoak-shared 1.2.57 → 1.2.58

package/dist/types/TApiExercise.d.ts

@@ -135,6 +135,9 @@ export type TExercise = {
         female: number;
         default: number;
     };
+    /** True for single-arm / single-leg exercises. The user enters weight per side,
+     *  so the scoring engine doubles it to get total mechanical load. */
+    isUnilateral?: boolean;
 };
 export type TBodyPartExercises = Record<TBodyPart, TExercise[]>;
 export type TApiCreateOrUpdateExerciseReq = {

package/dist/utils/scoringWorkout/calculateMuscleFatiue.d.ts

@@ -49,6 +49,8 @@ interface IFatigueExerciseData {
         muscleGroupFactor: number;
     };
     scoringSpecialHandling?: "plyometric" | "stretch-mobility" | "continuous-duration" | "loaded-carry";
+    /** P3-9: Single-arm/leg exercises. User enters weight per side; double it for total load. */
+    isUnilateral?: boolean;
 }
 /**
  * Calculate per-muscle fatigue scores for an exercise.

package/dist/utils/scoringWorkout/calculateMuscleFatiue.js

@@ -64,7 +64,7 @@ function calculateMuscleFatigue(sets, exercise, user, timingGuardrails, historic
         return {};
     const fatigueMultiplier = (_a = timingGuardrails === null || timingGuardrails === void 0 ? void 0 : timingGuardrails.fatigueMultiplier) !== null && _a !== void 0 ? _a : constants_1.FALLBACK_FATIGUE_MULTIPLIER;
     // --- Step 1–3: Compute cumulative fatigue stimulus ---
-    const cumulativeFatigue = computeCumulativeFatigue(sets, exercise.difficultyLevel, user, fatigueMultiplier, exercise.scoringSpecialHandling);
+    const cumulativeFatigue = computeCumulativeFatigue(sets, exercise.difficultyLevel, user, fatigueMultiplier, exercise.scoringSpecialHandling, exercise.isUnilateral);
     // --- Step 4: Distribute to muscles ---
     const rawMuscleFatigue = distributeFatigueToMuscles(cumulativeFatigue, exercise.primaryMuscles, exercise.secondaryMuscles);
     // --- Step 5: Normalize to 0–100 ---
@@ -88,11 +88,12 @@ function calculateMuscleFatigue(sets, exercise, user, timingGuardrails, historic
  * cardio:             Duration × speed factor (represents sustained effort)
  *   loaded-carry:     Speed factor boosted by carried weight relative to bodyweight
  */
-function computeVolumeLoad(set, difficultyLevel, user, scoringSpecialHandling) {
+function computeVolumeLoad(set, difficultyLevel, user, scoringSpecialHandling, isUnilateral) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
     switch (set.type) {
         case "weight-reps": {
-            const kg = (_a = set.kg) !== null && _a !== void 0 ? _a : 0;
+            // P3-9: User enters weight per side for unilateral exercises — double for total load
+            const kg = ((_a = set.kg) !== null && _a !== void 0 ? _a : 0) * (isUnilateral ? 2 : 1);
             const reps = (_b = set.reps) !== null && _b !== void 0 ? _b : 0;
             return kg * reps;
         }
@@ -175,12 +176,12 @@ function computeVolumeLoad(set, difficultyLevel, user, scoringSpecialHandling) {
  *
  * @returns Single number representing total fatigue stimulus
  */
-function computeCumulativeFatigue(sets, difficultyLevel, user, fatigueMultiplier, scoringSpecialHandling) {
+function computeCumulativeFatigue(sets, difficultyLevel, user, fatigueMultiplier, scoringSpecialHandling, isUnilateral) {
     let cumulative = 0;
     for (let i = 0; i < sets.length; i++) {
         const set = sets[i];
         // Step 1: Raw volume for this set
-        const volumeLoad = computeVolumeLoad(set, difficultyLevel, user, scoringSpecialHandling);
+        const volumeLoad = computeVolumeLoad(set, difficultyLevel, user, scoringSpecialHandling, isUnilateral);
         // Step 2: Scale by effort and exercise fatigue multiplier
         const stimulus = volumeLoad * set.effortFraction * fatigueMultiplier;
         // Step 3: Apply diminishing returns decay

package/dist/utils/scoringWorkout/calculateTotalVolume.d.ts

@@ -15,4 +15,4 @@ import { TRecord, TUserMetric } from "../../types";
  * @param difficultyLevel  Exercise difficulty (0–4). Used for bodyweight load
  *                         scaling on reps-only exercises (matches fatigue pillar).
  */
-export declare const calculateTotalVolume: (record: TRecord[], user: TUserMetric, scoringSpecialHandling?: "plyometric" | "stretch-mobility" | "continuous-duration" | "loaded-carry", difficultyLevel?: number) => number;
+export declare const calculateTotalVolume: (record: TRecord[], user: TUserMetric, scoringSpecialHandling?: "plyometric" | "stretch-mobility" | "continuous-duration" | "loaded-carry", difficultyLevel?: number, isUnilateral?: boolean) => number;

package/dist/utils/scoringWorkout/calculateTotalVolume.js

@@ -19,7 +19,7 @@ const constants_1 = require("./constants");
  * @param difficultyLevel  Exercise difficulty (0–4). Used for bodyweight load
  *                         scaling on reps-only exercises (matches fatigue pillar).
  */
-const calculateTotalVolume = (record, user, scoringSpecialHandling, difficultyLevel = 2) => {
+const calculateTotalVolume = (record, user, scoringSpecialHandling, difficultyLevel = 2, isUnilateral = false) => {
     if (scoringSpecialHandling === "stretch-mobility")
         return 0;
     // Bug A fix: only completed sets contribute to volume.
@@ -28,7 +28,8 @@ const calculateTotalVolume = (record, user, scoringSpecialHandling, difficultyLe
         switch (set.type) {
             case "weight-reps": {
                 const reps = parseFloat(set.reps) || 0;
-                const weight = parseFloat(set.kg) || 0;
+                // P3-9: User enters weight per side for unilateral exercises — double for total load
+                const weight = (parseFloat(set.kg) || 0) * (isUnilateral ? 2 : 1);
                 return total + reps * weight;
             }
             case "reps-only": {

package/dist/utils/scoringWorkout/index.js

@@ -45,6 +45,7 @@ const calculateExerciseScoreV2 = (param) => {
             muscleGroupFactor: exercise.metabolicData.muscleGroupFactor,
         },
         scoringSpecialHandling: exercise.scoringSpecialHandling,
+        isUnilateral: exercise.isUnilateral,
     }, userContext, exercise.timingGuardrails, historicalContext);
     // Pillar 3: Quality Score → score
     const isStrictTimingModeScoring = record.some((r) => r.isStrictMode);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dgpholdings/greatoak-shared",
-	"version": "1.2.57",
+	"version": "1.2.58",
 	"description": "Shared TypeScript types and utilities for @dgpholdings projects",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",