refactor(tray): take a RoutingMode instead of a bare string

update_tray typed its mode as String, so the tray menu spelled out
"rules"/"global"/"custom" and the webview cast the click payload back.
The menu now iterates the enum and derives each id from its wire value,
with an exhaustive match that fails to compile if a variant gains no
label; the webview resolves the payload against the generated list.

Author: loss-and-quick

frontend/src/generated/bindings.ts

@@ -25,7 +25,7 @@ export const commands = {
 	 *  calls this on hydrate and whenever the active/recent profiles or language
 	 *  change; clicks come back as [`TrayAction`] events (or `show`/`quit`).
 	 */
-	updateTray: (profiles: TrayProfile[], labels: TrayLabels, running: boolean, connected: boolean, routingMode: string) => typedError<null, string>(__TAURI_INVOKE("update_tray", { profiles, labels, running, connected, routingMode })),
+	updateTray: (profiles: TrayProfile[], labels: TrayLabels, running: boolean, connected: boolean, routingMode: RoutingMode_Deserialize) => typedError<null, string>(__TAURI_INVOKE("update_tray", { profiles, labels, running, connected, routingMode })),
 	/**
 	 *  Update only the tray tooltip + state icon (not the menu). Called on every status
 	 *  tick, so it stays cheap: the menu is rebuilt separately via [`update_tray`] only

frontend/src/lib/useTraySync.ts

@@ -8,7 +8,8 @@
 // ============================================================
 
 import { useEffect } from "react";
-import { commands, events, type RoutingMode_Serialize } from "../generated/bindings";
+import { commands, events } from "../generated/bindings";
+import { ROUTING_MODE_OPTS } from "../generated/defaults";
 import { useT } from "../i18n";
 import { isServiceUp } from "../lib/bridge";
 import { formatRate } from "../lib/format";
@@ -111,8 +112,10 @@ export function useTraySync(): void {
       if (action === "start" || action === "stop") void toggleService();
       else if (action === "restart") void restart();
       else if (action.startsWith("activate:")) void setActive(action.slice("activate:".length));
-      else if (action.startsWith("routing:"))
-        void setSetting("routingMode", action.slice("routing:".length) as RoutingMode_Serialize);
+      else if (action.startsWith("routing:")) {
+        const mode = ROUTING_MODE_OPTS.find((m) => m === action.slice("routing:".length));
+        if (mode) void setSetting("routingMode", mode);
+      }
     });
     return () => void pending.then((un) => un()).catch(() => {});
   }, [toggleService, restart, setActive, setSetting]);

src-tauri/src/lib.rs

@@ -20,6 +20,8 @@ use tauri_specta::{Builder, Event, collect_commands, collect_events};
 use kasumi_backend::platform::Platform;
 use kasumi_backend::{Command, Response, Service};
 use kasumi_core::contract::{PushFrame, RunState, ServiceStatus, SubAppliedEvent};
+use kasumi_core::enums::wire_value;
+use kasumi_core::state::RoutingMode;
 
 pub mod defaults;
 pub mod desktop;
@@ -78,11 +80,11 @@ fn update_tray(
     labels: TrayLabels,
     running: bool,
     connected: bool,
-    routing_mode: String,
+    routing_mode: RoutingMode,
 ) -> Result<(), String> {
     #[cfg(desktop)]
     {
-        rebuild_tray_menu(&app, &profiles, &labels, running, connected, &routing_mode)
+        rebuild_tray_menu(&app, &profiles, &labels, running, connected, routing_mode)
             .map_err(|e| e.to_string())?;
     }
     #[cfg(not(desktop))]
@@ -232,8 +234,9 @@ fn rebuild_tray_menu(
     labels: &TrayLabels,
     running: bool,
     connected: bool,
-    routing_mode: &str,
+    routing_mode: RoutingMode,
 ) -> tauri::Result<()> {
+    use strum::IntoEnumIterator;
     use tauri::menu::{CheckMenuItem, Menu, MenuItem, PredefinedMenuItem, Submenu};
 
     let Some(tray) = app.tray_by_id("main") else {
@@ -281,18 +284,21 @@ fn rebuild_tray_menu(
     // Routing-mode radio: exactly the current mode is checked. Tauri has no native
     // radio item, so — like v2rayN's tray — we use check marks; clicks come back as
     // `routing:<mode>` TrayActions the webview applies to `settings.routingMode`.
+    // Ids come from each variant's wire value, and the match below is exhaustive, so
+    // a new RoutingMode variant fails to compile until it is given a label here.
     let routing = Submenu::with_id(app, "routing", &labels.routing, true)?;
-    for (mode, label) in [
-        ("rules", &labels.routing_rules),
-        ("global", &labels.routing_global),
-        ("custom", &labels.routing_custom),
-    ] {
+    for mode in RoutingMode::iter() {
+        let label = match mode {
+            RoutingMode::Rules => &labels.routing_rules,
+            RoutingMode::Global => &labels.routing_global,
+            RoutingMode::Custom => &labels.routing_custom,
+        };
         let item = CheckMenuItem::with_id(
             app,
-            format!("routing:{mode}"),
+            format!("routing:{}", wire_value(&mode)),
             label,
             true,
-            routing_mode == mode,
+            mode == routing_mode,
             None::<&str>,
         )?;
         routing.append(&item)?;