@mantine/schedule 9.3.1 → 9.4.0

package/lib/components/ResourcesWeekView/ResourcesWeekView.d.ts

@@ -0,0 +1,106 @@
+import { BoxProps, DataAttributes, ElementProps, Factory, MantineRadius, ScrollAreaProps, StylesApiProps } from '@mantine/core';
+import { ScheduleLabelsOverride } from '../../labels';
+import { DateLabelFormat, DateStringValue, DateTimeStringValue, DayOfWeek, ScheduleEventData, ScheduleMode, ScheduleResourceData, ScheduleResourceGroup, ScheduleViewLevel } from '../../types';
+import { MoreEventsProps, MoreEventsStylesNames } from '../MoreEvents/MoreEvents';
+import { RenderEvent, RenderEventBody } from '../ScheduleEvent/ScheduleEvent';
+import { CombinedScheduleHeaderStylesNames } from '../ScheduleHeader/ScheduleHeader';
+import { ViewSelectProps } from '../ScheduleHeader/ViewSelect/ViewSelect';
+export type ResourcesWeekViewStylesNames = 'resourcesWeekView' | 'resourcesWeekViewRoot' | 'resourcesWeekViewInner' | 'resourcesWeekViewHeaderRows' | 'resourcesWeekViewHeaderContent' | 'resourcesWeekViewDayLabelsRow' | 'resourcesWeekViewDayLabel' | 'resourcesWeekViewTimeLabelsRow' | 'resourcesWeekViewScrollArea' | 'resourcesWeekViewCorner' | 'resourcesWeekViewTimeLabel' | 'resourcesWeekViewResourceLabel' | 'resourcesWeekViewRow' | 'resourcesWeekViewRowSlot' | 'resourcesWeekViewRowSlots' | 'resourcesWeekViewBackgroundEvent' | 'resourcesWeekViewAllDayEvent' | 'resourcesWeekViewCurrentTimeIndicator' | 'resourcesWeekViewCurrentTimeIndicatorLine' | 'resourcesWeekViewCurrentTimeIndicatorThumb' | 'resourcesWeekViewCurrentTimeIndicatorTimeBubble' | 'resourcesWeekViewEventWrapper' | 'resourcesWeekViewResizeHandle' | 'resourcesWeekViewGroupColumn' | 'resourcesWeekViewGroupColumnEmpty' | MoreEventsStylesNames | CombinedScheduleHeaderStylesNames;
+export type ResourcesWeekViewCssVariables = {
+    resourcesWeekView: '--resources-week-view-radius' | '--resources-week-view-slot-width' | '--resources-week-view-row-height' | '--resources-week-view-group-label-width';
+};
+export interface ResourcesWeekViewProps extends BoxProps, StylesApiProps<ResourcesWeekViewFactory>, ElementProps<'div'> {
+    __staticSelector?: string;
+    date: Date | string;
+    onDateChange?: (value: DateStringValue) => void;
+    resources: ScheduleResourceData[];
+    startTime?: string;
+    endTime?: string;
+    intervalMinutes?: number;
+    slotLabelFormat?: DateLabelFormat;
+    radius?: MantineRadius;
+    /** Date and time to scroll to on initial render, in `YYYY-MM-DD HH:mm:ss` format */
+    startScrollDateTime?: string;
+    scrollAreaProps?: Partial<ScrollAreaProps> & DataAttributes;
+    locale?: string;
+    withCurrentTimeIndicator?: boolean;
+    withCurrentTimeBubble?: boolean;
+    withHeader?: boolean;
+    onViewChange?: (view: ScheduleViewLevel) => void;
+    previousControlProps?: React.ComponentProps<'button'> & DataAttributes;
+    nextControlProps?: React.ComponentProps<'button'> & DataAttributes;
+    todayControlProps?: React.ComponentProps<'button'> & DataAttributes;
+    viewSelectProps?: Partial<ViewSelectProps> & DataAttributes;
+    weekLabelFormat?: DateLabelFormat;
+    renderWeekLabel?: (params: {
+        weekStart: DateStringValue;
+        weekEnd: DateStringValue;
+    }) => React.ReactNode;
+    events?: ScheduleEventData[];
+    slotWidth?: React.CSSProperties['width'];
+    rowHeight?: React.CSSProperties['height'];
+    labels?: ScheduleLabelsOverride;
+    highlightBusinessHours?: boolean;
+    businessHours?: [string, string];
+    renderEventBody?: RenderEventBody;
+    renderEvent?: RenderEvent;
+    renderResourceLabel?: (resource: ScheduleResourceData) => React.ReactNode;
+    /** List of resource groups to display as a column to the left of resource labels */
+    groups?: ScheduleResourceGroup[];
+    /** Function to customize group label rendering */
+    renderGroupLabel?: (group: ScheduleResourceGroup) => React.ReactNode;
+    /** Width of the group label column @default 80px */
+    groupLabelWidth?: React.CSSProperties['width'];
+    withEventsDragAndDrop?: boolean;
+    onEventDrop?: (data: {
+        eventId: string | number;
+        newStart: DateTimeStringValue;
+        newEnd: DateTimeStringValue;
+        event: ScheduleEventData;
+        resourceId?: string | number;
+    }) => void;
+    canDragEvent?: (event: ScheduleEventData) => boolean;
+    onEventDragStart?: (event: ScheduleEventData) => void;
+    onEventDragEnd?: () => void;
+    onTimeSlotClick?: (data: {
+        slotStart: DateTimeStringValue;
+        slotEnd: DateTimeStringValue;
+        nativeEvent: React.MouseEvent<HTMLButtonElement>;
+        resourceId?: string | number;
+    }) => void;
+    onEventClick?: (event: ScheduleEventData, e: React.MouseEvent<HTMLButtonElement>) => void;
+    withDragSlotSelect?: boolean;
+    onSlotDragEnd?: (data: {
+        rangeStart: DateTimeStringValue;
+        rangeEnd: DateTimeStringValue;
+        resourceId?: string | number;
+    }) => void;
+    mode?: ScheduleMode;
+    onExternalEventDrop?: (data: {
+        dataTransfer: DataTransfer;
+        dropDateTime: DateTimeStringValue;
+        resourceId?: string | number;
+    }) => void;
+    recurrenceExpansionLimit?: number;
+    /** Maximum number of events visible per time slot before "+more" indicator shows, minimum value is 1 @default 2 */
+    maxEventsPerTimeSlot?: number;
+    /** Props passed down to `MoreEvents` component */
+    moreEventsProps?: Partial<MoreEventsProps>;
+    firstDayOfWeek?: DayOfWeek;
+    weekendDays?: DayOfWeek[];
+    withWeekendDays?: boolean;
+    weekdayFormat?: DateLabelFormat;
+    highlightToday?: boolean;
+}
+export type ResourcesWeekViewFactory = Factory<{
+    props: ResourcesWeekViewProps;
+    ref: HTMLDivElement;
+    stylesNames: ResourcesWeekViewStylesNames;
+    vars: ResourcesWeekViewCssVariables;
+}>;
+export declare const ResourcesWeekView: import("@mantine/core").MantineComponent<{
+    props: ResourcesWeekViewProps;
+    ref: HTMLDivElement;
+    stylesNames: ResourcesWeekViewStylesNames;
+    vars: ResourcesWeekViewCssVariables;
+}>;

