@riverbankcms/sdk 0.134.0 → 0.135.1

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

@@ -1,5 +1,5 @@
 import type { DiscountContext } from '../../api/types';
-import type { EventTicketSelectionLine, EventRegistrationClientProps, FormData, Guest, GuestErrors, PaymentSelection, PaymentStepState, PublicEvent, RegistrationEvent, RegistrationResult, RegistrationStep } from './types';
+import type { EventTicketSelectionLine, EventRegistrationClientProps, EligibilityData, FormData, Guest, GuestErrors, PaymentSelection, PaymentStepState, PublicEvent, RegistrationEvent, RegistrationResult, RegistrationStep } from './types';
 import { usePortalAuth, useEligibility, useExistingEventRegistration } from './hooks';
 import { useWaitlistClaim } from '../../shared/useWaitlistClaim';
 import { useEventRegistrationStripeReturn } from './useEventRegistrationStripeReturn';
@@ -18,6 +18,7 @@ export type UseEventRegistrationWizardOptions = Readonly<{
     occurrenceContext: EventRegistrationClientProps['occurrenceContext'];
     subject?: EventRegistrationClientProps['subject'];
     events: PublicEvent[];
+    wholeSeriesOfferings?: EventRegistrationClientProps['wholeSeriesOfferings'];
     maxTicketsNum: number;
 }>;
 export type EventRegistrationWizardDeps = Readonly<{
@@ -42,7 +43,7 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
         overrides?: Record<string, unknown> | null | undefined;
     } | null | undefined;
     registrationTarget: Readonly<{
-        occurrenceId: string;
+        subject: import("./types").RegistrationSubject;
         selectedEventId: string | null;
     }> | null;
     subject: import("./eventScope").EventRegistrationPageSurfaceSubject | null | undefined;
@@ -114,12 +115,19 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     paymentSelection: PaymentSelection;
     isMembershipFastTrack: boolean;
     waitlistClaim: import("../../shared/useWaitlistClaim").UseWaitlistClaimResult;
-    eligibility: import("./types").EligibilityData | null;
+    eligibility: EligibilityData | null;
     eligibilityLoading: boolean;
     eligibilityError: string | null;
     existingRegistration: import("../../api").CustomerEventRegistration | null;
     existingRegistrationLoading: boolean;
     existingRegistrationState: import("./hooks.state").ExistingRegistrationLookupState;
+    registrationState: Readonly<{
+        kind: "none";
+    }> | Readonly<{
+        kind: "booked";
+    }> | Readonly<{
+        kind: "waitlisted";
+    }>;
     hasEligibility: boolean;
     hasMembershipEligibility: boolean;
     requireGuestDetails: boolean;
@@ -155,7 +163,7 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
         overrides?: Record<string, unknown> | null | undefined;
     } | null | undefined;
     registrationTarget: Readonly<{
-        occurrenceId: string;
+        subject: import("./types").RegistrationSubject;
         selectedEventId: string | null;
     }> | null;
     subject: import("./eventScope").EventRegistrationPageSurfaceSubject | null | undefined;
@@ -227,12 +235,19 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     paymentSelection: PaymentSelection;
     isMembershipFastTrack: boolean;
     waitlistClaim: import("../../shared/useWaitlistClaim").UseWaitlistClaimResult;
-    eligibility: import("./types").EligibilityData | null;
+    eligibility: EligibilityData | null;
     eligibilityLoading: boolean;
     eligibilityError: string | null;
     existingRegistration: import("../../api").CustomerEventRegistration | null;
     existingRegistrationLoading: boolean;
     existingRegistrationState: import("./hooks.state").ExistingRegistrationLookupState;
+    registrationState: Readonly<{
+        kind: "none";
+    }> | Readonly<{
+        kind: "booked";
+    }> | Readonly<{
+        kind: "waitlisted";
+    }>;
     hasEligibility: boolean;
     hasMembershipEligibility: boolean;
     requireGuestDetails: boolean;

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

