tonus 0.11.0 → 0.11.1

package/dist/engines/chant/chant.js

@@ -149,7 +149,19 @@ const CORPUS = [
 // still resolve to exactly one chant — the census contract says so in as many
 // words. So they stay addressable by `id`, by `office: "or"`, and by
 // `ordinary`, and stay out of the shelf's book list and row count.
-const KYRIALE_CHANTS = KYRIALE.map(entryToOrdinaryChant);
+//
+// Not shelved, but CITED: each entry carries the books that print it (gr, lu)
+// and their pages, so its by-book map is registered here the same way a corpus
+// record's is. That is what lets `cantus({ id, source: "lu" })` answer with the
+// Liber Usualis's leaf number instead of nothing.
+const KYRIALE_CHANTS = KYRIALE.map((entry) => {
+    const chant = entryToOrdinaryChant(entry);
+    const byBook = entry.pages;
+    if (byBook && !Array.isArray(byBook)) {
+        PAGES_BY_BOOK.set(chant.id, byBook);
+    }
+    return chant;
+});
 /** Everything nameable: the shelf, plus the ordinary that no shelf holds. */
 const ADDRESSABLE = [...CORPUS, ...KYRIALE_CHANTS];
 let _byId = null;

package/dist/engines/chant/ordinary.js

@@ -280,11 +280,21 @@ export function entryToOrdinaryChant(entry) {
     const ordinary = ORDINARY_OFFICES.has(entry.office)
         ? entry.office
         : "ke";
+    // The Kyriale's citation. `ky` is a category, not a volume, so it can never
+    // be cited — which is why these chants shipped with books: ["ky"] and no page
+    // at all, and nothing downstream could name where to find them. But they ARE
+    // printed: the extractor now carries the Graduale's and the Liber Usualis's
+    // listings on every entry. `books` is those volumes, owner first; `pages` is
+    // the OWNER's, exactly as chant.ts's withLabels() does for a shelf record —
+    // presentAs() swaps in the asked-for book's when a caller names one. An entry
+    // with no citation still falls back to its own printing, so it stays findable.
+    const books = (entry.books?.length ? entry.books : ["ky"]);
+    const pages = entry.pages?.[books[0]] ?? [];
     return {
         id: entry.id,
         incipit: entry.incipit,
         gabc: entry.gabc,
-        books: ["ky"],
+        books,
         office: "ky",
         // The genus follows the office code, as everywhere else — OFFICIA.ky.
         // It read "Ordinarium" while the office read "or", which was tonus's own
@@ -292,7 +302,10 @@ export function entryToOrdinaryChant(entry) {
         genus: OFFICIA.ky,
         mode: entry.mode ? String(entry.mode) : null,
         modus: entry.mode ? (MODI[String(entry.mode)] ?? null) : null,
-        pages: [],
+        pages,
+        // Still KY_SOURCE: the bibliographic note says a singer is holding the
+        // Kyriale, which is true, and is a different claim from which shelved
+        // volumes print it. `books` carries that.
         source: KY_SOURCE,
         ordinary,
         ordinarium: ORDINARIA[ordinary] ?? entry.incipit,

package/docs/api/chant.md

@@ -311,6 +311,18 @@ The Kyriale is a **partition of the Graduale**, so it is not a `source` and not
 a row in the shelf. It stays nameable by `id` and by the part of the Mass it
 belongs to.
 
+It is not a book, but it is **printed in** books, and it says which: every
+ordinary chant carries `books: ["lu", "gr"]` and the Graduale's and the Liber
+Usualis's pages, so it can be cited like anything else on the shelf.
+
+```js
+tonus.cantus({ id: "gregobase:31", source: "gr" })[0].pages; // [{ page: "28*", … }]
+tonus.cantus({ id: "gregobase:31", source: "lu" })[0].pages; // [{ page: "37",  … }]
+```
+
+`source` stays `ky` when no book is named — the note a singer holding the
+Kyriale would want — and `ky` is still absent from the book registry.
+
 A plain search does not sweep it in: `{ mode: 5 }` returns the shelf. Ask for a
 Kyrie and you get Kyries.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tonus",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "type": "module",
   "description": "Medieval music analysis: GABC plainchant exports, liturgical calendar, tuning systems, ephemeris, and the harmony of the spheres",
   "author": "Jeffrey Pierce <jeffrey@jeffreypierce.net>",