plusui-native-core 0.1.59 → 0.1.62

package/Core/Features/Connection/README.md

@@ -2,7 +2,7 @@
 
 ## 🎯 Overview
 
-The **Connection Feature** is PlusUI's absurdly simple system for frontend ↔ backend communication. Both sides use the same two methods: **`emit()`** and **`on()`**.
+The **Connection Feature** is PlusUI's absurdly simple system for frontend ↔ backend communication. Use **`feature.emit()`** and **`feature.on()`** on frontend, mirrored by scoped channels on backend.
 
 ## ✨ The 5 Primitives That Cover Everything
 
@@ -32,13 +32,15 @@ Just `emit()` and `on()` handle all communication patterns:
 ```typescript
 import { connect } from 'plusui-native-core/connect';
 
+const custom = connect.feature('custom');
+
 // Listen for response
-connect.on('greetResponse', (data) => {
+custom.on('greetResponse', (data) => {
   console.log(data.message); // "Hello, World!"
 });
 
 // Send message to backend
-connect.emit('greet', { name: 'World' });
+custom.emit('greet', { name: 'World' });
 ```
 
 ### Receive & Respond
@@ -48,23 +50,25 @@ connect.emit('greet', { name: 'World' });
 
 plusui::Connect connect;
 
-connect.on("greet", [&connect](const nlohmann::json& payload) {
+auto customFeature = connect.feature("custom");
+
+customFeature.on("greet", [&connect](const nlohmann::json& payload) {
   std::string user = payload.value("name", "World");
-  connect.emit("greetResponse", {{"message", "Hello, " + user + "!"}});
+  connect.emit("custom.greetResponse", {{"message", "Hello, " + user + "!"}});
 });
 
 // Wire backend connect ↔ window bridge once
 plusui::bindConnect(mainWindow, connect);
 
 // Example: backend push to frontend
-connect.emit("resize", {{"width", 1280}, {"height", 720}});
+connect.emit("custom.resize", {{"width", 1280}, {"height", 720}});
 ```
 
 ### Listen on Frontend
 
 ```typescript
 // Listen for messages from backend
-connect.on('resize', (data) => {
+custom.on('resize', (data) => {
   console.log(`${data.width}x${data.height}`);
   updateLayout(data);
 });
@@ -152,6 +156,12 @@ connect.on("custom.appEvent", [](const nlohmann::json& payload) {
 });
 ```
 
+`plusui connect` scans frontend and backend `.emit()` / `.on()` calls and understands feature aliases, including:
+
+- `const custom = createFeatureConnect('custom'); custom.on('event', ...)`
+- `const custom = connect.feature('custom'); custom.emit('event', ...)`
+- `auto custom = connect.feature("custom"); custom.on("event", ...)`
+
 ## 💡 Design Your Own Patterns
 
 ### Request/Response Pattern

package/Core/include/plusui/connect.hpp

@@ -106,6 +106,38 @@ public:
     }
   };
 
+  // ============================================================
+  // Channel — single-name channel object
+  //
+  // Mirror of the TypeScript createChannel() object:
+  //   download.on([](const json& p) { ... });
+  //   download.emit({{"progress", 50}});
+  //
+  // Obtained via connect.channel("download") or declared in
+  // the auto-generated connections.gen.hpp.
+  // ============================================================
+  class Channel {
+    Connect *owner;
+    std::string name_;
+
+  public:
+    Channel() : owner(nullptr) {}
+    Channel(Connect *parent, std::string channelName)
+        : owner(parent), name_(std::move(channelName)) {}
+
+    // Register a listener — mirrors TypeScript: download.on((d) => { ... })
+    void on(EventHandler handler) {
+      if (owner) owner->on(name_, std::move(handler));
+    }
+
+    // Send a message — mirrors TypeScript: download.emit({ key: value })
+    void emit(const nlohmann::json &payload = nlohmann::json::object()) {
+      if (owner) owner->emit(name_, payload);
+    }
+
+    const std::string &name() const { return name_; }
+  };
+
 private:
   std::function<void(const std::string &)> outboundHandler;
   std::map<std::string, std::vector<EventHandler>> eventHandlers;
@@ -145,6 +177,13 @@ 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
   void onCall(const std::string &name, CallHandler handler) {
     callHandlers[name] = std::move(handler);

package/Core/include/plusui/plusui.hpp

@@ -31,7 +31,6 @@
 #include <plusui/filedrop.hpp>
 #include <plusui/keyboard.hpp>
 #include <plusui/menu.hpp>
-#include <plusui/native_bindings.hpp>
 #include <plusui/tray.hpp>
 #include <plusui/webgpu.hpp>
 #include <plusui/window.hpp>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plusui-native-core",
-  "version": "0.1.59",
+  "version": "0.1.62",
   "description": "PlusUI Core framework (frontend + backend implementations)",
   "type": "module",
   "files": [

package/Core/include/plusui/native_bindings.hpp

@@ -1,19 +0,0 @@
-#pragma once
-
-#include <string>
-#include <vector>
-
-namespace plusui {
-
-struct BindingEntry {
-  const char *source;
-  const char *feature;
-  const char *method;
-};
-
-class NativeBindings {
-public:
-  static const std::vector<BindingEntry> &getEntries();
-};
-
-} // namespace plusui