@riverbankcms/sdk 0.104.3 → 0.107.0

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/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/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/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>;
@@ -72,4 +66,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, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;

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,11 @@ export type PreviewShellProps = {
     supabaseUrl?: string;
     themeRuntime?: PreviewThemeRuntime;
     designEditorEligibility?: PreviewDesignEditorEligibility;
+    /** Hides site-style controls for runtimes without palette authority. */
+    hideSiteStyleConfigurator?: boolean;
     baseFetch?: BaseFetch;
 };
-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, }: 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>;
@@ -52,4 +46,4 @@ export type PreviewShellLayoutProps = {
     themeRuntime?: PreviewThemeRuntime;
     siteStyleAccess?: SiteStyleAccess;
 };
-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, }: 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>>;

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

@@ -2,10 +2,10 @@ 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 CuratedPaletteId, type PaletteOverrides, type RuntimePaletteState } from '../../../../theme-core/src/palette/index';
-import { type FooterSelectionContext, type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleId, type TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
+import { type FooterSelectionContext, 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;
     apiClient: ApiClient;
@@ -19,14 +19,9 @@ export type StyleConfiguratorProps = Readonly<{
         selectionVersion?: number | null;
         selectionUpdatedAt?: string | null;
         buttonPersonalityId: ButtonPersonalityId | null;
-        runtimePaletteState?: RuntimePaletteState | null;
-        paletteVariantId?: CuratedPaletteId | null;
-        paletteOverrides?: PaletteOverrides | null;
+        runtimePaletteState: 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>>;
@@ -37,6 +32,7 @@ export type StyleConfiguratorProps = Readonly<{
         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, siteStyleAccess, }: StyleConfiguratorProps): React.JSX.Element;
+export declare function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, footerSelectionContext, expandedRowRequest, onFocusedSurfaceChange, siteStyleAccess, }: StyleConfiguratorProps): React.JSX.Element;

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

@@ -12,8 +12,8 @@
  */
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
 import type { Theme } from '../../../../blocks/src/index';
