@jjlmoya/utils-health 1.34.0 → 1.35.0

package/package.json

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

package/src/category/index.ts

@@ -30,10 +30,11 @@ import { fractionalExcretionSodiumCalculator } from '../tool/fractionalExcretion
 import { targetHeightEstimator } from '../tool/targetHeightEstimator/entry';
 import { correctedReticulocyteIndex } from '../tool/correctedReticulocyteIndex/entry';
 import { estimatedBloodVolumeCalculator } from '../tool/estimatedBloodVolumeCalculator/entry';
+import { anionGapCalculator } from '../tool/anionGapCalculator/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, 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, 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

@@ -26,6 +26,7 @@ export { fractionalExcretionSodiumCalculator } from './tool/fractionalExcretionS
 export { targetHeightEstimator } from './tool/targetHeightEstimator/entry';
 export { correctedReticulocyteIndex } from './tool/correctedReticulocyteIndex/entry';
 export { estimatedBloodVolumeCalculator } from './tool/estimatedBloodVolumeCalculator/entry';
+export { anionGapCalculator } from './tool/anionGapCalculator/entry';
 export { pelliRobsonTest } from './tool/pelliRobsonTest/entry';
 export { peripheralVisionTrainer } from './tool/peripheralVisionTrainer/entry';
 export { readingDistanceCalculator } from './tool/readingDistanceCalculator/entry';
@@ -63,6 +64,7 @@ import { fractionalExcretionSodiumCalculator } from './tool/fractionalExcretionS
 import { targetHeightEstimator } from './tool/targetHeightEstimator/entry';
 import { correctedReticulocyteIndex } from './tool/correctedReticulocyteIndex/entry';
 import { estimatedBloodVolumeCalculator } from './tool/estimatedBloodVolumeCalculator/entry';
+import { anionGapCalculator } from './tool/anionGapCalculator/entry';
 import { pelliRobsonTest } from './tool/pelliRobsonTest/entry';
 import { peripheralVisionTrainer } from './tool/peripheralVisionTrainer/entry';
 import { readingDistanceCalculator } from './tool/readingDistanceCalculator/entry';
@@ -71,4 +73,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, 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, targetHeightEstimator, daltonismSimulator, digestionStopwatch, epworthSleepinessScale, hydrationCalculator, leanBodyMassCalculator, metabolicAgeCalculator, pelliRobsonTest, peripheralVisionTrainer, readingDistanceCalculator, screenDecompressionTime, tinnitusReliever, parametricNoiseSynthesizer, ubeCalculator, waterPurifier];

package/src/index.ts

@@ -34,6 +34,7 @@ export * from './tool/fractionalExcretionSodiumCalculator';
 export * from './tool/targetHeightEstimator';
 export * from './tool/correctedReticulocyteIndex';
 export * from './tool/estimatedBloodVolumeCalculator';
+export * from './tool/anionGapCalculator';
 
 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(36);
+    expect(ALL_TOOLS.length).toBe(37);
   });
 });

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

package/src/tool/anionGapCalculator/anion-gap-calculator.css

