segue
Documentation

Documentation

Glossary

Definitions of the domain language used throughout Segue's documentation.

These terms have narrower meanings in Segue than they might have in general writing.

Route Transition

The visual handoff that runs before Next.js navigation starts. It does not own the destination's entrance animation.

Route-Transition Preset

A reusable Route Transition assigned to a destination path. It defines the standard outgoing animation for navigation to that destination.

Cover

Pre-commit animation that places transition visuals over the outgoing route before navigation proceeds. A failed or stalled Cover must not indefinitely defer navigation.

Route-Transition Override

Consumer choreography supplied by one initiating navigation instead of the destination's Route-Transition Preset. It is a callback, not Segue-managed DOM, and can decline or fail so that the destination's Preset runs.

Destination Entrance

Animation owned by the destination after navigation commits. A destination can adapt its entrance based on how navigation arrived, but the Route Transition does not render or control it.

Route-Transition Entry

The selected handoff by which a destination was reached: a Route-Transition Preset, a Route-Transition Override, or none. It does not report whether animation completed successfully.

Pending Destination

The normalized destination path during coordinated navigation.

Route Commit Pending

The period after outgoing work finishes and while the tracked Next.js navigation remains unsettled.

Transition Image

An image prepared for a Route-Transition Preset or Route-Transition Override. Transition Images can come from the source, destination, or surrounding interaction.

Image Warming

Best-effort preparation of Transition Images before navigation. Image Warming never delays navigation or the start of a Route Transition.

Image Asset

A source image identified by a stable content ID. An Image Asset can produce multiple Image Renditions.

Image Rendition

A project-defined representation of an Image Asset for a named sizing and transformation profile. An explicit Image Reference selects the profile; rendition data can describe responsive candidates for a renderer or browser.

Image Reference

The stable Image Asset ID and profile pair that selects one Image Rendition.

Outgoing Ownership

The period in which a selected Route-Transition Preset or accepted Route-Transition Override owns temporary visual state. It begins immediately before Override invocation or a Preset run and ends when navigation settles or is abandoned; it does not include Destination Entrance.

initial