plusui-native-core 0.1.102 → 0.1.104

package/Core/include/plusui/app.hpp

@@ -25,47 +25,47 @@ private:
   std::unique_ptr<Impl> pImpl;
 };
 
-class App::Builder {
-public:
-  struct Config {
-    std::string title = "PlusUI App";
-    int width = 1200;
-    int height = 800;
-    bool resizable = true;
-    bool devtools = true;
-    std::string trayIconPath;
-    std::string trayTooltip;
-    bool alwaysOnTop = false;
-    bool centered = true;
-    bool transparent = false;
-    bool decorations = true;
-    bool skipTaskbar = false;
-    bool scrollbars = true;
-    bool enableFileDrop = true;
-  };
-
-  Builder();
-
-  Builder &title(const std::string &t);
-  Builder &width(int w);
-  Builder &height(int h);
-  Builder &resizable(bool r);
-  Builder &devtools(bool d);
-  Builder &trayIcon(const std::string &icon);
-  Builder &trayTooltip(const std::string &tooltip);
-  Builder &alwaysOnTop(bool top);
-  Builder &centered(bool center);
-  Builder &transparent(bool transparent);
-  Builder &decorations(bool decorations);
-  Builder &skipTaskbar(bool skip);
-  Builder &scrollbars(bool show);
-  Builder &enableFileDrop(bool enable);
-
-  Window build();
-
-private:
-  Config config;
-};
+class App::Builder {
+public:
+  struct Config {
+    std::string title = "PlusUI App";
+    int width = 1200;
+    int height = 800;
+    bool resizable = true;
+    bool devtools = true;
+    std::string trayIconPath;
+    std::string trayTooltip;
+    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
+  };
+
+  Builder();
+
+  Builder &title(const std::string &t);
+  Builder &width(int w);
+  Builder &height(int h);
+  Builder &resizable(bool r);
+  Builder &devtools(bool d);
+  Builder &trayIcon(const std::string &icon);
+  Builder &trayTooltip(const std::string &tooltip);
+  Builder &alwaysOnTop(bool top);
+  Builder &centered(bool center);
+  Builder &transparent(bool transparent);
+  Builder &decorations(bool decorations);
+  Builder &skipTaskbar(bool skip);
+  Builder &scrollbars(bool show);
+  Builder &fileDrop(bool enable);
+
+  Window build();
+
+private:
+  Config config;
+};
 
 App::Builder createApp();
 

package/Core/include/plusui/connect.hpp

@@ -6,59 +6,69 @@
 #include <string>
 #include <vector>
 