package/lib/components/ResourcesWeekView/ResourcesWeekViewRow.d.ts

@@ -0,0 +1,39 @@
+import { GetStylesApi } from '@mantine/core';
+import { ScheduleLabelsOverride } from '../../labels';
+import { ScheduleMode, ScheduleResourceData, ScheduleResourceGroup } from '../../types';
+import { DayTimeInterval, ResourceGroupInfo, ResourcesGridControlsRef } from '../../utils';
+import type { ResourcesWeekViewFactory } from './ResourcesWeekView';
+export interface ResourcesWeekViewRowProps {
+    resource: ScheduleResourceData;
+    resourceIndex: number;
+    weekdays: string[];
+    slots: DayTimeInterval[];
+    getStyles: GetStylesApi<ResourcesWeekViewFactory>;
+    children?: React.ReactNode;
+    labels?: ScheduleLabelsOverride;
+    highlightBusinessHours?: boolean;
+    businessHours?: [string, string];
+    withEventsDragAndDrop?: boolean;
+    onRowSlotsDragOver?: (e: React.DragEvent<HTMLDivElement>, resourceId: string | number, resourceIndex: number) => void;
+    onRowSlotsDragLeave?: () => void;
+    onRowSlotsDrop?: (e: React.DragEvent<HTMLDivElement>, resourceId: string | number, resourceIndex: number) => void;
+    onSlotClick?: (resourceId: string | number, day: string, slotTime: string, event: React.MouseEvent<HTMLButtonElement>) => void;
+    dropTargetSlotIndex?: number;
+    mode?: ScheduleMode;
+    slotsRef?: ResourcesGridControlsRef;
+    firstSlotIndex?: {
+        resourceIndex: number;
+        slotIndex: number;
+    };
+    onSlotKeyDown?: (event: React.KeyboardEvent<HTMLButtonElement>, resourceIndex: number, slotIndex: number) => void;
+    withDragSlotSelect?: boolean;
+    onSlotPointerDown?: (event: React.PointerEvent<HTMLButtonElement>, index: number, group: string) => void;
+    isSlotDragSelected?: (index: number, group: string) => boolean;
+    rowSlotsContainerRef?: (node: HTMLDivElement | null) => void;
+    renderResourceLabel?: (resource: ScheduleResourceData) => React.ReactNode;
+    renderGroupLabel?: (group: ScheduleResourceGroup) => React.ReactNode;
+    scrolledX?: boolean;
+    groupInfo?: ResourceGroupInfo | null;
+    allDayCount?: number;
+}
+export declare function ResourcesWeekViewRow({ resource, resourceIndex, weekdays, slots, getStyles, children, labels, highlightBusinessHours, businessHours, withEventsDragAndDrop, onRowSlotsDragOver, onRowSlotsDragLeave, onRowSlotsDrop, onSlotClick, dropTargetSlotIndex, mode, slotsRef, firstSlotIndex, onSlotKeyDown, withDragSlotSelect, onSlotPointerDown, isSlotDragSelected, rowSlotsContainerRef, renderResourceLabel, renderGroupLabel, scrolledX, groupInfo, allDayCount, }: ResourcesWeekViewRowProps): import("react/jsx-runtime").JSX.Element;

package/lib/components/ResourcesWeekView/get-resources-week-view-events/get-resources-week-view-events.d.ts

@@ -0,0 +1,29 @@
+import { ScheduleEventData, ScheduleResourceData } from '../../../types';
+import { ResourcesDayViewEventsResult } from '../../ResourcesDayView/get-resources-day-view-events/get-resources-day-view-events';
+/** A single all-day bar (single-day all-day event or a multi-day event) spanning one or more
+ * consecutive visible weekdays, placed on a shared row so overlapping bars do not collide. */
+export interface ResourcesWeekViewAllDayBar {
+    /** The original event, with its declared start/end preserved for display and interaction */
+    event: ScheduleEventData;
+    /** Index of the first visible weekday the bar covers */
+    startDayIndex: number;
+    /** Index of the last visible weekday the bar covers */
+    endDayIndex: number;
+    /** Row within the all-day band, assigned so overlapping bars stack instead of overlapping */
+    row: number;
+}
+export interface ResourcesWeekViewEventsResult {
+    byDay: Record<string, ResourcesDayViewEventsResult>;
+    /** All-day bars per resource, each spanning the days it covers as a single continuous bar */
+    allDayBars: Record<string | number, ResourcesWeekViewAllDayBar[]>;
+}
+interface GetResourcesWeekViewEventsInput {
+    events: ScheduleEventData[] | undefined;
+    resources: ScheduleResourceData[];
+    weekdays: string[];
+    startTime?: string;
+    endTime?: string;
+    expansionLimit?: number;
+}
+export declare function getResourcesWeekViewEvents({ events, resources, weekdays, startTime, endTime, expansionLimit, }: GetResourcesWeekViewEventsInput): ResourcesWeekViewEventsResult;
+export {};

