kalendly 0.1.2 → 0.1.3

package/README.md

@@ -16,11 +16,11 @@ A universal calendar scheduler component that works seamlessly across React, Vue
 
 ## Live Examples
 
-Check out the interactive examples: [https://kalendly.netlify.app](https://kalendly.netlify.app)
+Check out the interactive examples: [https://kalendly-example.netlify.app/](https://kalendly-example.netlify.app)
 
-- [Vanilla JavaScript](https://kalendly.netlify.app/vanilla)
-- [React](https://kalendly.netlify.app/react)
-- [Vue](https://kalendly.netlify.app/vue)
+- [Vanilla JavaScript](https://kalendly-example.netlify.app/vanilla)
+- [React](https://kalendly-example.netlify.app/react)
+- [Vue](https://kalendly-example.netlify.app/vue)
 
 ## Installation
 

package/dist/vue/index.d.ts

@@ -0,0 +1,299 @@
+import { CSSProperties } from 'react';
+import { default as React_3 } from 'react';
+import { ReactNode } from 'react';
+import { TextStyle } from 'react-native';
+import { ViewStyle } from 'react-native';
+
+export declare interface CalendarActions {
+    next: () => void;
+    previous: () => void;
+    jump: (year: number, month: number) => void;
+    selectDate: (date: Date) => void;
+    updateTasks: () => void;
+}
+
+declare type CalendarComponentProps$1 = ReactCalendarProps;
+
+declare type CalendarComponentProps = ReactNativeCalendarProps;
+
+export declare interface CalendarConfig {
+    events: CalendarEvent[];
+    initialDate?: Date;
+    minYear?: number;
+    maxYear?: number;
+    weekStartsOn?: 0 | 1;
+    categoryColors?: CategoryColorMap;
+}
+
+export declare interface CalendarDate {
+    date: Date;
+    isCurrentMonth: boolean;
+    isToday: boolean;
+    hasEvents: boolean;
+    events: CalendarEvent[];
+}
+
+export declare class CalendarEngine {
+    private state;
+    private config;
+    private listeners;
+    private categoryColors;
+    constructor(config: CalendarConfig);
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(listener: () => void): () => void;
+    /**
+     * Notify all listeners of state changes
+     */
+    private notify;
+    /**
+     * Get current state
+     */
+    getState(): CalendarState;
+    /**
+     * Get view model with computed properties
+     */
+    getViewModel(): CalendarViewModel;
+    /**
+     * Get actions object
+     */
+    getActions(): CalendarActions;
+    /**
+     * Navigate to next month
+     */
+    private next;
+    /**
+     * Navigate to previous month
+     */
+    private previous;
+    /**
+     * Jump to specific month and year
+     */
+    private jump;
+    /**
+     * Select a specific date
+     */
+    private selectDate;
+    /**
+     * Update tasks for the currently selected date
+     */
+    private updateTasks;
+    /**
+     * Update events configuration
+     */
+    updateEvents(events: CalendarEvent[]): void;
+    /**
+     * Handle date cell click
+     */
+    handleDateClick(date: Date, dayIndex?: number): void;
+    /**
+     * Check if date has events
+     */
+    hasEventsForDate(date: Date): boolean;
+    /**
+     * Get events for a specific date
+     */
+    getEventsForDate(date: Date): CalendarEvent[];
+    /**
+     * Clear selected date
+     */
+    clearSelection(): void;
+    /**
+     * Get category color (with custom colors support)
+     */
+    getCategoryColor(category?: string): string;
+    /**
+     * Update category colors dynamically
+     */
+    updateCategoryColors(colors: CategoryColorMap): void;
+    /**
+     * Get all category colors
+     */
+    getCategoryColors(): CategoryColorMap;
+    /**
+     * Register a new category with color
+     */
+    registerCategory(name: string, color: string): void;
+    /**
+     * Destroy the engine and cleanup listeners
+     */
+    destroy(): void;
+}
+
+export declare interface CalendarEvent {
+    id: string | number;
+    name: string;
+    date: string | Date;
+    startTime?: string;
+    endTime?: string;
+    allDay?: boolean;
+    description?: string;
+    color?: string;
+    category?: 'work' | 'personal' | 'meeting' | 'deadline' | 'appointment' | 'other';
+    location?: string;
+    url?: string;
+    status?: 'scheduled' | 'completed' | 'cancelled' | 'tentative';
+    priority?: 'low' | 'medium' | 'high';
+    attendees?: string[];
+    organizer?: string;
+    reminders?: number[];
+    recurring?: {
+        frequency: 'daily' | 'weekly' | 'monthly' | 'yearly';
+        interval?: number;
+        endDate?: string | Date;
+        daysOfWeek?: number[];
+    };
+    notes?: string;
+    tags?: string[];
+    createdAt?: string | Date;
+    updatedAt?: string | Date;
+    [key: string]: unknown;
+}
+
+export declare type CalendarEventHandler = (event: CalendarEvent) => void;
+
+export declare interface CalendarProps {
+    events: CalendarEvent[];
+    initialDate?: Date;
+    minYear?: number;
+    maxYear?: number;
+    weekStartsOn?: 0 | 1;
+    onDateSelect?: (date: Date) => void;
+    onEventClick?: CalendarEventHandler;
+    onMonthChange?: (year: number, month: number) => void;
+}
+
+export declare interface CalendarState {
+    currentYear: number;
+    currentMonth: number;
+    currentDate: number;
+    selectedDate: Date | null;
+    selectedDayIndex: number | null;
+    tasks: CalendarEvent[];
+}
+
+export declare interface CalendarViewModel extends CalendarState {
+    months: string[];
+    days: string[];
+    years: number[];
+    monthAndYearText: string;
+    scheduleDay: string;
+    calendarDates: (CalendarDate | null)[][];
+    popupPositionClass: string;
+}
+
+export declare interface CategoryColorMap {
+    [category: string]: string;
+}
+
+export declare function createVanillaCalendar(props: VanillaCalendarProps): VanillaCalendarInstance;
+
+export declare const DAYS: string[];
+
+export declare const DEFAULT_CATEGORY_COLORS: CategoryColorMap;
+
+export declare function formatAttendees(attendees?: string[]): string;
+
+export declare function formatDateForDisplay(date: Date): string;
+
+export declare function formatTimeRange(event: CalendarEvent): string;
+
+export declare function generateCalendarDates(year: number, month: number, events?: CalendarEvent[], weekStartsOn?: 0 | 1): (CalendarDate | null)[][];
+
+export declare function generateYears(minYear?: number, maxYear?: number): number[];
+
+export declare function getCategoryColor(category: string, customColors?: CategoryColorMap): string;
+
+export declare function getCellClasses(calendarDate: CalendarDate | null): string[];
+
+export declare function getDefaultEventColor(category?: string, customColors?: CategoryColorMap): string;
+
+export declare function getEventsForDate(events: CalendarEvent[], date: Date): CalendarEvent[];
+
+export declare function getMonthYearText(year: number, month: number): string;
+
+export declare function getPopupPositionClass(selectedDayIndex: number | null): string;
+
+export declare function hasEvents(events: CalendarEvent[], date: Date): boolean;
+
+export declare function isSameDay(date1: Date, date2: Date): boolean;
+
+export declare function isToday(date: Date): boolean;
+
+export declare function isValidHexColor(color: string): boolean;
+
+export declare function mergeCategoryColors(customColors?: CategoryColorMap): CategoryColorMap;
+
+export declare const MONTHS: string[];
+
+declare const name_2 = "kalendly";
+export { name_2 as name }
+
+export declare function normalizeDate(date: Date): Date;
+
+export declare interface PopupPosition {
+    class: 'popup-left' | 'popup-right' | 'popup-center-top' | 'popup-center-bottom';
+    style?: Record<string, string | number>;
+}
+
+declare namespace React_2 {
+        { Calendar$1 as Calendar, declare type index$2_CalendarActions as CalendarActions, declare type CalendarComponentProps$1 as CalendarComponentProps, declare type index$2_CalendarConfig as CalendarConfig, declare type index$2_CalendarDate as CalendarDate, index$2_CalendarEngine as CalendarEngine, declare type index$2_CalendarEvent as CalendarEvent, declare type index$2_CalendarEventHandler as CalendarEventHandler, declare type index$2_CalendarProps as CalendarProps, declare type index$2_CalendarState as CalendarState, declare type index$2_CalendarViewModel as CalendarViewModel, declare type index$2_CategoryColorMap as CategoryColorMap, index$2_DAYS as DAYS, index$2_DEFAULT_CATEGORY_COLORS as DEFAULT_CATEGORY_COLORS, DatePopup$1 as DatePopup, declare type DatePopupProps$1 as DatePopupProps, index$2_MONTHS as MONTHS, declare type index$2_PopupPosition as PopupPosition, declare type index$2_ReactCalendarProps as ReactCalendarProps, index$2_formatAttendees as formatAttendees, index$2_formatDateForDisplay as formatDateForDisplay, index$2_formatTimeRange as formatTimeRange, index$2_generateCalendarDates as generateCalendarDates, index$2_generateYears as generateYears, index$2_getCategoryColor as getCategoryColor, index$2_getCellClasses as getCellClasses, index$2_getDefaultEventColor as getDefaultEventColor, index$2_getEventsForDate as getEventsForDate, index$2_getMonthYearText as getMonthYearText, index$2_getPopupPositionClass as getPopupPositionClass, index$2_hasEvents as hasEvents, index$2_isSameDay as isSameDay, index$2_isToday as isToday, index$2_isValidHexColor as isValidHexColor, index$2_mergeCategoryColors as mergeCategoryColors, index$2_normalizeDate as normalizeDate, index$2_sortEventsByTime as sortEventsByTime };
+}
+export { React_2 as React }
+
+export declare const ReactCalendar: React_3.FC<CalendarComponentProps$1>;
+
+declare interface ReactCalendarProps extends CalendarProps {
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+    renderEvent?: (event: CalendarEvent) => ReactNode;
+    renderNoEvents?: () => ReactNode;
+    title?: string;
+}
+
+export declare namespace ReactNative {
+        { index$1_Calendar as Calendar, export declare type index$1_CalendarActions as CalendarActions, export declare type index$1_CalendarComponentProps as CalendarComponentProps, export declare type index$1_CalendarConfig as CalendarConfig, export declare type index$1_CalendarDate as CalendarDate, index$1_CalendarEngine as CalendarEngine, export declare type index$1_CalendarEvent as CalendarEvent, export declare type index$1_CalendarEventHandler as CalendarEventHandler, export declare type index$1_CalendarProps as CalendarProps, export declare type index$1_CalendarState as CalendarState, export declare type index$1_CalendarViewModel as CalendarViewModel, export declare type index$1_CategoryColorMap as CategoryColorMap, index$1_DAYS as DAYS, index$1_DEFAULT_CATEGORY_COLORS as DEFAULT_CATEGORY_COLORS, index$1_DatePopup as DatePopup, export declare type index$1_DatePopupProps as DatePopupProps, index$1_MONTHS as MONTHS, export declare type index$1_PopupPosition as PopupPosition, export declare type index$1_ReactNativeCalendarProps as ReactNativeCalendarProps, export declare type index$1_SelectProps as SelectProps, index$1_calendarStyles as calendarStyles, index$1_formatAttendees as formatAttendees, index$1_formatDateForDisplay as formatDateForDisplay, index$1_formatTimeRange as formatTimeRange, index$1_generateCalendarDates as generateCalendarDates, index$1_generateYears as generateYears, index$1_getCategoryColor as getCategoryColor, index$1_getCellClasses as getCellClasses, index$1_getDefaultEventColor as getDefaultEventColor, index$1_getEventsForDate as getEventsForDate, index$1_getMonthYearText as getMonthYearText, index$1_getPopupPositionClass as getPopupPositionClass, index$1_hasEvents as hasEvents, index$1_isSameDay as isSameDay, index$1_isToday as isToday, index$1_isValidHexColor as isValidHexColor, index$1_mergeCategoryColors as mergeCategoryColors, index$1_normalizeDate as normalizeDate, index$1_sortEventsByTime as sortEventsByTime };
+}
+
+export declare const ReactNativeCalendar: React_3.FC<CalendarComponentProps>;
+
+declare interface ReactNativeCalendarProps extends CalendarProps {
+    style?: ViewStyle;
+    containerStyle?: ViewStyle;
+    headerStyle?: ViewStyle;
+    headerTextStyle?: TextStyle;
+    cellStyle?: ViewStyle;
+    cellTextStyle?: TextStyle;
+    renderEvent?: (event: CalendarEvent) => ReactNode;
+    renderNoEvents?: () => ReactNode;
+    title?: string;
+    showCloseButton?: boolean;
+}
+
+export declare function sortEventsByTime(events: CalendarEvent[]): CalendarEvent[];
+
+export declare namespace Vanilla {
+        { export declare type index_CalendarActions as CalendarActions, export declare type index_CalendarConfig as CalendarConfig, export declare type index_CalendarDate as CalendarDate, index_CalendarEngine as CalendarEngine, export declare type index_CalendarEvent as CalendarEvent, export declare type index_CalendarEventHandler as CalendarEventHandler, export declare type index_CalendarProps as CalendarProps, export declare type index_CalendarState as CalendarState, export declare type index_CalendarViewModel as CalendarViewModel, export declare type index_CategoryColorMap as CategoryColorMap, index_DAYS as DAYS, index_DEFAULT_CATEGORY_COLORS as DEFAULT_CATEGORY_COLORS, index_MONTHS as MONTHS, export declare type index_PopupPosition as PopupPosition, index_VanillaCalendar as VanillaCalendar, export declare type index_VanillaCalendarInstance as VanillaCalendarInstance, export declare type index_VanillaCalendarProps as VanillaCalendarProps, index_createCalendar as createCalendar, index_formatAttendees as formatAttendees, index_formatDateForDisplay as formatDateForDisplay, index_formatTimeRange as formatTimeRange, index_generateCalendarDates as generateCalendarDates, index_generateYears as generateYears, index_getCategoryColor as getCategoryColor, index_getCellClasses as getCellClasses, index_getDefaultEventColor as getDefaultEventColor, index_getEventsForDate as getEventsForDate, index_getMonthYearText as getMonthYearText, index_getPopupPositionClass as getPopupPositionClass, index_hasEvents as hasEvents, index_isSameDay as isSameDay, index_isToday as isToday, index_isValidHexColor as isValidHexColor, index_mergeCategoryColors as mergeCategoryColors, index_normalizeDate as normalizeDate, index_sortEventsByTime as sortEventsByTime };
+}
+
+declare interface VanillaCalendarInstance {
+    destroy: () => void;
+    updateEvents: (events: CalendarEvent[]) => void;
+    getCurrentDate: () => Date | null;
+    goToDate: (date: Date) => void;
+    getEngine: () => CalendarEngine;
+}
+
+declare interface VanillaCalendarProps extends CalendarProps {
+    container: HTMLElement | string;
+    className?: string;
+    title?: string;
+    renderEvent?: (event: CalendarEvent) => string;
+    renderNoEvents?: () => string;
+}
+
+export declare const version = "1.0.0";
+
+export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kalendly",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "A kalendly universal calendar scheduler component for React, Vue, and React Native",
   "keywords": [
     "calendar",