Merge branch 'of-offline-migration': offline daily view, remove scrapers

1 files changed, 22 insertions, 17 deletions

diff --git a/internal/liturgy/section.go b/internal/liturgy/section.go
index cacefb0..dcca7b5 100644
--- a/internal/liturgy/section.go
+++ b/internal/liturgy/section.go
@@ -2,28 +2,33 @@
 // structured sections (1st reading, psalm, acclamation, gospel).
 package liturgy
 
-// Section is one reading section of the liturgy page (e.g. "1. czytanie",
-// "Psalm", "Aklamacja", "Ewangelia"): its heading, optional subtitle, the
-// citation extracted from the heading, a stable identifier for which liturgical
-// part it is, and its body split into paragraphs of text lines.
+// Section is one reading section of the liturgy (e.g. "1. czytanie", "Psalm",
+// "Aklamacja", "Ewangelia"): its heading, optional subtitle, the citation shown
+// to the reader, an English-canonical lookup reference, a stable identifier for
+// which liturgical part it is, and its body split into paragraphs of text lines.
+//
+// Citation is the display form (the reader's configured sigla dialect); Ref is
+// the English-canonical reference the render resolves against a corpus. Keeping
+// them apart lets the header read "Ps 27" in Polish sigla while the lookup uses
+// "Psalms 27" (renumbered per Psalter). Ref is empty for sources that only
+// carry a display citation; the render then falls back to Citation.
 type Section struct {
-	Heading, Subtitle, Citation, PartID string
-	Paragraphs                          [][]string
+	Heading, Subtitle, Citation, Ref, PartID string
+	Paragraphs                               [][]string
 }
 
-// DayInfo is the day's liturgical identity, source-language (Polish for the
-// modern niedziela.pl lectionary, English/Latin for the traditional
-// missalemeum) -- never translated, like Section's own Heading/Citation.
-// A source that carries no such data (or an unrecognised page/response
-// shape) yields a zero DayInfo; callers must treat that as "omit the
-// header", never as an error.
+// DayInfo is the day's liturgical identity from the offline calendar engine.
+// Name follows the UI language where the calendar data has a localized name
+// (else English); Colour is normalized. A day that carries no celebration name
+// yields a zero DayInfo; callers must treat that as "omit the header", never as
+// an error.
 type DayInfo struct {
-	// Name is the celebration, e.g. "Święto św. Marii Magdaleny" (modern) or
-	// "St. Mary Magdalene" (traditional).
+	// Name is the celebration, e.g. "św. Marii Magdaleny" (pl UI, where the
+	// calendar data has a Polish name) or "Saint Mary Magdalene" (en).
 	Name string
-	// Season is the temporal context, e.g. "Feria IV after VIII Sunday
-	// after Pentecost" (traditional); always "" for the modern lectionary,
-	// whose temporal is folded into Name on temporal days.
+	// Season is the temporal context; currently left empty by the offline
+	// loader, since the celebration name already carries the temporal identity
+	// on temporal days.
 	Season string
 	// Colour is the normalized liturgical colour: "white", "green",
 	// "violet", "red", "rose", or "" when unknown/unmapped.