Add option to skip animation when the counter decreases

[stonko1994]

Description

This PR adds the possibility to skip the confetti animation when the $counter value decreases compared to the previous value.

Imagine one has bound the $counter to the current score of a 'player' in any game where the score can in- and decrease. However, the animation should only be shown when the score increases. Having such a convenient configuration option to skip the animation might be helpful.

I created the PR against master as the develop branch is behind the master branch.

Related Issues

No Issue created

Checklist

• [x] Have you added tests where necessary? Do all the test pass?
  • There is only one test that doesn't really test the business code so I didn't add a new one as the testing facility is not properly set up for adding new meaningful tests
• [x] Have you added descriptive comments to your code?
• [x] Have you updated the documentation related to this propo

[simibac]

Thanks for the PR. I believe that such logic should be resolved outside of the package as this is very specific to your usecase. IMO the score for a player should be maintained as a separate variable in your application. Your app should decide whether it wants to trigger the animation or not. Imagine some other app might want to trigger the animation only on odd counters etc. Such specific logic is difficult to abstract and thus, should be handled outside of a package.

Let me know if you disagree or if I understood the usecase wrong :)

[stonko1994]

That's a good point 🤔 If you start adding such convenience configurations to the package there might be a lot of other coming as well 😅

Totally agree that this should be resolved outside 🙂