@riverbankcms/sdk 0.108.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/buttons/types.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { type ThemeColorToken } from '../tokens/themeColorTokens';
 /**
  * Button System Types and Schemas
  *
@@ -77,23 +78,43 @@ export type DefaultVariantAliasId = typeof DEFAULT_VARIANT_ALIAS_ID;
  * `theme.buttons.sizes`, then to the system defaults.
  */
 export type VariantSizeOverrides = Partial<ButtonSizes>;
-export type ButtonBackground = {
+/**
+ * Closed colour relationship for a button variant.
+ *
+ * Solid foregrounds are derived from the exact background token. Surface
+ * treatments inherit the foreground contract of their containing surface.
+ * Gradients are the only token treatment that needs an explicit foreground,
+ * because no single palette on-colour can describe several stops.
+ */
+declare const OpaqueButtonColourTokenBrand: unique symbol;
+export type OpaqueButtonColourToken = ThemeColorToken & {
+    readonly [OpaqueButtonColourTokenBrand]: 'OpaqueButtonColourToken';
+};
+export declare function parseOpaqueButtonColourToken(value: unknown): OpaqueButtonColourToken | null;
+export declare function unsafeAsOpaqueButtonColourToken(value: string): OpaqueButtonColourToken;
+export declare const opaqueButtonColourTokenSchema: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
+export type ButtonColourTreatment = {
     type: 'solid';
-    colorToken: string;
+    colorToken: OpaqueButtonColourToken;
 } | {
     type: 'gradient';
-    stops: string[];
+    stops: [OpaqueButtonColourToken, OpaqueButtonColourToken, ...OpaqueButtonColourToken[]];
     direction: GradientDirection;
+    foregroundToken: OpaqueButtonColourToken;
 } | {
-    type: 'transparent';
+    type: 'surface';
+    role: 'link';
+};
+export type ButtonBackground = ButtonColourTreatment;
+export type ButtonEffectOptionValue = string | number | boolean | null | ButtonEffectOptionValue[] | {
+    [key: string]: ButtonEffectOptionValue;
 };
-export interface EffectApplication {
+export type EffectApplication = {
     effectId: string;
-    options?: Record<string, unknown>;
-}
+    options?: Record<string, ButtonEffectOptionValue>;
+};
 export interface ButtonBorder {
     widthClass: string;
-    colorToken: string;
 }
 /**
  * Optional trailing affordance icon carried by a button variant.
@@ -112,8 +133,6 @@ export interface ButtonBorder {
 export interface ButtonVariantAffordance {
     /** Registry icon id, e.g. `'ArrowRight'`. */
     iconId: string;
-    /** Optional palette token for the icon colour. Omit to inherit the button text colour. */
-    colorToken?: string;
 }
 export declare const cornerStyleSchema: z.ZodEnum<{
     square: "square";
@@ -249,7 +268,7 @@ export declare const buttonSizesSchema: z.ZodPipe<z.ZodObject<{
         fontSize?: string | undefined;
     } | undefined;
 }>>;
-export declare const buttonGlobalSettingsSchema: z.ZodObject<{
+export declare const buttonGlobalSettingsSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
     cornerStyle: z.ZodEnum<{
         square: "square";
         rounded: "rounded";
@@ -299,7 +318,7 @@ export declare const buttonGlobalSettingsSchema: z.ZodObject<{
         darken: "darken";
         saturate: "saturate";
     }>;
-    hoverColorToken: z.ZodOptional<z.ZodString>;
+    hoverColorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
     gradientStyle: z.ZodOptional<z.ZodEnum<{
         linear: "linear";
         radial: "radial";
@@ -311,7 +330,7 @@ export declare const buttonGlobalSettingsSchema: z.ZodObject<{
         hard: "hard";
         smooth: "smooth";
     }>>;
-}, z.core.$strip>;
+}, z.core.$strip>>;
 export declare const gradientDirectionSchema: z.ZodEnum<{
     "to-r": "to-r";
     "to-l": "to-l";
@@ -322,12 +341,33 @@ export declare const gradientDirectionSchema: z.ZodEnum<{
     "to-br": "to-br";
     "to-bl": "to-bl";
 }>;
+export declare const buttonColourTreatmentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"solid">;
+    colorToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"gradient">;
+    stops: z.ZodPipe<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>, z.ZodTransform<[OpaqueButtonColourToken, OpaqueButtonColourToken, ...OpaqueButtonColourToken[]], OpaqueButtonColourToken[]>>;
+    direction: z.ZodEnum<{
+        "to-r": "to-r";
+        "to-l": "to-l";
+        "to-t": "to-t";
+        "to-b": "to-b";
+        "to-tr": "to-tr";
+        "to-tl": "to-tl";
+        "to-br": "to-br";
+        "to-bl": "to-bl";
+    }>;
+    foregroundToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"surface">;
+    role: z.ZodLiteral<"link">;
+}, z.core.$strip>], "type">;
 export declare const buttonBackgroundSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"solid">;
