@riverbankcms/sdk 0.104.3 → 0.107.0

package/dist/_dts/blocks/src/system/blocks/events/recurring-schedule-projection.d.ts

@@ -0,0 +1,52 @@
+import { type EventSeriesId } from '../../../../../core/src/index';
+import { z } from 'zod';
+import type { PublicEvent, PublicEventDestination } from './shared/types';
+declare const weekdayOrder: readonly ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
+export type RecurringScheduleWeekday = (typeof weekdayOrder)[number];
+export type RecurringScheduleCadence = Readonly<{
+    kind: 'weekly';
+    weekday: RecurringScheduleWeekday;
+    weekdayIndex: number;
+    startTime: string;
+    endTime: string;
+    timeZone: string;
+}>;
+export type RecurringScheduleBooking = Readonly<{
+    kind: 'available';
+    destination: PublicEventDestination;
+}> | Readonly<{
+    kind: 'unavailable';
+    reason: 'missing_destination';
+}>;
+export type RecurringScheduleItem = Readonly<{
+    seriesId: EventSeriesId;
+    title: string;
+    venueName: string | null;
+    cadence: RecurringScheduleCadence;
+    booking: RecurringScheduleBooking;
+}>;
+export type RecurringScheduleDiagnostic = Readonly<{
+    seriesId: string;
+    reason: 'invalid_series_id' | 'insufficient_evidence' | 'inconsistent_weekday' | 'inconsistent_local_time' | 'inconsistent_weekly_interval' | 'inconsistent_recurrence' | 'unsupported_weekly_cadence' | 'inconsistent_timezone';
+}>;
+export type RecurringScheduleProjection = Readonly<{
+    items: readonly RecurringScheduleItem[];
+    diagnostics: readonly RecurringScheduleDiagnostic[];
+}>;
+export declare const recurringScheduleProjectionSchema: z.ZodType<RecurringScheduleProjection>;
+export type RecurringScheduleEventEvidence = Readonly<{
+    destination: PublicEventDestination;
+    endsAt: string;
+    occurrenceId: string;
+    recurrence?: PublicEvent['recurrence'];
+    scheduleScope?: PublicEvent['scheduleScope'];
+    seriesId: string;
+    startsAt: string;
+    timeZone?: string;
+    title: string;
+    venue: Readonly<{
+        name: string;
+    }> | null;
+}>;
+export declare function projectRecurringSchedule(events: readonly RecurringScheduleEventEvidence[]): RecurringScheduleProjection;
+export {};

package/dist/_dts/blocks/src/system/blocks/events/recurring-schedule.d.ts

@@ -0,0 +1,22 @@
+import type { SystemBlockDefinition } from '../../registry';
+import type { TipTapNode } from '../../manifest/richTextSchema';
+import type { LinkValue } from '../../types/link';
+import { type BlockConfig, type BlockContentShapeInput, type DefinedBlockManifest } from '../../defineBlock';
+import { type SectionStylesContent } from '../../fields/boxStyles';
+export { projectRecurringSchedule, recurringScheduleProjectionSchema, } from './recurring-schedule-projection';
+export type { RecurringScheduleBooking, RecurringScheduleCadence, RecurringScheduleDiagnostic, RecurringScheduleItem, RecurringScheduleProjection, } from './recurring-schedule-projection';
+export declare const recurringScheduleManifest: DefinedBlockManifest<BlockContentShapeInput<BlockConfig>>;
+export type RecurringScheduleContent = Readonly<{
+    eyebrow?: string | null;
+    heading?: string | null;
+    description?: TipTapNode | null;
+    showVenue?: boolean | null;
+    buttonVariant?: 'primary' | 'secondary' | 'outline' | 'link' | null;
+    seeAllButtonVariant?: 'primary' | 'secondary' | 'outline' | 'link' | null;
+    buttonText?: string | null;
+    seeAllUrl?: LinkValue | null;
+    seeAllLabel?: string | null;
+    emptyMessage?: string | null;
+    _sectionStyles?: SectionStylesContent;
+}>;
+export declare const recurringScheduleBlockDefinition: SystemBlockDefinition<RecurringScheduleContent>;

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

@@ -10,6 +10,21 @@ export declare const eventScheduleScopeSchema: z.ZodEnum<{
     recurring: "recurring";
     oneOff: "oneOff";
 }>;
