@riverbankcms/sdk 0.104.3 → 0.108.0

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

@@ -364,12 +364,12 @@ export declare const formFieldSchema: z.ZodObject<{
         date: "date";
         time: "time";
         email: "email";
+        url: "url";
         text: "text";
         textarea: "textarea";
         select: "select";
         checkbox: "checkbox";
         radio: "radio";
-        url: "url";
         consent: "consent";
         tel: "tel";
     }>;
@@ -425,12 +425,12 @@ declare const bookingQuestionScalarFieldSchema: z.ZodObject<{
         date: "date";
         time: "time";
         email: "email";
+        url: "url";
         text: "text";
         textarea: "textarea";
         select: "select";
         checkbox: "checkbox";
         radio: "radio";
-        url: "url";
         tel: "tel";
     }>;
 }, z.core.$strict>;
@@ -481,12 +481,12 @@ export declare const bookingQuestionFieldSchema: z.ZodDiscriminatedUnion<[z.ZodO
         date: "date";
         time: "time";
         email: "email";
+        url: "url";
         text: "text";
         textarea: "textarea";
         select: "select";
         checkbox: "checkbox";
         radio: "radio";
-        url: "url";
         tel: "tel";
     }>;
 }, z.core.$strict>, z.ZodObject<{
@@ -540,12 +540,12 @@ export declare const bookingQuestionsSectionSchema: z.ZodObject<{
             date: "date";
             time: "time";
             email: "email";
+            url: "url";
             text: "text";
             textarea: "textarea";
             select: "select";
             checkbox: "checkbox";
             radio: "radio";
-            url: "url";
             tel: "tel";
         }>;
     }, z.core.$strict>, z.ZodObject<{
@@ -602,12 +602,12 @@ export declare const bookingQuestionsDetailedSchemaSchema: z.ZodObject<{
                 date: "date";
                 time: "time";
                 email: "email";
+                url: "url";
                 text: "text";
                 textarea: "textarea";
                 select: "select";
                 checkbox: "checkbox";
                 radio: "radio";
-                url: "url";
                 tel: "tel";
             }>;
         }, z.core.$strict>, z.ZodObject<{
@@ -646,12 +646,12 @@ export declare const formSchemaSchema: z.ZodObject<{
             date: "date";
             time: "time";
             email: "email";
+            url: "url";
             text: "text";
             textarea: "textarea";
             select: "select";
             checkbox: "checkbox";
             radio: "radio";
-            url: "url";
             consent: "consent";
             tel: "tel";
         }>;
@@ -705,12 +705,12 @@ export declare const bookingQuestionsFlatSchemaSchema: z.ZodObject<{
             date: "date";
             time: "time";
             email: "email";
+            url: "url";
             text: "text";
             textarea: "textarea";
             select: "select";
             checkbox: "checkbox";
             radio: "radio";
-            url: "url";
             tel: "tel";
         }>;
     }, z.core.$strict>, z.ZodObject<{
@@ -763,12 +763,12 @@ export declare const bookingQuestionsStoredSchemaSchema: z.ZodUnion<readonly [z.
             date: "date";
             time: "time";
             email: "email";
+            url: "url";
             text: "text";
             textarea: "textarea";
             select: "select";
             checkbox: "checkbox";
             radio: "radio";
-            url: "url";
             tel: "tel";
         }>;
     }, z.core.$strict>, z.ZodObject<{
@@ -824,12 +824,12 @@ export declare const bookingQuestionsStoredSchemaSchema: z.ZodUnion<readonly [z.
                 date: "date";
                 time: "time";
                 email: "email";
+                url: "url";
                 text: "text";
                 textarea: "textarea";
                 select: "select";
                 checkbox: "checkbox";
                 radio: "radio";
-                url: "url";
                 tel: "tel";
             }>;
         }, z.core.$strict>, z.ZodObject<{
@@ -900,12 +900,12 @@ export declare const createFormPayloadSchema: z.ZodObject<{
                 date: "date";
                 time: "time";
                 email: "email";
+                url: "url";
                 text: "text";
                 textarea: "textarea";
                 select: "select";
                 checkbox: "checkbox";
                 radio: "radio";
-                url: "url";
                 consent: "consent";
                 tel: "tel";
             }>;

package/dist/_dts/editor/src/primitives/rich-text/RichTextEditorSurface.d.ts

@@ -26,6 +26,11 @@ export type RichTextToolbarLayout = Readonly<{
     kind: 'inline';
     tone: 'light' | 'dark';
     visibility: RichTextToolbarVisibility;
+}> | Readonly<{
+    kind: 'external';
+    tone: 'light' | 'dark';
+    visibility: RichTextToolbarVisibility;
+    renderHost: (toolbar: ReactNode) => ReactNode;
 }> | Readonly<{
     kind: 'chrome';
     tone: 'light' | 'dark';

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

@@ -54,6 +54,7 @@ export type BlockEditorProps = {
     enableDeletion?: boolean;
     onBlockSave?: (blockId: string, content: Record<string, unknown>) => void;
     onBlocksChange?: (blocks: BlockItem[]) => void;
+    onStructuralRevisionChange?: (revision: string) => void;
     theme?: Theme | null;
     widgetOverrides?: Record<string, FieldWidgetComponent>;
     headerLeftSlot?: ReactNode;

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

@@ -1,4 +1,4 @@
-import type { SiteIconStyleGuideVersionId } from '../../../blocks/src/index';
+import { type SiteIconStyleGuideVersionId } from '../../../blocks/src/index';
 import type { BlockItem, DraftsSlice, UiStore } from './types';
 import { type GeneratedIconSetGenerateInput, type GeneratedIconSetGenerateResult } from './GeneratedIconSetDialog';
 import { type GeneratedIconApplyState } from './generatedIconApplyCoordination';

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

@@ -31,12 +31,15 @@ export type GeneratedIconSetApplyResult = Readonly<{
     kind: 'failed';
     message: string;
 }>;
-export declare function GeneratedIconSetDialog({ open, onOpenChange, cards, styleGuideSummary, styleGuideEditHref, onGenerate, onApply, }: {
+export declare function GeneratedIconSetDialog({ open, onOpenChange, cards, styleGuideSummary, styleGuideEditHref, generatedIconSizePx, onGeneratedIconSizeChange, hasStaleGeneratedIcons, onGenerate, onApply, }: {
     open: boolean;
     onOpenChange: (open: boolean) => void;
     cards: readonly FeatureCardIconDialogCard[];
     styleGuideSummary?: string | null;
     styleGuideEditHref?: string | null;
+    generatedIconSizePx?: number;
+    onGeneratedIconSizeChange?: (value: number) => void;
+    hasStaleGeneratedIcons?: boolean;
     onGenerate?: (input: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApply?: (preview: GeneratedIconSetPreview) => GeneratedIconSetApplyResult | void | Promise<GeneratedIconSetApplyResult | void>;
 }): import("react").JSX.Element;

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

@@ -10,7 +10,7 @@ type UiStore = {
         };
     };
 };
-export declare function useBlockCreation({ allowCreation, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, triggerFocus, uiStore, }: {
+export declare function useBlockCreation({ allowCreation, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, triggerFocus, uiStore, onStructuralRevisionChange, }: {
     allowCreation: boolean;
     apiClient: ApiClient;
     siteId: string;
@@ -20,6 +20,7 @@ export declare function useBlockCreation({ allowCreation, apiClient, siteId, own
     onBlocksChange?: (blocks: BlockItem[]) => void;
     triggerFocus?: (target: BlockFocusTarget) => void;
     uiStore?: UiStore | null;
+    onStructuralRevisionChange?: (revision: string) => void;
 }): {
     pickerOpen: boolean;
     creatingBlockName: string | null;

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

@@ -9,7 +9,7 @@ type UiStore = {
         };
     };
 };
-export declare function useBlockDuplication({ allowCreation, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, triggerFocus, setErrorMessage, uiStore, }: {
+export declare function useBlockDuplication({ allowCreation, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, triggerFocus, setErrorMessage, uiStore, onStructuralRevisionChange, }: {
     allowCreation: boolean;
     apiClient: ApiClient;
     siteId: string;
@@ -20,6 +20,7 @@ export declare function useBlockDuplication({ allowCreation, apiClient, siteId,
     triggerFocus?: (target: BlockFocusTarget) => void;
     setErrorMessage: (msg: string | null) => void;
     uiStore?: UiStore | null;
+    onStructuralRevisionChange?: (revision: string) => void;
 }): {
     duplicatingBlockId: string | null;
     duplicateBlock: (blockId: string) => Promise<void>;

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

@@ -15,7 +15,7 @@ type UiStore = {
     };
     subscribe: (listener: () => void) => () => void;
 };
-export declare function useBlockReorder({ allowReordering, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, setErrorMessage, uiStore, }: {
+export declare function useBlockReorder({ allowReordering, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, setErrorMessage, uiStore, onStructuralRevisionChange, }: {
     allowReordering: boolean;
     apiClient: ApiClient;
     siteId: string;
@@ -25,6 +25,7 @@ export declare function useBlockReorder({ allowReordering, apiClient, siteId, ow
     onBlocksChange?: (blocks: BlockItem[]) => void;
     setErrorMessage: (msg: string | null) => void;
     uiStore?: UiStore | null;
+    onStructuralRevisionChange?: (revision: string) => void;
 }): {
     reorderId: string | null;
     handleMove: (blockId: string, direction: number) => void;

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

@@ -7,6 +7,11 @@ export type BlockEditorOwner = Readonly<{
     type: string;
     entryId: string;
     slotKey: string;
+}> | Readonly<{
+    kind: 'surface-slot';
+    pageSurfaceId: string;
+    slotKey: string;
+    compositionHash: string;
 }>;
 export type CreateEditableBlockInput = Readonly<{
     kind: string;
@@ -18,6 +23,10 @@ export declare function blockEditorOwnerKey(owner: BlockEditorOwner): string;
 export declare function createEditableBlockForOwner(apiClient: ApiClient, siteId: string, owner: BlockEditorOwner, input: CreateEditableBlockInput): Promise<{
     ok: boolean;
     block: Record<string, unknown>;
+} | {
+    ok: boolean;
+    block: import("../../../api/src/index").BlockListItem;
+    compositionHash: string;
 }>;
 export declare function reorderEditableBlocksForOwner(apiClient: ApiClient, siteId: string, owner: BlockEditorOwner, blockIds: string[]): Promise<{
     ok: boolean;
@@ -25,3 +34,4 @@ export declare function reorderEditableBlocksForOwner(apiClient: ApiClient, site
 export declare function deleteEditableBlockForOwner(apiClient: ApiClient, siteId: string, owner: BlockEditorOwner, blockId: string): Promise<{
     ok: boolean;
 }>;
+export declare function surfaceCompositionHashFromResponse(response: unknown): string | null;

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

@@ -7,6 +7,7 @@ export type BlockItem = {
     draftContent?: Record<string, unknown> | null;
     publishedContent?: Record<string, unknown> | null;
     bindings?: Record<string, unknown> | null;
+    optimisticHash?: string | null;
 };
 export type DraftBlockSnapshot = EditorStructuralDraftSnapshot;
 /**

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

@@ -1,6 +1,7 @@
 export * from './types';
 export * from './fileDomain';
 export * from './fileStorage';
+export * from './storagePathDomain';
 export * from './fileSafety';
 export * from './filePersistence';
 export * from './fileAssetLegacyProjection';
@@ -26,7 +27,7 @@ export * from './classifyAllPlanning';
 export * from './mediaSettingsState';
 export * from './videoSlotPolicy';
 export * from './identifiers';
-export { getImageUrl, getDirectImageUrl, getDirectImageUrlForRelativePath, getDirectImageUrlForSiteScopedPath, getDirectImageUrlForBucketPath, getDirectImageUrlForStoragePath, getDirectImageUrlForMediaAsset, isRelativeDirectImageStoragePath, isSiteScopedDirectImageStoragePath, type DirectImageMediaAsset, type DirectImageUrlOptions, type DirectImageUrlPathTarget, type ImageProxyFit, type ImageProxyParams, } from './url';
+export { getImageUrl, getDirectImageUrl, getDirectImageUrlForRelativePath, getDirectImageUrlForSiteScopedPath, getDirectImageUrlForBucketPath, getDirectImageUrlForMediaAsset, isSiteScopedDirectImageStoragePath, type DirectImageMediaAsset, type DirectImageUrlOptions, type DirectImageUrlPathTarget, type ImageProxyFit, type ImageProxyParams, } from './url';
 export { isSameTransformRect, isSameHotspot, type HotspotLike } from './compare';
 export { asRecord, isRecord } from './typeGuards';
 export { emitMediaCropDebug, isMediaCropDebugEnabled } from './cropDebug';

package/dist/_dts/media-core/src/storagePathDomain.d.ts

@@ -0,0 +1,47 @@
+import type { RelativeStoragePath as CoreRelativeStoragePath, SiteScopedStoragePath as CoreSiteScopedStoragePath } from '../../core/src/index';
+declare const __storagePathSiteBrand: unique symbol;
+type SiteScopedStoragePathBrand<TSiteId extends string> = Readonly<{
+    kind: 'SiteScopedStoragePath';
+    siteId: TSiteId;
+}>;
+export type RelativeStoragePath = CoreRelativeStoragePath;
+export type SiteScopedStoragePath<TSiteId extends string = string> = CoreSiteScopedStoragePath & {
+    readonly [__storagePathSiteBrand]: SiteScopedStoragePathBrand<TSiteId>;
+};
+export type StoragePathForSite<TSiteId extends string = string> = Readonly<{
+    relativePath: RelativeStoragePath;
+    fullPath: SiteScopedStoragePath<TSiteId>;
+}>;
+export type StoragePathParseError = {
+    tag: 'MISSING';
+} | {
+    tag: 'EMPTY';
+} | {
+    tag: 'LEADING_SLASH';
+} | {
+    tag: 'DOUBLE_SLASH';
+} | {
+    tag: 'TRAVERSAL';
+} | {
+    tag: 'SITE_SCOPED_PATH';
+} | {
+    tag: 'INVALID_SITE_PREFIX';
+    expectedPrefix: string;
+};
+export type StoragePathParseResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: StoragePathParseError;
+};
+export declare function unwrapRelativeStoragePath(value: RelativeStoragePath): string;
+export declare function unwrapSiteScopedStoragePath<TSiteId extends string>(value: SiteScopedStoragePath<TSiteId>): string;
+export declare function parseRelativeStoragePath(value: unknown): StoragePathParseResult<RelativeStoragePath>;
+export declare function assertRelativeStoragePath(value: string): RelativeStoragePath;
+export declare function toSiteScopedStoragePath<TSiteId extends string>(siteId: TSiteId, relativePath: RelativeStoragePath): SiteScopedStoragePath<TSiteId>;
+export declare function normalizeRelativeStoragePathForSite<TSiteId extends string>(siteId: TSiteId, value: unknown): StoragePathParseResult<StoragePathForSite<TSiteId>>;
+export declare function normalizeAmbiguousStoragePathForSite<TSiteId extends string>(siteId: TSiteId, value: unknown): StoragePathParseResult<StoragePathForSite<TSiteId>>;
+export declare function parseSiteScopedStoragePathForSite<TSiteId extends string>(siteId: TSiteId, value: unknown): StoragePathParseResult<SiteScopedStoragePath<TSiteId>>;
+export declare function assertSiteScopedStoragePathForSite<TSiteId extends string>(siteId: TSiteId, value: string): SiteScopedStoragePath<TSiteId>;
+export {};

package/dist/_dts/media-core/src/url.d.ts

@@ -25,31 +25,11 @@ export type DirectImageUrlPathTarget = Readonly<{
     kind: 'bucket-scoped';
     storagePath: string;
 }>;
-export declare function isRelativeDirectImageStoragePath(storagePath: string): storagePath is RelativeStoragePath;
 export declare function isSiteScopedDirectImageStoragePath(storagePath: string): storagePath is SiteScopedStoragePath;
+export declare function getDirectImageUrl(supabaseUrl: string, target: DirectImageUrlPathTarget, storageBucket?: string, options?: DirectImageUrlOptions): string;
 export declare function getDirectImageUrlForRelativePath(supabaseUrl: string, storagePath: RelativeStoragePath, siteId: string, storageBucket?: string, options?: DirectImageUrlOptions): string;
 export declare function getDirectImageUrlForSiteScopedPath(supabaseUrl: string, storagePath: SiteScopedStoragePath, storageBucket?: string, options?: DirectImageUrlOptions): string;
 export declare function getDirectImageUrlForBucketPath(supabaseUrl: string, storagePath: string, storageBucket?: string, options?: DirectImageUrlOptions): string;
-export declare function getDirectImageUrlForStoragePath(supabaseUrl: string, storagePath: RelativeStoragePath | SiteScopedStoragePath | string, storageBucket?: string, siteId?: string, options?: DirectImageUrlOptions): string;
-/**
- * @deprecated Prefer `getDirectImageUrlForMediaAsset`, `getDirectImageUrlForRelativePath`,
- * `getDirectImageUrlForSiteScopedPath`, or `getDirectImageUrlForBucketPath` so path shape
- * is explicit at the call site.
- *
- * Build a direct Supabase storage URL for an image.
- *
- * For images with transform options, uses the render endpoint which applies
- * server-side transformations. For images without transforms (or SVGs),
- * returns the direct public object URL.
- *
- * @param supabaseUrl - Supabase project URL (e.g., https://xxx.supabase.co)
- * @param storagePath - Relative path within the bucket (e.g., originals/2024/12/img.png)
- * @param storageBucket - Storage bucket name (default: 'media')
- * @param siteId - Site UUID to prepend as path prefix
- * @param options - Optional transform parameters
- * @returns Direct URL to the image
- */
-export declare function getDirectImageUrl(supabaseUrl: string, storagePath: RelativeStoragePath | SiteScopedStoragePath | string, storageBucket?: string, siteId?: string, options?: DirectImageUrlOptions): string;
 export type DirectImageMediaAsset = Pick<MediaAsset, 'storageBucket' | 'storagePath'>;
 export declare function getDirectImageUrlForMediaAsset(supabaseUrl: string, asset: DirectImageMediaAsset, options?: DirectImageUrlOptions): string;
 export type ImageProxyFit = 'clip' | 'crop' | 'max';

package/dist/_dts/path-utils/src/index.d.ts

@@ -1,4 +1,9 @@
 export type PathSegment = string | number;
+export declare class UnsafePathSegmentError extends Error {
+    readonly segment: string;
+    constructor(segment: string);
+}
+export declare function isUnsafePathSegment(segment: PathSegment): boolean;
 export declare function parsePath(path: string | Array<PathSegment>): Array<PathSegment>;
 export declare function segmentsToPath(segments: Array<PathSegment>): string | undefined;
 export declare function siblingPath(path: string, siblingFieldPath: string): string;

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

@@ -1,5 +1,5 @@
 import type { BlockItem } from '../../../../editor-blocks/src/index';
-import type { DesignRuntimeRules, PageDesignEditorReadModel, SurfaceResolutionContext } from '../../../../theme-core/src/site-styles/previewCompiler';
+import type { DesignRuntimeRules, ComponentRuntimeRules, PageDesignEditorReadModel, SurfaceResolutionContext } from '../../../../theme-core/src/site-styles/previewCompiler';
 import type { PreviewPageDesignEditorState } from '../preview/PageDesignEditorStateContext';
 import { type RuntimeContentDecorationProjection } from './previewProjection';
 export type RuntimePreviewSource = Readonly<{
@@ -9,13 +9,15 @@ export type RuntimePreviewSource = Readonly<{
     editorModel: PageDesignEditorReadModel;
     surfaceResolutionContext: SurfaceResolutionContext;
     designRules?: DesignRuntimeRules;
+    componentRules?: ComponentRuntimeRules;
 }>;
 export declare function applyPageDesignRuntimeFieldsToBlockItems(blockItems: readonly BlockItem[], source: RuntimePreviewSource): BlockItem[];
 export declare function applyPageDesignRuntimeFieldsToBlockContent(block: BlockItem, content: Record<string, unknown> | null, source: RuntimePreviewSource): Record<string, unknown> | null;
-export declare function buildPageDesignRuntimeFieldsByBlockId(editorModel: PageDesignEditorReadModel, surfaceResolutionContext: SurfaceResolutionContext, designRules?: DesignRuntimeRules): RuntimeContentDecorationProjection['fieldsByBlockId'];
+export declare function buildPageDesignRuntimeFieldsByBlockId(editorModel: PageDesignEditorReadModel, surfaceResolutionContext: SurfaceResolutionContext, designRules?: DesignRuntimeRules, componentRules?: ComponentRuntimeRules): RuntimeContentDecorationProjection['fieldsByBlockId'];
 export declare function pageDesignRuntimeProjectionFromSource(source: RuntimePreviewSource): RuntimeContentDecorationProjection | null;
 export declare function resolveRuntimePreviewSource(input: Readonly<{
     pageDesignState: PreviewPageDesignEditorState;
     surfaceResolutionContext: SurfaceResolutionContext | null;
     designRules?: DesignRuntimeRules;
+    componentRules?: ComponentRuntimeRules;
 }>): RuntimePreviewSource;

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

@@ -1,5 +1,6 @@
 import type { BlockItem } from '../../../../../editor-blocks/src/index';
 import { type DesignRuntimeRules, type PageDesignEditorReadModel, type RuntimeContentAdjacency, type SurfaceResolutionContext } from '../../../../../theme-core/src/site-styles/previewCompiler';
 import type { CanonicalBlockContent, PreviewRenderContent, RuntimeContentDecorationProjection } from './types';
-export declare function runtimeContentDecorationProjectionFromEditorModel(editorModel: PageDesignEditorReadModel, surfaceResolutionContext: SurfaceResolutionContext, designRules?: DesignRuntimeRules): RuntimeContentDecorationProjection;
+import type { ComponentRuntimeRules } from '../../../../../theme-core/src/site-styles/previewCompiler';
+export declare function runtimeContentDecorationProjectionFromEditorModel(editorModel: PageDesignEditorReadModel, surfaceResolutionContext: SurfaceResolutionContext, designRules?: DesignRuntimeRules, componentRules?: ComponentRuntimeRules): RuntimeContentDecorationProjection;
 export declare function applyRuntimeContentDecorationProjection(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projection: RuntimeContentDecorationProjection, adjacency?: Pick<RuntimeContentAdjacency, 'nextContent'>): PreviewRenderContent;

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

@@ -23,6 +23,7 @@ type PageBlockEditorPanelProps = {
     linkedEntrySection?: PreviewLinkedEntrySidebarSection | null;
     designPanel?: ReactNode;
     designOpenRequestId?: number | null;
+    designTakeoverActive?: boolean;
     sdkConfig?: SdkConfigForBlockPicker | null;
     mediaAssets?: MediaAssetIndexItem[];
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
@@ -33,5 +34,5 @@ type PageBlockEditorPanelProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function PageBlockEditorPanel({ siteId, pageId, dashboardBaseUrl, theme, apiClient, bearerToken, supabaseUrl, blockItems, uiStoreForBlockEditor, blockEditorRef, onBlocksChange, metadataPanel, linkedEntrySection, designPanel, designOpenRequestId, sdkConfig, mediaAssets, bookingOfferingPresets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PageBlockEditorPanelProps): React.JSX.Element;
+export declare function PageBlockEditorPanel({ siteId, pageId, dashboardBaseUrl, theme, apiClient, bearerToken, supabaseUrl, blockItems, uiStoreForBlockEditor, blockEditorRef, onBlocksChange, metadataPanel, linkedEntrySection, designPanel, designOpenRequestId, designTakeoverActive, sdkConfig, mediaAssets, bookingOfferingPresets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PageBlockEditorPanelProps): React.JSX.Element;
 export {};

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

@@ -18,4 +18,9 @@ export declare function PreviewChromeFloatingControl({ anchorSelector, anchorTar
     forceVisible?: boolean;
     children: ReactNode;
 }): React.JSX.Element;
+export declare function PreviewChromeFloatingBar({ anchorSelector, gapPx, children, }: {
+    anchorSelector: string;
+    gapPx?: number;
+    children: ReactNode;
+}): React.JSX.Element;
 export {};

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

@@ -6,8 +6,7 @@ import type { EntrySubrouteContextData, BookingOfferingPresetSummary, MediaAsset
 import { type ContentTypeSchema } from "../../../../content-model/src/index";
 import { type ZoomLevel } from "../../../../content-editor/src/index";
 import type { ButtonPersonalityId } from "../../../../theme-core/src/buttons/index";
-import type { CuratedPaletteId, PaletteOverrides, RuntimePaletteState } from "../../../../theme-core/src/palette/index";
-import type { FooterSelectionContext, FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId, TypographyPresetId } from "../../../../theme-core/src/site-styles/index";
+import type { FooterSelectionContext, FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId } from "../../../../theme-core/src/site-styles/index";
 import type { PreviewDesignRow } from "./sidebarTabPreference";
 import type { ViewportMode, ViewportWidth } from "./PreviewViewportControls";
 import { type SiteStyleAccess } from "./siteStyleAccess";
@@ -37,14 +36,9 @@ export type PreviewEditorSidebarProps = {
     themeSelectionUpdatedAt?: string | null;
     /** Persisted Style configurator selections (Phase C / E). */
     themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
-    runtimePaletteState?: RuntimePaletteState | null;
-    themeSelectionPaletteVariantId?: CuratedPaletteId | null;
-    themeSelectionPaletteOverrides?: PaletteOverrides | null;
+    runtimePaletteState: import('./styleConfiguratorSnapshot').PreviewRuntimePaletteState;
     themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
     themeSelectionHeaderStyleId?: HeaderStyleId | null;
-    themeSelectionTypographyPresetId?: TypographyPresetId | null;
-    themeSelectionTypographyBodyFontOverride?: string | null;
-    themeSelectionTypographyHeadingFontOverride?: string | null;
     themeSelectionHeaderLookId?: HeaderLookId | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
@@ -65,6 +59,7 @@ export type PreviewEditorSidebarProps = {
     activeTab: PreviewEditorSidebarTab;
     onTabChange: (tab: PreviewEditorSidebarTab) => void;
     onClose: () => void;
+    onFooterSaved?: () => void;
     viewportMode: ViewportMode;
     viewportWidth: ViewportWidth;
     zoom: ZoomLevel;
@@ -72,4 +67,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, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionTypographyPresetId, themeSelectionTypographyBodyFontOverride, themeSelectionTypographyHeadingFontOverride, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, designRowRequest, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, siteStyleAccess, activeTab, onTabChange, onClose, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;
+export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, designRowRequest, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, siteStyleAccess, activeTab, onTabChange, onClose, onFooterSaved, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;

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

@@ -10,6 +10,7 @@ export type PreviewBlock = {
     draftContent?: Record<string, unknown> | null;
     publishedContent?: Record<string, unknown> | null;
     bindings?: Record<string, unknown> | null;
+    optimisticHash?: string | null;
 };
 export type PreviewPageMetadata = {
     draftTitle: string;

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

@@ -1,8 +1,7 @@
 import React, { type ComponentProps, type ReactNode } from 'react';
 import { BlockApiProvider } from '../../../../blocks/src/client';
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
-import type { CuratedPaletteId, PaletteOverrides } from '../../../../theme-core/src/palette/index';
-import type { FooterSelectionContext, FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
+import type { FooterSelectionContext, FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
 import type { EntrySubrouteContextData, BookingOfferingPresetSummary, MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
 import type { ContentTypeSchema } from '../../../../content-model/src/index';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
@@ -39,18 +38,13 @@ export type PreviewShellProps = {
     themeSelectionUpdatedAt?: string | null;
     /**
      * 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.
+     * so reload renders the user's saved button personality and authoritative
+     * complete palette state.
      */
     themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
-    runtimePaletteState?: import('../../../../theme-core/src/palette/index').RuntimePaletteState | null;
-    themeSelectionPaletteVariantId?: CuratedPaletteId | null;
-    themeSelectionPaletteOverrides?: PaletteOverrides | null;
+    runtimePaletteState: import('./styleConfiguratorSnapshot').PreviewRuntimePaletteState;
     themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
     themeSelectionHeaderStyleId?: HeaderStyleId | null;
-    themeSelectionTypographyPresetId?: TypographyPresetId | null;
-    themeSelectionTypographyBodyFontOverride?: string | null;
-    themeSelectionTypographyHeadingFontOverride?: string | null;
     themeSelectionHeaderLookId?: HeaderLookId | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
@@ -75,9 +69,12 @@ export type PreviewShellProps = {
     supabaseUrl?: string;
     themeRuntime?: PreviewThemeRuntime;
     designEditorEligibility?: PreviewDesignEditorEligibility;
+    /** Hides site-style controls for runtimes without palette authority. */
+    hideSiteStyleConfigurator?: boolean;
     baseFetch?: BaseFetch;
+    onFooterSaved?: () => void;
 };
-export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionTypographyPresetId, themeSelectionTypographyBodyFontOverride, themeSelectionTypographyHeadingFontOverride, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, supabaseUrl, themeRuntime, designEditorEligibility, baseFetch, }: PreviewShellProps): React.JSX.Element;
+export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, supabaseUrl, themeRuntime, designEditorEligibility, hideSiteStyleConfigurator, baseFetch, onFooterSaved, }: PreviewShellProps): React.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,8 +1,7 @@
 import React, { type ReactNode } from "react";
 import { type EntrySubrouteContextData, type BookingOfferingPresetSummary, type MediaAssetIndexItem, type Theme } from "../../../../blocks/src/index";
 import type { ButtonPersonalityId } from "../../../../theme-core/src/buttons/index";
-import type { CuratedPaletteId, PaletteOverrides } from "../../../../theme-core/src/palette/index";
-import type { FooterSelectionContext, HeaderSelectionContext, FooterLookId, HeaderLayoutId, HeaderLookId, HeaderStyleId, TypographyPresetId } from "../../../../theme-core/src/site-styles/index";
+import type { FooterSelectionContext, HeaderSelectionContext, FooterLookId, HeaderLayoutId, HeaderLookId, HeaderStyleId } from "../../../../theme-core/src/site-styles/index";
 import type { ContentTypeSchema } from "../../../../content-model/src/index";
 import type { ApiClient } from "../../../../api/src/request";
 import type { SdkConfigForBlockPicker } from "../../../../editor-blocks/src/index";
@@ -29,14 +28,9 @@ export type PreviewShellLayoutProps = {
     themeSelectionVersion?: number | null;
     themeSelectionUpdatedAt?: string | null;
     themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
-    runtimePaletteState?: import('../../../../theme-core/src/palette/index').RuntimePaletteState | null;
-    themeSelectionPaletteVariantId?: CuratedPaletteId | null;
-    themeSelectionPaletteOverrides?: PaletteOverrides | null;
+    runtimePaletteState: import('./styleConfiguratorSnapshot').PreviewRuntimePaletteState;
     themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
     themeSelectionHeaderStyleId?: HeaderStyleId | null;
-    themeSelectionTypographyPresetId?: TypographyPresetId | null;
-    themeSelectionTypographyBodyFontOverride?: string | null;
-    themeSelectionTypographyHeadingFontOverride?: string | null;
     themeSelectionHeaderLookId?: HeaderLookId | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
@@ -51,5 +45,6 @@ export type PreviewShellLayoutProps = {
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     themeRuntime?: PreviewThemeRuntime;
     siteStyleAccess?: SiteStyleAccess;
+    onFooterSaved?: () => void;
 };
-export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionTypographyPresetId, themeSelectionTypographyBodyFontOverride, themeSelectionTypographyHeadingFontOverride, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, themeRuntime, siteStyleAccess, }: PreviewShellLayoutProps): React.JSX.Element;
+export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, themeRuntime, siteStyleAccess, onFooterSaved, }: PreviewShellLayoutProps): React.JSX.Element;

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

@@ -2,8 +2,7 @@ import React, { type ReactNode } from 'react';
 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 { RuntimePaletteState } from '../../../../theme-core/src/palette/index';
-import type { BrandDisplayMode, FooterLayoutId, FooterLookId, HeaderNavFontSizePreference, HeaderNavTypographyPreference, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, LogoSizePolicy, SiteChromeBackgroundColorToken, SiteChromeBackgroundOverride, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
+import type { BrandDisplayMode, FooterLayoutId, FooterLookId, HeaderNavFontSizePreference, HeaderNavTypographyPreference, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, LogoSizePolicy, SiteChromeBackgroundColorToken, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
 import { headerNavFontSizeOptions, headerNavTypographyOptions } from '../../../../theme-core/src/site-styles/index';
 import { type StyleConfiguratorHistoryEntry } from './StyleConfigurator.state';
 import type { SiteStyleAccess } from './siteStyleAccess';
@@ -118,12 +117,9 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
         selectionVersion?: number | null;
         selectionUpdatedAt?: string | null;
         buttonPersonalityId: ButtonPersonalityId | null;
-        runtimePaletteState?: RuntimePaletteState | null;
+        runtimePaletteState: import('./styleConfiguratorSnapshot').PreviewRuntimePaletteState;
         headerLayoutId?: HeaderLayoutId | null;
         headerStyleId?: HeaderStyleId | null;
-        typographyPresetId?: TypographyPresetId | null;
-        typographyBodyFontOverride?: string | null;
-        typographyHeadingFontOverride?: string | null;
         headerLookId?: HeaderLookId | null;
         footerLookId?: FooterLookId | null;
     }> & Readonly<Record<string, unknown>>;