@riverbankcms/sdk 0.80.0 → 0.81.0

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

@@ -1,7 +1,9 @@
 import type { PageOutline } from '../../../../../blocks/src/index';
+import type { EditorPreviewInspectorStore } from '../../../../../content-editor/src/index';
 import type { EditorBlockId } from '../../../../../core/src/index';
 import type { BlockItem } from '../../../../../editor-blocks/src/index';
 import type { CanonicalBlockContent, PreviewProjection, PreviewRenderContent } from '../previewProjection';
+import type { LinkedEntryRenderOverlay } from '../linkedEntryRenderOverlay';
 export type BlockWithContent = {
     [key: string]: unknown;
     id: string | null;
@@ -31,36 +33,7 @@ export type CachedBlockTransform = {
     src: EnrichedBlock;
     out: BlockWithContent;
 };
-export type EditorDraftInspectorStore = {
-    getState: () => {
-        drafts: {
-            inspect: () => DraftSnapshot[];
-        };
-        aiOverlays?: {
-            viewMode: 'before' | 'after';
-            overrides: Map<string, {
-                proposalId: string;
-                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;
-        };
-    };
-};
+export type EditorDraftInspectorStore = EditorPreviewInspectorStore;
 export type ComposePageArgs = {
     page: PageOutline | null;
     blockItems: BlockItem[];
@@ -72,4 +45,5 @@ export type ComposePreviewRenderPageArgs = {
     blockItems: BlockItem[];
     draftSnapshots: readonly DraftSnapshot[];
     projections: readonly PreviewProjection[];
+    linkedEntryOverlays?: LinkedEntryRenderOverlay;
 };

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

@@ -0,0 +1,11 @@
+import { type LinkedContentEntryId } from '../../../../content-editor/src/index';
+export type LinkedEntryRenderOverlay = ReadonlyMap<LinkedContentEntryId, Readonly<{
+    content: Record<string, unknown>;
+    optimisticHash: string | null;
+}>>;
+type DataContextWithResolvedData = Readonly<{
+    resolvedData?: Record<string, Record<string, unknown>>;
+}>;
+export declare function applyLinkedEntryRenderOverlay<T>(value: T, overlays: LinkedEntryRenderOverlay): T;
+export declare function applyLinkedEntryRenderOverlayToDataContext<T extends DataContextWithResolvedData | undefined>(dataContext: T, overlays: LinkedEntryRenderOverlay): T;
+export {};

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

@@ -1,6 +1,6 @@
-import type { AppearancePresetId, BoundaryOptionId, DesignBlockId, LayoutVariantKey, PageDesignEditorBlock, PageDesignEditorBoundary } from '../../../../theme-core/src/site-styles/index';
+import type { AppearancePresetId, BoundaryOptionId, DesignBlockId, LayoutVariantKey, PageDesignEditorBlock } from '../../../../theme-core/src/site-styles/index';
 import { type SystemCustomizeFacetId, type SystemCustomizeFacetTransition, type SystemCustomizeFacetValue } from '../../../../blocks/src/system/customize/facets';
-import { type BackgroundImagePoolItem, type BackgroundOverride } from '../../../../blocks/src/system/customize/backgrounds';
+import { type BackgroundImagePoolItem, type BackgroundImagePoolMediaAsset, type BackgroundOverride } from '../../../../blocks/src/system/customize/backgrounds';
 export type PreviewCustomizeCycleDirection = 'prev' | 'next';
 export type PreviewCustomizeAction = Readonly<{
     kind: 'set-layout';
@@ -21,6 +21,7 @@ export type PreviewCustomizeAction = Readonly<{
     override: BackgroundOverride;
     fromOverride: BackgroundOverride;
     baseContentId: string | null;
+    imageAsset?: BackgroundImagePoolMediaAsset;
 }> | Readonly<{
     kind: 'set-boundary';
     previousBlockId: DesignBlockId;
@@ -43,12 +44,6 @@ type PreviewSetBlockFacetAction = Extract<PreviewCustomizeAction, {
 type PreviewSetBackgroundAction = Extract<PreviewCustomizeAction, {
     kind: 'set-background';
 }>;
-type PreviewSetBoundaryAction = Extract<PreviewCustomizeAction, {
-    kind: 'set-boundary';
-}>;
-type PreviewResetBoundaryAction = Extract<PreviewCustomizeAction, {
-    kind: 'reset-boundary';
-}>;
 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<{
@@ -64,5 +59,4 @@ export declare function setPageDesignBlockBackground(input: Readonly<{
     fromOverride?: BackgroundOverride;
     imagePool?: readonly BackgroundImagePoolItem[];
 }>): PreviewSetBackgroundAction | null;
-export declare function cyclePageDesignBoundaryBreak(boundary: PageDesignEditorBoundary, direction: PreviewCustomizeCycleDirection): PreviewSetBoundaryAction | PreviewResetBoundaryAction | null;
 export {};

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

@@ -1,5 +1,6 @@
 import { type BlockManifest, type Theme } from '../../../../blocks/src/index';
 import { type FieldConfig, type FormBackend } from '../../../../block-form/src/client/index';
+import type { EditorBlockId } from '../../../../core/src/index';
 import { type SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
 import type { EditorUiState } from '../../../../content-editor/src/index';
 import type { PreviewZustandStoreApi } from '../preview/storeTypes';
@@ -16,7 +17,7 @@ export type BlockCustomizeControls = Readonly<{
     hasOverflowControls: boolean;
 }>;
 export declare function useBlockCustomizeControls({ blockId, blockKind, content, uiStore, theme, sdkConfig, maxQuickFields, maxPopoverRows, builtInPopoverRows, }: {
-    blockId: string;
+    blockId: EditorBlockId;
     blockKind: string;
     content: Readonly<Record<string, unknown>>;
     uiStore: PreviewZustandStoreApi<EditorUiState>;

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

@@ -29,7 +29,6 @@ export { PreviewAuthInit } from "./preview/PreviewAuthInit";
 export { PreviewAuthBanner } from "./preview/PreviewAuthBanner";
 export { PreviewKeepAliveClient } from "./preview/PreviewKeepAliveClient";
 export { PreviewQueryProvider, createPreviewQueryClient, } from "./preview/PreviewQueryProvider";
-export { resolvePreviewSurfaceId, resolvePreviewSurfaceIdFromSearch, } from "./preview/previewSurface";
 export { PreviewShell } from "./preview/PreviewShell";
 export type { PreviewShellProps } from "./preview/PreviewShell";
 export { PreviewShellLayout } from "./preview/PreviewShellLayout";

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

@@ -6,6 +6,7 @@ import type { EntrySubrouteContextData, MediaAssetIndexItem, Theme } from '../..
 import type { FieldWidgetComponent } from '../../../../block-form/src/client/index';
 import { type ViewportMode, type ViewportWidth } from './PreviewViewportControls';
 import type { PreviewEditorSidebarProps, PreviewTemplateData } from './PreviewEditorSidebar';
+import { type PreviewLinkedEntrySidebarSection } from './PreviewSidebarSection';
 type EntryEditorPanelProps = {
     siteId: string;
     entryData: NonNullable<PreviewEditorSidebarProps['entryData']>;
@@ -19,6 +20,7 @@ type EntryEditorPanelProps = {
     supabaseUrl?: string;
     entrySubrouteContext?: EntrySubrouteContextData | null;
     metadataPanel: ReactNode;
+    linkedEntrySection?: PreviewLinkedEntrySidebarSection | null;
     mediaAssets?: MediaAssetIndexItem[];
     widgets: Record<string, FieldWidgetComponent>;
     viewportMode: ViewportMode;
@@ -28,5 +30,5 @@ type EntryEditorPanelProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function EntryEditorPanel({ siteId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, metadataPanel, mediaAssets, widgets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: EntryEditorPanelProps): import("react/jsx-runtime").JSX.Element;
+export declare function EntryEditorPanel({ siteId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, metadataPanel, linkedEntrySection, mediaAssets, widgets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: EntryEditorPanelProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1 @@
+export declare function LinkedEntryEditEventBridge(): null;

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

@@ -6,6 +6,7 @@ import type { MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
 import type { EditorUiState, ZoomLevel } from '../../../../content-editor/src/index';
 import { type ViewportMode, type ViewportWidth } from './PreviewViewportControls';
 import type { PreviewZustandStoreApi } from './storeTypes';
+import { type PreviewLinkedEntrySidebarSection } from './PreviewSidebarSection';
 type PageBlockEditorPanelProps = {
     siteId: string;
     pageId: string;
@@ -18,6 +19,7 @@ type PageBlockEditorPanelProps = {
     blockEditorRef: MutableRefObject<BlockEditorHandle | null>;
     onBlocksChange: (nextItems: BlockItem[]) => void;
     metadataPanel: ReactNode;
+    linkedEntrySection?: PreviewLinkedEntrySidebarSection | null;
     designPanel?: ReactNode;
     sdkConfig?: SdkConfigForBlockPicker | null;
     mediaAssets?: MediaAssetIndexItem[];
@@ -28,5 +30,5 @@ type PageBlockEditorPanelProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function PageBlockEditorPanel({ siteId, pageId, theme, apiClient, bearerToken, supabaseUrl, blockItems, uiStoreForBlockEditor, blockEditorRef, onBlocksChange, metadataPanel, designPanel, sdkConfig, mediaAssets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PageBlockEditorPanelProps): import("react/jsx-runtime").JSX.Element;
+export declare function PageBlockEditorPanel({ siteId, pageId, theme, apiClient, bearerToken, supabaseUrl, blockItems, uiStoreForBlockEditor, blockEditorRef, onBlocksChange, metadataPanel, linkedEntrySection, designPanel, sdkConfig, mediaAssets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PageBlockEditorPanelProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1,20 @@
+import { type CSSProperties, type ReactNode } from 'react';
+import { type PreviewChromeAnchorBox, type PreviewChromeFloatingPlacement } from './previewChromePlacement';
+type PreviewChromeLayerContextValue = Readonly<{
+    portalTarget: HTMLElement | null;
+    subscribeLayout: (listener: () => void) => () => void;
+}>;
+export declare function PreviewChromeLayerProvider({ children, }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function usePreviewChromeLayerOptional(): PreviewChromeLayerContextValue | null;
+export declare function PreviewChromeFloatingControl({ anchorSelector, placement, fallbackClassName, fallbackStyle, portalClassName, forceVisible, children, }: {
+    anchorSelector: string;
+    placement: PreviewChromeFloatingPlacement | ((anchorBox: PreviewChromeAnchorBox | null) => PreviewChromeFloatingPlacement);
+    fallbackClassName: string;
+    fallbackStyle?: CSSProperties;
+    portalClassName?: string;
+    forceVisible?: boolean;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,13 @@
+import { type ReactNode } from 'react';
+import { type PreviewDesignHistoryDomainId, type PreviewDesignHistoryOrderState } from './previewDesignHistoryOrder';
+type PreviewDesignHistoryOrderContextValue = Readonly<{
+    state: PreviewDesignHistoryOrderState;
+    record: (domainId: PreviewDesignHistoryDomainId) => void;
+    confirmUndo: (domainId: PreviewDesignHistoryDomainId) => void;
+    confirmRedo: (domainId: PreviewDesignHistoryDomainId) => void;
+}>;
+export declare function PreviewDesignHistoryOrderProvider({ children, }: Readonly<{
+    children: ReactNode;
+}>): import("react/jsx-runtime").JSX.Element;
+export declare function usePreviewDesignHistoryOrder(): PreviewDesignHistoryOrderContextValue;
+export {};

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

@@ -1,3 +1,3 @@
-import type { StatusBarMenuItem } from '@riverbankcms/editor';
+import type { StatusBarMenuItem } from '../../../../editor/src/index';
 export declare function usePreviewOpenEditorMobileMenuItems(): StatusBarMenuItem[];
 export declare function PreviewOpenEditorButton(): import("react/jsx-runtime").JSX.Element;

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

@@ -1,29 +1,29 @@
-import { type ComponentProps, type ReactNode } from "react";
-import { BlockApiProvider } from "../../../../blocks/src/client";
-import type { ButtonPersonalityId } from "../../../../theme-core/src/buttons/index";
-import type { PaletteOverrides, PaletteVariantId } from "../../../../theme-core/src/palette/index";
-import type { FooterSelectionContext, FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId, TypographyPresetId } from "../../../../theme-core/src/site-styles/index";
-import type { EntrySubrouteContextData, MediaAssetIndexItem, Theme } from "../../../../blocks/src/index";
-import type { ContentTypeSchema } from "../../../../content-model/src/index";
-import type { SdkConfigForBlockPicker } from "../../../../editor-blocks/src/index";
-import type { SurfaceId } from "../../../../surfaces/src/index";
-import { type PreviewBlock, type PreviewContentEntryData, type PreviewPageMetadata } from "./PreviewEntryControllerProvider";
-import type { PreviewEditorSidebarProps, PreviewTemplateData } from "./PreviewEditorSidebar";
-import { type PreviewRuntimeSession } from "../../auth-contract";
+import { type ComponentProps, type ReactNode } from 'react';
+import { BlockApiProvider } from '../../../../blocks/src/client';
+import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
+import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
+import type { FooterSelectionContext, FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
+import type { EntrySubrouteContextData, MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
+import type { ContentTypeSchema } from '../../../../content-model/src/index';
+import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
+import type { SurfaceId } from '../../../../surfaces/src/index';
+import { type PreviewBlock, type PreviewContentEntryData, type PreviewPageMetadata } from './PreviewEntryControllerProvider';
+import type { PreviewEditorSidebarProps, PreviewTemplateData } from './PreviewEditorSidebar';
+import { type PreviewRuntimeSession } from '../../auth-contract';
 type BaseFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
 export type PreviewDesignEditorEligibility = Readonly<{
-    kind: "managed-page";
+    kind: 'managed-page';
 }> | Readonly<{
-    kind: "content-entry";
+    kind: 'content-entry';
 }> | Readonly<{
-    kind: "sdk-page";
+    kind: 'sdk-page';
 }> | Readonly<{
-    kind: "unsupported";
+    kind: 'unsupported';
 }>;
 export type PreviewShellProps = {
     children: ReactNode;
     apiBaseUrl: string;
-    blockApiConfig: ComponentProps<typeof BlockApiProvider>["config"];
+    blockApiConfig: ComponentProps<typeof BlockApiProvider>['config'];
     siteId: string;
     siteSlug: string;
     editableId: string | null;
@@ -60,13 +60,13 @@ export type PreviewShellProps = {
     referenceContentTypeKeys?: readonly string[];
     draftContent?: Record<string, unknown> | null;
     currentTemplate?: PreviewTemplateData | null;
-    initialStatus?: "draft" | "scheduled" | "published";
+    initialStatus?: 'draft' | 'scheduled' | 'published';
     initialBlocks?: PreviewBlock[];
     pageMetadata?: PreviewPageMetadata;
     isSiteLaunched: boolean;
     maintenanceModeEnabled: boolean;
     entrySubrouteContext?: EntrySubrouteContextData | null;
-    assistantPanel?: PreviewEditorSidebarProps["assistantPanel"];
+    assistantPanel?: PreviewEditorSidebarProps['assistantPanel'];
     sdkConfig?: SdkConfigForBlockPicker | null;
     mediaAssets?: MediaAssetIndexItem[];
     supabaseUrl?: string;

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

@@ -0,0 +1,13 @@
+import { type ReactNode } from 'react';
+export type PreviewSidebarSectionProps = Readonly<{
+    label: string;
+    defaultOpen?: boolean;
+    openRequestId?: number | null;
+    children: ReactNode;
+}>;
+export type PreviewLinkedEntrySidebarSection = Readonly<{
+    label: string;
+    openRequestId: number;
+    content: ReactNode;
+}>;
+export declare function PreviewSidebarSection({ label, defaultOpen, openRequestId, children, }: PreviewSidebarSectionProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,12 +1,49 @@
 import { type ReactNode } from 'react';
-import type { ApiClient } from '../../../../api/src/request';
+import { type ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
 import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
-import type { FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
+import type { BrandDisplayMode, FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, LogoSizePolicy, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
+import { type StyleConfiguratorHistoryEntry } from './StyleConfigurator.state';
 import type { SiteStyleAccess } from './siteStyleAccess';
 import { type SiteChromeLookOption } from './siteChromeLookRows';
 import type { SiteChromeEditableSurfaceKind } from './SiteChromeEditableSurface';
+import { type HeaderBrandDisplayOption, type HeaderLogoSizeOption } from './siteChromeBrandPreferences';
+import { type SiteStyleHistoryFailure, type SiteStyleHistorySkipReason } from './siteStyleHistoryState';
+import { type SiteChromeQuickControlHistoryFailure, type SiteChromeQuickControlHistorySkipReason } from './siteChromeQuickControlHistoryState';
+type SiteStyleHistoryController = Readonly<{
+    recordAppliedSelection: (entry: StyleConfiguratorHistoryEntry) => void;
+    setStagedPreviewActive: (active: boolean) => void;
+    undo: () => Promise<SiteStyleHistoryApplyOutcome>;
+    redo: () => Promise<SiteStyleHistoryApplyOutcome>;
+    canUndo: boolean;
+    canRedo: boolean;
+    isHistoryPending: boolean;
+    isHistoryStale: boolean;
+    historyFailure: string | null;
+    hasActiveStagedPreview: boolean;
+}>;
+type SiteStyleHistoryApplyOutcome = Readonly<{
+    kind: 'saved';
+}> | Readonly<{
+    kind: 'skipped';
+    reason: SiteStyleHistorySkipReason | 'not-ready' | 'staged-preview-active';
+}> | SiteStyleHistoryFailure;
+type SiteChromeQuickControlHistoryController = Readonly<{
+    undo: () => Promise<SiteChromeQuickControlApplyOutcome>;
+    redo: () => Promise<SiteChromeQuickControlApplyOutcome>;
+    canUndo: boolean;
+    canRedo: boolean;
+    isHistoryPending: boolean;
+    isHistoryStale: boolean;
+    historyFailure: string | null;
+}>;
+type SiteChromeQuickControlApplyOutcome = Readonly<{
+    kind: 'saved';
+}> | Readonly<{
+    kind: 'skipped';
+    reason: SiteChromeQuickControlHistorySkipReason | 'superseded';
+}> | SiteChromeQuickControlHistoryFailure;
 type SiteChromeCustomizeSurfaceState = Readonly<{
     kind: 'unavailable';
 }> | Readonly<{
@@ -19,8 +56,11 @@ type SiteChromeCustomizeSurfaceState = Readonly<{
     currentId: HeaderStyleId;
     currentLabel: string;
     options: readonly SiteChromeLookOption<HeaderStyleId>[];
+    brandDisplay: BrandDisplayMode;
+    brandDisplayOptions: readonly HeaderBrandDisplayOption[];
+    logoSize: LogoSizePolicy;
+    logoSizeOptions: readonly HeaderLogoSizeOption[];
     diagnostics: readonly string[];
-    saving: boolean;
     failure: string | null;
     applyAllowed: boolean;
 }> | Readonly<{
@@ -31,7 +71,6 @@ type SiteChromeCustomizeSurfaceState = Readonly<{
     currentLabel: string;
     options: readonly SiteChromeLookOption<FooterLookId | null>[];
     diagnostics: readonly string[];
-    saving: boolean;
     failure: string | null;
     applyAllowed: boolean;
 }>;
@@ -39,6 +78,10 @@ type SiteChromeCustomizeContextValue = Readonly<{
     getSurfaceState: (surface: SiteChromeEditableSurfaceKind) => SiteChromeCustomizeSurfaceState;
     cycleSurfaceLook: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
     cycleSurfaceLayout: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
+    setHeaderBrandDisplay: (value: BrandDisplayMode) => void;
+    setHeaderLogoSize: (value: LogoSizePolicy) => void;
+    siteStyleHistory: SiteStyleHistoryController;
+    quickControlHistory: SiteChromeQuickControlHistoryController;
 }>;
 export type SiteChromeCustomizeProviderProps = Readonly<{
     children: ReactNode;

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

@@ -14,6 +14,7 @@ import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/ind
 import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
 import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderStyleId, type TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionFallbackWarning, SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
+import { type EditorStagedSessionCapabilities, type EditorStagedSessionState } from '../../../../content-editor/src/editorTransactionState';
 export type StyleConfiguratorSaveStatus = Readonly<{
     kind: 'idle';
 }> | Readonly<{
@@ -52,6 +53,14 @@ export type SelectionSnapshot = Readonly<{
     typographyHeadingFontOverride: string | null;
 }>;
 type PaletteOverrideDrafts = Readonly<Partial<Record<PaletteVariantId, PaletteOverrides>>>;
+type StyleConfiguratorTargetKey = 'design:site-style';
+export type StyleConfiguratorHistoryEntry = Readonly<{
+    kind: 'site-style-design';
+    label: string;
+    previous: SelectionSnapshot;
+    next: SelectionSnapshot;
+}>;
+export type StyleConfiguratorStagedSession = EditorStagedSessionState<SelectionSnapshot, StyleConfiguratorHistoryEntry, StyleConfiguratorTargetKey>;
 export type StyleConfiguratorState = Readonly<{
     /**
      * Last persisted server snapshot. Updated on apply-success (and on
@@ -68,6 +77,7 @@ export type StyleConfiguratorState = Readonly<{
     notices: ReadonlyArray<StyleConfiguratorNotice>;
     paletteOverrideDrafts: PaletteOverrideDrafts;
     expandedRow: StyleConfiguratorExpandedRow;
+    stagedSession: StyleConfiguratorStagedSession;
 }>;
 export declare function createStyleConfiguratorState(base: SelectionSnapshot): StyleConfiguratorState;
 export declare function openRow(state: StyleConfiguratorState, row: Exclude<StyleConfiguratorExpandedRow, null>): StyleConfiguratorState;
@@ -77,6 +87,8 @@ export declare function openRow(state: StyleConfiguratorState, row: Exclude<Styl
  * `setOverrideTheme` call.
  */
 export declare function isPreviewingChange(state: StyleConfiguratorState): boolean;
+export declare function deriveStyleConfiguratorCapabilities(state: StyleConfiguratorState): EditorStagedSessionCapabilities;
+export declare function styleConfiguratorHistoryEntryForPersistedSelection(state: StyleConfiguratorState, persisted: SelectionSnapshot): StyleConfiguratorHistoryEntry | null;
 export declare function previewSiteStyle(state: StyleConfiguratorState, siteStyleId: SiteStyleId): StyleConfiguratorState;
 export declare function previewButtonPersonality(state: StyleConfiguratorState, buttonPersonalityId: ButtonPersonalityId): StyleConfiguratorState;
 export declare function previewHeaderLayout(state: StyleConfiguratorState, headerLayoutId: HeaderLayoutId): StyleConfiguratorState;
@@ -106,7 +118,7 @@ export declare function applyResolvedSelections(state: StyleConfiguratorState, i
 export declare function cancelPreview(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function markApplySaving(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function markApplySaved(state: StyleConfiguratorState, persisted: SelectionSnapshot): StyleConfiguratorState;
-export declare function markApplyFailed(state: StyleConfiguratorState, message: string): StyleConfiguratorState;
+export declare function markApplyFailed(state: StyleConfiguratorState, message: string, failureKind?: 'retryable' | 'stale'): StyleConfiguratorState;
 export declare function toggleRow(state: StyleConfiguratorState, row: StyleConfiguratorExpandedRow): StyleConfiguratorState;
 export declare function dismissWarnings(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function dismissNotices(state: StyleConfiguratorState): StyleConfiguratorState;
@@ -116,5 +128,6 @@ export declare function dismissNotices(state: StyleConfiguratorState): StyleConf
  * changes the persisted selection out-of-band.
  */
 export declare function syncStyleConfiguratorState(state: StyleConfiguratorState, base: SelectionSnapshot): StyleConfiguratorState;
+export declare function selectionSnapshotsEqual(a: SelectionSnapshot, b: SelectionSnapshot): boolean;
 export declare function paletteOverridesEqual(a: PaletteOverrides | null, b: PaletteOverrides | null): boolean;
 export {};

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

@@ -0,0 +1,5 @@
+import type { LinkedContentEditTarget } from '../../../../blocks/src/system/data/index';
+export declare const LINKED_ENTRY_EDIT_EVENT: "riverbank:preview:linked-entry-edit";
+export type LinkedEntryEditEvent = CustomEvent<LinkedContentEditTarget>;
+export declare function dispatchLinkedEntryEditEvent(target: LinkedContentEditTarget): void;
+export declare function isLinkedEntryEditEvent(event: Event): event is LinkedEntryEditEvent;

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

@@ -0,0 +1,46 @@
+import type { BlockItem } from '../../../../editor-blocks/src/index';
+export declare const PREVIEW_CHROME_EDGE_OFFSET_PX = 8;
+export declare const DEFAULT_PREVIEW_CHROME_FLOATING_PLACEMENT: PreviewChromeFloatingPlacement;
+export type HeaderClearance = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'overlay';
+    px: number;
+}>;
+export type PreviewChromeAnchorBox = Readonly<{
+    top: number;
+    right: number;
+    bottom: number;
+    height: number;
+}>;
+export type PreviewChromeFloatingPlacement = Readonly<{
+    kind: 'anchor-top-right';
+    topPx: number;
+    rightPx: number;
+}> | Readonly<{
+    kind: 'viewport-top-right';
+    topPx: number;
+    rightPx: number;
+}>;
+export type PreviewChromeFloatingPosition = Readonly<{
+    topPx: number;
+    rightPx: number;
+}>;
+export declare function headerClearanceFromPx(px: number): HeaderClearance;
+export declare function findFirstEditableContentBlockIndex(blocks: readonly Pick<BlockItem, 'kind'>[]): number | null;
+export declare function blockReceivesHeaderClearance(blocks: readonly Pick<BlockItem, 'kind'>[], blockIndex: number): boolean;
+export declare function planBlockToolbarPlacement(input: Readonly<{
+    blocks: readonly Pick<BlockItem, 'kind'>[];
+    blockIndex: number;
+    headerClearance: HeaderClearance;
+}>): PreviewChromeFloatingPlacement;
+export declare function planSiteChromeCustomizePlacement(input: Readonly<{
+    surface: 'header' | 'footer';
+    anchorBox: PreviewChromeAnchorBox | null;
+}>): PreviewChromeFloatingPlacement;
+export declare function resolvePreviewChromeFloatingPosition(input: Readonly<{
+    anchorBox: PreviewChromeAnchorBox | null;
+    containerTopEdgePx?: number;
+    containerRightEdgePx: number;
+    placement: PreviewChromeFloatingPlacement;
+}>): PreviewChromeFloatingPosition;

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

@@ -0,0 +1,68 @@
+import { type KeyboardEvent, type MouseEvent, type ReactNode, type Ref } from 'react';
+export type CustomizeControlUnavailableReason = 'single-option' | 'preview-only';
+export type CustomizeControlAvailability = Readonly<{
+    kind: 'available';
+}> | Readonly<{
+    kind: 'unavailable';
+    reason: CustomizeControlUnavailableReason;
+}>;
+export type CustomizeCycleAvailabilityInput = Readonly<{
+    kind: 'available';
+}> | Readonly<{
+    kind: CustomizeControlUnavailableReason;
+}>;
+export type CustomizePopoverController = Readonly<{
+    open: boolean;
+    close: () => void;
+    toggle: (event: MouseEvent<HTMLElement>) => void;
+    buttonRef: Ref<HTMLButtonElement>;
+    panelId: string;
+    descriptionId: string;
+    dialogRef: Ref<HTMLDivElement>;
+    registerInitialFocus: Ref<HTMLButtonElement>;
+    handleDialogKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
+}>;
+export declare function useCustomizePopoverController(): CustomizePopoverController;
+export type CustomizePillButtonProps = Readonly<{
+    buttonRef: Ref<HTMLButtonElement>;
+    ariaLabel: string;
+    open: boolean;
+    controlsId: string;
+    onClick: (event: MouseEvent<HTMLButtonElement>) => void;
+    disabled?: boolean;
+}>;
+export declare function CustomizePillButton({ buttonRef, ariaLabel, open, controlsId, onClick, disabled, }: CustomizePillButtonProps): import("react/jsx-runtime").JSX.Element;
+export type CustomizePopoverShellProps = Readonly<{
+    panelId: string;
+    descriptionId: string;
+    dialogLabel: string;
+    eyebrow: string;
+    title: string;
+    dialogRef: Ref<HTMLDivElement>;
+    closeButtonRef: Ref<HTMLButtonElement>;
+    onClose: () => void;
+    onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
+    spacing?: 'normal' | 'compact';
+    children: ReactNode;
+}>;
+export declare function CustomizePopoverShell({ panelId, descriptionId, dialogLabel, eyebrow, title, dialogRef, closeButtonRef, onClose, onKeyDown, spacing, children, }: CustomizePopoverShellProps): import("react/jsx-runtime").JSX.Element;
+export type CustomizeCycleRowProps = Readonly<{
+    label: string;
+    valueLabel: string;
+    previousLabel: string;
+    nextLabel: string;
+    availability: CustomizeControlAvailability;
+    onPrevious: () => void;
+    onNext: () => void;
+}>;
+export type CustomizeCycleControlPlan = CustomizeCycleRowProps;
+export type CustomizePopoverControlPlan = Readonly<{
+    cycleRows: readonly CustomizeCycleControlPlan[];
+}>;
+export declare function CustomizeCycleRow({ label, valueLabel, previousLabel, nextLabel, availability, onPrevious, onNext, }: CustomizeCycleRowProps): import("react/jsx-runtime").JSX.Element;
+export declare function cycleAvailability(input: CustomizeCycleAvailabilityInput): CustomizeControlAvailability;
+export declare function cycleUnavailableReasonLabel(reason: CustomizeControlUnavailableReason): string;
+export declare function cycleAvailabilityFromFlags(input: Readonly<{
+    canCycle: boolean;
+    applyAllowed: boolean;
+}>): CustomizeControlAvailability;

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

@@ -4,7 +4,7 @@ import type { PreviewCustomizeAction } from '../blocks/previewCustomizeActions';
 import type { SystemCustomizeFacetHistorySelection } from '../../../../blocks/src/system/customize/facets';
 import { type BackgroundOverride } from '../../../../blocks/src/system/customize/backgrounds';
 type PreviewLoadedEditorModel = PageDesignEditorReadModel;
-export type PreviewCustomizeHistoryEntry = Readonly<{
+export type PreviewCustomizeAtomicHistoryEntry = Readonly<{
     kind: 'layout';
     blockId: PreviewCustomizeActionBlockId;
     fromLayoutVariantKey: LayoutVariantKey;
@@ -30,6 +30,10 @@ export type PreviewCustomizeHistoryEntry = Readonly<{
     fromBoundaryOptionId: BoundaryOptionId | null;
     toBoundaryOptionId: BoundaryOptionId | null;
 }>;
+export type PreviewCustomizeHistoryEntry = PreviewCustomizeAtomicHistoryEntry | Readonly<{
+    kind: 'batch';
+    entries: readonly PreviewCustomizeAtomicHistoryEntry[];
+}>;
 type PreviewCustomizeActionBlockId = DesignBlockId;
 export type PreviewCustomizeHistoryPresent = Readonly<{
     editorModel: PreviewLoadedEditorModel;
@@ -40,12 +44,15 @@ export declare function createPreviewCustomizeHistoryState(editorModel: PreviewL
 export declare function canUndoPreviewCustomizeHistory(state: PreviewCustomizeHistoryState): boolean;
 export declare function canRedoPreviewCustomizeHistory(state: PreviewCustomizeHistoryState): boolean;
 export declare function pushPreviewCustomizeHistoryEntry(state: PreviewCustomizeHistoryState, entry: PreviewCustomizeHistoryEntry, editorModel: PreviewLoadedEditorModel): PreviewCustomizeHistoryState;
+export declare function previewCustomizeBatchHistoryEntry(entries: readonly (PreviewCustomizeHistoryEntry | null)[]): PreviewCustomizeHistoryEntry | null;
 export declare function replacePreviewCustomizeHistoryModel(state: PreviewCustomizeHistoryState, editorModel: PreviewLoadedEditorModel): PreviewCustomizeHistoryState;
 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, editorModel: PreviewLoadedEditorModel): PreviewCustomizeAction;
 export declare function previewCustomizeRedoActionForEntry(entry: PreviewCustomizeHistoryEntry, editorModel: PreviewLoadedEditorModel): PreviewCustomizeAction;
+export declare function previewCustomizeUndoActionsForEntry(entry: PreviewCustomizeHistoryEntry, editorModel: PreviewLoadedEditorModel): readonly PreviewCustomizeAction[];
+export declare function previewCustomizeRedoActionsForEntry(entry: PreviewCustomizeHistoryEntry, editorModel: PreviewLoadedEditorModel): readonly PreviewCustomizeAction[];
 export declare function previewCustomizeHistoryPresentEquals(left: PreviewCustomizeHistoryPresent, right: PreviewCustomizeHistoryPresent): boolean;
 export declare function contentRevisionIdForBlock(editorModel: PreviewLoadedEditorModel, blockId: PreviewCustomizeActionBlockId): string | null;
 export {};