@jjlmoya/utils-health 1.17.0 → 1.19.0

package/package.json

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

package/src/category/index.ts

@@ -11,10 +11,12 @@ import { binauralTuner } from '../tool/binauralTuner/entry';
 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, 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

@@ -14,6 +14,8 @@ export { screenDecompressionTime } from './tool/screenDecompressionTime';
 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';
 
@@ -25,4 +27,3 @@ export type {
   HealthToolEntry,
   HealthCategoryEntry,
 } from './types';
-

package/src/entries.ts

@@ -8,6 +8,8 @@ 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';
@@ -26,6 +28,8 @@ 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';
@@ -33,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, 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

@@ -35,8 +35,7 @@ describe('Locale Completeness Validation', () => {
     });
   });
 
-  it('all 17 tools registered', () => {
-    expect(ALL_TOOLS.length).toBe(17);
+  it('all 18 tools registered', () => {
+    expect(ALL_TOOLS.length).toBe(19);
   });
 });
-

package/src/tests/tool_validation.test.ts

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

package/src/tool/leanBodyMassCalculator/bibliography.astro

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

package/src/tool/leanBodyMassCalculator/bibliography.ts

@@ -0,0 +1,20 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Boer P.: Estimated lean body mass as an index for normalization of body fluid volumes in humans',
+    url: 'https://doi.org/10.1152/ajprenal.1984.247.4.F632',
+  },
+  {
+    name: 'Hume R.: Prediction of lean body mass from height and weight',
+    url: 'https://doi.org/10.1136/jcp.19.4.389',
+  },
+  {
+    name: 'NIH MedlinePlus: Body weight and body fat',
+    url: 'https://medlineplus.gov/ency/patientinstructions/000348.htm',
+  },
+  {
+    name: 'Wikipedia: Lean body mass',
+    url: 'https://en.wikipedia.org/wiki/Lean_body_mass',
+  },
+];

package/src/tool/leanBodyMassCalculator/component.astro

