@riverbankcms/sdk 0.60.0 → 0.60.3

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

@@ -0,0 +1,41 @@
+import { type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type PageDesignEditorReadModel } from '@riverbankcms/theme-core/site-styles';
+import { type HistoryState } from '@riverbankcms/content-editor';
+import type { PreviewCustomizeAction } from '../blocks/previewCustomizeActions';
+type PreviewLoadedEditorModel = PageDesignEditorReadModel;
+export type PreviewCustomizeHistoryEntry = Readonly<{
+    kind: 'layout';
+    blockId: PreviewCustomizeActionBlockId;
+    baseContentId: string | null;
+    fromLayoutVariantKey: LayoutVariantKey;
+    toLayoutVariantKey: LayoutVariantKey;
+}> | Readonly<{
+    kind: 'look';
+    blockId: PreviewCustomizeActionBlockId;
+    fromAppearancePresetId: AppearancePresetId | null;
+    toAppearancePresetId: AppearancePresetId | null;
+}> | Readonly<{
+    kind: 'boundary';
+    boundaryId: DesignBoundaryId;
+    previousBlockId: PreviewCustomizeActionBlockId;
+    nextBlockId: PreviewCustomizeActionBlockId;
+    fromBoundaryOptionId: BoundaryOptionId | null;
+    toBoundaryOptionId: BoundaryOptionId | null;
+}>;
+type PreviewCustomizeActionBlockId = DesignBlockId;
+export type PreviewCustomizeHistoryPresent = Readonly<{
+    editorModel: PreviewLoadedEditorModel;
+    entry: PreviewCustomizeHistoryEntry | null;
+}>;
+export type PreviewCustomizeHistoryState = HistoryState<PreviewCustomizeHistoryPresent>;
+export declare function createPreviewCustomizeHistoryState(editorModel: PreviewLoadedEditorModel): PreviewCustomizeHistoryState;
+export declare function canUndoPreviewCustomizeHistory(state: PreviewCustomizeHistoryState): boolean;
+export declare function canRedoPreviewCustomizeHistory(state: PreviewCustomizeHistoryState): boolean;
+export declare function pushPreviewCustomizeHistoryEntry(state: PreviewCustomizeHistoryState, entry: PreviewCustomizeHistoryEntry, editorModel: PreviewLoadedEditorModel): PreviewCustomizeHistoryState;
+export declare function replacePreviewCustomizeHistoryModel(state: PreviewCustomizeHistoryState, editorModel: PreviewLoadedEditorModel): PreviewCustomizeHistoryState;
+export declare function undoPreviewCustomizeHistory(state: PreviewCustomizeHistoryState): PreviewCustomizeHistoryState;
+export declare function redoPreviewCustomizeHistory(state: PreviewCustomizeHistoryState): PreviewCustomizeHistoryState;
+export declare function previewCustomizeHistoryEntryFromAction(editorModel: PreviewLoadedEditorModel, action: PreviewCustomizeAction): PreviewCustomizeHistoryEntry | null;
+export declare function previewCustomizeUndoActionForEntry(entry: PreviewCustomizeHistoryEntry): PreviewCustomizeAction;
+export declare function previewCustomizeRedoActionForEntry(entry: PreviewCustomizeHistoryEntry): PreviewCustomizeAction;
+export declare function previewCustomizeHistoryPresentEquals(left: PreviewCustomizeHistoryPresent, right: PreviewCustomizeHistoryPresent): boolean;
+export {};

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

@@ -0,0 +1,15 @@
+import { type PageDesignEditorReadModel } from '@riverbankcms/theme-core/site-styles/previewCompiler';
+import type { DesignBlockId } from '@riverbankcms/theme-core/site-styles';
+import type { PreviewCustomizeAction } from '../blocks/previewCustomizeActions';
+export type PreviewEditorRuntimeContent = Record<string, unknown>;
+export type PreviewCustomizeRuntimePatch = Readonly<{
+    blockId: DesignBlockId;
+    previousContent: PreviewEditorRuntimeContent;
+    nextContent: PreviewEditorRuntimeContent;
+    rollback: (currentContent: PreviewEditorRuntimeContent) => PreviewEditorRuntimeContent;
+}>;
+export declare function derivePreviewCustomizeRuntimePatch(input: Readonly<{
+    action: PreviewCustomizeAction;
+    editorModel: PageDesignEditorReadModel;
+    currentContent: PreviewEditorRuntimeContent | null;
+}>): PreviewCustomizeRuntimePatch | null;

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

