workflow-wasm 0.19.0

//!
//! Helper trait for managing options struct which extends [Object](js_sys::Object)
//! ```ignore
//! # use wasm_bindgen::JsValue;
//! # use crate::workflow_wasm::options::OptionsTrait;
//! // create MyOptions struct
//!
//! #[wasm_bindgen]
//! extern "C" {
//!     #[derive(Debug, Clone, PartialEq, Eq)]
//!     #[wasm_bindgen(extends = js_sys::Object)]
//!     pub type MyOptions;
//! }
//!
//!
//! impl OptionsTrait for MyOptions{}
//!
//! //impl methods as you need
//! impl MyOptions{
//!     /// Set title
//!     pub fn title(self, title:&str)->Self{
//!         self.set("title", JsValue::from(title))
//!     }
//!
//!     /// Set active
//!     pub fn active(self, active:bool)->Self{
//!         self.set("active", JsValue::from(active))
//!     }
//! }
//!
//! // use MyOptions
//!
//! let options = MyOptions::new()
//!     .title("title text")
//!     .active(true);
//!
//! ```
//!

use js_sys::Object;
use wasm_bindgen::prelude::*;

/// Trait for building JavaScript options objects, providing convenience
/// methods to construct an empty object and set (optionally nested) values
/// on it in a builder style.
pub trait OptionsTrait {
    /// "Construct a new `Options`.
    ///
    fn new() -> Self
    where
        Self: wasm_bindgen::JsCast,
    {
        #[allow(unused_mut)]
        let mut ret: Self = ::wasm_bindgen::JsCast::unchecked_into(Object::new());
        ret = ret.initialize();
        ret
    }

    /// Hook for initializing a freshly constructed options object. The
    /// default implementation returns `self` unchanged; implementors may
    /// override it to set default values.
    fn initialize(self) -> Self
    where
        Self: wasm_bindgen::JsCast,
    {
        self
    }

    /// Sets a value on the options object under the given key. Dot-separated
    /// keys (e.g. `"a.b.c"`) traverse and create nested objects as needed.
    /// Returns `self` to allow builder-style chaining.
    fn set(self, mut key: &str, value: JsValue) -> Self
    where
        Self: wasm_bindgen::JsCast,
    {
        let mut target = self.as_ref().clone();

        if key.contains('.') {
            let mut name_parts: Vec<&str> = key.split('.').collect();
            key = name_parts.pop().unwrap();

            for name in name_parts {
                //log_info!("name: {}, target: {:?}", name, target);
                let r = ::js_sys::Reflect::get(&target, &JsValue::from(name));

                match r {
                    Ok(r) => {
                        if !r.is_undefined() {
                            target = r
                        } else {
                            let object = Object::new();
                            let new_target = JsValue::from(object);
                            //log_info!("new_target: {:?}", new_target);
                            let _ =
                                ::js_sys::Reflect::set(&target, &JsValue::from(name), &new_target);

                            target = new_target;
                        }
                    }
                    Err(err) => {
                        panic!("OptionsExt::set(): unable to find property `{name}`, err: {err:?}");
                    }
                }
            }

            //log_info!("final: key: {}, target: {:?}", key, target);
        }

        let r = ::js_sys::Reflect::set(&target, &JsValue::from(key), &value);
        debug_assert!(
            r.is_ok(),
            "setting properties should never fail on our dictionary objects"
        );
        let _ = r;

        self
    }
}

/*
#[cfg(test)]
mod test{
    use super::*;
    use crate as workflow_wasm;
    #[test]
    fn test(){
        #[wasm_bindgen]
        extern "C" {
            #[wasm_bindgen(extends = js_sys::Object)]
            #[derive(Debug, Clone, PartialEq, Eq)]
            pub type MyOptions;
        }

        impl workflow_wasm::options::OptionsTrait for MyOptions{}

        //impl methods as you need
        impl MyOptions{
            /// Set title
            pub fn title(self, title:&str)->Self{
                self.set("title", JsValue::from(title))
            }

            /// Set active
            pub fn active(self, active:bool)->Self{
                self.set("active", JsValue::from(active))
            }
        }

        // use MyOptions

        let options = MyOptions::new()
            .title("title text")
            .active(true);
    }
}

*/