/// FFI declarations for the webview C library.
///
/// All extern functions are package-private. Public-facing wrappers live in
/// webview.mbt, command.mbt and plugin.mbt.
///
/// Ownership rules (moonbit-c-binding skill):
///   #borrow(param) — C only reads the value during the call, does not store it.
///   #owned(param)  — ownership transfers to C; C must moonbit_decref when done.
/// Primitives (Int, Int64, Bool, …) are passed by value — no annotation needed.
///
/// see: https://github.com/webview/webview/blob/master/webview.h

///|
/// Opaque handle returned by webview_create. C manages the underlying object.
#external
pub type WebView_t

///|
/// Opaque binding record returned by moonbit_webview_bind.
/// C allocates and owns it; MoonBit holds it only as a cookie for unbind.
#external
pub type BindingHandle

///|
/// Opaque IPC message snapshot returned by the native queue pop API.
#external
pub type IpcMessageHandle

// ── Bindings ─────────────────────────────────────────────────────────────────

///|
/// Bind a MoonBit closure as a named JavaScript function.
/// `name` is borrowed (used only during the call).
/// `closure` ownership transfers to the returned BindingHandle.
#borrow(name)
#owned(closure)
extern "C" fn webview_bind(
  w : WebView_t,
  name : Bytes,
  call_closure : FuncRef[(Bytes, Bytes, (Bytes, Bytes) -> Unit) -> Unit],
  closure : (Bytes, Bytes) -> Unit,
) -> BindingHandle = "moonbit_webview_bind"

// ── Helpers ──────────────────────────────────────────────────────────────────

///|
/// Copy a raw C string (seq/req pointer) into MoonBit-managed Bytes.
/// This copy is necessary because the C string is only valid for the duration
/// of the webview callback invocation.
#borrow(cstr)
extern "C" fn webview_copy_cstr(cstr : Bytes) -> Bytes = "moonbit_webview_copy_cstr"

///|
/// Register a custom scheme backed by a local root directory.
#borrow(w, scheme, root_dir)
pub extern "C" fn webview_set_custom_protocol(
  w : WebView_t,
  scheme : Bytes,
  root_dir : Bytes,
) -> Int = "webview_set_custom_protocol"

///|
/// Run a MoonBit closure on a detached native thread.
#owned(closure)
extern "C" fn run_in_background_thread(
  call_closure : FuncRef[(() -> Unit) -> Unit],
  closure : () -> Unit,
) -> Int = "moonbit_run_in_background_thread"

///|
/// Initialize native window manager runtime.
pub extern "C" fn wm_init(is_main_process : Int) -> Int = "moonbit_wm_init"

///|
/// Cleanup native window manager runtime.
pub extern "C" fn wm_cleanup() -> Unit = "moonbit_wm_cleanup"

///|
/// Create a managed native window and register it in WM.
#borrow(title, url)
pub extern "C" fn wm_create_window(
  title : Bytes,
  url : Bytes,
  width : Int,
  height : Int,
  x : Int,
  y : Int,
  has_x : Int,
  has_y : Int,
  parent_window_id : Int,
) -> Int = "moonbit_wm_create_window"

///|
/// Destroy managed window.
pub extern "C" fn wm_destroy_window(window_id : Int) -> Int = "moonbit_wm_destroy_window"

///|
/// Run managed window event loop.
pub extern "C" fn wm_run_window(window_id : Int) -> Int = "moonbit_wm_run_window"

///|
/// Start managed window event loop on a detached native thread.
pub extern "C" fn wm_run_window_async(window_id : Int) -> Int = "moonbit_wm_run_window_async"

///|
/// Request window termination.
pub extern "C" fn wm_terminate_window(window_id : Int) -> Int = "moonbit_wm_terminate_window"

///|
/// Set managed window title.
#borrow(title)
pub extern "C" fn wm_set_title(window_id : Int, title : Bytes) -> Int = "moonbit_wm_set_title"

///|
/// Set managed window size.
pub extern "C" fn wm_set_size(
  window_id : Int,
  width : Int,
  height : Int,
  hints : SizeHint,
) -> Int = "moonbit_wm_set_size"