package/lib/components/ResourcesWeekView/index.d.ts

@@ -0,0 +1,3 @@
+import type { ResourcesWeekViewCssVariables, ResourcesWeekViewFactory, ResourcesWeekViewProps, ResourcesWeekViewStylesNames } from './ResourcesWeekView';
+export { ResourcesWeekView } from './ResourcesWeekView';
+export type { ResourcesWeekViewProps, ResourcesWeekViewFactory, ResourcesWeekViewStylesNames, ResourcesWeekViewCssVariables, };

package/lib/components/Schedule/Schedule.d.ts

@@ -9,7 +9,7 @@ import { WeekViewProps, WeekViewStylesNames } from '../WeekView/WeekView';
 import { YearViewProps, YearViewStylesNames } from '../YearView/YearView';
 export type ScheduleStylesNames = 'root' | 'desktopView' | 'mobileView' | DayViewStylesNames | WeekViewStylesNames | MonthViewStylesNames | YearViewStylesNames | MobileMonthViewStylesNames;
 export type ScheduleLayout = 'default' | 'responsive';
-type ScheduleCommonProps = 'date' | 'onDateChange' | 'events' | 'locale' | 'radius' | 'labels' | 'renderEventBody' | 'withEventsDragAndDrop' | 'onEventDrop' | 'canDragEvent' | 'onEventDragStart' | 'onEventDragEnd' | 'onTimeSlotClick' | 'onAllDaySlotClick' | 'onEventClick' | 'onDayClick' | 'onMonthClick' | 'withDragSlotSelect' | 'onSlotDragEnd' | 'view' | 'onViewChange' | 'mode' | 'onExternalEventDrop' | 'withEventResize' | 'onEventResize' | 'canResizeEvent' | 'recurrenceExpansionLimit';
+type ScheduleCommonProps = 'date' | 'onDateChange' | 'events' | 'locale' | 'radius' | 'labels' | 'renderEventBody' | 'withEventsDragAndDrop' | 'onEventDrop' | 'canDragEvent' | 'onEventDragStart' | 'onEventDragEnd' | 'onTimeSlotClick' | 'onAllDaySlotClick' | 'onEventClick' | 'onDayClick' | 'onMonthClick' | 'withDragSlotSelect' | 'onSlotDragEnd' | 'view' | 'onViewChange' | 'mode' | 'withAgenda' | 'onExternalEventDrop' | 'withEventResize' | 'onEventResize' | 'canResizeEvent' | 'recurrenceExpansionLimit';
 type ScheduleViewProps<T> = Partial<Omit<T, ScheduleCommonProps>>;
 export interface ScheduleProps extends BoxProps, StylesApiProps<ScheduleFactory>, ElementProps<'div'> {
     __staticSelector?: string;
@@ -101,6 +101,8 @@ export interface ScheduleProps extends BoxProps, StylesApiProps<ScheduleFactory>
     yearViewProps?: ScheduleViewProps<YearViewProps>;
     /** Props specific to MobileMonthView (used in responsive layout) */
     mobileMonthViewProps?: ScheduleViewProps<MobileMonthViewProps>;
+    /** If set, displays an Agenda button in the header of DayView, WeekView and MonthView @default false */
+    withAgenda?: boolean;
 }
 export type ScheduleFactory = Factory<{
     props: ScheduleProps;

package/lib/components/ScheduleHeader/ScheduleHeaderBase.d.ts

@@ -48,6 +48,10 @@ export interface ScheduleHeaderBaseProps {
     viewSelectProps?: Partial<ViewSelectProps>;
     /** Styles API props to pass through */
     stylesApiProps?: StylesApiProps<any>;
+    /** Called when agenda button is clicked */
+    onAgendaClick?: () => void;
+    /** Whether the agenda view is currently active */
+    agendaActive?: boolean;
 }
-export declare function ScheduleHeaderBase({ view, navigationHandlers, control, labels, onDateChange, onViewChange, previousControlProps, nextControlProps, todayControlProps, viewSelectProps, stylesApiProps, }: ScheduleHeaderBaseProps): import("react/jsx-runtime").JSX.Element;
+export declare function ScheduleHeaderBase({ view, navigationHandlers, control, labels, onDateChange, onViewChange, previousControlProps, nextControlProps, todayControlProps, viewSelectProps, stylesApiProps, onAgendaClick, agendaActive, }: ScheduleHeaderBaseProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/lib/components/WeekView/WeekView.d.ts

@@ -2,11 +2,12 @@ import { BoxProps, DataAttributes, ElementProps, Factory, MantineRadius, ScrollA
 import { ScheduleLabelsOverride } from '../../labels';
 import { AnyDateValue, DateLabelFormat, DateStringValue, DateTimeStringValue, DayOfWeek, ScheduleEventData, ScheduleMode, ScheduleViewLevel } from '../../types';
 import { BusinessHoursValue } from '../../utils';
+import { AgendaViewStylesNames } from '../AgendaView/AgendaView';
 import { CurrentTimeIndicatorStylesNames } from '../CurrentTimeIndicator/CurrentTimeIndicator';
 import { RenderEvent, RenderEventBody } from '../ScheduleEvent/ScheduleEvent';
 import { CombinedScheduleHeaderStylesNames } from '../ScheduleHeader/ScheduleHeader';
 import { ViewSelectProps } from '../ScheduleHeader/ViewSelect/ViewSelect';
-export type WeekViewStylesNames = 'weekView' | 'weekViewRoot' | 'weekViewHeader' | 'weekViewInner' | 'weekViewAllDaySlotsEvents' | 'weekViewAllDaySlots' | 'weekViewAllDaySlotsList' | 'weekViewAllDaySlot' | 'weekViewAllDaySlotsLabel' | 'weekViewScrollArea' | 'weekViewCorner' | 'weekViewSlotLabels' | 'weekViewSlotLabel' | 'weekViewDayLabel' | 'weekViewDayWeekday' | 'weekViewDay' | 'weekViewDayNumber' | 'weekViewDaySlot' | 'weekViewDaySlots' | 'weekViewWeekLabel' | 'weekViewWeekNumber' | 'weekViewBackgroundEvent' | CurrentTimeIndicatorStylesNames | CombinedScheduleHeaderStylesNames;
+export type WeekViewStylesNames = 'weekView' | 'weekViewRoot' | 'weekViewHeader' | 'weekViewInner' | 'weekViewAllDaySlotsEvents' | 'weekViewAllDaySlots' | 'weekViewAllDaySlotsList' | 'weekViewAllDaySlot' | 'weekViewAllDaySlotsLabel' | 'weekViewScrollArea' | 'weekViewCorner' | 'weekViewSlotLabels' | 'weekViewSlotLabel' | 'weekViewDayLabel' | 'weekViewDayWeekday' | 'weekViewDay' | 'weekViewDayNumber' | 'weekViewDaySlot' | 'weekViewDaySlots' | 'weekViewWeekLabel' | 'weekViewWeekNumber' | 'weekViewBackgroundEvent' | CurrentTimeIndicatorStylesNames | CombinedScheduleHeaderStylesNames | AgendaViewStylesNames;
 export type WeekViewCssVariables = {
     weekView: '--week-view-radius' | '--week-view-slot-height' | '--week-view-all-day-slots-height';
 };
@@ -22,6 +23,8 @@ export interface WeekViewProps extends BoxProps, StylesApiProps<WeekViewFactory>
     endTime?: string;
     /** Number of minutes for each interval in the day view @default 60 */
     intervalMinutes?: number;
+    /** If set, grid lines are displayed for intervals smaller than one hour, for example 15 and 30 minutes intervals @default true */
+    withSubHourGridLines?: boolean;
     /** Dayjs format for slot labels or a callback function that returns formatted value @default HH:mm  */
     slotLabelFormat?: DateLabelFormat;
     /** Number 0-6, where 0 – Sunday and 6 – Saturday. @default 1 – Monday */
@@ -140,6 +143,8 @@ export interface WeekViewProps extends BoxProps, StylesApiProps<WeekViewFactory>
         start: DateTimeStringValue;
         end: DateTimeStringValue;
     }) => Record<string, any> | undefined;
+    /** If set, displays an Agenda button in the header that opens an agenda list view @default false */
+    withAgenda?: boolean;
 }
 export type WeekViewFactory = Factory<{
     props: WeekViewProps;

package/lib/components/WeekView/WeekViewDay.d.ts

@@ -11,6 +11,8 @@ export interface WeekViewDayProps {
     dayIndex: number;
     /** Slots intervals */
     slots: DayTimeInterval[];
+    /** Number of minutes for each interval, used to calculate slot height */
+    intervalMinutes: number;
     /** `useStyles` return value of `WeekView` */
     getStyles: GetStylesApi<WeekViewFactory>;
     /** Indices of weekend days, 0-6, where 0 is Sunday and 6 is Saturday. The default value is defined by `DatesProvider`. */
@@ -62,4 +64,4 @@ export interface WeekViewDayProps {
         end: DateTimeStringValue;
     }) => Record<string, any> | undefined;
 }
-export declare function WeekViewDay({ day, dayIndex, slots, getStyles, weekendDays, children, labels, highlightBusinessHours, businessHours, withEventsDragAndDrop, onDaySlotsDragOver, onDaySlotsDragLeave, onDaySlotsDrop, onSlotClick, dropTargetSlotIndex, mode, slotsRef, firstSlotIndex, onSlotKeyDown, onFirstSlotArrowUp, withDragSlotSelect, onSlotPointerDown, isSlotDragSelected, daySlotsContainerRef, getTimeSlotProps, }: WeekViewDayProps): import("react/jsx-runtime").JSX.Element;
+export declare function WeekViewDay({ day, dayIndex, slots, intervalMinutes, getStyles, weekendDays, children, labels, highlightBusinessHours, businessHours, withEventsDragAndDrop, onDaySlotsDragOver, onDaySlotsDragLeave, onDaySlotsDrop, onSlotClick, dropTargetSlotIndex, mode, slotsRef, firstSlotIndex, onSlotKeyDown, onFirstSlotArrowUp, withDragSlotSelect, onSlotPointerDown, isSlotDragSelected, daySlotsContainerRef, getTimeSlotProps, }: WeekViewDayProps): import("react/jsx-runtime").JSX.Element;

package/lib/hooks/use-horizontal-event-resize.d.ts

