@riverbankcms/sdk 0.125.0 → 0.127.0

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

@@ -35,7 +35,6 @@ export type PreviewEditorSidebarProps = {
     themeSelectionUpdatedAt?: string | null;
     /** Persisted Style configurator selections (Phase C / E). */
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
-    runtimePaletteState: import("./styleConfiguratorSnapshot").PreviewRuntimePaletteState;
     themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
     themeSelectionHeaderStyleId?: HeaderStyleId | null;
     themeSelectionHeaderLookId?: HeaderLookId | null;
@@ -61,4 +60,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, runtimePaletteState, 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, supabaseUrl, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, 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;
@@ -42,7 +53,6 @@ export type PreviewShellProps = {
      * complete palette state.
      */
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
-    runtimePaletteState: import('./styleConfiguratorSnapshot').PreviewRuntimePaletteState;
     themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
     themeSelectionHeaderStyleId?: HeaderStyleId | null;
     themeSelectionHeaderLookId?: HeaderLookId | null;
@@ -68,12 +78,12 @@ export type PreviewShellProps = {
     supabaseUrl?: string;
     themeRuntime?: PreviewThemeRuntime;
     designEditorEligibility?: PreviewDesignEditorEligibility;
-    /** Hides site-style controls for runtimes without palette authority. */
+    /** 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, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, runtimePaletteState, 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

@@ -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;
@@ -28,7 +34,6 @@ export type PreviewShellLayoutProps = {
     themeSelectionVersion?: number | null;
     themeSelectionUpdatedAt?: string | null;
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
-    runtimePaletteState: import("./styleConfiguratorSnapshot").PreviewRuntimePaletteState;
     themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
     themeSelectionHeaderStyleId?: HeaderStyleId | null;
     themeSelectionHeaderLookId?: HeaderLookId | null;
@@ -46,4 +51,4 @@ export type PreviewShellLayoutProps = {
     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, runtimePaletteState, 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, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, themeRuntime, siteStyleAccess, onFooterSaved, }: PreviewShellLayoutProps): React.JSX.Element;

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

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

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

@@ -1,10 +1,9 @@
 import React from 'react';
 import type { ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
-import { type ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
-import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
+import { type HeaderSelectionContext } from '../../../../theme-core/src/site-styles/index';
 import { type VisibleSiteStyleAccess } from './siteStyleAccess';
-import type { PreviewRuntimePaletteState } from './styleConfiguratorSnapshot';
+import { type StyleConfiguratorInitialSelections } from './styleConfiguratorSnapshot';
 export type StyleConfiguratorProps = Readonly<{
     siteId: string;
     apiClient: ApiClient;
@@ -14,16 +13,7 @@ export type StyleConfiguratorProps = Readonly<{
     selectionVersion?: number | null;
     selectionUpdatedAt?: string | null;
     /** Server-persisted design selections. */
-    initialSelections: Readonly<{
-        selectionVersion?: number | null;
-        selectionUpdatedAt?: string | null;
-        buttonStyleSelection: ButtonStyleSelection | null;
-        runtimePaletteState: PreviewRuntimePaletteState;
-        headerLayoutId?: HeaderLayoutId | null;
-        headerStyleId?: HeaderStyleId | null;
-        headerLookId?: HeaderLookId | null;
-        footerLookId?: FooterLookId | null;
-    }> & Readonly<Record<string, unknown>>;
+    initialSelections: StyleConfiguratorInitialSelections & Readonly<Record<string, unknown>>;
     headerSelectionContext?: Partial<HeaderSelectionContext>;
     onFocusedSurfaceChange?: (focused: boolean) => void;
     siteStyleAccess: VisibleSiteStyleAccess;

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

@@ -12,7 +12,7 @@
  */
 import { type ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
 import type { Theme } from '../../../../blocks/src/index';
-import type { PaletteColors, PaletteMode, PaletteSelection, PaletteEditorState, KnownCuratedPaletteValueKey, ResolvedPaletteSelection, RuntimePaletteState, SitePalette, SitePaletteId, SitePaletteVersion, PaletteLibraryAuthority } from '../../../../theme-core/src/palette/index';
+import type { PaletteColors, KnownCuratedPaletteValueKey } from '../../../../theme-core/src/palette/index';
 import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionFallbackWarning, SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
 import { type EditorStagedSessionCapabilities, type EditorStagedSessionState } from '../../../../content-editor/src/editorTransactionState';
@@ -48,41 +48,11 @@ export type TypographyDraftPatch = Readonly<{
     kind: 'scale';
     scale: ThemeTypography['scale'];
 }>;
-/** Runtime authority is deliberately separate from the editable core state. */
-export type PaletteSelectionSnapshot = Readonly<{
-    kind: 'available';
-    editor: PaletteEditorState;
-}> | Readonly<{
-    kind: 'invalid';
-    reason: PaletteAuthorityError;
-}>;
-export type PaletteAuthorityError = Extract<RuntimePaletteState, {
-    kind: 'invalid';
-}>['reason'] | 'runtime-curated-palette-missing' | 'runtime-curated-palette-mismatch' | 'invalid-active-site-palette-version';
 /** Read-only UI projection. It intentionally owns no palette transitions. */
 export type PalettePreviewProjection = Readonly<{
-    kind: 'curated';
-    valueKey: KnownCuratedPaletteValueKey;
-    colors: PaletteColors;
-    mode: PaletteMode;
-}> | Readonly<{
-    kind: 'curated-fork';
-    sourceValueKey: KnownCuratedPaletteValueKey;
-    colors: PaletteColors;
-    mode: PaletteMode;
-}> | Readonly<{
-    kind: 'site';
-    paletteId: SitePaletteId;
+    curatedValueKey: KnownCuratedPaletteValueKey | null;
     colors: PaletteColors;
-    mode: PaletteMode;
-    version: SitePaletteVersion;
-}> | Readonly<{
-    kind: 'new-site';
-    colors: PaletteColors;
-    mode: PaletteMode;
-}> | Readonly<{
-    kind: 'invalid';
-    reason: PaletteAuthorityError;
+    mode: Theme['palette']['meta']['mode'];
 }>;
 export type SelectionSnapshot = Readonly<{
     siteStyleId: SiteStyleId;
@@ -93,7 +63,7 @@ export type SelectionSnapshot = Readonly<{
     headerLookId: HeaderLookId | null;
     footerLookId: FooterLookId | null;
     buttonStyleSelection: ButtonStyleSelection;
-    palette: PaletteSelectionSnapshot;
+    palette: Theme['palette'];
     typography: ThemeTypography;
 }>;
 type StyleConfiguratorTargetKey = 'design:site-style';
@@ -104,22 +74,6 @@ export type StyleConfiguratorHistoryEntry = Readonly<{
     next: SelectionSnapshot;
 }>;
 export type StyleConfiguratorStagedSession = EditorStagedSessionState<SelectionSnapshot, StyleConfiguratorHistoryEntry, StyleConfiguratorTargetKey>;
-/**
- * A collaborator selected a different active palette while this editor had an
- * unsaved edit to the formerly active site palette. The base remains the
- * server authority; the complete local draft remains available for an
- * intentional retry or cancel.
- */
-export type StyleConfiguratorStalePaletteConflict = Readonly<{
-    kind: 'active-palette-changed';
-    originalPaletteId: SitePaletteId;
-    localDraft: Readonly<{
-        paletteId: SitePaletteId;
-        expectedVersion: SitePaletteVersion;
-        colors: PaletteColors;
-        mode: PaletteMode;
-    }>;
-}>;
 export type StyleConfiguratorState = Readonly<{
     /**
      * Last persisted server snapshot. Updated on apply-success (and on
@@ -134,19 +88,10 @@ export type StyleConfiguratorState = Readonly<{
     saveStatus: StyleConfiguratorSaveStatus;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
     notices: ReadonlyArray<StyleConfiguratorNotice>;
-    stalePaletteConflict: StyleConfiguratorStalePaletteConflict | null;
     expandedRow: StyleConfiguratorExpandedRow;
     stagedSession: StyleConfiguratorStagedSession;
 }>;
-export type PaletteMutationCapability = Readonly<{
-    kind: 'editable';
-}> | Readonly<{
-    kind: 'blocked';
-    reason: 'invalid-palette';
-    message: string;
-}>;
 export declare function createStyleConfiguratorState(base: SelectionSnapshot): StyleConfiguratorState;
-export declare function paletteMutationCapability(state: StyleConfiguratorState): PaletteMutationCapability;
 export declare function openRow(state: StyleConfiguratorState, row: Exclude<StyleConfiguratorExpandedRow, null>): StyleConfiguratorState;
 /**
  * True iff the user has previewed a change that hasn't been applied yet.
@@ -165,21 +110,13 @@ export declare function previewTypography(state: StyleConfiguratorState, typogra
 export declare function applyTypographyDraftPatch(state: StyleConfiguratorState, currentTypography: ThemeTypography, patch: TypographyDraftPatch): StyleConfiguratorState;
 export declare function resetTypographyToSaved(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function previewCuratedPalette(state: StyleConfiguratorState, valueKey: KnownCuratedPaletteValueKey): StyleConfiguratorState;
-export declare function previewSitePalette(state: StyleConfiguratorState, palette: Readonly<{
-    paletteId: SitePaletteId;
-    colors: PaletteColors;
-    mode: PaletteMode;
-    version: SitePaletteVersion;
-}>): StyleConfiguratorState;
-/** Starts a manual palette from the active complete palette, never sparse overrides. */
-export declare function createPalette(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function setPaletteColors(state: StyleConfiguratorState, colors: PaletteColors): StyleConfiguratorState;
 /**
  * Records the post-compile resolved selection + any fallback warnings.
  * Used after `compileSiteThemeFromSelections` runs against a new site style:
- * the resolver may have auto-picked a different button style if the user's
- * previous selection is not offered for the new style, or a different palette
- * if the persisted palette value key is no longer known.
+ * the resolver may have auto-picked a different button style or chrome look
+ * when the user's previous selection is not offered for the new style. The
+ * concrete palette is carried independently in the compiled Theme.
  *
  */
 export declare function applyResolvedSelections(state: StyleConfiguratorState, input: Readonly<{
@@ -190,10 +127,6 @@ export declare function cancelPreview(state: StyleConfiguratorState): StyleConfi
 export declare function markApplySaving(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function markApplySaved(state: StyleConfiguratorState, persisted: SelectionSnapshot): StyleConfiguratorState;
 export declare function markApplyFailed(state: StyleConfiguratorState, message: string, failureKind?: 'retryable' | 'stale'): StyleConfiguratorState;
-/** Advances a stale site's CAS token only for the user's explicit retry. */
-export declare function prepareStalePaletteRetry(state: StyleConfiguratorState, input?: Readonly<{
-    sitePalettes: readonly SitePalette[];
-}>): StyleConfiguratorState;
 export declare function toggleRow(state: StyleConfiguratorState, row: StyleConfiguratorExpandedRow): StyleConfiguratorState;
 export declare function dismissWarnings(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function dismissNotices(state: StyleConfiguratorState): StyleConfiguratorState;
@@ -203,32 +136,7 @@ export declare function dismissNotices(state: StyleConfiguratorState): StyleConf
  * changes the persisted selection out-of-band.
  */
 export declare function syncStyleConfiguratorState(state: StyleConfiguratorState, base: SelectionSnapshot): StyleConfiguratorState;
-/** Reconciles typed palette-library authority with the editor's saved base. */
-export declare function reconcilePaletteLibraryActive(state: StyleConfiguratorState, active: PaletteLibraryAuthority, sitePalettes: readonly SitePalette[]): StyleConfiguratorState;
-/**
- * A palette-library response only refreshes palette authority. Unlike a full
- * server snapshot, it must never discard the user's staged site-style work.
- * Site drafts keep their complete local colours/mode and rebase their expected
- * version when the same palette was changed elsewhere.
- */
-export declare function rebasePaletteLibraryAuthority(state: StyleConfiguratorState, committedPalette: ResolvedPaletteSelection): StyleConfiguratorState;
 export declare function selectionSnapshotsEqual(a: SelectionSnapshot, b: SelectionSnapshot): boolean;
 export declare function typographyObjectsEqual(a: ThemeTypography, b: ThemeTypography): boolean;
-type ModernRuntimePaletteState = Extract<RuntimePaletteState, Readonly<{
-    authority: 'curated';
-}>> | Extract<RuntimePaletteState, Readonly<{
-    authority: 'site';
-}>> | Extract<RuntimePaletteState, Readonly<{
-    kind: 'invalid';
-}>>;
-export declare function paletteSelectionSnapshotFromRuntime(runtime: ModernRuntimePaletteState): PaletteSelectionSnapshot;
-export declare function paletteSelectionSnapshotFromComplete(input: Readonly<{
-    selection: PaletteSelection;
-    colors: PaletteColors;
-    mode: PaletteMode;
-    version?: SitePaletteVersion;
-}>): PaletteSelectionSnapshot;
-export declare function paletteSelectionSnapshotsEqual(left: PaletteSelectionSnapshot, right: PaletteSelectionSnapshot): boolean;
-export declare function palettePreviewProjection(palette: PaletteSelectionSnapshot): PalettePreviewProjection;
-export declare function committedPaletteForSnapshot(palette: PaletteSelectionSnapshot): ResolvedPaletteSelection | null;
+export declare function palettePreviewProjection(palette: Theme['palette']): PalettePreviewProjection;
 export {};

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

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

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

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