-import type { CuratedPaletteId, PaletteColors, PaletteMode, RuntimePaletteState, SitePaletteId, SitePaletteVersion } from '../../../../theme-core/src/palette/index';
-import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderStyleId, type TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
+import type { 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';
 import type { SelectionFallbackWarning, SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
 import { type EditorStagedSessionCapabilities, type EditorStagedSessionState } from '../../../../content-editor/src/editorTransactionState';
 export type StyleConfiguratorSaveStatus = Readonly<{
@@ -25,6 +25,7 @@ export type StyleConfiguratorSaveStatus = Readonly<{
 }> | Readonly<{
     kind: 'failed';
     message: string;
+    failureKind: 'retryable' | 'stale';
 }>;
 export type StyleConfiguratorExpandedRow = 'style' | 'header-layout' | 'header-style' | 'footer-layout' | 'footer' | 'buttons' | 'typography' | 'palette' | 'colours' | null;
 /**
@@ -37,20 +38,6 @@ export type StyleConfiguratorNotice = never;
 type ThemeTypography = Theme['typography'];
 type BodyTypography = ThemeTypography['body'];
 type HeadingTypography = ThemeTypography['headings']['default'];
-export type TypographySelectionSnapshot = Readonly<{
-    kind: 'preset';
-    presetId: TypographyPresetId | null;
-    bodyFontOverride: string | null;
-    headingFontOverride: string | null;
-}> | Readonly<{
-    kind: 'custom';
-    typography: ThemeTypography;
-}>;
-export type TypographySelectionFlatFields = Readonly<{
-    typographyPresetId: TypographyPresetId | null;
-    typographyBodyFontOverride: string | null;
-    typographyHeadingFontOverride: string | null;
-}>;
 export type TypographyDraftPatch = Readonly<{
     kind: 'heading';
     patch: Partial<HeadingTypography>;
@@ -61,24 +48,41 @@ export type TypographyDraftPatch = Readonly<{
     kind: 'scale';
     scale: ThemeTypography['scale'];
 }>;
+/** Runtime authority is deliberately separate from the editable core state. */
 export type PaletteSelectionSnapshot = Readonly<{
-    kind: 'migrated-curated';
-    paletteId: CuratedPaletteId;
+    kind: 'available';
+    editor: PaletteEditorState;
+}> | Readonly<{
+    kind: 'invalid';
+    reason: PaletteAuthorityError;
+}>;
+export type PaletteAuthorityError = Extract<RuntimePaletteState, {
+    kind: 'invalid';
+}>['reason'] | 'runtime-curated-palette-missing' | 'runtime-curated-palette-mismatch' | 'invalid-active-site-palette-version';
+/** Read-only UI projection. It intentionally owns no palette transitions. */
+export type PalettePreviewProjection = Readonly<{
+    kind: 'curated';
+    valueKey: KnownCuratedPaletteValueKey;
+    colors: PaletteColors;
+    mode: PaletteMode;
+}> | Readonly<{
+    kind: 'curated-fork';
+    sourceValueKey: KnownCuratedPaletteValueKey;
     colors: PaletteColors;
     mode: PaletteMode;
 }> | Readonly<{
-    kind: 'migrated-site';
+    kind: 'site';
     paletteId: SitePaletteId;
     colors: PaletteColors;
     mode: PaletteMode;
     version: SitePaletteVersion;
 }> | Readonly<{
-    kind: 'legacy-unmigrated';
+    kind: 'new-site';
     colors: PaletteColors;
     mode: PaletteMode;
 }> | Readonly<{
     kind: 'invalid';
-    reason: string;
+    reason: PaletteAuthorityError;
 }>;
 export type SelectionSnapshot = Readonly<{
     siteStyleId: SiteStyleId;
@@ -90,7 +94,7 @@ export type SelectionSnapshot = Readonly<{
     footerLookId: FooterLookId | null;
     buttonPersonalityId: ButtonPersonalityId;
     palette: PaletteSelectionSnapshot;
-    typographySelection: TypographySelectionSnapshot;
+    typography: ThemeTypography;
 }>;
 type StyleConfiguratorTargetKey = 'design:site-style';
 export type StyleConfiguratorHistoryEntry = Readonly<{
@@ -100,6 +104,22 @@ export type StyleConfiguratorHistoryEntry = Readonly<{
     next: SelectionSnapshot;
 }>;
 export type StyleConfiguratorStagedSession = EditorStagedSessionState<SelectionSnapshot, StyleConfiguratorHistoryEntry, StyleConfiguratorTargetKey>;
+/**
+ * A collaborator selected a different active palette while this editor had an
+ * unsaved edit to the formerly active site palette. The base remains the
+ * server authority; the complete local draft remains available for an
+ * intentional retry or cancel.
+ */
+export type StyleConfiguratorStalePaletteConflict = Readonly<{
+    kind: 'active-palette-changed';
+    originalPaletteId: SitePaletteId;
+    localDraft: Readonly<{
+        paletteId: SitePaletteId;
+        expectedVersion: SitePaletteVersion;
+        colors: PaletteColors;
+        mode: PaletteMode;
+    }>;
+}>;
 export type StyleConfiguratorState = Readonly<{
     /**
      * Last persisted server snapshot. Updated on apply-success (and on
@@ -114,10 +134,7 @@ export type StyleConfiguratorState = Readonly<{
     saveStatus: StyleConfiguratorSaveStatus;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
     notices: ReadonlyArray<StyleConfiguratorNotice>;
-    paletteDrafts: Readonly<Partial<Record<CuratedPaletteId, Readonly<{
-        colors: PaletteColors;
-        mode: PaletteMode;
-    }>>>>;
+    stalePaletteConflict: StyleConfiguratorStalePaletteConflict | null;
     expandedRow: StyleConfiguratorExpandedRow;
     stagedSession: StyleConfiguratorStagedSession;
 }>;
@@ -144,33 +161,39 @@ export declare function previewButtonPersonality(state: 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;
-export declare function previewTypographyPreset(state: StyleConfiguratorState, typographyPresetId: TypographyPresetId): StyleConfiguratorState;
-export declare function setCustomTypography(state: StyleConfiguratorState, typography: ThemeTypography): StyleConfiguratorState;
+export declare function previewTypography(state: StyleConfiguratorState, typography: ThemeTypography): StyleConfiguratorState;
 export declare function applyTypographyDraftPatch(state: StyleConfiguratorState, currentTypography: ThemeTypography, patch: TypographyDraftPatch): StyleConfiguratorState;
 export declare function resetTypographyToSaved(state: StyleConfiguratorState): StyleConfiguratorState;
-export declare function previewCuratedPalette(state: StyleConfiguratorState, palette: Readonly<{
-    paletteId: CuratedPaletteId;
+export declare function previewCuratedPalette(state: StyleConfiguratorState, valueKey: KnownCuratedPaletteValueKey): StyleConfiguratorState;
+export declare function previewSitePalette(state: StyleConfiguratorState, palette: Readonly<{
+    paletteId: SitePaletteId;
     colors: PaletteColors;
     mode: PaletteMode;
+    version: SitePaletteVersion;
 }>): StyleConfiguratorState;
+/** Starts a manual palette from the active complete palette, never sparse overrides. */
+export declare function createPalette(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function setPaletteColors(state: StyleConfiguratorState, colors: PaletteColors): StyleConfiguratorState;
 /**
  * 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
  * previous selection is not offered for the new style, or a different palette
- * if the persisted palette ID is no longer known.
+ * 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'> & TypographySelectionFlatFields;
-    typographySelection?: TypographySelectionSnapshot;
+    resolved: Pick<SelectionSnapshot, 'buttonPersonalityId' | 'headerLayoutId' | 'headerStyleId' | 'headerLookId' | 'typography'>;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>): StyleConfiguratorState;
 export declare function cancelPreview(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function markApplySaving(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function markApplySaved(state: StyleConfiguratorState, persisted: SelectionSnapshot): StyleConfiguratorState;
 export declare function markApplyFailed(state: StyleConfiguratorState, message: string, failureKind?: 'retryable' | 'stale'): StyleConfiguratorState;
+/** Advances a stale site's CAS token only for the user's explicit retry. */
+export declare function prepareStalePaletteRetry(state: StyleConfiguratorState, input?: Readonly<{
+    sitePalettes: readonly SitePalette[];
+}>): StyleConfiguratorState;
 export declare function toggleRow(state: StyleConfiguratorState, row: StyleConfiguratorExpandedRow): StyleConfiguratorState;
 export declare function dismissWarnings(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function dismissNotices(state: StyleConfiguratorState): StyleConfiguratorState;
@@ -180,16 +203,31 @@ export declare function dismissNotices(state: StyleConfiguratorState): StyleConf
  * changes the persisted selection out-of-band.
  */
 export declare function syncStyleConfiguratorState(state: StyleConfiguratorState, base: SelectionSnapshot): StyleConfiguratorState;
+/** Reconciles typed palette-library authority with the editor's saved base. */
+export declare function reconcilePaletteLibraryActive(state: StyleConfiguratorState, active: PaletteLibraryAuthority, sitePalettes: readonly SitePalette[]): StyleConfiguratorState;
+/**
+ * A palette-library response only refreshes palette authority. Unlike a full
+ * server snapshot, it must never discard the user's staged site-style work.
+ * Site drafts keep their complete local colours/mode and rebase their expected
+ * version when the same palette was changed elsewhere.
+ */
+export declare function rebasePaletteLibraryAuthority(state: StyleConfiguratorState, committedPalette: ResolvedPaletteSelection): StyleConfiguratorState;
 export declare function selectionSnapshotsEqual(a: SelectionSnapshot, b: SelectionSnapshot): boolean;
-export declare function typographySelectionSnapshotFromFlat(input: Readonly<{
-    typographyPresetId?: TypographyPresetId | null;
-    typographyBodyFontOverride?: string | null;
-    typographyHeadingFontOverride?: string | null;
-    theme?: Theme | null;
-}>): TypographySelectionSnapshot;
-export declare function typographySelectionFlatFields(selection: TypographySelectionSnapshot): TypographySelectionFlatFields;
-export declare function customTypographyForSelection(selection: TypographySelectionSnapshot): ThemeTypography | null;
-export declare function typographySelectionsEqual(a: TypographySelectionSnapshot, b: TypographySelectionSnapshot): boolean;
-export declare function paletteSelectionSnapshotFromRuntime(runtime: RuntimePaletteState | null | undefined): PaletteSelectionSnapshot;
+type ModernRuntimePaletteState = Extract<RuntimePaletteState, Readonly<{
+    authority: 'curated';
+}>> | Extract<RuntimePaletteState, Readonly<{
+    authority: 'site';
+}>> | Extract<RuntimePaletteState, Readonly<{
+    kind: 'invalid';
+}>>;
+export declare function paletteSelectionSnapshotFromRuntime(runtime: ModernRuntimePaletteState): PaletteSelectionSnapshot;
+export declare function paletteSelectionSnapshotFromComplete(input: Readonly<{
+    selection: PaletteSelection;
+    colors: PaletteColors;
+    mode: PaletteMode;
+    version?: SitePaletteVersion;
+}>): PaletteSelectionSnapshot;
 export declare function paletteSelectionSnapshotsEqual(left: PaletteSelectionSnapshot, right: PaletteSelectionSnapshot): boolean;
+export declare function palettePreviewProjection(palette: PaletteSelectionSnapshot): PalettePreviewProjection;
+export declare function committedPaletteForSnapshot(palette: PaletteSelectionSnapshot): ResolvedPaletteSelection | null;
 export {};