Add a setting that disables the tab preview

With `preview_tabs` set to `false`, highlighting an entry in the quick
panel no longer switches to its tab; the selection is only applied when
the switch is committed.

Closes #11

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: FichteFoll

AGENTS.md

@@ -27,6 +27,7 @@
   It reuses an open instructions view (marked by the `tab_stack_setup_instructions` view setting) and selects it together with the source, instructions on the left.
   The plugin never runs `sudo`, a compiler or `setcap`; the user installs the helper to `keystate_helper_path` (default `/usr/local/libexec/tabstack-keystate`) with `cap_dac_read_search`, which the helper drops right after opening the input devices.
 - `tab_stack_open` arms a pending session, starts a Ctrl-release poller, and opens the quick panel after a short delay unless Ctrl is released first.
+- Highlighting a quick-panel entry previews its tab via `preview_entry`, unless `preview_tabs` is `false`; the selection is then only applied on commit.
 - Wrap-around cycling is implemented by intentionally closing and reopening the quick panel at the opposite boundary.
   That handoff keeps the session active and reuses the existing Ctrl-release poller.
 - `tab_stack.session_active` is the quick-panel session context key.

README.md

@@ -3,7 +3,7 @@
 TabStack is a [Sublime Text][] (build 4100+) package
 for switching between open tabs using an MRU-style stack.
 It keeps tab order per window
-and previews tabs in the quick panel
+and, optionally, previews tabs in the quick panel
 before committing the switch.
 It also preserves tab ordering across sessions
 and supports multiple selections.
@@ -39,6 +39,19 @@ Release `ctrl` to commit the selected tab.
 Press `ctrl+escape` to cancel.
 
 
+## Settings
+
+In `TabStack.sublime-settings`,
+which `Preferences: TabStack Settings` opens from the Command Palette:
+
+- `preview_tabs`:
+  set to `false` to stay on the current tab while moving through the quick panel.
+  The highlighted tab is then only shown once the switch is committed.
+
+The settings for the Ctrl-release helper
+are described under [Wayland Setup](#wayland-setup).
+
+
 ## Platform Support
 
 TabStack supports **Linux, Windows, and macOS**.

TabStack.sublime-settings

@@ -1,4 +1,8 @@
 {
+  // Switch to the highlighted tab while the quick panel is open.
+  // When `false`, the tab only changes once the switch is committed.
+  "preview_tabs": true,
+
   // Path to the `tabstack-keystate` helper that detects Ctrl releases on Linux.
   // It is used whenever it works, and it is required under native Wayland.
   "keystate_helper_path": "/usr/local/libexec/tabstack-keystate",

plugin/session.py

@@ -12,6 +12,8 @@
 CTRL_STATE_TIMEOUT_MS = 1000
 CTRL_STATE_RETRY_MS = 10
 
+_SETTINGS_FILE = "TabStack.sublime-settings"
+
 
 def _ensure_ctrl_release_poller(window: sublime.Window, state: TabStackWindowState) -> None:
     if state.ctrl_release_poller:
@@ -45,6 +47,8 @@ def show_panel(window: sublime.Window, state: TabStackWindowState) -> None:
         for entry in entries
     ]
 
+    preview_tabs = bool(sublime.load_settings(_SETTINGS_FILE).get("preview_tabs", True))
+
     def on_select(index: int) -> None:
         if index < 0:
             handle_panel_closed(window, state)
@@ -56,7 +60,8 @@ def on_highlight(index: int) -> None:
         if index < 0 or index >= len(entries):
             return
         state.session_selected_index = index
-        preview_entry(window, state)
+        if preview_tabs:
+            preview_entry(window, state)
 
     window.show_quick_panel(
         items,

sublime-package.json

@@ -7,6 +7,11 @@
           "$id": "sublime://settings/TabStack",
           "type": "object",
           "properties": {
+            "preview_tabs": {
+              "type": "boolean",
+              "default": true,
+              "markdownDescription": "Switch to the highlighted tab while the quick panel is open.\n\nWhen `false`, the tab only changes once the switch is committed."
+            },
             "keystate_helper_path": {
               "type": "string",
               "default": "/usr/local/libexec/tabstack-keystate",