feat(es_extended): add static ESX.ExtendedPlayers

[Kenshiin13]

Description

Adds ESX.ExtendedPlayers as a lightweight wrapper for ESX.GetExtendedPlayers. Returns tables of StaticPlayer objects (method-only wrappers) for multiple players, following the same pattern as the existing ESX.Player function.

---

Motivation

ESX.Player provides a minimal interface for a single player by exposing only methods via StaticPlayer. This reduces bloat and avoids exposing full xPlayer properties. ESX.ExtendedPlayers extends this approach to multiple players, making it easier to work with groups of players while keeping the same clean, method-only interface.

---

Implementation Details

• Introduces StaticPlayer class.
• Implements ESX.ExtendedPlayers(key?, val?) which:
  • Returns an array of StaticPlayer objects for a single filter.
  • Returns a table mapping groups to arrays of StaticPlayer objects for multi-group filters.
• Uses ESX.GetExtendedPlayers internally.
• Fully type-annotated for better IDE support and autocomplete.

---

Usage Example

local groupedPlayers = ESX.ExtendedPlayers("job", { "ambulance", "police" }) --[[@as table<string, StaticPlayer[]>]]
for group, players in pairs(groupedPlayers) do
    for i, xPlayer in ipairs(players) do
        print(group, xPlayer.getName())
    end
end

local xPlayers = ESX.ExtendedPlayers() --[=[@as StaticPlayer[]]=]
for i, xPlayer in ipairs(xPlayers) do
    print(xPlayer.getName())
end

---

PR Checklist

• My commit messages and PR title follow the Conventional Commits standard.
• My changes have been tested locally and function as expected.
• My PR does not introduce any breaking changes.
• I have provided a clear explanation of what my PR does, including the reasoning behind the changes and any relevant context.

[Kenshiin13]

esx-framework/esx-legacy-documentation@7153070

[Zykem]

LGTM, Thanks.