@@ -0,0 +1,240 @@
+---
+import { Icon } from 'astro-icon/components';
+import type { LeanBodyMassCalculatorUI } from './ui';
+
+interface Props {
+  locale?: string;
+  ui?: Record<string, unknown>;
+}
+
+const t = (Astro.props.ui || {}) as LeanBodyMassCalculatorUI;
+---
+
+<div class="lbm" data-ui={JSON.stringify(t)}>
+  <div class="lbm__shell">
+    <section class="lbm__stage" aria-live="polite">
+      <div class="lbm__figure-wrap">
+        <svg class="lbm__figure" viewBox="0 0 180 330" role="img" aria-label={t.silhouetteLean}>
+          <defs>
+            <clipPath id="lbm-body-clip">
+              <path d="M90 18c19 0 34 15 34 34s-15 34-34 34-34-15-34-34 15-34 34-34Zm-45 95c0-16 13-29 29-29h32c16 0 29 13 29 29v70c0 13-6 25-15 33l16 84c2 10-5 19-15 19h-10c-7 0-13-5-15-12l-7-54-7 54c-2 7-8 12-15 12H57c-10 0-17-9-15-19l16-84c-9-8-15-20-15-33v-70Z" />
+            </clipPath>
+          </defs>
+          <path class="lbm__figure-base" d="M90 18c19 0 34 15 34 34s-15 34-34 34-34-15-34-34 15-34 34-34Zm-45 95c0-16 13-29 29-29h32c16 0 29 13 29 29v70c0 13-6 25-15 33l16 84c2 10-5 19-15 19h-10c-7 0-13-5-15-12l-7-54-7 54c-2 7-8 12-15 12H57c-10 0-17-9-15-19l16-84c-9-8-15-20-15-33v-70Z" />
+          <g clip-path="url(#lbm-body-clip)">
+            <rect class="lbm__fat-fill" x="0" y="0" width="180" height="330" />
+            <rect id="lbm-lean-fill" class="lbm__lean-fill" x="0" y="330" width="180" height="0" />
+          </g>
+          <path class="lbm__figure-outline" d="M90 18c19 0 34 15 34 34s-15 34-34 34-34-15-34-34 15-34 34-34Zm-45 95c0-16 13-29 29-29h32c16 0 29 13 29 29v70c0 13-6 25-15 33l16 84c2 10-5 19-15 19h-10c-7 0-13-5-15-12l-7-54-7 54c-2 7-8 12-15 12H57c-10 0-17-9-15-19l16-84c-9-8-15-20-15-33v-70Z" />
+        </svg>
+        <div class="lbm__legend">
+          <span><i class="lbm__key lbm__key--lean"></i>{t.silhouetteLean}</span>
+          <span><i class="lbm__key lbm__key--fat"></i>{t.silhouetteFat}</span>
+        </div>
+      </div>
+
+      <div class="lbm__donut" style="
+
+--lean: 74">
+        <div class="lbm__ring" aria-hidden="true"></div>
+        <div class="lbm__ring-core">
+          <span>{t.leanShareLabel}</span>
+          <strong id="lbm-percent">74.0%</strong>
+        </div>
+      </div>
+
+      <div class="lbm__metrics">
+        <div>
+          <span>{t.leanMassLabel}</span>
+          <strong id="lbm-lean">55.5 kg</strong>
+        </div>
+        <div>
+          <span>{t.fatMassLabel}</span>
+          <strong id="lbm-fat">19.5 kg</strong>
+        </div>
+        <div>
+          <span>{t.totalWeightLabel}</span>
+          <strong id="lbm-total">75.0 kg</strong>
+        </div>
+      </div>
+    </section>
+
+    <section class="lbm__controls">
+      <div class="lbm__switches">
+        <div class="lbm__seg" role="group" aria-label={t.unitSystemLabel}>
+          <button class="lbm__seg-btn lbm__seg-btn--active" type="button" data-unit="metric">{t.unitMetric}</button>
+          <button class="lbm__seg-btn" type="button" data-unit="imperial">{t.unitImperial}</button>
+        </div>
+        <div class="lbm__seg" role="group" aria-label={t.sexLabel}>
+          <button class="lbm__icon-btn" type="button" data-sex="female" title={t.sexFemale}><Icon name="mdi:gender-female" /></button>
+          <button class="lbm__icon-btn lbm__icon-btn--active" type="button" data-sex="male" title={t.sexMale}><Icon name="mdi:gender-male" /></button>
+        </div>
+      </div>
+
+      <label class="lbm__field">
+        <span><b>{t.heightLabel}</b><output id="lbm-height-output">175 cm</output></span>
+        <input id="lbm-height-range" class="lbm__range" type="range" min="130" max="220" value="175" />
+        <input id="lbm-height-number" class="lbm__number" type="number" min="130" max="220" value="175" />
+      </label>
+
+      <label class="lbm__field">
+        <span><b>{t.weightLabel}</b><output id="lbm-weight-output">75 kg</output></span>
+        <input id="lbm-weight-range" class="lbm__range" type="range" min="35" max="180" value="75" />
+        <input id="lbm-weight-number" class="lbm__number" type="number" min="35" max="180" value="75" />
+      </label>
+
+      <div class="lbm__formula" role="group" aria-label={t.formulaLabel}>
+        <button class="lbm__formula-btn lbm__formula-btn--active" type="button" data-formula="boer">{t.formulaBoer}</button>
+        <button class="lbm__formula-btn" type="button" data-formula="james">{t.formulaJames}</button>
+        <button class="lbm__formula-btn" type="button" data-formula="hume">{t.formulaHume}</button>
+      </div>
+
+      <div class="lbm__equation">
+        <span><Icon name="mdi:function-variant" /> {t.equationLabel}</span>
+        <code id="lbm-equation">0.407W + 0.267H - 19.2</code>
+      </div>
+    </section>
+
+    <section class="lbm__notes">
+      <div><strong>{t.clinicalNoteTitle}</strong><p>{t.clinicalNoteText}</p></div>
+      <div><strong>{t.formulaNoteTitle}</strong><p>{t.formulaNoteText}</p></div>
+    </section>
+  </div>
+</div>
+
+<script>
+  type Unit = 'metric' | 'imperial';
+  type Sex = 'female' | 'male';
+  type Formula = 'boer' | 'james' | 'hume';
+
+  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 calculate(weightKg: number, heightCm: number, sex: Sex, formula: Formula): number {
+    if (formula === 'james') return sex === 'male' ? 1.1 * weightKg - 128 * (weightKg / heightCm) ** 2 : 1.07 * weightKg - 148 * (weightKg / heightCm) ** 2;
+    if (formula === 'hume') return sex === 'male' ? 0.3281 * weightKg + 0.33929 * heightCm - 29.5336 : 0.29569 * weightKg + 0.41813 * heightCm - 43.2933;
+    return sex === 'male' ? 0.407 * weightKg + 0.267 * heightCm - 19.2 : 0.252 * weightKg + 0.473 * heightCm - 48.3;
+  }
+
+  // eslint-disable-next-line max-lines-per-function
+  function initLBM(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, formula: 'boer' as Formula, heightCm: 175, weightKg: 75 };
+    const heightRange = requireEl<HTMLInputElement>(root, '#lbm-height-range');
+    const heightNumber = requireEl<HTMLInputElement>(root, '#lbm-height-number');
+    const weightRange = requireEl<HTMLInputElement>(root, '#lbm-weight-range');
+    const weightNumber = requireEl<HTMLInputElement>(root, '#lbm-weight-number');
+    const heightOutput = requireEl<HTMLOutputElement>(root, '#lbm-height-output');
+    const weightOutput = requireEl<HTMLOutputElement>(root, '#lbm-weight-output');
+    const lean = requireEl<HTMLElement>(root, '#lbm-lean');
+    const fat = requireEl<HTMLElement>(root, '#lbm-fat');
+    const total = requireEl<HTMLElement>(root, '#lbm-total');
+    const percent = requireEl<HTMLElement>(root, '#lbm-percent');
+    const donut = requireEl<HTMLElement>(root, '.lbm__donut');
+    const fill = requireEl<SVGRectElement>(root, '#lbm-lean-fill');
+    const equation = requireEl<HTMLElement>(root, '#lbm-equation');
+
+    const equations: Record<Formula, Record<Sex, string>> = {
+      boer: { male: '0.407W + 0.267H - 19.2', female: '0.252W + 0.473H - 48.3' },
+      james: { male: '1.1W - 128(W / H)^2', female: '1.07W - 148(W / H)^2' },
+      hume: { male: '0.32810W + 0.33929H - 29.5336', female: '0.29569W + 0.41813H - 43.2933' },
+    };
+
+    function mass(valueKg: number): string {
+      return state.unit === 'imperial' ? `${kgToLb(valueKg).toFixed(1)} ${ui.lb}` : `${valueKg.toFixed(1)} ${ui.kg}`;
+    }
+
+    function syncControls() {
+      if (state.unit === 'imperial') {
+        heightRange.min = heightNumber.min = '51';
+        heightRange.max = heightNumber.max = '87';
+        heightRange.step = heightNumber.step = '0.5';
+        weightRange.min = weightNumber.min = '77';
+        weightRange.max = weightNumber.max = '397';
+        weightRange.step = weightNumber.step = '1';
+        heightRange.value = heightNumber.value = cmToIn(state.heightCm).toFixed(1);
+        weightRange.value = weightNumber.value = Math.round(kgToLb(state.weightKg)).toString();
+      } else {
+        heightRange.min = heightNumber.min = '130';
+        heightRange.max = heightNumber.max = '220';
+        heightRange.step = heightNumber.step = '1';
+        weightRange.min = weightNumber.min = '35';
+        weightRange.max = weightNumber.max = '180';
+        weightRange.step = weightNumber.step = '1';
+        heightRange.value = heightNumber.value = Math.round(state.heightCm).toString();
+        weightRange.value = weightNumber.value = Math.round(state.weightKg).toString();
+      }
+    }
+
+    function render() {
+      const leanKg = Math.max(0, Math.min(state.weightKg, calculate(state.weightKg, state.heightCm, state.sex, state.formula)));
+      const fatKg = Math.max(0, state.weightKg - leanKg);
+      const share = state.weightKg > 0 ? (leanKg / state.weightKg) * 100 : 0;
+      heightOutput.textContent = state.unit === 'imperial' ? `${cmToIn(state.heightCm).toFixed(1)} ${ui.in}` : `${Math.round(state.heightCm)} ${ui.cm}`;
+      weightOutput.textContent = mass(state.weightKg);
+      lean.textContent = mass(leanKg);
+      fat.textContent = mass(fatKg);
+      total.textContent = mass(state.weightKg);
+      percent.textContent = `${share.toFixed(1)}%`;
+      donut.style.setProperty('--lean', share.toFixed(1));
+      const leanHeight = Math.max(0, Math.min(330, 330 * (share / 100)));
+      fill.setAttribute('y', String(330 - leanHeight));
+      fill.setAttribute('height', String(leanHeight));
+      equation.textContent = equations[state.formula][state.sex];
+    }
+
+    function readHeight(input: HTMLInputElement) {
+      state.heightCm = state.unit === 'imperial' ? inToCm(Number(input.value)) : Number(input.value);
+      syncControls();
+      render();
+    }
+
+    function readWeight(input: HTMLInputElement) {
+      state.weightKg = state.unit === 'imperial' ? lbToKg(Number(input.value)) : Number(input.value);
+      syncControls();
+      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('lbm__seg-btn--active', item === button));
+        syncControls();
+        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('lbm__icon-btn--active', item === button));
+        render();
+      });
+    });
+
+    root.querySelectorAll<HTMLButtonElement>('[data-formula]').forEach((button) => {
+      button.addEventListener('click', () => {
+        state.formula = button.dataset.formula as Formula;
+        root.querySelectorAll<HTMLButtonElement>('[data-formula]').forEach((item) => item.classList.toggle('lbm__formula-btn--active', item === button));
+        render();
+      });
+    });
+
+    heightRange.addEventListener('input', () => readHeight(heightRange));
+    heightNumber.addEventListener('input', () => readHeight(heightNumber));
+    weightRange.addEventListener('input', () => readWeight(weightRange));
+    weightNumber.addEventListener('input', () => readWeight(weightNumber));
+    syncControls();
+    render();
+  }
+
+  document.querySelectorAll('.lbm').forEach(initLBM);
+</script>

package/src/tool/leanBodyMassCalculator/entry.ts

@@ -0,0 +1,27 @@
+import type { HealthToolEntry } from '../../types';
+import type { LeanBodyMassCalculatorUI } from './ui';
+
+export const leanBodyMassCalculator: HealthToolEntry<LeanBodyMassCalculatorUI> = {
+  id: 'leanBodyMassCalculator',
+  icons: {
+    bg: 'mdi:human',
+    fg: 'mdi:scale-bathroom',
+  },
+  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),
+  },
+};