@classytic/stage 0.1.0 → 0.3.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Classytic
+Copyright (c) 2026 Classytic LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -3,7 +3,7 @@
 **Domain‑neutral visual primitive engine for the web.** Declarative SVG diagram/math
 primitives, draggable handles, a math↔pixel coordinate system, theming, a parametric
 asset/glyph kit, a serializable `SceneDoc` graph (resolver + command/undo), and a
-`LessonDoc` sequence engine. Reactive, web‑native, SSR‑safe, and agent‑drivable — the
+stepped‑lesson sequence engine (`StepSpec`). Reactive, web‑native, SSR‑safe, and agent‑drivable — the
 render foundation under [`@classytic/labs`](https://github.com/classytic/labs).
 
 ```bash
@@ -14,7 +14,7 @@ npm i @classytic/stage react react-dom
 
 Everything is also re‑exported from the root for convenience, but prefer subpaths so
 your bundle pulls only what it uses (ESM, per‑file emit; `sideEffects` are scoped to
-`**/*.css` + `**/assets/**`, so JS tree‑shakes while styles/assets are preserved):
+`**/*.css`, so JavaScript tree-shakes while the shared stylesheet is preserved):
 
 | Subpath | What's in it |
 |---|---|
@@ -27,7 +27,7 @@ your bundle pulls only what it uses (ESM, per‑file emit; `sideEffects` are sco
 | `@classytic/stage/builder` | `Editor`, `SceneBuilder`, `Palette`, construction `*_TOOLS` |
 | `@classytic/stage/assets` | `StageAssetDefs` + the glyph kit (`XBlockGlyph`, `WeightGlyph`, `BucketGlyph`, `HangerHook`) |
 | `@classytic/stage/math` | dependency‑free expression engine (`compileExpr`, `differentiate`, `toLatex`…) |
-| `@classytic/stage/lesson` | `LessonProvider`, `useLessonProgress`, `LessonStepScope` (sequence + gating + progress) |
+| `@classytic/stage/steps` | `StepProgressProvider`, `useStepProgress`, `StepScope` (step sequence + gating + progress) |
 | `@classytic/stage/styles.css` | theme tokens + control‑kit CSS (import once in global CSS) |
 
 ## Quick start
@@ -63,3 +63,7 @@ export function Demo() {
 ## License
 
 MIT
+
+## Trademark
+
+MIT-licensed code. "Classytic"/"arc" names + logos are trademarks of Classytic LLC — see [TRADEMARK.md](TRADEMARK.md).

package/dist/assets/index.mjs

@@ -1,5 +1,4 @@
 import { StageAssetDefs } from "./kit/svg-defs.mjs";
 import { BucketGlyph, HangerHook, WeightGlyph, XBlockGlyph } from "./kit/glyphs.mjs";
-import "./kit/index.mjs";
 
 export { BucketGlyph, HangerHook, StageAssetDefs, WeightGlyph, XBlockGlyph };

package/dist/assets/kit/glyphs.d.mts

@@ -8,7 +8,7 @@ interface GlyphBox {
   hpx: number;
   label: string;
 }
-/** The UNKNOWN — a crisp rounded tile with an italic label (e.g. "2x"). */
+/** The UNKNOWN, a crisp rounded tile with an italic label (e.g. "2x"). */
 declare function XBlockGlyph({
   cx,
   top,
@@ -16,7 +16,7 @@ declare function XBlockGlyph({
   hpx,
   label
 }: GlyphBox): ReactNode;
-/** A container of UNKNOWN amount — a pail, brand-colored (it IS an unknown, like
+/** A container of UNKNOWN amount, a pail, brand-colored (it IS an unknown, like
  *  the tile), labelled "?" until revealed. Built with real form: one light
  *  direction (top-left), 2-tone shading for volume (gradient body + a soft
  *  right-side shadow + a left specular streak), a rim with visible thickness
@@ -33,13 +33,13 @@ interface HangerHookProps {
   /** Attach point on the beam/arm (pixels). */
   topX: number;
   topY: number;
-  /** Attach point on the load — the top-centre of the glyph it carries (pixels). */
+  /** Attach point on the load, the top-centre of the glyph it carries (pixels). */
   botX: number;
   botY: number;
 }
 /**
  * A suspension: a thin eye on the beam, a taut thread, and an S-hook that grips
- * the load — the realistic way a weight hangs from an arm (replaces the old
+ * the load, the realistic way a weight hangs from an arm (replaces the old
  * bare "line + dot"). Pure pixel glyph: callers project math→px first. Layered
  * edge/metal/sheen strokes match the beam's metallic read.
  */
@@ -49,7 +49,7 @@ declare function HangerHook({
   botX,
   botY
 }: HangerHookProps): ReactNode;
-/** A KNOWN value — a clean flat coin with the number. */
+/** A KNOWN value, a clean flat coin with the number. */
 declare function WeightGlyph({
   cx,
   top,

package/dist/assets/kit/glyphs.mjs

@@ -3,7 +3,7 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/assets/kit/glyphs.tsx
-/** The UNKNOWN — a crisp rounded tile with an italic label (e.g. "2x"). */
+/** The UNKNOWN, a crisp rounded tile with an italic label (e.g. "2x"). */
 function XBlockGlyph({ cx, top, wpx, hpx, label }) {
 	const s = Math.min(wpx, hpx);
 	const x0 = cx - s / 2;
@@ -50,7 +50,7 @@ function XBlockGlyph({ cx, top, wpx, hpx, label }) {
 		})
 	] });
 }
-/** A container of UNKNOWN amount — a pail, brand-colored (it IS an unknown, like
+/** A container of UNKNOWN amount, a pail, brand-colored (it IS an unknown, like
 *  the tile), labelled "?" until revealed. Built with real form: one light
 *  direction (top-left), 2-tone shading for volume (gradient body + a soft
 *  right-side shadow + a left specular streak), a rim with visible thickness
@@ -156,7 +156,7 @@ function BucketGlyph({ cx, top, wpx, hpx, label }) {
 }
 /**
 * A suspension: a thin eye on the beam, a taut thread, and an S-hook that grips
-* the load — the realistic way a weight hangs from an arm (replaces the old
+* the load, the realistic way a weight hangs from an arm (replaces the old
 * bare "line + dot"). Pure pixel glyph: callers project math→px first. Layered
 * edge/metal/sheen strokes match the beam's metallic read.
 */
@@ -210,7 +210,7 @@ function HangerHook({ topX, topY, botX, botY }) {
 		})
 	] });
 }
-/** A KNOWN value — a clean flat coin with the number. */
+/** A KNOWN value, a clean flat coin with the number. */
 function WeightGlyph({ cx, top, wpx, hpx, label }) {
 	const r = Math.min(wpx, hpx) / 2;
 	const cy = top + r;

package/dist/builder/Palette.mjs

@@ -4,96 +4,57 @@ import { ToolIcon } from "./icons.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/builder/Palette.tsx
-const btn = (active) => ({
-	display: "inline-flex",
-	alignItems: "center",
-	gap: 6,
-	padding: "6px 10px",
-	borderRadius: 8,
-	fontSize: 13,
-	fontWeight: 600,
-	cursor: "pointer",
-	color: active ? "var(--stage-bg)" : "var(--stage-fg)",
-	background: active ? "var(--stage-accent)" : "transparent",
-	border: `1px solid ${active ? "var(--stage-accent)" : "var(--stage-muted)"}`
-});
-const iconBtn = (disabled) => ({
-	display: "inline-flex",
-	alignItems: "center",
-	gap: 6,
-	padding: "6px 10px",
-	borderRadius: 8,
-	fontSize: 13,
-	fontWeight: 600,
-	cursor: disabled ? "not-allowed" : "pointer",
-	opacity: disabled ? .4 : 1,
-	color: "var(--stage-fg)",
-	background: "transparent",
-	border: "1px solid var(--stage-muted)"
-});
 function Palette({ tools, activeTool, onSelect, onUndo, onRedo, canUndo, canRedo, onClear, onSave, hint }) {
-	return /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsxs("div", {
-		role: "toolbar",
-		"aria-label": "construction tools",
-		style: {
-			display: "flex",
-			flexWrap: "wrap",
-			gap: 6,
-			alignItems: "center"
-		},
-		children: [
-			tools.map((t) => /* @__PURE__ */ jsxs("button", {
-				type: "button",
-				"aria-pressed": activeTool === t.id,
-				onClick: () => onSelect(t.id),
-				style: btn(activeTool === t.id),
-				children: [/* @__PURE__ */ jsx(ToolIcon, { name: t.icon }), t.label]
-			}, t.id)),
-			/* @__PURE__ */ jsx("span", { style: {
-				width: 1,
-				alignSelf: "stretch",
-				background: "var(--stage-muted)",
-				margin: "0 4px"
-			} }),
-			/* @__PURE__ */ jsxs("button", {
-				type: "button",
-				onClick: onUndo,
-				disabled: !canUndo,
-				style: iconBtn(!canUndo),
-				children: [/* @__PURE__ */ jsx(ToolIcon, { name: "undo" }), "Undo"]
-			}),
-			/* @__PURE__ */ jsxs("button", {
-				type: "button",
-				onClick: onRedo,
-				disabled: !canRedo,
-				style: iconBtn(!canRedo),
-				children: [/* @__PURE__ */ jsx(ToolIcon, { name: "redo" }), "Redo"]
-			}),
-			/* @__PURE__ */ jsx("button", {
-				type: "button",
-				onClick: onClear,
-				style: iconBtn(false),
-				children: "Clear"
-			}),
-			onSave && /* @__PURE__ */ jsx("button", {
-				type: "button",
-				onClick: onSave,
-				style: {
-					...iconBtn(false),
-					color: "var(--stage-good)",
-					borderColor: "var(--stage-good)"
-				},
-				children: "Save"
-			})
-		]
-	}), /* @__PURE__ */ jsx("p", {
-		style: {
-			fontSize: 12,
-			opacity: .7,
-			margin: "6px 2px 0"
-		},
-		children: hint
-	})] });
+	return /* @__PURE__ */ jsxs("div", {
+		className: "stage-palette",
+		children: [/* @__PURE__ */ jsxs("div", {
+			role: "toolbar",
+			"aria-label": "construction tools",
+			className: "stage-palette__toolbar",
+			children: [
+				tools.map((t) => /* @__PURE__ */ jsxs("button", {
+					type: "button",
+					"aria-pressed": activeTool === t.id,
+					onClick: () => onSelect(t.id),
+					className: "stage-tool-button",
+					children: [/* @__PURE__ */ jsx(ToolIcon, { name: t.icon }), t.label]
+				}, t.id)),
+				/* @__PURE__ */ jsx("span", {
+					className: "stage-palette__divider",
+					"aria-hidden": "true"
+				}),
+				/* @__PURE__ */ jsxs("button", {
+					type: "button",
+					onClick: onUndo,
+					disabled: !canUndo,
+					className: "stage-tool-button",
+					children: [/* @__PURE__ */ jsx(ToolIcon, { name: "undo" }), "Undo"]
+				}),
+				/* @__PURE__ */ jsxs("button", {
+					type: "button",
+					onClick: onRedo,
+					disabled: !canRedo,
+					className: "stage-tool-button",
+					children: [/* @__PURE__ */ jsx(ToolIcon, { name: "redo" }), "Redo"]
+				}),
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: onClear,
+					className: "stage-tool-button",
+					children: "Clear"
+				}),
+				onSave && /* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: onSave,
+					className: "stage-tool-button stage-tool-button--save",
+					children: "Save"
+				})
+			]
+		}), /* @__PURE__ */ jsx("p", {
+			className: "stage-palette__hint",
+			children: hint
+		})]
+	});
 }
 
 //#endregion

package/dist/builder/SceneBuilder.mjs

@@ -14,9 +14,9 @@ import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/builder/SceneBuilder.tsx
 /**
-* <SceneBuilder> — the click-to-construct authoring surface. Pick a tool, click
+* <SceneBuilder>, the click-to-construct authoring surface. Pick a tool, click
 * the canvas: every action funnels through the Editor command stack (undo/redo +
-* the agent API). Output is a SceneDoc (onSave) — the same JSON the player
+* the agent API). Output is a SceneDoc (onSave), the same JSON the player
 * renders and the DB stores. Free points drag only in Select mode, so clicks in
 * other tools go to the tool, not a drag.
 */
@@ -149,12 +149,7 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 		}, `pend-${id}`) : null;
 	}), [pending, resolved]);
 	return /* @__PURE__ */ jsxs("div", {
-		className: "not-prose",
-		style: {
-			display: "flex",
-			flexDirection: "column",
-			gap: 10
-		},
+		className: "not-prose stage-builder",
 		children: [
 			/* @__PURE__ */ jsx(Palette, {
 				tools: toolSet,
@@ -184,21 +179,11 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 				]
 			}),
 			authoring && scalars.length > 0 && /* @__PURE__ */ jsx("div", {
-				style: {
-					display: "flex",
-					flexWrap: "wrap",
-					gap: 14,
-					padding: "2px",
-					fontSize: 13
-				},
+				className: "stage-builder__scalars",
 				children: scalars.map((el) => {
 					const f = el.free;
 					return /* @__PURE__ */ jsxs("label", {
-						style: {
-							display: "inline-flex",
-							alignItems: "center",
-							gap: 6
-						},
+						className: "stage-builder__scalar",
 						children: [
 							/* @__PURE__ */ jsx("strong", { children: el.label ?? el.id }),
 							/* @__PURE__ */ jsx("input", {
@@ -214,10 +199,7 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 								})
 							}),
 							/* @__PURE__ */ jsx("span", {
-								style: {
-									fontVariantNumeric: "tabular-nums",
-									minWidth: 24
-								},
+								className: "stage-builder__scalar-value",
 								children: f.value
 							})
 						]
@@ -225,30 +207,12 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 				})
 			}),
 			authoring && /* @__PURE__ */ jsxs("details", {
-				style: {
-					fontSize: 13,
-					border: "1px solid var(--stage-muted)",
-					borderRadius: 8,
-					padding: "6px 10px"
-				},
-				children: [/* @__PURE__ */ jsx("summary", {
-					style: {
-						cursor: "pointer",
-						fontWeight: 600
-					},
-					children: "Pedagogy — objectives · hints · difficulty"
-				}), /* @__PURE__ */ jsxs("div", {
-					style: {
-						display: "grid",
-						gap: 8,
-						marginTop: 8
-					},
+				className: "stage-builder__pedagogy",
+				children: [/* @__PURE__ */ jsx("summary", { children: "Pedagogy, objectives · hints · difficulty" }), /* @__PURE__ */ jsxs("div", {
+					className: "stage-builder__pedagogy-fields",
 					children: [
 						/* @__PURE__ */ jsxs("label", {
-							style: {
-								display: "grid",
-								gap: 3
-							},
+							className: "stage-builder__field-label",
 							children: ["Objectives (one per line)", /* @__PURE__ */ jsx("textarea", {
 								rows: 2,
 								value: (pedagogy.objectives ?? []).join("\n"),
@@ -256,14 +220,11 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 									...p,
 									objectives: splitLines(e.currentTarget.value)
 								})),
-								style: FIELD
+								className: "stage-builder__field"
 							})]
 						}),
 						/* @__PURE__ */ jsxs("label", {
-							style: {
-								display: "grid",
-								gap: 3
-							},
+							className: "stage-builder__field-label",
 							children: ["Hints (one per line)", /* @__PURE__ */ jsx("textarea", {
 								rows: 2,
 								value: (pedagogy.hints ?? []).join("\n"),
@@ -271,42 +232,32 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 									...p,
 									hints: splitLines(e.currentTarget.value)
 								})),
-								style: FIELD
+								className: "stage-builder__field"
 							})]
 						}),
 						/* @__PURE__ */ jsxs("label", {
-							style: {
-								display: "grid",
-								gap: 3
-							},
+							className: "stage-builder__field-label",
 							children: ["Success criteria", /* @__PURE__ */ jsx("input", {
 								value: pedagogy.successCriteria ?? "",
 								onChange: (e) => setPedagogy((p) => ({
 									...p,
 									successCriteria: e.currentTarget.value || void 0
 								})),
-								style: FIELD
+								className: "stage-builder__field"
 							})]
 						}),
 						/* @__PURE__ */ jsxs("label", {
-							style: {
-								display: "inline-flex",
-								alignItems: "center",
-								gap: 8
-							},
+							className: "stage-builder__difficulty",
 							children: ["Difficulty", /* @__PURE__ */ jsxs("select", {
 								value: pedagogy.difficulty ?? "",
 								onChange: (e) => setPedagogy((p) => ({
 									...p,
 									difficulty: e.currentTarget.value ? Number(e.currentTarget.value) : void 0
 								})),
-								style: {
-									...FIELD,
-									width: "auto"
-								},
+								className: "stage-builder__field stage-builder__field--select",
 								children: [/* @__PURE__ */ jsx("option", {
 									value: "",
-									children: "—"
+									children: ", "
 								}), [
 									1,
 									2,
@@ -325,15 +276,6 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 		]
 	});
 }
-const FIELD = {
-	width: "100%",
-	border: "1px solid var(--stage-muted)",
-	borderRadius: 6,
-	padding: "4px 8px",
-	background: "transparent",
-	color: "inherit",
-	font: "inherit"
-};
 const splitLines = (s) => s.split("\n").map((x) => x.trim()).filter(Boolean);
 
 //#endregion

package/dist/builder/editor.d.mts

@@ -21,7 +21,8 @@ declare class Editor {
   getResolved(): Resolved;
   subscribe(fn: () => void): () => void;
   private emit;
-  /** Apply a command. The ONLY mutation entry point. */
+  /** Apply a command. The ONLY mutation entry point. Validates first: an invalid command (bad
+   *  id, dangling binding, missing target) is REJECTED with a reason and the doc is untouched. */
   dispatch(cmd: Command, opts?: DispatchOpts): CommandResult;
   /** Group boundary marker (label-only in this impl; batch commands group atomically). */
   mark(_label?: string): void;

package/dist/builder/editor.mjs

@@ -1,12 +1,12 @@
 'use client';
 
 import { resolve } from "../scene/resolve.mjs";
-import { applyCommand, inverse } from "../scene/commands.mjs";
+import { applyCommand, createdIds, inverse, validateCommand } from "../scene/commands.mjs";
 import { useEffect, useReducer, useRef, useState } from "react";
 
 //#region src/builder/editor.ts
 /**
-* Editor — the single funnel for ALL scene mutations (builder tools, agents,
+* Editor, the single funnel for ALL scene mutations (builder tools, agents,
 * undo/redo, the control-surface bridge). Commands ARE the agent action API:
 * dispatch(cmd) is exactly what a human tool, a voice agent, and an undo all call.
 * Drag is an ephemeral overlay layer; updateDrag writes no command (no undo, no
@@ -48,8 +48,14 @@ var Editor = class {
 	emit() {
 		this.listeners.forEach((l) => l());
 	}
-	/** Apply a command. The ONLY mutation entry point. */
+	/** Apply a command. The ONLY mutation entry point. Validates first: an invalid command (bad
+	*  id, dangling binding, missing target) is REJECTED with a reason and the doc is untouched. */
 	dispatch(cmd, opts = {}) {
+		const error = validateCommand(this.doc, cmd);
+		if (error) return {
+			ok: false,
+			error
+		};
 		const inv = inverse(cmd, this.doc);
 		this.doc = applyCommand(this.doc, cmd);
 		if (opts.history !== "ignore") {
@@ -60,7 +66,11 @@ var Editor = class {
 			this.redoStack = [];
 		}
 		this.emit();
-		return { ok: true };
+		const ids = createdIds(cmd);
+		return ids.length ? {
+			ok: true,
+			createdIds: ids
+		} : { ok: true };
 	}
 	/** Group boundary marker (label-only in this impl; batch commands group atomically). */
 	mark(_label) {}

package/dist/builder/tools.d.mts

@@ -36,7 +36,7 @@ declare const MIDPOINT: Tool;
 declare const INTERSECT: Tool;
 declare const MEASURE: Tool;
 declare const DELETE: Tool;
-/** A free scalar parameter — appears as a live slider in the authoring strip. */
+/** A free scalar parameter, appears as a live slider in the authoring strip. */
 declare const SCALAR: Tool;
 /** A free text note placed in the scene. */
 declare const NOTE: Tool;

package/dist/builder/tools.mjs

@@ -224,7 +224,7 @@ const DELETE = {
 		});
 	}
 };
-/** A free scalar parameter — appears as a live slider in the authoring strip. */
+/** A free scalar parameter, appears as a live slider in the authoring strip. */
 const SCALAR = {
 	id: "scalar",
 	icon: "scalar",

package/dist/chem/index.d.mts

@@ -1,6 +1,6 @@
 //#region src/chem/index.d.ts
 /**
- * `chem` — acid–base / pH AND electrochemistry / Nernst, as a PURE kernel (no
+ * `chem`, acid–base / pH AND electrochemistry / Nernst, as a PURE kernel (no
  * React, no pixels). The engine behind titration curves, pH problems, and galvanic
  * cells.
  *
@@ -11,8 +11,8 @@
  *
  * where n_a is the acid initially present, n_b the strong base added, V the total
  * volume. A strong acid is just the K_a → ∞ limit (fully dissociated). Solving the
- * balance (monotonic in h → bisection) is robust everywhere — initial point, buffer
- * region, equivalence, and past it — with no piecewise approximations to get wrong.
+ * balance (monotonic in h → bisection) is robust everywhere, initial point, buffer
+ * region, equivalence, and past it, with no piecewise approximations to get wrong.
  *
  * Concentrations in mol/L, volumes in litres. Currently models an ACID analyte
  * titrated by a STRONG BASE (covers strong-acid and weak-acid curves).
@@ -81,7 +81,7 @@ interface CellResult {
 declare function galvanicCell(x: HalfCell, y: HalfCell, T?: number): CellResult;
 /** Arrhenius rate constant k = A·e^(−Ea/RT). */
 declare function arrhenius(A: number, Ea: number, T: number): number;
-/** Ratio k(T)/k(Tref) at fixed Ea — the stable way to scale a rate without a raw A. */
+/** Ratio k(T)/k(Tref) at fixed Ea, the stable way to scale a rate without a raw A. */
 declare function arrheniusRatio(Ea: number, T: number, Tref?: number): number;
 /** Fraction of molecules with energy ≥ Ea (Boltzmann) ≈ e^(−Ea/RT). */
 declare function fractionAboveEa(Ea: number, T: number): number;
@@ -94,7 +94,7 @@ interface StoichSpecies {
   name: string;
   /** Stoichiometric coefficient in the balanced equation. */
   coeff: number;
-  /** Molar mass, g/mol (optional — enables grams in the result). */
+  /** Molar mass, g/mol (optional, enables grams in the result). */
   molarMass?: number;
 }
 interface StoichResult {

package/dist/chem/index.mjs

@@ -1,6 +1,6 @@
 //#region src/chem/index.ts
 /**
-* `chem` — acid–base / pH AND electrochemistry / Nernst, as a PURE kernel (no
+* `chem`, acid–base / pH AND electrochemistry / Nernst, as a PURE kernel (no
 * React, no pixels). The engine behind titration curves, pH problems, and galvanic
 * cells.
 *
@@ -11,8 +11,8 @@
 *
 * where n_a is the acid initially present, n_b the strong base added, V the total
 * volume. A strong acid is just the K_a → ∞ limit (fully dissociated). Solving the
-* balance (monotonic in h → bisection) is robust everywhere — initial point, buffer
-* region, equivalence, and past it — with no piecewise approximations to get wrong.
+* balance (monotonic in h → bisection) is robust everywhere, initial point, buffer
+* region, equivalence, and past it, with no piecewise approximations to get wrong.
 *
 * Concentrations in mol/L, volumes in litres. Currently models an ACID analyte
 * titrated by a STRONG BASE (covers strong-acid and weak-acid curves).
@@ -90,7 +90,7 @@ function galvanicCell(x, y, T = T_STD) {
 function arrhenius(A, Ea, T) {
 	return A * Math.exp(-Ea / (R * T));
 }
-/** Ratio k(T)/k(Tref) at fixed Ea — the stable way to scale a rate without a raw A. */
+/** Ratio k(T)/k(Tref) at fixed Ea, the stable way to scale a rate without a raw A. */
 function arrheniusRatio(Ea, T, Tref = T_STD) {
 	return Math.exp(-(Ea / R) * (1 / T - 1 / Tref));
 }