calendary

const calendary: CalendaryFn

Factory function with generics support

Template

TMetadata

Custom metadata type for events

Template

TCategory

Category type for events

Example

// Default usage
const cal = calendary();

// With typed metadata
interface LiturgicalMetadata { rank: string; vestmentColor: string; }
const cal = calendary<LiturgicalMetadata>();
const day = cal.getDay("2025-12-25");
day.events[0].metadata?.rank; // TypeScript knows this exists

// With typed metadata and categories
type LiturgicalCategory = "solemnity" | "feast" | "memorial";
const cal = calendary<LiturgicalMetadata, LiturgicalCategory>();