@ilamy/calendar 1.0.0 → 1.0.2

package/dist/index.d.ts

@@ -1,5 +1,25 @@
 import React3 from "react";
-import { RRuleOptions } from "@/lib/recurrence-handler/types";
+import { Options } from "rrule";
+/**
+* Re-rrule.js Options with practical TypeScript interface.
+* Makes all properties optional except freq and dtstart (which are required by RFC 5545).
+* This allows clean object creation without needing explicit null values.
+*
+* @see https://tools.ietf.org/html/rfc5545 - RFC 5545 iCalendar specification
+* @see https://github.com/jakubroztocil/rrule - rrule.js library documentation
+*/
+type RRuleOptions = {
+	/**
+	* The frequency of the event. Must be one of the following: DAILY, WEEKLY, MONTHLY, etc.
+	*/
+	freq: Options["freq"];
+	/**
+	* The start date of the recurrence rule. This defines when the recurrence pattern begins.
+	* Required for proper RRULE functionality according to RFC 5545.
+	* @important Same as the event start date.
+	*/
+	dtstart: Date;
+} & Partial<Omit<Options, "freq" | "dtstart">>;
 /**
 * Core calendar event interface representing a single calendar event.
 * This is the primary data structure for calendar events.
@@ -173,6 +193,10 @@ interface Translations {
 type TranslationKey = keyof Translations;
 type TranslatorFunction = (key: TranslationKey | string) => string;
 /**
+* Available calendar view types.
+*/
+type CalendarView = "month" | "week" | "day" | "year";
+/**
 * This interface extends the base CalendarEvent but allows more flexible date types
 * for the start and end properties. The component will automatically convert these
 * to dayjs objects internally for consistent date handling.
@@ -198,7 +222,12 @@ interface IlamyCalendarProps {
 	* The initial view to display when the calendar loads.
 	* Defaults to 'month'.
 	*/
-	initialView?: "month" | "week" | "day" | "year";
+	initialView?: CalendarView;
+	/**
+	* The initial date to display when the calendar loads.
+	* If not provided, the calendar will default to today's date.
+	*/
+	initialDate?: dayjs.Dayjs | Date | string;
 	/**
 	* Custom render function for calendar events.
 	* If provided, it will override the default event rendering.
@@ -218,7 +247,7 @@ interface IlamyCalendarProps {
 	* Callback when the calendar view changes (month, week, day, year).
 	* Useful for syncing with external state or analytics.
 	*/
-	onViewChange?: (view: "month" | "week" | "day" | "year") => void;
+	onViewChange?: (view: CalendarView) => void;
 	/**
 	* Callback when a new event is added to the calendar.
 	* Provides the newly created event object.
@@ -303,9 +332,23 @@ interface IlamyCalendarProps {
 }
 declare const IlamyCalendar: React3.FC<IlamyCalendarProps>;
 import React4 from "react";
-interface IlamyResourceCalendarProps extends IlamyCalendarProps {
+/**
+* Public-facing resource calendar event interface with flexible date types.
+* Similar to IlamyCalendarPropEvent but with resource assignment fields.
+* Dates can be provided as dayjs.Dayjs, Date, or string and will be normalized internally.
+*
+* @interface IlamyResourceCalendarPropEvent
+* @extends {IlamyCalendarPropEvent}
+*/
+interface IlamyResourceCalendarPropEvent extends IlamyCalendarPropEvent {
+	/** Single resource assignment */
+	resourceId?: string | number;
+	/** Multiple resource assignment (cross-resource events) */
+	resourceIds?: (string | number)[];
+}
+interface IlamyResourceCalendarProps extends Omit<IlamyCalendarProps, "events"> {
 	/** Array of events to display */
-	events?: ResourceCalendarEvent[];
+	events?: IlamyResourceCalendarPropEvent[];
 	/** Array of resources */
 	resources?: Resource[];
 	/** Custom render function for resources */
@@ -342,34 +385,13 @@ interface ResourceCalendarEvent extends CalendarEvent {
 	resourceIds?: (string | number)[];
 }
 declare const IlamyResourceCalendar: React4.FC<IlamyResourceCalendarProps>;
-import { Options } from "rrule";
-/**
-* Re-rrule.js Options with practical TypeScript interface.
-* Makes all properties optional except freq and dtstart (which are required by RFC 5545).
-* This allows clean object creation without needing explicit null values.
-*
-* @see https://tools.ietf.org/html/rfc5545 - RFC 5545 iCalendar specification
-* @see https://github.com/jakubroztocil/rrule - rrule.js library documentation
-*/
-type RRuleOptions2 = {
-	/**
-	* The frequency of the event. Must be one of the following: DAILY, WEEKLY, MONTHLY, etc.
-	*/
-	freq: Options["freq"]
-	/**
-	* The start date of the recurrence rule. This defines when the recurrence pattern begins.
-	* Required for proper RRULE functionality according to RFC 5545.
-	* @important Same as the event start date.
-	*/
-	dtstart: Date
-} & Partial<Omit<Options, "freq" | "dtstart">>;
 /**
 * Simplified calendar context type for external use
 * Contains only the most commonly used calendar operations
 */
 interface UseIlamyCalendarContextReturn {
 	readonly currentDate: dayjs.Dayjs;
-	readonly view: "month" | "week" | "day" | "year";
+	readonly view: CalendarView;
 	readonly events: CalendarEvent[];
 	readonly isEventFormOpen: boolean;
 	readonly selectedEvent: CalendarEvent | null;
@@ -377,7 +399,7 @@ interface UseIlamyCalendarContextReturn {
 	readonly firstDayOfWeek: number;
 	readonly setCurrentDate: (date: dayjs.Dayjs) => void;
 	readonly selectDate: (date: dayjs.Dayjs) => void;
-	readonly setView: (view: "month" | "week" | "day" | "year") => void;
+	readonly setView: (view: CalendarView) => void;
 	readonly nextPeriod: () => void;
 	readonly prevPeriod: () => void;
 	readonly today: () => void;
@@ -408,4 +430,4 @@ declare const generateRecurringEvents: ({ event, currentEvents, startDate, endDa
 import { Frequency, Weekday } from "rrule";
 import { RRule } from "rrule";
 declare const defaultTranslations: Translations;
-export { useIlamyResourceCalendarContext, useIlamyCalendarContext, isRecurringEvent, generateRecurringEvents, defaultTranslations, Weekday, WeekDays, UseIlamyResourceCalendarContextReturn, UseIlamyCalendarContextReturn, TranslatorFunction, Translations, TranslationKey, ResourceCalendarEvent, Resource, RRuleOptions2 as RRuleOptions, RRule, IlamyResourceCalendarProps, IlamyResourceCalendar, IlamyCalendarProps, IlamyCalendar, Frequency, CalendarEvent };
+export { useIlamyResourceCalendarContext, useIlamyCalendarContext, isRecurringEvent, generateRecurringEvents, defaultTranslations, Weekday, WeekDays, UseIlamyResourceCalendarContextReturn, UseIlamyCalendarContextReturn, TranslatorFunction, Translations, TranslationKey, ResourceCalendarEvent, Resource, RRuleOptions, RRule, IlamyResourceCalendarProps, IlamyResourceCalendar, IlamyCalendarProps, IlamyCalendar, Frequency, CalendarView, CalendarEvent };