calendaryjs-plugin-liturgical 0.1.0

package/dist/index.js

@@ -0,0 +1,3099 @@
+import { addDays, parseDate, formatDate, daysBetween, resolveConflict, getYear, mergeEventConfig } from 'calendaryjs';
+
+// package.json
+var package_default = {
+  name: "calendaryjs-plugin-liturgical",
+  version: "0.1.0"};
+
+// src/computus.ts
+function computeEaster(year) {
+  const a = year % 19;
+  const b = Math.floor(year / 100);
+  const c = year % 100;
+  const d = Math.floor(b / 4);
+  const e = b % 4;
+  const f = Math.floor((b + 8) / 25);
+  const g = Math.floor((b - f + 1) / 3);
+  const h = (19 * a + b - d - g + 15) % 30;
+  const i = Math.floor(c / 4);
+  const k = c % 4;
+  const l = (32 + 2 * e + 2 * i - h - k) % 7;
+  const m = Math.floor((a + 11 * h + 22 * l) / 451);
+  const month = Math.floor((h + l - 7 * m + 114) / 31);
+  const day = (h + l - 7 * m + 114) % 31 + 1;
+  return new Date(year, month - 1, day);
+}
+function computeOrthodoxEaster(year) {
+  const a = year % 4;
+  const b = year % 7;
+  const c = year % 19;
+  const d = (19 * c + 15) % 30;
+  const e = (2 * a + 4 * b - d + 34) % 7;
+  const month = Math.floor((d + e + 114) / 31);
+  const day = (d + e + 114) % 31 + 1;
+  const julianDate = new Date(year, month - 1, day);
+  const gregorianDate = new Date(julianDate.getTime() + 13 * 864e5);
+  return gregorianDate;
+}
+function getEasterDateString(year) {
+  const easter = computeEaster(year);
+  const month = String(easter.getMonth() + 1).padStart(2, "0");
+  const day = String(easter.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
+function easterRelativeDate(year, offsetDays) {
+  const easter = computeEaster(year);
+  return new Date(easter.getFullYear(), easter.getMonth(), easter.getDate() + offsetDays);
+}
+
+// src/formulas/advent.ts
+function getAdvent1(year) {
+  const christmas = new Date(year, 11, 25);
+  const christmasDay = christmas.getDay();
+  let daysBack;
+  if (christmasDay === 0) {
+    daysBack = 28;
+  } else {
+    daysBack = christmasDay + 21;
+  }
+  const advent1 = new Date(year, 11, 25 - daysBack);
+  return advent1;
+}
+function getAdvent2(year) {
+  const advent1 = getAdvent1(year);
+  return new Date(advent1.getFullYear(), advent1.getMonth(), advent1.getDate() + 7);
+}
+function getAdvent3(year) {
+  const advent1 = getAdvent1(year);
+  return new Date(advent1.getFullYear(), advent1.getMonth(), advent1.getDate() + 14);
+}
+function getAdvent4(year) {
+  const advent1 = getAdvent1(year);
+  return new Date(advent1.getFullYear(), advent1.getMonth(), advent1.getDate() + 21);
+}
+function getBaptismOfLord(year, epiphanyOnSunday = false) {
+  let epiphany;
+  if (epiphanyOnSunday) {
+    const jan2 = new Date(year, 0, 2);
+    const jan2Day = jan2.getDay();
+    const daysToSunday = jan2Day === 0 ? 0 : 7 - jan2Day;
+    epiphany = new Date(year, 0, 2 + daysToSunday);
+  } else {
+    epiphany = new Date(year, 0, 6);
+  }
+  const epiphanyDay = epiphany.getDay();
+  if (epiphanyOnSunday && epiphany.getDate() >= 7) {
+    return new Date(year, 0, epiphany.getDate() + 1);
+  }
+  const daysToNextSunday = epiphanyDay === 0 ? 7 : 7 - epiphanyDay;
+  return new Date(year, 0, epiphany.getDate() + daysToNextSunday);
+}
+function getChristTheKing(year) {
+  const advent1 = getAdvent1(year);
+  return new Date(advent1.getFullYear(), advent1.getMonth(), advent1.getDate() - 7);
+}
+function getHolyFamily(year) {
+  const christmas = new Date(year, 11, 25);
+  const christmasDay = christmas.getDay();
+  if (christmasDay === 0) {
+    return new Date(year, 11, 30);
+  }
+  const daysToSunday = 7 - christmasDay;
+  return new Date(year, 11, 25 + daysToSunday);
+}
+
+// src/daily/boundaries.ts
+function getLiturgicalYear(date) {
+  const year = date.getFullYear();
+  const advent1ThisYear = getAdvent1(year);
+  if (date < advent1ThisYear) {
+    return year;
+  }
+  return year + 1;
+}
+function getLiturgicalYearBoundaries(liturgicalYear, epiphanyOnSunday = false) {
+  const advent1 = getAdvent1(liturgicalYear - 1);
+  const christmas = new Date(liturgicalYear - 1, 11, 25);
+  const baptismOfLord = getBaptismOfLord(liturgicalYear, epiphanyOnSunday);
+  const easter = computeEaster(liturgicalYear);
+  const ashWednesday = addDays(easter, -46);
+  const pentecost = addDays(easter, 49);
+  const christTheKing = getChristTheKing(liturgicalYear);
+  return {
+    advent1,
+    christmas,
+    baptismOfLord,
+    ashWednesday,
+    easter,
+    pentecost,
+    christTheKing
+  };
+}
+
+// src/daily/calculator.ts
+function getLiturgicalDay(date, options = {}) {
+  const { epiphanyOnSunday = false } = options;
+  const d = typeof date === "string" ? parseDate(date) : date;
+  const dateStr = formatDate(d);
+  const dayOfWeek = d.getDay();
+  const isSunday = dayOfWeek === 0;
+  const isWeekday = !isSunday;
+  const litYear = getLiturgicalYear(d);
+  const boundaries = getLiturgicalYearBoundaries(litYear, epiphanyOnSunday);
+  const { season, week, rank, vestmentColor } = calculateSeasonAndWeek(
+    d,
+    boundaries,
+    litYear,
+    epiphanyOnSunday
+  );
+  return {
+    date: dateStr,
+    season,
+    week,
+    dayOfWeek,
+    rank,
+    vestmentColor,
+    isSunday,
+    isWeekday,
+    metadata: {
+      season,
+      rank,
+      vestmentColor
+    }
+  };
+}
+function calculateSeasonAndWeek(date, boundaries, litYear, epiphanyOnSunday) {
+  const { advent1, christmas, baptismOfLord, ashWednesday, easter, pentecost } = boundaries;
+  const nextAdvent1 = getLiturgicalYearBoundaries(litYear + 1, epiphanyOnSunday).advent1;
+  if (date >= advent1 && date < christmas) {
+    const daysFromAdvent1 = daysBetween(advent1, date);
+    const week = Math.floor(daysFromAdvent1 / 7) + 1;
+    const dayOfWeek = date.getDay();
+    return {
+      season: "advent",
+      week,
+      rank: dayOfWeek === 0 ? "solemnity" : "ordinary",
+      vestmentColor: week === 3 && dayOfWeek === 0 ? "rose" : "violet"
+    };
+  }
+  if (date >= christmas && date <= baptismOfLord) {
+    const daysFromChristmas = daysBetween(christmas, date);
+    const week = daysFromChristmas <= 7 ? 1 : 2;
+    return {
+      season: "christmas",
+      week,
+      rank: daysFromChristmas === 0 ? "solemnity" : "ordinary",
+      vestmentColor: "white"
+    };
+  }
+  if (date > baptismOfLord && date < ashWednesday) {
+    const daysFromBaptism = daysBetween(baptismOfLord, date);
+    const week = Math.floor(daysFromBaptism / 7) + 1;
+    const dayOfWeek = date.getDay();
+    return {
+      season: "ordinary-time-1",
+      week,
+      rank: dayOfWeek === 0 ? "solemnity" : "ordinary",
+      vestmentColor: "green"
+    };
+  }
+  const holySaturday = addDays(easter, -1);
+  if (date >= ashWednesday && date <= holySaturday) {
+    const firstSundayOfLent = addDays(ashWednesday, 7 - ashWednesday.getDay());
+    let week;
+    if (date < firstSundayOfLent) {
+      week = 0;
+    } else {
+      const daysFromFirstSunday = daysBetween(firstSundayOfLent, date);
+      week = Math.floor(daysFromFirstSunday / 7) + 1;
+    }
+    const dayOfWeek = date.getDay();
+    const palmSunday = addDays(easter, -7);
+    if (date >= palmSunday) {
+      week = 6;
+    }
+    return {
+      season: "lent",
+      week,
+      rank: dayOfWeek === 0 ? "solemnity" : "ordinary",
+      vestmentColor: week === 4 && dayOfWeek === 0 ? "rose" : "violet"
+    };
+  }
+  if (date >= easter && date <= pentecost) {
+    const daysFromEaster = daysBetween(easter, date);
+    const week = Math.floor(daysFromEaster / 7) + 1;
+    const dayOfWeek = date.getDay();
+    return {
+      season: "easter",
+      week,
+      rank: dayOfWeek === 0 ? "solemnity" : "ordinary",
+      vestmentColor: daysFromEaster === 49 ? "red" : "white"
+      // Pentecost is red
+    };
+  }
+  if (date > pentecost && date < nextAdvent1) {
+    const daysFromPentecost = daysBetween(pentecost, date);
+    const ot1Weeks = Math.floor(daysBetween(baptismOfLord, ashWednesday) / 7);
+    const ot2WeekOffset = ot1Weeks + 1;
+    const week = Math.floor(daysFromPentecost / 7) + ot2WeekOffset;
+    const dayOfWeek = date.getDay();
+    return {
+      season: "ordinary-time-2",
+      week,
+      rank: dayOfWeek === 0 ? "solemnity" : "ordinary",
+      vestmentColor: "green"
+    };
+  }
+  return {
+    season: "ordinary-time-2",
+    week: 1,
+    rank: "ordinary",
+    vestmentColor: "green"
+  };
+}
+function getLiturgicalDaysInRange(startDate, endDate, options = {}) {
+  const start = typeof startDate === "string" ? parseDate(startDate) : startDate;
+  const end = typeof endDate === "string" ? parseDate(endDate) : endDate;
+  const days = [];
+  const current = new Date(start);
+  while (current <= end) {
+    days.push(getLiturgicalDay(current, options));
+    current.setDate(current.getDate() + 1);
+  }
+  return days;
+}
+function getLiturgicalDaysForMonth(year, month, options = {}) {
+  const startDate = new Date(year, month - 1, 1);
+  const endDate = new Date(year, month, 0);
+  return getLiturgicalDaysInRange(startDate, endDate, options);
+}
+function getLiturgicalDaysForYear(year, options = {}) {
+  const startDate = new Date(year, 0, 1);
+  const endDate = new Date(year, 11, 31);
+  return getLiturgicalDaysInRange(startDate, endDate, options);
+}
+
+// src/generators/easter.ts
+var easterEventHandler = {
+  validate(event) {
+    if (typeof event !== "object" || event === null) return false;
+    const e = event;
+    return e.type === "easter" && typeof e.id === "string";
+  },
+  generate(_event, year) {
+    return [computeEaster(year)];
+  }
+};
+
+// src/generators/offset.ts
+var offsetEventHandler = {
+  validate(event) {
+    if (typeof event !== "object" || event === null) return false;
+    const e = event;
+    return e.type === "offset" && typeof e.baseEvent === "string" && typeof e.offsetDays === "number" && typeof e.id === "string";
+  },
+  generate(event, year) {
+    const offsetEvent = event;
+    let baseDate;
+    switch (offsetEvent.baseEvent) {
+      case "easter":
+        baseDate = computeEaster(year);
+        break;
+      default:
+        throw new Error(
+          `Unknown base event "${offsetEvent.baseEvent}". Supported base events: "easter".`
+        );
+    }
+    const resultDate = new Date(baseDate);
+    resultDate.setDate(resultDate.getDate() + offsetEvent.offsetDays);
+    return [resultDate];
+  }
+};
+
+// src/plugin.ts
+function liturgical(options = {}) {
+  const { epiphanyOnSunday = false, enrichDays = true } = options;
+  const liturgicalDayEnricher = {
+    name: "liturgical",
+    priority: 20,
+    enrich(day) {
+      const litDay = getLiturgicalDay(day.date, {
+        epiphanyOnSunday
+      });
+      return {
+        ...day,
+        liturgical: {
+          season: litDay.season,
+          week: litDay.week,
+          rank: litDay.rank,
+          vestmentColor: litDay.vestmentColor
+        }
+      };
+    }
+  };
+  return {
+    name: package_default.name,
+    version: package_default.version,
+    install(calendary) {
+      if (enrichDays) {
+        calendary.registerDayEnricher(liturgicalDayEnricher);
+      }
+    },
+    eventTypes: {
+      easter: easterEventHandler,
+      offset: offsetEventHandler
+    },
+    formulas: {
+      "advent-1": (year) => getAdvent1(year),
+      "advent-2": (year) => getAdvent2(year),
+      "advent-3": (year) => getAdvent3(year),
+      "advent-4": (year) => getAdvent4(year),
+      "baptism-of-lord": (year) => getBaptismOfLord(year, epiphanyOnSunday),
+      "christ-the-king": (year) => getChristTheKing(year)
+    }
+  };
+}
+
+// src/keys.ts
+var EASTER_CYCLE_KEYS = [
+  "EASTER_SUNDAY",
+  "ASH_WEDNESDAY",
+  "PALM_SUNDAY",
+  "HOLY_THURSDAY",
+  "GOOD_FRIDAY",
+  "HOLY_SATURDAY",
+  "DIVINE_MERCY_SUNDAY",
+  "ASCENSION",
+  "PENTECOST",
+  "TRINITY_SUNDAY",
+  "CORPUS_CHRISTI",
+  "SACRED_HEART",
+  "IMMACULATE_HEART"
+];
+var FIXED_SOLEMNITY_KEYS = [
+  "MARY_MOTHER_OF_GOD",
+  "EPIPHANY",
+  "PRESENTATION",
+  "SAINT_JOSEPH",
+  "ANNUNCIATION",
+  "NATIVITY_OF_JOHN_BAPTIST",
+  "PETER_AND_PAUL",
+  "TRANSFIGURATION",
+  "ASSUMPTION",
+  "EXALTATION_OF_CROSS",
+  "ALL_SAINTS",
+  "ALL_SOULS",
+  "IMMACULATE_CONCEPTION",
+  "CHRISTMAS",
+  "HOLY_INNOCENTS",
+  "HOLY_FAMILY"
+];
+var COMPUTED_KEYS = [
+  "ADVENT_1",
+  "ADVENT_2",
+  "ADVENT_3",
+  "ADVENT_4",
+  "BAPTISM_OF_LORD",
+  "CHRIST_THE_KING"
+];
+var MEMORIAL_SAINT_KEYS = [
+  // January
+  "BASIL_GREGORY",
+  "ANTHONY_ABBOT",
+  "AGNES",
+  "FRANCIS_DE_SALES",
+  "TIMOTHY_TITUS",
+  "THOMAS_AQUINAS",
+  "JOHN_BOSCO",
+  // February
+  "AGATHA",
+  "PAUL_MIKI",
+  "SCHOLASTICA",
+  "OUR_LADY_OF_LOURDES",
+  "CYRIL_METHODIUS",
+  "POLYCARP",
+  // March
+  "PERPETUA_FELICITY",
+  "PATRICK",
+  "CYRIL_OF_JERUSALEM",
+  // April
+  "MARTIN_I",
+  "ANSELM",
+  "GEORGE",
+  "ADALBERT",
+  "FIDELIS",
+  "LOUIS_GRIGNION",
+  "PETER_CHANEL",
+  "CATHERINE_OF_SIENA",
+  "PIUS_V",
+  // May
+  "JOSEPH_WORKER",
+  "ATHANASIUS",
+  "NEREUS_ACHILLEUS",
+  "PANCRAS",
+  "OUR_LADY_OF_FATIMA",
+  "JOHN_I",
+  "BERNARDINE",
+  "PHILIP_NERI",
+  "AUGUSTINE_OF_CANTERBURY",
+  // June
+  "JUSTIN",
+  "MARCELLINUS_PETER",
+  "CHARLES_LWANGA",
+  "BONIFACE",
+  "NORBERT",
+  "EPHREM",
+  "BARNABAS",
+  "ROMUALD",
+  "JOHN_FISHER_THOMAS_MORE",
+  "FIRST_MARTYRS_OF_ROME",
+  // July
+  "THOMAS_APOSTLE",
+  "ELIZABETH_OF_PORTUGAL",
+  "MARIA_GORETTI",
+  "AUGUSTINE_ZHAO",
+  "BENEDICT",
+  "HENRY",
+  "CAMILLUS",
+  "BONAVENTURE",
+  "OUR_LADY_OF_MOUNT_CARMEL",
+  "APOLLINARIS",
+  "LAWRENCE_OF_BRINDISI",
+  "MARY_MAGDALENE",
+  "BRIDGET",
+  "SHARBEL",
+  "JAMES_APOSTLE",
+  "MARTHA",
+  "PETER_CHRYSOLOGUS",
+  "IGNATIUS_OF_LOYOLA",
+  // August
+  "ALPHONSUS",
+  "JOHN_VIANNEY",
+  "DEDICATION_MARY_MAJOR",
+  "SIXTUS_II",
+  "CAJETAN",
+  "DOMINIC",
+  "LAWRENCE",
+  "CLARE",
+  "JANE_FRANCES",
+  "PONTIAN_HIPPOLYTUS",
+  "MAXIMILIAN_KOLBE",
+  "JOHN_EUDES",
+  "BERNARD",
+  "PIUS_X",
+  "QUEENSHIP_OF_MARY",
+  "BARTHOLOMEW",
+  "LOUIS_IX",
+  "JOSEPH_CALASANZ",
+  "MONICA",
+  "AUGUSTINE",
+  "PASSION_OF_JOHN_BAPTIST",
+  // September
+  "GREGORY_THE_GREAT",
+  "BIRTH_OF_MARY",
+  "PETER_CLAVER",
+  "MOST_HOLY_NAME_OF_MARY",
+  "OUR_LADY_OF_SORROWS",
+  "CORNELIUS_CYPRIAN",
+  "ROBERT_BELLARMINE",
+  "JANUARIUS",
+  "MATTHEW",
+  "PADRE_PIO",
+  "COSMAS_DAMIAN",
+  "WENCESLAUS",
+  "LAWRENCE_RUIZ",
+  "ARCHANGELS",
+  "JEROME",
+  // October
+  "THERESE_OF_LISIEUX",
+  "GUARDIAN_ANGELS",
+  "FRANCIS_OF_ASSISI",
+  "FAUSTINA",
+  "BRUNO",
+  "OUR_LADY_OF_ROSARY",
+  "DENIS",
+  "CALLISTUS_I",
+  "TERESA_OF_AVILA",
+  "HEDWIG",
+  "MARGARET_MARY",
+  "IGNATIUS_OF_ANTIOCH",
+  "LUKE",
+  "ISAAC_JOGUES",
+  "PAUL_OF_CROSS",
+  "JOHN_PAUL_II",
+  "JOHN_OF_CAPISTRANO",
+  "ANTHONY_MARY_CLARET",
+  "SIMON_JUDE",
+  // November
+  "DEDICATION_LATERAN",
+  "LEO_THE_GREAT",
+  "MARTIN_OF_TOURS",
+  "JOSAPHAT",
+  "MARGARET_OF_SCOTLAND",
+  "GERTRUDE",
+  "ELIZABETH_OF_HUNGARY",
+  "DEDICATION_PETER_PAUL",
+  "PRESENTATION_OF_MARY",
+  "CLEMENT_I",
+  "COLUMBAN",
+  "CATHERINE_OF_ALEXANDRIA",
+  "ANDREW_APOSTLE",
+  // December
+  "FRANCIS_XAVIER",
+  "LUCY",
+  "STEPHEN_FIRST_MARTYR",
+  "JOHN_APOSTLE"
+];
+var ALL_MASS_KEYS = [
+  ...EASTER_CYCLE_KEYS,
+  ...FIXED_SOLEMNITY_KEYS,
+  ...COMPUTED_KEYS,
+  ...MEMORIAL_SAINT_KEYS
+];
+var MassKeys = {
+  // Easter Cycle
+  EASTER_SUNDAY: "EASTER_SUNDAY",
+  ASH_WEDNESDAY: "ASH_WEDNESDAY",
+  PALM_SUNDAY: "PALM_SUNDAY",
+  HOLY_THURSDAY: "HOLY_THURSDAY",
+  GOOD_FRIDAY: "GOOD_FRIDAY",
+  HOLY_SATURDAY: "HOLY_SATURDAY",
+  DIVINE_MERCY_SUNDAY: "DIVINE_MERCY_SUNDAY",
+  ASCENSION: "ASCENSION",
+  PENTECOST: "PENTECOST",
+  TRINITY_SUNDAY: "TRINITY_SUNDAY",
+  CORPUS_CHRISTI: "CORPUS_CHRISTI",
+  SACRED_HEART: "SACRED_HEART",
+  IMMACULATE_HEART: "IMMACULATE_HEART",
+  // Fixed Solemnities
+  MARY_MOTHER_OF_GOD: "MARY_MOTHER_OF_GOD",
+  EPIPHANY: "EPIPHANY",
+  PRESENTATION: "PRESENTATION",
+  SAINT_JOSEPH: "SAINT_JOSEPH",
+  ANNUNCIATION: "ANNUNCIATION",
+  NATIVITY_OF_JOHN_BAPTIST: "NATIVITY_OF_JOHN_BAPTIST",
+  PETER_AND_PAUL: "PETER_AND_PAUL",
+  TRANSFIGURATION: "TRANSFIGURATION",
+  ASSUMPTION: "ASSUMPTION",
+  EXALTATION_OF_CROSS: "EXALTATION_OF_CROSS",
+  ALL_SAINTS: "ALL_SAINTS",
+  ALL_SOULS: "ALL_SOULS",
+  IMMACULATE_CONCEPTION: "IMMACULATE_CONCEPTION",
+  CHRISTMAS: "CHRISTMAS",
+  HOLY_INNOCENTS: "HOLY_INNOCENTS",
+  HOLY_FAMILY: "HOLY_FAMILY",
+  // Computed
+  ADVENT_1: "ADVENT_1",
+  ADVENT_2: "ADVENT_2",
+  ADVENT_3: "ADVENT_3",
+  ADVENT_4: "ADVENT_4",
+  BAPTISM_OF_LORD: "BAPTISM_OF_LORD",
+  CHRIST_THE_KING: "CHRIST_THE_KING",
+  // Memorial Saints - January
+  BASIL_GREGORY: "BASIL_GREGORY",
+  ANTHONY_ABBOT: "ANTHONY_ABBOT",
+  AGNES: "AGNES",
+  FRANCIS_DE_SALES: "FRANCIS_DE_SALES",
+  TIMOTHY_TITUS: "TIMOTHY_TITUS",
+  THOMAS_AQUINAS: "THOMAS_AQUINAS",
+  JOHN_BOSCO: "JOHN_BOSCO",
+  // February
+  AGATHA: "AGATHA",
+  PAUL_MIKI: "PAUL_MIKI",
+  SCHOLASTICA: "SCHOLASTICA",
+  OUR_LADY_OF_LOURDES: "OUR_LADY_OF_LOURDES",
+  CYRIL_METHODIUS: "CYRIL_METHODIUS",
+  POLYCARP: "POLYCARP",
+  // March
+  PERPETUA_FELICITY: "PERPETUA_FELICITY",
+  PATRICK: "PATRICK",
+  CYRIL_OF_JERUSALEM: "CYRIL_OF_JERUSALEM",
+  // April
+  MARTIN_I: "MARTIN_I",
+  ANSELM: "ANSELM",
+  GEORGE: "GEORGE",
+  ADALBERT: "ADALBERT",
+  FIDELIS: "FIDELIS",
+  LOUIS_GRIGNION: "LOUIS_GRIGNION",
+  PETER_CHANEL: "PETER_CHANEL",
+  CATHERINE_OF_SIENA: "CATHERINE_OF_SIENA",
+  PIUS_V: "PIUS_V",
+  // May
+  JOSEPH_WORKER: "JOSEPH_WORKER",
+  ATHANASIUS: "ATHANASIUS",
+  NEREUS_ACHILLEUS: "NEREUS_ACHILLEUS",
+  PANCRAS: "PANCRAS",
+  OUR_LADY_OF_FATIMA: "OUR_LADY_OF_FATIMA",
+  JOHN_I: "JOHN_I",
+  BERNARDINE: "BERNARDINE",
+  PHILIP_NERI: "PHILIP_NERI",
+  AUGUSTINE_OF_CANTERBURY: "AUGUSTINE_OF_CANTERBURY",
+  // June
+  JUSTIN: "JUSTIN",
+  MARCELLINUS_PETER: "MARCELLINUS_PETER",
+  CHARLES_LWANGA: "CHARLES_LWANGA",
+  BONIFACE: "BONIFACE",
+  NORBERT: "NORBERT",
+  EPHREM: "EPHREM",
+  BARNABAS: "BARNABAS",
+  ROMUALD: "ROMUALD",
+  JOHN_FISHER_THOMAS_MORE: "JOHN_FISHER_THOMAS_MORE",
+  FIRST_MARTYRS_OF_ROME: "FIRST_MARTYRS_OF_ROME",
+  // July
+  THOMAS_APOSTLE: "THOMAS_APOSTLE",
+  ELIZABETH_OF_PORTUGAL: "ELIZABETH_OF_PORTUGAL",
+  MARIA_GORETTI: "MARIA_GORETTI",
+  AUGUSTINE_ZHAO: "AUGUSTINE_ZHAO",
+  BENEDICT: "BENEDICT",
+  HENRY: "HENRY",
+  CAMILLUS: "CAMILLUS",
+  BONAVENTURE: "BONAVENTURE",
+  OUR_LADY_OF_MOUNT_CARMEL: "OUR_LADY_OF_MOUNT_CARMEL",
+  APOLLINARIS: "APOLLINARIS",
+  LAWRENCE_OF_BRINDISI: "LAWRENCE_OF_BRINDISI",
+  MARY_MAGDALENE: "MARY_MAGDALENE",
+  BRIDGET: "BRIDGET",
+  SHARBEL: "SHARBEL",
+  JAMES_APOSTLE: "JAMES_APOSTLE",
+  MARTHA: "MARTHA",
+  PETER_CHRYSOLOGUS: "PETER_CHRYSOLOGUS",
+  IGNATIUS_OF_LOYOLA: "IGNATIUS_OF_LOYOLA",
+  // August
+  ALPHONSUS: "ALPHONSUS",
+  JOHN_VIANNEY: "JOHN_VIANNEY",
+  DEDICATION_MARY_MAJOR: "DEDICATION_MARY_MAJOR",
+  SIXTUS_II: "SIXTUS_II",
+  CAJETAN: "CAJETAN",
+  DOMINIC: "DOMINIC",
+  LAWRENCE: "LAWRENCE",
+  CLARE: "CLARE",
+  JANE_FRANCES: "JANE_FRANCES",
+  PONTIAN_HIPPOLYTUS: "PONTIAN_HIPPOLYTUS",
+  MAXIMILIAN_KOLBE: "MAXIMILIAN_KOLBE",
+  JOHN_EUDES: "JOHN_EUDES",
+  BERNARD: "BERNARD",
+  PIUS_X: "PIUS_X",
+  QUEENSHIP_OF_MARY: "QUEENSHIP_OF_MARY",
+  BARTHOLOMEW: "BARTHOLOMEW",
+  LOUIS_IX: "LOUIS_IX",
+  JOSEPH_CALASANZ: "JOSEPH_CALASANZ",
+  MONICA: "MONICA",
+  AUGUSTINE: "AUGUSTINE",
+  PASSION_OF_JOHN_BAPTIST: "PASSION_OF_JOHN_BAPTIST",
+  // September
+  GREGORY_THE_GREAT: "GREGORY_THE_GREAT",
+  BIRTH_OF_MARY: "BIRTH_OF_MARY",
+  PETER_CLAVER: "PETER_CLAVER",
+  MOST_HOLY_NAME_OF_MARY: "MOST_HOLY_NAME_OF_MARY",
+  OUR_LADY_OF_SORROWS: "OUR_LADY_OF_SORROWS",
+  CORNELIUS_CYPRIAN: "CORNELIUS_CYPRIAN",
+  ROBERT_BELLARMINE: "ROBERT_BELLARMINE",
+  JANUARIUS: "JANUARIUS",
+  MATTHEW: "MATTHEW",
+  PADRE_PIO: "PADRE_PIO",
+  COSMAS_DAMIAN: "COSMAS_DAMIAN",
+  WENCESLAUS: "WENCESLAUS",
+  LAWRENCE_RUIZ: "LAWRENCE_RUIZ",
+  ARCHANGELS: "ARCHANGELS",
+  JEROME: "JEROME",
+  // October
+  THERESE_OF_LISIEUX: "THERESE_OF_LISIEUX",
+  GUARDIAN_ANGELS: "GUARDIAN_ANGELS",
+  FRANCIS_OF_ASSISI: "FRANCIS_OF_ASSISI",
+  FAUSTINA: "FAUSTINA",
+  BRUNO: "BRUNO",
+  OUR_LADY_OF_ROSARY: "OUR_LADY_OF_ROSARY",
+  DENIS: "DENIS",
+  CALLISTUS_I: "CALLISTUS_I",
+  TERESA_OF_AVILA: "TERESA_OF_AVILA",
+  HEDWIG: "HEDWIG",
+  MARGARET_MARY: "MARGARET_MARY",
+  IGNATIUS_OF_ANTIOCH: "IGNATIUS_OF_ANTIOCH",
+  LUKE: "LUKE",
+  ISAAC_JOGUES: "ISAAC_JOGUES",
+  PAUL_OF_CROSS: "PAUL_OF_CROSS",
+  JOHN_PAUL_II: "JOHN_PAUL_II",
+  JOHN_OF_CAPISTRANO: "JOHN_OF_CAPISTRANO",
+  ANTHONY_MARY_CLARET: "ANTHONY_MARY_CLARET",
+  SIMON_JUDE: "SIMON_JUDE",
+  // November
+  DEDICATION_LATERAN: "DEDICATION_LATERAN",
+  LEO_THE_GREAT: "LEO_THE_GREAT",
+  MARTIN_OF_TOURS: "MARTIN_OF_TOURS",
+  JOSAPHAT: "JOSAPHAT",
+  MARGARET_OF_SCOTLAND: "MARGARET_OF_SCOTLAND",
+  GERTRUDE: "GERTRUDE",
+  ELIZABETH_OF_HUNGARY: "ELIZABETH_OF_HUNGARY",
+  DEDICATION_PETER_PAUL: "DEDICATION_PETER_PAUL",
+  PRESENTATION_OF_MARY: "PRESENTATION_OF_MARY",
+  CLEMENT_I: "CLEMENT_I",
+  COLUMBAN: "COLUMBAN",
+  CATHERINE_OF_ALEXANDRIA: "CATHERINE_OF_ALEXANDRIA",
+  ANDREW_APOSTLE: "ANDREW_APOSTLE",
+  // December
+  FRANCIS_XAVIER: "FRANCIS_XAVIER",
+  LUCY: "LUCY",
+  STEPHEN_FIRST_MARTYR: "STEPHEN_FIRST_MARTYR",
+  JOHN_APOSTLE: "JOHN_APOSTLE"
+};
+
+// src/definitions.ts
+function meta(season, rank, vestmentColor) {
+  return { season, rank, vestmentColor };
+}
+var EASTER_CYCLE_EVENTS = [
+  {
+    key: "EASTER_SUNDAY",
+    type: "easter",
+    category: "easter-cycle",
+    metadata: meta("easter", "solemnity", "white")
+  },
+  {
+    key: "ASH_WEDNESDAY",
+    type: "offset",
+    category: "easter-cycle",
+    offsetDays: -46,
+    metadata: meta("lent", "solemnity", "violet")
+  },
+  {
+    key: "PALM_SUNDAY",
+    type: "offset",
+    category: "easter-cycle",
+    offsetDays: -7,
+    metadata: meta("lent", "solemnity", "red")
+  },
+  {
+    key: "HOLY_THURSDAY",
+    type: "offset",
+    category: "easter-cycle",
+    offsetDays: -3,
+    metadata: meta("lent", "solemnity", "white")
+  },
+  {
+    key: "GOOD_FRIDAY",
+    type: "offset",
+    category: "easter-cycle",
+    offsetDays: -2,
+    metadata: meta("lent", "solemnity", "red")
+  },
+  {
+    key: "HOLY_SATURDAY",
+    type: "offset",
+    category: "easter-cycle",
+    offsetDays: -1,
+    metadata: meta("lent", "solemnity", "white")
+  },
+  {
+    key: "DIVINE_MERCY_SUNDAY",
+    type: "offset",
+    category: "easter-cycle",
+    offsetDays: 7,
+    metadata: meta("easter", "solemnity", "white")
+  },
+  {
+    key: "ASCENSION",
+    type: "offset",
+    category: "easter-cycle",
+    offsetDays: 39,
+    // Thursday, can be moved to Sunday (+42)
+    metadata: meta("easter", "solemnity", "white")
+  },
+  {
+    key: "PENTECOST",
+    type: "offset",
+    category: "easter-cycle",
+    offsetDays: 49,
+    metadata: meta("easter", "solemnity", "red")
+  },
+  {
+    key: "TRINITY_SUNDAY",
+    type: "offset",
+    category: "easter-cycle",
+    offsetDays: 56,
+    metadata: meta("ordinary-time-2", "solemnity", "white")
+  },
+  {
+    key: "CORPUS_CHRISTI",
+    type: "offset",
+    category: "easter-cycle",
+    offsetDays: 60,
+    // Thursday, usually moved to Sunday (+63)
+    metadata: meta("ordinary-time-2", "solemnity", "white")
+  },
+  {
+    key: "SACRED_HEART",
+    type: "offset",
+    category: "easter-cycle",
+    offsetDays: 68,
+    // Friday after Corpus Christi
+    metadata: meta("ordinary-time-2", "solemnity", "white")
+  },
+  {
+    key: "IMMACULATE_HEART",
+    type: "offset",
+    category: "easter-cycle",
+    offsetDays: 69,
+    // Saturday after Sacred Heart
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  }
+];
+var FIXED_SOLEMNITY_EVENTS = [
+  {
+    key: "MARY_MOTHER_OF_GOD",
+    type: "const",
+    category: "solemnities",
+    month: 1,
+    day: 1,
+    metadata: meta("christmas", "solemnity", "white")
+  },
+  {
+    key: "EPIPHANY",
+    type: "const",
+    category: "solemnities",
+    month: 1,
+    day: 6,
+    metadata: meta("christmas", "solemnity", "white")
+  },
+  {
+    key: "PRESENTATION",
+    type: "const",
+    category: "feasts",
+    month: 2,
+    day: 2,
+    metadata: meta("ordinary-time-1", "feast", "white")
+  },
+  {
+    key: "SAINT_JOSEPH",
+    type: "const",
+    category: "solemnities",
+    month: 3,
+    day: 19,
+    metadata: meta("lent", "solemnity", "white")
+  },
+  {
+    key: "ANNUNCIATION",
+    type: "const",
+    category: "solemnities",
+    month: 3,
+    day: 25,
+    metadata: meta("lent", "solemnity", "white")
+  },
+  {
+    key: "NATIVITY_OF_JOHN_BAPTIST",
+    type: "const",
+    category: "solemnities",
+    month: 6,
+    day: 24,
+    metadata: meta("ordinary-time-2", "solemnity", "white")
+  },
+  {
+    key: "PETER_AND_PAUL",
+    type: "const",
+    category: "solemnities",
+    month: 6,
+    day: 29,
+    metadata: meta("ordinary-time-2", "solemnity", "red")
+  },
+  {
+    key: "TRANSFIGURATION",
+    type: "const",
+    category: "feasts",
+    month: 8,
+    day: 6,
+    metadata: meta("ordinary-time-2", "feast", "white")
+  },
+  {
+    key: "ASSUMPTION",
+    type: "const",
+    category: "solemnities",
+    month: 8,
+    day: 15,
+    metadata: meta("ordinary-time-2", "solemnity", "white")
+  },
+  {
+    key: "EXALTATION_OF_CROSS",
+    type: "const",
+    category: "feasts",
+    month: 9,
+    day: 14,
+    metadata: meta("ordinary-time-2", "feast", "red")
+  },
+  {
+    key: "ALL_SAINTS",
+    type: "const",
+    category: "solemnities",
+    month: 11,
+    day: 1,
+    metadata: meta("ordinary-time-2", "solemnity", "white")
+  },
+  {
+    key: "ALL_SOULS",
+    type: "const",
+    category: "solemnities",
+    month: 11,
+    day: 2,
+    metadata: meta("ordinary-time-2", "solemnity", "violet")
+  },
+  {
+    key: "IMMACULATE_CONCEPTION",
+    type: "const",
+    category: "solemnities",
+    month: 12,
+    day: 8,
+    metadata: meta("advent", "solemnity", "white")
+  },
+  {
+    key: "CHRISTMAS",
+    type: "const",
+    category: "solemnities",
+    month: 12,
+    day: 25,
+    metadata: meta("christmas", "solemnity", "white")
+  },
+  {
+    key: "HOLY_INNOCENTS",
+    type: "const",
+    category: "feasts",
+    month: 12,
+    day: 28,
+    metadata: meta("christmas", "feast", "red")
+  },
+  {
+    key: "HOLY_FAMILY",
+    type: "nth-weekday",
+    category: "solemnities",
+    // First Sunday after Dec 25; if Dec 25 itself is Sunday use Dec 30
+    dayOfWeek: 0,
+    after: { month: 12, day: 26 },
+    before: { month: 12, day: 31 },
+    fallback: { month: 12, day: 30 },
+    metadata: meta("christmas", "feast", "white")
+  }
+];
+var COMPUTED_EVENTS = [
+  {
+    key: "ADVENT_1",
+    type: "formula",
+    category: "computed",
+    formula: "advent-1",
+    metadata: meta("advent", "solemnity", "violet")
+  },
+  {
+    key: "ADVENT_2",
+    type: "formula",
+    category: "computed",
+    formula: "advent-2",
+    metadata: meta("advent", "solemnity", "violet")
+  },
+  {
+    key: "ADVENT_3",
+    type: "formula",
+    category: "computed",
+    formula: "advent-3",
+    metadata: meta("advent", "solemnity", "rose")
+  },
+  {
+    key: "ADVENT_4",
+    type: "formula",
+    category: "computed",
+    formula: "advent-4",
+    metadata: meta("advent", "solemnity", "violet")
+  },
+  {
+    key: "BAPTISM_OF_LORD",
+    type: "formula",
+    category: "computed",
+    formula: "baptism-of-lord",
+    metadata: meta("christmas", "feast", "white")
+  },
+  {
+    key: "CHRIST_THE_KING",
+    type: "formula",
+    category: "computed",
+    formula: "christ-the-king",
+    metadata: meta("ordinary-time-2", "solemnity", "white")
+  }
+];
+var MEMORIAL_SAINT_EVENTS = [
+  // ===== JANUARY =====
+  {
+    key: "BASIL_GREGORY",
+    type: "const",
+    category: "memorials",
+    month: 1,
+    day: 2,
+    metadata: meta("christmas", "memorial", "white")
+  },
+  {
+    key: "ANTHONY_ABBOT",
+    type: "const",
+    category: "memorials",
+    month: 1,
+    day: 17,
+    metadata: meta("ordinary-time-1", "memorial", "white")
+  },
+  {
+    key: "AGNES",
+    type: "const",
+    category: "memorials",
+    month: 1,
+    day: 21,
+    metadata: meta("ordinary-time-1", "memorial", "red")
+  },
+  {
+    key: "FRANCIS_DE_SALES",
+    type: "const",
+    category: "memorials",
+    month: 1,
+    day: 24,
+    metadata: meta("ordinary-time-1", "memorial", "white")
+  },
+  {
+    key: "TIMOTHY_TITUS",
+    type: "const",
+    category: "memorials",
+    month: 1,
+    day: 26,
+    metadata: meta("ordinary-time-1", "memorial", "white")
+  },
+  {
+    key: "THOMAS_AQUINAS",
+    type: "const",
+    category: "memorials",
+    month: 1,
+    day: 28,
+    metadata: meta("ordinary-time-1", "memorial", "white")
+  },
+  {
+    key: "JOHN_BOSCO",
+    type: "const",
+    category: "memorials",
+    month: 1,
+    day: 31,
+    metadata: meta("ordinary-time-1", "memorial", "white")
+  },
+  // ===== FEBRUARY =====
+  {
+    key: "AGATHA",
+    type: "const",
+    category: "memorials",
+    month: 2,
+    day: 5,
+    metadata: meta("ordinary-time-1", "memorial", "red")
+  },
+  {
+    key: "PAUL_MIKI",
+    type: "const",
+    category: "memorials",
+    month: 2,
+    day: 6,
+    metadata: meta("ordinary-time-1", "memorial", "red")
+  },
+  {
+    key: "SCHOLASTICA",
+    type: "const",
+    category: "memorials",
+    month: 2,
+    day: 10,
+    metadata: meta("ordinary-time-1", "memorial", "white")
+  },
+  {
+    key: "OUR_LADY_OF_LOURDES",
+    type: "const",
+    category: "memorials",
+    month: 2,
+    day: 11,
+    metadata: meta("ordinary-time-1", "memorial", "white")
+  },
+  {
+    key: "CYRIL_METHODIUS",
+    type: "const",
+    category: "memorials",
+    month: 2,
+    day: 14,
+    metadata: meta("ordinary-time-1", "memorial", "white")
+  },
+  {
+    key: "POLYCARP",
+    type: "const",
+    category: "memorials",
+    month: 2,
+    day: 23,
+    metadata: meta("ordinary-time-1", "memorial", "red")
+  },
+  // ===== MARCH =====
+  {
+    key: "PERPETUA_FELICITY",
+    type: "const",
+    category: "memorials",
+    month: 3,
+    day: 7,
+    metadata: meta("lent", "memorial", "red")
+  },
+  {
+    key: "PATRICK",
+    type: "const",
+    category: "memorials",
+    month: 3,
+    day: 17,
+    metadata: meta("lent", "memorial", "white")
+  },
+  {
+    key: "CYRIL_OF_JERUSALEM",
+    type: "const",
+    category: "memorials",
+    month: 3,
+    day: 18,
+    metadata: meta("lent", "memorial", "white")
+  },
+  // ===== APRIL =====
+  {
+    key: "MARTIN_I",
+    type: "const",
+    category: "memorials",
+    month: 4,
+    day: 13,
+    metadata: meta("lent", "memorial", "red")
+  },
+  {
+    key: "ANSELM",
+    type: "const",
+    category: "memorials",
+    month: 4,
+    day: 21,
+    metadata: meta("easter", "memorial", "white")
+  },
+  {
+    key: "GEORGE",
+    type: "const",
+    category: "memorials",
+    month: 4,
+    day: 23,
+    metadata: meta("easter", "memorial", "red")
+  },
+  {
+    key: "ADALBERT",
+    type: "const",
+    category: "memorials",
+    month: 4,
+    day: 23,
+    metadata: meta("easter", "memorial", "red")
+  },
+  {
+    key: "FIDELIS",
+    type: "const",
+    category: "memorials",
+    month: 4,
+    day: 24,
+    metadata: meta("easter", "memorial", "red")
+  },
+  {
+    key: "LOUIS_GRIGNION",
+    type: "const",
+    category: "memorials",
+    month: 4,
+    day: 28,
+    metadata: meta("easter", "memorial", "white")
+  },
+  {
+    key: "PETER_CHANEL",
+    type: "const",
+    category: "memorials",
+    month: 4,
+    day: 28,
+    metadata: meta("easter", "memorial", "red")
+  },
+  {
+    key: "CATHERINE_OF_SIENA",
+    type: "const",
+    category: "memorials",
+    month: 4,
+    day: 29,
+    metadata: meta("easter", "memorial", "white")
+  },
+  {
+    key: "PIUS_V",
+    type: "const",
+    category: "memorials",
+    month: 4,
+    day: 30,
+    metadata: meta("easter", "memorial", "white")
+  },
+  // ===== MAY =====
+  {
+    key: "JOSEPH_WORKER",
+    type: "const",
+    category: "memorials",
+    month: 5,
+    day: 1,
+    metadata: meta("easter", "memorial", "white")
+  },
+  {
+    key: "ATHANASIUS",
+    type: "const",
+    category: "memorials",
+    month: 5,
+    day: 2,
+    metadata: meta("easter", "memorial", "white")
+  },
+  {
+    key: "NEREUS_ACHILLEUS",
+    type: "const",
+    category: "memorials",
+    month: 5,
+    day: 12,
+    metadata: meta("easter", "memorial", "red")
+  },
+  {
+    key: "PANCRAS",
+    type: "const",
+    category: "memorials",
+    month: 5,
+    day: 12,
+    metadata: meta("easter", "memorial", "red")
+  },
+  {
+    key: "OUR_LADY_OF_FATIMA",
+    type: "const",
+    category: "memorials",
+    month: 5,
+    day: 13,
+    metadata: meta("easter", "memorial", "white")
+  },
+  {
+    key: "JOHN_I",
+    type: "const",
+    category: "memorials",
+    month: 5,
+    day: 18,
+    metadata: meta("easter", "memorial", "red")
+  },
+  {
+    key: "BERNARDINE",
+    type: "const",
+    category: "memorials",
+    month: 5,
+    day: 20,
+    metadata: meta("easter", "memorial", "white")
+  },
+  {
+    key: "PHILIP_NERI",
+    type: "const",
+    category: "memorials",
+    month: 5,
+    day: 26,
+    metadata: meta("easter", "memorial", "white")
+  },
+  {
+    key: "AUGUSTINE_OF_CANTERBURY",
+    type: "const",
+    category: "memorials",
+    month: 5,
+    day: 27,
+    metadata: meta("easter", "memorial", "white")
+  },
+  // ===== JUNE =====
+  {
+    key: "JUSTIN",
+    type: "const",
+    category: "memorials",
+    month: 6,
+    day: 1,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "MARCELLINUS_PETER",
+    type: "const",
+    category: "memorials",
+    month: 6,
+    day: 2,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "CHARLES_LWANGA",
+    type: "const",
+    category: "memorials",
+    month: 6,
+    day: 3,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "BONIFACE",
+    type: "const",
+    category: "memorials",
+    month: 6,
+    day: 5,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "NORBERT",
+    type: "const",
+    category: "memorials",
+    month: 6,
+    day: 6,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "EPHREM",
+    type: "const",
+    category: "memorials",
+    month: 6,
+    day: 9,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "BARNABAS",
+    type: "const",
+    category: "memorials",
+    month: 6,
+    day: 11,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "ROMUALD",
+    type: "const",
+    category: "memorials",
+    month: 6,
+    day: 19,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "JOHN_FISHER_THOMAS_MORE",
+    type: "const",
+    category: "memorials",
+    month: 6,
+    day: 22,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "FIRST_MARTYRS_OF_ROME",
+    type: "const",
+    category: "memorials",
+    month: 6,
+    day: 30,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  // ===== JULY =====
+  {
+    key: "THOMAS_APOSTLE",
+    type: "const",
+    category: "feasts",
+    month: 7,
+    day: 3,
+    metadata: meta("ordinary-time-2", "feast", "red")
+  },
+  {
+    key: "ELIZABETH_OF_PORTUGAL",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 4,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "MARIA_GORETTI",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 6,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "AUGUSTINE_ZHAO",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 9,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "BENEDICT",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 11,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "HENRY",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 13,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "CAMILLUS",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 14,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "BONAVENTURE",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 15,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "OUR_LADY_OF_MOUNT_CARMEL",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 16,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "APOLLINARIS",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 20,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "LAWRENCE_OF_BRINDISI",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 21,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "MARY_MAGDALENE",
+    type: "const",
+    category: "feasts",
+    month: 7,
+    day: 22,
+    metadata: meta("ordinary-time-2", "feast", "white")
+  },
+  {
+    key: "BRIDGET",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 23,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "SHARBEL",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 24,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "JAMES_APOSTLE",
+    type: "const",
+    category: "feasts",
+    month: 7,
+    day: 25,
+    metadata: meta("ordinary-time-2", "feast", "red")
+  },
+  {
+    key: "MARTHA",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 29,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "PETER_CHRYSOLOGUS",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 30,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "IGNATIUS_OF_LOYOLA",
+    type: "const",
+    category: "memorials",
+    month: 7,
+    day: 31,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  // ===== AUGUST =====
+  {
+    key: "ALPHONSUS",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 1,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "JOHN_VIANNEY",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 4,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "DEDICATION_MARY_MAJOR",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 5,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "SIXTUS_II",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 7,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "CAJETAN",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 7,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "DOMINIC",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 8,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "LAWRENCE",
+    type: "const",
+    category: "feasts",
+    month: 8,
+    day: 10,
+    metadata: meta("ordinary-time-2", "feast", "red")
+  },
+  {
+    key: "CLARE",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 11,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "JANE_FRANCES",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 12,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "PONTIAN_HIPPOLYTUS",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 13,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "MAXIMILIAN_KOLBE",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 14,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "JOHN_EUDES",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 19,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "BERNARD",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 20,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "PIUS_X",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 21,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "QUEENSHIP_OF_MARY",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 22,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "BARTHOLOMEW",
+    type: "const",
+    category: "feasts",
+    month: 8,
+    day: 24,
+    metadata: meta("ordinary-time-2", "feast", "red")
+  },
+  {
+    key: "LOUIS_IX",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 25,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "JOSEPH_CALASANZ",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 25,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "MONICA",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 27,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "AUGUSTINE",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 28,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "PASSION_OF_JOHN_BAPTIST",
+    type: "const",
+    category: "memorials",
+    month: 8,
+    day: 29,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  // ===== SEPTEMBER =====
+  {
+    key: "GREGORY_THE_GREAT",
+    type: "const",
+    category: "memorials",
+    month: 9,
+    day: 3,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "BIRTH_OF_MARY",
+    type: "const",
+    category: "feasts",
+    month: 9,
+    day: 8,
+    metadata: meta("ordinary-time-2", "feast", "white")
+  },
+  {
+    key: "PETER_CLAVER",
+    type: "const",
+    category: "memorials",
+    month: 9,
+    day: 9,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "MOST_HOLY_NAME_OF_MARY",
+    type: "const",
+    category: "memorials",
+    month: 9,
+    day: 12,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "OUR_LADY_OF_SORROWS",
+    type: "const",
+    category: "memorials",
+    month: 9,
+    day: 15,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "CORNELIUS_CYPRIAN",
+    type: "const",
+    category: "memorials",
+    month: 9,
+    day: 16,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "ROBERT_BELLARMINE",
+    type: "const",
+    category: "memorials",
+    month: 9,
+    day: 17,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "JANUARIUS",
+    type: "const",
+    category: "memorials",
+    month: 9,
+    day: 19,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "MATTHEW",
+    type: "const",
+    category: "feasts",
+    month: 9,
+    day: 21,
+    metadata: meta("ordinary-time-2", "feast", "red")
+  },
+  {
+    key: "PADRE_PIO",
+    type: "const",
+    category: "memorials",
+    month: 9,
+    day: 23,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "COSMAS_DAMIAN",
+    type: "const",
+    category: "memorials",
+    month: 9,
+    day: 26,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "WENCESLAUS",
+    type: "const",
+    category: "memorials",
+    month: 9,
+    day: 28,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "LAWRENCE_RUIZ",
+    type: "const",
+    category: "memorials",
+    month: 9,
+    day: 28,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "ARCHANGELS",
+    type: "const",
+    category: "feasts",
+    month: 9,
+    day: 29,
+    metadata: meta("ordinary-time-2", "feast", "white")
+  },
+  {
+    key: "JEROME",
+    type: "const",
+    category: "memorials",
+    month: 9,
+    day: 30,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  // ===== OCTOBER =====
+  {
+    key: "THERESE_OF_LISIEUX",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 1,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "GUARDIAN_ANGELS",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 2,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "FRANCIS_OF_ASSISI",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 4,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "FAUSTINA",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 5,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "BRUNO",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 6,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "OUR_LADY_OF_ROSARY",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 7,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "DENIS",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 9,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "CALLISTUS_I",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 14,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "TERESA_OF_AVILA",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 15,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "HEDWIG",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 16,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "MARGARET_MARY",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 16,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "IGNATIUS_OF_ANTIOCH",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 17,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "LUKE",
+    type: "const",
+    category: "feasts",
+    month: 10,
+    day: 18,
+    metadata: meta("ordinary-time-2", "feast", "red")
+  },
+  {
+    key: "ISAAC_JOGUES",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 19,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "PAUL_OF_CROSS",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 19,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "JOHN_PAUL_II",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 22,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "JOHN_OF_CAPISTRANO",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 23,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "ANTHONY_MARY_CLARET",
+    type: "const",
+    category: "memorials",
+    month: 10,
+    day: 24,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "SIMON_JUDE",
+    type: "const",
+    category: "feasts",
+    month: 10,
+    day: 28,
+    metadata: meta("ordinary-time-2", "feast", "red")
+  },
+  // ===== NOVEMBER =====
+  {
+    key: "DEDICATION_LATERAN",
+    type: "const",
+    category: "feasts",
+    month: 11,
+    day: 9,
+    metadata: meta("ordinary-time-2", "feast", "white")
+  },
+  {
+    key: "LEO_THE_GREAT",
+    type: "const",
+    category: "memorials",
+    month: 11,
+    day: 10,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "MARTIN_OF_TOURS",
+    type: "const",
+    category: "memorials",
+    month: 11,
+    day: 11,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "JOSAPHAT",
+    type: "const",
+    category: "memorials",
+    month: 11,
+    day: 12,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "MARGARET_OF_SCOTLAND",
+    type: "const",
+    category: "memorials",
+    month: 11,
+    day: 16,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "GERTRUDE",
+    type: "const",
+    category: "memorials",
+    month: 11,
+    day: 16,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "ELIZABETH_OF_HUNGARY",
+    type: "const",
+    category: "memorials",
+    month: 11,
+    day: 17,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "DEDICATION_PETER_PAUL",
+    type: "const",
+    category: "memorials",
+    month: 11,
+    day: 18,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "PRESENTATION_OF_MARY",
+    type: "const",
+    category: "memorials",
+    month: 11,
+    day: 21,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "CLEMENT_I",
+    type: "const",
+    category: "memorials",
+    month: 11,
+    day: 23,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "COLUMBAN",
+    type: "const",
+    category: "memorials",
+    month: 11,
+    day: 23,
+    metadata: meta("ordinary-time-2", "memorial", "white")
+  },
+  {
+    key: "CATHERINE_OF_ALEXANDRIA",
+    type: "const",
+    category: "memorials",
+    month: 11,
+    day: 25,
+    metadata: meta("ordinary-time-2", "memorial", "red")
+  },
+  {
+    key: "ANDREW_APOSTLE",
+    type: "const",
+    category: "feasts",
+    month: 11,
+    day: 30,
+    metadata: meta("advent", "feast", "red")
+  },
+  // ===== DECEMBER =====
+  {
+    key: "FRANCIS_XAVIER",
+    type: "const",
+    category: "memorials",
+    month: 12,
+    day: 3,
+    metadata: meta("advent", "memorial", "white")
+  },
+  {
+    key: "LUCY",
+    type: "const",
+    category: "memorials",
+    month: 12,
+    day: 13,
+    metadata: meta("advent", "memorial", "red")
+  },
+  {
+    key: "STEPHEN_FIRST_MARTYR",
+    type: "const",
+    category: "feasts",
+    month: 12,
+    day: 26,
+    metadata: meta("christmas", "feast", "red")
+  },
+  {
+    key: "JOHN_APOSTLE",
+    type: "const",
+    category: "feasts",
+    month: 12,
+    day: 27,
+    metadata: meta("christmas", "feast", "white")
+  }
+];
+var ALL_LITURGICAL_EVENTS = [
+  ...EASTER_CYCLE_EVENTS,
+  ...FIXED_SOLEMNITY_EVENTS,
+  ...COMPUTED_EVENTS,
+  ...MEMORIAL_SAINT_EVENTS
+];
+function getEventsByCategory(categories) {
+  return ALL_LITURGICAL_EVENTS.filter((e) => categories.includes(e.category));
+}
+
+// src/presets.ts
+var EASTER = {
+  type: "easter",
+  id: "easter-sunday",
+  title: "Easter Sunday",
+  categories: ["easter-cycle", "solemnities"],
+  priority: 1,
+  metadata: {
+    season: "easter",
+    rank: "solemnity",
+    vestmentColor: "white"
+  }
+};
+var ASH_WEDNESDAY = {
+  type: "offset",
+  id: "ash-wednesday",
+  title: "Ash Wednesday",
+  baseEvent: "easter",
+  offsetDays: -46,
+  categories: ["easter-cycle", "solemnities"],
+  metadata: {
+    season: "lent",
+    rank: "solemnity",
+    vestmentColor: "violet"
+  }
+};
+var PALM_SUNDAY = {
+  type: "offset",
+  id: "palm-sunday",
+  title: "Palm Sunday",
+  baseEvent: "easter",
+  offsetDays: -7,
+  categories: ["easter-cycle", "solemnities"],
+  metadata: {
+    season: "lent",
+    rank: "solemnity",
+    vestmentColor: "red"
+  }
+};
+var HOLY_THURSDAY = {
+  type: "offset",
+  id: "holy-thursday",
+  title: "Holy Thursday",
+  baseEvent: "easter",
+  offsetDays: -3,
+  categories: ["easter-cycle", "solemnities"],
+  metadata: {
+    season: "lent",
+    rank: "solemnity",
+    vestmentColor: "white"
+  }
+};
+var GOOD_FRIDAY = {
+  type: "offset",
+  id: "good-friday",
+  title: "Good Friday",
+  baseEvent: "easter",
+  offsetDays: -2,
+  categories: ["easter-cycle", "solemnities"],
+  metadata: {
+    season: "lent",
+    rank: "solemnity",
+    vestmentColor: "red"
+  }
+};
+var HOLY_SATURDAY = {
+  type: "offset",
+  id: "holy-saturday",
+  title: "Holy Saturday",
+  baseEvent: "easter",
+  offsetDays: -1,
+  categories: ["easter-cycle", "solemnities"],
+  metadata: {
+    season: "lent",
+    rank: "solemnity",
+    vestmentColor: "white"
+  }
+};
+var ASCENSION = {
+  type: "offset",
+  id: "ascension",
+  title: "Ascension",
+  baseEvent: "easter",
+  offsetDays: 39,
+  categories: ["easter-cycle", "solemnities"],
+  metadata: {
+    season: "easter",
+    rank: "solemnity",
+    vestmentColor: "white"
+  }
+};
+var PENTECOST = {
+  type: "offset",
+  id: "pentecost",
+  title: "Pentecost",
+  baseEvent: "easter",
+  offsetDays: 49,
+  categories: ["easter-cycle", "solemnities"],
+  metadata: {
+    season: "easter",
+    rank: "solemnity",
+    vestmentColor: "red"
+  }
+};
+var TRINITY_SUNDAY = {
+  type: "offset",
+  id: "trinity-sunday",
+  title: "Trinity Sunday",
+  baseEvent: "easter",
+  offsetDays: 56,
+  categories: ["easter-cycle", "solemnities"],
+  metadata: {
+    season: "ordinary-time-2",
+    rank: "solemnity",
+    vestmentColor: "white"
+  }
+};
+var CORPUS_CHRISTI = {
+  type: "offset",
+  id: "corpus-christi",
+  title: "Corpus Christi",
+  baseEvent: "easter",
+  offsetDays: 60,
+  categories: ["easter-cycle", "solemnities"],
+  metadata: {
+    season: "ordinary-time-2",
+    rank: "solemnity",
+    vestmentColor: "white"
+  }
+};
+var LITURGICAL_EVENTS = [
+  EASTER,
+  ASH_WEDNESDAY,
+  PALM_SUNDAY,
+  HOLY_THURSDAY,
+  GOOD_FRIDAY,
+  HOLY_SATURDAY,
+  ASCENSION,
+  PENTECOST,
+  TRINITY_SUNDAY,
+  CORPUS_CHRISTI
+];
+var SEASON_VESTMENT_COLORS = {
+  advent: "violet",
+  christmas: "white",
+  "ordinary-time-1": "green",
+  lent: "violet",
+  easter: "white",
+  "ordinary-time-2": "green"
+};
+function getSeason(date, options = {}) {
+  const { epiphanyOnSunday = false } = options;
+  const d = typeof date === "string" ? parseDate(date) : date;
+  const liturgicalYear = getLiturgicalYear(d);
+  const day = getLiturgicalDay(d, { epiphanyOnSunday });
+  return {
+    season: day.season,
+    vestmentColor: SEASON_VESTMENT_COLORS[day.season],
+    week: day.week,
+    liturgicalYear
+  };
+}
+function getCurrentSeason(options = {}) {
+  return getSeason(/* @__PURE__ */ new Date(), options);
+}
+function getLiturgicalYearChart(liturgicalYear, options = {}) {
+  const { epiphanyOnSunday = false } = options;
+  const boundaries = getLiturgicalYearBoundaries(liturgicalYear, epiphanyOnSunday);
+  const nextBoundaries = getLiturgicalYearBoundaries(liturgicalYear + 1, epiphanyOnSunday);
+  const startDate = boundaries.advent1;
+  const endDate = new Date(nextBoundaries.advent1);
+  endDate.setDate(endDate.getDate() - 1);
+  const totalDays = Math.round((endDate.getTime() - startDate.getTime()) / (1e3 * 60 * 60 * 24)) + 1;
+  const holySaturday = new Date(boundaries.easter);
+  holySaturday.setDate(holySaturday.getDate() - 1);
+  const beforeAshWednesday = new Date(boundaries.ashWednesday);
+  beforeAshWednesday.setDate(beforeAshWednesday.getDate() - 1);
+  const beforeNextAdvent = new Date(nextBoundaries.advent1);
+  beforeNextAdvent.setDate(beforeNextAdvent.getDate() - 1);
+  const seasonBoundaries = [
+    {
+      season: "advent",
+      start: boundaries.advent1,
+      end: new Date(boundaries.christmas.getTime() - 24 * 60 * 60 * 1e3)
+      // Dec 24
+    },
+    {
+      season: "christmas",
+      start: boundaries.christmas,
+      end: boundaries.baptismOfLord
+    },
+    {
+      season: "ordinary-time-1",
+      start: new Date(boundaries.baptismOfLord.getTime() + 24 * 60 * 60 * 1e3),
+      // Day after Baptism
+      end: beforeAshWednesday
+    },
+    {
+      season: "lent",
+      start: boundaries.ashWednesday,
+      end: holySaturday
+    },
+    {
+      season: "easter",
+      start: boundaries.easter,
+      end: boundaries.pentecost
+    },
+    {
+      season: "ordinary-time-2",
+      start: new Date(boundaries.pentecost.getTime() + 24 * 60 * 60 * 1e3),
+      // Day after Pentecost
+      end: beforeNextAdvent
+    }
+  ];
+  let cumulativeDays = 0;
+  const segments = seasonBoundaries.map(({ season, start, end }) => {
+    const days = Math.round((end.getTime() - start.getTime()) / (1e3 * 60 * 60 * 24)) + 1;
+    const percentage = days / totalDays * 100;
+    const startAngle = cumulativeDays / totalDays * 360;
+    const endAngle = (cumulativeDays + days) / totalDays * 360;
+    cumulativeDays += days;
+    return {
+      season,
+      vestmentColor: SEASON_VESTMENT_COLORS[season],
+      startDate: formatDate(start),
+      endDate: formatDate(end),
+      days,
+      startAngle,
+      endAngle,
+      percentage
+    };
+  });
+  return {
+    liturgicalYear,
+    calendarYearStart: liturgicalYear - 1,
+    calendarYearEnd: liturgicalYear,
+    startDate: formatDate(startDate),
+    endDate: formatDate(endDate),
+    totalDays,
+    segments
+  };
+}
+function getCalendarYearSeasons(calendarYear, options = {}) {
+  const { epiphanyOnSunday = false } = options;
+  const startDate = new Date(calendarYear, 0, 1);
+  const endDate = new Date(calendarYear, 11, 31);
+  const totalDays = 365 + (isLeapYear(calendarYear) ? 1 : 0);
+  const segments = [];
+  const currentDate = new Date(startDate);
+  let currentSeason = null;
+  let segmentStart = null;
+  let cumulativeDays = 0;
+  while (currentDate <= endDate) {
+    const day = getLiturgicalDay(currentDate, { epiphanyOnSunday });
+    if (day.season !== currentSeason) {
+      if (currentSeason !== null && segmentStart !== null) {
+        const prevEnd = new Date(currentDate);
+        prevEnd.setDate(prevEnd.getDate() - 1);
+        const days = Math.round((prevEnd.getTime() - segmentStart.getTime()) / (1e3 * 60 * 60 * 24)) + 1;
+        const percentage = days / totalDays * 100;
+        const startAngle = cumulativeDays / totalDays * 360;
+        cumulativeDays += days;
+        const endAngle = cumulativeDays / totalDays * 360;
+        segments.push({
+          season: currentSeason,
+          vestmentColor: SEASON_VESTMENT_COLORS[currentSeason],
+          startDate: formatDate(segmentStart),
+          endDate: formatDate(prevEnd),
+          days,
+          startAngle,
+          endAngle,
+          percentage
+        });
+      }
+      currentSeason = day.season;
+      segmentStart = new Date(currentDate);
+    }
+    currentDate.setDate(currentDate.getDate() + 1);
+  }
+  if (currentSeason !== null && segmentStart !== null) {
+    const days = Math.round((endDate.getTime() - segmentStart.getTime()) / (1e3 * 60 * 60 * 24)) + 1;
+    const percentage = days / totalDays * 100;
+    const startAngle = cumulativeDays / totalDays * 360;
+    const endAngle = 360;
+    segments.push({
+      season: currentSeason,
+      vestmentColor: SEASON_VESTMENT_COLORS[currentSeason],
+      startDate: formatDate(segmentStart),
+      endDate: formatDate(endDate),
+      days,
+      startAngle,
+      endAngle,
+      percentage
+    });
+  }
+  return segments;
+}
+function isLeapYear(year) {
+  return year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
+}
+
+// src/utils/texts.ts
+var DEFAULT_LITURGICAL_TEXTS = {
+  // Easter Cycle
+  EASTER_SUNDAY: {
+    title: "Easter Sunday",
+    keywords: ["easter", "resurrection", "paschal"]
+  },
+  ASH_WEDNESDAY: {
+    title: "Ash Wednesday",
+    keywords: ["ash", "lent", "fasting"]
+  },
+  PALM_SUNDAY: {
+    title: "Palm Sunday",
+    keywords: ["palm", "passion", "holy week"]
+  },
+  HOLY_THURSDAY: {
+    title: "Holy Thursday",
+    keywords: ["maundy", "last supper", "holy week"]
+  },
+  GOOD_FRIDAY: {
+    title: "Good Friday",
+    keywords: ["crucifixion", "passion", "holy week"]
+  },
+  HOLY_SATURDAY: {
+    title: "Holy Saturday",
+    keywords: ["vigil", "holy week"]
+  },
+  DIVINE_MERCY_SUNDAY: {
+    title: "Divine Mercy Sunday",
+    keywords: ["divine mercy", "octave of easter"]
+  },
+  ASCENSION: {
+    title: "Ascension",
+    keywords: ["ascension", "heaven"]
+  },
+  PENTECOST: {
+    title: "Pentecost",
+    keywords: ["pentecost", "holy spirit", "tongues of fire"]
+  },
+  TRINITY_SUNDAY: {
+    title: "Trinity Sunday",
+    keywords: ["trinity", "father son spirit"]
+  },
+  CORPUS_CHRISTI: {
+    title: "Corpus Christi",
+    keywords: ["corpus christi", "body of christ", "eucharist"]
+  },
+  SACRED_HEART: {
+    title: "Sacred Heart of Jesus",
+    keywords: ["sacred heart", "heart of jesus"]
+  },
+  IMMACULATE_HEART: {
+    title: "Immaculate Heart of Mary",
+    keywords: ["immaculate heart", "heart of mary"]
+  },
+  // Fixed Solemnities
+  MARY_MOTHER_OF_GOD: {
+    title: "Mary, Mother of God",
+    keywords: ["mary", "mother of god", "theotokos"]
+  },
+  EPIPHANY: {
+    title: "Epiphany",
+    keywords: ["epiphany", "magi", "three kings"]
+  },
+  PRESENTATION: {
+    title: "Presentation of the Lord",
+    keywords: ["presentation", "candlemas", "simeon"]
+  },
+  SAINT_JOSEPH: {
+    title: "Saint Joseph",
+    keywords: ["joseph", "foster father"]
+  },
+  ANNUNCIATION: {
+    title: "Annunciation",
+    keywords: ["annunciation", "gabriel", "mary"]
+  },
+  NATIVITY_OF_JOHN_BAPTIST: {
+    title: "Nativity of John the Baptist",
+    keywords: ["john baptist", "birth"]
+  },
+  PETER_AND_PAUL: {
+    title: "Saints Peter and Paul",
+    keywords: ["peter", "paul", "apostles"]
+  },
+  TRANSFIGURATION: {
+    title: "Transfiguration",
+    keywords: ["transfiguration", "mount tabor"]
+  },
+  ASSUMPTION: {
+    title: "Assumption of Mary",
+    keywords: ["assumption", "mary", "heaven"]
+  },
+  EXALTATION_OF_CROSS: {
+    title: "Exaltation of the Holy Cross",
+    keywords: ["cross", "exaltation", "holy cross"]
+  },
+  ALL_SAINTS: {
+    title: "All Saints",
+    keywords: ["all saints", "saints"]
+  },
+  ALL_SOULS: {
+    title: "All Souls",
+    keywords: ["all souls", "faithful departed", "dead"]
+  },
+  IMMACULATE_CONCEPTION: {
+    title: "Immaculate Conception",
+    keywords: ["immaculate conception", "mary"]
+  },
+  CHRISTMAS: {
+    title: "Christmas",
+    keywords: ["christmas", "nativity", "birth of christ"]
+  },
+  HOLY_INNOCENTS: {
+    title: "Holy Innocents",
+    keywords: ["holy innocents", "martyrs", "herod"]
+  },
+  HOLY_FAMILY: {
+    title: "Holy Family",
+    keywords: ["holy family", "jesus mary joseph"]
+  },
+  // Computed
+  ADVENT_1: {
+    title: "First Sunday of Advent",
+    keywords: ["advent", "first sunday"]
+  },
+  ADVENT_2: {
+    title: "Second Sunday of Advent",
+    keywords: ["advent", "second sunday"]
+  },
+  ADVENT_3: {
+    title: "Third Sunday of Advent",
+    keywords: ["advent", "third sunday", "gaudete"]
+  },
+  ADVENT_4: {
+    title: "Fourth Sunday of Advent",
+    keywords: ["advent", "fourth sunday"]
+  },
+  BAPTISM_OF_LORD: {
+    title: "Baptism of the Lord",
+    keywords: ["baptism", "jordan", "epiphany"]
+  },
+  CHRIST_THE_KING: {
+    title: "Christ the King",
+    keywords: ["christ the king", "king", "reign"]
+  },
+  // ===== MEMORIAL SAINTS =====
+  // January
+  BASIL_GREGORY: {
+    title: "Saints Basil the Great and Gregory Nazianzen",
+    keywords: ["basil", "gregory", "doctors"]
+  },
+  ANTHONY_ABBOT: { title: "Saint Anthony, Abbot", keywords: ["anthony", "abbot", "desert father"] },
+  AGNES: { title: "Saint Agnes, Virgin and Martyr", keywords: ["agnes", "virgin", "martyr"] },
+  FRANCIS_DE_SALES: {
+    title: "Saint Francis de Sales",
+    keywords: ["francis de sales", "doctor", "bishop"]
+  },
+  TIMOTHY_TITUS: { title: "Saints Timothy and Titus", keywords: ["timothy", "titus", "bishops"] },
+  THOMAS_AQUINAS: {
+    title: "Saint Thomas Aquinas",
+    keywords: ["thomas aquinas", "doctor", "angelic"]
+  },
+  JOHN_BOSCO: { title: "Saint John Bosco", keywords: ["john bosco", "don bosco", "salesians"] },
+  // February
+  AGATHA: { title: "Saint Agatha", keywords: ["agatha", "virgin", "martyr"] },
+  PAUL_MIKI: {
+    title: "Saints Paul Miki and Companions",
+    keywords: ["paul miki", "japan", "martyrs"]
+  },
+  SCHOLASTICA: { title: "Saint Scholastica", keywords: ["scholastica", "virgin", "benedict"] },
+  OUR_LADY_OF_LOURDES: {
+    title: "Our Lady of Lourdes",
+    keywords: ["lourdes", "mary", "bernadette"]
+  },
+  CYRIL_METHODIUS: {
+    title: "Saints Cyril and Methodius",
+    keywords: ["cyril", "methodius", "slavs"]
+  },
+  POLYCARP: { title: "Saint Polycarp", keywords: ["polycarp", "bishop", "martyr"] },
+  // March
+  PERPETUA_FELICITY: {
+    title: "Saints Perpetua and Felicity",
+    keywords: ["perpetua", "felicity", "martyrs"]
+  },
+  PATRICK: { title: "Saint Patrick", keywords: ["patrick", "ireland", "bishop"] },
+  CYRIL_OF_JERUSALEM: {
+    title: "Saint Cyril of Jerusalem",
+    keywords: ["cyril", "jerusalem", "doctor"]
+  },
+  // April
+  MARTIN_I: { title: "Saint Martin I", keywords: ["martin", "pope", "martyr"] },
+  ANSELM: { title: "Saint Anselm", keywords: ["anselm", "canterbury", "doctor"] },
+  GEORGE: { title: "Saint George", keywords: ["george", "martyr", "dragon"] },
+  ADALBERT: { title: "Saint Adalbert", keywords: ["adalbert", "bishop", "martyr"] },
+  FIDELIS: { title: "Saint Fidelis of Sigmaringen", keywords: ["fidelis", "martyr", "capuchin"] },
+  LOUIS_GRIGNION: {
+    title: "Saint Louis Grignion de Montfort",
+    keywords: ["louis montfort", "mary"]
+  },
+  PETER_CHANEL: { title: "Saint Peter Chanel", keywords: ["peter chanel", "martyr", "oceania"] },
+  CATHERINE_OF_SIENA: {
+    title: "Saint Catherine of Siena",
+    keywords: ["catherine siena", "doctor", "mystic"]
+  },
+  PIUS_V: { title: "Saint Pius V", keywords: ["pius", "pope", "rosary"] },
+  // May
+  JOSEPH_WORKER: { title: "Saint Joseph the Worker", keywords: ["joseph", "worker", "labor"] },
+  ATHANASIUS: { title: "Saint Athanasius", keywords: ["athanasius", "doctor", "alexandria"] },
+  NEREUS_ACHILLEUS: {
+    title: "Saints Nereus and Achilleus",
+    keywords: ["nereus", "achilleus", "martyrs"]
+  },
+  PANCRAS: { title: "Saint Pancras", keywords: ["pancras", "martyr"] },
+  OUR_LADY_OF_FATIMA: { title: "Our Lady of Fatima", keywords: ["fatima", "mary", "portugal"] },
+  JOHN_I: { title: "Saint John I", keywords: ["john", "pope", "martyr"] },
+  BERNARDINE: { title: "Saint Bernardine of Siena", keywords: ["bernardine", "siena", "preacher"] },
+  PHILIP_NERI: { title: "Saint Philip Neri", keywords: ["philip neri", "oratory", "rome"] },
+  AUGUSTINE_OF_CANTERBURY: {
+    title: "Saint Augustine of Canterbury",
+    keywords: ["augustine", "canterbury", "england"]
+  },
+  // June
+  JUSTIN: { title: "Saint Justin Martyr", keywords: ["justin", "martyr", "philosopher"] },
+  MARCELLINUS_PETER: {
+    title: "Saints Marcellinus and Peter",
+    keywords: ["marcellinus", "peter", "martyrs"]
+  },
+  CHARLES_LWANGA: {
+    title: "Saints Charles Lwanga and Companions",
+    keywords: ["charles lwanga", "uganda", "martyrs"]
+  },
+  BONIFACE: { title: "Saint Boniface", keywords: ["boniface", "germany", "martyr"] },
+  NORBERT: { title: "Saint Norbert", keywords: ["norbert", "premonstratensians"] },
+  EPHREM: { title: "Saint Ephrem", keywords: ["ephrem", "syria", "doctor"] },
+  BARNABAS: { title: "Saint Barnabas", keywords: ["barnabas", "apostle", "cyprus"] },
+  ROMUALD: { title: "Saint Romuald", keywords: ["romuald", "camaldolese"] },
+  JOHN_FISHER_THOMAS_MORE: {
+    title: "Saints John Fisher and Thomas More",
+    keywords: ["john fisher", "thomas more", "martyrs", "england"]
+  },
+  FIRST_MARTYRS_OF_ROME: {
+    title: "First Martyrs of the Holy Roman Church",
+    keywords: ["martyrs", "rome", "nero"]
+  },
+  // July
+  THOMAS_APOSTLE: { title: "Saint Thomas, Apostle", keywords: ["thomas", "apostle", "doubting"] },
+  ELIZABETH_OF_PORTUGAL: {
+    title: "Saint Elizabeth of Portugal",
+    keywords: ["elizabeth", "portugal", "queen"]
+  },
+  MARIA_GORETTI: { title: "Saint Maria Goretti", keywords: ["maria goretti", "virgin", "martyr"] },
+  AUGUSTINE_ZHAO: {
+    title: "Saints Augustine Zhao Rong and Companions",
+    keywords: ["augustine zhao", "china", "martyrs"]
+  },
+  BENEDICT: { title: "Saint Benedict", keywords: ["benedict", "monks", "nursia"] },
+  HENRY: { title: "Saint Henry", keywords: ["henry", "emperor"] },
+  CAMILLUS: { title: "Saint Camillus de Lellis", keywords: ["camillus", "sick", "nurses"] },
+  BONAVENTURE: { title: "Saint Bonaventure", keywords: ["bonaventure", "doctor", "franciscan"] },
+  OUR_LADY_OF_MOUNT_CARMEL: {
+    title: "Our Lady of Mount Carmel",
+    keywords: ["carmel", "mary", "scapular"]
+  },
+  APOLLINARIS: { title: "Saint Apollinaris", keywords: ["apollinaris", "ravenna", "martyr"] },
+  LAWRENCE_OF_BRINDISI: {
+    title: "Saint Lawrence of Brindisi",
+    keywords: ["lawrence brindisi", "doctor", "capuchin"]
+  },
+  MARY_MAGDALENE: {
+    title: "Saint Mary Magdalene",
+    keywords: ["mary magdalene", "apostle to apostles"]
+  },
+  BRIDGET: { title: "Saint Bridget", keywords: ["bridget", "sweden", "mystic"] },
+  SHARBEL: { title: "Saint Sharbel Makhluf", keywords: ["sharbel", "lebanon", "hermit"] },
+  JAMES_APOSTLE: { title: "Saint James, Apostle", keywords: ["james", "apostle", "compostela"] },
+  MARTHA: { title: "Saint Martha", keywords: ["martha", "bethany"] },
+  PETER_CHRYSOLOGUS: {
+    title: "Saint Peter Chrysologus",
+    keywords: ["peter chrysologus", "doctor", "ravenna"]
+  },
+  IGNATIUS_OF_LOYOLA: {
+    title: "Saint Ignatius of Loyola",
+    keywords: ["ignatius", "loyola", "jesuits"]
+  },
+  // August
+  ALPHONSUS: {
+    title: "Saint Alphonsus Liguori",
+    keywords: ["alphonsus", "liguori", "doctor", "redemptorists"]
+  },
+  JOHN_VIANNEY: {
+    title: "Saint John Vianney",
+    keywords: ["john vianney", "cure of ars", "priest"]
+  },
+  DEDICATION_MARY_MAJOR: {
+    title: "Dedication of the Basilica of Saint Mary Major",
+    keywords: ["mary major", "basilica", "rome"]
+  },
+  SIXTUS_II: { title: "Saint Sixtus II and Companions", keywords: ["sixtus", "pope", "martyrs"] },
+  CAJETAN: { title: "Saint Cajetan", keywords: ["cajetan", "theatines"] },
+  DOMINIC: { title: "Saint Dominic", keywords: ["dominic", "dominicans", "preacher"] },
+  LAWRENCE: {
+    title: "Saint Lawrence, Deacon and Martyr",
+    keywords: ["lawrence", "deacon", "martyr"]
+  },
+  CLARE: { title: "Saint Clare", keywords: ["clare", "assisi", "poor clares"] },
+  JANE_FRANCES: {
+    title: "Saint Jane Frances de Chantal",
+    keywords: ["jane frances", "chantal", "visitation"]
+  },
+  PONTIAN_HIPPOLYTUS: {
+    title: "Saints Pontian and Hippolytus",
+    keywords: ["pontian", "hippolytus", "martyrs"]
+  },
+  MAXIMILIAN_KOLBE: {
+    title: "Saint Maximilian Kolbe",
+    keywords: ["maximilian kolbe", "auschwitz", "martyr"]
+  },
+  JOHN_EUDES: { title: "Saint John Eudes", keywords: ["john eudes", "hearts"] },
+  BERNARD: { title: "Saint Bernard", keywords: ["bernard", "clairvaux", "doctor"] },
+  PIUS_X: { title: "Saint Pius X", keywords: ["pius", "pope", "eucharist"] },
+  QUEENSHIP_OF_MARY: {
+    title: "Queenship of the Blessed Virgin Mary",
+    keywords: ["queenship", "mary", "queen"]
+  },
+  BARTHOLOMEW: {
+    title: "Saint Bartholomew, Apostle",
+    keywords: ["bartholomew", "apostle", "nathanael"]
+  },
+  LOUIS_IX: { title: "Saint Louis IX", keywords: ["louis", "france", "king"] },
+  JOSEPH_CALASANZ: {
+    title: "Saint Joseph Calasanz",
+    keywords: ["joseph calasanz", "piarists", "schools"]
+  },
+  MONICA: { title: "Saint Monica", keywords: ["monica", "augustine", "mother"] },
+  AUGUSTINE: { title: "Saint Augustine", keywords: ["augustine", "hippo", "doctor"] },
+  PASSION_OF_JOHN_BAPTIST: {
+    title: "Passion of Saint John the Baptist",
+    keywords: ["john baptist", "beheading", "martyr"]
+  },
+  // September
+  GREGORY_THE_GREAT: { title: "Saint Gregory the Great", keywords: ["gregory", "pope", "doctor"] },
+  BIRTH_OF_MARY: {
+    title: "Nativity of the Blessed Virgin Mary",
+    keywords: ["birth", "mary", "nativity"]
+  },
+  PETER_CLAVER: { title: "Saint Peter Claver", keywords: ["peter claver", "slaves", "jesuit"] },
+  MOST_HOLY_NAME_OF_MARY: { title: "Most Holy Name of Mary", keywords: ["name", "mary"] },
+  OUR_LADY_OF_SORROWS: {
+    title: "Our Lady of Sorrows",
+    keywords: ["sorrows", "mary", "seven sorrows"]
+  },
+  CORNELIUS_CYPRIAN: {
+    title: "Saints Cornelius and Cyprian",
+    keywords: ["cornelius", "cyprian", "martyrs"]
+  },
+  ROBERT_BELLARMINE: {
+    title: "Saint Robert Bellarmine",
+    keywords: ["robert bellarmine", "doctor", "jesuit"]
+  },
+  JANUARIUS: { title: "Saint Januarius", keywords: ["januarius", "naples", "martyr"] },
+  MATTHEW: {
+    title: "Saint Matthew, Apostle and Evangelist",
+    keywords: ["matthew", "apostle", "evangelist"]
+  },
+  PADRE_PIO: {
+    title: "Saint Padre Pio of Pietrelcina",
+    keywords: ["padre pio", "stigmata", "capuchin"]
+  },
+  COSMAS_DAMIAN: {
+    title: "Saints Cosmas and Damian",
+    keywords: ["cosmas", "damian", "martyrs", "physicians"]
+  },
+  WENCESLAUS: { title: "Saint Wenceslaus", keywords: ["wenceslaus", "bohemia", "martyr"] },
+  LAWRENCE_RUIZ: {
+    title: "Saints Lawrence Ruiz and Companions",
+    keywords: ["lawrence ruiz", "philippines", "martyrs"]
+  },
+  ARCHANGELS: {
+    title: "Saints Michael, Gabriel, and Raphael, Archangels",
+    keywords: ["michael", "gabriel", "raphael", "archangels"]
+  },
+  JEROME: { title: "Saint Jerome", keywords: ["jerome", "doctor", "bible", "vulgate"] },
+  // October
+  THERESE_OF_LISIEUX: {
+    title: "Saint Therese of the Child Jesus",
+    keywords: ["therese", "lisieux", "little flower", "doctor"]
+  },
+  GUARDIAN_ANGELS: { title: "Holy Guardian Angels", keywords: ["guardian angels", "angels"] },
+  FRANCIS_OF_ASSISI: {
+    title: "Saint Francis of Assisi",
+    keywords: ["francis", "assisi", "franciscans"]
+  },
+  FAUSTINA: { title: "Saint Faustina Kowalska", keywords: ["faustina", "divine mercy"] },
+  BRUNO: { title: "Saint Bruno", keywords: ["bruno", "carthusians"] },
+  OUR_LADY_OF_ROSARY: { title: "Our Lady of the Rosary", keywords: ["rosary", "mary", "lepanto"] },
+  DENIS: { title: "Saint Denis and Companions", keywords: ["denis", "paris", "martyrs"] },
+  CALLISTUS_I: { title: "Saint Callistus I", keywords: ["callistus", "pope", "martyr"] },
+  TERESA_OF_AVILA: {
+    title: "Saint Teresa of Avila",
+    keywords: ["teresa", "avila", "doctor", "carmelite"]
+  },
+  HEDWIG: { title: "Saint Hedwig", keywords: ["hedwig", "silesia"] },
+  MARGARET_MARY: {
+    title: "Saint Margaret Mary Alacoque",
+    keywords: ["margaret mary", "sacred heart"]
+  },
+  IGNATIUS_OF_ANTIOCH: {
+    title: "Saint Ignatius of Antioch",
+    keywords: ["ignatius", "antioch", "martyr"]
+  },
+  LUKE: { title: "Saint Luke, Evangelist", keywords: ["luke", "evangelist", "physician"] },
+  ISAAC_JOGUES: {
+    title: "Saints Isaac Jogues and Companions",
+    keywords: ["isaac jogues", "north america", "martyrs"]
+  },
+  PAUL_OF_CROSS: { title: "Saint Paul of the Cross", keywords: ["paul cross", "passionists"] },
+  JOHN_PAUL_II: { title: "Saint John Paul II", keywords: ["john paul", "pope", "poland"] },
+  JOHN_OF_CAPISTRANO: {
+    title: "Saint John of Capistrano",
+    keywords: ["john capistrano", "franciscan"]
+  },
+  ANTHONY_MARY_CLARET: {
+    title: "Saint Anthony Mary Claret",
+    keywords: ["anthony claret", "claretians"]
+  },
+  SIMON_JUDE: { title: "Saints Simon and Jude, Apostles", keywords: ["simon", "jude", "apostles"] },
+  // November
+  DEDICATION_LATERAN: {
+    title: "Dedication of the Lateran Basilica",
+    keywords: ["lateran", "basilica", "rome"]
+  },
+  LEO_THE_GREAT: { title: "Saint Leo the Great", keywords: ["leo", "pope", "doctor"] },
+  MARTIN_OF_TOURS: { title: "Saint Martin of Tours", keywords: ["martin", "tours", "cloak"] },
+  JOSAPHAT: { title: "Saint Josaphat", keywords: ["josaphat", "bishop", "martyr"] },
+  MARGARET_OF_SCOTLAND: {
+    title: "Saint Margaret of Scotland",
+    keywords: ["margaret", "scotland", "queen"]
+  },
+  GERTRUDE: { title: "Saint Gertrude", keywords: ["gertrude", "mystic"] },
+  ELIZABETH_OF_HUNGARY: {
+    title: "Saint Elizabeth of Hungary",
+    keywords: ["elizabeth", "hungary", "charity"]
+  },
+  DEDICATION_PETER_PAUL: {
+    title: "Dedication of the Basilicas of Saints Peter and Paul",
+    keywords: ["peter", "paul", "basilicas", "rome"]
+  },
+  PRESENTATION_OF_MARY: {
+    title: "Presentation of the Blessed Virgin Mary",
+    keywords: ["presentation", "mary", "temple"]
+  },
+  CLEMENT_I: { title: "Saint Clement I", keywords: ["clement", "pope", "martyr"] },
+  COLUMBAN: { title: "Saint Columban", keywords: ["columban", "ireland", "missionary"] },
+  CATHERINE_OF_ALEXANDRIA: {
+    title: "Saint Catherine of Alexandria",
+    keywords: ["catherine", "alexandria", "martyr"]
+  },
+  ANDREW_APOSTLE: { title: "Saint Andrew, Apostle", keywords: ["andrew", "apostle", "scotland"] },
+  // December
+  FRANCIS_XAVIER: {
+    title: "Saint Francis Xavier",
+    keywords: ["francis xavier", "jesuit", "missions"]
+  },
+  LUCY: { title: "Saint Lucy", keywords: ["lucy", "virgin", "martyr", "light"] },
+  STEPHEN_FIRST_MARTYR: {
+    title: "Saint Stephen, First Martyr",
+    keywords: ["stephen", "first martyr", "deacon"]
+  },
+  JOHN_APOSTLE: {
+    title: "Saint John, Apostle and Evangelist",
+    keywords: ["john", "apostle", "evangelist", "beloved"]
+  }
+};
+
+// src/utils/generator.ts
+function getYearsInRange(range) {
+  const startYear = getYear(range.from);
+  const endYear = getYear(range.to);
+  const years = [];
+  for (let y = startYear; y <= endYear; y++) {
+    years.push(y);
+  }
+  return years;
+}
+function computeEventDate(def, year, options) {
+  switch (def.type) {
+    case "easter": {
+      const easter = computeEaster(year);
+      return formatDate(easter);
+    }
+    case "offset": {
+      let offsetDays = def.offsetDays;
+      if (def.key === "ASCENSION" && options.ascensionOnSunday) {
+        offsetDays = 42;
+      }
+      if (def.key === "CORPUS_CHRISTI" && options.corpusChristiOnSunday) {
+        offsetDays = 63;
+      }
+      const easter = computeEaster(year);
+      const eventDate = addDays(easter, offsetDays);
+      return formatDate(eventDate);
+    }
+    case "const": {
+      if (def.month && def.day) {
+        const month = String(def.month).padStart(2, "0");
+        const day = String(def.day).padStart(2, "0");
+        return `${year}-${month}-${day}`;
+      }
+      return null;
+    }
+    case "nth-weekday": {
+      return computeNthWeekdayDate(def, year);
+    }
+    case "formula":
+      return null;
+    /* v8 ignore next 2 -- defensive: def.type is an exhaustive union (no other case) */
+    default:
+      return null;
+  }
+}
+function computeNthWeekdayDate(def, year) {
+  const dayOfWeek = def.dayOfWeek;
+  if (dayOfWeek === void 0) return null;
+  if (def.after !== void 0) {
+    const candidate = firstWeekdayOnOrAfterAnchor(year, def.after, dayOfWeek);
+    if (def.before !== void 0) {
+      const beforeDate = new Date(year, def.before.month - 1, def.before.day);
+      if (candidate === null || candidate >= beforeDate) {
+        if (def.fallback !== void 0) {
+          const m2 = String(def.fallback.month).padStart(2, "0");
+          const d2 = String(def.fallback.day).padStart(2, "0");
+          return `${year}-${m2}-${d2}`;
+        }
+        return null;
+      }
+    }
+    if (candidate === null) return null;
+    const m = String(candidate.getMonth() + 1).padStart(2, "0");
+    const d = String(candidate.getDate()).padStart(2, "0");
+    return `${year}-${m}-${d}`;
+  }
+  if (def.nth !== void 0 && def.nthMonth !== void 0) {
+    const date = nthWeekdayInMonth(year, def.nthMonth, dayOfWeek, def.nth);
+    if (!date) return null;
+    const m = String(date.getMonth() + 1).padStart(2, "0");
+    const d = String(date.getDate()).padStart(2, "0");
+    return `${year}-${m}-${d}`;
+  }
+  return null;
+}
+function firstWeekdayOnOrAfterAnchor(year, anchor, dayOfWeek) {
+  for (let offset = 0; offset <= 6; offset++) {
+    const date = new Date(year, anchor.month - 1, anchor.day + offset);
+    if (date.getDay() === dayOfWeek) return date;
+  }
+  return null;
+}
+function nthWeekdayInMonth(year, month, dayOfWeek, nth) {
+  if (nth === -1) {
+    const daysInMonth2 = new Date(year, month, 0).getDate();
+    for (let d = daysInMonth2; d >= 1; d--) {
+      const date = new Date(year, month - 1, d);
+      if (date.getDay() === dayOfWeek) return date;
+    }
+    return null;
+  }
+  let count = 0;
+  const daysInMonth = new Date(year, month, 0).getDate();
+  for (let d = 1; d <= daysInMonth; d++) {
+    const date = new Date(year, month - 1, d);
+    if (date.getDay() === dayOfWeek) {
+      count++;
+      if (count === nth) return date;
+    }
+  }
+  return null;
+}
+function buildEventConfig(def, options) {
+  const key = def.key;
+  const defaultText = DEFAULT_LITURGICAL_TEXTS[key] ?? { title: def.key };
+  const customConfig = options.customResolver?.(key);
+  const baseConfig = {
+    id: def.key.toLowerCase().replace(/_/g, "-"),
+    title: defaultText.title,
+    metadata: def.metadata,
+    priority: def.metadata.rank === "solemnity" ? 1 : def.metadata.rank === "feast" ? 2 : 3
+  };
+  if (defaultText.keywords && defaultText.keywords.length > 0) {
+    baseConfig.keywords = defaultText.keywords;
+  }
+  const mergedConfig = mergeEventConfig(baseConfig, customConfig);
+  switch (def.type) {
+    case "easter":
+      return { ...mergedConfig, type: "easter" };
+    case "offset": {
+      let offsetDays = def.offsetDays;
+      if (def.key === "ASCENSION" && options.ascensionOnSunday) {
+        offsetDays = 42;
+      }
+      if (def.key === "CORPUS_CHRISTI" && options.corpusChristiOnSunday) {
+        offsetDays = 63;
+      }
+      return {
+        ...mergedConfig,
+        type: "offset",
+        baseEvent: "easter",
+        offsetDays
+      };
+    }
+    case "const":
+      return {
+        ...mergedConfig,
+        type: "const",
+        month: def.month,
+        day: def.day
+      };
+    case "nth-weekday":
+      return {
+        ...mergedConfig,
+        type: "nth-weekday",
+        dayOfWeek: def.dayOfWeek,
+        nth: def.nth,
+        month: def.nthMonth,
+        after: def.after,
+        before: def.before,
+        fallback: def.fallback
+      };
+    case "formula":
+      return {
+        ...mergedConfig,
+        type: "formula",
+        formula: def.formula
+      };
+    /* v8 ignore start -- defensive: def.type is an exhaustive union, no unknown type reaches here */
+    default:
+      return { ...mergedConfig, type: "const", month: 1, day: 1 };
+  }
+}
+var DEFAULT_OPTIONS = {
+  epiphanyOnSunday: false,
+  ascensionOnSunday: false,
+  corpusChristiOnSunday: true,
+  includeCategories: ["easter-cycle", "solemnities", "feasts", "memorials", "computed"],
+  groupId: "liturgical-calendar"
+};
+function generateLiturgicalEvents(options) {
+  const mergedOptions = { ...DEFAULT_OPTIONS, ...options };
+  const range = mergedOptions.range;
+  const years = getYearsInRange(range);
+  const allEvents = [];
+  const categories = mergedOptions.includeCategories;
+  const eventDefs = getEventsByCategory(categories);
+  for (const def of eventDefs) {
+    const eventConfig = buildEventConfig(def, mergedOptions);
+    let shouldDrop = false;
+    const onConflict = "onConflict" in eventConfig ? eventConfig.onConflict : void 0;
+    if (onConflict) {
+      for (const year of years) {
+        const eventDate = computeEventDate(def, year, mergedOptions);
+        if (eventDate) {
+          const conflictAction = resolveConflict(onConflict, eventDate);
+          if (conflictAction.action === "drop") {
+            shouldDrop = true;
+            break;
+          }
+        }
+      }
+    }
+    if (!shouldDrop) {
+      allEvents.push(eventConfig);
+    }
+  }
+  return {
+    id: mergedOptions.groupId,
+    events: allEvents
+  };
+}
+function createLiturgicalGenerator(generatorOptions = {}) {
+  const { defaults } = generatorOptions;
+  return (options) => {
+    const mergedOptions = { ...defaults, ...options };
+    return generateLiturgicalEvents(mergedOptions);
+  };
+}
+
+export { ALL_LITURGICAL_EVENTS, ALL_MASS_KEYS, ASCENSION, ASH_WEDNESDAY, COMPUTED_EVENTS, COMPUTED_KEYS, CORPUS_CHRISTI, DEFAULT_LITURGICAL_TEXTS, EASTER, EASTER_CYCLE_EVENTS, EASTER_CYCLE_KEYS, FIXED_SOLEMNITY_EVENTS, FIXED_SOLEMNITY_KEYS, GOOD_FRIDAY, HOLY_SATURDAY, HOLY_THURSDAY, LITURGICAL_EVENTS, MEMORIAL_SAINT_EVENTS, MEMORIAL_SAINT_KEYS, MassKeys, PALM_SUNDAY, PENTECOST, TRINITY_SUNDAY, computeEaster, computeOrthodoxEaster, createLiturgicalGenerator, easterEventHandler, easterRelativeDate, generateLiturgicalEvents, getAdvent1, getAdvent2, getAdvent3, getAdvent4, getBaptismOfLord, getCalendarYearSeasons, getChristTheKing, getCurrentSeason, getEasterDateString, getEventsByCategory, getHolyFamily, getLiturgicalDay, getLiturgicalDaysForMonth, getLiturgicalDaysForYear, getLiturgicalDaysInRange, getLiturgicalYear, getLiturgicalYearBoundaries, getLiturgicalYearChart, getSeason, liturgical, offsetEventHandler };