Fixes #3692++ - Rearchitects drivers

[tznind]

This is a super set of #3791 and exists to see diff and direction of v2 drivers as discussed in #3821

Fixes

• Fixes Comprehensive Logging and Metrics (Opt in) #3892
• Fixes Refactoring, cleanup, and abstraction for ConsoleDrivers #3692
• Fixes Refactor ConsoleDriver to minimize duplicated code in all drivers #2319
• Fixes Harden EscSeqUtils  #2803
• Fixes Refactor ConsoleDrivers to support ANSI sequences natively (e.g. Virtual Terminal Sequences on Windows) #2610
• Might fix Mouse API makes it way too hard to track button pressed #3312
• Might fix Mouse doubleclick stops continous pressed events. #3404
• Might fix Not always getting Button1Clicked events on Netdriver or CursesDriver #3374

Progress

• Keyboard
  • Exit
  • Typing
  • Backspace
• Views
  • Run/RequestStop
  • MenuBar
• Mouse (see MouseInterpreter)
  • Button 1 click
  • Multi clicks
  • All buttons
  • Scroll wheel
• Other
  • Clipboard

Proposed Changes/Todos

Splits drivers up into logical components, simplifies and centralizes shared code patterns.

Pull Request checklist:

• I've named my PR in the form of "Fixes #issue. Terse description."
• My code follows the style guidelines of Terminal.Gui - if you use Visual Studio, hit CTRL-K-D to automatically reformat your files before committing.
• My code follows the Terminal.Gui library design guidelines
• I ran dotnet test before commit
• I have made corresponding changes to the API documentation (using /// style comments)
• My changes generate no new warnings
• I have checked my code and corrected any poor grammar or misspellings
• I conducted basic QA to assure all features are working

[tig]

Hope you're ok with me updating the title & first post...

[tznind]

Hope you're ok with me updating the title & first post...

No problem! Always appreciate a clear naming

Now we have fledgling support for

• Keyboard
• Mouse
• Screen size

Net (i.e. native dotnet) and Windows (i.e win 32 api) are the two implementations - I assume we can drop curses and don't need to port?

[tznind]

@BDisp EscSeqUtils.MapKey does not handle backspace. Here is the ConsoleKeyInfo that comes in direct from console when reading with console read:

Apparently:

When working with ConsoleKeyInfo in a console application (e.g., in .NET or similar environments), the behavior you're describing is common. Here's why:
Backspace and 127 (0x7F) Behavior

Historically, many systems followed terminal standards where the Backspace key sent the DELETE (0x7F) control character instead of the Backspace (0x08) character.

When you press the Backspace key, the console might interpret it as sending the 127 (0x7F) code instead of 0x08 (Backspace).

This happens because of differences in how the terminal emulator or console environment maps keyboard keys to control codes.

How is this handled in NetDriver? is MapKey the best place to put this new logic?

[BDisp]

The DEL (127) is handled on the EscSeqUtils.MapConsoleKeyInfo method.

[BDisp]

This code fixes the right button click to popup the context menu.

[tznind]

The DEL (127) is handled on the EscSeqUtils.MapConsoleKeyInfo method.

Great, I have added in call to this function in the new architecture, see aa8bdd7

This code fixes the right button click to popup the context menu.

Right click works for v2 net but not v2 win, I will have to explore your suggestion further when I have some time.

[tznind]

Windows right click working thanks! 6c55e11

[BDisp]

Great, I have added in call to this function in the new architecture, see aa8bdd7

Nice.

Right click works for v2 net but not v2 win, I will have to explore your suggestion further when I have some time.

Works with NetDriver because it rely in the EscSeqUtils API and WindowsDriver don't, and it's needed to point the right way how to handle it. Don't forget to deal with the warning.

[tznind]

I have added metrics for Redraw in v2 drivers and Trace logging for the view that is responsible for wanting itself redrawn. This will let us fix issues e.g. this one where HexView is constantly saying it wants layout and redraw when nothing is going on in app:

 dotnet-counters monitor -n UICatalog --counters Terminal.Gui

[tznind]

@BDisp @tig any feedback on this PR would be appreciated.

[BDisp]

@BDisp @tig any feedback on this PR would be appreciated.

I'm in vacancy mode sorry.

[tig]

@BDisp @tig any feedback on this PR would be appreciated.

Yes.

My lighthouse beam is focused on other things right now.

But it's swinging around and will be back on TG real soon now.

I'm really excited about this PR!

[tznind]

@BDisp the EscSeqUtils.MapConsoleKeyInfo is broken for some keys e.g.

new ConsoleKeyInfo ('}', ConsoleKey.Oem6, true, false, false) 

Gets returned as

new ConsoleKeyInfo('}', ConsoleKey.None, true, false, false);

This then breaks EscSeqUtils.MapKey

MapConsoleKeyInfo and MapKey are the two methods I am chaining to turn ConsoleKeyInfo into Key

For now I am using workaround:

 /// <summary>
 /// Converts terminal raw input class <see cref="ConsoleKeyInfo"/> into
 /// common Terminal.Gui event model for keypresses (<see cref="Key"/>)
 /// </summary>
 /// <param name="input"></param>
 /// <returns></returns>
 public static Key ConsoleKeyInfoToKey (ConsoleKeyInfo input)
 {
     ConsoleKeyInfo adjustedInput = EscSeqUtils.MapConsoleKeyInfo (input);
     
     // TODO : EscSeqUtils.MapConsoleKeyInfo is wrong for e.g. '{' - it winds up clearing the Key
     //        So if the method nuked it then we should just work with the original.
     if (adjustedInput.Key == ConsoleKey.None && input.Key != ConsoleKey.None)
     {
         return EscSeqUtils.MapKey (input);
     }

     return EscSeqUtils.MapKey (adjustedInput);
 }