# Changelog

## Unreleased - XXXX-XX-XX

- Make AnimationTarget derives Clone and Copy by [#90](https://github.com/Multirious/bevy_tween/pull/90)

## v0.13.0 - 2026-07-03

- Migrate to bevy 0.19
- Update nix flake

## v0.12.0 - 2026-03-09

- Migrate to Bevy 0.18 by [#80](https://github.com/Multirious/bevy_tween/pull/80)

- By [#78](https://github.com/Multirious/bevy_tween/pull/78)
  Breaking:
  - **All plugins** now have the generic parameter `TimeCtx` and field `schedule` with the constructor `in_schedule`. This is used to specify the time context and schedule to register all the systems in.
    For example:
    - `DefaultTweenPlugins::default()` remains default for `()` time context within `PostUpdate` schedule.
    - `DefaultTweenPlugins::<Fixed>::in_schedule(FixedLast)` for `Fixed` time context within `FixedLast` schedule.
  - **ALL** animation will not run without `bevy_time_runner::TimeContext<TimeCtx>` marker component with the complementary plugin registered. This also apply to all children of the animation entity. The library currently make sure that all animation spawned through **the framework automatically includes this component**, but if you do insert any animation components manually, you will have to make sure to include TimeContext component. Consult the docs for more details.
  - Add `enable_debug` field to `TweenCorePlugin`.
  - `BevyTweenRegisterSystems::add_tween_systems` now expects `schedule` parameter.
  - Add `animation_in_time_context<T>()` method to `AnimationBuilderExt`
  - All tween systems has the generic parameter `TimeCtx` and changed query to only query for tweens entity with `TimeContext<TimeCtx>` component.

  Non-brekaing:
  - Add `component_tween_system_with_time_context` which is the same as `component_tween_system` but has the generic parameter `TimeCtx`
  - Add `component_dyn_tween_system_with_time_context` which is the same as `component_dyn_tween_system` but has the generic parameter `TimeCtx`
  - Add `resource_tween_system_with_time_context` which is the same as `resource_tween_system` but has the generic parameter `TimeCtx`

  - Deprecated `TweenAppResource`. Though all plugins will continued to support it to remain compatible **except plugin groups**.

  Example:
  - Add `time_context_animation` example.

Internal:
- Update flake by [#77](https://github.com/Multirious/bevy_tween/pull/77)
  - Use latest instead of a version for stableRust in flake.nix
  - `nix flake update`
  - Remove flake-utils dependency from flake.nix
- Update issue and PR template by [#81](https://github.com/Multirious/bevy_tween/pull/81)

## v0.11.0 - 2026-01-01

- Add `EventEmittingTween` to all event-emitting tweens, no matter their `Data` type

## v0.10.0 - 2025-10-08

- Migrate to Bevy 0.17

## v0.9.1 - 2025-07-15

- Fix color delta interpolation

### Breaking Change

- Add a delta flag to the built-in tweens
  - This comes instead of the additional XDelta type so that one won't have to register so twice the types

## v0.9.0 - 2025-07-14

### Breaking Changes

- `interpolate` functions now take an additional `previous_value` argument, which you can now use to make delta tweens.
  Still, you'd have to update everything that implements `Interpolator` to match the new signature.
  - Now, if you want to interpolate yourself an interpolator that uses `previous_value`, you should query for `TweenPreviousValue` as well. This is a required component, so it'll always be on the tween's entity unless you explicitly remove it.

### Changes

- Migrate to Bevy 0.16.1
- You can now use `previous_value` to make tweens that apply delta instead of set values
  (see `TranslationDelta` for example). This is useful when you want two ongoing tweens to affect the same entity.

## v0.8.0 - 2025-05-09

### Changes

- Migrate to bevy 0.16
  - Update all examples
- Change to Rust edition 2024
- Add Nix flake files
- Update EaseKind documentation to EaseFunction

## v0.7.0 - 2024-12-09

### Changes

- Migrate to bevy 0.15
  - `LookupCurveHandle` as a replacement for `Handle<LookupCurve>`
  - Update all examples
- Update README.md
- Add public `new()` constructor for `AnimationBuilder`
- Update Cargo.toml dependnecies
- Replace bevy_eventlistener with observer ([#44](https://github.com/Multirious/bevy_tween/pull/44))
- Remove `tween_event_taking_system`, `TweenEventTakingPlugin`, and inner option inside `TweenEvent` ([#44](https://github.com/Multirious/bevy_tween/pull/44))
- `entity_event` is now a example for tween event and observers
- Change EaseFunction to EaseKind which is a direct copy from `bevy_math::curve::EaseFunction` and will be deprecated in favour of `bevy_math::curve::EaseFunction`

## v0.6.0 - 2024-7-07

### Changes

- Update `bevy` to `0.14`
- Add interpolators for some UI components when using the `bevy_ui` feature. ([#33](https://github.com/Multirious/bevy_tween/pull/33))
  - `BackgroundColor`
  - `BorderColor`
- Add optional feature for `serde`. ([#31](https://github.com/Multirious/bevy_tween/pull/31))
  - Derive `Serialize` and `Deserialize` for `EaseFunction`
- Clean up `TweenAppResource` after the app runs. ([#28](https://github.com/Multirious/bevy_tween/pull/28))
- Update animation builder ([#36](https://github.com/Multirious/bevy_tween/pull/36))
  - Add `entity_commands()` getter
  - Add `time_runner()` getter
  - Add `time_runner_mut()` getter
  - Add `skipped()` method
  - Add `disabled()` method
  - Add `time_scale()` method
  - Add `direction()` method
- Optimize crate size (11 MB to 0.488 MB)
  - Remove one 9.8 MB gif file

## v0.5.0 - 2024-06-09

### Breaking changes

- Move span_tweener and tween_timer types to `bevy_time_runner`
- Remove `tween_timer` module and all types in it. Some types can be found in `bevy_time_runner`
- Remove `span_tween` module and all types in it
- Remove `"span_tween"` feature flag
- Remove `TweenSystemSet::TickTween `
- Remove `TweenSystemSet::Tweener`
- Replace `TargetComponent::Tweener*` with `TargetComponent::Marker` and `AnimationTarget`. Update default accordingly
- Update library to use types from `bevy_time_runner`
- Remove all types, method, and function related to tweener. Most is renamed and move to `bevy_time_runner`

All timing types is moved to `bevy_time_runner` including some changes.

- `Repeat`
- `RepeatStyle`
- `SpanTweener` is replaced with `TimeRunner`
- `AnimationDirection` is replaced with `TimeDirection`
- `SpanTweenerEnded` is replaced with `TimeRunnerEnded`
- `TweenTimeSpan` is replaced with `TimeSpan`
- ...And some more

### Fixes

- Fix tween systems error will flood the console

### Changes

- Supports `bevy_eventlistener` #16 by musjj
- Interpolation implementation for bevy_lookup_curve
- Update readme
- Update docs
- Improve lib docs
- Fix getting started code example. You're suppose to use `bevy_tween::prelude::*` not `bevy_tween::*`!
- Add curve text art to EaseFunction
- Implements combinator
- Implements state
- New animation builder and traits
- Add function constructor for interpolators
- Add `IntoTarget` trait
- pub use bevy_time_runner
- `TweenCorePlugin` adds `TimeRunnerPlugin` automatically if not exists
- Remove deprecated systems and types
- Add build.rs file to actually make CHANNEL_NIGHTLY cfg flag works
- Update all examples to account for new changes
- Add rustc_version to build dependencies
- Remove span_tween example
- Turn off format_code_in_doc_comments rust fmt config

## v0.4.0 - 2024-04-08

### Changes

- Add `SpanTweensBuilder::add` trait
- Add `SpanTweenPreset` trait
- Update examples to use the preset APIs.
- Documentations
- Add "Features" section to README.md
- Add "Contributions" section to README.md
- Add "Your contributions" section to README.md

## v0.3.1 - 2024-04-04

- Fix README.md

## v0.3.0 - 2024-04-03

### Breaking Changes

- Remove unnecessary generics from `TargetComponent` and `TargetResource`
- Add `app_resource: TweenAppResource` field to `TweenCorePlugin`
- All plugins and APIs that uses `PostUpdate` schedule is changed to use schedule from
  `TweenAppResource`
- Delegate `span_tweener_system()`'s ticking responsibility to `tick_span_tweener_system()`
- Remove `Eq` and `Hash` derives from `SpanTweener`, `Elasped`, and `TweenTimer`
- Remove `new()` from `Elasped`
- Remove `state: TweenState` field from SpanTweenBundle
- Remove `TweenState`
- Remove `TweenTarget` impl from `TargetComponent`, `TargetResource` and, `TargetAsset`
- Change `component_tween_system_full`, `resource_tween_system_full`, and `asset_tween_system_full`
  function signature to account for `SkipTween` component
- Remove `TickResult`
- Change `Elasped` struct definition
- Combine `repeat` and `repeat_style` in `TweenTimer` to just `repeat` then
  change corresponding methods.
- Change `TweenTimer::tick()` to accepts `f32` instead of `Duration`
- Change `TweenTimer::tick()` behavior to not update `previous` field in `Elasped`.
  `collaspe_elasped` will update the `previous` field instead.
- Change `Repeat` to use `i32` instead of `usize` and update their corresponding methods.

### Changes

- Add `TweenAppResource`
- Add `DefaultTweenEventsPlugin`
- Add `TweenEventData`
- Add `TweenEvent`
- Add `TweenTimer::set_tick`
- Add `TweenTimer::collaspe_elasped`
- Add `Repeat::advance_counter_by`
- Add `apply_component_tween_system`, `apply_resource_tween_system`,
  and `apply_asset_tween_system`
- Add `SkipTween`
- Add `SkipTweener`
- Add `TweenProgress` to replace `TweenState`
- Add `SpanTweensBuilderExt`
- Add `SpanTweensBuilder`
- Add `tick_span_tweener_system()`
- Add `SpanTweenerBundle::tween_here()`
- Add `SpanTweenHereBundle`
- Add `DefaultTweenEventsPlugin` to `DefaultTweenPlugins`
- Add `BoxedInterpolator` alias for `Box<dyn Interpolator>`
- Add impl `Interpolator` for `Arc<I>` and `dyn Fn`
- Register `EaseFunction` in `EaseFunctionPlugin`
- Register `TweenProgress` in `TweenCorePlugin`
- Add unit tests for `TweenTimer`
- Lots of documentations and code examples
- Remove `TweenTarget` and `Interpolator` trait requirement from `Tween<T, I>`
- Remove many `TweenTarget` requirement from `Tween<T, I>` implementations
- Improves `TweenTimer::tick()` code to account to new `Elasped`
- Improves `span_tweener_system` code to account to new `TweenTimer::tick()` behavior

### Fixes

- Fixed missing `AngleZ` tween system in `DefaultInterpolatorsPlugin`

### Deprecates

- Deprecate `QuickSpanTweenBundle`
- Deprecate `span_tween::span_tween()`
- Deprecate `ChildSpanTweenBuilder`
- Deprecate `ChildSpanTweenBuilderExt`
- Deprecate `WorldChildSpanTweenBuilder`
- Deprecate `WorldChildSpanTweenBuilderExt`
- Deprecate `TweenTarget`
- Deprecate `component_tween_system_full`
- Deprecate `resource_tween_system_full`
- Deprecate `asset_tween_system_full`
- Deprecate `Repeat::try_advance_counter`

## v0.2.0 - 2024-03-14

_First release!_