@ilamy/calendar 3.2.1 → 3.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
  [![License](https://img.shields.io/npm/l/@ilamy/calendar?style=flat-square&color=black)](https://github.com/kcsujeet/ilamy-calendar/blob/main/LICENSE)
5
5
  [![Build Status](https://img.shields.io/github/actions/workflow/status/kcsujeet/ilamy-calendar/ci.yml?branch=main&style=flat-square)](https://github.com/kcsujeet/ilamy-calendar/actions)
6
6
 
7
- A powerful, full-featured yet **lightweight and highly pluggable** React calendar component library built with **TypeScript**, **Tailwind CSS 4**, and **shadcn/ui**. The core is small — ~118 KB minified (≈40 KB gzipped), React and other dependencies not included — with opt-in plugins for recurring events, agenda views, and more, so you only ship what you use. Built for high-performance scheduling with RFC 5545 recurring events, resource management, and drag-and-drop interactions.
7
+ A powerful, full-featured yet **lightweight and highly pluggable** React calendar component library built with **TypeScript**, **Tailwind CSS 4**, and **shadcn/ui**. The core is small — ~155 KB minified (≈52 KB gzipped), React and other dependencies not included — with opt-in plugins for recurring events, agenda views, and more, so you only ship what you use. Built for scheduling with RFC 5545 recurring events, resource management, and drag-and-drop to move and resize events.
8
8
 
9
9
  <div align="center">
10
10
  <img width="1159" height="698" alt="Screenshot 2026-07-12 at 2 44 36 PM" src="https://github.com/user-attachments/assets/316c6ad4-2965-4dc4-b779-88b0ac916669" />
@@ -31,7 +31,7 @@ ilamy Calendar is free and open source. If you'd like to support its development
31
31
  ### Resource Management
32
32
  - **Resource Timeline**: Visualize and manage events across multiple resources (rooms, people, equipment).
33
33
  - **Vertical & Horizontal Layouts**: Flexible resource views to fit any application design.
34
- - **Resource-Aware Validation**: Ensure events are correctly assigned and don't overlap where prohibited.
34
+ - **Resource-Aware Availability**: The event form limits dates and times to each resource's business hours, and `isCellDisabled` (or `businessHours`) blocks drops onto unavailable cells.
35
35
 
36
36
  ### Recurring Events (RFC 5545)
37
37
 
@@ -43,19 +43,19 @@ Opt-in via the recurrence plugin (`plugins={[recurrencePlugin()]}` from `@ilamy/
43
43
  - **iCalendar Export**: Export events to `.ics` files with strict RFC 5545 compliance.
44
44
 
45
45
  ### Plugin System
46
- - **Opt-in capabilities**: The core ships no plugins. Add behavior through the `plugins` prop, each from its own subpath: `@ilamy/calendar/plugins/recurrence` (RFC 5545 recurring events) and `@ilamy/calendar/plugins/agenda` (agenda list view).
46
+ - **Opt-in capabilities**: The core ships no plugins. Add behavior through the `plugins` prop, each from its own subpath: `@ilamy/calendar/plugins/recurrence` (RFC 5545 recurring events), `@ilamy/calendar/plugins/agenda` (agenda list view) and `@ilamy/calendar/plugins/drag-to-create` (drag across empty cells to create an event).
47
47
 
48
48
  ### Internationalization & Timezones
49
- - **Timezones**: Full timezone support via `dayjs.tz` with automatic DST handling.
50
- - **Internationalization**: Support for 100+ locales with configurable week start days.
49
+ - **Timezones**: A `timezone` prop renders and parses dates in that zone via `dayjs.tz`, DST included. Known gap: dayjs still reads zoned dates through the machine's own zone, so results can be an hour off on a machine whose clocks change (see `docs/timezones.md`).
50
+ - **Internationalization**: Dates follow any dayjs locale (dayjs ships 140+; import the ones you use, e.g. `import 'dayjs/locale/fr'`, and pass `locale`). UI text is translated through the `translations` or `translator` props, with English built in. The week start day is configurable.
51
51
 
52
52
  ### Interactions
53
- - **Drag & Drop**: Move and resize events with precision using `@dnd-kit`.
53
+ - **Drag & Drop**: Drag events to move them, or drag an edge to resize them, powered by `@dnd-kit`.
54
54
  - **Responsive**: Adaptive layouts designed for desktop, tablet, and mobile.
55
55
 
56
56
  ### Developer Experience
57
57
  - **Type Safety**: Written in TypeScript with comprehensive type definitions and IntelliSense support.
58
- - **Reliability**: 100% test coverage for all mission-critical date and recurrence logic.
58
+ - **Tests**: A unit and integration suite covers date, recurrence and layout logic, plus a browser (Playwright) suite for drag and geometry.
59
59
  - **Theming**: Built on Tailwind CSS 4 variables for effortless branding and customization.
60
60
  - **Modern Stack**: Zero-config integration with React 19 and modern build tools.
61
61
 
@@ -139,6 +139,7 @@ import { agendaPlugin } from '@ilamy/calendar/plugins/agenda';
139
139
 
140
140
  - **`@ilamy/calendar/plugins/recurrence`** — RFC 5545 recurring-event expansion and scoped edit/delete. Also re-adds `rrule`/`recurrenceId`/`exdates` to `CalendarEvent`.
141
141
  - **`@ilamy/calendar/plugins/agenda`** — an agenda (upcoming-events list) view scoped to a `window`.
142
+ - **`@ilamy/calendar/plugins/drag-to-create`** — drag across empty cells to open the event form preselected with that range.
142
143
 
143
144
  ---
144
145