tonus 0.5.0 → 0.6.1

package/BIBLIOGRAPHY.md

@@ -126,6 +126,12 @@ doctrine tables, and the references behind them. Code cites by bracketed key
   shades) and III with the Canobic Inscription (c. 150).** The tetrachord
   genera for the tuning presets; the Greater Perfect System tone assignments
   and aspect–consonance mapping for the doctrina.
+- `ptolemy-tetrabiblos` — **Ptolemy. _Tetrabiblos_ I.17 (the domiciles) and
+  I.19 (the exaltations) (c. 150).** The rulerships and the triplicity and
+  quadruplicity classifications, transmitted whole through the medieval Latin
+  tradition and uncontested across sources; the ground of the zodiac doctrine
+  table. The exaltation degrees it gives (the Sun at 19° Arietis and the rest)
+  are not carried — the sign is the resolution anything here reads.
 - `schulter-harmony` — **Schulter, Margo. Medieval Music & Arts Foundation
   harmony FAQs:** "Pythagorean Tuning and Medieval Polyphony"
   (<https://www.medieval.org/emfaq/harmony/pyth.html>) and "Hexachords,

package/CHANGELOG.md

@@ -4,6 +4,72 @@ All notable changes to tonus. Newest first.
 
 ## Unreleased
 
+## 0.6.0 — 2026-08-16
+
+The zodiac learns what it means, and the hand stops sitting on its own floor.
+
+### Added
+
+- **`ZODIACA` — the doctrine of the twelve signs.** `caelum` answers WHERE a
+  body is; this answers what a medieval reader brought to that position: the
+  element and its Galenic humor, the quality, the ruling and exalted planets,
+  and the member of the zodiac man the sign governs. `ZODIACA[body.zodiac]` is
+  the join, so a sky and its meaning are one lookup apart.
+
+  Deliberately no dates. When the Sun enters a sign is the ephemeris's business
+  and moves with precession — a table carrying "March 21" would be wrong for
+  most of the period this library models, and wrong differently every century.
+
+  The exaltation degrees are omitted (the sign is the resolution anything here
+  reads) and so are the lunar nodes, which are not tonus bodies. Five signs
+  exalt nobody, and that silence is the tradition's.
+
+### Changed — breaking
+
+- **`SIGNS` and `SIGNA` are no longer exported.** `ZODIACA` carries each sign's
+  own `sign` and `signum` beside its doctrine, so it answers both what a sign
+  is called and what it means. The bare name arrays go back to being internal
+  to the engine that computes a longitude, which is the only place they were a
+  lookup rather than a listing.
+
+  ```js
+  // before
+  import tonus, { SIGNS, SIGNA } from "tonus";
+  SIGNS[body.zodiac];              // "Capricorn"
+  SIGNA[body.zodiac];              // "Capricornus"
+
+  // after
+  import tonus, { ZODIACA } from "tonus";
+  ZODIACA[body.zodiac].sign;       // "Capricorn"
+  ZODIACA[body.zodiac].signum;     // "Capricornus"
+  ```
+
+### Fixed
+
+- **The Manus line reads the note that was clicked.** The subheader found its
+  row by pitch, and `find(r => r.spn === spn)` returns the FIRST note of the
+  chant at that pitch — so clicking the second E of a porrectus flexus
+  described an E in a torculus eleven notes earlier, with that note's neume,
+  joint and Guidonian name.
+
+### Site
+
+- **The chant is lifted onto the hand automatically, by whole octaves.** Almost
+  nothing fits the gamut as printed: measured over 400 chants, 32 sit inside
+  their mode's gamut and 346 sit below it, so a piece read straight lands on
+  the bottom joint and stays there. The lift is computed from the chant's own
+  lowest note, which takes notes landing on a joint from 68.8% to 99.9%. The
+  `octava` button was the manual version of this and is gone.
+- **The three sung hours become one Officium segment**, with all eight hours in
+  its popover — Matins and Vespers on, the little hours and Compline there to
+  be asked for.
+- **The address bar keeps `cantus` and nothing else.** Eleven parameters were
+  mirrored there, each written the moment it moved off its default, which made
+  the bar a running transcript of a session.
+- All three analysis tracks open together; the Similes subheader reports the
+  company a melody keeps rather than describing the list; the temperament
+  slider steps a tenth of a cent, the precision its readout prints.
+
 ## 0.5.0 — 2026-08-12
 
 Rendering, mostly — a day of looking at real chant on a real page and fixing

package/README.md

@@ -1,79 +1,19 @@
 # tonus
 
 **tonus** is a JavaScript library for medieval music theory and chant
-analysis. It carries the Gregorian repertoire and the theory it was built on:
-it resolves what any day calls for, tunes chant in the ratios it was sung in,
-parses and draws the notation, voices the planets as pitch, and measures each
-chant in comparison.
+analysis. It carries the Gregorian repertoire and the concepts it was built on.
+
+It tunes to scales medieval singers would have used, tells you which chants
+belong to which day and returns analysis and notation, and calculates the
+_music of the spheres_ proposed by Pythagoras, Boethius, and more as real
+intervals.
+
+**[Interactive demo →](https://jeffreypierce.github.io/tonus/)**
 
 Everything is computed locally and deterministically: the same question always
 returns the same answer, from data that ships inside the package, with no network
 calls and no runtime dependencies.
 
-## What it covers
-
-- **Pitch and tuning.** The medieval pitch world: Pythagorean and meantone
-  temperaments, just intonation and custom scales, the Guidonian gamut and hand,
-  hexachords and their mutations, and interval analysis by name.
-- **The eight modes.** Each church mode with its final, dominant, ambitus, and
-  ethos, and the psalm tones that go with them.
-- **The liturgical calendar.** The Tridentine calendar of any year, resolved
-  against Easter (by the Julian or the Gregorian computus), with each feast's
-  rank, grade, and season.
-- **The chant repertoire.** About 2,200 chants across ten books (nine Solesmes
-  editions and the Nocturnale Romanum night office), in
-  [GABC](https://gregorio-project.github.io/) notation: Mass propers, the Kyriale,
-  the Office hours, the psalter, and the Matins nocturns, retrievable by feast,
-  season, mode, or office.
-- **Rhythm and notation.** GABC parsed into phrases, syllables, and tuned notes,
-  shaped by the Solesmes arsis/thesis rhythm, with an analytic fingerprint of a
-  chant's melodic character, and drawn to a square-note or modern staff.
-- **The harmony of the spheres.** An ephemeris of the classical planets, voiced
-  as tuned pitch after Boethius, Nicomachus, Pliny, and Ptolemy.
-- **The census.** Every shipped chant measured against the corpus that holds
-  it: how typical it is, where it is unusual, and its nearest neighbours by
-  melodic shape.
-
-## The ideas behind it
-
-Boethius's _De institutione musica_ carried Greek theory into the Latin
-Middle Ages, and it treats music as a branch of number, beside arithmetic,
-geometry, and astronomy. Its music runs from the audible to the inaudible:
-voices and instruments (_musica instrumentalis_), body and soul (_musica
-humana_), the turning cosmos (_musica mundana_). Chant was composed and
-copied inside that frame: pitch was ratio, the modes a received order, the
-heavens harmonic proportion.
-
-tonus takes those claims literally enough to compute them. It tunes pitch in
-the Pythagorean ratios of the treatises. It reads the calendar as the
-retrieval index it was for a millennium. It follows the Solesmes rhythm of
-arsis and thesis. And it computes _musica mundana_ as sounding pitch. Where
-the sources run out or contradict one another, tonus makes an editorial call
-and records it in the code.
-
-tonus is an instrument for study. It treats this repertoire as musical and
-historical material to be measured, queried, and understood; what it models is
-the sound and its structure.
-
-## Sources
-
-tonus is built on primary and scholarly sources, and it names them wherever it
-makes a choice. The chant and calendar data are the Solesmes editions, by way of
-[GregoBase](https://gregobase.selapa.net/),
-[Divinum Officium](https://divinumofficium.com/), and the community _Nocturnale
-Romanum_. The rhythm follows Mocquereau, Gajard, Suñol, and Daniel Saulnier; the
-modes and cadences follow Rockstro's _Grove_ article, Niedermeyer & d'Ortigue,
-and Apel; the tuning follows Boethius's _De institutione musica_ and Ptolemy's
-_Harmonics_; the notation is engraved in Daniel Spreadbury's
-[Bravura](https://github.com/steinbergmedia/bravura), the reference font for the
-SMuFL standard; the planetary doctrines follow Godwin's sourcebooks of the
-Pythagorean tradition.
-
-Every figure is cited in the code beside what it explains. The complete list is
-[BIBLIOGRAPHY.md](BIBLIOGRAPHY.md).
-
-## Example
-
 ```sh
 npm install tonus
 ```
@@ -92,8 +32,9 @@ const [feast] = tonus.festum({ date: new Date("2026-12-25") });
 const [introit] = tonus.proprium({ feast, office: "in" });
 // → "Puer natus est", mode 7, from the Liber Usualis
 
-// Turn the chant into tuned, rhythmicized notes.
+// Turn the chant into tuned, rhythmicized notes, then draw it.
 const score = tonus.notatio(introit, { temperamentum: t });
+const { svg, geometry } = tonus.inscriptio(score, { width: 680 });
 
 // And voice the Christmas sky as pitch, after Boethius.
 const harmony = tonus.harmonia(tonus.caelum({ date: feast.date }));
@@ -102,6 +43,56 @@ const harmony = tonus.harmonia(tonus.caelum({ date: feast.date }));
 The objects each call returns (`feast`, `t`) pass straight back into the next as
 filters.
 
+## The API
+
+Fourteen methods, each named for what it returns.
+
+| Method                        | Returns                                                           |
+| ----------------------------- | ----------------------------------------------------------------- |
+| `festum({ date })`            | the feasts of a day, with rank, grade, and season                 |
+| `pascha(year)`                | Easter and the movable feasts reckoned from it                    |
+| `cantus({ … })`               | chants by id, incipit, mode, office, or source                    |
+| `proprium({ feast, office })` | the Mass propers for a feast                                      |
+| `ordinarium({ … })`           | the Kyriale — the Mass ordinary settings                          |
+| `officium({ feast, hora })`   | an Office hour, psalms and antiphons in order                     |
+| `psalmus({ psalm })`          | a psalm, pointed for its tone                                     |
+| `corpus()`                    | what ships: counts by book, genus, and mode                       |
+| `census({ id })`              | one chant measured against the corpus                             |
+| `temperamentum({ … })`        | a tuning — `nota`, `gradus`, `modus`, `intervallum`               |
+| `notatio(chant)`              | GABC parsed to phrases, syllables, and tuned notes                |
+| `inscriptio(score)`           | `{ svg, geometry }` — the score drawn, and where each note landed |
+| `caelum({ date })`            | the classical planets at a moment                                 |
+| `harmonia(caelum)`            | those positions voiced as pitch                                   |
+
+**Tuning** covers Pythagorean and meantone temperaments, just intonation and
+custom scales, the Guidonian gamut and hand, hexachords and their mutations,
+and intervals named as the treatises name them. Each of the eight modes carries
+its final, dominant, ambitus, and ethos, with its psalm tones.
+
+**The calendar** is Tridentine, resolved against Easter by
+the Julian or the Gregorian computus.
+
+**The repertoire** is 2,187 chants across ten books — nine Solesmes editions and
+the _Nocturnale Romanum_ night office — in
+[GABC](https://gregorio-project.github.io/) notation: Mass propers, the Kyriale,
+the Office hours, the psalter, and the Matins nocturns.
+
+**Scores** are shaped by the Solesmes arsis/thesis rhythm, fingerprinted for
+melodic character, and drawn to a square-note or modern staff.
+
+## Concepts
+
+Boethius treated music as a branch of number theory, and divided it into the
+audible and the inaudible: instruments and voices, body and soul, the turning
+cosmos. Chant
+was composed inside that frame: pitch was ratio, the modes a received order,
+the heavens harmonic proportion. tonus takes those claims literally enough to
+compute them, which is why tuning is ratio arithmetic, why the calendar is a
+retrieval index, and why there is an ephemeris in a chant library at all.
+
+Where the sources run out or contradict one another, tonus makes an editorial
+call and records it in the code.
+
 ## Documentation
 
 The **[documentation index](docs/api/index.md)** is the technical center: the full
@@ -114,8 +105,7 @@ one page per engine, in dependency order:
 ## Install and run
 
 ESM only. Node ≥ 20; works in the browser through a bundler. No runtime
-dependencies. About 2,200 chants and the 650-entry calendar ship in the
-package.
+dependencies. The chants and the 650-entry calendar ship in the package.
 
 ```sh
 npm test          # builds and runs the suite (node --test)
@@ -124,6 +114,20 @@ npm test          # builds and runs the suite (node --test)
 The data files in `src/data/` are generated by a separate extraction pipeline
 (tonus-corpus). Edits happen there, not here.
 
+## Sources
+
+The chant and calendar data are the Solesmes editions, by way of
+[GregoBase](https://gregobase.selapa.net/),
+[Divinum Officium](https://divinumofficium.com/), and the community _Nocturnale
+Romanum_. The notation is engraved in Daniel Spreadbury's
+[Bravura](https://github.com/steinbergmedia/bravura), the reference font for the
+SMuFL standard. Behind the rest stand Mocquereau and Suñol on rhythm, Rockstro
+and Apel on the modes, Boethius and Ptolemy on tuning, and Godwin on the
+Pythagorean planets.
+
+Every figure is cited in the code beside what it explains, and
+[BIBLIOGRAPHY.md](BIBLIOGRAPHY.md) is the complete list.
+
 ## License
 
 [PolyForm Noncommercial 1.0.0](LICENSE): free to use, study, modify, and

package/dist/data/gabc-glyphs.js

@@ -3,7 +3,7 @@
 // ---------------------------------------------------------------------------
 // Codepoints and pitch positions mirror the gabc-smufl project's
 // data/gabc-map.json (SMuFL 1.5 / Bravura 1.392). Outlines for these codepoints
-// are baked into smufl-glyphs.json by scripts/extract-smufl-glyphs.py.
+// are baked into smufl-glyphs.json by scripts/extract-smufl-glyphs.mjs.
 //
 // pitch_positions: the raw GABC pitch letter a–m IS the staff slot, in
 // half-staff-spaces from the bottom line, independent of clef. (a=-2 … c=0

package/dist/data/smufl-glyphs.js

@@ -1,17 +1,17 @@
 // ---------------------------------------------------------------------------
 // data/smufl-glyphs — SMuFL chant glyph outlines (baked from Bravura)
 // ---------------------------------------------------------------------------
-// Generated by scripts/extract-smufl-glyphs.py — do not edit smufl-glyphs.json
+// Generated by `npm run glyphs` — do not edit smufl-glyphs.json
 // by hand. Paths are in font units, y-up (baseline at 0); the SVG emitter
 // applies scale(s, -s). See the script header for the coordinate contract.
 
 const data = ({
  "meta": {
   "source": "Bravura.otf (Steinberg Media, SIL OFL 1.1)",
-  "smufl": "plainchant PUA (U+E8F0\u2013U+E9D9)",
+  "smufl": "plainchant PUA (U+E8F0–U+E9D9)",
   "upm": 1000,
   "coordinates": "font units, y-up (baseline at 0); emitter applies scale(s, -s)",
-  "regenerate": "python3 scripts/extract-smufl-glyphs.py",
+  "regenerate": "npm run glyphs",
   "count": 138
  },
  "glyphs": {
@@ -1275,7 +1275,7 @@ const data = ({
    "advance": 215,
    "bbox": [
     0,
-    -173.08333333333334,
+    -173.08333333333331,
     215,
     435
    ]

package/dist/data/smufl-glyphs.json

@@ -1,10 +1,10 @@
 {
  "meta": {
   "source": "Bravura.otf (Steinberg Media, SIL OFL 1.1)",
-  "smufl": "plainchant PUA (U+E8F0\u2013U+E9D9)",
+  "smufl": "plainchant PUA (U+E8F0–U+E9D9)",
   "upm": 1000,
   "coordinates": "font units, y-up (baseline at 0); emitter applies scale(s, -s)",
-  "regenerate": "python3 scripts/extract-smufl-glyphs.py",
+  "regenerate": "npm run glyphs",
   "count": 138
  },
  "glyphs": {
@@ -1268,7 +1268,7 @@
    "advance": 215,
    "bbox": [
     0,
-    -173.08333333333334,
+    -173.08333333333331,
     215,
     435
    ]

package/dist/engines/harmonia/data/zodiac.d.ts

@@ -0,0 +1,47 @@
+import type { BodyName } from "../../planet/types.js";
+/** The four Aristotelian elements, as the triplicities assign them. */
+export type Element = "fire" | "earth" | "air" | "water";
+/** Ptolemy's quadruplicities, in the scholastic naming. */
+export type Quality = "cardinal" | "fixed" | "mutable";
+/** The Galenic humor the sign's element carries. */
+export type Humor = "cholera" | "melancholia" | "sanguis" | "phlegma";
+/** The part of the body a sign governs, in the zodiac man. */
+export interface Melothesia {
+    /** The member as the manuscripts name it: caput, collum, pectus… */
+    latin: string;
+    /** What that covers, in English — several signs govern more than one part. */
+    english: string;
+}
+/** A sign's doctrine. English keys carry machine codes; the Latin fields carry
+ *  the authentic terms a reader meets on the page. */
+export interface ZodiacSign {
+    /** 0 = Aries … 11 = Pisces, matching `Body.zodiac`. */
+    index: number;
+    /** Matches `Body.sign` verbatim. */
+    sign: string;
+    /** Matches `Body.signum` verbatim — Scorpius, Capricornus. */
+    signum: string;
+    /** The astronomical symbol, U+2648–U+2653. */
+    symbol: string;
+    element: Element;
+    elementum: string;
+    quality: Quality;
+    qualitas: string;
+    /** The sign's nature as the two Aristotelian pairs, in Latin. */
+    nature: {
+        heat: string;
+        moisture: string;
+    };
+    genus: "masculinum" | "femininum";
+    humor: Humor;
+    temperament: string;
+    /** The planet that rules the sign. */
+    domicile: BodyName;
+    /** The planet exalted in it — null for the five that have none. */
+    exaltation: BodyName | null;
+    melothesia: Melothesia;
+    /** Where the sources disagree, said plainly rather than resolved. */
+    variant?: string;
+}
+export declare const ZODIACA: readonly ZodiacSign[];
+//# sourceMappingURL=zodiac.d.ts.map

package/dist/engines/harmonia/data/zodiac.js

@@ -0,0 +1,163 @@
+// ---------------------------------------------------------------------------
+// engines/harmonia/data/zodiac — what the twelve signs MEAN
+// ---------------------------------------------------------------------------
+//
+// `caelum` answers WHERE: a body's ecliptic longitude becomes `zodiac` (the
+// index), `sign` and `signum`. This table answers WHAT IT MEANS — the doctrine
+// a medieval reader brought to that position.
+//
+// DELIBERATELY NO DATES. When the Sun enters a sign is the ephemeris's
+// business and changes with precession; a table that carried "March 21" would
+// be wrong for most of the period this library models, and wrong differently
+// every century. The index is the join, and `caelum` computes it.
+//
+// The join: `SIGNS[i]`, `SIGNA[i]` (engines/planet/planet.ts) and `ZODIACA[i]`
+// are one list three ways, so `ZODIACA[body.zodiac]` is always that body's
+// doctrine. The two name arrays live with the ephemeris because drawing the
+// wheel needs them without any of this; the meanings live here because nothing
+// in computing a position depends on them.
+//
+// Sources, per field:
+//   domicile    Ptolemy, Tetrabiblos I.17 [biblio: ptolemy-tetrabiblos],
+//               transmitted whole through the medieval Latin tradition and
+//               uncontested across sources.
+//   exaltation  Tetrabiblos I.19 and the standard medieval list, THE SEVEN
+//               PLANETS ONLY. The lunar nodes' exaltations (Caput Draconis in
+//               Gemini, Cauda in Sagittarius) are omitted because the nodes are
+//               not tonus bodies. The exaltation DEGREES (Sun at 19° Arietis
+//               and the rest) are omitted as more precision than any consumer
+//               here reads — five signs simply have no exaltation, and that
+//               absence is the tradition's, not an omission.
+//   element,    the Ptolemaic triplicities and quadruplicities. The Latin
+//   quality     quality terms are the scholastic mobile/fixum/commune, where
+//               Ptolemy writes tropic/solid/bicorporeal.
+//   humor       the Galenic element→humor square — fire/cholera, earth/
+//               melancholia, air/sanguis, water/phlegma — ubiquitous in
+//               medieval medicine.
+//   melothesia  the homo signorum of medieval calendars and medical
+//               manuscripts, Aries at the head down to Pisces at the feet (the
+//               Très Riches Heures anatomical man is the familiar picture).
+//               Practice, not decoration: phlebotomy was timed against it.
+//
+// Where the tradition wobbles, the entry says so in `variant` rather than
+// picking a winner quietly. Uncertainty is data.
+export const ZODIACA = [
+    {
+        index: 0, sign: "Aries", signum: "Aries", symbol: "♈",
+        element: "fire", elementum: "ignis",
+        quality: "cardinal", qualitas: "mobile",
+        nature: { heat: "calidum", moisture: "siccum" },
+        genus: "masculinum", humor: "cholera", temperament: "cholericum",
+        domicile: "Mars", exaltation: "Sun",
+        melothesia: { latin: "caput", english: "the head and face" },
+    },
+    {
+        index: 1, sign: "Taurus", signum: "Taurus", symbol: "♉",
+        element: "earth", elementum: "terra",
+        quality: "fixed", qualitas: "fixum",
+        nature: { heat: "frigidum", moisture: "siccum" },
+        genus: "femininum", humor: "melancholia", temperament: "melancholicum",
+        domicile: "Venus", exaltation: "Moon",
+        melothesia: { latin: "collum", english: "the neck and throat" },
+    },
+    {
+        index: 2, sign: "Gemini", signum: "Gemini", symbol: "♊",
+        element: "air", elementum: "aer",
+        quality: "mutable", qualitas: "commune",
+        nature: { heat: "calidum", moisture: "humidum" },
+        genus: "masculinum", humor: "sanguis", temperament: "sanguineum",
+        domicile: "Mercury", exaltation: null,
+        melothesia: { latin: "umeri", english: "the shoulders, arms and hands" },
+    },
+    {
+        index: 3, sign: "Cancer", signum: "Cancer", symbol: "♋",
+        element: "water", elementum: "aqua",
+        quality: "cardinal", qualitas: "mobile",
+        nature: { heat: "frigidum", moisture: "humidum" },
+        genus: "femininum", humor: "phlegma", temperament: "phlegmaticum",
+        domicile: "Moon", exaltation: "Jupiter",
+        melothesia: { latin: "pectus", english: "the breast and chest" },
+        variant: "the melothesia wobbles here more than anywhere: some manuscripts "
+            + "extend Cancer to the lungs and stomach",
+    },
+    {
+        index: 4, sign: "Leo", signum: "Leo", symbol: "♌",
+        element: "fire", elementum: "ignis",
+        quality: "fixed", qualitas: "fixum",
+        nature: { heat: "calidum", moisture: "siccum" },
+        genus: "masculinum", humor: "cholera", temperament: "cholericum",
+        domicile: "Sun", exaltation: null,
+        melothesia: { latin: "cor", english: "the heart, back and sides" },
+    },
+    {
+        index: 5, sign: "Virgo", signum: "Virgo", symbol: "♍",
+        element: "earth", elementum: "terra",
+        quality: "mutable", qualitas: "commune",
+        nature: { heat: "frigidum", moisture: "siccum" },
+        genus: "femininum", humor: "melancholia", temperament: "melancholicum",
+        domicile: "Mercury", exaltation: "Mercury",
+        melothesia: { latin: "venter", english: "the belly and bowels" },
+    },
+    {
+        index: 6, sign: "Libra", signum: "Libra", symbol: "♎",
+        element: "air", elementum: "aer",
+        quality: "cardinal", qualitas: "mobile",
+        nature: { heat: "calidum", moisture: "humidum" },
+        genus: "masculinum", humor: "sanguis", temperament: "sanguineum",
+        domicile: "Venus", exaltation: "Saturn",
+        melothesia: { latin: "renes", english: "the kidneys and loins" },
+    },
+    {
+        index: 7, sign: "Scorpio", signum: "Scorpius", symbol: "♏",
+        element: "water", elementum: "aqua",
+        quality: "fixed", qualitas: "fixum",
+        nature: { heat: "frigidum", moisture: "humidum" },
+        genus: "femininum", humor: "phlegma", temperament: "phlegmaticum",
+        domicile: "Mars", exaltation: null,
+        melothesia: { latin: "genitalia", english: "the genitals" },
+    },
+    {
+        index: 8, sign: "Sagittarius", signum: "Sagittarius", symbol: "♐",
+        element: "fire", elementum: "ignis",
+        quality: "mutable", qualitas: "commune",
+        nature: { heat: "calidum", moisture: "siccum" },
+        genus: "masculinum", humor: "cholera", temperament: "cholericum",
+        domicile: "Jupiter", exaltation: null,
+        melothesia: { latin: "femora", english: "the thighs" },
+    },
+    {
+        index: 9, sign: "Capricorn", signum: "Capricornus", symbol: "♑",
+        element: "earth", elementum: "terra",
+        quality: "cardinal", qualitas: "mobile",
+        nature: { heat: "frigidum", moisture: "siccum" },
+        genus: "femininum", humor: "melancholia", temperament: "melancholicum",
+        domicile: "Saturn", exaltation: "Mars",
+        melothesia: { latin: "genua", english: "the knees" },
+    },
+    {
+        index: 10, sign: "Aquarius", signum: "Aquarius", symbol: "♒",
+        element: "air", elementum: "aer",
+        quality: "fixed", qualitas: "fixum",
+        nature: { heat: "calidum", moisture: "humidum" },
+        genus: "masculinum", humor: "sanguis", temperament: "sanguineum",
+        domicile: "Saturn", exaltation: null,
+        melothesia: { latin: "crura", english: "the shins and ankles" },
+    },
+    {
+        index: 11, sign: "Pisces", signum: "Pisces", symbol: "♓",
+        element: "water", elementum: "aqua",
+        quality: "mutable", qualitas: "commune",
+        nature: { heat: "frigidum", moisture: "humidum" },
+        genus: "femininum", humor: "phlegma", temperament: "phlegmaticum",
+        domicile: "Jupiter", exaltation: "Venus",
+        melothesia: { latin: "pedes", english: "the feet" },
+    },
+];
+// THE LUNAR PROHIBITION, recorded here rather than exported: while the Moon
+// stands in a sign, that sign's member is not to be touched. It is the reason
+// the zodiac man is in a physician's calendar at all — it was "dangerous, if
+// not fatal, to treat that member if the Moon was in the sign at the time" —
+// and it is one line of doctrine that any consumer can state for itself from
+// `ZODIACA[moon.zodiac].melothesia`. A constant holding a sentence of English
+// would be prose pretending to be data.
+//# sourceMappingURL=zodiac.js.map

package/dist/engines/score/emitters/svg.js

@@ -135,7 +135,14 @@ function resolveOpts(o) {
         rubricaColor: cssVar("rubrica", o.rubricaColor ?? "#9E2B25"),
     };
 }
-const HOUSE_SERIF = "'Crimson Pro', 'Crimson Text', 'EB Garamond', Garamond, Georgia, serif";
+// JUNICODE FIRST, then the Garamonds. tonus ships no font bytes, so this stack
+// is a request and not a guarantee — but naming the recommended face at its
+// head costs nothing and means a page that already loads Junicode (the labs,
+// the site, a medievalist's own stylesheet) gets the dress the plates are drawn
+// with without passing a `fonts` option at all. Every name after it is the
+// fallback that was here before, so a page without Junicode renders exactly as
+// it did. See score.md → "The recommended face".
+const HOUSE_SERIF = "Junicode, 'Crimson Pro', 'Crimson Text', 'EB Garamond', Garamond, Georgia, serif";
 // The books abbreviate the genus in the margin mark (Intr., Grad., Offert.);
 // a genus not in the table prints as-is with its period.
 const GENUS_ABBREV = {

package/dist/index.d.ts

@@ -56,7 +56,7 @@ export { TONES } from "./engines/temper/data/tones.js";
 export type { PsalmTone, Differentia } from "./engines/temper/data/tones.js";
 export { CADENTIAE, CADENTIAE_POPULATION } from "./data/cadentiae.js";
 export type { CadentiaFamilia } from "./data/cadentiae.js";
-export { SIGNS, SIGNA } from "./engines/planet/planet.js";
+export { ZODIACA } from "./engines/harmonia/data/zodiac.js";
 export { CENSUS_GROUPS, CENSUS_ORDER } from "./data/census.js";
 export type { Feast, FeastQuery, Pascha, Season, Grade, Chant, CantusQuery, OrdinaryChant, PropriumQuery, OrdinariumQuery, OfficiumQuery, PsalmusQuery, Corpus, GenusCount, ModeCount, SharedCount, CorpusLedger, CorpusFullCount, CorpusQuery, Census, CensusQuery, CensusBy, CensusGroup, CensusGroupProfile, CensusNeighbor, Temperamentum, TemperamentumInput, TemperamentumOpts, Tuning, Pitch, PitchInput, Step, Neume, NeumeShape, Interval, ModeData, CadenceFigure, Modus, TunedNote, GamutOptions, Tonus, TonusOpts, Score, ScoreOpts, PondusInput, PondusOpts, AccentusInput, AccentusOpts, Cadence, CadenceTarget, CadenceApproach, Modulation, InscriptioOpts, Inscriptio, NoteGeometry, FontSpec, FontSlot, FontEmbed, ChantTabulaRow, Note, Performance, Phrase, Syllable, LyricRun, RestEvent, ParseError, ArsisThesis, RhythmicType, CompoundBeat, VoicedPitch, Cosmos, CosmosQuery, Body, BodyName, Aspect, Imprint, Attractor, VowelAttractor, ModalAffinity, Prosody, RhythmicProfile, NoteRange, CadenceDistribution, Harmony, HarmoniaOpts, VoicedBody, VoicedAspect, Frame, Author, HarmonyTabulaRow, PlanetVowel, };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -54,8 +54,11 @@ export { SOURCES } from "./engines/chant/chant.js"; // book code → bibliograph
 export { MODES } from "./engines/temper/data/modes.js";
 export { TONES } from "./engines/temper/data/tones.js";
 export { CADENTIAE, CADENTIAE_POPULATION } from "./data/cadentiae.js";
-// planet — the zodiac
-export { SIGNS, SIGNA } from "./engines/planet/planet.js";
+// planet — the zodiac. ZODIACA is the whole table: it carries each sign's own
+// `sign` and `signum` beside its doctrine, so `ZODIACA[body.zodiac]` answers
+// both what the sign is CALLED and what it MEANS. The bare name arrays stay
+// inside the engine that computes a longitude, where they are the lookup.
+export { ZODIACA } from "./engines/harmonia/data/zodiac.js";
 // census — the field groups and the block index. CENSUS_GROUPS keys are the
 // valid `by:` values AND the `profile` keys; CENSUS_ORDER holds every censused
 // id, so asking whether a chant is in the census stops needing a try/catch.

package/docs/api/heavens.md

@@ -9,6 +9,7 @@ summarized in [Theory & Context](#theory--context).
 - [Heavens](#heavens)
   - [The heavens — `caelum`](#the-heavens--caelum)
   - [Aspects](#aspects)
+  - [The signs — `ZODIACA`](#the-signs--zodiaca)
   - [The voiced heavens — `harmonia`](#the-voiced-heavens--harmonia)
   - [The planetary vowels](#the-planetary-vowels)
   - [The tabula](#the-tabula)
@@ -129,6 +130,55 @@ interface Aspect {
 }
 ```
 
+## The signs — `ZODIACA`
+
+`caelum` answers WHERE a body is. `ZODIACA` answers what that position MEANT:
+the doctrine a medieval reader brought to a planet standing in a sign.
+
+```js
+import tonus, { ZODIACA } from "tonus";
+
+const [sun] = tonus.caelum({ date: new Date("2026-12-25") }).bodies;
+const sign = ZODIACA[sun.zodiac];
+// → { sign: "Capricorn", signum: "Capricornus", symbol: "♑",
+//     element: "earth", elementum: "terra", humor: "melancholia",
+//     quality: "cardinal", domicile: "Saturn", exaltation: "Mars",
+//     melothesia: { latin: "genua", english: "the knees" }, … }
+```
+
+`ZODIACA[body.zodiac]` is the join. The array is in ecliptic order and each
+entry knows its own `index`, so a body's sign is addressed directly rather than
+searched for.
+
+| Field                   | What it holds                                                        |
+| ----------------------- | -------------------------------------------------------------------- |
+| `sign` / `signum`       | the code and the Latin — identical to `Body.sign` / `Body.signum`    |
+| `symbol`                | the astronomical sign, U+2648–U+2653                                 |
+| `element` / `elementum` | one of the four, and its Latin                                       |
+| `quality` / `qualitas`  | cardinal, fixed, mutable — Ptolemy's tropic/solid/bicorporeal        |
+| `nature`                | the two Aristotelian pairs: `calidum`/`frigidum`, `siccum`/`humidum` |
+| `humor` / `temperament` | the Galenic humor the element carries, and its temperament           |
+| `domicile`              | the planet that rules the sign, as a `BodyName`                      |
+| `exaltation`            | the planet exalted in it — `null` for the five that have none        |
+| `melothesia`            | the member of the zodiac man the sign governs                        |
+| `variant`               | present only where the sources disagree                              |
+
+**There are no dates.** When the Sun enters a sign is the ephemeris's business
+and moves with precession; a table carrying "March 21" would be wrong for most
+of the period this library models, and wrong differently every century.
+
+**What is omitted, and why.** The exaltation degrees Ptolemy gives (the Sun at
+19° Arietis and the rest) are not carried — the sign is the resolution anything
+here reads. Nor are the lunar nodes' exaltations, because the nodes are not
+tonus bodies. Five signs exalt nobody: that silence is the tradition's, not a
+gap in the table.
+
+The `melothesia` is the *homo signorum* of medieval calendars — Aries at the
+head down to Pisces at the feet. It was practice, not decoration: phlebotomy
+was timed against it, and while the Moon stood in a sign its member was not to
+be touched. Sourced from Ptolemy's *Tetrabiblos* I.17 and I.19
+[biblio: ptolemy-tetrabiblos].
+
 ## The voiced heavens — `harmonia`
 
 `harmonia(cosmos, opts?)` gives each body a pitch and a Greek vowel according to

package/docs/api/index.md

@@ -4,6 +4,8 @@ The technical center of tonus: the full public API, the conventions every method
 obeys, and the error contract. The API is **fourteen methods on the `tonus`
 namespace**, no sub-namespaces.
 
+**[Interactive demo →](https://jeffreypierce.github.io/tonus/)**
+
 ```js
 import tonus from "tonus";
 ```
@@ -15,22 +17,22 @@ import tonus from "tonus";
 
 ## The methods
 
-| Method                             | Page                    | Returns                                                 |
-| ---------------------------------- | ----------------------- | ------------------------------------------------------- |
-| `tonus.festum(query?)`             | [calendar](calendar.md) | `Feast[]` — liturgical calendar lookup                  |
-| `tonus.pascha(year)`               | [calendar](calendar.md) | `Pascha` — the movable anchors of a liturgical year     |
-| `tonus.cantus(query?)`             | [chant](chant.md)       | `Chant[]` — cross-corpus chant retrieval / GABC parsing |
-| `tonus.corpus(code?)`              | [chant](chant.md)       | `Corpus` — a book's ledger; no arg → the whole shelf     |
-| `tonus.proprium(query?)`           | [chant](chant.md)       | `Chant[]` — Mass propers                                |
-| `tonus.ordinarium(query?)`         | [chant](chant.md)       | `OrdinaryChant[]` — Kyriale                             |
-| `tonus.officium(query?)`           | [chant](chant.md)       | `Chant[]` — Divine Office hours                         |
-| `tonus.psalmus(query?)`            | [chant](chant.md)       | `Chant[]` — intoned psalm verses                        |
-| `tonus.temperamentum(input?)`      | [tuning](tuning.md)     | `Temperamentum` — tuning context                        |
-| `tonus.notatio(chant, opts?)`      | [score](score.md)       | `Score` — GABC → musical score                          |
-| `tonus.inscriptio(score, opts?)`   | [score](score.md)       | `Inscriptio` — `{ svg, geometry }`, the score drawn     |
-| `tonus.caelum(query?)`             | [heavens](heavens.md)   | `Cosmos \| Cosmos[]` — ephemeris                        |
-| `tonus.harmonia(cosmos, opts?)`    | [heavens](heavens.md)   | `Harmony` — musica universalis                          |
-| `tonus.census(query)`              | [census](census.md)     | `Census` — a chant against the corpus                   |
+| Method                           | Page                    | Returns                                                 |
+| -------------------------------- | ----------------------- | ------------------------------------------------------- |
+| `tonus.festum(query?)`           | [calendar](calendar.md) | `Feast[]` — liturgical calendar lookup                  |
+| `tonus.pascha(year)`             | [calendar](calendar.md) | `Pascha` — the movable anchors of a liturgical year     |
+| `tonus.cantus(query?)`           | [chant](chant.md)       | `Chant[]` — cross-corpus chant retrieval / GABC parsing |
+| `tonus.corpus(code?)`            | [chant](chant.md)       | `Corpus` — a book's ledger; no arg → the whole shelf    |
+| `tonus.proprium(query?)`         | [chant](chant.md)       | `Chant[]` — Mass propers                                |
+| `tonus.ordinarium(query?)`       | [chant](chant.md)       | `OrdinaryChant[]` — Kyriale                             |
+| `tonus.officium(query?)`         | [chant](chant.md)       | `Chant[]` — Divine Office hours                         |
+| `tonus.psalmus(query?)`          | [chant](chant.md)       | `Chant[]` — intoned psalm verses                        |
+| `tonus.temperamentum(input?)`    | [tuning](tuning.md)     | `Temperamentum` — tuning context                        |
+| `tonus.notatio(chant, opts?)`    | [score](score.md)       | `Score` — GABC → musical score                          |
+| `tonus.inscriptio(score, opts?)` | [score](score.md)       | `Inscriptio` — `{ svg, geometry }`, the score drawn     |
+| `tonus.caelum(query?)`           | [heavens](heavens.md)   | `Cosmos \| Cosmos[]` — ephemeris                        |
+| `tonus.harmonia(cosmos, opts?)`  | [heavens](heavens.md)   | `Harmony` — musica universalis                          |
+| `tonus.census(query)`            | [census](census.md)     | `Census` — a chant against the corpus                   |
 
 ### Query and builder functions
 

package/docs/api/score.md

@@ -446,6 +446,39 @@ files: with `embed` it is a conduit for data the consumer supplies, so the
 consumer carries the face's license terms. Unset roles keep the house serif.
 `moderna` honours the `lyric`, `title`, and `annotation` slots.
 
+#### The recommended face — Junicode
+
+The plates are drawn in
+**[Junicode](https://github.com/psb1558/Junicode-font)** (OFL), which the house
+stack already asks for first. Load it and add the dress:
+
+```css
+@font-face {
+  font-family: "Junicode";
+  src: url("JunicodeVF-Roman.woff2") format("woff2-variations");
+  font-weight: 300 700;
+}
+```
+
+```js
+tonus.inscriptio(score, {
+  width: 900,
+  theme: {
+    fonts: {
+      dropcap:    { family: "Junicode", weight: 700 },
+      title:      { family: "Junicode", weight: 620 },
+      annotation: { family: "Junicode", weight: 640 },
+      lyric:      { family: "Junicode", weight: 560, scale: 1.06 },
+    },
+  },
+  dropcap: true, annotation: "auto", // a role shows only once its feature is on
+});
+```
+
+Reference it rather than `embed` it unless one SVG must travel alone: the face
+is 196 KB base64'd, which triples a typical chant and repeats in every file,
+where a reference is cached once.
+
 **`colors`** reach the SVG as CSS custom properties with the theme's own value
 as the fallback — `fill="var(--tonus-note, #111)"`. A rendered chant therefore
 carries the ink it was drawn with *and* stays themable: a host stylesheet that

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tonus",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "type": "module",
   "description": "Medieval music analysis and performance: GABC plainchant exports, liturgical calendar, tuning systems, ephemeris, and the harmony of the spheres",
   "author": "Jeffrey Pierce <jeffrey@jeffreypierce.net>",
@@ -55,10 +55,12 @@
     "serve": "npm run site && node scripts/serve.mjs",
     "diagrams": "npm run site && node scripts/diagram-lab.mjs",
     "lab": "npm run build && node scripts/render-lab.mjs",
-    "stress": "npm run build && node scripts/render-stress.mjs"
+    "stress": "npm run build && node scripts/render-stress.mjs",
+    "glyphs": "node scripts/extract-smufl-glyphs.mjs"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "fontkit": "^2.0.0",
     "typescript": "^5.6.3"
   },
   "engines": {