@perspective-dev/viewer 4.0.0

package/src/rust/utils/browser/blob.rs

@@ -0,0 +1,49 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use perspective_js::utils::ApiResult;
+
+pub trait AsBlob {
+    /// Standardized conversions from common `wasm_bindgen` types to
+    /// `js_sys::Blob`, which is commonly necessary to provide data to a
+    /// download or clipboard action.
+    fn as_blob(&self) -> ApiResult<web_sys::Blob>;
+}
+
+impl AsBlob for js_sys::ArrayBuffer {
+    fn as_blob(&self) -> ApiResult<web_sys::Blob> {
+        let array = std::iter::once(js_sys::Uint8Array::new(self)).collect::<js_sys::Array>();
+        Ok(web_sys::Blob::new_with_u8_array_sequence(&array)?)
+    }
+}
+
+impl AsBlob for js_sys::JsString {
+    fn as_blob(&self) -> ApiResult<web_sys::Blob> {
+        let array = std::iter::once(self).collect::<js_sys::Array>();
+        let options = web_sys::BlobPropertyBag::new();
+        options.set_type("text/plain");
+        Ok(web_sys::Blob::new_with_str_sequence_and_options(
+            &array, &options,
+        )?)
+    }
+}
+
+impl AsBlob for js_sys::Object {
+    fn as_blob(&self) -> ApiResult<web_sys::Blob> {
+        let array = std::iter::once(js_sys::JSON::stringify(self)?).collect::<js_sys::Array>();
+        let options = web_sys::BlobPropertyBag::new();
+        options.set_type("text/plain");
+        Ok(web_sys::Blob::new_with_str_sequence_and_options(
+            &array, &options,
+        )?)
+    }
+}

package/src/rust/utils/browser/download.rs

@@ -0,0 +1,26 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use perspective_js::utils::{global, *};
+use wasm_bindgen::JsCast;
+
+pub fn download(name: &str, value: &web_sys::Blob) -> ApiResult<()> {
+    let element: web_sys::HtmlElement = global::document().create_element("a")?.unchecked_into();
+    let blob_url = web_sys::Url::create_object_url_with_blob(value)?;
+    element.set_attribute("download", name)?;
+    element.set_attribute("href", &blob_url)?;
+    element.style().set_property("display", "none")?;
+    global::body().append_child(&element)?;
+    element.click();
+    global::body().remove_child(&element)?;
+    Ok(())
+}

package/src/rust/utils/browser/mod.rs

@@ -0,0 +1,24 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+mod blob;
+mod download;
+mod request_animation_frame;
+mod selection;
+
+#[cfg(test)]
+mod tests;
+
+pub use blob::*;
+pub use download::*;
+pub use request_animation_frame::*;
+pub use selection::*;

package/src/rust/utils/browser/request_animation_frame.rs

@@ -0,0 +1,76 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use ::futures::channel::oneshot::*;
+use perspective_js::utils::{global, *};
+use wasm_bindgen::prelude::*;
+
+/// An `async` version of `queueMicrotask()`, curiously absent from [`web_sys`].
+pub async fn await_queue_microtask() -> ApiResult<()> {
+    #[wasm_bindgen]
+    extern "C" {
+        #[wasm_bindgen(js_name = Window)]
+        type QMWindow;
+
+        #[wasm_bindgen(catch, method, structural, js_class = "Window", js_name = queueMicrotask)]
+        fn queue_microtask(this: &QMWindow, callback: &::js_sys::Function) -> Result<i32, JsValue>;
+    }
+
+    let (sender, receiver) = channel::<()>();
+    let jsfun = Closure::once_into_js(move || sender.send(()).unwrap());
+    js_sys::global()
+        .dyn_into::<QMWindow>()
+        .unwrap()
+        .queue_microtask(jsfun.unchecked_ref())?;
+
+    Ok(receiver.await?)
+}
+
+/// An `async` version of `requestAnimationFrame()`, which resolves on the next
+/// animation frame.
+pub async fn request_animation_frame() {
+    let (sender, receiver) = channel::<()>();
+    let jsfun = Closure::once_into_js(move || sender.send(()).unwrap());
+    global::window()
+        .request_animation_frame(jsfun.unchecked_ref())
+        .unwrap();
+
+    receiver.await.unwrap()
+}
+
+/// An `async` which awaits the browser's `load` event, which is automatically
+/// bypassed if `document.readyState` indicates this has already occurred.
+pub async fn await_dom_loaded() -> ApiResult<()> {
+    let state = global::document().ready_state();
+    if state == "complete" || state == "loaded" {
+        Ok(())
+    } else {
+        let (sender, receiver) = channel::<()>();
+        let jsfun = Closure::once_into_js(move || sender.send(()).unwrap());
+        global::window().add_event_listener_with_callback("load", jsfun.unchecked_ref())?;
+        Ok(receiver.await?)
+    }
+}
+
+/// An `async` version of `set_timeout`, which resolves in `timeout`
+/// milliseconds
+pub async fn set_timeout(timeout: i32) -> ApiResult<()> {
+    let (sender, receiver) = channel::<()>();
+    let jsfun = Closure::once_into_js(move || {
+        let _ = sender.send(());
+    });
+
+    global::window()
+        .set_timeout_with_callback_and_timeout_and_arguments_0(jsfun.unchecked_ref(), timeout)?;
+
+    Ok(receiver.await?)
+}

