@riverbankcms/sdk 0.130.0 → 0.132.0

package/dist/_dts/blocks/src/system/blocks/events/whole-series/schemas.d.ts

@@ -0,0 +1,135 @@
+import { z } from 'zod';
+import type { PublicWholeSeriesOffering } from './types';
+export declare const wholeSeriesVenueSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    address: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const wholeSeriesSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    startsAt: z.ZodString;
+    endsAt: z.ZodString;
+    timeZone: z.ZodString;
+    capacityOverride: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    overrides: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export declare const wholeSeriesTeamMemberSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    roleLabel: z.ZodNullable<z.ZodString>;
+    summary: z.ZodNullable<z.ZodString>;
+    profilePath: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const wholeSeriesPricingOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    priceAmount: z.ZodNumber;
+    isActive: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+    capacityLimit: z.ZodNullable<z.ZodNumber>;
+    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";
+    }>>>;
+}, z.core.$strip>;
+export declare const wholeSeriesPricingSchema: z.ZodObject<{
+    bookingRequirement: z.ZodEnum<{
+        required: "required";
+        none: "none";
+    }>;
+    pricingStrategy: z.ZodEnum<{
+        single: "single";
+        sliding_scale: "sliding_scale";
+        free: "free";
+        tiered: "tiered";
+    }>;
+    currency: z.ZodString;
+    singlePriceAmount: z.ZodNullable<z.ZodNumber>;
+    slidingMinAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    slidingMaxAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    slidingSuggestedAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    paymentTerms: z.ZodObject<{
+        allowedOptions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"upfront">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"deferred_manual">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"instalment_plan">;
+            plan: z.ZodUnion<readonly [z.ZodObject<{
+                kind: z.ZodLiteral<"deposit_plus_one_remainder">;
+                depositAmountCents: z.ZodNumber;
+                depositRefundability: z.ZodEnum<{
+                    refundable: "refundable";
+                    non_refundable: "non_refundable";
+                }>;
+                remainderDueCount: z.ZodNumber;
+                intervalUnit: z.ZodEnum<{
+                    day: "day";
+                    week: "week";
+                    month: "month";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"deposit_plus_scheduled_instalments">;
+                depositAmountCents: z.ZodNumber;
+                depositRefundability: z.ZodEnum<{
+                    refundable: "refundable";
+                    non_refundable: "non_refundable";
+                }>;
+                instalmentCount: z.ZodNumber;
+                intervalCount: z.ZodNumber;
+                intervalUnit: z.ZodEnum<{
+                    day: "day";
+                    week: "week";
+                    month: "month";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"equal_scheduled_instalments">;
+                instalmentCount: z.ZodNumber;
+                intervalCount: z.ZodNumber;
+                intervalUnit: z.ZodEnum<{
+                    day: "day";
+                    week: "week";
+                    month: "month";
+                }>;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"flexible_balance">;
+            config: z.ZodObject<{
+                upfrontAmountCents: z.ZodNumber;
+                dueDateRule: z.ZodUnion<readonly [z.ZodObject<{
+                    kind: z.ZodLiteral<"relative_to_start_date">;
+                    daysBeforeStart: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"fixed_calendar_date">;
+                    dueAt: z.ZodString;
+                }, z.core.$strip>]>;
+                depositRefundability: z.ZodEnum<{
+                    refundable: "refundable";
+                    non_refundable: "non_refundable";
+                }>;
+            }, z.core.$strip>;
+        }, z.core.$strip>]>>;
+    }, z.core.$strip>;
+    options: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        priceAmount: z.ZodNumber;
+        isActive: z.ZodBoolean;
+        sortOrder: z.ZodNumber;
+        capacityLimit: z.ZodNullable<z.ZodNumber>;
+        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";
+        }>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const publicWholeSeriesOfferingSchema: z.ZodType<PublicWholeSeriesOffering>;
+export declare const publicWholeSeriesOfferingsArraySchema: z.ZodArray<z.ZodType<PublicWholeSeriesOffering, unknown, z.core.$ZodTypeInternals<PublicWholeSeriesOffering, unknown>>>;

package/dist/_dts/blocks/src/system/blocks/events/whole-series/types.d.ts

@@ -0,0 +1,81 @@
+/** Canonical public model for Events booked as one complete run. */
+import type { BlockBookingPaymentTerms } from '../../shared/bookingPaymentTerms';
+import type { PublicTeamMemberSummary } from '../../shared/teamMembers';
+import type { BlockButtonRole } from '../../../constants/buttonRoles';
+export type WholeSeriesOfferingStatus = 'active' | 'draft' | 'cancelled';
+export type WholeSeriesVenue = {
+    id: string;
+    name: string;
+    address: string | null;
+};
+export type WholeSeriesSession = {
+    id: string;
+    startsAt: string;
+    endsAt: string;
+    timeZone: string;
+    capacityOverride?: number | null;
+    overrides?: Record<string, unknown> | null;
+};
+export type WholeSeriesPricingOption = {
+    id: string;
+    name: string;
+    description: string | null;
+    priceAmount: number;
+    isActive: boolean;
+    sortOrder: number;
+    capacityLimit: number | null;
+    saleStartsAt: string | null;
+    saleEndsAt: string | null;
+    attendanceScope?: 'in_person' | 'online' | 'both' | null;
+};
+export type WholeSeriesPricing = {
+    bookingRequirement: 'none' | 'required';
+    pricingStrategy: 'free' | 'single' | 'tiered' | 'sliding_scale';
+    currency: string;
+    singlePriceAmount: number | null;
+    slidingMinAmount?: number | null;
+    slidingMaxAmount?: number | null;
+    slidingSuggestedAmount?: number | null;
+    paymentTerms: BlockBookingPaymentTerms;
+    options: readonly WholeSeriesPricingOption[];
+};
+/**
+ * Public whole-series offering data from the API.
+ * Used by Event registration and details surfaces.
+ */
+export type PublicWholeSeriesOffering = {
+    /** Canonical event-series identity backing this concrete bookable run. */
+    eventSeriesId: string;
+    /** Offering identity owning the public Event page and its available runs. */
+    eventOfferingId: string;
+    title: string;
+    slug: string;
+    /** Rich text description (ProseMirror/TipTap JSON format) */
+    description: unknown;
+    teamMembers?: PublicTeamMemberSummary[];
+    /** Registration is open if the run has not started yet. */
+    enrollmentOpen: boolean;
+    /** Canonical shared pricing model for the whole-series run. */
+    pricing: WholeSeriesPricing;
+    /** Currency code (ISO 4217) */
+    currency: string;
+    /** Shared booking payment-terms model for appointments and Events. */
+    paymentTerms: BlockBookingPaymentTerms;
+    /** Maximum enrollment capacity (null = unlimited) */
+    enrollmentCapacity: number | null;
+    /** Whether memberships can be used for free enrollment */
+    acceptsMemberships: boolean;
+    /** Operational status of the run. */
+    status: WholeSeriesOfferingStatus;
+    /** Total number of sessions in the run. */
+    sessionsCount: number;
+    /** Number of enrolled students */
+    enrolledCount: number;
+    /** Available spots (null if unlimited) */
+    availableSpots: number | null;
+    /** Every session included in this run. */
+    sessions: WholeSeriesSession[];
+    /** Venue information */
+    venue: WholeSeriesVenue | null;
+};
+export type ButtonVariant = BlockButtonRole;

package/dist/_dts/blocks/src/system/blocks/feature-cards.d.ts

@@ -5,10 +5,34 @@ import { type BlockConfig, type BlockContentShapeInput, type DefinedBlockManifes
 import { type StandardAspectRatio } from "../fields/aspectRatio";
 import { type BlockCtaContent } from "../fields/ctas";
 import type { BlockIconValue, SemanticIconId } from "../icons";
+import type { CardRole } from "../../../../theme-core/src/cards/index";
 import { type FeatureCardIconTreatment } from "./feature-card-icons";
 type FeatureCardsVariant = "cards" | "editorial-diptych" | "editorial-pathways";
 type FeatureCardsColumns = "2" | "3" | "4";
-export type FeatureCardSurfaceRole = "open" | "panel";
+/**
+ * This block's historical per-item surface values. They are aliases of card
+ * roles now, and stay parseable forever — persisted content carries them.
+ */
+export type FeatureCardLegacySurfaceRole = "open" | "panel";
+/**
+ * What an individual card may say about its own surface: the card-role
+ * vocabulary *minus* `open`, plus this block's two historical values.
+ *
+ * The subtraction is the point. `open` predates the role vocabulary here and
+ * keeps its old meaning — the unmarked boxless card every unset item already
+ * falls back to, which is role `none`. Reading it as role `open` would put a
+ * top rule on every default feature card, so
+ * `FEATURE_CARD_SURFACE_ROLE_ALIASES` maps it to `none` before any role
+ * normalization runs, and it does so unconditionally.
+ *
+ * Building the union as `Exclude<CardRole, 'open'> | FeatureCardLegacySurfaceRole`
+ * therefore states the truth: the string `open` is only ever reachable through
+ * the legacy half, and **the canonical `open` role is permanently
+ * unaddressable per item on this block** — the alias always wins. A caller
+ * that wants the canonical open card sets it as the block's card role, not as
+ * an item's `surfaceRole`.
+ */
+export type FeatureCardSurfaceRole = Exclude<CardRole, "open"> | FeatureCardLegacySurfaceRole;
 export declare const featureCardsManifest: DefinedBlockManifest<BlockContentShapeInput<BlockConfig>>;
 export type FeatureCard = {
     surfaceRole?: FeatureCardSurfaceRole | null;

package/dist/_dts/blocks/src/system/blocks/media-text.d.ts

@@ -4,6 +4,7 @@ import type { SystemBlockDefinition } from "../registry";
 import type { SemanticSpacing } from "../spacing";
 import { type ContentFrameIntent } from "../frame/frameStyles";
 import { type StandardAspectRatio } from "../fields/aspectRatio";
+import { type CardStylesContent } from "../fields/boxStyles";
 import { type StandardImageShape } from "../fields/imageShape";
 import { type ImageColSize } from "../fields/imageLayout";
 type MediaTextAlignment = "left" | "center";
@@ -94,36 +95,7 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
         readonly ui: {
             readonly intent: "display";
         };
-    }, import("../../../../block-form/src/backend/index").FieldDefinition, {
-        readonly id: "gap";
-        readonly type: "select";
-        readonly label: "Gap between media and text";
-        readonly required: false;
-        readonly defaultValue: "comfortable";
-        readonly multiple: false;
-        readonly options: [{
-            readonly value: "none";
-            readonly label: "None";
-        }, {
-            readonly value: "compact";
-            readonly label: "Compact";
-        }, {
-            readonly value: "cozy";
-            readonly label: "Cozy";
-        }, {
-            readonly value: "medium";
-            readonly label: "Medium";
-        }, {
-            readonly value: "comfortable";
-            readonly label: "Comfortable";
-        }, {
-            readonly value: "spacious";
-            readonly label: "Spacious";
-        }];
-        readonly ui: {
-            readonly intent: "display";
-        };
-    }, {
+    }, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, {
         readonly id: string;
         readonly label: string;
         readonly required: boolean;
@@ -2043,8 +2015,8 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
         readonly label: string;
         readonly id: string;
         readonly type: "repeater";
-        readonly required: boolean;
         readonly description?: string | undefined;
+        readonly required: boolean;
         readonly ui?: {
             widget?: string | undefined;
             preset?: "disclosure" | undefined;
@@ -2160,8 +2132,8 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
         readonly label: string;
         readonly id: string;
         readonly type: "group";
-        readonly required: boolean;
         readonly description?: string | undefined;
+        readonly required: boolean;
         readonly ui?: {
             widget?: string | undefined;
             preset?: "disclosure" | undefined;
@@ -2267,8 +2239,8 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
         readonly label: string;
         readonly id: string;
         readonly type: "modal";
-        readonly required: boolean;
         readonly description?: string | undefined;
+        readonly required: boolean;
         readonly ui?: {
             widget?: string | undefined;
             preset?: "disclosure" | undefined;
@@ -2374,8 +2346,8 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
         readonly label: string;
         readonly id: string;
         readonly type: "tabGroup";
-        readonly required: boolean;
         readonly description?: string | undefined;
+        readonly required: boolean;
         readonly ui?: {
             widget?: string | undefined;
             preset?: "disclosure" | undefined;
@@ -4796,8 +4768,8 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
         label: string;
         id: string;
         type: "repeater";
-        required: boolean;
         description?: string | undefined;
+        required: boolean;
         minItems: number;
         maxItems?: number | undefined;
         visibleRoles?: ("admin" | "designer" | "author")[] | undefined;
@@ -4929,8 +4901,8 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
         label: string;
         id: string;
         type: "group";
-        required: boolean;
         description?: string | undefined;
+        required: boolean;
         visibleRoles?: ("admin" | "designer" | "author")[] | undefined;
         defaultValue?: any;
         schema: {
@@ -5052,8 +5024,8 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
         label: string;
         id: string;
         type: "modal";
-        required: boolean;
         description?: string | undefined;
+        required: boolean;
         visibleRoles?: ("admin" | "designer" | "author")[] | undefined;
         defaultValue?: any;
         schema: {
@@ -5175,8 +5147,8 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
         label: string;
         id: string;
         type: "tabGroup";
-        required: boolean;
         description?: string | undefined;
+        required: boolean;
         visibleRoles?: ("admin" | "designer" | "author")[] | undefined;
         defaultValue?: any;
         activeTabField?: string | undefined;
@@ -5301,8 +5273,8 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
         label: string;
         id: "_textCardStyles";
         type: "modal";
-        required: boolean;
         description?: string | undefined;
+        required: boolean;
         visibleRoles?: ("admin" | "designer" | "author")[] | undefined;
         defaultValue?: any;
         schema: {
@@ -5331,6 +5303,11 @@ export type MediaTextContent = {
     text: RichTextDoc;
     wrapTextInCard?: boolean | null;
     _textCardStyles?: unknown;
+    /**
+     * Compiler-owned. Media-text reads only the card role off this — its card's
+     * own styling lives in `_textCardStyles` above (issue 1297, Phase 2b).
+     */
+    _cardStyles?: CardStylesContent;
     _frameStyles?: ContentFrameIntent | null;
 };
 export declare const mediaTextBlockDefinition: SystemBlockDefinition<MediaTextContent>;

package/dist/_dts/blocks/src/system/blocks/offerings-preview/model.d.ts

@@ -28,7 +28,7 @@ export declare const OFFERINGS_PREVIEW_EVENT_PRESET_DEFINITIONS: readonly [{
 export type OfferingsPreviewEventPreset = (typeof OFFERINGS_PREVIEW_EVENT_PRESET_DEFINITIONS)[number]['preset'];
 export type OfferingsPreviewEventSourceKey = (typeof OFFERINGS_PREVIEW_EVENT_PRESET_DEFINITIONS)[number]['sourceKey'];
 export type OfferingsPreviewEventDataKey = (typeof OFFERINGS_PREVIEW_EVENT_PRESET_DEFINITIONS)[number]['dataKey'];
-export declare const OFFERINGS_PREVIEW_EVENT_PRESETS: ("performance" | "class" | "workshop" | "retreat")[];
+export declare const OFFERINGS_PREVIEW_EVENT_PRESETS: ("class" | "workshop" | "retreat" | "performance")[];
 export declare const OFFERINGS_PREVIEW_AUTHORABLE_SOURCE_KEYS: readonly [...("eventPreset:class" | "eventPreset:workshop" | "eventPreset:retreat" | "eventPreset:performance")[], "course"];
 export declare const OFFERINGS_PREVIEW_SOURCE_KEYS: readonly [...("eventPreset:class" | "eventPreset:workshop" | "eventPreset:retreat" | "eventPreset:performance")[], "course"];
 export type OfferingsPreviewSourceKey = OfferingsPreviewEventSourceKey | 'course';

package/dist/_dts/blocks/src/system/blocks/site-header.d.ts

@@ -35,7 +35,6 @@ export declare const siteHeaderManifest: import("..").DefinedBlockManifest<impor
     readonly paletteHidden: true;
 }>>;
 export type SiteHeaderManifest = typeof siteHeaderManifest;
-export type SiteHeaderVariant = 'classic' | 'centered' | 'transparent' | 'floating';
 export declare const SITE_HEADER_MODES: readonly ["default", "hidden"];
 export type SiteHeaderMode = (typeof SITE_HEADER_MODES)[number];
 export type SiteHeaderContent = Readonly<{

package/dist/_dts/blocks/src/system/blocks/team-members.d.ts

@@ -1,6 +1,7 @@
+import { type BlockManifest } from "../manifest/schema";
 import type { SystemBlockDefinition } from "../registry";
+import { type CardStylesContent } from "../fields/boxStyles";
 import type { SemanticSpacing } from "../spacing";
-import type { NodeDefinition } from "../node";
 import { type ImageColSize } from "../fields/imageLayout";
 import type { PublicTeamMemberPhoto } from "./shared/teamMembers";
 type ThumbnailShape = "round" | "rounded" | "square";
@@ -9,68 +10,7 @@ type LayoutWidth = "full" | "lg-3-4-left";
 type ThumbnailPadding = "none" | "sm" | "md" | "lg";
 type StackImagePosition = "left" | "right" | "alternate";
 type StackContentAlignment = "top" | "center";
-export declare const teamMembersManifest: import("..").DefinedBlockManifest<import("..").BlockContentShapeInput<{
-    readonly id: "block.team-members";
-    readonly title: "Team Members";
-    readonly category: "content";
-    readonly contentSource: {
-        readonly kind: "mixed";
-    };
-    readonly titleSource: "heading";
-    readonly additionalFields: readonly [import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, {
-        readonly ui: {
-            readonly intent: "content";
-            readonly visibleWhen: {
-                readonly field: "source";
-                readonly equals: "manual";
-            };
-        };
-        readonly label: string;
-        readonly id: string;
-        readonly type: "repeater";
-        readonly required: boolean;
-        readonly description?: string | undefined;
-        readonly minItems: number;
-        readonly maxItems?: number | undefined;
-        readonly visibleRoles?: ("admin" | "designer" | "author")[] | undefined;
-        readonly defaultValue?: any;
-        readonly itemLabel: string;
-        readonly itemLabelSource?: string | undefined;
-        readonly showSummary?: boolean | undefined;
-        readonly summaryFields?: string[] | undefined;
-        readonly summaryMaxChars?: number | undefined;
-        readonly polymorphic?: boolean | undefined;
-        readonly allowConversion: boolean;
-        readonly schema?: {
-            fields: import("../../../../block-form/src/backend/index").FieldDefinition[];
-        };
-        readonly itemTypes?: Record<string, import("..").ItemTypeDefinition>;
-    }];
-    readonly layout: NodeDefinition;
-    readonly variants: {
-        readonly grid: NodeDefinition;
-        readonly stack: NodeDefinition;
-    };
-    readonly defaultVariant: "grid";
-    readonly variantOptions: {
-        readonly grid: {
-            readonly label: "Grid";
-            readonly description: "Members in a responsive grid";
-            readonly icon: "Grid3X3";
-        };
-        readonly stack: {
-            readonly label: "Stack";
-            readonly description: "Members in a stacked list with photo + bio";
-            readonly icon: "List";
-        };
-    };
-    readonly description: "Show your team members in a grid or stacked list.";
-    readonly tags: readonly ["team", "people", "members"];
-    readonly icon: "Users";
-    readonly styleTokens: {
-        readonly spacing: "lg";
-    };
-}>>;
+export declare const teamMembersManifest: BlockManifest;
 type ManualTeamMemberItem = {
     _type: "teamMember";
     name: string;
@@ -91,6 +31,7 @@ type TeamMembersCommonContent = {
     stackContentAlignment?: StackContentAlignment | null;
     columns?: string | number | null;
     gap?: SemanticSpacing;
+    _cardStyles?: CardStylesContent;
 };
 export type TeamMembersContent = (TeamMembersCommonContent & {
     source?: "manual" | null;

package/dist/_dts/blocks/src/system/customize/backgrounds.d.ts

@@ -1,5 +1,5 @@
 import { type MediaAssetId } from '../../../../core/src/index';
-import { type ThemeBackgroundTextLegibilityPlan, type AppearancePresetId, type LayoutVariantKey, type PageDesignEditorBackgroundSupport } from '../../../../theme-core/src/site-styles/index';
+import { type AppearancePresetId, type LayoutVariantKey, type PageDesignEditorBackgroundSupport } from '../../../../theme-core/src/site-styles/index';
 import type { ThemeColorToken } from '../../../../theme-core/src/tokens/index';
 import { type GradientPresetId } from '../../../../theme-core/src/gradients/index';
 import type { RenderableMediaAsset } from '../../../../media-core/src/index';
@@ -177,8 +177,6 @@ export declare const recommendedBackgroundColorTokens: readonly BackgroundColorT
 export declare const advancedBackgroundColorTokens: BackgroundColorToken[];
 export declare function parseBackgroundColorToken(value: unknown): BackgroundColorToken | null;
 export declare function isBackgroundColorToken(value: unknown): value is BackgroundColorToken;
-export declare function foregroundTokenForBackgroundColorToken(token: BackgroundColorToken): string;
-export declare function planBackgroundColorTextLegibility(token: BackgroundColorToken): ThemeBackgroundTextLegibilityPlan;
 export declare function dedupeBackgroundColorTokensByPalette(tokens: readonly BackgroundColorToken[], palette: BackgroundColorPalette): readonly BackgroundColorToken[];
 export declare function backgroundModeForOverride(override: BackgroundOverride): BackgroundMode;
 export declare function backgroundOverrideEquals(left: BackgroundOverride, right: BackgroundOverride): boolean;

package/dist/_dts/blocks/src/system/fields/boxStyles.d.ts

@@ -1,5 +1,6 @@
 import type { ModalFieldDefinition } from '../manifest/schema';
 import type { AccordionIconTreatment, EyebrowTreatment, EventListTreatment, HeadingDecorationOverride, TileTreatment } from '../../../../theme-core/src/site-styles/index';
+import { type CardRole } from '../../../../theme-core/src/cards/index';
 import type { BackgroundContent } from './backgroundContent';
 /**
  * Options for customizing a section styles field.
@@ -49,6 +50,12 @@ type CardStylesOptions = {
     label?: string;
     /** Whether to include background field (default: true) */
     includeBackground?: boolean;
+    /**
+     * Expose only the semantic role selector. This is for blocks such as events
+     * that let authors choose a site-style card role without exposing a second
+     * set of visual identity controls.
+     */
+    controls?: 'overrides' | 'role-only';
 } & BoxStylesUiOptions;
 /**
  * Content type for section styles field (_sectionStyles).
@@ -84,8 +91,12 @@ export type CardStylesContent = {
     spacing?: string | null;
     raised?: boolean | null;
     rounded?: string | null;
-    cardVariant?: string | null;
-    treatment?: 'accent-quote' | 'editorial-rule' | 'soft-panel' | 'editorial-serif-quote' | 'editorial-open' | null;
+    /**
+     * The card role the block's Look asked for. Compiled by the site-style
+     * runtime; the site style owns what the role looks like. The one field that
+     * names a card surface.
+     */
+    role?: CardRole | null;
 } | null;
 export type ContainerStylesContent = {
     background?: BackgroundContent | null;

package/dist/_dts/blocks/src/system/fields/gridLayout.d.ts

@@ -0,0 +1,20 @@
+import { type FieldDefinition } from "../manifest/schema";
+type FieldUi = NonNullable<FieldDefinition["ui"]>;
+type FieldVisibleWhen = FieldUi["visibleWhen"];
+type SharedSelectOptions = Readonly<{
+    label?: string;
+    description?: string;
+    defaultValue?: string;
+    visibleWhen?: FieldVisibleWhen;
+}>;
+/**
+ * Grid `userColumns` binding for blocks with a user-configured column count.
+ * The count renders through the canonical responsive ladder — see
+ * {@link gridUserColumnLadder}.
+ */
+export declare function userColumnsGridBinding(): Record<string, unknown>;
+/** Shared "Columns" select (2/3/4) for grid-layout blocks. */
+export declare function columnsSelectField(options?: SharedSelectOptions): FieldDefinition;
+/** Shared semantic "Gap" select for layout blocks. */
+export declare function gapSelectField(options?: SharedSelectOptions): FieldDefinition;
+export {};

package/dist/_dts/blocks/src/system/node/fragments/classNameBinding.d.ts

@@ -1,9 +1,14 @@
 import type { Binding } from "../schema";
+/**
+ * A class name resolved from a binding. `$prepend` / `$append` are read by the
+ * resolver for string composition; a fallback belongs *inside* `$bind`, where
+ * the resolver actually reads it — a sibling `fallback` here was silently
+ * ignored, so the field is gone rather than looking load-bearing.
+ */
 export type BoundClassName = Readonly<{
     $bind: Binding;
     $prepend?: string;
     $append?: string;
-    fallback?: string;
 }>;
 export type ClassNameBinding = string | BoundClassName;
 export declare function prependClassName(className: string, value: ClassNameBinding): ClassNameBinding;

package/dist/_dts/blocks/src/system/node/fragments/styledCard.d.ts

@@ -1,12 +1,43 @@
 import type { CSSProperties } from "react";
 import type { NodeDefinition } from "../schema";
 import { type NodeModifier } from "../builder";
+import type { BoundClassName } from "./classNameBinding";
 type StyledCardDataProps = Readonly<Record<`data-${string}`, unknown>>;
+/** Where a block's per-item surface choice lives, and how it maps to roles. */
+export type ItemCardRoleBinding = Readonly<{
+    /** Binding path to the item's own surface value (e.g. `card.surfaceRole`). */
+    from: string;
+    /** The block's persisted per-item vocabulary, mapped onto card roles. */
+    aliases?: Readonly<Record<string, string>>;
+}>;
+/**
+ * The shared child hooks generated card CSS targets (`.card-media`,
+ * `.card-content`). They join the class list only while a card role is in play,
+ * so cards still on the legacy treatment path keep their exact classes.
+ *
+ * Blocks whose items each choose a surface pass `itemRole` so the hook follows
+ * the item's choice; blocks with one surface per block bind from the card
+ * styles themselves (the transform reads the role off `stylesFrom` and ignores
+ * a non-string bound value), which keeps one emission path for both shapes.
+ */
+export declare function cardRoleChildClass(input: Readonly<{
+    emit: "media" | "content";
+    baseClass: string;
+    /** Where the block's compiled card styles live (e.g. `content._cardStyles`). */
+    stylesFrom: string;
+    itemRole?: ItemCardRoleBinding;
+}>): BoundClassName;
 export declare function styledCard(children: Array<NodeDefinition | null | undefined>, opts: {
     stylesFrom: string;
     backgroundFrom: string;
     baseClassName?: string;
     style?: CSSProperties;
     dataProps?: StyledCardDataProps;
+    /**
+     * Blocks whose items each choose a card surface bind the class list from
+     * the per-item role instead, so the item's choice can override the role
+     * the block's Look compiled. See `cardRoleClass` in feature-cards.
+     */
+    itemRole?: ItemCardRoleBinding;
 }, ...mods: NodeModifier[]): NodeDefinition;
 export {};

package/dist/_dts/blocks/src/system/node/validation-constants.d.ts

@@ -20,7 +20,7 @@ export type AllowedNodeType = (typeof ALLOWED_NODE_TYPES)[number];
  * $bind.transforms within custom block layouts. Transform IDs
  * not in this list will be rejected during validation.
  */
-export declare const ALLOWED_TRANSFORM_IDS: readonly ["string.uppercase", "value.fallback", "date.formatShort", "array.length", "value.jsonArray", "value.csv", "array.marqueeLoop", "value.mapToken", "layout.maxWidthClass", "layout.headerRootClass", "layout.footerRootClass", "layout.headerRootStyle", "layout.headerSectionBackground", "layout.classicNavMode", "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", "ui.imageGalleryFilterClass", "ui.imageGalleryTileClass", "ui.imageGalleryTileStyle", "ui.imageGalleryMarqueeTileStyle", "ui.imageGalleryMarqueeDuration", "ui.imageGalleryMarqueeDirection", "ui.imageFragmentClass", "ui.imageFragmentSize", "media.fromUrl", "background.resolveStyle", "background.resolveColorsStyle", "background.resolveFrameClassName", "background.resolveImageStyle", "background.resolveImageClassName", "background.resolveOverlayStyle", "links.resolve", "links.label", "content.interpolateRichTextTokens", "boxStyles.spacing", "boxStyles.resolveRootClass", "boxStyles.resolveRootStyle", "boxStyles.semanticGap", "boxStyles.semanticGapValue", "boxStyles.cardVariantClass", "containerStyles.resolveBoxClassName"];
+export declare const ALLOWED_TRANSFORM_IDS: readonly ["string.uppercase", "value.fallback", "date.formatShort", "array.length", "value.jsonArray", "value.csv", "array.marqueeLoop", "value.mapToken", "layout.maxWidthClass", "layout.headerRootClass", "layout.footerRootClass", "layout.headerRootStyle", "layout.headerSectionBackground", "layout.classicNavMode", "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", "ui.imageGalleryFilterClass", "ui.imageGalleryTileClass", "ui.imageGalleryTileStyle", "ui.imageGalleryMarqueeTileStyle", "ui.imageGalleryMarqueeDuration", "ui.imageGalleryMarqueeDirection", "ui.imageFragmentClass", "ui.imageFragmentSize", "media.fromUrl", "background.resolveStyle", "background.resolveColorsStyle", "background.resolveFrameClassName", "background.resolveImageStyle", "background.resolveImageClassName", "background.resolveOverlayStyle", "links.resolve", "links.label", "content.interpolateRichTextTokens", "boxStyles.spacing", "boxStyles.resolveRootClass", "boxStyles.resolveRootStyle", "boxStyles.semanticGap", "boxStyles.semanticGapValue", "containerStyles.resolveBoxClassName"];
 export type AllowedTransformId = (typeof ALLOWED_TRANSFORM_IDS)[number];
 /**
  * Set for O(1) lookup of allowed node types.