@riverbankcms/sdk 0.62.2 → 0.62.4

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

@@ -1,14 +1,15 @@
 import type { BlockItem } from '@riverbankcms/editor-blocks';
-import { type CompiledBlockRuntimeFields, type DesignBlockId, type PageDesignEditorReadModel } from '@riverbankcms/theme-core/site-styles/previewCompiler';
+import type { PageDesignEditorReadModel } from '@riverbankcms/theme-core/site-styles/previewCompiler';
 import type { PreviewPageDesignEditorState } from '../preview/PageDesignEditorStateContext';
-type RuntimeFieldsByBlockId = ReadonlyMap<DesignBlockId, CompiledBlockRuntimeFields>;
-type RuntimePreviewSource = Readonly<{
+import { type RuntimeContentDecorationProjection } from './previewProjection';
+export type RuntimePreviewSource = Readonly<{
     kind: 'preserve-server-runtime';
 }> | Readonly<{
     kind: 'apply-editor-model';
     editorModel: PageDesignEditorReadModel;
 }>;
 export declare function applyPageDesignRuntimeFieldsToBlockItems(blockItems: readonly BlockItem[], source: RuntimePreviewSource): BlockItem[];
-export declare function buildPageDesignRuntimeFieldsByBlockId(editorModel: PageDesignEditorReadModel): RuntimeFieldsByBlockId;
+export declare function applyPageDesignRuntimeFieldsToBlockContent(block: BlockItem, content: Record<string, unknown> | null, source: RuntimePreviewSource): Record<string, unknown> | null;
+export declare function buildPageDesignRuntimeFieldsByBlockId(editorModel: PageDesignEditorReadModel): RuntimeContentDecorationProjection['fieldsByBlockId'];
+export declare function pageDesignRuntimeProjectionFromSource(source: RuntimePreviewSource): RuntimeContentDecorationProjection | null;
 export declare function resolveRuntimePreviewSource(pageDesignState: PreviewPageDesignEditorState): RuntimePreviewSource;
-export {};

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

@@ -0,0 +1,7 @@
+import type { EditorBlockId } from '@riverbankcms/core';
+import type { BlockItem } from '@riverbankcms/editor-blocks';
+import type { AiProposalProjectionState, CanonicalBlockContent, ContentFieldOverrideProjection, PreviewProjection, PreviewRenderContent, StructureProjection } from './types';
+export declare function previewProjectionsFromAiOverlays(overlays: AiProposalProjectionState | null | undefined): PreviewProjection[];
+export declare function applyStructureProjection(blockItems: readonly BlockItem[], projection: StructureProjection): BlockItem[];
+export declare function applyContentFieldOverrideProjection(blockId: EditorBlockId, content: CanonicalBlockContent | PreviewRenderContent | null, projection: ContentFieldOverrideProjection): PreviewRenderContent | CanonicalBlockContent | null;
+export declare function blockHasContentFieldOverrideProjection(blockId: EditorBlockId, projection: ContentFieldOverrideProjection): boolean;

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

@@ -0,0 +1,7 @@
+import type { EditorBlockId } from '@riverbankcms/core';
+import type { BlockItem } from '@riverbankcms/editor-blocks';
+import type { CanonicalBlockContent, PreviewProjection, PreviewRenderContent } from './types';
+export declare function applyPreviewStructureProjections(blockItems: readonly BlockItem[], projections: readonly PreviewProjection[]): BlockItem[];
+export declare function applyPreviewContentFieldProjections(blockId: EditorBlockId, content: CanonicalBlockContent | null, projections: readonly PreviewProjection[]): CanonicalBlockContent | PreviewRenderContent | null;
+export declare function applyPreviewRuntimeContentProjections(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projections: readonly PreviewProjection[]): CanonicalBlockContent | PreviewRenderContent | null;
+export declare function blockHasPreviewContentFieldProjection(blockId: EditorBlockId, projections: readonly PreviewProjection[]): boolean;

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

@@ -0,0 +1,4 @@
+export { applyContentFieldOverrideProjection, applyStructureProjection, blockHasContentFieldOverrideProjection, previewProjectionsFromAiOverlays, } from './aiProposalProjection';
+export { applyPreviewContentFieldProjections, applyPreviewRuntimeContentProjections, applyPreviewStructureProjections, blockHasPreviewContentFieldProjection, } from './applyPreviewProjections';
+export { applyRuntimeContentDecorationProjection, runtimeContentDecorationProjectionFromEditorModel, } from './runtimeContentDecoration';
+export type { AiProposalProjectionState, CanonicalBlockContent, ContentFieldOverrideProjection, PreviewFieldOverride, PreviewProjection, PreviewProjectionAddedBlock, PreviewRenderContent, RuntimeContentDecorationProjection, StructureProjection, } from './types';

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

@@ -0,0 +1,5 @@
+import type { BlockItem } from '@riverbankcms/editor-blocks';
+import { type PageDesignEditorReadModel } from '@riverbankcms/theme-core/site-styles/previewCompiler';
+import type { CanonicalBlockContent, PreviewRenderContent, RuntimeContentDecorationProjection } from './types';
+export declare function runtimeContentDecorationProjectionFromEditorModel(editorModel: PageDesignEditorReadModel): RuntimeContentDecorationProjection;
+export declare function applyRuntimeContentDecorationProjection(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projection: RuntimeContentDecorationProjection): PreviewRenderContent;

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

@@ -0,0 +1,72 @@
+import type { EditorBlockId } from '@riverbankcms/core';
+import type { BlockItem } from '@riverbankcms/editor-blocks';
+import type { CompiledBlockRuntimeFields, DesignBlockId } from '@riverbankcms/theme-core/site-styles/previewCompiler';
+export type CanonicalBlockContent = Record<string, unknown> & {
+    readonly __contentAuthority?: 'canonical-block-content';
+};
+export type PreviewRenderContent = Record<string, unknown> & {
+    readonly __contentAuthority?: 'preview-render-content';
+};
+export type PreviewFieldOverride = Readonly<{
+    proposalId: string;
+    before: unknown;
+    after: unknown;
+}>;
+export type AiProposalProjectionState = Readonly<{
+    viewMode: 'before' | 'after';
+    overrides: ReadonlyMap<string, PreviewFieldOverride>;
+    structure?: AiStructureProjectionInput | null;
+}>;
+export type AiStructureProjectionInput = Readonly<{
+    proposalId: string;
+    includeUnspecified?: boolean;
+    before: Readonly<{
+        blockIds: readonly string[];
+    }>;
+    after: Readonly<{
+        blockIds: readonly string[];
+        addedBlocks?: readonly PreviewProjectionAddedBlock[];
+    }>;
+}>;
+export type PreviewProjectionAddedBlock = Readonly<{
+    id: string;
+    kind: string;
+    content?: CanonicalBlockContent | null;
+}>;
+export type PreviewProjection = Readonly<{
+    kind: 'structure-overlay';
+    source: 'ai-proposal';
+    viewMode: 'before' | 'after';
+    proposalId: string;
+    includeUnspecified?: boolean;
+    before: Readonly<{
+        blockIds: readonly string[];
+    }>;
+    after: Readonly<{
+        blockIds: readonly string[];
+        addedBlocks?: readonly PreviewProjectionAddedBlock[];
+    }>;
+}> | Readonly<{
+    kind: 'content-field-overrides';
+    source: 'ai-proposal';
+    viewMode: 'before' | 'after';
+    overrides: ReadonlyMap<string, PreviewFieldOverride>;
+}> | Readonly<{
+    kind: 'runtime-content-decoration';
+    source: 'page-design';
+    fieldsByBlockId: ReadonlyMap<DesignBlockId, CompiledBlockRuntimeFields>;
+}>;
+export type StructureProjection = Extract<PreviewProjection, {
+    kind: 'structure-overlay';
+}>;
+export type ContentFieldOverrideProjection = Extract<PreviewProjection, {
+    kind: 'content-field-overrides';
+}>;
+export type RuntimeContentDecorationProjection = Extract<PreviewProjection, {
+    kind: 'runtime-content-decoration';
+}>;
+export type ContentProjectionTarget = Readonly<{
+    block: BlockItem;
+    editorBlockId: EditorBlockId | null;
+    content: CanonicalBlockContent | null;
+}>;

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

@@ -8,7 +8,7 @@ export { PreviewShellSmoke } from "./PreviewShellSmoke";
 export { PreviewLayoutProvider, usePreviewLayout, } from "./layout/PreviewLayoutContext";
 export { useOptionalPreviewLayout } from "./layout/PreviewLayoutContext";
 export { previewAssistantEnabled, resolvePreviewSidebarTab, } from "./preview/assistantAvailability";
-export type { PreviewSidebarTab } from "./preview/sidebarTabPreference";
+export type { PreviewDesignRow, PreviewSidebarOpenRequest, PreviewSidebarTab, } from "./preview/sidebarTabPreference";
 export { getPreviewSidebarTab, onPreviewSidebarOpenRequest, requestPreviewSidebarOpen, setPreviewSidebarTab, } from "./preview/sidebarTabPreference";
 export type { PreviewViewportControlsProps, ViewportMode, ViewportWidth, } from "./preview/PreviewViewportControls";
 export { PreviewViewportControls } from "./preview/PreviewViewportControls";

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

@@ -1,17 +1,18 @@
 import { type ReactNode } from 'react';
-import type { SiteChromeLayoutNodes } from '@riverbankcms/theme-core/siteChrome';
-type PreviewLayoutContextValue = SiteChromeLayoutNodes | null;
-export declare function PreviewLayoutProvider({ headerNode, bannerNode, bannerShellBehavior, footerNode, children, }: {
+type PreviewLayoutContextValue = Readonly<{
+    headerNode: ReactNode;
+    bannerNode?: ReactNode;
+    footerNode: ReactNode;
+}> | null;
+export declare function PreviewLayoutProvider({ headerNode, bannerNode, footerNode, children, }: {
     headerNode: ReactNode;
     bannerNode?: ReactNode;
-    bannerShellBehavior?: SiteChromeLayoutNodes['bannerShellBehavior'];
     footerNode: ReactNode;
     children: ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
 export declare function usePreviewLayout(): Readonly<{
     headerNode: ReactNode;
     bannerNode?: ReactNode;
-    bannerShellBehavior?: import("@riverbankcms/blocks").SiteTopShellBehavior;
     footerNode: ReactNode;
 }>;
 export declare function useOptionalPreviewLayout(): PreviewLayoutContextValue;

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

@@ -17,11 +17,12 @@ type PageDesignEditorStateContextValue = Readonly<{
 }>;
 export declare const PREVIEW_CUSTOMIZE_STALE_MESSAGE = "This page changed since that design choice. Refresh the preview, then try again.";
 export { applyPreviewCustomizeActionToState } from './previewCustomizeWorkflowState';
-export declare function PreviewPageDesignEditorStateProvider({ apiClient, siteId, pageId, enabled, children, }: Readonly<{
+export declare function PreviewPageDesignEditorStateProvider({ apiClient, siteId, pageId, enabled, autosaveDelayMs, children, }: Readonly<{
     apiClient: ApiClient;
     siteId: string;
     pageId: string | null;
     enabled: boolean;
+    autosaveDelayMs?: number;
     children: ReactNode;
 }>): import("react/jsx-runtime").JSX.Element;
 export declare function usePreviewPageDesignEditorState(): PageDesignEditorStateContextValue;

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

@@ -7,6 +7,8 @@ import { type ContentTypeSchema } from "@riverbankcms/content-model";
 import { type ZoomLevel } from "@riverbankcms/content-editor";
 import type { ButtonPersonalityId } from "@riverbankcms/theme-core/buttons";
 import type { PaletteOverrides, PaletteVariantId } from "@riverbankcms/theme-core/palette";
+import type { FooterSelectionContext, FooterLookId, HeaderSelectionContext, HeaderLookId } from "@riverbankcms/theme-core/site-styles";
+import type { PreviewDesignRow } from "./sidebarTabPreference";
 import type { ViewportMode, ViewportWidth } from "./PreviewViewportControls";
 import { type SiteStyleAccess } from "./siteStyleAccess";
 export type PreviewEditorSidebarTab = "editor" | "assistant";
@@ -35,6 +37,14 @@ export type PreviewEditorSidebarProps = {
     themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
     themeSelectionPaletteVariantId?: PaletteVariantId | null;
     themeSelectionPaletteOverrides?: PaletteOverrides | null;
+    themeSelectionHeaderLookId?: HeaderLookId | null;
+    themeSelectionFooterLookId?: FooterLookId | null;
+    themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
+    themeSelectionFooterContext?: Partial<FooterSelectionContext>;
+    designRowRequest?: Readonly<{
+        id: number;
+        row: PreviewDesignRow;
+    }> | null;
     apiClient: ApiClient;
     bearerToken?: string | null;
     supabaseUrl?: string;
@@ -53,4 +63,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, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, siteStyleAccess, activeTab, onTabChange, onClose, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): import("react/jsx-runtime").JSX.Element;
+export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, designRowRequest, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, siteStyleAccess, activeTab, onTabChange, onClose, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): import("react/jsx-runtime").JSX.Element;

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

@@ -2,6 +2,7 @@ import { type ComponentProps, type ReactNode } from "react";
 import { BlockApiProvider } from "@riverbankcms/blocks/client";
 import type { ButtonPersonalityId } from "@riverbankcms/theme-core/buttons";
 import type { PaletteOverrides, PaletteVariantId } from "@riverbankcms/theme-core/palette";
+import type { FooterSelectionContext, FooterLookId, HeaderSelectionContext, HeaderLookId } from "@riverbankcms/theme-core/site-styles";
 import type { EntrySubrouteContextData, MediaAssetIndexItem, Theme } from "@riverbankcms/blocks";
 import type { ContentTypeSchema } from "@riverbankcms/content-model";
 import type { SdkConfigForBlockPicker } from "@riverbankcms/editor-blocks";
@@ -34,14 +35,17 @@ export type PreviewShellProps = {
     themeId?: string | null;
     themeSelectionId?: string | null;
     /**
-     * Persisted Style configurator selections (Phase C). Forwarded into the
-     * StyleConfigurator so reload renders the user's saved button personality
-     * + palette variant + sparse overrides instead of falling back to the
-     * site style defaults.
+     * Persisted Style configurator selections. Forwarded into StyleConfigurator
+     * so reload renders the user's saved button personality, palette variant,
+     * and sparse overrides instead of falling back to the site style defaults.
      */
     themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
     themeSelectionPaletteVariantId?: PaletteVariantId | null;
     themeSelectionPaletteOverrides?: PaletteOverrides | null;
+    themeSelectionHeaderLookId?: HeaderLookId | null;
+    themeSelectionFooterLookId?: FooterLookId | null;
+    themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
+    themeSelectionFooterContext?: Partial<FooterSelectionContext>;
     pageId: string | null;
     routeId: string | null;
     entryData?: PreviewContentEntryData | null;
@@ -63,7 +67,7 @@ export type PreviewShellProps = {
     designEditorEligibility?: PreviewDesignEditorEligibility;
     baseFetch?: BaseFetch;
 };
-export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, supabaseUrl, useThemeScope, designEditorEligibility, baseFetch, }: PreviewShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, supabaseUrl, useThemeScope, designEditorEligibility, baseFetch, }: PreviewShellProps): import("react/jsx-runtime").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

@@ -2,6 +2,7 @@ import { type ReactNode } from "react";
 import { type EntrySubrouteContextData, type MediaAssetIndexItem, type Theme } from "@riverbankcms/blocks";
 import type { ButtonPersonalityId } from "@riverbankcms/theme-core/buttons";
 import type { PaletteOverrides, PaletteVariantId } from "@riverbankcms/theme-core/palette";
+import type { FooterSelectionContext, HeaderSelectionContext, FooterLookId, HeaderLookId } from "@riverbankcms/theme-core/site-styles";
 import type { ContentTypeSchema } from "@riverbankcms/content-model";
 import type { ApiClient } from "@riverbankcms/api/request";
 import type { SdkConfigForBlockPicker } from "@riverbankcms/editor-blocks";
@@ -27,6 +28,10 @@ export type PreviewShellLayoutProps = {
     themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
     themeSelectionPaletteVariantId?: PaletteVariantId | null;
     themeSelectionPaletteOverrides?: PaletteOverrides | null;
+    themeSelectionHeaderLookId?: HeaderLookId | null;
+    themeSelectionFooterLookId?: FooterLookId | null;
+    themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
+    themeSelectionFooterContext?: Partial<FooterSelectionContext>;
     supabaseUrl?: string;
     isSiteLaunched: boolean;
     maintenanceModeEnabled: boolean;
@@ -37,4 +42,4 @@ export type PreviewShellLayoutProps = {
     useThemeScope?: boolean;
     siteStyleAccess?: SiteStyleAccess;
 };
-export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, useThemeScope, siteStyleAccess, }: PreviewShellLayoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, useThemeScope, siteStyleAccess, }: PreviewShellLayoutProps): import("react/jsx-runtime").JSX.Element;

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

@@ -2,19 +2,30 @@ import type { ApiClient } from '@riverbankcms/api/request';
 import type { Theme } from '@riverbankcms/blocks';
 import { type ButtonPersonalityId } from '@riverbankcms/theme-core/buttons';
 import { type PaletteVariantId, type PaletteOverrides } from '@riverbankcms/theme-core/palette';
+import { type FooterSelectionContext, type FooterLookId, type HeaderSelectionContext, type HeaderLookId } from '@riverbankcms/theme-core/site-styles';
 import { type VisibleSiteStyleAccess } from './siteStyleAccess';
+import type { PreviewDesignRow } from './sidebarTabPreference';
 export type StyleConfiguratorProps = Readonly<{
     siteId: string;
     apiClient: ApiClient;
     theme?: Theme | null;
     themeId?: string | null;
     selectionId?: string | null;
-    /** Server-persisted Style configurator selections (Phase C). */
+    /** Server-persisted design selections. */
     initialSelections: Readonly<{
         buttonPersonalityId: ButtonPersonalityId | null;
         paletteVariantId: PaletteVariantId | null;
         paletteOverrides: PaletteOverrides | null;
+        headerLookId?: HeaderLookId | null;
+        footerLookId?: FooterLookId | null;
     }>;
+    headerSelectionContext?: Partial<HeaderSelectionContext>;
+    footerSelectionContext?: Partial<FooterSelectionContext>;
+    expandedRowRequest?: Readonly<{
+        /** Monotonic request id so repeated clicks on the same chrome surface retrigger the effect. */
+        id: number;
+        row: PreviewDesignRow;
+    }> | null;
     siteStyleAccess: VisibleSiteStyleAccess;
 }>;
-export declare function StyleConfigurator({ siteId, apiClient, theme, themeId, selectionId, initialSelections, siteStyleAccess, }: StyleConfiguratorProps): import("react/jsx-runtime").JSX.Element;
+export declare function StyleConfigurator({ siteId, apiClient, theme, themeId, selectionId, initialSelections, headerSelectionContext, footerSelectionContext, expandedRowRequest, siteStyleAccess, }: StyleConfiguratorProps): import("react/jsx-runtime").JSX.Element;

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

@@ -12,6 +12,7 @@
  */
 import type { ButtonPersonalityId } from '@riverbankcms/theme-core/buttons';
 import type { PaletteOverrides, PaletteVariantId } from '@riverbankcms/theme-core/palette';
+import type { FooterLookId, HeaderLookId } from '@riverbankcms/theme-core/site-styles';
 import type { SelectionFallbackWarning, SiteStyleId } from '@riverbankcms/theme-core/site-styles/previewCompiler';
 export type StyleConfiguratorSaveStatus = Readonly<{
     kind: 'idle';
@@ -23,7 +24,7 @@ export type StyleConfiguratorSaveStatus = Readonly<{
     kind: 'failed';
     message: string;
 }>;
-export type StyleConfiguratorExpandedRow = 'style' | 'buttons' | 'palette' | 'colours' | null;
+export type StyleConfiguratorExpandedRow = 'style' | 'header' | 'footer' | 'buttons' | 'palette' | 'colours' | null;
 /**
  * Configurator-level notices that aren't compiler selection fallback warnings.
  * Kept separate from `SelectionFallbackWarning` (which comes from
@@ -37,6 +38,8 @@ export type StyleConfiguratorNotice = Readonly<{
 }>;
 export type SelectionSnapshot = Readonly<{
     siteStyleId: SiteStyleId;
+    headerLookId: HeaderLookId | null;
+    footerLookId: FooterLookId | null;
     buttonPersonalityId: ButtonPersonalityId;
     paletteVariantId: PaletteVariantId;
     paletteOverrides: PaletteOverrides | null;
@@ -60,6 +63,7 @@ export type StyleConfiguratorState = Readonly<{
     expandedRow: StyleConfiguratorExpandedRow;
 }>;
 export declare function createStyleConfiguratorState(base: SelectionSnapshot): StyleConfiguratorState;
+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.
  * Drives the "Apply" / "Cancel" footer visibility and the live-preview
@@ -68,6 +72,8 @@ export declare function createStyleConfiguratorState(base: SelectionSnapshot): S
 export declare function isPreviewingChange(state: StyleConfiguratorState): boolean;
 export declare function previewSiteStyle(state: StyleConfiguratorState, siteStyleId: SiteStyleId): StyleConfiguratorState;
 export declare function previewButtonPersonality(state: StyleConfiguratorState, buttonPersonalityId: ButtonPersonalityId): StyleConfiguratorState;
+export declare function previewHeaderLook(state: StyleConfiguratorState, headerLookId: HeaderLookId | null): StyleConfiguratorState;
+export declare function previewFooterLook(state: StyleConfiguratorState, footerLookId: FooterLookId | null): StyleConfiguratorState;
 export declare function previewPaletteVariant(state: StyleConfiguratorState, paletteVariantId: PaletteVariantId): StyleConfiguratorState;
 export declare function setPaletteOverrides(state: StyleConfiguratorState, paletteOverrides: PaletteOverrides | null): StyleConfiguratorState;
 /**

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

@@ -0,0 +1 @@
+export declare const previewCustomizePillButtonClassName = "rounded-full bg-black/80 px-2.5 py-1 text-xs text-white shadow hover:bg-black";

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

@@ -41,4 +41,5 @@ export declare function previewCustomizeHistoryEntryFromAction(editorModel: Prev
 export declare function previewCustomizeUndoActionForEntry(entry: PreviewCustomizeHistoryEntry, editorModel: PreviewLoadedEditorModel): PreviewCustomizeAction;
 export declare function previewCustomizeRedoActionForEntry(entry: PreviewCustomizeHistoryEntry, editorModel: PreviewLoadedEditorModel): PreviewCustomizeAction;
 export declare function previewCustomizeHistoryPresentEquals(left: PreviewCustomizeHistoryPresent, right: PreviewCustomizeHistoryPresent): boolean;
+export declare function contentRevisionIdForBlock(editorModel: PreviewLoadedEditorModel, blockId: PreviewCustomizeActionBlockId): string | null;
 export {};

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

@@ -1,4 +1,4 @@
-import { type PageDesignEditorReadModel } from '@riverbankcms/theme-core/site-styles/previewCompiler';
+import type { PageDesignEditorReadModel } from '@riverbankcms/theme-core/site-styles/previewCompiler';
 import type { DesignBlockId } from '@riverbankcms/theme-core/site-styles';
 import type { PreviewCustomizeAction } from '../blocks/previewCustomizeActions';
 export type PreviewEditorRuntimeContent = Record<string, unknown>;
@@ -8,6 +8,14 @@ export type PreviewCustomizeRuntimePatch = Readonly<{
     nextContent: PreviewEditorRuntimeContent;
     rollback: (currentContent: PreviewEditorRuntimeContent) => PreviewEditorRuntimeContent;
 }>;
+export type PreviewCustomizeActionDomain = Readonly<{
+    kind: 'block-content-write';
+}> | Readonly<{
+    kind: 'page-design-write';
+}> | Readonly<{
+    kind: 'render-only-preview';
+}>;
+export declare function classifyPreviewCustomizeActionDomain(action: PreviewCustomizeAction): PreviewCustomizeActionDomain;
 export declare function derivePreviewCustomizeRuntimePatch(input: Readonly<{
     action: PreviewCustomizeAction;
     editorModel: PageDesignEditorReadModel;

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

@@ -20,6 +20,9 @@ export type PreviewPageDesignEditorState = Readonly<{
 export type PreviewPageDesignEditorApplyOutcome = Readonly<{
     kind: 'saved';
     response: ApplyPageDesignEditorActionResponse;
+}> | Readonly<{
+    kind: 'queued';
+    message: string;
 }> | Readonly<{
     kind: 'skipped';
     reason: PreviewCustomizeSkipReason;
@@ -37,10 +40,14 @@ export type PreviewPageDesignEditorApplyOutcome = Readonly<{
 export type PreviewCustomizeSkipReason = 'disabled' | 'missing-page' | 'not-loaded' | 'mutation-pending' | 'stale' | 'no-history-entry' | 'cannot-undo' | 'cannot-redo';
 export type PreviewCustomizeMutationState = Readonly<{
     kind: 'idle';
+}> | Readonly<{
+    kind: 'dirty';
+    actions: readonly PreviewCustomizePendingAction[];
 }> | Readonly<{
     kind: 'applying';
     action: PreviewCustomizeAction;
     historyEntry: PreviewCustomizeHistoryEntry | null;
+    queuedActions: readonly PreviewCustomizePendingAction[];
 }> | Readonly<{
     kind: 'undoing';
     action: PreviewCustomizeAction;
@@ -72,6 +79,10 @@ export type PreviewCustomizeWorkflowState = Readonly<{
     history: PreviewCustomizeHistoryState;
     mutation: PreviewCustomizeMutationState;
 }>;
+type PreviewCustomizePendingAction = Readonly<{
+    action: PreviewCustomizeAction;
+    historyEntry: PreviewCustomizeHistoryEntry | null;
+}>;
 export type PreviewCustomizeBeginResult = Readonly<{
     kind: 'started';
     state: PreviewCustomizeWorkflowState;
@@ -87,6 +98,7 @@ export declare function failedPreviewCustomizeWorkflowState(message: string): Pr
 export declare function previewCustomizeLoadSucceeded(pageState: ApiPageDesignEditorStateResponse): PreviewCustomizeWorkflowState;
 export declare function previewCustomizeWorkflowPageState(workflow: PreviewCustomizeWorkflowState): PreviewPageDesignEditorState;
 export declare function beginPreviewCustomizeApply(workflow: PreviewCustomizeWorkflowState, action: PreviewCustomizeAction): PreviewCustomizeBeginResult;
+export declare function beginPreviewCustomizeAutosave(workflow: PreviewCustomizeWorkflowState): PreviewCustomizeBeginResult;
 export declare function beginPreviewCustomizeUndo(workflow: PreviewCustomizeWorkflowState): PreviewCustomizeBeginResult;
 export declare function beginPreviewCustomizeRedo(workflow: PreviewCustomizeWorkflowState): PreviewCustomizeBeginResult;
 export declare function confirmPreviewCustomizeMutation(workflow: PreviewCustomizeWorkflowState, response: ApplyPageDesignEditorActionResponse): PreviewCustomizeWorkflowState;
@@ -103,4 +115,5 @@ export declare function applyPreviewCustomizeActionToState(state: PreviewPageDes
 export declare function skippedPreviewCustomizeOutcome(reason: PreviewCustomizeSkipReason): Extract<PreviewPageDesignEditorApplyOutcome, {
     kind: 'skipped';
 }>;
+export declare function previewCustomizePendingActions(workflow: PreviewCustomizeWorkflowState): readonly PreviewCustomizeAction[];
 export {};

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

@@ -1,6 +1,12 @@
 import type { PreviewSidebarTab } from '@riverbankcms/content-editor';
 export type { PreviewSidebarTab };
+export type PreviewDesignRow = 'header' | 'footer';
+export type PreviewSidebarOpenRequest = Readonly<{
+    tab: PreviewSidebarTab;
+    designRow?: PreviewDesignRow;
+}>;
+export declare function parsePreviewSidebarOpenRequestDetail(detail: unknown): PreviewSidebarOpenRequest;
 export declare function getPreviewSidebarTab(): PreviewSidebarTab;
 export declare function setPreviewSidebarTab(tab: PreviewSidebarTab): void;
-export declare function requestPreviewSidebarOpen(tab: PreviewSidebarTab): void;
-export declare function onPreviewSidebarOpenRequest(handler: (tab: PreviewSidebarTab) => void): () => void;
+export declare function requestPreviewSidebarOpen(input: PreviewSidebarTab | PreviewSidebarOpenRequest): void;
+export declare function onPreviewSidebarOpenRequest(handler: (request: PreviewSidebarOpenRequest) => void): () => void;

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

@@ -0,0 +1,49 @@
+import { type CuratedSiteStyle } from '@riverbankcms/theme-core/site-styles/previewCompiler';
+import { type FooterLookId, type FooterSelectionContext, type HeaderLookId, type HeaderSelectionContext, type LookCustomizationWritePlan } from '@riverbankcms/theme-core/site-styles';
+import type { SelectionSnapshot, StyleConfiguratorState } from './StyleConfigurator.state';
+export type SiteChromeLookOption<TId extends string | null> = Readonly<{
+    id: TId;
+    label: string;
+    description?: string;
+    available: boolean;
+}>;
+export type SiteChromeLookCatalogOption<TId extends string> = Readonly<{
+    id: TId;
+    label: string;
+}>;
+export type SiteChromeLookRowModel<TId extends string> = Readonly<{
+    options: readonly SiteChromeLookOption<TId | null>[];
+    diagnostics: readonly string[];
+    renderedLookId: TId;
+}>;
+export type SiteChromeLookModels = Readonly<{
+    header: SiteChromeLookRowModel<HeaderLookId>;
+    footer: SiteChromeLookRowModel<FooterLookId>;
+}>;
+type SiteChromeLookModelInput = Readonly<{
+    state: StyleConfiguratorState;
+    siteStyle: CuratedSiteStyle;
+    headerSelectionContext?: Partial<HeaderSelectionContext>;
+    footerSelectionContext?: Partial<FooterSelectionContext>;
+}>;
+export declare function buildSiteChromeLookModels(input: SiteChromeLookModelInput): SiteChromeLookModels;
+export declare function cycleSiteChromeLookId<TId extends string>(options: readonly SiteChromeLookOption<TId | null>[], currentId: TId | null, direction: 'prev' | 'next'): TId | null | undefined;
+export declare function cycleableSiteChromeOptions<TId extends string>(options: readonly SiteChromeLookOption<TId | null>[]): readonly SiteChromeLookOption<TId | null>[];
+export type SiteChromeLookSelectionCommand = Readonly<{
+    surface: 'header';
+    lookId: HeaderLookId | null;
+}> | Readonly<{
+    surface: 'footer';
+    lookId: FooterLookId | null;
+}>;
+export type SiteChromeLookSelectionPlan = Readonly<{
+    kind: 'header';
+    writePlan: LookCustomizationWritePlan<HeaderLookId>;
+    next: Pick<SelectionSnapshot, 'headerLookId'>;
+}> | Readonly<{
+    kind: 'footer';
+    writePlan: LookCustomizationWritePlan<FooterLookId>;
+    next: Pick<SelectionSnapshot, 'footerLookId'>;
+}>;
+export declare function planSiteChromeLookSelection(command: SiteChromeLookSelectionCommand): SiteChromeLookSelectionPlan;
+export {};

package/dist/_dts/sdk/src/public-api/contracts.d.ts

@@ -284,13 +284,15 @@ export type SiteResponse = {
     themeId?: string | null;
     selectionId?: string | null;
     /**
-     * Persisted Style configurator selections (Phase C). Optional so legacy
+     * Persisted design selections. Optional so legacy
      * payloads without these columns still satisfy the type — consumers fall
      * back to the site style's defaults when null.
      */
     selectionButtonPersonalityId?: string | null;
     selectionPaletteVariantId?: string | null;
     selectionPaletteOverrides?: Record<string, string> | null;
+    selectionHeaderLookId?: string | null;
+    selectionFooterLookId?: string | null;
     navigation: NavigationMenuWithItems[];
     appointmentsEnabled?: boolean;
     portalEnabled?: boolean;

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.62.2";
+export declare const SDK_VERSION = "0.62.4";

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

@@ -34,6 +34,7 @@ export type SurfaceHostContext = Readonly<{
  * rather than relying on positional alignment between arrays.
  */
 export declare const SURFACE_ROOT_HOSTS: Readonly<Record<SurfaceId, Readonly<Record<SurfaceTier, string>>>>;
+export declare const SURFACE_SITE_ROOT_HOSTS: Readonly<Record<SurfaceId, Readonly<Record<SurfaceTier, string>>>>;
 export declare function resolveSurfaceFontHref(surfaceId: SurfaceId): string | null;
 export declare function resolveSurfaceHostContext(value: string | URL | null | undefined): SurfaceHostContext | null;
 export declare function buildSurfaceAwareDashboardOrigin(input: Readonly<{