@riverbankcms/sdk 0.148.0 → 0.150.0

package/dist/_dts/media-editor/src/MediaPickerMiniDialog.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentType } from 'react';
+import type { MediaPickerMiniRenderProps } from '../../media-react/src/index';
+import { type MediaPickerDialogProps } from './MediaPickerDialog';
+type LibraryDialogKeys = 'open' | 'onOpenChange' | 'assets' | 'loading' | 'error' | 'retryLoad' | 'hasMore' | 'selectAsset' | 'loadMore' | 'enqueueUploads' | 'uploads';
+export type MediaPickerMiniDialogProps = Omit<MediaPickerDialogProps, LibraryDialogKeys> & {
+    picker: MediaPickerMiniRenderProps;
+    component?: ComponentType<MediaPickerDialogProps>;
+};
+export declare function MediaPickerMiniDialog({ picker, component: DialogComponent, ...props }: MediaPickerMiniDialogProps): import("react").JSX.Element;
+export {};

package/dist/_dts/media-editor/src/index.d.ts

@@ -1,6 +1,8 @@
 export { MediaEditor } from './MediaEditor';
 export type { MediaEditorProps } from './MediaEditor';
 export { MediaPickerDialog } from './MediaPickerDialog';
+export { MediaPickerMiniDialog } from './MediaPickerMiniDialog';
+export type { MediaPickerMiniDialogProps } from './MediaPickerMiniDialog';
 export type { MediaPickerAssetSelection, MediaPickerDialogProps, MediaPickerPolicy, } from './MediaPickerDialog';
 export { FileAssetPreview, classifyMimeForPreview } from './FileAssetPreview';
 export { CropDialog } from './CropDialog';

package/dist/_dts/preview-next/src/client/preview/PreviewEntryControllerProvider.d.ts

