@riverbankcms/sdk 0.143.0 → 0.144.0

package/dist/_dts/api/src/billing.d.ts

@@ -109,7 +109,7 @@ export type StripeConnectDisconnectResponse = {
     success: boolean;
     message: string;
 };
-export declare function changePlan(apiClient: ApiClient, { attemptId, planId, interval, prorationBehavior, options, }: ChangePlanRequest & {
+export declare function changePlan(apiClient: ApiClient, request: ChangePlanRequest & {
     options?: RequestInit;
 }): Promise<ChangePlanResponse>;
 export declare function createBillingPortalSession(apiClient: ApiClient, options?: RequestInit): Promise<BillingPortalSessionResponse>;

package/dist/_dts/api/src/billingEndpointTypes.d.ts

@@ -4,17 +4,23 @@ import type { APIEndpoint } from './apiEndpointTypes';
 import type { BillingPortalSessionResponse } from './billing';
 export type ChangePlanRequest = Readonly<{
     attemptId: string;
+}> & (Readonly<{
+    intent: 'change_plan';
     planId: string;
     interval: 'monthly';
     prorationBehavior?: 'create_prorations' | 'always_invoice' | 'none';
-}>;
+}> | Readonly<{
+    intent: 'reverse_cancellation';
+}>);
 export type ChangePlanResponse = Readonly<{
     membership: MembershipSummary | null;
 }>;
-export type AdminChangePlanRequest = Readonly<Omit<ChangePlanRequest, 'interval' | 'attemptId'> & {
+export type AdminChangePlanRequest = Readonly<{
     attemptId?: string;
     userId: string;
+    planId: string;
     interval: BillingInterval;
+    prorationBehavior?: 'create_prorations' | 'always_invoice' | 'none';
     reason?: string;
     bypassProration?: boolean;
 }>;

package/dist/_dts/api/src/bookingConfig.d.ts

@@ -1,7 +1,7 @@
 import type { EventOnlineDetails } from './bookingRecords';
 import type { CreateEventRequest } from './eventManagementContracts';
 import { BOOKING_SETTINGS_SECTION_KEYS } from './bookingSettingsSections';
-import { type EventPreset } from '../../core/src/index';
+import { type ResolvedEventCatalogue, type EventPreset } from '../../core/src/index';
 export { BOOKING_SETTINGS_SECTION_KEYS, BOOKING_SETTINGS_SECTION_LABELS, } from './bookingSettingsSections';
 import type { EventBookingOffer, EventPricing, EventPricingAttendanceScope, PricingOptionId, PublicEventPricingOptionAvailability, SiteVerticalBookingConfig, StaffMemberId, UserId } from '../../core/src/index';
 /**
@@ -420,3 +420,5 @@ export type BookingSettingsEditorSnapshot = {
     appointmentStaffNotificationSetupHealth: AppointmentStaffNotificationSetupHealth;
 };
 export type BookingSettingsResponse = BookingSettingsEditorSnapshot;
+/** Normalize optional wire defaults once before projecting operational Event policy. */
+export declare function resolveBookingSettingsEventCatalogue(settings: Pick<BookingSettings, 'verticalConfig' | 'eventTypePresets'>): ResolvedEventCatalogue;

package/dist/_dts/api/src/index.d.ts

@@ -71,7 +71,7 @@ export { deleteEventOfferingRequest, addEventSeriesRegistrationRequest, updateEv
 export * from './appointmentServiceContracts';
 export type { BookingPricing, BookingPricingDraft, BookingPricingInput, BookingPricingInputValueTypes, BookingPricingOption, BookingPricingOptionInput, BookingSettingsSection, BookingSettingsSectionUpdate, BookingSettingsSectionUpdateRequest, } from './bookingConfig';
 export type { BookingServicePricing, BookingServicePricingInput, BookingServicePricingOption, BookingServicePricingOptionInput, } from './bookingServicePricing';
-export { BOOKING_SETTINGS_SECTION_LABELS, BOOKING_SETTINGS_SECTION_KEYS, BOOKING_SETTINGS_SECTIONS, DEFAULT_APPOINTMENT_STAFF_DIGEST_LOCAL_SEND_TIME, DEFAULT_BOOKING_NOTIFICATION_SEND_RULE, DEFAULT_BOOKING_NOTIFICATION_SETTINGS, DIRECT_CHECKOUT_COLLECTION_OPTION_KINDS, applyBookingSettingsSectionUpdate, applyBookingSettingsSectionUpdates, createBookingSettingsUpdateRequest, } from './bookingConfig';
+export { BOOKING_SETTINGS_SECTION_LABELS, BOOKING_SETTINGS_SECTION_KEYS, BOOKING_SETTINGS_SECTIONS, DEFAULT_APPOINTMENT_STAFF_DIGEST_LOCAL_SEND_TIME, DEFAULT_BOOKING_NOTIFICATION_SEND_RULE, DEFAULT_BOOKING_NOTIFICATION_SETTINGS, DIRECT_CHECKOUT_COLLECTION_OPTION_KINDS, applyBookingSettingsSectionUpdate, applyBookingSettingsSectionUpdates, createBookingSettingsUpdateRequest, resolveBookingSettingsEventCatalogue, } from './bookingConfig';
 export { bookingPaymentCollectionOptionSchema } from './bookingPaymentTermSchemas';
 export { BOOKING_LEDGER_CANCELLATION_MODE_VALUES, BOOKING_LEDGER_DATE_BASIS_VALUES, BOOKING_LEDGER_KIND_VALUES, BOOKING_LEDGER_PERIOD_PRESET_VALUES, BOOKING_ACTIVITY_CATEGORY_VALUES, BOOKING_ACTIVITY_TYPE_VALUES, BOOKING_QUESTION_ANSWER_EXPORT_SCOPES, BOOKING_QUESTION_ANSWER_EXPORT_SCOPE_VALUES, CUSTOMER_MEMBERSHIP_STATUS_VALUES, CUSTOMER_PASS_STATUS_VALUES, } from './bookingRecords';
 export type { BookingQuestionAnswerExportScopeKind, CreatePersonRecordEntryRequest, ExportBookingQuestionAnswersCsvRequest, } from './bookingRecords';

package/dist/_dts/api/src/navigation/dashboardBookingsNav.d.ts

@@ -1,4 +1,4 @@
-import { type AppointmentResourceId, type EventSeriesCanonicalBehaviour, type SiteVerticalBookingConfig } from "../../../core/src/index";
+import { type AppointmentResourceId, type EventPreset, type ResolvedEventCatalogue } from "../../../core/src/index";
 import type { BookingSettingsSection } from "../bookingConfig";
 import { type StaffScope } from "../staffAccess";
 import type { SiteRole } from "../siteMembers";
@@ -59,9 +59,9 @@ export type DashboardBookingsNavDestination = Readonly<{
     kind: "events_all";
 }> | Readonly<{
     kind: "events_preset";
-    preset: EventSeriesCanonicalBehaviour;
+    preset: Exclude<EventPreset, 'event'>;
 }> | Readonly<{
-    kind: "courses";
+    kind: "events_other";
 }> | Readonly<{
     kind: "venues";
 }> | Readonly<{
@@ -86,4 +86,4 @@ export type DashboardBookingsNavGroupPlan = Readonly<{
     items: readonly DashboardBookingsNavItemPlan[];
 }>;
 export declare function resolveDashboardBookingsNavPolicy(modules: DashboardBookingModules, ctx: DashboardBookingsNavContext): DashboardBookingsNavPolicy;
-export declare function buildDashboardBookingsNavPlan(modules: DashboardBookingModules, ctx: DashboardBookingsNavContext, verticalConfig?: SiteVerticalBookingConfig | null): readonly DashboardBookingsNavGroupPlan[];
+export declare function buildDashboardBookingsNavPlan(modules: DashboardBookingModules, ctx: DashboardBookingsNavContext, catalogue: ResolvedEventCatalogue): readonly DashboardBookingsNavGroupPlan[];

package/dist/_dts/api/src/publicExperience/eventEndpoints.d.ts

@@ -61,6 +61,7 @@ export type PublicEventAPIEndpoints = {
     }>;
     resolveEventSubroute: APIEndpoint<never, {
         siteId: string;
+        stage?: 'published' | 'preview';
         kind: 'event-occurrence' | 'event-run';
         subjectKind: 'eventOffering' | 'eventSeries';
         subjectId: string;

package/dist/_dts/api/src/sdkContracts.d.ts

@@ -17,7 +17,7 @@ export type { SdkCatalogButtonRole, SdkCatalogButtonStyleControl, } from './sdkT
 import type { SdkPullEventCategory } from './sdkEventCategoryContracts';
 import type { SdkPullSettings } from './sdkSettingsContracts';
 export type { SdkConfigureBookingVerticalRequest, SdkConfigureBookingVerticalResponse, SdkPullSettingsWarning, } from './sdkBookingVerticalContracts';
-export type { SdkPullSettings, SdkPullSettingsResponse, } from './sdkSettingsContracts';
+export type { SdkPullSettings, SdkPullSettingsResponse, SdkUpdateSettingsInput, } from './sdkSettingsContracts';
 export type { SdkPullEventCategory } from './sdkEventCategoryContracts';
 import type { SdkManagementEvent, SdkManagementEventOccurrence, SdkManagementEventRun } from './sdkManagedEventContracts';
 export type { SdkEventOccurrenceDeletionEligibility, SdkEventOccurrenceProvenance, SdkManagementEvent, SdkManagementEventOccurrence, SdkManagementEventRun, } from './sdkManagedEventContracts';

package/dist/_dts/api/src/sdkSettingsContracts.d.ts

@@ -11,11 +11,19 @@ export interface SdkPullSettings {
         ogImage?: string;
         allowIndexingInProduction?: boolean;
     } | null;
+    /** Media identifier of the site logo, designed for light backgrounds. */
     logoIdentifier?: string | null;
+    /** Media identifier of the optional logo designed for dark backgrounds. */
+    logoDarkBackgroundIdentifier?: string | null;
     faviconIdentifier?: string | null;
     /** Optional, configured booking vertical for SDK-owned booking surfaces. */
     verticalConfig?: ConfiguredSiteVerticalBookingConfig;
 }
+/**
+ * The settings a management client may write. Named field by field so a new
+ * pull-only field never becomes writable just by being added to the pull shape.
+ */
+export type SdkUpdateSettingsInput = Partial<Pick<SdkPullSettings, 'siteTitle' | 'homepageId' | 'seoDefaults' | 'logoIdentifier' | 'logoDarkBackgroundIdentifier' | 'faviconIdentifier'>>;
 export interface SdkPullSettingsResponse {
     settings: SdkPullSettings;
     warnings?: readonly (string | SdkPullSettingsWarning)[];

package/dist/_dts/api/src/sitePlatformEndpoints.d.ts

@@ -7,7 +7,7 @@ import type { CheckRedirectQuery, CheckRedirectResponse, CreateRedirectRuleReque
 import type { CreateManagementKeyRequest, CreateManagementKeyResponse, CreateSiteApiKeyRequest, CreateSiteApiKeyResponse, CreateSitePreviewKeyRequest, CreateSitePreviewKeyResponse, CreateWebhookRequest, CreateWebhookResponse, DeleteBackupUploadRequest, DeleteBackupUploadResponse, DeleteWebhookResponse, GetSiteApiKeyAccessLogsResponse, ListSitePreviewKeysResponse, GetWebhookResponse, ImportBackupAsNewSiteRequest, ImportBackupAsNewSiteResponse, ImportSiteBackupRequest, ListManagementKeysResponse, ListSiteApiKeysResponse, ListWebhooksResponse, RevokeManagementKeyRequest, RevokeManagementKeyResponse, RevokeSiteApiKeyResponse, SdkDeploymentHealthResponse, SetupSdkDeploymentRevalidationWebhookRequest, SetupSdkDeploymentRevalidationWebhookResponse, SetupSdkRevalidationWebhookRequest, SetupSdkRevalidationWebhookResponse, UpdateWebhookRequest, UpdateWebhookResponse, BackupImportResponse, BackupPreviewRequest, BackupPreviewResponse, CreateBackupUploadUrlRequest, CreateBackupUploadUrlResponse } from './siteInfrastructure';
 import type { GetSiteInspirationAnalysisResponse, ListSiteInspirationAnalysesResponse } from './siteGeneration';
 import type { ListGscPropertiesAdminResponse, AuthStatusResponse, CronAppointmentRemindersResponse, CronBillingStatusResponse, CronEventFeedbackEmailsResponse, CronEventOccurrencesResponse, CronEventRemindersResponse, CronMediaJobsQuery, CronMediaJobsResponse, CronNewsletterSendResponse, CronPaymentReconciliationResponse, CronSeoIngestResponse, CronWaitlistExpiryResponse } from './siteOperations';
-import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkAddEventOccurrenceRequest, SdkBackfillIdentifiersResult, SdkEventOccurrenceResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkPatchPageBlockBody, SdkPatchPageBlockResponse, SdkGetVenueResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventOccurrencesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaDeleteApplyResponse, SdkMediaDeletePreviewResponse, SdkMediaDownloadResponse, SdkMediaListResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCapabilitiesResponse, SdkConfigureBookingVerticalRequest, SdkConfigureBookingVerticalResponse, SdkDemoContentResponse, SdkDeleteResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkPullSettings, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpdateEventOccurrenceRequest, SdkUpsertBlockResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertVenueResponse } from './sdkContracts';
+import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkAddEventOccurrenceRequest, SdkBackfillIdentifiersResult, SdkEventOccurrenceResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkPatchPageBlockBody, SdkPatchPageBlockResponse, SdkGetVenueResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventOccurrencesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaDeleteApplyResponse, SdkMediaDeletePreviewResponse, SdkMediaDownloadResponse, SdkMediaListResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCapabilitiesResponse, SdkConfigureBookingVerticalRequest, SdkConfigureBookingVerticalResponse, SdkDemoContentResponse, SdkDeleteResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkUpdateSettingsInput, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpdateEventOccurrenceRequest, SdkUpsertBlockResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertVenueResponse } from './sdkContracts';
 import type { FooterCompositionUpdateRequest } from './siteManagementEndpoints';
 import type { SdkEventUpsertBody } from './sdk-event-upsert';
 import type { SdkEntryPaginationQueryInput } from './schemas/sdk-entries';
@@ -472,13 +472,7 @@ export type SitePlatformAPIEndpoints = {
         contentType: string;
         identifier: string;
     }, SdkPublishOrUnpublishEntryResponse>;
-    sdkUpdateSettings: APIEndpoint<{
-        siteTitle?: string;
-        homepageId?: string | null;
-        seoDefaults?: SdkPullSettings['seoDefaults'];
-        logoIdentifier?: string | null;
-        faviconIdentifier?: string | null;
-    }, {
+    sdkUpdateSettings: APIEndpoint<SdkUpdateSettingsInput, {
         siteId: string;
     }, SdkUpdateSettingsResponse>;
     sdkConfigureBookingVertical: APIEndpoint<SdkConfigureBookingVerticalRequest, {

package/dist/_dts/api/src/siteSettings.d.ts

@@ -14,7 +14,13 @@ export type SiteGeneralSettingsPayload = {
      * must not have its save rejected or blank the stored value.
      */
     siteDescription?: string | null;
+    /** The site logo, designed for light backgrounds. */
     logoAssetId: string | null;
+    /**
+     * Optional logo designed for dark backgrounds. Optional on the way in,
+     * where absent means unchanged.
+     */
+    logoDarkBackgroundAssetId?: string | null;
     /** Optional masthead image for the hosted booking storefront. */
     coverAssetId?: string | null;
     faviconAssetId: string | null;
@@ -86,15 +92,19 @@ export type SiteBusinessAddressPayload = {
 export type SiteBusinessAddressResponse = {
     businessAddress: BusinessAddress | null;
 };
+export type SiteLayoutLogoPayload = {
+    assetId: string | null;
+    url: string | null;
+    alt: string | null;
+    width?: number | null;
+    height?: number | null;
+};
 export type SiteLayoutResolvedPayload = SiteLayoutSettingsPayload & {
     banner: SiteBannerSettingsPayload;
-    logo?: {
-        assetId: string | null;
-        url: string | null;
-        alt: string | null;
-        width?: number | null;
-        height?: number | null;
-    };
+    /** The site logo, designed for light backgrounds. */
+    logo?: SiteLayoutLogoPayload;
+    /** Optional logo designed for dark backgrounds; null or absent when unset. */
+    logoForDarkBackgrounds?: SiteLayoutLogoPayload | null;
 };
 export type SiteLayoutSettingsResponse = {
     settings: SiteLayoutSettingsPayload;

package/dist/_dts/billing/src/membership/index.d.ts

@@ -9,6 +9,7 @@ export interface MembershipState {
     status: SubscriptionRecord['status'];
     currentPeriodEnd: string;
     cancelAtPeriodEnd: boolean;
+    hasRecoverableSubscription: boolean;
     trialEndsAt?: string | null;
     entitlements: PlanEntitlements;
 }
@@ -22,6 +23,8 @@ export interface MembershipSummary {
     status: SubscriptionRecord['status'];
     currentPeriodEnd: string;
     cancelAtPeriodEnd: boolean;
+    /** Server-derived provider lifecycle signal; do not infer this from status. */
+    hasRecoverableSubscription: boolean;
     trialEndsAt?: string | null;
 }
 export type InvalidMembership = Readonly<{

package/dist/_dts/block-form/src/backend/types.d.ts

@@ -46,6 +46,13 @@ export type FormState = {
     isSubmitting?: boolean;
     errors: Record<string, FieldError>;
 };
+/** Array operations that preserve the identity of rows they don't touch. */
+export type FieldArrayOperations = Readonly<{
+    append: (value: unknown) => void;
+    insert: (index: number, value: unknown) => void;
+    move: (from: number, to: number) => void;
+    remove: (index: number) => void;
+}>;
 /**
  * Unified form backend interface.
  * Factory functions (createRHFBackend, createStoreBackend) return this interface.
@@ -97,6 +104,13 @@ export interface FormBackend {
         /** Insert item at index */
         insert: (path: string, index: number, value: unknown) => void;
     };
+    /**
+     * React Hook Form backend only. A mounted repeater registers its
+     * `useFieldArray` operations for a path, and `arrayField` uses them for that
+     * path so existing rows keep their ids (and their open state). Returns a
+     * function that unregisters them.
+     */
+    registerFieldArray?: (path: string, operations: FieldArrayOperations) => () => void;
     /** Get form-level state */
     formState: FormState;
     /** Reset entire form (optionally with new values) */

package/dist/_dts/block-form/src/client/index.d.ts

@@ -8,6 +8,7 @@ export { BlockContextProvider, useBlockContext } from '../context';
 export { DisplayLabelResolverProvider, useDisplayLabelResolvers, } from '../context';
 export { FieldPreviewResolverProvider, useFieldPreviewResolvers, } from '../context';
 export { ImageResolveContextProvider, useImageResolveContextOptional, } from '../context';
+export { RepeaterHostActionsProvider, useRepeaterHostActions, } from '../context';
 export { FieldFrame, FieldFrameMessage } from '../widgets/FieldFrame';
 export { WidgetField, WidgetFieldMessage } from '../widgets/Field';
 export { SelectField } from '../widgets/SelectField';

package/dist/_dts/block-form/src/context/RepeaterHostActionsContext.d.ts

@@ -0,0 +1,30 @@
+import { type ReactNode } from 'react';
+/**
+ * Actions a host screen can take over for a specific repeater.
+ *
+ * Block-form stays generic: it doesn't know what a "field preset" or a
+ * form's naming rules are. A host that does can register actions for a
+ * repeater path, and the repeater asks instead of acting. With nothing
+ * registered, a repeater behaves exactly as it always has.
+ */
+export type RepeaterHostActions = Readonly<{
+    /**
+     * The host decides what to add at `position` (and adds it). While this is
+     * registered the repeater shows an insert divider between items, and its
+     * add button calls this instead of appending a blank item.
+     */
+    requestAdd?: (position: number) => void;
+    /** The host duplicates the item at `index`, following its own rules. */
+    requestDuplicate?: (index: number) => void;
+    /** Label for the add button and insert dividers' noun, e.g. "field". */
+    addLabel?: string;
+    /** Shown instead of the list and add button while the repeater is empty. */
+    emptyState?: ReactNode;
+}>;
+/** Host actions keyed by repeater path, e.g. `{ fields: { requestAdd } }`. */
+export type RepeaterHostActionsMap = Readonly<Record<string, RepeaterHostActions>>;
+export declare function RepeaterHostActionsProvider({ actions, children, }: Readonly<{
+    actions: RepeaterHostActionsMap;
+    children: ReactNode;
+}>): import("react").JSX.Element;
+export declare function useRepeaterHostActions(path: string): RepeaterHostActions;

package/dist/_dts/block-form/src/context/index.d.ts

@@ -2,3 +2,4 @@ export { BlockContextProvider, useBlockContext, type BlockContextValue, type Blo
 export { DisplayLabelResolverProvider, useDisplayLabelResolvers, type DisplayLabelResolver, type DisplayLabelResolverMap, type ResolverCallContext, } from './DisplayLabelResolverContext';
 export { FieldPreviewResolverProvider, useFieldPreviewResolvers, type FieldPreviewResolver, type FieldPreviewResolverMap, type FieldPreviewResolverCallContext, } from './FieldPreviewResolverContext';
 export { ImageResolveContextProvider, useImageResolveContextOptional, } from './ImageResolveContext';
+export { RepeaterHostActionsProvider, useRepeaterHostActions, type RepeaterHostActions, type RepeaterHostActionsMap, } from './RepeaterHostActionsContext';

package/dist/_dts/block-form/src/index.d.ts

@@ -26,3 +26,4 @@ export type { DateParseResult, DatePickerPopoverProps, } from './widgets/DateFie
 export type { FieldSettingsModalProps } from './widgets/FieldSettingsModal';
 export type { SettingsModalProps, SettingsTab, SettingsTabId, } from './widgets/SettingsModal';
 export type { VisibilityValueReader } from './utils/evaluateVisibility';
+export type { RepeaterHostActions, RepeaterHostActionsMap, } from './context/RepeaterHostActionsContext';

package/dist/_dts/block-form/src/widgets/RepeaterField/components/RepeaterList.d.ts

@@ -4,6 +4,7 @@
 import { type ReactNode, type RefObject } from 'react';
 import type { RepeaterFieldConfig, FieldConfig } from '../../../fields/types';
 import type { FormBackend } from '../../../backend/types';
+import type { RepeaterHostActions } from '../../../context/RepeaterHostActionsContext';
 export interface RepeaterListProps {
     config: RepeaterFieldConfig;
     backend: FormBackend;
@@ -12,9 +13,11 @@ export interface RepeaterListProps {
         id: string;
     }>;
     minItems: number;
+    maxItems?: number;
     onMove: (from: number, to: number) => void;
     onRemove: (index: number) => void;
     renderChild: (field: FieldConfig, path: string) => ReactNode;
     focusFallbackRef?: RefObject<HTMLButtonElement | null>;
+    hostActions?: RepeaterHostActions;
 }
-export declare function RepeaterList({ config, backend, basePath, items, minItems, onMove, onRemove, renderChild, focusFallbackRef, }: RepeaterListProps): ReactNode;
+export declare function RepeaterList({ config, backend, basePath, items, minItems, maxItems, onMove, onRemove, renderChild, focusFallbackRef, hostActions, }: RepeaterListProps): ReactNode;

package/dist/_dts/block-form/src/widgets/RepeaterField/components/RepeaterRow.d.ts

@@ -1,5 +1,5 @@
 /**
- * Repeater row - sortable item with disclosure
+ * Repeater row - sortable item on the shared editor item card
  * Handles drag-drop, disclosure state, and coordinates child rendering
  *
  * Routes non-content item fields into a settings modal in the row header.
@@ -16,11 +16,14 @@ export interface RepeaterRowProps {
     basePath: string;
     itemsLength: number;
     minItems: number;
+    maxItems?: number;
     containerWidth: number;
     onMove: (from: number, to: number, focusTarget: RepeaterRowActionFocusTarget) => void;
     onRemove: (index: number) => void;
+    /** Offers "Duplicate item" when provided. */
+    onDuplicate?: (index: number) => void;
     renderChild: (field: FieldConfig, path: string) => ReactNode;
     canDrag: boolean;
     actionControlRefs?: Partial<Record<RepeaterRowActionFocusTarget, Ref<HTMLButtonElement>>>;
 }
-export declare function RepeaterRow({ id, index, config, backend, basePath, itemsLength, minItems, containerWidth, onMove, onRemove, renderChild, canDrag, actionControlRefs, }: RepeaterRowProps): ReactNode;
+export declare function RepeaterRow({ id, index, config, backend, basePath, itemsLength, minItems, maxItems, containerWidth, onMove, onRemove, onDuplicate, renderChild, canDrag, actionControlRefs, }: RepeaterRowProps): ReactNode;

package/dist/_dts/block-form/src/widgets/RepeaterField/components/RepeaterRowActions.d.ts

@@ -2,20 +2,30 @@
  * Repeater row action controls - direct reorder buttons plus compact menu.
  */
 import type { ReactNode, Ref } from 'react';
+import { type EditorItemCardActionsProps } from '../../../../../ui/src/index';
 export interface RepeaterRowActionsProps {
     index: number;
     itemsLength: number;
     minItems: number;
+    maxItems?: number;
     containerWidth?: number;
     actionPresentation?: 'auto' | 'wide' | 'compact';
     itemLabel: string;
     onMoveUp: () => void;
     onMoveDown: () => void;
     onRemove: () => void;
+    /** Offers "Duplicate item" when provided. */
+    onDuplicate?: () => void;
     actionControlRefs?: Partial<Record<RepeaterRowActionFocusTarget, Ref<HTMLButtonElement>>>;
     showReorderActions?: boolean;
     disableMoveUp?: boolean;
     disableMoveDown?: boolean;
 }
 export type RepeaterRowActionFocusTarget = 'moveEarlier' | 'moveLater' | 'menu';
-export declare function RepeaterRowActions({ index, itemsLength, minItems, containerWidth, actionPresentation, itemLabel, onMoveUp, onMoveDown, onRemove, actionControlRefs, showReorderActions, disableMoveUp, disableMoveDown, }: RepeaterRowActionsProps): ReactNode;
+/**
+ * The repeater's row actions, as props for the shared editor item card.
+ * Availability, compact collapsing and focus refs stay here with the
+ * repeater; the card only draws them.
+ */
+export declare function buildRepeaterRowActions({ index, itemsLength, minItems, maxItems, containerWidth, actionPresentation, itemLabel, onMoveUp, onMoveDown, onRemove, onDuplicate, actionControlRefs, showReorderActions, disableMoveUp, disableMoveDown, }: RepeaterRowActionsProps): EditorItemCardActionsProps;
+export declare function RepeaterRowActions(props: RepeaterRowActionsProps): ReactNode;

package/dist/_dts/block-form/src/widgets/RepeaterField/hooks/index.d.ts

@@ -4,3 +4,4 @@ export { useResolvedItemLabel, useResolvedRepeaterItemLabel, type ResolvedRepeat
 export { useLayoutGridCapacity } from './useLayoutGridCapacity';
 export { useLinearRepeaterDnd, type LinearRepeaterSortingStrategyKind } from './useLinearRepeaterDnd';
 export { useRepeaterPointerDragCapability } from './useRepeaterPointerDragCapability';
+export { useEmptyStateFocusAfterRemoval } from './useEmptyStateFocusAfterRemoval';

package/dist/_dts/block-form/src/widgets/RepeaterField/hooks/useEmptyStateFocusAfterRemoval.d.ts

@@ -0,0 +1,8 @@
+import { type RefObject } from 'react';
+/**
+ * When removing the last item swaps the list for a host's empty state, the
+ * removed row's controls are gone and focus would fall to the page. Move it to
+ * the empty state's first action instead — but only after a removal, never
+ * when a repeater simply starts out empty.
+ */
+export declare function useEmptyStateFocusAfterRemoval(itemCount: number, showEmptyState: boolean): RefObject<HTMLDivElement | null>;

package/dist/_dts/block-form/src/widgets/RepeaterField/utils/buildSummary.d.ts

@@ -2,7 +2,21 @@
  * Build a summary preview text for a repeater item
  * Shows first 2 non-hidden, non-label-source field values
  */
-import type { RepeaterFieldConfig } from '../../../fields/types';
+import type { RepeaterFieldConfig, FieldConfig } from '../../../fields/types';
 import type { FormBackend } from '../../../backend/types';
 export declare const DEFAULT_REPEATER_SUMMARY_MAX_CHARS = 96;
+type SummaryPartOptions = Readonly<{
+    /** True when the repeater named this field in `summaryFields`. */
+    explicitlyListed: boolean;
+}>;
+/**
+ * The summary text for one field's value, resolved by the field's type:
+ * select values become their option labels (a value missing from the
+ * select's own options is omitted rather than shown as an internal key), and
+ * a boolean contributes its own label when true
+ * — but only when the repeater asked for it, so checkboxes don't start
+ * appearing in summaries that never had them.
+ */
+export declare function resolveSummaryPart(field: FieldConfig, value: unknown, options: SummaryPartOptions): string | null;
 export declare function buildSummary(field: RepeaterFieldConfig, index: number, backend: FormBackend, basePath: string): string;
+export {};

package/dist/_dts/block-form/src/widgets/RepeaterField/utils/repeaterRowActionsDomain.d.ts

@@ -1,10 +1,10 @@
 export declare const REPEATER_ROW_COMPACT_ACTIONS_WIDTH = 640;
-export type RepeaterRowActionId = 'moveEarlier' | 'moveLater' | 'delete';
+export type RepeaterRowActionId = 'moveEarlier' | 'moveLater' | 'duplicate' | 'delete';
 export type RepeaterRowActionAvailability = {
     kind: 'enabled';
 } | {
     kind: 'disabled';
-    reason: 'first-item' | 'last-item' | 'minimum-items' | 'unavailable';
+    reason: 'first-item' | 'last-item' | 'minimum-items' | 'maximum-items' | 'unavailable';
 };
 export type RepeaterRowMenuAction = {
     id: RepeaterRowActionId;
@@ -32,6 +32,9 @@ export type RepeaterRowActionPresentationInput = {
     index: number;
     itemsLength: number;
     minItems: number;
+    /** Present when duplicating is offered; duplicates count towards it. */
+    maxItems?: number;
+    canDuplicate?: boolean;
     actionPresentation?: 'auto' | 'wide' | 'compact';
 };
 export type RepeaterRowActionRenderPlanInput = RepeaterRowActionPresentationInput & {