rock-mod 0.21.0 → 0.23.0

package/dist/client/entities/ccmp/vehicle/CCMPVehicle.js

@@ -0,0 +1,311 @@
+import { BaseObjectType } from "../../../../shared/entities";
+import { Vector3D } from "../../../../shared/common/utils";
+export class CCMPVehicle {
+    constructor(_ccmpVehicle, _onDestroy = () => { }) {
+        this._ccmpVehicle = _ccmpVehicle;
+        this._onDestroy = _onDestroy;
+        this._destroyed = false;
+    }
+    get id() {
+        return this._ccmpVehicle.id;
+    }
+    get remoteId() {
+        return this._ccmpVehicle.remoteId;
+    }
+    get type() {
+        return BaseObjectType.Vehicle;
+    }
+    get isExists() {
+        if (this._destroyed)
+            return false;
+        if (this._ccmpVehicle.isRemote)
+            return this._getRemoteVehicleExists();
+        return this._ccmpVehicle.isExists;
+    }
+    get handle() {
+        return this._normalizeHandle(this._ccmpVehicle.handle);
+    }
+    destroy() {
+        if (this._destroyed)
+            return;
+        this._destroyed = true;
+        this._ccmpVehicle.destroy();
+        this._onDestroy(this);
+    }
+    get position() {
+        const { x, y, z } = this._ccmpVehicle.position;
+        return new Vector3D(x, y, z);
+    }
+    get dimension() {
+        return this._ccmpVehicle.dimension;
+    }
+    setPosition(value) {
+        this._ccmpVehicle.setPosition(value);
+    }
+    setDimension(value) {
+        this._ccmpVehicle.setDimension(value);
+    }
+    setCoords(xPos, yPos, zPos, xAxis, yAxis, zAxis, clearArea) {
+        this._ccmpVehicle.setCoords(xPos, yPos, zPos, xAxis, yAxis, zAxis, clearArea);
+    }
+    get model() {
+        return this._ccmpVehicle.model;
+    }
+    get heading() {
+        return this._ccmpVehicle.heading;
+    }
+    setHeading(heading) {
+        this._ccmpVehicle.setHeading(heading);
+    }
+    setModel(value) {
+        this._ccmpVehicle.setModel(value);
+    }
+    get rotation() {
+        const { x, y, z } = this._ccmpVehicle.rotation;
+        return new Vector3D(x, y, z);
+    }
+    get forwardVector() {
+        const { x, y, z } = this._ccmpVehicle.forwardVector;
+        return new Vector3D(x, y, z);
+    }
+    setRotation(value) {
+        this._ccmpVehicle.setRotation(value);
+    }
+    freezePosition(freeze) {
+        this._ccmpVehicle.freezePosition(freeze);
+    }
+    setCollision(collision, keepPhysics) {
+        this._ccmpVehicle.setCollision(collision, keepPhysics);
+    }
+    setInvincible(invincible) {
+        this._ccmpVehicle.setInvincible(invincible);
+    }
+    setVisible(visible) {
+        this._ccmpVehicle.setVisible(visible);
+    }
+    setAlpha(alpha) {
+        this._ccmpVehicle.setAlpha(alpha);
+    }
+    get alpha() {
+        return this._ccmpVehicle.alpha;
+    }
+    resetAlpha() {
+        this._ccmpVehicle.resetAlpha();
+    }
+    getOffsetFromInWorldCoords(offsetX, offsetY, offsetZ) {
+        const { x, y, z } = this._ccmpVehicle.getOffsetFromInWorldCoords(offsetX, offsetY, offsetZ);
+        return new Vector3D(x, y, z);
+    }
+    getBoneIndexByName(boneName) {
+        return this._ccmpVehicle.getBoneIndexByName(boneName);
+    }
+    getWorldPositionOfBone(boneIndex) {
+        const { x, y, z } = this._ccmpVehicle.getWorldPositionOfBone(boneIndex);
+        return new Vector3D(x, y, z);
+    }
+    getVariable(name) {
+        const remoteId = this.remoteId;
+        if (remoteId === null)
+            return null;
+        const value = ccmp.entities.getStreamSyncedMeta(ccmp.entities.ENTITY_TYPE.Vehicle, remoteId, name);
+        return value === undefined ? null : value;
+    }
+    getSyncedMeta(key) {
+        const remoteId = this.remoteId;
+        if (remoteId === null)
+            return undefined;
+        return ccmp.entities.getStreamSyncedMeta(ccmp.entities.ENTITY_TYPE.Vehicle, remoteId, key);
+    }
+    hasSyncedMeta(key) {
+        const remoteId = this.remoteId;
+        if (remoteId === null)
+            return false;
+        return ccmp.entities.hasStreamSyncedMeta(ccmp.entities.ENTITY_TYPE.Vehicle, remoteId, key);
+    }
+    getSyncedMetaKeys() {
+        const remoteId = this.remoteId;
+        if (remoteId === null)
+            return [];
+        return ccmp.entities.getStreamSyncedMetaKeys(ccmp.entities.ENTITY_TYPE.Vehicle, remoteId);
+    }
+    attachToEntity(target, boneIndex, offset, rotation, p9, useSoftPinning, collision, isPed, vertexIndex, fixedRot) {
+        this._ccmpVehicle.attachToEntity(target, boneIndex, offset, rotation, p9, useSoftPinning, collision, isPed, vertexIndex, fixedRot);
+    }
+    detach(useDetachVelocity, collision) {
+        this._ccmpVehicle.detach(useDetachVelocity, collision);
+    }
+    getSpeed() {
+        return this._ccmpVehicle.getSpeed();
+    }
+    isPlayingAnim(dictionary, name, taskFlag) {
+        return this._ccmpVehicle.isPlayingAnim(dictionary, name, taskFlag);
+    }
+    get bodyHealth() {
+        return this._ccmpVehicle.bodyHealth;
+    }
+    get engineHealth() {
+        return this._ccmpVehicle.engineHealth;
+    }
+    get numberPlate() {
+        return this._ccmpVehicle.numberPlate;
+    }
+    get isDead() {
+        return this._ccmpVehicle.isDead;
+    }
+    setBodyHealth(value) {
+        this._ccmpVehicle.setBodyHealth(value);
+    }
+    setEngineHealth(value) {
+        this._ccmpVehicle.setEngineHealth(value);
+    }
+    setNumberPlate(value) {
+        this._ccmpVehicle.setNumberPlate(value);
+    }
+    explode() {
+        this._ccmpVehicle.explode();
+    }
+    getPedInSeat(seat) {
+        return this._ccmpVehicle.getPedInSeat(seat);
+    }
+    setUndriveable(toggle) {
+        this._ccmpVehicle.setUndriveable(toggle);
+    }
+    get maxNumberOfPassengers() {
+        return this._ccmpVehicle.maxNumberOfPassengers;
+    }
+    get gear() {
+        return this._ccmpVehicle.gear;
+    }
+    get speed() {
+        return this._ccmpVehicle.speed;
+    }
+    get isEngineRunning() {
+        return this._ccmpVehicle.isEngineRunning;
+    }
+    setEngineOn(toggle, instantly, otherwise) {
+        this._ccmpVehicle.setEngineOn(toggle, instantly, otherwise);
+    }
+    get lightsState() {
+        return this._ccmpVehicle.lightsState;
+    }
+    get isLocked() {
+        return this._ccmpVehicle.isLocked;
+    }
+    setIsLocked(value) {
+        this._ccmpVehicle.setIsLocked(value);
+    }
+    setCustomPrimaryColour(color) {
+        this._ccmpVehicle.setCustomPrimaryColour(color);
+    }
+    setCustomSecondaryColour(color) {
+        this._ccmpVehicle.setCustomSecondaryColour(color);
+    }
+    get customPrimaryColour() {
+        return this._ccmpVehicle.customPrimaryColour;
+    }
+    get customSecondaryColour() {
+        return this._ccmpVehicle.customSecondaryColour;
+    }
+    setMod(modType, modIndex) {
+        this._ccmpVehicle.setMod(modType, modIndex);
+    }
+    getMod(modType) {
+        return this._ccmpVehicle.getMod(modType);
+    }
+    getNumMods(modType) {
+        return this._ccmpVehicle.getNumMods(modType);
+    }
+    setNeonLightEnabled(index, toggle) {
+        this._ccmpVehicle.setNeonLightEnabled(index, toggle);
+    }
+    setNeonLightsColour(color) {
+        this._ccmpVehicle.setNeonLightsColour(color);
+    }
+    setWindowTint(tintType) {
+        this._ccmpVehicle.setWindowTint(tintType);
+    }
+    get windowTint() {
+        return this._ccmpVehicle.windowTint;
+    }
+    setWheelType(wheelType) {
+        this._ccmpVehicle.setWheelType(wheelType);
+    }
+    get wheelType() {
+        return this._ccmpVehicle.wheelType;
+    }
+    setNumberPlateTextIndex(index) {
+        this._ccmpVehicle.setNumberPlateTextIndex(index);
+    }
+    get numberPlateTextIndex() {
+        return this._ccmpVehicle.numberPlateTextIndex;
+    }
+    setDoorOpen(doorIndex, loose, openInstantly) {
+        this._ccmpVehicle.setDoorOpen(doorIndex, loose, openInstantly);
+    }
+    setDoorShut(doorIndex, instantly) {
+        this._ccmpVehicle.setDoorShut(doorIndex, instantly);
+    }
+    setHandling(field, value) {
+        this._ccmpVehicle.setHandling(field, value);
+    }
+    getHandling(field) {
+        return this._ccmpVehicle.getHandling(field);
+    }
+    setEnginePowerMultiplier(value) {
+        this._ccmpVehicle.setEnginePowerMultiplier(value);
+    }
+    setEngineTorqueMultiplier(value) {
+        this._ccmpVehicle.setEngineTorqueMultiplier(value);
+    }
+    modifyTopSpeed(value) {
+        this._ccmpVehicle.modifyTopSpeed(value);
+    }
+    setCheatPowerIncrease(value) {
+        this._ccmpVehicle.setCheatPowerIncrease(value);
+    }
+    toggleMod(modType, toggle) {
+        this._ccmpVehicle.toggleMod(modType, toggle);
+    }
+    setTyreSmokeColor(r, g, b) {
+        this._ccmpVehicle.setTyreSmokeColor(r, g, b);
+    }
+    setModColor1(paintType, color, p3) {
+        this._ccmpVehicle.setModColor1(paintType, color, p3);
+    }
+    setExtraColours(pearlescentColor, wheelColor) {
+        this._ccmpVehicle.setExtraColours(pearlescentColor, wheelColor);
+    }
+    setHeadlightColor(colorIndex) {
+        this._ccmpVehicle.setHeadlightColor(colorIndex);
+    }
+    setDashboardColor(colorIndex) {
+        this._ccmpVehicle.setDashboardColor(colorIndex);
+    }
+    setInteriorColor(colorIndex) {
+        this._ccmpVehicle.setInteriorColor(colorIndex);
+    }
+    getMaxBraking() {
+        return this._ccmpVehicle.getMaxBraking();
+    }
+    getAcceleration() {
+        return this._ccmpVehicle.getAcceleration();
+    }
+    getMaxTraction() {
+        return this._ccmpVehicle.getMaxTraction();
+    }
+    getModelMaxSpeed() {
+        return this._ccmpVehicle.getModelMaxSpeed();
+    }
+    _normalizeHandle(value) {
+        const handle = Number(value);
+        return Number.isFinite(handle) && handle > 0 ? Math.trunc(handle) : 0;
+    }
+    _getRemoteVehicleExists() {
+        try {
+            return this._ccmpVehicle.isExists;
+        }
+        catch (_a) {
+            return true;
+        }
+    }
+}

