@riverbankcms/sdk 0.62.2 → 0.64.0

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

@@ -886,6 +886,7 @@ export declare function parseBookingQuestionsContent(shape: BookingQuestionsForm
  * Form creation payload schema
  * Validates the request body when creating a new form via API
  */
+export declare const formSlugSchema: z.ZodString;
 export declare const createFormPayloadSchema: z.ZodObject<{
     name: z.ZodString;
     slug: z.ZodString;

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

@@ -18,6 +18,6 @@ export type { BlockDraftSaveability, BlockDraftValidationIssue } from '@riverban
 export { applyManifestIssuesToForm } from './manifestIssues';
 export { BlockPickerDialog } from './block-editor/BlockPickerDialog';
 export { MediaField } from './media/MediaField';
-export * from './widgets';
+export * from './widgets/index';
 export { createBlockFormLogger, setBlockFormLoggerFactory, setBlockFormAppLogger } from './block-form/debug';
 export type { BlockFormLogger } from './block-form/debug';

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

@@ -1,7 +1,7 @@
-export * from './button';
-export * from './content-type-select';
-export * from './entry-picker';
-export * from './icon-picker';
-export * from './link';
-export * from './reference';
-export * from './rich-text';
+export * from './button/index';
+export * from './content-type-select/index';
+export * from './entry-picker/index';
+export * from './icon-picker/index';
+export * from './link/index';
+export * from './reference/index';
+export * from './rich-text/index';

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

@@ -3,7 +3,7 @@ import { type LinkValue } from '@riverbankcms/blocks';
 import type { RoutableContentItem } from '@riverbankcms/api/navigation';
 import type { SiteId } from '@riverbankcms/core';
 import type { LinkWidgetAdapters } from './types';
-type LinkWidgetProps = {
+export type LinkWidgetProps = {
     siteId?: SiteId;
     value: LinkValue | null;
     onChange: (value: LinkValue | null) => void;
@@ -16,4 +16,3 @@ type LinkWidgetProps = {
     mode?: 'inline' | 'dialog';
 };
 export declare function LinkWidget({ siteId, value, onChange, disabled, initialItems, adapters, label, description, fieldPath, mode, }: LinkWidgetProps): import("react/jsx-runtime").JSX.Element;
-export {};

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

@@ -1,4 +1,5 @@
 export { LinkWidget } from './LinkWidget';
+export type { LinkWidgetProps } from './LinkWidget';
 export { LinkPicker } from './LinkPicker';
 export { LinkPickerDialog } from './LinkPickerDialog';
 export { LinkSummary } from './LinkSummary';

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

@@ -1,5 +1,6 @@
-export declare function BlockToolbar({ blockId, blockKind, content, }: {
+export declare function BlockToolbar({ blockId, blockKind, content, headerClearancePx, }: {
     blockId: string;
     blockKind: string;
     content: Record<string, unknown>;
+    headerClearancePx?: number;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -1,7 +1,8 @@
 import type { MutableRefObject } from 'react';
 import type { PageOutline } from '@riverbankcms/blocks';
-import type { ComposePageArgs, CachedBlockTransform, BlockWithContent } from './types';
+import type { ComposePageArgs, ComposePreviewRenderPageArgs, CachedBlockTransform, BlockWithContent } from './types';
 export type PageOutlineWithContent = Omit<PageOutline, 'blocks'> & {
     blocks: BlockWithContent[];
 };
 export declare function composePageFromBlocks(args: ComposePageArgs, cacheRef: MutableRefObject<Map<string, CachedBlockTransform>>): PageOutlineWithContent | null;
+export declare function composePreviewRenderPage(args: ComposePreviewRenderPageArgs, cacheRef: MutableRefObject<Map<string, CachedBlockTransform>>): PageOutlineWithContent | null;

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

@@ -1,2 +1,2 @@
-export { composePageFromBlocks } from './composePageFromBlocks';
-export type { ComposePageArgs, CachedBlockTransform, EditorDraftInspectorStore } from './types';
+export { composePageFromBlocks, composePreviewRenderPage, } from './composePageFromBlocks';
+export type { CachedBlockTransform, ComposePageArgs, ComposePreviewRenderPageArgs, EditorDraftInspectorStore, } from './types';

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

@@ -1,5 +1,6 @@
 import type { EditorBlockId } from '@riverbankcms/core';
 import type { BlockItem } from '@riverbankcms/editor-blocks';
 import type { DraftSnapshot, EditorDraftInspectorStore, EnrichedBlock } from './types';
+import { type PreviewProjection } from '../previewProjection';
 export declare function getDraftSnapshots(uiStore: EditorDraftInspectorStore): Map<EditorBlockId, DraftSnapshot>;
-export declare function mergeBlockWithDraft(block: BlockItem, draftMap: Map<EditorBlockId, DraftSnapshot>, index: number, uiStore: EditorDraftInspectorStore): EnrichedBlock;
+export declare function mergeBlockWithDraft(block: BlockItem, draftMap: Map<EditorBlockId, DraftSnapshot>, index: number, projections?: readonly PreviewProjection[]): EnrichedBlock;

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

@@ -1,29 +1,30 @@
 import type { PageOutline } from '@riverbankcms/blocks';
 import type { EditorBlockId } from '@riverbankcms/core';
 import type { BlockItem } from '@riverbankcms/editor-blocks';
+import type { CanonicalBlockContent, PreviewProjection, PreviewRenderContent } from '../previewProjection';
 export type BlockWithContent = {
     [key: string]: unknown;
     id: string | null;
     kind: string;
     purpose: string;
-    content?: Record<string, unknown>;
-    draftContent?: Record<string, unknown> | null;
-    publishedContent?: Record<string, unknown> | null;
+    content?: PreviewRenderContent;
+    draftContent?: PreviewRenderContent | null;
+    publishedContent?: PreviewRenderContent | null;
     bindings?: Record<string, unknown>;
 };
 export type DraftSnapshot = {
     id: EditorBlockId;
-    baseline: Record<string, unknown> | null;
-    current: Record<string, unknown> | null;
+    baseline: CanonicalBlockContent | null;
+    current: CanonicalBlockContent | null;
 };
 export type EnrichedBlock = {
     id: string | null;
     kind: string;
     purpose: string;
     orderIndex: number;
-    content: Record<string, unknown> | null;
-    draftContent: Record<string, unknown> | null;
-    publishedContent: Record<string, unknown> | null;
+    content: PreviewRenderContent | null;
+    draftContent: PreviewRenderContent | null;
+    publishedContent: PreviewRenderContent | null;
     bindings: Record<string, unknown> | null;
 };
 export type CachedBlockTransform = {
@@ -42,6 +43,21 @@ export type EditorDraftInspectorStore = {
                 before: unknown;
                 after: unknown;
             }>;
+            structure?: {
+                proposalId: string;
+                includeUnspecified?: boolean;
+                before: {
+                    blockIds: string[];
+                };
+                after: {
+                    blockIds: string[];
+                    addedBlocks?: Array<{
+                        id: string;
+                        kind: string;
+                        content?: Record<string, unknown> | null;
+                    }>;
+                };
+            } | null;
         };
     };
 };
@@ -49,4 +65,11 @@ export type ComposePageArgs = {
     page: PageOutline | null;
     blockItems: BlockItem[];
     uiStore: EditorDraftInspectorStore;
+    projections?: readonly PreviewProjection[];
+};
+export type ComposePreviewRenderPageArgs = {
+    page: PageOutline | null;
+    blockItems: BlockItem[];
+    draftSnapshots: readonly DraftSnapshot[];
+    projections: readonly PreviewProjection[];
 };

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";
@@ -31,10 +33,19 @@ export type PreviewEditorSidebarProps = {
     theme?: Theme | null;
     themeId?: string | null;
     themeSelectionId?: string | null;
+    themeSelectionUpdatedAt?: string | null;
     /** Persisted Style configurator selections (Phase C / E). */
     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 +64,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, themeSelectionUpdatedAt, 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";
@@ -33,15 +34,19 @@ export type PreviewShellProps = {
     theme: Theme;
     themeId?: string | null;
     themeSelectionId?: string | null;
+    themeSelectionUpdatedAt?: 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 +68,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, themeSelectionUpdatedAt, 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";
@@ -24,9 +25,14 @@ export type PreviewShellLayoutProps = {
     bearerToken?: string | null;
     themeId?: string | null;
     themeSelectionId?: string | null;
+    themeSelectionUpdatedAt?: string | null;
     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 +43,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, themeSelectionUpdatedAt, 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/SiteChromeCustomizeButton.d.ts

@@ -0,0 +1,4 @@
+import type { SiteChromeEditableSurfaceKind } from './SiteChromeEditableSurface';
+export declare function SiteChromeCustomizeButton({ surface, }: {
+    surface: SiteChromeEditableSurfaceKind;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,49 @@
+import { type ReactNode } from 'react';
+import type { ApiClient } from '@riverbankcms/api/request';
+import type { Theme } from '@riverbankcms/blocks';
+import type { ButtonPersonalityId } from '@riverbankcms/theme-core/buttons';
+import type { PaletteOverrides, PaletteVariantId } from '@riverbankcms/theme-core/palette';
+import type { FooterLookId, FooterSelectionContext, HeaderLookId, HeaderSelectionContext } from '@riverbankcms/theme-core/site-styles';
+import type { SiteStyleAccess } from './siteStyleAccess';
+import { type SiteChromeLookOption } from './siteChromeLookRows';
+import type { SiteChromeEditableSurfaceKind } from './SiteChromeEditableSurface';
+type SiteChromeCustomizeSurfaceState = Readonly<{
+    kind: 'unavailable';
+}> | Readonly<{
+    kind: 'available';
+    label: string;
+    currentId: HeaderLookId | FooterLookId | null;
+    currentLabel: string;
+    options: readonly SiteChromeLookOption<HeaderLookId | FooterLookId | null>[];
+    diagnostics: readonly string[];
+    saving: boolean;
+    failure: string | null;
+    applyAllowed: boolean;
+}>;
+type SiteChromeCustomizeContextValue = Readonly<{
+    getSurfaceState: (surface: SiteChromeEditableSurfaceKind) => SiteChromeCustomizeSurfaceState;
+    cycleSurfaceLook: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
+}>;
+export type SiteChromeCustomizeProviderProps = Readonly<{
+    children: ReactNode;
+    siteId: string;
+    apiClient: ApiClient;
+    theme?: Theme | null;
+    themeId?: string | null;
+    selectionId?: string | null;
+    selectionUpdatedAt?: string | null;
+    initialSelections: Readonly<{
+        selectionUpdatedAt?: string | null;
+        buttonPersonalityId: ButtonPersonalityId | null;
+        paletteVariantId: PaletteVariantId | null;
+        paletteOverrides: PaletteOverrides | null;
+        headerLookId?: HeaderLookId | null;
+        footerLookId?: FooterLookId | null;
+    }>;
+    headerSelectionContext?: Partial<HeaderSelectionContext>;
+    footerSelectionContext?: Partial<FooterSelectionContext>;
+    siteStyleAccess?: SiteStyleAccess;
+}>;
+export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, themeId, selectionId, selectionUpdatedAt, initialSelections, headerSelectionContext, footerSelectionContext, siteStyleAccess, }: SiteChromeCustomizeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useSiteChromeCustomizeOptional(): SiteChromeCustomizeContextValue | null;
+export {};

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

@@ -0,0 +1,6 @@
+import { default as React, type ReactNode } from 'react';
+export type SiteChromeEditableSurfaceKind = 'header' | 'footer';
+export declare function SiteChromeEditableSurface({ surface, children, }: {
+    surface: SiteChromeEditableSurfaceKind;
+    children: ReactNode;
+}): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;

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

@@ -2,19 +2,32 @@ 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). */
+    selectionUpdatedAt?: string | null;
+    /** Server-persisted design selections. */
     initialSelections: Readonly<{
+        selectionUpdatedAt?: string | null;
         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, selectionUpdatedAt, 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,9 @@ export type StyleConfiguratorNotice = Readonly<{
 }>;
 export type SelectionSnapshot = Readonly<{
     siteStyleId: SiteStyleId;
+    selectionUpdatedAt?: string | null;
+    headerLookId: HeaderLookId | null;
+    footerLookId: FooterLookId | null;
     buttonPersonalityId: ButtonPersonalityId;
     paletteVariantId: PaletteVariantId;
     paletteOverrides: PaletteOverrides | null;
@@ -60,6 +64,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 +73,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 {};