@riverbankcms/sdk 0.129.1 → 0.130.2

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

@@ -1,6 +1,6 @@
 import type { SystemBlockDefinition } from "../registry";
 import { type SectionStylesContent } from "../fields/boxStyles";
-import { publicMembershipProductSchema, publicPassProductSchema, publicMembershipProductCollectionSchema, publicPassProductCollectionSchema, type PublicMembershipProductCollection, type PublicMembershipProduct, type PublicPassProductCollection, type PublicPassProduct } from "./shop.shared";
+import { publicMembershipProductSchema, publicPassProductSchema, publicMembershipProductCollectionSchema, publicPassProductCollectionSchema, type PublicMembershipProductCollection, type PublicMembershipProduct, type PublicPassProductCollection, type PublicPassProduct, type PurchasablePublicPassProduct } from "./shop.shared";
 import { shopBlockRuntime } from "../runtime/nodes/shop.interactive";
 import type { BlockManifest } from "../manifest/schema";
 import type { BlockButtonRole } from "../constants/buttonRoles";
@@ -39,5 +39,5 @@ export type ShopContent = {
     _sectionStyles?: SectionStylesContent;
 };
 export { publicMembershipProductCollectionSchema, publicMembershipProductSchema, publicPassProductCollectionSchema, publicPassProductSchema, };
-export type { PublicMembershipProductCollection, PublicMembershipProduct, PublicPassProductCollection, PublicPassProduct, };
+export type { PublicMembershipProductCollection, PublicMembershipProduct, PublicPassProductCollection, PublicPassProduct, PurchasablePublicPassProduct, };
 export declare const shopBlockDefinition: SystemBlockDefinition<ShopContent, typeof shopBlockRuntime>;

package/dist/_dts/blocks/src/system/blocks/shop.shared.d.ts

@@ -1,8 +1,6 @@
 import { z } from 'zod';