package/src/rust/utils/browser/selection.rs

@@ -0,0 +1,79 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use perspective_js::utils::global;
+use wasm_bindgen::JsCast;
+
+use crate::*;
+
+/// Utilities for caret position.  DOM elements have different APIs for this
+/// but `Deref` makes them fall through, so it is important that this method
+/// be called on the correct struct type!
+pub trait CaretPosition {
+    fn select_all(&self) -> ApiResult<()>;
+    fn set_caret_position(&self, offset: usize) -> ApiResult<()>;
+    fn get_caret_position(&self) -> Option<u32>;
+}
+
+impl CaretPosition for web_sys::HtmlElement {
+    fn select_all(&self) -> ApiResult<()> {
+        let range = global::document().create_range()?;
+        let selection = global::window().get_selection()?.into_apierror()?;
+        range.set_start(self, 0_u32)?;
+        range.set_end(self, 10000000_u32)?;
+        selection.remove_all_ranges()?;
+        selection.add_range(&range)?;
+        Ok(())
+    }
+
+    fn set_caret_position(&self, offset: usize) -> ApiResult<()> {
+        let range = global::document().create_range()?;
+        let selection = global::window().get_selection()?.into_apierror()?;
+        range.set_start(self, offset as u32)?;
+        range.collapse_with_to_start(true);
+        selection.remove_all_ranges()?;
+        selection.add_range(&range)?;
+        Ok(())
+    }
+
+    fn get_caret_position(&self) -> Option<u32> {
+        maybe! {
+            let root = self.get_root_node().unchecked_into::<web_sys::Document>();
+            let selection = root.get_selection()?.into_apierror()?;
+            if selection.range_count() > 0 {
+                let range = selection.get_range_at(0)?;
+                range.end_offset()
+            } else {
+                Err(wasm_bindgen::JsValue::UNDEFINED)
+            }
+        }
+        .ok()
+    }
+}
+
+impl CaretPosition for web_sys::HtmlTextAreaElement {
+    fn select_all(&self) -> ApiResult<()> {
+        self.set_selection_start(Some(0_u32))?;
+        self.set_selection_end(Some(1000000000_u32))?;
+        Ok(())
+    }
+
+    fn set_caret_position(&self, offset: usize) -> ApiResult<()> {
+        self.set_selection_end(Some(offset as u32))?;
+        self.set_selection_start(Some(offset as u32))?;
+        Ok(())
+    }
+
+    fn get_caret_position(&self) -> Option<u32> {
+        self.selection_end().ok()?
+    }
+}

package/src/rust/utils/browser/tests/debounce.rs

