@nativewrappers/fivem 0.0.42 → 0.0.44

package/common/utils/Vector.js

@@ -1,546 +0,0 @@
-// Adapted from https://raw.githubusercontent.com/you21979/typescript-vector/master/vector3.ts
-import { ClassTypes } from './ClassTypes';
-/**
- * A base vector class inherited by all vector classes.
- */
-export class Vector {
-    /**
-     * Creates a new vector based on the provided parameters.
-     * @param x The x-component of the vector.
-     * @param y The y-component of the vector (optional, defaults to the value of x).
-     * @param z The z-component of the vector (optional, defaults to the value of y).
-     * @param w The w-component of the vector (optional, defaults to the value of z).
-     * @returns A new vector instance.
-     */
-    static create(x, y, z, w) {
-        if (y === undefined && typeof x === 'number')
-            return new Vector2(x, x);
-        if (typeof x === 'object')
-            ({ x, y, z, w } = x);
-        const size = this instanceof Vector ? this.size : [x, y, z, w].filter(arg => arg !== undefined).length;
-        switch (size) {
-            default:
-            case 2:
-                return new Vector2(x, y);
-            case 3:
-                return new Vector3(x, y, z);
-            case 4:
-                return new Vector4(x, y, z, w);
-        }
-    }
-    /**
-     * Creates a vector from binary data in a MsgpackBuffer.
-     * @param msgpackBuffer The buffer containing binary data.
-     * @returns A new vector instance.
-     */
-    static fromBuffer({ buffer }) {
-        const arr = [];
-        for (let offset = 0; offset < buffer.length; offset += 4)
-            arr.push(buffer.readFloatLE(offset));
-        return this.fromArray(arr);
-    }
-    /**
-     * Creates a deep copy of the provided vector.
-     * @param obj The vector to clone.
-     * @returns A new vector instance that is a copy of the provided vector.
-     */
-    static clone(obj) {
-        return this.create(obj);
-    }
-    /**
-     * Performs an operation between a vector and either another vector or scalar value.
-     * @param a - The first vector.
-     * @param b - The second vector or scalar value.
-     * @param operator - The function defining the operation to perform.
-     * @returns A new vector resulting from the operation.
-     */
-    static operate(a, b, operator) {
-        let { x, y, z, w } = a;
-        const isNumber = typeof b === 'number';
-        x = operator(x, isNumber ? b : (b.x ?? 0));
-        y = operator(y, isNumber ? b : (b.y ?? 0));
-        if (z !== undefined)
-            z = operator(z, isNumber ? b : (b.z ?? 0));
-        if (w !== undefined)
-            w = operator(w, isNumber ? b : (b.w ?? 0));
-        return this.create(x, y, z, w);
-    }
-    /**
-     * Adds two vectors or a scalar value to a vector.
-     * @param a - The first vector or scalar value.
-     * @param b - The second vector or scalar value.
-     * @returns A new vector with incremented components.
-     */
-    static add(a, b) {
-        return this.operate(a, b, (x, y) => x + y);
-    }
-    /**
-     * Adds a scalar value to the x-component of a vector.
-     * @param obj - The vector.
-     * @param x - The value to add to the x-component.
-     * @returns A new vector with the x-component incremented.
-     */
-    static addX(obj, x) {
-        const vec = this.clone(obj);
-        vec.x += x;
-        return vec;
-    }
-    /**
-     * Adds a scalar value to the y-component of a vector.
-     * @param obj - The vector.
-     * @param y - The value to add to the y-component.
-     * @returns A new vector with the y-component incremented.
-     */
-    static addY(obj, y) {
-        const vec = this.clone(obj);
-        vec.y += y;
-        return vec;
-    }
-    /**
-     * Adds a scalar value to the z-component of a vector.
-     * @param obj - The vector.
-     * @param z - The value to add to the z-component.
-     * @returns A new vector with the z-component incremented.
-     */
-    static addZ(obj, z) {
-        const vec = this.clone(obj);
-        vec.z += z;
-        return vec;
-    }
-    /**
-     * Adds a scalar value to the w-component of a vector.
-     * @param obj - The vector.
-     * @param w - The value to add to the w-component.
-     * @returns A new vector with the w-component incremented.
-     */
-    static addW(obj, w) {
-        const vec = this.clone(obj);
-        vec.w += w;
-        return vec;
-    }
-    /**
-     * Subtracts one vector from another or subtracts a scalar value from a vector.
-     * @param a - The vector.
-     * @param b - The second vector or scalar value.
-     * @returns A new vector with subtracted components.
-     */
-    static subtract(a, b) {
-        return this.operate(a, b, (x, y) => x - y);
-    }
-    /**
-     * Multiplies two vectors by their components, or multiplies a vector by a scalar value.
-     * @param a - The vector.
-     * @param b - The second vector or scalar value.
-     * @returns A new vector with multiplied components.
-     */
-    static multiply(a, b) {
-        return this.operate(a, b, (x, y) => x * y);
-    }
-    /**
-     * Divides two vectors by their components, or divides a vector by a scalar value.
-     * @param a - The vector.
-     * @param b - The second vector or scalar vector.
-     * @returns A new vector with divided components.
-     */
-    static divide(a, b) {
-        return this.operate(a, b, (x, y) => x / y);
-    }
-    /**
-     * Performs an operation between a vector and either another vector or scalar value converting the vector into absolute values.
-     * @param a - The first vector.
-     * @param b - The second vector or scalar value.
-     * @param operator - The function defining the operation to perform.
-     * @returns A new vector resulting from the operation.
-     */
-    static operateAbsolute(a, b, operator) {
-        let { x, y, z, w } = a;
-        const isNumber = typeof b === 'number';
-        x = operator(Math.abs(x), isNumber ? b : Math.abs(b.x ?? 0));
-        y = operator(Math.abs(y), isNumber ? b : Math.abs(b.y ?? 0));
-        if (z !== undefined)
-            z = operator(Math.abs(z), isNumber ? b : Math.abs(b.z ?? 0));
-        if (w !== undefined)
-            w = operator(Math.abs(w), isNumber ? b : Math.abs(b.w ?? 0));
-        return this.create(x, y, z, w);
-    }
-    /**
-     * Adds two vectors or a scalar value to a vector.
-     * @param a - The first vector or scalar value.
-     * @param b - The second vector or scalar value.
-     * @returns A new vector with incremented components.
-     */
-    static addAbsolute(a, b) {
-        return this.operateAbsolute(a, b, (x, y) => x + y);
-    }
-    /**
-     * Subtracts one vector from another or subtracts a scalar value from a vector.
-     * @param a - The vector.
-     * @param b - The second vector or scalar value.
-     * @returns A new vector with subtracted components.
-     */
-    static subtractAbsolute(a, b) {
-        return this.operateAbsolute(a, b, (x, y) => x - y);
-    }
-    /**
-     * Multiplies two vectors by their components, or multiplies a vector by a scalar value.
-     * @param a - The vector.
-     * @param b - The second vector or scalar value.
-     * @returns A new vector with multiplied components.
-     */
-    static multiplyAbsolute(a, b) {
-        return this.operateAbsolute(a, b, (x, y) => x * y);
-    }
-    /**
-     * Divides two vectors by their components, or divides a vector by a scalar value
-     * @param a - The vector.
-     * @param b - The second vector or scalar vector.
-     * @returns A new vector with divided components.
-     */
-    static divideAbsolute(a, b) {
-        return this.operateAbsolute(a, b, (x, y) => x / y);
-    }
-    /**
-     * Calculates the dot product of two vectors.
-     * @param a - The first vector.
-     * @param b - The second vector.
-     * @returns A scalar value representing the degree of alignment between the input vectors.
-     */
-    static dotProduct(a, b) {
-        let result = 0;
-        for (const key of ['x', 'y', 'z', 'w']) {
-            const x = a[key];
-            const y = b[key];
-            if (!!x && !!y)
-                result += x * y;
-            else if (x || y)
-                throw new Error('Vectors must have the same dimensions');
-        }
-        return result;
-    }
-    /**
-     * Calculates the cross product of two vectors in three-dimensional space.
-     * @param a - The first vector.
-     * @param b - The second vector.
-     * @returns A new vector perpendicular to both input vectors.
-     */
-    static crossProduct(a, b) {
-        const { x: ax, y: ay, z: az, w: aw } = a;
-        const { x: bx, y: by, z: bz } = b;
-        if (ax === undefined ||
-            ay === undefined ||
-            az === undefined ||
-            bx === undefined ||
-            by === undefined ||
-            bz === undefined)
-            throw new Error('Vector.crossProduct requires two three-dimensional vectors.');
-        return this.create(ay * bz - az * by, az * bx - ax * bz, ax * by - ay * bx, aw);
-    }
-    /**
-     * Normalizes a vector, producing a new vector with the same direction but with a magnitude of 1.
-     * @param vector - The vector to be normalized.
-     * @returns The new normalized vector.
-     */
-    static normalize(a) {
-        const length = a instanceof Vector ? a.Length : this.Length(a);
-        return this.divide(a, length);
-    }
-    /**
-     * Creates a vector from an array of numbers.
-     * @param primitive An array of numbers (usually returned by a native).
-     */
-    static fromArray(primitive) {
-        const [x, y, z, w] = primitive;
-        return this.create(x, y, z, w);
-    }
-    /**
-     * Creates a vector from an array or object containing vector components.
-     * @param primitive The object to use as a vector.
-     */
-    static fromObject(primitive) {
-        if (Array.isArray(primitive))
-            return this.fromArray(primitive);
-        if ('buffer' in primitive && 'type' in primitive)
-            return this.fromBuffer(primitive);
-        const { x, y, z, w } = primitive;
-        return this.create(x, y, z, w);
-    }
-    /**
-     * Creates an array of vectors from an array of number arrays
-     * @param primitives A multi-dimensional array of number arrays
-     */
-    static fromArrays(primitives) {
-        return primitives.map(this.fromArray);
-    }
-    /**
-     * Calculates the length (magnitude) of a vector.
-     * @param obj - The vector for which to calculate the length.
-     * @returns The magnitude of the vector.
-     */
-    static Length(obj) {
-        let sum = 0;
-        for (const key of ['x', 'y', 'z', 'w']) {
-            if (key in obj) {
-                const value = obj[key];
-                sum += value * value;
-            }
-        }
-        return Math.sqrt(sum);
-    }
-    /**
-     * Constructs a new vector.
-     * @param size The size of the vector (number of components).
-     * @param x The x-component of the vector.
-     * @param y The y-component of the vector (optional, defaults to x).
-     * @param z The z-component of the vector (optional).
-     * @param w The w-component of the vector (optional).
-     */
-    constructor(size, x = 0, y = x, z, w) {
-        this.size = size;
-        this.x = x;
-        this.y = y;
-        this.z = z;
-        this.w = w;
-        // DO NOT USE, ONLY EXPOSED BECAUSE TS IS TRASH, THIS TYPE IS NOT GUARANTEED
-        // TO EXIST
-        this.type = ClassTypes.Vector2;
-    }
-    *[Symbol.iterator]() {
-        yield this.x;
-        yield this.y;
-        if (this.z !== undefined)
-            yield this.z;
-        if (this.w !== undefined)
-            yield this.w;
-    }
-    toString() {
-        return `vector${this.size}(${this.toArray().join(', ')})`;
-    }
-    /**
-     * @see Vector.clone
-     */
-    clone() {
-        return Vector.clone(this);
-    }
-    /**
-     * The product of the Euclidean magnitudes of this and another Vector.
-     *
-     * @param v Vector to find Euclidean magnitude between.
-     * @returns Euclidean magnitude with another vector.
-     */
-    distanceSquared(v) {
-        const w = this.subtract(v);
-        return Vector.dotProduct(w, w);
-    }
-    /**
-     * The distance between two Vectors.
-     *
-     * @param v Vector to find distance between.
-     * @returns Distance between this and another vector.
-     */
-    distance(v) {
-        return Math.sqrt(this.distanceSquared(v));
-    }
-    /**
-     * @see Vector.normalize
-     */
-    normalize() {
-        return Vector.normalize(this);
-    }
-    /**
-     * @see Vector.dotProduct
-     */
-    dotProduct(v) {
-        return Vector.dotProduct(this, v);
-    }
-    /**
-     * @see Vector.add
-     */
-    add(v) {
-        return Vector.add(this, v);
-    }
-    /**
-     * @see Vector.addX
-     */
-    addX(x) {
-        return Vector.addX(this, x);
-    }
-    /**
-     * @see Vector.addY
-     */
-    addY(y) {
-        return Vector.addY(this, y);
-    }
-    /**
-     * @see Vector.subtract
-     */
-    subtract(v) {
-        return Vector.subtract(this, v);
-    }
-    /**
-     * @see Vector.multiply
-     */
-    multiply(v) {
-        return Vector.multiply(this, v);
-    }
-    /**
-     * @see Vector.divide
-     */
-    divide(v) {
-        return Vector.divide(this, v);
-    }
-    /**
-     * @see Vector.addAbsolute
-     */
-    addAbsolute(v) {
-        return Vector.addAbsolute(this, v);
-    }
-    /**
-     * @see Vector.subtractAbsolute
-     */
-    subtractAbsolute(v) {
-        return Vector.subtractAbsolute(this, v);
-    }
-    /**
-     * @see Vector.multiply
-     */
-    multiplyAbsolute(v) {
-        return Vector.multiplyAbsolute(this, v);
-    }
-    /**
-     * @see Vector.divide
-     */
-    divideAbsolute(v) {
-        return Vector.divideAbsolute(this, v);
-    }
-    /**
-     * Converts the vector to an array of its components.
-     */
-    toArray() {
-        return [...this];
-    }
-    /**
-     * Replaces the components of the vector with the components of another vector object.
-     * @param v - The object whose components will replace the current vector's components.
-     */
-    replace(v) {
-        for (const key of ['x', 'y', 'z', 'w']) {
-            if (key in this && key in v)
-                this[key] = v[key];
-        }
-    }
-    /**
-     * Calculates the length (magnitude) of a vector.
-     * @returns The magnitude of the vector.
-     */
-    get Length() {
-        let sum = 0;
-        for (let value of this)
-            sum += value * value;
-        return Math.sqrt(sum);
-    }
-}
-/**
- * Represents a 2-dimensional vector.
- */
-export class Vector2 extends Vector {
-    /**
-     * Constructs a new 2D vector.
-     * @param x The x-component of the vector.
-     * @param y The y-component of the vector (optional, defaults to x).
-     */
-    constructor(x, y = x) {
-        super(2, x, y);
-        // DO NOT USE, ONLY EXPOSED BECAUSE TS IS TRASH, THIS TYPE IS NOT GUARANTEED
-        // TO EXIST, CHANGING IT WILL BREAK STUFF
-        this.type = ClassTypes.Vector2;
-    }
-}
-Vector2.Zero = new Vector2(0, 0);
-/**
- * Represents a 3-dimensional vector.
- */
-export class Vector3 extends Vector {
-    /**
-     * Constructs a new 3D vector.
-     * @param x The x-component of the vector.
-     * @param y The y-component of the vector (optional, defaults to x).
-     * @param z The z-component of the vector (optional, defaults to y).
-     */
-    constructor(x, y = x, z = y) {
-        super(3, x, y, z);
-        // DO NOT USE, ONLY EXPOSED BECAUSE TS IS TRASH, THIS TYPE IS NOT GUARANTEED
-        // TO EXIST, CHANGING IT WILL BREAK STUFF
-        this.type = ClassTypes.Vector3;
-        this.z = z;
-    }
-    /**
-     * @see Vector.addZ
-     */
-    addZ(z) {
-        return Vector.addZ(this, z);
-    }
-    /**
-     * @see Vector.crossProduct
-     */
-    crossProduct(v) {
-        return Vector.crossProduct(this, v);
-    }
-    /**
-     * @returns the x and y values as Vec2
-     */
-    toVec2() {
-        return new Vector2(this.x, this.y);
-    }
-}
-Vector3.Zero = new Vector3(0, 0, 0);
-/**
- * Represents a 4-dimensional vector.
- */
-export class Vector4 extends Vector {
-    /**
-     * Constructs a new 4D vector.
-     * @param x The x-component of the vector.
-     * @param y The y-component of the vector (optional, defaults to x).
-     * @param z The z-component of the vector (optional, defaults to y).
-     * @param w The w-component of the vector (optional, defaults to z).
-     */
-    constructor(x, y = x, z = y, w = z) {
-        super(4, x, y, z, w);
-        // DO NOT USE, ONLY EXPOSED BECAUSE TS IS TRASH, THIS TYPE IS NOT GUARANTEED
-        // TO EXIST, CHANGING IT WILL BREAK STUFF
-        this.type = ClassTypes.Vector4;
-        this.z = z;
-        this.w = w;
-    }
-    /**
-     * @see Vector.addZ
-     */
-    addZ(z) {
-        return Vector.addZ(this, z);
-    }
-    /**
-     * @see Vector.addW
-     */
-    addW(w) {
-        return Vector.addW(this, w);
-    }
-    /**
-     * @see Vector.crossProduct
-     */
-    crossProduct(v) {
-        return Vector.crossProduct(this, v);
-    }
-    /**
-     * @returns the x and y values as Vec2
-     */
-    toVec2() {
-        return new Vector2(this.x, this.y);
-    }
-    /**
-     * @returns the x and y values as Vec3
-     */
-    toVec3() {
-        return new Vector3(this.x, this.y, this.z);
-    }
-}
-Vector4.Zero = new Vector4(0, 0, 0, 0);

