Refactor to simplify complexity

[MrNeRF]

As someone who is deeply familiar with this codebase, I am aware that there are several rough corners where the code can be simplified and made more readable. In an effort to improve the maintainability and clarity of the project, I kindly request the following:

1. Code Simplification: Please review the codebase and identify areas where the logic can be simplified without altering the functionality. The goal is to make the code cleaner, more intuitive, and easier to follow.

2. Consultation: As I am intimately familiar with the project, please feel free to reach out to me during this process. I can provide insights into which parts of the code are known to be particularly complex and could benefit the most from refactoring.

3. Refactoring: Based on the identified areas, please proceed with a thoughtful refactoring of the code. This should focus on removing unnecessary complexity, improving function and variable names, and organizing the code in a more logical and readable manner.

4. Documentation Update: After the refactoring is complete, please update relevant parts of the documentation to reflect any changes made to the code structure or function names.

5. Testing: Ensure that comprehensive tests are run after the refactoring to confirm that all functionalities remain intact and that no new issues have been introduced.

The overarching goal of this request is to make the codebase more accessible and manageable, both for current developers and for future contributors to the project.