@riverbankcms/sdk 0.78.2 → 0.79.0

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/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';
@@ -21,8 +21,9 @@ export type MediaEditorProps = {
     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, previewMaxWidth, preventPreviewUpscale, 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-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/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/navigationCommands.d.ts

@@ -12,6 +12,10 @@ export type CliNavigationCommandCompileError = Readonly<{
     code: 'missing_local_navigation_menu';
     name: CliNavigationMenuName;
     message: string;
+}> | Readonly<{
+    code: 'duplicate_navigation_identity';
+    identity: string;
+    message: string;
 }> | CliCommandValidationCompileError;
 export type CliNavigationCommandCompileInput = Readonly<{
     source: CliNavigationCommandBatchSource;

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

@@ -47,6 +47,7 @@ export type OneOffBlockMutation = Readonly<{
 }>;
 export type OneOffNavigationMutation = Readonly<{
     kind: 'upsert';
+    identifier?: string;
     menuName: string;
     items: readonly NavigationItemInput[];
 }>;

package/dist/_dts/sdk/src/cli/sync/diff.d.ts

@@ -35,6 +35,7 @@ export interface BlockDiff {
 }
 export interface NavigationDiff {
     type: DiffType;
+    identifier?: string | null;
     name: string;
     /** List of changed field paths (for updates) */
     changes?: string[];
@@ -135,6 +136,13 @@ export interface JsonDiffChange {
     /** Status change: publish or unpublish */
     statusChange?: 'publish' | 'unpublish';
 }
+export interface JsonDiffWarning {
+    type: 'duplicate_navigation_identity';
+    source: 'local' | 'remote';
+    identity: string;
+    menuNames: readonly string[];
+    message: string;
+}
 export interface JsonDiff {
     summary: {
         creates: number;
@@ -144,6 +152,7 @@ export interface JsonDiff {
         unpublishes: number;
     };
     changes: JsonDiffChange[];
+    warnings?: readonly JsonDiffWarning[];
 }
 /** JSON diff output for pull --dry-run --json-diff */
 export interface PullJsonDiff {

package/dist/_dts/sdk/src/client/management/types.d.ts

@@ -131,6 +131,7 @@ export interface PulledNavigationMenu {
     updatedAt: string;
 }
 export interface NavigationMenuUpsertInput {
+    identifier?: string;
     name: string;
     isPrimary?: boolean;
     isFooter?: boolean;
@@ -808,6 +809,7 @@ export interface NavigationOperations {
     list(): Promise<ManagementNavigationMenu[]>;
     get(name: string): Promise<ManagementNavigationMenu | null>;
     upsert(input: NavigationMenuUpsertInput): Promise<ManagementNavigationMenu>;
+    delete(menuId: string): Promise<void>;
 }
 export interface SettingsOperations {
     get(): Promise<ManagementSettings>;

package/dist/_dts/sdk/src/config/field-definitions.d.ts

@@ -9,6 +9,8 @@
 import type { LinkValue, Media, TipTapNode } from '../contracts';
 export type VisibilityLevel = 'admin' | 'designer' | 'author';
 export type ReferenceValueFrom = 'id' | 'identifier' | 'slug';
+export declare const SDK_ICON_PICKER_PRESETS: readonly ["cta", "feature"];
+export type SdkIconPickerPreset = (typeof SDK_ICON_PICKER_PRESETS)[number];
 export type MediaDeliveryOptions = {
     sizes?: string;
     widthCandidates?: number[];
@@ -80,7 +82,7 @@ export type FieldUi = Partial<{
     thumbnailAltField: string;
     thumbnailLabelField: string;
     thumbnailCardDensity: 'compact' | 'comfortable';
-    iconPickerPreset: 'cta';
+    iconPickerPreset: SdkIconPickerPreset;
     contentTypeField: string;
     fixedContentType: string;
     valueFrom: 'id' | 'identifier' | 'slug';

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

@@ -1,5 +1,5 @@
 export type { TipTapNode, TipTapMark, Media, LinkValue, InternalRouteOnlyLinkValue, InternalResolvedLinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, } from './content';
-export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CourseDetailsContent, CourseRegistrationContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, ProductDetailContent, ProductListContent, SectionStylesContent, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, } from './system-block-content';
+export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CourseDetailsContent, CourseRegistrationContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, ProductDetailContent, ProductListContent, 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, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, } from './page';
 export type { Theme, ThemeTokens } from './theme';
 export type { CustomCssDeclarationsInput, CustomCssRuleInput, CustomCssNestedRuleInput, CustomCssAtRuleInput, KeyframesAtRuleInput, FontFaceAtRuleInput, MediaAtRuleInput, SupportsAtRuleInput, RawAtRuleInput, } from './custom-css';

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

@@ -5,7 +5,7 @@
  * require importing internal blocks package types.
  */
 import type { LinkValue, Media, TipTapNode } from './content';
-import type { EventCategoryId, VenueId } from '../../../core/src/index';
+import type { Brand, EventCategoryId, VenueId } from '../../../core/src/index';
 type UnknownRecord = Record<string, unknown>;
 type ImageMedia = Omit<Media, 'type'> & {
     type: 'image';
@@ -53,6 +53,20 @@ export type ContainerStylesContent = {
     fullWidth?: boolean | null;
 } | null;
 export type CtaIconName = 'ArrowRight' | 'ArrowLeft' | 'ChevronRight' | 'ChevronLeft' | 'ChevronUp' | 'ChevronDown' | 'ExternalLink' | 'Download' | 'Upload' | 'Mail' | 'Phone' | 'Play' | 'ShoppingCart' | 'Calendar' | 'MapPin' | 'Info' | 'Plus' | 'Minus' | 'Check' | 'X';
+export type SemanticIconId = 'protection-trust' | 'confidentiality' | 'care-support' | 'partnership' | 'warmth' | 'community' | 'personal-guidance' | 'conversation' | 'friendly-welcome' | 'insight-learning' | 'natural-wellbeing' | 'growth' | 'gentle-care' | 'special-touch' | 'ideas' | 'direction' | 'focus' | 'quality' | 'highlight' | 'verified-quality' | 'learning' | 'training' | 'programmes-dates' | 'place' | 'products' | 'packages' | 'time' | 'practical-service' | 'at-home' | 'worldwide' | 'professional-service';
+export type BlockIconValue = {
+    kind: 'none';
+} | {
+    kind: 'semantic';
+    iconId: SemanticIconId;
+} | {
+    kind: 'generated';
+    setId: Brand<string, 'GeneratedIconSetId'>;
+    assetId: Brand<string, 'GeneratedIconAssetId'>;
+    semanticFallbackIconId: SemanticIconId;
+    styleGuideVersionId: Brand<string, 'SiteIconStyleGuideVersionId'>;
+};
+export type FeatureCardIconTreatment = 'plain' | 'soft-badge' | 'utility-badge';
 export type RichTextDoc = {
     type: 'doc';
     content?: Array<{
@@ -306,6 +320,7 @@ export type FaqItem = {
     answer: unknown;
 };
 export type FaqContent = {
+    variant?: 'default' | 'two-column' | 'question-columns' | 'split-heading-columns' | null;
     eyebrow?: string | null;
     title?: string | null;
     description?: unknown;
@@ -315,6 +330,7 @@ export type FaqContent = {
 export type FeatureCard = {
     media?: Media | null;
     aspectRatio?: StandardAspectRatio | null;
+    icon?: BlockIconValue | SemanticIconId | null;
     title: string;
     body?: TipTapNode | null;
     ctas?: BlockCtaContent[] | null;
@@ -324,6 +340,7 @@ export type FeatureCardsContent = {
     title?: string | null;
     description?: TipTapNode | null;
     columns?: '2' | '3' | '4' | null;
+    _iconTreatment?: FeatureCardIconTreatment | null;
     cards?: FeatureCard[] | null;
 };
 export type HeroCta = {
@@ -502,7 +519,7 @@ export type TeamMembersContent = (TeamMembersCommonContent & {
     members?: ManualTeamMemberItem[];
 });
 export type TestimonialsBlockContent = {
-    variant?: 'carousel' | 'grid' | null;
+    variant?: 'carousel' | 'grid' | 'split-grid' | null;
     heading?: string | null;
     subheading?: string | null;
     avatarLayout?: 'above-centered' | 'inline-left' | 'hidden' | null;

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

@@ -40,7 +40,7 @@
 export { createCatchAllPage } from './catch-all';
 export { RiverbankContentLoadError, SdkContentLoadError, classifyContentLoadError, isSdkContentLoadError, toContentLoadFailureLogFields, type CatchAllContentLoadFailureContext, type CatchAllRequestContext, type ClassifiedContentLoadError, type SdkContentLoadFailure, type SdkContentLoadFailureKind, type SdkContentLoadNotFound, } from './content-load-failure';
 export type { CreateCatchAllPageOptions, CreateCatchAllPageResult, CatchAllPageProps, CatchAllContext, ThemeSwitchConfigV1, ThemeResolverContext, } from './types';
-export { generateAllStaticParams, validateStaticParamsEnv, pathToSlugArray, type StaticParamsEnvResult, } from './static-params';
+export { createGenerateStaticParams, generateAllStaticParams, normalizeStaticRoutePath, validateStaticParamsEnv, pathToSlugArray, routesToStaticParams, type CreateGenerateStaticParamsOptions, type GenerateAllStaticParamsOptions, type StaticParam, type StaticParamsClient, type StaticParamsEnvResult, type StaticParamsFailureContext, type StaticParamsFailureMode, type StaticParamsRoute, } from './static-params';
 export { createSitemap, type CreateSitemapOptions, type SitemapGenerator, } from './sitemap';
 export { createRobots, type CreateRobotsOptions } from './robots';
 /**

package/dist/_dts/sdk/src/next/revalidate.d.ts

@@ -17,13 +17,34 @@
  * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';
  *
  * export const POST = createRevalidateHandler({
- *   onRevalidate: (payload, items) => {
- *     console.log(`Revalidated ${items.length} items for ${payload.event}`);
+ *   onRevalidate: (payload, items, metadata) => {
+ *     console.log(`Revalidated ${items.length} items for ${payload.event}`, metadata);
  *   },
  * });
  * ```
  */
 import { type WebhookPayload } from '../webhooks/verify';
+export type NormalizedRevalidationPaths = Readonly<{
+    paths: string[];
+    invalidPaths: string[];
+}>;
+export type RevalidationRequestMetadata = Readonly<{
+    event: WebhookPayload['event'];
+    siteId: string;
+    dispatchId?: string;
+    pathCount: number;
+    tagCount: number;
+    itemCount: number;
+    requestId?: string;
+    correlationId?: string;
+    monitorRunId?: string;
+}>;
+/**
+ * Normalize a public URL path for Next revalidation.
+ */
+export declare function normalizeRevalidationPath(path: string): string | null;
+export declare function normalizeRevalidationPaths(paths?: readonly string[]): NormalizedRevalidationPaths;
+export declare function normalizeRevalidationTags(tags?: readonly string[]): string[];
 /**
  * Options for the revalidation handler.
  */
@@ -36,15 +57,15 @@ export interface RevalidateHandlerOptions {
      * Callback called after successful revalidation.
      * Useful for logging or analytics.
      */
-    onRevalidate?: (payload: WebhookPayload, revalidatedItems: string[]) => void;
+    onRevalidate?: (payload: WebhookPayload, revalidatedItems: string[], metadata: RevalidationRequestMetadata) => void;
 }
 /**
  * Create a Next.js API route handler for webhook revalidation.
  *
  * The handler:
  * 1. Verifies the webhook signature using HMAC-SHA256
- * 2. Calls `revalidateTag()` for each tag in the payload
- * 3. Calls `revalidatePath()` if a path is included in the data
+ * 2. Calls `revalidateTag()` for each normalized tag in the payload
+ * 3. Calls `revalidatePath()` for each normalized path in the payload
  * 4. Returns a JSON response with the revalidation results
  *
  * @param options - Configuration options

package/dist/_dts/sdk/src/next/static-params.d.ts

@@ -11,6 +11,29 @@
  * export { generateAllStaticParams as generateStaticParams };
  * ```
  */
+import type { RiverbankClient } from '../client/types';
+import type { RoutableContentResponse } from '../public-api/contracts';
+export type StaticParam = Readonly<{
+    slug: string[];
+}>;
+export type StaticParamsRoute = Pick<RoutableContentResponse['items'][number], 'path'>;
+export type StaticParamsClient = Pick<RiverbankClient, 'getAllPublishedRoutes'>;
+export type StaticParamsFailureMode = 'throw' | 'fallback';
+export type StaticParamsFailureContext = Readonly<{
+    siteId: string;
+    error: unknown;
+    reason: 'route_discovery_failed' | 'invalid_route_path';
+    path?: string;
+}>;
+export type CreateGenerateStaticParamsOptions = Readonly<{
+    getClient: () => StaticParamsClient | Promise<StaticParamsClient>;
+    siteId: string;
+    failureMode?: StaticParamsFailureMode;
+    fallbackPaths?: readonly string[];
+    onFailure?: (context: StaticParamsFailureContext) => void;
+    signal?: AbortSignal;
+}>;
+export type GenerateAllStaticParamsOptions = Pick<CreateGenerateStaticParamsOptions, 'failureMode' | 'fallbackPaths' | 'onFailure' | 'signal'>;
 /**
  * Environment variable validation result
  */
@@ -25,6 +48,7 @@ export type StaticParamsEnvResult = {
     valid: false;
     missingVars: string[];
 };
+export declare function dashboardUrlToApiBaseUrl(input: string): string;
 /**
  * Validate that all required environment variables are set.
  *
@@ -36,6 +60,7 @@ export type StaticParamsEnvResult = {
  * @returns Validation result with config or missing vars
  */
 export declare function validateStaticParamsEnv(): StaticParamsEnvResult;
+export declare function normalizeStaticRoutePath(path: string): string;
 /**
  * Convert a route path to a Next.js slug array.
  *
@@ -50,6 +75,8 @@ export declare function validateStaticParamsEnv(): StaticParamsEnvResult;
  * ```
  */
 export declare function pathToSlugArray(path: string): string[];
+export declare function routesToStaticParams(routes: readonly StaticParamsRoute[]): StaticParam[];
+export declare function createGenerateStaticParams(options: CreateGenerateStaticParamsOptions): () => Promise<StaticParam[]>;
 /**
  * Generate static params for all published routes.
  *
@@ -79,6 +106,4 @@ export declare function pathToSlugArray(path: string): string[];
  * }
  * ```
  */
-export declare function generateAllStaticParams(): Promise<{
-    slug: string[];
-}[]>;
+export declare function generateAllStaticParams(options?: GenerateAllStaticParamsOptions): Promise<StaticParam[]>;

package/dist/_dts/sdk/src/public-api/contracts.d.ts

@@ -810,7 +810,7 @@ export type SitemapRoutesResponse = {
     pageSize: number;
     allowIndexingInProduction: boolean;
 };
-export type PublicEndpointName = "getSite" | "getContentByPath" | "listPublishedEntries" | "getPublishedEntryPreview" | "getPublicFormById" | "listPublicForms" | "getPublicBookingServices" | "getPublicChallenge" | "listPublicEvents" | "batchBlockLoaders" | "listPublicCourses" | "listPublicTeamMembers" | "listPublicProducts" | "listPublicPasses" | "listPublicMemberships" | "resolveEntrySubroute" | "resolveEventOccurrence" | "checkRedirect" | "getRoutableContent" | "getPublicSitemapRoutes";
+export type PublicEndpointName = "getSite" | "getContentByPath" | "listPublishedEntries" | "getPublishedEntryPreview" | "getPublicFormById" | "listPublicForms" | "getPublicBookingServices" | "getPublicChallenge" | "listPublicEvents" | "batchBlockLoaders" | "listPublicCourses" | "listPublicTeamMembers" | "listPublicProducts" | "listPublicPasses" | "listPublicMemberships" | "resolveEntrySubroute" | "resolveEventOccurrence" | "checkRedirect" | "getRoutableContent" | "getPublicRoutableContent" | "getPublicSitemapRoutes";
 export type PublicAPIEndpoints = {
     getSite: APIEndpointBase<never, {
         id?: string;
@@ -949,6 +949,10 @@ export type PublicAPIEndpoints = {
         siteId: string;
         publishedOnly?: string;
     }, RoutableContentResponse>;
+    getPublicRoutableContent: APIEndpointBase<never, {
+        siteId: string;
+        publishedOnly?: string;
+    }, RoutableContentResponse>;
     getPublicSitemapRoutes: APIEndpointBase<never, {
         siteId: string;
         page?: string;

package/dist/_dts/sdk/src/public-api/runtime.d.ts

@@ -1,5 +1,5 @@
 import type { ApiResult, HTTPMethod, PublicAPIEndpoints, PublicEndpointName } from './contracts';
-export declare const PUBLIC_ENDPOINT_NAMES: readonly ["getSite", "getContentByPath", "listPublishedEntries", "getPublishedEntryPreview", "getPublicFormById", "listPublicForms", "getPublicBookingServices", "getPublicChallenge", "listPublicEvents", "batchBlockLoaders", "listPublicCourses", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "resolveEntrySubroute", "resolveEventOccurrence", "checkRedirect", "getRoutableContent", "getPublicSitemapRoutes"];
+export declare const PUBLIC_ENDPOINT_NAMES: readonly ["getSite", "getContentByPath", "listPublishedEntries", "getPublishedEntryPreview", "getPublicFormById", "listPublicForms", "getPublicBookingServices", "getPublicChallenge", "listPublicEvents", "batchBlockLoaders", "listPublicCourses", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "resolveEntrySubroute", "resolveEventOccurrence", "checkRedirect", "getRoutableContent", "getPublicRoutableContent", "getPublicSitemapRoutes"];
 export type ApiClient = <E extends PublicEndpointName>(params: {
     endpoint: E;
     params?: PublicAPIEndpoints[E]['query'];

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.78.2";
+export declare const SDK_VERSION = "0.79.0";

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

@@ -1,4 +1,4 @@
 /**
  * Webhook utilities for Riverbank SDK
  */
-export { verifyWebhookSignature, parseWebhookPayload, WebhookPayloadSchema, type WebhookPayload, type ParseWebhookResult, } from './verify';
+export { SUPPORTED_WEBHOOK_EVENTS, verifyWebhookSignature, parseWebhookPayload, RIVERBANK_SIGNATURE_PREFIX, WebhookPayloadSchema, WebhookEventSchema, normalizeRevalidationPath, parseRevalidationPath, unwrapRevalidationPath, type RevalidationPath, type RevalidationPathParseError, type RevalidationPathParseResult, type WebhookEvent, type WebhookPayload, type ParseWebhookResult, } from './verify';