@riverbankcms/sdk 0.107.0 → 0.108.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/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/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/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/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/client/management/blocks.d.ts

@@ -1,6 +1,19 @@
 /**
  * Block Operations for Management Client
  */
-import { type HttpClient } from './http';
+import { ManagementApiError, type HttpClient } from './http';
 import type { BlockOperations } from './types';
+/**
+ * Discriminated stale-conflict error for `blocks.patch`: the block's draft
+ * changed since the caller's read. `currentHash` is the server's current
+ * draft content hash — retry the patch with it as `baseContentHash`.
+ * Extracted from the typed `SdkPatchPageBlockStaleContentFieldError` wire
+ * contract, so callers never parse prose.
+ */
+export declare class BlockPatchStaleContentError extends ManagementApiError {
+    readonly kind = "stale-content";
+    readonly currentHash: string;
+    constructor(source: ManagementApiError, currentHash: string);
+}
+export declare function isBlockPatchStaleContentError(error: unknown): error is BlockPatchStaleContentError;
 export declare function createBlockOperations(http: HttpClient): BlockOperations;

package/dist/_dts/sdk/src/client/management/index.d.ts

@@ -38,5 +38,6 @@ import { CourseSessionConflictError } from './courses';
 export declare function createManagementClient(config: ManagementClientConfig): ManagementClient;
 export type { ManagementClient, ManagementClientConfig, ManagementEntry, ManagementPage, ManagementBlock, ManagementNavigationMenu, ManagementNavigationItem, ManagementSettings, ManagementForm, ManagementFormField, ManagementFormSchema, ManagementFormSettings, ManagementVenue, VenueAddress, VenueLocation, VenueUpsertInput, ManagementEventCategory, EventCategoryUpsertInput, ManagementEventSeries, EventSchedule, EventScheduleUpsertInput, EventStartDurationSchedule, EventStartEndSchedule, EventPricing, EventPaymentTerms, EventPaymentTermsInput, EventContent, EventSeriesUpsertInput, ManagementCourseRun, CourseRunUpsertInput, CourseSession, CourseProgramContent, CourseSessionConflict, EntryUpsertInput, EntryPublishUpsertResult, UpsertedManagementEntry, PageUpsertInput, PagePublishUpsertResult, BlockUpsertInput, NavigationMenuUpsertInput, NavigationItemInput, FormUpsertInput, SiteStyleSelectionApplyCommand, SiteStyleSelectionApplyCommandInput, ThemeUpsertInitializeInput, ThemeUpsertInput, ThemeUpsertResult, ThemeUpsertUpdateInput, ThemeStyleSelectionApplyInput, ThemeStyleSelectionApplyResult, FooterContent, ManagementFooterContent, FooterContentUpsertInput, FooterOperations, PulledFooter, PulledEntries, PulledPages, PulledDrafts, PulledNavigation, PulledSettings, PulledForms, PulledTheme, PulledVenues, PulledEventCategories, PulledEvents, PulledCourses, PulledSiteInfo, PulledContentType, PulledContentTypes, PulledContent, PaginationOptions, PaginatedResult, EntryOperations, PageOperations, BlockOperations, NavigationOperations, SettingsOperations, SettingsUpdateInput, WebhookOperations, SetupRevalidationWebhookInput, SetupRevalidationWebhookResult, ManagementWebhookEndpoint, RevalidationWebhookPlannedEndpoint, FormOperations, ThemeOperations, VenueOperations, EventCategoryOperations, EventOperations, CourseOperations, PullOperations, IdentifiersOperations, BackfillResult, BackfillPageResult, BackfillBlockResult, BackfillEntryResult, MediaOperations, MediaUploadResult, } from './types';
 export { ManagementApiError, type ManagementApiErrorRequest } from './http';
+export { BlockPatchStaleContentError, isBlockPatchStaleContentError, } from './blocks';
 export { applySiteStyleSelectionBodyFromCommand, buildApplySiteStyleSelectionCommand, } from './theme';
 export { CourseSessionConflictError };

package/dist/_dts/sdk/src/client/management/types.d.ts

