@riverbankcms/sdk 0.88.0 → 0.90.0

package/dist/_dts/sdk/src/client/runtimeCachePolicy.d.ts

@@ -0,0 +1,160 @@
+import type { PublicEndpointName } from '../public-api/contracts';
+import type { GetPageParams, GetSiteParams } from './types';
+declare const publishedRuntimeCacheKeyBrand: unique symbol;
+declare const publishedRuntimeCachePayloadSchemaVersionBrand: unique symbol;
+export type PublishedRuntimeCacheKey = string & {
+    readonly [publishedRuntimeCacheKeyBrand]: 'PublishedRuntimeCacheKey';
+};
+export type PublishedRuntimeCachePayloadSchemaVersion = number & {
+    readonly [publishedRuntimeCachePayloadSchemaVersionBrand]: 'PublishedRuntimeCachePayloadSchemaVersion';
+};
+export declare const DEFAULT_PUBLISHED_RUNTIME_CACHE_PAYLOAD_SCHEMA_VERSION: PublishedRuntimeCachePayloadSchemaVersion;
+export type RuntimeCachePolicyKind = 'durable-public-stale' | 'memory-only' | 'live-only';
+export type RuntimeCacheLiveOnlyReason = 'unknown_endpoint' | 'non_get_request' | 'preview_request' | 'force_refresh' | 'opaque_batch_loader' | 'challenge_endpoint' | 'auth_required' | 'safety_sensitive_booking';
+export type RuntimeCachePolicy = Readonly<{
+    kind: 'durable-public-stale';
+    endpoint: PublicEndpointName;
+    freshTtlSec: number;
+    staleTtlSec: number;
+}> | Readonly<{
+    kind: 'memory-only';
+    endpoint: PublicEndpointName;
+    freshTtlSec: number;
+    reason: 'durable_rollout_pending';
+}> | Readonly<{
+    kind: 'live-only';
+    endpoint: string;
+    reason: RuntimeCacheLiveOnlyReason;
+}>;
+export type RuntimeCacheParams = Readonly<Record<string, string | number | boolean | null | undefined>>;
+export type ResolveRuntimeCachePolicyInput = Readonly<{
+    endpoint: string;
+    method?: string;
+    params?: RuntimeCacheParams;
+}>;
+export declare function resolveRuntimeCachePolicy(input: ResolveRuntimeCachePolicyInput): RuntimeCachePolicy;
+export type GetSiteRuntimeCacheParams = Readonly<Pick<GetSiteParams, 'id' | 'slug' | 'domain' | 'currentPath' | 'force'>>;
+export type GetContentByPathRuntimeCacheParams = Readonly<Pick<GetPageParams, 'siteId' | 'path' | 'preview'>>;
+type KeyDeriverInputByEndpoint = Readonly<{
+    getSite: GetSiteRuntimeCacheParams;
+    getContentByPath: GetContentByPathRuntimeCacheParams;
+}>;
+export type PublishedRuntimeCacheKeyEndpoint = keyof typeof DURABLE_RUNTIME_CACHE_KEY_DERIVERS;
+export type ParsePublishedRuntimeCacheKeyResult = Readonly<{
+    ok: true;
+    key: PublishedRuntimeCacheKey;
+    endpoint: PublishedRuntimeCacheKeyEndpoint;
+}> | Readonly<{
+    ok: false;
+    error: 'not_string' | 'invalid_prefix' | 'unknown_endpoint' | 'invalid_param_encoding';
+}>;
+export type ParsePublishedRuntimeCacheKeyDetailsResult = Readonly<{
+    ok: true;
+    key: PublishedRuntimeCacheKey;
+    endpoint: PublishedRuntimeCacheKeyEndpoint;
+    normalizedParams: PublishedRuntimeNormalizedParams;
+}> | Readonly<{
+    ok: false;
+    error: 'not_string' | 'invalid_prefix' | 'unknown_endpoint' | 'invalid_param_encoding';
+}>;
+export type ParsePublishedRuntimeCachePayloadSchemaVersionResult = Readonly<{
+    ok: true;
+    value: PublishedRuntimeCachePayloadSchemaVersion;
+}> | Readonly<{
+    ok: false;
+    error: 'not_number' | 'not_integer' | 'not_positive';
+}>;
+export type PublishedRuntimeCacheFreshness = Readonly<{
+    kind: 'fresh';
+    staleAgeSec: 0;
+}> | Readonly<{
+    kind: 'stale';
+    staleAgeSec: number;
+}> | Readonly<{
+    kind: 'expired';
+}> | Readonly<{
+    kind: 'invalid_timestamp';
+    field: 'freshUntil' | 'staleUntil';
+}>;
+export type ClassifyPublishedRuntimeCacheFreshnessInput = Readonly<{
+    freshUntil: string;
+    staleUntil: string;
+    now: Date;
+}>;
+export type PublishedRuntimeCacheReadInput = Readonly<{
+    cacheKey: PublishedRuntimeCacheKey;
+    endpoint: PublishedRuntimeCacheKeyEndpoint;
+    payloadSchemaVersion?: PublishedRuntimeCachePayloadSchemaVersion;
+}>;
+export type PublishedRuntimeCacheReadResult<TPayload = unknown> = Readonly<{
+    kind: 'hit';
+    freshness: 'fresh' | 'stale';
+    payload: TPayload;
+    staleAgeSec: number;
+}> | Readonly<{
+    kind: 'miss';
+    reason: 'not_found' | 'expired' | 'schema_mismatch';
+}> | Readonly<{
+    kind: 'error';
+    error: Readonly<{
+        kind: PublishedRuntimeCacheAdapterErrorKind;
+        message: string;
+    }>;
+}>;
+export type PublishedRuntimeCacheAdapterErrorKind = 'read_failed' | 'corrupt_row' | 'adapter_exception';
+export type PublishedRuntimeCacheWriteInput<TPayload = unknown> = Readonly<{
+    cacheKey: PublishedRuntimeCacheKey;
+    endpoint: PublishedRuntimeCacheKeyEndpoint;
+    normalizedParams: PublishedRuntimeNormalizedParams;
+    payload: TPayload;
+    siteId?: string | null;
+    freshTtlSec: number;
+    staleTtlSec: number;
+    payloadSchemaVersion?: PublishedRuntimeCachePayloadSchemaVersion;
+    writeReason?: string;
+}>;
+export type PublishedRuntimeCacheAdapter = Readonly<{
+    read?: <TPayload = unknown>(input: PublishedRuntimeCacheReadInput) => Promise<PublishedRuntimeCacheReadResult<TPayload>>;
+    write?: <TPayload = unknown>(input: PublishedRuntimeCacheWriteInput<TPayload>) => void | Promise<void>;
+}>;
+export type DerivePublishedRuntimeCacheKeyInput = {
+    [E in PublishedRuntimeCacheKeyEndpoint]: Readonly<{
+        endpoint: E;
+        params: KeyDeriverInputByEndpoint[E];
+    }>;
+}[PublishedRuntimeCacheKeyEndpoint];
+export type PublishedRuntimeNormalizedParams = Readonly<Record<string, string>>;
+export type PublishedRuntimeCacheKeyError = Readonly<{
+    kind: 'not_durable_eligible';
+    policy: RuntimeCachePolicy;
+}> | Readonly<{
+    kind: 'missing_site_identity';
+    acceptedParams: readonly ['slug', 'domain', 'id'];
+}> | Readonly<{
+    kind: 'missing_required_param';
+    endpoint: PublishedRuntimeCacheKeyEndpoint;
+    param: 'siteId';
+}>;
+export type DerivePublishedRuntimeCacheKeyResult = Readonly<{
+    ok: true;
+    endpoint: PublishedRuntimeCacheKeyEndpoint;
+    key: PublishedRuntimeCacheKey;
+    normalizedParams: PublishedRuntimeNormalizedParams;
+}> | Readonly<{
+    ok: false;
+    error: PublishedRuntimeCacheKeyError;
+}>;
+export declare function normalizeRuntimePublicPath(value: unknown): string;
+declare function deriveGetSiteKey(params: GetSiteRuntimeCacheParams): DerivePublishedRuntimeCacheKeyResult;
+declare function deriveGetContentByPathKey(params: GetContentByPathRuntimeCacheParams): DerivePublishedRuntimeCacheKeyResult;
+declare const DURABLE_RUNTIME_CACHE_KEY_DERIVERS: {
+    readonly getSite: typeof deriveGetSiteKey;
+    readonly getContentByPath: typeof deriveGetContentByPathKey;
+};
+export declare function isPublishedRuntimeCacheKeyEndpoint(value: unknown): value is PublishedRuntimeCacheKeyEndpoint;
+export declare function parsePublishedRuntimeCacheKey(value: unknown): ParsePublishedRuntimeCacheKeyResult;
+export declare function parsePublishedRuntimeCacheKeyDetails(value: unknown): ParsePublishedRuntimeCacheKeyDetailsResult;
+export declare function parsePublishedRuntimeCachePayloadSchemaVersion(value: unknown): ParsePublishedRuntimeCachePayloadSchemaVersionResult;
+export declare function classifyPublishedRuntimeCacheFreshness(input: ClassifyPublishedRuntimeCacheFreshnessInput): PublishedRuntimeCacheFreshness;
+export declare function derivePublishedRuntimeCacheKey(input: DerivePublishedRuntimeCacheKeyInput): DerivePublishedRuntimeCacheKeyResult;
+export {};

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