@@ -0,0 +1,20 @@
+import { type Dispatch, type SetStateAction } from 'react';
+import type { ResolveWaitlistClaimResponse } from '../../api/types';
+import type { EventTicketSelectionLine, FormData, Guest, RegistrationEvent, RegistrationStep } from './types';
+export type WaitlistClaimRestorationSetters = Readonly<{
+    setErrorMessage: Dispatch<SetStateAction<string>>;
+    setStep: (step: RegistrationStep) => void;
+    setSelectedEvent: Dispatch<SetStateAction<RegistrationEvent | null>>;
+    setAttendanceMode: Dispatch<SetStateAction<'in_person' | 'online' | null>>;
+    setTicketSelections: Dispatch<SetStateAction<EventTicketSelectionLine[]>>;
+    setSlidingAmountInput: Dispatch<SetStateAction<string>>;
+    setTicketsCount: (count: number) => void;
+    setFormData: Dispatch<SetStateAction<FormData>>;
+    setGuests: Dispatch<SetStateAction<Guest[]>>;
+}>;
+export declare function useWaitlistClaimRestoration(input: Readonly<{
+    claim: ResolveWaitlistClaimResponse | null;
+    scopedEvents: readonly RegistrationEvent[];
+    occurrenceContextId?: string;
+    setters: WaitlistClaimRestorationSetters;
+}>): void;

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

@@ -1,6 +1,9 @@
-import type { EligibilityCheckResponse } from '../../api/types';
+import type { RegistrationOptionsResponse } from '../../api/types';
 import type { EligibilityData, EligibilityEventTicketType, PublicEvent, PublicEventTicketType, RegistrationEvent } from './types';
 export declare const DEFAULT_EVENT_CURRENCY = "usd";
+export declare function getPortalSubjectEmail(profile: Readonly<{
+    email: string;
+}> | null): string | null;
 export type SelectableEventTicketType = EligibilityEventTicketType | PublicEventTicketType;
 type TicketTypeSourceEvent = PublicEvent | RegistrationEvent;
 /**
@@ -24,15 +27,6 @@ export declare function formatEventDateTime(isoTimestamp: string, options?: {
     timeZone?: string | null;
     locale?: string;
 }): string;
-/**
- * Build the registration API endpoint URL
- *
- * @param apiBaseUrl - The dashboard API base URL (e.g., "http://localhost:4000/api")
- * @param siteId - The site ID
- * @param customEndpoint - Optional custom endpoint override
- * @returns The full API endpoint URL
- */
-export declare function buildRegistrationEndpoint(apiBaseUrl: string, siteId: string, customEndpoint?: string): string;
 export { formatPrice } from '../../shared';
 /** Tooltip text shown when pass/membership redemptions are unavailable for multi-ticket bookings. */
 export declare const ENTITLEMENT_SINGLE_TICKET_TOOLTIP = "Only available for single-ticket bookings";
