@techsquidtv/canvas-timeline-core

Binary-searchable timeline snap target index.

The central orchestrator and coordinator for the high-performance timeline editor. Maintains state (tracks, clips, markers, playhead position, zoom scale, scrolls, snaps), builds dynamic snap indexes for magnetic snap guidance, handles split and edit actions, and publishes state events to trigger low-latency canvas renderings and lightweight React layouts.

Clip that is active at a timeline time, including its mapped source time.

Filters for selecting active clips at a timeline time.

Options for selecting active timeline layers at a timeline time. Use this when integrations need named layers such as `visuals`, `audio`, `subtitles`, or `effects` instead of one flat active-clip list. The same active clip can match more than one layer.

Active timeline layer lookup result. Results include every active clip matched by the requested selectors plus convenience `primary` entries for apps that only need the first match in each layer. Each `ActiveClip` includes mapped source time and source range data for preview and playback synchronization.

Represents an individual media clip node positioned at a specific timeline interval.

Payload emitted by `clip:created` for committed clip creation.

Transient edit-preview state attached to clips while an interaction is active. This state is not intended to be persisted with project data. UI layers can use it to render live editing affordances such as overwrite cut indicators.

Viewport-space pointer query for timeline clip hit testing.

Hit-test result for a clip pointer target.

Keyframe add/update event payload.

Keyframe removal event payload.

Keyframe selection change event payload.

Live clip movement event payload.

Event payload emitted when the playhead enters, updates within, or leaves a clip.

Payload emitted by `clip:removed` for committed clip removal.

Live clip resizing event payload.

Clip selection change event payload.

Live clip slip event payload.

Persistent snap settings for one clip.

Source-media interval covered by a timeline clip.

Payload emitted by `clip:split` for committed clip split.

Viewport-space rectangle for a clip and its containing track.

Central event mapping definition for all engine events.

Undo/redo history state change event payload.

Selection in/out point boundary change event payload.

Represents a bookmark or annotation pin on the timeline's top time ruler.

Marker change event payload (add, remove, update).

Persistent snap settings for one marker.

Options for starting timeline playback.

Controls which built-in timeline boundaries are indexed as magnetic snap targets.

Exact source-frame timestamp returned by a media integration.

App or media-player supplied exact source-frame resolver.

Transient feedback for a live cross-track clip drag.

Flattened clip metadata shared by core geometry APIs, React hooks, and custom renderers.

Serializable group of timeline clips edited as a linked unit.

One deterministic clip placement used when inserting an already-associated clip group.

Options for moving a clip in time and optionally into another track.

Result metadata for a committed or previewed clip move.

Clip entry with viewport geometry and editing/display state.

Options for creating a clip group from existing clips.

Command that deletes existing clips and any linked group members.

Command that removes a timeline range and ripples later clips closed by default.

Range of timeline content affected by an edit command.

Result returned after committing an edit command.

Describes how an active timeline edit affects one clip. This state is transient and is intended for headless UI affordances during live editing interactions. It is not part of the persisted project model.

Active live edit impacts for the current interaction. The model is operation-based so editing modes share the same headless React surface.

App-defined behavioral policy for timeline edit commands.

Context passed to product-defined edit policy callbacks.

Shared preview result produced for every edit command.

Result returned by command validation and policy callbacks.

Command that inserts grouped clips and pushes later clips forward per target track.

Options for inserting multiple clips and grouping them in one history entry. Inserted groups use the grouped insert command pipeline: the first placement may snap, the shared snap delta is applied to every placement, and later clips ripple forward per target track.

Command that inserts a new clip and pushes later clips forward.

Canvas-aligned geometry settings for clip hit testing and affordance placement.

One clip-scoped property keyframe positioned at an absolute timeline time.

Cubic Bezier tangent handle stored on one keyframe side.

Options for keyframe geometry and hit-testing.

Viewport-space pointer query for timeline keyframe hit testing.

Options for committing or previewing keyframe mutations.

Viewport-space point used by keyframe curve segments and handles.

Inputs for mapping a keyframe time/value pair into viewport space.

Definition for one scalar keyframe property registered with the engine.

Keyframe entry with viewport geometry and edit/display state.

Serializable keyframe geometry grouped by clip for canvas drawing.

Serializable keyframe geometry prepared by core for one property.

Options for preparing canvas-serializable keyframe render geometry.

Serializable keyframe point used by canvas drawing.

Serializable keyframe segment used by canvas drawing.

Keyframe segment entry with viewport geometry and optional Bezier tangents.

Options for keyframe segment and tangent geometry.

Interpolation data owned by one side of a keyframe.

Patch applied to one keyframe side.

Bezier tangent handle entry with viewport geometry and edit state.

Viewport-space rectangle for one keyframe tangent affordance.

