📝 Add docstrings to right-click-action

frontend/src-tauri/src/main.rs

@@ -6,23 +6,115 @@ mod services;
 use tauri::path::BaseDirectory;
 use tauri::Manager;
 
+// -------- Clipboard imports --------
+use tauri::command;
+use tauri::AppHandle;
+use std::path::PathBuf;
+use arboard::{Clipboard, ImageData};
+use std::borrow::Cow;
+use image::GenericImageView;
+
+// -------- Clipboard command --------
+/// Copy an image file into the system clipboard.
+///
+/// Resolves `path` relative to the application's AppData directory, loads the image,
+/// converts it to RGBA, and places it on the system clipboard.
+///
+/// # Parameters
+///
+/// - `app`: Tauri application handle used to resolve the given path relative to the AppData directory.
+/// - `path`: File path to the image, interpreted relative to the AppData base directory.
+///
+/// # Returns
+///
+/// `Ok(())` on success; `Err(String)` on failure. Possible error messages include:
+/// - `"Invalid file path"` if the provided path cannot be resolved.
+/// - `"File does not exist"` if the resolved path is missing.
+/// - `"Image too large to copy to clipboard"` if the image exceeds the configured pixel limit.
+/// - Other errors returned as strings (e.g., image decoding or clipboard errors).
+///
+/// # Examples
+///
+/// ```ignore
+/// // `app_handle` is a `tauri::AppHandle` obtained in a Tauri command or setup.
+/// let _ = copy_image_to_clipboard(app_handle, "resources/images/logo.png".into())?;
+/// ```
+#[command]
+fn copy_image_to_clipboard(app: AppHandle, path: String) -> Result<(), String> {
+    let resolved: PathBuf = app
+        .path()
+        .resolve(&path, BaseDirectory::AppData)
+        .map_err(|_| "Invalid file path")?;
+
+    if !resolved.exists() {
+        return Err("File does not exist".into());
+    }
+
+    let img = image::open(&resolved).map_err(|e| e.to_string())?;
+
+    // Fix: Add a Size Limit
+    let (width, height) = img.dimensions();
+    const MAX_PIXELS: u32 = 30_000_000; // ~120MB RGBA
+
+    if width * height > MAX_PIXELS {
+        return Err("Image too large to copy to clipboard".into());
+    }
+
+    let rgba = img.to_rgba8();
+
+    let image_data = ImageData {
+        width: rgba.width() as usize,
+        height: rgba.height() as usize,
+        bytes: Cow::Owned(rgba.into_raw()),
+    };
+
+    let mut clipboard = Clipboard::new().map_err(|e| e.to_string())?;
+    clipboard
+        .set_image(image_data)
+        .map_err(|e| e.to_string())?;
+
+    Ok(())
+}
+
+/// Entry point that builds and runs the Tauri application with its plugins, setup hook, and command handlers.
+///
+/// The application is configured with the project's plugin set, a setup hook that resolves and prints a resource
+/// path, and registers invocation commands (including `services::get_server_path` and `copy_image_to_clipboard`).
+///
+/// # Examples
+///
+/// ```no_run
+/// // Starts the application (no-op in documentation tests)
+/// fn main() {
+///     crate::main()
+/// }
+/// ```
 fn main() {
     tauri::Builder::default()
+        // -------- Existing plugins (unchanged) --------
         .plugin(tauri_plugin_opener::init())
         .plugin(tauri_plugin_updater::Builder::new().build())
         .plugin(tauri_plugin_store::Builder::new().build())
         .plugin(tauri_plugin_shell::init())
         .plugin(tauri_plugin_fs::init())
         .plugin(tauri_plugin_dialog::init())
         .plugin(tauri_plugin_process::init())
+
+        // -------- Existing setup (unchanged) --------
         .setup(|app| {
             let resource_path = app
                 .path()
                 .resolve("resources/backend", BaseDirectory::Resource)?;
             println!("Resource path: {:?}", resource_path);
             Ok(())
         })
-        .invoke_handler(tauri::generate_handler![services::get_server_path,])
+
+        // -------- Register commands --------
+        .invoke_handler(tauri::generate_handler![
+            services::get_server_path,
+            copy_image_to_clipboard
+        ])
+
         .run(tauri::generate_context!())
         .expect("error while running tauri application");
-}
+}