Improve directory redirects and strict entry-file handling for root folders and VFS

CMakeLists.txt

@@ -126,13 +126,15 @@ if (WEBUI_BUILD_EXAMPLES)
     add_executable(call_cpp_from_js ${CMAKE_CURRENT_SOURCE_DIR}/examples/C++/call_cpp_from_js/main.cpp)
     add_executable(serve_a_folder_cpp ${CMAKE_CURRENT_SOURCE_DIR}/examples/C++/serve_a_folder/main.cpp)
     add_executable(virtual_file_system_cpp ${CMAKE_CURRENT_SOURCE_DIR}/examples/C++/virtual_file_system/main.cpp)
+    add_executable(test_index_redirect_cpp ${CMAKE_CURRENT_SOURCE_DIR}/examples/C++/test_index_redirect/main.cpp)
 
     # C examples
     add_executable(minimal_c ${CMAKE_CURRENT_SOURCE_DIR}/examples/C/minimal/main.c)
     add_executable(call_js_from_c ${CMAKE_CURRENT_SOURCE_DIR}/examples/C/call_js_from_c/main.c)
     add_executable(call_c_from_js ${CMAKE_CURRENT_SOURCE_DIR}/examples/C/call_c_from_js/main.c)
     add_executable(serve_a_folder_c ${CMAKE_CURRENT_SOURCE_DIR}/examples/C/serve_a_folder/main.c)
     add_executable(virtual_file_system_c ${CMAKE_CURRENT_SOURCE_DIR}/examples/C/virtual_file_system/main.c)
+    add_executable(test_index_redirect_c ${CMAKE_CURRENT_SOURCE_DIR}/examples/C/test_index_redirect/main.c)
     add_executable(public_network_access ${CMAKE_CURRENT_SOURCE_DIR}/examples/C/public_network_access/main.c)
     add_executable(web_app_multi_client ${CMAKE_CURRENT_SOURCE_DIR}/examples/C/web_app_multi_client/main.c)
     add_executable(chatgpt_api ${CMAKE_CURRENT_SOURCE_DIR}/examples/C/chatgpt_api/main.c)
@@ -146,12 +148,14 @@ if (WEBUI_BUILD_EXAMPLES)
     target_link_libraries(call_cpp_from_js webui)
     target_link_libraries(serve_a_folder_cpp webui)
     target_link_libraries(virtual_file_system_cpp webui)
+    target_link_libraries(test_index_redirect_cpp webui)
 
     target_link_libraries(minimal_c webui)
     target_link_libraries(call_js_from_c webui)
     target_link_libraries(call_c_from_js webui)
     target_link_libraries(serve_a_folder_c webui)
     target_link_libraries(virtual_file_system_c webui)
+    target_link_libraries(test_index_redirect_c webui)
     target_link_libraries(public_network_access webui)
     target_link_libraries(web_app_multi_client webui)
     target_link_libraries(chatgpt_api webui)
