@riverbankcms/sdk 0.98.0 → 0.99.0

package/dist/_dts/api/src/siteOperations.d.ts

@@ -1,5 +1,6 @@
 import type { AppointmentBookingQuestionsTask } from "./bookingOperations";
 import type { SiteRole } from "./siteMembers";
+import type { AdminManagedSubscriptionActionChoice, ManagedManualBillingReason, SiteBillingArrangement, SiteBillingArrangementKind, SiteBillingArrangementSubscriptionAction, SiteBillingManualReviewPayload, SiteBillingManualReviewResolutionAction, SiteBillingManualReviewStatus } from "../../billing/src/site-arrangements";
 /**
  * Site Operations Contracts
  *
@@ -70,8 +71,12 @@ export type AdminSiteCostResponse = {
     site: {
         id: string;
         name: string;
+        arrangement: SiteBillingArrangement;
+        arrangementKind: SiteBillingArrangementKind;
         monthlyCostCents: number;
         billingStartsAt: string | null;
+        manualReason: ManagedManualBillingReason | null;
+        manualNote: string | null;
         formattedCost: string;
     };
     owner: {
@@ -88,10 +93,46 @@ export type AdminSiteCostResponse = {
         formattedPreviousCost: string;
         formattedNewCost: string;
     }>;
+    arrangementHistory: Array<{
+        id: string;
+        previousArrangement: SiteBillingArrangementKind;
+        newArrangement: SiteBillingArrangementKind;
+        previousCostCents: number;
+        newCostCents: number;
+        previousManualReason: ManagedManualBillingReason | null;
+        newManualReason: ManagedManualBillingReason | null;
+        previousManualNote: string | null;
+        newManualNote: string | null;
+        changedBy: string;
+        reason: string | null;
+        subscriptionAction: SiteBillingArrangementSubscriptionAction;
+        subscriptionActionResult: unknown;
+        createdAt: string;
+        formattedPreviousCost: string;
+        formattedNewCost: string;
+    }>;
+    manualReviews: AdminSiteCostManualReview[];
 };
-export type AdminUpdateSiteCostRequest = {
+export type AdminSiteCostManualReview = SiteBillingManualReviewPayload & {
+    id: string;
+    status: SiteBillingManualReviewStatus;
+    resolutionAction: SiteBillingManualReviewResolutionAction | null;
+    createdAt: string;
+};
+export type AdminSiteBillingArrangementRequest = {
+    tag: "self_serve";
+} | {
+    tag: "managed_platform_subscription";
     monthlyCostCents: number;
     billingStartsAt?: string | null;
+} | {
+    tag: "managed_manual";
+    reason: ManagedManualBillingReason;
+    note?: string | null;
+};
+export type AdminUpdateSiteCostRequest = {
+    arrangement: AdminSiteBillingArrangementRequest;
+    subscriptionAction?: AdminManagedSubscriptionActionChoice;
     reason?: string;
 };
 export type AdminSiteCostUpdateSyncResult = {
@@ -106,6 +147,15 @@ export type AdminSiteCostUpdateSyncResult = {
 } | {
     status: "failed";
     message: string;
+} | {
+    status: "cancelled";
+    message: null;
+} | {
+    status: "scheduled_cancel_at_period_end";
+    message: null;
+} | {
+    status: "manual_review_required";
+    message: string;
 };
 export type AdminUpdateSiteCostResponse = AdminSiteCostResponse & {
     subscriptionSync: AdminSiteCostUpdateSyncResult;
@@ -120,6 +170,20 @@ export type AdminScheduleBillingComponentEndResponse = {
         endsAt: string;
     };
 };
+export type AdminResolveSiteBillingManualReviewRequest = {
+    resolutionAction: SiteBillingManualReviewResolutionAction;
+    resolutionNote: string;
+};
+export type AdminResolveSiteBillingManualReviewResponse = {
+    review: {
+        id: string;
+        status: SiteBillingManualReviewStatus;
+        resolutionAction: SiteBillingManualReviewResolutionAction | null;
+        resolvedAt: string | null;
+        resolvedBy: string | null;
+        resolutionNote: string | null;
+    };
+};
 export type ListGscPropertiesAdminResponse = {
     properties: Array<{
         id: string;

package/dist/_dts/billing/src/site-arrangements.d.ts

@@ -0,0 +1,151 @@
+import { type PositiveCents, type Result } from '../../core/src/index';
+export declare const SITE_BILLING_ARRANGEMENT_KINDS: readonly ["self_serve", "managed_platform_subscription", "managed_manual"];
+export type SiteBillingArrangementKind = (typeof SITE_BILLING_ARRANGEMENT_KINDS)[number];
+export declare const MANAGED_MANUAL_BILLING_REASONS: readonly ["bank_transfer", "testing_exchange", "complimentary", "other"];
+export type ManagedManualBillingReason = (typeof MANAGED_MANUAL_BILLING_REASONS)[number];
+export type SiteBillingArrangement = Readonly<{
+    tag: 'self_serve';
+}> | Readonly<{
+    tag: 'managed_platform_subscription';
+    monthlyCostCents: PositiveCents;
+    billingStartsAt: string | null;
+}> | Readonly<{
+    tag: 'managed_manual';
+    reason: ManagedManualBillingReason;
+    note: string | null;
+}>;
+export type SiteBillingArrangementRow = Readonly<{
+    siteBillingArrangement: string | null | undefined;
+    monthlyCostCents: number | null | undefined;
+    billingStartsAt: string | null | undefined;
+    siteBillingManualReason?: string | null | undefined;
+    siteBillingManualNote?: string | null | undefined;
+}>;
+export type SiteBillingArrangementParseError = Readonly<{
+    kind: 'unknown_arrangement';
+    value: string | null | undefined;
+}> | Readonly<{
+    kind: 'invalid_platform_cost';
+    value: number | null | undefined;
+}> | Readonly<{
+    kind: 'unexpected_platform_fields_for_self_serve';
+}> | Readonly<{
+    kind: 'missing_manual_reason';
+}> | Readonly<{
+    kind: 'unknown_manual_reason';
+    value: string | null | undefined;
+}> | Readonly<{
+    kind: 'unexpected_platform_fields_for_manual';
+}> | Readonly<{
+    kind: 'unexpected_manual_fields_for_non_manual';
+}>;
+export type SiteBillingArrangementStorageFields = Readonly<{
+    siteBillingArrangement: SiteBillingArrangementKind;
+    monthlyCostCents: number;
+    billingStartsAt: string | null;
+    siteBillingManualReason: ManagedManualBillingReason | null;
+    siteBillingManualNote: string | null;
+}>;
+export type BillingSubscriptionOrigin = 'self_serve_plan' | 'managed_site_aggregate';
+export declare const BILLING_SUBSCRIPTION_ORIGINS: readonly ["self_serve_plan", "managed_site_aggregate"];
+export type AdminManagedSubscriptionActionChoice = 'cancel_immediately' | 'cancel_at_period_end' | 'manual_review';
+export type ActiveSiteLinkedPlatformAddOn = Readonly<{
+    id: string;
+    kind: string;
+}>;
+export type SiteBillingSubscriptionSnapshot = Readonly<{
+    id: string;
+    origin: BillingSubscriptionOrigin | null;
+    status: string;
+}> | null;
+export type SiteBillingManualReviewReason = 'ambiguous_subscription_origin' | 'active_site_linked_add_on' | 'admin_requested_manual_review' | 'missing_admin_subscription_choice' | 'subscription_action_failed';
+export declare const SITE_BILLING_MANUAL_REVIEW_REASONS: readonly ["ambiguous_subscription_origin", "active_site_linked_add_on", "admin_requested_manual_review", "missing_admin_subscription_choice", "subscription_action_failed"];
+export type SiteBillingManualReviewStatus = 'open' | 'resolved';
+export declare const SITE_BILLING_MANUAL_REVIEW_STATUSES: readonly ["open", "resolved"];
+export type SiteBillingManualReviewResolutionAction = 'external_action_completed' | 'no_action_needed' | 'duplicate' | 'superseded_by_arrangement_change' | 'accepted_risk';
+export declare const SITE_BILLING_MANUAL_REVIEW_RESOLUTION_ACTIONS: readonly ["external_action_completed", "no_action_needed", "duplicate", "superseded_by_arrangement_change", "accepted_risk"];
+export type SiteBillingManualReviewFailureAction = 'cancel_immediately' | 'cancel_at_period_end' | 'sync_existing_subscription' | 'post_stripe_arrangement_update_failed';
+export type SiteBillingManualReviewDetailsByReason = Readonly<{
+    ambiguous_subscription_origin: Readonly<{
+        subscriptionId: string | null;
+    }>;
+    active_site_linked_add_on: Readonly<{
+        activeAddOnIds: readonly string[];
+    }>;
+    admin_requested_manual_review: Readonly<{
+        subscriptionId: string | null;
+    }>;
+    missing_admin_subscription_choice: Readonly<{
+        subscriptionId: string | null;
+    }>;
+    subscription_action_failed: Readonly<{
+        action: SiteBillingManualReviewFailureAction;
+        error: string;
+        stripeSubscriptionId: string | null;
+        externalActionCompleted?: boolean;
+        transitionAttemptId?: string | null;
+    }>;
+}>;
+export type SiteBillingManualReviewPayload = {
+    [TReason in SiteBillingManualReviewReason]: Readonly<{
+        reason: TReason;
+        details: SiteBillingManualReviewDetailsByReason[TReason];
+    }>;
+}[SiteBillingManualReviewReason];
+export type SiteBillingArrangementPlanManualReviewReason = Exclude<SiteBillingManualReviewReason, 'subscription_action_failed'>;
+export type SiteBillingArrangementSubscriptionAction = 'not_applicable' | 'sync_attempted' | 'cancelled_immediately' | 'scheduled_cancel_at_period_end' | 'manual_review_required' | 'failed';
+export declare const SITE_BILLING_ARRANGEMENT_SUBSCRIPTION_ACTIONS: readonly ["not_applicable", "sync_attempted", "cancelled_immediately", "scheduled_cancel_at_period_end", "manual_review_required", "failed"];
+export type SiteBillingTransitionAttemptStatus = 'pending_external_action' | 'external_action_succeeded' | 'finalized' | 'failed';
+export declare const SITE_BILLING_TRANSITION_ATTEMPT_STATUSES: readonly ["pending_external_action", "external_action_succeeded", "finalized", "failed"];
+export type SiteBillingArrangementChangePlan = Readonly<{
+    tag: 'no_stripe_action';
+}> | Readonly<{
+    tag: 'sync_existing_subscription';
+}> | Readonly<{
+    tag: 'cancel_managed_site_subscription';
+    timing: 'immediate' | 'period_end';
+    subscriptionId: string;
+}> | Readonly<{
+    tag: 'manual_review_required';
+    reason: SiteBillingArrangementPlanManualReviewReason;
+    subscriptionId?: string;
+    activeAddOnIds?: readonly string[];
+}>;
+export declare function isSiteBillingArrangementKind(value: string | null | undefined): value is SiteBillingArrangementKind;
+export declare function isManagedManualBillingReason(value: string | null | undefined): value is ManagedManualBillingReason;
+export declare function isBillingSubscriptionOrigin(value: string | null | undefined): value is BillingSubscriptionOrigin;
+export declare function isSiteBillingArrangementSubscriptionAction(value: string | null | undefined): value is SiteBillingArrangementSubscriptionAction;
+export declare function isSiteBillingManualReviewReason(value: string | null | undefined): value is SiteBillingManualReviewReason;
+export declare function isSiteBillingManualReviewStatus(value: string | null | undefined): value is SiteBillingManualReviewStatus;
+export declare function isSiteBillingManualReviewResolutionAction(value: string | null | undefined): value is SiteBillingManualReviewResolutionAction;
+export declare function isSiteBillingTransitionAttemptStatus(value: string | null | undefined): value is SiteBillingTransitionAttemptStatus;
+export declare function normalizeSiteBillingManualReviewPayload(payload: SiteBillingManualReviewPayload): SiteBillingManualReviewPayload;
+export declare function parseSiteBillingArrangement(row: SiteBillingArrangementRow): Result<SiteBillingArrangement, SiteBillingArrangementParseError>;
+export declare function unwrapSiteBillingArrangement(row: SiteBillingArrangementRow): SiteBillingArrangement;
+export declare function siteBillingArrangementToStorage(arrangement: SiteBillingArrangement): SiteBillingArrangementStorageFields;
+export declare function getSiteBillingArrangementKind(arrangement: SiteBillingArrangement): SiteBillingArrangementKind;
+export declare function grantsStudioEquivalentEntitlements(arrangement: SiteBillingArrangement): boolean;
+export declare function isManagedSiteArrangement(arrangement: SiteBillingArrangement): boolean;
+export declare function isPlatformCollectedManagedSite(arrangement: SiteBillingArrangement): arrangement is Extract<SiteBillingArrangement, {
+    tag: 'managed_platform_subscription';
+}>;
+export declare function requiresSiteBillingCheckout(arrangement: SiteBillingArrangement): boolean;
+export declare function countsAsSelfServeMacadamiaSite(arrangement: SiteBillingArrangement): boolean;
+export declare function toChargeableManagedSiteCost(site: Readonly<{
+    siteId: string;
+    siteName: string;
+    arrangement: SiteBillingArrangement;
+}>): Readonly<{
+    siteId: string;
+    siteName: string;
+    monthlyCostCents: number;
+    billingStartsAt: string | null;
+}> | null;
+export declare function planSiteBillingArrangementChange(input: Readonly<{
+    previous: SiteBillingArrangement;
+    next: SiteBillingArrangement;
+    subscription: SiteBillingSubscriptionSnapshot;
+    activeSiteLinkedAddOns: readonly ActiveSiteLinkedPlatformAddOn[];
+    adminSubscriptionAction?: AdminManagedSubscriptionActionChoice | null;
+}>): SiteBillingArrangementChangePlan;
+export declare function isSubscriptionActiveForArrangementPlanning(status: string): boolean;

package/dist/_dts/billing/src/subscriptions/store.d.ts

@@ -1,10 +1,12 @@
 import type { BillingInterval } from '../plans/types';
+import type { BillingSubscriptionOrigin } from '../site-arrangements';
 export type SubscriptionStatus = 'incomplete' | 'trialing' | 'active' | 'past_due' | 'canceled' | 'unpaid';
 export interface SubscriptionRecord {
     id: string;
     userId: string;
     customerId: string;
     planId: string;
+    origin: BillingSubscriptionOrigin | null;
     interval: BillingInterval;
     status: SubscriptionStatus;
     currentPeriodEnd: string;

package/dist/_dts/block-form/src/widgets/RepeaterField/utils/resolveThumbnail.d.ts

@@ -1,7 +1,8 @@
-import { type ResolveImageUrlContext } from '../../../../../blocks/src/index';
+import { resolveImageUrlWithContext, type ResolveImageUrlContext } from '../../../../../blocks/src/index';
 type ResolveRepeaterThumbnailOptions = {
     siteId?: string;
     imageResolveContext?: ResolveImageUrlContext;
+    resolveImageUrl?: typeof resolveImageUrlWithContext;
 };
 export type ResolvedRepeaterThumbnail = {
     src: string | null;

package/dist/_dts/blocks/src/PageRenderer.d.ts

@@ -50,6 +50,8 @@ type PageRendererDataContext = {
     occurrenceContext?: OccurrenceContextData | null;
     entrySubrouteContext?: EntrySubrouteContextData | null;
     contentEntry?: Record<string, unknown> | null;
+    pageSurface?: Record<string, unknown> | null;
+    subject?: unknown;
     editableRouteMetadataFieldIds?: ReadonlyArray<string> | null;
     supabaseUrl?: string;
     mediaAssets?: readonly MediaAssetIndexItem[];
@@ -104,6 +106,10 @@ export type BlockOverrideProps<TContent = Record<string, unknown>> = {
     entrySubrouteContext?: EntrySubrouteContextData | null;
     /** Content entry context for template-aware block overrides. */
     contentEntry?: Record<string, unknown> | null;
