@ilamy/calendar 0.3.2 → 1.0.0

package/README.md

@@ -4,9 +4,12 @@ A powerful, full-featured React calendar component library built with TypeScript
 
 <img width="1643" height="873" alt="Screenshot 2025-08-05 at 9 46 41 AM" src="https://github.com/user-attachments/assets/d289f034-0d26-4a1c-a997-dfa1ad26aa7a" />
 
+<img width="1663" height="872" alt="Screenshot 2025-10-13 at 4 24 29 PM" src="https://github.com/user-attachments/assets/ba0aa27e-373c-40ba-98c6-2d6fd767cb66" />
+
 ## Features
 
 - 🗓️ **Multiple Views**: Month, Week, Day, and Year views with smooth transitions
+- 📊 **Resource Calendar**: Visualize and manage events across multiple resources with timeline layout
 - 🎯 **Drag & Drop**: Move events between dates and time slots with collision detection
 - 🔄 **RFC 5545 Recurring Events**: Full RRULE support with Google Calendar-style operations
   - **RRULE Patterns**: Daily, Weekly, Monthly, Yearly with complex frequencies

package/dist/index.d.ts

@@ -1,25 +1,5 @@
 import React3 from "react";
-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">>;
+import { RRuleOptions } from "@/lib/recurrence-handler/types";
 /**
 * Core calendar event interface representing a single calendar event.
 * This is the primary data structure for calendar events.
@@ -157,6 +137,12 @@ interface Translations {
 	day: string;
 	year: string;
 	more: string;
+	resources: string;
+	resource: string;
+	time: string;
+	date: string;
+	noResourcesVisible: string;
+	addResourcesOrShowExisting: string;
 	sunday: string;
 	monday: string;
 	tuesday: string;
@@ -288,6 +274,11 @@ interface IlamyCalendarProps {
 	* Useful for read-only views or when drag-and-drop is not needed.
 	*/
 	disableDragAndDrop?: boolean;
+	/**
+	* Maximum number of events to display per day in month view.
+	* Additional events will be hidden and can be viewed via a "more" link.
+	* Defaults to 3 if not specified.
+	*/
 	dayMaxEvents?: number;
 	/**
 	* Whether to stick the view header to the top of the calendar.
@@ -311,6 +302,67 @@ interface IlamyCalendarProps {
 	headerClassName?: string;
 }
 declare const IlamyCalendar: React3.FC<IlamyCalendarProps>;
+import React4 from "react";
+interface IlamyResourceCalendarProps extends IlamyCalendarProps {
+	/** Array of events to display */
+	events?: ResourceCalendarEvent[];
+	/** Array of resources */
+	resources?: Resource[];
+	/** Custom render function for resources */
+	renderResource?: (resource: Resource) => React.ReactNode;
+}
+/**
+* Resource interface representing a calendar resource (person, room, equipment, etc.)
+*/
+interface Resource {
+	/** Unique identifier for the resource */
+	id: string | number;
+	/** Display title of the resource */
+	title: string;
+	/**
+	* Color for the resource (supports CSS color values, hex, rgb, hsl, or CSS class names)
+	* @example "#3b82f6", "blue-500", "rgb(59, 130, 246)"
+	*/
+	color?: string;
+	/**
+	* Background color for the resource (supports CSS color values, hex, rgb, hsl, or CSS class names)
+	* @example "#dbeafe", "blue-100", "rgba(59, 130, 246, 0.1)"
+	*/
+	backgroundColor?: string;
+	/** Optional position for resource display */
+	position?: number;
+}
+/**
+* Resource calendar event interface extending CalendarEvent with resource assignment
+*/
+interface ResourceCalendarEvent extends CalendarEvent {
+	/** Single resource assignment */
+	resourceId?: string | number;
+	/** Multiple resource assignment (cross-resource events) */
+	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
@@ -336,6 +388,15 @@ interface UseIlamyCalendarContextReturn {
 	readonly closeEventForm: () => void;
 }
 declare const useIlamyCalendarContext: () => UseIlamyCalendarContextReturn;
+/**
+* Simplified resource calendar context type for external use
+*/
+interface UseIlamyResourceCalendarContextReturn extends UseIlamyCalendarContextReturn {
+	readonly events: ResourceCalendarEvent[];
+	readonly resources: Resource[];
+	readonly getEventsForResource: (resourceId: string | number) => ResourceCalendarEvent[];
+}
+declare const useIlamyResourceCalendarContext: () => UseIlamyResourceCalendarContextReturn;
 declare const isRecurringEvent: (event: CalendarEvent) => boolean;
 interface GenerateRecurringEventsProps {
 	event: CalendarEvent;
@@ -347,4 +408,4 @@ declare const generateRecurringEvents: ({ event, currentEvents, startDate, endDa
 import { Frequency, Weekday } from "rrule";
 import { RRule } from "rrule";
 declare const defaultTranslations: Translations;
-export { useIlamyCalendarContext, isRecurringEvent, generateRecurringEvents, defaultTranslations, Weekday, WeekDays, UseIlamyCalendarContextReturn, TranslatorFunction, Translations, TranslationKey, RRuleOptions, RRule, IlamyCalendarProps, IlamyCalendar, Frequency, CalendarEvent };
+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 };