diagcalc 3.2.3 → 3.2.4

package/README.md

@@ -52,6 +52,23 @@ The web and terminal interfaces both follow that workflow.
 - Fagan nomogram in the web app
 - TUI, text CLI, and JSON CLI output in the terminal app
 
+## Case Studies
+
+The app includes both generic teaching scenarios and literature-based examples.
+
+- `screening` - low-prevalence population screening workflow
+- `caseControl` - balanced case-control teaching example
+- `clinic` - specialist clinic setting with intermediate prevalence
+- `ddimer` - D-dimer for pulmonary embolism rule-out
+- `troponin` - high-sensitivity troponin for acute myocardial infarction
+- `mammography` - screening mammography in a low-prevalence setting
+- `covid_antigen` - rapid antigen testing for COVID-19
+- `hiv_elisa` - fourth-generation HIV ELISA screening
+- `strep_throat` - rapid antigen testing for streptococcal pharyngitis
+- `xray_pneumonia` - chest X-ray for community-acquired pneumonia
+
+These cases are included to support teaching across different prevalence settings, screening vs. confirmation logic, and Bayesian interpretation of test results.
+
 ## Web App
 
 The web app is static. It does not need a build step.

package/bin/diagcalc.js

@@ -206,6 +206,11 @@ function main() {
   }
 
   const metrics = core.calculateMetrics(built.input);
+  if (args.format !== undefined && typeof args.format !== "string") {
+    process.stderr.write("Missing value for --format. Use --format text or --format json.\n");
+    process.exitCode = 1;
+    return;
+  }
   const format = typeof args.format === "string" ? args.format.toLowerCase() : "text";
   if (format === "json") {
     printJsonReport(built.dataset, built.input, metrics);

package/index.html

@@ -8,6 +8,7 @@
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600;700;800&display=swap" />
     <link rel="stylesheet" href="styles.css" />
+    <script defer src="https://analytics.tiagojct.eu/script.js" data-website-id="2c7df365-61e6-42e6-8298-a20ada3e296a"></script>
   </head>
   <body>
     <header class="intro" role="banner">

package/lib/diagcalc-core.js

@@ -21,7 +21,7 @@
     }
 
     if (preTestProb < 0 || preTestProb >= 100) {
-      return { valid: false, message: "Pre-test probability must be between 0 and 99.9%." };
+      return { valid: false, message: "Pre-test probability must be at least 0% and below 100%." };
     }
 
     if (tp + fn === 0) {
@@ -135,6 +135,9 @@
   }
 
   function calculateRatio(numerator, denominator) {
+    if (numerator === 0 && denominator === 0) {
+      return NaN;
+    }
     if (denominator === 0) {
       return Infinity;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diagcalc",
-  "version": "3.2.3",
+  "version": "3.2.4",
   "description": "Diagnostic calculator for the browser, terminal, and plain CLI.",
   "homepage": "https://diagcalc.tiagojct.eu/",
   "repository": {

package/script.js

@@ -1,14 +1,20 @@
 document.addEventListener("DOMContentLoaded", () => {
   const core = window.DiagcalcCore;
   const datasetStore = window.DiagcalcDatasets;
+  const feedbackEl = document.getElementById("feedback");
 
   if (!core || !datasetStore) {
+    const missing = [!core && "DiagcalcCore", !datasetStore && "DiagcalcDatasets"].filter(Boolean).join(" and ");
+    console.error(`DIAGCALC: required script(s) failed to load: ${missing}.`);
+    if (feedbackEl) {
+      feedbackEl.textContent = "Calculator failed to load. Refresh the page or check the network tab for missing scripts.";
+      feedbackEl.classList.add("error");
+    }
     return;
   }
 
   const datasets = datasetStore.datasets;
   const form = document.getElementById("inputForm");
-  const feedbackEl = document.getElementById("feedback");
   const resultsEl = document.getElementById("results");
   const datasetSelect = document.getElementById("datasetSelect");
   const resetButton = document.getElementById("resetButton");
@@ -464,7 +470,7 @@ function renderFaganNomogram(canvas, container, data) {
     drawLrLabel(lrPosY, "LR+", lrPositive, warmColor, true);
   }
 
-  if (Number.isFinite(lrNegative) && lrNegative > 0) {
+  if (lrNegative > 0) {
     const postNegY = probToY(postNegative);
     const lrNegY = midpointY(preY, postNegY);
 

package/tui/index.js

@@ -720,7 +720,10 @@ function runTui() {
   resultsBox.key(["pageup"], () => resultsBox.scroll(-10));
   resultsBox.key(["pagedown"], () => resultsBox.scroll(10));
 
-  screen.key(["q", "C-c"], () => {
+  screen.key(["C-c"], () => {
+    process.exit(0);
+  });
+  screen.key(["q"], () => {
     if (!state.modalOpen) {
       process.exit(0);
     }
@@ -821,6 +824,10 @@ function displayValue(value) {
   return Number.isFinite(value) ? String(value) : "-";
 }
 
+function formatPreTest(value) {
+  return Number.isFinite(value) ? core.formatPercentage(value / 100) : "-";
+}
+
 function buildConfusionMatrixBox(input) {
   const tp = displayValue(input.tp).padStart(5);
   const fp = displayValue(input.fp).padStart(5);
@@ -892,7 +899,7 @@ function buildTextExport(state, metrics, validation) {
     "Confusion matrix",
     `  TP ${displayValue(state.input.tp)}   FP ${displayValue(state.input.fp)}`,
     `  FN ${displayValue(state.input.fn)}   TN ${displayValue(state.input.tn)}`,
-    `  Pre-test probability ${displayValue(state.input.preTestProb)}%`,
+    `  Pre-test probability ${formatPreTest(state.input.preTestProb)}`,
     "",
   ];
 
@@ -916,7 +923,7 @@ function buildMarkdownExport(state, metrics, validation) {
     `| Test +         | ${displayValue(state.input.tp)} | ${displayValue(state.input.fp)} |`,
     `| Test -         | ${displayValue(state.input.fn)} | ${displayValue(state.input.tn)} |`,
     "",
-    `Pre-test probability: ${displayValue(state.input.preTestProb)}%`,
+    `Pre-test probability: ${formatPreTest(state.input.preTestProb)}`,
     "",
   ];