@@ -51,31 +45,7 @@ export declare function areEntitlementsDisabledForTicketCount(ticketsCount: numb
  * @param creditsRemaining - Credits on the pass before this booking, if known
  */
 export declare function formatPassCreditUsageLabel(creditsRemaining: number | null | undefined): string;
-/**
- * Build the eligibility check endpoint URL
- *
- * @param apiBaseUrl - The dashboard API base URL (e.g., "http://localhost:4000/api")
- * @param siteId - The site ID
- * @param customEndpoint - Optional custom endpoint override
- * @returns The full API endpoint URL
- */
-export declare function buildEligibilityEndpoint(apiBaseUrl: string, siteId: string, customEndpoint?: string): string;
-/**
- * Build the checkout endpoint URL
- *
- * @param apiBaseUrl - The dashboard API base URL (e.g., "http://localhost:4000/api")
- * @param siteId - The site ID
- * @param customEndpoint - Optional custom endpoint override
- * @returns The full API endpoint URL
- */
-export declare function buildCheckoutEndpoint(apiBaseUrl: string, siteId: string, customEndpoint?: string): string;
-/**
- * Transform API eligibility response to internal eligibility data.
- *
- * @param response - The raw API response from checkEligibility
- * @returns Transformed eligibility data for component use
- */
-export declare function transformEligibilityResponse(response: EligibilityCheckResponse): EligibilityData;
+export declare function transformRegistrationOptionsResponse(response: RegistrationOptionsResponse): EligibilityData;
 export declare function getTicketTypeAvailabilityLabel(ticketType: Pick<SelectableEventTicketType, 'availability'>): string | null;
 export declare function getVisibleTicketTypes(input: {
     event: TicketTypeSourceEvent | null;
@@ -89,24 +59,3 @@ export declare function findSelectedTicketType(input: {
     selectedTicketTypeId: string | null;
     selectedAttendanceMode?: 'in_person' | 'online' | null;
 }): SelectableEventTicketType | null;
-/**
- * Check if card payment is the only available option.
- *
- * Returns true when:
- * - Event requires payment (not free)
- * - User can pay directly (card payment enabled)
- * - User has no eligible passes
- * - User has no eligible memberships
- * - No passes are available for purchase (upsells)
- * - No memberships are available for purchase (upsells)
- *
- * Used to pre-select stripe in PaymentSelectionStep when there's only one option.
- */
-export declare function isOnlyCardPaymentAvailable(eligibility: EligibilityData | null): boolean;
-/**
- * Like `isOnlyCardPaymentAvailable`, but accounts for ticket-count rules.
- *
- * Passes/memberships (and pass/membership bundles) are disabled for multi-ticket bookings,
- * so they shouldn't prevent us auto-selecting card when they're visible-but-disabled.
- */
-export declare function isOnlyCardPaymentAvailableForTicketCount(eligibility: EligibilityData | null, ticketsCount: number): boolean;

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

@@ -0,0 +1,20 @@
+import type { ResolveWaitlistClaimResponse } from '../../api/types';
+import type { EventTicketSelectionLine, RegistrationEvent } from './types';
+export type WaitlistClaimRestoration = Readonly<{
+    ok: false;
+    message: string;
+}> | Readonly<{
+    ok: true;
+    event: RegistrationEvent | null;
+    attendanceMode: 'in_person' | 'online';
+    ticketSelections: readonly EventTicketSelectionLine[];
+    ticketsCount: number;
+    slidingAmountInput: string | null;
+}>;
+export declare function resolveWaitlistClaimRestoration(input: Readonly<{
+    claim: ResolveWaitlistClaimResponse;
+    scopedEvents: readonly RegistrationEvent[];
+    occurrenceContextId?: string;
+}>): WaitlistClaimRestoration;
+export declare function resolveClaimedTicketSelections(claim: ResolveWaitlistClaimResponse | null): readonly EventTicketSelectionLine[] | null;
+export declare function resolveClaimTicketCount(claim: ResolveWaitlistClaimResponse | null, fallback: number): number;

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

@@ -26,11 +26,7 @@ export type EventRegistrationSourceProps = Readonly<{
     maxTickets?: string | null;
     showVenue?: boolean;
     showCapacity?: boolean;
-    showSessions?: boolean;
-    showPrice?: boolean;
     successMessage?: string;
-    waitlistMessage?: string;
-    membershipMessage?: string;
     buttonVariant?: BlockButtonRole;
     overlayEnabled?: boolean;
     spamProtectionEnabled?: boolean;
@@ -54,7 +50,7 @@ export type EventRegistrationDisplay = Readonly<{
     titleText: string;
     bodyText: string;
 }>;
-export type EventRegistrationHydration = Readonly<Omit<InternalEventRegistrationClientProps, 'siteId' | 'stage' | 'registrationEndpoint' | 'eligibilityEndpoint' | 'checkoutEndpoint' | 'buttonText' | 'className'>>;
+export type EventRegistrationHydration = Readonly<Omit<InternalEventRegistrationClientProps, 'siteId' | 'stage' | 'buttonText' | 'className'>>;
 type EventRegistrationIslandMeta = Readonly<{
     siteId?: string;
     apiBaseUrl?: string;
@@ -82,11 +78,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
         maxTickets?: string | null;
         showVenue?: boolean;
         showCapacity?: boolean;
-        showSessions?: boolean;
-        showPrice?: boolean;
         successMessage?: string;
-        waitlistMessage?: string;
-        membershipMessage?: string;
         buttonVariant?: BlockButtonRole;
         overlayEnabled?: boolean;
         spamProtectionEnabled?: boolean;
@@ -100,7 +92,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
         }> | null;
     }>) => Readonly<{
         display: EventRegistrationDisplay;
-        hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
+        hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
     }>;
     contracts: Readonly<{
         source: Readonly<{
@@ -120,11 +112,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
                 maxTickets?: string | null;
                 showVenue?: boolean;
                 showCapacity?: boolean;
-                showSessions?: boolean;
-                showPrice?: boolean;
                 successMessage?: string;
-                waitlistMessage?: string;
-                membershipMessage?: string;
                 buttonVariant?: BlockButtonRole;
                 overlayEnabled?: boolean;
                 spamProtectionEnabled?: boolean;
@@ -153,11 +141,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
                 maxTickets?: string | null;
                 showVenue?: boolean;
                 showCapacity?: boolean;
-                showSessions?: boolean;
-                showPrice?: boolean;
                 successMessage?: string;
-                waitlistMessage?: string;
-                membershipMessage?: string;
                 buttonVariant?: BlockButtonRole;
                 overlayEnabled?: boolean;
                 spamProtectionEnabled?: boolean;
@@ -174,11 +158,11 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
         render: Readonly<{
             encode: (value: Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
+                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
+                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
             }>>;
         }>;
     }>;
@@ -196,7 +180,7 @@ export declare const eventRegistrationInteractiveIslandPropsCodec: Readonly<{
             mode: "event-registration";
         } & Readonly<{
             display: EventRegistrationDisplay;
-            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
+            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
         }>>;
     }>) => unknown;
     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<Readonly<{
@@ -211,7 +195,7 @@ export declare const eventRegistrationInteractiveIslandPropsCodec: Readonly<{
             mode: "event-registration";
         } & Readonly<{
             display: EventRegistrationDisplay;
-            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
+            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
         }>>;
     }>>;
 }>;

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

