@riverbankcms/sdk 0.153.0 → 0.154.0

package/dist/_dts/theme-core/src/site-styles/appearancePresetTypes.d.ts

@@ -4,7 +4,7 @@ import type { ContentFrameIntent, EyebrowTreatment, EventListTreatment, HeroComp
 import type { ItemRole } from '../cards/types';
 import type { AppearancePresetId } from './types';
 import type { LookOption, LookOptionGroup } from './lookOptionGroups';
-export type AppearancePresetTarget = 'hero' | 'intro' | 'body-text' | 'offerings' | 'feature-cards' | 'events' | 'media-text' | 'testimonials' | 'faq' | 'contact-form' | 'newsletter' | 'cta';
+export type AppearancePresetTarget = 'hero' | 'intro' | 'body-text' | 'offerings' | 'feature-cards' | 'events' | 'media-text' | 'image-gallery' | 'testimonials' | 'faq' | 'contact-form' | 'newsletter' | 'cta';
 export type BlockAppearanceDesign = Readonly<{
     sectionSurface: SiteStyleSurfaceIntent;
     contentFrame: ContentFrameIntent;
@@ -55,7 +55,9 @@ export declare const cardListKnobs: readonly ["actionStyle", "showPhotos", "card
 export declare const lookKnobBlocks: {
     readonly actionStyle: readonly [...("block.feature-cards" | "block.appointment-services" | "block.offerings-preview")[], "block.event-calendar"];
     readonly titleSize: "block.hero";
-    readonly imagePosition: "block.hero";
+    readonly imagePosition: readonly ["block.hero", "block.media-text"];
+    readonly imageShape: "block.media-text";
+    readonly aspectRatio: "block.media-text";
     readonly stickerLine: "block.hero";
     readonly smallCaption: "block.hero";
     readonly candleGlow: "block.hero";
@@ -65,7 +67,7 @@ export declare const lookKnobBlocks: {
     readonly dates: "block.offerings-preview";
     readonly showCapacity: "block.event-calendar";
     readonly quoteCount: "block.testimonials";
-    readonly archFrame: "block.testimonials";
+    readonly archFrame: readonly ["block.testimonials", "block.newsletter-signup", "block.form"];
     readonly tilt: "block.testimonials";
 };
 export type LookKnobId = keyof typeof lookKnobBlocks;
@@ -104,7 +106,7 @@ type AppearancePresetIdentity = Readonly<{
     id: string;
     target: AppearancePresetTarget;
     label: string;
-    blockKinds: readonly ('block.hero' | 'block.intro' | 'block.offerings-preview' | 'block.feature-cards' | 'block.event-calendar' | 'block.event-listing' | 'block.event-details' | 'block.media-text' | 'block.testimonials' | 'block.faq' | 'block.form' | 'block.appointment-booking' | 'block.appointment-services' | 'block.cta-full')[];
+    blockKinds: readonly ('block.hero' | 'block.intro' | 'block.body-text' | 'block.offerings-preview' | 'block.feature-cards' | 'block.event-calendar' | 'block.event-listing' | 'block.event-details' | 'block.media-text' | 'block.image-gallery' | 'block.newsletter-signup' | 'block.testimonials' | 'block.faq' | 'block.form' | 'block.appointment-booking' | 'block.appointment-services' | 'block.cta-full')[];
 }>;
 export type LegacyBlockAppearancePreset = AppearancePresetIdentity & Readonly<{
     /**
@@ -135,12 +137,12 @@ export declare function isArrangementAppearancePreset(preset: BlockAppearancePre
 export declare function lookModes(look: ArrangementBlockAppearancePreset): readonly (string | null)[];
 export type AppearancePreset = BlockAppearancePreset;
 export type BlockAppearancePresetTarget = BlockAppearancePreset['target'];
-export declare const appearancePresetTargets: readonly ["hero", "intro", "body-text", "offerings", "feature-cards", "events", "media-text", "testimonials", "faq", "contact-form", "newsletter", "cta"];
+export declare const appearancePresetTargets: readonly ["hero", "intro", "body-text", "offerings", "feature-cards", "events", "media-text", "image-gallery", "testimonials", "faq", "contact-form", "newsletter", "cta"];
 export declare function cardListKnobDefaults(block: string, arrangement: string, knobs: readonly LookKnobId[], defaults: ArrangementBlockAppearancePreset['structure']['knobDefaults']): {
     knobs?: undefined;
     knobDefaults?: undefined;
 } | {
-    knobs: ("dates" | "actionStyle" | "showPhotos" | "cardMarker" | "titleSize" | "imagePosition" | "stickerLine" | "smallCaption" | "candleGlow" | "columnGuides" | "showCapacity" | "quoteCount" | "archFrame" | "tilt")[];
+    knobs: ("dates" | "actionStyle" | "showPhotos" | "cardMarker" | "titleSize" | "imagePosition" | "imageShape" | "aspectRatio" | "stickerLine" | "smallCaption" | "candleGlow" | "columnGuides" | "showCapacity" | "quoteCount" | "archFrame" | "tilt")[];
     knobDefaults: {
         dates?: string | undefined;
         actionStyle: string;
@@ -148,6 +150,8 @@ export declare function cardListKnobDefaults(block: string, arrangement: string,
         cardMarker?: string | undefined;
         titleSize?: string | undefined;
         imagePosition?: string | undefined;
+        imageShape?: string | undefined;
+        aspectRatio?: string | undefined;
         stickerLine?: string | undefined;
         smallCaption?: string | undefined;
         candleGlow?: string | undefined;
@@ -158,6 +162,18 @@ export declare function cardListKnobDefaults(block: string, arrangement: string,
         tilt?: string | undefined;
     };
 };
-export declare function defineArrangementLook(id: string, block: 'hero' | 'feature-cards' | 'event-calendar' | 'testimonials' | 'event-details', name: string, arrangement: string, knobs: readonly LookKnobId[], input?: Partial<Pick<ArrangementBlockAppearancePreset['structure'], 'itemRoles' | 'slotRoles' | 'actionSize' | 'whenMissing' | 'styleFallback' | 'forcedKnobs' | 'knobValues' | 'knobDefaults' | 'knobDescriptions'>>): ArrangementBlockAppearancePreset;
+declare const arrangementLookTargets: {
+    readonly hero: "hero";
+    readonly 'feature-cards': "feature-cards";
+    readonly 'event-calendar': "events";
+    readonly testimonials: "testimonials";
+    readonly 'event-details': "events";
+    readonly 'media-text': "media-text";
+    readonly 'image-gallery': "image-gallery";
+    readonly 'newsletter-signup': "newsletter";
+    readonly form: "contact-form";
+    readonly 'body-text': "body-text";
+};
+export declare function defineArrangementLook(id: string, block: keyof typeof arrangementLookTargets, name: string, arrangement: string, knobs: readonly LookKnobId[], input?: Partial<Pick<ArrangementBlockAppearancePreset['structure'], 'itemRoles' | 'slotRoles' | 'actionSize' | 'whenMissing' | 'styleFallback' | 'forcedKnobs' | 'knobValues' | 'knobDefaults' | 'knobDescriptions'>>): ArrangementBlockAppearancePreset;
 export declare function defineCardListLook(id: string, name: string, arrangement: string, requires: readonly CardListItemPart[], knobs: readonly LookKnobId[], input?: NonNullable<Parameters<typeof defineArrangementLook>[5]>): ArrangementBlockAppearancePreset;
 export {};

package/dist/_dts/theme-core/src/site-styles/backgroundAppearance.d.ts

@@ -2,6 +2,6 @@ import { type ThemeColorToken } from '../tokens';
 export declare const backgroundAppearanceQuickColorTokenNames: readonly ["background", "surface", "muted", "primary", "secondary", "accent"];
 export declare const backgroundAppearanceBaseColorTokenNames: readonly ["background", "surface", "surfaceAlt", "muted", "primary", "secondary", "accent", "neutral"];
 export declare const backgroundAppearanceShadeableColorTokenNames: readonly ["primary", "secondary", "accent", "neutral"];
-export declare const backgroundAppearanceColorTokenNames: readonly ("surface" | "background" | "primary" | "secondary" | "accent" | "surfaceAlt" | "muted" | "neutral" | "neutral-50" | "neutral-900" | "primary-50" | "primary-500" | "primary-900" | "secondary-50" | "secondary-500" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "neutral-100" | "neutral-600" | "primary-400" | "neutral-300" | "neutral-950" | "neutral-800" | "neutral-700" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "accent-400" | "neutral-200" | "secondary-400" | "neutral-400" | "primary-100" | "neutral-500" | "primary-800" | "primary-700" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
-export declare const backgroundAppearanceAdvancedColorTokenNames: ("surface" | "background" | "primary" | "secondary" | "accent" | "surfaceAlt" | "muted" | "neutral" | "neutral-50" | "neutral-900" | "primary-50" | "primary-500" | "primary-900" | "secondary-50" | "secondary-500" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "neutral-100" | "neutral-600" | "primary-400" | "neutral-300" | "neutral-950" | "neutral-800" | "neutral-700" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "accent-400" | "neutral-200" | "secondary-400" | "neutral-400" | "primary-100" | "neutral-500" | "primary-800" | "primary-700" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
+export declare const backgroundAppearanceColorTokenNames: readonly ("surface" | "background" | "primary" | "secondary" | "accent" | "surfaceAlt" | "muted" | "neutral" | "neutral-50" | "neutral-900" | "primary-50" | "primary-500" | "primary-900" | "secondary-50" | "secondary-500" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "neutral-100" | "neutral-600" | "primary-400" | "neutral-300" | "neutral-950" | "neutral-800" | "neutral-700" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "accent-400" | "neutral-200" | "secondary-400" | "neutral-400" | "secondary-950" | "primary-100" | "neutral-500" | "primary-800" | "primary-700" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
+export declare const backgroundAppearanceAdvancedColorTokenNames: ("surface" | "background" | "primary" | "secondary" | "accent" | "surfaceAlt" | "muted" | "neutral" | "neutral-50" | "neutral-900" | "primary-50" | "primary-500" | "primary-900" | "secondary-50" | "secondary-500" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "neutral-100" | "neutral-600" | "primary-400" | "neutral-300" | "neutral-950" | "neutral-800" | "neutral-700" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "accent-400" | "neutral-200" | "secondary-400" | "neutral-400" | "secondary-950" | "primary-100" | "neutral-500" | "primary-800" | "primary-700" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
 export declare function parseBackgroundAppearanceColorToken(value: unknown): ThemeColorToken | null;

package/dist/_dts/theme-core/src/site-styles/compilationPlan.d.ts

@@ -1,3 +1,4 @@
+import { type FooterPreferences } from './footerPreferences';
 import type { Theme } from '../schema';
 import type { ButtonSystem } from '../buttons/types';
 import type { ButtonStyleSelection } from '../buttons/styles/selection';
@@ -53,12 +54,7 @@ export type HeaderPreserveDirective = Readonly<{
 }>;
 export type HeaderCompilationDirective = HeaderPreserveDirective | HeaderRecompileDirective;
 export type FooterCompilationDirective = Readonly<{
-    kind: 'preserve';
-    footer: Theme['footer'];
-    footerLookId: FooterLookId | null;
-}> | Readonly<{
-    kind: 'apply-look';
-    footer: Theme['footer'];
+    preferences: FooterPreferences;
     footerLookId: FooterLookId | null;
 }>;
 export type ButtonUpdateRecompileReason = 'selection-change' | 'missing-applied-buttons';
@@ -88,6 +84,7 @@ export type SiteThemeCompilationPlan = Readonly<{
     buttons: ReplacementButtonRecompileDirective;
     header: HeaderRecompileDirective;
     footerLookId: FooterLookId | null;
+    footerPreferences: FooterPreferences;
 }> | Readonly<{
     kind: 'update-selection';
     buttons: ButtonCompilationDirective;
@@ -98,6 +95,7 @@ export declare function replaceSiteStyleCompilationPlan(input: Readonly<{
     headerSelection: HeaderLayoutStyleSelection;
     buttonStyleSelection?: ButtonStyleSelection | null;
     footerLookId?: FooterLookId | null;
+    footerPreferences?: FooterPreferences;
     headerLogo?: HeaderLogoContext;
 }>): Extract<SiteThemeCompilationPlan, {
     kind: 'replace-site-style';

package/dist/_dts/theme-core/src/site-styles/compileFooterAgainstRow.d.ts

@@ -0,0 +1,121 @@
+import type { Theme } from '../schema';
+import type { CuratedSiteStyle } from './curatedSiteStyles';
+import { type FooterPreferences } from './footerPreferences';
+import { type FooterLookId } from './footerLooks';
+/** The one footer composition: offered selection → recipe → whole intent record. */
+export declare function compileFooterAgainstRow<TTheme extends Theme>(input: Readonly<{
+    theme: TTheme;
+    siteStyle: CuratedSiteStyle | null;
+    lookId: FooterLookId | null;
+    preferences: FooterPreferences;
+}>): {
+    theme: TTheme & {
+        footer: {
+            variant: "split" | "simple" | "centred";
+            maxWidth: "full" | "container";
+            background: {
+                type: "image" | "color" | "gradient";
+                contentOwner?: "site-chrome-editor" | undefined;
+                color?: string | null | undefined;
+                gradient?: {
+                    type: "linear" | "radial" | "conic";
+                    stops: {
+                        color: string;
+                        position: number;
+                    }[];
+                    angle?: number | undefined;
+                    shape?: "circle" | "ellipse" | undefined;
+                    position?: string | undefined;
+                } | null | undefined;
+                image?: import("../../../media-core/src/index").Media | null | undefined;
+                textColor?: string | null | undefined;
+            };
+            navStyle: "scale" | "solid" | "underline" | "minimal" | "underline-grow" | "capsule" | "frosted";
+            navWeight: "bold" | "medium" | "regular" | "semibold";
+            navColor?: string | null | undefined;
+            navLinkStyle?: {
+                colorToken: string;
+                padding: "none" | "compact" | "default";
+                borderRadius: "none" | "full" | "md" | "sm";
+                typography: "heading" | "body";
+                fontWeight: "bold" | "medium" | "regular" | "semibold";
+                textTransform: "none" | "uppercase" | "capitalize";
+                italic: boolean;
+                textSize?: "base" | "lg" | "xl" | "xs" | "sm" | undefined;
+                letterSpacing?: "normal" | "wide" | "wider" | "widest" | undefined;
+                contrastTreatment?: "none" | "soft-glow" | undefined;
+                hoverColorToken?: string | null | undefined;
+                paddingX?: "none" | "compact" | "default" | "tight" | "relaxed" | "spacious" | undefined;
+                effects?: {
+                    base?: {
+                        effectId: string;
+                        options?: Record<string, any> | undefined;
+                    }[] | undefined;
+                    hover?: {
+                        effectId: string;
+                        options?: Record<string, any> | undefined;
+                    }[] | undefined;
+                    active?: {
+                        effectId: string;
+                        options?: Record<string, any> | undefined;
+                    }[] | undefined;
+                    focus?: {
+                        effectId: string;
+                        options?: Record<string, any> | undefined;
+                    }[] | undefined;
+                } | undefined;
+                name?: string | undefined;
+            } | undefined;
+            bottomTextLinkStyle?: {
+                colorToken?: string | undefined;
+                hoverColorToken?: string | null | undefined;
+                decorationColorToken?: string | null | undefined;
+                underline?: boolean | undefined;
+            } | undefined;
+            navLayout?: {
+                layout?: "stack" | "inline-wrap" | "inline" | undefined;
+            } | undefined;
+            logo?: {
+                size?: "md" | "lg" | "xl" | "sm" | undefined;
+                maxHeight?: "md" | "lg" | "xl" | "sm" | undefined;
+                align?: "start" | "end" | "center" | undefined;
+            } | undefined;
+            bottomBar?: {
+                enabled?: boolean | undefined;
+                fullBleed?: boolean | undefined;
+                background?: {
+                    type: "image" | "color" | "gradient";
+                    contentOwner?: "site-chrome-editor" | undefined;
+                    color?: string | null | undefined;
+                    gradient?: {
+                        type: "linear" | "radial" | "conic";
+                        stops: {
+                            color: string;
+                            position: number;
+                        }[];
+                        angle?: number | undefined;
+                        shape?: "circle" | "ellipse" | undefined;
+                        position?: string | undefined;
+                    } | null | undefined;
+                    image?: import("../../../media-core/src/index").Media | null | undefined;
+                    textColor?: string | null | undefined;
+                } | undefined;
+                textColor?: string | null | undefined;
+                textAlign?: "left" | "right" | "center" | undefined;
+                paddingY?: "none" | "compact" | "default" | "tight" | "relaxed" | "spacious" | undefined;
+                paddingX?: "none" | "compact" | "default" | "tight" | "relaxed" | "spacious" | undefined;
+                borderTop?: {
+                    colorToken?: string | null | undefined;
+                    width?: "none" | "medium" | "thin" | "thick" | undefined;
+                } | undefined;
+            } | undefined;
+        };
+    };
+    lookId: FooterLookId;
+    preferences: Readonly<{
+        background: import("../../../blocks/src/index").SiteChromeBackgroundOverride;
+        navigationLayout: "inline-wrap" | "stack";
+    }>;
+};
+/** Style switches retain an offered choice; otherwise use the style's first choice. */
+export declare function resolveFooterLookIdForStyle(siteStyle: Pick<CuratedSiteStyle, 'recommendedFooterLookIds'> | null, current: FooterLookId | null): FooterLookId;

package/dist/_dts/theme-core/src/site-styles/curatedSiteStyles.d.ts

@@ -1,3 +1,4 @@
+import { type FooterLookRecipeOverrides } from './footerLookDefaults';
 import type { SiteStyleLooks } from './lookResolution';
 import { type ButtonStyleSelection } from '../buttons/styles';
 import { type CuratedPalette, type KnownCuratedPaletteValueKey } from '../palette/curated';
@@ -168,6 +169,8 @@ export type CuratedSiteStyle = Readonly<{
      * docs/guides/site-styles.md.
      */
     headerStyleRecipes?: HeaderStyleRecipeOverrides;
+    /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
+    footerLookRecipes?: FooterLookRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -233,6 +236,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * docs/guides/site-styles.md.
      */
     headerStyleRecipes?: HeaderStyleRecipeOverrides;
+    /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
+    footerLookRecipes?: FooterLookRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -282,6 +287,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * docs/guides/site-styles.md.
      */
     headerStyleRecipes?: HeaderStyleRecipeOverrides;
+    /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
+    footerLookRecipes?: FooterLookRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -331,6 +338,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * docs/guides/site-styles.md.
      */
     headerStyleRecipes?: HeaderStyleRecipeOverrides;
+    /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
+    footerLookRecipes?: FooterLookRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -380,6 +389,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * docs/guides/site-styles.md.
      */
     headerStyleRecipes?: HeaderStyleRecipeOverrides;
+    /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
+    footerLookRecipes?: FooterLookRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -429,6 +440,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * docs/guides/site-styles.md.
      */
     headerStyleRecipes?: HeaderStyleRecipeOverrides;
+    /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
+    footerLookRecipes?: FooterLookRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -478,6 +491,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * docs/guides/site-styles.md.
      */
     headerStyleRecipes?: HeaderStyleRecipeOverrides;
+    /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
+    footerLookRecipes?: FooterLookRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -527,6 +542,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * docs/guides/site-styles.md.
      */
     headerStyleRecipes?: HeaderStyleRecipeOverrides;
+    /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
+    footerLookRecipes?: FooterLookRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -576,6 +593,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * docs/guides/site-styles.md.
      */
     headerStyleRecipes?: HeaderStyleRecipeOverrides;
+    /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
+    footerLookRecipes?: FooterLookRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -625,6 +644,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * docs/guides/site-styles.md.
      */
     headerStyleRecipes?: HeaderStyleRecipeOverrides;
+    /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
+    footerLookRecipes?: FooterLookRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -674,6 +695,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * docs/guides/site-styles.md.
      */
     headerStyleRecipes?: HeaderStyleRecipeOverrides;
+    /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
+    footerLookRecipes?: FooterLookRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -724,6 +747,8 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
      * docs/guides/site-styles.md.
      */
     headerStyleRecipes?: HeaderStyleRecipeOverrides;
+    /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
+    footerLookRecipes?: FooterLookRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;

package/dist/_dts/theme-core/src/site-styles/footerLookDefaults.d.ts

@@ -0,0 +1,45 @@
+import type { FooterLookIdValue } from './footerLooks';
+import type { FooterLookRecipe } from './footerLookRecipe';
+export type FooterLookRecipeOverrides = Partial<Record<FooterLookIdValue, FooterLookRecipe>>;
+export type FooterLookRecipeOwner = Readonly<{
+    footerLookRecipes?: FooterLookRecipeOverrides;
+}>;
+export declare const defaultFooterLookRecipes: {
+    readonly 'footer-centred-name': {
+        readonly arrangement: "centred";
+        readonly ground: {
+            readonly kind: "token";
+            readonly token: "surface";
+        };
+        readonly nav: {
+            readonly weight: "regular";
+            readonly colorToken: "text";
+            readonly hoverColorToken: "primary";
+            readonly typography: "body";
+        };
+        readonly legal: {
+            readonly kind: "separate";
+            readonly bar: null;
+        };
+        readonly brandAlign: "center";
+    };
+    readonly 'footer-links-row': {
+        readonly arrangement: "simple";
+        readonly ground: {
+            readonly kind: "token";
+            readonly token: "surface";
+        };
+        readonly nav: {
+            readonly weight: "regular";
+            readonly colorToken: "text";
+            readonly hoverColorToken: "primary";
+            readonly typography: "body";
+        };
+        readonly legal: {
+            readonly kind: "integrated";
+        };
+        readonly brandAlign: "start";
+    };
+};
+/** A whole authored recipe replaces the default; facets are never deep-merged. */
+export declare function resolveFooterLookRecipe(style: FooterLookRecipeOwner | null, id: FooterLookIdValue): FooterLookRecipe;

package/dist/_dts/theme-core/src/site-styles/footerLookRecipe.d.ts

@@ -0,0 +1,50 @@
+import type { Theme } from '../schema';
+import type { PaletteTokenName, themeColorShadeSteps } from '../tokens';
+import type { SiteStyleLooks } from './lookResolution';
+export type FooterRecipeColorToken = PaletteTokenName | `${PaletteTokenName}-${(typeof themeColorShadeSteps)[number]}`;
+export type FooterGround = Readonly<{
+    kind: 'token';
+    token: FooterRecipeColorToken;
+}> | Readonly<{
+    kind: 'style-surface';
+    surface: string;
+}>;
+export type FooterBarPaint = Readonly<{
+    fullBleed: boolean;
+    background: FooterGround;
+    textColor: FooterRecipeColorToken;
+    textAlign: 'left' | 'center' | 'right';
+    paddingY: 'none' | 'tight' | 'compact' | 'default' | 'relaxed' | 'spacious';
+    paddingX: 'none' | 'tight' | 'compact' | 'default' | 'relaxed' | 'spacious';
+    borderTop: Readonly<{
+        width: 'none' | 'thin' | 'medium' | 'thick';
+        colorToken?: FooterRecipeColorToken;
+    }>;
+}>;
+export type FooterLookRecipe = Readonly<{
+    arrangement: 'simple' | 'split' | 'centred';
+    ground: FooterGround;
+    nav: Readonly<{
+        weight: 'regular' | 'medium' | 'semibold' | 'bold';
+        colorToken: FooterRecipeColorToken;
+        hoverColorToken: FooterRecipeColorToken;
+        typography: 'body' | 'heading';
+    }>;
+    legal: Readonly<{
+        kind: 'integrated';
+    }> | Readonly<{
+        kind: 'separate';
+        bar: FooterBarPaint | null;
+        linkStyle?: Theme['footer']['bottomTextLinkStyle'];
+    }>;
+    brandAlign: 'start' | 'center' | 'end';
+    /** A style's fixed brand height; otherwise derived from the header. */
+    brandLogoSize?: 'sm' | 'md' | 'lg' | 'xl';
+}>;
+export type FooterRecipeSurfaceOwner = Readonly<{
+    looks: SiteStyleLooks;
+}>;
+/** Construct appearance from its owners; persisted footer bytes are never inputs. */
+export declare function compileFooterRecipe(recipe: FooterLookRecipe, theme: Theme, style: FooterRecipeSurfaceOwner): Theme['footer'];
+/** Reject undeclared references when the curated catalogue is loaded, before rendering. */
+export declare function validateFooterRecipeSurfaces(style: FooterRecipeSurfaceOwner, recipe: FooterLookRecipe): void;

package/dist/_dts/theme-core/src/site-styles/footerLooks.d.ts

@@ -1,6 +1,5 @@
-import type { Theme } from '../schema';
 import { type Brand } from './types';
-export declare const footerLookIdValues: readonly ["footer-links-quiet", "footer-links-emphasized"];
+export declare const footerLookIdValues: readonly ["footer-links-row", "footer-centred-name"];
 export type FooterLookIdValue = (typeof footerLookIdValues)[number];
 export type FooterLookId = Brand<FooterLookIdValue, 'FooterLookId'>;
 export declare function asFooterLookId(value: FooterLookIdValue): FooterLookId;
@@ -17,46 +16,21 @@ export declare function parsePersistedFooterLookId(value: string): Exclude<Persi
     kind: 'empty';
 }>;
 export declare function parsePersistedFooterLookId(value: string | null | undefined): PersistedFooterLookIdParseResult;
-export type FooterArrangementBlockAppearancePreset = Readonly<{
+export type FooterLookDefinition = Readonly<{
     id: FooterLookId;
     label: string;
     description: string;
-    compile: (theme: Theme) => Theme['footer'];
-}>;
-export type FooterSelectionResult = Readonly<{
-    selectedLookId: FooterLookId;
-    selectedLook: FooterArrangementBlockAppearancePreset;
-    footer: Theme['footer'];
-    rejected: readonly [];
-}>;
-export type FooterLookDiagnostics = Readonly<{
-    surface: Readonly<{
-        kind: 'site-footer';
-    }>;
-    selectedLookId: FooterLookId;
-    rejected: readonly [];
-}>;
-export type FooterLookResolutionInput = Readonly<{
-    theme: Theme;
-    recommendedLookIds: readonly FooterLookId[];
 }>;
 export declare const guaranteedFallbackFooterLookId: FooterLookId;
-declare function quietFooterLinks(theme: Theme): Theme['footer'];
-declare function emphasizedFooterLinks(theme: Theme): Theme['footer'];
 export declare const footerLookCatalog: readonly [{
     readonly id: FooterLookId;
-    readonly label: "Quiet links";
-    readonly description: "Regular-weight footer navigation with a restrained hover.";
-    readonly compile: typeof quietFooterLinks;
+    readonly label: "Links in a row";
+    readonly description: "Your links in a row, with the other footer sections in columns beside them.";
 }, {
     readonly id: FooterLookId;
-    readonly label: "Emphasized links";
-    readonly description: "Medium-weight footer navigation with a clearer emphasis.";
-    readonly compile: typeof emphasizedFooterLinks;
+    readonly label: "Centred name, links beneath";
+    readonly description: "Your site name centred, with your links, contact details and social links beneath it.";
 }];
-export declare function getFooterLook(id: FooterLookId): FooterArrangementBlockAppearancePreset | null;
-export declare function findFooterLook(id: FooterLookId): FooterArrangementBlockAppearancePreset | undefined;
-export declare function getFooterLookOrThrow(id: FooterLookId): FooterArrangementBlockAppearancePreset;
-export declare function resolveFooterLook(input: FooterLookResolutionInput): FooterSelectionResult;
-export declare function footerLookDiagnosticsFromSelectionResult(result: FooterSelectionResult): FooterLookDiagnostics;
-export {};
+export declare function getFooterLook(id: FooterLookId): FooterLookDefinition | null;
+export declare function findFooterLook(id: FooterLookId): FooterLookDefinition | undefined;
+export declare function getFooterLookOrThrow(id: FooterLookId): FooterLookDefinition;

package/dist/_dts/theme-core/src/site-styles/footerPreferences.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { Theme, ThemeFooter } from '../schema';
+import { type SiteChromeBackgroundOverride } from './siteChromeBackgrounds';
+export type FooterPreferences = Readonly<{
+    background: SiteChromeBackgroundOverride;
+    navigationLayout: 'inline-wrap' | 'stack';
+}>;
+export declare const defaultFooterPreferences: FooterPreferences;
+export declare const footerPreferencesSchema: z.ZodType<FooterPreferences>;
+/** Quick controls express background only; the composer owns navigation intent. */
+export declare const footerPreferencesWireSchema: z.ZodObject<{
+    background: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"default">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"color">;
+        token: z.ZodType<import("../../../blocks/src/index").SiteChromeBackgroundColorToken, unknown, z.core.$ZodTypeInternals<import("../../../blocks/src/index").SiteChromeBackgroundColorToken, unknown>>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
+export type PersistedFooterPreferences = Readonly<{
+    kind: 'present';
+    preferences: FooterPreferences;
+}> | Readonly<{
+    kind: 'invalid';
+    issues: readonly string[];
+}>;
+export declare function parsePersistedFooterPreferences(value: unknown): PersistedFooterPreferences;
+/** One-time backfill rule, also exercised against the migration SQL. Not a runtime fallback. */
+export declare function readFooterPreferences(theme: unknown): FooterPreferences;
+export declare function applyFooterPreferences(theme: Theme, footer: ThemeFooter, preferences: FooterPreferences): ThemeFooter;

package/dist/_dts/theme-core/src/site-styles/headerPreferencesPersistence.d.ts

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { type SiteChromeBackgroundColorToken } from './siteChromeBackgrounds';
 import type { HeaderPreferences } from './headerPreferences';
 /**
  * The persisted shape of `HeaderPreferences`, closed at every field.
@@ -17,7 +16,7 @@ export declare const headerPreferencesWireSchema: z.ZodObject<{
         kind: z.ZodLiteral<"default">;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"color">;
-        token: z.ZodType<SiteChromeBackgroundColorToken, unknown, z.core.$ZodTypeInternals<SiteChromeBackgroundColorToken, unknown>>;
+        token: z.ZodType<import("../../../blocks/src/index").SiteChromeBackgroundColorToken, unknown, z.core.$ZodTypeInternals<import("../../../blocks/src/index").SiteChromeBackgroundColorToken, unknown>>;
     }, z.core.$strict>], "kind">;
     navTextSize: z.ZodEnum<{
         base: "base";
@@ -46,8 +45,8 @@ export declare const headerPreferencesWireSchema: z.ZodObject<{
     logoSize: z.ZodEnum<{
         display: "display";
         auto: "auto";
-        standard: "standard";
         compact: "compact";
+        standard: "standard";
         generous: "generous";
     }>;
 }, z.core.$strict>;

package/dist/_dts/theme-core/src/site-styles/index.d.ts

@@ -12,6 +12,8 @@ export * from './curatedSiteStyles';
 export * from './customizableSurfaces';
 export * from './designState';
 export * from './footerLooks';
+export * from './footerLookRecipe';
+export * from './footerLookDefaults';
 export * from './generatedSchemas';
 export * from './generatedDesignPipeline';
 export * from './headerLayoutStyles';
@@ -59,3 +61,5 @@ export * from './effectiveArrangement';
 export * from './lookResolution';
 export { cardListItemParts, cardListBlockParts, cardListFamilyBlocks } from './appearancePresetTypes';
 export type { CardListItemPart } from './appearancePresetTypes';
+export * from './footerPreferences';
+export * from './compileFooterAgainstRow';

package/dist/_dts/theme-core/src/site-styles/lookResolution.d.ts

@@ -134,7 +134,7 @@ export type ArrangementStyleLooks = Readonly<{
 export declare function lookDefinitionForId(lookId: AppearancePresetId, catalogue?: readonly ArrangementBlockAppearancePreset[]): ArrangementBlockAppearancePreset | null;
 /** Validates destination data independently of manifest rollout availability. */
 export declare function validateLookFallbacks(style: ArrangementStyleLooks, catalogue?: readonly ArrangementBlockAppearancePreset[]): void;
-export declare const arrangementLookHooks: readonly ["data-fact", "data-card-list", "data-card-list-item", "data-availability", "data-event-places", "data-today", "data-other-month", "data-current", "data-skin", "data-look", "data-arrangement", "data-treat", "data-surface", "data-length", "data-knob-*", "data-mode", "data-has-*", "data-photo-count", "data-slot", "data-placeholder-field"];
+export declare const arrangementLookHooks: readonly ["data-fact", "data-card-list", "data-card-list-item", "data-availability", "data-event-places", "data-today", "data-other-month", "data-current", "data-skin", "data-look", "data-arrangement", "data-treat", "data-surface", "data-length", "data-knob-*", "data-mode", "data-has-*", "data-photo-count", "data-slot", "data-control", "data-placeholder-field"];
 export type CompiledArrangementLook = Readonly<{
     look: ArrangementBlockAppearancePreset;
     treatment: string;
@@ -160,7 +160,7 @@ export { cardListKnobs, cardListKnobBlocks, lookKnobBlocks, type LookKnobBlock,
 export declare const arrangementAppearancePresets: ArrangementBlockAppearancePreset[];
 export declare function arrangementStyleAvailability(style: SiteStyleLooks, preset: ArrangementBlockAppearancePreset, capabilities: ArrangementLookCapabilities | undefined): LookAvailability;
 /** Closed structural hooks shared by block arrangements and bounded skins. */
-export declare const arrangementSlotNames: readonly ["section", "stack", "inline", "grid", "head", "eyebrow", "heading", "intro", "frame", "copy", "caption", "headline", "lede", "actions", "media", "photo", "gallery", "sticker", "facts", "fact-label", "fact-value", "chips", "chip", "figure", "figure-value", "figure-label", "schedule", "dates", "date-places", "availability", "layout", "items", "item", "lead", "item-media", "item-body", "icon", "numeral", "item-title", "item-text", "item-actions", "list", "row", "row-continued", "group", "group-label", "group-day", "group-date", "date", "weekday", "day", "month", "date-label", "time", "price", "mark", "navigation", "time-start", "time-length", "what", "item-meta", "places", "places-low", "places-full", "action", "panel", "panel-heading", "more", "quote", "attribution", "outcome", "controls", "control", "counter"];
+export declare const arrangementSlotNames: readonly ["contact", "social", "base", "section", "stack", "inline", "grid", "head", "eyebrow", "heading", "intro", "frame", "copy", "caption", "headline", "lede", "actions", "media", "photo", "gallery", "sticker", "facts", "fact-label", "fact-value", "chips", "chip", "figure", "figure-value", "figure-label", "schedule", "dates", "date-places", "availability", "layout", "items", "item", "lead", "item-media", "item-body", "icon", "numeral", "item-title", "item-text", "item-actions", "list", "row", "row-continued", "group", "group-label", "group-day", "group-date", "date", "weekday", "day", "month", "date-label", "time", "price", "mark", "navigation", "time-start", "time-length", "what", "item-meta", "places", "places-low", "places-full", "action", "panel", "panel-heading", "more", "quote", "attribution", "outcome", "controls", "control", "counter"];
 export type ArrangementSlotName = typeof arrangementSlotNames[number];
 /** One role resolver, including section inheritance and ground-specific overrides. */
 export declare function resolveItemSurface(role: import('../cards').ItemRole, ground: Ground, style: Readonly<{

package/dist/_dts/theme-core/src/site-styles/previewCompiler.d.ts

@@ -58,7 +58,7 @@ export type UpdateSiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Re
 type ResolvedSiteThemeSelections = Readonly<{
     buttonStyleSelection: ButtonStyleSelection;
     headerSelection: HeaderLayoutStyleSelection;
-    footerLookId: FooterLookId | null;
+    footerLookId: FooterLookId;
 }>;
 type ReplacementResolvedSiteThemeSelections = ResolvedSiteThemeSelections & Readonly<{
     footerLookId: FooterLookId;