@riverbankcms/sdk 0.129.0 → 0.130.0

package/dist/_dts/core/src/footer-navigation-layout.d.ts

@@ -0,0 +1,4 @@
+export declare const footerNavigationLayouts: readonly ["stack", "inline-wrap"];
+export type FooterNavigationLayout = (typeof footerNavigationLayouts)[number];
+export declare const defaultFooterNavigationLayout: FooterNavigationLayout;
+export declare function normalizeFooterNavigationLayout(value: 'stack' | 'inline' | 'inline-wrap' | null | undefined): FooterNavigationLayout;

package/dist/_dts/core/src/index.d.ts

@@ -32,6 +32,7 @@ export * from './public-url-validation';
 export * from './public-profile';
 export * from './rich-text';
 export * from './footer-composition';
+export * from './footer-navigation-layout';
 export * from './footer-arrangement';
 export * from './footer-composition-types';
 export * from './footer-engagement';

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

@@ -16214,9 +16214,8 @@ export type Database = {
                     button_style_options: Json;
                     created_at: string;
                     footer_look_id: string | null;
-                    header_layout_id: string | null;
-                    header_look_id: string | null;
-                    header_style_id: string | null;
+                    header_layout_id: string;
+                    header_style_id: string;
                     id: string;
                     is_current: boolean;
                     overrides: Json;
@@ -16231,9 +16230,8 @@ export type Database = {
                     button_style_options?: Json;
                     created_at?: string;
                     footer_look_id?: string | null;
-                    header_layout_id?: string | null;
-                    header_look_id?: string | null;
-                    header_style_id?: string | null;
+                    header_layout_id: string;
+                    header_style_id: string;
                     id?: string;
                     is_current?: boolean;
                     overrides?: Json;
@@ -16248,9 +16246,8 @@ export type Database = {
                     button_style_options?: Json;
                     created_at?: string;
                     footer_look_id?: string | null;
-                    header_layout_id?: string | null;
-                    header_look_id?: string | null;
-                    header_style_id?: string | null;
+                    header_layout_id?: string;
+                    header_style_id?: string;
                     id?: string;
                     is_current?: boolean;
                     overrides?: Json;
@@ -18791,9 +18788,8 @@ export type Database = {
                     p_button_style_id: string;
                     p_button_style_options: Json;
                     p_footer_look_id?: string;
-                    p_header_layout_id?: string;
-                    p_header_look_id?: string;
-                    p_header_style_id?: string;
+                    p_header_layout_id: string;
+                    p_header_style_id: string;
                     p_selection_id?: string;
                     p_site_id: string;
                     p_theme: Json;
@@ -19723,6 +19719,14 @@ export type Database = {
                     status: string;
                 }[];
             };
+            create_managed_event: {
+                Args: {
+                    p_command: Json;
+                    p_site_id: string;
+                    p_user_id: string;
+                };
+                Returns: Json;
+            };
             create_media_asset_with_storage_quota: {
                 Args: {
                     p_asset: Json;
@@ -19867,6 +19871,18 @@ export type Database = {
                 };
                 Returns: string;
             };
+            delete_managed_event_v1_atomic: {
+                Args: {
+                    p_actor_user_id: string;
+                    p_event_offering_id: string;
+                    p_now: string;
+                    p_site_id: string;
+                };
+                Returns: {
+                    outcome: string;
+                    runs_count: number;
+                }[];
+            };
             delete_native_event_series_page_v1_atomic: {
                 Args: {
                     p_actor_user_id: string;
@@ -20887,9 +20903,8 @@ export type Database = {
                     p_button_style_id: string;
                     p_button_style_options: Json;
                     p_footer_look_id?: string;
-                    p_header_layout_id?: string;
-                    p_header_look_id?: string;
-                    p_header_style_id?: string;
+                    p_header_layout_id: string;
+                    p_header_style_id: string;
                     p_site_id: string;
                     p_theme: Json;
                     p_user_id: string;
@@ -20971,6 +20986,12 @@ export type Database = {
                     replayed: boolean;
                 }[];
             };
+            read_managed_event_inventory_snapshot_v1: {
+                Args: {
+                    p_site_id: string;
+                };
+                Returns: Json;
+            };
             read_published_runtime_cache_entry: {
                 Args: {
                     p_cache_key: string;
@@ -21375,9 +21396,8 @@ export type Database = {
                     p_button_style_options: Json;
                     p_expected_selection_version: number;
                     p_footer_look_id?: string;
-                    p_header_layout_id?: string;
-                    p_header_look_id?: string;
-                    p_header_style_id?: string;
+                    p_header_layout_id: string;
+                    p_header_style_id: string;
                     p_selection_id?: string;
                     p_selection_overrides: Json;
                     p_selection_overrides_mode: string;

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

@@ -15,6 +15,7 @@ export * from './fileDownloadResolution';
 export * from './fileAssetDeletion';
 export * from './fileAssetCompatibility';
 export * from './fileMimeDetection';
+export * from './mimeType';
 export * from './filename';
 export * from './uploadVerificationContract';
 export * from './videoPrep';

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;

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/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 {};

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

@@ -0,0 +1,53 @@
+import { type CuratedSiteStyle } from '../../../../theme-core/src/site-styles/previewCompiler';
+import { type FooterLookId, type HeaderLayoutId, type HeaderLogoContext, type HeaderStyleId, type FooterLookCustomizationWritePlan } from '../../../../theme-core/src/site-styles/index';
+import type { SelectionSnapshot, StyleConfiguratorState } from './StyleConfigurator.state';
+export type SiteChromeSelectionOption<TId extends string | null> = Readonly<{
+    id: TId;
+    label: string;
+    description?: string;
+}>;
+export type SiteChromeSelectionCatalogOption<TId extends string> = Readonly<{
+    id: TId;
+    label: string;
+}>;
+export type SiteChromeFooterSelectionRowModel<TId extends string> = Readonly<{
+    options: readonly SiteChromeSelectionOption<TId | null>[];
+    diagnostics: readonly string[];
+    renderedLookId: TId;
+}>;
+export type SiteChromeSelectionModels = Readonly<{
+    headerLayout: Readonly<{
+        options: readonly SiteChromeSelectionOption<HeaderLayoutId>[];
+        renderedLayoutId: HeaderLayoutId;
+    }>;
+    headerStyle: Readonly<{
+        options: readonly SiteChromeSelectionOption<HeaderStyleId>[];
+        renderedStyleId: HeaderStyleId;
+    }>;
+    footer: SiteChromeFooterSelectionRowModel<FooterLookId>;
+}>;
+type SiteChromeSelectionModelInput = Readonly<{
+    state: StyleConfiguratorState;
+    siteStyle: CuratedSiteStyle;
+    headerLogoContext?: HeaderLogoContext;
+}>;
+export declare function buildSiteChromeSelectionModels(input: SiteChromeSelectionModelInput): SiteChromeSelectionModels;
+export declare function cycleSiteChromeSelectionId<TId extends string>(options: readonly SiteChromeSelectionOption<TId | null>[], currentId: TId | null, direction: 'prev' | 'next'): TId | null | undefined;
+export type SiteChromeSelectionCommand = Readonly<{
+    surface: 'header';
+    layoutId: HeaderLayoutId;
+    styleId: HeaderStyleId;
+}> | Readonly<{
+    surface: 'footer';
+    lookId: FooterLookId | null;
+}>;
+export type SiteChromeSelectionPlan = Readonly<{
+    kind: 'header';
+    next: Pick<SelectionSnapshot, 'headerLayoutId' | 'headerStyleId'>;
+}> | Readonly<{
+    kind: 'footer';
+    writePlan: FooterLookCustomizationWritePlan<FooterLookId>;
+    next: Pick<SelectionSnapshot, 'footerLookId'>;
+}>;
+export declare function planSiteChromeSelection(command: SiteChromeSelectionCommand): SiteChromeSelectionPlan;
+export {};

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

@@ -1,16 +1,11 @@
 import type { PreviewRuntimeSession } from "../../auth-contract";
 export type SiteStyleAccess = Readonly<{
     kind: "hidden";
-}> | Readonly<{
-    kind: "preview-only";
 }> | Readonly<{
     kind: "apply-allowed";
 }>;
 export type VisibleSiteStyleAccess = Extract<SiteStyleAccess, Readonly<{
-    kind: "preview-only" | "apply-allowed";
+    kind: "apply-allowed";
 }>>;
 export declare function resolveSiteStyleAccess(session: PreviewRuntimeSession | null): SiteStyleAccess;
 export declare function canInspectSiteStyle(access: SiteStyleAccess): access is VisibleSiteStyleAccess;
-export declare function canApplySiteStyle(access: VisibleSiteStyleAccess): access is Extract<VisibleSiteStyleAccess, Readonly<{
-    kind: "apply-allowed";
-}>>;