@riverbankcms/sdk 0.70.0 → 0.70.3

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

@@ -27,4 +27,5 @@ export { Layout } from './rendering/components/Layout';
 export type { LayoutProps, HeaderData, FooterData } from './rendering/components/Layout';
 export { PageRenderer, ThemeScope, buildThemeRuntime, RichText, resolveImageUrl, resolveImageUrlWithContext, resolveImageSourceSetWithContext, ImagePresets, } from './rendering';
 export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, CollectionContent, ColumnsContent, CourseDetailsContent, CourseRegistrationContent, CtaFullContent, EmbedContent, EventCalendarContent, EventDetailsContent, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FormBlockContent, GiftingContent, HeroContent, HeroMedia, ImageGalleryContent, MediaTextContent, NewsletterSignupContent, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, SystemBlockContentByKind, SystemBlockContentFor, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, VideoGridContent, ImageOptions, ResolveImageUrlContext, ResolveImageSourceSetOptions, ResolvedImageSourceSet, PageOutline, RouteMap, Theme, ThemeTokens, Media, TipTapNode, LinkValue, RichTextPrimitiveProps, } from './rendering';
-export type { BlockOverrideProps, BlockOverrides, BlockOverrideComponent, KnownSystemBlockOverrides, } from './rendering';
+export type { BlockOverrideProps, BlockOverrideRegistration, BlockOverrideRegistrations, BlockOverrides, BlockOverrideComponent, KnownSystemBlockOverrides, LazyBlockOverrideFactory, LazyBlockOverrideRegistration, } from './rendering';
+export { defineLazyBlockOverride } from './rendering';

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

@@ -8,7 +8,7 @@ import type { ReactNode } from 'react';
 import type { RiverbankClient } from '../client/types';
 import type { RiverbankSiteConfig } from '../config/types';
 import type { Theme } from '../contracts';
-import type { BlockOverrides } from '../rendering/overrides';
+import type { BlockOverrideRegistrations } from '../rendering/overrides';
 import type { Metadata } from '../metadata/generatePageMetadata';
 import type { LoadContentResult } from '../rendering/helpers/loadContent';
 /**
@@ -182,8 +182,10 @@ export type CreateCatchAllPageOptions = {
     /**
      * Custom block component overrides for rendering.
      * Keys can be full block kind ("block.hero") or short form ("hero").
+     * Wrap client-heavy dynamic imports with defineLazyBlockOverride(); raw
+     * promise-returning functions are not lazy override registrations.
      */
-    blockOverrides?: BlockOverrides;
+    blockOverrides?: BlockOverrideRegistrations;
     /**
      * Override site URL for metadata generation.
      * Defaults to `config.liveUrl` or `config.previewUrl` based on preview mode.

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

@@ -297,6 +297,7 @@ export type SiteResponse = {
     theme: Theme;
     themeId?: string | null;
     selectionId?: string | null;
+    selectionVersion?: number | null;
     selectionUpdatedAt?: string | null;
     /**
      * Persisted design selections. Optional so legacy

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

@@ -23,7 +23,8 @@ export { ThemeScope, } from './blocks-theme-scope';
 export { buildThemeRuntime, } from './blocks-theme-runtime';
 export type { ComponentRegistry, PageRendererDataContext, PageRendererProps, SdkConfigForRenderer, } from './blocks-page-renderer';
 export type { ThemeScopeProps, } from './blocks-theme-scope';
-export type { BlockOverrideProps, BlockOverrideComponent, BlockOverrides, KnownSystemBlockOverrides, } from './overrides';
+export type { BlockOverrideProps, BlockOverrideComponent, BlockOverrideRegistration, BlockOverrideRegistrations, BlockOverrides, KnownSystemBlockOverrides, LazyBlockOverrideFactory, LazyBlockOverrideRegistration, } from './overrides';
+export { defineLazyBlockOverride } from './overrides';
 /**
  * @example Server-side rendering (Next.js App Router)
  * ```tsx

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

@@ -0,0 +1,10 @@
+import type { PageOutline } from '../contracts';
+import { type BlockOverrideRegistrations, type BlockOverrides } from './overrides';
+/**
+ * Resolve only override registrations used by the current page or template.
+ *
+ * Eager components are passed through unchanged. Lazy registrations created
+ * with `defineLazyBlockOverride()` are loaded only after their block kind is
+ * found in the rendered block tree.
+ */
+export declare function resolveBlockOverridesForPage(registrations: BlockOverrideRegistrations | undefined, page: PageOutline | null | undefined): Promise<BlockOverrides | undefined>;

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

@@ -25,8 +25,20 @@ type BivariantOverrideComponent<TContent = Record<string, unknown>> = {
     bivarianceHack(props: BlockOverrideProps<TContent, Record<string, unknown>>): React.ReactElement | null;
 }['bivarianceHack'];
 type CompatibleBlockOverrideComponent<TContent = Record<string, unknown>> = BlockOverrideComponent<TContent, Record<string, unknown>> | BivariantOverrideComponent<TContent>;
