@riverbankcms/sdk 0.135.1 → 0.137.0

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,31 @@
+import { type PublicEventPricing } from '../../../../../../../core/src/index';
+import type { PublicEvent, PublicEventTicketType } from '../../../../blocks/events/shared/types';
+type RuntimeEventPricingSource = {
+    destination?: unknown;
+    eventDestinationMode?: unknown;
+    path?: unknown;
+    pricing?: unknown;
+    requiresRegistration?: boolean | null;
+    pricingType?: unknown;
+    price?: unknown;
+    currency?: unknown;
+    priceDisplay?: unknown;
+    pricingMode?: unknown;
+    ticketTypes?: unknown;
+};
+export declare function resolveRuntimeEventPricing(event: RuntimeEventPricingSource): PublicEventPricing<PublicEventTicketType>;
+/**
+ * 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<unknown>): string;
+export {};

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

@@ -1,12 +1,14 @@
 import * as React from 'react';
+import type { CalendarDate } from '../../../../../../../calendar/src/index';
 import type { PublicEvent } from '../../../../blocks/events/shared/types';
 export type CalendarDayCellProps = {
     /** The date this cell represents */
-    date: Date;
+    date: CalendarDate;
     /** Events occurring on this date */
     events: PublicEvent[];
     /** Whether this date is in the currently viewed month */
     isCurrentMonth: boolean;
+    today: CalendarDate;
 };
 /**
  * CalendarDayCell - Renders a single day in the calendar grid

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

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function CalendarNavigationChevron({ direction, }: Readonly<{
+    direction: 'previous' | 'next';
+}>): React.ReactElement;

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

@@ -1,7 +1,8 @@
 import React from 'react';
+import type { CalendarDate } from '../../../../../../../calendar/src/index';
 import type { PublicEvent } from '../../../../blocks/events/shared/types';
 type DayEventsModalProps = {
-    date: Date;
+    date: CalendarDate;
     events: PublicEvent[];
     showCapacity: boolean;
     onClose: () => void;

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

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { PublicEvent } from '../../../../blocks/events/shared/types';
+import type { CalendarDate } from '../../../../../../../calendar/src/index';
 /**
  * Modal state - either closed, showing a single event, or showing all events for a day
  */
