@riverbankcms/sdk 0.127.0 → 0.129.0

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/next/catch-all.d.ts

@@ -1,3 +1,9 @@
 import type { CreateCatchAllPageOptions, CreateCatchAllPageResult } from './types';
+type InvalidCatchAllRenderingOption = 'missing_block_overrides' | 'theme_option_in_overrides_only' | 'theme_runtime_in_overrides_only';
+export declare class InvalidCatchAllRenderingOptionsError extends Error {
+    readonly code: InvalidCatchAllRenderingOption;
+    constructor(code: InvalidCatchAllRenderingOption);
+}
 /** Build a Next.js catch-all page and metadata generator for Riverbank content. */
 export declare function createCatchAllPage(options: CreateCatchAllPageOptions): CreateCatchAllPageResult;
+export {};

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

@@ -37,9 +37,10 @@
  *
  * @packageDocumentation
  */
-export { createCatchAllPage } from './catch-all';
+export { createCatchAllPage, InvalidCatchAllRenderingOptionsError, } from './catch-all';
 export { RiverbankContentLoadError, SdkContentLoadError, classifyContentLoadError, isSdkContentLoadError, toContentLoadFailureLogFields, type CatchAllContentLoadFailureContext, type CatchAllRequestContext, type ClassifiedContentLoadError, type SdkContentLoadFailure, type SdkContentLoadFailureKind, type SdkContentLoadNotFound, } from './content-load-failure';
 export type { CreateCatchAllPageOptions, CreateCatchAllPageResult, CatchAllPageProps, CatchAllContext, ThemeSwitchConfigV1, ThemeResolverContext, } from './types';
+export type { SdkOverrideOnlyRendering, SdkOverrideOnlyRuntime, SdkRenderingMode, } from '../rendering/renderingMode';
 export type { BlockLoaderMap, DataLoaderContext, DataLoaderFn, DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderRenderTarget, DataLoaderSearchParams, DataLoaderValue, } from '../data/types';
 export { createGenerateStaticParams, generateAllStaticParams, normalizeStaticRoutePath, validateStaticParamsEnv, pathToSlugArray, routesToStaticParams, type CreateGenerateStaticParamsOptions, type GenerateAllStaticParamsOptions, type StaticParam, type StaticParamsClient, type StaticParamsEnvResult, type StaticParamsFailureContext, type StaticParamsFailureMode, type StaticParamsRoute, } from './static-params';
 export { createSitemap, type CreateSitemapOptions, type SitemapGenerator, } from './sitemap';

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

@@ -0,0 +1,33 @@
+import React from 'react';
+import { type LoadContentResult } from '../rendering/helpers/loadContent';
+import type { BlockOverrideRegistrations } from '../rendering/overrides';
+import type { SdkRenderingMode } from '../rendering/renderingMode';
+import type { SdkThemeRuntime } from '../rendering/themeRuntime';
+import type { Theme } from '../contracts';
+import type { toEntrySubrouteContext } from './catch-all-utils';
+type CommonRenderInput = Readonly<{
+    apiBaseUrl: string;
+    blockOverrides?: BlockOverrideRegistrations;
+    content: LoadContentResult;
+    entrySubrouteContext: ReturnType<typeof toEntrySubrouteContext>;
+    portalToken: string | null;
+    preview: boolean;
+}>;
+export type SdkContentRenderInput = CommonRenderInput & (Readonly<{
+    kind: 'themed';
+    theme: Theme;
+    themeRuntime: SdkThemeRuntime;
+}> | Readonly<{
+    kind: 'overrides-only';
+    rendering: Extract<SdkRenderingMode, {
+        kind: 'overrides-only';
+    }>;
+}>);
+export type RenderSdkContentResult = Readonly<{
+    kind: 'rendered';
+    node: React.ReactNode;
+}> | Readonly<{
+    kind: 'not-found';
+}>;
+export declare function renderSdkContent(input: SdkContentRenderInput): Promise<RenderSdkContentResult>;
+export {};

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

@@ -9,6 +9,7 @@ import type { RiverbankClient } from '../client/types';
 import type { RiverbankSiteConfig } from '../config/types';
 import type { Theme } from '../contracts';
 import type { SdkThemeRuntime } from '../rendering/themeRuntime';
+import type { SdkOverrideOnlyRendering, SdkRenderingMode } from '../rendering/renderingMode';
 import type { BlockOverrideRegistrations } from '../rendering/overrides';
 import type { Metadata } from '../metadata/generatePageMetadata';
 import type { LoadContentResult } from '../rendering/helpers/loadContent';
