bg-name-days 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mariyan Yordanov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# bg-name-days
+
+Bulgarian name days calendar library. Pure JavaScript, zero dependencies.
+800+ names with variants, diminutives, Latin transliteration, and moveable Orthodox feast date computation.
+
+## Installation
+
+```bash
+npm install bg-name-days
+```
+
+## Usage
+
+```js
+import {
+  getNameDay,
+  getNamesByDate,
+  isNameDay,
+  getTodayNames,
+  searchNames,
+  getNamesByHoliday,
+  getUpcomingNameDays,
+  getAllNameDays,
+  transliterate,
+  orthodoxEaster,
+} from 'bg-name-days';
+```
+
+### Find name day by name
+
+```js
+getNameDay('Георги');
+// {
+//   name: 'Георги', month: 5, day: 6,
+//   holiday: 'Гергьовден', holidayLatin: 'Gergyovden',
+//   tradition: 'orthodox', variants: ['Георгина', 'Гергана', ...],
+//   isMoveable: false
+// }
+
+getNameDay('Georgi');  // Latin input works too
+getNameDay('гошо');    // Case-insensitive, finds via variants → Георги
+
+getNameDay('Стефан');
+// Returns array — Стефан has multiple name days (Jan 9 + Dec 27)
+
+getNameDay('Непознато');
+// null
+```
+
+### Get names by date
+
+```js
+getNamesByDate('05-06');
+// ['Георги', 'Георгина', 'Гергана', 'Гошо', 'Жоро', ...]
+
+getNamesByDate(new Date(2026, 0, 1));
+// ['Васил', 'Василка', 'Василена', ...]
+```
+
+### Check if today is someone's name day
+
+```js
+isNameDay('Георги', new Date('2026-05-06'));  // true
+isNameDay('Георги', new Date('2026-05-07'));  // false
+isNameDay('Цветан', new Date('2026-04-05')); // true (Цветница 2026)
+```
+
+### Get today's celebrating names
+
+```js
+getTodayNames();
+// ['Валентин', 'Валентина', 'Трифон', ...] (on Feb 14)
+```
+
+### Search names by prefix
+
+```js
+searchNames('Гео');
+// [{ name: 'Георги', date: '05-06', holiday: 'Гергьовден' }]
+
+searchNames('Geo');  // Latin prefix search works too
+```
+
+### Get names by holiday
+
+```js
+getNamesByHoliday('Гергьовден');
+// ['Георги', 'Георгина', 'Гергана', 'Гошо', 'Жоро', ...]
+
+getNamesByHoliday('Цветница');
+// 100+ flower-related names (Цветан, Роза, Виолета, Маргарита, ...)
+```
+
+### Upcoming name days
+
+```js
+getUpcomingNameDays(7);
+// [
+//   { month: 2, day: 14, holiday: 'Трифон Зарезан', names: ['Трифон', ...] },
+//   { month: 2, day: 17, holiday: '...', names: [...] },
+//   ...
+// ]
+
+getUpcomingNameDays(7, new Date('2026-05-01'));  // Custom start date
+```
+
+### Transliterate
+
+```js
+transliterate('Георги');   // 'Georgi'
+transliterate('Yordan');   // 'Йордан'
+transliterate('Щерьо');    // 'Shteryo'
+```
+
+### Orthodox Easter
+
+```js
+orthodoxEaster(2026);  // Date: April 12, 2026
+orthodoxEaster(2027);  // Date: May 2, 2027
+```
+
+### Get all name days
+
+```js
+const all = getAllNameDays(2026);
+// Array of 263 NameDayResult objects (fixed + resolved moveable for the year)
+```
+
+## API Reference
+
+| Function | Parameters | Returns | Description |
+|---|---|---|---|
+| `getNameDay(name, year?)` | `string, number?` | `NameDayResult \| NameDayResult[] \| null` | Find name day by name (Cyrillic or Latin) |
+| `getNamesByDate(date, year?)` | `string \| Date, number?` | `string[]` | Get all celebrating names for a date |
+| `isNameDay(name, date)` | `string, Date` | `boolean` | Check if a name celebrates on a date |
+| `getTodayNames()` | - | `string[]` | Get names celebrating today |
+| `searchNames(prefix, year?)` | `string, number?` | `SearchResult[]` | Search names by prefix |
+| `getNamesByHoliday(name, year?)` | `string, number?` | `string[]` | Get all names for a holiday |
+| `getUpcomingNameDays(days, start?)` | `number, Date?` | `UpcomingNameDay[]` | Get upcoming name days |
+| `getAllNameDays(year?)` | `number?` | `NameDayResult[]` | Get full dataset |
+| `transliterate(text)` | `string` | `string` | Auto-detect and transliterate (CYR↔LAT) |
+| `orthodoxEaster(year)` | `number` | `Date` | Calculate Orthodox Easter date |
+
+## Moveable Feasts
+
+Seven Bulgarian name days are tied to moveable Orthodox feasts (based on Easter):
+
+| Holiday | Offset | Example names |
+|---|---|---|
+| Тодоровден | Easter − 43 | Тодор, Теодор, Дора, Божидар |
+| Лазаровден | Easter − 8 | Лазар, Лъчезар |
+| Цветница | Easter − 7 | Цветан, Роза, Виолета, Маргарита, 100+ |
+| Великден | Easter | Велика, Велико, Паскал |
+| Спасовден | Easter + 39 | Спас, Спасена |
+| Петдесетница | Easter + 49 | Трайко, Траян |
+| Духов ден | Easter + 50 | Пламен |
+
+The library automatically computes the correct dates for any year using the Gauss algorithm for Orthodox Easter.
+
+## Transliteration
+
+Follows the official Bulgarian transliteration law (2009):
+
+| А | Б | В | Г | Д | Е | Ж | З | И | Й | К | Л | М | Н | О |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| A | B | V | G | D | E | Zh | Z | I | Y | K | L | M | N | O |
+
+| П | Р | С | Т | У | Ф | Х | Ц | Ч | Ш | Щ | Ъ | Ь | Ю | Я |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| P | R | S | T | U | F | H | Ts | Ch | Sh | Sht | A | Y | Yu | Ya |
+
+## Data Sources
+
+- Bulgarian Orthodox Church calendar
+- imeniden.com — comprehensive Bulgarian name day reference
+- Wikipedia: Именни дни в България
+- bg-patriarshia.bg — Patriarch's official calendar
+
+## Contributing Names
+
+Know a Bulgarian name that's missing? PRs welcome!
+
+1. Find the correct month file in `src/data/` (e.g., `may.js` for May names)
+2. Add your entry following the format in existing files
+3. Run `npm test` to verify data integrity
+4. Submit PR with source reference
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "bg-name-days",
+  "version": "2.0.0",
+  "description": "Bulgarian name days calendar library. Pure JavaScript, zero dependencies. 800+ names with variants, diminutives, Latin transliteration, and moveable Orthodox feast date computation.",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "scripts": {
+    "test": "node --test __tests__/*.test.js",
+    "validate": "node scripts/validateData.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "bulgarian",
+    "name-days",
+    "именни-дни",
+    "имен-ден",
+    "calendar",
+    "transliteration",
+    "bulgaria",
+    "orthodox",
+    "orthodox-easter"
+  ],
+  "author": "KinTales",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MariyanYordanov/kintales-name-days.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MariyanYordanov/kintales-name-days/issues"
+  },
+  "homepage": "https://github.com/MariyanYordanov/kintales-name-days#readme",
+  "files": [
+    "src/"
+  ]
+}

