@jjlmoya/utils-health 1.26.0 → 1.27.0

package/package.json

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

package/src/category/index.ts

@@ -22,10 +22,11 @@ import { leanBodyMassCalculator } from '../tool/leanBodyMassCalculator/entry';
 import { metabolicAgeCalculator } from '../tool/metabolicAgeCalculator/entry';
 import { bunCreatinineCalculator } from '../tool/bunCreatinineCalculator/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, targetHeightEstimator, daltonismSimulator, tinnitusReliever, breathingVisualizer, caffeineTracker, waterPurifier, digestionStopwatch, binauralTuner, pelliRobsonTest, peripheralVisionTrainer, epworthSleepinessScale],
+  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],
   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 { targetHeightEstimator } from './tool/targetHeightEstimator/entry';
+export { correctedReticulocyteIndex } from './tool/correctedReticulocyteIndex/entry';
 export { pelliRobsonTest } from './tool/pelliRobsonTest/entry';
 export { peripheralVisionTrainer } from './tool/peripheralVisionTrainer/entry';
 export { readingDistanceCalculator } from './tool/readingDistanceCalculator/entry';
@@ -48,6 +49,7 @@ import { macronutrientCalculator } from './tool/macronutrientCalculator/entry';
 import { tdeeCalculator } from './tool/tdeeCalculator/entry';
 import { bunCreatinineCalculator } from './tool/bunCreatinineCalculator/entry';
 import { targetHeightEstimator } from './tool/targetHeightEstimator/entry';
+import { correctedReticulocyteIndex } from './tool/correctedReticulocyteIndex/entry';
 import { pelliRobsonTest } from './tool/pelliRobsonTest/entry';
 import { peripheralVisionTrainer } from './tool/peripheralVisionTrainer/entry';
 import { readingDistanceCalculator } from './tool/readingDistanceCalculator/entry';
@@ -55,4 +57,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, 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, 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/targetHeightEstimator';
+export * from './tool/correctedReticulocyteIndex';
 
 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(28);
+    expect(ALL_TOOLS.length).toBe(29);
   });
 });

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

package/src/tool/correctedReticulocyteIndex/bibliography.astro

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

package/src/tool/correctedReticulocyteIndex/bibliography.ts

@@ -0,0 +1,20 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Hillman RS, Finch CA: Red Cell Manual',
+    url: 'https://openlibrary.org/books/OL5686128M/Red_cell_manual',
+  },
+  {
+    name: 'Panzassy AJ: Reticulocyte production index',
+    url: 'https://pubmed.ncbi.nlm.nih.gov/4061477/',
+  },
+  {
+    name: 'MedlinePlus / NIH: Reticulocyte count test',
+    url: 'https://medlineplus.gov/lab-tests/reticulocyte-count/',
+  },
+  {
+    name: 'Wikipedia: Reticulocyte production index',
+    url: 'https://en.wikipedia.org/wiki/Reticulocyte_production_index',
+  },
+];

package/src/tool/correctedReticulocyteIndex/component.astro

