@riverbankcms/sdk 0.60.16 → 0.62.4

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

@@ -0,0 +1,9 @@
+import { type SystemCustomizeFacetId, type SystemCustomizeFacetValue } from '@riverbankcms/blocks/system/customize/facets';
+import type { PageDesignEditorBlock } from '@riverbankcms/theme-core/site-styles/previewCompiler';
+export type PreviewCustomizeFacetControl = Readonly<{
+    facetId: SystemCustomizeFacetId;
+    label: string;
+    value: SystemCustomizeFacetValue;
+    valueLabel: string;
+}>;
+export declare function previewCustomizeFacetControlsFor(blockKind: string, content: Record<string, unknown>, designBlock: PageDesignEditorBlock | null): readonly PreviewCustomizeFacetControl[];

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

@@ -1,4 +1,5 @@
 import type { AppearancePresetId, BoundaryOptionId, DesignBlockId, LayoutVariantKey, PageDesignEditorBlock, PageDesignEditorBoundary } from '@riverbankcms/theme-core/site-styles';
+import { type SystemCustomizeFacetId, type SystemCustomizeFacetTransition, type SystemCustomizeFacetValue } from '@riverbankcms/blocks/system/customize/facets';
 export type PreviewCustomizeCycleDirection = 'prev' | 'next';
 export type PreviewCustomizeAction = Readonly<{
     kind: 'set-layout';
@@ -10,6 +11,10 @@ export type PreviewCustomizeAction = Readonly<{
     blockId: DesignBlockId;
     appearancePresetId: AppearancePresetId | null;
 }> | Readonly<{
+    kind: 'set-block-facet';
+    blockId: DesignBlockId;
+    baseContentId: string | null;
+} & SystemCustomizeFacetTransition> | Readonly<{
     kind: 'set-boundary';
     previousBlockId: DesignBlockId;
     nextBlockId: DesignBlockId;
@@ -25,6 +30,9 @@ type PreviewSetLayoutAction = Extract<PreviewCustomizeAction, {
 type PreviewSetLookAction = Extract<PreviewCustomizeAction, {
     kind: 'set-look';
 }>;
+type PreviewSetBlockFacetAction = Extract<PreviewCustomizeAction, {
+    kind: 'set-block-facet';
+}>;
 type PreviewSetBoundaryAction = Extract<PreviewCustomizeAction, {
     kind: 'set-boundary';
 }>;
@@ -33,5 +41,11 @@ type PreviewResetBoundaryAction = Extract<PreviewCustomizeAction, {
 }>;
 export declare function cyclePageDesignBlockLayout(block: PageDesignEditorBlock, direction: PreviewCustomizeCycleDirection): PreviewSetLayoutAction | null;
 export declare function cyclePageDesignBlockLook(block: PageDesignEditorBlock, direction: PreviewCustomizeCycleDirection): PreviewSetLookAction | null;
+export declare function cyclePageDesignBlockFacet(input: Readonly<{
+    block: PageDesignEditorBlock;
+    facetId: SystemCustomizeFacetId;
+    currentValue: SystemCustomizeFacetValue;
+    direction: PreviewCustomizeCycleDirection;
+}>): PreviewSetBlockFacetAction | null;
 export declare function cyclePageDesignBoundaryBreak(boundary: PageDesignEditorBoundary, direction: PreviewCustomizeCycleDirection): PreviewSetBoundaryAction | PreviewResetBoundaryAction | null;
 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,16 +1,19 @@
 import { type ReactNode } from 'react';
-type PreviewLayoutContextValue = {
+type PreviewLayoutContextValue = Readonly<{
     headerNode: ReactNode;
+    bannerNode?: ReactNode;
     footerNode: ReactNode;
-} | null;
-export declare function PreviewLayoutProvider({ headerNode, footerNode, children, }: {
+}> | null;
+export declare function PreviewLayoutProvider({ headerNode, bannerNode, footerNode, children, }: {
     headerNode: ReactNode;
+    bannerNode?: ReactNode;
     footerNode: ReactNode;
     children: ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function usePreviewLayout(): {
+export declare function usePreviewLayout(): Readonly<{
     headerNode: ReactNode;
+    bannerNode?: ReactNode;
     footerNode: ReactNode;
-};
+}>;
 export declare function useOptionalPreviewLayout(): PreviewLayoutContextValue;
 export {};

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

@@ -1,11 +1,11 @@
 import { type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type PageDesignEditorReadModel } from '@riverbankcms/theme-core/site-styles';
 import { type HistoryState } from '@riverbankcms/content-editor';
 import type { PreviewCustomizeAction } from '../blocks/previewCustomizeActions';
+import type { SystemCustomizeFacetHistorySelection } from '@riverbankcms/blocks/system/customize/facets';
 type PreviewLoadedEditorModel = PageDesignEditorReadModel;
 export type PreviewCustomizeHistoryEntry = Readonly<{
     kind: 'layout';
     blockId: PreviewCustomizeActionBlockId;
-    baseContentId: string | null;
     fromLayoutVariantKey: LayoutVariantKey;
     toLayoutVariantKey: LayoutVariantKey;
 }> | Readonly<{
@@ -14,6 +14,9 @@ export type PreviewCustomizeHistoryEntry = Readonly<{
     fromAppearancePresetId: AppearancePresetId | null;
     toAppearancePresetId: AppearancePresetId | null;
 }> | Readonly<{
+    kind: 'block-facet';
+    blockId: PreviewCustomizeActionBlockId;
+} & SystemCustomizeFacetHistorySelection> | Readonly<{
     kind: 'boundary';
     boundaryId: DesignBoundaryId;
     previousBlockId: PreviewCustomizeActionBlockId;
@@ -35,7 +38,8 @@ export declare function replacePreviewCustomizeHistoryModel(state: PreviewCustom
 export declare function undoPreviewCustomizeHistory(state: PreviewCustomizeHistoryState): PreviewCustomizeHistoryState;
 export declare function redoPreviewCustomizeHistory(state: PreviewCustomizeHistoryState): PreviewCustomizeHistoryState;
 export declare function previewCustomizeHistoryEntryFromAction(editorModel: PreviewLoadedEditorModel, action: PreviewCustomizeAction): PreviewCustomizeHistoryEntry | null;
-export declare function previewCustomizeUndoActionForEntry(entry: PreviewCustomizeHistoryEntry): PreviewCustomizeAction;
-export declare function previewCustomizeRedoActionForEntry(entry: PreviewCustomizeHistoryEntry): PreviewCustomizeAction;
+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;