@riverbankcms/sdk 0.74.0 → 0.76.0

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.interactive.d.ts

@@ -1,30 +1,8 @@
-import { z } from "zod";
 import { type InteractiveIslandProps } from "../../../contracts/islands";
-import { type BookingFormService, type BookingFormConfig, type BookingFormServicesSource, type BookingFormSettings, type BookingFormSourceRecord } from "./booking-form.state";
+import { type BookingFormService, type BookingFormConfig, type BookingFormServicesSource } from "./booking-form.state";
+import { type BookingFormRebookContext, type BookingFormSourceProps } from "./booking-runtime-sources";
 export type { BookingFormConfig, BookingFormService };
-export type BookingFormRebookContext = Readonly<{
-    kind: "portal_rebook";
-}>;
-export type BookingFormSourceProps = Readonly<{
-    siteId?: string;
-    apiBaseUrl?: string;
-    portalToken?: string | null;
-    formId?: string;
-    serviceId?: string | null;
-    resourceId?: string | null;
-    initialData?: Readonly<Record<string, unknown>> | null;
-    noticeMessage?: string | null;
-    requiresServiceSelection?: boolean;
-    requiresResourceSelection?: boolean;
-    shouldAutoSelectSingleResource?: boolean;
-    rebookContext?: BookingFormRebookContext | null;
-    submitLabel?: string | null;
-    successMessage?: string | null;
-    form?: BookingFormSourceRecord | null;
-    services?: BookingFormServicesSource | null;
-    spamProtectionEnabled?: boolean;
-    className?: string | null;
-}>;
+export type { BookingFormRebookContext, BookingFormSourceProps };
 export type BookingFormDisplay = Readonly<{
     kind: "booking-form";
     state: "missing" | "ready";
@@ -47,8 +25,6 @@ export type BookingFormHydration = Readonly<{
     services: readonly BookingFormService[];
     spamProtectionEnabled?: boolean;
 }>;
-export declare const bookingSettingsSchema: z.ZodType<BookingFormSettings>;
-export declare const bookingSourceFormSchema: z.ZodType<BookingFormSourceRecord>;
 type BookingFormIslandMeta = Readonly<{
     siteId?: string;
     apiBaseUrl?: string;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-runtime-sources.d.ts

@@ -0,0 +1,163 @@
+import { z } from "zod";
+import type { PublicEvent } from "../../blocks/events/shared/types";
+import type { BookingFormField, BookingFormService, BookingFormServicesSource, BookingFormSettings, BookingFormSourceRecord } from "./booking-form.state";
+import type { EventRegistrationContentEntry, EventRegistrationSourceProps } from "./event-registration.interactive";
+export declare const APPOINTMENT_BOOKING_RUNTIME_FORM_ID = "booking-form";
+export type BookingFormRebookContext = Readonly<{
+    kind: "portal_rebook";
+}>;
+export type BookingFormSourceProps = Readonly<{
+    siteId?: string;
+    apiBaseUrl?: string;
+    portalToken?: string | null;
+    formId?: string;
+    serviceId?: string | null;
+    resourceId?: string | null;
+    initialData?: Readonly<Record<string, unknown>> | null;
+    noticeMessage?: string | null;
+    requiresServiceSelection?: boolean;
+    requiresResourceSelection?: boolean;
+    shouldAutoSelectSingleResource?: boolean;
+    rebookContext?: BookingFormRebookContext | null;
+    submitLabel?: string | null;
+    successMessage?: string | null;
+    form?: BookingFormSourceRecord | null;
+    services?: BookingFormServicesSource | null;
+    spamProtectionEnabled?: boolean;
+    className?: string | null;
+}>;
+export declare const bookingFieldSchema: z.ZodType<BookingFormField>;
+export declare const bookingSettingsSchema: z.ZodType<BookingFormSettings>;
+export declare const bookingSourceFormSchema: z.ZodType<BookingFormSourceRecord>;
+export type AppointmentBookingRuntimeTarget = Readonly<{
+    kind: "appointment-form";
+    formId: string;
+    requestedServiceId: string | null;
+    requestedResourceId: string | null;
+    rebookContext: BookingFormRebookContext | null;
+}>;
+export type EventRegistrationRuntimeTarget = Readonly<{
+    kind: "event-occurrence";
+    occurrenceId: string;
+    seriesId: string | null;
+}> | Readonly<{
+    kind: "event-series";
+    seriesId: string;
+}>;
+export type BookingRuntimeTarget = AppointmentBookingRuntimeTarget | EventRegistrationRuntimeTarget;
+export type BookingRuntimeSourceLoadError = Readonly<{
+    kind: "appointments-disabled";
+    target: AppointmentBookingRuntimeTarget;
+}> | Readonly<{
+    kind: "source-not-found";
+    target: BookingRuntimeTarget;
+    source: "form" | "service" | "resource" | "event" | "occurrence";
+}> | Readonly<{
+    kind: "source-unavailable";
+    target: BookingRuntimeTarget;
+    reason: "appointments-disabled" | "missing-form" | "missing-services" | "stale-service" | "stale-resource" | "event-unavailable" | "occurrence-unavailable";
+}> | Readonly<{
+    kind: "invalid-source-data";
+    target: BookingRuntimeTarget;
+    issues: readonly string[];
+}> | Readonly<{
+    kind: "unsupported-target";
+    target: BookingRuntimeTarget;
+}>;
+export type BookingRuntimeSourceLoader<TLoaded> = Readonly<{
+    load: (target: BookingRuntimeTarget) => Promise<Readonly<{
+        ok: true;
+        value: TLoaded;
+    }> | Readonly<{
+        ok: false;
+        error: BookingRuntimeSourceLoadError;
+    }>>;
+}>;
+export type AppointmentBookingFormSourceInput = Readonly<{
+    id: string;
+    name: string;
+    schemaJson: unknown;
+    settingsJson: unknown;
+}>;
+export type AppointmentBookingFormSourceValidation = Readonly<{
+    ok: true;
+    value: BookingFormSourceRecord;
+}> | Readonly<{
+    ok: false;
+    issues: readonly string[];
+}>;
+export type AppointmentBookingServiceSourceInput = Readonly<{
+    id: string;
+    title: string;
+    description?: string | null;
+    durationMinutes?: number;
+    priceAmount?: number | null;
+    priceCurrency?: string | null;
+    paymentTerms?: BookingFormService["paymentTerms"];
+    paymentTermsAvailability?: BookingFormService["paymentTermsAvailability"];
+}>;
+export type AppointmentBookingSourceProps = BookingFormSourceProps & Readonly<{
+    siteId: string;
+    formId: string;
+    form: BookingFormSourceRecord;
+    services: BookingFormService[];
+    serviceId: string | null;
+    resourceId: string | null;
+    initialData: Readonly<Record<string, unknown>> | null;
+    noticeMessage: string | null;
+    requiresServiceSelection: boolean;
+    requiresResourceSelection: boolean;
+    shouldAutoSelectSingleResource: boolean;
+    rebookContext: BookingFormRebookContext | null;
+}>;
+export declare function buildAppointmentBookingRuntimeTarget(input: Readonly<{
+    formId?: string | null;
+    requestedServiceId?: string | null;
+    requestedResourceId?: string | null;
+    rebookContext?: BookingFormRebookContext | null;
+}>): AppointmentBookingRuntimeTarget;
+export declare function normalizeAppointmentBookingFormSource(input: Readonly<{
+    siteId: string;
+    form: AppointmentBookingFormSourceInput;
+}>): BookingFormSourceRecord;
+export declare function validateAppointmentBookingFormSource(input: Readonly<{
+    siteId: string;
+    form: AppointmentBookingFormSourceInput;
+}>): AppointmentBookingFormSourceValidation;
+export declare function normalizeAppointmentBookingServices(input: Readonly<{
+    siteId: string;
+    services: readonly AppointmentBookingServiceSourceInput[];
+}>): BookingFormService[];
+export declare function buildAppointmentBookingSourceProps(input: Readonly<{
+    siteId: string;
+    apiBaseUrl?: string;
+    portalToken?: string | null;
+    form: AppointmentBookingFormSourceInput;
+    services: readonly AppointmentBookingServiceSourceInput[];
+    serviceId: string | null;
+    resourceId: string | null;
+    initialData: Readonly<Record<string, unknown>> | null;
+    noticeMessage: string | null;
+    requiresServiceSelection: boolean;
+    requiresResourceSelection: boolean;
+    shouldAutoSelectSingleResource: boolean;
+    rebookContext: BookingFormRebookContext | null;
+}>): AppointmentBookingSourceProps;
+export declare function buildEventRegistrationRuntimeTarget(input: Readonly<{
+    kind: "event-occurrence";
+    occurrenceId: string;
+    seriesId?: string | null;
+}> | Readonly<{
+    kind: "event-series";
+    seriesId: string;
+}>): EventRegistrationRuntimeTarget;
+export declare function buildEventRegistrationSourceProps(input: Readonly<{
+    siteId: string;
+    apiBaseUrl?: string;
+    portalToken?: string | null;
+    occurrenceContext?: EventRegistrationSourceProps["occurrenceContext"];
+    contentEntry?: EventRegistrationContentEntry | null;
+    events?: readonly PublicEvent[] | null;
+    stage?: EventRegistrationSourceProps["stage"];
+    supportEmail?: string;
+}> & Omit<EventRegistrationSourceProps, "siteId" | "apiBaseUrl" | "portalToken" | "occurrenceContext" | "contentEntry" | "events" | "stage" | "supportEmail">): EventRegistrationSourceProps;

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration.interactive.d.ts

@@ -72,7 +72,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
             className: string | null;
             summaryButtonText: string;
         }>;
-        hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
+        hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint" | "buttonText">>;
     }>;
     contracts: Readonly<{
         source: Readonly<{
@@ -131,7 +131,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
                     className: string | null;
                     summaryButtonText: string;
                 }>;
-                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
+                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint" | "buttonText">>;
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                 display: Readonly<{
@@ -140,7 +140,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
                     className: string | null;
                     summaryButtonText: string;
                 }>;
-                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
+                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint" | "buttonText">>;
             }>>;
         }>;
     }>;
