@jjlmoya/utils-health 1.27.0 → 1.28.0

package/package.json

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

package/src/category/index.ts

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

@@ -18,6 +18,7 @@ export { metabolicAgeCalculator } from './tool/metabolicAgeCalculator/entry';
 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 { targetHeightEstimator } from './tool/targetHeightEstimator/entry';
 export { correctedReticulocyteIndex } from './tool/correctedReticulocyteIndex/entry';
 export { pelliRobsonTest } from './tool/pelliRobsonTest/entry';
@@ -48,6 +49,7 @@ import { metabolicAgeCalculator } from './tool/metabolicAgeCalculator/entry';
 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 { targetHeightEstimator } from './tool/targetHeightEstimator/entry';
 import { correctedReticulocyteIndex } from './tool/correctedReticulocyteIndex/entry';
 import { pelliRobsonTest } from './tool/pelliRobsonTest/entry';
@@ -57,4 +59,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, bodyFatPercentageCalculator, waistHipRatioCalculator, waistHeightRatioCalculator, breathingVisualizer, caffeineTracker, caloricDeficitCalculator, dailyProteinCalculator, macronutrientCalculator, tdeeCalculator, bunCreatinineCalculator, correctedReticulocyteIndex, targetHeightEstimator, daltonismSimulator, digestionStopwatch, epworthSleepinessScale, hydrationCalculator, leanBodyMassCalculator, metabolicAgeCalculator, pelliRobsonTest, peripheralVisionTrainer, readingDistanceCalculator, screenDecompressionTime, tinnitusReliever, ubeCalculator, waterPurifier];
+export const ALL_ENTRIES = [binauralTuner, bloodUnitConverter, bmiCalculator, bodyAdiposityIndexCalculator, bodyFatPercentageCalculator, waistHipRatioCalculator, waistHeightRatioCalculator, breathingVisualizer, caffeineTracker, caloricDeficitCalculator, dailyProteinCalculator, macronutrientCalculator, tdeeCalculator, bunCreatinineCalculator, serumOsmolalityCalculator, correctedReticulocyteIndex, targetHeightEstimator, daltonismSimulator, digestionStopwatch, epworthSleepinessScale, hydrationCalculator, leanBodyMassCalculator, metabolicAgeCalculator, pelliRobsonTest, peripheralVisionTrainer, readingDistanceCalculator, screenDecompressionTime, tinnitusReliever, ubeCalculator, waterPurifier];

package/src/index.ts

@@ -25,6 +25,7 @@ export * from './tool/bodyFatPercentageCalculator';
 export * from './tool/macronutrientCalculator';
 export * from './tool/tdeeCalculator';
 export * from './tool/bunCreatinineCalculator';
+export * from './tool/serumOsmolalityCalculator';
 export * from './tool/targetHeightEstimator';
 export * from './tool/correctedReticulocyteIndex';
 

package/src/tests/locale_completeness.test.ts

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

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

package/src/tool/serumOsmolalityCalculator/bibliography.astro

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

package/src/tool/serumOsmolalityCalculator/bibliography.ts

@@ -0,0 +1,24 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Gennari FJ. Serum osmolality: uses and limitations. New England Journal of Medicine. 1984.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/6472391/',
+  },
+  {
+    name: 'Purssell RA, et al. Derivation and validation of a formula to calculate the osmolal gap. Annals of Emergency Medicine. 2001.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/11385324/',
+  },
+  {
+    name: 'MedlinePlus / NIH: Osmolality blood test',
+    url: 'https://medlineplus.gov/lab-tests/osmolality-tests/',
+  },
+  {
+    name: 'Wikipedia: Osmol gap',
+    url: 'https://en.wikipedia.org/wiki/Osmol_gap',
+  },
+  {
+    name: 'EXTRIP Workgroup: extracorporeal treatment recommendations for methanol and ethylene glycol poisoning',
+    url: 'https://www.extrip-workgroup.org/',
+  },
+];

