rock-mod 0.20.0 → 0.21.0

package/dist/client/factories/ccmp/CCMPManagersFactory.js

@@ -0,0 +1,149 @@
+import { CCMPNetManager } from "../../net/ccmp/CCMPNetManager";
+import { CCMPBrowserManager } from "../../game/ccmp/browser/CCMPBrowserManager";
+import { CCMPStorageManager } from "../../game/ccmp/storage/CCMPStorageManager";
+import { CCMPKeysManager } from "../../game/ccmp/keys/CCMPKeysManager";
+import { CCMPNametagsManager } from "../../game/ccmp/nametags/CCMPNametagsManager";
+import { CCMPChatManager } from "../../game/ccmp/chat/CCMPChatManager";
+import { CCMPControlsManager } from "../../game/ccmp/controls/CCMPControlsManager";
+import { CCMPPlayersManager } from "../../entities/ccmp/player/CCMPPlayersManager";
+import { CCMPPedsManager } from "../../entities/ccmp/ped/CCMPPedsManager";
+import { CCMPVehiclesManager } from "../../entities/ccmp/vehicle/CCMPVehiclesManager";
+import { CCMPUtilsManager } from "../../utils/ccmp/CCMPUtilsManager";
+import { CCMPGraphicsManager } from "../../game/ccmp/graphics/CCMPGraphicsManager";
+import { CCMPUiManager } from "../../game/ccmp/ui/CCMPUiManager";
+import { CCMPPathfindManager } from "../../game/ccmp/pathfind/CCMPPathfindManager";
+import { CCMPZoneManager } from "../../game/ccmp/zone/CCMPZoneManager";
+import { CCMPNativeCallerManager } from "../../game/ccmp/native/CCMPNativeCallerManager";
+import { CCMPGuiManager } from "../../game/ccmp/gui/CCMPGuiManager";
+import { CCMPRaycastingManager } from "../../game/ccmp/raycasting/CCMPRaycastingManager";
+import { CCMPSyncedMetaBridge } from "../../net/ccmp/events/CCMPSyncedMetaBridge";
+import { CCMPCameraManager } from "../../entities/ccmp/camera/CCMPCameraManager";
+import { CCMPStreamingManager } from "../../game/ccmp/streaming/CCMPStreamingManager";
+import { CCMPCursorManager } from "../../game/ccmp/cursor/CCMPCursorManager";
+import { CCMPGameObjectManager } from "../../game/ccmp/object/CCMPGameObjectManager";
+import { CCMPGameplayManager } from "../../game/ccmp/gameplay/CCMPGameplayManager";
+import { createNotImplementedProxy } from "./createNotImplementedProxy";
+export class CCMPManagersFactory {
+    constructor() {
+        /**
+         * Сохраняем созданный `CCMPNetManager` потому что другим менеджерам
+         * (например, `CCMPPlayersManager`) нужен доступ к его событиям. Порядок
+         * создания в `RockMod` гарантирует, что `createNetManager` вызывается
+         * первым — мы можем безопасно полагаться на наличие `_netManager` в
+         * последующих фабричных методах.
+         */
+        this._netManager = null;
+    }
+    createNetManager() {
+        this._netManager = new CCMPNetManager();
+        return this._netManager;
+    }
+    _requireNetManager(forMethod) {
+        if (!this._netManager) {
+            throw new Error(`CCMPManagersFactory.${forMethod}: ` +
+                "createNetManager() ещё не вызывался. Это нарушение контракта порядка " +
+                "фабричных методов в RockMod-конструкторе.");
+        }
+        return this._netManager;
+    }
+    createBlipsManager() {
+        return createNotImplementedProxy("CCMPBlipsManager");
+    }
+    createColshapesManager() {
+        return createNotImplementedProxy("CCMPColshapesManager");
+    }
+    createMarkersManager() {
+        return createNotImplementedProxy("CCMPMarkersManager");
+    }
+    createObjectsManager() {
+        return createNotImplementedProxy("CCMPObjectsManager");
+    }
+    createPedsManager() {
+        return new CCMPPedsManager();
+    }
+    createPlayersManager() {
+        const netManager = this._requireNetManager("createPlayersManager");
+        const playersManager = new CCMPPlayersManager(netManager.events);
+        // Bridge для `streamSyncedMetaChange` создаётся здесь — ему нужен
+        // players manager для резолва `entityId → CCMPPlayer`, а events bus
+        // — для эмиссии `rm::syncedMetaChange` (на который уже подписан
+        // `CCMPDataHandler`, инстанцированный в `CCMPNetManager`).
+        new CCMPSyncedMetaBridge(netManager.events, playersManager).register();
+        return playersManager;
+    }
+    createUtilsManager() {
+        return new CCMPUtilsManager();
+    }
+    createVehiclesManager() {
+        return new CCMPVehiclesManager();
+    }
+    createBrowserManager() {
+        return new CCMPBrowserManager();
+    }
+    createChatManager() {
+        return new CCMPChatManager();
+    }
+    createCursorManager() {
+        return new CCMPCursorManager();
+    }
+    createGuiManager() {
+        return new CCMPGuiManager();
+    }
+    createRaycastingManager() {
+        return new CCMPRaycastingManager();
+    }
+    createVoiceChatManager() {
+        return createNotImplementedProxy("CCMPVoiceChatManager");
+    }
+    createCameraManager() {
+        return new CCMPCameraManager();
+    }
+    createStorageManager() {
+        return new CCMPStorageManager();
+    }
+    createGraphicsManager() {
+        return new CCMPGraphicsManager();
+    }
+    createNativeManager() {
+        return new CCMPNativeCallerManager();
+    }
+    createStreamingManager() {
+        return new CCMPStreamingManager();
+    }
+    createLocalPlayerManager() {
+        return createNotImplementedProxy("CCMPLocalPlayerManager");
+    }
+    createControlsManager() {
+        return new CCMPControlsManager();
+    }
+    createKeysManager() {
+        return new CCMPKeysManager();
+    }
+    createGameplayManager() {
+        return new CCMPGameplayManager();
+    }
+    createGameCameraManager() {
+        return createNotImplementedProxy("CCMPGameCameraManager");
+    }
+    createUiManager() {
+        return new CCMPUiManager();
+    }
+    createNametagsManager() {
+        return new CCMPNametagsManager();
+    }
+    createPathfindManager() {
+        return new CCMPPathfindManager();
+    }
+    createZoneManager() {
+        return new CCMPZoneManager();
+    }
+    createWeaponManager() {
+        return createNotImplementedProxy("CCMPWeaponManager");
+    }
+    createGameObjectManager() {
+        return new CCMPGameObjectManager();
+    }
+    createConsoleManager() {
+        return createNotImplementedProxy("CCMPConsoleManager");
+    }
+}

