@uni-design-system/uni-angular 10.1.0 → 10.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uni-design-system/uni-angular",
-  "version": "10.1.0",
+  "version": "10.2.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -22,7 +22,7 @@
     "@angular/core": "^21.2.0",
     "@angular/forms": "^21.2.0",
     "@emotion/css": "^11.0.0",
-    "@uni-design-system/uni-core": "^10.1.0"
+    "@uni-design-system/uni-core": "^10.2.0"
   },
   "module": "fesm2022/uni-design-system-uni-angular.mjs",
   "typings": "types/uni-design-system-uni-angular.d.ts",

package/schematics/ng-add/index.js

@@ -901,6 +901,30 @@ var buildBorders = (c) => ({
 * surface and draws the edge — so every role stays consistent and a theme can
 * still override any single cell.
 */
+/**
+* Accent roles for the selection controls (checkbox, radio, toggle).
+*
+* A variant names the intent; this says which colour token draws it, and the
+* component decides where it lands — the box fill, the ring, the dot, the
+* track, the focus ring. Keeping it as a role rather than a `variants`
+* StyleExpression is what stops interior class names like `.checkbox-check`
+* becoming public theme contract.
+*
+* The same seven names `button` and `iconButton` theme, so the library is
+* consistent about which intents exist by default.
+*/
+var SELECTION_ACCENTS = {
+	primary: { accent: "primary" },
+	secondary: { accent: "secondary" },
+	tertiary: { accent: "tertiary" },
+	warn: { accent: "warn" },
+	success: { accent: "success" },
+	disabled: { accent: "disabled" },
+	ghost: {
+		accent: "ghost",
+		onAccent: "on-primary"
+	}
+};
 var tagVariant = (c, role) => ({ [role]: {
 	backgroundColor: c[`${role}-container`],
 	color: c[`on-${role}-container`],
@@ -1037,18 +1061,24 @@ var buildComponents = (c) => ({
 		activeColor: "primary-container",
 		maxSuggestions: 8
 	} },
-	checkbox: { options: {
-		size: 20,
-		boxColor: "surface",
-		borderRadius: 2,
-		focusRingGap: 2
-	} },
-	radio: { options: {
-		size: 20,
-		ringColor: "outline",
-		fillColor: "surface",
-		motion: "control"
-	} },
+	checkbox: {
+		options: {
+			size: 20,
+			boxColor: "surface",
+			borderRadius: 2,
+			focusRingGap: 2
+		},
+		variantOptions: SELECTION_ACCENTS
+	},
+	radio: {
+		options: {
+			size: 20,
+			ringColor: "outline",
+			fillColor: "surface",
+			motion: "control"
+		},
+		variantOptions: SELECTION_ACCENTS
+	},
 	dialog: { options: {
 		borderRadius: "lg",
 		color: "primary-surface",
@@ -1110,13 +1140,16 @@ var buildComponents = (c) => ({
 			activeSymbol: "check",
 			motion: "control"
 		},
-		variants: { warn: {
-			color: c.warn,
-			[HOVER_OR_KEYBOARD_FOCUS]: {
-				backgroundColor: c["warn-container"],
-				color: c["on-warn-container"]
+		variants: {
+			primary: {},
+			warn: {
+				color: c.warn,
+				[HOVER_OR_KEYBOARD_FOCUS]: {
+					backgroundColor: c["warn-container"],
+					color: c["on-warn-container"]
+				}
 			}
-		} }
+		}
 	},
 	popover: { options: {
 		color: "primary-surface",
@@ -1665,6 +1698,7 @@ var buildComponents = (c) => ({
 			knobColor: "surface",
 			motion: "control"
 		},
+		variantOptions: SELECTION_ACCENTS,
 		sizes: {
 			sm: {
 				width: 28,
@@ -2125,7 +2159,7 @@ var UniThemes = {
 Object.keys(UniThemes)[0];
 //#endregion
 //#region package.json
-var version = "10.1.0";
+var version = "10.2.0";
 //#endregion
 //#region schematics-src/ng-add/transforms.ts
 var addDependencies = (packageJsonText, deps) => {

package/types/uni-design-system-uni-angular.d.ts

@@ -1008,8 +1008,8 @@ declare class ThemeService {
     readonly theme: Signal<UniTheme>;
     /** Selectable themes, derived from the registry — reactive to registration. */
     readonly themeOptions: Signal<Options<string>>;
-    components: Signal<Partial<Record<ComponentName, ComponentTheme<object>>>>;
-    component: <T>(componentName: ComponentName) => Signal<ComponentTheme<T>>;
+    components: Signal<Partial<Record<ComponentName, ComponentTheme<object, object>>>>;
+    component: <T, V = object>(componentName: ComponentName) => Signal<ComponentTheme<T, V>>;
     colors: Signal<Partial<Record<string, string>>>;
     typeFaces: Signal<Record<string, _uni_design_system_uni_core.TypeFaceDefinition>>;
     spacing: Signal<_uni_design_system_uni_core.Spacing>;
@@ -1068,6 +1068,28 @@ declare class ThemeService {
     componentStyle: (componentName: ComponentName, variant: Variant, size: Size) => Signal<{
         [x: string]: string | number | _uni_design_system_uni_core.StyleExpression;
     }>;
+    /**
+     * The active variant's roles from a component's `variantOptions` map — the
+     * per-variant data a component *reads* rather than CSS it applies. See
+     * `ComponentTheme.variantOptions`.
+     */
+    variantRoles: <V>(componentName: ComponentName, variant: Variant) => Signal<V | undefined>;
+    private readonly warnedVariants;
+    /**
+     * Say something when a component is asked for a variant its theme does not
+     * define, once per component/variant pair.
+     *
+     * `Variant` is an open registry, so a name the theme never styled cannot be a
+     * compile error — and the miss is silent by construction, because an absent
+     * style spreads to nothing and an absent role falls back. That is exactly the
+     * ordinary state of a work in progress: a designer registers `destructive`,
+     * uses it, and has not written its theme block yet. Same reasoning as
+     * {@link resolveSpacing}, whose open scale has the same problem.
+     *
+     * A component that themes no variants at all is not missing anything — most
+     * of the library never varies by intent — so silence there is correct.
+     */
+    private warnUnthemedVariant;
     /**
      * Resolve a spacing token to its CSS value. `'none'` resolves through the
      * scale like any other token — it is `0`, not the string `'none'`, which is
@@ -1161,7 +1183,7 @@ declare class ThemeService {
     gap(gap: OptionalSize): NullableStyleExpression;
     zIndex(element: ZIndexableElements | undefined): NullableStyleExpression;
     borderColor(borderColor: ColorToken): NullableStyleExpression;
-    getComponentTheme<T>(componentName: ComponentName): Signal<ComponentTheme<T>>;
+    getComponentTheme<T, V = object>(componentName: ComponentName): Signal<ComponentTheme<T, V>>;
     getComponentOptions: <T>(componentName: ComponentName) => _angular_core.WritableSignal<T>;
     componentOptions: (componentName: ComponentName) => Signal<unknown>;
     style(prop: string, value: string | number | undefined): NullableStyleExpression;
@@ -1177,20 +1199,44 @@ declare class ThemeService {
 
 declare const UNI_THEMES: InjectionToken<Record<string, UniTheme>>;
 
-declare class BaseComponent<T = unknown> {
+declare class BaseComponent<T = unknown, V = unknown> {
     protected componentName: ComponentName;
     theme: ThemeService;
-    variant: _angular_core.InputSignal<Variant>;
+    variant: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     size: _angular_core.InputSignal<Size>;
-    componentTheme: _angular_core.Signal<_uni_design_system_uni_core.ComponentTheme<T>>;
+    componentTheme: _angular_core.Signal<_uni_design_system_uni_core.ComponentTheme<T, V>>;
+    /**
+     * The active variant's roles from the theme's `variantOptions` map, for
+     * components whose accent lands on several interior elements and so cannot
+     * be expressed as a single applied style. Undefined when the theme does not
+     * define this variant — which also raises a dev warning.
+     */
+    variantRoles: _angular_core.Signal<V>;
     componentOptions: _angular_core.Signal<T>;
     style: _angular_core.Signal<{
         [x: string]: string | number | _uni_design_system_uni_core.StyleExpression;
     }>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BaseComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BaseComponent<any>, "ng-component", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BaseComponent<any, any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BaseComponent<any, any>, "ng-component", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * What a variant means for a checkbox, as theme data the component reads.
+ *
+ * The accent lands in five places — the box outline, the checked border, the
+ * checked and indeterminate fills, and the focus ring — so it cannot be a
+ * single applied style without naming interior classes in the theme. Naming
+ * the role instead keeps `.checkbox-box` and `.checkbox-check` private.
+ */
+interface UniCheckboxVariant {
+    /** Box outline, checked fill and focus ring. */
+    accent: ColorKey;
+    /**
+     * The tick and dash, which draw on top of the accent fill. Defaults to the
+     * accent's paired `on-` token; set it where no such pair exists.
+     */
+    onAccent?: ColorKey;
+}
 interface UniCheckboxOptions {
     size?: string | number;
     borderRadius?: string | number;
@@ -1199,7 +1245,7 @@ interface UniCheckboxOptions {
     focusRingGap?: string | number;
 }
 
-declare class UniCheckboxComponent extends BaseComponent<UniCheckboxOptions> implements FormCheckboxControl {
+declare class UniCheckboxComponent extends BaseComponent<UniCheckboxOptions, UniCheckboxVariant> implements FormCheckboxControl {
     readonly checked: _angular_core.ModelSignal<boolean>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly touched: _angular_core.ModelSignal<boolean>;
@@ -1207,6 +1253,13 @@ declare class UniCheckboxComponent extends BaseComponent<UniCheckboxOptions> imp
     readonly dirty: _angular_core.InputSignal<boolean>;
     /** Synced from required() validators by the Signal Forms [formField] directive. */
     readonly required: _angular_core.InputSignal<boolean>;
+    /**
+     * Accent colour token, overriding the variant's themed accent for one
+     * instance. Mirrors `uni-toggle`'s input of the same name — it exists because
+     * `variant` defaults to `'primary'`, so the component cannot tell "set to
+     * primary" from "not set".
+     */
+    readonly checkedColor: _angular_core.InputSignal<string>;
     /**
      * Id(s) of external element(s) describing this control — typically your
      * app-rendered error message — exposed as aria-describedby.
@@ -1223,11 +1276,22 @@ declare class UniCheckboxComponent extends BaseComponent<UniCheckboxOptions> imp
     handleChange(event: Event): void;
     protected readonly checkboxLabel: _angular_core.Signal<string>;
     protected readonly checkboxInput: _angular_core.Signal<string>;
-    getThemeColor(token: ColorToken): string;
-    /** The content color paired with a variant fill (on-primary, on-warn, …). */
-    getOnColor(variant: ColorToken): string;
+    /**
+     * The accent and its paired content colour, from the theme's variant roles.
+     *
+     * Previously the variant *name* was looked up as a colour token, which held
+     * together only because every variant happened to also be a colour. With the
+     * registry open that coincidence ends by design: `variant="destructive"`
+     * would have missed and silently rendered primary. The theme now says which
+     * colour draws the intent, and an unthemed variant warns rather than lying.
+     *
+     * `primary` is the last resort because it is a reserved variant name — the
+     * default every component inherits.
+     */
+    private readonly accent;
+    protected readonly boxColor: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UniCheckboxComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UniCheckboxComponent, "uni-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "dirty": { "alias": "dirty"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "touched": "touchedChange"; "indeterminate": "indeterminateChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UniCheckboxComponent, "uni-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "dirty": { "alias": "dirty"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "checkedColor": { "alias": "checkedColor"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "touched": "touchedChange"; "indeterminate": "indeterminateChange"; }, never, never, true, never>;
 }
 
 /** A commit was refused (no match); the field reverted to the committed label. */
@@ -1834,7 +1898,7 @@ declare class UniGridDirective extends UniBoxDirective {
     templateColumns: _angular_core.InputSignal<string>;
     templateRows: _angular_core.InputSignal<string>;
     outline: _angular_core.InputSignal<Thickness>;
-    outlineColor: _angular_core.InputSignal<Variant>;
+    outlineColor: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     protected readonly gridClassName: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UniGridDirective, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<UniGridDirective, "[uni-grid-layout], [grid-layout]", never, { "display": { "alias": "display"; "required": false; "isSignal": true; }; "templateAreas": { "alias": "templateAreas"; "required": false; "isSignal": true; }; "templateColumns": { "alias": "templateColumns"; "required": false; "isSignal": true; }; "templateRows": { "alias": "templateRows"; "required": false; "isSignal": true; }; "outline": { "alias": "outline"; "required": false; "isSignal": true; }; "outlineColor": { "alias": "outlineColor"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -1989,6 +2053,14 @@ interface UniRadioOption {
      */
     disabled?: boolean;
 }
+/**
+ * What a variant means for a radio, as theme data the component reads. The
+ * accent lands on the dot, the hover and checked rings, and the focus ring.
+ */
+interface UniRadioVariant {
+    /** Dot fill, checked/hover ring and focus ring. */
+    accent: ColorKey;
+}
 interface UniRadioOptions {
     /**
      * The size of the radio buttons
@@ -2003,7 +2075,7 @@ interface UniRadioOptions {
     motion?: Motion;
 }
 
-declare class UniRadioComponent extends BaseComponent<UniRadioOptions> implements FormValueControl<string> {
+declare class UniRadioComponent extends BaseComponent<UniRadioOptions, UniRadioVariant> implements FormValueControl<string> {
     readonly value: _angular_core.ModelSignal<string>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly touched: _angular_core.ModelSignal<boolean>;
@@ -2011,6 +2083,12 @@ declare class UniRadioComponent extends BaseComponent<UniRadioOptions> implement
     readonly dirty: _angular_core.InputSignal<boolean>;
     /** Synced from required() validators by the Signal Forms [formField] directive. */
     readonly required: _angular_core.InputSignal<boolean>;
+    /**
+     * Accent colour token, overriding the variant's themed accent for one
+     * instance. Mirrors the input of the same name on `uni-checkbox` and
+     * `uni-toggle`.
+     */
+    readonly checkedColor: _angular_core.InputSignal<string>;
     /**
      * Id(s) of external element(s) describing this control — typically your
      * app-rendered error message — exposed as aria-describedby.
@@ -2028,9 +2106,20 @@ declare class UniRadioComponent extends BaseComponent<UniRadioOptions> implement
     protected readonly radioOptionClass: _angular_core.Signal<string>;
     protected readonly radioInputClass: _angular_core.Signal<string>;
     handleRadioChange(optionValue: string): void;
-    getThemeColor(token: ColorToken): string;
+    /**
+     * The accent colour, from the theme's variant roles rather than by treating
+     * the variant name as a colour token — see `uni-checkbox` for why that had
+     * to stop. `primary` is the last resort: a reserved variant name.
+     */
+    /**
+     * A chrome colour by token. Unlike the `getThemeColor` this replaces, there
+     * is no silent fallback to primary: these are tokens the theme is required
+     * to define, so a miss should be visible rather than disguised.
+     */
+    private color;
+    private readonly accent;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UniRadioComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UniRadioComponent, "uni-radio", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "dirty": { "alias": "dirty"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touched": "touchedChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UniRadioComponent, "uni-radio", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "dirty": { "alias": "dirty"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "checkedColor": { "alias": "checkedColor"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touched": "touchedChange"; }, never, never, true, never>;
 }
 
 /**
@@ -2290,7 +2379,7 @@ declare class UniSliderComponent extends BaseComponent<UniSliderOptions> impleme
     formatValue: _angular_core.InputSignal<(value: number) => string>;
     /** Enforced distance between the two ends, in range mode. */
     minGap: _angular_core.InputSignal<number>;
-    variant: _angular_core.InputSignal<Variant>;
+    variant: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     /** Continuous, during a drag or a held key. Bind this for a live preview. */
     sliding: _angular_core.OutputEmitterRef<number | UniNumberRange>;
     /**
@@ -3083,7 +3172,7 @@ declare class UniTagInputComponent extends BaseComponent<UniTagInputOptions> imp
     max: _angular_core.InputSignal<number>;
     validate: _angular_core.InputSignal<(raw: string) => boolean>;
     parse: _angular_core.InputSignal<(pasted: string) => string[]>;
-    tagVariant: _angular_core.InputSignal<Variant>;
+    tagVariant: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     tagTone: _angular_core.InputSignal<TagTone>;
     tagSize: _angular_core.InputSignal<Size>;
     suggestions: _angular_core.InputSignal<UniTagSuggestion[]>;
@@ -3338,6 +3427,14 @@ declare class UniTimeInputComponent extends BaseComponent<UniTimeInputOptions> i
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<UniTimeInputComponent, "uni-time-input, TimeInput", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "dirty": { "alias": "dirty"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "slots": { "alias": "slots"; "required": false; "isSignal": true; }; "hour12": { "alias": "hour12"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "commitOnBlur": { "alias": "commitOnBlur"; "required": false; "isSignal": true; }; "embedded": { "alias": "embedded"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touched": "touchedChange"; "rejected": "rejected"; }, never, never, true, never>;
 }
 
+/**
+ * What a variant means for a toggle, as theme data the component reads. The
+ * accent fills the checked track and colours the focus ring.
+ */
+interface UniToggleVariant {
+    /** Checked track fill and focus ring. */
+    accent: ColorKey;
+}
 interface UniToggleOptions {
     /**
      * @deprecated Track height in px, from before the toggle had a `sizes` block.
@@ -3362,7 +3459,7 @@ interface UniToggleOptions {
     motion?: Motion;
 }
 
-declare class UniToggleComponent extends BaseComponent<UniToggleOptions> implements FormCheckboxControl {
+declare class UniToggleComponent extends BaseComponent<UniToggleOptions, UniToggleVariant> implements FormCheckboxControl {
     readonly checked: _angular_core.ModelSignal<boolean>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly touched: _angular_core.ModelSignal<boolean>;
@@ -3398,13 +3495,23 @@ declare class UniToggleComponent extends BaseComponent<UniToggleOptions> impleme
      * treats its size block the same way.
      */
     private readonly metrics;
-    /** The resolved checked/accent color: input, then theme option, then variant. */
+    /**
+     * The resolved checked/accent color: the per-instance input, then the
+     * variant's themed accent, then the theme option.
+     *
+     * The last link used to be `this.variant()` — the variant *name* resolved as
+     * a colour token. That only ever worked because every variant happened to
+     * also be a colour; with the registry open, `variant="destructive"` would
+     * have missed and silently rendered primary. `primary` is the last resort
+     * because it is a reserved variant name.
+     */
     private readonly accent;
     /** Knob slide and track color change, as a motion token — never `all`. */
     private readonly transitions;
     protected readonly toggleLabel: _angular_core.Signal<string>;
     protected readonly toggleInput: _angular_core.Signal<string>;
-    getThemeColor(token: ColorToken): string;
+    /** A chrome colour by token — no silent fallback; see `uni-radio`. */
+    private color;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UniToggleComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<UniToggleComponent, "uni-toggle", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "dirty": { "alias": "dirty"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "checkedColor": { "alias": "checkedColor"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "touched": "touchedChange"; }, never, never, true, never>;
 }
@@ -3529,7 +3636,7 @@ interface UniBadgeOptions {
 }
 
 declare class UniBadgeComponent extends BaseComponent<UniBadgeOptions> {
-    color: _angular_core.InputSignal<Variant>;
+    color: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     useVariant: _angular_core.InputSignal<boolean>;
     width: _angular_core.InputSignal<number>;
     protected readonly className: _angular_core.Signal<string>;
@@ -3766,7 +3873,7 @@ declare class UniCalendarComponent extends BaseComponent<UniCalendarOptions> imp
     protected readonly outsideDayClass: _angular_core.Signal<string>;
     protected readonly dotsClass: _angular_core.Signal<string>;
     /** One dot class per marker variant present, resolved from the palette. */
-    protected readonly dotClasses: _angular_core.Signal<Map<Variant, string>>;
+    protected readonly dotClasses: _angular_core.Signal<Map<keyof _uni_design_system_uni_core.UniVariantRegistry, string>>;
     protected dotClassFor(variant: Variant | undefined): string;
     protected readonly showOutside: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UniCalendarComponent, never>;
@@ -4068,16 +4175,16 @@ interface UniDialogButtonsOptions {
 declare class UniDialogButtonsComponent extends BaseComponent<UniDialogButtonsOptions> {
     private dialog;
     confirmButtonText: _angular_core.InputSignal<string>;
-    confirmButtonVariant: _angular_core.InputSignal<Variant>;
+    confirmButtonVariant: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     cancelButtonText: _angular_core.InputSignal<string>;
-    cancelButtonVariant: _angular_core.InputSignal<Variant>;
+    cancelButtonVariant: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     disableConfirm: _angular_core.InputSignal<boolean>;
     padding: _angular_core.InputSignal<NullableSize>;
     paddingBottom: _angular_core.InputSignal<NullableSize>;
     justifyContent: _angular_core.InputSignal<JustifyContent>;
     confirmed: _angular_core.OutputEmitterRef<void>;
-    protected confirmVariant: _angular_core.Signal<Variant>;
-    protected cancelVariant: _angular_core.Signal<Variant>;
+    protected confirmVariant: _angular_core.Signal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
+    protected cancelVariant: _angular_core.Signal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     protected paddingValue: _angular_core.Signal<NullableSize>;
     protected paddingBottomValue: _angular_core.Signal<NullableSize>;
     protected justifyContentValue: _angular_core.Signal<JustifyContent>;
@@ -4207,15 +4314,15 @@ interface UniDrawerButtonsOptions {
 declare class UniDrawerButtonsComponent extends BaseComponent<UniDrawerButtonsOptions> {
     private readonly drawer;
     confirmButtonText: _angular_core.InputSignal<string>;
-    confirmButtonVariant: _angular_core.InputSignal<Variant>;
+    confirmButtonVariant: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     cancelButtonText: _angular_core.InputSignal<string>;
-    cancelButtonVariant: _angular_core.InputSignal<Variant>;
+    cancelButtonVariant: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     disableConfirm: _angular_core.InputSignal<boolean>;
     padding: _angular_core.InputSignal<NullableSize>;
     justifyContent: _angular_core.InputSignal<JustifyContent>;
     confirmed: _angular_core.OutputEmitterRef<void>;
-    protected confirmVariant: _angular_core.Signal<Variant>;
-    protected cancelVariant: _angular_core.Signal<Variant>;
+    protected confirmVariant: _angular_core.Signal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
+    protected cancelVariant: _angular_core.Signal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     protected paddingValue: _angular_core.Signal<NullableSize>;
     protected justifyContentValue: _angular_core.Signal<JustifyContent>;
     protected gapValue: _angular_core.Signal<NullableSize>;
@@ -4670,7 +4777,7 @@ declare class UniFileDropZoneComponent {
     get fileSelectorElement(): HTMLInputElement;
     height: _angular_core.InputSignal<string | number>;
     borderRadius: _angular_core.InputSignal<string>;
-    border: _angular_core.InputSignal<Variant>;
+    border: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     padding: _angular_core.InputSignal<NullableSize>;
     useBrowseButton: _angular_core.InputSignal<boolean>;
     browseButtonText: _angular_core.InputSignal<string>;
@@ -4819,7 +4926,7 @@ declare class UniIconButtonComponent {
     private theme;
     config: _angular_core.Signal<_uni_design_system_uni_core.ComponentTheme<{
         borderRadius?: RadiiSize;
-    }>>;
+    }, object>>;
     /**
      * Accessible name for the button. Alternative to projecting text content
      * (`<button icon-button>Close</button>`); one of the two is required for
@@ -4828,7 +4935,7 @@ declare class UniIconButtonComponent {
     ariaLabel: _angular_core.InputSignal<string>;
     iconName: _angular_core.InputSignal<IconName>;
     symbolName: _angular_core.InputSignal<string>;
-    variant: _angular_core.InputSignal<Variant>;
+    variant: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     size: _angular_core.InputSignal<Size>;
     disable: _angular_core.InputSignal<boolean>;
     loading: _angular_core.InputSignal<boolean>;
@@ -4962,7 +5069,7 @@ declare class UniNotificationBadgeComponent extends BaseComponent<UniNotificatio
     count: _angular_core.InputSignal<number>;
     maxCount: _angular_core.InputSignal<number>;
     badgeVariant: _angular_core.InputSignal<"dot" | "count" | "pill">;
-    color: _angular_core.InputSignal<Variant>;
+    color: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     position: _angular_core.InputSignal<"top-right" | "top-left" | "bottom-right" | "bottom-left">;
     show: _angular_core.InputSignal<boolean>;
     /**
@@ -5307,7 +5414,7 @@ declare class UniScrollAreaComponent {
     paddingRight: _angular_core.InputSignal<OptionalSize>;
     paddingTop: _angular_core.InputSignal<OptionalSize>;
     paddingBottom: _angular_core.InputSignal<OptionalSize>;
-    border: _angular_core.InputSignal<Variant>;
+    border: _angular_core.InputSignal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     height: _angular_core.InputSignal<OptionalValue>;
     width: _angular_core.InputSignal<OptionalValue>;
     appearance: _angular_core.InputSignal<ScrollbarAppearance>;
@@ -5629,7 +5736,7 @@ declare class UniTagComponent extends BaseComponent<UniTagOptions> {
     removed: _angular_core.OutputEmitterRef<UniTagValue>;
     activated: _angular_core.OutputEmitterRef<UniTagValue>;
     /** A disabled chip wears the theme's `disabled` role, whatever its variant. */
-    protected readonly resolvedVariant: _angular_core.Signal<_uni_design_system_uni_core.Variant>;
+    protected readonly resolvedVariant: _angular_core.Signal<keyof _uni_design_system_uni_core.UniVariantRegistry>;
     protected readonly themeStyle: _angular_core.Signal<{
         [x: string]: string | number | _uni_design_system_uni_core.StyleExpression;
     }>;
@@ -5659,7 +5766,7 @@ declare class UniThemeBuilderComponent {
     protected readonly schemes: ColorScheme[];
     protected readonly categories: ColorCategory[];
     protected readonly shapes: ThemeShape[];
-    protected readonly variants: Variant[];
+    protected readonly variants: (keyof _uni_design_system_uni_core.UniVariantRegistry)[];
     protected readonly sizes: readonly ["sm", "md", "lg", "xl"];
     protected readonly swatches: {
         label: string;
@@ -5922,4 +6029,4 @@ declare class DragAndDropDirective {
 }
 
 export { BodyRenderDirective, ConfirmationDialogComponent, DRAWER_PANEL, DragAndDropDirective, FOCUSABLE_SELECTOR, ListboxNavigation, LocalStorageService, NotificationService, NotificationsComponent, RippleDirective, TRANSFORM_ORIGINS, ThemeService, UNI_FORMS, UNI_LAYOUT, UNI_THEMES, UniAlertComponent, UniAppBarComponent, UniAvatarComponent, UniAvatarGroupComponent, UniBackgroundComponent, UniBadgeComponent, UniBaseDatasource, UniBoxDirective, UniBreadcrumbComponent, UniButtonComponent, UniButtonGroupComponent, UniCalendarComponent, UniCalloutComponent, UniCardComponent, UniCardContentComponent, UniCardHeaderComponent, UniCenterDirective, UniCheckboxComponent, UniComboboxComponent, UniDataSearchComponent, UniDataTableComponent, UniDateInputComponent, UniDateTimeInputComponent, UniDebounceInputComponent, UniDialogButtonsComponent, UniDialogComponent, UniDialogHeaderComponent, UniDividerComponent, UniDrawerButtonsComponent, UniDrawerComponent, UniDrawerHeaderComponent, UniDropdownComponent, UniExpandAreaComponent, UniExpandComponent, UniExpandToggleComponent, UniFileDropZoneComponent, UniGridAreaDirective, UniGridDirective, UniIconButtonComponent, UniIconComponent, UniInputBoxComponent, UniInputComponent, UniJsonViewComponent, UniMenuComponent, UniMultiSelectComponent, UniMultiSelectDropdownComponent, UniNotificationBadgeComponent, UniNumberInputComponent, UniNumberRangeInputComponent, UniPaginatorComponent, UniPopoverComponent, UniProgressBarComponent, UniProgressGaugeComponent, UniQuantityStepperComponent, UniRadioComponent, UniRecordDatasource, UniRowDirective, UniScrollAreaComponent, UniSearchInputComponent, UniSelectComponent, UniServerSideDatasource, UniSkeletonComponent, UniSliderComponent, UniSnackbarComponent, UniSortHeaderComponent, UniStackDirective, UniStatComponent, UniSymbolComponent, UniTabComponent, UniTabsComponent, UniTagComponent, UniTagInputComponent, UniTextDirective, UniTextareaComponent, UniThemeBuilderComponent, UniThemeSwitchComponent, UniTimeInputComponent, UniToggleComponent, UniTooltipComponent, UniTourComponent, UniWrapDirective, acceptableFile, addDays, addMonths, anchorArrowStyles, anchorStyles, buildMonthGrid, clampDecimal, clearAnchorName, compareDecimal, createAnnouncer, createListboxNavigation, createPressRepeat, dayOfWeek, daysInMonth, decimalScale, discreteOverlayTransition, evaluateExpression, focusableElements, formatDate, formatMonthHeading, formatNumber, formatTime, fromScaled, getFileExtension, inclusiveDayCount, isCanonicalDecimal, isDivider, isToggleOpen, isValidDate, isoDate, joinDateTime, listboxPopupAttr, listboxPopupStyles, localeDatePlaceholder, localeDefaultHour12, localeFieldOrder, localeMonthNames, localeNumberParts, localeWeekStart, losesPrecision, monthOf, motionSafe, newAnchorName, newListboxAnchor, normalizeDecimal, parseDateText, parseNumber, parseTimeText, promoteListboxPopup, rawNumberText, resolveElement, resolveFocusTarget, resolveNumberFormat, restoreOverlayFocus, roundDecimal, setAnchorName, settleNumber, shiftDecimal, speakNumber, splitDateTime, spotlightStyles, stepDecimal, supportsAnchoredPopup, timeSlots, toAsciiDigits, toDecimal, toNumber, toScaled, todayIso, transformOriginFor, uniqueId, useTimer, visuallyHidden, weekdayNames };
-export type { Alert, AnchorOffset, AnchorRect, Announcer, BrandPaletteConfig, BreadcrumbItem, ButtonGroupConfig, ButtonGroupItem, ColumnDefinition, Confirmation, DataLoader, DrawerBackground, DrawerCloseReason, DrawerMode, DrawerPosition, ImagePosition, ListboxNavigationConfig, MenuDivider, MenuItem, MenuItemWithLabel, MenuItemWithTemplate, Option, Options, PageRequest, PageResponse, Placement, PressRepeat, PressRepeatConfig, PressRepeatTiming, ScrollbarAppearance, SkeletonShape, SkeletonSweepDirection, Snackbar, Sort, SortDirection, SpotlightOptions, SpotlightStyles, UniAppBarOptions, UniAvatarGroupOptions, UniAvatarOptions, UniBreadcrumbOptions, UniCalendarMarker, UniCalendarMode, UniCalendarOptions, UniCalendarValue, UniCalloutDismissal, UniCalloutOptions, UniCheckboxOptions, UniComboboxOptions, UniComboboxRejection, UniDataSearchOptions, UniDataTableOptions, UniDatasource, UniDate, UniDateInputOptions, UniDateInputRejection, UniDateRange, UniDateTime, UniDateTimeInputOptions, UniDrawerButtonsOptions, UniDrawerCloseRequest, UniDrawerHeaderOptions, UniDrawerOptions, UniDrawerPanel, UniExpandOptions, UniInputBoxOptions, UniInputMode, UniInputType, UniListboxPopupOptions, UniLocaleNumberParts, UniMenuItemOptions, UniMenuOptions, UniMonthGridCell, UniMultiSelectDropdownOptions, UniNotificationBadgeOptions, UniNumberClamp, UniNumberFormatConfig, UniNumberGrouping, UniNumberInputOptions, UniNumberParseResult, UniNumberPreset, UniNumberRange, UniNumberRangeInputOptions, UniNumberRangePart, UniNumberRangeRejection, UniNumberRejectReason, UniNumberRejection, UniNumberStepConfig, UniNumberStepped, UniPaginatorOptions, UniPopoverOptions, UniQuantityStepperOptions, UniRadioOption, UniRadioOptions, UniResolvedNumberFormat, UniRoundingMode, UniSearchInputOptions, UniSkeletonOptions, UniSliderMark, UniSliderOptions, UniSliderThumb, UniStatOptions, UniStepperLayout, UniTabsOptions, UniTagInputOptions, UniTagItem, UniTagOptions, UniTagRejection, UniTagSuggestion, UniTagValue, UniTextareaOptions, UniTime, UniTimeInputOptions, UniTimeInputRejection, UniToggleOptions, UniTourAdvance, UniTourOptions, UniTourStep, UniWeekdayName };
+export type { Alert, AnchorOffset, AnchorRect, Announcer, BrandPaletteConfig, BreadcrumbItem, ButtonGroupConfig, ButtonGroupItem, ColumnDefinition, Confirmation, DataLoader, DrawerBackground, DrawerCloseReason, DrawerMode, DrawerPosition, ImagePosition, ListboxNavigationConfig, MenuDivider, MenuItem, MenuItemWithLabel, MenuItemWithTemplate, Option, Options, PageRequest, PageResponse, Placement, PressRepeat, PressRepeatConfig, PressRepeatTiming, ScrollbarAppearance, SkeletonShape, SkeletonSweepDirection, Snackbar, Sort, SortDirection, SpotlightOptions, SpotlightStyles, UniAppBarOptions, UniAvatarGroupOptions, UniAvatarOptions, UniBreadcrumbOptions, UniCalendarMarker, UniCalendarMode, UniCalendarOptions, UniCalendarValue, UniCalloutDismissal, UniCalloutOptions, UniCheckboxOptions, UniCheckboxVariant, UniComboboxOptions, UniComboboxRejection, UniDataSearchOptions, UniDataTableOptions, UniDatasource, UniDate, UniDateInputOptions, UniDateInputRejection, UniDateRange, UniDateTime, UniDateTimeInputOptions, UniDrawerButtonsOptions, UniDrawerCloseRequest, UniDrawerHeaderOptions, UniDrawerOptions, UniDrawerPanel, UniExpandOptions, UniInputBoxOptions, UniInputMode, UniInputType, UniListboxPopupOptions, UniLocaleNumberParts, UniMenuItemOptions, UniMenuOptions, UniMonthGridCell, UniMultiSelectDropdownOptions, UniNotificationBadgeOptions, UniNumberClamp, UniNumberFormatConfig, UniNumberGrouping, UniNumberInputOptions, UniNumberParseResult, UniNumberPreset, UniNumberRange, UniNumberRangeInputOptions, UniNumberRangePart, UniNumberRangeRejection, UniNumberRejectReason, UniNumberRejection, UniNumberStepConfig, UniNumberStepped, UniPaginatorOptions, UniPopoverOptions, UniQuantityStepperOptions, UniRadioOption, UniRadioOptions, UniRadioVariant, UniResolvedNumberFormat, UniRoundingMode, UniSearchInputOptions, UniSkeletonOptions, UniSliderMark, UniSliderOptions, UniSliderThumb, UniStatOptions, UniStepperLayout, UniTabsOptions, UniTagInputOptions, UniTagItem, UniTagOptions, UniTagRejection, UniTagSuggestion, UniTagValue, UniTextareaOptions, UniTime, UniTimeInputOptions, UniTimeInputRejection, UniToggleOptions, UniToggleVariant, UniTourAdvance, UniTourOptions, UniTourStep, UniWeekdayName };