lua: Change CompletionRequested handler to use an event table. (#5280)

src/controllers/plugins/LuaAPI.hpp

@@ -5,6 +5,8 @@
 extern "C" {
 #    include <lua.h>
 }
+#    include "controllers/plugins/LuaUtilities.hpp"
+
 #    include <QString>
 
 #    include <cassert>
@@ -55,6 +57,28 @@ struct CompletionList {
     bool hideOthers{};
 };
 
+/**
+ * @lua@class CompletionEvent
+ */
+struct CompletionEvent {
+    /**
+     * @lua@field query string The word being completed
+     */
+    QString query;
+    /**
+     * @lua@field full_text_content string Content of the text input
+     */
+    QString full_text_content;
+    /**
+     * @lua@field cursor_position integer Position of the cursor in the text input in unicode codepoints (not bytes)
+     */
+    int cursor_position{};
+    /**
+     * @lua@field is_first_word boolean True if this is the first word in the input
+     */
+    bool is_first_word{};
+};
+
 /**
  * @includefile common/Channel.hpp
  * @includefile controllers/plugins/api/ChannelRef.hpp
@@ -74,7 +98,7 @@ int c2_register_command(lua_State *L);
  * Registers a callback to be invoked when completions for a term are requested.
  *
  * @lua@param type "CompletionRequested"
- * @lua@param func fun(query: string, full_text_content: string, cursor_position: integer, is_first_word: boolean): CompletionList The callback to be invoked.
+ * @lua@param func fun(event: CompletionEvent): CompletionList The callback to be invoked.
  * @exposed c2.register_callback
  */
 int c2_register_callback(lua_State *L);

src/controllers/plugins/LuaUtilities.cpp

@@ -142,6 +142,20 @@ StackIdx push(lua_State *L, const int &b)
     return lua_gettop(L);
 }
 
+StackIdx push(lua_State *L, const api::CompletionEvent &ev)
+{
+    auto idx = pushEmptyTable(L, 4);
+#    define PUSH(field)         \
+        lua::push(L, ev.field); \
+        lua_setfield(L, idx, #field)
+    PUSH(query);
+    PUSH(full_text_content);
+    PUSH(cursor_position);
+    PUSH(is_first_word);
+#    undef PUSH
+    return idx;
+}
+
 bool peek(lua_State *L, int *out, StackIdx idx)
 {
     StackGuard guard(L);

src/controllers/plugins/LuaUtilities.hpp

@@ -28,6 +28,7 @@ namespace chatterino::lua {
 
 namespace api {
     struct CompletionList;
+    struct CompletionEvent;
 }  // namespace api
 
 constexpr int ERROR_BAD_PEEK = LUA_OK - 1;
@@ -66,6 +67,7 @@ StackIdx push(lua_State *L, const QString &str);
 StackIdx push(lua_State *L, const std::string &str);
 StackIdx push(lua_State *L, const bool &b);
 StackIdx push(lua_State *L, const int &b);
+StackIdx push(lua_State *L, const api::CompletionEvent &ev);
 
 // returns OK?
 bool peek(lua_State *L, int *out, StackIdx idx = -1);

src/controllers/plugins/Plugin.hpp

@@ -98,8 +98,8 @@ public:
 
     // Note: The CallbackFunction object's destructor will remove the function from the lua stack
     using LuaCompletionCallback =
-        lua::CallbackFunction<lua::api::CompletionList, QString, QString, int,
-                              bool>;
+        lua::CallbackFunction<lua::api::CompletionList,
+                              lua::api::CompletionEvent>;
     std::optional<LuaCompletionCallback> getCompletionCallback()
     {
         if (this->state_ == nullptr || !this->error_.isNull())
@@ -123,7 +123,7 @@ public:
 
         // move
         return std::make_optional<lua::CallbackFunction<
-            lua::api::CompletionList, QString, QString, int, bool>>(
+            lua::api::CompletionList, lua::api::CompletionEvent>>(
             this->state_, lua_gettop(this->state_));
     }
 

src/controllers/plugins/PluginController.cpp

@@ -433,8 +433,12 @@ std::pair<bool, QStringList> PluginController::updateCustomCompletions(
             qCDebug(chatterinoLua)
                 << "Processing custom completions from plugin" << name;
             auto &cb = *opt;
-            auto errOrList =
-                cb(query, fullTextContent, cursorPosition, isFirstWord);
+            auto errOrList = cb(lua::api::CompletionEvent{
+                .query = query,
+                .full_text_content = fullTextContent,
+                .cursor_position = cursorPosition,
+                .is_first_word = isFirstWord,
+            });
             if (std::holds_alternative<int>(errOrList))
             {
                 guard.handled();