+export declare const lazyBlockOverrideSymbol: unique symbol;
+export type LazyBlockOverrideFactory<TContent = Record<string, unknown>> = () => Promise<BivariantOverrideComponent<TContent>>;
+export type LazyBlockOverrideRegistration<TContent = Record<string, unknown>> = {
+    readonly [lazyBlockOverrideSymbol]: true;
+    readonly load: LazyBlockOverrideFactory<TContent>;
+};
+export type BlockOverrideRegistration<TContent = Record<string, unknown>> = CompatibleBlockOverrideComponent<TContent> | LazyBlockOverrideRegistration<TContent>;
+export declare function defineLazyBlockOverride<TContent = Record<string, unknown>>(load: LazyBlockOverrideFactory<TContent>): LazyBlockOverrideRegistration<TContent>;
 export type KnownSystemBlockOverrides = {
     [K in keyof SystemBlockContentByKind]?: CompatibleBlockOverrideComponent<SystemBlockContentByKind[K]>;
 };
 export type BlockOverrides = KnownSystemBlockOverrides & Record<string, CompatibleBlockOverrideComponent<Record<string, unknown>>>;
+export type KnownSystemBlockOverrideRegistrations = {
+    [K in keyof SystemBlockContentByKind]?: BlockOverrideRegistration<SystemBlockContentByKind[K]>;
+};
+export type BlockOverrideRegistrations = KnownSystemBlockOverrideRegistrations & Record<string, BlockOverrideRegistration<Record<string, unknown>>>;
 export {};

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.70.0";
+export declare const SDK_VERSION = "0.70.3";

package/dist/_dts/site-commands/src/commands.d.ts

@@ -35,11 +35,17 @@ export declare const configureSiteIdentityCommandSchema: z.ZodObject<{
         }>>;
     }, z.core.$strict>;
 }, z.core.$strict>;
-export declare const applySiteStyleCommandSchema: z.ZodObject<{
-    type: z.ZodLiteral<"applySiteStyle">;
+export declare const applySiteStyleSelectionCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"applySiteStyleSelection">;
     ref: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleRef, string>>;
     input: z.ZodObject<{
-        styleKey: z.ZodString;
+        siteStyleId: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleRef, string>>;
+        buttonPersonalityId: z.ZodNullable<z.ZodString>;
+        paletteVariantId: z.ZodNullable<z.ZodString>;
+        paletteOverrides: z.ZodNullable<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        headerLookId: z.ZodNullable<z.ZodString>;
+        footerLookId: z.ZodNullable<z.ZodString>;
+        baseSelectionVersion: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 export declare const upsertMediaAssetCommandSchema: z.ZodObject<{
@@ -977,10 +983,16 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strict>>;
     }, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"applySiteStyle">;
+    type: z.ZodLiteral<"applySiteStyleSelection">;
     ref: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleRef, string>>;
     input: z.ZodObject<{
-        styleKey: z.ZodString;
+        siteStyleId: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleRef, string>>;
+        buttonPersonalityId: z.ZodNullable<z.ZodString>;
+        paletteVariantId: z.ZodNullable<z.ZodString>;
+        paletteOverrides: z.ZodNullable<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        headerLookId: z.ZodNullable<z.ZodString>;
+        footerLookId: z.ZodNullable<z.ZodString>;
+        baseSelectionVersion: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"upsertMediaAsset">;
@@ -1799,10 +1811,16 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
             }, z.core.$strict>>;
         }, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{
-        type: z.ZodLiteral<"applySiteStyle">;
+        type: z.ZodLiteral<"applySiteStyleSelection">;
         ref: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleRef, string>>;
         input: z.ZodObject<{
-            styleKey: z.ZodString;
+            siteStyleId: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleRef, string>>;
+            buttonPersonalityId: z.ZodNullable<z.ZodString>;
+            paletteVariantId: z.ZodNullable<z.ZodString>;
+            paletteOverrides: z.ZodNullable<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+            headerLookId: z.ZodNullable<z.ZodString>;
+            footerLookId: z.ZodNullable<z.ZodString>;
+            baseSelectionVersion: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertMediaAsset">;

package/dist/_dts/site-commands/src/metadata.d.ts

@@ -28,7 +28,7 @@ export declare const siteCommandMetadata: {
         readonly capability: "bookings.settings.write";
         readonly support: "supported";
     };
-    readonly applySiteStyle: {
+    readonly applySiteStyleSelection: {
         readonly scope: "style";
         readonly risk: "low";
         readonly writeSemantics: "upsert";
@@ -37,7 +37,7 @@ export declare const siteCommandMetadata: {
         readonly conflictPolicy: "update_existing";
         readonly previewability: "static_preview";
         readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
-        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "internal_apply"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "ai_proposal", "internal_apply"];
         readonly capability: "theme.write";
         readonly support: "supported";
     };