feat: use WEBUI_EXTENSION_API to turn on/off extensions

Author: konakona418

include/webui_extras.h include/webui_extensions.hinclude/webui_extras.h renamed to include/webui_extensions.h

@@ -8,14 +8,26 @@
   Canada.
 */
 
-#ifndef _WEBUI_EXTRAS_H
-#define _WEBUI_EXTRAS_H
+#ifndef _WEBUI_EXTENSIONS_H
+#define _WEBUI_EXTENSIONS_H
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-#include "webui.h"
+/**
+ * This is to help the compiler identify whether to compile the extensions API funtions or not
+ * - If you are including the webui.c file to your source file directly,
+ *   and wish to use the extensions API functions, 
+ *   please include this header file before including webui.c,
+ *   or define this macro manually before including webui.c
+ * - In other cases, as long as the webui.c file is not included directly, 
+ *   you might need to define this macro in your compiler settings
+ */
+#define WEBUI_EXTENSIONS_API
+
+#include <stdbool.h>
+#include <stddef.h>
 
 /**
  * @brief Construct a JavaScript string from a format string,
@@ -32,7 +44,7 @@ extern "C" {
  *
  * @example webui_run_fmt(myWindow, "alert('Hello %s');", "World");
  */
-WEBUI_EXPORT void webui_run_fmt(size_t window, const char* fmt, ...);
+void webui_run_fmt(size_t window, const char* fmt, ...);
 
 /**
  * @brief Construct a JavaScript string from a format string,
@@ -56,12 +68,12 @@ WEBUI_EXPORT void webui_run_fmt(size_t window, const char* fmt, ...);
  * @example bool err = webui_script_fmt(myWindow, 0, myBuffer, myBufferSize,
  *     "return %d + %d;", 4, 6);
  */
-WEBUI_EXPORT bool webui_script_fmt(size_t window, size_t timeout,
+bool webui_script_fmt(size_t window, size_t timeout,
     char* buffer, size_t buffer_length, 
     const char* fmt, ...);
 
 #ifdef __cplusplus
 }
 #endif
 
-#endif /*_WEBUI_EXTRAS_H */
+#endif /*_WEBUI_EXTENSIONS_H */

src/webui.c

@@ -847,6 +847,7 @@ void webui_run(size_t window, const char* script) {
     _webui_send_all(win, 0, WEBUI_CMD_JS_QUICK, script, js_len);
 }
 
+#ifdef WEBUI_EXTENSION_API
 void webui_run_fmt(size_t window, const char* fmt, ...) {
     int len;
     char* buf;
@@ -871,6 +872,7 @@ void webui_run_fmt(size_t window, const char* fmt, ...) {
 
     _webui_free_mem((void*)buf);
 }
+#endif /* WEBUI_EXTENSION_API */
 
 void webui_set_close_handler_wv(size_t window, bool(*close_handler)(size_t window)) {
 
@@ -1090,6 +1092,7 @@ bool webui_script(size_t window, const char* script, size_t timeout,
     return webui_script_client(&e, script, timeout, buffer, buffer_length);
 }
 
+#ifdef WEBUI_EXTENSION_API
 bool webui_script_fmt(
     size_t window, size_t timeout,
     char* buffer, size_t buffer_length, 
@@ -1120,6 +1123,7 @@ bool webui_script_fmt(
 
     return status;
 }
+#endif /* WEBUI_EXTENSION_API */
 
 static uint32_t _webui_generate_random_uint32() {
     uint32_t timestamp = (uint32_t) time(NULL);