@@ -10,13 +11,13 @@ type ModalState = {
     event: PublicEvent;
 } | {
     type: 'day';
-    date: Date;
+    date: CalendarDate;
     events: PublicEvent[];
 };
 interface EventModalContextValue {
     modalState: ModalState;
     openEventModal: (event: PublicEvent) => void;
-    openDayModal: (date: Date, events: PublicEvent[]) => void;
+    openDayModal: (date: CalendarDate, events: PublicEvent[]) => void;
     closeModal: () => void;
 }
 type EventModalProviderProps = {

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;

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

@@ -1,11 +1,14 @@
 import React from 'react';
+import { type CalendarDate } from '../../../../../../../calendar/src/index';
 import type { PublicEvent } from '../../../../blocks/events/shared/types';
-import { type WeekCalendarDays } from './utils';
+import { type WeekCalendarDays } from '../domain';
 type WeekAgendaViewProps = {
     days: WeekCalendarDays;
     events: PublicEvent[];
     showCapacity: boolean;
     emptyMessage?: string;
+    calendarTimeZone: string;
+    today: CalendarDate;
 };
 /**
  * WeekAgendaView Component

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

@@ -1,9 +1,33 @@
 import React from 'react';
 import type { ButtonVariant, PublicEvent } from '../../../../blocks/events/shared/types';
-import { type WeekCalendarDays } from './utils';
-type WeekBoardViewProps = {
+import { type CalendarDate } from '../../../../../../../calendar/src/index';
+import { type WeekCalendarDays, type WeekCalendarViewport } from '../domain';
+export type WeekBoardNavigationState = Readonly<{
+    rangeLabel: string;
+    isCurrentWeek: boolean;
+}>;
+export type WeekBoardLoadState = Readonly<{
+    kind: 'idle';
+}> | Readonly<{
+    kind: 'loading';
+}> | Readonly<{
+    kind: 'error';
+    onRetry: () => void;
+}>;
+export type WeekBoardNavigation = WeekBoardNavigationState & (Readonly<{
+    kind: 'static';
+}> | Readonly<{
+    kind: 'interactive';
+    loadState: WeekBoardLoadState;
+    onPrevious: () => void;
+    onNext: () => void;
+    onToday: () => void;
+}>);
+export declare function buildWeekBoardNavigationState(viewport: Pick<WeekCalendarViewport, 'days' | 'title'>, today: CalendarDate): WeekBoardNavigationState;
+export type WeekBoardViewProps = {
     days: WeekCalendarDays;
     events: PublicEvent[];
+    navigation: WeekBoardNavigation;
     showCapacity: boolean;
     emptyMessage?: string;
     /** Optional board title shown in the top bar. Hidden when empty. */
@@ -19,6 +43,8 @@ type WeekBoardViewProps = {
     elevated?: boolean;
     /** Opt-in section band. Generic default is bandless. */
     banded?: boolean;
+    calendarTimeZone: string;
+    today: CalendarDate;
 };
 type WeekBoardDisplay = Readonly<{
     events: readonly PublicEvent[];
@@ -32,8 +58,10 @@ type WeekBoardDisplay = Readonly<{
     buttonVariant?: ButtonVariant;
     elevated?: boolean;
     banded?: boolean;
+    calendarTimeZone: string;
+    today: CalendarDate;
 }>;
-export declare function buildWeekBoardViewProps(display: WeekBoardDisplay, days: WeekCalendarDays): WeekBoardViewProps;
+export declare function buildWeekBoardViewProps(display: WeekBoardDisplay, days: WeekCalendarDays, navigation: WeekBoardNavigation, events?: readonly PublicEvent[]): WeekBoardViewProps;
 /**
  * WeekBoardView
  *

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

@@ -1,7 +1,9 @@
 import React from 'react';
+import type { CalendarDate } from '../../../../../../../calendar/src/index';
 import type { PublicEvent, WeekStart } from '../../../../blocks/events/shared/types';
 type WeekTimetableViewProps = {
-    viewDate: Date;
+    viewDate: CalendarDate;
+    today: CalendarDate;
     events: PublicEvent[];
     startOfWeek: WeekStart;
     showCapacity: boolean;

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

@@ -1,5 +1,7 @@
 import { z } from "zod";
 import { type CardRole } from "../../../../../../../theme-core/src/cards/index";
+import { type BookingTimeZone } from "../../../../../../../core/src/index";
+import type { CalendarDate } from '../../../../../../../calendar/src/index';
 import type { ButtonVariant, CalendarTabViews, CalendarView, ColumnOption, EventLayout, EventScheduleScope, EventSurfaceScope, FilterAutoShow, PublicEvent, WeekStart } from "../../../../blocks/events/shared/types";
 import { type EventListPaginationAction, type EventListPaginationMode, type EventPageSize } from "./listOptions";
 import type { EventListingDisplay } from "../EventListing.interactive";
@@ -35,6 +37,7 @@ export type EventCollectionSourceProps = Readonly<{
     buttonText?: string;
     emptyMessage?: string;
     className?: string;
+    bookingTimeZone?: string;
 }>;
 export type EventCollectionDisplay = Readonly<{
     events: readonly PublicEvent[];
@@ -70,6 +73,10 @@ export type EventCollectionHydration = Readonly<{
     eventSurface: EventSurfaceScope;
     filterEventPresets: string | null;
     scheduleScope: EventScheduleScope;
+    calendarContext: Readonly<{
+        timeZone: BookingTimeZone;
+        initialToday: CalendarDate;
+    }>;
 }>;
 export declare const eventCollectionFilterSourceSchemaShape: {
     readonly showFilters: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
@@ -116,6 +123,7 @@ export declare const eventCollectionSourceSchemaShape: {
     readonly buttonText: z.ZodOptional<z.ZodString>;
     readonly emptyMessage: z.ZodOptional<z.ZodString>;
     readonly className: z.ZodOptional<z.ZodString>;
+    readonly bookingTimeZone: z.ZodOptional<z.ZodString>;
     readonly showFilters: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly showCategoryFilter: z.ZodOptional<z.ZodEnum<{
         auto: "auto";
@@ -1658,5 +1666,5 @@ export declare const eventCollectionDisplaySchemaShape: {
 };
 export declare const eventCollectionHydrationSchema: z.ZodType<EventCollectionHydration>;
 export declare function buildEventCollectionDisplay(source: EventCollectionSourceProps): EventCollectionDisplay;
-export declare function buildEventCollectionHydration(source: EventCollectionSourceProps): EventCollectionHydration;
+export declare function buildEventCollectionHydration(source: EventCollectionSourceProps, now?: Date): EventCollectionHydration;
 export declare function buildEventCollectionListingDisplay(display: EventCollectionDisplay, prefetchedEvents: boolean, className: string | null): EventListingDisplay;

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

@@ -1,8 +1,10 @@
 /**
  * Shared runtime components and utilities for event blocks
  */
-export * from './utils';
+export * from '../domain';
+export * from './listingLayout';
 export { EventCard } from './EventCard';
 export { EventCompactRow } from './EventCompactRow';
 export { EmptyState } from './EmptyState';
 export { DateTimeTile } from './DateTimeTile';
+export { OfferingTitle } from './OfferingTitle';

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

@@ -0,0 +1,23 @@
+/**
+ * Layout classes for event listing containers and cards. Presentation
+ * plumbing rather than event domain logic, so it lives beside the components.
+ */
+import type { CardOrientation, EventLayout } from '../../../../blocks/events/shared/types';
+/**
+ * Column class mappings for grid layouts, derived from the canonical
+ * responsive column ladder (see gridUserColumnLadder).
+ */
+export declare const COLUMN_CLASSES: Record<string, string>;
+/**
+ * Build container class based on layout mode
+ * @param layout - 'grid', 'stack', or 'compact'
+ * @param columns - Number of columns for grid layout ('2', '3', '4')
+ * @returns `rb-*` class string for the container
+ */
+export declare function getContainerClass(layout: EventLayout, columns: string): string;
+/**
+ * Get card orientation based on layout mode
+ * @param layout - 'grid', 'stack', or 'compact'
+ * @returns 'horizontal' for stack layout, 'vertical' for grid and compact layouts
+ */
+export declare function getCardOrientation(layout: EventLayout): CardOrientation;

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

@@ -6,7 +6,7 @@
  * categoryColor with theme fallback). Renderers (WeekTimetableView,
  * EventCalendar.server) consume this shape.
  */
-import { type WeekStart } from '../../../../../../../calendar/src/index';
+import { type WeekStart, type CalendarDate } from '../../../../../../../calendar/src/index';
 import type { PublicEvent } from '../../../../blocks/events/shared/types';
 export type TimetableEventCell = {
     event: PublicEvent;
@@ -24,7 +24,7 @@ export type TimetableEventCell = {
     isFull: boolean;
 };
 export type TimetableDay = {
-    date: Date;
+    date: CalendarDate;
     dateKey: string;
     label: string;
     shortLabel: string;
@@ -41,7 +41,8 @@ export type TimetableModel = {
 };
 type BuildTimetableModelInput = {
     events: readonly PublicEvent[];
-    viewDate: Date;
+    viewDate: CalendarDate;
+    today: CalendarDate;
     startOfWeek: WeekStart;
 };
 export declare function buildTimetableModel(input: BuildTimetableModelInput): TimetableModel;

package/dist/_dts/blocks/src/system/transforms/registry/layout.d.ts

@@ -17,7 +17,6 @@ export declare const headerLogoTextVisibleTransform: TransformDefinition;
  * Consumed by the site-header block's `$when` gates so the two classic rows are
  * mutually exclusive without introducing a new top-level header variant.
  */
-export declare const classicNavModeTransform: TransformDefinition;
 declare const maxWidthClassSchema: z.ZodObject<{
     base: z.ZodOptional<z.ZodString>;
     container: z.ZodOptional<z.ZodString>;

package/dist/_dts/calendar/src/grid.d.ts

@@ -1,87 +1,45 @@
-/**
- * Calendar grid helpers — pure date math.
- *
- * No items. No timezones beyond the runtime locale. No domain.
- * Use these to lay out month/week views; group items into the resulting
- * cells with `groupItemsByDate` from `./group`.
- */
+/** Calendar grid helpers over date-only values. */
+export type CalendarDate = Readonly<{
+    year: number;
+    month: number;
+    day: number;
+}>;
 export type WeekStart = 'sunday' | 'monday';
 export type CalendarViewportKind = 'month' | 'week';
-export type WeekCalendarDays = readonly [Date, Date, Date, Date, Date, Date, Date];
+export type WeekCalendarDays = readonly [CalendarDate, CalendarDate, CalendarDate, CalendarDate, CalendarDate, CalendarDate, CalendarDate];
 export type MonthCalendarViewport = Readonly<{
     kind: 'month';
-    anchorDate: Date;
-    days: readonly Date[];
+    anchorDate: CalendarDate;
+    days: readonly CalendarDate[];
     title: string;
 }>;
 export type WeekCalendarViewport = Readonly<{
     kind: 'week';
-    anchorDate: Date;
+    anchorDate: CalendarDate;
     days: WeekCalendarDays;
     title: string;
 }>;
 export type CalendarViewport = MonthCalendarViewport | WeekCalendarViewport;
 export declare const DAY_NAMES: readonly ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
 export declare const MONTH_NAMES: readonly ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
-/**
- * Convention default: maximum events to show per calendar day before a
- * "+N more" overflow indicator. Renderers may override.
- */
 export declare const MAX_EVENTS_PER_DAY = 3;
-/** Format a date as YYYY-MM-DD using the runtime's local timezone. */
-export declare function formatDateKey(date: Date): string;
-/**
- * True when `date` and `now` are the same local calendar day.
- * `now` defaults to `new Date()` so casual callers don't need to thread it,
- * but tests and snapshot-rendering should pass an explicit value.
- */
-export declare function isToday(date: Date, now?: Date): boolean;
-/** True when two dates fall on the same local calendar day. */
-export declare function isSameLocalDay(left: Date, right: Date): boolean;
-export declare function getStartOfMonth(date: Date): Date;
-export declare function getEndOfMonth(date: Date): Date;
-/**
- * Add (or subtract) months to a date, clamping the day-of-month to the
- * target month's last day. Avoids JS Date overflow (Jan 29 + 1 month → Mar 1
- * in non-leap years).
- */
-export declare function addMonths(date: Date, months: number): Date;
-/** Add (or subtract) days while preserving local time-of-day fields. */
-export declare function addDays(date: Date, days: number): Date;
-/** Shift a calendar anchor by the natural unit for a viewport kind. */
-export declare function shiftCalendarAnchorDate(date: Date, view: CalendarViewportKind, steps: number): Date;
-/**
- * Get an inclusive 3-month window around `date`, returned as ISO strings
- * with UTC midnight bounds. Suitable for prefetching event windows when
- * the consumer handles timezone conversion downstream.
- */
-export declare function getThreeMonthRange(date: Date): {
-    from: string;
-    to: string;
-};
-/**
- * Build the calendar days for a month view. Returns 42 dates (6 rows × 7
- * days) including padding from prior/next months for a stable grid.
- */
-export declare function getMonthCalendarDays(year: number, month: number, startOfWeek: WeekStart): Date[];
-/** Build the 7 dates of the week containing `baseDate`. */
-export declare function getWeekCalendarDays(baseDate: Date, startOfWeek: WeekStart): Date[];
-/** Build the 7 dates of the week containing `baseDate` as a fixed-width tuple. */
-export declare function getWeekCalendarDayTuple(baseDate: Date, startOfWeek: WeekStart): WeekCalendarDays;
-/**
- * Day-name labels reordered for the chosen week start. Pass a custom
- * `dayNames` array (length 7, Sunday-first) to localize.
- */
+export declare function formatDateKey(date: CalendarDate): string;
+export declare function isToday(date: CalendarDate, today: CalendarDate): boolean;
+export declare function isSameCalendarDay(left: CalendarDate, right: CalendarDate): boolean;
+export declare function getStartOfMonth(date: CalendarDate): CalendarDate;
+export declare function getEndOfMonth(date: CalendarDate): CalendarDate;
+export declare function addMonths(date: CalendarDate, months: number): CalendarDate;
+export declare function addDays(date: CalendarDate, days: number): CalendarDate;
+export declare function shiftCalendarAnchorDate(date: CalendarDate, view: CalendarViewportKind, steps: number): CalendarDate;
+export declare function getMonthCalendarDays(year: number, month: number, startOfWeek: WeekStart): CalendarDate[];
+export declare function getWeekCalendarDays(baseDate: CalendarDate, startOfWeek: WeekStart): CalendarDate[];
+export declare function getDayOfWeek(date: CalendarDate): number;
+export declare function getWeekCalendarDayTuple(baseDate: CalendarDate, startOfWeek: WeekStart): WeekCalendarDays;
 export declare function getOrderedDayNames(startOfWeek: WeekStart, dayNames?: readonly string[]): string[];
-/**
- * Header title for a calendar view.
- *   - month: "January 2025"
- *   - week:  "January 5 - 11, 2025" or "December 30 - January 5, 2025"
- */
-export declare function formatCalendarTitle(viewDate: Date, view: 'month' | 'week', days: Date[], monthNames?: readonly string[]): string;
+export declare function formatCalendarTitle(viewDate: CalendarDate, view: CalendarViewportKind, days: readonly CalendarDate[], monthNames?: readonly string[]): string;
 export declare function buildCalendarViewport(input: Readonly<{
     view: CalendarViewportKind;
-    anchorDate: Date;
+    anchorDate: CalendarDate;
     startOfWeek: WeekStart;
     monthNames?: readonly string[];
 }>): CalendarViewport;

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

@@ -1,5 +1,5 @@
-export type { CalendarViewport, CalendarViewportKind, MonthCalendarViewport, WeekCalendarDays, WeekCalendarViewport, WeekStart, } from './grid';
-export { addDays, buildCalendarViewport, getMonthCalendarDays, getWeekCalendarDays, getWeekCalendarDayTuple, getOrderedDayNames, formatCalendarTitle, formatDateKey, isToday, isSameLocalDay, addMonths, shiftCalendarAnchorDate, getStartOfMonth, getEndOfMonth, getThreeMonthRange, DAY_NAMES, MONTH_NAMES, MAX_EVENTS_PER_DAY, } from './grid';
+export type { CalendarViewport, CalendarViewportKind, CalendarDate, MonthCalendarViewport, WeekCalendarDays, WeekCalendarViewport, WeekStart, } from './grid';
+export { addDays, buildCalendarViewport, getMonthCalendarDays, getWeekCalendarDays, getWeekCalendarDayTuple, getDayOfWeek, getOrderedDayNames, formatCalendarTitle, formatDateKey, isToday, isSameCalendarDay, addMonths, shiftCalendarAnchorDate, getStartOfMonth, getEndOfMonth, DAY_NAMES, MONTH_NAMES, MAX_EVENTS_PER_DAY, } from './grid';
 export type { TimetableInput, TimetableModel, TimetableDay, TimetableCell, TimetableBounds, TimetableDiagnostic, InvalidItemReason, TimetableView, } from './timetable';
 export { buildTimetableModel } from './timetable';
 export type { GroupItemsByDateAccessors } from './group';

package/dist/_dts/calendar/src/timetable.d.ts

@@ -9,7 +9,7 @@
  * the same output. The model has no opinion on what an item is — pass
  * accessors.
  */
-import { type WeekStart } from './grid';
+import { type CalendarDate, type WeekStart } from './grid';
 export type TimetableBounds = Readonly<{
     /** Hour ticks below this are clipped. Default 5. */
     minStartHour?: number;
@@ -24,7 +24,7 @@ export type TimetableBounds = Readonly<{
 }>;
 export type TimetableInput<T> = Readonly<{
     items: readonly T[];
-    viewDate: Date;
+    viewDate: CalendarDate;
     view?: TimetableView;
     startOfWeek: WeekStart;
     getId: (item: T) => string;
@@ -35,12 +35,8 @@ export type TimetableInput<T> = Readonly<{
     /** Sort tiebreak when two items have identical start+end. Defaults to getId. */
     getOrderKey?: (item: T) => string;
     bounds?: TimetableBounds;
-    /**
-     * "Now" reference for the `isToday` flag on each day. Defaults to
-     * `new Date()`; pass an explicit value to keep the model fully deterministic
-     * for snapshot tests.
-     */
-    now?: Date;
+    /** The calendar's explicit site-local current date. */
+    today: CalendarDate;
 }>;
 export type InvalidItemReason = 'invalid-start' | 'invalid-end' | 'invalid-timezone' | 'non-positive-duration' | 'out-of-visible-hours';
 export type TimetableDiagnostic<T> = Readonly<{
@@ -68,7 +64,7 @@ export type TimetableCell<T> = Readonly<{
     color: string | null;
 }>;
 export type TimetableDay<T> = Readonly<{
-    date: Date;
+    date: CalendarDate;
     dateKey: string;
     isToday: boolean;
     cells: readonly TimetableCell<T>[];

package/dist/_dts/commerce/src/purchase/allocation.d.ts

@@ -0,0 +1,11 @@
+import { type NonNegativeCents } from '../../../core/src/index';
+/**
+ * Allocate an integer total proportionally using largest remainders.
+ *
+ * Negative weights are treated as zero. When every weight is zero, the total
+ * is spread evenly instead, with residual units assigned in input order.
+ */
+export declare function allocateTotalByWeight<TLineId extends string>(total: number, lines: readonly Readonly<{
+    id: TLineId;
+    weight: number;
+}>[]): ReadonlyMap<TLineId, NonNegativeCents>;

package/dist/_dts/commerce/src/purchase/event-registration-errors.d.ts

@@ -0,0 +1,57 @@
+export type EventRegistrationErrorAction = 'none' | 'retry' | 'places' | 'start' | 'details' | 'payment-options' | 'payment-status' | 'portal' | 'event';
+export declare const eventRegistrationErrors: {
+    readonly registrationClosed: {
+        readonly message: "Booking is currently closed for this event. Please contact the organiser if you’d like to find out more.";
+        readonly action: "none";
+    };
+    readonly paymentUncertain: {
+        readonly message: "We’re checking your booking and payment. Please don’t try to book again yet. If you’ve already paid, you don’t need to pay again.";
+        readonly action: "payment-status";
+    };
+    readonly paymentPageUnavailable: {
+        readonly message: "We couldn’t open the payment page. Please refresh this page and try again. If this keeps happening, contact the organiser for help.";
+        readonly action: "retry";
+    };
+    readonly paymentUnavailable: {
+        readonly message: "Online payment is not available for this event right now. Please contact the organiser for help with booking.";
+        readonly action: "none";
+    };
+    readonly capacityChanged: {
+        readonly message: "Sorry, there aren’t enough places left for your selection. Please check the available places and choose again.";
+        readonly action: "places";
+    };
+    readonly selectionChanged: {
+        readonly message: "The booking options for this event have changed. Please check the latest options and choose your places again.";
+        readonly action: "places";
+    };
+    readonly registrationPreparationChanged: {
+        readonly message: "The booking options for this event have changed. Please check the latest options and choose your places again.";
+        readonly action: "places";
+    };
+    readonly registrationAlreadyExists: {
+        readonly message: "You already have a booking for this event. Please check your bookings to see its status. If you need help, contact the organiser.";
+        readonly action: "portal";
+    };
+    readonly holdExpired: {
+        readonly message: "Your reservation has timed out. Please check availability and choose your places again.";
+        readonly action: "start";
+    };
+    readonly waitlistUnavailable: {
+        readonly message: "Sorry, the waiting list place offered in this invitation is no longer available. Please check the event for available places or contact the organiser for help.";
+        readonly action: "event";
+    };
+    readonly paymentContextMismatch: {
+        readonly message: "The payment options for this event have changed. Please check the latest options before continuing.";
+        readonly action: "payment-options";
+    };
+    readonly idempotencyConflict: {
+        readonly message: "You’ve already started booking this event. Please finish in the other tab if it’s still open, or check your booking status before starting again.";
+        readonly action: "portal";
+    };
+    readonly invalidCommitInput: {
+        readonly message: "We couldn’t accept your booking details. Please check the information you entered and try again. If this keeps happening, contact the organiser for help.";
+        readonly action: "details";
+    };
+};
+export type EventRegistrationErrorReason = keyof typeof eventRegistrationErrors;
+export declare function parseEventRegistrationErrorReason(value: unknown): EventRegistrationErrorReason | null;

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

@@ -1,4 +1,5 @@
 export * from './types';
+export * from './allocation';
 export * from './orderTypes';
 export * from './orderPlanningTypes';
 export * from './bookingInstalmentSchedule';
@@ -52,4 +53,6 @@ export * from './refundPolicy';
 export * from './settlement';
 export * from './shopRefundPlanning';
 export * from './stripeMinimumCharge';
+export * from './stripeCheckoutReturnUrl';
 export * from './stateTransitions';
+export * from './event-registration-errors';

package/dist/_dts/commerce/src/purchase/settlement.d.ts

@@ -89,6 +89,39 @@ export declare function buildRefundableLineSettlement<TLineId extends string>(op
     stripeChargeCents: number;
     alreadyRefundedCents: number;
 }>): Result<RefundableLineSettlement, RefundableLineSettlementError<TLineId>>;
+export type OrderItemCashAllocation = Readonly<{
+    orderItemId: string;
+    amountCents: number;
+}>;
+/**
+ * Cash actually collected against one order line, summed from its payment
+ * receipt allocations. Shared so every refundable-remainder caller measures
+ * funding the same way.
+ */
+export declare function orderItemCashFundedCents(allocations: ReadonlyArray<OrderItemCashAllocation>, orderItemId: string): number;
+/**
+ * Funding facts for a single order line, expressed the way the refund runtime
+ * sees them: cash actually collected against the line (payment receipt
+ * allocations), plus any store credit applied to it, minus what has already
+ * been refunded.
+ */
+export type OrderItemRefundFunding = Readonly<{
+    /** Cash collected for this line so far (receipt allocation totals). */
+    cashFundedCents: number;
+    /** Store credit applied to this line. */
+    creditAppliedCents: number;
+    /** Refunds already applied to this line. */
+    refundedCents: number;
+}>;
+/**
+ * The single authority on how much of an order line is still refundable.
+ *
+ * Every surface that shows or enforces a refundable remainder MUST go through
+ * this function. Computing it from the line's net total instead of its actual
+ * funding overstates the remainder on partially collected orders, which used to
+ * let the dashboard offer a refund the runtime then refused.
+ */
+export declare function orderItemRefundableRemainingCents(funding: OrderItemRefundFunding): NonNegativeCents;
 export declare function refundableRemainingCents(settlement: RefundableLineSettlement): NonNegativeCents;
 export declare function ensureSingleCurrency(lines: ReadonlyArray<{
     currency: string;

package/dist/_dts/commerce/src/purchase/stripeCheckoutReturnUrl.d.ts

@@ -0,0 +1,8 @@
+export declare const STRIPE_CHECKOUT_SESSION_ID_PLACEHOLDER = "{CHECKOUT_SESSION_ID}";
+/**
+ * Completes a Stripe success URL with the session correlation parameter.
+ *
+ * URL owns the query/fragment boundary so the parameter can never be appended
+ * inside a hash fragment. Stripe requires its placeholder to remain literal.
+ */
+export declare function ensureStripeCheckoutSessionIdInSuccessUrl(successUrl: string): string;

package/dist/_dts/content-model/src/templates/defaults.d.ts

@@ -124,6 +124,9 @@ export declare const DEFAULT_TEMPLATE_DEFINITIONS: {
         }, {
             readonly blockKind: "block.body-text";
             readonly scope: "entry";
+            readonly content: {
+                readonly body: import("../../../core/src/index").RichTextDoc;
+            };
             readonly bindings: import("./types").TemplateBindingRecord;
         }, {
             readonly blockKind: "system.entry-slot";
@@ -189,6 +192,9 @@ export declare const DEFAULT_TEMPLATE_DEFINITIONS: {
         }, {
             readonly blockKind: "block.body-text";
             readonly scope: "entry";
+            readonly content: {
+                readonly body: import("../../../core/src/index").RichTextDoc;
+            };
             readonly bindings: import("./types").TemplateBindingRecord;
         }];
     };