From d541ed8c39f618cf6d8c1f7e77896676d4b72a73 Mon Sep 17 00:00:00 2001
From: fosterwei <gongjian.sam@gmail.com>
Date: Mon, 12 Oct 2026 14:02:34 +0000
Subject: [PATCH] Embed each compound's calculator on its record, and link both
 ways

Every compound that has a calculator page now carries the calculator on
its own record too, directly under the dosage chart, with a link to the
full page and a card in Related records. The calculator page already
linked back, so the pair is now joined in both directions and neither is
an orphan.

Placement is deliberate. The outline on all 19 qualifying records puts
the calculator immediately after "dosage chart: studies versus what
circulates", so a reader who has just seen which figures were studied
and which merely circulate is one scroll from working out what a vial
yields, rather than finding the tool in a different section.

The block renders only for a record that qualifies for a calculator
page, by the same rule that decides whether that page exists: finished,
reviewed, and carrying at least two distinct published dose figures.
Fifteen compounds get neither, which is the point.

Calculators.astro gains id, heading and headingLevel props so the one
component can sit inside a compound page under that page's own H2 with
its tool heading demoted to H3, instead of producing two H2s or a copy of
the markup. The arithmetic still has exactly one implementation and one
test suite.

The tests now check every compound that has a calculator page: a link to
it, a calculator section, an output element, and the embedded script
computing the known case. 55 assertions, up from 36. Verified by
removing the link, cutting the section, and breaking the script on a
built page; each exits 1. The first attempt at the section cut used a
regex that never matched, so that fault was not exercised until the cut
was done by index. Worth recording because a test that passed only
because the injection failed would have looked identical to a test that
works.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
---
 research/intents/aod-9604.json         |  1 +
 research/intents/ara-290.json          |  1 +
 research/intents/bpc-157.json          |  1 +
 research/intents/cagrilintide.json     |  1 +
 research/intents/dsip.json             |  1 +
 research/intents/ghrp-6.json           |  1 +
 research/intents/humanin.json          |  1 +
 research/intents/ipamorelin.json       |  1 +
 research/intents/melanotan-ii.json     |  1 +
 research/intents/mots-c.json           |  1 +
 research/intents/retatrutide.json      |  1 +
 research/intents/selank.json           |  1 +
 research/intents/semax.json            |  1 +
 research/intents/ss-31.json            |  1 +
 research/intents/survodutide.json      |  1 +
 research/intents/tb-500.json           |  1 +
 research/intents/tesamorelin.json      |  1 +
 research/intents/tesofensine.json      |  1 +
 research/intents/thymosin-alpha-1.json |  1 +
 scripts/test_calculators.mjs           | 24 ++++++++++++++++++++++++
 src/components/Calculators.astro       | 16 ++++++++++++----
 src/layouts/CompoundV2.astro           | 17 +++++++++++++++--
 22 files changed, 70 insertions(+), 6 deletions(-)

diff --git a/research/intents/aod-9604.json b/research/intents/aod-9604.json
index b665144..ed3e282 100644
--- a/research/intents/aod-9604.json
+++ b/research/intents/aod-9604.json
@@ -530,6 +530,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/ara-290.json b/research/intents/ara-290.json
index 0face7b..f39cc74 100644
--- a/research/intents/ara-290.json
+++ b/research/intents/ara-290.json
@@ -477,6 +477,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/bpc-157.json b/research/intents/bpc-157.json
index b30a685..b09945f 100644
--- a/research/intents/bpc-157.json
+++ b/research/intents/bpc-157.json
@@ -416,6 +416,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/cagrilintide.json b/research/intents/cagrilintide.json
index 8c1f6f8..ebebc5a 100644
--- a/research/intents/cagrilintide.json
+++ b/research/intents/cagrilintide.json
@@ -196,6 +196,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/dsip.json b/research/intents/dsip.json
index 4323ad8..c742bfc 100644
--- a/research/intents/dsip.json
+++ b/research/intents/dsip.json
@@ -397,6 +397,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/ghrp-6.json b/research/intents/ghrp-6.json
index 4855771..0cfa977 100644
--- a/research/intents/ghrp-6.json
+++ b/research/intents/ghrp-6.json
@@ -544,6 +544,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/humanin.json b/research/intents/humanin.json
index eed9be9..e27d614 100644
--- a/research/intents/humanin.json
+++ b/research/intents/humanin.json
@@ -463,6 +463,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/ipamorelin.json b/research/intents/ipamorelin.json
index 269120e..cd2efb0 100644
--- a/research/intents/ipamorelin.json
+++ b/research/intents/ipamorelin.json
@@ -304,6 +304,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/melanotan-ii.json b/research/intents/melanotan-ii.json
index 2db0058..f3fa55f 100644
--- a/research/intents/melanotan-ii.json
+++ b/research/intents/melanotan-ii.json
@@ -543,6 +543,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/mots-c.json b/research/intents/mots-c.json
index 7c5fb5c..e4a5168 100644
--- a/research/intents/mots-c.json
+++ b/research/intents/mots-c.json
@@ -209,6 +209,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/retatrutide.json b/research/intents/retatrutide.json
index 6731552..1a7e458 100644
--- a/research/intents/retatrutide.json
+++ b/research/intents/retatrutide.json
@@ -295,6 +295,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "escalation",
     "adverse",
     "who",
