@jjlmoya/utils-health 1.30.0 → 1.31.0

package/package.json

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

package/src/category/index.ts

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

@@ -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 { correctedSodiumHyperglycemiaCalculator } from './tool/correctedSodiumHyperglycemiaCalculator/entry';
 export { fractionalExcretionSodiumCalculator } from './tool/fractionalExcretionSodiumCalculator/entry';
 export { targetHeightEstimator } from './tool/targetHeightEstimator/entry';
 export { correctedReticulocyteIndex } from './tool/correctedReticulocyteIndex/entry';
@@ -53,6 +54,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 { correctedSodiumHyperglycemiaCalculator } from './tool/correctedSodiumHyperglycemiaCalculator/entry';
 import { fractionalExcretionSodiumCalculator } from './tool/fractionalExcretionSodiumCalculator/entry';
 import { targetHeightEstimator } from './tool/targetHeightEstimator/entry';
 import { correctedReticulocyteIndex } from './tool/correctedReticulocyteIndex/entry';
@@ -63,4 +65,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, amputationAdjustedBmiCalculator, bodyAdiposityIndexCalculator, bodyFatPercentageCalculator, waistHipRatioCalculator, waistHeightRatioCalculator, breathingVisualizer, caffeineTracker, caloricDeficitCalculator, dailyProteinCalculator, macronutrientCalculator, tdeeCalculator, bunCreatinineCalculator, serumOsmolalityCalculator, fractionalExcretionSodiumCalculator, correctedReticulocyteIndex, targetHeightEstimator, daltonismSimulator, digestionStopwatch, epworthSleepinessScale, hydrationCalculator, leanBodyMassCalculator, metabolicAgeCalculator, pelliRobsonTest, peripheralVisionTrainer, readingDistanceCalculator, screenDecompressionTime, tinnitusReliever, ubeCalculator, waterPurifier];
+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, ubeCalculator, waterPurifier];

package/src/index.ts

@@ -27,6 +27,7 @@ export * from './tool/macronutrientCalculator';
 export * from './tool/tdeeCalculator';
 export * from './tool/bunCreatinineCalculator';
 export * from './tool/serumOsmolalityCalculator';
+export * from './tool/correctedSodiumHyperglycemiaCalculator';
 export * from './tool/fractionalExcretionSodiumCalculator';
 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(32);
+    expect(ALL_TOOLS.length).toBe(33);
   });
 });

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

package/src/tool/correctedSodiumHyperglycemiaCalculator/bibliography.astro

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

package/src/tool/correctedSodiumHyperglycemiaCalculator/bibliography.ts

@@ -0,0 +1,24 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Katz MA. Hyperglycemia-induced hyponatremia: calculation of expected serum sodium depression. New England Journal of Medicine. 1973.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/4700474/',
+  },
+  {
+    name: 'Hillier TA, Abbott RD, Barrett EJ. Hyponatremia: evaluating the correction factor for hyperglycemia. American Journal of Medicine. 1999.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/10225241/',
+  },
+  {
+    name: 'Joint British Diabetes Societies guideline: management of diabetic ketoacidosis in adults',
+    url: 'https://abcd.care/resource/jbds-02-management-diabetic-ketoacidosis-adults',
+  },
+  {
+    name: 'American Diabetes Association. Hyperglycemic crises in adult patients with diabetes.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/19564476/',
+  },
+  {
+    name: 'Merck Manual Professional: Hyponatremia',
+    url: 'https://www.merckmanuals.com/professional/endocrine-and-metabolic-disorders/electrolyte-disorders/hyponatremia',
+  },
+];

package/src/tool/correctedSodiumHyperglycemiaCalculator/component.astro

