@riverbankcms/sdk 0.60.0 → 0.60.3

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

@@ -8311,6 +8311,7 @@ export type Database = {
                     reply_to_email: string | null;
                     sender_address_line_1: string | null;
                     sender_address_line_2: string | null;
+                    sender_address_source: string;
                     sender_city: string | null;
                     sender_country: string | null;
                     sender_display_name: string | null;
@@ -8332,6 +8333,7 @@ export type Database = {
                     reply_to_email?: string | null;
                     sender_address_line_1?: string | null;
                     sender_address_line_2?: string | null;
+                    sender_address_source?: string;
                     sender_city?: string | null;
                     sender_country?: string | null;
                     sender_display_name?: string | null;
@@ -8353,6 +8355,7 @@ export type Database = {
                     reply_to_email?: string | null;
                     sender_address_line_1?: string | null;
                     sender_address_line_2?: string | null;
+                    sender_address_source?: string;
                     sender_city?: string | null;
                     sender_country?: string | null;
                     sender_display_name?: string | null;
@@ -11716,6 +11719,7 @@ export type Database = {
                     banner_settings: Json;
                     billing_settings: Json | null;
                     booking_settings: Json;
+                    business_address: Json | null;
                     created_at: string;
                     favicon_asset_id: string | null;
                     footer_content_json: Json;
@@ -11742,6 +11746,7 @@ export type Database = {
                     banner_settings?: Json;
                     billing_settings?: Json | null;
                     booking_settings?: Json;
+                    business_address?: Json | null;
                     created_at?: string;
                     favicon_asset_id?: string | null;
                     footer_content_json?: Json;
@@ -11768,6 +11773,7 @@ export type Database = {
                     banner_settings?: Json;
                     billing_settings?: Json | null;
                     booking_settings?: Json;
+                    business_address?: Json | null;
                     created_at?: string;
                     favicon_asset_id?: string | null;
                     footer_content_json?: Json;
@@ -12010,30 +12016,39 @@ export type Database = {
             };
             site_theme_selections: {
                 Row: {
+                    button_personality_id: string | null;
                     created_at: string;
                     id: string;
                     is_current: boolean;
                     overrides: Json;
+                    palette_overrides: Json | null;
+                    palette_variant_id: string | null;
                     site_id: string;
                     theme_id: string;
                     updated_at: string;
                     user_id: string;
                 };
                 Insert: {
+                    button_personality_id?: string | null;
                     created_at?: string;
                     id?: string;
                     is_current?: boolean;
                     overrides?: Json;
+                    palette_overrides?: Json | null;
+                    palette_variant_id?: string | null;
                     site_id: string;
                     theme_id: string;
                     updated_at?: string;
                     user_id: string;
                 };
                 Update: {
+                    button_personality_id?: string | null;
                     created_at?: string;
                     id?: string;
                     is_current?: boolean;
                     overrides?: Json;
+                    palette_overrides?: Json | null;
+                    palette_variant_id?: string | null;
                     site_id?: string;
                     theme_id?: string;
                     updated_at?: string;
@@ -13914,6 +13929,13 @@ export type Database = {
                     waitlist_position: number;
                 }[];
             };
+            create_media_asset_with_storage_quota: {
+                Args: {
+                    p_asset: Json;
+                    p_max_bytes: number;
+                };
+                Returns: string;
+            };
             create_order_shipment_atomic: {
                 Args: {
                     p_carrier_name?: string;

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

@@ -5,6 +5,7 @@ import { type Theme } from '@riverbankcms/blocks';
 import type { PageDesignEditorReadModel } from '@riverbankcms/theme-core/site-styles';
 import { type EditorStructuralCommand } from '@riverbankcms/core';
 import { type SdkConfigForBlockPicker } from './block-editor/sdkBlockMerger';
+import { type ReorderControlMode } from './block-editor/reorderControlMode';
 import type { ArrayKeysManager, BlockEditorHandle, BlockItem, BlockFocusRequest, UiSlice, DraftsSlice } from './block-editor/types';
 import type { BlockDraftSaveability, FieldWidgetComponent } from '@riverbankcms/block-form/client';
 type UiState = {
@@ -13,6 +14,7 @@ type UiState = {
     requestFocus: UiSlice['requestFocus'];
     clearFocus: () => void;
     setActiveBlockId: UiSlice['setActiveBlockId'];
+    setActivePreviewField: UiSlice['setActivePreviewField'];
     arrayKeys: ArrayKeysManager;
     blockValidation: {
         markPathEdited: (blockId: Parameters<DraftsSlice['setAtPath']>[0], path: string) => void;
@@ -49,6 +51,7 @@ export type BlockEditorProps = {
     pageDesignEditorModel?: PageDesignEditorReadModel | null;
     enabledContentTypes?: string[];
     sdkConfig?: SdkConfigForBlockPicker | null;
+    reorderControlMode?: ReorderControlMode;
 };
 export declare const BlockEditor: import("react").ForwardRefExoticComponent<BlockEditorProps & import("react").RefAttributes<BlockEditorHandle>>;
 export {};

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

@@ -5,6 +5,10 @@ import { type PageDesignEditorBlock } from '@riverbankcms/theme-core/site-styles
 import { type EditorBlockId } from '@riverbankcms/core';
 import type { ArrayKeysManager, DraftsSlice, UiStore as BlockEditorUiStore } from './block-editor/types';
 type UiStoreState = {
+    setActivePreviewField: (field: {
+        blockId: EditorBlockId;
+        fieldPath: string;
+    } | null) => void;
     blockValidation: {
         markPathEdited: (blockId: EditorBlockId, path: string) => void;
         isPathEdited: (blockId: EditorBlockId, path: string) => boolean;

package/dist/_dts/editor-blocks/src/block-editor/BlockCard.d.ts

@@ -1,13 +1,15 @@
+import type { SyntheticListenerMap } from '@dnd-kit/core/dist/hooks/utilities';
 import { type EditorBlockId } from '@riverbankcms/core';
 import type { PageDesignEditorBlock } from '@riverbankcms/theme-core/site-styles';
 import type { SystemBlockDefinition } from '@riverbankcms/blocks';
-import type { Theme } from '@riverbankcms/blocks';
 import type { BlockDraftSaveability } from '@riverbankcms/block-form/client';
+import type { FieldWidgetComponent } from '@riverbankcms/block-form/client';
+import type { Theme } from '@riverbankcms/blocks';
+import { type ReorderControlMode } from './reorderControlMode';
 import type { ArrayKeysManager, BlockFocusRequest, BlockItem, UiStore, DraftsSlice, UiSlice } from './types';
 /** Drag listener props from dnd-kit */
-type DragListeners = Record<string, Function> | undefined;
-import type { FieldWidgetComponent } from '@riverbankcms/block-form/client';
-type BlockCardStore = UiStore<Pick<UiSlice, 'activeBlockId' | 'setActiveBlockId'> & {
+type DragListeners = SyntheticListenerMap | undefined;
+type BlockCardStore = UiStore<Pick<UiSlice, 'activeBlockId' | 'setActiveBlockId' | 'setActivePreviewField'> & {
     blockValidation: {
         markPathEdited: (blockId: EditorBlockId, path: string) => void;
         isPathEdited: (blockId: EditorBlockId, path: string) => boolean;
@@ -17,7 +19,7 @@ type BlockCardStore = UiStore<Pick<UiSlice, 'activeBlockId' | 'setActiveBlockId'
     drafts: Pick<DraftsSlice, 'getBlockSnapshot' | 'getCurrentValues' | 'getAtPath' | 'setAtPath' | 'edit' | 'initNewBlock' | 'updateBlockBaseline' | 'clearError'>;
     arrayKeys: ArrayKeysManager;
 }>;
-export declare function BlockCard({ siteId, block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onCollapsedChange, highlighted, hasRecoveryConflict, focusSignal, onFocusHandled, onBlockSave, theme, widgetOverrides, uiStore, hideThemeV2RawStyleFields, pageDesignBlock, }: {
+export declare function BlockCard({ siteId, block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onCollapsedChange, highlighted, hasRecoveryConflict, focusSignal, onFocusHandled, onBlockSave, theme, widgetOverrides, uiStore, hideThemeV2RawStyleFields, pageDesignBlock, reorderControlMode, }: {
     siteId: string;
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
@@ -41,5 +43,6 @@ export declare function BlockCard({ siteId, block, manifest, isFirst, isLast, is
     uiStore: BlockCardStore;
     hideThemeV2RawStyleFields?: boolean;
     pageDesignBlock?: PageDesignEditorBlock | null;
+    reorderControlMode?: ReorderControlMode;
 }): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/_dts/editor-blocks/src/block-editor/BlockCardHeader.d.ts

@@ -1,14 +1,15 @@
-import type { Theme } from '@riverbankcms/blocks';
-/** Drag listener props from dnd-kit */
-type DragListeners = Record<string, Function> | undefined;
-import type { SystemBlockDefinition } from '@riverbankcms/blocks';
+import type { SyntheticListenerMap } from '@dnd-kit/core/dist/hooks/utilities';
 import type { FieldWidgetComponent } from '@riverbankcms/block-form/client';
+import { type SystemBlockDefinition, type Theme } from '@riverbankcms/blocks';
+import type { ReorderControlMode } from './reorderControlMode';
 import type { BlockItem, UiStore, DraftsSlice, ArrayKeysManager } from './types';
+/** Drag listener props from dnd-kit */
+type DragListeners = SyntheticListenerMap | undefined;
 type BlockCardHeaderStore = UiStore<{
     drafts: Pick<DraftsSlice, 'getBlockSnapshot' | 'getCurrentValues' | 'initNewBlock' | 'updateBlockBaseline' | 'clearError' | 'setAtPath' | 'getAtPath'>;
     arrayKeys: ArrayKeysManager;
 }>;
-export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, }: {
+export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, reorderControlMode, }: {
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
     isFirst: boolean;
@@ -27,5 +28,6 @@ export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMo
     widgetOverrides?: Record<string, FieldWidgetComponent>;
     theme?: Theme | null;
     hideThemeV2RawStyleFields?: boolean;
+    reorderControlMode?: ReorderControlMode;
 }): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/_dts/editor-blocks/src/block-editor/SortableBlockItem.d.ts

@@ -5,6 +5,7 @@ import type { BlockFocusRequest, BlockItem } from './types';
 import { type SdkConfigForBlockPicker } from './sdkBlockMerger';
 import { BlockCard } from './BlockCard';
 import type { FieldWidgetComponent } from '@riverbankcms/block-form/client';
+import { type ReorderControlMode } from './reorderControlMode';
 export declare const SortableBlockItem: import("react").NamedExoticComponent<{
     siteId: string;
     block: BlockItem;
@@ -28,4 +29,5 @@ export declare const SortableBlockItem: import("react").NamedExoticComponent<{
     sdkConfig?: SdkConfigForBlockPicker | null;
     hideThemeV2RawStyleFields?: boolean;
     pageDesignBlock?: PageDesignEditorBlock | null;
+    reorderControlMode?: ReorderControlMode;
 }>;

package/dist/_dts/editor-blocks/src/block-editor/reorderControlMode.d.ts

@@ -0,0 +1,3 @@
+export type ReorderControlMode = 'full' | 'drag-handle-only';
+export declare const DEFAULT_REORDER_CONTROL_MODE: ReorderControlMode;
+export declare function shouldShowMoveButtons(mode: ReorderControlMode): boolean;

package/dist/_dts/editor-blocks/src/block-editor/types.d.ts

@@ -43,6 +43,10 @@ export type UiSlice = {
         itemIndex?: number | null;
     }) => void;
     clearFocus: () => void;
+    setActivePreviewField: (field: {
+        blockId: EditorBlockId;
+        fieldPath: string;
+    } | null) => void;
 };
 export type ArrayKeysManager = {
     get: (scope: string, path: string) => string[] | undefined;

package/dist/_dts/media-react/src/hooks/useApiMediaUploader.d.ts

@@ -1,3 +1,4 @@
+import type { ApiErrorCode, FieldError } from '@riverbankcms/api/common';
 import { type ApiClient } from '@riverbankcms/api/request';
 import type { UploadIntentContract } from '@riverbankcms/api';
 import type { VideoPrepIntent } from '@riverbankcms/media-core';
@@ -6,6 +7,19 @@ import type { UploadProgressHandler } from './useUploads';
 import { type ClassificationHook, type LoggerLike } from './internal/classification';
 export type UploadIntentResolver = UploadIntentContract | ((file: File) => UploadIntentContract | undefined);
 export type VideoPrepIntentResolver = VideoPrepIntent | ((file: File) => VideoPrepIntent | undefined);
+export declare class MediaUploaderError extends Error {
+    readonly code?: ApiErrorCode;
+    readonly status?: number;
+    readonly fieldErrors?: readonly FieldError[];
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        readonly code?: ApiErrorCode;
+        readonly status?: number;
+        readonly fieldErrors?: readonly FieldError[];
+        readonly cause?: unknown;
+    });
+}
+export declare function getMediaUploaderErrorCode(error: Error | undefined): ApiErrorCode | undefined;
 export type UseApiMediaUploaderOptions = {
     siteId: string;
     apiClient: ApiClient;

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

@@ -6,7 +6,7 @@ export { useUploads } from './hooks/useUploads';
 export type { UseUploadsOptions, UseUploadsResult, UploadItem, UploadStatus, UploadProgressStage, UploadProgressHandler } from './hooks/useUploads';
 export { useSupabaseMediaUploader } from './hooks/useSupabaseMediaUploader';
 export type { UseSupabaseMediaUploaderOptions } from './hooks/useSupabaseMediaUploader';
-export { useApiMediaUploader } from './hooks/useApiMediaUploader';
+export { getMediaUploaderErrorCode, MediaUploaderError, useApiMediaUploader, } from './hooks/useApiMediaUploader';
 export type { UploadIntentResolver, UseApiMediaUploaderOptions, VideoPrepIntentResolver } from './hooks/useApiMediaUploader';
 export { useAuthenticatedImageSrc } from './hooks/useAuthenticatedImageSrc';
 export { extractVideoPosterFrame } from './videoFrameExtraction';

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

@@ -1,21 +1,44 @@
-import type { PreviewPageDesignEditorApplyOutcome } from '../preview/PageDesignEditorStateContext';
-import type { PreviewCustomizeAction } from './previewCustomizeActions';
-type CustomizeSaveSequenceRef = {
-    current: number;
-};
-type SavedCustomizeOutcome = Extract<PreviewPageDesignEditorApplyOutcome, {
-    kind: 'saved';
+/**
+ * Sequence-numbered runner for optimistic save flows where the user can fire
+ * the next action before the previous save resolves. Each invocation gets a
+ * fresh sequence number from a shared `nextSequence` callback; the runner
+ * only commits success / failure when its sequence is still the latest.
+ *
+ * Used by the Style configurator: tapping personality A then quickly tapping
+ * personality B should land B's save even if A's network round-trip is
+ * slower, and A's late-arriving response must not clobber B's local state.
+ */
+export type OptimisticActionRun<TSuccess> = Readonly<{
+    /**
+     * Pure result computed locally before the network call fires (the
+     * optimistic "this is what the world will look like" snapshot). Skipped
+     * if the runner has already been superseded.
+     */
+    optimistic?: () => void;
+    /** The network call. Resolves with the persisted payload. */
+    network: () => Promise<TSuccess>;
+    /**
+     * Invoked when `network` resolves AND this run is still the latest.
+     * Stale runs swallow the success silently — the next run will reconcile.
+     */
+    onSuccess: (success: TSuccess) => void;
+    /**
+     * Invoked when `network` rejects AND this run is still the latest. Stale
+     * failures are ignored on the same principle.
+     */
+    onError: (error: unknown) => void;
 }>;
-export declare function runOptimisticCustomizeAction<TAction extends PreviewCustomizeAction, TSnapshot = undefined>(input: Readonly<{
-    action: TAction;
-    snapshot: TSnapshot;
-    sequenceRef: CustomizeSaveSequenceRef;
-    applyAction: (action: PreviewCustomizeAction) => Promise<PreviewPageDesignEditorApplyOutcome>;
-    failureMessage: string;
-    applyOptimistic?: (snapshot: TSnapshot) => void;
-    onStart?: () => void;
-    onSaved?: (outcome: SavedCustomizeOutcome) => void;
-    rollback?: (snapshot: TSnapshot) => void;
-    onFailed: (message: string) => void;
-}>): void;
-export {};
+export type OptimisticActionRunner = Readonly<{
+    /** Schedule a new run; returns its sequence number for debugging / tests. */
+    run: <TSuccess>(action: OptimisticActionRun<TSuccess>) => Promise<number>;
+    /** Force the runner into a known sequence — useful for unmount sentinels. */
+    invalidate: () => void;
+    /** Read the latest sequence. Test/debug only; UI should not branch on it. */
+    current: () => number;
+}>;
+/**
+ * Create a runner. The runner is stateful (holds the latest sequence)
+ * but the inputs to each `run` call are pure data — so individual actions
+ * remain easy to unit-test by stubbing `network`.
+ */
+export declare function createOptimisticActionRunner(): OptimisticActionRunner;

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

@@ -2,6 +2,8 @@ export type { PreviewAuthFailureSource, PreviewAuthFetch, PreviewAuthState, } fr
 export { initPreviewAuth, markPreviewAuthExpired, usePreviewAuth, usePreviewAuthFetch, usePreviewToken, } from "./previewAuthStore";
 export type { OnboardingPreviewRedirectAuthPlan, PreviewAuthMode, PreviewExchangeTokenKind, PreviewRuntimeSession, PreviewSessionAuthMode, PreviewSessionTokens, } from "../auth-contract";
 export { getPreviewRuntimeSessionAuthMode, isPreviewRuntimeSessionEditable, resolveOnboardingPreviewRedirectAuthPlan, resolvePreviewAuthMode, resolvePreviewExchangeTokenKind, resolvePreviewRuntimeSession, resolvePreviewSessionCanEdit, } from "../auth-contract";
+export type { OnboardingPreviewEndpointUrlInput, OnboardingPreviewStage, PreviewAuthEntryUrlInput, PreviewAuthExchangeUrlInput, PreviewBrowserEntryRouteKey, PreviewDashboardApiEndpointKey, } from "../route-contract";
+export { buildOnboardingPreviewStatusUrl, buildOnboardingResendConfirmationUrl, buildPreviewAuthEntryUrl, buildPreviewAuthExchangeUrl, previewAuthEntryPathname, previewBrowserEntries, previewDashboardApiEndpoints, } from "../route-contract";
 export { PreviewShellSmoke } from "./PreviewShellSmoke";
 export { PreviewLayoutProvider, usePreviewLayout, } from "./layout/PreviewLayoutContext";
 export { useOptionalPreviewLayout } from "./layout/PreviewLayoutContext";

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

@@ -1,37 +1,22 @@
 import { type ReactNode } from 'react';
-import type { APIEndpoints } from '@riverbankcms/api';
 import { type ApiClient } from '@riverbankcms/api/request';
 import type { PreviewCustomizeAction } from '../blocks/previewCustomizeActions';
-type ApiPageDesignEditorStateResponse = NonNullable<APIEndpoints['getPageDesignEditorState']['response']>;
-type ApplyPageDesignEditorActionResponse = NonNullable<APIEndpoints['applyPageDesignEditorAction']['response']>;
-export type PreviewPageDesignEditorApplyOutcome = Readonly<{
-    kind: 'saved';
-    response: ApplyPageDesignEditorActionResponse;
-}> | Readonly<{
-    kind: 'skipped';
-}> | Readonly<{
-    kind: 'stale';
-    message: string;
-}> | Readonly<{
-    kind: 'invalid';
-    message: string;
-}> | Readonly<{
-    kind: 'failed';
-    message: string;
-}>;
-export type PreviewPageDesignEditorState = Readonly<{
-    kind: 'unsupported';
-}> | Readonly<{
-    kind: 'loading';
-}> | Readonly<{
-    kind: 'failed';
-    message: string;
-}> | ApiPageDesignEditorStateResponse;
+import { type PreviewPageDesignEditorApplyOutcome, type PreviewPageDesignEditorState } from './previewCustomizeWorkflowState';
+export type { PreviewPageDesignEditorApplyOutcome, PreviewPageDesignEditorState, } from './previewCustomizeWorkflowState';
 type PageDesignEditorStateContextValue = Readonly<{
     state: PreviewPageDesignEditorState;
     reload: () => void;
     applyAction: (action: PreviewCustomizeAction) => Promise<PreviewPageDesignEditorApplyOutcome>;
+    undo: () => Promise<PreviewPageDesignEditorApplyOutcome>;
+    redo: () => Promise<PreviewPageDesignEditorApplyOutcome>;
+    canUndo: boolean;
+    canRedo: boolean;
+    isHistoryPending: boolean;
+    isHistoryStale: boolean;
+    historyFailure: string | null;
 }>;
+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<{
     apiClient: ApiClient;
     siteId: string;
@@ -40,5 +25,3 @@ export declare function PreviewPageDesignEditorStateProvider({ apiClient, siteId
     children: ReactNode;
 }>): import("react/jsx-runtime").JSX.Element;
 export declare function usePreviewPageDesignEditorState(): PageDesignEditorStateContextValue;
-export declare function applyPreviewCustomizeActionToState(state: PreviewPageDesignEditorState, action: PreviewCustomizeAction): PreviewPageDesignEditorState;
-export {};

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

@@ -5,6 +5,8 @@ import type { SurfaceId } from "@riverbankcms/surfaces";
 import type { MediaAssetIndexItem, OccurrenceContextData, Theme } from "@riverbankcms/blocks";
 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 { ViewportMode, ViewportWidth } from "./PreviewViewportControls";
 import { type SiteStyleAccess } from "./siteStyleAccess";
 export type PreviewEditorSidebarTab = "editor" | "assistant";
@@ -29,6 +31,10 @@ export type PreviewEditorSidebarProps = {
     theme?: Theme | null;
     themeId?: string | null;
     themeSelectionId?: string | null;
+    /** Persisted Style configurator selections (Phase C / E). */
+    themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
+    themeSelectionPaletteVariantId?: PaletteVariantId | null;
+    themeSelectionPaletteOverrides?: PaletteOverrides | null;
     apiClient: ApiClient;
     bearerToken?: string | null;
     supabaseUrl?: string;
@@ -47,4 +53,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, apiClient, bearerToken, supabaseUrl, occurrenceContext, 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, apiClient, bearerToken, supabaseUrl, occurrenceContext, 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/PreviewEditorUI.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import type { ApiClient } from '@riverbankcms/api/request';
-import type { SurfaceId } from '@riverbankcms/surfaces';
+import { type SurfaceId } from '@riverbankcms/surfaces';
 type PreviewEditorUIProps = {
     inMaintenanceMode?: boolean;
     siteId?: string;

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

@@ -1,5 +1,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 { MediaAssetIndexItem, OccurrenceContextData, Theme } from "@riverbankcms/blocks";
 import type { ContentTypeSchema } from "@riverbankcms/content-model";
 import type { SdkConfigForBlockPicker } from "@riverbankcms/editor-blocks";
@@ -31,6 +33,15 @@ export type PreviewShellProps = {
     theme: Theme;
     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.
+     */
+    themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
+    themeSelectionPaletteVariantId?: PaletteVariantId | null;
+    themeSelectionPaletteOverrides?: PaletteOverrides | null;
     pageId: string | null;
     routeId: string | null;
     entryData?: PreviewContentEntryData | null;
@@ -52,7 +63,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, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, occurrenceContext, 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, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, occurrenceContext, 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

@@ -1,5 +1,7 @@
 import { type ReactNode } from "react";
 import { type MediaAssetIndexItem, type OccurrenceContextData, type Theme } from "@riverbankcms/blocks";
+import type { ButtonPersonalityId } from "@riverbankcms/theme-core/buttons";
+import type { PaletteOverrides, PaletteVariantId } from "@riverbankcms/theme-core/palette";
 import type { ContentTypeSchema } from "@riverbankcms/content-model";
 import type { ApiClient } from "@riverbankcms/api/request";
 import type { SdkConfigForBlockPicker } from "@riverbankcms/editor-blocks";
@@ -22,6 +24,9 @@ export type PreviewShellLayoutProps = {
     bearerToken?: string | null;
     themeId?: string | null;
     themeSelectionId?: string | null;
+    themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
+    themeSelectionPaletteVariantId?: PaletteVariantId | null;
+    themeSelectionPaletteOverrides?: PaletteOverrides | null;
     supabaseUrl?: string;
     isSiteLaunched: boolean;
     maintenanceModeEnabled: boolean;
@@ -32,4 +37,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, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, occurrenceContext, 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, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, occurrenceContext, assistantPanel, sdkConfig, mediaAssets, useThemeScope, siteStyleAccess, }: PreviewShellLayoutProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,20 @@
+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 VisibleSiteStyleAccess } from './siteStyleAccess';
+export type StyleConfiguratorProps = Readonly<{
+    siteId: string;
+    apiClient: ApiClient;
+    theme?: Theme | null;
+    themeId?: string | null;
+    selectionId?: string | null;
+    /** Server-persisted Style configurator selections (Phase C). */
+    initialSelections: Readonly<{
+        buttonPersonalityId: ButtonPersonalityId | null;
+        paletteVariantId: PaletteVariantId | null;
+        paletteOverrides: PaletteOverrides | null;
+    }>;
+    siteStyleAccess: VisibleSiteStyleAccess;
+}>;
+export declare function StyleConfigurator({ siteId, apiClient, theme, themeId, selectionId, initialSelections, siteStyleAccess, }: StyleConfiguratorProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,99 @@
+/**
+ * Pure state module for the Style configurator. Per-action function style so
+ * the picker rows, apply flow, and concurrency layer can call into a small,
+ * exhaustive set of named transitions instead of a centralised reducer
+ * switch.
+ *
+ * The configurator surfaces three site-level decisions (site style, button
+ * personality, palette variant) plus optional sparse palette overrides. The
+ * "base" snapshot is what the server has persisted; "previewed" is what the
+ * preview pane is currently rendering. They diverge while the user is
+ * picking and converge on apply-success.
+ */
+import type { ButtonPersonalityId } from '@riverbankcms/theme-core/buttons';
+import type { PaletteOverrides, PaletteVariantId } from '@riverbankcms/theme-core/palette';
+import type { CompatibilityWarning, SiteStyleId } from '@riverbankcms/theme-core/site-styles/previewCompiler';
+export type StyleConfiguratorSaveStatus = Readonly<{
+    kind: 'idle';
+}> | Readonly<{
+    kind: 'saving';
+}> | Readonly<{
+    kind: 'saved';
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}>;
+export type StyleConfiguratorExpandedRow = 'style' | 'buttons' | 'palette' | 'colours' | null;
+/**
+ * Configurator-level notices that aren't compiler compatibility warnings.
+ * Kept separate from `CompatibilityWarning` (which comes from
+ * `compileSiteThemeFromSelections`) so the layers stay clean: warnings are
+ * compiler-emitted, notices are UI-level decisions the configurator makes.
+ */
+export type StyleConfiguratorNotice = Readonly<{
+    kind: 'overrides-cleared-by-site-style-switch';
+}>;
+export type SelectionSnapshot = Readonly<{
+    siteStyleId: SiteStyleId;
+    buttonPersonalityId: ButtonPersonalityId;
+    paletteVariantId: PaletteVariantId;
+    paletteOverrides: PaletteOverrides | null;
+}>;
+export type StyleConfiguratorState = Readonly<{
+    /**
+     * Last persisted server snapshot. Updated on apply-success (and on
+     * external rebases via `syncStyleConfiguratorState`).
+     */
+    base: SelectionSnapshot;
+    /**
+     * Currently rendered selection. Diverges from `base` while the user is
+     * previewing changes. Identical to `base` after apply-success.
+     */
+    previewed: SelectionSnapshot;
+    saveStatus: StyleConfiguratorSaveStatus;
+    warnings: ReadonlyArray<CompatibilityWarning>;
+    notices: ReadonlyArray<StyleConfiguratorNotice>;
+    expandedRow: StyleConfiguratorExpandedRow;
+}>;
+export declare function createStyleConfiguratorState(base: SelectionSnapshot): 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
+ * `setOverrideTheme` call.
+ */
+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 previewPaletteVariant(state: StyleConfiguratorState, paletteVariantId: PaletteVariantId): StyleConfiguratorState;
+export declare function setPaletteOverrides(state: StyleConfiguratorState, paletteOverrides: PaletteOverrides | null): StyleConfiguratorState;
+/**
+ * Records the post-compile resolved selection + any compatibility warnings.
+ * Used after `compileSiteThemeFromSelections` runs against a new site style:
+ * the resolver may have auto-picked a different personality / palette if the
+ * user's previous selections weren't compatible with the new style.
+ *
+ * When `clearOverrides` is true, sparse `paletteOverrides` from the previous
+ * site style are dropped — the new variant has different colour-role meanings
+ * (e.g. the previous `primary` override doesn't apply to the new variant's
+ * `primary` if the new style has a fundamentally different palette voice).
+ * A `'overrides-cleared-by-site-style-switch'` notice is appended so the UI
+ * can surface a "we cleared your colour overrides" line.
+ */
+export declare function applyResolvedSelections(state: StyleConfiguratorState, input: Readonly<{
+    resolved: Pick<SelectionSnapshot, 'buttonPersonalityId' | 'paletteVariantId'>;
+    warnings: ReadonlyArray<CompatibilityWarning>;
+    clearOverrides?: boolean;
+}>): StyleConfiguratorState;
+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 toggleRow(state: StyleConfiguratorState, row: StyleConfiguratorExpandedRow): StyleConfiguratorState;
+export declare function dismissWarnings(state: StyleConfiguratorState): StyleConfiguratorState;
+export declare function dismissNotices(state: StyleConfiguratorState): StyleConfiguratorState;
+/**
+ * Reconciles local state with a fresh server snapshot — used after
+ * `router.refresh()` lands new theme data, or when an external write
+ * changes the persisted selection out-of-band.
+ */
+export declare function syncStyleConfiguratorState(state: StyleConfiguratorState, base: SelectionSnapshot): StyleConfiguratorState;

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

@@ -0,0 +1,12 @@
+import { type SurfaceId } from "@riverbankcms/surfaces";
+export declare const PREVIEW_CHROME_THEME_CLASS_NAME = "builder-dashboard-chrome-theme";
+export declare const PREVIEW_CHROME_PORTAL_CLASS_NAME = "builder-editor-chrome";
+export type PreviewChromeSurface = Readonly<{
+    surfaceClassName: string | null;
+    dataSurface: string | null;
+}>;
+export declare function resolvePreviewChromeSurface(surfaceId?: SurfaceId | null): PreviewChromeSurface;
+export declare function getPreviewChromeSurfaceDataProps(surface: PreviewChromeSurface): Readonly<Record<string, string>>;
+export declare function applyPreviewChromeSurfaceToElement(element: HTMLElement, surface: PreviewChromeSurface, options?: Readonly<{
+    includePortalClass?: boolean;
+}>): void;