@riverbankcms/sdk 0.128.0 → 0.129.0

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

@@ -7,7 +7,7 @@ import type { ContentTypeSchema } from '../../../../content-model/src/index';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
 import type { SurfaceId } from '../../../../surfaces/src/index';
 import { type PreviewBlock, type PreviewContentEntryData, type PreviewPageMetadata } from './PreviewEntryControllerProvider';
-import { type PreviewThemeRuntime } from './themeRuntime';
+import { type PreviewRenderingMode, type PreviewThemeRuntime } from './themeRuntime';
 import type { PreviewEditorSidebarProps, PreviewTemplateData } from './PreviewEditorSidebar';
 import { type PreviewRuntimeSession } from '../../auth-contract';
 type BaseFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
@@ -20,7 +20,7 @@ export type PreviewDesignEditorEligibility = Readonly<{
 }> | Readonly<{
     kind: 'unsupported';
 }>;
-export type PreviewShellProps = {
+type PreviewShellCommonProps = {
     children: ReactNode;
     apiBaseUrl: string;
     blockApiConfig: ComponentProps<typeof BlockApiProvider>['config'];
@@ -36,13 +36,11 @@ export type PreviewShellProps = {
      * saves are computed against this theme, so it must never carry
      * page-derived adaptations.
      */
-    theme: Theme;
     /**
      * Page-adapted theme used to render the preview document (e.g. opening-
      * foreground header adaptation). Render-only: never persisted. Falls back
      * to the canonical theme when absent.
      */
-    renderTheme?: Theme | null;
     themeId?: string | null;
     themeSelectionId?: string | null;
     themeSelectionVersion?: number | null;
@@ -76,14 +74,28 @@ export type PreviewShellProps = {
     mediaAssets?: readonly MediaAssetIndexItem[];
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     supabaseUrl?: string;
-    themeRuntime?: PreviewThemeRuntime;
     designEditorEligibility?: PreviewDesignEditorEligibility;
     /** Hides site-style controls when this runtime cannot persist design edits. */
     hideSiteStyleConfigurator?: boolean;
     baseFetch?: BaseFetch;
     onFooterSaved?: () => void;
 };
-export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, renderTheme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, supabaseUrl, themeRuntime, designEditorEligibility, hideSiteStyleConfigurator, baseFetch, onFooterSaved, }: PreviewShellProps): React.JSX.Element;
+type ThemedPreviewShellProps = PreviewShellCommonProps & {
+    rendering?: never;
+    theme: Theme;
+    renderTheme?: Theme | null;
+    themeRuntime?: PreviewThemeRuntime;
+};
+type OverrideOnlyPreviewShellProps = PreviewShellCommonProps & {
+    rendering: Extract<PreviewRenderingMode, {
+        kind: 'overrides-only';
+    }>;
+    theme?: never;
+    renderTheme?: never;
+    themeRuntime?: never;
+};
+export type PreviewShellProps = ThemedPreviewShellProps | OverrideOnlyPreviewShellProps;
+export declare function PreviewShell(props: PreviewShellProps): React.JSX.Element;
 export declare function defaultDesignEditorEligibility(input: Readonly<{
     pageId: string | null;
     entryData?: PreviewContentEntryData | null;

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

@@ -1,23 +1,16 @@
-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 { HeaderSelectionContext, FooterLookId, HeaderLayoutId, HeaderLookId, HeaderStyleId } from "../../../../theme-core/src/site-styles/index";
-import type { ContentTypeSchema } from "../../../../content-model/src/index";
-import type { ApiClient } from "../../../../api/src/request";
-import type { SdkConfigForBlockPicker } from "../../../../editor-blocks/src/index";
-import type { SurfaceId } from "../../../../surfaces/src/index";
-import { type PreviewEntryData, type PreviewTemplateData } from "./PreviewEditorSidebar";
-import { type SiteStyleAccess } from "./siteStyleAccess";
-import { type PreviewThemeRuntime } from "./themeRuntime";
-export type PreviewShellLayoutProps = {
+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 { HeaderSelectionContext, FooterLookId, HeaderLayoutId, HeaderLookId, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
+import type { ContentTypeSchema } from '../../../../content-model/src/index';
+import type { ApiClient } from '../../../../api/src/request';
+import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
+import type { SurfaceId } from '../../../../surfaces/src/index';
+import { type PreviewEntryData, type PreviewTemplateData } from './PreviewEditorSidebar';
+import { type SiteStyleAccess } from './siteStyleAccess';
+import { type PreviewRenderingMode, type PreviewThemeRuntime } from './themeRuntime';
+type PreviewShellLayoutCommonProps = {
     children: ReactNode;
-    /** Canonical site theme — persistence/configurator base, never page-adapted. */
-    theme: Theme;
-    /**
-     * Page-adapted theme for rendering the preview document. Render-only;
-     * falls back to the canonical theme when absent.
-     */
-    renderTheme?: Theme | null;
     surfaceId: SurfaceId;
     siteId: string;
     dashboardBaseUrl?: string | null;
@@ -45,8 +38,24 @@ export type PreviewShellLayoutProps = {
     assistantPanel?: ReactNode;
     sdkConfig?: SdkConfigForBlockPicker | null;
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
-    themeRuntime?: PreviewThemeRuntime;
     siteStyleAccess?: SiteStyleAccess;
     onFooterSaved?: () => void;
 };
-export declare function PreviewShellLayout({ children, theme, renderTheme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, bookingOfferingPresets, themeRuntime, siteStyleAccess, onFooterSaved, }: PreviewShellLayoutProps): React.JSX.Element;
+type ThemedPreviewShellLayoutProps = PreviewShellLayoutCommonProps & {
+    rendering?: never;
+    /** Canonical persistence/configurator base, never page-adapted. */
+    theme: Theme;
+    renderTheme?: Theme | null;
+    themeRuntime?: PreviewThemeRuntime;
+};
+type OverrideOnlyPreviewShellLayoutProps = PreviewShellLayoutCommonProps & {
+    rendering: Extract<PreviewRenderingMode, {
+        kind: 'overrides-only';
+    }>;
+    theme?: never;
+    renderTheme?: never;
+    themeRuntime?: never;
+};
+export type PreviewShellLayoutProps = ThemedPreviewShellLayoutProps | OverrideOnlyPreviewShellLayoutProps;
+export declare function PreviewShellLayout(props: PreviewShellLayoutProps): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
+export {};

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

@@ -1,13 +1,13 @@
-import React, { type ReactElement, type ReactNode } from "react";
-import { type SiteChromeRenderModel } from "../../../../blocks/src/client/site-chrome";
-import type { ViewportMode } from "./PreviewViewportControls";
-import { type PreviewThemeRuntime } from "./themeRuntime";
+import React, { type ReactElement, type ReactNode } from 'react';
+import { type SiteChromeRenderModel } from '../../../../blocks/src/client/site-chrome';
+import type { ViewportMode } from './PreviewViewportControls';
+import { type PreviewThemeRuntime } from './themeRuntime';
 export declare function PreviewThemedSiteDocument({ children, themeRuntime, useContainerResponsiveMode, viewportMode, viewportWidth, scale, contentHeight, scaleContainerRef, contentRef, staticHeaderNode, bannerNode, staticFooterNode, siteChromeRenderModel, }: {
     children: ReactNode;
     themeRuntime?: PreviewThemeRuntime;
     useContainerResponsiveMode: boolean;
     viewportMode: ViewportMode;
-    viewportWidth: number | "full";
+    viewportWidth: number | 'full';
     scale: number;
     contentHeight: number;
     scaleContainerRef: (node: HTMLDivElement | null) => void;
@@ -17,3 +17,16 @@ export declare function PreviewThemedSiteDocument({ children, themeRuntime, useC
     staticFooterNode: ReactNode;
     siteChromeRenderModel: SiteChromeRenderModel | null;
 }): ReactElement | null;
+export declare function PreviewOverrideOnlySiteDocument({ children, runtime, useContainerResponsiveMode, viewportMode, viewportWidth, scale, contentHeight, scaleContainerRef, contentRef, }: {
+    children: ReactNode;
+    runtime: Extract<PreviewThemeRuntime, {
+        kind: 'responsive-only' | 'none';
+    }>;
+    useContainerResponsiveMode: boolean;
+    viewportMode: ViewportMode;
+    viewportWidth: number | 'full';
+    scale: number;
+    contentHeight: number;
+    scaleContainerRef: (node: HTMLDivElement | null) => void;
+    contentRef: React.RefObject<HTMLDivElement | null>;
+}): ReactElement | null;

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

@@ -1,6 +1,15 @@
 import type { ThemeResponsiveMode, ThemeRuntime } from '../../../../theme-core/src/index';
 export type PreviewThemeResponsiveMode = ThemeResponsiveMode;
 export type PreviewThemeRuntime = ThemeRuntime;
+export type PreviewRenderingMode = Readonly<{
+    kind: 'themed';
+    themeRuntime: PreviewThemeRuntime;
+}> | Readonly<{
+    kind: 'overrides-only';
+    runtime: Extract<PreviewThemeRuntime, {
+        kind: 'responsive-only' | 'none';
+    }>;
+}>;
 export declare const defaultPreviewThemeRuntime: {
     readonly kind: "cms-theme";
 };

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

@@ -1,8 +1,8 @@
-import type { MediaAssetIndexItem } from "../../../../blocks/src/index";
-import type { SurfaceId } from "../../../../surfaces/src/index";
-import type { PreviewRuntimeSession } from "../../auth-contract";
-import type { PreviewThemeRuntime } from "../preview/themeRuntime";
-export { SdkPreviewModeRuntime as SdkPreviewMode } from "./SdkPreviewModeRuntime";
+import type { MediaAssetIndexItem } from '../../../../blocks/src/index';
+import type { SurfaceId } from '../../../../surfaces/src/index';
+import type { PreviewRuntimeSession } from '../../auth-contract';
+import type { PreviewRenderingMode, PreviewThemeRuntime } from '../preview/themeRuntime';
+export { SdkPreviewModeRuntime as SdkPreviewMode } from './SdkPreviewModeRuntime';
 export type SdkPreviewModeContent = {
     page: unknown;
     pageId: string;
@@ -18,7 +18,8 @@ export type SdkPreviewModeContent = {
     supabaseUrl?: string;
     mediaAssets?: MediaAssetIndexItem[];
 };
-export type SdkPreviewModeProps = {
+export type SdkPreviewRenderingMode = PreviewRenderingMode;
+type SdkPreviewModeCommonProps = {
     apiBaseUrl: string;
     dashboardBaseUrl?: string | null;
     siteId: string;
@@ -27,6 +28,20 @@ export type SdkPreviewModeProps = {
     previewSession: PreviewRuntimeSession | null;
     previewToken: string;
     content: SdkPreviewModeContent;
+};
+type ThemedSdkPreviewModeProps = SdkPreviewModeCommonProps & {
+    rendering?: Extract<PreviewRenderingMode, {
+        kind: 'themed';
+    }>;
     blockOverrides?: unknown;
     themeRuntime?: PreviewThemeRuntime;
 };
+type OverrideOnlySdkPreviewModeProps = SdkPreviewModeCommonProps & {
+    rendering: Extract<PreviewRenderingMode, {
+        kind: 'overrides-only';
+    }>;
+    blockOverrides: unknown;
+    themeRuntime?: never;
+};
+export type SdkPreviewModeProps = ThemedSdkPreviewModeProps | OverrideOnlySdkPreviewModeProps;
+export type SdkPreviewModePropsWithoutBlockOverrides = SdkPreviewModeProps extends infer Props ? Props extends unknown ? Omit<Props, 'blockOverrides'> : never : never;

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

@@ -1,8 +1,8 @@
-export { PreviewLayoutProvider, usePreviewLayout, useOptionalPreviewLayout, } from "./layout/PreviewLayoutContext";
-export { PreviewQueryProvider, createPreviewQueryClient, } from "./preview/PreviewQueryProvider";
-export { PreviewShell } from "./preview/PreviewShell";
-export type { PreviewShellProps } from "./preview/PreviewShell";
-export { PreviewShellLayout } from "./preview/PreviewShellLayout";
-export type { PreviewShellLayoutProps } from "./preview/PreviewShellLayout";
-export type { SdkPreviewModeContent, SdkPreviewModeProps, } from "./sdk/SdkPreviewMode";
-export { SdkPreviewMode } from "./sdk/SdkPreviewMode";
+export { PreviewLayoutProvider, usePreviewLayout, useOptionalPreviewLayout, } from './layout/PreviewLayoutContext';
+export { PreviewQueryProvider, createPreviewQueryClient, } from './preview/PreviewQueryProvider';
+export { PreviewShell } from './preview/PreviewShell';
+export type { PreviewShellProps } from './preview/PreviewShell';
+export { PreviewShellLayout } from './preview/PreviewShellLayout';
+export type { PreviewShellLayoutProps } from './preview/PreviewShellLayout';
+export type { SdkPreviewModeContent, SdkPreviewModeProps, SdkPreviewModePropsWithoutBlockOverrides, } from './sdk/SdkPreviewMode';
+export { SdkPreviewMode } from './sdk/SdkPreviewMode';

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/rendering/blocks-page-renderer.d.ts

@@ -6,6 +6,15 @@ 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;
@@ -36,8 +45,7 @@ export type BlocksPageRendererDataContext = Omit<PageRendererDataContext, 'media
 export type SdkConfigForRenderer = {
     customBlocks?: SdkCustomBlock[];
 };
-export type PageRendererProps = {
-    theme: Theme;
+type PageRendererCommonProps = {
     page: PageOutline | null;
     runtimeBoundaries?: readonly PageRuntimeBoundary[];
     usePlaceholders?: boolean;
@@ -45,10 +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;

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

@@ -6,32 +6,34 @@
 import { buildMenu, buildFooterMenu, buildFooterMenuForRole, buildLogo } from '../../navigation';
 import type { RiverbankClient, SiteResponse } from '../../client/types';
 import { type SdkThemeRuntime } from '../themeRuntime';
-export type HeaderData = {
+import { type SdkOverrideOnlyRendering } from '../renderingMode';
+export type CustomHeaderData = {
     menu: ReturnType<typeof buildMenu>;
     logo: ReturnType<typeof buildLogo>;
     site: SiteResponse['site'];
-    theme: SiteResponse['theme'];
     routes: SiteResponse['routes'];
 };
-export type FooterData = {
+export type CustomFooterData = {
     menu: ReturnType<typeof buildMenu>;
     footerMenu: ReturnType<typeof buildFooterMenu>;
     legalFooterMenu: ReturnType<typeof buildFooterMenuForRole>;
     logo: ReturnType<typeof buildLogo>;
     site: SiteResponse['site'];
-    theme: SiteResponse['theme'];
     routes: SiteResponse['routes'];
 };
-export type LayoutProps = {
+export type HeaderData = CustomHeaderData & {
+    theme: SiteResponse['theme'];
+};
+export type FooterData = CustomFooterData & {
+    theme: SiteResponse['theme'];
+};
+type LayoutCommonProps = {
     siteData?: SiteResponse;
     client?: RiverbankClient;
     siteId?: string;
     slug?: string;
     domain?: string;
     children: React.ReactNode;
-    header?: boolean | ((data: HeaderData) => React.ReactNode);
-    footer?: boolean | ((data: FooterData) => React.ReactNode);
-    headerVariant?: 'classic' | 'centered' | 'transparent' | 'floating';
     /**
      * Whether the current request has an active portal session.
      * Used to resolve portal navigation labels (e.g. "Login" vs "My account").
@@ -41,17 +43,27 @@ export type LayoutProps = {
     hasPortalSession?: boolean;
     /** Render stage for internal links and block transforms. */
     previewStage?: 'published' | 'preview';
-    /**
-     * Controls the runtime wrapper around SDK layout content.
-     *
-     * - cms-theme: inject CMS theme variables and component CSS
-     * - responsive-only: keep the responsive utility root without CMS theme styles
-     * - none: render no SDK runtime wrapper; only safe with fully custom chrome
-     *
-     * @default { kind: 'cms-theme' }
-     */
+};
+type ThemedLayoutProps = LayoutCommonProps & {
+    rendering?: never;
+    header?: boolean | ((data: HeaderData) => React.ReactNode);
+    footer?: boolean | ((data: FooterData) => React.ReactNode);
+    headerVariant?: 'classic' | 'centered' | 'transparent' | 'floating';
     themeRuntime?: SdkThemeRuntime;
 };
+type OverrideOnlyLayoutProps = LayoutCommonProps & {
+    rendering: SdkOverrideOnlyRendering;
+    header: false | ((data: CustomHeaderData) => React.ReactNode);
+    footer: false | ((data: CustomFooterData) => React.ReactNode);
+    headerVariant?: never;
+    themeRuntime?: never;
+};
+export type LayoutProps = ThemedLayoutProps | OverrideOnlyLayoutProps;
+export declare class UnsupportedOverrideOnlyLayoutChromeError extends Error {
+    readonly surface: 'header' | 'footer';
+    readonly code = "unsupported_override_only_layout_chrome";
+    constructor(surface: 'header' | 'footer');
+}
 /**
  * Layout component that wraps content with site header and footer.
  *
@@ -87,4 +99,5 @@ export type LayoutProps = {
  * </Layout>
  * ```
  */
-export declare function Layout({ siteData: providedSiteData, client, siteId, slug, domain, children, header, footer, headerVariant, hasPortalSession, previewStage, themeRuntime, }: LayoutProps): Promise<import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>>;
+export declare function Layout(props: LayoutProps): Promise<import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>>;
+export {};