Add typed call helpers

Author: jinzhongjia

README.md

@@ -12,6 +12,7 @@ The current phase provides:
 - embedded HTML, static directories, custom resources, external URLs, and a
   built-in JavaScript bridge;
 - JavaScript calls to Zig bindings with return values;
+- typed integer, float, and boolean call arguments and replies;
 - window and targeted `Call.client` calls to JavaScript with results, errors,
   timeouts, and stale-client detection;
 - targeted client navigation, close, and raw binary delivery;

docs/PURE_ZIG_REFACTOR.md

@@ -296,8 +296,6 @@ implementations.
 | Upstream API | Current gap |
 |---|---|
 | `webui_bind()` | `Window.bind` supports explicit `webui.call()` calls, but the bridge does not automatically dispatch DOM events from an element with the same ID to that binding. |
-| `webui_get_float()`, `webui_get_float_at()` | `Call.float()` is not implemented. |
-| `webui_return_float()`, `webui_return_bool()` | `Call.reply()` can encode these values as text, but typed `replyFloat()` and `replyBool()` helpers are not implemented. |
 | `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. |
@@ -350,8 +348,8 @@ not implementation gaps:
 | `webui_close()`, `webui_destroy()`, `webui_exit()`, `webui_clean()` | `Window.close()`, `Running.stop()`, and `App.deinit()`. |
 | `webui_set_context()`, `webui_get_context()` | Binding and event-handler `user_data`. |
 | `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_bool()`, `webui_get_bool_at()` | `Call.string()`, `Call.int()`, and `Call.boolean()`. |
-| `webui_return_string()`, `webui_return_int()` | `Call.reply()` and `Call.replyInt()`. |
+| `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_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()`. |
@@ -386,7 +384,6 @@ This completes the behavior represented by `webui_set_public()`,
 
 ### Calls, bindings, and browser bridge
 
-- Add `Call.float()`, `Call.replyFloat()`, and `Call.replyBool()`.
 - Make element-name bindings dispatch the same binding for DOM events while
   preserving explicit `webui.call()` support.
 - Implement bridge `setLogging()`, `encode()`, `decode()`,
@@ -508,5 +505,5 @@ zig build -Dtarget=aarch64-macos
 
 Continue capability parity:
 
-1. Add `Call.float()`, `Call.replyFloat()`, and `Call.replyBool()`.
+1. Add element-name DOM binding dispatch.
 2. Complete the public browser bridge API.

src/app.zig

@@ -636,6 +636,10 @@ pub const Call = struct {
         return std.fmt.parseInt(i64, try self.string(index), 10);
     }
 
+    pub fn float(self: *const Call, index: usize) !f64 {
+        return std.fmt.parseFloat(f64, try self.string(index));
+    }
+
     pub fn boolean(self: *const Call, index: usize) !bool {
         const value = try self.string(index);
         if (std.mem.eql(u8, value, "true")) return true;
@@ -654,6 +658,15 @@ pub const Call = struct {
         var buffer: [64]u8 = undefined;
         try self.reply(try std.fmt.bufPrint(&buffer, "{d}", .{value}));
     }
+
+    pub fn replyFloat(self: *Call, value: f64) !void {
+        var buffer: [64]u8 = undefined;
+        try self.reply(try std.fmt.bufPrint(&buffer, "{d}", .{value}));
+    }
+
+    pub fn replyBool(self: *Call, value: bool) !void {
+        try self.reply(if (value) "true" else "false");
+    }
 };
 
 pub const Client = struct {
@@ -1718,13 +1731,22 @@ test "call accessors, window creation, and routes" {
     var call: Call = .{
         .gpa = gpa,
         .client = .{ .state = window.state, .client_id = 1 },
-        .arguments = &.{ "42", "true" },
+        .arguments = &.{ "42", "true", "1.25", "invalid" },
     };
     defer call.deinit();
     try std.testing.expectEqual(@as(i64, 42), try call.int(0));
     try std.testing.expect(try call.boolean(1));
+    try std.testing.expectEqual(@as(f64, 1.25), try call.float(2));
+    try std.testing.expectError(error.InvalidCharacter, call.float(3));
+    try std.testing.expectError(error.MissingArgument, call.float(4));
     try call.replyInt(84);
     try std.testing.expectEqualStrings("84", call.response.items);
+    try call.replyFloat(1.25);
+    try std.testing.expectEqualStrings("1.25", call.response.items);
+    try call.replyBool(true);
+    try std.testing.expectEqualStrings("true", call.response.items);
+    try call.replyBool(false);
+    try std.testing.expectEqualStrings("false", call.response.items);
 }
 
 fn integrationHandler(call: *Call, user_data: ?*anyopaque) !void {