feat(ironrdp-web): iron-remote-desktop helper crate for remote desktop WASM modules (#755)

Author: RRRadicalEdward

Cargo.lock

@@ -0,0 +1,32 @@
+[package]
+name = "iron-remote-desktop"
+version = "0.1.0"
+edition.workspace = true
+license.workspace = true
+homepage.workspace = true
+repository.workspace = true
+authors.workspace = true
+keywords.workspace = true
+categories.workspace = true
+
+[features]
+panic_hook = ["dep:console_error_panic_hook"]
+
+[dependencies]
+# WASM
+wasm-bindgen = "0.2"
+web-sys = { version = "0.3", features = ["HtmlCanvasElement"] }
+tracing-web = "0.1"
+
+# The `console_error_panic_hook` crate provides better debugging of panics by
+# logging them with `console.error`. This is great for development, but requires
+# all the `std::fmt` and `std::panicking` infrastructure, so isn't great for
+# code size when deploying.
+console_error_panic_hook = { version = "0.1", optional = true }
+
+# Logging
+tracing = { version = "0.1", features = ["log"] }
+tracing-subscriber = { version = "0.3", features = ["time"] }
+
+[lints]
+workspace = true

crates/iron-remote-desktop/Cargo.toml

@@ -0,0 +1,18 @@
+use wasm_bindgen::JsValue;
+use web_sys::js_sys;
+
+pub trait ClipboardTransaction {
+    type ClipboardContent: ClipboardContent;
+
+    fn init() -> Self;
+    fn add_content(&mut self, content: Self::ClipboardContent);
+    fn is_empty(&self) -> bool;
+    fn contents(&self) -> js_sys::Array;
+}
+
+pub trait ClipboardContent {
+    fn new_text(mime_type: &str, text: &str) -> Self;
+    fn new_binary(mime_type: &str, binary: &[u8]) -> Self;
+    fn mime_type(&self) -> &str;
+    fn value(&self) -> JsValue;
+}

crates/iron-remote-desktop/src/clipboard.rs

@@ -0,0 +1,10 @@
+#[derive(Debug)]
+pub enum CursorStyle {
+    Default,
+    Hidden,
+    Url {
+        data: String,
+        hotspot_x: u16,
+        hotspot_y: u16,
+    },
+}

crates/iron-remote-desktop/src/cursor.rs

@@ -0,0 +1,23 @@
+use wasm_bindgen::prelude::*;
+
+pub trait IronError {
+    fn backtrace(&self) -> String;
+    fn kind(&self) -> IronErrorKind;
+}
+
+#[derive(Clone, Copy)]
+#[wasm_bindgen]
+pub enum IronErrorKind {
+    /// Catch-all error kind
+    General,
+    /// Incorrect password used
+    WrongPassword,
+    /// Unable to login to machine
+    LogonFailure,
+    /// Insufficient permission, server denied access
+    AccessDenied,
+    /// Something wrong happened when sending or receiving the RDCleanPath message
+    RDCleanPath,
+    /// Couldn’t connect to proxy
+    ProxyConnect,
+}

crates/iron-remote-desktop/src/error.rs

@@ -0,0 +1,17 @@
+pub trait DeviceEvent {
+    fn mouse_button_pressed(button: u8) -> Self;
+    fn mouse_button_released(button: u8) -> Self;
+    fn mouse_move(x: u16, y: u16) -> Self;
+    fn wheel_rotations(vertical: bool, rotation_units: i16) -> Self;
+    fn key_pressed(scancode: u16) -> Self;
+    fn key_released(scancode: u16) -> Self;
+    fn unicode_pressed(unicode: char) -> Self;
+    fn unicode_released(unicode: char) -> Self;
+}
+
+pub trait InputTransaction {
+    type DeviceEvent: DeviceEvent;
+
+    fn init() -> Self;
+    fn add_event(&mut self, event: Self::DeviceEvent);
+}