@@ -162,7 +162,7 @@ export declare const eventRegistrationInteractiveIslandPropsCodec: Readonly<{
                 className: string | null;
                 summaryButtonText: string;
             }>;
-            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
+            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint" | "buttonText">>;
         }>>;
     }>) => unknown;
     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<Readonly<{
@@ -181,7 +181,7 @@ export declare const eventRegistrationInteractiveIslandPropsCodec: Readonly<{
                 className: string | null;
                 summaryButtonText: string;
             }>;
-            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
+            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint" | "buttonText">>;
         }>>;
     }>>;
 }>;

package/dist/_dts/blocks/src/system/runtime/nodes/events/index.d.ts

@@ -7,5 +7,8 @@ export { EventListingSSR } from './EventListing.server';
 export { EventCalendarSSR } from './EventCalendar.server';
 export { EventCombinedSSR } from './EventCombined.server';
 export { EventListingClient } from './EventListing.client';
+export type { EventListingClientProps } from './EventListing.client';
 export { EventCalendarClient } from './EventCalendar.client';
+export type { EventCalendarClientProps } from './EventCalendar.client';
 export { EventCombinedClient, EventCombinedIslandClient } from './EventCombined.client';
+export type { EventCombinedClientProps, EventCombinedIslandClientProps, } from './EventCombined.client';

