@riverbankcms/sdk 0.149.0 → 0.150.0

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

@@ -52,7 +52,9 @@ export * from './settlement';
 export * from './shopRefundPlanning';
 export * from './stripeMinimumCharge';
 export * from './stripeCheckoutReturnUrl';
+export * from './checkoutCopy';
 export * from './stateTransitions';
 export * from './event-registration-errors';
 export * from './eventCheckoutRecoveryWindow';
 export { STRIPE_COMMISSION_FREE_REASONS, type StripeCommissionFreeReason, } from './stripeCommissionMetadata';
+export * from './checkoutPresentation';

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

@@ -150,6 +150,7 @@ export type MembershipBundleFulfillmentMetadata = Readonly<{
     membershipName: string;
 }>;
 export type MembershipOrderItemMetadata = CheckoutLineMetadata & StripeBookingCommissionOrderItemMetadata & Readonly<{
+    /** Written by checkout; identifies a standalone purchase. Older rows and renewals lack it. */
     membershipId?: MembershipId;
     billingInterval?: 'month' | 'year';
     bundleFulfillment?: MembershipBundleFulfillmentMetadata;

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

@@ -1,8 +1,15 @@
+import type { CheckoutPresentation } from './checkoutPresentation';
 export declare const STRIPE_CHECKOUT_SESSION_ID_PLACEHOLDER = "{CHECKOUT_SESSION_ID}";
 /**
- * Completes a Stripe success URL with the session correlation parameter.
+ * Completes a Stripe return URL with the session correlation parameter.
  *
  * URL owns the query/fragment boundary so the parameter can never be appended
  * inside a hash fragment. Stripe requires its placeholder to remain literal.
  */
-export declare function ensureStripeCheckoutSessionIdInSuccessUrl(successUrl: string): string;
+export declare function ensureStripeCheckoutSessionIdInReturnUrl(returnUrl: string): string;
+/**
+ * The page Stripe returns a completed session to: the checkout's own success
+ * (hosted) or return (embedded) URL, with the session filled in where Stripe
+ * would have put it.
+ */
+export declare function completedStripeCheckoutReturnUrl(presentation: CheckoutPresentation, sessionId: string): string;

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

@@ -1,3 +1,4 @@
+import type { CheckoutMode, CheckoutPresentation } from './checkoutPresentation';
 /**
  * Purchase domain types — the unified model for all customer acquisitions.
  *
@@ -62,24 +63,22 @@ export type AttendeeInfo = Readonly<{
 }>;
 export type AttendeeBearingCheckoutItem = EventTicketItem | EventSeriesRegistrationItem;
 export type Checkout = CartCheckout | MembershipCheckout;
-export type CartCheckout = {
+export type CartCheckout<M extends CheckoutMode = CheckoutMode> = {
     mode: 'one_time';
     siteId: SiteId;
     items: NonEmptyArray<CheckoutItem>;
     customer: CustomerInfo;
     discountCode?: string;
     collectionOptionKind?: BookingPaymentCollectionOptionKind;
-    successUrl: string;
-    cancelUrl: string;
+    presentation: CheckoutPresentation<M>;
 };
-export type MembershipCheckout = {
+export type MembershipCheckout<M extends CheckoutMode = CheckoutMode> = {
     mode: 'subscription';
     siteId: SiteId;
     membership: MembershipItem;
     customer: CustomerInfo;
     discountCode?: string;
-    successUrl: string;
-    cancelUrl: string;
+    presentation: CheckoutPresentation<M>;
 };
 export type CustomerInfo = {
     email: string;

package/dist/_dts/content-editor/src/FooterComposerOverview.d.ts

@@ -1,5 +1,5 @@
 import { type FooterCompositionV1, type FooterNavigationLayout } from '../../core/src/index';
-import type { FooterRuntimeViewModel } from '../../blocks/src/client/site-chrome';
+import type { FooterAttribution, FooterRuntimeViewModel } from '../../blocks/src/client/site-chrome';
 import { type FooterEditorTarget, type planFooterEditorView } from './footerComposer';
 import type { SaveState } from './useFooterComposerState';
 type FooterPlan = ReturnType<typeof planFooterEditorView>;
@@ -9,7 +9,8 @@ export declare function SaveBadge({ state }: {
 export declare function FooterPreview({ runtime, }: {
     runtime: FooterRuntimeViewModel;
 }): import("react").JSX.Element;
-export declare function FooterOverview({ plan, composition, onTarget, onChange, manageLinksHref, manageSettingsHref, navigationLayout, onEngagement, onNavigationLayoutChange, }: {
+export declare function FooterOverview({ attribution, plan, composition, onTarget, onChange, manageLinksHref, manageSettingsHref, navigationLayout, onEngagement, onNavigationLayoutChange, }: {
+    attribution: FooterAttribution | null;
     plan: FooterPlan;
     composition: FooterCompositionV1;
     onTarget: (target: FooterEditorTarget) => void;

package/dist/_dts/content-editor/src/footerPreviewRuntime.d.ts

@@ -1,4 +1,4 @@
-import { type FooterResolvedEngagement, type FooterRuntimeViewModel } from '../../blocks/src/client/site-chrome';
+import { type FooterAttribution, type FooterResolvedEngagement, type FooterRuntimeViewModel } from '../../blocks/src/client/site-chrome';
 import type { FooterCompositionV1, FooterNavigationLayout, PublicProfile } from '../../core/src/index';
 export type FooterPreviewRuntimeInput = Readonly<{
     composition: FooterCompositionV1;
@@ -10,5 +10,10 @@ export type FooterPreviewRuntimeInput = Readonly<{
     legalRegion: 'integrated' | 'separate';
     navigationLayout: FooterNavigationLayout;
     engagement: FooterResolvedEngagement;
+    /**
+     * The plan's attribution line, from the composition read. The preview adds
+     * it the same way the served footer does, so the two match.
+     */
+    attribution: FooterAttribution | null;
 }>;
 export declare function buildFooterPreviewRuntime(input: FooterPreviewRuntimeInput): FooterRuntimeViewModel;

