From fe8fa98123b9a90cee2977e5274542c9e8922e17 Mon Sep 17 00:00:00 2001
From: WinterSolstice8 <60417494+wintersolstice8@users.noreply.github.com>
Date: Fri, 3 Apr 2026 20:57:09 -0600
Subject: [PATCH] [lua] [lls] Adjust some LLS hinting for new LLS version

---
 scripts/globals/job_utils/dragoon.lua      | 1 +
 scripts/globals/nyzul/floor_generation.lua | 8 +++++++-
 scripts/specs/core/CBaseEntity.lua         | 2 +-
 3 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/scripts/globals/job_utils/dragoon.lua b/scripts/globals/job_utils/dragoon.lua
index b9263471aec..a6aa72bb422 100644
--- a/scripts/globals/job_utils/dragoon.lua
+++ b/scripts/globals/job_utils/dragoon.lua
@@ -327,6 +327,7 @@ xi.job_utils.dragoon.applyEmpathyBonus = function(player, wyvern)
     xi.job_utils.dragoon.addWyvernExp(player, 200 * empathyTotal)
 
     if empathyTotal > 0 then
+        ---@type CStatusEffect[]
         local validEffects = {}
         local i            = 0
         local effects      = player:getStatusEffects()
diff --git a/scripts/globals/nyzul/floor_generation.lua b/scripts/globals/nyzul/floor_generation.lua
index 5a3a1bcf96b..7fb0223545c 100644
--- a/scripts/globals/nyzul/floor_generation.lua
+++ b/scripts/globals/nyzul/floor_generation.lua
@@ -6,9 +6,13 @@ local ID = zones[xi.zone.NYZUL_ISLE]
 xi = xi or {}
 xi.nyzul = xi.nyzul or {}
 
+---@alias coords { x: number, y: number, z: number }
+---@alias coordArray { table: coords[] }
+
 -----------------------------------
 -- Data Tables
 -----------------------------------
+---@type coordArray[]
 local lampSpawnPoints = -- Set lamp spawn points, by layout.
 {
     [1] = -- 380, -0.5, -500
@@ -189,6 +193,7 @@ local lampSpawnPoints = -- Set lamp spawn points, by layout.
     },
 }
 
+---@type coordArray[]
 local layoutSpawnPoints = -- Spawnpoints by layout.
 {
     [1] =
@@ -1224,7 +1229,8 @@ xi.nyzul.prepareMobs = function(instance)
         -- Build dynamic table with all the possible spawn points.
         local floorLayout      = instance:getLocalVar('Nyzul_Isle_FloorLayout')
         local spawnPointIndex  = 0
-        local spawnPoint       = 0
+        ---@type coords
+        local spawnPoint       = nil
         local dTableSpawnPoint = {}
 
         for i = 1, #layoutSpawnPoints[floorLayout] do
diff --git a/scripts/specs/core/CBaseEntity.lua b/scripts/specs/core/CBaseEntity.lua
index c3f70ef87e6..2a7cb9ddb4e 100644
--- a/scripts/specs/core/CBaseEntity.lua
+++ b/scripts/specs/core/CBaseEntity.lua
@@ -2899,7 +2899,7 @@ function CBaseEntity:getStatusEffectBySource(StatusID, SourceType, SourceTypePar
 end
 
 ---@nodiscard
----@return table
+---@return CStatusEffect[]
 function CBaseEntity:getStatusEffects()
 end