@lynx-js/lynx-library-headers 0.0.4 → 0.0.6

package/include/capi/lynx_env_capi.h

@@ -27,6 +27,8 @@ LYNX_CAPI_EXPORT void lynx_env_set_devtool_app_info(const char* name,
                                                     const char* value);
 LYNX_CAPI_EXPORT void lynx_env_enable_devtool(int enable);
 LYNX_CAPI_EXPORT int lynx_env_is_devtool_enabled();
+// Returns the local DebugRouter TCP port, or -1 before the listener is ready.
+LYNX_CAPI_EXPORT int lynx_env_get_devtool_local_port();
 LYNX_CAPI_EXPORT int lynx_env_connect_devtool(const char* url);
 LYNX_CAPI_EXPORT void lynx_env_set_open_card_callback(
     lynx_env_open_card_callback callback, void* user_data);

package/include/capi/lynx_group_capi.h

@@ -34,6 +34,11 @@ LYNX_CAPI_EXPORT void lynx_group_set_preload_js_paths(lynx_group_t*,
 LYNX_CAPI_EXPORT void lynx_group_set_enable_js_group_thread(lynx_group_t*,
                                                             int enable);
 
+// Enables or disables the shared white board for a lynx group. When enabled,
+// Lynx views in the same group share one white board instance.
+LYNX_CAPI_EXPORT void lynx_group_set_enable_white_board(lynx_group_t*,
+                                                        int enable);
+
 // Release the lynx group.
 LYNX_CAPI_EXPORT void lynx_group_release(lynx_group_t*);
 

package/include/capi/lynx_view_capi.h

@@ -20,11 +20,21 @@ LYNX_EXTERN_C_BEGIN
 // when it is no longer needed.
 typedef struct lynx_view_t lynx_view_t;
 
+typedef struct lynx_devtool_target_t {
+  int32_t session_id;
+  // Owned by the LynxView and valid until the next target query or release.
+  const char* url;
+} lynx_devtool_target_t;
+
 // Create lynx view with builder.
 LYNX_CAPI_EXPORT lynx_view_t* lynx_view_create(lynx_view_builder_t* builder,
                                                void* user_data);
 LYNX_CAPI_EXPORT void* lynx_view_get_user_data(lynx_view_t*);
 
+// Returns false until this LynxView is attached to the DebugRouter.
+LYNX_CAPI_EXPORT bool lynx_view_get_devtool_target(
+    lynx_view_t*, lynx_devtool_target_t* target);
+
 // Get the fixed WebView2 runtime path configured by the builder. Returns an
 // empty string if no fixed runtime path was configured.
 LYNX_CAPI_EXPORT const char* lynx_view_get_webview2_fixed_runtime_path(

package/include/lynx/platform/embedder/public/capi/lynx_env_capi.h

@@ -27,6 +27,8 @@ LYNX_CAPI_EXPORT void lynx_env_set_devtool_app_info(const char* name,
                                                     const char* value);
 LYNX_CAPI_EXPORT void lynx_env_enable_devtool(int enable);
 LYNX_CAPI_EXPORT int lynx_env_is_devtool_enabled();
+// Returns the local DebugRouter TCP port, or -1 before the listener is ready.
+LYNX_CAPI_EXPORT int lynx_env_get_devtool_local_port();
 LYNX_CAPI_EXPORT int lynx_env_connect_devtool(const char* url);
 LYNX_CAPI_EXPORT void lynx_env_set_open_card_callback(
     lynx_env_open_card_callback callback, void* user_data);

package/include/lynx/platform/embedder/public/capi/lynx_group_capi.h

@@ -34,6 +34,11 @@ LYNX_CAPI_EXPORT void lynx_group_set_preload_js_paths(lynx_group_t*,
 LYNX_CAPI_EXPORT void lynx_group_set_enable_js_group_thread(lynx_group_t*,
                                                             int enable);
 
+// Enables or disables the shared white board for a lynx group. When enabled,
+// Lynx views in the same group share one white board instance.
+LYNX_CAPI_EXPORT void lynx_group_set_enable_white_board(lynx_group_t*,
+                                                        int enable);
+
 // Release the lynx group.
 LYNX_CAPI_EXPORT void lynx_group_release(lynx_group_t*);
 

package/include/lynx/platform/embedder/public/capi/lynx_view_capi.h

@@ -20,11 +20,21 @@ LYNX_EXTERN_C_BEGIN
 // when it is no longer needed.
 typedef struct lynx_view_t lynx_view_t;
 
+typedef struct lynx_devtool_target_t {
+  int32_t session_id;
+  // Owned by the LynxView and valid until the next target query or release.
+  const char* url;
+} lynx_devtool_target_t;
+
 // Create lynx view with builder.
 LYNX_CAPI_EXPORT lynx_view_t* lynx_view_create(lynx_view_builder_t* builder,
                                                void* user_data);
 LYNX_CAPI_EXPORT void* lynx_view_get_user_data(lynx_view_t*);
 
+// Returns false until this LynxView is attached to the DebugRouter.
+LYNX_CAPI_EXPORT bool lynx_view_get_devtool_target(
+    lynx_view_t*, lynx_devtool_target_t* target);
+
 // Get the fixed WebView2 runtime path configured by the builder. Returns an
 // empty string if no fixed runtime path was configured.
 LYNX_CAPI_EXPORT const char* lynx_view_get_webview2_fixed_runtime_path(

package/include/lynx/platform/embedder/public/lynx_env.h

@@ -23,6 +23,7 @@ class LynxEnv {
   void SetDevtoolAppInfo(const char* name, const char* value);
   void SetDevtoolEnabled(bool enable);
   bool IsDevtoolEnabled();
+  int GetDevtoolLocalPort();
   bool ConnectDevtool(const char* url);
   void SetOpenCardCallback(lynx_env_open_card_callback callback,
                            void* user_data);
@@ -71,6 +72,10 @@ inline bool LynxEnv::IsDevtoolEnabled() {
   return lynx_env_is_devtool_enabled();
 }
 
+inline int LynxEnv::GetDevtoolLocalPort() {
+  return lynx_env_get_devtool_local_port();
+}
+
 inline bool LynxEnv::ConnectDevtool(const char* url) {
   return lynx_env_connect_devtool(url);
 }

package/include/lynx/platform/embedder/public/lynx_group.h

@@ -36,11 +36,18 @@ class LynxGroup {
 
   bool EnableJSGroupThread() const { return enable_js_group_thread_; }
 
+  bool EnableWhiteBoard() const { return enable_white_board_; }
+
   void SetEnableJSGroupThread(bool enable) {
     enable_js_group_thread_ = enable;
     lynx_group_set_enable_js_group_thread(group_, enable);
   }
 
+  void SetEnableWhiteBoard(bool enable) {
+    enable_white_board_ = enable;
+    lynx_group_set_enable_white_board(group_, enable);
+  }
+
   void SetPreloadJSPaths(std::vector<std::string> paths) {
     preload_js_paths_ = std::move(paths);
     std::vector<const char*> c_paths(preload_js_paths_.size());
@@ -62,6 +69,7 @@ class LynxGroup {
   std::string id_;
   std::vector<std::string> preload_js_paths_;
   bool enable_js_group_thread_ = false;
+  bool enable_white_board_ = false;
 };
 
 }  // namespace pub

package/include/lynx/platform/embedder/public/lynx_view.h

@@ -29,6 +29,11 @@ struct lynx_view_t;
 namespace lynx {
 namespace pub {
 
+struct LynxDevtoolTarget {
+  int32_t session_id;
+  std::string url;
+};
+
 /**
  * @apidoc
  * @brief LynxView is the main entry point for rendering and interacting with
@@ -344,6 +349,19 @@ class LynxView {
     }
   }
 
+  bool GetDevtoolTarget(LynxDevtoolTarget* target) {
+    if (!target) {
+      return false;
+    }
+    lynx_devtool_target_t native_target{};
+    if (!lynx_view_get_devtool_target(lynx_view_, &native_target)) {
+      return false;
+    }
+    target->session_id = native_target.session_id;
+    target->url = native_target.url ? native_target.url : "";
+    return true;
+  }
+
   lynx_view_t* Impl() { return lynx_view_; }
 
   LynxView(const LynxView&) = delete;

package/include/lynx_env.h

@@ -23,6 +23,7 @@ class LynxEnv {
   void SetDevtoolAppInfo(const char* name, const char* value);
   void SetDevtoolEnabled(bool enable);
   bool IsDevtoolEnabled();
+  int GetDevtoolLocalPort();
   bool ConnectDevtool(const char* url);
   void SetOpenCardCallback(lynx_env_open_card_callback callback,
                            void* user_data);
@@ -71,6 +72,10 @@ inline bool LynxEnv::IsDevtoolEnabled() {
   return lynx_env_is_devtool_enabled();
 }
 
+inline int LynxEnv::GetDevtoolLocalPort() {
+  return lynx_env_get_devtool_local_port();
+}
+
 inline bool LynxEnv::ConnectDevtool(const char* url) {
   return lynx_env_connect_devtool(url);
 }

package/include/lynx_group.h

@@ -36,11 +36,18 @@ class LynxGroup {
 
   bool EnableJSGroupThread() const { return enable_js_group_thread_; }
 
+  bool EnableWhiteBoard() const { return enable_white_board_; }
+
   void SetEnableJSGroupThread(bool enable) {
     enable_js_group_thread_ = enable;
     lynx_group_set_enable_js_group_thread(group_, enable);
   }
 
+  void SetEnableWhiteBoard(bool enable) {
+    enable_white_board_ = enable;
+    lynx_group_set_enable_white_board(group_, enable);
+  }
+
   void SetPreloadJSPaths(std::vector<std::string> paths) {
     preload_js_paths_ = std::move(paths);
     std::vector<const char*> c_paths(preload_js_paths_.size());
@@ -62,6 +69,7 @@ class LynxGroup {
   std::string id_;
   std::vector<std::string> preload_js_paths_;
   bool enable_js_group_thread_ = false;
+  bool enable_white_board_ = false;
 };
 
 }  // namespace pub

package/include/lynx_view.h

@@ -29,6 +29,11 @@ struct lynx_view_t;
 namespace lynx {
 namespace pub {
 
+struct LynxDevtoolTarget {
+  int32_t session_id;
+  std::string url;
+};
+
 /**
  * @apidoc
  * @brief LynxView is the main entry point for rendering and interacting with
@@ -344,6 +349,19 @@ class LynxView {
     }
   }
 
+  bool GetDevtoolTarget(LynxDevtoolTarget* target) {
+    if (!target) {
+      return false;
+    }
+    lynx_devtool_target_t native_target{};
+    if (!lynx_view_get_devtool_target(lynx_view_, &native_target)) {
+      return false;
+    }
+    target->session_id = native_target.session_id;
+    target->url = native_target.url ? native_target.url : "";
+    return true;
+  }
+
   lynx_view_t* Impl() { return lynx_view_; }
 
   LynxView(const LynxView&) = delete;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lynx-js/lynx-library-headers",
   "author": "Lynxtron Authors",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "type": "module",
   "description": "Lynx embedder C/C++ API and weak N-API headers for native libraries",
   "repository": {
@@ -25,7 +25,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@lynx-js/lynxtron": "0.0.4"
+    "@lynx-js/lynxtron": "0.0.6"
   },
   "engines": {
     "node": ">=18"