Add application default directory

Author: jinzhongjia

README.md

@@ -11,6 +11,7 @@ The current phase provides:
 - one `App`, multiple isolated windows, and automatic port selection;
 - embedded HTML, static directories, custom resources, external URLs, and a
   built-in JavaScript bridge;
+- application-wide default static directories for windows without content;
 - runtime content and resource-handler replacement through
   `Window.setContent()`;
 - targeted runtime content replacement through `Client.show()`;
@@ -113,6 +114,10 @@ Serve a directory by setting
 app starts and closed when it stops. Custom resources receive `webui.Request`
 and `webui.Response` directly.
 
+Set `App.Options.default_directory` to let windows created without `.content`
+inherit one static directory. Explicit window content takes precedence. A
+window without either setting returns `error.MissingContent`.
+
 `Window.setContent(&running, content)` prepares and installs new content, then
 navigates every connected client to it and returns the number notified. An
 invalid replacement leaves the current content unchanged. If client

docs/PURE_ZIG_REFACTOR.md

@@ -276,6 +276,7 @@ protocol input never panics.
 | `window.run()` | `Window.eval()` |
 | `Event.runClient()` | `Call.client.eval()` |
 | `setRootFolder()` | Initial `.directory` content or runtime `Window.setContent()`. |
+| `setDefaultRootFolder()` | `App.Options.default_directory` and an omitted window `content`. |
 | Global `setConfig()` | `App.Options` or `Window.Options` |
 | `wait()` / `clean()` | `Running.wait()` / `App.deinit()` |
 | `malloc/free/memcpy/encode/decode` | Zig allocators and standard library |
@@ -296,7 +297,6 @@ implementations.
 | Upstream API | Current gap |
 |---|---|
 | `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. |
 | `webui_open_url()` | The internal OS URL opener is not exposed as a general public API. |
 | `webui_get_best_browser()`, `webui_browser_exist()`, `webui_show_browser()`, `webui_set_browser_folder()` | Browser discovery, selection, and custom executable locations are not implemented. |
@@ -331,6 +331,7 @@ not implementation gaps:
 | `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_set_default_root_folder()` | `App.Options.default_directory` supplies directory content to windows created without explicit content. |
 | `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 +390,6 @@ connection waiting, and caller-provided logging.
 
 ### Dynamic content and client state
 
-- Add an application default directory.
 - Add inline and file-backed window icons.
 
 This completes `webui_show()`, `webui_show_client()`, `webui_is_shown()`,
@@ -483,4 +483,4 @@ zig build -Dtarget=aarch64-macos
 
 Continue capability parity:
 
-1. Add an application default directory and window icons.
+1. Add inline and file-backed window icons.

src/app.zig

@@ -1501,13 +1501,14 @@ pub const App = struct {
         public: bool = false,
         tls: ?Tls = null,
         use_cookies: bool = false,
+        default_directory: ?[]const u8 = null,
         logger: ?Logger = null,
         logger_user_data: ?*anyopaque = null,
         limits: Limits = .{},
     };
 
     pub const WindowOptions = struct {
-        content: Content,
+        content: ?Content = null,
         /// One client by default; values above one explicitly enable
         /// bounded multi-client mode.
         max_clients: usize = 1,
@@ -1554,9 +1555,14 @@ pub const App = struct {
         {
             return error.InvalidPendingEventLimit;
         }
+        const selected_content: Content = options.content orelse
+            if (self.options.default_directory) |path|
+                .{ .directory = path }
+            else
+                return error.MissingContent;
         const state = try self.gpa.create(WindowState);
         errdefer self.gpa.destroy(state);
-        var content = try StoredContent.init(self.gpa, options.content);
+        var content = try StoredContent.init(self.gpa, selected_content);
         errdefer content.deinit(self.gpa);
         state.* = .{
             .gpa = self.gpa,
@@ -2321,6 +2327,13 @@ test "call accessors, window creation, and routes" {
 
     var app = App.init(gpa, .{});
     defer app.deinit();
+    try std.testing.expectError(error.MissingContent, app.createWindow(.{}));
+    var invalid_default_app = App.init(gpa, .{ .default_directory = "" });
+    defer invalid_default_app.deinit();
+    try std.testing.expectError(
+        error.InvalidDirectory,
+        invalid_default_app.createWindow(.{}),
+    );
     try std.testing.expectError(error.InvalidDirectory, app.createWindow(.{
         .content = .{ .directory = "" },
     }));
@@ -3044,17 +3057,15 @@ test "JavaScript and Zig calls complete over HTTP and WebSocket" {
     );
     defer gpa.free(directory_path);
 
-    var app = App.init(gpa, .{});
+    var app = App.init(gpa, .{ .default_directory = directory_path });
     defer app.deinit();
+    const default_window = try app.createWindow(.{});
     const window = try app.createWindow(.{
         .content = .{ .html = "test page" },
     });
     const second_window = try app.createWindow(.{
         .content = .{ .html = "second page" },
     });
-    const directory_window = try app.createWindow(.{
-        .content = .{ .directory = directory_path },
-    });
     const custom_window = try app.createWindow(.{
         .content = .{ .custom = .{
             .handler = integrationResourceHandler,
@@ -3133,7 +3144,7 @@ test "JavaScript and Zig calls complete over HTTP and WebSocket" {
             running.inner.address,
             io,
             try std.fmt.bufPrint(&target, "/{s}/", .{
-                directory_window.state.capability,
+                default_window.state.capability,
             }),
             "directory page",
             &response,
@@ -3151,7 +3162,7 @@ test "JavaScript and Zig calls complete over HTTP and WebSocket" {
             running.inner.address,
             io,
             try std.fmt.bufPrint(&target, "/{s}/%2e%2e/secret.txt", .{
-                directory_window.state.capability,
+                default_window.state.capability,
             }),
             "\r\n\r\n",
             &response,