@riverbankcms/sdk 0.129.1 → 0.130.2

package/dist/_dts/editor-blocks/src/media/MediaField.d.ts

@@ -1,5 +1,5 @@
-import type { FieldWidgetProps } from '../../../block-form/src/client/index';
-import type { FileFieldConfig, MediaFieldConfig } from '../../../block-form/src/client/index';
+import type { FieldWidgetProps } from '../../../block-form/src/index';
+import type { FileFieldConfig, MediaFieldConfig } from '../../../block-form/src/index';
 import type { UploadIntentContract } from '../../../api/src/index';
 import { type VideoPrepIntent } from '../../../media-core/src/index';
 import { type MediaValue } from '../../../media-editor/src/index';

package/dist/_dts/editor-blocks/src/widgets/button/ButtonField.d.ts

@@ -1,4 +1,4 @@
-import type { FieldWidgetProps, ButtonFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps, ButtonFieldConfig } from '../../../../block-form/src/index';
 /**
  * Button Field Widget
  *

package/dist/_dts/editor-blocks/src/widgets/button/ButtonVariantField.d.ts

@@ -1,2 +1,2 @@
-import type { FieldWidgetProps, SelectFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps, SelectFieldConfig } from '../../../../block-form/src/index';
 export declare function ButtonVariantField({ path, backend, config }: FieldWidgetProps<string, SelectFieldConfig>): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/button/index.d.ts

@@ -1,6 +1,6 @@
 export { ButtonField } from './ButtonField';
 export type { ButtonValue } from './ButtonField';
-export type { ButtonFieldConfig } from '../../../../block-form/src/client/index';
+export type { ButtonFieldConfig } from '../../../../block-form/src/index';
 export { ButtonWidgetProvider, useButtonWidgetContext } from './context';
 export type { ButtonWidgetContextValue, ButtonVariantOption, ButtonWidgetProviderProps } from './context';
 export { ButtonVariantField } from './ButtonVariantField';

package/dist/_dts/editor-blocks/src/widgets/content-type-select/ContentTypeSelectField.d.ts

@@ -1,4 +1,4 @@
-import type { FieldWidgetProps, ContentTypeSelectFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps, ContentTypeSelectFieldConfig } from '../../../../block-form/src/index';
 /**
  * ContentTypeSelectField - Content type select widget using FieldWidgetProps pattern
  *

package/dist/_dts/editor-blocks/src/widgets/entry-picker/EntryPickerField.d.ts

@@ -1,4 +1,4 @@
-import type { FieldWidgetProps, EntryPickerFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps, EntryPickerFieldConfig } from '../../../../block-form/src/index';
 /**
  * EntryPickerField - Entry picker widget for selecting content entries
  *

package/dist/_dts/editor-blocks/src/widgets/entry-picker/index.d.ts

@@ -2,4 +2,4 @@ export { EntryPickerField } from './EntryPickerField';
 export { EntryPickerWidgetProvider, useEntryPickerWidgetContext } from './EntryPickerWidgetProvider';
 export { getEntryPickerLabelForStoredValue, getEntryPickerOptionValueForStoredValue, } from './utils';
 export type { EntryPickerWidgetAdapter, EntryPickerAdapterArgs, EntryPickerAdapterLabels, EntryPickerItem, EntryPickerItemBadgeVariant, } from './types';
-export type { EntryPickerFieldConfig } from '../../../../block-form/src/client/index';
+export type { EntryPickerFieldConfig } from '../../../../block-form/src/index';

package/dist/_dts/editor-blocks/src/widgets/icon-picker/IconPickerField.d.ts

@@ -1,4 +1,4 @@
-import { type FieldWidgetProps, type TextFieldConfig } from '../../../../block-form/src/client/index';
+import { type FieldWidgetProps, type TextFieldConfig } from '../../../../block-form/src/index';
 type IconPickerValue = unknown;
 export declare function IconPickerField({ path, backend, config }: FieldWidgetProps<IconPickerValue, TextFieldConfig>): import("react").JSX.Element;
 export {};

package/dist/_dts/editor-blocks/src/widgets/inline-text/InlineTextField.d.ts

@@ -1,3 +1,3 @@
-import type { FieldWidgetProps, InlineTextFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps, InlineTextFieldConfig } from '../../../../block-form/src/index';
 import { type InlineText } from '../../../../blocks/src/index';
 export declare function InlineTextField({ path, backend, config, }: FieldWidgetProps<InlineText, InlineTextFieldConfig>): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/link/LinkField.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from 'react';
-import type { FieldWidgetProps } from '../../../../block-form/src/client/index';
-import type { LinkFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps } from '../../../../block-form/src/index';
+import type { LinkFieldConfig } from '../../../../block-form/src/index';
 /**
  * LinkField - Adapter for new widget architecture
  *

package/dist/_dts/editor-blocks/src/widgets/offerings-preview/OfferingsPreviewGroupOrderField.d.ts

@@ -1,2 +1,2 @@
-import { type FieldWidgetProps, type SelectFieldConfig } from '../../../../block-form/src/client/index';
+import { type FieldWidgetProps, type SelectFieldConfig } from '../../../../block-form/src/index';
 export declare function OfferingsPreviewGroupOrderField({ path, backend, config, }: FieldWidgetProps<readonly unknown[] | null, SelectFieldConfig>): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/reference/ReferenceField.d.ts

@@ -1,5 +1,5 @@
-import type { FieldWidgetProps } from '../../../../block-form/src/client/index';
-import type { ReferenceFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps } from '../../../../block-form/src/index';
+import type { ReferenceFieldConfig } from '../../../../block-form/src/index';
 /**
  * ReferenceField - Reference/relation select widget using new FieldWidgetProps pattern
  */

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

