@riverbankcms/sdk 0.130.2 → 0.134.0

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

@@ -9,15 +9,7 @@ export declare const softPillRecipe: Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("..").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("../..").ButtonSizes;
@@ -69,15 +61,7 @@ export declare const earthPillRecipe: Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("..").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("../..").ButtonSizes;
@@ -129,15 +113,7 @@ export declare const confidentChipRecipe: Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("..").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("../..").ButtonSizes;
@@ -189,15 +165,7 @@ export declare const editorialLinkRecipe: Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("..").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("../..").ButtonSizes;
@@ -249,15 +217,7 @@ export declare const pebbleRecipe: Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("..").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("../..").ButtonSizes;
@@ -309,15 +269,7 @@ export declare const brushedWashRecipe: Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("..").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("../..").ButtonSizes;
@@ -369,75 +321,7 @@ export declare const inkStampRecipe: Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
-    defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
-        global: import("../../../../../blocks/src/index").ButtonGlobalSettings;
-        sizes?: import("../..").ButtonSizes;
-        roles: Readonly<{
-            primary: Readonly<{
-                kind: "complete";
-                appearance: import("..").ButtonVariantAppearance;
-            }>;
-            secondary: Readonly<{
-                kind: "complete";
-                appearance: import("..").ButtonVariantAppearance;
-            }>;
-            outline: Readonly<{
-                kind: "complete";
-                appearance: import("..").ButtonVariantAppearance;
-            }> | Readonly<{
-                kind: "derive";
-                from: import("..").CompleteButtonRole;
-                overrides?: Partial<import("..").ButtonVariantAppearance>;
-            }>;
-            ghost: Readonly<{
-                kind: "complete";
-                appearance: import("..").ButtonVariantAppearance;
-            }> | Readonly<{
-                kind: "derive";
-                from: import("..").CompleteButtonRole;
-                overrides?: Partial<import("..").ButtonVariantAppearance>;
-            }>;
-            accent: Readonly<{
-                kind: "complete";
-                appearance: import("..").ButtonVariantAppearance;
-            }> | Readonly<{
-                kind: "derive";
-                from: import("..").CompleteButtonRole;
-                overrides?: Partial<import("..").ButtonVariantAppearance>;
-            }>;
-        }>;
-        surfacePolicy?: import("../..").ButtonSurfacePolicy;
-    }>;
-}>;
-export declare const flatInkRecipe: Readonly<{
-    id: "flat-ink";
-    accessibilityLabel: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../../blocks/src/index").StyleEra;
-    }>>>;
-    parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
-    defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("..").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("../..").ButtonSizes;
@@ -489,15 +373,7 @@ export declare const showtimePillRecipe: Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("..").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("../..").ButtonSizes;
@@ -549,15 +425,7 @@ export declare const joyStampRecipe: Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("..").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("../..").ButtonSizes;
@@ -609,15 +477,7 @@ export declare const ornateRitualRecipe: Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("..").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("../..").ButtonSizes;

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

@@ -1,5 +1,6 @@
 import type { ButtonSystem } from '../types';
