Liturgia

Hoc dominium magnum et complexum est. Hae notae concisae manere debent ut utiles sint.

Dominium datorum liturgicorum et quomodo hoc API illud repraesentet. Exemplum dominii est, non tabula rerum constructarum. Notae indicant ubi forma electio deliberata vel limes est; Limites quae non praebemus enumerant.

Quae API praebeat

Pro (calendar, region, date), resolvit et reddit:

1. Contextum diei: diem civilem et hebdomadis, tempus (cum hebdomade), cyclos anni liturgici (lectionarium OF A/B/C, feriae I/II, hebdomadem psalterii), statum praecepti.
2. Celebrationem: quid dies sit: nomen pluribus linguis, gradum, colorem, formam brevem sancti, categorias Communis, sodalitatem octavae.
3. Commemorationes: alios sanctos ut orationes additas inclusos.
4. Festa hodierna: quemque sanctum huic diei pertinentem, exitu signatum (celebratum / commemoratum / omissum / adveniens), ut «cuius festum est?» non indigeat interpretatione resolutionis (§6).
5. Missam vel Missas: propria (Introitus … Postcommunio) et lectiones (citationem et textum); plures cum dies complures habet, ut Nativitas, vigiliae, Requiem.
6. Officium: octo horas compositas (psalmos, antiphonas, hymnum, capitulum, canticum, collectam), primis et secundis Vesperis distinctis.
7. Resolutionem ad libitum: cur hoc officium praevaluerit, quis commemoratus, omissus, translatus vel non observatus sit.
8. Sanctos: secundum ritum adibiles (/{calendar}/saints/{id}).

Omnis textus hominibus legibilis tabula { la, en, … } est, Latina semper praesente. Liturgia resolutio est: temporale (tempora ex Paschate) et sanctorale (festa fixa) utrumque officium proponit; praecedentia (occurrentia intra diem, concurrentia in marginibus eius) praecipuum et exitum reliquorum eligit; praecipuum Missam et Officium praebet, composita Proprium → Commune → Psalterium.

Puncta extrema

Regula collocationis. Subsidia inter ritus summo gradu sunt (/calendars, /saints, /regions); subsidia uni ritui sub /calendars/{cal} ponuntur. Dies summarium leve reddit; partes graves vel intra responsum per ?include= (ad copiam) vel ut subsidia separatim adibilia (ad nexum directum) veniunt. Utrumque adest; vide Inclusiones.

Inclusiones. ?include=masses,office,resolution,martyrology illas partes graves intra responsum diei (vel cuiusque diei intervalli vel anni) includit, ut aspectus usitatus «mensis lectionum» una petitio sit, non 1 + N. URL subsidiorum (…/masses, …/office/{hour}, …/resolution) ad nexus directos adibiles manent. Sine include, dies solum summarium et links est.

Collectiones (/days?from..to, /years/{label}, utraque quaestio /saints) involucrum reddunt, numquam seriem nudam, ut quaestio repetita, summae, paginae et limites adhibiti appareant:

{ "results": [ … ], "query": { … echoed, incl. region }, "page": { "total": 342, "next": "…cursor…" },
  "warnings": [ "span capped to 90 days" ] }   // warnings only when something was clamped

Series intra unum subsidium, ut saints.* et readings, campi subordinati limitati sunt; collectiones non sunt et nudae manent.

Identificatores et conventio.

• Dies: dies specificus est ISO integer YYYY-MM-DD; festum recurrens fixum est MM-DD; festum mobile obiectum anchor est (§2). Annus liturgicus propriam identitatem habet: {label} canonicum est spatium ab Adventu ad Adventum YYYY-YYYY (e.g. 2025-2026), ambiguitatem unius anni «incipit in / finit in» removens. Solum YYYY (annus qui in Adventu YYYY incipit) vel quilibet dies contentus per 301 ad spatium canonicum dirigitur, ut unus annus = unum URL.
• region est restrictio quaestionis ad libitum; pars viae non est quia ad libitum est. Omissum vel ignotum → general (editio typica), leniter, numquam errorem producens, repetitum cum region_default_applied. {cal} autem pars structuralis est, ideo cal malum 404 reddit.
• Identificatores viae magnitudinem litterarum neglegunt. {cal} (ordinary/traditional/dominican, sine nominibus alternis), {hour} et {mass} omnes sine discrimine maiuscularum resolvuntur (Traditional, Vespers, MIDNIGHT omnes valent); identificator vere ignotus adhuc 404 reddit. Haec lenitas petenti solum prodest.
• Lingua per Accept-Language eligitur, conventione contenti, non per viam vel parametrum. Latina semper adest, ideo restrictio solum addit et 406 numquam fit. Responsa Vary: Accept-Language mittunt.
• Translatio secunda dimensio est, a lingua distincta: intra unam linguam plures editiones Scripturae sunt (en: douay, cpdv; la: vulgate Clementina, cum Nova Vulgata futura), et usor unam praeferre potest. Per parametrum quaestionis translations ad libitum eligitur; editions= nomen canonicum est, campo responsi respondens, cum translations= ut nomine alterno accepto. Index identificatorum editionum commatibus distinguitur (editions=cpdv,vulgate), ad summum una pro lingua, solum ad text lectionum applicata; citationes et omnis textus extra Scripturam a translatione independentes sunt. Ignotum vel absens → editio praestituta pro lingua, leniter sine errore, per editions repetita, cum elemento warnings in collectionibus cum petitio ad praestitutam rediit. Quisque text lectionis resolutus editione edition quae eum produxit signatur, ut responsum numquam ambiguum sit. /liturgy/v1/translations editiones pro lingua praesto enumerat; series electa in Vary et ETag infra includitur. Cur parametrum quaestionis: nota linguae HTTP Accept-Language linguam eligit, non editionem publicatoris intra eam; ea onerata (en-x-cpdv) insolita est et a CDN linguas intellegentibus reponi non potest.
• Formae breves sanctorum in duobus spatiis nominum sunt: id uni ritui et person canonica. Nexus inter eas necessarii sunt: tabula ritus person habet (nexum sursum), calendars{} personae ref habet (nexum deorsum). Neuter identificator finis clausus est.

