Add NebulaController, tab manager, and CEF clients

Introduce core application structure and browser management: add NebulaController and run entry (src/app/*) to centralize window, tab and CEF lifecycle logic; implement TabManager and NebulaTab (src/browser/*) for tab creation, navigation and state tracking; add URL utilities (NormalizeNavigationInput, JsonEscape) and CEF browser client glue (src/cef/browser_client.cpp/.h) to forward chrome commands and content events. Update app/main.cpp to delegate startup to nebula::app::RunNebula. Add UI assets (chrome.html, chrome.css, chrome.js, lucide, menu-popup updates) and remove obsolete nebot.html. Update CMakeLists to include new sources, add ${CMAKE_SOURCE_DIR}/src to includes and link dwmapi on Windows. Overall this refactors startup and splits responsibilities for cleaner tab and browser lifecycle handling.
2026-05-14 10:18:51 +12:00
parent 207a849f06
commit a8786b4c1c
23 changed files with 2835 additions and 330 deletions
@@ -0,0 +1,222 @@
+#include "cef/browser_client.h"
+
+#include "include/cef_request.h"
+#include "include/wrapper/cef_helpers.h"
+#include "ui/paths.h"
+
+namespace nebula::cef {
+namespace {
+
+constexpr char kChromeCommandMessage[] = "NebulaChromeCommand";
+
+std::vector<std::string> ToStringVector(const std::vector<CefString>& values) {
+    std::vector<std::string> result;
+    result.reserve(values.size());
+    for (const auto& value : values) {
+        result.push_back(value.ToString());
+    }
+    return result;
+}
+
+}  // namespace
+
+NebulaBrowserClient::NebulaBrowserClient(BrowserRole role, BrowserClientDelegate* delegate)
+    : role_(role), delegate_(delegate) {}
+
+bool NebulaBrowserClient::OnProcessMessageReceived(CefRefPtr<CefBrowser> browser,
+                                                   CefRefPtr<CefFrame> frame,
+                                                   CefProcessId source_process,
+                                                   CefRefPtr<CefProcessMessage> message) {
+    CEF_REQUIRE_UI_THREAD();
+    UNREFERENCED_PARAMETER(browser);
+    UNREFERENCED_PARAMETER(frame);
+    UNREFERENCED_PARAMETER(source_process);
+
+    if ((role_ != BrowserRole::Chrome && role_ != BrowserRole::MenuPopup) || !message ||
+        message->GetName().ToString() != kChromeCommandMessage) {
+        return false;
+    }
+
+    CefRefPtr<CefListValue> args = message->GetArgumentList();
+    const std::string command = args && args->GetSize() > 0 ? args->GetString(0).ToString() : "";
+    const std::string payload = args && args->GetSize() > 1 ? args->GetString(1).ToString() : "";
+    if (delegate_ && !command.empty()) {
+        delegate_->OnChromeCommand(command, payload);
+        return true;
+    }
+
+    return false;
+}
+
+void NebulaBrowserClient::OnAddressChange(CefRefPtr<CefBrowser> browser,
+                                          CefRefPtr<CefFrame> frame,
+                                          const CefString& url) {
+    CEF_REQUIRE_UI_THREAD();
+    if (role_ == BrowserRole::Content && delegate_ && frame && frame->IsMain()) {
+        delegate_->OnContentAddressChanged(browser, url.ToString());
+    }
+}
+
+void NebulaBrowserClient::OnTitleChange(CefRefPtr<CefBrowser> browser,
+                                        const CefString& title) {
+    CEF_REQUIRE_UI_THREAD();
+    if (role_ == BrowserRole::Content && delegate_) {
+        delegate_->OnContentTitleChanged(browser, title.ToString());
+    }
+}
+
+void NebulaBrowserClient::OnFaviconURLChange(CefRefPtr<CefBrowser> browser,
+                                             const std::vector<CefString>& icon_urls) {
+    CEF_REQUIRE_UI_THREAD();
+    if (role_ == BrowserRole::Content && delegate_) {
+        delegate_->OnContentFaviconChanged(browser, ToStringVector(icon_urls));
+    }
+}
+
+bool NebulaBrowserClient::OnPreKeyEvent(CefRefPtr<CefBrowser> browser,
+                                        const CefKeyEvent& event,
+                                        CefEventHandle os_event,
+                                        bool* is_keyboard_shortcut) {
+    CEF_REQUIRE_UI_THREAD();
+    UNREFERENCED_PARAMETER(os_event);
+
+    if (role_ == BrowserRole::Content &&
+        event.type == KEYEVENT_RAWKEYDOWN &&
+        (event.modifiers & EVENTFLAG_CONTROL_DOWN) != 0 &&
+        event.windows_key_code == 'T') {
+        if (is_keyboard_shortcut) {
+            *is_keyboard_shortcut = true;
+        }
+        if (delegate_) {
+            delegate_->OnPopupRequested(browser, nebula::ui::GetHomeUrl());
+        }
+        return true;
+    }
+
+    return false;
+}
+
+bool NebulaBrowserClient::OnBeforePopup(CefRefPtr<CefBrowser> browser,
+                                        CefRefPtr<CefFrame> frame,
+                                        int popup_id,
+                                        const CefString& target_url,
+                                        const CefString& target_frame_name,
+                                        CefLifeSpanHandler::WindowOpenDisposition target_disposition,
+                                        bool user_gesture,
+                                        const CefPopupFeatures& popupFeatures,
+                                        CefWindowInfo& windowInfo,
+                                        CefRefPtr<CefClient>& client,
+                                        CefBrowserSettings& settings,
+                                        CefRefPtr<CefDictionaryValue>& extra_info,
+                                        bool* no_javascript_access) {
+    CEF_REQUIRE_UI_THREAD();
+    UNREFERENCED_PARAMETER(frame);
+    UNREFERENCED_PARAMETER(popup_id);
+    UNREFERENCED_PARAMETER(target_frame_name);
+    UNREFERENCED_PARAMETER(target_disposition);
+    UNREFERENCED_PARAMETER(user_gesture);
+    UNREFERENCED_PARAMETER(popupFeatures);
+    UNREFERENCED_PARAMETER(windowInfo);
+    UNREFERENCED_PARAMETER(client);
+    UNREFERENCED_PARAMETER(settings);
+    UNREFERENCED_PARAMETER(extra_info);
+    UNREFERENCED_PARAMETER(no_javascript_access);
+
+    if (role_ == BrowserRole::Content && delegate_) {
+        delegate_->OnPopupRequested(browser, target_url.ToString());
+        return true;
+    }
+
+    return false;
+}
+
+void NebulaBrowserClient::OnAfterCreated(CefRefPtr<CefBrowser> browser) {
+    CEF_REQUIRE_UI_THREAD();
+    if (delegate_) {
+        delegate_->OnBrowserCreated(role_, browser);
+    }
+}
+
+void NebulaBrowserClient::OnBeforeClose(CefRefPtr<CefBrowser> browser) {
+    CEF_REQUIRE_UI_THREAD();
+    if (delegate_) {
+        delegate_->OnBrowserClosing(role_, browser);
+    }
+}
+
+void NebulaBrowserClient::OnLoadingStateChange(CefRefPtr<CefBrowser> browser,
+                                               bool isLoading,
+                                               bool canGoBack,
+                                               bool canGoForward) {
+    CEF_REQUIRE_UI_THREAD();
+    UNREFERENCED_PARAMETER(canGoBack);
+    UNREFERENCED_PARAMETER(canGoForward);
+
+    if (role_ == BrowserRole::Content && delegate_) {
+        delegate_->OnContentLoadingStateChanged(browser, isLoading);
+    }
+}
+
+void NebulaBrowserClient::OnLoadStart(CefRefPtr<CefBrowser> browser,
+                                      CefRefPtr<CefFrame> frame,
+                                      TransitionType transition_type) {
+    CEF_REQUIRE_UI_THREAD();
+    UNREFERENCED_PARAMETER(transition_type);
+
+    if (role_ == BrowserRole::Content && delegate_ && frame && frame->IsMain()) {
+        delegate_->OnContentLoadProgressChanged(browser, 0.12);
+    }
+}
+
+void NebulaBrowserClient::OnLoadEnd(CefRefPtr<CefBrowser> browser,
+                                    CefRefPtr<CefFrame> frame,
+                                    int httpStatusCode) {
+    CEF_REQUIRE_UI_THREAD();
+    UNREFERENCED_PARAMETER(httpStatusCode);
+
+    if (role_ == BrowserRole::Content && delegate_ && frame && frame->IsMain()) {
+        delegate_->OnContentLoadProgressChanged(browser, 1.0);
+    }
+}
+
+bool NebulaBrowserClient::OnBeforeBrowse(CefRefPtr<CefBrowser> browser,
+                                         CefRefPtr<CefFrame> frame,
+                                         CefRefPtr<CefRequest> request,
+                                         bool user_gesture,
+                                         bool is_redirect) {
+    CEF_REQUIRE_UI_THREAD();
+    UNREFERENCED_PARAMETER(browser);
+    UNREFERENCED_PARAMETER(user_gesture);
+    UNREFERENCED_PARAMETER(is_redirect);
+
+    if (role_ == BrowserRole::Content && frame && frame->IsMain() && request &&
+        nebula::ui::IsChromiumNewTabUrl(request->GetURL().ToString())) {
+        frame->LoadURL(nebula::ui::GetHomeUrl());
+        return true;
+    }
+
+    return false;
+}
+
+bool NebulaBrowserClient::OnShowPermissionPrompt(
+    CefRefPtr<CefBrowser> browser,
+    uint64_t prompt_id,
+    const CefString& requesting_origin,
+    uint32_t requested_permissions,
+    CefRefPtr<CefPermissionPromptCallback> callback) {
+    CEF_REQUIRE_UI_THREAD();
+    UNREFERENCED_PARAMETER(prompt_id);
+    UNREFERENCED_PARAMETER(requesting_origin);
+
+    if (role_ == BrowserRole::Content &&
+        (requested_permissions & CEF_PERMISSION_TYPE_GEOLOCATION) != 0 &&
+        browser && callback &&
+        nebula::ui::IsInternalHomeUrl(browser->GetMainFrame()->GetURL().ToString())) {
+        callback->Continue(CEF_PERMISSION_RESULT_ACCEPT);
+        return true;
+    }
+
+    return false;
+}
+
+}  // namespace nebula::cef
@@ -0,0 +1,118 @@
+#pragma once
+
+#include <string>
+#include <vector>
+
+#include "include/cef_client.h"
+#include "include/cef_display_handler.h"
+#include "include/cef_keyboard_handler.h"
+#include "include/cef_life_span_handler.h"
+#include "include/cef_load_handler.h"
+#include "include/cef_permission_handler.h"
+#include "include/cef_request_handler.h"
+
+namespace nebula::cef {
+
+enum class BrowserRole {
+    Chrome,
+    Content,
+    MenuPopup,
+};
+
+class BrowserClientDelegate {
+public:
+    virtual ~BrowserClientDelegate() = default;
+    virtual void OnBrowserCreated(BrowserRole role, CefRefPtr<CefBrowser> browser) = 0;
+    virtual void OnBrowserClosing(BrowserRole role, CefRefPtr<CefBrowser> browser) = 0;
+    virtual void OnChromeCommand(const std::string& command, const std::string& payload) = 0;
+    virtual void OnContentAddressChanged(CefRefPtr<CefBrowser> browser, const std::string& url) = 0;
+    virtual void OnContentTitleChanged(CefRefPtr<CefBrowser> browser, const std::string& title) = 0;
+    virtual void OnContentLoadingStateChanged(CefRefPtr<CefBrowser> browser, bool is_loading) = 0;
+    virtual void OnContentLoadProgressChanged(CefRefPtr<CefBrowser> browser, double progress) = 0;
+    virtual void OnContentFaviconChanged(CefRefPtr<CefBrowser> browser, const std::vector<std::string>& urls) = 0;
+    virtual void OnPopupRequested(CefRefPtr<CefBrowser> browser, const std::string& target_url) = 0;
+};
+
+class NebulaBrowserClient final : public CefClient,
+                                 public CefDisplayHandler,
+                                 public CefKeyboardHandler,
+                                 public CefLifeSpanHandler,
+                                 public CefLoadHandler,
+                                 public CefPermissionHandler,
+                                 public CefRequestHandler {
+public:
+    NebulaBrowserClient(BrowserRole role, BrowserClientDelegate* delegate);
+
+    CefRefPtr<CefDisplayHandler> GetDisplayHandler() override { return this; }
+    CefRefPtr<CefKeyboardHandler> GetKeyboardHandler() override { return this; }
+    CefRefPtr<CefLifeSpanHandler> GetLifeSpanHandler() override { return this; }
+    CefRefPtr<CefLoadHandler> GetLoadHandler() override { return this; }
+    CefRefPtr<CefPermissionHandler> GetPermissionHandler() override { return this; }
+    CefRefPtr<CefRequestHandler> GetRequestHandler() override { return this; }
+
+    bool OnProcessMessageReceived(CefRefPtr<CefBrowser> browser,
+                                  CefRefPtr<CefFrame> frame,
+                                  CefProcessId source_process,
+                                  CefRefPtr<CefProcessMessage> message) override;
+
+    void OnAddressChange(CefRefPtr<CefBrowser> browser,
+                         CefRefPtr<CefFrame> frame,
+                         const CefString& url) override;
+    void OnTitleChange(CefRefPtr<CefBrowser> browser,
+                       const CefString& title) override;
+    void OnFaviconURLChange(CefRefPtr<CefBrowser> browser,
+                            const std::vector<CefString>& icon_urls) override;
+
+    bool OnPreKeyEvent(CefRefPtr<CefBrowser> browser,
+                       const CefKeyEvent& event,
+                       CefEventHandle os_event,
+                       bool* is_keyboard_shortcut) override;
+
+    bool OnBeforePopup(CefRefPtr<CefBrowser> browser,
+                       CefRefPtr<CefFrame> frame,
+                       int popup_id,
+                       const CefString& target_url,
+                       const CefString& target_frame_name,
+                       CefLifeSpanHandler::WindowOpenDisposition target_disposition,
+                       bool user_gesture,
+                       const CefPopupFeatures& popupFeatures,
+                       CefWindowInfo& windowInfo,
+                       CefRefPtr<CefClient>& client,
+                       CefBrowserSettings& settings,
+                       CefRefPtr<CefDictionaryValue>& extra_info,
+                       bool* no_javascript_access) override;
+
+    void OnAfterCreated(CefRefPtr<CefBrowser> browser) override;
+    void OnBeforeClose(CefRefPtr<CefBrowser> browser) override;
+
+    void OnLoadingStateChange(CefRefPtr<CefBrowser> browser,
+                              bool isLoading,
+                              bool canGoBack,
+                              bool canGoForward) override;
+    void OnLoadStart(CefRefPtr<CefBrowser> browser,
+                     CefRefPtr<CefFrame> frame,
+                     TransitionType transition_type) override;
+    void OnLoadEnd(CefRefPtr<CefBrowser> browser,
+                   CefRefPtr<CefFrame> frame,
+                   int httpStatusCode) override;
+
+    bool OnBeforeBrowse(CefRefPtr<CefBrowser> browser,
+                        CefRefPtr<CefFrame> frame,
+                        CefRefPtr<CefRequest> request,
+                        bool user_gesture,
+                        bool is_redirect) override;
+
+    bool OnShowPermissionPrompt(CefRefPtr<CefBrowser> browser,
+                                uint64_t prompt_id,
+                                const CefString& requesting_origin,
+                                uint32_t requested_permissions,
+                                CefRefPtr<CefPermissionPromptCallback> callback) override;
+
+private:
+    BrowserRole role_;
+    BrowserClientDelegate* delegate_ = nullptr;
+
+    IMPLEMENT_REFCOUNTING(NebulaBrowserClient);
+};
+
+}  // namespace nebula::cef
@@ -0,0 +1,79 @@
+#include "cef/nebula_app.h"
+
+#include "include/cef_process_message.h"
+#include "include/wrapper/cef_helpers.h"
+
+namespace nebula::cef {
+namespace {
+
+constexpr char kChromeCommandMessage[] = "NebulaChromeCommand";
+
+class NativeBridgeHandler final : public CefV8Handler {
+public:
+    bool Execute(const CefString& name,
+                 CefRefPtr<CefV8Value> object,
+                 const CefV8ValueList& arguments,
+                 CefRefPtr<CefV8Value>& retval,
+                 CefString& exception) override {
+        UNREFERENCED_PARAMETER(object);
+        UNREFERENCED_PARAMETER(retval);
+
+        if (name != "postMessage") {
+            return false;
+        }
+
+        if (arguments.empty() || !arguments[0]->IsString()) {
+            exception = "nebulaNative.postMessage requires a command string.";
+            return true;
+        }
+
+        CefRefPtr<CefV8Context> context = CefV8Context::GetCurrentContext();
+        CefRefPtr<CefBrowser> browser = context ? context->GetBrowser() : nullptr;
+        CefRefPtr<CefFrame> frame = context ? context->GetFrame() : nullptr;
+        if (!browser || !frame) {
+            exception = "No CEF frame is available for native messaging.";
+            return true;
+        }
+
+        CefRefPtr<CefProcessMessage> message = CefProcessMessage::Create(kChromeCommandMessage);
+        CefRefPtr<CefListValue> args = message->GetArgumentList();
+        args->SetString(0, arguments[0]->GetStringValue());
+        args->SetString(1, arguments.size() > 1 && arguments[1]->IsString()
+                               ? arguments[1]->GetStringValue()
+                               : CefString());
+
+        frame->SendProcessMessage(PID_BROWSER, message);
+        return true;
+    }
+
+private:
+    IMPLEMENT_REFCOUNTING(NativeBridgeHandler);
+};
+
+}  // namespace
+
+void NebulaApp::OnBeforeCommandLineProcessing(const CefString& process_type,
+                                              CefRefPtr<CefCommandLine> command_line) {
+    UNREFERENCED_PARAMETER(process_type);
+
+    // The bundled UI is loaded from file:// and uses ES modules.
+    command_line->AppendSwitch("allow-file-access-from-files");
+}
+
+void NebulaApp::OnContextCreated(CefRefPtr<CefBrowser> browser,
+                                 CefRefPtr<CefFrame> frame,
+                                 CefRefPtr<CefV8Context> context) {
+    CEF_REQUIRE_RENDERER_THREAD();
+    UNREFERENCED_PARAMETER(browser);
+    UNREFERENCED_PARAMETER(frame);
+
+    CefRefPtr<CefV8Value> global = context->GetGlobal();
+    CefRefPtr<CefV8Value> native = CefV8Value::CreateObject(nullptr, nullptr);
+    native->SetValue(
+        "postMessage",
+        CefV8Value::CreateFunction("postMessage", new NativeBridgeHandler()),
+        V8_PROPERTY_ATTRIBUTE_NONE);
+    global->SetValue("nebulaNative", native, V8_PROPERTY_ATTRIBUTE_READONLY);
+}
+
+}  // namespace nebula::cef
@@ -0,0 +1,25 @@
+#pragma once
+
+#include "include/cef_app.h"
+#include "include/cef_render_process_handler.h"
+#include "include/cef_v8.h"
+
+namespace nebula::cef {
+
+class NebulaApp final : public CefApp,
+                       public CefRenderProcessHandler {
+public:
+    CefRefPtr<CefRenderProcessHandler> GetRenderProcessHandler() override { return this; }
+
+    void OnBeforeCommandLineProcessing(const CefString& process_type,
+                                       CefRefPtr<CefCommandLine> command_line) override;
+
+    void OnContextCreated(CefRefPtr<CefBrowser> browser,
+                          CefRefPtr<CefFrame> frame,
+                          CefRefPtr<CefV8Context> context) override;
+
+private:
+    IMPLEMENT_REFCOUNTING(NebulaApp);
+};
+
+}  // namespace nebula::cef