Method compileTransformsLuaEntry

app/src/DataModel/FrameBuilder.cpp:2066–2130

* @brief Compiles a single Lua dataset transform; logs and skips on any error. */

 * @brief Compiles a single Lua dataset transform; logs and skips on any error.
 */
void DataModel::FrameBuilder::compileTransformsLuaEntry(lua_State* L,
                                                        TransformEngine& engine,
                                                        const TransformEntry& entry)
{
  const int baseTop = lua_gettop(L);

  try {
    lua_newtable(L);
    lua_createtable(L, 0, 1);
    lua_pushglobaltable(L);
    lua_setfield(L, -2, "__index");
    lua_setmetatable(L, -2);

    const QByteArray utf8 = entry.code.toUtf8();
    const QByteArray chunkName =
      QByteArray("=transform[") + QByteArray::number(entry.uniqueId) + "]";
    if (luaL_loadbufferx(L, utf8.constData(), utf8.size(), chunkName.constData(), "t") != LUA_OK) {
      qWarning() << "[FrameBuilder] Transform compile error for dataset" << entry.uniqueId << ":"
                 << lua_tostring(L, -1);
      lua_settop(L, baseTop);
      return;
    }

    lua_pushvalue(L, -2);
    lua_setupvalue(L, -2, 1);

    if (lua_pcall(L, 0, 0, 0) != LUA_OK) {
      qWarning() << "[FrameBuilder] Transform runtime error for dataset" << entry.uniqueId << ":"
                 << lua_tostring(L, -1);
      lua_settop(L, baseTop);
      return;
    }

    lua_getfield(L, -1, "transform");
    if (!lua_isfunction(L, -1)) {
      qWarning() << "[FrameBuilder] Dataset" << entry.uniqueId
                 << "transform code does not define transform()";
      lua_settop(L, baseTop);
      return;
    }

    bool acceptsInfo = false;
    lua_pushvalue(L, -1);
    lua_Debug ar;
    if (lua_getinfo(L, ">u", &ar) != 0) [[likely]]
      acceptsInfo = (ar.nparams >= 2);

    auto existingIt = engine.luaRefs.find(entry.uniqueId);
    if (existingIt != engine.luaRefs.end()) [[unlikely]]
      luaL_unref(L, LUA_REGISTRYINDEX, existingIt->second.ref);

    engine.luaRefs[entry.uniqueId] = LuaTransformRef{luaL_ref(L, LUA_REGISTRYINDEX), acceptsInfo};

    lua_pop(L, 1);
    Q_ASSERT(lua_gettop(L) == baseTop);
  } catch (const std::exception& e) {
    qWarning() << "[FrameBuilder] Transform compile uncaught exception for dataset"
               << entry.uniqueId << ":" << e.what();