@precisa-saude/fhir-calculators 0.1.0

package/README.md

@@ -0,0 +1,90 @@
+# @precisa-saude/fhir-calculators
+
+Calculadoras clínicas — PhenoAge (Levine 2018), BrDMrisc (Bracco 2023), biomarcadores derivados (HOMA-IR, VLDL, IMC).
+
+## Instalação
+
+```bash
+npm install @precisa-saude/fhir-calculators
+```
+
+> **Nota:** Requer `@precisa-saude/fhir` como peer dependency.
+
+## Uso rápido
+
+### PhenoAge — Idade biológica
+
+Implementação do algoritmo de Levine et al. (2018) para cálculo de idade biológica a partir de 9 biomarcadores sanguíneos.
+
+```ts
+import { phenoage } from '@precisa-saude/fhir-calculators';
+
+const result = phenoage.calculatePhenoAge({
+  chronologicalAge: 45,
+  albumin: 42,             // g/L
+  creatinine: 80,          // μmol/L
+  glucose: 5.2,            // mmol/L
+  crp: 1.5,                // mg/L
+  lymphocytePercent: 30,
+  mcv: 88,                 // fL
+  rdw: 13.2,               // %
+  alkalinePhosphatase: 65, // U/L
+  wbc: 6.0,                // 10^9/L
+});
+
+console.log(result.phenoAge);       // 42.3 (idade biológica)
+console.log(result.ageDifference);  // -2.7 (anos mais jovem)
+```
+
+### BrDMrisc — Risco de diabetes tipo 2
+
+Implementação do modelo BrDMrisc (Bracco et al. 2023) para estimativa de risco de diabetes tipo 2 em 10 anos, validado para a população brasileira. Seleciona automaticamente o melhor modelo disponível com base nos biomarcadores presentes.
+
+```ts
+import { brdmrisc } from '@precisa-saude/fhir-calculators';
+
+const result = brdmrisc.calculateBrDMrisc({
+  fpg: 105,           // mg/dL — glicemia de jejum
+  hba1c: 5.8,         // %
+  triglycerides: 180,  // mg/dL
+  hdlc: 42,           // mg/dL
+});
+
+console.log(result.riskPercent);  // 18.5 (% risco em 10 anos)
+console.log(result.riskCategory); // 'moderate'
+console.log(result.modelUsed.name); // 'FPG + HbA1c + Lipids'
+```
+
+### Biomarcadores derivados
+
+Calcula biomarcadores derivados a partir de valores laboratoriais existentes.
+
+```ts
+import { computeDerivedBiomarkers } from '@precisa-saude/fhir-calculators';
+
+const derived = computeDerivedBiomarkers([
+  { code: 'Glucose', value: 95 },
+  { code: 'Insulin', value: 12.0 },
+  { code: 'Triglycerides', value: 150 },
+]);
+
+// Retorna: HOMA-IR = (95 × 12) / 405, VLDL = 150 / 5
+derived.forEach(d => console.log(`${d.code}: ${d.value} ${d.unit}`));
+```
+
+## Referências acadêmicas
+
+| Calculadora     | Referência                                                                                     |
+| --------------- | ---------------------------------------------------------------------------------------------- |
+| PhenoAge        | Levine ME et al. (2018). An epigenetic biomarker of aging. *Aging* 10(4):573-591               |
+| BrDMrisc        | Bracco PA et al. (2023). BrDMrisc model for type 2 diabetes risk in Brazilians                 |
+| HOMA-IR         | Matthews DR et al. (1985). Homeostasis model assessment. *Diabetologia* 28(7):412-419          |
+| VLDL            | Friedewald WT et al. (1972). Estimation of LDL cholesterol. *Clin Chem* 18(6):499-502          |
+
+## Aviso médico
+
+Este pacote implementa algoritmos clínicos publicados para fins de software. Os resultados **não constituem diagnóstico médico** e não substituem avaliação profissional. Consulte o [DISCLAIMER.md](../../DISCLAIMER.md) na raiz do repositório para detalhes completos.
+
+## Licença
+
+[Apache-2.0](../../LICENSE)