tonus 0.1.4 → 0.1.6

package/BIBLIOGRAPHY.md

@@ -1,112 +1,159 @@
 # 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)
-- **Bloomfield, _Compline_ (github.com/bbloomf/compline, public domain)**
-  — reference dates & chants for the traditional Roman Compline ordo → [docs/chant.md](docs/chant.md#sources)
+- `gregobase` — **GregoBase.** <https://gregobase.selapa.net/>. Chant corpora in
+  GABC, extracted by book (GregoBase source IDs 2, 3, 48, 15):
+  - _Graduale sacrosanctæ Romanæ ecclesiæ de tempore et de sanctis_ (Graduale
+    Romanum). Ed. Solesmes. Tournai: Desclée, 1961 — 1,344 chants (`gr`).
+  - _Liber Usualis Missæ et Officii pro dominicis et festis cum cantu
+    Gregoriano_. Ed. Solesmes. Tournai: Desclée, 1961 — 2,377 chants (`lu`).
+  - _Liber antiphonarius pro diurnis horis_ (Antiphonale Romanum). Solesmes,
+    1960 — 1,422 chants (`la`).
+  - _Liber Hymnarius cum invitatoriis & aliquibus responsoriis_. Solesmes, 1983
+    — 361 chants (`lh`).
+  - _Antiphonale Monasticum pro diurnis horis_ (the monastic antiphonary).
+    Solesmes, 1934 — 1,429 chants (`am`). The classic Solesmes monastic edition,
+    carrying the rhythmic marks the score engine reads (not the 2005–07
+    restoration).
+- `divinum-officium` — **Divinum Officium.** The 1570–1962 Roman Breviary and
+  Missal in machine-readable form. <https://github.com/DivinumOfficium/divinum-officium>;
+  <https://divinumofficium.com/> — the liturgical calendar (642 entries), Mass
+  propers (926), Office hours (929 days), and the Psalterium (2,612 psalm + 579
+  canticle verses, Vulgate), plus the feast names, ranks (`ritus`), and Tempora
+  stem structure the seasons follow.
+- `graduale-toni-communes` — **Graduale Romanum appendix (Toni Communes).** Psalm
+  tones and differentiae, including the tonus peregrinus.
+- `versus-psalmorum` — **_Versus Psalmorum et Canticorum_ (No. 839).** Solesmes.
+  The psalm-verse formulas for the tones.
+- `bloomfield-compline` — **Bloomfield, _Compline_.** <https://github.com/bbloomf/compline>
+  (public domain). Reference dates and chants for the traditional Roman Compline
+  ordo.
 
 ## 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)
-- **Niedermeyer & d'Ortigue, _Gregorian Accompaniment_ (trans. Goodrich)** —
-  the per-mode cadence figures → [docs/tuning.md](docs/tuning.md#sources)
-- **Bragers, _A Short Treatise on Gregorian Accompaniment_ (1934)** —
-  cadence figures, cross-check → [docs/tuning.md](docs/tuning.md#sources)
-- **Homan, _Cadence in Gregorian Chant_ (1961)** — analytic study of
-  cadences → [docs/score.md](docs/score.md#sources)
-- **Murray, "Accentual Cadences in Gregorian Chant" (1958)** — spondaic and
-  dactylic verbal cadences → [docs/score.md](docs/score.md#sources)
-- **Suñol, _Textbook of Gregorian Chant According to the Solesmes Method_
-  (1930)** — modes, dominants, psalmody, the Solesmes rhythm doctrine →
-  [docs/tuning.md](docs/tuning.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)
+- `carroll-chironomy` — **Carroll, Joseph Robert. _The Technique of Gregorian
+  Chironomy_. Toledo, OH: Gregorian Institute of America, 1955.** Seven rhythmic
+  types, three melodic rules, chironomy.
+- `carroll-applied` — **Carroll, Joseph Robert. _An Applied Course in Gregorian
+  Chant_. Toledo, OH: Gregorian Institute of America, 1956.** Compound beats,
+  ictus placement.
+- `gajard-rhythm` — **Gajard, Joseph (trans. Aldhelm Dean). _The Rhythm of
+  Plainsong According to the Solesmes School_. New York: J. Fischer & Bro., 1945.** The arsis/thesis synthesis.
+- `mocquereau-nombre` — **Mocquereau, André. _Le nombre musical grégorien_,
+  1908–1927.** The Solesmes school's foundation.
+- `cardine-semiology` — **Cardine, Eugène. "Semiology and the Interpretation of
+  Gregorian Chant." Trans. Virginia A. Schubert; from the Festschrift for Joseph
+  Lennards.** The semiological approach the `restrained` pondus style reflects.
+- `desrocquettes-values` — **Desrocquettes, Jean Hébert. "Gregorian Musical
+  Values."** The Solesmes school's rhythmic values, from Mocquereau's collaborator.
+- `niedermeyer-ortigue` — **Niedermeyer, Louis, and Joseph d'Ortigue. _Gregorian
+  Accompaniment: A Theoretical and Practical Treatise upon the Accompaniment of
+  Plainsong_. Trans. Wallace Goodrich. New York: Novello, Ewer & Co.** The
+  per-mode cadence figures and the modal ethos epithets.
+- `bragers-treatise` — **Bragers, Achille P. _A Short Treatise on Gregorian
+  Accompaniment_. New York: J. Fischer & Bro., 1934.** Cadence figures, cross-check.
+- `homan-cadence` — **Homan, Frederic W. _Cadence in Gregorian Chant_. Ph.D.
+  diss., Indiana University, 1961.** The analytic study of chant cadences.
+- `murray-accentual` — **Murray, Gregory. "Accentual Cadences in Gregorian
+  Chant." _The Downside Review_, 1958.** The spondaic and dactylic verbal cadences.
+- `sunol-textbook` — **Suñol, Dom Gregory. _Textbook of Gregorian Chant According
+  to the Solesmes Method_. Trans. from the 6th French ed. Tournai: Desclée, 1930.** Modes, dominants, psalmody, and the Solesmes rhythm doctrine.
+- `apel-chant` — **Apel, Willi. _Gregorian Chant_. Bloomington: Indiana
+  University Press, 1958.** The analytic study of the repertoire.
+- `hiley-plainchant` — **Hiley, David. _Western Plainchant: A Handbook_. Oxford:
+  Clarendon Press, 1993.** The standard modern reference.
+- `treitler-voice-pen` — **Treitler, Leo. _With Voice and Pen: Coming to Know
+  Medieval Song and How It Was Made_. Oxford: Oxford University Press, 2003.**
+  Orality and notation.
+- `saulnier-guide` — **Saulnier, Daniel. _Gregorian Chant: A Guide_. CMAA
+  edition.** Chant introduction.
+- `pierik-spirit` — **Pierik, Marie. _The Spirit of Gregorian Chant_. Milwaukee:
+  Bruce, 1939; and _Gregorian Chant Analyzed and Studied_. St. Meinrad, IN:
+  Grail, 1951.** Chant interpretation.
+- `burkard-manual` — **Burkard, Dom Sisbert. _Manual of Plain Chant_. 1906.**
+  Plainchant instruction.
+- `kelly-capturing` — **Kelly, Thomas Forrest. _Capturing Music: The Story of
+  Notation_. New York: W. W. Norton, 2014.** Notation history.
+- `gregorio-gabc` — **The Gregorio project.** <https://gregorio-project.github.io/>.
+  The GABC plain-text chant notation the corpora are encoded in and the parser reads.
 
 ## 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)
+- `boethius-institutione` — **Boethius. _De institutione musica_ (c. 524),
+  esp. I.27.** The medieval transmission of Pythagorean interval math; also the
+  Boethius doctrina (conjunct diatonic planetary scale, transmitting Nicomachus).
+- `ptolemy-harmonics` — **Ptolemy. _Harmonics_ I.15–16 (the three diatonic
+  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.
+- `atkinson-nexus` — **Atkinson, Charles M. _The Critical Nexus: Tone-System,
+  Mode, and Notation in Early Medieval Music_. New York: Oxford University Press, 2009.** Tone-system, mode, and notation.
+- `reisenweaver-guido` — **Reisenweaver, Anna. "Guido of Arezzo and His Influence
+  on Music Learning." _Musical Offerings_ 3, no. 1 (2012).** Guido's pedagogy.
+- `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,
+  solmization, and musica ficta" (<https://www.medieval.org/emfaq/harmony/hex.html>).
+  Pythagorean tuning; hexachords and solmization; the consonance taxonomy.
+- `rockstro-grove` — **Rockstro, W. S. "Modes, The Ecclesiastical." In _A
+  Dictionary of Music and Musicians_ (Grove, 1st ed.).**
+  <https://en.wikisource.org/wiki/A_Dictionary_of_Music_and_Musicians/Modes,_The_Ecclesiastical>.
+  The church modes, their dominants and modulations in rank order.
+- `powers-wiering-mode` — **Powers, Harold S., and Frans Wiering, et al. "Mode."
+  _Grove Music Online_, 2001, §§I–III.**
+  <https://doi.org/10.1093/gmo/9781561592630.article.43718>. Medieval modal theory.
+- `liber-usualis` — **_The Liber Usualis, with Introduction and Rubrics in
+  English_. Ed. the Benedictines of Solesmes. Tournai: Desclée, 1961.** The
+  introduction's "Rules for Interpretation" and rubrics — the original design
+  source for the GABC parser and rhythm model: the notation and neume taxonomy,
+  the three ictus rules, accidental scope, bar-line/breathing semantics, psalmody
+  structure, and Latin diction. (A structured extract is kept at
+  `~/Documents/Projects/Liber_Parsed/`. The book itself is also a chant corpus
+  source — see `gregobase`.)
+- `scala-format` — **Scala scale archive and `.scl` format. Manuel Op de Coul,
+  Huygens-Fokker Foundation.** <https://www.huygens-fokker.org/scala/scl_format.html>.
+  Custom tuning input.
+- `guidonian-gamut` — **Guido of Arezzo's gamut and solmization, and the
+  eight-mode system, as standardized in medieval theory** (gamut, hexachords,
+  modes, psalm tones).
+- `wikipedia-tuning` — **Wikipedia:** [Pythagorean tuning](https://en.wikipedia.org/wiki/Pythagorean_tuning),
+  [Meantone temperament](https://en.wikipedia.org/wiki/Meantone_temperament),
+  [Gregorian mode](https://en.wikipedia.org/wiki/Gregorian_mode). General-reference
+  orientation for the temperaments and the modal system.
 
 ## 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)
+- `godwin-harmonies` — **Godwin, Joscelyn. _Harmonies of Heaven and Earth: The
+  Spiritual Dimension of Music from Antiquity to the Avant-Garde_. London: Thames
+  & Hudson, 1987.** Planetary scale taxonomy (Types A/B/C) and per-author analyses.
+- `godwin-spheres` — **Godwin, Joscelyn, ed. _The Harmony of the Spheres: A
+  Sourcebook of the Pythagorean Tradition in Music_. Rochester, VT: Inner
+  Traditions, 1993.** Primary-source translations used to verify ratio and
+  tone-name claims.
+- `godwin-vowels` — **Godwin, Joscelyn. _The Mystery of the Seven Vowels in Theory
+  and Practice_. Grand Rapids: Phanes Press, 1991.** Planetary vowel attestations;
+  the Moon→Saturn vowel order after Nicomachus.
+- `doctrina-primaries` — **The doctrina primary sources:** Nicomachus of Gerasa,
+  _Manual of Harmonics_ (c. 100) and _Excerpta ex Nicomacho_; Plato, _Republic_
+  X, 617b (Myth of Er); Pliny the Elder, _Naturalis historia_ II.xx (c. 77, with
+  octave closure per Censorinus and Theon of Smyrna); Ptolemy, _Harmonics_ III.
+  With the vowel–planet attestations: Porphyry, Marcus Gnosticus, Demetrius of
+  Phaleron, Eusebius of Caesarea, Barthélemy of Edessa (via `godwin-vowels`).
 
 ## 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)
+- `standish-jpl` — **Standish, E. M. "Keplerian Elements for Approximate
+  Positions of the Major Planets." JPL Solar System Dynamics, 1992 (updated for
+  DE430).** <https://ssd.jpl.nasa.gov/planets/approx_pos.html>. The orbital
+  element tables.
+- `schlyter-positions` — **Schlyter, Paul. "Computing planetary positions — a
+  tutorial with worked examples." Stjärnhimlen.**
+  <https://www.stjarnhimlen.se/comp/tutorial.html>. The Sun and Moon position
+  formulae.
+- `computus` — **Easter computus: the Gregorian algorithm (Gauss/Butcher) and,
+  before 1583, the classical 19-year Julian cycle with Julian→Gregorian day-number
+  conversion.** See [Computus](https://en.wikipedia.org/wiki/Computus).
+- `wikipedia-calendar` — **Wikipedia:** [Tridentine calendar](https://en.wikipedia.org/wiki/Tridentine_calendar),
+  [Ranking of liturgical days in the Roman Rite](https://en.wikipedia.org/wiki/Ranking_of_liturgical_days_in_the_Roman_Rite).
+  General-reference background for the era and the grade precedence.

package/CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+All notable changes to tonus. Newest first.
+
+## 0.1.6
+
+- **The monastic Office.** `officium({ rite: "monasticum" })` assembles the
+  Benedictine cursus — the little hours, Lauds, Vespers, Compline, and Prime —
+  from the Antiphonale Monasticum, with the monastic psalm distribution
+  (Compline is Ps 4, 90, 133). The Roman rite is the default; the two share a
+  calendar. Monastic Matins is served flat (its nocturn structure is future
+  work). Also adds the Antiphonale Monasticum (1934) as a retrievable chant
+  source: `cantus({ source: "am" })`, 1,429 chants.
+- **Guidonian hand** corrected to the canonical counter-clockwise spiral (it had
+  filled linearly). The `Finger`/`Region` types are tightened (`wrist`/`palm`
+  removed, `super` added).
+- **Double mora** (`..`) now lengthens correctly, and `Note.context` /
+  the tabula row carry `mora: 0 | 1 | 2` (was a `doubleEpisema` boolean) so the
+  single/double distinction is available for scoring.
+- **f-clef** pitch mapping fixed (f3/f4 were a third off).
+- Internal: generated corpus data separated from hand-authored tables;
+  `office-psalms` → `office-psalms-roman`.
+
+## 0.1.5
+
+- **Rhythmic types** (`phrase.rhythmicType`, `phrase.beats`) — Le Guennant/Carroll
+  incise classification IV–VIII over the compound-beat sequence, with Type VIII
+  (contraction) after Suñol. The `beats` sequence is the shared derivation the
+  chironomy renderer will read.
+
+## 0.1.4
+
+- **Modulation detection** (`score.modulations`) — where the tonal centre leans
+  away from the home mode, calibrated against Suñol.
+- **Richer modal affinity** — degree-, ictus-, and cadence-weighted, with ranked
+  initials after Rockstro.
+- **`modus()`** tunes its finalis, tenor, and ambitus through the temperamentum.
+
+## 0.1.3
+
+- **Cadence detection** (`score.cadences`) — per-mode melodic cadence figures,
+  after Niedermeyer & d'Ortigue.
+- Psalm tones _in directum_ and solemn mediants.
+- Suñol-derived neum timing (salicus, oriscus).
+- The Latin modal ethos.
+
+## 0.1.2
+
+- **Little-hours psalmody** (Terce, Sext, None) — Ps 118 in course, from the
+  extracted Divinum Officium Tridentine scheme. The Divine Office is now complete
+  across all eight hours.
+
+## 0.1.1
+
+- **Prime and Compline** office hours — the seasonal ordos, assembled from
+  existing corpus chants.
+
+## 0.1.0
+
+- Core release: tuning (`temperamentum`), calendar (`festum`/`pascha`), chant
+  (`cantus`/`proprium`/`ordinarium`/`officium`/`psalmus`), score
+  (`notatio` → MIDI/MusicXML), heavens (`caelum`/`harmonia`).

package/README.md

@@ -44,10 +44,13 @@ One page per engine, in dependency order. Each page states its rules, then its t
   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.
+These pages are the middle of a three-level ladder: the API docs here link down
+into the code, where the full theory, provenance, and editorial reasoning live in
+comments beside what they explain. Read as deep as you care to. Sources for
+concepts, scholarship, and data are listed in
+[BIBLIOGRAPHY.md](BIBLIOGRAPHY.md); where sources disagree or run out, **tonus**
+makes an editorial call, recorded in the code and glossed in the page's Theory &
+Context section.
 
 ## The tuning engine
 
@@ -93,11 +96,6 @@ const harmony = tonus.harmonia(tonus.caelum({ date: feast.date }));
 // each visible planet voiced as pitch and Greek vowel, after Boethius
 ```
 
-## Roadmap
-
-SVG chant engraving, an interactive documentation site,
-and cadence detection is laid out in [ROADMAP.md](ROADMAP.md).
-
 ## Development
 
 ```sh

package/dist/data/am.d.ts

@@ -0,0 +1,5 @@
+import type { Chant } from "./types.js";
+import type { ChantData } from "./gr.js";
+export declare const AM_SOURCE: Chant["source"];
+export declare const AM_DATA: ChantData[];
+//# sourceMappingURL=am.d.ts.map