package/src/data/april.js

@@ -0,0 +1,135 @@
+/** @typedef {import('../types.js').NameDayEntry} NameDayEntry */
+
+/** @type {NameDayEntry[]} */
+export const april = [
+  {
+    name: "Мария",
+    variants: ["Мариан", "Мариана", "Мариела", "Маринела", "Маринка", "Марика", "Мара", "Марийка", "Мариета", "Марио", "Марин", "Марина"],
+    latin: ["Mariya", "Marian", "Mariana", "Mariela", "Marinela", "Marinka", "Marika", "Mara", "Mariyka", "Marieta", "Mario", "Marin", "Marina"],
+    month: 4, day: 1,
+    holiday: "Света Мария Египетска",
+    holidayLatin: "Sveta Mariya Egipetska",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Исидор",
+    variants: [],
+    latin: ["Isidor"],
+    month: 4, day: 4,
+    holiday: "Свети Исидор",
+    holidayLatin: "Sveti Isidor",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Теодул",
+    variants: [],
+    latin: ["Teodul"],
+    month: 4, day: 5,
+    holiday: "Свети Теодул",
+    holidayLatin: "Sveti Teodul",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Методи",
+    variants: ["Методий"],
+    latin: ["Metodi", "Metodiy"],
+    month: 4, day: 6,
+    holiday: "Свети Методий",
+    holidayLatin: "Sveti Metodiy",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Мартин",
+    variants: ["Мартина"],
+    latin: ["Martin", "Martina"],
+    month: 4, day: 14,
+    holiday: "Свети Мартин",
+    holidayLatin: "Sveti Martin",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Марко",
+    variants: ["Марк"],
+    latin: ["Marko", "Mark"],
+    month: 4, day: 25,
+    holiday: "Свети Марк",
+    holidayLatin: "Sveti Mark",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Симеон",
+    variants: ["Симо", "Симона"],
+    latin: ["Simeon", "Simo", "Simona"],
+    month: 4, day: 17,
+    holiday: "Свети Симеон",
+    holidayLatin: "Sveti Simeon",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Елисавета",
+    variants: ["Елиза"],
+    latin: ["Elisaveta", "Eliza"],
+    month: 4, day: 24,
+    holiday: "Света Елисавета",
+    holidayLatin: "Sveta Elisaveta",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Никита",
+    variants: [],
+    latin: ["Nikita"],
+    month: 4, day: 3,
+    holiday: "Свети Никита",
+    holidayLatin: "Sveti Nikita",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Терентий",
+    variants: [],
+    latin: ["Terentiy"],
+    month: 4, day: 10,
+    holiday: "Свети Терентий",
+    holidayLatin: "Sveti Terentiy",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Яков",
+    variants: ["Якоб"],
+    latin: ["Yakov", "Yakob"],
+    month: 4, day: 30,
+    holiday: "Свети Яков",
+    holidayLatin: "Sveti Yakov",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Теодосий",
+    variants: ["Тодосий", "Доси"],
+    latin: ["Teodosiy", "Todosiy", "Dosi"],
+    month: 4, day: 7,
+    holiday: "Свети Теодосий",
+    holidayLatin: "Sveti Teodosiy",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Ирина",
+    variants: ["Ирена", "Ира"],
+    latin: ["Irina", "Irena", "Ira"],
+    month: 4, day: 16,
+    holiday: "Света Ирина",
+    holidayLatin: "Sveta Irina",
+    tradition: "orthodox",
+    moveable: null,
+  },
+];

