npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@rozie-ui/fullcalendar-react

v0.2.4

Published

Idiomatic React calendar/scheduler — one Rozie source compiled to React wrapping FullCalendar.

Readme

@rozie-ui/fullcalendar-react

Idiomatic react FullCalendar — a cross-framework calendar/scheduler compiled from one Rozie source wrapping FullCalendar. This package is generated; do not edit src/ by hand.

Install

npm i @rozie-ui/fullcalendar-react

Peer dependencies: the four @fullcalendar/* engine packages (@fullcalendar/core, @fullcalendar/daygrid, @fullcalendar/timegrid, @fullcalendar/interaction, all ^6.1) + react + react-dom. Install them alongside this package. FullCalendar v6 auto-injects its own stylesheet — there is no manual CSS import to add.

Also installed: @rozie/runtime-react — Rozie's small, tree-shaken runtime helper package (controllable state, keyboard navigation, event modifiers, and safe interpolation). It arrives as a regular dependency, so npm pulls it for you. Your bundler keeps only the helpers this component actually uses — typically a few hundred bytes to a few KB, minified and gzipped. What's in it and what it costs.

Usage

import { useState } from 'react';
import { FullCalendar } from '@rozie-ui/fullcalendar-react';

export function Demo() {
  const [view, setView] = useState('dayGridMonth');
  const [events] = useState([{ id: '1', title: 'Kickoff', start: '2026-06-04' }]);
  return (
    <FullCalendar
      view={view}
      onViewChange={setView}
      events={events}
      onEventClick={(e) => console.log(e.event, e.el)}
    />
  );
}

Props

| Name | Type | Default | Two-way (model) | Required | | --- | --- | --- | :---: | :---: | | events | Array | [] | | | | view | String | "dayGridMonth" | ✓ | | | weekends | Boolean | true | | | | editable | Boolean | true | | | | selectable | Boolean | true | | | | height | String \| Number | 480 | | | | defaultColor | String | "#3b82f6" | | | | locale | String | "en" | | | | firstDay | Number | null | | | | slotDuration | String | "00:30:00" | | | | nowIndicator | Boolean | false | | | | headerToolbar | Object | {…} | | | | options | Object | {} | | |

Events

| Event | Payload | Description | | --- | --- | --- | | eventClick | FullCalendarEventClick | Fired when a calendar event is clicked, or activated with Enter/Space (then jsEvent is a KeyboardEvent). el is the clicked event's DOM element (use it as the anchor for a popover or tooltip). | | dateClick | FullCalendarDateClick | Fired when an empty date/time cell is clicked. dayEl is the clicked day cell (an anchor for a popover) and jsEvent the click. | | eventDrop | FullCalendarEventDrop | Fired after an event is dragged to a new date/time. Call revert() to reject the move; oldEvent is the event before it. event and oldEvent both carry allDay, so a drop onto or off the all-day row shows as event.allDay !== oldEvent.allDay. | | select | FullCalendarSelection | Fired when a date/time range is selected by drag (requires selectable). | | eventResize | FullCalendarEventResize | Fired after an event is resized by dragging its edge (requires editable). Call revert() to reject the resize; oldEvent is the event before it. event and oldEvent both carry allDay. | | datesSet | FullCalendarDatesSet | Fired whenever the visible date range changes (navigation or view switch). view is the active view type string. | | eventMouseEnter | FullCalendarEventPointer | Fired when the pointer enters a calendar event (payload mirrors eventClick, with jsEvent always a MouseEvent). | | eventMouseLeave | FullCalendarEventPointer | Fired when the pointer leaves a calendar event (payload mirrors eventMouseEnter). | | unselect | FullCalendarUnselect | Fired when a previously selected date/time range is cleared. jsEvent is the pointer/touch UIEvent, or null when it was cleared programmatically (e.g. clearSelection). | | loading | FullCalendarLoading | Fired when the calendar begins or finishes loading events. It fires only while FullCalendar fetches an event source itself (a URL/JSON feed or a function source); with only the events array bound it never fires (see Gotchas). | | eventsSet | FullCalendarEventsSet | Fired after the set of rendered events changes — the normalized current event set, for persistence/sync consumers. |

Imperative handle

Beyond props/events, the component exposes imperative methods (declared once in the Rozie source via $expose). Grab a handle with the native ref mechanism and call them directly:

import { useRef } from 'react';
import { FullCalendar, type FullCalendarHandle } from '@rozie-ui/fullcalendar-react';

const cal = useRef<FullCalendarHandle>(null);
// <FullCalendar ref={cal} ... />
cal.current?.next();
const api = cal.current?.getApi();

| Method | Description | | --- | --- | | getApi | Return the underlying FullCalendar Calendar instance for direct API access. | | changeView | Switch the active view — changeView(viewName, dateOrRange?). | | addEvent | Add an event — addEvent(eventInput, source?). | | removeEvent | Remove an event by id — removeEvent(id). | | today | Navigate to today. | | prev | Navigate to the previous date range. | | next | Navigate to the next date range. | | gotoDate | Navigate to a specific date — gotoDate(date). | | getDate | Return the calendar’s current anchor Date (the view model carries only the view type). null before mount. | | getEvents | Return all current events as an EventApi[] (synchronous read; eventsSet is push-only). [] before mount. | | scrollToTime | Scroll a timeGrid view to a time of day — scrollToTime(duration) (e.g. "09:00"). | | updateSize | Force a relayout after the container resized outside FullCalendar’s knowledge (tab reveal, sidebar collapse). | | prevYear | Navigate to the previous year. | | nextYear | Navigate to the next year. | | selectRange | Programmatically select a date/time range — selectRange(dateOrObj, endDate?) (CalendarApi.select). | | clearSelection | Clear the current selection (CalendarApi.unselect). |

Slots

| Slot | Params | Bind as | | --- | --- | --- | | event | arg | renderEvent={({ arg }) => …} | | dayCell | arg | renderDayCell={({ arg }) => …} | | dayHeader | arg | renderDayHeader={({ arg }) => …} | | slotLabel | arg | renderSlotLabel={({ arg }) => …} | | weekNumber | arg | renderWeekNumber={({ arg }) => …} | | nowIndicatorContent | arg | renderNowIndicatorContent={({ arg }) => …} | | moreLink | arg | renderMoreLink={({ arg }) => …} | | allDayContent | arg | renderAllDayContent={({ arg }) => …} | | slotLaneContent | arg | renderSlotLaneContent={({ arg }) => …} | | noEventsContent | arg | renderNoEventsContent={({ arg }) => …} |

Gotchas

Events are keyboard-focusable. Whenever an eventClick handler is registered, FullCalendar makes every event interactive (tabindex="0", Enter/Space activation). This wrapper always registers one, because it powers the eventClick event. FullCalendar checks the eventInteractive option before it checks for handlers, so opt out with options={{ eventInteractive: false }}. A per-event interactive: false also works when the global option is unset.

loading fires only for fetched sources. It reflects event sources FullCalendar fetches itself (a URL/JSON feed or a function source). The events prop is always an in-memory array reconciled synchronously, so with events alone loading never fires; track your own fetch state instead. For FullCalendar-managed fetching, pass sources through options as eventSources: options={{ eventSources: [{ url: '/api/events' }] }}.

noEventsContent needs a list view. The slot renders only in list views, and the baked-in daygrid/timegrid/interaction plugins provide none. Recipe: npm i @fullcalendar/list, import listPlugin from '@fullcalendar/list', pass options={{ plugins: [listPlugin] }} (the plugins key merges with the baked-in defaults), and set view to listWeek, listDay or listMonth. The slot then renders when the list is empty.