@riverbankcms/sdk 0.130.0 → 0.130.2

package/dist/_dts/editor-blocks/src/widgets/button/index.d.ts

@@ -1,6 +1,6 @@
 export { ButtonField } from './ButtonField';
 export type { ButtonValue } from './ButtonField';
-export type { ButtonFieldConfig } from '../../../../block-form/src/client/index';
+export type { ButtonFieldConfig } from '../../../../block-form/src/index';
 export { ButtonWidgetProvider, useButtonWidgetContext } from './context';
 export type { ButtonWidgetContextValue, ButtonVariantOption, ButtonWidgetProviderProps } from './context';
 export { ButtonVariantField } from './ButtonVariantField';

package/dist/_dts/editor-blocks/src/widgets/content-type-select/ContentTypeSelectField.d.ts

@@ -1,4 +1,4 @@
-import type { FieldWidgetProps, ContentTypeSelectFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps, ContentTypeSelectFieldConfig } from '../../../../block-form/src/index';
 /**
  * ContentTypeSelectField - Content type select widget using FieldWidgetProps pattern
  *

package/dist/_dts/editor-blocks/src/widgets/entry-picker/EntryPickerField.d.ts

@@ -1,4 +1,4 @@
-import type { FieldWidgetProps, EntryPickerFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps, EntryPickerFieldConfig } from '../../../../block-form/src/index';
 /**
  * EntryPickerField - Entry picker widget for selecting content entries
  *

package/dist/_dts/editor-blocks/src/widgets/entry-picker/index.d.ts

@@ -2,4 +2,4 @@ export { EntryPickerField } from './EntryPickerField';
 export { EntryPickerWidgetProvider, useEntryPickerWidgetContext } from './EntryPickerWidgetProvider';
 export { getEntryPickerLabelForStoredValue, getEntryPickerOptionValueForStoredValue, } from './utils';
 export type { EntryPickerWidgetAdapter, EntryPickerAdapterArgs, EntryPickerAdapterLabels, EntryPickerItem, EntryPickerItemBadgeVariant, } from './types';
-export type { EntryPickerFieldConfig } from '../../../../block-form/src/client/index';
+export type { EntryPickerFieldConfig } from '../../../../block-form/src/index';

package/dist/_dts/editor-blocks/src/widgets/icon-picker/IconPickerField.d.ts

@@ -1,4 +1,4 @@
-import { type FieldWidgetProps, type TextFieldConfig } from '../../../../block-form/src/client/index';
+import { type FieldWidgetProps, type TextFieldConfig } from '../../../../block-form/src/index';
 type IconPickerValue = unknown;
 export declare function IconPickerField({ path, backend, config }: FieldWidgetProps<IconPickerValue, TextFieldConfig>): import("react").JSX.Element;
 export {};

package/dist/_dts/editor-blocks/src/widgets/inline-text/InlineTextField.d.ts

@@ -1,3 +1,3 @@
-import type { FieldWidgetProps, InlineTextFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps, InlineTextFieldConfig } from '../../../../block-form/src/index';
 import { type InlineText } from '../../../../blocks/src/index';
 export declare function InlineTextField({ path, backend, config, }: FieldWidgetProps<InlineText, InlineTextFieldConfig>): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/link/LinkField.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from 'react';
-import type { FieldWidgetProps } from '../../../../block-form/src/client/index';
-import type { LinkFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps } from '../../../../block-form/src/index';
+import type { LinkFieldConfig } from '../../../../block-form/src/index';
 /**
  * LinkField - Adapter for new widget architecture
  *

package/dist/_dts/editor-blocks/src/widgets/offerings-preview/OfferingsPreviewGroupOrderField.d.ts

@@ -1,2 +1,2 @@
-import { type FieldWidgetProps, type SelectFieldConfig } from '../../../../block-form/src/client/index';
+import { type FieldWidgetProps, type SelectFieldConfig } from '../../../../block-form/src/index';
 export declare function OfferingsPreviewGroupOrderField({ path, backend, config, }: FieldWidgetProps<readonly unknown[] | null, SelectFieldConfig>): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/reference/ReferenceField.d.ts

@@ -1,5 +1,5 @@
-import type { FieldWidgetProps } from '../../../../block-form/src/client/index';
-import type { ReferenceFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps } from '../../../../block-form/src/index';
+import type { ReferenceFieldConfig } from '../../../../block-form/src/index';
 /**
  * ReferenceField - Reference/relation select widget using new FieldWidgetProps pattern
  */