diff --git a/research/intents/selank.json b/research/intents/selank.json
index eb46891..c72a8fe 100644
--- a/research/intents/selank.json
+++ b/research/intents/selank.json
@@ -194,6 +194,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/semax.json b/research/intents/semax.json
index 63c3dd6..a11e956 100644
--- a/research/intents/semax.json
+++ b/research/intents/semax.json
@@ -209,6 +209,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/ss-31.json b/research/intents/ss-31.json
index d406129..6fd4a2a 100644
--- a/research/intents/ss-31.json
+++ b/research/intents/ss-31.json
@@ -484,6 +484,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/survodutide.json b/research/intents/survodutide.json
index 870c693..cacb67e 100644
--- a/research/intents/survodutide.json
+++ b/research/intents/survodutide.json
@@ -507,6 +507,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/tb-500.json b/research/intents/tb-500.json
index 2f6fb45..c3b6a7a 100644
--- a/research/intents/tb-500.json
+++ b/research/intents/tb-500.json
@@ -210,6 +210,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/tesamorelin.json b/research/intents/tesamorelin.json
index b4b53cb..58cf87c 100644
--- a/research/intents/tesamorelin.json
+++ b/research/intents/tesamorelin.json
@@ -241,6 +241,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/tesofensine.json b/research/intents/tesofensine.json
index 89f8e81..4fed07d 100644
--- a/research/intents/tesofensine.json
+++ b/research/intents/tesofensine.json
@@ -487,6 +487,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/research/intents/thymosin-alpha-1.json b/research/intents/thymosin-alpha-1.json
index 6a358d0..195bfd2 100644
--- a/research/intents/thymosin-alpha-1.json
+++ b/research/intents/thymosin-alpha-1.json
@@ -474,6 +474,7 @@
     "evidence",
     "doses",
     "dosage-chart",
+    "calculator",
     "adverse",
     "who",
     "biomarkers",
diff --git a/scripts/test_calculators.mjs b/scripts/test_calculators.mjs
index ea04e4e..b76fa51 100644
--- a/scripts/test_calculators.mjs
+++ b/scripts/test_calculators.mjs
@@ -139,6 +139,30 @@ if (fs.existsSync(CALC_DIR)) {
   }
 }
 
