@riverbankcms/sdk 0.80.0 → 0.82.0

package/dist/_dts/blocks/src/system/blocks/team-members.d.ts

@@ -25,10 +25,10 @@ export declare const teamMembersManifest: import("..").DefinedBlockManifest<impo
         readonly id: string;
         readonly type: "repeater";
         readonly label: string;
-        readonly description?: string | undefined;
         readonly required: boolean;
-        readonly defaultValue?: any;
+        readonly description?: string | undefined;
         readonly visibleRoles?: ("admin" | "designer" | "author")[] | undefined;
+        readonly defaultValue?: any;
         readonly itemLabel: string;
         readonly itemLabelSource?: string | undefined;
         readonly showSummary?: boolean | undefined;

package/dist/_dts/blocks/src/system/blocks/testimonials.d.ts

@@ -6,6 +6,9 @@ export declare const testimonialsManifest: import("..").DefinedBlockManifest<imp
     readonly title: "Testimonials";
     readonly category: "marketing";
     readonly includeContainerStyles: true;
+    readonly previewCustomize: {
+        readonly quickFieldPriority: ["avatarLayout", "gridColumns", "slidesToShow", "maxEntries", "autoplay"];
+    };
     readonly layout: NodeDefinition;
     readonly variants: {
         readonly carousel: NodeDefinition;

package/dist/_dts/blocks/src/system/componentFactory.d.ts

@@ -12,6 +12,7 @@ type RenderOptions = {
     viewModelOverrides?: Record<string, unknown>;
     data?: Record<string, unknown>;
     pathBase?: string;
+    imageResolveContext?: Parameters<typeof resolveTree>[1]["imageResolveContext"];
 };
 /**
  * Resolves the layout definition for a block based on its manifest and content.

package/dist/_dts/blocks/src/system/constants/background.d.ts

@@ -54,7 +54,7 @@ export declare const BACKGROUND_POSITION_PRESETS: readonly [{
     readonly value: "right bottom";
     readonly label: "Right Bottom";
 }];
-export declare const BACKGROUND_POSITION_PRESET_VALUES: ("center" | "left" | "right" | "top" | "bottom" | "right center" | "top left" | "top right" | "bottom left" | "bottom right" | "top center" | "bottom center" | "left center" | "left top" | "right top" | "left bottom" | "right bottom")[];
+export declare const BACKGROUND_POSITION_PRESET_VALUES: ("left" | "right" | "center" | "top" | "bottom" | "right center" | "top left" | "top right" | "bottom left" | "bottom right" | "top center" | "bottom center" | "left center" | "left top" | "right top" | "left bottom" | "right bottom")[];
 /**
  * Maps position keywords to rb-* anchor positioning classes.
  * Used for positioning scaled/overflow images within their containers.

package/dist/_dts/blocks/src/system/constants/blockKinds.d.ts

@@ -1,4 +1,4 @@
-export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.appointment-booking", "block.event-registration", "block.event-details", "block.course-registration", "block.course-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
+export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.appointment-booking", "block.event-registration", "block.event-details", "block.course-registration", "block.course-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.offerings-preview", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
 export type SystemBlockKind = (typeof SYSTEM_BLOCK_KINDS)[number];
 export type CustomBlockKind = `custom.${string}`;
 export type BlockKind = SystemBlockKind | CustomBlockKind;

package/dist/_dts/blocks/src/system/customize/backgrounds.d.ts

@@ -1,6 +1,7 @@
 import { type MediaAssetId } from '../../../../core/src/index';
-import { type AppearancePresetId, type LayoutVariantKey } from '../../../../theme-core/src/site-styles/index';
-import { type ThemeColorToken } from '../../../../theme-core/src/tokens/index';
+import { type ThemeBackgroundTextLegibilityPlan, type AppearancePresetId, type LayoutVariantKey } from '../../../../theme-core/src/site-styles/index';
+import type { ThemeColorToken } from '../../../../theme-core/src/tokens/index';
+import type { RenderableMediaAsset } from '../../../../media-core/src/index';
 export type BackgroundMode = 'default' | 'color' | 'gradient' | 'image';
 export type BackgroundModeCycleDirection = 'prev' | 'next';
 export type BackgroundColorToken = ThemeColorToken & {
@@ -31,12 +32,19 @@ export type ParsedBackgroundOverride = Readonly<{
     background: Readonly<Record<string, unknown>>;
 }>;
 export type BackgroundImagePoolSource = 'current' | 'generated-ambient' | 'previous-background' | 'general-media';
-export type BackgroundImagePoolItem = Readonly<{
+export type BackgroundImagePoolMediaAsset = RenderableMediaAsset;
+type BaseBackgroundImagePoolItem = Readonly<{
     mediaId: MediaAssetId;
-    source: BackgroundImagePoolSource;
     label?: string;
     rank?: number;
 }>;
+export type BackgroundImagePoolItem = Readonly<BaseBackgroundImagePoolItem & {
+    source: 'current';
+    mediaAsset?: BackgroundImagePoolMediaAsset;
+}> | Readonly<BaseBackgroundImagePoolItem & {
+    source: Exclude<BackgroundImagePoolSource, 'current'>;
+    mediaAsset: BackgroundImagePoolMediaAsset;
+}>;
 export type BackgroundContrastTreatment = Readonly<{
     kind: 'theme-foreground';
     minContrastRatio: 4.5;
@@ -149,17 +157,20 @@ export type ResolveBackgroundCapabilityInput = Readonly<{
 }>;
 export declare const BACKGROUND_MODES: readonly ["default", "color", "gradient", "image"];
 export declare const DEFAULT_BACKGROUND_OVERRIDE: BackgroundOverride;
-export declare const BACKGROUND_CUSTOMIZABLE_BLOCK_KINDS: readonly ["block.hero", "block.testimonials", "block.cta-full", "block.form"];
+export declare const BACKGROUND_CUSTOMIZABLE_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.testimonials", "block.cta-full", "block.form"];
+export declare const BACKGROUND_COLOR_ONLY_BLOCK_KINDS: readonly ["block.intro"];
 export declare const BACKGROUND_RICH_LAYOUT_FAMILIES: readonly ["split"];
 export declare const BACKGROUND_RICH_SECTION_SURFACES: readonly ["hero-image"];
 export declare function isBackgroundCustomizableBlockKind(blockKind: string): boolean;
 export type BackgroundColorPalette = Readonly<Record<string, string | null | undefined>>;
 export declare const backgroundColorTokens: readonly BackgroundColorToken[];
+export declare const quickBackgroundColorTokens: readonly BackgroundColorToken[];
 export declare const recommendedBackgroundColorTokens: readonly BackgroundColorToken[];
 export declare const advancedBackgroundColorTokens: BackgroundColorToken[];
 export declare function parseBackgroundColorToken(value: unknown): BackgroundColorToken | null;
 export declare function isBackgroundColorToken(value: unknown): value is BackgroundColorToken;
 export declare function foregroundTokenForBackgroundColorToken(token: BackgroundColorToken): string;
+export declare function planBackgroundColorTextLegibility(token: BackgroundColorToken): ThemeBackgroundTextLegibilityPlan;
 export declare function dedupeBackgroundColorTokensByPalette(tokens: readonly BackgroundColorToken[], palette: BackgroundColorPalette): readonly BackgroundColorToken[];
 export declare function parseGradientPresetId(value: unknown): GradientPresetId | null;
 export declare function isGradientPresetId(value: unknown): value is GradientPresetId;
@@ -177,3 +188,6 @@ export declare function planBackgroundTransition(current: BackgroundOverride, ca
 export declare function planBackgroundOverride(current: ParsedBackgroundOverride, capability: BackgroundCapability, override: BackgroundOverride): BackgroundOverridePlan;
 export declare function rankBackgroundImagePoolItems(items: readonly BackgroundImagePoolItem[]): readonly BackgroundImagePoolItem[];
 export declare function enabledBackgroundModes(capability: BackgroundCapability): readonly BackgroundMode[];
+export declare function backgroundColorTokensForValueCycling(capability: BackgroundCapability): readonly BackgroundColorToken[];
+export declare function canCycleBackgroundOverrideValue(override: BackgroundOverride, capability: BackgroundCapability): boolean;
+export {};

package/dist/_dts/blocks/src/system/customize/facets.d.ts

@@ -27,7 +27,7 @@ export declare const eventCalendarListLayoutFacet: {
     readonly label: "List style";
     readonly values: {
         value: "compact" | "grid" | "stack";
-        label: "Compact" | "Grid" | "Stack";
+        label: "Compact" | "Stack" | "Grid";
     }[];
     readonly defaultValue: "stack";
     readonly target: {
@@ -41,7 +41,7 @@ export declare const systemCustomizeFacetDefinitions: readonly [{
     readonly label: "List style";
     readonly values: {
         value: "compact" | "grid" | "stack";
-        label: "Compact" | "Grid" | "Stack";
+        label: "Compact" | "Stack" | "Grid";
     }[];
     readonly defaultValue: "stack";
     readonly target: {

package/dist/_dts/blocks/src/system/data/index.d.ts

@@ -4,6 +4,8 @@
  */
 export { prefetchBlockData } from './prefetchBlockData';
 export type { PrefetchBlockDataOptions } from './prefetchBlockData';
+export { LINKED_CONTENT_ENTRY_META_KEY, buildLinkedContentEditTarget, coerceLinkedContentEntriesPayload, describeLinkedContentEditSupport, getLinkedContentEntryMeta, resolveLinkedEntryInlineFieldEligibility, } from './linkedContentEntries';
+export type { LinkedEntryFieldSource, LinkedEntryInlineFieldEligibility, LinkedEntryInlineFieldReadOnlyReason, LinkedContentEditSupport, LinkedContentEditTarget, LinkedContentEntryMeta, LinkedContentEntryRecord, PreviewLinkedEntryFieldBinding, PreviewLinkedEntryInlineFieldType, PreviewLinkedEntryWriteBinding, PublicContentTypeFieldMeta, PublicContentTypeMeta, } from './linkedContentEntries';
 export { initialPreviewResolvedDataState, previewResolvedDataReducer, selectPreviewResolvedData, } from './previewResolvedDataState';
 export type { PreviewLoaderError, PreviewResolvedDataAction, PreviewResolvedDataState, } from './previewResolvedDataState';
 export { SUPPORTED_LOADER_ENDPOINTS, isSupportedLoaderEndpoint, } from './loaderEndpoints';

package/dist/_dts/blocks/src/system/data/linkedContentEntries.d.ts

@@ -0,0 +1,102 @@
+export declare const LINKED_CONTENT_ENTRY_META_KEY: "__rbLinkedContentEntry";
+export type PublicContentTypeFieldMeta = Readonly<{
+    id: string;
+    type: string;
+    mediaKinds?: readonly string[] | null;
+    fileKinds?: readonly string[] | null;
+}>;
+export type PublicContentTypeMeta = Readonly<{
+    key: string;
+    titleField: string | null;
+    fields: readonly PublicContentTypeFieldMeta[];
+    previewLinkedEntryEditing?: PublicContentTypeLinkedEntryEditing | null;
+}>;
+export type PublicContentTypeLinkedEntryEditing = Readonly<{
+    kind: 'generic';
+}> | Readonly<{
+    kind: 'unsupported-domain-backed';
+    reason: string;
+}>;
+export type LinkedContentEditSupport = Readonly<{
+    kind: 'supported';
+}> | Readonly<{
+    kind: 'unsupported-domain-backed';
+    reason: string;
+}> | Readonly<{
+    kind: 'unsupported-content-type';
+    reason: string;
+}> | Readonly<{
+    kind: 'unsupported-missing-schema';
+    reason: string;
+}>;
+export type LinkedContentEntryMeta = Readonly<{
+    kind: 'linked-content-entry';
+    entryId: string;
+    contentTypeKey: string;
+    contentTypeLabel: string;
+    title: string;
+    optimisticHash: string | null;
+    support: LinkedContentEditSupport;
+    contentType: PublicContentTypeMeta;
+    fieldSources: readonly LinkedEntryFieldSource[];
+}>;
+export type LinkedContentEditTarget = Readonly<{
+    kind: 'linked-content-entry';
+    entryId: string;
+    contentTypeKey: string;
+    contentTypeLabel: string;
+    title: string;
+    sourceBlockId: string | null;
+    sourceBlockKind: string | null;
+    itemIndex: number;
+    content: Record<string, unknown>;
+    optimisticHash: string | null;
+    contentType: PublicContentTypeMeta;
+}>;
+export type PreviewLinkedEntryInlineFieldType = 'text' | 'richText';
+export type LinkedEntryInlineFieldReadOnlyReason = 'missing-entry-meta' | 'unsupported-content-type' | 'missing-field-schema' | 'unsupported-field-type' | 'unmapped-display-path' | 'route-field' | 'derived-field';
+export type LinkedEntryFieldSource = Readonly<{
+    kind: 'content-field';
+    displayPath: string;
+    fieldPath: string;
+    fieldType: PreviewLinkedEntryInlineFieldType;
+}> | Readonly<{
+    kind: 'read-only';
+    displayPath: string;
+    reason: LinkedEntryInlineFieldReadOnlyReason;
+}>;
+export type PreviewLinkedEntryWriteBinding = Readonly<{
+    kind: 'linked-entry-write-field';
+    entryId: string;
+    fieldPath: string;
+    fieldType: PreviewLinkedEntryInlineFieldType;
+}>;
+export type PreviewLinkedEntryFieldBinding = Readonly<{
+    kind: 'linked-entry-field';
+    target: LinkedContentEditTarget;
+    write: PreviewLinkedEntryWriteBinding;
+    displayPath: string;
+}>;
+export type LinkedEntryInlineFieldEligibility = Readonly<{
+    kind: 'editable';
+    write: PreviewLinkedEntryWriteBinding;
+    displayPath: string;
+}> | Readonly<{
+    kind: 'read-only';
+    reason: LinkedEntryInlineFieldReadOnlyReason;
+}>;
+export type LinkedContentEntryRecord = Record<string, unknown> & Partial<Record<typeof LINKED_CONTENT_ENTRY_META_KEY, LinkedContentEntryMeta>>;
+export declare function coerceLinkedContentEntriesPayload(payload: unknown): unknown;
+export declare function getLinkedContentEntryMeta(value: unknown): LinkedContentEntryMeta | null;
+export declare function buildLinkedContentEditTarget(input: {
+    entry: unknown;
+    sourceBlockId?: string | null;
+    sourceBlockKind?: string | null;
+    itemIndex: number;
+}): LinkedContentEditTarget | null;
+export declare function resolveLinkedEntryInlineFieldEligibility(input: {
+    entry: unknown;
+    displayPath: string;
+    renderedNodeType: 'text' | 'richText';
+}): LinkedEntryInlineFieldEligibility;
+export declare function describeLinkedContentEditSupport(support: LinkedContentEditSupport): string;

package/dist/_dts/blocks/src/system/data/loaderEndpoints.d.ts

@@ -1,3 +1,3 @@
-export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "getPublicEventDetails", "listPublicCourses", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices"];
+export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "getPublicEventDetails", "listPublicCourses", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices"];
 export type SupportedLoaderEndpoint = typeof SUPPORTED_LOADER_ENDPOINTS[number];
 export declare function isSupportedLoaderEndpoint(endpoint: string): endpoint is SupportedLoaderEndpoint;

package/dist/_dts/blocks/src/system/defineBlock.d.ts

@@ -1,4 +1,4 @@
-import type { BlockManifest, BlockCategory, StyleTokenConfig, BehaviourConfig } from './manifest/schema';
+import type { BlockManifest, BlockCategory, PreviewCustomizeManifestCuration, StyleTokenConfig, BehaviourConfig } from './manifest/schema';
 import type { NodeDefinition } from './node';
 import { type FragmentFieldConfigInput, type FragmentConfigInputOf, type FragmentDefinition } from './fragments';
 /**
@@ -68,6 +68,8 @@ export type BlockConfig = {
     paletteHidden?: boolean;
     /** Block manages its own wrapper (for sticky/fixed positioning) */
     managesOwnWrapper?: boolean;
+    /** Optional Preview Customize quick-control curation. */
+    previewCustomize?: PreviewCustomizeManifestCuration;
     /** Content types this block is compatible with */
     contentTypes?: readonly string[];
 };

