@riverbankcms/sdk 0.127.0 → 0.129.0

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

@@ -6,32 +6,34 @@
 import { buildMenu, buildFooterMenu, buildFooterMenuForRole, buildLogo } from '../../navigation';
 import type { RiverbankClient, SiteResponse } from '../../client/types';
 import { type SdkThemeRuntime } from '../themeRuntime';
-export type HeaderData = {
+import { type SdkOverrideOnlyRendering } from '../renderingMode';
+export type CustomHeaderData = {
     menu: ReturnType<typeof buildMenu>;
     logo: ReturnType<typeof buildLogo>;
     site: SiteResponse['site'];
-    theme: SiteResponse['theme'];
     routes: SiteResponse['routes'];
 };
-export type FooterData = {
+export type CustomFooterData = {
     menu: ReturnType<typeof buildMenu>;
     footerMenu: ReturnType<typeof buildFooterMenu>;
     legalFooterMenu: ReturnType<typeof buildFooterMenuForRole>;
     logo: ReturnType<typeof buildLogo>;
     site: SiteResponse['site'];
-    theme: SiteResponse['theme'];
     routes: SiteResponse['routes'];
 };
-export type LayoutProps = {
+export type HeaderData = CustomHeaderData & {
+    theme: SiteResponse['theme'];
+};
+export type FooterData = CustomFooterData & {
+    theme: SiteResponse['theme'];
+};
+type LayoutCommonProps = {
     siteData?: SiteResponse;
     client?: RiverbankClient;
     siteId?: string;
     slug?: string;
     domain?: string;
     children: React.ReactNode;
-    header?: boolean | ((data: HeaderData) => React.ReactNode);
-    footer?: boolean | ((data: FooterData) => React.ReactNode);
-    headerVariant?: 'classic' | 'centered' | 'transparent' | 'floating';
     /**
      * Whether the current request has an active portal session.
      * Used to resolve portal navigation labels (e.g. "Login" vs "My account").
@@ -41,17 +43,27 @@ export type LayoutProps = {
     hasPortalSession?: boolean;
     /** Render stage for internal links and block transforms. */
     previewStage?: 'published' | 'preview';
-    /**
-     * Controls the runtime wrapper around SDK layout content.
-     *
-     * - cms-theme: inject CMS theme variables and component CSS
-     * - responsive-only: keep the responsive utility root without CMS theme styles
-     * - none: render no SDK runtime wrapper; only safe with fully custom chrome
-     *
-     * @default { kind: 'cms-theme' }
-     */
+};
+type ThemedLayoutProps = LayoutCommonProps & {
+    rendering?: never;
+    header?: boolean | ((data: HeaderData) => React.ReactNode);
+    footer?: boolean | ((data: FooterData) => React.ReactNode);
+    headerVariant?: 'classic' | 'centered' | 'transparent' | 'floating';
     themeRuntime?: SdkThemeRuntime;
 };
+type OverrideOnlyLayoutProps = LayoutCommonProps & {
+    rendering: SdkOverrideOnlyRendering;
+    header: false | ((data: CustomHeaderData) => React.ReactNode);
+    footer: false | ((data: CustomFooterData) => React.ReactNode);
+    headerVariant?: never;
+    themeRuntime?: never;
+};
+export type LayoutProps = ThemedLayoutProps | OverrideOnlyLayoutProps;
+export declare class UnsupportedOverrideOnlyLayoutChromeError extends Error {
+    readonly surface: 'header' | 'footer';
+    readonly code = "unsupported_override_only_layout_chrome";
+    constructor(surface: 'header' | 'footer');
+}
 /**
  * Layout component that wraps content with site header and footer.
  *
@@ -87,4 +99,5 @@ export type LayoutProps = {
  * </Layout>
  * ```
  */
-export declare function Layout({ siteData: providedSiteData, client, siteId, slug, domain, children, header, footer, headerVariant, hasPortalSession, previewStage, themeRuntime, }: LayoutProps): Promise<import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>>;
+export declare function Layout(props: LayoutProps): Promise<import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>>;
+export {};

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

@@ -7,12 +7,11 @@ import { type ComponentRegistry } from '../blocks-page-renderer';
 import { type SdkThemeRuntime } from '../themeRuntime';
 import type { BlockOverrides } from '../overrides';
 import type { SdkCustomBlock } from '../../config/types';
-export type PageProps = {
+import type { SdkRenderingMode } from '../renderingMode';
+type PageCommonProps = {
     page: PageOutline;
     runtimeBoundaries?: readonly PageRuntimeBoundary[];
-    theme: Theme;
     siteId: string;
-    themeTokens?: ThemeTokens;
     resolvedData?: ResolvedBlockData;
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
     routeMap?: RouteMap;
@@ -82,17 +81,29 @@ export type PageProps = {
      * Keys can be full block kind ("block.hero") or short form ("hero").
      */
     blockOverrides?: BlockOverrides;
-    /**
-     * Controls the runtime wrapper around page content.
-     *
-     * @default { kind: 'none' }
-     */
+};
+type ThemedPageProps = PageCommonProps & {
+    rendering?: never;
+    theme: Theme;
+    themeTokens?: ThemeTokens;
+    /** @default { kind: 'none' } */
     themeRuntime?: SdkThemeRuntime;
 };
+type OverrideOnlyPageProps = PageCommonProps & {
+    rendering: Extract<SdkRenderingMode, {
+        kind: 'overrides-only';
+    }>;
+    theme?: never;
+    themeTokens?: never;
+    themeRuntime?: never;
+    blockOverrides: BlockOverrides;
+};
+export type PageProps = ThemedPageProps | OverrideOnlyPageProps;
 export type PageHydrationBootstrapConfig = {
     siteId: string;
     supabaseUrl?: string;
     mediaAssets?: readonly MediaAssetIndexItem[];
 };
 export declare function toPageHydrationBootstrapConfig(props: Pick<PageProps, 'siteId' | 'supabaseUrl' | 'mediaAssets'>): PageHydrationBootstrapConfig;
-export declare function PageContent({ page, runtimeBoundaries, theme, themeTokens: providedTokens, siteId, resolvedData, bookingOfferingPresets, routeMap, pagesByIdentifier, entriesByIdentifier, wrapBlock, registry, usePlaceholders, blockOverrides, sdkConfig, customBlocks, supabaseUrl, mediaAssets, apiBaseUrl, portalToken, previewToken, dataContext, themeRuntime, }: PageProps): ReactElement;
+export declare function PageContent(props: PageProps): ReactElement;
+export {};

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

@@ -7,8 +7,10 @@
 export { Page } from './components/Page';
 export type { PageProps } from './components/Page';
 export { Layout } from './components/Layout';
-export type { LayoutProps, HeaderData, FooterData } from './components/Layout';
+export type { LayoutProps, HeaderData, FooterData, CustomHeaderData, CustomFooterData, } from './components/Layout';
+export { UnsupportedOverrideOnlyLayoutChromeError } from './components/Layout';
 export type { SdkThemeResponsiveMode, SdkThemeRuntime } from './themeRuntime';
+export type { SdkOverrideOnlyRendering, SdkOverrideOnlyRuntime, SdkRenderingMode, } from './renderingMode';
 export { Block } from './components/Block';
 export type { BlockProps } from './components/Block';
 export { loadPage } from './helpers/loadPage';
@@ -16,14 +18,16 @@ export type { LoadPageParams, LoadPageResult } from './helpers/loadPage';
 export { loadContent, isPageContent, isEntryContent, isPageSurfaceContent, } from './helpers/loadContent';
 export type { LoadContentParams, LoadContentResult, ContentEntryData, PagePreviewMetadata, SiteData, } from './helpers/loadContent';
 export type { BlockLoaderMap, DataLoaderContext, DataLoaderFn, DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderRenderTarget, DataLoaderSearchParams, DataLoaderValue, } from '../data/types';
-export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CardStylesContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LayoutAlign, LayoutWidth, Media, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, TipTapNode, TipTapMark, LinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, PageOutline, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, Theme, ThemeTokens, RichTextDoc, SectionStylesContent, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, MediaAssetIndexItem, ImageOptions, ResolveImageUrlContext, ResolveImageUrlContextInput, ResolveImageSourceSetOptions, ResolvedImageSourceSet, } from '../contracts';
+export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CardStylesContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LayoutAlign, LayoutWidth, Media, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, RichTextDoc, TipTapNode, TipTapMark, LinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, PageOutline, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, Theme, ThemeTokens, SectionStylesContent, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, MediaAssetIndexItem, ImageOptions, ResolveImageUrlContext, ResolveImageUrlContextInput, ResolveImageSourceSetOptions, ResolvedImageSourceSet, } from '../contracts';
 export { ImagePresets } from '../contracts';
 export { RichText } from './primitives/RichText';
 export { resolveImageUrl, resolveImageUrlWithContext, resolveImageSourceSetWithContext, } from './image';
-export { PageRenderer } from './blocks-page-renderer';
+export { MissingBlockOverrideError, PageRenderer, toBlocksPageRendererDataContext, } from './blocks-page-renderer';
 export { ThemeScope } from './blocks-theme-scope';
 export { buildThemeRuntime } from './blocks-theme-runtime';
-export type { ComponentRegistry, PageRendererDataContext, PageRendererProps, SdkConfigForRenderer, } from './blocks-page-renderer';
+export { toBlocksImageResolveContextInput, toBlocksMediaAssets, } from './mediaAssets';
+export type { BlocksImageResolveContextInput, BlocksMediaAssetIndexItem, } from './mediaAssets';
+export type { ComponentRegistry, BlocksPageRendererDataContext, PageRendererDataContext, PageRendererProps, SdkConfigForRenderer, } from './blocks-page-renderer';
 export type { ThemeScopeProps } from './blocks-theme-scope';
 export type { BlockOverrideProps, BlockOverrideComponent, BlockOverrideRegistration, BlockOverrideRegistrations, BlockOverrides, CustomBlockOverrideKey, KnownSystemBlockOverrides, KnownBlockOverrideKey, LazyBlockOverrideFactory, LazyBlockOverrideRegistration, StrictBlockOverrideRegistrations, StrictBlockOverrides, SystemBlockOverrideKey, } from './overrides';
 export { defineBlockOverrideRegistrations, defineBlockOverrides, defineLazyBlockOverride, } from './overrides';

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

@@ -1,4 +1,10 @@
-import type { MediaAssetIndexItem as BlocksMediaAssetIndexItem, ResolveImageUrlContextInput as BlocksResolveImageUrlContextInput } from '../../../blocks/src/index';
+import { type MediaAssetId } from '../../../core/src/index';
 import type { MediaAssetIndexItem as SdkMediaAssetIndexItem, ResolveImageUrlContextInput as SdkResolveImageUrlContextInput } from '../contracts';
+export type BlocksMediaAssetIndexItem = Omit<SdkMediaAssetIndexItem, 'id'> & Readonly<{
+    id: MediaAssetId;
+}>;
+export type BlocksImageResolveContextInput = Omit<SdkResolveImageUrlContextInput, 'mediaAssets'> & Readonly<{
+    mediaAssets?: readonly BlocksMediaAssetIndexItem[];
+}>;
 export declare function toBlocksMediaAssets(assets: readonly SdkMediaAssetIndexItem[] | undefined): readonly BlocksMediaAssetIndexItem[] | undefined;
-export declare function toBlocksImageResolveContextInput(context: SdkResolveImageUrlContextInput | undefined): BlocksResolveImageUrlContextInput | undefined;
+export declare function toBlocksImageResolveContextInput(context: SdkResolveImageUrlContextInput | undefined): BlocksImageResolveContextInput | undefined;

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

@@ -0,0 +1,23 @@
+import type { SdkThemeRuntime } from './themeRuntime';
+export type SdkOverrideOnlyRuntime = Extract<SdkThemeRuntime, {
+    kind: 'responsive-only' | 'none';
+}>;
+export type SdkOverrideOnlyRendering = Readonly<{
+    kind: 'overrides-only';
+    runtime?: SdkOverrideOnlyRuntime;
+}>;
+export type SdkRenderingMode = Readonly<{
+    kind: 'themed';
+    themeRuntime: SdkThemeRuntime;
+}> | Readonly<{
+    kind: 'overrides-only';
+    runtime: SdkOverrideOnlyRuntime;
+}>;
+export declare const defaultOverrideOnlyRuntime: {
+    readonly kind: "responsive-only";
+};
+export declare function normalizeSdkRenderingMode(input: Readonly<{
+    rendering?: SdkOverrideOnlyRendering;
+    themeRuntime: SdkThemeRuntime;
+}>): SdkRenderingMode;
+export declare function themeRuntimeForRendering(rendering: SdkRenderingMode): SdkThemeRuntime;

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

@@ -4,11 +4,13 @@
  */
 export { Page } from './components/Page.server';
 export type { PageProps } from './components/Page.server';
-export { Layout } from './components/Layout';
-export type { LayoutProps, HeaderData, FooterData } from './components/Layout';
-export type { SdkThemeResponsiveMode, SdkThemeRuntime, } from './themeRuntime';
+export { Layout, UnsupportedOverrideOnlyLayoutChromeError, } from './components/Layout';
+export type { LayoutProps, HeaderData, FooterData, CustomHeaderData, CustomFooterData, } from './components/Layout';
+export type { SdkThemeResponsiveMode, SdkThemeRuntime } from './themeRuntime';
+export type { SdkOverrideOnlyRendering, SdkOverrideOnlyRuntime, SdkRenderingMode, } from './renderingMode';
 export { Block } from './components/Block.server';
 export type { BlockProps } from './components/Block.server';
+export { MissingBlockOverrideError } from './blocks-page-renderer';
 export { defineBlockOverrideRegistrations, defineBlockOverrides, defineLazyBlockOverride, } from './overrides';
 export { buildPageBlockKindIndex, collectUsedBlockKindsFromPageOutline, resolveBlockOverridesForPage, } from './overrideResolution';
 export type { PageBlockKindIndex } from './overrideResolution';

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

@@ -24,3 +24,9 @@ export declare function renderWithSdkThemeRuntime({ themeRuntime, theme, childre
     theme: Theme;
     children: React.ReactNode;
 }): React.ReactElement;
+export declare function renderWithOverrideOnlyRuntime({ runtime, children, }: {
+    runtime: Extract<SdkThemeRuntime, {
+        kind: 'responsive-only' | 'none';
+    }>;
+    children: React.ReactNode;
+}): React.ReactElement;

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

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

@@ -674,7 +674,14 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
         type: z.ZodLiteral<"upsertFooterContent">;
         ref: z.ZodPipe<z.ZodString, z.ZodTransform<import("./refs").FooterRef, string>>;
         input: z.ZodObject<{
-            bottomText: z.ZodOptional<z.ZodNullable<z.ZodCustom<import("../../core/src/index").RichTextDoc, import("../../core/src/index").RichTextDoc>>>;
+            composition: z.ZodCustom<Readonly<{
+                schemaVersion: 1;
+                sections: readonly import("../../core/src/index").FooterSection[];
+            }>, Readonly<{
+                schemaVersion: 1;
+                sections: readonly import("../../core/src/index").FooterSection[];
+            }>>;
+            baseRevision: z.ZodNumber;
         }, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertContentEntry">;

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

@@ -224,7 +224,14 @@ export declare const upsertFooterContentCommandSchema: z.ZodObject<{
     type: z.ZodLiteral<"upsertFooterContent">;
     ref: z.ZodPipe<z.ZodString, z.ZodTransform<FooterRef, string>>;
     input: z.ZodObject<{
-        bottomText: z.ZodOptional<z.ZodNullable<z.ZodCustom<RichTextDoc, RichTextDoc>>>;
+        composition: z.ZodCustom<Readonly<{
+            schemaVersion: 1;
+            sections: readonly import("../../core/src/index").FooterSection[];
+        }>, Readonly<{
+            schemaVersion: 1;
+            sections: readonly import("../../core/src/index").FooterSection[];
+        }>>;
+        baseRevision: z.ZodNumber;
     }, z.core.$strict>;
 }, z.core.$strict>;
 export declare const upsertContentEntryCommandSchema: z.ZodObject<{
@@ -1392,7 +1399,14 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"upsertFooterContent">;
     ref: z.ZodPipe<z.ZodString, z.ZodTransform<FooterRef, string>>;
     input: z.ZodObject<{
-        bottomText: z.ZodOptional<z.ZodNullable<z.ZodCustom<RichTextDoc, RichTextDoc>>>;
+        composition: z.ZodCustom<Readonly<{
+            schemaVersion: 1;
+            sections: readonly import("../../core/src/index").FooterSection[];
+        }>, Readonly<{
+            schemaVersion: 1;
+            sections: readonly import("../../core/src/index").FooterSection[];
+        }>>;
+        baseRevision: z.ZodNumber;
     }, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"upsertContentEntry">;

package/dist/_dts/theme-core/src/header/paintTargets.d.ts

@@ -11,10 +11,16 @@ type ViewportBandPaintTarget = Readonly<{
     ownerSelector: string;
     selector: string;
     mediaQuery: string;
-    topExtension: Readonly<{
-        customProperty: '--rb-header-floating-top-gap';
-        value: '1rem' | '0.75rem';
-        ownerProperty: 'top' | 'margin-top';
+    extent: Readonly<{
+        top: Readonly<{
+            customProperty: '--rb-header-floating-top-gap';
+            value: '1rem' | '0.75rem';
+            ownerProperty: 'top' | 'margin-top';
+        }>;
+        bottom: Readonly<{
+            customProperty: '--rb-header-floating-bottom-extension';
+            value: '0.75rem';
+        }>;
     }>;
     ownerNeedsPositioning: boolean;
 }>;

package/dist/_dts/theme-core/src/header/surfaceRules.d.ts

@@ -2,8 +2,7 @@ import type { ThemeHeader } from '../schema';
 import type { TokenResolver } from '../tokens/resolver';
 export type HeaderSurfaceRules = Readonly<{
     base: readonly string[];
-    scrolled: readonly string[];
     border: readonly string[];
 }>;
-/** Compile the visual surface declarations independently of paint geometry. */
-export declare function buildHeaderSurfaceRules(header: ThemeHeader, tokens: TokenResolver, blur: string): HeaderSurfaceRules;
+/** Compile the at-rest surface independently of scroll treatment and paint geometry. */
+export declare function buildHeaderSurfaceRules(header: ThemeHeader, tokens: TokenResolver): HeaderSurfaceRules;