@riverbankcms/sdk 0.60.0 → 0.60.1

package/dist/_dts/editor-blocks/src/BlockForm.d.ts

@@ -5,6 +5,10 @@ import { type PageDesignEditorBlock } from '@riverbankcms/theme-core/site-styles
 import { type EditorBlockId } from '@riverbankcms/core';
 import type { ArrayKeysManager, DraftsSlice, UiStore as BlockEditorUiStore } from './block-editor/types';
 type UiStoreState = {
+    setActivePreviewField: (field: {
+        blockId: EditorBlockId;
+        fieldPath: string;
+    } | null) => void;
     blockValidation: {
         markPathEdited: (blockId: EditorBlockId, path: string) => void;
         isPathEdited: (blockId: EditorBlockId, path: string) => boolean;

package/dist/_dts/editor-blocks/src/block-editor/BlockCard.d.ts

@@ -1,13 +1,15 @@
+import type { SyntheticListenerMap } from '@dnd-kit/core/dist/hooks/utilities';
 import { type EditorBlockId } from '@riverbankcms/core';
 import type { PageDesignEditorBlock } from '@riverbankcms/theme-core/site-styles';
 import type { SystemBlockDefinition } from '@riverbankcms/blocks';
-import type { Theme } from '@riverbankcms/blocks';
 import type { BlockDraftSaveability } from '@riverbankcms/block-form/client';
+import type { FieldWidgetComponent } from '@riverbankcms/block-form/client';
+import type { Theme } from '@riverbankcms/blocks';
+import { type ReorderControlMode } from './reorderControlMode';
 import type { ArrayKeysManager, BlockFocusRequest, BlockItem, UiStore, DraftsSlice, UiSlice } from './types';
 /** Drag listener props from dnd-kit */
-type DragListeners = Record<string, Function> | undefined;
-import type { FieldWidgetComponent } from '@riverbankcms/block-form/client';
-type BlockCardStore = UiStore<Pick<UiSlice, 'activeBlockId' | 'setActiveBlockId'> & {
+type DragListeners = SyntheticListenerMap | undefined;
+type BlockCardStore = UiStore<Pick<UiSlice, 'activeBlockId' | 'setActiveBlockId' | 'setActivePreviewField'> & {
     blockValidation: {
         markPathEdited: (blockId: EditorBlockId, path: string) => void;
         isPathEdited: (blockId: EditorBlockId, path: string) => boolean;
@@ -17,7 +19,7 @@ type BlockCardStore = UiStore<Pick<UiSlice, 'activeBlockId' | 'setActiveBlockId'
     drafts: Pick<DraftsSlice, 'getBlockSnapshot' | 'getCurrentValues' | 'getAtPath' | 'setAtPath' | 'edit' | 'initNewBlock' | 'updateBlockBaseline' | 'clearError'>;
     arrayKeys: ArrayKeysManager;
 }>;
-export declare function BlockCard({ siteId, block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onCollapsedChange, highlighted, hasRecoveryConflict, focusSignal, onFocusHandled, onBlockSave, theme, widgetOverrides, uiStore, hideThemeV2RawStyleFields, pageDesignBlock, }: {
+export declare function BlockCard({ siteId, block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onCollapsedChange, highlighted, hasRecoveryConflict, focusSignal, onFocusHandled, onBlockSave, theme, widgetOverrides, uiStore, hideThemeV2RawStyleFields, pageDesignBlock, reorderControlMode, }: {
     siteId: string;
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
@@ -41,5 +43,6 @@ export declare function BlockCard({ siteId, block, manifest, isFirst, isLast, is
     uiStore: BlockCardStore;
     hideThemeV2RawStyleFields?: boolean;
     pageDesignBlock?: PageDesignEditorBlock | null;
+    reorderControlMode?: ReorderControlMode;
 }): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/_dts/editor-blocks/src/block-editor/BlockCardHeader.d.ts

@@ -1,14 +1,15 @@
-import type { Theme } from '@riverbankcms/blocks';
-/** Drag listener props from dnd-kit */
-type DragListeners = Record<string, Function> | undefined;
-import type { SystemBlockDefinition } from '@riverbankcms/blocks';
+import type { SyntheticListenerMap } from '@dnd-kit/core/dist/hooks/utilities';
 import type { FieldWidgetComponent } from '@riverbankcms/block-form/client';
+import { type SystemBlockDefinition, type Theme } from '@riverbankcms/blocks';
+import type { ReorderControlMode } from './reorderControlMode';
 import type { BlockItem, UiStore, DraftsSlice, ArrayKeysManager } from './types';
+/** Drag listener props from dnd-kit */
+type DragListeners = SyntheticListenerMap | undefined;
 type BlockCardHeaderStore = UiStore<{
     drafts: Pick<DraftsSlice, 'getBlockSnapshot' | 'getCurrentValues' | 'initNewBlock' | 'updateBlockBaseline' | 'clearError' | 'setAtPath' | 'getAtPath'>;
     arrayKeys: ArrayKeysManager;
 }>;
-export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, }: {
+export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, reorderControlMode, }: {
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
     isFirst: boolean;
@@ -27,5 +28,6 @@ export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMo
     widgetOverrides?: Record<string, FieldWidgetComponent>;
     theme?: Theme | null;
     hideThemeV2RawStyleFields?: boolean;
+    reorderControlMode?: ReorderControlMode;
 }): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/_dts/editor-blocks/src/block-editor/SortableBlockItem.d.ts

@@ -5,6 +5,7 @@ import type { BlockFocusRequest, BlockItem } from './types';
 import { type SdkConfigForBlockPicker } from './sdkBlockMerger';
 import { BlockCard } from './BlockCard';
 import type { FieldWidgetComponent } from '@riverbankcms/block-form/client';
+import { type ReorderControlMode } from './reorderControlMode';
 export declare const SortableBlockItem: import("react").NamedExoticComponent<{
     siteId: string;
     block: BlockItem;
@@ -28,4 +29,5 @@ export declare const SortableBlockItem: import("react").NamedExoticComponent<{
     sdkConfig?: SdkConfigForBlockPicker | null;
     hideThemeV2RawStyleFields?: boolean;
     pageDesignBlock?: PageDesignEditorBlock | null;
+    reorderControlMode?: ReorderControlMode;
 }>;

package/dist/_dts/editor-blocks/src/block-editor/reorderControlMode.d.ts

@@ -0,0 +1,3 @@
+export type ReorderControlMode = 'full' | 'drag-handle-only';
+export declare const DEFAULT_REORDER_CONTROL_MODE: ReorderControlMode;
+export declare function shouldShowMoveButtons(mode: ReorderControlMode): boolean;

package/dist/_dts/editor-blocks/src/block-editor/types.d.ts

@@ -43,6 +43,10 @@ export type UiSlice = {
         itemIndex?: number | null;
     }) => void;
     clearFocus: () => void;
+    setActivePreviewField: (field: {
+        blockId: EditorBlockId;
+        fieldPath: string;
+    } | null) => void;
 };
 export type ArrayKeysManager = {
     get: (scope: string, path: string) => string[] | undefined;

package/dist/_dts/media-react/src/hooks/useApiMediaUploader.d.ts

@@ -1,3 +1,4 @@
+import type { ApiErrorCode, FieldError } from '@riverbankcms/api/common';
 import { type ApiClient } from '@riverbankcms/api/request';
 import type { UploadIntentContract } from '@riverbankcms/api';
 import type { VideoPrepIntent } from '@riverbankcms/media-core';
@@ -6,6 +7,19 @@ import type { UploadProgressHandler } from './useUploads';
 import { type ClassificationHook, type LoggerLike } from './internal/classification';
 export type UploadIntentResolver = UploadIntentContract | ((file: File) => UploadIntentContract | undefined);
 export type VideoPrepIntentResolver = VideoPrepIntent | ((file: File) => VideoPrepIntent | undefined);
+export declare class MediaUploaderError extends Error {
+    readonly code?: ApiErrorCode;
+    readonly status?: number;
+    readonly fieldErrors?: readonly FieldError[];
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        readonly code?: ApiErrorCode;
+        readonly status?: number;
+        readonly fieldErrors?: readonly FieldError[];
+        readonly cause?: unknown;
+    });
+}
+export declare function getMediaUploaderErrorCode(error: Error | undefined): ApiErrorCode | undefined;
 export type UseApiMediaUploaderOptions = {
     siteId: string;
     apiClient: ApiClient;

package/dist/_dts/media-react/src/index.d.ts

@@ -6,7 +6,7 @@ export { useUploads } from './hooks/useUploads';
 export type { UseUploadsOptions, UseUploadsResult, UploadItem, UploadStatus, UploadProgressStage, UploadProgressHandler } from './hooks/useUploads';
 export { useSupabaseMediaUploader } from './hooks/useSupabaseMediaUploader';
 export type { UseSupabaseMediaUploaderOptions } from './hooks/useSupabaseMediaUploader';
-export { useApiMediaUploader } from './hooks/useApiMediaUploader';
+export { getMediaUploaderErrorCode, MediaUploaderError, useApiMediaUploader, } from './hooks/useApiMediaUploader';
 export type { UploadIntentResolver, UseApiMediaUploaderOptions, VideoPrepIntentResolver } from './hooks/useApiMediaUploader';
 export { useAuthenticatedImageSrc } from './hooks/useAuthenticatedImageSrc';
 export { extractVideoPosterFrame } from './videoFrameExtraction';

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

@@ -2,6 +2,8 @@ export type { PreviewAuthFailureSource, PreviewAuthFetch, PreviewAuthState, } fr
 export { initPreviewAuth, markPreviewAuthExpired, usePreviewAuth, usePreviewAuthFetch, usePreviewToken, } from "./previewAuthStore";
 export type { OnboardingPreviewRedirectAuthPlan, PreviewAuthMode, PreviewExchangeTokenKind, PreviewRuntimeSession, PreviewSessionAuthMode, PreviewSessionTokens, } from "../auth-contract";
 export { getPreviewRuntimeSessionAuthMode, isPreviewRuntimeSessionEditable, resolveOnboardingPreviewRedirectAuthPlan, resolvePreviewAuthMode, resolvePreviewExchangeTokenKind, resolvePreviewRuntimeSession, resolvePreviewSessionCanEdit, } from "../auth-contract";
+export type { OnboardingPreviewEndpointUrlInput, OnboardingPreviewStage, PreviewAuthEntryUrlInput, PreviewAuthExchangeUrlInput, PreviewBrowserEntryRouteKey, PreviewDashboardApiEndpointKey, } from "../route-contract";
+export { buildOnboardingPreviewStatusUrl, buildOnboardingResendConfirmationUrl, buildPreviewAuthEntryUrl, buildPreviewAuthExchangeUrl, previewAuthEntryPathname, previewBrowserEntries, previewDashboardApiEndpoints, } from "../route-contract";
 export { PreviewShellSmoke } from "./PreviewShellSmoke";
 export { PreviewLayoutProvider, usePreviewLayout, } from "./layout/PreviewLayoutContext";
 export { useOptionalPreviewLayout } from "./layout/PreviewLayoutContext";

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

@@ -1,37 +1,22 @@
 import { type ReactNode } from 'react';
-import type { APIEndpoints } from '@riverbankcms/api';
 import { type ApiClient } from '@riverbankcms/api/request';
 import type { PreviewCustomizeAction } from '../blocks/previewCustomizeActions';
-type ApiPageDesignEditorStateResponse = NonNullable<APIEndpoints['getPageDesignEditorState']['response']>;
-type ApplyPageDesignEditorActionResponse = NonNullable<APIEndpoints['applyPageDesignEditorAction']['response']>;
-export type PreviewPageDesignEditorApplyOutcome = Readonly<{
-    kind: 'saved';
-    response: ApplyPageDesignEditorActionResponse;
-}> | Readonly<{
-    kind: 'skipped';
-}> | Readonly<{
-    kind: 'stale';
-    message: string;
-}> | Readonly<{
-    kind: 'invalid';
-    message: string;
-}> | Readonly<{
-    kind: 'failed';
-    message: string;
-}>;
-export type PreviewPageDesignEditorState = Readonly<{
-    kind: 'unsupported';
-}> | Readonly<{
-    kind: 'loading';
-}> | Readonly<{
-    kind: 'failed';
-    message: string;
-}> | ApiPageDesignEditorStateResponse;
+import { type PreviewPageDesignEditorApplyOutcome, type PreviewPageDesignEditorState } from './previewCustomizeWorkflowState';
+export type { PreviewPageDesignEditorApplyOutcome, PreviewPageDesignEditorState, } from './previewCustomizeWorkflowState';
 type PageDesignEditorStateContextValue = Readonly<{
     state: PreviewPageDesignEditorState;
     reload: () => void;
     applyAction: (action: PreviewCustomizeAction) => Promise<PreviewPageDesignEditorApplyOutcome>;
+    undo: () => Promise<PreviewPageDesignEditorApplyOutcome>;
+    redo: () => Promise<PreviewPageDesignEditorApplyOutcome>;
+    canUndo: boolean;
+    canRedo: boolean;
+    isHistoryPending: boolean;
+    isHistoryStale: boolean;
+    historyFailure: string | null;
 }>;
+export declare const PREVIEW_CUSTOMIZE_STALE_MESSAGE = "This page changed since that design choice. Refresh the preview, then try again.";
+export { applyPreviewCustomizeActionToState } from './previewCustomizeWorkflowState';
 export declare function PreviewPageDesignEditorStateProvider({ apiClient, siteId, pageId, enabled, children, }: Readonly<{
     apiClient: ApiClient;
     siteId: string;
@@ -40,5 +25,3 @@ export declare function PreviewPageDesignEditorStateProvider({ apiClient, siteId
     children: ReactNode;
 }>): import("react/jsx-runtime").JSX.Element;
 export declare function usePreviewPageDesignEditorState(): PageDesignEditorStateContextValue;
-export declare function applyPreviewCustomizeActionToState(state: PreviewPageDesignEditorState, action: PreviewCustomizeAction): PreviewPageDesignEditorState;
-export {};

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

@@ -1,6 +1,6 @@
 import React from 'react';
 import type { ApiClient } from '@riverbankcms/api/request';
-import type { SurfaceId } from '@riverbankcms/surfaces';
+import { type SurfaceId } from '@riverbankcms/surfaces';
 type PreviewEditorUIProps = {
     inMaintenanceMode?: boolean;
     siteId?: string;

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

@@ -0,0 +1,12 @@
+import { type SurfaceId } from "@riverbankcms/surfaces";
+export declare const PREVIEW_CHROME_THEME_CLASS_NAME = "builder-dashboard-chrome-theme";
+export declare const PREVIEW_CHROME_PORTAL_CLASS_NAME = "builder-editor-chrome";
+export type PreviewChromeSurface = Readonly<{
+    surfaceClassName: string | null;
+    dataSurface: string | null;
+}>;
+export declare function resolvePreviewChromeSurface(surfaceId?: SurfaceId | null): PreviewChromeSurface;
+export declare function getPreviewChromeSurfaceDataProps(surface: PreviewChromeSurface): Readonly<Record<string, string>>;
+export declare function applyPreviewChromeSurfaceToElement(element: HTMLElement, surface: PreviewChromeSurface, options?: Readonly<{
+    includePortalClass?: boolean;
+}>): void;

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;