@jjlmoya/utils-health 1.36.0 → 1.37.0

package/package.json

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

package/src/category/index.ts

@@ -32,10 +32,12 @@ import { correctedReticulocyteIndex } from '../tool/correctedReticulocyteIndex/e
 import { estimatedBloodVolumeCalculator } from '../tool/estimatedBloodVolumeCalculator/entry';
 import { anionGapCalculator } from '../tool/anionGapCalculator/entry';
 import { creatinineClearanceCockcroftGault } from '../tool/creatinineClearanceCockcroftGault/entry';
+import { correctedCalciumCalculator } from '../tool/correctedCalciumCalculator/entry';
+import { egfrCalculator } from '../tool/egfrCalculator/entry';
 
 export const healthCategory: HealthCategoryEntry = {
   icon: 'mdi:heart-pulse',
-  tools: [bmiCalculator, amputationAdjustedBmiCalculator, bodyAdiposityIndexCalculator, bodyFatPercentageCalculator, waistHipRatioCalculator, waistHeightRatioCalculator, leanBodyMassCalculator, metabolicAgeCalculator, caloricDeficitCalculator, dailyProteinCalculator, macronutrientCalculator, tdeeCalculator, bunCreatinineCalculator, serumOsmolalityCalculator, meanArterialPressureCalculator, correctedSodiumHyperglycemiaCalculator, fractionalExcretionSodiumCalculator, correctedReticulocyteIndex, estimatedBloodVolumeCalculator, anionGapCalculator, creatinineClearanceCockcroftGault, 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, estimatedBloodVolumeCalculator, anionGapCalculator, creatinineClearanceCockcroftGault, correctedCalciumCalculator, egfrCalculator, 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

@@ -28,6 +28,8 @@ export { correctedReticulocyteIndex } from './tool/correctedReticulocyteIndex/en
 export { estimatedBloodVolumeCalculator } from './tool/estimatedBloodVolumeCalculator/entry';
 export { anionGapCalculator } from './tool/anionGapCalculator/entry';
 export { creatinineClearanceCockcroftGault } from './tool/creatinineClearanceCockcroftGault/entry';
+export { correctedCalciumCalculator } from './tool/correctedCalciumCalculator/entry';
+export { egfrCalculator } from './tool/egfrCalculator/entry';
 export { pelliRobsonTest } from './tool/pelliRobsonTest/entry';
 export { peripheralVisionTrainer } from './tool/peripheralVisionTrainer/entry';
 export { readingDistanceCalculator } from './tool/readingDistanceCalculator/entry';
@@ -67,6 +69,8 @@ import { correctedReticulocyteIndex } from './tool/correctedReticulocyteIndex/en
 import { estimatedBloodVolumeCalculator } from './tool/estimatedBloodVolumeCalculator/entry';
 import { anionGapCalculator } from './tool/anionGapCalculator/entry';
 import { creatinineClearanceCockcroftGault } from './tool/creatinineClearanceCockcroftGault/entry';
+import { correctedCalciumCalculator } from './tool/correctedCalciumCalculator/entry';
+import { egfrCalculator } from './tool/egfrCalculator/entry';
 import { pelliRobsonTest } from './tool/pelliRobsonTest/entry';
 import { peripheralVisionTrainer } from './tool/peripheralVisionTrainer/entry';
 import { readingDistanceCalculator } from './tool/readingDistanceCalculator/entry';
@@ -75,4 +79,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, meanArterialPressureCalculator, correctedSodiumHyperglycemiaCalculator, fractionalExcretionSodiumCalculator, correctedReticulocyteIndex, estimatedBloodVolumeCalculator, anionGapCalculator, creatinineClearanceCockcroftGault, 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, estimatedBloodVolumeCalculator, anionGapCalculator, creatinineClearanceCockcroftGault, correctedCalciumCalculator, egfrCalculator, targetHeightEstimator, daltonismSimulator, digestionStopwatch, epworthSleepinessScale, hydrationCalculator, leanBodyMassCalculator, metabolicAgeCalculator, pelliRobsonTest, peripheralVisionTrainer, readingDistanceCalculator, screenDecompressionTime, tinnitusReliever, parametricNoiseSynthesizer, ubeCalculator, waterPurifier];

package/src/index.ts

@@ -36,6 +36,8 @@ export * from './tool/correctedReticulocyteIndex';
 export * from './tool/estimatedBloodVolumeCalculator';
 export * from './tool/anionGapCalculator';
 export * from './tool/creatinineClearanceCockcroftGault';
+export * from './tool/correctedCalciumCalculator';
+export * from './tool/egfrCalculator';
 
 export { healthCategory } from './category';
 export const healthCategorySEO = () => import('./category/seo.astro').then((m) => m.default);

package/src/tests/locale_completeness.test.ts

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

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

package/src/tool/correctedCalciumCalculator/bibliography.astro

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

package/src/tool/correctedCalciumCalculator/bibliography.ts

@@ -0,0 +1,20 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Payne RB, et al. (1973). Interpretation of serum calcium in patients with abnormal serum proteins. British Medical Journal.',
+    url: 'https://www.bmj.com/content/4/5893/643',
+  },
+  {
+    name: 'StatPearls: Hypocalcemia (clinical review of calcium homeostasis).',
+    url: 'https://www.ncbi.nlm.nih.gov/books/NBK560604/',
+  },
+  {
+    name: 'StatPearls: Hypercalcemia (clinical guidance on calcium abnormalities).',
+    url: 'https://www.ncbi.nlm.nih.gov/books/NBK430714/',
+  },
+  {
+    name: 'Wikipedia: Calcium in biology (physiology and binding characteristics).',
+    url: 'https://en.wikipedia.org/wiki/Calcium_in_biology',
+  },
+];

package/src/tool/correctedCalciumCalculator/component.astro

@@ -0,0 +1,317 @@
+---
+import './corrected-calcium-calculator.css';
+import type { CorrectedCalciumCalculatorUI } from './ui';
+
+interface Props {
+  locale?: string;
+  ui?: Record<string, unknown>;
+}
+
+const t = (Astro.props.ui || {}) as CorrectedCalciumCalculatorUI;
+---
+
+<div class="ccc" data-ui={JSON.stringify(t)}>
+  <div class="ccc__warning" role="alert">
+    <div class="ccc__warning-mark">{t.safetyMark}</div>
+    <div class="ccc__warning-text">
+      <strong class="ccc__warning-title">{t.safetyTitle}</strong>
+      <span>{t.safetyBody}</span>
+    </div>
+  </div>
+
+  <div class="ccc__layout">
+    <section class="ccc__meter-card" aria-label={t.calciumAxisLabel}>
+      <h3 class="ccc__meter-title">{t.calciumAxisLabel}</h3>
+      
+      <div class="ccc__gauge-container">
+        <div class="ccc__gauge-track">
+          <div id="ccc-segment-low" class="ccc__gauge-segment ccc__gauge-segment--low"></div>
+          <div id="ccc-segment-normal" class="ccc__gauge-segment ccc__gauge-segment--normal"></div>
+          <div id="ccc-segment-high" class="ccc__gauge-segment ccc__gauge-segment--high"></div>
+        </div>
+
+        <div id="ccc-displacement-bridge" class="ccc__displacement-bridge"></div>
+        
+        <div id="ccc-ptr-measured" class="ccc__pointer ccc__pointer--measured">
+          <span class="ccc__pointer-label ccc__pointer-label--measured">{t.measuredMarker}</span>
+        </div>
+
+        <div id="ccc-ptr-corrected" class="ccc__pointer ccc__pointer--corrected">
+          <span class="ccc__pointer-label ccc__pointer-label--corrected">{t.correctedMarker}</span>
+        </div>
+      </div>
+
+      <div class="ccc__scale-labels">
+        <span id="ccc-tick-min" class="ccc__scale-tick" style="left: 0%;"></span>
+        <span id="ccc-tick-low-val" class="ccc__scale-tick"></span>
+        <span id="ccc-tick-high-val" class="ccc__scale-tick"></span>
+        <span id="ccc-tick-max" class="ccc__scale-tick" style="left: 100%;"></span>
+      </div>
+    </section>
+
+    <section class="ccc__panel">
+      <div class="ccc__fields">
+        <div class="ccc__field">
+          <label class="ccc__field-title" for="ccc-calcium">{t.calciumLabel}</label>
+          <div class="ccc__input-group">
+            <input id="ccc-calcium" class="ccc__input" type="number" min="0" step="0.1" placeholder={t.calciumPlaceholder} />
+            <div class="ccc__toggle-group" role="group">
+              <button type="button" class="ccc__toggle-btn ccc__toggle-btn--active" data-calcium-unit="mg/dL">{t.calciumMgdl}</button>
+              <button type="button" class="ccc__toggle-btn" data-calcium-unit="mmol/L">{t.calciumMmol}</button>
+            </div>
+          </div>
+        </div>
+
+        <div class="ccc__field">
+          <label class="ccc__field-title" for="ccc-albumin">{t.albuminLabel}</label>
+          <div class="ccc__input-group">
+            <input id="ccc-albumin" class="ccc__input" type="number" min="0" step="0.1" placeholder={t.albuminPlaceholder} />
+            <div class="ccc__toggle-group" role="group">
+              <button type="button" class="ccc__toggle-btn ccc__toggle-btn--active" data-albumin-unit="g/dL">{t.albuminGdl}</button>
+              <button type="button" class="ccc__toggle-btn" data-albumin-unit="g/L">{t.albuminGl}</button>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <div class="ccc__results">
+        <div class="ccc__result-box ccc__result-box--highlight">
+          <span class="ccc__result-label">{t.correctedLabel}</span>
+          <div class="ccc__result-values">
+            <span id="ccc-val-corrected" class="ccc__result-number">{t.emptyValue}</span>
+            <span id="ccc-unit-corrected" class="ccc__result-unit"></span>
+          </div>
+        </div>
+
+        <div class="ccc__result-box">
+          <span class="ccc__result-label">{t.measuredLabel}</span>
+          <div class="ccc__result-values">
+            <span id="ccc-val-measured" class="ccc__result-number">{t.emptyValue}</span>
+            <span id="ccc-unit-measured" class="ccc__result-unit"></span>
+          </div>
+        </div>
+      </div>
+
+      <div id="ccc-interpretation" class="ccc__interpretation" style="display: none;"></div>
+
+      <div class="ccc__formula">
+        <span>{t.formulaLabel}: </span>
+        <code id="ccc-formula-text"></code>
+      </div>
+    </section>
+  </div>
+</div>
+
+<script>
+  type CalciumUnit = 'mg/dL' | 'mmol/L';
+  type AlbuminUnit = 'g/dL' | 'g/L';
+
+  interface UIStrings {
+    emptyValue: string;
+    formulaConventional: string;
+    formulaSi: string;
+    interpretationLow: string;
+    interpretationNormal: string;
+    interpretationHigh: string;
+    interpretationBody: string;
+    calciumMgdl: string;
+    calciumMmol: string;
+  }
+
+  const root = document.querySelector('.ccc');
+  if (root) {
+    const t: UIStrings = JSON.parse(root.getAttribute('data-ui') || '{}');
+
+    const inputCalcium = root.querySelector('#ccc-calcium') as HTMLInputElement;
+    const inputAlbumin = root.querySelector('#ccc-albumin') as HTMLInputElement;
+
+    const valMeasured = root.querySelector('#ccc-val-measured') as HTMLSpanElement;
+    const valCorrected = root.querySelector('#ccc-val-corrected') as HTMLSpanElement;
+    const unitMeasured = root.querySelector('#ccc-unit-measured') as HTMLSpanElement;
+    const unitCorrected = root.querySelector('#ccc-unit-corrected') as HTMLSpanElement;
+
+    const ptrMeasured = root.querySelector('#ccc-ptr-measured') as HTMLDivElement;
+    const ptrCorrected = root.querySelector('#ccc-ptr-corrected') as HTMLDivElement;
+    const bridge = root.querySelector('#ccc-displacement-bridge') as HTMLDivElement;
+
+    const segmentLow = root.querySelector('#ccc-segment-low') as HTMLDivElement;
+    const segmentNormal = root.querySelector('#ccc-segment-normal') as HTMLDivElement;
+    const segmentHigh = root.querySelector('#ccc-segment-high') as HTMLDivElement;
+
+    const tickMin = root.querySelector('#ccc-tick-min') as HTMLSpanElement;
+    const tickLowVal = root.querySelector('#ccc-tick-low-val') as HTMLSpanElement;
+    const tickHighVal = root.querySelector('#ccc-tick-high-val') as HTMLSpanElement;
+    const tickMax = root.querySelector('#ccc-tick-max') as HTMLSpanElement;
+
+    const interpretation = root.querySelector('#ccc-interpretation') as HTMLDivElement;
+    const formulaText = root.querySelector('#ccc-formula-text') as HTMLElement;
+
+    let calciumUnit: CalciumUnit = 'mg/dL';
+    let albuminUnit: AlbuminUnit = 'g/dL';
+
+    const getLimits = (unit: CalciumUnit) => {
+      if (unit === 'mg/dL') {
+        return { min: 5.0, max: 14.0, low: 8.5, high: 10.5 };
+      }
+      return { min: 1.25, max: 3.50, low: 2.15, high: 2.55 };
+    };
+
+    const updateScale = () => {
+      const limits = getLimits(calciumUnit);
+      const total = limits.max - limits.min;
+      const lowPct = ((limits.low - limits.min) / total) * 100;
+      const normalPct = ((limits.high - limits.low) / total) * 100;
+      const highPct = ((limits.max - limits.high) / total) * 100;
+
+      segmentLow.style.width = `${lowPct}%`;
+      segmentNormal.style.width = `${normalPct}%`;
+      segmentHigh.style.width = `${highPct}%`;
+
+      tickMin.textContent = limits.min.toFixed(unitDecimals());
+      
+      tickLowVal.textContent = limits.low.toFixed(unitDecimals());
+      tickLowVal.style.left = `${lowPct}%`;
+      
+      tickHighVal.textContent = limits.high.toFixed(unitDecimals());
+      tickHighVal.style.left = `${lowPct + normalPct}%`;
+      
+      tickMax.textContent = limits.max.toFixed(unitDecimals());
+
+      formulaText.textContent = calciumUnit === 'mg/dL' ? t.formulaConventional : t.formulaSi;
+    };
+
+    const unitDecimals = () => {
+      return calciumUnit === 'mg/dL' ? 1 : 2;
+    };
+
+    const getPositionPct = (val: number, min: number, max: number) => {
+      const pct = ((val - min) / (max - min)) * 100;
+      return Math.max(0, Math.min(100, pct));
+    };
+
+    const getCorrectedVal = (ca: number, alb: number) => {
+      if (calciumUnit === 'mg/dL') {
+        const albGdl = albuminUnit === 'g/L' ? alb / 10 : alb;
+        return ca + 0.8 * (4.0 - albGdl);
+      }
+      const albGl = albuminUnit === 'g/dL' ? alb * 10 : alb;
+      return ca + 0.02 * (40 - albGl);
+    };
+
+    const updatePointers = (ca: number, corrected: number) => {
+      const limits = getLimits(calciumUnit);
+      const measuredPct = getPositionPct(ca, limits.min, limits.max);
+      const correctedPct = getPositionPct(corrected, limits.min, limits.max);
+
+      ptrMeasured.style.left = `${measuredPct}%`;
+      ptrCorrected.style.left = `${correctedPct}%`;
+
+      const startPct = Math.min(measuredPct, correctedPct);
+      const widthPct = Math.abs(measuredPct - correctedPct);
+      bridge.style.left = `${startPct}%`;
+      bridge.style.width = `${widthPct}%`;
+    };
+
+    const showInterpretation = (corrected: number) => {
+      const limits = getLimits(calciumUnit);
+      interpretation.style.display = 'block';
+      interpretation.className = 'ccc__interpretation';
+
+      if (corrected < limits.low) {
+        interpretation.classList.add('ccc__interpretation--low');
+        interpretation.innerHTML = `<strong>${t.interpretationLow}</strong> — ${t.interpretationBody}`;
+      } else if (corrected > limits.high) {
+        interpretation.classList.add('ccc__interpretation--high');
+        interpretation.innerHTML = `<strong>${t.interpretationHigh}</strong> — ${t.interpretationBody}`;
+      } else {
+        interpretation.classList.add('ccc__interpretation--normal');
+        interpretation.innerHTML = `<strong>${t.interpretationNormal}</strong> — ${t.interpretationBody}`;
+      }
+    };
+
+    const calculate = () => {
+      let ca = parseFloat(inputCalcium.value);
+      let alb = parseFloat(inputAlbumin.value);
+      const isBlank = isNaN(ca) || isNaN(alb);
+
+      if (isBlank) {
+        ca = calciumUnit === 'mg/dL' ? 8.0 : 2.0;
+        alb = albuminUnit === 'g/dL' ? 3.0 : 30;
+        ptrMeasured.classList.add('ccc__pointer--preview');
+        ptrCorrected.classList.add('ccc__pointer--preview');
+        valMeasured.textContent = t.emptyValue;
+        valCorrected.textContent = t.emptyValue;
+        unitMeasured.textContent = '';
+        unitCorrected.textContent = '';
+        interpretation.style.display = 'none';
+      } else {
+        ptrMeasured.classList.remove('ccc__pointer--preview');
+        ptrCorrected.classList.remove('ccc__pointer--preview');
+      }
+
+      const corrected = getCorrectedVal(ca, alb);
+      const decimals = unitDecimals();
+
+      if (!isBlank) {
+        valMeasured.textContent = ca.toFixed(decimals);
+        valCorrected.textContent = corrected.toFixed(decimals);
+        unitMeasured.textContent = calciumUnit;
+        unitCorrected.textContent = calciumUnit;
+        showInterpretation(corrected);
+      }
+
+      updatePointers(ca, corrected);
+    };
+
+    root.querySelectorAll('[data-calcium-unit]').forEach((btn) => {
+      btn.addEventListener('click', (e) => {
+        const target = e.currentTarget as HTMLButtonElement;
+        const newUnit = target.getAttribute('data-calcium-unit') as CalciumUnit;
+        if (newUnit !== calciumUnit) {
+          root.querySelectorAll('[data-calcium-unit]').forEach((b) => b.classList.remove('ccc__toggle-btn--active'));
+          target.classList.add('ccc__toggle-btn--active');
+          
+          const caVal = parseFloat(inputCalcium.value);
+          if (!isNaN(caVal)) {
+            if (newUnit === 'mmol/L') {
+              inputCalcium.value = (caVal / 4).toFixed(2);
+            } else {
+              inputCalcium.value = (caVal * 4).toFixed(1);
+            }
+          }
+          calciumUnit = newUnit;
+          updateScale();
+          calculate();
+        }
+      });
+    });
+
+    root.querySelectorAll('[data-albumin-unit]').forEach((btn) => {
+      btn.addEventListener('click', (e) => {
+        const target = e.currentTarget as HTMLButtonElement;
+        const newUnit = target.getAttribute('data-albumin-unit') as AlbuminUnit;
+        if (newUnit !== albuminUnit) {
+          root.querySelectorAll('[data-albumin-unit]').forEach((b) => b.classList.remove('ccc__toggle-btn--active'));
+          target.classList.add('ccc__toggle-btn--active');
+
+          const albVal = parseFloat(inputAlbumin.value);
+          if (!isNaN(albVal)) {
+            if (newUnit === 'g/L') {
+              inputAlbumin.value = (albVal * 10).toFixed(0);
+            } else {
+              inputAlbumin.value = (albVal / 10).toFixed(1);
+            }
+          }
+          albuminUnit = newUnit;
+          calculate();
+        }
+      });
+    });
+
+    inputCalcium.addEventListener('input', calculate);
+    inputAlbumin.addEventListener('input', calculate);
+
+    updateScale();
+    calculate();
+  }
+</script>