Repositio. Responsum functio pura (cal, date, region, Accept-Language, translations, data-version) est. ETag omnia sex includit, non solam viam, ne CDN via et Vary signatum variantem regionis, linguae vel translationis male praebeat; et emendatio datorum vel nova tabula regionis data-version promovet, omne ETag affectum mutans. Hoc instrumentum invalidationis dierum praeteritorum est, qui diu reponuntur sed numquam immutable sunt. If-None-Match → 304.

Versiones et cursus vitae. /liturgy/v1 intra versionem maiorem addit: campi addi possunt (formae Quaestionum apertarum addentur), numquam removeri vel typum mutare. Novae editiones et regiones ut data (§2) veniunt. Mutatio pactum frangens ut /liturgy/v2 editur; vetus versio deinde diem remotionis per titulos responsi Deprecation et Sunset accipit (monitio saltem 12 mensium), et campi obsoleti nexum Deprecation in documentis habent. Nihil in v1 tacite mutatur.

Errores sunt application/problem+json (RFC 9457) cum URI type machinario stabili, title, status, detail et instance:

• 400: notitia male formata, ut dies non canonicus cum zeris YYYY-MM-DD vel valor include extra seriem permissam.
• 404: {cal}, {person}, {id} ignotum vel {hour}/{mass} quod hic dies non praebet.
• 405: verbum extra GET in via valida (API ad solam lectionem est); titulum Allow: GET habet.
• 406: numquam redditur: Latina semper adest, ideo quilibet Accept-Language satisfieri potest.
• 422: petitio bene formata quam editio praebere non potest, ut dies extra spatium sustentum.
• 429: frequentia limitata, cum Retry-After.
• region malum, editio translations ignota vel from/to ultra limitem numquam error est: redit ad praestitutum vel restringitur, valore adhibito repetito (region_default_applied / editions) et elemento warnings in collectionibus.

Consuetudines.

• Genus medii application/json; pactum machinarium canonicum documentum OpenAPI 3.1 publicatum (/liturgy/v1/openapi.json) est. Clientes ex eo generantur, et auctoritas cuiusque formae hic adumbratae est.
• Sola lectio et idempotentia. Quodque punctum extremum GET est, ideo tutum, idempotens et reponibile; nullae scriptiones sunt, ideo claves idempotentiae non requiruntur.
• Authenticatio et limites. Petitiones clavem API baiulam (Authorization: Bearer gianna_…) habent, in applicatione a qualibet ratione creatam (POST /api/keys, semel ostentam; administra vel revoca per GET/DELETE /api/keys). Sessio navigatoris quae accessit etiam ad usum intra applicationem valet. Haec data gratuita sunt: rationem requirunt, subscriptionem non requirunt. Non authenticatum → 401, cum WWW-Authenticate: Bearer; sessio visitatoris anonyma → 403. Index servitii, openapi.json et fontes feasts.ics publici sunt et clave non indigent. Limites frequentiae intervalla fixa pro familia sunt, per 429 et Retry-After imposita, cum RateLimit-Limit in 429; limitatio IP in fronte procuratoris inversi est. Authenticatio et gradus repraesentationem non variant, ideo clavem repositi non ingrediuntur.
• Tituli repositionis. Quodque responsum ETag cum Cache-Control: public, max-age=… limitato et stale-while-revalidate habet. Dies praeteriti diuturnum max-age accipiunt quia responsum rubricale stabile est, sed non immutable signantur: emendatio datorum vel nova tabula region etiam resolutionem historicam mutare potest, et immutable exemplum obsoletum perpetuo figeret. ETag, quod versionem datorum, regionem et seriem linguarum includit, instrumentum invalidationis est; clientes per If-None-Match revalidant. Responsa public sunt quia repraesentatio secundum petentem numquam variatur, sed API aditus restringitur, ideo repositum marginale ab operatore rectum clavem baiulam ante responsum ex reposito requirere debet. Noli repositum commune anonymum ante /liturgy/v1 ponere.
• «Hodie». Subsidium «hodie» in servitore non est: dies liturgicus diem civilem petentis sequitur, quem servitor UTC decernere non debet. Clientes diem localem resolvunt et explicite petunt (…/days/2026-06-09). Accept-Language/region diem numquam implicant.
• Custodia sumptus ?include. include recusatur (400) in collectionibus plurium dierum pro partibus gravibus (office, masses) ultra parvum spatium (e.g. > 31 dies), ne intervallum annuum responsum immensum petere possit; ad illa utere subsidiis pro die. resolution, leve, semper includi potest.

1. Calendaria (ritus)

Systema sui iuris, cum proprio sanctorali, praecedentia, propriis et editione. Dies independenter in singulis resolvitur, ideo praecedentia pro ritu (§4) est, non globalis.

Quisque unum identificatorem stabilem habet, ordinary, traditional, dominican, sine nominibus alternis, et declarat utrum Officium praebeat.