package/src/data/august.js

@@ -0,0 +1,175 @@
+/** @typedef {import('../types.js').NameDayEntry} NameDayEntry */
+
+/** @type {NameDayEntry[]} */
+export const august = [
+  {
+    name: "Макавей",
+    variants: [],
+    latin: ["Makavey"],
+    month: 8, day: 1,
+    holiday: "Свети Макавей",
+    holidayLatin: "Sveti Makavey",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Преслав",
+    variants: ["Преслава", "Спас", "Спаска", "Спасена", "Спасиян"],
+    latin: ["Preslav", "Preslava", "Spas", "Spaska", "Spasena", "Spasiyan"],
+    month: 8, day: 6,
+    holiday: "Преображение Господне",
+    holidayLatin: "Preobrazhenie Gospodne",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Дончо",
+    variants: ["Донка", "Доника"],
+    latin: ["Doncho", "Donka", "Donika"],
+    month: 8, day: 7,
+    holiday: "Свети Донат",
+    holidayLatin: "Sveti Donat",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Емил",
+    variants: ["Емилия", "Емилиян", "Емилиана"],
+    latin: ["Emil", "Emiliya", "Emiliyan", "Emiliana"],
+    month: 8, day: 8,
+    holiday: "Свети Емилиан",
+    holidayLatin: "Sveti Emilian",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Мария",
+    variants: ["Мариан", "Мариана", "Мариела", "Маринела", "Маринка", "Марика", "Мара", "Марийка", "Мариета", "Марио", "Богдана", "Божана"],
+    latin: ["Mariya", "Marian", "Mariana", "Mariela", "Marinela", "Marinka", "Marika", "Mara", "Mariyka", "Marieta", "Mario", "Bogdana", "Bozhana"],
+    month: 8, day: 15,
+    holiday: "Голяма Богородица",
+    holidayLatin: "Golyama Bogoroditsa",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Самуил",
+    variants: ["Самуила"],
+    latin: ["Samuil", "Samuila"],
+    month: 8, day: 20,
+    holiday: "Свети Самуил",
+    holidayLatin: "Sveti Samuil",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Адриан",
+    variants: ["Адриана", "Наталия", "Натали", "Наталка"],
+    latin: ["Adrian", "Adriana", "Nataliya", "Natali", "Natalka"],
+    month: 8, day: 26,
+    holiday: "Свети Адриан и Наталия",
+    holidayLatin: "Sveti Adrian i Nataliya",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Фани",
+    variants: ["Фанка"],
+    latin: ["Fani", "Fanka"],
+    month: 8, day: 27,
+    holiday: "Свети Фанурий",
+    holidayLatin: "Sveti Fanuriy",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Йоан",
+    variants: ["Йоана"],
+    latin: ["Yoan", "Yoana"],
+    month: 8, day: 28,
+    holiday: "Успение на Свети Йоан Кръстител",
+    holidayLatin: "Uspenie na Sveti Yoan Krastitel",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Александър",
+    variants: ["Александра", "Александрина", "Сашо", "Сашка", "Алекс", "Алексей", "Алеко"],
+    latin: ["Aleksandar", "Aleksandra", "Aleksandrina", "Sasho", "Sashka", "Aleks", "Aleksey", "Aleko"],
+    month: 8, day: 30,
+    holiday: "Свети Александър",
+    holidayLatin: "Sveti Aleksandar",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Илия",
+    variants: ["Илиян", "Илияна"],
+    latin: ["Iliya", "Iliyan", "Iliyana"],
+    month: 8, day: 2,
+    holiday: "Свети Илия (Илинден по стар стил)",
+    holidayLatin: "Sveti Iliya (Ilinden po star stil)",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Герман",
+    variants: ["Германа"],
+    latin: ["German", "Germana"],
+    month: 8, day: 9,
+    holiday: "Свети Герман",
+    holidayLatin: "Sveti German",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Евтихий",
+    variants: [],
+    latin: ["Evtihiy"],
+    month: 8, day: 24,
+    holiday: "Свети Евтихий",
+    holidayLatin: "Sveti Evtihiy",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Лаврентий",
+    variants: ["Лаврен"],
+    latin: ["Lavrentiy", "Lavren"],
+    month: 8, day: 10,
+    holiday: "Свети Лаврентий",
+    holidayLatin: "Sveti Lavrentiy",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Диомид",
+    variants: [],
+    latin: ["Diomid"],
+    month: 8, day: 16,
+    holiday: "Свети Диомид",
+    holidayLatin: "Sveti Diomid",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Исак",
+    variants: [],
+    latin: ["Isak"],
+    month: 8, day: 3,
+    holiday: "Свети Исаак",
+    holidayLatin: "Sveti Isaak",
+    tradition: "orthodox",
+    moveable: null,
+  },
+  {
+    name: "Флора",
+    variants: ["Флорентина", "Лавър"],
+    latin: ["Flora", "Florentina", "Lavar"],
+    month: 8, day: 18,
+    holiday: "Свети Флор и Лавър",
+    holidayLatin: "Sveti Flor i Lavar",
+    tradition: "orthodox",
+    moveable: null,
+  },
+];