package/dist/client/factories/ccmp/createNotImplementedProxy.d.ts

@@ -0,0 +1 @@
+export declare const createNotImplementedProxy: <T extends object>(name: string) => T;

package/dist/client/factories/ccmp/createNotImplementedProxy.js

@@ -0,0 +1,24 @@
+const createNotImplementedError = (path) => new Error(`${path}: not implemented yet`);
+const createProxy = (path) => {
+    function notImplementedProxyTarget() {
+        throw createNotImplementedError(path);
+    }
+    return new Proxy(notImplementedProxyTarget, {
+        apply() {
+            throw createNotImplementedError(path);
+        },
+        construct() {
+            throw createNotImplementedError(path);
+        },
+        get(_target, property) {
+            if (property === "then") {
+                return undefined;
+            }
+            return createProxy(`${path}.${String(property)}`);
+        },
+        set(_target, property) {
+            throw createNotImplementedError(`${path}.${String(property)}`);
+        },
+    });
+};
+export const createNotImplementedProxy = (name) => createProxy(name);

package/dist/client/game/ccmp/browser/CCMPBrowserManager.d.ts

@@ -0,0 +1,22 @@
+import { type IBrowserHandle, type IBrowserManager } from "../../common/browser/IBrowserManager";
+/**
+ * Реализация `IBrowserManager` поверх нативного CCMP browser API.
+ *
+ * CCMP предоставляет полноценное CEF-управление через `ccmp.browsers` —
+ * это прямое соответствие RageMP'шному `mp.browsers`. Маппинг:
+ *  - `create(url)` → `ccmp.browsers.create(url)` → возвращает `Browser` с
+ *    числовым `id`, который мы храним для последующих `execute`/`destroy`.
+ *  - `execute(code)` → `Browser.executeJavaScript(code)`.
+ *  - `destroy()` → `Browser.destroy()`.
+ *
+ * Геймод-консьюмер (`BrowserService` → один логический браузер на гейм-mod)
+ * управляет только одним инстансом одновременно, поэтому держим ссылку
+ * на единственный созданный браузер.
+ */
+export declare class CCMPBrowserManager implements IBrowserManager {
+    private _browser;
+    create(url: string): void;
+    createInstance(url: string): IBrowserHandle;
+    destroy(): void;
+    execute(code: string): void;
+}

