# Agent Orb Variants

> Animated Agent Orb variants for React and shadcn, in three styles: Ring, Aurora and Dots.

Three Pro painters for Agent Orb: a hollow Ring that frames an avatar, an Aurora whose curtains fold instead of spin, and a Dots lattice that ripples outward. Each runs on the orb's clock, so speed follows the token rate.

- Tier: Eased Pro
- Interaction: Loading
- Page: https://eased.dev/components/orb-variants
- Installs: motion

## Install

Agent Orb Variants ships with Eased Pro (https://eased.dev/#pricing). Members add the `@eased-pro` registry with their token (https://eased.dev/account), then run:

```bash
npx shadcn add @eased-pro/orb-variants
```

Three Pro painters for [Agent Orb](/components/agent-orb): Ring, Aurora and Dots. Each is an `OrbVariant`, so the orb still owns the clock, the state palette, the token-rate speed, the off-screen pause and reduced motion; a variant only draws.

## When to use

- An assistant's presence needs a different character than the free orb: Ring frames an avatar or icon, Aurora reads calm and atmospheric, Dots reads technical.
- Voice and agent UIs that already use Agent Orb and want a second look without new state wiring.

## When not to use

- Inline text status (a 16px orb next to a label): the free orb reads best that small. Dots needs at least 32px to show its lattice.

## Usage

```tsx example.tsx
import { AgentOrb } from "@/components/eased/agent-orb/agent-orb";
import { RingOrb } from "@/components/eased/orb-variants/orb-variants";
import { useTokenRate } from "@/components/eased/_primitives/thinking-core/thinking-core";

const { rate } = useTokenRate(message.text);
<AgentOrb variant={RingOrb} state="speaking" rate={rate} size={72} />
```

## API reference

### RingOrb, AuroraOrb, DotsOrb

Components of type `OrbVariant`, passed as Agent Orb's `variant`. They take `{ size, state, phase, energy, reduced }` from the orb; you never render them directly. `ORB_VARIANTS` maps `ring`, `aurora` and `dots` to them for pickers.

Re-theme with `--eased-orb-a`, `--eased-orb-b`, `--eased-orb-c` and `--eased-orb-deep` on `.eased-orb[data-state="…"]`, exactly as for the free orb.

## Accessibility

- The orb owns the role (`img`) and the name; variants are `aria-hidden` paint.

## Motion

Ring: a conic band turns at 70°/s while a brighter comet laps it at −150°/s, and the band thickens from 8% to 15% of the diameter with energy. Aurora: four tall curtains sway and shear on their own pairs of frequencies, so the light folds rather than spins; energy widens the sway. Dots: a ripple travels outward through a hex lattice, swelling each dot as it passes, with radii written straight to the SVG from the clock (no re-renders). All three breathe 1 → 1.05 with energy, follow the orb's speed (0.4× idle to 2× speaking), pause off-screen and draw a still frame under reduced motion.

## Notes for AI

Pick a variant by character, then pass it as `variant`; feed `rate` from `useTokenRate` and `level` from an `AnalyserNode` exactly as for the free orb.

Do not render a variant without Agent Orb, and do not animate it yourself: the orb's clock already eases speed and energy.

## Related

- [Agent Orb](/components/agent-orb): the free orb and the clock these run on.
