Skip to content

v0.3.12 - EventDetailScreen Modal and Enhanced Visualization (2025-12-23)

What Changed?

This release enhances the EventDisplayPanel with a full-screen modal display for detailed event inspection. Users can now press Enter to expand the current event into a dedicated modal screen showing all event fields and detailed detector visualization. The release also refines the visual indicators with blue for hits and gray for no-hits to improve readability.

What's New

Main Feature: EventDetailScreen Modal Display

What it does: The EventDetailScreen provides a full-screen modal view of event details when activated from the EventDisplayPanel. The modal displays the complete detector structure visualization alongside all event fields in a scrollable format. Users can quickly drill-down into event data without losing the main monitoring view.

How to use it:

  1. Focus on the EventDisplayPanel (click or navigate to it)
  2. Press Enter to open the full-screen event details modal
  3. Review all event fields and detector layer information
  4. Press q or Escape to return to the main monitoring view

Example modal display:

Event Details

Type: 7
Detected: 1234567890

|-----|---|
| top | ◼ |  (blue filled = hit detected)
|-----|---|
| mid | ◼ |  (blue filled = hit detected)
|-----|---|
| btm | ◼ |  (blue filled = hit detected)
|-----|---|

All Fields:
adc_value: 4095
detected_us: 1234567890
hit_type: 7
...

Installation

Quick Start

# Get the release
git checkout v0.3.12

# Setup
uv sync

# Run monitor with stdin
uv run kazunoko generate 100 | uv run examples/monitor.py

# Or watch a directory
uv run examples/monitor.py --watch /path/to/data

What's Different from the Last Version?

✅ Added

  • EventDetailScreen class: Full-screen modal for displaying detailed event information
  • Modal display of all event fields with automatic sorting
  • Enter key binding to open event detail modal from EventDisplayPanel
  • q and Escape key bindings to close the modal screen
  • Enhanced keyboard navigation for drilling into event data

🔧 Changed

  • EventDisplayPanel indicator colors refined: blue for hits, gray for no-hits
  • Improved visual contrast between detector layer states
  • Updated keyboard shortcut documentation with modal expand action

🐛 Fixed

  • None

Is It Safe to Upgrade?

Backward Compatible: Yes

  • All existing CLI commands and workflows unchanged
  • No breaking changes to public APIs or monitor functionality
  • Modal display is entirely additive - existing functionality preserved
  • Existing monitoring scripts and integrations continue to work without modification

Tests Passed

  • ✅ Builds without errors
  • ✅ Pre-commit hooks pass
  • ✅ Conventional commit validation passed
  • ✅ Monitor starts and displays all panels
  • ✅ Modal opens and closes correctly on Enter/Escape
  • ✅ Event data displays correctly in modal

Release Details

  • Date: 2025-12-23
  • Version: v0.3.12
  • Files Changed: 1 (examples/monitor.py)
  • Commits:
  • 6cbeb5b refactor: update EventDisplayPanel indicator colors to blue and gray
  • 1f7f246 feat: add detected_us timestamp to EventDisplayPanel
  • c747167 feat: add modal display for EventDisplayPanel
  • e612195 bump: version 0.3.11 → 0.3.12

Next Steps

  • User feedback on modal usability and information display
  • Potential enhancements: event filtering in modal, search functionality, event comparison
  • Consider adding event history navigation in modal
  • Performance optimization for very large event datasets