@@ -0,0 +1,37 @@
+import { DateTimeStringValue, ScheduleEventData, ScheduleMode } from '../types';
+type ResizeEdge = 'start' | 'end';
+export interface UseHorizontalEventResizeInput {
+    enabled?: boolean;
+    mode?: ScheduleMode;
+    startTime: string;
+    endTime: string;
+    intervalMinutes: number;
+    onEventResize?: (data: {
+        eventId: string | number;
+        newStart: DateTimeStringValue;
+        newEnd: DateTimeStringValue;
+        event: ScheduleEventData;
+    }) => void;
+    canResizeEvent?: (event: ScheduleEventData) => boolean;
+}
+export declare function useHorizontalEventResize({ enabled, mode, startTime, endTime, intervalMinutes, onEventResize, canResizeEvent, }: UseHorizontalEventResizeInput): {
+    handleResizeStart: ({ event, edge, container, originalLeft, originalWidth, eventDate, pointerEvent, }: {
+        event: ScheduleEventData;
+        edge: ResizeEdge;
+        container: HTMLElement;
+        originalLeft: number;
+        originalWidth: number;
+        eventDate: string;
+        pointerEvent: React.PointerEvent;
+    }) => void;
+    isResizing: boolean;
+    resizingEventId: string | number | null;
+    resizingEdge: ResizeEdge | null;
+    getResizePosition: (eventId: string | number) => {
+        left: number;
+        width: number;
+    } | null;
+    isResizableEvent: (event: ScheduleEventData) => boolean;
+    wasResizing: () => boolean;
+};
+export {};