package/dist/_dts/blocks/src/system/runtime/nodes/header-section.client.d.ts

@@ -6,6 +6,7 @@ type HeaderSectionNodeProps = React.PropsWithChildren<{
     blockContent?: unknown;
     fragmentRegistry?: unknown;
     pathBase?: string;
+    "data-preview-site-chrome-surface"?: string;
     [key: string]: unknown;
 }>;
 /**

package/dist/_dts/blocks/src/system/runtime/nodes/header-section.server.d.ts

@@ -2,6 +2,7 @@ import React from "react";
 type HeaderSectionNodeProps = React.PropsWithChildren<{
     blockId?: string | null;
     className?: string;
+    "data-preview-site-chrome-surface"?: string;
     [key: string]: unknown;
 }>;
 /**

package/dist/_dts/blocks/src/system/runtime/shared/components/BookingOptionCompactRow.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import { type ThemeButtonVariantId } from '../../../../../../theme-core/src/buttons/index';
+export type BookingOptionMetaItem = Readonly<{
+    id?: string;
+    label: string;
+    icon?: React.ReactNode;
+    className?: string;
+}>;
+export type BookingOptionCompactRowAction = Readonly<{
+    kind: 'action';
+    label: string;
+    href: string;
+}> | Readonly<{
+    kind: 'status';
+    label: string;
+}>;
+export type BookingOptionCompactRowViewModel = Readonly<{
+    id: string;
+    title: string;
+    primaryMeta?: readonly string[];
+    secondaryMeta?: readonly BookingOptionMetaItem[];
+    priceLabel?: string | null;
+    action: BookingOptionCompactRowAction;
+}>;
+export type BookingOptionCompactRowProps = Readonly<{
+    option: BookingOptionCompactRowViewModel;
+    buttonVariant?: ThemeButtonVariantId;
+}>;
+export declare function BookingOptionCompactRow({ option, buttonVariant, }: BookingOptionCompactRowProps): React.ReactElement;

package/dist/_dts/blocks/src/system/runtime/shared/components/BookingOptionList.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { ThemeButtonVariantId } from '../../../../../../theme-core/src/buttons/index';
+import { type BookingOptionCompactRowViewModel } from './BookingOptionCompactRow';
+export type BookingOptionGroupViewModel = Readonly<{
+    id: string;
+    title: string;
+    options: readonly BookingOptionCompactRowViewModel[];
+}>;
+export type BookingOptionListProps = Readonly<{
+    groups: readonly BookingOptionGroupViewModel[];
+    buttonVariant?: ThemeButtonVariantId;
+}>;
+export declare function BookingOptionList({ groups, buttonVariant, }: BookingOptionListProps): React.ReactElement;

package/dist/_dts/blocks/src/system/runtime/shared/components/index.d.ts

@@ -6,6 +6,10 @@ export { ClockIcon } from './ClockIcon';
 export { CrossIcon } from './CrossIcon';
 export { ActionRow } from './ActionRow';
 export type { ActionRowProps } from './ActionRow';
+export { BookingOptionCompactRow } from './BookingOptionCompactRow';
+export type { BookingOptionCompactRowAction, BookingOptionCompactRowProps, BookingOptionCompactRowViewModel, BookingOptionMetaItem, } from './BookingOptionCompactRow';
+export { BookingOptionList } from './BookingOptionList';
+export type { BookingOptionGroupViewModel, BookingOptionListProps, } from './BookingOptionList';
 export { FieldValidationMessage, getFieldValidationControlProps, } from './FieldValidationMessage';
 export type { FieldValidationControlInput, FieldValidationControlProps, FieldValidationMessageProps, } from './FieldValidationMessage';
 export { FeedbackMessage } from './FeedbackMessage';

package/dist/_dts/blocks/src/system/runtime/shared/index.d.ts

@@ -5,7 +5,8 @@
  */
 export type { FormData, ButtonVariant } from './types';
 export { DEFAULT_CURRENCY } from './types';
