plusui-native-core 0.1.105 → 0.1.107

package/Core/include/plusui/api.hpp

@@ -1,237 +1,237 @@
-#pragma once
-
-/**
- * PlusUI C++ API
- *
- * Mirrors: Core/Features/API/index.ts
- *
- * ONE INCLUDE. ALL FEATURES.
- *
- *   #include <plusui/plusui>   // get everything
- *   using namespace plusui;
- *
- * ─────────────────────────────────────────────────────────────────────────────
- * FEATURE MAP  (C++ class ↔ TypeScript object)
- * ─────────────────────────────────────────────────────────────────────────────
- *
- *  TypeScript          C++ class / accessor       Header
- *  ─────────────────── ────────────────────────── ──────────────────
- *  window              Window                     window.hpp
- *  app / createApp()   App, App::Builder          app.hpp
- *  browser             Browser                    browser.hpp
- *  clipboard           Clipboard                  clipboard.hpp
- *  keyboard            Keyboard                   keyboard.hpp
- *  tray                TrayManager                tray.hpp
- *  display             DisplayManager             display.hpp
- *  menu                MenuManager                menu.hpp
- *  router              Router                     router.hpp
- *  fileDrop            FileDrop                   filedrop.hpp
- *  gpu                 WebGPU                     webgpu.hpp
- *  connect             Connect                    connect.hpp
- *
- * ─────────────────────────────────────────────────────────────────────────────
- * FRONTEND ↔ BACKEND MIRROR
- * ─────────────────────────────────────────────────────────────────────────────
- *
- * IMPORT / INCLUDE
- *   TS:   import plusui from 'plusui'
- *   C++:  #include <plusui/plusui>
- *         using namespace plusui;
- *
- * ── WINDOW ───────────────────────────────────────────────────────────────────
- * Actions
- *   TS:   window.show()                   C++:  win.show()
- *   TS:   window.hide()                   C++:  win.hide()
- *   TS:   window.minimize()               C++:  win.minimize()
- *   TS:   window.maximize()               C++:  win.maximize()
- *   TS:   window.restore()                C++:  win.restore()
- *   TS:   window.close()                  C++:  win.close()
- *   TS:   window.center()                 C++:  win.center()
- *   TS:   window.focus()                  C++:  win.focus()
- *   TS:   window.setTitle("My App")       C++:  win.setTitle("My App")
- *   TS:   window.setSize(800, 600)        C++:  win.setSize(800, 600)
- *   TS:   window.setPosition(100, 100)    C++:  win.setPosition(100, 100)
- *   TS:   window.setFullscreen(true)      C++:  win.setFullscreen(true)
- *   TS:   window.setAlwaysOnTop(true)     C++:  win.setAlwaysOnTop(true)
- *   TS:   window.setResizable(false)      C++:  win.setResizable(false)
- *   TS:   window.setDecorations(false)    C++:  win.setDecorations(false)
- *   TS:   window.setTransparency(0.5)     C++:  win.setOpacity(0.5)
- *   TS:   window.setIcon(path)            C++:  win.setIconFromMemory(data, size)
- *   TS:   window.isMaximized()            C++:  win.isMaximized()
- *   TS:   window.isMinimized()            C++:  win.isMinimized()
- *   TS:   window.isVisible()              C++:  win.isVisible()
- * Events
- *   TS:   window.onResize(cb)             C++:  win.onResize(cb)
- *   TS:   window.onMove(cb)               C++:  win.onMove(cb)
- *   TS:   window.onClose(cb)              C++:  win.onClose(cb)
- *   TS:   window.onFocus(cb)              C++:  win.onFocus(cb)
- *   TS:   window.onStateChange(cb)        C++:  win.onStateChange(cb)
- *   TS:   window.onFileDrop(cb)           C++:  win.onFileDrop(cb)
- *
- * ── APP ──────────────────────────────────────────────────────────────────────
- *   TS:   createApp()                     C++:  createApp()
- *     .title("My App")                          .title("My App")
- *     .width(1200)                              .width(1200)
- *     .height(800)                              .height(800)
- *     .devtools(true)                           .devtools(true)
- *     .fileDrop(true);                    .fileDrop(true)
- *                                               .build()   ← returns Window
- *   TS:   app.quit()                      C++:  app.quit()
- *   TS:   app.onReady(cb)                 C++:  (start after build())
- *   TS:   app.onQuit(cb)                  C++:  app.run()  ← blocks until quit
- *
- * ── ROUTER ───────────────────────────────────────────────────────────────────
- *   TS:   router.setRoutes({'/': url})    C++:  Router::instance().setRoutes({...})
- *   TS:   router.push("/settings")        C++:  Router::instance().push("/settings")
- *   TS:   router.replace("/settings")     C++:  Router::instance().replace("/settings")
- *   TS:   router.getCurrentRoute()        C++:  Router::instance().getCurrentRoute()
- *   TS:   router.setInitialRoute("/")     C++:  Router::instance().setInitialRoute("/")
- *   TS:   router.onRouteChange(cb)        C++:  Router::instance().onRouteChange(cb)
- *
- * ── BROWSER (WebView navigation) ─────────────────────────────────────────────
- *   TS:   browser.navigate(url)           C++:  browser.navigate(url)
- *   TS:   browser.open(url)               C++:  browser.navigate(url)
- *   TS:   browser.openExternal(url)       C++:  browser.openExternal(url)
- *   TS:   browser.openNewWindow(url)      C++:  browser.openNewWindow(url)
- *   TS:   browser.goBack()                C++:  browser.goBack()
- *   TS:   browser.goForward()             C++:  browser.goForward()
- *   TS:   browser.reload()                C++:  browser.reload()
- *   TS:   browser.stop()                  C++:  browser.stop()
- *   TS:   browser.getUrl()                C++:  browser.getURL()
- *   TS:   browser.getTitle()              C++:  browser.getTitle()
- *   TS:   browser.getState()              C++:  browser.getState()
- *   TS:   browser.canGoBack()             C++:  browser.canGoBack()
- *   TS:   browser.canGoForward()          C++:  browser.canGoForward()
- *   TS:   browser.isLoading()             C++:  browser.isLoading()
- * Events
- *   TS:   browser.onNavigate(cb)          C++:  browser.onNavigate(cb)
- *   TS:   browser.onStateChange(cb)       C++:  browser.onStateChange(cb)
- *   TS:   browser.onLoadStart(cb)         C++:  browser.onLoadStart(cb)
- *   TS:   browser.onLoadEnd(cb)           C++:  browser.onLoadEnd(cb)
- *   TS:   browser.onLoadError(cb)         C++:  browser.onLoadError(cb)
- *
- * ── CLIPBOARD ────────────────────────────────────────────────────────────────
- *   TS:   clipboard.getText()             C++:  Clipboard::getText()
- *   TS:   clipboard.setText("hello")      C++:  Clipboard::setText("hello")
- *   TS:   clipboard.hasText()             C++:  Clipboard::hasText()
- *   TS:   clipboard.getImage()            C++:  Clipboard::getImage()
- *   TS:   clipboard.setImage(b64)         C++:  Clipboard::setImage(b64)
- *   TS:   clipboard.hasImage()            C++:  Clipboard::hasImage()
- *   TS:   clipboard.clear()               C++:  Clipboard::clear()
- *   TS:   clipboard.onChange(cb)          C++:  Clipboard::instance().onChange(cb)
- *
- * ── KEYBOARD ─────────────────────────────────────────────────────────────────
- *   TS:   keyboard.isKeyPressed(key)      C++:  Keyboard::instance().isKeyPressed(key)
- *   TS:   keyboard.registerShortcut(...)  C++:  Keyboard::instance().registerShortcut(...)
- *   TS:   keyboard.unregisterShortcut(id) C++:  Keyboard::instance().unregisterShortcut(id)
- *   TS:   keyboard.clearShortcuts()       C++:  Keyboard::instance().clearShortcuts()
- *   TS:   keyboard.onKeyDown(cb)          C++:  Keyboard::instance().onKeyDown(cb)
- *   TS:   keyboard.onKeyUp(cb)            C++:  Keyboard::instance().onKeyUp(cb)
- *   TS:   keyboard.onShortcut(cb)         C++:  Keyboard::instance().onShortcut(cb)
- *
- * ── TRAY ─────────────────────────────────────────────────────────────────────
- *   TS:   tray.setIcon(path)              C++:  win.tray().setIcon(path)
- *   TS:   tray.setTooltip(text)           C++:  win.tray().setTooltip(text)
- *   TS:   tray.setVisible(true)           C++:  win.tray().setVisible(true)
- *   TS:   tray.setMenu(items)             C++:  win.tray().setMenu(items)
- *   TS:   tray.setContextMenu(items)      C++:  win.tray().setContextMenu(items)
- *   TS:   tray.onClick(cb)                C++:  win.tray().onClick(cb)
- *   TS:   tray.onDoubleClick(cb)          C++:  win.tray().onDoubleClick(cb)
- *   TS:   tray.onRightClick(cb)           C++:  win.tray().onRightClick(cb)
- *   TS:   tray.onMenuItemClick(cb)        C++:  win.tray().onMenuItemClick(cb)
- *
- * ── DISPLAY ──────────────────────────────────────────────────────────────────
- *   TS:   display.getAllDisplays()         C++:  DisplayManager::instance().getAllDisplays()
- *   TS:   display.getPrimaryDisplay()      C++:  DisplayManager::instance().getPrimary()
- *   TS:   display.getDisplayAt(x, y)       C++:  DisplayManager::instance().getAt(x, y)
- *   TS:   display.getScreenWidth()         C++:  DisplayManager::instance().getScreenWidth()
- *   TS:   display.getScreenHeight()        C++:  DisplayManager::instance().getScreenHeight()
- *   TS:   display.onConnected(cb)          C++:  DisplayManager::instance().onConnected(cb)
- *   TS:   display.onDisconnected(cb)       C++:  DisplayManager::instance().onDisconnected(cb)
- *   TS:   display.onChanged(cb)            C++:  DisplayManager::instance().onChanged(cb)
- *
- * ── MENU ─────────────────────────────────────────────────────────────────────
- *   TS:   menu.create(items)              C++:  MenuManager::instance().create(items)
- *   TS:   menu.popup(id, x, y)            C++:  MenuManager::instance().popup(id, x, y)
- *   TS:   menu.setApplicationMenu(items)  C++:  MenuManager::instance().setApplicationMenu(items)
- *   TS:   menu.showContextMenu(items)     C++:  MenuManager::instance().showContextMenu(items)
- *   TS:   menu.onItemClick(cb)            C++:  MenuManager::instance().onItemClick(cb)
- *   TS:   menu.onContextOpen(cb)          C++:  MenuManager::instance().onContextOpen(cb)
- *
- * ── FILEDROP ─────────────────────────────────────────────────────────────────
- *   TS:   fileDrop.setEnabled(true)       C++:  FileDrop::instance().setEnabled(true)
- *   TS:   fileDrop.startDrag(paths)       C++:  FileDrop::instance().startDrag(paths)
- *   TS:   fileDrop.onFilesDropped(cb)     C++:  FileDrop::instance().onFilesDropped(cb)
- *   TS:   fileDrop.onDragEnter(cb)        C++:  FileDrop::instance().onDragEnter(cb)
- *   TS:   fileDrop.onDragLeave(cb)        C++:  FileDrop::instance().onDragLeave(cb)
- *
- * ── GPU (WebGPU) ──────────────────────────────────────────────────────────────
- *   TS:   gpu.requestAdapter()            C++:  WebGPU::instance().requestAdapter()
- *   TS:   gpu.getPreferredCanvasFormat()  C++:  WebGPU::instance().getPreferredCanvasFormat()
- *   TS:   gpu.onAdapterLost(cb)           C++:  WebGPU::instance().onAdapterLost(cb)
- *   TS:   gpu.onDeviceLost(cb)            C++:  WebGPU::instance().onDeviceLost(cb)
- *   TS:   gpu.onError(cb)                 C++:  WebGPU::instance().onError(cb)
- *
- * ── CONNECT (custom bidirectional channels) ───────────────────────────────────
- *   TS:   connect.emit("name", data)      C++:  connect.emit("name", {{"key", val}})
- *   TS:   connect.on("name", cb)          C++:  connect.on("name", cb)
- *   TS:   connect.on("name", cb)          C++:  connect.on("name", [](const json& d){ ... })
- *   TS:   createChannel("name")           C++:  connect.channel("name")
- *   TS:   createFeatureConnect("scope")   C++:  connect.feature("scope")
- *   TS:   handleMessage override          C++:  override handleMessage(name, data)
- *
- * ─────────────────────────────────────────────────────────────────────────────
- * USAGE EXAMPLE
- * ─────────────────────────────────────────────────────────────────────────────
- *
- *   #include <plusui/plusui>
- *   using namespace plusui;
- *
- *   class MyApp : public Connect {
- *   protected:
- *     void handleMessage(const std::string& name, const nlohmann::json& data) override {
- *       if (name == "greet") {
- *         emit("greeting", {{"message", "Hello " + data["name"].get<std::string>()}});
- *       }
- *     }
- *   };
- *
- *   int main() {
- *     auto win = createApp()
- *       .title("My App")
- *       .width(1200)
- *       .height(800)
- *       .fileDrop(true)
- *       .build();
- *
- *     MyApp connect;
- *     bindConnect(win, connect);
- *
- *     win.loadURL("http://localhost:5173");
- *
- *     win.onClose([]{ app.quit(); });
- *     win.tray().setIcon("icon.png");
- *     win.tray().onClick([&](int, int){ win.show(); });
- *
- *     Router::instance().setRoutes({{"/", "http://localhost:5173"}});
- *     Router::instance().push("/");
- *
- *     app.run();
- *   }
- */
-
-// ─── Feature Headers ──────────────────────────────────────────────────────────
-
-#include <plusui/app.hpp>
-#include <plusui/browser.hpp>
-#include <plusui/clipboard.hpp>
-#include <plusui/connect.hpp>
-#include <plusui/connection.hpp>
-#include <plusui/display.hpp>
-#include <plusui/filedrop.hpp>
-#include <plusui/keyboard.hpp>
-#include <plusui/menu.hpp>
-#include <plusui/router.hpp>
-#include <plusui/tray.hpp>
-#include <plusui/webgpu.hpp>
-#include <plusui/window.hpp>
+#pragma once
+
+/**
+ * PlusUI C++ API
+ *
+ * Mirrors: Core/Features/API/index.ts
+ *
+ * ONE INCLUDE. ALL FEATURES.
+ *
+ *   #include <plusui/plusui>   // get everything
+ *   using namespace plusui;
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * FEATURE MAP  (C++ class ↔ TypeScript object)
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ *  TypeScript          C++ class / accessor       Header
+ *  ─────────────────── ────────────────────────── ──────────────────
+ *  window              Window                     window.hpp
+ *  app / createApp()   App, App::Builder          app.hpp
+ *  browser             Browser                    browser.hpp
+ *  clipboard           Clipboard                  clipboard.hpp
+ *  keyboard            Keyboard                   keyboard.hpp
+ *  tray                TrayManager                tray.hpp
+ *  display             DisplayManager             display.hpp
+ *  menu                MenuManager                menu.hpp
+ *  router              Router                     router.hpp
+ *  fileDrop            FileDrop                   filedrop.hpp
+ *  gpu                 WebGPU                     webgpu.hpp
+ *  connect             Connect                    connect.hpp
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * FRONTEND ↔ BACKEND MIRROR
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * IMPORT / INCLUDE
+ *   TS:   import plusui from 'plusui'
+ *   C++:  #include <plusui/plusui>
+ *         using namespace plusui;
+ *
+ * ── WINDOW ───────────────────────────────────────────────────────────────────
+ * Actions
+ *   TS:   window.show()                   C++:  win.show()
+ *   TS:   window.hide()                   C++:  win.hide()
+ *   TS:   window.minimize()               C++:  win.minimize()
+ *   TS:   window.maximize()               C++:  win.maximize()
+ *   TS:   window.restore()                C++:  win.restore()
+ *   TS:   window.close()                  C++:  win.close()
+ *   TS:   window.center()                 C++:  win.center()
+ *   TS:   window.focus()                  C++:  win.focus()
+ *   TS:   window.setTitle("My App")       C++:  win.setTitle("My App")
+ *   TS:   window.setSize(800, 600)        C++:  win.setSize(800, 600)
+ *   TS:   window.setPosition(100, 100)    C++:  win.setPosition(100, 100)
+ *   TS:   window.setFullscreen(true)      C++:  win.setFullscreen(true)
+ *   TS:   window.setAlwaysOnTop(true)     C++:  win.setAlwaysOnTop(true)
+ *   TS:   window.setResizable(false)      C++:  win.setResizable(false)
+ *   TS:   window.setDecorations(false)    C++:  win.setDecorations(false)
+ *   TS:   window.setTransparency(0.5)     C++:  win.setOpacity(0.5)
+ *   TS:   window.setIcon(path)            C++:  win.setIconFromMemory(data, size)
+ *   TS:   window.isMaximized()            C++:  win.isMaximized()
+ *   TS:   window.isMinimized()            C++:  win.isMinimized()
+ *   TS:   window.isVisible()              C++:  win.isVisible()
+ * Events
+ *   TS:   window.onResize(cb)             C++:  win.onResize(cb)
+ *   TS:   window.onMove(cb)               C++:  win.onMove(cb)
+ *   TS:   window.onClose(cb)              C++:  win.onClose(cb)
+ *   TS:   window.onFocus(cb)              C++:  win.onFocus(cb)
+ *   TS:   window.onStateChange(cb)        C++:  win.onStateChange(cb)
+ *   TS:   window.onFileDrop(cb)           C++:  win.onFileDrop(cb)
+ *
+ * ── APP ──────────────────────────────────────────────────────────────────────
+ *   TS:   createApp()                     C++:  createApp()
+ *     .title("My App")                          .title("My App")
+ *     .width(1200)                              .width(1200)
+ *     .height(800)                              .height(800)
+ *     .devtools(true)                           .devtools(true)
+ *     .fileDrop(true);                    .fileDrop(true)
+ *                                               .build()   ← returns Window
+ *   TS:   app.quit()                      C++:  app.quit()
+ *   TS:   app.onReady(cb)                 C++:  (start after build())
+ *   TS:   app.onQuit(cb)                  C++:  app.run()  ← blocks until quit
+ *
+ * ── ROUTER ───────────────────────────────────────────────────────────────────
+ *   TS:   router.setRoutes({'/': url})    C++:  Router::instance().setRoutes({...})
+ *   TS:   router.push("/settings")        C++:  Router::instance().push("/settings")
+ *   TS:   router.replace("/settings")     C++:  Router::instance().replace("/settings")
+ *   TS:   router.getCurrentRoute()        C++:  Router::instance().getCurrentRoute()
+ *   TS:   router.setInitialRoute("/")     C++:  Router::instance().setInitialRoute("/")
+ *   TS:   router.onRouteChange(cb)        C++:  Router::instance().onRouteChange(cb)
+ *
+ * ── BROWSER (WebView navigation) ─────────────────────────────────────────────
+ *   TS:   browser.navigate(url)           C++:  browser.navigate(url)
+ *   TS:   browser.open(url)               C++:  browser.navigate(url)
+ *   TS:   browser.openExternal(url)       C++:  browser.openExternal(url)
+ *   TS:   browser.openNewWindow(url)      C++:  browser.openNewWindow(url)
+ *   TS:   browser.goBack()                C++:  browser.goBack()
+ *   TS:   browser.goForward()             C++:  browser.goForward()
+ *   TS:   browser.reload()                C++:  browser.reload()
+ *   TS:   browser.stop()                  C++:  browser.stop()
+ *   TS:   browser.getUrl()                C++:  browser.getURL()
+ *   TS:   browser.getTitle()              C++:  browser.getTitle()
+ *   TS:   browser.getState()              C++:  browser.getState()
+ *   TS:   browser.canGoBack()             C++:  browser.canGoBack()
+ *   TS:   browser.canGoForward()          C++:  browser.canGoForward()
+ *   TS:   browser.isLoading()             C++:  browser.isLoading()
+ * Events
+ *   TS:   browser.onNavigate(cb)          C++:  browser.onNavigate(cb)
+ *   TS:   browser.onStateChange(cb)       C++:  browser.onStateChange(cb)
+ *   TS:   browser.onLoadStart(cb)         C++:  browser.onLoadStart(cb)
+ *   TS:   browser.onLoadEnd(cb)           C++:  browser.onLoadEnd(cb)
+ *   TS:   browser.onLoadError(cb)         C++:  browser.onLoadError(cb)
+ *
+ * ── CLIPBOARD ────────────────────────────────────────────────────────────────
+ *   TS:   clipboard.getText()             C++:  Clipboard::getText()
+ *   TS:   clipboard.setText("hello")      C++:  Clipboard::setText("hello")
+ *   TS:   clipboard.hasText()             C++:  Clipboard::hasText()
+ *   TS:   clipboard.getImage()            C++:  Clipboard::getImage()
+ *   TS:   clipboard.setImage(b64)         C++:  Clipboard::setImage(b64)
+ *   TS:   clipboard.hasImage()            C++:  Clipboard::hasImage()
+ *   TS:   clipboard.clear()               C++:  Clipboard::clear()
+ *   TS:   clipboard.onChange(cb)          C++:  Clipboard::instance().onChange(cb)
+ *
+ * ── KEYBOARD ─────────────────────────────────────────────────────────────────
+ *   TS:   keyboard.isKeyPressed(key)      C++:  Keyboard::instance().isKeyPressed(key)
+ *   TS:   keyboard.registerShortcut(...)  C++:  Keyboard::instance().registerShortcut(...)
+ *   TS:   keyboard.unregisterShortcut(id) C++:  Keyboard::instance().unregisterShortcut(id)
+ *   TS:   keyboard.clearShortcuts()       C++:  Keyboard::instance().clearShortcuts()
+ *   TS:   keyboard.onKeyDown(cb)          C++:  Keyboard::instance().onKeyDown(cb)
+ *   TS:   keyboard.onKeyUp(cb)            C++:  Keyboard::instance().onKeyUp(cb)
+ *   TS:   keyboard.onShortcut(cb)         C++:  Keyboard::instance().onShortcut(cb)
+ *
+ * ── TRAY ─────────────────────────────────────────────────────────────────────
+ *   TS:   tray.setIcon(path)              C++:  win.tray().setIcon(path)
+ *   TS:   tray.setTooltip(text)           C++:  win.tray().setTooltip(text)
+ *   TS:   tray.setVisible(true)           C++:  win.tray().setVisible(true)
+ *   TS:   tray.setMenu(items)             C++:  win.tray().setMenu(items)
+ *   TS:   tray.setContextMenu(items)      C++:  win.tray().setContextMenu(items)
+ *   TS:   tray.onClick(cb)                C++:  win.tray().onClick(cb)
+ *   TS:   tray.onDoubleClick(cb)          C++:  win.tray().onDoubleClick(cb)
+ *   TS:   tray.onRightClick(cb)           C++:  win.tray().onRightClick(cb)
+ *   TS:   tray.onMenuItemClick(cb)        C++:  win.tray().onMenuItemClick(cb)
+ *
+ * ── DISPLAY ──────────────────────────────────────────────────────────────────
+ *   TS:   display.getAllDisplays()         C++:  DisplayManager::instance().getAllDisplays()
+ *   TS:   display.getPrimaryDisplay()      C++:  DisplayManager::instance().getPrimary()
+ *   TS:   display.getDisplayAt(x, y)       C++:  DisplayManager::instance().getAt(x, y)
+ *   TS:   display.getScreenWidth()         C++:  DisplayManager::instance().getScreenWidth()
+ *   TS:   display.getScreenHeight()        C++:  DisplayManager::instance().getScreenHeight()
+ *   TS:   display.onConnected(cb)          C++:  DisplayManager::instance().onConnected(cb)
+ *   TS:   display.onDisconnected(cb)       C++:  DisplayManager::instance().onDisconnected(cb)
+ *   TS:   display.onChanged(cb)            C++:  DisplayManager::instance().onChanged(cb)
+ *
+ * ── MENU ─────────────────────────────────────────────────────────────────────
+ *   TS:   menu.create(items)              C++:  MenuManager::instance().create(items)
+ *   TS:   menu.popup(id, x, y)            C++:  MenuManager::instance().popup(id, x, y)
+ *   TS:   menu.setApplicationMenu(items)  C++:  MenuManager::instance().setApplicationMenu(items)
+ *   TS:   menu.showContextMenu(items)     C++:  MenuManager::instance().showContextMenu(items)
+ *   TS:   menu.onItemClick(cb)            C++:  MenuManager::instance().onItemClick(cb)
+ *   TS:   menu.onContextOpen(cb)          C++:  MenuManager::instance().onContextOpen(cb)
+ *
+ * ── FILEDROP ─────────────────────────────────────────────────────────────────
+ *   TS:   fileDrop.setEnabled(true)       C++:  FileDrop::instance().setEnabled(true)
+ *   TS:   fileDrop.startDrag(paths)       C++:  FileDrop::instance().startDrag(paths)
+ *   TS:   fileDrop.onFilesDropped(cb)     C++:  FileDrop::instance().onFilesDropped(cb)
+ *   TS:   fileDrop.onDragEnter(cb)        C++:  FileDrop::instance().onDragEnter(cb)
+ *   TS:   fileDrop.onDragLeave(cb)        C++:  FileDrop::instance().onDragLeave(cb)
+ *
+ * ── GPU (WebGPU) ──────────────────────────────────────────────────────────────
+ *   TS:   gpu.requestAdapter()            C++:  WebGPU::instance().requestAdapter()
+ *   TS:   gpu.getPreferredCanvasFormat()  C++:  WebGPU::instance().getPreferredCanvasFormat()
+ *   TS:   gpu.onAdapterLost(cb)           C++:  WebGPU::instance().onAdapterLost(cb)
+ *   TS:   gpu.onDeviceLost(cb)            C++:  WebGPU::instance().onDeviceLost(cb)
+ *   TS:   gpu.onError(cb)                 C++:  WebGPU::instance().onError(cb)
+ *
+ * ── CONNECT (custom bidirectional channels) ───────────────────────────────────
+ *   TS:   connect.emit("name", data)      C++:  connect.emit("name", {{"key", val}})
+ *   TS:   connect.on("name", cb)          C++:  connect.on("name", cb)
+ *   TS:   connect.on("name", cb)          C++:  connect.on("name", [](const json& d){ ... })
+ *   TS:   createChannel("name")           C++:  connect.channel("name")
+ *   TS:   createFeatureConnect("scope")   C++:  connect.feature("scope")
+ *   TS:   handleMessage override          C++:  override handleMessage(name, data)
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * USAGE EXAMPLE
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ *   #include <plusui/plusui>
+ *   using namespace plusui;
+ *
+ *   class MyApp : public Connect {
+ *   protected:
+ *     void handleMessage(const std::string& name, const nlohmann::json& data) override {
+ *       if (name == "greet") {
+ *         emit("greeting", {{"message", "Hello " + data["name"].get<std::string>()}});
+ *       }
+ *     }
+ *   };
+ *
+ *   int main() {
+ *     auto win = createApp()
+ *       .title("My App")
+ *       .width(1200)
+ *       .height(800)
+ *       .fileDrop(true)
+ *       .build();
+ *
+ *     MyApp connect;
+ *     bindConnect(win, connect);
+ *
+ *     win.loadURL("http://localhost:5173");
+ *
+ *     win.onClose([]{ app.quit(); });
+ *     win.tray().setIcon("icon.png");
+ *     win.tray().onClick([&](int, int){ win.show(); });
+ *
+ *     Router::instance().setRoutes({{"/", "http://localhost:5173"}});
+ *     Router::instance().push("/");
+ *
+ *     app.run();
+ *   }
+ */
+
+// ─── Feature Headers ──────────────────────────────────────────────────────────
+
+#include <plusui/app.hpp>
+#include <plusui/browser.hpp>
+#include <plusui/clipboard.hpp>
+#include <plusui/connect.hpp>
+#include <plusui/connection.hpp>
+#include <plusui/display.hpp>
+#include <plusui/filedrop.hpp>
+#include <plusui/keyboard.hpp>
+#include <plusui/menu.hpp>
+#include <plusui/router.hpp>
+#include <plusui/tray.hpp>
+#include <plusui/webgpu.hpp>
+#include <plusui/window.hpp>