+export declare const publicEventRecurrenceSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"weekly">;
+    interval: z.ZodNumber;
+    weekdays: z.ZodArray<z.ZodEnum<{
+        MO: "MO";
+        TU: "TU";
+        WE: "WE";
+        TH: "TH";
+        FR: "FR";
+        SA: "SA";
+        SU: "SU";
+    }>>;
+}, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"other">;
+}, z.core.$strip>>], "kind">;
 export declare const eventDestinationModeSchema: z.ZodEnum<{
     "cms-managed": "cms-managed";
     "system-managed": "system-managed";
@@ -374,6 +389,21 @@ export declare const publicEventSchema: z.ZodObject<{
         recurring: "recurring";
         oneOff: "oneOff";
     }>>;
+    recurrence: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"weekly">;
+        interval: z.ZodNumber;
+        weekdays: z.ZodArray<z.ZodEnum<{
+            MO: "MO";
+            TU: "TU";
+            WE: "WE";
+            TH: "TH";
+            FR: "FR";
+            SA: "SA";
+            SU: "SU";
+        }>>;
+    }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"other">;
+    }, z.core.$strip>>], "kind">>;
     id: z.ZodString;
     occurrenceId: z.ZodString;
     seriesId: z.ZodString;
@@ -1034,6 +1064,21 @@ export declare const publicEventsArraySchema: z.ZodArray<z.ZodObject<{
         recurring: "recurring";
         oneOff: "oneOff";
     }>>;
+    recurrence: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"weekly">;
+        interval: z.ZodNumber;
+        weekdays: z.ZodArray<z.ZodEnum<{
+            MO: "MO";
+            TU: "TU";
+            WE: "WE";
+            TH: "TH";
+            FR: "FR";
+            SA: "SA";
+            SU: "SU";
+        }>>;
+    }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"other">;
+    }, z.core.$strip>>], "kind">>;
     id: z.ZodString;
     occurrenceId: z.ZodString;
     seriesId: z.ZodString;

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

@@ -48,6 +48,14 @@ export type PublicEventDestination = Readonly<{
     url: string;
     label: string;
 }>;
