@jjlmoya/utils-health 1.18.0 → 1.19.0

package/package.json

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

package/src/category/index.ts

@@ -12,10 +12,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, 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

@@ -9,6 +9,7 @@ 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';
@@ -28,6 +29,7 @@ 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 +37,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, daltonismSimulator, digestionStopwatch, epworthSleepinessScale, hydrationCalculator, leanBodyMassCalculator, metabolicAgeCalculator, pelliRobsonTest, peripheralVisionTrainer, readingDistanceCalculator, screenDecompressionTime, tinnitusReliever, ubeCalculator, waterPurifier];

package/src/index.ts

@@ -15,6 +15,7 @@ export * from './tool/bloodUnitConverter';
 export * from './tool/readingDistanceCalculator';
 export * from './tool/hydrationCalculator';
 export * from './tool/bodyAdiposityIndexCalculator';
+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(19);
   });
 });

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(19);
     });
 
     it('healthCategory should be defined', () => {

package/src/tool/metabolicAgeCalculator/bibliography.astro

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

package/src/tool/metabolicAgeCalculator/bibliography.ts

@@ -0,0 +1,28 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Mifflin MD, St Jeor ST, et al.: A new predictive equation for resting energy expenditure in healthy individuals',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/2305711/',
+  },
+  {
+    name: 'Harris JA, Benedict FG.: A biometric study of human basal metabolism in man',
+    url: 'https://doi.org/10.1073/pnas.4.12.370',
+  },
+  {
+    name: 'Katch FI, McArdle WD.: Nutrition, Weight Control, and Exercise',
+    url: 'https://archive.org/details/nutritionweightc0000katc',
+  },
+  {
+    name: 'National Academies: Dietary Reference Intakes for Energy',
+    url: 'https://www.ncbi.nlm.nih.gov/books/NBK56068/',
+  },
+  {
+    name: 'CDC: Physical Activity Basics',
+    url: 'https://www.cdc.gov/physical-activity-basics/index.html',
+  },
+  {
+    name: 'Wikipedia: Basal metabolic rate',
+    url: 'https://en.wikipedia.org/wiki/Basal_metabolic_rate',
+  },
+];

package/src/tool/metabolicAgeCalculator/component.astro