@@ -0,0 +1,106 @@
+import type { APIEndpoints } from '@riverbankcms/api';
+import type { PreviewCustomizeAction } from '../blocks/previewCustomizeActions';
+import { type PreviewCustomizeHistoryEntry, type PreviewCustomizeHistoryState } from './previewCustomizeHistory';
+type ApiPageDesignEditorStateResponse = NonNullable<APIEndpoints['getPageDesignEditorState']['response']>;
+type LoadedPageDesignEditorState = Extract<ApiPageDesignEditorStateResponse, Readonly<{
+    kind: 'loaded';
+}>>;
+type NonLoadedPageDesignEditorState = Exclude<ApiPageDesignEditorStateResponse, Readonly<{
+    kind: 'loaded';
+}>>;
+type ApplyPageDesignEditorActionResponse = NonNullable<APIEndpoints['applyPageDesignEditorAction']['response']>;
+export type PreviewPageDesignEditorState = Readonly<{
+    kind: 'unsupported';
+}> | Readonly<{
+    kind: 'loading';
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}> | ApiPageDesignEditorStateResponse;
+export type PreviewPageDesignEditorApplyOutcome = Readonly<{
+    kind: 'saved';
+    response: ApplyPageDesignEditorActionResponse;
+}> | Readonly<{
+    kind: 'skipped';
+    reason: PreviewCustomizeSkipReason;
+    message: string;
+}> | Readonly<{
+    kind: 'stale';
+    message: string;
+}> | Readonly<{
+    kind: 'invalid';
+    message: string;
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}>;
+export type PreviewCustomizeSkipReason = 'disabled' | 'missing-page' | 'not-loaded' | 'mutation-pending' | 'stale' | 'no-history-entry' | 'cannot-undo' | 'cannot-redo';
+export type PreviewCustomizeMutationState = Readonly<{
+    kind: 'idle';
+}> | Readonly<{
+    kind: 'applying';
+    action: PreviewCustomizeAction;
+    historyEntry: PreviewCustomizeHistoryEntry | null;
+}> | Readonly<{
+    kind: 'undoing';
+    action: PreviewCustomizeAction;
+    entry: PreviewCustomizeHistoryEntry;
+}> | Readonly<{
+    kind: 'redoing';
+    action: PreviewCustomizeAction;
+    entry: PreviewCustomizeHistoryEntry;
+}> | Readonly<{
+    kind: 'stale';
+    message: string;
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}>;
+export type PreviewCustomizeWorkflowState = Readonly<{
+    kind: 'unsupported';
+}> | Readonly<{
+    kind: 'loading';
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}> | Readonly<{
+    kind: 'ready';
+    pageState: NonLoadedPageDesignEditorState;
+}> | Readonly<{
+    kind: 'loaded';
+    pageState: LoadedPageDesignEditorState;
+    history: PreviewCustomizeHistoryState;
+    mutation: PreviewCustomizeMutationState;
+}>;
+export type PreviewCustomizeBeginResult = Readonly<{
+    kind: 'started';
+    state: PreviewCustomizeWorkflowState;
+    action: PreviewCustomizeAction;
+}> | Readonly<{
+    kind: 'skipped';
+    reason: PreviewCustomizeSkipReason;
+    message: string;
+}>;
+export declare function unsupportedPreviewCustomizeWorkflowState(): PreviewCustomizeWorkflowState;
+export declare function loadingPreviewCustomizeWorkflowState(): PreviewCustomizeWorkflowState;
+export declare function failedPreviewCustomizeWorkflowState(message: string): PreviewCustomizeWorkflowState;
+export declare function previewCustomizeLoadSucceeded(pageState: ApiPageDesignEditorStateResponse): PreviewCustomizeWorkflowState;
+export declare function previewCustomizeWorkflowPageState(workflow: PreviewCustomizeWorkflowState): PreviewPageDesignEditorState;
+export declare function beginPreviewCustomizeApply(workflow: PreviewCustomizeWorkflowState, action: PreviewCustomizeAction): PreviewCustomizeBeginResult;
+export declare function beginPreviewCustomizeUndo(workflow: PreviewCustomizeWorkflowState): PreviewCustomizeBeginResult;
+export declare function beginPreviewCustomizeRedo(workflow: PreviewCustomizeWorkflowState): PreviewCustomizeBeginResult;
+export declare function confirmPreviewCustomizeMutation(workflow: PreviewCustomizeWorkflowState, response: ApplyPageDesignEditorActionResponse): PreviewCustomizeWorkflowState;
+export declare function rejectPreviewCustomizeMutation(previousWorkflow: PreviewCustomizeWorkflowState, outcome: Exclude<PreviewPageDesignEditorApplyOutcome, {
+    kind: 'saved' | 'skipped';
+}>): PreviewCustomizeWorkflowState;
+export declare function previewCustomizeCanUndo(workflow: PreviewCustomizeWorkflowState): boolean;
+export declare function previewCustomizeCanRedo(workflow: PreviewCustomizeWorkflowState): boolean;
+export declare function previewCustomizeCanApply(workflow: PreviewCustomizeWorkflowState): boolean;
+export declare function previewCustomizeIsMutationPending(workflow: PreviewCustomizeWorkflowState): boolean;
+export declare function previewCustomizeIsStale(workflow: PreviewCustomizeWorkflowState): boolean;
+export declare function previewCustomizeFailureMessage(workflow: PreviewCustomizeWorkflowState): string | null;
+export declare function applyPreviewCustomizeActionToState(state: PreviewPageDesignEditorState, action: PreviewCustomizeAction): PreviewPageDesignEditorState;
+export declare function skippedPreviewCustomizeOutcome(reason: PreviewCustomizeSkipReason): Extract<PreviewPageDesignEditorApplyOutcome, {
+    kind: 'skipped';
+}>;
+export {};

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

