@return

---@return type [name] [description]
---@return (instance) type [name] [description]
---@return (definition) type [name] [description]

---@return string name The player's name
function GetPlayerName() return "Player" end

---@return boolean success Whether the operation succeeded
---@return string message Status message
function DoOperation()
    return true, "OK"
end

local ok, msg = DoOperation()
-- ok: boolean, msg: string ✅

---@return Player | nil player The player, or nil if not found
function FindPlayer(name) end

---@return Player? player
function FindPlayer(name) end

---@return boolean=false success Whether the operation succeeded
function SaveData() end

---@generic T
---@param value T
---@return T
function clone(value) return deepCopy(value) end

---@generic T : Entity
---@param class `T`
---@return T
function ents.Create(class) end

---@generic T : Entity
---@param class `T`
---@return T[]
function ents.FindByClass(class) end

---@return fun(x: number): string formatter
function GetFormatter() end

---@return (instance) Panel
function CreateMyPanel()
    return vgui.Create("DPanel")
end

local panel = CreateMyPanel()
function panel:Refresh() end  -- Only on this panel instance

local other = CreateMyPanel()
other:Refresh()  -- ❌ Error: Refresh doesn't exist here

---@return (definition) Entity
function GetEntityBase()
    return Entity
end

local base = GetEntityBase()
base.MyNewMethod = function(self) end -- Added to all Entity instances globally