package/dist/client/game/ccmp/browser/CCMPBrowserManager.js

@@ -0,0 +1,66 @@
+class CCMPBrowserHandle {
+    constructor(url) {
+        this._browser = ccmp.browsers.create(url);
+    }
+    get isAlive() {
+        return this._browser !== null;
+    }
+    destroy() {
+        if (!this._browser) {
+            return;
+        }
+        this._browser.destroy();
+        this._browser = null;
+    }
+    execute(code) {
+        if (!this._browser) {
+            return;
+        }
+        this._browser.executeJavaScript(code);
+    }
+    setOrderId(orderId) {
+        if (!this._browser) {
+            return;
+        }
+        this._browser.setOrderId(orderId);
+    }
+}
+/**
+ * Реализация `IBrowserManager` поверх нативного CCMP browser API.
+ *
+ * CCMP предоставляет полноценное CEF-управление через `ccmp.browsers` —
+ * это прямое соответствие RageMP'шному `mp.browsers`. Маппинг:
+ *  - `create(url)` → `ccmp.browsers.create(url)` → возвращает `Browser` с
+ *    числовым `id`, который мы храним для последующих `execute`/`destroy`.
+ *  - `execute(code)` → `Browser.executeJavaScript(code)`.
+ *  - `destroy()` → `Browser.destroy()`.
+ *
+ * Геймод-консьюмер (`BrowserService` → один логический браузер на гейм-mod)
+ * управляет только одним инстансом одновременно, поэтому держим ссылку
+ * на единственный созданный браузер.
+ */
+export class CCMPBrowserManager {
+    constructor() {
+        this._browser = null;
+    }
+    create(url) {
+        this.destroy();
+        this._browser = this.createInstance(url);
+    }
+    createInstance(url) {
+        return new CCMPBrowserHandle(url);
+    }
+    destroy() {
+        if (!this._browser) {
+            return;
+        }
+        this._browser.destroy();
+        this._browser = null;
+    }
+    execute(code) {
+        if (!this._browser) {
+            return;
+        }
+        this._browser.execute(code);
+    }
+}

package/dist/client/game/ccmp/chat/CCMPChatManager.d.ts

@@ -0,0 +1,26 @@
+import { type IChatManager } from "../../common/chat/IChatManager";
+/**
+ * No-op реализация `IChatManager` под CCMP.
+ *
+ * У RageMP клиента есть `mp.gui.chat.activate(state)` (разрешает игроку
+ * печатать в чат по T) и `mp.gui.chat.show(state)` (видимость чат-окна).
+ * У CCMP **нет JS API для управления чатом** — только встроенное событие
+ * `chatMessage` на приём входящих сообщений и `ccmp.notify(text)` для HUD-
+ * уведомлений (не относится к чату).
+ *
+ * Бросать нельзя: геймод-консьюмер `RockModChatAdapter.activate` вызывается
+ * из `ChatService.onModuleInit` — исключение поднимет весь bootstrap DI.
+ * Поэтому игнорируем + один раз пишем warn, чтобы было видно в логах что
+ * фича недоступна.
+ *
+ * Следствие: под CCMP программное управление чатом не работает. Чат-UI
+ * (если он есть) рисуется самим CCMP-клиентом на Rust-стороне и реагирует
+ * на свои клавиши. Когда (если) CCMP добавит JS-API для чата — заменим.
+ */
+export declare class CCMPChatManager implements IChatManager {
+    private _warned;
+    activate(state: boolean): void;
+    show(state: boolean): void;
+    push(text: string): void;
+    private _warnOnce;
+}

package/dist/client/game/ccmp/chat/CCMPChatManager.js