@@ -0,0 +1,34 @@
+export type PreviewUndoDomainId = 'content' | 'theme-customize';
+export type PreviewUndoDomainStatus = 'idle' | 'pending' | 'stale' | 'failed';
+export type PreviewUndoFocusOwner = 'preview-customize' | 'content' | 'native';
+export type PreviewUndoDomainOwnership = Readonly<{
+    kind: 'focused';
+    owner: PreviewUndoFocusOwner;
+}> | Readonly<{
+    kind: 'available';
+}> | Readonly<{
+    kind: 'fallback';
+}>;
+export type PreviewUndoSelectionContext = Readonly<{
+    kind: 'chrome';
+}> | Readonly<{
+    kind: 'shortcut';
+    owner: PreviewUndoFocusOwner;
+}>;
+export type PreviewUndoDomainHandle = Readonly<{
+    id: PreviewUndoDomainId;
+    ownership: PreviewUndoDomainOwnership;
+    canUndo: boolean;
+    canRedo: boolean;
+    status?: PreviewUndoDomainStatus;
+    undo: () => void;
+    redo: () => void;
+}>;
+export type PreviewUndoCommand = 'undo' | 'redo';
+export declare function selectPreviewUndoDomain(domains: readonly PreviewUndoDomainHandle[], command: PreviewUndoCommand, context: PreviewUndoSelectionContext): PreviewUndoDomainHandle | null;
+export declare function previewUndoControlsForDomains(domains: readonly PreviewUndoDomainHandle[], context: PreviewUndoSelectionContext): Readonly<{
+    canUndo: boolean;
+    canRedo: boolean;
+    onUndo: () => void;
+    onRedo: () => void;
+}>;

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