+    /** Native page-surface context for template-aware block overrides. */
+    pageSurface?: Record<string, unknown> | null;
+    /** Subject descriptor for native page-surface block overrides. */
+    subject?: unknown;
     /** Supabase project URL (useful for media URL resolution in override components) */
     supabaseUrl?: string;
     /** Full image-resolution context including canonical media sidecars. */

package/dist/_dts/blocks/src/system/runtime/components/booking/DatePicker.d.ts

@@ -1,8 +1,10 @@
 /**
  * DatePicker Component
  *
- * Displays a dropdown for selecting an appointment date from available dates.
- * Supports loading states, empty states, and progressive loading.
+ * Selectable grid of available appointment dates rendered as pill buttons
+ * (weekday / day / month), with loading, empty and progressive-loading
+ * states. Selection uses button-toggle semantics: each pill is a button with
+ * aria-pressed and a full accessible date name, inside a labelled group.
  */
 import React from 'react';
 type DatePickerProps = {
@@ -10,6 +12,8 @@ type DatePickerProps = {
     onChange: (date: string) => void;
     dateOptions: string[];
     required?: boolean;
+    ariaDescribedBy?: string;
+    ariaInvalid?: boolean;
     isLoading?: boolean;
     isEmpty?: boolean;
     hasMore?: boolean;

package/dist/_dts/blocks/src/system/runtime/components/booking/SuccessMessage.d.ts

@@ -1,7 +1,9 @@
 /**
  * SuccessMessage Component
  *
- * Displays success message after successful appointment booking.
+ * Terminal success state after a completed appointment booking.
+ * Rendered on the shared registration-surface (see booking-form.client),
+ * using the shared TerminalPanel + StateIcon primitives.
  */
 import React from 'react';
 type SuccessMessageProps = {

package/dist/_dts/blocks/src/system/runtime/components/booking/TimeSlotSelector.d.ts

@@ -1,16 +1,22 @@
 /**
  * TimeSlotSelector Component
  *
- * Displays available time slots for the selected date with loading and empty states.
+ * Selectable grid of available time slots for the chosen date, rendered as
+ * pill buttons with button-toggle semantics (aria-pressed) inside a labelled
+ * group. The timezone is part of each pill's accessible name via the full
+ * time format; the visible pill shows the compact time.
  */
 import React from 'react';
-import type { TimeSlot } from '../../hooks/useAvailableSlots';
+import type { BookingSlotDisplayOption } from '../../hooks/useHeadlessBookingFlow.state';
 type TimeSlotSelectorProps = {
     value: string;
-    onChange: (slotStartTime: string) => void;
-    slots: TimeSlot[];
+    onChange: (slotKey: string) => void;
+    slots: readonly BookingSlotDisplayOption[];
     isLoading: boolean;
+    timezone: string;
     required?: boolean;
+    ariaDescribedBy?: string;
+    ariaInvalid?: boolean;
 };
 export declare const TimeSlotSelector: React.FC<TimeSlotSelectorProps>;
 export {};

package/dist/_dts/blocks/src/system/runtime/hooks/useHeadlessBookingFlow.state.d.ts

@@ -1,3 +1,3 @@
-export { unsafeAsBookingFieldId, bookingFlowReducer, buildBookingAvailabilityQuery, buildBookingStepPlan, buildBookingSubmitPlan, createBookingBlockApiConfig, createEmptyBookingValidationErrors, createFieldBookingValidationErrors, createFormBookingValidationError, createInitialBookingFlowReducerState, describeUnknownError, deriveBookingFieldViews, deriveBookingFlowSteps, getAppointmentBookingOverrideInput, hasBookingValidationErrors, resolveAppointmentPackagesModel, resolveAvailabilitySelectionInvalidation, resolveHeadlessBookingStatus, resolveHeadlessBookingView, toBookingFormData, toBookingSlotView, toBookingSlotViews, toOptionalAppointmentResourceId, toOptionalAppointmentServiceId, validateBookingField, validateBookingFields, validateBookingStep, } from "../nodes/booking-form.headless.state";
+export { unsafeAsBookingFieldId, bookingFlowReducer, buildBookingAvailabilityQuery, buildBookingStepPlan, buildBookingSubmitPlan, createBookingBlockApiConfig, createEmptyBookingValidationErrors, createFieldBookingValidationErrors, createFormBookingValidationError, createInitialBookingFlowReducerState, deriveBookingSlotDisplayOptions, describeUnknownError, deriveBookingFieldViews, deriveBookingFlowSteps, getAppointmentBookingOverrideInput, hasBookingValidationErrors, resolveAppointmentPackagesModel, resolveAvailabilitySelectionInvalidation, resolveHeadlessBookingStatus, resolveHeadlessBookingView, toBookingFormData, toBookingSlotView, toBookingSlotViews, toOptionalAppointmentResourceId, toOptionalAppointmentServiceId, validateBookingField, validateBookingFields, validateBookingStep, } from "../nodes/booking-form.headless.state";
 export { formatBookingCentsAsCurrencyInput, getBookingServiceSlidingScale, parseBookingCurrencyInputToCents, } from "../nodes/booking-form.state";
-export type { AppointmentBookingOverrideData, AppointmentBookingOverrideInput, AppointmentBookingOverrideInputResult, AppointmentBookingOverridePropsLike, BookingAvailabilityQuery, BookingAppointmentPackagesModel, BookingAppointmentPackagesUnavailableReason, BookingFieldId, BookingFieldValue, BookingFieldView, BookingFlowActionResult, BookingFlowFeedback, BookingFlowStatus, BookingFlowStep, BookingFlowStepId, BookingFlowView, BookingResourceView, BookingSlotSelection, BookingSlotView, BookingSubmitActionResult, BookingSubmitOptions, BookingValidationErrors, DerivedBookingFlowSteps, DeriveBookingFlowStepsInput, LoadState, } from "../nodes/booking-form.headless.state";
+export type { AppointmentBookingOverrideData, AppointmentBookingOverrideInput, AppointmentBookingOverrideInputResult, AppointmentBookingOverridePropsLike, BookingAvailabilityQuery, BookingAppointmentPackagesModel, BookingAppointmentPackagesUnavailableReason, BookingFieldId, BookingFieldValue, BookingFieldView, BookingFlowActionResult, BookingFlowFeedback, BookingFlowStatus, BookingFlowStep, BookingFlowStepId, BookingFlowView, BookingResourceView, BookingSlotDisplayOption, BookingSlotSelection, BookingSlotView, BookingSubmitActionResult, BookingSubmitOptions, BookingValidationErrors, DerivedBookingFlowSteps, DeriveBookingFlowStepsInput, LoadState, } from "../nodes/booking-form.headless.state";

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.headless.state.d.ts

@@ -47,6 +47,13 @@ export type BookingSlotSelection = Readonly<{
     resourceName?: string;
     label?: string;
 }>;
+export type BookingSlotDisplayOption = Readonly<{
+    key: string;
+    startAt: string;
+    endAt: string;
+    resourceId: AppointmentResourceId;
+    slot: BookingSlotView;
+}>;
 export type BookingResourceView = Readonly<{
     id: AppointmentResourceId;
     label: string;
@@ -429,6 +436,10 @@ export declare function resolveAvailabilitySelectionInvalidation(input: Readonly
 }>): AvailabilitySelectionInvalidation;
 export declare function toBookingSlotView(slot: BookingSlotSelection): BookingSlotView;
 export declare function toBookingSlotViews(slots: readonly TimeSlot[]): BookingSlotView[];
+export declare function deriveBookingSlotDisplayOptions(input: Readonly<{
+    slots: readonly BookingSlotView[];
+    hasSelectedResource: boolean;
+}>): BookingSlotDisplayOption[];
 export declare function toBookingFormData(state: BookingFlowReducerState): BookingFormData;
 export declare function buildBookingStepPlan(input: BuildBookingStepPlanInput): readonly BookingStepPlanItem[];
 export declare function validateBookingStep(input: Readonly<{

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

@@ -1,6 +1,8 @@
 /**
  * Step indicator component for the event registration wizard.
- * Thin wrapper around the shared StepIndicator with 'er' class prefix.
+ * Thin wrapper around the shared StepIndicator: styled by the shared
+ * registration-surface classes, with 'er'-prefixed classes kept in the
+ * markup as the stable hook surface for per-site theme CSS.
  */
 import { type StepIndicatorBaseProps } from '../../shared';
 export declare function StepIndicator(props: StepIndicatorBaseProps): import("react").JSX.Element;

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

@@ -5,10 +5,11 @@ export type FeedbackMessageProps = Readonly<{
     tone: FeedbackTone;
     children: ReactNode;
     className?: string;
+    id?: string;
     title?: ReactNode;
     titleClassName?: string;
     bodyClassName?: string;
     role?: 'alert' | 'status';
     live?: FeedbackLiveMode;
 }>;
-export declare function FeedbackMessage({ tone, children, className, title, titleClassName, bodyClassName, role, live, }: FeedbackMessageProps): import("react").JSX.Element;
+export declare function FeedbackMessage({ tone, children, className, id, title, titleClassName, bodyClassName, role, live, }: FeedbackMessageProps): import("react").JSX.Element;

package/dist/_dts/blocks/src/system/runtime/{nodes/event-registration → shared/components}/SelectableOptionCard.d.ts

@@ -1,5 +1,15 @@
 import React from 'react';
-type SelectableOptionCardProps = {
+/**
+ * Class-name preset applying the shared registration-surface option-card
+ * styling (`registration-surface.css`). Spread these and supply the
+ * block-specific content class names (icon/label/detail) alongside.
+ */
+export declare const RB_OPTION_CARD_CLASSES: {
+    readonly baseClassName: "rb-option-card";
+    readonly selectedClassName: "rb-option-card--selected";
+    readonly disabledClassName: "rb-option-card--disabled";
+};
+export type SelectableOptionCardProps = {
     baseClassName: string;
     selectedClassName: string;
     disabledClassName: string;
@@ -18,4 +28,3 @@ type SelectableOptionCardProps = {
     renderDisabledTooltip?: (tooltip: string) => React.ReactNode;
 };
 export declare function SelectableOptionCard(props: SelectableOptionCardProps): React.JSX.Element;
-export {};

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

@@ -2,10 +2,19 @@
  * Shared step indicator component for registration wizards.
  * Shows numbered steps with current progress and completion state.
  *
- * Supports both course-registration (cr-*) and event-registration (er-*) class prefixes.
+ * 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.
+ *
+ * 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.
  */
 /**
- * Base props for StepIndicator wrappers (without classPrefix).
+ * Base props for StepIndicator wrappers (without class channel config).
  * Use this type when creating block-specific thin wrappers.
  */
 export type StepIndicatorBaseProps = {
@@ -20,7 +29,9 @@ export type StepIndicatorBaseProps = {
  * Full props for the shared StepIndicator component.
  */
 export type StepIndicatorProps = StepIndicatorBaseProps & {
-    /** CSS class prefix (e.g., 'cr' or 'er') */
-    classPrefix: string;
+    /** Block-prefixed class channel (e.g. 'cr' or 'er'); kept as a theme-CSS hook */
+    classPrefix?: string;
+    /** Also emit the shared registration-surface `rb-*` classes */
+    emitSharedClasses?: boolean;
 };
-export declare function StepIndicator({ currentStep, totalSteps, stepLabels, classPrefix, }: StepIndicatorProps): import("react").JSX.Element;
+export declare function StepIndicator({ currentStep, totalSteps, stepLabels, classPrefix, emitSharedClasses, }: StepIndicatorProps): import("react").JSX.Element;

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

@@ -27,3 +27,5 @@ 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';

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, BookingOptionCompactRow, BookingOptionList, CheckIcon, ClockIcon, CrossIcon, BLOCK_DISCOUNT_CODE_DISCLOSURE_CLASSES, DiscountCodeDisclosure, FieldValidationMessage, FeedbackMessage, getFieldValidationControlProps, MembershipHero, ModalShell, StateIcon, StepIndicator, TerminalPanel, } from './components';
-export type { ActionRowProps, BookingOptionCompactRowAction, BookingOptionCompactRowProps, BookingOptionCompactRowViewModel, BookingOptionGroupViewModel, BookingOptionListProps, BookingOptionMetaItem, DiscountCodeDisclosureProps, DiscountCodeDisclosureSurface, FieldValidationControlInput, FieldValidationControlProps, FieldValidationMessageProps, FeedbackLiveMode, FeedbackMessageProps, FeedbackTone, ModalShellProps, StepIndicatorBaseProps, StepIndicatorProps, TerminalPanelProps, TerminalPanelTitleElement, } from './components';
+export { ActionRow, BookingOptionCompactRow, BookingOptionList, 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, BookingOptionCompactRowAction, BookingOptionCompactRowProps, BookingOptionCompactRowViewModel, BookingOptionGroupViewModel, BookingOptionListProps, BookingOptionMetaItem, DiscountCodeDisclosureProps, DiscountCodeDisclosureSurface, FieldValidationControlInput, FieldValidationControlProps, FieldValidationMessageProps, FeedbackLiveMode, FeedbackMessageProps, FeedbackTone, ModalShellProps, StepIndicatorBaseProps, StepIndicatorProps, TerminalPanelProps, TerminalPanelTitleElement, } from './components';

package/dist/_dts/blocks/src/utils/date-formatting.d.ts

@@ -24,9 +24,25 @@ export declare function generateDateRange(days: number, from?: Date): string[];
  * @returns Formatted date (e.g., "Friday, March 15, 2025")
  */
 export declare function formatDate(dateStr: string): string;
+/**
+ * Formats an ISO date string (YYYY-MM-DD) into the compact parts shown on a
+ * booking date pill (e.g. { weekday: "Fri", day: "15", month: "Mar" }).
+ * Use formatDate() for the full accessible name.
+ */
+export declare function formatDatePillParts(dateStr: string): Readonly<{
+    weekday: string;
+    day: string;
+    month: string;
+}>;
+/**
+ * Formats an ISO datetime string to a compact time without the timezone
+ * suffix (e.g. "2:30 PM") — used on booking time pills where the timezone is
+ * announced once for the whole group. Use formatTime() for the full form.
+ */
+export declare function formatTimeShort(isoString: string, timeZone?: string): string;
 /**
  * Formats an ISO datetime string to a human-readable time
  * @param isoString - ISO datetime string (e.g., "2025-03-15T14:30:00Z")
  * @returns Formatted time (e.g., "2:30 PM EST")
  */
-export declare function formatTime(isoString: string): string;
+export declare function formatTime(isoString: string, timeZone?: string): string;