tonus 0.1.0

package/BIBLIOGRAPHY.md

@@ -0,0 +1,99 @@
+# Bibliography
+
+Master index of sources used in building tonus. Full citation detail lives
+with the engine each source informs — follow the links to the `## Sources`
+section of the relevant page.
+
+## Data corpora
+
+- **GregoBase** — chant corpora in GABC, by book (the four Solesmes
+  editions: Graduale Romanum 1961, Liber Usualis 1961, Liber Antiphonarius
+  1960, Liber Hymnarius 1983) → [docs/chant.md](docs/chant.md#sources)
+- **Divinum Officium** — liturgical calendar (642 entries), Mass propers,
+  Office hours, Psalterium → [docs/calendar.md](docs/calendar.md#sources),
+  [docs/chant.md](docs/chant.md#sources)
+- **Graduale Romanum appendix (Toni Communes)** — psalm tones and
+  differentiae, incl. tonus peregrinus →
+  [docs/chant.md](docs/chant.md#sources)
+- **Versus Psalmorum et Canticorum (Solesmes, No. 839)** — psalm-verse
+  formulas → [docs/chant.md](docs/chant.md#sources)
+
+## Chant rhythm (score engine)
+
+- **Carroll, _The Technique of Gregorian Chironomy_ (1955)** — seven
+  rhythmic types, three melodic rules, chironomy →
+  [docs/score.md](docs/score.md#sources)
+- **Carroll, _An Applied Course in Gregorian Chant_ (1956)** — compound
+  beats, ictus placement → [docs/score.md](docs/score.md#sources)
+- **Gajard, _The Rhythm of Plainsong_ (1945)** — arsis/thesis synthesis →
+  [docs/score.md](docs/score.md#sources)
+- **Mocquereau, _Le nombre musical grégorien_ (1908–1927)** — the Solesmes
+  school's foundation → [docs/score.md](docs/score.md#sources)
+- **Cardine, "Semiology and the Interpretation of Gregorian Chant"** — the
+  semiological approach → [docs/score.md](docs/score.md#sources)
+- **Desrocquettes, "Gregorian Musical Values"** — Solesmes rhythmic
+  values → [docs/score.md](docs/score.md#sources)
+- **Apel, _Gregorian Chant_ (1958)** — analytic study of the repertoire →
+  [docs/chant.md](docs/chant.md#sources)
+- **Hiley, _Western Plainchant_ (1993)** — the standard reference →
+  [docs/chant.md](docs/chant.md#sources)
+- **Treitler, _With Voice and Pen_ (2003)** — orality and notation →
+  [docs/chant.md](docs/chant.md#sources)
+- **Saulnier, _Gregorian Chant: A Guide_** — chant introduction →
+  [docs/chant.md](docs/chant.md#sources)
+- **Pierik, _The Spirit of Gregorian Chant_ (1939) and _Gregorian Chant
+  Analyzed and Studied_ (1951)** — chant interpretation →
+  [docs/chant.md](docs/chant.md#sources)
+- **Burkard, _Manual of Plain Chant_ (1906)** — plainchant instruction →
+  [docs/chant.md](docs/chant.md#sources)
+- **Kelly, _Capturing Music: The Story of Notation_ (2014)** — notation
+  history → [docs/chant.md](docs/chant.md#sources)
+
+## Tuning and music theory (temperamentum engine)
+
+- **Boethius, _De institutione musica_** — Pythagorean interval math;
+  also the Boethius doctrina → [docs/tuning.md](docs/tuning.md#sources),
+  [docs/heavens.md](docs/heavens.md#sources)
+- **Ptolemy, _Harmonics_ I.15–16** — the three diatonic shades; _Harmonics_
+  III for the doctrina → [docs/tuning.md](docs/tuning.md#sources),
+  [docs/heavens.md](docs/heavens.md#sources)
+- **Atkinson, _The Critical Nexus_ (2009)** — tone-system, mode, and
+  notation → [docs/tuning.md](docs/tuning.md#sources)
+- **Reisenweaver, "Guido of Arezzo" (2012)** — Guido's pedagogy →
+  [docs/tuning.md](docs/tuning.md#sources)
+- **Schulter, medieval.org harmony FAQs** — Pythagorean tuning; hexachords
+  and solmization → [docs/tuning.md](docs/tuning.md#sources)
+- **Rockstro, "Modes, The Ecclesiastical" (Grove, 1st ed.)** — the church
+  modes → [docs/tuning.md](docs/tuning.md#sources)
+- **Powers/Wiering et al., "Mode" (Grove Music Online, 2001), §§I–III** —
+  medieval modal theory → [docs/tuning.md](docs/tuning.md#sources)
+- **Liber Usualis introduction and rubrics (Desclée, 1961)** —
+  interpretation rules → [docs/tuning.md](docs/tuning.md#sources),
+  [docs/chant.md](docs/chant.md#sources)
+- **Scala scale archive / `.scl` format** (Huygens-Fokker Foundation) —
+  custom tuning input → [docs/tuning.md](docs/tuning.md#sources)
+- **Guidonian gamut, solmization, and the eight-mode system** — as
+  standardized in medieval theory →
+  [docs/tuning.md](docs/tuning.md#sources)
+
+## Musica universalis (harmonia engine)
+
+- **Godwin, _Harmonies of Heaven and Earth_ (1987)** — planetary scale
+  taxonomy and analyses → [docs/heavens.md](docs/heavens.md#sources)
+- **Godwin (ed.), _The Harmony of the Spheres_ (1993)** — primary-source
+  translations → [docs/heavens.md](docs/heavens.md#sources)
+- **Godwin, _The Mystery of the Seven Vowels_ (1991)** — planetary vowel
+  attestations → [docs/heavens.md](docs/heavens.md#sources)
+- **Nicomachus, Plato, Pliny, Ptolemy** — the doctrina primaries (with the
+  vowel attestations: Porphyry, Marcus Gnosticus, Demetrius, Eusebius,
+  Barthélemy of Edessa) → [docs/heavens.md](docs/heavens.md#sources)
+
+## Astronomy and computus
+
+- **Standish, "Keplerian Elements for Approximate Positions of the Major
+  Planets" (JPL, 1992/DE430)** — orbital elements →
+  [docs/heavens.md](docs/heavens.md#sources)
+- **Schlyter, "Computing planetary positions" (Stjärnhimlen)** — position
+  computation tutorial → [docs/heavens.md](docs/heavens.md#sources)
+- **Gauss/Butcher computus; Julian 19-year cycle** — Easter reckoning →
+  [docs/calendar.md](docs/calendar.md#sources)

package/LICENSE

@@ -0,0 +1,29 @@
+MIT License
+
+Copyright (c) 2026 Jeffrey Pierce
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Data provenance: the chant corpora derive from GregoBase
+(https://gregobase.selapa.net/); the liturgical calendar, propers, office,
+and psalter derive from the Divinum Officium project
+(https://github.com/DivinumOfficium/divinum-officium); orbital elements from
+JPL/NASA (Standish 1992, DE430). See BIBLIOGRAPHY.md for full attribution.

package/README.md

@@ -0,0 +1,108 @@
+# tonus
+
+**tonus** is a medieval music and cosmology library. It covers:
+
+- pitch, tuning, hexachords, and the eight church modes
+- the liturgical calendar, the feast of the day, and mass selection
+- the chant repertoire in GABC: propers, ordinary, office, and psalm tones
+- chant rhythm and performance shaping, rendered to MIDI or MusicXML
+- planetary positions voiced as tuned pitch across the classical theorists' "harmony of the spheres"
+
+**tonus** is implemented in TypeScript and its API is a single namespace of methods. Every result is deterministic: the same
+query returns the same answer, computed locally from data that ships with
+the package, with no network calls.
+
+## Install
+
+```sh
+npm install tonus
+```
+
+ESM only. Node ≥ 20; works in the browser through a bundler. No runtime
+dependencies. Roughly 5,500 chants and the full 642-entry calendar ship in
+the package — 6.5 MB unpacked, 1.5 MB packed.
+
+## Documentation
+
+One page per engine, in dependency order. Each page states its rules, then its theory and historical context, then its sources.
+
+- **[Index](docs/index.md)** — Table of contents and conventions.
+- **[Tuning](docs/tuning.md)** — `temperamentum`. The medieval pitch system:
+  temperaments, Guidonian gamut and hand,
+  hexachordal solmization and mutations, eight modes, and psalm
+  tones. Depends on nothing else in the library.
+- **[Calendar](docs/calendar.md)** — `festum`, `pascha`. The Tridentine
+  liturgical calendar resolved against dual-computus Easter: feasts with
+  their authentic ranks, grades, and seasons, and the movable anchors of
+  any year.
+- **[Chant](docs/chant.md)** — `cantus`, `proprium`, `ordinarium`,
+  `officium`, `psalmus`. The Solesmes books in GABC: Mass propers, the
+  Kyriale, the Office hours, the psalter.
+- **[Score](docs/score.md)** — `notatio`. GABC into tuned notes: phrases,
+  syllables, Solesmes arsis/thesis rhythm, prosody, the analytic imprint.
+- **[Heavens](docs/heavens.md)** — `caelum`, `harmonia`. An ephemeris
+  computed from JPL orbital elements, voiced through the planetary
+  doctrines of Boethius, Nicomachus, Pliny, and Ptolemy.
+
+Sources for concepts, scholarship, and data are listed in
+[BIBLIOGRAPHY.md](BIBLIOGRAPHY.md). Where sources disagree or run out,
+**tonus** makes an editorial call, documented in the relevant page's
+Theory & Context section.
+
+## The tuning engine
+
+The tuning engine is self-contained; every other engine resolves its pitches
+through it.
+
+```js
+import tonus from "tonus";
+
+const t = tonus.temperamentum({ mode: 1 }); // Pythagorean, mode 1
+
+t.nota("D4");
+// 293.33 Hz — the final of mode 1, tuned through pure fifths
+
+t.gradus("D4");
+// Delasolre: RE of the natural hexachord, role "finalis",
+// middle finger, base joint, on the Guidonian hand
+
+t.intervallum("D4", "A4");
+// Quinta (alias Diapente), perfect — final to tenor
+
+t.tonus();
+// psalm tone 1, differentia 1g:
+// intonatio F3–A3–C4, mediatio C4–A3–G3–A3, terminatio C4–A3–G3–A3–G3
+```
+
+## The liturgical stack
+
+The remaining engines compose:
+
+```js
+const [feast] = tonus.festum({ date: new Date("2026-12-25") });
+// nomen: "In Nativitate Domini", ritus: "Duplex I classis",
+// grade: "duplex-i", tempus: "Tempus Nativitatis"
+
+const [introit] = tonus.proprium({ feast, office: "in" });
+// "Puer natus est", mode 7, GABC from the Liber Usualis
+
+const score = tonus.notatio(introit, { temperamentum: t });
+// phrases, syllables, tuned pitches, arsis/thesis rhythm, prosody, imprint
+
+const harmony = tonus.harmonia(tonus.caelum({ date: feast.date }));
+// each visible planet voiced as pitch and Greek vowel, after Boethius
+```
+
+## Development
+
+```sh
+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.
+
+## License
+
+[MIT](LICENSE). Chant and liturgical data derive from GregoBase and Divinum
+Officium; see [BIBLIOGRAPHY.md](BIBLIOGRAPHY.md) for full attribution.

package/dist/data/cal.d.ts

@@ -0,0 +1,10 @@
+export interface CalEntry {
+    id: string;
+    name: string;
+    rank: number;
+    ritus?: string;
+}
+export declare const CAL_SANCTI: CalEntry[];
+export declare const CAL_TEMPORA: CalEntry[];
+export declare const CAL: CalEntry[];
+//# sourceMappingURL=cal.d.ts.map