@@ -30,6 +31,8 @@ export interface CatchAllContext {
      * visual theme/responsive infrastructure contract.
      */
     themeRuntime: SdkThemeRuntime;
+    /** Explicit rendering capabilities selected for this request. */
+    rendering: SdkRenderingMode;
     /** Search parameters from the URL (for filtering, pagination, etc.) */
     searchParams: DataLoaderSearchParams;
 }
@@ -138,7 +141,7 @@ type CatchAllThemeOptions = {
  * });
  * ```
  */
-export type CreateCatchAllPageOptions = {
+type CreateCatchAllPageBaseOptions = {
     /**
      * Function that returns the Riverbank client.
      * Called fresh on each request to support different caching strategies.
@@ -186,7 +189,6 @@ export type CreateCatchAllPageOptions = {
      * Wrap client-heavy dynamic imports with defineLazyBlockOverride(); raw
      * promise-returning functions are not lazy override registrations.
      */
-    blockOverrides?: BlockOverrideRegistrations;
     /**
      * Server-only host data loaders for custom blocks.
      *
@@ -286,12 +288,6 @@ export type CreateCatchAllPageOptions = {
     wrapper?: (props: {
         children: ReactNode;
     }) => ReactNode | Promise<ReactNode>;
-    /**
-     * Controls the runtime wrapper around rendered page content.
-     *
-     * @default { kind: 'responsive-only' }
-     */
-    themeRuntime?: SdkThemeRuntime;
     /**
      * Enable portal authentication for the reserved `/portal` customer route.
      *
@@ -315,7 +311,25 @@ export type CreateCatchAllPageOptions = {
      * ```
      */
     enablePortal?: boolean;
-} & CatchAllThemeOptions;
+};
+type ThemedCatchAllOptions = CatchAllThemeOptions & {
+    /** Default theme-backed rendering behavior. */
+    rendering?: never;
+    blockOverrides?: BlockOverrideRegistrations;
+    /** @default { kind: 'responsive-only' } */
+    themeRuntime?: SdkThemeRuntime;
+};
+type OverrideOnlyCatchAllOptions = {
+    /** Render exclusively through host-provided block overrides. */
+    rendering: SdkOverrideOnlyRendering;
+    blockOverrides: BlockOverrideRegistrations;
+    themeRuntime?: never;
+    theme?: never;
+    themes?: never;
+    themeSwitch?: never;
+    getTheme?: never;
+};
+export type CreateCatchAllPageOptions = CreateCatchAllPageBaseOptions & (ThemedCatchAllOptions | OverrideOnlyCatchAllOptions);
 /**
  * Next.js page props for catch-all routes.
  *

package/dist/_dts/sdk/src/preview-next/before-render.d.ts

@@ -1,14 +1,13 @@
-import type { ComponentType, ReactNode } from "react";
-import type { CatchAllContext } from "../next/types";
-import type { SdkPreviewModeProps } from "./client";
-type PreviewModeClientProps = Omit<SdkPreviewModeProps, "blockOverrides">;
+import type { ComponentType, ReactNode } from 'react';
+import type { CatchAllContext } from '../next/types';
+import type { SdkPreviewModePropsWithoutBlockOverrides } from './client';
 export type CreatePreviewModeBeforeRenderOptions = {
     getClient: () => {
         getBaseUrl(): string;
     };
     siteId: string;
     siteSlug: string;
-    PreviewModeClient: ComponentType<PreviewModeClientProps>;
+    PreviewModeClient: ComponentType<SdkPreviewModePropsWithoutBlockOverrides>;
     /**
      * When omitted, defaults to `process.env.RIVERBANK_PREVIEW_MODE === 'true'`.
      * This mirrors the scaffolds and makes it easy to keep preview wiring committed
@@ -34,4 +33,3 @@ export type CreatePreviewModeBeforeRenderOptions = {
  * (e.g. `SdkPreviewModeClient`) to avoid serializing functions over the RSC boundary.
  */
 export declare function createPreviewModeBeforeRender(options: CreatePreviewModeBeforeRenderOptions): (context: CatchAllContext) => Promise<ReactNode | null>;
-export {};

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

@@ -1,6 +1,6 @@
-import React, { type ReactNode } from "react";
-import type { PreviewShellLayoutProps, PreviewShellProps, SdkPreviewModeProps } from "../../../../preview-next/src/client/index";
-export type { SdkPreviewModeContent, SdkPreviewModeProps, PreviewThemeRuntime, PreviewThemeResponsiveMode, PreviewShellProps, PreviewShellLayoutProps, } from '../../../../preview-next/src/client/index';
+import React, { type ReactNode } from 'react';
+import type { PreviewShellLayoutProps, PreviewShellProps, SdkPreviewModeProps } from '../../../../preview-next/src/client/index';
+export type { SdkPreviewModeContent, SdkPreviewModeProps, SdkPreviewModePropsWithoutBlockOverrides, PreviewThemeRuntime, PreviewThemeResponsiveMode, PreviewShellProps, PreviewShellLayoutProps, } from '../../../../preview-next/src/client/index';
 type PreviewQueryProviderProps = Readonly<{
     children: ReactNode;
 }>;

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

