@riverbankcms/sdk 0.136.0 → 0.138.0

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

@@ -1,3 +1,4 @@
+import type { EventRegistrationErrorAction } from '../../../../../../commerce/src/purchase/index';
 import type { DiscountContext } from '../../api/types';
 import type { EventTicketSelectionLine, EventRegistrationClientProps, EligibilityData, FormData, Guest, GuestErrors, PaymentSelection, PaymentStepState, PublicEvent, RegistrationEvent, RegistrationResult, RegistrationStep } from './types';
 import { usePortalAuth, useEligibility, useExistingEventRegistration } from './hooks';
@@ -18,7 +19,6 @@ export type UseEventRegistrationWizardOptions = Readonly<{
     occurrenceContext: EventRegistrationClientProps['occurrenceContext'];
     subject?: EventRegistrationClientProps['subject'];
     events: PublicEvent[];
-    wholeSeriesOfferings?: EventRegistrationClientProps['wholeSeriesOfferings'];
     maxTicketsNum: number;
 }>;
 export type EventRegistrationWizardDeps = Readonly<{
@@ -58,14 +58,14 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     setSelectedEvent: import("react").Dispatch<import("react").SetStateAction<RegistrationEvent | null>>;
     ticketsCount: number;
     setTicketsCount: (nextTicketsCount: number) => void;
-    selectedAttendanceMode: "online" | "in_person" | null;
-    setSelectedAttendanceMode: import("react").Dispatch<import("react").SetStateAction<"online" | "in_person" | null>>;
+    selectedAttendanceMode: "in_person" | "online" | null;
+    setSelectedAttendanceMode: import("react").Dispatch<import("react").SetStateAction<"in_person" | "online" | null>>;
     ticketSelections: Readonly<{
-        ticketTypeId: string | null;
+        pricingOptionId: string | null;
         quantity: number;
     }>[];
     selectedTicketLines: Readonly<{
-        ticketTypeId: string | null;
+        pricingOptionId: string | null;
         quantity: number;
     }>[];
     setSelectedTicketLines: (lines: readonly EventTicketSelectionLine[]) => void;
@@ -78,16 +78,16 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
         suggestedAmount: number | null;
     }> | null;
     slidingScaleSelectionMessage: string | null;
-    selectedTicketType: import("./utils").SelectableEventTicketType | null;
-    ticketSelectionSummaryLines: Readonly<{
-        ticketTypeId: string | null;
+    selectedTicketType: import("../../..").EventRegistrationPricingOption | null;
+    ticketSelectionSummaryLines: {
+        pricingOptionId: string | null;
         label: string;
         quantity: number;
         unitPriceCents: number;
         subtotalCents: number;
-    }>[];
-    ticketSelectionSubtotalCents: number;
-    visibleTicketTypes: import("./utils").SelectableEventTicketType[];
+    }[];
+    ticketSelectionSubtotalCents: number | null;
+    visibleTicketTypes: import("../../..").EventRegistrationPricingOption[];
     ticketTypeSelectionRequired: boolean;
     hasValidTicketSelection: boolean;
     eventRequiresPayment: boolean;
@@ -101,6 +101,7 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     handleGuestShakeEnd: () => void;
     registrationResult: RegistrationResult | null;
     errorMessage: string;
+    errorAction: EventRegistrationErrorAction;
     altchaSolution: string | null;
     setAltchaSolution: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     portalAuthState: import("./hooks").PortalAuthState;
@@ -141,7 +142,7 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     discountsAvailableLoading: boolean;
     discountContext: DiscountContext | null;
     shouldShowDiscountToggle: boolean;
-    verification: import("../../hooks/usePaymentVerification").PaymentVerificationResult;
+    verification: import("./useEventRegistrationStripeReturn").EventRegistrationStripeReturnResult;
     handleDetailsComplete: () => Promise<EventRegistrationDetailsCompleteResult>;
     handlePaymentSelect: () => Promise<void>;
     handleUseCardInsteadOfPass: () => void;
