@riverbankcms/sdk 0.129.1 → 0.130.0

package/dist/_dts/preview-next/src/client/preview/siteStylePreviewPlanner.d.ts

@@ -1,34 +1,25 @@
 import type { Theme } from '../../../../blocks/src/index';
 import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
-import type { FooterLookId, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, SiteChromeSurface } from '../../../../theme-core/src/site-styles/index';
-import { compileSiteThemeFromSelections, type CuratedSiteStyle, type SelectionFallbackWarning, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
+import type { FooterLookId, HeaderLayoutId, HeaderLogoContext, HeaderStyleId, SiteChromeSurface } from '../../../../theme-core/src/site-styles/index';
+import { type CuratedSiteStyle, type SelectionFallbackWarning, type SiteThemeSelectionsResult, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
 export type SiteStylePreviewSelection = Readonly<{
     siteStyleId: SiteStyleId;
     buttonStyleSelection: ButtonStyleSelection;
     palette: Theme['palette'];
     typography: Theme['typography'];
-    headerLayoutId?: HeaderLayoutId | null;
-    headerStyleId?: HeaderStyleId | null;
-    headerLookId: HeaderLookId | null;
-    footerLookId: FooterLookId | null;
-}>;
-export type SiteStyleChromePreviewSelection = Readonly<{
-    headerLookId: HeaderLookId | null;
+    headerLayoutId: HeaderLayoutId;
+    headerStyleId: HeaderStyleId;
     footerLookId: FooterLookId | null;
 }>;
 export type SiteStylePreviewPlan = Readonly<{
     themeOverlay: Theme;
-    resolvedSelections: ReturnType<typeof compileSiteThemeFromSelections>['resolvedSelections'] & Readonly<{
-        headerLayoutId: HeaderLayoutId;
-        headerStyleId: HeaderStyleId;
-    }>;
-    chromeSelection: SiteStyleChromePreviewSelection;
+    resolvedSelections: SiteThemeSelectionsResult['resolvedSelections'];
     warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>;
 type SiteStylePreviewPlanCommonInput = Readonly<{
     siteStyle: CuratedSiteStyle;
     selection: SiteStylePreviewSelection;
-    headerSelectionContext?: Partial<HeaderSelectionContext>;
+    headerLogoContext?: HeaderLogoContext;
 }>;
 export type SiteStylePreviewPlanInput = SiteStylePreviewPlanCommonInput & (Readonly<{
     compilation: Readonly<{

package/dist/_dts/preview-next/src/client/preview/styleConfiguratorSnapshot.d.ts

@@ -1,20 +1,18 @@
 import type { Theme } from '../../../../blocks/src/index';
 import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
-import type { FooterLookId, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
+import type { FooterLookId, HeaderLayoutStyleSelection, HeaderLogoContext } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 export type StyleConfiguratorInitialSelections = Readonly<{
     selectionVersion?: number | null;
     selectionUpdatedAt?: string | null;
     buttonStyleSelection: ButtonStyleSelection | null;
-    headerLayoutId?: HeaderLayoutId | null;
-    headerStyleId?: HeaderStyleId | null;
-    headerLookId?: HeaderLookId | null;
+    headerSelection?: HeaderLayoutStyleSelection | null;
     footerLookId?: FooterLookId | null;
 }>;
 type StyleConfiguratorSnapshotInput = Readonly<{
     theme?: Theme | null;
     initialSelections: StyleConfiguratorInitialSelections;
-    headerSelectionContext?: Partial<HeaderSelectionContext>;
+    headerLogoContext?: HeaderLogoContext;
 }>;
 /**
  * The parsed theme is the complete palette authority for preview.
@@ -22,6 +20,6 @@ type StyleConfiguratorSnapshotInput = Readonly<{
 export declare function resolveStyleConfiguratorInitialSnapshot(input: Readonly<{
     theme?: Theme | null;
     initialSelections: StyleConfiguratorSnapshotInput['initialSelections'];
-    headerSelectionContext?: Partial<HeaderSelectionContext>;
+    headerLogoContext?: HeaderLogoContext;
 }>): SelectionSnapshot | null;
 export {};

package/dist/_dts/sdk/src/config/types.d.ts

@@ -62,6 +62,7 @@ export type LoaderWhenValue = boolean | LoaderParamBinding;
 export interface SdkConfigLoader {
     endpoint: SdkLoaderEndpoint;
     params: Record<string, LoaderParamValue>;
+    requiredParams?: readonly string[];
     mode?: 'server' | 'client';
     when?: LoaderWhenValue;
 }

package/dist/_dts/sdk/src/config/validation.d.ts

@@ -258,6 +258,7 @@ export declare const sdkConfigLoaderSchema: z.ZodObject<{
             }>>;
         }, z.core.$strip>;
     }, z.core.$strip>]>>;
+    requiredParams: z.ZodOptional<z.ZodArray<z.ZodString>>;
     mode: z.ZodDefault<z.ZodEnum<{
         server: "server";
         client: "client";
@@ -324,6 +325,7 @@ export declare const sdkDataLoadersSchema: z.ZodOptional<z.ZodRecord<z.ZodString
             }>>;
         }, z.core.$strip>;
     }, z.core.$strip>]>>;
+    requiredParams: z.ZodOptional<z.ZodArray<z.ZodString>>;
     mode: z.ZodDefault<z.ZodEnum<{
         server: "server";
         client: "client";

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

@@ -9,6 +9,7 @@ import type { EventRegistrationContent } from './event-registration-content';
 export type { EventRegistrationContent } from './event-registration-content';
 import type { Brand, EventCategoryId, RichTextDoc, VenueId } from '../../../core/src/index';
 import type { SiteFooterContent as BlocksSiteFooterContent } from '../../../blocks/src/system/blocks/site-footer';
+import type { CardStylesContent as BlocksCardStylesContent, ContainerStylesContent as BlocksContainerStylesContent, SectionStylesContent as BlocksSectionStylesContent } from '../../../blocks/src/index';
 type UnknownRecord = Record<string, unknown>;
 type ImageMedia = Omit<Media, 'type'> & {
     type: 'image';
@@ -16,47 +17,9 @@ type ImageMedia = Omit<Media, 'type'> & {
 type StandardAspectRatio = 'auto' | '16/9' | '4/3' | '1/1' | '3/4' | '9/16';
 export type SemanticSpacing = 'none' | 'compact' | 'cozy' | 'medium' | 'comfortable' | 'spacious';
 export type ImageColSize = '1/4' | '1/3' | '2/5' | '1/2' | '2/3';
-export type SectionStylesContent = {
-    background?: {
-        type?: 'color' | 'gradient' | 'image';
-        color?: string | null;
-        gradient?: string | null;
-        image?: Media | null;
-        objectFit?: 'fill' | 'fit' | 'original' | 'custom' | null;
-        scale?: string | null;
-        position?: string | null;
-        opacity?: number | null;
-        overlay?: {
-            type?: 'none' | 'color' | 'gradient' | null;
-            color?: string | null;
-            gradient?: string | null;
-            opacity?: number | null;
-        } | null;
-        textColor?: string | null;
-        headingColor?: string | null;
-    } | null;
-    spacing?: string | null;
-} | null;
-export type CardStylesContent = {
-    background?: Record<string, unknown> | null;
-    border?: {
-        enabled?: boolean | null;
-        width?: 'none' | '1' | '2' | '3' | null;
-        colorToken?: string | null;
-    } | null;
-    spacing?: string | null;
-    raised?: boolean | null;
-    rounded?: string | 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;
-    spacing?: string | null;
-    raised?: boolean | null;
-    rounded?: string | null;
-    fullWidth?: boolean | null;
-} | null;
+export type SectionStylesContent = BlocksSectionStylesContent;
+export type CardStylesContent = BlocksCardStylesContent;
+export type ContainerStylesContent = BlocksContainerStylesContent;
 export type CtaIconName = 'ArrowRight' | 'ArrowLeft' | 'ChevronRight' | 'ChevronLeft' | 'ChevronUp' | 'ChevronDown' | 'ExternalLink' | 'Download' | 'Upload' | 'Mail' | 'Phone' | 'Play' | 'ShoppingCart' | 'Calendar' | 'MapPin' | 'Info' | 'Plus' | 'Minus' | 'Check' | 'X';
 export type SemanticIconId = 'protection-trust' | 'confidentiality' | 'care-support' | 'partnership' | 'warmth' | 'community' | 'personal-guidance' | 'conversation' | 'friendly-welcome' | 'insight-learning' | 'natural-wellbeing' | 'growth' | 'gentle-care' | 'special-touch' | 'ideas' | 'direction' | 'focus' | 'quality' | 'highlight' | 'verified-quality' | 'learning' | 'training' | 'programmes-dates' | 'place' | 'products' | 'packages' | 'time' | 'practical-service' | 'at-home' | 'worldwide' | 'professional-service';
 export type BlockIconValue = {

package/dist/_dts/sdk/src/next/catch-all-theme-admission.d.ts

@@ -0,0 +1,23 @@
+import type { Theme } from '../contracts';
+import type { LoadContentResult } from '../rendering/helpers/loadContent';
+import type { SdkRenderingMode } from '../rendering/renderingMode';
+import type { ResolveThemeResult } from './resolveTheme';
+export type CatchAllRenderingAdmission = Readonly<{
+    kind: 'overrides-only';
+    content: LoadContentResult;
+    rendering: Extract<SdkRenderingMode, {
+        kind: 'overrides-only';
+    }>;
+}> | Readonly<{
+    kind: 'not-found';
+}> | Readonly<{
+    kind: 'themed';
+    content: LoadContentResult;
+    theme: Theme;
+    warning?: string;
+}>;
+export declare function admitCatchAllRendering(input: Readonly<{
+    content: LoadContentResult;
+    rendering: SdkRenderingMode;
+    resolveTheme: () => Promise<ResolveThemeResult>;
+}>): Promise<CatchAllRenderingAdmission>;

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

@@ -38,6 +38,8 @@
  * @packageDocumentation
  */
 export { createCatchAllPage, InvalidCatchAllRenderingOptionsError, } from './catch-all';
+export { MISSING_SDK_THEME_ERROR_CODE, MissingSdkThemeError, } from '../rendering/themeAdmission';
+export type { MissingSdkThemeReason } from '../rendering/themeAdmission';
 export { RiverbankContentLoadError, SdkContentLoadError, classifyContentLoadError, isSdkContentLoadError, toContentLoadFailureLogFields, type CatchAllContentLoadFailureContext, type CatchAllRequestContext, type ClassifiedContentLoadError, type SdkContentLoadFailure, type SdkContentLoadFailureKind, type SdkContentLoadNotFound, } from './content-load-failure';
 export type { CreateCatchAllPageOptions, CreateCatchAllPageResult, CatchAllPageProps, CatchAllContext, ThemeSwitchConfigV1, ThemeResolverContext, } from './types';
 export type { SdkOverrideOnlyRendering, SdkOverrideOnlyRuntime, SdkRenderingMode, } from '../rendering/renderingMode';
@@ -66,13 +68,13 @@ export interface ISRConfig {
 /**
  * Get ISR configuration based on the current environment.
  *
- * @example
- * ```tsx
- * // app/[[...slug]]/page.tsx
- * import { getISRConfig } from '@riverbankcms/sdk/next';
+ * Do not use the returned value directly in a Next.js route-segment config
+ * export. Next statically analyzes those exports and requires a literal such as
+ * `export const revalidate = 300`.
  *
- * export const revalidate = getISRConfig().revalidate;
- * ```
+ * @deprecated Next.js route-segment config must be statically analyzable, which
+ * was this helper's intended use. Export a literal `revalidate` value and use
+ * the SDK preview integration for request-bound preview rendering instead.
  *
  * @returns ISR configuration with revalidate interval and preview flag
  */

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

@@ -24,11 +24,10 @@ export type ThemeOptionsForResolver = {
 } | {};
 export interface ResolveThemeInput {
     config: Pick<RiverbankSiteConfig, 'themeSource' | 'activeTheme'>;
-    contentTheme: Theme;
+    contentTheme: Theme | null;
     searchParams: DataLoaderSearchParams;
     isDevelopment: boolean;
     themeOptions: ThemeOptionsForResolver;
     context: ThemeResolverContext;
 }
-export declare const MISSING_LOCAL_THEME_ERROR_MESSAGE = "[createCatchAllPage] config.themeSource is 'local' but no local theme was provided. Provide { theme }, { themes }, or { getTheme }, or set config.themeSource to 'cms'.";
 export declare function resolveTheme(input: ResolveThemeInput): Promise<ResolveThemeResult>;

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

@@ -202,6 +202,16 @@ type CreateCatchAllPageBaseOptions = {
      * Defaults to `config.liveUrl` or `config.previewUrl` based on preview mode.
      */
     siteUrl?: string;
+    /**
+     * Controls whether the server page reads Next.js `searchParams`.
+     *
+     * Reading that prop opts the entire route into dynamic rendering in Next.js.
+     * Set this to `ignore` for ISR routes that do not use query parameters for
+     * server-rendered themes, data loaders, redirects, or metadata.
+     *
+     * @default 'dynamic'
+     */
+    searchParamsMode?: 'dynamic' | 'ignore';
     /**
      * Intercept before rendering to implement maintenance mode, access control, etc.
      *

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

@@ -268,7 +268,7 @@ export type SiteRouteRecord = {
     publishedAt?: string | null;
 };
 export type SiteBookingOfferingPresetSummary = ApiSiteBookingOfferingPresetSummary;
-type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | 'selectionId' | 'selectionVersion' | 'selectionUpdatedAt' | 'selectionButtonStyleSelection' | 'selectionHeaderLayoutId' | 'selectionHeaderStyleId' | 'selectionHeaderLookId' | 'selectionFooterLookId'>;
+type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | 'selectionId' | 'selectionVersion' | 'selectionUpdatedAt' | 'selectionButtonStyleSelection' | 'selectionHeaderSelection' | 'selectionFooterLookId'>;
 export type SiteResponse = SiteSelectionResponse & {
     site: {
         id: string;
@@ -625,21 +625,7 @@ export type PublicProductsResponse = {
         }>;
     }>;
 };
-export type PublicPassesResponse = {
-    passes: Array<{
-        id: string;
-        productUseCase: 'event_pass' | 'appointment_package';
-        name: string;
-        description: string | null;
-        price: number;
-        currency: string;
-        creditsTotal: number;
-        pricePerCredit: number;
-        validDays: number | null;
-        eligibleCategoryIds: string[];
-        eligibleCategoryNames: string[];
-    }>;
-};
+export type PublicPassesResponse = APIEndpoints['listPublicPasses']['response'];
 export type PublicMembershipsResponse = {
     memberships: Array<{
         id: string;

package/dist/_dts/sdk/src/rendering/components/Layout.d.ts

@@ -5,6 +5,7 @@
  */
 import { buildMenu, buildFooterMenu, buildFooterMenuForRole, buildLogo } from '../../navigation';
 import type { RiverbankClient, SiteResponse } from '../../client/types';
+import type { Theme } from '../../contracts';
 import { type SdkThemeRuntime } from '../themeRuntime';
 import { type SdkOverrideOnlyRendering } from '../renderingMode';
 export type CustomHeaderData = {
@@ -22,10 +23,10 @@ export type CustomFooterData = {
     routes: SiteResponse['routes'];
 };
 export type HeaderData = CustomHeaderData & {
-    theme: SiteResponse['theme'];
+    theme: Theme;
 };
 export type FooterData = CustomFooterData & {
-    theme: SiteResponse['theme'];
+    theme: Theme;
 };
 type LayoutCommonProps = {
     siteData?: SiteResponse;

package/dist/_dts/sdk/src/rendering/helpers/loadContent.d.ts

@@ -102,7 +102,7 @@ export type PageContentResult = {
     page: PageProps['page'];
     runtimeBoundaries?: PageProps['runtimeBoundaries'];
     /** Site theme for styling */
-    theme: Theme;
+    theme: Theme | null;
     /** Site ID */
     siteId: string;
     /** Declarative custom blocks stored in DB (if any) */
@@ -151,7 +151,7 @@ export type EntryContentResult = {
         contentEntry: Record<string, unknown>;
     };
     /** Site theme for styling (useful if rendering with SDK components) */
-    theme: Theme;
+    theme: Theme | null;
     /** Site ID */
     siteId: string;
     /** Declarative custom blocks stored in DB (if any) */
@@ -213,7 +213,7 @@ export type PageSurfaceContentResult = {
         pageSurface: Record<string, unknown>;
         subject: PageSurfaceContentData['subject'];
     };
-    theme: Theme;
+    theme: Theme | null;
     siteId: string;
     customBlocks?: SdkCustomBlock[];
     site: SiteData;
@@ -256,6 +256,7 @@ export declare function isPageSurfaceContent(result: LoadContentResult): result
  *   });
  *
  *   if (isPageContent(content)) {
+ *     if (!content.theme) throw new MissingSdkThemeError(content.siteId, 'cms_theme_absent');
  *     return <Page {...content} />;
  *   }
  *
@@ -284,6 +285,7 @@ export declare function isPageSurfaceContent(result: LoadContentResult): result
  *   }
  * }
  *
+ * if (!content.theme) throw new MissingSdkThemeError(content.siteId, 'cms_theme_absent');
  * return <Page {...content} />;
  * ```
  *

package/dist/_dts/sdk/src/rendering/helpers/pageRuntimeSupport.d.ts

@@ -5,7 +5,7 @@ import type { SdkCustomBlock } from '../../config/types';
 export type RuntimeSdkConfig = NonNullable<SiteResponse['sdkConfig']>;
 export type SiteData = SiteResponse['site'];
 export type SiteRenderSupport = Readonly<{
-    theme: Theme;
+    theme: Theme | null;
     site: SiteData;
     sdkConfig: RuntimeSdkConfig | null;
     bookingOfferingPresets: readonly SiteBookingOfferingPresetSummary[];

package/dist/_dts/sdk/src/rendering/hooks/useContent.d.ts

@@ -58,7 +58,7 @@ type PageSuccessState = {
     page: PageProps['page'];
     runtimeBoundaries?: PageProps['runtimeBoundaries'];
     entry: null;
-    theme: Theme;
+    theme: Theme | null;
     siteId: string;
     resolvedData: ResolvedBlockData;
     supabaseUrl?: string;
@@ -73,7 +73,7 @@ type EntrySuccessState = {
     type: 'entry';
     page: null;
     entry: ContentEntryData;
-    theme: Theme;
+    theme: Theme | null;
     siteId: string;
     resolvedData: null;
 };
@@ -116,6 +116,7 @@ export declare function isEntryContentResult(result: UseContentResult): result i
  *   if (content.error) return <div>Error: {content.error.message}</div>;
  *
  *   if (isPageContentResult(content)) {
+ *     if (!content.theme) return <div>This site needs a theme before it can be displayed.</div>;
  *     return <Page page={content.page} theme={content.theme} siteId={content.siteId} resolvedData={content.resolvedData} />;
  *   }
  *
@@ -145,6 +146,7 @@ export declare function isEntryContentResult(result: UseContentResult): result i
  *   }
  * }
  *
+ * if (!content.theme) return <MissingTheme />;
  * return <Page {...content} />;
  * ```
  */

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

@@ -9,6 +9,8 @@ export type { PageProps } from './components/Page';
 export { Layout } from './components/Layout';
 export type { LayoutProps, HeaderData, FooterData, CustomHeaderData, CustomFooterData, } from './components/Layout';
 export { UnsupportedOverrideOnlyLayoutChromeError } from './components/Layout';
+export { MISSING_SDK_THEME_ERROR_CODE, MissingSdkThemeError, } from './themeAdmission';
+export type { MissingSdkThemeReason } from './themeAdmission';
 export type { SdkThemeResponsiveMode, SdkThemeRuntime } from './themeRuntime';
 export type { SdkOverrideOnlyRendering, SdkOverrideOnlyRuntime, SdkRenderingMode, } from './renderingMode';
 export { Block } from './components/Block';

package/dist/_dts/sdk/src/rendering/islands/types.d.ts

@@ -147,7 +147,12 @@ export type PublicPassProduct = {
     validDays: number | null;
     eligibleCategoryIds: string[];
     eligibleCategoryNames: string[];
-};
+} & ({
+    purchaseAvailability: 'purchasable';
+} | {
+    purchaseAvailability: 'display_only';
+    unavailabilityReason: 'online_payments_unavailable';
+});
 export type PublicMembershipProduct = {
     id: string;
     name: string;

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

@@ -5,6 +5,8 @@
 export { Page } from './components/Page.server';
 export type { PageProps } from './components/Page.server';
 export { Layout, UnsupportedOverrideOnlyLayoutChromeError, } from './components/Layout';
+export { MISSING_SDK_THEME_ERROR_CODE, MissingSdkThemeError, } from './themeAdmission';
+export type { MissingSdkThemeReason } from './themeAdmission';
 export type { LayoutProps, HeaderData, FooterData, CustomHeaderData, CustomFooterData, } from './components/Layout';
 export type { SdkThemeResponsiveMode, SdkThemeRuntime } from './themeRuntime';
 export type { SdkOverrideOnlyRendering, SdkOverrideOnlyRuntime, SdkRenderingMode, } from './renderingMode';

package/dist/_dts/sdk/src/rendering/themeAdmission.d.ts

@@ -0,0 +1,11 @@
+import type { Theme } from '../contracts';
+export declare const MISSING_SDK_THEME_ERROR_CODE: "missing_sdk_theme";
+export type MissingSdkThemeReason = 'cms_theme_absent' | 'local_theme_absent';
+export declare class MissingSdkThemeError extends Error {
+    readonly siteId: string;
+    readonly reason: MissingSdkThemeReason;
+    readonly themeKey?: string | undefined;
+    readonly code: "missing_sdk_theme";
+    constructor(siteId: string, reason?: MissingSdkThemeReason, themeKey?: string | undefined);
+}
+export declare function requireSdkTheme(theme: Theme | null | undefined, siteId: string, reason?: MissingSdkThemeReason): Theme;

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

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

package/dist/_dts/theme-core/src/blockOverrides.d.ts

@@ -1,4 +1,4 @@
-import type { BlockThemeOverride, Theme } from "./schema";
+import { type BlockThemeOverride, type Theme } from './schema';
 import type { HeadingDecorationOverride, VisibleHeadingDecoration } from "./site-styles/types";
 export declare function normalizeBlockKind(blockKind: string): string;
 export type EffectiveHeadingDecoration = Readonly<{

package/dist/_dts/theme-core/src/boxBackgroundSchema.d.ts

@@ -0,0 +1,184 @@
+import { z } from 'zod';
+export declare const boxBackgroundOverlaySchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"none">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"color">;
+    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    opacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"gradient">;
+    gradient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    opacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>], "type">>;
+export declare const boxBackgroundSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    contentOwner: z.ZodOptional<z.ZodLiteral<"page-design-editor">>;
+    textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    headingColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    linkColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    supportingColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodLiteral<"color">;
+    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    contentOwner: z.ZodOptional<z.ZodLiteral<"page-design-editor">>;
+    textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    headingColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    linkColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    supportingColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodLiteral<"gradient">;
+    gradient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gradientPresetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    contentOwner: z.ZodOptional<z.ZodLiteral<"page-design-editor">>;
+    textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    headingColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    linkColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    supportingColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    opacity: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodNumber>>>;
+    objectFit: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        fill: "fill";
+        custom: "custom";
+        fit: "fit";
+        original: "original";
+    }>>>;
+    scale: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    position: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    motion: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        static: "static";
+        "fixed-frame": "fixed-frame";
+    }>>>;
+    overflow: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    overlay: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        opacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"gradient">;
+        gradient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        opacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>], "type">>>>;
+    type: z.ZodLiteral<"image">;
+    image: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        purpose: z.ZodOptional<z.ZodString>;
+        placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        assetId: z.ZodOptional<z.ZodString>;
+        identifier: z.ZodOptional<z.ZodString>;
+        src: z.ZodOptional<z.ZodString>;
+        alt: z.ZodOptional<z.ZodString>;
+        filename: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        storageBucket: z.ZodOptional<z.ZodString>;
+        storagePath: z.ZodOptional<z.ZodString>;
+        poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            tag: z.ZodLiteral<"storage">;
+            assetId: z.ZodOptional<z.ZodString>;
+            storageBucket: z.ZodString;
+            storagePath: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            tag: z.ZodLiteral<"external-src">;
+            assetId: z.ZodOptional<z.ZodString>;
+            src: z.ZodString;
+        }, z.core.$strip>], "tag">>;
+        transform: z.ZodOptional<z.ZodObject<{
+            aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+                aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+                rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+                hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    radius: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>>;
+                rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+            }, z.core.$strip>>>>>;
+            rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            hotspot: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+        }, z.core.$strip>>;
+        type: z.ZodLiteral<"image">;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    contentOwner: z.ZodOptional<z.ZodLiteral<"page-design-editor">>;
+    textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    headingColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    linkColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    supportingColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    opacity: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodNumber>>>;
+    objectFit: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        fill: "fill";
+        custom: "custom";
+        fit: "fit";
+        original: "original";
+    }>>>;
+    scale: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    position: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    motion: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        static: "static";
+        "fixed-frame": "fixed-frame";
+    }>>>;
+    overflow: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    overlay: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        opacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"gradient">;
+        gradient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        opacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>], "type">>>>;
+    type: z.ZodLiteral<"video">;
+    image: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        purpose: z.ZodOptional<z.ZodString>;
+        placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        assetId: z.ZodOptional<z.ZodString>;
+        identifier: z.ZodOptional<z.ZodString>;
+        src: z.ZodOptional<z.ZodString>;
+        alt: z.ZodOptional<z.ZodString>;
+        filename: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        storageBucket: z.ZodOptional<z.ZodString>;
+        storagePath: z.ZodOptional<z.ZodString>;
+        poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            tag: z.ZodLiteral<"storage">;
+            assetId: z.ZodOptional<z.ZodString>;
+            storageBucket: z.ZodString;
+            storagePath: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            tag: z.ZodLiteral<"external-src">;
+            assetId: z.ZodOptional<z.ZodString>;
+            src: z.ZodString;
+        }, z.core.$strip>], "tag">>;
+        transform: z.ZodOptional<z.ZodObject<{
+            aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+                aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+                rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+                hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    radius: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>>;
+                rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+            }, z.core.$strip>>>>>;
+            rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            hotspot: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+        }, z.core.$strip>>;
+        type: z.ZodLiteral<"video">;
+    }, z.core.$strip>>>;
+    showVideoOnMobile: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>], "type">;
+export type BoxBackground = z.infer<typeof boxBackgroundSchema>;