package/common/utils/Vector2.d.ts

@@ -1 +0,0 @@
-export { Vector2 } from './Vector';

package/common/utils/Vector2.js

@@ -1 +0,0 @@
-export { Vector2 } from './Vector';

package/common/utils/Vector3.d.ts

@@ -1 +0,0 @@
-export { Vector3 } from './Vector';

package/common/utils/Vector3.js

@@ -1 +0,0 @@
-export { Vector3 } from './Vector';

package/common/utils/Vector4.d.ts

@@ -1 +0,0 @@
-export { Vector4 } from './Vector';

package/common/utils/Vector4.js

@@ -1 +0,0 @@
-export { Vector4 } from './Vector';

package/common/utils/cleanPlayerName.d.ts

@@ -1,6 +0,0 @@
-/**
- * Cleans up a player name and returns one version to be displayed, and one pure version to be used for fuzzy matching.
- * In case the name has no ascii characters, the pure name will be "empty name".
- * NOTE: this is not perfect, but took me two hours to arrive to this point.
- */
-export declare const cleanPlayerName: (original: string) => string;

package/common/utils/cleanPlayerName.js

@@ -1,27 +0,0 @@
-/* eslint-disable */
-// Spooky shit happens in here, don't let eslint get angry
-// Shamlessly ripped from txAdmin, MIT license
-/**
- * Cleans up a player name and returns one version to be displayed, and one pure version to be used for fuzzy matching.
- * In case the name has no ascii characters, the pure name will be "empty name".
- * NOTE: this is not perfect, but took me two hours to arrive to this point.
- */
-export const cleanPlayerName = (original) => {
-    // \u0000-\u001F > C0 controls
-    // \u007F-\u009F > delete + C1 controls
-    // \u200B-\u200D\uFEFF > zero width spaces
-    // \u200E > RTL mark
-    // \uA9C1-\uA9C5 > javanese text adornation (oversized)
-    // \u239B-\u23AD > Miscellaneous Technical — Bracket pieces items (oversized)
-    let displayName = original
-        .substring(0, 75) //lua should have truncated it first, but double checking
-        .replace(/[\u0000-\u001F\u007F-\u009F\u200B-\u200D\uFEFF\u200E\uA9C1-\uA9C5\u239B-\u23AD]/g, '')
-        .replace(/~(HUD_\S+|HC_\S+|[a-z]|[a1]_\d+|bold|italic|ws|wanted_star|nrt|EX_R\*|BLIP_\S+|ACCEPT|CANCEL|PAD_\S+|INPUT_\S+|INPUTGROUP_\S+)~/gi, '') // https://docs.fivem.net/docs/game-references/text-formatting/
-        .replace(/\^\d/gi, '') //console color codes
-        .replace(/\p{Mark}{2,}/gu, '') //2+ consecutive marks (zalgo text)
-        .replace(/\s+/g, ' ')
-        .trim();
-    if (!displayName.length)
-        displayName = 'empty name';
-    return displayName;
-};

