amberjs 1.17.0

JavaScript/TypeScript runtime built with Rust and V8
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298

// CustomEvent API implementation for Web standard
// Provides CustomEvent interface for custom event handling
// Used for custom event dispatching in AI agent systems and UI frameworks

use rusty_v8 as v8;

fn bool_option(
    scope: &mut v8::PinScope,
    init_obj: v8::Local<v8::Object>,
    key: &str,
    default: bool,
) -> bool {
    let Some(key_string) = v8::String::new(scope, key) else {
        return default;
    };
    init_obj
        .get(scope, key_string.into())
        .map(|value| value.to_boolean(scope).boolean_value(scope))
        .unwrap_or(default)
}

fn has_own_property(scope: &mut v8::PinScope, object: v8::Local<v8::Object>, key: &str) -> bool {
    let Some(key_string) = v8::String::new(scope, key) else {
        return false;
    };
    object
        .get(scope, key_string.into())
        .map(|value| !value.is_undefined())
        .unwrap_or(false)
}

fn prevent_default_if_cancelable(scope: &mut v8::PinScope, this: v8::Local<v8::Object>) {
    let Some(cancelable_key) = v8::String::new(scope, "cancelable") else {
        return;
    };
    let is_cancelable = this
        .get(scope, cancelable_key.into())
        .map(|value| value.to_boolean(scope).boolean_value(scope))
        .unwrap_or(false);
    if !is_cancelable {
        return;
    }

    let default_prevented_key = v8::String::new(scope, "defaultPrevented").unwrap().into();
    let true_val = v8::Boolean::new(scope, true);
    this.set(scope, default_prevented_key, true_val.into());
}

/// Setup CustomEvent API in V8 context
/// CustomEvent provides a way to create custom events with custom data (detail)
pub fn setup_custom_event_api(
    scope: &mut v8::ContextScope<v8::HandleScope>,
    context: &v8::Local<v8::Context>,
) {
    let global = context.global(scope);

    // Create CustomEvent constructor
    let custom_event_func = v8::Function::new(scope, custom_event_constructor).unwrap();
    let custom_event_name = v8::String::new(scope, "CustomEvent").unwrap();
    global.set(scope, custom_event_name.into(), custom_event_func.into());

    // Create prototype object
    let prototype = v8::Object::new(scope);
    let prototype_name = v8::String::new(scope, "CustomEventPrototype").unwrap();
    global.set(scope, prototype_name.into(), prototype.into());

    // Inherit from Event
    let event_func_name = v8::String::new(scope, "Event").unwrap();
    let event_func = global.get(scope, event_func_name.into()).unwrap();
    if event_func.is_function() {
        let event_func: v8::Local<v8::Function> = v8::Local::cast(event_func);
        let prototype_of = v8::String::new(scope, "prototype").unwrap();
        let event_proto = event_func.get(scope, prototype_of.into()).unwrap();
        if event_proto.is_object() {
            let event_proto: v8::Local<v8::Object> = v8::Local::cast(event_proto);
            prototype.set_prototype(scope, event_proto.into());
        }
    }

    // Set up prototype methods - preventDefault from Event
    let prevent_default_fn = v8::Function::new(
        scope,
        |scope: &mut v8::PinScope,
         args: v8::FunctionCallbackArguments,
         _retval: v8::ReturnValue| {
            let this = args.this();
            prevent_default_if_cancelable(scope, this);
        },
    )
    .unwrap();
    let prevent_default_key: v8::Local<v8::Name> =
        v8::String::new(scope, "preventDefault").unwrap().into();
    prototype.set(scope, prevent_default_key.into(), prevent_default_fn.into());

    // Set CustomEvent as global constructor (for instanceof checks)
    global.set(scope, custom_event_name.into(), custom_event_func.into());
}