package/dist/_dts/blocks/src/system/designCapabilities.d.ts

@@ -1,4 +1,4 @@
-import { type BlockDesignCapability, type DesignedBlockDesignCapability, type DesignedBlockDesignCapabilityInput, type EyebrowTreatment, type BlockDesignCapabilityMap, type BlockDesignMetadataMap, type NonEmptyReadonlyArray, type UnsupportedBlockDesignCapabilityReason } from '../../../theme-core/src/site-styles/index';
+import { type BlockDesignCapability, type DesignedBlockDesignCapability, type DesignedBlockDesignCapabilityInput, type EyebrowTreatment, type BlockDesignCapabilityMap, type BlockDesignMetadataMap, type NonEmptyReadonlyArray, type NoExtraKeys, type UnsupportedBlockDesignCapabilityReason } from '../../../theme-core/src/site-styles/index';
 import type { AnyBlockRuntimeDefinition } from '../contracts';
 import type { SystemBlockDefinition } from './registry';
 export type NoBlockDesignCapabilityReason = UnsupportedBlockDesignCapabilityReason;
@@ -9,7 +9,7 @@ export type BlockDesignCapabilityDeclaration = Readonly<{
     kind: 'none';
     reason: NoBlockDesignCapabilityReason;
 }>;
-export declare function declareBlockDesignCapability(capability: DesignedBlockDesignCapabilityInput): BlockDesignCapabilityDeclaration;
+export declare function declareBlockDesignCapability<const TCapability extends DesignedBlockDesignCapabilityInput>(capability: NoExtraKeys<TCapability, DesignedBlockDesignCapabilityInput>): BlockDesignCapabilityDeclaration;
 export declare function withEyebrowCapability(declaration: BlockDesignCapabilityDeclaration, eyebrowTreatments: NonEmptyReadonlyArray<EyebrowTreatment>): BlockDesignCapabilityDeclaration;
 export declare function declareNoBlockDesignCapability(reason: NoBlockDesignCapabilityReason): BlockDesignCapabilityDeclaration;
 export declare function resolveDeclaredBlockDesignCapability(declaration: BlockDesignCapabilityDeclaration | undefined): BlockDesignCapability | undefined;

