@riverbankcms/sdk 0.126.0 → 0.128.0

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

@@ -1,14 +1,13 @@
 import React, { type ReactNode } from 'react';
 import { type ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
-import type { BrandDisplayMode, FooterLookId, HeaderNavFontSizePreference, HeaderNavTypographyPreference, HeaderLayoutId, HeaderSelectionContext, HeaderStyleId, LogoSizePolicy, SiteChromeBackgroundColorToken, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
-import { headerNavFontSizeOptions, headerNavTypographyOptions } from '../../../../theme-core/src/site-styles/index';
+import type { BrandDisplayMode, HeaderNavFontSizePreference, HeaderNavTypographyPreference, HeaderInteractionPalettePreference, HeaderSelectionContext, LogoSizePolicy, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
 import { type StyleConfiguratorHistoryEntry } from './StyleConfigurator.state';
 import type { SiteStyleAccess } from './siteStyleAccess';
-import { type SiteChromeLookOption } from './siteChromeLookRows';
 import { type StyleConfiguratorInitialSelections } from './styleConfiguratorSnapshot';
 import type { SiteChromeEditableSurfaceKind } from './SiteChromeEditableSurface';
-import { type HeaderBrandDisplayOption, type HeaderLogoSizeOption } from './siteChromeBrandPreferences';
+import type { SiteChromeCustomizeSurfaceState } from './siteChromeCustomizeTypes';
+export type { SiteChromeBackgroundControlState, SiteChromeCustomizeSurfaceState, } from './siteChromeCustomizeTypes';
 import { type SiteStyleHistoryFailure, type SiteStyleHistorySkipReason } from './siteStyleHistoryState';
 import { type SiteChromeQuickControlHistoryFailure, type SiteChromeQuickControlHistorySkipReason } from './siteChromeQuickControlHistoryState';
 type SiteStyleHistoryController = Readonly<{
@@ -44,50 +43,6 @@ type SiteChromeQuickControlApplyOutcome = Readonly<{
     kind: 'skipped';
     reason: SiteChromeQuickControlHistorySkipReason | 'superseded';
 }> | SiteChromeQuickControlHistoryFailure;
-export type SiteChromeBackgroundControlState = Readonly<{
-    available: boolean;
-    current: SiteChromeBackgroundOverride;
-    currentLabel: string;
-    quickTokens: readonly SiteChromeBackgroundColorToken[];
-    advancedTokens: readonly SiteChromeBackgroundColorToken[];
-}>;
-export type SiteChromeCustomizeSurfaceState = Readonly<{
-    kind: 'unavailable';
-}> | Readonly<{
-    kind: 'available';
-    surface: 'header';
-    label: string;
-    currentLayoutId: HeaderLayoutId;
-    currentLayoutLabel: string;
-    layoutOptions: readonly SiteChromeLookOption<HeaderLayoutId>[];
-    currentId: HeaderStyleId;
-    currentLabel: string;
-    options: readonly SiteChromeLookOption<HeaderStyleId>[];
-    brandDisplay: BrandDisplayMode;
-    brandDisplayOptions: readonly HeaderBrandDisplayOption[];
-    brandSizeLabel: string;
-    logoSize: LogoSizePolicy;
-    logoSizeOptions: readonly HeaderLogoSizeOption[];
-    menuFont: HeaderNavTypographyPreference;
-    menuFontOptions: typeof headerNavTypographyOptions;
-    menuFontSize: HeaderNavFontSizePreference;
-    menuFontSizeOptions: typeof headerNavFontSizeOptions;
-    diagnostics: readonly string[];
-    background: SiteChromeBackgroundControlState;
-    failure: string | null;
-    applyAllowed: boolean;
-}> | Readonly<{
-    kind: 'available';
-    surface: 'footer';
-    label: string;
-    currentId: FooterLookId | null;
-    currentLabel: string;
-    options: readonly SiteChromeLookOption<FooterLookId | null>[];
-    diagnostics: readonly string[];
-    background: SiteChromeBackgroundControlState;
-    failure: string | null;
-    applyAllowed: boolean;
-}>;
 type SiteChromeCustomizeContextValue = Readonly<{
     canOpenDesignEditor: boolean;
     getSurfaceState: (surface: SiteChromeEditableSurfaceKind) => SiteChromeCustomizeSurfaceState;
@@ -97,6 +52,7 @@ type SiteChromeCustomizeContextValue = Readonly<{
     setHeaderLogoSize: (value: LogoSizePolicy) => void;
     setHeaderMenuFont: (value: HeaderNavTypographyPreference) => void;
     setHeaderMenuFontSize: (value: HeaderNavFontSizePreference) => void;
+    setHeaderInteractionPalette: (value: HeaderInteractionPalettePreference) => void;
     cycleSurfaceBackground: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
     chooseSurfaceBackground: (surface: SiteChromeEditableSurfaceKind, override: SiteChromeBackgroundOverride) => void;
     siteStyleHistory: SiteStyleHistoryController;
@@ -118,4 +74,3 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
 }>;
 export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, siteStyleAccess, canOpenDesignEditor, }: SiteChromeCustomizeProviderProps): React.JSX.Element;
 export declare function useSiteChromeCustomizeOptional(): SiteChromeCustomizeContextValue | null;
-export {};

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

@@ -0,0 +1,8 @@
+import type { HeaderInteractionPalettePreference, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
+import { resolveHeaderInteractionPaletteControl } from '../../../../theme-core/src/site-styles/index';
+type HeaderInteractionPaletteSurfaceState = Readonly<{
+    interactionPalette: ReturnType<typeof resolveHeaderInteractionPaletteControl>;
+    diagnostics: readonly string[];
+}>;
+export declare function headerInteractionPaletteSurfaceState(styleId: HeaderStyleId, preference: HeaderInteractionPalettePreference): HeaderInteractionPaletteSurfaceState;
+export {};

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

@@ -0,0 +1,15 @@
+import type { Theme } from "../../../../theme-core/src/index";
+export type PreviewThemeRoles = Readonly<{
+    /** Base theme for site-style saves and configurator state. */
+    persistenceTheme: Theme;
+    /** Theme the preview document renders with (may be page-adapted). */
+    documentTheme: Theme;
+}>;
+/**
+ * Splits the preview theme inputs into their two distinct roles so the
+ * page-adapted render theme can never reach the persistence path.
+ */
+export declare function resolvePreviewThemeRoles(input: {
+    theme: Theme;
+    renderTheme?: Theme | null;
+}): PreviewThemeRoles;

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

@@ -0,0 +1,54 @@
+import type { BrandDisplayMode, FooterLookId, HeaderInteractionPaletteControlState, HeaderLayoutId, HeaderNavFontSizePreference, HeaderNavTypographyPreference, HeaderStyleId, LogoSizePolicy, SiteChromeBackgroundColorToken, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
+import type { HeaderBrandDisplayOption, HeaderLogoSizeOption } from './siteChromeBrandPreferences';
+import type { SiteChromeLookOption } from './siteChromeLookRows';
+export type SiteChromeBackgroundControlState = Readonly<{
+    available: boolean;
+    current: SiteChromeBackgroundOverride;
+    currentLabel: string;
+    quickTokens: readonly SiteChromeBackgroundColorToken[];
+    advancedTokens: readonly SiteChromeBackgroundColorToken[];
+}>;
+export type SiteChromeCustomizeSurfaceState = Readonly<{
+    kind: 'unavailable';
+}> | Readonly<{
+    kind: 'available';
+    surface: 'header';
+    label: string;
+    currentLayoutId: HeaderLayoutId;
+    currentLayoutLabel: string;
+    layoutOptions: readonly SiteChromeLookOption<HeaderLayoutId>[];
+    currentId: HeaderStyleId;
+    currentLabel: string;
+    options: readonly SiteChromeLookOption<HeaderStyleId>[];
+    brandDisplay: BrandDisplayMode;
+    brandDisplayOptions: readonly HeaderBrandDisplayOption[];
+    brandSizeLabel: string;
+    logoSize: LogoSizePolicy;
+    logoSizeOptions: readonly HeaderLogoSizeOption[];
+    menuFont: HeaderNavTypographyPreference;
+    menuFontOptions: readonly Readonly<{
+        value: HeaderNavTypographyPreference;
+        label: string;
+    }>[];
+    menuFontSize: HeaderNavFontSizePreference;
+    menuFontSizeOptions: readonly Readonly<{
+        value: HeaderNavFontSizePreference;
+        label: string;
+    }>[];
+    interactionPalette: HeaderInteractionPaletteControlState;
+    diagnostics: readonly string[];
+    background: SiteChromeBackgroundControlState;
+    failure: string | null;
+    applyAllowed: boolean;
+}> | Readonly<{
+    kind: 'available';
+    surface: 'footer';
+    label: string;
+    currentId: FooterLookId | null;
+    currentLabel: string;
+    options: readonly SiteChromeLookOption<FooterLookId | null>[];
+    diagnostics: readonly string[];
+    background: SiteChromeBackgroundControlState;
+    failure: string | null;
+    applyAllowed: boolean;
+}>;

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

@@ -1,12 +1,21 @@
 import { type CuratedSiteStyle } from '../../../../theme-core/src/site-styles/previewCompiler';
-import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleId, type LookCustomizationWritePlan } from '../../../../theme-core/src/site-styles/index';
+import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleAvailability, type HeaderStyleId, type LookCustomizationWritePlan } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot, StyleConfiguratorState } from './StyleConfigurator.state';
-export type SiteChromeLookOption<TId extends string | null> = Readonly<{
+export type SiteChromeLookUnavailableReason = Extract<HeaderStyleAvailability, {
+    kind: 'unavailable';
+}>['reason'] | 'unknown-header-style';
+type SiteChromeLookOptionBase<TId extends string | null> = Readonly<{
     id: TId;
     label: string;
     description?: string;
-    available: boolean;
 }>;
+export type SiteChromeLookOption<TId extends string | null> = SiteChromeLookOptionBase<TId> & (Readonly<{
+    available: true;
+    unavailableReason?: never;
+}> | Readonly<{
+    available: false;
+    unavailableReason: SiteChromeLookUnavailableReason;
+}>);
 export type SiteChromeLookCatalogOption<TId extends string> = Readonly<{
     id: TId;
     label: string;
@@ -33,6 +42,7 @@ type SiteChromeLookModelInput = Readonly<{
     headerSelectionContext?: Partial<HeaderSelectionContext>;
 }>;
 export declare function buildSiteChromeLookModels(input: SiteChromeLookModelInput): SiteChromeLookModels;
+export declare function siteChromeLookUnavailableReasonLabel(reason: SiteChromeLookUnavailableReason): string;
 export declare function cycleSiteChromeLookId<TId extends string>(options: readonly SiteChromeLookOption<TId | null>[], currentId: TId | null, direction: 'prev' | 'next'): TId | null | undefined;
 export declare function cycleableSiteChromeOptions<TId extends string>(options: readonly SiteChromeLookOption<TId | null>[]): readonly SiteChromeLookOption<TId | null>[];
 export type SiteChromeLookSelectionCommand = Readonly<{

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

@@ -0,0 +1,3 @@
+import { type HeaderNavPreferences } from '../../../../theme-core/src/site-styles/index';
+import type { SiteChromeQuickControlHistoryEntry, SiteChromeQuickControlNavTarget } from './siteChromeQuickControlHistoryState';
+export declare function quickControlHistoryEntryFromNavPreferenceChange(previous: HeaderNavPreferences, next: HeaderNavPreferences, target: SiteChromeQuickControlNavTarget): SiteChromeQuickControlHistoryEntry | null;

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

@@ -1,5 +1,5 @@
 import { type HistoryState } from '../../../../content-editor/src/index';
-import { type BrandDisplayMode, type FooterLookId, type HeaderNavFontSizePreference, type HeaderNavPreferences, type HeaderNavTypographyPreference, type LogoSizePolicy, type SiteChromeBackgroundOverride, type SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
+import { type BrandDisplayMode, type FooterLookId, type HeaderNavFontSizePreference, type HeaderNavPreferences, type HeaderNavTypographyPreference, type HeaderInteractionPalettePreference, type LogoSizePolicy, type SiteChromeBackgroundOverride, type SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 import type { HeaderBrandPreferences } from './siteChromeBrandPreferences';
 type HeaderLayoutSelection = Pick<SelectionSnapshot, 'headerLayoutId' | 'headerStyleId' | 'headerLookId'>;
@@ -40,6 +40,10 @@ export type SiteChromeQuickControlHistoryEntry = Readonly<{
     kind: 'header-menu-font-size';
     previous: HeaderNavFontSizePreference;
     next: HeaderNavFontSizePreference;
+}> | Readonly<{
+    kind: 'header-interaction-palette';
+    previous: HeaderInteractionPalettePreference;
+    next: HeaderInteractionPalettePreference;
 }>;
 export type SiteChromeQuickControlHistoryPresent = Readonly<{
     selection: SelectionSnapshot;
@@ -108,7 +112,7 @@ export type SiteChromeQuickControlHistoryFailure = Readonly<{
 }>;
 export type SiteChromeQuickControlSelectionTarget = 'header-layout' | 'header-style' | 'footer-look';
 export type SiteChromeQuickControlBrandTarget = 'header-brand-display' | 'header-logo-size';
-export type SiteChromeQuickControlNavTarget = 'header-menu-font' | 'header-menu-font-size';
+export type SiteChromeQuickControlNavTarget = 'header-menu-font' | 'header-menu-font-size' | 'header-interaction-palette';
 export type SiteChromeQuickControlBackgroundTarget = 'header-background' | 'footer-background';
 export declare function createSiteChromeQuickControlHistoryState(present: SiteChromeQuickControlHistoryPresentInput): SiteChromeQuickControlHistoryState;
 export declare function recordSiteChromeQuickControlHistoryEntry(state: SiteChromeQuickControlHistoryState, input: Readonly<{
@@ -119,7 +123,6 @@ export declare function recordSiteChromeQuickControlHistoryEntry(state: SiteChro
 export declare function quickControlHistoryEntryFromSelectionChange(previous: SelectionSnapshot, next: SelectionSnapshot, target: SiteChromeQuickControlSelectionTarget): SiteChromeQuickControlHistoryEntry | null;
 export declare function quickControlHistoryEntryFromBrandPreferenceChange(previous: HeaderBrandPreferences, next: HeaderBrandPreferences, target: SiteChromeQuickControlBrandTarget): SiteChromeQuickControlHistoryEntry | null;
 export declare function quickControlHistoryEntryFromBackgroundPreferenceChange(previous: SiteChromeBackgroundPreferences, next: SiteChromeBackgroundPreferences, target: SiteChromeQuickControlBackgroundTarget): SiteChromeQuickControlHistoryEntry | null;
-export declare function quickControlHistoryEntryFromNavPreferenceChange(previous: HeaderNavPreferences, next: HeaderNavPreferences, target: SiteChromeQuickControlNavTarget): SiteChromeQuickControlHistoryEntry | null;
 export declare function beginSiteChromeQuickControlHistoryUndo(state: SiteChromeQuickControlHistoryState): SiteChromeQuickControlHistoryBeginResult;
 export declare function beginSiteChromeQuickControlHistoryRedo(state: SiteChromeQuickControlHistoryState): SiteChromeQuickControlHistoryBeginResult;
 export declare function confirmSiteChromeQuickControlHistoryMutation(state: SiteChromeQuickControlHistoryState, persisted: SiteChromeQuickControlHistoryPresentInput): SiteChromeQuickControlHistoryState;

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

@@ -1,16 +1,17 @@
 import { type ReactNode } from 'react';
 import type { ApiClient } from '../../../../api/src/request';
-import { type BookingOfferingPresetSummary, type MediaAssetIndexItem, type Theme } from '../../../../blocks/src/index';
+import { type BookingOfferingPresetSummary, type Theme } from '../../../../blocks/src/index';
 import type { FieldWidgetComponent } from '../../../../block-form/src/client/index';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
 import { __testUtils, createPreviewEntryPickerAdapter, createPreviewLinkAdapters, createPreviewReferenceAdapters, createPreviewSiteOptionAdapters } from './widgetAdapters';
-export declare function PreviewFormProvider({ siteId: rawSiteId, theme, previewClient, bearerToken, supabaseUrl, mediaAssets, bookingOfferingPresets, sdkConfig, children, }: {
+/**
+ * Composes preview form widget providers beneath PreviewShell's media authority.
+ * Consumers rendering this directly must provide an ancestor MediaEditorProvider.
+ */
+export declare function PreviewFormProvider({ siteId: rawSiteId, theme, previewClient, bookingOfferingPresets, sdkConfig, children, }: {
     siteId: string;
     theme?: Theme | null;
     previewClient: ApiClient;
-    bearerToken?: string | null;
-    supabaseUrl?: string;
-    mediaAssets?: MediaAssetIndexItem[];
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     sdkConfig?: SdkConfigForBlockPicker | null;
     children: ReactNode;

package/dist/_dts/sdk/src/cli/commands/push/execute/footer.d.ts

@@ -1,3 +1,5 @@
+import type { ManagementFooterContent } from '../../../../client/management/types';
+import { writeFooterContentAfterPush } from '../../../content/footerFile';
 import type { EnvTarget } from '../../../helpers';
 import type { OutputContext } from '../../../output';
 import { type FooterDiff } from '../../../sync/diff';
@@ -5,6 +7,12 @@ import type { PushOptions } from '../options';
 export type FooterPushExecutionResult = Readonly<{
     success: boolean;
 }>;
+export type FooterLocalRefreshResult = Readonly<{
+    kind: 'refreshed';
+}> | Readonly<{
+    kind: 'failed';
+    cause: unknown;
+}>;
 type FooterPushDecision = Readonly<{
     kind: 'unchanged';
 }> | Readonly<{
@@ -21,6 +29,7 @@ export declare function footerDryRunPayload(diff: FooterDiff): Readonly<{
     dryRun: true;
     changes: readonly string[];
 }>;
+export declare function refreshLocalFooterAfterPush(contentDir: string, footer: ManagementFooterContent, writeFooter?: typeof writeFooterContentAfterPush): Promise<FooterLocalRefreshResult>;
 export declare function executeFooterPush(input: Readonly<{
     output: OutputContext;
     target: EnvTarget;

package/dist/_dts/sdk/src/cli/content/footerFile.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export type LocalFooterContent = import('../../../../api/src/sdkContracts').SdkFooterContent;
+export declare const localFooterContentSchema: z.ZodObject<{
+    composition: z.ZodPipe<z.ZodUnknown, z.ZodTransform<Readonly<{
+        schemaVersion: 1;
+        sections: readonly import("../../../../core/src/index").FooterSection[];
+    }>, unknown>>;
+    revision: z.ZodNumber;
+}, z.core.$strict>;
+export declare function writeFooterContentAfterPush(contentDir: string, footer: LocalFooterContent): Promise<string>;

package/dist/_dts/sdk/src/cli/content/reader.d.ts

@@ -12,8 +12,9 @@ import { type LocalEventScheduleIdentity } from './localEventSchedule';
 export type { LocalEventOccurrence, LocalEventScheduleIdentity } from './localEventSchedule';
 export { InvalidLocalEventScheduleIdentityError } from './localEventSchedule';
 import { type ValidatedThemeForPersistence } from '../../../../blocks/src/index';
+import type { RichTextDoc } from '../../../../core/src/index';
 import type { EventPaymentTermsInput } from '../../client/management/types';
-import { type RichTextDoc } from '../../../../core/src/index';
+import { type LocalFooterContent } from './footerFile';
 export interface LocalEntry {
     identifier: string;
     data: Record<string, unknown>;
@@ -125,10 +126,7 @@ export interface LocalTheme {
  *
  * Footer links are managed via navigation (footer menu), not this file.
  */
-export interface LocalFooterContent {
-    /** Rich text content in ProseMirror JSON format. Set to null to clear. */
-    bottomText?: RichTextDoc | null;
-}
+export type { LocalFooterContent } from './footerFile';
 export interface LocalVenueAddress {
     line1?: string | null;
     line2?: string | null;

package/dist/_dts/sdk/src/cli/site-commands/footerCommands.d.ts

@@ -1,6 +1,6 @@
 import { type Result, type SiteId } from '../../../../core/src/index';
 import { type SiteCommandOf } from '../../../../site-commands/src/index';
-import type { ManagementClient } from '../../client/management/types';
+import type { ManagementClient, ManagementFooterContent } from '../../client/management/types';
 import type { LocalFooterContent } from '../content/reader';
 import type { EnvTarget } from '../helpers';
 import type { FooterDiff } from '../sync/diff';
@@ -20,7 +20,16 @@ export type FooterSiteCommandType = 'upsertFooterContent';
 export type FooterSiteCommand = SiteCommandOf<FooterSiteCommandType>;
 export type FooterSiteCommandPlan = CliFooterCommandCompileSuccess['plan'];
 export type CliFooterCommandExecutionError = CliCommandExecutionError<FooterSiteCommandType>;
-export type CliFooterCommandExecutionResult = CliCommandExecutionResult<FooterSiteCommandType>;
+export type CliFooterCommandApplication = Readonly<{
+    kind: 'not-applied';
+}> | Readonly<{
+    kind: 'applied';
+    authoritativeFooter: ManagementFooterContent | null;
+}>;
+export type CliFooterCommandExecutionResult = Readonly<{
+    execution: CliCommandExecutionResult<FooterSiteCommandType>;
+    application: CliFooterCommandApplication;
+}>;
 export declare const footerSiteCommandTypes: readonly ["upsertFooterContent"];
 export type FooterCommandReportSubject = Readonly<{
     identifier: 'footer';
@@ -36,7 +45,10 @@ export declare function executeFooterCommandPlanAsSyncResult(input: Readonly<{
     client: Pick<ManagementClient, 'footer'>;
     compiledPlan: FooterCommandCompiledPlan;
     onBeforeExecute?: (commandCount: number) => void;
-}>): Promise<SyncResult>;
+}>): Promise<Readonly<{
+    syncResult: SyncResult;
+    application: CliFooterCommandApplication;
+}>>;
 export declare function executeFooterCommandPlanAsReport(input: Readonly<{
     client: Pick<ManagementClient, 'footer'>;
     compiledPlan: FooterCommandCompiledPlan;

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

@@ -0,0 +1,2 @@
+/** Combine signals into one that aborts when any input aborts. */
+export declare function combineAbortSignals(...signals: AbortSignal[]): AbortSignal;

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

@@ -9,7 +9,7 @@ import type { SiteCommandOf } from '../../../../site-commands/src/index';
 import type { SdkEventPricing, SdkEventPricingInput, SdkEventTicketTypeInput } from '../../../../api/src/sdk-event-pricing';
 import type { SdkEventPaymentTerms, SdkEventPaymentTermsInput } from '../../../../api/src/sdk-event-payment-terms';
 import type { SdkEventUpsertBody } from '../../../../api/src/sdk-event-upsert';
-import type { SdkAddEventOccurrenceRequest, SdkEventOccurrenceCapacityIntent, SdkEventOccurrenceScheduleInput, SdkManagementEventOccurrence, SdkManagementEventSeries, SdkPullEventSeries } from '../../../../api/src/sdkContracts';
+import type { SdkAddEventOccurrenceRequest, SdkEventOccurrenceCapacityIntent, SdkEventOccurrenceScheduleInput, SdkManagementEventOccurrence, SdkManagementEventSeries, SdkFooterContent, SdkPullEventSeries } from '../../../../api/src/sdkContracts';
 import type { SdkPullTruncationMeta } from '../../../../api/src/sdkContracts';
 import type { SdkCapabilitiesResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCatalogThemeResponse, SdkDemoContentResponse } from '../../../../api/src/sdkContracts';
 import type { SdkEntryPublishErrorCode, SdkPagePublishErrorCode, SdkPublicationOutcome } from '../../../../api/src/sdkContracts';
@@ -542,27 +542,18 @@ export interface ThemeStyleSelectionApplyResult {
 }
 /**
  * Footer content for SDK management operations.
- * A narrow legal-text command. The CMS maps this onto the V1 footer composition's
- * legal module without exposing or replacing the aggregate.
+ * The footer sync boundary carries the complete composition and its optimistic
+ * concurrency revision.
  */
-export interface FooterContent {
-    /** Rich text content in ProseMirror JSON format */
-    bottomText?: RichTextDoc;
-}
+export type FooterContent = ManagementFooterContent;
 /**
  * Footer content as returned from CMS.
  */
-export interface ManagementFooterContent {
-    /** Rich text content in ProseMirror JSON format */
-    bottomText: RichTextDoc;
-}
+export type ManagementFooterContent = SdkFooterContent;
 /**
  * Input for upserting footer content.
  */
-export interface FooterContentUpsertInput {
-    /** Set to null to clear. */
-    bottomText?: RichTextDoc | null;
-}
+export type FooterContentUpsertInput = NonNullable<APIEndpoints['sdkUpsertFooter']['body']>;
 export interface PulledFooter {
     footer: ManagementFooterContent | null;
     meta: {

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

@@ -1,6 +1,6 @@
-import type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicWeeklySlotAvailabilityResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, PublicEventsResponse, 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, 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, ResolveEventOccurrenceResponse, RouteDecisionResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, } from '../public-api/contracts';
+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';
 /**
  * Pagination metadata returned when `includeMeta: true`
  */
@@ -512,6 +512,14 @@ export interface RiverbankClient {
         seriesId?: string;
         includeOccurrenceId?: string;
     } & SdkMethodOptions): Promise<PublicEventDetailsResponse>;
+    /**
+     * Fetch one whole-series offering for a registration surface.
+     */
+    getPublicWholeSeriesOffering(params: {
+        siteId: string;
+        eventSeriesId: string;
+        stage?: string;
+    } & SdkMethodOptions): Promise<PublicWholeSeriesOfferingResponse>;
     /**
      * List public team members for a site (for Team Members block)
      */

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

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

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

@@ -45,7 +45,7 @@ export type BlockCategory = 'marketing' | 'content' | 'blog' | 'media' | 'layout
  *
  * Re-exported from `@riverbankcms/blocks` (single source of truth).
  */
-export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "listPublicRecurringSchedule", "getPublicEventDetails", "listPublicWholeSeriesOfferings", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices", "getPublicWeeklySlotAvailability"];
+export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "listPublicRecurringSchedule", "getPublicEventDetails", "listPublicWholeSeriesOfferings", "getPublicWholeSeriesOffering", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices", "getPublicWeeklySlotAvailability"];
 export type SdkLoaderEndpoint = (typeof SUPPORTED_LOADER_ENDPOINTS)[number];
 export type LoaderParamBinding = {
     $bind: {

package/dist/_dts/sdk/src/config/validation.d.ts

@@ -137,6 +137,7 @@ export declare const sdkLoaderEndpointSchema: z.ZodEnum<{
     getPublicBookingServices: "getPublicBookingServices";
     getPublicWeeklySlotAvailability: "getPublicWeeklySlotAvailability";
     listPublicEvents: "listPublicEvents";
+    getPublicWholeSeriesOffering: "getPublicWholeSeriesOffering";
     listPublicPasses: "listPublicPasses";
     listPublicMemberships: "listPublicMemberships";
     listPublicProducts: "listPublicProducts";
@@ -226,6 +227,7 @@ export declare const sdkConfigLoaderSchema: z.ZodObject<{
         getPublicBookingServices: "getPublicBookingServices";
         getPublicWeeklySlotAvailability: "getPublicWeeklySlotAvailability";
         listPublicEvents: "listPublicEvents";
+        getPublicWholeSeriesOffering: "getPublicWholeSeriesOffering";
         listPublicPasses: "listPublicPasses";
         listPublicMemberships: "listPublicMemberships";
         listPublicProducts: "listPublicProducts";
@@ -291,6 +293,7 @@ export declare const sdkDataLoadersSchema: z.ZodOptional<z.ZodRecord<z.ZodString
         getPublicBookingServices: "getPublicBookingServices";
         getPublicWeeklySlotAvailability: "getPublicWeeklySlotAvailability";
         listPublicEvents: "listPublicEvents";
+        getPublicWholeSeriesOffering: "getPublicWholeSeriesOffering";
         listPublicPasses: "listPublicPasses";
         listPublicMemberships: "listPublicMemberships";
         listPublicProducts: "listPublicProducts";

package/dist/_dts/sdk/src/contracts/event-registration-content.d.ts

@@ -0,0 +1,16 @@
+import type { ButtonVariant, SectionStylesContent } from './system-block-content';
+export type EventRegistrationContent = {
+    heading?: string | null;
+    showSessions?: boolean | null;
+    description?: unknown;
+    showPrice?: boolean | null;
+    maxTickets?: '1' | '2' | '3' | '5' | '10' | null;
+    showCapacity?: boolean | null;
+    successMessage?: string | null;
+    showVenue?: boolean | null;
+    membershipMessage?: string | null;
+    waitlistMessage?: string | null;
+    buttonText?: string | null;
+    buttonVariant?: ButtonVariant | null;
+    _sectionStyles?: SectionStylesContent;
+};

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

@@ -5,7 +5,10 @@
  * require importing internal blocks package types.
  */
 import type { InlineText, LinkValue, Media } from './content';
+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';
 type UnknownRecord = Record<string, unknown>;
 type ImageMedia = Omit<Media, 'type'> & {
     type: 'image';
@@ -246,18 +249,6 @@ export type EventListingContent = {
     emptyMessage?: string | null;
     _sectionStyles?: SectionStylesContent;
 };
-export type EventRegistrationContent = {
-    heading?: string | null;
-    description?: unknown;
-    maxTickets?: '1' | '2' | '3' | '5' | '10' | null;
-    showVenue?: boolean | null;
-    showCapacity?: boolean | null;
-    successMessage?: string | null;
-    waitlistMessage?: string | null;
-    buttonText?: string | null;
-    buttonVariant?: ButtonVariant | null;
-    _sectionStyles?: SectionStylesContent;
-};
 export type EventSpotlightContent = {
     heading?: string | null;
     description?: unknown;
@@ -505,9 +496,7 @@ export type CheckoutContent = {
     emptyStateText?: string | null;
     _sectionStyles?: SectionStylesContent;
 };
-export type SiteFooterContent = Readonly<{
-    showBusinessAddress?: boolean | null;
-}>;
+export type SiteFooterContent = BlocksSiteFooterContent;
 export type SiteHeaderMode = 'default' | 'hidden';
 export type SiteHeaderContent = Readonly<{
     mode?: SiteHeaderMode | null;

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

@@ -1,24 +1,11 @@
 import type { AddressedLocationValue, BusinessAddress } from '../../../core/src/index';
 import type { APIEndpoints, SdkRuntimePageSurfaceSubject as ApiSdkRuntimePageSurfaceSubject, SiteBySlugResponse as ApiSiteBySlugResponse, SiteBookingOfferingPresetSummary as ApiSiteBookingOfferingPresetSummary } from '../../../api/src/index';
-import type { Media, MediaAssetIndexItem, SiteFooterContent, SiteHeaderContent } from '../contracts';
+import type { MediaAssetIndexItem, SiteFooterContent, SiteHeaderContent } from '../contracts';
 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';
-export type PublicTeamMemberSummary = {
-    id: string;
-    name: string;
-    roleLabel: string | null;
-    summary: string | null;
-    profilePath: string | null;
-};
-export type PublicTeamMemberPhoto = (Omit<Media, 'type'> & {
-    type: 'image';
-}) | null;
-export type PublicTeamMemberBlockItem = PublicTeamMemberSummary & {
-    _type: 'teamMember';
-    role: string | null;
-    bio: string | null;
-    photo: PublicTeamMemberPhoto;
-};
+import type { PublicTeamMemberBlockItem } from './teamMemberContracts';
+export type { PublicTeamMemberBlockItem, PublicTeamMemberPhoto, PublicTeamMemberSummary, } from './teamMemberContracts';
+export type { PublicWholeSeriesOfferingResponse } from './wholeSeriesContracts';
 export type RuntimeSiteSdkConfig = {
     theme?: SdkThemeConfig;
     customBlocks?: SdkCustomBlock[];
@@ -900,4 +887,3 @@ export type PublicSdkContainerOptionsConfig = SdkContainerOptionsConfig;
 export type PublicSdkBlockFieldConfig = SdkBlockFieldConfig;
 export type PublicSdkBlockFieldOptionsMap = SdkBlockFieldOptionsMap;
 export type PublicSdkFieldSelectOption = SdkFieldSelectOption;
-export {};

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

@@ -0,0 +1,17 @@
+import type { Media } from '../contracts';
+export type PublicTeamMemberSummary = {
+    id: string;
+    name: string;
+    roleLabel: string | null;
+    summary: string | null;
+    profilePath: string | null;
+};
+export type PublicTeamMemberPhoto = (Omit<Media, 'type'> & {
+    type: 'image';
+}) | null;
+export type PublicTeamMemberBlockItem = PublicTeamMemberSummary & {
+    _type: 'teamMember';
+    role: string | null;
+    bio: string | null;
+    photo: PublicTeamMemberPhoto;
+};

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

@@ -0,0 +1,2 @@
+import type { APIEndpoints } from '../../../api/src/index';
+export type PublicWholeSeriesOfferingResponse = NonNullable<APIEndpoints['getPublicWholeSeriesOffering']['response']>;

package/dist/_dts/sdk/src/rendering/blocks-page-renderer.d.ts

@@ -3,6 +3,7 @@ import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextDa
 import type { SdkCustomBlock } from '../config/types';
 import type { BlockOverrides } from './overrides';
 import type { SiteBookingOfferingPresetSummary } from '../public-api/contracts';
+import { type BlocksImageResolveContextInput, type BlocksMediaAssetIndexItem } from './mediaAssets';
 import type { EventPageSurfaceSubjectWire } from '../../../core/src/index';
 export type ComponentRegistry = Record<string, React.ElementType>;
 export type PageRendererDataContext = {
@@ -26,6 +27,11 @@ export type PageRendererDataContext = {
     apiBaseUrl?: string;
     portalToken?: string | null;
     previewToken?: string | null;
+    eventRegistrationOverlayEnabled?: boolean;
+};
+export type BlocksPageRendererDataContext = Omit<PageRendererDataContext, 'mediaAssets' | 'imageResolveContext'> & {
+    mediaAssets?: readonly BlocksMediaAssetIndexItem[];
+    imageResolveContext?: BlocksImageResolveContextInput;
 };
 export type SdkConfigForRenderer = {
     customBlocks?: SdkCustomBlock[];
@@ -44,4 +50,5 @@ export type PageRendererProps = {
     sdkConfig?: SdkConfigForRenderer | null;
     customBlocks?: SdkCustomBlock[];
 };
+export declare function toBlocksPageRendererDataContext(dataContext: PageRendererDataContext): BlocksPageRendererDataContext;
 export declare function PageRenderer(props: PageRendererProps): React.ReactElement;