package/common/utils/enumValues.d.ts

@@ -1,12 +0,0 @@
-/**
- * EnumValues - iterate over enum values
- * Just copy&paste from https://github.com/microsoft/TypeScript/issues/4753#issuecomment-694557208
- *
- * @param enumObj
- */
-export declare function enumValues<T extends string>(enumObj: {
-    [key: string]: T;
-}): IterableIterator<T>;
-export declare function enumValues<T extends string | number>(enumObj: {
-    [key: string]: T;
-}): IterableIterator<Exclude<T, string>>;

package/common/utils/enumValues.js

@@ -1,14 +0,0 @@
-export function* enumValues(enumObj) {
-    let isStringEnum = true;
-    for (const property in enumObj) {
-        if (typeof enumObj[property] === 'number') {
-            isStringEnum = false;
-            break;
-        }
-    }
-    for (const property in enumObj) {
-        if (isStringEnum || typeof enumObj[property] === 'number') {
-            yield enumObj[property];
-        }
-    }
-}

package/common/utils/getStringFromUInt8Array.d.ts

@@ -1,8 +0,0 @@
-/**
- * get string from uint8 array
- *
- * @param buffer - Uint8Array
- * @param start - The beginning of the specified portion of the array
- * @param end - The end of the specified portion of the array
- */
-export declare const getStringFromUInt8Array: (buffer: Uint8Array, start: number, end: number) => string;