@@ -1,4 +1,5 @@
 import type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicCoursesResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, PublicEventsResponse, ResolveEntrySubrouteResponse, ResolveEventOccurrenceResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, PublicProductCategorySelector } from '../public-api/contracts';
+import type { PublishedRuntimeCacheAdapter, PublishedRuntimeCacheAdapterErrorKind } from './runtimeCachePolicy';
 export type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicCoursesResponse, PublicEventsResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, ResolveEntrySubrouteResponse, ResolveEventOccurrenceResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, } from '../public-api/contracts';
 /**
  * Pagination metadata returned when `includeMeta: true`
@@ -88,12 +89,27 @@ export type GetEntriesByIdentifiersParams = {
  * Source of the data returned by a resilient fetch
  */
 export type ResilienceSource = 'live' | 'cache' | 'stale' | 'prebuild' | 'error';
+export type ResilienceCacheTier = 'memory-fresh' | 'memory-stale' | 'durable-fresh' | 'durable-stale' | 'prebuild';
+export type ResilienceDurableCacheDiagnostic = Readonly<{
+    outcome: 'miss';
+    reason: 'not_found' | 'expired' | 'schema_mismatch';
+}> | Readonly<{
+    outcome: 'error';
+    error: Readonly<{
+        kind: PublishedRuntimeCacheAdapterErrorKind;
+        message: string;
+    }>;
+}>;
 /**
  * Status information from a resilient fetch operation
  */
 export interface ResilienceStatus {
     /** Where the data came from */
     source: ResilienceSource;
+    /** More precise cache tier when source is cache/stale/prebuild */
+    cacheTier?: ResilienceCacheTier;
+    /** Durable cache miss/error details when live origin failed and no durable hit was served */
+    durableCache?: ResilienceDurableCacheDiagnostic;
     /** Whether this was a preview request */
     isPreview: boolean;
     /** Cache key used for this request */
@@ -243,7 +259,8 @@ export type SdkAuthConfig = {
 };
 export declare const SDK_CORRELATION_HEADER_NAMES: readonly ["x-request-id", "x-correlation-id", "x-riverbank-monitor-run-id"];
 export type SdkCorrelationHeaderName = (typeof SDK_CORRELATION_HEADER_NAMES)[number];
-export type SdkCorrelationHeaders = Readonly<Partial<Record<SdkCorrelationHeaderName, string>>>;
+export type SdkDefaultHeaderName = SdkCorrelationHeaderName | 'x-vercel-protection-bypass';
+export type SdkCorrelationHeaders = Readonly<Partial<Record<SdkDefaultHeaderName, string>>>;
 /**
  * Configuration for creating a Riverbank CMS client
  */
@@ -286,6 +303,14 @@ export interface RiverbankClientConfig {
      * Per-request headers still win when an individual SDK method supplies `options.headers`.
      */
     defaultHeaders?: SdkCorrelationHeaders;
+    /**
+     * Optional durable published runtime cache adapter.
+     *
+     * Used only for default-closed, anonymous published endpoints that the SDK
+     * policy marks durable-stale eligible. The SDK owns fallback ordering and
+     * metadata; the app owns the storage implementation.
+     */
+    publishedRuntimeCache?: PublishedRuntimeCacheAdapter;
     /**
      * Cache configuration
      */

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

@@ -25,6 +25,7 @@ export { Page } from './rendering/components/Page';
 export type { PageProps } from './rendering/components/Page';
 export { Layout } from './rendering/components/Layout';
 export type { LayoutProps, HeaderData, FooterData } from './rendering/components/Layout';
+export type { SdkThemeResponsiveMode, SdkThemeRuntime, } from './rendering/themeRuntime';
 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, BlockOverrideRegistration, BlockOverrideRegistrations, BlockOverrides, BlockOverrideComponent, CustomBlockOverrideKey, KnownSystemBlockOverrides, KnownBlockOverrideKey, LazyBlockOverrideFactory, LazyBlockOverrideRegistration, StrictBlockOverrideRegistrations, StrictBlockOverrides, SystemBlockOverrideKey, } from './rendering';

package/dist/_dts/sdk/src/config/field-definitions.d.ts

@@ -29,7 +29,9 @@ export type FieldVisibilityPredicate = {
     maxItems?: number;
 };
 export type FieldVisibilityCondition = FieldVisibilityPredicate | {
-    allOf: FieldVisibilityPredicate[];
+    allOf: FieldVisibilityCondition[];
+} | {
+    anyOf: FieldVisibilityCondition[];
 };
 export type FieldUi = Partial<{
     widget: string;

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

@@ -215,9 +215,10 @@ export type EmbedContent = {
 export type EventLayout = 'grid' | 'stack' | 'compact';
 export type ColumnOption = '2' | '3' | '4';
 export type WeekStart = 'sunday' | 'monday';
-export type DisplayMode = 'combined' | 'month' | 'week' | 'list' | 'timetable';
+export type DisplayMode = 'combined' | 'calendar' | 'list' | 'timetable';
 export type FilterAutoShow = 'auto' | 'always' | 'never';
 export type CalendarTabViews = 'both' | 'month' | 'week';
+export type CalendarView = 'month' | 'week';
 export type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'link';
 export type CardVariantRole = 'default' | 'alternative';
 export type LegacyCardVariantRoleAlias = 'variant1' | 'variant2';
@@ -238,6 +239,7 @@ export type EventCalendarContent = {
     loadMoreText?: string | null;
     startOfWeek?: WeekStart | null;
     calendarTabViews?: CalendarTabViews | null;
+    defaultCalendarView?: CalendarView | null;
     showFilters?: boolean | null;
     showCategoryFilter?: FilterAutoShow | null;
     showVenueFilter?: boolean | null;

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

@@ -19,12 +19,14 @@
  */
 export { createRiverbankClient, getResilienceStatusFromError, RiverbankApiError, } from './client/index';
 export { SDK_CORRELATION_HEADER_NAMES } from './client/types';
-export type { RiverbankClient, RiverbankClientConfig, SdkCorrelationHeaderName, SdkCorrelationHeaders, SdkAuthConfig, SiteResponse, PageResponse, EntriesResponse, EntriesResponseWithMeta, GetEntriesByIdentifiersParams, GetPageParams, GetSiteParams, PaginationMeta, EntryResponse, ResilienceConfig, ResilienceStatus, ResilientData, ResilienceSource, CircuitState, RetryConfig, CircuitBreakerConfig, } from './client/types';
+export type { RiverbankClient, RiverbankClientConfig, SdkCorrelationHeaderName, SdkCorrelationHeaders, SdkAuthConfig, SiteResponse, PageResponse, EntriesResponse, EntriesResponseWithMeta, GetEntriesByIdentifiersParams, GetPageParams, GetSiteParams, PaginationMeta, EntryResponse, ResilienceConfig, ResilienceDurableCacheDiagnostic, ResilienceStatus, ResilientData, ResilienceSource, CircuitState, RetryConfig, CircuitBreakerConfig, } from './client/types';
 export { prebuildCache } from './prebuild/index';
 export type { PrebuildOptions, PrebuildResult, PrebuildProgress, PrebuildManifest, PrebuildContentType, } from './prebuild/types';
 export { PrebuildLoader, createPrebuildLoader, canUsePrebuild, } from './prebuild/loader';
 export type { PrebuildLoaderConfig, LoadResult } from './prebuild/loader';
 export type { ApiClient } from './public-api/runtime';
 export { buildEndpointURL, API_ENDPOINTS } from './public-api/runtime';
+export { DEFAULT_PUBLISHED_RUNTIME_CACHE_PAYLOAD_SCHEMA_VERSION, classifyPublishedRuntimeCacheFreshness, derivePublishedRuntimeCacheKey, isPublishedRuntimeCacheKeyEndpoint, normalizeRuntimePublicPath, parsePublishedRuntimeCacheKey, parsePublishedRuntimeCacheKeyDetails, parsePublishedRuntimeCachePayloadSchemaVersion, resolveRuntimeCachePolicy, } from './client/runtimeCachePolicy';
+export type { ClassifyPublishedRuntimeCacheFreshnessInput, DerivePublishedRuntimeCacheKeyInput, DerivePublishedRuntimeCacheKeyResult, GetContentByPathRuntimeCacheParams, GetSiteRuntimeCacheParams, ParsePublishedRuntimeCacheKeyResult, ParsePublishedRuntimeCacheKeyDetailsResult, ParsePublishedRuntimeCachePayloadSchemaVersionResult, PublishedRuntimeCacheAdapter, PublishedRuntimeCacheAdapterErrorKind, PublishedRuntimeCacheFreshness, PublishedRuntimeCacheKey, PublishedRuntimeCacheKeyEndpoint, PublishedRuntimeCacheKeyError, PublishedRuntimeCachePayloadSchemaVersion, PublishedRuntimeCacheReadInput, PublishedRuntimeCacheReadResult, PublishedRuntimeCacheWriteInput, PublishedRuntimeNormalizedParams, ResolveRuntimeCachePolicyInput, RuntimeCacheLiveOnlyReason, RuntimeCacheParams, RuntimeCachePolicy, RuntimeCachePolicyKind, } from './client/runtimeCachePolicy';
 export type { RiverbankSiteConfig, SiteStyleConfig, SectionBackground, SectionOptionsConfig, ContainerOptionsConfig, SectionSpacing, ContainerMaxWidth, ContainerAlignment, } from './config';
 export { SYSTEM_BLOCK_KINDS, type SystemBlockKind, type CustomBlockKind, type BlockKind, } from './types';

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

@@ -8,6 +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 { SdkThemeRuntime } from '../rendering/themeRuntime';
 import type { BlockOverrideRegistrations } from '../rendering/overrides';
 import type { Metadata } from '../metadata/generatePageMetadata';
 import type { LoadContentResult } from '../rendering/helpers/loadContent';
@@ -23,13 +24,11 @@ export interface CatchAllContext {
     /** Whether preview mode is enabled */
     preview: boolean;
     /**
-     * Whether the SDK page renderer should wrap content in ThemeScope.
-     *
-     * This is the same `useThemeScope` value passed to `createCatchAllPage()`.
-     * Preview mode should mirror this so SDK sites that fully own their styling
-     * don't accidentally get CMS theme styling applied only while editing.
+     * Runtime wrapper used by the SDK page renderer.
+     * Preview mode mirrors this so editing and live rendering use the same
+     * visual theme/responsive infrastructure contract.
      */
-    useThemeScope: boolean;
+    themeRuntime: SdkThemeRuntime;
     /** Search parameters from the URL (for filtering, pagination, etc.) */
     searchParams: Record<string, string | string[] | undefined>;
 }
@@ -279,13 +278,11 @@ export type CreateCatchAllPageOptions = {
         children: ReactNode;
     }) => ReactNode | Promise<ReactNode>;
     /**
-     * Wrap page content in ThemeScope to inject theme CSS variables and styles.
-     * Enable this to use built-in theme styling from the CMS.
-     * Disable if you're bringing your own styles.
+     * Controls the runtime wrapper around rendered page content.
      *
-     * @default false
+     * @default { kind: 'responsive-only' }
      */
-    useThemeScope?: boolean;
+    themeRuntime?: SdkThemeRuntime;
     /**
      * Enable portal authentication for the reserved `/portal` customer route.
      *

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

@@ -1,6 +1,6 @@
 import React, { type ReactNode } from "react";
 import type { PreviewShellLayoutProps, PreviewShellProps, SdkPreviewModeProps } from "../../../../preview-next/src/client/index";
-export type { SdkPreviewModeContent, SdkPreviewModeProps, PreviewShellProps, PreviewShellLayoutProps, } from '../../../../preview-next/src/client/index';
+export type { SdkPreviewModeContent, SdkPreviewModeProps, PreviewThemeRuntime, PreviewThemeResponsiveMode, PreviewShellProps, PreviewShellLayoutProps, } from '../../../../preview-next/src/client/index';
 type PreviewQueryProviderProps = Readonly<{
     children: ReactNode;
 }>;

package/dist/_dts/sdk/src/rendering/blocks-theme-scope.d.ts

@@ -1,10 +1,11 @@
 import * as React from 'react';
+import type { ThemeResponsiveMode } from '../../../theme-core/src/index';
 import type { Theme } from '../contracts';
 export type ThemeScopeProps = {
     theme: Theme;
     children?: React.ReactNode;
     themeId?: string;
-    responsiveMode?: 'viewport' | 'container';
+    responsiveMode?: ThemeResponsiveMode;
     className?: string;
 };
 export declare function ThemeScope(props: ThemeScopeProps): React.ReactElement;

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

@@ -5,6 +5,7 @@
  */
 import { buildMenu, buildFooterMenu, buildLogo } from '../../navigation';
 import type { RiverbankClient, SiteResponse } from '../../client/types';
+import { type SdkThemeRuntime } from '../themeRuntime';
 export type HeaderData = {
     menu: ReturnType<typeof buildMenu>;
     logo: ReturnType<typeof buildLogo>;
@@ -40,15 +41,15 @@ export type LayoutProps = {
     /** Render stage for internal links and block transforms. */
     previewStage?: 'published' | 'preview';
     /**
-     * Wrap layout content in ThemeScope to inject theme CSS variables and styles.
-     * Enable this to use built-in theme styling from the CMS.
-     * Disable if you're bringing your own styles and want to avoid SDK-injected theme variables.
+     * Controls the runtime wrapper around SDK layout content.
      *
-     * Note: Disabling this while using the default header/footer (blocks) may result in unstyled output.
+     * - 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 true
+     * @default { kind: 'cms-theme' }
      */
-    useThemeScope?: boolean;
+    themeRuntime?: SdkThemeRuntime;
 };
 /**
  * Layout component that wraps content with site header and footer.
@@ -85,4 +86,4 @@ export type LayoutProps = {
  * </Layout>
  * ```
  */
-export declare function Layout({ siteData: providedSiteData, client, siteId, slug, domain, children, header, footer, headerVariant, hasPortalSession, previewStage, useThemeScope, }: LayoutProps): Promise<import("react").JSX.Element>;
+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>>>;

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

@@ -4,6 +4,7 @@ import type { ResolvedBlockData } from '../../data';
 import type { SiteBookingOfferingPresetSummary } from '../../public-api/contracts';
 import type { RuntimeSdkConfig } from '../helpers/loadPage';
 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 = {
@@ -77,13 +78,11 @@ export type PageProps = {
      */
     blockOverrides?: BlockOverrides;
     /**
-     * Wrap content in ThemeScope to inject theme CSS variables and styles.
-     * Enable this to use built-in theme styling from the CMS.
-     * Disable if you're bringing your own styles.
+     * Controls the runtime wrapper around page content.
      *
-     * @default false
+     * @default { kind: 'none' }
      */
-    useThemeScope?: boolean;
+    themeRuntime?: SdkThemeRuntime;
 };
 export type PageHydrationBootstrapConfig = {
     siteId: string;
@@ -91,4 +90,4 @@ export type PageHydrationBootstrapConfig = {
     mediaAssets?: readonly MediaAssetIndexItem[];
 };
 export declare function toPageHydrationBootstrapConfig(props: Pick<PageProps, 'siteId' | 'supabaseUrl' | 'mediaAssets'>): PageHydrationBootstrapConfig;
-export declare function PageContent({ page, theme, themeTokens: providedTokens, siteId, resolvedData, bookingOfferingPresets, routeMap, pagesByIdentifier, entriesByIdentifier, wrapBlock, registry, usePlaceholders, blockOverrides, sdkConfig, customBlocks, supabaseUrl, mediaAssets, apiBaseUrl, portalToken, previewToken, dataContext, useThemeScope, }: PageProps): ReactElement;
+export declare function PageContent({ page, theme, themeTokens: providedTokens, siteId, resolvedData, bookingOfferingPresets, routeMap, pagesByIdentifier, entriesByIdentifier, wrapBlock, registry, usePlaceholders, blockOverrides, sdkConfig, customBlocks, supabaseUrl, mediaAssets, apiBaseUrl, portalToken, previewToken, dataContext, themeRuntime, }: PageProps): ReactElement;

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

@@ -8,6 +8,7 @@ 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 { SdkThemeResponsiveMode, SdkThemeRuntime, } from './themeRuntime';
 export { Block } from './components/Block';
 export type { BlockProps } from './components/Block';
 export { loadPage } from './helpers/loadPage';

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

@@ -6,6 +6,7 @@ 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 { Block } from './components/Block.server';
 export type { BlockProps } from './components/Block.server';
 export { defineBlockOverrideRegistrations, defineBlockOverrides, defineLazyBlockOverride, } from './overrides';

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

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { ThemeResponsiveMode, ThemeRuntime } from '../../../theme-core/src/index';
+import type { Theme } from '../contracts';
+export type SdkThemeResponsiveMode = ThemeResponsiveMode;
+export type SdkThemeRuntime = ThemeRuntime;
+export declare const defaultLayoutThemeRuntime: {
+    readonly kind: "cms-theme";
+};
+export declare const defaultSdkChromeThemeRuntime: {
+    readonly kind: "responsive-only";
+};
+export declare const defaultPageThemeRuntime: {
+    readonly kind: "none";
+};
+export declare const defaultCatchAllThemeRuntime: {
+    readonly kind: "responsive-only";
+};
+export declare function planLayoutThemeRuntime(input: {
+    themeRuntime?: SdkThemeRuntime;
+    usesSdkChrome: boolean;
+}): SdkThemeRuntime;
+export declare function renderWithSdkThemeRuntime({ themeRuntime, theme, children, }: {
+    themeRuntime: SdkThemeRuntime;
+    theme: Theme;
+    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.88.0";
+export declare const SDK_VERSION = "0.90.0";

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

@@ -406,6 +406,7 @@ export declare const upsertEventSeriesCommandSchema: z.ZodObject<{
     ref: z.ZodPipe<z.ZodString, z.ZodTransform<EventSeriesRef, string>>;
     input: z.ZodObject<{
         slug: z.ZodString;
+        path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         title: z.ZodString;
         archetype: z.ZodEnum<{
             custom: "custom";
@@ -514,6 +515,11 @@ export declare const upsertEventSeriesCommandSchema: z.ZodObject<{
         paymentTerms: z.ZodOptional<z.ZodUnknown>;
         presentation: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         tags: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+        blocks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            kind: z.ZodString;
+            content: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>>>>;
         staffRefs: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<StaffRef, string>>>>>;
     }, z.core.$strict>;
 }, z.core.$strict>;
@@ -1366,6 +1372,7 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     ref: z.ZodPipe<z.ZodString, z.ZodTransform<EventSeriesRef, string>>;
     input: z.ZodObject<{
         slug: z.ZodString;
+        path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         title: z.ZodString;
         archetype: z.ZodEnum<{
             custom: "custom";
@@ -1474,6 +1481,11 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         paymentTerms: z.ZodOptional<z.ZodUnknown>;
         presentation: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         tags: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+        blocks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            kind: z.ZodString;
+            content: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>>>>;
         staffRefs: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<StaffRef, string>>>>>;
     }, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
@@ -2241,6 +2253,7 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
         ref: z.ZodPipe<z.ZodString, z.ZodTransform<EventSeriesRef, string>>;
         input: z.ZodObject<{
             slug: z.ZodString;
+            path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             title: z.ZodString;
             archetype: z.ZodEnum<{
                 custom: "custom";
@@ -2349,6 +2362,11 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
             paymentTerms: z.ZodOptional<z.ZodUnknown>;
             presentation: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
             tags: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+            blocks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+                identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                kind: z.ZodString;
+                content: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strict>>>>;
             staffRefs: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<StaffRef, string>>>>>;
         }, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{

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

@@ -0,0 +1,12 @@
+import * as React from "react";
+import { type ThemeResponsiveMode } from "./responsiveMode";
+export type ResponsiveScopeProps = {
+    children: React.ReactNode;
+    responsiveMode?: ThemeResponsiveMode;
+    className?: string;
+};
+/**
+ * Structural responsive root for SDK/runtime chrome that opts out of CMS theme
+ * styling but still depends on scoped rb-* responsive utility classes.
+ */
+export declare function ResponsiveScope({ children, responsiveMode, className, }: ResponsiveScopeProps): React.JSX.Element;

package/dist/_dts/theme-core/src/accordions/types.d.ts

@@ -46,8 +46,8 @@ export declare const accordionSystemSchema: z.ZodObject<{
         elevation: z.ZodEnum<{
             medium: "medium";
             none: "none";
-            low: "low";
             high: "high";
+            low: "low";
         }>;
         softness: z.ZodNullable<z.ZodEnum<{
             soft: "soft";

package/dist/_dts/theme-core/src/buttons/personalities/types.d.ts

@@ -62,8 +62,8 @@ export declare const buttonPersonalitySchema: z.ZodObject<{
             shadow: z.ZodEnum<{
                 medium: "medium";
                 none: "none";
-                low: "low";
                 high: "high";
+                low: "low";
             }>;
             textTransform: z.ZodEnum<{
                 none: "none";
@@ -145,8 +145,8 @@ export declare const buttonPersonalitySchema: z.ZodObject<{
                 elevation: z.ZodEnum<{
                     medium: "medium";
                     none: "none";
-                    low: "low";
                     high: "high";
+                    low: "low";
                 }>;
                 softness: z.ZodNullable<z.ZodEnum<{
                     soft: "soft";

package/dist/_dts/theme-core/src/buttons/types.d.ts

@@ -103,8 +103,8 @@ export declare const cornerStyleSchema: z.ZodEnum<{
 export declare const shadowSizeSchema: z.ZodEnum<{
     medium: "medium";
     none: "none";
-    low: "low";
     high: "high";
+    low: "low";
 }>;
 export declare const textTransformSchema: z.ZodEnum<{
     none: "none";
@@ -239,8 +239,8 @@ export declare const buttonGlobalSettingsSchema: z.ZodObject<{
     shadow: z.ZodEnum<{
         medium: "medium";
         none: "none";
-        low: "low";
         high: "high";
+        low: "low";
     }>;
     textTransform: z.ZodEnum<{
         none: "none";
@@ -390,8 +390,8 @@ export declare const buttonVariantSchema: z.ZodObject<{
         elevation: z.ZodEnum<{
             medium: "medium";
             none: "none";
-            low: "low";
             high: "high";
+            low: "low";
         }>;
         softness: z.ZodNullable<z.ZodEnum<{
             soft: "soft";
@@ -457,8 +457,8 @@ export declare const buttonSystemSchema: z.ZodObject<{
         shadow: z.ZodEnum<{
             medium: "medium";
             none: "none";
-            low: "low";
             high: "high";
+            low: "low";
         }>;
         textTransform: z.ZodEnum<{
             none: "none";
@@ -540,8 +540,8 @@ export declare const buttonSystemSchema: z.ZodObject<{
             elevation: z.ZodEnum<{
                 medium: "medium";
                 none: "none";
-                low: "low";
                 high: "high";
+                low: "low";
             }>;
             softness: z.ZodNullable<z.ZodEnum<{
                 soft: "soft";

package/dist/_dts/theme-core/src/cards/types.d.ts

@@ -189,8 +189,8 @@ export declare const cardVariantSchema: z.ZodObject<{
         elevation: z.ZodEnum<{
             medium: "medium";
             none: "none";
-            low: "low";
             high: "high";
+            low: "low";
         }>;
         softness: z.ZodNullable<z.ZodEnum<{
             soft: "soft";
@@ -297,8 +297,8 @@ export declare const cardSystemSchema: z.ZodObject<{
             elevation: z.ZodEnum<{
                 medium: "medium";
                 none: "none";
-                low: "low";
                 high: "high";
+                low: "low";
             }>;
             softness: z.ZodNullable<z.ZodEnum<{
                 soft: "soft";