Add asynchronous binding replies

Author: jinzhongjia

README.md

@@ -13,12 +13,14 @@ The current phase provides:
   built-in JavaScript bridge;
 - JavaScript calls to Zig bindings with return values;
 - typed integer, float, and boolean call arguments and replies;
+- owned one-shot delayed binding replies through `Call.deferReply()`;
 - window and targeted `Call.client` calls to JavaScript with results, errors,
   timeouts, and stale-client detection;
 - targeted client navigation, close, and raw binary delivery;
 - bounded multi-client windows through `WindowOptions.max_clients`;
 - bounded concurrent evaluations through
   `WindowOptions.max_pending_evals`;
+- bounded delayed replies through `WindowOptions.max_pending_replies`;
 - explicit connection, WebSocket message, call, argument, binding, event, and
   script limits through `App.Options.limits`;
 - window navigation, close, raw-data, and JavaScript broadcasts with
@@ -107,6 +109,12 @@ Navigation attempts are intercepted while an event handler is installed; call
 handlers receive no arguments and their replies are ignored; explicit
 `webui.call("button", ...)` remains available.
 
+Binding handlers can transfer an explicit `webui.call()` response beyond the
+handler lifetime with `Call.deferReply()`. Complete the owned `PendingReply`
+once with `reply()`, `replyInt()`, `replyFloat()`, or `replyBool()`, or call
+`deinit()` to abandon it. All pending replies must be completed or abandoned
+before `App.deinit()`.
+
 The browser-side `webui` object also provides connection events, runtime
 logging, Base64 helpers, navigation control, and native high-contrast media
 query detection.

docs/PURE_ZIG_REFACTOR.md

@@ -298,7 +298,6 @@ implementations.
 | `webui_show()`, `webui_set_root_folder()`, `webui_set_file_handler()`, `webui_set_file_handler_window()` | Content and resource handling can only be selected when creating a window; replacing them at runtime is not implemented. |
 | `webui_show_client()` | `Client` cannot replace the content of only one connected browser. |
 | `webui_is_shown()` | There is no window-level connected/shown query. |
-| `webui_set_config(asynchronous_response)` | A `Call` response must be completed during the binding handler lifetime. |
 | `webui_set_config(show_wait_connection)`, `webui_set_timeout()` | `Window.open()` does not optionally wait for a browser connection. |
 | `webui_set_config(ui_event_blocking)`, `webui_set_event_blocking()` | Per-window event scheduling control is not exposed. |
 | `webui_set_config(folder_monitor)` | Directory change monitoring and automatic browser reload are not implemented. |
@@ -343,6 +342,7 @@ not implementation gaps:
 | `webui_get_count()`, `webui_get_size()`, `webui_get_size_at()` | `Call.arguments.len` and `Call.bytes(index).len`. |
 | `webui_get_string()`, `webui_get_string_at()`, `webui_get_int()`, `webui_get_int_at()`, `webui_get_float()`, `webui_get_float_at()`, `webui_get_bool()`, `webui_get_bool_at()` | `Call.string()`, `Call.int()`, `Call.float()`, and `Call.boolean()`. |
 | `webui_return_string()`, `webui_return_int()`, `webui_return_float()`, `webui_return_bool()` | `Call.reply()`, `Call.replyInt()`, `Call.replyFloat()`, and `Call.replyBool()`. |
+| `webui_set_config(asynchronous_response)` | `Call.deferReply()` transfers the response to a bounded, owned, one-shot `PendingReply`. |
 | `webui_run()`, `webui_script()` | `Window.run()` and `Window.eval()`. |
 | `webui_run_client()`, `webui_script_client()` | `Client.run()` and `Client.eval()`. |
 | `webui_close_client()`, `webui_navigate_client()`, `webui_send_raw_client()` | `Client.close()`, `Client.navigate()`, and `Client.sendRaw()`. |
@@ -385,7 +385,6 @@ methods, and the public browser bridge surface.
 
 ### Handler and event lifecycle
 
-- Add an owned delayed-response handle for asynchronous binding responses.
 - Add per-window serialized or concurrent event execution.
 - Add optional wait-for-connection behavior and a connection timeout.
 - Add a caller-provided logger.
@@ -494,7 +493,6 @@ zig build -Dtarget=aarch64-macos
 
 Continue capability parity:
 
-1. Add an owned delayed-response handle for asynchronous binding responses.
-2. Add per-window event scheduling control.
-3. Add optional wait-for-connection behavior and a connection timeout.
-4. Add a caller-provided logger.
+1. Add per-window event scheduling control.
+2. Add optional wait-for-connection behavior and a connection timeout.
+3. Add a caller-provided logger.