package/dist/_dts/editor-blocks/src/widgets/rich-text/RichTextField.d.ts

@@ -1,5 +1,5 @@
-import type { FieldWidgetProps } from '../../../../block-form/src/client/index';
-import type { RichTextFieldConfig } from '../../../../block-form/src/client/index';
+import type { FieldWidgetProps } from '../../../../block-form/src/index';
+import type { RichTextFieldConfig } from '../../../../block-form/src/index';
 import { type RichTextDoc } from '../../../../blocks/src/system/manifest/richTextSchema';
 type RichTextValue = RichTextDoc;
 export declare function RichTextField({ path, backend, config, }: FieldWidgetProps<RichTextValue, RichTextFieldConfig>): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/site-option-picker/SiteOptionPickerField.d.ts

@@ -1,3 +1,3 @@
-import type { SelectFieldConfig, FieldWidgetProps } from '../../../../block-form/src/client/index';
+import type { SelectFieldConfig, FieldWidgetProps } from '../../../../block-form/src/index';
 import { type SiteOptionValue } from './utils';
 export declare function SiteOptionPickerField({ path, backend, config, }: FieldWidgetProps<SiteOptionValue, SelectFieldConfig>): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/site-option-picker/utils.d.ts

@@ -1,5 +1,5 @@
 import { type SiteOptionSource } from '../../../../blocks/src/index';
-import type { SelectFieldConfig } from '../../../../block-form/src/client/index';
+import type { SelectFieldConfig } from '../../../../block-form/src/index';
 export type SiteOptionValue = string | string[] | null | undefined;
 export declare function normalizeSiteOptionMultiValue(value: SiteOptionValue): string[];
 export declare function getSiteOptionSource(config: SelectFieldConfig): SiteOptionSource | null;

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

@@ -1,5 +1,5 @@
 import { type BlockManifest, type Theme } from '../../../../blocks/src/index';
-import { type FieldConfig, type FormBackend } from '../../../../block-form/src/client/index';
+import { type FieldConfig, type FormBackend } from '../../../../block-form/src/index';
 import type { EditorBlockId } from '../../../../core/src/index';
 import { type SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
 import type { EditorUiState } from '../../../../content-editor/src/index';

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

@@ -3,7 +3,7 @@ import type { ApiClient } from '../../../../api/src/request';
 import { type ContentTypeSchema } from '../../../../content-model/src/index';
 import { type ZoomLevel } from '../../../../content-editor/src/index';
 import type { EntrySubrouteContextData, 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 { type ViewportMode, type ViewportWidth } from './PreviewViewportControls';
 import type { PreviewEditorSidebarProps, PreviewTemplateData } from './PreviewEditorSidebar';

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

@@ -1,7 +1,7 @@
 import React from "react";
 import type { ApiClient } from "../../../../api/src/request";
 import 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";
 type EntrySlotBlockEditorPanelProps = {
     siteId: string;

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

@@ -72,6 +72,8 @@ type PreviewShellCommonProps = {
     mediaAssets?: readonly MediaAssetIndexItem[];
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     supabaseUrl?: string;
+    /** Base URL returned by the content response for site-font storage. */
+    siteFontStorageUrl?: string;
     designEditorEligibility?: PreviewDesignEditorEligibility;
     /** Hides site-style controls when this runtime cannot persist design edits. */
     hideSiteStyleConfigurator?: boolean;

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

@@ -0,0 +1,6 @@
+import { type ReactNode } from 'react';
+export declare function PreviewSiteFontStorageProvider({ siteFontStorageUrl, children, }: Readonly<{
+    siteFontStorageUrl?: string;
+    children: ReactNode;
+}>): import("react").JSX.Element;
+export declare function usePreviewSiteFontStorageUrl(): string | undefined;

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/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/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,7 +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 { CardStylesContent as BlocksCardStylesContent, ContainerStylesContent as BlocksContainerStylesContent, SectionStylesContent as BlocksSectionStylesContent } from '../../../blocks/src/index';
+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';
@@ -20,6 +22,8 @@ export type ImageColSize = '1/4' | '1/3' | '2/5' | '1/2' | '2/3';
 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 = {
@@ -91,6 +95,7 @@ export type CollectionContent = {
         _type: string;
         [key: string]: unknown;
     }>;
+    _cardStyles?: CardStylesContent;
 };
 export type ColumnsContent = {
     equalHeight?: boolean;
@@ -135,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;
@@ -267,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;
@@ -347,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;
@@ -365,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 = {
@@ -490,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/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/rendering/components/Layout.d.ts

@@ -49,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 & {

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

@@ -20,7 +20,7 @@ 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, 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 type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CardStylesContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, ContentFrameIntent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, CardRole, FeatureCardLegacySurfaceRole, FeatureCardSurfaceRole, 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';

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

@@ -244,7 +244,15 @@ export type FormIslandProps = BlocksFormIslandProps;
 export type BookingFormService = BlocksBookingFormService;
 export type BookingFormConfig = BlocksBookingFormConfig;
 export type BookingFormIslandProps = BlocksBookingFormIslandProps;
-export type CardVariant = 'default' | 'variant1' | 'variant2';
+/**
+ * Card surface selection as it reaches an island.
+ *
+ * The canonical vocabulary is the card *role* (`none` / `open` / `default` /
+ * `alternative`); `variant1` / `variant2` are legacy aliases of `alternative`
+ * that persisted content still carries. Both keep parsing — the union is
+ * widened additively so no existing SDK consumer breaks.
+ */
+export type CardVariant = 'default' | 'alternative' | 'open' | 'none' | 'variant1' | 'variant2';
 export type ButtonVariant = SystemButtonVariant;
 export type EventListingLayout = EventLayout;
 export type CardOrientation = 'vertical' | 'horizontal';

package/dist/_dts/sdk/src/theme-bridge/types.d.ts

@@ -44,10 +44,12 @@ export interface ThemeBridgeButtonConfig {
  */
 export interface ThemeBridgeCardConfig {
     /**
-     * Which card variants to generate.
+     * Which card variants to generate — one id per card role the theme
+     * implements. `elevated` and `outlined` are the pre-role names of
+     * `alternative` and `open`, kept so existing configs keep working.
      * @default ['default']
      */
-    variants?: Array<'default' | 'elevated' | 'outlined'>;
+    variants?: Array<'default' | 'alternative' | 'open' | 'elevated' | 'outlined'>;
 }
 /**
  * Component CSS generation options.

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

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

@@ -4,6 +4,7 @@
  * Pure functions for generating card CSS without requiring the full Theme type.
  * Used by both the full CMS theme system and the SDK theme bridge.
  */
+import type { CardEdgeRule } from './types';
 export type CardBackgroundType = 'solid' | 'transparent' | 'gradient';
 export type CardSpacingCore = 'none' | 'compact' | 'cozy' | 'medium' | 'comfortable' | 'spacious';
 export type CardCornerValueCore = 'square' | 'soft' | 'rounded' | 'pill' | 'expressive';
@@ -15,14 +16,20 @@ export interface CardCornerRadiiCore {
     bottomLeft?: CardCornerValueCore;
     bottomRight?: CardCornerValueCore;
 }
-export interface CardAccentEdgeCore {
-    edge: CardEdgeCore;
-    colorToken: string;
-    width: CardEdgeWidthCore;
-}
 export interface CardVariantCore {
-    /** Unique variant identifier (e.g., 'default', 'elevated') */
+    /** Unique variant identifier (e.g., 'default', 'alternative') */
     id: string;
+    /**
+     * Which card role this variant implements. Generated CSS addresses the
+     * variant by its stable `.card-role-*` alias as well as its id, so content
+     * compiled against the role contract renders on a bridge theme too.
+     */
+    role?: CardRoleCore;
+    /**
+     * Ids this variant used to ship under. They keep emitting their `.card-{id}`
+     * class so SDK sites that address an older variant name keep their surface.
+     */
+    legacyIds?: readonly string[];
     /** Background style */
     background: CardBackgroundType;
     /** Background color token for solid backgrounds */
@@ -41,10 +48,17 @@ export interface CardVariantCore {
     borderToken?: string;
     /** Border width */
     borderWidth?: 'none' | 'thin' | 'medium' | 'thick';
-    /** Single accent edge; replaces the full border when set */
-    accentEdge?: CardAccentEdgeCore;
+    /** Edge rules drawn on the card; coexists with the border */
+    decorations?: CardEdgeRule[];
     /** Per-corner radius override; wins over the global corners setting */
     cornerRadii?: CardCornerRadiiCore;
+    /**
+     * Opts a variant out of the theme's global card shadow. A boxless card has
+     * no box to cast one, so `open` sets it; every other variant inherits the
+     * setting as before. Named for what it does rather than mirroring
+     * `CardVariant.shadow`, which is an object describing a shadow.
+     */
+    suppressShadow?: true;
 }
 export interface CardCoreSettings {
     /** Corner radius style */
@@ -65,8 +79,38 @@ export interface CardCoreSettings {
  * @param settings - Global card settings
  * @returns CSS string
  */
-export declare function generateCardCoreCss(scopeId: string, variants: CardVariantCore[], settings: CardCoreSettings): string;
+export declare function generateCardCoreCss(scopeId: string, variants: CardVariantCore[], settings: CardCoreSettings, scope?: CardClassScope): string;
+/** The roles a bridge card variant can implement. `none` is never a variant. */
+export type CardRoleCore = 'default' | 'alternative' | 'open';
+/**
+ * Which half of a variant's class list to address.
+ *
+ * The split exists because the two halves have different lifecycles on a
+ * bridge theme. `.card-role-*` is the *contract*: compiled content names a
+ * role and expects a surface, so the aliases are emitted unconditionally.
+ * `.card-{id}` and its legacy ids are the *catalogue*: an SDK consumer opts
+ * into those by name through `components.cards`.
+ */
+export type CardClassScope = 'all' | 'role-aliases' | 'named';
+/** Every class a variant's rule is addressed by, within a scope. */
+export declare function cardVariantClasses(variant: CardVariantCore, scope?: CardClassScope): string[];
 /**
- * Get default card variants for SDK usage.
+ * The default card variants for SDK/bridge themes — one per surface-backed
+ * role, so a bridge theme implements the same card contract a site style does
+ * and compiled `_cardStyles.role` renders on it.
+ *
+ * Two of the pre-role trio survive as legacy ids: `.card-elevated` is the
+ * `alternative` card under its old name, and both were the same surface before
+ * the rename. `outlined` is different — a fully bordered box is not what the
+ * `open` role means (boxless but marked), so it keeps its own variant and its
+ * own declarations as a *compatibility class only*. It carries no role, which
+ * means:
+ *
+ * - `.card-outlined` renders exactly what it always did;
+ * - `role: 'open'` renders the boxless marked card on a bridge theme, the same
+ *   thing it renders under a site style;
+ * - naming `outlined` in `components.cards.variants` enables the compatibility
+ *   class and nothing else — it does not publish `.card-role-open`, because
+ *   selecting a legacy name is not a claim on a semantic role.
  */
 export declare function getDefaultCardVariants(): CardVariantCore[];

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

@@ -0,0 +1,33 @@
+import type { CardEdgeRule, CardEdgeRuleWidth } from './types';
+/**
+ * Card decoration CSS — the single implementation shared by the Theme-driven
+ * generator (`generateCardCss`) and the dependency-free core generator
+ * (`core.ts`). Both used to carry their own accent-edge emitter; they now
+ * differ only in how a colour token resolves to a CSS colour.
+ */
+/** Resolves a palette token name to a CSS colour value. */
+export type CardColorResolver = (token: string) => string;
+export declare const CARD_EDGE_RULE_WIDTH_MAP: Record<CardEdgeRuleWidth, string>;
+/**
+ * The one short-rule length in the corpus (the editorial-rule accent). A fixed
+ * constant keeps `length: 'short'` a semantic choice rather than a free number.
+ */
+export declare const SHORT_CARD_EDGE_RULE_LENGTH = "2.75rem";
+/** Apply a decoration's optional alpha to its resolved colour. */
+export declare function cardDecorationColor(rule: CardEdgeRule, resolveColor: CardColorResolver): string;
+/**
+ * Container border declarations for a variant's border and its full-length
+ * edge rules. The two are independent: a card may be outlined *and* carry an
+ * accent edge. A variant with edge rules and no border still zeroes the box so
+ * only the decorated sides draw.
+ */
+export declare function cardBorderDeclarations(borderDeclaration: string | null, decorations: readonly CardEdgeRule[] | undefined, resolveColor: CardColorResolver): string[];
+/**
+ * Complete pseudo-element rules for a variant's short edge rules.
+ *
+ * `cardDecorationsSchema` caps the list at two, which makes the two pseudos
+ * sufficient for anything that parsed. The dependency-free core types carry a
+ * plain array with no such cap, so short rules past the second are dropped
+ * here rather than silently overwriting `::after`.
+ */
+export declare function cardDecorationPseudoRules(containerSelectors: readonly string[], decorations: readonly CardEdgeRule[] | undefined, resolveColor: CardColorResolver): string[];