@riverbankcms/sdk 0.151.0 → 0.153.0

package/dist/_dts/blocks/src/system/runtime/nodes/file-download.d.ts

@@ -1,8 +1,9 @@
 import React from 'react';
-import { type Media, type PublicDownloadMediaType } from '../../../lib/media';
+import { type PublicDownloadMediaType } from '../../../lib/media';
+import { type RuntimeMedia } from './media';
 import { type BlockButtonRole } from '../../constants/buttonRoles';
 export type FileDownloadNodeProps = Readonly<{
-    value?: Media | null;
+    value?: RuntimeMedia | null;
     title?: string | null;
     description?: string | null;
     buttonLabel?: string | null;

package/dist/_dts/blocks/src/system/runtime/nodes/media.d.ts

@@ -1,6 +1,10 @@
 import React from 'react';
-import { type ResolvedMediaTransform, type DirectImageUrlOptions, type RenderableMediaAsset, type RenderableMediaAssetIndex } from '../../../../../media-core/src/index';
+import { type RuntimeMedia, type ManagedMediaResolution, type ResolvedMediaTransform, type DirectImageUrlOptions } from '../../../../../media-core/src/index';
 import type { Media } from '../../../lib/media';
+import { type ResolveImageUrlContext } from './mediaContext';
+export { buildMediaAssetIndex, buildResolveImageUrlContext, getCurrentResolveImageUrlContext, getSiteId, getSupabaseUrl, runWithMediaContext, setContextSupabaseUrl, setContextSiteId, setContextMediaAssetIndex, setContextMediaAssets, setContextResolveImageUrlContext, } from './mediaContext';
+export type { MediaAssetIndex, MediaAssetIndexItem, ResolveImageUrlContext, ResolveImageUrlContextInput } from './mediaContext';
+export type { RuntimeMedia } from '../../../../../media-core/src/index';
 /**
  * Options for image URL resolution.
  * Requires either dimensions or explicit original request.
@@ -18,24 +22,6 @@ export type ImageOptions = {
 } | {
     original: true;
 };
-export type ResolveImageUrlContext = {
-    supabaseUrl?: string;
-    siteId?: string;
-    /**
-     * Optional per-call media asset index for resolving identifier-only media values
-     * without mutating persisted content shapes.
-     */
-    mediaAssetIndex?: MediaAssetIndex;
-};
-export type ResolveImageUrlContextInput = Readonly<{
-    supabaseUrl?: string;
-    siteId?: string;
-    mediaAssetIndex?: MediaAssetIndex;
-    mediaAssets?: readonly MediaAssetIndexItem[];
-}>;
-export type MediaAssetIndexItem = RenderableMediaAsset;
-export type MediaAssetIndex = RenderableMediaAssetIndex;
-export declare function buildMediaAssetIndex(assets: readonly MediaAssetIndexItem[] | undefined): MediaAssetIndex | undefined;
 export type ResolveImageSourceSetOptions = {
     widthCandidates?: readonly number[];
     sizes?: string;
@@ -78,9 +64,8 @@ export type MediaUrlResolution = Readonly<{
     assetId?: string;
     identifier?: string | null;
 }>;
-export declare function buildResolveImageUrlContext(input: ResolveImageUrlContextInput | undefined): ResolveImageUrlContext;
-export declare function resolveMediaStorageUrl(value: Media, context?: ResolveImageUrlContext | null, transformOptions?: DirectImageUrlOptions): string | undefined;
-export declare function resolveMediaStorageUrlResult(value: Media, context?: ResolveImageUrlContext | null, transformOptions?: DirectImageUrlOptions): MediaUrlResolution;
+export declare function resolveMediaStorageUrl(value: RuntimeMedia, context?: ResolveImageUrlContext | null, transformOptions?: DirectImageUrlOptions): string | undefined;
+export declare function resolveMediaStorageUrlResult(value: RuntimeMedia, context?: ResolveImageUrlContext | null, transformOptions?: DirectImageUrlOptions): MediaUrlResolution;
 /**
  * Common image size presets.
  * Use these for consistent sizing across the application.
@@ -111,68 +96,15 @@ export declare const ImagePresets: {
         readonly resize: "contain";
     };
 };
-/**
- * Media context for URL resolution.
- * Contains site-specific values needed to build storage URLs.
- */
-type MediaContext = {
-    supabaseUrl?: string;
-    siteId?: string;
-    mediaAssetIndex?: MediaAssetIndex;
-};
-/**
- * Run a function with the given media context.
- * On server: Uses AsyncLocalStorage to isolate context per request.
- * On client: Temporarily sets module-level context for the duration of the call.
- *
- * @example
- * ```tsx
- * runWithMediaContext(
- *   { supabaseUrl: 'https://...', siteId: 'abc-123' },
- *   () => renderPage(page)
- * )
- * ```
- */
-export declare function runWithMediaContext<T>(context: MediaContext, fn: () => T): T;
-/**
- * Set the Supabase URL in the current context.
- * @deprecated Use runWithMediaContext instead for request isolation.
- */
-export declare function setContextSupabaseUrl(url: string | undefined): void;
-/**
- * Set the site ID in the current context.
- * @deprecated Use runWithMediaContext instead for request isolation.
- */
-export declare function setContextSiteId(siteId: string | undefined): void;
-export declare function setContextMediaAssetIndex(index: MediaAssetIndex | undefined): void;
-export declare function setContextResolveImageUrlContext(context: ResolveImageUrlContext | undefined): void;
-export declare function getCurrentResolveImageUrlContext(): ResolveImageUrlContext | undefined;
-export declare function setContextMediaAssets(assets: readonly MediaAssetIndexItem[] | undefined): void;
-/**
- * Get the Supabase URL for constructing direct storage URLs.
- * Used for serving images directly from Supabase storage CDN.
- *
- * Resolution order:
- * 1. Context URL (set via runWithMediaContext or setContextSupabaseUrl)
- * 2. Environment variable NEXT_PUBLIC_SUPABASE_URL
- *
- * SDK sites receive the URL from the API, so they don't need the env var.
- * Dashboard and frontend apps use the env var.
- */
-export declare function getSupabaseUrl(): string;
-/**
- * Get the site ID for constructing storage paths.
- * Required for relative path resolution.
- */
-export declare function getSiteId(): string | undefined;
-export declare function resolveVideoPosterUrl(value: Media, context?: ResolveImageUrlContext | null): string | undefined;
-export declare function resolveMediaWithContext<TMedia extends Media>(value: TMedia, context?: ResolveImageUrlContext | null): TMedia;
+/** Resolve portable content without exposing runtime metadata as saved values. */
+export declare function resolveMediaWithContext<TReference extends Media>(reference: TReference, context?: ResolveImageUrlContext | null): ManagedMediaResolution<TReference>;
+export declare function resolveVideoPosterUrl(value: RuntimeMedia, context?: ResolveImageUrlContext | null): string | undefined;
 export type MediaImageLoading = NonNullable<React.ImgHTMLAttributes<HTMLImageElement>['loading']>;
 export type MediaImageFetchPriority = NonNullable<React.ImgHTMLAttributes<HTMLImageElement>['fetchPriority']>;
 export type MediaNodeProps = {
     "data-slot"?: string;
     "data-surface"?: string;
-    value?: Media | null;
+    value?: RuntimeMedia | null;
     className?: string;
     style?: React.CSSProperties;
     children?: React.ReactNode;
@@ -196,7 +128,7 @@ export type MediaNodeProps = {
     imageResolveContext?: ResolveImageUrlContext | null;
 };
 export type VideoPlaybackMode = 'inline' | 'background';
-export declare function resolveMediaNodeResponsiveImage(value: Media, size: ImageOptions, style: React.CSSProperties | undefined, slot: {
+export declare function resolveMediaNodeResponsiveImage(value: RuntimeMedia, size: ImageOptions, style: React.CSSProperties | undefined, slot: {
     fieldPath?: string;
     blockKind?: string | null;
     blockContent?: unknown;
@@ -207,14 +139,15 @@ export declare function resolveMediaNodeResponsiveImage(value: Media, size: Imag
     resolvedTransform?: ResolvedMediaTransform;
     isProxy?: boolean;
 };
-export declare function renderVideo(value: Media, className?: string, style?: React.CSSProperties, context?: ResolveImageUrlContext | null, options?: {
+export declare function renderVideo(value: RuntimeMedia, className?: string, style?: React.CSSProperties, context?: ResolveImageUrlContext | null, options?: {
     playback?: VideoPlaybackMode;
 }): React.ReactElement | null;
-export declare function renderAudio(value: Media, className?: string, style?: React.CSSProperties, context?: ResolveImageUrlContext | null): React.ReactElement | null;
-export declare function computeMediaTransformStyle(value: Media, style?: React.CSSProperties, targetAspectRatio?: number | string, options?: {
+export declare function resolvePublicMediaUrl(value: RuntimeMedia, context?: ResolveImageUrlContext | null): string | undefined;
+export declare function renderAudio(value: RuntimeMedia, className?: string, style?: React.CSSProperties, context?: ResolveImageUrlContext | null): React.ReactElement | null;
+export declare function computeMediaTransformStyle(value: RuntimeMedia, style?: React.CSSProperties, targetAspectRatio?: number | string, options?: {
     resolvedTransform?: ResolvedMediaTransform;
     isProxy?: boolean;
-}): React.CSSProperties | undefined;
+}, context?: ResolveImageUrlContext | null): React.CSSProperties | undefined;
 export declare const computeHotspotStyle: typeof computeMediaTransformStyle;
 export declare function resolveTargetAspectRatio(size: ImageOptions): number | undefined;
 export declare function MediaPlaceholder({ className, style, fieldPath, authoring, }: {
@@ -246,10 +179,9 @@ export declare const MediaNode: React.FC<MediaNodeProps>;
  * resolveImageUrl(media, { original: true })
  * ```
  */
-export declare function resolveImageUrl(value: Media, options: ImageOptions, context?: ResolveImageUrlContext | null): string | undefined;
-export declare function resolveImageUrlResult(value: Media, options: ImageOptions, context?: ResolveImageUrlContext | null): MediaUrlResolution;
-export declare function resolveImageUrlWithContext(value: Media, options: ImageOptions, context?: ResolveImageUrlContext | null, transformAspectRatio?: number | string): string | undefined;
-export declare function resolveImageUrlWithContextResult(value: Media, options: ImageOptions, context?: ResolveImageUrlContext | null, transformAspectRatio?: number | string): MediaUrlResolution;
-export declare function resolveImageSourceSetWithContext(value: Media, options: ResolveImageSourceSetOptions, context?: ResolveImageUrlContext | null): ResolvedImageSourceSet | undefined;
+export declare function resolveImageUrl(value: RuntimeMedia, options: ImageOptions, context?: ResolveImageUrlContext | null): string | undefined;
+export declare function resolveImageUrlResult(value: RuntimeMedia, options: ImageOptions, context?: ResolveImageUrlContext | null): MediaUrlResolution;
+export declare function resolveImageUrlWithContext(value: RuntimeMedia, options: ImageOptions, context?: ResolveImageUrlContext | null, transformAspectRatio?: number | string): string | undefined;
+export declare function resolveImageUrlWithContextResult(value: RuntimeMedia, options: ImageOptions, context?: ResolveImageUrlContext | null, transformAspectRatio?: number | string): MediaUrlResolution;
+export declare function resolveImageSourceSetWithContext(value: RuntimeMedia, options: ResolveImageSourceSetOptions, context?: ResolveImageUrlContext | null): ResolvedImageSourceSet | undefined;
 export declare function mediaImageHostProps(props: Pick<MediaNodeProps, 'value' | 'className' | 'loading' | 'fetchPriority' | 'data-slot' | 'data-surface'>, style: React.CSSProperties | undefined): React.ImgHTMLAttributes<HTMLImageElement> & Pick<MediaNodeProps, 'data-slot' | 'data-surface'>;
-export {};

package/dist/_dts/blocks/src/system/runtime/nodes/mediaContext.d.ts

@@ -0,0 +1,69 @@
+import { type RenderableMediaAsset, type RenderableMediaAssetIndex } from '../../../../../media-core/src/index';
+export type ResolveImageUrlContext = {
+    supabaseUrl?: string;
+    siteId?: string;
+    /**
+     * Optional per-call media asset index for resolving identifier-only media values
+     * without mutating persisted content shapes.
+     */
+    mediaAssetIndex?: MediaAssetIndex;
+};
+export type ResolveImageUrlContextInput = Readonly<{
+    supabaseUrl?: string;
+    siteId?: string;
+    mediaAssetIndex?: MediaAssetIndex;
+    mediaAssets?: readonly MediaAssetIndexItem[];
+}>;
+export type MediaAssetIndexItem = RenderableMediaAsset;
+export type MediaAssetIndex = RenderableMediaAssetIndex;
+export declare function buildMediaAssetIndex(assets: readonly MediaAssetIndexItem[] | undefined): MediaAssetIndex | undefined;
+export declare function buildResolveImageUrlContext(input: ResolveImageUrlContextInput | undefined): ResolveImageUrlContext;
+/**
+ * Media context for URL resolution.
+ * Contains site-specific values needed to build storage URLs.
+ */
+type MediaContext = {
+    supabaseUrl?: string;
+    siteId?: string;
+    mediaAssetIndex?: MediaAssetIndex;
+};
+/**
+ * Run a function with the given media context.
+ * On server: Uses AsyncLocalStorage to isolate context per request.
+ * On client: Temporarily sets module-level context for the duration of the call.
+ *
+ * @example
+ * ```tsx
+ * runWithMediaContext(
+ *   { supabaseUrl: 'https://...', siteId: 'abc-123' },
+ *   () => renderPage(page)
+ * )
+ * ```
+ */
+export declare function runWithMediaContext<T>(context: MediaContext, fn: () => T): T;
+export declare function setContextSupabaseUrl(url: string | undefined): void;
+/** @deprecated Use runWithMediaContext for request isolation. */
+export declare function setContextSiteId(siteId: string | undefined): void;
+export declare function setContextMediaAssetIndex(index: MediaAssetIndex | undefined): void;
+export declare function setContextResolveImageUrlContext(context: ResolveImageUrlContext | undefined): void;
+export declare function getCurrentResolveImageUrlContext(): ResolveImageUrlContext | undefined;
+export declare function setContextMediaAssets(assets: readonly MediaAssetIndexItem[] | undefined): void;
+/**
+ * Get the Supabase URL for constructing direct storage URLs.
+ * Used for serving images directly from Supabase storage CDN.
+ *
+ * Resolution order:
+ * 1. Context URL (set via runWithMediaContext or setContextSupabaseUrl)
+ * 2. Environment variable NEXT_PUBLIC_SUPABASE_URL
+ *
+ * SDK sites receive the URL from the API, so they don't need the env var.
+ * Dashboard and frontend apps use the env var.
+ */
+export declare function getSupabaseUrl(): string;
+/**
+ * Get the site ID for constructing storage paths.
+ * Required for relative path resolution.
+ */
+export declare function getSiteId(): string | undefined;
+export declare function getMediaAssetIndex(context?: ResolveImageUrlContext): MediaAssetIndex | undefined;
+export {};

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

@@ -1,4 +1,4 @@
-import type { BookingDepositRefundPolicy } from '../../../../../core/src/index';
+import { type BookingDepositRefundPolicy, type BookingInstalmentPlanConfig } from '../../../../../core/src/index';
 export type BookingPaymentOptionCopy = Readonly<{
     title: string;
     description: string;
@@ -6,6 +6,8 @@ export type BookingPaymentOptionCopy = Readonly<{
     ctaLabel: string;
 }>;
 export declare function buildUpfrontBookingPaymentOptionCopy(formattedTotal: string): BookingPaymentOptionCopy;
+/** Reused after booking; payment remains outside the platform. */
+export declare const OFFLINE_BOOKING_PAYMENT_INSTRUCTIONS = "Pay the business later, outside the platform.";
 export declare function buildDeferredManualBookingPaymentOptionCopy(): BookingPaymentOptionCopy;
 export declare function buildInstalmentBookingPaymentOptionCopy(input: Readonly<{
     formattedDueToday: string;
@@ -19,3 +21,5 @@ export declare function buildFlexibleBalanceBookingPaymentOptionCopy(input: Read
     dueDateLabel: string;
     depositRefundability: BookingDepositRefundPolicy;
 }>): BookingPaymentOptionCopy;
+/** Configured cadence for the existing instalment description. */
+export declare function buildBookingInstalmentCadenceLabel(plan: BookingInstalmentPlanConfig): string;

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,5 @@ 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';
+export type { LinkResolverContext } from '../../links/resolve';

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

@@ -1,4 +1,6 @@
 import type { TransformDefinition } from "./core";
+import { type LinkResolverContext } from "../../links/resolve";
 export declare const resolveLinkTransform: TransformDefinition;
 export declare const linkLabelTransform: TransformDefinition;
 export declare const linksTransforms: TransformDefinition[];
+export declare function resolveAuthoredLinkHref(value: unknown, context?: LinkResolverContext): 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 {};