/// 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"