@riverbankcms/sdk 0.107.0 → 0.109.0

package/dist/_dts/blocks/src/contracts/proof-block-islands.d.ts

@@ -256,7 +256,7 @@ export declare const proofBlockIslandCodecs: {
                     className: string | null;
                     titleText: string;
                     bodyText: string;
-                    stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                    stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                     summaryButtonText: string;
                 }>;
                 hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -279,7 +279,7 @@ export declare const proofBlockIslandCodecs: {
                     className: string | null;
                     titleText: string;
                     bodyText: string;
-                    stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                    stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                     summaryButtonText: string;
                 }>;
                 hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -1342,7 +1342,7 @@ export declare const runtimeIslandCodecs: {
                     className: string | null;
                     titleText: string;
                     bodyText: string;
-                    stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                    stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                     summaryButtonText: string;
                 }>;
                 hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -1365,7 +1365,7 @@ export declare const runtimeIslandCodecs: {
                     className: string | null;
                     titleText: string;
                     bodyText: string;
-                    stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                    stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                     summaryButtonText: string;
                 }>;
                 hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;

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

@@ -13,7 +13,7 @@ export * from '../../theme-core/src/schema';
 export * from '../../theme-core/src/site-styles/index';
 export * from '../../theme-core/src/styles/buttons';
 export * from '../../theme-core/src/styles/buttonsLibrary';
-export { type ButtonBackground, type ButtonBorder, type ButtonGlobalSettings, type ButtonSystem, type ButtonVariant, type CornerStyle, type EffectApplication, type FontWeight, type GradientSharpness, type GradientStyle, type HoverColor, type HoverTransform, type ShadowSize, type TextTransform, buttonBackgroundSchema, buttonBorderSchema, buttonGlobalSettingsSchema, buttonSystemSchema, buttonVariantSchema, cornerStyleSchema, effectApplicationSchema, fontWeightSchema, gradientSharpnessSchema, gradientStyleSchema, hoverColorSchema, hoverTransformSchema, shadowSizeSchema, textTransformSchema, generateButtonCss, generateDefaultButtonSystem, buttonPresets, type ButtonPreset, EFFECT_PRESETS, getEffectPreset, getEffectPresetsByCategory, getAllEffectPresets, type EffectCategory, type EffectPreset, type EffectContext, type StateGroup, generateButtonCoreCss, getDefaultButtonVariants, type ButtonVariantCore, type ButtonCoreSettings, type ButtonBackgroundType, type GradientDirection, } from '../../theme-core/src/buttons/index';
+export { type ButtonBackground, type ButtonBorder, type ButtonGlobalSettings, type ButtonSystem, type ButtonVariant, type CornerStyle, type EffectApplication, type FontWeight, type GradientSharpness, type GradientStyle, type HoverColor, type HoverTransform, type ShadowSize, type TextTransform, buttonBackgroundSchema, buttonBorderSchema, buttonGlobalSettingsSchema, buttonSystemSchema, buttonVariantSchema, cornerStyleSchema, effectApplicationSchema, fontWeightSchema, gradientSharpnessSchema, gradientStyleSchema, hoverColorSchema, hoverTransformSchema, shadowSizeSchema, textTransformSchema, generateButtonCss, generateDefaultButtonSystem, buttonPresets, type ButtonPreset, EFFECT_PRESETS, getEffectPreset, getEffectPresetsByCategory, getAllEffectPresets, type EffectCategory, type EffectPreset, type EffectContext, type StateGroup, generateButtonCoreCss, getDefaultButtonVariants, type ButtonVariantCore, type ButtonCoreSettings, type GradientDirection, } from '../../theme-core/src/buttons/index';
 export { type CardBackground, type CardBorder, type CardSpacing, type CardSystem, type CardVariant, type CardVariantRole, type BoxStylesCardVariant, cardBackgroundSchema, cardBorderSchema, cardSpacingSchema, cardSystemSchema, cardVariantSchema, cardVariantRoleSchema, boxStylesCardVariantSchema, normalizeCardVariantRole, normalizeBoxStylesCardVariant, generateCardCss, generateDefaultCardSystem, generateCardCoreCss, getDefaultCardVariants, type CardVariantCore, type CardCoreSettings, type CardBackgroundType, type CardSpacingCore, } from '../../theme-core/src/cards/index';
 export { generateInputCoreCss, getDefaultInputSettings, type InputCoreSettings, } from '../../theme-core/src/inputs/core';
 export * from '../../theme-core/src/tokens/index';