@@ -0,0 +1,41 @@
+/**
+ * No-op реализация `IChatManager` под CCMP.
+ *
+ * У RageMP клиента есть `mp.gui.chat.activate(state)` (разрешает игроку
+ * печатать в чат по T) и `mp.gui.chat.show(state)` (видимость чат-окна).
+ * У CCMP **нет JS API для управления чатом** — только встроенное событие
+ * `chatMessage` на приём входящих сообщений и `ccmp.notify(text)` для HUD-
+ * уведомлений (не относится к чату).
+ *
+ * Бросать нельзя: геймод-консьюмер `RockModChatAdapter.activate` вызывается
+ * из `ChatService.onModuleInit` — исключение поднимет весь bootstrap DI.
+ * Поэтому игнорируем + один раз пишем warn, чтобы было видно в логах что
+ * фича недоступна.
+ *
+ * Следствие: под CCMP программное управление чатом не работает. Чат-UI
+ * (если он есть) рисуется самим CCMP-клиентом на Rust-стороне и реагирует
+ * на свои клавиши. Когда (если) CCMP добавит JS-API для чата — заменим.
+ */
+export class CCMPChatManager {
+    constructor() {
+        this._warned = false;
+    }
+    activate(state) {
+        this._warnOnce("activate", state);
+    }
+    show(state) {
+        this._warnOnce("show", state);
+    }
+    push(text) {
+        ccmp.notify(text);
+    }
+    _warnOnce(method, state) {
+        if (this._warned) {
+            return;
+        }
+        this._warned = true;
+        console.warn(`[CCMPChatManager] ${method}(${String(state)}) вызван, но CCMP не ` +
+            `предоставляет JS API для управления чатом. Дальнейшие вызовы ` +
+            `activate/show будут проигнорированы молча.`);
+    }
+}

package/dist/client/game/ccmp/controls/CCMPControlsManager.d.ts

@@ -0,0 +1,33 @@
+import { type IControlsManager } from "../../common/controls/IControlsManager";
+/**
+ * Реализация `IControlsManager` поверх натива-обёртки CCMP `ccmp.natives.pad.*`.
+ *
+ * Все четыре метода — прямой passthrough к соответствующим GTA V-нативам
+ * (`DISABLE_CONTROL_ACTION`, `IS_CONTROL_PRESSED`, `IS_DISABLED_CONTROL_PRESSED`,
+ * `GET_DISABLED_CONTROL_NORMAL`) с сохранением порядка аргументов:
+ *
+ *   IControlsManager.disableControlAction(padIndex, control, disable)
+ *     → ccmp.natives.pad.disableControlAction(padIndex, control, disable)
+ *
+ * Семантика и значения индексов идентичны RageMP — гейм-mod консьюмеры
+ * (`ControlsService` / `WeaponService.disableControlActions`) используют те
+ * же константы `Control.*` (см. `@shared/common/enums/Control`).
+ *
+ * **Hot path:** `disableControlAction` вызывается на каждый render-tick из
+ * `WeaponController.onRender`. CCMP-native — это синхронный вызов V8 op'а,
+ * стоимость порядка единиц микросекунд; никакой буферизации не нужно.
+ *
+ * Имена параметров `CcmpNativesPad.disableControlAction(control, action, ...)`
+ * **обманчивы** — это generic-renames из натив-генератора. Фактически первый
+ * аргумент — `padIndex` (0..2), второй — `control` (Control.*), третий —
+ * `disable: boolean`. См. https://docs.fivem.net/natives/?_0xFE99B66D43DA8E7B.
+ */
+export declare class CCMPControlsManager implements IControlsManager {
+    disableControlAction(padIndex: number, control: number, disable: boolean): void;
+    isDisabledControlPressed(padIndex: number, control: number): boolean;
+    isDisabledControlJustPressed(padIndex: number, control: number): boolean;
+    isControlPressed(padIndex: number, control: number): boolean;
+    isControlJustPressed(padIndex: number, control: number): boolean;
+    isControlJustReleased(padIndex: number, control: number): boolean;
+    getDisabledControlNormal(padIndex: number, control: number): number;
+}

package/dist/client/game/ccmp/controls/CCMPControlsManager.js

