feat(calendar): core types + Gregorian Computus

1 files changed, 146 insertions, 0 deletions

diff --git a/internal/calendar/types.go b/internal/calendar/types.go
new file mode 100644
index 0000000..f481441
--- /dev/null
+++ b/internal/calendar/types.go
@@ -0,0 +1,146 @@
+// Package calendar computes the Ordinary Form liturgical day for any Gregorian
+// date, offline and from first principles. It imports only the standard library.
+package calendar
+
+import "time"
+
+type Rank int
+
+const (
+	RankFerial   Rank = iota // ordinary weekday
+	RankOptional             // optional memorial
+	RankMemorial             // obligatory memorial
+	RankFeast
+	RankSolemnity
+)
+
+type Class int
+
+const (
+	ClassNone  Class = iota // temporal / ferial
+	ClassSaint              // a saint
+	ClassBVM                // the Blessed Virgin Mary
+	ClassLord               // the Lord
+)
+
+type Colour string
+
+const (
+	White  Colour = "white"
+	Red    Colour = "red"
+	Green  Colour = "green"
+	Violet Colour = "violet"
+	Rose   Colour = "rose"
+	Black  Colour = "black"
+)
+
+type Season string
+
+const (
+	Advent    Season = "advent"
+	Christmas Season = "christmas"
+	Lent      Season = "lent"
+	Triduum   Season = "triduum"
+	Easter_   Season = "easter" // trailing underscore: Easter is the func name
+	Ordinary  Season = "ordinary"
+)
+
+type Reading struct{ Part, Citation string }
+
+type Mass struct {
+	Variant  string // "" = the day Mass; e.g. "vigil"
+	Readings []Reading
+}
+
+// DateSpec is a celebration's raw date expression, resolved by resolveDate:
+// "MM-DD" (fixed) | "easter±N" | "christmas±N" | "sunday-after MM-DD".
+type DateSpec string
+
+// RawCelebration is a celebration's fields exactly as parsed from a layer,
+// before typing/merging. Fields are raw INI values keyed by INI key
+// (e.g. "rank", "name.pl"); Variants holds "[slug/variant]" sub-sections.
+type RawCelebration struct {
+	Fields   map[string]string
+	Variants map[string]map[string]string
+}
+
+// Celebration is the typed, built form used in results.
+type Celebration struct {
+	Slug   string
+	Name   map[string]string // lang -> name
+	Rank   Rank
+	Class  Class
+	Colour Colour
+	Date   DateSpec
+	Masses []Mass
+	Layer  string // provenance
+}
+
+// Layer is one calendar layer (the embedded universal base, or later an
+// override file). Cels is keyed by slug; insertion order is not significant.
+type Layer struct {
+	ID, Name, Type string
+	Cels           map[string]RawCelebration
+}
+
+// Selection carries the config choices that steer computation.
+type Selection struct {
+	Form          string // "new" (OF). "old" reserved.
+	Epiphany      string // "fixed" | "sunday"
+	Ascension     string // "thursday" | "sunday"
+	CorpusChristi string // "thursday" | "sunday"
+}
+
+// DefaultSelection is the Universal Roman Calendar default.
+func DefaultSelection() Selection {
+	return Selection{Form: "new", Epiphany: "fixed", Ascension: "thursday", CorpusChristi: "thursday"}
+}
+
+type LiturgicalDay struct {
+	Date         time.Time
+	Season       Season
+	Week         int
+	Weekday      time.Weekday
+	Observed     Celebration
+	Others       []Celebration
+	Colour       Colour
+	SundayCycle  string // "A" | "B" | "C"
+	WeekdayCycle string // "I" | "II"
+}
+
+func ParseRank(s string) Rank {
+	switch s {
+	case "solemnity":
+		return RankSolemnity
+	case "feast":
+		return RankFeast
+	case "memorial":
+		return RankMemorial
+	case "optional":
+		return RankOptional
+	default:
+		return RankFerial
+	}
+}
+
+func ParseClass(s string) Class {
+	switch s {
+	case "lord":
+		return ClassLord
+	case "bvm":
+		return ClassBVM
+	case "saint":
+		return ClassSaint
+	default:
+		return ClassNone
+	}
+}
+
+func ParseColour(s string) Colour {
+	switch Colour(s) {
+	case White, Red, Green, Violet, Rose, Black:
+		return Colour(s)
+	default:
+		return ""
+	}
+}