@riverbankcms/sdk 0.152.0 → 0.154.0

package/dist/_dts/media-editor/src/editorMediaState.d.ts

@@ -0,0 +1,29 @@
+import { type ManagedMediaResolution, type RenderableMediaAssetIndex } from '../../media-core/src/index';
+import type { MediaValue } from './types';
+import { type CropEditorSource } from './cropEditorSource';
+type EditorMediaResolution = ManagedMediaResolution<MediaValue>;
+type IneligibleCrop = Readonly<{
+    kind: 'ineligible';
+}>;
+export type EditorMediaState = Readonly<{
+    resolution: undefined;
+    crop: IneligibleCrop;
+}> | Readonly<{
+    resolution: Extract<EditorMediaResolution, {
+        kind: 'missing';
+    }>;
+    crop: IneligibleCrop | Readonly<{
+        kind: 'missing';
+    }>;
+}> | Readonly<{
+    resolution: Extract<EditorMediaResolution, {
+        kind: 'resolved';
+    }>;
+    crop: IneligibleCrop | Readonly<{
+        kind: 'ready';
+        source: CropEditorSource;
+    }>;
+}>;
+/** Decide source availability and crop eligibility once for all editor consumers. */
+export declare function resolveEditorMediaState(reference: MediaValue | undefined, index: RenderableMediaAssetIndex | undefined): EditorMediaState;
+export {};

package/dist/_dts/media-editor/src/mediaSelection.d.ts

@@ -6,6 +6,5 @@ export type BuildPersistableMediaValueOptions = Readonly<{
     mediaKind: PersistableMediaValue['type'];
     previousValue: MediaValue | undefined;
     poster: MediaValue['poster'] | undefined;
-    publicUrl?: string;
 }>;
-export declare function buildPersistableMediaValue({ asset, mediaKind, previousValue, poster, publicUrl, }: BuildPersistableMediaValueOptions): PersistableMediaValue;
+export declare function buildPersistableMediaValue({ asset, mediaKind, previousValue, poster, }: BuildPersistableMediaValueOptions): PersistableMediaValue;

package/dist/_dts/media-editor/src/runtimeMediaAssetState.d.ts

@@ -1,13 +1,14 @@
 import type { MediaAssetIndexItem } from '../../blocks/src/index';
