@riverbankcms/sdk 0.152.0 → 0.154.0

package/dist/_dts/blocks/src/system/transforms/registry/footerArrangement.d.ts

@@ -0,0 +1,6 @@
+import type { ThemeFooter } from '../../../../../theme-core/src/schema';
+import { type TransformDefinition } from './core';
+export declare const footerBrandArrangementTransform: TransformDefinition;
+export declare const footerModuleInkStyleTransform: TransformDefinition;
+/** A centred base without authored bar paint inherits its measured surface line. */
+export declare function footerBottomBarBorderColorStyle(footer: Partial<ThemeFooter> | undefined): import("react").CSSProperties;

package/dist/_dts/blocks/src/system/transforms/registry/index.d.ts

@@ -13,3 +13,4 @@ export declare const defaultTransforms: import("./core").TransformRegistry;
 export { boxStyleClassNames } from "./_utils/boxStyleClassNames";
 export { formattingTransforms, layoutTransforms, chromeLogoTransforms, uiTransforms, mediaTransforms, backgroundTransforms, linksTransforms, boxStylesTransforms, contentTransforms, headerRuntimeTransforms, };
 export { resolveAuthoredLinkHref } from './links';
+export type { LinkResolverContext } from '../../links/resolve';

package/dist/_dts/blocks/src/system/transforms/registry/layout.d.ts

@@ -63,20 +63,9 @@ declare const footerBottomBarContainerClassSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const footerBottomBarContainerClassTransform: TransformDefinition<z.infer<typeof footerBottomBarContainerClassSchema>>;
 export declare const footerBottomBarStyleTransform: TransformDefinition;
