design: revenue calendar year view, bulk-select, and mobile agenda (#424 #426 #428)

[Toyosi5566]

Overview

This PR restores and extends the Revenue Reporting Calendar with a year/quarter period switcher, bulk-select close UX with undo, and a mobile agenda view — covering audit-friendly year overview, ops bulk reconciliation, and usable small-screen browsing.

Related Issue

Closes #424
Closes #426
Closes #428

Changes

📅 Year / Quarter Period Switcher (#424)

• [ADD] src/components/RevenueCalendarPeriodViews.tsx
  • 12-month year overview grid with per-month status glyphs, counts, and keyboard navigation.
  • Quarter tiles with month-level glyphs and drill-down into month view.
• [MODIFY] RevenueReportingCalendar.tsx
  • Segmented Month / Quarter / Year control; year±1 navigation; selection preserved across scales.

✅ Bulk Select + Close (#426)

• [MODIFY] Floating bulk action toolbar
  • Shift+Click / Ctrl·Cmd+Click / Shift+Arrow range selection.
  • Close → confirm copy for mixed statuses → UndoBanner via onBulkClose / onBulkCloseUndo.
  • Export and Nudge Owners hooks (onBulkExport, onBulkNudge).

📱 Mobile Agenda (#428)

• [ADD] src/components/RevenueCalendarAgendaView.tsx
  • Restores missing AgendaView (calendar was crashing on master).
  • Sticky month headers, issuer labels, swipe nudge/close with confirm.
• [MODIFY] Mobile Calendar / Agenda toggle (month scale).

📚 Docs & tests

• [ADD] docs/uiux/revenue-calendar-year-bulk-agenda.md
• [MODIFY] RevenueReportingCalendar.test.tsx — coverage for period switcher, bulk close, and agenda.
• [FIX] Details panel month/year parse bug that rendered titles like “October 2074”.

Verification Results

npm test -- --run src/components/RevenueReportingCalendar.test.tsx
✅ 53/53 passed

npx eslint src/components/RevenueReportingCalendar.tsx \
  src/components/RevenueCalendarPeriodViews.tsx \
  src/components/RevenueCalendarAgendaView.tsx
✅ clean

Acceptance Criteria	Status
Year overview with month tiles + status glyphs + drill-down	✅ Month/Quarter/Year switcher with keyboard grids
Year switch preserves selection; keyboard nav	✅ Selection retained; arrow/Home/End/Enter on tiles
Bulk select with Shift+click + keyboard equivalents	✅ Shift/Cmd click + Shift+Arrow
Floating toolbar: close / export / nudge + undo	✅ Confirm-close + UndoBanner
Mobile agenda with sticky month headers + status pills	✅ Restored agenda; sticky headers; issuer + swipe actions
WCAG-oriented labels / roles documented	✅ Docs + ARIA roles in components

[drips-wave]

@Toyosi5566 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits