bg-name-days 2.0.0

package/src/data/nameDays.js

@@ -0,0 +1,132 @@
+/** @typedef {import('../types.js').NameDayEntry} NameDayEntry */
+
+import { january } from './january.js';
+import { february } from './february.js';
+import { march } from './march.js';
+import { april } from './april.js';
+import { may } from './may.js';
+import { june } from './june.js';
+import { july } from './july.js';
+import { august } from './august.js';
+import { september } from './september.js';
+import { october } from './october.js';
+import { november } from './november.js';
+import { december } from './december.js';
+import { getMoveableEntries } from '../moveable.js';
+
+/** All fixed-date entries (no year dependency). */
+const fixedEntries = [
+  ...january, ...february, ...march, ...april,
+  ...may, ...june, ...july, ...august,
+  ...september, ...october, ...november, ...december,
+];
+
+/**
+ * @typedef {Object} NameDayIndex
+ * @property {Map<string, NameDayEntry[]>} byName - lowercase name → entries
+ * @property {Map<string, NameDayEntry[]>} byDate - "MM-DD" → entries
+ * @property {Map<string, NameDayEntry[]>} byHoliday - lowercase holiday → entries
+ * @property {number} year - year this index was built for
+ */
+
+/** @type {Map<number, NameDayIndex>} */
+const indexCache = new Map();
+
+/**
+ * Pad a number to 2 digits.
+ * @param {number} n
+ * @returns {string}
+ */
+function pad(n) {
+  return String(n).padStart(2, '0');
+}
+
+/**
+ * Build name/date/holiday indexes for a given year.
+ * Moveable entries are resolved for that year.
+ * @param {NameDayEntry[]} entries
+ * @param {number} year
+ * @returns {NameDayIndex}
+ */
+function buildIndex(entries, year) {
+  /** @type {Map<string, NameDayEntry[]>} */
+  const byName = new Map();
+  /** @type {Map<string, NameDayEntry[]>} */
+  const byDate = new Map();
+  /** @type {Map<string, NameDayEntry[]>} */
+  const byHoliday = new Map();
+
+  for (const entry of entries) {
+    // Index by primary name (lowercase)
+    const primaryKey = entry.name.toLowerCase();
+    if (!byName.has(primaryKey)) byName.set(primaryKey, []);
+    byName.get(primaryKey).push(entry);
+
+    // Index by each variant (lowercase)
+    for (const variant of entry.variants) {
+      const variantKey = variant.toLowerCase();
+      if (!byName.has(variantKey)) byName.set(variantKey, []);
+      byName.get(variantKey).push(entry);
+    }
+
+    // Index by each latin name (lowercase)
+    for (const latin of entry.latin) {
+      const latinKey = latin.toLowerCase();
+      if (!byName.has(latinKey)) byName.set(latinKey, []);
+      byName.get(latinKey).push(entry);
+    }
+
+    // Index by date "MM-DD"
+    const dateKey = `${pad(entry.month)}-${pad(entry.day)}`;
+    if (!byDate.has(dateKey)) byDate.set(dateKey, []);
+    byDate.get(dateKey).push(entry);
+
+    // Index by holiday (lowercase)
+    const holidayKey = entry.holiday.toLowerCase();
+    if (!byHoliday.has(holidayKey)) byHoliday.set(holidayKey, []);
+    byHoliday.get(holidayKey).push(entry);
+  }
+
+  return { byName, byDate, byHoliday, year };
+}
+
+/**
+ * Get the index for a given year. Uses cache for performance.
+ * @param {number} [year] - defaults to current year
+ * @returns {NameDayIndex}
+ */
+export function getIndex(year) {
+  const y = year ?? new Date().getFullYear();
+
+  if (indexCache.has(y)) {
+    return /** @type {NameDayIndex} */ (indexCache.get(y));
+  }
+
+  const moveableEntries = getMoveableEntries(y);
+  const allEntries = [...fixedEntries, ...moveableEntries];
+  const index = buildIndex(allEntries, y);
+
+  indexCache.set(y, index);
+  return index;
+}
+
+/**
+ * Get all fixed-date entries (no moveable).
+ * Returns a shallow copy.
+ * @returns {NameDayEntry[]}
+ */
+export function getAllFixed() {
+  return [...fixedEntries];
+}
+
+/**
+ * Get all entries for a given year (fixed + resolved moveable).
+ * Returns a shallow copy.
+ * @param {number} [year] - defaults to current year
+ * @returns {NameDayEntry[]}
+ */
+export function getAllEntries(year) {
+  const y = year ?? new Date().getFullYear();
+  const moveableEntries = getMoveableEntries(y);
+  return [...fixedEntries, ...moveableEntries];
+}