package/dist/_dts/content-editor/src/useFooterComposerState.d.ts

@@ -29,6 +29,13 @@ export declare function useFooterComposerState({ apiClient, canEdit, initialTarg
     siteId: import("../../core/src/index").SiteId;
     target: FooterEditorTarget;
     setTarget: import("react").Dispatch<import("react").SetStateAction<FooterEditorTarget>>;
+    attribution: Readonly<{
+        lead: string;
+        link: Readonly<{
+            href: string;
+            label: string;
+        }>;
+    }> | null;
     compositionSnapshot: FooterCompositionSnapshot | null;
     engagementOptions: Readonly<{
         forms: readonly import("../../api/src/footerSettings").FooterFormSummary[];

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

@@ -85,3 +85,4 @@ export * from './navigation-locations';
 export * from './navigation-portal-labels';
 export * from './event-preset-vocabulary';
 export * from './event-catalogue';
+export * from './patch';

package/dist/_dts/core/src/patch/index.d.ts

@@ -0,0 +1,30 @@
+import type { Result } from '../result';
+export type Settable<T> = Readonly<{
+    kind: 'keep';
+}> | Readonly<{
+    kind: 'set';
+    value: T;
+}>;
+export type Clearable<T> = Settable<T> | Readonly<{
+    kind: 'clear';
+}>;
+/** Lists and documents use Settable too: a supplied value replaces the whole value. */
+export type ChangesWire<T extends Readonly<Record<string, Settable<unknown> | Clearable<unknown>>>> = {
+    readonly [K in keyof T]?: Extract<T[K], {
+        kind: 'set';
+    }>['value'] | (Extract<T[K], {
+        kind: 'clear';
+    }> extends never ? never : null);
+};
+export declare function settableFrom<T>(wireValue: T | undefined): Settable<T>;
+export declare function clearableFrom<T>(wireValue: T | null | undefined): Clearable<T>;
+export declare function applySettable<T>(stored: T, change: Settable<T>): T;
+export declare function applyClearable<T>(stored: T | null, change: Clearable<T>): T | null;
+export type ProtectedBagKeys<K extends string> = Readonly<{
+    kind: 'protected-keys';
+    keys: readonly K[];
+}>;
+/** A null deletes a key; protected keys are refused even when their value agrees. */
+export declare function mergeBag<T, K extends string>(stored: Readonly<Record<string, T>>, patch: Readonly<Record<string, T | null | undefined>>, options: Readonly<{
+    protectedKeys: readonly K[];
+}>): Readonly<Result<Readonly<Record<string, T>>, ProtectedBagKeys<K>>>;

package/dist/_dts/db/src/generated/supabase/database.types.d.ts

@@ -2447,6 +2447,7 @@ export type Database = {
                     event_series_registration_id: string | null;
                     expires_at: string;
                     id: string;
+                    order_id: string | null;
                     released_at: string | null;
                     site_id: string;
                     status: string;
@@ -2464,6 +2465,7 @@ export type Database = {
                     event_series_registration_id?: string | null;
                     expires_at: string;
                     id?: string;
+                    order_id?: string | null;
                     released_at?: string | null;
                     site_id: string;
                     status?: string;
@@ -2481,6 +2483,7 @@ export type Database = {
                     event_series_registration_id?: string | null;
                     expires_at?: string;
                     id?: string;
+                    order_id?: string | null;
                     released_at?: string | null;
                     site_id?: string;
                     status?: string;
@@ -2536,6 +2539,13 @@ export type Database = {
                         referencedRelation: "event_series_registrations";
                         referencedColumns: ["id"];
                     },
+                    {
+                        foreignKeyName: "booking_customer_credit_reservations_order_id_fkey";
+                        columns: ["order_id"];
+                        isOneToOne: false;
+                        referencedRelation: "orders";
+                        referencedColumns: ["id"];
+                    },
                     {
                         foreignKeyName: "booking_customer_credit_reservations_site_id_fkey";
                         columns: ["site_id"];
@@ -18092,7 +18102,10 @@ export type Database = {
                     p_command: string;
                     p_order_id: string;
                 };
-                Returns: string;
+                Returns: {
+                    operation_id: string;
+                    outcome: string;
+                }[];
             };
             accept_site_invitation: {
                 Args: {
@@ -19321,6 +19334,7 @@ export type Database = {
             consume_booking_customer_credit_reservation: {
                 Args: {
                     p_booking_payment_id?: string;
+                    p_order_id: string;
                     p_reference_id?: string;
                     p_reference_type?: string;
                     p_reservation_id: string;
@@ -20695,6 +20709,14 @@ export type Database = {
                 };
                 Returns: string;
             };
+            open_standalone_membership_order_v1: {
+                Args: {
+                    p_customer_id: string;
+                    p_membership_id: string;
+                    p_site_id: string;
+                };
+                Returns: string;
+            };
             ops_update_event_attendee_checkin: {
                 Args: {
                     p_attendee_id: string;
@@ -20789,6 +20811,7 @@ export type Database = {
                     p_order_number_seq: number;
                     p_paid_cents: number;
                     p_payment_method: string;
+                    p_reservations?: Json;
                     p_site_id: string;
                     p_status: string;
                     p_stripe_account_id: string;
@@ -21072,6 +21095,12 @@ export type Database = {
                 };
                 Returns: boolean;
             };
+            release_order_checkout_reservations_v1: {
+                Args: {
+                    p_order_id: string;
+                };
+                Returns: undefined;
+            };
             release_site_invitation_resend_claim: {
                 Args: {
                     p_actor_user_id: string;

package/dist/_dts/sdk/src/bookings/index.d.ts

@@ -35,4 +35,5 @@ export declare const HeadlessBookingPaymentSelectionStep: React.FC<HeadlessBooki
 export { BOOKING_FORM_DATA_RESERVED_KEY_VALUES } from '../../../blocks/src/client';
 export { HeadlessBookingAltchaWidget, HeadlessEventRegistrationAltchaWidget, createBookingBlockApiConfig, createEventRegistrationBlockApiConfig, getAppointmentBookingOverrideInput, getEventRegistrationOverrideInput, useHeadlessBookingFlow, useHeadlessEventRegistrationFlow, };
 export type { BookingService, BookingFormConfig } from './types';
-export type { Service, TimeSlot, BookingFormSettings, BookingFormSchema, BookingFormField, BookingFormData, BookingSelectedCollectionOptionKind, BookingSubmissionData, BookingSubmissionResult, BookingFormClientProps, BookingFormClientForm, BookingFormClientService, HeadlessBookingPaymentSelectionStepProps, HeadlessBookingFlow, HeadlessBookingFlowOptions, HeadlessBookingProviderProps, HeadlessEventRegistrationFlow, HeadlessEventRegistrationFlowOptions, HeadlessEventRegistrationProviderProps, EventRegistrationAttendeeModel, EventRegistrationDiscountModel, EventRegistrationEventsModel, EventRegistrationFlowActionResult, EventRegistrationFlowActions, EventRegistrationFlowStatus, EventRegistrationFlowStep, EventRegistrationFlowStepId, EventRegistrationFlowView, EventRegistrationGuestsModel, EventRegistrationLoadState, EventRegistrationOverrideData, EventRegistrationOverrideInput, EventRegistrationOverrideInputResult, EventRegistrationOverridePropsLike, EventRegistrationPaymentModel, EventRegistrationPaymentSelection, EventRegistrationPortalAuthModel, EventRegistrationSpamProtectionModel, EventRegistrationSubmitOptions, EventRegistrationSubmitResult, EventRegistrationTerminalModel, EventRegistrationTicketsModel, AppointmentBookingOverrideData, AppointmentBookingOverrideInput, AppointmentBookingOverrideInputResult, BookingAvailabilityQuery, BookingAppointmentPackagesModel, BookingAppointmentPackagesUnavailableReason, BookingPaymentOptionViewModel, BookingPaymentSelectionViewModel, BookingFieldValue, BookingFieldView, BookingFlowActionResult, BookingFlowFeedback, BookingFlowStatus, BookingResourceView, BookingResourcesModel, BookingFlowStep, BookingFlowStepId, BookingFlowView, BookingSlotView, BookingSubmitActionResult, BookingSubmitOptions, BookingValidationErrors, DerivedBookingFlowSteps, DeriveBookingFlowStepsInput, UseBookingFormConfigResult, } from './types';
+export type { Service, TimeSlot, BookingFormSettings, BookingFormSchema, BookingFormField, BookingFormData, BookingSelectedCollectionOptionKind, BookingSubmissionData, BookingSubmissionResult, BookingFormClientProps, BookingFormClientForm, BookingFormClientService, HeadlessBookingPaymentSelectionStepProps, HeadlessBookingFlow, HeadlessBookingFlowOptions, HeadlessBookingProviderProps, HeadlessEventRegistrationFlow, HeadlessEventRegistrationFlowOptions, HeadlessEventRegistrationProviderProps, EventRegistrationAttendeeModel, EventRegistrationDiscountModel, EventRegistrationEventsModel, EventRegistrationFlowActionResult, EventRegistrationFlowActions, EventRegistrationFlowStatus, EventRegistrationFlowStep, EventRegistrationFlowStepId, EventRegistrationFlowView, EventRegistrationGuestsModel, EventRegistrationLoadState, EventRegistrationOverrideData, EventRegistrationOverrideInput, EventRegistrationOverrideInputResult, EventRegistrationOverridePropsLike, EventRegistrationPaymentModel, EventRegistrationPaymentSelection, EventRegistrationPortalAuthModel, EventRegistrationSpamProtectionModel, EventRegistrationSubmitResult, EventRegistrationTerminalModel, EventRegistrationTicketsModel, AppointmentBookingOverrideData, AppointmentBookingOverrideInput, AppointmentBookingOverrideInputResult, BookingAvailabilityQuery, BookingAppointmentPackagesModel, BookingAppointmentPackagesUnavailableReason, BookingPaymentOptionViewModel, BookingPaymentSelectionViewModel, BookingFieldValue, BookingFieldView, BookingFlowActionResult, BookingFlowFeedback, BookingFlowStatus, BookingResourceView, BookingResourcesModel, BookingFlowStep, BookingFlowStepId, BookingFlowView, BookingSlotView, BookingSubmitActionResult, BookingSubmitOptions, BookingValidationErrors, DerivedBookingFlowSteps, DeriveBookingFlowStepsInput, UseBookingFormConfigResult, } from './types';
+export { EventRegistrationPayment } from '../../../blocks/src/client';

package/dist/_dts/sdk/src/bookings/types.d.ts

@@ -8,7 +8,7 @@
  * responses.
  */
 import type { BookingFlexibleBalanceConfig, BookingInstalmentPlanConfig } from '../../../core/src/index';
-export type { AppointmentBookingOverrideData, AppointmentBookingOverrideInput, AppointmentBookingOverrideInputResult, BookingAvailabilityQuery, BookingAppointmentPackagesModel, BookingAppointmentPackagesUnavailableReason, BookingPaymentOptionViewModel, BookingPaymentSelectionViewModel, BookingFieldValue, BookingFieldView, BookingFlowActionResult, BookingFlowFeedback, BookingFlowStatus, BookingResourceView, BookingFlowStep, BookingFlowStepId, BookingFlowView, BookingResourcesModel, BookingSlotView, BookingSubmitActionResult, BookingSubmitOptions, BookingValidationErrors, DerivedBookingFlowSteps, DeriveBookingFlowStepsInput, EventRegistrationAttendeeModel, EventRegistrationDiscountModel, EventRegistrationEventsModel, EventRegistrationFlowActionResult, EventRegistrationFlowActions, EventRegistrationFlowStatus, EventRegistrationFlowStep, EventRegistrationFlowStepId, EventRegistrationFlowView, EventRegistrationGuestsModel, EventRegistrationLoadState, EventRegistrationOverrideData, EventRegistrationOverrideInput, EventRegistrationOverrideInputResult, EventRegistrationOverridePropsLike, EventRegistrationPaymentModel, EventRegistrationPaymentSelection, EventRegistrationPortalAuthModel, EventRegistrationSpamProtectionModel, EventRegistrationSubmitOptions, EventRegistrationSubmitResult, EventRegistrationTerminalModel, EventRegistrationTicketsModel, HeadlessBookingFlow, HeadlessBookingFlowOptions, HeadlessBookingPaymentSelectionStepProps, HeadlessBookingProviderProps, HeadlessEventRegistrationFlow, HeadlessEventRegistrationFlowOptions, HeadlessEventRegistrationProviderProps, } from '../../../blocks/src/client';
+export type { AppointmentBookingOverrideData, AppointmentBookingOverrideInput, AppointmentBookingOverrideInputResult, BookingAvailabilityQuery, BookingAppointmentPackagesModel, BookingAppointmentPackagesUnavailableReason, BookingPaymentOptionViewModel, BookingPaymentSelectionViewModel, BookingFieldValue, BookingFieldView, BookingFlowActionResult, BookingFlowFeedback, BookingFlowStatus, BookingResourceView, BookingFlowStep, BookingFlowStepId, BookingFlowView, BookingResourcesModel, BookingSlotView, BookingSubmitActionResult, BookingSubmitOptions, BookingValidationErrors, DerivedBookingFlowSteps, DeriveBookingFlowStepsInput, EventRegistrationAttendeeModel, EventRegistrationDiscountModel, EventRegistrationEventsModel, EventRegistrationFlowActionResult, EventRegistrationFlowActions, EventRegistrationFlowStatus, EventRegistrationFlowStep, EventRegistrationFlowStepId, EventRegistrationFlowView, EventRegistrationGuestsModel, EventRegistrationLoadState, EventRegistrationOverrideData, EventRegistrationOverrideInput, EventRegistrationOverrideInputResult, EventRegistrationOverridePropsLike, EventRegistrationPaymentModel, EventRegistrationPaymentSelection, EventRegistrationPortalAuthModel, EventRegistrationSpamProtectionModel, EventRegistrationSubmitResult, EventRegistrationTerminalModel, EventRegistrationTicketsModel, HeadlessBookingFlow, HeadlessBookingFlowOptions, HeadlessBookingPaymentSelectionStepProps, HeadlessBookingProviderProps, HeadlessEventRegistrationFlow, HeadlessEventRegistrationFlowOptions, HeadlessEventRegistrationProviderProps, } from '../../../blocks/src/client';
 import type { BookingFormData as BlocksBookingFormData, BookingFormField as BlocksBookingFormField, BookingFormClientProps as BlocksBookingFormClientProps, BookingFormConfig as BlocksBookingFormConfig, BookingService as BlocksBookingService } from '../../../blocks/src/client';
 export type { BookingSelectedCollectionOptionKind } from '../../../blocks/src/client';
 export { BOOKING_FORM_DATA_RESERVED_KEY_VALUES } from '../../../blocks/src/client';

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.149.0";
+export declare const SDK_VERSION = "0.150.0";

package/dist/_dts/theme-core/src/blocks/index.d.ts

@@ -18,4 +18,5 @@
  */
 export type { BlockVarGeneratorTheme, BlockVarGeneratorContext, BlockVarGenerator, BlockVarRegistry, BlockCustomVars, } from './types';
 export { registerBlockVarGenerator, getBlockVarGenerator, generateAllBlockVarsCss, generateBlockCustomVarsCss, } from './registry';
+export { opaquePanels, generateOpaquePanelCss, type OpaquePanel } from './opaquePanels';
 export * from './vars';

package/dist/_dts/theme-core/src/blocks/opaquePanels.d.ts

@@ -0,0 +1,147 @@
+import { type OpaqueSurfaceContext } from '../surfaces/opaqueSurface';
+/**
+ * Every element in `blocks-static/` CSS that paints its own background behind
+ * text or buttons, with the palette token it paints.
+ *
+ * The CSS owns layout and the paint itself; this registry owns what the paint
+ * implies. `generateOpaquePanelCss` publishes each panel's foreground contract
+ * and button context from the theme, exactly as card roles and section
+ * backgrounds do, so a white panel inside a dark band never inherits the band's
+ * light text or its band-resolved buttons. `opaquePanels.test.ts` scans the
+ * static CSS and fails when a rule paints a surface token without an entry
+ * here, or when a registered rule declares the contract by hand.
+ *
+ * Selectors are written without the theme-scope prefix; the generator adds it.
+ * A `transparent` entry is a treatment that turns a surface-owning class into
+ * a boxless row, so it hands the surrounding surface's contract back.
+ */
+export declare const opaquePanels: readonly [{
+    readonly selector: ":where([data-block=\"event-registration\"], [data-block=\"appointment-booking\"]) .rb-reg-surface";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surface";
+    };
+}, {
+    readonly selector: ":where([data-block='event-registration']) .er-booking-teaser";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surface";
+    };
+}, {
+    readonly selector: ":where([data-block='event-registration']) .er-booking-bar";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "background";
+    };
+}, {
+    readonly selector: ":where([data-block='event-registration']) .er-modal";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "background";
+    };
+}, {
+    readonly selector: ":where([data-block='event-registration']) .er-booking-overlay__panel";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "background";
+    };
+}, {
+    readonly selector: ":where([data-block='event-calendar']) .event-agenda-card";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surface";
+    };
+}, {
+    readonly selector: ":where([data-block='event-calendar']) .event-timetable-event";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surface";
+    };
+}, {
+    readonly selector: ":where([data-block='event-calendar']) .event-week-board";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surface";
+    };
+}, {
+    readonly selector: ":where([data-block='event-calendar']) .event-week-board-top";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surfaceAlt";
+    };
+}, {
+    readonly selector: ":where([data-block='event-calendar']) .event-week-board-foot";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surfaceAlt";
+    };
+}, {
+    readonly selector: ":where([data-block='event-calendar']) .ec-modal";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surface";
+    };
+}, {
+    readonly selector: ".event-listing-compact-container";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surface";
+    };
+}, {
+    readonly selector: ".shop__card";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surface";
+    };
+}, {
+    readonly selector: ".shop--register .shop__card";
+    readonly paint: {
+        readonly kind: "transparent";
+    };
+}, {
+    readonly selector: ":where([data-block=\"shop\"]) .shop__return";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surface";
+    };
+}, {
+    readonly selector: "[data-block=\"feature-cards\"][data-block-composition=\"asymmetric-emphasis\"] .rb-feature-card:nth-child(even)";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "secondary";
+    };
+}, {
+    readonly selector: ".rb-feature-cards-grid--editorial-diptych .rb-feature-card[data-surface-role=\"panel\"]";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "primary";
+    };
+}, {
+    readonly selector: ":is(.rb-event-list-treatment-ruled-register, .rb-event-list-treatment-editorial-register, .rb-event-list-treatment-dense-index) .event-card.event-card";
+    readonly paint: {
+        readonly kind: "transparent";
+    };
+}, {
+    readonly selector: ".feedback-callout";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surface";
+    };
+}, {
+    readonly selector: "[data-block=\"gifting\"] .gifting-feedback";
+    readonly paint: {
+        readonly kind: "solid";
+        readonly token: "surface";
+    };
+}];
+export type OpaquePanel = (typeof opaquePanels)[number];
+/**
+ * Publishes every registered panel's surface contract. Emitted after the card
+ * CSS in both the theme runtime and the SDK theme bridge, so a composition
+ * that recolours a card role (the feature-card diptych panel) or a treatment
+ * that empties one (the event registers) wins over the role's own contract.
+ */
+export declare function generateOpaquePanelCss(input: Readonly<{
+    themeId: string;
+    surface: OpaqueSurfaceContext;
+}>): string;

