options.py(fix[explode_complex]): Parse multi-feature terminal-overrides

why: Per tmux.1, terminal-overrides entries are colon-separated strings where
the first part is a terminal pattern and remaining parts are individual
features. The previous code used `split(":", maxsplit=1)` which collapsed all
features after the pattern into a single key.
what:
- Split on all colons, not just the first
- Iterate over each feature part individually
- Add parametrized tests for multi-feature entries

Author: tony

src/libtmux/options.py

@@ -519,18 +519,21 @@ def explode_complex(
 
                 for item in val.iter_values():
                     try:
-                        term, features = item.split(":", maxsplit=1)
+                        # Split on all colons: first part is terminal pattern,
+                        # remaining parts are individual features/capabilities
+                        parts = item.split(":")
+                        term = parts[0]
+                        features = parts[1:]
+
                         if term not in new_overrides:
                             new_overrides[term] = {}
-                        if features and "=" in features:
-                            k, v = features.split("=", 1)
-
-                            if v.isdigit():
-                                v = int(v)
 
-                            new_overrides[term][k] = v
-                        else:
-                            new_overrides[term][features] = None
+                        for feature in features:
+                            if feature and "=" in feature:
+                                k, v = feature.split("=", 1)
+                                new_overrides[term][k] = int(v) if v.isdigit() else v
+                            elif feature:
+                                new_overrides[term][feature] = None
                     except Exception:  # NOQA: PERF203
                         logger.exception("Error parsing options")
                 options[key] = new_overrides

tests/test_options.py

@@ -19,7 +19,7 @@
 from libtmux.common import has_gte_version
 from libtmux.constants import OptionScope
 from libtmux.exc import OptionError
-from libtmux.options import convert_values
+from libtmux.options import TerminalOverrides, convert_values
 from libtmux.pane import Pane
 
 if t.TYPE_CHECKING:
@@ -301,6 +301,73 @@ def test_terminal_overrides(
     assert options_["terminal-overrides"]["xterm-256color"] == {"Tc": None}
 
 
+class TerminalOverridesMultiFeatureCase(t.NamedTuple):
+    """Test fixture for terminal-overrides with multiple features per terminal."""
+
+    test_id: str
+    raw_entry: str
+    expected_term: str
+    expected_features: dict[str, str | int | None]
+
+
+@pytest.mark.parametrize(
+    TerminalOverridesMultiFeatureCase._fields,
+    [
+        TerminalOverridesMultiFeatureCase(
+            test_id="two_flags",
+            raw_entry="xterm*:smcup@:rmcup@",
+            expected_term="xterm*",
+            expected_features={"smcup@": None, "rmcup@": None},
+        ),
+        TerminalOverridesMultiFeatureCase(
+            test_id="flag_and_keyval",
+            raw_entry="xterm*:XT:Ms=clipboard",
+            expected_term="xterm*",
+            expected_features={"XT": None, "Ms": "clipboard"},
+        ),
+        TerminalOverridesMultiFeatureCase(
+            test_id="multiple_keyvals",
+            raw_entry="screen*:Tc:RGB:setab=test",
+            expected_term="screen*",
+            expected_features={
+                "Tc": None,
+                "RGB": None,
+                "setab": "test",
+            },
+        ),
+        TerminalOverridesMultiFeatureCase(
+            test_id="integer_value",
+            raw_entry="tmux*:colors=256:Tc",
+            expected_term="tmux*",
+            expected_features={"colors": 256, "Tc": None},
+        ),
+    ],
+    ids=lambda x: x.test_id if isinstance(x, TerminalOverridesMultiFeatureCase) else x,
+)
+def test_terminal_overrides_multi_feature(
+    server: Server,
+    monkeypatch: pytest.MonkeyPatch,
+    test_id: str,
+    raw_entry: str,
+    expected_term: str,
+    expected_features: dict[str, str | int | None],
+) -> None:
+    """Test terminal-overrides parsing with multiple features per terminal.
+
+    Per tmux.1 (lines 4311-4326), terminal-overrides entries are colon-separated
+    strings: terminal pattern followed by a LIST of features (not just one).
+    For example, 'xterm*:XT:Ms=value' should parse as two features: XT and Ms.
+    """
+    mock_options = [f"terminal-overrides[0] {raw_entry}"]
+    monkeypatch.setattr(server, "cmd", fake_cmd(stdout=mock_options))
+    options_ = server._show_options()
+
+    assert "terminal-overrides" in options_
+    term_overrides = t.cast(TerminalOverrides, options_["terminal-overrides"])
+    assert expected_term in term_overrides
+    assert term_overrides[expected_term] == expected_features
+
+
 def test_command_alias(
     server: Server,
     monkeypatch: pytest.MonkeyPatch,