beyond-all-reason · WatchTheFort · Mar 31, 2025 · Mar 26, 2025 · Mar 26, 2025 · Mar 26, 2025
diff --git a/.luarc.json b/.luarc.json
@@ -11,7 +11,14 @@
       "include": "require",
       "shard_include": "require"
   },
-  "workspace.library": [
-    "recoil-lua-library"
-  ]
+  "workspace": {
+    "library": [
+      "recoil-lua-library"
+    ],
+    "ignoreDir": [
+      ".vscode",
+      "luaui/Tests",
+      "luaui/TestsExamples"
+    ]
+  }
 }
diff --git a/common/upgets/api_resource_spot_finder.lua b/common/upgets/api_resource_spot_finder.lua
@@ -1,4 +1,4 @@
-local upget = gadget or widget
+local upget = gadget or widget ---@type Addon
 local globalScope = gadget and GG or WG
 
 -- gadget side must be layered after gadgets/map_metal_spot_placer.lua

diff --git a/luarules/gadgets/AILoader.lua b/luarules/gadgets/AILoader.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Shard AI Loader",

diff --git a/luarules/gadgets/activity_broadcast.lua b/luarules/gadgets/activity_broadcast.lua
@@ -1,4 +1,6 @@
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name	= "Activity Broadcast",

diff --git a/luarules/gadgets/ai_namer.lua b/luarules/gadgets/ai_namer.lua
@@ -1,5 +1,7 @@
 
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name	= "AI namer",

