chore: bump version to v3.31.3

fxmanifest.lua

@@ -6,7 +6,7 @@ rdr3_warning 'I acknowledge that this is a prerelease build of RedM, and I am aw
 
 name 'ox_lib'
 author 'Overextended'
-version '3.31.1'
+version '3.31.3'
 license 'LGPL-3.0-or-later'
 repository 'https://github.com/communityox/ox_lib'
 description 'A library of shared functions to utilise in other resources.'

locales/fr.json

@@ -7,27 +7,27 @@
     "confirm": "Confirmer",
     "more": "Plus...",
     "settings": {
-      "locale": "Change locale",
-      "locale_description": "Current language: ${language} (%s)",
-      "notification_audio": "Notification audio",
-      "notification_position": "Notification position"
+      "locale": "Changer la langue",
+      "locale_description": "Langue actuelle : ${language} (%s)",
+      "notification_audio": "Audio des notifications",
+      "notification_position": "Position des notifications"
     },
     "position": {
-      "bottom": "Bottom",
-      "bottom-left": "Bottom-left",
-      "bottom-right": "Bottom-right",
-      "center-left": "Center-left",
-      "center-right": "Center-right",
-      "top": "Top",
-      "top-left": "Top-left",
-      "top-right": "Top-right"
+      "bottom": "Bas",
+      "bottom-left": "Bas-gauche",
+      "bottom-right": "Bas-droite",
+      "center-left": "Centre-gauche",
+      "center-right": "Centre-droite",
+      "top": "Haut",
+      "top-left": "Haut-gauche",
+      "top-right": "Haut-droite"
     }
   },
-  "open_radial_menu": "Open radial menu",
-  "cancel_progress": "Cancel current progress bar",
-  "txadmin_announcement": "Server announcement by %s",
-  "txadmin_dm": "Direct Message from %s",
-  "txadmin_warn": "You have been warned by %s",
-  "txadmin_warn_content": "%s  \nAction ID: %s",
-  "txadmin_scheduledrestart": "Scheduled Restart"
+  "open_radial_menu": "Ouvrir le menu radial",
+  "cancel_progress": "Annuler la barre de progression actuelle",
+  "txadmin_announcement": "Annonce serveur par %s",
+  "txadmin_dm": "Message privé de %s",
+  "txadmin_warn": "Vous avez été averti par %s",
+  "txadmin_warn_content": "%s\nID de l'action : %s",
+  "txadmin_scheduledrestart": "Redémarrage programmé"
 }

package/client/resource/addKeybind/index.ts

@@ -0,0 +1,120 @@
+interface CKeybind extends KeybindProps {
+  currentKey: string;
+  disabled: boolean;
+  isPressed: boolean;
+  hash: number;
+  getCurrentKey(): string;
+  isControlPressed(): boolean;
+}
+
+interface KeybindProps {
+  name: string;
+  description: string;
+  defaultMapper?: string;
+  defaultKey?: string;
+  disabled?: boolean;
+  disable?(this: CKeybind, toggle: boolean): void;
+  onPressed?(this: CKeybind): void;
+  onReleased?(this: CKeybind): void;
+  [key: string]: any;
+}
+
+const keybinds: Record<string, CKeybind> = {};
+
+class Keybind implements CKeybind {
+  name: string;
+  description: string;
+  defaultMapper?: string;
+  defaultKey?: string;
+  onPressed?: (this: CKeybind) => void;
+  onReleased?: (this: CKeybind) => void;
+  secondaryKey?: string;
+  secondaryMapper?: string;
+  [key: string]: any;
+
+  disabled: boolean = false;
+  isPressed: boolean = false;
+  hash: number;
+
+  constructor(data: KeybindProps) {
+    this.name = data.name;
+    this.description = data.description;
+    this.defaultMapper = data.defaultMapper ?? "keyboard";
+    this.defaultKey = data.defaultKey ?? "";
+    this.secondaryKey = data.secondaryKey;
+    this.secondaryMapper = data.secondaryMapper;
+
+    if (typeof data.disabled === "boolean") this.disabled = data.disabled;
+    this.onPressed = data.onPressed;
+    this.onReleased = data.onReleased;
+
+    this.hash = GetHashKey("+" + this.name) | 0x80000000;
+  }
+
+  get currentKey(): string {
+    return this.getCurrentKey();
+  }
+
+  getCurrentKey(): string {
+    const label = GetControlInstructionalButton(0, this.hash, true);
+    return label.substring(2);
+  }
+
+  isControlPressed(): boolean {
+    return this.isPressed;
+  }
+
+  disable(toggle: boolean): void {
+    this.disabled = toggle;
+  }
+}
+
+
+export function addKeybind(data: KeybindProps): CKeybind {
+  const kb = new Keybind(data);
+
+  keybinds[kb.name] = kb;
+
+  RegisterCommand("+" + kb.name, () => {
+    if (kb.disabled || IsPauseMenuActive()) return;
+    kb.isPressed = true;
+    kb.onPressed?.call(kb);
+  }, false);
+
+  RegisterCommand("-" + kb.name, () => {
+    if (kb.disabled || IsPauseMenuActive()) return;
+    kb.isPressed = false;
+    kb.onReleased?.call(kb);
+  }, false);
+
+  RegisterKeyMapping(
+    "+" + kb.name,
+    kb.description,
+    kb.defaultMapper ?? "keyboard",
+    kb.defaultKey ?? ""
+  );
+
+  if (kb.secondaryKey) {
+    RegisterKeyMapping(
+      "~!+" + kb.name,
+      kb.description,
+      kb.secondaryMapper ?? kb.defaultMapper ?? "keyboard",
+      kb.secondaryKey
+    );
+  }
+
+  setTimeout(() => {
+    emit("chat:removeSuggestion", `/+${kb.name}`);
+    emit("chat:removeSuggestion", `/-${kb.name}`);
+  }, 500);
+
+  return kb;
+}
+
+export function getKeybind(name: string): CKeybind | undefined {
+  return keybinds[name];
+}
+
+export function getAllKeybinds(): Readonly<Record<string, CKeybind>> {
+  return keybinds;
+}

package/client/resource/index.ts

@@ -14,3 +14,4 @@ export * from './vehicleProperties';
 export * from './callback';
 export * from './points';
 export * from './dui';
+export * from './addKeybind';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@communityox/ox_lib",
   "author": "Overextended",
-  "version": "3.31.1",
+  "version": "3.31.3",
   "description": "JS/TS wrapper for ox_lib exports",
   "main": "./shared/index.js",
   "types": "./shared/index.d.ts",