@riverbankcms/sdk 0.147.0 → 0.149.0

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

@@ -1,3 +1,4 @@
+import type { BookingPaymentCollectionOptionKind } from "../../../../../core/src/index";
 import type { BlockBookingPaymentTerms } from "../../blocks/shared/bookingPaymentTerms";
 import { type BlockBookingConsent } from "../../blocks/shared/bookingConsent";
 import type { AppointmentBookingStatusResponse } from "../api/types";
@@ -70,7 +71,7 @@ export type BookingFormService = Readonly<{
     categoryId?: string | null;
 }>;
 export { projectSelectedAppointmentConsentIntoForm, resolveSelectedAppointmentConsent, type SelectedAppointmentConsent, } from "./booking-form.consent";
-export type BookingSelectedCollectionOptionKind = "upfront" | "deferred_manual" | "instalment_plan" | "flexible_balance";
+export type BookingSelectedCollectionOptionKind = BookingPaymentCollectionOptionKind;
 type BookingCustomFieldData<TCustomFieldId extends string> = Readonly<{
     [K in TCustomFieldId as K extends BookingFormDataReservedKey ? never : K]?: unknown;
 }>;
@@ -161,6 +162,9 @@ export type BookingFormViewState = Readonly<{
 }> | Readonly<{
     kind: "verifying";
     message: string;
+}> | Readonly<{
+    kind: "timeout";
+    message: string;
 }> | Readonly<{
     kind: "error";
     message: string;
@@ -245,4 +249,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/commerce/shared/display.d.ts

@@ -1,4 +1,4 @@
-import type { PublicMembershipProduct, PublicPassProduct, PurchasablePublicPassProduct } from '../../../../blocks/shop';
+import type { PublicMembershipProduct, PublicPassProduct, PurchasablePublicMembershipProduct, PurchasablePublicPassProduct } from '../../../../blocks/shop';
 import type { PublicProduct } from '../../../../blocks/products/shared';
 import type { CommerceCartItem, CommerceCheckoutState } from '../../shop-commerce.shared';
 export declare function formatCommercePrice(cents: number, currency: string): string;
@@ -82,7 +82,14 @@ export type MembershipCardDisplay = Readonly<{
     description: string | null;
     priceLabel: string;
     intervalLabel: string;
-    actionLabel: string;
+    action: Readonly<{
+        kind: 'purchase';
+        label: string;
+        product: PurchasablePublicMembershipProduct;
+    }> | Readonly<{
+        kind: 'unavailable';
+        label: string;
+    }>;
 }>;
 export type PassesMembershipsDisplay = Readonly<{
     kind: 'passes-memberships';

package/dist/_dts/blocks/src/system/runtime/nodes/event-details/presentation.d.ts

@@ -52,7 +52,8 @@ export declare function resolveEventDetailsPresentation(input: EventDetailsPrese
         eligibleCategoryIds: string[];
         eligibleCategoryNames: string[];
     })[];
-    applicableMemberships: {
+    applicableMemberships: ({
+        purchaseAvailability: "purchasable";
         id: string;
         name: string;
         description: string | null;
@@ -61,7 +62,18 @@ export declare function resolveEventDetailsPresentation(input: EventDetailsPrese
         billingInterval: "month" | "year";
         eligibleCategoryIds: string[];
         eligibleCategoryNames: string[];
-    }[];
+    } | {
+        purchaseAvailability: "display_only";
+        unavailabilityReason: "online_payments_unavailable";
+        id: string;
+        name: string;
+        description: string | null;
+        price: number;
+        currency: string;
+        billingInterval: "month" | "year";
+        eligibleCategoryIds: string[];
+        eligibleCategoryNames: string[];
+    })[];
     showVenue: boolean;
     showMap: boolean;
     showOtherDates: boolean;

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

@@ -33,6 +33,8 @@ type PaymentSelectionStepProps = {
     onRequestLogin?: () => void;
     /** Callback to report state to parent (for footer action rendering) */
     onStateChange?: (state: PaymentStepState) => void;
+    /** The registration flow's "now"; payment schedules start from here. */
+    nowIso: string;
 };
 /**
  * Payment Selection Step

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

@@ -3,9 +3,7 @@ import type { BlockBookingPaymentCollectionOption, BlockBookingPaymentTerms } fr
 import type { EventRegistrationAvailablePaymentOption } from '../../../blocks/event-registration';
 import { type BookingPaymentOptionViewModel } from '../../shared/bookingPaymentOptions';
 import type { PaymentSelection } from './types';
-type EventDirectPaymentOption = Extract<BlockBookingPaymentCollectionOption, {
-    kind: 'upfront' | 'deferred_manual' | 'instalment_plan' | 'flexible_balance';
-}>;
+type EventDirectPaymentOption = BlockBookingPaymentCollectionOption;
 export declare function getApprovedDirectPaymentCollectionOptionKinds(paymentOptions: readonly EventRegistrationAvailablePaymentOption[]): readonly DirectCheckoutCollectionOptionKind[];
 export type EventRegistrationDirectPaymentOption = Omit<BookingPaymentOptionViewModel, 'kind' | 'title'> & Readonly<{
     kind: Extract<DirectCheckoutCollectionOptionKind, EventDirectPaymentOption['kind']>;
@@ -40,6 +38,8 @@ export declare function buildEventRegistrationPaymentOptionsViewModel(input: Rea
     totalPriceCents: number;
     currency: string;
     startsAt?: string | null;
+    /** When the registration is being made; instalment schedules start here. */
+    nowIso: string;
     locale?: string;
 }>): EventRegistrationPaymentOptionsViewModel;
 export declare function resolveEventRegistrationDirectPaymentSelection(input: Readonly<{

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

@@ -5,6 +5,7 @@ import { useWaitlistClaim } from '../../shared/useWaitlistClaim';
 import { useEventRegistrationStripeReturn } from './useEventRegistrationStripeReturn';
 import { useEventRegistrationSubmit } from './useEventRegistrationSubmit';
 import { useDiscountCodeUi } from './useDiscountCodeUi';
+import { useBookingNowIso } from '../../hooks/useBookingNowIso';
 export type EventRegistrationDetailsCompleteResult = Readonly<{
     ok: true;
     outcome: 'payment-step' | 'submitted';
@@ -30,9 +31,11 @@ export type EventRegistrationWizardDeps = Readonly<{
     useEventRegistrationStripeReturn: typeof useEventRegistrationStripeReturn;
     useEventRegistrationSubmit: typeof useEventRegistrationSubmit;
     useDiscountCodeUi: typeof useDiscountCodeUi;
+    useBookingNowIso: typeof useBookingNowIso;
 }>;
 export declare function useEventRegistrationWizard(options: UseEventRegistrationWizardOptions): {
     api: import("../../api").BoundBlockApiClient;
+    nowIso: string;
     anchorId: string;
     occurrenceContext: {
         id: string;
@@ -165,6 +168,7 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
 };
 export declare function useEventRegistrationWizardWithDeps(options: UseEventRegistrationWizardOptions, deps: EventRegistrationWizardDeps): {
     api: import("../../api").BoundBlockApiClient;
+    nowIso: string;
     anchorId: string;
     occurrenceContext: {
         id: string;

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;