• 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(...)')

• 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.

• 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 scrambleText() function-based value to animate text with a character-by-character scramble/reveal effect (learn more: https://animejs.com/documentation/text/scrambletext)

• 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

• New priority parameter to control execution order within the engine tick loop

• 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

• createLayout() now accepts an id parameter

• globals is now exported from the main module entry point
• forEachChildren, addChild, removeChild helpers are now exported from utils

• 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

• Fix chaining in keyframe arrays and timelines producing incorrect intermediate shapes

• Fix accessing non-existent chainable methods throwing an error instead of returning undefined

• Fix addEffect() returning undefined instead of this when the effect argument is not a function

• Fix scroll-controlled layout animations not properly calling onComplete and onPause callbacks

• Fix _startTime not being preserved when reconstructing tracked animations, causing timing jumps on effect refresh

• 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

• Type annotation for splitText() and TextSplitter target parameter widened from HTMLElement to Element

• 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

• 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

• New globals.editor hook system allowing an external editor to intercept animate() and createTimeline() calls

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

• Fix a regression introduced in v4.3.2 that prevented inline element to be animated in some cases.

• Fix a regression introduced in v4.3.0 that prevented CSS computed style of background to be correctly interpreted as a color value (#1136).

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

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

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

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

Playback

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

Easing

• Add an opacity animation preview to the easing functions editor

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

• New createLayout() method to easily animate between two layout states (learn more about layouts here: https://animejs.com/documentation/layout)

• The ease parameter now accepts function-based values (like duration and delay properties)

• Add composition parameter to disable animation composition when using .add() and greatly improve performance

• 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

• Fix animations not being properly removed from document.timeline in some cases

• Fix spring parameters not properly setting the duration

• Fix spring easing being ignored when defined in the defaults parameter
• Fix .call() and .sync() incorrectly inheriting delay from defaults parameters

• 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

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

• createMotionPath(): Fix a bug introduced in v4.2.1 that wrapped the target back to 0 when reaching 1 (#1104 )