fazer-lang 3.1.0 → 3.2.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file.
 
+## [3.2.0] - 2026-01-24
+
+### Added
+- **3D Game Engine (WebGL 2.0)**: Fully hardware-accelerated 3D rendering engine.
+    - `gfx.init3d(title, w, h)`: Initialize 3D context.
+    - `gfx.mesh_create(id, verts, cols, norms)`: Upload mesh data to GPU (VBO/VAO).
+    - `gfx.draw(id, x,y,z, rx,ry,rz, sx,sy,sz)`: Draw 3D mesh entity with transformation.
+    - `gfx.camera(x,y,z, tx,ty,tz)`: Set camera position and look-at target.
+    - `gfx.light(x,y,z)`: Set point light position.
+- **engine3d Library**: High-level 3D abstraction library (included in `lib/`).
+    - `import("engine3d.fz")`: Import the standard 3D library.
+    - `engine3d.Vec3`, `vec_add`, `vec_sub`, `vec_cross`: Vector math utilities.
+    - `engine3d.create_cube_mesh`, `create_plane_mesh`: Built-in mesh generators.
+    - `engine3d.Camera`: FPS Camera implementation.
+    - `engine3d.Entity`: Base 3D entity class.
+    - `engine3d.aabb_intersect`: 3D collision detection.
+- **Overlay UI**: 2D text rendering on top of 3D scene (`gfx.text` works in 3D mode).
+
 ## [3.1.0] - 2026-01-24
 
 ### Added

package/README.md

@@ -65,6 +65,10 @@ Documentation détaillée par section :
     *   **Injection de Code** : Injection de Shellcode via `CreateRemoteThread` (Memory Injection).
     *   **Crypto** : AES-256, Hachage (SHA256/512), HMAC, Encodages.
     *   **Forensics** : Dump mémoire (MiniDump), Liste processus.
+*   **Moteur 3D (v3.2)** : Moteur de jeu WebGL 2.0 complet intégré.
+    *   **Rendu** : Meshes 3D, Eclairage, Caméra FPS.
+    *   **Bibliothèque** : `engine3d` inclus pour la physique (AABB) et les mathématiques vectorielles.
+    *   **Mixte** : Overlay 2D sur scène 3D pour les interfaces utilisateur.
 *   **Stdlib Étendue** : Mathématiques, FS récursif, HTTP avancé (Headers, Proxies).
 *   **Pipe Operator (`->>`)** : Enchaînez les opérations proprement.
 *   **Pattern Matching (`case`)** : Contrôle de flux expressif.

package/docs/3D_ENGINE.md

@@ -0,0 +1,99 @@
+# Guide du Moteur 3D Fazer (v3.2)
+
+Fazer v3.2 introduit un moteur de rendu 3D complet, accéléré matériellement via WebGL 2.0. Ce guide explique comment créer des scènes 3D, gérer la caméra, et utiliser la bibliothèque standard `engine3d`.
+
+## Initialisation
+
+Pour démarrer le mode 3D, utilisez `gfx.init3d` au lieu de `gfx.init`.
+
+```fazer
+gfx.init3d("Mon Jeu 3D", 800, 600)
+
+fn loop() ->
+    gfx.clear({r:0.1, g:0.1, b:0.1})
+    # ... rendu ...
+end
+
+gfx.loop(loop)
+```
+
+## Bibliothèque `engine3d`
+
+La bibliothèque `engine3d` fournit des abstractions de haut niveau pour faciliter le développement. Elle est incluse dans la distribution standard.
+
+```fazer
+engine3d := import("engine3d.fz")
+```
+
+### Vecteurs
+
+```fazer
+v1 := engine3d.Vec3(1, 0, 0)
+v2 := engine3d.Vec3(0, 1, 0)
+v3 := engine3d.vec_add(v1, v2) # {x:1, y:1, z:0}
+```
+
+### Création de Meshes
+
+Vous pouvez générer des formes primitives facilement :
+
+```fazer
+# Créer un cube rouge avec l'ID "cube1"
+engine3d.create_cube_mesh("cube1", {r:1, g:0, b:0})
+
+# Créer un sol gris
+engine3d.create_plane_mesh("floor", {r:0.5, g:0.5, b:0.5}, 20, 20)
+```
+
+### Entités et Caméra
+
+La bibliothèque propose une structure `Entity` et une `Camera` FPS prête à l'emploi.
+
+```fazer
+# Caméra
+mut cam := engine3d.Camera(0, 2, 5)
+
+# Entité
+mut box := engine3d.Entity("cube1", 0, 0, 0)
+
+fn loop() ->
+    gfx.clear({r:0.1, g:0.1, b:0.1})
+    
+    # Mise à jour Caméra (ZQSD + Souris)
+    cam.update(cam)
+    
+    # Dessiner l'entité
+    box.draw(box)
+end
+```
+
+## API Bas Niveau (`gfx`)
+
+Si vous souhaitez contrôler directement le pipeline de rendu :
+
+*   `gfx.mesh_create(id, verts, cols, norms)`: Envoie les données géométriques au GPU.
+    *   `verts`: Liste plate [x,y,z, x,y,z, ...]
+    *   `cols`: Liste plate [r,g,b, r,g,b, ...]
+    *   `norms`: Liste plate [nx,ny,nz, ...]
+*   `gfx.draw(id, x, y, z, rx, ry, rz, sx, sy, sz)`: Dessine un mesh avec transformation (Position, Rotation, Scale).
+*   `gfx.camera(x, y, z, tx, ty, tz)`: Positionne la caméra et le point qu'elle regarde (LookAt).
+*   `gfx.light(x, y, z)`: Positionne la source de lumière ponctuelle.
+
+## Interface Utilisateur (Overlay)
+
+Vous pouvez dessiner du texte 2D par-dessus la scène 3D pour afficher des scores, de la vie, etc.
+
+```fazer
+gfx.text(10, 10, "Score: 100", "#FFFFFF", 20)
+```
+
+## Collisions
+
+La bibliothèque inclut une fonction simple d'intersection AABB (Axis-Aligned Bounding Box).
+
+```fazer
+hit := engine3d.aabb_intersect(
+    pos1, size1, # {x,y,z}
+    pos2, size2  # {x,y,z}
+)
+```