package/common/utils/getStringFromUInt8Array.js

@@ -1,10 +0,0 @@
-/**
- * get string from uint8 array
- *
- * @param buffer - Uint8Array
- * @param start - The beginning of the specified portion of the array
- * @param end - The end of the specified portion of the array
- */
-export const getStringFromUInt8Array = (buffer, start, end) => String.fromCharCode(...buffer.slice(start, end))
-    // eslint-disable-next-line no-control-regex
-    .replace(/\u0000/g, '');

package/common/utils/getUInt32FromUint8Array.d.ts

@@ -1,8 +0,0 @@
-/**
- * get uint32 from uint8 array
- *
- * @param buffer - Uint8Array
- * @param start - The beginning of the specified portion of the array
- * @param end - The end of the specified portion of the array
- */
-export declare const getUInt32FromUint8Array: (buffer: Uint8Array, start: number, end: number) => number;

package/common/utils/getUInt32FromUint8Array.js

@@ -1,8 +0,0 @@
-/**
- * get uint32 from uint8 array
- *
- * @param buffer - Uint8Array
- * @param start - The beginning of the specified portion of the array
- * @param end - The end of the specified portion of the array
- */
-export const getUInt32FromUint8Array = (buffer, start, end) => new Uint32Array(buffer.slice(start, end).buffer)[0];

package/common/utils/index.d.ts

@@ -1,12 +0,0 @@
-export * from './Vector2';
-export * from './Vector3';
-export * from './Vector4';
-export * from './PointF';
-export * from './Maths';
-export * from './Quaternion';
-export * from './Color';
-export { cleanPlayerName } from './cleanPlayerName';
-export declare const Delay: (milliseconds: number) => Promise<void>;
-export { enumValues } from './enumValues';
-export { getStringFromUInt8Array } from './getStringFromUInt8Array';
-export { getUInt32FromUint8Array } from './getUInt32FromUint8Array';