@@ -0,0 +1,114 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use std::cell::Cell;
+use std::rc::Rc;
+
+use futures::channel::oneshot::*;
+use futures::future::join_all;
+use wasm_bindgen_futures::spawn_local;
+use wasm_bindgen_test::*;
+
+use super::super::request_animation_frame::set_timeout;
+use crate::utils::debounce::*;
+
+#[wasm_bindgen_test]
+pub async fn test_lock() {
+    let debounce_mutex = DebounceMutex::default();
+    let cell = Rc::new(Cell::new(0));
+    let (sender, receiver) = channel::<bool>();
+    spawn_local({
+        let cell = cell.clone();
+        let debounce_mutex = debounce_mutex.clone();
+        async move {
+            debounce_mutex
+                .lock(async {
+                    cell.set(1);
+                    set_timeout(10).await.unwrap();
+                    cell.set(2);
+                })
+                .await
+        }
+    });
+
+    spawn_local({
+        let cell = cell.clone();
+        let debounce_mutex = debounce_mutex.clone();
+        async move {
+            debounce_mutex
+                .lock(async {
+                    for _ in 0..10 {
+                        set_timeout(1).await.unwrap();
+                        if cell.get() == 1 {
+                            sender.send(false).unwrap();
+                            return;
+                        }
+                    }
+                    sender.send(cell.get() == 2).unwrap();
+                })
+                .await
+        }
+    });
+
+    assert!(receiver.await.unwrap());
+}
+
+#[wasm_bindgen_test]
+pub async fn test_lock_seq() {
+    let debounce_mutex = DebounceMutex::default();
+    let cell: Rc<Cell<u32>> = Rc::new(Cell::new(0));
+
+    let tasks = (0..10)
+        .map(|_| {
+            let cell = cell.clone();
+            let debounce_mutex = debounce_mutex.clone();
+            async move {
+                debounce_mutex
+                    .lock(async {
+                        set_timeout(10).await.unwrap();
+                        cell.set(cell.get() + 1);
+                    })
+                    .await;
+            }
+        })
+        .collect::<Vec<_>>();
+
+    assert_eq!(join_all(tasks).await.len(), 10);
+    assert_eq!(cell.get(), 10);
+}
+
+#[wasm_bindgen_test]
+pub async fn test_debounce_seq() {
+    let debounce_mutex = DebounceMutex::default();
+    let cell: Rc<Cell<u32>> = Rc::new(Cell::new(0));
+
+    let tasks = (0..10)
+        .map(|_| {
+            let cell = cell.clone();
+            let debounce_mutex = debounce_mutex.clone();
+            async move {
+                debounce_mutex
+                    .debounce(async {
+                        set_timeout(10).await.unwrap();
+                        cell.set(cell.get() + 1);
+                        Ok(())
+                    })
+                    .await
+                    .unwrap();
+            }
+        })
+        .collect::<Vec<_>>();
+
+    assert_eq!(join_all(tasks).await.len(), 10);
+    assert!(cell.get() < 10);
+    assert!(cell.get() > 0);
+}

package/src/rust/utils/browser/tests/mod.rs

@@ -0,0 +1,13 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+mod debounce;

package/src/rust/utils/custom_element.rs

@@ -0,0 +1,85 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use wasm_bindgen::prelude::*;
+
+pub trait CustomElementMetadata {
+    const CUSTOM_ELEMENT_NAME: &'static str;
+    const STATICS: &'static [&'static str] = [].as_slice();
+    const TYPE_NAME: &'static str = std::any::type_name::<Self>();
+
+    fn struct_name() -> &'static str {
+        match &Self::TYPE_NAME.rfind(':') {
+            Some(pos) => &Self::TYPE_NAME[pos + 1..],
+            None => Self::TYPE_NAME,
+        }
+    }
+}
+
+#[wasm_bindgen(inline_js = r#"
+    export function bootstrap(psp, name, clsname, statics) {
+        const cls = psp[clsname];
+        const proto = cls.prototype;
+        class x extends HTMLElement {
+            constructor() {
+                super();
+                this._instance = new cls(this);
+            }
+        }
+
+        const names = Object.getOwnPropertyNames(proto);
+        for (const key of names) {
+            if ('get' in Object.getOwnPropertyDescriptor(proto, key)) {
+                Object.defineProperty(x.prototype, key, {
+                    get: function() {
+                        return this._instance[key];
+                    }
+                });
+            } else {
+                Object.defineProperty(x.prototype, key, {
+                    value: function(...args) {
+                        return this._instance[key].call(this._instance, ...args);
+                    }
+                });
+            }
+        }
+
+        for (const key of statics) {
+            Object.defineProperty(x, key, {
+                value: function(...args) {
+                    return psp[key].call(psp, ...args);
+                }
+            });
+        }
+
+        Object.defineProperty(x, '__wasm_module__', {
+            get() {
+                return psp;
+            },
+        });
+
+        customElements.define(name, x);
+    }
+"#)]
+extern "C" {
+    #[wasm_bindgen(js_name = "bootstrap")]
+    fn js_bootstrap(psp: &JsValue, name: &str, cls: &str, statics: js_sys::Array) -> JsValue;
+}
+
+pub fn define_web_component<T: CustomElementMetadata>(module: &JsValue) {
+    js_bootstrap(
+        module,
+        T::CUSTOM_ELEMENT_NAME,
+        T::struct_name(),
+        T::STATICS.iter().cloned().map(JsValue::from).collect(),
+    );
+}