Nota: una nomenclatura ubique. Haec tria verba nomina per totum productum sunt: praeferentia calendarii familiae servata et /api/prefs applicationis, instrumentum liturgiae agentis et verba usoribus ostenta exacte ordinary / traditional / dominican adhibent. Priores identificatores et nomina alterna (roman-ordinary, roman-1962, general, of, tlm, op) una mutatione nominum pactum frangente ante externos usores API remota sunt. Hic 404 reddunt, punctum praeferentiarum ea recusat et migratio 0029 ordines servatos rescripsit. Synonyma humana («TLM», «Missa Latina», «Forma extraordinaria», «Novus Ordo») lingua naturalis sunt: pars LLM ea ad verbum canonicum refert; interpretes sola tria accipiunt, sine discrimine magnitudinis litterarum.

2. Notitiae resolutionis: ritus, annus, regio

Temporale: mobile, Paschati innixum (→ Septuagesima, Feria quarta Cinerum, Ascensio, Pentecostes, numeri dominicarum; Adventus alterum finem figit). Functio anni.

Nota: Pascha calculatur. Per computum Gregorianum occidentalem; omnis dies mobilis ex eo pendet, ideo algorithmus nominatus et tabula regressionis dierum notorum definiuntur. Computus orientalis Iulianus et rationes historicae divergentes extra ambitum sunt.

Sanctorale: tria genera, non solum «mensis et dies»:

• fixum: mensis et dies, ab anno independens (Nativitas 25 Decembris). Maxima pars.
• mobile: temporali per regulam innixum (Sancta Familia = dominica infra octavam Nativitatis, aliter 30 Decembris; Sacrum Cor = feria sexta post octavam Corporis Christi). anchor habet.
• mobile, inter ritus diversum: regula fundamenti secundum ritum differt (Christus Rex = ultima dominica ante Adventum in OF, ultima dominica Octobris in 1962). Fundamentum proprietas (feast, rite) est.

{ "id": "sacred-heart", "kind": "moveable",
  "anchor": { "base": "corpus-christi-octave", "offset": "friday-after" } }
// base: a named temporale point (easter | pentecost | corpus-christi | advent | epiphany |
//   christmas | <-octave variants>);  offset: nth-weekday-after/before | sunday-within | n-days

Nota: editiones interne per partes differentes componuntur, sola inventa coniuncta eduntur. Versio tabula fundamentalis et partes reformationum est (1568 → … → 1960): ars constructionis, non dimensio exposita. Nullus selector anni rubricarum; «1939» petere non potes. Electio editionis futura est (Limites).

Regio: tres effectus rubricales, duo exemplati: qui dies festi ad dominicam transferantur (pro conferentia: Epiphania, Ascensio, Corpus Christi), qui de praecepto sint (§3a). Etiam festa propria, patronorum, confert; haec non exemplata sunt (Limites).

Nota: regio munere vero conferentiae angustior est. Festa propria quae confert praecedentiam afficiunt (sollemnitas patroni diem mutat), sed solum translationem et praeceptum exemplamus. general praestitutum est editio typica; Ascensionem, Epiphaniam et Corpus Christi in feria retinet quamvis plurima pars mundi dominica observet. Translatio vel praeceptum ex praestituto lectum responsum editionis typicae dat, non civitatis. Tabulae pro conferentia data sunt, tempore addita.

Annus liturgicus: prima dominica Adventus incipit; annus civilis duos continet. Cycli OF ex eo pendent:

"liturgical_year": {
  "starts": "2025-11-30",
  "sunday_cycle":  "C",   // OF A|B|C — rolls over at ADVENT;  null for 1962
  "weekday_cycle": "II",  // OF I|II  — rolls over at 1 JAN;   null for 1962
  "psalter_week":  2      // OF 1–4   — null when overridden
}

Nota: duo cycli diebus diversis renovantur. Cyclus dominicalis in Adventu mutatur; cyclus ferialis (I = anni civiles impares) 1 Ianuarii, medio anno. Unum starts utrumque derivare non potest, ideo utrumque resolutum praebetur. Cycli null in 1962 sunt, quia annui. psalter_week etiam extra 1962 saepe null est: sollemnitates et festa hebdomadem I accipiunt, et octavae, dies finales Adventus et Hebdomada sancta psalterium substituunt. Indicium solis diebus ordinariis est, numquam series plana 1–4.

3. Dies liturgicus

Punctum diei summarium reddit: nucleum levem et nexus. Officium, propria Missae integra et resolutio petitiones separatae sunt, secundum tabulam supra. Summarium:

{
  "calendar": "traditional", "region": "general",
  "region_default_applied": true,  // true only when the caller named no region (§2)
  "editions": { "la": "vulgate", "en": "douay" },  // scripture edition per language, always present (§10)
  "date": "2026-01-28",       // CIVIL date (see note)
  "weekday": "wednesday",     // CIVIL weekday of the civil date
  "liturgical_year": { /* §2 */ },
  "season":     { "id": "epiphany", "arc": "after-epiphany", "week": 3 },  // §5
  "obligation": { /* §3a */ },
  "celebration":    { /* below — the headline, singular */ },
  "saints": {                  // §6 — THE field for "whose feast day is it?"
    "celebrated":   [ { "name": {…}, "id": "…", "person": "…", "rank": {…} } ],
    "commemorated": [ /* sanctoral commemorations; never the feria */ ],
    "associated":   [ /* fixed-date saints in this calendar, independent of precedence */ ],
    "remembered":   [ { "name": "Ss. Primus and Felician" }, … ]  // notes via ?include=martyrology
  },
  "masses": [ { "id": "day", "name": {…}, "colour": {…}, "option_type": "prescribed" } ],
  "links": { "office_url": "…", "masses_url": "…", "resolution_url": "…" }
}