package/src/tool/serumOsmolalityCalculator/component.astro

@@ -0,0 +1,269 @@
+---
+import './serum-osmolality-calculator.css';
+import type { SerumOsmolalityCalculatorUI } from './ui';
+
+interface Props {
+  locale?: string;
+  ui?: Record<string, unknown>;
+}
+
+const t = (Astro.props.ui || {}) as SerumOsmolalityCalculatorUI;
+---
+
+<div class="osm" data-ui={JSON.stringify(t)}>
+  <div class="osm__warning" role="alert" aria-label={t.educationWarningTitle}>
+    <div class="osm__warning-mark">{t.educationWarningMark}</div>
+    <div>
+      <strong>{t.educationWarningTitle}</strong>
+      <span>{t.educationWarningBody}</span>
+    </div>
+  </div>
+
+  <div class="osm__grid">
+    <section class="osm__panel osm__panel--results">
+      <div class="osm__hero">
+        <div class="osm__metric osm__metric--primary">
+          <span>{t.calculatedLabel}</span>
+          <strong id="osm-calculated">{t.emptyValue}</strong>
+          <small>{t.mosm}</small>
+        </div>
+        <div id="osm-gap-chip" class="osm__metric osm__gap-chip">
+          <span>{t.gapLabel}</span>
+          <strong id="osm-gap">{t.emptyValue}</strong>
+          <small id="osm-gap-state">{t.gapUnavailable}</small>
+        </div>
+      </div>
+
+      <div class="osm__bars" aria-label={t.gapLabel}>
+        <div class="osm__bar-row">
+          <span>{t.calculatedShort}</span>
+          <div class="osm__bar-track"><div id="osm-calc-bar" class="osm__bar osm__bar--calculated"></div></div>
+          <b id="osm-calc-bar-value">{t.emptyValue}</b>
+        </div>
+        <div class="osm__bar-row" id="osm-measured-row">
+          <span>{t.measuredShort}</span>
+          <div class="osm__bar-track">
+            <div id="osm-measured-bar" class="osm__bar osm__bar--measured"></div>
+            <div id="osm-gap-bar" class="osm__bar-gap"></div>
+          </div>
+          <b id="osm-measured-bar-value">{t.emptyValue}</b>
+        </div>
+      </div>
+
+      <div id="osm-alert" class="osm__alert" hidden>
+        <strong>{t.elevatedPanelTitle}</strong>
+        <p>{t.elevatedPanelBody}</p>
+        <span>{t.elevatedCauses}</span>
+      </div>
+    </section>
+
+    <section class="osm__panel osm__panel--inputs">
+      <label class="osm__field">
+        <span>{t.sodiumLabel}</span>
+        <div class="osm__input-shell">
+          <input id="osm-na" type="number" min="0" step="0.1" placeholder={t.sodiumPlaceholder} />
+          <small>{t.sodiumUnit}</small>
+        </div>
+      </label>
+
+      <label class="osm__field">
+        <span>{t.glucoseLabel}</span>
+        <div class="osm__input-shell osm__input-shell--toggle">
+          <input id="osm-glucose" type="number" min="0" step="0.1" placeholder={t.glucosePlaceholder} />
+          <div class="osm__toggle" role="group" aria-label={t.glucoseLabel}>
+            <button type="button" class="osm__toggle-btn osm__toggle-btn--active" data-glucose-unit="mg/dL">{t.glucoseMgdl}</button>
+            <button type="button" class="osm__toggle-btn" data-glucose-unit="mmol/L">{t.glucoseMmol}</button>
+          </div>
+        </div>
+        <small class="osm__converted" id="osm-glucose-converted"></small>
+      </label>
+
+      <label class="osm__field">
+        <span>{t.nitrogenLabel}</span>
+        <div class="osm__input-shell osm__input-shell--toggle">
+          <input id="osm-nitrogen" type="number" min="0" step="0.1" placeholder={t.nitrogenPlaceholder} />
+          <div class="osm__toggle" role="group" aria-label={t.nitrogenLabel}>
+            <button type="button" class="osm__toggle-btn osm__toggle-btn--active" data-nitrogen-unit="bun-mg/dL">{t.bunMgdl}</button>
+            <button type="button" class="osm__toggle-btn" data-nitrogen-unit="urea-mmol/L">{t.ureaMmol}</button>
+          </div>
+        </div>
+        <small class="osm__converted" id="osm-nitrogen-converted"></small>
+      </label>
+
+      <label class="osm__field">
+        <span>{t.measuredLabel}</span>
+        <div class="osm__input-shell">
+          <input id="osm-measured" type="number" min="0" step="0.1" placeholder={t.measuredPlaceholder} />
+          <small>{t.mosm}</small>
+        </div>
+        <small class="osm__hint">{t.measuredHint}</small>
+      </label>
+
+      <div class="osm__formula">
+        <span>{t.formulaLabel}</span>
+        <code id="osm-formula">{t.formulaConventional}</code>
+      </div>
+    </section>
+  </div>
+</div>
+
+<script>
+  type GlucoseUnit = 'mg/dL' | 'mmol/L';
+  type NitrogenUnit = 'bun-mg/dL' | 'urea-mmol/L';
+
+  interface OsmCtx {
+    root: Element;
+    ui: Record<string, string>;
+    sodium: HTMLInputElement;
+    glucose: HTMLInputElement;
+    nitrogen: HTMLInputElement;
+    measured: HTMLInputElement;
+    glucoseUnit: GlucoseUnit;
+    nitrogenUnit: NitrogenUnit;
+  }
+
+  interface OsmRenderState {
+    calculated: number;
+    measuredRaw: number;
+    gap: number | null;
+    elevated: boolean;
+    maxBar: number;
+  }
+
+  function osmQs<T extends HTMLElement | SVGElement>(root: Element, selector: string): T {
+    const el = root.querySelector<T>(selector);
+    if (!el) throw new Error(`Missing ${selector}`);
+    return el;
+  }
+
+  function glucoseToMmol(value: number, unit: GlucoseUnit): number {
+    return unit === 'mg/dL' ? value / 18 : value;
+  }
+
+  function nitrogenToUreaMmol(value: number, unit: NitrogenUnit): number {
+    return unit === 'bun-mg/dL' ? value / 2.8 : value;
+  }
+
+  function fmt(value: number): string {
+    return String(Math.round(value * 10) / 10);
+  }
+
+  function setWidth(el: HTMLElement, value: number, max: number) {
+    const pct = value > 0 ? Math.max(3, Math.min(100, (value / max) * 100)) : 0;
+    el.style.width = `${pct}%`;
+  }
+
+  function resetOsm(ctx: OsmCtx) {
+    osmQs<HTMLElement>(ctx.root, '#osm-calculated').textContent = ctx.ui.emptyValue;
+    osmQs<HTMLElement>(ctx.root, '#osm-calc-bar-value').textContent = ctx.ui.emptyValue;
+    osmQs<HTMLElement>(ctx.root, '#osm-gap').textContent = ctx.ui.emptyValue;
+    osmQs<HTMLElement>(ctx.root, '#osm-gap-state').textContent = ctx.ui.gapUnavailable;
+    osmQs<HTMLElement>(ctx.root, '#osm-measured-bar-value').textContent = ctx.ui.emptyValue;
+    osmQs<HTMLElement>(ctx.root, '#osm-alert').hidden = true;
+    osmQs<HTMLElement>(ctx.root, '#osm-gap-chip').className = 'osm__metric osm__gap-chip';
+    setWidth(osmQs<HTMLElement>(ctx.root, '#osm-calc-bar'), 0, 330);
+    setWidth(osmQs<HTMLElement>(ctx.root, '#osm-measured-bar'), 0, 330);
+    setWidth(osmQs<HTMLElement>(ctx.root, '#osm-gap-bar'), 0, 330);
+  }
+
+  function getGapState(ctx: OsmCtx, gap: number | null, elevated: boolean): string {
+    if (gap === null) return ctx.ui.gapUnavailable;
+    return elevated ? ctx.ui.elevatedGap : ctx.ui.normalGap;
+  }
+
+  function renderNumericResults(ctx: OsmCtx, state: OsmRenderState) {
+    const hasMeasured = state.measuredRaw > 0;
+    osmQs<HTMLElement>(ctx.root, '#osm-calculated').textContent = fmt(state.calculated);
+    osmQs<HTMLElement>(ctx.root, '#osm-calc-bar-value').textContent = fmt(state.calculated);
+    osmQs<HTMLElement>(ctx.root, '#osm-gap').textContent = state.gap === null ? ctx.ui.emptyValue : fmt(state.gap);
+    osmQs<HTMLElement>(ctx.root, '#osm-gap-state').textContent = getGapState(ctx, state.gap, state.elevated);
+    osmQs<HTMLElement>(ctx.root, '#osm-measured-bar-value').textContent = hasMeasured ? fmt(state.measuredRaw) : ctx.ui.emptyValue;
+    osmQs<HTMLElement>(ctx.root, '#osm-measured-row').classList.toggle('osm__bar-row--muted', !hasMeasured);
+    osmQs<HTMLElement>(ctx.root, '#osm-alert').hidden = !state.elevated;
+    osmQs<HTMLElement>(ctx.root, '#osm-gap-chip').className = state.elevated ? 'osm__metric osm__gap-chip osm__gap-chip--elevated' : 'osm__metric osm__gap-chip';
+  }
+
+  function renderBars(ctx: OsmCtx, state: OsmRenderState) {
+    const hasMeasured = state.measuredRaw > 0;
+    setWidth(osmQs<HTMLElement>(ctx.root, '#osm-calc-bar'), state.calculated, state.maxBar);
+    setWidth(osmQs<HTMLElement>(ctx.root, '#osm-measured-bar'), hasMeasured ? state.measuredRaw : 0, state.maxBar);
+    osmQs<HTMLElement>(ctx.root, '#osm-gap-bar').style.width = state.gap !== null && state.gap > 0 ? `${Math.min(100, (state.gap / state.maxBar) * 100)}%` : '0%';
+  }
+
+  function renderFormula(ctx: OsmCtx) {
+    const isSi = ctx.glucoseUnit === 'mmol/L' && ctx.nitrogenUnit === 'urea-mmol/L';
+    osmQs<HTMLElement>(ctx.root, '#osm-formula').textContent = isSi ? ctx.ui.formulaSi : ctx.ui.formulaConventional;
+  }
+
+  function renderConversions(ctx: OsmCtx, glucoseMmol: number, ureaMmol: number) {
+    osmQs<HTMLElement>(ctx.root, '#osm-glucose-converted').textContent =
+      ctx.glucoseUnit === 'mg/dL'
+        ? `${ctx.ui.convertedGlucose}: ${fmt(glucoseMmol)} ${ctx.ui.glucoseMmol}`
+        : `${ctx.ui.convertedGlucose}: ${fmt(glucoseMmol * 18)} ${ctx.ui.glucoseMgdl}`;
+    osmQs<HTMLElement>(ctx.root, '#osm-nitrogen-converted').textContent =
+      ctx.nitrogenUnit === 'bun-mg/dL'
+        ? `${ctx.ui.convertedNitrogen}: ${fmt(ureaMmol)} ${ctx.ui.ureaMmol}`
+        : `${ctx.ui.convertedNitrogen}: ${fmt(ureaMmol * 2.8)} ${ctx.ui.bunMgdl}`;
+  }
+
+  function renderOsm(ctx: OsmCtx) {
+    const sodium = parseFloat(ctx.sodium.value);
+    const glucoseRaw = parseFloat(ctx.glucose.value);
+    const nitrogenRaw = parseFloat(ctx.nitrogen.value);
+    const measuredRaw = parseFloat(ctx.measured.value);
+    const hasCore = sodium > 0 && glucoseRaw >= 0 && nitrogenRaw >= 0;
+
+    if (!hasCore) {
+      resetOsm(ctx);
+      return;
+    }
+
+    const glucoseMmol = glucoseToMmol(glucoseRaw, ctx.glucoseUnit);
+    const ureaMmol = nitrogenToUreaMmol(nitrogenRaw, ctx.nitrogenUnit);
+    const calculated = Math.round((2 * sodium + glucoseMmol + ureaMmol) * 10) / 10;
+    const hasMeasured = measuredRaw > 0;
+    const gap = hasMeasured ? Math.round((measuredRaw - calculated) * 10) / 10 : null;
+    const elevated = gap !== null && gap > 10;
+    const maxBar = Math.max(330, calculated, hasMeasured ? measuredRaw : 0);
+
+    const state = { calculated, measuredRaw, gap, elevated, maxBar };
+    renderNumericResults(ctx, state);
+    renderBars(ctx, state);
+    renderFormula(ctx);
+    renderConversions(ctx, glucoseMmol, ureaMmol);
+  }
+
+  function initOsm(root: Element) {
+    const ctx: OsmCtx = {
+      root,
+      ui: JSON.parse((root as HTMLElement).dataset.ui || '{}') as Record<string, string>,
+      sodium: osmQs<HTMLInputElement>(root, '#osm-na'),
+      glucose: osmQs<HTMLInputElement>(root, '#osm-glucose'),
+      nitrogen: osmQs<HTMLInputElement>(root, '#osm-nitrogen'),
+      measured: osmQs<HTMLInputElement>(root, '#osm-measured'),
+      glucoseUnit: 'mg/dL',
+      nitrogenUnit: 'bun-mg/dL',
+    };
+
+    root.querySelectorAll<HTMLButtonElement>('[data-glucose-unit]').forEach((btn) => {
+      btn.addEventListener('click', () => {
+        ctx.glucoseUnit = btn.dataset.glucoseUnit as GlucoseUnit;
+        root.querySelectorAll<HTMLButtonElement>('[data-glucose-unit]').forEach((item) => item.classList.toggle('osm__toggle-btn--active', item === btn));
+        renderOsm(ctx);
+      });
+    });
+
+    root.querySelectorAll<HTMLButtonElement>('[data-nitrogen-unit]').forEach((btn) => {
+      btn.addEventListener('click', () => {
+        ctx.nitrogenUnit = btn.dataset.nitrogenUnit as NitrogenUnit;
+        root.querySelectorAll<HTMLButtonElement>('[data-nitrogen-unit]').forEach((item) => item.classList.toggle('osm__toggle-btn--active', item === btn));
+        renderOsm(ctx);
+      });
+    });
+
+    [ctx.sodium, ctx.glucose, ctx.nitrogen, ctx.measured].forEach((input) => input.addEventListener('input', () => renderOsm(ctx)));
+    renderOsm(ctx);
+  }
+
+  document.querySelectorAll('.osm').forEach(initOsm);
+</script>

package/src/tool/serumOsmolalityCalculator/entry.ts

@@ -0,0 +1,27 @@
+import type { HealthToolEntry } from '../../types';
+import type { SerumOsmolalityCalculatorUI } from './ui';
+
+export const serumOsmolalityCalculator: HealthToolEntry<SerumOsmolalityCalculatorUI> = {
+  id: 'serumOsmolalityCalculator',
+  icons: {
+    bg: 'mdi:flask-outline',
+    fg: 'mdi:chart-bar-stacked',
+  },
+  i18n: {
+    en: () => import('./i18n/en').then((m) => m.content),
+    de: () => import('./i18n/de').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),
+  },
+};