///|
/// Apply native custom-window style flags.
pub extern "C" fn wm_set_window_customization(
  window_id : Int,
  frameless : Int,
  resizable : Int,
  closeable : Int,
  always_on_top : Int,
  transparent : Int,
  title_bar_style : TitleBarStyle,
  title_bar_overlay : Int,
) -> Int = "moonbit_wm_set_window_customization"

///|
/// Set macOS traffic-light buttons position.
pub extern "C" fn wm_set_traffic_light_position(
  window_id : Int,
  x : Int,
  y : Int,
) -> Int = "moonbit_wm_set_traffic_light_position"

///|
/// Minimize native window.
pub extern "C" fn wm_minimize_window(window_id : Int) -> Int = "moonbit_wm_minimize_window"

///|
/// Maximize native window.
pub extern "C" fn wm_maximize_window(window_id : Int) -> Int = "moonbit_wm_maximize_window"

///|
/// Restore native window from maximized state.
pub extern "C" fn wm_unmaximize_window(window_id : Int) -> Int = "moonbit_wm_unmaximize_window"

///|
/// Toggle native maximize state.
pub extern "C" fn wm_toggle_maximize_window(window_id : Int) -> Int = "moonbit_wm_toggle_maximize_window"

///|
/// Set native fullscreen state.
pub extern "C" fn wm_set_fullscreen_window(
  window_id : Int,
  fullscreen : Int,
) -> Int = "moonbit_wm_set_fullscreen_window"

///|
/// Toggle native fullscreen state.
pub extern "C" fn wm_toggle_fullscreen_window(window_id : Int) -> Int = "moonbit_wm_toggle_fullscreen_window"

///|
/// Start native window drag/move gesture.
pub extern "C" fn wm_start_drag_window(window_id : Int) -> Int = "moonbit_wm_start_drag_window"

///|
/// Close native window.
pub extern "C" fn wm_close_window(window_id : Int) -> Int = "moonbit_wm_close_window"

///|
/// Enable or disable developer tools integration.
pub extern "C" fn wm_set_devtools(window_id : Int, enabled : Int) -> Int = "moonbit_wm_set_devtools"

///|
/// Navigate managed window to URL.
#borrow(url)
pub extern "C" fn wm_navigate(window_id : Int, url : Bytes) -> Int = "moonbit_wm_navigate"

///|
/// Set managed window HTML.
#borrow(html)
pub extern "C" fn wm_set_html(window_id : Int, html : Bytes) -> Int = "moonbit_wm_set_html"

///|
/// Eval JS in managed window.
#borrow(js)
pub extern "C" fn wm_eval_js(window_id : Int, js : Bytes) -> Int = "moonbit_wm_eval_js"

///|
/// Init JS in managed window.
#borrow(js)
pub extern "C" fn wm_init_js(window_id : Int, js : Bytes) -> Int = "moonbit_wm_init_js"

///|
/// Set managed window visibility.
pub extern "C" fn wm_set_visibility(window_id : Int, visible : Int) -> Int = "moonbit_webview_set_window_visibility"

///|
/// Get managed window visibility.
pub extern "C" fn wm_get_visibility(window_id : Int) -> Int = "moonbit_webview_get_window_visibility"

///|
/// Query managed window count.
pub extern "C" fn wm_get_window_count() -> Int = "moonbit_wm_get_window_count"

///|
/// Query managed window id at index.
pub extern "C" fn wm_get_window_id_at(index : Int) -> Int = "moonbit_wm_get_window_id_at"

///|
/// Query managed window state.
pub extern "C" fn wm_get_window_state(window_id : Int) -> Int = "moonbit_wm_get_window_state"

///|
/// Query parent window id.
pub extern "C" fn wm_get_parent_window_id(window_id : Int) -> Int = "moonbit_wm_get_parent_window_id"

///|
/// Get native handle by managed window id.
pub extern "C" fn wm_get_handle(window_id : Int) -> WebView_t = "moonbit_wm_get_handle"

