@riverbankcms/sdk 0.135.1 → 0.136.0

package/dist/_dts/blocks/src/system/runtime/components/registry.client.d.ts

@@ -638,6 +638,14 @@ export declare const runtimeBackedBlockClientEntries: {
                     eventSurface: import("../..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("../..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../../../core/src/index").BookingTimeZone;
+                        initialToday: Readonly<{
+                            year: number;
+                            month: number;
+                            day: number;
+                        }>;
+                    }>;
                 }>;
             }>;
             contracts: Readonly<{
@@ -655,6 +663,14 @@ export declare const runtimeBackedBlockClientEntries: {
                             eventSurface: import("../..").EventSurfaceScope;
                             filterEventPresets: string | null;
                             scheduleScope: import("../..").EventScheduleScope;
+                            calendarContext: Readonly<{
+                                timeZone: import("../../../../../core/src/index").BookingTimeZone;
+                                initialToday: Readonly<{
+                                    year: number;
+                                    month: number;
+                                    day: number;
+                                }>;
+                            }>;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -666,6 +682,14 @@ export declare const runtimeBackedBlockClientEntries: {
                             eventSurface: import("../..").EventSurfaceScope;
                             filterEventPresets: string | null;
                             scheduleScope: import("../..").EventScheduleScope;
+                            calendarContext: Readonly<{
+                                timeZone: import("../../../../../core/src/index").BookingTimeZone;
+                                initialToday: Readonly<{
+                                    year: number;
+                                    month: number;
+                                    day: number;
+                                }>;
+                            }>;
                         }>;
                     }>>;
                 }>;
@@ -685,6 +709,14 @@ export declare const runtimeBackedBlockClientEntries: {
                         eventSurface: import("../..").EventSurfaceScope;
                         filterEventPresets: string | null;
                         scheduleScope: import("../..").EventScheduleScope;
+                        calendarContext: Readonly<{
+                            timeZone: import("../../../../../core/src/index").BookingTimeZone;
+                            initialToday: Readonly<{
+                                year: number;
+                                month: number;
+                                day: number;
+                            }>;
+                        }>;
                     }>;
                 }>;
                 contracts: Readonly<{
@@ -702,6 +734,14 @@ export declare const runtimeBackedBlockClientEntries: {
                                 eventSurface: import("../..").EventSurfaceScope;
                                 filterEventPresets: string | null;
                                 scheduleScope: import("../..").EventScheduleScope;
+                                calendarContext: Readonly<{
+                                    timeZone: import("../../../../../core/src/index").BookingTimeZone;
+                                    initialToday: Readonly<{
+                                        year: number;
+                                        month: number;
+                                        day: number;
+                                    }>;
+                                }>;
                             }>;
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -713,6 +753,14 @@ export declare const runtimeBackedBlockClientEntries: {
                                 eventSurface: import("../..").EventSurfaceScope;
                                 filterEventPresets: string | null;
                                 scheduleScope: import("../..").EventScheduleScope;
+                                calendarContext: Readonly<{
+                                    timeZone: import("../../../../../core/src/index").BookingTimeZone;
+                                    initialToday: Readonly<{
+                                        year: number;
+                                        month: number;
+                                        day: number;
+                                    }>;
+                                }>;
                             }>;
                         }>>;
                     }>;
@@ -2237,6 +2285,10 @@ export declare const clientComponentRegistryEntries: {
                     eventSurface: import("../..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("../..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../../../core/src/index").BookingTimeZone;
+                        initialToday: import("../../../../../calendar/src/index").CalendarDate;
+                    }>;
                 }>;
             }>>;
         }>>;

package/dist/_dts/blocks/src/system/runtime/components/runtime-backed-blocks.d.ts

@@ -327,6 +327,14 @@ export declare const runtimeBackedBlockServerEntries: {
                     eventSurface: import("../..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("../..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../../../core/src/index").BookingTimeZone;
+                        initialToday: Readonly<{
+                            year: number;
+                            month: number;
+                            day: number;
+                        }>;
+                    }>;
                 }>;
             }>;
             contracts: Readonly<{
@@ -344,6 +352,14 @@ export declare const runtimeBackedBlockServerEntries: {
                             eventSurface: import("../..").EventSurfaceScope;
                             filterEventPresets: string | null;
                             scheduleScope: import("../..").EventScheduleScope;
+                            calendarContext: Readonly<{
+                                timeZone: import("../../../../../core/src/index").BookingTimeZone;
+                                initialToday: Readonly<{
+                                    year: number;
+                                    month: number;
+                                    day: number;
+                                }>;
+                            }>;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -355,6 +371,14 @@ export declare const runtimeBackedBlockServerEntries: {
                             eventSurface: import("../..").EventSurfaceScope;
                             filterEventPresets: string | null;
                             scheduleScope: import("../..").EventScheduleScope;
+                            calendarContext: Readonly<{
+                                timeZone: import("../../../../../core/src/index").BookingTimeZone;
+                                initialToday: Readonly<{
+                                    year: number;
+                                    month: number;
+                                    day: number;
+                                }>;
+                            }>;
                         }>;
                     }>>;
                 }>;

