@riverbankcms/sdk 0.130.0 → 0.132.0

package/dist/_dts/sdk/src/client/types.d.ts

@@ -1,6 +1,7 @@
-import type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicWeeklySlotAvailabilityResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, PublicEventsResponse, PublicWholeSeriesOfferingResponse, ResolveEventOccurrenceResponse, RouteDecisionResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, PublicProductCategorySelector } from '../public-api/contracts';
+import type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicWeeklySlotAvailabilityResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, PublicEventsResponse, PublicWholeSeriesOfferingResponse, ResolveEventOccurrenceResponse, ResolveEventRunResponse, RouteDecisionResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, PublicProductCategorySelector } from '../public-api/contracts';
 import type { PublishedRuntimeCacheAdapter, PublishedRuntimeCacheAdapterErrorKind } from './runtimeCachePolicy';
-export type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicWeeklySlotAvailabilityResponse, PublicEventsResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, PublicWholeSeriesOfferingResponse, ResolveEventOccurrenceResponse, RouteDecisionResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, } from '../public-api/contracts';
+import type { EventPageSurfaceSubjectRefWire } from '../../../core/src/index';
+export type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicWeeklySlotAvailabilityResponse, PublicEventsResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, PublicWholeSeriesOfferingResponse, ResolveEventOccurrenceResponse, ResolveEventRunResponse, RouteDecisionResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, } from '../public-api/contracts';
 /**
  * Pagination metadata returned when `includeMeta: true`
  */