-export { buildCheckoutReturnUrls, resolveDedicatedBookingPath, formatPrice, scrollToBlock, consumeSearchParam, consumeSearchParams, validateFormData, getStepNumber, } from './utils';
+export { BOOK_TARGET_PARAMS, buildCheckoutReturnUrls, resolveDedicatedBookingHref, resolveDedicatedBookingPath, resolveDedicatedBookingTarget, formatPrice, scrollToBlock, consumeSearchParam, consumeSearchParams, validateFormData, getStepNumber, } from './utils';
+export type { DedicatedBookingTarget, UniversalBookingRouteTarget, } from './utils';
 export { createBodyThemePortalRoot } from './utils';
-export { ActionRow, CheckIcon, ClockIcon, CrossIcon, FieldValidationMessage, FeedbackMessage, getFieldValidationControlProps, MembershipHero, ModalShell, StateIcon, StepIndicator, TerminalPanel, } from './components';
-export type { ActionRowProps, FieldValidationControlInput, FieldValidationControlProps, FieldValidationMessageProps, FeedbackLiveMode, FeedbackMessageProps, FeedbackTone, ModalShellProps, StepIndicatorBaseProps, StepIndicatorProps, TerminalPanelProps, TerminalPanelTitleElement, } from './components';
+export { ActionRow, BookingOptionCompactRow, BookingOptionList, CheckIcon, ClockIcon, CrossIcon, FieldValidationMessage, FeedbackMessage, getFieldValidationControlProps, MembershipHero, ModalShell, StateIcon, StepIndicator, TerminalPanel, } from './components';
+export type { ActionRowProps, BookingOptionCompactRowAction, BookingOptionCompactRowProps, BookingOptionCompactRowViewModel, BookingOptionGroupViewModel, BookingOptionListProps, BookingOptionMetaItem, FieldValidationControlInput, FieldValidationControlProps, FieldValidationMessageProps, FeedbackLiveMode, FeedbackMessageProps, FeedbackTone, ModalShellProps, StepIndicatorBaseProps, StepIndicatorProps, TerminalPanelProps, TerminalPanelTitleElement, } from './components';

