@riverbankcms/sdk 0.91.0 → 0.93.0

package/dist/_dts/blocks/src/system/runtime/api/types.d.ts

@@ -116,6 +116,7 @@ export interface BookingSubmitRequest {
     customFields: Record<string, unknown>;
     timezone: string;
     discountCode?: string;
+    selectedSlidingAmount?: number;
     selectedCollectionOptionKind?: "upfront" | "deferred_manual" | "instalment_plan" | "flexible_balance";
     altchaSolution?: string | null;
     successUrl?: string;
@@ -212,6 +213,7 @@ export interface BookingService {
     title: string;
     description?: string;
     durationMinutes?: number;
+    pricing?: import("../nodes/booking-form.state").BookingFormServicePricing;
     priceAmount?: number | null;
     priceCurrency?: string | null;
     paymentTerms?: import("../../blocks/shared/bookingPaymentTerms").BlockBookingPaymentTerms;
@@ -339,6 +341,7 @@ export interface EventRegisterRequest {
     occurrenceId: string;
     attendanceMode?: 'in_person' | 'online';
     ticketTypeId?: string;
+    selectedSlidingAmount?: number;
     email: string;
     name: string;
     ticketsCount: number;
@@ -424,6 +427,7 @@ export interface EligibilityCheckRequest {
     occurrenceId: string;
     attendanceMode?: 'in_person' | 'online';
     ticketTypeId?: string;
+    selectedSlidingAmount?: number;
     email: string;
     ticketsCount: number;
 }
@@ -436,7 +440,7 @@ export interface EligibilityCheckResponse {
         membership: EligibleMembership | null;
         passes: EligiblePass[];
         requiresPayment: boolean;
-        pricingMode?: "single" | "ticket_types";
+        pricingMode?: "single" | "ticket_types" | "sliding_scale";
         selectedTicketTypeId?: string | null;
         ticketTypes?: EligibilityEventTicketType[];
         eventPrice: number | null;
@@ -469,6 +473,7 @@ export interface CourseEnrollRequest {
     siteId: string;
     courseId: string;
     pricingOptionId?: string;
+    selectedSlidingAmount?: number;
     email: string;
     name: string;
     phone?: string;
@@ -528,6 +533,7 @@ export interface CourseCheckoutRequest {
     siteId: string;
     courseId: string;
     pricingOptionId?: string;
+    selectedSlidingAmount?: number;
     email: string;
     name: string;
     phone?: string;
@@ -744,6 +750,7 @@ export type UnifiedCheckoutItem = {
     type: "course_enrollment";
     courseId: string;
     pricingOptionId?: string;
+    selectedSlidingAmount?: number;
     attendeeInfo: {
         email: string;
         name: string;

package/dist/_dts/blocks/src/system/runtime/hooks/useHeadlessBookingFlow.d.ts

@@ -3,7 +3,7 @@ import { type BlockApiConfig } from "../api";
 import type { AutoAppliedDiscountPreview } from "../api/types";
 import type { BookingFormConfig, BookingFormData, BookingFormService, BookingSelectedCollectionOptionKind } from "../nodes/booking-form.state";
 import { type BookingPaymentSelectionViewModel } from "../shared/bookingPaymentOptions";
-import { createBookingBlockApiConfig, type BookingAppointmentPackagesModel, type BookingFieldValue, type BookingFieldView, type BookingFlowActionResult, type BookingFlowFeedback, type BookingFlowStatus, type BookingFlowView, type BookingResourceView, type BookingFlowStep, type BookingFlowStepId, type BookingSlotSelection, type BookingSlotView, type BookingSubmitActionResult, type BookingSubmitOptions, type LoadState } from "./useHeadlessBookingFlow.state";
+import { createBookingBlockApiConfig, type BookingAppointmentPackagesModel, type BookingFieldValue, type BookingFieldView, type BookingFlowActionResult, type BookingFlowFeedback, type BookingFlowStatus, type BookingFlowView, type BookingResourceView, type BookingFlowStep, type BookingFlowStepId, type BookingSlotSelection, type BookingSlotView, type BookingSubmitActionResult, type BookingSubmitOptions, getBookingServiceSlidingScale, type LoadState } from "./useHeadlessBookingFlow.state";
 export type { BlockApiConfig };
 export type { BookingAppointmentPackagesModel };
 export { createBookingBlockApiConfig };
@@ -61,6 +61,9 @@ export type BookingPaymentModel = Readonly<{
     selection: null;
     selectedCollectionOptionKind?: BookingSelectedCollectionOptionKind;
     selectedAppointmentPackageId?: string;
+    selectedSlidingAmountInput: string;
+    selectedSlidingAmount: number | null;
+    slidingScale: ReturnType<typeof getBookingServiceSlidingScale>;
     appointmentPackages: BookingAppointmentPackagesModel;
     errorMessage: string;
 }> | Readonly<{
@@ -69,6 +72,9 @@ export type BookingPaymentModel = Readonly<{
     selection: BookingPaymentSelectionViewModel | null;
     selectedCollectionOptionKind?: BookingSelectedCollectionOptionKind;
     selectedAppointmentPackageId?: string;
+    selectedSlidingAmountInput: string;
+    selectedSlidingAmount: number | null;
+    slidingScale: ReturnType<typeof getBookingServiceSlidingScale>;
     appointmentPackages: BookingAppointmentPackagesModel;
 }>;
 export type BookingDiscountModel = Readonly<{
@@ -101,6 +107,7 @@ export type BookingFlowActions = Readonly<{
     markFieldTouched: (fieldId: string) => void;
     selectPaymentOption: (kind: BookingSelectedCollectionOptionKind | null) => void;
     selectAppointmentPackage: (packageId: string | null) => void;
+    setSlidingAmountInput: (value: string) => void;
     setDiscountCode: (code: string) => void;
     clearDiscountCode: () => void;
     setAltchaSolution: (solution: string | null) => void;

package/dist/_dts/blocks/src/system/runtime/hooks/useHeadlessBookingFlow.state.d.ts

@@ -1,2 +1,3 @@
 export { unsafeAsBookingFieldId, bookingFlowReducer, buildBookingAvailabilityQuery, buildBookingStepPlan, buildBookingSubmitPlan, createBookingBlockApiConfig, createEmptyBookingValidationErrors, createFieldBookingValidationErrors, createFormBookingValidationError, createInitialBookingFlowReducerState, describeUnknownError, deriveBookingFieldViews, deriveBookingFlowSteps, getAppointmentBookingOverrideInput, hasBookingValidationErrors, resolveAppointmentPackagesModel, resolveAvailabilitySelectionInvalidation, resolveHeadlessBookingStatus, resolveHeadlessBookingView, toBookingFormData, toBookingSlotView, toBookingSlotViews, toOptionalAppointmentResourceId, toOptionalAppointmentServiceId, validateBookingField, validateBookingFields, validateBookingStep, } from "../nodes/booking-form.headless.state";
+export { formatBookingCentsAsCurrencyInput, getBookingServiceSlidingScale, parseBookingCurrencyInputToCents, } from "../nodes/booking-form.state";
 export type { AppointmentBookingOverrideData, AppointmentBookingOverrideInput, AppointmentBookingOverrideInputResult, AppointmentBookingOverridePropsLike, BookingAvailabilityQuery, BookingAppointmentPackagesModel, BookingAppointmentPackagesUnavailableReason, BookingFieldId, BookingFieldValue, BookingFieldView, BookingFlowActionResult, BookingFlowFeedback, BookingFlowStatus, BookingFlowStep, BookingFlowStepId, BookingFlowView, BookingResourceView, BookingSlotSelection, BookingSlotView, BookingSubmitActionResult, BookingSubmitOptions, BookingValidationErrors, DerivedBookingFlowSteps, DeriveBookingFlowStepsInput, LoadState, } from "../nodes/booking-form.headless.state";

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

@@ -167,6 +167,7 @@ export type BookingFlowReducerState = Readonly<{
     fieldValues: Readonly<Record<string, BookingFieldValue>>;
     touchedFields: Readonly<Record<string, boolean>>;
     discountCode: string;
+    selectedSlidingAmountInput: string;
     selectedCollectionOptionKind?: BookingSelectedCollectionOptionKind;
     selectedAppointmentPackageId?: CustomerPassId;
     altchaSolution: string | null;
@@ -195,6 +196,9 @@ export type BookingFlowEvent = Readonly<{
 }> | Readonly<{
     type: "payment-option-selected";
     kind: BookingSelectedCollectionOptionKind | null;
+}> | Readonly<{
+    type: "sliding-amount-changed";
+    value: string;
 }> | Readonly<{
     type: "appointment-package-selected";
     packageId: CustomerPassId | null;

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

@@ -152,6 +152,14 @@ export declare const bookingFormBlockRuntime: Readonly<{
                 title: string;
                 description?: string;
                 durationMinutes?: number;
+                pricing?: Readonly<{
+                    pricingStrategy: "free" | "single" | "tiered" | "sliding_scale";
+                    currency: string;
+                    singlePriceAmount?: number | null;
+                    slidingMinAmount?: number | null;
+                    slidingMaxAmount?: number | null;
+                    slidingSuggestedAmount?: number | null;
+                }>;
                 priceAmount?: number | null;
                 priceCurrency?: string | null;
                 paymentTerms?: import("../../blocks/shared/bookingPaymentTerms").BlockBookingPaymentTerms;
@@ -348,6 +356,14 @@ export declare const bookingFormBlockRuntime: Readonly<{
                         title: string;
                         description?: string;
                         durationMinutes?: number;
+                        pricing?: Readonly<{
+                            pricingStrategy: "free" | "single" | "tiered" | "sliding_scale";
+                            currency: string;
+                            singlePriceAmount?: number | null;
+                            slidingMinAmount?: number | null;
+                            slidingMaxAmount?: number | null;
+                            slidingSuggestedAmount?: number | null;
+                        }>;
                         priceAmount?: number | null;
                         priceCurrency?: string | null;
                         paymentTerms?: import("../../blocks/shared/bookingPaymentTerms").BlockBookingPaymentTerms;
@@ -424,6 +440,14 @@ export declare const bookingFormBlockRuntime: Readonly<{
                         title: string;
                         description?: string;
                         durationMinutes?: number;
+                        pricing?: Readonly<{
+                            pricingStrategy: "free" | "single" | "tiered" | "sliding_scale";
+                            currency: string;
+                            singlePriceAmount?: number | null;
+                            slidingMinAmount?: number | null;
+                            slidingMaxAmount?: number | null;
+                            slidingSuggestedAmount?: number | null;
+                        }>;
                         priceAmount?: number | null;
                         priceCurrency?: string | null;
                         paymentTerms?: import("../../blocks/shared/bookingPaymentTerms").BlockBookingPaymentTerms;
@@ -512,6 +536,14 @@ export declare const bookingFormInteractiveIslandPropsCodec: Readonly<{
                     title: string;
                     description?: string;
                     durationMinutes?: number;
+                    pricing?: Readonly<{
+                        pricingStrategy: "free" | "single" | "tiered" | "sliding_scale";
+                        currency: string;
+                        singlePriceAmount?: number | null;
+                        slidingMinAmount?: number | null;
+                        slidingMaxAmount?: number | null;
+                        slidingSuggestedAmount?: number | null;
+                    }>;
                     priceAmount?: number | null;
                     priceCurrency?: string | null;
                     paymentTerms?: import("../../blocks/shared/bookingPaymentTerms").BlockBookingPaymentTerms;
@@ -597,6 +629,14 @@ export declare const bookingFormInteractiveIslandPropsCodec: Readonly<{
                     title: string;
                     description?: string;
                     durationMinutes?: number;
+                    pricing?: Readonly<{
+                        pricingStrategy: "free" | "single" | "tiered" | "sliding_scale";
+                        currency: string;
+                        singlePriceAmount?: number | null;
+                        slidingMinAmount?: number | null;
+                        slidingMaxAmount?: number | null;
+                        slidingSuggestedAmount?: number | null;
+                    }>;
                     priceAmount?: number | null;
                     priceCurrency?: string | null;
                     paymentTerms?: import("../../blocks/shared/bookingPaymentTerms").BlockBookingPaymentTerms;

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

@@ -1,5 +1,5 @@
 export declare const APPOINTMENT_BOOKING_BLOCK_ID: "block.appointment-booking";
-export declare const BOOKING_FORM_DATA_RESERVED_KEY_VALUES: readonly ["serviceId", "resourceId", "selectedDate", "selectedSlot", "discountCode", "selectedCollectionOptionKind", "selectedAppointmentPackageId"];
+export declare const BOOKING_FORM_DATA_RESERVED_KEY_VALUES: readonly ["serviceId", "resourceId", "selectedDate", "selectedSlot", "discountCode", "selectedSlidingAmountInput", "selectedCollectionOptionKind", "selectedAppointmentPackageId"];
 export type BookingFormDataReservedKey = (typeof BOOKING_FORM_DATA_RESERVED_KEY_VALUES)[number];
 export type BookingReservedFieldCollision = Readonly<{
     fieldId: BookingFormDataReservedKey;

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

@@ -61,12 +61,21 @@ type BlockBookingPaymentTermsAvailability = Readonly<{
     paymentTerms: BlockBookingPaymentTerms;
     reason: "online_payment_configured_before_launch";
 }>;
+export type BookingFormServicePricing = Readonly<{
+    pricingStrategy: "free" | "single" | "tiered" | "sliding_scale";
+    currency: string;
+    singlePriceAmount?: number | null;
+    slidingMinAmount?: number | null;
+    slidingMaxAmount?: number | null;
+    slidingSuggestedAmount?: number | null;
+}>;
 export type BookingFormService = Readonly<{
     id: string;
     siteId: string;
     title: string;
     description?: string;
     durationMinutes?: number;
+    pricing?: BookingFormServicePricing;
     priceAmount?: number | null;
     priceCurrency?: string | null;
     paymentTerms?: BlockBookingPaymentTerms;
@@ -85,6 +94,7 @@ export type BookingFormData<TCustomFieldId extends string = never> = Readonly<{
     selectedDate?: string;
     selectedSlot?: string;
     discountCode?: string;
+    selectedSlidingAmountInput?: string;
     selectedCollectionOptionKind?: BookingSelectedCollectionOptionKind;
     selectedAppointmentPackageId?: string;
 }> & BookingCustomFieldData<TCustomFieldId>;
@@ -101,6 +111,7 @@ type BookingSubmissionCommon = Readonly<{
 export type BookingSubmissionData = (BookingSubmissionCommon & Readonly<{
     kind: "standard";
     discountCode?: string;
+    selectedSlidingAmount?: number;
     selectedCollectionOptionKind?: BookingSelectedCollectionOptionKind;
     altchaSolution?: string | null;
     successUrl?: string;
@@ -111,6 +122,12 @@ export type BookingSubmissionData = (BookingSubmissionCommon & Readonly<{
 }>);
 export type BookingPaymentStepMode = "hidden" | "disclosure_only" | "choice_required" | "unsupported";
 type BookingPaymentSelectionMode = "implicit_upfront" | "implicit_deferred_manual" | "implicit_instalment_plan" | "implicit_flexible_balance" | "choice_required" | "pending_stripe_setup" | "unsupported";
+export type BookingServiceSlidingScale = Readonly<{
+    minAmount: number;
+    maxAmount: number;
+    suggestedAmount: number | null;
+    currency: string;
+}>;
 export type BookingPaymentStepResolution = Readonly<{
     mode: BookingPaymentStepMode;
     service: BookingFormService | null;
@@ -169,6 +186,14 @@ export type BookingSubmissionPreparationError = Readonly<{
     tag: "payment-option-required";
     serviceId: string;
     serviceTitle: string;
+}> | Readonly<{
+    tag: "sliding-amount-required";
+    serviceId: string;
+    serviceTitle: string;
+}> | Readonly<{
+    tag: "sliding-amount-out-of-range";
+    serviceId: string;
+    serviceTitle: string;
 }> | Readonly<{
     tag: "payment-option-unsupported";
     serviceId: string;
@@ -206,6 +231,10 @@ export declare function resolveBookingSiteId(siteId: string | undefined, form: B
 export declare function normalizeBookingFormConfig(form: unknown): BookingFormConfig | null;
 export declare function normalizeBookingServices(services: unknown): readonly BookingFormService[];
 export declare function toSelectedCollectionOptionKind(value: unknown): BookingSelectedCollectionOptionKind | undefined;
+export declare function getBookingServiceSlidingScale(service: BookingFormService | null | undefined): BookingServiceSlidingScale | null;
+export declare function parseBookingCurrencyInputToCents(value: string | undefined): number | null;
+export declare function formatBookingCentsAsCurrencyInput(amount: number): string;
+export declare function isBookingServiceSlidingAmountInRange(slidingScale: BookingServiceSlidingScale, selectedAmount: number | null): selectedAmount is number;
 export declare function getBookingServicePaymentSelectionMode(service: BookingFormService | undefined): BookingPaymentSelectionMode;
 export declare function resolveDefaultBookingServiceId(formConfig: BookingFormConfig | null | undefined, services: readonly BookingFormService[]): string | null;
 export declare function resolveBookingSelectedService(input: Readonly<{

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

@@ -91,6 +91,7 @@ export type AppointmentBookingServiceSourceInput = Readonly<{
     title: string;
     description?: string | null;
     durationMinutes?: number;
+    pricing?: BookingFormService["pricing"];
     priceAmount?: number | null;
     priceCurrency?: string | null;
     paymentTerms?: BookingFormService["paymentTerms"];

package/dist/_dts/blocks/src/system/runtime/nodes/course-registration/components.d.ts

@@ -27,6 +27,12 @@ interface CoursePricingSelectorProps {
     onSelect: (pricingOptionId: string) => void;
 }
 export declare function CoursePricingSelector({ pricing, selectedPricingOptionId, onSelect, }: CoursePricingSelectorProps): React.JSX.Element | null;
+interface CourseSlidingScaleInputProps {
+    pricing: ResolvedCoursePricingState;
+    value: string;
+    onChange: (value: string) => void;
+}
+export declare function CourseSlidingScaleInput({ pricing, value, onChange, }: CourseSlidingScaleInputProps): React.JSX.Element | null;
 interface EnrollmentFormProps {
     formData: FormData;
     errors: Partial<Record<keyof FormData, string>>;

package/dist/_dts/blocks/src/system/runtime/nodes/course-registration/useCourseRegistrationWizard.d.ts

@@ -10,12 +10,20 @@ export declare function useCourseRegistrationWizard(props: CourseRegistrationCli
     selectedCourse: PublicCourse | null;
     selectedPricingOptionId: string | null;
     setSelectedPricingOptionId: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    selectedSlidingAmountInput: string;
+    setSelectedSlidingAmountInput: import("react").Dispatch<import("react").SetStateAction<string>>;
     selectedCoursePricing: Readonly<{
         currency: string;
         display: import("../../../blocks/courses/shared").CoursePriceDisplay;
         selectableOptions: readonly import("../../../blocks/courses/shared").CoursePricingOption[];
         requiresSelection: boolean;
         selectedOption: import("../../../blocks/courses/shared").CoursePricingOption | null;
+        slidingScale: Readonly<{
+            minAmount: number;
+            maxAmount: number;
+            suggestedAmount: number | null;
+        }> | null;
+        selectedSlidingAmount: number | null;
         selectedPriceAmount: number | null;
         selectedRequiresPayment: boolean;
         hasPaidSelection: boolean;

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

@@ -9,6 +9,14 @@ type TicketSelectionStepProps = {
     maxTickets: number;
     selectedTicketTypeId?: string | null;
     onTicketTypeChange?: (ticketTypeId: string) => void;
+    slidingScale?: Readonly<{
+        minAmount: number;
+        maxAmount: number;
+        suggestedAmount: number | null;
+    }> | null;
+    selectedSlidingAmountInput?: string;
+    slidingScaleSelectionMessage?: string | null;
+    onSlidingAmountChange?: (amount: string) => void;
     onTicketsChange: (count: number) => void;
 };
 /**

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

@@ -41,6 +41,7 @@ export declare function useEligibility(params: {
     occurrenceId: string;
     attendanceMode?: 'in_person' | 'online' | null;
     ticketTypeId: string | null;
+    selectedSlidingAmount?: number | null;
     email: string;
     ticketsCount: number;
 }): UseEligibilityResult;

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

@@ -43,7 +43,7 @@ export type EligibilityData = {
     /** Whether the selected event/ticket type currently requires payment. */
     requiresPayment: boolean;
     /** Persisted pricing mode for the underlying event series. */
-    pricingMode?: 'single' | 'ticket_types';
+    pricingMode?: 'single' | 'ticket_types' | 'sliding_scale';
     /** Selected ticket type echoed back from the eligibility API, if any. */
     selectedTicketTypeId?: string | null;
     /** Public ticket types available for selection in ticket-type mode. */

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

@@ -26,6 +26,7 @@ export declare function useEventRegistrationSubmit(options: {
     registrationTarget: RegistrationTarget | null;
     selectedAttendanceMode: 'in_person' | 'online' | null;
     selectedTicketTypeId: string | null;
+    selectedSlidingAmount: number | null;
     ticketsCount: number;
     formData: FormData;
     altchaSolution: string | null;

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

@@ -50,6 +50,15 @@ export declare function useEventRegistrationWizard(options: {
     setSelectedAttendanceMode: import("react").Dispatch<import("react").SetStateAction<"in_person" | "online" | null>>;
     selectedTicketTypeId: string | null;
     setSelectedTicketTypeId: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    selectedSlidingAmountInput: string;
+    setSelectedSlidingAmountInput: import("react").Dispatch<import("react").SetStateAction<string>>;
+    selectedSlidingAmount: number | null;
+    selectedEventSlidingScale: Readonly<{
+        minAmount: number;
+        maxAmount: number;
+        suggestedAmount: number | null;
+    }> | null;
+    slidingScaleSelectionMessage: string | null;
     selectedTicketType: import("./utils").SelectableEventTicketType | null;
     visibleTicketTypes: import("./utils").SelectableEventTicketType[];
     ticketTypeSelectionRequired: boolean;

package/dist/_dts/content-editor/src/controller/EntryControllerProvider.d.ts

@@ -1,15 +1,15 @@
-import { type ContentEntrySnapshot, type ContentTypeSchema, type ToolbarState } from "../../../content-model/src/index";
-import type { EditorBlockId } from "../../../core/src/index";
-import type { BlockItem } from "../../../editor-blocks/src/block-editor/types";
-import { type ReactNode } from "react";
-import { type PublishOptions } from "../hooks/useEntryActions";
-import { type ApiClient } from "../services";
-import type { DraftWorkflowStatus } from "../types";
-import { type EditorUiState } from "../ui/editorUiStore";
-import type { ResolveBlockManifest } from "../ui/blockValidationView";
+import { type ContentEntrySnapshot, type ContentTypeSchema, type ToolbarState } from '../../../content-model/src/index';
+import type { EditorBlockId } from '../../../core/src/index';
+import type { BlockItem } from '../../../editor-blocks/src/block-editor/types';
+import { type ReactNode } from 'react';
+import { type PublishOptions } from '../hooks/useEntryActions';
+import { type ApiClient } from '../services';
+import type { DraftWorkflowStatus } from '../types';
+import { type EditorUiState } from '../ui/editorUiStore';
+import type { ResolveBlockManifest } from '../ui/blockValidationView';
 export type EntryControllerBlocksSlice = {
     list: BlockItem[];
-    status: "idle" | "loading" | "error";
+    status: 'idle' | 'loading' | 'error';
     actions: {
         setList: (next: BlockItem[]) => void;
     };
@@ -75,7 +75,7 @@ type BaseInternalProps = {
     entityLabel?: string | null;
     initialEntry?: ContentEntrySnapshot | null;
     /** Autosave mode (default: auto). Manual disables background autosave triggers. */
-    saveMode?: "auto" | "manual";
+    saveMode?: 'auto' | 'manual';
     /** Initial content values for content entries - used to hydrate content store */
     initialContent?: Record<string, unknown> | null;
     /** Published content values for content entries - used to detect unpublished changes */
@@ -85,13 +85,13 @@ type BaseInternalProps = {
     resolveBlockManifest?: ResolveBlockManifest;
 };
 type PageInternalProps = BaseInternalProps & {
-    kind: "page";
-    initialStatus?: "draft" | "scheduled" | "published";
+    kind: 'page';
+    initialStatus?: 'draft' | 'scheduled' | 'published';
 } & {
     initialBlocks?: BlockItem[];
 };
 type ContentInternalProps = BaseInternalProps & {
-    kind: "content";
+    kind: 'content';
     initialBlocks?: BlockItem[];
 };
 type EntryControllerProviderProps = PageInternalProps | ContentInternalProps;

package/dist/_dts/content-editor/src/controller/useEntrySyncHelpers.d.ts

@@ -22,7 +22,7 @@ export declare function useEntrySyncHelpers({ uiStore, setErrorMessage, }: UseEn
     resetFromSnapshot: (snapshot: {
         baseline: Record<string, unknown>;
         values: Record<string, unknown>;
-    }, _resetOptions?: unknown) => void;
+    }) => void;
     handleMetadataAutosaveSuccess: (nextEntry: ContentEntrySnapshot) => void;
     markAutosaveError: (error: unknown) => string;
 };

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

@@ -1,12 +1,12 @@
-import { type ContentEntrySnapshot, type RoutingHelpers } from "../../../content-model/src/index";
-import type { EditorUiStoreInstance } from "../ui/editorUiStore";
-import type { PublishEntryResult } from "../services/contentEntryServices";
+import { type ContentEntrySnapshot, type RoutingHelpers } from '../../../content-model/src/index';
+import type { EditorUiStoreInstance } from '../ui/editorUiStore';
+import type { PublishEntryResult } from '../services/contentEntryServices';
 /** Services interface for entry operations */
 export type EntryServices = {
     deleteEntry: () => Promise<void>;
 };
 export type PublishOptions = {
-    mode?: "default" | "now";
+    mode?: 'default' | 'now';
 };
 /** Definition with services */
 export type EntryDefinition = {
@@ -15,16 +15,6 @@ export type EntryDefinition = {
         buildPayload?: (values: Record<string, unknown>, entry: ContentEntrySnapshot) => unknown;
     };
 };
-/**
- * Options for resetting from snapshot.
- */
-export type ResetFromSnapshotOptions = {
-    /**
-     * When true, preserves current form values after reset.
-     * Useful after publish to keep the UI showing the just-published values.
-     */
-    keepValues?: boolean;
-};
 export type EntryActionsOptions<TEntry extends ContentEntrySnapshot> = {
     /** Current entry snapshot */
     entry: TEntry;
@@ -55,7 +45,7 @@ export type EntryActionsOptions<TEntry extends ContentEntrySnapshot> = {
     resetFromSnapshot: (snapshot: {
         baseline: Record<string, unknown>;
         values: Record<string, unknown>;
-    }, resetOptions?: ResetFromSnapshotOptions) => void;
+    }) => void;
     /** Function to set error message */
     setErrorMessage: (message: string | null) => void;
 };

package/dist/_dts/content-editor/src/ui/editorSnapshot.d.ts

@@ -59,6 +59,40 @@ export type EditorValueSnapshot<TValue extends EditorValueRecord | null> = Reado
     publishedBaseline: TValue;
     syncState: EditorSyncState;
 }>;
+export type EditorValuePublicationState<TValue extends EditorValueRecord | null> = Readonly<{
+    kind: 'empty';
+    hasUnpublishedChanges: false;
+}> | Readonly<{
+    kind: 'unpublished-draft';
+    current: Exclude<TValue, null>;
+    hasUnpublishedChanges: true;
+}> | Readonly<{
+    kind: 'published-clean';
+    published: Exclude<TValue, null>;
+    hasUnpublishedChanges: false;
+}> | Readonly<{
+    kind: 'published-missing-current';
+    published: Exclude<TValue, null>;
+    hasUnpublishedChanges: true;
+}> | Readonly<{
+    kind: 'published-with-unpublished-changes';
+    current: Exclude<TValue, null>;
+    published: Exclude<TValue, null>;
+    hasUnpublishedChanges: true;
+}>;
+export declare function deriveEditorValuePublicationState<TValue extends EditorValueRecord | null>(snapshot: EditorValueSnapshot<TValue>): EditorValuePublicationState<TValue>;
+export type EditorPublishSuccessTransition = Readonly<{
+    metadata: Readonly<{
+        baseline: EditorMetadataValues | null;
+        current: EditorMetadataValues | null;
+        published: EditorMetadataValues | null;
+    }>;
+    content: Readonly<{
+        published: EditorContentValues | null;
+        versionAtPublishStart: number;
+    }>;
+    blockPublishedBaselines: readonly BlockPublishedBaselineInput[] | null;
+}>;
 type EditorMetadataSnapshot = EditorValueSnapshot<EditorMetadataValues | null>;
 type EditorContentSnapshot = EditorValueSnapshot<EditorContentValues | null>;
 export type EditorLinkedEntryMeta = Readonly<{
@@ -150,6 +184,9 @@ export type EditorSystemOperation = {
 } | {
     type: 'set-content-published-baseline';
     published: EditorContentValues | null;
+} | {
+    type: 'apply-publish-success';
+    transition: EditorPublishSuccessTransition;
 } | {
     type: 'autosave-metadata-succeeded';
     savedValues: EditorMetadataValues | null;
@@ -242,6 +279,7 @@ export declare function hydrateMetadataSnapshot(snapshot: EditorHistorySnapshot,
 export declare function hydrateContentSnapshot(snapshot: EditorHistorySnapshot, baseline: EditorContentValues | null, current?: EditorContentValues | null, published?: EditorContentValues | null): EditorHistorySnapshot;
 export declare function setMetadataPublishedBaseline(snapshot: EditorHistorySnapshot, published: EditorMetadataValues | null): EditorHistorySnapshot;
 export declare function setContentPublishedBaseline(snapshot: EditorHistorySnapshot, published: EditorContentValues | null): EditorHistorySnapshot;
+export declare function applyPublishSuccessTransition(snapshot: EditorHistorySnapshot, transition: EditorPublishSuccessTransition): EditorHistorySnapshot;
 export declare function autosaveMetadataSucceeded(snapshot: EditorHistorySnapshot, savedValues: EditorMetadataValues | null, acknowledgedVersion: number): EditorHistorySnapshot;
 export declare function autosaveContentSucceeded(snapshot: EditorHistorySnapshot, savedValues: EditorContentValues | null, acknowledgedVersion: number): EditorHistorySnapshot;
 export declare function autosaveMetadataFailed(snapshot: EditorHistorySnapshot, message?: string): EditorHistorySnapshot;
@@ -271,4 +309,12 @@ export declare function replaceEditorBlockList(snapshot: EditorHistorySnapshot,
 export declare function getDraftSnapshot(snapshot: EditorHistorySnapshot, blockId: string): EditorDraftSnapshot | null;
 export declare function inspectDrafts(snapshot: EditorHistorySnapshot): EditorDraftSnapshot[];
 export declare function getLinkedEntrySnapshot(snapshot: EditorHistorySnapshot, entryId: string): EditorLinkedEntrySnapshot | null;
+export type EditorDraftUnpublishedBlockChange = Readonly<{
+    blockId: EditorBlockId;
+    kind: string;
+    reason: 'missing_published' | 'missing_current' | 'different';
+    currentContent: EditorBlockValues | null;
+    publishedContent: EditorBlockValues | null;
+}>;
+export declare function getFirstUnpublishedDraftChange(snapshot: EditorHistorySnapshot): EditorDraftUnpublishedBlockChange | null;
 export declare function hasUnpublishedDraftChanges(snapshot: EditorHistorySnapshot): boolean;