@riverbankcms/sdk 0.129.1 → 0.130.2

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

@@ -0,0 +1,53 @@
+import { type CuratedSiteStyle } from '../../../../theme-core/src/site-styles/previewCompiler';
+import { type FooterLookId, type HeaderLayoutId, type HeaderLogoContext, type HeaderStyleId, type FooterLookCustomizationWritePlan } from '../../../../theme-core/src/site-styles/index';
+import type { SelectionSnapshot, StyleConfiguratorState } from './StyleConfigurator.state';
+export type SiteChromeSelectionOption<TId extends string | null> = Readonly<{
+    id: TId;
+    label: string;
+    description?: string;
+}>;
+export type SiteChromeSelectionCatalogOption<TId extends string> = Readonly<{
+    id: TId;
+    label: string;
+}>;
+export type SiteChromeFooterSelectionRowModel<TId extends string> = Readonly<{
+    options: readonly SiteChromeSelectionOption<TId | null>[];
+    diagnostics: readonly string[];
+    renderedLookId: TId;
+}>;
+export type SiteChromeSelectionModels = Readonly<{
+    headerLayout: Readonly<{
+        options: readonly SiteChromeSelectionOption<HeaderLayoutId>[];
+        renderedLayoutId: HeaderLayoutId;
+    }>;
+    headerStyle: Readonly<{
+        options: readonly SiteChromeSelectionOption<HeaderStyleId>[];
+        renderedStyleId: HeaderStyleId;
+    }>;
+    footer: SiteChromeFooterSelectionRowModel<FooterLookId>;
+}>;
+type SiteChromeSelectionModelInput = Readonly<{
+    state: StyleConfiguratorState;
+    siteStyle: CuratedSiteStyle;
+    headerLogoContext?: HeaderLogoContext;
+}>;
+export declare function buildSiteChromeSelectionModels(input: SiteChromeSelectionModelInput): SiteChromeSelectionModels;
+export declare function cycleSiteChromeSelectionId<TId extends string>(options: readonly SiteChromeSelectionOption<TId | null>[], currentId: TId | null, direction: 'prev' | 'next'): TId | null | undefined;
+export type SiteChromeSelectionCommand = Readonly<{
+    surface: 'header';
+    layoutId: HeaderLayoutId;
+    styleId: HeaderStyleId;
+}> | Readonly<{
+    surface: 'footer';
+    lookId: FooterLookId | null;
+}>;
+export type SiteChromeSelectionPlan = Readonly<{
+    kind: 'header';
+    next: Pick<SelectionSnapshot, 'headerLayoutId' | 'headerStyleId'>;
+}> | Readonly<{
+    kind: 'footer';
+    writePlan: FooterLookCustomizationWritePlan<FooterLookId>;
+    next: Pick<SelectionSnapshot, 'footerLookId'>;
+}>;
+export declare function planSiteChromeSelection(command: SiteChromeSelectionCommand): SiteChromeSelectionPlan;
+export {};

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

@@ -0,0 +1,5 @@
+import type { SiteFontRecord } from './typographyFontCatalog';
+export declare function buildSiteFontFaceCss(siteFonts: readonly SiteFontRecord[], siteFontStorageUrl?: string): string;
+export declare function SiteFontFaceStyles({ siteFonts, }: Readonly<{
+    siteFonts: readonly SiteFontRecord[];
+}>): import("react").JSX.Element | null;

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

@@ -1,16 +1,11 @@
 import type { PreviewRuntimeSession } from "../../auth-contract";
 export type SiteStyleAccess = Readonly<{
     kind: "hidden";
-}> | Readonly<{
-    kind: "preview-only";
 }> | Readonly<{
     kind: "apply-allowed";
 }>;
 export type VisibleSiteStyleAccess = Extract<SiteStyleAccess, Readonly<{
-    kind: "preview-only" | "apply-allowed";
+    kind: "apply-allowed";
 }>>;
 export declare function resolveSiteStyleAccess(session: PreviewRuntimeSession | null): SiteStyleAccess;
 export declare function canInspectSiteStyle(access: SiteStyleAccess): access is VisibleSiteStyleAccess;
-export declare function canApplySiteStyle(access: VisibleSiteStyleAccess): access is Extract<VisibleSiteStyleAccess, Readonly<{
-    kind: "apply-allowed";
-}>>;

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/preview-next/src/client/sdk/contentStorage.d.ts

@@ -0,0 +1,10 @@
+type PreviewContentStorageSource = Readonly<{
+    supabaseUrl?: unknown;
+}>;
+/**
+ * Reads the current content storage endpoint from the legacy content wire
+ * shape. Keep the provider-specific field in this adapter so preview
+ * rendering only depends on the neutral storage URL it receives.
+ */
+export declare function resolveContentStorageUrl(content: PreviewContentStorageSource): string | undefined;
+export {};

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

@@ -1,7 +1,7 @@
 import { type ReactNode } from 'react';
 import type { ApiClient } from '../../../../api/src/request';
 import { type BookingOfferingPresetSummary, type Theme } from '../../../../blocks/src/index';
-import type { FieldWidgetComponent } from '../../../../block-form/src/client/index';
+import type { FieldWidgetComponent } from '../../../../block-form/src/index';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
 import { __testUtils, createPreviewEntryPickerAdapter, createPreviewLinkAdapters, createPreviewReferenceAdapters, createPreviewSiteOptionAdapters } from './widgetAdapters';
 /**

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

@@ -3,3 +3,4 @@ export * from "./cookies";
 export * from "./redirects";
 export * from "./auth-contract";
 export * from "./route-contract";
+export * from "./refresh-contract";

package/dist/_dts/preview-next/src/keepAlive.d.ts

@@ -1,17 +1,15 @@
 import type { CookieStoreLike } from './session';
-type PreviewKeepAliveLogger = {
+export type PreviewKeepAliveLogger = {
     debug?: (message: string, meta?: Record<string, unknown>) => void;
     warn?: (message: string, meta?: Record<string, unknown>) => void;
     error?: (message: string, meta?: Record<string, unknown>) => void;
 };
-type CreatePreviewKeepAliveRouteHandlerOptions = {
+export type CreatePreviewKeepAliveRouteHandlerOptions = {
     maxAge?: number;
     refreshThresholdSeconds?: number;
     logger?: PreviewKeepAliveLogger;
-    supabaseUrl?: string;
-    supabaseAnonKey?: string;
+    dashboardUrl?: string | null;
     getCookies?: () => Promise<CookieStoreLike>;
     fetcher?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
 };
 export declare function createPreviewKeepAliveRouteHandler(options?: CreatePreviewKeepAliveRouteHandlerOptions): (request: Request) => Promise<Response>;
-export {};

package/dist/_dts/preview-next/src/refresh-contract.d.ts

@@ -0,0 +1 @@
+export { parsePreviewRefreshResponse, previewRefreshRequestSchema, previewRefreshResponseSchema, type PreviewRefreshParseError, type PreviewRefreshRequest, type PreviewRefreshResponse, } from '../../api/src/preview-auth';

package/dist/_dts/preview-next/src/route-contract.d.ts

@@ -7,6 +7,9 @@ export declare const previewDashboardApiEndpoints: {
     readonly previewAuthExchange: {
         readonly path: "/api/preview/auth/exchange";
     };
+    readonly previewAuthRefresh: {
+        readonly path: "/api/preview/auth/refresh";
+    };
     readonly onboardingPreviewStatus: {
         readonly path: "/api/public/sites/{siteId}/onboarding/preview-status";
     };
@@ -26,6 +29,9 @@ export type PreviewAuthEntryUrlInput = Readonly<{
 export type PreviewAuthExchangeUrlInput = Readonly<{
     dashboardBaseUrl: string;
 }>;
+export type PreviewAuthRefreshUrlInput = Readonly<{
+    dashboardBaseUrl: string;
+}>;
 export type OnboardingPreviewEndpointUrlInput = Readonly<{
     dashboardBaseUrl: string;
     siteId: string;
@@ -33,5 +39,6 @@ export type OnboardingPreviewEndpointUrlInput = Readonly<{
 export declare const previewAuthEntryPathname: "/preview/auth";
 export declare function buildPreviewAuthEntryUrl(input: PreviewAuthEntryUrlInput): string;
 export declare function buildPreviewAuthExchangeUrl(input: PreviewAuthExchangeUrlInput): string;
+export declare function buildPreviewAuthRefreshUrl(input: PreviewAuthRefreshUrlInput): string;
 export declare function buildOnboardingPreviewStatusUrl(input: OnboardingPreviewEndpointUrlInput): string;
 export declare function buildOnboardingResendConfirmationUrl(input: OnboardingPreviewEndpointUrlInput): string;

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/index.d.ts

@@ -1,5 +1,5 @@
 export type { TipTapNode, TipTapMark, RichTextDoc, InlineText, InlineTextAccentTone, InlineTextHighlightTone, InlineTextMark, InlineTextRun, Media, LinkValue, InternalRouteOnlyLinkValue, InternalResolvedLinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, } from './content';
-export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, ProductDetailContent, ProductListContent, RecurringScheduleContent, SectionStylesContent, SemanticIconId, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, BlockIconValue, FeatureCardIconTreatment, } from './system-block-content';
+export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardRole, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, ContentFrameIntent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FeatureCardLegacySurfaceRole, FeatureCardSurfaceRole, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, ProductDetailContent, ProductListContent, RecurringScheduleContent, SectionStylesContent, SemanticIconId, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, BlockIconValue, FeatureCardIconTreatment, } from './system-block-content';
 export type { PageOutline, PageRuntimeBoundary, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, } from './page';
 export type { Theme, ThemeTokens } from './theme';
 export type { CustomCssDeclarationsInput, CustomCssRuleInput, CustomCssNestedRuleInput, CustomCssAtRuleInput, KeyframesAtRuleInput, FontFaceAtRuleInput, MediaAtRuleInput, SupportsAtRuleInput, RawAtRuleInput, } from './custom-css';

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

@@ -9,6 +9,9 @@ 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 { EventCalendarContent as BlocksEventCalendarContent } from '../../../blocks/src/system/blocks/events/event-calendar';
+import type { CalendarTabViews as BlocksCalendarTabViews, CalendarView as BlocksCalendarView, ColumnOption as BlocksColumnOption, DisplayMode as BlocksDisplayMode, EventLayout as BlocksEventLayout, FilterAutoShow as BlocksFilterAutoShow, WeekStart as BlocksWeekStart } from '../../../blocks/src/system/blocks/events/shared/types';
+import type { CardStylesContent as BlocksCardStylesContent, ContainerStylesContent as BlocksContainerStylesContent, ContentFrameIntent as BlocksContentFrameIntent, SectionStylesContent as BlocksSectionStylesContent } from '../../../blocks/src/index';
 type UnknownRecord = Record<string, unknown>;
 type ImageMedia = Omit<Media, 'type'> & {
     type: 'image';
@@ -16,47 +19,11 @@ 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;
+/** The compiled frame a Look asks for around a block's content. */
+export type ContentFrameIntent = BlocksContentFrameIntent;
 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 = {
@@ -128,6 +95,7 @@ export type CollectionContent = {
         _type: string;
         [key: string]: unknown;
     }>;
+    _cardStyles?: CardStylesContent;
 };
 export type ColumnsContent = {
     equalHeight?: boolean;
@@ -172,48 +140,36 @@ export type EmbedContent = {
     layout?: string | null;
     emptyMessage?: string | null;
 };
-export type EventLayout = 'grid' | 'stack' | 'compact';
-export type ColumnOption = '2' | '3' | '4';
-export type WeekStart = 'sunday' | 'monday';
-export type DisplayMode = 'combined' | 'calendar' | 'list' | 'timetable' | 'week-board';
-export type FilterAutoShow = 'auto' | 'always' | 'never';
-export type CalendarTabViews = 'both' | 'month' | 'week';
-export type CalendarView = 'month' | 'week';
+/**
+ * The calendar's own vocabularies, aliased rather than restated. They are the
+ * event blocks' types; a hand-kept copy of a closed union is exactly what let
+ * the calendar contract drift in the first place.
+ */
+export type EventLayout = BlocksEventLayout;
+export type ColumnOption = BlocksColumnOption;
+export type WeekStart = BlocksWeekStart;
+export type DisplayMode = BlocksDisplayMode;
+export type FilterAutoShow = BlocksFilterAutoShow;
+export type CalendarTabViews = BlocksCalendarTabViews;
+export type CalendarView = BlocksCalendarView;
 export type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost' | 'accent';
+/**
+ * The canonical card-role vocabulary. A site style owns the implementation of
+ * each role; content names the role.
+ */
+export type CardRole = 'none' | 'open' | 'default' | 'alternative';
 export type CardVariantRole = 'default' | 'alternative';
-export type LegacyCardVariantRoleAlias = 'variant1' | 'variant2';
+export type LegacyCardVariantRoleAlias = 'variant1' | 'variant2' | 'statement';
 export type EventCardVariantInput = CardVariantRole | LegacyCardVariantRoleAlias;
-export type EventSurfacePreset = 'course' | 'class' | 'workshop' | 'retreat' | 'performance';
+export type EventSurfacePreset = 'course' | 'term' | 'class' | 'workshop' | 'retreat' | 'performance';
 export type EventSurfaceScope = 'all' | 'regularClassSchedule' | 'specialDatedEvents' | 'custom';
 export type EventScheduleScope = 'any' | 'recurring' | 'oneOff';
-export type EventCalendarContent = {
-    heading?: string | null;
-    description?: unknown;
-    displayMode?: DisplayMode | null;
-    listLayout?: EventLayout | null;
-    listColumns?: ColumnOption | null;
-    layout?: EventLayout | null;
-    columns?: ColumnOption | null;
-    eventsPerPage?: '6' | '10' | '12' | '20' | '24' | '30' | null;
-    loadMoreText?: string | null;
-    startOfWeek?: WeekStart | null;
-    calendarTabViews?: CalendarTabViews | null;
-    defaultCalendarView?: CalendarView | null;
-    showFilters?: boolean | null;
-    showCategoryFilter?: FilterAutoShow | null;
-    showVenueFilter?: boolean | null;
-    showStaffFilter?: boolean | null;
-    eventSurface?: EventSurfaceScope | null;
-    filterEventPresets?: readonly EventSurfacePreset[] | null;
-    scheduleScope?: EventScheduleScope | null;
-    filterCategoryIds?: readonly EventCategoryId[] | null;
-    filterStaffMemberId?: string | null;
-    filterVenueId?: VenueId | null;
-    buttonVariant?: ButtonVariant | null;
-    buttonText?: string | null;
-    emptyMessage?: string | null;
-    _sectionStyles?: SectionStylesContent;
-};
+/**
+ * Aliased from the blocks package rather than restated. The calendar's content
+ * is large, and a hand-kept copy drifts silently — the SDK copy was missing
+ * eight fields before this. `SiteFooterContent` is aliased for the same reason.
+ */
+export type EventCalendarContent = BlocksEventCalendarContent;
 export type EventDetailsContent = {
     heading?: string | null;
     showVenue?: boolean | null;
@@ -304,8 +260,28 @@ export type FaqContent = {
     items?: FaqItem[] | null;
     _containerStyles?: ContainerStylesContent;
 };
+/**
+ * This block's historical per-item surface values. They are aliases of card
+ * roles now, and stay parseable forever — persisted content carries them.
+ */
+export type FeatureCardLegacySurfaceRole = 'open' | 'panel';
+/**
+ * A feature card's own surface choice: the canonical card-role vocabulary
+ * *minus* `open`, plus this block's two historical values.
+ *
+ * `panel` is a legacy alias of the `alternative` role. `open` is the one worth
+ * knowing about: on this block it predates the role vocabulary and keeps its
+ * old meaning — an unmarked boxless card, which is role `none` — so it is
+ * excluded from the canonical half and supplied only by the legacy half.
+ *
+ * The consequence is permanent and deliberate: **the canonical `open` role is
+ * not addressable per item on a feature card.** The alias always wins. A card
+ * that should render the marked, boxless `open` role gets it from the block's
+ * card role, not from `surfaceRole`.
+ */
+export type FeatureCardSurfaceRole = Exclude<CardRole, 'open'> | FeatureCardLegacySurfaceRole;
 export type FeatureCard = {
-    surfaceRole?: 'open' | 'panel' | null;
+    surfaceRole?: FeatureCardSurfaceRole | null;
     media?: Media | null;
     aspectRatio?: StandardAspectRatio | null;
     icon?: BlockIconValue | SemanticIconId | null;
@@ -384,6 +360,7 @@ export type MediaTextImagePosition = 'left' | 'right';
 export type MediaTextAspectRatio = 'auto' | '16/9' | '4/3' | '1/1' | '3/4' | '9/16';
 export type MediaTextImageShape = 'default' | 'square' | 'rounded' | 'circle' | 'arch';
 export type MediaTextContent = {
+    eyebrow?: string | null;
     title?: string | null;
     titleAlignment?: MediaTextAlignment | null;
     imagePosition?: MediaTextImagePosition | null;
@@ -402,6 +379,13 @@ export type MediaTextContent = {
     text: RichTextDoc;
     wrapTextInCard?: boolean | null;
     _textCardStyles?: unknown;
+    /**
+     * Compiler-owned. Its card role rides into the author's text card, so this
+     * block has no card control of its own.
+     */
+    _cardStyles?: CardStylesContent;
+    /** Compiler-owned: the frame a Look asks for around the block's content. */
+    _frameStyles?: ContentFrameIntent | null;
 };
 export type NewsletterSignupPreset = 'emailOnly' | 'emailName' | 'emailFirstLast' | 'emailNameCompany';
 export type NewsletterSignupContent = {
@@ -527,6 +511,7 @@ type TeamMembersCommonContent = {
     stackContentAlignment?: StackContentAlignment | null;
     columns?: string | number | null;
     gap?: SemanticSpacing;
+    _cardStyles?: CardStylesContent;
 };
 export type TeamMembersContent = (TeamMembersCommonContent & {
     source?: 'manual' | null;

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/preview-next/keep-alive.d.ts

@@ -1 +1 @@
-export { createPreviewKeepAliveRouteHandler } from '@riverbankcms/preview-next/keep-alive';
+export { createPreviewKeepAliveRouteHandler, type CreatePreviewKeepAliveRouteHandlerOptions, type PreviewKeepAliveLogger, } from '@riverbankcms/preview-next/keep-alive';

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;
@@ -48,7 +49,7 @@ type ThemedLayoutProps = LayoutCommonProps & {
     rendering?: never;
     header?: boolean | ((data: HeaderData) => React.ReactNode);
     footer?: boolean | ((data: FooterData) => React.ReactNode);
-    headerVariant?: 'classic' | 'centered' | 'transparent' | 'floating';
+    headerVariant?: 'classic' | 'centered' | 'floating';
     themeRuntime?: SdkThemeRuntime;
 };
 type OverrideOnlyLayoutProps = LayoutCommonProps & {