@@ -178,14 +179,14 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     setSelectedEvent: import("react").Dispatch<import("react").SetStateAction<RegistrationEvent | null>>;
     ticketsCount: number;
     setTicketsCount: (nextTicketsCount: number) => void;
-    selectedAttendanceMode: "online" | "in_person" | null;
-    setSelectedAttendanceMode: import("react").Dispatch<import("react").SetStateAction<"online" | "in_person" | null>>;
+    selectedAttendanceMode: "in_person" | "online" | null;
+    setSelectedAttendanceMode: import("react").Dispatch<import("react").SetStateAction<"in_person" | "online" | null>>;
     ticketSelections: Readonly<{
-        ticketTypeId: string | null;
+        pricingOptionId: string | null;
         quantity: number;
     }>[];
     selectedTicketLines: Readonly<{
-        ticketTypeId: string | null;
+        pricingOptionId: string | null;
         quantity: number;
     }>[];
     setSelectedTicketLines: (lines: readonly EventTicketSelectionLine[]) => void;
@@ -198,16 +199,16 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
         suggestedAmount: number | null;
     }> | null;
     slidingScaleSelectionMessage: string | null;
-    selectedTicketType: import("./utils").SelectableEventTicketType | null;
-    ticketSelectionSummaryLines: Readonly<{
-        ticketTypeId: string | null;
+    selectedTicketType: import("../../..").EventRegistrationPricingOption | null;
+    ticketSelectionSummaryLines: {
+        pricingOptionId: string | null;
         label: string;
         quantity: number;
         unitPriceCents: number;
         subtotalCents: number;
-    }>[];
-    ticketSelectionSubtotalCents: number;
-    visibleTicketTypes: import("./utils").SelectableEventTicketType[];
+    }[];
+    ticketSelectionSubtotalCents: number | null;
+    visibleTicketTypes: import("../../..").EventRegistrationPricingOption[];
     ticketTypeSelectionRequired: boolean;
     hasValidTicketSelection: boolean;
     eventRequiresPayment: boolean;
@@ -221,6 +222,7 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     handleGuestShakeEnd: () => void;
     registrationResult: RegistrationResult | null;
     errorMessage: string;
+    errorAction: EventRegistrationErrorAction;
     altchaSolution: string | null;
     setAltchaSolution: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     portalAuthState: import("./hooks").PortalAuthState;
@@ -261,7 +263,7 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     discountsAvailableLoading: boolean;
     discountContext: DiscountContext | null;
     shouldShowDiscountToggle: boolean;
-    verification: import("../../hooks/usePaymentVerification").PaymentVerificationResult;
+    verification: import("./useEventRegistrationStripeReturn").EventRegistrationStripeReturnResult;
     handleDetailsComplete: () => Promise<EventRegistrationDetailsCompleteResult>;
     handlePaymentSelect: () => Promise<void>;
     handleUseCardInsteadOfPass: () => void;

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

@@ -1,7 +1,9 @@
 import { type Dispatch, type SetStateAction } from 'react';
 import type { ResolveWaitlistClaimResponse } from '../../api/types';
 import type { EventTicketSelectionLine, FormData, Guest, RegistrationEvent, RegistrationStep } from './types';