@@ -0,0 +1,47 @@
+/// <reference types="@classic-mp/types/client" />
+/**
+ * Реализация `IControlsManager` поверх натива-обёртки CCMP `ccmp.natives.pad.*`.
+ *
+ * Все четыре метода — прямой passthrough к соответствующим GTA V-нативам
+ * (`DISABLE_CONTROL_ACTION`, `IS_CONTROL_PRESSED`, `IS_DISABLED_CONTROL_PRESSED`,
+ * `GET_DISABLED_CONTROL_NORMAL`) с сохранением порядка аргументов:
+ *
+ *   IControlsManager.disableControlAction(padIndex, control, disable)
+ *     → ccmp.natives.pad.disableControlAction(padIndex, control, disable)
+ *
+ * Семантика и значения индексов идентичны RageMP — гейм-mod консьюмеры
+ * (`ControlsService` / `WeaponService.disableControlActions`) используют те
+ * же константы `Control.*` (см. `@shared/common/enums/Control`).
+ *
+ * **Hot path:** `disableControlAction` вызывается на каждый render-tick из
+ * `WeaponController.onRender`. CCMP-native — это синхронный вызов V8 op'а,
+ * стоимость порядка единиц микросекунд; никакой буферизации не нужно.
+ *
+ * Имена параметров `CcmpNativesPad.disableControlAction(control, action, ...)`
+ * **обманчивы** — это generic-renames из натив-генератора. Фактически первый
+ * аргумент — `padIndex` (0..2), второй — `control` (Control.*), третий —
+ * `disable: boolean`. См. https://docs.fivem.net/natives/?_0xFE99B66D43DA8E7B.
+ */
+export class CCMPControlsManager {
+    disableControlAction(padIndex, control, disable) {
+        ccmp.natives.pad.disableControlAction(padIndex, control, disable);
+    }
+    isDisabledControlPressed(padIndex, control) {
+        return ccmp.natives.pad.isDisabledControlPressed(padIndex, control);
+    }
+    isDisabledControlJustPressed(padIndex, control) {
+        return ccmp.natives.pad.isDisabledControlJustPressed(padIndex, control);
+    }
+    isControlPressed(padIndex, control) {
+        return ccmp.natives.pad.isControlPressed(padIndex, control);
+    }
+    isControlJustPressed(padIndex, control) {
+        return ccmp.natives.pad.isControlJustPressed(padIndex, control);
+    }
+    isControlJustReleased(padIndex, control) {
+        return ccmp.natives.pad.isControlJustReleased(padIndex, control);
+    }
+    getDisabledControlNormal(padIndex, control) {
+        return ccmp.natives.pad.getDisabledControlNormal(padIndex, control);
+    }
+}

package/dist/client/game/ccmp/cursor/CCMPCursorManager.d.ts

@@ -0,0 +1,6 @@
+import { type ICursorManager } from "../../../game";
+import { Vector2D } from "../../../../shared/common/utils";
+export declare class CCMPCursorManager implements ICursorManager {
+    show(_freezeControls: boolean, state: boolean): void;
+    getPosition(): Vector2D;
+}

package/dist/client/game/ccmp/cursor/CCMPCursorManager.js

@@ -0,0 +1,15 @@
+/// <reference types="@classic-mp/types/client" />
+import { Vector2D } from "../../../../shared/common/utils";
+export class CCMPCursorManager {
+    show(_freezeControls, state) {
+        if (state) {
+            ccmp.cursor.show();
+            return;
+        }
+        ccmp.cursor.hide();
+    }
+    getPosition() {
+        const position = ccmp.cursor.getPosition();
+        return new Vector2D(position.x, position.y);
+    }
+}

package/dist/client/game/ccmp/gameplay/CCMPGameplayManager.d.ts

@@ -0,0 +1,6 @@
+import { type IGameplayManager } from "../../../game";
+import { type IVector3D } from "../../../../shared/common/utils";
+export declare class CCMPGameplayManager implements IGameplayManager {
+    setFadeOutAfterDeath(toggle: boolean): void;
+    getGroundZFor3dCoord(position: IVector3D, ignoreWater: boolean, waterLevelCheck: boolean): number;
+}

package/dist/client/game/ccmp/gameplay/CCMPGameplayManager.js

