@jjlmoya/utils-health 1.18.0 → 1.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-health",
-    "version": "1.18.0",
+    "version": "1.20.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/category/index.ts

@@ -5,6 +5,7 @@ import { daltonismSimulator } from '../tool/daltonismSimulator/entry';
 import { tinnitusReliever } from '../tool/tinnitusReliever/entry';
 import { breathingVisualizer } from '../tool/breathingVisualizer/entry';
 import { caffeineTracker } from '../tool/caffeineTracker/entry';
+import { dailyProteinCalculator } from '../tool/dailyProteinCalculator/entry';
 import { waterPurifier } from '../tool/waterPurifier/entry';
 import { digestionStopwatch } from '../tool/digestionStopwatch/entry';
 import { binauralTuner } from '../tool/binauralTuner/entry';
@@ -12,10 +13,11 @@ import { pelliRobsonTest } from '../tool/pelliRobsonTest/entry';
 import { peripheralVisionTrainer } from '../tool/peripheralVisionTrainer/entry';
 import { epworthSleepinessScale } from '../tool/epworthSleepinessScale/entry';
 import { leanBodyMassCalculator } from '../tool/leanBodyMassCalculator/entry';
+import { metabolicAgeCalculator } from '../tool/metabolicAgeCalculator/entry';
 
 export const healthCategory: HealthCategoryEntry = {
   icon: 'mdi:heart-pulse',
-  tools: [bmiCalculator, bodyAdiposityIndexCalculator, leanBodyMassCalculator, daltonismSimulator, tinnitusReliever, breathingVisualizer, caffeineTracker, waterPurifier, digestionStopwatch, binauralTuner, pelliRobsonTest, peripheralVisionTrainer, epworthSleepinessScale],
+  tools: [bmiCalculator, bodyAdiposityIndexCalculator, leanBodyMassCalculator, metabolicAgeCalculator, dailyProteinCalculator, daltonismSimulator, tinnitusReliever, breathingVisualizer, caffeineTracker, waterPurifier, digestionStopwatch, binauralTuner, pelliRobsonTest, peripheralVisionTrainer, epworthSleepinessScale],
   i18n: {
     en: () => import('./i18n/en').then((m) => m.content),
     es: () => import('./i18n/es').then((m) => m.content),

package/src/data.ts

@@ -15,6 +15,7 @@ export { bloodUnitConverter } from './tool/bloodUnitConverter';
 export { readingDistanceCalculator } from './tool/readingDistanceCalculator';
 export { hydrationCalculator } from './tool/hydrationCalculator';
 export { leanBodyMassCalculator } from './tool/leanBodyMassCalculator';
+export { metabolicAgeCalculator } from './tool/metabolicAgeCalculator';
 
 export { healthCategory } from './category';
 

package/src/entries.ts

@@ -4,11 +4,13 @@ export { bmiCalculator } from './tool/bmiCalculator/entry';
 export { bodyAdiposityIndexCalculator } from './tool/bodyAdiposityIndexCalculator/entry';
 export { breathingVisualizer } from './tool/breathingVisualizer/entry';
 export { caffeineTracker } from './tool/caffeineTracker/entry';
+export { dailyProteinCalculator } from './tool/dailyProteinCalculator/entry';
 export { daltonismSimulator } from './tool/daltonismSimulator/entry';
 export { digestionStopwatch } from './tool/digestionStopwatch/entry';
 export { epworthSleepinessScale } from './tool/epworthSleepinessScale/entry';
 export { hydrationCalculator } from './tool/hydrationCalculator/entry';
 export { leanBodyMassCalculator } from './tool/leanBodyMassCalculator/entry';
+export { metabolicAgeCalculator } from './tool/metabolicAgeCalculator/entry';
 export { pelliRobsonTest } from './tool/pelliRobsonTest/entry';
 export { peripheralVisionTrainer } from './tool/peripheralVisionTrainer/entry';
 export { readingDistanceCalculator } from './tool/readingDistanceCalculator/entry';
@@ -23,11 +25,13 @@ import { bmiCalculator } from './tool/bmiCalculator/entry';
 import { bodyAdiposityIndexCalculator } from './tool/bodyAdiposityIndexCalculator/entry';
 import { breathingVisualizer } from './tool/breathingVisualizer/entry';
 import { caffeineTracker } from './tool/caffeineTracker/entry';
+import { dailyProteinCalculator } from './tool/dailyProteinCalculator/entry';
 import { daltonismSimulator } from './tool/daltonismSimulator/entry';
 import { digestionStopwatch } from './tool/digestionStopwatch/entry';
 import { epworthSleepinessScale } from './tool/epworthSleepinessScale/entry';
 import { hydrationCalculator } from './tool/hydrationCalculator/entry';
 import { leanBodyMassCalculator } from './tool/leanBodyMassCalculator/entry';
+import { metabolicAgeCalculator } from './tool/metabolicAgeCalculator/entry';
 import { pelliRobsonTest } from './tool/pelliRobsonTest/entry';
 import { peripheralVisionTrainer } from './tool/peripheralVisionTrainer/entry';
 import { readingDistanceCalculator } from './tool/readingDistanceCalculator/entry';
@@ -35,4 +39,4 @@ import { screenDecompressionTime } from './tool/screenDecompressionTime/entry';
 import { tinnitusReliever } from './tool/tinnitusReliever/entry';
 import { ubeCalculator } from './tool/ubeCalculator/entry';
 import { waterPurifier } from './tool/waterPurifier/entry';
-export const ALL_ENTRIES = [binauralTuner, bloodUnitConverter, bmiCalculator, bodyAdiposityIndexCalculator, breathingVisualizer, caffeineTracker, daltonismSimulator, digestionStopwatch, epworthSleepinessScale, hydrationCalculator, leanBodyMassCalculator, pelliRobsonTest, peripheralVisionTrainer, readingDistanceCalculator, screenDecompressionTime, tinnitusReliever, ubeCalculator, waterPurifier];
+export const ALL_ENTRIES = [binauralTuner, bloodUnitConverter, bmiCalculator, bodyAdiposityIndexCalculator, breathingVisualizer, caffeineTracker, dailyProteinCalculator, daltonismSimulator, digestionStopwatch, epworthSleepinessScale, hydrationCalculator, leanBodyMassCalculator, metabolicAgeCalculator, pelliRobsonTest, peripheralVisionTrainer, readingDistanceCalculator, screenDecompressionTime, tinnitusReliever, ubeCalculator, waterPurifier];

package/src/index.ts

@@ -15,6 +15,9 @@ export * from './tool/bloodUnitConverter';
 export * from './tool/readingDistanceCalculator';
 export * from './tool/hydrationCalculator';
 export * from './tool/bodyAdiposityIndexCalculator';
+export * from './tool/dailyProteinCalculator';
+export * from './tool/leanBodyMassCalculator';
+export * from './tool/metabolicAgeCalculator';
 
 export { healthCategory } from './category';
 export const healthCategorySEO = () => import('./category/seo.astro').then((m) => m.default);

package/src/tests/locale_completeness.test.ts

@@ -36,6 +36,6 @@ describe('Locale Completeness Validation', () => {
   });
 
   it('all 18 tools registered', () => {
-    expect(ALL_TOOLS.length).toBe(18);
+    expect(ALL_TOOLS.length).toBe(20);
   });
 });

