feat: 🚀 Fixed and improved side event arranger

[Sahil-Simform]

Description

• I have fixed overlapping event issue
• Fixed the proper event arrangement issue when there is 4 consicutive events
• Improved code quality and performance

Checklist

• The title of my PR starts with a Conventional Commit prefix (fix:, feat:, docs: etc).
• I have followed the Contributor Guide when preparing my PR.
• I have updated/added tests for ALL new/updated/fixed functionality.
• I have updated/added relevant documentation in docs and added dartdoc comments with ///.
• I have updated/added relevant examples in examples or docs.

Breaking Change?

• Yes, this PR is a breaking change.
• No, this PR is not a breaking change.

Related Issues

[PRBaraiya]

Converting this PR to a draft as we need more improvements in the algorythm

[Copilot]

Pull request overview

This PR refactors the SideEventArranger class to fix overlapping event issues and improve event arrangement, particularly for scenarios with 4 consecutive events. The implementation replaces the previous recursive algorithm with a cleaner column-based approach.

Key changes:

• Complete rewrite of the event arrangement algorithm using a first-fit column allocation strategy
• Renamed includeEdges parameter to countAdjacentEventsAsOverlapping for better clarity
• Added comprehensive documentation for all methods with edge case descriptions

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.