fix(compat): add tmux version compatibility for 3.2a-3.5

- Add command_error hook field (tmux 3.5+)
- Guard pane-colours test with version check (tmux 3.3+)
- Update terminal-overrides expectations for tmux 3.5
- Fix escape-time doctests to not rely on default value

Author: tony

src/libtmux/_internal/constants.py

@@ -434,6 +434,8 @@ class Hooks(
     after_split_window: SparseArray[str] = field(default_factory=SparseArray)
     # Runs after 'unbind-key' completes
     after_unbind_key: SparseArray[str] = field(default_factory=SparseArray)
+    # Runs when a command fails (tmux 3.5+)
+    command_error: SparseArray[str] = field(default_factory=SparseArray)
 
     @classmethod
     def from_stdout(cls, value: list[str]) -> Hooks:

src/libtmux/options.py

@@ -609,9 +609,6 @@ def set_option(
         ...
         ...     default_option_scope = OptionScope.Server
 
-        >>> MyServer()._show_option('escape-time')
-        500
-
         >>> MyServer().set_option('escape-time', 1250)
         <libtmux.options.MyServer object at ...>
 
@@ -727,8 +724,8 @@ def unset_option(
         >>> MyServer().unset_option('escape-time')
         <libtmux.options.MyServer object at ...>
 
-        >>> MyServer()._show_option('escape-time')
-        500
+        >>> isinstance(MyServer()._show_option('escape-time'), int)
+        True
         """
         if scope is DEFAULT_OPTION_SCOPE:
             scope = self.default_option_scope

tests/test_options.py

@@ -489,7 +489,11 @@ def test_stable_baseline_options_and_hooks(server: Server) -> None:
             assert terminal_features["rxvt*"] == ["ignorefkeys"]
 
     # Terminal overrides differ by version
-    if has_gte_version("3.0"):
+    # In tmux 3.5+, terminal-overrides has a default value
+    if has_gte_version("3.5"):
+        terminal_overrides = server.show_option("terminal-overrides")
+        assert isinstance(terminal_overrides, (dict, type(None)))
+    elif has_gte_version("3.0"):
         assert server.show_option("terminal-overrides") is None
     else:
         terminal_overrides = server.show_option("terminal-overrides")
@@ -515,10 +519,11 @@ def test_stable_baseline_options_and_hooks(server: Server) -> None:
         with pytest.raises(OptionError):
             server.show_option("update-environment")
 
-    # List variables: Pane
+    # List variables: Pane (pane-colours added in tmux 3.3)
     pane = session.active_pane
     assert pane is not None
-    assert pane.show_option("pane-colours") is None
+    if has_gte_version("3.3"):
+        assert pane.show_option("pane-colours") is None
 
 
 def test_high_level_api_expectations(server: Server) -> None: