Function pulseVariable

pulseVariable(
    startBeat: number,
    peakBeat: number,
    endBeat: number,
    peak?: number | number[],
    easingIn?: number,
    easingOut?: number,
    options?: VariableEventOptions,
): AnimatedVariable
Create a "pulse" animated variable: ramps from 0 to peak then back to 0.

Shorthand for a common shockwave / flash pattern.
Parameters
- startBeat: number
  Beat where the ramp-up begins.
- peakBeat: number
  Beat where the value reaches its maximum.
- endBeat: number
  Beat where the value returns to 0.
- peak: number | number[] = 1
  Peak value (default: 1). Accepts a scalar or vector.
- easingIn: number = 2
  Easing for the ramp-up phase (default: 2).
- easingOut: number = 2
  Easing for the ramp-down phase (default: 2).
- options: VariableEventOptions = {}
Returns AnimatedVariable
An AnimatedVariable with two events.
Example
```
// Short shockwave pulse: 0 → 1 → 0 between beats 0, 0.5, 2
const pulse = pulseVariable(0, 0.5, 2, 1, 'cubicOut', 'cubicIn');
```
- Defined in extra.ts:454