@riverbankcms/sdk 0.111.0 → 0.119.0

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

@@ -15,7 +15,7 @@ export type Shadow = {
      * personalities are unaffected. Set it for coloured offset shadows
      * (e.g. a cream "stamp" shadow on a dark brand surface).
      */
-    colorToken?: string;
+    colorToken?: OpaqueButtonColourToken;
 };
 export type CornerStyle = 'square' | 'rounded' | 'pill';
 export type ShadowSize = 'none' | 'low' | 'medium' | 'high';
@@ -23,7 +23,7 @@ export type TextTransform = 'none' | 'uppercase' | 'lowercase' | 'capitalize';
 export type FontWeight = 500 | 600 | 700;
 export type ButtonTypography = 'body' | 'heading';
 export type HoverTransform = 'none' | 'lift' | 'scale' | 'press';
-export type HoverColor = 'none' | 'brighten' | 'darken' | 'saturate' | 'token';
+export type HoverColor = 'none' | 'token';
 export type ButtonPaddingPreset = 'compact' | 'default' | 'spacious';
 export type GradientStyle = 'linear' | 'radial' | 'conic';
 export type GradientSharpness = 'smooth' | 'medium' | 'hard';
@@ -45,6 +45,13 @@ export declare const VARIANT_ROLES: readonly ["primary", "secondary", "outline",
 export type VariantRole = (typeof VARIANT_ROLES)[number];
 export declare function isVariantRole(value: string): value is VariantRole;
 declare const SpecialVariantIdBrand: unique symbol;
+/**
+ * Canonical persisted/CSS-safe button variant identifier.
+ *
+ * IDs become class selectors, so keep the contract deliberately narrower than
+ * an arbitrary string and shared with every authoring/runtime boundary.
+ */
+export declare const buttonVariantIdSchema: z.ZodString;
 /**
  * Branded ID for theme-specific special variants that don't map to a standard role
  * (e.g. `banner`, `generous`, `pulse`, `danger`).
@@ -106,23 +113,135 @@ export type ButtonColourTreatment = {
     role: 'link';
 };
 export type ButtonBackground = ButtonColourTreatment;
-export type ButtonEffectOptionValue = string | number | boolean | null | ButtonEffectOptionValue[] | {
-    [key: string]: ButtonEffectOptionValue;
-};
-export type EffectApplication = {
-    effectId: string;
-    options?: Record<string, ButtonEffectOptionValue>;
-};
+/**
+ * The complete persisted button-effect contract.
+ *
+ * Navigation has its own generic interactive-effect model. Button variants use
+ * this closed union so unsupported effect IDs, unknown option keys, and unsafe
+ * CSS values cannot become representable after the schema boundary.
+ */
+export declare const buttonEffectApplicationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    effectId: z.ZodLiteral<"darken-background">;
+    options: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"lighten-background">;
+    options: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"background-on-hover">;
+    options: z.ZodOptional<z.ZodObject<{
+        colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"animated-gradient">;
+    options: z.ZodOptional<z.ZodObject<{
+        direction: z.ZodOptional<z.ZodEnum<{
+            horizontal: "horizontal";
+            vertical: "vertical";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"drop-shadow">;
+    options: z.ZodOptional<z.ZodObject<{
+        intensity: z.ZodOptional<z.ZodEnum<{
+            medium: "medium";
+            subtle: "subtle";
+            strong: "strong";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"inner-shadow">;
+    options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"neumorphic-shadow">;
+    options: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodOptional<z.ZodEnum<{
+            raised: "raised";
+            pressed: "pressed";
+        }>>;
+        intensity: z.ZodOptional<z.ZodEnum<{
+            medium: "medium";
+            subtle: "subtle";
+            strong: "strong";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"retro-3d-shadow">;
+    options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"scale-up">;
+    options: z.ZodOptional<z.ZodObject<{
+        scale: z.ZodOptional<z.ZodEnum<{
+            1.02: "1.02";
+            1.03: "1.03";
+            1.05: "1.05";
+            "1.10": "1.10";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"scale-down">;
+    options: z.ZodOptional<z.ZodObject<{
+        scale: z.ZodOptional<z.ZodEnum<{
+            "0.90": "0.90";
+            0.95: "0.95";
+            0.97: "0.97";
+            0.98: "0.98";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"lift">;
+    options: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodOptional<z.ZodEnum<{
+            1: "1";
+            0.25: "0.25";
+            0.5: "0.5";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"press-down">;
+    options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"pop">;
+    options: z.ZodOptional<z.ZodObject<{
+        intensity: z.ZodOptional<z.ZodEnum<{
+            medium: "medium";
+            subtle: "subtle";
+            dramatic: "dramatic";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"border-bottom-grow">;
+    options: z.ZodOptional<z.ZodObject<{
+        height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        origin: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            right: "right";
+            center: "center";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    effectId: z.ZodLiteral<"sketchy-border">;
+    options: z.ZodOptional<z.ZodObject<{
+        intensity: z.ZodOptional<z.ZodEnum<{
+            medium: "medium";
+            subtle: "subtle";
+            strong: "strong";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "effectId">;
+export type ButtonEffectApplication = z.infer<typeof buttonEffectApplicationSchema>;
 export interface ButtonBorder {
     widthClass: string;
 }
 /**
  * Optional trailing affordance icon carried by a button variant.
  *
- * When set, the generated button CSS emits a themed trailing icon (a masked
- * SVG in `colorToken`, or `currentColor` when the token is omitted) after the
- * label — so a personality can supply an affordance (e.g. a CTA arrow) to every
- * button of that variant without per-node authoring. Entirely optional: variants
+ * When set, the generated button CSS emits a masked SVG in `currentColor`
+ * after the label, so the theme can supply an affordance (e.g. a CTA arrow)
+ * to every button of that variant without per-node authoring. Entirely optional: variants
  * that omit `affordance` are byte-identical to before.
  *
  * `iconId` references the shared icon registry (the same id space a `button`
@@ -170,9 +289,6 @@ export declare const hoverTransformSchema: z.ZodEnum<{
 export declare const hoverColorSchema: z.ZodEnum<{
     none: "none";
     token: "token";
-    brighten: "brighten";
-    darken: "darken";
-    saturate: "saturate";
 }>;
 export declare const buttonPaddingPresetSchema: z.ZodEnum<{
     default: "default";
@@ -268,7 +384,7 @@ export declare const buttonSizesSchema: z.ZodPipe<z.ZodObject<{
         fontSize?: string | undefined;
     } | undefined;
 }>>;
-export declare const buttonGlobalSettingsSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+export declare const buttonGlobalSettingsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     cornerStyle: z.ZodEnum<{
         square: "square";
         rounded: "rounded";
@@ -288,7 +404,6 @@ export declare const buttonGlobalSettingsSchema: z.ZodPipe<z.ZodTransform<unknow
         capitalize: "capitalize";
     }>;
     fontWeight: z.ZodUnion<readonly [z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>]>;
-    borderWidth: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
     typography: z.ZodOptional<z.ZodEnum<{
         heading: "heading";
         body: "body";
@@ -311,14 +426,61 @@ export declare const buttonGlobalSettingsSchema: z.ZodPipe<z.ZodTransform<unknow
         lift: "lift";
         press: "press";
     }>;
-    hoverColor: z.ZodEnum<{
+    gradientStyle: z.ZodOptional<z.ZodEnum<{
+        linear: "linear";
+        radial: "radial";
+        conic: "conic";
+    }>>;
+    gradientAngle: z.ZodOptional<z.ZodNumber>;
+    gradientSharpness: z.ZodOptional<z.ZodEnum<{
+        medium: "medium";
+        hard: "hard";
+        smooth: "smooth";
+    }>>;
+    hoverColor: z.ZodLiteral<"none">;
+    hoverColorToken: z.ZodOptional<z.ZodNever>;
+}, z.core.$strict>, z.ZodObject<{
+    cornerStyle: z.ZodEnum<{
+        square: "square";
+        rounded: "rounded";
+        pill: "pill";
+    }>;
+    cornerRadius: z.ZodOptional<z.ZodNumber>;
+    shadow: z.ZodOptional<z.ZodEnum<{
+        medium: "medium";
+        none: "none";
+        high: "high";
+        low: "low";
+    }>>;
+    textTransform: z.ZodEnum<{
         none: "none";
-        token: "token";
-        brighten: "brighten";
-        darken: "darken";
-        saturate: "saturate";
+        lowercase: "lowercase";
+        uppercase: "uppercase";
+        capitalize: "capitalize";
+    }>;
+    fontWeight: z.ZodUnion<readonly [z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>]>;
+    typography: z.ZodOptional<z.ZodEnum<{
+        heading: "heading";
+        body: "body";
+    }>>;
+    fontSize: z.ZodOptional<z.ZodString>;
+    letterSpacing: z.ZodOptional<z.ZodEnum<{
+        tight: "tight";
+        normal: "normal";
+        loose: "loose";
+    }>>;
+    italic: z.ZodOptional<z.ZodBoolean>;
+    paddingPreset: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        compact: "compact";
+        spacious: "spacious";
+    }>>;
+    hoverTransform: z.ZodEnum<{
+        none: "none";
+        scale: "scale";
+        lift: "lift";
+        press: "press";
     }>;
-    hoverColorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
     gradientStyle: z.ZodOptional<z.ZodEnum<{
         linear: "linear";
         radial: "radial";
@@ -330,7 +492,9 @@ export declare const buttonGlobalSettingsSchema: z.ZodPipe<z.ZodTransform<unknow
         hard: "hard";
         smooth: "smooth";
     }>>;
-}, z.core.$strip>>;
+    hoverColor: z.ZodLiteral<"token">;
+    hoverColorToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
+}, z.core.$strict>], "hoverColor">;
 export declare const gradientDirectionSchema: z.ZodEnum<{
     "to-r": "to-r";
     "to-l": "to-l";
@@ -344,7 +508,7 @@ export declare const gradientDirectionSchema: z.ZodEnum<{
 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<{
+}, z.core.$strict>, 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<{
@@ -358,14 +522,14 @@ export declare const buttonColourTreatmentSchema: z.ZodDiscriminatedUnion<[z.Zod
         "to-bl": "to-bl";
     }>;
     foregroundToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
-}, z.core.$strip>, z.ZodObject<{
+}, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"surface">;
     role: z.ZodLiteral<"link">;
-}, z.core.$strip>], "type">;
+}, z.core.$strict>], "type">;
 export declare const buttonBackgroundSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"solid">;
     colorToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
-}, z.core.$strip>, z.ZodObject<{
+}, z.core.$strict>, 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<{
@@ -379,23 +543,466 @@ export declare const buttonBackgroundSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         "to-bl": "to-bl";
     }>;
     foregroundToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
-}, z.core.$strip>, z.ZodObject<{
+}, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"surface">;
     role: z.ZodLiteral<"link">;
-}, z.core.$strip>], "type">;
-export declare const effectApplicationSchema: z.ZodType<EffectApplication>;
+}, z.core.$strict>], "type">;
 export declare const buttonBorderSchema: z.ZodObject<{
     widthClass: z.ZodString;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export declare const buttonVariantAffordanceSchema: z.ZodObject<{
     iconId: z.ZodString;
-}, z.core.$strip>;
+}, z.core.$strict>;
 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>;
+    base: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        effectId: z.ZodLiteral<"darken-background">;
+        options: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"lighten-background">;
+        options: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"background-on-hover">;
+        options: z.ZodOptional<z.ZodObject<{
+            colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"animated-gradient">;
+        options: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodOptional<z.ZodEnum<{
+                horizontal: "horizontal";
+                vertical: "vertical";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"drop-shadow">;
+        options: z.ZodOptional<z.ZodObject<{
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                strong: "strong";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"inner-shadow">;
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"neumorphic-shadow">;
+        options: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodOptional<z.ZodEnum<{
+                raised: "raised";
+                pressed: "pressed";
+            }>>;
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                strong: "strong";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"retro-3d-shadow">;
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"scale-up">;
+        options: z.ZodOptional<z.ZodObject<{
+            scale: z.ZodOptional<z.ZodEnum<{
+                1.02: "1.02";
+                1.03: "1.03";
+                1.05: "1.05";
+                "1.10": "1.10";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"scale-down">;
+        options: z.ZodOptional<z.ZodObject<{
+            scale: z.ZodOptional<z.ZodEnum<{
+                "0.90": "0.90";
+                0.95: "0.95";
+                0.97: "0.97";
+                0.98: "0.98";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"lift">;
+        options: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodEnum<{
+                1: "1";
+                0.25: "0.25";
+                0.5: "0.5";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"press-down">;
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"pop">;
+        options: z.ZodOptional<z.ZodObject<{
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                dramatic: "dramatic";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"border-bottom-grow">;
+        options: z.ZodOptional<z.ZodObject<{
+            height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+            origin: z.ZodOptional<z.ZodEnum<{
+                left: "left";
+                right: "right";
+                center: "center";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"sketchy-border">;
+        options: z.ZodOptional<z.ZodObject<{
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                strong: "strong";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "effectId">>>;
+    hover: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        effectId: z.ZodLiteral<"darken-background">;
+        options: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"lighten-background">;
+        options: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"background-on-hover">;
+        options: z.ZodOptional<z.ZodObject<{
+            colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"animated-gradient">;
+        options: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodOptional<z.ZodEnum<{
+                horizontal: "horizontal";
+                vertical: "vertical";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"drop-shadow">;
+        options: z.ZodOptional<z.ZodObject<{
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                strong: "strong";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"inner-shadow">;
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"neumorphic-shadow">;
+        options: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodOptional<z.ZodEnum<{
+                raised: "raised";
+                pressed: "pressed";
+            }>>;
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                strong: "strong";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"retro-3d-shadow">;
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"scale-up">;
+        options: z.ZodOptional<z.ZodObject<{
+            scale: z.ZodOptional<z.ZodEnum<{
+                1.02: "1.02";
+                1.03: "1.03";
+                1.05: "1.05";
+                "1.10": "1.10";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"scale-down">;
+        options: z.ZodOptional<z.ZodObject<{
+            scale: z.ZodOptional<z.ZodEnum<{
+                "0.90": "0.90";
+                0.95: "0.95";
+                0.97: "0.97";
+                0.98: "0.98";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"lift">;
+        options: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodEnum<{
+                1: "1";
+                0.25: "0.25";
+                0.5: "0.5";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"press-down">;
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"pop">;
+        options: z.ZodOptional<z.ZodObject<{
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                dramatic: "dramatic";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"border-bottom-grow">;
+        options: z.ZodOptional<z.ZodObject<{
+            height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+            origin: z.ZodOptional<z.ZodEnum<{
+                left: "left";
+                right: "right";
+                center: "center";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"sketchy-border">;
+        options: z.ZodOptional<z.ZodObject<{
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                strong: "strong";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "effectId">>>;
+    active: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        effectId: z.ZodLiteral<"darken-background">;
+        options: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"lighten-background">;
+        options: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"background-on-hover">;
+        options: z.ZodOptional<z.ZodObject<{
+            colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"animated-gradient">;
+        options: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodOptional<z.ZodEnum<{
+                horizontal: "horizontal";
+                vertical: "vertical";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"drop-shadow">;
+        options: z.ZodOptional<z.ZodObject<{
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                strong: "strong";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"inner-shadow">;
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"neumorphic-shadow">;
+        options: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodOptional<z.ZodEnum<{
+                raised: "raised";
+                pressed: "pressed";
+            }>>;
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                strong: "strong";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"retro-3d-shadow">;
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"scale-up">;
+        options: z.ZodOptional<z.ZodObject<{
+            scale: z.ZodOptional<z.ZodEnum<{
+                1.02: "1.02";
+                1.03: "1.03";
+                1.05: "1.05";
+                "1.10": "1.10";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"scale-down">;
+        options: z.ZodOptional<z.ZodObject<{
+            scale: z.ZodOptional<z.ZodEnum<{
+                "0.90": "0.90";
+                0.95: "0.95";
+                0.97: "0.97";
+                0.98: "0.98";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"lift">;
+        options: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodEnum<{
+                1: "1";
+                0.25: "0.25";
+                0.5: "0.5";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"press-down">;
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"pop">;
+        options: z.ZodOptional<z.ZodObject<{
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                dramatic: "dramatic";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"border-bottom-grow">;
+        options: z.ZodOptional<z.ZodObject<{
+            height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+            origin: z.ZodOptional<z.ZodEnum<{
+                left: "left";
+                right: "right";
+                center: "center";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"sketchy-border">;
+        options: z.ZodOptional<z.ZodObject<{
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                strong: "strong";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "effectId">>>;
+    focus: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        effectId: z.ZodLiteral<"darken-background">;
+        options: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"lighten-background">;
+        options: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"background-on-hover">;
+        options: z.ZodOptional<z.ZodObject<{
+            colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"animated-gradient">;
+        options: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodOptional<z.ZodEnum<{
+                horizontal: "horizontal";
+                vertical: "vertical";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"drop-shadow">;
+        options: z.ZodOptional<z.ZodObject<{
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                strong: "strong";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"inner-shadow">;
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"neumorphic-shadow">;
+        options: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodOptional<z.ZodEnum<{
+                raised: "raised";
+                pressed: "pressed";
+            }>>;
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                strong: "strong";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"retro-3d-shadow">;
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"scale-up">;
+        options: z.ZodOptional<z.ZodObject<{
+            scale: z.ZodOptional<z.ZodEnum<{
+                1.02: "1.02";
+                1.03: "1.03";
+                1.05: "1.05";
+                "1.10": "1.10";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"scale-down">;
+        options: z.ZodOptional<z.ZodObject<{
+            scale: z.ZodOptional<z.ZodEnum<{
+                "0.90": "0.90";
+                0.95: "0.95";
+                0.97: "0.97";
+                0.98: "0.98";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"lift">;
+        options: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodEnum<{
+                1: "1";
+                0.25: "0.25";
+                0.5: "0.5";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"press-down">;
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"pop">;
+        options: z.ZodOptional<z.ZodObject<{
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                dramatic: "dramatic";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"border-bottom-grow">;
+        options: z.ZodOptional<z.ZodObject<{
+            height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+            origin: z.ZodOptional<z.ZodEnum<{
+                left: "left";
+                right: "right";
+                center: "center";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        effectId: z.ZodLiteral<"sketchy-border">;
+        options: z.ZodOptional<z.ZodObject<{
+            intensity: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                subtle: "subtle";
+                strong: "strong";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "effectId">>>;
+}, z.core.$strict>;
 /**
  * Per-variant size overrides schema — every entry is optional.
  *
@@ -422,14 +1029,12 @@ export declare const variantSizeOverridesSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
- * 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.
+ * 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).
  */
-export declare const buttonVariantSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+export declare const buttonVariantSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     enabled: z.ZodBoolean;
@@ -437,7 +1042,7 @@ export declare const buttonVariantSchema: z.ZodPipe<z.ZodTransform<unknown, unkn
     background: z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"solid">;
         colorToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, 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<{
@@ -451,10 +1056,11 @@ export declare const buttonVariantSchema: z.ZodPipe<z.ZodTransform<unknown, unkn
             "to-bl": "to-bl";
         }>;
         foregroundToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"surface">;
         role: z.ZodLiteral<"link">;
-    }, z.core.$strip>], "type">;
+    }, z.core.$strict>], "type">;
+    /** Tailwind radius token (e.g. `'rounded-md'`). Omit to inherit from `global.cornerStyle`. */
     borderRadius: z.ZodOptional<z.ZodString>;
     shadow: z.ZodOptional<z.ZodObject<{
         elevation: z.ZodEnum<{
@@ -472,18 +1078,462 @@ export declare const buttonVariantSchema: z.ZodPipe<z.ZodTransform<unknown, unkn
             bottom: "bottom";
             "bottom-right": "bottom-right";
         }>>;
-        colorToken: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+        colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+    }, z.core.$strict>>;
     border: z.ZodOptional<z.ZodObject<{
         widthClass: z.ZodString;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     hoverBackgroundToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
     effects: z.ZodOptional<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>>;
+        base: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            effectId: z.ZodLiteral<"darken-background">;
+            options: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"lighten-background">;
+            options: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"background-on-hover">;
+            options: z.ZodOptional<z.ZodObject<{
+                colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"animated-gradient">;
+            options: z.ZodOptional<z.ZodObject<{
+                direction: z.ZodOptional<z.ZodEnum<{
+                    horizontal: "horizontal";
+                    vertical: "vertical";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"drop-shadow">;
+            options: z.ZodOptional<z.ZodObject<{
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    strong: "strong";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"inner-shadow">;
+            options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"neumorphic-shadow">;
+            options: z.ZodOptional<z.ZodObject<{
+                mode: z.ZodOptional<z.ZodEnum<{
+                    raised: "raised";
+                    pressed: "pressed";
+                }>>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    strong: "strong";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"retro-3d-shadow">;
+            options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"scale-up">;
+            options: z.ZodOptional<z.ZodObject<{
+                scale: z.ZodOptional<z.ZodEnum<{
+                    1.02: "1.02";
+                    1.03: "1.03";
+                    1.05: "1.05";
+                    "1.10": "1.10";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"scale-down">;
+            options: z.ZodOptional<z.ZodObject<{
+                scale: z.ZodOptional<z.ZodEnum<{
+                    "0.90": "0.90";
+                    0.95: "0.95";
+                    0.97: "0.97";
+                    0.98: "0.98";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"lift">;
+            options: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodOptional<z.ZodEnum<{
+                    1: "1";
+                    0.25: "0.25";
+                    0.5: "0.5";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"press-down">;
+            options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"pop">;
+            options: z.ZodOptional<z.ZodObject<{
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    dramatic: "dramatic";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"border-bottom-grow">;
+            options: z.ZodOptional<z.ZodObject<{
+                height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+                origin: z.ZodOptional<z.ZodEnum<{
+                    left: "left";
+                    right: "right";
+                    center: "center";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"sketchy-border">;
+            options: z.ZodOptional<z.ZodObject<{
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    strong: "strong";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "effectId">>>;
+        hover: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            effectId: z.ZodLiteral<"darken-background">;
+            options: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"lighten-background">;
+            options: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"background-on-hover">;
+            options: z.ZodOptional<z.ZodObject<{
+                colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"animated-gradient">;
+            options: z.ZodOptional<z.ZodObject<{
+                direction: z.ZodOptional<z.ZodEnum<{
+                    horizontal: "horizontal";
+                    vertical: "vertical";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"drop-shadow">;
+            options: z.ZodOptional<z.ZodObject<{
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    strong: "strong";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"inner-shadow">;
+            options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"neumorphic-shadow">;
+            options: z.ZodOptional<z.ZodObject<{
+                mode: z.ZodOptional<z.ZodEnum<{
+                    raised: "raised";
+                    pressed: "pressed";
+                }>>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    strong: "strong";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"retro-3d-shadow">;
+            options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"scale-up">;
+            options: z.ZodOptional<z.ZodObject<{
+                scale: z.ZodOptional<z.ZodEnum<{
+                    1.02: "1.02";
+                    1.03: "1.03";
+                    1.05: "1.05";
+                    "1.10": "1.10";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"scale-down">;
+            options: z.ZodOptional<z.ZodObject<{
+                scale: z.ZodOptional<z.ZodEnum<{
+                    "0.90": "0.90";
+                    0.95: "0.95";
+                    0.97: "0.97";
+                    0.98: "0.98";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"lift">;
+            options: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodOptional<z.ZodEnum<{
+                    1: "1";
+                    0.25: "0.25";
+                    0.5: "0.5";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"press-down">;
+            options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"pop">;
+            options: z.ZodOptional<z.ZodObject<{
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    dramatic: "dramatic";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"border-bottom-grow">;
+            options: z.ZodOptional<z.ZodObject<{
+                height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+                origin: z.ZodOptional<z.ZodEnum<{
+                    left: "left";
+                    right: "right";
+                    center: "center";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"sketchy-border">;
+            options: z.ZodOptional<z.ZodObject<{
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    strong: "strong";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "effectId">>>;
+        active: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            effectId: z.ZodLiteral<"darken-background">;
+            options: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"lighten-background">;
+            options: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"background-on-hover">;
+            options: z.ZodOptional<z.ZodObject<{
+                colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"animated-gradient">;
+            options: z.ZodOptional<z.ZodObject<{
+                direction: z.ZodOptional<z.ZodEnum<{
+                    horizontal: "horizontal";
+                    vertical: "vertical";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"drop-shadow">;
+            options: z.ZodOptional<z.ZodObject<{
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    strong: "strong";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"inner-shadow">;
+            options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"neumorphic-shadow">;
+            options: z.ZodOptional<z.ZodObject<{
+                mode: z.ZodOptional<z.ZodEnum<{
+                    raised: "raised";
+                    pressed: "pressed";
+                }>>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    strong: "strong";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"retro-3d-shadow">;
+            options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"scale-up">;
+            options: z.ZodOptional<z.ZodObject<{
+                scale: z.ZodOptional<z.ZodEnum<{
+                    1.02: "1.02";
+                    1.03: "1.03";
+                    1.05: "1.05";
+                    "1.10": "1.10";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"scale-down">;
+            options: z.ZodOptional<z.ZodObject<{
+                scale: z.ZodOptional<z.ZodEnum<{
+                    "0.90": "0.90";
+                    0.95: "0.95";
+                    0.97: "0.97";
+                    0.98: "0.98";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"lift">;
+            options: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodOptional<z.ZodEnum<{
+                    1: "1";
+                    0.25: "0.25";
+                    0.5: "0.5";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"press-down">;
+            options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"pop">;
+            options: z.ZodOptional<z.ZodObject<{
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    dramatic: "dramatic";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"border-bottom-grow">;
+            options: z.ZodOptional<z.ZodObject<{
+                height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+                origin: z.ZodOptional<z.ZodEnum<{
+                    left: "left";
+                    right: "right";
+                    center: "center";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"sketchy-border">;
+            options: z.ZodOptional<z.ZodObject<{
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    strong: "strong";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "effectId">>>;
+        focus: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            effectId: z.ZodLiteral<"darken-background">;
+            options: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"lighten-background">;
+            options: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"background-on-hover">;
+            options: z.ZodOptional<z.ZodObject<{
+                colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"animated-gradient">;
+            options: z.ZodOptional<z.ZodObject<{
+                direction: z.ZodOptional<z.ZodEnum<{
+                    horizontal: "horizontal";
+                    vertical: "vertical";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"drop-shadow">;
+            options: z.ZodOptional<z.ZodObject<{
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    strong: "strong";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"inner-shadow">;
+            options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"neumorphic-shadow">;
+            options: z.ZodOptional<z.ZodObject<{
+                mode: z.ZodOptional<z.ZodEnum<{
+                    raised: "raised";
+                    pressed: "pressed";
+                }>>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    strong: "strong";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"retro-3d-shadow">;
+            options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"scale-up">;
+            options: z.ZodOptional<z.ZodObject<{
+                scale: z.ZodOptional<z.ZodEnum<{
+                    1.02: "1.02";
+                    1.03: "1.03";
+                    1.05: "1.05";
+                    "1.10": "1.10";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"scale-down">;
+            options: z.ZodOptional<z.ZodObject<{
+                scale: z.ZodOptional<z.ZodEnum<{
+                    "0.90": "0.90";
+                    0.95: "0.95";
+                    0.97: "0.97";
+                    0.98: "0.98";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"lift">;
+            options: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodOptional<z.ZodEnum<{
+                    1: "1";
+                    0.25: "0.25";
+                    0.5: "0.5";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"press-down">;
+            options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"pop">;
+            options: z.ZodOptional<z.ZodObject<{
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    dramatic: "dramatic";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"border-bottom-grow">;
+            options: z.ZodOptional<z.ZodObject<{
+                height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+                origin: z.ZodOptional<z.ZodEnum<{
+                    left: "left";
+                    right: "right";
+                    center: "center";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            effectId: z.ZodLiteral<"sketchy-border">;
+            options: z.ZodOptional<z.ZodObject<{
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    medium: "medium";
+                    subtle: "subtle";
+                    strong: "strong";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "effectId">>>;
+    }, z.core.$strict>>;
     sizes: z.ZodOptional<z.ZodObject<{
         sm: z.ZodOptional<z.ZodObject<{
             padding: z.ZodString;
@@ -504,10 +1554,10 @@ export declare const buttonVariantSchema: z.ZodPipe<z.ZodTransform<unknown, unkn
     }, z.core.$strip>>;
     affordance: z.ZodOptional<z.ZodObject<{
         iconId: z.ZodString;
-    }, z.core.$strip>>;
-}, z.core.$strip>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
 export declare const buttonSystemSchema: z.ZodObject<{
-    global: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    global: z.ZodDiscriminatedUnion<[z.ZodObject<{
         cornerStyle: z.ZodEnum<{
             square: "square";
             rounded: "rounded";
@@ -527,7 +1577,6 @@ export declare const buttonSystemSchema: z.ZodObject<{
             capitalize: "capitalize";
         }>;
         fontWeight: z.ZodUnion<readonly [z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>]>;
-        borderWidth: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
         typography: z.ZodOptional<z.ZodEnum<{
             heading: "heading";
             body: "body";
@@ -550,14 +1599,61 @@ export declare const buttonSystemSchema: z.ZodObject<{
             lift: "lift";
             press: "press";
         }>;
-        hoverColor: z.ZodEnum<{
+        gradientStyle: z.ZodOptional<z.ZodEnum<{
+            linear: "linear";
+            radial: "radial";
+            conic: "conic";
+        }>>;
+        gradientAngle: z.ZodOptional<z.ZodNumber>;
+        gradientSharpness: z.ZodOptional<z.ZodEnum<{
+            medium: "medium";
+            hard: "hard";
+            smooth: "smooth";
+        }>>;
+        hoverColor: z.ZodLiteral<"none">;
+        hoverColorToken: z.ZodOptional<z.ZodNever>;
+    }, z.core.$strict>, z.ZodObject<{
+        cornerStyle: z.ZodEnum<{
+            square: "square";
+            rounded: "rounded";
+            pill: "pill";
+        }>;
+        cornerRadius: z.ZodOptional<z.ZodNumber>;
+        shadow: z.ZodOptional<z.ZodEnum<{
+            medium: "medium";
+            none: "none";
+            high: "high";
+            low: "low";
+        }>>;
+        textTransform: z.ZodEnum<{
+            none: "none";
+            lowercase: "lowercase";
+            uppercase: "uppercase";
+            capitalize: "capitalize";
+        }>;
+        fontWeight: z.ZodUnion<readonly [z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>]>;
+        typography: z.ZodOptional<z.ZodEnum<{
+            heading: "heading";
+            body: "body";
+        }>>;
+        fontSize: z.ZodOptional<z.ZodString>;
+        letterSpacing: z.ZodOptional<z.ZodEnum<{
+            tight: "tight";
+            normal: "normal";
+            loose: "loose";
+        }>>;
+        italic: z.ZodOptional<z.ZodBoolean>;
+        paddingPreset: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            compact: "compact";
+            spacious: "spacious";
+        }>>;
+        hoverTransform: z.ZodEnum<{
             none: "none";
-            token: "token";
-            brighten: "brighten";
-            darken: "darken";
-            saturate: "saturate";
+            scale: "scale";
+            lift: "lift";
+            press: "press";
         }>;
-        hoverColorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
         gradientStyle: z.ZodOptional<z.ZodEnum<{
             linear: "linear";
             radial: "radial";
@@ -569,8 +1665,10 @@ export declare const buttonSystemSchema: z.ZodObject<{
             hard: "hard";
             smooth: "smooth";
         }>>;
-    }, z.core.$strip>>;
-    variants: z.ZodArray<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+        hoverColor: z.ZodLiteral<"token">;
+        hoverColorToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
+    }, z.core.$strict>], "hoverColor">;
+    variants: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         enabled: z.ZodBoolean;
@@ -578,7 +1676,7 @@ export declare const buttonSystemSchema: z.ZodObject<{
         background: z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodLiteral<"solid">;
             colorToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
-        }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>, 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<{
@@ -592,10 +1690,11 @@ export declare const buttonSystemSchema: z.ZodObject<{
                 "to-bl": "to-bl";
             }>;
             foregroundToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
-        }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>, z.ZodObject<{
             type: z.ZodLiteral<"surface">;
             role: z.ZodLiteral<"link">;
-        }, z.core.$strip>], "type">;
+        }, z.core.$strict>], "type">;
+        /** Tailwind radius token (e.g. `'rounded-md'`). Omit to inherit from `global.cornerStyle`. */
         borderRadius: z.ZodOptional<z.ZodString>;
         shadow: z.ZodOptional<z.ZodObject<{
             elevation: z.ZodEnum<{
@@ -613,18 +1712,462 @@ export declare const buttonSystemSchema: z.ZodObject<{
                 bottom: "bottom";
                 "bottom-right": "bottom-right";
             }>>;
-            colorToken: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
+            colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+        }, z.core.$strict>>;
         border: z.ZodOptional<z.ZodObject<{
             widthClass: z.ZodString;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         hoverBackgroundToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
         effects: z.ZodOptional<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>>;
+            base: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                effectId: z.ZodLiteral<"darken-background">;
+                options: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"lighten-background">;
+                options: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"background-on-hover">;
+                options: z.ZodOptional<z.ZodObject<{
+                    colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"animated-gradient">;
+                options: z.ZodOptional<z.ZodObject<{
+                    direction: z.ZodOptional<z.ZodEnum<{
+                        horizontal: "horizontal";
+                        vertical: "vertical";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"drop-shadow">;
+                options: z.ZodOptional<z.ZodObject<{
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        strong: "strong";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"inner-shadow">;
+                options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"neumorphic-shadow">;
+                options: z.ZodOptional<z.ZodObject<{
+                    mode: z.ZodOptional<z.ZodEnum<{
+                        raised: "raised";
+                        pressed: "pressed";
+                    }>>;
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        strong: "strong";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"retro-3d-shadow">;
+                options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"scale-up">;
+                options: z.ZodOptional<z.ZodObject<{
+                    scale: z.ZodOptional<z.ZodEnum<{
+                        1.02: "1.02";
+                        1.03: "1.03";
+                        1.05: "1.05";
+                        "1.10": "1.10";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"scale-down">;
+                options: z.ZodOptional<z.ZodObject<{
+                    scale: z.ZodOptional<z.ZodEnum<{
+                        "0.90": "0.90";
+                        0.95: "0.95";
+                        0.97: "0.97";
+                        0.98: "0.98";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"lift">;
+                options: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodOptional<z.ZodEnum<{
+                        1: "1";
+                        0.25: "0.25";
+                        0.5: "0.5";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"press-down">;
+                options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"pop">;
+                options: z.ZodOptional<z.ZodObject<{
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        dramatic: "dramatic";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"border-bottom-grow">;
+                options: z.ZodOptional<z.ZodObject<{
+                    height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+                    origin: z.ZodOptional<z.ZodEnum<{
+                        left: "left";
+                        right: "right";
+                        center: "center";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"sketchy-border">;
+                options: z.ZodOptional<z.ZodObject<{
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        strong: "strong";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>], "effectId">>>;
+            hover: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                effectId: z.ZodLiteral<"darken-background">;
+                options: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"lighten-background">;
+                options: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"background-on-hover">;
+                options: z.ZodOptional<z.ZodObject<{
+                    colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"animated-gradient">;
+                options: z.ZodOptional<z.ZodObject<{
+                    direction: z.ZodOptional<z.ZodEnum<{
+                        horizontal: "horizontal";
+                        vertical: "vertical";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"drop-shadow">;
+                options: z.ZodOptional<z.ZodObject<{
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        strong: "strong";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"inner-shadow">;
+                options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"neumorphic-shadow">;
+                options: z.ZodOptional<z.ZodObject<{
+                    mode: z.ZodOptional<z.ZodEnum<{
+                        raised: "raised";
+                        pressed: "pressed";
+                    }>>;
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        strong: "strong";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"retro-3d-shadow">;
+                options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"scale-up">;
+                options: z.ZodOptional<z.ZodObject<{
+                    scale: z.ZodOptional<z.ZodEnum<{
+                        1.02: "1.02";
+                        1.03: "1.03";
+                        1.05: "1.05";
+                        "1.10": "1.10";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"scale-down">;
+                options: z.ZodOptional<z.ZodObject<{
+                    scale: z.ZodOptional<z.ZodEnum<{
+                        "0.90": "0.90";
+                        0.95: "0.95";
+                        0.97: "0.97";
+                        0.98: "0.98";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"lift">;
+                options: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodOptional<z.ZodEnum<{
+                        1: "1";
+                        0.25: "0.25";
+                        0.5: "0.5";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"press-down">;
+                options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"pop">;
+                options: z.ZodOptional<z.ZodObject<{
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        dramatic: "dramatic";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"border-bottom-grow">;
+                options: z.ZodOptional<z.ZodObject<{
+                    height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+                    origin: z.ZodOptional<z.ZodEnum<{
+                        left: "left";
+                        right: "right";
+                        center: "center";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"sketchy-border">;
+                options: z.ZodOptional<z.ZodObject<{
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        strong: "strong";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>], "effectId">>>;
+            active: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                effectId: z.ZodLiteral<"darken-background">;
+                options: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"lighten-background">;
+                options: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"background-on-hover">;
+                options: z.ZodOptional<z.ZodObject<{
+                    colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"animated-gradient">;
+                options: z.ZodOptional<z.ZodObject<{
+                    direction: z.ZodOptional<z.ZodEnum<{
+                        horizontal: "horizontal";
+                        vertical: "vertical";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"drop-shadow">;
+                options: z.ZodOptional<z.ZodObject<{
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        strong: "strong";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"inner-shadow">;
+                options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"neumorphic-shadow">;
+                options: z.ZodOptional<z.ZodObject<{
+                    mode: z.ZodOptional<z.ZodEnum<{
+                        raised: "raised";
+                        pressed: "pressed";
+                    }>>;
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        strong: "strong";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"retro-3d-shadow">;
+                options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"scale-up">;
+                options: z.ZodOptional<z.ZodObject<{
+                    scale: z.ZodOptional<z.ZodEnum<{
+                        1.02: "1.02";
+                        1.03: "1.03";
+                        1.05: "1.05";
+                        "1.10": "1.10";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"scale-down">;
+                options: z.ZodOptional<z.ZodObject<{
+                    scale: z.ZodOptional<z.ZodEnum<{
+                        "0.90": "0.90";
+                        0.95: "0.95";
+                        0.97: "0.97";
+                        0.98: "0.98";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"lift">;
+                options: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodOptional<z.ZodEnum<{
+                        1: "1";
+                        0.25: "0.25";
+                        0.5: "0.5";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"press-down">;
+                options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"pop">;
+                options: z.ZodOptional<z.ZodObject<{
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        dramatic: "dramatic";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"border-bottom-grow">;
+                options: z.ZodOptional<z.ZodObject<{
+                    height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+                    origin: z.ZodOptional<z.ZodEnum<{
+                        left: "left";
+                        right: "right";
+                        center: "center";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"sketchy-border">;
+                options: z.ZodOptional<z.ZodObject<{
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        strong: "strong";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>], "effectId">>>;
+            focus: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                effectId: z.ZodLiteral<"darken-background">;
+                options: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"lighten-background">;
+                options: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"background-on-hover">;
+                options: z.ZodOptional<z.ZodObject<{
+                    colorToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"animated-gradient">;
+                options: z.ZodOptional<z.ZodObject<{
+                    direction: z.ZodOptional<z.ZodEnum<{
+                        horizontal: "horizontal";
+                        vertical: "vertical";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"drop-shadow">;
+                options: z.ZodOptional<z.ZodObject<{
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        strong: "strong";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"inner-shadow">;
+                options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"neumorphic-shadow">;
+                options: z.ZodOptional<z.ZodObject<{
+                    mode: z.ZodOptional<z.ZodEnum<{
+                        raised: "raised";
+                        pressed: "pressed";
+                    }>>;
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        strong: "strong";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"retro-3d-shadow">;
+                options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"scale-up">;
+                options: z.ZodOptional<z.ZodObject<{
+                    scale: z.ZodOptional<z.ZodEnum<{
+                        1.02: "1.02";
+                        1.03: "1.03";
+                        1.05: "1.05";
+                        "1.10": "1.10";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"scale-down">;
+                options: z.ZodOptional<z.ZodObject<{
+                    scale: z.ZodOptional<z.ZodEnum<{
+                        "0.90": "0.90";
+                        0.95: "0.95";
+                        0.97: "0.97";
+                        0.98: "0.98";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"lift">;
+                options: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodOptional<z.ZodEnum<{
+                        1: "1";
+                        0.25: "0.25";
+                        0.5: "0.5";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"press-down">;
+                options: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"pop">;
+                options: z.ZodOptional<z.ZodObject<{
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        dramatic: "dramatic";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"border-bottom-grow">;
+                options: z.ZodOptional<z.ZodObject<{
+                    height: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+                    origin: z.ZodOptional<z.ZodEnum<{
+                        left: "left";
+                        right: "right";
+                        center: "center";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                effectId: z.ZodLiteral<"sketchy-border">;
+                options: z.ZodOptional<z.ZodObject<{
+                    intensity: z.ZodOptional<z.ZodEnum<{
+                        medium: "medium";
+                        subtle: "subtle";
+                        strong: "strong";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>], "effectId">>>;
+        }, z.core.$strict>>;
         sizes: z.ZodOptional<z.ZodObject<{
             sm: z.ZodOptional<z.ZodObject<{
                 padding: z.ZodString;
@@ -645,8 +2188,8 @@ export declare const buttonSystemSchema: z.ZodObject<{
         }, z.core.$strip>>;
         affordance: z.ZodOptional<z.ZodObject<{
             iconId: z.ZodString;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
     sizes: z.ZodOptional<z.ZodPipe<z.ZodObject<{
         sm: z.ZodObject<{
             padding: z.ZodString;
@@ -699,9 +2242,9 @@ export declare const buttonSystemSchema: z.ZodObject<{
             fontSize?: string | undefined;
         } | undefined;
     }>>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type Priority = 1 | 2 | 3;
-export interface ButtonGlobalSettings {
+interface ButtonGlobalSettingsBase {
     cornerStyle: CornerStyle;
     cornerRadius?: number;
     /**
@@ -711,8 +2254,6 @@ export interface ButtonGlobalSettings {
     shadow?: ShadowSize;
     textTransform: TextTransform;
     fontWeight: FontWeight;
-    /** @deprecated See JSDoc on `buttonGlobalSettingsSchema.borderWidth`. */
-    borderWidth: 1 | 2 | 3;
     /** Typography source (body or heading) — picks which theme typography pool to use */
     typography?: ButtonTypography;
     /** Font size token for all variants in the family (e.g. "text-xs", "text-sm") */
@@ -724,19 +2265,23 @@ export interface ButtonGlobalSettings {
     /** Padding preset (used as sized-variant default when no sizes config) */
     paddingPreset?: ButtonPaddingPreset;
     hoverTransform: HoverTransform;
-    hoverColor: HoverColor;
-    /** When hoverColor is 'token', this specifies which token to use */
-    hoverColorToken?: OpaqueButtonColourToken;
     gradientStyle?: GradientStyle;
     gradientAngle?: number;
     gradientSharpness?: GradientSharpness;
 }
+export type ButtonGlobalSettings = ButtonGlobalSettingsBase & (Readonly<{
+    hoverColor: 'none';
+    hoverColorToken?: never;
+}> | Readonly<{
+    hoverColor: 'token';
+    hoverColorToken: OpaqueButtonColourToken;
+}>);
 /** Effects per state group */
 export interface VariantEffects {
-    base?: EffectApplication[];
-    hover?: EffectApplication[];
-    active?: EffectApplication[];
-    focus?: EffectApplication[];
+    base?: ButtonEffectApplication[];
+    hover?: ButtonEffectApplication[];
+    active?: ButtonEffectApplication[];
+    focus?: ButtonEffectApplication[];
 }
 /**
  * A button variant.