fix(#1240): fix overall balance to stay anchored to today across calendar navigation

[rbalogic]

Summary

Fixes #1240.

Overall Balance now stays anchored to the real current day, even when navigating to past or future dates in Month/Day views.

What Changed?

• Anchored Overall Balance calculations to today in both Month and Day views
• Preserved existing count-today behavior
• Updated English tooltip copy to match implemented behavior
• Added renderer test coverage for past/future navigation in both calendar views
• Stabilized the calendar window wait-mode renderer test

Why This Change?

Navigating the calendar previously made Overall Balance appear to shift with the viewed date.
This update keeps the metric fixed to today for consistent, predictable behavior.

Testing

npm run test:electron-mocha

npx eslint \
  renderer/classes/BaseCalendar.js \
  renderer/classes/MonthCalendar.js \
  renderer/classes/DayCalendar.js \
  __tests__/__renderer__/calendar.mjs \
  __tests__/__renderer__/classes/MonthCalendar.mjs \
  __tests__/__renderer__/classes/DayCalendar.mjs \
  --config configs/eslint.config.mjs

npx prettier -c locales/en/translation.json --config configs/.prettierrc.json

Notes

• No screenshots included: behavior change only, plus a tooltip text update.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[rbalogic]

@tupaschoal Please review this PR when you can and approve workflow if required, Thanks.

[tupaschoal]

Sorry for the delay, I'm currently very busy, so it will still be a couple weeks until I can review it

[tupaschoal]

Hi @rbalogic, sorry it took me so long to review this, but I'm finally here :D

It looks to be working just fine and thanks for adding tests. Maybe we need an additional test with some actual values just to trust that the math is expected?

Also I noticed that when we switch months/days (depending on calendar view), the overall balance flickers as if it just recalculated, but now we know it doesn't, so there is probably logic somewhere that doesn't need to be called everytime the view changes.

[tupaschoal]

Why did you have to add this piece of code?

[rbalogic]

This was added to make the test deterministic.

src/calendar.js registers the IPC handlers during async setup after import, and in the full suite this test could sometimes assert before handleToggleMainWindowWait had been assigned. This small wait just synchronizes the test with that setup.

[rbalogic]

@tupaschoal I have addressed the comments. Added a real-value regression test, removed the redundant month-view overall balance refresh that was causing the extra recalculation, and explained the calendar.mjs synchronization code in the inline reply.

Please review when you can, Thanks.

[tupaschoal]

I tested and I still see a small flicker, I recorded ahigh fps gif

Note that it sets the balance to ... because of its placeholder text

I'm ok if you think this should be handled in a separate PR, but I think it becomes a bit weirder now that the balance itself is not changing.

[rbalogic]

@tupaschoal Thanks, I handled this in the same PR.

The remaining flicker was coming from the month view redraw recreating the overall-balance field with the ... placeholder before the async overall-balance refresh completed. I changed the calendar to restore the last known overall balance immediately after redraw, and then let the async refresh update it if needed.

So this should keep the field stable during navigation while preserving the existing async calculation flow.

[tupaschoal]

\changelog-update
Message: Fix #1240: Overall balance updates when changing months/days