-declare const footerSplitMainClassSchema: z.ZodObject<{
-    base: z.ZodOptional<z.ZodString>;
-    reverseClass: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const footerSplitMainClassTransform: TransformDefinition<z.infer<typeof footerSplitMainClassSchema>>;
 declare const footerLogoClassSchema: z.ZodObject<{
     base: z.ZodOptional<z.ZodString>;
-    requireExplicitShow: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const footerLogoClassTransform: TransformDefinition<z.infer<typeof footerLogoClassSchema>>;
-declare const footerLogoMediaClassSchema: z.ZodObject<{
-    base: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const footerLogoMediaClassTransform: TransformDefinition<z.infer<typeof footerLogoMediaClassSchema>>;
-export declare const footerLogoTextVisibleTransform: TransformDefinition;
 export declare const layoutTransforms: TransformDefinition[];
 export {};

package/dist/_dts/blocks/src/system/transforms/registry/links.d.ts

@@ -1,6 +1,6 @@
-import type { TransformContext, TransformDefinition } from "./core";
-export type LinkResolutionContext = Pick<TransformContext, 'routes' | 'pagesByIdentifier' | 'entriesByIdentifier' | 'stage'>;
+import type { TransformDefinition } from "./core";
+import { type LinkResolverContext } from "../../links/resolve";
 export declare const resolveLinkTransform: TransformDefinition;
 export declare const linkLabelTransform: TransformDefinition;
 export declare const linksTransforms: TransformDefinition[];
-export declare function resolveAuthoredLinkHref(value: unknown, context?: LinkResolutionContext): string | null;
+export declare function resolveAuthoredLinkHref(value: unknown, context?: LinkResolverContext): string | null;

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/content-model/src/content-types/schema.d.ts

@@ -12,14 +12,14 @@ declare const BaseContentFieldSchema: z.ZodObject<{
         text: "text";
         group: "group";
         url: "url";
+        file: "file";
+        datetime: "datetime";
         textarea: "textarea";
         select: "select";
         media: "media";
         reference: "reference";
-        repeater: "repeater";
-        file: "file";
-        datetime: "datetime";
         button: "button";
+        repeater: "repeater";
         richText: "richText";
     }>;
     label: z.ZodOptional<z.ZodString>;

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-runtime.d.ts

@@ -1,6 +1,6 @@
 import type { BrevoListId, MailchimpAudienceId, MailchimpInterestId } from './mailing-list-identifiers';
 import { type Result } from './result';
-import type { MailingListGlobalForm, MailingListSetupRevision, NativeMailingListTopicId } from './mailing-list-setup';
+import type { MailingListGlobalForm, MailingListSetupRevision, NativeMailingListTopicId, NewsletterAudience } from './mailing-list-setup';
 export type MailingListRuntimeContext = Readonly<{
     tag: 'not_configured';
 }> | Readonly<{
@@ -12,7 +12,7 @@ export type MailingListRuntimeContext = Readonly<{
 }>;
 export type MailingListRuntimeProvider = Readonly<{
     provider: 'native';
-    defaultTopicId: NativeMailingListTopicId;
+    defaultAudience: NewsletterAudience;
     topics: readonly Readonly<{
         id: NativeMailingListTopicId;
         name: string;

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

@@ -1,5 +1,12 @@
-import type { ConfiguredMailingListProvider, MailingListGlobalForm, MailingListSetupRevision, MailingListSiteSetup } from './mailing-list-setup';
+import type { ConfiguredMailingListProvider, MailingListGlobalForm, MailingListSetupRevision, MailingListSiteSetup, NewsletterAudience } from './mailing-list-setup';
 import { type Result } from './result';
+import { z } from 'zod';
+export declare const newsletterAudienceSchema: z.ZodPipe<z.ZodUnknown, z.ZodTransform<Readonly<{
+    kind: "general";
+}> | Readonly<{
+    kind: "topic";
+    topicId: import("./mailing-list-setup").NativeMailingListTopicId;
+}>, unknown>>;
 export type MailingListSetupParseError = Readonly<{
     tag: 'invalid_mailing_list_setup';
     field: 'shape' | 'tag' | 'siteId' | 'revision' | 'form' | 'provider' | 'connectionId' | 'accountId' | 'defaultTargetId' | 'confirmation';
@@ -11,4 +18,5 @@ export type MailingListGlobalFormParseError = Readonly<{
 export declare function parseMailingListGlobalForm(value: unknown): Result<MailingListGlobalForm, MailingListGlobalFormParseError>;
 export declare function parseMailingListSiteSetup(value: unknown): Result<MailingListSiteSetup, MailingListSetupParseError>;
 export declare function parseConfiguredMailingListProvider(value: unknown): Result<ConfiguredMailingListProvider, MailingListSetupParseError>;
+export declare function parseNewsletterAudience(value: unknown): Result<NewsletterAudience, 'invalid_newsletter_audience'>;
 export declare function parseMailingListSetupRevision(value: unknown): MailingListSetupRevision | null;

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

@@ -5,10 +5,21 @@ export type MailingListProvider = 'native' | 'mailchimp' | 'brevo';
 /** The name shown to people for each provider; the native one is the product brand. */
 export declare function mailingListProviderName(provider: MailingListProvider): string;
 export type NativeMailingListTopicId = NewsletterListId;
+/** An explicit subscription scope; absence of a topic never grants general consent. */
+export type NewsletterAudience = Readonly<{
+    kind: 'general';
+}> | Readonly<{
+    kind: 'topic';
+    topicId: NativeMailingListTopicId;
+}>;
+export declare function sameNewsletterAudience(left: NewsletterAudience, right: NewsletterAudience): boolean;
 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';
@@ -48,7 +59,7 @@ export type BrevoConfirmation = Readonly<{
 }>;
 export type NativeMailingListSetup = Readonly<{
     provider: 'native';
-    defaultTopicId: NativeMailingListTopicId;
+    defaultAudience: NewsletterAudience;
     confirmation: ToggleConfirmation;
 }>;
 export type MailchimpMailingListSetup = Readonly<{

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;
@@ -185,7 +190,7 @@ export type MailingListPublicSignupResponse = Readonly<{
     reason: 'profile_rejected';
 }> | Readonly<{
     tag: 'unavailable';
-    reason: 'configuration_unavailable' | 'stale_configuration' | 'authentication_failed' | 'target_unavailable' | 'rate_limited' | 'temporarily_unavailable';
+    reason: 'confirmation_email_failed' | 'configuration_unavailable' | 'stale_configuration' | 'authentication_failed' | 'target_unavailable' | 'rate_limited' | 'temporarily_unavailable';
 }> | Readonly<{
     tag: 'uncertain';
     reason: 'deadline_exceeded' | 'network_interrupted';