@riverbankcms/sdk 0.153.0 → 0.154.0

package/dist/_dts/blocks/src/system/transforms/typed.d.ts

@@ -47,18 +47,9 @@ export declare const transformDefinitions: {
         contained?: string | undefined;
     }>;
     readonly 'layout.footerBottomBarStyle': TransformDefinition;
-    readonly 'layout.footerSplitMainClass': TransformDefinition<{
-        base?: string | undefined;
-        reverseClass?: string | undefined;
-    }>;
     readonly 'layout.footerLogoClass': TransformDefinition<{
         base?: string | undefined;
-        requireExplicitShow?: boolean | undefined;
-    }>;
-    readonly 'layout.footerLogoMediaClass': TransformDefinition<{
-        base?: string | undefined;
     }>;
-    readonly 'layout.footerLogoTextVisible': TransformDefinition;
     readonly 'ui.headingClassFromAlignment': TransformDefinition<{
         base: string;
     }>;
@@ -123,7 +114,7 @@ export declare function bindProp(from: string, opts?: {
     readonly $bind: {
         readonly pick?: "value" | "context" | "collection" | undefined;
         readonly fallback?: {} | null | undefined;
-        readonly transforms?: TransformStep<"string.uppercase" | "value.fallback" | "date.formatShort" | "value.csv" | "layout.maxWidthClass" | "layout.headerRootClass" | "layout.footerRootClass" | "layout.headerRootStyle" | "layout.headerSectionBackground" | "layout.footerRootStyle" | "ui.headerNavLinkClass" | "ui.headingClassFromAlignment" | "ui.bodyClassFromAlignment" | "ui.stackAlignFromAlignment" | "ui.sectionStateTone" | "ui.heroContentWrapperClass" | "ui.heroCtaJustify" | "ui.heroStackJustifyFromVerticalAlignment" | "ui.heroGridClassFromVerticalAlignment" | "ui.conditionalClass" | "ui.twoColumnContainerClass" | "ui.twoColumnFlexBasis" | "media.fromUrl" | "content.interpolateRichTextTokens" | "boxStyles.semanticGap" | "boxStyles.semanticGapValue" | "layout.headerLogoClass" | "layout.headerLogoMediaClass" | "layout.headerLogoTextVisible" | "layout.footerBottomBarClass" | "layout.footerBottomBarContainerClass" | "layout.footerBottomBarStyle" | "layout.footerSplitMainClass" | "layout.footerLogoClass" | "layout.footerLogoMediaClass" | "layout.footerLogoTextVisible" | "layout.chromeLogo" | "layout.headerRuntimeContract">[] | undefined;
+        readonly transforms?: TransformStep<"string.uppercase" | "value.fallback" | "date.formatShort" | "value.csv" | "layout.maxWidthClass" | "layout.headerRootClass" | "layout.footerRootClass" | "layout.headerRootStyle" | "layout.headerSectionBackground" | "layout.footerRootStyle" | "ui.headerNavLinkClass" | "ui.headingClassFromAlignment" | "ui.bodyClassFromAlignment" | "ui.stackAlignFromAlignment" | "ui.sectionStateTone" | "ui.heroContentWrapperClass" | "ui.heroCtaJustify" | "ui.heroStackJustifyFromVerticalAlignment" | "ui.heroGridClassFromVerticalAlignment" | "ui.conditionalClass" | "ui.twoColumnContainerClass" | "ui.twoColumnFlexBasis" | "media.fromUrl" | "content.interpolateRichTextTokens" | "boxStyles.semanticGap" | "boxStyles.semanticGapValue" | "layout.headerLogoClass" | "layout.headerLogoMediaClass" | "layout.headerLogoTextVisible" | "layout.footerBottomBarClass" | "layout.footerBottomBarContainerClass" | "layout.footerBottomBarStyle" | "layout.footerLogoClass" | "layout.chromeLogo" | "layout.headerRuntimeContract">[] | undefined;
         readonly from: string;
     };
 };

package/dist/_dts/commerce/src/purchase/orderConfirmationPlanning.d.ts

@@ -94,6 +94,7 @@ export type OrderConfirmationSettlement = Readonly<{
 export type OrderConfirmationFormatters = Readonly<{
     formatCurrencyAmount: (amountCents: number, currency: string) => string;
     formatDateTime: (isoString: string) => string;
+    formatPaymentDueDate: (isoString: string) => string;
     formatInstalmentStatusLabel: (row: OrderInstalmentSummary['rows'][number]) => string;
     resolveCustomerDisplayName: (name: string | null, email: string) => string;
 }>;

package/dist/_dts/content-editor/src/FooterComposerOverview.d.ts

@@ -1,4 +1,4 @@
-import { type FooterCompositionV1, type FooterNavigationLayout } from '../../core/src/index';
+import { type FooterCompositionV1, type FooterArrangement, type FooterNavigationLayout } from '../../core/src/index';
 import type { FooterAttribution, FooterRuntimeViewModel } from '../../blocks/src/client/site-chrome';
 import { type FooterEditorTarget, type planFooterEditorView } from './footerComposer';
 import type { SaveState } from './useFooterComposerState';
@@ -9,7 +9,7 @@ export declare function SaveBadge({ state }: {
 export declare function FooterPreview({ runtime, }: {
     runtime: FooterRuntimeViewModel;
 }): import("react").JSX.Element;
-export declare function FooterOverview({ attribution, plan, composition, onTarget, onChange, manageLinksHref, manageSettingsHref, navigationLayout, onEngagement, onNavigationLayoutChange, }: {
+export declare function FooterOverview({ attribution, plan, composition, onTarget, onChange, manageLinksHref, manageSettingsHref, navigationLayout, arrangement, onEngagement, onNavigationLayoutChange, navigationLayoutPending, navigationLayoutDisabled, }: {
     attribution: FooterAttribution | null;
     plan: FooterPlan;
     composition: FooterCompositionV1;
@@ -18,7 +18,10 @@ export declare function FooterOverview({ attribution, plan, composition, onTarge
     manageLinksHref: string;
     manageSettingsHref: string;
     navigationLayout: FooterNavigationLayout;
+    arrangement?: FooterArrangement;
     onEngagement: () => void;
+    navigationLayoutPending?: boolean;
+    navigationLayoutDisabled?: boolean;
     onNavigationLayoutChange?: (layout: FooterNavigationLayout) => void;
 }): import("react").JSX.Element;
 export {};

package/dist/_dts/content-editor/src/FooterComposerPanel.d.ts

@@ -1,3 +1,3 @@
 import { type ReactNode } from 'react';
 import type { FooterComposerPanelProps } from './footerComposerPanelTypes';
-export declare function FooterComposerPanel({ apiClient, siteId: rawSiteId, customFooterMode, manageLinksHref, manageFormsHref, manageNewsletterHref, manageSettingsHref, legalRegion, navigationLayoutAccess, initialTarget, initialTargetRequestId, variant, canEdit, onSaved, loadingFallback, }: FooterComposerPanelProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+export declare function FooterComposerPanel({ apiClient, siteId: rawSiteId, customFooterMode, manageLinksHref, manageFormsHref, manageNewsletterHref, manageSettingsHref, arrangement, legalRegion, navigationLayoutAccess, initialTarget, initialTargetRequestId, variant, canEdit, onSaved, loadingFallback, }: FooterComposerPanelProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;

package/dist/_dts/content-editor/src/FooterNavigationLayoutControl.d.ts

@@ -1,5 +1,8 @@
-import type { FooterNavigationLayout } from '../../core/src/index';
-export declare function FooterNavigationLayoutControl({ value, onChange, }: Readonly<{
+import type { FooterArrangement, FooterNavigationLayout } from '../../core/src/index';
+export declare function FooterNavigationLayoutControl({ value, arrangement, onChange, pending, disabled, }: Readonly<{
+    pending?: boolean;
+    disabled?: boolean;
+    arrangement?: FooterArrangement;
     value: FooterNavigationLayout;
     onChange: (layout: FooterNavigationLayout) => void;
-}>): import("react").JSX.Element;
+}>): import("react").JSX.Element | null;

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

@@ -24,7 +24,7 @@ export type LeaseParticipationKind = ClassifiedParticipation['kind'];
 export declare function classifyLeaseParticipation(participation: EditorLeaseParticipation): ClassifiedParticipation;
 export declare function leaseConfigOf(participation: EditorLeaseParticipation): EditorLeaseConfig | null;
 /** Viewing and leased mounts share one store identity, so switching between them keeps local edits. */
-export declare function leaseExemptionOf(participation: EditorLeaseParticipation): "team-member-profile" | "sdk" | null;
+export declare function leaseExemptionOf(participation: EditorLeaseParticipation): "sdk" | "team-member-profile" | null;
 export declare function initialParticipationEditability(participation: EditorLeaseParticipation): EditorEditability;
 /**
  * The store's editability after the mount's participation changes. A lease controller owns

package/dist/_dts/content-editor/src/footerComposer.d.ts

@@ -1,4 +1,4 @@
-import { type FooterArrangementPlan, type FooterCompositionV1, type FooterModuleId, type FooterNavigationRole, type FooterNavigationLayout, type FooterSection, type PublicProfile } from '../../core/src/index';
+import { type FooterArrangement, type FooterArrangementPlan, type FooterCompositionV1, type FooterModuleId, type FooterNavigationRole, type FooterNavigationLayout, type FooterSection, type PublicProfile } from '../../core/src/index';
 export type FooterEditorTarget = Readonly<{
     kind: 'overview';
 }> | Readonly<{
@@ -52,6 +52,7 @@ type FooterEditorViewPlanInput = Readonly<{
     hasLegalPolicyNavigation?: boolean;
     hasEngagementSource?: boolean;
     canEdit: boolean;
+    arrangement?: FooterArrangement;
     legalRegion?: 'integrated' | 'separate';
     navigationLayout?: FooterNavigationLayout;
 }>;

package/dist/_dts/content-editor/src/footerComposerPanelTypes.d.ts

@@ -1,15 +1,17 @@
+import type { FooterArrangement } from '../../core/src/index';
 import type { ReactNode } from 'react';
 import type { ApiClient } from '../../api/src/request';
 import type { FooterEditorTarget } from './footerComposer';
 import type { FooterNavigationLayoutAccess } from './useFooterNavigationLayout';
 export type FooterComposerPanelProps = Readonly<{
-    apiClient: ApiClient<'getFooterComposition' | 'updateFooterComposition' | 'getPublicProfile' | 'updatePublicProfile' | 'getNavigationMenus' | 'getMailingListAuthoringContext' | 'listForms' | 'applySiteStyleSelection'>;
+    apiClient: ApiClient<'getFooterComposition' | 'updateFooterComposition' | 'getPublicProfile' | 'updatePublicProfile' | 'getNavigationMenus' | 'getMailingListAuthoringContext' | 'listForms' | 'applySiteStyleSelection' | 'getSite'>;
     siteId: string;
     customFooterMode: 'default' | 'blocks' | 'default+blocks' | 'none';
     manageLinksHref: string;
     manageFormsHref?: string;
     manageNewsletterHref?: string;
     manageSettingsHref: string;
+    arrangement?: FooterArrangement;
     legalRegion?: 'integrated' | 'separate';
     navigationLayoutAccess?: FooterNavigationLayoutAccess;
     initialTarget?: FooterEditorTarget;

package/dist/_dts/content-editor/src/footerNavigationLayoutState.d.ts

@@ -0,0 +1,56 @@
+import type { FooterNavigationLayout } from '../../core/src/index';
+export type FooterNavigationSnapshot = Readonly<{
+    siteId: string;
+    selectionId: string | null;
+    selectionVersion: number;
+    layout: FooterNavigationLayout;
+    editable: boolean;
+}>;
+export type FooterNavigationRequest = Readonly<{
+    snapshot: FooterNavigationSnapshot;
+    layout: FooterNavigationLayout;
+}>;
+export type FooterNavigationState = Readonly<{
+    source: FooterNavigationSnapshot;
+    confirmed: FooterNavigationSnapshot;
+}> & (Readonly<{
+    kind: 'ready';
+}> | Readonly<{
+    kind: 'saving';
+    request: FooterNavigationRequest;
+}> | Readonly<{
+    kind: 'reload-failed';
+}>);
+export type FooterNavigationEvent = Readonly<{
+    kind: 'confirmed';
+    request: FooterNavigationRequest;
+    snapshot: FooterNavigationSnapshot;
+}> | Readonly<{
+    kind: 'failed' | 'reload-failed';
+    request: FooterNavigationRequest;
+}>;
+export declare function refreshFooterNavigation(state: FooterNavigationState, source: FooterNavigationSnapshot): FooterNavigationState;
+/** The controller hands the effect shell an admitted request and its pending state together. */
+export declare function beginFooterNavigationSave(state: FooterNavigationState, layout: FooterNavigationLayout): {
+    readonly kind: "blocked";
+    readonly request?: undefined;
+    readonly state?: undefined;
+} | {
+    readonly kind: "save";
+    readonly request: Readonly<{
+        snapshot: FooterNavigationSnapshot;
+        layout: FooterNavigationLayout;
+    }>;
+    readonly state: {
+        readonly kind: "saving";
+        readonly request: Readonly<{
+            snapshot: FooterNavigationSnapshot;
+            layout: FooterNavigationLayout;
+        }>;
+        readonly source: FooterNavigationSnapshot;
+        readonly confirmed: FooterNavigationSnapshot;
+    };
+};
+/** Only the admitted request can finish; a newer refreshed revision wins. */
+export declare function transitionFooterNavigation(state: FooterNavigationState, event: FooterNavigationEvent): FooterNavigationState;
+export declare function footerNavigationLayoutValue(state: FooterNavigationState): FooterNavigationLayout;

package/dist/_dts/content-editor/src/footerPreviewRuntime.d.ts

@@ -1,5 +1,5 @@
 import { type FooterAttribution, type FooterResolvedEngagement, type FooterRuntimeViewModel } from '../../blocks/src/client/site-chrome';
-import type { FooterCompositionV1, FooterNavigationLayout, PublicProfile } from '../../core/src/index';
+import type { FooterCompositionV1, FooterArrangement, FooterNavigationLayout, PublicProfile } from '../../core/src/index';
 export type FooterPreviewRuntimeInput = Readonly<{
     composition: FooterCompositionV1;
     publicProfile: PublicProfile;
@@ -7,6 +7,7 @@ export type FooterPreviewRuntimeInput = Readonly<{
     hasLogo: boolean;
     hasMainNavigation: boolean;
     hasLegalPolicyNavigation: boolean;
+    arrangement?: FooterArrangement;
     legalRegion: 'integrated' | 'separate';
     navigationLayout: FooterNavigationLayout;
     engagement: FooterResolvedEngagement;

package/dist/_dts/content-editor/src/useFooterComposerState.d.ts

@@ -18,10 +18,9 @@ export declare function useFooterComposerState({ apiClient, canEdit, initialTarg
     message: string | null;
     navigationLayoutControl: {
         readonly layout: "stack" | "inline-wrap";
-        readonly onChange: undefined;
-    } | {
-        readonly layout: "stack" | "inline-wrap";
-        readonly onChange: (next: import("../../core/src/index").FooterNavigationLayout) => Promise<void>;
+        readonly pending: boolean;
+        readonly disabled: boolean;
+        readonly onChange: ((layout: import("../../core/src/index").FooterNavigationLayout) => Promise<void>) | undefined;
     };
     saveComposition: (next: FooterCompositionV1, optimistic?: boolean) => Promise<CompositionSaveOutcome>;
     saveProfile: (next: PublicProfile) => Promise<void>;

package/dist/_dts/content-editor/src/useFooterNavigationLayout.d.ts

@@ -1,4 +1,5 @@
-import type { ApiClient } from '../../api/src/request';
+import type { FooterPreferences } from '../../theme-core/src/site-styles/index';
+import { type ApiClient } from '../../api/src/request';
 import type { Theme } from '../../blocks/src/index';
 import { type FooterNavigationLayout } from '../../core/src/index';
 export type FooterSaveState = 'idle' | 'saving' | 'saved' | 'conflict' | 'failed';
@@ -7,20 +8,22 @@ export type FooterNavigationLayoutAccess = Readonly<{
 }> | Readonly<{
     kind: 'editable';
     theme: Theme;
+    preferences: FooterPreferences;
     selectionId: string | null;
     selectionVersion: number;
 }>;
-export declare function useFooterNavigationLayout({ apiClient, siteId, access, onSaved, onSaveStateChange, onMessageChange, }: Readonly<{
-    apiClient: ApiClient<'applySiteStyleSelection'>;
+type Options = Readonly<{
+    apiClient: ApiClient<'applySiteStyleSelection' | 'getSite'>;
     siteId: string;
     access: FooterNavigationLayoutAccess;
     onSaved?: () => void;
     onSaveStateChange: (state: FooterSaveState) => void;
     onMessageChange: (message: string | null) => void;
-}>): {
-    readonly layout: "stack" | "inline-wrap";
-    readonly onChange: undefined;
-} | {
+}>;
+export declare function useFooterNavigationLayout(options: Options): {
     readonly layout: "stack" | "inline-wrap";
-    readonly onChange: (next: FooterNavigationLayout) => Promise<void>;
+    readonly pending: boolean;
+    readonly disabled: boolean;
+    readonly onChange: ((layout: FooterNavigationLayout) => Promise<void>) | undefined;
 };
+export {};

package/dist/_dts/core/src/booking-refunds.d.ts

@@ -64,3 +64,5 @@ export type AcceptedEventScheduleUpdate<TId extends string = string> = Readonly<
     }>;
     cancellationResult: BusinessCancellationResult;
 }>;
+/** Narrow an already typed schedule-write response by its receipt discriminant. */
+export declare function isAcceptedEventScheduleUpdate(response: object): response is AcceptedEventScheduleUpdate;

package/dist/_dts/core/src/date-display.d.ts

@@ -0,0 +1,85 @@
+import { type BookingTimeZone, type LocalScheduleDate, type UtcIsoDateTimeString } from './booking-date-time';
+/** Explicit business/viewer projection; never consults a clock or server locale. */
+export type DisplayContext = Readonly<{
+    locale: string;
+    timeZone: BookingTimeZone;
+}>;
+export type DisplayDate = Readonly<{
+    kind: 'instant';
+    value: UtcIsoDateTimeString;
+}> | Readonly<{
+    kind: 'civil';
+    value: LocalScheduleDate;
+}>;
+export type DateStyle = 'numeric' | 'short' | 'long';
+export type ZoneLabel = 'omit' | 'always';
+export type DisplayDateOptions = Readonly<{
+    date?: DateStyle;
+    weekday?: 'short' | 'long';
+    year?: 'numeric' | 'omit';
+}>;
+export type DisplayTimeOptions = Readonly<{
+    zone: ZoneLabel;
+}>;
+export type DisplayDateTimeOptions = DisplayDateOptions & DisplayTimeOptions;
+export type DateTimeSpan = Readonly<{
+    start: UtcIsoDateTimeString;
+    end: UtcIsoDateTimeString;
+}>;
+export type BookingDisplayContext = Readonly<{
+    context: DisplayContext;
+    zone: ZoneLabel;
+}>;
+/** Site-language policy, shared by customer emails and public event adapters. */
+export declare function inferSiteDateLocale(siteTimeZone: string | null | undefined): string;
+/** Callers resolve the facts once; all clocks consume the same label decision. */
+export declare function resolveBookingDisplayContext(input: Readonly<{
+    sessionTimeZone: BookingTimeZone;
+    siteTimeZone: BookingTimeZone;
+    locale: string;
+    isOnline: boolean;
+    surface: 'email' | 'dashboard';
+}>): BookingDisplayContext;
+/** Internal adapter profile: SDK keeps its established native/custom typography. */
+export type DatePresentationProfile = Readonly<{
+    kind: 'display';
+    dateFormat: Intl.DateTimeFormatOptions;
+    clock: Readonly<{
+        kind: 'compact';
+        localeSource: 'product' | 'context';
+    }>;
+    zone: ZoneLabel;
+}> | Readonly<{
+    kind: 'sdk';
+    dateFormat: Intl.DateTimeFormatOptions;
+    clock: ClockPresentation;
+    zone: 'omit';
+}>;
+/** Public SDK option policy lives beside the display profile, never in its adapter. */
+export declare function sdkPresentationProfile(context: DisplayContext, dateFormat: Intl.DateTimeFormatOptions, time?: Readonly<{
+    timePresentation?: 'compact' | 'standard';
+    format?: Intl.DateTimeFormatOptions;
+}>): DatePresentationProfile;
+type ClockPresentation = Readonly<{
+    kind: 'compact';
+    localeSource: 'product' | 'context';
+}> | Readonly<{
+    kind: 'intl';
+    format: Intl.DateTimeFormatOptions;
+}>;
+export declare function formatDate(value: DisplayDate, context: DisplayContext, options?: DisplayDateOptions): string;
+export declare function formatDateRange(start: DisplayDate, endInclusive: DisplayDate, context: DisplayContext, options?: DisplayDateOptions): string;
+export declare function formatDateTime(value: UtcIsoDateTimeString, context: DisplayContext, options: DisplayDateTimeOptions): string;
+export declare function formatDateTimeRange(span: DateTimeSpan, context: DisplayContext, options: DisplayDateTimeOptions): string;
+export declare function formatTime(value: UtcIsoDateTimeString, context: DisplayContext, options: DisplayTimeOptions): string;
+export declare function formatTimeRange(start: UtcIsoDateTimeString, end: UtcIsoDateTimeString, context: DisplayContext, options: DisplayTimeOptions): string;
+/** Sole date projection/typography owner, used by display and scheduled adapters. */
+export declare function presentDate(value: DisplayDate, context: DisplayContext, profile: DatePresentationProfile): string;
+export declare function presentDateRange(start: DisplayDate, end: DisplayDate, context: DisplayContext, profile: DatePresentationProfile): string;
+export declare function presentTime(value: UtcIsoDateTimeString, context: DisplayContext, profile: DatePresentationProfile): string;
+export declare function presentDateTime(value: UtcIsoDateTimeString, context: DisplayContext, profile: DatePresentationProfile): string;
+export declare function presentTimeRange(span: DateTimeSpan, context: DisplayContext, profile: DatePresentationProfile): string;
+export declare function presentDateTimeRange(span: DateTimeSpan, context: DisplayContext, profile: DatePresentationProfile): string;
+export declare function formatTimeAgo(value: UtcIsoDateTimeString, now: UtcIsoDateTimeString, context: DisplayContext): string;
+export declare function formatTimeUntil(value: UtcIsoDateTimeString, now: UtcIsoDateTimeString, context: DisplayContext): string;
+export {};

package/dist/_dts/core/src/date-time-formatter.d.ts

@@ -0,0 +1,2 @@
+export declare function getDateTimeFormatter(locale: string, timeZone: string, format: Intl.DateTimeFormatOptions): Intl.DateTimeFormat;
+export declare function formatIntlRange(formatter: Intl.DateTimeFormat, start: Date, end: Date): string;

package/dist/_dts/core/src/footer-arrangement.d.ts

@@ -1,2 +1,9 @@
-import type { FooterArrangementPlan, FooterLookPolicy, RenderableFooterSection } from './footer-composition-types';
+import type { FooterArrangement, FooterArrangementPlan, FooterLookPolicy, RenderableFooterSection } from './footer-composition-types';
+import type { FooterNavigationLayout } from './footer-navigation-layout';
+/** One policy owner for the served footer and its composition preview. */
+export declare function footerArrangementPolicy(input: Readonly<{
+    arrangement?: FooterArrangement;
+    legalRegion?: 'integrated' | 'separate';
+    storedNavigationLayout?: FooterNavigationLayout | 'inline';
+}>): FooterLookPolicy;
 export declare function planFooterArrangement(renderableSections: readonly RenderableFooterSection[], policy: FooterLookPolicy): FooterArrangementPlan;

package/dist/_dts/core/src/footer-composition-types.d.ts

@@ -56,20 +56,25 @@ export type FooterCompositionError = Readonly<{
     path: string;
     message: string;
 }>;
+export type FooterArrangement = 'simple' | 'split' | 'centred';
+export type FooterArrangementSlot = 'head' | 'navigation' | 'contact' | 'social' | 'panel' | 'base' | 'stack';
 export type FooterLookPolicy = Readonly<{
+    arrangement: FooterArrangement;
     kind: 'integrated-legal' | 'separate-legal-region';
     navigationLayout: FooterNavigationLayout;
 }>;
-export type FooterVisualGroupKind = 'identity' | 'main-navigation' | 'visit' | 'engagement' | 'legal-ending';
+export type FooterVisualGroupKind = 'social' | 'identity' | 'main-navigation' | 'visit' | 'engagement' | 'legal-ending';
 export type FooterColumnCount = 1 | 2 | 3 | 4 | 5;
 export type FooterVisualGroup = Readonly<{
     kind: FooterVisualGroupKind;
     sections: readonly FooterSection[];
     width: 'column' | 'full-row';
+    slot?: FooterArrangementSlot;
 }>;
 export type FooterRenderRegion = Readonly<{
     kind: 'engagement-row' | 'main' | 'bottom';
     columns: FooterColumnCount;
+    slot?: FooterArrangementSlot;
     groups: readonly FooterVisualGroup[];
 }>;
 export type FooterArrangementPlan = Readonly<{

package/dist/_dts/core/src/footer-composition.d.ts

@@ -1,7 +1,7 @@
 import type { FooterCompositionError, FooterCompositionV1, FooterModuleId, FooterSection, FooterSourceAvailability, ResolvedFooterSection } from './footer-composition-types';
 import { type FooterEngagementSection } from './footer-engagement';
 import { type Result } from './result';
-export { planFooterArrangement } from './footer-arrangement';
+export { planFooterArrangement, footerArrangementPolicy } from './footer-arrangement';
 export type * from './footer-composition-types';
 export declare function unsafeAsFooterModuleId(value: string): FooterModuleId;
 export declare function parseFooterModuleId(value: unknown): Result<FooterModuleId, FooterCompositionError>;

package/dist/_dts/core/src/footer-navigation-layout.d.ts

@@ -1,4 +1,7 @@
+import type { FooterArrangement } from './footer-composition-types';
 export declare const footerNavigationLayouts: readonly ["stack", "inline-wrap"];
 export type FooterNavigationLayout = (typeof footerNavigationLayouts)[number];
 export declare const defaultFooterNavigationLayout: FooterNavigationLayout;
 export declare function normalizeFooterNavigationLayout(value: 'stack' | 'inline' | 'inline-wrap' | null | undefined): FooterNavigationLayout;
+/** The arrangement chooses presentation; the stored preference remains intact. */
+export declare function effectiveFooterNavigationLayout(arrangement: FooterArrangement, stored: FooterNavigationLayout): FooterNavigationLayout;

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

@@ -24,6 +24,8 @@ export * from './booking-live-payment-terms';
 export * from './booking-payment-options';
 export * from './appointment-booking-terms';
 export * from './booking-date-time';
+export { formatDate, formatDateRange, formatDateTime, formatDateTimeRange, formatTime, formatTimeRange, formatTimeAgo, formatTimeUntil, inferSiteDateLocale, resolveBookingDisplayContext, type DisplayContext, type DisplayDate, type DateStyle, type ZoneLabel, type DisplayDateOptions, type DisplayTimeOptions, type DisplayDateTimeOptions, type DateTimeSpan, type BookingDisplayContext, } from './date-display';
+export * from './scheduled-date-time';
 export * from './booking-consent';
 export * from './appointment-service-categories';
 export * from './dated-offering-settlement';

package/dist/_dts/core/src/mailing-list-setup.d.ts

@@ -17,6 +17,9 @@ export type MailingListSetupRevision = Brand<number, 'MailingListSetupRevision'>
 export type MailingListProfileField = 'name' | 'first_name' | 'last_name' | 'company' | 'phone';
 export type MailingListGlobalFields = Readonly<{
     preset: 'emailOnly';
+}> | Readonly<{
+    preset: 'emailFirstName';
+    firstName: 'required' | 'optional';
 }> | Readonly<{
     preset: 'emailName';
     name: 'required' | 'optional';

package/dist/_dts/core/src/mailing-list-submission.d.ts

@@ -1,6 +1,6 @@
 import { type Brand, type ContentVersionId, type SiteId } from './branded';
 import type { FooterModuleId } from './footer-composition-types';
-import type { BrevoConfirmation, MailingListGlobalForm, MailingListProvider, MailingListSetupRevision, ToggleConfirmation } from './mailing-list-setup';
+import type { BrevoConfirmation, MailingListGlobalForm, MailingListProvider, MailingListProfileField, MailingListSetupRevision, ToggleConfirmation } from './mailing-list-setup';
 import type { ResolvedMailingListTarget } from './mailing-list-targeting';
 import type { BrevoConnectionId, MailchimpConnectionId } from './mailing-list-identifiers';
 export declare const MAILING_LIST_SUBMISSION_BUDGET_MS = 10000;
@@ -77,6 +77,9 @@ export type MailingListSignupProfile = (MailingListSignupProfileBase & Readonly<
 }>) | (MailingListSignupProfileBase & Readonly<{
     preset: 'emailName';
     name: ResolvedMailingListProfileField;
+}>) | (MailingListSignupProfileBase & Readonly<{
+    preset: 'emailFirstName';
+    firstName: ResolvedMailingListProfileField;
 }>) | (MailingListSignupProfileBase & Readonly<{
     preset: 'emailFirstLast';
     firstName: ResolvedMailingListProfileField;
@@ -107,6 +110,8 @@ export declare function parseMailingListSignupProfile(form: MailingListGlobalFor
     ok: false;
     error: MailingListSignupProfileParseError;
 }>;
+/** One projection consumed by native signup and external provider adapters. */
+export declare function mailingListSignupProfileValues(profile: MailingListSignupProfile): Readonly<Record<MailingListProfileField, string | null>>;
 type ResolvedMailingListSignupIntentBase = Readonly<{
     siteId: SiteId;
     setupRevision: MailingListSetupRevision;

package/dist/_dts/core/src/public-profile.d.ts

@@ -75,6 +75,8 @@ export type PublicContactVisibility = Readonly<{
     email: PublicAddressVisibility;
 }>;
 export type PublicProfile = Readonly<{
+    /** Explicitly public offering description; never inferred from private AI notes. */
+    businessDescription: string | null;
     contact: PublicContactDetails | null;
     contactVisibility: PublicContactVisibility;
     openingHours: WeeklyOpeningHours | null;
@@ -92,7 +94,7 @@ export type PublicProfile = Readonly<{
     premises: boolean | null;
 }>;
 export type PublicProfileParseError = Readonly<{
-    code: 'invalid_shape' | 'contact_method_required' | 'invalid_email' | 'invalid_phone' | 'invalid_timezone' | 'invalid_weekdays' | 'invalid_time' | 'invalid_interval' | 'overlapping_intervals' | 'invalid_social_link' | 'invalid_address_visibility' | 'invalid_contact_visibility' | 'invalid_premises' | 'duplicate_social_link_id';
+    code: 'invalid_business_description' | 'invalid_shape' | 'contact_method_required' | 'invalid_email' | 'invalid_phone' | 'invalid_timezone' | 'invalid_weekdays' | 'invalid_time' | 'invalid_interval' | 'overlapping_intervals' | 'invalid_social_link' | 'invalid_address_visibility' | 'invalid_contact_visibility' | 'invalid_premises' | 'duplicate_social_link_id';
     path: string;
     message: string;
 }>;

package/dist/_dts/core/src/scheduled-date-time.d.ts

@@ -0,0 +1,69 @@
+export type ScheduledDateTimeInput = Readonly<{
+    startsAt: string;
+    timeZone: string;
+    locale?: string;
+}>;
+export type ScheduledDateTimeRangeInput = Readonly<{
+    startsAt: string;
+    endsAt: string;
+    timeZone: string;
+    locale?: string;
+}>;
+export type ScheduledIntlDateTimeFormatOptions = Readonly<Omit<Intl.DateTimeFormatOptions, 'timeZone'>>;
+export type ScheduledDateFormatOptions = Readonly<{
+    format?: ScheduledIntlDateTimeFormatOptions;
+}>;
+export type ScheduledCompactTimeFormatOptions = Readonly<{
+    timePresentation?: 'compact';
+    format?: never;
+}>;
+export type ScheduledStandardTimeFormatOptions = Readonly<{
+    timePresentation: 'standard';
+    format?: ScheduledIntlDateTimeFormatOptions;
+}>;
+export type ScheduledTimeFormatOptions = ScheduledCompactTimeFormatOptions | ScheduledStandardTimeFormatOptions;
+export type ScheduledDateTimeFormatOptions = Readonly<{
+    dateFormat?: ScheduledIntlDateTimeFormatOptions;
+    time?: ScheduledTimeFormatOptions;
+}>;
+export type RiverbankDateTimeFormatErrorDetails = Readonly<{
+    code: 'invalid_starts_at';
+    field: 'startsAt';
+    value: string;
+}> | Readonly<{
+    code: 'invalid_ends_at';
+    field: 'endsAt';
+    value: string;
+}> | Readonly<{
+    code: 'missing_ends_at';
+    field: 'endsAt';
+    value: string;
+}> | Readonly<{
+    code: 'invalid_time_zone';
+    field: 'timeZone';
+    value: string;
+}> | Readonly<{
+    code: 'invalid_locale';
+    field: 'locale';
+    value: string;
+}> | Readonly<{
+    code: 'end_before_start';
+    field: 'endsAt';
+    value: string;
+}>;
+export type RiverbankDateTimeFormatErrorCode = RiverbankDateTimeFormatErrorDetails['code'];
+export type RiverbankDateTimeFormatErrorField = RiverbankDateTimeFormatErrorDetails['field'];
+export declare class RiverbankDateTimeFormatError extends Error {
+    readonly name = "RiverbankDateTimeFormatError";
+    readonly code: RiverbankDateTimeFormatErrorCode;
+    readonly field: RiverbankDateTimeFormatErrorField;
+    readonly value: string;
+    constructor(details: RiverbankDateTimeFormatErrorDetails);
+}
+/** Public contract adapters: admission/options here, all presentation in date-display. */
+export declare function formatScheduledDate(input: ScheduledDateTimeInput, options?: ScheduledDateFormatOptions): string;
+export declare function formatScheduledTime(input: ScheduledDateTimeInput, options?: ScheduledTimeFormatOptions): string;
+export declare function formatScheduledDateTime(input: ScheduledDateTimeInput, options?: ScheduledDateTimeFormatOptions): string;
+export declare function formatScheduledDateRange(input: ScheduledDateTimeRangeInput, options?: ScheduledDateFormatOptions): string;
+export declare function formatScheduledTimeRange(input: ScheduledDateTimeRangeInput, options?: ScheduledTimeFormatOptions): string;
+export declare function formatScheduledDateTimeRange(input: ScheduledDateTimeRangeInput, options?: ScheduledDateTimeFormatOptions): string;