package/lib/index.d.mts

@@ -7,6 +7,11 @@ export * from './components/DayView';
 export * from './components/WeekView';
 export * from './components/MonthView';
 export * from './components/YearView';
+export * from './components/ResourcesDayView';
+export * from './components/ResourcesWeekView';
+export * from './components/ResourcesMonthView';
+export * from './components/ResourcesSchedule';
+export * from './components/AgendaView';
 export * from './components/ScheduleEvent';
 export * from './components/ScheduleHeader';
 export * from './components/CurrentTimeIndicator';

package/lib/index.d.ts

@@ -7,6 +7,11 @@ export * from './components/DayView';
 export * from './components/WeekView';
 export * from './components/MonthView';
 export * from './components/YearView';
+export * from './components/ResourcesDayView';
+export * from './components/ResourcesWeekView';
+export * from './components/ResourcesMonthView';
+export * from './components/ResourcesSchedule';
+export * from './components/AgendaView';
 export * from './components/ScheduleEvent';
 export * from './components/ScheduleHeader';
 export * from './components/CurrentTimeIndicator';

package/lib/labels.d.ts

@@ -19,6 +19,10 @@ export interface ScheduleLabels {
     viewSelectLabel: string;
     noEvents: string;
     moreLabel: (hiddenEventsCount: number) => string;
+    resource?: string;
+    resources?: string;
+    resourceSlot?: string;
+    agenda?: string;
 }
 export declare const DEFAULT_SCHEDULE_LABELS: ScheduleLabels;
 export type ScheduleLabelsOverride = Partial<ScheduleLabels>;

package/lib/types.d.ts

@@ -1,5 +1,23 @@
 import dayjs from 'dayjs';
 import { MantineColor } from '@mantine/core';
+/** Resource data object passed to resource view components */
+export interface ScheduleResourceData {
+    /** Unique resource identifier */
+    id: string | number;
+    /** Resource display label */
+    label: React.ReactNode;
+    /** Optional color for the resource */
+    color?: MantineColor;
+    /** Additional resource data, defined by the user, not used internally by the library */
+    payload?: Record<PropertyKey, any>;
+}
+/** Group definition for resource views, groups are displayed as a rowspan-style column */
+export interface ScheduleResourceGroup {
+    /** Group display label */
+    label: React.ReactNode;
+    /** Resource IDs that belong to this group */
+    resourceIds: (string | number)[];
+}
 /** Date value type used by internal package utils */
 export type AnyDateValue = DateStringValue | Date | dayjs.Dayjs;
 /** Date value used by all Mantine components, format: `YYYY-MM-DD` */
