@riverbankcms/sdk 0.109.0 → 0.118.0

package/dist/_dts/editor/src/index.d.ts

@@ -22,7 +22,7 @@ export type { RichTextRoutableItem } from './primitives/rich-text/toolbar/linkPo
 export { useRichTextEditor } from './primitives/rich-text/useRichTextEditor';
 export { buildRichTextImageAttrs, getRichTextImagePositionFromTarget, getSelectedRichTextImagePosition, insertOrReplaceRichTextImage, } from './primitives/rich-text/imageActions';
 export type { PickedRichTextImage } from './primitives/rich-text/imageActions';
-export { EMPTY_DOC, isDocEmpty, normaliseDoc, } from './primitives/rich-text/utils';
+export { EMPTY_DOC, isDocEmpty, parseRichTextDoc, } from './primitives/rich-text/utils';
 export { formatUnsupportedRichTextSummary, hasUnsupportedRichTextContent, sanitizeRichTextContentForSchema, } from './primitives/rich-text/sanitize';
 export type { RichTextContentWarnings } from './primitives/rich-text/sanitize';
 export { EditorContent } from '@tiptap/react';

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

@@ -1,3 +1,5 @@
+import { type RichTextDoc } from '../../../../blocks/src/system/manifest/richTextSchema';
+export type { RichTextDoc } from '../../../../blocks/src/system/manifest/richTextSchema';
 export interface TextNode {
     type: 'text';
     text: string;
@@ -11,10 +13,6 @@ export interface ContentNode {
     content?: Array<TextNode | ContentNode>;
     [key: string]: unknown;
 }
-export interface RichTextDoc {
-    type: 'doc';
-    content: ContentNode[];
-}
 export declare const EMPTY_DOC: RichTextDoc;
 export declare function isDocEmpty(doc: unknown): boolean;
-export declare function normaliseDoc(doc: unknown): RichTextDoc;
+export declare function parseRichTextDoc(doc: unknown): RichTextDoc;

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

@@ -44,7 +44,7 @@ export type BlockEditorProps = {
     siteId: string;
     dashboardBaseUrl?: string | null;
     owner: BlockEditorOwner;
-    blocks: BlockItem[];
+    blocks: readonly BlockItem[];
     recoveryConflictBlockIds?: readonly string[];
     recoveryConflictReviewRequestId?: number | null;
     uiStore: StoreApi<UiState>;

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

@@ -23,7 +23,8 @@ type BlockCardStore = UiStore<Pick<UiSlice, 'activeBlockId' | 'setActiveBlockId'
     drafts: Pick<DraftsSlice, 'getBlockSnapshot' | 'getCurrentValues' | 'getAtPath' | 'setAtPath' | 'edit' | 'initNewBlock' | 'updateBlockBaseline' | 'clearError'>;
     arrayKeys: ArrayKeysManager;
 } & GeneratedIconApplyState>;
-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, actionPresentation, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, }: {
+export declare function BlockCard({ interactionReady, siteId, block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onCollapsedChange, highlighted, hasRecoveryConflict, focusSignal, onFocusHandled, onBlockSave, theme, widgetOverrides, uiStore, hideThemeV2RawStyleFields, pageDesignBlock, reorderControlMode, actionPresentation, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, }: {
+    interactionReady: boolean;
     siteId: string;
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];

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

@@ -12,7 +12,8 @@ type BlockCardHeaderStore = UiStore<GeneratedIconApplyState & {
     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, reorderControlMode, actionPresentation, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, }: {
+export declare function BlockCardHeader({ interactionReady, block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, reorderControlMode, actionPresentation, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, }: {
+    interactionReady: boolean;
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
     isFirst: boolean;

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

@@ -0,0 +1,15 @@
+import { type EditorBlockBaselineInput, type EditorBlockId, type EditorDraftBlockBaselineUpdateMetaInput, type EditorDraftBlockInitMetaInput } from '../../../core/src/index';
+import type { BlockItem } from './types';
+export type BlockFieldExtensions = Readonly<Record<string, {
+    fields?: ReadonlyArray<{
+        id: string;
+        defaultValue?: unknown;
+    }>;
+}>>;
+export type BlockDraftBaselineSeed = Readonly<{
+    blockId: EditorBlockId;
+    baseline: EditorBlockBaselineInput;
+    initMeta: EditorDraftBlockInitMetaInput;
+    refreshMeta: EditorDraftBlockBaselineUpdateMetaInput;
+}>;
+export declare function buildBlockDraftBaselineSeed(block: BlockItem, index: number, blockFieldExtensions?: BlockFieldExtensions | null): BlockDraftBaselineSeed | null;

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

@@ -1,5 +1,6 @@
 import { type EditorBlockId, type EditorBlockBaselineInput, type EditorDraftBlockBaselineUpdateMetaInput, type EditorDraftBlockInitMetaInput } from '../../../../core/src/index';
 import type { BlockItem } from '../types';
+import { type BlockFieldExtensions } from '../blockDraftBaselineSeed';
 type DraftsSlice = {
     getBlockSnapshot: (blockId: EditorBlockId) => {
         id: EditorBlockId;
@@ -18,13 +19,8 @@ type UiStore = {
 };
 export declare function useBlockBaselineSync({ enabled, blockList, blockFieldExtensions, uiStore, }: {
     enabled: boolean;
-    blockList: BlockItem[];
-    blockFieldExtensions?: Readonly<Record<string, {
-        fields?: ReadonlyArray<{
-            id: string;
-            defaultValue?: unknown;
-        }>;
-    }>> | null;
+    blockList: readonly BlockItem[];
+    blockFieldExtensions?: BlockFieldExtensions | null;
     uiStore: UiStore | null;
 }): void;
 export {};

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

@@ -9,6 +9,18 @@ type UiStore = {
         };
     };
 };
+export declare function buildDuplicatedBlockItem(input: Readonly<{
+    createdBlock: BlockItem;
+    copiedContent: Record<string, unknown> | null;
+    persistedCopy: Readonly<{
+        data: unknown;
+        optimistic_hash?: string | null;
+    }> | null;
+    orderIndex: number;
+}>): BlockItem;
+export declare function requirePersistedDuplicateRevision(owner: BlockEditorOwner, persistedCopy: Readonly<{
+    optimistic_hash?: string | null;
+}>): string | null;
 export declare function useBlockDuplication({ allowCreation, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, triggerFocus, setErrorMessage, uiStore, onStructuralRevisionChange, }: {
     allowCreation: boolean;
     apiClient: ApiClient;

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;
+    purpose?: string | null;
     optimisticHash?: string | null;
 };
 export type DraftBlockSnapshot = EditorStructuralDraftSnapshot;

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

@@ -1,3 +1,3 @@
 import type { BlockItem } from './types';
-export declare const normalizeBlockListInitial: (items: BlockItem[]) => BlockItem[];
+export declare const normalizeBlockListInitial: (items: readonly BlockItem[]) => BlockItem[];
 export declare const reindexBlockList: (items: BlockItem[]) => BlockItem[];

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

@@ -4,7 +4,8 @@ export type { BlockEditorOwner } from './block-editor/owner';
 export { createCustomBlockRegistry, mergeBlockDescriptorsWithRegistry, mergeBlockDescriptors, getBlockManifestFromSdkConfig, transformSdkBlockToManifest, transformSdkBlockToDefinition, transformToBlockDescriptor, } from './block-editor/sdkBlockMerger';
 export type { CustomBlockManifestSource, CustomBlockRegistry, CustomBlockRegistryEntry, ResolvedCustomBlockManifest, SdkCustomBlock, SdkConfigForBlockPicker, } from './block-editor/sdkBlockMerger';
 export type { BlockEditorHandle, BlockFocusRequest, BlockFocusTarget, BlockItem, } from './block-editor/types';
-export { useBlockListContext, useBlockListContextOptional, BlockListProvider } from './block-editor/BlockListContext';
+export { buildBlockDraftBaselineSeed, type BlockDraftBaselineSeed, type BlockFieldExtensions, } from './block-editor/blockDraftBaselineSeed';
+export { useBlockListContext, useBlockListContextOptional, BlockListProvider, } from './block-editor/BlockListContext';
 export type { BlockListContextValue } from './block-editor/BlockListContext';
 export { BlockThumbnail } from './block-editor/BlockThumbnail';
 export type { BlockThumbnailProps } from './block-editor/BlockThumbnail';
@@ -13,14 +14,14 @@ export { BlockForm } from './BlockForm';
 export { FormProvider } from './FormProvider';
 export type { FormProviderProps } from './FormProvider';
 export { buildBlockContentPayload, formatManifestIssues } from './blockPayload';
-export type { BlockContentPayloadResult, ManifestFieldIssue, BuildBlockContentPayloadOptions } from './blockPayload';
+export type { BlockContentPayloadResult, ManifestFieldIssue, BuildBlockContentPayloadOptions, } from './blockPayload';
 export { deriveBlockDraftSaveability, formatUnfinishedBlocksSummary, shouldShowBlockFieldValidation, unfinishedBlockCopy, validateBlockManifestValues, } from '../../block-form/src/client/index';
-export type { BlockDraftSaveability, BlockDraftValidationIssue } from '../../block-form/src/client/index';
+export type { BlockDraftSaveability, BlockDraftValidationIssue, } from '../../block-form/src/client/index';
 export { applyManifestIssuesToForm } from './manifestIssues';
 export { BlockPickerDialog } from './block-editor/BlockPickerDialog';
 export { FileField, MediaField } from './media/MediaField';
 export { hideThemeV2RawStyleFields, prepareBlockEditorManifest, } from './block-editor/preparedManifest';
-export { stripTopLevelRoutingUi, } from './block-editor/settingsIntent';
+export { stripTopLevelRoutingUi } from './block-editor/settingsIntent';
 export * from './widgets/index';
-export { createBlockFormLogger, setBlockFormLoggerFactory, setBlockFormAppLogger } from './block-form/debug';
+export { createBlockFormLogger, setBlockFormLoggerFactory, setBlockFormAppLogger, } from './block-form/debug';
 export type { BlockFormLogger } from './block-form/debug';

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/editor-blocks/src/widgets/rich-text/RichTextField.d.ts

@@ -1,6 +1,6 @@
-import type { Content } from '@tiptap/react';
 import type { FieldWidgetProps } from '../../../../block-form/src/client/index';
 import type { RichTextFieldConfig } from '../../../../block-form/src/client/index';
-type RichTextValue = Content;
+import { type RichTextDoc } from '../../../../blocks/src/system/manifest/richTextSchema';
+type RichTextValue = RichTextDoc;
 export declare function RichTextField({ path, backend, config, }: FieldWidgetProps<RichTextValue, RichTextFieldConfig>): import("react").JSX.Element;
 export {};

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

@@ -0,0 +1,104 @@
+import type { SiteId } from '../../core/src/index';
+import type { MediaIdentifier } from './identifiers';
+export type ContentFieldPathSegment = string | number;
+export type ContentFieldPath = readonly ContentFieldPathSegment[];
+export type ContentMediaType = 'image' | 'video' | 'audio' | 'document' | 'spreadsheet' | 'archive';
+export type AllowedContentMediaTypes = readonly [
+    ContentMediaType,
+    ...ContentMediaType[]
+];
+export type ContentMediaAuditContext = Readonly<{
+    source: 'database' | 'backup' | 'snapshot';
+    table: string;
+    recordId: string;
+    siteId: SiteId;
+    ownerKind: string;
+    stage: string | null;
+    schemaKey: string;
+}>;
+export type ContentMediaAuditField = Readonly<{
+    kind: 'media';
+    id: string;
+    allowedMediaTypes: AllowedContentMediaTypes;
+}> | Readonly<{
+    kind: 'object';
+    id: string;
+    fields: readonly ContentMediaAuditField[];
+}> | Readonly<{
+    kind: 'repeater';
+    id: string;
+    mode: 'fields';
+    fields: readonly ContentMediaAuditField[];
+}> | Readonly<{
+    kind: 'repeater';
+    id: string;
+    mode: 'variants';
+    variants: readonly Readonly<{
+        typeId: string;
+        fields: readonly ContentMediaAuditField[];
+    }>[];
+    discriminator?: string;
+}>;
+type LocatedFinding = Readonly<{
+    context: ContentMediaAuditContext;
+    path: ContentFieldPath;
+    valueSummary: string;
+}>;
+export type LegacyStringContentMediaFinding = LocatedFinding & Readonly<{
+    tag: 'legacy-string';
+    originalValue: string;
+    expectedMediaType: ContentMediaType;
+    allowedMediaTypes: AllowedContentMediaTypes;
+}>;
+export type ContentMediaAuditFinding = LegacyStringContentMediaFinding | (LocatedFinding & Readonly<{
+    tag: 'blank-string';
+    expectedMediaType: ContentMediaType;
+}>) | (LocatedFinding & Readonly<{
+    tag: 'malformed-object';
+    expectedMediaType: ContentMediaType;
+}>) | (LocatedFinding & Readonly<{
+    tag: 'missing-schema';
+}>);
+export type ContentMediaAuditInput = Readonly<{
+    context: ContentMediaAuditContext;
+    data: unknown;
+    fields: readonly ContentMediaAuditField[] | null;
+}>;
+export type LegacyMediaAssetCandidate = Readonly<{
+    siteId: SiteId;
+    identifier: MediaIdentifier;
+    mediaType: ContentMediaType;
+    legacyValues: readonly string[];
+    active: boolean;
+}>;
+export type ResolvedLegacyMediaMapping = Readonly<{
+    finding: LegacyStringContentMediaFinding;
+    identifier: MediaIdentifier;
+    mediaType: ContentMediaType;
+}>;
+export type LegacyMediaResolutionError = Readonly<{
+    tag: 'missing-asset';
+    finding: LegacyStringContentMediaFinding;
+}> | Readonly<{
+    tag: 'ambiguous-asset';
+    finding: LegacyStringContentMediaFinding;
+    identifiers: readonly MediaIdentifier[];
+}> | Readonly<{
+    tag: 'kind-mismatch';
+    finding: LegacyStringContentMediaFinding;
+    identifier: MediaIdentifier;
+    actualMediaType: ContentMediaType;
+}>;
+export type LegacyMediaResolutionResult = Readonly<{
+    ok: true;
+    value: ResolvedLegacyMediaMapping;
+}> | Readonly<{
+    ok: false;
+    error: LegacyMediaResolutionError;
+}>;
+export declare function formatContentFieldPath(path: ContentFieldPath): string;
+export declare function summarizeContentMediaValue(value: unknown): string;
+export declare function auditContentMediaValues(input: ContentMediaAuditInput): readonly ContentMediaAuditFinding[];
+export declare function resolveLegacyMediaFinding(finding: LegacyStringContentMediaFinding, assets: readonly LegacyMediaAssetCandidate[]): LegacyMediaResolutionResult;
+export declare function resolveLegacyMediaFindings(findings: readonly ContentMediaAuditFinding[], assets: readonly LegacyMediaAssetCandidate[]): readonly LegacyMediaResolutionResult[];
+export {};

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

@@ -0,0 +1,8 @@
+import { type AllowedContentMediaTypes, type ContentMediaAuditField } from './contentMediaAudit';
+/**
+ * Adapts content-type schemas and block manifests into the dependency-neutral
+ * field tree consumed by the pure audit walker. Unknown field kinds are ignored.
+ */
+export declare function adaptContentMediaAuditFields(schemaOrFields: unknown, options?: Readonly<{
+    defaultFileKinds?: AllowedContentMediaTypes;
+}>): readonly ContentMediaAuditField[] | null;

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

@@ -0,0 +1,22 @@
+import { type ContentMediaAuditContext, type ContentMediaAuditFinding, type LegacyMediaResolutionResult } from './contentMediaAudit';
+export type ContentMediaAuditSnapshotRecord = Readonly<Record<string, unknown>>;
+export type ContentMediaAuditSnapshot = Readonly<{
+    contentVersions: readonly ContentMediaAuditSnapshotRecord[];
+    contentEntries: readonly ContentMediaAuditSnapshotRecord[];
+    contentTypes: readonly ContentMediaAuditSnapshotRecord[];
+    blocks: readonly ContentMediaAuditSnapshotRecord[];
+    customBlocks: readonly ContentMediaAuditSnapshotRecord[];
+    pageSurfaces: readonly ContentMediaAuditSnapshotRecord[];
+    mediaAssets: readonly ContentMediaAuditSnapshotRecord[];
+    sites?: readonly ContentMediaAuditSnapshotRecord[];
+    contentTemplates?: readonly ContentMediaAuditSnapshotRecord[];
+    contentTemplateBlocks?: readonly ContentMediaAuditSnapshotRecord[];
+    footerBlocks?: readonly ContentMediaAuditSnapshotRecord[];
+}>;
+export type ContentMediaAuditReport = Readonly<{
+    findings: readonly ContentMediaAuditFinding[];
+    resolutions: readonly LegacyMediaResolutionResult[];
+    counts: Readonly<Record<string, number>>;
+}>;
+export type ContentMediaAuditManifestMap = ReadonlyMap<string, unknown>;
+export declare function auditContentMediaSnapshot(snapshot: ContentMediaAuditSnapshot, source: ContentMediaAuditContext['source'], builtInManifests: ContentMediaAuditManifestMap): ContentMediaAuditReport;

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

@@ -44,4 +44,6 @@ export * from './richTextImageWriteNormalizer';
 export * from './mediaUsageProjection';
 export * from './portableMediaReferences';
 export * from './renderableMediaAsset';
-export * from './legacyMediaValue';
+export * from './contentMediaAudit';
+export * from './contentMediaAuditFieldAdapter';
+export * from './contentMediaSnapshotAudit';

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 {};