Add window shown state query

Author: jinzhongjia

README.md

@@ -16,6 +16,7 @@ The current phase provides:
 - targeted runtime content replacement through `Client.show()`;
 - explicit browser connection waiting and timeout through
   `Window.waitForConnection()`;
+- window connected/shown state through `Window.isShown()`;
 - 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()`;

docs/PURE_ZIG_REFACTOR.md

@@ -295,7 +295,6 @@ implementations.
 
 | Upstream API | Current gap |
 |---|---|
-| `webui_is_shown()` | There is no window-level connected/shown query. |
 | `webui_set_config(folder_monitor)` | Directory change monitoring and automatic browser reload are not implemented. |
 | `webui_set_default_root_folder()` | There is no application-wide default directory content setting. |
 | `webui_set_icon()`, `webui_set_icon_file()` | Window icon configuration is not implemented. |
@@ -331,6 +330,7 @@ not implementation gaps:
 | `webui_new_window()`, `webui_new_window_id()`, `webui_get_new_window_id()` | `App.createWindow()` and application-owned IDs. |
 | `webui_show()`, `webui_start_server()`, `webui_get_url()` | Initial `Content`, runtime `Window.setContent()`, `App.start()`, `Window.open()`, and `Window.url()`. |
 | `webui_show_client()` | `Client.show()` replaces the window content and navigates only the selected client. |
+| `webui_is_shown()` | `Window.isShown()` reports whether the window has at least one connected browser client. |
 | `webui_wait()`, `webui_wait_async()` | `Running.wait()` used directly or through `std.Io` concurrency. |
 | `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`. |
@@ -389,7 +389,6 @@ connection waiting, and caller-provided logging.
 
 ### Dynamic content and client state
 
-- Add a window connected/shown query.
 - Add an application default directory.
 - Add inline and file-backed window icons.
 
@@ -484,5 +483,4 @@ zig build -Dtarget=aarch64-macos
 
 Continue capability parity:
 
-1. Add a window connected/shown query.
-2. Add an application default directory and window icons.
+1. Add an application default directory and window icons.

src/app.zig

@@ -1318,6 +1318,11 @@ pub const Window = struct {
         try browser.open(self.state.gpa, io, page_url);
     }
 
+    /// Return whether at least one browser client is connected.
+    pub fn isShown(self: Window, io: std.Io) bool {
+        return self.state.hasClients(io);
+    }
+
     /// Wait for at least one browser connection and return the first client.
     pub fn waitForConnection(
         self: Window,
@@ -2790,6 +2795,7 @@ test "window connection waiting observes clients and timeouts" {
     const window = try app.createWindow(.{
         .content = .{ .html = "connection wait test" },
     });
+    try std.testing.expect(!window.isShown(io));
     var running = try app.start(io);
     defer running.stop() catch {};
 
@@ -2821,6 +2827,7 @@ test "window connection waiting observes clients and timeouts" {
     ));
 
     const delayed = try waiting.await(io);
+    try std.testing.expect(window.isShown(io));
     try std.testing.expect(delayed.isConnected(io));
     const immediate = try window.waitForConnection(io, .zero);
     try std.testing.expectEqual(delayed.id(), immediate.id());
@@ -2831,6 +2838,7 @@ test "window connection waiting observes clients and timeouts" {
         try std.Io.sleep(io, .fromMilliseconds(1), .awake);
     }
     try std.testing.expect(!delayed.isConnected(io));
+    try std.testing.expect(!window.isShown(io));
     try std.testing.expectError(
         error.Timeout,
         window.waitForConnection(io, .fromMilliseconds(5)),
@@ -3654,6 +3662,7 @@ test "multi-client limits, targeting, and disconnect lifecycle" {
     try window.bind("greet", integrationHandler, &called_client_id);
     var running = try app.start(io);
     defer running.stop() catch {};
+    try std.testing.expect(!window.isShown(io));
 
     const first_stream = try connectTestWebSocket(
         running.inner.address,
@@ -3670,6 +3679,7 @@ test "multi-client limits, targeting, and disconnect lifecycle" {
         &window.state.capability,
         &first_response,
     ));
+    try std.testing.expect(window.isShown(io));
 
     var packet: std.ArrayList(u8) = .empty;
     defer packet.deinit(gpa);
@@ -3705,6 +3715,7 @@ test "multi-client limits, targeting, and disconnect lifecycle" {
         &window.state.capability,
         &second_response,
     ));
+    try std.testing.expect(window.isShown(io));
     packet.clearRetainingCapacity();
     try protocol.append(&packet, gpa, .{
         .token = window.state.token,
@@ -4074,6 +4085,7 @@ test "multi-client limits, targeting, and disconnect lifecycle" {
     }
     try std.testing.expect(first_disconnected);
     try std.testing.expect(second.isConnected(io));
+    try std.testing.expect(window.isShown(io));
     try std.testing.expect(!app.closed.load(.acquire));
     try std.testing.expectError(error.ConnectionClosed, first_eval.await(io));
     try std.testing.expectError(
@@ -4115,4 +4127,5 @@ test "multi-client limits, targeting, and disconnect lifecycle" {
     try std.testing.expectEqual(protocol.Command.close, second_close.header.command);
     try second_stream.shutdown(io, .both);
     try running.wait();
+    try std.testing.expect(!window.isShown(io));
 }