package/src/data/november.js

@@ -0,0 +1,225 @@
+/** @typedef {import('../types.js').NameDayEntry} NameDayEntry */
+
+/** @type {NameDayEntry[]} */
+export const november = [
+  {
+    name: "Будин",
+    variants: ["Будинка"],
+    latin: ["Budin", "Budinka"],
+    month: 11, day: 1,
+    holiday: "Ден на народните будители",
+    holidayLatin: "Den na narodnite buditeli",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Михаил",
+    variants: ["Михаела", "Михо", "Мишо", "Миха", "Михалина"],
+    latin: ["Mihail", "Mihaela", "Miho", "Misho", "Miha", "Mihalina"],
+    month: 11, day: 8,
+    holiday: "Архангеловден (Свети Архангел Михаил)",
+    holidayLatin: "Arhangelovden (Sveti Arhangel Mihail)",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Ангел",
+    variants: ["Ангела", "Ангелина", "Ангелинка", "Архангел"],
+    latin: ["Angel", "Angela", "Angelina", "Angelinka", "Arhangel"],
+    month: 11, day: 8,
+    holiday: "Архангеловден (Свети Архангел Михаил)",
+    holidayLatin: "Arhangelovden (Sveti Arhangel Mihail)",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Гавраил",
+    variants: ["Гаврил", "Габриел", "Габриела"],
+    latin: ["Gavrail", "Gavril", "Gabriel", "Gabriela"],
+    month: 11, day: 8,
+    holiday: "Архангеловден (Свети Архангел Михаил)",
+    holidayLatin: "Arhangelovden (Sveti Arhangel Mihail)",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Рафаел",
+    variants: ["Рафаела"],
+    latin: ["Rafael", "Rafaela"],
+    month: 11, day: 8,
+    holiday: "Архангеловден (Свети Архангел Михаил)",
+    holidayLatin: "Arhangelovden (Sveti Arhangel Mihail)",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Мина",
+    variants: ["Минка", "Минчо"],
+    latin: ["Mina", "Minka", "Mincho"],
+    month: 11, day: 11,
+    holiday: "Свети Мина",
+    holidayLatin: "Sveti Mina",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Гурий",
+    variants: [],
+    latin: ["Guriy"],
+    month: 11, day: 15,
+    holiday: "Свети Гурий",
+    holidayLatin: "Sveti Guriy",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Матей",
+    variants: ["Матея"],
+    latin: ["Matey", "Mateya"],
+    month: 11, day: 16,
+    holiday: "Свети Матей",
+    holidayLatin: "Sveti Matey",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Мария",
+    variants: ["Мариан", "Мариана", "Марийка", "Мариела"],
+    latin: ["Mariya", "Marian", "Mariana", "Mariyka", "Mariela"],
+    month: 11, day: 21,
+    holiday: "Въведение Богородично",
+    holidayLatin: "Vavedenie Bogorodichno",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Филип",
+    variants: ["Филипа"],
+    latin: ["Filip", "Filipa"],
+    month: 11, day: 22,
+    holiday: "Свети Филимон и Архип",
+    holidayLatin: "Sveti Filimon i Arhip",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Александър",
+    variants: ["Александра", "Сашо", "Сашка", "Алекс"],
+    latin: ["Aleksandar", "Aleksandra", "Sasho", "Sashka", "Aleks"],
+    month: 11, day: 23,
+    holiday: "Свети Александър Невски",
+    holidayLatin: "Sveti Aleksandar Nevski",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Климент",
+    variants: ["Климентина"],
+    latin: ["Kliment", "Klimentina"],
+    month: 11, day: 25,
+    holiday: "Свети Климент Охридски",
+    holidayLatin: "Sveti Kliment Ohridski",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Андрей",
+    variants: ["Андрея", "Андреан", "Андреана", "Андриан", "Андрияна", "Андро", "Първан", "Първанка"],
+    latin: ["Andrey", "Andreya", "Andrean", "Andreana", "Andrian", "Andriyana", "Andro", "Parvan", "Parvanka"],
+    month: 11, day: 30,
+    holiday: "Андреевден",
+    holidayLatin: "Andreevden",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Йоаникий",
+    variants: [],
+    latin: ["Yoanikiy"],
+    month: 11, day: 4,
+    holiday: "Свети Йоаникий",
+    holidayLatin: "Sveti Yoanikiy",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Нектарий",
+    variants: [],
+    latin: ["Nektariy"],
+    month: 11, day: 9,
+    holiday: "Свети Нектарий",
+    holidayLatin: "Sveti Nektariy",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Златко",
+    variants: ["Златка", "Златина", "Злата", "Златан", "Златимир", "Златимира"],
+    latin: ["Zlatko", "Zlatka", "Zlatina", "Zlata", "Zlatan", "Zlatimir", "Zlatimira"],
+    month: 11, day: 13,
+    holiday: "Свети Йоан Златоуст",
+    holidayLatin: "Sveti Yoan Zlatoust",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Григор",
+    variants: ["Григорий", "Гриша"],
+    latin: ["Grigor", "Grigoriy", "Grisha"],
+    month: 11, day: 17,
+    holiday: "Свети Григорий Неокесарийски",
+    holidayLatin: "Sveti Grigoriy Neokesariyski",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Павел",
+    variants: ["Павлина", "Паулина", "Поли"],
+    latin: ["Pavel", "Pavlina", "Paulina", "Poli"],
+    month: 11, day: 6,
+    holiday: "Свети Павел",
+    holidayLatin: "Sveti Pavel",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Павел",
+    variants: ["Павлина"],
+    latin: ["Pavel", "Pavlina"],
+    month: 11, day: 19,
+    holiday: "Свети Павел",
+    holidayLatin: "Sveti Pavel",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Филип",
+    variants: ["Филипа", "Филипина"],
+    latin: ["Filip", "Filipa", "Filipina"],
+    month: 11, day: 14,
+    holiday: "Свети Филип",
+    holidayLatin: "Sveti Filip",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Екатерина",
+    variants: ["Катерина", "Катя", "Катюша", "Катрин"],
+    latin: ["Ekaterina", "Katerina", "Katya", "Katyusha", "Katrin"],
+    month: 11, day: 24,
+    holiday: "Света Екатерина",
+    holidayLatin: "Sveta Ekaterina",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Стилиян",
+    variants: ["Стилияна", "Стилян", "Стиляна"],
+    latin: ["Stiliyan", "Stiliyana", "Stilyan", "Stilyana"],
+    month: 11, day: 26,
+    holiday: "Свети Стилиян",
+    holidayLatin: "Sveti Stiliyan",
+    tradition: "orthodox",
+    moveable: null,
+  },
+];

