@riverbankcms/sdk 0.130.2 → 0.132.0

package/dist/_dts/preview-next/src/client/preview/ButtonStylePicker.d.ts

@@ -1,14 +1,15 @@
 import React from 'react';
 import { type Theme } from '../../../../blocks/src/index';
-import { type ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
+import { type ButtonStyleSelection, type ButtonStyleSelectionRepair } from '../../../../theme-core/src/buttons/index';
 export type ButtonStylePickerProps = Readonly<{
     selections: readonly ButtonStyleSelection[];
     current: ButtonStyleSelection;
     previewTheme: Theme;
     onPreview: (selection: ButtonStyleSelection) => void;
     disabled?: boolean;
+    repairs?: readonly ButtonStyleSelectionRepair[];
 }>;
-export declare function ButtonStylePicker({ selections, current, previewTheme, onPreview, disabled, }: ButtonStylePickerProps): React.JSX.Element;
+export declare function ButtonStylePicker({ selections, current, previewTheme, onPreview, disabled, repairs, }: ButtonStylePickerProps): React.JSX.Element;
 export declare function ButtonStylePreviewPair({ selection, previewTheme, compact, }: Readonly<{
     selection: ButtonStyleSelection;
     previewTheme: Theme;

package/dist/_dts/preview-next/src/client/preview/PreviewEditorSidebar.d.ts

@@ -5,6 +5,7 @@ import type { SurfaceId } from '../../../../surfaces/src/index';
 import type { EntrySubrouteContextData, BookingOfferingPresetSummary, Theme } from '../../../../blocks/src/index';
 import { type ContentTypeSchema } from '../../../../content-model/src/index';
 import { type ZoomLevel } from '../../../../content-editor/src/index';
+import { type StyleConfiguratorProps } from './StyleConfigurator';
 import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
 import type { FooterLookId, HeaderLayoutStyleSelection, HeaderLogoContext } from '../../../../theme-core/src/site-styles/index';
 import type { ViewportMode, ViewportWidth } from './PreviewViewportControls';
@@ -35,6 +36,7 @@ export type PreviewEditorSidebarProps = {
     themeSelectionUpdatedAt?: string | null;
     /** Persisted Style configurator selections (Phase C / E). */
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
+    themeSelectionButtonStyleRepairs?: StyleConfiguratorProps['buttonStyleRepairs'];
     themeSelectionHeaderSelection?: HeaderLayoutStyleSelection | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderLogo?: HeaderLogoContext;
@@ -56,4 +58,4 @@ export type PreviewEditorSidebarProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, themeSelectionHeaderSelection, themeSelectionFooterLookId, themeSelectionHeaderLogo, apiClient, bearerToken, entrySubrouteContext, assistantPanel, sdkConfig, bookingOfferingPresets, siteStyleAccess, activeTab, onTabChange, onClose, onFooterSaved, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;
+export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, themeSelectionButtonStyleRepairs, themeSelectionHeaderSelection, themeSelectionFooterLookId, themeSelectionHeaderLogo, apiClient, bearerToken, entrySubrouteContext, assistantPanel, sdkConfig, bookingOfferingPresets, siteStyleAccess, activeTab, onTabChange, onClose, onFooterSaved, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;

package/dist/_dts/preview-next/src/client/preview/PreviewShell.d.ts

@@ -1,6 +1,6 @@
 import React, { type ComponentProps, type ReactNode } from 'react';
 import { BlockApiProvider } from '../../../../blocks/src/client';
-import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
+import type { ButtonStyleSelection, ButtonStyleSelectionRepair } from '../../../../theme-core/src/buttons/index';
 import type { FooterLookId, HeaderLayoutStyleSelection, HeaderLogoContext } from '../../../../theme-core/src/site-styles/index';
 import type { EntrySubrouteContextData, BookingOfferingPresetSummary, MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
 import type { ContentTypeSchema } from '../../../../content-model/src/index';
@@ -51,6 +51,7 @@ type PreviewShellCommonProps = {
      * complete palette state.
      */
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
+    themeSelectionButtonStyleRepairs?: readonly ButtonStyleSelectionRepair[];
     themeSelectionHeaderSelection?: HeaderLayoutStyleSelection | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderLogo?: HeaderLogoContext;

package/dist/_dts/preview-next/src/client/preview/PreviewShellLayout.d.ts

@@ -1,6 +1,6 @@
 import React, { type ReactNode } from 'react';
 import { type EntrySubrouteContextData, type BookingOfferingPresetSummary, type Theme } from '../../../../blocks/src/index';
-import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
+import type { ButtonStyleSelection, ButtonStyleSelectionRepair } from '../../../../theme-core/src/buttons/index';
 import type { HeaderLogoContext, FooterLookId, HeaderLayoutStyleSelection } from '../../../../theme-core/src/site-styles/index';
 import type { ContentTypeSchema } from '../../../../content-model/src/index';
 import type { ApiClient } from '../../../../api/src/request';
@@ -27,6 +27,7 @@ type PreviewShellLayoutCommonProps = {
     themeSelectionVersion?: number | null;
     themeSelectionUpdatedAt?: string | null;
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
+    themeSelectionButtonStyleRepairs?: readonly ButtonStyleSelectionRepair[];
     themeSelectionHeaderSelection?: HeaderLayoutStyleSelection | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderLogo?: HeaderLogoContext;

package/dist/_dts/preview-next/src/client/preview/StyleConfigurator.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
+import { type ButtonStyleSelectionRepair } from '../../../../theme-core/src/buttons/index';
 import { type HeaderLogoContext } from '../../../../theme-core/src/site-styles/index';
 import { type StyleConfiguratorInitialSelections } from './styleConfiguratorSnapshot';
 export type StyleConfiguratorProps = Readonly<{
@@ -13,7 +14,8 @@ export type StyleConfiguratorProps = Readonly<{
     selectionUpdatedAt?: string | null;
     /** Server-persisted design selections. */
     initialSelections: StyleConfiguratorInitialSelections & Readonly<Record<string, unknown>>;
+    buttonStyleRepairs?: readonly ButtonStyleSelectionRepair[];
     headerLogoContext?: HeaderLogoContext;
     onFocusedSurfaceChange?: (focused: boolean) => void;
 }>;
-export declare function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerLogoContext, onFocusedSurfaceChange, }: StyleConfiguratorProps): React.JSX.Element;
+export declare function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, buttonStyleRepairs, headerLogoContext, onFocusedSurfaceChange, }: StyleConfiguratorProps): React.JSX.Element;

package/dist/_dts/preview-next/src/client/preview/StyleConfiguratorWarningNotice.d.ts

@@ -0,0 +1,7 @@
+import type { SelectionFallbackWarning } from '../../../../theme-core/src/site-styles/previewCompiler';
+type StyleConfiguratorWarningNoticeProps = Readonly<{
+    warnings: ReadonlyArray<SelectionFallbackWarning>;
+    onDismiss: () => void;
+}>;
+export declare function StyleConfiguratorWarningNotice({ warnings, onDismiss, }: StyleConfiguratorWarningNoticeProps): import("react").JSX.Element;
+export {};

package/dist/_dts/preview-next/src/client/preview/siteStylePreviewPlanner.d.ts

@@ -1,5 +1,5 @@
 import type { Theme } from '../../../../blocks/src/index';
-import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
+import { type ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
 import type { FooterLookId, HeaderLayoutId, HeaderLogoContext, HeaderStyleId, SiteChromeSurface } from '../../../../theme-core/src/site-styles/index';
 import { type CuratedSiteStyle, type SelectionFallbackWarning, type SiteThemeSelectionsResult, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
 export type SiteStylePreviewSelection = Readonly<{

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

@@ -0,0 +1,11 @@
+import type { ApiClient, ApiResult } from '../../../api/src/public/index';
+import type { RiverbankClient } from './types';
+type EventSubrouteReadDeps = Readonly<{
+    apiClient: ApiClient;
+    resilientFetchData: <T>(cacheKey: string, fetcher: (signal: AbortSignal) => Promise<ApiResult<T>>, options: Readonly<{
+        signal?: AbortSignal;
+    }>) => Promise<T>;
+}>;
+type EventSubrouteReadOperations = Pick<RiverbankClient, 'resolveEventOccurrence' | 'resolveEventRun'>;
+export declare function createEventSubrouteReadOperations(deps: EventSubrouteReadDeps): EventSubrouteReadOperations;
+export {};

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, 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, 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,6 +9,7 @@ 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 { 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';
@@ -158,9 +159,6 @@ export type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost' | 'acc
  * each role; content names the role.
  */
 export type CardRole = 'none' | 'open' | 'default' | 'alternative';
-export type CardVariantRole = 'default' | 'alternative';
-export type LegacyCardVariantRoleAlias = 'variant1' | 'variant2' | 'statement';
-export type EventCardVariantInput = CardVariantRole | LegacyCardVariantRoleAlias;
 export type EventSurfacePreset = 'course' | 'term' | 'class' | 'workshop' | 'retreat' | 'performance';
 export type EventSurfaceScope = 'all' | 'regularClassSchedule' | 'specialDatedEvents' | 'custom';
 export type EventScheduleScope = 'any' | 'recurring' | 'oneOff';
@@ -170,17 +168,7 @@ export type EventScheduleScope = 'any' | 'recurring' | 'oneOff';
  * eight fields before this. `SiteFooterContent` is aliased for the same reason.
  */
 export type EventCalendarContent = BlocksEventCalendarContent;
-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;
-};
+export type EventDetailsContent = BlocksEventDetailsContent;
 export type EventListingContent = {
     heading?: string | null;
     description?: unknown;
@@ -190,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;
@@ -213,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;

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/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/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, ContentFrameIntent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, CardRole, FeatureCardLegacySurfaceRole, FeatureCardSurfaceRole, 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/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/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.130.2";
+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 {};

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

@@ -9,6 +9,7 @@ export * from './classNames';
 export * from './generateButtonCss';
 export * from './resolveButtonColourStates';
 export * from './buttonSurfaceContext';
+export * from './contextualHover';
 export * from './affordanceIcons';
 export * from './generateDefaultButtonSystem';
 export * from './constants';

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

@@ -1,4 +1,5 @@
 import type { ButtonGlobalSettings, ButtonVariant, OpaqueButtonColourToken, VariantEffects } from './types';
+import type { ButtonContextualHoverRepair } from './contextualHover';
 import { type ButtonColourContractError, type ButtonColourPalette, type ButtonVisualState, type KnownButtonSurface } from './buttonColourContract';
 export { BUTTON_CONTRAST_POLICY, BUTTON_VISUAL_STATES, formatButtonColourContractError, type ButtonColourContractError, type ButtonColourPalette, type ButtonVisualState, type KnownButtonSurface, } from './buttonColourContract';
 export { classifyButtonEffectId, type ButtonEffectClassification, } from './effectClassification';
@@ -40,10 +41,12 @@ export type ButtonColourContractResult = Readonly<{
     states: ResolvedButtonColourStates;
     focusIndicator: ResolvedButtonFocusIndicator;
     nonColourEffects: VariantEffects;
+    contextualHoverRepair: ButtonContextualHoverRepair | null;
 }> | Readonly<{
     ok: false;
     error: ButtonColourContractError;
 }>;
+export type { ButtonContextualHoverRepair } from './contextualHover';
 export declare function compileButtonColourStates(input: Readonly<{
     variant: ButtonVariant;
     global: ButtonGlobalSettings;

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

@@ -0,0 +1,14 @@
+import type { ButtonColourPalette, KnownButtonSurface } from './buttonColourContract';
+import { type ButtonContextualHoverRepair } from './contextualHover';
+import type { ButtonColourTreatment, ButtonGlobalSettings, ButtonVariant } from './types';
+export type ResolvedButtonHoverTreatment = Readonly<{
+    treatment: ButtonColourTreatment;
+    repair: ButtonContextualHoverRepair | null;
+}>;
+export declare function resolveButtonHoverTreatment(input: Readonly<{
+    variant: ButtonVariant;
+    global: ButtonGlobalSettings;
+    fallback: ButtonColourTreatment;
+    palette: ButtonColourPalette;
+    surface?: KnownButtonSurface;
+}>): ResolvedButtonHoverTreatment;