package/dist/_dts/theme-core/src/boxBackgroundSchema.d.ts

@@ -18,6 +18,17 @@ export declare const boxBackgroundSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     supportingColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     type: z.ZodLiteral<"color">;
     color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    mediaScrim: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        opacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"gradient">;
+        gradient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        opacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>], "type">>>>;
 }, z.core.$strip>, z.ZodObject<{
     contentOwner: z.ZodOptional<z.ZodLiteral<"page-design-editor">>;
     textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -27,6 +38,17 @@ export declare const boxBackgroundSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"gradient">;
     gradient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     gradientPresetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    mediaScrim: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        opacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"gradient">;
+        gradient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        opacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>], "type">>>>;
 }, z.core.$strip>, z.ZodObject<{
     contentOwner: z.ZodOptional<z.ZodLiteral<"page-design-editor">>;
     textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/_dts/theme-core/src/buttons/buttonSurfaceContext.d.ts

@@ -62,6 +62,28 @@ export type ContextualButtonResolution = Readonly<{
  * Images, gradients, alpha/composite layers and arbitrary CSS remain unknown.
  */
 export declare function deriveButtonSurfaceContext(input: ButtonSurfaceInput, palette: Readonly<Record<string, string>>, fallbackToken?: string): ButtonSurfaceContext;
+/**
+ * The complete button context a surface publishes: `--rb-action-*` variables
+ * for every role, resolved against the surface when its colour is provable,
+ * and an explicit reset when it is not (image, gradient, composited), so a
+ * nested surface never inherits a context resolved for an outer band.
+ * A surface with no background of its own publishes nothing and inherits.
+ *
+ * Sections (through the blocks background transforms), card roles and opaque
+ * block panels all publish through this one function.
+ */
+export declare function surfaceButtonContextStyles(input: Readonly<{
+    surface: ButtonSurfaceInput;
+    palette: ButtonColourPalette;
+    buttonSystem: ButtonSystem | undefined;
+    fallbackToken?: string;
+}>): Readonly<Record<string, string>>;
+/** Every role's contextual styles against one proven solid surface. */
+export declare function knownSurfaceButtonContextStyles(input: Readonly<{
+    surface: KnownButtonSurface;
+    palette: ButtonColourPalette;
+    buttonSystem: ButtonSystem;
+}>): Readonly<Record<string, string>>;
 export declare function resolveContextualButtonRole(input: Readonly<{
     role: VariantRole;
     buttonSystem: ButtonSystem;

package/dist/_dts/theme-core/src/cards/roles.d.ts

@@ -20,6 +20,18 @@ export type ResolvedCardSurface = {
     variant: CardVariant;
     source: CardSurfaceSource;
 };
+/**
+ * Whether a card system gives `role` a surface of its own, rather than one
+ * borrowed through the fallback chain below.
+ *
+ * `none` asks for no surface and `default` is every card system's everyday
+ * card (the generated baseline stands in for it by design), so both always
+ * hold. `alternative` and `open` hold only when the site style declares an
+ * enabled variant for them: otherwise `alternative` quietly renders the
+ * default card and `open` the generated baseline, and a Look asking for either
+ * would look like some other Look. Look availability is derived from this.
+ */
+export declare function cardSystemDefinesRole(cardSystem: CardSystem | null, role: CardRole): boolean;
 /**
  * Resolve a card role against a site style's card system.
  *