rock-mod 0.20.0 → 0.22.0

package/dist/client/entities/ragemp/entity/RageEntity.js

@@ -5,8 +5,8 @@ export class RageEntity extends RageWorldObject {
         return this.mpEntity.model;
     }
     get rotation() {
-        const { x, y, z } = this.mpEntity.rotation;
-        return new Vector3D(x, y, z);
+        var _a, _b;
+        return (_b = (_a = this._getNativeRotation()) !== null && _a !== void 0 ? _a : this._getEntityRotationProperty()) !== null && _b !== void 0 ? _b : new Vector3D(0, 0, this.heading);
     }
     constructor(options) {
         super(options);
@@ -22,6 +22,9 @@ export class RageEntity extends RageWorldObject {
     }
     setRotation(value) {
         this.mpEntity.rotation = new mp.Vector3(value);
+        if (this._hasValidHandle()) {
+            mp.game.entity.setRotation(this.handle, value.x, value.y, value.z, 2, true);
+        }
     }
     get forwardVector() {
         const vector = this.mpEntity.getForwardVector();
@@ -65,6 +68,17 @@ export class RageEntity extends RageWorldObject {
     getVariable(name) {
         return this.mpEntity.getVariable(name);
     }
+    getSyncedMeta(key) {
+        const value = this.mpEntity.getVariable(key);
+        return value === null ? undefined : value;
+    }
+    hasSyncedMeta(key) {
+        return this.mpEntity.getVariable(key) !== null;
+    }
+    getSyncedMetaKeys() {
+        // RageMP не экспонирует список ключей синхронно — возвращаем пустой массив.
+        return [];
+    }
     attachToEntity(target, boneIndex, offset, rotation, p9, useSoftPinning, collision, isPed, vertexIndex, fixedRot) {
         mp.game.entity.attachToEntity(this.handle, target.handle, boneIndex, offset.x, offset.y, offset.z, rotation.x, rotation.y, rotation.z, p9, useSoftPinning, collision, isPed, vertexIndex, fixedRot);
     }
@@ -77,4 +91,33 @@ export class RageEntity extends RageWorldObject {
     isPlayingAnim(dictionary, name, taskFlag) {
         return mp.game.entity.isPlayingAnim(this.handle, dictionary, name, taskFlag);
     }
+    _getNativeRotation() {
+        if (!this._hasValidHandle())
+            return null;
+        try {
+            const rotation = mp.game.entity.getRotation(this.handle, 2);
+            if (!this._isVectorLike(rotation))
+                return null;
+            return new Vector3D(rotation.x, rotation.y, rotation.z);
+        }
+        catch (_a) {
+            return null;
+        }
+    }
+    _getEntityRotationProperty() {
+        const rotation = this.mpEntity.rotation;
+        if (!this._isVectorLike(rotation))
+            return null;
+        return new Vector3D(rotation.x, rotation.y, rotation.z);
+    }
+    _hasValidHandle() {
+        return typeof this.handle === "number" && this.handle > 0;
+    }
+    _isVectorLike(value) {
+        return (typeof value === "object" &&
+            value !== null &&
+            typeof value.x === "number" &&
+            typeof value.y === "number" &&
+            typeof value.z === "number");
+    }
 }

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

@@ -0,0 +1,48 @@
+import { type IManagersFactory } from "../common/IManagersFactory";
+type ManagerReturn<K extends keyof IManagersFactory> = IManagersFactory[K] extends (...args: never[]) => infer R ? R : never;
+export declare class CCMPManagersFactory implements IManagersFactory {
+    private _netManager;
+    private _blipsManager;
+    private _colshapesManager;
+    private _markersManager;
+    private _objectsManager;
+    private _pedsManager;
+    private _playersManager;
+    private _vehiclesManager;
+    private _syncedMetaBridgeRegistered;
+    createNetManager(): ManagerReturn<"createNetManager">;
+    private _requireNetManager;
+    private _registerSyncedMetaBridgeIfReady;
+    createBlipsManager(): ManagerReturn<"createBlipsManager">;
+    createColshapesManager(): ManagerReturn<"createColshapesManager">;
+    createMarkersManager(): ManagerReturn<"createMarkersManager">;
+    createObjectsManager(): ManagerReturn<"createObjectsManager">;
+    createPedsManager(): ManagerReturn<"createPedsManager">;
+    createPlayersManager(): ManagerReturn<"createPlayersManager">;
+    createUtilsManager(): ManagerReturn<"createUtilsManager">;
+    createVehiclesManager(): ManagerReturn<"createVehiclesManager">;
+    createBrowserManager(): ManagerReturn<"createBrowserManager">;
+    createChatManager(): ManagerReturn<"createChatManager">;
+    createCursorManager(): ManagerReturn<"createCursorManager">;
+    createGuiManager(): ManagerReturn<"createGuiManager">;
+    createRaycastingManager(): ManagerReturn<"createRaycastingManager">;
+    createVoiceChatManager(): ManagerReturn<"createVoiceChatManager">;
+    createCameraManager(): ManagerReturn<"createCameraManager">;
+    createStorageManager(): ManagerReturn<"createStorageManager">;
+    createGraphicsManager(): ManagerReturn<"createGraphicsManager">;
+    createNativeManager(): ManagerReturn<"createNativeManager">;
+    createStreamingManager(): ManagerReturn<"createStreamingManager">;
+    createLocalPlayerManager(): ManagerReturn<"createLocalPlayerManager">;
+    createControlsManager(): ManagerReturn<"createControlsManager">;
+    createKeysManager(): ManagerReturn<"createKeysManager">;
+    createGameplayManager(): ManagerReturn<"createGameplayManager">;
+    createGameCameraManager(): ManagerReturn<"createGameCameraManager">;
+    createUiManager(): ManagerReturn<"createUiManager">;
+    createNametagsManager(): ManagerReturn<"createNametagsManager">;
+    createPathfindManager(): ManagerReturn<"createPathfindManager">;
+    createZoneManager(): ManagerReturn<"createZoneManager">;
+    createWeaponManager(): ManagerReturn<"createWeaponManager">;
+    createGameObjectManager(): ManagerReturn<"createGameObjectManager">;
+    createConsoleManager(): ManagerReturn<"createConsoleManager">;
+}
+export {};

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

@@ -0,0 +1,189 @@
+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 { CCMPObjectsManager } from "../../entities/ccmp/object/CCMPObjectsManager";
+import { CCMPMarkersManager } from "../../entities/ccmp/marker/CCMPMarkersManager";
+import { CCMPBlipsManager } from "../../entities/ccmp/blip/CCMPBlipsManager";
+import { CCMPColshapesManager } from "../../entities/ccmp/colshape/CCMPColshapesManager";
+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() {
+        this._netManager = null;
+        this._blipsManager = null;
+        this._colshapesManager = null;
+        this._markersManager = null;
+        this._objectsManager = null;
+        this._pedsManager = null;
+        this._playersManager = null;
+        this._vehiclesManager = null;
+        this._syncedMetaBridgeRegistered = false;
+    }
+    createNetManager() {
+        this._netManager = new CCMPNetManager();
+        return this._netManager;
+    }
+    _requireNetManager(forMethod) {
+        if (!this._netManager) {
+            throw new Error(`CCMPManagersFactory.${forMethod}: ` +
+                "createNetManager() was not called yet. This violates RockMod manager factory order.");
+        }
+        return this._netManager;
+    }
+    _registerSyncedMetaBridgeIfReady() {
+        if (this._syncedMetaBridgeRegistered ||
+            !this._netManager ||
+            !this._blipsManager ||
+            !this._colshapesManager ||
+            !this._markersManager ||
+            !this._objectsManager ||
+            !this._pedsManager ||
+            !this._playersManager ||
+            !this._vehiclesManager) {
+            return;
+        }
+        new CCMPSyncedMetaBridge(this._netManager.events, {
+            blips: this._blipsManager,
+            colshapes: this._colshapesManager,
+            markers: this._markersManager,
+            objects: this._objectsManager,
+            peds: this._pedsManager,
+            players: this._playersManager,
+            vehicles: this._vehiclesManager,
+        }).register();
+        this._syncedMetaBridgeRegistered = true;
+    }
+    createBlipsManager() {
+        const netManager = this._requireNetManager("createBlipsManager");
+        this._blipsManager = new CCMPBlipsManager(netManager.events);
+        this._registerSyncedMetaBridgeIfReady();
+        return this._blipsManager;
+    }
+    createColshapesManager() {
+        const netManager = this._requireNetManager("createColshapesManager");
+        this._colshapesManager = new CCMPColshapesManager(netManager.events);
+        this._registerSyncedMetaBridgeIfReady();
+        return this._colshapesManager;
+    }
+    createMarkersManager() {
+        const netManager = this._requireNetManager("createMarkersManager");
+        this._markersManager = new CCMPMarkersManager(netManager.events);
+        this._registerSyncedMetaBridgeIfReady();
+        return this._markersManager;
+    }
+    createObjectsManager() {
+        const netManager = this._requireNetManager("createObjectsManager");
+        this._objectsManager = new CCMPObjectsManager(netManager.events);
+        this._registerSyncedMetaBridgeIfReady();
+        return this._objectsManager;
+    }
+    createPedsManager() {
+        const netManager = this._requireNetManager("createPedsManager");
+        this._pedsManager = new CCMPPedsManager(netManager.events);
+        this._registerSyncedMetaBridgeIfReady();
+        return this._pedsManager;
+    }
+    createPlayersManager() {
+        const netManager = this._requireNetManager("createPlayersManager");
+        this._playersManager = new CCMPPlayersManager(netManager.events);
+        this._registerSyncedMetaBridgeIfReady();
+        return this._playersManager;
+    }
+    createUtilsManager() {
+        return new CCMPUtilsManager();
+    }
+    createVehiclesManager() {
+        this._vehiclesManager = new CCMPVehiclesManager();
+        this._registerSyncedMetaBridgeIfReady();
+        return this._vehiclesManager;
+    }
+    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;
+    }
+}