@riverbankcms/sdk 0.146.0 → 0.148.0

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.mailing-list-choice.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+import type { HeadlessBookingFlow } from "../hooks/useHeadlessBookingFlow";
+export declare function BookingMailingListChoice({ booking, }: Readonly<{
+    booking: HeadlessBookingFlow;
+}>): React.ReactElement | null;

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

@@ -0,0 +1,9 @@
+import type { BookingFormData } from "./booking-form.state";
+import type { BookingFlowReducerState, BookingFlowEvent } from "./booking-form.headless.state";
+export declare function bookingFormDataWithEligibleOptIn(data: BookingFormData, eligible: boolean): BookingFormData;
+type ContactEvent = Extract<BookingFlowEvent, {
+    type: "field-updated" | "field-touched" | "mailing-list-opt-in-set";
+}>;
+export declare function isBookingContactEvent(event: BookingFlowEvent): event is ContactEvent;
+export declare function applyBookingContactEvent(state: BookingFlowReducerState, event: ContactEvent): BookingFlowReducerState;
+export {};

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.reserved-fields.d.ts

@@ -1,5 +1,5 @@
 export declare const APPOINTMENT_BOOKING_BLOCK_ID: "block.appointment-booking";
-export declare const BOOKING_FORM_DATA_RESERVED_KEY_VALUES: readonly ["serviceId", "resourceId", "selectedDate", "selectedSlot", "discountCode", "selectedSlidingAmountInput", "selectedCollectionOptionKind", "selectedAppointmentPackageId"];
+export declare const BOOKING_FORM_DATA_RESERVED_KEY_VALUES: readonly ["serviceId", "resourceId", "selectedDate", "selectedSlot", "discountCode", "selectedSlidingAmountInput", "selectedCollectionOptionKind", "selectedAppointmentPackageId", "mailingListOptIn"];
 export type BookingFormDataReservedKey = (typeof BOOKING_FORM_DATA_RESERVED_KEY_VALUES)[number];
 export type BookingReservedFieldCollision = Readonly<{
     fieldId: BookingFormDataReservedKey;

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

@@ -17,5 +17,5 @@ type BookingFormProps = BookingFormSourceProps & Readonly<{
  * own `.rb-reg-surface`, and leaves no stale loading state on the mounted form.
  * `event-registration.server.tsx` follows the same shape.
  */
-export declare function BookingFormSSR({ blockId, siteId, apiBaseUrl, portalToken, formId, serviceId, resourceId, initialData, noticeMessage, requiresServiceSelection, requiresResourceSelection, shouldAutoSelectSingleResource, rebookContext, submitLabel, successMessage, form, services, spamProtectionEnabled, className, children, }: BookingFormProps): React.JSX.Element;
+export declare function BookingFormSSR({ blockId, children, ...sourceProps }: BookingFormProps): React.JSX.Element;
 export default BookingFormSSR;

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

@@ -83,6 +83,7 @@ export type BookingFormData<TCustomFieldId extends string = never> = Readonly<{
     selectedSlidingAmountInput?: string;
     selectedCollectionOptionKind?: BookingSelectedCollectionOptionKind;
     selectedAppointmentPackageId?: string;
+    mailingListOptIn?: boolean;
 }> & BookingCustomFieldData<TCustomFieldId>;
 type RuntimeBookingFormData = BookingFormData<string>;
 type BookingSubmissionCommon = Readonly<{
@@ -92,6 +93,7 @@ type BookingSubmissionCommon = Readonly<{
     startAt: string;
     endAt: string;
     customFields: Readonly<Record<string, unknown>>;
+    mailingListOptIn?: boolean;
     timezone: string;
 }>;
 export type BookingSubmissionData = (BookingSubmissionCommon & Readonly<{
@@ -159,6 +161,9 @@ export type BookingFormViewState = Readonly<{
 }> | Readonly<{
     kind: "verifying";
     message: string;
+}> | Readonly<{
+    kind: "timeout";
+    message: string;
 }> | Readonly<{
     kind: "error";
     message: string;
@@ -243,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

@@ -0,0 +1,9 @@
+import type { BookingMailingListNote as BookingSignupNote } from '../../../../../core/src/index';
+import type { HeadlessBookingFlow } from "../hooks/useHeadlessBookingFlow";
+export declare function createBookingFormSubmitHandler(input: Readonly<{
+    booking: HeadlessBookingFlow;
+    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-form.submit-success.d.ts

@@ -0,0 +1,9 @@
+import type { BookingSubmitResponse } from "../api/types";
+import type { BookingFlowEvent, BookingSubmitActionResult } from "./booking-form.headless.state";
+export declare function completeBookingSubmission(input: Readonly<{
+    data: BookingSubmitResponse;
+    redirect: "auto" | "manual";
+    successMessage?: string | null;
+    navigateToCheckout: (url: string) => void;
+    dispatch: (event: BookingFlowEvent) => void;
+}>): BookingSubmitActionResult;

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

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import type { MailingListRuntimeContext } from "../../../../../core/src/index";
 import type { PublicEvent } from "../../blocks/events/shared/types";
 import type { StandardBookingFormField, BookingFormService, BookingFormServiceCategory, BookingFormServicesSource, BookingFormSettings, BookingFormSourceRecord } from "./booking-form.state";
 import type { EventRegistrationSourceProps } from "./event-registration.interactive";
@@ -8,8 +9,11 @@ export type BookingFormRebookContext = Readonly<{
 }>;
 export type BookingFormSourceProps = Readonly<{
     siteId?: string;
+    demoEmailSuppressed?: boolean;
     apiBaseUrl?: string;
     portalToken?: string | null;
+    mailingList?: MailingListRuntimeContext;
+    siteName?: string;
     formId?: string;
     serviceId?: string | null;
     resourceId?: string | null;

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/AttendeeDetailsStep.d.ts

@@ -24,6 +24,9 @@ type AttendeeDetailsStepProps = {
     /** Callback when guest section shake animation ends */
     onGuestShakeEnd?: () => void;
     consent: BlockBookingConsent | null;
+    mailingListSignup?: Readonly<{
+        siteName: string;
+    }> | null;
 };
 /**
  * Attendee Details Step

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,8 +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/event-registration.headless.contract.d.ts

@@ -122,6 +122,9 @@ export type EventRegistrationTicketsModel = Readonly<{
 export type EventRegistrationAttendeeModel = Readonly<{
     values: FormData;
     errors: Partial<Record<keyof FormData, string>>;
+    mailingListSignup: Readonly<{
+        siteName: string;
+    }> | null;
 }>;
 export type EventRegistrationGuestsModel = Readonly<{
     required: boolean;

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

@@ -1,3 +1,4 @@
+import type { BookingMailingListNote as BookingSignupNote } from '../../../../../../core/src/index';
 /**
  * SessionStorage utilities for preserving form state across Stripe redirects.
  *
@@ -22,6 +23,7 @@ type PendingRegistrationV5 = {
     paymentSelection: PaymentSelection & {
         method: Exclude<PaymentSelection['method'], null>;
     };
+    mailingListSignupNote?: BookingSignupNote;
     timestamp: number;
 };
 export type PendingRegistration = PendingRegistrationV5;

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

@@ -1,4 +1,6 @@
+import type { BookingMailingListNote as BookingSignupNote } from '../../../../../../core/src/index';
 import type { PublicEventPricing } from '../../../../../../core/src/index';
+import type { MailingListRuntimeContext } from '../../../../../../core/src/index';
 import type { EventRegistrationAvailablePaymentOption, EventRegistrationOptionsResponse, EventRegistrationPricingOption } from '../../../blocks/event-registration';
 import type { OccurrenceContext } from '../../../blocks/event-registration.shared';
 import type { PublicEvent, PublicEventPricingOption, PublicEventPricingOptionAvailability, PublicRunSession } from '../../../blocks/events/shared/types';
@@ -33,10 +35,13 @@ export type RegistrationResult = {
      */
     title?: string;
     message?: string;
+    emailFollowupMessage?: string;
     variant?: 'success' | 'info';
+    mailingListSignupNote?: BookingSignupNote;
 };
 export type PaymentStatusRecoveryState = Readonly<{
     subject: import('../../api/types').EventRegistrationPaymentSubject;
+    mailingListSignupNote?: BookingSignupNote;
 }> & (Readonly<{
     kind: 'ready' | 'checking' | 'processing' | 'temporarilyUnavailable' | 'retryAvailable' | 'assistanceRequired';
 }> | Readonly<{
@@ -169,6 +174,7 @@ export type PaymentStepState = {
     showLoginPrompt: boolean;
 };
 export type EventRegistrationClientProps = {
+    demoEmailSuppressed?: boolean;
     occurrenceContext?: OccurrenceContext | null;
     subject?: EventRegistrationPageSurfaceSubject | null;
     events?: PublicEvent[] | null;
@@ -188,4 +194,6 @@ export type EventRegistrationClientProps = {
     sitePasses?: PublicPassProductCollection | null;
     /** Site-wide public membership products; filtered against the selected event before prompting. */
     siteMemberships?: PublicMembershipProductCollection | null;
+    mailingList?: MailingListRuntimeContext;
+    siteName?: string;
 };

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';
@@ -37,6 +38,9 @@ export type UseEventRegistrationSubmitInput = {
     ticketSelections: readonly EventTicketSelectionLine[];
     selectedSlidingAmount: number | null;
     formData: FormData;
+    mailingListSignup: Readonly<{
+        siteName: string;
+    }> | null;
     altchaSolution: string | null;
     requireGuestDetails: boolean;
     guests: Guest[];
@@ -65,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/useEventRegistrationWizard.d.ts

@@ -19,6 +19,8 @@ export type UseEventRegistrationWizardOptions = Readonly<{
     subject?: EventRegistrationClientProps['subject'];
     events: PublicEvent[];
     maxTicketsNum: number;
+    mailingList?: EventRegistrationClientProps['mailingList'];
+    siteName?: string;
 }>;
 export type EventRegistrationWizardDeps = Readonly<{
     usePortalAuth: typeof usePortalAuth;
@@ -91,6 +93,9 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     hasValidTicketSelection: boolean;
     eventRequiresPayment: boolean;
     formData: FormData;
+    mailingListSignup: Readonly<{
+        siteName: string;
+    }> | null;
     setFormData: import("react").Dispatch<import("react").SetStateAction<FormData>>;
     errors: Partial<Record<keyof FormData, string>>;
     guests: Guest[];
@@ -220,6 +225,9 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     hasValidTicketSelection: boolean;
     eventRequiresPayment: boolean;
     formData: FormData;
+    mailingListSignup: Readonly<{
+        siteName: string;
+    }> | null;
     setFormData: import("react").Dispatch<import("react").SetStateAction<FormData>>;
     errors: Partial<Record<keyof FormData, string>>;
     guests: Guest[];

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

@@ -1,3 +1,4 @@
+import { type MailingListRuntimeContext } from '../../../../../core/src/index';
 import type { BrowserReadAuthority } from '../api/types';
 import type { BlockButtonRole } from '../../constants/buttonRoles';
 import type { PublicEvent } from '../../blocks/events/shared/types';
@@ -13,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;
@@ -36,6 +38,8 @@ export type EventRegistrationSourceProps = Readonly<{
     supportEmail?: string;
     sitePasses?: PublicPassProductCollection | null;
     siteMemberships?: PublicMembershipProductCollection | null;
+    mailingList?: MailingListRuntimeContext;
+    siteName?: string;
 }>;
 export type EventRegistrationDisplay = Readonly<{
     kind: 'event-registration';
@@ -69,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;
@@ -96,9 +101,11 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
         siteMemberships?: Readonly<{
             memberships: readonly import("./shop.client").PublicMembershipProduct[];
         }> | null;
+        mailingList?: MailingListRuntimeContext;
+        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;
         }>;
     }>;
@@ -106,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;
@@ -133,9 +141,12 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
                 siteMemberships?: Readonly<{
                     memberships: readonly import("./shop.client").PublicMembershipProduct[];
                 }> | null;
+                mailingList?: MailingListRuntimeContext;
+                siteName?: string;
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                 siteId?: string;
+                demoEmailSuppressed?: boolean;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 previewToken?: string | null;
@@ -163,18 +174,20 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
                 siteMemberships?: Readonly<{
                     memberships: readonly import("./shop.client").PublicMembershipProduct[];
                 }> | null;
+                mailingList?: MailingListRuntimeContext;
+                siteName?: string;
             }>>;
         }>;
         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;
                 }>;
             }>>;
@@ -195,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;
             }>;
         }>>;
@@ -213,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;