@riverbankcms/sdk 0.138.0 → 0.139.0

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

@@ -783,18 +783,22 @@ export declare const runtimeBackedBlockClientEntries: {
             buildRender: (source: import("../nodes/newsletter-form.types").NewsletterFormProps) => Readonly<{
                 display: Readonly<{
                     kind: "newsletter-form";
+                    availability: "ready" | "unavailable";
                     className: string | null;
                     buttonLabel: string;
                     buttonVariant: import("../nodes/newsletter-form.types").NewsletterButtonVariant;
-                    successMessage: string | null;
                     privacyNote: string | null;
                     fields: readonly import("../nodes/newsletter-form.types").NewsletterFieldDef[];
+                    choices: readonly Readonly<{
+                        id: string;
+                        label: string;
+                    }>[];
                 }>;
                 hydration: Readonly<{
                     target: import("../nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                    preset: import("../nodes/newsletter-form.types").NewsletterPreset;
-                    includePhone: boolean;
-                    tags?: string | null;
+                    setupRevision: number | null;
+                    choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                    choicePresentation: "hidden" | "automatic" | "visitor_choice";
                     spamProtectionEnabled?: boolean;
                 }>;
             }>;
@@ -807,36 +811,44 @@ export declare const runtimeBackedBlockClientEntries: {
                     encode: (value: Readonly<{
                         display: Readonly<{
                             kind: "newsletter-form";
+                            availability: "ready" | "unavailable";
                             className: string | null;
                             buttonLabel: string;
                             buttonVariant: import("../nodes/newsletter-form.types").NewsletterButtonVariant;
-                            successMessage: string | null;
                             privacyNote: string | null;
                             fields: readonly import("../nodes/newsletter-form.types").NewsletterFieldDef[];
+                            choices: readonly Readonly<{
+                                id: string;
+                                label: string;
+                            }>[];
                         }>;
                         hydration: Readonly<{
                             target: import("../nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                            preset: import("../nodes/newsletter-form.types").NewsletterPreset;
-                            includePhone: boolean;
-                            tags?: string | null;
+                            setupRevision: number | null;
+                            choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                            choicePresentation: "hidden" | "automatic" | "visitor_choice";
                             spamProtectionEnabled?: boolean;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                         display: Readonly<{
                             kind: "newsletter-form";
+                            availability: "ready" | "unavailable";
                             className: string | null;
                             buttonLabel: string;
                             buttonVariant: import("../nodes/newsletter-form.types").NewsletterButtonVariant;
-                            successMessage: string | null;
                             privacyNote: string | null;
                             fields: readonly import("../nodes/newsletter-form.types").NewsletterFieldDef[];
+                            choices: readonly Readonly<{
+                                id: string;
+                                label: string;
+                            }>[];
                         }>;
                         hydration: Readonly<{
                             target: import("../nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                            preset: import("../nodes/newsletter-form.types").NewsletterPreset;
-                            includePhone: boolean;
-                            tags?: string | null;
+                            setupRevision: number | null;
+                            choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                            choicePresentation: "hidden" | "automatic" | "visitor_choice";
                             spamProtectionEnabled?: boolean;
                         }>;
                     }>>;
@@ -851,18 +863,22 @@ export declare const runtimeBackedBlockClientEntries: {
                 buildRender: (source: import("../nodes/newsletter-form.types").NewsletterFormProps) => Readonly<{
                     display: Readonly<{
                         kind: "newsletter-form";
+                        availability: "ready" | "unavailable";
                         className: string | null;
                         buttonLabel: string;
                         buttonVariant: import("../nodes/newsletter-form.types").NewsletterButtonVariant;
-                        successMessage: string | null;
                         privacyNote: string | null;
                         fields: readonly import("../nodes/newsletter-form.types").NewsletterFieldDef[];
+                        choices: readonly Readonly<{
+                            id: string;
+                            label: string;
+                        }>[];
                     }>;
                     hydration: Readonly<{
                         target: import("../nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                        preset: import("../nodes/newsletter-form.types").NewsletterPreset;
-                        includePhone: boolean;
-                        tags?: string | null;
+                        setupRevision: number | null;
+                        choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                        choicePresentation: "hidden" | "automatic" | "visitor_choice";
                         spamProtectionEnabled?: boolean;
                     }>;
                 }>;
@@ -875,36 +891,44 @@ export declare const runtimeBackedBlockClientEntries: {
                         encode: (value: Readonly<{
                             display: Readonly<{
                                 kind: "newsletter-form";
+                                availability: "ready" | "unavailable";
                                 className: string | null;
                                 buttonLabel: string;
                                 buttonVariant: import("../nodes/newsletter-form.types").NewsletterButtonVariant;
-                                successMessage: string | null;
                                 privacyNote: string | null;
                                 fields: readonly import("../nodes/newsletter-form.types").NewsletterFieldDef[];
+                                choices: readonly Readonly<{
+                                    id: string;
+                                    label: string;
+                                }>[];
                             }>;
                             hydration: Readonly<{
                                 target: import("../nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                                preset: import("../nodes/newsletter-form.types").NewsletterPreset;
-                                includePhone: boolean;
-                                tags?: string | null;
+                                setupRevision: number | null;
+                                choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                                choicePresentation: "hidden" | "automatic" | "visitor_choice";
                                 spamProtectionEnabled?: boolean;
                             }>;
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                             display: Readonly<{
                                 kind: "newsletter-form";
+                                availability: "ready" | "unavailable";
                                 className: string | null;
                                 buttonLabel: string;
                                 buttonVariant: import("../nodes/newsletter-form.types").NewsletterButtonVariant;
-                                successMessage: string | null;
                                 privacyNote: string | null;
                                 fields: readonly import("../nodes/newsletter-form.types").NewsletterFieldDef[];
+                                choices: readonly Readonly<{
+                                    id: string;
+                                    label: string;
+                                }>[];
                             }>;
                             hydration: Readonly<{
                                 target: import("../nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                                preset: import("../nodes/newsletter-form.types").NewsletterPreset;
-                                includePhone: boolean;
-                                tags?: string | null;
+                                setupRevision: number | null;
+                                choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                                choicePresentation: "hidden" | "automatic" | "visitor_choice";
                                 spamProtectionEnabled?: boolean;
                             }>;
                         }>>;

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

@@ -396,18 +396,22 @@ export declare const runtimeBackedBlockServerEntries: {
             buildRender: (source: import("../nodes/newsletter-form.types").NewsletterFormProps) => Readonly<{
                 display: Readonly<{
                     kind: "newsletter-form";
+                    availability: "ready" | "unavailable";
                     className: string | null;
                     buttonLabel: string;
                     buttonVariant: import("../nodes/newsletter-form.types").NewsletterButtonVariant;
-                    successMessage: string | null;
                     privacyNote: string | null;
                     fields: readonly import("../nodes/newsletter-form.types").NewsletterFieldDef[];
+                    choices: readonly Readonly<{
+                        id: string;
+                        label: string;
+                    }>[];
                 }>;
                 hydration: Readonly<{
                     target: import("../nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                    preset: import("../nodes/newsletter-form.types").NewsletterPreset;
-                    includePhone: boolean;
-                    tags?: string | null;
+                    setupRevision: number | null;
+                    choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                    choicePresentation: "hidden" | "automatic" | "visitor_choice";
                     spamProtectionEnabled?: boolean;
                 }>;
             }>;
@@ -420,36 +424,44 @@ export declare const runtimeBackedBlockServerEntries: {
                     encode: (value: Readonly<{
                         display: Readonly<{
                             kind: "newsletter-form";
+                            availability: "ready" | "unavailable";
                             className: string | null;
                             buttonLabel: string;
                             buttonVariant: import("../nodes/newsletter-form.types").NewsletterButtonVariant;
-                            successMessage: string | null;
                             privacyNote: string | null;
                             fields: readonly import("../nodes/newsletter-form.types").NewsletterFieldDef[];
+                            choices: readonly Readonly<{
+                                id: string;
+                                label: string;
+                            }>[];
                         }>;
                         hydration: Readonly<{
                             target: import("../nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                            preset: import("../nodes/newsletter-form.types").NewsletterPreset;
-                            includePhone: boolean;
-                            tags?: string | null;
+                            setupRevision: number | null;
+                            choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                            choicePresentation: "hidden" | "automatic" | "visitor_choice";
                             spamProtectionEnabled?: boolean;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                         display: Readonly<{
                             kind: "newsletter-form";
+                            availability: "ready" | "unavailable";
                             className: string | null;
                             buttonLabel: string;
                             buttonVariant: import("../nodes/newsletter-form.types").NewsletterButtonVariant;
-                            successMessage: string | null;
                             privacyNote: string | null;
                             fields: readonly import("../nodes/newsletter-form.types").NewsletterFieldDef[];
+                            choices: readonly Readonly<{
+                                id: string;
+                                label: string;
+                            }>[];
                         }>;
                         hydration: Readonly<{
                             target: import("../nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                            preset: import("../nodes/newsletter-form.types").NewsletterPreset;
-                            includePhone: boolean;
-                            tags?: string | null;
+                            setupRevision: number | null;
+                            choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                            choicePresentation: "hidden" | "automatic" | "visitor_choice";
                             spamProtectionEnabled?: boolean;
                         }>;
                     }>>;

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

@@ -35,6 +35,8 @@ export type CalendarEventsState<Kind extends CalendarViewportKind> = {
     events: PublicEvent[];
     /** Current view date (anchor of the calendar viewport) */
     viewDate: CalendarDate;
+    /** Current civil day in the site timezone. */
+    today: CalendarDate;
     /** Derived calendar viewport for the current view date */
     viewport: CalendarViewportFor<Kind>;
     /** Whether events are being loaded */
@@ -54,6 +56,7 @@ type UseCalendarViewportOptions = Readonly<{
     view?: CalendarViewportKind;
     startOfWeek?: WeekStart;
     initialDate: CalendarDate;
+    today: CalendarDate;
 }>;
 /**
  * Owns calendar viewport state only: selected anchor date, derived visible

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

@@ -1,4 +1,4 @@
-import type { CalendarDate } from '../../../../../calendar/src/index';
+import { type CalendarDate } from '../../../../../calendar/src/index';
 import type { PublicEvent } from '../../blocks/events/shared/types';
 import { type CalendarWindowPage, type CalendarMonthWindow, type CalendarSourceCursor } from '../../blocks/events/shared/calendarWindow';
 type MonthState = Readonly<{

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

@@ -0,0 +1,22 @@
+import { type BookingTimeZone } from '../../../../../core/src/index';
+import { type CalendarDate } from '../../../../../calendar/src/index';
+export type CalendarTodayContext = Readonly<{
+    timeZone: BookingTimeZone;
+    initialToday: CalendarDate;
+}>;
+type CalendarTodayClock = Readonly<{
+    now: () => Date;
+    resolveDate?: CalendarDateResolver;
+}>;
+type CalendarDateBoundary = Readonly<{
+    kind: 'found';
+    instant: Date;
+}> | Readonly<{
+    kind: 'retry';
+    delayMs: number;
+}>;
+type CalendarDateResolver = (instant: Date, timeZone: BookingTimeZone) => CalendarDate;
+/** Find the first instant after `now` whose site-local civil date differs. */
+export declare function findNextCalendarDateBoundary(now: Date, timeZone: BookingTimeZone, resolveDate?: CalendarDateResolver): CalendarDateBoundary;
+export declare function useCalendarToday(context: CalendarTodayContext, clock?: CalendarTodayClock): CalendarDate;
+export {};

package/dist/_dts/blocks/src/system/runtime/nodes/appointment-services.d.ts

@@ -0,0 +1,51 @@
+import React from 'react';
+import { z } from 'zod';
+declare const publicLocationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"online">;
+}, z.core.$strip>, z.ZodObject<{
+    mode: z.ZodLiteral<"in_person">;
+    venue: z.ZodNullable<z.ZodObject<{
+        name: z.ZodString;
+        area: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    mode: z.ZodLiteral<"either">;
+    venue: z.ZodNullable<z.ZodObject<{
+        name: z.ZodString;
+        area: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "mode">;
+type PublicAppointmentLocation = z.infer<typeof publicLocationSchema>;
+export type AppointmentServiceRow = Readonly<{
+    id: string;
+    title: string;
+    description: string | null;
+    durationLabel: string;
+    locationLabel: string | null;
+    priceLabel: string | null;
+    href: string;
+}>;
+export type AppointmentServicesView = Readonly<{
+    kind: 'items';
+    rows: readonly AppointmentServiceRow[];
+}> | Readonly<{
+    kind: 'empty';
+    message: string;
+}> | Readonly<{
+    kind: 'error';
+    message: string;
+}>;
+export type AppointmentServicesNodeProps = Readonly<{
+    sectionHeading?: unknown;
+    services?: unknown;
+    pathname?: unknown;
+    className?: string | null;
+}>;
+export declare function formatAppointmentDuration(durationMinutes: number): string;
+export declare function formatAppointmentLocation(location: PublicAppointmentLocation): string | null;
+export declare function buildAppointmentServicesView(input: Readonly<{
+    services: unknown;
+    pathname: string | undefined;
+}>): AppointmentServicesView;
+export declare function AppointmentServicesNode({ sectionHeading, services, pathname, className, }: AppointmentServicesNodeProps): React.ReactElement;
+export default AppointmentServicesNode;

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

@@ -117,6 +117,7 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     isMembershipFastTrack: boolean;
     waitlistClaim: import("../../shared/useWaitlistClaim").UseWaitlistClaimResult;
     eligibility: EligibilityData | null;
+    registrationOptionsState: import("./hooks.state").EligibilityLookupState;
     eligibilityLoading: boolean;
     eligibilityError: string | null;
     existingRegistration: import("../../api").CustomerEventRegistration | null;
@@ -238,6 +239,7 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     isMembershipFastTrack: boolean;
     waitlistClaim: import("../../shared/useWaitlistClaim").UseWaitlistClaimResult;
     eligibility: EligibilityData | null;
+    registrationOptionsState: import("./hooks.state").EligibilityLookupState;
     eligibilityLoading: boolean;
     eligibilityError: string | null;
     existingRegistration: import("../../api").CustomerEventRegistration | null;

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

@@ -56,7 +56,6 @@ type EventRegistrationIslandMeta = Readonly<{
     previewToken?: string | null;
     stage?: 'preview' | 'published';
 }>;
-export declare function buildEventRegistrationDisplay(source: EventRegistrationSourceProps): EventRegistrationDisplay;
 export type EventRegistrationInteractiveIslandProps = InteractiveIslandProps<EventRegistrationIslandMeta, 'event-registration', typeof eventRegistrationBlockRuntime>;
 export declare const eventRegistrationBlockRuntime: Readonly<{
     kind: "client-owned";

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

@@ -1,9 +1,12 @@
 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 CalendarViewLoadState } from "../../hooks/useCalendarEvents";
 import type { EventCombinedInteractiveIslandProps } from "./EventCombined.interactive";
 import type { EventCollectionHydration } from './shared/eventCollectionContract';
+import { type CalendarDate, type CalendarViewport } from "./shared";
 import { type EventListPaginationAction, type EventPageSize } from "./shared/listOptions";
+import { type CalendarViewToggleOption } from "./shared/calendarViewOptions";
 export type EventCombinedClientProps = Readonly<{
     events?: PublicEvent[] | null;
     siteId: string;
@@ -37,6 +40,31 @@ export type EventCombinedClientProps = Readonly<{
     calendarWindow?: EventCollectionHydration['calendarWindow'];
 }>;
 export type EventCombinedIslandClientProps = EventCombinedInteractiveIslandProps;
+type EventCombinedCalendarTabProps = Readonly<{
+    calendarTabViews: CalendarTabViews;
+    calendarView: CalendarView;
+    calendarViewOptions: readonly CalendarViewToggleOption[];
+    onCalendarViewChange: (view: CalendarView) => void;
+    calendarEvents: PublicEvent[];
+    eventsByDate: Map<string, PublicEvent[]>;
+    viewDate: CalendarDate;
+    viewport: CalendarViewport;
+    calendarLoadState: CalendarViewLoadState;
+    dayNames: readonly string[];
+    calendarContext: EventCollectionHydration["calendarContext"];
+    today: CalendarDate;
+    goToPrevious: () => void;
+    goToNext: () => void;
+    goToToday: () => void;
+    emptyMessage: string;
+    showCapacity: boolean;
+    showVenue: boolean;
+    cardRole: CardRole;
+    buttonVariant: ButtonVariant;
+    buttonText: string;
+    showEmptyState: boolean;
+}>;
+export declare const EventCombinedCalendarTab: React.FC<EventCombinedCalendarTabProps>;
 /**
  * EventCombined Component
  *

package/dist/_dts/blocks/src/system/runtime/nodes/events/domain/bookability.d.ts

@@ -0,0 +1,9 @@
+import type { PublicEvent } from '../../../../blocks/events/shared/types';
+/**
+ * Whether a public event has a registration path a visitor can take.
+ *
+ * Lifecycle admission comes from the public booking-availability contract;
+ * capacity comes from the shared event-domain helpers so uncapped, fallback,
+ * and hybrid attendance-mode cases agree with the registration runtime.
+ */
+export declare function isBookableEvent(event: PublicEvent): boolean;

package/dist/_dts/blocks/src/system/runtime/nodes/events/domain/dates.d.ts

@@ -11,6 +11,8 @@ type DateTimeFormatOptions = {
     timeZone?: string | null;
     locale?: string;
 };
+/** Use the event timezone when present, otherwise the calendar/site timezone. */
+export declare function resolveEventTimeZone(event: Pick<PublicEvent, 'timeZone'>, calendarTimeZone: string): string;
 /**
  * Format date for display.
  * Returns: "Monday, January 15, 2025"
@@ -36,7 +38,19 @@ export type EventCompactDateRail = Readonly<{
     month: string;
     label: string;
 }>;
+export type EventNextDateFact = Readonly<{
+    dateTime: string;
+    value: string;
+    label: string;
+}>;
 export declare function formatEventCompactDateRail(isoTimestamp: string, options?: DateTimeFormatOptions): EventCompactDateRail;
+/**
+ * Format the next occurrence for the image-free catalogue card treatment.
+ *
+ * The compact rail already owns this short, booking-local date vocabulary;
+ * keep the fact panel on the same date and timezone rules as event rows.
+ */
+export declare function formatEventNextDateFact(event: Pick<PublicEvent, 'startsAt' | 'timeZone'>): EventNextDateFact;
 export { addDays, addMonths, buildCalendarViewport, formatCalendarTitle, formatDateKey, getEndOfMonth, getMonthCalendarDays, getOrderedDayNames, getStartOfMonth, getWeekCalendarDays, getWeekCalendarDayTuple, isToday, MAX_EVENTS_PER_DAY, shiftCalendarAnchorDate, } from '../../../../../../../calendar/src/index';
 export type { CalendarDate, CalendarViewport, CalendarViewportKind, MonthCalendarViewport, WeekCalendarDays, WeekCalendarViewport, } from '../../../../../../../calendar/src/index';
 /**

package/dist/_dts/blocks/src/system/runtime/nodes/events/domain/duration.d.ts

@@ -0,0 +1,2 @@
+import type { PublicEvent } from '../../../../blocks/events/shared/types';
+export declare function formatEventDuration(event: Pick<PublicEvent, 'startsAt' | 'endsAt'>): string;

package/dist/_dts/blocks/src/system/runtime/nodes/events/domain/index.d.ts

@@ -7,8 +7,12 @@
  * Components in ../shared and the registration wizard import from this barrel.
  */
 export * from './capacity';
+export * from './bookability';
 export * from './cta';
 export * from './dates';
 export * from './destination';
+export * from './duration';
+export * from './location';
 export * from './people';
 export * from './pricing';
+export * from './quickDates';

package/dist/_dts/blocks/src/system/runtime/nodes/events/domain/location.d.ts

@@ -0,0 +1,2 @@
+import type { PublicEvent } from '../../../../blocks/events/shared/types';
+export declare function formatEventLocation(event: Pick<PublicEvent, 'deliveryMode' | 'venue'>): string;

package/dist/_dts/blocks/src/system/runtime/nodes/events/domain/quickDates.d.ts

@@ -0,0 +1,16 @@
+import type { PublicEvent } from '../../../../blocks/events/shared/types';
+export declare const QUICK_EVENT_DATE_LIMIT = 4;
+export type EventQuickDateFact = Readonly<{
+    dateTime: string;
+    label: string;
+}>;
+/**
+ * Select the next occurrence-targeted events for a quick-book rail.
+ *
+ * The API normally returns valid timestamps, but malformed values sort after
+ * valid events so one bad record cannot displace an otherwise useful rail.
+ * Sorting before deduplication means a duplicate occurrence keeps its earliest
+ * deterministic representation.
+ */
+export declare function selectQuickDateEvents(events: readonly PublicEvent[]): readonly PublicEvent[];
+export declare function formatEventQuickDate(event: Pick<PublicEvent, 'startsAt' | 'timeZone'>): EventQuickDateFact;

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

@@ -1,9 +1,17 @@
 import React from 'react';
-import type { PublicEvent } from '../../../../blocks/events/shared/types';
+import type { ButtonVariant, PublicEvent } from '../../../../blocks/events/shared/types';
 type AgendaEventCardProps = {
     event: PublicEvent;
     /** Whether to render the capacity indicator. */
     showCapacity: boolean;
+    /** Whether the published agenda row should include its public location. */
+    showVenue?: boolean;
+    /** Theme button role used by the agenda booking action. */
+    buttonVariant?: ButtonVariant;
+    /** Optional override for the canonical booking action label. */
+    buttonText?: string;
+    /** Calendar/site timezone used when legacy events omit their own timezone. */
+    calendarTimeZone: string;
     /** When provided, renders as button and calls onClick instead of navigating */
     onClick?: (event: PublicEvent) => void;
 };

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

@@ -8,6 +8,8 @@ export type CalendarDayCellProps = {
     events: PublicEvent[];
     /** Whether this date is in the currently viewed month */
     isCurrentMonth: boolean;
+    /** Calendar/site timezone used when an event omits its own timezone. */
+    calendarTimeZone: string;
     today: CalendarDate;
 };
 /**

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

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function CalendarDayHeaders({ dayNames, }: Readonly<{
+    dayNames: readonly string[];
+}>): React.ReactElement;

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

@@ -5,6 +5,7 @@ type DayEventsModalProps = {
     date: CalendarDate;
     events: PublicEvent[];
     showCapacity: boolean;
+    calendarTimeZone: string;
     onClose: () => void;
     onSelectEvent: (event: PublicEvent) => void;
     portalRoot?: HTMLElement | null;
@@ -15,5 +16,5 @@ type DayEventsModalProps = {
  * Uses AgendaEventCard with onClick prop to display events.
  * Clicking an event triggers onSelectEvent (typically opens EventDetailModal).
  */
-export declare function DayEventsModal({ date, events, showCapacity, onClose, onSelectEvent, portalRoot, }: DayEventsModalProps): React.ReactElement;
+export declare function DayEventsModal({ date, events, showCapacity, calendarTimeZone, onClose, onSelectEvent, portalRoot, }: DayEventsModalProps): React.ReactElement;
 export default DayEventsModal;

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

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { CardRole } from '../../../../../../../theme-core/src/cards/index';
 import type { ButtonVariant, CardOrientation, PublicEvent } from '../../../../blocks/events/shared/types';
+type EventCardPresentation = 'default' | 'catalogue';
 type EventCardProps = {
     event: PublicEvent;
     cardRole?: CardRole;
@@ -18,6 +19,10 @@ type EventCardProps = {
     showSummary?: boolean;
     /** Card orientation - 'vertical' for grid, 'horizontal' for stack */
     orientation?: CardOrientation;
+    /** Catalogue cards add the date media fallback and canonical price footer. */
+    presentation?: EventCardPresentation;
+    /** Heading level used by the containing page's document outline. */
+    headingLevel?: 3 | 4;
 };
 /**
  * EventCard Component

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

@@ -6,6 +6,7 @@ type EventModalsProps = {
     cardRole?: CardRole;
     buttonVariant?: ButtonVariant;
     buttonText?: string;
+    calendarTimeZone: string;
 };
 /**
  * EventModals - Renders the appropriate modal based on context state
@@ -15,5 +16,5 @@ type EventModalsProps = {
  * - EventDetailModal for single event view
  * - DayEventsModal for day events list (clicking an event switches to event modal)
  */
-export declare function EventModals({ showCapacity, cardRole, buttonVariant, buttonText, }: EventModalsProps): React.ReactElement | null;
+export declare function EventModals({ showCapacity, cardRole, buttonVariant, buttonText, calendarTimeZone, }: EventModalsProps): React.ReactElement | null;
 export default EventModals;

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

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { ButtonVariant, PublicEvent } from '../../../../blocks/events/shared/types';
+export type EventQuickDatesProps = Readonly<{
+    events: readonly PublicEvent[];
+    pathname: string;
+    buttonVariant?: ButtonVariant;
+}>;
+/**
+ * Render a bounded rail of direct occurrence booking choices.
+ *
+ * The heading belongs to this runtime component so it stays with the
+ * bounded rail. Native events target the occurrence booking route while
+ * external events retain their canonical destination and target behaviour.
+ */
+export declare function EventQuickDates({ events, pathname, buttonVariant, }: EventQuickDatesProps): React.ReactElement | null;

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

@@ -1,20 +1,24 @@
 import React from 'react';
 import { type CalendarDate } from '../../../../../../../calendar/src/index';
-import type { PublicEvent } from '../../../../blocks/events/shared/types';
+import type { ButtonVariant, PublicEvent } from '../../../../blocks/events/shared/types';
 import { type WeekCalendarDays } from '../domain';
 type WeekAgendaViewProps = {
     days: WeekCalendarDays;
     events: PublicEvent[];
     showCapacity: boolean;
+    showVenue?: boolean;
     emptyMessage?: string;
+    showEmptyState: boolean;
     calendarTimeZone: string;
     today: CalendarDate;
+    buttonVariant?: ButtonVariant;
+    buttonText?: string;
 };
 /**
  * WeekAgendaView Component
  *
- * Displays a week of events in an agenda/list style with rich event details.
- * Shows all 7 days with date headers, empty days show "No events scheduled".
+ * Displays populated days in a week as an agenda/list with rich event details.
+ * A week without events has one empty state instead of seven repeated messages.
  */
 export declare const WeekAgendaView: React.FC<WeekAgendaViewProps>;
 export default WeekAgendaView;

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

@@ -7,6 +7,7 @@ type WeekTimetableViewProps = {
     events: PublicEvent[];
     startOfWeek: WeekStart;
     showCapacity: boolean;
+    calendarTimeZone: string;
     emptyMessage?: string;
 };
 export declare const WeekTimetableView: React.FC<WeekTimetableViewProps>;