@underverse-ui/underverse 0.2.103 → 0.2.104

package/dist/index.d.cts

@@ -1030,6 +1030,10 @@ interface CalendarTimelineVirtualization {
     enabled?: boolean;
     overscan?: number;
 }
+type CalendarTimelineColumnVirtualization = boolean | {
+    /** Extra slots rendered on each side. Default: 6 */
+    overscan?: number;
+};
 type CalendarTimelineAdaptiveSlotWidths = boolean | {
     /**
      * "shrink": empty slots get `emptySlotWidth`, event slots keep the fixed base width (default).
@@ -1040,6 +1044,17 @@ type CalendarTimelineAdaptiveSlotWidths = boolean | {
     emptySlotWidth?: number;
     /** Cap (px) for event slot width when `mode="redistribute"`. Default: `baseSlotWidth * 2.5`. */
     maxEventSlotWidth?: number;
+    /**
+     * Day view only: if enabled and the computed grid is narrower than the viewport, expand columns to fill the available width.
+     * Default: false.
+     */
+    fillContainer?: boolean;
+    /**
+     * Day view only (when `fillContainer`): where the extra width goes.
+     * - "event": distribute extra width to columns that have events (default)
+     * - "all": distribute extra width to all columns
+     */
+    fillDistribute?: "event" | "all";
 };
 interface CalendarTimelineProps<TResourceMeta = unknown, TEventMeta = unknown> extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onChange"> {
     resources: CalendarTimelineResource<TResourceMeta>[];
@@ -1138,6 +1153,24 @@ interface CalendarTimelineProps<TResourceMeta = unknown, TEventMeta = unknown> e
     /** Day view only (when `dayEventStyle="compact"`): max visual width (px). */
     dayEventMaxWidth?: number;
     dayTimeStepMinutes?: number;
+    /** Render tooltips on events (can be expensive for large datasets). Default: true. */
+    enableEventTooltips?: boolean;
+    /**
+     * Day view: header rendering mode.
+     * - "full": show every time slot label (default; matches legacy behavior)
+     * - "smart": show start/…/end markers to reduce clutter on dense timelines
+     */
+    dayHeaderMode?: "full" | "smart";
+    /**
+     * Day view: optionally compress empty time columns when `dayHeaderMode="smart"`.
+     * Default: false (keeps legacy column widths).
+     */
+    daySlotCompression?: boolean;
+    /**
+     * Day view only: virtualize columns in the header/overlay when there are many time slots (e.g. 5–15min step).
+     * Keeps scroll behavior the same but reduces DOM work.
+     */
+    columnVirtualization?: CalendarTimelineColumnVirtualization;
     /**
      * Day view horizontal range:
      * - "full": show 24h (default)
@@ -1209,7 +1242,7 @@ interface CalendarTimelineProps<TResourceMeta = unknown, TEventMeta = unknown> e
     virtualization?: CalendarTimelineVirtualization;
 }
 
-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, defaultResourceColumnWidth, onResourceColumnWidthChange, minResourceColumnWidth, maxResourceColumnWidth, rowHeight, defaultRowHeight, onRowHeightChange, minRowHeight, maxRowHeight, rowHeights, defaultRowHeights, onRowHeightsChange, autoRowHeight, enableLayoutResize, slotMinWidth, adaptiveSlotWidths, dayEventStyle, dayEventMaxWidth, dayTimeStepMinutes, dayRangeMode, workHours, maxLanesPerRow, now, renderResource, renderGroup, renderEvent, interactions, onRangeChange, onEventClick, onEventDoubleClick, onCreateEventClick, onCreateEvent, onEventMove, onEventResize, onEventDelete, 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, defaultResourceColumnWidth, onResourceColumnWidthChange, minResourceColumnWidth, maxResourceColumnWidth, rowHeight, defaultRowHeight, onRowHeightChange, minRowHeight, maxRowHeight, rowHeights, defaultRowHeights, onRowHeightsChange, autoRowHeight, enableLayoutResize, slotMinWidth, adaptiveSlotWidths, dayEventStyle, dayEventMaxWidth, dayTimeStepMinutes, enableEventTooltips, dayHeaderMode, daySlotCompression, columnVirtualization, dayRangeMode, workHours, maxLanesPerRow, now, renderResource, renderGroup, renderEvent, interactions, onRangeChange, onEventClick, onEventDoubleClick, onCreateEventClick, onCreateEvent, onEventMove, onEventResize, onEventDelete, onMoreClick, virtualization, className, ...rest }: CalendarTimelineProps<TResourceMeta, TEventMeta>): react_jsx_runtime.JSX.Element;
 
 type ComboboxOption = string | {
     label: string;

package/dist/index.d.ts

@@ -1030,6 +1030,10 @@ interface CalendarTimelineVirtualization {
     enabled?: boolean;
     overscan?: number;
 }
+type CalendarTimelineColumnVirtualization = boolean | {
+    /** Extra slots rendered on each side. Default: 6 */
+    overscan?: number;
+};
 type CalendarTimelineAdaptiveSlotWidths = boolean | {
     /**
      * "shrink": empty slots get `emptySlotWidth`, event slots keep the fixed base width (default).
@@ -1040,6 +1044,17 @@ type CalendarTimelineAdaptiveSlotWidths = boolean | {
     emptySlotWidth?: number;
     /** Cap (px) for event slot width when `mode="redistribute"`. Default: `baseSlotWidth * 2.5`. */
     maxEventSlotWidth?: number;
+    /**
+     * Day view only: if enabled and the computed grid is narrower than the viewport, expand columns to fill the available width.
+     * Default: false.
+     */
+    fillContainer?: boolean;
+    /**
+     * Day view only (when `fillContainer`): where the extra width goes.
+     * - "event": distribute extra width to columns that have events (default)
+     * - "all": distribute extra width to all columns
+     */
+    fillDistribute?: "event" | "all";
 };
 interface CalendarTimelineProps<TResourceMeta = unknown, TEventMeta = unknown> extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onChange"> {
     resources: CalendarTimelineResource<TResourceMeta>[];