/// CustomEvent constructor callback
/// CustomEvent(type, eventInitDict)
///
/// eventInitDict:
///   - detail: Custom event data (default: null)
///   - bubbles: Whether event bubbles (default: false)
///   - cancelable: Whether event is cancelable (default: false)
fn custom_event_constructor(
    scope: &mut v8::PinScope,
    args: v8::FunctionCallbackArguments,
    mut rv: v8::ReturnValue,
) {
    // Initialize default values
    let mut event_type = String::from("custom");
    let mut detail: Option<v8::Local<v8::Value>> = None;
    let mut bubbles = false;
    let mut cancelable = false;

    // Parse arguments
    if args.length() >= 1 {
        let type_arg = args.get(0);
        if type_arg.is_string() {
            event_type = type_arg
                .to_string(scope)
                .unwrap()
                .to_rust_string_lossy(scope);
        }
    }

    // Parse eventInitDict if second argument is provided
    if args.length() >= 2 {
        let dict = args.get(1);
        if dict.is_object() {
            let dict: v8::Local<v8::Object> = v8::Local::cast(dict);
            let mut has_explicit_detail = false;
            let has_event_init_field = has_own_property(scope, dict, "bubbles")
                || has_own_property(scope, dict, "cancelable")
                || has_own_property(scope, dict, "composed");

            // Get detail property
            let detail_key = v8::String::new(scope, "detail").unwrap();
            if let Some(val) = dict.get(scope, detail_key.into()) {
                if !val.is_undefined() {
                    detail = Some(val);
                    has_explicit_detail = true;
                }
            }

            // Older Amber examples passed the payload object directly, or under
            // a "data" key, instead of the standard { detail } eventInitDict.
            if !has_explicit_detail {
                let data_key = v8::String::new(scope, "data").unwrap();
                if let Some(val) = dict.get(scope, data_key.into()) {
                    if !val.is_undefined() {
                        detail = Some(val);
                        has_explicit_detail = true;
                    }
                }
            }

            if !has_explicit_detail {
                if has_event_init_field {
                    detail = None;
                } else {
                    detail = Some(dict.into());
                }
            }

            bubbles = bool_option(scope, dict, "bubbles", false);
            cancelable = bool_option(scope, dict, "cancelable", false);
        }
    }

    // Create the CustomEvent object
    let event_obj = v8::Object::new(scope);

    // Set type
    let type_key = v8::String::new(scope, "type").unwrap();
    let type_val = v8::String::new(scope, &event_type).unwrap();
    event_obj.set(scope, type_key.into(), type_val.into());

    // Set detail property (custom event data)
    let detail_key = v8::String::new(scope, "detail").unwrap();
    if let Some(d) = detail {
        event_obj.set(scope, detail_key.into(), d);
    } else {
        let null_val: v8::Local<v8::Value> = v8::null(scope).into();
        event_obj.set(scope, detail_key.into(), null_val);
    }

    // Set inherited Event properties
    let bubbles_key = v8::String::new(scope, "bubbles").unwrap();
    let bubbles_val = v8::Boolean::new(scope, bubbles);
    event_obj.set(scope, bubbles_key.into(), bubbles_val.into());

    let cancelable_key = v8::String::new(scope, "cancelable").unwrap();
    let cancelable_val = v8::Boolean::new(scope, cancelable);
    event_obj.set(scope, cancelable_key.into(), cancelable_val.into());

    let composed_key = v8::String::new(scope, "composed").unwrap();
    let composed_val = v8::Boolean::new(scope, false);
    event_obj.set(scope, composed_key.into(), composed_val.into());

    // Set defaultPrevented (readonly, but we set initial value)
    let default_prevented_key = v8::String::new(scope, "defaultPrevented").unwrap();
    let default_prevented_val = v8::Boolean::new(scope, false);
    event_obj.set(
        scope,
        default_prevented_key.into(),
        default_prevented_val.into(),
    );

    // Set isTrusted
    let is_trusted_key = v8::String::new(scope, "isTrusted").unwrap();
    let is_trusted_val = v8::Boolean::new(scope, false);
    event_obj.set(scope, is_trusted_key.into(), is_trusted_val.into());

    // Add preventDefault method
    let prevent_default_fn = v8::Function::new(
        scope,
        |scope: &mut v8::PinScope,
         args: v8::FunctionCallbackArguments,
         _retval: v8::ReturnValue| {
            let this = args.this();
            prevent_default_if_cancelable(scope, this);
        },
    )
    .unwrap();
    let prevent_default_key: v8::Local<v8::Name> =
        v8::String::new(scope, "preventDefault").unwrap().into();
    event_obj.set(scope, prevent_default_key.into(), prevent_default_fn.into());

    rv.set(event_obj.into());
}

/// Create a CustomEvent object for event dispatching
/// This is a helper function that can be used by other modules
pub fn create_custom_event_object<'a>(
    scope: &mut v8::PinScope<'a, '_>,
    event_type: &str,
    detail: Option<v8::Local<'a, v8::Value>>,
) -> v8::Local<'a, v8::Object> {
    let event_obj = v8::Object::new(scope);

    // Set type
    let type_key = v8::String::new(scope, "type").unwrap();
    let type_val = v8::String::new(scope, event_type).unwrap();
    event_obj.set(scope, type_key.into(), type_val.into());

    // Set detail property
    let detail_key = v8::String::new(scope, "detail").unwrap();
    if let Some(d) = detail {
        event_obj.set(scope, detail_key.into(), d);
    } else {
        let null_val: v8::Local<v8::Value> = v8::null(scope).into();
        event_obj.set(scope, detail_key.into(), null_val);
    }

    // Set inherited Event properties
    let bubbles_key = v8::String::new(scope, "bubbles").unwrap();
    let bubbles_val = v8::Boolean::new(scope, false);
    event_obj.set(scope, bubbles_key.into(), bubbles_val.into());

    let cancelable_key = v8::String::new(scope, "cancelable").unwrap();
    let cancelable_val = v8::Boolean::new(scope, false);
    event_obj.set(scope, cancelable_key.into(), cancelable_val.into());

    let composed_key = v8::String::new(scope, "composed").unwrap();
    let composed_val = v8::Boolean::new(scope, false);
    event_obj.set(scope, composed_key.into(), composed_val.into());

    let default_prevented_key = v8::String::new(scope, "defaultPrevented").unwrap();
    let default_prevented_val = v8::Boolean::new(scope, false);
    event_obj.set(
        scope,
        default_prevented_key.into(),
        default_prevented_val.into(),
    );

    let is_trusted_key = v8::String::new(scope, "isTrusted").unwrap();
    let is_trusted_val = v8::Boolean::new(scope, false);
    event_obj.set(scope, is_trusted_key.into(), is_trusted_val.into());

    // Add preventDefault method
    let prevent_default_fn = v8::Function::new(
        scope,
        |scope: &mut v8::PinScope,
         args: v8::FunctionCallbackArguments,
         _retval: v8::ReturnValue| {
            let this = args.this();
            prevent_default_if_cancelable(scope, this);
        },
    )
    .unwrap();
    let prevent_default_key: v8::Local<v8::Name> =
        v8::String::new(scope, "preventDefault").unwrap().into();
    event_obj.set(scope, prevent_default_key.into(), prevent_default_fn.into());

    event_obj
}