@riverbankcms/sdk 0.109.0 → 0.111.0

package/dist/_dts/theme-core/src/buttons/styles/selection.d.ts

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+export declare const BUTTON_STYLE_IDS: readonly ["soft-pill", "earth-pill", "confident-chip", "editorial-link", "pebble", "ink-stamp", "flat-ink", "brushed-wash", "showtime-pill", "joy-stamp", "ornate-ritual", "quiet-arrow"];
+export type ButtonStyleId = (typeof BUTTON_STYLE_IDS)[number];
+export declare const quietArrowParametersSchema: z.ZodObject<{
+    secondaryTreatment: z.ZodEnum<{
+        outlined: "outlined";
+        "solid-accent": "solid-accent";
+    }>;
+}, z.core.$strict>;
+export type QuietArrowParameters = z.infer<typeof quietArrowParametersSchema>;
+export declare const buttonStyleSelectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    styleId: z.ZodLiteral<"soft-pill">;
+    parameters: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    styleId: z.ZodLiteral<"earth-pill">;
+    parameters: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    styleId: z.ZodLiteral<"confident-chip">;
+    parameters: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    styleId: z.ZodLiteral<"editorial-link">;
+    parameters: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    styleId: z.ZodLiteral<"pebble">;
+    parameters: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    styleId: z.ZodLiteral<"ink-stamp">;
+    parameters: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    styleId: z.ZodLiteral<"flat-ink">;
+    parameters: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    styleId: z.ZodLiteral<"brushed-wash">;
+    parameters: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    styleId: z.ZodLiteral<"showtime-pill">;
+    parameters: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    styleId: z.ZodLiteral<"joy-stamp">;
+    parameters: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    styleId: z.ZodLiteral<"ornate-ritual">;
+    parameters: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    styleId: z.ZodLiteral<"quiet-arrow">;
+    parameters: z.ZodObject<{
+        secondaryTreatment: z.ZodEnum<{
+            outlined: "outlined";
+            "solid-accent": "solid-accent";
+        }>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "styleId">;
+export type ButtonStyleSelection = z.infer<typeof buttonStyleSelectionSchema>;
+export type ButtonStyleSelectionFor<TStyleId extends ButtonStyleId> = Extract<ButtonStyleSelection, Readonly<{
+    styleId: TStyleId;
+}>>;
+export declare const DEFAULT_BUTTON_STYLE_SELECTION: {
+    readonly styleId: "soft-pill";
+    readonly parameters: {};
+};
+export declare function createDefaultButtonStyleSelection(styleId: ButtonStyleId): ButtonStyleSelection;
+export declare function isButtonStyleId(value: string): value is ButtonStyleId;
+/**
+ * Stable identity for a validated style selection. Parsing first canonicalises
+ * parameter key order, so future recipe parameters do not require editor-core
+ * equality or key logic.
+ */
+export declare function buttonStyleSelectionKey(selection: ButtonStyleSelection): string;
+export declare function buttonStyleSelectionsEqual(a: ButtonStyleSelection, b: ButtonStyleSelection): boolean;

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

@@ -1,4 +1,4 @@
-import { type ButtonPersonalityId, type KnownButtonPersonalityId } from '../buttons/personalities';
+import { type ButtonStyleSelection } from '../buttons/styles';
 import { type KnownCuratedPaletteValueKey } from '../palette/curated';
 import type { Theme } from '../schema';
 import { type HeaderLayoutId, type HeaderLayoutIdValue, type HeaderLookId, type HeaderStyleId } from './headerLooks';
@@ -28,7 +28,7 @@ type CuratedSiteStyleCardOverrides = NonNullable<Theme['cards']>;
 type CuratedSiteStyleTestimonialQuoteOverrides = NonNullable<Theme['testimonialQuote']>;
 /**
  * Site-style-specific Theme overrides are applied after token recipes,
- * button personality, and curated palette selection have compiled the base
+ * button style, and curated palette selection have compiled the base
  * Theme. Values here intentionally win; palette and button selections remain
  * independent Style configurator choices.
  */
@@ -58,7 +58,9 @@ export type CuratedSiteStyleThemeOverrides = Readonly<{
      */
     testimonialQuote?: CuratedSiteStyleTestimonialQuoteOverrides;
 }>;
-export type ButtonPersonalityChoice = CuratedChoice<KnownButtonPersonalityId>;
+export type ButtonStyleChoice = ButtonStyleSelection & Readonly<{
+    note?: string;
+}>;
 export type CuratedPaletteRecommendation = CuratedChoice<KnownCuratedPaletteValueKey>;
 export type HeaderLayoutChoice = CuratedChoice<HeaderLayoutId>;
 export type HeaderStyleChoice = CuratedChoice<HeaderStyleId>;
@@ -121,7 +123,7 @@ export type CuratedSiteStyle = Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -129,7 +131,7 @@ export type CuratedSiteStyle = Readonly<{
     /** Optional concrete hero typography applied with the site style. */
     heroTypography?: SiteStyleHeroTypography;
 }>;
-export declare function defaultButtonPersonalityForSiteStyle(siteStyle: CuratedSiteStyle): ButtonPersonalityId;
+export declare function defaultButtonStyleSelectionForSiteStyle(siteStyle: CuratedSiteStyle): ButtonStyleSelection;
 export declare function defaultPaletteForSiteStyle(siteStyle: CuratedSiteStyle): KnownCuratedPaletteValueKey;
 /**
  * V1 generated site styles are curated product presets, not AI-authored design
@@ -168,7 +170,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -207,7 +209,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -246,7 +248,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -285,7 +287,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -324,7 +326,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -363,7 +365,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -402,7 +404,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -441,7 +443,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -480,7 +482,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -519,7 +521,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -558,7 +560,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -597,7 +599,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -636,7 +638,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -675,7 +677,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -714,7 +716,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -753,7 +755,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -792,7 +794,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -831,7 +833,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */
@@ -871,7 +873,7 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     recommendedHeaderLookIds: readonly HeaderLookId[];
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
-    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     /** Concrete typography applied when this site style is selected. */

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

@@ -1,8 +1,7 @@
 import type { Theme } from '../schema';
-import { type SiteChromeLookDiagnostics } from './customizableSurfaces';
 import { type Brand } from './types';
-export declare const footerLookIdValues: readonly ["footer-identity-quiet", "footer-muted-grounding", "footer-centered-calm", "footer-split-editorial", "footer-editorial-columns", "site-footer-brand-two-band"];
-export type FooterLookIdValue = typeof footerLookIdValues[number];
+export declare const footerLookIdValues: readonly ["footer-links-quiet", "footer-links-emphasized"];
+export type FooterLookIdValue = (typeof footerLookIdValues)[number];
 export type FooterLookId = Brand<FooterLookIdValue, 'FooterLookId'>;
 export declare function asFooterLookId(value: FooterLookIdValue): FooterLookId;
 export type PersistedFooterLookIdParseResult = Readonly<{
@@ -18,179 +17,46 @@ export declare function parsePersistedFooterLookId(value: string): Exclude<Persi
     kind: 'empty';
 }>;
 export declare function parsePersistedFooterLookId(value: string | null | undefined): PersistedFooterLookIdParseResult;
-export declare const footerLayoutIdValues: readonly ["identity", "centered", "split", "columns"];
-export type FooterLayoutIdValue = typeof footerLayoutIdValues[number];
-export type FooterLayoutId = Brand<FooterLayoutIdValue, 'FooterLayoutId'>;
-export declare function asFooterLayoutId(value: FooterLayoutIdValue): FooterLayoutId;
-export declare const footerStyleIdValues: readonly ["quiet", "calm", "editorial", "brand-band"];
-export type FooterStyleIdValue = typeof footerStyleIdValues[number];
-export type FooterStyleId = Brand<FooterStyleIdValue, 'FooterStyleId'>;
-export declare function asFooterStyleId(value: FooterStyleIdValue): FooterStyleId;
-export type FooterLayoutDefinition = Readonly<{
-    id: FooterLayoutId;
-    label: string;
-    description: string;
-    requiresFooterNav?: boolean;
-    requiresFooterNavGroups?: boolean;
-    maxRecommendedNavDensity?: Extract<FooterSelectionContext['navDensity'], 'sparse' | 'balanced'>;
-}>;
-export type FooterStyleDefinition = Readonly<{
-    id: FooterStyleId;
-    label: string;
-    description: string;
-}>;
 export type FooterLookDefinition = Readonly<{
     id: FooterLookId;
     label: string;
-    layoutId: FooterLayoutId;
-    styleId: FooterStyleId;
-    hiddenFromLayoutStyleControls?: boolean;
-    requiresFooterNav?: boolean;
-    requiresFooterNavGroups?: boolean;
-    maxRecommendedNavDensity?: Extract<FooterSelectionContext['navDensity'], 'sparse' | 'balanced'>;
-    allowedContentPresence?: readonly Exclude<FooterSelectionContext['contentPresence'], 'unknown'>[];
+    description: string;
     compile: (theme: Theme) => Theme['footer'];
 }>;
-export type FooterSelectionContext = Readonly<{
-    navDensity: 'unknown' | 'none' | 'sparse' | 'balanced' | 'dense';
-    groupedNav: 'unknown' | 'none' | 'present';
-    contentPresence: 'unknown' | 'default-footer' | 'footer-blocks' | 'default-and-blocks';
-}>;
-export type RejectedFooterLookReason = 'footer-nav-required' | 'footer-nav-groups-required' | 'footer-nav-too-dense' | 'footer-content-incompatible';
-export type RejectedFooterLook = Readonly<{
-    lookId: FooterLookId;
-    reasons: readonly RejectedFooterLookReason[];
-}>;
 export type FooterSelectionResult = Readonly<{
     selectedLookId: FooterLookId;
     selectedLook: FooterLookDefinition;
     footer: Theme['footer'];
-    rejected: readonly RejectedFooterLook[];
+    rejected: readonly [];
+}>;
+export type FooterLookDiagnostics = Readonly<{
+    surface: Readonly<{
+        kind: 'site-footer';
+    }>;
+    selectedLookId: FooterLookId;
+    rejected: readonly [];
 }>;
-export type FooterLookDiagnostics = SiteChromeLookDiagnostics<FooterLookId, RejectedFooterLookReason>;
 export type FooterLookResolutionInput = Readonly<{
     theme: Theme;
     recommendedLookIds: readonly FooterLookId[];
-    context?: Partial<FooterSelectionContext>;
 }>;
-export declare const defaultFooterSelectionContext: FooterSelectionContext;
 export declare const guaranteedFallbackFooterLookId: FooterLookId;
-export declare const footerLayoutCatalog: readonly [{
-    readonly id: FooterLayoutId;
-    readonly label: "Identity";
-    readonly description: "Logo, site text, address, and legal copy without relying on footer navigation.";
-}, {
-    readonly id: FooterLayoutId;
-    readonly label: "Centered";
-    readonly description: "A calm centered stack for identity, short copy, and optional compact navigation.";
-    readonly maxRecommendedNavDensity: "sparse";
-}, {
-    readonly id: FooterLayoutId;
-    readonly label: "Split";
-    readonly description: "Navigation and brand signoff separated into a wider split footer.";
-    readonly requiresFooterNav: true;
-    readonly maxRecommendedNavDensity: "balanced";
-}, {
-    readonly id: FooterLayoutId;
-    readonly label: "Columns";
-    readonly description: "Grouped footer navigation columns with a supporting bottom line.";
-    readonly requiresFooterNav: true;
-    readonly requiresFooterNavGroups: true;
-}];
-export declare const footerStyleCatalog: readonly [{
-    readonly id: FooterStyleId;
-    readonly label: "Quiet";
-    readonly description: "Lightweight, practical footer treatment.";
-}, {
-    readonly id: FooterStyleId;
-    readonly label: "Calm";
-    readonly description: "Soft centered treatment with restrained dividers.";
-}, {
-    readonly id: FooterStyleId;
-    readonly label: "Editorial";
-    readonly description: "Text-forward treatment with fine-line structure.";
-}, {
-    readonly id: FooterStyleId;
-    readonly label: "Brand band";
-    readonly description: "High-contrast brand treatment with a stronger bottom bar.";
-}];
-export declare function getFooterLayout(id: FooterLayoutId): FooterLayoutDefinition | null;
-export declare function getFooterStyle(id: FooterStyleId): FooterStyleDefinition | null;
-export declare function getFooterLooksForLayout(layoutId: FooterLayoutId): readonly FooterLookDefinition[];
-export declare function getFooterLooksForStyle(styleId: FooterStyleId): readonly FooterLookDefinition[];
-export declare function findFooterLookForLayoutStyle(input: Readonly<{
-    layoutId: FooterLayoutId;
-    styleId: FooterStyleId;
-}>): FooterLookDefinition | null;
-export declare function findDefaultFooterLookForLayout(layoutId: FooterLayoutId): FooterLookDefinition | null;
-/**
- * No-nav-safe identity footer: brand and legal/supporting copy carry the
- * footer without implying missing navigation.
- */
-declare function identityQuietFooter(theme: Theme): Theme['footer'];
-/**
- * Back-compat alias for the previous default footer Look. It keeps existing
- * persisted selections valid while staying hidden from the new layout/style UI.
- */
-declare function mutedGroundingFooter(theme: Theme): Theme['footer'];
-/** Applies a high-contrast brand band with a darker full-bleed bottom bar. */
-declare function brandTwoBandFooter(theme: Theme): Theme['footer'];
-/**
- * Centered stack on a softly tinted band: logo, inline nav, address, and a
- * hairline-topped copyright line, all centered.
- */
-declare function centeredCalmFooter(theme: Theme): Theme['footer'];
-/** Editorial split footer: compact nav on one side, brand signoff on the other. */
-declare function splitEditorialFooter(theme: Theme): Theme['footer'];
-/**
- * Editorial columns: site name and supporting copy on the left, inline nav on
- * the right, with a hairline-topped bottom line. Uses the footer block's
- * columns layout.
- */
-declare function editorialColumnsFooter(theme: Theme): Theme['footer'];
+declare function quietFooterLinks(theme: Theme): Theme['footer'];
+declare function emphasizedFooterLinks(theme: Theme): Theme['footer'];
 export declare const footerLookCatalog: readonly [{
     readonly id: FooterLookId;
-    readonly label: "Identity footer";
-    readonly layoutId: FooterLayoutId;
-    readonly styleId: FooterStyleId;
-    readonly compile: typeof identityQuietFooter;
-}, {
-    readonly id: FooterLookId;
-    readonly label: "Muted grounding footer";
-    readonly layoutId: FooterLayoutId;
-    readonly styleId: FooterStyleId;
-    readonly hiddenFromLayoutStyleControls: true;
-    readonly compile: typeof mutedGroundingFooter;
-}, {
-    readonly id: FooterLookId;
-    readonly label: "Centered calm footer";
-    readonly layoutId: FooterLayoutId;
-    readonly styleId: FooterStyleId;
-    readonly compile: typeof centeredCalmFooter;
-}, {
-    readonly id: FooterLookId;
-    readonly label: "Split editorial footer";
-    readonly layoutId: FooterLayoutId;
-    readonly styleId: FooterStyleId;
-    readonly compile: typeof splitEditorialFooter;
-}, {
-    readonly id: FooterLookId;
-    readonly label: "Editorial columns footer";
-    readonly layoutId: FooterLayoutId;
-    readonly styleId: FooterStyleId;
-    readonly compile: typeof editorialColumnsFooter;
+    readonly label: "Quiet links";
+    readonly description: "Regular-weight footer navigation with a restrained hover.";
+    readonly compile: typeof quietFooterLinks;
 }, {
     readonly id: FooterLookId;
-    readonly label: "Two-band brand footer";
-    readonly layoutId: FooterLayoutId;
-    readonly styleId: FooterStyleId;
-    readonly allowedContentPresence: readonly ["default-footer", "default-and-blocks"];
-    readonly compile: typeof brandTwoBandFooter;
+    readonly label: "Emphasized links";
+    readonly description: "Medium-weight footer navigation with a clearer emphasis.";
+    readonly compile: typeof emphasizedFooterLinks;
 }];
 export declare function getFooterLook(id: FooterLookId): FooterLookDefinition | null;
 export declare function findFooterLook(id: FooterLookId): FooterLookDefinition | undefined;
 export declare function getFooterLookOrThrow(id: FooterLookId): FooterLookDefinition;
 export declare function resolveFooterLook(input: FooterLookResolutionInput): FooterSelectionResult;
 export declare function footerLookDiagnosticsFromSelectionResult(result: FooterSelectionResult): FooterLookDiagnostics;
-export declare function footerLookRejectionReasonLabel(reason: RejectedFooterLookReason): string;
 export {};

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

@@ -1,3 +1,5 @@
 import type { Theme } from '../schema';
 export type HeaderCtaTreatment = 'default' | 'primary' | 'secondary' | 'inverted' | 'outline' | 'ghost';
-export declare function resolveHeaderCtaVariant(theme: Theme, treatment: HeaderCtaTreatment): string | undefined;
+type HeaderCtaButtonTheme = Pick<Theme, 'buttons'>;
+export declare function resolveHeaderCtaVariant(theme: HeaderCtaButtonTheme, treatment: HeaderCtaTreatment): string | undefined;
+export {};

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

@@ -1,9 +1,9 @@
 import type { PageDesignEditorReadModel } from './pageDesignEditorModel';
 import { type Theme } from '../schema';
-import { type ButtonPersonalityId } from '../buttons/personalities';
+import { type ButtonStyleSelection } from '../buttons/styles';
 import type { CompleteResolvedPaletteSelection, PaletteSelection } from '../palette';
 import { type CuratedSiteStyle } from './curatedSiteStyles';
-import { type FooterLookId, type FooterSelectionContext, type FooterSelectionResult } from './footerLooks';
+import { type FooterLookId, type FooterSelectionResult } from './footerLooks';
 import { type HeaderLayoutId, type HeaderSelectionContext, type HeaderLookId, type HeaderSelectionResult, type HeaderStyleId } from './headerLooks';
 import { type CompiledBlockRuntimeFields, type CompiledBoundaryRuntime, type CompiledPageRuntime, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext } from './runtimeCompiler';
 import { type AppearancePresetId, type DesignBlockId, type SiteStyleId } from './types';
@@ -24,7 +24,7 @@ export { repairDesignIssue, resolveBlockDesignPlan } from './resolver';
 export { cycleableOptionsFromResolved, deriveDesignCustomizationScope, recommendedDesignOption, type CycleableDesignOption, type CycleableOptions, type DesignCustomizationAuthority, type DesignCustomizationScope, type DesignCustomizationSurface, type DesignCustomizationUnsupportedReason, type DesignOptionIssue, type ResolvedDesignOption, } from './previewCustomization';
 export { compileBlockRuntimeFields, compileBoundaryRuntime, compilePageRuntimeFields, compileTokenRecipes, compileTransitionRuntime, compiledRuntimeStyleFieldNames, defaultComponentRuntimeRules, defaultDesignRuntimeRules, surfaceResolutionContextFromPalette, surfaceResolutionContextFromTheme, stripCompiledRuntimeStyleFields, type CompiledBlockRuntime, type CompiledBlockRuntimeFields, type CompiledBoundaryRuntime, type CompiledPageRuntime, type CompileBlockRuntimeInput, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext, } from './runtimeCompiler';
 export { defaultCuratedChoice, requireEntriesForCuratedChoices, resolveCuratedChoice, type CuratedChoice, type CuratedChoiceResolution, } from './curatedChoices';
-export { curatedSiteStyles, defaultButtonPersonalityForSiteStyle, defaultPaletteForSiteStyle, getCuratedSiteStyle, type CuratedSiteStyle, } from './curatedSiteStyles';
+export { curatedSiteStyles, defaultButtonStyleSelectionForSiteStyle, defaultPaletteForSiteStyle, getCuratedSiteStyle, type CuratedSiteStyle, } from './curatedSiteStyles';
 export { asDesignBlockId, asSiteStyleId, makeBoundaryId, type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type ResolvedPageDesignPlan, type SiteStyleId, } from './types';
 export declare const previewCustomizePurpose: "preview-customize";
 /**
@@ -36,20 +36,19 @@ export declare function compileCuratedSiteStyleTheme(siteStyle: CuratedSiteStyle
 export declare function defaultResolvedPaletteForSiteStyle(siteStyle: CuratedSiteStyle): CompleteResolvedPaletteSelection;
 export declare function compileCuratedSiteStyleThemeById(siteStyleId: SiteStyleId): CuratedSiteStyleTheme | null;
 export type SelectionFallbackWarning = Readonly<{
-    kind: 'rejected-personality';
+    kind: 'rejected-button-style';
     requested: string;
-    fellBackTo: ButtonPersonalityId;
+    fellBackTo: ButtonStyleSelection;
 }>;
 type SiteThemeSelectionsCommonInput = Readonly<{
     siteStyle: CuratedSiteStyle;
-    buttonPersonalityId: ButtonPersonalityId | null;
+    buttonStyleSelection: ButtonStyleSelection | null;
     typography?: Theme['typography'];
     headerLookId?: HeaderLookId | null;
     headerLayoutId?: HeaderLayoutId | null;
     headerStyleId?: HeaderStyleId | null;
     footerLookId?: FooterLookId | null;
     headerSelectionContext?: Partial<HeaderSelectionContext>;
-    footerSelectionContext?: Partial<FooterSelectionContext>;
 }>;
 export type SiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Readonly<{
     resolvedPalette: CompleteResolvedPaletteSelection;
@@ -63,7 +62,7 @@ type SiteThemeSelectionsBaseResult = Readonly<{
         footerLookId: FooterLookId | null;
     }>;
     resolvedSelections: Readonly<{
-        buttonPersonalityId: ButtonPersonalityId;
+        buttonStyleSelection: ButtonStyleSelection;
         paletteSelection: PaletteSelection | null;
         headerLookId: HeaderLookId | null;
         headerLayoutId: HeaderLayoutId;
@@ -76,7 +75,7 @@ type SiteThemeSelectionsBaseResult = Readonly<{
 }>;
 export type SiteThemeSelectionsResult = SiteThemeSelectionsBaseResult;
 /**
- * High-level, site-style-aware compiler. Resolves the user's personality and
+ * High-level, site-style-aware compiler. Resolves the user's button style and
  * palette selections into theme tokens. Palette authority is always supplied
  * as a complete resolved curated/site selection or an explicit draft.
  *

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

@@ -1,6 +1,6 @@
 import { type CardStylesOverride, type ContainerStylesOverride, type SectionStylesOverride, type Theme } from '../schema';
 import { type ExpandedPalette } from '../palette/expandPalette';
-import { type ButtonPersonalityId } from '../buttons/personalities';
+import { type ButtonStyleSelection } from '../buttons/styles';
 import type { CompleteResolvedPaletteSelection } from '../palette/resolveSelection';
 import { type RuntimeStyleWriteResultForFields, type StyleAuthority } from './designState';
 import { type ContentFrameIntent, type BlockCompositionIntent, type EyebrowTreatment, type FlushFrameTreatment, type DesignBoundaryId, type PanelFrameTreatment, type ResolvedBlockDesignPlan, type ResolvedPageDesignPlan, type SiteStyleItemSurfaceIntent, type SiteStyleSectionTransitionIntent, type SiteStyleSurfaceIntent, type ThemeTokenRecipes } from './types';
@@ -338,8 +338,8 @@ type PaletteCompileOptions = Readonly<{
     resolvedPalette?: CompleteResolvedPaletteSelection;
 }>;
 export type CompileTokenRecipesOptions = Readonly<{
-    /** Resolved button personality ID. When provided, emits `theme.buttons`. */
-    buttonPersonalityId?: ButtonPersonalityId;
+    /** Validated button style selection. When provided, emits `theme.buttons`. */
+    buttonStyleSelection?: ButtonStyleSelection;
 }> & PaletteCompileOptions;
 /**
  * Compiles bounded token recipes to the current Theme schema. This is intentionally
@@ -347,7 +347,7 @@ export type CompileTokenRecipesOptions = Readonly<{
  * Theme output before any persistence or Phase 5 integration consumes them.
  *
  * Optional `options` accept an already-resolved palette selection and button
- * personality. Sparse overrides and legacy palette IDs are deliberately not
+ * style. Sparse overrides and legacy palette IDs are deliberately not
  * compiler inputs: callers must resolve a complete palette before compiling.
  */
 export declare function compileTokenRecipes(recipes: ThemeTokenRecipes, options?: CompileTokenRecipesOptions): Theme;

package/dist/_dts/ui/src/palette/hex.d.ts

@@ -2,8 +2,8 @@
  * Hex colour helpers shared by every palette-editing surface (Macadamia
  * onboarding swatches, the LiveThemeEditor, the Style configurator advanced
  * row). Consolidates three prior duplicates: `normalizeColorPickerValue` in
- * Macadamia, `normalizeHex` + `contrastRatio` in `theme-editor/utils.ts`, and
- * the inline regex in `updateColorRole`.
+ * Macadamia, `normalizeHex` + `contrastRatio` formerly in
+ * `theme-editor/utils.ts`, and the inline regex in `updateColorRole`.
  *
  * Pure functions; no DOM, no React.
  */
@@ -13,7 +13,7 @@
  * without a leading `#`; returns `fallback` for any other shape (empty
  * string, garbage, characters outside `[0-9a-f]`, wrong length, etc.). Pass
  * a `fallback` to make the fallback explicit at the call site — defaulting
- * to `'#000000'` keeps the legacy `theme-editor/utils.ts` semantics.
+ * to `'#000000'` preserves the former theme-editor helper semantics.
  */
 export declare function normalizeHex(input: string | null | undefined, fallback?: string): string;
 /**