package/dist/_dts/blocks/src/primitives/layout/Section.d.ts

@@ -2,7 +2,6 @@ import React from "react";
 import type { PrimitiveProps } from "../types";
 declare const Section: React.ForwardRefExoticComponent<PrimitiveProps & {
     background?: string;
-    allowOverflow?: boolean;
     /** Data slot attribute for CSS targeting */
     "data-slot"?: string;
 } & React.RefAttributes<HTMLElement>>;

package/dist/_dts/blocks/src/rendering/server.d.ts

@@ -4,4 +4,5 @@ export { makeDefaultBlockComponent, renderBlock } from '../system/componentFacto
 export { getDefaultComponentRegistry } from '../system/runtime/components';
 export { siteHeaderManifest } from '../system/blocks/site-header';
 export { siteFooterManifest } from '../system/blocks/site-footer';
+export { buildFooterRuntimeViewModel, type FooterRuntimeModule, type FooterRuntimeViewModel, } from '../system/blocks/site-footer-runtime';
 export { resolveFooterRenderPlan } from '../../../theme-core/src/footer/mode';

package/dist/_dts/blocks/src/system/blocks/audio-player.d.ts

@@ -5,6 +5,9 @@ export declare const audioPlayerManifest: import("..").DefinedBlockManifest<impo
     readonly title: "Audio Player";
     readonly titleSource: "title";
     readonly category: "media";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly description: "Add a branded audio player for a single track.";
     readonly tags: readonly ["audio", "player", "music", "podcast", "media"];
     readonly icon: "AudioLines";

package/dist/_dts/blocks/src/system/blocks/body-text.d.ts

