@underverse-ui/underverse 0.2.88 → 0.2.89

package/dist/index.d.cts

@@ -904,6 +904,7 @@ declare function Calendar({ month, defaultMonth, onMonthChange, value, defaultVa
 type CalendarTimelineView = "month" | "week" | "day";
 type CalendarTimelineDateInput = Date | string | number;
 type CalendarTimelineSize = "sm" | "md" | "xl";
+type CalendarTimelineSheetSize = "sm" | "md" | "lg" | "xl" | "full";
 interface CalendarTimelineGroup {
     id: string;
     label: React$1.ReactNode;
@@ -980,6 +981,26 @@ interface CalendarTimelineProps<TResourceMeta = unknown, TEventMeta = unknown> e
     resources: CalendarTimelineResource<TResourceMeta>[];
     events: CalendarTimelineEvent<TEventMeta>[];
     size?: CalendarTimelineSize;
+    /**
+     * Enable the built-in right-side event details sheet on click.
+     * If `renderEventSheet` is provided, this defaults to enabled.
+     */
+    enableEventSheet?: boolean;
+    eventSheetSize?: CalendarTimelineSheetSize;
+    renderEventSheet?: (args: {
+        event: CalendarTimelineEvent<TEventMeta>;
+        resource?: CalendarTimelineResource<TResourceMeta>;
+        close: () => void;
+        locale: string;
+        timeZone: string;
+        view: CalendarTimelineView;
+    }) => React$1.ReactNode;
+    selectedEventId?: string | null;
+    defaultSelectedEventId?: string | null;
+    onSelectedEventIdChange?: (eventId: string | null) => void;
+    eventSheetOpen?: boolean;
+    defaultEventSheetOpen?: boolean;
+    onEventSheetOpenChange?: (open: boolean) => void;
     view?: CalendarTimelineView;
     defaultView?: CalendarTimelineView;
     onViewChange?: (view: CalendarTimelineView) => void;
@@ -1041,7 +1062,7 @@ interface CalendarTimelineProps<TResourceMeta = unknown, TEventMeta = unknown> e
     virtualization?: CalendarTimelineVirtualization;
 }
 
-declare function CalendarTimeline<TResourceMeta = unknown, TEventMeta = unknown>({ resources, events, size, view, defaultView, onViewChange, date, defaultDate, onDateChange, weekStartsOn, locale, timeZone, labels, formatters, groups, groupCollapsed, defaultGroupCollapsed, onGroupCollapsedChange, resourceColumnWidth, rowHeight, slotMinWidth, dayTimeStepMinutes, maxLanesPerRow, now, renderResource, renderGroup, renderEvent, interactions, onRangeChange, onEventClick, onEventDoubleClick, onCreateEvent, onEventMove, onEventResize, onMoreClick, virtualization, className, ...rest }: CalendarTimelineProps<TResourceMeta, TEventMeta>): react_jsx_runtime.JSX.Element;
+declare function CalendarTimeline<TResourceMeta = unknown, TEventMeta = unknown>({ resources, events, size, enableEventSheet, eventSheetSize, renderEventSheet, selectedEventId, defaultSelectedEventId, onSelectedEventIdChange, eventSheetOpen, defaultEventSheetOpen, onEventSheetOpenChange, view, defaultView, onViewChange, date, defaultDate, onDateChange, weekStartsOn, locale, timeZone, labels, formatters, groups, groupCollapsed, defaultGroupCollapsed, onGroupCollapsedChange, resourceColumnWidth, rowHeight, slotMinWidth, dayTimeStepMinutes, maxLanesPerRow, now, renderResource, renderGroup, renderEvent, interactions, onRangeChange, onEventClick, onEventDoubleClick, onCreateEvent, onEventMove, onEventResize, onMoreClick, virtualization, className, ...rest }: CalendarTimelineProps<TResourceMeta, TEventMeta>): react_jsx_runtime.JSX.Element;
 
 type ComboboxOption = string | {
     label: string;

package/dist/index.d.ts

@@ -904,6 +904,7 @@ declare function Calendar({ month, defaultMonth, onMonthChange, value, defaultVa
 type CalendarTimelineView = "month" | "week" | "day";
 type CalendarTimelineDateInput = Date | string | number;
 type CalendarTimelineSize = "sm" | "md" | "xl";
+type CalendarTimelineSheetSize = "sm" | "md" | "lg" | "xl" | "full";
 interface CalendarTimelineGroup {
     id: string;
     label: React$1.ReactNode;
@@ -980,6 +981,26 @@ interface CalendarTimelineProps<TResourceMeta = unknown, TEventMeta = unknown> e
     resources: CalendarTimelineResource<TResourceMeta>[];
     events: CalendarTimelineEvent<TEventMeta>[];
     size?: CalendarTimelineSize;
+    /**
+     * Enable the built-in right-side event details sheet on click.
+     * If `renderEventSheet` is provided, this defaults to enabled.
+     */
+    enableEventSheet?: boolean;
+    eventSheetSize?: CalendarTimelineSheetSize;
+    renderEventSheet?: (args: {
+        event: CalendarTimelineEvent<TEventMeta>;
+        resource?: CalendarTimelineResource<TResourceMeta>;
+        close: () => void;
+        locale: string;
+        timeZone: string;
+        view: CalendarTimelineView;
+    }) => React$1.ReactNode;
+    selectedEventId?: string | null;
+    defaultSelectedEventId?: string | null;
+    onSelectedEventIdChange?: (eventId: string | null) => void;
+    eventSheetOpen?: boolean;
+    defaultEventSheetOpen?: boolean;
+    onEventSheetOpenChange?: (open: boolean) => void;
     view?: CalendarTimelineView;
     defaultView?: CalendarTimelineView;
     onViewChange?: (view: CalendarTimelineView) => void;
@@ -1041,7 +1062,7 @@ interface CalendarTimelineProps<TResourceMeta = unknown, TEventMeta = unknown> e
     virtualization?: CalendarTimelineVirtualization;
 }
 
-declare function CalendarTimeline<TResourceMeta = unknown, TEventMeta = unknown>({ resources, events, size, view, defaultView, onViewChange, date, defaultDate, onDateChange, weekStartsOn, locale, timeZone, labels, formatters, groups, groupCollapsed, defaultGroupCollapsed, onGroupCollapsedChange, resourceColumnWidth, rowHeight, slotMinWidth, dayTimeStepMinutes, maxLanesPerRow, now, renderResource, renderGroup, renderEvent, interactions, onRangeChange, onEventClick, onEventDoubleClick, onCreateEvent, onEventMove, onEventResize, onMoreClick, virtualization, className, ...rest }: CalendarTimelineProps<TResourceMeta, TEventMeta>): react_jsx_runtime.JSX.Element;
+declare function CalendarTimeline<TResourceMeta = unknown, TEventMeta = unknown>({ resources, events, size, enableEventSheet, eventSheetSize, renderEventSheet, selectedEventId, defaultSelectedEventId, onSelectedEventIdChange, eventSheetOpen, defaultEventSheetOpen, onEventSheetOpenChange, view, defaultView, onViewChange, date, defaultDate, onDateChange, weekStartsOn, locale, timeZone, labels, formatters, groups, groupCollapsed, defaultGroupCollapsed, onGroupCollapsedChange, resourceColumnWidth, rowHeight, slotMinWidth, dayTimeStepMinutes, maxLanesPerRow, now, renderResource, renderGroup, renderEvent, interactions, onRangeChange, onEventClick, onEventDoubleClick, onCreateEvent, onEventMove, onEventResize, onMoreClick, virtualization, className, ...rest }: CalendarTimelineProps<TResourceMeta, TEventMeta>): react_jsx_runtime.JSX.Element;
 
 type ComboboxOption = string | {
     label: string;

package/dist/index.js

@@ -7832,6 +7832,15 @@ function CalendarTimeline({
   resources,
   events,
   size = "md",
+  enableEventSheet,
+  eventSheetSize = "md",
+  renderEventSheet,
+  selectedEventId,
+  defaultSelectedEventId,
+  onSelectedEventIdChange,
+  eventSheetOpen,
+  defaultEventSheetOpen,
+  onEventSheetOpenChange,
   view,
   defaultView = "month",
   onViewChange,
@@ -7872,6 +7881,28 @@ function CalendarTimeline({
   const detectedLocale = useLocale();
   const resolvedLocale = React28.useMemo(() => localeToBCP47(locale ?? detectedLocale), [locale, detectedLocale]);
   const resolvedTimeZone = React28.useMemo(() => timeZone ?? Intl.DateTimeFormat().resolvedOptions().timeZone ?? "UTC", [timeZone]);
+  const effectiveEnableEventSheet = enableEventSheet ?? Boolean(renderEventSheet);
+  const isControlledSelectedEventId = selectedEventId !== void 0;
+  const [internalSelectedEventId, setInternalSelectedEventId] = React28.useState(defaultSelectedEventId ?? null);
+  const activeSelectedEventId = isControlledSelectedEventId ? selectedEventId : internalSelectedEventId;
+  const setSelectedEventId = React28.useCallback(
+    (next) => {
+      if (!isControlledSelectedEventId) setInternalSelectedEventId(next);
+      onSelectedEventIdChange?.(next);
+    },
+    [isControlledSelectedEventId, onSelectedEventIdChange]
+  );
+  const isControlledEventSheetOpen = eventSheetOpen !== void 0;
+  const [internalEventSheetOpen, setInternalEventSheetOpen] = React28.useState(defaultEventSheetOpen ?? false);
+  const activeEventSheetOpen = isControlledEventSheetOpen ? Boolean(eventSheetOpen) : internalEventSheetOpen;
+  const setEventSheetOpen = React28.useCallback(
+    (next) => {
+      if (!isControlledEventSheetOpen) setInternalEventSheetOpen(next);
+      onEventSheetOpenChange?.(next);
+      if (!next) setSelectedEventId(null);
+    },
+    [isControlledEventSheetOpen, onEventSheetOpenChange, setSelectedEventId]
+  );
   const sizeConfig = React28.useMemo(() => {
     const cfgBySize = {
       sm: {
@@ -8088,6 +8119,31 @@ function CalendarTimeline({
     for (const r of resources) map.set(r.id, r);
     return map;
   }, [resources]);
+  const selectedEvent = React28.useMemo(() => {
+    if (!activeSelectedEventId) return null;
+    const found = normalizedEvents.find((e) => e.id === activeSelectedEventId);
+    return found ?? null;
+  }, [activeSelectedEventId, normalizedEvents]);
+  const selectedResource = React28.useMemo(() => {
+    if (!selectedEvent) return void 0;
+    return resourceById.get(selectedEvent.resourceId);
+  }, [resourceById, selectedEvent]);
+  const selectedTimeText = React28.useMemo(() => {
+    if (!selectedEvent) return "";
+    return formatters?.eventTime?.({
+      start: selectedEvent._start,
+      end: selectedEvent._end,
+      locale: resolvedLocale,
+      timeZone: resolvedTimeZone,
+      view: activeView
+    }) ?? defaultEventTime({ start: selectedEvent._start, end: selectedEvent._end, locale: resolvedLocale, timeZone: resolvedTimeZone, view: activeView });
+  }, [activeView, formatters, resolvedLocale, resolvedTimeZone, selectedEvent]);
+  React28.useEffect(() => {
+    if (!effectiveEnableEventSheet) return;
+    if (activeEventSheetOpen && activeSelectedEventId && !selectedEvent) {
+      setEventSheetOpen(false);
+    }
+  }, [activeEventSheetOpen, activeSelectedEventId, effectiveEnableEventSheet, selectedEvent, setEventSheetOpen]);
   const leftRef = React28.useRef(null);
   const bodyRef = React28.useRef(null);
   const headerRef = React28.useRef(null);
@@ -8556,7 +8612,13 @@ function CalendarTimeline({
                               role: "button",
                               tabIndex: 0,
                               "aria-label": aria,
-                              onClick: () => onEventClick?.(ev),
+                              onClick: () => {
+                                onEventClick?.(ev);
+                                if (effectiveEnableEventSheet) {
+                                  setSelectedEventId(ev.id);
+                                  setEventSheetOpen(true);
+                                }
+                              },
                               onDoubleClick: () => onEventDoubleClick?.(ev),
                               onPointerDown: (e) => onPointerDownEvent(e, ev, "move"),
                               children: [
@@ -8622,7 +8684,35 @@ function CalendarTimeline({
               ]
             }
           )
-        ] })
+        ] }),
+        effectiveEnableEventSheet && selectedEvent ? /* @__PURE__ */ jsx33(
+          Sheet,
+          {
+            open: activeEventSheetOpen,
+            onOpenChange: setEventSheetOpen,
+            side: "right",
+            size: eventSheetSize,
+            title: selectedEvent.title ?? "Event",
+            description: selectedTimeText || void 0,
+            children: renderEventSheet ? renderEventSheet({
+              event: selectedEvent,
+              resource: selectedResource,
+              close: () => setEventSheetOpen(false),
+              locale: resolvedLocale,
+              timeZone: resolvedTimeZone,
+              view: activeView
+            }) : /* @__PURE__ */ jsxs28("div", { className: "space-y-3", children: [
+              selectedResource?.label ? /* @__PURE__ */ jsxs28("div", { children: [
+                /* @__PURE__ */ jsx33("div", { className: "text-xs text-muted-foreground", children: t("resourcesHeader") }),
+                /* @__PURE__ */ jsx33("div", { className: "font-medium", children: selectedResource.label })
+              ] }) : null,
+              /* @__PURE__ */ jsxs28("div", { children: [
+                /* @__PURE__ */ jsx33("div", { className: "text-xs text-muted-foreground", children: "ID" }),
+                /* @__PURE__ */ jsx33("div", { className: "font-mono text-xs break-all", children: selectedEvent.id })
+              ] })
+            ] })
+          }
+        ) : null
       ]
     }
   );