@riverbankcms/sdk 0.127.0 → 0.129.0

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

@@ -1,22 +1,7 @@
 import { type InteractiveIslandProps } from '../../../contracts/islands';
-import { type NewsletterSignupDestinationProvider, type NewsletterSignupPublicDestinationRef } from '../../blocks/newsletter-signup-destination';
-import { type NewsletterButtonVariant, type NewsletterFieldDef, type NewsletterPreset } from './newsletter-form.types';
-export type NewsletterFormSourceProps = Readonly<{
-    blockId?: string | null;
-    siteId?: string;
-    apiBaseUrl?: string;
-    listId?: string | null;
-    destinationProvider?: NewsletterSignupDestinationProvider | null;
-    preset?: NewsletterPreset;
-    includePhone?: boolean;
-    buttonLabel?: string | null;
-    buttonVariant?: NewsletterButtonVariant | null;
-    successMessage?: string | null;
-    privacyNote?: string | null;
-    tags?: string | null;
-    spamProtectionEnabled?: boolean;
-    className?: string | null;
-}>;
+import { type NewsletterSignupPublicDestinationRef } from '../../blocks/newsletter-signup-destination';
+import { type NewsletterButtonVariant, type NewsletterFieldDef, type NewsletterFormProps, type NewsletterPreset } from './newsletter-form.types';
+export type NewsletterFormSourceProps = NewsletterFormProps;
 export type NewsletterFormDisplay = Readonly<{
     kind: 'newsletter-form';
     className: string | null;
@@ -27,13 +12,28 @@ export type NewsletterFormDisplay = Readonly<{
     fields: readonly NewsletterFieldDef[];
 }>;
 export type NewsletterFormHydration = Readonly<{
-    destinationRef?: NewsletterSignupPublicDestinationRef | null;
-    listId?: string | null;
+    target: NewsletterFormHydrationTarget;
     preset: NewsletterPreset;
     includePhone: boolean;
     tags?: string | null;
     spamProtectionEnabled?: boolean;
 }>;
+export type NewsletterFormHydrationTarget = Readonly<{
+    tag: 'block-source';
+    destinationRef: NewsletterSignupBlockDestinationRef | null;
+}> | Readonly<{
+    tag: 'signed-footer-source';
+    destinationRef: NewsletterSignupSignedDestinationRef;
+}> | Readonly<{
+    tag: 'legacy-direct-list';
+    listId: string | null;
+}>;
+type NewsletterSignupBlockDestinationRef = Extract<NewsletterSignupPublicDestinationRef, {
+    tag: 'block_ref';
+}>;
+type NewsletterSignupSignedDestinationRef = Extract<NewsletterSignupPublicDestinationRef, {
+    tag: 'signed_destination_ref';
+}>;
 type NewsletterIslandMeta = Readonly<{
     siteId?: string;
     apiBaseUrl?: string;
@@ -42,22 +42,7 @@ export declare function buildNewsletterDisplay(source: NewsletterFormSourceProps
 export type NewsletterFormInteractiveIslandProps = InteractiveIslandProps<NewsletterIslandMeta, 'newsletter-form', typeof newsletterFormBlockRuntime>;
 export declare const newsletterFormBlockRuntime: Readonly<{
     kind: "progressive";
-    buildRender: (source: Readonly<{
-        blockId?: string | null;
-        siteId?: string;
-        apiBaseUrl?: string;
-        listId?: string | null;
-        destinationProvider?: NewsletterSignupDestinationProvider | null;
-        preset?: NewsletterPreset;
-        includePhone?: boolean;
-        buttonLabel?: string | null;
-        buttonVariant?: NewsletterButtonVariant | null;
-        successMessage?: string | null;
-        privacyNote?: string | null;
-        tags?: string | null;
-        spamProtectionEnabled?: boolean;
-        className?: string | null;
-    }>) => Readonly<{
+    buildRender: (source: NewsletterFormProps) => Readonly<{
         display: Readonly<{
             kind: "newsletter-form";
             className: string | null;
@@ -68,8 +53,7 @@ export declare const newsletterFormBlockRuntime: Readonly<{
             fields: readonly NewsletterFieldDef[];
         }>;
         hydration: Readonly<{
-            destinationRef?: NewsletterSignupPublicDestinationRef | null;
-            listId?: string | null;
+            target: NewsletterFormHydrationTarget;
             preset: NewsletterPreset;
             includePhone: boolean;
             tags?: string | null;
@@ -78,38 +62,8 @@ export declare const newsletterFormBlockRuntime: Readonly<{
     }>;
     contracts: Readonly<{
         source: Readonly<{
-            encode: (value: Readonly<{
-                blockId?: string | null;
-                siteId?: string;
-                apiBaseUrl?: string;
-                listId?: string | null;
-                destinationProvider?: NewsletterSignupDestinationProvider | null;
-                preset?: NewsletterPreset;
-                includePhone?: boolean;
-                buttonLabel?: string | null;
-                buttonVariant?: NewsletterButtonVariant | null;
-                successMessage?: string | null;
-                privacyNote?: string | null;
-                tags?: string | null;
-                spamProtectionEnabled?: boolean;
-                className?: string | null;
-            }>) => unknown;
-            decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
-                blockId?: string | null;
-                siteId?: string;
-                apiBaseUrl?: string;
-                listId?: string | null;
-                destinationProvider?: NewsletterSignupDestinationProvider | null;
-                preset?: NewsletterPreset;
-                includePhone?: boolean;
-                buttonLabel?: string | null;
-                buttonVariant?: NewsletterButtonVariant | null;
-                successMessage?: string | null;
-                privacyNote?: string | null;
-                tags?: string | null;
-                spamProtectionEnabled?: boolean;
-                className?: string | null;
-            }>>;
+            encode: (value: NewsletterFormProps) => unknown;
+            decode: (input: unknown) => import("../../../contracts").DecodeResult<NewsletterFormProps>;
         }>;
         render: Readonly<{
             encode: (value: Readonly<{
@@ -123,8 +77,7 @@ export declare const newsletterFormBlockRuntime: Readonly<{
                     fields: readonly NewsletterFieldDef[];
                 }>;
                 hydration: Readonly<{
-                    destinationRef?: NewsletterSignupPublicDestinationRef | null;
-                    listId?: string | null;
+                    target: NewsletterFormHydrationTarget;
                     preset: NewsletterPreset;
                     includePhone: boolean;
                     tags?: string | null;
@@ -142,8 +95,7 @@ export declare const newsletterFormBlockRuntime: Readonly<{
                     fields: readonly NewsletterFieldDef[];
                 }>;
                 hydration: Readonly<{
-                    destinationRef?: NewsletterSignupPublicDestinationRef | null;
-                    listId?: string | null;
+                    target: NewsletterFormHydrationTarget;
                     preset: NewsletterPreset;
                     includePhone: boolean;
                     tags?: string | null;
@@ -153,6 +105,7 @@ export declare const newsletterFormBlockRuntime: Readonly<{
         }>;
     }>;
 }>;
+export declare function projectNewsletterFormHydrationTarget(source: NewsletterFormSourceProps): NewsletterFormHydrationTarget;
 export declare const newsletterFormInteractiveIslandPropsCodec: Readonly<{
     encode: (value: Readonly<Readonly<{
         siteId?: string;
@@ -172,8 +125,7 @@ export declare const newsletterFormInteractiveIslandPropsCodec: Readonly<{
                 fields: readonly NewsletterFieldDef[];
             }>;
             hydration: Readonly<{
-                destinationRef?: NewsletterSignupPublicDestinationRef | null;
-                listId?: string | null;
+                target: NewsletterFormHydrationTarget;
                 preset: NewsletterPreset;
                 includePhone: boolean;
                 tags?: string | null;
@@ -199,8 +151,7 @@ export declare const newsletterFormInteractiveIslandPropsCodec: Readonly<{
                 fields: readonly NewsletterFieldDef[];
             }>;
             hydration: Readonly<{
-                destinationRef?: NewsletterSignupPublicDestinationRef | null;
-                listId?: string | null;
+                target: NewsletterFormHydrationTarget;
                 preset: NewsletterPreset;
                 includePhone: boolean;
                 tags?: string | null;

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.server.d.ts

@@ -6,5 +6,5 @@ import type { NewsletterFormProps } from './newsletter-form.types';
  * Renders the newsletter signup form for SSR with hydration support.
  * Uses the islands architecture pattern to hydrate on the client.
  */
-export declare function NewsletterFormSSR({ blockId, siteId, apiBaseUrl, listId, destinationProvider, preset, includePhone, buttonLabel, buttonVariant, successMessage, privacyNote, tags, spamProtectionEnabled, className, }: NewsletterFormProps): React.JSX.Element;
+export declare function NewsletterFormSSR(props: NewsletterFormProps): React.JSX.Element;
 export default NewsletterFormSSR;

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.submission.d.ts

@@ -1,5 +1,5 @@
 import type { NewsletterSubscribeTarget } from '../api/types';
-import type { NewsletterSignupPublicDestinationRef } from '../../blocks/newsletter-signup-destination';
+import type { NewsletterFormHydrationTarget } from './newsletter-form.interactive';
 export type NewsletterFormRawSubmissionFields = Readonly<{
     email: FormDataEntryValue | null;
     firstName: FormDataEntryValue | null;
@@ -23,10 +23,7 @@ export type NewsletterSubmitTargetResolution = Readonly<{
     target: NewsletterSubscribeTarget;
 }> | Readonly<{
     tag: 'unavailable';
-    reason: 'missing_legacy_list';
+    reason: 'missing_block_source' | 'missing_legacy_list';
 }>;
 export declare function mapNewsletterFormFieldsToSubscriberInput(fields: NewsletterFormRawSubmissionFields): NewsletterFormSubmissionFields;
-export declare function resolveNewsletterSubmitTarget(input: Readonly<{
-    listId?: string | null;
-    destinationRef?: NewsletterSignupPublicDestinationRef | null;
-}>): NewsletterSubmitTargetResolution;
+export declare function resolveNewsletterSubmitTarget(input: NewsletterFormHydrationTarget): NewsletterSubmitTargetResolution;

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.types.d.ts

@@ -3,7 +3,7 @@
  *
  * Shared types for the newsletter form server and client components.
  */
-import type { NewsletterSignupFieldPreset } from '../../blocks/newsletter-signup-destination';
+import type { NewsletterSignupDestinationProvider, NewsletterSignupFieldPreset, NewsletterSignupPublicDestinationRef } from '../../blocks/newsletter-signup-destination';
 import type { BlockButtonRole } from '../../constants/buttonRoles';
 export type NewsletterPreset = NewsletterSignupFieldPreset;
 export type NewsletterFieldDef = {
@@ -15,17 +15,11 @@ export type NewsletterFieldDef = {
 };
 export type NewsletterDestinationProvider = 'riverbank' | 'mailchimp';
 export type NewsletterButtonVariant = BlockButtonRole;
-export type NewsletterFormProps = {
-    /** Block ID for island hydration */
-    blockId?: string | null;
+type NewsletterFormCommonProps = {
     /** Site ID for API calls */
     siteId?: string;
     /** API base URL for client-side fetching */
     apiBaseUrl?: string;
-    /** Newsletter list ID to subscribe users to */
-    listId?: string | null;
-    /** Active signup destination provider */
-    destinationProvider?: NewsletterDestinationProvider | null;
     /** Field preset configuration */
     preset?: NewsletterPreset;
     /** Adds an optional phone field to the selected preset */
@@ -45,9 +39,34 @@ export type NewsletterFormProps = {
     /** Additional CSS class */
     className?: string | null;
 };
+type BlockNewsletterFormSource = Readonly<{
+    source: 'block';
+    blockId?: string | null;
+    destinationProvider?: NewsletterSignupDestinationProvider | null;
+    /** Authoring state only; public submission authority is always blockId. */
+    listId?: string | null;
+}>;
+type SignedFooterNewsletterFormSource = Readonly<{
+    source: 'signed-footer';
+    destinationRef: Extract<NewsletterSignupPublicDestinationRef, {
+        tag: 'signed_destination_ref';
+    }>;
+    blockId?: never;
+    destinationProvider?: never;
+    listId?: never;
+}>;
+type LegacyDirectListNewsletterFormSource = Readonly<{
+    source: 'legacy-direct-list';
+    listId: string | null;
+    blockId?: never;
+    destinationRef?: never;
+    destinationProvider?: never;
+}>;
+export type NewsletterFormProps = NewsletterFormCommonProps & (BlockNewsletterFormSource | SignedFooterNewsletterFormSource | LegacyDirectListNewsletterFormSource);
 /**
  * Get form fields based on preset configuration.
  */
 export declare function getPresetFields(preset: NewsletterPreset, options?: {
     includePhone?: boolean;
 }): NewsletterFieldDef[];
+export {};

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

@@ -0,0 +1,21 @@
+import { type FooterCompositionV1 } from '../../core/src/index';
+import type { FooterRuntimeViewModel } from '../../blocks/src/client/site-chrome';
+import { type FooterEditorTarget, type planFooterEditorView } from './footerComposer';
+import type { SaveState } from './useFooterComposerState';
+type FooterPlan = ReturnType<typeof planFooterEditorView>;
+export declare function SaveBadge({ state }: {
+    state: SaveState;
+}): import("react").JSX.Element | null;
+export declare function FooterPreview({ runtime, }: {
+    runtime: FooterRuntimeViewModel;
+}): import("react").JSX.Element;
+export declare function FooterOverview({ plan, composition, onTarget, onChange, manageLinksHref, manageSettingsHref, onEngagement, }: {
+    plan: FooterPlan;
+    composition: FooterCompositionV1;
+    onTarget: (target: FooterEditorTarget) => void;
+    onChange: (composition: FooterCompositionV1) => void;
+    manageLinksHref: string;
+    manageSettingsHref: string;
+    onEngagement: () => void;
+}): import("react").JSX.Element;
+export {};

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

@@ -1,11 +1,13 @@
 import { type ReactNode } from 'react';
 import type { ApiClient } from '../../api/src/request';
 import { type FooterEditorTarget } from './footerComposer';
-export declare function FooterComposerPanel({ apiClient, siteId: rawSiteId, customFooterMode, manageLinksHref, manageSettingsHref, legalRegion, initialTarget, variant, canEdit, onSaved, loadingFallback, }: {
+export declare function FooterComposerPanel({ apiClient, siteId: rawSiteId, customFooterMode, manageLinksHref, manageFormsHref, manageNewsletterHref, manageSettingsHref, legalRegion, initialTarget, variant, canEdit, onSaved, loadingFallback, }: {
     apiClient: ApiClient;
     siteId: string;
     customFooterMode: 'default' | 'blocks' | 'default+blocks' | 'none';
     manageLinksHref: string;
+    manageFormsHref?: string;
+    manageNewsletterHref?: string;
     manageSettingsHref: string;
     legalRegion?: 'integrated' | 'separate';
     initialTarget?: FooterEditorTarget;

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

@@ -0,0 +1,31 @@
+import type { FooterEngagementAuthoringOptions } from '../../api/src/footer-settings';
+import type { FooterEngagementDraft, FooterEngagementDraftEvent } from './footerEngagementDraft';
+type DispatchDraft = (event: FooterEngagementDraftEvent) => void;
+export declare function EngagementKindChoice({ dispatch, kind, }: Readonly<{
+    dispatch: DispatchDraft;
+    kind: FooterEngagementDraft['kind'];
+}>): import("react").JSX.Element;
+export declare function EngagementCopyFields({ dispatch, draft, error, }: Readonly<{
+    dispatch: DispatchDraft;
+    draft: FooterEngagementDraft;
+    error: string | null;
+}>): import("react").JSX.Element;
+export declare function EngagementPlacementChoice({ dispatch, treatment, }: Readonly<{
+    dispatch: DispatchDraft;
+    treatment: FooterEngagementDraft['treatment'];
+}>): import("react").JSX.Element;
+export declare function StandardContactChoice({ dispatch, formId, manageFormsHref, options, }: Readonly<{
+    dispatch: DispatchDraft;
+    formId: string;
+    manageFormsHref: string;
+    options: FooterEngagementAuthoringOptions;
+}>): import("react").JSX.Element;
+export declare function MailingListChoice({ dispatch, draft, manageNewsletterHref, options, }: Readonly<{
+    dispatch: DispatchDraft;
+    draft: Extract<FooterEngagementDraft, {
+        kind: 'mailing-list';
+    }>;
+    manageNewsletterHref: string;
+    options: FooterEngagementAuthoringOptions;
+}>): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,17 @@
+import type { FooterEngagementSection } from '../../core/src/index';
+import type { FooterEngagementAuthoringOptions } from '../../api/src/footer-settings';
+import type { FooterEngagementReadiness } from './footerEngagementEditor';
+type FooterEngagementEditorPanelProps = Readonly<{
+    candidate: FooterEngagementSection | null;
+    current: FooterEngagementSection | null;
+    manageFormsHref: string;
+    manageNewsletterHref: string;
+    onApply: () => void;
+    onCancel: () => void;
+    onPreview: (candidate: FooterEngagementSection) => void;
+    onRemove: () => void;
+    options: FooterEngagementAuthoringOptions;
+    readiness: FooterEngagementReadiness;
+}>;
+export declare function FooterEngagementEditorPanel(props: FooterEngagementEditorPanelProps): import("react").JSX.Element;
+export {};

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

@@ -4,6 +4,8 @@ export type FooterEditorTarget = Readonly<{
 }> | Readonly<{
     kind: 'module';
     moduleId: FooterModuleId;
+}> | Readonly<{
+    kind: 'engagement';
 }> | Readonly<{
     kind: 'shared-profile';
     section: 'contact' | 'opening-hours' | 'social-links';
@@ -48,6 +50,7 @@ type FooterEditorViewPlanInput = Readonly<{
     hasLogo?: boolean;
     hasMainNavigation?: boolean;
     hasLegalPolicyNavigation?: boolean;
+    hasEngagementSource?: boolean;
     canEdit: boolean;
     legalRegion?: 'integrated' | 'separate';
 }>;

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

@@ -0,0 +1,57 @@
+import { type FooterEngagementSection, type Result } from '../../core/src/index';
+type FooterEngagementDraftBase = Readonly<{
+    treatment: FooterEngagementSection['treatment'];
+    heading: string;
+    intro: string;
+}>;
+type FooterMailingCopyDraft = Readonly<{
+    buttonLabel: string;
+    successMessage: string;
+    privacyNote: string;
+}>;
+export type FooterEngagementDraft = (FooterEngagementDraftBase & Readonly<{
+    kind: 'standard-contact';
+    formId: string;
+}>) | (FooterEngagementDraftBase & FooterMailingCopyDraft & Readonly<{
+    kind: 'mailing-list';
+    destination: Readonly<{
+        provider: 'riverbank';
+        listId: string;
+    }> | Readonly<{
+        provider: 'mailchimp';
+        audienceId: string;
+    }>;
+}>);
+export type FooterEngagementDraftEvent = Readonly<{
+    type: 'select-kind';
+    kind: FooterEngagementDraft['kind'];
+}> | Readonly<{
+    type: 'set-treatment';
+    treatment: FooterEngagementDraft['treatment'];
+}> | Readonly<{
+    type: 'set-heading';
+    heading: string;
+}> | Readonly<{
+    type: 'set-intro';
+    intro: string;
+}> | Readonly<{
+    type: 'set-form';
+    formId: string;
+}> | Readonly<{
+    type: 'select-mailing-provider';
+    provider: 'riverbank' | 'mailchimp';
+}> | Readonly<{
+    type: 'set-mailing-destination';
+    id: string;
+}> | Readonly<{
+    type: 'set-mailing-copy';
+    field: keyof FooterMailingCopyDraft;
+    value: string;
+}>;
+export declare function reduceFooterEngagementDraft(draft: FooterEngagementDraft, event: FooterEngagementDraftEvent): FooterEngagementDraft;
+export declare function createFooterEngagementDraft(section: FooterEngagementSection | null): FooterEngagementDraft;
+type DraftParseError = Readonly<{
+    message: string;
+}>;
+export declare function parseFooterEngagementDraft(draft: FooterEngagementDraft, currentId: string, mailchimpConnectionId: string): Result<FooterEngagementSection, DraftParseError>;
+export {};

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

@@ -0,0 +1,11 @@
+import type { FooterEngagementSection } from '../../core/src/index';
+import type { FooterEngagementAuthoringOptions } from '../../api/src/footer-settings';
+import type { FooterResolvedEngagement } from '../../blocks/src/client/site-chrome';
+export type FooterEngagementReadiness = Readonly<{
+    kind: 'ready';
+}> | Readonly<{
+    kind: 'needs-repair';
+    message: string;
+}>;
+export declare function resolveFooterEngagementAuthoringState(section: FooterEngagementSection | null, options: FooterEngagementAuthoringOptions): FooterEngagementReadiness;
+export declare function resolveFooterEngagementPreview(section: FooterEngagementSection | null, options: FooterEngagementAuthoringOptions): FooterResolvedEngagement;

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

@@ -0,0 +1,13 @@
+import { type FooterResolvedEngagement, type FooterRuntimeViewModel } from '../../blocks/src/client/site-chrome';
+import type { FooterCompositionV1, PublicProfile } from '../../core/src/index';
+export type FooterPreviewRuntimeInput = Readonly<{
+    composition: FooterCompositionV1;
+    publicProfile: PublicProfile;
+    hasBusinessAddress: boolean;
+    hasLogo: boolean;
+    hasMainNavigation: boolean;
+    hasLegalPolicyNavigation: boolean;
+    legalRegion: 'integrated' | 'separate';
+    engagement: FooterResolvedEngagement;
+}>;
+export declare function buildFooterPreviewRuntime(input: FooterPreviewRuntimeInput): FooterRuntimeViewModel;

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

@@ -25,6 +25,7 @@ export { PreviewRichTextEditor } from './primitives/PreviewRichTextEditor';
 export { recordsEqual as editorValuesEqual } from './ui/stores/utils';
 export { footerModuleLabel, planFooterEditorView, type FooterEditorSectionPlan, type FooterEditorSource, type FooterEditorTarget, type FooterEditorViewPlan, } from './footerComposer';
 export { FooterComposerPanel } from './FooterComposerPanel';
+export { resolveFooterEngagementAuthoringState, type FooterEngagementReadiness, } from './footerEngagementEditor';
 export { useStoreBinding, parseEditorPath } from './primitives/shared';
 export type { PathInfo } from './primitives/shared';
 export * from './ai/overlayHelpers';

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

@@ -0,0 +1,35 @@
+import { type FooterCompositionSnapshot, type PublicProfileSnapshot } from '../../api/src/footer-settings';
+import type { ApiClient } from '../../api/src/request';
+import { type FooterCompositionV1, type PublicProfile } from '../../core/src/index';
+import type { FooterEditorTarget } from './footerComposer';
+export type SaveState = 'idle' | 'saving' | 'saved' | 'conflict' | 'failed';
+export type CompositionSaveOutcome = 'saved' | 'conflict' | 'failed';
+type FooterComposerStateOptions = Readonly<{
+    apiClient: ApiClient;
+    canEdit: boolean;
+    initialTarget?: FooterEditorTarget;
+    onSaved?: () => void;
+    rawSiteId: string;
+}>;
+export declare function useFooterComposerState({ apiClient, canEdit, initialTarget, onSaved, rawSiteId, }: FooterComposerStateOptions): {
+    message: string | null;
+    saveComposition: (next: FooterCompositionV1, optimistic?: boolean) => Promise<CompositionSaveOutcome>;
+    saveProfile: (next: PublicProfile) => Promise<void>;
+    saveState: SaveState;
+    siteId: import("../../core/src/index").SiteId;
+    target: FooterEditorTarget;
+    setTarget: import("react").Dispatch<import("react").SetStateAction<FooterEditorTarget>>;
+    compositionSnapshot: FooterCompositionSnapshot | null;
+    engagementOptions: Readonly<{
+        forms: readonly import("../../api/src/footerSettings").FooterFormSummary[];
+        newsletterLists: readonly import("../../api/src/index").NewsletterListRecord[];
+        mailchimp: import("../../api/src/index").ListMailchimpAudiencesResponse;
+    }> | null;
+    load: () => Promise<void>;
+    loadError: string | null;
+    navigationMenus: import("../../api/src/index").NavigationMenuWithItems[] | null;
+    profileSnapshot: PublicProfileSnapshot | null;
+    setCompositionSnapshot: import("react").Dispatch<import("react").SetStateAction<FooterCompositionSnapshot | null>>;
+    setProfileSnapshot: import("react").Dispatch<import("react").SetStateAction<PublicProfileSnapshot | null>>;
+};
+export {};

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

@@ -0,0 +1,2 @@
+import type { FooterArrangementPlan, FooterLookPolicy, RenderableFooterSection } from './footer-composition-types';
+export declare function planFooterArrangement(renderableSections: readonly RenderableFooterSection[], policy: FooterLookPolicy): FooterArrangementPlan;

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

@@ -0,0 +1,118 @@
+import type { Brand } from './branded';
+import type { FooterEngagementSection, FooterEngagementSource } from './footer-engagement';
+import type { RichTextDoc } from './rich-text';
+export type FooterModuleId = Brand<string, 'FooterModuleId'>;
+export type FooterMembershipKey = Brand<string, 'FooterMembershipKey'>;
+export type FooterRichText = RichTextDoc;
+export type FooterNavigationRole = 'main' | 'legal-policy';
+type FooterSectionBase<TKind extends string> = Readonly<{
+    id: FooterModuleId;
+    kind: TKind;
+    heading: string | null;
+    selected: boolean;
+}>;
+export type FooterSection = (FooterSectionBase<'brand'> & Readonly<{
+    showLogo: boolean;
+    showTitle: boolean;
+}>) | (FooterSectionBase<'navigation'> & Readonly<{
+    source: Readonly<{
+        kind: 'menu-role';
+        role: 'main';
+    }>;
+}>) | (FooterSectionBase<'legal-navigation'> & Readonly<{
+    source: Readonly<{
+        kind: 'menu-role';
+        role: 'legal-policy';
+    }>;
+}>) | (FooterSectionBase<'business-address'> & Readonly<{
+    source: Readonly<{
+        kind: 'business-address';
+    }>;
+}>) | (FooterSectionBase<'contact'> & Readonly<{
+    source: Readonly<{
+        kind: 'public-profile';
+    }>;
+}>) | (FooterSectionBase<'opening-hours'> & Readonly<{
+    source: Readonly<{
+        kind: 'public-profile';
+    }>;
+}>) | (FooterSectionBase<'social-links'> & Readonly<{
+    source: Readonly<{
+        kind: 'public-profile';
+    }>;
+}>) | (FooterSectionBase<'supporting-text'> & Readonly<{
+    content: FooterRichText | null;
+}>) | (FooterSectionBase<'legal'> & Readonly<{
+    content: FooterRichText | null;
+}>) | FooterEngagementSection;
+export type FooterSectionKind = FooterSection['kind'];
+export type FooterCompositionV1 = Readonly<{
+    schemaVersion: 1;
+    sections: readonly FooterSection[];
+}>;
+export type FooterCompositionError = Readonly<{
+    code: 'invalid_shape' | 'unsupported_schema_version' | 'invalid_section' | 'duplicate_section_id' | 'duplicate_section_kind' | 'unknown_section';
+    path: string;
+    message: string;
+}>;
+export type FooterLookPolicy = Readonly<{
+    kind: 'integrated-legal';
+}> | Readonly<{
+    kind: 'separate-legal-region';
+}>;
+export type FooterVisualGroupKind = 'identity' | 'main-navigation' | 'visit' | 'engagement' | 'legal-ending';
+export type FooterColumnCount = 1 | 2 | 3 | 4 | 5;
+export type FooterVisualGroup = Readonly<{
+    kind: FooterVisualGroupKind;
+    sections: readonly FooterSection[];
+    span: 1;
+}>;
+export type FooterRenderRegion = Readonly<{
+    kind: 'engagement-row' | 'main' | 'bottom';
+    columns: FooterColumnCount;
+    groups: readonly FooterVisualGroup[];
+}>;
+export type FooterArrangementPlan = Readonly<{
+    membershipKey: FooterMembershipKey;
+    regions: readonly FooterRenderRegion[];
+    mobileGroups: readonly FooterVisualGroup[];
+}>;
+export type FooterRepairTarget = Readonly<{
+    kind: 'site-identity';
+}> | Readonly<{
+    kind: 'navigation';
+    role: FooterNavigationRole;
+}> | Readonly<{
+    kind: 'business-address';
+}> | Readonly<{
+    kind: 'engagement-source';
+    source: FooterEngagementSource['kind'];
+}> | Readonly<{
+    kind: 'public-profile';
+    section: 'contact' | 'opening-hours' | 'social-links';
+}> | Readonly<{
+    kind: 'footer-section';
+    sectionId: FooterModuleId;
+}>;
+export type ResolvedFooterSection = Readonly<{
+    kind: 'renderable';
+    section: FooterSection;
+}> | Readonly<{
+    kind: 'missing-source';
+    section: FooterSection;
+    repairTarget: FooterRepairTarget;
+}>;
+export type RenderableFooterSection = Extract<ResolvedFooterSection, {
+    kind: 'renderable';
+}>;
+export type FooterSourceAvailability = Readonly<{
+    hasLogo: boolean;
+    hasMainNavigation: boolean;
+    hasLegalPolicyNavigation: boolean;
+    hasBusinessAddress: boolean;
+    hasContact: boolean;
+    hasOpeningHours: boolean;
+    hasSocialLinks: boolean;
+    hasEngagementSource: boolean;
+}>;
+export {};