+// Each compound that has a calculator page also embeds the calculator on its
+// own record and links to the page. The two must agree: a calculator page with
+// no inbound link from its compound is an orphan, and a compound page whose
+// embedded tool does not compute is the same defect as the empty tools were.
+if (fs.existsSync(CALC_DIR)) {
+  for (const slug of fs.readdirSync(CALC_DIR, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name)) {
+    const file = path.join(DIST, 'compounds', slug, 'index.html');
+    if (!fs.existsSync(file)) { fails.push(`compounds/${slug}: no compound page for calculator page`); continue; }
+    const html = fs.readFileSync(file, 'utf8');
+    if (!html.includes(`href="/calculators/${slug}"`)) fails.push(`compounds/${slug}: no link to /calculators/${slug}`);
+    if (!/<section id="calculator">/.test(html)) { fails.push(`compounds/${slug}: no calculator section`); continue; }
+    if (!/id="r-out"/.test(html)) { fails.push(`compounds/${slug}: calculator section has no output element`); continue; }
+    const m = html.match(/<script type="module">([\s\S]*?)<\/script>/i);
+    if (!m) { fails.push(`compounds/${slug}: calculator present but no module script`); continue; }
+    const els = {};
+    for (const [id, v] of Object.entries({ 'r-mass': 5, 'r-vol': 2, 'r-want': 250, 'r-scale': 100 })) els[id] = { value: String(v), addEventListener() {} };
+    const out = { textContent: '' }; els['r-out'] = out;
+    globalThis.document = { getElementById: (id) => els[id] ?? null };
+    new Function(m[1])();
+    if (!out.textContent.includes('10 units on a U-100')) fails.push(`compounds/${slug}: embedded calculator did not compute`);
+    else pass++;
+  }
+}
+
 if (fails.length) {
   console.error(`calculator tests: ${pass} passed, ${fails.length} FAILED\n`);
   for (const f of fails) console.error(`  ${f}\n`);
diff --git a/src/components/Calculators.astro b/src/components/Calculators.astro
index 5aab7aa..f3d3c9b 100644
--- a/src/components/Calculators.astro
+++ b/src/components/Calculators.astro
@@ -8,12 +8,20 @@
 // Nothing here accepts a body weight, an age or a condition, and nothing
 // returns a dose. Each tool states its formula above the inputs, so the
 // arithmetic can be checked by hand.
-interface Props { slug: string }
-const { slug } = Astro.props;
+interface Props {
+  slug: string;
+  /** The reconstitution tool's section id and heading, overridable so the same
+   *  component can sit inside a compound page under that page's own H2. */
+  id?: string;
+  heading?: string;
+  headingLevel?: 2 | 3;
+}
+const { slug, id = 'calc-recon', heading = 'Work out concentration and what to draw', headingLevel = 2 } = Astro.props;
+const H = headingLevel === 3 ? 'h3' : 'h2';
 ---
 {slug === 'reconstitution-calculator' && (
-  <section id="calc-recon">
-    <h2>Work out concentration and what to draw</h2>
+  <section id={id}>
+    <H>{heading}</H>
     <p class="prose">Two divisions, both shown. <b>Concentration</b> = mass in the vial &divide; diluent volume. <b>Volume to draw</b> = mass you want &divide; that concentration. Syringe units are that volume &times; the units per millilitre on your syringe's own scale.</p>
     <form class="calc" onsubmit="return false">
       <label for="r-mass">Mass in vial (mg)</label>
diff --git a/src/layouts/CompoundV2.astro b/src/layouts/CompoundV2.astro
index 26fe909..d4796c8 100644
--- a/src/layouts/CompoundV2.astro
+++ b/src/layouts/CompoundV2.astro
@@ -28,6 +28,8 @@ import LandscapeTable from '../components/v2/LandscapeTable.astro';
 import HumanTrials from '../components/v2/HumanTrials.astro';
 import CombinationEvidence from '../components/v2/CombinationEvidence.astro';
 import EditorialSection from '../components/v2/EditorialSection.astro';
+import Calculators from '../components/Calculators.astro';
+import { qualifies as hasCalculator } from '../lib/calculators';
 import { entityLinker } from '../lib/entities';
 import ReconstitutionMath from '../components/shared/ReconstitutionMath.astro';
 import EquipmentInStudies from '../components/shared/EquipmentInStudies.astro';
@@ -120,7 +122,7 @@ const ledeFor = (f: string) => [boundaryFor(intent, f), defaultLedes[f]].filter(
 // claims but with mapped demand renders as an explicit absence statement.
 type Guide = { id: string; heading: string; lede?: string; html: string; pending?: boolean };
 const guide: Guide[] = ((d as any).guide ?? []) as Guide[];
-type Block = { id: string; kind: 'human' | 'table' | 'landscape' | 'claims' | 'absence' | 'method' | 'compare' | 'combination' | 'regulatory' | 'open' | 'faq' | 'guide'; field?: string; label: string; group: string; guide?: Guide };
+type Block = { id: string; kind: 'human' | 'table' | 'landscape' | 'claims' | 'absence' | 'method' | 'calculator' | 'compare' | 'combination' | 'regulatory' | 'open' | 'faq' | 'guide'; field?: string; label: string; group: string; guide?: Guide };
 // Links the first mention of each other record in this page's own prose.
 const linkEntities = entityLinker([d.slug], 10);
 const blocks: Block[] = [];
@@ -133,6 +135,11 @@ for (const [f, id, label] of evidence) {
   if (has(f)) blocks.push({ id, kind: 'claims', field: f, label: headingFor(intent, f, label), group: 'Evidence' });
   else if (queriesFor(intent, f).some((q) => q.policy !== 'redirect')) blocks.push({ id, kind: 'absence', field: f, label: headingFor(intent, f, label), group: 'Evidence' });
 }
+// The compound's own calculator, only where it has one: a record qualifies when
+// it is finished and carries at least two distinct published dose figures, the
+// same rule that decides whether /calculators/<slug> exists at all.
+const calculatorHere = hasCalculator(entry);
+if (calculatorHere) blocks.push({ id: 'calculator', kind: 'calculator', label: headingFor(intent, 'calculator', `${d.preferred_name} dosage calculator`), group: 'Evidence' });
 if (hasAnyEvidence) blocks.push({ id: 'method', kind: 'method', label: 'Method notes', group: 'Method' });
 if (peerEntries.length > 0) blocks.push({ id: 'compare', kind: 'compare', label: headingFor(intent, 'compare', 'Other compounds in its class'), group: 'Context' });
 if (inStacks.length > 0) blocks.push({ id: 'combination', kind: 'combination', label: headingFor(intent, 'combination', 'Studied in combination'), group: 'Context' });
@@ -228,6 +235,11 @@ const toc = [secs[0], secs[1], secs[2], ...tocBody, ...secs.filter((s) => ['sour
                 <EvidenceTable rows={A.evidence_table} />
               </section>
             );
+            case 'calculator': return (
+              <section id="calculator"><div><h2>{b.label}</h2><p class="lede">Enter a vial and a dose and it returns the concentration, the volume and the units on your syringe. It converts the numbers you give it and suggests none. The doses studies of {d.preferred_name} actually used, with a units chart per vial size, are on the <a href={`/calculators/${d.slug}`}>full {d.preferred_name} calculator page</a>.</p></div>
+                <Calculators slug="reconstitution-calculator" id="calculator-tool" heading="Work out concentration and what to draw" headingLevel={3} />
+              </section>
+            );
             case 'claims': return (
               <section id={b.id}><div><h2>{b.label}</h2><p class="lede">{ledeFor(b.field!)}</p></div><ClaimCards claims={A[b.field!]} sources={d.sources} />{b.field === 'weight_normalized_doses' && <WeightCaveat />}</section>
             );
@@ -260,8 +272,9 @@ const toc = [secs[0], secs[1], secs[2], ...tocBody, ...secs.filter((s) => ['sour
 
         {d.sources.length > 0 && <section id="sources"><div><h2>Sources</h2><p class="lede">Full citations. Every claim above links to one of these by its id.</p></div><Sources sources={d.sources} /></section>}
         <section id="card"><h2>Reference card</h2><RefCard record={d} reg={reg} path={path} /></section>
-        {(inStacks.length > 0 || inComparisons.length > 0 || peerEntries.length > 0) && (
+        {(inStacks.length > 0 || inComparisons.length > 0 || peerEntries.length > 0 || calculatorHere) && (
           <section id="related"><h2>Related records</h2><ul class="cards">
+            {calculatorHere && <li><a href={`/calculators/${d.slug}`}>{d.preferred_name} dosage calculator</a><div class="sub">Units, mg and reconstitution, with the doses studies used</div></li>}
             {peerEntries.map((p) => <li><a href={`/compounds/${p.data.slug}`}>{p.data.preferred_name}</a><div class="sub">Peer compound</div></li>)}
             {inStacks.map((s) => <li><a href={`/stacks/${s.slug}`}>{s.name}</a><div class="sub">Stack · wave {s.pilot_wave}</div></li>)}
             {inComparisons.map((c) => <li><a href={`/compare/${c.slug}`}>{c.sides.join(' vs ')}</a><div class="sub">Comparison · wave {c.pilot_wave}</div></li>)}