Nudge

Shift a landed reel up or down by N positions to reveal caller-supplied symbols. one primitive, with pacing and control variants below.

Nudge a reel#

Shift one reel after it lands; incoming is the final visible order, top-down. Below: the base nudge, then the same row of wilds dropped sequentially (three beats) vs in parallel (one beat).

Staggered nudge. wave reveal#

Promise.all with a per-reel startDelay fires every reel’s tween concurrently for a wave reveal. validation still throws synchronously.

Spotlight after a nudge#

Land a near-miss, parallel-nudge three reels to complete a wild line, then run SymbolSpotlight on the new winners.

Nudge through a big symbol#

A 1xH block on the target reel is nudged through as a unit; the second demo drags a tail-visible block fully into view.

Gotcha: only single-reel (size.reels === 1) blocks can be nudged. cross-reel blocks throw.

Nudge a horizontal set#

On .orientation('horizontal') a reel is a screen row, so a nudge shifts it sideways. One press nudges row 0 'forward' (a wild enters at the left edge) and row 2 'reverse' (a wild enters at the right).

Gotcha: incoming is start-to-end order, which reads left-to-right here, not top-down.

Nudge on a roll-up set#

Two wilds land on the middle line and the third stops one cell below it; a 'forward' nudge on a .direction('reverse') reel travels upward and rolls it onto the line, which then spotlights.

Gotcha: direction is relative to the reel’s own axis, so 'forward' is up here and the incoming symbol arrives at the bottom cell.

Abort a nudge#

Cancel a running nudge via NudgeOptions.signal. the strip still snaps to landed, but nudge() rejects with AbortError and nudge:cancelled fires.

Skip an in-flight nudge#

reelSet.skipNudge(reel) fast-forwards a running nudge to its landed state; nudge() resolves normally, so the success path still runs.