package/src/rust/utils/datetime.rs

@@ -0,0 +1,49 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use chrono::{DateTime, FixedOffset, NaiveDateTime, TimeZone, Utc};
+use perspective_js::utils::*;
+use wasm_bindgen::prelude::*;
+
+fn input_value_format(x: &str) -> Result<&str, JsValue> {
+    match x.len() {
+        23 => Ok("%Y-%m-%dT%H:%M:%S%.3f"),
+        19 => Ok("%Y-%m-%dT%H:%M:%S"),
+        16 => Ok("%Y-%m-%dT%H:%M"),
+        _ => Err(format!("Unknown format {x}").into()),
+    }
+}
+
+fn get_local_tz() -> FixedOffset {
+    FixedOffset::west_opt(js_sys::Date::new(&0.into()).get_timezone_offset() as i32 * 60).unwrap()
+}
+
+pub fn posix_to_utc_str(x: f64) -> ApiResult<String> {
+    let tz = get_local_tz();
+    if x > 0_f64 {
+        Ok(Utc
+            .timestamp_opt(x as i64 / 1000, ((x as i64 % 1000) * 1000000) as u32)
+            .earliest()
+            .into_apierror()?
+            .with_timezone(&tz)
+            .format("%Y-%m-%dT%H:%M:%S%.3f")
+            .to_string())
+    } else {
+        Err(format!("Unknown timestamp {x}").into())
+    }
+}
+
+pub fn str_to_utc_posix(val: &str) -> Result<f64, ApiError> {
+    let tz = get_local_tz();
+    let posix = NaiveDateTime::parse_from_str(val, input_value_format(val)?)?;
+    Ok(DateTime::<Utc>::from(tz.from_local_datetime(&posix).unwrap()).timestamp_millis() as f64)
+}

package/src/rust/utils/debounce.rs

@@ -0,0 +1,54 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use std::cell::Cell;
+use std::future::Future;
+use std::rc::Rc;
+
+use async_lock::Mutex;
+use perspective_js::utils::ApiResult;
+
+#[derive(Default)]
+pub struct DebounceMutexData {
+    id: Cell<u64>,
+    mutex: Mutex<u64>,
+}
+
+#[derive(Clone, Default)]
+pub struct DebounceMutex(Rc<DebounceMutexData>);
+
+impl DebounceMutex {
+    pub async fn lock<T>(&self, f: impl Future<Output = T>) -> T {
+        let mut last = self.0.mutex.lock().await;
+        let next = self.0.id.get();
+        let result = f.await;
+        *last = next;
+        result
+    }
+
+    pub async fn debounce(&self, f: impl Future<Output = ApiResult<()>>) -> ApiResult<()> {
+        let next = self.0.id.get() + 1;
+        let mut last = self.0.mutex.lock().await;
+        if *last < next {
+            let next = self.0.id.get() + 1;
+            self.0.id.set(next);
+            let result = f.await;
+            if result.is_ok() {
+                *last = next;
+            }
+
+            result
+        } else {
+            Ok(())
+        }
+    }
+}

package/src/rust/utils/hooks/mod.rs

@@ -0,0 +1,15 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+mod use_async_callback;
+
+pub use use_async_callback::*;