@@ -1,5 +1,5 @@
-import type { FieldWidgetProps } from '../../../../block-form/src/client/index';
-import type { RichTextFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps } from '../../../../block-form/src/index';
+import type { RichTextFieldConfig } from '../../../../block-form/src/index';
 import { type RichTextDoc } from '../../../../blocks/src/system/manifest/richTextSchema';
 type RichTextValue = RichTextDoc;
 export declare function RichTextField({ path, backend, config, }: FieldWidgetProps<RichTextValue, RichTextFieldConfig>): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/site-option-picker/SiteOptionPickerField.d.ts

@@ -1,3 +1,3 @@
-import type { SelectFieldConfig, FieldWidgetProps } from '../../../../block-form/src/client/index';
+import type { SelectFieldConfig, FieldWidgetProps } from '../../../../block-form/src/index';
 import { type SiteOptionValue } from './utils';
 export declare function SiteOptionPickerField({ path, backend, config, }: FieldWidgetProps<SiteOptionValue, SelectFieldConfig>): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/site-option-picker/utils.d.ts

@@ -1,5 +1,5 @@
 import { type SiteOptionSource } from '../../../../blocks/src/index';
-import type { SelectFieldConfig } from '../../../../block-form/src/client/index';
+import type { SelectFieldConfig } from '../../../../block-form/src/index';
 export type SiteOptionValue = string | string[] | null | undefined;
 export declare function normalizeSiteOptionMultiValue(value: SiteOptionValue): string[];
 export declare function getSiteOptionSource(config: SelectFieldConfig): SiteOptionSource | null;

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

@@ -1,5 +1,5 @@
 import { type BlockManifest, type Theme } from '../../../../blocks/src/index';
-import { type FieldConfig, type FormBackend } from '../../../../block-form/src/client/index';
+import { type FieldConfig, type FormBackend } from '../../../../block-form/src/index';
 import type { EditorBlockId } from '../../../../core/src/index';
 import { type SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
 import type { EditorUiState } from '../../../../content-editor/src/index';

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

@@ -3,7 +3,7 @@ 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, Theme } from '../../../../blocks/src/index';
-import type { FieldWidgetComponent } from '../../../../block-form/src/client/index';
+import type { FieldWidgetComponent } from '../../../../block-form/src/index';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
 import { type ViewportMode, type ViewportWidth } from './PreviewViewportControls';
 import type { PreviewEditorSidebarProps, PreviewTemplateData } from './PreviewEditorSidebar';

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