-// ============================================
-// PlusUI Connect Feature
-// ============================================
-//
-// TWO METHODS. FIVE PRIMITIVES. EVERYTHING YOU NEED.
-//
-// Mirror API - same methods on both sides:
-//   Frontend: connect.emit(name, data)  →  Backend: emit(name, data)
-//   Frontend: connect.on(name, callback) →  Backend: handleMessage(name, data)
-//
-// ============================================
-// THE 5 PRIMITIVES
-// ============================================
-//
-// 1. EVENT - Fire & forget, one way →
-//    Frontend: connect.emit('notification', { message: 'Done!' })
-//    Backend:  emit("notification", {{"message", "Done!"}});
-//
-// 2. CALL - Request/response, two ways ↔
-//    Frontend: connect.emit('getUser', { id: 123 })
-//              connect.on('userData', (data) => { ... })
-//    Backend:  handleMessage("getUser", payload) → emit("userData", {...})
-//
-// 3. STREAM - Continuous data, one way push →
-//    Backend:  emit("cpu-usage", {{"percent", 45}});  // called repeatedly
-//    Frontend: connect.on('cpu-usage', (data) => { ... })
-//
-// 4. QUERY - Request + stream, two way + many ↔↔↔
-//    Frontend: connect.emit('search', { query: 'test' })
-//              connect.on('searchResult', (item) => { ... })  // fires multiple times
-//    Backend:  handleMessage("search", payload) → emit("searchResult", item1)
-//                                                  emit("searchResult", item2) ...
-//
-// 5. STATE - Synced value, both ways ↕
-//    Both sides can emit and receive the same message:
-//    connect.emit('theme', { mode: 'dark' })
-//    connect.on('theme', (data) => { ... })
-//
-// ============================================
-// BASIC USAGE
-// ============================================
-//
-// class MyConnect : public plusui::Connect {
-// protected:
-//   void handleMessage(const std::string& name, const nlohmann::json& data) override {
-//     if (name == "greet") {
-//       auto userName = data["name"].get<std::string>();
-//       emit("greeting", {{"message", "Hello " + userName + "!"}});
-//     }
-//   }
-// };
-//
-// ============================================
+// ============================================================================
+// PlusUI Connect
+// ============================================================================
+//
+// SEMANTIC SYNTAX. ZERO CONFIG. ALL 5 PATTERNS.
+//
+// IMPORTANT: This is for CUSTOM user-defined communication only!
+// Built-in features (window, clipboard, app, etc.) use their own APIs:
+//   window.minimize();
+//   clipboard.setText("hello");
+//   app.quit();
+//
+// Just write code using connect::namespace.method() syntax for custom
+// frontend ↔ backend communication, then run `plusui connect`.
+//
+// Patterns are auto-detected from your code:
+//
+//   connect::user.handleFetch = [](const json& p) -> json { ... };  // CALL
+//   connect::app.notify({{"msg", "Hello!"}});                       // FIRE
+//   connect::files.onUpload = [](const json& p) { ... };            // EVENT
+//
+// Custom channels are auto-generated by `plusui connect`.
+//
+// ============================================================================
+// THE 5 COMMUNICATION PATTERNS
+// ============================================================================
+// ALL PATTERNS WORK BIDIRECTIONALLY - frontend ↔ backend
+// ============================================================================
+//
+// 1. REQUEST-RESPONSE (Call)
+//    Frontend → Backend:
+//      const user = await connect.user.fetch(123);
+//      connect::user.handleFetch = [](const json& p) -> json { ... };
+//    Backend → Frontend:
+//      auto result = connect.call("ui.handlePrompt", {{"msg", "Hi"}});
+//      connect.ui.handlePrompt = async (data) => { ... return result; };
+//
+// 2. SIMPLEX (Fire & Forget) — One-way, no response expected
+//    Frontend → Backend:
+//      connect.files.upload({ file: myFile })
+//      connect::files.onUpload = [](const json& p) { ... };
+//    Backend → Frontend:
+//      connect::app.notify({{"msg", "Update complete!"}});
+//      connect.app.onNotify((msg) => toast.success(msg));
+//
+// 3. PUBLISH-SUBSCRIBE (One-to-Many) — Broadcast to multiple listeners
+//    Backend → Frontend:
+//      connect::sensors.publishTemperature({{72.5}});
+//      connect.sensors.onTemperature(cb1); connect.sensors.onTemperature(cb2);
+//    Frontend → Backend:
+//      connect.auth.login({ user: "john" });
+//      connect::auth.onLogin = [](const json& p) { ... };
+//
+// 4. FULL-DUPLEX (Bidirectional Stream) — Continuous both ways
+//    Frontend sends chunks, backend sends progress
+//    connect.files.onChunk(chunk); connect.files.onProgress(cb);
+//    connect::files.onChunk = [](json) { ... }; connect::files.progress({{...}});
+//
+// 5. HALF-DUPLEX (State Sync) — Both sides can update, one at a time
+//    connect.settings.setTheme("dark"); connect.settings.onThemeChange(cb);
+//    connect::settings.onSetTheme = [](json) { ... }; connect::settings.themeChange({{...}});
+//
+// ============================================================================
 
 namespace plusui {
 
@@ -107,7 +117,7 @@ public:
   };
 
   // ============================================================
-  // Channel — single-name channel object
+  // Channel — single-name channel object (legacy / backward compat)
   //
   // Mirror of the TypeScript createChannel() object:
   //   download.on([](const json& p) { ... });