@@ -0,0 +1,242 @@
+---
+import { Icon } from 'astro-icon/components';
+import type { MetabolicAgeCalculatorUI } from './ui';
+
+interface Props {
+  locale?: string;
+  ui?: Record<string, unknown>;
+}
+
+const t = (Astro.props.ui || {}) as MetabolicAgeCalculatorUI;
+---
+
+<div class="mac" data-ui={JSON.stringify(t)}>
+  <div class="mac__grid">
+    <section class="mac__dial-panel" aria-live="polite">
+      <div class="mac__dial">
+        <div class="mac__arc"></div>
+        <div class="mac__chrono-line" title={t.chronologicalAgeLabel}></div>
+        <div class="mac__needle"></div>
+        <div class="mac__hub"></div>
+        <div class="mac__readout">
+          <span>{t.metabolicAgeLabel}</span>
+          <strong id="mac-metabolic-age">42</strong>
+          <em id="mac-delta">{t.deltaAligned}</em>
+        </div>
+      </div>
+      <div class="mac__dial-legend" aria-label={t.dialLegendLabel}>
+        <span><i class="mac__key mac__key--needle"></i>{t.metabolicAgeLabel}</span>
+        <span><i class="mac__key mac__key--chrono"></i>{t.chronologicalAgeLabel}</span>
+      </div>
+
+      <div class="mac__scale">
+        <div class="mac__scale-bar"><span id="mac-score-bar" style="width: 62%"></span></div>
+        <div class="mac__scale-labels">
+          <strong id="mac-category">{t.categoryBalanced}</strong>
+          <span>{t.scaleRangeLabel}</span>
+        </div>
+      </div>
+
+      <div class="mac__metrics">
+        <div><span>{t.chronologicalAgeLabel}</span><strong id="mac-chronological">42</strong></div>
+        <div><span>{t.bmrLabel}</span><strong id="mac-bmr">1,620 {t.kcalDay}</strong></div>
+        <div><span>{t.tdeeLabel}</span><strong id="mac-tdee">2,511 {t.kcalDay}</strong></div>
+        <div><span>{t.idealBmrLabel}</span><strong id="mac-ideal-bmr">1,645 {t.kcalDay}</strong></div>
+      </div>
+    </section>
+
+    <section class="mac__controls">
+      <div class="mac__topline">
+        <div class="mac__seg" role="group" aria-label={t.unitSystemLabel}>
+          <button class="mac__seg-btn mac__seg-btn--active" type="button" data-unit="metric">{t.unitMetric}</button>
+          <button class="mac__seg-btn" type="button" data-unit="imperial">{t.unitImperial}</button>
+        </div>
+        <div class="mac__icons" role="group" aria-label={t.sexLabel}>
+          <button class="mac__icon-btn" type="button" data-sex="female" title={t.sexFemale}><Icon name="mdi:gender-female" /></button>
+          <button class="mac__icon-btn mac__icon-btn--active" type="button" data-sex="male" title={t.sexMale}><Icon name="mdi:gender-male" /></button>
+        </div>
+      </div>
+
+      <label class="mac__field">
+        <span><b>{t.ageLabel}</b><output id="mac-age-output">42</output></span>
+        <input id="mac-age" type="range" min="18" max="85" value="42" />
+      </label>
+
+      <label class="mac__field">
+        <span><b>{t.heightLabel}</b><output id="mac-height-output">175 {t.cm}</output></span>
+        <input id="mac-height" type="range" min="130" max="220" value="175" />
+      </label>
+
+      <label class="mac__field">
+        <span><b>{t.weightLabel}</b><output id="mac-weight-output">75 {t.kg}</output></span>
+        <input id="mac-weight" type="range" min="35" max="180" value="75" />
+      </label>
+
+      <label class="mac__field mac__field--fat">
+        <span><b>{t.bodyFatLabel}</b><output id="mac-fat-output">22{t.percent}</output></span>
+        <input id="mac-fat" type="range" min="5" max="55" value="22" />
+        <small>{t.bodyFatHint}</small>
+      </label>
+
+      <div class="mac__activity" role="group" aria-label={t.activityLabel}>
+        <button type="button" data-activity="sedentary">{t.activitySedentary}</button>
+        <button type="button" data-activity="light">{t.activityLight}</button>
+        <button class="mac__activity-active" type="button" data-activity="moderate">{t.activityModerate}</button>
+        <button type="button" data-activity="veryActive">{t.activityVeryActive}</button>
+      </div>
+    </section>
+
+    <section class="mac__advice">
+      <div class="mac__advice-head">
+        <Icon name="mdi:lightbulb-on-outline" />
+        <strong>{t.adviceTitle}</strong>
+      </div>
+      <div id="mac-advice-main" class="mac__advice-card">{t.adviceBalanced}</div>
+      <div class="mac__advice-row">
+        <div><Icon name="mdi:dumbbell" /><span>{t.adviceTraining}</span></div>
+        <div><Icon name="mdi:food-drumstick-outline" /><span>{t.adviceProtein}</span></div>
+      </div>
+      <p><strong>{t.disclaimerTitle}</strong> {t.disclaimerText}</p>
+    </section>
+  </div>
+</div>
+
+<script>
+  type Unit = 'metric' | 'imperial';
+  type Sex = 'female' | 'male';
+  type Activity = 'sedentary' | 'light' | 'moderate' | 'veryActive';
+
+  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 cmToIn(cm: number) { return cm / 2.54; }
+  function inToCm(inches: number) { return inches * 2.54; }
+  function mifflin(weightKg: number, heightCm: number, age: number, sex: Sex) { return 10 * weightKg + 6.25 * heightCm - 5 * age + (sex === 'male' ? 5 : -161); }
+  function katch(weightKg: number, fat: number) { return 370 + 21.6 * weightKg * (1 - fat / 100); }
+  function idealFat(age: number, sex: Sex) {
+    if (sex === 'male') {
+      if (age < 30) return 13;
+      if (age < 50) return 16;
+      return 19;
+    }
+
+    if (age < 30) return 21;
+    if (age < 50) return 23;
+    return 25;
+  }
+
+  function getCategoryLabel(cat: string, ui: Record<string, string>) {
+    if (cat === 'young') return ui.categoryYoung;
+    if (cat === 'balanced') return ui.categoryBalanced;
+    return ui.categoryAged;
+  }
+
+  function getAdvice(cat: string, ui: Record<string, string>) {
+    if (cat === 'young') return ui.adviceYoung;
+    if (cat === 'balanced') return ui.adviceBalanced;
+    return ui.adviceAged;
+  }
+
+  function getDeltaLabel(ageDelta: number, ui: Record<string, string>) {
+    if (ageDelta < 0) return `${Math.abs(ageDelta)} ${ui.deltaYounger}`;
+    if (ageDelta > 0) return `${ageDelta} ${ui.deltaOlder}`;
+    return ui.deltaAligned;
+  }
+
+  // eslint-disable-next-line max-lines-per-function
+  function initMAC(root: Element) {
+    const ui = JSON.parse((root as HTMLElement).dataset.ui || '{}') as Record<string, string>;
+    const state = { unit: 'metric' as Unit, sex: 'male' as Sex, activity: 'moderate' as Activity, age: 42, heightCm: 175, weightKg: 75, fat: 22 };
+    const activityMultipliers: Record<Activity, number> = { sedentary: 1.2, light: 1.375, moderate: 1.55, veryActive: 1.725 };
+    const age = requireEl<HTMLInputElement>(root, '#mac-age');
+    const height = requireEl<HTMLInputElement>(root, '#mac-height');
+    const weight = requireEl<HTMLInputElement>(root, '#mac-weight');
+    const fat = requireEl<HTMLInputElement>(root, '#mac-fat');
+    const ageOutput = requireEl<HTMLOutputElement>(root, '#mac-age-output');
+    const heightOutput = requireEl<HTMLOutputElement>(root, '#mac-height-output');
+    const weightOutput = requireEl<HTMLOutputElement>(root, '#mac-weight-output');
+    const fatOutput = requireEl<HTMLOutputElement>(root, '#mac-fat-output');
+    const dial = requireEl<HTMLElement>(root, '.mac__dial');
+    const metabolicAge = requireEl<HTMLElement>(root, '#mac-metabolic-age');
+    const delta = requireEl<HTMLElement>(root, '#mac-delta');
+    const category = requireEl<HTMLElement>(root, '#mac-category');
+    const scoreBar = requireEl<HTMLElement>(root, '#mac-score-bar');
+    const chronological = requireEl<HTMLElement>(root, '#mac-chronological');
+    const bmrEl = requireEl<HTMLElement>(root, '#mac-bmr');
+    const tdeeEl = requireEl<HTMLElement>(root, '#mac-tdee');
+    const idealBmrEl = requireEl<HTMLElement>(root, '#mac-ideal-bmr');
+    const advice = requireEl<HTMLElement>(root, '#mac-advice-main');
+
+    function formatMass(valueKg: number) {
+      return state.unit === 'imperial' ? `${Math.round(kgToLb(valueKg))} ${ui.lb}` : `${Math.round(valueKg)} ${ui.kg}`;
+    }
+
+    function syncUnitControls() {
+      if (state.unit === 'imperial') {
+        height.min = '51'; height.max = '87'; height.step = '0.5'; height.value = cmToIn(state.heightCm).toFixed(1);
+        weight.min = '77'; weight.max = '397'; weight.step = '1'; weight.value = String(Math.round(kgToLb(state.weightKg)));
+      } else {
+        height.min = '130'; height.max = '220'; height.step = '1'; height.value = String(Math.round(state.heightCm));
+        weight.min = '35'; weight.max = '180'; weight.step = '1'; weight.value = String(Math.round(state.weightKg));
+      }
+    }
+
+    function render() {
+      const bmr = katch(state.weightKg, state.fat);
+      const idealBmr = katch(state.weightKg, idealFat(state.age, state.sex));
+      const metabolic = Math.max(12, Math.min(95, Math.round(state.age + (state.fat - idealFat(state.age, state.sex)) * 0.8 + ((idealBmr - bmr) / 20))));
+      const ageDelta = metabolic - state.age;
+      const score = Math.max(0, Math.min(100, 62 - ageDelta * 3 + (activityMultipliers[state.activity] - 1.2) * 22));
+      let cat = 'balanced';
+      if (ageDelta <= -5) cat = 'young';
+      if (ageDelta > 5) cat = 'aged';
+      ageOutput.textContent = String(state.age);
+      heightOutput.textContent = state.unit === 'imperial' ? `${cmToIn(state.heightCm).toFixed(1)} ${ui.in}` : `${Math.round(state.heightCm)} ${ui.cm}`;
+      weightOutput.textContent = formatMass(state.weightKg);
+      fatOutput.textContent = `${state.fat}${ui.percent}`;
+      metabolicAge.textContent = String(metabolic);
+      chronological.textContent = String(state.age);
+      bmrEl.textContent = `${Math.round(bmr).toLocaleString()} ${ui.kcalDay}`;
+      tdeeEl.textContent = `${Math.round(mifflin(state.weightKg, state.heightCm, state.age, state.sex) * activityMultipliers[state.activity]).toLocaleString()} ${ui.kcalDay}`;
+      idealBmrEl.textContent = `${Math.round(idealBmr).toLocaleString()} ${ui.kcalDay}`;
+      category.textContent = getCategoryLabel(cat, ui);
+      advice.textContent = getAdvice(cat, ui);
+      delta.textContent = getDeltaLabel(ageDelta, ui);
+      scoreBar.style.width = `${score}%`;
+      dial.style.setProperty('--needle', `${Math.max(-80, Math.min(80, (metabolic - 45) * 3))}deg`);
+      dial.style.setProperty('--chrono', `${Math.max(-80, Math.min(80, (state.age - 45) * 3))}deg`);
+      root.classList.toggle('mac--young', cat === 'young');
+      root.classList.toggle('mac--aged', cat === 'aged');
+    }
+
+    age.addEventListener('input', () => { state.age = Number(age.value); render(); });
+    fat.addEventListener('input', () => { state.fat = Number(fat.value); render(); });
+    height.addEventListener('input', () => { state.heightCm = state.unit === 'imperial' ? inToCm(Number(height.value)) : Number(height.value); render(); });
+    weight.addEventListener('input', () => { state.weightKg = state.unit === 'imperial' ? lbToKg(Number(weight.value)) : Number(weight.value); render(); });
+    root.querySelectorAll<HTMLButtonElement>('[data-unit]').forEach((button) => button.addEventListener('click', () => {
+      state.unit = button.dataset.unit as Unit;
+      root.querySelectorAll<HTMLButtonElement>('[data-unit]').forEach((item) => item.classList.toggle('mac__seg-btn--active', item === button));
+      syncUnitControls();
+      render();
+    }));
+    root.querySelectorAll<HTMLButtonElement>('[data-sex]').forEach((button) => button.addEventListener('click', () => {
+      state.sex = button.dataset.sex as Sex;
+      root.querySelectorAll<HTMLButtonElement>('[data-sex]').forEach((item) => item.classList.toggle('mac__icon-btn--active', item === button));
+      render();
+    }));
+    root.querySelectorAll<HTMLButtonElement>('[data-activity]').forEach((button) => button.addEventListener('click', () => {
+      state.activity = button.dataset.activity as Activity;
+      root.querySelectorAll<HTMLButtonElement>('[data-activity]').forEach((item) => item.classList.toggle('mac__activity-active', item === button));
+      render();
+    }));
+    syncUnitControls();
+    render();
+  }
+
+  document.querySelectorAll('.mac').forEach(initMAC);
+</script>

package/src/tool/metabolicAgeCalculator/entry.ts

@@ -0,0 +1,27 @@
+import type { HealthToolEntry } from '../../types';
+import type { MetabolicAgeCalculatorUI } from './ui';
+
+export const metabolicAgeCalculator: HealthToolEntry<MetabolicAgeCalculatorUI> = {
+  id: 'metabolicAgeCalculator',
+  icons: {
+    bg: 'mdi:speedometer',
+    fg: 'mdi:human-cane',
+  },
+  i18n: {
+    de: () => import('./i18n/de').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    es: () => import('./i18n/es').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
+  },
+};