@riverbankcms/sdk 0.107.0 → 0.109.0

package/dist/_dts/db/src/schemas/forms.d.ts

@@ -364,12 +364,12 @@ export declare const formFieldSchema: z.ZodObject<{
         date: "date";
         time: "time";
         email: "email";
+        url: "url";
         text: "text";
         textarea: "textarea";
         select: "select";
         checkbox: "checkbox";
         radio: "radio";
-        url: "url";
         consent: "consent";
         tel: "tel";
     }>;
@@ -425,12 +425,12 @@ declare const bookingQuestionScalarFieldSchema: z.ZodObject<{
         date: "date";
         time: "time";
         email: "email";
+        url: "url";
         text: "text";
         textarea: "textarea";
         select: "select";
         checkbox: "checkbox";
         radio: "radio";
-        url: "url";
         tel: "tel";
     }>;
 }, z.core.$strict>;
@@ -481,12 +481,12 @@ export declare const bookingQuestionFieldSchema: z.ZodDiscriminatedUnion<[z.ZodO
         date: "date";
         time: "time";
         email: "email";
+        url: "url";
         text: "text";
         textarea: "textarea";
         select: "select";
         checkbox: "checkbox";
         radio: "radio";
-        url: "url";
         tel: "tel";
     }>;
 }, z.core.$strict>, z.ZodObject<{
@@ -540,12 +540,12 @@ export declare const bookingQuestionsSectionSchema: z.ZodObject<{
             date: "date";
             time: "time";
             email: "email";
+            url: "url";
             text: "text";
             textarea: "textarea";
             select: "select";
             checkbox: "checkbox";
             radio: "radio";
-            url: "url";
             tel: "tel";
         }>;
     }, z.core.$strict>, z.ZodObject<{
@@ -602,12 +602,12 @@ export declare const bookingQuestionsDetailedSchemaSchema: z.ZodObject<{
                 date: "date";
                 time: "time";
                 email: "email";
+                url: "url";
                 text: "text";
                 textarea: "textarea";
                 select: "select";
                 checkbox: "checkbox";
                 radio: "radio";
-                url: "url";
                 tel: "tel";
             }>;
         }, z.core.$strict>, z.ZodObject<{
@@ -646,12 +646,12 @@ export declare const formSchemaSchema: z.ZodObject<{
             date: "date";
             time: "time";
             email: "email";
+            url: "url";
             text: "text";
             textarea: "textarea";
             select: "select";
             checkbox: "checkbox";
             radio: "radio";
-            url: "url";
             consent: "consent";
             tel: "tel";
         }>;
@@ -705,12 +705,12 @@ export declare const bookingQuestionsFlatSchemaSchema: z.ZodObject<{
             date: "date";
             time: "time";
             email: "email";
+            url: "url";
             text: "text";
             textarea: "textarea";
             select: "select";
             checkbox: "checkbox";
             radio: "radio";
-            url: "url";
             tel: "tel";
         }>;
     }, z.core.$strict>, z.ZodObject<{
@@ -763,12 +763,12 @@ export declare const bookingQuestionsStoredSchemaSchema: z.ZodUnion<readonly [z.
             date: "date";
             time: "time";
             email: "email";
+            url: "url";
             text: "text";
             textarea: "textarea";
             select: "select";
             checkbox: "checkbox";
             radio: "radio";
-            url: "url";
             tel: "tel";
         }>;
     }, z.core.$strict>, z.ZodObject<{
@@ -824,12 +824,12 @@ export declare const bookingQuestionsStoredSchemaSchema: z.ZodUnion<readonly [z.
                 date: "date";
                 time: "time";
                 email: "email";
+                url: "url";
                 text: "text";
                 textarea: "textarea";
                 select: "select";
                 checkbox: "checkbox";
                 radio: "radio";
-                url: "url";
                 tel: "tel";
             }>;
         }, z.core.$strict>, z.ZodObject<{
@@ -900,12 +900,12 @@ export declare const createFormPayloadSchema: z.ZodObject<{
                 date: "date";
                 time: "time";
                 email: "email";
+                url: "url";
                 text: "text";
                 textarea: "textarea";
                 select: "select";
                 checkbox: "checkbox";
                 radio: "radio";
-                url: "url";
                 consent: "consent";
                 tel: "tel";
             }>;

package/dist/_dts/editor/src/primitives/rich-text/RichTextEditorSurface.d.ts

@@ -26,6 +26,11 @@ export type RichTextToolbarLayout = Readonly<{
     kind: 'inline';
     tone: 'light' | 'dark';
     visibility: RichTextToolbarVisibility;
+}> | Readonly<{
+    kind: 'external';
+    tone: 'light' | 'dark';
+    visibility: RichTextToolbarVisibility;
+    renderHost: (toolbar: ReactNode) => ReactNode;
 }> | Readonly<{
     kind: 'chrome';
     tone: 'light' | 'dark';

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

@@ -54,6 +54,7 @@ export type BlockEditorProps = {
     enableDeletion?: boolean;
     onBlockSave?: (blockId: string, content: Record<string, unknown>) => void;
     onBlocksChange?: (blocks: BlockItem[]) => void;
+    onStructuralRevisionChange?: (revision: string) => void;
     theme?: Theme | null;
     widgetOverrides?: Record<string, FieldWidgetComponent>;
     headerLeftSlot?: ReactNode;

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

@@ -10,7 +10,7 @@ type UiStore = {
         };
     };
 };
-export declare function useBlockCreation({ allowCreation, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, triggerFocus, uiStore, }: {
+export declare function useBlockCreation({ allowCreation, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, triggerFocus, uiStore, onStructuralRevisionChange, }: {
     allowCreation: boolean;
     apiClient: ApiClient;
     siteId: string;
@@ -20,6 +20,7 @@ export declare function useBlockCreation({ allowCreation, apiClient, siteId, own
     onBlocksChange?: (blocks: BlockItem[]) => void;
     triggerFocus?: (target: BlockFocusTarget) => void;
     uiStore?: UiStore | null;
+    onStructuralRevisionChange?: (revision: string) => void;
 }): {
     pickerOpen: boolean;
     creatingBlockName: string | null;

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

@@ -9,7 +9,7 @@ type UiStore = {
         };
     };
 };
-export declare function useBlockDuplication({ allowCreation, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, triggerFocus, setErrorMessage, uiStore, }: {
+export declare function useBlockDuplication({ allowCreation, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, triggerFocus, setErrorMessage, uiStore, onStructuralRevisionChange, }: {
     allowCreation: boolean;
     apiClient: ApiClient;
     siteId: string;
@@ -20,6 +20,7 @@ export declare function useBlockDuplication({ allowCreation, apiClient, siteId,
     triggerFocus?: (target: BlockFocusTarget) => void;
     setErrorMessage: (msg: string | null) => void;
     uiStore?: UiStore | null;
+    onStructuralRevisionChange?: (revision: string) => void;
 }): {
     duplicatingBlockId: string | null;
     duplicateBlock: (blockId: string) => Promise<void>;

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

@@ -15,7 +15,7 @@ type UiStore = {
     };
     subscribe: (listener: () => void) => () => void;
 };
-export declare function useBlockReorder({ allowReordering, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, setErrorMessage, uiStore, }: {
+export declare function useBlockReorder({ allowReordering, apiClient, siteId, owner, blockList, setBlockList, onBlocksChange, setErrorMessage, uiStore, onStructuralRevisionChange, }: {
     allowReordering: boolean;
     apiClient: ApiClient;
     siteId: string;
@@ -25,6 +25,7 @@ export declare function useBlockReorder({ allowReordering, apiClient, siteId, ow
     onBlocksChange?: (blocks: BlockItem[]) => void;
     setErrorMessage: (msg: string | null) => void;
     uiStore?: UiStore | null;
+    onStructuralRevisionChange?: (revision: string) => void;
 }): {
     reorderId: string | null;
     handleMove: (blockId: string, direction: number) => void;

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

@@ -7,6 +7,11 @@ export type BlockEditorOwner = Readonly<{
     type: string;
     entryId: string;
     slotKey: string;
+}> | Readonly<{
+    kind: 'surface-slot';
+    pageSurfaceId: string;
+    slotKey: string;
+    compositionHash: string;
 }>;
 export type CreateEditableBlockInput = Readonly<{
     kind: string;
@@ -18,6 +23,10 @@ export declare function blockEditorOwnerKey(owner: BlockEditorOwner): string;
 export declare function createEditableBlockForOwner(apiClient: ApiClient, siteId: string, owner: BlockEditorOwner, input: CreateEditableBlockInput): Promise<{
     ok: boolean;
     block: Record<string, unknown>;
+} | {
+    ok: boolean;
+    block: import("../../../api/src/index").BlockListItem;
+    compositionHash: string;
 }>;
 export declare function reorderEditableBlocksForOwner(apiClient: ApiClient, siteId: string, owner: BlockEditorOwner, blockIds: string[]): Promise<{
     ok: boolean;
@@ -25,3 +34,4 @@ export declare function reorderEditableBlocksForOwner(apiClient: ApiClient, site
 export declare function deleteEditableBlockForOwner(apiClient: ApiClient, siteId: string, owner: BlockEditorOwner, blockId: string): Promise<{
     ok: boolean;
 }>;
+export declare function surfaceCompositionHashFromResponse(response: unknown): string | null;

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

@@ -7,6 +7,7 @@ export type BlockItem = {
     draftContent?: Record<string, unknown> | null;
     publishedContent?: Record<string, unknown> | null;
     bindings?: Record<string, unknown> | null;
+    optimisticHash?: string | null;
 };
 export type DraftBlockSnapshot = EditorStructuralDraftSnapshot;
 /**

package/dist/_dts/media-core/src/fileMimeDetection.d.ts

@@ -8,3 +8,19 @@ export type MagicDetectedMimeType = 'image/png' | 'image/jpeg' | 'image/gif' | '
  */
 export declare function detectMimeTypeFromBuffer(buffer: Uint8Array | null | undefined): MagicDetectedMimeType | undefined;
 export declare function bufferAsLatin1(buffer: Uint8Array, maxBytes?: number): string;
+/**
+ * Recognizes an SVG document by its leading element only.
+ *
+ * Within a bounded window we skip an optional UTF-8 BOM, whitespace, and any XML
+ * prolog constructs (XML declaration / processing instructions, comments, and a
+ * DOCTYPE) and then require the very first element to be `<svg>`. Requiring the
+ * root element — rather than scanning for `<svg` anywhere — is the false-positive
+ * guard: an HTML document that merely embeds inline `<svg>` further down (its
+ * first element is `<html>`/`<body>`/etc.) is deliberately NOT recognized as SVG.
+ *
+ * DOCTYPE is skipped rather than rejected here so a DOCTYPE-bearing SVG is still
+ * recognized and routed to the finalize sanitizer (which rejects DOCTYPE/entities
+ * outright) instead of failing earlier as an opaque MIME mismatch. This probe is
+ * intentionally trusted only through the contract-gated `svg-fallback` strategy.
+ */
+export declare function looksLikeSvgBuffer(buffer: Uint8Array | null | undefined): boolean;

package/dist/_dts/media-core/src/fileStorage.d.ts

@@ -9,6 +9,7 @@ export declare const PUBLIC_SITE_FILE_STORAGE_BUCKETS: readonly [StorageBucketNa
 export declare const FILE_UPLOAD_STAGING_PREFIX = "temp-file-uploads";
 export declare const DURABLE_FILE_STORAGE_PREFIX = "sites";
 export declare const DURABLE_FILE_FOLDER = "files";
+export declare const SDK_UPLOAD_STAGING_PREFIX = "sdk-staging";
 export declare const PRIVATE_SITE_FILE_BUCKET_MIME_TYPES: readonly ["application/pdf", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "text/plain", "application/rtf", "text/rtf", "image/jpeg", "image/png", "image/webp", "image/gif", "image/avif", "image/heic", "image/heif", "image/svg+xml", "text/csv", "application/csv", "application/vnd.ms-excel", "application/zip", "application/x-zip-compressed", "audio/mpeg", "audio/mp4", "audio/wav", "audio/x-wav", "audio/ogg", "audio/webm", "audio/flac", "video/mp4", "video/webm", "video/quicktime"];
 export declare const TEMP_UPLOAD_BUCKET_MIME_TYPES: readonly ["application/pdf", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "text/plain", "application/rtf", "text/rtf", "image/jpeg", "image/png", "image/webp", "image/gif", "image/avif", "image/heic", "image/heif", "image/svg+xml", "text/csv", "application/csv", "application/vnd.ms-excel", "application/zip", "application/x-zip-compressed", "audio/mpeg", "audio/mp4", "audio/wav", "audio/x-wav", "audio/ogg", "audio/webm", "audio/flac", "video/mp4", "video/webm", "video/quicktime", "font/woff2", "application/font-woff2", "application/x-font-woff2", "application/octet-stream"];
 export type FileStoragePathError = 'unsafe-path-segment';
@@ -39,3 +40,10 @@ export declare function buildStagedUploadStoragePath(input: StagedUploadStorageP
  */
 export declare function buildDurableFileStoragePath(input: DurableFileStoragePathInput): Result<SiteScopedStoragePath, FileStoragePathError>;
 export declare function parseStoragePath(value: string): Result<StoragePath, FileStoragePathError>;
+/**
+ * Builds the private staging path for an SDK-management upload from its intended
+ * durable relative path: `sdk-staging/{siteId}/{durableRelativePath}`. Finalize
+ * promotes the object from here (in `temp-uploads`) to the public bucket only
+ * after verification + sanitization.
+ */
+export declare function buildSdkStagedStoragePath(siteId: SiteId, durableRelativePath: string): Result<StoragePath, FileStoragePathError>;

package/dist/_dts/media-core/src/storagePathDomain.d.ts

@@ -22,6 +22,8 @@ export type StoragePathParseError = {
     tag: 'DOUBLE_SLASH';
 } | {
     tag: 'TRAVERSAL';
+} | {
+    tag: 'PERCENT_ENCODING';
 } | {
     tag: 'SITE_SCOPED_PATH';
 } | {

package/dist/_dts/media-core/src/uploadVerificationContract.d.ts

@@ -17,6 +17,9 @@ export type UploadVerificationStrategy = Readonly<{
 }> | Readonly<{
     tag: 'rtf-fallback';
     detectedMimeType: 'application/rtf';
+}> | Readonly<{
+    tag: 'svg-fallback';
+    detectedMimeType: 'image/svg+xml';
 }>;
 export type AcceptedUploadKindContract = Readonly<{
     kind: FileKind;

package/dist/_dts/path-utils/src/index.d.ts

@@ -1,4 +1,9 @@
 export type PathSegment = string | number;
+export declare class UnsafePathSegmentError extends Error {
+    readonly segment: string;
+    constructor(segment: string);
+}
+export declare function isUnsafePathSegment(segment: PathSegment): boolean;
 export declare function parsePath(path: string | Array<PathSegment>): Array<PathSegment>;
 export declare function segmentsToPath(segments: Array<PathSegment>): string | undefined;
 export declare function siblingPath(path: string, siblingFieldPath: string): string;

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

@@ -1,6 +1,7 @@
 import React from 'react';
 import { type BookingOfferingPresetSummary, type Theme } from '../../../../blocks/src/index';
 import { type BackgroundColorPalette } from '../../../../blocks/src/system/customize/backgrounds';
+import { type GradientPresetId } from '../../../../theme-core/src/gradients/index';
 import { type PreviewChromeFloatingPlacement } from '../preview/previewChromePlacement';
 export declare function BlockToolbar({ blockId, blockKind, content, bookingOfferingPresets, theme, placement, }: {
     blockId: string;
@@ -10,4 +11,5 @@ export declare function BlockToolbar({ blockId, blockKind, content, bookingOffer
     theme?: Theme | null;
     placement?: PreviewChromeFloatingPlacement;
 }): React.JSX.Element;
+export declare function gradientPreviewCss(gradientId: GradientPresetId): string;
 export declare function readBackgroundColorPaletteSnapshot(): BackgroundColorPalette | null;

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

@@ -18,4 +18,9 @@ export declare function PreviewChromeFloatingControl({ anchorSelector, anchorTar
     forceVisible?: boolean;
     children: ReactNode;
 }): React.JSX.Element;
+export declare function PreviewChromeFloatingBar({ anchorSelector, gapPx, children, }: {
+    anchorSelector: string;
+    gapPx?: number;
+    children: ReactNode;
+}): React.JSX.Element;
 export {};

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

@@ -59,6 +59,7 @@ export type PreviewEditorSidebarProps = {
     activeTab: PreviewEditorSidebarTab;
     onTabChange: (tab: PreviewEditorSidebarTab) => void;
     onClose: () => void;
+    onFooterSaved?: () => void;
     viewportMode: ViewportMode;
     viewportWidth: ViewportWidth;
     zoom: ZoomLevel;
@@ -66,4 +67,4 @@ export type PreviewEditorSidebarProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, designRowRequest, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, siteStyleAccess, activeTab, onTabChange, onClose, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;
+export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, designRowRequest, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, siteStyleAccess, activeTab, onTabChange, onClose, onFooterSaved, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;

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

@@ -10,6 +10,7 @@ export type PreviewBlock = {
     draftContent?: Record<string, unknown> | null;
     publishedContent?: Record<string, unknown> | null;
     bindings?: Record<string, unknown> | null;
+    optimisticHash?: string | null;
 };
 export type PreviewPageMetadata = {
     draftTitle: string;

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

@@ -72,8 +72,9 @@ export type PreviewShellProps = {
     /** Hides site-style controls for runtimes without palette authority. */
     hideSiteStyleConfigurator?: boolean;
     baseFetch?: BaseFetch;
+    onFooterSaved?: () => void;
 };
-export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, supabaseUrl, themeRuntime, designEditorEligibility, hideSiteStyleConfigurator, baseFetch, }: PreviewShellProps): React.JSX.Element;
+export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, supabaseUrl, themeRuntime, designEditorEligibility, hideSiteStyleConfigurator, baseFetch, onFooterSaved, }: PreviewShellProps): React.JSX.Element;
 export declare function defaultDesignEditorEligibility(input: Readonly<{
     pageId: string | null;
     entryData?: PreviewContentEntryData | null;

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

@@ -45,5 +45,6 @@ export type PreviewShellLayoutProps = {
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     themeRuntime?: PreviewThemeRuntime;
     siteStyleAccess?: SiteStyleAccess;
+    onFooterSaved?: () => void;
 };
-export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, themeRuntime, siteStyleAccess, }: PreviewShellLayoutProps): React.JSX.Element;
+export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, themeRuntime, siteStyleAccess, onFooterSaved, }: PreviewShellLayoutProps): React.JSX.Element;

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

@@ -213,6 +213,7 @@ export declare function reconcilePaletteLibraryActive(state: StyleConfiguratorSt
  */
 export declare function rebasePaletteLibraryAuthority(state: StyleConfiguratorState, committedPalette: ResolvedPaletteSelection): StyleConfiguratorState;
 export declare function selectionSnapshotsEqual(a: SelectionSnapshot, b: SelectionSnapshot): boolean;
+export declare function typographyObjectsEqual(a: ThemeTypography, b: ThemeTypography): boolean;
 type ModernRuntimePaletteState = Extract<RuntimePaletteState, Readonly<{
     authority: 'curated';
 }>> | Extract<RuntimePaletteState, Readonly<{

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

@@ -0,0 +1,4 @@
+export declare const PREVIEW_DESIGN_SAVE_ERROR_MESSAGE = "We couldn\u2019t save that change just now. Please try again in a minute or two.";
+export declare const PREVIEW_DESIGN_REFRESH_ERROR_MESSAGE = "We couldn\u2019t refresh the latest design just now. Your changes are still here. Please try again in a minute or two.";
+export declare const PREVIEW_DESIGN_LOAD_ERROR_MESSAGE = "We couldn\u2019t load those design options just now. Please try again in a minute or two.";
+export declare function reportPreviewDesignError(operation: string, error: unknown): void;

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

@@ -20,7 +20,7 @@ export type ApplySiteStyleSelectionBodyBuildResult = Readonly<{
     ok: false;
     error: Extract<PaletteApplyCommandPlan, {
         ok: false;
-    }>['error'];
+    }>['error'] | 'no-selection-changes';
 }>;
 export declare function buildApplySiteStyleSelectionBody(input: Readonly<{
     base: SelectionSnapshot;

package/dist/_dts/sdk/src/cli/commands/audit.d.ts

@@ -99,4 +99,4 @@ export declare function auditOrphanedEntries(ctx: Pick<AuditContext, 'localEntry
 export declare function auditContentTypes(localContentTypes: Set<string>, validContentTypes: Set<string>): AuditIssue[];
 export declare function auditEventReferences(events: LocalEvent[], ctx: Pick<AuditContext, 'localVenueRefs' | 'remoteVenueRefs' | 'localCategoryRefs' | 'remoteCategoryRefs' | 'localFormRefs' | 'remoteFormRefs'>): AuditIssue[];
 export declare function auditCourseReferences(courses: LocalCourse[], ctx: Pick<AuditContext, 'localVenueRefs' | 'remoteVenueRefs' | 'localCategoryRefs' | 'remoteCategoryRefs' | 'localFormRefs' | 'remoteFormRefs'>): AuditIssue[];
-export declare const auditCommand: Command;
+export declare const createAuditCommand: () => Command;

package/dist/_dts/sdk/src/cli/commands/compare.d.ts

@@ -58,5 +58,5 @@ export declare function compareLocalVsCms(localEntries: LocalEntry[], remoteEntr
     data: Record<string, unknown>;
     status: string;
 }>, contentType: string): ComparisonResult;
-export declare const compareCommand: Command;
+export declare const createCompareCommand: () => Command;
 export {};

package/dist/_dts/sdk/src/cli/commands/deploy.d.ts

@@ -39,5 +39,5 @@ export declare function checkWorkingDirectoryClean(git: SimpleGit, prebuildOutpu
  * @internal Exported for testing
  */
 export declare function commitCacheIfChanged(git: SimpleGit, prebuildOutput: string): Promise<boolean>;
-export declare const deployCommand: Command;
+export declare const createDeployCommand: () => Command;
 export {};

package/dist/_dts/sdk/src/cli/commands/drafts.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Drafts Command (Phase 7.3)
+ *
+ * Cross-type overview of pages and entries with pending (unpublished) changes.
+ * Consumes the SDK `pull.drafts()` operation (server-side `GET pull/drafts`),
+ * which is correctly server-filtered and fully enumerated — replacing the
+ * post-pagination `entry list --status draft` trap.
+ *
+ * Usage:
+ *   riverbankcms drafts
+ *   riverbankcms drafts --json
+ */
+import { Command } from 'commander';
+import type { PulledDrafts } from '../../client/management/types';
+/** Flatten the drafts overview into unified table rows for human display. */
+export declare function draftsToTableRows(drafts: PulledDrafts): string[][];
+export declare const createDraftsCommand: () => Command;
+export declare const draftsCommand: Command;

package/dist/_dts/sdk/src/cli/commands/entry.d.ts

@@ -12,6 +12,7 @@
  *   riverbankcms entry list <type> [--limit N] [--page N]
  */
 import { Command } from 'commander';
+import { type EntryScaffold } from '../../../../content-model/src/index';
 import type { ManagementClient, ManagementEntry } from '../../client/management/types';
 import { type MediaValidationResult } from '../media/write-guard';
 export declare const ENTRY_LIST_COLUMNS: readonly ["id", "identifier", "slug", "status", "hasUnpublishedChanges", "updatedAt", "createdAt", "publishedAt", "title", "contentType"];
@@ -37,4 +38,18 @@ export declare function findEntryById(client: ManagementClient, contentType: str
     limit?: number;
     maxPages?: number;
 }): Promise<ManagementEntry | null>;
+/**
+ * Resolve a scaffold for a content type from the discovery catalog (the field
+ * DSL), or an error listing the available keys. Sourced from
+ * `client.catalog.contentTypes()`, matching how `content-type list` resolves its
+ * source from the client. (An offline local-config fallback is not implemented:
+ * the normalized field DSL is only exposed over the catalog API, and
+ * `content-type list` likewise has no local fallback.)
+ */
+export declare function resolveEntryScaffold(client: ManagementClient, contentType: string): Promise<{
+    scaffold: EntryScaffold;
+} | {
+    error: string;
+    availableKeys: string[];
+}>;
 export declare const entryCommand: Command;

package/dist/_dts/sdk/src/cli/commands/init-docs.d.ts

@@ -9,5 +9,5 @@ interface InitDocsOptions {
     config?: string;
 }
 export declare function runInitDocs(options: InitDocsOptions, command: Command): Promise<void>;
-declare const initDocsCommand: Command;
-export { initDocsCommand };
+export declare const createInitDocsCommand: () => Command;
+export {};

package/dist/_dts/sdk/src/cli/commands/publish-all.d.ts

@@ -47,4 +47,4 @@ export declare function categorizeEntries(entries: ManagementEntry[]): {
  * Exported for testing.
  */
 export declare function aggregateResults(results: PublishResult[]): Omit<PublishAllSummary, 'total'>;
-export declare const publishAllCommand: Command;
+export declare const createPublishAllCommand: () => Command;

package/dist/_dts/sdk/src/cli/commands/pull.d.ts

@@ -39,4 +39,5 @@ export declare function shouldPromptForOverwrite(opts: {
     force: boolean;
     yes: boolean;
 }): boolean;
+export declare const createPullCommand: () => Command;
 export declare const pullCommand: Command;

package/dist/_dts/sdk/src/cli/commands/push/execute/diff.d.ts

@@ -16,4 +16,4 @@ export declare function displayDiff(params: {
     remoteContent: PulledContent;
     humanDiff?: boolean;
     mediaReport?: LocalMediaPushReport;
-}): void;
+}): unknown;

package/dist/_dts/sdk/src/cli/commands/push/options.d.ts

@@ -5,7 +5,10 @@ export interface PushOptions {
     force?: boolean;
     forceUpdateAsset?: boolean;
     allowTruncated?: boolean;
+    /** @deprecated Use `--diff-detail` instead; folded into the `--json` envelope. */
     jsonDiff?: string;
+    /** Diff verbosity carried in the `--json` envelope: 'summary' (default) or 'full'. */
+    diffDetail?: string;
     withConfig?: boolean;
     withTheme?: boolean;
     syncMedia?: boolean;

package/dist/_dts/sdk/src/cli/commands/push-execute.d.ts

@@ -7,6 +7,17 @@ import { type PushScope } from './push/consts';
 export interface PushExecutionResult {
     success: boolean;
 }
+/**
+ * Single command-owned result for a push, assembled once at the end of the push
+ * command (finding 4). `executePushForEnv` writes the diff into `detail` and the
+ * sync outcome into `execution`; the command adds `verification` and emits the
+ * whole object exactly once, so no stage's result clobbers another's.
+ */
+export interface PushResultAccumulator {
+    detail?: unknown;
+    execution?: unknown;
+    verification?: unknown;
+}
 export declare function noContentFoundWarningDetails(contentDir: string): Readonly<{
     contentDir: string;
     expectedFiles: readonly string[];
@@ -39,5 +50,5 @@ export declare function executePushForEnv(output: OutputContext, target: EnvTarg
     jsonDiffMode?: JsonDiffMode | null;
 }, globalOpts: {
     json?: boolean;
-}): Promise<PushExecutionResult>;
+}, resultSink?: PushResultAccumulator): Promise<PushExecutionResult>;
 export {};

package/dist/_dts/sdk/src/cli/commands/setup.d.ts

@@ -1,2 +1,3 @@
 import { Command } from 'commander';
+export declare function createSetupCommand(): Command;
 export declare const setupCommand: Command;

package/dist/_dts/sdk/src/cli/commands/verify.d.ts

@@ -7,4 +7,5 @@
  *   riverbankcms verify [--env=remote] [--config <path>]
  */
 import { Command } from 'commander';
+export declare const createVerifyCommand: () => Command;
 export declare const verifyCommand: Command;

package/dist/_dts/sdk/src/cli/content/reader.d.ts

@@ -62,6 +62,7 @@ export interface LocalNavigationMenu {
     name: string;
     isPrimary?: boolean;
     isFooter?: boolean;
+    footerRole?: 'main' | 'legal-policy' | null;
     items: LocalNavigationItem[];
 }
 export interface LocalNavigation {

package/dist/_dts/sdk/src/cli/helpers.d.ts

@@ -7,8 +7,29 @@
 import { Command } from 'commander';
 import type { SiteId } from '../../../core/src/index';
 import type { ManagementClient } from '../client/management/types';
-import { type OutputContext } from './output';
+import { InvocationEnvelope, type OutputContext } from './output';
 import { type CliErrorContext } from './errors';
+/**
+ * Run `fn` within a fresh invocation envelope. Returns the envelope so `runCli`
+ * can flush it and derive the exit code after the run completes (or fails).
+ */
+export declare function runWithInvocation<T>(fn: (envelope: InvocationEnvelope) => Promise<T>): {
+    envelope: InvocationEnvelope;
+    done: Promise<T>;
+};
+/** The current invocation's envelope, if output is running inside `runCli`. */
+export declare function currentInvocationEnvelope(): InvocationEnvelope | undefined;
+/**
+ * Build the space-separated command path for the envelope's `command` field,
+ * excluding the root program name (e.g. `entry upsert`, `drafts`).
+ */
+export declare function resolveCommandPath(command: Command): string;
+/**
+ * Create an OutputContext bound to a command. In JSON mode it resolves the
+ * current invocation's envelope from the async context, so all output funnels
+ * into one document.
+ */
+export declare function createOutputForCommand(command: Command): OutputContext;
 /**
  * Environment target for CLI operations.
  */

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

@@ -3,5 +3,9 @@
  *
  * CLI tools for SDK site developers.
  * Supports bidirectional content management: pull content from CMS and push content back.
+ *
+ * This module is the bin entry point: it loads env files, then runs the CLI via
+ * `runCli`, which owns the process exit code and guarantees exactly one JSON
+ * envelope per invocation under `--json`. The command tree lives in `program.ts`.
  */
 export {};