Viewport-space pointer query for keyframe tangent handle hit testing.

Viewport-space rectangle for one keyframe affordance.

Command that removes a timeline range while leaving the gap in place.

Command that moves an existing clip.

Command that places grouped clips and overwrites overlaps per target track.

Command that places a new clip and removes or trims overlaps on the target track.

Clip placement command shared by insert and overwrite edits.

Command that trims one boundary and ripples later clips on the same track.

Command that rolls the shared boundary between two adjacent clips.

Viewport and density options for building shared headless timeline ruler ticks.

One viewport-space ruler tick for canvas, DOM, or custom rendering.

Input for creating or upserting a clip keyframe.

Command that moves an existing clip by a relative timeline offset.

Command that shifts an existing clip's source start without moving timeline bounds.

Transient snap feedback consumed by canvas rendering and focused hooks.

Context passed to runtime snap target providers.

Result of resolving a candidate time against the prepared snap index.

One timeline time that can attract an edited boundary.

Command that splits selected clips at one timeline time.

Represents the complete, serialized state model of the high performance timeline.

Options for building track viewport geometry.

Options for batching row-height updates with related viewport state.

Expanded row height update for a timeline track.

Hit-test result for a timeline track row.

Viewport-space rectangle for a timeline track row.

Command that trims one existing clip boundary.

Input for updating one existing clip keyframe.

Input for updating one side of an existing clip keyframe.

Input for updating one or both sides of an existing clip keyframe with explicit patches.

Engine-owned constraints for horizontal timeline zoom.

A horizontal timeline lane containing clips and editing state. Tracks are app-owned rows in the timeline model. The engine uses each track's stable id for editing operations, reads the ordered clip list for rendering and hit testing, and honors view/editing flags such as visible, collapsed, locked, and muted.

Track change event payload (add, remove).

Viewport-space pointer query for timeline track hit testing.

Track lock change event payload.

Track mute change event payload.

Track resize event payload.

Track selection change event payload.

Persistent snap settings for one track and its clips.

Track visibility change event payload.

Viewport-intersecting clip entry with clipped timeline and source-media ranges.

Options for building viewport-intersecting clip geometry.

Filters for one named active layer. A layer selector describes the kind of active clips an app wants to drive, such as visual previews, audio playback, subtitles, effects, or a particular source asset. Selectors are matched against the active clips returned for a single timeline time.

Reason a committed engine command created a new clip.

Region of a timeline clip hit by pointer interaction.

Reason a committed engine command removed a clip.

A value that may be available immediately or after asynchronous media lookup.

Clock responsible for advancing playback. Internal playback uses the engine's requestAnimationFrame loop. External playback lets a media player or audio clock drive playhead updates.

Options for building snap targets before a drag, trim, or range-boundary edit.

Source-frame lookup strategy for media integrations.

Reason a clip cannot currently be dropped on a track.

Options for building all clip viewport geometry.

First-class edit command accepted by TimelineEngine edit APIs.

Consequence of an active edit for an affected clip.

Current tool or intent family selected by product editor chrome.

Editing operation that can produce live edit impacts.

Machine-readable reason an edit command cannot be resolved or committed.

Hit-test result for a timeline keyframe pointer target.

Segment interpolation mode used from one keyframe to the next.

App-defined scalar property id that can be animated with timeline keyframes.

Side of a keyframe that controls an adjacent segment.

Hit-test result for a keyframe tangent handle pointer target.

Immutable scalar keyframe property definition stored by the engine registry.

Display format and frame-rate requirements for a timeline ruler.

Ruler tick visual weight.

Options for building shared headless timeline ruler ticks.

Timeline interaction currently preparing or resolving snap targets.

Runtime source of app-defined snap targets such as grids, beats, and captions.

Built-in and application-defined magnetic snap target categories.

Viewport-intersecting keyframe entry.

Viewport-intersecting keyframe segment.

Default incoming tangent used when a Bezier keyframe side omits its handle.

Geometry defaults shared by canvas-aligned interaction layers.

Default zoom-in density when a frame rate constrains timeline zoom.

Default outgoing tangent used when a Bezier keyframe side omits its handle.

Creates a scalar keyframe property definition from a numeric range.

Returns viewport-space cubic Bezier control points between two keyframe points.

Evaluates a Cubic Bezier segment curve at normalized time progress.

Evaluates normalized segment progress for a keyframe interpolation mode.

Maps one keyframe value to the same viewport point used by canvas drawing and DOM handles.

Builds shared viewport-space ruler ticks for canvas, DOM, and custom renderers.

Validates and clamps one Bezier tangent handle to the timeline interpolation domain.

Normalizes a keyframe interpolation mode. Unknown or omitted values are treated as linear.

Normalizes one side of a keyframe.

Shifts all keyframes on a clip by a timeline delta.