@riverbankcms/sdk 0.130.2 → 0.134.0

package/dist/_dts/blocks/src/system/runtime/nodes/events/EventListing.interactive.d.ts

@@ -1,4 +1,5 @@
-import type { ButtonVariant, CardOrientation, CardVariant, ColumnOption, EventCardVariantInput, EventLayout, EventScheduleScope, EventSurfaceScope, FilterAutoShow, PublicEvent } from "../../../blocks/events/shared/types";
+import { type CardRole } from "../../../../../../theme-core/src/cards/index";
+import type { ButtonVariant, CardOrientation, ColumnOption, EventLayout, EventScheduleScope, EventSurfaceScope, FilterAutoShow, PublicEvent } from "../../../blocks/events/shared/types";
 import { type InteractiveIslandProps } from "../../../../contracts/islands";
 import { type EventListPaginationAction, type EventListPaginationMode, type EventPageSize } from "./shared/listOptions";
 export type EventListingSourceProps = Readonly<{
@@ -12,7 +13,7 @@ export type EventListingSourceProps = Readonly<{
     paginationMode?: EventListPaginationMode;
     seeAllUrl?: string;
     loadMoreText?: string;
-    cardVariant?: EventCardVariantInput;
+    cardRole?: CardRole;
     buttonVariant?: ButtonVariant;
     buttonText?: string;
     showVenue?: boolean;
@@ -39,7 +40,7 @@ export type EventListingDisplay = Readonly<{
     emptyMessage: string;
     loadingMessage: string;
     containerClass: string;
-    cardVariant: CardVariant;
+    cardRole: CardRole;
     buttonVariant: ButtonVariant;
     buttonText: string;
     showVenue: boolean;
@@ -84,7 +85,7 @@ export declare const eventListingBlockRuntime: Readonly<{
         paginationMode?: EventListPaginationMode;
         seeAllUrl?: string;
         loadMoreText?: string;
-        cardVariant?: EventCardVariantInput;
+        cardRole?: CardRole;
         buttonVariant?: ButtonVariant;
         buttonText?: string;
         showVenue?: boolean;
@@ -111,7 +112,7 @@ export declare const eventListingBlockRuntime: Readonly<{
             emptyMessage: string;
             loadingMessage: string;
             containerClass: string;
-            cardVariant: CardVariant;
+            cardRole: CardRole;
             buttonVariant: ButtonVariant;
             buttonText: string;
             showVenue: boolean;
@@ -151,7 +152,7 @@ export declare const eventListingBlockRuntime: Readonly<{
                 paginationMode?: EventListPaginationMode;
                 seeAllUrl?: string;
                 loadMoreText?: string;
-                cardVariant?: EventCardVariantInput;
+                cardRole?: CardRole;
                 buttonVariant?: ButtonVariant;
                 buttonText?: string;
                 showVenue?: boolean;
@@ -181,7 +182,7 @@ export declare const eventListingBlockRuntime: Readonly<{
                 paginationMode?: EventListPaginationMode;
                 seeAllUrl?: string;
                 loadMoreText?: string;
-                cardVariant?: EventCardVariantInput;
+                cardRole?: CardRole;
                 buttonVariant?: ButtonVariant;
                 buttonText?: string;
                 showVenue?: boolean;
@@ -211,7 +212,7 @@ export declare const eventListingBlockRuntime: Readonly<{
                     emptyMessage: string;
                     loadingMessage: string;
                     containerClass: string;
-                    cardVariant: CardVariant;
+                    cardRole: CardRole;
                     buttonVariant: ButtonVariant;
                     buttonText: string;
                     showVenue: boolean;
@@ -247,7 +248,7 @@ export declare const eventListingBlockRuntime: Readonly<{
                     emptyMessage: string;
                     loadingMessage: string;
                     containerClass: string;
-                    cardVariant: CardVariant;
+                    cardRole: CardRole;
                     buttonVariant: ButtonVariant;
                     buttonText: string;
                     showVenue: boolean;
@@ -295,7 +296,7 @@ export declare const eventListingInteractiveIslandPropsCodec: Readonly<{
                 emptyMessage: string;
                 loadingMessage: string;
                 containerClass: string;
-                cardVariant: CardVariant;
+                cardRole: CardRole;
                 buttonVariant: ButtonVariant;
                 buttonText: string;
                 showVenue: boolean;
@@ -340,7 +341,7 @@ export declare const eventListingInteractiveIslandPropsCodec: Readonly<{
                 emptyMessage: string;
                 loadingMessage: string;
                 containerClass: string;
-                cardVariant: CardVariant;
+                cardRole: CardRole;
                 buttonVariant: ButtonVariant;
                 buttonText: string;
                 showVenue: boolean;

package/dist/_dts/blocks/src/system/runtime/nodes/events/EventListing.server.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
-import type { ButtonVariant, ColumnOption, EventCardVariantInput, EventLayout, FilterAutoShow, PublicEvent } from '../../../blocks/events/shared/types';
+import type { ButtonVariant, ColumnOption, EventLayout, FilterAutoShow, PublicEvent } from '../../../blocks/events/shared/types';
+import type { CardRole } from '../../../../../../theme-core/src/cards/index';
 type EventListingProps = Readonly<{
     blockId?: string | null;
     events?: PublicEvent[] | null;
@@ -12,7 +13,7 @@ type EventListingProps = Readonly<{
     paginationMode?: 'loadMore' | 'seeAllLink';
     seeAllUrl?: string;
     loadMoreText?: string;
-    cardVariant?: EventCardVariantInput;
+    cardRole?: CardRole;
     buttonVariant?: ButtonVariant;
     buttonText?: string;
     showVenue?: boolean;

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

@@ -1,10 +1,11 @@
 import React from 'react';
-import type { PublicEvent, EventCardVariantInput, ButtonVariant, EventLayout } from '../../../blocks/events/shared/types';
+import type { PublicEvent, ButtonVariant, EventLayout } from '../../../blocks/events/shared/types';
+import type { CardRole } from '../../../../../../theme-core/src/cards/index';
 type EventSpotlightProps = {
     events?: PublicEvent[] | null;
     layout?: EventLayout;
     columns?: '2' | '3';
-    cardVariant?: EventCardVariantInput;
+    cardRole?: CardRole;
     buttonVariant?: ButtonVariant;
     buttonText?: string;
     ctaLabel?: string | null;

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/EventCard.d.ts

@@ -1,8 +1,9 @@
 import React from 'react';
-import type { ButtonVariant, CardOrientation, EventCardVariantInput, PublicEvent } from '../../../../blocks/events/shared/types';
+import type { CardRole } from '../../../../../../../theme-core/src/cards/index';
+import type { ButtonVariant, CardOrientation, PublicEvent } from '../../../../blocks/events/shared/types';
 type EventCardProps = {
     event: PublicEvent;
-    cardVariant?: EventCardVariantInput;
+    cardRole?: CardRole;
     buttonVariant?: ButtonVariant;
     buttonText?: string;
     showVenue?: boolean;

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/EventDetailModal.d.ts

@@ -1,11 +1,12 @@
 import React from 'react';
-import type { PublicEvent, ButtonVariant, EventCardVariantInput } from '../../../../blocks/events/shared/types';
+import type { PublicEvent, ButtonVariant } from '../../../../blocks/events/shared/types';
+import type { CardRole } from '../../../../../../../theme-core/src/cards/index';
 type EventDetailModalProps = {
     event: PublicEvent;
     showCapacity: boolean;
     onClose: () => void;
     portalRoot?: HTMLElement | null;
-    cardVariant?: EventCardVariantInput;
+    cardRole?: CardRole;
     buttonVariant?: ButtonVariant;
     buttonText?: string;
     showMap?: boolean;
@@ -16,5 +17,5 @@ type EventDetailModalProps = {
  * Reuses EventCard component directly for DRY implementation.
  * EventCard already includes the CTA button to navigate to the full event page.
  */
-export declare function EventDetailModal({ event, showCapacity, onClose, portalRoot, cardVariant, buttonVariant, buttonText, showMap, }: EventDetailModalProps): React.ReactElement;
+export declare function EventDetailModal({ event, showCapacity, onClose, portalRoot, cardRole, buttonVariant, buttonText, showMap, }: EventDetailModalProps): React.ReactElement;
 export default EventDetailModal;

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/EventModalCloseButton.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+type EventModalCloseButtonProps = Readonly<{
+    closeButtonRef: React.RefObject<HTMLButtonElement | null>;
+    onClose: () => void;
+}>;
+export declare function EventModalCloseButton({ closeButtonRef, onClose, }: EventModalCloseButtonProps): React.ReactElement;
+export {};

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/EventModals.d.ts

@@ -1,8 +1,9 @@
 import React from 'react';
-import type { ButtonVariant, EventCardVariantInput } from '../../../../blocks/events/shared/types';
+import type { ButtonVariant } from '../../../../blocks/events/shared/types';
+import type { CardRole } from '../../../../../../../theme-core/src/cards/index';
 type EventModalsProps = {
     showCapacity: boolean;
-    cardVariant?: EventCardVariantInput;
+    cardRole?: CardRole;
     buttonVariant?: ButtonVariant;
     buttonText?: string;
 };
@@ -14,5 +15,5 @@ type EventModalsProps = {
  * - EventDetailModal for single event view
  * - DayEventsModal for day events list (clicking an event switches to event modal)
  */
-export declare function EventModals({ showCapacity, cardVariant, buttonVariant, buttonText, }: EventModalsProps): React.ReactElement | null;
+export declare function EventModals({ showCapacity, cardRole, buttonVariant, buttonText, }: EventModalsProps): React.ReactElement | null;
 export default EventModals;

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/WeekBoardView.d.ts

@@ -20,6 +20,20 @@ type WeekBoardViewProps = {
     /** Opt-in section band. Generic default is bandless. */
     banded?: boolean;
 };
+type WeekBoardDisplay = Readonly<{
+    events: readonly PublicEvent[];
+    showCapacity: boolean;
+    emptyMessage?: string;
+    boardTitle?: string;
+    footerNote?: string;
+    loadMoreText?: string;
+    buttonText: string;
+    seeAllUrl?: string | null;
+    buttonVariant?: ButtonVariant;
+    elevated?: boolean;
+    banded?: boolean;
+}>;
+export declare function buildWeekBoardViewProps(display: WeekBoardDisplay, days: WeekCalendarDays): WeekBoardViewProps;
 /**
  * WeekBoardView
  *

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/eventCollectionContract.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { type CardRole } from "../../../../../../../theme-core/src/cards/index";
 import type { ButtonVariant, CalendarTabViews, CalendarView, ColumnOption, EventLayout, EventScheduleScope, EventSurfaceScope, FilterAutoShow, PublicEvent, WeekStart } from "../../../../blocks/events/shared/types";
 import { type EventListPaginationAction, type EventListPaginationMode, type EventPageSize } from "./listOptions";
 import type { EventListingDisplay } from "../EventListing.interactive";
@@ -29,6 +30,7 @@ export type EventCollectionSourceProps = Readonly<{
     showVenue?: boolean | null;
     showMap?: boolean | null;
     showCapacity?: boolean | null;
+    cardRole?: CardRole;
     buttonVariant?: ButtonVariant;
     buttonText?: string;
     emptyMessage?: string;
@@ -56,6 +58,7 @@ export type EventCollectionDisplay = Readonly<{
     showVenue: boolean;
     showMap: boolean;
     showCapacity: boolean;
+    cardRole: CardRole;
     buttonVariant: ButtonVariant;
     buttonText: string;
     emptyMessage: string;
@@ -97,6 +100,12 @@ export declare const eventCollectionSourceSchemaShape: {
     readonly showVenue: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly showMap: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly showCapacity: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    readonly cardRole: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        none: "none";
+        default: "default";
+        alternative: "alternative";
+    }>>;
     readonly buttonVariant: z.ZodOptional<z.ZodEnum<{
         outline: "outline";
         accent: "accent";
@@ -138,11 +147,11 @@ export declare const eventCollectionSourceSchemaShape: {
         eventPreset: z.ZodOptional<z.ZodEnum<{
             course: "course";
             event: "event";
-            term: "term";
-            performance: "performance";
             class: "class";
+            term: "term";
             workshop: "workshop";
             retreat: "retreat";
+            performance: "performance";
         }>>;
         eventDestinationMode: z.ZodOptional<z.ZodEnum<{
             "cms-managed": "cms-managed";
@@ -472,14 +481,14 @@ export declare const eventCollectionSourceSchemaShape: {
             }>;
         }, z.core.$strip>], "kind">;
         deliveryMode: z.ZodEnum<{
+            online: "online";
             in_person: "in_person";
             hybrid: "hybrid";
-            online: "online";
         }>;
         attendanceModes: z.ZodArray<z.ZodObject<{
             mode: z.ZodEnum<{
-                in_person: "in_person";
                 online: "online";
+                in_person: "in_person";
             }>;
             capacity: z.ZodNullable<z.ZodNumber>;
             registeredCount: z.ZodNumber;
@@ -562,9 +571,9 @@ export declare const eventCollectionSourceSchemaShape: {
                 }>;
                 capacityLimit: z.ZodNullable<z.ZodNumber>;
                 attendanceScope: z.ZodOptional<z.ZodEnum<{
-                    in_person: "in_person";
                     both: "both";
                     online: "online";
+                    in_person: "in_person";
                 }>>;
                 saleStartsAt: z.ZodNullable<z.ZodString>;
                 saleEndsAt: z.ZodNullable<z.ZodString>;
@@ -711,6 +720,17 @@ export declare const eventCollectionSourceSchemaShape: {
                 }, z.core.$strip>;
             }, z.core.$strip>]>>;
         }, z.core.$strip>;
+        consent: z.ZodNullable<z.ZodType<Readonly<{
+            requirementId: string;
+            title: string;
+            agreement: import("../../../../../../../core/src/index").RichTextDoc;
+            checkboxLabel: string;
+        }>, unknown, z.core.$ZodTypeInternals<Readonly<{
+            requirementId: string;
+            title: string;
+            agreement: import("../../../../../../../core/src/index").RichTextDoc;
+            checkboxLabel: string;
+        }>, unknown>>>;
         accessRestriction: z.ZodEnum<{
             none: "none";
             category: "category";
@@ -723,8 +743,8 @@ export declare const eventCollectionSourceSchemaShape: {
             eventSeriesId: z.ZodString;
             pricing: z.ZodObject<{
                 bookingRequirement: z.ZodEnum<{
-                    required: "required";
                     none: "none";
+                    required: "required";
                 }>;
                 pricingStrategy: z.ZodEnum<{
                     single: "single";
@@ -810,9 +830,9 @@ export declare const eventCollectionSourceSchemaShape: {
                     saleStartsAt: z.ZodNullable<z.ZodString>;
                     saleEndsAt: z.ZodNullable<z.ZodString>;
                     attendanceScope: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                        in_person: "in_person";
                         both: "both";
                         online: "online";
+                        in_person: "in_person";
                     }>>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>;
@@ -866,11 +886,11 @@ export declare const eventCollectionDisplaySchemaShape: {
         eventPreset: z.ZodOptional<z.ZodEnum<{
             course: "course";
             event: "event";
-            term: "term";
-            performance: "performance";
             class: "class";
+            term: "term";
             workshop: "workshop";
             retreat: "retreat";
+            performance: "performance";
         }>>;
         eventDestinationMode: z.ZodOptional<z.ZodEnum<{
             "cms-managed": "cms-managed";
@@ -1200,14 +1220,14 @@ export declare const eventCollectionDisplaySchemaShape: {
             }>;
         }, z.core.$strip>], "kind">;
         deliveryMode: z.ZodEnum<{
+            online: "online";
             in_person: "in_person";
             hybrid: "hybrid";
-            online: "online";
         }>;
         attendanceModes: z.ZodArray<z.ZodObject<{
             mode: z.ZodEnum<{
-                in_person: "in_person";
                 online: "online";
+                in_person: "in_person";
             }>;
             capacity: z.ZodNullable<z.ZodNumber>;
             registeredCount: z.ZodNumber;
@@ -1290,9 +1310,9 @@ export declare const eventCollectionDisplaySchemaShape: {
                 }>;
                 capacityLimit: z.ZodNullable<z.ZodNumber>;
                 attendanceScope: z.ZodOptional<z.ZodEnum<{
-                    in_person: "in_person";
                     both: "both";
                     online: "online";
+                    in_person: "in_person";
                 }>>;
                 saleStartsAt: z.ZodNullable<z.ZodString>;
                 saleEndsAt: z.ZodNullable<z.ZodString>;
@@ -1439,6 +1459,17 @@ export declare const eventCollectionDisplaySchemaShape: {
                 }, z.core.$strip>;
             }, z.core.$strip>]>>;
         }, z.core.$strip>;
+        consent: z.ZodNullable<z.ZodType<Readonly<{
+            requirementId: string;
+            title: string;
+            agreement: import("../../../../../../../core/src/index").RichTextDoc;
+            checkboxLabel: string;
+        }>, unknown, z.core.$ZodTypeInternals<Readonly<{
+            requirementId: string;
+            title: string;
+            agreement: import("../../../../../../../core/src/index").RichTextDoc;
+            checkboxLabel: string;
+        }>, unknown>>>;
         accessRestriction: z.ZodEnum<{
             none: "none";
             category: "category";
@@ -1451,8 +1482,8 @@ export declare const eventCollectionDisplaySchemaShape: {
             eventSeriesId: z.ZodString;
             pricing: z.ZodObject<{
                 bookingRequirement: z.ZodEnum<{
-                    required: "required";
                     none: "none";
+                    required: "required";
                 }>;
                 pricingStrategy: z.ZodEnum<{
                     single: "single";
@@ -1538,9 +1569,9 @@ export declare const eventCollectionDisplaySchemaShape: {
                     saleStartsAt: z.ZodNullable<z.ZodString>;
                     saleEndsAt: z.ZodNullable<z.ZodString>;
                     attendanceScope: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                        in_person: "in_person";
                         both: "both";
                         online: "online";
+                        in_person: "in_person";
                     }>>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>;
@@ -1599,6 +1630,12 @@ export declare const eventCollectionDisplaySchemaShape: {
     readonly showVenue: z.ZodBoolean;
     readonly showMap: z.ZodBoolean;
     readonly showCapacity: z.ZodBoolean;
+    readonly cardRole: z.ZodEnum<{
+        open: "open";
+        none: "none";
+        default: "default";
+        alternative: "alternative";
+    }>;
     readonly buttonVariant: z.ZodEnum<{
         outline: "outline";
         accent: "accent";

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

@@ -13,7 +13,7 @@ export type MagicLinkFormProps = {
     /** Called when successfully sent (optional) */
     onSuccess?: () => void;
     /** CSS class prefix for styling (e.g., 'cp' for customer portal, 'er' for event registration, 'cr' for course registration) */
-    classPrefix?: 'cp' | 'er' | 'cr';
+    classPrefix?: 'cp' | 'er' | 'cr' | 'er-whole-series';
     /** Whether to show compact/inline styling */
     compact?: boolean;
 };

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

@@ -0,0 +1,7 @@
+import type { RichTextDoc } from "../../../../../../core/src/index";
+export declare function BookingConsentAgreement({ agreement, showTitle, title, titleId, }: Readonly<{
+    agreement: RichTextDoc;
+    showTitle?: boolean;
+    title: string;
+    titleId: string;
+}>): React.ReactElement;

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

@@ -1,18 +1,18 @@
 import type React from 'react';
-type BlockDiscountCodeSurface = 'course-registration' | 'event-registration';
+type BlockDiscountCodeSurface = 'event-registration' | 'whole-series-registration';
 export type DiscountCodeDisclosureSurface = BlockDiscountCodeSurface | 'theme-form';
 export declare const BLOCK_DISCOUNT_CODE_DISCLOSURE_CLASSES: {
-    readonly 'course-registration': {
-        readonly root: "cr-discount";
-        readonly toggle: "cr-discount__toggle";
-        readonly form: "cr-discount__form";
-        readonly label: "cr-discount__label";
-        readonly row: "cr-discount__row";
-        readonly input: "cr-discount__input";
-        readonly apply: "cr-discount__apply";
-        readonly remove: "cr-discount__remove";
-        readonly hint: "cr-discount__hint";
-        readonly feedback: "cr-discount__feedback";
+    readonly 'whole-series-registration': {
+        readonly root: "er-whole-series-discount";
+        readonly toggle: "er-whole-series-discount__toggle";
+        readonly form: "er-whole-series-discount__form";
+        readonly label: "er-whole-series-discount__label";
+        readonly row: "er-whole-series-discount__row";
+        readonly input: "er-whole-series-discount__input";
+        readonly apply: "er-whole-series-discount__apply";
+        readonly remove: "er-whole-series-discount__remove";
+        readonly hint: "er-whole-series-discount__hint";
+        readonly feedback: "er-whole-series-discount__feedback";
     };
     readonly 'event-registration': {
         readonly root: "er-discount";

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

@@ -12,6 +12,7 @@ export type FormData = {
     email: string;
     phone: string;
     notes: string;
+    consentAccepted?: boolean;
 };
 /**
  * Button style variants.

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

@@ -13,4 +13,5 @@ export type UseWaitlistClaimDeps = Readonly<{
     useBlockApi: typeof useBlockApi;
 }>;
 export declare function useWaitlistClaim(): UseWaitlistClaimResult;
+export declare function useWaitlistClaimForToken(token: string | null): UseWaitlistClaimResult;
 export declare function useWaitlistClaimWithDeps(deps: UseWaitlistClaimDeps): UseWaitlistClaimResult;

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

@@ -1,4 +1,4 @@
-import { type CardRole } from '../../../../../../theme-core/src/cards/index';
+import { type CardRole } from "../../../../../../theme-core/src/cards/index";
 /**
  * @file The one place box-style content becomes CSS classes.
  *
@@ -12,19 +12,33 @@ export declare const RAISED_SHADOW_CLASS = "rb-shadow-md";
 export declare const ROUNDED_CLASSES: Readonly<Record<string, string>>;
 export declare const fixedFrameScopeClass = "rb-bg-motion-fixed-frame-scope";
 export declare function hasFixedFrameBackgroundMotion(value: unknown): boolean;
+/**
+ * The stable per-theme class for a card role. Generated card CSS emits these
+ * aliases alongside each `.card-{id}` rule, so content addresses "this site
+ * style's open card" without knowing which variant implements it.
+ */
+export declare function cardRoleClass(role: Exclude<CardRole, "none">): string;
+/**
+ * The role class for a card slot the *block* owns structurally, where a Look
+ * may still name the surface.
+ *
+ * Some layouts have more than one card slot and decide themselves which one is
+ * the statement — the featured-editorial testimonials field is a lead voice
+ * beside its supporting voices, and that is structure, not composition. Those
+ * slots still have to honour a Look that picks a surface, or a role-picking
+ * Look would silently no-op under the layout. So the slot carries a default
+ * role and the Look's compiled role wins over it when there is one.
+ *
+ * An explicit `none` is honoured as boxlessness and emits no class, matching
+ * how the composite emitter reads it.
+ */
 /**
  * The role a card renders with, and the one place a set of card styles becomes
  * a role.
  *
- * Precedence: a per-item override, then the `role` a Look compiled onto the
- * block's card styles, then the legacy `cardVariant` field. `cardVariant` only
- * ever held role names, so it reads *as* a role rather than as a second
- * vocabulary — an explicit `role` wins when a record carries both.
- *
- * Compiled and freshly authored card styles carry only `role`. `cardVariant`
- * survives on content persisted before the role contract, and normalizes here
- * rather than in `cardStylesOverrideSchema` because that content reaches the
- * renderer as a raw record without ever passing through the schema.
+ * Precedence: a per-item override, then the `role` a Look or semantic field
+ * compiled onto the block's card styles. Persisted inputs are normalized at
+ * this boundary because raw block records do not pass through the theme schema.
  */
 export declare function resolveCardRoleForBoxStyles(input: Record<string, unknown>, override: CardRole | null | undefined): CardRole | null;
 /**
@@ -34,7 +48,7 @@ export declare function resolveCardRoleForBoxStyles(input: Record<string, unknow
  */
 export declare function resolveItemCardRole(value: unknown, aliases: Readonly<Record<string, string>> | undefined): CardRole | null;
 /** The border widths `CardStylesContent['border']` can carry. */
-export type BoxBorderWidth = 'none' | '1' | '2' | '3';
+export type BoxBorderWidth = "none" | "1" | "2" | "3";
 /**
  * A box border after the one legacy shape has been normalized away, parsed
  * into the vocabulary the field actually declares. The record arrives here as
@@ -80,6 +94,11 @@ export declare function boxStyleClassNames(value: unknown, options: Readonly<{
      * per-item override in blocks that let individual cards pick their surface.
      */
     cardRoleOverride?: CardRole | null;
+    /**
+     * A structural slot's default surface when neither the item nor compiled
+     * card styles names one. An explicit `none` still wins over this fallback.
+     */
+    cardRoleFallback?: Exclude<CardRole, "none">;
     /**
      * The elevation class an elevated box gets. Defaults to the standard raised
      * shadow; pass `null` to opt out explicitly (the binding pipeline does that

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

@@ -1,6 +1,6 @@
 import { type TransformDefinition } from "./core";
 import type { SemanticSpacing } from "../../spacing";
-import { type CardRole } from '../../../../../theme-core/src/cards/index';
+import type { CardRole } from "../../../../../theme-core/src/cards/index";
 /**
  * Maps semantic spacing values to CSS-only `rb-*` spacing classes.
  *
@@ -86,13 +86,24 @@ type CardRoleClassOptions = {
  * background, radius) ride along on top as they always have.
  */
 export declare const cardRoleClassTransform: TransformDefinition<CardRoleClassOptions>;
-export declare const cardVariantClassTransform: TransformDefinition<{
+/**
+ * The role class for a layout's own card slot, bound from the block's compiled
+ * card styles so a Look that picks a surface still reaches a slot the layout
+ * assigned a default role to.
+ */
+export declare const cardSlotRoleTransform: TransformDefinition<{
     baseClass?: string;
+    slotDefault: Exclude<CardRole, "none">;
 }>;
-export declare const boxStylesBorderColorTransform: TransformDefinition<{
+type BoxStylesBorderColorOptions = {
     fallbackToken?: string;
     returnEmptyForDefault?: boolean;
-}>;
+    /** Read card styles here when the bound value is a per-item role. */
+    stylesPath?: string;
+    /** Map a block's per-item surface vocabulary onto canonical card roles. */
+    itemRoleAliases?: Readonly<Record<string, string>>;
+};
+export declare const boxStylesBorderColorTransform: TransformDefinition<BoxStylesBorderColorOptions>;
 type SectionClassNameOptions = {
     baseClass?: string;
     containerStylesPath?: string;

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

@@ -9,4 +9,5 @@ import { contentTransforms } from "./content";
 import { headerRuntimeTransforms } from "./headerRuntime";
 export declare const builtinTransformDefinitions: import("./core").TransformDefinition<unknown>[];
 export declare const defaultTransforms: import("./core").TransformRegistry;
+export { boxStyleClassNames } from "./_utils/boxStyleClassNames";
 export { formattingTransforms, layoutTransforms, uiTransforms, mediaTransforms, backgroundTransforms, linksTransforms, boxStylesTransforms, contentTransforms, headerRuntimeTransforms, };

package/dist/_dts/blocks/src/system/transforms/typed.d.ts

@@ -100,9 +100,6 @@ export declare const transformDefinitions: {
     readonly 'boxStyles.semanticGapValue': TransformDefinition<{
         fallback?: import("../spacing").SemanticSpacing;
     }>;
-    readonly 'boxStyles.cardVariantClass': TransformDefinition<{
-        baseClass?: string;
-    }>;
 };
 export type TransformId = keyof typeof transformDefinitions;
 type OptionsOf<T> = T extends TransformDefinition<infer O> ? O : never;
@@ -123,7 +120,7 @@ export declare function bindProp(from: string, opts?: {
     readonly $bind: {
         readonly pick?: "value" | "context" | "collection" | undefined;
         readonly fallback?: {} | null | undefined;
-        readonly transforms?: TransformStep<"string.uppercase" | "value.fallback" | "date.formatShort" | "value.csv" | "layout.maxWidthClass" | "layout.headerRootClass" | "layout.footerRootClass" | "layout.headerRootStyle" | "layout.headerSectionBackground" | "layout.footerRootStyle" | "ui.headerNavLinkClass" | "ui.headingClassFromAlignment" | "ui.bodyClassFromAlignment" | "ui.stackAlignFromAlignment" | "ui.sectionStateTone" | "ui.heroContentWrapperClass" | "ui.heroCtaJustify" | "ui.heroStackJustifyFromVerticalAlignment" | "ui.heroGridClassFromVerticalAlignment" | "ui.conditionalClass" | "ui.twoColumnContainerClass" | "ui.twoColumnFlexBasis" | "media.fromUrl" | "content.interpolateRichTextTokens" | "boxStyles.semanticGap" | "boxStyles.semanticGapValue" | "boxStyles.cardVariantClass" | "layout.headerLogoClass" | "layout.headerLogoMediaClass" | "layout.headerLogoTextVisible" | "layout.footerBottomBarClass" | "layout.footerBottomBarContainerClass" | "layout.footerBottomBarStyle" | "layout.footerSplitMainClass" | "layout.footerLogoClass" | "layout.footerLogoMediaClass" | "layout.footerLogoTextVisible" | "layout.headerRuntimeContract">[] | undefined;
+        readonly transforms?: TransformStep<"string.uppercase" | "value.fallback" | "date.formatShort" | "value.csv" | "layout.maxWidthClass" | "layout.headerRootClass" | "layout.footerRootClass" | "layout.headerRootStyle" | "layout.headerSectionBackground" | "layout.footerRootStyle" | "ui.headerNavLinkClass" | "ui.headingClassFromAlignment" | "ui.bodyClassFromAlignment" | "ui.stackAlignFromAlignment" | "ui.sectionStateTone" | "ui.heroContentWrapperClass" | "ui.heroCtaJustify" | "ui.heroStackJustifyFromVerticalAlignment" | "ui.heroGridClassFromVerticalAlignment" | "ui.conditionalClass" | "ui.twoColumnContainerClass" | "ui.twoColumnFlexBasis" | "media.fromUrl" | "content.interpolateRichTextTokens" | "boxStyles.semanticGap" | "boxStyles.semanticGapValue" | "layout.headerLogoClass" | "layout.headerLogoMediaClass" | "layout.headerLogoTextVisible" | "layout.footerBottomBarClass" | "layout.footerBottomBarContainerClass" | "layout.footerBottomBarStyle" | "layout.footerSplitMainClass" | "layout.footerLogoClass" | "layout.footerLogoMediaClass" | "layout.footerLogoTextVisible" | "layout.headerRuntimeContract">[] | undefined;
         readonly from: string;
     };
 };