@jjlmoya/utils-health 1.32.0 → 1.33.0

package/package.json

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

package/src/category/index.ts

@@ -24,6 +24,7 @@ import { leanBodyMassCalculator } from '../tool/leanBodyMassCalculator/entry';
 import { metabolicAgeCalculator } from '../tool/metabolicAgeCalculator/entry';
 import { bunCreatinineCalculator } from '../tool/bunCreatinineCalculator/entry';
 import { serumOsmolalityCalculator } from '../tool/serumOsmolalityCalculator/entry';
+import { meanArterialPressureCalculator } from '../tool/meanArterialPressureCalculator/entry';
 import { correctedSodiumHyperglycemiaCalculator } from '../tool/correctedSodiumHyperglycemiaCalculator/entry';
 import { fractionalExcretionSodiumCalculator } from '../tool/fractionalExcretionSodiumCalculator/entry';
 import { targetHeightEstimator } from '../tool/targetHeightEstimator/entry';
@@ -31,7 +32,7 @@ import { correctedReticulocyteIndex } from '../tool/correctedReticulocyteIndex/e
 
 export const healthCategory: HealthCategoryEntry = {
   icon: 'mdi:heart-pulse',
-  tools: [bmiCalculator, amputationAdjustedBmiCalculator, bodyAdiposityIndexCalculator, bodyFatPercentageCalculator, waistHipRatioCalculator, waistHeightRatioCalculator, leanBodyMassCalculator, metabolicAgeCalculator, caloricDeficitCalculator, dailyProteinCalculator, macronutrientCalculator, tdeeCalculator, bunCreatinineCalculator, serumOsmolalityCalculator, correctedSodiumHyperglycemiaCalculator, fractionalExcretionSodiumCalculator, correctedReticulocyteIndex, targetHeightEstimator, daltonismSimulator, tinnitusReliever, parametricNoiseSynthesizer, breathingVisualizer, caffeineTracker, waterPurifier, digestionStopwatch, binauralTuner, pelliRobsonTest, peripheralVisionTrainer, epworthSleepinessScale],
+  tools: [bmiCalculator, amputationAdjustedBmiCalculator, bodyAdiposityIndexCalculator, bodyFatPercentageCalculator, waistHipRatioCalculator, waistHeightRatioCalculator, leanBodyMassCalculator, metabolicAgeCalculator, caloricDeficitCalculator, dailyProteinCalculator, macronutrientCalculator, tdeeCalculator, bunCreatinineCalculator, serumOsmolalityCalculator, meanArterialPressureCalculator, correctedSodiumHyperglycemiaCalculator, fractionalExcretionSodiumCalculator, correctedReticulocyteIndex, targetHeightEstimator, daltonismSimulator, tinnitusReliever, parametricNoiseSynthesizer, 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/entries.ts

@@ -20,6 +20,7 @@ export { macronutrientCalculator } from './tool/macronutrientCalculator/entry';
 export { tdeeCalculator } from './tool/tdeeCalculator/entry';
 export { bunCreatinineCalculator } from './tool/bunCreatinineCalculator/entry';
 export { serumOsmolalityCalculator } from './tool/serumOsmolalityCalculator/entry';
+export { meanArterialPressureCalculator } from './tool/meanArterialPressureCalculator/entry';
 export { correctedSodiumHyperglycemiaCalculator } from './tool/correctedSodiumHyperglycemiaCalculator/entry';
 export { fractionalExcretionSodiumCalculator } from './tool/fractionalExcretionSodiumCalculator/entry';
 export { targetHeightEstimator } from './tool/targetHeightEstimator/entry';
@@ -55,6 +56,7 @@ import { macronutrientCalculator } from './tool/macronutrientCalculator/entry';
 import { tdeeCalculator } from './tool/tdeeCalculator/entry';
 import { bunCreatinineCalculator } from './tool/bunCreatinineCalculator/entry';
 import { serumOsmolalityCalculator } from './tool/serumOsmolalityCalculator/entry';
+import { meanArterialPressureCalculator } from './tool/meanArterialPressureCalculator/entry';
 import { correctedSodiumHyperglycemiaCalculator } from './tool/correctedSodiumHyperglycemiaCalculator/entry';
 import { fractionalExcretionSodiumCalculator } from './tool/fractionalExcretionSodiumCalculator/entry';
 import { targetHeightEstimator } from './tool/targetHeightEstimator/entry';
@@ -67,4 +69,4 @@ import { tinnitusReliever } from './tool/tinnitusReliever/entry';
 import { parametricNoiseSynthesizer } from './tool/parametricNoiseSynthesizer/entry';
 import { ubeCalculator } from './tool/ubeCalculator/entry';
 import { waterPurifier } from './tool/waterPurifier/entry';
-export const ALL_ENTRIES = [binauralTuner, bloodUnitConverter, bmiCalculator, amputationAdjustedBmiCalculator, bodyAdiposityIndexCalculator, bodyFatPercentageCalculator, waistHipRatioCalculator, waistHeightRatioCalculator, breathingVisualizer, caffeineTracker, caloricDeficitCalculator, dailyProteinCalculator, macronutrientCalculator, tdeeCalculator, bunCreatinineCalculator, serumOsmolalityCalculator, correctedSodiumHyperglycemiaCalculator, fractionalExcretionSodiumCalculator, correctedReticulocyteIndex, targetHeightEstimator, daltonismSimulator, digestionStopwatch, epworthSleepinessScale, hydrationCalculator, leanBodyMassCalculator, metabolicAgeCalculator, pelliRobsonTest, peripheralVisionTrainer, readingDistanceCalculator, screenDecompressionTime, tinnitusReliever, parametricNoiseSynthesizer, ubeCalculator, waterPurifier];
+export const ALL_ENTRIES = [binauralTuner, bloodUnitConverter, bmiCalculator, amputationAdjustedBmiCalculator, bodyAdiposityIndexCalculator, bodyFatPercentageCalculator, waistHipRatioCalculator, waistHeightRatioCalculator, breathingVisualizer, caffeineTracker, caloricDeficitCalculator, dailyProteinCalculator, macronutrientCalculator, tdeeCalculator, bunCreatinineCalculator, serumOsmolalityCalculator, meanArterialPressureCalculator, correctedSodiumHyperglycemiaCalculator, fractionalExcretionSodiumCalculator, correctedReticulocyteIndex, targetHeightEstimator, daltonismSimulator, digestionStopwatch, epworthSleepinessScale, hydrationCalculator, leanBodyMassCalculator, metabolicAgeCalculator, pelliRobsonTest, peripheralVisionTrainer, readingDistanceCalculator, screenDecompressionTime, tinnitusReliever, parametricNoiseSynthesizer, ubeCalculator, waterPurifier];

package/src/index.ts

@@ -28,6 +28,7 @@ export * from './tool/macronutrientCalculator';
 export * from './tool/tdeeCalculator';
 export * from './tool/bunCreatinineCalculator';
 export * from './tool/serumOsmolalityCalculator';
+export * from './tool/meanArterialPressureCalculator';
 export * from './tool/correctedSodiumHyperglycemiaCalculator';
 export * from './tool/fractionalExcretionSodiumCalculator';
 export * from './tool/targetHeightEstimator';

package/src/tests/locale_completeness.test.ts

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

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 33 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(34);
+      expect(ALL_TOOLS.length).toBe(35);
     });
 
     it('healthCategory should be defined', () => {

package/src/tool/meanArterialPressureCalculator/bibliography.astro

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

package/src/tool/meanArterialPressureCalculator/bibliography.ts

@@ -0,0 +1,24 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'DeMers D, Wachs D. Physiology, Mean Arterial Pressure. StatPearls Publishing. 2020.',
+    url: 'https://www.ncbi.nlm.nih.gov/books/NBK538226/',
+  },
+  {
+    name: 'Moran D, et al. Calculation of mean arterial pressure. Journal of Clinical Monitoring. 1995.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/8530791/',
+  },
+  {
+    name: 'Magder S. The meaning of blood pressure. Critical Care. 2018.',
+    url: 'https://ccforum.biomedcentral.com/articles/10.1186/s13054-018-2171-1',
+  },
+  {
+    name: 'Surviving Sepsis Campaign: international guidelines for management of sepsis and septic shock 2021.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/34599691/',
+  },
+  {
+    name: 'Wikipedia: Mean arterial pressure',
+    url: 'https://en.wikipedia.org/wiki/Mean_arterial_pressure',
+  },
+];