@@ -0,0 +1,10 @@
+/// <reference types="@classic-mp/types/client" />
+export class CCMPGameplayManager {
+    setFadeOutAfterDeath(toggle) {
+        ccmp.natives.misc.setFadeOutAfterDeath(toggle);
+    }
+    getGroundZFor3dCoord(position, ignoreWater, waterLevelCheck) {
+        const result = ccmp.natives.misc.getGroundZFor3dCoord(position.x, position.y, position.z, ignoreWater, waterLevelCheck);
+        return result.groundz;
+    }
+}

package/dist/client/game/ccmp/graphics/CCMPGraphicsManager.d.ts

@@ -0,0 +1,58 @@
+import { type IGraphicsManager, type ILoopedParticleFxAtCoordOptions, type IParticleFxAtCoordOptions, type IScreenTextOptions } from "../../common/graphics/IGraphicsManager";
+import { type IVector2D, type IVector3D } from "../../../../shared/common/utils";
+/**
+ * Реализация `IGraphicsManager` под CCMP.
+ *
+ * RageMP даёт высокоуровневые обёртки `mp.game.graphics.drawText` /
+ * `world3dToScreen2d` / etc. У CCMP таких помощников нет — есть только
+ * сырые GTA V натив-биндинги в `ccmp.natives.{hud,graphics}.*`. Этот класс
+ * собирает их в эквивалент RageMP API.
+ *
+ * ### `drawText` — мульти-нативная цепочка
+ *
+ * Стандартная GTA V последовательность:
+ *  1. `SET_TEXT_FONT/SCALE/COLOUR/OUTLINE/CENTRE` — стиль текста
+ *  2. `BEGIN_TEXT_COMMAND_DISPLAY_TEXT('STRING')` — открыть text command
+ *  3. `ADD_TEXT_COMPONENT_SUBSTRING_PLAYER_NAME(text)` — добавить содержимое
+ *  4. `END_TEXT_COMMAND_DISPLAY_TEXT(x, y, 0)` — отрисовать
+ *
+ * **Hot path:** вызывается каждый render-tick из `HudController.onRender`
+ * (ammo, nametags, etc). Все вызовы синхронны (V8-ops), общая стоимость —
+ * единицы микросекунд на текст.
+ *
+ * **Ограничение длины:** `ADD_TEXT_COMPONENT_SUBSTRING_PLAYER_NAME` усекает
+ * вход на 99 символов. Для типичных HUD-меток (ammo "30/120", имена игроков)
+ * не критично; для длинных строк нужно разбивать на чанки последовательными
+ * `ADD_*` вызовами. Сейчас не реализовано — добавим если понадобится.
+ *
+ * ### `world3dToScreen2d`
+ *
+ * `getScreenCoordFromWorldCoord` возвращает `{return, screenx, screeny}` —
+ * `return=false` означает, что точка вне frustum'а; маппим в `null` для
+ * совпадения с RageMP-семантикой.
+ *
+ * ### `getActiveScreenResolution`
+ *
+ * Маппится на `getActualScreenResolution` (GTA native `0x873C9F3104101DD3`),
+ * который возвращает физическое разрешение рендера — то же, что RageMP'шный
+ * `getActiveScreenResolution` (это один и тот же натив, переименованный по-
+ * разному в разных биндингах).
+ *
+ * ### `startScreenEffect` / `stopScreenEffect`
+ *
+ * Маппятся на `animpostfxPlay` / `animpostfxStop` (`ANIMPOSTFX_PLAY`/`STOP`) —
+ * это и есть GTA V натив для screen effect'ов (по-старому называвшийся
+ * `START_SCREEN_EFFECT`).
+ */
+export declare class CCMPGraphicsManager implements IGraphicsManager {
+    drawText(text: string, position: IVector2D, options?: IScreenTextOptions): void;
+    world3dToScreen2d(position: IVector3D): IVector2D | null;
+    startScreenEffect(effectName: string, duration: number, looped: boolean): void;
+    stopScreenEffect(effectName: string): void;
+    setPtfxAssetNextCall(assetName: string): void;
+    startParticleFxNonLoopedAtCoord(options: IParticleFxAtCoordOptions): boolean;
+    startParticleFxLoopedAtCoord(options: ILoopedParticleFxAtCoordOptions): number;
+    stopParticleFxLooped(handle: number, p1: boolean): void;
+    getSafeZoneSize(): number;
+    getActiveScreenResolution(): IVector2D;
+}

