[i3wm] deprecate port ... actions in favor of standard desk ... actions (#2074)

Co-authored-by: Nicholas Riley <com-github@sabi.net>

Author: chdoc

BREAKING_CHANGES.txt

@@ -7,6 +7,7 @@ and when the change was applied given the delay between changes being
 submitted and the time they were reviewed and merged.
 
 ---
+* 2025-12-11 Deprecated i3wm commands `port [left | right | <number_small>]` in favour of standard `desk [left | right | <number_small>]` commands.
 * 2025-11-21 Deprecated i3wm commands `[grow | shrink | center] window` in favour of `(win | window) [grow | shrink | center] for consistency with other window commands.
 * 2025-10-12 Change the prefix for bitwise operators from `op bitwise` to `(bit | bitwise)`. Bitwise assignment operators have been moved to the `user.code_operators_bitwise` list.
 * 2025-09-04 Remove `user.c_keywords` list and capture to instead rely on the `user.code_keyword` and `user.code_keyword_unprefixed` lists for consistency.

apps/i3wm/i3wm.py

@@ -64,6 +64,17 @@ def switcher_focus(name: str):  # type: ignore
         # focus_on_window_activation is set to "smart" or "urgent"
         actions.user.i3msg('[urgent="latest"] focus')
 
+    # the default implementation considers desktops consecutively numbered
+    # this would be highly confusing given the numbering of i3wm workspaces
+    def desktop(number: int):  # type: ignore
+        actions.user.i3msg(f"workspace number {number}")
+
+    def desktop_next():
+        actions.user.i3msg(f"workspace next")
+
+    def desktop_last():
+        actions.user.i3msg(f"workspace prev")
+
 
 @mod.action_class
 class Actions:

apps/i3wm/i3wm.talon

@@ -2,14 +2,13 @@
 os: linux
 tag: user.i3wm
 -
+
 # Change the settings below, if your key combination for these actions differs from the defaults.
 # user.i3_launch_key = "super-d"
 # user.i3_terminal_key = "super-enter"
 
-port <number_small>: user.i3msg("workspace number {number_small}")
-(port flip | flipper): user.i3msg("workspace back_and_forth")
-port right: user.i3msg("workspace next")
-port left: user.i3msg("workspace prev")
+# Use the commands in desktops.talon to navigate between workspaces
+(desk flip | flipper): user.i3msg("workspace back_and_forth")
 
 (win | window) left: user.i3msg("focus left")
 (win | window) right: user.i3msg("focus right")
@@ -104,3 +103,16 @@ grow window [<number>]:
 shrink window [<number>]:
     user.deprecate_command("2025-11-21", "shrink window", "(win | window) shrink")
     user.i3wm_resize_window("shrink", number or 4, "height width")
+
+port <number_small>:
+    user.deprecate_command("2025-12-11", "port <number_small>", "desk <number_small>")
+    user.i3msg("workspace number {number_small}")
+port flip:
+    user.deprecate_command("2025-12-11", "port flip", "(desk flip | flipper)")
+    user.i3msg("workspace back_and_forth")
+port right:
+    user.deprecate_command("2025-12-11", "port right", "desk right")
+    user.i3msg("workspace next")
+port left:
+    user.deprecate_command("2025-12-11", "port left", "desk left")
+    user.i3msg("workspace prev")