Interface

UseTimelineExternalClipDropResult

Result returned by `useTimelineExternalClipDrop`.

Usage notes

Use `rootProps` on the drop surface, then render the feedback fields in timeline chrome such as target-row highlighting, invalid-drop messages, or a preview badge. `lastResult` keeps the last command outcome available after hover feedback clears.

Signature

Type Definition
Interface UseTimelineExternalClipDropResult

Type parameters

NameConstraintDefaultDescription
TrackKindNonestringApp-defined track kind values carried by the current target track.

Properties

NameSignatureDescription
clearDropFeedback(): voidClears current hover feedback while preserving the last result.
draggingdragging: booleanWhether an external drag is currently over the drop surface.
dropSecondsdropSeconds: number | nullTimeline seconds under the pointer, when a track is resolved.
dropTimedropTime: RationalTime | nullTimeline time under the pointer, when a track is resolved.
hoveredTrackIdhoveredTrackId: string | nullTrack currently under the pointer, including invalid targets.
lastResultlastResult: TimelineCommandResult<TimelineEditCommitResult> | nullLast committed or rejected drop result.
reasonreason: TimelineCommandFailureReason | nullMachine-readable reason for invalid feedback.
rootPropsrootProps: TimelineExternalClipDropRootPropsProps for the element that should accept native external drops.
targetTracktargetTrack: Track<TrackKind> | nullValid target track currently accepting the payload.
targetTrackIdtargetTrackId: string | nullValid target track id currently accepting the payload.
validvalid: booleanWhether the current external payload can be dropped.