/// This module provides the FFI (Foreign Function Interface) for the low-level
/// browser backend.
///
/// The exported C ABI intentionally keeps the historical `webview_*` names so
/// existing MoonBit callers do not need API changes when the native
/// implementation changes backend.
///|
/// typedef void *webview_t;
#external
pub type Webview_t
///|
/// Opaque C string pointer received from the native webview callback.
#external
pub type CStr
///|
/// Opaque binding handle returned by the native webview wrapper.
#external
pub type BindingHandle
///|
/// extern webview_t webview_create(int debug, void *window);
pub extern "C" fn webview_create(debug : Int, window : Int64) -> Webview_t = "webview_create"
///|
/// extern void webview_destroy(webview_t w);
pub extern "C" fn webview_destroy(webview : Webview_t) -> Int = "webview_destroy"
///|
/// extern void webview_run(webview_t w);
pub extern "C" fn webview_run(webview : Webview_t) -> Int = "webview_run"
///|
/// extern void webview_terminate(webview_t w);
pub extern "C" fn webview_terminate(webview : Webview_t) -> Int = "webview_terminate"
///|
/// extern void webview_dispatch(webview_t w, void (*fn)(webview_t w, void *arg), void *arg);
pub extern "C" fn webview_dispatch(
webview : Webview_t,
call_closure : FuncRef[(Webview_t, (Webview_t) -> Unit) -> Unit],
closure : () -> Unit,
) -> Int = "webview_dispatch"
///|
/// extern void *webview_get_window(webview_t w);
pub extern "C" fn webview_get_window(webview : Webview_t) -> Int64 = "webview_get_window"
///|
/// Returns a stable integer identity for the native webview handle.
extern "C" fn webview_identity(webview : Webview_t) -> Int64 = "moonbit_webview_identity"
///|
/// extern void *webview_get_native_handle(webview_t w, webview_native_handle_kind_t kind);
pub extern "C" fn webview_get_native_handle(
webview : Webview_t,
kind : NativeHandleKind,
) -> Int64 = "webview_get_native_handle"
///|
/// extern void webview_set_title(webview_t w, const char *title);
#borrow(title)
pub extern "C" fn webview_set_title(webview : Webview_t, title : Bytes) -> Int = "webview_set_title"
///|
/// extern void webview_set_size(webview_t w, int width, int height, webview_hint_t hints);
pub extern "C" fn webview_set_size(
webview : Webview_t,
width : Int,
height : Int,
hint : SizeHint,
) -> Int = "webview_set_size"
///|
/// extern void webview_navigate(webview_t w, const char *url);
#borrow(url)
pub extern "C" fn webview_navigate(webview : Webview_t, url : Bytes) -> Int = "webview_navigate"
///|
/// Queues a pre-rendered HTML replacement script.
#borrow(js)
extern "C" fn webview_set_html_script(webview : Webview_t, js : Bytes) -> Int = "moonbit_webview_set_html_script"
///|
/// extern void webview_set_html(webview_t w, const char *html);
pub fn webview_set_html(webview : Webview_t, html : Bytes) -> Int {
webview_set_html_script(
webview,
@ffi.to_cstr(
webview_html_replacement_script(webview_c_string_bytes_to_string(html)),
),
)
}
///|
/// extern void webview_init(webview_t w, const char *js);
#borrow(js)
pub extern "C" fn webview_init(webview : Webview_t, js : Bytes) -> Int = "webview_init"
///|
/// extern void webview_eval(webview_t w, const char *js);
#borrow(js)
pub extern "C" fn webview_eval(webview : Webview_t, js : Bytes) -> Int = "webview_eval"
///|
/// Wrapper around `webview_bind` that stores the owned MoonBit closure inside
/// an opaque native binding record and returns that record as a handle for
/// later unbind/cleanup.
#borrow(name)
#owned(closure)
pub extern "C" fn webview_bind(
webview : Webview_t,
name : Bytes,
call_closure : FuncRef[(CStr, CStr, (Bytes, Bytes) -> Unit) -> Unit],
closure : (Bytes, Bytes) -> Unit,
) -> BindingHandle = "moonbit_webview_bind"
///|
/// Copies a raw C string into MoonBit-managed bytes, preserving the trailing
/// null terminator.
extern "C" fn webview_copy_cstr(cstr : CStr) -> Bytes = "moonbit_webview_copy_cstr"
///|
/// Checks whether a native binding handle is null.
extern "C" fn webview_binding_is_null(binding : BindingHandle) -> Bool = "moonbit_is_null"
///|
/// Wrapper around `webview_unbind` that also releases the opaque native
/// binding handle returned by `webview_bind`.
#borrow(name)
pub extern "C" fn webview_unbind(
webview : Webview_t,
name : Bytes,
binding : BindingHandle,
) -> Int = "moonbit_webview_unbind"
///|
/// extern void webview_return(webview_t w, const char *seq, int status, const char *result);
#borrow(seq, result)
pub extern "C" fn webview_return(
webview : Webview_t,
seq : Bytes,
status : Int,
result : Bytes,
) -> Int = "webview_return"
///|
/// Returns the compiled low-level browser backend id.
extern "C" fn webview_backend_id_ffi() -> Bytes = "moonbit_webview_backend_id"
///|
/// Returns whether the compiled browser backend can create real windows.
extern "C" fn webview_backend_available_ffi() -> Bool = "moonbit_webview_backend_available"