package/dist/_dts/blocks/src/system/runtime/shared/utils/bookingRoute.d.ts

@@ -11,5 +11,25 @@ export type DedicatedBookingTarget = Readonly<{
     hostKey: string;
     siteIdentifier: string;
 }>;
+export type UniversalBookingRouteTarget = Readonly<{
+    kind: 'chooser';
+}> | Readonly<{
+    kind: 'appointment_service';
+    serviceId: string;
+    resourceId?: string | null;
+}> | Readonly<{
+    kind: 'event_occurrence';
+    occurrenceId: string;
+}> | Readonly<{
+    kind: 'event_series';
+    eventId: string;
+}>;
+export declare const BOOK_TARGET_PARAMS: {
+    readonly service: "service";
+    readonly resource: "resource";
+    readonly occurrence: "occurrence";
+    readonly event: "event";
+};
 export declare function resolveDedicatedBookingTarget(pathname: string): DedicatedBookingTarget;
 export declare function resolveDedicatedBookingPath(pathname: string): string;
+export declare function resolveDedicatedBookingHref(pathname: string, bookingTarget?: UniversalBookingRouteTarget): string;

package/dist/_dts/blocks/src/system/runtime/shared/utils/index.d.ts

@@ -2,7 +2,8 @@
  * Shared Utilities Barrel Export
  */
 export { buildCheckoutReturnUrls } from './checkoutUrls';
-export { resolveDedicatedBookingPath } from './bookingRoute';
+export { BOOK_TARGET_PARAMS, resolveDedicatedBookingHref, resolveDedicatedBookingPath, resolveDedicatedBookingTarget, } from './bookingRoute';
+export type { DedicatedBookingTarget, UniversalBookingRouteTarget, } from './bookingRoute';
 export { resolveDedicatedCheckoutPath } from './checkoutRoute';
 export { formatPrice } from './formatting';
 export { logoutPortal } from './portalLogout';

package/dist/_dts/blocks/src/system/types/link.d.ts

@@ -48,6 +48,17 @@ export type AuthoredLinkValue = InternalLinkValue | ExternalLinkValue | CustomLi
  * navigation-persistence converter accepts them.
  */
 export type LinkValue = AuthoredLinkValue;
+export type LinkReferenceVisitorContext = Readonly<{
+    routeIds: Readonly<{
+        add: (routeId: string) => void;
+    }>;
+    pageIdentifiers: Readonly<{
+        add: (identifier: string) => void;
+    }>;
+    entryIdentifiers: Readonly<{
+        add: (contentType: string, identifier: string) => void;
+    }>;
+}>;
 export declare const internalRouteOnlyLinkSchema: z.ZodObject<{
     kind: z.ZodLiteral<"internal">;
     routeId: z.ZodString;
@@ -133,4 +144,5 @@ export declare const linkSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.Zod
     contentType: z.ZodString;
     identifier: z.ZodString;
 }, z.core.$loose>]>;