///|
/// Respond to a JS binding call on the managed window UI thread.
#borrow(seq, result)
pub extern "C" fn wm_return_raw(
  window_id : Int,
  seq : Bytes,
  status : Int,
  result : Bytes,
) -> Int = "moonbit_wm_return_raw"

///|
/// Create child-process window.
#borrow(title, url)
pub extern "C" fn wm_create_child_window(
  title : Bytes,
  url : Bytes,
  width : Int,
  height : Int,
  parent_window_id : Int,
) -> Int = "moonbit_wm_create_child_window"

///|
/// Fork the current process into a child that is already connected to the IPC server.
/// Returns child pid in the parent process, `0` in the child process, and `-1` on error.
pub extern "C" fn wm_fork_process() -> Int = "moonbit_wm_fork_process"

///|
/// Spawn a fresh child process by executing the given program path with one extra argument.
#borrow(program, arg1)
pub extern "C" fn wm_spawn_process(program : Bytes, arg1 : Bytes) -> Int = "moonbit_wm_spawn_process"

///|
/// Connect the current process to the parent's IPC server and switch WM into child mode.
pub extern "C" fn wm_connect_child_process() -> Int = "moonbit_wm_connect_child_process"

///|
/// Get process type: 0 main, 1 child.
pub extern "C" fn wm_get_process_type() -> Int = "moonbit_wm_get_process_type"

///|
/// Get current process id.
pub extern "C" fn wm_get_process_id() -> Int = "moonbit_wm_get_process_id"

///|
/// Kill child process.
pub extern "C" fn wm_kill_child(pid : Int) -> Int = "moonbit_wm_kill_child"

///|
/// Non-blocking child wait. Returns child pid when exited, `0` when still running.
pub extern "C" fn wm_wait_child_noblock(pid : Int) -> Int = "moonbit_wm_wait_child_noblock_no_status"

///|
/// Send asynchronous IPC message.
#borrow(subtype, data)
pub extern "C" fn wm_ipc_send(
  source_window_id : Int,
  target_window_id : Int,
  message_type : Int,
  subtype : Bytes,
  data : Bytes,
) -> Int = "moonbit_wm_ipc_send"

///|
/// Send an IPC request and wait for the raw response bytes.
#borrow(subtype, data)
pub extern "C" fn wm_ipc_request_bytes(
  source_window_id : Int,
  target_window_id : Int,
  subtype : Bytes,
  data : Bytes,
  timeout_ms : Int,
) -> Bytes = "moonbit_wm_ipc_request_bytes"

///|
/// Send an IPC response that matches a previous request id.
#borrow(data)
pub extern "C" fn wm_ipc_respond(
  source_window_id : Int,
  target_window_id : Int,
  request_id : Int,
  data : Bytes,
) -> Int = "moonbit_wm_ipc_respond"

///|
/// Pop the next queued IPC message snapshot for the given queue id.
pub extern "C" fn wm_ipc_pop_message(window_id : Int) -> IpcMessageHandle = "moonbit_wm_ipc_pop_message"

///|
extern "C" fn ipc_message_free(message : IpcMessageHandle) -> Unit = "moonbit_wm_ipc_message_free"

///|
extern "C" fn ipc_message_source_window_id(message : IpcMessageHandle) -> Int = "moonbit_wm_ipc_message_source_window_id"

///|
extern "C" fn ipc_message_target_window_id(message : IpcMessageHandle) -> Int = "moonbit_wm_ipc_message_target_window_id"

///|
extern "C" fn ipc_message_type(message : IpcMessageHandle) -> Int = "moonbit_wm_ipc_message_type"

///|
extern "C" fn ipc_message_id(message : IpcMessageHandle) -> Int = "moonbit_wm_ipc_message_id"

///|
extern "C" fn ipc_message_subtype(message : IpcMessageHandle) -> Bytes = "moonbit_wm_ipc_message_subtype"

///|
extern "C" fn ipc_message_data(message : IpcMessageHandle) -> Bytes = "moonbit_wm_ipc_message_data"