package/dist/client/game/ccmp/graphics/CCMPGraphicsManager.js

@@ -0,0 +1,112 @@
+/// <reference types="@classic-mp/types/client" />
+import { Vector2D } from "../../../../shared/common/utils";
+/**
+ * Реализация `IGraphicsManager` под CCMP.
+ *
+ * RageMP даёт высокоуровневые обёртки `mp.game.graphics.drawText` /
+ * `world3dToScreen2d` / etc. У CCMP таких помощников нет — есть только
+ * сырые GTA V натив-биндинги в `ccmp.natives.{hud,graphics}.*`. Этот класс
+ * собирает их в эквивалент RageMP API.
+ *
+ * ### `drawText` — мульти-нативная цепочка
+ *
+ * Стандартная GTA V последовательность:
+ *  1. `SET_TEXT_FONT/SCALE/COLOUR/OUTLINE/CENTRE` — стиль текста
+ *  2. `BEGIN_TEXT_COMMAND_DISPLAY_TEXT('STRING')` — открыть text command
+ *  3. `ADD_TEXT_COMPONENT_SUBSTRING_PLAYER_NAME(text)` — добавить содержимое
+ *  4. `END_TEXT_COMMAND_DISPLAY_TEXT(x, y, 0)` — отрисовать
+ *
+ * **Hot path:** вызывается каждый render-tick из `HudController.onRender`
+ * (ammo, nametags, etc). Все вызовы синхронны (V8-ops), общая стоимость —
+ * единицы микросекунд на текст.
+ *
+ * **Ограничение длины:** `ADD_TEXT_COMPONENT_SUBSTRING_PLAYER_NAME` усекает
+ * вход на 99 символов. Для типичных HUD-меток (ammo "30/120", имена игроков)
+ * не критично; для длинных строк нужно разбивать на чанки последовательными
+ * `ADD_*` вызовами. Сейчас не реализовано — добавим если понадобится.
+ *
+ * ### `world3dToScreen2d`
+ *
+ * `getScreenCoordFromWorldCoord` возвращает `{return, screenx, screeny}` —
+ * `return=false` означает, что точка вне frustum'а; маппим в `null` для
+ * совпадения с RageMP-семантикой.
+ *
+ * ### `getActiveScreenResolution`
+ *
+ * Маппится на `getActualScreenResolution` (GTA native `0x873C9F3104101DD3`),
+ * который возвращает физическое разрешение рендера — то же, что RageMP'шный
+ * `getActiveScreenResolution` (это один и тот же натив, переименованный по-
+ * разному в разных биндингах).
+ *
+ * ### `startScreenEffect` / `stopScreenEffect`
+ *
+ * Маппятся на `animpostfxPlay` / `animpostfxStop` (`ANIMPOSTFX_PLAY`/`STOP`) —
+ * это и есть GTA V натив для screen effect'ов (по-старому называвшийся
+ * `START_SCREEN_EFFECT`).
+ */
+export class CCMPGraphicsManager {
+    drawText(text, position, options) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+        const font = (_a = options === null || options === void 0 ? void 0 : options.font) !== null && _a !== void 0 ? _a : 0;
+        const [scaleX, scaleY] = (_b = options === null || options === void 0 ? void 0 : options.scale) !== null && _b !== void 0 ? _b : [0.3, 0.3];
+        const r = (_d = (_c = options === null || options === void 0 ? void 0 : options.color) === null || _c === void 0 ? void 0 : _c.r) !== null && _d !== void 0 ? _d : 255;
+        const g = (_f = (_e = options === null || options === void 0 ? void 0 : options.color) === null || _e === void 0 ? void 0 : _e.g) !== null && _f !== void 0 ? _f : 255;
+        const b = (_h = (_g = options === null || options === void 0 ? void 0 : options.color) === null || _g === void 0 ? void 0 : _g.b) !== null && _h !== void 0 ? _h : 255;
+        const a = (_k = (_j = options === null || options === void 0 ? void 0 : options.color) === null || _j === void 0 ? void 0 : _j.a) !== null && _k !== void 0 ? _k : 255;
+        const outline = (_l = options === null || options === void 0 ? void 0 : options.outline) !== null && _l !== void 0 ? _l : true;
+        const centre = (_m = options === null || options === void 0 ? void 0 : options.centre) !== null && _m !== void 0 ? _m : false;
+        const hud = ccmp.natives.hud;
+        hud.setTextFont(font);
+        // Натив `SET_TEXT_SCALE(scale, size)` — первый параметр обычно игнорируется,
+        // эффективный размер задаётся вторым. RageMP передаёт оба из массива
+        // `[scaleX, scaleY]` — повторяем тот же контракт.
+        hud.setTextScale(scaleX, scaleY);
+        hud.setTextColour(r, g, b, a);
+        if (outline) {
+            hud.setTextOutline();
+        }
+        if (centre) {
+            hud.setTextCentre(true);
+        }
+        hud.beginTextCommandDisplayText("STRING");
+        hud.addTextComponentSubstringPlayerName(text);
+        // p2 — `unk_const_0` (введён в b2699); 0 — стандартное значение.
+        hud.endTextCommandDisplayText(position.x, position.y, 0);
+    }
+    world3dToScreen2d(position) {
+        const result = ccmp.natives.graphics.getScreenCoordFromWorldCoord(position.x, position.y, position.z);
+        if (!result.return) {
+            // Точка вне frustum'а — RageMP в таком случае возвращает `null`.
+            return null;
+        }
+        return new Vector2D(result.screenx, result.screeny);
+    }
+    startScreenEffect(effectName, duration, looped) {
+        ccmp.natives.graphics.animpostfxPlay(effectName, duration, looped);
+    }
+    stopScreenEffect(effectName) {
+        ccmp.natives.graphics.animpostfxStop(effectName);
+    }
+    setPtfxAssetNextCall(assetName) {
+        ccmp.natives.graphics.useParticleFxAsset(assetName);
+    }
+    startParticleFxNonLoopedAtCoord(options) {
+        return ccmp.natives.graphics.startParticleFxNonLoopedAtCoord(options.effectName, options.position.x, options.position.y, options.position.z, options.rotation.x, options.rotation.y, options.rotation.z, options.scale, options.xAxis, options.yAxis, options.zAxis);
+    }
+    startParticleFxLoopedAtCoord(options) {
+        return ccmp.natives.graphics.startParticleFxLoopedAtCoord(options.effectName, options.position.x, options.position.y, options.position.z, options.rotation.x, options.rotation.y, options.rotation.z, options.scale, options.xAxis, options.yAxis, options.zAxis, options.p11);
+    }
+    stopParticleFxLooped(handle, p1) {
+        ccmp.natives.graphics.stopParticleFxLooped(handle, p1);
+    }
+    getSafeZoneSize() {
+        return ccmp.natives.graphics.getSafeZoneSize();
+    }
+    getActiveScreenResolution() {
+        // `getActualScreenResolution` (0x873C9F3104101DD3) === RageMP'шный
+        // `getActiveScreenResolution` — это один и тот же native под разными
+        // именами в разных биндингах.
+        const result = ccmp.natives.graphics.getActualScreenResolution();
+        return new Vector2D(result.x, result.y);
+    }
+}

package/dist/client/game/ccmp/gui/CCMPGuiManager.d.ts

@@ -0,0 +1,5 @@
+import { type IGuiManager } from "../../common/gui/IGuiManager";
+export declare class CCMPGuiManager implements IGuiManager {
+    private _warnedTakeScreenshot;
+    takeScreenshot(name: string, type: number, quality: number, compressionQuality: number): void;
+}

package/dist/client/game/ccmp/gui/CCMPGuiManager.js

@@ -0,0 +1,17 @@
+/// <reference types="@classic-mp/types/client" />
+export class CCMPGuiManager {
+    constructor() {
+        this._warnedTakeScreenshot = false;
+    }
+    takeScreenshot(name, type, quality, compressionQuality) {
+        void name;
+        void type;
+        void quality;
+        void compressionQuality;
+        if (this._warnedTakeScreenshot) {
+            return;
+        }
+        this._warnedTakeScreenshot = true;
+        console.warn("[CCMPGuiManager] takeScreenshot is not available in CCMP client JS.");
+    }
+}