@@ -0,0 +1,262 @@
+---
+import './corrected-reticulocyte-index-calculator.css';
+import type { CorrectedReticulocyteIndexUI } from './ui';
+
+interface Props {
+  locale?: string;
+  ui?: Record<string, unknown>;
+}
+
+const t = (Astro.props.ui || {}) as CorrectedReticulocyteIndexUI;
+---
+
+<div class="rpi" data-ui={JSON.stringify(t)}>
+  <div class="rpi__warning" role="note" aria-label={t.disclaimerTitle}>
+    <svg class="rpi__warning-icon" viewBox="0 0 24 24" aria-hidden="true">
+      <path d="M12 2L2.6 20.5h18.8L12 2z" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linejoin="round" />
+      <path d="M12 8v6" stroke="currentColor" stroke-width="2" stroke-linecap="round" />
+      <circle cx="12" cy="17.2" r="1.2" fill="currentColor" />
+    </svg>
+    <div>
+      <strong>{t.disclaimerTitle}</strong>
+      <span>{t.disclaimerBody}</span>
+    </div>
+  </div>
+
+  <div class="rpi__report">
+    <div class="rpi__inputs">
+      <label class="rpi__field">
+        <span>{t.observedLabel}</span>
+        <input id="rpi-observed" class="rpi__input" type="number" min="0" max="30" step="0.1" value="7" placeholder={t.observedPlaceholder} aria-label={t.observedLabel} />
+      </label>
+
+      <label class="rpi__field">
+        <span>{t.patientHctLabel}</span>
+        <input id="rpi-patient-hct" class="rpi__input" type="number" min="5" max="65" step="0.1" value="30" placeholder={t.patientHctPlaceholder} aria-label={t.patientHctLabel} />
+      </label>
+
+      <label class="rpi__field rpi__field--reference">
+        <span>{t.referenceHctLabel}</span>
+        <input id="rpi-reference-hct" class="rpi__input" type="number" min="20" max="60" step="0.1" value="45" placeholder={t.referenceHctPlaceholder} aria-label={t.referenceHctLabel} />
+        <div class="rpi__presets" role="group" aria-label={t.referenceHctLabel}>
+          <button type="button" class="rpi__preset rpi__preset--active" data-reference="45">{t.referenceMale}</button>
+          <button type="button" class="rpi__preset" data-reference="40">{t.referenceFemale}</button>
+          <button type="button" class="rpi__preset" data-reference="custom">{t.referenceCustom}</button>
+        </div>
+      </label>
+    </div>
+
+    <div class="rpi__result" data-band="adequate">
+      <div class="rpi__sphere" aria-label={t.rpiSphereLabel} role="img">
+        <svg viewBox="0 0 220 220" aria-hidden="true">
+          <defs>
+            <radialGradient id="rpiSphereGlow" cx="42%" cy="32%" r="70%">
+              <stop offset="0" stop-color="#fff" stop-opacity="0.95" />
+              <stop offset="0.26" stop-color="#fca5a5" stop-opacity="0.72" />
+              <stop offset="1" stop-color="#7f1d1d" stop-opacity="0.94" />
+            </radialGradient>
+          </defs>
+          <circle class="rpi__sphere-orbit" cx="110" cy="110" r="92" />
+          <circle class="rpi__sphere-core" cx="110" cy="110" r="76" />
+          <path id="rpi-sphere-fill" class="rpi__sphere-fill" d="M42 141 C75 118 139 118 178 141 L178 186 L42 186 Z" />
+          <circle class="rpi__sphere-shine" cx="82" cy="72" r="19" />
+        </svg>
+        <div class="rpi__sphere-value">
+          <span>{t.rpiLabel}</span>
+          <strong id="rpi-value">3.11</strong>
+        </div>
+      </div>
+
+      <div class="rpi__readout">
+        <span class="rpi__badge" id="rpi-badge">{t.adequateBadge}</span>
+        <strong id="rpi-band">{t.adequateLabel}</strong>
+        <p id="rpi-description">{t.adequateDescription}</p>
+      </div>
+    </div>
+  </div>
+
+  <div class="rpi__metrics">
+    <div class="rpi__metric">
+      <span>{t.correctedLabel}</span>
+      <strong id="rpi-corrected">4.67%</strong>
+    </div>
+    <div class="rpi__metric">
+      <span>{t.maturationFactorLabel}</span>
+      <strong id="rpi-factor">1.5</strong>
+    </div>
+    <div class="rpi__metric">
+      <span>{t.rpiLabel}</span>
+      <strong id="rpi-small">3.11</strong>
+    </div>
+  </div>
+
+  <div class="rpi__formula">
+    <div class="rpi__formula-card">
+      <span class="rpi__formula-mark" aria-hidden="true"></span>
+      <div class="rpi__formula-copy">
+        <strong>{t.formulaCorrectedTitle}</strong>
+        <span>{t.formulaCorrectedText}</span>
+      </div>
+    </div>
+    <div class="rpi__formula-card">
+      <span class="rpi__formula-mark" aria-hidden="true"></span>
+      <div class="rpi__formula-copy">
+        <strong>{t.formulaRpiTitle}</strong>
+        <span>{t.formulaRpiText}</span>
+      </div>
+    </div>
+    <div class="rpi__factor-card">
+      <div class="rpi__formula-copy">
+        <strong>{t.factorTitle}</strong>
+      </div>
+      <div class="rpi__factor-grid">
+        <span>{t.factorRule1}</span>
+        <span>{t.factorRule15}</span>
+        <span>{t.factorRule2}</span>
+        <span>{t.factorRule25}</span>
+      </div>
+    </div>
+  </div>
+</div>
+
+<script>
+  type Band = 'insufficient' | 'borderline' | 'adequate';
+
+  interface Elements {
+    root: HTMLElement;
+    observed: HTMLInputElement;
+    patientHct: HTMLInputElement;
+    referenceHct: HTMLInputElement;
+    presets: NodeListOf<HTMLButtonElement>;
+    result: HTMLElement;
+    rpiValue: HTMLElement;
+    rpiSmall: HTMLElement;
+    corrected: HTMLElement;
+    factor: HTMLElement;
+    badge: HTMLElement;
+    band: HTMLElement;
+    description: HTMLElement;
+    sphereFill: SVGPathElement;
+  }
+
+  function required<T extends Element>(root: Element, selector: string): T {
+    const element = root.querySelector<T>(selector);
+    if (!element) throw new Error(selector);
+    return element;
+  }
+
+  function getElements(root: Element): Elements | null {
+    try {
+      return {
+        root: root as HTMLElement,
+        observed: required<HTMLInputElement>(root, '#rpi-observed'),
+        patientHct: required<HTMLInputElement>(root, '#rpi-patient-hct'),
+        referenceHct: required<HTMLInputElement>(root, '#rpi-reference-hct'),
+        presets: root.querySelectorAll<HTMLButtonElement>('.rpi__preset'),
+        result: required<HTMLElement>(root, '.rpi__result'),
+        rpiValue: required<HTMLElement>(root, '#rpi-value'),
+        rpiSmall: required<HTMLElement>(root, '#rpi-small'),
+        corrected: required<HTMLElement>(root, '#rpi-corrected'),
+        factor: required<HTMLElement>(root, '#rpi-factor'),
+        badge: required<HTMLElement>(root, '#rpi-badge'),
+        band: required<HTMLElement>(root, '#rpi-band'),
+        description: required<HTMLElement>(root, '#rpi-description'),
+        sphereFill: required<SVGPathElement>(root, '#rpi-sphere-fill'),
+      };
+    } catch {
+      return null;
+    }
+  }
+
+  function factorForHct(hct: number): number {
+    if (hct >= 35) return 1;
+    if (hct >= 25) return 1.5;
+    if (hct >= 15) return 2;
+    return 2.5;
+  }
+
+  function classifyRpi(rpi: number): Band {
+    if (rpi < 2) return 'insufficient';
+    if (rpi >= 3) return 'adequate';
+    return 'borderline';
+  }
+
+  function round2(value: number): number {
+    return Math.round(value * 100) / 100;
+  }
+
+  function formatPercent(value: number, ui: Record<string, string>): string {
+    return `${round2(value).toFixed(2)}${ui.percentUnit}`;
+  }
+
+  function renderEmpty(elements: Elements, ui: Record<string, string>) {
+    elements.corrected.textContent = ui.emptyValue;
+    elements.factor.textContent = ui.emptyValue;
+    elements.rpiValue.textContent = ui.emptyValue;
+    elements.rpiSmall.textContent = ui.emptyValue;
+  }
+
+  function render(elements: Elements, ui: Record<string, string>) {
+    const observed = Number(elements.observed.value);
+    const patientHct = Number(elements.patientHct.value);
+    const referenceHct = Number(elements.referenceHct.value);
+    const hasValues = observed > 0 && patientHct > 0 && referenceHct > 0;
+
+    if (!hasValues) {
+      renderEmpty(elements, ui);
+      return;
+    }
+
+    const corrected = observed * (patientHct / referenceHct);
+    const factor = factorForHct(patientHct);
+    const rpi = corrected / factor;
+    const band = classifyRpi(rpi);
+    const bandCopy: Record<Band, { label: string; badge: string; description: string }> = {
+      insufficient: { label: ui.insufficientLabel, badge: ui.insufficientBadge, description: ui.insufficientDescription },
+      borderline: { label: ui.borderlineLabel, badge: ui.borderlineBadge, description: ui.borderlineDescription },
+      adequate: { label: ui.adequateLabel, badge: ui.adequateBadge, description: ui.adequateDescription },
+    };
+
+    elements.result.dataset.band = band;
+    elements.corrected.textContent = formatPercent(corrected, ui);
+    elements.factor.textContent = factor.toFixed(1);
+    elements.rpiValue.textContent = round2(rpi).toFixed(2);
+    elements.rpiSmall.textContent = round2(rpi).toFixed(2);
+    elements.badge.textContent = bandCopy[band].badge;
+    elements.band.textContent = bandCopy[band].label;
+    elements.description.textContent = bandCopy[band].description;
+
+    const fillLevel = Math.max(0.14, Math.min(0.86, rpi / 5));
+    const top = 186 - fillLevel * 124;
+    elements.sphereFill.setAttribute('d', `M42 ${top} C76 ${top - 14} 142 ${top - 14} 178 ${top} L178 186 L42 186 Z`);
+  }
+
+  function initRpi(root: Element) {
+    const ui = JSON.parse((root as HTMLElement).dataset.ui || '{}') as Record<string, string>;
+    const elements = getElements(root);
+    if (!elements) return;
+    const update = () => render(elements, ui);
+
+    elements.presets.forEach((button) => {
+      button.addEventListener('click', () => {
+        const reference = button.dataset.reference;
+        if (reference !== 'custom' && reference) elements.referenceHct.value = reference;
+        elements.presets.forEach((item) => item.classList.toggle('rpi__preset--active', item === button));
+        update();
+      });
+    });
+
+    [elements.observed, elements.patientHct, elements.referenceHct].forEach((input) => {
+      input.addEventListener('input', () => {
+        if (input === elements.referenceHct) {
+          elements.presets.forEach((item) => item.classList.toggle('rpi__preset--active', item.dataset.reference === 'custom'));
+        }
+        update();
+      });
+    });
+
+    update();
+  }
+
+  document.querySelectorAll('.rpi').forEach(initRpi);
+</script>