Nota: saints tabulas separatas servat. celebrated/commemorated exitus liturgici HUIUS calendarii sunt; feria sanctus non est et numquam apparet. associated index sanctorum dierum fixorum calendarii electi est, ideo praecedentia conexionem diei festi non delet. remembered Martyrologium Romanum est: OMNIS sanctus diei, saepe 5–15, sive alicubi celebratus sive non. Editio anni 1916 iuris publici interne servatur; sancti postea canonizati ab ea absunt, cum pars calendarii eos habet. Dies eius calendarium vetus sequuntur ubi differunt. Exitus resolutionis futuri (transferred, omitted) ut claves novae adduntur. remembered[].name solum Anglice est (Limites). Nomina semper adsunt; elogium note cuiusque tabulae per ?include=martyrology includitur, inclusione gravi spatio sicut masses/office limitata. Elogia per 90 dies maximam partem responsi efficerent. Responsa per gzip comprimuntur cum conventum est.

Nota: summarium descriptiones Missarum enumerat. masses[] levia { id, name, colour, option_type } pro Missa habet; propria per masses_url vel ?include=masses veniunt. Solus numerus alteram petitionem ad identitates Missarum cognoscendas requireret; insuper celebration.colour color diei est, qui in die plurium Missarum differt ubi quaeque proprium colorem habet (Requiem nigrum est dum dies albus legitur, §7). colour pro Missa hic auctoritatem ad cellulam diei ostendendam habet.

Nota: dies civilis clavis est; duo facta distincta «vesperae sabbati». (Apertum.) Die civili signamus, quia mutatio clavis «da mihi 2026-06-09» ambiguum faceret, et extensionem vespertinam ut relationes explicitas separatas exemplamus: primae Vesperae (rubricale: Officium diei sequentis hoc vespere dicitur; liturgical_evening.belongs_to) et Missa anticipata (canonicum: Missa vespere sabbati praeceptum dominicale implet; anticipated_mass). Officium crastinum esse potest dum Missa dicta adhuc hodierna est. Apertum: forma exacta eorum.

3a. Praeceptum: regione pendet, ex gradu non derivatur.

"obligation": {
  "status": "lapsed",                        // yes | no | lapsed
  "reason": "falls on a Monday in region X", // display
  "reason_code": "lapses-monday"   // null | lapses-saturday | lapses-monday | transferred | not-precept-in-region
}

Nota: tres status et instrumentum machinarium. Valor logicus regulam praecepti partialis, quod sabbato vel feria secunda cessat, sine mutatione annua ferre non potest; reason_code instrumentum programmaticum iuxta prosa est. In general, typica, responsum est lex universalis: omnis dominica et decem dies canonis 1246, octo fixi et mobiles Ascensio et Corpus Christi, cum reason eos nominante. Ex gradu NON derivatur; pleraeque sollemnitates praeceptum non habent. Cessatio vel translatio pro regione (reason_code, lapsed) cum tabulis regionum completur.

Celebratio

{
  "name":  { "la": "S. Petri Nolasci Confessoris", "en": "St. Peter Nolasco, Confessor" },
  "rank":  { "label": "class-3", "precedence": 711, "cycle": "sanctorale" },  // §4
  "colour": { "default": "white", "alternatives": [] },                       // §5
  "id":     "petrus-nolascus",     // RITE-SCOPED slug → /{calendar}/saints/{id}
  "person": "peter-nolasco",       // canonical link UP → /liturgy/v1/saints/{person} (§11) — mandatory
  "titles": ["confessor"],         // category SET → Common(s) (§8)
  "octave": null                   // or { "of", "day" } (§9)
}

Nota: forma brevis uni ritui pertinet; person sursum conectit. Idem sanctus gradu, nomine, etiam die inter ritus differre potest, ideo id celebrationem huius ritus designat. person nexus necessarius sursum ad tabulam canonicam inter ritus (§11) est, cuius calendars{} retro deorsum conectit. Duo spatia nominum formarum brevium numquam colliduntur quia quisque identificator semper alteri iungitur.

4. Gradus, praecedentia, resolutio

Pars maxime codificata. Duae quaestiones: occurrentia (duo officia, eadem dies: quis celebretur, commemoretur, omittatur, transferatur) et concurrentia (secundae Vesperae unius officii primis sequentis occurrunt: cui pertineant; §8).

Gradus secundum ritum differunt. 1962/Dominicanus: quattuor classes I–IV, commemorationes et feria; classis festi et diei (dominica, feria, vigilia, dies octavae) miscentur. Feria I classis festo I classis praevalet; dominica II classis festo III classis praevalet, quod deinde commemoratur. OF: Sollemnitas > Festum > Memoria > Memoria ad libitum > Feria (tabula anni 1969).

Nota: «dominica» ipsa plures gradus habet. 1962: dominicae I classis (Adventus, Quadragesima, tempus Passionis, paene nihil admittunt) et II classis (dominicae virides quas festum II classis dimovere potest). OF simile est: dominicae Adventus, Quadragesimae et Paschatis omnibus festis praevalent; dominicae per annum Festis Domini cedunt. Gradus dominicae specificam classem habet, numquam unum gradum.

