kalendly 0.2.1 → 0.3.0

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+type Open<T extends string> = T | (string & {});
 interface CalendarEvent {
     id: string | number;
     name: string;
@@ -7,11 +8,12 @@ interface CalendarEvent {
     allDay?: boolean;
     description?: string;
     color?: string;
-    category?: 'work' | 'personal' | 'meeting' | 'deadline' | 'appointment' | 'other';
+    category?: Open<'work' | 'personal' | 'meeting' | 'deadline' | 'appointment' | 'other'>;
     location?: string;
     url?: string;
-    status?: 'scheduled' | 'completed' | 'cancelled' | 'tentative';
-    priority?: 'low' | 'medium' | 'high';
+    status?: Open<'scheduled' | 'completed' | 'cancelled' | 'tentative'>;
+    priority?: Open<'low' | 'medium' | 'high'>;
+    availabilityStatus?: Open<'open' | 'conditional' | 'blocked'>;
     attendees?: string[];
     organizer?: string;
     reminders?: number[];
@@ -52,6 +54,13 @@ interface CalendarConfig {
     maxYear?: number;
     weekStartsOn?: 0 | 1;
     categoryColors?: CategoryColorMap;
+    monthCount?: number;
+}
+interface CalendarPane {
+    year: number;
+    month: number;
+    monthAndYearText: string;
+    calendarDates: CalendarDate[][];
 }
 interface CalendarActions {
     next: () => void;
@@ -62,18 +71,14 @@ interface CalendarActions {
     selectDate: (date: Date) => void;
     updateTasks: () => void;
 }
-interface PopupPosition {
-    class: 'popup-left' | 'popup-right' | 'popup-center-top' | 'popup-center-bottom';
-    style?: Record<string, string | number>;
-}
 interface CalendarViewModel extends CalendarState {
     months: string[];
     days: string[];
     years: number[];
     monthAndYearText: string;
     scheduleDay: string;
+    panes: CalendarPane[];
     calendarDates: CalendarDate[][];
-    popupPositionClass: string;
 }
 type CalendarEventHandler = (event: CalendarEvent) => void;
 interface CalendarProps {
@@ -98,7 +103,39 @@ interface CalendarTheme {
     borderColor?: string;
     todayOutline?: string;
     selectedBg?: string;
+    headerBg?: string;
+    popupBg?: string;
+    pickerBg?: string;
+    pickerShadow?: string;
     eventIndicator?: string;
+    onAccent?: string;
+    link?: string;
+    openBg?: string;
+    openFg?: string;
+    conditionalBg?: string;
+    conditionalFg?: string;
+    blockedBg?: string;
+    blockedFg?: string;
+    rangeBg?: string;
+    rangeOutline?: string;
+    inRangeBg?: string;
+    inRangeOutline?: string;
+    badgeBg?: string;
+    badgeText?: string;
+    badgeSuccessBg?: string;
+    badgeSuccessText?: string;
+    badgeInfoBg?: string;
+    badgeInfoText?: string;
+    badgeWarningBg?: string;
+    badgeWarningText?: string;
+    badgeDangerBg?: string;
+    badgeDangerText?: string;
+    badgeNeutralBg?: string;
+    badgeNeutralText?: string;
+    badgePositiveBg?: string;
+    badgePositiveText?: string;
+    badgeTentativeBg?: string;
+    badgeTentativeText?: string;
 }
 
 declare const MONTHS: string[];
@@ -111,7 +148,6 @@ declare function generateYears(minYear?: number, maxYear?: number): number[];
 declare function getEventsForDate(events: CalendarEvent[], date: Date): CalendarEvent[];
 declare function hasEvents(events: CalendarEvent[], date: Date): boolean;
 declare function generateCalendarDates(year: number, month: number, events?: CalendarEvent[], weekStartsOn?: 0 | 1): CalendarDate[][];
-declare function getPopupPositionClass(selectedDayIndex: number | null): string;
 declare function getCellClasses(calendarDate: CalendarDate): string[];
 declare function formatDateForDisplay(date: Date): string;
 declare function getMonthYearText(year: number, month: number): string;
@@ -123,6 +159,10 @@ declare function getDefaultEventColor(category?: string, customColors?: Category
 declare function mergeCategoryColors(customColors?: CategoryColorMap): CategoryColorMap;
 declare function isValidHexColor(color: string): boolean;
 declare function getCategoryColor(category: string, customColors?: CategoryColorMap): string;
+declare function escapeHtml(value: unknown): string;
+declare function slugifyToken(value: string): string;
+declare function safeUrl(value: string): string;
+declare function safeColor(value: string): string;
 
 declare class CalendarEngine {
     private state;
@@ -222,6 +262,7 @@ declare class CalendarEngine {
 
 declare class CalendarElement extends HTMLElement {
     static observedAttributes: string[];
+    private static readonly themeMap;
     private engine;
     private unsubscribe;
     private actions;
@@ -239,6 +280,10 @@ declare class CalendarElement extends HTMLElement {
     private _categoryColors;
     private _renderEvent;
     private _renderNoEvents;
+    private _availabilityColors;
+    private _selectableStatuses;
+    private _initError;
+    private pendingUpdate;
     private _rangeStart;
     private _rangeEnd;
     private _timeRangeDate;
@@ -249,19 +294,36 @@ declare class CalendarElement extends HTMLElement {
     set events(val: CalendarEvent[]);
     set theme(val: CalendarTheme);
     set categoryColors(val: CategoryColorMap);
+    get availabilityColors(): Record<string, string>;
+    set availabilityColors(val: Record<string, string>);
+    get selectableStatuses(): string[];
+    set selectableStatuses(val: string[]);
     set renderEvent(val: (e: CalendarEvent) => string);
     set renderNoEvents(val: () => string);
     get loading(): boolean;
     set loading(val: boolean);
+    private reaction;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private get headingText();
+    private get monthCount();
     private get minYear();
     private get maxYear();
     private initEngine;
     private reinit;
     private cleanup;
     private applyTheme;
+    private static readonly BUILT_IN_BUCKETS;
+    private static titleDeprecationWarned;
+    private get knownBuckets();
+    get updateComplete(): Promise<void>;
+    private scheduleRender;
+    private rethrowInitError;
+    private assertStatusesDeclared;
+    private assertStatusesKnown;
+    private resolveBucket;
+    private isDateSelectable;
     private render;
     private attachEventListeners;
     private updatePickerYear;
@@ -291,11 +353,15 @@ interface CalendarElementProps {
     categoryColors?: CategoryColorMap;
     renderEvent?: (event: CalendarEvent) => string;
     renderNoEvents?: () => string;
+    availabilityColors?: Record<string, string>;
+    selectableStatuses?: string[];
 }
 interface CalendarElementInstance {
     events: CalendarEvent[];
     theme: CalendarTheme;
     categoryColors: CategoryColorMap;
+    availabilityColors: Record<string, string>;
+    selectableStatuses: string[];
     renderEvent: (event: CalendarEvent) => string;
     renderNoEvents: () => string;
     updateEvents: (events: CalendarEvent[]) => void;
@@ -305,4 +371,4 @@ interface CalendarElementInstance {
     getEngine: () => CalendarEngine;
 }
 
-export { type CalendarActions, type CalendarConfig, type CalendarDate, CalendarElement, type CalendarElementInstance, type CalendarElementProps, CalendarEngine, type CalendarEvent, type CalendarEventHandler, type CalendarProps, type CalendarState, type CalendarTheme, type CalendarViewModel, type CategoryColorMap, DAYS, DEFAULT_CATEGORY_COLORS, MONTHS, MONTHS_FULL, type PopupPosition, defineCalendarElement, formatAttendees, formatDateForDisplay, formatTimeRange, generateCalendarDates, generateYears, getCategoryColor, getCellClasses, getDefaultEventColor, getEventsForDate, getMonthYearText, getPopupPositionClass, hasEvents, isSameDay, isToday, isValidHexColor, mergeCategoryColors, normalizeDate, sortEventsByTime };
+export { type CalendarActions, type CalendarConfig, type CalendarDate, CalendarElement, type CalendarElementInstance, type CalendarElementProps, CalendarEngine, type CalendarEvent, type CalendarEventHandler, type CalendarPane, type CalendarProps, type CalendarState, type CalendarTheme, type CalendarViewModel, type CategoryColorMap, DAYS, DEFAULT_CATEGORY_COLORS, MONTHS, MONTHS_FULL, defineCalendarElement, escapeHtml, formatAttendees, formatDateForDisplay, formatTimeRange, generateCalendarDates, generateYears, getCategoryColor, getCellClasses, getDefaultEventColor, getEventsForDate, getMonthYearText, hasEvents, isSameDay, isToday, isValidHexColor, mergeCategoryColors, normalizeDate, safeColor, safeUrl, slugifyToken, sortEventsByTime };

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+type Open<T extends string> = T | (string & {});
 interface CalendarEvent {
     id: string | number;
     name: string;
@@ -7,11 +8,12 @@ interface CalendarEvent {
     allDay?: boolean;
     description?: string;
     color?: string;
-    category?: 'work' | 'personal' | 'meeting' | 'deadline' | 'appointment' | 'other';
+    category?: Open<'work' | 'personal' | 'meeting' | 'deadline' | 'appointment' | 'other'>;
     location?: string;
     url?: string;
-    status?: 'scheduled' | 'completed' | 'cancelled' | 'tentative';
-    priority?: 'low' | 'medium' | 'high';
+    status?: Open<'scheduled' | 'completed' | 'cancelled' | 'tentative'>;
+    priority?: Open<'low' | 'medium' | 'high'>;
+    availabilityStatus?: Open<'open' | 'conditional' | 'blocked'>;
     attendees?: string[];
     organizer?: string;
     reminders?: number[];
@@ -52,6 +54,13 @@ interface CalendarConfig {
     maxYear?: number;
     weekStartsOn?: 0 | 1;
     categoryColors?: CategoryColorMap;
+    monthCount?: number;
+}
+interface CalendarPane {
+    year: number;
+    month: number;
+    monthAndYearText: string;
+    calendarDates: CalendarDate[][];
 }
 interface CalendarActions {
     next: () => void;
@@ -62,18 +71,14 @@ interface CalendarActions {
     selectDate: (date: Date) => void;
     updateTasks: () => void;
 }
-interface PopupPosition {
-    class: 'popup-left' | 'popup-right' | 'popup-center-top' | 'popup-center-bottom';
-    style?: Record<string, string | number>;
-}
 interface CalendarViewModel extends CalendarState {
     months: string[];
     days: string[];
     years: number[];
     monthAndYearText: string;
     scheduleDay: string;
+    panes: CalendarPane[];
     calendarDates: CalendarDate[][];
-    popupPositionClass: string;
 }
 type CalendarEventHandler = (event: CalendarEvent) => void;
 interface CalendarProps {
@@ -98,7 +103,39 @@ interface CalendarTheme {
     borderColor?: string;
     todayOutline?: string;
     selectedBg?: string;
+    headerBg?: string;
+    popupBg?: string;
+    pickerBg?: string;
+    pickerShadow?: string;
     eventIndicator?: string;
+    onAccent?: string;
+    link?: string;
+    openBg?: string;
+    openFg?: string;
+    conditionalBg?: string;
+    conditionalFg?: string;
+    blockedBg?: string;
+    blockedFg?: string;
+    rangeBg?: string;
+    rangeOutline?: string;
+    inRangeBg?: string;
+    inRangeOutline?: string;
+    badgeBg?: string;
+    badgeText?: string;
+    badgeSuccessBg?: string;
+    badgeSuccessText?: string;
+    badgeInfoBg?: string;
+    badgeInfoText?: string;
+    badgeWarningBg?: string;
+    badgeWarningText?: string;
+    badgeDangerBg?: string;
+    badgeDangerText?: string;
+    badgeNeutralBg?: string;
+    badgeNeutralText?: string;
+    badgePositiveBg?: string;
+    badgePositiveText?: string;
+    badgeTentativeBg?: string;
+    badgeTentativeText?: string;
 }
 
 declare const MONTHS: string[];
@@ -111,7 +148,6 @@ declare function generateYears(minYear?: number, maxYear?: number): number[];
 declare function getEventsForDate(events: CalendarEvent[], date: Date): CalendarEvent[];
 declare function hasEvents(events: CalendarEvent[], date: Date): boolean;
 declare function generateCalendarDates(year: number, month: number, events?: CalendarEvent[], weekStartsOn?: 0 | 1): CalendarDate[][];
-declare function getPopupPositionClass(selectedDayIndex: number | null): string;
 declare function getCellClasses(calendarDate: CalendarDate): string[];
 declare function formatDateForDisplay(date: Date): string;
 declare function getMonthYearText(year: number, month: number): string;
@@ -123,6 +159,10 @@ declare function getDefaultEventColor(category?: string, customColors?: Category
 declare function mergeCategoryColors(customColors?: CategoryColorMap): CategoryColorMap;
 declare function isValidHexColor(color: string): boolean;
 declare function getCategoryColor(category: string, customColors?: CategoryColorMap): string;
+declare function escapeHtml(value: unknown): string;
+declare function slugifyToken(value: string): string;
+declare function safeUrl(value: string): string;
+declare function safeColor(value: string): string;
 
 declare class CalendarEngine {
     private state;
@@ -222,6 +262,7 @@ declare class CalendarEngine {
 
 declare class CalendarElement extends HTMLElement {
     static observedAttributes: string[];
+    private static readonly themeMap;
     private engine;
     private unsubscribe;
     private actions;
@@ -239,6 +280,10 @@ declare class CalendarElement extends HTMLElement {
     private _categoryColors;
     private _renderEvent;
     private _renderNoEvents;
+    private _availabilityColors;
+    private _selectableStatuses;
+    private _initError;
+    private pendingUpdate;
     private _rangeStart;
     private _rangeEnd;
     private _timeRangeDate;
@@ -249,19 +294,36 @@ declare class CalendarElement extends HTMLElement {
     set events(val: CalendarEvent[]);
     set theme(val: CalendarTheme);
     set categoryColors(val: CategoryColorMap);
+    get availabilityColors(): Record<string, string>;
+    set availabilityColors(val: Record<string, string>);
+    get selectableStatuses(): string[];
+    set selectableStatuses(val: string[]);
     set renderEvent(val: (e: CalendarEvent) => string);
     set renderNoEvents(val: () => string);
     get loading(): boolean;
     set loading(val: boolean);
+    private reaction;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private get headingText();
+    private get monthCount();
     private get minYear();
     private get maxYear();
     private initEngine;
     private reinit;
     private cleanup;
     private applyTheme;
+    private static readonly BUILT_IN_BUCKETS;
+    private static titleDeprecationWarned;
+    private get knownBuckets();
+    get updateComplete(): Promise<void>;
+    private scheduleRender;
+    private rethrowInitError;
+    private assertStatusesDeclared;
+    private assertStatusesKnown;
+    private resolveBucket;
+    private isDateSelectable;
     private render;
     private attachEventListeners;
     private updatePickerYear;
@@ -291,11 +353,15 @@ interface CalendarElementProps {
     categoryColors?: CategoryColorMap;
     renderEvent?: (event: CalendarEvent) => string;
     renderNoEvents?: () => string;
+    availabilityColors?: Record<string, string>;
+    selectableStatuses?: string[];
 }
 interface CalendarElementInstance {
     events: CalendarEvent[];
     theme: CalendarTheme;
     categoryColors: CategoryColorMap;
+    availabilityColors: Record<string, string>;
+    selectableStatuses: string[];
     renderEvent: (event: CalendarEvent) => string;
     renderNoEvents: () => string;
     updateEvents: (events: CalendarEvent[]) => void;
@@ -305,4 +371,4 @@ interface CalendarElementInstance {
     getEngine: () => CalendarEngine;
 }
 
-export { type CalendarActions, type CalendarConfig, type CalendarDate, CalendarElement, type CalendarElementInstance, type CalendarElementProps, CalendarEngine, type CalendarEvent, type CalendarEventHandler, type CalendarProps, type CalendarState, type CalendarTheme, type CalendarViewModel, type CategoryColorMap, DAYS, DEFAULT_CATEGORY_COLORS, MONTHS, MONTHS_FULL, type PopupPosition, defineCalendarElement, formatAttendees, formatDateForDisplay, formatTimeRange, generateCalendarDates, generateYears, getCategoryColor, getCellClasses, getDefaultEventColor, getEventsForDate, getMonthYearText, getPopupPositionClass, hasEvents, isSameDay, isToday, isValidHexColor, mergeCategoryColors, normalizeDate, sortEventsByTime };
+export { type CalendarActions, type CalendarConfig, type CalendarDate, CalendarElement, type CalendarElementInstance, type CalendarElementProps, CalendarEngine, type CalendarEvent, type CalendarEventHandler, type CalendarPane, type CalendarProps, type CalendarState, type CalendarTheme, type CalendarViewModel, type CategoryColorMap, DAYS, DEFAULT_CATEGORY_COLORS, MONTHS, MONTHS_FULL, defineCalendarElement, escapeHtml, formatAttendees, formatDateForDisplay, formatTimeRange, generateCalendarDates, generateYears, getCategoryColor, getCellClasses, getDefaultEventColor, getEventsForDate, getMonthYearText, hasEvents, isSameDay, isToday, isValidHexColor, mergeCategoryColors, normalizeDate, safeColor, safeUrl, slugifyToken, sortEventsByTime };