anime

New Features

• Adapters
  • New registerAdapter() API to extend animate() and utils.set() to non-DOM targets (learn more: https://animejs.com/documentation/adapters)
• Three.js adapter
  • New built-in three.js adapter, imported as a side-effect from animejs/adapters/three, to animate Object3D, materials, lights, cameras, audio nodes, UniformNode (TSL) and instanced meshes (learn more: https://animejs.com/documentation/adapters/three)
• Stagger
  • Auto-grid mode now supports 3D layouts, using {x, y, z} coordinates or an explicit grid: [columns, rows, depth] triplet
  • The from parameter now accepts [x, y, z] normalized coordinates and axis now accepts 'z' for 3D grid origins
  • New jitter parameter to add a random offset to staggered values, either a single number or a [start, end] range
  • New seed parameter to make jitter and from: 'random' reproducible

Bug Fixes and improvements

• Color
  • Color animations now blend RGB channels in pseudo-linear space for smoother, more even transitions (intermediate colors differ slightly from previous versions)
• Render
  • Fix a flicker that could appear randomly between iterations of reversed loops
  • Fix a flicker that could appear randomly on alternate loops when using non-integer duration values
• Timeline
  • Fix a backward seek leaving a timeline child stuck at its end value when all its properties share the same delay
  • Fix a timeline child whose delay is longer than its duration overwriting a later sibling's value on a forward seek
  • Fix stale values when seeking a timeline whose children animate the same property through delayed tweens, most visible with staggered jitter delays
  • Fix an implicit from value resolving to a stale value when an overridden tween sits earlier in the chain
  • Improve performance when building large timelines with many overlapping .add() calls on the same property, and fix a case where such a timeline could cancel itself
• Keyframes
  • Fix a floating point precision issue producing incorrect intermediate values in keyframe arrays
  • Fix scrubbing backward past the start of a keyframe sequence not restoring the first keyframe's from value
  • Fix scrubbing forward past the end of a keyframe sequence leaving the target stuck on a previous keyframe's value
  • Fix sequential keyframes occasionally detected as overlapping because of floating point drift, leaving the target stuck on the wrong value when scrubbing
• Animation
  • Fix function-based and CSS variable from values in object form ({ from, to }) not re-resolving on refresh()
  • Fix stretch() not correctly scaling animations that use keyframes
• Scroll
  • Fix a getBoundingClientRect crash that could happen when a scroll container resized before its target was ready
• Engine
  • More accurate frame scheduling that no longer drops frames arriving slightly early because of requestAnimationFrame jitter
  • Faster engine.speed and engine.timeUnit updates that skip unnecessary work when the value does not actually change

Bug fix

• Fix a regression introduced in 4.4.0 with timeline .call() not triggering properly in some cases.

Breaking Changes

• Transforms
  • Transforms now follow a fixed render order (perspective > translate > rotate > scale > skew), regardless of the order they are defined in animation parameters:

    // Before: scale rendered first because it was defined first
    animate(el, { scale: 2, translateX: 100 }) // → scale(2) translateX(100px)
    // After: order is always fixed
    animate(el, { scale: 2, translateX: 100 }) // → translate(100px, 0px) scale(2)
    

  • matrix and matrix3d can no longer be animated directly (they are still preserved when read from inline styles and can be set using transform: 'matrix(...)')
• Function-based values
  • The third argument of function-based value callbacks changed from total (Number) to targets (Array). To migrate, replace total with targets.length:

    // Before
    translateX: (target, index, total) => total * 10
    // After
    translateX: (target, index, targets) => targets.length * 10
    

  • A fourth argument prevTween is now passed to function-based value callbacks, providing access to the previous sibling tween's computed end value for the same target and property.
• Stagger
  • The stagger callback signature changed to match function-based values: the third argument is now the targets array instead of the total count:

    // Before
    delay: stagger(100, { use: (target, i, total) => total - i })
    // After
    delay: stagger(100, { use: (target, i, targets) => targets.length - i })
    

New Features

• scrambleText
  • New scrambleText() function-based value to animate text with a character-by-character scramble/reveal effect (learn more: https://animejs.com/documentation/text/scrambletext)
• Stagger
  • New grid: true auto-grid mode that computes a 2D layout from element positions or JS object coordinates ({x, y}) instead of requiring explicit [columns, rows] dimensions
  • The from parameter now accepts [x, y] normalized coordinate arrays (0 to 1) for precise grid origin control
• Timer / Animation / Timeline
  • New priority parameter to control execution order within the engine tick loop
• Transforms
  • Adjacent axis properties are now grouped into CSS shorthand for shorter transform strings:
    • translateX + translateY → translate(x, y)
    • translateX + translateY + translateZ → translate3d(x, y, z)
    • scaleX + scaleY → scale(x, y)
    • scaleX + scaleY + scaleZ → scale3d(x, y, z)
  • Inline transform parsing rewritten to properly handle multi-argument CSS functions (translate(x, y), scale3d(x, y, z)) and nested calc() expressions
• Layout
  • createLayout() now accepts an id parameter
• Exports
  • globals is now exported from the main module entry point
  • forEachChildren, addChild, removeChild helpers are now exported from utils

Bug Fixes and improvements

• JS Animation
  • revert() now restores object properties and DOM attributes to their original pre-animation values, in addition to CSS styles and transforms (previously only CSS styles and transforms were reverted, leaving animated object props and attributes at their last animated value). The public cleanInlineStyles() utility keeps its original behavior and only clears inline styles and transforms.
  • Fix getOriginalAnimatableValue not storing the original inline value for object properties and DOM attributes, preventing proper revert
• morphTo
  • Fix chaining in keyframe arrays and timelines producing incorrect intermediate shapes
• Chainable utils
  • Fix accessing non-existent chainable methods throwing an error instead of returning undefined
• splitText
  • Fix addEffect() returning undefined instead of this when the effect argument is not a function
• Layout
  • Fix scroll-controlled layout animations not properly calling onComplete and onPause callbacks
• keepTime
  • Fix _startTime not being preserved when reconstructing tracked animations, causing timing jumps on effect refresh

Changes

• Engine
  • DevTools integration (AnimeJSDevTools) removed
  • Render loop performance: inline closures in tick() and render() extracted to module-scope functions to avoid allocation every frame
  • Tween composition is now resolved before computing to/from/duration/delay values, so the previous sibling tween is available to function-based value callbacks
• splitText
  • Type annotation for splitText() and TextSplitter target parameter widened from HTMLElement to Element
• Tween value chaining
  • Each tween now pre-computes and stores its end value at construction time
  • Enables function-based values like morphTo and scrambleText to read the previous tween's end value when used in keyframe arrays or timelines
• morphTo
  • Now properly chains in keyframe arrays and timelines by reading the previous tween's computed end value instead of mutating the target element with a Symbol
• Editor integration (👀)
  • New globals.editor hook system allowing an external editor to intercept animate() and createTimeline() calls

Bug Fixes

• Auto Layout
  • Fix auto layout not properly synced with onScroll, allowing controlling layout animations like this:

layout.animate({
  autoplay: onScroll({
    sync: true,
  })
});

Bug Fixes

• Auto Layout
  • Fix a regression introduced in v4.3.2 that prevented inline element to be animated in some cases.
• Animation
  • Fix a regression introduced in v4.3.0 that prevented CSS computed style of background to be correctly interpreted as a color value (#1136).

Improvements

• WAAPI / Timeline
  • Synced WAAPI animations now automatically have their persist property set to true (#1121)

Bug Fixes

• onScroll
  • Fix comment syntax potentially causing an error (#1124)

Improvements

• Refresh

  • Function-based "from" values now refresh correctly when calling .refresh()
  • Unit conversion (e.g., svh to rem) is recalculated on refresh

• onScroll

  • Add onResize callback that triggers when the scroll container refreshes due to a resize event

Documentation

• Playback

  • Add missing tl.backward / anim.backward / time.backward property doc

• Easing

  • Add an opacity animation preview to the easing functions editor

Bug Fixes

• Layout
  • Fix an issue where inline tags, like or weren't detected when surrounded by comments (again)

Bug Fixes

• Layout
  • Fix an issue where inline tags, like or weren't detected when surrounded by comments

New Features

• AutoLayout
  • New createLayout() method to easily animate between two layout states (learn more about layouts here: https://animejs.com/documentation/layout)
• Easings
  • The ease parameter now accepts function-based values (like duration and delay properties)
• Timeline
  • Add composition parameter to disable animation composition when using .add() and greatly improve performance

Bug Fixes

• JS Animation
  • Fix an issue where complex values containing a color (e.g., box-shadow) would be incorrectly handled as color values instead of complex string values
• WAAPI
  • Fix animations not being properly removed from document.timeline in some cases
• Draggable
  • Fix spring parameters not properly setting the duration
• Timeline
  • Fix spring easing being ignored when defined in the defaults parameter
  • Fix .call() and .sync() incorrectly inheriting delay from defaults parameters
• splitText
  • Fix a bug where the first word of the second line could be incorrectly added to the first line
  • Fix unnecessary empty spaces not being properly removed from lines

Changes

• Engine
  • Increase max fps to 240 (previously 120)
  • Animation / Timer / Timeline
  • Add muteCallbacks parameter to .complete(muteCallbacks) to complete the animation without triggering callbacks