@riverbankcms/sdk 0.78.0 → 0.79.0

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

@@ -4,7 +4,10 @@ import { BlockForm } from '../BlockForm';
 import type { ComponentProps } from 'react';
 import type { BlockItem, BlockFocusRequest } from './types';
 import type { FieldWidgetComponent } from '../../../block-form/src/client/index';
-export declare function BlockCardBody({ siteId, block, manifest, uiStore, hasRecoveryConflict, focusSignal, onFocusHandled, onBlockSave, theme, widgetOverrides, hideThemeV2RawStyleFields, pageDesignBlock, }: {
+import type { SiteIconStyleGuideVersionId } from '../../../blocks/src/index';
+import type { GeneratedIconSetGenerateResult, GeneratedIconSetPreview } from './GeneratedIconSetDialog';
+import type { getFeatureCardIconDialogCards } from './featureCardIconActions';
+export declare function BlockCardBody({ siteId, block, manifest, uiStore, hasRecoveryConflict, focusSignal, onFocusHandled, onBlockSave, theme, widgetOverrides, hideThemeV2RawStyleFields, pageDesignBlock, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, onApplyGeneratedIconSet, }: {
     siteId: string;
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
@@ -17,4 +20,12 @@ export declare function BlockCardBody({ siteId, block, manifest, uiStore, hasRec
     widgetOverrides?: Record<string, FieldWidgetComponent>;
     hideThemeV2RawStyleFields?: boolean;
     pageDesignBlock?: PageDesignEditorBlock | null;
+    currentStyleGuideVersionId?: SiteIconStyleGuideVersionId | null;
+    iconStyleGuideSummary?: string | null;
+    iconStyleGuideEditHref?: string | null;
+    onGenerateIconSet?: (input: Readonly<{
+        userStyleNote: string | null;
+        cards: ReturnType<typeof getFeatureCardIconDialogCards>;
+    }>) => Promise<GeneratedIconSetGenerateResult>;
+    onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -1,16 +1,18 @@
 import type { SyntheticListenerMap } from '@dnd-kit/core/dist/hooks/utilities';
 import type { FieldWidgetComponent } from '../../../block-form/src/client/index';
-import { type SystemBlockDefinition, type Theme } from '../../../blocks/src/index';
+import { type SiteIconStyleGuideVersionId, type SystemBlockDefinition, type Theme } from '../../../blocks/src/index';
 import { type BlockActionControlMode } from './actionControlMode';
 import type { ReorderControlMode } from './reorderControlMode';
 import type { BlockItem, UiStore, DraftsSlice, ArrayKeysManager } from './types';
+import { getFeatureCardIconDialogCards } from './featureCardIconActions';
+import { type GeneratedIconSetGenerateResult, type GeneratedIconSetPreview } from './GeneratedIconSetDialog';
 /** Drag listener props from dnd-kit */
 type DragListeners = SyntheticListenerMap | undefined;
 type BlockCardHeaderStore = UiStore<{
     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, actionControlMode, }: {
+export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, reorderControlMode, actionControlMode, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, onApplyGeneratedIconSet, }: {
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
     isFirst: boolean;
@@ -31,5 +33,13 @@ export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMo
     hideThemeV2RawStyleFields?: boolean;
     reorderControlMode?: ReorderControlMode;
     actionControlMode?: BlockActionControlMode;
+    currentStyleGuideVersionId?: SiteIconStyleGuideVersionId | null;
+    iconStyleGuideSummary?: string | null;
+    iconStyleGuideEditHref?: string | null;
+    onGenerateIconSet?: (input: Readonly<{
+        userStyleNote: string | null;
+        cards: ReturnType<typeof getFeatureCardIconDialogCards>;
+    }>) => Promise<GeneratedIconSetGenerateResult>;
+    onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
 }): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1,21 @@
+import type { SiteIconStyleGuideVersionId } from '../../../blocks/src/index';
+import type { BlockItem, DraftsSlice, UiStore } from './types';
+import { getFeatureCardIconDialogCards } from './featureCardIconActions';
+import { type GeneratedIconSetGenerateResult, type GeneratedIconSetPreview } from './GeneratedIconSetDialog';
+type FeatureCardIconsPanelStore = UiStore<{
+    drafts: Pick<DraftsSlice, 'getCurrentValues' | 'setAtPath'>;
+}>;
+export declare function supportsFeatureCardIconActions(blockKind: string): boolean;
+export declare function FeatureCardIconsPanel({ block, uiStore, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, onApplyGeneratedIconSet, }: {
+    block: BlockItem;
+    uiStore: FeatureCardIconsPanelStore;
+    currentStyleGuideVersionId?: SiteIconStyleGuideVersionId | null;
+    iconStyleGuideSummary?: string | null;
+    iconStyleGuideEditHref?: string | null;
+    onGenerateIconSet?: (input: Readonly<{
+        userStyleNote: string | null;
+        cards: ReturnType<typeof getFeatureCardIconDialogCards>;
+    }>) => Promise<GeneratedIconSetGenerateResult>;
+    onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
+}): import("react/jsx-runtime").JSX.Element | null;
+export {};

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

@@ -0,0 +1,40 @@
+import { type GeneratedBlockIconValue } from '../../../blocks/src/index';
+import type { GeneratedIconSetCandidate } from '../../../api/src/index';
+import type { FeatureCardIconDialogCard } from './featureCardIconActions';
+export type GeneratedIconSetPreviewAsset = Readonly<{
+    cardKey: string;
+    title: string;
+    src: string;
+    iconValue: GeneratedBlockIconValue;
+}>;
+export type GeneratedIconSetPreview = Readonly<{
+    setId: string;
+    styleGuideSummary: string;
+    candidate?: GeneratedIconSetCandidate;
+    assets: readonly GeneratedIconSetPreviewAsset[];
+}>;
+export type GeneratedIconSetGenerateResult = Readonly<{
+    kind: 'preview_ready';
+    preview: GeneratedIconSetPreview;
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}>;
+export type GeneratedIconSetApplyResult = Readonly<{
+    kind: 'applied';
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}>;
+export declare function GeneratedIconSetDialog({ open, onOpenChange, cards, styleGuideSummary, styleGuideEditHref, onGenerate, onApply, }: {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    cards: readonly FeatureCardIconDialogCard[];
+    styleGuideSummary?: string | null;
+    styleGuideEditHref?: string | null;
+    onGenerate?: (input: Readonly<{
+        userStyleNote: string | null;
+        cards: readonly FeatureCardIconDialogCard[];
+    }>) => Promise<GeneratedIconSetGenerateResult>;
+    onApply?: (preview: GeneratedIconSetPreview) => GeneratedIconSetApplyResult | void | Promise<GeneratedIconSetApplyResult | void>;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -1,5 +1,5 @@
 import { type ComponentProps } from 'react';
-import { type Theme } from '../../../blocks/src/index';
+import { type Theme, type SiteIconStyleGuideVersionId } from '../../../blocks/src/index';
 import type { PageDesignEditorBlock } from '../../../theme-core/src/site-styles/index';
 import type { BlockFocusRequest, BlockItem } from './types';
 import { type CustomBlockRegistryEntry, type SdkConfigForBlockPicker } from './sdkBlockMerger';
@@ -7,6 +7,8 @@ import { BlockCard } from './BlockCard';
 import type { FieldWidgetComponent } from '../../../block-form/src/client/index';
 import { type BlockActionControlMode } from './actionControlMode';
 import { type ReorderControlMode } from './reorderControlMode';
+import type { GeneratedIconSetGenerateResult, GeneratedIconSetPreview } from './GeneratedIconSetDialog';
+import type { getFeatureCardIconDialogCards } from './featureCardIconActions';
 export declare const SortableBlockItem: import("react").NamedExoticComponent<{
     siteId: string;
     block: BlockItem;
@@ -33,4 +35,12 @@ export declare const SortableBlockItem: import("react").NamedExoticComponent<{
     pageDesignBlock?: PageDesignEditorBlock | null;
     reorderControlMode?: ReorderControlMode;
     actionControlMode?: BlockActionControlMode;
+    currentStyleGuideVersionId?: SiteIconStyleGuideVersionId | null;
+    iconStyleGuideSummary?: string | null;
+    iconStyleGuideEditHref?: string | null;
+    onGenerateIconSet?: (input: Readonly<{
+        userStyleNote: string | null;
+        cards: ReturnType<typeof getFeatureCardIconDialogCards>;
+    }>) => Promise<GeneratedIconSetGenerateResult>;
+    onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
 }>;

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

@@ -0,0 +1,82 @@
+import { applyFeatureCardIconSuggestions, type GeneratedBlockIconValue, type FeatureCardIconInputContent, type SemanticIconId, type SiteIconStyleGuideVersionId } from '../../../blocks/src/index';
+import { type EditorBlockId } from '../../../core/src/index';
+import type { DraftsSlice } from './types';
+type FeatureCardIconActionDrafts = Pick<DraftsSlice, 'setAtPath'>;
+export type FeatureCardIconActionResult = {
+    kind: 'applied';
+    appliedCount: number;
+} | {
+    kind: 'no_cards';
+} | {
+    kind: 'complete';
+} | {
+    kind: 'plan_failed';
+    reason: Exclude<ReturnType<typeof applyFeatureCardIconSuggestions>['kind'], 'applied'>;
+    cardKey?: string;
+    iconId?: string;
+};
+export type FeatureCardGeneratedIconSetAssetInput = Readonly<{
+    cardKey: string;
+    iconValue: unknown;
+}>;
+export type FeatureCardGeneratedIconSetApplyPlan = Readonly<{
+    kind: 'applied';
+    appliedIcons: readonly Readonly<{
+        cardIndex: number;
+        cardKey: string;
+        iconValue: GeneratedBlockIconValue;
+    }>[];
+}> | Readonly<{
+    kind: 'duplicate_asset_card_key';
+    cardKey: string;
+}> | Readonly<{
+    kind: 'missing_asset_card_key';
+    cardKey: string;
+}> | Readonly<{
+    kind: 'unknown_card_key';
+    cardKey: string;
+}> | Readonly<{
+    kind: 'invalid_generated_icon';
+    cardKey: string;
+}>;
+export type FeatureCardGeneratedIconSetActionResult = Readonly<{
+    kind: 'applied';
+    appliedCount: number;
+}> | Readonly<{
+    kind: 'no_cards';
+}> | Readonly<{
+    kind: 'plan_failed';
+    reason: Exclude<FeatureCardGeneratedIconSetApplyPlan['kind'], 'applied'>;
+    cardKey?: string;
+}>;
+export type FeatureCardIconDialogCard = Readonly<{
+    cardKey: string;
+    title: string;
+    bodyText: string;
+    semanticIconId: SemanticIconId;
+}>;
+export type FeatureCardGeneratedIconStyleSummary = Readonly<{
+    kind: 'unavailable';
+}> | Readonly<{
+    kind: 'available';
+    generatedCount: number;
+    staleCount: number;
+    invalidGeneratedCount: number;
+}>;
+export declare function getFeatureCards(content: Record<string, unknown> | null | undefined): FeatureCardIconInputContent[];
+export declare function getFeatureCardIconStatus(content: Record<string, unknown> | null | undefined): import("../../../blocks/src/index").FeatureCardIconCompletion;
+export declare function getFeatureCardIconDialogCards(content: Record<string, unknown> | null | undefined): readonly FeatureCardIconDialogCard[];
+export declare function getFeatureCardGeneratedIconStyleSummary(content: Record<string, unknown> | null | undefined, currentStyleGuideVersionId: SiteIconStyleGuideVersionId | null | undefined): FeatureCardGeneratedIconStyleSummary;
+export declare function applyCuratedFeatureCardIconSuggestions({ blockId, content, drafts, }: {
+    blockId: EditorBlockId;
+    content: Record<string, unknown> | null | undefined;
+    drafts: FeatureCardIconActionDrafts;
+}): FeatureCardIconActionResult;
+export declare function planGeneratedFeatureCardIconSetApply(cards: readonly FeatureCardIconInputContent[], assets: readonly FeatureCardGeneratedIconSetAssetInput[]): FeatureCardGeneratedIconSetApplyPlan;
+export declare function applyGeneratedFeatureCardIconSet({ blockId, content, drafts, assets, }: {
+    blockId: EditorBlockId;
+    content: Record<string, unknown> | null | undefined;
+    drafts: FeatureCardIconActionDrafts;
+    assets: readonly FeatureCardGeneratedIconSetAssetInput[];
+}): FeatureCardGeneratedIconSetActionResult;
+export {};

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

@@ -5,7 +5,7 @@ export type ManifestFieldIssue = {
     path: string;
     segments: string[];
     message: string;
-    code: z.ZodIssue['code'];
+    code: string;
 };
 export type BlockContentPayloadResult<TValues extends Record<string, unknown> = Record<string, unknown>> = {
     data: TValues | null;

package/dist/_dts/editor-blocks/src/widgets/icon-picker/IconPickerField.d.ts

@@ -1,4 +1,4 @@
 import { type FieldWidgetProps, type TextFieldConfig } from '../../../../block-form/src/client/index';
-type IconPickerValue = string | null;
+type IconPickerValue = unknown;
 export declare function IconPickerField({ path, backend, config }: FieldWidgetProps<IconPickerValue, TextFieldConfig>): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -61,6 +61,9 @@ export type FileUse = {
 } | {
     readonly tag: 'site-brand-asset';
     readonly brandUse: SiteBrandAssetUse;
+} | {
+    readonly tag: 'site-background-asset';
+    readonly backgroundUse: SiteBackgroundAssetUse;
 } | {
     readonly tag: 'site-font-file';
     readonly fontId: SiteFontId;
@@ -71,10 +74,14 @@ export type FileUse = {
 export type FileUseTag = FileUse['tag'];
 export type WorkflowInputKind = 'audio-enrichment' | 'generic-file-processing';
 export type SiteBrandAssetUse = 'logo' | 'social-image';
+export type AmbientBackgroundRole = 'light-texture' | 'proof-band-dark' | 'cta-wash' | 'footer-detail' | 'style-atmosphere-1' | 'style-atmosphere-2';
+export type SiteBackgroundAssetUse = 'selected-background' | AmbientBackgroundRole;
 export type TemporaryIngestionKind = 'backup-zip' | 'newsletter-csv' | 'instagram-zip';
-export declare const FILE_USE_TAGS: readonly ["media-library", "content-download", "digital-product-file", "workflow-input", "booking-evidence", "site-brand-asset", "site-font-file", "temporary-ingestion"];
+export declare const FILE_USE_TAGS: readonly ["media-library", "content-download", "digital-product-file", "workflow-input", "booking-evidence", "site-brand-asset", "site-background-asset", "site-font-file", "temporary-ingestion"];
 export declare const WORKFLOW_INPUT_KINDS: readonly ["audio-enrichment", "generic-file-processing"];
 export declare const SITE_BRAND_ASSET_USES: readonly ["logo", "social-image"];
+export declare const AMBIENT_BACKGROUND_ROLES: readonly ["light-texture", "proof-band-dark", "cta-wash", "footer-detail", "style-atmosphere-1", "style-atmosphere-2"];
+export declare const SITE_BACKGROUND_ASSET_USES: readonly ["selected-background", "light-texture", "proof-band-dark", "cta-wash", "footer-detail", "style-atmosphere-1", "style-atmosphere-2"];
 export declare const TEMPORARY_INGESTION_KINDS: readonly ["backup-zip", "newsletter-csv", "instagram-zip"];
 export type UploadIntent = {
     readonly tag: 'media-library';

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

@@ -1,4 +1,4 @@
-import type { MediaKind } from '@riverbankcms/media-storage-supabase';
+import type { MediaAssetWithLabels, MediaKind } from '@riverbankcms/media-storage-supabase';
 import { type UploadIntentResolver, type VideoPrepIntentResolver } from '../../media-react/src/index';
 import type { VideoPrepIntent } from '../../media-core/src/index';
 import type { MediaValue } from './types';
@@ -19,8 +19,11 @@ export type MediaEditorProps = {
     fullWidth?: boolean;
     previewVariant?: 'default' | 'thumbnail';
     showRemoveAction?: boolean;
+    previewMaxWidth?: 'xs' | 'sm' | 'md' | 'none';
+    preventPreviewUpscale?: boolean;
+    onUploadComplete?: (asset: MediaAssetWithLabels) => void;
     uploadIntent?: UploadIntentResolver;
     videoPrepIntent?: VideoPrepIntentResolver;
     videoSelectionIntent?: VideoPrepIntent;
 };
-export declare const MediaEditor: ({ value, onChange, allowedKinds, previewAspectRatio, minSourceWidth, minSourceHeight, showAltInput, cropEditorMode, cropEditorAutoOpen, mediaPickerAutoOpen, showPreview, showActionOverlay, onEditDetails, fullWidth, previewVariant, showRemoveAction, uploadIntent, videoPrepIntent, videoSelectionIntent, }: MediaEditorProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MediaEditor: ({ value, onChange, allowedKinds, previewAspectRatio, minSourceWidth, minSourceHeight, showAltInput, cropEditorMode, cropEditorAutoOpen, mediaPickerAutoOpen, showPreview, showActionOverlay, onEditDetails, fullWidth, previewVariant, showRemoveAction, previewMaxWidth, preventPreviewUpscale, onUploadComplete, uploadIntent, videoPrepIntent, videoSelectionIntent, }: MediaEditorProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -10,5 +10,7 @@ export type MediaPreviewProps = {
     variant?: 'default' | 'thumbnail';
     showRemoveAction?: boolean;
     showActionOverlay?: boolean;
+    previewMaxWidth?: 'xs' | 'sm' | 'md' | 'none';
+    preventUpscale?: boolean;
 };
-export declare const MediaPreview: ({ value, previewAspectRatio, onReplace, onEditCrop, onEditDetails, onRemove, fullWidth, variant, showRemoveAction, showActionOverlay, }: MediaPreviewProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MediaPreview: ({ value, previewAspectRatio, onReplace, onEditCrop, onEditDetails, onRemove, fullWidth, variant, showRemoveAction, showActionOverlay, previewMaxWidth, preventUpscale, }: MediaPreviewProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -7,6 +7,8 @@ type MediaEditorFieldUi = {
     mediaPickerAutoOpen?: boolean;
     showMediaPreview?: boolean;
     showMediaOverlayActions?: boolean;
+    mediaPreviewMaxWidth?: 'xs' | 'sm' | 'md' | 'none';
+    preventMediaPreviewUpscale?: boolean;
 } & Record<string, unknown>;
 type MediaEditorFieldLike = {
     type?: string;
@@ -17,4 +19,7 @@ export declare function withRepeaterThumbnailMediaFieldUi<T extends MediaEditorF
 }): (T & {
     ui: MediaEditorFieldUi;
 }) | null;
+export declare function withRepeaterStackMediaFieldUi<T extends MediaEditorFieldLike>(field: T): T & {
+    ui: MediaEditorFieldUi;
+};
 export {};

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

@@ -13,6 +13,6 @@ export { MediaEditorContextProvider, useMediaEditor, useMediaEditorOptional, typ
 export { MediaEditorProvider } from './provider';
 export type { MediaEditorProviderProps } from './provider';
 export { createMediaEditorProvider } from './createMediaEditorProvider';
-export { withRepeaterThumbnailMediaFieldUi } from './fieldUi';
+export { withRepeaterStackMediaFieldUi, withRepeaterThumbnailMediaFieldUi } from './fieldUi';
 export type { MediaValue, MediaTransform, MediaHotspot } from './types';
 export { DEFAULT_HOTSPOT } from './utils';

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

@@ -28,6 +28,7 @@ export type MediaLibraryProps = {
     uploader?: UseUploadsOptions['uploader'];
     maxParallelUploads?: number;
     getListOptions?: () => Partial<ListMediaAssetsOptions>;
+    onUploadComplete?: (asset: MediaAssetWithLabels) => void;
     children: (props: MediaLibraryRenderProps) => ReactNode;
 };
-export declare const MediaLibrary: ({ siteId, repo, pageSize, allowMultiSelect, uploader, maxParallelUploads, children, getListOptions, }: MediaLibraryProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MediaLibrary: ({ siteId, repo, pageSize, allowMultiSelect, uploader, maxParallelUploads, children, getListOptions, onUploadComplete, }: MediaLibraryProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -17,5 +17,6 @@ export type MediaPickerMiniProps = {
     open?: boolean;
     onOpenChange?: (value: boolean) => void;
     getListOptions?: MediaLibraryProps['getListOptions'];
+    onUploadComplete?: MediaLibraryProps['onUploadComplete'];
 };
-export declare const MediaPickerMini: ({ siteId, repo, onPick, children, pageSize, uploader, autoCloseOnPick, open, onOpenChange, getListOptions, }: MediaPickerMiniProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MediaPickerMini: ({ siteId, repo, onPick, children, pageSize, uploader, autoCloseOnPick, open, onOpenChange, getListOptions, onUploadComplete, }: MediaPickerMiniProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,5 +1,6 @@
 import type { AppearancePresetId, BoundaryOptionId, DesignBlockId, LayoutVariantKey, PageDesignEditorBlock, PageDesignEditorBoundary } from '../../../../theme-core/src/site-styles/index';
 import { type SystemCustomizeFacetId, type SystemCustomizeFacetTransition, type SystemCustomizeFacetValue } from '../../../../blocks/src/system/customize/facets';
+import { type BackgroundImagePoolItem, type BackgroundOverride } from '../../../../blocks/src/system/customize/backgrounds';
 export type PreviewCustomizeCycleDirection = 'prev' | 'next';
 export type PreviewCustomizeAction = Readonly<{
     kind: 'set-layout';
@@ -15,6 +16,12 @@ export type PreviewCustomizeAction = Readonly<{
     blockId: DesignBlockId;
     baseContentId: string | null;
 } & SystemCustomizeFacetTransition> | Readonly<{
+    kind: 'set-background';
+    blockId: DesignBlockId;
+    override: BackgroundOverride;
+    fromOverride: BackgroundOverride;
+    baseContentId: string | null;
+}> | Readonly<{
     kind: 'set-boundary';
     previousBlockId: DesignBlockId;
     nextBlockId: DesignBlockId;
@@ -33,6 +40,9 @@ type PreviewSetLookAction = Extract<PreviewCustomizeAction, {
 type PreviewSetBlockFacetAction = Extract<PreviewCustomizeAction, {
     kind: 'set-block-facet';
 }>;
+type PreviewSetBackgroundAction = Extract<PreviewCustomizeAction, {
+    kind: 'set-background';
+}>;
 type PreviewSetBoundaryAction = Extract<PreviewCustomizeAction, {
     kind: 'set-boundary';
 }>;
@@ -47,5 +57,12 @@ export declare function cyclePageDesignBlockFacet(input: Readonly<{
     currentValue: SystemCustomizeFacetValue;
     direction: PreviewCustomizeCycleDirection;
 }>): PreviewSetBlockFacetAction | null;
+export declare function setPageDesignBlockBackground(input: Readonly<{
+    block: PageDesignEditorBlock;
+    override: BackgroundOverride;
+    currentContent?: Record<string, unknown> | null;
+    fromOverride?: BackgroundOverride;
+    imagePool?: readonly BackgroundImagePoolItem[];
+}>): PreviewSetBackgroundAction | null;
 export declare function cyclePageDesignBoundaryBreak(boundary: PageDesignEditorBoundary, direction: PreviewCustomizeCycleDirection): PreviewSetBoundaryAction | PreviewResetBoundaryAction | null;
 export {};

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

@@ -1,4 +1,5 @@
 import { type ReactNode } from 'react';
+import type { BackgroundImagePoolItem } from '../../../../blocks/src/system/customize/backgrounds';
 import { type ApiClient } from '../../../../api/src/request';
 import type { PreviewCustomizeAction } from '../blocks/previewCustomizeActions';
 import { type PreviewPageDesignEditorApplyOutcome, type PreviewPageDesignEditorState } from './previewCustomizeWorkflowState';
@@ -6,6 +7,9 @@ export type { PreviewPageDesignEditorApplyOutcome, PreviewPageDesignEditorState,
 type PageDesignEditorStateContextValue = Readonly<{
     state: PreviewPageDesignEditorState;
     reload: () => void;
+    backgroundImagePool: readonly BackgroundImagePoolItem[];
+    backgroundImagePoolStatus: 'idle' | 'loading' | 'loaded' | 'failed';
+    loadBackgroundImagePool: () => Promise<readonly BackgroundImagePoolItem[]>;
     applyAction: (action: PreviewCustomizeAction) => Promise<PreviewPageDesignEditorApplyOutcome>;
     undo: () => Promise<PreviewPageDesignEditorApplyOutcome>;
     redo: () => Promise<PreviewPageDesignEditorApplyOutcome>;

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

@@ -91,8 +91,9 @@ export declare function setPaletteOverrides(state: StyleConfiguratorState, palet
 /**
  * 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 / palette if the
- * user's previous selections are not offered for the new 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.
  *
  * Palette overrides are scoped by palette variant. If the resolver moves the
  * preview to a different palette, the current sparse overrides are stashed

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

@@ -2,6 +2,7 @@ import { type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, typ
 import { type HistoryState } from '../../../../content-editor/src/index';
 import type { PreviewCustomizeAction } from '../blocks/previewCustomizeActions';
 import type { SystemCustomizeFacetHistorySelection } from '../../../../blocks/src/system/customize/facets';
+import { type BackgroundOverride } from '../../../../blocks/src/system/customize/backgrounds';
 type PreviewLoadedEditorModel = PageDesignEditorReadModel;
 export type PreviewCustomizeHistoryEntry = Readonly<{
     kind: 'layout';
@@ -17,6 +18,11 @@ export type PreviewCustomizeHistoryEntry = Readonly<{
     kind: 'block-facet';
     blockId: PreviewCustomizeActionBlockId;
 } & SystemCustomizeFacetHistorySelection> | Readonly<{
+    kind: 'background';
+    blockId: PreviewCustomizeActionBlockId;
+    fromOverride: BackgroundOverride;
+    toOverride: BackgroundOverride;
+}> | Readonly<{
     kind: 'boundary';
     boundaryId: DesignBoundaryId;
     previousBlockId: PreviewCustomizeActionBlockId;

package/dist/_dts/sdk/src/cli/commands/push/consts.d.ts

@@ -1,3 +1,3 @@
-export declare const VALID_PUSH_SCOPES: readonly ["entries", "pages", "navigation", "forms", "theme", "footer", "venues", "event-categories", "events", "courses", "all"];
+export declare const VALID_PUSH_SCOPES: readonly ["entries", "pages", "navigation", "forms", "settings", "theme", "footer", "venues", "event-categories", "events", "courses", "all"];
 export type PushScope = (typeof VALID_PUSH_SCOPES)[number];
 export declare function isValidPushScope(scope: string): scope is PushScope;

package/dist/_dts/sdk/src/cli/commands/push/metadata.d.ts

@@ -12,6 +12,8 @@ export interface MetadataUpdateFlags {
     willUpdateNavigation: boolean;
     /** Whether forms metadata should be updated (zero failures + some synced) */
     willUpdateForms: boolean;
+    /** Whether settings metadata should be updated (zero failures + settings synced) */
+    willUpdateSettings: boolean;
     /** Whether any metadata should be updated (at least one content type qualifies) */
     shouldUpdateMetadata: boolean;
 }

package/dist/_dts/sdk/src/cli/commands/push/stale.d.ts

@@ -1,6 +1,6 @@
-import type { EntryMetadata, PagesMetadata, NavigationMetadata, FormsMetadata, LocalContent } from '../../content/reader';
+import type { EntryMetadata, PagesMetadata, NavigationMetadata, FormsMetadata, LocalContent, SettingsMetadata } from '../../content/reader';
 import type { PulledContent } from '../../../client/management/types';
-export type StaleScope = 'entries' | 'pages' | 'navigation' | 'forms';
+export type StaleScope = 'entries' | 'pages' | 'navigation' | 'settings' | 'forms';
 export interface StaleItem {
     scope: StaleScope;
     /** Only set for entries — the content type slug */
@@ -14,4 +14,4 @@ export interface StaleItem {
  * Check for stale content (remote is newer than local base)
  * @internal Exported for testing
  */
-export declare function checkForStaleContent(localContent: LocalContent, localMeta: Map<string, EntryMetadata>, pagesMeta: PagesMetadata | null, navigationMeta: NavigationMetadata | null, formsMeta: FormsMetadata | null, remoteContent: PulledContent): StaleItem[];
+export declare function checkForStaleContent(localContent: LocalContent, localMeta: Map<string, EntryMetadata>, pagesMeta: PagesMetadata | null, navigationMeta: NavigationMetadata | null, formsMeta: FormsMetadata | null, remoteContent: PulledContent, settingsMeta?: SettingsMetadata | null): StaleItem[];

package/dist/_dts/sdk/src/cli/commands/push-execute.d.ts

@@ -1,11 +1,18 @@
 import { type EnvTarget } from '../helpers';
 import type { OutputContext } from '../output';
+import type { ContentSummary } from '../content/reader';
 import { type JsonDiffMode } from '../sync';
 import type { PushOptions } from './push/options';
 import { type PushScope } from './push/consts';
 export interface PushExecutionResult {
     success: boolean;
 }
+export declare function noContentFoundWarningDetails(contentDir: string): Readonly<{
+    contentDir: string;
+    expectedFiles: readonly string[];
+    suggestion: string;
+}>;
+export declare function contentSummaryHasPushableContent(summary: ContentSummary): boolean;
 type MergeRemoteValidationInput = Readonly<{
     target: EnvTarget;
     pushScope: PushScope;

package/dist/_dts/sdk/src/cli/commands/push.d.ts

@@ -11,6 +11,7 @@
  *   riverbankcms push pages              # Push pages with blocks
  *   riverbankcms push pages home         # Push specific page with blocks
  *   riverbankcms push navigation         # Push navigation menus
+ *   riverbankcms push settings           # Push site settings
  *   riverbankcms push footer             # Push footer content
  *   riverbankcms push theme              # Push activeTheme from config (or 'current')
  *   riverbankcms push theme modern       # Push specific theme file
@@ -18,6 +19,7 @@
  *   riverbankcms push --dry-run          # Show what would be pushed
  */
 import { Command } from 'commander';
+export { contentSummaryHasPushableContent, noContentFoundWarningDetails } from './push-execute';
 export { VALID_PUSH_SCOPES, isValidPushScope, type PushScope } from './push/consts';
 export { calculateMetadataUpdates, type MetadataUpdateFlags } from './push/metadata';
 export { filterLocalContent, type FilterResult } from './push/filter';

package/dist/_dts/sdk/src/cli/content/reader.d.ts

@@ -12,6 +12,7 @@ export interface LocalEntry {
     status?: 'draft' | 'published';
     hasUnpublishedChanges?: boolean;
     slug?: string;
+    manualOrder?: number;
 }
 export declare class LegacyEntryTitleError extends Error {
     readonly filePath: string;
@@ -376,6 +377,7 @@ export interface ContentSummary {
 export declare function getContentSummary(contentDir: string): Promise<ContentSummary>;
 export interface EntryMetadata {
     pulledAt: string;
+    manualOrder?: string[];
     entries: Record<string, {
         id?: string;
         createdAt?: string;
@@ -397,6 +399,10 @@ export interface NavigationMetadata {
         updatedAt?: string;
     }>;
 }
+export interface SettingsMetadata {
+    pulledAt: string;
+    updatedAt: string | null;
+}
 /**
  * Read metadata for a content type from .meta/ directory
  *
@@ -412,6 +418,13 @@ export declare function readEntriesMeta(contentDir: string, contentType: string)
  * @returns Map of content type to metadata
  */
 export declare function readAllMeta(contentDir: string): Promise<Map<string, EntryMetadata>>;
+/**
+ * Read settings metadata from .meta/settings.json
+ *
+ * @param contentDir - Base content directory
+ * @returns Settings metadata or null if not found
+ */
+export declare function readSettingsMeta(contentDir: string): Promise<SettingsMetadata | null>;
 /**
  * Read pages metadata from .meta/pages.json
  *

package/dist/_dts/sdk/src/cli/content/writer.d.ts

@@ -50,7 +50,7 @@ export declare function writeNavigation(contentDir: string, pulledNavigation: Pu
  *
  * Format: content/settings.json
  */
-export declare function writeSettings(contentDir: string, pulledSettings: PulledSettings): Promise<string>;
+export declare function writeSettings(contentDir: string, pulledSettings: PulledSettings, options?: WriterOptions): Promise<string>;
 /**
  * Write forms to content directory
  *
@@ -195,6 +195,7 @@ export declare function updateMetadataAfterPush(contentDir: string, remoteConten
         updatedAt: string;
         createdAt?: string;
     }>;
+    settingsUpdatedAt?: string | null;
     forms?: Array<{
         slug: string;
         updatedAt: string;

package/dist/_dts/sdk/src/cli/helpers.d.ts

@@ -97,6 +97,7 @@ export interface PulledEntryOutput {
     slug?: string;
     /** Resolved title (routable title when present, otherwise content title) */
     title: string;
+    manualOrder?: number;
 }
 /**
  * Map an entry from API response to pull output format.
@@ -109,6 +110,7 @@ export declare function mapEntryForOutput<T extends {
     hasUnpublishedChanges: boolean;
     slug?: string;
     title: string;
+    manualOrder?: number;
 }>(entry: T): PulledEntryOutput;
 /**
  * Parse pagination options from command flags.

package/dist/_dts/sdk/src/cli/navigationIdentity.d.ts

@@ -0,0 +1,11 @@
+import { navigationMenuIdentity, type NavigationMenuIdentity, type NavigationMenuIdentityInput } from '../../../api/src/navigation';
+import { type Result } from '../../../core/src/index';
+export type NavigationIdentityInput = NavigationMenuIdentityInput;
+export type DuplicateNavigationIdentityError = Readonly<{
+    code: 'duplicate_navigation_identity';
+    identity: NavigationMenuIdentity;
+    menuNames: readonly string[];
+}>;
+export declare const navigationIdentity: typeof navigationMenuIdentity;
+export declare function navigationIdentityMap<T extends NavigationIdentityInput>(menus: readonly T[]): Result<ReadonlyMap<NavigationMenuIdentity, T>, DuplicateNavigationIdentityError>;
+export declare function duplicateNavigationIdentityMessage(error: DuplicateNavigationIdentityError): string;

package/dist/_dts/sdk/src/cli/site-commands/commandKeys.d.ts

@@ -5,9 +5,9 @@ export type CliPageIdentifier = Brand<string, 'SdkCliPageIdentifier'>;
 export type CliBlockIdentifier = Brand<string, 'SdkCliBlockIdentifier'>;
 export type CliFormSlug = Brand<string, 'SdkCliFormSlug'>;
 export type CliNavigationMenuName = Brand<string, 'SdkCliNavigationMenuName'>;
-export declare const asCliContentTypeKey: (value: string) => CliContentTypeKey;
-export declare const asCliEntryIdentifier: (value: string) => CliEntryIdentifier;
-export declare const asCliPageIdentifier: (value: string) => CliPageIdentifier;
-export declare const asCliBlockIdentifier: (value: string) => CliBlockIdentifier;
-export declare const asCliFormSlug: (value: string) => CliFormSlug;
-export declare const asCliNavigationMenuName: (value: string) => CliNavigationMenuName;
+export declare const unsafeAsCliContentTypeKey: (value: string) => CliContentTypeKey;
+export declare const unsafeAsCliEntryIdentifier: (value: string) => CliEntryIdentifier;
+export declare const unsafeAsCliPageIdentifier: (value: string) => CliPageIdentifier;
+export declare const unsafeAsCliBlockIdentifier: (value: string) => CliBlockIdentifier;
+export declare const unsafeAsCliFormSlug: (value: string) => CliFormSlug;
+export declare const unsafeAsCliNavigationMenuName: (value: string) => CliNavigationMenuName;