feat(commands): context-menu operations, registry commands, Help menu; fixes

File context menu gains Copy / Move / Pack to Archive; the pane menu
gains Paste and Refresh, and "Open in Default App" is relabelled Reveal
in File Manager. directory_properties and open_config_file become
registry commands (palette, bindable, newt cmd). macOS gets a Help menu
with Documentation. Palette disambiguation: "Back (History)…" /
"Forward (History)…", distinct short names for send_to_terminal and
focus_terminal, focus commands moved to the Terminal category.

Fixes riding along: saving or deleting a connection refuses to proceed
when connections.toml exists but fails to parse, instead of treating it
as empty and writing back a one-entry list; the preferences watcher
compares resolved bindings and commands by value, so an in-place edit
of a [[bind]] entry reloads; the file server validates a remote object's
Content-Type before using it as a header; the drag ghost is built from
DOM nodes rather than innerHTML.

Author: tibordp

FEATURE_DUMP.md

@@ -73,7 +73,7 @@ Zoom is applied via the webview zoom factor and persisted app-wide in the runtim
 - **Close Window** (Mod+Shift+W): Closes the current window. Shifted (gnome-terminal convention) so a session window can't be closed on a stray Mod+W. Viewer/editor children can't outlive the session they were spawned from, so closing a main window takes them along: a Rust-side `CloseRequested` interceptor (covers the command, the menu item, and the OS close button alike) closes viewer children outright and sweeps editor children — dirty ones prompt, the window close resumes once the last child editor is gone, and refusing a prompt aborts the close.
 - **Quit Newt** (Mod+Q): Closes all main windows, exiting the app. Open editor windows are swept first so their unsaved-changes prompts fire: the quit waits (event-driven, via the `Destroyed` handler) for the last editor to close before the main windows go, and refusing any editor's prompt aborts the quit (`cancel_quit`), leaving all remaining windows open. Pre-warmed hidden editors are exempt from the sweep. OS-initiated termination (macOS Dock quit, logout) goes through the same sweep via an `applicationShouldTerminate:` method injected into tao's app delegate at runtime (`terminate_guard` in `main.rs` — tao doesn't implement the selector and `RunEvent::ExitRequested` never fires for OS termination, see tauri#9198): a dirty editor cancels the termination and runs the sweep, a clean app terminates immediately so it never blocks logout. Editor dirty state is mirrored to Rust for this via `set_editor_dirty`. The `ExitRequested { code: None }` handler remains as a safety net for the all-windows-closed path.
 - **Reload Window**: Available in the Debug dialog (debug builds only).
-- **Refresh File List** (Mod+R): Force-refreshes the active pane's directory listing.
+- **Refresh File List** (unbound by default — `mod+r` would be Quick Connect's Ctrl+R on Windows/Linux; palette, pane context menu): Force-refreshes the active pane's directory listing.
 
 Multiple main windows coexist in the same process: "New Window", remote connections, and elevated sessions all create additional windows within the running app. Each window has its own independent session, panes, terminals, and operations; closing the last main window exits the app.
 
@@ -85,6 +85,7 @@ Main windows carry a minimal native menu on macOS (Windows/Linux main windows ha
 - **File**: New Window, Connect to Remote Host…, Close Window.
 - **Edit**: predefined Cut/Copy/Paste/Select All (required so macOS routes Cmd+C/V/X/A to the webview — previously the sole content of the main-window menu).
 - **Window**: predefined Minimize, Zoom.
+- **Help**: Newt Documentation (`documentation`).
 
 Viewer and editor windows prepend an app submenu with Quit Newt (Cmd+Q) on macOS, so quit works whichever window is focused.
 
@@ -276,6 +277,7 @@ The default browser context menu is suppressed in the main window (but not in th
 | View | F3 |
 | Edit | F4 |
 | Copy Path | Mod+C |
+| Copy / Move / Pack to Archive | F5 / F6 / Alt+F5 |
 | Rename | F2 |
 | Delete | F8 |
 | Delete Permanently | Shift+Delete |
@@ -289,10 +291,12 @@ The Follow row appears only when it would do something: labelled "Reveal Source"
 
 | Item | Shortcut |
 |------|----------|
-| Open in Default App | Shift+F3 (host-local VFS only) |
+| Reveal in File Manager | Shift+F3 (host-local VFS only) |
 | New Directory | F7 |
 | New File | |
-| Directory Properties | |
+| Paste | Mod+V |
+| Refresh | (unbound) |
+| Directory Properties | (`directory_properties`, unbound) |
 | Windows Menu | Shift+RClick (Windows host + host-local files only) |
 
 **Windows shell context menu** (Windows host, host-local files): the trailing "Windows Menu" item — or Shift+right-click to skip our menu entirely — pops the classic `IContextMenu` shell menu (not the Windows 11 abbreviated one) for the effective selection; on empty space (or the `..` row) it targets the current directory itself. Implementation (`main_window/shell_menu.rs`, `shell_context_menu` command): runs synchronously on the main thread (`TrackPopupMenuEx` pumps its own modal loop), `SHParseDisplayName` on de-verbatimed paths (`launch_cwd`) → parent `IShellFolder::GetUIObjectOf` → `QueryContextMenu` → `TrackPopupMenuEx(TPM_RETURNCMD)` → `InvokeCommand`, with the Tauri window temporarily subclassed to forward `WM_INITMENUPOPUP`/`WM_DRAWITEM`/`WM_MEASUREITEM`/`WM_MENUCHAR` to `IContextMenu2/3` so dynamic submenus ("Open with", "Send to") populate. User-cancelled verbs (`ERROR_CANCELLED`) are not errors; shell-side mutations (delete, rename, …) reach the pane through the directory watcher. In **elevated sessions** the menu is still built and invoked by the non-elevated UI process — items the desktop user can't read (e.g. `C:\Windows\System32\config\*`) fail at `SHParseDisplayName` with an error, and any verb that did run would run non-elevated. Deliberate: an agent-side menu (feasible for the UAC transport, which shares the interactive desktop) would invoke *every* verb elevated — "Open"/"Open with" silently spawning admin-token processes — which is why Explorer refuses to run elevated too. Power users who need shell verbs on admin-only files can just run `newt.exe` itself elevated.

src-tauri/src/cmd/mod.rs

@@ -482,6 +482,7 @@ async fn dispatch_registry_command_inner(
         "edit" => window::cmd_edit(ctx, pane).await?,
         "rename" => dialog::cmd_rename(ctx, pane)?,
         "properties" => dialog::cmd_properties(ctx, pane)?,
+        "directory_properties" => dialog::cmd_directory_properties(ctx, pane)?,
         "delete_selected" => operations::cmd_delete_selected(ctx, pane).await?,
         "delete_permanent" => operations::cmd_delete_permanent(ctx, pane).await?,
         "create_directory" => dialog::cmd_create_directory(ctx, pane)?,
@@ -525,6 +526,7 @@ async fn dispatch_registry_command_inner(
         "next_terminal" => terminal::cmd_next_terminal(ctx, pane)?,
         "prev_terminal" => terminal::cmd_prev_terminal(ctx, pane)?,
         "open_settings" => dialog::cmd_open_settings(ctx, pane)?,
+        "open_config_file" => preferences::cmd_open_config_file(ctx, pane)?,
         "command_palette" => dialog::cmd_command_palette(ctx, pane)?,
         "hot_paths" => dialog::cmd_hot_paths(ctx, pane)?,
         "user_commands" => dialog::cmd_user_commands(ctx, pane)?,
@@ -579,6 +581,7 @@ mod dispatch_tests {
             "edit",
             "rename",
             "properties",
+            "directory_properties",
             "delete_selected",
             "delete_permanent",
             "create_directory",
@@ -621,6 +624,7 @@ mod dispatch_tests {
             "next_terminal",
             "prev_terminal",
             "open_settings",
+            "open_config_file",
             "command_palette",
             "hot_paths",
             "user_commands",

src-tauri/src/connections.rs

@@ -205,13 +205,23 @@ pub fn list_connections(config_dir: &std::path::Path) -> Vec<ConnectionProfile>
     }
 }
 
+/// An absent file is an empty list; an unparsable one is an error, since
+/// the caller is about to write the list back.
+fn read_connections_file(path: &std::path::Path) -> Result<ConnectionsFile, Error> {
+    let content = match std::fs::read_to_string(path) {
+        Ok(content) => content,
+        Err(e) if e.kind() == std::io::ErrorKind::NotFound => return Ok(Default::default()),
+        Err(e) => return Err(Error::Custom(format!("{}: {e}", path.display()))),
+    };
+    toml::from_str(&content).map_err(|e| Error::Custom(format!("{}: {e}", path.display())))
+}
+
 pub fn save_connection(
     config_dir: &std::path::Path,
     profile: ConnectionProfile,
 ) -> Result<(), Error> {
     let path = connections_path(config_dir);
-    let content = std::fs::read_to_string(&path).unwrap_or_default();
-    let mut file: ConnectionsFile = toml::from_str(&content).unwrap_or_default();
+    let mut file = read_connections_file(&path)?;
 
     // Update existing or append
     if let Some(existing) = file.connections.iter_mut().find(|c| c.id == profile.id) {
@@ -227,8 +237,7 @@ pub fn save_connection(
 
 pub fn delete_connection(config_dir: &std::path::Path, id: &str) -> Result<(), Error> {
     let path = connections_path(config_dir);
-    let content = std::fs::read_to_string(&path).unwrap_or_default();
-    let mut file: ConnectionsFile = toml::from_str(&content).unwrap_or_default();
+    let mut file = read_connections_file(&path)?;
 
     file.connections.retain(|c| c.id != id);
 

src-tauri/src/file_server.rs

@@ -139,9 +139,11 @@ async fn serve_file(
         }
     };
 
+    // The type may come verbatim from a remote object's Content-Type.
     let mime = details
         .mime_type
-        .unwrap_or_else(|| "application/octet-stream".to_string());
+        .and_then(|m| header::HeaderValue::from_str(&m).ok())
+        .unwrap_or(header::HeaderValue::from_static("application/octet-stream"));
     let file_size = details.size;
 
     let range_header = headers

src-tauri/src/main_window/menu.rs

@@ -114,9 +114,22 @@ fn build(app_handle: &AppHandle, label: &str) -> Result<Menu<Wry>, Error> {
         ],
     )?;
 
+    let help_submenu = Submenu::with_items(
+        app_handle,
+        "Help",
+        true,
+        &[&cmd_item("documentation", "Newt Documentation")?],
+    )?;
+
     Ok(Menu::with_items(
         app_handle,
-        &[&app_submenu, &file_submenu, &edit_submenu, &window_submenu],
+        &[
+            &app_submenu,
+            &file_submenu,
+            &edit_submenu,
+            &window_submenu,
+            &help_submenu,
+        ],
     )?)
 }
 

src-tauri/src/preferences/commands.rs

@@ -211,6 +211,16 @@ pub fn default_commands() -> Vec<CommandDef> {
             needs_pane: true,
             scope: CommandScope::Main,
         },
+        CommandDef {
+            id: "directory_properties".into(),
+            name: "Directory Properties...".into(),
+            short_name: None,
+            category: "File".into(),
+            default_keys: vec![],
+            default_when: Some("pane_focused".into()),
+            needs_pane: true,
+            scope: CommandScope::Main,
+        },
         CommandDef {
             id: "delete_selected".into(),
             name: "Delete Selected".into(),
@@ -330,7 +340,7 @@ pub fn default_commands() -> Vec<CommandDef> {
         },
         CommandDef {
             id: "history_back".into(),
-            name: "Back...".into(),
+            name: "Back (History)...".into(),
             short_name: None,
             category: "Navigation".into(),
             default_keys: vec!["alt+left".into()],
@@ -340,7 +350,7 @@ pub fn default_commands() -> Vec<CommandDef> {
         },
         CommandDef {
             id: "history_forward".into(),
-            name: "Forward...".into(),
+            name: "Forward (History)...".into(),
             short_name: None,
             category: "Navigation".into(),
             default_keys: vec!["alt+right".into()],
@@ -361,7 +371,7 @@ pub fn default_commands() -> Vec<CommandDef> {
         CommandDef {
             id: "send_to_terminal".into(),
             name: "Open in Terminal".into(),
-            short_name: Some("Terminal".into()),
+            short_name: Some("Open in Term".into()),
             category: "Terminal".into(),
             default_keys: vec!["mod+enter".into()],
             default_when: Some("pane_focused".into()),
@@ -675,7 +685,7 @@ pub fn default_commands() -> Vec<CommandDef> {
             id: "focus_panes".into(),
             name: "Focus File Panes".into(),
             short_name: Some("Panes".into()),
-            category: "Navigation".into(),
+            category: "Terminal".into(),
             default_keys: vec!["alt+up".into()],
             default_when: None,
             needs_pane: false,
@@ -684,8 +694,8 @@ pub fn default_commands() -> Vec<CommandDef> {
         CommandDef {
             id: "focus_terminal".into(),
             name: "Focus Terminal".into(),
-            short_name: Some("Terminal".into()),
-            category: "Navigation".into(),
+            short_name: Some("Focus Term".into()),
+            category: "Terminal".into(),
             default_keys: vec!["alt+down".into()],
             default_when: None,
             needs_pane: false,
@@ -731,6 +741,16 @@ pub fn default_commands() -> Vec<CommandDef> {
             needs_pane: false,
             scope: CommandScope::Main,
         },
+        CommandDef {
+            id: "open_config_file".into(),
+            name: "Open Settings File in Editor".into(),
+            short_name: None,
+            category: "File".into(),
+            default_keys: vec![],
+            default_when: None,
+            needs_pane: false,
+            scope: CommandScope::Main,
+        },
         CommandDef {
             id: "command_palette".into(),
             name: "Command Palette...".into(),

src-tauri/src/preferences/mod.rs

@@ -48,15 +48,15 @@ pub struct BookmarkAdded {
 }
 
 /// A resolved keybinding after `mod+` expansion and cascading.
-#[derive(Debug, Clone, serde::Serialize, specta::Type)]
+#[derive(Debug, Clone, PartialEq, serde::Serialize, specta::Type)]
 pub struct ResolvedBinding {
     pub key: String,
     pub command: String,
     pub when: Option<String>,
 }
 
 /// Command metadata for the command palette.
-#[derive(Debug, Clone, serde::Serialize, specta::Type)]
+#[derive(Debug, Clone, PartialEq, serde::Serialize, specta::Type)]
 pub struct CommandInfo {
     pub id: String,
     pub name: String,
@@ -629,10 +629,10 @@ impl PreferencesManager {
                 {
                     let mut guard = resolved.write();
                     if guard.settings != new_resolved.settings
-                        || guard.bindings.len() != new_resolved.bindings.len()
+                        || guard.bindings != new_resolved.bindings
                         || guard.bookmarks != new_resolved.bookmarks
                         || guard.user_commands != new_resolved.user_commands
-                        || guard.commands.len() != new_resolved.commands.len()
+                        || guard.commands != new_resolved.commands
                     {
                         *guard = new_resolved.clone();
                     } else {

src/main_window/ContextMenu.tsx

@@ -116,6 +116,33 @@ export function FileContextMenuContent({
 
         <CM.Separator className={styles.separator} />
 
+        <CM.Item
+          className={styles.item}
+          disabled={isParentDir}
+          onSelect={() => safe(ipc.cmdCopy(paneHandle))}
+        >
+          Copy
+          <Shortcut commands={commands} id="copy" />
+        </CM.Item>
+        <CM.Item
+          className={styles.item}
+          disabled={isParentDir}
+          onSelect={() => safe(ipc.cmdMove(paneHandle))}
+        >
+          Move
+          <Shortcut commands={commands} id="move" />
+        </CM.Item>
+        <CM.Item
+          className={styles.item}
+          disabled={isParentDir}
+          onSelect={() => safe(ipc.cmdCreateArchive(paneHandle))}
+        >
+          Pack to Archive
+          <Shortcut commands={commands} id="create_archive" />
+        </CM.Item>
+
+        <CM.Separator className={styles.separator} />
+
         <CM.Item
           className={styles.item}
           disabled={isParentDir}
@@ -193,7 +220,7 @@ export function PaneContextMenuContent({
               className={styles.item}
               onSelect={() => safe(ipc.cmdOpenFolder(paneHandle))}
             >
-              Open in Default App
+              Reveal in File Manager
               <Shortcut commands={commands} id="open_folder" />
             </CM.Item>
             <CM.Separator className={styles.separator} />
@@ -214,6 +241,20 @@ export function PaneContextMenuContent({
           New File
           <Shortcut commands={commands} id="create_file" />
         </CM.Item>
+        <CM.Item
+          className={styles.item}
+          onSelect={() => safe(ipc.cmdPasteFromClipboard(paneHandle))}
+        >
+          Paste
+          <Shortcut commands={commands} id="paste_from_clipboard" />
+        </CM.Item>
+        <CM.Item
+          className={styles.item}
+          onSelect={() => safe(ipc.cmdRefresh(paneHandle))}
+        >
+          Refresh
+          <Shortcut commands={commands} id="refresh" />
+        </CM.Item>
 
         <CM.Separator className={styles.separator} />
 
@@ -222,6 +263,7 @@ export function PaneContextMenuContent({
           onSelect={() => safe(ipc.cmdDirectoryProperties(paneHandle))}
         >
           Directory Properties
+          <Shortcut commands={commands} id="directory_properties" />
         </CM.Item>
 
         <ShellMenuItem onShellMenu={onShellMenu} />

src/main_window/Pane.tsx

@@ -1219,12 +1219,14 @@ function PaneInner(
         if (ghost) {
           if (dnd.files.length === 1) {
             const f = dnd.files[0];
-            if (f.is_dir) {
-              ghost.innerHTML = `<div class="file-icon folder"></div> ${f.name}`;
-            } else {
+            const icon = document.createElement("div");
+            icon.className = f.is_dir ? "file-icon folder" : "file-icon";
+            if (!f.is_dir) {
               const { ch, color } = getFileIconChar(f.name, f.is_dir);
-              ghost.innerHTML = `<div class="file-icon" style="color: ${color}">${ch}</div> ${f.name}`;
+              icon.style.color = color;
+              icon.textContent = ch;
             }
+            ghost.replaceChildren(icon, ` ${f.name}`);
           } else {
             ghost.textContent = `${dnd.files.length} items`;
           }