"rank": { "label": "class-1", "precedence": 910, "cycle": "temporale" }
// label = native grade; precedence = sortable (higher outranks); cycle = which PROPOSED it

Notae de rank.

• cycle = cyclus proponens: dominica vel feria temporale est quamvis classis diei sit, non festum; illud discrimen in label est.
• precedence solum intra unam resolutionem comparat, unum ritum et unum diem. Comparatio inter ritus sensu caret; numquam festum anni 1962 contra OF resolvis (§1).
• precedence ordinat; non decernit. (Apertum.) Aliqua praecedentia condicionalis est: Festum Domini dominicam per annum dimovet, sed non Adventus, Quadragesimae vel Paschatis. Duobus numeris integris decerni non potest; machina tota tabula utitur, numerus solum exitus est. Apertum: regulam an solum exitum eius exponere?
• Dies non unus gradus scalaris est: Missa, horae diurnae et duae Vesperae singulae ad diversa officia resolvi possunt per concurrentiam, separatim adibilia (§7/§8).

Resolutio ad libitum: consilium integrum, non solum praecipuum:

"resolution": {
  "winner": "sanctorale",
  "displaced": [
    { "name": {…}, "outcome": "commemorated" },
    { "name": {…}, "outcome": "omitted" },
    { "name": {…}, "outcome": "not-observed" },  // dropped for the year
    { "name": {…}, "outcome": "transferred", "chain": ["2026-01-28","2026-01-30"] }
  ]
}

Translatio. Festum impeditum gradu satis alto movetur ad proximum diem liberum, iterum si ille occupatus est. Haec catena in fine Adventus, octava Nativitatis et Hebdomada sancta fieri potest. Si nullus dies ante limitem est, hoc anno non observatur. Ita festum ex die priore advenire potest (transferred_from/transferred_to), in tabulis saints novi diei per from ostentum (§6). outcome distinguit transferred (alio motum), not-observed et omitted (mansit, nihil dictum).

Nota: dominicae resumptae alius motus sunt. (Apertum.) Dominica impedita post Epiphaniam vel Pentecosten hebdomadibus postea ante Adventum resumi potest. Translationi simile est sed forma festi caret, ideo catena non convenit. Non exemplatum: solum die celebrationis apparet, sine nexu retro. Apertum: relatio resumes:.

5. Tempora et color

"season": { "id": "lent", "arc": "after-epiphany", "week": 3 }
// arc: 1962 counting arc, null for OF;  week: within the arc (see note)

Identificatores: advent · christmas · (1962:) epiphany · septuagesima · passiontide · pentecost (arcus after-pentecost) · (utrumque:) lent · easter · (OF:) ordinary. Tempus Ascensionis intra easter est; tempus post Pentecosten anni 1962 pentecost et arc est, non identificator separatus. Hebdomades ab 1 numerantur et dominica figuntur: hebdomas initii arcus medio hebdomadis, ut dies Cinerum vel post Epiphaniam, hebdomas 1 est. Tempus Nativitatis OF usque ad vigiliam Baptismatis durat; tempus Nativitatis anni 1962 tempore Epiphaniae die 6 Ianuarii cedit. Tempora colorem, mutationes cantus Missae (§7), utrum Gloria, Alleluia et Te Deum dicantur et recursum ferialem vel Communis regunt.

Nota: quid week numeret. Numerator globalis non est. 1962 pro arcu reincipit: after-epiphany et after-pentecost uterque ab 1 incipit, ideo arc distinguit. Numerus post Pentecosten 23–28 annuatim variat, ultimis dominicis post Epiphaniam ante Adventum resumptis (§4). OF tempus per annum unum numerum 1–34 habet qui Quadragesimam et Pascha transilit (…8, [Quadragesima/Pascha], 11…); arc nullum est.

Nota: season positio celebrata est, scalaris ex electione. Dies in duobus contextibus esse potest: dies octavae Nativitatis christmas et sodalis octavae est; dominica resumpta in loco ante Adventum est quamvis origine post Epiphaniam. Unum obiectum positionis celebratae, octava separata (§9); contextus originis dominicae resumptae amittitur (apertum, §4). Satis rarum.

Nota: color est { default, alternatives[] }, numquam scalaris. Gaudete et Laetare roseum addunt; Requiem nigrum vel violaceum est; aliquae vigiliae et votivae differunt. Valores: album, rubrum, viride, violaceum, roseum, nigrum, aureum.

6. Commemorationes et pars saints

Officium inferius impeditum ut fragmentum orationum in officio praecipuo servatur; numquam «secunda Missa» est.

• Compositio: Missa: secunda vel tertia Collecta, Secreta, Postcommunio. Laudes et Vesperae: antiphona, versiculus et collecta. Matutinum: interdum nona lectio.
• Duo gradus: privileged (dominicae, festa I classis, feriae Adventus et Quadragesimae, Quattuor Tempora, dies octavae Nativitatis, Litaniae maiores: Laudes, Vesperae et omnes Missae) et ordinary (Laudes, Vesperae et solae Missae lectae; in Missa sollemni omittitur).
• Ordo et limes: ordinatum (privilegiata primum, classis altior primum, ordo fixus intra classem), regula truncatum in limite orationum; ipsa truncatio notitia est.
• Dies qui nullas admittunt: Dominica Palmarum, Vigilia Pentecostes, dies summi: vacuum ex regula cum causa differt ab «nulla hodie incidit», absente.