diff --git a/luarules/gadgets/ai_ruins.lua b/luarules/gadgets/ai_ruins.lua
@@ -3,6 +3,8 @@ if not (Spring.GetModOptions().ruins == "enabled" or (Spring.GetModOptions().rui
 	return
 end
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name      = "ruin spawn",

diff --git a/luarules/gadgets/ai_scav_blueprint_tester.lua b/luarules/gadgets/ai_scav_blueprint_tester.lua
@@ -13,6 +13,8 @@ local radius
 local high_radius = 0
 local line = 1
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
     return {
       name      = "Scav Blueprint Tester",

diff --git a/luarules/gadgets/ai_simpleai.lua b/luarules/gadgets/ai_simpleai.lua
@@ -21,6 +21,8 @@ for i = 1, #teams do
 end
 teams = nil
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "SimpleAI",

diff --git a/luarules/gadgets/api_damage_stats.lua b/luarules/gadgets/api_damage_stats.lua
@@ -1,4 +1,6 @@
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
   return {
     name      = "Stats",

diff --git a/luarules/gadgets/api_enemyunitdestroyed.lua b/luarules/gadgets/api_enemyunitdestroyed.lua
@@ -1,4 +1,6 @@
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name    = "EnemyUnitDestroyed",

diff --git a/luarules/gadgets/api_garbage_collector.lua b/luarules/gadgets/api_garbage_collector.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Garbage Collector",

diff --git a/luarules/gadgets/api_missions.lua b/luarules/gadgets/api_missions.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Mission API loader",

diff --git a/luarules/gadgets/api_missions_triggers.lua b/luarules/gadgets/api_missions_triggers.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Mission API triggers",

diff --git a/luarules/gadgets/api_pbr_enabler.lua b/luarules/gadgets/api_pbr_enabler.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name      = "PBR enabler",

diff --git a/luarules/gadgets/api_permissions.lua b/luarules/gadgets/api_permissions.lua
@@ -1,4 +1,6 @@
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name    = "Permissions",

diff --git a/luarules/gadgets/api_widget_events.lua b/luarules/gadgets/api_widget_events.lua
@@ -1,5 +1,7 @@
 if gadgetHandler:IsSyncedCode() then return end
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name      = "Widget Events",

diff --git a/luarules/gadgets/camera_lockcamera.lua b/luarules/gadgets/camera_lockcamera.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "CameraBroadcast",

diff --git a/luarules/gadgets/cmd_alliance_break.lua b/luarules/gadgets/cmd_alliance_break.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Unally on demand",

diff --git a/luarules/gadgets/cmd_area_mex.lua b/luarules/gadgets/cmd_area_mex.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Area Mex",

diff --git a/luarules/gadgets/cmd_dev_helpers.lua b/luarules/gadgets/cmd_dev_helpers.lua
@@ -5,6 +5,8 @@ for word in msg:gmatch("[%-_%w]+") do
 end
 ]]--
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Dev Helper Cmds",

diff --git a/luarules/gadgets/cmd_factory_stop_production.lua b/luarules/gadgets/cmd_factory_stop_production.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Factory Stop Production",

diff --git a/luarules/gadgets/cmd_get_player_data.lua b/luarules/gadgets/cmd_get_player_data.lua
@@ -1,6 +1,8 @@
 --------------------------------------------------------------------------------
 --------------------------------------------------------------------------------
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Get Player Data",

diff --git a/luarules/gadgets/cmd_give.lua b/luarules/gadgets/cmd_give.lua
@@ -1,4 +1,6 @@
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name    = "Give Command",

diff --git a/luarules/gadgets/cmd_idle_players.lua b/luarules/gadgets/cmd_idle_players.lua
@@ -3,6 +3,8 @@ if Spring.Utilities.Gametype.IsSinglePlayer() then
 	return
 end
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
     return {
         name = "Take Manager",

diff --git a/luarules/gadgets/cmd_limiter.lua b/luarules/gadgets/cmd_limiter.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name      = "CMD limiter",

diff --git a/luarules/gadgets/cmd_luaui_reload.lua b/luarules/gadgets/cmd_luaui_reload.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
   return {
     name      = "LuaUI Reload",

diff --git a/luarules/gadgets/cmd_manual_launch.lua b/luarules/gadgets/cmd_manual_launch.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name 	= "Manual launch command",

diff --git a/luarules/gadgets/cmd_mex_denier.lua b/luarules/gadgets/cmd_mex_denier.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Deny Invalid Mex Orders",

diff --git a/luarules/gadgets/cmd_mouse_pos_broadcast.lua b/luarules/gadgets/cmd_mouse_pos_broadcast.lua
@@ -7,6 +7,8 @@
 --------------------------------------------------------------------------------
 --------------------------------------------------------------------------------
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name	= "Cursor Broadcast",

diff --git a/luarules/gadgets/cmd_onoffdesc.lua b/luarules/gadgets/cmd_onoffdesc.lua
@@ -2,6 +2,8 @@ if not gadgetHandler:IsSyncedCode() then
 	return
 end
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
   return {
 	name 	= "On/Off descriptions",

diff --git a/luarules/gadgets/cmd_paused_is_paused.lua b/luarules/gadgets/cmd_paused_is_paused.lua
@@ -6,6 +6,8 @@ if not gadgetHandler:IsSyncedCode() then
 	return
 end
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name 	= "Paused is paused",

diff --git a/luarules/gadgets/cmd_place_target_on_ground.lua b/luarules/gadgets/cmd_place_target_on_ground.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name      = 'Place Target On Ground',

diff --git a/luarules/gadgets/cmd_remove_stop.lua b/luarules/gadgets/cmd_remove_stop.lua
@@ -2,6 +2,8 @@ if not gadgetHandler:IsSyncedCode() then
 	return
 end
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name 	= "Remove Stop",

diff --git a/luarules/gadgets/cmd_remove_wait.lua b/luarules/gadgets/cmd_remove_wait.lua
@@ -2,6 +2,8 @@ if not gadgetHandler:IsSyncedCode() then
 	return
 end
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name 	= "Remove Wait",

diff --git a/luarules/gadgets/cmd_selected_units.lua b/luarules/gadgets/cmd_selected_units.lua
@@ -1,4 +1,6 @@
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Ally Selected Units",

diff --git a/luarules/gadgets/cmd_sendcommand.lua b/luarules/gadgets/cmd_sendcommand.lua
@@ -1,4 +1,6 @@
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name    = "Send Command",

diff --git a/luarules/gadgets/cmd_undo.lua b/luarules/gadgets/cmd_undo.lua
@@ -1,4 +1,6 @@
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name    = "Undo Self Destruction Havoc",

diff --git a/luarules/gadgets/cus_gl4.lua b/luarules/gadgets/cus_gl4.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name	= "CUS GL4",

diff --git a/luarules/gadgets/dbg_buildicons_run.lua b/luarules/gadgets/dbg_buildicons_run.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Build Icons Slowy (/luarules buildiconslow or buildiconanim or buildiconanimslow)",

diff --git a/luarules/gadgets/dbg_cob_debug.lua b/luarules/gadgets/dbg_cob_debug.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Cob Debug",

diff --git a/luarules/gadgets/dbg_gadget_profiler.lua b/luarules/gadgets/dbg_gadget_profiler.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Gadget Profiler",

diff --git a/luarules/gadgets/dbg_synced_proxy.lua b/luarules/gadgets/dbg_synced_proxy.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Synced Proxy",

diff --git a/luarules/gadgets/dbg_test_env_helper.lua b/luarules/gadgets/dbg_test_env_helper.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Test Environment Helper",

diff --git a/luarules/gadgets/dbg_unit_callins.lua b/luarules/gadgets/dbg_unit_callins.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "UnitCallinsGadget",

diff --git a/luarules/gadgets/dbg_unitposition_logger.lua b/luarules/gadgets/dbg_unitposition_logger.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Unit Position Logger",

diff --git a/luarules/gadgets/dev_replay_data.lua b/luarules/gadgets/dev_replay_data.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name    = "UnitDamagedReplay",
@@ -46,6 +48,8 @@ end
 
 --[[
 Use this widget to print UnitDamaged info to the infolog (or modify it for your purposes)
+local widget = widget ---@type Widget
+
 function widget:GetInfo()
     return {
       name      = "UnitDamageReplayAnalysis",

diff --git a/luarules/gadgets/feature_dead_explosion.lua b/luarules/gadgets/feature_dead_explosion.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Feature Death Explosion",

diff --git a/luarules/gadgets/feature_debris_physics.lua b/luarules/gadgets/feature_debris_physics.lua
@@ -1,5 +1,7 @@
 if not gadgetHandler:IsSyncedCode() then return end
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name    = "Debris physics",

diff --git a/luarules/gadgets/fx_atmosphere.lua b/luarules/gadgets/fx_atmosphere.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
     return {
         name      = "GeoVent Sounds",

diff --git a/luarules/gadgets/fx_depthcharge_splash.lua b/luarules/gadgets/fx_depthcharge_splash.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
     return {
         name      = "Depthcharge splash",

diff --git a/luarules/gadgets/fx_missile_smoke.lua b/luarules/gadgets/fx_missile_smoke.lua
@@ -2,6 +2,8 @@
 -- but can run out of fuel when they dont traight fly to maxrange
 
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
     return {
         name      = "Missile smoke",

diff --git a/luarules/gadgets/fx_missile_starburst_liftoff.lua b/luarules/gadgets/fx_missile_starburst_liftoff.lua
@@ -2,6 +2,8 @@
 -- but can run out of fuel when they dont traight fly to maxrange
 
 
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "Starburst Missile Liftoff",

diff --git a/luarules/gadgets/fx_projectile_effects.lua b/luarules/gadgets/fx_projectile_effects.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
     return {
         name      = "Projectile Effects",

diff --git a/luarules/gadgets/fx_reclaim_shards.lua b/luarules/gadgets/fx_reclaim_shards.lua
@@ -1,3 +1,5 @@
+local gadget = gadget ---@type Gadget
+
 function gadget:GetInfo()
 	return {
 		name = "fx_reclaim_shards",