@@ -5,6 +5,9 @@ export declare const bodyTextManifest: import("..").DefinedBlockManifest<import(
     readonly title: "Body Text";
     readonly titleSource: "heading";
     readonly category: "content";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly fragments: readonly [{
         readonly fragment: import("..").DefinedFragment<{
             readonly fields: readonly [{

package/dist/_dts/blocks/src/system/blocks/contact-newsletter.d.ts

@@ -8,6 +8,9 @@ export declare const contactNewsletterManifest: import("..").DefinedBlockManifes
     readonly titleSource: "contactTitle";
     readonly description: "Two-column newsletter signup and contact form section.";
     readonly category: "interactive";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly layout: import("..").NodeDefinition;
     readonly defaultVariant: "default";
     readonly variants: {

package/dist/_dts/blocks/src/system/blocks/course-registration.d.ts

@@ -111,28 +111,7 @@ export declare const courseRegistrationManifest: import("..").DefinedBlockManife
         readonly multiline: false;
         readonly defaultValue: "Sign up";
         readonly maxLength: 40;
-    }, {
-        readonly id: "buttonVariant";
-        readonly type: "select";
-        readonly label: "Button style";
-        readonly description: "Choose a button style from your theme";
-        readonly required: false;
-        readonly multiple: false;
-        readonly defaultValue: "primary";
-        readonly options: [{
-            readonly value: "primary";
-            readonly label: "Primary";
-        }, {
-            readonly value: "secondary";
-            readonly label: "Secondary";
-        }, {
-            readonly value: "outline";
-            readonly label: "Outline";
-        }];
-        readonly ui: {
-            readonly intent: "style";
-        };
-    }];
+    }, import("../../../../block-form/src/backend/index").FieldDefinition];
 }>;
 export type CourseRegistrationContent = {
     heading?: string | null;

package/dist/_dts/blocks/src/system/blocks/cta-full.d.ts

@@ -5,6 +5,9 @@ declare const ctaFullConfig: {
     readonly id: "block.cta-full";
     readonly title: "Full-width CTA";
     readonly category: "marketing";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly fragments: readonly [{
         readonly fragment: import("..").DefinedFragment<{
             readonly fields: readonly [{

package/dist/_dts/blocks/src/system/blocks/event-registration.d.ts

@@ -100,28 +100,7 @@ export declare const eventRegistrationManifest: import("..").DefinedBlockManifes
         readonly multiline: false;
         readonly defaultValue: "Complete Registration";
         readonly maxLength: 40;
-    }, {
-        readonly id: "buttonVariant";
-        readonly type: "select";
-        readonly label: "Button style";
-        readonly description: "Choose a button style from your theme";
-        readonly required: false;
-        readonly multiple: false;
-        readonly defaultValue: "primary";
-        readonly options: [{
-            readonly value: "primary";
-            readonly label: "Primary";
-        }, {
-            readonly value: "secondary";
-            readonly label: "Secondary";
-        }, {
-            readonly value: "outline";
-            readonly label: "Outline";
-        }];
-        readonly ui: {
-            readonly intent: "style";
-        };
-    }];
+    }, import("../../../../block-form/src/backend/index").FieldDefinition];
 }>;
 export type EventRegistrationContent = {
     heading?: string | null;

package/dist/_dts/blocks/src/system/blocks/file-download.d.ts

@@ -5,6 +5,9 @@ export declare const fileDownloadManifest: import("..").DefinedBlockManifest<imp
     readonly title: "File Download";
     readonly titleSource: ["title", "file.filename"];
     readonly category: "media";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly description: "Add a simple public download link for a document, ZIP, or audio file.";
     readonly tags: readonly ["file", "download", "document", "zip", "media"];
     readonly icon: "Download";

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

@@ -78,6 +78,9 @@ export declare const formManifest: import("..").DefinedBlockManifest<import(".."
         readonly paletteHidden: false;
     };
     readonly category: "interactive";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly tags: readonly ["form", "contact", "input", "submit", "fields", "signup", "lead-capture"];
     readonly icon: "FormInput";
 }>>;

package/dist/_dts/blocks/src/system/blocks/image-gallery.d.ts

@@ -6,6 +6,9 @@ export declare const imageGalleryManifest: import("..").DefinedBlockManifest<imp
     readonly id: "block.image-gallery";
     readonly title: "Image Gallery";
     readonly category: "content";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly previewCustomize: {
         readonly quickFieldPriority: ["aspectRatio", "slidesToShow", "fullBleed", "marqueeSpeed", "marqueePauseOnHover"];
     };

package/dist/_dts/blocks/src/system/blocks/media-text.d.ts

@@ -31,6 +31,9 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
     readonly id: "block.media-text";
     readonly title: "Media and Text";
     readonly category: "layout";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly includeContainerStyles: true;
     readonly titleSource: "title";
     readonly previewCustomize: {

package/dist/_dts/blocks/src/system/blocks/newsletter-signup.d.ts

@@ -8,6 +8,9 @@ export declare const newsletterSignupManifest: import("..").DefinedBlockManifest
     readonly titleSource: "title";
     readonly description: "Newsletter subscription form with configurable field presets.";
     readonly category: "interactive";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly fragments: readonly [{
         readonly fragment: import("..").DefinedFragment<{
             readonly fields: readonly [{

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

@@ -0,0 +1,50 @@
+import { type FooterCompositionV1, type FooterMembershipKey, type FooterModuleId, type PublicProfile } from '../../../../core/src/index';
+export type FooterRuntimeModule = Readonly<{
+    id: FooterModuleId;
+    kind: 'brand' | 'navigation' | 'legal-navigation' | 'business-address' | 'contact' | 'opening-hours' | 'social-links' | 'supporting-text' | 'legal';
+    heading: string | null;
+    navigationClassName?: string;
+    showLogo?: boolean;
+    showTitle?: boolean;
+    address?: string;
+    contactLinks?: readonly Readonly<{
+        href: string;
+        label: string;
+    }>[];
+    openingHours?: readonly Readonly<{
+        weekday: string;
+        hours: string;
+    }>[];
+    timeZone?: string;
+    socialLinks?: readonly Readonly<{
+        href: string;
+        label: string;
+        icon: string | null;
+    }>[];
+    content?: Readonly<Record<string, unknown>>;
+}>;
+export type FooterRuntimeViewModel = Readonly<{
+    membershipKey: FooterMembershipKey;
+    regions: readonly FooterRuntimeRegion[];
+}>;
+export type FooterRuntimeGroup = Readonly<{
+    kind: 'identity' | 'main-navigation' | 'visit' | 'legal-ending';
+    modules: readonly FooterRuntimeModule[];
+}>;
+export type FooterRuntimeRegion = Readonly<{
+    kind: 'main' | 'bottom';
+    className: string;
+    groups: readonly FooterRuntimeGroup[];
+}>;
+type FooterRuntimeViewModelInput = Readonly<{
+    composition: FooterCompositionV1;
+    publicProfile: PublicProfile;
+    businessAddress: string | null;
+    hasFooterNavigation: boolean;
+    hasLegalPolicyNavigation?: boolean;
+    hasLogo?: boolean;
+    legalRegion?: 'integrated' | 'separate';
+    layoutVariant?: 'simple' | 'columns' | 'split';
+}>;
+export declare function buildFooterRuntimeViewModel(input: FooterRuntimeViewModelInput): FooterRuntimeViewModel;
+export {};

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

@@ -1,53 +1,14 @@
-import type { NodeDefinition } from "../node";
-import type { SystemBlockDefinition } from "../registry";
-export declare const siteFooterManifest: import("..").DefinedBlockManifest<import("..").BlockContentShapeInput<{
-    readonly id: "block.site-footer";
-    readonly title: "Site Footer";
-    readonly category: "layout";
-    readonly fragments: readonly [{
-        readonly fragment: import("..").DefinedFragment<{
-            readonly fields: readonly [{
-                readonly id: "bodyText";
-                readonly type: "richText";
-                readonly label: "Body text";
-                readonly description: "Appears in the main footer area.";
-                readonly ui: {
-                    readonly variant: "limited";
-                };
-            }, {
-                readonly id: "bottomText";
-                readonly type: "richText";
-                readonly label: "Bottom bar text";
-                readonly description: "Appears in the optional footer bottom bar.";
-                readonly ui: {
-                    readonly variant: "limited";
-                };
-            }];
-        }>;
-        readonly fieldPriority: 0;
-    }];
+import type { SystemBlockDefinition } from '../registry';
+import type { FooterRuntimeViewModel } from './site-footer-runtime';
+export declare const siteFooterManifest: import("..").DefinedBlockManifest<{
     readonly skipSectionStyles: true;
-    readonly additionalFields: readonly [{
-        readonly id: "showBusinessAddress";
-        readonly type: "boolean";
-        readonly label: "Add business address to site footer?";
-        readonly required: false;
-        readonly defaultValue: false;
-        readonly ui: {
-            readonly intent: "content";
-        };
-    }];
-    readonly layout: NodeDefinition;
-    readonly description: "Site-wide footer with navigation links and optional columns.";
-    readonly styleTokens: {
-        readonly spacing: "md";
-    };
-    readonly paletteHidden: true;
-}>>;
-export type SiteFooterVariant = "simple" | "columns" | "split";
-export type SiteFooterContent = {
+}>;
+export type SiteFooterVariant = 'simple' | 'columns' | 'split';
+export type SiteFooterContent = Readonly<{
+    /** Legacy storage-only fields. The V1 runtime does not read these values. */
     bodyText?: unknown;
     bottomText?: unknown;
     showBusinessAddress?: boolean | null;
-};
+    footerRuntime?: FooterRuntimeViewModel | null;
+}>;
 export declare const siteFooterBlockDefinition: SystemBlockDefinition<SiteFooterContent>;

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

@@ -4,6 +4,9 @@ export declare const siteHeaderManifest: import("..").DefinedBlockManifest<impor
     readonly id: "block.site-header";
     readonly title: "Site Header";
     readonly category: "layout";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly additionalFields: readonly [{
         readonly id: "mode";
         readonly type: "select";

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

@@ -13,6 +13,9 @@ export declare const teamMembersManifest: import("..").DefinedBlockManifest<impo
     readonly id: "block.team-members";
     readonly title: "Team Members";
     readonly category: "content";
+    readonly contentSource: {
+        readonly kind: "mixed";
+    };
     readonly titleSource: "heading";
     readonly additionalFields: readonly [import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, {
         readonly ui: {

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

@@ -5,6 +5,9 @@ export declare const testimonialsManifest: import("..").DefinedBlockManifest<imp
     readonly id: "block.testimonials";
     readonly title: "Testimonials";
     readonly category: "marketing";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly includeContainerStyles: true;
     readonly previewCustomize: {
         readonly quickFieldPriority: ["avatarLayout", "gridColumns", "slidesToShow", "maxEntries", "autoplay"];

package/dist/_dts/blocks/src/system/blocks/video-grid.d.ts

@@ -4,6 +4,9 @@ export declare const videoGridManifest: import("..").DefinedBlockManifest<import
     readonly id: "block.video-grid";
     readonly title: "Video Grid";
     readonly category: "media";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly skipSectionStyles: true;
     readonly additionalFields: import("../../../../block-form/src/backend/index").FieldDefinition[];
     readonly layout: NodeDefinition;

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: ("left" | "right" | "top" | "bottom" | "center" | "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" | "bottom" | "top" | "center" | "right center" | "top center" | "top left" | "top right" | "bottom left" | "bottom right" | "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/customize/backgrounds.d.ts

@@ -1,15 +1,14 @@
 import { type MediaAssetId } from '../../../../core/src/index';
 import { type ThemeBackgroundTextLegibilityPlan, type AppearancePresetId, type LayoutVariantKey, type PageDesignEditorBackgroundSupport } from '../../../../theme-core/src/site-styles/index';
 import type { ThemeColorToken } from '../../../../theme-core/src/tokens/index';
+import { type GradientPresetId } from '../../../../theme-core/src/gradients/index';
 import type { RenderableMediaAsset } from '../../../../media-core/src/index';
+export { isGradientPresetId, parseGradientPresetId, type GradientPresetId, } from '../../../../theme-core/src/gradients/index';
 export type BackgroundMode = 'default' | 'color' | 'gradient' | 'image';
 export type BackgroundModeCycleDirection = 'prev' | 'next';
 export type BackgroundColorToken = ThemeColorToken & {
     readonly __backgroundColorTokenBrand: 'BackgroundColorToken';
 };
-export type GradientPresetId = string & {
-    readonly __brand: 'GradientPresetId';
-};
 export type BackgroundOverride = Readonly<{
     kind: 'default';
 }> | Readonly<{
@@ -31,6 +30,15 @@ export type ParsedBackgroundOverride = Readonly<{
     reason: LegacyBackgroundReason;
     background: Readonly<Record<string, unknown>>;
 }>;
+export type CanonicalSectionBackground = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'block-authored';
+    background: Readonly<Record<string, unknown>>;
+}> | Readonly<{
+    kind: 'page-design-override';
+    parsed: ParsedBackgroundOverride;
+}>;
 export type BackgroundImagePoolSource = 'current' | 'generated-ambient' | 'previous-background' | 'general-media';
 export type BackgroundImagePoolMediaAsset = RenderableMediaAsset;
 type BaseBackgroundImagePoolItem = Readonly<{
@@ -169,8 +177,6 @@ export declare function isBackgroundColorToken(value: unknown): value is Backgro
 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;
 export declare function backgroundModeForOverride(override: BackgroundOverride): BackgroundMode;
 export declare function backgroundOverrideEquals(left: BackgroundOverride, right: BackgroundOverride): boolean;
 export declare function imagePoolForOverride(override: BackgroundOverride): readonly BackgroundImagePoolItem[];
@@ -178,6 +184,11 @@ export declare function defaultBackgroundOverrideForMode(mode: BackgroundMode, c
 export declare function resolveBackgroundCapability(input: ResolveBackgroundCapabilityInput): BackgroundCapability;
 export declare function backgroundCapabilityFromModes(modeCapabilities: readonly BackgroundModeCapability[]): BackgroundCapability;
 export declare function parseBackgroundOverrideFromContent(content: BackgroundCustomizeContent): ParsedBackgroundOverride;
+/**
+ * Classifies persisted content before runtime Look decoration is considered.
+ * Only the explicit owner marker can make a background a page-design override.
+ */
+export declare function parseCanonicalSectionBackground(content: BackgroundCustomizeContent): CanonicalSectionBackground;
 export declare function parseBackgroundOverride(value: unknown): ParsedBackgroundOverride;
 export declare function serializeBackgroundOverride(override: BackgroundOverride): Record<string, unknown> | null;
 export declare function applyBackgroundOverrideContentPatch(content: BackgroundCustomizeContent, override: BackgroundOverride): BackgroundCustomizeContent;
@@ -187,4 +198,3 @@ export declare function rankBackgroundImagePoolItems(items: readonly BackgroundI
 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/defineBlock.d.ts

@@ -1,4 +1,4 @@
-import type { BlockManifest, BlockCategory, PreviewCustomizeManifestCuration, StyleTokenConfig, BehaviourConfig } from './manifest/schema';
+import type { BlockManifest, BlockCategory, BlockContentSource, PreviewCustomizeManifestCuration, StyleTokenConfig, BehaviourConfig } from './manifest/schema';
 import type { NodeDefinition } from './node';
 import { type FragmentFieldConfigInput, type FragmentConfigInputOf, type FragmentDefinition } from './fragments';
 /**
@@ -72,6 +72,14 @@ export type BlockConfig = {
     previewCustomize?: PreviewCustomizeManifestCuration;
     /** Content types this block is compatible with */
     contentTypes?: readonly string[];
+    /**
+     * Explicit content-source classification for this block: whether its rendered
+     * content is authored inline, comes from content-type entries, or both.
+     * Declared per block (not inferred) and REQUIRED — a system block cannot be
+     * defined without classifying itself, and a registry-wide test double-checks
+     * the assembled manifests.
+     */
+    contentSource: BlockContentSource;
 };
 declare const BlockInput: unique symbol;
 type PickConfigProperty<C, K extends keyof BlockConfig> = K extends keyof C ? {

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

@@ -7,6 +7,14 @@ type CtasOptions = {
     minItems?: number;
     maxItems?: number;
     button?: ButtonOptions;
+    /**
+     * Explicit default value for the repeater. Pass `[]` to guarantee the CTA
+     * repeater materializes with NO seeded row (see 8.1: onboarding must not leave
+     * placeholder `label:"Label"` CTA stubs). Without this the repeater still
+     * defaults to `[]` via `minItems: 0`, but declaring it makes the no-seed
+     * contract explicit and regression-proof against a future `minItems` change.
+     */
+    defaultValue?: readonly Record<string, unknown>[];
 };
 type CtasOptionId<O> = O extends {
     id: infer Id extends string;

package/dist/_dts/blocks/src/system/icons/registry.d.ts

@@ -2,7 +2,8 @@ import { type CtaIconName } from './cta';
 import { type SemanticIconId } from './semantic';
 import { type IconPickerPreset } from './presets';
 import type { IconComponent } from './svg';
-export type IconName = CtaIconName | SemanticIconId;
+import { type SocialIconName } from './social';
+export type IconName = CtaIconName | SemanticIconId | SocialIconName;
 export type IconIdForPreset<Preset extends IconPickerPreset> = Preset extends 'cta' ? CtaIconName : Preset extends 'feature' ? SemanticIconId : never;
 export type IconPickerOption<Preset extends IconPickerPreset = IconPickerPreset> = {
     id: IconIdForPreset<Preset>;

package/dist/_dts/blocks/src/system/icons/social.d.ts

@@ -0,0 +1,5 @@
+import { type IconComponent } from './svg';
+export declare const SOCIAL_ICON_NAMES: readonly ["SocialFacebook", "SocialInstagram", "SocialLinkedIn", "SocialTikTok", "SocialX", "SocialYouTube"];
+export type SocialIconName = (typeof SOCIAL_ICON_NAMES)[number];
+export declare function isSocialIconName(value: unknown): value is SocialIconName;
+export declare function getSocialIconComponent(value: unknown): IconComponent | null;

package/dist/_dts/blocks/src/system/icons/svg.d.ts

@@ -13,6 +13,7 @@ export type IconSvgProps = Omit<SVGProps<SVGSVGElement>, 'width' | 'height'> & {
     title?: string;
 };
 export type IconComponent = React.ComponentType<IconSvgProps>;
+export declare function createIcon(displayName: string, children: React.ReactNode): IconComponent;
 export declare const ArrowDownIcon: IconComponent;
 export declare const ArrowLeftIcon: IconComponent;
 export declare const ArrowRightIcon: IconComponent;

package/dist/_dts/blocks/src/system/manifest/schema.d.ts

@@ -4802,9 +4802,9 @@ export declare const styleTokenSchema: z.ZodObject<{
     }>>;
     typography: z.ZodOptional<z.ZodEnum<{
         display: "display";
+        heading: "heading";
         body: "body";
         caption: "caption";
-        heading: "heading";
         subheading: "subheading";
     }>>;
     spacing: z.ZodOptional<z.ZodEnum<{
@@ -4845,6 +4845,29 @@ export declare const blockCategoryEnum: z.ZodEnum<{
     interactive: "interactive";
 }>;
 export type BlockCategory = z.infer<typeof blockCategoryEnum>;
+/**
+ * Explicit authoring classification of where a block's rendered content comes from.
+ *
+ * - `inline`  — all content is authored inline in the block's own fields.
+ * - `entries` — the block renders content-type entries; `contentType` names the backing type.
+ * - `mixed`   — the block has inline fields AND renders entries; `contentType` names the
+ *               backing type when a single one applies.
+ *
+ * This is EXPLICIT metadata declared on every block definition (not inferred from
+ * dataLoaders/field types), so the catalog can classify entry-backed vs inline blocks
+ * honestly. A registry-wide test asserts every registered block declares it.
+ */
+export declare const blockContentSourceKinds: readonly ["inline", "entries", "mixed"];
+export type BlockContentSourceKind = (typeof blockContentSourceKinds)[number];
+export declare const blockContentSourceSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        entries: "entries";
+        mixed: "mixed";
+        inline: "inline";
+    }>;
+    contentType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BlockContentSource = z.infer<typeof blockContentSourceSchema>;
 export declare const manifestSchema: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodString;
@@ -4890,9 +4913,9 @@ export declare const manifestSchema: z.ZodObject<{
         }>>;
         typography: z.ZodOptional<z.ZodEnum<{
             display: "display";
+            heading: "heading";
             body: "body";
             caption: "caption";
-            heading: "heading";
             subheading: "subheading";
         }>>;
         spacing: z.ZodOptional<z.ZodEnum<{
@@ -4939,6 +4962,14 @@ export declare const manifestSchema: z.ZodObject<{
         interactive: "interactive";
     }>>;
     contentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    contentSource: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<{
+            entries: "entries";
+            mixed: "mixed";
+            inline: "inline";
+        }>;
+        contentType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     icon: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/dist/_dts/blocks/src/system/node/fragments/backgroundLayer.d.ts

@@ -55,6 +55,10 @@ export type BackgroundLayerOptions = {
      */
     imageFetchPriority?: MediaImageFetchPriority;
 };
+export type BackgroundFrameOptions = BackgroundLayerOptions & {
+    /** Decorative nodes painted below the configured background layers. */
+    leadingNodes?: NodeDefinition[];
+};
 /**
  * Creates background layer nodes for rendering backgrounds from field data.
  *
@@ -97,6 +101,15 @@ export type BackgroundLayerOptions = {
  * )
  */
 export declare function backgroundLayer(path: string, options?: BackgroundLayerOptions): NodeDefinition[];
+/**
+ * Wrap decorative background layers in their own clipping frame.
+ *
+ * Foreground content remains outside this frame, so editor outlines, focus
+ * rings, and floating controls are never clipped by a visual background.
+ * Backgrounds that explicitly opt into overflow keep that behavior within
+ * the decorative layer rather than changing the content root.
+ */
+export declare function backgroundFrame(path: string, options?: BackgroundFrameOptions): NodeDefinition;
 /**
  * Creates a media node for rendering background image/video media with conditional rendering.
  *

package/dist/_dts/blocks/src/system/node/fragments/footerNav.d.ts

@@ -1,3 +1,4 @@
+import type { NodeModifier } from "../builder";
 import type { NodeDefinition } from "../schema";
 import type { ClassNameBinding } from "./classNameBinding";
 type FooterNavMode = "all" | "links-only" | "flatten";
@@ -16,6 +17,7 @@ type FooterNavOpts = {
      */
     mode?: FooterNavMode;
 };
+export declare const whenCollectionHasItems: (collectionPath: string) => NodeModifier;
 /**
  * Footer navigation component that renders children expanded (not as dropdowns).
  *