"commemorations": [
  { "name": { "la": "S. Agnetis … secundo", "en": "St Agnes, 2nd feast" },
    "rank": { "label": "commemoration", "precedence": 110 },
    "kind": "ordinary", "prayers": { "collect": { … } }, "id": "agnes-secundo" }
]

Nota: limes calculatur; collectae imperatae separatae sunt. Limes pro die calculatur, tempore pendens, non semper 3. Collecta imperata, ab episcopo vel rubricis addita, commemoratio sancti non est; proprium campum imperated_collects[] in Missa habet.

Nota: Ultimum Evangelium in ambitu, Praefatio extra. Cum festum dominicam dimovet (1962), Evangelium dominicae commemoratae fit Ultimum Evangelium proprium, calendario electum et in ambitu (last_gospel). Praefatio diei gradu et tempore regitur sed ad Ordinarium pertinet: Limes, ad summum titulus, non textus.

saints: «cuius festum est?» Commemoratio pars inferior certaminis praecedentiae est, ideo sanctus praecipuus numquam in saints.commemorated est; et pars inferior non semper commemoratur:

Pars exitu signatur potius quam index planus notetur, ut quaestio communis «quis hodie celebratur?» uno aditu clavis respondeatur, et novi exitus formam sine frangendo extendant. remembered Martyrologii iuxta ut tertius gradus stat: exitus resolutionis omnino non est, sed commemoratio integra Ecclesiae illius diei.

"saints": {
  "celebrated":   [ { "name": {…}, "id": "lawrence", "person": "lawrence", "rank": {…} } ],
  "commemorated": [ { "name": {…}, "id": "agnes-secundo", "rank": {…} } ],
  "remembered":   [ { "name": "St Tychicus" } ]  // + "note" with ?include=martyrology
}

7. Missa

Propria, distincta ab Ordinario fixo, ordinata: Introitus · Collecta · Epistula · Graduale/Tractus/Alleluia · [Sequentia] · Evangelium · Offertorium · Secreta · Communio · Postcommunio. Aliquot lectiones Scripturae sunt (OF: prima et secunda cum psalmo; traditionale: epistula et evangelium); textus cantuum (Introitus, Graduale, Offertorium, Communio) antiphonae propriae sunt. Quisque locus munere signatur, ut una forma omnibus ritibus serviat:

{ "role": "gospel", "ref": "Luc 14:16-24",
  "text": { "la": "In illo témpore…", "en": "…" },
  "edition": { "la": "vulgate", "en": "douay" } }  // which edition produced each text (ids per /liturgy/v1/translations)
// ref = uncopyrightable citation, present when known, independent of text + translation

Nota: translatio dimensio pro textu est, linguae independens (§10). Solus text Scripturae eam habet; ref, nomina, rubricae et antiphonae cantus non habent. edition translationem vere adhibitam pro lingua refert, post petitionem translations et recursum praestitutum pro lingua, ut cliens qui unam petivit et aliam accepit, quia illi loco non praesto, cognoscere possit. Omnes editiones quas praebemus iuris publici sunt et interne tenentur.

Nota: readings[] longitudine varia et ordinatum est, non exemplar fixum Epistulae et Evangelii: sabbatum Quattuor Temporum usque ad sex lectiones habet, Vigilia Paschalis seriem prophetiarum (12 antiquius, 4 in 1962); plura elementa role: "lectio" positione distinguuntur.

Nota: cantus inter lectiones et Sequentia. Locus inter lectiones unum munus (interlection) habet secundum tempus varians: Graduale, Tractus paenitentialis vel duplex Alleluia tempore Paschali. Sequentia locus separatus est post Alleluia: role: "sequence", obligation: obligatory | optional (Pascha et Pentecostes obligatoria; Lauda Sion et Stabat Mater ad libitum; Dies Irae Requiem pertinens).

Una dies, plures Missae: masses index est, singularis index unius:

• pluralitas praescripta: tres Nativitatis, media nocte, aurora et die, et vigiliae magnae; omnes dicuntur.
• electio ad libitum: memoria ad libitum OF vel feria; una dicitur.
• Requiem praescriptum: cum dies Requiem est (Omnium Animarum = tres), in ambitu; votiva arbitraria vel Requiem occasionale extra sunt (Limites).

"masses": [
  { "id": "midnight", "name": {…}, "option_type": "prescribed", "colour": {…}, "readings": [ … ] },
  { "id": "dawn", "option_type": "prescribed", … }, { "id": "day", "option_type": "prescribed", … }
]
// option_type: prescribed (all said) | optional (a choice)

8. Officium (Officium divinum / Liturgia Horarum)

Octo horae: matins · lauds · prime · terce · sext · none · vespers · compline. Prima in OF suppressa est; calendarium horas suas declarat. Quaeque: psalmi et cantica ab antiphonis circumdati; hymnus; capitulum, versiculus et responsorium; collecta. Cantica evangelica propria pro hora: Benedictus (Laudes), Magnificat (Vesperae), Nunc Dimittis (Completorium). Matutinum maius est: unus vel tres nocturni psalmorum et lectionum, Te Deum diebus festivis.

{
  "hour": "vespers",
  "psalmody": [ { "antiphon": {…}, "psalm": { "ref": "Ps 109", "text": {…} } } ],
  "chapter": { "ref": "…", "text": {…} }, "hymn": {…}, "versicle": {…},
  "canticle": { "antiphon": {…}, "text": { "la": "Magnificat…", "en": "…" } },
  "collect": {…}, "commemorations": [ /* §6 — Lauds & Vespers only */ ]
}

Compositio per partes: Proprium → Communia applicabilia → Psalterium, singulis elementis independenter ad sequentem partem recurrentibus, ut collecta ex Proprio, psalmi ex Psalterio.

Nota: pars Communis composita est. titles series est (["martyr","bishop"] → utrumque Commune componitur), et quodque Commune plura formularia pro tempore tenet. Resolutio per Communia applicabilia et electio formularii tempori recti fit; non «unus titulus → unum Commune».

Primae et secundae Vesperae, concurrentia: festum primas Vesperas pridie et secundas Vesperas ipso die habet; ubi occurrunt, praecedentia (§4) decernit quae cantentur et utrum alterae commemorentur. «Vesperae die D» ambiguum est; duo obiecta distincta sunt.

Nota: Vesperae fontibus divisis Limes sunt. Concurrentia non semper pura substitutio est: psalmi ex uno officio, capitulum, hymnus et collecta a capitulo ex alio. Una Vespera ex duobus officiis, quam Proprium→Commune→Psalterium exprimere non potest. Vesperas resolutas et exitum praebemus, divisionem elementorum non praebemus.

9. Octavae, vigiliae, dies temporum privilegiatorum

Octavae: festum primi gradus per octo dies prolongatum; quisque dies infra octavam et dies octava proprius dies gradu definitus et impedibilis est. 1960 tres retinet: Nativitatem, Pascha, Pentecosten. octave: { of, day }: day positio est; vera classis in rank est. Dies octavae Nativitatis uniformes non sunt: 26–28 Decembris III classis, dies octava II classis.

Nota: genus octavae extra ambitum ab 1960 est. Ante 1955 octavae privilegiatae, communes et simplices classificatae sunt; 1960 eas ad tres redegit, ideo type hodie non est. Editio ante 1955 (§2) octave_type requireret.

Vigiliae: pridies liturgicus magni festi, dies separatus in die priore cum propria Missa et officio; intra aliam octavam cadere potest.

Nota: vigiliae typis definiuntur. vigil_type: ordinary (commemorata cum impedita) | privileged (Vigilia Nativitatis, dominicae praevalet) | paschal (Vigilia Paschalis, initium Tridui). Gradus proprietas diei est (rank).

Dies temporales temporum privilegiatorum: genera dierum cum propriis Missis, gradu definita et commemoratione privilegiata (rank.cycle: "temporale"), non feriae simplices: feriae Adventus a 17 Decembris (dies «O»); propria feriarum Quadragesimae; Quattuor Tempora; dies Rogationum (Litania maior 25 Aprilis et Litaniae minores), procession: true.

Nota: litania processionalis contentum non praebitum est. Litaniae Sanctorum in processione neque proprium Missae neque hora Officii sunt; quartum genus contenti sine loco in §7/§8. Dies, Missa et gradus in ambitu sunt; procession: true signat; textus litaniarum extra est.

10. Textus pluribus linguis

Quilibet textus hominibus legibilis tabula linguarum est { "la": …, "en": …, "fr": … }:

• Latina semper adest: iuris publici, numquam per filtrum remota.
• Linguae data sunt, non schema: fr vel es addere aliam clavem addit; petitio linguas restringere potest, Latina semper retenta.
• Citatio ≠ textus: ref factum est quod solum stare potest; text forma eius transferibilis est, fortasse absens.

Lingua et translatio, duae dimensiones. Lingua (Accept-Language) clavem tabulae eligit; translatio (parametrum quaestionis translations) pro solo text Scripturae eligit quae editio iuris publici illam clavem compleat. Coniunguntur: Accept-Language: en et translations=cpdv → textus Anglicus ex CPDV. Editiones etiam data sunt (pro lingua: en → douay | cpdv; la → vulgate), quaeque cum praestituto pro lingua; electio resoluta in omni lectione per edition (§7) refertur et in gradu responsi ut editions repetitur. Textus extra Scripturam, ut nomina, rubricae et antiphonae cantus, unam formam canonicam pro lingua habent et hanc dimensionem neglegunt. Omnes editiones interne tenentur, corpora iuris publici in servitio inclusa; nulla a tertia parte petitur.

11. Sancti

Duo gradus. Tabula uni ritui pertinens (§3) celebratio illius ritus est, cum proprio die, gradu et nomine. Supra eam persona canonica eundem sanctum per ritus ordinat ut omnia calendaria simul videas, etiam cum ritus dies diversos servant (Catharina Senensis: OF 29 Aprilis, 1962 30 Aprilis; Ephraem: OF 9 Iunii, 1962 18 Iunii). Persona index est; data cuiusque ritus propria manent. Unificatio normalizatione nominis utitur, honorificis et clausulis titulorum remotis et variantibus orthographicis coniunctis, parvo indice nominum alternorum comprobatorum et identificatoribus distinctis pro ritu cum nomen normalizatum iam occupatum est. Dies ut claves identitatis non adhibentur quia reformatio diem eiusdem sancti movere potest.

Persona, omnia calendaria simul (GET /liturgy/v1/saints/john-of-the-cross):

{
  "person": "john-of-the-cross", "name": { "la": "S. Ioannes a Cruce", "en": "St John of the Cross" },
  "calendars": {
    "traditional":     { "id": "ioannes-a-cruce", "date": "11-24", "rank": "class-3",
                        "titles": ["confessor","doctor"], "ref": "/liturgy/v1/calendars/traditional/saints/ioannes-a-cruce" },
    "ordinary": { "id": "john-of-the-cross", "date": "12-14", "rank": "memorial",
                        "titles": ["doctor"], "ref": "/liturgy/v1/calendars/ordinary/saints/john-of-the-cross" }
  }
}

