@riverbankcms/sdk 0.108.0 → 0.111.0

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

@@ -1,5 +1,6 @@
 import { type ReactNode } from 'react';
 import type { ButtonSystem } from '../../../../blocks/src/index';
+import { type BlockButtonRole } from '../../../../blocks/src/system/constants/buttonRoles';
 /**
  * Button Widget Context
  *
@@ -7,13 +8,13 @@ import type { ButtonSystem } from '../../../../blocks/src/index';
  * Similar to MediaEditorProvider and LinkWidgetProvider pattern.
  */
 export interface ButtonVariantOption {
-    id: string;
+    id: BlockButtonRole;
     name: string;
     priority: number;
 }
 export interface ButtonWidgetContextValue {
     variants: ButtonVariantOption[];
-    defaultVariant: string | null;
+    defaultVariant: BlockButtonRole | null;
     buttonSystem: ButtonSystem | null;
 }
 export interface ButtonWidgetProviderProps {

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

@@ -8,3 +8,19 @@ export type MagicDetectedMimeType = 'image/png' | 'image/jpeg' | 'image/gif' | '
  */
 export declare function detectMimeTypeFromBuffer(buffer: Uint8Array | null | undefined): MagicDetectedMimeType | undefined;
 export declare function bufferAsLatin1(buffer: Uint8Array, maxBytes?: number): string;
+/**
+ * Recognizes an SVG document by its leading element only.
+ *
+ * Within a bounded window we skip an optional UTF-8 BOM, whitespace, and any XML
+ * prolog constructs (XML declaration / processing instructions, comments, and a
+ * DOCTYPE) and then require the very first element to be `<svg>`. Requiring the
+ * root element — rather than scanning for `<svg` anywhere — is the false-positive
+ * guard: an HTML document that merely embeds inline `<svg>` further down (its
+ * first element is `<html>`/`<body>`/etc.) is deliberately NOT recognized as SVG.
+ *
+ * DOCTYPE is skipped rather than rejected here so a DOCTYPE-bearing SVG is still
+ * recognized and routed to the finalize sanitizer (which rejects DOCTYPE/entities
+ * outright) instead of failing earlier as an opaque MIME mismatch. This probe is
+ * intentionally trusted only through the contract-gated `svg-fallback` strategy.
+ */
+export declare function looksLikeSvgBuffer(buffer: Uint8Array | null | undefined): boolean;

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

@@ -9,6 +9,7 @@ export declare const PUBLIC_SITE_FILE_STORAGE_BUCKETS: readonly [StorageBucketNa
 export declare const FILE_UPLOAD_STAGING_PREFIX = "temp-file-uploads";
 export declare const DURABLE_FILE_STORAGE_PREFIX = "sites";
 export declare const DURABLE_FILE_FOLDER = "files";
+export declare const SDK_UPLOAD_STAGING_PREFIX = "sdk-staging";
 export declare const PRIVATE_SITE_FILE_BUCKET_MIME_TYPES: readonly ["application/pdf", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "text/plain", "application/rtf", "text/rtf", "image/jpeg", "image/png", "image/webp", "image/gif", "image/avif", "image/heic", "image/heif", "image/svg+xml", "text/csv", "application/csv", "application/vnd.ms-excel", "application/zip", "application/x-zip-compressed", "audio/mpeg", "audio/mp4", "audio/wav", "audio/x-wav", "audio/ogg", "audio/webm", "audio/flac", "video/mp4", "video/webm", "video/quicktime"];
 export declare const TEMP_UPLOAD_BUCKET_MIME_TYPES: readonly ["application/pdf", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "text/plain", "application/rtf", "text/rtf", "image/jpeg", "image/png", "image/webp", "image/gif", "image/avif", "image/heic", "image/heif", "image/svg+xml", "text/csv", "application/csv", "application/vnd.ms-excel", "application/zip", "application/x-zip-compressed", "audio/mpeg", "audio/mp4", "audio/wav", "audio/x-wav", "audio/ogg", "audio/webm", "audio/flac", "video/mp4", "video/webm", "video/quicktime", "font/woff2", "application/font-woff2", "application/x-font-woff2", "application/octet-stream"];
 export type FileStoragePathError = 'unsafe-path-segment';
@@ -39,3 +40,10 @@ export declare function buildStagedUploadStoragePath(input: StagedUploadStorageP
  */
 export declare function buildDurableFileStoragePath(input: DurableFileStoragePathInput): Result<SiteScopedStoragePath, FileStoragePathError>;
 export declare function parseStoragePath(value: string): Result<StoragePath, FileStoragePathError>;
+/**
+ * Builds the private staging path for an SDK-management upload from its intended
+ * durable relative path: `sdk-staging/{siteId}/{durableRelativePath}`. Finalize
+ * promotes the object from here (in `temp-uploads`) to the public bucket only
+ * after verification + sanitization.
+ */
+export declare function buildSdkStagedStoragePath(siteId: SiteId, durableRelativePath: string): Result<StoragePath, FileStoragePathError>;

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

@@ -22,6 +22,8 @@ export type StoragePathParseError = {
     tag: 'DOUBLE_SLASH';
 } | {
     tag: 'TRAVERSAL';
+} | {
+    tag: 'PERCENT_ENCODING';
 } | {
     tag: 'SITE_SCOPED_PATH';
 } | {

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

@@ -17,6 +17,9 @@ export type UploadVerificationStrategy = Readonly<{
 }> | Readonly<{
     tag: 'rtf-fallback';
     detectedMimeType: 'application/rtf';
+}> | Readonly<{
+    tag: 'svg-fallback';
+    detectedMimeType: 'image/svg+xml';
 }>;
 export type AcceptedUploadKindContract = Readonly<{
     kind: FileKind;

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

@@ -1,6 +1,7 @@
 import React from 'react';
 import { type BookingOfferingPresetSummary, type Theme } from '../../../../blocks/src/index';
 import { type BackgroundColorPalette } from '../../../../blocks/src/system/customize/backgrounds';
+import { type GradientPresetId } from '../../../../theme-core/src/gradients/index';
 import { type PreviewChromeFloatingPlacement } from '../preview/previewChromePlacement';
 export declare function BlockToolbar({ blockId, blockKind, content, bookingOfferingPresets, theme, placement, }: {
     blockId: string;
@@ -10,4 +11,5 @@ export declare function BlockToolbar({ blockId, blockKind, content, bookingOffer
     theme?: Theme | null;
     placement?: PreviewChromeFloatingPlacement;
 }): React.JSX.Element;
+export declare function gradientPreviewCss(gradientId: GradientPresetId): string;
 export declare function readBackgroundColorPaletteSnapshot(): BackgroundColorPalette | null;

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

@@ -8,8 +8,9 @@ export { PreviewShellSmoke } from "./PreviewShellSmoke";
 export { PreviewLayoutProvider, usePreviewLayout, } from "./layout/PreviewLayoutContext";
 export { useOptionalPreviewLayout } from "./layout/PreviewLayoutContext";
 export { previewAssistantEnabled, resolvePreviewSidebarTab, } from "./preview/assistantAvailability";
-export type { PreviewDesignRow, PreviewSidebarOpenRequest, PreviewSidebarTab, } from "./preview/sidebarTabPreference";
-export { getPreviewSidebarTab, onPreviewSidebarOpenRequest, requestPreviewSidebarOpen, setPreviewSidebarTab, } from "./preview/sidebarTabPreference";
+export type { PreviewSidebarTab } from "./preview/sidebarTabPreference";
+export { getPreviewSidebarTab, setPreviewSidebarTab, } from "./preview/sidebarTabPreference";
+export type { PreviewDesignRow, PreviewEditorOpenIntent, } from "../../../content-editor/src/index";
 export type { PreviewViewportControlsProps, ViewportMode, ViewportWidth, } from "./preview/PreviewViewportControls";
 export { PreviewViewportControls } from "./preview/PreviewViewportControls";
 export type { PreviewThemeResponsiveMode, PreviewThemeRuntime, } from "./preview/themeRuntime";

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

@@ -0,0 +1,16 @@
+import React from 'react';
+import { type Theme } from '../../../../blocks/src/index';
+import { type ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
+export type ButtonStylePickerProps = Readonly<{
+    selections: readonly ButtonStyleSelection[];
+    current: ButtonStyleSelection;
+    previewTheme: Theme;
+    onPreview: (selection: ButtonStyleSelection) => void;
+    disabled?: boolean;
+}>;
+export declare function ButtonStylePicker({ selections, current, previewTheme, onPreview, disabled, }: ButtonStylePickerProps): React.JSX.Element;
+export declare function ButtonStylePreviewPair({ selection, previewTheme, compact, }: Readonly<{
+    selection: ButtonStyleSelection;
+    previewTheme: Theme;
+    compact?: boolean;
+}>): React.JSX.Element | null;

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

@@ -3,7 +3,7 @@ import type { ApiClient } from '../../../../api/src/request';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/block-editor/sdkBlockMerger';
 import type { BlockEditorHandle, BlockItem } from '../../../../editor-blocks/src/block-editor/types';
 import type { BookingOfferingPresetSummary, MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
-import type { EditorUiState, ZoomLevel } from '../../../../content-editor/src/index';
+import { type EditorUiState, type ZoomLevel } from '../../../../content-editor/src/index';
 import { type ViewportMode, type ViewportWidth } from './PreviewViewportControls';
 import type { PreviewZustandStoreApi } from './storeTypes';
 import { type PreviewLinkedEntrySidebarSection } from './PreviewSidebarSection';
@@ -22,7 +22,6 @@ type PageBlockEditorPanelProps = {
     metadataPanel: ReactNode;
     linkedEntrySection?: PreviewLinkedEntrySidebarSection | null;
     designPanel?: ReactNode;
-    designOpenRequestId?: number | null;
     designTakeoverActive?: boolean;
     sdkConfig?: SdkConfigForBlockPicker | null;
     mediaAssets?: MediaAssetIndexItem[];
@@ -34,5 +33,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, designTakeoverActive, 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, designTakeoverActive, sdkConfig, mediaAssets, bookingOfferingPresets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PageBlockEditorPanelProps): React.JSX.Element;
 export {};

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

@@ -0,0 +1,7 @@
+import { type ReactNode } from 'react';
+import type { PreviewDesignOpenRequest } from '../../../../content-editor/src/index';
+export declare function PreviewDesignOpenRequestProvider({ request, children, }: {
+    request: PreviewDesignOpenRequest | null;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function usePreviewDesignOpenRequest(): PreviewDesignOpenRequest | null;

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

@@ -5,9 +5,8 @@ import type { SurfaceId } from "../../../../surfaces/src/index";
 import type { EntrySubrouteContextData, BookingOfferingPresetSummary, MediaAssetIndexItem, Theme } from "../../../../blocks/src/index";
 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 { FooterSelectionContext, FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId } from "../../../../theme-core/src/site-styles/index";
-import type { PreviewDesignRow } from "./sidebarTabPreference";
+import type { ButtonStyleSelection } from "../../../../theme-core/src/buttons/index";
+import type { FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId } from "../../../../theme-core/src/site-styles/index";
 import type { ViewportMode, ViewportWidth } from "./PreviewViewportControls";
 import { type SiteStyleAccess } from "./siteStyleAccess";
 export type PreviewEditorSidebarTab = "editor" | "assistant";
@@ -35,18 +34,13 @@ export type PreviewEditorSidebarProps = {
     themeSelectionVersion?: number | null;
     themeSelectionUpdatedAt?: string | null;
     /** Persisted Style configurator selections (Phase C / E). */
-    themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
-    runtimePaletteState: import('./styleConfiguratorSnapshot').PreviewRuntimePaletteState;
+    themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
+    runtimePaletteState: import("./styleConfiguratorSnapshot").PreviewRuntimePaletteState;
     themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
     themeSelectionHeaderStyleId?: HeaderStyleId | null;
     themeSelectionHeaderLookId?: HeaderLookId | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
-    themeSelectionFooterContext?: Partial<FooterSelectionContext>;
-    designRowRequest?: Readonly<{
-        id: number;
-        row: PreviewDesignRow;
-    }> | null;
     apiClient: ApiClient;
     bearerToken?: string | null;
     supabaseUrl?: string;
@@ -67,4 +61,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, 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;
+export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, runtimePaletteState, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, 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/PreviewShell.d.ts

@@ -1,7 +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 { FooterSelectionContext, FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
+import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
+import type { 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';
@@ -38,17 +38,16 @@ export type PreviewShellProps = {
     themeSelectionUpdatedAt?: string | null;
     /**
      * Persisted Style configurator selections. Forwarded into StyleConfigurator
-     * so reload renders the user's saved button personality and authoritative
+     * so reload renders the user's saved button style and authoritative
      * complete palette state.
      */
-    themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
+    themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
     runtimePaletteState: import('./styleConfiguratorSnapshot').PreviewRuntimePaletteState;
     themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
     themeSelectionHeaderStyleId?: HeaderStyleId | null;
     themeSelectionHeaderLookId?: HeaderLookId | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
-    themeSelectionFooterContext?: Partial<FooterSelectionContext>;
     pageId: string | null;
     routeId: string | null;
     entryData?: PreviewContentEntryData | null;
@@ -74,7 +73,7 @@ export type PreviewShellProps = {
     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, 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 PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, runtimePaletteState, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, 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,13 +1,13 @@
 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 { FooterSelectionContext, HeaderSelectionContext, FooterLookId, HeaderLayoutId, HeaderLookId, HeaderStyleId } from "../../../../theme-core/src/site-styles/index";
+import type { ButtonStyleSelection } from "../../../../theme-core/src/buttons/index";
+import type { 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";
 import type { SurfaceId } from "../../../../surfaces/src/index";
 import { type PreviewEntryData, type PreviewTemplateData } from "./PreviewEditorSidebar";
-import type { SiteStyleAccess } from "./siteStyleAccess";
+import { type SiteStyleAccess } from "./siteStyleAccess";
 import { type PreviewThemeRuntime } from "./themeRuntime";
 export type PreviewShellLayoutProps = {
     children: ReactNode;
@@ -27,14 +27,13 @@ export type PreviewShellLayoutProps = {
     themeSelectionId?: string | null;
     themeSelectionVersion?: number | null;
     themeSelectionUpdatedAt?: string | null;
-    themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
-    runtimePaletteState: import('./styleConfiguratorSnapshot').PreviewRuntimePaletteState;
+    themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
+    runtimePaletteState: import("./styleConfiguratorSnapshot").PreviewRuntimePaletteState;
     themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
     themeSelectionHeaderStyleId?: HeaderStyleId | null;
     themeSelectionHeaderLookId?: HeaderLookId | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderContext?: Partial<HeaderSelectionContext>;
-    themeSelectionFooterContext?: Partial<FooterSelectionContext>;
     supabaseUrl?: string;
     isSiteLaunched: boolean;
     maintenanceModeEnabled: boolean;
@@ -47,4 +46,4 @@ export type PreviewShellLayoutProps = {
     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, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, themeRuntime, siteStyleAccess, onFooterSaved, }: 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, themeSelectionButtonStyleSelection, runtimePaletteState, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, 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

@@ -1,8 +1,8 @@
 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 { BrandDisplayMode, FooterLayoutId, FooterLookId, HeaderNavFontSizePreference, HeaderNavTypographyPreference, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, LogoSizePolicy, SiteChromeBackgroundColorToken, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
+import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
+import type { BrandDisplayMode, FooterLookId, HeaderNavFontSizePreference, HeaderNavTypographyPreference, 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';
@@ -80,9 +80,6 @@ export type SiteChromeCustomizeSurfaceState = Readonly<{
     kind: 'available';
     surface: 'footer';
     label: string;
-    currentLayoutId: FooterLayoutId;
-    currentLayoutLabel: string;
-    layoutOptions: readonly SiteChromeLookOption<FooterLayoutId>[];
     currentId: FooterLookId | null;
     currentLabel: string;
     options: readonly SiteChromeLookOption<FooterLookId | null>[];
@@ -92,9 +89,10 @@ export type SiteChromeCustomizeSurfaceState = Readonly<{
     applyAllowed: boolean;
 }>;
 type SiteChromeCustomizeContextValue = Readonly<{
+    canOpenDesignEditor: boolean;
     getSurfaceState: (surface: SiteChromeEditableSurfaceKind) => SiteChromeCustomizeSurfaceState;
     cycleSurfaceLook: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
-    cycleSurfaceLayout: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
+    cycleHeaderLayout: (direction: 'prev' | 'next') => void;
     setHeaderBrandDisplay: (value: BrandDisplayMode) => void;
     setHeaderLogoSize: (value: LogoSizePolicy) => void;
     setHeaderMenuFont: (value: HeaderNavTypographyPreference) => void;
@@ -116,7 +114,7 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
     initialSelections: Readonly<{
         selectionVersion?: number | null;
         selectionUpdatedAt?: string | null;
-        buttonPersonalityId: ButtonPersonalityId | null;
+        buttonStyleSelection: ButtonStyleSelection | null;
         runtimePaletteState: import('./styleConfiguratorSnapshot').PreviewRuntimePaletteState;
         headerLayoutId?: HeaderLayoutId | null;
         headerStyleId?: HeaderStyleId | null;
@@ -124,9 +122,9 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
         footerLookId?: FooterLookId | null;
     }> & Readonly<Record<string, unknown>>;
     headerSelectionContext?: Partial<HeaderSelectionContext>;
-    footerSelectionContext?: Partial<FooterSelectionContext>;
     siteStyleAccess?: SiteStyleAccess;
+    canOpenDesignEditor?: boolean;
 }>;
-export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, footerSelectionContext, siteStyleAccess, }: SiteChromeCustomizeProviderProps): React.JSX.Element;
+export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, siteStyleAccess, canOpenDesignEditor, }: SiteChromeCustomizeProviderProps): React.JSX.Element;
 export declare function useSiteChromeCustomizeOptional(): SiteChromeCustomizeContextValue | null;
 export {};

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

@@ -1,10 +1,9 @@
 import React 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 FooterSelectionContext, type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
+import { type ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
+import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
 import { type VisibleSiteStyleAccess } from './siteStyleAccess';
-import type { PreviewDesignRow } from './sidebarTabPreference';
 import type { PreviewRuntimePaletteState } from './styleConfiguratorSnapshot';
 export type StyleConfiguratorProps = Readonly<{
     siteId: string;
@@ -18,7 +17,7 @@ export type StyleConfiguratorProps = Readonly<{
     initialSelections: Readonly<{
         selectionVersion?: number | null;
         selectionUpdatedAt?: string | null;
-        buttonPersonalityId: ButtonPersonalityId | null;
+        buttonStyleSelection: ButtonStyleSelection | null;
         runtimePaletteState: PreviewRuntimePaletteState;
         headerLayoutId?: HeaderLayoutId | null;
         headerStyleId?: HeaderStyleId | null;
@@ -26,13 +25,7 @@ export type StyleConfiguratorProps = Readonly<{
         footerLookId?: FooterLookId | null;
     }> & Readonly<Record<string, unknown>>;
     headerSelectionContext?: Partial<HeaderSelectionContext>;
-    footerSelectionContext?: Partial<FooterSelectionContext>;
-    expandedRowRequest?: Readonly<{
-        /** Monotonic request id so repeated clicks on the same chrome surface retrigger the effect. */
-        id: number;
-        row: PreviewDesignRow;
-    }> | null;
     onFocusedSurfaceChange?: (focused: boolean) => void;
     siteStyleAccess: VisibleSiteStyleAccess;
 }>;
-export declare function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, footerSelectionContext, expandedRowRequest, onFocusedSurfaceChange, siteStyleAccess, }: StyleConfiguratorProps): React.JSX.Element;
+export declare function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, onFocusedSurfaceChange, siteStyleAccess, }: StyleConfiguratorProps): React.JSX.Element;

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

@@ -5,12 +5,12 @@
  * switch.
  *
  * The configurator surfaces three site-level decisions (site style, button
- * personality, palette state). The
+ * button style, palette state). 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 '../../../../theme-core/src/buttons/index';
+import { type ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
 import type { Theme } from '../../../../blocks/src/index';
 import type { PaletteColors, PaletteMode, PaletteSelection, PaletteEditorState, KnownCuratedPaletteValueKey, ResolvedPaletteSelection, RuntimePaletteState, SitePalette, SitePaletteId, SitePaletteVersion, PaletteLibraryAuthority } from '../../../../theme-core/src/palette/index';
 import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
@@ -27,7 +27,7 @@ export type StyleConfiguratorSaveStatus = Readonly<{
     message: string;
     failureKind: 'retryable' | 'stale';
 }>;
-export type StyleConfiguratorExpandedRow = 'style' | 'header-layout' | 'header-style' | 'footer-layout' | 'footer' | 'buttons' | 'typography' | 'palette' | 'colours' | null;
+export type StyleConfiguratorExpandedRow = 'style' | 'header-layout' | 'header-style' | 'footer' | 'buttons' | 'typography' | 'palette' | 'colours' | null;
 /**
  * Configurator-level notices that aren't compiler selection fallback warnings.
  * Kept separate from `SelectionFallbackWarning` (which comes from
@@ -92,7 +92,7 @@ export type SelectionSnapshot = Readonly<{
     headerStyleId: HeaderStyleId;
     headerLookId: HeaderLookId | null;
     footerLookId: FooterLookId | null;
-    buttonPersonalityId: ButtonPersonalityId;
+    buttonStyleSelection: ButtonStyleSelection;
     palette: PaletteSelectionSnapshot;
     typography: ThemeTypography;
 }>;
@@ -157,7 +157,7 @@ export declare function isPreviewingChange(state: StyleConfiguratorState): boole
 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 previewButtonStyle(state: StyleConfiguratorState, buttonStyleSelection: ButtonStyleSelection): StyleConfiguratorState;
 export declare function previewHeaderLayout(state: StyleConfiguratorState, headerLayoutId: HeaderLayoutId): StyleConfiguratorState;
 export declare function previewHeaderStyle(state: StyleConfiguratorState, headerStyleId: HeaderStyleId): StyleConfiguratorState;
 export declare function previewFooterLook(state: StyleConfiguratorState, footerLookId: FooterLookId | null): StyleConfiguratorState;
@@ -177,13 +177,13 @@ export declare function setPaletteColors(state: StyleConfiguratorState, colors:
 /**
  * Records the post-compile resolved selection + any fallback warnings.
  * Used after `compileSiteThemeFromSelections` runs against a new site style:
- * the resolver may have auto-picked a different personality if the user's
+ * the resolver may have auto-picked a different button style if the user's
  * previous selection is not offered for the new style, or a different palette
  * if the persisted palette value key is no longer known.
  *
  */
 export declare function applyResolvedSelections(state: StyleConfiguratorState, input: Readonly<{
-    resolved: Pick<SelectionSnapshot, 'buttonPersonalityId' | 'headerLayoutId' | 'headerStyleId' | 'headerLookId' | 'typography'>;
+    resolved: Pick<SelectionSnapshot, 'buttonStyleSelection' | 'headerLayoutId' | 'headerStyleId' | 'headerLookId' | 'typography'>;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>): StyleConfiguratorState;
 export declare function cancelPreview(state: StyleConfiguratorState): StyleConfiguratorState;
@@ -213,6 +213,7 @@ export declare function reconcilePaletteLibraryActive(state: StyleConfiguratorSt
  */
 export declare function rebasePaletteLibraryAuthority(state: StyleConfiguratorState, committedPalette: ResolvedPaletteSelection): StyleConfiguratorState;
 export declare function selectionSnapshotsEqual(a: SelectionSnapshot, b: SelectionSnapshot): boolean;
+export declare function typographyObjectsEqual(a: ThemeTypography, b: ThemeTypography): boolean;
 type ModernRuntimePaletteState = Extract<RuntimePaletteState, Readonly<{
     authority: 'curated';
 }>> | Extract<RuntimePaletteState, Readonly<{

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

@@ -1,12 +1,4 @@
 import type { PreviewSidebarTab } from '../../../../content-editor/src/index';
 export type { PreviewSidebarTab };
-export type PreviewDesignRow = 'header' | 'footer' | 'header-layout' | 'header-style' | 'footer-layout';
-export type PreviewSidebarOpenRequest = Readonly<{
-    tab: PreviewSidebarTab;
-    designRow?: PreviewDesignRow;
-}>;
-export declare function parsePreviewSidebarOpenRequestDetail(detail: unknown): PreviewSidebarOpenRequest;
 export declare function getPreviewSidebarTab(): PreviewSidebarTab;
 export declare function setPreviewSidebarTab(tab: PreviewSidebarTab): void;
-export declare function requestPreviewSidebarOpen(input: PreviewSidebarTab | PreviewSidebarOpenRequest): void;
-export declare function onPreviewSidebarOpenRequest(handler: (request: PreviewSidebarOpenRequest) => void): () => void;

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

@@ -1,5 +1,5 @@
 import { type CuratedSiteStyle } from '../../../../theme-core/src/site-styles/previewCompiler';
-import { type FooterLayoutId, type FooterLookId, type FooterSelectionContext, type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleId, type LookCustomizationWritePlan } from '../../../../theme-core/src/site-styles/index';
+import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleId, type LookCustomizationWritePlan } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot, StyleConfiguratorState } from './StyleConfigurator.state';
 export type SiteChromeLookOption<TId extends string | null> = Readonly<{
     id: TId;
@@ -25,17 +25,12 @@ export type SiteChromeLookModels = Readonly<{
         options: readonly SiteChromeLookOption<HeaderStyleId>[];
         renderedStyleId: HeaderStyleId;
     }>;
-    footerLayout: Readonly<{
-        options: readonly SiteChromeLookOption<FooterLayoutId>[];
-        renderedLayoutId: FooterLayoutId;
-    }>;
     footer: SiteChromeLookRowModel<FooterLookId>;
 }>;
 type SiteChromeLookModelInput = Readonly<{
     state: StyleConfiguratorState;
     siteStyle: CuratedSiteStyle;
     headerSelectionContext?: Partial<HeaderSelectionContext>;
-    footerSelectionContext?: Partial<FooterSelectionContext>;
 }>;
 export declare function buildSiteChromeLookModels(input: SiteChromeLookModelInput): SiteChromeLookModels;
 export declare function cycleSiteChromeLookId<TId extends string>(options: readonly SiteChromeLookOption<TId | null>[], currentId: TId | null, direction: 'prev' | 'next'): TId | null | undefined;
@@ -48,10 +43,6 @@ export type SiteChromeLookSelectionCommand = Readonly<{
     surface: 'footer';
     lookId: FooterLookId | null;
 }>;
-export type SiteChromeFooterLayoutSelectionCommand = Readonly<{
-    layoutId: FooterLayoutId;
-    currentLookId: FooterLookId;
-}>;
 export type SiteChromeLookSelectionPlan = Readonly<{
     kind: 'header';
     writePlan: LookCustomizationWritePlan<HeaderLookId>;
@@ -62,5 +53,4 @@ export type SiteChromeLookSelectionPlan = Readonly<{
     next: Pick<SelectionSnapshot, 'footerLookId'>;
 }>;
 export declare function planSiteChromeLookSelection(command: SiteChromeLookSelectionCommand): SiteChromeLookSelectionPlan;
-export declare function planSiteChromeFooterLayoutSelection(command: SiteChromeFooterLayoutSelectionCommand): FooterLookId | undefined;
 export {};

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

@@ -16,10 +16,6 @@ export type SiteChromeQuickControlHistoryEntry = Readonly<{
     kind: 'footer-look';
     previous: FooterLookId | null;
     next: FooterLookId | null;
-}> | Readonly<{
-    kind: 'footer-layout';
-    previous: FooterLookId | null;
-    next: FooterLookId | null;
 }> | Readonly<{
     kind: 'header-background';
     previous: SiteChromeBackgroundOverride;
@@ -110,7 +106,7 @@ export type SiteChromeQuickControlHistoryFailure = Readonly<{
     kind: 'retryable' | 'stale';
     message: string;
 }>;
-export type SiteChromeQuickControlSelectionTarget = 'header-layout' | 'header-style' | 'footer-layout' | 'footer-look';
+export type SiteChromeQuickControlSelectionTarget = 'header-layout' | 'header-style' | 'footer-look';
 export type SiteChromeQuickControlBrandTarget = 'header-brand-display' | 'header-logo-size';
 export type SiteChromeQuickControlNavTarget = 'header-menu-font' | 'header-menu-font-size';
 export type SiteChromeQuickControlBackgroundTarget = 'header-background' | 'footer-background';

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

@@ -1,6 +1,6 @@
 import type { APIEndpoints } from '../../../../api/src/index';
 import type { Theme } from '../../../../blocks/src/index';
-import type { FooterSelectionContext, HeaderNavPreferences, HeaderSelectionContext, SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
+import type { HeaderNavPreferences, HeaderSelectionContext, SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { CuratedSiteStyle } from '../../../../theme-core/src/site-styles/previewCompiler';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 import { type SiteStylePreviewPlan } from './siteStylePreviewPlanner';
@@ -18,7 +18,6 @@ export type BuildSiteChromeSavePlanInput = Readonly<{
     selection: SelectionSnapshot;
     baseTheme: Theme | null | undefined;
     headerSelectionContext: Partial<HeaderSelectionContext> | undefined;
-    footerSelectionContext: Partial<FooterSelectionContext> | undefined;
     headerBrandPreferences: HeaderBrandPreferences;
     headerNavPreferences: HeaderNavPreferences;
     backgroundPreferences: SiteChromeBackgroundPreferences;
@@ -26,6 +25,6 @@ export type BuildSiteChromeSavePlanInput = Readonly<{
     selectionId: string | null;
     baseSelectionUpdatedAt: string | null;
 }>;
-export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerSelectionContext, footerSelectionContext, headerBrandPreferences, headerNavPreferences, backgroundPreferences, themeId, selectionId, baseSelectionUpdatedAt, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
+export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerSelectionContext, headerBrandPreferences, headerNavPreferences, backgroundPreferences, themeId, selectionId, baseSelectionUpdatedAt, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
 export declare function siteChromeSavePlanBodyForBaseRevision(plan: SiteChromeSavePlan, baseSelectionUpdatedAt: string | null): SaveSiteChromeLookSelectionBody;
 export {};

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

@@ -1,12 +1,12 @@
 import type { Theme } from '../../../../blocks/src/index';
-import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
+import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
 import { type CompleteResolvedPaletteSelection } from '../../../../theme-core/src/palette/index';
-import type { FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
+import type { FooterLookId, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
 import { compileSiteThemeFromSelections, type CuratedSiteStyle, type SelectionFallbackWarning, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
 import type { PaletteSelectionSnapshot } from './StyleConfigurator.state';
 export type SiteStylePreviewSelection = Readonly<{
     siteStyleId: SiteStyleId;
-    buttonPersonalityId: ButtonPersonalityId;
+    buttonStyleSelection: ButtonStyleSelection;
     palette: PaletteSelectionSnapshot;
     typography: Theme['typography'];
     headerLayoutId?: HeaderLayoutId | null;
@@ -29,7 +29,6 @@ export type SiteStylePreviewPlanInput = Readonly<{
     selection: SiteStylePreviewSelection;
     baseTheme?: Theme | null;
     headerSelectionContext?: Partial<HeaderSelectionContext>;
-    footerSelectionContext?: Partial<FooterSelectionContext>;
 }>;
 export declare function planSiteStylePreviewChange(input: SiteStylePreviewPlanInput): SiteStylePreviewPlan;
 export declare function resolvedPaletteForPreview(palette: PaletteSelectionSnapshot, siteStyle: CuratedSiteStyle): CompleteResolvedPaletteSelection;

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

@@ -20,7 +20,7 @@ export type ApplySiteStyleSelectionBodyBuildResult = Readonly<{
     ok: false;
     error: Extract<PaletteApplyCommandPlan, {
         ok: false;
-    }>['error'];
+    }>['error'] | 'no-selection-changes';
 }>;
 export declare function buildApplySiteStyleSelectionBody(input: Readonly<{
     base: SelectionSnapshot;