package/Core/include/plusui/app.hpp

@@ -1,30 +1,30 @@
-#ifndef PLUSUI_APP_H
-#define PLUSUI_APP_H
-
-#include "tray.hpp"
-#include "window.hpp"
-#include <functional>
-#include <future>
-#include <memory>
-#include <string>
-
-namespace plusui {
-
-class App {
-public:
-  App();
-  ~App();
-
-  class Builder;
-
-  void run();
-  void quit();
-
-private:
-  struct Impl;
-  std::unique_ptr<Impl> pImpl;
-};
-
+#ifndef PLUSUI_APP_H
+#define PLUSUI_APP_H
+
+#include "tray.hpp"
+#include "window.hpp"
+#include <functional>
+#include <future>
+#include <memory>
+#include <string>
+
+namespace plusui {
+
+class App {
+public:
+  App();
+  ~App();
+
+  class Builder;
+
+  void run();
+  void quit();
+
+private:
+  struct Impl;
+  std::unique_ptr<Impl> pImpl;
+};
+
 class App::Builder {
 public:
   struct Config {
@@ -35,13 +35,14 @@ public:
     bool devtools = true;
     std::string trayIconPath;
     std::string trayTooltip;
+    bool tray = false;
     bool alwaysOnTop = false;
     bool centered = true;
     bool transparent = false;
     bool decorations = true;
     bool skipTaskbar = false;
     bool scrollbars = true;
-    bool fileDrop = true; // Enable OS file drop
+    bool fileDrop = true;
   };
 
   Builder();
@@ -53,6 +54,7 @@ public:
   Builder &devtools(bool d);
   Builder &trayIcon(const std::string &icon);
   Builder &trayTooltip(const std::string &tooltip);
+  Builder &tray(bool enable);
   Builder &alwaysOnTop(bool top);
   Builder &centered(bool center);
   Builder &transparent(bool transparent);
@@ -66,9 +68,9 @@ public:
 private:
   Config config;
 };
-
-App::Builder createApp();
-
-} // namespace plusui
-
-#endif
+
+App::Builder createApp();
+
+} // namespace plusui
+
+#endif