@@ -1,7 +1,7 @@
 import React from "react";
 import type { ApiClient } from "../../../../api/src/request";
 import type { Theme } from "../../../../blocks/src/index";
-import type { FieldWidgetComponent } from "../../../../block-form/src/client/index";
+import type { FieldWidgetComponent } from "../../../../block-form/src/index";
 import type { SdkConfigForBlockPicker } from "../../../../editor-blocks/src/index";
 type EntrySlotBlockEditorPanelProps = {
     siteId: string;

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

@@ -0,0 +1,8 @@
+import { type ReactNode } from 'react';
+import { type EditorUiState } from '../../../../content-editor/src/index';
+import type { PreviewZustandStoreApi } from './storeTypes';
+export declare function FooterSidebarDisclosure({ editorStore, hidden, children, }: {
+    editorStore: PreviewZustandStoreApi<EditorUiState>;
+    hidden: boolean;
+    children: ReactNode;
+}): import("react").JSX.Element;

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

@@ -4,10 +4,10 @@ import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/bloc
 import type { BlockEditorHandle, BlockItem } from '../../../../editor-blocks/src/block-editor/types';
 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 { ViewportMode, ViewportWidth } from './PreviewViewportControls';
 import type { PreviewZustandStoreApi } from './storeTypes';
-import { type PreviewLinkedEntrySidebarSection } from './PreviewSidebarSection';
-type PageBlockEditorPanelProps = {
+import type { PreviewLinkedEntrySidebarSection } from './PreviewSidebarSection';
+export type PageBlockEditorPanelProps = {
     siteId: string;
     pageId: string;
     dashboardBaseUrl?: string | null;
@@ -21,6 +21,7 @@ type PageBlockEditorPanelProps = {
     linkedEntrySection?: PreviewLinkedEntrySidebarSection | null;
     designPanel?: ReactNode;
     designTakeoverActive?: boolean;
+    footerPanel?: ReactNode;
     sdkConfig?: SdkConfigForBlockPicker | null;
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     viewportMode: ViewportMode;
@@ -30,5 +31,4 @@ type PageBlockEditorPanelProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-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 {};
+export declare function PageBlockEditorPanel(props: PageBlockEditorPanelProps): React.JSX.Element;

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

@@ -1,15 +1,15 @@
-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, 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";
-import type { FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId } from "../../../../theme-core/src/site-styles/index";
-import type { ViewportMode, ViewportWidth } from "./PreviewViewportControls";
-import { type SiteStyleAccess } from "./siteStyleAccess";
-export type PreviewEditorSidebarTab = "editor" | "assistant";
+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, 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';
+import type { FooterLookId, HeaderLayoutStyleSelection, HeaderLogoContext } from '../../../../theme-core/src/site-styles/index';
+import type { ViewportMode, ViewportWidth } from './PreviewViewportControls';
+import { type SiteStyleAccess } from './siteStyleAccess';
+export type PreviewEditorSidebarTab = 'editor' | 'assistant';
 export type PreviewTemplateData = {
     name: string;
     description?: string | null;
@@ -35,11 +35,9 @@ export type PreviewEditorSidebarProps = {
     themeSelectionUpdatedAt?: string | null;
     /** Persisted Style configurator selections (Phase C / E). */
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
-    themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
-    themeSelectionHeaderStyleId?: HeaderStyleId | null;
-    themeSelectionHeaderLookId?: HeaderLookId | null;
+    themeSelectionHeaderSelection?: HeaderLayoutStyleSelection | null;
     themeSelectionFooterLookId?: FooterLookId | null;
-    themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
+    themeSelectionHeaderLogo?: HeaderLogoContext;
     apiClient: ApiClient;
     bearerToken?: string | null;
     entrySubrouteContext?: EntrySubrouteContextData | null;
@@ -58,4 +56,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, entrySubrouteContext, assistantPanel, sdkConfig, 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, themeSelectionHeaderSelection, themeSelectionFooterLookId, themeSelectionHeaderLogo, 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/PreviewFooterEditorPanel.d.ts

@@ -0,0 +1,20 @@
+import type { ApiClient } from '../../../../api/src/request';
+import type { Theme } from '../../../../blocks/src/index';
+import { type PreviewInspection } from '../../../../content-editor/src/index';
+import type { SiteStyleAccess } from './siteStyleAccess';
+type FooterInspection = Extract<PreviewInspection, Readonly<{
+    kind: 'footer' | 'footer-module';
+}>>;
+export declare function PreviewFooterEditorPanel({ apiClient, siteId, dashboardBaseUrl, theme, selectionId, selectionVersion, siteStyleAccess, inspection, canEdit, onSaved, }: Readonly<{
+    apiClient: ApiClient;
+    siteId: string;
+    dashboardBaseUrl: string | null;
+    theme: Theme | null;
+    selectionId: string | null;
+    selectionVersion: number | null;
+    siteStyleAccess: SiteStyleAccess;
+    inspection: FooterInspection | null;
+    canEdit: boolean;
+    onSaved?: () => void;
+}>): import("react").JSX.Element;
+export {};

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

@@ -1,7 +1,7 @@
 import React, { type ComponentProps, type ReactNode } from 'react';
 import { BlockApiProvider } from '../../../../blocks/src/client';
 import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
-import type { FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
+import type { FooterLookId, HeaderLayoutStyleSelection, HeaderLogoContext } from '../../../../theme-core/src/site-styles/index';
 import type { EntrySubrouteContextData, BookingOfferingPresetSummary, MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
 import type { ContentTypeSchema } from '../../../../content-model/src/index';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
@@ -51,11 +51,9 @@ type PreviewShellCommonProps = {
      * complete palette state.
      */
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
-    themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
-    themeSelectionHeaderStyleId?: HeaderStyleId | null;
-    themeSelectionHeaderLookId?: HeaderLookId | null;
+    themeSelectionHeaderSelection?: HeaderLayoutStyleSelection | null;
     themeSelectionFooterLookId?: FooterLookId | null;
-    themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
+    themeSelectionHeaderLogo?: HeaderLogoContext;
     pageId: string | null;
     routeId: string | null;
     entryData?: PreviewContentEntryData | null;
@@ -74,6 +72,8 @@ type PreviewShellCommonProps = {
     mediaAssets?: readonly MediaAssetIndexItem[];
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     supabaseUrl?: string;
+    /** Base URL returned by the content response for site-font storage. */
+    siteFontStorageUrl?: string;
     designEditorEligibility?: PreviewDesignEditorEligibility;
     /** Hides site-style controls when this runtime cannot persist design edits. */
     hideSiteStyleConfigurator?: boolean;

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

@@ -1,7 +1,7 @@
 import React, { type ReactNode } from 'react';
 import { type EntrySubrouteContextData, type BookingOfferingPresetSummary, type Theme } from '../../../../blocks/src/index';
 import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
-import type { HeaderSelectionContext, FooterLookId, HeaderLayoutId, HeaderLookId, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
+import type { HeaderLogoContext, FooterLookId, HeaderLayoutStyleSelection } from '../../../../theme-core/src/site-styles/index';
 import type { ContentTypeSchema } from '../../../../content-model/src/index';
 import type { ApiClient } from '../../../../api/src/request';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
@@ -27,11 +27,9 @@ type PreviewShellLayoutCommonProps = {
     themeSelectionVersion?: number | null;
     themeSelectionUpdatedAt?: string | null;
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
-    themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
-    themeSelectionHeaderStyleId?: HeaderStyleId | null;
-    themeSelectionHeaderLookId?: HeaderLookId | null;
+    themeSelectionHeaderSelection?: HeaderLayoutStyleSelection | null;
     themeSelectionFooterLookId?: FooterLookId | null;
-    themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
+    themeSelectionHeaderLogo?: HeaderLogoContext;
     isSiteLaunched: boolean;
     maintenanceModeEnabled: boolean;
     entrySubrouteContext?: EntrySubrouteContextData | null;

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

@@ -0,0 +1,6 @@
+import { type ReactNode } from 'react';
+export declare function PreviewSiteFontStorageProvider({ siteFontStorageUrl, children, }: Readonly<{
+    siteFontStorageUrl?: string;
+    children: ReactNode;
+}>): import("react").JSX.Element;
+export declare function usePreviewSiteFontStorageUrl(): string | undefined;

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

@@ -1,7 +1,7 @@
 import React, { type ReactNode } from 'react';
 import { type ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
-import type { BrandDisplayMode, HeaderNavFontSizePreference, HeaderNavTypographyPreference, HeaderInteractionPalettePreference, HeaderSelectionContext, LogoSizePolicy, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
+import type { BrandDisplayMode, HeaderNavFontSizePreference, HeaderNavTypographyPreference, HeaderInteractionPalettePreference, HeaderLogoContext, LogoSizePolicy, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
 import { type StyleConfiguratorHistoryEntry } from './StyleConfigurator.state';
 import type { SiteStyleAccess } from './siteStyleAccess';
 import { type StyleConfiguratorInitialSelections } from './styleConfiguratorSnapshot';
@@ -46,7 +46,7 @@ type SiteChromeQuickControlApplyOutcome = Readonly<{
 type SiteChromeCustomizeContextValue = Readonly<{
     canOpenDesignEditor: boolean;
     getSurfaceState: (surface: SiteChromeEditableSurfaceKind) => SiteChromeCustomizeSurfaceState;
-    cycleSurfaceLook: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
+    cycleChromeSelection: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
     cycleHeaderLayout: (direction: 'prev' | 'next') => void;
     setHeaderBrandDisplay: (value: BrandDisplayMode) => void;
     setHeaderLogoSize: (value: LogoSizePolicy) => void;
@@ -68,9 +68,9 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
     selectionVersion?: number | null;
     selectionUpdatedAt?: string | null;
     initialSelections: StyleConfiguratorInitialSelections & Readonly<Record<string, unknown>>;
-    headerSelectionContext?: Partial<HeaderSelectionContext>;
+    headerLogoContext?: HeaderLogoContext;
     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 SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerLogoContext, siteStyleAccess, canOpenDesignEditor, }: SiteChromeCustomizeProviderProps): React.JSX.Element;
 export declare function useSiteChromeCustomizeOptional(): SiteChromeCustomizeContextValue | null;

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

@@ -1,8 +1,7 @@
 import React from 'react';
 import type { ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
-import { type HeaderSelectionContext } from '../../../../theme-core/src/site-styles/index';
-import { type VisibleSiteStyleAccess } from './siteStyleAccess';
+import { type HeaderLogoContext } from '../../../../theme-core/src/site-styles/index';
 import { type StyleConfiguratorInitialSelections } from './styleConfiguratorSnapshot';
 export type StyleConfiguratorProps = Readonly<{
     siteId: string;
@@ -14,8 +13,7 @@ export type StyleConfiguratorProps = Readonly<{
     selectionUpdatedAt?: string | null;
     /** Server-persisted design selections. */
     initialSelections: StyleConfiguratorInitialSelections & Readonly<Record<string, unknown>>;
-    headerSelectionContext?: Partial<HeaderSelectionContext>;
+    headerLogoContext?: HeaderLogoContext;
     onFocusedSurfaceChange?: (focused: boolean) => void;
-    siteStyleAccess: VisibleSiteStyleAccess;
 }>;
-export declare function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, onFocusedSurfaceChange, siteStyleAccess, }: StyleConfiguratorProps): React.JSX.Element;
+export declare function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerLogoContext, onFocusedSurfaceChange, }: StyleConfiguratorProps): React.JSX.Element;

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

@@ -13,7 +13,7 @@
 import { type ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
 import type { Theme } from '../../../../blocks/src/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 CuratedSiteStyle, type FooterLookId, type HeaderLayoutId, 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';
 export type StyleConfiguratorSaveStatus = Readonly<{
@@ -31,7 +31,7 @@ export type StyleConfiguratorExpandedRow = 'style' | 'header-layout' | 'header-s
 /**
  * Configurator-level notices that aren't compiler selection fallback warnings.
  * Kept separate from `SelectionFallbackWarning` (which comes from
- * `compileSiteThemeFromSelections`) so the layers stay clean: warnings are
+ * `compileReplacementSiteThemeFromSelections`) so the layers stay clean: warnings are
  * compiler-emitted, notices are UI-level decisions the configurator makes.
  */
 export type StyleConfiguratorNotice = never;
@@ -60,7 +60,6 @@ export type SelectionSnapshot = Readonly<{
     selectionUpdatedAt?: string | null;
     headerLayoutId: HeaderLayoutId;
     headerStyleId: HeaderStyleId;
-    headerLookId: HeaderLookId | null;
     footerLookId: FooterLookId | null;
     buttonStyleSelection: ButtonStyleSelection;
     palette: Theme['palette'];
@@ -103,7 +102,7 @@ export declare function deriveStyleConfiguratorCapabilities(state: StyleConfigur
 export declare function styleConfiguratorHistoryEntryForPersistedSelection(state: StyleConfiguratorState, persisted: SelectionSnapshot): StyleConfiguratorHistoryEntry | null;
 export declare function previewSiteStyle(state: StyleConfiguratorState, siteStyleId: SiteStyleId): StyleConfiguratorState;
 export declare function previewButtonStyle(state: StyleConfiguratorState, buttonStyleSelection: ButtonStyleSelection): StyleConfiguratorState;
-export declare function previewHeaderLayout(state: StyleConfiguratorState, headerLayoutId: HeaderLayoutId): StyleConfiguratorState;
+export declare function previewHeaderLayout(state: StyleConfiguratorState, siteStyle: CuratedSiteStyle, headerLayoutId: HeaderLayoutId): StyleConfiguratorState;
 export declare function previewHeaderStyle(state: StyleConfiguratorState, headerStyleId: HeaderStyleId): StyleConfiguratorState;
 export declare function previewFooterLook(state: StyleConfiguratorState, footerLookId: FooterLookId | null): StyleConfiguratorState;
 export declare function previewTypography(state: StyleConfiguratorState, typography: ThemeTypography): StyleConfiguratorState;
@@ -113,14 +112,14 @@ export declare function previewCuratedPalette(state: StyleConfiguratorState, val
 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 or chrome look
+ * Used after `compileReplacementSiteThemeFromSelections` runs against a new site style:
+ * the resolver may have auto-picked a different button or chrome selection
  * 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<{
-    resolved: Pick<SelectionSnapshot, 'buttonStyleSelection' | 'headerLayoutId' | 'headerStyleId' | 'headerLookId' | 'typography'>;
+    resolved: Pick<SelectionSnapshot, 'buttonStyleSelection' | 'headerLayoutId' | 'headerStyleId' | 'typography'>;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>): StyleConfiguratorState;
 export declare function cancelPreview(state: StyleConfiguratorState): StyleConfiguratorState;

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

@@ -1,5 +1,5 @@
 import type { Theme } from '../../../../blocks/src/index';
-import type { BrandDisplayMode, HeaderBrandPreferences, HeaderSelectionContext, LogoSizePolicy } from '../../../../theme-core/src/site-styles/index';
+import type { BrandDisplayMode, HeaderBrandPreferences, HeaderLogoContext, LogoSizePolicy } from '../../../../theme-core/src/site-styles/index';
 export type { HeaderBrandPreferences } from '../../../../theme-core/src/site-styles/index';
 export type HeaderBrandDisplayOption = Readonly<{
     value: BrandDisplayMode;
@@ -26,16 +26,16 @@ export declare const DEFAULT_HEADER_BRAND_PREFERENCES: Readonly<{
     logoSize: LogoSizePolicy;
 }>;
 export declare const HEADER_LOGO_SIZE_OPTIONS: readonly HeaderLogoSizeOption[];
-export declare function createHeaderBrandControlState({ theme, headerSelectionContext, }: {
+export declare function createHeaderBrandControlState({ theme, headerLogoContext, }: {
     theme: Theme | null;
-    headerSelectionContext: Partial<HeaderSelectionContext> | undefined;
+    headerLogoContext: HeaderLogoContext | undefined;
 }): HeaderBrandControlState;
-export declare function createHeaderBrandControlStateFromPreferences({ preferences, headerSelectionContext, }: {
+export declare function createHeaderBrandControlStateFromPreferences({ preferences, headerLogoContext, }: {
     preferences: HeaderBrandPreferences;
-    headerSelectionContext: Partial<HeaderSelectionContext> | undefined;
+    headerLogoContext: HeaderLogoContext | undefined;
 }): HeaderBrandControlState;
 export declare function readHeaderBrandPreferences(theme: Theme | null): HeaderBrandPreferences;
 export declare function normalizeHeaderBrandPreferences(preferences: HeaderBrandPreferences, hasLogo: boolean): HeaderBrandPreferences;
 export declare function withHeaderBrandThemePreferences(theme: Theme, preferences: HeaderBrandPreferences): Theme;
-export declare function withHeaderBrandPreferences(context: Partial<HeaderSelectionContext> | undefined, preferences: HeaderBrandPreferences): Partial<HeaderSelectionContext> | undefined;
-export declare function hasLogoInHeaderSelectionContext(context: Partial<HeaderSelectionContext> | undefined): boolean;
+export declare function withHeaderBrandPreferences(context: HeaderLogoContext | undefined, preferences: HeaderBrandPreferences): HeaderLogoContext | undefined;
+export declare function hasLogoInHeaderLogoContext(context: HeaderLogoContext | undefined): boolean;

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

@@ -1,6 +1,6 @@
 import type { BrandDisplayMode, FooterLookId, HeaderInteractionPaletteControlState, HeaderLayoutId, HeaderNavFontSizePreference, HeaderNavTypographyPreference, HeaderStyleId, LogoSizePolicy, SiteChromeBackgroundColorToken, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
 import type { HeaderBrandDisplayOption, HeaderLogoSizeOption } from './siteChromeBrandPreferences';
-import type { SiteChromeLookOption } from './siteChromeLookRows';
+import type { SiteChromeSelectionOption } from './siteChromeSelectionRows';
 export type SiteChromeBackgroundControlState = Readonly<{
     available: boolean;
     current: SiteChromeBackgroundOverride;
@@ -16,10 +16,10 @@ export type SiteChromeCustomizeSurfaceState = Readonly<{
     label: string;
     currentLayoutId: HeaderLayoutId;
     currentLayoutLabel: string;
-    layoutOptions: readonly SiteChromeLookOption<HeaderLayoutId>[];
+    layoutOptions: readonly SiteChromeSelectionOption<HeaderLayoutId>[];
     currentId: HeaderStyleId;
     currentLabel: string;
-    options: readonly SiteChromeLookOption<HeaderStyleId>[];
+    options: readonly SiteChromeSelectionOption<HeaderStyleId>[];
     brandDisplay: BrandDisplayMode;
     brandDisplayOptions: readonly HeaderBrandDisplayOption[];
     brandSizeLabel: string;
@@ -46,7 +46,7 @@ export type SiteChromeCustomizeSurfaceState = Readonly<{
     label: string;
     currentId: FooterLookId | null;
     currentLabel: string;
-    options: readonly SiteChromeLookOption<FooterLookId | null>[];
+    options: readonly SiteChromeSelectionOption<FooterLookId | null>[];
     diagnostics: readonly string[];
     background: SiteChromeBackgroundControlState;
     failure: string | null;

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

@@ -2,8 +2,8 @@ import { type HistoryState } from '../../../../content-editor/src/index';
 import { type BrandDisplayMode, type FooterLookId, type HeaderNavFontSizePreference, type HeaderNavPreferences, type HeaderNavTypographyPreference, type HeaderInteractionPalettePreference, type LogoSizePolicy, type SiteChromeBackgroundOverride, type SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 import type { HeaderBrandPreferences } from './siteChromeBrandPreferences';
-type HeaderLayoutSelection = Pick<SelectionSnapshot, 'headerLayoutId' | 'headerStyleId' | 'headerLookId'>;
-type HeaderStyleSelection = Pick<SelectionSnapshot, 'headerStyleId' | 'headerLookId'>;
+type HeaderLayoutSelection = Pick<SelectionSnapshot, 'headerLayoutId' | 'headerStyleId'>;
+type HeaderStyleSelection = Pick<SelectionSnapshot, 'headerStyleId'>;
 export type SiteChromeQuickControlHistoryEntry = Readonly<{
     kind: 'header-layout';
     previous: HeaderLayoutSelection;

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

@@ -1,28 +1,24 @@
 import type { APIEndpoints } from '../../../../api/src/index';
 import type { Theme } from '../../../../blocks/src/index';
-import type { HeaderNavPreferences, HeaderSelectionContext, SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
+import type { HeaderNavPreferences, HeaderLogoContext, SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { CuratedSiteStyle } from '../../../../theme-core/src/site-styles/previewCompiler';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 import { type SiteStylePreviewPlan } from './siteStylePreviewPlanner';
 import type { SiteChromeEditableSurfaceKind } from './SiteChromeEditableSurface';
 import { type HeaderBrandPreferences } from './siteChromeBrandPreferences';
-type SaveSiteChromeLookSelectionBody = NonNullable<APIEndpoints['saveSiteChromeLookSelection']['body']>;
+type SaveSiteChromeSelectionBody = NonNullable<APIEndpoints['saveSiteChromeSelection']['body']>;
+export type SaveSiteChromeSelectionResponse = NonNullable<APIEndpoints['saveSiteChromeSelection']['response']>;
 export type SiteChromeSavePlan = Readonly<{
     compiled: SiteStylePreviewPlan;
     themeOverlay: Theme;
-    body: SaveSiteChromeLookSelectionBody;
+    body: SaveSiteChromeSelectionBody;
 }>;
 export type BuildSiteChromeSavePlanInput = Readonly<{
     surface: SiteChromeEditableSurfaceKind;
-    selectionPersistence: Readonly<{
-        kind: 'preserve';
-    }> | Readonly<{
-        kind: 'write';
-    }>;
     siteStyle: CuratedSiteStyle;
     selection: SelectionSnapshot;
     baseTheme: Theme | null | undefined;
-    headerSelectionContext: Partial<HeaderSelectionContext> | undefined;
+    headerLogoContext: HeaderLogoContext | undefined;
     headerBrandPreferences: HeaderBrandPreferences;
     headerNavPreferences: HeaderNavPreferences;
     backgroundPreferences: SiteChromeBackgroundPreferences;
@@ -30,6 +26,11 @@ export type BuildSiteChromeSavePlanInput = Readonly<{
     selectionId: string | null;
     baseSelectionUpdatedAt: string | null;
 }>;
-export declare function buildSiteChromeSavePlan({ surface, selectionPersistence, siteStyle, selection, baseTheme, headerSelectionContext, headerBrandPreferences, headerNavPreferences, backgroundPreferences, themeId, selectionId, baseSelectionUpdatedAt, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
-export declare function siteChromeSavePlanBodyForBaseRevision(plan: SiteChromeSavePlan, baseSelectionUpdatedAt: string | null): SaveSiteChromeLookSelectionBody;
+export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerLogoContext, headerBrandPreferences, headerNavPreferences, backgroundPreferences, themeId, selectionId, baseSelectionUpdatedAt, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
+export declare function siteChromeSavePlanBodyForBaseRevision(plan: SiteChromeSavePlan, baseSelectionUpdatedAt: string | null): SaveSiteChromeSelectionBody;
+export declare function selectionSnapshotFromSiteChromeSaveResponse({ saved, fallback, savePlan, }: Readonly<{
+    saved: SaveSiteChromeSelectionResponse;
+    fallback: SelectionSnapshot;
+    savePlan: SiteChromeSavePlan;
+}>): SelectionSnapshot;
 export {};