-import { type ResolveButtonStyleError } from './domain';
+import type { VariantRole } from '../types';
+import { type ButtonHoverTreatmentValue, type ResolveButtonStyleError } from './domain';
 import { type ButtonStyleId, type ButtonStyleSelection, type ButtonStyleSelectionFor } from './selection';
 export declare const buttonStyleRecipes: readonly [Readonly<{
     id: "soft-pill";
@@ -12,15 +13,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("./domain").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("..").ButtonSizes;
@@ -71,15 +64,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("./domain").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("..").ButtonSizes;
@@ -130,15 +115,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("./domain").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("..").ButtonSizes;
@@ -189,15 +166,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("./domain").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("..").ButtonSizes;
@@ -248,15 +217,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("./domain").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("..").ButtonSizes;
@@ -307,15 +268,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("./domain").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("..").ButtonSizes;
@@ -364,18 +317,50 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
-    defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
+    parameterSchema: import("zod").ZodType<{
+        hoverPreferences?: {
+            outline?: "accent" | "secondary" | "contextual" | undefined;
+            accent?: "accent" | "secondary" | "contextual" | undefined;
+            primary?: "accent" | "secondary" | "contextual" | undefined;
+            secondary?: "accent" | "secondary" | "contextual" | undefined;
+            ghost?: "accent" | "secondary" | "contextual" | undefined;
+        } | undefined;
+    }, unknown, import("zod/v4/core").$ZodTypeInternals<{
+        hoverPreferences?: {
+            outline?: "accent" | "secondary" | "contextual" | undefined;
+            accent?: "accent" | "secondary" | "contextual" | undefined;
+            primary?: "accent" | "secondary" | "contextual" | undefined;
+            secondary?: "accent" | "secondary" | "contextual" | undefined;
+            ghost?: "accent" | "secondary" | "contextual" | undefined;
+        } | undefined;
+    }, unknown>>;
+    defaultParameters: {
+        hoverPreferences?: {
+            outline?: "accent" | "secondary" | "contextual" | undefined;
+            accent?: "accent" | "secondary" | "contextual" | undefined;
+            primary?: "accent" | "secondary" | "contextual" | undefined;
+            secondary?: "accent" | "secondary" | "contextual" | undefined;
+            ghost?: "accent" | "secondary" | "contextual" | undefined;
+        } | undefined;
+    };
+    controls: readonly import("./domain").ButtonStyleControl<{
+        hoverPreferences?: {
+            outline?: "accent" | "secondary" | "contextual" | undefined;
+            accent?: "accent" | "secondary" | "contextual" | undefined;
+            primary?: "accent" | "secondary" | "contextual" | undefined;
+            secondary?: "accent" | "secondary" | "contextual" | undefined;
+            ghost?: "accent" | "secondary" | "contextual" | undefined;
+        } | undefined;
     }>[];
-    defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
+    defineSystem: (parameters: {
+        hoverPreferences?: {
+            outline?: "accent" | "secondary" | "contextual" | undefined;
+            accent?: "accent" | "secondary" | "contextual" | undefined;
+            primary?: "accent" | "secondary" | "contextual" | undefined;
+            secondary?: "accent" | "secondary" | "contextual" | undefined;
+            ghost?: "accent" | "secondary" | "contextual" | undefined;
+        } | undefined;
+    }) => Readonly<{
         global: import("../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("..").ButtonSizes;
         roles: Readonly<{
@@ -425,15 +410,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("./domain").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("..").ButtonSizes;
@@ -484,15 +461,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("./domain").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("..").ButtonSizes;
@@ -543,15 +512,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("./domain").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("..").ButtonSizes;
@@ -602,15 +563,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
     }>>>;
     parameterSchema: import("zod").ZodType<Readonly<Record<string, never>>, unknown, import("zod/v4/core").$ZodTypeInternals<Readonly<Record<string, never>>, unknown>>;
     defaultParameters: Readonly<Record<string, never>>;
-    controls: readonly Readonly<{
-        kind: "choice";
-        parameter: string;
-        label: string;
-        options: readonly Readonly<{
-            value: never;
-            label: string;
-        }>[];
-    }>[];
+    controls: readonly import("./domain").ButtonStyleControl<Readonly<Record<string, never>>>[];
     defineSystem: (parameters: Readonly<Record<string, never>>) => Readonly<{
         global: import("../../../../blocks/src/index").ButtonGlobalSettings;
         sizes?: import("..").ButtonSizes;
@@ -744,4 +697,6 @@ export type UpdateButtonStyleSelectionChoiceResult = Readonly<{
  * selection. Preview controls never need recipe-specific parameter branches.
  */
 export declare function updateButtonStyleSelectionChoice(selection: ButtonStyleSelection, parameter: string, value: string): UpdateButtonStyleSelectionChoiceResult;
+export declare function buttonStyleHoverPreferenceValue(selection: ButtonStyleSelection, parameter: string, role: VariantRole): ButtonHoverTreatmentValue | null;
+export declare function updateButtonStyleHoverPreference(selection: ButtonStyleSelection, parameter: string, role: VariantRole, value: ButtonHoverTreatmentValue | null): UpdateButtonStyleSelectionChoiceResult;
 export {};

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { type VariantRole } from '../types';
 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<{
@@ -8,6 +9,38 @@ export declare const quietArrowParametersSchema: z.ZodObject<{
     }>;
 }, z.core.$strict>;
 export type QuietArrowParameters = z.infer<typeof quietArrowParametersSchema>;
+export declare const FLAT_INK_HOVER_TREATMENT_VALUES: readonly ["contextual", "secondary", "accent"];
+export declare const flatInkHoverTreatmentSchema: z.ZodEnum<{
+    accent: "accent";
+    secondary: "secondary";
+    contextual: "contextual";
+}>;
+export declare const flatInkHoverPreferencesSchema: z.ZodObject<Record<"outline" | "accent" | "primary" | "secondary" | "ghost", z.ZodOptional<z.ZodEnum<{
+    accent: "accent";
+    secondary: "secondary";
+    contextual: "contextual";
+}>>>, z.core.$strict>;
+export declare const flatInkParametersSchema: z.ZodObject<{
+    hoverPreferences: z.ZodOptional<z.ZodObject<Record<"outline" | "accent" | "primary" | "secondary" | "ghost", z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        secondary: "secondary";
+        contextual: "contextual";
+    }>>>, z.core.$strict>>;
+}, z.core.$strict>;
+export type FlatInkHoverTreatment = z.infer<typeof flatInkHoverTreatmentSchema>;
+export type FlatInkParameters = z.infer<typeof flatInkParametersSchema>;
+export type ButtonHoverTreatmentPreference = Readonly<{
+    kind: 'recommended';
+}> | Readonly<{
+    kind: 'explicit';
+    treatment: Readonly<{
+        kind: 'contextual-shade-shift';
+    }> | Readonly<{
+        kind: 'palette-role';
+        role: 'secondary' | 'accent';
+    }>;
+}>;
+export type ButtonHoverPreferences = Readonly<Record<VariantRole, ButtonHoverTreatmentPreference>>;
 export declare const buttonStyleSelectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     styleId: z.ZodLiteral<"soft-pill">;
     parameters: z.ZodObject<{}, z.core.$strict>;
@@ -28,7 +61,13 @@ export declare const buttonStyleSelectionSchema: z.ZodDiscriminatedUnion<[z.ZodO
     parameters: z.ZodObject<{}, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     styleId: z.ZodLiteral<"flat-ink">;
-    parameters: z.ZodObject<{}, z.core.$strict>;
+    parameters: z.ZodObject<{
+        hoverPreferences: z.ZodOptional<z.ZodObject<Record<"outline" | "accent" | "primary" | "secondary" | "ghost", z.ZodOptional<z.ZodEnum<{
+            accent: "accent";
+            secondary: "secondary";
+            contextual: "contextual";
+        }>>>, z.core.$strict>>;
+    }, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     styleId: z.ZodLiteral<"brushed-wash">;
     parameters: z.ZodObject<{}, z.core.$strict>;
@@ -62,9 +101,18 @@ export declare function createDefaultButtonStyleSelection(styleId: ButtonStyleId
 export declare function isButtonStyleId(value: string): value is ButtonStyleId;
 export type PersistedButtonStyleSelectionResult = Readonly<{
     selection: ButtonStyleSelection;
-    warning: 'invalid-persisted-button-style-selection' | null;
+    warning: 'invalid-persisted-button-style-selection' | 'repaired-persisted-button-style-selection' | null;
+    repairs: readonly ButtonStyleSelectionRepair[];
+}>;
+export type ButtonStyleSelectionRepair = Readonly<{
+    kind: 'repaired-option';
+    styleId: ButtonStyleId;
+    parameter: string;
+    role: VariantRole | null;
+    reason: 'invalid-option-shape' | 'unsupported-option';
 }>;
 export declare function parsePersistedButtonStyleSelection(value: unknown, fallback?: ButtonStyleSelection): PersistedButtonStyleSelectionResult;
+export declare function normalizeFlatInkHoverPreferences(parameters: FlatInkParameters): ButtonHoverPreferences;
 /**
  * Stable identity for a validated style selection. Parsing first canonicalises
  * parameter key order, so future recipe parameters do not require editor-core