+export declare function visitLinkValueReferences(value: unknown, visitor: LinkReferenceVisitorContext): void;
 export declare function isInternalResolvedLinkValue(value: LinkValue | null | undefined): value is InternalResolvedLinkValue;

package/dist/_dts/content-editor/src/hooks/validateBlocksForPublish.d.ts

@@ -5,6 +5,7 @@
  * This catches empty required fields and other validation errors that were allowed
  * during editing (draft mode) but must be fixed before publishing.
  */
+import type { FieldValidationDescriptor } from '../../../blocks/src/index';
 import type { EditorBlockId } from '../../../core/src/index';
 import type { EditorUiStoreInstance } from '../ui/editorUiStore';
 /**
@@ -17,6 +18,10 @@ export type BlockValidationError = {
     blockKind: string;
     /** The path to the invalid field (e.g., "title", "items.0.label") */
     fieldPath: string;
+    /** Manifest-derived metadata for the invalid field, when the path resolves to one */
+    fieldDescriptor: FieldValidationDescriptor | null;
+    /** Whether the field can be directly focused in the editor sidebar */
+    isFieldVisibleInSidebar: boolean;
     /** Human-readable label for the field */
     fieldLabel: string;
     /** The validation error message */

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

@@ -5,6 +5,7 @@ import { type Theme } from '../../blocks/src/index';
 import type { PageDesignEditorReadModel } from '../../theme-core/src/site-styles/index';
 import { type EditorStructuralCommand } from '../../core/src/index';
 import { type SdkConfigForBlockPicker } from './block-editor/sdkBlockMerger';
+import { type BlockActionControlMode } from './block-editor/actionControlMode';
 import { type ReorderControlMode } from './block-editor/reorderControlMode';
 import type { ArrayKeysManager, BlockEditorHandle, BlockItem, BlockFocusRequest, UiSlice, DraftsSlice } from './block-editor/types';
 import type { BlockDraftSaveability, FieldWidgetComponent } from '../../block-form/src/client/index';
@@ -52,6 +53,7 @@ export type BlockEditorProps = {
     enabledContentTypes?: string[];
     sdkConfig?: SdkConfigForBlockPicker | null;
     reorderControlMode?: ReorderControlMode;
+    actionControlMode?: BlockActionControlMode;
 };
 export declare const BlockEditor: import("react").ForwardRefExoticComponent<BlockEditorProps & import("react").RefAttributes<BlockEditorHandle>>;
 export {};

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

@@ -5,6 +5,7 @@ import type { SystemBlockDefinition } from '../../../blocks/src/index';
 import type { BlockDraftSaveability } from '../../../block-form/src/client/index';
 import type { FieldWidgetComponent } from '../../../block-form/src/client/index';
 import type { Theme } from '../../../blocks/src/index';
+import { type BlockActionControlMode } from './actionControlMode';
 import { type ReorderControlMode } from './reorderControlMode';
 import type { ArrayKeysManager, BlockFocusRequest, BlockItem, UiStore, DraftsSlice, UiSlice } from './types';
 /** Drag listener props from dnd-kit */
@@ -19,7 +20,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, reorderControlMode, }: {
+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, actionControlMode, }: {
     siteId: string;
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
@@ -44,5 +45,6 @@ export declare function BlockCard({ siteId, block, manifest, isFirst, isLast, is
     hideThemeV2RawStyleFields?: boolean;
     pageDesignBlock?: PageDesignEditorBlock | null;
     reorderControlMode?: ReorderControlMode;
+    actionControlMode?: BlockActionControlMode;
 }): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,6 +1,7 @@
 import type { SyntheticListenerMap } from '@dnd-kit/core/dist/hooks/utilities';
 import type { FieldWidgetComponent } from '../../../block-form/src/client/index';
 import { type SystemBlockDefinition, type Theme } from '../../../blocks/src/index';
+import { type BlockActionControlMode } from './actionControlMode';
 import type { ReorderControlMode } from './reorderControlMode';
 import type { BlockItem, UiStore, DraftsSlice, ArrayKeysManager } from './types';
 /** Drag listener props from dnd-kit */
@@ -9,7 +10,7 @@ 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, reorderControlMode, }: {
+export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, reorderControlMode, actionControlMode, }: {
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
     isFirst: boolean;
@@ -29,5 +30,6 @@ export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMo
     theme?: Theme | null;
     hideThemeV2RawStyleFields?: boolean;
     reorderControlMode?: ReorderControlMode;
+    actionControlMode?: BlockActionControlMode;
 }): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -6,12 +6,16 @@ type BlockSettingsModalStore = UiStore<{
     drafts: Pick<DraftsSlice, 'getBlockSnapshot' | 'getCurrentValues' | 'clearError' | 'setAtPath' | 'getAtPath'>;
     arrayKeys: ArrayKeysManager;
 }>;