@@ -16,6 +16,8 @@ import type { PaletteSelection } from '../../../../theme-core/src/palette/index'
 import type { Theme } from '../../contracts';
 export type SdkDeletePageResponse = NonNullable<APIEndpoints['sdkDeletePage']['response']>;
 export type SdkGetPageBlockResponse = NonNullable<APIEndpoints['sdkGetPageBlock']['response']>;
+export type SdkPatchPageBlockBody = NonNullable<APIEndpoints['sdkPatchPageBlock']['body']>;
+export type SdkPatchPageBlockResponse = NonNullable<APIEndpoints['sdkPatchPageBlock']['response']>;
 export type SdkPullEntriesAllResponse = NonNullable<APIEndpoints['sdkPullEntriesAll']['response']>;
 export type SdkUpsertEntryResponse = NonNullable<APIEndpoints['sdkUpsertEntry']['response']>;
 export type SdkUpsertPageResponse = NonNullable<APIEndpoints['sdkUpsertPage']['response']>;
@@ -150,6 +152,7 @@ export interface ManagementNavigationMenu {
     name: string;
     isPrimary: boolean;
     isFooter: boolean;
+    footerRole: 'main' | 'legal-policy' | null;
     items: ManagementNavigationItem[];
     createdAt: string;
     updatedAt: string;
@@ -189,6 +192,7 @@ export interface PulledNavigationMenu {
     name: string;
     isPrimary: boolean;
     isFooter: boolean;
+    footerRole: 'main' | 'legal-policy' | null;
     items: PulledNavigationItem[];
     createdAt: string;
     updatedAt: string;
@@ -198,6 +202,7 @@ export interface NavigationMenuUpsertInput {
     name: string;
     isPrimary?: boolean;
     isFooter?: boolean;
+    footerRole?: 'main' | 'legal-policy' | null;
     items: NavigationItemInput[];
 }
 export interface NavigationItemInput {
@@ -595,7 +600,8 @@ export interface ThemeStyleSelectionApplyResult {
 }
 /**
  * Footer content for SDK management operations.
- * Matches the structure stored in site_settings.footer_content_json (bottomText only).
+ * A narrow legal-text command. The CMS maps this onto the V1 footer composition's
+ * legal module without exposing or replacing the aggregate.
  */
 export interface FooterContent {
     /** Rich text content in ProseMirror JSON format */
@@ -944,10 +950,18 @@ export interface PageOperations {
     delete(identifier: string): Promise<void>;
 }
 export type ManagementPageBlock = SdkGetPageBlockResponse['block'];
+/**
+ * Input for `blocks.patch` — derived from the API contract.
+ * `baseContentHash` must be the `contentHash` from a prior `blocks.get`;
+ * a stale hash rejects with a 409 whose `fieldErrors[0].message` carries the
+ * current hash (field `baseContentHash`, code `STALE_CONTENT`).
+ */
+export type BlockPatchInput = SdkPatchPageBlockBody;
 export interface BlockOperations {
     list(pageIdentifier: string): Promise<ManagementBlock[]>;
     get(pageIdentifier: string, blockIdentifier: string): Promise<ManagementPageBlock | null>;
     upsert(pageIdentifier: string, input: BlockUpsertInput): Promise<ManagementBlock>;
+    patch(pageIdentifier: string, blockIdentifier: string, input: BlockPatchInput): Promise<ManagementPageBlock>;
     reorder(pageIdentifier: string, blockIdentifiers: string[]): Promise<void>;
     delete(pageIdentifier: string, blockIdentifier: string): Promise<void>;
 }

package/dist/_dts/sdk/src/config/content-types.d.ts

@@ -300,6 +300,8 @@ export interface NavigationMenuConfig {
     isPrimary?: boolean;
     /** Is this the footer menu? */
     isFooter?: boolean;
+    /** Named footer destination. Prefer this for new configurations. */
+    footerRole?: 'main' | 'legal-policy' | null;
     /** Menu items */
     items: NavigationItemConfig[];
 }

package/dist/_dts/sdk/src/config/content-validation.d.ts

@@ -97,6 +97,10 @@ export declare const navigationMenuConfigSchema: z.ZodObject<{
     name: z.ZodString;
     isPrimary: z.ZodOptional<z.ZodBoolean>;
     isFooter: z.ZodOptional<z.ZodBoolean>;
+    footerRole: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        main: "main";
+        "legal-policy": "legal-policy";
+    }>>>;
     items: z.ZodArray<z.ZodType<Readonly<{
         label: string;
         link: import("../../../api/src/index").NavigationAuthoringLinkInput;

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

@@ -280,6 +280,7 @@ export declare function getPrimaryNavigation(navigation: NavigationMenuWithItems
  * ```
  */
 export declare function getFooterNavigation(navigation: NavigationMenuWithItems[] | null | undefined): NavigationMenuWithItems | null;
+export declare function getFooterNavigationByRole(navigation: NavigationMenuWithItems[] | null | undefined, role: 'main' | 'legal-policy'): NavigationMenuWithItems | null;
 /**
  * Get a navigation menu by name/slug.
  *
@@ -417,6 +418,7 @@ export declare function buildMenu(navigation: NavigationMenuWithItems[], routes:
  * ```
  */
 export declare function buildFooterMenu(navigation: NavigationMenuWithItems[], routes: RouteMap, options?: NavigationRenderOptions): FooterMenu;
+export declare function buildFooterMenuForRole(navigation: NavigationMenuWithItems[], routes: RouteMap, role: 'main' | 'legal-policy', options?: NavigationRenderOptions): FooterMenu;
 export declare function resolveNavigationLinkHref(link: LinkPayload | null, routes: RouteMap, options?: NavigationRenderOptions): string | null;
 /**
  * Build a Logo from site layout data.

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

@@ -184,6 +184,7 @@ export interface NavigationMenuRecord {
     name: string;
     isPrimary: boolean;
     isFooter: boolean;
+    footerRole: 'main' | 'legal-policy' | null;
     createdAt?: string | null;
     updatedAt?: string | null;
 }
@@ -315,7 +316,7 @@ export type SiteResponse = {
      * Persisted design selections. 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;
     runtimePaletteState?: RuntimePaletteState | null;
     selectionHeaderLayoutId?: string | null;
@@ -424,7 +425,7 @@ export type SdkRuntimePageSurfaceContentSource = Readonly<{
 export type SdkRuntimePageSurface = {
     id: string;
     routeId: string;
-    readinessState: 'shippable';
+    readinessState: 'internal_pilot' | 'shippable';
     subject: SdkRuntimePageSurfaceSubject;
     title: string;
     slug: string | null;

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

@@ -3,7 +3,7 @@
  *
  * Renders site header and footer around content. Fetches site data if not provided.
  */
-import { buildMenu, buildFooterMenu, buildLogo } from '../../navigation';
+import { buildMenu, buildFooterMenu, buildFooterMenuForRole, buildLogo } from '../../navigation';
 import type { RiverbankClient, SiteResponse } from '../../client/types';
 import { type SdkThemeRuntime } from '../themeRuntime';
 export type HeaderData = {
@@ -16,6 +16,7 @@ export type HeaderData = {
 export type FooterData = {
     menu: ReturnType<typeof buildMenu>;
     footerMenu: ReturnType<typeof buildFooterMenu>;
+    legalFooterMenu: ReturnType<typeof buildFooterMenuForRole>;
     logo: ReturnType<typeof buildLogo>;
     site: SiteResponse['site'];
     theme: SiteResponse['theme'];

package/dist/_dts/sdk/src/rendering/helpers/loadContent.d.ts

@@ -182,7 +182,7 @@ export type EntryContentResult = {
 export type PageSurfaceContentData = {
     id: string;
     routeId: string;
-    readinessState: 'shippable';
+    readinessState: 'internal_pilot' | 'shippable';
     subject: SdkRuntimePageSurfaceSubject;
     title: string;
     slug: string | null;

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

package/dist/_dts/site-commands/src/commands.d.ts

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { type BlockRef, type BlocksRef, type CommandRef, type ContentEntryRef, type CourseRef, type PassProductRef, type MembershipProductRef, type BookingCustomerRef, type CustomerPassRef, type CustomerMembershipRef, type AppointmentBookingRef, type CourseEnrollmentRef, type EventRegistrationRef, type PassRedemptionRef, type OrderRef, type EventSeriesRef, type FormRef, type FooterRef, type MediaRef, type NavigationRef, type PageRef, type SiteStyleRef, type StaffRef, type TicketTypeRef, type VenueRef, type EventCategoryRef, type AppointmentServiceRef, type AppointmentResourceRef, type AppointmentAvailabilityRef, type SiteCommandSiteRef } from './refs';
 export declare const navigationLocations: readonly ["main", "header", "footer"];
 export type NavigationLocation = (typeof navigationLocations)[number];
-export declare const navigationMenuRoles: readonly ["primary", "footer"];
+export declare const navigationMenuRoles: readonly ["primary", "footer", "legal-policy"];
 export type NavigationMenuRole = (typeof navigationMenuRoles)[number];
 export declare const offeringArchetypes: readonly ["class", "workshop", "retreat", "performance", "custom"];
 export type OfferingArchetype = (typeof offeringArchetypes)[number];
@@ -488,13 +488,14 @@ export declare const upsertNavigationMenuCommandSchema: z.ZodObject<{
         identifier: z.ZodOptional<z.ZodString>;
         name: z.ZodOptional<z.ZodString>;
         location: z.ZodOptional<z.ZodEnum<{
-            header: "header";
-            footer: "footer";
             main: "main";
+            footer: "footer";
+            header: "header";
         }>>;
         role: z.ZodOptional<z.ZodEnum<{
-            primary: "primary";
+            "legal-policy": "legal-policy";
             footer: "footer";
+            primary: "primary";
         }>>;
         items: z.ZodReadonly<z.ZodArray<z.ZodType<Readonly<{
             label: string;
@@ -1750,13 +1751,14 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         identifier: z.ZodOptional<z.ZodString>;
         name: z.ZodOptional<z.ZodString>;
         location: z.ZodOptional<z.ZodEnum<{
-            header: "header";
-            footer: "footer";
             main: "main";
+            footer: "footer";
+            header: "header";
         }>>;
         role: z.ZodOptional<z.ZodEnum<{
-            primary: "primary";
+            "legal-policy": "legal-policy";
             footer: "footer";
+            primary: "primary";
         }>>;
         items: z.ZodReadonly<z.ZodArray<z.ZodType<Readonly<{
             label: string;
@@ -2928,13 +2930,14 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
             identifier: z.ZodOptional<z.ZodString>;
             name: z.ZodOptional<z.ZodString>;
             location: z.ZodOptional<z.ZodEnum<{
-                header: "header";
-                footer: "footer";
                 main: "main";
+                footer: "footer";
+                header: "header";
             }>>;
             role: z.ZodOptional<z.ZodEnum<{
-                primary: "primary";
+                "legal-policy": "legal-policy";
                 footer: "footer";
+                primary: "primary";
             }>>;
             items: z.ZodReadonly<z.ZodArray<z.ZodType<Readonly<{
                 label: string;

package/dist/_dts/theme-core/src/accordions/types.d.ts

@@ -87,8 +87,8 @@ export declare const accordionSystemSchema: z.ZodObject<{
             semibold: "semibold";
         }>>;
         fontFamily: z.ZodOptional<z.ZodEnum<{
-            body: "body";
             heading: "heading";
+            body: "body";
         }>>;
         fontScale: z.ZodOptional<z.ZodEnum<{
             body: "body";
@@ -115,9 +115,9 @@ export declare const accordionSystemSchema: z.ZodObject<{
         triggerColorToken: z.ZodOptional<z.ZodString>;
         accent: z.ZodOptional<z.ZodObject<{
             edge: z.ZodEnum<{
+                bottom: "bottom";
                 left: "left";
                 top: "top";
-                bottom: "bottom";
             }>;
             colorToken: z.ZodString;
             thickness: z.ZodEnum<{

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

@@ -20,6 +20,17 @@ export declare const buttonPersonalities: readonly [Readonly<{
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
     buttonSystem: import("../../../../blocks/src/index").ButtonSystem;
+}>, Readonly<{
+    id: ButtonPersonalityId<"two-tone-pill">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../../../blocks/src/index").StyleTone;
+        energy: import("../../../../blocks/src/index").StyleEnergy;
+        motion: import("../../../../blocks/src/index").StyleMotion;
+        era: import("../../../../blocks/src/index").StyleEra;
+    }>>>;
+    buttonSystem: import("../../../../blocks/src/index").ButtonSystem;
 }>, Readonly<{
     id: ButtonPersonalityId<"earth-pill">;
     name: string;