@@ -62,7 +62,6 @@ type PreviewEntryControllerProviderProps = {
  */
 export type PreviewLiveDrafts = Readonly<{
     client: LiveDraftsClient;
-    previewToken: string;
     refreshBaselines: () => void;
 }>;
 export declare function PreviewEntryControllerProvider({ children, siteId, pageId, pageNodeType, routeId: providedRouteId, entryData, contentTypeSchema, initialStatus, initialBlocks, blockFieldExtensions, pageMetadata, apiClient, subscribeToLeaseChanges, onLeaseGranted, liveDrafts, }: PreviewEntryControllerProviderProps): React.JSX.Element;

package/dist/_dts/preview-next/src/client/preview/PreviewShell.d.ts

@@ -33,7 +33,7 @@ type PreviewShellCommonProps = {
     subscribeToLeaseChanges?: EditLeaseChangeSubscription;
     onLeaseGranted?: () => void;
     /** Live drafts between tabs; the host supplies a Supabase client dedicated to the preview token. */
-    liveDrafts?: Omit<PreviewLiveDrafts, 'previewToken'> | null;
+    liveDrafts?: PreviewLiveDrafts | null;
     previewSession: PreviewRuntimeSession | null;
     previewToken: string;
     dashboardBaseUrl?: string | null;

package/dist/_dts/preview-next/src/client/previewAuthStore.d.ts

@@ -1,3 +1,4 @@
+import { type ApiClient } from "../../../api/src/request";
 import { type PreviewRuntimeSession, type PreviewSessionAuthMode } from "../auth-contract";
 export type PreviewAuthState = "ok" | "expired";
 export type PreviewAuthFailureSource = "keep-alive" | "inline-save" | "publish" | "block-editor" | "metadata" | "draft-action" | "query" | "unknown";
@@ -22,6 +23,8 @@ export declare function usePreviewAuth(): PreviewAuthSnapshot;
  * Returns null if no token is available (falls back to proxy).
  */
 export declare function usePreviewToken(): string | null;
+export declare function getPreviewAccessToken(): string;
+export declare function setPreviewAccessToken(token: string): void;
 type PreviewAuthInitInput = {
     siteId: string;
     siteSlug: string;
@@ -38,5 +41,9 @@ export declare function initPreviewAuth(input: PreviewAuthInitInput): void;
 export declare function __getPreviewAuthStateForTests(): Readonly<PreviewAuthSnapshot>;
 export declare function __resetPreviewAuthStateForTests(): void;
 export declare function markPreviewAuthExpired(source: PreviewAuthFailureSource): void;
+/** Handle bearer 401s at the request boundary, including calls outside the query cache. */
+export declare function createGuardedPreviewApiClient(baseUrl: string): ApiClient;
+/** Query callbacks receive the same error after the request guard has decided auth state. */
+export declare function wasPreviewApiAuthErrorHandled(error: unknown): boolean;
 export declare function usePreviewAuthFetch(baseFetch: BaseFetch): PreviewAuthFetch;
 export {};

package/dist/_dts/preview-next/src/constants.d.ts

@@ -3,3 +3,7 @@ export declare const PREVIEW_REFRESH_COOKIE_NAME = "preview_refresh_token";
 export declare const PREVIEW_COOKIE_MAX_AGE: number;
 export declare const PREVIEW_CODE_PARAM = "preview_code";
 export declare const PREVIEW_THEME_COOKIE_NAME = "preview_theme_id";
+export declare const PREVIEW_KEEP_ALIVE_INTERVAL_MS: number;
+export declare const PREVIEW_KEEP_ALIVE_JITTER_RATIO = 0.1;
+export declare const PREVIEW_KEEP_ALIVE_MAX_INTERVAL_MS: number;
+export declare const PREVIEW_REFRESH_THRESHOLD_SECONDS: number;

package/dist/_dts/preview-next/src/keepAlive.d.ts

@@ -1,6 +1,7 @@
 import type { CookieStoreLike } from './session';
 export type PreviewKeepAliveLogger = {
     debug?: (message: string, meta?: Record<string, unknown>) => void;
+    info?: (message: string, meta?: Record<string, unknown>) => void;
     warn?: (message: string, meta?: Record<string, unknown>) => void;
     error?: (message: string, meta?: Record<string, unknown>) => void;
 };

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/rendering/islands/types.d.ts

@@ -1,6 +1,6 @@
 import type { ButtonVariant as SystemButtonVariant, EventScheduleScope as SystemEventScheduleScope, EventSurfacePreset as SystemEventSurfacePreset, RichTextDoc as SystemRichTextDoc } from '../../contracts/system-block-content';
 import type { PublicTeamMemberSummary } from '../../../../api/src/index';
-import type { BookingFlexibleBalanceConfig, BookingInstalmentPlanConfig, LocationCoordinates, PublicEventPriceDisplay, PublicEventPricing, PublicEventPricingOption, PublicEventPricingOptionAvailability, PublicEventPricingType } from '../../../../core/src/index';
+import type { BookingPaymentCollectionOption, LocationCoordinates, PublicEventPriceDisplay, PublicEventPricing, PublicEventPricingOption, PublicEventPricingOptionAvailability, PublicEventPricingType } from '../../../../core/src/index';
 import type { AccordionIslandProps as BlocksAccordionIslandProps, BookingFormConfig as BlocksBookingFormConfig, BookingFormInteractiveIslandProps as BlocksBookingFormIslandProps, BookingFormService as BlocksBookingFormService, CarouselIslandProps as BlocksCarouselIslandProps, CartDisplay as BlocksCartDisplay, CartInteractiveIslandProps as BlocksCartIslandProps, CartLineDisplay as BlocksCartLineDisplay, CheckoutDisplay as BlocksCheckoutDisplay, CheckoutInteractiveIslandProps as BlocksCheckoutIslandProps, EventCalendarInteractiveIslandProps as BlocksEventCalendarIslandProps, EventCombinedInteractiveIslandProps as BlocksEventCombinedIslandProps, EventDetailsIslandProps as BlocksEventDetailsIslandProps, EventDetailsOccurrenceContext as BlocksEventDetailsOccurrenceContext, LocationMapIslandProps as BlocksLocationMapIslandProps, EventRegistrationInteractiveIslandProps as BlocksEventRegistrationIslandProps, EventListingDisplay as BlocksEventListingDisplay, EventListingHydration as BlocksEventListingHydration, EventListingInteractiveIslandProps as BlocksEventListingIslandProps, PublicEvent as BlocksPublicEvent, FormInteractiveIslandProps as BlocksFormIslandProps, HeaderSectionIslandProps as BlocksHeaderSectionIslandProps, MembershipCardDisplay as BlocksMembershipCardDisplay, NewsletterFormInteractiveIslandProps as BlocksNewsletterFormIslandProps, PassCardDisplay as BlocksPassCardDisplay, PassesMembershipsDisplay as BlocksPassesMembershipsDisplay, ProductCardDisplay as BlocksProductCardDisplay, ProductDetailDisplay as BlocksProductDetailDisplay, ProductDetailInteractiveIslandProps as BlocksProductDetailIslandProps, ProductListDisplay as BlocksProductListDisplay, ProductListInteractiveIslandProps as BlocksProductListIslandProps, ProductVariantOptionDisplay as BlocksProductVariantOptionDisplay, ShopInteractiveIslandProps as BlocksShopIslandProps } from '../../../../blocks/src/contracts/index';
 export type ResponsiveSlidesToShow = {
     mobile?: number | string;
@@ -72,17 +72,7 @@ export type PublicEventAttendanceModeAvailability = {
     waitlistEnabled: boolean;
 };
 export type { PublicTeamMemberSummary };
-export type BookingPaymentCollectionOption = {
-    kind: 'upfront';
-} | {
-    kind: 'deferred_manual';
-} | {
-    kind: 'instalment_plan';
-    plan: BookingInstalmentPlanConfig;
-} | {
-    kind: 'flexible_balance';
-    config: BookingFlexibleBalanceConfig;
-};
+export type { BookingPaymentCollectionOption };
 export type BookingPaymentTerms = {
     allowedOptions: BookingPaymentCollectionOption[];
 };

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.148.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.
  *