-export declare function BlockSettingsModal({ block, manifest, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, }: {
+export declare function BlockSettingsModal({ block, manifest, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, showSettingsTrigger, open: controlledOpen, onOpenChange, onAvailabilityChange, }: {
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
     uiStore: BlockSettingsModalStore;
     widgetOverrides?: Record<string, FieldWidgetComponent>;
     theme?: Theme | null;
     hideThemeV2RawStyleFields?: boolean;
+    showSettingsTrigger?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    onAvailabilityChange?: (available: boolean) => void;
 }): ReactNode;
 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 '../../../block-form/src/client/index';
+import { type BlockActionControlMode } from './actionControlMode';
 import { type ReorderControlMode } from './reorderControlMode';
 export declare const SortableBlockItem: import("react").NamedExoticComponent<{
     siteId: string;
@@ -30,4 +31,5 @@ export declare const SortableBlockItem: import("react").NamedExoticComponent<{
     hideThemeV2RawStyleFields?: boolean;
     pageDesignBlock?: PageDesignEditorBlock | null;
     reorderControlMode?: ReorderControlMode;
+    actionControlMode?: BlockActionControlMode;
 }>;

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

@@ -0,0 +1,2 @@
+export type BlockActionControlMode = 'inline' | 'menu';
+export declare const DEFAULT_BLOCK_ACTION_CONTROL_MODE: BlockActionControlMode;

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

@@ -13,7 +13,7 @@ export { FormProvider } from './FormProvider';
 export type { FormProviderProps } from './FormProvider';
 export { buildBlockContentPayload, formatManifestIssues } from './blockPayload';
 export type { BlockContentPayloadResult, ManifestFieldIssue, BuildBlockContentPayloadOptions } from './blockPayload';
-export { deriveBlockDraftSaveability, formatUnfinishedBlocksSummary, normalizeManifestIssueMessage, shouldShowBlockFieldValidation, unfinishedBlockCopy, validateBlockManifestValues, } from '../../block-form/src/client/index';
+export { deriveBlockDraftSaveability, formatUnfinishedBlocksSummary, shouldShowBlockFieldValidation, unfinishedBlockCopy, validateBlockManifestValues, } from '../../block-form/src/client/index';
 export type { BlockDraftSaveability, BlockDraftValidationIssue } from '../../block-form/src/client/index';
 export { applyManifestIssuesToForm } from './manifestIssues';
 export { BlockPickerDialog } from './block-editor/BlockPickerDialog';

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

@@ -1,6 +1,16 @@
 import { default as React, type ReactNode } from 'react';
 export type SiteChromeEditableSurfaceKind = 'header' | 'footer';
-export declare function SiteChromeEditableSurface({ surface, children, }: {
+type SiteChromeEditableSurfaceProps = Readonly<{
     surface: SiteChromeEditableSurfaceKind;
     children: ReactNode;
-}): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+    /**
+     * Decorate a single custom React component root instead of wrapping it.
+     *
+     * Only use this when the component is known to forward className,
+     * data attributes, and children to its actual chrome root; otherwise the
+     * customize button and preview metadata can be swallowed by the component.
+     */
+    preserveSingleComponentRoot?: boolean;
+}>;
+export declare function SiteChromeEditableSurface({ surface, children, preserveSingleComponentRoot, }: SiteChromeEditableSurfaceProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+export {};

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

@@ -2,14 +2,32 @@ import { type ReactNode } from 'react';
 import type { Theme } from '../../../../blocks/src/index';
 import { type Rfc6902Op } from '../utils/rfc6902';
 type ThemePatchOp = Rfc6902Op;
+export type PreviewThemeOverlaySource = 'ai-designer' | 'site-chrome' | 'style-configurator' | 'unknown';
+type PreviewThemeOverlaySourceOptions = Readonly<{
+    source?: PreviewThemeOverlaySource;
+}>;
+export type PreviewThemeOverlay = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'patch';
+    source: PreviewThemeOverlaySource;
+    ops: readonly ThemePatchOp[];
+}> | Readonly<{
+    kind: 'theme';
+    source: PreviewThemeOverlaySource;
+    theme: Theme;
+}>;
 type PreviewThemeOverlayContextValue = {
     baseTheme: Theme;
+    overlay: PreviewThemeOverlay;
     overlayOps: ThemePatchOp[] | null;
-    setOverlayOps: (ops: ThemePatchOp[] | null) => void;
+    overlayOpsSource: PreviewThemeOverlaySource | null;
+    setOverlayOps: (ops: ThemePatchOp[] | null, options?: PreviewThemeOverlaySourceOptions) => void;
     overrideTheme: Theme | null;
-    setOverrideTheme: (theme: Theme | null) => void;
+    overrideThemeSource: PreviewThemeOverlaySource | null;
+    setOverrideTheme: (theme: Theme | null, options?: PreviewThemeOverlaySourceOptions) => void;
     effectiveTheme: Theme;
-    clearOverlay: () => void;
+    clearOverlay: (options?: PreviewThemeOverlaySourceOptions) => void;
 };
 export declare function PreviewThemeOverlayProvider({ baseTheme, children }: {
     baseTheme: Theme;

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

@@ -27,5 +27,5 @@ export { Layout } from './rendering/components/Layout';
 export type { LayoutProps, HeaderData, FooterData } from './rendering/components/Layout';
 export { PageRenderer, ThemeScope, buildThemeRuntime, RichText, resolveImageUrl, resolveImageUrlWithContext, resolveImageSourceSetWithContext, ImagePresets, } from './rendering';
 export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, CollectionContent, ColumnsContent, CourseDetailsContent, CourseRegistrationContent, CtaFullContent, EmbedContent, EventCalendarContent, EventDetailsContent, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FormBlockContent, GiftingContent, HeroContent, HeroMedia, ImageGalleryContent, MediaTextContent, NewsletterSignupContent, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, SystemBlockContentByKind, SystemBlockContentFor, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, VideoGridContent, ImageOptions, ResolveImageUrlContext, ResolveImageSourceSetOptions, ResolvedImageSourceSet, PageOutline, RouteMap, Theme, ThemeTokens, Media, TipTapNode, LinkValue, RichTextPrimitiveProps, } from './rendering';
-export type { BlockOverrideProps, BlockOverrideRegistration, BlockOverrideRegistrations, BlockOverrides, BlockOverrideComponent, KnownSystemBlockOverrides, LazyBlockOverrideFactory, LazyBlockOverrideRegistration, } from './rendering';
-export { defineLazyBlockOverride } from './rendering';
+export type { BlockOverrideProps, BlockOverrideRegistration, BlockOverrideRegistrations, BlockOverrides, BlockOverrideComponent, CustomBlockOverrideKey, KnownSystemBlockOverrides, KnownBlockOverrideKey, LazyBlockOverrideFactory, LazyBlockOverrideRegistration, StrictBlockOverrideRegistrations, StrictBlockOverrides, SystemBlockOverrideKey, } from './rendering';
+export { defineBlockOverrideRegistrations, defineBlockOverrides, defineLazyBlockOverride, } from './rendering';

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

@@ -456,6 +456,7 @@ export type EntriesResponse<TContent = Record<string, unknown>> = {
     entries: ContentEntryListItem<TContent>[];
     meta?: ListPublishedEntriesMeta;
     contentType?: PublicContentTypeMeta | null;
+    mediaAssets?: SdkRuntimeMediaAsset[];
 };
 export interface FormRecord {
     id: string;