@riverbankcms/sdk 0.130.0 → 0.130.2

package/dist/_dts/blocks/src/system/blocks/events/shared/schemas.d.ts

@@ -2,6 +2,7 @@ import { z } from 'zod';
 export declare const eventPresetSchema: z.ZodEnum<{
     course: "course";
     event: "event";
+    term: "term";
     performance: "performance";
     class: "class";
     workshop: "workshop";
@@ -367,6 +368,24 @@ export declare const publicTeamMemberSummarySchema: z.ZodObject<{
     summary: z.ZodNullable<z.ZodString>;
     profilePath: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+export declare const publicEventBookingAvailabilitySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"open">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"closed">;
+    reason: z.ZodEnum<{
+        occurrence_cancelled: "occurrence_cancelled";
+        occurrence_completed: "occurrence_completed";
+        series_draft: "series_draft";
+        series_cancelled: "series_cancelled";
+        series_completed: "series_completed";
+        series_archived: "series_archived";
+        parent_archived: "parent_archived";
+        parent_inconsistent: "parent_inconsistent";
+        not_public: "not_public";
+        already_started: "already_started";
+        enrollment_closed: "enrollment_closed";
+    }>;
+}, z.core.$strip>], "kind">;
 /**
  * Zod schema for public event data
  */
@@ -378,6 +397,7 @@ export declare const publicEventSchema: z.ZodObject<{
     eventPreset: z.ZodOptional<z.ZodEnum<{
         course: "course";
         event: "event";
+        term: "term";
         performance: "performance";
         class: "class";
         workshop: "workshop";
@@ -692,6 +712,24 @@ export declare const publicEventSchema: z.ZodObject<{
         label: z.ZodString;
     }, z.core.$strip>], "kind">;
     requiresRegistration: z.ZodBoolean;
+    bookingAvailability: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"open">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"closed">;
+        reason: z.ZodEnum<{
+            occurrence_cancelled: "occurrence_cancelled";
+            occurrence_completed: "occurrence_completed";
+            series_draft: "series_draft";
+            series_cancelled: "series_cancelled";
+            series_completed: "series_completed";
+            series_archived: "series_archived";
+            parent_archived: "parent_archived";
+            parent_inconsistent: "parent_inconsistent";
+            not_public: "not_public";
+            already_started: "already_started";
+            enrollment_closed: "enrollment_closed";
+        }>;
+    }, z.core.$strip>], "kind">;
     deliveryMode: z.ZodEnum<{
         in_person: "in_person";
         hybrid: "hybrid";
@@ -738,6 +776,8 @@ export declare const publicEventSchema: z.ZodObject<{
         active: "active";
         draft: "draft";
         archived: "archived";
+        completed: "completed";
+        cancelled: "cancelled";
     }>>;
     timeZone: z.ZodString;
     pricing: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1050,6 +1090,7 @@ export declare const publicEventsArraySchema: z.ZodArray<z.ZodObject<{
     eventPreset: z.ZodOptional<z.ZodEnum<{
         course: "course";
         event: "event";
+        term: "term";
         performance: "performance";
         class: "class";
         workshop: "workshop";
@@ -1364,6 +1405,24 @@ export declare const publicEventsArraySchema: z.ZodArray<z.ZodObject<{
         label: z.ZodString;
     }, z.core.$strip>], "kind">;
     requiresRegistration: z.ZodBoolean;
+    bookingAvailability: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"open">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"closed">;
+        reason: z.ZodEnum<{
+            occurrence_cancelled: "occurrence_cancelled";
+            occurrence_completed: "occurrence_completed";
+            series_draft: "series_draft";
+            series_cancelled: "series_cancelled";
+            series_completed: "series_completed";
+            series_archived: "series_archived";
+            parent_archived: "parent_archived";
+            parent_inconsistent: "parent_inconsistent";
+            not_public: "not_public";
+            already_started: "already_started";
+            enrollment_closed: "enrollment_closed";
+        }>;
+    }, z.core.$strip>], "kind">;
     deliveryMode: z.ZodEnum<{
         in_person: "in_person";
         hybrid: "hybrid";
@@ -1410,6 +1469,8 @@ export declare const publicEventsArraySchema: z.ZodArray<z.ZodObject<{
         active: "active";
         draft: "draft";
         archived: "archived";
+        completed: "completed";
+        cancelled: "cancelled";
     }>>;
     timeZone: z.ZodString;
     pricing: z.ZodDiscriminatedUnion<[z.ZodObject<{

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

@@ -1,7 +1,7 @@
 /**
  * Shared types for event display blocks
  */
-import type { LocationCoordinates, PublicEventPricing, PublicEventPricingType } from '../../../../../../core/src/index';
+import type { LocationCoordinates, PublicEventPricing, PublicEventPricingType, PublicEventBookingAvailability } from '../../../../../../core/src/index';
 import type { Media } from '../../../../lib/media';
 import type { RichTextDoc } from '../../../manifest/richTextSchema';
 import type { BlockBookingPaymentTerms } from '../../shared/bookingPaymentTerms';
@@ -39,13 +39,13 @@ export type PricingType = PublicEventPricingType;
 /**
  * Access restriction type for events
  */
-export type AccessRestriction = "none" | "category";
+export type AccessRestriction = 'none' | 'category';
 export type PublicEventDestination = Readonly<{
-    kind: "native";
-    mode: "cms-managed" | "system-managed";
+    kind: 'native';
+    mode: 'cms-managed' | 'system-managed';
     path: string;
 }> | Readonly<{
-    kind: "external";
+    kind: 'external';
     url: string;
     label: string;
 }>;
@@ -58,11 +58,11 @@ export type PublicEventRecurrence = Readonly<{
     kind: 'other';
 }>;
 export type PublicEventTicketTypeAvailability = {
-    kind: "available";
+    kind: 'available';
     remainingCapacity: number | null;
 } | {
-    kind: "unavailable";
-    reason: "inactive" | "not_on_sale_yet" | "sale_ended" | "sold_out" | "event_sold_out";
+    kind: 'unavailable';
+    reason: 'inactive' | 'not_on_sale_yet' | 'sale_ended' | 'sold_out' | 'event_sold_out';
     remainingCapacity: number | null;
 };
 export type PublicEventTicketType = {
@@ -74,16 +74,16 @@ export type PublicEventTicketType = {
     priceAmount: number;
     isActive: boolean;
     sortOrder: number;
-    capacityMode: "limited" | "unlimited";
+    capacityMode: 'limited' | 'unlimited';
     capacityLimit: number | null;
-    attendanceScope?: "in_person" | "online" | "both";
+    attendanceScope?: 'in_person' | 'online' | 'both';
     saleStartsAt: string | null;
     saleEndsAt: string | null;
     availability: PublicEventTicketTypeAvailability;
     createdAt: string;
     updatedAt: string;
 };
-export type PublicEventAttendanceMode = "in_person" | "online";
+export type PublicEventAttendanceMode = 'in_person' | 'online';
 export type PublicEventAttendanceModeAvailability = {
     mode: PublicEventAttendanceMode;
     capacity: number | null;
@@ -97,15 +97,15 @@ export type PublicEventAttendanceModeAvailability = {
  */
 export type PublicEvent = {
     /** Canonical registration scope for this occurrence's series. */
-    bookingScope: "single_occurrence" | "whole_series";
+    bookingScope: 'single_occurrence' | 'whole_series';
     /** Canonical event-series preset when this is an event occurrence. */
-    eventPreset?: "event" | EventSurfacePreset;
+    eventPreset?: 'event' | EventSurfacePreset;
     /** Resolved destination mode for the event series. */
-    eventDestinationMode?: "cms-managed" | "system-managed";
+    eventDestinationMode?: 'cms-managed' | 'system-managed';
     /** Public navigation destination for cards/details CTAs. */
     destination: PublicEventDestination;
     /** Whether this occurrence belongs to a recurring or one-off series. */
-    scheduleScope?: Exclude<EventScheduleScope, "any">;
+    scheduleScope?: Exclude<EventScheduleScope, 'any'>;
     /** Safe, normalized recurrence evidence when the series owns a recurrence rule. */
     recurrence?: PublicEventRecurrence;
     id: string;
@@ -127,8 +127,10 @@ export type PublicEvent = {
     path: string | null;
     /** Whether this event requires registration (drop-in events return false). */
     requiresRegistration: boolean;
+    /** Canonical lifecycle admission; display remains independent from booking. */
+    bookingAvailability: PublicEventBookingAvailability;
     /** How people can attend this event. */
-    deliveryMode: "in_person" | "online" | "hybrid";
+    deliveryMode: 'in_person' | 'online' | 'hybrid';
     /** Per-mode availability used by registration flows. */
     attendanceModes: PublicEventAttendanceModeAvailability[];
     startsAt: string;
@@ -143,7 +145,7 @@ export type PublicEvent = {
     eventCategory: EventCategory | null;
     teamMembers?: PublicTeamMemberSummary[];
     /** Event series status: 'active' events accept registrations, 'draft' events only in preview mode */
-    status?: "active" | "draft" | "archived";
+    status?: 'active' | 'draft' | 'cancelled' | 'completed' | 'archived';
     /** Effective IANA timezone identifier for this event (venue override > site default). */
     timeZone: string;
     /** Canonical pricing model derived by the public API boundary. */
@@ -180,7 +182,7 @@ export type EventCardVariantInput = CardVariant | LegacyEventCardVariant;
  * - vertical: Standard card layout with image on top (grid mode)
  * - horizontal: Image on left, content on right (stack mode)
  */
-export type CardOrientation = "vertical" | "horizontal";
+export type CardOrientation = 'vertical' | 'horizontal';
 /**
  * Button variant options for event actions
  */
@@ -192,7 +194,7 @@ export type EventLayout = (typeof eventCalendarListLayoutValues)[number];
 /**
  * Column options for grid layouts
  */
-export type ColumnOption = "2" | "3" | "4";
+export type ColumnOption = '2' | '3' | '4';
 /**
  * Calendar view options
  */
@@ -200,7 +202,7 @@ export type CalendarView = (typeof eventCalendarDefaultViewValues)[number];
 /**
  * Week start day options
  */
-export type WeekStart = "sunday" | "monday";
+export type WeekStart = 'sunday' | 'monday';
 /**
  * Display mode options for the enhanced event-calendar block
  * - combined: Tabbed view with List + Calendar tabs (default)
@@ -215,12 +217,12 @@ export type DisplayMode = (typeof eventCalendarDisplayModeValues)[number];
  * - always: Always show filter
  * - never: Never show filter
  */
-export type FilterAutoShow = "auto" | "always" | "never";
+export type FilterAutoShow = 'auto' | 'always' | 'never';
 /**
  * Calendar tab view options for Combined mode
  * - both: Show toggle for month/week
  * - month: Month view only
  * - week: Week view only
  */
-export type CalendarTabViews = "both" | "month" | "week";
+export type CalendarTabViews = 'both' | 'month' | 'week';
 export type { EventScheduleScope, EventSurfacePreset, EventSurfaceScope };

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;
@@ -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/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.
@@ -84,8 +85,19 @@ export type CardStylesContent = {
     spacing?: string | null;
     raised?: boolean | null;
     rounded?: string | 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;
+    /**
+     * Legacy name for `role` — it only ever held role names. Read-only history:
+     * content persisted before the role contract still carries it, and it reads
+     * as a role at the render boundary (`resolveCardRoleForBoxStyles`), where an
+     * explicit `role` wins.
+     */
     cardVariant?: string | null;
-    treatment?: 'accent-quote' | 'editorial-rule' | 'soft-panel' | 'editorial-serif-quote' | 'editorial-open' | 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/runtime/api/endpoints.d.ts

@@ -86,6 +86,7 @@ export declare const EVENTS: {
         path: string;
         method: "POST";
         authScope: "portal";
+        skipPreviewStage: true;
     };
     checkout: {
         path: string;
@@ -110,6 +111,7 @@ export declare const WHOLE_SERIES: {
         path: string;
         method: "POST";
         authScope: "portal";
+        skipPreviewStage: true;
     };
     checkout: {
         path: string;
@@ -432,6 +434,7 @@ export declare const ENDPOINTS: {
             path: string;
             method: "POST";
             authScope: "portal";
+            skipPreviewStage: true;
         };
         checkout: {
             path: string;
@@ -456,6 +459,7 @@ export declare const ENDPOINTS: {
             path: string;
             method: "POST";
             authScope: "portal";
+            skipPreviewStage: true;
         };
         checkout: {
             path: string;

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

@@ -15,7 +15,6 @@ export interface WholeSeriesRegistrationRequest {
     phone?: string;
     formData?: Record<string, unknown>;
     altchaSolution?: string | null;
-    stage?: "preview" | "published";
     paymentMethod?: Exclude<CoursePaymentMethod, "stripe">;
     customerMembershipId?: string;
     claimToken?: string;

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

@@ -117,7 +117,6 @@ export interface EventRegisterRequest {
     phone?: string;
     notes?: string;
     altchaSolution?: string | null;
-    stage?: "preview" | "published";
     paymentMethod?: PaymentMethod;
     customerPassId?: string;
     customerMembershipId?: string;

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

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