@ilamy/calendar 3.2.0 → 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 +8 -7
- package/dist/index.d.ts +502 -112
- package/dist/index.js +3 -3
- package/dist/plugins/agenda.d.ts +42 -2
- package/dist/plugins/agenda.js +1 -1
- package/dist/plugins/drag-to-create.d.ts +42 -2
- package/dist/plugins/drag-to-create.js +1 -1
- package/dist/plugins/recurrence.d.ts +42 -2
- package/dist/plugins/recurrence.js +2 -2
- package/dist/shared/chunk-58t5nwpa.js +2 -0
- package/dist/shared/chunk-8n7287tn.js +2 -0
- package/dist/shared/{chunk-1x8xjsbq.js → chunk-fdfxtah1.js} +2 -2
- package/dist/shared/chunk-hd24e4t0.js +2 -0
- package/dist/shared/chunk-qc1dpk9c.js +2 -0
- package/dist/shared/{chunk-p26ryh5z.js → chunk-ybbzp3rf.js} +2 -2
- package/dist/testing/index.d.ts +836 -34
- package/dist/testing/index.js +1 -1
- package/package.json +3 -2
- package/dist/shared/chunk-cn24081x.js +0 -2
- package/dist/shared/chunk-mn44xvnt.js +0 -2
- package/dist/shared/chunk-tfk3a0d4.js +0 -2
- package/dist/shared/chunk-xf8cy2gp.js +0 -2
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
[](https://github.com/kcsujeet/ilamy-calendar/blob/main/LICENSE)
|
|
5
5
|
[](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 — ~
|
|
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
|
|
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)
|
|
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**:
|
|
50
|
-
- **Internationalization**:
|
|
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**:
|
|
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
|
-
- **
|
|
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
|
|