@forcecalendar/core 2.1.70 → 2.3.0

package/types/types.d.ts

@@ -0,0 +1,1225 @@
+/**
+ * Type definitions for Lightning Calendar Core
+ * @module types
+ */
+export type EventData = {
+    /**
+     * - Unique identifier for the event
+     */
+    id: string;
+    /**
+     * - Event title
+     */
+    title: string;
+    /**
+     * - Start date/time of the event
+     */
+    start: Date | string;
+    /**
+     * - End date/time of the event
+     */
+    end?: Date | string;
+    /**
+     * - Whether this is an all-day event
+     */
+    allDay?: boolean;
+    /**
+     * - Event description
+     */
+    description?: string;
+    /**
+     * - Event location
+     */
+    location?: string;
+    /**
+     * - Event color (applies to all color properties if set)
+     */
+    color?: string;
+    /**
+     * - Background color for the event
+     */
+    backgroundColor?: string;
+    /**
+     * - Border color for the event
+     */
+    borderColor?: string;
+    /**
+     * - Text color for the event
+     */
+    textColor?: string;
+    /**
+     * - Whether this is a recurring event
+     */
+    recurring?: boolean;
+    /**
+     * - Recurrence rule (RRULE string or object)
+     */
+    recurrenceRule?: RecurrenceRule | string;
+    /**
+     * - IANA timezone for the event
+     */
+    timeZone?: string;
+    /**
+     * - IANA timezone for the event end (cross-timezone events)
+     */
+    endTimeZone?: string;
+    /**
+     * - Backward-compatible alias for recurrenceRule
+     */
+    recurrence?: RecurrenceRule | string;
+    /**
+     * - Single category (alias for a one-element categories array)
+     */
+    category?: string;
+    /**
+     * - Event status
+     */
+    status?: EventStatus;
+    /**
+     * - Event visibility
+     */
+    visibility?: EventVisibility;
+    /**
+     * - Event organizer
+     */
+    organizer?: Organizer;
+    /**
+     * - Event attendees
+     */
+    attendees?: Attendee[];
+    /**
+     * - Event reminders
+     */
+    reminders?: Reminder[];
+    /**
+     * - Event categories/tags
+     */
+    categories?: string[];
+    /**
+     * - Event attachments
+     */
+    attachments?: Attachment[];
+    /**
+     * - Virtual meeting information
+     */
+    conferenceData?: ConferenceData;
+    /**
+     * - Custom metadata for extensibility
+     */
+    metadata?: Record<string, any>;
+};
+export type EventStatus = ('confirmed' | 'tentative' | 'cancelled');
+export type EventVisibility = ('public' | 'private' | 'confidential');
+export type AttendeeResponseStatus = ('needs-action' | 'accepted' | 'declined' | 'tentative' | 'delegated');
+export type AttendeeRole = ('required' | 'optional' | 'resource');
+export type ReminderMethod = ('email' | 'popup' | 'sms');
+export type Organizer = {
+    /**
+     * - Unique identifier for the organizer
+     */
+    id?: string;
+    /**
+     * - Organizer's name
+     */
+    name: string;
+    /**
+     * - Organizer's email
+     */
+    email: string;
+    /**
+     * - Organizer's phone number
+     */
+    phoneNumber?: string;
+    /**
+     * - URL to organizer's photo
+     */
+    photoUrl?: string;
+};
+export type Attendee = {
+    /**
+     * - Unique identifier for the attendee
+     */
+    id?: string;
+    /**
+     * - Attendee's name
+     */
+    name: string;
+    /**
+     * - Attendee's email
+     */
+    email: string;
+    /**
+     * - Attendee's phone number
+     */
+    phoneNumber?: string;
+    /**
+     * - URL to attendee's photo
+     */
+    photoUrl?: string;
+    /**
+     * - Response status
+     */
+    responseStatus?: AttendeeResponseStatus;
+    /**
+     * - Attendee role
+     */
+    role?: AttendeeRole;
+    /**
+     * - Whether attendance is optional
+     */
+    optional?: boolean;
+    /**
+     * - Whether attendee is a resource (room, equipment)
+     */
+    resource?: boolean;
+    /**
+     * - Attendee's comment or note
+     */
+    comment?: string;
+    /**
+     * - When the attendee responded
+     */
+    responseTime?: Date;
+};
+export type Reminder = {
+    /**
+     * - Unique identifier for the reminder
+     */
+    id?: string;
+    /**
+     * - Reminder method
+     */
+    method: ReminderMethod;
+    /**
+     * - Minutes before event to trigger reminder
+     */
+    minutesBefore: number;
+    /**
+     * - Custom reminder message
+     */
+    message?: string;
+    /**
+     * - Whether reminder is active
+     */
+    enabled?: boolean;
+};
+export type Attachment = {
+    /**
+     * - Unique identifier for the attachment
+     */
+    id?: string;
+    /**
+     * - File name
+     */
+    fileName: string;
+    /**
+     * - URL to the file
+     */
+    fileUrl?: string;
+    /**
+     * - MIME type of the file
+     */
+    mimeType?: string;
+    /**
+     * - File size in bytes
+     */
+    size?: number;
+    /**
+     * - URL to file type icon
+     */
+    iconUrl?: string;
+};
+export type ConferenceData = {
+    /**
+     * - Unique identifier for the conference
+     */
+    id?: string;
+    /**
+     * - Conference solution (e.g., 'zoom', 'teams', 'meet')
+     */
+    solution?: string;
+    /**
+     * - Conference URL
+     */
+    url?: string;
+    /**
+     * - Conference phone number
+     */
+    phone?: string;
+    /**
+     * - Access code or meeting ID
+     */
+    accessCode?: string;
+    /**
+     * - Meeting password
+     */
+    password?: string;
+    /**
+     * - Additional conference notes
+     */
+    notes?: string;
+};
+export type RecurrenceRule = {
+    /**
+     * - Frequency of recurrence
+     */
+    freq: ('DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY');
+    /**
+     * - Interval between occurrences
+     */
+    interval?: number;
+    /**
+     * - Number of occurrences
+     */
+    count?: number;
+    /**
+     * - End date for recurrence
+     */
+    until?: Date;
+    /**
+     * - Days of week (MO, TU, WE, TH, FR, SA, SU)
+     */
+    byDay?: string[];
+    /**
+     * - Days of month (1-31)
+     */
+    byMonthDay?: number[];
+    /**
+     * - Months (1-12)
+     */
+    byMonth?: number[];
+    /**
+     * - Position in set (-1 for last)
+     */
+    bySetPos?: number[];
+    /**
+     * - Exception dates to exclude
+     */
+    exceptions?: Date[];
+};
+export type CalendarConfig = {
+    /**
+     * - Initial view type
+     */
+    view?: ViewType;
+    /**
+     * - Initial date to display
+     */
+    date?: Date;
+    /**
+     * - Day week starts on (0=Sunday, 6=Saturday)
+     */
+    weekStartsOn?: number;
+    /**
+     * - Locale for formatting
+     */
+    locale?: string;
+    /**
+     * - IANA timezone
+     */
+    timeZone?: string;
+    /**
+     * - Show week numbers
+     */
+    showWeekNumbers?: boolean;
+    /**
+     * - Show weekend days
+     */
+    showWeekends?: boolean;
+    /**
+     * - Always show 6 weeks in month view
+     */
+    fixedWeekCount?: boolean;
+    /**
+     * - Business hours configuration
+     */
+    businessHours?: BusinessHours;
+    /**
+     * - Initial events to load
+     */
+    events?: EventData[];
+};
+export type ViewType = ('month' | 'week' | 'day' | 'list');
+export type BusinessHours = {
+    /**
+     * - Start time (HH:MM format)
+     */
+    start: string;
+    /**
+     * - End time (HH:MM format)
+     */
+    end: string;
+};
+export type ViewData = {
+    /**
+     * - Type of view
+     */
+    type: ViewType;
+    /**
+     * - Start date of the view
+     */
+    startDate?: Date;
+    /**
+     * - End date of the view
+     */
+    endDate?: Date;
+};
+export type MonthViewData = {
+    /**
+     * - Always 'month'
+     */
+    type: ViewType;
+    /**
+     * - Year being displayed
+     */
+    year: number;
+    /**
+     * - Month being displayed (0-11)
+     */
+    month: number;
+    /**
+     * - Localized month name
+     */
+    monthName: string;
+    /**
+     * - Array of weeks in the month
+     */
+    weeks: WeekData[];
+    /**
+     * - First date in the view
+     */
+    startDate: Date;
+    /**
+     * - Last date in the view
+     */
+    endDate: Date;
+};
+export type WeekData = {
+    /**
+     * - Week number in the year
+     */
+    weekNumber: number;
+    /**
+     * - Array of days in the week
+     */
+    days: DayData[];
+};
+export type DayData = {
+    /**
+     * - Date object for the day
+     */
+    date: Date;
+    /**
+     * - Day of the month (1-31)
+     */
+    dayOfMonth: number;
+    /**
+     * - Whether this day is in the current month
+     */
+    isCurrentMonth: boolean;
+    /**
+     * - Whether this is today
+     */
+    isToday: boolean;
+    /**
+     * - Whether this is a weekend day
+     */
+    isWeekend: boolean;
+    /**
+     * - Events for this day
+     */
+    events: import('./events/Event.js').Event[];
+};
+export type WeekViewData = {
+    /**
+     * - Always 'week'
+     */
+    type: ViewType;
+    /**
+     * - Week number in the year
+     */
+    weekNumber: number;
+    /**
+     * - First day of the week
+     */
+    startDate: Date;
+    /**
+     * - Last day of the week
+     */
+    endDate: Date;
+    /**
+     * - Array of days with detailed event data
+     */
+    days: WeekDayData[];
+};
+export type WeekDayData = {
+    /**
+     * - Date object for the day
+     */
+    date: Date;
+    /**
+     * - Day of week (0-6)
+     */
+    dayOfWeek: number;
+    /**
+     * - Localized day name
+     */
+    dayName: string;
+    /**
+     * - Whether this is today
+     */
+    isToday: boolean;
+    /**
+     * - Whether this is a weekend day
+     */
+    isWeekend: boolean;
+    /**
+     * - All events for this day
+     */
+    events: import('./events/Event.js').Event[];
+    /**
+     * - Groups of overlapping events
+     */
+    overlapGroups: Array<import('./events/Event.js').Event[]>;
+    /**
+     * - Function to calculate positions
+     */
+    getEventPositions: (events: import('./events/Event.js').Event[]) => Map<string, EventPosition>;
+};
+export type EventPosition = {
+    /**
+     * - Column index for rendering
+     */
+    column: number;
+    /**
+     * - Total number of columns
+     */
+    totalColumns: number;
+};
+export type DayViewData = {
+    /**
+     * - Always 'day'
+     */
+    type: ViewType;
+    /**
+     * - Date being displayed
+     */
+    date: Date;
+    /**
+     * - Localized day name
+     */
+    dayName: string;
+    /**
+     * - Whether this is today
+     */
+    isToday: boolean;
+    /**
+     * - All-day events
+     */
+    allDayEvents: import('./events/Event.js').Event[];
+    /**
+     * - Hourly time slots
+     */
+    hours: HourSlot[];
+};
+export type HourSlot = {
+    /**
+     * - Hour (0-23)
+     */
+    hour: number;
+    /**
+     * - Formatted time string
+     */
+    time: string;
+    /**
+     * - Events in this hour
+     */
+    events: import('./events/Event.js').Event[];
+};
+export type ListViewData = {
+    /**
+     * - Always 'list'
+     */
+    type: ViewType;
+    /**
+     * - Start of the list range
+     */
+    startDate: Date;
+    /**
+     * - End of the list range
+     */
+    endDate: Date;
+    /**
+     * - Days with events
+     */
+    days: ListDayData[];
+    /**
+     * - Total event count
+     */
+    totalEvents: number;
+};
+export type ListDayData = {
+    /**
+     * - Date object
+     */
+    date: Date;
+    /**
+     * - Localized day name
+     */
+    dayName: string;
+    /**
+     * - Whether this is today
+     */
+    isToday: boolean;
+    /**
+     * - Events for this day
+     */
+    events: import('./events/Event.js').Event[];
+};
+export type CalendarState = {
+    /**
+     * - Current view type
+     */
+    view: ViewType;
+    /**
+     * - Currently displayed date
+     */
+    currentDate: Date;
+    /**
+     * - Selected event ID
+     */
+    selectedEventId: string | null;
+    /**
+     * - Selected date
+     */
+    selectedDate: Date | null;
+    /**
+     * - Hovered event ID
+     */
+    hoveredEventId: string | null;
+    /**
+     * - Hovered date
+     */
+    hoveredDate: Date | null;
+    /**
+     * - Week start day
+     */
+    weekStartsOn: number;
+    /**
+     * - Show week numbers
+     */
+    showWeekNumbers: boolean;
+    /**
+     * - Show weekends
+     */
+    showWeekends: boolean;
+    /**
+     * - Fixed week count in month view
+     */
+    fixedWeekCount: boolean;
+    /**
+     * - IANA timezone
+     */
+    timeZone: string;
+    /**
+     * - Locale string
+     */
+    locale: string;
+    /**
+     * - Hour format
+     */
+    hourFormat: ('12h' | '24h');
+    /**
+     * - Business hours
+     */
+    businessHours: BusinessHours;
+    /**
+     * - Active filters
+     */
+    filters: FilterState;
+    /**
+     * - Dragging state
+     */
+    isDragging: boolean;
+    /**
+     * - Resizing state
+     */
+    isResizing: boolean;
+    /**
+     * - Creating state
+     */
+    isCreating: boolean;
+    /**
+     * - Loading state
+     */
+    isLoading: boolean;
+    /**
+     * - Loading message
+     */
+    loadingMessage: string;
+    /**
+     * - Error message
+     */
+    error: string | null;
+    /**
+     * - Custom metadata
+     */
+    metadata: Record<string, any>;
+};
+export type FilterState = {
+    /**
+     * - Search term
+     */
+    searchTerm: string;
+    /**
+     * - Selected categories
+     */
+    categories: string[];
+    /**
+     * - Show all-day events
+     */
+    showAllDay: boolean;
+    /**
+     * - Show timed events
+     */
+    showTimed: boolean;
+};
+export type EventStoreChange = {
+    /**
+     * - Type of change
+     */
+    type: ('add' | 'update' | 'remove' | 'clear');
+    /**
+     * - Affected event
+     */
+    event?: import('./events/Event.js').Event;
+    /**
+     * - Previous event state (for updates)
+     */
+    oldEvent?: import('./events/Event.js').Event;
+    /**
+     * - Previous events (for clear)
+     */
+    oldEvents?: import('./events/Event.js').Event[];
+    /**
+     * - Store version number
+     */
+    version: number;
+};
+export type QueryFilters = {
+    /**
+     * - Start date for range query
+     */
+    start?: Date;
+    /**
+     * - End date for range query
+     */
+    end?: Date;
+    /**
+     * - Specific date to query
+     */
+    date?: Date;
+    /**
+     * - Month (0-11)
+     */
+    month?: number;
+    /**
+     * - Year
+     */
+    year?: number;
+    /**
+     * - Filter by all-day events
+     */
+    allDay?: boolean;
+    /**
+     * - Filter by recurring events
+     */
+    recurring?: boolean;
+    /**
+     * - Filter by event status
+     */
+    status?: EventStatus;
+    /**
+     * - Filter by categories
+     */
+    categories?: string[];
+    /**
+     * - Whether to match all categories (AND) or any (OR)
+     */
+    matchAllCategories?: boolean;
+    /**
+     * - Filter by events with/without attendees
+     */
+    hasAttendees?: boolean;
+    /**
+     * - Filter by organizer email
+     */
+    organizerEmail?: string;
+    /**
+     * - Sort field
+     */
+    sort?: ('start' | 'end' | 'duration' | 'title');
+};
+export type EventOccurrence = {
+    /**
+     * - Occurrence start date
+     */
+    start: Date;
+    /**
+     * - Occurrence end date
+     */
+    end: Date;
+    /**
+     * - ID of the parent recurring event
+     */
+    recurringEventId: string;
+};
+export type CalendarPlugin = {
+    /**
+     * - Installation function
+     */
+    install: (calendar: import('./calendar/Calendar.js').Calendar) => void;
+    /**
+     * - Cleanup function
+     */
+    uninstall?: (calendar: import('./calendar/Calendar.js').Calendar) => void;
+};
+export type EventListener = (payload: any) => void;
+export type UnsubscribeFn = () => void;
+export type ConflictType = ('time' | 'attendee' | 'resource' | 'location');
+export type ConflictSeverity = ('critical' | 'high' | 'medium' | 'low');
+export type ConflictDetails = {
+    /**
+     * - Unique identifier for the conflict
+     */
+    id: string;
+    /**
+     * - Type of conflict
+     */
+    type: ConflictType;
+    /**
+     * - Severity level
+     */
+    severity: ConflictSeverity;
+    /**
+     * - ID of the event with conflict
+     */
+    eventId: string;
+    /**
+     * - ID of the conflicting event
+     */
+    conflictingEventId: string;
+    /**
+     * - Human-readable description
+     */
+    description: string;
+    /**
+     * - Start of overlap period
+     */
+    overlapStart?: Date;
+    /**
+     * - End of overlap period
+     */
+    overlapEnd?: Date;
+    /**
+     * - Duration of overlap in minutes
+     */
+    overlapMinutes?: number;
+    /**
+     * - Email addresses of conflicting attendees
+     */
+    conflictingAttendees?: string[];
+    /**
+     * - Resource that has conflict
+     */
+    conflictingResource?: string;
+    /**
+     * - Additional conflict information
+     */
+    metadata?: Record<string, any>;
+};
+export type ConflictCheckOptions = {
+    /**
+     * - Check for attendee conflicts
+     */
+    checkAttendees?: boolean;
+    /**
+     * - Check for resource conflicts
+     */
+    checkResources?: boolean;
+    /**
+     * - Check for location conflicts
+     */
+    checkLocation?: boolean;
+    /**
+     * - Ignore all-day events in conflict check
+     */
+    ignoreAllDay?: boolean;
+    /**
+     * - Event IDs to exclude from check
+     */
+    excludeEventIds?: string[];
+    /**
+     * - Event statuses to include
+     */
+    includeStatuses?: EventStatus[];
+    /**
+     * - Buffer time between events in minutes
+     */
+    bufferMinutes?: number;
+};
+export type ConflictSummary = {
+    /**
+     * - Whether any conflicts exist
+     */
+    hasConflicts: boolean;
+    /**
+     * - Total number of conflicts
+     */
+    totalConflicts: number;
+    /**
+     * - Array of conflict details
+     */
+    conflicts: ConflictDetails[];
+    /**
+     * - Count by type
+     */
+    conflictsByType: any;
+    /**
+     * - Count by severity
+     */
+    conflictsBySeverity: any;
+    /**
+     * - All event IDs involved
+     */
+    affectedEventIds: string[];
+    /**
+     * - All attendee emails involved
+     */
+    affectedAttendees: string[];
+};
+/**
+ * @typedef {Object} EventData
+ * @property {string} id - Unique identifier for the event
+ * @property {string} title - Event title
+ * @property {Date|string} start - Start date/time of the event
+ * @property {Date|string} [end] - End date/time of the event
+ * @property {boolean} [allDay=false] - Whether this is an all-day event
+ * @property {string} [description=''] - Event description
+ * @property {string} [location=''] - Event location
+ * @property {string} [color=null] - Event color (applies to all color properties if set)
+ * @property {string} [backgroundColor=null] - Background color for the event
+ * @property {string} [borderColor=null] - Border color for the event
+ * @property {string} [textColor=null] - Text color for the event
+ * @property {boolean} [recurring=false] - Whether this is a recurring event
+ * @property {RecurrenceRule|string} [recurrenceRule=null] - Recurrence rule (RRULE string or object)
+ * @property {string} [timeZone=null] - IANA timezone for the event
+ * @property {string} [endTimeZone=null] - IANA timezone for the event end (cross-timezone events)
+ * @property {RecurrenceRule|string} [recurrence=null] - Backward-compatible alias for recurrenceRule
+ * @property {string} [category=null] - Single category (alias for a one-element categories array)
+ * @property {EventStatus} [status='confirmed'] - Event status
+ * @property {EventVisibility} [visibility='public'] - Event visibility
+ * @property {Organizer} [organizer=null] - Event organizer
+ * @property {Attendee[]} [attendees=[]] - Event attendees
+ * @property {Reminder[]} [reminders=[]] - Event reminders
+ * @property {string[]} [categories=[]] - Event categories/tags
+ * @property {Attachment[]} [attachments=[]] - Event attachments
+ * @property {ConferenceData} [conferenceData=null] - Virtual meeting information
+ * @property {Object.<string, any>} [metadata={}] - Custom metadata for extensibility
+ */
+/**
+ * @typedef {('confirmed'|'tentative'|'cancelled')} EventStatus
+ */
+/**
+ * @typedef {('public'|'private'|'confidential')} EventVisibility
+ */
+/**
+ * @typedef {('needs-action'|'accepted'|'declined'|'tentative'|'delegated')} AttendeeResponseStatus
+ */
+/**
+ * @typedef {('required'|'optional'|'resource')} AttendeeRole
+ */
+/**
+ * @typedef {('email'|'popup'|'sms')} ReminderMethod
+ */
+/**
+ * @typedef {Object} Organizer
+ * @property {string} [id] - Unique identifier for the organizer
+ * @property {string} name - Organizer's name
+ * @property {string} email - Organizer's email
+ * @property {string} [phoneNumber] - Organizer's phone number
+ * @property {string} [photoUrl] - URL to organizer's photo
+ */
+/**
+ * @typedef {Object} Attendee
+ * @property {string} [id] - Unique identifier for the attendee
+ * @property {string} name - Attendee's name
+ * @property {string} email - Attendee's email
+ * @property {string} [phoneNumber] - Attendee's phone number
+ * @property {string} [photoUrl] - URL to attendee's photo
+ * @property {AttendeeResponseStatus} [responseStatus='needs-action'] - Response status
+ * @property {AttendeeRole} [role='required'] - Attendee role
+ * @property {boolean} [optional=false] - Whether attendance is optional
+ * @property {boolean} [resource=false] - Whether attendee is a resource (room, equipment)
+ * @property {string} [comment] - Attendee's comment or note
+ * @property {Date} [responseTime] - When the attendee responded
+ */
+/**
+ * @typedef {Object} Reminder
+ * @property {string} [id] - Unique identifier for the reminder
+ * @property {ReminderMethod} method - Reminder method
+ * @property {number} minutesBefore - Minutes before event to trigger reminder
+ * @property {string} [message] - Custom reminder message
+ * @property {boolean} [enabled=true] - Whether reminder is active
+ */
+/**
+ * @typedef {Object} Attachment
+ * @property {string} [id] - Unique identifier for the attachment
+ * @property {string} fileName - File name
+ * @property {string} [fileUrl] - URL to the file
+ * @property {string} [mimeType] - MIME type of the file
+ * @property {number} [size] - File size in bytes
+ * @property {string} [iconUrl] - URL to file type icon
+ */
+/**
+ * @typedef {Object} ConferenceData
+ * @property {string} [id] - Unique identifier for the conference
+ * @property {string} [solution] - Conference solution (e.g., 'zoom', 'teams', 'meet')
+ * @property {string} [url] - Conference URL
+ * @property {string} [phone] - Conference phone number
+ * @property {string} [accessCode] - Access code or meeting ID
+ * @property {string} [password] - Meeting password
+ * @property {string} [notes] - Additional conference notes
+ */
+/**
+ * @typedef {Object} RecurrenceRule
+ * @property {('DAILY'|'WEEKLY'|'MONTHLY'|'YEARLY')} freq - Frequency of recurrence
+ * @property {number} [interval=1] - Interval between occurrences
+ * @property {number} [count=null] - Number of occurrences
+ * @property {Date} [until=null] - End date for recurrence
+ * @property {string[]} [byDay=[]] - Days of week (MO, TU, WE, TH, FR, SA, SU)
+ * @property {number[]} [byMonthDay=[]] - Days of month (1-31)
+ * @property {number[]} [byMonth=[]] - Months (1-12)
+ * @property {number[]} [bySetPos=[]] - Position in set (-1 for last)
+ * @property {Date[]} [exceptions=[]] - Exception dates to exclude
+ */
+/**
+ * @typedef {Object} CalendarConfig
+ * @property {ViewType} [view='month'] - Initial view type
+ * @property {Date} [date=new Date()] - Initial date to display
+ * @property {number} [weekStartsOn=0] - Day week starts on (0=Sunday, 6=Saturday)
+ * @property {string} [locale='en-US'] - Locale for formatting
+ * @property {string} [timeZone] - IANA timezone
+ * @property {boolean} [showWeekNumbers=false] - Show week numbers
+ * @property {boolean} [showWeekends=true] - Show weekend days
+ * @property {boolean} [fixedWeekCount=true] - Always show 6 weeks in month view
+ * @property {BusinessHours} [businessHours] - Business hours configuration
+ * @property {EventData[]} [events=[]] - Initial events to load
+ */
+/**
+ * @typedef {('month'|'week'|'day'|'list')} ViewType
+ */
+/**
+ * @typedef {Object} BusinessHours
+ * @property {string} start - Start time (HH:MM format)
+ * @property {string} end - End time (HH:MM format)
+ */
+/**
+ * @typedef {Object} ViewData
+ * @property {ViewType} type - Type of view
+ * @property {Date} [startDate] - Start date of the view
+ * @property {Date} [endDate] - End date of the view
+ */
+/**
+ * @typedef {Object} MonthViewData
+ * @property {ViewType} type - Always 'month'
+ * @property {number} year - Year being displayed
+ * @property {number} month - Month being displayed (0-11)
+ * @property {string} monthName - Localized month name
+ * @property {WeekData[]} weeks - Array of weeks in the month
+ * @property {Date} startDate - First date in the view
+ * @property {Date} endDate - Last date in the view
+ */
+/**
+ * @typedef {Object} WeekData
+ * @property {number} weekNumber - Week number in the year
+ * @property {DayData[]} days - Array of days in the week
+ */
+/**
+ * @typedef {Object} DayData
+ * @property {Date} date - Date object for the day
+ * @property {number} dayOfMonth - Day of the month (1-31)
+ * @property {boolean} isCurrentMonth - Whether this day is in the current month
+ * @property {boolean} isToday - Whether this is today
+ * @property {boolean} isWeekend - Whether this is a weekend day
+ * @property {import('./events/Event.js').Event[]} events - Events for this day
+ */
+/**
+ * @typedef {Object} WeekViewData
+ * @property {ViewType} type - Always 'week'
+ * @property {number} weekNumber - Week number in the year
+ * @property {Date} startDate - First day of the week
+ * @property {Date} endDate - Last day of the week
+ * @property {WeekDayData[]} days - Array of days with detailed event data
+ */
+/**
+ * @typedef {Object} WeekDayData
+ * @property {Date} date - Date object for the day
+ * @property {number} dayOfWeek - Day of week (0-6)
+ * @property {string} dayName - Localized day name
+ * @property {boolean} isToday - Whether this is today
+ * @property {boolean} isWeekend - Whether this is a weekend day
+ * @property {import('./events/Event.js').Event[]} events - All events for this day
+ * @property {Array<import('./events/Event.js').Event[]>} overlapGroups - Groups of overlapping events
+ * @property {(events: import('./events/Event.js').Event[]) => Map<string, EventPosition>} getEventPositions - Function to calculate positions
+ */
+/**
+ * @typedef {Object} EventPosition
+ * @property {number} column - Column index for rendering
+ * @property {number} totalColumns - Total number of columns
+ */
+/**
+ * @typedef {Object} DayViewData
+ * @property {ViewType} type - Always 'day'
+ * @property {Date} date - Date being displayed
+ * @property {string} dayName - Localized day name
+ * @property {boolean} isToday - Whether this is today
+ * @property {import('./events/Event.js').Event[]} allDayEvents - All-day events
+ * @property {HourSlot[]} hours - Hourly time slots
+ */
+/**
+ * @typedef {Object} HourSlot
+ * @property {number} hour - Hour (0-23)
+ * @property {string} time - Formatted time string
+ * @property {import('./events/Event.js').Event[]} events - Events in this hour
+ */
+/**
+ * @typedef {Object} ListViewData
+ * @property {ViewType} type - Always 'list'
+ * @property {Date} startDate - Start of the list range
+ * @property {Date} endDate - End of the list range
+ * @property {ListDayData[]} days - Days with events
+ * @property {number} totalEvents - Total event count
+ */
+/**
+ * @typedef {Object} ListDayData
+ * @property {Date} date - Date object
+ * @property {string} dayName - Localized day name
+ * @property {boolean} isToday - Whether this is today
+ * @property {import('./events/Event.js').Event[]} events - Events for this day
+ */
+/**
+ * @typedef {Object} CalendarState
+ * @property {ViewType} view - Current view type
+ * @property {Date} currentDate - Currently displayed date
+ * @property {string|null} selectedEventId - Selected event ID
+ * @property {Date|null} selectedDate - Selected date
+ * @property {string|null} hoveredEventId - Hovered event ID
+ * @property {Date|null} hoveredDate - Hovered date
+ * @property {number} weekStartsOn - Week start day
+ * @property {boolean} showWeekNumbers - Show week numbers
+ * @property {boolean} showWeekends - Show weekends
+ * @property {boolean} fixedWeekCount - Fixed week count in month view
+ * @property {string} timeZone - IANA timezone
+ * @property {string} locale - Locale string
+ * @property {('12h'|'24h')} hourFormat - Hour format
+ * @property {BusinessHours} businessHours - Business hours
+ * @property {FilterState} filters - Active filters
+ * @property {boolean} isDragging - Dragging state
+ * @property {boolean} isResizing - Resizing state
+ * @property {boolean} isCreating - Creating state
+ * @property {boolean} isLoading - Loading state
+ * @property {string} loadingMessage - Loading message
+ * @property {string|null} error - Error message
+ * @property {Object.<string, any>} metadata - Custom metadata
+ */
+/**
+ * @typedef {Object} FilterState
+ * @property {string} searchTerm - Search term
+ * @property {string[]} categories - Selected categories
+ * @property {boolean} showAllDay - Show all-day events
+ * @property {boolean} showTimed - Show timed events
+ */
+/**
+ * @typedef {Object} EventStoreChange
+ * @property {('add'|'update'|'remove'|'clear')} type - Type of change
+ * @property {import('./events/Event.js').Event} [event] - Affected event
+ * @property {import('./events/Event.js').Event} [oldEvent] - Previous event state (for updates)
+ * @property {import('./events/Event.js').Event[]} [oldEvents] - Previous events (for clear)
+ * @property {number} version - Store version number
+ */
+/**
+ * @typedef {Object} QueryFilters
+ * @property {Date} [start] - Start date for range query
+ * @property {Date} [end] - End date for range query
+ * @property {Date} [date] - Specific date to query
+ * @property {number} [month] - Month (0-11)
+ * @property {number} [year] - Year
+ * @property {boolean} [allDay] - Filter by all-day events
+ * @property {boolean} [recurring] - Filter by recurring events
+ * @property {EventStatus} [status] - Filter by event status
+ * @property {string[]} [categories] - Filter by categories
+ * @property {boolean} [matchAllCategories=false] - Whether to match all categories (AND) or any (OR)
+ * @property {boolean} [hasAttendees] - Filter by events with/without attendees
+ * @property {string} [organizerEmail] - Filter by organizer email
+ * @property {('start'|'end'|'duration'|'title')} [sort] - Sort field
+ */
+/**
+ * @typedef {Object} EventOccurrence
+ * @property {Date} start - Occurrence start date
+ * @property {Date} end - Occurrence end date
+ * @property {string} recurringEventId - ID of the parent recurring event
+ */
+/**
+ * @typedef {Object} CalendarPlugin
+ * @property {(calendar: import('./calendar/Calendar.js').Calendar) => void} install - Installation function
+ * @property {(calendar: import('./calendar/Calendar.js').Calendar) => void} [uninstall] - Cleanup function
+ */
+/**
+ * @typedef {(payload: any) => void} EventListener
+ */
+/**
+ * @typedef {() => void} UnsubscribeFn
+ */
+/**
+ * @typedef {('time'|'attendee'|'resource'|'location')} ConflictType
+ */
+/**
+ * @typedef {('critical'|'high'|'medium'|'low')} ConflictSeverity
+ */
+/**
+ * @typedef {Object} ConflictDetails
+ * @property {string} id - Unique identifier for the conflict
+ * @property {ConflictType} type - Type of conflict
+ * @property {ConflictSeverity} severity - Severity level
+ * @property {string} eventId - ID of the event with conflict
+ * @property {string} conflictingEventId - ID of the conflicting event
+ * @property {string} description - Human-readable description
+ * @property {Date} [overlapStart] - Start of overlap period
+ * @property {Date} [overlapEnd] - End of overlap period
+ * @property {number} [overlapMinutes] - Duration of overlap in minutes
+ * @property {string[]} [conflictingAttendees] - Email addresses of conflicting attendees
+ * @property {string} [conflictingResource] - Resource that has conflict
+ * @property {Object.<string, any>} [metadata] - Additional conflict information
+ */
+/**
+ * @typedef {Object} ConflictCheckOptions
+ * @property {boolean} [checkAttendees=true] - Check for attendee conflicts
+ * @property {boolean} [checkResources=true] - Check for resource conflicts
+ * @property {boolean} [checkLocation=true] - Check for location conflicts
+ * @property {boolean} [ignoreAllDay=false] - Ignore all-day events in conflict check
+ * @property {string[]} [excludeEventIds=[]] - Event IDs to exclude from check
+ * @property {EventStatus[]} [includeStatuses=['confirmed', 'tentative']] - Event statuses to include
+ * @property {number} [bufferMinutes=0] - Buffer time between events in minutes
+ */
+/**
+ * @typedef {Object} ConflictSummary
+ * @property {boolean} hasConflicts - Whether any conflicts exist
+ * @property {number} totalConflicts - Total number of conflicts
+ * @property {ConflictDetails[]} conflicts - Array of conflict details
+ * @property {Object.<ConflictType, number>} conflictsByType - Count by type
+ * @property {Object.<ConflictSeverity, number>} conflictsBySeverity - Count by severity
+ * @property {string[]} affectedEventIds - All event IDs involved
+ * @property {string[]} affectedAttendees - All attendee emails involved
+ */
+export {};