+import type { EventRegistrationErrorAction } from '../../../../../../commerce/src/purchase/index';
 export type WaitlistClaimRestorationSetters = Readonly<{
+    setErrorAction?: (action: EventRegistrationErrorAction) => void;
     setErrorMessage: Dispatch<SetStateAction<string>>;
     setStep: (step: RegistrationStep) => void;
     setSelectedEvent: Dispatch<SetStateAction<RegistrationEvent | null>>;

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

@@ -1,10 +1,17 @@
+import type { EventRegistrationPricingOption } from '../../../blocks/event-registration';
 import type { RegistrationOptionsResponse } from '../../api/types';
-import type { EligibilityData, EligibilityEventTicketType, PublicEvent, PublicEventTicketType, RegistrationEvent } from './types';
-export declare const DEFAULT_EVENT_CURRENCY = "usd";
+import type { EligibilityData, PublicEvent, RegistrationEvent } from './types';
 export declare function getPortalSubjectEmail(profile: Readonly<{
     email: string;
 }> | null): string | null;
-export type SelectableEventTicketType = EligibilityEventTicketType | PublicEventTicketType;
+/**
+ * A ticket type the wizard can offer.
+ *
+ * It answers to `pricingOptionId` whichever source it came from — the
+ * registration-options response or the event record — so the wizard never has
+ * to remember which of two names this identity goes by (A44).
+ */
+export type SelectableEventTicketType = EventRegistrationPricingOption;
 type TicketTypeSourceEvent = PublicEvent | RegistrationEvent;
 /**
  * Format date for display
@@ -56,6 +63,6 @@ export declare function getImplicitSingleAvailableTicketType(ticketTypes: readon
 export declare function findSelectedTicketType(input: {
     event: TicketTypeSourceEvent | null;
     eligibility: EligibilityData | null;
-    selectedTicketTypeId: string | null;
+    selectedPricingOptionId: string | null;
     selectedAttendanceMode?: 'in_person' | 'online' | null;
 }): SelectableEventTicketType | null;

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

@@ -1,6 +1,5 @@
 import type { BlockButtonRole } from '../../constants/buttonRoles';
 import type { PublicEvent } from '../../blocks/events/shared/types';
-import type { PublicWholeSeriesOffering } from '../../blocks/events/whole-series';
 import { type PublicMembershipProductCollection, type PublicPassProductCollection } from '../../blocks/shop.shared';
 import type { OccurrenceContext } from '../../blocks/event-registration.shared';
 import type { EventRegistrationClientProps as InternalEventRegistrationClientProps } from './event-registration/types';
@@ -18,9 +17,8 @@ export type EventRegistrationSourceProps = Readonly<{
     occurrenceContext?: OccurrenceContext | null;
     subject?: EventRegistrationPageSurfaceSubject | null;
     events?: PublicEvent[] | null;
-    wholeSeriesOfferings?: PublicWholeSeriesOffering[] | null;
-    wholeSeriesOffering?: PublicWholeSeriesOffering | null;
-    subjectWholeSeriesOffering?: PublicWholeSeriesOffering | null;
+    /** Runs for a whole-series page, loaded independently of the date page. */
+    wholeSeriesRunEvents?: PublicEvent[] | null;
     className?: string | null;
     buttonText?: string | null;
     maxTickets?: string | null;
@@ -70,9 +68,8 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
         occurrenceContext?: OccurrenceContext | null;
         subject?: EventRegistrationPageSurfaceSubject | null;
         events?: PublicEvent[] | null;
-        wholeSeriesOfferings?: PublicWholeSeriesOffering[] | null;
-        wholeSeriesOffering?: PublicWholeSeriesOffering | null;
-        subjectWholeSeriesOffering?: PublicWholeSeriesOffering | null;
+        /** Runs for a whole-series page, loaded independently of the date page. */
+        wholeSeriesRunEvents?: PublicEvent[] | null;
         className?: string | null;
         buttonText?: string | null;
         maxTickets?: string | null;
@@ -104,9 +101,8 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
                 occurrenceContext?: OccurrenceContext | null;
                 subject?: EventRegistrationPageSurfaceSubject | null;
                 events?: PublicEvent[] | null;
-                wholeSeriesOfferings?: PublicWholeSeriesOffering[] | null;
-                wholeSeriesOffering?: PublicWholeSeriesOffering | null;
-                subjectWholeSeriesOffering?: PublicWholeSeriesOffering | null;
+                /** Runs for a whole-series page, loaded independently of the date page. */
+                wholeSeriesRunEvents?: PublicEvent[] | null;
                 className?: string | null;
                 buttonText?: string | null;
                 maxTickets?: string | null;
@@ -133,9 +129,8 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
                 occurrenceContext?: OccurrenceContext | null;
                 subject?: EventRegistrationPageSurfaceSubject | null;
                 events?: PublicEvent[] | null;
-                wholeSeriesOfferings?: PublicWholeSeriesOffering[] | null;
-                wholeSeriesOffering?: PublicWholeSeriesOffering | null;
-                subjectWholeSeriesOffering?: PublicWholeSeriesOffering | null;
+                /** Runs for a whole-series page, loaded independently of the date page. */
+                wholeSeriesRunEvents?: PublicEvent[] | null;
                 className?: string | null;
                 buttonText?: string | null;
                 maxTickets?: string | null;

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

@@ -50,6 +50,7 @@ export declare const eventCalendarBlockRuntime: Readonly<{
     buildRender: (source: EventCalendarSourceProps) => Readonly<{
         display: EventCalendarDisplay;
         hydration: Readonly<{
+            calendarWindow?: import("../../../../contracts").CalendarWindowPage;
             siteId: string;
             stage?: "preview" | "published";
             prefetchedEvents: boolean;
@@ -75,6 +76,7 @@ export declare const eventCalendarBlockRuntime: Readonly<{
             encode: (value: Readonly<{
                 display: EventCalendarDisplay;
                 hydration: Readonly<{
+                    calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                     siteId: string;
                     stage?: "preview" | "published";
                     prefetchedEvents: boolean;
@@ -94,6 +96,7 @@ export declare const eventCalendarBlockRuntime: Readonly<{
             decode: (input: unknown) => import("../../../../contracts").DecodeResult<Readonly<{
                 display: EventCalendarDisplay;
                 hydration: Readonly<{
+                    calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                     siteId: string;
                     stage?: "preview" | "published";
                     prefetchedEvents: boolean;
@@ -125,6 +128,7 @@ export declare const eventCalendarInteractiveIslandPropsCodec: Readonly<{
         } & Readonly<{
             display: EventCalendarDisplay;
             hydration: Readonly<{
+                calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                 siteId: string;
                 stage?: "preview" | "published";
                 prefetchedEvents: boolean;
@@ -153,6 +157,7 @@ export declare const eventCalendarInteractiveIslandPropsCodec: Readonly<{
         } & Readonly<{
             display: EventCalendarDisplay;
             hydration: Readonly<{
+                calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                 siteId: string;
                 stage?: "preview" | "published";
                 prefetchedEvents: boolean;

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

@@ -34,6 +34,7 @@ export type EventCombinedClientProps = Readonly<{
     emptyMessage?: string;
     className?: string;
     calendarContext: EventCollectionHydration['calendarContext'];
+    calendarWindow?: EventCollectionHydration['calendarWindow'];
 }>;
 export type EventCombinedIslandClientProps = EventCombinedInteractiveIslandProps;
 /**

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

@@ -21,7 +21,8 @@ export type EventCombinedInteractiveIslandProps = InteractiveIslandProps<EventCo
 export declare const eventCombinedBlockRuntime: Readonly<{
     kind: "progressive";
     buildRender: (source: Readonly<{
-        events?: import("../event-registration").PublicEvent[] | null;
+        calendarWindow?: import("../../../../contracts").CalendarWindowPage | null;
+        events?: import("../../../../../../api/src/index").PublicEvent[] | null;
         siteId: string;
         apiBaseUrl?: string;
         stage?: "preview" | "published";
@@ -56,6 +57,7 @@ export declare const eventCombinedBlockRuntime: Readonly<{
     }>) => Readonly<{
         display: EventCombinedDisplay;
         hydration: Readonly<{
+            calendarWindow?: import("../../../../contracts").CalendarWindowPage;
             siteId: string;
             stage?: "preview" | "published";
             prefetchedEvents: boolean;
@@ -75,7 +77,8 @@ export declare const eventCombinedBlockRuntime: Readonly<{
     contracts: Readonly<{
         source: Readonly<{
             encode: (value: Readonly<{
-                events?: import("../event-registration").PublicEvent[] | null;
+                calendarWindow?: import("../../../../contracts").CalendarWindowPage | null;
+                events?: import("../../../../../../api/src/index").PublicEvent[] | null;
                 siteId: string;
                 apiBaseUrl?: string;
                 stage?: "preview" | "published";
@@ -109,7 +112,8 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                 bookingTimeZone?: string;
             }>) => unknown;
             decode: (input: unknown) => import("../../../../contracts").DecodeResult<Readonly<{
-                events?: import("../event-registration").PublicEvent[] | null;
+                calendarWindow?: import("../../../../contracts").CalendarWindowPage | null;
+                events?: import("../../../../../../api/src/index").PublicEvent[] | null;
                 siteId: string;
                 apiBaseUrl?: string;
                 stage?: "preview" | "published";
@@ -147,6 +151,7 @@ export declare const eventCombinedBlockRuntime: Readonly<{
             encode: (value: Readonly<{
                 display: EventCombinedDisplay;
                 hydration: Readonly<{
+                    calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                     siteId: string;
                     stage?: "preview" | "published";
                     prefetchedEvents: boolean;
@@ -166,6 +171,7 @@ export declare const eventCombinedBlockRuntime: Readonly<{
             decode: (input: unknown) => import("../../../../contracts").DecodeResult<Readonly<{
                 display: EventCombinedDisplay;
                 hydration: Readonly<{
+                    calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                     siteId: string;
                     stage?: "preview" | "published";
                     prefetchedEvents: boolean;
@@ -197,6 +203,7 @@ export declare const eventCombinedInteractiveIslandPropsCodec: Readonly<{
         } & Readonly<{
             display: EventCombinedDisplay;
             hydration: Readonly<{
+                calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                 siteId: string;
                 stage?: "preview" | "published";
                 prefetchedEvents: boolean;
@@ -225,6 +232,7 @@ export declare const eventCombinedInteractiveIslandPropsCodec: Readonly<{
         } & Readonly<{
             display: EventCombinedDisplay;
             hydration: Readonly<{
+                calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                 siteId: string;
                 stage?: "preview" | "published";
                 prefetchedEvents: boolean;

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

@@ -0,0 +1,164 @@
+import type { PublicEvent, PublicEventAttendanceMode, PublicEventAttendanceModeAvailability } from '../../../../blocks/events/shared/types';
+/**
+ * The four fields capacity maths needs. Satisfied by a `PublicEvent`, by the
+ * wizard's `RegistrationEvent`, and by a single attendance-mode availability
+ * row, so one helper can answer for the whole event or for one mode.
+ */
+export type EventCapacitySource = Pick<PublicEvent, 'capacity' | 'registeredCount' | 'availableSpots' | 'waitlistEnabled'>;
+export type EventAvailability = {
+    /** Remaining spots. `null` when the event has no capacity cap. */
+    available: number | null;
+    /** True when the event has a cap and no spots remain. */
+    isFull: boolean;
+};
+/**
+ * Compute remaining spots for an event from `availableSpots` with a fallback
+ * to `capacity - registeredCount`. Returns `{ available: null, isFull: false }`
+ * for uncapped events so call sites can render no capacity indicator at all.
+ *
+ * The single source of truth for capacity math across event cards, agenda
+ * rows, and timetable cells — keep wording variations in the call sites.
+ */
+export declare function getEventAvailability(event: EventCapacitySource): EventAvailability;
+type EventWithAttendanceModes = EventCapacitySource & {
+    attendanceModes?: readonly PublicEventAttendanceModeAvailability[] | null;
+};
+/**
+ * Pick the capacity row a booking decision should read: the selected
+ * attendance mode's availability when the visitor has chosen one and the
+ * event publishes it, otherwise the event-level aggregate.
+ *
+ * The mode row is used wholesale. A mode with `capacity: null` on a capped
+ * event is uncapped *by design*: the registration write path applies the
+ * same rule via `getEffectiveOccurrenceCapacityForAttendanceMode`, so falling
+ * back to the event's `availableSpots` here would block bookings the server
+ * accepts. (Waitlist claims are still occurrence-scoped; see issue 1377.)
+ */
+export declare function selectEventCapacitySource(event: EventWithAttendanceModes, attendanceMode?: PublicEventAttendanceMode | null): EventCapacitySource;
+/**
+ * Whether the visitor's next step is the waitlist: the source is full *and*
+ * a waitlist is open. The one place this is decided — cards, rows, the
+ * wizard's steps and its action bar all route through here so they agree,
+ * including for producers that omit `availableSpots` and rely on the
+ * `capacity - registeredCount` fallback.
+ */
+export declare function canJoinEventWaitlist(event: EventWithAttendanceModes, options?: {
+    attendanceMode?: PublicEventAttendanceMode | null;
+}): boolean;
+/**
+ * Remaining places at or below which an event reads as scarce and the exact
+ * count is worth showing. Above it, no number is shown at all: "147 places
+ * left" is not something a visitor acts on, and it is the figure most likely
+ * to be stale on a cached page.
+ *
+ *   max( min(3, ceil(capacity * 0.25)), ceil(capacity * 0.05) )
+ *
+ * The 25% arm stops small groups shouting early (3 of 4 is not urgency); the
+ * 5% floor stops large events staying silent until three remain.
+ * capacity 4 -> 1, 12 -> 3, 40 -> 3, 100 -> 5, 200 -> 10.
+ */
+export declare function lowCapacityThreshold(capacity: number): number;
+/**
+ * The remaining-places state every surface renders from. `open` deliberately
+ * carries no count: nothing should show one above the threshold, and logic
+ * that needs the number (quantity caps) reads {@link getEventAvailability}.
+ */
+export type RemainingPlaces = {
+    kind: 'unlimited';
+} | {
+    kind: 'open';
+} | {
+    kind: 'low';
+    remaining: number;
+} | {
+    kind: 'full';
+    waitlist: boolean;
+};
+export declare function getRemainingPlaces(source: EventCapacitySource): RemainingPlaces;
+export type RemainingPlacesWording = Readonly<{
+    /** Label when full with no waitlist. Defaults to "Full". */
+    full?: string;
+    /** Label when full with a waitlist open. Defaults to "Waitlist". */
+    waitlist?: string;
+    /** "2 left" instead of "2 places left", for pills and timetable cells. */
+    compact?: boolean;
+}>;
+/**
+ * The one place a remaining-places count becomes text. Returns `null` when
+ * nothing should be shown: uncapped events, and capped events above the
+ * scarcity threshold. Surfaces that need their own full-state wording pass
+ * it in rather than re-deriving the count.
+ */
+export declare function formatRemainingPlaces(source: EventCapacitySource, wording?: RemainingPlacesWording): string | null;
+/**
+ * Ticket types publish only what is left, never a total, so the capacity
+ * threshold cannot apply. The absolute arm of {@link lowCapacityThreshold}
+ * is used on its own: the count shows at three or fewer, otherwise nothing.
+ */
+export declare const TICKET_TYPE_LOW_COUNT = 3;
+export declare function formatTicketTypeRemaining(remainingCapacity: number | null): string | null;
+/** Total capacity as copy ("12 places"), for detail surfaces that state the size of an event. */
+export declare function formatTotalCapacity(capacity: number | null): string | null;
+/**
+ * Three-state availability status for compact boards and pills.
+ * - `available`: uncapped, or above the scarcity threshold. No label.
+ * - `filling`: at or below {@link lowCapacityThreshold}. Label is the compact count.
+ * - `waitlist`: full. Label reflects whether a waitlist is open.
+ */
+export type EventAvailabilityStatus = 'available' | 'filling' | 'waitlist';
+export type EventAvailabilityDetail = {
+    status: EventAvailabilityStatus;
+    /** Remaining spots. `null` when the event has no capacity cap. */
+    available: number | null;
+    isFull: boolean;
+    /** Short pill label, e.g. "2 left", "Waitlist", "Full". `null` when nothing should show. */
+    label: string | null;
+};
+export declare function getEventAvailabilityStatus(event: HybridEventCapacitySource): EventAvailabilityDetail;
+/**
+ * An event as the browse surfaces see it: the aggregate capacity fields plus
+ * the delivery mode and the per-mode rows. `PublicEvent` satisfies it.
+ */
+export type HybridEventCapacitySource = EventWithAttendanceModes & {
+    deliveryMode?: PublicEvent['deliveryMode'];
+};
+/** Remaining places for each side of a hybrid event. */
+export type HybridRemainingPlaces = Readonly<{
+    inPerson: RemainingPlaces;
+    online: RemainingPlaces;
+}>;
+/**
+ * Per-mode remaining places for a hybrid event, or `null` when the event is
+ * not hybrid or does not publish both rows — in which case the aggregate is
+ * all there is and the existing single-label helpers apply.
+ */
+export declare function getHybridAvailability(event: HybridEventCapacitySource): HybridRemainingPlaces | null;
+/**
+ * The capacity row a whole-event decision should read: the most open
+ * attendance mode of a hybrid event, otherwise the aggregate. A hybrid event
+ * is sold out only when both of its modes are, and its waitlist is reachable
+ * when either full mode has one open.
+ */
+export declare function selectMostOpenCapacitySource(event: HybridEventCapacitySource): EventCapacitySource;
+/** True when no attendance mode has room. Hybrid-aware; use this for sold-out decisions. */
+export declare function isEventFull(event: HybridEventCapacitySource): boolean;
+/**
+ * True when the event is full on every mode and at least one of those full
+ * modes has a waitlist open. An event with a mode still bookable is not a
+ * waitlist prospect: it should send the visitor to that mode instead.
+ */
+export declare function canJoinEventWaitlistOnAnyMode(event: HybridEventCapacitySource): boolean;
+/**
+ * The browse-surface label for an event's remaining places. Single-mode
+ * events get exactly the aggregate label {@link formatRemainingPlaces}
+ * produces, and so does a hybrid event whose two modes tell the same story.
+ * When the modes differ, both sides are named: "available" on a card is a
+ * promise the registration wizard would otherwise have to break.
+ *
+ * Hybrid examples, in person full with 3 online places left:
+ *   default                -> "Online: 3 places left · In person: Full"
+ *   { full: 'Sold out' }   -> "Online: 3 places left · In person: Sold out"
+ *   { compact: true }      -> "Online: 3 left"
+ */
+export declare function formatEventRemainingPlaces(event: HybridEventCapacitySource, wording?: RemainingPlacesWording): string | null;
+export {};

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

@@ -0,0 +1,29 @@
+/**
+ * Booking call-to-action resolution for events: where an event links to and
+ * what the button says. Sold-out and waitlist decisions come from capacity.ts
+ * so cards, rows and the wizard never disagree.
+ */
+import type { PublicEvent } from '../../../../blocks/events/shared/types';
+export type ResolvedEventCta = {
+    label: string;
+    href: string;
+    external: boolean;
+    /**
+     * True when no booking CTA should render (e.g. sold out with no waitlist).
+     * This does NOT mean the event is unreachable: cards and rows link the
+     * title to the event page regardless, so a hidden CTA is never a dead end.
+     */
+    hidden: boolean;
+};
+export declare function resolveEventHref(event: PublicEvent): string;
+export declare function resolveEventLinkProps(event: PublicEvent): {
+    href: string;
+    target?: '_blank';
+    rel?: string;
+};
+/**
+ * Resolve the CTA state for an event.
+ * Shared by EventCard and EventCompactRow to keep sold-out, registration-closed,
+ * and course-specific defaults consistent.
+ */
+export declare function resolveEventCta(event: PublicEvent, buttonText?: string | null): ResolvedEventCta;

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

@@ -0,0 +1,47 @@
+/**
+ * Date and time presentation for events: the single place an event's
+ * timestamps become strings or date buckets. Calendar-grid primitives are
+ * re-exported from @riverbankcms/calendar so block code has one import.
+ */
+import type { PublicEvent } from '../../../../blocks/events/shared/types';
+export { DAY_NAMES, MONTH_NAMES } from '../../../../../../../calendar/src/index';
+export type { WeekStart } from '../../../../../../../calendar/src/index';
+type DateTimeFormatOptions = {
+    /** When omitted, runtime local timezone is used. */
+    timeZone?: string | null;
+    locale?: string;
+};
+/**
+ * Format date for display.
+ * Returns: "Monday, January 15, 2025"
+ */
+export declare function formatDate(isoTimestamp: string, options?: DateTimeFormatOptions): string;
+/**
+ * Format time for display.
+ * Returns: "10:00 AM"
+ */
+export declare function formatTime(isoTimestamp: string, options?: DateTimeFormatOptions): string;
+export declare function formatEventDateParts(args: {
+    startsAt: string;
+    endsAt: string;
+    timeZone?: string | null;
+    locale?: string;
+}): {
+    date: string;
+    timeRange: string;
+};
+export type EventCompactDateRail = Readonly<{
+    weekday: string;
+    day: string;
+    month: string;
+    label: string;
+}>;
+export declare function formatEventCompactDateRail(isoTimestamp: string, options?: DateTimeFormatOptions): EventCompactDateRail;
+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';
+/**
+ * Group events by their local date (YYYY-MM-DD key in each event's own
+ * timezone). Thin domain wrapper over `groupItemsByDate` from the calendar
+ * package; preserves the historical `Map<string, PublicEvent[]>` shape.
+ */
+export declare function groupEventsByDate(events: PublicEvent[], calendarTimeZone: string): Map<string, PublicEvent[]>;

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

@@ -0,0 +1,14 @@
+/**
+ * Event domain helpers: pure functions that turn event data into strings,
+ * numbers, hrefs and decisions. One file per concept, no React.
+ *
+ * If you are about to format a date, a price, a name, a capacity count or a
+ * CTA for an event inline in a component, the function belongs here instead.
+ * Components in ../shared and the registration wizard import from this barrel.
+ */
+export * from './capacity';
+export * from './cta';
+export * from './dates';
+export * from './destination';
+export * from './people';
+export * from './pricing';

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

@@ -0,0 +1,6 @@
+/**
+ * People presentation for events: teacher lines and name lists.
+ */
+import type { PublicEvent } from '../../../../blocks/events/shared/types';
+export declare function formatTeamMemberNames(names: readonly string[]): string | null;
+export declare function formatEventTeacherLine(event: PublicEvent): string | null;

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

@@ -0,0 +1,24 @@
+import { type PublicEventPricing } from '../../../../../../../core/src/index';
+import type { PublicEvent } from '../../../../blocks/events/shared/types';
+/**
+ * Format event price for display.
+ * @returns "Free", "£25", "£12 - £25", "Free / £12 - £25", "Course (From £40)", etc.
+ *
+ * Events render compact amounts (no trailing ".00"); the actual ADT→string
+ * mapping lives in `formatBookingPriceDisplay` in @riverbankcms/core so all
+ * surfaces stay consistent.
+ */
+export declare function formatEventPrice(event: PublicEvent): string;
+/**
+ * Format an event's price directly from its pricing value (without the full
+ * event). Same output as {@link formatEventPrice}.
+ */
+export declare function formatEventPriceDisplay(pricing: PublicEventPricing): string;
+/**
+ * Format one exact money amount from the canonical Event pricing projection.
+ *
+ * Used where a surface has an amount rather than a whole pricing model — a
+ * discount line, a single run price. Amounts render exactly (trailing minor
+ * units kept) because these sit next to other exact figures.
+ */
+export declare function formatEventPriceAmount(amount: number, currency: string, locale?: string): string;

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

@@ -0,0 +1,11 @@
+import React from 'react';
+/**
+ * Heading for an offering card or row. Links to the offering's page when one
+ * exists so a sold-out or closed offering stays reachable (issue 1372); the
+ * `.event-title-link` rule lives in theme-core's event-list.css.
+ */
+export declare function OfferingTitle({ className, path, title, }: Readonly<{
+    className: string;
+    path: string | null;
+    title: string;
+}>): React.JSX.Element;