@@ -54,6 +72,8 @@ interface ScheduleEventBase<Payload extends EventPayload = EventPayload> {
     display?: 'default' | 'background';
     /** Additional event data, defined by the user, not used internally by the library */
     payload?: Payload;
+    /** Resource ID that this event belongs to, used by resource view components */
+    resourceId?: string | number;
 }
 /** One-off event without recurrence */
 export interface ScheduleSingleEventData<Payload extends EventPayload = EventPayload> extends ScheduleEventBase<Payload> {

package/lib/utils/get-group-to-resource-id-map/get-group-to-resource-id-map.d.ts

@@ -0,0 +1,3 @@
+import { ScheduleResourceData } from '../../types';
+/** Builds a map from a stringified resource id to its original id value */
+export declare function getGroupToResourceIdMap(resources: ScheduleResourceData[]): Map<string, string | number>;

package/lib/utils/get-index-from-drag-point/get-index-from-drag-point.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Finds the index of the element whose horizontal bounds contain `clientX`.
+ * When `clientX` falls outside every element, it clamps to the first or last
+ * element; returns `null` when no element matches and the row is empty.
+ */
+export declare function getIndexFromDragPoint(elements: (HTMLElement | null)[], clientX: number): number | null;

package/lib/utils/get-ordered-resources/get-ordered-resources.d.ts

@@ -0,0 +1,17 @@
+import { ScheduleResourceData, ScheduleResourceGroup } from '../../types';
+export interface GroupRange {
+    group: ScheduleResourceGroup;
+    startIndex: number;
+    count: number;
+}
+export interface ResourceGroupInfo {
+    group: ScheduleResourceGroup;
+    position: 'first' | 'middle' | 'last' | 'only';
+    count: number;
+}
+export interface OrderedResourcesResult {
+    orderedResources: ScheduleResourceData[];
+    groupRanges: GroupRange[];
+    resourceGroupMap: (ResourceGroupInfo | null)[];
+}
+export declare function getOrderedResources(resources: ScheduleResourceData[], groups: ScheduleResourceGroup[] | undefined): OrderedResourcesResult;

package/lib/utils/handle-resources-grid-key-down/handle-resources-grid-key-down.d.ts

@@ -0,0 +1,10 @@
+import { RefObject } from 'react';
+/** Reference to a 2D array of slot buttons: [resourceIndex][slotIndex] */
+export type ResourcesGridControlsRef = RefObject<HTMLButtonElement[][]>;
+export interface HandleResourcesGridKeyDownInput {
+    controlsRef: ResourcesGridControlsRef;
+    resourceIndex: number;
+    slotIndex: number;
+    event: React.KeyboardEvent<HTMLButtonElement>;
+}
+export declare function handleResourcesGridKeyDown({ controlsRef, resourceIndex, slotIndex, event, }: HandleResourcesGridKeyDownInput): void;

package/lib/utils/index.d.ts

@@ -39,3 +39,9 @@ export type { ParsedTime } from './parse-time-string/parse-time-string';
 export type { CalculateDropTimeInput, CalculateDropTimeResult, } from './calculate-drop-time/calculate-drop-time';
 export type { CalculateMonthDropDateInput, CalculateMonthDropDateResult, } from './calculate-month-drop-date/calculate-month-drop-date';
 export type { BusinessHoursMod, BusinessHoursPerDay, BusinessHoursRange, BusinessHoursValue, GetBusinessHoursModInput, } from './get-business-hours-mod/get-business-hours-mod';
+export { getOrderedResources } from './get-ordered-resources/get-ordered-resources';
+export type { GroupRange, OrderedResourcesResult, ResourceGroupInfo, } from './get-ordered-resources/get-ordered-resources';
+export { handleResourcesGridKeyDown } from './handle-resources-grid-key-down/handle-resources-grid-key-down';
+export type { HandleResourcesGridKeyDownInput, ResourcesGridControlsRef, } from './handle-resources-grid-key-down/handle-resources-grid-key-down';
+export { getGroupToResourceIdMap } from './get-group-to-resource-id-map/get-group-to-resource-id-map';
+export { getIndexFromDragPoint } from './get-index-from-drag-point/get-index-from-drag-point';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mantine/schedule",
-  "version": "9.3.1",
+  "version": "9.4.0",
   "description": "Schedule Mantine component",
   "homepage": "https://mantine.dev/",
   "license": "MIT",
@@ -35,9 +35,9 @@
     "directory": "packages/@mantine/schedule"
   },
   "peerDependencies": {
-    "@mantine/core": "9.3.1",
-    "@mantine/dates": "9.3.1",
-    "@mantine/hooks": "9.3.1",
+    "@mantine/core": "9.4.0",
+    "@mantine/dates": "9.4.0",
+    "@mantine/hooks": "9.4.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"
   },