@riverbankcms/sdk 0.126.0 → 0.128.0

package/dist/_dts/db/src/schemas/forms.d.ts

@@ -10,6 +10,19 @@ export declare const formPresentationSettingsSchema: z.ZodObject<{
     submitLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     templateKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strict>;
+export declare const contactFormDefinitionSettingsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"custom-contact">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"standard-contact">;
+    optionalFields: z.ZodObject<{
+        name: z.ZodObject<{
+            visible: z.ZodBoolean;
+        }, z.core.$strict>;
+        phone: z.ZodObject<{
+            visible: z.ZodBoolean;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "kind">;
 /**
  * Contact form settings
  * Used for general inquiry forms that send notifications to site owners
@@ -45,6 +58,19 @@ export declare const contactFormSettingsSchema: z.ZodObject<{
         }, z.core.$strict>>;
         emails: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
+    definition: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"custom-contact">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"standard-contact">;
+        optionalFields: z.ZodObject<{
+            name: z.ZodObject<{
+                visible: z.ZodBoolean;
+            }, z.core.$strict>;
+            phone: z.ZodObject<{
+                visible: z.ZodBoolean;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">>;
 }, z.core.$strict>;
 /**
  * Booking form settings
@@ -168,6 +194,19 @@ export declare const formSettingsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strict>>;
         emails: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
+    definition: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"custom-contact">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"standard-contact">;
+        optionalFields: z.ZodObject<{
+            name: z.ZodObject<{
+                visible: z.ZodBoolean;
+            }, z.core.$strict>;
+            phone: z.ZodObject<{
+                visible: z.ZodBoolean;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"booking">;
     serviceId: z.ZodOptional<z.ZodString>;
@@ -265,6 +304,19 @@ export declare const formSettingsInputSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         }, z.core.$strict>>;
         emails: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
+    definition: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"custom-contact">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"standard-contact">;
+        optionalFields: z.ZodObject<{
+            name: z.ZodObject<{
+                visible: z.ZodBoolean;
+            }, z.core.$strict>;
+            phone: z.ZodObject<{
+                visible: z.ZodBoolean;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">>;
     readonly submitLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     readonly templateKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strict>, z.ZodObject<{
@@ -344,6 +396,7 @@ export type BookingQuestionsFormSettings = z.infer<typeof bookingQuestionsFormSe
 export type FormSettings = z.infer<typeof formSettingsSchema>;
 export type FormPresentationSettings = z.infer<typeof formPresentationSettingsSchema>;
 export type FormSettingsInput = z.infer<typeof formSettingsInputSchema>;
+export type ContactFormDefinitionSettings = z.infer<typeof contactFormDefinitionSettingsSchema>;
 type JsonRecord = Record<string, unknown>;
 export declare function stripPresentationKeysFromBehaviorSettings(value: unknown): JsonRecord;
 export declare function extractFormPresentationSettings(input: Readonly<{
@@ -886,10 +939,14 @@ export declare function parseBookingQuestionsContent(shape: BookingQuestionsForm
  * Form creation payload schema
  * Validates the request body when creating a new form via API
  */
-export declare const formSlugSchema: z.ZodString;
+declare const formSlugBrand: unique symbol;
+export type FormSlug = string & {
+    readonly [formSlugBrand]: 'FormSlug';
+};
+export declare const formSlugSchema: z.ZodPipe<z.ZodString, z.ZodTransform<FormSlug, string>>;
 export declare const createFormPayloadSchema: z.ZodObject<{
     name: z.ZodString;
-    slug: z.ZodString;
+    slug: z.ZodPipe<z.ZodString, z.ZodTransform<FormSlug, string>>;
     schema: z.ZodObject<{
         version: z.ZodDefault<z.ZodString>;
         fields: z.ZodArray<z.ZodObject<{
@@ -961,6 +1018,19 @@ export declare const createFormPayloadSchema: z.ZodObject<{
             }, z.core.$strict>>;
             emails: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
+        definition: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"custom-contact">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"standard-contact">;
+            optionalFields: z.ZodObject<{
+                name: z.ZodObject<{
+                    visible: z.ZodBoolean;
+                }, z.core.$strict>;
+                phone: z.ZodObject<{
+                    visible: z.ZodBoolean;
+                }, z.core.$strict>;
+            }, z.core.$strict>;
+        }, z.core.$strict>], "kind">>;
         readonly submitLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         readonly templateKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strict>, z.ZodObject<{

package/dist/_dts/db/src/schemas/standard-contact.d.ts

@@ -0,0 +1,114 @@
+import { z } from 'zod';
+import { type ContactFormDefinitionSettings, type ContactFormSettings, type FormPresentationSettings, type FormSchema } from './forms';
+export declare const standardContactFormSchemaSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    fields: z.ZodTuple<[z.ZodObject<{
+        id: z.ZodLiteral<"name">;
+        label: z.ZodString;
+        type: z.ZodLiteral<"text">;
+        required: z.ZodLiteral<false>;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodLiteral<"email">;
+        label: z.ZodString;
+        type: z.ZodLiteral<"email">;
+        required: z.ZodLiteral<true>;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodLiteral<"phone">;
+        label: z.ZodString;
+        type: z.ZodLiteral<"tel">;
+        required: z.ZodLiteral<false>;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodLiteral<"message">;
+        label: z.ZodString;
+        type: z.ZodLiteral<"textarea">;
+        required: z.ZodLiteral<true>;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], null>;
+}, z.core.$strict>;
+export type StandardContactFormSchema = z.infer<typeof standardContactFormSchemaSchema>;
+type ContactSettingsFor<TKind extends ContactFormDefinitionSettings['kind']> = ContactFormSettings & Readonly<{
+    definition: Extract<ContactFormDefinitionSettings, {
+        kind: TKind;
+    }>;
+}>;
+export type ContactFormDefinition = Readonly<{
+    kind: 'custom-contact';
+    settings: ContactSettingsFor<'custom-contact'>;
+    schema: FormSchema;
+}> | Readonly<{
+    kind: 'standard-contact';
+    settings: ContactSettingsFor<'standard-contact'>;
+    schema: StandardContactFormSchema;
+}>;
+export type ContactFormDefinitionParseError = Readonly<{
+    kind: 'invalid-contact-settings';
+    issues: readonly string[];
+}> | Readonly<{
+    kind: 'invalid-custom-contact-schema';
+    issues: readonly string[];
+}> | Readonly<{
+    kind: 'invalid-standard-contact-schema';
+    issues: readonly string[];
+}>;
+export type ContactFormDefinitionParseResult = Readonly<{
+    ok: true;
+    value: ContactFormDefinition;
+}> | Readonly<{
+    ok: false;
+    error: ContactFormDefinitionParseError;
+}>;
+export declare function parseContactFormDefinition(input: Readonly<{
+    settingsJson: unknown;
+    schemaJson: unknown;
+}>): ContactFormDefinitionParseResult;
+export type StandardContactFormPatch = Readonly<{
+    name?: Readonly<{
+        label?: string;
+        placeholder?: string;
+        visible?: boolean;
+    }>;
+    email?: Readonly<{
+        label?: string;
+        placeholder?: string;
+    }>;
+    phone?: Readonly<{
+        label?: string;
+        placeholder?: string;
+        visible?: boolean;
+    }>;
+    message?: Readonly<{
+        label?: string;
+        placeholder?: string;
+    }>;
+}>;
+type StandardContactDefinition = Extract<ContactFormDefinition, {
+    kind: 'standard-contact';
+}>;
+export type StandardContactFormUpdateResult = Readonly<{
+    ok: true;
+    value: StandardContactDefinition;
+}> | Readonly<{
+    ok: false;
+    error: ContactFormDefinitionParseError;
+}>;
+export declare function createStandardContactFormDefinition(): Extract<ContactFormDefinition, {
+    kind: 'standard-contact';
+}>;
+export declare function updateStandardContactFormDefinition(current: StandardContactDefinition, patch: StandardContactFormPatch): StandardContactFormUpdateResult;
+export declare function projectStandardContactRenderedSchema(definition: Extract<ContactFormDefinition, {
+    kind: 'standard-contact';
+}>): FormSchema;
+export declare function projectStandardContactAsCustom(input: Readonly<{
+    definition: Extract<ContactFormDefinition, {
+        kind: 'standard-contact';
+    }>;
+    presentation: FormPresentationSettings;
+}>): Readonly<{
+    schema: FormSchema;
+    settings: ContactSettingsFor<'custom-contact'>;
+    presentation: FormPresentationSettings;
+}>;
+export {};

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/blocks/previewBatchLoaderParams.d.ts

@@ -0,0 +1,6 @@
+import { type APIEndpoints } from '../../../../api/src/index';
+type BatchBody = NonNullable<APIEndpoints['batchBlockLoaders']['body']>;
+type BatchRequest = BatchBody['requests'][number];
+export type PreviewBatchableLoaderEndpoint = BatchRequest['endpoint'];
+export declare function toPreviewBatchParams(endpoint: PreviewBatchableLoaderEndpoint, params: Record<string, string>): BatchRequest['params'];
+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/EntryEditorPanel.d.ts

@@ -2,7 +2,7 @@ import React, { type ReactNode } from 'react';
 import type { ApiClient } from '../../../../api/src/request';
 import { type ContentTypeSchema } from '../../../../content-model/src/index';
 import { type ZoomLevel } from '../../../../content-editor/src/index';
-import type { EntrySubrouteContextData, MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
+import type { EntrySubrouteContextData, Theme } from '../../../../blocks/src/index';
 import type { FieldWidgetComponent } from '../../../../block-form/src/client/index';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
 import { type ViewportMode, type ViewportWidth } from './PreviewViewportControls';
@@ -18,12 +18,9 @@ type EntryEditorPanelProps = {
     currentTemplate?: PreviewTemplateData | null;
     theme?: Theme | null;
     apiClient: ApiClient;
-    bearerToken?: string | null;
-    supabaseUrl?: string;
     entrySubrouteContext?: EntrySubrouteContextData | null;
     metadataPanel: ReactNode;
     linkedEntrySection?: PreviewLinkedEntrySidebarSection | null;
-    mediaAssets?: MediaAssetIndexItem[];
     widgets: Record<string, FieldWidgetComponent>;
     sdkConfig?: SdkConfigForBlockPicker | null;
     viewportMode: ViewportMode;
@@ -33,5 +30,5 @@ type EntryEditorPanelProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function EntryEditorPanel({ siteId, dashboardBaseUrl, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, metadataPanel, linkedEntrySection, mediaAssets, widgets, sdkConfig, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: EntryEditorPanelProps): React.JSX.Element;
+export declare function EntryEditorPanel({ siteId, dashboardBaseUrl, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, apiClient, entrySubrouteContext, metadataPanel, linkedEntrySection, widgets, sdkConfig, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: EntryEditorPanelProps): React.JSX.Element;
 export {};

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

@@ -1,6 +1,6 @@
 import React from "react";
 import type { ApiClient } from "../../../../api/src/request";
-import type { MediaAssetIndexItem, Theme } from "../../../../blocks/src/index";
+import type { Theme } from "../../../../blocks/src/index";
 import type { FieldWidgetComponent } from "../../../../block-form/src/client/index";
 import type { SdkConfigForBlockPicker } from "../../../../editor-blocks/src/index";
 type EntrySlotBlockEditorPanelProps = {
@@ -10,11 +10,8 @@ type EntrySlotBlockEditorPanelProps = {
     entryId: string;
     theme?: Theme | null;
     apiClient: ApiClient;
-    bearerToken?: string | null;
-    supabaseUrl?: string;
     sdkConfig?: SdkConfigForBlockPicker | null;
-    mediaAssets?: MediaAssetIndexItem[];
     widgets: Record<string, FieldWidgetComponent>;
 };
-export declare function EntrySlotBlockEditorPanel({ siteId, dashboardBaseUrl, typeKey, entryId, theme, apiClient, bearerToken, supabaseUrl, sdkConfig, mediaAssets, widgets, }: EntrySlotBlockEditorPanelProps): React.JSX.Element | null;
+export declare function EntrySlotBlockEditorPanel({ siteId, dashboardBaseUrl, typeKey, entryId, theme, apiClient, sdkConfig, widgets, }: EntrySlotBlockEditorPanelProps): React.JSX.Element | null;
 export {};

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/PageBlockEditorPanel.d.ts

@@ -2,7 +2,7 @@ import React, { type MutableRefObject, type ReactNode } from 'react';
 import type { ApiClient } from '../../../../api/src/request';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/block-editor/sdkBlockMerger';
 import type { BlockEditorHandle, BlockItem } from '../../../../editor-blocks/src/block-editor/types';
-import type { BookingOfferingPresetSummary, MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
+import type { BookingOfferingPresetSummary, Theme } from '../../../../blocks/src/index';
 import { type EditorUiState, type ZoomLevel } from '../../../../content-editor/src/index';
 import { type ViewportMode, type ViewportWidth } from './PreviewViewportControls';
 import type { PreviewZustandStoreApi } from './storeTypes';
@@ -13,8 +13,6 @@ type PageBlockEditorPanelProps = {
     dashboardBaseUrl?: string | null;
     theme?: Theme | null;
     apiClient: ApiClient;
-    bearerToken?: string | null;
-    supabaseUrl?: string;
     blockItems: BlockItem[];
     uiStoreForBlockEditor: PreviewZustandStoreApi<EditorUiState>;
     blockEditorRef: MutableRefObject<BlockEditorHandle | null>;
@@ -24,7 +22,6 @@ type PageBlockEditorPanelProps = {
     designPanel?: ReactNode;
     designTakeoverActive?: boolean;
     sdkConfig?: SdkConfigForBlockPicker | null;
-    mediaAssets?: MediaAssetIndexItem[];
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     viewportMode: ViewportMode;
     viewportWidth: ViewportWidth;
@@ -33,5 +30,5 @@ type PageBlockEditorPanelProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function PageBlockEditorPanel({ siteId, pageId, dashboardBaseUrl, theme, apiClient, bearerToken, supabaseUrl, blockItems, uiStoreForBlockEditor, blockEditorRef, onBlocksChange, metadataPanel, linkedEntrySection, designPanel, designTakeoverActive, sdkConfig, mediaAssets, bookingOfferingPresets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PageBlockEditorPanelProps): React.JSX.Element;
+export declare function PageBlockEditorPanel({ siteId, pageId, dashboardBaseUrl, theme, apiClient, blockItems, uiStoreForBlockEditor, blockEditorRef, onBlocksChange, metadataPanel, linkedEntrySection, designPanel, designTakeoverActive, sdkConfig, bookingOfferingPresets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PageBlockEditorPanelProps): React.JSX.Element;
 export {};

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

@@ -2,7 +2,7 @@ import React, { type ReactNode } from "react";
 import type { ApiClient } from "../../../../api/src/request";
 import type { SdkConfigForBlockPicker } from "../../../../editor-blocks/src/index";
 import type { SurfaceId } from "../../../../surfaces/src/index";
-import type { EntrySubrouteContextData, BookingOfferingPresetSummary, MediaAssetIndexItem, Theme } from "../../../../blocks/src/index";
+import type { EntrySubrouteContextData, BookingOfferingPresetSummary, Theme } from "../../../../blocks/src/index";
 import { type ContentTypeSchema } from "../../../../content-model/src/index";
 import { type ZoomLevel } from "../../../../content-editor/src/index";
 import type { ButtonStyleSelection } from "../../../../theme-core/src/buttons/index";
@@ -42,11 +42,9 @@ export type PreviewEditorSidebarProps = {
     themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
     apiClient: ApiClient;
     bearerToken?: string | null;
-    supabaseUrl?: string;
     entrySubrouteContext?: EntrySubrouteContextData | null;
     assistantPanel?: ReactNode;
     sdkConfig?: SdkConfigForBlockPicker | null;
-    mediaAssets?: MediaAssetIndexItem[];
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     siteStyleAccess?: SiteStyleAccess;
     activeTab: PreviewEditorSidebarTab;
@@ -60,4 +58,4 @@ export type PreviewEditorSidebarProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, siteStyleAccess, activeTab, onTabChange, onClose, onFooterSaved, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;
+export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, apiClient, bearerToken, entrySubrouteContext, assistantPanel, sdkConfig, bookingOfferingPresets, siteStyleAccess, activeTab, onTabChange, onClose, onFooterSaved, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;

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

@@ -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;
@@ -62,7 +73,7 @@ export type PreviewShellProps = {
     entrySubrouteContext?: EntrySubrouteContextData | null;
     assistantPanel?: PreviewEditorSidebarProps['assistantPanel'];
     sdkConfig?: SdkConfigForBlockPicker | null;
-    mediaAssets?: MediaAssetIndexItem[];
+    mediaAssets?: readonly MediaAssetIndexItem[];
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     supabaseUrl?: string;
     themeRuntime?: PreviewThemeRuntime;
@@ -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;

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

@@ -1,5 +1,5 @@
 import React, { type ReactNode } from "react";
-import { type EntrySubrouteContextData, type BookingOfferingPresetSummary, type MediaAssetIndexItem, type Theme } from "../../../../blocks/src/index";
+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";
@@ -11,7 +11,13 @@ import { type SiteStyleAccess } from "./siteStyleAccess";
 import { type PreviewThemeRuntime } from "./themeRuntime";
 export type PreviewShellLayoutProps = {
     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;
@@ -33,16 +39,14 @@ export type PreviewShellLayoutProps = {
     themeSelectionHeaderLookId?: HeaderLookId | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
-    supabaseUrl?: string;
     isSiteLaunched: boolean;
     maintenanceModeEnabled: boolean;
     entrySubrouteContext?: EntrySubrouteContextData | null;
     assistantPanel?: ReactNode;
     sdkConfig?: SdkConfigForBlockPicker | null;
-    mediaAssets?: MediaAssetIndexItem[];
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     themeRuntime?: PreviewThemeRuntime;
     siteStyleAccess?: SiteStyleAccess;
     onFooterSaved?: () => void;
 };
-export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, themeRuntime, siteStyleAccess, onFooterSaved, }: PreviewShellLayoutProps): React.JSX.Element;
+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;