@@ -166,11 +170,13 @@ if (WEBUI_BUILD_EXAMPLES)
         set_target_properties(call_cpp_from_js PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")
         set_target_properties(serve_a_folder_cpp PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")
         set_target_properties(virtual_file_system_cpp PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")
+        set_target_properties(test_index_redirect_cpp PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")
         set_target_properties(minimal_c PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")
         set_target_properties(call_js_from_c PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")
         set_target_properties(call_c_from_js PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")
         set_target_properties(serve_a_folder_c PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")
         set_target_properties(virtual_file_system_c PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")
+        set_target_properties(test_index_redirect_c PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")
         set_target_properties(public_network_access PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")
         set_target_properties(web_app_multi_client PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")
         set_target_properties(chatgpt_api PROPERTIES LINK_FLAGS "/SubSystem:\"Windows\"" VS_DPI_AWARE "ON")

examples/C++/README.md

@@ -9,6 +9,7 @@ The only requirement to build the examples is a a C++11 compiler.
 - `call_js_from_cpp`: Calls JavaScript from C++ using class methods and member-function bind.
 - `serve_a_folder`: Uses WebUI to serve a folder with multiple files (class-based example using member-function bind).
 - `virtual_file_system`: Embeds files using a virtual file system.
+- `test_index_redirect`: Tests index fallback and custom entry behavior for `/`, `/sub`, and `/sub/foo`.
 
 To build an example, cd into its directory and run the make command.
 

examples/C++/test_index_redirect/main.cpp

@@ -0,0 +1,87 @@
+#include "webui.hpp"
+#include "vfs.h"
+
+// This example is used to verify redirect and fallback behavior for:
+//   /, /sub, /sub/foo
+// in both storage modes:
+//   1) set_root_folder(...)
+//   2) set_file_handler(vfs)
+//
+// Server mode is the primary redirect test path because it exposes the raw
+// HTTP behavior (302 Location targets) without mixing in window lifecycle.
+//
+// The expected server behavior is:
+//   - start_server("custom.html") prefers custom.html in every directory
+//   - an explicit filename is strict; if it does not exist, the request fails
+//   - start_server() or start_server("") means "fallback mode", which probes
+//     index.html, index.htm, index.ts, then index.js
+//
+// Note: index.ts and index.js can still be valid fallback targets for
+// runtime/script-first scenarios, but they are not equivalent to an HTML GUI
+// entry page. For normal GUI testing, HTML/HTM are the page-like entries.
+int main(int argc, char *argv[])
+{
+    bool serverMode = false;
+    bool vfsEnabled = false;
+    for (int i = 1; i < argc; ++i)
+    {
+        if (std::string(argv[i]) == "--server")
+        {
+            serverMode = true;
+        }
+        else if (std::string(argv[i]) == "--vfs")
+        {
+            vfsEnabled = true;
+        }
+    }
+
+    webui::window window_;
+    webui::set_config(use_cookies, false);
+
+    if (vfsEnabled)
+    {
+        window_.set_file_handler(vfs);
+    }
+    else
+    {
+        window_.set_root_folder("/home/gordon/Dokumenty/PlatformIO/Projects/webui/examples/C++/test_index_redirect/ui/");
+
+        // Absolute paths:
+        // window_.set_root_folder("/path/to/ui/");
+        // window_.set_root_folder("/path/to/ui");
+
+        // Relative if ui folder is next to executable:
+        // window_.set_root_folder("ui/");
+        // window_.set_root_folder("ui");
+    }
+
+    if (serverMode)
+    {
+        window_.set_port(8080);
+
+        // Explicit custom entry file:
+        window_.start_server("custom.html");
+
+        // Redirect to the hardcoded index.* fallback list:
+        // window_.start_server();
+
+    }
+    else
+    {
+        // Explicit custom entry file:
+        window_.show("custom.html");
+        // window_.show_browser("custom.html"); // AnyBrowser is the default second argument in C++.
+
+        // Redirect to the hardcoded index.* fallback list:
+        // window_.show();
+        // window_.show_browser();
+    }
+
+    webui::wait();
+
+    return 0;
+}
+
+#if defined(_MSC_VER)
+int APIENTRY WinMain(HINSTANCE hInst, HINSTANCE hInstPrev, PSTR cmdline, int cmdshow) { return main(__argc, __argv); }
+#endif

examples/C++/test_index_redirect/ui/custom.html

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>ui/custom.html</title>
+</head>
+<body>
+  <h1>ui/custom.html</h1>
+  <p>IDENTIFIER: ui/custom.html</p>
+  <p>Directory routes: <a href="/">/</a> | <a href="/sub">/sub</a> | <a href="/sub/foo">/sub/foo</a></p>
+  <h2>All test files</h2>
+  <ul>
+    <li><a href="/custom.html">/custom.html</a></li>
+    <li><a href="/index.html">/index.html</a></li>
+    <li><a href="/index.css">/index.css</a></li>
+    <li><a href="/index.js">/index.js</a></li>
+    <li><a href="/sub/custom.html">/sub/custom.html</a></li>
+    <li><a href="/sub/index.html">/sub/index.html</a></li>
+    <li><a href="/sub/index.css">/sub/index.css</a></li>
+    <li><a href="/sub/index.js">/sub/index.js</a></li>
+    <li><a href="/sub/foo/custom.html">/sub/foo/custom.html</a></li>
+    <li><a href="/sub/foo/index.html">/sub/foo/index.html</a></li>
+    <li><a href="/sub/foo/index.css">/sub/foo/index.css</a></li>
+    <li><a href="/sub/foo/index.js">/sub/foo/index.js</a></li>
+  </ul>
+<script src="/webui.js"></script>
+</body>
+</html>

examples/C++/test_index_redirect/ui/index.css

@@ -0,0 +1,4 @@
+/* IDENTIFIER: ui/index.css */
+/* Directory routes: / | /sub | /sub/foo */
+/* All files: /custom.html /index.html /index.css /index.js /sub/custom.html /sub/index.html /sub/index.css /sub/index.js /sub/foo/custom.html /sub/foo/index.html /sub/foo/index.css /sub/foo/index.js */
+body { font-family: monospace; }

examples/C++/test_index_redirect/ui/index.html

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>ui/index.html</title>
+</head>
+<body>
+  <h1>ui/index.html</h1>
+  <p>IDENTIFIER: ui/index.html</p>
+  <p>Directory routes: <a href="/">/</a> | <a href="/sub">/sub</a> | <a href="/sub/foo">/sub/foo</a></p>
+  <h2>All test files</h2>
+  <ul>
+    <li><a href="/custom.html">/custom.html</a></li>
+    <li><a href="/index.html">/index.html</a></li>
+    <li><a href="/index.css">/index.css</a></li>
+    <li><a href="/index.js">/index.js</a></li>
+    <li><a href="/sub/custom.html">/sub/custom.html</a></li>
+    <li><a href="/sub/index.html">/sub/index.html</a></li>
+    <li><a href="/sub/index.css">/sub/index.css</a></li>
+    <li><a href="/sub/index.js">/sub/index.js</a></li>
+    <li><a href="/sub/foo/custom.html">/sub/foo/custom.html</a></li>
+    <li><a href="/sub/foo/index.html">/sub/foo/index.html</a></li>
+    <li><a href="/sub/foo/index.css">/sub/foo/index.css</a></li>
+    <li><a href="/sub/foo/index.js">/sub/foo/index.js</a></li>
+  </ul>
+<script src="/webui.js"></script>
+</body>
+</html>

examples/C++/test_index_redirect/ui/index.js

@@ -0,0 +1,4 @@
+// IDENTIFIER: ui/index.js
+// Directory routes: / | /sub | /sub/foo
+// All files: /custom.html /index.html /index.css /index.js /sub/custom.html /sub/index.html /sub/index.css /sub/index.js /sub/foo/custom.html /sub/foo/index.html /sub/foo/index.css /sub/foo/index.js
+console.log('IDENTIFIER: ui/index.js');

examples/C++/test_index_redirect/ui/sub/custom.html

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>ui/sub/custom.html</title>
+</head>
+<body>
+  <h1>ui/sub/custom.html</h1>
+  <p>IDENTIFIER: ui/sub/custom.html</p>
+  <p>Directory routes: <a href="/">/</a> | <a href="/sub">/sub</a> | <a href="/sub/foo">/sub/foo</a></p>
+  <h2>All test files</h2>
+  <ul>
+    <li><a href="/custom.html">/custom.html</a></li>
+    <li><a href="/index.html">/index.html</a></li>
+    <li><a href="/index.css">/index.css</a></li>
+    <li><a href="/index.js">/index.js</a></li>
+    <li><a href="/sub/custom.html">/sub/custom.html</a></li>
+    <li><a href="/sub/index.html">/sub/index.html</a></li>
+    <li><a href="/sub/index.css">/sub/index.css</a></li>
+    <li><a href="/sub/index.js">/sub/index.js</a></li>
+    <li><a href="/sub/foo/custom.html">/sub/foo/custom.html</a></li>
+    <li><a href="/sub/foo/index.html">/sub/foo/index.html</a></li>
+    <li><a href="/sub/foo/index.css">/sub/foo/index.css</a></li>
+    <li><a href="/sub/foo/index.js">/sub/foo/index.js</a></li>
+  </ul>
+<script src="/webui.js"></script>
+</body>
+</html>

examples/C++/test_index_redirect/ui/sub/foo/custom.html

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>ui/sub/foo/custom.html</title>
+</head>
+<body>
+  <h1>ui/sub/foo/custom.html</h1>
+  <p>IDENTIFIER: ui/sub/foo/custom.html</p>
+  <p>Directory routes: <a href="/">/</a> | <a href="/sub">/sub</a> | <a href="/sub/foo">/sub/foo</a></p>
+  <h2>All test files</h2>
+  <ul>
+    <li><a href="/custom.html">/custom.html</a></li>
+    <li><a href="/index.html">/index.html</a></li>
+    <li><a href="/index.css">/index.css</a></li>
+    <li><a href="/index.js">/index.js</a></li>
+    <li><a href="/sub/custom.html">/sub/custom.html</a></li>
+    <li><a href="/sub/index.html">/sub/index.html</a></li>
+    <li><a href="/sub/index.css">/sub/index.css</a></li>
+    <li><a href="/sub/index.js">/sub/index.js</a></li>
+    <li><a href="/sub/foo/custom.html">/sub/foo/custom.html</a></li>
+    <li><a href="/sub/foo/index.html">/sub/foo/index.html</a></li>
+    <li><a href="/sub/foo/index.css">/sub/foo/index.css</a></li>
+    <li><a href="/sub/foo/index.js">/sub/foo/index.js</a></li>
+  </ul>
+<script src="/webui.js"></script>
+</body>
+</html>

examples/C++/test_index_redirect/ui/sub/foo/index.css

@@ -0,0 +1,4 @@
+/* IDENTIFIER: ui/sub/foo/index.css */
+/* Directory routes: / | /sub | /sub/foo */
+/* All files: /custom.html /index.html /index.css /index.js /sub/custom.html /sub/index.html /sub/index.css /sub/index.js /sub/foo/custom.html /sub/foo/index.html /sub/foo/index.css /sub/foo/index.js */
+body { font-family: monospace; }

examples/C++/test_index_redirect/ui/sub/foo/index.html

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>ui/sub/foo/index.html</title>
+</head>
+<body>
+  <h1>ui/sub/foo/index.html</h1>
+  <p>IDENTIFIER: ui/sub/foo/index.html</p>
+  <p>Directory routes: <a href="/">/</a> | <a href="/sub">/sub</a> | <a href="/sub/foo">/sub/foo</a></p>
+  <h2>All test files</h2>
+  <ul>
+    <li><a href="/custom.html">/custom.html</a></li>
+    <li><a href="/index.html">/index.html</a></li>
+    <li><a href="/index.css">/index.css</a></li>
+    <li><a href="/index.js">/index.js</a></li>
+    <li><a href="/sub/custom.html">/sub/custom.html</a></li>
+    <li><a href="/sub/index.html">/sub/index.html</a></li>
+    <li><a href="/sub/index.css">/sub/index.css</a></li>
+    <li><a href="/sub/index.js">/sub/index.js</a></li>
+    <li><a href="/sub/foo/custom.html">/sub/foo/custom.html</a></li>
+    <li><a href="/sub/foo/index.html">/sub/foo/index.html</a></li>
+    <li><a href="/sub/foo/index.css">/sub/foo/index.css</a></li>
+    <li><a href="/sub/foo/index.js">/sub/foo/index.js</a></li>
+  </ul>
+<script src="/webui.js"></script>
+</body>
+</html>

examples/C++/test_index_redirect/ui/sub/foo/index.js

@@ -0,0 +1,4 @@
+// IDENTIFIER: ui/sub/foo/index.js
+// Directory routes: / | /sub | /sub/foo
+// All files: /custom.html /index.html /index.css /index.js /sub/custom.html /sub/index.html /sub/index.css /sub/index.js /sub/foo/custom.html /sub/foo/index.html /sub/foo/index.css /sub/foo/index.js
+console.log('IDENTIFIER: ui/sub/foo/index.js');

examples/C++/test_index_redirect/ui/sub/index.css

@@ -0,0 +1,4 @@
+/* IDENTIFIER: ui/sub/index.css */
+/* Directory routes: / | /sub | /sub/foo */
+/* All files: /custom.html /index.html /index.css /index.js /sub/custom.html /sub/index.html /sub/index.css /sub/index.js /sub/foo/custom.html /sub/foo/index.html /sub/foo/index.css /sub/foo/index.js */
+body { font-family: monospace; }

examples/C++/test_index_redirect/ui/sub/index.html

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>ui/sub/index.html</title>
+</head>
+<body>
+  <h1>ui/sub/index.html</h1>
+  <p>IDENTIFIER: ui/sub/index.html</p>
+  <p>Directory routes: <a href="/">/</a> | <a href="/sub">/sub</a> | <a href="/sub/foo">/sub/foo</a></p>
+  <h2>All test files</h2>
+  <ul>
+    <li><a href="/custom.html">/custom.html</a></li>
+    <li><a href="/index.html">/index.html</a></li>
+    <li><a href="/index.css">/index.css</a></li>
+    <li><a href="/index.js">/index.js</a></li>
+    <li><a href="/sub/custom.html">/sub/custom.html</a></li>
+    <li><a href="/sub/index.html">/sub/index.html</a></li>
+    <li><a href="/sub/index.css">/sub/index.css</a></li>
+    <li><a href="/sub/index.js">/sub/index.js</a></li>
+    <li><a href="/sub/foo/custom.html">/sub/foo/custom.html</a></li>
+    <li><a href="/sub/foo/index.html">/sub/foo/index.html</a></li>
+    <li><a href="/sub/foo/index.css">/sub/foo/index.css</a></li>
+    <li><a href="/sub/foo/index.js">/sub/foo/index.js</a></li>
+  </ul>
+<script src="/webui.js"></script>
+</body>
+</html>

examples/C++/test_index_redirect/ui/sub/index.js

@@ -0,0 +1,4 @@
+// IDENTIFIER: ui/sub/index.js
+// Directory routes: / | /sub | /sub/foo
+// All files: /custom.html /index.html /index.css /index.js /sub/custom.html /sub/index.html /sub/index.css /sub/index.js /sub/foo/custom.html /sub/foo/index.html /sub/foo/index.css /sub/foo/index.js
+console.log('IDENTIFIER: ui/sub/index.js');