jours-feries-france/README.md

Bibliothèque pour gérer les jours fériés en France

# jours-feries-france

Bibliothèque JavaScript/TypeScript pour gérer les jours fériés en France.

## Installation

```bash
npm install jours-feries-france
```

## Utilisation

```typescript
import { estJourFerie, isHoliday, getJourFerie, getJoursFeriesAnnee } from 'jours-feries-france';

// Vérifier si une date est un jour férié (avec logs)
console.log(estJourFerie('2025-05-01')); // true
console.log(estJourFerie('01/05/2025')); // true (format français)
console.log(estJourFerie(new Date('2025-05-01'))); // true

// Vérifier si une date est un jour férié (sans logs)
console.log(isHoliday('2025-12-25')); // true
console.log(isHoliday('14/07/2025')); // true
console.log(isHoliday(new Date(2025, 0, 1))); // true

// Obtenir les informations d'un jour férié
const jourFerie = getJourFerie('2025-05-01');
console.log(jourFerie);
// {
//   date: 2025-05-01T00:00:00.000Z,
//   nom: 'Fête du Travail',
//   isRegional: false
// }

// Obtenir tous les jours fériés d'une année
const joursFeries = getJoursFeriesAnnee(2025);
console.log(joursFeries);
// [
//   { date: '2025-01-01', nom: "Jour de l'an", isRegional: false },
//   { date: '2025-04-21', nom: 'Lundi de Pâques', isRegional: false },
//   ...
// ]

// Inclure les jours fériés régionaux (Alsace-Moselle)
const joursRegionaux = getJoursFeriesAnnee(2025, { 
  includeRegional: true, 
  region: 'Alsace-Moselle' 
});
```

## Fonctionnalités

- Supporte les formats de date ISO (YYYY-MM-DD) et français (DD/MM/YYYY)
- Supporte les objets JavaScript Date
- Gère les jours fériés fixes et mobiles
- Supporte les jours fériés spécifiques à l'Alsace-Moselle
- Entièrement typé avec TypeScript
- Zéro dépendance
- Option pour vérifier les jours fériés sans logs de debug

## Jours fériés supportés

### Jours fériés nationaux
- 1er janvier - Jour de l'an
- Lundi de Pâques (mobile)
- 1er mai - Fête du Travail
- 8 mai - Victoire 1945
- Ascension (mobile)
- Lundi de Pentecôte (mobile)
- 14 juillet - Fête nationale
- 15 août - Assomption
- 1er novembre - Toussaint
- 11 novembre - Armistice
- 25 décembre - Noël

### Jours fériés Alsace-Moselle
- Vendredi Saint (mobile)
- 26 décembre - Saint-Étienne

## Licence

MIT