package/docs/GUIDE.md

@@ -15,8 +15,9 @@ Que vous soyez un débutant complet ou un développeur expérimenté, ce manuel
 5.  [Module 5 : Manipulation de Fichiers & Système](#module-5--manipulation-de-fichiers--système)
 6.  [Module 6 : Interfaces Graphiques (GUI)](#module-6--interfaces-graphiques-gui)
 7.  [Module 7 : Réseau & Web](#module-7--réseau--web)
-8.  [Module 8 : Cybersécurité & Red Team](#module-8--cybersécurité--red-team)
-9.  [Annexe : Compiler en .EXE](#annexe--compiler-en-exe)
+8. 8.  [Module 8 : Cybersécurité & Red Team](#module-8--cybersécurité--red-team)
+9.  [Module 9 : Moteur 3D & Jeux](#module-9--moteur-3d--jeux)
+10. [Annexe : Compiler en .EXE](#annexe--compiler-en-exe)
 
 ---
 
@@ -229,15 +230,59 @@ print(page.status)
 > ⚠️ **AVERTISSEMENT** : Usage éducatif et autorisé uniquement.
 
 ### Fonctionnalités Clés
-*   **Chiffrement** : `encrypt_file("secret.txt", "clé")` (AES-256)
-*   **Registre Windows** : `registry_set`, `registry_get` (Persistance)
-*   **Reverse Shell** : `tcp_connect` (Client TCP brut)
-*   **Fond d'écran** : `set_wallpaper("hacked.jpg")`
+*   **Chiffrement** : `crypto.aes_encrypt`, `crypto.hash`, `crypto.hmac`.
+*   **Implant** : `implant.beacon(url, ms)`, `implant.persist("startup")`.
+*   **WiFi** : `wifi.scan()`, `wifi.dump("SSID")`.
+*   **Espionnage (Spy)** :
+    *   `spy.keys_start("log.txt")` : Keylogger (processus détaché).
+    *   `spy.screenshot("ecran.png")` : Capture d'écran.
+    *   `spy.clip_mon(callback)` : Surveille le presse-papier.
+*   **Stéganographie** : `steg.hide_bmp`, `steg.reveal_bmp` (LSB).
+*   **Injection** : `proc.inject(pid, shellcode)` (PowerShell/C# Bridge).
+*   **Forensics** : `sys.mem_dump(pid, file)`.
+*   **Anti-Forensics** : `self.destruct()` (Auto-destruction).
 
 *Pour un guide détaillé sur ces fonctions, consultez le fichier `PENTESTING.md`.*
 
 ---
 
+## Module 9 : Moteur 3D & Jeux
+
+Fazer 3.2 intègre un moteur 3D complet (WebGL 2.0).
+
+### Démarrage Rapide
+
+```fazer
+# Importer la bibliothèque standard 3D
+engine3d := import("engine3d.fz")
+
+# Initialiser la fenêtre 3D
+gfx.init3d("Mon Jeu", 1280, 720)
+
+# Créer une caméra
+mut cam := engine3d.Camera(0, 2, 5)
+
+# Créer un cube
+engine3d.create_cube_mesh("box", {r:1, g:0, b:0})
+mut ent := engine3d.Entity("box", 0, 0, 0)
+
+fn loop() ->
+    gfx.clear({r:0.2, g:0.2, b:0.2})
+    
+    # Mettre à jour la caméra
+    cam.update(cam)
+    
+    # Dessiner l'entité
+    ent.draw(ent)
+end
+
+gfx.loop(loop)
+```
+
+Pour plus de détails, voir le [Guide Moteur 3D](3D_ENGINE.md).
+
+---
+
 ## Annexe : Compiler en .EXE
 
 Transformez n'importe quel script `.fz` en un exécutable Windows autonome `.exe` que vous pouvez partager.