@jjlmoya/utils-health 1.28.0 → 1.29.0

package/package.json

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

package/src/category/index.ts

@@ -22,12 +22,13 @@ 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 { 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, bodyAdiposityIndexCalculator, bodyFatPercentageCalculator, waistHipRatioCalculator, waistHeightRatioCalculator, leanBodyMassCalculator, metabolicAgeCalculator, caloricDeficitCalculator, dailyProteinCalculator, macronutrientCalculator, tdeeCalculator, bunCreatinineCalculator, serumOsmolalityCalculator, 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, 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

@@ -19,6 +19,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 { fractionalExcretionSodiumCalculator } from './tool/fractionalExcretionSodiumCalculator/entry';
 export { targetHeightEstimator } from './tool/targetHeightEstimator/entry';
 export { correctedReticulocyteIndex } from './tool/correctedReticulocyteIndex/entry';
 export { pelliRobsonTest } from './tool/pelliRobsonTest/entry';
@@ -50,6 +51,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 { fractionalExcretionSodiumCalculator } from './tool/fractionalExcretionSodiumCalculator/entry';
 import { targetHeightEstimator } from './tool/targetHeightEstimator/entry';
 import { correctedReticulocyteIndex } from './tool/correctedReticulocyteIndex/entry';
 import { pelliRobsonTest } from './tool/pelliRobsonTest/entry';
@@ -59,4 +61,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, serumOsmolalityCalculator, 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, fractionalExcretionSodiumCalculator, correctedReticulocyteIndex, targetHeightEstimator, daltonismSimulator, digestionStopwatch, epworthSleepinessScale, hydrationCalculator, leanBodyMassCalculator, metabolicAgeCalculator, pelliRobsonTest, peripheralVisionTrainer, readingDistanceCalculator, screenDecompressionTime, tinnitusReliever, ubeCalculator, waterPurifier];

package/src/index.ts

@@ -26,6 +26,7 @@ export * from './tool/macronutrientCalculator';
 export * from './tool/tdeeCalculator';
 export * from './tool/bunCreatinineCalculator';
 export * from './tool/serumOsmolalityCalculator';
+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(30);
+    expect(ALL_TOOLS.length).toBe(31);
   });
 });

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

package/src/tool/fractionalExcretionSodiumCalculator/bibliography.astro

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

package/src/tool/fractionalExcretionSodiumCalculator/bibliography.ts

@@ -0,0 +1,28 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Espinel CH. The FENa test. Use in the differential diagnosis of acute renal failure. JAMA. 1976.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/947998/',
+  },
+  {
+    name: 'Steiner RW. Interpreting the fractional excretion of sodium. American Journal of Medicine. 1984.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/6507441/',
+  },
+  {
+    name: 'Miller TR, Anderson RJ, Linas SL, et al. Urinary diagnostic indices in acute renal failure. Annals of Internal Medicine. 1978.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/677543/',
+  },
+  {
+    name: 'KDIGO Clinical Practice Guideline for Acute Kidney Injury. Kidney International Supplements. 2012.',
+    url: 'https://kdigo.org/guidelines/acute-kidney-injury/',
+  },
+  {
+    name: 'Merck Manual Professional Edition: Acute Kidney Injury',
+    url: 'https://www.merckmanuals.com/professional/genitourinary-disorders/acute-kidney-injury/acute-kidney-injury-aki',
+  },
+  {
+    name: 'Wikipedia: Fractional excretion of sodium',
+    url: 'https://en.wikipedia.org/wiki/Fractional_excretion_of_sodium',
+  },
+];

package/src/tool/fractionalExcretionSodiumCalculator/component.astro