@@ -561,23 +562,29 @@ export interface RiverbankClient {
      * // Resolve occurrence by date
      * const result = await client.resolveEventOccurrence({
      *   siteId: 'site-id',
-     *   eventSeriesIds: ['event-series-id'],
+     *   subject: { kind: 'eventSeries', eventSeriesId: 'event-series-id' },
      *   segment: '2025-01-15',
      * });
      *
      * // Resolve occurrence by UUID
      * const result = await client.resolveEventOccurrence({
      *   siteId: 'site-id',
-     *   eventSeriesIds: ['event-series-id'],
+     *   subject: { kind: 'eventSeries', eventSeriesId: 'event-series-id' },
      *   segment: 'abc123-...',
      * });
      * ```
      */
     resolveEventOccurrence(params: {
         siteId: string;
-        eventSeriesIds: readonly [string, ...string[]];
+        subject: EventPageSurfaceSubjectRefWire;
         segment: string;
     } & SdkMethodOptions): Promise<ResolveEventOccurrenceResponse>;
+    /** Resolve one run slug within a canonical parent Event. */
+    resolveEventRun(params: {
+        siteId: string;
+        subject: EventPageSurfaceSubjectRefWire;
+        segment: string;
+    } & SdkMethodOptions): Promise<ResolveEventRunResponse>;
     /**
      * Check if a path has a configured redirect rule
      *

package/dist/_dts/sdk/src/components.d.ts

@@ -27,6 +27,6 @@ export { Layout } from './rendering/components/Layout';
 export type { LayoutProps, HeaderData, FooterData } from './rendering/components/Layout';
 export type { SdkThemeResponsiveMode, SdkThemeRuntime, } from './rendering/themeRuntime';
 export { PageRenderer, ThemeScope, buildThemeRuntime, RichText, resolveImageUrl, resolveImageUrlWithContext, resolveImageSourceSetWithContext, ImagePresets, } from './rendering';
-export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, CollectionContent, ColumnsContent, CtaFullContent, EmbedContent, EventCalendarContent, EventDetailsContent, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FormBlockContent, GiftingContent, HeroContent, HeroMedia, ImageGalleryContent, MediaTextContent, NewsletterSignupContent, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, SystemBlockContentByKind, SystemBlockContentFor, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, VideoGridContent, ImageOptions, ResolveImageUrlContext, ResolveImageSourceSetOptions, ResolvedImageSourceSet, PageOutline, RouteMap, Theme, ThemeTokens, Media, TipTapNode, LinkValue, RichTextPrimitiveProps, } from './rendering';
+export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, CollectionContent, ColumnsContent, CtaFullContent, EmbedContent, EventCalendarContent, EventDetailsContent, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FormBlockContent, GiftingContent, HeroContent, HeroMedia, ImageGalleryContent, IntroContent, MediaTextContent, NewsletterSignupContent, OfferingsPreviewContent, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, SystemBlockContentByKind, SystemBlockContentFor, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, VideoGridContent, ImageOptions, ResolveImageUrlContext, ResolveImageSourceSetOptions, ResolvedImageSourceSet, PageOutline, RouteMap, Theme, ThemeTokens, Media, TipTapNode, LinkValue, RichTextPrimitiveProps, } from './rendering';
 export type { BlockOverrideProps, BlockOverrideRegistration, BlockOverrideRegistrations, BlockOverrides, BlockOverrideComponent, CustomBlockOverrideKey, KnownSystemBlockOverrides, KnownBlockOverrideKey, LazyBlockOverrideFactory, LazyBlockOverrideRegistration, StrictBlockOverrideRegistrations, StrictBlockOverrides, SystemBlockOverrideKey, } from './rendering';
 export { defineBlockOverrideRegistrations, defineBlockOverrides, defineLazyBlockOverride, } from './rendering';

package/dist/_dts/sdk/src/contracts/index.d.ts

@@ -1,5 +1,5 @@
 export type { TipTapNode, TipTapMark, RichTextDoc, InlineText, InlineTextAccentTone, InlineTextHighlightTone, InlineTextMark, InlineTextRun, Media, LinkValue, InternalRouteOnlyLinkValue, InternalResolvedLinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, } from './content';
-export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, ProductDetailContent, ProductListContent, RecurringScheduleContent, SectionStylesContent, SemanticIconId, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, BlockIconValue, FeatureCardIconTreatment, } from './system-block-content';
+export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardRole, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, ContentFrameIntent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FeatureCardLegacySurfaceRole, FeatureCardSurfaceRole, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, IntroContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, OfferingsPreviewContent, ProductDetailContent, ProductListContent, RecurringScheduleContent, SectionStylesContent, SemanticIconId, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, BlockIconValue, FeatureCardIconTreatment, } from './system-block-content';
 export type { PageOutline, PageRuntimeBoundary, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, } from './page';
 export type { Theme, ThemeTokens } from './theme';
 export type { CustomCssDeclarationsInput, CustomCssRuleInput, CustomCssNestedRuleInput, CustomCssAtRuleInput, KeyframesAtRuleInput, FontFaceAtRuleInput, MediaAtRuleInput, SupportsAtRuleInput, RawAtRuleInput, } from './custom-css';

package/dist/_dts/sdk/src/contracts/page.d.ts

@@ -28,16 +28,5 @@ export type RouteMapEntry = string | {
     [key: string]: unknown;
 };
 export type RouteMap = Record<string, RouteMapEntry>;
-export type OccurrenceContextData = {
-    id: string;
-    seriesId: string;
-    startsAt: string;
-    endsAt: string;
-    timeZone: string;
-    capacityOverride?: number | null;
-    overrides?: Record<string, unknown> | null;
-};
-export type EntrySubrouteContextData = {
-    kind: 'event-occurrence';
-    occurrence: OccurrenceContextData;
-};
+export type OccurrenceContextData = import('../../../core/src/index').EventOccurrenceContextData;
+export type EntrySubrouteContextData = import('../../../core/src/index').EventPageSubrouteContext;

package/dist/_dts/sdk/src/contracts/system-block-content.d.ts

@@ -9,7 +9,10 @@ import type { EventRegistrationContent } from './event-registration-content';
 export type { EventRegistrationContent } from './event-registration-content';
 import type { Brand, EventCategoryId, RichTextDoc, VenueId } from '../../../core/src/index';
 import type { SiteFooterContent as BlocksSiteFooterContent } from '../../../blocks/src/system/blocks/site-footer';
-import type { CardStylesContent as BlocksCardStylesContent, ContainerStylesContent as BlocksContainerStylesContent, SectionStylesContent as BlocksSectionStylesContent } from '../../../blocks/src/index';
+import type { EventDetailsContent as BlocksEventDetailsContent } from '../../../blocks/src/system/blocks/event-details';
+import type { EventCalendarContent as BlocksEventCalendarContent } from '../../../blocks/src/system/blocks/events/event-calendar';
+import type { CalendarTabViews as BlocksCalendarTabViews, CalendarView as BlocksCalendarView, ColumnOption as BlocksColumnOption, DisplayMode as BlocksDisplayMode, EventLayout as BlocksEventLayout, FilterAutoShow as BlocksFilterAutoShow, WeekStart as BlocksWeekStart } from '../../../blocks/src/system/blocks/events/shared/types';
+import type { CardStylesContent as BlocksCardStylesContent, ContainerStylesContent as BlocksContainerStylesContent, ContentFrameIntent as BlocksContentFrameIntent, SectionStylesContent as BlocksSectionStylesContent } from '../../../blocks/src/index';
 type UnknownRecord = Record<string, unknown>;
 type ImageMedia = Omit<Media, 'type'> & {
     type: 'image';
@@ -20,6 +23,8 @@ export type ImageColSize = '1/4' | '1/3' | '2/5' | '1/2' | '2/3';
 export type SectionStylesContent = BlocksSectionStylesContent;
 export type CardStylesContent = BlocksCardStylesContent;
 export type ContainerStylesContent = BlocksContainerStylesContent;
+/** The compiled frame a Look asks for around a block's content. */
+export type ContentFrameIntent = BlocksContentFrameIntent;
 export type CtaIconName = 'ArrowRight' | 'ArrowLeft' | 'ChevronRight' | 'ChevronLeft' | 'ChevronUp' | 'ChevronDown' | 'ExternalLink' | 'Download' | 'Upload' | 'Mail' | 'Phone' | 'Play' | 'ShoppingCart' | 'Calendar' | 'MapPin' | 'Info' | 'Plus' | 'Minus' | 'Check' | 'X';
 export type SemanticIconId = 'protection-trust' | 'confidentiality' | 'care-support' | 'partnership' | 'warmth' | 'community' | 'personal-guidance' | 'conversation' | 'friendly-welcome' | 'insight-learning' | 'natural-wellbeing' | 'growth' | 'gentle-care' | 'special-touch' | 'ideas' | 'direction' | 'focus' | 'quality' | 'highlight' | 'verified-quality' | 'learning' | 'training' | 'programmes-dates' | 'place' | 'products' | 'packages' | 'time' | 'practical-service' | 'at-home' | 'worldwide' | 'professional-service';
 export type BlockIconValue = {
@@ -91,6 +96,7 @@ export type CollectionContent = {
         _type: string;
         [key: string]: unknown;
     }>;
+    _cardStyles?: CardStylesContent;
 };
 export type ColumnsContent = {
     equalHeight?: boolean;
@@ -135,59 +141,34 @@ export type EmbedContent = {
     layout?: string | null;
     emptyMessage?: string | null;
 };
-export type EventLayout = 'grid' | 'stack' | 'compact';
-export type ColumnOption = '2' | '3' | '4';
-export type WeekStart = 'sunday' | 'monday';
-export type DisplayMode = 'combined' | 'calendar' | 'list' | 'timetable' | 'week-board';
-export type FilterAutoShow = 'auto' | 'always' | 'never';
-export type CalendarTabViews = 'both' | 'month' | 'week';
-export type CalendarView = 'month' | 'week';
+/**
+ * The calendar's own vocabularies, aliased rather than restated. They are the
+ * event blocks' types; a hand-kept copy of a closed union is exactly what let
+ * the calendar contract drift in the first place.
+ */
+export type EventLayout = BlocksEventLayout;
+export type ColumnOption = BlocksColumnOption;
+export type WeekStart = BlocksWeekStart;
+export type DisplayMode = BlocksDisplayMode;
+export type FilterAutoShow = BlocksFilterAutoShow;
+export type CalendarTabViews = BlocksCalendarTabViews;
+export type CalendarView = BlocksCalendarView;
 export type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost' | 'accent';
-export type CardVariantRole = 'default' | 'alternative';
-export type LegacyCardVariantRoleAlias = 'variant1' | 'variant2';
-export type EventCardVariantInput = CardVariantRole | LegacyCardVariantRoleAlias;
-export type EventSurfacePreset = 'course' | 'class' | 'workshop' | 'retreat' | 'performance';
+/**
+ * The canonical card-role vocabulary. A site style owns the implementation of
+ * each role; content names the role.
+ */
+export type CardRole = 'none' | 'open' | 'default' | 'alternative';
+export type EventSurfacePreset = 'course' | 'term' | 'class' | 'workshop' | 'retreat' | 'performance';
 export type EventSurfaceScope = 'all' | 'regularClassSchedule' | 'specialDatedEvents' | 'custom';
 export type EventScheduleScope = 'any' | 'recurring' | 'oneOff';
-export type EventCalendarContent = {
-    heading?: string | null;
-    description?: unknown;
-    displayMode?: DisplayMode | null;
-    listLayout?: EventLayout | null;
-    listColumns?: ColumnOption | null;
-    layout?: EventLayout | null;
-    columns?: ColumnOption | null;
-    eventsPerPage?: '6' | '10' | '12' | '20' | '24' | '30' | null;
-    loadMoreText?: string | null;
-    startOfWeek?: WeekStart | null;
-    calendarTabViews?: CalendarTabViews | null;
-    defaultCalendarView?: CalendarView | null;
-    showFilters?: boolean | null;
-    showCategoryFilter?: FilterAutoShow | null;
-    showVenueFilter?: boolean | null;
-    showStaffFilter?: boolean | null;
-    eventSurface?: EventSurfaceScope | null;
-    filterEventPresets?: readonly EventSurfacePreset[] | null;
-    scheduleScope?: EventScheduleScope | null;
-    filterCategoryIds?: readonly EventCategoryId[] | null;
-    filterStaffMemberId?: string | null;
-    filterVenueId?: VenueId | null;
-    buttonVariant?: ButtonVariant | null;
-    buttonText?: string | null;
-    emptyMessage?: string | null;
-    _sectionStyles?: SectionStylesContent;
-};
-export type EventDetailsContent = {
-    heading?: string | null;
-    showVenue?: boolean | null;
-    showMap?: boolean | null;
-    showOtherDates?: boolean | null;
-    otherDatesLimit?: '3' | '5' | '10' | null;
-    showCost?: boolean | null;
-    showAcceptedPasses?: boolean | null;
-    showAcceptedMemberships?: boolean | null;
-    _sectionStyles?: SectionStylesContent;
-};
+/**
+ * Aliased from the blocks package rather than restated. The calendar's content
+ * is large, and a hand-kept copy drifts silently — the SDK copy was missing
+ * eight fields before this. `SiteFooterContent` is aliased for the same reason.
+ */
+export type EventCalendarContent = BlocksEventCalendarContent;
+export type EventDetailsContent = BlocksEventDetailsContent;
 export type EventListingContent = {
     heading?: string | null;
     description?: unknown;
@@ -197,7 +178,7 @@ export type EventListingContent = {
     paginationMode?: 'loadMore' | 'seeAllLink' | null;
     seeAllUrl?: string | null;
     loadMoreText?: string | null;
-    cardVariant?: EventCardVariantInput | null;
+    _cardStyles?: CardStylesContent;
     buttonVariant?: ButtonVariant | null;
     buttonText?: string | null;
     showVenue?: boolean | null;
@@ -220,7 +201,7 @@ export type EventSpotlightContent = {
     ctaUrl?: LinkValue | string | null;
     layout?: 'grid' | 'stack' | null;
     columns?: '2' | '3' | null;
-    cardVariant?: EventCardVariantInput | null;
+    _cardStyles?: CardStylesContent;
     buttonVariant?: ButtonVariant | null;
     buttonText?: string | null;
     showVenue?: boolean | null;
@@ -267,8 +248,28 @@ export type FaqContent = {
     items?: FaqItem[] | null;
     _containerStyles?: ContainerStylesContent;
 };
+/**
+ * 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';
+/**
+ * A feature card's own surface choice: the canonical card-role vocabulary
+ * *minus* `open`, plus this block's two historical values.
+ *
+ * `panel` is a legacy alias of the `alternative` role. `open` is the one worth
+ * knowing about: on this block it predates the role vocabulary and keeps its
+ * old meaning — an unmarked boxless card, which is role `none` — so it is
+ * excluded from the canonical half and supplied only by the legacy half.
+ *
+ * The consequence is permanent and deliberate: **the canonical `open` role is
+ * not addressable per item on a feature card.** The alias always wins. A card
+ * that should render the marked, boxless `open` role gets it from the block's
+ * card role, not from `surfaceRole`.
+ */
+export type FeatureCardSurfaceRole = Exclude<CardRole, 'open'> | FeatureCardLegacySurfaceRole;
 export type FeatureCard = {
-    surfaceRole?: 'open' | 'panel' | null;
+    surfaceRole?: FeatureCardSurfaceRole | null;
     media?: Media | null;
     aspectRatio?: StandardAspectRatio | null;
     icon?: BlockIconValue | SemanticIconId | null;
@@ -347,6 +348,7 @@ export type MediaTextImagePosition = 'left' | 'right';
 export type MediaTextAspectRatio = 'auto' | '16/9' | '4/3' | '1/1' | '3/4' | '9/16';
 export type MediaTextImageShape = 'default' | 'square' | 'rounded' | 'circle' | 'arch';
 export type MediaTextContent = {
+    eyebrow?: string | null;
     title?: string | null;
     titleAlignment?: MediaTextAlignment | null;
     imagePosition?: MediaTextImagePosition | null;
@@ -365,6 +367,13 @@ export type MediaTextContent = {
     text: RichTextDoc;
     wrapTextInCard?: boolean | null;
     _textCardStyles?: unknown;
+    /**
+     * Compiler-owned. Its card role rides into the author's text card, so this
+     * block has no card control of its own.
+     */
+    _cardStyles?: CardStylesContent;
+    /** Compiler-owned: the frame a Look asks for around the block's content. */
+    _frameStyles?: ContentFrameIntent | null;
 };
 export type NewsletterSignupPreset = 'emailOnly' | 'emailName' | 'emailFirstLast' | 'emailNameCompany';
 export type NewsletterSignupContent = {
@@ -490,6 +499,7 @@ type TeamMembersCommonContent = {
     stackContentAlignment?: StackContentAlignment | null;
     columns?: string | number | null;
     gap?: SemanticSpacing;
+    _cardStyles?: CardStylesContent;
 };
 export type TeamMembersContent = (TeamMembersCommonContent & {
     source?: 'manual' | null;

package/dist/_dts/sdk/src/next/pageMetadataProjection.d.ts

@@ -0,0 +1,7 @@
+import type { PageContentResult } from '../rendering/helpers/loadContent';
+export type PageMetadataProjection = Readonly<{
+    name: string;
+    purpose?: string;
+}>;
+export declare function projectPageMetadata(content: PageContentResult, preview: boolean): PageMetadataProjection;
+export declare function pageMetadataTitleMode(content: PageContentResult, preview: boolean): 'exact' | undefined;

package/dist/_dts/sdk/src/next/resolveEventPageSubroute.d.ts

@@ -0,0 +1,12 @@
+import type { RiverbankClient } from '../client/types';
+import { type LoadContentResult } from '../rendering/helpers/loadContent';
+import type { EntrySubrouteData } from '../routing/resolvePageContent';
+type EventSubrouteClient = Pick<RiverbankClient, 'resolveEventOccurrence' | 'resolveEventRun'>;
+export declare function resolveEventPageSubroute(input: Readonly<{
+    siteId: string;
+    client: EventSubrouteClient;
+    content: LoadContentResult;
+    kind?: string | null;
+    segment: string;
+}>): Promise<EntrySubrouteData | null>;
+export {};

package/dist/_dts/sdk/src/preview-next/keep-alive.d.ts

@@ -1 +1 @@
-export { createPreviewKeepAliveRouteHandler } from '@riverbankcms/preview-next/keep-alive';
+export { createPreviewKeepAliveRouteHandler, type CreatePreviewKeepAliveRouteHandlerOptions, type PreviewKeepAliveLogger, } from '@riverbankcms/preview-next/keep-alive';

package/dist/_dts/sdk/src/public-api/contracts.d.ts

@@ -4,6 +4,7 @@ import type { MediaAssetIndexItem, SiteFooterContent, SiteHeaderContent } from '
 import type { CompiledBoundaryRuntime } from '../../../theme-core/src/site-styles/index';
 import type { BlockFieldConfig as SdkBlockFieldConfig, BlockFieldOptionsMap as SdkBlockFieldOptionsMap, ContentConfig as SdkContentConfig, ContainerOptionsConfig as SdkContainerOptionsConfig, FieldSelectOption as SdkFieldSelectOption, SdkCustomBlock, SdkThemeConfig, SdkThemePalette, SectionBackground as SdkSectionBackground, SectionOptionsConfig as SdkSectionOptionsConfig, SiteStyleConfig as SdkSiteStyleConfig } from '../config/types';
 import type { PublicTeamMemberBlockItem } from './teamMemberContracts';
+import type { ResolveEventSubrouteResponse } from './eventSubrouteContracts';
 export type { PublicTeamMemberBlockItem, PublicTeamMemberPhoto, PublicTeamMemberSummary, } from './teamMemberContracts';
 export type { PublicWholeSeriesOfferingResponse } from './wholeSeriesContracts';
 export type RuntimeSiteSdkConfig = {
@@ -268,7 +269,7 @@ export type SiteRouteRecord = {
     publishedAt?: string | null;
 };
 export type SiteBookingOfferingPresetSummary = ApiSiteBookingOfferingPresetSummary;
-type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | 'selectionId' | 'selectionVersion' | 'selectionUpdatedAt' | 'selectionButtonStyleSelection' | 'selectionHeaderSelection' | 'selectionFooterLookId'>;
+type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | 'selectionId' | 'selectionVersion' | 'selectionUpdatedAt' | 'selectionButtonStyleSelection' | 'selectionButtonStyleRepairs' | 'selectionHeaderSelection' | 'selectionFooterLookId'>;
 export type SiteResponse = SiteSelectionResponse & {
     site: {
         id: string;
@@ -638,18 +639,7 @@ export type PublicMembershipsResponse = {
         eligibleCategoryNames: string[];
     }>;
 };
-export type ResolveEventOccurrenceResponse = {
-    occurrence: {
-        id: string;
-        seriesId: string;
-        startsAt: string;
-        endsAt: string;
-        timeZone: string;
-        status: string;
-        capacityOverride: number | null;
-        overridesJson: Record<string, unknown>;
-    } | null;
-};
+export type { ResolveEventOccurrenceResponse, ResolveEventRunResponse, ResolveEventSubrouteResponse, } from './eventSubrouteContracts';
 export type CheckRedirectResponse = {
     redirectTo: string | null;
     status?: number;
@@ -705,7 +695,7 @@ export type SitemapRoutesResponse = {
     pageSize: number;
     allowIndexingInProduction: boolean;
 };
-export type PublicEndpointName = 'getSite' | 'getContentByPath' | 'resolveRouteOutcome' | 'resolveRouteDecision' | 'listPublishedEntries' | 'getPublishedEntryPreview' | 'getPublicFormById' | 'listPublicForms' | 'getPublicBookingServices' | 'getPublicWeeklySlotAvailability' | 'getPublicChallenge' | 'listPublicEvents' | 'batchBlockLoaders' | 'listPublicTeamMembers' | 'listPublicProducts' | 'listPublicPasses' | 'listPublicMemberships' | 'resolveEventOccurrence' | 'checkRedirect' | 'getRoutableContent' | 'getPublicRoutableContent' | 'getPublicSitemapRoutes';
+export type PublicEndpointName = 'getSite' | 'getContentByPath' | 'resolveRouteOutcome' | 'resolveRouteDecision' | 'listPublishedEntries' | 'getPublishedEntryPreview' | 'getPublicFormById' | 'listPublicForms' | 'getPublicBookingServices' | 'getPublicWeeklySlotAvailability' | 'getPublicChallenge' | 'listPublicEvents' | 'batchBlockLoaders' | 'listPublicTeamMembers' | 'listPublicProducts' | 'listPublicPasses' | 'listPublicMemberships' | 'resolveEventSubroute' | 'checkRedirect' | 'getRoutableContent' | 'getPublicRoutableContent' | 'getPublicSitemapRoutes';
 export type PublicAPIEndpoints = {
     getSite: APIEndpointBase<never, {
         id?: string;
@@ -834,11 +824,7 @@ export type PublicAPIEndpoints = {
         siteId: string;
         categories?: string;
     }, PublicMembershipsResponse>;
-    resolveEventOccurrence: APIEndpointBase<never, {
-        siteId: string;
-        eventSeriesIds: string;
-        segment: string;
-    }, ResolveEventOccurrenceResponse>;
+    resolveEventSubroute: APIEndpointBase<never, NonNullable<APIEndpoints['resolveEventSubroute']['query']>, ResolveEventSubrouteResponse>;
     checkRedirect: APIEndpointBase<never, {
         site: string;
         path: string;

package/dist/_dts/sdk/src/public-api/eventSubrouteContracts.d.ts

@@ -0,0 +1,12 @@
+import type { APIEndpoints } from '../../../api/src/index';
+export type ResolveEventSubrouteResponse = NonNullable<APIEndpoints['resolveEventSubroute']['response']>;
+export type ResolveEventOccurrenceResponse = Readonly<{
+    occurrence: Extract<ResolveEventSubrouteResponse['subroute'], {
+        kind: 'event-occurrence';
+    }>['occurrence'] | null;
+}>;
+export type ResolveEventRunResponse = Readonly<{
+    run: Extract<ResolveEventSubrouteResponse['subroute'], {
+        kind: 'event-run';
+    }>['run'] | null;
+}>;

package/dist/_dts/sdk/src/public-api/runtime.d.ts

@@ -1,5 +1,5 @@
 import type { ApiResult, HTTPMethod, PublicAPIEndpoints, PublicEndpointName } from './contracts';
-export declare const PUBLIC_ENDPOINT_NAMES: readonly ["getSite", "getContentByPath", "resolveRouteOutcome", "resolveRouteDecision", "listPublishedEntries", "getPublishedEntryPreview", "getPublicFormById", "listPublicForms", "getPublicBookingServices", "getPublicWeeklySlotAvailability", "getPublicChallenge", "listPublicEvents", "batchBlockLoaders", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "resolveEventOccurrence", "checkRedirect", "getRoutableContent", "getPublicRoutableContent", "getPublicSitemapRoutes"];
+export declare const PUBLIC_ENDPOINT_NAMES: readonly ["getSite", "getContentByPath", "resolveRouteOutcome", "resolveRouteDecision", "listPublishedEntries", "getPublishedEntryPreview", "getPublicFormById", "listPublicForms", "getPublicBookingServices", "getPublicWeeklySlotAvailability", "getPublicChallenge", "listPublicEvents", "batchBlockLoaders", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "resolveEventSubroute", "checkRedirect", "getRoutableContent", "getPublicRoutableContent", "getPublicSitemapRoutes"];
 export type ApiClient = <E extends PublicEndpointName>(params: {
     endpoint: E;
     params?: PublicAPIEndpoints[E]['query'];

package/dist/_dts/sdk/src/rendering/client.d.ts

@@ -1,2 +1,46 @@
+import { type ReactElement, type ReactNode } from 'react';
+export type BlockApiAuth = Readonly<{
+    type: 'api-key';
+    key: string;
+}> | Readonly<{
+    type: 'bearer';
+    token: string;
+}> | Readonly<{
+    type: 'none';
+}>;
+export type BlockApiConfig = Readonly<{
+    baseUrl: string;
+    auth: BlockApiAuth;
+    siteId?: string;
+    isPreview?: boolean;
+}>;
+export type NewsletterSubscribeInput = Readonly<{
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    name?: string;
+    company?: string;
+    phone?: string;
+    target: Readonly<{
+        tag: 'published_block_ref';
+        destinationRef: Readonly<{
+            tag: 'block_ref';
+            blockId: string;
+        }>;
+    }>;
+    tags?: string[];
+}>;
+export type NewsletterSubscribeResult = Readonly<{
+    subscribed: boolean;
+    requiresConfirmation?: boolean;
+}>;
+export declare function BlockApiProvider({ config, children, }: Readonly<{
+    config: BlockApiConfig;
+    children: ReactNode;
+}>): ReactElement;
+/** Narrow client contract for custom newsletter override renderers. */
+export declare function useNewsletterBlockApi(): Readonly<{
+    subscribeNewsletter(input: NewsletterSubscribeInput): Promise<NewsletterSubscribeResult>;
+}>;
 export declare const clientComponentRegistry: Record<string, unknown>;
 export { BlocksIslandsHydrator } from './islands/BlocksIslandsHydrator';

package/dist/_dts/sdk/src/rendering/components/Layout.d.ts

@@ -49,7 +49,7 @@ type ThemedLayoutProps = LayoutCommonProps & {
     rendering?: never;
     header?: boolean | ((data: HeaderData) => React.ReactNode);
     footer?: boolean | ((data: FooterData) => React.ReactNode);
-    headerVariant?: 'classic' | 'centered' | 'transparent' | 'floating';
+    headerVariant?: 'classic' | 'centered' | 'floating';
     themeRuntime?: SdkThemeRuntime;
 };
 type OverrideOnlyLayoutProps = LayoutCommonProps & {

package/dist/_dts/sdk/src/rendering/index.d.ts

@@ -20,7 +20,7 @@ export type { LoadPageParams, LoadPageResult } from './helpers/loadPage';
 export { loadContent, isPageContent, isEntryContent, isPageSurfaceContent, } from './helpers/loadContent';
 export type { LoadContentParams, LoadContentResult, ContentEntryData, PagePreviewMetadata, SiteData, } from './helpers/loadContent';
 export type { BlockLoaderMap, DataLoaderContext, DataLoaderFn, DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderRenderTarget, DataLoaderSearchParams, DataLoaderValue, } from '../data/types';
-export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CardStylesContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LayoutAlign, LayoutWidth, Media, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, RichTextDoc, TipTapNode, TipTapMark, LinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, PageOutline, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, Theme, ThemeTokens, SectionStylesContent, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, MediaAssetIndexItem, ImageOptions, ResolveImageUrlContext, ResolveImageUrlContextInput, ResolveImageSourceSetOptions, ResolvedImageSourceSet, } from '../contracts';
+export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CardStylesContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, ContentFrameIntent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, CardRole, FeatureCardLegacySurfaceRole, FeatureCardSurfaceRole, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, IntroContent, LayoutAlign, LayoutWidth, Media, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, OfferingsPreviewContent, RichTextDoc, TipTapNode, TipTapMark, LinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, PageOutline, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, Theme, ThemeTokens, SectionStylesContent, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, MediaAssetIndexItem, ImageOptions, ResolveImageUrlContext, ResolveImageUrlContextInput, ResolveImageSourceSetOptions, ResolvedImageSourceSet, } from '../contracts';
 export { ImagePresets } from '../contracts';
 export { RichText } from './primitives/RichText';
 export { resolveImageUrl, resolveImageUrlWithContext, resolveImageSourceSetWithContext, } from './image';

package/dist/_dts/sdk/src/rendering/islands/types.d.ts

@@ -244,7 +244,15 @@ export type FormIslandProps = BlocksFormIslandProps;
 export type BookingFormService = BlocksBookingFormService;
 export type BookingFormConfig = BlocksBookingFormConfig;
 export type BookingFormIslandProps = BlocksBookingFormIslandProps;
-export type CardVariant = 'default' | 'variant1' | 'variant2';
+/**
+ * Card surface selection as it reaches an island.
+ *
+ * The canonical vocabulary is the card *role* (`none` / `open` / `default` /
+ * `alternative`); `variant1` / `variant2` are legacy aliases of `alternative`
+ * that persisted content still carries. Both keep parsing — the union is
+ * widened additively so no existing SDK consumer breaks.
+ */
+export type CardVariant = 'default' | 'alternative' | 'open' | 'none' | 'variant1' | 'variant2';
 export type ButtonVariant = SystemButtonVariant;
 export type EventListingLayout = EventLayout;
 export type CardOrientation = 'vertical' | 'horizontal';

package/dist/_dts/sdk/src/routing/entrySubroutes.d.ts

@@ -27,7 +27,7 @@ export type ShouldAttemptEntrySubrouteArgs = {
     entryTypeKey: string | null;
     segment: string;
 };
-export type KnownEntrySubrouteKind = 'event-occurrence';
+export type KnownEntrySubrouteKind = 'event-occurrence' | 'event-run';
 /**
  * Parse a path into parent path and last segment.
  * Returns null when no parent/segment split exists.

package/dist/_dts/sdk/src/routing/resolveOccurrence.d.ts

@@ -4,6 +4,7 @@
  * Resolves URL segments like "2025-01-15" or "abc123-uuid" to event occurrence data.
  */
 import type { RiverbankClient, ResolveEventOccurrenceResponse } from '../client/types';
+import type { EventPageSurfaceSubjectRefWire } from '../../../core/src/index';
 import { isISODateString, isUUID, isValidSegment } from './segmentValidators';
 /**
  * Data for a resolved event occurrence
@@ -32,9 +33,9 @@ export type ResolveOccurrenceParams = {
      */
     siteId: string;
     /**
-     * Event series IDs represented by the page authority.
+     * Canonical Event page subject that owns the occurrence.
      */
-    eventSeriesIds: readonly [string, ...string[]];
+    subject: EventPageSurfaceSubjectRefWire;
     /**
      * URL segment to resolve - either a date (YYYY-MM-DD) or UUID
      */
@@ -56,7 +57,7 @@ export type ResolveOccurrenceParams = {
  *   const result = await resolveOccurrence({
  *     client,
  *     siteId: 'your-site-id',
- *     eventSeriesIds: [pageSurface.subject.eventSeriesId],
+ *     subject: pageSurface.subject,
  *     segment: params.occurrence, // e.g., "2025-01-15"
  *   });
  *

package/dist/_dts/sdk/src/routing/resolvePageContent.d.ts

@@ -7,12 +7,16 @@
  * Both SDK and frontend inject their own auth/loaders, but share the same resolution logic.
  */
 import type { ContentTypeRoutingInfo } from './contentTypeResolver';
-import type { ResolveEventOccurrenceResponse } from '../client/types';
+import type { ResolveEventOccurrenceResponse, ResolveEventRunResponse } from '../client/types';
 export type OccurrenceData = NonNullable<ResolveEventOccurrenceResponse['occurrence']>;
-export type EntrySubrouteData = {
+export type EventRunData = NonNullable<ResolveEventRunResponse['run']>;
+export type EntrySubrouteData = Readonly<{
     kind: 'event-occurrence';
     occurrence: OccurrenceData;
-};
+}> | Readonly<{
+    kind: 'event-run';
+    run: EventRunData;
+}>;
 export type PublicLoadStage = 'site_lookup' | 'content_lookup' | 'entry_subroute_lookup' | 'redirect_lookup' | 'content_normalization';
 export type PublicContentLoadError = {
     kind: 'timeout';

package/dist/_dts/sdk/src/theme-bridge/types.d.ts

@@ -44,10 +44,12 @@ export interface ThemeBridgeButtonConfig {
  */
 export interface ThemeBridgeCardConfig {
     /**
-     * Which card variants to generate.
+     * Which card variants to generate — one id per card role the theme
+     * implements. `elevated` and `outlined` are the pre-role names of
+     * `alternative` and `open`, kept so existing configs keep working.
      * @default ['default']
      */
-    variants?: Array<'default' | 'elevated' | 'outlined'>;
+    variants?: Array<'default' | 'alternative' | 'open' | 'elevated' | 'outlined'>;
 }
 /**
  * Component CSS generation options.

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.130.0";
+export declare const SDK_VERSION = "0.132.0";

package/dist/_dts/theme-core/src/buttons/buttonSurfaceContext.d.ts

@@ -44,7 +44,7 @@ export type ContextualButtonResolution = Readonly<{
 }> | Readonly<{
     kind: 'repaired';
     requestedRole: VariantRole;
-    candidate: 'surface-outline' | VariantRole;
+    candidate: 'contextual-hover' | 'surface-outline' | VariantRole;
     states: ResolvedButtonColourStates;
     focusIndicator: ResolvedButtonFocusIndicator;
     boundary: Readonly<{

package/dist/_dts/theme-core/src/buttons/contextualHover.d.ts

@@ -0,0 +1,41 @@
+import { type ButtonColourPalette, type KnownButtonSurface } from './buttonColourContract';
+import { type ContextualButtonHover, type OpaqueButtonColourToken } from './types';
+type ShadeDirection = ContextualButtonHover['fallbackDirection'];
+export type ContextualHoverResolution = Readonly<{
+    kind: 'resolved';
+    token: OpaqueButtonColourToken;
+    direction: ShadeDirection;
+    evidence: 'known-surface' | 'fallback-direction';
+}> | Readonly<{
+    kind: 'unavailable';
+    reason: 'no-distinct-shade' | 'no-text-safe-candidate' | 'no-surface-safe-candidate';
+}>;
+export type ButtonContextualHoverRepair = Readonly<{
+    kind: 'preferred-token-replaced';
+    preferredToken: OpaqueButtonColourToken;
+    contextualToken: OpaqueButtonColourToken;
+}>;
+export type ContextualHoverPreferenceResolution = Readonly<{
+    kind: 'resolved';
+    token: OpaqueButtonColourToken;
+    repair: ButtonContextualHoverRepair | null;
+}> | Extract<ContextualHoverResolution, {
+    kind: 'unavailable';
+}>;
+export declare function resolveContextualHoverPreference(input: Readonly<{
+    instruction: ContextualButtonHover;
+    palette: ButtonColourPalette;
+    surface?: KnownButtonSurface;
+}>): ContextualHoverPreferenceResolution;
+/**
+ * Resolves semantic shade movement from real palette steps. The persisted
+ * instruction owns the colour family and deterministic unknown-surface
+ * fallback; a proven surface may select the opposite direction when it gives
+ * the button stronger separation while retaining the shared contrast contract.
+ */
+export declare function resolveContextualHover(input: Readonly<{
+    instruction: ContextualButtonHover;
+    palette: ButtonColourPalette;
+    surface?: KnownButtonSurface;
+}>): ContextualHoverResolution;
+export {};