+export type PublicEventRecurrenceWeekday = 'MO' | 'TU' | 'WE' | 'TH' | 'FR' | 'SA' | 'SU';
+export type PublicEventRecurrence = Readonly<{
+    kind: 'weekly';
+    interval: number;
+    weekdays: readonly PublicEventRecurrenceWeekday[];
+}> | Readonly<{
+    kind: 'other';
+}>;
 export type PublicEventTicketTypeAvailability = {
     kind: "available";
     remainingCapacity: number | null;
@@ -97,6 +105,8 @@ export type PublicEvent = {
     destination: PublicEventDestination;
     /** Whether this occurrence belongs to a recurring or one-off series. */
     scheduleScope?: Exclude<EventScheduleScope, "any">;
+    /** Safe, normalized recurrence evidence when the series owns a recurrence rule. */
+    recurrence?: PublicEventRecurrence;
     id: string;
     /** Always the occurrence ID (stable pagination cursor) */
     occurrenceId: string;

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

@@ -6,10 +6,12 @@ import { type StandardAspectRatio } from "../fields/aspectRatio";
 import { type BlockCtaContent } from "../fields/ctas";
 import type { BlockIconValue, SemanticIconId } from "../icons";
 import { type FeatureCardIconTreatment } from "./feature-card-icons";
-type FeatureCardsVariant = "cards";
+type FeatureCardsVariant = "cards" | "editorial-diptych" | "editorial-pathways";
 type FeatureCardsColumns = "2" | "3" | "4";
+export type FeatureCardSurfaceRole = "open" | "panel";
 export declare const featureCardsManifest: DefinedBlockManifest<BlockContentShapeInput<BlockConfig>>;
 export type FeatureCard = {
+    surfaceRole?: FeatureCardSurfaceRole | null;
     media?: Media | null;
     aspectRatio?: StandardAspectRatio | null;
     icon?: BlockIconValue | SemanticIconId | null;
@@ -20,6 +22,7 @@ export type FeatureCard = {
 export type FeatureCardsCardMarker = "icons" | "numbers" | "none";
 export type FeatureCardsContent = {
     variant?: FeatureCardsVariant | null;
+    eyebrow?: string | null;
     title?: string | null;
     description?: TipTapNode | null;
     columns?: FeatureCardsColumns | null;

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

@@ -42,6 +42,7 @@ export * from "./event-details";
 export * from "./course-registration";
 export * from "./course-details";
 export * from "./events";
+export * from "./events/recurring-schedule";
 export * from "./embed";
 export * from "./team-members";
 export * from "./image-gallery";

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

@@ -66,6 +66,14 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
         readonly required: false;
         readonly multiline: false;
         readonly maxLength: 120;
+    }, {
+        readonly id: "eyebrow";
+        readonly type: "text";
+        readonly label: "Eyebrow";
+        readonly description: "Optional short label above the title";
+        readonly required: false;
+        readonly multiline: false;
+        readonly maxLength: 80;
     }, {
         readonly id: "titleAlignment";
         readonly type: "select";
@@ -5257,6 +5265,7 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
 }>>;
 export type MediaTextContent = {
     title?: string | null;
+    eyebrow?: string | null;
     titleAlignment?: MediaTextAlignment | null;
     imagePosition?: MediaTextImagePosition | null;
     gap?: SemanticSpacing | null;

package/dist/_dts/blocks/src/system/blocks/newsletter-signup.d.ts

@@ -31,7 +31,7 @@ export declare const newsletterSignupManifest: import("..").DefinedBlockManifest
                 readonly label: "Send signups to";
                 readonly description: "Choose where new subscribers from this form should go.";
                 readonly defaultValue: "riverbank";
-                readonly required: true;
+                readonly required: false;
                 readonly ui: {
                     readonly intent: "behavior";
                 };
@@ -117,7 +117,7 @@ export declare const newsletterSignupManifest: import("..").DefinedBlockManifest
                 readonly type: "text";
                 readonly label: "Button label";
                 readonly defaultValue: "Subscribe";
-            }, {
+            }, import("../../../../block-form/src/backend/index").FieldDefinition, {
                 readonly id: "successMessage";
                 readonly type: "text";
                 readonly label: "Success message";
@@ -148,6 +148,7 @@ export declare const newsletterSignupManifest: import("..").DefinedBlockManifest
     readonly variants: {
         readonly stacked: import("..").NodeDefinition;
         readonly inline: import("..").NodeDefinition;
+        readonly "editorial-split": import("..").NodeDefinition;
     };
     readonly defaultVariant: "stacked";
     readonly variantOptions: {
@@ -159,6 +160,10 @@ export declare const newsletterSignupManifest: import("..").DefinedBlockManifest
             readonly label: "Inline";
             readonly description: "Horizontal layout (email + button side by side)";
         };
+        readonly "editorial-split": {
+            readonly label: "Editorial split";
+            readonly description: "Copy and form in balanced side-by-side columns, stacked on mobile.";
+        };
     };
     readonly styleTokens: {
         readonly background: "surface";
@@ -197,6 +202,7 @@ export type NewsletterSignupContent = {
     preset: NewsletterSignupPreset;
     includePhone?: boolean | null;
     buttonLabel?: string | null;
+    buttonVariant?: 'primary' | 'secondary' | 'outline' | null;
     successMessage?: string | null;
     privacyNote?: string | null;
     tags?: string | null;

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

@@ -1,13 +1,13 @@
-import type { SystemBlockDefinition } from "../../registry";
-import type { BlockManifest } from "../../manifest";
-import { type CardStylesContent, type SectionStylesContent } from "../../fields/boxStyles";
-import type { ButtonVariant } from "../events/shared/types";
-import { type OfferingsPreviewGroupOverride, type OfferingsPreviewSourceKey } from "./model";
+import type { SystemBlockDefinition } from '../../registry';
+import type { BlockManifest } from '../../manifest';
+import { type CardStylesContent, type SectionStylesContent } from '../../fields/boxStyles';
+import type { ButtonVariant } from '../events/shared/types';
+import { type OfferingsPreviewGroupOverride, type OfferingsPreviewSourceKey } from './model';
 export declare const offeringsPreviewManifest: BlockManifest;
 export type OfferingsPreviewContent = {
     heading?: string | null;
     description?: unknown;
-    itemLimit?: "1" | "2" | "3" | "4" | "5" | "6" | null;
+    itemLimit?: '1' | '2' | '3' | '4' | '5' | '6' | null;
     groupOrder?: readonly OfferingsPreviewSourceKey[] | null;
     groupOverrides?: readonly OfferingsPreviewGroupOverride[] | null;
     _cardStyles?: CardStylesContent;
@@ -17,5 +17,5 @@ export type OfferingsPreviewContent = {
     _sectionStyles?: SectionStylesContent;
 };
 export declare const offeringsPreviewBlockDefinition: SystemBlockDefinition<OfferingsPreviewContent>;
-export type { BookingOfferingPresetSummary, OfferingsPreviewGroupOrder, OfferingsPreviewGroupOverride, OfferingsPreviewSourceKey, } from "./model";
-export { deriveDefaultOfferingsPreviewGroups, inferLegacyOfferingsPreviewGroupOrder, isOfferingsPreviewSourceKey, normalizeOfferingsPreviewContentForWrite, normalizeOfferingsPreviewGroupOrder, resolveOfferingsPreviewGroupOrderEntries, resolveOfferingsPreviewGroupKeys, } from "./model";
+export type { BookingOfferingPresetSummary, OfferingsPreviewGroupOrder, OfferingsPreviewGroupOverride, OfferingsPreviewSourceKey, } from './model';
+export { deriveDefaultOfferingsPreviewGroups, inferLegacyOfferingsPreviewGroupOrder, isOfferingsPreviewSourceKey, normalizeOfferingsPreviewContentForWrite, normalizeOfferingsPreviewGroupOrder, resolveOfferingsPreviewGroupOrderEntries, resolveOfferingsPreviewGroupKeys, } from './model';

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

@@ -1,5 +1,5 @@
-import type { PublicEvent } from "../events/shared/types";
-import type { PublicCourse } from "../courses/shared/types";
+import type { PublicEvent } from '../events/shared/types';
+import type { PublicCourse } from '../courses/shared/types';
 export declare const OFFERINGS_PREVIEW_DEFAULT_ITEM_LIMIT = "3";
 export declare const OFFERINGS_PREVIEW_DEFAULT_BUTTON_TEXT = "Book";
 export declare const OFFERINGS_PREVIEW_DEFAULT_EMPTY_MESSAGE = "Nothing scheduled just yet.";
@@ -25,26 +25,26 @@ export declare const OFFERINGS_PREVIEW_EVENT_PRESET_DEFINITIONS: readonly [{
     readonly dataKey: "performanceEvents";
     readonly label: "Performances";
 }];
-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 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_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";
+export type OfferingsPreviewSourceKey = OfferingsPreviewEventSourceKey | 'course';
 export type OfferingsPreviewSource = Readonly<{
-    kind: "eventPreset";
+    kind: 'eventPreset';
     preset: OfferingsPreviewEventPreset;
 }> | Readonly<{
-    kind: "course";
+    kind: 'course';
 }>;
-export type OfferingsPreviewCtaMode = "auto" | "custom" | "hidden";
-export type OfferingsPreviewGroupPresentation = "compact-list" | "single-card";
+export type OfferingsPreviewCtaMode = 'auto' | 'custom' | 'hidden';
+export type OfferingsPreviewGroupPresentation = 'compact-list' | 'single-card' | 'featured-summary';
 export type OfferingsPreviewRouteCandidate = Readonly<{
     entityId: string;
     path: string;
     title: string;
-    kind: "page" | "content";
+    kind: 'page' | 'content';
     contentTypeKey?: string | null;
 }>;
 export type OfferingsPreviewGroupCtaConfig = Readonly<{
@@ -56,8 +56,8 @@ export type OfferingsPreviewResolvedCta = Readonly<{
     href: string;
     label: string;
 }>;
-export type BookingOfferingCanonicalBehaviour = OfferingsPreviewEventPreset | "course" | "appointment";
-export type BookingOfferingEngine = "event_series" | "course" | "appointment_service";
+export type BookingOfferingCanonicalBehaviour = OfferingsPreviewEventPreset | 'course' | 'appointment';
+export type BookingOfferingEngine = 'event_series' | 'course' | 'appointment_service';
 export type BookingOfferingPresetSummary = Readonly<{
     id: string;
     canonicalBehaviour: BookingOfferingCanonicalBehaviour;
@@ -90,27 +90,27 @@ export type OfferingsPreviewGroupOrderEntry = Readonly<{
     override?: OfferingsPreviewGroupOverride;
 }>;
 export type OfferingsPreviewItem = Readonly<{
-    kind: "event";
+    kind: 'event';
     event: PublicEvent;
 } | {
-    kind: "course";
+    kind: 'course';
     course: PublicCourse;
     path: string | null;
 }>;
 export type OfferingsPreviewGroupItemData = Readonly<{
-    kind: "ready";
+    kind: 'ready';
     items: readonly OfferingsPreviewItem[];
 } | {
-    kind: "failed";
-    reason: "not_loaded";
+    kind: 'failed';
+    reason: 'not_loaded';
 }>;
 export type OfferingsPreviewGroupEventData = OfferingsPreviewGroupItemData;
 export type OfferingsPreviewGroupRenderState = Readonly<{
-    kind: "items";
+    kind: 'items';
     group: ResolvedOfferingsPreviewGroup;
     items: readonly OfferingsPreviewItem[];
 } | {
-    kind: "empty";
+    kind: 'empty';
     group: ResolvedOfferingsPreviewGroup;
     message: string;
 }>;
@@ -136,11 +136,11 @@ export declare function resolveOfferingsPreviewGroupKeys(input: Readonly<{
     overrides?: readonly OfferingsPreviewGroupOverride[] | null;
 }>): readonly OfferingsPreviewSourceKey[];
 export declare function normalizeOfferingsPreviewGroupOrder(value: readonly unknown[] | null | undefined): Readonly<{
-    kind: "legacy";
+    kind: 'legacy';
 } | {
-    kind: "default";
+    kind: 'default';
 } | {
-    kind: "custom";
+    kind: 'custom';
     keys: readonly OfferingsPreviewSourceKey[];
 }>;
 export declare function inferLegacyOfferingsPreviewGroupOrder(overrides: readonly Readonly<{
@@ -159,4 +159,4 @@ export declare function buildOfferingsPreviewRenderStates(input: Readonly<{
     emptyMessage: string;
     failedMessage: string;
 }>): readonly OfferingsPreviewGroupRenderState[];
-export declare function resolveOfferingsPreviewCoursePath(course: Pick<PublicCourse, "contentEntryId" | "slug">, routes: readonly OfferingsPreviewRouteCandidate[] | null | undefined): string | null;
+export declare function resolveOfferingsPreviewCoursePath(course: Pick<PublicCourse, 'contentEntryId' | 'slug'>, routes: readonly OfferingsPreviewRouteCandidate[] | null | undefined): string | null;

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

@@ -0,0 +1,29 @@
+import type { PublicCourse } from '../courses/shared/types';
+import type { PublicEvent } from '../events/shared/types';
+type ScheduleOccurrence = Readonly<{
+    startsAt: string;
+    endsAt: string;
+    timeZone: string;
+}>;
+export type OfferingsPreviewScheduleSummary = Readonly<{
+    kind: 'single-occurrence';
+    occurrence: ScheduleOccurrence;
+} | {
+    kind: 'multi-day-span';
+    occurrence: ScheduleOccurrence;
+} | {
+    kind: 'fixed-recurring-run';
+    first: ScheduleOccurrence;
+    last: ScheduleOccurrence;
+    sessionCount: number;
+    recurrenceLabel: string;
+} | {
+    kind: 'irregular-multi-session-run';
+    first: ScheduleOccurrence;
+    last: ScheduleOccurrence;
+    sessionCount: number;
+}>;
+export declare function deriveEventScheduleSummary(event: Pick<PublicEvent, 'startsAt' | 'endsAt' | 'timeZone'>): OfferingsPreviewScheduleSummary;
+export declare function deriveCourseScheduleSummary(course: Pick<PublicCourse, 'sessions'>): OfferingsPreviewScheduleSummary | null;
+export declare function nextCourseSessionStart(course: Pick<PublicCourse, 'sessions'>): string | null;
+export {};

package/dist/_dts/blocks/src/system/blocks/shop.d.ts

@@ -23,11 +23,12 @@ export declare const shopManifest: BlockManifest;
 export type ShopContent = {
     showPasses?: boolean | null;
     showMemberships?: boolean | null;
-    layout?: "grid" | "list" | null;
+    layout?: "grid" | "list" | "register" | null;
     columns?: "1" | "2" | "3" | "4" | null;
     showDescriptions?: boolean | null;
     showValidityPeriod?: boolean | null;
     showPricePerCredit?: boolean | null;
+    buttonVariant?: 'primary' | 'secondary' | 'outline' | 'link' | null;
     passesHeading?: string | null;
     membershipsHeading?: string | null;
     buyButtonText?: string | null;

package/dist/_dts/blocks/src/system/constants/blockKinds.d.ts

@@ -1,4 +1,4 @@
-export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.contact-newsletter", "block.appointment-booking", "block.weekly-slot-availability", "block.event-registration", "block.event-details", "block.course-registration", "block.course-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.offerings-preview", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
+export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.contact-newsletter", "block.appointment-booking", "block.weekly-slot-availability", "block.event-registration", "block.event-details", "block.course-registration", "block.course-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.recurring-schedule", "block.offerings-preview", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
 export type SystemBlockKind = (typeof SYSTEM_BLOCK_KINDS)[number];
 export type CustomBlockKind = `custom.${string}`;
 export type BlockKind = SystemBlockKind | CustomBlockKind;

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 } from '../../../../theme-core/src/site-styles/index';
+import { type ThemeBackgroundTextLegibilityPlan, type AppearancePresetId, type LayoutVariantKey, type PageDesignEditorBackgroundSupport } from '../../../../theme-core/src/site-styles/index';
 import type { ThemeColorToken } from '../../../../theme-core/src/tokens/index';
 import type { RenderableMediaAsset } from '../../../../media-core/src/index';
 export type BackgroundMode = 'default' | 'color' | 'gradient' | 'image';
@@ -129,6 +129,7 @@ export type BackgroundOverrideBlockedReason = 'mode-unavailable' | 'value-unavai
 export type BackgroundCustomizeContent = Record<string, unknown>;
 export type BackgroundCapabilityBlock = Readonly<{
     blockKind: string;
+    backgroundSupport: PageDesignEditorBackgroundSupport;
     layout: Readonly<{
         effectiveValue: LayoutVariantKey;
     }> | null;
@@ -157,11 +158,7 @@ export type ResolveBackgroundCapabilityInput = Readonly<{
 }>;
 export declare const BACKGROUND_MODES: readonly ["default", "color", "gradient", "image"];
 export declare const DEFAULT_BACKGROUND_OVERRIDE: BackgroundOverride;
-export declare const BACKGROUND_CUSTOMIZABLE_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.event-calendar", "block.testimonials", "block.cta-full", "block.form"];
-export declare const BACKGROUND_COLOR_ONLY_BLOCK_KINDS: readonly ["block.intro", "block.event-calendar"];
-export declare const BACKGROUND_RICH_LAYOUT_FAMILIES: readonly ["split"];
 export declare const BACKGROUND_RICH_SECTION_SURFACES: readonly ["hero-image"];
-export declare function isBackgroundCustomizableBlockKind(blockKind: string): boolean;
 export type BackgroundColorPalette = Readonly<Record<string, string | null | undefined>>;
 export declare const backgroundColorTokens: readonly BackgroundColorToken[];
 export declare const quickBackgroundColorTokens: readonly BackgroundColorToken[];

package/dist/_dts/blocks/src/system/data/loaderEndpoints.d.ts

@@ -1,3 +1,3 @@
-export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "getPublicEventDetails", "listPublicCourses", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices", "getPublicWeeklySlotAvailability"];
+export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "listPublicRecurringSchedule", "getPublicEventDetails", "listPublicCourses", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices", "getPublicWeeklySlotAvailability"];
 export type SupportedLoaderEndpoint = typeof SUPPORTED_LOADER_ENDPOINTS[number];
 export declare function isSupportedLoaderEndpoint(endpoint: string): endpoint is SupportedLoaderEndpoint;

package/dist/_dts/blocks/src/system/designCapabilities.d.ts

@@ -11,6 +11,7 @@ export type BlockDesignCapabilityDeclaration = Readonly<{
 }>;
 export declare function declareBlockDesignCapability<const TCapability extends DesignedBlockDesignCapabilityInput>(capability: NoExtraKeys<TCapability, DesignedBlockDesignCapabilityInput>): BlockDesignCapabilityDeclaration;
 export declare function withEyebrowCapability(declaration: BlockDesignCapabilityDeclaration, eyebrowTreatments: NonEmptyReadonlyArray<EyebrowTreatment>): BlockDesignCapabilityDeclaration;
+export declare function withLookCapability(declaration: BlockDesignCapabilityDeclaration): BlockDesignCapabilityDeclaration;
 export declare function declareNoBlockDesignCapability(reason: NoBlockDesignCapabilityReason): BlockDesignCapabilityDeclaration;
 export declare function resolveDeclaredBlockDesignCapability(declaration: BlockDesignCapabilityDeclaration | undefined): BlockDesignCapability | undefined;
 export declare function blockDesignCapabilityMapFromDefinitions(definitions: readonly SystemBlockDefinition<unknown, AnyBlockRuntimeDefinition | undefined>[]): BlockDesignCapabilityMap;

package/dist/_dts/blocks/src/system/fragments/library/newsletterForm.d.ts

@@ -11,7 +11,7 @@ export declare const newsletterFormFragment: import("..").DefinedFragment<{
         readonly label: "Send signups to";
         readonly description: "Choose where new subscribers from this form should go.";
         readonly defaultValue: "riverbank";
-        readonly required: true;
+        readonly required: false;
         readonly ui: {
             readonly intent: "behavior";
         };
@@ -97,7 +97,7 @@ export declare const newsletterFormFragment: import("..").DefinedFragment<{
         readonly type: "text";
         readonly label: "Button label";
         readonly defaultValue: "Subscribe";
-    }, {
+    }, import("../../../../../block-form/src/backend/index").FieldDefinition, {
         readonly id: "successMessage";
         readonly type: "text";
         readonly label: "Success message";

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

@@ -1,9 +1,12 @@
 import type { CSSProperties } from "react";
 import type { NodeDefinition } from "../schema";
 import { type NodeModifier } from "../builder";
+type StyledCardDataProps = Readonly<Record<`data-${string}`, unknown>>;
 export declare function styledCard(children: Array<NodeDefinition | null | undefined>, opts: {
     stylesFrom: string;
     backgroundFrom: string;
     baseClassName?: string;
     style?: CSSProperties;
+    dataProps?: StyledCardDataProps;
 }, ...mods: NodeModifier[]): NodeDefinition;
+export {};

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

@@ -43,7 +43,7 @@ export { createBlockApi, BlockApiError } from './client';
 export type { BlockApiClient } from './client';
 export { BlockApiProvider, useBlockApi, useBlockApiOptional } from './context';
 export type { BlockApiProviderProps } from './context';
-export type { BlockApiConfig, BlockApiAuth, ApiKeyAuth, BearerAuth, NoAuth, ApiResponse, ApiSuccessResponse, ApiErrorResponse, FormSubmitRequest, FormSubmitResponse, FormConfigResponse, FormField, BookingSubmitRequest, BookingSubmitResponse, AppointmentBookingStatusRequest, AppointmentBookingStatusResponse, AvailableSlotsRequest, AvailableSlotsResponse, TimeSlot, AvailableDatesRequest, AvailableDatesResponse, BookingService, BookingServicesRequest, BookingServicesResponse, BookingServiceResponse, BookingResource, BookingResourcesRequest, BookingResourcesResponse, PublicEvent, PublicEventsRequest, PublicEventsResponse, EventVenue, PricingType, AccessRestriction, EventFilterCategory, EventFilterStaffMember, EventFilterVenue, EventFiltersResponse, EventRegisterRequest, EventRegisterResponse, EventCheckoutRequest, EventCheckoutResponse, PaymentMethod, EligibilityCheckRequest, EligibilityCheckResponse, EligiblePass, EligibleMembership, AvailablePass, AvailableMembership, CoursePaymentMethod, CourseEnrollRequest, CourseEnrollResponse, CourseEnrollSuccessResponse, CourseWaitlistResponse, CourseCheckoutRequest, CourseCheckoutResponse, DiscountContext, DiscountsAvailableRequest, DiscountsAvailableResponse, DiscountApplyLine, DiscountApplyRequest, DiscountApplyRejectedReason, DiscountApplyResponse, ShopCheckoutRequest, ShopCheckoutResponse, ShopDuplicateMembershipWarning, CustomerProfile, CustomerOrder, CustomerOrderInstalmentPlan, CustomerOrderInstalmentPlanStatus, CustomerOrderInstalmentRow, CustomerOrderInstalmentStatus, CustomerOrderPaymentState, EnabledModules, PortalMeResponse, PortalMeUpdateRequest, CustomerPass, CustomerPassCreditHistoryEntry, CustomerMembership, EventTicketBreakdownLine, CustomerEventRegistration, PortalEventTicket, CustomerAppointment, AppointmentBookingQuestionsTaskDetail, BookingQuestionsTaskDetail, BookingQuestionsAnswerValue, BookingQuestionsField, BookingQuestionsFieldOption, BookingQuestionsSection, BeforeYouComeTaskSummary, CustomerCourseEnrollment, EventGuest, PortalCredit, PortalCreditSummary, PortalCreditTransaction, PortalCreditResponse, PortalOrderCheckoutRequest, PortalOrderCheckoutResponse, PortalDigitalProduct, PortalDigitalProductFile, PortalDigitalProductsResponse, PortalDigitalProductAccessResponse, PortalDigitalProductDownloadUrlResponse, PortalAppointmentBookingQuestionsResponse, PortalCreateAppointmentBookingQuestionsUploadUrlRequest, PortalCreateAppointmentBookingQuestionsUploadUrlResponse, PortalFinalizeAppointmentBookingQuestionsUploadRequest, PortalFinalizeAppointmentBookingQuestionsUploadResponse, PortalUpdateAppointmentBookingQuestionsRequest, PortalUpdateAppointmentBookingQuestionsResponse, PortalEventBookingQuestionsResponse, PortalCreateEventBookingQuestionsUploadUrlRequest, PortalCreateEventBookingQuestionsUploadUrlResponse, PortalFinalizeEventBookingQuestionsUploadRequest, PortalFinalizeEventBookingQuestionsUploadResponse, PortalUpdateEventBookingQuestionsRequest, PortalUpdateEventBookingQuestionsResponse, PortalCourseBookingQuestionsResponse, PortalCreateCourseBookingQuestionsUploadUrlRequest, PortalCreateCourseBookingQuestionsUploadUrlResponse, PortalFinalizeCourseBookingQuestionsUploadRequest, PortalFinalizeCourseBookingQuestionsUploadResponse, PortalUpdateCourseBookingQuestionsRequest, PortalUpdateCourseBookingQuestionsResponse, UpdateEventGuestsRequest, EventGuestsResponse, PortalCancelCourseEnrollmentRequest, PortalCancelCourseEnrollmentResult, PortalCancelAppointmentRequest, PortalCancelAppointmentResult, PortalCancelEventRegistrationRequest, PortalRefundInfo, PortalCancelEventRegistrationResult, PortalTransferEventRegistrationRequest, PortalTransferEventRegistrationResult, PortalRescheduleAppointmentRequest, PortalRescheduleAppointmentResponse, PortalCancelMembershipAtPeriodEndResult, MagicLinkRequest, } from './types';
+export type { BlockApiConfig, BlockApiAuth, ApiKeyAuth, BearerAuth, NoAuth, ApiResponse, ApiSuccessResponse, ApiErrorResponse, FormSubmitRequest, FormSubmitResponse, FormConfigResponse, FormField, BookingSubmitRequest, BookingSubmitResponse, AppointmentBookingStatusRequest, AppointmentBookingStatusResponse, AvailableSlotsRequest, AvailableSlotsResponse, TimeSlot, AvailableDatesRequest, AvailableDatesResponse, BookingService, BookingServicesRequest, BookingServicesResponse, BookingServiceResponse, BookingResource, BookingResourcesRequest, BookingResourcesResponse, PublicEvent, PublicEventsRequest, PublicEventsResponse, EventVenue, PricingType, AccessRestriction, EventFilterCategory, EventFilterStaffMember, EventFilterVenue, EventFiltersResponse, EventRegisterRequest, EventRegisterResponse, EventCheckoutRequest, EventCheckoutResponse, PaymentMethod, EligibilityCheckRequest, EligibilityCheckResponse, EligiblePass, EligibleMembership, AvailablePass, AvailableMembership, CoursePaymentMethod, CourseEnrollRequest, CourseEnrollResponse, CourseEnrollSuccessResponse, CourseWaitlistResponse, CourseCheckoutRequest, CourseCheckoutResponse, DiscountContext, DiscountsAvailableRequest, DiscountsAvailableResponse, DiscountApplyLine, DiscountApplyRequest, DiscountApplyRejectedReason, DiscountApplyResponse, ShopCheckoutRequest, ShopCheckoutResponse, ShopDuplicateMembershipWarning, CustomerProfile, CustomerOrder, CustomerOrderFilter, CustomerOrderItem, CustomerOrderInstalmentPlan, CustomerOrderInstalmentPlanStatus, CustomerOrderInstalmentRow, CustomerOrderInstalmentStatus, CustomerOrderPaymentState, CustomerOrderRefund, EnabledModules, PortalMeResponse, PortalMeUpdateRequest, CustomerPass, CustomerPassCreditHistoryEntry, CustomerMembership, EventTicketBreakdownLine, CustomerEventRegistration, PortalEventTicket, CustomerAppointment, AppointmentBookingQuestionsTaskDetail, BookingQuestionsTaskDetail, BookingQuestionsAnswerValue, BookingQuestionsField, BookingQuestionsFieldOption, BookingQuestionsSection, BeforeYouComeTaskSummary, CustomerCourseEnrollment, EventGuest, PortalCredit, PortalCreditSummary, PortalCreditTransaction, PortalCreditResponse, PortalOrderCheckoutRequest, PortalOrderCheckoutResponse, PortalDigitalProduct, PortalDigitalProductFile, PortalDigitalProductsResponse, PortalDigitalProductAccessResponse, PortalDigitalProductDownloadUrlResponse, PortalAppointmentBookingQuestionsResponse, PortalCreateAppointmentBookingQuestionsUploadUrlRequest, PortalCreateAppointmentBookingQuestionsUploadUrlResponse, PortalFinalizeAppointmentBookingQuestionsUploadRequest, PortalFinalizeAppointmentBookingQuestionsUploadResponse, PortalUpdateAppointmentBookingQuestionsRequest, PortalUpdateAppointmentBookingQuestionsResponse, PortalEventBookingQuestionsResponse, PortalCreateEventBookingQuestionsUploadUrlRequest, PortalCreateEventBookingQuestionsUploadUrlResponse, PortalFinalizeEventBookingQuestionsUploadRequest, PortalFinalizeEventBookingQuestionsUploadResponse, PortalUpdateEventBookingQuestionsRequest, PortalUpdateEventBookingQuestionsResponse, PortalCourseBookingQuestionsResponse, PortalCreateCourseBookingQuestionsUploadUrlRequest, PortalCreateCourseBookingQuestionsUploadUrlResponse, PortalFinalizeCourseBookingQuestionsUploadRequest, PortalFinalizeCourseBookingQuestionsUploadResponse, PortalUpdateCourseBookingQuestionsRequest, PortalUpdateCourseBookingQuestionsResponse, UpdateEventGuestsRequest, EventGuestsResponse, PortalCancelCourseEnrollmentRequest, PortalCancelCourseEnrollmentResult, PortalCancelAppointmentRequest, PortalCancelAppointmentResult, PortalCancelEventRegistrationRequest, PortalRefundInfo, PortalCancelEventRegistrationResult, PortalTransferEventRegistrationRequest, PortalTransferEventRegistrationResult, PortalRescheduleAppointmentRequest, PortalRescheduleAppointmentResponse, PortalCancelMembershipAtPeriodEndResult, MagicLinkRequest, } from './types';
 export { discountAvailabilityAllowsManualEntry, discountAvailabilityHasDiscounts, getAutoAppliedDiscountPreview, } from './types';
 export type { BookingQuestionsDocumentAnswerValue } from '../../../portal/types';
 export { deriveCreditProductLabels, getCreditProductCreditUnit, getCreditProductTypeLabel, getPortalCreditProductCreditNoun, } from './creditProducts';

package/dist/_dts/blocks/src/system/runtime/blockComposition.d.ts

@@ -0,0 +1,2 @@
+import type { BlockCompositionIntent } from '../../../../theme-core/src/site-styles/index';
+export declare function readBlockComposition(value: unknown): BlockCompositionIntent | null;