@@ -0,0 +1,251 @@
+---
+import './fractional-excretion-sodium-calculator.css';
+import type { FractionalExcretionSodiumCalculatorUI } from './ui';
+
+interface Props {
+  locale?: string;
+  ui?: Record<string, unknown>;
+}
+
+const t = (Astro.props.ui || {}) as FractionalExcretionSodiumCalculatorUI;
+---
+
+<div class="fena" data-ui={JSON.stringify(t)}>
+  <div class="fena__warning" role="alert" aria-label={t.educationWarningTitle}>
+    <div class="fena__warning-mark">{t.educationWarningMark}</div>
+    <div>
+      <strong>{t.educationWarningTitle}</strong>
+      <span>{t.educationWarningBody}</span>
+    </div>
+  </div>
+
+  <div class="fena__grid">
+    <section class="fena__panel fena__panel--viz">
+      <div class="fena__dial" aria-label={t.resultLabel}>
+        <div class="fena__dial-arc"></div>
+        <div id="fena-needle" class="fena__needle"></div>
+        <div class="fena__dial-center">
+          <span>{t.resultLabel}</span>
+          <strong id="fena-value">{t.emptyValue}</strong>
+          <small>{t.percentUnit}</small>
+        </div>
+        <span class="fena__scale fena__scale--low">{t.scaleLow}</span>
+        <span class="fena__scale fena__scale--mid">{t.scaleMid}</span>
+        <span class="fena__scale fena__scale--high">{t.scaleHigh}</span>
+      </div>
+
+      <div id="fena-band" class="fena__band fena__band--empty">
+        <strong id="fena-band-title">{t.enterValues}</strong>
+        <span id="fena-band-body">{t.formula}</span>
+      </div>
+
+      <div class="fena__kidney" aria-label={t.kidneyFilterLabel}>
+        <svg viewBox="0 0 320 170" role="img" aria-hidden="true">
+          <path class="fena__kidney-shape" d="M118 16c-41 4-73 39-73 82 0 36 21 63 51 63 22 0 32-17 32-38 0-17-9-31-9-48 0-22 15-40 37-48-11-8-23-12-38-11Z"></path>
+          <path class="fena__kidney-shape fena__kidney-shape--right" d="M202 16c41 4 73 39 73 82 0 36-21 63-51 63-22 0-32-17-32-38 0-17 9-31 9-48 0-22-15-40-37-48 11-8 23-12 38-11Z"></path>
+          <path class="fena__tube" d="M82 82c48 0 53 41 78 41s30-41 78-41"></path>
+          <path id="fena-reabsorb-flow" class="fena__flow fena__flow--reabsorb" d="M88 101c40 15 56 24 72 24s32-9 72-24"></path>
+          <path id="fena-excrete-flow" class="fena__flow fena__flow--excrete" d="M160 124v37"></path>
+          <circle class="fena__na fena__na--a" cx="86" cy="82" r="7"></circle>
+          <circle class="fena__na fena__na--b" cx="160" cy="123" r="7"></circle>
+          <circle class="fena__na fena__na--c" cx="235" cy="82" r="7"></circle>
+        </svg>
+        <div class="fena__flow-labels">
+          <span>{t.sodiumReabsorbedLabel}</span>
+          <span>{t.sodiumExcretedLabel}</span>
+        </div>
+      </div>
+    </section>
+
+    <section class="fena__panel fena__panel--inputs">
+      <label class="fena__field">
+        <span>{t.serumSodiumLabel}</span>
+        <div class="fena__input-shell">
+          <input id="fena-serum-na" type="number" min="0" step="0.1" placeholder={t.serumSodiumPlaceholder} />
+          <small>{t.sodiumUnit}</small>
+        </div>
+      </label>
+
+      <label class="fena__field">
+        <span>{t.urineSodiumLabel}</span>
+        <div class="fena__input-shell">
+          <input id="fena-urine-na" type="number" min="0" step="0.1" placeholder={t.urineSodiumPlaceholder} />
+          <small>{t.sodiumUnit}</small>
+        </div>
+      </label>
+
+      <label class="fena__field">
+        <span>{t.serumCreatinineLabel}</span>
+        <div class="fena__input-shell fena__input-shell--toggle">
+          <input id="fena-serum-cr" type="number" min="0" step="0.01" placeholder={t.serumCreatininePlaceholder} />
+          <div class="fena__toggle" role="group" aria-label={t.serumCreatinineLabel}>
+            <button type="button" class="fena__toggle-btn fena__toggle-btn--active" data-serum-cr-unit="mg/dL">{t.mgdl}</button>
+            <button type="button" class="fena__toggle-btn" data-serum-cr-unit="umol/L">{t.umol}</button>
+          </div>
+        </div>
+        <small id="fena-serum-cr-converted" class="fena__converted"></small>
+      </label>
+
+      <label class="fena__field">
+        <span>{t.urineCreatinineLabel}</span>
+        <div class="fena__input-shell fena__input-shell--toggle">
+          <input id="fena-urine-cr" type="number" min="0" step="0.1" placeholder={t.urineCreatininePlaceholder} />
+          <div class="fena__toggle" role="group" aria-label={t.urineCreatinineLabel}>
+            <button type="button" class="fena__toggle-btn fena__toggle-btn--active" data-urine-cr-unit="mg/dL">{t.mgdl}</button>
+            <button type="button" class="fena__toggle-btn" data-urine-cr-unit="umol/L">{t.umol}</button>
+          </div>
+        </div>
+        <small id="fena-urine-cr-converted" class="fena__converted"></small>
+      </label>
+
+      <div class="fena__formula">
+        <span>{t.formulaLabel}</span>
+        <code>{t.formula}</code>
+      </div>
+
+      <div class="fena__caveat">
+        <strong>{t.caveatTitle}</strong>
+        <span>{t.caveatBody}</span>
+      </div>
+    </section>
+  </div>
+</div>
+
+<script>
+  type CreatinineUnit = 'mg/dL' | 'umol/L';
+  type FenaBand = 'prerenal' | 'indeterminate' | 'intrinsic';
+
+  interface FenaCtx {
+    root: Element;
+    ui: Record<string, string>;
+    serumNa: HTMLInputElement;
+    urineNa: HTMLInputElement;
+    serumCr: HTMLInputElement;
+    urineCr: HTMLInputElement;
+    serumCrUnit: CreatinineUnit;
+    urineCrUnit: CreatinineUnit;
+  }
+
+  const CR_FACTOR = 88.4;
+
+  function fenaQs<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 toMgdl(value: number, unit: CreatinineUnit): number {
+    return unit === 'umol/L' ? value / CR_FACTOR : value;
+  }
+
+  function fmt(value: number, digits = 2): string {
+    return String(Math.round(value * 10 ** digits) / 10 ** digits);
+  }
+
+  function bandFor(value: number): FenaBand {
+    if (value < 1) return 'prerenal';
+    if (value <= 2) return 'indeterminate';
+    return 'intrinsic';
+  }
+
+  function setBand(ctx: FenaCtx, band: FenaBand | 'empty') {
+    const title = fenaQs<HTMLElement>(ctx.root, '#fena-band-title');
+    const body = fenaQs<HTMLElement>(ctx.root, '#fena-band-body');
+    const box = fenaQs<HTMLElement>(ctx.root, '#fena-band');
+    box.className = `fena__band fena__band--${band}`;
+    if (band === 'empty') {
+      title.textContent = ctx.ui.enterValues;
+      body.textContent = ctx.ui.formula;
+      return;
+    }
+    title.textContent = ctx.ui[`${band}Label`];
+    body.textContent = ctx.ui[`${band}Body`];
+  }
+
+  function resetFena(ctx: FenaCtx) {
+    fenaQs<HTMLElement>(ctx.root, '#fena-value').textContent = ctx.ui.emptyValue;
+    fenaQs<HTMLElement>(ctx.root, '#fena-needle').style.transform = 'translateX(-50%) rotate(-82deg)';
+    fenaQs<SVGPathElement>(ctx.root, '#fena-reabsorb-flow').style.strokeWidth = '12';
+    fenaQs<SVGPathElement>(ctx.root, '#fena-excrete-flow').style.strokeWidth = '4';
+    fenaQs<HTMLElement>(ctx.root, '#fena-serum-cr-converted').textContent = '';
+    fenaQs<HTMLElement>(ctx.root, '#fena-urine-cr-converted').textContent = '';
+    setBand(ctx, 'empty');
+  }
+
+  function renderConversions(ctx: FenaCtx, serumCrMgdl: number, urineCrMgdl: number) {
+    fenaQs<HTMLElement>(ctx.root, '#fena-serum-cr-converted').textContent =
+      ctx.serumCrUnit === 'mg/dL'
+        ? `${ctx.ui.serumCreatinineConverted}: ${fmt(serumCrMgdl * CR_FACTOR, 1)} ${ctx.ui.umol}`
+        : `${ctx.ui.serumCreatinineConverted}: ${fmt(serumCrMgdl)} ${ctx.ui.mgdl}`;
+    fenaQs<HTMLElement>(ctx.root, '#fena-urine-cr-converted').textContent =
+      ctx.urineCrUnit === 'mg/dL'
+        ? `${ctx.ui.urineCreatinineConverted}: ${fmt(urineCrMgdl * CR_FACTOR, 0)} ${ctx.ui.umol}`
+        : `${ctx.ui.urineCreatinineConverted}: ${fmt(urineCrMgdl)} ${ctx.ui.mgdl}`;
+  }
+
+  function renderFena(ctx: FenaCtx) {
+    const serumNa = parseFloat(ctx.serumNa.value);
+    const urineNa = parseFloat(ctx.urineNa.value);
+    const serumCrRaw = parseFloat(ctx.serumCr.value);
+    const urineCrRaw = parseFloat(ctx.urineCr.value);
+    const hasValues = serumNa > 0 && urineNa >= 0 && serumCrRaw > 0 && urineCrRaw > 0;
+
+    if (!hasValues) {
+      resetFena(ctx);
+      return;
+    }
+
+    const serumCrMgdl = toMgdl(serumCrRaw, ctx.serumCrUnit);
+    const urineCrMgdl = toMgdl(urineCrRaw, ctx.urineCrUnit);
+    const fena = ((urineNa * serumCrMgdl) / (serumNa * urineCrMgdl)) * 100;
+    const rounded = Math.round(fena * 100) / 100;
+    const band = bandFor(rounded);
+    const angle = -82 + Math.min(1, rounded / 4) * 164;
+    const excretion = Math.max(4, Math.min(16, 4 + rounded * 3));
+    const reabsorb = Math.max(4, 14 - rounded * 2.2);
+
+    fenaQs<HTMLElement>(ctx.root, '#fena-value').textContent = fmt(rounded);
+    fenaQs<HTMLElement>(ctx.root, '#fena-needle').style.transform = `translateX(-50%) rotate(${angle}deg)`;
+    fenaQs<SVGPathElement>(ctx.root, '#fena-reabsorb-flow').style.strokeWidth = String(reabsorb);
+    fenaQs<SVGPathElement>(ctx.root, '#fena-excrete-flow').style.strokeWidth = String(excretion);
+    setBand(ctx, band);
+    renderConversions(ctx, serumCrMgdl, urineCrMgdl);
+  }
+
+  function bindUnit(root: Element, selector: string, activeClass: string, onChange: (unit: CreatinineUnit) => void) {
+    root.querySelectorAll<HTMLButtonElement>(selector).forEach((btn) => {
+      btn.addEventListener('click', () => {
+        const unit = (btn.dataset.serumCrUnit || btn.dataset.urineCrUnit) as CreatinineUnit;
+        onChange(unit);
+        root.querySelectorAll<HTMLButtonElement>(selector).forEach((item) => item.classList.toggle(activeClass, item === btn));
+      });
+    });
+  }
+
+  function initFena(root: Element) {
+    const ctx: FenaCtx = {
+      root,
+      ui: JSON.parse((root as HTMLElement).dataset.ui || '{}') as Record<string, string>,
+      serumNa: fenaQs<HTMLInputElement>(root, '#fena-serum-na'),
+      urineNa: fenaQs<HTMLInputElement>(root, '#fena-urine-na'),
+      serumCr: fenaQs<HTMLInputElement>(root, '#fena-serum-cr'),
+      urineCr: fenaQs<HTMLInputElement>(root, '#fena-urine-cr'),
+      serumCrUnit: 'mg/dL',
+      urineCrUnit: 'mg/dL',
+    };
+
+    bindUnit(root, '[data-serum-cr-unit]', 'fena__toggle-btn--active', (unit) => {
+      ctx.serumCrUnit = unit;
+      renderFena(ctx);
+    });
+    bindUnit(root, '[data-urine-cr-unit]', 'fena__toggle-btn--active', (unit) => {
+      ctx.urineCrUnit = unit;
+      renderFena(ctx);
+    });
+
+    [ctx.serumNa, ctx.urineNa, ctx.serumCr, ctx.urineCr].forEach((input) => input.addEventListener('input', () => renderFena(ctx)));
+    renderFena(ctx);
+  }
+
+  document.querySelectorAll('.fena').forEach(initFena);
+</script>

package/src/tool/fractionalExcretionSodiumCalculator/entry.ts

@@ -0,0 +1,27 @@
+import type { HealthToolEntry } from '../../types';
+import type { FractionalExcretionSodiumCalculatorUI } from './ui';
+
+export const fractionalExcretionSodiumCalculator: HealthToolEntry<FractionalExcretionSodiumCalculatorUI> = {
+  id: 'fractionalExcretionSodiumCalculator',
+  icons: {
+    bg: 'mdi:flask-outline',
+    fg: 'mdi:percent-outline',
+  },
+  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),
+  },
+};