package/dist/_dts/blocks/src/system/fields/boxStyles.d.ts

@@ -81,6 +81,10 @@ export type SectionStylesContent = {
         textColor?: string | null;
         /** Optional color token for headings. Falls back to textColor if not set. */
         headingColor?: string | null;
+        /** Optional color token for links. Falls back to textColor if not set. */
+        linkColor?: string | null;
+        /** Optional color token for supporting copy. Falls back to textColor if not set. */
+        supportingColor?: string | null;
     } | null;
     spacing?: string | null;
     minHeight?: 'none' | 'banner' | 'hero' | 'immersive' | null;
@@ -100,7 +104,8 @@ export type CardStylesContent = {
     spacing?: string | null;
     raised?: boolean | null;
     rounded?: string | null;
-    treatment?: 'accent-quote' | null;
+    cardVariant?: string | null;
+    treatment?: 'accent-quote' | 'editorial-rule' | 'soft-panel' | 'editorial-serif-quote' | 'editorial-open' | null;
 } | null;
 export type ContainerStylesContent = {
     background?: Record<string, unknown> | null;

package/dist/_dts/blocks/src/system/fragments/library/faqHeading.d.ts

@@ -22,4 +22,3 @@ export declare const faqHeadingFragment: import("..").DefinedFragment<{
         };
     }];
 }>;
-export declare const decoratedFaqHeadingLayout: import("../..").NodeDefinition;