@@ -178,10 +188,6 @@ public:
   Feature feature(const std::string &scope) { return Feature(this, scope); }
 
   // Create a named channel object — mirrors TypeScript createChannel('name')
-  // Returns by value; store as a member or local:
-  //   auto download = connect.channel("download");
-  //   download.on([](const json& p) { ... });
-  //   download.emit({{"progress", 50}});
   Channel channel(const std::string &name) { return Channel(this, name); }
 
   // Request/response helper for call primitive
@@ -205,12 +211,11 @@ public:
 
   /**
    * emit() - Send a message to the frontend
-   * 
-   * Works for all 5 primitives:
-   *   - EVENT: emit("notification", {{"msg", "Hi!"}})
-   *   - CALL: emit("response", {{"data", 123}})
-   *   - STREAM: emit("updates", {{"value", x}})  // call repeatedly
-   *   - QUERY: emit("result", item)  // call for each result
+   *
+   * Works for all 5 communication patterns:
+   *   - SIMPLEX: emit("notification", {{"msg", "Hi!"}})
+   *   - CALL RESPONSE: emitResult(id, name, payload)
+   *   - STREAM/PUB-SUB: emit("updates", {{"value", x}})  // call repeatedly
    *   - STATE: emit("theme", {{"mode", "dark"}})
    */
   void emit(const std::string &name, const nlohmann::json &payload) {
@@ -227,6 +232,32 @@ public:
     emitEnvelope("error", name, nlohmann::json::object(), id, message);
   }
 