@@ -2,7 +2,7 @@ import React from 'react';
 import type { PreviewShellLayoutProps, PreviewShellProps, SdkPreviewModeProps } from '../../../../preview-next/src/client/sdk-runtime';
 export { PreviewLayoutProvider, usePreviewLayout, useOptionalPreviewLayout, } from '../../../../preview-next/src/client/layout/PreviewLayoutContext';
 export { PreviewQueryProvider, createPreviewQueryClient, } from '../../../../preview-next/src/client/preview/PreviewQueryProvider';
-export type { PreviewShellProps, PreviewShellLayoutProps, SdkPreviewModeContent, SdkPreviewModeProps, } from '../../../../preview-next/src/client/sdk-runtime';
+export type { PreviewShellProps, PreviewShellLayoutProps, SdkPreviewModeContent, SdkPreviewModeProps, SdkPreviewModePropsWithoutBlockOverrides, } from '../../../../preview-next/src/client/sdk-runtime';
 export declare function SdkPreviewMode(props: SdkPreviewModeProps): React.JSX.Element;
 export declare function PreviewShell(props: PreviewShellProps): React.JSX.Element;
 export declare function PreviewShellLayout(props: PreviewShellLayoutProps): React.JSX.Element;

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,8 +3,18 @@ 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 MissingBlockOverrideError = Error & Readonly<{
+    code: 'missing_block_override';
+    blockKind: string;
+}>;
+type MissingBlockOverrideErrorConstructor = Readonly<{
+    new (blockKind: string): MissingBlockOverrideError;
+    prototype: MissingBlockOverrideError;
+}>;
+export declare const MissingBlockOverrideError: MissingBlockOverrideErrorConstructor;
 export type PageRendererDataContext = {
     siteId?: string;
     pageId?: string;
@@ -26,12 +36,16 @@ 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[];
 };
-export type PageRendererProps = {
-    theme: Theme;
+type PageRendererCommonProps = {
     page: PageOutline | null;
     runtimeBoundaries?: readonly PageRuntimeBoundary[];
     usePlaceholders?: boolean;
@@ -39,9 +53,24 @@ export type PageRendererProps = {
     routeMap?: RouteMap;
     wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;
     registry?: ComponentRegistry;
-    themeTokens?: ThemeTokens;
     blockOverrides?: BlockOverrides;
     sdkConfig?: SdkConfigForRenderer | null;
     customBlocks?: SdkCustomBlock[];
 };
+type ThemedPageRendererProps = PageRendererCommonProps & {
+    rendering?: never;
+    theme: Theme;
+    themeTokens?: ThemeTokens;
+};
+type OverrideOnlyPageRendererProps = PageRendererCommonProps & {
+    rendering: {
+        kind: 'overrides-only';
+    };
+    theme?: never;
+    themeTokens?: never;
+    blockOverrides: BlockOverrides;
+};
+export type PageRendererProps = ThemedPageRendererProps | OverrideOnlyPageRendererProps;
+export declare function toBlocksPageRendererDataContext(dataContext: PageRendererDataContext): BlocksPageRendererDataContext;
 export declare function PageRenderer(props: PageRendererProps): React.ReactElement;
+export {};

package/dist/_dts/sdk/src/rendering/components/Block.shared.d.ts

@@ -11,11 +11,10 @@ import type { RiverbankClient } from '../../client/types';
 import type { BlockKind } from '../../types';
 import type { BlockOverrideComponent } from '../overrides';
 export type { BlockOverrideComponent } from '../overrides';
-export type BlockProps = {
+type BlockCommonProps = {
     blockKind: BlockKind;
     blockId?: string | null;
     content: Record<string, unknown>;
-    theme: Theme;
     siteId?: string;
     /**
      * Supabase storage URL for direct image access in SSR output and client
@@ -63,6 +62,18 @@ export type BlockProps = {
      */
     override?: BlockOverrideComponent;
 };
+type ThemedBlockProps = BlockCommonProps & {
+    rendering?: never;
+    theme: Theme;
+};
+type OverrideOnlyBlockProps = BlockCommonProps & {
+    rendering: {
+        kind: 'overrides-only';
+    };
+    theme?: never;
+    override: BlockOverrideComponent;
+};
+export type BlockProps = ThemedBlockProps | OverrideOnlyBlockProps;
 export type BlockHydrationBootstrapConfig = {
     siteId?: string;
     supabaseUrl?: string;