plusui-native-core 0.1.8 → 0.1.9

package/Core/include/plusui/bindings.hpp

@@ -0,0 +1,65 @@
+/**
+ * PlusUI Unified Binding System
+ * 
+ * Single macro for all frontend ↔ backend communication
+ * Generates type-safe bindings at compile time
+ * Simple, bidirectional, type-safe
+ */
+
+#pragma once
+#include <string>
+#include <functional>
+#include <nlohmann/json.hpp>
+
+namespace plusui {
+
+/**
+ * PLUSUI_BIND - Unified binding macro
+ * 
+ * Usage in C++ headers:
+ *   PLUSUI_BIND(methodName, ReturnType, ParamType1, ParamType2, ...)
+ * 
+ * Examples:
+ *   PLUSUI_BIND(getUserName, string, void)
+ *   PLUSUI_BIND(setTheme, void, string)
+ *   PLUSUI_BIND(calculate, int, int, int)
+ *   PLUSUI_BIND(onFileChanged, void, json)
+ * 
+ * Direction is auto-detected:
+ *   - Methods with return values: Frontend → Backend
+ *   - Methods starting with "on": Backend → Frontend (events)
+ *   - Explicitly bidirectional when needed
+ */
+
+// Macro for binding definitions (parsed by bindgen)
+#define PLUSUI_BIND(name, returnType, ...) \
+  /* Marker for code generation - actual impl in user code */
+
+namespace bindings {
+
+using json = nlohmann::json;
+
+// Invoke handler type - backend methods callable from frontend
+using InvokeHandler = std::function<json(const json& params)>;
+
+// Event handler type - frontend methods callable from backend
+using EventHandler = std::function<void(const json& data)>;
+
+// Register a backend method (frontend can call this)
+void registerMethod(const std::string& name, InvokeHandler handler);
+
+// Register an event listener (backend can emit to this)
+void registerEvent(const std::string& name, EventHandler handler);
+
+// Call frontend from backend (emit event)
+void emitToFrontend(const std::string& name, const json& data);
+
+// Call backend from frontend (invoke method) - handled by webview bridge
+json invokeFromFrontend(const std::string& name, const json& params);
+
+// Get all registered bindings (for diagnostics)
+std::vector<std::string> getRegisteredMethods();
+std::vector<std::string> getRegisteredEvents();
+
+} // namespace bindings
+} // namespace plusui

package/Core/include/plusui/custom_bindings.hpp

@@ -0,0 +1,17 @@
+#pragma once
+
+#include <functional>
+#include <string>
+#include <vector>
+
+namespace plusui {
+
+using CustomBindingCallback = std::function<void(const std::string &payload)>;
+
+class CustomBindings {
+public:
+  static void registerBinding(const std::string &name,
+                              CustomBindingCallback callback);
+};
+
+} // namespace plusui

package/Core/include/plusui/filedrop.hpp

@@ -0,0 +1,77 @@
+#pragma once
+
+#include <string>
+#include <vector>
+#include <functional>
+
+namespace PlusUI {
+
+/**
+ * FileInfo - Represents a dropped file
+ */
+struct FileInfo {
+    std::string path;        // Full path to the file
+    std::string name;        // File name with extension
+    std::string type;        // MIME type (e.g., "image/png", "text/plain")
+    std::uint64_t size;      // File size in bytes
+};
+
+/**
+ * FileDrop - Cross-platform drag & drop file handling
+ *
+ * Enables dragging files into the webview window and from the window to the desktop.
+ * Supports all file types cross-platform (Windows, macOS, Linux).
+ */
+class FileDrop {
+public:
+    FileDrop();
+    ~FileDrop();
+
+    /**
+     * Enable or disable file drop into window
+     * @param enabled - true to allow files to be dropped into the window
+     */
+    void setEnabled(bool enabled);
+
+    /**
+     * Check if file drop is currently enabled
+     * @return true if file drop is enabled
+     */
+    bool isEnabled() const;
+
+    /**
+     * Set callback for when files are dropped into the window
+     * @param callback - Function called with array of dropped files
+     */
+    void onFilesDropped(std::function<void(const std::vector<FileInfo>&)> callback);
+
+    /**
+     * Set callback for when a drag operation enters the window
+     * @param callback - Function called when drag enters
+     */
+    void onDragEnter(std::function<void()> callback);
+
+    /**
+     * Set callback for when a drag operation leaves the window
+     * @param callback - Function called when drag leaves
+     */
+    void onDragLeave(std::function<void()> callback);
+
+    /**
+     * Start a drag operation to drag files out of the window
+     * @param filePaths - Paths to files to be dragged
+     * @return true if drag operation started successfully
+     */
+    bool startDrag(const std::vector<std::string>& filePaths);
+
+    /**
+     * Clear all callbacks
+     */
+    void clearCallbacks();
+
+private:
+    struct Impl;
+    Impl* pImpl;
+};
+
+} // namespace PlusUI

package/Core/include/plusui/native_bindings.hpp

@@ -0,0 +1,19 @@
+#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

package/package.json

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