package/src/tests/tool_validation.test.ts

@@ -5,7 +5,7 @@ import { healthCategory } from '../data';
 describe('Tool Validation Suite', () => {
   describe('Library Registration', () => {
     it('should have 18 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(18);
+      expect(ALL_TOOLS.length).toBe(20);
     });
 
     it('healthCategory should be defined', () => {

package/src/tool/dailyProteinCalculator/bibliography.astro

@@ -0,0 +1,14 @@
+---
+import { Bibliography } from '@jjlmoya/utils-shared';
+import { dailyProteinCalculator } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'en' } = Astro.props;
+const content = await dailyProteinCalculator.i18n[locale]?.();
+---
+
+{content && <Bibliography links={content.bibliography} />}

package/src/tool/dailyProteinCalculator/bibliography.ts

@@ -0,0 +1,28 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Phillips SM, Chevalier S, Leidy HJ: Protein requirements beyond the RDA',
+    url: 'https://doi.org/10.1139/apnm-2015-0550',
+  },
+  {
+    name: 'Campbell B. et al.: International Society of Sports Nutrition position stand: protein and exercise',
+    url: 'https://doi.org/10.1186/1550-2783-4-8',
+  },
+  {
+    name: 'Jager R. et al.: International Society of Sports Nutrition position stand: protein and exercise update',
+    url: 'https://doi.org/10.1186/s12970-017-0177-8',
+  },
+  {
+    name: 'Institute of Medicine: Dietary Reference Intakes for Energy, Carbohydrate, Fiber, Fat, Fatty Acids, Cholesterol, Protein, and Amino Acids',
+    url: 'https://nap.nationalacademies.org/catalog/10490/dietary-reference-intakes-for-energy-carbohydrate-fiber-fat-fatty-acids-cholesterol-protein-and-amino-acids',
+  },
+  {
+    name: 'NIH Office of Dietary Supplements: Protein fact sheet',
+    url: 'https://ods.od.nih.gov/factsheets/Protein-HealthProfessional/',
+  },
+  {
+    name: 'Wikipedia: Protein in nutrition',
+    url: 'https://en.wikipedia.org/wiki/Protein_(nutrient)',
+  },
+];

package/src/tool/dailyProteinCalculator/component.astro

@@ -0,0 +1,282 @@
+---
+import { Icon } from 'astro-icon/components';
+import type { DailyProteinCalculatorUI } from './ui';
+
+interface Props {
+  locale?: string;
+  ui?: Record<string, unknown>;
+}
+
+const t = (Astro.props.ui || {}) as DailyProteinCalculatorUI;
+---
+
+<div class="dpc" data-ui={JSON.stringify(t)}>
+  <div class="dpc__shell">
+    <section class="dpc__result" aria-live="polite">
+      <div class="dpc__plate" aria-hidden="true">
+        <div class="dpc__plate-ring"></div>
+        <Icon name="mdi:food-steak" />
+      </div>
+      <div class="dpc__target">
+        <span>{t.dailyTargetLabel}</span>
+        <strong id="dpc-total">132 g</strong>
+      </div>
+      <div class="dpc__stats">
+        <div><span>{t.rangeLabel}</span><strong id="dpc-range">112-151 g</strong></div>
+        <div><span>{t.ratioLabel}</span><strong id="dpc-ratio">1.8 g/kg</strong></div>
+      </div>
+      <div id="dpc-safe" class="dpc__safe" hidden>
+        <Icon name="mdi:alert-outline" />
+        <div><strong>{t.safeLimitTitle}</strong><p>{t.safeLimitText}</p></div>
+      </div>
+    </section>
+
+    <section class="dpc__controls">
+      <div class="dpc__topline">
+        <div class="dpc__seg" role="group" aria-label={t.unitSystemLabel}>
+          <button class="dpc__seg-btn dpc__seg-btn--active" type="button" data-unit="metric">{t.unitMetric}</button>
+          <button class="dpc__seg-btn" type="button" data-unit="imperial">{t.unitImperial}</button>
+        </div>
+        <label class="dpc__toggle">
+          <input id="dpc-pregnant" type="checkbox" />
+          <span>{t.pregnancyLabel}</span>
+        </label>
+        <label class="dpc__toggle">
+          <input id="dpc-lactating" type="checkbox" />
+          <span>{t.lactationLabel}</span>
+        </label>
+      </div>
+
+      <div class="dpc__field">
+        <label for="dpc-weight"><b>{t.weightLabel}</b><output id="dpc-weight-output">75 kg</output></label>
+        <input id="dpc-weight" class="dpc__range" type="range" min="40" max="180" value="75" />
+      </div>
+
+      <div class="dpc__field">
+        <label for="dpc-age"><b>{t.ageLabel}</b><output id="dpc-age-output">38 years</output></label>
+        <input id="dpc-age" class="dpc__range" type="range" min="16" max="90" value="38" />
+      </div>
+
+      <div>
+        <span class="dpc__label">{t.goalLabel}</span>
+        <div class="dpc__chips" role="group" aria-label={t.goalLabel}>
+          <button class="dpc__chip" type="button" data-goal="fatLoss">{t.goalFatLoss}</button>
+          <button class="dpc__chip dpc__chip--active" type="button" data-goal="maintenance">{t.goalMaintenance}</button>
+          <button class="dpc__chip" type="button" data-goal="muscleGain">{t.goalMuscleGain}</button>
+          <button class="dpc__chip" type="button" data-goal="recovery">{t.goalRecovery}</button>
+        </div>
+      </div>
+
+      <div>
+        <span class="dpc__label">{t.activityLabel}</span>
+        <div class="dpc__chips" role="group" aria-label={t.activityLabel}>
+          <button class="dpc__chip" type="button" data-activity="sedentary">{t.activitySedentary}</button>
+          <button class="dpc__chip dpc__chip--active" type="button" data-activity="active">{t.activityActive}</button>
+          <button class="dpc__chip" type="button" data-activity="endurance">{t.activityEndurance}</button>
+          <button class="dpc__chip" type="button" data-activity="strength">{t.activityStrength}</button>
+          <button class="dpc__chip" type="button" data-activity="athlete">{t.activityAthlete}</button>
+        </div>
+      </div>
+    </section>
+    <section class="dpc__foods">
+      <h3>{t.foodPanelTitle}</h3>
+      <div class="dpc__food-grid">
+        <div><Icon name="mdi:food-drumstick" /><span>{t.chickenLabel}</span><strong id="dpc-chicken">120 g</strong></div>
+        <div><Icon name="mdi:soy-sauce" /><span>{t.tofuLabel}</span><strong id="dpc-tofu">310 g</strong></div>
+        <div><Icon name="mdi:egg" /><span>{t.eggsLabel}</span><strong id="dpc-eggs">5</strong></div>
+        <div><Icon name="mdi:bowl-mix" /><span>{t.greekYogurtLabel}</span><strong id="dpc-yogurt">270 g</strong></div>
+        <div><Icon name="mdi:spoon-sugar" /><span>{t.proteinPowderLabel}</span><strong id="dpc-powder">5 {t.scoops}</strong></div>
+        <div><Icon name="mdi:fish" /><span>{t.tunaLabel}</span><strong id="dpc-tuna">120 {t.grams}</strong></div>
+      </div>
+      <p><strong>{t.educationTitle}</strong> {t.educationText}</p>
+    </section>
+  </div>
+</div>
+
+<script>
+  type Unit = 'metric' | 'imperial';
+  type Goal = 'fatLoss' | 'maintenance' | 'muscleGain' | 'recovery';
+  type Activity = 'sedentary' | 'active' | 'endurance' | 'strength' | 'athlete';
+
+  interface CalculatorState {
+    unit: Unit;
+    weightKg: number;
+    age: number;
+    goal: Goal;
+    activity: Activity;
+    pregnant: boolean;
+    lactating: boolean;
+  }
+
+  const activityRanges: Record<Activity, [number, number]> = {
+    sedentary: [0.8, 1],
+    active: [1.2, 1.5],
+    endurance: [1.2, 1.6],
+    strength: [1.6, 2.2],
+    athlete: [1.8, 2.3],
+  };
+  const goalBoost: Record<Goal, [number, number]> = {
+    maintenance: [0, 0],
+    recovery: [0.2, 0.3],
+    muscleGain: [0.2, 0.4],
+    fatLoss: [0.5, 0.7],
+  };
+
+  function requireEl<T extends Element>(root: Element, selector: string): T {
+    const el = root.querySelector<T>(selector);
+    if (!el) throw new Error(`Missing ${selector}`);
+    return el;
+  }
+
+  function kgToLb(kg: number) { return kg * 2.2046226218; }
+  function lbToKg(lb: number) { return lb / 2.2046226218; }
+
+  function calculate(state: CalculatorState) {
+    const [activityLow, activityHigh] = activityRanges[state.activity];
+    const [boostLow, boostHigh] = goalBoost[state.goal];
+    const ageBoost = state.age >= 65 ? 0.2 : 0;
+    const low = Math.min(2.4, activityLow + boostLow + ageBoost);
+    const high = Math.min(2.6, activityHigh + boostHigh + ageBoost);
+    const ratio = Math.round(((low + high) / 2) * 10) / 10;
+    const added = (state.pregnant ? 25 : 0) + (state.lactating ? 20 : 0);
+    const total = Math.round(state.weightKg * ratio + added);
+    return { total, low: Math.round(state.weightKg * low + added), high: Math.round(state.weightKg * high + added), ratio };
+  }
+
+  function syncWeightControl(state: CalculatorState, weight: HTMLInputElement) {
+    if (state.unit === 'imperial') {
+      weight.min = '88';
+      weight.max = '397';
+      weight.value = String(Math.round(kgToLb(state.weightKg)));
+    } else {
+      weight.min = '40';
+      weight.max = '180';
+      weight.value = String(Math.round(state.weightKg));
+    }
+  }
+
+  function renderFoods(root: Element, total: number, ui: Record<string, string>) {
+    requireEl<HTMLElement>(root, '#dpc-chicken').textContent = `${Math.round((total / 31) * 100)} ${ui.grams}`;
+    requireEl<HTMLElement>(root, '#dpc-tofu').textContent = `${Math.round((total / 12) * 100)} ${ui.grams}`;
+    requireEl<HTMLElement>(root, '#dpc-eggs').textContent = `${Math.max(1, Math.round(total / 6))}`;
+    requireEl<HTMLElement>(root, '#dpc-yogurt').textContent = `${Math.round((total / 10) * 100)} ${ui.grams}`;
+    requireEl<HTMLElement>(root, '#dpc-powder').textContent = `${(total / 25).toFixed(1)} ${ui.scoops}`;
+    requireEl<HTMLElement>(root, '#dpc-tuna').textContent = `${Math.round((total / 26) * 100)} ${ui.grams}`;
+  }
+
+  function loadSavedState(state: CalculatorState) {
+    const saved = localStorage.getItem('dpc_state');
+    if (!saved) return;
+    try {
+      const parsed = JSON.parse(saved);
+      if (parsed.unit) state.unit = parsed.unit;
+      if (parsed.weightKg) state.weightKg = parsed.weightKg;
+      if (parsed.age) state.age = parsed.age;
+      if (parsed.goal) state.goal = parsed.goal;
+      if (parsed.activity) state.activity = parsed.activity;
+      state.pregnant = !!parsed.pregnant;
+      state.lactating = !!parsed.lactating;
+    } catch {}
+  }
+
+  function setupInputs(root: Element, state: CalculatorState) {
+    const weight = requireEl<HTMLInputElement>(root, '#dpc-weight');
+    const age = requireEl<HTMLInputElement>(root, '#dpc-age');
+    const pregnant = requireEl<HTMLInputElement>(root, '#dpc-pregnant');
+    const lactating = requireEl<HTMLInputElement>(root, '#dpc-lactating');
+
+    weight.value = String(state.unit === 'imperial' ? Math.round(kgToLb(state.weightKg)) : Math.round(state.weightKg));
+    age.value = String(state.age);
+    pregnant.checked = state.pregnant;
+    lactating.checked = state.lactating;
+  }
+
+  function updateActiveClasses(root: Element, state: CalculatorState) {
+    root.querySelectorAll<HTMLButtonElement>('[data-unit]').forEach((item) => {
+      item.classList.toggle('dpc__seg-btn--active', item.dataset.unit === state.unit);
+    });
+    root.querySelectorAll<HTMLButtonElement>('[data-goal]').forEach((item) => {
+      item.classList.toggle('dpc__chip--active', item.dataset.goal === state.goal);
+    });
+    root.querySelectorAll<HTMLButtonElement>('[data-activity]').forEach((item) => {
+      item.classList.toggle('dpc__chip--active', item.dataset.activity === state.activity);
+    });
+  }
+
+  function renderAll(root: Element, state: CalculatorState, ui: Record<string, string>) {
+    const result = calculate(state);
+    requireEl<HTMLElement>(root, '#dpc-total').textContent = `${result.total} ${ui.grams}`;
+    requireEl<HTMLElement>(root, '#dpc-range').textContent = `${result.low}-${result.high} ${ui.grams}`;
+    requireEl<HTMLElement>(root, '#dpc-ratio').textContent = `${result.ratio.toFixed(1)} g/kg`;
+    requireEl<HTMLOutputElement>(root, '#dpc-weight-output').textContent = state.unit === 'imperial' ? `${Math.round(kgToLb(state.weightKg))} ${ui.lb}` : `${Math.round(state.weightKg)} ${ui.kg}`;
+    requireEl<HTMLOutputElement>(root, '#dpc-age-output').textContent = `${state.age} ${ui.years}`;
+    requireEl<HTMLElement>(root, '#dpc-safe').hidden = result.total / state.weightKg <= 2.5;
+    renderFoods(root, result.total, ui);
+    localStorage.setItem('dpc_state', JSON.stringify(state));
+  }
+
+  function bindButtons(root: Element, state: CalculatorState, ui: Record<string, string>, weight: HTMLInputElement) {
+    root.querySelectorAll<HTMLButtonElement>('[data-unit]').forEach((btn) => {
+      btn.addEventListener('click', () => {
+        state.unit = btn.dataset.unit as Unit;
+        updateActiveClasses(root, state);
+        syncWeightControl(state, weight);
+        renderAll(root, state, ui);
+      });
+    });
+    root.querySelectorAll<HTMLButtonElement>('[data-goal]').forEach((btn) => {
+      btn.addEventListener('click', () => {
+        state.goal = btn.dataset.goal as Goal;
+        updateActiveClasses(root, state);
+        renderAll(root, state, ui);
+      });
+    });
+    root.querySelectorAll<HTMLButtonElement>('[data-activity]').forEach((btn) => {
+      btn.addEventListener('click', () => {
+        state.activity = btn.dataset.activity as Activity;
+        updateActiveClasses(root, state);
+        renderAll(root, state, ui);
+      });
+    });
+  }
+
+  function bindInputs(root: Element, state: CalculatorState, ui: Record<string, string>, weight: HTMLInputElement) {
+    const age = requireEl<HTMLInputElement>(root, '#dpc-age');
+    const pregnant = requireEl<HTMLInputElement>(root, '#dpc-pregnant');
+    const lactating = requireEl<HTMLInputElement>(root, '#dpc-lactating');
+
+    weight.addEventListener('input', () => {
+      state.weightKg = state.unit === 'imperial' ? lbToKg(Number(weight.value)) : Number(weight.value);
+      renderAll(root, state, ui);
+    });
+    age.addEventListener('input', () => {
+      state.age = Number(age.value);
+      renderAll(root, state, ui);
+    });
+    pregnant.addEventListener('change', () => {
+      state.pregnant = pregnant.checked;
+      renderAll(root, state, ui);
+    });
+    lactating.addEventListener('change', () => {
+      state.lactating = lactating.checked;
+      renderAll(root, state, ui);
+    });
+  }
+
+  function initDailyProtein(root: Element) {
+    const ui = JSON.parse((root as HTMLElement).dataset.ui || '{}') as Record<string, string>;
+    const state: CalculatorState = { unit: 'metric', weightKg: 75, age: 38, goal: 'maintenance', activity: 'active', pregnant: false, lactating: false };
+    const weight = requireEl<HTMLInputElement>(root, '#dpc-weight');
+
+    loadSavedState(state);
+    setupInputs(root, state);
+    updateActiveClasses(root, state);
+    syncWeightControl(state, weight);
+    bindButtons(root, state, ui, weight);
+    bindInputs(root, state, ui, weight);
+    renderAll(root, state, ui);
+  }
+
+  document.querySelectorAll('.dpc').forEach(initDailyProtein);
+</script>
+