@riverbankcms/sdk 0.81.0 → 0.84.0

package/dist/_dts/blocks/src/system/blocks/site-header.d.ts

@@ -1,8 +1,41 @@
+import type { NodeDefinition } from '../node';
 import type { SystemBlockDefinition } from '../registry';
-export declare const siteHeaderManifest: import("..").DefinedBlockManifest<{
+export declare const siteHeaderManifest: import("..").DefinedBlockManifest<import("..").BlockContentShapeInput<{
+    readonly id: "block.site-header";
+    readonly title: "Site Header";
+    readonly category: "layout";
+    readonly additionalFields: readonly [{
+        readonly id: "mode";
+        readonly type: "select";
+        readonly label: "Header display";
+        readonly required: false;
+        readonly multiple: false;
+        readonly defaultValue: "default";
+        readonly options: [{
+            readonly value: "default";
+            readonly label: "Show header";
+        }, {
+            readonly value: "hidden";
+            readonly label: "Hide header";
+        }];
+        readonly ui: {
+            readonly intent: "display";
+        };
+    }];
     readonly skipSectionStyles: true;
-}>;
+    readonly managesOwnWrapper: true;
+    readonly layout: NodeDefinition;
+    readonly description: "Site-wide header with logo, navigation, and optional CTA.";
+    readonly styleTokens: {
+        readonly spacing: "sm";
+    };
+    readonly paletteHidden: true;
+}>>;
 export type SiteHeaderManifest = typeof siteHeaderManifest;
 export type SiteHeaderVariant = 'classic' | 'centered' | 'transparent' | 'floating';
-export type SiteHeaderContent = Record<string, never>;
+export declare const SITE_HEADER_MODES: readonly ["default", "hidden"];
+export type SiteHeaderMode = (typeof SITE_HEADER_MODES)[number];
+export type SiteHeaderContent = Readonly<{
+    mode?: SiteHeaderMode | null;
+}>;
 export declare const siteHeaderBlockDefinition: SystemBlockDefinition<SiteHeaderContent>;

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

@@ -25,17 +25,17 @@ 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 minItems: number;
+        readonly maxItems?: number | undefined;
         readonly visibleRoles?: ("admin" | "designer" | "author")[] | undefined;
+        readonly defaultValue?: any;
         readonly itemLabel: string;
         readonly itemLabelSource?: string | undefined;
         readonly showSummary?: boolean | undefined;
         readonly summaryFields?: string[] | undefined;
         readonly summaryMaxChars?: number | undefined;
-        readonly minItems: number;
-        readonly maxItems?: number | undefined;
         readonly polymorphic?: boolean | undefined;
         readonly allowConversion: boolean;
         readonly schema?: {

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/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.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 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.contact-newsletter", "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,6 @@
 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';
@@ -164,11 +164,13 @@ 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;
@@ -186,4 +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,8 +4,8 @@
  */
 export { prefetchBlockData } from './prefetchBlockData';
 export type { PrefetchBlockDataOptions } from './prefetchBlockData';
-export { LINKED_CONTENT_ENTRY_META_KEY, buildLinkedContentEditTarget, coerceLinkedContentEntriesPayload, describeLinkedContentEditSupport, getLinkedContentEntryMeta, } from './linkedContentEntries';
-export type { LinkedContentEditSupport, LinkedContentEditTarget, LinkedContentEntryMeta, LinkedContentEntryRecord, PublicContentTypeFieldMeta, PublicContentTypeMeta, } from './linkedContentEntries';
+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

@@ -38,6 +38,7 @@ export type LinkedContentEntryMeta = Readonly<{
     optimisticHash: string | null;
     support: LinkedContentEditSupport;
     contentType: PublicContentTypeMeta;
+    fieldSources: readonly LinkedEntryFieldSource[];
 }>;
 export type LinkedContentEditTarget = Readonly<{
     kind: 'linked-content-entry';
@@ -52,6 +53,38 @@ export type LinkedContentEditTarget = Readonly<{
     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;
@@ -61,4 +94,9 @@ export declare function buildLinkedContentEditTarget(input: {
     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/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/fields/aspectRatio.d.ts

@@ -1,5 +1,5 @@
 import type { FieldDefinition } from '../manifest/schema';
-export type StandardAspectRatio = 'auto' | '16/9' | '4/3' | '1/1' | '3/4';
+export type StandardAspectRatio = 'auto' | '16/9' | '4/3' | '1/1' | '3/4' | '9/16';
 type FieldUi = NonNullable<FieldDefinition['ui']>;
 type FieldVisibleWhen = FieldUi['visibleWhen'];
 export declare const standardAspectRatioOptions: readonly [{
@@ -17,6 +17,9 @@ export declare const standardAspectRatioOptions: readonly [{
 }, {
     readonly value: "3/4";
     readonly label: "3:4 (Portrait)";
+}, {
+    readonly value: "9/16";
+    readonly label: "9:16 (Tall portrait)";
 }];
 type AspectRatioFieldOptions = Readonly<{
     id?: string;

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

@@ -0,0 +1,30 @@
+import type { FieldDefinition } from '../manifest/schema';
+export type StandardImageShape = 'default' | 'square' | 'rounded' | 'circle' | 'arch';
+type FieldUi = NonNullable<FieldDefinition['ui']>;
+type FieldVisibleWhen = FieldUi['visibleWhen'];
+export declare const standardImageShapeOptions: readonly [{
+    readonly value: "default";
+    readonly label: "Default";
+}, {
+    readonly value: "square";
+    readonly label: "Square corners";
+}, {
+    readonly value: "rounded";
+    readonly label: "Rounded corners";
+}, {
+    readonly value: "circle";
+    readonly label: "Circle";
+}, {
+    readonly value: "arch";
+    readonly label: "Arch";
+}];
+type ImageShapeFieldOptions = Readonly<{
+    id?: string;
+    label?: string;
+    description?: string;
+    defaultValue?: StandardImageShape;
+    uiIntent?: 'display' | 'style';
+    visibleWhen?: FieldVisibleWhen;
+}>;
+export declare function createImageShapeField(options?: ImageShapeFieldOptions): FieldDefinition;
+export {};

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

@@ -1,5 +1,30 @@
 export declare const heroLayoutControlsFragment: import("..").DefinedFragment<{
     readonly fields: readonly [{
+        readonly id: "titleSize";
+        readonly type: "select";
+        readonly label: "Title size";
+        readonly description: "Adjust the visual scale of the hero title.";
+        readonly required: false;
+        readonly ui: {
+            readonly intent: "display";
+        };
+        readonly options: [{
+            readonly value: "auto";
+            readonly label: "Auto";
+        }, {
+            readonly value: "quiet";
+            readonly label: "Normal";
+        }, {
+            readonly value: "editorial";
+            readonly label: "Large";
+        }, {
+            readonly value: "display";
+            readonly label: "Huge";
+        }, {
+            readonly value: "poster";
+            readonly label: "Poster";
+        }];
+    }, {
         readonly id: "contentAlignment";
         readonly type: "select";
         readonly label: "Content alignment";