-    colorToken: z.ZodString;
+    colorToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"gradient">;
-    stops: z.ZodArray<z.ZodString>;
+    stops: z.ZodPipe<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>, z.ZodTransform<[OpaqueButtonColourToken, OpaqueButtonColourToken, ...OpaqueButtonColourToken[]], OpaqueButtonColourToken[]>>;
     direction: z.ZodEnum<{
         "to-r": "to-r";
         "to-l": "to-l";
@@ -338,20 +378,23 @@ export declare const buttonBackgroundSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         "to-br": "to-br";
         "to-bl": "to-bl";
     }>;
+    foregroundToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
 }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"transparent">;
+    type: z.ZodLiteral<"surface">;
+    role: z.ZodLiteral<"link">;
 }, z.core.$strip>], "type">;
-export declare const effectApplicationSchema: z.ZodObject<{
-    effectId: z.ZodString;
-    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-}, z.core.$strip>;
+export declare const effectApplicationSchema: z.ZodType<EffectApplication>;
 export declare const buttonBorderSchema: z.ZodObject<{
     widthClass: z.ZodString;
-    colorToken: z.ZodString;
 }, z.core.$strip>;
 export declare const buttonVariantAffordanceSchema: z.ZodObject<{
     iconId: z.ZodString;
-    colorToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const variantEffectsSchema: z.ZodObject<{
+    base: z.ZodOptional<z.ZodArray<z.ZodType<EffectApplication, unknown, z.core.$ZodTypeInternals<EffectApplication, unknown>>>>;
+    hover: z.ZodOptional<z.ZodArray<z.ZodType<EffectApplication, unknown, z.core.$ZodTypeInternals<EffectApplication, unknown>>>>;
+    active: z.ZodOptional<z.ZodArray<z.ZodType<EffectApplication, unknown, z.core.$ZodTypeInternals<EffectApplication, unknown>>>>;
+    focus: z.ZodOptional<z.ZodArray<z.ZodType<EffectApplication, unknown, z.core.$ZodTypeInternals<EffectApplication, unknown>>>>;
 }, z.core.$strip>;
 /**
  * Per-variant size overrides schema — every entry is optional.
@@ -379,22 +422,24 @@ export declare const variantSizeOverridesSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
- * Unified variant schema. Every variant participates in the size system; the
- * optional `sizes` field lets a variant scale differently than the theme
- * default (e.g. link-style variants declaring zero horizontal padding at
- * every size).
+ * Temporary persisted-theme admission boundary for issue #1206.
+ *
+ * Production inventory on 2026-07-22 found 22 rows using the old independent
+ * `textColorToken`/border colour shape. New source and all downstream code use
+ * only the canonical relationship. Delete this preprocessor after the reviewed
+ * production rewrite reports zero legacy rows.
  */
-export declare const buttonVariantSchema: z.ZodObject<{
+export declare const buttonVariantSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     enabled: z.ZodBoolean;
     priority: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
     background: z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"solid">;
-        colorToken: z.ZodString;
+        colorToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"gradient">;
-        stops: z.ZodArray<z.ZodString>;
+        stops: z.ZodPipe<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>, z.ZodTransform<[OpaqueButtonColourToken, OpaqueButtonColourToken, ...OpaqueButtonColourToken[]], OpaqueButtonColourToken[]>>;
         direction: z.ZodEnum<{
             "to-r": "to-r";
             "to-l": "to-l";
@@ -405,10 +450,11 @@ export declare const buttonVariantSchema: z.ZodObject<{
             "to-br": "to-br";
             "to-bl": "to-bl";
         }>;
+        foregroundToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
     }, z.core.$strip>, z.ZodObject<{
-        type: z.ZodLiteral<"transparent">;
+        type: z.ZodLiteral<"surface">;
+        role: z.ZodLiteral<"link">;
     }, z.core.$strip>], "type">;
-    textColorToken: z.ZodString;
     borderRadius: z.ZodOptional<z.ZodString>;
     shadow: z.ZodOptional<z.ZodObject<{
         elevation: z.ZodEnum<{
@@ -430,26 +476,13 @@ export declare const buttonVariantSchema: z.ZodObject<{
     }, z.core.$strip>>;
     border: z.ZodOptional<z.ZodObject<{
         widthClass: z.ZodString;
-        colorToken: z.ZodString;
     }, z.core.$strip>>;
-    hoverBackgroundToken: z.ZodOptional<z.ZodString>;
+    hoverBackgroundToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
     effects: z.ZodOptional<z.ZodObject<{
-        base: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            effectId: z.ZodString;
-            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        }, z.core.$strip>>>;
-        hover: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            effectId: z.ZodString;
-            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        }, z.core.$strip>>>;
-        active: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            effectId: z.ZodString;
-            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        }, z.core.$strip>>>;
-        focus: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            effectId: z.ZodString;
-            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        }, z.core.$strip>>>;
+        base: z.ZodOptional<z.ZodArray<z.ZodType<EffectApplication, unknown, z.core.$ZodTypeInternals<EffectApplication, unknown>>>>;
+        hover: z.ZodOptional<z.ZodArray<z.ZodType<EffectApplication, unknown, z.core.$ZodTypeInternals<EffectApplication, unknown>>>>;
+        active: z.ZodOptional<z.ZodArray<z.ZodType<EffectApplication, unknown, z.core.$ZodTypeInternals<EffectApplication, unknown>>>>;
+        focus: z.ZodOptional<z.ZodArray<z.ZodType<EffectApplication, unknown, z.core.$ZodTypeInternals<EffectApplication, unknown>>>>;
     }, z.core.$strip>>;
     sizes: z.ZodOptional<z.ZodObject<{
         sm: z.ZodOptional<z.ZodObject<{
@@ -471,11 +504,10 @@ export declare const buttonVariantSchema: z.ZodObject<{
     }, z.core.$strip>>;
     affordance: z.ZodOptional<z.ZodObject<{
         iconId: z.ZodString;
-        colorToken: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
+}, z.core.$strip>>;
 export declare const buttonSystemSchema: z.ZodObject<{
-    global: z.ZodObject<{
+    global: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
         cornerStyle: z.ZodEnum<{
             square: "square";
             rounded: "rounded";
@@ -525,7 +557,7 @@ export declare const buttonSystemSchema: z.ZodObject<{
             darken: "darken";
             saturate: "saturate";
         }>;
-        hoverColorToken: z.ZodOptional<z.ZodString>;
+        hoverColorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
         gradientStyle: z.ZodOptional<z.ZodEnum<{
             linear: "linear";
             radial: "radial";
@@ -537,18 +569,18 @@ export declare const buttonSystemSchema: z.ZodObject<{
             hard: "hard";
             smooth: "smooth";
         }>>;
-    }, z.core.$strip>;
-    variants: z.ZodArray<z.ZodObject<{
+    }, z.core.$strip>>;
+    variants: z.ZodArray<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         enabled: z.ZodBoolean;
         priority: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
         background: z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodLiteral<"solid">;
-            colorToken: z.ZodString;
+            colorToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"gradient">;
-            stops: z.ZodArray<z.ZodString>;
+            stops: z.ZodPipe<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>, z.ZodTransform<[OpaqueButtonColourToken, OpaqueButtonColourToken, ...OpaqueButtonColourToken[]], OpaqueButtonColourToken[]>>;
             direction: z.ZodEnum<{
                 "to-r": "to-r";
                 "to-l": "to-l";
@@ -559,10 +591,11 @@ export declare const buttonSystemSchema: z.ZodObject<{
                 "to-br": "to-br";
                 "to-bl": "to-bl";
             }>;
+            foregroundToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
         }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"transparent">;
+            type: z.ZodLiteral<"surface">;
+            role: z.ZodLiteral<"link">;
         }, z.core.$strip>], "type">;
-        textColorToken: z.ZodString;
         borderRadius: z.ZodOptional<z.ZodString>;
         shadow: z.ZodOptional<z.ZodObject<{
             elevation: z.ZodEnum<{
@@ -584,26 +617,13 @@ export declare const buttonSystemSchema: z.ZodObject<{
         }, z.core.$strip>>;
         border: z.ZodOptional<z.ZodObject<{
             widthClass: z.ZodString;
-            colorToken: z.ZodString;
         }, z.core.$strip>>;
-        hoverBackgroundToken: z.ZodOptional<z.ZodString>;
+        hoverBackgroundToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
         effects: z.ZodOptional<z.ZodObject<{
-            base: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                effectId: z.ZodString;
-                options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-            }, z.core.$strip>>>;
-            hover: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                effectId: z.ZodString;
-                options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-            }, z.core.$strip>>>;
-            active: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                effectId: z.ZodString;
-                options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-            }, z.core.$strip>>>;
-            focus: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                effectId: z.ZodString;
-                options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-            }, z.core.$strip>>>;
+            base: z.ZodOptional<z.ZodArray<z.ZodType<EffectApplication, unknown, z.core.$ZodTypeInternals<EffectApplication, unknown>>>>;
+            hover: z.ZodOptional<z.ZodArray<z.ZodType<EffectApplication, unknown, z.core.$ZodTypeInternals<EffectApplication, unknown>>>>;
+            active: z.ZodOptional<z.ZodArray<z.ZodType<EffectApplication, unknown, z.core.$ZodTypeInternals<EffectApplication, unknown>>>>;
+            focus: z.ZodOptional<z.ZodArray<z.ZodType<EffectApplication, unknown, z.core.$ZodTypeInternals<EffectApplication, unknown>>>>;
         }, z.core.$strip>>;
         sizes: z.ZodOptional<z.ZodObject<{
             sm: z.ZodOptional<z.ZodObject<{
@@ -625,9 +645,8 @@ export declare const buttonSystemSchema: z.ZodObject<{
         }, z.core.$strip>>;
         affordance: z.ZodOptional<z.ZodObject<{
             iconId: z.ZodString;
-            colorToken: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
-    }, z.core.$strip>>;
+    }, z.core.$strip>>>;
     sizes: z.ZodOptional<z.ZodPipe<z.ZodObject<{
         sm: z.ZodObject<{
             padding: z.ZodString;
@@ -707,7 +726,7 @@ export interface ButtonGlobalSettings {
     hoverTransform: HoverTransform;
     hoverColor: HoverColor;
     /** When hoverColor is 'token', this specifies which token to use */
-    hoverColorToken?: string;
+    hoverColorToken?: OpaqueButtonColourToken;
     gradientStyle?: GradientStyle;
     gradientAngle?: number;
     gradientSharpness?: GradientSharpness;
@@ -737,13 +756,12 @@ export interface ButtonVariant {
     name: string;
     enabled: boolean;
     priority: Priority;
-    background: ButtonBackground;
-    textColorToken: string;
+    background: ButtonColourTreatment;
     /** Tailwind radius token (e.g. `'rounded-md'`). Omit to inherit from `global.cornerStyle`. */
     borderRadius?: string;
     shadow?: Shadow;
     border?: ButtonBorder;
-    hoverBackgroundToken?: string;
+    hoverBackgroundToken?: OpaqueButtonColourToken;
     effects?: VariantEffects;
     /** Per-variant size overrides. See VariantSizeOverrides. */
     sizes?: VariantSizeOverrides;

package/dist/_dts/theme-core/src/cards/types.d.ts

@@ -93,11 +93,11 @@ export declare const cardBorderSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** Per-corner radius value. `expressive` is a large block-radius multiple. */
 export declare const cardCornerValueSchema: z.ZodEnum<{
+    expressive: "expressive";
     soft: "soft";
     square: "square";
     rounded: "rounded";
     pill: "pill";
-    expressive: "expressive";
 }>;
 export type CardCornerValue = z.infer<typeof cardCornerValueSchema>;
 /**
@@ -106,9 +106,9 @@ export type CardCornerValue = z.infer<typeof cardCornerValueSchema>;
  */
 export declare const cardAccentEdgeSchema: z.ZodObject<{
     edge: z.ZodEnum<{
-        bottom: "bottom";
         left: "left";
         right: "right";
+        bottom: "bottom";
         top: "top";
     }>;
     colorToken: z.ZodString;
@@ -122,32 +122,32 @@ export declare const cardAccentEdgeSchema: z.ZodObject<{
 export type CardAccentEdge = z.infer<typeof cardAccentEdgeSchema>;
 export declare const cardCornerRadiiSchema: z.ZodObject<{
     topLeft: z.ZodOptional<z.ZodEnum<{
+        expressive: "expressive";
         soft: "soft";
         square: "square";
         rounded: "rounded";
         pill: "pill";
-        expressive: "expressive";
     }>>;
     topRight: z.ZodOptional<z.ZodEnum<{
+        expressive: "expressive";
         soft: "soft";
         square: "square";
         rounded: "rounded";
         pill: "pill";
-        expressive: "expressive";
     }>>;
     bottomLeft: z.ZodOptional<z.ZodEnum<{
+        expressive: "expressive";
         soft: "soft";
         square: "square";
         rounded: "rounded";
         pill: "pill";
-        expressive: "expressive";
     }>>;
     bottomRight: z.ZodOptional<z.ZodEnum<{
+        expressive: "expressive";
         soft: "soft";
         square: "square";
         rounded: "rounded";
         pill: "pill";
-        expressive: "expressive";
     }>>;
 }, z.core.$strip>;
 export type CardCornerRadii = z.infer<typeof cardCornerRadiiSchema>;
@@ -210,32 +210,32 @@ export declare const cardVariantSchema: z.ZodObject<{
     }>>;
     cornerRadii: z.ZodOptional<z.ZodObject<{
         topLeft: z.ZodOptional<z.ZodEnum<{
+            expressive: "expressive";
             soft: "soft";
             square: "square";
             rounded: "rounded";
             pill: "pill";
-            expressive: "expressive";
         }>>;
         topRight: z.ZodOptional<z.ZodEnum<{
+            expressive: "expressive";
             soft: "soft";
             square: "square";
             rounded: "rounded";
             pill: "pill";
-            expressive: "expressive";
         }>>;
         bottomLeft: z.ZodOptional<z.ZodEnum<{
+            expressive: "expressive";
             soft: "soft";
             square: "square";
             rounded: "rounded";
             pill: "pill";
-            expressive: "expressive";
         }>>;
         bottomRight: z.ZodOptional<z.ZodEnum<{
+            expressive: "expressive";
             soft: "soft";
             square: "square";
             rounded: "rounded";
             pill: "pill";
-            expressive: "expressive";
         }>>;
     }, z.core.$strip>>;
     border: z.ZodOptional<z.ZodObject<{
@@ -244,9 +244,9 @@ export declare const cardVariantSchema: z.ZodObject<{
     }, z.core.$strip>>;
     accentEdge: z.ZodOptional<z.ZodObject<{
         edge: z.ZodEnum<{
-            bottom: "bottom";
             left: "left";
             right: "right";
+            bottom: "bottom";
             top: "top";
         }>;
         colorToken: z.ZodString;
@@ -318,32 +318,32 @@ export declare const cardSystemSchema: z.ZodObject<{
         }>>;
         cornerRadii: z.ZodOptional<z.ZodObject<{
             topLeft: z.ZodOptional<z.ZodEnum<{
+                expressive: "expressive";
                 soft: "soft";
                 square: "square";
                 rounded: "rounded";
                 pill: "pill";
-                expressive: "expressive";
             }>>;
             topRight: z.ZodOptional<z.ZodEnum<{
+                expressive: "expressive";
                 soft: "soft";
                 square: "square";
                 rounded: "rounded";
                 pill: "pill";
-                expressive: "expressive";
             }>>;
             bottomLeft: z.ZodOptional<z.ZodEnum<{
+                expressive: "expressive";
                 soft: "soft";
                 square: "square";
                 rounded: "rounded";
                 pill: "pill";
-                expressive: "expressive";
             }>>;
             bottomRight: z.ZodOptional<z.ZodEnum<{
+                expressive: "expressive";
                 soft: "soft";
                 square: "square";
                 rounded: "rounded";
                 pill: "pill";
-                expressive: "expressive";
             }>>;
         }, z.core.$strip>>;
         border: z.ZodOptional<z.ZodObject<{
@@ -352,9 +352,9 @@ export declare const cardSystemSchema: z.ZodObject<{
         }, z.core.$strip>>;
         accentEdge: z.ZodOptional<z.ZodObject<{
             edge: z.ZodEnum<{
-                bottom: "bottom";
                 left: "left";
                 right: "right";
+                bottom: "bottom";
                 top: "top";
             }>;
             colorToken: z.ZodString;