Quaeque pars ritus et localem id et ref habet, nexum deorsum; tabula uni ritui pertinens person habet, nexum sursum (§3). Duo spatia nominum formarum brevium clientem numquam destituunt.

Quaestio varios Sanctos Ioannes distinguit: solum nomen colliditur, ideo quisque titulos et dies festos habet. Quaestio globalis ostendit quae calendaria quemque servent; quaestio pro ritu solum illud sanctorale enumerat. Inventa involucrum collectionis sunt (Puncta extrema), cum Accept-Language pro textu:

// GET /liturgy/v1/saints?q=john   (Accept-Language: en)
{ "results": [
    { "person": "john-the-baptist", "name": {…}, "titles": ["precursor"], "calendars": ["traditional","ordinary"],
      "feasts": [ { "date": "06-24", "kind": "nativity" }, { "date": "08-29", "kind": "beheading" } ] },
    { "person": "john-of-the-cross", "name": {…}, "titles": ["doctor"], "calendars": ["traditional","ordinary"] }
  ],
  "query": { "q": "john" }, "page": { "total": 2, "next": null } }

• Unum inventum pro persona, feasts[] quemque eventum enumerante. Sanctus plures habere potest: Nativitatem et Decollationem, diem octavae, festum secundo (§6). date est MM-DD fixum vel anchor mobile (§2).
• Concordantia per claves nominis linguarum est, sine discrimine diacriticorum, Latina semper praesente. q nomini respondet; title / month filtra separata sunt.
• Quaestio pro ritu (/calendars/{cal}/saints) formas breves locales et solum diem, gradum et titulos illius ritus reddit; sanctus a ritu absens ab inventis eius abest.

Limites (non praebita)

• Cantus et caeremoniae, et Ordinarium fixum Missae: proprium et calendarium quod illud eligit praebemus.
• Primae Vesperae (…/office/first-vespers): resolutioni concurrentiae pertinent, quae nondum calculatur; via 404 reddit ne contentum secundarum Vesperarum sub nomine falso praebeat. vespers/second-vespers, propriae diei, praebentur.
• Nomina sanctorum nunc solum Anglice sunt: sanctorale inclusum nomina Latina non habet, ideo partes name sancti { en } sunt. Haec unica exceptio Latinae semper praesentis est, quae omni textui liturgico valet; Latina completur cum data ritus ordinantur.
• Praefatio (Ordinarium), quamvis Ultimum Evangelium dominicae commemoratae, proprium, praebeatur (§6).
• Textus litaniarum processionalium, diebus Rogationum et Litaniae maioris (§9); dies in ambitu est.
• Vesperae concurrentes fontibus divisis (§8): Vesperae resolutae praebentur, divisio non praebetur.
• Missae votivae arbitrariae vel occasionales funebres vel nuptiales; dies Requiem praescripti inclusi sunt (§7).
• Calendaria localia vel propria extra tres ritus, tabulas translationis et praecepti pro conferentia et festa propria regionis, patronorum, quae praecedentiam afficiunt: data tempore addita (§2).
• Editiones historicae arbitrariae: solae tres editiones coniunctae; nullus selector anni rubricarum. Dimensio edition futura est (§2).
• Duo contextus temporum simultanei, ut origo dominicae resumptae (§5).
• Computus orientalis Iulianus: Pascha Gregorianum assumitur (§2).
• Tituli dierum temporalium linguis vernaculis: Latina fundamentum semper praesens est; nomen Anglicum additamentum quantum fieri potest a datis fontis limitatum est. Divinum Officium titulos temporales et festorum Domini Latine servat, ideo circa tertia pars dierum 1962/Dominicanorum nomen Anglicum non habet. Textus lectionum et Officii tamen transferuntur ubi versio gratuita est. Festa sanctoralia nomen Anglicum accipiunt ubi fons habet.
• Calculatio translationis et omissionis (§4/§6): machina occurrentiam resolvit, praecipuum et commemorationes, sed nondum translationem. saints.associated conexiones dierum fixorum Formae ordinariae independenter servat; resolution.displaced adhuc solum commemorated continet. Exitus omitted / transferred / not-observed et chain in forma sunt et complentur cum resolutio translationis advenit. Tabulae DO Tabulae/Transfer ad eam interne servantur. Absentiam emittimus sine translatione coniecta.

Quaestiones apertae

• Dies liturgicus vel dies civilis ut clavis (§3): forma relationum extensionis vespertinae.
• Praecedentia condicionalis (§4): regulam an solum exitum eius exponere?
• Dominicae resumptae (§4): relatio resumes: a translatione distincta.

Fontes

Gradus dierum liturgicorum · Commemoratio · Occurrentia · Proprium · Breviarium Romanum · Calendarium Romanum generale anni 1960 · Rubricae generales anni 1960 · romcal (opus prius exemplaris calendarii).

Origo datorum: omnia interne tenentur, nulla petitio tertiae partis tempore operationis. Calendarium, propria et Officium: corpus Divinum Officium iuris publici, interne inclusum. Martyrologium: editio Baltimorensis anni 1916 iuris publici, interne inclusa (data/martyrology/). Textus Scripturae: editiones iuris publici interne inclusae; la: Vulgata Clementina, cum Nova Vulgata ubi libera; en: Douay-Rheims (Challoner), Catholic Public Domain Version. Citationes facta sunt quae iure auctoris protegi non possunt. Nihil ex servitio externo tempore petitionis accipitur.