-/**
- * Public pass product for shop display
- */
-export declare const publicPassProductSchema: z.ZodObject<{
+export declare const purchasablePublicPassProductSchema: z.ZodObject<{
+    purchaseAvailability: z.ZodLiteral<"purchasable">;
     id: z.ZodString;
     productUseCase: z.ZodDefault<z.ZodEnum<{
         event_pass: "event_pass";
@@ -18,7 +16,42 @@ export declare const publicPassProductSchema: z.ZodObject<{
     eligibleCategoryIds: z.ZodArray<z.ZodString>;
     eligibleCategoryNames: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
+export declare const publicPassProductSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    purchaseAvailability: z.ZodLiteral<"purchasable">;
+    id: z.ZodString;
+    productUseCase: z.ZodDefault<z.ZodEnum<{
+        event_pass: "event_pass";
+        appointment_package: "appointment_package";
+    }>>;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    price: z.ZodNumber;
+    currency: z.ZodString;
+    creditsTotal: z.ZodNumber;
+    pricePerCredit: z.ZodNumber;
+    validDays: z.ZodNullable<z.ZodNumber>;
+    eligibleCategoryIds: z.ZodArray<z.ZodString>;
+    eligibleCategoryNames: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    purchaseAvailability: z.ZodLiteral<"display_only">;
+    unavailabilityReason: z.ZodLiteral<"online_payments_unavailable">;
+    id: z.ZodString;
+    productUseCase: z.ZodDefault<z.ZodEnum<{
+        event_pass: "event_pass";
+        appointment_package: "appointment_package";
+    }>>;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    price: z.ZodNumber;
+    currency: z.ZodString;
+    creditsTotal: z.ZodNumber;
+    pricePerCredit: z.ZodNumber;
+    validDays: z.ZodNullable<z.ZodNumber>;
+    eligibleCategoryIds: z.ZodArray<z.ZodString>;
+    eligibleCategoryNames: z.ZodArray<z.ZodString>;
+}, z.core.$strip>], "purchaseAvailability">;
 export type PublicPassProduct = z.infer<typeof publicPassProductSchema>;
+export type PurchasablePublicPassProduct = z.infer<typeof purchasablePublicPassProductSchema>;
 export type PublicPassProductCollection = Readonly<{
     passes: readonly PublicPassProduct[];
 }>;

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

@@ -1,2 +1,2 @@
-import type { NodeDefinition } from "../node";
+import type { NodeDefinition } from '../node';
 export declare const footerNavGroupsLayout: NodeDefinition;

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

@@ -27,6 +27,7 @@ type FooterRuntimeModuleVariant = (FooterRuntimeModuleBase<'brand'> & Readonly<{
     showTitle: boolean;
 }>) | (FooterRuntimeModuleBase<'navigation'> & Readonly<{
     navigationClassName?: string;
+    navigationGroupsClassName?: string;
 }>) | FooterRuntimeModuleBase<'legal-navigation'> | (FooterRuntimeModuleBase<'business-address'> & Readonly<{
     address: string;
 }>) | (FooterRuntimeModuleBase<'contact'> & Readonly<{
@@ -103,6 +104,7 @@ export type FooterRuntimeViewModel = Readonly<{
 }>;
 export type FooterRuntimeGroup = Readonly<{
     kind: 'identity' | 'main-navigation' | 'visit' | 'engagement' | 'legal-ending';
+    className: string;
     modules: readonly FooterRuntimeModule[];
 }>;
 export type FooterRuntimeRegion = Readonly<{
@@ -119,6 +121,7 @@ type FooterRuntimeViewModelInput = Readonly<{
     hasLogo?: boolean;
     legalRegion?: 'integrated' | 'separate';
     layoutVariant?: 'simple' | 'columns' | 'split';
+    navigationLayout?: 'stack' | 'inline' | 'inline-wrap';
     engagement: FooterResolvedEngagement;
 }>;
 type FooterRuntimeSectionProjectionInput = Readonly<{

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

@@ -35,7 +35,6 @@ export declare const siteHeaderManifest: import("..").DefinedBlockManifest<impor
     readonly paletteHidden: true;
 }>>;
 export type SiteHeaderManifest = typeof siteHeaderManifest;
-export type SiteHeaderVariant = 'classic' | 'centered' | 'transparent' | 'floating';
 export declare const SITE_HEADER_MODES: readonly ["default", "hidden"];
 export type SiteHeaderMode = (typeof SITE_HEADER_MODES)[number];
 export type SiteHeaderContent = Readonly<{

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

@@ -1,6 +1,7 @@
+import { type BlockManifest } from "../manifest/schema";
 import type { SystemBlockDefinition } from "../registry";
+import { type CardStylesContent } from "../fields/boxStyles";
 import type { SemanticSpacing } from "../spacing";
-import type { NodeDefinition } from "../node";
 import { type ImageColSize } from "../fields/imageLayout";
 import type { PublicTeamMemberPhoto } from "./shared/teamMembers";
 type ThumbnailShape = "round" | "rounded" | "square";
@@ -9,68 +10,7 @@ type LayoutWidth = "full" | "lg-3-4-left";
 type ThumbnailPadding = "none" | "sm" | "md" | "lg";
 type StackImagePosition = "left" | "right" | "alternate";
 type StackContentAlignment = "top" | "center";
-export declare const teamMembersManifest: import("..").DefinedBlockManifest<import("..").BlockContentShapeInput<{
-    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: {
-            readonly intent: "content";
-            readonly visibleWhen: {
-                readonly field: "source";
-                readonly equals: "manual";
-            };
-        };
-        readonly label: string;
-        readonly id: string;
-        readonly type: "repeater";
-        readonly required: boolean;
-        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 polymorphic?: boolean | undefined;
-        readonly allowConversion: boolean;
-        readonly schema?: {
-            fields: import("../../../../block-form/src/backend/index").FieldDefinition[];
-        };
-        readonly itemTypes?: Record<string, import("..").ItemTypeDefinition>;
-    }];
-    readonly layout: NodeDefinition;
-    readonly variants: {
-        readonly grid: NodeDefinition;
-        readonly stack: NodeDefinition;
-    };
-    readonly defaultVariant: "grid";
-    readonly variantOptions: {
-        readonly grid: {
-            readonly label: "Grid";
-            readonly description: "Members in a responsive grid";
-            readonly icon: "Grid3X3";
-        };
-        readonly stack: {
-            readonly label: "Stack";
-            readonly description: "Members in a stacked list with photo + bio";
-            readonly icon: "List";
-        };
-    };
-    readonly description: "Show your team members in a grid or stacked list.";
-    readonly tags: readonly ["team", "people", "members"];
-    readonly icon: "Users";
-    readonly styleTokens: {
-        readonly spacing: "lg";
-    };
-}>>;
+export declare const teamMembersManifest: BlockManifest;
 type ManualTeamMemberItem = {
     _type: "teamMember";
     name: string;
@@ -91,6 +31,7 @@ type TeamMembersCommonContent = {
     stackContentAlignment?: StackContentAlignment | null;
     columns?: string | number | null;
     gap?: SemanticSpacing;
+    _cardStyles?: CardStylesContent;
 };
 export type TeamMembersContent = (TeamMembersCommonContent & {
     source?: "manual" | null;

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

@@ -5,15 +5,15 @@ import { resolveTree } from './runtime';
 import type { Theme } from '../../../theme-core/src/schema';
 import type { NodeDefinition } from './node';
 type RenderOptions = {
-    registry?: Parameters<typeof resolveTree>[1]["registry"];
-    theme?: Parameters<typeof resolveTree>[1]["theme"];
+    registry?: Parameters<typeof resolveTree>[1]['registry'];
+    theme?: Parameters<typeof resolveTree>[1]['theme'];
     themeConfig?: Theme;
-    transforms?: Parameters<typeof resolveTree>[1]["transforms"];
+    transforms?: Parameters<typeof resolveTree>[1]['transforms'];
     viewModelOverrides?: Record<string, unknown>;
     data?: Record<string, unknown>;
     pathBase?: string;
-    imageResolveContext?: Parameters<typeof resolveTree>[1]["imageResolveContext"];
-    previewAuthoring?: Parameters<typeof resolveTree>[1]["previewAuthoring"];
+    imageResolveContext?: Parameters<typeof resolveTree>[1]['imageResolveContext'];
+    previewAuthoring?: Parameters<typeof resolveTree>[1]['previewAuthoring'];
 };
 /**
  * Resolves the layout definition for a block based on its manifest and content.

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

@@ -1,8 +1,11 @@
 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 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';
+import { type BackgroundContent } from '../fields/backgroundContent';
+import { serializeBackgroundOverride } from './serializeBackgroundOverride';
+export { serializeBackgroundOverride };
 export { isGradientPresetId, parseGradientPresetId, type GradientPresetId, } from '../../../../theme-core/src/gradients/index';
 export type BackgroundMode = 'default' | 'color' | 'gradient' | 'image';
 export type BackgroundModeCycleDirection = 'prev' | 'next';
@@ -21,20 +24,20 @@ export type BackgroundOverride = Readonly<{
     kind: 'image';
     mediaId: MediaAssetId;
 }>;
-export type LegacyBackgroundReason = 'unsupported-shape' | 'unsupported-mode' | 'invalid-color-token' | 'arbitrary-gradient-css' | 'missing-gradient-preset-id' | 'invalid-gradient-preset-id' | 'missing-image-media-id' | 'invalid-image-media-id' | 'video-background';
+export type UnsupportedBackgroundReason = 'unsupported-shape' | 'unsupported-mode' | 'invalid-color-token' | 'arbitrary-gradient-css' | 'missing-gradient-preset-id' | 'invalid-gradient-preset-id' | 'missing-image-media-id' | 'invalid-image-media-id' | 'video-background';
 export type ParsedBackgroundOverride = Readonly<{
     kind: 'supported';
     override: BackgroundOverride;
 }> | Readonly<{
-    kind: 'legacy';
-    reason: LegacyBackgroundReason;
+    kind: 'unsupported';
+    reason: UnsupportedBackgroundReason;
     background: Readonly<Record<string, unknown>>;
 }>;
 export type CanonicalSectionBackground = Readonly<{
     kind: 'none';
 }> | Readonly<{
     kind: 'block-authored';
-    background: Readonly<Record<string, unknown>>;
+    background: BackgroundContent;
 }> | Readonly<{
     kind: 'page-design-override';
     parsed: ParsedBackgroundOverride;
@@ -133,7 +136,7 @@ export type BackgroundOverridePlan = Readonly<{
     kind: 'blocked';
     reason: BackgroundOverrideBlockedReason;
 }>;
-export type BackgroundOverrideBlockedReason = 'mode-unavailable' | 'value-unavailable' | 'legacy-current-background';
+export type BackgroundOverrideBlockedReason = 'mode-unavailable' | 'value-unavailable' | 'unsupported-current-background';
 export type BackgroundCustomizeContent = Record<string, unknown>;
 export type BackgroundCapabilityBlock = Readonly<{
     blockKind: string;
@@ -174,8 +177,6 @@ export declare const recommendedBackgroundColorTokens: readonly BackgroundColorT
 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 backgroundModeForOverride(override: BackgroundOverride): BackgroundMode;
 export declare function backgroundOverrideEquals(left: BackgroundOverride, right: BackgroundOverride): boolean;
@@ -190,7 +191,6 @@ export declare function parseBackgroundOverrideFromContent(content: BackgroundCu
  */
 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;
 export declare function planBackgroundTransition(current: BackgroundOverride, capability: BackgroundCapability, action: BackgroundTransitionAction): BackgroundTransitionPlan;
 export declare function planBackgroundOverride(current: ParsedBackgroundOverride, capability: BackgroundCapability, override: BackgroundOverride): BackgroundOverridePlan;

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

@@ -0,0 +1,3 @@
+import type { BackgroundContent } from '../fields/backgroundContent';
+import type { BackgroundOverride } from './backgrounds';
+export declare function serializeBackgroundOverride(override: BackgroundOverride): BackgroundContent | null;

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

@@ -17,26 +17,8 @@ type BackgroundFieldOptions = {
  * declared but is managed implicitly by TabGroupField. When the user switches tabs,
  * the widget writes the tab ID to the path `{id}.type`.
  *
- * The stored data structure is:
- * ```typescript
- * {
- *   type: 'color' | 'gradient' | 'image' | 'video',  // Managed by TabGroupField
- *   color?: string,                         // From Color tab
- *   gradient?: string,                      // From Gradient tab (CSS value)
- *   image?: MediaReference,                 // From Image tab (image or decorative video)
- *   showVideoOnMobile?: boolean,            // From Video tab
- *   objectFit?: 'fill' | 'fit' | 'original' | 'custom',
- *   scale?: string,
- *   position?: string,
- *   opacity?: number,
- *   overlay?: {                             // Image/video overlay (when includeAdvanced)
- *     type: 'color' | 'gradient' | 'none',
- *     color?: string,                       // Token or hex
- *     gradient?: string,                    // CSS gradient
- *     opacity?: number,                     // 0-100
- *   },
- * }
- * ```
+ * Persistence projects the selected tab into the canonical discriminated
+ * `BackgroundContent` union. Fields owned by inactive tabs are not stored.
  *
  * ## SDK Filtering
  *

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

@@ -0,0 +1,17 @@
+import { boxBackgroundOverlaySchema, type BoxBackground } from '../../../../theme-core/src/schema';
+import type { ImageMedia } from '../../lib/media';
+export type BackgroundContent = BoxBackground;
+export type BackgroundForeground = Pick<BackgroundContent, 'textColor' | 'headingColor' | 'linkColor' | 'supportingColor'>;
+export type BackgroundOverlay = ReturnType<typeof boxBackgroundOverlaySchema.parse>;
+export type ImageBackgroundContent = Extract<BackgroundContent, {
+    type: 'image';
+}>;
+export type ImageBackgroundDefaults = Partial<Omit<ImageBackgroundContent, 'type' | 'image'>>;
+/**
+ * Replaces only the background medium while retaining presentation fields that
+ * are valid for the resulting image variant. Stale color/gradient tab state is
+ * never copied into the new value.
+ */
+export declare function replaceBackgroundWithImage(value: unknown, image: ImageMedia, defaults?: ImageBackgroundDefaults): ImageBackgroundContent;
+export declare function parseBackgroundContent(value: unknown): BackgroundContent | null;
+export declare function parseBackgroundOverlay(value: unknown): BackgroundOverlay | undefined;

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

@@ -0,0 +1,20 @@
+declare const BACKGROUND_SLOTS: readonly ["_sectionStyles", "_containerStyles", "_cardStyles"];
+export type BoxBackgroundAuditRecord = Readonly<Record<string, unknown>>;
+export type BoxBackgroundAuditFinding = Readonly<{
+    contentVersionId: string;
+    siteId: string | null;
+    blockId: string;
+    stage: string | null;
+    slot: (typeof BACKGROUND_SLOTS)[number];
+    issues: readonly Readonly<{
+        path: readonly PropertyKey[];
+        code: string;
+        message: string;
+    }>[];
+}>;
+export type BoxBackgroundAuditReport = Readonly<{
+    inspectedBackgrounds: number;
+    findings: readonly BoxBackgroundAuditFinding[];
+}>;
+export declare function auditBoxBackgroundContentVersions(records: readonly BoxBackgroundAuditRecord[]): BoxBackgroundAuditReport;
+export {};

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

@@ -1,6 +1,7 @@
 import type { ModalFieldDefinition } from '../manifest/schema';
-import type { AccordionIconTreatment, EyebrowTreatment, EventListTreatment, HeadingDecorationOverride, PageDesignEditorBackgroundOverrideOwner, TileTreatment } from '../../../../theme-core/src/site-styles/index';
-import type { Media } from '../../lib/media';
+import type { AccordionIconTreatment, EyebrowTreatment, EventListTreatment, HeadingDecorationOverride, TileTreatment } from '../../../../theme-core/src/site-styles/index';
+import type { CardRole } from '../../../../theme-core/src/cards/index';
+import type { BackgroundContent } from './backgroundContent';
 /**
  * Options for customizing a section styles field.
  */
@@ -65,35 +66,7 @@ type CardStylesOptions = {
  * ```
  */
 export type SectionStylesContent = {
-    background?: {
-        type?: 'color' | 'gradient' | 'image';
-        contentOwner?: PageDesignEditorBackgroundOverrideOwner | null;
-        color?: string | null;
-        /** CSS gradient string (e.g., "linear-gradient(...)") */
-        gradient?: string | null;
-        /** Curated gradient preset identifier. */
-        gradientPresetId?: string | null;
-        image?: Media | null;
-        objectFit?: 'fill' | 'fit' | 'original' | 'custom' | null;
-        scale?: string | null;
-        position?: string | null;
-        opacity?: number | null;
-        motion?: 'static' | 'fixed-frame' | null;
-        overlay?: {
-            type?: 'none' | 'color' | 'gradient' | null;
-            color?: string | null;
-            /** CSS gradient string (e.g., "linear-gradient(...)") */
-            gradient?: string | null;
-            opacity?: number | null;
-        } | null;
-        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;
+    background?: BackgroundContent | null;
     spacing?: string | null;
     minHeight?: 'none' | 'banner' | 'hero' | 'immersive' | null;
     tileTreatment?: TileTreatment | null;
@@ -103,7 +76,7 @@ export type SectionStylesContent = {
     accordionIconTreatment?: AccordionIconTreatment | null;
 } | null;
 export type CardStylesContent = {
-    background?: Record<string, unknown> | null;
+    background?: BackgroundContent | null;
     border?: {
         enabled?: boolean | null;
         width?: 'none' | '1' | '2' | '3' | null;
@@ -112,11 +85,22 @@ export type CardStylesContent = {
     spacing?: string | null;
     raised?: boolean | null;
     rounded?: string | null;
+    /**
+     * The card role the block's Look asked for. Compiled by the site-style
+     * runtime; the site style owns what the role looks like. The one field that
+     * names a card surface.
+     */
+    role?: CardRole | null;
+    /**
+     * Legacy name for `role` — it only ever held role names. Read-only history:
+     * content persisted before the role contract still carries it, and it reads
+     * as a role at the render boundary (`resolveCardRoleForBoxStyles`), where an
+     * explicit `role` wins.
+     */
     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;
+    background?: BackgroundContent | null;
     spacing?: string | null;
     raised?: boolean | null;
     rounded?: string | null;

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

@@ -0,0 +1,20 @@
+import { type FieldDefinition } from "../manifest/schema";
+type FieldUi = NonNullable<FieldDefinition["ui"]>;
+type FieldVisibleWhen = FieldUi["visibleWhen"];
+type SharedSelectOptions = Readonly<{
+    label?: string;
+    description?: string;
+    defaultValue?: string;
+    visibleWhen?: FieldVisibleWhen;
+}>;
+/**
+ * Grid `userColumns` binding for blocks with a user-configured column count.
+ * The count renders through the canonical responsive ladder — see
+ * {@link gridUserColumnLadder}.
+ */
+export declare function userColumnsGridBinding(): Record<string, unknown>;
+/** Shared "Columns" select (2/3/4) for grid-layout blocks. */
+export declare function columnsSelectField(options?: SharedSelectOptions): FieldDefinition;
+/** Shared semantic "Gap" select for layout blocks. */
+export declare function gapSelectField(options?: SharedSelectOptions): FieldDefinition;
+export {};

package/dist/_dts/blocks/src/system/fragments/builder.d.ts

@@ -25,6 +25,7 @@ export type FragmentComposition = {
 export type FragmentDataLoaders = Record<string, {
     endpoint: string;
     params: Record<string, unknown>;
+    requiredParams?: readonly string[];
     mode: "server" | "client";
 }>;
 export declare class FragmentCompositionError extends Error {

package/dist/_dts/blocks/src/system/fragments/types.d.ts

@@ -6,6 +6,7 @@ declare const fragmentDataSchema: z.ZodObject<{
     loader: z.ZodOptional<z.ZodObject<{
         endpoint: z.ZodString;
         params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        requiredParams: z.ZodOptional<z.ZodArray<z.ZodString>>;
         mode: z.ZodDefault<z.ZodEnum<{
             server: "server";
             client: "client";

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

@@ -4,5 +4,5 @@
  * These helpers make it easy to build custom block overrides that integrate
  * seamlessly with Riverbank CMS theme tokens and content fields.
  */
-export { resolveBackground, SectionBackground, type BackgroundInput, type ResolvedBackground, type SectionBackgroundProps, } from './resolveBackground';
+export { resolveBackground, SectionBackground, type ResolvedBackground, type SectionBackgroundProps, } from './resolveBackground';
 export { apiBindings, withApiBindings, type ApiBinding, } from './api-bindings';

package/dist/_dts/blocks/src/system/helpers/resolveBackground.d.ts

@@ -5,50 +5,15 @@
  * (color, gradient, image, and decorative video) with full theme token support, matching the
  * behavior of the default declarative block system.
  */
-import * as React from "react";
-import { type ThemeTokens } from "../theme";
-import type { Media } from "../../lib/media";
-import { type BackgroundMedia } from "./backgroundMedia";
-import { type ResolveImageUrlContext } from "../runtime/nodes/media";
+import * as React from 'react';
+import { type ThemeTokens } from '../theme';
+import { type BackgroundMedia } from './backgroundMedia';
+import { type BackgroundContent } from '../fields/backgroundContent';
+import { type ResolveImageUrlContext } from '../runtime/nodes/media';
 /**
  * Raw background data from CMS content fields.
  * This is the shape of `_sectionStyles.background`, `_containerStyles.background`, etc.
  */
-export type BackgroundInput = {
-    /** Color token name (e.g., "primary") or raw hex value */
-    color?: string | null;
-    /** CSS gradient string */
-    gradient?: string | null;
-    /** Curated gradient preset identifier. Used for Customize-mode backgrounds. */
-    gradientPresetId?: string | null;
-    /** Background image or decorative video media object */
-    image?: Media | null;
-    /** Whether decorative background video should play on mobile. Defaults to false. */
-    showVideoOnMobile?: boolean | null;
-    /** Media sizing mode: 'fill' (cover), 'fit' (contain), 'original', 'custom' */
-    objectFit?: string | null;
-    /** Media position: preset keyword or custom CSS value */
-    position?: string | null;
-    /** Media scale value (e.g., "150%", "200px") - only for 'custom'/'original' modes */
-    scale?: string | null;
-    /** Background opacity (0-1 decimal; legacy 1-100 percentages are still accepted) */
-    opacity?: number | null;
-    /** Image scroll behavior for image-backed sections. */
-    motion?: "static" | "fixed-frame" | null;
-    /** Whether background should overflow container bounds */
-    overflow?: boolean | null;
-    /** Overlay configuration for image/video media */
-    overlay?: {
-        /** Overlay type: 'color', 'gradient', or 'none' */
-        type?: "color" | "gradient" | "none" | null;
-        /** Overlay color token or hex value */
-        color?: string | null;
-        /** Overlay CSS gradient string */
-        gradient?: string | null;
-        /** Overlay opacity (0-1 decimal; legacy 1-100 percentages are still accepted) */
-        opacity?: number | null;
-    } | null;
-};
 /**
  * Resolved background ready for rendering.
  * Token names are converted to actual hex values.
@@ -62,10 +27,10 @@ export type ResolvedBackground = {
     opacity: number | null;
     /** Whether background should overflow */
     overflow: boolean;
-    /** Resolved image/video media data. Retains the legacy `image` property name for saved background compatibility. */
+    /** Resolved image/video media data from the background contract's shared `image` slot. */
     image: {
         /** Media kind */
-        kind: BackgroundMedia["type"];
+        kind: BackgroundMedia['type'];
         /** Media URL */
         url: string;
         /** Alt text */
@@ -86,7 +51,7 @@ export type ResolvedBackground = {
     /** Resolved overlay data for rendering on top of image/video media */
     overlay: {
         /** Overlay type */
-        type: "color" | "gradient" | "none";
+        type: 'color' | 'gradient' | 'none';
         /** Resolved background color (hex) */
         backgroundColor: string | null;
         /** CSS gradient string */
@@ -139,10 +104,10 @@ export type ResolveBackgroundOptions = {
  * }
  * ```
  */
-export declare function resolveBackground(background: BackgroundInput | null | undefined, theme?: ThemeTokens, options?: ResolveBackgroundOptions): ResolvedBackground;
+export declare function resolveBackground(input: BackgroundContent | null | undefined, theme?: ThemeTokens, options?: ResolveBackgroundOptions): ResolvedBackground;
 export type SectionBackgroundProps = {
     /** Raw background data from content (e.g., content._sectionStyles?.background) */
-    background: BackgroundInput | null | undefined;
+    background: BackgroundContent | null | undefined;
     /** Theme tokens for resolving color tokens to hex values */
     theme?: ThemeTokens;
     /** Target aspect ratio used to resolve aspect-specific crop metadata */

package/dist/_dts/blocks/src/system/manifest/fieldValidation/index.d.ts

@@ -1,6 +1,7 @@
-import { z } from "zod";
+import { z } from 'zod';
 import { linkSchema, customLinkSchema, entryLinkSchema, externalLinkSchema, internalLinkSchema, internalResolvedLinkSchema, internalRouteOnlyLinkSchema, pageLinkSchema } from "../../types/link";
-import { type FieldDefinition, type VisibilityLevel } from "../schema";
+import { type FieldDefinition, type VisibilityLevel } from '../schema';
+export { auditBoxBackgroundContentVersions, type BoxBackgroundAuditFinding, type BoxBackgroundAuditRecord, type BoxBackgroundAuditReport, } from '../../fields/backgroundContentAudit';
 export { linkSchema, customLinkSchema, entryLinkSchema, externalLinkSchema, internalLinkSchema, internalResolvedLinkSchema, internalRouteOnlyLinkSchema, pageLinkSchema, };
 export type FieldPath = readonly (string | number)[];
 export type FieldValidationMode = "strict" | "draft";
@@ -135,7 +136,7 @@ export type FieldValidationIssue = BaseIssue<"required", {
 }> | BaseIssue<"tooManyItems", {
     maximum: number;
     itemLabel: string;
-}> | BaseIssue<"invalidRichText"> | BaseIssue<"invalidInlineText"> | BaseIssue<"invalidMedia"> | BaseIssue<"invalidLink"> | BaseIssue<"invalidReference">;
+}> | BaseIssue<"invalidRichText"> | BaseIssue<"invalidInlineText"> | BaseIssue<"invalidMedia"> | BaseIssue<"invalidBoxBackground"> | BaseIssue<"invalidLink"> | BaseIssue<"invalidReference">;
 type BaseIssue<K extends string, Extra extends object = Record<never, never>> = Readonly<{
     kind: K;
     path: FieldPath;
@@ -150,8 +151,9 @@ export type ManifestContentValidationIssue = Readonly<{
     requiredScope: ManifestContentRequiredScope | null;
 }>;
 export type ManifestContentValidationResult = Readonly<{
-    kind: "valid";
+    kind: 'valid';
     issues: readonly [];
+    data: Readonly<Record<string, unknown>>;
 }> | Readonly<{
     kind: "invalid";
     issues: readonly ManifestContentValidationIssue[];
@@ -228,6 +230,7 @@ export type GroupFieldValidationPlan = PlanBase<"group", "object", ObjectConstra
         }>[];
     }>;
     allowNullChildren?: boolean;
+    valueContract?: "boxBackground";
 }>;
 export type PassthroughFieldValidationPlan = PlanBase<"passthrough", "unknown", RequiredConstraint> & Readonly<{
     fieldType: "presetOrCustom" | "contentTypeSelect" | "entryPicker";

package/dist/_dts/blocks/src/system/manifest/fieldValidation/writeCanonicalization.d.ts

@@ -0,0 +1,4 @@
+import type { FieldValidationPlan, GroupFieldValidationPlan } from './index';
+export declare function allGroupChildPlans(plan: GroupFieldValidationPlan): readonly FieldValidationPlan[];
+export declare function selectedGroupChildPlans(plan: GroupFieldValidationPlan, value: unknown): readonly FieldValidationPlan[];
+export declare function canonicalizeObjectForWrite(plans: readonly FieldValidationPlan[], value: unknown): unknown;