@@ -0,0 +1,229 @@
+---
+import './corrected-sodium-hyperglycemia-calculator.css';
+import type { CorrectedSodiumHyperglycemiaCalculatorUI } from './ui';
+
+interface Props {
+  locale?: string;
+  ui?: Record<string, unknown>;
+}
+
+const t = (Astro.props.ui || {}) as CorrectedSodiumHyperglycemiaCalculatorUI;
+---
+
+<div class="csh" data-ui={JSON.stringify(t)}>
+  <div class="csh__warning" role="alert" aria-label={t.safetyTitle}>
+    <div class="csh__warning-mark">{t.safetyMark}</div>
+    <div>
+      <strong>{t.safetyTitle}</strong>
+      <span>{t.safetyBody}</span>
+    </div>
+  </div>
+
+  <div class="csh__layout">
+    <section class="csh__rule" aria-label={t.glucoseAxisLabel}>
+      <div class="csh__glucose-rail">
+        <span>{t.glucoseTickLow}</span>
+        <span>{t.glucoseTickMid}</span>
+        <span>{t.glucoseTickHigh}</span>
+        <div id="csh-glucose-fill" class="csh__glucose-fill"></div>
+        <div id="csh-glucose-dot" class="csh__glucose-dot"></div>
+      </div>
+      <div class="csh__sodium-stage" aria-label={t.sodiumAxisLabel}>
+        <div class="csh__sodium-band csh__sodium-band--low"></div>
+        <div class="csh__sodium-band csh__sodium-band--normal"></div>
+        <div class="csh__sodium-band csh__sodium-band--high"></div>
+        <div id="csh-measured-pin" class="csh__pin csh__pin--measured">
+          <b>{t.measuredMarker}</b>
+          <span id="csh-measured-pin-value">{t.emptyValue}</span>
+        </div>
+        <div id="csh-corrected-pin" class="csh__pin csh__pin--corrected">
+          <b>{t.correctedMarker}</b>
+          <span id="csh-corrected-pin-value">{t.emptyValue}</span>
+        </div>
+      </div>
+    </section>
+
+    <section class="csh__panel">
+      <div class="csh__inputs">
+        <label class="csh__field">
+          <span>{t.sodiumLabel}</span>
+          <div class="csh__input-shell">
+            <input id="csh-sodium" type="number" min="80" max="190" step="0.1" placeholder={t.sodiumPlaceholder} />
+            <small>{t.sodiumUnit}</small>
+          </div>
+        </label>
+
+        <label class="csh__field">
+          <span>{t.glucoseLabel}</span>
+          <div class="csh__input-shell csh__input-shell--toggle">
+            <input id="csh-glucose" type="number" min="0" step="0.1" placeholder={t.glucosePlaceholder} />
+            <div class="csh__toggle" role="group" aria-label={t.glucoseLabel}>
+              <button type="button" class="csh__toggle-btn csh__toggle-btn--active" data-glucose-unit="mg/dL">{t.glucoseMgdl}</button>
+              <button type="button" class="csh__toggle-btn" data-glucose-unit="mmol/L">{t.glucoseMmol}</button>
+            </div>
+          </div>
+          <small id="csh-converted" class="csh__converted"></small>
+        </label>
+      </div>
+
+      <div class="csh__factor" role="group" aria-label={t.factorLabel}>
+        <button type="button" class="csh__factor-btn csh__factor-btn--active" data-mode="katz">
+          <strong>{t.katzLabel}</strong>
+          <span>{t.katzHint}</span>
+        </button>
+        <button type="button" class="csh__factor-btn" data-mode="hillier">
+          <strong>{t.hillierLabel}</strong>
+          <span>{t.hillierHint}</span>
+        </button>
+      </div>
+
+      <div class="csh__results">
+        <div class="csh__result csh__result--main">
+          <span>{t.correctedLabel}</span>
+          <strong id="csh-corrected">{t.emptyValue}</strong>
+          <small>{t.sodiumUnit}</small>
+        </div>
+        <div class="csh__result">
+          <span>{t.correctionLabel}</span>
+          <strong id="csh-correction">{t.emptyValue}</strong>
+          <small>{t.sodiumUnit}</small>
+        </div>
+        <div class="csh__result">
+          <span>{t.factorUsedLabel}</span>
+          <strong id="csh-factor">{t.emptyValue}</strong>
+          <small>{t.factorUnitLabel}</small>
+        </div>
+      </div>
+
+      <div class="csh__formula">
+        <span>{t.formulaLabel}</span>
+        <code id="csh-formula">{t.formulaKatz}</code>
+      </div>
+
+      <div id="csh-interpretation" class="csh__interpretation">
+        <strong>{t.interpretationNormal}</strong>
+        <span>{t.interpretationBody}</span>
+      </div>
+    </section>
+  </div>
+</div>
+
+<script>
+  type GlucoseUnit = 'mg/dL' | 'mmol/L';
+  type Mode = 'katz' | 'hillier';
+
+  interface Ctx {
+    root: Element;
+    ui: Record<string, string>;
+    sodium: HTMLInputElement;
+    glucose: HTMLInputElement;
+    glucoseUnit: GlucoseUnit;
+    mode: Mode;
+  }
+
+  function qs<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 glucoseToMgdl(value: number, unit: GlucoseUnit): number {
+    return unit === 'mmol/L' ? value * 18.0182 : value;
+  }
+
+  function factorFor(glucoseMgdl: number, mode: Mode): 1.6 | 2.4 {
+    return mode === 'hillier' && glucoseMgdl > 400 ? 2.4 : 1.6;
+  }
+
+  function sodiumPosition(value: number): number {
+    return Math.max(12, Math.min(88, ((value - 115) / 45) * 100));
+  }
+
+  function glucosePosition(value: number): number {
+    return Math.max(0, Math.min(100, ((value - 60) / 740) * 100));
+  }
+
+  function getCorrectedLabel(ctx: Ctx, corrected: number): string {
+    if (corrected < 135) return ctx.ui.interpretationLow;
+    if (corrected > 145) return ctx.ui.interpretationHigh;
+    return ctx.ui.interpretationNormal;
+  }
+
+  function reset(ctx: Ctx) {
+    ['#csh-corrected', '#csh-correction', '#csh-factor', '#csh-measured-pin-value', '#csh-corrected-pin-value'].forEach((selector) => {
+      qs<HTMLElement>(ctx.root, selector).textContent = ctx.ui.emptyValue;
+    });
+    qs<HTMLElement>(ctx.root, '#csh-glucose-fill').style.height = '0%';
+    qs<HTMLElement>(ctx.root, '#csh-glucose-dot').style.bottom = '0%';
+    qs<HTMLElement>(ctx.root, '#csh-measured-pin').style.left = '12%';
+    qs<HTMLElement>(ctx.root, '#csh-corrected-pin').style.left = '12%';
+  }
+
+  function render(ctx: Ctx) {
+    const sodium = parseFloat(ctx.sodium.value);
+    const glucoseRaw = parseFloat(ctx.glucose.value);
+    if (!(sodium > 0) || !(glucoseRaw >= 0)) {
+      reset(ctx);
+      return;
+    }
+
+    const glucoseMgdl = glucoseToMgdl(glucoseRaw, ctx.glucoseUnit);
+    const factor = factorFor(glucoseMgdl, ctx.mode);
+    const correction = (factor / 100) * (glucoseMgdl - 100);
+    const corrected = sodium + correction;
+    const correctedLabel = getCorrectedLabel(ctx, corrected);
+
+    qs<HTMLElement>(ctx.root, '#csh-corrected').textContent = fmt(corrected);
+    qs<HTMLElement>(ctx.root, '#csh-correction').textContent = fmt(correction);
+    qs<HTMLElement>(ctx.root, '#csh-factor').textContent = fmt(factor);
+    qs<HTMLElement>(ctx.root, '#csh-formula').textContent = factor === 2.4 ? ctx.ui.formulaHillier : ctx.ui.formulaKatz;
+    qs<HTMLElement>(ctx.root, '#csh-measured-pin-value').textContent = fmt(sodium);
+    qs<HTMLElement>(ctx.root, '#csh-corrected-pin-value').textContent = fmt(corrected);
+    qs<HTMLElement>(ctx.root, '#csh-interpretation').querySelector('strong')!.textContent = correctedLabel;
+
+    qs<HTMLElement>(ctx.root, '#csh-glucose-fill').style.height = `${glucosePosition(glucoseMgdl)}%`;
+    qs<HTMLElement>(ctx.root, '#csh-glucose-dot').style.bottom = `${glucosePosition(glucoseMgdl)}%`;
+    qs<HTMLElement>(ctx.root, '#csh-measured-pin').style.left = `${sodiumPosition(sodium)}%`;
+    qs<HTMLElement>(ctx.root, '#csh-corrected-pin').style.left = `${sodiumPosition(corrected)}%`;
+    qs<HTMLElement>(ctx.root, '#csh-converted').textContent =
+      ctx.glucoseUnit === 'mg/dL'
+        ? `${ctx.ui.convertedGlucose}: ${fmt(glucoseMgdl / 18.0182)} ${ctx.ui.glucoseMmol}`
+        : `${ctx.ui.convertedGlucose}: ${fmt(glucoseMgdl)} ${ctx.ui.glucoseMgdl}`;
+  }
+
+  function init(root: Element) {
+    const ctx: Ctx = {
+      root,
+      ui: JSON.parse((root as HTMLElement).dataset.ui || '{}') as Record<string, string>,
+      sodium: qs<HTMLInputElement>(root, '#csh-sodium'),
+      glucose: qs<HTMLInputElement>(root, '#csh-glucose'),
+      glucoseUnit: 'mg/dL',
+      mode: 'katz',
+    };
+
+    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('csh__toggle-btn--active', item === btn));
+        render(ctx);
+      });
+    });
+
+    root.querySelectorAll<HTMLButtonElement>('[data-mode]').forEach((btn) => {
+      btn.addEventListener('click', () => {
+        ctx.mode = btn.dataset.mode as Mode;
+        root.querySelectorAll<HTMLButtonElement>('[data-mode]').forEach((item) => item.classList.toggle('csh__factor-btn--active', item === btn));
+        render(ctx);
+      });
+    });
+
+    [ctx.sodium, ctx.glucose].forEach((input) => input.addEventListener('input', () => render(ctx)));
+    render(ctx);
+  }
+
+  document.querySelectorAll('.csh').forEach(init);
+</script>