+import { indexRenderableMediaAssets } from '../../media-core/src/index';
 export type RuntimeMediaAssetState = Readonly<{
     siteId: string;
     baseAssets: readonly MediaAssetIndexItem[];
     registeredAssets: readonly MediaAssetIndexItem[];
+    mediaAssetIndex: ReturnType<typeof indexRenderableMediaAssets>;
 }>;
 export type RuntimeMediaAssetAction = Readonly<{
     type: 'siteSnapshotReplaced';
-    siteId: string;
-    baseAssets: readonly MediaAssetIndexItem[];
+    snapshot: RuntimeMediaAssetState;
 }> | Readonly<{
     type: 'assetRegistered';
     siteId: string;
@@ -16,8 +17,6 @@ export type RuntimeMediaAssetAction = Readonly<{
 export declare function createRuntimeMediaAssetState(siteId: string, baseAssets: readonly MediaAssetIndexItem[]): RuntimeMediaAssetState;
 export declare function reduceRuntimeMediaAssetState(state: RuntimeMediaAssetState, action: RuntimeMediaAssetAction): RuntimeMediaAssetState;
 /**
- * Returns a freshly deduped merge of base and runtime assets.
- * Callers should memoize the result if referential stability matters downstream.
+ * Returns the admitted list already owned by the current runtime index.
  */
 export declare function selectRuntimeMediaAssets(state: RuntimeMediaAssetState): readonly MediaAssetIndexItem[];
-export declare function createRuntimeMediaAssetSnapshotKey(siteId: string, assets: readonly MediaAssetIndexItem[]): string;

package/dist/_dts/media-editor/src/types.d.ts

@@ -6,6 +6,6 @@ export type MediaTransform = NonNullable<Media['transform']>;
  * Re-export the canonical block/media value shape so media-editor, editor-blocks,
  * and app consumers all speak the same content contract.
  */
-export type MediaValue = Media;
+export type MediaValue = PersistableMedia;
 /** A media editor output that satisfies the canonical block write contract. */
 export type PersistableMediaValue = PersistableMedia;

package/dist/_dts/media-editor/src/utils.d.ts

@@ -9,5 +9,4 @@ export declare const isAudioValue: (value: MediaValue | undefined) => boolean;
 export declare const isDocumentValue: (value: MediaValue | undefined) => boolean;
 export declare const isSpreadsheetValue: (value: MediaValue | undefined) => boolean;
 export declare const isArchiveValue: (value: MediaValue | undefined) => boolean;
-export declare const isSvgValue: (value: MediaValue | undefined) => boolean;
 export declare const buildPreviewParams: (value: MediaValue | undefined, targetAspectRatio?: number | string) => TransformParams;

package/dist/_dts/media-react/src/components/cropChangePolicy.d.ts

@@ -3,4 +3,7 @@ export type CropperChangePolicy = {
     markUserEdit: boolean;
     persistRect: boolean;
 };
-export declare function resolveCropperChangePolicy(origin: CropperChangeOrigin): CropperChangePolicy;
+export declare function resolveCropperChangePolicy(input: Readonly<{
+    origin: CropperChangeOrigin;
+    hasUserEdits: boolean;
+}>): CropperChangePolicy;

package/dist/_dts/media-react/src/components/cropGeometry.d.ts

@@ -49,3 +49,4 @@ export declare function clampCropperCoordinates(coords: CropperCoordinates, opti
 export declare function isSameCropperCoordinates(a: CropperCoordinates, b: CropperCoordinates): boolean;
 export declare function rotateHotspotForOutput(hotspot: ImageHotspot, rotation: RightAngleRotation): ImageHotspot;
 export declare function unrotateHotspotFromOutput(hotspot: ImageHotspot, rotation: RightAngleRotation): ImageHotspot;
+export declare function isCropperCoordinates(value: unknown): value is CropperCoordinates;

package/dist/_dts/media-react/src/components/useImageCropperController.d.ts

@@ -37,6 +37,7 @@ type UseImageCropperControllerResult = {
     };
     cropConstraintMessage?: string;
     handleCropChange: (cropper: CropperRef) => void;
+    beginCropInteraction: () => void;
     handleHotspotPointer: (event: ReactPointerEvent<HTMLDivElement>) => void;
     resetCrop: () => void;
 };

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

@@ -36,8 +36,9 @@ export declare function useArrangementToolbar(input: Readonly<{
     chooseBackground: (override: BackgroundOverride) => void;
     openField: (fieldPath: string) => void;
 }>): ArrangementToolbar | null;
-export declare function ArrangementControlsRow({ toolbar, blockTitle, popover, onToggleOptions, editButton, }: Readonly<{
+export declare function ArrangementControlsRow({ toolbar, blockName, blockTitle, popover, onToggleOptions, editButton, }: Readonly<{
     toolbar: ArrangementToolbar;
+    blockName: ReactNode;
     blockTitle: string;
     popover: CustomizePopoverController;
     onToggleOptions: (event: React.MouseEvent<HTMLElement>) => void;

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

@@ -5,7 +5,8 @@ import { type PreviewCustomizeSelectedImage } from './previewCustomizeSelectedMe
 type ChooseBackground = (override: BackgroundOverride, options?: Readonly<{
     selectedImage?: PreviewCustomizeSelectedImage;
 }>) => void;
-export declare function BackgroundChooser({ capability, current, imagePoolStatus, onChoose, }: {
+export declare function BackgroundChooser({ editingSlot, capability, current, imagePoolStatus, onChoose, }: {
+    editingSlot: string;
     capability: BackgroundCapability;
     current: BackgroundOverride;
     imagePoolStatus: 'idle' | 'loading' | 'loaded' | 'failed';

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

@@ -1,28 +1,27 @@
-import type { MediaAssetId } from '../../../../core/src/index';
 import type { Media } from '../../../../blocks/src/index';
+import { type RenderableMediaAssetIndex, type RenderableMediaAsset } from '../../../../media-core/src/index';
 import type { BackgroundImagePoolItem, BackgroundImagePoolMediaAsset, BackgroundOverride } from '../../../../blocks/src/system/customize/backgrounds';
-export type PreviewCustomizeRenderableImageSource = Readonly<{
-    id: MediaAssetId;
-    identifier?: string | null;
-    storageBucket?: string | null;
-    storagePath?: string | null;
+export type PreviewCustomizeRenderableImageSource = Omit<RenderableMediaAsset, 'width' | 'height'> & Readonly<{
     width?: number | null;
     height?: number | null;
-    mimeType?: string | null;
 }>;
 export type PreviewCustomizeSelectedImage = Readonly<{
-    mediaId: MediaAssetId;
+    reference: Extract<Media, {
+        type: 'image';
+    }>;
     imageAsset: BackgroundImagePoolMediaAsset;
 }>;
-export declare function selectedImageFromMediaValue(value: Media | undefined): PreviewCustomizeSelectedImage | null;
-export declare function selectedImageFromRenderableAsset(asset: PreviewCustomizeRenderableImageSource): PreviewCustomizeSelectedImage;
+export declare function selectedImageFromMediaValue(value: Media | undefined, index: RenderableMediaAssetIndex | undefined): PreviewCustomizeSelectedImage | null;
+export declare function selectedImageFromRenderableAsset(source: PreviewCustomizeRenderableImageSource): PreviewCustomizeSelectedImage;
 export declare function imagePoolWithSelectedImage(input: Readonly<{
     imagePool: readonly BackgroundImagePoolItem[];
     override: BackgroundOverride;
     selectedImage: PreviewCustomizeSelectedImage | undefined;
 }>): readonly BackgroundImagePoolItem[];
-export declare function selectedOrPooledImageAssetForMediaId(input: Readonly<{
+export declare function selectedOrPooledImageAssetForReference(input: Readonly<{
     imagePool: readonly BackgroundImagePoolItem[] | undefined;
-    mediaId: MediaAssetId;
+    reference: Extract<Media, {
+        type: 'image';
+    }>;
     selectedImage: PreviewCustomizeSelectedImage | undefined;
 }>): BackgroundImagePoolMediaAsset | undefined;

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

@@ -60,6 +60,7 @@ type PreviewShellCommonProps = {
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
     themeSelectionButtonStyleRepairs?: readonly ButtonStyleSelectionRepair[];
     themeSelectionHeaderPreferences?: import('../../../../theme-core/src/site-styles/index').HeaderPreferences | null;
+    themeSelectionFooterPreferences?: import('../../../../theme-core/src/site-styles/index').FooterPreferences | null;
     themeSelectionHeaderSelection?: HeaderLayoutStyleSelection | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderLogo?: HeaderLogoContext;

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

@@ -30,6 +30,7 @@ type PreviewShellLayoutCommonProps = {
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
     themeSelectionButtonStyleRepairs?: readonly ButtonStyleSelectionRepair[];
     themeSelectionHeaderPreferences?: import('../../../../theme-core/src/site-styles/index').HeaderPreferences | null;
+    themeSelectionFooterPreferences?: import('../../../../theme-core/src/site-styles/index').FooterPreferences | null;
     themeSelectionHeaderSelection?: HeaderLayoutStyleSelection | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderLogo?: HeaderLogoContext;

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

@@ -1,3 +1,4 @@
+import { type FooterPreferences } from '../../../../theme-core/src/site-styles/index';
 import React, { type ReactNode } from 'react';
 import { type ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
@@ -36,6 +37,7 @@ type SiteChromeCustomizeContextValue = Readonly<{
     setHeaderInteractionPalette: (value: HeaderInteractionPalettePreference) => void;
     cycleSurfaceBackground: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
     chooseSurfaceBackground: (surface: SiteChromeEditableSurfaceKind, override: SiteChromeBackgroundOverride) => void;
+    getFooterPreferences: () => FooterPreferences | null;
     siteStyleHistory: SiteStyleHistoryController;
     quickControlHistory: SiteChromeQuickControlHistoryController;
 }>;
@@ -45,6 +47,7 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
     apiClient: ApiClient;
     theme?: Theme | null;
     headerPreferences?: HeaderPreferences | null;
+    footerPreferences?: FooterPreferences | null;
     themeId?: string | null;
     selectionId?: string | null;
     selectionVersion?: number | null;
@@ -54,5 +57,5 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
     siteStyleAccess?: SiteStyleAccess;
     canOpenDesignEditor?: boolean;
 }>;
-export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, headerPreferences, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerLogoContext, siteStyleAccess, canOpenDesignEditor, }: SiteChromeCustomizeProviderProps): React.JSX.Element;
+export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, headerPreferences, footerPreferences, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerLogoContext, siteStyleAccess, canOpenDesignEditor, }: SiteChromeCustomizeProviderProps): React.JSX.Element;
 export declare function useSiteChromeCustomizeOptional(): SiteChromeCustomizeContextValue | null;

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

@@ -1,9 +1,11 @@
+import { type SiteChromeQuickControlSaveRequest } from './siteChromeQuickControlSaveRequest';
+import type { FooterPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { APIEndpoints } from '../../../../api/src/index';
 import type { Theme } from '../../../../blocks/src/index';
 import type { HeaderNavPreferences, HeaderLogoContext, HeaderPreferences, 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';
+import type { SiteStylePreviewPlan } from './siteStylePreviewPlanner';
 import type { SiteChromeEditableSurfaceKind } from './SiteChromeEditableSurface';
 import { type HeaderBrandPreferences } from './siteChromeBrandPreferences';
 type SaveSiteChromeSelectionBody = NonNullable<APIEndpoints['saveSiteChromeSelection']['body']>;
@@ -17,7 +19,7 @@ export type BuildSiteChromeSavePlanInput = Readonly<{
     surface: SiteChromeEditableSurfaceKind;
     siteStyle: CuratedSiteStyle;
     selection: SelectionSnapshot;
-    baseTheme: Theme | null | undefined;
+    baseTheme: Theme;
     headerLogoContext: HeaderLogoContext | undefined;
     headerBrandPreferences: HeaderBrandPreferences;
     headerNavPreferences: HeaderNavPreferences;
@@ -27,8 +29,9 @@ export type BuildSiteChromeSavePlanInput = Readonly<{
     baseSelectionUpdatedAt: string | null;
     /** Persisted intent, including the structural fields quick controls cannot edit. */
     persistedHeaderPreferences: HeaderPreferences;
+    persistedFooterPreferences: FooterPreferences;
 }>;
-export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerLogoContext, headerBrandPreferences, headerNavPreferences, backgroundPreferences, themeId, selectionId, baseSelectionUpdatedAt, persistedHeaderPreferences, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
+export declare function buildSiteChromeSavePlan(input: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
 /**
  * The nav half of the record the server persisted, read back rather than
  * re-derived from the saved bytes. The theme is compiled output from 4b
@@ -38,8 +41,8 @@ export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection,
  */
 export declare function headerNavPreferencesFromSiteChromeSaveResponse(saved: SaveSiteChromeSelectionResponse): HeaderNavPreferences;
 /**
- * The header half comes from the persisted record; the footer half has no
- * entry in `HeaderPreferences` and stays derived from the saved theme.
+ * Each surface comes from its own persisted record. Header absence retains
+ * the existing pre-backfill fallback; footer intent is always required.
  */
 export declare function backgroundPreferencesFromSiteChromeSaveResponse(saved: SaveSiteChromeSelectionResponse): SiteChromeBackgroundPreferences;
 /**
@@ -55,4 +58,23 @@ export declare function selectionSnapshotFromSiteChromeSaveResponse({ saved, fal
     fallback: SelectionSnapshot;
     savePlan: SiteChromeSavePlan;
 }>): SelectionSnapshot;
+/** Close record readiness and the targeted quick-control edit before running effects. */
+export declare function planSiteChromeQuickControlSave(input: Readonly<{
+    request: SiteChromeQuickControlSaveRequest;
+    currentSelection: SelectionSnapshot | null;
+    confirmedBrand: HeaderBrandPreferences;
+    confirmedNav: HeaderNavPreferences;
+    confirmedBackground: SiteChromeBackgroundPreferences;
+    footerPreferences: FooterPreferences | null;
+    compilation: Omit<BuildSiteChromeSavePlanInput, 'surface' | 'siteStyle' | 'selection' | 'headerBrandPreferences' | 'headerNavPreferences' | 'backgroundPreferences' | 'persistedFooterPreferences' | 'baseTheme'> & Readonly<{
+        baseTheme: Theme | null | undefined;
+    }>;
+}>): Readonly<{
+    kind: 'unavailable';
+}> | Readonly<{
+    kind: 'prepared';
+    previousSelection: SelectionSnapshot;
+    selection: SelectionSnapshot;
+    savePlan: SiteChromeSavePlan;
+}>;
 export {};

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

@@ -1,3 +1,4 @@
+import { type FooterPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { Theme } from '../../../../blocks/src/index';
 import { type ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
 import type { HeaderBrandPresentationPreference, FooterLookId, HeaderLayoutId, HeaderLogoContext, HeaderStyleId, SiteChromeSurface } from '../../../../theme-core/src/site-styles/index';
@@ -19,6 +20,7 @@ export type SiteStylePreviewPlan = Readonly<{
 type SiteStylePreviewPlanCommonInput = Readonly<{
     siteStyle: CuratedSiteStyle;
     selection: SiteStylePreviewSelection;
+    footerPreferences?: FooterPreferences;
     headerLogoContext?: HeaderLogoContext;
     /**
      * The row's brand-presentation mode, which the preview must honour or it

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

@@ -0,0 +1,12 @@
+export type ConfirmedPreferenceRecord<T> = Readonly<{
+    source: T;
+    value: T;
+}>;
+/** A refreshed row replaces confirmations made against the previous row. */
+export declare function refreshPreferenceRecord<T>(record: ConfirmedPreferenceRecord<T>, source: T): ConfirmedPreferenceRecord<T>;
+/** Props and confirmed responses share one render model; the ref serves async callbacks only. */
+export declare function useConfirmedPreferenceRecord<T>(source: T): {
+    value: T;
+    confirm: (value: T) => void;
+    getLatest: () => T;
+};

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

@@ -0,0 +1,26 @@
+import type { Theme } from '../../../../blocks/src/index';
+import { type FooterPreferences } from '../../../../theme-core/src/site-styles/index';
+import type { SiteStyleAccess } from './siteStyleAccess';
+/** The client controller holds the row's record across previews, responses and refreshes. */
+export declare function usePersistedFooterPreferences(stored: FooterPreferences | null | undefined): {
+    getFooterPreferences: () => Readonly<{
+        background: import("../../../../blocks/src/index").SiteChromeBackgroundOverride;
+        navigationLayout: "inline-wrap" | "stack";
+    }> | null;
+    getLatestFooterPreferences: () => Readonly<{
+        background: import("../../../../blocks/src/index").SiteChromeBackgroundOverride;
+        navigationLayout: "inline-wrap" | "stack";
+    }> | null;
+    observeSavedFooter: <T extends {
+        footerPreferences: FooterPreferences;
+    }>(saved: T) => T;
+    backgroundPreferencesFor: (theme: Theme | null | undefined) => {
+        footer: import("../../../../blocks/src/index").SiteChromeBackgroundOverride;
+        header: import("../../../../blocks/src/index").SiteChromeBackgroundOverride;
+    };
+};
+/** Record availability governs every appearance control, including history writes. */
+export declare function footerRecordCapabilities(preferences: FooterPreferences | null | undefined, access: SiteStyleAccess, canOpenDesignEditor: boolean): {
+    applyAllowed: boolean;
+    canOpenDesignEditor: boolean;
+};

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

@@ -1,8 +1,46 @@
-import { type RefObject } from 'react';
 import type { Theme } from '../../../../blocks/src/index';
 import { type HeaderLogoContext, type HeaderPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 import type { SiteChromeCustomizeProviderProps } from './SiteChromeCustomizeContext';
 /** Keep the row-owned intent across optimistic edits and server responses. */
-export declare function usePersistedHeaderPreferences(stored: HeaderPreferences | null, theme: Theme | null | undefined, selection: SelectionSnapshot | null, logo: HeaderLogoContext | undefined): RefObject<HeaderPreferences>;
+export declare function usePersistedHeaderPreferences(stored: HeaderPreferences | null, theme: Theme | null | undefined, selection: SelectionSnapshot | null, logo: HeaderLogoContext | undefined): {
+    preferences: Readonly<{
+        brandPresentation: import("../../../../blocks/src/index").HeaderBrandPresentationPreference;
+        brandDisplay: import("../../../../blocks/src/index").BrandDisplayMode;
+        logoSize: import("../../../../blocks/src/index").LogoSizePolicy;
+        navFontRole: import("../../../../blocks/src/index").HeaderNavTypographyPreference;
+        navTextSize: import("../../../../blocks/src/index").HeaderNavFontSizePreference;
+        interactionPalette: import("../../../../blocks/src/index").HeaderInteractionPalettePreference;
+        background: import("../../../../blocks/src/index").SiteChromeBackgroundOverride;
+        structure: import("../../../../blocks/src/index").HeaderStructurePreferences;
+    }>;
+    getLatestPreferences: () => Readonly<{
+        brandPresentation: import("../../../../blocks/src/index").HeaderBrandPresentationPreference;
+        brandDisplay: import("../../../../blocks/src/index").BrandDisplayMode;
+        logoSize: import("../../../../blocks/src/index").LogoSizePolicy;
+        navFontRole: import("../../../../blocks/src/index").HeaderNavTypographyPreference;
+        navTextSize: import("../../../../blocks/src/index").HeaderNavFontSizePreference;
+        interactionPalette: import("../../../../blocks/src/index").HeaderInteractionPalettePreference;
+        background: import("../../../../blocks/src/index").SiteChromeBackgroundOverride;
+        structure: Readonly<{
+            positioning: "inherit" | import("../../../../blocks/src/index").ThemeHeader["positioning"];
+            shrinkOnScroll: "inherit" | boolean;
+            logoText: "inherit" | "none" | import("../../../../blocks/src/index").HeaderLogoTextIntent;
+        }>;
+    }>;
+    observeSavedPreferences: (value: Readonly<{
+        brandPresentation: import("../../../../blocks/src/index").HeaderBrandPresentationPreference;
+        brandDisplay: import("../../../../blocks/src/index").BrandDisplayMode;
+        logoSize: import("../../../../blocks/src/index").LogoSizePolicy;
+        navFontRole: import("../../../../blocks/src/index").HeaderNavTypographyPreference;
+        navTextSize: import("../../../../blocks/src/index").HeaderNavFontSizePreference;
+        interactionPalette: import("../../../../blocks/src/index").HeaderInteractionPalettePreference;
+        background: import("../../../../blocks/src/index").SiteChromeBackgroundOverride;
+        structure: Readonly<{
+            positioning: "inherit" | import("../../../../blocks/src/index").ThemeHeader["positioning"];
+            shrinkOnScroll: "inherit" | boolean;
+            logoText: "inherit" | "none" | import("../../../../blocks/src/index").HeaderLogoTextIntent;
+        }>;
+    }>) => void;
+};
 export declare function useSiteChromeInitialSnapshot({ theme, initialSelections, selectionVersion, selectionUpdatedAt, headerLogoContext, }: Pick<SiteChromeCustomizeProviderProps, 'theme' | 'initialSelections' | 'selectionVersion' | 'selectionUpdatedAt' | 'headerLogoContext'>): SelectionSnapshot | null;

package/dist/_dts/sdk/src/config/validation.d.ts

@@ -39,8 +39,8 @@ export declare const sectionBackgroundSchema: z.ZodObject<{
  * Schema for section spacing values.
  */
 export declare const sectionSpacingSchema: z.ZodEnum<{
-    default: "default";
     compact: "compact";
+    default: "default";
     spacious: "spacious";
 }>;
 /**
@@ -68,8 +68,8 @@ export declare const sectionOptionsSchema: z.ZodOptional<z.ZodObject<{
     backgroundImage: z.ZodOptional<z.ZodBoolean>;
     backgroundGradient: z.ZodOptional<z.ZodBoolean>;
     spacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodEnum<{
-        default: "default";
         compact: "compact";
+        default: "default";
         spacious: "spacious";
     }>>, z.ZodBoolean]>>;
     textColor: z.ZodOptional<z.ZodBoolean>;
@@ -104,8 +104,8 @@ export declare const siteStyleConfigSchema: z.ZodOptional<z.ZodObject<{
         backgroundImage: z.ZodOptional<z.ZodBoolean>;
         backgroundGradient: z.ZodOptional<z.ZodBoolean>;
         spacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodEnum<{
-            default: "default";
             compact: "compact";
+            default: "default";
             spacious: "spacious";
         }>>, z.ZodBoolean]>>;
         textColor: z.ZodOptional<z.ZodBoolean>;

package/dist/_dts/sdk/src/contracts/content.d.ts

@@ -40,51 +40,8 @@ export type AuthoredLinkValue = BlocksAuthoredLinkValue;
  * persistence must narrow to a persistable lifecycle value first.
  */
 export type LinkValue = BlocksLinkValue;
-export type MediaTypeDiscriminant = 'image' | 'video' | 'audio' | 'document' | 'spreadsheet' | 'archive';
-export type Media = {
-    type: MediaTypeDiscriminant;
-    purpose?: string;
-    placeholder?: boolean;
-    assetId?: string;
-    identifier?: string;
-    src?: string;
-    alt?: string;
-    filename?: string;
-    mimeType?: string;
-    width?: number;
-    height?: number;
-    storageBucket?: string;
-    storagePath?: string;
-    poster?: {
-        tag: 'storage';
-        assetId?: string;
-        storageBucket: string;
-        storagePath: string;
-    } | {
-        tag: 'external-src';
-        assetId?: string;
-        src: string;
-    };
-    transform?: {
-        aspectCrops?: Record<string, {
-            aspect?: string;
-            rect?: [number, number, number, number];
-            hotspot?: {
-                x: number;
-                y: number;
-                radius?: number;
-            };
-            rotation?: 0 | 90 | 180 | 270;
-        }>;
-        rect?: [number, number, number, number];
-        hotspot?: {
-            x: number;
-            y: number;
-            radius?: number;
-        };
-        rotation?: 0 | 90 | 180 | 270;
-    };
-};
+/** Portable managed references and explicit runtime sources share the canonical contracts. */
+export type { Media, PersistableMedia, MediaIdentifier, MediaTypeDiscriminant, MediaPoster, ExternalMedia, AssetMedia, RuntimeMedia, RuntimeMediaOfType, RenderableMediaAsset, RenderableMediaAssetIndex, ManagedMediaResolution, } from '../../../media-core/src/index';
 export type RichTextVariant = 'full' | 'inline' | 'limited' | 'media' | 'notes';
 export type RichTextPrimitiveProps = {
     as?: React.ElementType;

package/dist/_dts/sdk/src/contracts/index.d.ts

@@ -1,4 +1,4 @@
-export type { TipTapNode, TipTapMark, RichTextDoc, InlineText, InlineTextAccentTone, InlineTextHighlightTone, InlineTextMark, InlineTextRun, Media, LinkValue, InternalRouteOnlyLinkValue, InternalResolvedLinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, } from './content';
+export type { TipTapNode, TipTapMark, RichTextDoc, InlineText, InlineTextAccentTone, InlineTextHighlightTone, InlineTextMark, InlineTextRun, Media, PersistableMedia, MediaIdentifier, MediaTypeDiscriminant, MediaPoster, ExternalMedia, AssetMedia, RuntimeMedia, RuntimeMediaOfType, RenderableMediaAsset, RenderableMediaAssetIndex, ManagedMediaResolution, LinkValue, InternalRouteOnlyLinkValue, InternalResolvedLinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, } from './content';
 export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardRole, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, ContentFrameIntent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FeatureCardLegacySurfaceRole, FeatureCardSurfaceRole, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, IntroContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, OfferingsPreviewContent, ProductDetailContent, ProductListContent, RecurringScheduleContent, SectionStylesContent, SemanticIconId, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, BlockIconValue, FeatureCardIconTreatment, } from './system-block-content';
 export type { PageOutline, PageRuntimeJoin, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, } from './page';
 export type { Theme, ThemeTokens } from './theme';

package/dist/_dts/sdk/src/contracts/rendering.d.ts

@@ -1,7 +1,7 @@
 /**
  * Public SDK rendering contracts.
  */
-import type { Media } from './content';
+import type { RuntimeMedia } from './content';
 export type ImageOptions = {
     width: number;
     height?: number;
@@ -72,5 +72,5 @@ export type ResolveImageSourceSetOptions = {
     targetAspectRatio?: number;
     defaultWidth?: number;
 };
-export type ResolveImageUrl = (value: Media, options: ImageOptions) => string | undefined;
-export type ResolveImageUrlWithContext = (value: Media, options: ImageOptions, context?: ResolveImageUrlContext) => string | undefined;
+export type ResolveImageUrl = (value: RuntimeMedia, options: ImageOptions) => string | undefined;
+export type ResolveImageUrlWithContext = (value: RuntimeMedia, options: ImageOptions, context?: ResolveImageUrlContext) => string | undefined;

package/dist/_dts/sdk/src/contracts/system-block-content.d.ts

@@ -8,6 +8,7 @@ import type { InlineText, LinkValue, Media } from './content';
 import type { EventRegistrationContent } from './event-registration-content';
 export type { EventRegistrationContent } from './event-registration-content';
 import type { Brand, EventCategoryId, RichTextDoc, VenueId } from '../../../core/src/index';
+import type { ImageGalleryContent as BlocksImageGalleryContent } from '../../../blocks/src/system/blocks/image-gallery';
 import type { SiteFooterContent as BlocksSiteFooterContent } from '../../../blocks/src/system/blocks/site-footer';
 import type { NewsletterSignupContent as BlocksNewsletterSignupContent } from '../../../blocks/src/system/blocks/newsletter-signup';
 import type { ContactNewsletterContent as BlocksContactNewsletterContent } from '../../../blocks/src/system/blocks/contact-newsletter';
@@ -66,12 +67,7 @@ export type BlogListingContent = {
     _cardStyles?: CardStylesContent;
 };
 export type BodyTextAlignment = 'left' | 'center';
-export type BodyTextContent = {
-    variant?: 'prose' | 'intro' | 'narrow' | null;
-    heading?: string | null;
-    body: RichTextDoc;
-    alignment?: BodyTextAlignment | null;
-};
+export type BodyTextContent = import('../../../blocks/src/system/blocks/body-text').BodyTextContent;
 export type BlockCtaContent = {
     label?: string | null;
     href?: string | null;
@@ -331,38 +327,7 @@ export type HeroContent = {
     columnGuides?: boolean | null;
 };
 export type HeroMedia = Media;
-export type ImageGalleryContent = {
-    variant?: 'grid' | 'carousel' | 'masonry' | 'marquee' | null;
-    fullBleed?: boolean | null;
-    aspectRatio?: 'auto' | '1/1' | '4/3' | '16/9' | '3/2' | '3/4' | null;
-    slidesToShow?: '1' | '2' | '3' | null;
-    slidesToShowTablet?: '' | '1' | '2' | '3' | null;
-    slidesToShowDesktop?: '' | '1' | '2' | '3' | null;
-    transition?: 'slide' | 'fade' | null;
-    showControls?: boolean | null;
-    showDots?: boolean | null;
-    autoplay?: boolean | null;
-    autoplayDelay?: '3000' | '5000' | '7000' | '10000' | null;
-    arrowVisibility?: 'always' | 'hover' | null;
-    loop?: boolean | null;
-    marqueeDirection?: 'left' | 'right' | null;
-    marqueeSpeed?: 'slow' | 'medium' | 'fast' | null;
-    marqueePauseOnHover?: boolean | null;
-    marqueeImageSize?: 'sm' | 'md' | 'lg' | 'xl' | null;
-    imageFilter?: 'none' | 'grayscale' | 'grayscale-hover-reveal' | 'sepia' | null;
-    imageBorder?: {
-        enabled?: boolean | null;
-        colorToken?: string | null;
-        opacity?: number | null;
-        width?: '1' | '2' | '3' | null;
-    } | null;
-    imageCorners?: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | null;
-    images?: Array<{
-        image?: Media | null;
-        caption?: string | null;
-    }> | null;
-    _sectionStyles?: SectionStylesContent;
-};
+export type ImageGalleryContent = BlocksImageGalleryContent;
 export type MediaTextAlignment = 'left' | 'center';
 export type MediaTextImagePosition = 'left' | 'right';
 export type MediaTextAspectRatio = 'auto' | '16/9' | '4/3' | '1/1' | '3/4' | '9/16';
@@ -602,14 +567,7 @@ export type BlogPostContent = {
     title?: string | null;
     postSlug?: string | null;
 };
-export type FormBlockContent = {
-    title?: string | null;
-    intro?: RichTextDoc | null;
-    formSlug: string;
-    submitLabel?: string | null;
-    successMessage?: string | null;
-    _sectionStyles?: SectionStylesContent;
-};
+export type FormBlockContent = import('../../../blocks/src/system/blocks/form').FormBlockContent;
 export type LocationMapContent = {
     heading?: string | null;
     location?: {