package/src/data/october.js

@@ -0,0 +1,165 @@
+/** @typedef {import('../types.js').NameDayEntry} NameDayEntry */
+
+/** @type {NameDayEntry[]} */
+export const october = [
+  {
+    name: "Закрила",
+    variants: ["Закрилка"],
+    latin: ["Zakrila", "Zakrilka"],
+    month: 10, day: 1,
+    holiday: "Покров Богородичен",
+    holidayLatin: "Pokrov Bogorodichen",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Петка",
+    variants: ["Петкана", "Параскева", "Параскев"],
+    latin: ["Petka", "Petkana", "Paraskeva", "Paraskev"],
+    month: 10, day: 14,
+    holiday: "Петковден (Света Петка)",
+    holidayLatin: "Petkovden (Sveta Petka)",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Тома",
+    variants: ["Томас"],
+    latin: ["Toma", "Tomas"],
+    month: 10, day: 19,
+    holiday: "Свети апостол Тома",
+    holidayLatin: "Sveti apostol Toma",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Артемий",
+    variants: [],
+    latin: ["Artemiy"],
+    month: 10, day: 20,
+    holiday: "Свети Артемий",
+    holidayLatin: "Sveti Artemiy",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Димитър",
+    variants: ["Димитрина", "Димитринка", "Митко", "Митка", "Димо", "Димана", "Димка", "Димчо", "Димитрия", "Деметра", "Деметрия"],
+    latin: ["Dimitar", "Dimitrina", "Dimitrinka", "Mitko", "Mitka", "Dimo", "Dimana", "Dimka", "Dimcho", "Dimitriya", "Demetra", "Demetriya"],
+    month: 10, day: 26,
+    holiday: "Димитровден",
+    holidayLatin: "Dimitrovden",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Нестор",
+    variants: ["Нестора"],
+    latin: ["Nestor", "Nestora"],
+    month: 10, day: 27,
+    holiday: "Свети Нестор",
+    holidayLatin: "Sveti Nestor",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Киприан",
+    variants: ["Киприана"],
+    latin: ["Kiprian", "Kipriana"],
+    month: 10, day: 2,
+    holiday: "Свети Киприан",
+    holidayLatin: "Sveti Kiprian",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Тома",
+    variants: ["Томас"],
+    latin: ["Toma", "Tomas"],
+    month: 10, day: 6,
+    holiday: "Свети апостол Тома",
+    holidayLatin: "Sveti apostol Toma",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Пелагия",
+    variants: [],
+    latin: ["Pelagiya"],
+    month: 10, day: 8,
+    holiday: "Света Пелагия",
+    holidayLatin: "Sveta Pelagiya",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Лука",
+    variants: ["Лукан", "Лучезар", "Лучезара"],
+    latin: ["Luka", "Lukan", "Luchezar", "Luchezara"],
+    month: 10, day: 18,
+    holiday: "Свети апостол Лука",
+    holidayLatin: "Sveti apostol Luka",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Арета",
+    variants: [],
+    latin: ["Areta"],
+    month: 10, day: 24,
+    holiday: "Свети Арета",
+    holidayLatin: "Sveti Areta",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Евлампий",
+    variants: [],
+    latin: ["Evlampiy"],
+    month: 10, day: 10,
+    holiday: "Свети Евлампий",
+    holidayLatin: "Sveti Evlampiy",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Параскева",
+    variants: ["Параскев"],
+    latin: ["Paraskeva", "Paraskev"],
+    month: 10, day: 28,
+    holiday: "Свети Параскева",
+    holidayLatin: "Sveti Paraskeva",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Дария",
+    variants: ["Дарина", "Дарин", "Даринка"],
+    latin: ["Dariya", "Darina", "Darin", "Darinka"],
+    month: 10, day: 12,
+    holiday: "Света Дария",
+    holidayLatin: "Sveta Dariya",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Евтим",
+    variants: ["Евтимия"],
+    latin: ["Evtim", "Evtimiya"],
+    month: 10, day: 15,
+    holiday: "Свети Евтимий Нови",
+    holidayLatin: "Sveti Evtimiy Novi",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Лука",
+    variants: [],
+    latin: ["Luka"],
+    month: 10, day: 31,
+    holiday: "Свети апостол Лука",
+    holidayLatin: "Sveti apostol Luka",
+    tradition: "orthodox",
+    moveable: null,
+  },
+];