package/dist/client/entities/ccmp/vehicle/CCMPVehiclesManager.d.ts

@@ -1,54 +1,11 @@
 import { type IVehicle } from "../../common/vehicle/IVehicle";
 import { type IVehicleCreateOptions, type IVehiclesManager } from "../../common/vehicle/IVehiclesManager";
 import { type IWorldObjectsIterator } from "../../common/worldObject/IWorldObjectsIterator";
-/**
- * Реализация `IVehiclesManager` под CCMP — **пустой пул** + native helper.
- *
- * ### Почему пусто
- *
- * RageMP даёт `mp.vehicles.toArray()`/`mp.vehicles.at(id)` — JS-side pool из
- * stream'нутых-в-радиус транспортных средств, заполняемый рантаймом. CCMP
- * такого пула на client-side не экспонирует:
- *  - `ccmp.natives.vehicle.createVehicle` создаёт локальный handle без id /
- *    replication / managed lifecycle.
- *  - `ccmp.vehicles.*` (server-side) спавнит реплицируемые vehicle-сущности,
- *    но клиент видит их данные через game state, а не как managed-IVehicle-
- *    инстансы в JS-pool'е.
- *
- * Поэтому iterator всегда пустой, `find*` возвращает null, `get*` и `deleteById` кидают.
- *
- * ### Hot path: `iterator.all()` на каждый render-tick
- *
- * Геймод-консьюмер `VehiclePartsInteractionController.syncVehicleProximity` →
- * `VehiclePartsInteractionService.syncState` → `VehicleService.getNearbyVehicles`
- * → `VehicleRepository.getNearby` → `VehicleRepository.getAll` → `iterator.all()`.
- * До этой реализации `VehiclesManager` был `createNotImplementedProxy`, и каждый
- * frame падал `CCMPVehiclesManager.iterator.all: not implemented yet`. Теперь
- * iterator возвращает пустой итератор — interaction-сервис тихо деградирует
- * (нет vehicles в радиусе → нет UI-хинтов / интеракций).
- *
- * ### `create(...)` под CCMP
- *
- * Не реализован осознанно: `VehicleRepository.create(...)` в геймоде ожидает
- * `IRockModVehicle` с id/remoteId/position/etc, а CCMP-натив `createVehicle`
- * возвращает только handle без id-mapping'а. Для корректной поддержки нужен
- * полноценный `CCMPVehicle`-класс и интеграция с server-side `ccmp.vehicles.*`
- * — отдельная задача. Сейчас бросаем понятную ошибку.
- *
- * ### `getDisplayNameFromVehicleModel`
- *
- * Этот метод **реализован** — натив `getDisplayNameFromVehicleModel`
- * (`0xB215AAC32D25D019`) экспонирован в `ccmp.natives.vehicle.*` и работает
- * без vehicle-pool'а (принимает только modelHash, возвращает GXT-ключ или
- * "CARNOTFOUND" для unknown-моделей).
- *
- * TODO: когда понадобится spawning vehicles из клиента (миссии, тестовые
- * объекты) — реализовать через `ccmp.natives.vehicle.createVehicle` + локальный
- * id-counter + `CCMPVehicle`-обёртку. Для синхронизированных vehicles нужна
- * server-side фабрика с `ccmp.vehicles.create` и net-events для распространения
- * id-mapping'а.
- */
 export declare class CCMPVehiclesManager implements IVehiclesManager {
+    private readonly _vehicles;
+    private readonly _vehiclesByRemoteId;
+    private readonly _iterator;
+    constructor();
     create(options: IVehicleCreateOptions): IVehicle;
     getDisplayNameFromVehicleModel(modelHash: number): string;
     syncWithMpPool(): void;
@@ -60,5 +17,11 @@ export declare class CCMPVehiclesManager implements IVehiclesManager {
     getByRemoteID(remoteId: number): IVehicle;
     deleteById(id: number): IVehicle;
     get iterator(): IWorldObjectsIterator<IVehicle>;
-    private readonly _iterator;
+    private _register;
+    private _unregister;
+    private _findRegistered;
+    private _registerLifecycleEvents;
+    private _filter;
+    private _pruneDestroyed;
+    private _getNativeVehiclesApi;
 }

package/dist/client/entities/ccmp/vehicle/CCMPVehiclesManager.js

@@ -1,105 +1,184 @@
 /// <reference types="@classic-mp/types/client" />
-const EMPTY_VEHICLES = [];
-/**
- * Реализация `IVehiclesManager` под CCMP — **пустой пул** + native helper.
- *
- * ### Почему пусто
- *
- * RageMP даёт `mp.vehicles.toArray()`/`mp.vehicles.at(id)` — JS-side pool из
- * stream'нутых-в-радиус транспортных средств, заполняемый рантаймом. CCMP
- * такого пула на client-side не экспонирует:
- *  - `ccmp.natives.vehicle.createVehicle` создаёт локальный handle без id /
- *    replication / managed lifecycle.
- *  - `ccmp.vehicles.*` (server-side) спавнит реплицируемые vehicle-сущности,
- *    но клиент видит их данные через game state, а не как managed-IVehicle-
- *    инстансы в JS-pool'е.
- *
- * Поэтому iterator всегда пустой, `find*` возвращает null, `get*` и `deleteById` кидают.
- *
- * ### Hot path: `iterator.all()` на каждый render-tick
- *
- * Геймод-консьюмер `VehiclePartsInteractionController.syncVehicleProximity` →
- * `VehiclePartsInteractionService.syncState` → `VehicleService.getNearbyVehicles`
- * → `VehicleRepository.getNearby` → `VehicleRepository.getAll` → `iterator.all()`.
- * До этой реализации `VehiclesManager` был `createNotImplementedProxy`, и каждый
- * frame падал `CCMPVehiclesManager.iterator.all: not implemented yet`. Теперь
- * iterator возвращает пустой итератор — interaction-сервис тихо деградирует
- * (нет vehicles в радиусе → нет UI-хинтов / интеракций).
- *
- * ### `create(...)` под CCMP
- *
- * Не реализован осознанно: `VehicleRepository.create(...)` в геймоде ожидает
- * `IRockModVehicle` с id/remoteId/position/etc, а CCMP-натив `createVehicle`
- * возвращает только handle без id-mapping'а. Для корректной поддержки нужен
- * полноценный `CCMPVehicle`-класс и интеграция с server-side `ccmp.vehicles.*`
- * — отдельная задача. Сейчас бросаем понятную ошибку.
- *
- * ### `getDisplayNameFromVehicleModel`
- *
- * Этот метод **реализован** — натив `getDisplayNameFromVehicleModel`
- * (`0xB215AAC32D25D019`) экспонирован в `ccmp.natives.vehicle.*` и работает
- * без vehicle-pool'а (принимает только modelHash, возвращает GXT-ключ или
- * "CARNOTFOUND" для unknown-моделей).
- *
- * TODO: когда понадобится spawning vehicles из клиента (миссии, тестовые
- * объекты) — реализовать через `ccmp.natives.vehicle.createVehicle` + локальный
- * id-counter + `CCMPVehicle`-обёртку. Для синхронизированных vehicles нужна
- * server-side фабрика с `ccmp.vehicles.create` и net-events для распространения
- * id-mapping'а.
- */
+import { RockMod } from "../../../RockMod";
+import { ClientInternalEventName } from "../../../net/common/events/types";
+import { CCMPVehicle } from "./CCMPVehicle";
 export class CCMPVehiclesManager {
     constructor() {
-        // -- IVehiclesManager -----------------------------------------------------
-        // Iterator реализован inline и возвращает пустые итераторы — hot path
-        // `VehiclePartsInteractionController.syncVehicleProximity` → `VehicleRepository.getNearby`
-        // теперь тихо деградирует вместо падения на каждом render-tick'е.
+        this._vehicles = new Map();
+        this._vehiclesByRemoteId = new Map();
         this._iterator = {
-            all: () => EMPTY_VEHICLES[Symbol.iterator](),
-            dimension: () => EMPTY_VEHICLES[Symbol.iterator](),
-            range2D: () => EMPTY_VEHICLES[Symbol.iterator](),
-            range3D: () => EMPTY_VEHICLES[Symbol.iterator](),
+            all: () => this._filter(() => true),
+            dimension: (value) => this._filter((vehicle) => vehicle.dimension === value),
+            range2D: (center, range) => this._filter((vehicle) => {
+                const position = vehicle.position;
+                const squaredDistance = (position.x - center.x) ** 2 + (position.y - center.y) ** 2;
+                return squaredDistance <= range * range;
+            }),
+            range3D: (center, range) => this._filter((vehicle) => vehicle.position.isInRange(center, range)),
         };
+        this._registerLifecycleEvents();
+        this.syncWithMpPool();
     }
     create(options) {
-        void options;
-        throw new Error("CCMPVehiclesManager.create: создание vehicles на client-side под CCMP не поддерживается. " +
-            "Используйте server-side `ccmp.vehicles.create` (см. server/entities/ccmp/vehicle/*), " +
-            "либо вызывайте `ccmp.natives.vehicle.createVehicle` напрямую для локального vehicle-handle.");
+        var _a;
+        const ccmpVehicle = (_a = this._getNativeVehiclesApi()) === null || _a === void 0 ? void 0 : _a.create(options.model, options.position, options.rotation, {
+            dimension: options.dimension,
+            engine: options.engine,
+            locked: options.locked,
+        });
+        if (!ccmpVehicle) {
+            throw new Error(`CCMPVehiclesManager.create: ccmp.vehicles.create failed for model "${options.model}"`);
+        }
+        return this._register(ccmpVehicle);
     }
     getDisplayNameFromVehicleModel(modelHash) {
-        return ccmp.natives.vehicle.getDisplayNameFromVehicleModel(modelHash);
+        var _a, _b;
+        return (_b = (_a = this._getNativeVehiclesApi()) === null || _a === void 0 ? void 0 : _a.getDisplayNameFromModel(modelHash)) !== null && _b !== void 0 ? _b : "";
     }
-    // -- IEntitiesManager -----------------------------------------------------
     syncWithMpPool() {
-        // No-op: client-side vehicle pool под CCMP отсутствует, синхронизировать нечего.
+        this._pruneDestroyed();
+        const ccmpVehicles = this._getNativeVehiclesApi();
+        if (!ccmpVehicles)
+            return;
+        for (const ccmpVehicle of ccmpVehicles.all) {
+            this._register(ccmpVehicle);
+        }
     }
     registerById(id) {
-        throw new Error(`CCMPVehiclesManager.registerById(${id}): client-side vehicle pool под CCMP отсутствует, ` +
-            "регистрировать vehicle по id невозможно.");
+        var _a, _b;
+        const existingVehicle = this.findByID(id);
+        if (existingVehicle)
+            return existingVehicle;
+        const ccmpVehicle = (_b = (_a = this._getNativeVehiclesApi()) === null || _a === void 0 ? void 0 : _a.getById(id)) !== null && _b !== void 0 ? _b : null;
+        if (!ccmpVehicle) {
+            throw new Error(`CCMPVehiclesManager.registerById(${id}): vehicle not found.`);
+        }
+        return this._register(ccmpVehicle);
     }
     unregisterById(id) {
-        throw new Error(`CCMPVehiclesManager.unregisterById(${id}): client-side vehicle pool под CCMP отсутствует, ` +
-            "разрегистрировать vehicle по id невозможно.");
+        return this.deleteById(id);
     }
-    // -- IBaseObjectsManager / IWorldObjectsManager ---------------------------
     findByID(id) {
-        void id;
-        return null;
+        var _a, _b, _c;
+        const vehicle = (_a = this._vehicles.get(id)) !== null && _a !== void 0 ? _a : null;
+        if (vehicle && vehicle.isExists)
+            return vehicle;
+        if (vehicle)
+            this._unregister(vehicle);
+        const ccmpVehicle = (_c = (_b = this._getNativeVehiclesApi()) === null || _b === void 0 ? void 0 : _b.getById(id)) !== null && _c !== void 0 ? _c : null;
+        if (!ccmpVehicle)
+            return null;
+        return this._register(ccmpVehicle);
     }
     getByID(id) {
-        throw new Error(`CCMPVehiclesManager.getByID(${id}): vehicle не найден (пул пуст под CCMP).`);
+        const vehicle = this.findByID(id);
+        if (!vehicle) {
+            throw new Error(`CCMPVehiclesManager.getByID(${id}): vehicle not found.`);
+        }
+        return vehicle;
     }
     findByRemoteID(remoteId) {
-        void remoteId;
-        return null;
+        var _a, _b, _c;
+        const vehicle = (_a = this._vehiclesByRemoteId.get(remoteId)) !== null && _a !== void 0 ? _a : null;
+        if (vehicle && vehicle.isExists)
+            return vehicle;
+        if (vehicle)
+            this._unregister(vehicle);
+        const ccmpVehicle = (_c = (_b = this._getNativeVehiclesApi()) === null || _b === void 0 ? void 0 : _b.getByRemoteId(remoteId)) !== null && _c !== void 0 ? _c : null;
+        if (!ccmpVehicle)
+            return null;
+        return this._register(ccmpVehicle);
     }
     getByRemoteID(remoteId) {
-        throw new Error(`CCMPVehiclesManager.getByRemoteID(${remoteId}): vehicle не найден (пул пуст под CCMP).`);
+        const vehicle = this.findByRemoteID(remoteId);
+        if (!vehicle) {
+            throw new Error(`CCMPVehiclesManager.getByRemoteID(${remoteId}): vehicle not found.`);
+        }
+        return vehicle;
     }
     deleteById(id) {
-        throw new Error(`CCMPVehiclesManager.deleteById(${id}): vehicle не найден (пул пуст под CCMP).`);
+        const vehicle = this.getByID(id);
+        vehicle.destroy();
+        return vehicle;
     }
     get iterator() {
         return this._iterator;
     }
+    _register(ccmpVehicle) {
+        const existingVehicle = this._findRegistered(ccmpVehicle);
+        if (existingVehicle && existingVehicle.isExists)
+            return existingVehicle;
+        if (existingVehicle)
+            this._unregister(existingVehicle);
+        const vehicle = new CCMPVehicle(ccmpVehicle, (destroyedVehicle) => {
+            this._unregister(destroyedVehicle);
+        });
+        this._vehicles.set(vehicle.id, vehicle);
+        if (vehicle.remoteId !== null) {
+            this._vehiclesByRemoteId.set(vehicle.remoteId, vehicle);
+        }
+        return vehicle;
+    }
+    _unregister(vehicle) {
+        this._vehicles.delete(vehicle.id);
+        if (vehicle.remoteId !== null) {
+            this._vehiclesByRemoteId.delete(vehicle.remoteId);
+        }
+    }
+    _findRegistered(ccmpVehicle) {
+        var _a, _b, _c;
+        return ((_c = (_b = (ccmpVehicle.remoteId === null ? null : ((_a = this._vehiclesByRemoteId.get(ccmpVehicle.remoteId)) !== null && _a !== void 0 ? _a : null))) !== null && _b !== void 0 ? _b : this._vehicles.get(ccmpVehicle.id)) !== null && _c !== void 0 ? _c : null);
+    }
+    _registerLifecycleEvents() {
+        const eventsApi = ccmp;
+        eventsApi.on("vehicleCreated", (ccmpVehicle) => {
+            if (!ccmpVehicle)
+                return;
+            const vehicle = this._register(ccmpVehicle);
+            RockMod.instance.net.events.emitInternal(ClientInternalEventName.EntityCreated, vehicle);
+        });
+        eventsApi.on("vehicleDestroyed", (ccmpVehicle) => {
+            var _a;
+            if (!ccmpVehicle)
+                return;
+            const vehicle = (_a = this._findRegistered(ccmpVehicle)) !== null && _a !== void 0 ? _a : this._register(ccmpVehicle);
+            RockMod.instance.net.events.emitInternal(ClientInternalEventName.EntityDestroyed, vehicle);
+            this._unregister(vehicle);
+        });
+        eventsApi.on("vehicleStreamIn", (ccmpVehicle) => {
+            if (!ccmpVehicle)
+                return;
+            const vehicle = this._register(ccmpVehicle);
+            RockMod.instance.net.events.emitInternal(ClientInternalEventName.EntityStreamIn, vehicle);
+        });
+        eventsApi.on("vehicleStreamOut", (ccmpVehicle) => {
+            var _a;
+            if (!ccmpVehicle)
+                return;
+            const vehicle = (_a = this._findRegistered(ccmpVehicle)) !== null && _a !== void 0 ? _a : this._register(ccmpVehicle);
+            RockMod.instance.net.events.emitInternal(ClientInternalEventName.EntityStreamOut, vehicle);
+        });
+    }
+    *_filter(predicate) {
+        for (const vehicle of this._vehicles.values()) {
+            if (!vehicle.isExists) {
+                this._unregister(vehicle);
+                continue;
+            }
+            if (predicate(vehicle)) {
+                yield vehicle;
+            }
+        }
+    }
+    _pruneDestroyed() {
+        for (const vehicle of this._vehicles.values()) {
+            if (!vehicle.isExists) {
+                this._unregister(vehicle);
+            }
+        }
+    }
+    _getNativeVehiclesApi() {
+        var _a;
+        return (_a = ccmp.vehicles) !== null && _a !== void 0 ? _a : null;
+    }
 }

package/dist/client/entities/common/baseObject/IBaseObject.d.ts

@@ -5,7 +5,8 @@ export interface IBaseObjectOptions {
 }
 export interface IBaseObject {
     get id(): number;
-    get remoteId(): number;
+    /** Server/network id for remote objects; null for client-only objects. */
+    get remoteId(): number | null;
     get type(): BaseObjectType;
     get isExists(): boolean;
     get handle(): number;

package/dist/client/entities/ragemp/entity/RageEntity.d.ts

@@ -31,4 +31,8 @@ export declare abstract class RageEntity<T extends EntityMp> extends RageWorldOb
     detach(useDetachVelocity: boolean, collision: boolean): void;
     getSpeed(): number;
     isPlayingAnim(dictionary: string, name: string, taskFlag: number): boolean;
+    private _getNativeRotation;
+    private _getEntityRotationProperty;
+    private _hasValidHandle;
+    private _isVectorLike;
 }