package/src/tool/meanArterialPressureCalculator/component.astro

@@ -0,0 +1,224 @@
+---
+import './mean-arterial-pressure-calculator.css';
+import type { MeanArterialPressureCalculatorUI } from './ui';
+
+interface Props {
+  locale?: string;
+  ui?: Record<string, unknown>;
+}
+
+const t = (Astro.props.ui || {}) as MeanArterialPressureCalculatorUI;
+---
+
+<div class="mapcalc" data-ui={JSON.stringify(t)} data-band="optimal">
+  <div class="mapcalc__safety" role="alert">
+    <strong>{t.educationWarningTitle}</strong>
+    <span>{t.educationWarningBody}</span>
+  </div>
+
+  <div class="mapcalc__grid">
+    <section class="mapcalc__dial-panel" aria-label={t.mapLabel}>
+      <div class="mapcalc__dial" aria-hidden="true">
+        <div class="mapcalc__dial-face"></div>
+        <div class="mapcalc__ticks">
+          <span class="mapcalc__tick mapcalc__tick--40">40</span>
+          <span class="mapcalc__tick mapcalc__tick--60">60</span>
+          <span class="mapcalc__tick mapcalc__tick--80">80</span>
+          <span class="mapcalc__tick mapcalc__tick--100">100</span>
+          <span class="mapcalc__tick mapcalc__tick--120">120</span>
+          <span class="mapcalc__tick mapcalc__tick--140">140</span>
+        </div>
+        <div class="mapcalc__dial-unit">{t.mmhg}</div>
+        <div id="map-needle" class="mapcalc__needle"></div>
+        <div class="mapcalc__hub"></div>
+      </div>
+
+      <div class="mapcalc__readout">
+        <span>{t.mapLabel}</span>
+        <strong id="map-value">{t.emptyValue}</strong>
+        <small>{t.mmhg}</small>
+      </div>
+
+      <div id="map-status" class="mapcalc__status">
+        <strong>{t.optimalTitle}</strong>
+        <span>{t.optimalBody}</span>
+      </div>
+
+      <div class="mapcalc__ranges" aria-label={t.mapLabel}>
+        <span class="mapcalc__range mapcalc__range--red">{t.rangeInadequate}</span>
+        <span class="mapcalc__range mapcalc__range--yellow">{t.rangeWarning}</span>
+        <span class="mapcalc__range mapcalc__range--green">{t.rangeOptimal}</span>
+        <span class="mapcalc__range mapcalc__range--orange">{t.rangeElevated}</span>
+      </div>
+    </section>
+
+    <section class="mapcalc__controls">
+      <label class="mapcalc__control">
+        <span><b>{t.systolicLabel}</b><small>{t.sbpShort}</small></span>
+        <input id="map-sbp-range" type="range" min="70" max="240" step="1" value="120" />
+        <div class="mapcalc__number">
+          <input id="map-sbp" type="number" min="70" max="240" step="1" value="120" />
+          <small>{t.mmhg}</small>
+        </div>
+      </label>
+
+      <label class="mapcalc__control">
+        <span><b>{t.diastolicLabel}</b><small>{t.dbpShort}</small></span>
+        <input id="map-dbp-range" type="range" min="30" max="160" step="1" value="80" />
+        <div class="mapcalc__number">
+          <input id="map-dbp" type="number" min="30" max="160" step="1" value="80" />
+          <small>{t.mmhg}</small>
+        </div>
+      </label>
+
+      <label class="mapcalc__control mapcalc__control--hr">
+        <span><b>{t.heartRateLabel}</b><small>{t.heartRateOptional}</small></span>
+        <input id="map-hr-range" type="range" min="30" max="180" step="1" value="75" />
+        <div class="mapcalc__number">
+          <input id="map-hr" type="number" min="30" max="180" step="1" value="75" />
+          <small>{t.bpm}</small>
+        </div>
+      </label>
+
+      <label class="mapcalc__switch">
+        <input id="map-use-hr" type="checkbox" />
+        <span>{t.heartRateToggle}</span>
+      </label>
+
+      <div class="mapcalc__metrics">
+        <div>
+          <span>{t.standardMapLabel}</span>
+          <strong id="map-standard">{t.emptyValue}</strong>
+        </div>
+        <div>
+          <span>{t.correctedMapLabel}</span>
+          <strong id="map-corrected">{t.emptyValue}</strong>
+        </div>
+        <div>
+          <span>{t.pulsePressureLabel}</span>
+          <strong id="map-pulse">{t.emptyValue}</strong>
+        </div>
+      </div>
+
+      <div class="mapcalc__formula">
+        <span id="map-mode">{t.activeStandard}</span>
+        <code id="map-formula">{t.standardFormula}</code>
+      </div>
+    </section>
+  </div>
+</div>
+
+<script>
+  type Band = 'inadequate' | 'warning' | 'optimal' | 'elevated';
+
+  interface MapCtx {
+    root: HTMLElement;
+    ui: Record<string, string>;
+    sbp: HTMLInputElement;
+    dbp: HTMLInputElement;
+    hr: HTMLInputElement;
+    sbpRange: HTMLInputElement;
+    dbpRange: HTMLInputElement;
+    hrRange: HTMLInputElement;
+    useHr: HTMLInputElement;
+  }
+
+  function mapQs<T extends HTMLElement>(root: Element, selector: string): T {
+    const el = root.querySelector<T>(selector);
+    if (!el) throw new Error(`Missing ${selector}`);
+    return el;
+  }
+
+  function fmt(value: number): string {
+    return String(Math.round(value * 10) / 10);
+  }
+
+  function clamp(value: number, min: number, max: number): number {
+    return Math.min(max, Math.max(min, value));
+  }
+
+  function bandFor(map: number): Band {
+    if (map < 60) return 'inadequate';
+    if (map < 70) return 'warning';
+    if (map <= 100) return 'optimal';
+    return 'elevated';
+  }
+
+  function statusFor(ctx: MapCtx, band: Band): [string, string] {
+    if (band === 'inadequate') return [ctx.ui.inadequateTitle, ctx.ui.inadequateBody];
+    if (band === 'warning') return [ctx.ui.warningTitle, ctx.ui.warningBody];
+    if (band === 'elevated') return [ctx.ui.elevatedTitle, ctx.ui.elevatedBody];
+    return [ctx.ui.optimalTitle, ctx.ui.optimalBody];
+  }
+
+  function readMapInputs(ctx: MapCtx) {
+    const sbp = clamp(parseFloat(ctx.sbp.value) || 0, 70, 240);
+    let dbp = clamp(parseFloat(ctx.dbp.value) || 0, 30, 160);
+    const hr = clamp(parseFloat(ctx.hr.value) || 75, 30, 180);
+    if (dbp >= sbp) dbp = Math.max(30, sbp - 1);
+
+    ctx.sbp.value = String(Math.round(sbp));
+    ctx.dbp.value = String(Math.round(dbp));
+    ctx.hr.value = String(Math.round(hr));
+    ctx.sbpRange.value = ctx.sbp.value;
+    ctx.dbpRange.value = ctx.dbp.value;
+    ctx.hrRange.value = ctx.hr.value;
+
+    return { sbp, dbp, hr };
+  }
+
+  function renderMap(ctx: MapCtx) {
+    const { sbp, dbp, hr } = readMapInputs(ctx);
+
+    const pulsePressure = sbp - dbp;
+    const standard = (sbp + 2 * dbp) / 3;
+    const corrected = dbp + (0.33 + 0.0012 * hr) * pulsePressure;
+    const displayed = ctx.useHr.checked ? corrected : standard;
+    const band = bandFor(displayed);
+    const angle = -122 + (clamp(displayed, 40, 140) - 40) * 2.44;
+    const [title, body] = statusFor(ctx, band);
+
+    ctx.root.dataset.band = band;
+    mapQs<HTMLElement>(ctx.root, '#map-needle').style.setProperty('--angle', `${angle}deg`);
+    mapQs<HTMLElement>(ctx.root, '#map-value').textContent = fmt(displayed);
+    mapQs<HTMLElement>(ctx.root, '#map-standard').textContent = fmt(standard);
+    mapQs<HTMLElement>(ctx.root, '#map-corrected').textContent = ctx.useHr.checked ? fmt(corrected) : ctx.ui.emptyValue;
+    mapQs<HTMLElement>(ctx.root, '#map-pulse').textContent = fmt(pulsePressure);
+    mapQs<HTMLElement>(ctx.root, '#map-mode').textContent = ctx.useHr.checked ? ctx.ui.activeCorrected : ctx.ui.activeStandard;
+    mapQs<HTMLElement>(ctx.root, '#map-formula').textContent = ctx.useHr.checked ? ctx.ui.correctedFormula : ctx.ui.standardFormula;
+
+    const status = mapQs<HTMLElement>(ctx.root, '#map-status');
+    mapQs<HTMLElement>(status, 'strong').textContent = title;
+    mapQs<HTMLElement>(status, 'span').textContent = body;
+  }
+
+  function bindPair(ctx: MapCtx, numberInput: HTMLInputElement, rangeInput: HTMLInputElement) {
+    numberInput.addEventListener('input', () => renderMap(ctx));
+    rangeInput.addEventListener('input', () => {
+      numberInput.value = rangeInput.value;
+      renderMap(ctx);
+    });
+  }
+
+  function initMapCalculator(root: Element) {
+    const ctx: MapCtx = {
+      root: root as HTMLElement,
+      ui: JSON.parse((root as HTMLElement).dataset.ui || '{}') as Record<string, string>,
+      sbp: mapQs<HTMLInputElement>(root, '#map-sbp'),
+      dbp: mapQs<HTMLInputElement>(root, '#map-dbp'),
+      hr: mapQs<HTMLInputElement>(root, '#map-hr'),
+      sbpRange: mapQs<HTMLInputElement>(root, '#map-sbp-range'),
+      dbpRange: mapQs<HTMLInputElement>(root, '#map-dbp-range'),
+      hrRange: mapQs<HTMLInputElement>(root, '#map-hr-range'),
+      useHr: mapQs<HTMLInputElement>(root, '#map-use-hr'),
+    };
+
+    bindPair(ctx, ctx.sbp, ctx.sbpRange);
+    bindPair(ctx, ctx.dbp, ctx.dbpRange);
+    bindPair(ctx, ctx.hr, ctx.hrRange);
+    ctx.useHr.addEventListener('change', () => renderMap(ctx));
+    renderMap(ctx);
+  }
+
+  document.querySelectorAll('.mapcalc').forEach(initMapCalculator);
+</script>

package/src/tool/meanArterialPressureCalculator/entry.ts

@@ -0,0 +1,27 @@
+import type { HealthToolEntry } from '../../types';
+import type { MeanArterialPressureCalculatorUI } from './ui';
+
+export const meanArterialPressureCalculator: HealthToolEntry<MeanArterialPressureCalculatorUI> = {
+  id: 'meanArterialPressureCalculator',
+  icons: {
+    bg: 'mdi:gauge',
+    fg: 'mdi:heart-pulse',
+  },
+  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),
+  },
+};