Pane(feat[move]): add move() wrapping tmux move-pane directly

why: move-pane is a real tmux command (since 1.7) with its own cmd_entry.
While it shares exec with join-pane, it should be invocable directly.
what:
- Add Pane.move() calling tmux move-pane with vertical (-v/-h),
  detach (-d), full_window (-f), size (-l), before (-b) parameters
- Uses server.cmd with explicit -s/-t targeting
- Add test verifying pane moves between windows

Author: tony

src/libtmux/pane.py

@@ -1661,6 +1661,78 @@ def respawn(
         if proc.stderr:
             raise exc.LibTmuxException(proc.stderr)
 
+    def move(
+        self,
+        target: str | Pane | Window,
+        *,
+        vertical: bool = True,
+        detach: bool = True,
+        full_window: bool | None = None,
+        size: str | int | None = None,
+        before: bool | None = None,
+    ) -> None:
+        """Move this pane to another window via ``$ tmux move-pane``.
+
+        Similar to :meth:`join` but invokes the ``move-pane`` command directly.
+
+        Parameters
+        ----------
+        target : str, Pane, or Window
+            Target pane or window to move into.
+        vertical : bool, optional
+            Split vertically (``-v`` flag), default True. False for
+            horizontal (``-h``).
+        detach : bool, optional
+            Do not switch to the target window (``-d`` flag), default True.
+        full_window : bool, optional
+            Use the full window width/height (``-f`` flag).
+        size : str or int, optional
+            Size for the moved pane (``-l`` flag).
+        before : bool, optional
+            Place the pane before the target (``-b`` flag).
+
+        Examples
+        --------
+        >>> pane_to_move = window.split(shell='sleep 1m')
+        >>> w2 = session.new_window(window_name='move_target')
+        >>> pane_to_move.move(w2)
+        """
+        tmux_args: tuple[str, ...] = ()
+
+        if vertical:
+            tmux_args += ("-v",)
+        else:
+            tmux_args += ("-h",)
+
+        if detach:
+            tmux_args += ("-d",)
+
+        if full_window:
+            tmux_args += ("-f",)
+
+        if size is not None:
+            tmux_args += (f"-l{size}",)
+
+        if before:
+            tmux_args += ("-b",)
+
+        # Determine target ID
+        from libtmux.window import Window
+
+        if isinstance(target, Pane):
+            target_id = str(target.pane_id)
+        elif isinstance(target, Window):
+            target_id = str(target.window_id)
+        else:
+            target_id = target
+
+        tmux_args += ("-s", str(self.pane_id), "-t", target_id)
+
+        proc = self.server.cmd("move-pane", *tmux_args)
+
+        if proc.stderr:
+            raise exc.LibTmuxException(proc.stderr)
+
     def join(
         self,
         target: str | Pane | Window,

tests/test_pane.py

@@ -924,6 +924,25 @@ def test_respawn_pane_kill(session: Session) -> None:
     assert pane in window.panes
 
 
+def test_move_pane(session: Session) -> None:
+    """Test Pane.move() moves pane to another window."""
+    w1 = session.new_window(window_name="move_src")
+    pane = w1.active_pane
+    assert pane is not None
+    pane_to_move = pane.split(shell="sleep 1m")
+    assert len(w1.panes) == 2
+
+    w2 = session.new_window(window_name="move_dst")
+    initial_w2_panes = len(w2.panes)
+
+    pane_to_move.move(w2)
+
+    w1.refresh()
+    w2.refresh()
+    assert len(w1.panes) == 1
+    assert len(w2.panes) == initial_w2_panes + 1
+
+
 def test_join_pane(session: Session) -> None:
     """Test Pane.join() roundtrip with break_pane."""
     window = session.new_window(window_name="test_join")