@@ -1,4 +1,5 @@
-export type PreviewSidebarTab = 'editor' | 'assistant';
+import type { PreviewSidebarTab } from '@riverbankcms/content-editor';
+export type { PreviewSidebarTab };
 export declare function getPreviewSidebarTab(): PreviewSidebarTab;
 export declare function setPreviewSidebarTab(tab: PreviewSidebarTab): void;
 export declare function requestPreviewSidebarOpen(tab: PreviewSidebarTab): void;

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

@@ -1,11 +1,7 @@
 import type { LaunchReadiness } from "@riverbankcms/api/launch-readiness";
-import type { PreviewConfirmationDialogState } from "./PreviewConfirmationDialog";
-type ResendFeedback = Readonly<{
-    kind: "success" | "error";
-    message: string;
-}> | null;
+import type { PreviewSessionAuthMode } from "../../auth-contract";
 export declare function useOnboardingConfirmationCheck(input: Readonly<{
-    authMode: "onboardingGrant" | null;
+    authMode: PreviewSessionAuthMode;
     dashboardBaseUrl: string | null;
     previewToken: string | null;
     siteId: string | null;
@@ -16,13 +12,12 @@ export declare function useOnboardingConfirmationCheck(input: Readonly<{
     readonly closeDialog: () => void;
     readonly dashboardContinueUrl: string | null;
     readonly dashboardUnlocked: boolean;
-    readonly dialogState: PreviewConfirmationDialogState;
+    readonly dialogState: import("../../onboarding-preview-planner").OnboardingConfirmationDialogState;
     readonly hasLoadedStatus: boolean;
     readonly isCheckingConfirmation: boolean;
     readonly isResendingConfirmation: boolean;
     readonly launchReadiness: LaunchReadiness;
     readonly resendConfirmation: () => Promise<void>;
-    readonly resendFeedback: ResendFeedback;
+    readonly resendFeedback: import("../../onboarding-preview-planner").OnboardingResendFeedback;
     readonly statusLoadFailed: boolean;
 };
-export {};

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

@@ -2,6 +2,5 @@ export declare const PREVIEW_COOKIE_NAME = "preview_token";
 export declare const PREVIEW_REFRESH_COOKIE_NAME = "preview_refresh_token";
 export declare const PREVIEW_COOKIE_MAX_AGE: number;
 export declare const PREVIEW_CODE_PARAM = "preview_code";
-export declare const PREVIEW_AUTH_ENTRY_PATH = "/preview/auth";
 export declare const PREVIEW_SURFACE_PARAM = "preview_surface";
 export declare const PREVIEW_THEME_COOKIE_NAME = "preview_theme_id";

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

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

package/dist/_dts/preview-next/src/onboarding-preview-planner.d.ts

@@ -0,0 +1,89 @@
+import type { LaunchReadiness, OnboardingPreviewStatusResponse, ResendOnboardingPreviewConfirmationResponse } from '@riverbankcms/api/launch-readiness';
+import type { PreviewAuthEntryUrlInput } from './route-contract';
+export declare const DEFAULT_CHECK_ERROR_MESSAGE = "Unable to check your confirmation status right now.";
+export declare const DEFAULT_RESEND_ERROR_MESSAGE = "Unable to resend your confirmation email right now.";
+export declare const RESEND_SUCCESS_MESSAGE = "We sent a fresh confirmation email. Check your inbox and spam folder.";
+export declare const ALREADY_CONFIRMED_MESSAGE = "Your email is already confirmed. You can complete setup in the dashboard.";
+export type OnboardingPreviewPlannerAuthMode = 'onboardingGrant' | 'userSession' | null;
+export type OnboardingConfirmationDialogState = Readonly<{
+    kind: 'ready';
+}> | Readonly<{
+    kind: 'pending';
+}> | Readonly<{
+    kind: 'error';
+    message: string;
+}> | null;
+export type OnboardingResendFeedback = Readonly<{
+    kind: 'success' | 'error';
+    message: string;
+}> | null;
+export type OnboardingConfirmationState = Readonly<{
+    dashboardUnlocked: boolean;
+    dialogState: OnboardingConfirmationDialogState;
+    hasLoadedStatus: boolean;
+    launchReadiness: LaunchReadiness;
+    resendFeedback: OnboardingResendFeedback;
+    statusLoadFailed: boolean;
+}>;
+export type OnboardingConfirmationStateUpdate = Readonly<{
+    kind: 'setDashboardUnlocked';
+    dashboardUnlocked: boolean;
+}> | Readonly<{
+    kind: 'setDialogState';
+    dialogState: OnboardingConfirmationDialogState;
+}> | Readonly<{
+    kind: 'setHasLoadedStatus';
+    hasLoadedStatus: boolean;
+}> | Readonly<{
+    kind: 'setLaunchReadiness';
+    launchReadiness: LaunchReadiness;
+}> | Readonly<{
+    kind: 'setResendFeedback';
+    resendFeedback: OnboardingResendFeedback;
+}> | Readonly<{
+    kind: 'setStatusLoadFailed';
+    statusLoadFailed: boolean;
+}>;
+export type OnboardingConfirmationEffect = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'startPreviewUpgrade';
+    input: PreviewAuthEntryUrlInput;
+}>;
+export type OnboardingConfirmationPlan = Readonly<{
+    updates: readonly OnboardingConfirmationStateUpdate[];
+    effect: OnboardingConfirmationEffect;
+}>;
+export declare function applyOnboardingConfirmationUpdate(state: OnboardingConfirmationState, update: OnboardingConfirmationStateUpdate): OnboardingConfirmationState;
+export declare function applyOnboardingConfirmationUpdates(state: OnboardingConfirmationState, updates: readonly OnboardingConfirmationStateUpdate[]): OnboardingConfirmationState;
+export declare function planStatusApplied(input: Readonly<{
+    allowUserSessionUnlock: boolean;
+    authMode: OnboardingPreviewPlannerAuthMode;
+    currentUrl: string | null;
+    dashboardBaseUrl: string | null;
+    siteSlug: string | null;
+    status: OnboardingPreviewStatusResponse;
+    upgradeAlreadyStarted: boolean;
+}>): OnboardingConfirmationPlan;
+export declare function planAlreadyUnlockedManualCheck(): OnboardingConfirmationPlan;
+export declare function planMissingConfirmationStatusConfig(message?: string): OnboardingConfirmationPlan;
+export declare function planConfirmationStatusFailure(message?: string): OnboardingConfirmationPlan;
+export declare function planManualConfirmationStatusSuccess(input: Readonly<{
+    authMode: OnboardingPreviewPlannerAuthMode;
+    currentUrl: string | null;
+    dashboardBaseUrl: string | null;
+    siteSlug: string | null;
+    status: OnboardingPreviewStatusResponse;
+    upgradeAlreadyStarted: boolean;
+}>): OnboardingConfirmationPlan;
+export declare function planInitialStatusLoadFailure(): OnboardingConfirmationPlan;
+export declare function planMissingResendConfirmationConfig(message?: string): OnboardingConfirmationPlan;
+export declare function planResendConfirmationFailure(message?: string): OnboardingConfirmationPlan;
+export declare function planResendConfirmationSuccess(input: Readonly<{
+    authMode: OnboardingPreviewPlannerAuthMode;
+    currentUrl: string | null;
+    dashboardBaseUrl: string | null;
+    response: ResendOnboardingPreviewConfirmationResponse;
+    siteSlug: string | null;
+    upgradeAlreadyStarted: boolean;
+}>): OnboardingConfirmationPlan;

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

@@ -0,0 +1,37 @@
+export declare const previewBrowserEntries: {
+    readonly previewAuthEntry: {
+        readonly pathname: "/preview/auth";
+    };
+};
+export declare const previewDashboardApiEndpoints: {
+    readonly previewAuthExchange: {
+        readonly path: "/api/preview/auth/exchange";
+    };
+    readonly onboardingPreviewStatus: {
+        readonly path: "/api/public/sites/{siteId}/onboarding/preview-status";
+    };
+    readonly onboardingResendConfirmation: {
+        readonly path: "/api/public/sites/{siteId}/onboarding/resend-confirmation";
+    };
+};
+export type PreviewBrowserEntryRouteKey = keyof typeof previewBrowserEntries;
+export type PreviewDashboardApiEndpointKey = keyof typeof previewDashboardApiEndpoints;
+export type OnboardingPreviewStage = 'preview';
+export type PreviewAuthEntryUrlInput = Readonly<{
+    dashboardBaseUrl: string;
+    returnUrl: string;
+    fallbackUrl: string;
+    siteSlug?: string | null;
+}>;
+export type PreviewAuthExchangeUrlInput = Readonly<{
+    dashboardBaseUrl: string;
+}>;
+export type OnboardingPreviewEndpointUrlInput = Readonly<{
+    dashboardBaseUrl: string;
+    siteId: string;
+}>;
+export declare const previewAuthEntryPathname: "/preview/auth";
+export declare function buildPreviewAuthEntryUrl(input: PreviewAuthEntryUrlInput): string;
+export declare function buildPreviewAuthExchangeUrl(input: PreviewAuthExchangeUrlInput): string;
+export declare function buildOnboardingPreviewStatusUrl(input: OnboardingPreviewEndpointUrlInput): string;
+export declare function buildOnboardingResendConfirmationUrl(input: OnboardingPreviewEndpointUrlInput): string;

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

@@ -1,4 +1,4 @@
-import type { BookingFlexibleBalanceConfig, BookingInstalmentPlanConfig } from '@riverbankcms/core';
+import type { AddressedLocationValue, BusinessAddress, BookingFlexibleBalanceConfig, BookingInstalmentPlanConfig } from '@riverbankcms/core';
 import type { MediaAssetIndexItem, SiteFooterContent, SiteHeaderContent, Theme } from '../contracts';
 import type { BlockFieldConfig as SdkBlockFieldConfig, BlockFieldOptionsMap as SdkBlockFieldOptionsMap, ContentConfig as SdkContentConfig, ContainerOptionsConfig as SdkContainerOptionsConfig, FieldSelectOption as SdkFieldSelectOption, SdkCustomBlock, SdkThemeConfig, SdkThemePalette, SectionBackground as SdkSectionBackground, SectionOptionsConfig as SdkSectionOptionsConfig, SiteStyleConfig as SdkSiteStyleConfig } from '../config/types';
 export type RuntimeSiteSdkConfig = {
@@ -270,6 +270,8 @@ export type SiteResponse = {
         maintenance_mode_message?: unknown | null;
         deployment_mode?: 'managed' | 'headless_cms' | 'headless_full' | null;
         is_sdk_site?: boolean | null;
+        businessAddress?: BusinessAddress | null;
+        venuesById?: Record<string, AddressedLocationValue>;
     };
     favicon?: {
         assetId: string;
@@ -279,6 +281,14 @@ export type SiteResponse = {
     theme: Theme;
     themeId?: string | null;
     selectionId?: string | null;
+    /**
+     * Persisted Style configurator selections (Phase C). Optional so legacy
+     * payloads without these columns still satisfy the type — consumers fall
+     * back to the site style's defaults when null.
+     */
+    selectionButtonPersonalityId?: string | null;
+    selectionPaletteVariantId?: string | null;
+    selectionPaletteOverrides?: Record<string, string> | null;
     navigation: NavigationMenuWithItems[];
     appointmentsEnabled?: boolean;
     portalEnabled?: boolean;

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

@@ -1,79 +1,10 @@
 /**
- * Block component for rendering individual CMS blocks
+ * Default Block renderer component for Riverbank CMS.
  *
- * Renders a single block with its content and data.
+ * This surface restores the common SDK behavior where rendering a block also
+ * boots interactive CMS islands automatically. For a bootstrap-free surface,
+ * use `@riverbankcms/sdk/rendering/server`.
  */
-import * as React from 'react';
-import type { Theme, ThemeTokens } from '../../contracts';
-import type { RiverbankClient } from '../../client/types';
-import type { BlockKind } from '../../types';
-/**
- * Override component for custom block rendering.
- * Receives the same props as default block components.
- */
-export type BlockOverrideComponent = React.ComponentType<{
-    content: Record<string, unknown>;
-    theme?: ThemeTokens;
-    themeConfig?: Theme;
-    data?: Record<string, unknown>;
-    blockId?: string | null;
-    blockKind?: BlockKind;
-}>;
-export type BlockProps = {
-    blockKind: BlockKind;
-    blockId?: string | null;
-    content: Record<string, unknown>;
-    theme: Theme;
-    siteId: string;
-    pageId?: string;
-    previewStage?: 'published' | 'preview';
-    client?: RiverbankClient;
-    usePlaceholders?: boolean;
-    /**
-     * Custom component to override default block rendering.
-     * When provided, renders this component instead of the manifest-based default.
-     * This is SSR-safe - no context or hooks required.
-     *
-     * @example
-     * ```tsx
-     * <Block
-     *   blockKind="block.hero"
-     *   content={heroContent}
-     *   theme={theme}
-     *   siteId={siteId}
-     *   override={MyCustomHero}
-     * />
-     * ```
-     */
-    override?: BlockOverrideComponent;
-};
-/**
- * Renders a single CMS block with optional data loading.
- *
- * Use this component when you want to render individual blocks outside of a full page context,
- * or when mixing CMS blocks with custom JSX.
- *
- * @example Basic usage
- * ```tsx
- * <Block
- *   blockKind="block.hero"
- *   content={{ headline: 'Welcome', subheadline: 'To our site' }}
- *   theme={theme}
- *   siteId="site-123"
- * />
- * ```
- *
- * @example With data loading
- * ```tsx
- * <Block
- *   blockKind="block.blog-listing"
- *   blockId="block-456"
- *   content={blockContent}
- *   theme={theme}
- *   siteId="site-123"
- *   pageId="page-789"
- *   client={client}
- * />
- * ```
- */
-export declare function Block({ blockKind, blockId, content, theme, siteId, pageId, previewStage, client, usePlaceholders: _usePlaceholders, override: OverrideComponent, }: BlockProps): Promise<import("react/jsx-runtime").JSX.Element>;
+import { type BlockProps } from './Block.shared';
+export type { BlockOverrideComponent, BlockProps } from './Block.shared';
+export declare function Block(props: BlockProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,9 @@
+/**
+ * Server-only Block renderer for Riverbank CMS.
+ *
+ * This stays server-safe by delegating to the shared `BlockContent` renderer
+ * without pulling the client hydration bootstrap into the server entrypoint.
+ */
+import { type BlockProps } from './Block.shared';
+export type { BlockOverrideComponent, BlockProps } from './Block.shared';
+export declare function Block(props: BlockProps): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/sdk/src/rendering/components/Block.shared.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Shared Block rendering implementation.
+ *
+ * The default `@riverbankcms/sdk/rendering` surface wraps this with island
+ * hydration; the strict `@riverbankcms/sdk/rendering/server` surface exports it
+ * directly.
+ */
+import * as React from 'react';
+import type { MediaAssetIndexItem, RouteMap, Theme } from '../../contracts';
+import type { RiverbankClient } from '../../client/types';
+import type { BlockKind } from '../../types';
+import type { BlockOverrideComponent } from '../overrides';
+export type { BlockOverrideComponent } from '../overrides';
+export type BlockProps = {
+    blockKind: BlockKind;
+    blockId?: string | null;
+    content: Record<string, unknown>;
+    theme: Theme;
+    siteId?: string;
+    /**
+     * Supabase storage URL for direct image access in SSR output and client
+     * islands.
+     */
+    supabaseUrl?: string;
+    /**
+     * Canonical media sidecar for resolving identifier-only media values.
+     */
+    mediaAssets?: readonly MediaAssetIndexItem[];
+    /**
+     * Base URL for the CMS API. Interactive blocks need this for client-side
+     * form, booking, event, and commerce calls.
+     */
+    apiBaseUrl?: string;
+    /**
+     * Portal token for customer portal Bearer auth.
+     */
+    portalToken?: string | null;
+    /** Route lookup for CMS links inside block content. */
+    routeMap?: RouteMap;
+    /** Page identifier to routeId lookup for { kind: 'page' } links. */
+    pagesByIdentifier?: Record<string, string>;
+    /** ContentType -> identifier -> routeId lookup for { kind: 'entry' } links. */
+    entriesByIdentifier?: Record<string, Record<string, string>>;
+    pageId?: string;
+    previewStage?: 'published' | 'preview';
+    client?: RiverbankClient;
+    usePlaceholders?: boolean;
+    /**
+     * Custom component to override default block rendering. When provided, renders
+     * this component instead of the manifest-based default. Override components
+     * receive the same serializable runtime context as page-level block overrides.
+     *
+     * @example
+     * ```tsx
+     * <Block
+     *   blockKind="block.hero"
+     *   content={heroContent}
+     *   theme={theme}
+     *   siteId={siteId}
+     *   override={MyCustomHero}
+     * />
+     * ```
+     */
+    override?: BlockOverrideComponent;
+};
+export type BlockHydrationBootstrapConfig = {
+    siteId?: string;
+    supabaseUrl?: string;
+    mediaAssets?: readonly MediaAssetIndexItem[];
+};
+export declare function toBlockHydrationBootstrapConfig(props: Pick<BlockProps, 'siteId' | 'supabaseUrl' | 'mediaAssets'>): BlockHydrationBootstrapConfig;
+/**
+ * Renders a single CMS block with optional data loading.
+ *
+ * Use this component when you want to render individual blocks outside of a full page context,
+ * or when mixing CMS blocks with custom JSX.
+ */
+export declare function BlockContent(props: BlockProps): Promise<React.ReactElement<unknown, string | React.JSXElementConstructor<any>>>;

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

@@ -54,11 +54,11 @@ export type LayoutProps = {
  * Layout component that wraps content with site header and footer.
  *
  * This is a server/RSC-safe component. The default `@riverbankcms/sdk/rendering`
- * `Page` surface mounts CMS island hydration automatically, while the strict
- * `@riverbankcms/sdk/rendering/server` surface stays bootstrap-free. If a custom
- * host bypasses the default `Page` surface and still renders hydratable CMS
- * islands, mount `BlocksIslandsHydrator` from `@riverbankcms/sdk/rendering/client`
- * explicitly.
+ * `Page` and `Block` surfaces mount CMS island hydration automatically, while
+ * the strict `@riverbankcms/sdk/rendering/server` surface stays bootstrap-free.
+ * If a custom host renders hydratable CMS islands through the strict server
+ * surface, mount `BlocksIslandsHydrator` from
+ * `@riverbankcms/sdk/rendering/client` explicitly.
  *
  * @example With pre-fetched site data (recommended)
  * ```tsx

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

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

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

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

@@ -1,4 +1,4 @@
-import type { GradientDirection, ButtonPaddingPreset } from './types';
+import type { ButtonSizes, GradientDirection, ButtonPaddingPreset } from './types';
 /**
  * Shared constants for button CSS generation
  *
@@ -38,3 +38,11 @@ export declare const FONT_SIZE_MAP: Record<string, string>;
  * These are global defaults that apply to all button variants unless overridden
  */
 export declare const BUTTON_PADDING_PRESETS: Record<ButtonPaddingPreset, string>;
+/**
+ * System defaults used when a theme doesn't supply its own `theme.buttons.sizes`.
+ *
+ * Every size is defined so the size class CSS always emits a complete rule and
+ * variants are never naked. Referenced by `generateButtonCss` and surfaceable
+ * from UI ("Showing default size ramp") without duplicating the values.
+ */
+export declare const DEFAULT_BUTTON_SIZES: ButtonSizes;