@riverbankcms/sdk 0.151.0 → 0.152.0

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

@@ -1,17 +1,34 @@
 import { type ResolvedBookingCollectionOption } from '../../../../../commerce/src/purchase/index';
-import { type BookingPaymentCollectionOptionKind } from '../../../../../core/src/index';
+import { type BookingPaymentCollectionOptionKind, type AppointmentBookingTerms } from '../../../../../core/src/index';
 export type BookingPaymentSelectionKind = BookingPaymentCollectionOptionKind;
 export type BookingPaymentOptionSummaryRow = Readonly<{
     label: string;
     value: string;
 }>;
+/** The two figures a payment choice leads with, as numbers and as written. */
+export type BookingPaymentOptionAmounts = Readonly<{
+    totalCents: number;
+    dueTodayCents: number;
+    formattedTotal: string;
+    formattedDueToday: string;
+}>;
 export type BookingPaymentOptionViewModel = Readonly<{
     kind: BookingPaymentSelectionKind;
     /** Copy can describe full payment without changing the admitted collection kind. */
     presentationKind: BookingPaymentSelectionKind;
     title: string;
     description: string;
+    /** Total and Due today, then `termRows`: the full summary as written. */
     summaryRows: readonly BookingPaymentOptionSummaryRow[];
+    amounts: BookingPaymentOptionAmounts;
+    /** Structured balance facts; presentation labels never identify money. */
+    flexibleBalance: Readonly<{
+        remainingBalance: string;
+        balanceDueBy: string;
+        depositPolicy: string;
+    }> | null;
+    /** The terms beyond the two amounts (balance, deposit policy, schedule). */
+    termRows: readonly BookingPaymentOptionSummaryRow[];
     helperText?: string;
     ctaLabel: string;
     dueNowCents: number;
@@ -28,3 +45,22 @@ export declare function buildBookingPaymentSelectionViewModel(input: Readonly<{
     priceCurrency?: string | null;
     locale?: string;
 }>): BookingPaymentSelectionViewModel;
+/**
+ * A payment choice's price for its row (issue 1581): the total when it's all
+ * paid now, "£18.00 due" when nothing is paid now, otherwise what's paid today.
+ */
+export declare function paymentChoicePrice(amounts: BookingPaymentOptionAmounts): string;
+/** The row's supporting lines: its description, the total when the price is today's part, then its terms. */
+export declare function paymentChoiceDetails(input: Readonly<{
+    description: string;
+    amounts: BookingPaymentOptionAmounts;
+    termRows: readonly BookingPaymentOptionSummaryRow[];
+    helperText?: string;
+}>): readonly string[];
+/** Reviewed net amounts use the same payment facts and copy as the payment step. */
+export declare function buildReviewedBookingPaymentViewModel(input: Readonly<{
+    terms: AppointmentBookingTerms;
+    bookingStartAt: string | null;
+    anchorAt: string;
+    locale?: string;
+}>): BookingPaymentOptionViewModel | null;

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

@@ -22,13 +22,20 @@ export type ModalShellProps = Readonly<{
     titleClassName?: string;
     closeButtonClassName?: string;
     closeIcon?: React.ReactNode;
+    /**
+     * Where focus goes when the shell closes, given the element that opened it.
+     * By default the opener itself; a caller whose opener may not be focusable
+     * yet when the shell closes (an inert bar) decides its own destination.
+     */
+    returnFocus?: (opener: HTMLElement | null) => void;
 }>;
 /**
  * Shared, unopinionated modal shell for interactive runtime flows.
  *
  * Styling is supplied by the caller via class names, while the shell owns
- * focus, escape handling, body-scroll locking, overlay clicks, and optional
+ * focus (trapped inside, returned on close), escape handling for the
+ * innermost open shell, body-scroll locking, overlay clicks, and optional
  * portaling into a themed root.
  */
-export declare function ModalShell({ title, titleId, onClose, children, portalRoot, portal, portalWrapperClassName, portalWrapperProps, overlayClassName, modalClassName, renderSrOnlyTitle, renderHeader, headerClassName, titleClassName, closeButtonClassName, closeIcon, }: ModalShellProps): React.ReactNode;
+export declare function ModalShell({ title, titleId, onClose, children, portalRoot, portal, portalWrapperClassName, portalWrapperProps, overlayClassName, modalClassName, renderSrOnlyTitle, renderHeader, headerClassName, titleClassName, closeButtonClassName, closeIcon, returnFocus, }: ModalShellProps): React.ReactNode;
 export {};

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

@@ -0,0 +1,28 @@
+import React from 'react';
+/**
+ * One way to pay, as a full-width row (issue 1581): the label and detail on
+ * the left, the price on the right. Event and appointment booking both
+ * render their payment choices through this.
+ */
+export type PaymentChoiceRow = Readonly<{
+    id: string;
+    label: string;
+    /** Supporting lines under the label. */
+    details?: readonly string[];
+    /** What this choice costs, e.g. "£18.00" or "£18.00 due". */
+    price?: string | null;
+    selected: boolean;
+    disabled?: boolean;
+    /** Why a disabled row can't be chosen; shown in the row, not a tooltip. */
+    disabledReason?: string;
+    onSelect: () => void;
+}>;
+/**
+ * Payment choices as a radio group. Native radios give the whole row as the
+ * hit area and arrow-key movement between choices; the selected row takes the
+ * primary accent and disabled rows stay readable with their reason.
+ */
+export declare function PaymentChoiceRows(props: Readonly<{
+    label: string;
+    rows: readonly PaymentChoiceRow[];
+}>): React.ReactElement;

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

@@ -1,16 +1,14 @@
 /**
- * Shared step indicator component for registration wizards.
- * Shows numbered steps with current progress and completion state.
+ * Shared progress indicator for registration wizards (event and appointment
+ * booking): the current step's label, "Step N of M", and a thin bar.
  *
  * Two class channels can be emitted (independently or together):
  * - `emitSharedClasses` adds the shared registration-surface classes
- *   (`rb-steps-nav`, `rb-step-circle`, ...) styled by
- *   theme-core `blocks-static/registration-surface.css`.
- * - `classPrefix` adds block-prefixed classes (e.g. `er-step-circle`) — the
- *   legacy styling channel and the stable hook surface for per-site theme CSS.
+ *   (`rb-progress`, `rb-progress__fill`, ...) styled by theme-core
+ *   `blocks-static/registration-surface.css`.
+ * - `classPrefix` adds block-prefixed classes (e.g. `er-progress`), kept as a
+ *   stable hook surface for per-site theme CSS.
  *
- * Blocks opt in to the shared channel as part of their registration-surface
- * migration (issue 1174); until then a prefix-only render is unchanged output.
  * At least one channel must be enabled or the indicator renders unstyled.
  */
 /**

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

@@ -19,13 +19,13 @@ export { StateIcon } from './StateIcon';
 export type { LoggedInAsUserProps } from './LoggedInAsUser';
 export { MembershipHero } from './MembershipHero';
 export { ModalShell } from './ModalShell';
+export { PaymentChoiceRows } from './PaymentChoiceRows';
+export type { PaymentChoiceRow } from './PaymentChoiceRows';
 export type { ModalShellProps } from './ModalShell';
 export { TabBarFragment } from './TabBarFragment';
 export { TerminalPanel } from './TerminalPanel';
 export type { TerminalPanelProps, TerminalPanelTitleElement, } from './TerminalPanel';
 export { StepIndicator } from './StepIndicator';
 export type { StepIndicatorBaseProps, StepIndicatorProps, } from './StepIndicator';
-export { RB_OPTION_CARD_CLASSES, SelectableOptionCard, } from './SelectableOptionCard';
-export type { SelectableOptionCardProps } from './SelectableOptionCard';
 export { ThemedActionsButton, ThemedAuthoredButton, ThemedButton, ThemedButtonLink, ThemedButtonSpecimen, ThemedDownloadLink } from './ThemedButton';
 export type { ThemedActionsButtonProps, ThemedAuthoredButtonProps, ThemedButtonProps, ThemedButtonLinkProps, ThemedButtonSpecimenProps, ThemedDownloadLinkProps } from './ThemedButton';

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

@@ -8,5 +8,5 @@ export { DEFAULT_CURRENCY } from './types';
 export { BOOK_TARGET_PARAMS, buildCheckoutReturnUrls, resolveDedicatedBookingHref, resolveDedicatedBookingPath, resolveDedicatedBookingTarget, formatPrice, scrollToBlock, consumeSearchParam, consumeSearchParams, validateFormData, getStepNumber, } from './utils';
 export type { DedicatedBookingTarget, UniversalBookingRouteTarget, } from './utils';
 export { createBodyThemePortalRoot } from './utils';
-export { ActionRow, CheckIcon, ClockIcon, CrossIcon, BLOCK_DISCOUNT_CODE_DISCLOSURE_CLASSES, DiscountCodeDisclosure, FieldValidationMessage, FeedbackMessage, getFieldValidationControlProps, MembershipHero, ModalShell, RB_OPTION_CARD_CLASSES, SelectableOptionCard, StateIcon, StepIndicator, TerminalPanel, } from './components';
-export type { ActionRowProps, SelectableOptionCardProps, DiscountCodeDisclosureProps, DiscountCodeDisclosureSurface, FieldValidationControlInput, FieldValidationControlProps, FieldValidationMessageProps, FeedbackLiveMode, FeedbackMessageProps, FeedbackTone, ModalShellProps, StepIndicatorBaseProps, StepIndicatorProps, TerminalPanelProps, TerminalPanelTitleElement, } from './components';
+export { ActionRow, CheckIcon, ClockIcon, CrossIcon, BLOCK_DISCOUNT_CODE_DISCLOSURE_CLASSES, DiscountCodeDisclosure, FieldValidationMessage, FeedbackMessage, getFieldValidationControlProps, MembershipHero, ModalShell, StateIcon, StepIndicator, TerminalPanel, } from './components';
+export type { ActionRowProps, DiscountCodeDisclosureProps, DiscountCodeDisclosureSurface, FieldValidationControlInput, FieldValidationControlProps, FieldValidationMessageProps, FeedbackLiveMode, FeedbackMessageProps, FeedbackTone, ModalShellProps, StepIndicatorBaseProps, StepIndicatorProps, TerminalPanelProps, TerminalPanelTitleElement, } from './components';

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

@@ -1,19 +1,16 @@
-import { useBlockApi } from "../api";
-import type { ResolveWaitlistClaimResponse } from "../api/types";
+import { useBlockApi } from '../api';
+import { type WaitlistClaimCredential, type WaitlistClaimRequest, type WaitlistClaimLookup } from './useWaitlistClaim.state';
 export declare function getWaitlistClaimTokenFromUrl(): string | null;
 export declare function getWaitlistClaimEntryIdFromUrl(): string | null;
-export type UseWaitlistClaimResult = {
-    token: string | null;
-    entryId: string | null;
-    claim: ResolveWaitlistClaimResponse | null;
-    error: string | null;
-    loginMessage: string | null;
-    requiresPortalLogin: boolean;
-    isLoading: boolean;
-};
+export type UseWaitlistClaimResult = WaitlistClaimLookup | null;
 export type UseWaitlistClaimDeps = Readonly<{
     useBlockApi: typeof useBlockApi;
 }>;
+/** Memoize only claim parameters; payment URL cleanup is not a new invitation. */
+export declare function useWaitlistClaimCredential(): WaitlistClaimCredential | null;
+/** Remove both alternatives, retaining all unrelated URL and history state. */
+export declare function clearWaitlistClaimLocation(): void;
 export declare function useWaitlistClaim(): UseWaitlistClaimResult;
-export declare function useWaitlistClaimForToken(token: string | null): UseWaitlistClaimResult;
 export declare function useWaitlistClaimWithDeps(deps: UseWaitlistClaimDeps): UseWaitlistClaimResult;
+export declare function useWaitlistClaimForRequest(request: WaitlistClaimRequest | null): UseWaitlistClaimResult;
+export declare function useWaitlistClaimForRequestWithDeps(request: WaitlistClaimRequest | null, deps: UseWaitlistClaimDeps): UseWaitlistClaimResult;

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

@@ -1,4 +1,19 @@
 import type { ResolveWaitlistClaimResponse } from "../api/types";
+export type WaitlistClaimCredential = Readonly<{
+    kind: 'emailedToken';
+    token: string;
+}> | Readonly<{
+    kind: 'portalOwnedEntry';
+    entryId: string;
+}>;
+/** Object identity binds one asynchronous lookup to the draft that requested it. */
+export type WaitlistClaimRequest = Readonly<{
+    credential: WaitlistClaimCredential;
+}>;
+export type WaitlistClaimLookup = Readonly<{
+    request: WaitlistClaimRequest;
+    state: WaitlistClaimState;
+}>;
 export type WaitlistClaimResolveFailure = Readonly<{
     kind: "portal-login-required";
     message: string;

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

@@ -1,18 +1,13 @@
-/**
- * Create a portal root that preserves theme scope styling while escaping
- * local stacking contexts.
- *
- * Why this exists:
- * - Theme variables are applied via inline styles on the nearest `.theme-scope`.
- * - Some pages create stacking contexts (e.g. transformed hero decorations) that
- *   can sit above fixed-position overlays rendered inside the normal tree.
- * - Portaling to `document.body` escapes stacking contexts, but loses theme scope.
- *
- * This helper creates a new `.theme-scope` element attached to `document.body`,
- * copying inline CSS vars + relevant data attrs from the current theme scope.
- */
-export type ThemePortalRoot = {
+/** Mirror a theme scope on body-level portals, including live preview edits. */
+export type ThemePortalRoot = Readonly<{
     root: HTMLElement;
     cleanup: () => void;
-};
+}>;
+type AttributeSnapshot = ReadonlyMap<string, string>;
+type AttributeChanges = Readonly<{
+    set: AttributeSnapshot;
+    remove: readonly string[];
+}>;
+export declare function attributeChanges(prev: AttributeSnapshot, next: AttributeSnapshot): AttributeChanges;
 export declare function createBodyThemePortalRoot(sourceEl: Element): ThemePortalRoot | null;
+export {};

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

@@ -12,3 +12,4 @@ export declare const builtinTransformDefinitions: import("./core").TransformDefi
 export declare const defaultTransforms: import("./core").TransformRegistry;
 export { boxStyleClassNames } from "./_utils/boxStyleClassNames";
 export { formattingTransforms, layoutTransforms, chromeLogoTransforms, uiTransforms, mediaTransforms, backgroundTransforms, linksTransforms, boxStylesTransforms, contentTransforms, headerRuntimeTransforms, };
+export { resolveAuthoredLinkHref } from './links';

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

@@ -1,4 +1,6 @@
-import type { TransformDefinition } from "./core";
+import type { TransformContext, TransformDefinition } from "./core";
+export type LinkResolutionContext = Pick<TransformContext, 'routes' | 'pagesByIdentifier' | 'entriesByIdentifier' | 'stage'>;
 export declare const resolveLinkTransform: TransformDefinition;
 export declare const linkLabelTransform: TransformDefinition;
 export declare const linksTransforms: TransformDefinition[];
+export declare function resolveAuthoredLinkHref(value: unknown, context?: LinkResolutionContext): string | null;

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

@@ -21,3 +21,5 @@ export declare function canInstalmentPlanCompleteBefore(input: Readonly<{
     deadline: string;
     schedule: readonly BookingInstalmentScheduleRow[];
 }>): boolean;
+/** Later obligations are identified by their state, never their position. */
+export declare function getBookingLaterInstalments(schedule: readonly BookingInstalmentScheduleRow[]): readonly BookingInstalmentScheduleRow[];

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

@@ -84,6 +84,12 @@ export declare function resolveAvailableBookingCollectionOptions(input: Readonly
     totalCents: number;
 }>): readonly ResolvedBookingCollectionOption[];
 export declare function isBookingCollectionEquivalentToUpfront(option: ResolvedBookingCollectionOption): boolean;
+export declare function resolveBookingCollectionOptionFacts(input: Readonly<{
+    option: BookingPaymentCollectionOption;
+    totalCents: number;
+    anchorAt: string;
+    bookingStartAt: string | null;
+}>): ResolvedBookingCollectionOption;
 /** Discounts change preview money, never an already admitted collection identity. */
 export declare function repriceBookingCollectionOptions(input: Readonly<{
     options: readonly ResolvedBookingCollectionOption[];

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

@@ -1,3 +1,5 @@
+import { type ConfirmationPayment, type ConfirmationOrderItem } from './confirmationPayment';
+export { settledOrderItemTotalCents } from './confirmationPayment';
 import type { OrderPaymentMethod } from './orderTypes';
 export type ConfirmationEmailPaymentSummary = Readonly<{
     kind: 'free';
@@ -21,7 +23,7 @@ export type ConfirmationEmailPaymentSummary = Readonly<{
     amountOutstandingCents?: number;
     dueAt?: string | null;
     currency: string;
-    paymentMethod: Extract<OrderPaymentMethod, 'stripe' | 'store_credit' | 'mixed'>;
+    paymentMethod: Extract<OrderPaymentMethod, 'stripe' | 'store_credit' | 'mixed' | 'manual'>;
 }>;
 export type ConfirmationEmailTemplatePaymentFields = Readonly<{
     paymentMethod?: 'free' | 'pass' | 'membership' | 'stripe' | 'manual' | 'waived';
@@ -34,18 +36,10 @@ export type ConfirmationEmailTemplatePaymentFields = Readonly<{
     managedBalanceDueAt?: string | null;
 }>;
 type NonMonetaryConfirmationPaymentMethod = 'free' | 'pass' | 'membership';
-export declare function settledOrderItemTotalCents(item: Readonly<{
-    netTotalCents: number | null;
-    totalCents: number | null;
-    creditCents: number | null;
-}>): number;
-export declare function buildOrderItemConfirmationEmailPaymentSummary(options: {
+/** Email copy projection; this function never decides settlement. */
+export declare function toConfirmationEmailPaymentSummary(payment: ConfirmationPayment): ConfirmationEmailPaymentSummary;
+type EmailOrderPaymentInput = Readonly<{
     orderPaymentMethod: OrderPaymentMethod;
-    item: Readonly<{
-        netTotalCents: number | null;
-        totalCents: number | null;
-        creditCents: number | null;
-    }>;
     currency: string;
     flexibleBalanceDueAt?: string | null;
     settlement: Readonly<{
@@ -54,7 +48,14 @@ export declare function buildOrderItemConfirmationEmailPaymentSummary(options: {
         kind: 'collected';
         collectedCents: number;
     }>;
-}): ConfirmationEmailPaymentSummary;
+}>;
+/** Legacy notification adapter, retained unchanged in meaning until #1587. */
+export declare function buildOrderItemsConfirmationEmailPaymentSummary(options: EmailOrderPaymentInput & Readonly<{
+    items: readonly ConfirmationOrderItem[];
+}>): ConfirmationEmailPaymentSummary;
+export declare function buildOrderItemConfirmationEmailPaymentSummary(options: EmailOrderPaymentInput & Readonly<{
+    item: ConfirmationOrderItem;
+}>): ConfirmationEmailPaymentSummary;
 export declare function buildEventRegistrationConfirmationEmailPaymentSummary(options: Readonly<{
     paymentMethod: NonMonetaryConfirmationPaymentMethod;
     passCreditsUsed?: number;
@@ -88,4 +89,3 @@ export declare function buildBypassedCheckoutConfirmationEmailPaymentSummary(opt
     currency: string;
 }>): ConfirmationEmailPaymentSummary;
 export declare function toConfirmationEmailTemplatePaymentFields(summary: ConfirmationEmailPaymentSummary | undefined): ConfirmationEmailTemplatePaymentFields;
-export {};

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

@@ -0,0 +1,65 @@
+import { type NonNegativeCents, type Result } from '../../../core/src/index';
+import type { z } from 'zod';
+import { confirmationPaymentSchema, type paymentBalanceSchema } from './confirmationPaymentSchema';
+import { type OrderPaymentPositionInconsistency, type PaymentTerms } from './orderPaymentState';
+import type { OrderPaymentMethod } from './orderTypes';
+import type { CurrencyCode } from './settlement';
+export type PaymentBalance = z.infer<typeof paymentBalanceSchema>;
+export type ConfirmationPayment = z.infer<typeof confirmationPaymentSchema>;
+type MonetaryMethod = Extract<OrderPaymentMethod, 'stripe' | 'store_credit' | 'mixed' | 'manual'>;
+export type ConfirmationPaymentIssue = OrderPaymentPositionInconsistency | Readonly<{
+    kind: 'missing_settlement_evidence';
+}> | Readonly<{
+    kind: 'ambiguous_booking_allocation';
+}> | Readonly<{
+    kind: 'invalid_pass_credits';
+}>;
+export type ConfirmationPaymentInput = Readonly<{
+    kind: 'free' | 'waived';
+}> | Readonly<{
+    kind: 'pass';
+    passName?: string | null;
+    passCreditsUsed?: number | null;
+}> | Readonly<{
+    kind: 'membership';
+    membershipName?: string | null;
+}> | Readonly<{
+    kind: 'monetary';
+    paymentMethod: MonetaryMethod;
+    currency: CurrencyCode;
+    cashDueCents: NonNegativeCents;
+    cashPaidCents: NonNegativeCents;
+    creditPaidCents: NonNegativeCents;
+    waivedCents: NonNegativeCents;
+    terms: PaymentTerms;
+}>;
+/** Public payment evidence returns only schema-valid decisions. Legacy email
+ * snapshots deliberately use the amount calculation below instead of this boundary.
+ */
+export declare function buildConfirmationPayment(input: ConfirmationPaymentInput): Result<ConfirmationPayment, ConfirmationPaymentIssue>;
+export type ConfirmationOrderItem = Readonly<{
+    netTotalCents: number | null;
+    totalCents: number | null;
+    creditCents: number | null;
+}>;
+export declare function settledOrderItemTotalCents(item: ConfirmationOrderItem): number;
+/** Historical notification amounts, not a validated public payment decision.
+ * Preserve HEAD's raw snapshot numbers; strict evidence validation belongs to
+ * the public read boundary, not notification-plan construction (#1587).
+ */
+export declare function calculateOrderItemsConfirmationPaymentAmounts(input: Readonly<{
+    items: readonly ConfirmationOrderItem[];
+    settlement: Readonly<{
+        kind: 'settled_in_full';
+    }> | Readonly<{
+        kind: 'collected';
+        collectedCents: number;
+    }>;
+}>): Readonly<{
+    amountPaidCents: number;
+    amountOutstandingCents: number;
+}>;
+export declare function collectedOrderItemsConfirmationCents<TItem extends Readonly<{
+    id: string;
+}>>(items: readonly TItem[], collectedCentsByOrderItemId: Readonly<Record<string, number>>): number;
+export {};

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

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+export declare const paymentBalanceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"settled">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"due">;
+    amountCents: z.ZodPipe<z.ZodNumber, z.ZodTransform<import("../../../core/src/index").PositiveCents, number>>;
+    dueAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>], "kind">;
+export declare const confirmationPaymentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"free">;
+    balance: z.ZodObject<{
+        kind: z.ZodLiteral<"settled">;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"waived">;
+    balance: z.ZodObject<{
+        kind: z.ZodLiteral<"settled">;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"pass">;
+    passName: z.ZodNullable<z.ZodString>;
+    passCreditsUsed: z.ZodNullable<z.ZodNumber>;
+    balance: z.ZodObject<{
+        kind: z.ZodLiteral<"settled">;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"membership">;
+    membershipName: z.ZodNullable<z.ZodString>;
+    balance: z.ZodObject<{
+        kind: z.ZodLiteral<"settled">;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"manual_due">;
+    currency: z.ZodPipe<z.ZodString, z.ZodTransform<import("./settlement").CurrencyCode, string>>;
+    balance: z.ZodObject<{
+        kind: z.ZodLiteral<"due">;
+        amountCents: z.ZodPipe<z.ZodNumber, z.ZodTransform<import("../../../core/src/index").PositiveCents, number>>;
+        dueAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    balance: z.ZodObject<{
+        kind: z.ZodLiteral<"due">;
+        amountCents: z.ZodPipe<z.ZodNumber, z.ZodTransform<import("../../../core/src/index").PositiveCents, number>>;
+        dueAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    amountPaidCents: z.ZodPipe<z.ZodNumber, z.ZodTransform<import("../../../core/src/index").NonNegativeCents, number>>;
+    currency: z.ZodPipe<z.ZodString, z.ZodTransform<import("./settlement").CurrencyCode, string>>;
+    kind: z.ZodLiteral<"managed_balance_due">;
+}, z.core.$strict>, z.ZodObject<{
+    paymentMethod: z.ZodEnum<{
+        mixed: "mixed";
+        manual: "manual";
+        stripe: "stripe";
+        store_credit: "store_credit";
+    }>;
+    balance: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"settled">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"due">;
+        amountCents: z.ZodPipe<z.ZodNumber, z.ZodTransform<import("../../../core/src/index").PositiveCents, number>>;
+        dueAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>], "kind">;
+    amountPaidCents: z.ZodPipe<z.ZodNumber, z.ZodTransform<import("../../../core/src/index").NonNegativeCents, number>>;
+    currency: z.ZodPipe<z.ZodString, z.ZodTransform<import("./settlement").CurrencyCode, string>>;
+    kind: z.ZodLiteral<"monetary">;
+}, z.core.$strict>], "kind">;

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

@@ -20,6 +20,8 @@ export * from './checkoutStripeSessionPlanning';
 export * from './checkoutSessionMetadata';
 export * from './canonicalRefundPlanner';
 export * from './confirmationEmailPayment';
+export * from './confirmationPayment';
+export * from './confirmationPaymentSchema';
 export * from './discountApplication';
 export * from './oneTimeCheckoutPlanning';
 export * from './order-number';

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

@@ -111,6 +111,14 @@ export type OrderPaymentPositionInput = Readonly<{
     }> | null;
     hasCollectionFailure?: boolean;
 }>;
+/** Amount arithmetic shared by strict payment evidence and tolerant email snapshots.
+ * Snapshots historically clamp overcollection to zero; the strict decision below
+ * checks collectability before using the same calculation.
+ */
+export declare function calculateOutstandingOrderAmountCents(input: Readonly<{
+    totalCents: number;
+    settledCents: number;
+}>): number;
 export declare function calculateOrderBalanceDueCents(input: Readonly<{
     grandTotalCents: NonNegativeCents;
     paidCents: NonNegativeCents;

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

@@ -150,11 +150,11 @@ export declare const DEFAULT_TEMPLATE_DEFINITIONS: {
             readonly blockKind: "block.event-registration";
             readonly scope: "entry";
             readonly content: {
-                readonly heading: "Register for this event";
+                readonly heading: "";
                 readonly maxTickets: "5";
                 readonly showVenue: true;
                 readonly showCapacity: true;
-                readonly buttonText: "Complete Registration";
+                readonly buttonText: "Book your place";
                 readonly buttonVariant: "primary";
             };
             readonly bindings: {

package/dist/_dts/core/src/appointment-booking-terms.d.ts

@@ -0,0 +1,20 @@
+import type { BookingPaymentCollectionOption } from './booking-payment-options';
+/** Customer disclosure only: amounts are acceptance ceilings, never settlement inputs. */
+export type AppointmentBookingTerms = Readonly<{
+    currency: string;
+    totalCents: number;
+    dueNowCents: number;
+    laterPaymentAmountsCents: readonly number[];
+    paymentOption: BookingPaymentCollectionOption | Readonly<{
+        kind: 'not_required';
+    }>;
+    promisedDiscountId?: string | null;
+}>;
+export type AppointmentBookingReviewReason = 'amount_increased' | 'payment_terms_changed' | 'discount_unavailable';
+export type AppointmentBookingReview = Readonly<{
+    terms: AppointmentBookingTerms;
+    subtotalCents: number;
+    discountCents: number;
+    creditCents: number;
+    reason: AppointmentBookingReviewReason;
+}>;

package/dist/_dts/core/src/booking-payment-schemas.d.ts

@@ -519,4 +519,74 @@ export declare const bookingPaymentOptionsChoiceSchema: z.ZodDiscriminatedUnion<
         }, z.core.$strip>], "kind">>;
     }, z.core.$strip>;
 }, z.core.$strict>], "source">;
+/** Strict evidence shape; accepts configured rules but no materialised schedule metadata. */
+export declare const appointmentBookingTermsSchema: z.ZodObject<{
+    currency: z.ZodString;
+    totalCents: z.ZodNumber;
+    dueNowCents: z.ZodNumber;
+    laterPaymentAmountsCents: z.ZodArray<z.ZodNumber>;
+    paymentOption: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"upfront">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"deferred_manual">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"instalment_plan">;
+        plan: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"deposit_plus_one_remainder">;
+            depositAmountCents: z.ZodNumber;
+            depositRefundability: z.ZodEnum<{
+                refundable: "refundable";
+                non_refundable: "non_refundable";
+            }>;
+            remainderDueCount: z.ZodNumber;
+            intervalUnit: z.ZodEnum<{
+                day: "day";
+                week: "week";
+                month: "month";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"deposit_plus_scheduled_instalments">;
+            depositAmountCents: z.ZodNumber;
+            depositRefundability: z.ZodEnum<{
+                refundable: "refundable";
+                non_refundable: "non_refundable";
+            }>;
+            instalmentCount: z.ZodNumber;
+            intervalCount: z.ZodNumber;
+            intervalUnit: z.ZodEnum<{
+                day: "day";
+                week: "week";
+                month: "month";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"equal_scheduled_instalments">;
+            instalmentCount: z.ZodNumber;
+            intervalCount: z.ZodNumber;
+            intervalUnit: z.ZodEnum<{
+                day: "day";
+                week: "week";
+                month: "month";
+            }>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"flexible_balance">;
+        config: z.ZodObject<{
+            upfrontAmountCents: z.ZodNumber;
+            dueDateRule: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"relative_to_start_date">;
+                daysBeforeStart: z.ZodNumber;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"fixed_calendar_date">;
+                dueAt: z.ZodString;
+            }, z.core.$strict>], "kind">;
+            depositRefundability: z.ZodEnum<{
+                refundable: "refundable";
+                non_refundable: "non_refundable";
+            }>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">, z.ZodObject<{
+        kind: z.ZodLiteral<"not_required">;
+    }, z.core.$strict>]>;
+    promisedDiscountId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
 export {};

package/dist/_dts/core/src/branded.d.ts

@@ -139,7 +139,6 @@ export type DemoLifecycleAuditEventId = Brand<string, 'DemoLifecycleAuditEventId
 export type DemoRuntimeId = Brand<string, 'DemoRuntimeId'>;
 export type DemoCapability = Brand<string, 'DemoCapability'>;
 export type DemoPaymentFlowId = Brand<string, 'DemoPaymentFlowId'>;
-export type DemoClaimTtlHours = Brand<number, 'DemoClaimTtlHours'>;
 export type GiftingOfferId = Brand<string, 'GiftingOfferId'>;
 export type GiftingInstrumentId = Brand<string, 'GiftingInstrumentId'>;
 export type BookingRequirementId = Brand<string, 'BookingRequirementId'>;
@@ -278,7 +277,6 @@ export declare const unsafeAsDemoLifecycleAuditEventId: (id: string) => DemoLife
 export declare const unsafeAsDemoRuntimeId: (id: string) => DemoRuntimeId;
 export declare const unsafeAsDemoCapability: (value: string) => DemoCapability;
 export declare const unsafeAsDemoPaymentFlowId: (id: string) => DemoPaymentFlowId;
-export declare const unsafeAsDemoClaimTtlHours: (value: number) => DemoClaimTtlHours;
 export declare const unsafeAsGiftingOfferId: (id: string) => GiftingOfferId;
 export declare const unsafeAsGiftingInstrumentId: (id: string) => GiftingInstrumentId;
 export declare const unsafeAsBookingRequirementId: (id: string) => BookingRequirementId;

package/dist/_dts/core/src/demo-claim-access.d.ts

@@ -4,7 +4,7 @@ export type DemoClaimAccessInstance = Readonly<{
     status: DemoInstanceStatus;
 }>;
 export type DemoClaimAccessClaim = Readonly<{
-    status: DemoClaimStatus;
+    status: Exclude<DemoClaimStatus, 'preparing'>;
     expiresAt: string;
 }> | null;
 export declare function deriveDemoClaimAccessState(input: Readonly<{