@@ -6,6 +6,6 @@ export type DateTimeTileProps = {
 };
 /**
  * Shared tile content for displaying date and time range.
- * Used by event-details "Other dates" and course-details "Sessions".
+ * Used by event-details "Other dates".
  */
 export declare function DateTimeTile({ startsAt, endsAt, timeZone }: DateTimeTileProps): React.JSX.Element;

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

@@ -141,8 +141,8 @@ export declare const eventCollectionSourceSchemaShape: {
     readonly filterVenueId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     readonly events: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         bookingScope: z.ZodEnum<{
-            single_occurrence: "single_occurrence";
             whole_series: "whole_series";
+            single_occurrence: "single_occurrence";
         }>;
         eventPreset: z.ZodOptional<z.ZodEnum<{
             course: "course";
@@ -632,9 +632,9 @@ export declare const eventCollectionSourceSchemaShape: {
                 currency: z.ZodString;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
-            kind: z.ZodLiteral<"course">;
+            kind: z.ZodLiteral<"whole_series">;
             display: z.ZodObject<{
-                kind: z.ZodLiteral<"course">;
+                kind: z.ZodLiteral<"whole_series">;
                 display: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"free">;
                     currency: z.ZodString;
@@ -646,6 +646,11 @@ export declare const eventCollectionSourceSchemaShape: {
                     kind: z.ZodLiteral<"from">;
                     amount: z.ZodNumber;
                     currency: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"range">;
+                    minAmount: z.ZodNumber;
+                    maxAmount: z.ZodNumber;
+                    currency: z.ZodString;
                 }, z.core.$strip>, z.ZodObject<{
                     kind: z.ZodLiteral<"unavailable">;
                     currency: z.ZodString;
@@ -880,8 +885,8 @@ export declare const eventCollectionSourceSchemaShape: {
 export declare const eventCollectionDisplaySchemaShape: {
     readonly events: z.ZodArray<z.ZodObject<{
         bookingScope: z.ZodEnum<{
-            single_occurrence: "single_occurrence";
             whole_series: "whole_series";
+            single_occurrence: "single_occurrence";
         }>;
         eventPreset: z.ZodOptional<z.ZodEnum<{
             course: "course";
@@ -1371,9 +1376,9 @@ export declare const eventCollectionDisplaySchemaShape: {
                 currency: z.ZodString;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
-            kind: z.ZodLiteral<"course">;
+            kind: z.ZodLiteral<"whole_series">;
             display: z.ZodObject<{
-                kind: z.ZodLiteral<"course">;
+                kind: z.ZodLiteral<"whole_series">;
                 display: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"free">;
                     currency: z.ZodString;
@@ -1385,6 +1390,11 @@ export declare const eventCollectionDisplaySchemaShape: {
                     kind: z.ZodLiteral<"from">;
                     amount: z.ZodNumber;
                     currency: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"range">;
+                    minAmount: z.ZodNumber;
+                    maxAmount: z.ZodNumber;
+                    currency: z.ZodString;
                 }, z.core.$strip>, z.ZodObject<{
                     kind: z.ZodLiteral<"unavailable">;
                     currency: z.ZodString;

package/dist/_dts/blocks/src/system/runtime/nodes/offerings-preview.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { PublicCourse } from '../../blocks/courses/shared/types';
+import type { PublicWholeSeriesOffering } from '../../blocks/events/whole-series/types';
 import type { ButtonVariant, PublicEvent } from '../../blocks/events/shared/types';
 import type { CardStylesContent } from '../../fields/boxStyles';
 import { type BookingOfferingPresetSummary, type OfferingsPreviewEventDataKey, type OfferingsPreviewGroupOrder, type OfferingsPreviewGroupOverride, type OfferingsPreviewRouteCandidate } from '../../blocks/offerings-preview/model';
@@ -17,7 +17,7 @@ type OfferingsPreviewProps = Readonly<{
     routeCandidates?: Readonly<{
         routes?: readonly OfferingsPreviewRouteCandidate[] | null;
     }> | null;
-    courses?: readonly PublicCourse[] | null;
+    wholeSeriesOfferings?: readonly PublicWholeSeriesOffering[] | null;
 }> & Partial<Record<OfferingsPreviewEventDataKey, readonly PublicEvent[] | null>>;
 export declare function OfferingsPreviewNode(props: OfferingsPreviewProps): React.JSX.Element | null;
 export default OfferingsPreviewNode;

package/dist/_dts/blocks/src/system/runtime/shared/bookingPaymentOptions.d.ts

@@ -1,4 +1,4 @@
-import type { BlockBookingPaymentTerms } from '../../blocks/shared/bookingPaymentTerms';
+import type { BlockBookingPaymentCollectionOption, BlockBookingPaymentTerms } from '../../blocks/shared/bookingPaymentTerms';
 export type BookingPaymentSelectionKind = 'upfront' | 'deferred_manual' | 'instalment_plan' | 'flexible_balance';
 export type BookingPaymentOptionSummaryRow = Readonly<{
     label: string;
@@ -18,6 +18,11 @@ export type BookingPaymentSelectionViewModel = Readonly<{
     serviceTitle: string;
     options: readonly BookingPaymentOptionViewModel[];
 }>;
+export declare function resolveBookingPaymentDueNowCents(input: Readonly<{
+    option: BlockBookingPaymentCollectionOption;
+    totalCents: number;
+    bookingStartAt?: string | null;
+}>): number;
 export declare function buildBookingPaymentSelectionViewModel(input: Readonly<{
     serviceTitle: string;
     paymentTerms?: BlockBookingPaymentTerms;

package/dist/_dts/blocks/src/system/runtime/shared/components/DiscountCodeDisclosure.d.ts

@@ -1,19 +1,7 @@
 import type React from 'react';
-type BlockDiscountCodeSurface = 'event-registration' | 'whole-series-registration';
+type BlockDiscountCodeSurface = 'event-registration';
 export type DiscountCodeDisclosureSurface = BlockDiscountCodeSurface | 'theme-form';
 export declare const BLOCK_DISCOUNT_CODE_DISCLOSURE_CLASSES: {
-    readonly 'whole-series-registration': {
-        readonly root: "er-whole-series-discount";
-        readonly toggle: "er-whole-series-discount__toggle";
-        readonly form: "er-whole-series-discount__form";
-        readonly label: "er-whole-series-discount__label";
-        readonly row: "er-whole-series-discount__row";
-        readonly input: "er-whole-series-discount__input";
-        readonly apply: "er-whole-series-discount__apply";
-        readonly remove: "er-whole-series-discount__remove";
-        readonly hint: "er-whole-series-discount__hint";
-        readonly feedback: "er-whole-series-discount__feedback";
-    };
     readonly 'event-registration': {
         readonly root: "er-discount";
         readonly toggle: "er-discount__toggle";

package/dist/_dts/blocks/src/system/runtime/shared/components/LoggedInAsUser.d.ts

@@ -4,7 +4,7 @@ export type LoggedInAsUserProps = {
     email: string;
     /** Optional logout handler. If provided, shows "Not you? Log out" link. */
     onLogout?: () => void;
-    /** CSS class prefix for styling (e.g., 'er' for event-registration, 'cr' for course-registration) */
+    /** CSS class prefix for the owning registration surface. */
     classPrefix: string;
 };
 /**

package/dist/_dts/blocks/src/system/runtime/shared/components/MembershipHero.d.ts

@@ -2,7 +2,7 @@
  * Celebratory UI shown when user's membership covers the course/event.
  * Displays confirmation that no payment is required.
  *
- * Supports both course-registration (cr-*) and event-registration (er-*) class prefixes.
+ * Supports registration surfaces with a caller-provided class prefix.
  */
 type MembershipHeroProps = {
     /** Name of the membership that covers this item */

package/dist/_dts/blocks/src/system/runtime/shared/components/StateIcon.d.ts

@@ -8,7 +8,7 @@ type StateIconProps = {
  * Circular icon wrapper for terminal state screens (success, error, waitlist, etc.).
  *
  * Layout is provided by shared `rb-state-icon` CSS; color variants are
- * block-scoped (e.g., scoped to `[data-block="course-registration"]`).
+ * block-scoped by the owning registration surface.
  */
 export declare function StateIcon({ variant, children }: StateIconProps): import("react").JSX.Element;
 export {};

package/dist/_dts/blocks/src/system/runtime/shared/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared Registration Components and Utilities
  *
- * This module provides shared code for course-registration and event-registration blocks.
+ * Shared registration components and utilities.
  */
 export type { FormData, ButtonVariant } from './types';
 export { DEFAULT_CURRENCY } from './types';

package/dist/_dts/blocks/src/system/runtime/shared/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared Registration Types
  *
- * Common types used by both course-registration and event-registration blocks.
+ * Common types used by public registration blocks.
  */
 import type { BlockButtonRole } from '../../constants/buttonRoles';
 /**

package/dist/_dts/blocks/src/system/runtime/shared/utils/checkoutUrls.d.ts

@@ -5,10 +5,10 @@
  * and include the block anchor hash for post-redirect scroll targeting.
  *
  * @param paramName - Query parameter name to add (e.g., 'enrollment', 'registration')
- * @param anchorId - Block anchor ID for hash fragment (e.g., 'course-registration')
+ * @param anchorId - Block anchor ID for the return URL hash fragment.
  * @returns Object with success and cancel URLs
  */
-export declare function buildCheckoutReturnUrls(paramName: string, anchorId: string): {
+export declare function buildCheckoutReturnUrls(paramName: string, anchorId: string, returnParams?: Readonly<Record<string, string>>): {
     successUrl: string;
     cancelUrl: string;
 };

package/dist/_dts/commerce/src/index.d.ts

@@ -0,0 +1,16 @@
+export { assertNever } from './utils/assertNever';
+export type { Json } from './types/json';
+export * from './money';
+export * from './moneyContracts';
+export * from './moneyDateUtils';
+export * from './moneyPayments';
+export * from './moneyReceiptReadModel';
+export * from './moneyPlanningTime';
+export * from './moneyReport';
+export * from './moneyReportPage';
+export * from './waitlists';
+export * from './shop/digitalFulfillment';
+export * from './shop/fulfillmentStatus';
+export * from './shop/shipmentEligibility';
+export * from './shop/shippingAddress';
+export * from './shop/inventoryRestore';

package/dist/_dts/commerce/src/money.d.ts

@@ -0,0 +1,122 @@
+import { type Result, type EventCategoryId, type EventSeriesId, type MembershipId, type MoneyDateString, type PassId, type ProductId, type VenueId } from '../../core/src/index';
+import { type MoneyPlanningTimeInput } from './moneyPlanningTime';
+export declare const MONEY_PERIOD_PRESETS: readonly ["1d", "7d", "30d", "90d", "365d"];
+export type MoneyPeriodPreset = (typeof MONEY_PERIOD_PRESETS)[number];
+export declare const MONEY_ITEM_KINDS: readonly ["event", "event_series_registration", "pass", "membership", "product"];
+export type MoneyItemKind = (typeof MONEY_ITEM_KINDS)[number];
+export type MoneyPeriod = Readonly<{
+    kind: 'preset';
+    preset: MoneyPeriodPreset;
+    from?: never;
+    to?: never;
+}> | Readonly<{
+    kind: 'custom';
+    from: MoneyDateString;
+    to: MoneyDateString;
+    preset?: never;
+}>;
+export type MoneyDateRange = Readonly<{
+    from: MoneyDateString;
+    to: MoneyDateString;
+}>;
+export type MoneyEntityFilters = Readonly<{
+    eventSeriesIds: readonly EventSeriesId[];
+    eventCategoryIds: readonly EventCategoryId[];
+    venueIds: readonly VenueId[];
+    passIds: readonly PassId[];
+    membershipIds: readonly MembershipId[];
+    productIds: readonly ProductId[];
+    discountCodes: readonly string[];
+}>;
+export type MoneyFilterState = Readonly<{
+    period: MoneyPeriod;
+    itemKinds: readonly MoneyItemKind[];
+    entities: MoneyEntityFilters;
+}>;
+export type MoneyFilterSelection = Readonly<{
+    itemKinds: readonly MoneyItemKind[];
+    entities: MoneyEntityFilters;
+}>;
+export type MoneyQueryRange = Readonly<{
+    kind: 'all';
+}> | MoneyPeriod;
+export type MoneyQueryParamKey = 'period' | 'from' | 'to' | 'kind' | 'event' | 'category' | 'venue' | 'pass' | 'membership' | 'product' | 'discount';
+export type MoneyFilterQuery = Readonly<{
+    period?: MoneyPeriodPreset;
+    from?: string;
+    to?: string;
+    kind?: MoneyItemKind[];
+    event?: string[];
+    category?: string[];
+    venue?: string[];
+    pass?: string[];
+    membership?: string[];
+    product?: string[];
+    discount?: string[];
+}>;
+type MoneyQueryRangeInput = Readonly<{
+    period?: string;
+    from?: string;
+    to?: string;
+}>;
+export type MoneyFilterParseIssue = Readonly<{
+    kind: 'invalid_period_preset';
+    value: string;
+}> | Readonly<{
+    kind: 'invalid_date';
+    field: 'from' | 'to';
+    value: string;
+}> | Readonly<{
+    kind: 'invalid_date_range';
+    from: string;
+    to: string;
+}> | Readonly<{
+    kind: 'partial_custom_range';
+    from: string | null;
+    to: string | null;
+}> | Readonly<{
+    kind: 'invalid_item_kind';
+    value: string;
+}> | Readonly<{
+    kind: 'empty_filter_value';
+    field: Exclude<MoneyQueryParamKey, 'period' | 'from' | 'to' | 'kind'>;
+}>;
+export type MoneyFilterParseResult = Readonly<{
+    value: MoneyFilterState;
+    issues: readonly MoneyFilterParseIssue[];
+}>;
+export type MoneyQueryRangeError = Readonly<{
+    kind: 'invalid_period';
+    value: string;
+}> | Readonly<{
+    kind: 'invalid_date';
+    field: 'from' | 'to';
+    value: string;
+}> | Readonly<{
+    kind: 'invalid_date_range';
+    from: string;
+    to: string;
+}> | Readonly<{
+    kind: 'partial_custom_range';
+    from: string | null;
+    to: string | null;
+}>;
+export declare const DEFAULT_MONEY_FILTER_STATE: MoneyFilterState;
+export declare function isMoneyDateString(value: string): value is MoneyDateString;
+export declare function parseMoneyDateString(value: string): MoneyDateString | null;
+export declare function isMoneyPeriodPreset(value: unknown): value is MoneyPeriodPreset;
+export declare function isMoneyItemKind(value: unknown): value is MoneyItemKind;
+export declare function createDefaultMoneyFilterState(): MoneyFilterState;
+export declare function createDefaultMoneyFilterSelection(): MoneyFilterSelection;
+export declare function resolveMoneyDateRange(period: MoneyPeriod, options?: MoneyPlanningTimeInput): MoneyDateRange;
+export declare function parseMoneyFilterState(searchParams: URLSearchParams): MoneyFilterParseResult;
+export declare function serializeMoneyFilterState(filters: MoneyFilterState): URLSearchParams;
+export declare function moneyFilterStateToQuery(filters: MoneyFilterState, options?: Readonly<{
+    includePeriod?: boolean;
+}>): MoneyFilterQuery;
+export declare function moneyFilterStateToSelection(filters: MoneyFilterState): MoneyFilterSelection;
+export declare function moneyFilterSelectionFromQuery(query: Pick<MoneyFilterQuery, 'kind' | 'event' | 'category' | 'venue' | 'pass' | 'membership' | 'product' | 'discount'>): MoneyFilterSelection;
+export declare function resolveMoneyQueryRange(query: MoneyQueryRangeInput, options?: Readonly<{
+    defaultPreset?: MoneyPeriodPreset;
+}>): Result<MoneyQueryRange, MoneyQueryRangeError>;
+export {};