diagcalc 3.2.4 → 5.1.0

package/lib/diagcalc-datasets.js

@@ -5,7 +5,7 @@
   }
 
   root.DiagcalcDatasets = factory();
-}(typeof globalThis !== "undefined" ? globalThis : this, () => {
+}(/** @type {any} */ (typeof globalThis !== "undefined" ? globalThis : this), () => {
   const datasets = {
     screening: {
       tp: 42,
@@ -45,6 +45,7 @@
       preTestProb: 28.6,
       name: "D-dimer for pulmonary embolism",
       description: "Low Wells score + D-dimer to rule out pulmonary embolism in the emergency department.",
+      lastReviewed: "2026-05-13",
       reference: {
         authors: "Righini M, et al.",
         title: "Age-Adjusted D-Dimer Cutoff Levels to Rule Out Pulmonary Embolism",
@@ -61,6 +62,7 @@
       preTestProb: 15,
       name: "High-sensitivity troponin for AMI",
       description: "High-sensitivity troponin for diagnosis of acute myocardial infarction.",
+      lastReviewed: "2026-05-13",
       reference: {
         authors: "Reichlin T, et al.",
         title: "Early Diagnosis of Myocardial Infarction with Sensitive Cardiac Troponin Assays",
@@ -77,6 +79,7 @@
       preTestProb: 1,
       name: "Screening mammography",
       description: "Mammographic screening in women aged 50-69 (aggregated data).",
+      lastReviewed: "2026-05-13",
       reference: {
         authors: "Kopans DB, et al.",
         title: "Screening Mammography Performance Metrics",
@@ -93,6 +96,7 @@
       preTestProb: 42.9,
       name: "Rapid COVID-19 antigen test",
       description: "Rapid antigen test for SARS-CoV-2 in symptomatic patients (first 7 days).",
+      lastReviewed: "2026-05-13",
       reference: {
         authors: "Dinnes J, et al.",
         title: "Rapid, Point-of-Care Antigen Tests for COVID-19",
@@ -109,6 +113,7 @@
       preTestProb: 2,
       name: "HIV ELISA",
       description: "4th-generation ELISA for HIV screening in the general population.",
+      lastReviewed: "2026-05-13",
       reference: {
         authors: "Masciotra S, et al.",
         title: "Performance of HIV Diagnostic Tests",
@@ -125,6 +130,7 @@
       preTestProb: 32,
       name: "Rapid Streptococcus test",
       description: "Rapid antigen test for streptococcal pharyngitis in children with fever and sore throat.",
+      lastReviewed: "2026-05-13",
       reference: {
         authors: "Cohen JF, et al.",
         title: "Rapid Antigen Detection Test for Group A Streptococcus in Children",
@@ -141,6 +147,7 @@
       preTestProb: 33.3,
       name: "Chest X-ray for pneumonia",
       description: "Chest X-ray for community-acquired pneumonia in symptomatic adults.",
+      lastReviewed: "2026-05-13",
       reference: {
         authors: "Hagaman JT, et al.",
         title: "Admission Chest Radiograph Lacks Sensitivity in Pneumonia",
@@ -149,8 +156,139 @@
         url: "https://www.amjmedsci.org/",
       },
     },
+    wells_dvt: {
+      tp: 60,
+      fp: 85,
+      fn: 15,
+      tn: 340,
+      preTestProb: 15,
+      name: "Wells score (≥2) for DVT",
+      description: "Wells clinical prediction rule (cut-off ≥2 points = 'DVT likely') applied to outpatients with suspected lower-limb deep vein thrombosis.",
+      lastReviewed: "2026-05-13",
+      reference: {
+        authors: "Wells PS, et al.",
+        title: "Evaluation of D-Dimer in the Diagnosis of Suspected Deep-Vein Thrombosis",
+        journal: "N Engl J Med. 2003;349(13):1227-1235",
+        doi: "10.1056/NEJMoa023153",
+        url: "https://www.nejm.org/doi/full/10.1056/NEJMoa023153",
+      },
+    },
+    heart_acs: {
+      tp: 380,
+      fp: 1020,
+      fn: 20,
+      tn: 1020,
+      preTestProb: 17,
+      name: "HEART score (≥4) for MACE in chest pain",
+      description: "HEART score (History, ECG, Age, Risk factors, Troponin) ≥4 to predict 6-week major adverse cardiac events in undifferentiated ED chest pain.",
+      lastReviewed: "2026-05-13",
+      reference: {
+        authors: "Backus BE, et al.",
+        title: "A prospective validation of the HEART score for chest pain patients at the emergency department",
+        journal: "Int J Cardiol. 2013;168(3):2153-2158",
+        doi: "10.1016/j.ijcard.2013.01.255",
+        url: "https://www.internationaljournalofcardiology.com/article/S0167-5273(13)00253-2/fulltext",
+      },
+    },
+    curb65: {
+      tp: 72,
+      fp: 214,
+      fn: 24,
+      tn: 758,
+      preTestProb: 9,
+      name: "CURB-65 (≥2) for severe community-acquired pneumonia",
+      description: "CURB-65 score ≥2 as a marker of severe community-acquired pneumonia / 30-day mortality, derived/validated across UK, NZ and Netherlands cohorts.",
+      lastReviewed: "2026-05-13",
+      reference: {
+        authors: "Lim WS, et al.",
+        title: "Defining community acquired pneumonia severity on presentation to hospital: an international derivation and validation study",
+        journal: "Thorax. 2003;58(5):377-382",
+        doi: "10.1136/thorax.58.5.377",
+        url: "https://thorax.bmj.com/content/58/5/377",
+      },
+    },
+    qsofa: {
+      tp: 55,
+      fp: 180,
+      fn: 45,
+      tn: 720,
+      preTestProb: 10,
+      name: "qSOFA (≥2) for sepsis screening",
+      description: "Quick SOFA score ≥2 (SBP ≤100, RR ≥22, altered mentation) as a bedside screen for in-hospital mortality among patients with suspected infection outside the ICU.",
+      lastReviewed: "2026-05-13",
+      reference: {
+        authors: "Seymour CW, et al.",
+        title: "Assessment of Clinical Criteria for Sepsis (Sepsis-3)",
+        journal: "JAMA. 2016;315(8):762-774",
+        doi: "10.1001/jama.2016.0288",
+        url: "https://jamanetwork.com/journals/jama/fullarticle/2492875",
+      },
+    },
+    apgar_5min: {
+      tp: 20,
+      fp: 200,
+      fn: 60,
+      tn: 19720,
+      preTestProb: 0.4,
+      name: "APGAR < 7 at 5 min for severe neonatal outcome",
+      description: "Five-minute APGAR score below 7 as a predictor of neonatal death in term infants. Illustrates a highly specific but low-sensitivity test at very low disease prevalence.",
+      lastReviewed: "2026-05-13",
+      reference: {
+        authors: "Casey BM, McIntire DD, Leveno KJ.",
+        title: "The continuing value of the Apgar score for the assessment of newborn infants",
+        journal: "N Engl J Med. 2001;344(7):467-471",
+        doi: "10.1056/NEJM200102153440701",
+        url: "https://www.nejm.org/doi/full/10.1056/NEJM200102153440701",
+      },
+    },
+    fast_trauma: {
+      tp: 110,
+      fp: 28,
+      fn: 19,
+      tn: 1383,
+      preTestProb: 8,
+      name: "FAST ultrasound for blunt abdominal trauma",
+      description: "Focused Assessment with Sonography for Trauma (surgeon-performed) for intra-abdominal injury in blunt trauma patients.",
+      lastReviewed: "2026-05-13",
+      reference: {
+        authors: "Rozycki GS, et al.",
+        title: "A prospective study of surgeon-performed ultrasound as the primary adjuvant modality for injured patient assessment",
+        journal: "Ann Surg. 1998;228(4):557-567",
+        doi: "10.1097/00000658-199810000-00012",
+        url: "https://journals.lww.com/annalsofsurgery/Fulltext/1998/10000/A_Prospective_Study_of_Surgeon_Performed.12.aspx",
+      },
+    },
   };
 
+  // Existing counts have no retained source-table extraction. Citations are
+  // background reading, not evidence that these exact counts were published.
+  for (const dataset of Object.values(datasets)) {
+    dataset.provenance = Object.freeze({
+      kind: "illustrative",
+      sourceLocation: null,
+      extraction: null,
+      population: dataset.description,
+      threshold: null,
+      referenceStandard: null,
+      outcome: null,
+      reviewStatus: "Extraction not verified",
+      note: dataset.reference
+        ? "Illustrative teaching counts. The citation is background reading; these counts have not been verified against a published table."
+        : "Generic illustrative teaching scenario; not an empirical study.",
+    });
+    if (dataset.lastReviewed) {
+      dataset.referenceLastReviewed = dataset.lastReviewed;
+      delete dataset.lastReviewed;
+    }
+    Object.freeze(dataset.reference);
+    Object.freeze(dataset);
+  }
+  Object.freeze(datasets);
+
+  function buildDatasetWarnings(dataset) {
+    return dataset && dataset.provenance ? [dataset.provenance.note] : [];
+  }
+
   function getDataset(key) {
     if (!Object.prototype.hasOwnProperty.call(datasets, key)) {
       return null;
@@ -168,6 +306,7 @@
 
   return {
     datasets,
+    buildDatasetWarnings,
     getDataset,
     listDatasets,
   };

package/lib/diagcalc-geometry.js

@@ -0,0 +1,27 @@
+(function (root, factory) {
+  if (typeof module === "object" && module.exports) {
+    module.exports = factory();
+    return;
+  }
+  root.DiagcalcGeometry = factory();
+}(/** @type {any} */ (typeof globalThis !== "undefined" ? globalThis : this), () => {
+  const limit = Math.log(999);
+  function logit(probability) {
+    return Math.log(probability / (1 - probability));
+  }
+  function prePosition(probability) {
+    return 0.5 + logit(probability) / (2 * limit);
+  }
+  function postPosition(probability) {
+    return 0.5 - logit(probability) / (2 * limit);
+  }
+  function lrPosition(lr) {
+    return 0.5 - Math.log(lr) / (4 * limit);
+  }
+  /** Normalised calibrated Fagan coordinates; off-scale values are not clipped. */
+  function faganCoordinates(pre, lr, post) {
+    const positions = { pre: prePosition(pre), lr: lrPosition(lr), post: postPosition(post) };
+    return { ...positions, inRange: Object.values(positions).every((value) => Number.isFinite(value) && value >= 0 && value <= 1) };
+  }
+  return { prePosition, postPosition, lrPosition, faganCoordinates };
+}));