@riverbankcms/sdk 0.147.0 → 0.148.0

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

@@ -4,22 +4,10 @@
  * Provides a reusable polling mechanism with configurable intervals,
  * max attempts, and completion detection. Used by usePaymentVerification
  * and other hooks that need to poll for status changes.
- *
- * @example
- * ```tsx
- * const polling = usePolling(shouldPoll ? {
- *   pollFn: () => api.getStatus(id),
- *   isComplete: (result) => result.status === 'done',
- * } : null);
- *
- * useEffect(() => {
- *   if (polling.status === 'completed') {
- *     handleSuccess(polling.result);
- *   }
- * }, [polling.status]);
- * ```
  */
 export type UsePollingConfig<T> = {
+    /** Stable identifier for the operation being polled. Changing it starts a new cycle. */
+    restartKey: string;
     /** Function to call on each poll - should return the data to check */
     pollFn: () => Promise<T>;
     /** Returns true when polling should stop (success condition) */
@@ -28,8 +16,8 @@ export type UsePollingConfig<T> = {
     isFailed?: (result: T) => boolean;
     /** Max attempts before timeout (default: 10) */
     maxAttempts?: number;
-    /** Interval between polls in ms (default: 1000) */
-    interval?: number;
+    /** Fixed interval or delay selector receiving the one-based attempt number. */
+    interval?: number | ((attempt: number) => number);
 };
 export type UsePollingResult<T> = {
     /** Current polling status */
@@ -42,37 +30,8 @@ export type UsePollingResult<T> = {
     retry: () => void;
 };
 /**
- * Generic hook for polling an async operation until completion.
- *
- * Pass config to start polling, or null to stop/idle.
- * The hook handles cleanup on unmount and config changes.
- *
- * **IMPORTANT: Config identity stability**
- *
- * The config object is used as an effect dependency. If config identity
- * changes on every render (e.g., inline objects), polling will restart
- * continuously, causing infinite request loops.
- *
- * Always memoize the config object:
- *
- * @example
- * ```tsx
- * // BAD - inline object creates new identity every render
- * usePolling({
- *   pollFn: () => api.getStatus(id),
- *   isComplete: (result) => result.status === 'done',
- * });
- *
- * // GOOD - memoized config, stable identity
- * const pollConfig = useMemo(() => shouldPoll ? {
- *   pollFn: () => api.getStatus(id),
- *   isComplete: (result) => result.status === 'done',
- * } : null, [shouldPoll, api, id]);
- *
- * usePolling(pollConfig);
- * ```
- *
- * @param config - Configuration for polling, or null to stop
- * @returns Polling result with status, data, and retry function
+ * Polls until the operation completes, fails, times out, or becomes disabled.
+ * Config objects may be rebuilt across renders; change restartKey to begin a
+ * new operation and reset its attempt budget.
  */
 export declare function usePolling<T>(config: UsePollingConfig<T> | null): UsePollingResult<T>;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.checkout-return-context.d.ts

@@ -0,0 +1,7 @@
+import type { BookingMailingListNote } from '../../../../../core/src/index';
+export type AppointmentCheckoutReturnContext = Readonly<{
+    customerEmail: string | null;
+    mailingListNote: BookingMailingListNote | null;
+}>;
+export declare function saveAppointmentCheckoutReturnContext(sessionId: string, context: AppointmentCheckoutReturnContext): void;
+export declare function readAppointmentCheckoutReturnContext(sessionId: string): AppointmentCheckoutReturnContext | null;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.completion.d.ts

@@ -1,9 +1,11 @@
 import type { BookingMailingListNote as BookingSignupNote } from '../../../../../core/src/index';
 import React from "react";
 import { type BookingRedirectState } from "./booking-form.state";
-export declare function BookingFormCompletion({ resourceName, successMessage, redirectState, localNote, }: Readonly<{
+export declare function BookingFormCompletion({ resourceName, successMessage, redirectState, localNote, customerEmail, demoEmailSuppressed, }: Readonly<{
     resourceName?: string | null;
     successMessage?: string | null;
     redirectState: BookingRedirectState;
     localNote: BookingSignupNote | null;
+    customerEmail: string | null;
+    demoEmailSuppressed?: boolean;
 }>): React.ReactElement;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.headless.state.d.ts

@@ -137,6 +137,8 @@ export type BookingSubmitActionResult = Readonly<{
         kind: "booked";
         appointmentId: string;
         resourceName: string | null;
+        customerEmail: string | null;
+        demoBookingPass?: string;
         mailingListSignupNote?: BookingSignupNote;
     };
 }> | Readonly<{
@@ -145,6 +147,8 @@ export type BookingSubmitActionResult = Readonly<{
         kind: "checkout_redirect";
         checkoutUrl: string;
         sessionId: string;
+        customerEmail: string | null;
+        demoBookingPass?: string;
         mailingListSignupNote?: BookingSignupNote;
     };
 }> | Exclude<BookingFlowActionResult, Readonly<{

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.interactive.d.ts

@@ -13,6 +13,7 @@ export type BookingFormDisplay = Readonly<{
     message: string | null;
 }>;
 export type BookingFormHydration = Readonly<{
+    demoEmailSuppressed?: boolean;
     mailingList?: MailingListRuntimeContext;
     siteName?: string;
     formId: string | null;
@@ -44,6 +45,7 @@ export declare const bookingFormBlockRuntime: Readonly<{
     kind: "client-owned";
     buildRender: (source: Readonly<{
         siteId?: string;
+        demoEmailSuppressed?: boolean;
         apiBaseUrl?: string;
         portalToken?: string | null;
         mailingList?: MailingListRuntimeContext;
@@ -94,6 +96,7 @@ export declare const bookingFormBlockRuntime: Readonly<{
             message: string | null;
         }>;
         hydration: Readonly<{
+            demoEmailSuppressed?: boolean;
             mailingList?: MailingListRuntimeContext;
             siteName?: string;
             formId: string | null;
@@ -173,6 +176,7 @@ export declare const bookingFormBlockRuntime: Readonly<{
         source: Readonly<{
             encode: (value: Readonly<{
                 siteId?: string;
+                demoEmailSuppressed?: boolean;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 mailingList?: MailingListRuntimeContext;
@@ -216,6 +220,7 @@ export declare const bookingFormBlockRuntime: Readonly<{
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                 siteId?: string;
+                demoEmailSuppressed?: boolean;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 mailingList?: MailingListRuntimeContext;
@@ -269,6 +274,7 @@ export declare const bookingFormBlockRuntime: Readonly<{
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    demoEmailSuppressed?: boolean;
                     mailingList?: MailingListRuntimeContext;
                     siteName?: string;
                     formId: string | null;
@@ -354,6 +360,7 @@ export declare const bookingFormBlockRuntime: Readonly<{
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    demoEmailSuppressed?: boolean;
                     mailingList?: MailingListRuntimeContext;
                     siteName?: string;
                     formId: string | null;
@@ -451,6 +458,7 @@ export declare const bookingFormInteractiveIslandPropsCodec: Readonly<{
                 message: string | null;
             }>;
             hydration: Readonly<{
+                demoEmailSuppressed?: boolean;
                 mailingList?: MailingListRuntimeContext;
                 siteName?: string;
                 formId: string | null;
@@ -545,6 +553,7 @@ export declare const bookingFormInteractiveIslandPropsCodec: Readonly<{
                 message: string | null;
             }>;
             hydration: Readonly<{
+                demoEmailSuppressed?: boolean;
                 mailingList?: MailingListRuntimeContext;
                 siteName?: string;
                 formId: string | null;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.payment-confirmation.d.ts

@@ -0,0 +1,13 @@
+import { type BookingFormService, type BookingSelectedCollectionOptionKind } from "./booking-form.state";
+export type BookingPaymentConfirmationSummary = Readonly<{
+    serviceTitle: string;
+    durationMinutes: number;
+    priceAmount: number;
+    priceCurrency: string;
+}>;
+export declare function resolveBookingPaymentConfirmationSummary(input: Readonly<{
+    service: BookingFormService | null;
+    priceAmount: number;
+    selectedCollectionOptionKind?: BookingSelectedCollectionOptionKind;
+    hasSelectedAppointmentPackage: boolean;
+}>): BookingPaymentConfirmationSummary | null;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.state.d.ts

@@ -161,6 +161,9 @@ export type BookingFormViewState = Readonly<{
 }> | Readonly<{
     kind: "verifying";
     message: string;
+}> | Readonly<{
+    kind: "timeout";
+    message: string;
 }> | Readonly<{
     kind: "error";
     message: string;
@@ -245,4 +248,15 @@ export declare function prepareBookingSubmission(input: Readonly<{
     viewerTimeZone?: string | null;
 }>): BookingSubmissionPreparationResult;
 export declare function formatBookingSubmissionPreparationError(error: BookingSubmissionPreparationError): string;
-export declare function getBookingSuccessMessage(successMessage: string | null | undefined): string;
+export type BookingSuccessCopy = Readonly<{
+    message: string;
+    defaultEmailSentence?: string;
+}>;
+export declare function getBookingSuccessCopy(successMessage: string | null | undefined): BookingSuccessCopy;
+export declare function getRegistrationSuccessCopy(result: Readonly<{
+    status?: 'confirmed' | 'waitlist';
+    variant?: 'success' | 'info';
+    message?: string | null;
+    emailFollowupMessage?: string | null;
+}> | null, fallback: string | null | undefined): BookingSuccessCopy;
+export declare function getShopSuccessCopy(outcome: 'success' | 'cancelled'): BookingSuccessCopy;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.submit-actions.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+import type { HeadlessBookingFlow } from "../hooks/useHeadlessBookingFlow";
+type BookingFormSubmitActionsProps = Readonly<{
+    booking: HeadlessBookingFlow;
+    onSubmit: () => Promise<void>;
+}>;
+export declare function BookingFormSubmitActions({ booking, onSubmit, }: BookingFormSubmitActionsProps): React.ReactElement;
+export {};

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.submit-handler.d.ts

@@ -5,4 +5,5 @@ export declare function createBookingFormSubmitHandler(input: Readonly<{
     bookingAnchorId: string;
     isPortalRebook: boolean;
     setLocalMailingListNote: (note: BookingSignupNote | null) => void;
+    setLocalCustomerEmail: (email: string | null) => void;
 }>): () => Promise<void>;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-runtime-sources.d.ts

@@ -9,6 +9,7 @@ export type BookingFormRebookContext = Readonly<{
 }>;
 export type BookingFormSourceProps = Readonly<{
     siteId?: string;
+    demoEmailSuppressed?: boolean;
     apiBaseUrl?: string;
     portalToken?: string | null;
     mailingList?: MailingListRuntimeContext;

package/dist/_dts/blocks/src/system/runtime/nodes/checkout.server.d.ts

@@ -6,7 +6,8 @@ type CheckoutProps = Readonly<{
     apiBaseUrl?: string;
     readAuthority?: import('../api/types').BrowserReadAuthority;
     stage?: 'preview' | 'published';
+    demoEmailSuppressed?: boolean;
     children?: React.ReactNode;
 }> & ShopDisplayConfig;
-export declare function CheckoutSSR({ blockId, siteId, apiBaseUrl, stage, children, ...rest }: CheckoutProps): React.JSX.Element;
+export declare function CheckoutSSR({ blockId, siteId, apiBaseUrl, stage, demoEmailSuppressed, children, ...rest }: CheckoutProps): React.JSX.Element;
 export default CheckoutSSR;

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

@@ -20,5 +20,6 @@ export declare function EventRegistrationSurface(props: Readonly<{
     buttonText: string;
     buttonVariant: ThemeButtonVariantId;
     supportEmail?: string;
-    successMessage: string;
+    successMessage?: string;
+    demoEmailSuppressed?: boolean;
 }>): import("react").JSX.Element;

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

@@ -1,3 +1,8 @@
 import React from 'react';
 import type { EventRegistrationClientProps } from './types';
+import { type UseEventRegistrationWizardResult } from './useEventRegistrationWizard';
 export declare function EventRegistrationWizard(props: EventRegistrationClientProps): React.JSX.Element;
+export type EventRegistrationWizardViewProps = EventRegistrationClientProps & Readonly<{
+    wizard: UseEventRegistrationWizardResult;
+}>;
+export declare function EventRegistrationWizardView(viewProps: EventRegistrationWizardViewProps): React.JSX.Element;

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

@@ -1,11 +1,14 @@
 import type { BookingMailingListNote as BookingSignupNote } from '../../../../../../core/src/index';
 import React from 'react';
+import type { BookingSuccessCopy } from '../booking-form.state';
 type SuccessStepProps = {
     title?: string;
-    message: string;
+    copy: BookingSuccessCopy;
     variant?: 'success' | 'info';
     mailingListSignupNote?: BookingSignupNote;
     context?: 'booking' | 'waitlist';
+    demoEmailSuppressed?: boolean;
+    customerEmail: string | null;
 };
 /**
  * Success Step

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

@@ -35,6 +35,7 @@ export type RegistrationResult = {
      */
     title?: string;
     message?: string;
+    emailFollowupMessage?: string;
     variant?: 'success' | 'info';
     mailingListSignupNote?: BookingSignupNote;
 };
@@ -173,6 +174,7 @@ export type PaymentStepState = {
     showLoginPrompt: boolean;
 };
 export type EventRegistrationClientProps = {
+    demoEmailSuppressed?: boolean;
     occurrenceContext?: OccurrenceContext | null;
     subject?: EventRegistrationPageSurfaceSubject | null;
     events?: PublicEvent[] | null;

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

@@ -1,3 +1,4 @@
+import { generateUuidV4 } from '../../../../../../core/src/index';
 import type { EventRegistrationErrorAction } from '../../../../../../commerce/src/purchase/index';
 import type { BlockApiClient } from '../../api';
 import type { EventRegistrationStatusReference, PaymentMethod } from '../../api/types';
@@ -68,11 +69,7 @@ export type EventRegistrationSubmitDeps = Readonly<{
      */
     createClientCommandId: () => string;
 }>;
-type ClientCommandIdCryptoSource = Readonly<{
-    randomUUID?: () => string;
-    getRandomValues: (bytes: Uint8Array<ArrayBuffer>) => Uint8Array<ArrayBuffer>;
-}>;
-export declare function createClientCommandId(cryptoSource?: ClientCommandIdCryptoSource): string;
+export declare const createClientCommandId: typeof generateUuidV4;
 export declare function useEventRegistrationSubmit(options: UseEventRegistrationSubmitInput): EventRegistrationSubmit;
 /**
  * Describe a completed registration to the success step.

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

@@ -14,6 +14,7 @@ export type EventRegistrationGenericShellStepLabels = typeof EVENT_REGISTRATION_
 type EventRegistrationShellStepLabel = (typeof EVENT_REGISTRATION_SHELL_STEP_LABELS)[number];
 export type EventRegistrationSourceProps = Readonly<{
     siteId?: string;
+    demoEmailSuppressed?: boolean;
     apiBaseUrl?: string;
     portalToken?: string | null;
     previewToken?: string | null;
@@ -72,6 +73,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
     kind: "client-owned";
     buildRender: (source: Readonly<{
         siteId?: string;
+        demoEmailSuppressed?: boolean;
         apiBaseUrl?: string;
         portalToken?: string | null;
         previewToken?: string | null;
@@ -103,7 +105,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
         siteName?: string;
     }>) => Readonly<{
         display: EventRegistrationDisplay;
-        hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+        hydration: Readonly<Omit<InternalEventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
             eventSource: EventRegistrationEventSource;
         }>;
     }>;
@@ -111,6 +113,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
         source: Readonly<{
             encode: (value: Readonly<{
                 siteId?: string;
+                demoEmailSuppressed?: boolean;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 previewToken?: string | null;
@@ -143,6 +146,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                 siteId?: string;
+                demoEmailSuppressed?: boolean;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 previewToken?: string | null;
@@ -177,13 +181,13 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
         render: Readonly<{
             encode: (value: Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                     eventSource: EventRegistrationEventSource;
                 }>;
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                     eventSource: EventRegistrationEventSource;
                 }>;
             }>>;
@@ -204,7 +208,7 @@ export declare const eventRegistrationInteractiveIslandPropsCodec: Readonly<{
             mode: "event-registration";
         } & Readonly<{
             display: EventRegistrationDisplay;
-            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                 eventSource: EventRegistrationEventSource;
             }>;
         }>>;
@@ -222,7 +226,7 @@ export declare const eventRegistrationInteractiveIslandPropsCodec: Readonly<{
             mode: "event-registration";
         } & Readonly<{
             display: EventRegistrationDisplay;
-            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                 eventSource: EventRegistrationEventSource;
             }>;
         }>>;

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

@@ -2,6 +2,7 @@ import type { EventCollectionSourceProps } from "./shared/eventCollectionContrac
 import { type CardRole } from "../../../../../../theme-core/src/cards/index";
 import type { ButtonVariant, CardOrientation, ColumnOption, EventLayout, EventScheduleScope, EventSurfaceScope, FilterAutoShow, PublicEvent } from "../../../blocks/events/shared/types";
 import { type InteractiveIslandProps } from "../../../../contracts/islands";
+import { type EventCardDisplayProps } from "./shared/eventCardPresentations";
 import { type EventListPaginationAction, type EventListPaginationMode, type EventPageSize } from "./shared/listOptions";
 import type { BrowserReadAuthority } from "../../api/types";
 export type EventListingSourceProps = Pick<EventCollectionSourceProps, "showFilters" | "showCategoryFilter" | "showVenueFilter" | "showStaffFilter" | "eventSurface" | "filterEventPresets" | "scheduleScope" | "seriesIds" | "filterCategoryIds" | "filterStaffMemberId" | "filterVenueId"> & Readonly<{
@@ -280,4 +281,9 @@ export declare const eventListingInteractiveIslandPropsCodec: Readonly<{
     }>>;
 }>;
 export declare function buildEventListingInteractiveIslandProps(props: EventListingSourceProps): EventListingInteractiveIslandProps;
+/**
+ * The card an events listing draws when nothing on the block changes it: the
+ * block's own defaults, read through its render.
+ */
+export declare function defaultEventListingCardProps(): EventCardDisplayProps;
 export {};

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

@@ -11,6 +11,40 @@ type DateTimeFormatOptions = {
     timeZone?: string | null;
     locale?: string;
 };
+/**
+ * The English locale a site's public dates are written in, read from the
+ * site's own time zone (Will, 2026-09-26: "date style from site time zone").
+ *
+ * Sites don't store a locale, and every public word around a date is English,
+ * so the only open question is which English conventions to follow: day or
+ * month first, and a 24 or 12-hour clock. The site's time zone is the one
+ * fact every site carries about where it is. It is the site's, never an
+ * event's: a venue left at UTC must not turn a UK site's dates American.
+ * Anywhere this can't place (UTC, the Americas, Asia) keeps US English, which
+ * is what these helpers wrote before sites were placed at all.
+ */
+export declare function eventDateLocale(siteTimeZone: string | null | undefined): string;
+export type EventDateOptions = Readonly<{
+    timeZone: string | null;
+    locale: string;
+}>;
+/**
+ * Formatting options for an event's dates: the times in the event's own zone,
+ * written in its site's locale. A record from an older server that doesn't
+ * name the site's zone falls back to the event's.
+ */
+export declare function eventDateOptions(place: Readonly<{
+    timeZone?: string | null;
+    siteTimeZone?: string | null;
+}>): EventDateOptions;
+/**
+ * Start and end times as cards write them, in the site's locale:
+ * "10:00 to 16:00" in the UK, "10:00 AM to 4:00 PM" in the US.
+ */
+export declare function formatEventTimeRange(times: Readonly<{
+    startsAt: string;
+    endsAt: string;
+}>, options: EventDateOptions): string;
 /** Use the event timezone when present, otherwise the calendar/site timezone. */
 export declare function resolveEventTimeZone(event: Pick<PublicEvent, 'timeZone'>, calendarTimeZone: string): string;
 /**
@@ -19,8 +53,8 @@ export declare function resolveEventTimeZone(event: Pick<PublicEvent, 'timeZone'
  */
 export declare function formatDate(isoTimestamp: string, options?: DateTimeFormatOptions): string;
 /**
- * Format time for display.
- * Returns: "10:00 AM"
+ * Format time for display, on the locale's own clock.
+ * Returns: "9:00 AM" (en-US) or "09:00" (en-GB)
  */
 export declare function formatTime(isoTimestamp: string, options?: DateTimeFormatOptions): string;
 export declare function formatEventDateParts(args: {
@@ -50,7 +84,7 @@ export declare function formatEventCompactDateRail(isoTimestamp: string, options
  * 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 declare function formatEventNextDateFact(event: Pick<PublicEvent, 'startsAt' | 'timeZone' | 'siteTimeZone'>): 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/shared/EventCard.client.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
 import { EventCard } from './EventCard';
-type EventCardClientProps = Omit<React.ComponentProps<typeof EventCard>, 'mapSlot'>;
+export type EventCardClientProps = Omit<React.ComponentProps<typeof EventCard>, 'mapSlot'>;
 export declare function EventCardClient({ event, showMap, allowMap, ...cardProps }: EventCardClientProps): React.ReactElement;
 export default EventCardClient;

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

@@ -1,8 +1,9 @@
 import React from 'react';
 import type { CardRole } from '../../../../../../../theme-core/src/cards/index';
 import type { ButtonVariant, CardOrientation, PublicEvent } from '../../../../blocks/events/shared/types';
+import type { ResolveImageUrlContext } from '../../media';
 type EventCardPresentation = 'default' | 'catalogue';
-type EventCardProps = {
+export type EventCardProps = {
     event: PublicEvent;
     cardRole?: CardRole;
     buttonVariant?: ButtonVariant;
@@ -23,6 +24,12 @@ type EventCardProps = {
     presentation?: EventCardPresentation;
     /** Heading level used by the containing page's document outline. */
     headingLevel?: 3 | 4;
+    /**
+     * How the image resolves outside a rendered page, such as a dashboard
+     * preview: the site and its media assets, because stored media values drop
+     * their storage path. A rendered page supplies its own and leaves this out.
+     */
+    imageResolveContext?: ResolveImageUrlContext | null;
 };
 /**
  * EventCard Component
@@ -33,4 +40,12 @@ type EventCardProps = {
  * This component is server-safe (uses no client APIs like Intl).
  */
 export declare const EventCard: React.FC<EventCardProps>;
+/**
+ * The card's date and times, written the way the event's place writes them
+ * ("Friday, 16 October 2026" and "10:00 to 16:00" in the UK).
+ */
+export declare function formatEventCardWhen(event: Pick<PublicEvent, 'startsAt' | 'endsAt' | 'timeZone' | 'siteTimeZone'>): Readonly<{
+    formattedDate: string;
+    formattedTime: string;
+}>;
 export default EventCard;

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

@@ -0,0 +1,13 @@
+import type { ButtonVariant, PublicEvent } from '../../../../blocks/events/shared/types';
+import type { EventListingDisplay } from '../EventListing.interactive';
+import type { EventCardProps } from './EventCard';
+/**
+ * How a listing draws each card, apart from the event itself. Each listing
+ * reads its card settings from here, and so does anything that previews a
+ * card as that listing would draw it (the dashboard's event wizard).
+ */
+export type EventCardDisplayProps = Omit<EventCardProps, 'event' | 'mapSlot' | 'imageResolveContext'>;
+/** A booking page's catalogue card: one per series, "See dates" for dated events. */
+export declare function catalogueEventCardProps(event: Pick<PublicEvent, 'bookingScope'>, buttonVariant?: ButtonVariant): EventCardDisplayProps;
+/** An events listing's card, from the listing's display settings. */
+export declare function listingEventCardProps(display: Pick<EventListingDisplay, 'cardRole' | 'buttonVariant' | 'buttonText' | 'showVenue' | 'showMap' | 'showCapacity' | 'orientation'>): EventCardDisplayProps;

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

@@ -198,7 +198,6 @@ export declare const eventCollectionSourceSchemaShape: {
             body: z.ZodOptional<z.ZodNullable<z.ZodType<import("../../../../../../../core/src/index").RichTextDoc, unknown, z.core.$ZodTypeInternals<import("../../../../../../../core/src/index").RichTextDoc, unknown>>>>;
         }, z.core.$strip>>;
         presentation: z.ZodOptional<z.ZodObject<{
-            cardTitleOverride: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             image: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 purpose: z.ZodOptional<z.ZodString>;
@@ -547,6 +546,7 @@ export declare const eventCollectionSourceSchemaShape: {
             cancelled: "cancelled";
         }>>;
         timeZone: z.ZodString;
+        siteTimeZone: z.ZodOptional<z.ZodString>;
         pricing: z.ZodType<import("../../../../../../../core/src/index").PublicEventPricing, unknown, z.core.$ZodTypeInternals<import("../../../../../../../core/src/index").PublicEventPricing, unknown>>;
         paymentTerms: z.ZodObject<{
             allowedOptions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -687,7 +687,6 @@ export declare const eventCollectionSourceSchemaShape: {
             body: z.ZodOptional<z.ZodNullable<z.ZodType<import("../../../../../../../core/src/index").RichTextDoc, unknown, z.core.$ZodTypeInternals<import("../../../../../../../core/src/index").RichTextDoc, unknown>>>>;
         }, z.core.$strip>>;
         presentation: z.ZodOptional<z.ZodObject<{
-            cardTitleOverride: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             image: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 purpose: z.ZodOptional<z.ZodString>;
@@ -1036,6 +1035,7 @@ export declare const eventCollectionSourceSchemaShape: {
             cancelled: "cancelled";
         }>>;
         timeZone: z.ZodString;
+        siteTimeZone: z.ZodOptional<z.ZodString>;
         pricing: z.ZodType<import("../../../../../../../core/src/index").PublicEventPricing, unknown, z.core.$ZodTypeInternals<import("../../../../../../../core/src/index").PublicEventPricing, unknown>>;
         paymentTerms: z.ZodObject<{
             allowedOptions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -1237,7 +1237,6 @@ export declare const eventCollectionDisplaySchemaShape: {
             body: z.ZodOptional<z.ZodNullable<z.ZodType<import("../../../../../../../core/src/index").RichTextDoc, unknown, z.core.$ZodTypeInternals<import("../../../../../../../core/src/index").RichTextDoc, unknown>>>>;
         }, z.core.$strip>>;
         presentation: z.ZodOptional<z.ZodObject<{
-            cardTitleOverride: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             image: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 purpose: z.ZodOptional<z.ZodString>;
@@ -1586,6 +1585,7 @@ export declare const eventCollectionDisplaySchemaShape: {
             cancelled: "cancelled";
         }>>;
         timeZone: z.ZodString;
+        siteTimeZone: z.ZodOptional<z.ZodString>;
         pricing: z.ZodType<import("../../../../../../../core/src/index").PublicEventPricing, unknown, z.core.$ZodTypeInternals<import("../../../../../../../core/src/index").PublicEventPricing, unknown>>;
         paymentTerms: z.ZodObject<{
             allowedOptions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -1726,7 +1726,6 @@ export declare const eventCollectionDisplaySchemaShape: {
             body: z.ZodOptional<z.ZodNullable<z.ZodType<import("../../../../../../../core/src/index").RichTextDoc, unknown, z.core.$ZodTypeInternals<import("../../../../../../../core/src/index").RichTextDoc, unknown>>>>;
         }, z.core.$strip>>;
         presentation: z.ZodOptional<z.ZodObject<{
-            cardTitleOverride: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             image: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 purpose: z.ZodOptional<z.ZodString>;
@@ -2075,6 +2074,7 @@ export declare const eventCollectionDisplaySchemaShape: {
             cancelled: "cancelled";
         }>>;
         timeZone: z.ZodString;
+        siteTimeZone: z.ZodOptional<z.ZodString>;
         pricing: z.ZodType<import("../../../../../../../core/src/index").PublicEventPricing, unknown, z.core.$ZodTypeInternals<import("../../../../../../../core/src/index").PublicEventPricing, unknown>>;
         paymentTerms: z.ZodObject<{
             allowedOptions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -2205,7 +2205,7 @@ export declare const eventCollectionDisplaySchemaShape: {
         3: "3";
         4: "4";
     }>;
-    readonly eventsPerPage: z.ZodType<24 | 3 | 6 | 12 | 10 | 30 | 20, unknown, z.core.$ZodTypeInternals<24 | 3 | 6 | 12 | 10 | 30 | 20, unknown>>;
+    readonly eventsPerPage: z.ZodType<10 | 24 | 3 | 6 | 20 | 12 | 30, unknown, z.core.$ZodTypeInternals<10 | 24 | 3 | 6 | 20 | 12 | 30, unknown>>;
     readonly paginationAction: z.ZodType<EventListPaginationAction, unknown, z.core.$ZodTypeInternals<EventListPaginationAction, unknown>>;
     readonly startOfWeek: z.ZodEnum<{
         monday: "monday";