@@ -1138,6 +1153,24 @@ interface CalendarTimelineProps<TResourceMeta = unknown, TEventMeta = unknown> e
     /** Day view only (when `dayEventStyle="compact"`): max visual width (px). */
     dayEventMaxWidth?: number;
     dayTimeStepMinutes?: number;
+    /** Render tooltips on events (can be expensive for large datasets). Default: true. */
+    enableEventTooltips?: boolean;
+    /**
+     * Day view: header rendering mode.
+     * - "full": show every time slot label (default; matches legacy behavior)
+     * - "smart": show start/…/end markers to reduce clutter on dense timelines
+     */
+    dayHeaderMode?: "full" | "smart";
+    /**
+     * Day view: optionally compress empty time columns when `dayHeaderMode="smart"`.
+     * Default: false (keeps legacy column widths).
+     */
+    daySlotCompression?: boolean;
+    /**
+     * Day view only: virtualize columns in the header/overlay when there are many time slots (e.g. 5–15min step).
+     * Keeps scroll behavior the same but reduces DOM work.
+     */
+    columnVirtualization?: CalendarTimelineColumnVirtualization;
     /**
      * Day view horizontal range:
      * - "full": show 24h (default)
@@ -1209,7 +1242,7 @@ interface CalendarTimelineProps<TResourceMeta = unknown, TEventMeta = unknown> e
     virtualization?: CalendarTimelineVirtualization;
 }
 
-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, defaultResourceColumnWidth, onResourceColumnWidthChange, minResourceColumnWidth, maxResourceColumnWidth, rowHeight, defaultRowHeight, onRowHeightChange, minRowHeight, maxRowHeight, rowHeights, defaultRowHeights, onRowHeightsChange, autoRowHeight, enableLayoutResize, slotMinWidth, adaptiveSlotWidths, dayEventStyle, dayEventMaxWidth, dayTimeStepMinutes, dayRangeMode, workHours, maxLanesPerRow, now, renderResource, renderGroup, renderEvent, interactions, onRangeChange, onEventClick, onEventDoubleClick, onCreateEventClick, onCreateEvent, onEventMove, onEventResize, onEventDelete, 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, defaultResourceColumnWidth, onResourceColumnWidthChange, minResourceColumnWidth, maxResourceColumnWidth, rowHeight, defaultRowHeight, onRowHeightChange, minRowHeight, maxRowHeight, rowHeights, defaultRowHeights, onRowHeightsChange, autoRowHeight, enableLayoutResize, slotMinWidth, adaptiveSlotWidths, dayEventStyle, dayEventMaxWidth, dayTimeStepMinutes, enableEventTooltips, dayHeaderMode, daySlotCompression, columnVirtualization, dayRangeMode, workHours, maxLanesPerRow, now, renderResource, renderGroup, renderEvent, interactions, onRangeChange, onEventClick, onEventDoubleClick, onCreateEventClick, onCreateEvent, onEventMove, onEventResize, onEventDelete, onMoreClick, virtualization, className, ...rest }: CalendarTimelineProps<TResourceMeta, TEventMeta>): react_jsx_runtime.JSX.Element;
 
 type ComboboxOption = string | {
     label: string;