Merge branch 'v2_develop' into v2_3847_tabview-focus-fix

Author: BDisp

.github/workflows/publish.yml

@@ -19,13 +19,13 @@ jobs:
         fetch-depth: 0 # fetch-depth is needed for GitVersion
 
     - name: Install GitVersion 
-      uses: gittools/actions/gitversion/setup@v2
+      uses: gittools/actions/gitversion/setup@v3
       with:
           versionSpec: '5.x'
           includePrerelease: true
 
     - name: Determine Version
-      uses: gittools/actions/gitversion/execute@v2
+      uses: gittools/actions/gitversion/execute@v3
       with:
         useConfigFile: true
         #additionalArguments: /b develop

Showcase.md

@@ -26,7 +26,7 @@
 
 - **[Muse](https://github.com/MaciekWin3/Muse)** - Muse is terminal music player built with Terminal.Gui and NAudio on .NET platform.
   ![Muse](https://github.com/user-attachments/assets/94aeb559-a889-4b52-bb0d-453b3e19b290)
-z
+
 - **[Whale](https://github.com/MaciekWin3/Whale)** - Lightweight terminal user interface application that helps software engineers manage Docker containers.
   ![Whale](https://github.com/user-attachments/assets/7ef6e348-c36b-4aee-a63c-4e5c60c3aad2)
 

Terminal.Gui/Application/Application.Driver.cs

@@ -8,6 +8,7 @@ public static partial class Application // Driver abstractions
     /// <summary>Gets the <see cref="ConsoleDriver"/> that has been selected. See also <see cref="ForceDriver"/>.</summary>
     public static ConsoleDriver? Driver { get; internal set; }
 
+    // BUGBUG: Force16Colors should be nullable.
     /// <summary>
     ///     Gets or sets whether <see cref="Application.Driver"/> will be forced to output only the 16 colors defined in
     ///     <see cref="ColorName16"/>. The default is <see langword="false"/>, meaning 24-bit (TrueColor) colors will be output
@@ -16,6 +17,7 @@ public static partial class Application // Driver abstractions
     [SerializableConfigurationProperty (Scope = typeof (SettingsScope))]
     public static bool Force16Colors { get; set; }
 
+    // BUGBUG: ForceDriver should be nullable.
     /// <summary>
     ///     Forces the use of the specified driver (one of "fake", "ansi", "curses", "net", or "windows"). If not
     ///     specified, the driver is selected based on the platform.

Terminal.Gui/Application/Application.Keyboard.cs

@@ -49,6 +49,11 @@ public static bool RaiseKeyDownEvent (Key key)
         {
             if (binding.Value.BoundView is { })
             {
+                if (!binding.Value.BoundView.Enabled)
+                {
+                    return false;
+                }
+
                 bool? handled = binding.Value.BoundView?.InvokeCommands (binding.Value.Commands, binding.Key, binding.Value);
 
                 if (handled != null && (bool)handled)

Terminal.Gui/Drawing/Glyphs.cs

@@ -20,6 +20,11 @@
 /// </remarks>
 public class GlyphDefinitions
 {
+    // IMPORTANT: If you change these, make sure to update the ./Resources/config.json file as
+    // IMPORTANT: it is the source of truth for the default glyphs at runtime.
+    // IMPORTANT: Configuration Manager test SaveDefaults uses this class to generate the default config file
+    // IMPORTANT: in ./UnitTests/bin/Debug/netX.0/config.json
+
     /// <summary>File icon.  Defaults to ☰ (Trigram For Heaven)</summary>
     public Rune File { get; set; } = (Rune)'☰';
 

Terminal.Gui/Input/KeyBindings.cs

@@ -1,5 +1,7 @@
 #nullable enable
 
+using static System.Formats.Asn1.AsnWriter;
+
 namespace Terminal.Gui;
 
 /// <summary>
@@ -17,7 +19,7 @@ public class KeyBindings
     public KeyBindings () { }
 
     /// <summary>Initializes a new instance bound to <paramref name="boundView"/>.</summary>
-    public KeyBindings (View boundView) { BoundView = boundView; }
+    public KeyBindings (View? boundView) { BoundView = boundView; }
 
     /// <summary>Adds a <see cref="KeyBinding"/> to the collection.</summary>
     /// <param name="key"></param>
@@ -27,7 +29,12 @@ public void Add (Key key, KeyBinding binding, View? boundViewForAppScope = null)
     {
         if (BoundView is { } && binding.Scope.FastHasFlags (KeyBindingScope.Application))
         {
-            throw new ArgumentException ("Application scoped KeyBindings must be added via Application.KeyBindings.Add");
+            throw new InvalidOperationException ("Application scoped KeyBindings must be added via Application.KeyBindings.Add");
+        }
+
+        if (BoundView is { } && boundViewForAppScope is null)
+        {
+            boundViewForAppScope = BoundView;
         }
 
         if (TryGet (key, out KeyBinding _))
@@ -78,6 +85,10 @@ public void Add (Key key, KeyBindingScope scope, View? boundViewForAppScope = nu
         {
             throw new ArgumentException ("Application scoped KeyBindings must be added via Application.KeyBindings.Add");
         }
+        else
+        {
+            // boundViewForAppScope = BoundView;
+        }
 
         if (key is null || !key.IsValid)
         {
@@ -93,11 +104,9 @@ public void Add (Key key, KeyBindingScope scope, View? boundViewForAppScope = nu
         if (TryGet (key, out KeyBinding binding))
         {
             throw new InvalidOperationException (@$"A key binding for {key} exists ({binding}).");
-
-            //Bindings [key] = new (commands, scope, BoundView);
         }
 
-        Add (key, new KeyBinding (commands, scope, BoundView), boundViewForAppScope);
+        Add (key, new KeyBinding (commands, scope, boundViewForAppScope), boundViewForAppScope);
     }
 
     /// <summary>
@@ -120,9 +129,14 @@ public void Add (Key key, KeyBindingScope scope, View? boundViewForAppScope = nu
     /// </param>
     public void Add (Key key, KeyBindingScope scope, params Command [] commands)
     {
+        if (BoundView is null && !scope.FastHasFlags (KeyBindingScope.Application))
+        {
+            throw new InvalidOperationException ("BoundView cannot be null.");
+        }
+
         if (BoundView is { } && scope.FastHasFlags (KeyBindingScope.Application))
         {
-            throw new ArgumentException ("Application scoped KeyBindings must be added via Application.KeyBindings.Add");
+            throw new InvalidOperationException ("Application scoped KeyBindings must be added via Application.KeyBindings.Add");
         }
 
         if (key == Key.Empty || !key.IsValid)
@@ -140,7 +154,7 @@ public void Add (Key key, KeyBindingScope scope, params Command [] commands)
             throw new InvalidOperationException (@$"A key binding for {key} exists ({binding}).");
         }
 
-        Add (key, new KeyBinding (commands, scope, BoundView));
+        Add (key, new KeyBinding (commands, scope, BoundView), BoundView);
     }
 
     /// <summary>
@@ -219,14 +233,22 @@ public void Add (Key key, params Command [] commands)
     /// <summary>The collection of <see cref="KeyBinding"/> objects.</summary>
     public Dictionary<Key, KeyBinding> Bindings { get; } = new (new KeyEqualityComparer ());
 
+    /// <summary>
+    ///     Gets the keys that are bound.
+    /// </summary>
+    /// <returns></returns>
+    public IEnumerable<Key> GetBoundKeys ()
+    {
+        return Bindings.Keys;
+    }
+
     /// <summary>
     ///     The view that the <see cref="KeyBindings"/> are bound to.
     /// </summary>
     /// <remarks>
-    ///     If <see langword="null"/>, the <see cref="KeyBindings"/> are not bound to a <see cref="View"/>. This is used for
-    ///     Application.KeyBindings.
+    ///     If <see langword="null"/> the KeyBindings object is being used for Application.KeyBindings.
     /// </remarks>
-    public View? BoundView { get; }
+    internal View? BoundView { get; }
 
     /// <summary>Removes all <see cref="KeyBinding"/> objects from the collection.</summary>
     public void Clear () { Bindings.Clear (); }
@@ -312,7 +334,7 @@ public IEnumerable<Key> GetKeysFromCommands (params Command [] commands)
     /// <param name="boundViewForAppScope">Optional View for <see cref="KeyBindingScope.Application"/> bindings.</param>
     public void Remove (Key key, View? boundViewForAppScope = null)
     {
-        if (!TryGet (key, out KeyBinding binding))
+        if (!TryGet (key, out KeyBinding _))
         {
             return;
         }
@@ -371,6 +393,11 @@ public void ReplaceKey (Key oldKey, Key newKey)
     /// <returns><see langword="true"/> if the Key is bound; otherwise <see langword="false"/>.</returns>
     public bool TryGet (Key key, out KeyBinding binding)
     {
+        //if (BoundView is null)
+        //{
+        //    throw new InvalidOperationException ("KeyBindings must be bound to a View to use this method.");
+        //}
+
         binding = new (Array.Empty<Command> (), KeyBindingScope.Disabled, null);
 
         if (key.IsValid)
@@ -394,6 +421,11 @@ public bool TryGet (Key key, KeyBindingScope scope, out KeyBinding binding)
     {
         if (!key.IsValid)
         {
+        //if (BoundView is null)
+        //{
+        //    throw new InvalidOperationException ("KeyBindings must be bound to a View to use this method.");
+        //}
+
             binding = new (Array.Empty<Command> (), KeyBindingScope.Disabled, null);
             return false;
         }

Terminal.Gui/Resources/config.json

@@ -16,14 +16,173 @@
   // to throw exceptions. 
   "ConfigurationManager.ThrowOnJsonErrors": false,
 
-  "Application.NextTabKey": "Tab",
-  "Application.PrevTabKey": "Shift+Tab",
+  // --------------- Application Settings ---------------
+  "Key.Separator": "+",
+
+  "Application.ArrangeKey": "Ctrl+F5",
+  "Application.Force16Colors": false,
+  //"Application.ForceDriver": "", // TODO: ForceDriver should be nullable
+  "Application.IsMouseDisabled": false,
   "Application.NextTabGroupKey": "F6",
+  "Application.NextTabKey": "Tab",
   "Application.PrevTabGroupKey": "Shift+F6",
+  "Application.PrevTabKey": "Shift+Tab",
   "Application.QuitKey": "Esc",
-  "Application.ArrangeKey": "Ctrl+F5",
-  "Key.Separator": "+",
 
+  // --------------- Colors ---------------
+
+
+  // --------------- View Specific Settings ---------------
+  "ContextMenu.DefaultKey": "Shift+F10",
+  "FileDialog.MaxSearchResults": 10000,
+  "FileDialogStyle.DefaultUseColors": false,
+  "FileDialogStyle.DefaultUseUnicodeCharacters": false,
+
+  // --------------- Glyphs ---------------
+  "Glyphs": {
+    "File": "☰",
+    "Folder": "꤉",
+    "HorizontalEllipsis": "…",
+    "VerticalFourDots": "⁞",
+    "CheckStateChecked": "☑",
+    "CheckStateUnChecked": "☐",
+    "CheckStateNone": "☒",
+    "Selected": "◉",
+    "UnSelected": "○",
+    "RightArrow": "►",
+    "LeftArrow": "◄",
+    "DownArrow": "▼",
+    "UpArrow": "▲",
+    "LeftDefaultIndicator": "►",
+    "RightDefaultIndicator": "◄",
+    "LeftBracket": "⟦",
+    "RightBracket": "⟧",
+    "BlocksMeterSegment": "▌",
+    "ContinuousMeterSegment": "█",
+    "Stipple": "░",
+    "Diamond": "◊",
+    "Close": "✘",
+    "Minimize": "❏",
+    "Maximize": "✽",
+    "Dot": "∙",
+    "BlackCircle": "●",
+    "Expand": "+",
+    "Collapse": "-",
+    "IdenticalTo": "≡",
+    "Move": "◊",
+    "SizeHorizontal": "↔",
+    "SizeVertical": "↕",
+    "SizeTopLeft": "↖",
+    "SizeTopRight": "↗",
+    "SizeBottomRight": "↘",
+    "SizeBottomLeft": "↙",
+    "Apple": "\uD83C\uDF4E",
+    "AppleBMP": "❦",
+    "HLine": "─",
+    "VLine": "│",
+    "HLineDbl": "═",
+    "VLineDbl": "║",
+    "HLineHvDa2": "╍",
+    "VLineHvDa3": "┇",
+    "HLineHvDa3": "┅",
+    "HLineHvDa4": "┉",
+    "VLineHvDa2": "╏",
+    "VLineHvDa4": "┋",
+    "HLineDa2": "╌",
+    "VLineDa3": "┆",
+    "HLineDa3": "┄",
+    "HLineDa4": "┈",
+    "VLineDa2": "╎",
+    "VLineDa4": "┊",
+    "HLineHv": "━",
+    "VLineHv": "┃",
+    "HalfLeftLine": "╴",
+    "HalfTopLine": "╵",
+    "HalfRightLine": "╶",
+    "HalfBottomLine": "╷",
+    "HalfLeftLineHv": "╸",
+    "HalfTopLineHv": "╹",
+    "HalfRightLineHv": "╺",
+    "HalfBottomLineLt": "╻",
+    "RightSideLineLtHv": "╼",
+    "BottomSideLineLtHv": "╽",
+    "LeftSideLineHvLt": "╾",
+    "TopSideLineHvLt": "╿",
+    "ULCorner": "┌",
+    "ULCornerDbl": "╔",
+    "ULCornerR": "╭",
+    "ULCornerHv": "┏",
+    "ULCornerHvLt": "┎",
+    "ULCornerLtHv": "┍",
+    "ULCornerDblSingle": "╓",
+    "ULCornerSingleDbl": "╒",
+    "LLCorner": "└",
+    "LLCornerHv": "┗",
+    "LLCornerHvLt": "┖",
+    "LLCornerLtHv": "┕",
+    "LLCornerDbl": "╚",
+    "LLCornerSingleDbl": "╘",
+    "LLCornerDblSingle": "╙",
+    "LLCornerR": "╰",
+    "URCorner": "┐",
+    "URCornerDbl": "╗",
+    "URCornerR": "╮",
+    "URCornerHv": "┓",
+    "URCornerHvLt": "┑",
+    "URCornerLtHv": "┒",
+    "URCornerDblSingle": "╖",
+    "URCornerSingleDbl": "╕",
+    "LRCorner": "┘",
+    "LRCornerDbl": "╝",
+    "LRCornerR": "╯",
+    "LRCornerHv": "┛",
+    "LRCornerDblSingle": "╜",
+    "LRCornerSingleDbl": "╛",
+    "LRCornerLtHv": "┙",
+    "LRCornerHvLt": "┚",
+    "LeftTee": "├",
+    "LeftTeeDblH": "╞",
+    "LeftTeeDblV": "╟",
+    "LeftTeeDbl": "╠",
+    "LeftTeeHvH": "┝",
+    "LeftTeeHvV": "┠",
+    "LeftTeeHvDblH": "┣",
+    "RightTee": "┤",
+    "RightTeeDblH": "╡",
+    "RightTeeDblV": "╢",
+    "RightTeeDbl": "╣",
+    "RightTeeHvH": "┥",
+    "RightTeeHvV": "┨",
+    "RightTeeHvDblH": "┫",
+    "TopTee": "┬",
+    "TopTeeDblH": "╤",
+    "TopTeeDblV": "╥",
+    "TopTeeDbl": "╦",
+    "TopTeeHvH": "┯",
+    "TopTeeHvV": "┰",
+    "TopTeeHvDblH": "┳",
+    "BottomTee": "┴",
+    "BottomTeeDblH": "╧",
+    "BottomTeeDblV": "╨",
+    "BottomTeeDbl": "╩",
+    "BottomTeeHvH": "┷",
+    "BottomTeeHvV": "┸",
+    "BottomTeeHvDblH": "┻",
+    "Cross": "┼",
+    "CrossDblH": "╪",
+    "CrossDblV": "╫",
+    "CrossDbl": "╬",
+    "CrossHvH": "┿",
+    "CrossHvV": "╂",
+    "CrossHv": "╋",
+    "ShadowVerticalStart": "▖",
+    "ShadowVertical": "▌",
+    "ShadowHorizontalStart": "▝",
+    "ShadowHorizontal": "▀",
+    "ShadowHorizontalEnd": "▘"
+  },
+
+  // --------------- Themes -----------------
   "Theme": "Default",
   "Themes": [
     {

Terminal.Gui/View/Layout/DimAuto.cs

@@ -35,7 +35,7 @@ internal override int Calculate (int location, int superviewContentSize, View us
         int screenX4 = dimension == Dimension.Width ? Application.Screen.Width * 4 : Application.Screen.Height * 4;
         int autoMax = MaximumContentDim?.GetAnchor (superviewContentSize) ?? screenX4;
 
-        Debug.Assert (autoMin <= autoMax, "MinimumContentDim must be less than or equal to MaximumContentDim.");
+        Debug.WriteLineIf (autoMin > autoMax, "MinimumContentDim must be less than or equal to MaximumContentDim.");
 
         if (Style.FastHasFlags (DimAutoStyle.Text))
         {