@@ -0,0 +1,472 @@
+.agap {
+  --agap-ink: #172033;
+  --agap-muted: #667085;
+  --agap-line: #dbe4ef;
+  --agap-panel: #fff;
+  --agap-soft: #f6f8fb;
+  --agap-na: #2563eb;
+  --agap-k: #8b5cf6;
+  --agap-cl: #059669;
+  --agap-hco3: #0891b2;
+  --agap-gap: #f59e0b;
+  --agap-danger: #d92d20;
+  --agap-ok: #079455;
+
+  background: linear-gradient(135deg, #f8fbff, #fff8ed);
+  border: 1px solid var(--agap-line);
+  border-radius: 8px;
+  color: var(--agap-ink);
+  display: grid;
+  gap: 8px;
+  padding: 8px;
+  width: 100%;
+}
+
+.theme-dark .agap {
+  --agap-ink: #eef4ff;
+  --agap-muted: #a7b2c5;
+  --agap-line: #334155;
+  --agap-panel: #101827;
+  --agap-soft: #172235;
+  --agap-na: #78a9ff;
+  --agap-k: #b69aff;
+  --agap-cl: #4bd49d;
+  --agap-hco3: #4ecfe5;
+  --agap-gap: #ffc15a;
+  --agap-danger: #ff6b5f;
+  --agap-ok: #4bd49d;
+
+  background: linear-gradient(135deg, #101827, #151f2e);
+}
+
+.agap__warning {
+  background: linear-gradient(90deg, rgba(217, 45, 32, 0.12), rgba(245, 158, 11, 0.1)), var(--agap-panel);
+  border: 2px solid var(--agap-danger);
+  border-radius: 8px;
+  display: grid;
+  gap: 3px;
+  padding: 8px 10px;
+}
+
+.agap__warning strong {
+  color: var(--agap-danger);
+  font-size: 0.82rem;
+  font-weight: 950;
+  letter-spacing: 0.02em;
+  line-height: 1.15;
+  text-transform: uppercase;
+}
+
+.agap__warning span {
+  color: var(--agap-ink);
+  font-size: 0.78rem;
+  font-weight: 750;
+  line-height: 1.3;
+}
+
+.agap__shell {
+  align-items: start;
+  display: grid;
+  gap: 10px;
+}
+
+.agap__hero,
+.agap__workbench {
+  background: color-mix(in srgb, var(--agap-panel) 92%, transparent);
+  border: 1px solid var(--agap-line);
+  border-radius: 8px;
+}
+
+.agap__hero {
+  display: grid;
+  gap: 8px;
+  grid-template-columns: 1fr 1fr;
+  padding: 10px;
+}
+
+.agap__score {
+  background: linear-gradient(135deg, rgba(37, 99, 235, 0.12), rgba(8, 145, 178, 0.08)), var(--agap-soft);
+  border: 1px solid color-mix(in srgb, var(--agap-na) 26%, var(--agap-line));
+  border-radius: 8px;
+  min-width: 0;
+  padding: 10px 12px;
+}
+
+.agap__score--corrected {
+  background: linear-gradient(135deg, rgba(245, 158, 11, 0.15), rgba(139, 92, 246, 0.08)), var(--agap-soft);
+  border-color: color-mix(in srgb, var(--agap-gap) 34%, var(--agap-line));
+}
+
+.agap__score span,
+.agap__score small {
+  color: var(--agap-muted);
+  display: block;
+  font-size: 0.76rem;
+  font-weight: 900;
+  line-height: 1.2;
+  text-transform: uppercase;
+}
+
+.agap__score strong {
+  color: var(--agap-na);
+  display: block;
+  font-size: clamp(3rem, 9vw, 5.5rem);
+  font-weight: 950;
+  letter-spacing: 0;
+  line-height: 0.9;
+  margin: 8px 0 6px;
+}
+
+.agap__score--corrected strong {
+  color: var(--agap-gap);
+}
+
+.agap__range {
+  background: var(--agap-soft);
+  border: 1px solid var(--agap-line);
+  border-radius: 8px;
+  display: grid;
+  gap: 7px;
+  grid-column: 1 / -1;
+  padding: 9px 10px;
+}
+
+.agap__range > span,
+.agap__range-labels {
+  color: var(--agap-muted);
+  font-size: 0.74rem;
+  font-weight: 900;
+}
+
+.agap__track {
+  background: linear-gradient(90deg, var(--agap-na) 0 28%, var(--agap-ok) 28% 54%, var(--agap-danger) 54% 100%);
+  border-radius: 999px;
+  height: 14px;
+  position: relative;
+}
+
+.agap__track i {
+  background: rgba(255, 255, 255, 0.72);
+  border-radius: inherit;
+  bottom: 3px;
+  left: 28%;
+  position: absolute;
+  top: 3px;
+  width: 26%;
+}
+
+.agap__track b {
+  background: var(--agap-ink);
+  border: 2px solid var(--agap-panel);
+  border-radius: 999px;
+  height: 24px;
+  position: absolute;
+  top: 50%;
+  transform: translate(-50%, -50%);
+  transition: left 0.2s ease;
+  width: 12px;
+}
+
+.agap__range-labels {
+  display: flex;
+  justify-content: space-between;
+}
+
+.agap__workbench {
+  display: grid;
+  gap: 9px;
+  padding: 9px;
+}
+
+.agap__inputs {
+  display: grid;
+  gap: 7px;
+  grid-template-columns: 1fr 1fr;
+}
+
+.agap__field {
+  background: var(--agap-panel);
+  border: 1px solid var(--agap-line);
+  border-radius: 8px;
+  display: grid;
+  gap: 3px;
+  min-width: 0;
+  padding: 8px 10px;
+}
+
+.agap__field:focus-within {
+  border-color: var(--agap-na);
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--agap-na) 17%, transparent);
+}
+
+.agap__field span {
+  color: var(--agap-muted);
+  font-size: 0.72rem;
+  font-weight: 950;
+  line-height: 1.1;
+}
+
+.agap__field input {
+  background: transparent;
+  border: 0;
+  color: var(--agap-ink);
+  font: inherit;
+  font-size: 1.16rem;
+  font-weight: 950;
+  min-width: 0;
+  outline: 0;
+  padding: 0;
+}
+
+.agap__field small {
+  color: var(--agap-muted);
+  font-size: 0.72rem;
+  font-weight: 900;
+}
+
+.agap__field--albumin {
+  grid-column: 1 / -1;
+  grid-template-columns: minmax(0, 1fr) auto;
+}
+
+.agap__field--albumin span,
+.agap__field--albumin input {
+  grid-column: 1;
+}
+
+.agap__units {
+  align-self: center;
+  background: var(--agap-soft);
+  border: 1px solid var(--agap-line);
+  border-radius: 7px;
+  display: flex;
+  grid-column: 2;
+  grid-row: 1 / span 2;
+  overflow: hidden;
+}
+
+.agap__unit {
+  background: transparent;
+  border: 0;
+  color: var(--agap-muted);
+  cursor: pointer;
+  font: inherit;
+  font-size: 0.72rem;
+  font-weight: 950;
+  padding: 8px 10px;
+}
+
+.agap__unit--active {
+  background: var(--agap-ink);
+  color: var(--agap-panel);
+}
+
+.agap__switch {
+  align-items: center;
+  background: var(--agap-soft);
+  border: 1px solid var(--agap-line);
+  border-radius: 8px;
+  display: flex;
+  gap: 9px;
+  grid-column: 1 / -1;
+  min-height: 42px;
+  padding: 8px 10px;
+}
+
+.agap__switch input {
+  accent-color: var(--agap-na);
+  height: 18px;
+  width: 18px;
+}
+
+.agap__switch span {
+  font-size: 0.82rem;
+  font-weight: 900;
+}
+
+.agap__visual {
+  display: grid;
+  gap: 9px;
+}
+
+.agap__formula {
+  align-items: center;
+  background: var(--agap-soft);
+  border: 1px solid var(--agap-line);
+  border-radius: 8px;
+  display: grid;
+  gap: 8px;
+  grid-template-columns: auto minmax(0, 1fr);
+  padding: 8px 10px;
+}
+
+.agap__formula span {
+  color: var(--agap-muted);
+  font-size: 0.72rem;
+  font-weight: 950;
+  text-transform: uppercase;
+}
+
+.agap__formula code {
+  background: var(--agap-panel);
+  border: 1px solid var(--agap-line);
+  border-radius: 6px;
+  color: var(--agap-ink);
+  font-size: 0.86rem;
+  font-weight: 900;
+  padding: 7px 8px;
+  white-space: normal;
+}
+
+.agap__bars {
+  display: grid;
+  gap: 8px;
+}
+
+.agap__bar-row {
+  display: grid;
+  gap: 6px;
+}
+
+.agap__bar-head {
+  align-items: baseline;
+  display: flex;
+  justify-content: space-between;
+}
+
+.agap__bar-head b {
+  color: var(--agap-muted);
+  font-size: 0.74rem;
+  font-weight: 950;
+  text-transform: uppercase;
+}
+
+.agap__bar-head span {
+  color: var(--agap-ink);
+  font-size: 0.84rem;
+  font-weight: 950;
+}
+
+.agap__bar {
+  background: var(--agap-soft);
+  border: 1px solid var(--agap-line);
+  border-radius: 8px;
+  display: flex;
+  height: 44px;
+  overflow: hidden;
+}
+
+.agap__part {
+  align-items: center;
+  color: #fff;
+  display: flex;
+  font-size: 0.78rem;
+  font-weight: 950;
+  justify-content: center;
+  min-width: 0;
+  overflow: hidden;
+  padding: 0 8px;
+  text-overflow: ellipsis;
+  transition: width 0.22s ease;
+  white-space: nowrap;
+}
+
+.agap__part--na { background: var(--agap-na); }
+.agap__part--k { background: var(--agap-k); }
+.agap__part--cl { background: var(--agap-cl); }
+.agap__part--hco3 { background: var(--agap-hco3); }
+.agap__part--gap {
+  background:
+    repeating-linear-gradient(135deg, rgba(255, 255, 255, 0.2), rgba(255, 255, 255, 0.2) 8px, transparent 8px, transparent 16px),
+    var(--agap-gap);
+  color: #2c1c00;
+}
+
+.agap__interpretation {
+  background: color-mix(in srgb, var(--agap-ok) 10%, var(--agap-panel));
+  border: 1px solid color-mix(in srgb, var(--agap-ok) 38%, var(--agap-line));
+  border-radius: 8px;
+  padding: 10px;
+}
+
+.agap__interpretation--hero {
+  grid-column: 1 / -1;
+}
+
+.agap__interpretation[data-state='low'] {
+  background: color-mix(in srgb, var(--agap-na) 10%, var(--agap-panel));
+  border-color: color-mix(in srgb, var(--agap-na) 38%, var(--agap-line));
+}
+
+.agap__interpretation[data-state='high'] {
+  background: color-mix(in srgb, var(--agap-danger) 10%, var(--agap-panel));
+  border-color: color-mix(in srgb, var(--agap-danger) 42%, var(--agap-line));
+}
+
+.agap__interpretation b {
+  display: block;
+  font-size: 1rem;
+  margin-bottom: 4px;
+}
+
+.agap__interpretation p {
+  color: var(--agap-muted);
+  font-size: 0.86rem;
+  font-weight: 650;
+  line-height: 1.35;
+  margin: 0;
+}
+
+@media (min-width: 780px) {
+  .agap {
+    padding: 10px;
+  }
+
+  .agap__shell {
+    grid-template-columns: minmax(290px, 0.74fr) minmax(0, 1.26fr);
+  }
+
+  .agap__hero {
+    align-content: start;
+    align-self: start;
+  }
+
+  .agap__workbench {
+    grid-template-columns: 310px minmax(0, 1fr);
+  }
+}
+
+@media (min-width: 1120px) {
+  .agap__inputs {
+    grid-template-columns: repeat(4, minmax(0, 1fr));
+  }
+
+  .agap__field--albumin,
+  .agap__switch {
+    grid-column: span 2;
+  }
+
+  .agap__workbench {
+    grid-template-columns: 1fr;
+  }
+}
+
+@media (max-width: 520px) {
+  .agap__hero,
+  .agap__inputs {
+    grid-template-columns: 1fr;
+  }
+
+  .agap__field--albumin,
+  .agap__switch {
+    grid-column: auto;
+  }
+
+  .agap__formula {
+    grid-template-columns: 1fr;
+  }
+
+  .agap__bar {
+    height: 42px;
+  }
+}

package/src/tool/anionGapCalculator/bibliography.astro

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

package/src/tool/anionGapCalculator/bibliography.ts

@@ -0,0 +1,28 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Emmett M, Narins RG. Clinical use of the anion gap. Medicine. 1977.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/896161/',
+  },
+  {
+    name: 'Figge J, et al. Anion gap and hypoalbuminemia. Critical Care Medicine. 1998.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/9824071/',
+  },
+  {
+    name: 'Kraut JA, Madias NE. Serum anion gap: its uses and limitations in clinical medicine. Clinical Journal of the American Society of Nephrology. 2007.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/17699401/',
+  },
+  {
+    name: 'Berend K. Diagnostic use of base excess in acid-base disorders. New England Journal of Medicine. 2018.',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/30044931/',
+  },
+  {
+    name: 'Merck Manual Professional: Metabolic Acidosis',
+    url: 'https://www.merckmanuals.com/professional/endocrine-and-metabolic-disorders/acid-base-regulation-and-disorders/metabolic-acidosis',
+  },
+  {
+    name: 'Wikipedia: Anion gap',
+    url: 'https://en.wikipedia.org/wiki/Anion_gap',
+  },
+];