@riverbankcms/sdk 0.126.0 → 0.127.0

package/dist/_dts/db/src/generated/supabase/database.types.d.ts

@@ -15698,53 +15698,6 @@ export type Database = {
                     }
                 ];
             };
-            site_palettes: {
-                Row: {
-                    canonical_color_hash: string;
-                    colors: Json;
-                    created_at: string;
-                    id: string;
-                    mode: string;
-                    origin_kind: string;
-                    origin_reference: string | null;
-                    site_id: string;
-                    updated_at: string;
-                    version: number;
-                };
-                Insert: {
-                    canonical_color_hash: string;
-                    colors: Json;
-                    created_at?: string;
-                    id?: string;
-                    mode: string;
-                    origin_kind: string;
-                    origin_reference?: string | null;
-                    site_id: string;
-                    updated_at?: string;
-                    version?: number;
-                };
-                Update: {
-                    canonical_color_hash?: string;
-                    colors?: Json;
-                    created_at?: string;
-                    id?: string;
-                    mode?: string;
-                    origin_kind?: string;
-                    origin_reference?: string | null;
-                    site_id?: string;
-                    updated_at?: string;
-                    version?: number;
-                };
-                Relationships: [
-                    {
-                        foreignKeyName: "site_palettes_site_id_fkey";
-                        columns: ["site_id"];
-                        isOneToOne: false;
-                        referencedRelation: "sites";
-                        referencedColumns: ["id"];
-                    }
-                ];
-            };
             site_proposal_selections: {
                 Row: {
                     created_at: string;
@@ -16227,9 +16180,7 @@ export type Database = {
             };
             site_theme_selections: {
                 Row: {
-                    active_curated_palette_value_key: string | null;
-                    active_site_palette_id: string | null;
-                    button_personality_id: string | null;
+                    button_style_id: string | null;
                     button_style_options: Json;
                     created_at: string;
                     footer_look_id: string | null;
@@ -16246,9 +16197,7 @@ export type Database = {
                     user_id: string;
                 };
                 Insert: {
-                    active_curated_palette_value_key?: string | null;
-                    active_site_palette_id?: string | null;
-                    button_personality_id?: string | null;
+                    button_style_id?: string | null;
                     button_style_options?: Json;
                     created_at?: string;
                     footer_look_id?: string | null;
@@ -16265,9 +16214,7 @@ export type Database = {
                     user_id: string;
                 };
                 Update: {
-                    active_curated_palette_value_key?: string | null;
-                    active_site_palette_id?: string | null;
-                    button_personality_id?: string | null;
+                    button_style_id?: string | null;
                     button_style_options?: Json;
                     created_at?: string;
                     footer_look_id?: string | null;
@@ -16284,13 +16231,6 @@ export type Database = {
                     user_id?: string;
                 };
                 Relationships: [
-                    {
-                        foreignKeyName: "site_theme_selections_active_site_palette_fkey";
-                        columns: ["active_site_palette_id", "site_id"];
-                        isOneToOne: false;
-                        referencedRelation: "site_palettes";
-                        referencedColumns: ["id", "site_id"];
-                    },
                     {
                         foreignKeyName: "site_theme_selections_site_id_fkey";
                         columns: ["site_id"];
@@ -18818,7 +18758,7 @@ export type Database = {
             apply_site_theme_command_atomic: {
                 Args: {
                     p_base_selection_version: number;
-                    p_button_personality_id: string;
+                    p_button_style_id: string;
                     p_button_style_options: Json;
                     p_footer_look_id?: string;
                     p_header_layout_id?: string;
@@ -18836,31 +18776,6 @@ export type Database = {
                     theme_id: string;
                 }[];
             };
-            apply_site_theme_command_authoritative_atomic_v2: {
-                Args: {
-                    p_base_selection_version: number;
-                    p_button_personality_id: string;
-                    p_button_style_options: Json;
-                    p_footer_look_id: string;
-                    p_header_layout_id?: string;
-                    p_header_look_id: string;
-                    p_header_style_id?: string;
-                    p_palette_command: Json;
-                    p_selection_id?: string;
-                    p_site_id: string;
-                    p_theme: Json;
-                };
-                Returns: {
-                    active_curated_palette_value_key: string;
-                    active_site_palette_id: string;
-                    outcome: string;
-                    selection_id: string;
-                    selection_updated_at: string;
-                    site_palette_version: number;
-                    style_selection_version: number;
-                    theme_id: string;
-                }[];
-            };
             apply_successful_order_payment_atomic: {
                 Args: {
                     p_allocations: Json;
@@ -19236,6 +19151,21 @@ export type Database = {
                     site_id: string;
                 }[];
             };
+            claim_dated_offering_waitlist_capacity_effects_v3_atomic: {
+                Args: {
+                    p_claim_ttl?: unknown;
+                    p_limit?: number;
+                    p_now: string;
+                };
+                Returns: {
+                    claim_token: string;
+                    effect_id: string;
+                    event_series_id: string;
+                    reason: string;
+                    seats_delta: number;
+                    site_id: string;
+                }[];
+            };
             claim_due_appointment_payment_requests: {
                 Args: {
                     p_claim_ttl_seconds?: number;
@@ -20334,12 +20264,6 @@ export type Database = {
                 };
                 Returns: Json;
             };
-            is_complete_palette_colors: {
-                Args: {
-                    p_colors: Json;
-                };
-                Returns: boolean;
-            };
             is_email_allowed: {
                 Args: {
                     p_email: string;
@@ -20895,41 +20819,19 @@ export type Database = {
             };
             provision_initial_site_theme_atomic: {
                 Args: {
-                    p_button_personality_id: string;
-                    p_button_style_options: Json;
-                    p_footer_look_id?: string;
-                    p_header_layout_id?: string;
-                    p_header_look_id?: string;
-                    p_header_style_id?: string;
-                    p_site_id: string;
-                    p_theme: Json;
-                    p_user_id: string;
-                };
-                Returns: {
-                    outcome: string;
-                    selection_id: string;
-                    theme_id: string;
-                }[];
-            };
-            provision_initial_site_theme_authoritative_atomic_v2: {
-                Args: {
-                    p_button_personality_id: string;
+                    p_button_style_id: string;
                     p_button_style_options: Json;
                     p_footer_look_id?: string;
                     p_header_layout_id?: string;
                     p_header_look_id?: string;
                     p_header_style_id?: string;
-                    p_palette_command: Json;
                     p_site_id: string;
                     p_theme: Json;
                     p_user_id: string;
                 };
                 Returns: {
-                    active_curated_palette_value_key: string;
-                    active_site_palette_id: string;
                     outcome: string;
                     selection_id: string;
-                    site_palette_version: number;
                     theme_id: string;
                 }[];
             };
@@ -21313,6 +21215,26 @@ export type Database = {
                     revocation_outcome: string;
                 }[];
             };
+            revoke_dated_offering_consumed_registration_v3_atomic: {
+                Args: {
+                    p_enrollment_id: string;
+                    p_event_series_id: string;
+                    p_hold_id: string;
+                    p_intent: string;
+                    p_now: string;
+                    p_order_item_id?: string;
+                    p_refund_id?: string;
+                    p_refunded_amount_cents?: number;
+                    p_site_id: string;
+                    p_waitlist_effect?: string;
+                };
+                Returns: {
+                    audit_event_id: string;
+                    enrollment_id: string;
+                    hold_id: string;
+                    revocation_outcome: string;
+                }[];
+            };
             revoke_dated_offering_non_cash_registration_v1_atomic: {
                 Args: {
                     p_enrollment_id: string;
@@ -21342,6 +21264,20 @@ export type Database = {
                     revocation_outcome: string;
                 }[];
             };
+            revoke_dated_offering_non_cash_registration_v3_atomic: {
+                Args: {
+                    p_enrollment_id: string;
+                    p_event_series_id: string;
+                    p_now: string;
+                    p_order_item_id: string;
+                    p_site_id: string;
+                    p_waitlist_effect?: string;
+                };
+                Returns: {
+                    enrollment_id: string;
+                    revocation_outcome: string;
+                }[];
+            };
             revoke_historical_whole_series_registration_v1_atomic: {
                 Args: {
                     p_enrollment_id: string;
@@ -21370,7 +21306,7 @@ export type Database = {
             };
             save_current_theme_aggregate_atomic: {
                 Args: {
-                    p_button_personality_id: string;
+                    p_button_style_id: string;
                     p_button_style_options: Json;
                     p_expected_selection_version: number;
                     p_footer_look_id?: string;
@@ -21393,35 +21329,6 @@ export type Database = {
                     theme_id: string;
                 }[];
             };
-            save_current_theme_aggregate_authoritative_atomic_v2: {
-                Args: {
-                    p_button_personality_id: string;
-                    p_button_style_options: Json;
-                    p_expected_selection_version: number;
-                    p_footer_look_id: string;
-                    p_header_layout_id?: string;
-                    p_header_look_id: string;
-                    p_header_style_id?: string;
-                    p_palette_command: Json;
-                    p_selection_id?: string;
-                    p_selection_overrides: Json;
-                    p_selection_overrides_mode: string;
-                    p_site_id: string;
-                    p_theme: Json;
-                    p_theme_id?: string;
-                    p_user_id: string;
-                };
-                Returns: {
-                    active_curated_palette_value_key: string;
-                    active_site_palette_id: string;
-                    outcome: string;
-                    selection_id: string;
-                    selection_updated_at: string;
-                    site_palette_version: number;
-                    style_selection_version: number;
-                    theme_id: string;
-                }[];
-            };
             select_dated_offering_run_cancellation_settlement_v1_atomic: {
                 Args: {
                     p_enrollment_id: string;
@@ -21485,13 +21392,6 @@ export type Database = {
                 };
                 Returns: boolean;
             };
-            site_palette_canonical_hash: {
-                Args: {
-                    p_colors: Json;
-                    p_mode: string;
-                };
-                Returns: string;
-            };
             staff_member_has_customer_record_relationship: {
                 Args: {
                     p_customer_id: string;
@@ -21976,6 +21876,43 @@ export type Database = {
                     pricing_option_id: string;
                 }[];
             };
+            waitlist_allocate_event_occurrence_holds_v1: {
+                Args: {
+                    p_attendance_mode: string;
+                    p_event_occurrence_id: string;
+                    p_hold_payloads?: Json;
+                    p_site_id: string;
+                };
+                Returns: {
+                    attendance_mode: string | null;
+                    cancelled_at: string | null;
+                    consumed_at: string | null;
+                    course_id: string | null;
+                    created_at: string;
+                    email_delivery_status: string;
+                    event_occurrence_id: string | null;
+                    event_series_id: string | null;
+                    expired_at: string | null;
+                    expires_at: string;
+                    id: string;
+                    last_emailed_at: string | null;
+                    metadata: Json;
+                    reserved_at: string;
+                    site_id: string;
+                    status: string;
+                    subject_kind: string;
+                    token_public_id: string;
+                    token_secret_hash: string;
+                    updated_at: string;
+                    waitlist_entry_id: string;
+                }[];
+                SetofOptions: {
+                    from: "*";
+                    to: "waitlist_holds";
+                    isOneToOne: false;
+                    isSetofReturn: true;
+                };
+            };
             waitlist_allocate_holds: {
                 Args: {
                     p_attendance_mode?: string;
@@ -22098,6 +22035,21 @@ export type Database = {
                     consumed: boolean;
                 }[];
             };
+            waitlist_event_occurrence_capacity_snapshot_v1: {
+                Args: {
+                    p_attendance_mode: string;
+                    p_event_occurrence_id: string;
+                    p_now?: string;
+                    p_site_id: string;
+                };
+                Returns: {
+                    active_hold_seats: number;
+                    available_seats: number;
+                    capacity: number;
+                    is_unbounded: boolean;
+                    occupied_seats: number;
+                }[];
+            };
             waitlist_expire_due_holds: {
                 Args: {
                     p_hold_id?: string;
@@ -22172,6 +22124,42 @@ export type Database = {
                     hold_waitlist_entry_id: string;
                 }[];
             };
+            waitlist_expire_due_holds_v3: {
+                Args: {
+                    p_hold_id?: string;
+                    p_limit?: number;
+                    p_now?: string;
+                };
+                Returns: {
+                    entry_attendance_mode: string;
+                    entry_customer_email: string;
+                    entry_customer_id: string;
+                    entry_customer_name: string;
+                    entry_customer_phone: string;
+                    entry_event_occurrence_id: string;
+                    entry_event_series_id: string;
+                    entry_form_snapshot: Json;
+                    entry_id: string;
+                    entry_joined_at: string;
+                    entry_metadata: Json;
+                    entry_site_id: string;
+                    entry_source: string;
+                    entry_status: string;
+                    entry_subject_kind: string;
+                    hold_attendance_mode: string;
+                    hold_email_delivery_status: string;
+                    hold_event_occurrence_id: string;
+                    hold_event_series_id: string;
+                    hold_expires_at: string;
+                    hold_id: string;
+                    hold_site_id: string;
+                    hold_status: string;
+                    hold_subject_kind: string;
+                    hold_token_public_id: string;
+                    hold_token_secret_hash: string;
+                    hold_waitlist_entry_id: string;
+                }[];
+            };
             waitlist_subject_capacity_snapshot: {
                 Args: {
                     p_attendance_mode?: string;

package/dist/_dts/editor-blocks/src/BlockEditor.d.ts

@@ -23,6 +23,10 @@ type UiState = {
         isPathEdited: (blockId: Parameters<DraftsSlice['setAtPath']>[0], path: string) => boolean;
         showAllValidation: (blockId: Parameters<DraftsSlice['setAtPath']>[0]) => boolean;
         getBlockSaveability: (blockId: Parameters<DraftsSlice['setAtPath']>[0]) => BlockDraftSaveability;
+        setValidationManifests: (manifests: readonly Readonly<{
+            blockId: Parameters<DraftsSlice['setAtPath']>[0];
+            manifest: import('../../blocks/src/index').BlockManifest;
+        }>[]) => void;
     };
     structure: {
         getList: () => readonly BlockItem[];

package/dist/_dts/editor-blocks/src/block-editor/hooks/useBlockValidationManifests.d.ts

@@ -0,0 +1,26 @@
+import { type BlockManifest, type Theme } from '../../../../blocks/src/index';
+import type { SdkBlockFieldExtensionsMap, SdkBlockFieldOptionsMap } from '../../../../block-form/src/client/index';
+import { type EditorBlockId } from '../../../../core/src/index';
+import type { BlockItem } from '../types';
+import { type CustomBlockRegistryEntry, type SdkConfigForBlockPicker } from '../sdkBlockMerger';
+type ValidationManifestStore = Readonly<{
+    getState: () => Readonly<{
+        blockValidation: Readonly<{
+            setValidationManifests: (entries: readonly Readonly<{
+                blockId: EditorBlockId;
+                manifest: BlockManifest;
+            }>[]) => void;
+        }>;
+    }>;
+}>;
+export declare function useBlockValidationManifests(input: Readonly<{
+    blockList: readonly BlockItem[];
+    uiStore: ValidationManifestStore;
+    sdkConfig: SdkConfigForBlockPicker | null;
+    customBlocks: readonly CustomBlockRegistryEntry[];
+    theme?: Theme | null;
+    blockFieldOptions: SdkBlockFieldOptionsMap | null;
+    blockFieldExtensions: SdkBlockFieldExtensionsMap | null;
+    hideThemeV2RawStyleFields: boolean;
+}>): void;
+export {};

package/dist/_dts/editor-blocks/src/widgets/rich-text/imageInsert.d.ts

@@ -1,4 +1,4 @@
-import type { MediaAssetWithLabels } from '@riverbankcms/media-storage-supabase';
+import type { IdentifierReadyMediaAsset } from '../../../../media-editor/src/index';
 export declare const RICH_TEXT_IMAGE_MAX_WIDTH = 1920;
 export declare const RICH_TEXT_IMAGE_QUALITY = 85;
 export type RichTextImageInsertAttrs = {
@@ -9,9 +9,9 @@ export type RichTextImageInsertAttrs = {
     height?: number;
 };
 type BuildRichTextImageInsertAttrsArgs = {
-    asset: MediaAssetWithLabels;
+    asset: IdentifierReadyMediaAsset;
     supabaseUrl?: string | null;
     fallbackSrc?: string | null;
 };
-export declare function buildRichTextImageInsertAttrs({ asset, supabaseUrl, fallbackSrc, }: BuildRichTextImageInsertAttrsArgs): RichTextImageInsertAttrs | null;
+export declare function buildRichTextImageInsertAttrs({ asset, supabaseUrl, fallbackSrc, }: BuildRichTextImageInsertAttrsArgs): RichTextImageInsertAttrs;
 export {};

package/dist/_dts/media-editor/src/MediaEditor.d.ts

@@ -5,10 +5,10 @@ import { type UploadIntentResolver, type VideoPrepIntentResolver } from '../../m
 import type { VideoPrepIntent } from '../../media-core/src/index';
 import { type CropDialogProps } from './CropDialog';
 import { type MediaPickerDialogProps, type MediaPickerPolicy } from './MediaPickerDialog';
-import type { MediaValue } from './types';
+import type { MediaValue, PersistableMediaValue } from './types';
 export type MediaEditorProps = {
     value: MediaValue | undefined;
-    onChange: (next: MediaValue | undefined) => void;
+    onChange: (next: PersistableMediaValue | undefined) => void;
     allowedKinds?: readonly MediaKind[];
     previewAspectRatio?: number;
     minSourceWidth?: number;

package/dist/_dts/media-editor/src/context.d.ts

@@ -2,7 +2,7 @@ import { type ReactNode } from 'react';
 import type { ApiClient } from '../../api/src/request';
 import type { MediaAssetWithLabels, MediaStorageRepo } from '@riverbankcms/media-storage-supabase';
 import type { UploadProgressHandler, UseApiMediaUploaderOptions } from '../../media-react/src/index';
-import type { MediaAssetIndex, ResolveImageUrlContext } from '../../blocks/src/index';
+import type { ResolveImageUrlContext } from '../../blocks/src/index';
 type MediaEditorUploaderOptions = Omit<UseApiMediaUploaderOptions, 'siteId' | 'apiClient' | 'bucket'>;
 export type MediaEditorContextValue = {
     siteId: string;
@@ -13,7 +13,6 @@ export type MediaEditorContextValue = {
     getPublicUrl: (asset: MediaAssetWithLabels) => string;
     registerMediaAsset: (asset: MediaAssetWithLabels) => void;
     bearerToken?: string | null;
-    mediaAssetIndex?: MediaAssetIndex;
     imageResolveContext: ResolveImageUrlContext;
 };
 export declare function MediaEditorContextProvider({ value, children, }: {

package/dist/_dts/media-editor/src/index.d.ts

@@ -14,5 +14,7 @@ export { MediaEditorProvider } from './provider';
 export type { MediaEditorProviderProps } from './provider';
 export { createMediaEditorProvider } from './createMediaEditorProvider';
 export { withRepeaterStackMediaFieldUi, withRepeaterThumbnailMediaFieldUi, withRepeaterThumbnailPickerOnlyMediaFieldUi, } from './fieldUi';
-export type { MediaValue, MediaTransform, MediaHotspot } from './types';
+export type { MediaValue, PersistableMediaValue, MediaTransform, MediaHotspot } from './types';
 export { DEFAULT_HOTSPOT } from './utils';
+export { buildPersistableMediaValue, mediaSelectionFailureMessage, prepareMediaAssetForSelection, } from './mediaSelection';
+export type { BuildPersistableMediaValueOptions, IdentifierReadyMediaAsset, PrepareMediaSelectionResult, } from './mediaSelection';

package/dist/_dts/media-editor/src/mediaSelection.d.ts

@@ -0,0 +1,32 @@
+import type { ApiClient } from '../../api/src/request';
+import { type MediaIdentifier } from '../../blocks/src/index';
+import type { MediaAssetWithLabels } from '@riverbankcms/media-storage-supabase';
+import type { MediaValue, PersistableMediaValue } from './types';
+export type IdentifierReadyMediaAsset = Omit<MediaAssetWithLabels, 'identifier'> & Readonly<{
+    identifier: MediaIdentifier;
+}>;
+export type PrepareMediaSelectionResult = Readonly<{
+    tag: 'ready';
+    asset: IdentifierReadyMediaAsset;
+}> | Readonly<{
+    tag: 'failed';
+    reason: 'identifier-assignment-failed';
+    error: unknown;
+}> | Readonly<{
+    tag: 'failed';
+    reason: 'identifier-missing-after-assignment';
+}>;
+type PrepareMediaSelectionFailure = Extract<PrepareMediaSelectionResult, {
+    tag: 'failed';
+}>;
+export declare function mediaSelectionFailureMessage(failure: PrepareMediaSelectionFailure): string;
+export type BuildPersistableMediaValueOptions = Readonly<{
+    asset: IdentifierReadyMediaAsset;
+    mediaKind: PersistableMediaValue['type'];
+    previousValue: MediaValue | undefined;
+    poster: MediaValue['poster'] | undefined;
+    publicUrl?: string;
+}>;
+export declare function buildPersistableMediaValue({ asset, mediaKind, previousValue, poster, publicUrl, }: BuildPersistableMediaValueOptions): PersistableMediaValue;
+export declare function prepareMediaAssetForSelection(apiClient: ApiClient, asset: MediaAssetWithLabels): Promise<PrepareMediaSelectionResult>;
+export {};

package/dist/_dts/media-editor/src/types.d.ts

@@ -1,5 +1,5 @@
 import type { ImageHotspot } from '../../media-react/src/index';
-import type { Media } from '../../blocks/src/index';
+import type { Media, PersistableMedia } from '../../blocks/src/index';
 export type MediaHotspot = ImageHotspot;
 export type MediaTransform = NonNullable<Media['transform']>;
 /**
@@ -7,3 +7,5 @@ export type MediaTransform = NonNullable<Media['transform']>;
  * and app consumers all speak the same content contract.
  */
 export type MediaValue = Media;
+/** A media editor output that satisfies the canonical block write contract. */
+export type PersistableMediaValue = PersistableMedia;

package/dist/_dts/media-editor/src/useMediaSelection.d.ts

@@ -0,0 +1,26 @@
+import type { MediaAssetWithLabels, MediaKind } from '@riverbankcms/media-storage-supabase';
+import type { MediaEditorContextValue } from './context';
+import type { MediaPickerAssetSelection } from './MediaPickerDialog';
+import type { MediaValue, PersistableMediaValue } from './types';
+export type MediaSelectionState = Readonly<{
+    tag: 'idle';
+}> | Readonly<{
+    tag: 'preparing';
+}> | Readonly<{
+    tag: 'failed';
+    message: string;
+}>;
+type UseMediaSelectionOptions = Readonly<{
+    context: MediaEditorContextValue;
+    value: MediaValue | undefined;
+    allowedKinds: readonly MediaKind[];
+    evaluateAssetSelection: (asset: MediaAssetWithLabels) => MediaPickerAssetSelection;
+    onChange: (next: PersistableMediaValue | undefined) => void;
+    onSelectionComplete: () => void;
+}>;
+export declare function useMediaSelection(options: UseMediaSelectionOptions): {
+    readonly cancelSelection: () => void;
+    readonly handleSelect: (picked: MediaAssetWithLabels) => Promise<void>;
+    readonly selectionState: MediaSelectionState;
+};
+export {};

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

@@ -35,6 +35,8 @@ export { PreviewShell } from "./preview/PreviewShell";
 export type { PreviewShellProps } from "./preview/PreviewShell";
 export { PreviewShellLayout } from "./preview/PreviewShellLayout";
 export type { PreviewShellLayoutProps } from "./preview/PreviewShellLayout";
+export { resolvePreviewThemeRoles } from "./preview/previewThemeRoles";
+export type { PreviewThemeRoles } from "./preview/previewThemeRoles";
 export type { PreviewFailureSource } from "./preview/usePreviewKeepAlive";
 export { usePreviewKeepAlive } from "./preview/usePreviewKeepAlive";
 export { EditablePageRenderer } from "./blocks/EditablePageRenderer";

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

@@ -0,0 +1,12 @@
+import type { SiteChromeCustomizeSurfaceState } from './siteChromeCustomizeTypes';
+export type HeaderMenuSurfaceState = Extract<SiteChromeCustomizeSurfaceState, {
+    kind: 'available';
+    surface: 'header';
+}>;
+export declare function isHeaderMenuSurfaceState(state: SiteChromeCustomizeSurfaceState): state is HeaderMenuSurfaceState;
+export declare function HeaderMenuControls({ state, disabled, onMenuFontChange, onMenuFontSizeChange, }: Readonly<{
+    state: HeaderMenuSurfaceState;
+    disabled?: boolean;
+    onMenuFontChange?: (value: HeaderMenuSurfaceState['menuFont']) => void;
+    onMenuFontSizeChange?: (value: HeaderMenuSurfaceState['menuFontSize']) => void;
+}>): import("react").JSX.Element;

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

@@ -31,7 +31,18 @@ export type PreviewShellProps = {
     previewToken: string;
     dashboardBaseUrl?: string | null;
     surfaceId: SurfaceId;
+    /**
+     * Canonical site theme — the persistence/configurator base. Site-style
+     * 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;
@@ -72,7 +83,7 @@ export type PreviewShellProps = {
     baseFetch?: BaseFetch;
     onFooterSaved?: () => void;
 };
-export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, 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;
+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;
 export declare function defaultDesignEditorEligibility(input: Readonly<{
     pageId: string | null;
     entryData?: PreviewContentEntryData | null;