package/dist/_dts/blocks/src/system/runtime/hooks/useCalendarEvents.d.ts

@@ -1,6 +1,13 @@
 import type { PublicEvent } from '../../blocks/events/shared/types';
+import { type BookingTimeZone } from '../../../../../core/src/index';
+import type { CalendarDate } from '../../../../../calendar/src/index';
 import { type CalendarViewport, type CalendarViewportKind, type WeekStart } from '../nodes/events/shared/utils';
 import { type EventRuntimeFilters } from '../nodes/events/shared/listOptions';
+import { type CalendarViewLoadState } from './useCalendarEvents.state';
+export type { CalendarViewLoadState } from './useCalendarEvents.state';
+type CalendarViewportFor<Kind extends CalendarViewportKind> = Extract<CalendarViewport, Readonly<{
+    kind: Kind;
+}>>;
 type UseCalendarEventsOptions = {
     /** @deprecated Site ID is now provided by BlockApiProvider context */
     siteId?: string;
@@ -16,59 +23,72 @@ type UseCalendarEventsOptions = {
     filters?: EventRuntimeFilters;
     /** Fetch stage (preview vs published) */
     stage?: 'preview' | 'published';
+    calendarContext: Readonly<{
+        timeZone: BookingTimeZone;
+        initialToday: CalendarDate;
+    }>;
 };
-type CalendarEventsState = {
+export type CalendarEventsState<Kind extends CalendarViewportKind> = {
     /** Events visible in the current view */
     events: PublicEvent[];
     /** Current view date (anchor of the calendar viewport) */
-    viewDate: Date;
+    viewDate: CalendarDate;
     /** Derived calendar viewport for the current view date */
-    viewport: CalendarViewport;
+    viewport: CalendarViewportFor<Kind>;
     /** Whether events are being loaded */
-    loading: boolean;
-    /** Error from last fetch */
-    error: Error | null;
+    loadState: CalendarViewLoadState;
     /** Set the view date */
-    setViewDate: (date: Date) => void;
+    setViewDate: (date: CalendarDate) => void;
     /** Navigate to previous viewport period */
     goToPrevious: () => void;
     /** Navigate to next viewport period */
     goToNext: () => void;
     /** Navigate to today */
     goToToday: () => void;
+    /** Retry loading the currently selected viewport without changing its date */
+    retryCurrentView: () => void;
 };
 type UseCalendarViewportOptions = Readonly<{
     view?: CalendarViewportKind;
     startOfWeek?: WeekStart;
-    initialDate?: Date;
+    initialDate: CalendarDate;
 }>;
 /**
  * Owns calendar viewport state only: selected anchor date, derived visible
  * period, and navigation by the natural unit for the active view.
  */
-export declare function useCalendarViewport({ view, startOfWeek, initialDate, }?: UseCalendarViewportOptions): Readonly<{
-    viewDate: Date;
-    viewport: CalendarViewport;
-    goToDate: (date: Date) => void;
+type CalendarViewportState<Kind extends CalendarViewportKind> = Readonly<{
+    viewDate: CalendarDate;
+    viewport: CalendarViewportFor<Kind>;
+    goToDate: (date: CalendarDate) => void;
     goToPrevious: () => void;
     goToNext: () => void;
     goToToday: () => void;
 }>;
+type ExplicitCalendarViewportOptions<Kind extends CalendarViewportKind> = Omit<UseCalendarViewportOptions, 'view'> & Readonly<{
+    view: Kind;
+}>;
+type DefaultCalendarViewportOptions = Omit<UseCalendarViewportOptions, 'view'> & Readonly<{
+    view?: undefined;
+}>;
+export declare function useCalendarViewport(options: DefaultCalendarViewportOptions): CalendarViewportState<'month'>;
+export declare function useCalendarViewport<Kind extends CalendarViewportKind>(options: ExplicitCalendarViewportOptions<Kind>): CalendarViewportState<Kind>;
 type UseCalendarEventCacheOptions = Readonly<{
-    viewDate: Date;
+    viewDate: CalendarDate;
     initialEvents?: PublicEvent[];
     preloadMonths?: number;
     filters?: EventRuntimeFilters;
     stage?: 'preview' | 'published';
+    timeZone: BookingTimeZone;
 }>;
 /**
  * Owns event loading and month-window caching for a supplied viewport anchor.
  * It does not decide navigation semantics or visible calendar days.
  */
-export declare function useCalendarEventCache({ viewDate, initialEvents, preloadMonths, filters, stage, }: UseCalendarEventCacheOptions): Readonly<{
+export declare function useCalendarEventCache({ viewDate, initialEvents, preloadMonths, filters, stage, timeZone, }: UseCalendarEventCacheOptions): Readonly<{
     events: PublicEvent[];
-    loading: boolean;
-    error: Error | null;
+    loadState: CalendarViewLoadState;
+    retryCurrentView: () => void;
 }>;
 /**
  * Hook for calendar event management with month-based caching.
@@ -84,6 +104,12 @@ export declare function useCalendarEventCache({ viewDate, initialEvents, preload
  * });
  * ```
  */
-export declare function useCalendarEvents({ siteId: _siteId, // Deprecated: siteId now comes from BlockApiProvider context
-initialEvents, view, startOfWeek, preloadMonths, filters, stage, }: UseCalendarEventsOptions): CalendarEventsState;
+type ExplicitCalendarEventsOptions<Kind extends CalendarViewportKind> = Omit<UseCalendarEventsOptions, 'view'> & Readonly<{
+    view: Kind;
+}>;
+type DefaultCalendarEventsOptions = Omit<UseCalendarEventsOptions, 'view'> & Readonly<{
+    view?: undefined;
+}>;
+export declare function useCalendarEvents(options: DefaultCalendarEventsOptions): CalendarEventsState<'month'>;
+export declare function useCalendarEvents<Kind extends CalendarViewportKind>(options: ExplicitCalendarEventsOptions<Kind>): CalendarEventsState<Kind>;
 export default useCalendarEvents;

package/dist/_dts/blocks/src/system/runtime/hooks/useCalendarEvents.state.d.ts

@@ -1,20 +1,37 @@
+import type { CalendarDate } from '../../../../../calendar/src/index';
+export type CalendarLoadScope = Readonly<{
+    anchorDate: CalendarDate;
+    filtersKey: string;
+}>;
 export type CalendarEventCacheLoadState = Readonly<{
     kind: 'idle';
 }> | Readonly<{
     kind: 'loading';
+    scope: CalendarLoadScope;
 }> | Readonly<{
     kind: 'error';
+    scope: CalendarLoadScope;
     error: Error;
 }>;
 export type CalendarEventCacheLoadAction = Readonly<{
     type: 'started';
+    scope: CalendarLoadScope;
 }> | Readonly<{
     type: 'succeeded';
+    scope: CalendarLoadScope;
 }> | Readonly<{
     type: 'failed';
+    scope: CalendarLoadScope;
+    error: Error;
+}>;
+export type CalendarViewLoadState = Readonly<{
+    kind: 'idle';
+}> | Readonly<{
+    kind: 'loading';
+}> | Readonly<{
+    kind: 'error';
     error: Error;
 }>;
-export declare function calendarEventCacheLoadReducer(_state: CalendarEventCacheLoadState, action: CalendarEventCacheLoadAction): CalendarEventCacheLoadState;
+export declare function calendarEventCacheLoadReducer(state: CalendarEventCacheLoadState, action: CalendarEventCacheLoadAction): CalendarEventCacheLoadState;
+export declare function projectCalendarLoadState(state: CalendarEventCacheLoadState, scope: CalendarLoadScope): CalendarViewLoadState;
 export declare function toCalendarEventCacheLoadError(error: unknown): Error;
-export declare function isCalendarEventCacheLoading(state: CalendarEventCacheLoadState): boolean;
-export declare function getCalendarEventCacheError(state: CalendarEventCacheLoadState): Error | null;

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/VerifyingTimeoutStep.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
 type VerifyingTimeoutStepProps = {
-    onCheckAgain: () => void;
+    onCheckAgain?: () => void;
     supportEmail?: string;
+    title?: string;
+    message?: string;
 };
 /**
  * Verifying Timeout Step

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/useEventRegistrationStripeReturn.d.ts

@@ -26,6 +26,7 @@ export type EventRegistrationStripeReturnDeps = Readonly<{
     consumeReturnParams: () => Readonly<{
         registration: string | null;
         registration_attempt: string | null;
+        session_id: string | null;
     }>;
     scrollToBlock: typeof scrollToBlock;
     cleanupStaleRegistrations: typeof cleanupStaleRegistrations;

package/dist/_dts/blocks/src/system/runtime/nodes/events/EventCalendar.client.d.ts

@@ -1,5 +1,5 @@
-import React from "react";
-import { type EventCalendarInteractiveIslandProps } from "./EventCalendar.interactive";
+import React from 'react';
+import { type EventCalendarInteractiveIslandProps } from './EventCalendar.interactive';
 export type EventCalendarClientProps = EventCalendarInteractiveIslandProps;
 export declare const EventCalendarClient: React.FC<EventCalendarClientProps>;
 export default EventCalendarClient;

package/dist/_dts/blocks/src/system/runtime/nodes/events/EventCalendar.interactive.d.ts

@@ -56,6 +56,14 @@ export declare const eventCalendarBlockRuntime: Readonly<{
             eventSurface: import("../../..").EventSurfaceScope;
             filterEventPresets: string | null;
             scheduleScope: import("../../..").EventScheduleScope;
+            calendarContext: Readonly<{
+                timeZone: import("../../../../../../core/src/index").BookingTimeZone;
+                initialToday: Readonly<{
+                    year: number;
+                    month: number;
+                    day: number;
+                }>;
+            }>;
         }>;
     }>;
     contracts: Readonly<{
@@ -73,6 +81,14 @@ export declare const eventCalendarBlockRuntime: Readonly<{
                     eventSurface: import("../../..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("../../..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../../../../core/src/index").BookingTimeZone;
+                        initialToday: Readonly<{
+                            year: number;
+                            month: number;
+                            day: number;
+                        }>;
+                    }>;
                 }>;
             }>) => unknown;
             decode: (input: unknown) => import("../../../../contracts").DecodeResult<Readonly<{
@@ -84,6 +100,14 @@ export declare const eventCalendarBlockRuntime: Readonly<{
                     eventSurface: import("../../..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("../../..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../../../../core/src/index").BookingTimeZone;
+                        initialToday: Readonly<{
+                            year: number;
+                            month: number;
+                            day: number;
+                        }>;
+                    }>;
                 }>;
             }>>;
         }>;
@@ -107,6 +131,14 @@ export declare const eventCalendarInteractiveIslandPropsCodec: Readonly<{
                 eventSurface: import("../../..").EventSurfaceScope;
                 filterEventPresets: string | null;
                 scheduleScope: import("../../..").EventScheduleScope;
+                calendarContext: Readonly<{
+                    timeZone: import("../../../../../../core/src/index").BookingTimeZone;
+                    initialToday: Readonly<{
+                        year: number;
+                        month: number;
+                        day: number;
+                    }>;
+                }>;
             }>;
         }>>;
     }>) => unknown;
@@ -127,6 +159,14 @@ export declare const eventCalendarInteractiveIslandPropsCodec: Readonly<{
                 eventSurface: import("../../..").EventSurfaceScope;
                 filterEventPresets: string | null;
                 scheduleScope: import("../../..").EventScheduleScope;
+                calendarContext: Readonly<{
+                    timeZone: import("../../../../../../core/src/index").BookingTimeZone;
+                    initialToday: Readonly<{
+                        year: number;
+                        month: number;
+                        day: number;
+                    }>;
+                }>;
             }>;
         }>>;
     }>>;

package/dist/_dts/blocks/src/system/runtime/nodes/events/EventCombined.client.d.ts

@@ -2,6 +2,7 @@ import React from "react";
 import type { PublicEvent, ButtonVariant, EventLayout, ColumnOption, WeekStart, CalendarTabViews, FilterAutoShow, CalendarView, EventScheduleScope, EventSurfaceScope } from "../../../blocks/events/shared/types";
 import type { CardRole } from "../../../../../../theme-core/src/cards/index";
 import type { EventCombinedInteractiveIslandProps } from "./EventCombined.interactive";
+import type { EventCollectionHydration } from './shared/eventCollectionContract';
 import { type EventListPaginationAction, type EventPageSize } from "./shared/listOptions";
 export type EventCombinedClientProps = Readonly<{
     events?: PublicEvent[] | null;
@@ -32,6 +33,7 @@ export type EventCombinedClientProps = Readonly<{
     buttonText?: string;
     emptyMessage?: string;
     className?: string;
+    calendarContext: EventCollectionHydration['calendarContext'];
 }>;
 export type EventCombinedIslandClientProps = EventCombinedInteractiveIslandProps;
 /**

package/dist/_dts/blocks/src/system/runtime/nodes/events/EventCombined.interactive.d.ts

@@ -52,6 +52,7 @@ export declare const eventCombinedBlockRuntime: Readonly<{
         buttonText?: string;
         emptyMessage?: string;
         className?: string;
+        bookingTimeZone?: string;
     }>) => Readonly<{
         display: EventCombinedDisplay;
         hydration: Readonly<{
@@ -61,6 +62,14 @@ export declare const eventCombinedBlockRuntime: Readonly<{
             eventSurface: import("../../..").EventSurfaceScope;
             filterEventPresets: string | null;
             scheduleScope: import("../../..").EventScheduleScope;
+            calendarContext: Readonly<{
+                timeZone: import("../../../../../../core/src/index").BookingTimeZone;
+                initialToday: Readonly<{
+                    year: number;
+                    month: number;
+                    day: number;
+                }>;
+            }>;
         }>;
     }>;
     contracts: Readonly<{
@@ -97,6 +106,7 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                 buttonText?: string;
                 emptyMessage?: string;
                 className?: string;
+                bookingTimeZone?: string;
             }>) => unknown;
             decode: (input: unknown) => import("../../../../contracts").DecodeResult<Readonly<{
                 events?: import("../event-registration").PublicEvent[] | null;
@@ -130,6 +140,7 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                 buttonText?: string;
                 emptyMessage?: string;
                 className?: string;
+                bookingTimeZone?: string;
             }>>;
         }>;
         render: Readonly<{
@@ -142,6 +153,14 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                     eventSurface: import("../../..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("../../..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../../../../core/src/index").BookingTimeZone;
+                        initialToday: Readonly<{
+                            year: number;
+                            month: number;
+                            day: number;
+                        }>;
+                    }>;
                 }>;
             }>) => unknown;
             decode: (input: unknown) => import("../../../../contracts").DecodeResult<Readonly<{
@@ -153,6 +172,14 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                     eventSurface: import("../../..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("../../..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../../../../core/src/index").BookingTimeZone;
+                        initialToday: Readonly<{
+                            year: number;
+                            month: number;
+                            day: number;
+                        }>;
+                    }>;
                 }>;
             }>>;
         }>;
@@ -176,6 +203,14 @@ export declare const eventCombinedInteractiveIslandPropsCodec: Readonly<{
                 eventSurface: import("../../..").EventSurfaceScope;
                 filterEventPresets: string | null;
                 scheduleScope: import("../../..").EventScheduleScope;
+                calendarContext: Readonly<{
+                    timeZone: import("../../../../../../core/src/index").BookingTimeZone;
+                    initialToday: Readonly<{
+                        year: number;
+                        month: number;
+                        day: number;
+                    }>;
+                }>;
             }>;
         }>>;
     }>) => unknown;
@@ -196,6 +231,14 @@ export declare const eventCombinedInteractiveIslandPropsCodec: Readonly<{
                 eventSurface: import("../../..").EventSurfaceScope;
                 filterEventPresets: string | null;
                 scheduleScope: import("../../..").EventScheduleScope;
+                calendarContext: Readonly<{
+                    timeZone: import("../../../../../../core/src/index").BookingTimeZone;
+                    initialToday: Readonly<{
+                        year: number;
+                        month: number;
+                        day: number;
+                    }>;
+                }>;
             }>;
         }>>;
     }>>;

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/CalendarDayCell.d.ts

@@ -1,12 +1,14 @@
 import * as React from 'react';
+import type { CalendarDate } from '../../../../../../../calendar/src/index';
 import type { PublicEvent } from '../../../../blocks/events/shared/types';
 export type CalendarDayCellProps = {
     /** The date this cell represents */
-    date: Date;
+    date: CalendarDate;
     /** Events occurring on this date */
     events: PublicEvent[];
     /** Whether this date is in the currently viewed month */
     isCurrentMonth: boolean;
+    today: CalendarDate;
 };
 /**
  * CalendarDayCell - Renders a single day in the calendar grid

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/CalendarNavigationChevron.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function CalendarNavigationChevron({ direction, }: Readonly<{
+    direction: 'previous' | 'next';
+}>): React.ReactElement;

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/DayEventsModal.d.ts

@@ -1,7 +1,8 @@
 import React from 'react';
+import type { CalendarDate } from '../../../../../../../calendar/src/index';
 import type { PublicEvent } from '../../../../blocks/events/shared/types';
 type DayEventsModalProps = {
-    date: Date;
+    date: CalendarDate;
     events: PublicEvent[];
     showCapacity: boolean;
     onClose: () => void;

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/EventModalContext.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { PublicEvent } from '../../../../blocks/events/shared/types';
+import type { CalendarDate } from '../../../../../../../calendar/src/index';
 /**
  * Modal state - either closed, showing a single event, or showing all events for a day
  */
@@ -10,13 +11,13 @@ type ModalState = {
     event: PublicEvent;
 } | {
     type: 'day';
-    date: Date;
+    date: CalendarDate;
     events: PublicEvent[];
 };
 interface EventModalContextValue {
     modalState: ModalState;
     openEventModal: (event: PublicEvent) => void;
-    openDayModal: (date: Date, events: PublicEvent[]) => void;
+    openDayModal: (date: CalendarDate, events: PublicEvent[]) => void;
     closeModal: () => void;
 }
 type EventModalProviderProps = {

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/WeekAgendaView.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import { type CalendarDate } from '../../../../../../../calendar/src/index';
 import type { PublicEvent } from '../../../../blocks/events/shared/types';
 import { type WeekCalendarDays } from './utils';
 type WeekAgendaViewProps = {
@@ -6,6 +7,8 @@ type WeekAgendaViewProps = {
     events: PublicEvent[];
     showCapacity: boolean;
     emptyMessage?: string;
+    calendarTimeZone: string;
+    today: CalendarDate;
 };
 /**
  * WeekAgendaView Component

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/WeekBoardView.d.ts

@@ -1,9 +1,33 @@
 import React from 'react';
 import type { ButtonVariant, PublicEvent } from '../../../../blocks/events/shared/types';
-import { type WeekCalendarDays } from './utils';
-type WeekBoardViewProps = {
+import { type CalendarDate } from '../../../../../../../calendar/src/index';
+import { type WeekCalendarDays, type WeekCalendarViewport } from './utils';
+export type WeekBoardNavigationState = Readonly<{
+    rangeLabel: string;
+    isCurrentWeek: boolean;
+}>;
+export type WeekBoardLoadState = Readonly<{
+    kind: 'idle';
+}> | Readonly<{
+    kind: 'loading';
+}> | Readonly<{
+    kind: 'error';
+    onRetry: () => void;
+}>;
+export type WeekBoardNavigation = WeekBoardNavigationState & (Readonly<{
+    kind: 'static';
+}> | Readonly<{
+    kind: 'interactive';
+    loadState: WeekBoardLoadState;
+    onPrevious: () => void;
+    onNext: () => void;
+    onToday: () => void;
+}>);
+export declare function buildWeekBoardNavigationState(viewport: Pick<WeekCalendarViewport, 'days' | 'title'>, today: CalendarDate): WeekBoardNavigationState;
+export type WeekBoardViewProps = {
     days: WeekCalendarDays;
     events: PublicEvent[];
+    navigation: WeekBoardNavigation;
     showCapacity: boolean;
     emptyMessage?: string;
     /** Optional board title shown in the top bar. Hidden when empty. */
@@ -19,6 +43,8 @@ type WeekBoardViewProps = {
     elevated?: boolean;
     /** Opt-in section band. Generic default is bandless. */
     banded?: boolean;
+    calendarTimeZone: string;
+    today: CalendarDate;
 };
 type WeekBoardDisplay = Readonly<{
     events: readonly PublicEvent[];
@@ -32,8 +58,10 @@ type WeekBoardDisplay = Readonly<{
     buttonVariant?: ButtonVariant;
     elevated?: boolean;
     banded?: boolean;
+    calendarTimeZone: string;
+    today: CalendarDate;
 }>;
-export declare function buildWeekBoardViewProps(display: WeekBoardDisplay, days: WeekCalendarDays): WeekBoardViewProps;
+export declare function buildWeekBoardViewProps(display: WeekBoardDisplay, days: WeekCalendarDays, navigation: WeekBoardNavigation, events?: readonly PublicEvent[]): WeekBoardViewProps;
 /**
  * WeekBoardView
  *