+  /**
+   * call() - Make a call to the frontend and wait for response
+   *
+   * Enables bidirectional request/response:
+   *   Backend: auto answer = connect.call("ui.promptUser", {{"msg", "Sure?"}});
+   *   Frontend: connect.ui.handlePromptUser = async (data) => { ... return result; };
+   */
+  void call(const std::string &name, const nlohmann::json &payload,
+            std::function<void(const nlohmann::json &)> onResult = nullptr,
+            std::function<void(const std::string &)> onError = nullptr) {
+    auto id = std::to_string(std::chrono::steady_clock::now().time_since_epoch().count());
+    
+    if (onResult || onError) {
+      // Store pending callback for when frontend responds
+      on(name + ".__result__." + id, [this, id, name, onResult, onError](const nlohmann::json &p) {
+        if (p.contains("error") && onError) {
+          onError(p["error"].get<std::string>());
+        } else if (onResult) {
+          onResult(p.value("payload", nlohmann::json::object()));
+        }
+      });
+    }
+
+    emitEnvelope("call", name, payload, id);
+  }
+
   // Parse and dispatch incoming messages from frontend
   void dispatchMessage(const std::string &message) {
     try {
@@ -276,6 +307,25 @@ public:
         return;
       }
 
+      if (kind == "result" || kind == "error") {
+        // Response from a frontend call — dispatch to pending listeners
+        std::string resultKey = name + ".__result__." + id;
+        auto listenersIt = eventHandlers.find(resultKey);
+        if (listenersIt != eventHandlers.end()) {
+          nlohmann::json resultPayload;
+          if (kind == "error") {
+            resultPayload["error"] = envelope.value("error", "Unknown error");
+          } else {
+            resultPayload["payload"] = payload;
+          }
+          for (const auto &listener : listenersIt->second) {
+            listener(resultPayload);
+          }
+          eventHandlers.erase(resultKey);
+        }
+        return;
+      }
+
       if (kind == "sub") {
         auto subIt = subscriptionHandlers.find(name);
         if (subIt != subscriptionHandlers.end()) {
@@ -325,23 +375,17 @@ protected:
 
   /**
    * handleMessage() - Receive messages from the frontend
-   * 
+   *
    * Override this to handle incoming messages. This is your "on()" equivalent.
-   * 
-   * Works for all 5 primitives:
-   *   - EVENT: Just receive and act
-   *   - CALL: Receive request, emit() response
-   *   - STREAM: Receive subscription, emit() repeatedly
-   *   - QUERY: Receive query, emit() multiple results
-   *   - STATE: Receive update, optionally emit() back
-   * 
-   * Example:
-   *   void handleMessage(const std::string& name, const nlohmann::json& data) override {
-   *     if (name == "greet") {
-   *       auto userName = data["name"].get<std::string>();
-   *       emit("greeting", {{"message", "Hello " + userName}});
-   *     }
-   *   }
+   *
+   * For the new semantic API, prefer using the generated connect:: namespace
+   * instead of overriding this method:
+   *
+   *   connect::user.handleFetch = [](const json& p) -> json {
+   *     return database.getUser(p["id"]);
+   *   };
+   *
+   * This method remains for backward compatibility and catch-all handling.
    */
   virtual void handleMessage(const std::string &name,
                              const nlohmann::json &payload) {
@@ -352,7 +396,7 @@ protected:
 
 void bindConnect(Window &window, Connect &connect);
 
-// Legacy alias for backwards compatibility
+// Legacy aliases for backwards compatibility
 using Bridge = Connect;
 using Connection = Connect;
 

package/Core/include/plusui/window.hpp

@@ -11,46 +11,44 @@ namespace plusui {
 
 class TrayManager;
 
-struct WindowConfig {
-  // Window properties
-  std::string title = "PlusUI Window";
-  int x = -1;
-  int y = -1;
-  int width = 800;
-  int height = 600;
-  int minWidth = 100;
-  int minHeight = 100;
-  int maxWidth = -1;
-  int maxHeight = -1;
-  bool resizable = true;
-  bool minimizable = true;
-  bool maximizable = true;
-  bool closable = true;
-  bool alwaysOnTop = false;
-  bool center = true;
-  bool frame = true;
-  bool transparent = false;
-  bool decorations = true;
-  bool skipTaskbar = false;
-  double opacity = 1.0;
-  bool fullscreen = false;
-  bool enableFileDrop =
-      true; // Enable native FileDrop API (auto-disables webview drag-drop)
-
-  // WebView properties
-  std::string userAgent = "";
-  bool devtools = true;
-  bool contextMenu = true;
-  bool javascript = true;
-  bool webSecurity = true;
-  bool allowFileAccess = false;
-  bool allowRemoteContent = true;
-  std::string dataPath = "";
-  int cacheSize = 100;    // MB
-  bool scrollbars = true; // Show/hide scrollbars
-  bool disableWebviewDragDrop =
-      true; // Disable webview drag-drop (usually set by enableFileDrop)
-};
+struct WindowConfig {
+  // Window properties
+  std::string title = "PlusUI Window";
+  int x = -1;
+  int y = -1;
+  int width = 800;
+  int height = 600;
+  int minWidth = 100;
+  int minHeight = 100;
+  int maxWidth = -1;
+  int maxHeight = -1;
+  bool resizable = true;
+  bool minimizable = true;
+  bool maximizable = true;
+  bool closable = true;
+  bool alwaysOnTop = false;
+  bool center = true;
+  bool frame = true;
+  bool transparent = false;
+  bool decorations = true;
+  bool skipTaskbar = false;
+  double opacity = 1.0;
+  bool fullscreen = false;
+  bool fileDrop = true; // Enable OS file drop (drag files from Explorer/Finder into window)
+  bool disableWebviewDragDrop = true; // Disable browser HTML drag-drop (auto-set by fileDrop)
+
+  // WebView properties
+  std::string userAgent = "";
+  bool devtools = true;
+  bool contextMenu = true;
+  bool javascript = true;
+  bool webSecurity = true;
+  bool allowFileAccess = false;
+  bool allowRemoteContent = true;
+  std::string dataPath = "";
+  int cacheSize = 100;    // MB
+  bool scrollbars = true; // Show/hide scrollbars
+};
 
 struct WindowState {
   int x = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plusui-native-core",
-  "version": "0.1.102",
+  "version": "0.1.104",
   "description": "PlusUI Core framework (frontend + backend implementations)",
   "type": "module",
   "main": "./Core/Features/API/index.ts",