fazer-lang 2.2.1 → 2.4.0

package/README.md

@@ -1,62 +1,63 @@
 # Fazer
 
-**Fazer** is a powerful, concise scripting language designed for automation, security, and data processing. It features a unique syntax with pipe operators (`→>`), pattern matching (`case`), and a batteries-included standard library.
+**Fazer** — Le langage de script nouvelle génération par **L'EMPRISE**.
+
+Conçu pour l'automatisation, la sécurité et le traitement de données, Fazer combine une syntaxe concise avec une bibliothèque standard "batteries included".
 
 ## Installation
 
-Install Fazer globally using npm:
+Installez Fazer globalement via npm :
 
 ```bash
 npm install -g fazer-lang
 ```
 
-## Usage
-
-Run the REPL (interactive mode):
+## Utilisation Rapide
 
+Lancer le REPL (mode interactif) :
 ```bash
 fazer
 ```
 
-Run a script:
-
+Exécuter un script :
 ```bash
-fazer my_script.fz
+fazer mon_script.fz
 ```
 
-## Features
-
-- **Pipe Operator**: Chain functions easily: `readText("in.txt") →> encText(pass) →> writeText("out.enc")`
-- **Pattern Matching**: Expressive control flow with `case`
-- **Batteries Included**: Built-in modules for:
-  - File System (`readText`, `writeText`, `ls`, `exists`)
-  - Cryptography (`aes-256-gcm`, `sha256`)
-  - Networking (`fetch`, `server`, `discord`)
-  - JSON (`json`, `parseJson`)
-  - System (`exec`, `env`, `argv`)
-- **Single File**: The runtime is compact and efficient.
-
-## Example
-
-```fazer
-fn main() →
-  println(style("Welcome to Fazer", "cyan"))
-  
-  files := ls(".")
-  println("Found " + len(files) + " files.")
-  
-  case exists("secret.txt")
-    true →
-      content := readText("secret.txt")
-      println("Secret content: " + content)
-    end
-    else → end
-  end
-end
-
-main()
-```
+## Création d'Exécutable (.exe)
+
+Transformez vos scripts Fazer en applications Windows portables et natives :
+
+1.  (Optionnel) Placez une icône `app.ico` dans le dossier.
+2.  Lancez la commande de build :
+    ```bash
+    fazer build mon_script.fz
+    ```
+3.  Récupérez votre application dans `dist/mon_script/mon_script.exe`.
+
+Le dossier généré est **portable** : zippez-le et envoyez-le à n'importe qui, aucune installation n'est requise !
+
+## Documentation
+
+La documentation complète est disponible dans le dossier [`docs/`](./docs/README.md).
+
+*   [Guide de Démarrage](./docs/getting-started.md)
+*   [Syntaxe du Langage](./docs/syntax.md)
+*   [Bibliothèque Standard (Stdlib)](./docs/stdlib.md)
+*   [Exemples](./docs/examples.md)
+
+## Fonctionnalités Clés
+
+*   **GUI Native** : Créez de vraies applications Windows (WinForms) avec widgets natifs (`window`, `button`, `entry`, etc.).
+*   **Pipe Operator (`->>`)** : Enchaînez les opérations proprement.
+*   **Pattern Matching (`case`)** : Contrôle de flux expressif.
+*   **Sécurité Intégrée** : Chiffrement AES-256-GCM et SHA256 natifs.
+*   **Réseau & Web** : Client HTTP `fetch`, serveur web `server`, et module `discord`.
+*   **Système de Fichiers** : Manipulation simple et puissante.
+*   **Automation** : Gestion du presse-papier (`clipboard`), notifications (`notify`), et persistance (`db`).
+*   **Extensible** : Système de modules `import`.
 
-## License
+## Copyright
 
-MIT
+© 2024 **L'EMPRISE**. Tous droits réservés.
+Distribué sous licence MIT.

package/docs/README.md

@@ -0,0 +1,26 @@
+# Documentation Fazer
+
+Bienvenue dans la documentation officielle du langage **Fazer**.
+
+## Table des Matières
+
+1.  **[Guide de Démarrage](./getting-started.md)**
+    *   Installation
+    *   Votre premier script
+    *   Mode interactif (REPL)
+
+2.  **[Syntaxe du Langage](./syntax.md)**
+    *   Variables et Types
+    *   Opérateur Pipe (`->>`)
+    *   Contrôle de Flux (`case`)
+    *   Fonctions
+
+3.  **[Bibliothèque Standard (Stdlib)](./stdlib.md)**
+    *   E/S Console (`println`, `ask`...)
+    *   Système de Fichiers (`readText`, `writeText`...)
+    *   Chiffrement (`encText`, `sha256`...)
+    *   Réseau & Web (`server`, `fetch`, `discord`...)
+    *   Utilitaires (`json`, `exec`...)
+
+4.  **[Exemples](./examples.md)**
+    *   Scripts complets pour apprendre par l'exemple.

package/docs/examples.md

@@ -0,0 +1,60 @@
+# Exemples Fazer
+
+## 1. Hello World
+
+```fazer
+"Hello World" ->> println
+```
+
+## 2. Demander le nom
+
+```fazer
+"Quel est votre nom ? " ->> ask ->> println
+```
+
+## 3. Chiffrement de Fichier (Logique simplifiée)
+
+Ce script montre comment on pourrait structurer un outil de chiffrement.
+
+```fazer
+fn main () {
+  "1. Chiffrer" ->> println
+  "2. Déchiffrer" ->> println
+  "Choix : " ->> ask ->> case {
+    "1" : {
+      "Fichier à chiffrer : " ->> ask ->> enc_flow
+    }
+    "2" : {
+      "Fichier à déchiffrer : " ->> ask ->> dec_flow
+    }
+    _ : {
+      "Choix invalide" ->> println
+    }
+  }
+}
+
+fn enc_flow (path) {
+  path ->> exists ->> case {
+    true : {
+      "Mot de passe : " ->> ask ->> pass
+      path ->> readText ->> encText(pass) ->> saveText(path)
+      "Fichier chiffré !" ->> println
+    }
+    _ : { "Fichier introuvable" ->> println }
+  }
+}
+
+// Lancer le main
+main()
+```
+
+## 4. Serveur Web Simple
+
+```fazer
+fn handle_request (req) {
+  "<h1>Bienvenue sur Fazer Web</h1>" // Retourne le HTML
+}
+
+"Démarrage du serveur sur 8080..." ->> println
+8080 ->> server("handle_request")
+```

package/docs/getting-started.md

@@ -0,0 +1,153 @@
+# Guide de Démarrage Fazer
+
+Bienvenue dans Fazer, le langage de script puissant et moderne pour Windows.
+
+## Installation
+
+1. Téléchargez la dernière version.
+2. Lancez `install_system.ps1` pour configurer le PATH et les associations de fichiers.
+3. Ouvrez un terminal et tapez `fazer` pour lancer le REPL.
+
+## Votre premier script
+
+Créez un fichier `hello.fz` :
+
+```fazer
+"Bonjour Fazer !" ->> println
+```
+
+Exécutez-le :
+```bash
+fazer run hello.fz
+```
+
+Ou simplement (si installé) :
+```bash
+fazer hello.fz
+```
+
+## Concepts de Base
+
+### Variables et Fonctions
+
+```fazer
+# Variable
+nom := "Monde"
+
+# Fonction
+fn saluer(n) ->
+  "Bonjour " + n
+end
+
+saluer(nom) ->> println
+```
+
+### Pipe (`->>`)
+
+L'opérateur pipe passe le résultat de gauche comme premier argument à la fonction de droite.
+
+```fazer
+"  texte sale  " ->> str_trim ->> str_upper ->> println
+# Affiche : "TEXTE SALE"
+```
+
+## Bibliothèque Standard (Nouveau !)
+
+Fazer dispose maintenant d'une bibliothèque standard riche pour les tâches réelles.
+
+### 1. Système de Fichiers
+```fazer
+# Lire
+contenu := fs_read("config.txt")
+
+# Écrire
+fs_write("log.txt", "Succès")
+```
+
+### 2. Modules (`import`)
+Organisez votre code en plusieurs fichiers.
+
+**math.fz** :
+```fazer
+add := (a, b) => a + b
+PI := 3.14159
+```
+
+**main.fz** :
+```fazer
+m := import("math.fz")
+m.add(10, 5) ->> println
+m.PI ->> println
+```
+
+### 3. Base de Données Native (`db`)
+Persistance des données JSON simple et efficace.
+
+```fazer
+# Initialiser (charge ou crée le fichier)
+store := db("data.json")
+
+# Sauvegarder une valeur
+store.set("score", 100)
+store.set("user", "viced")
+
+# Lire une valeur
+store.get("score") ->> println
+
+# Récupérer tout
+all := store.all()
+```
+
+### 4. Automation Système
+Interagissez avec Windows.
+
+```fazer
+# Presse-papier (Copier)
+clipboard_set("Copié depuis Fazer !")
+
+# Notifications
+notify("Titre", "Ceci est une notification Windows native")
+
+# Exécution de commandes
+ip := exec("ipconfig")
+```
+
+### 5. GUI Native (Vrai Native)
+Créez des applications Windows natives (WinForms) directement en Fazer.
+
+```fazer
+# 1. Définir l'interface
+window("Mon Application", 400, 300)
+label("lbl_msg", "Bienvenue !", 20, 20, 360, 30)
+button("btn_ok", "Cliquez-moi", 20, 60, 150, 40)
+entry("txt_nom", "Votre nom", 20, 120, 360, 30)
+
+# 2. Gestionnaire d'événements
+fn handler(ev) ->
+  id = ev["id"]
+  
+  if id == "btn_ok"
+    msgbox("Bouton cliqué !")
+    set_text("lbl_msg", "Merci !")
+  end
+  
+  if id == "txt_nom"
+    # ev["value"] contient le texte tapé
+    print("Nom changé: " + ev["value"])
+  end
+end
+
+# 3. Lancer l'interface
+gui(handler)
+```
+
+### 6. Serveur Web
+Créez des API ou des sites web.
+
+```fazer
+fn handler(req) ->
+  "Vous avez demandé : " + req.url
+end
+
+server(8080, handler)
+```

package/docs/stdlib.md

@@ -0,0 +1,111 @@
+# Bibliothèque Standard (Stdlib)
+
+Fazer inclut une bibliothèque standard "batteries included" pour le développement d'applications robustes.
+
+## Système de Fichiers (fs)
+
+Manipulation de fichiers synchrones et performante.
+
+### `fs_read(path)`
+Lit le contenu d'un fichier en texte (UTF-8). Retourne `null` en cas d'erreur.
+```fazer
+content := fs_read("config.json")
+```
+
+### `fs_write(path, content)`
+Écrit (écrase) du contenu dans un fichier. Retourne `true` si succès.
+```fazer
+fs_write("log.txt", "Initialisation...")
+```
+
+### `fs_append(path, content)`
+Ajoute du contenu à la fin d'un fichier.
+```fazer
+fs_append("log.txt", "\nNouvelle entrée")
+```
+
+### `fs_exists(path)`
+Vérifie si un fichier ou dossier existe.
+```fazer
+if fs_exists("data") -> ... end
+```
+
+## Manipulation de Données
+
+### JSON
+*   `json_parse(str)` : Convertit une chaîne JSON en objet/liste.
+*   `json_stringify(obj)` : Convertit un objet en chaîne JSON formatée.
+    *   Alias : `json(obj)`
+
+### Chaînes de Caractères (String)
+*   `str_split(str, delimiter)` : Découpe une chaîne en liste.
+*   `str_replace(str, old, new)` : Remplace toutes les occurrences.
+*   `str_trim(str)` : Retire les espaces au début et à la fin.
+*   `str_upper(str)` : Convertit en majuscules.
+*   `str_lower(str)` : Convertit en minuscules.
+
+### Mathématiques
+*   `random()` : Retourne un nombre aléatoire entre 0.0 et 1.0.
+*   `round(n)` : Arrondi à l'entier le plus proche.
+*   `floor(n)` : Arrondi à l'entier inférieur.
+*   `ceil(n)` : Arrondi à l'entier supérieur.
+*   `int(n)` : Conversion en entier.
+*   `float(n)` : Conversion en flottant.
+
+## Base de Données (db)
+
+### `db(path)`
+Crée ou charge une base de données JSON persistante.
+```fazer
+store := db("data.json")
+store.set("key", "value")
+val := store.get("key")
+data := store.all()
+```
+
+## Automation & Système
+
+### Presse-papier
+*   `clipboard_set(text)` : Copie du texte dans le presse-papier.
+*   `clipboard_get()` : Récupère le texte du presse-papier.
+
+### Notifications
+*   `notify(title, msg)` : Affiche une notification système native.
+
+### Exécution
+*   `exec(cmd)` : Exécute une commande système et capture la sortie.
+*   `sleep(ms)` : Pause l'exécution.
+*   `import(path)` : Charge un module Fazer externe.
+
+## Interface Graphique (GUI Native)
+
+Créez des applications Windows Forms natives.
+
+### Widgets
+*   `window(title, width, height, icon_path)` : Définit la fenêtre principale. `icon_path` est optionnel (ex: `"app.ico"`).
+*   `button(id, text, x, y, w, h)` : Ajoute un bouton.
+*   `label(id, text, x, y, w, h)` : Ajoute une étiquette de texte.
+*   `entry(id, text, x, y, w, h)` : Ajoute un champ de saisie texte.
+
+### Interaction
+*   `gui(handler)` : Lance la boucle d'événements. `handler` reçoit des événements `{id, type, value}`.
+*   `set_text(id, text)` : Change le texte d'un widget (à utiliser dans le handler).
+*   `msgbox(text)` : Affiche une boîte de dialogue modale.
+
+## Réseau & Web
+
+### `server(port, handler)`
+Démarre un serveur HTTP.
+```fazer
+fn handler(req) ->
+  return({ "body": "Hello World" })
+end
+server(8080, handler)
+```
+
+### `fetch(url, options)`
+Effectue une requête HTTP asynchrone.
+```fazer
+res := fetch("https://api.example.com/data")
+print(res.body)
+```

package/docs/syntax.md

@@ -0,0 +1,86 @@
+# Syntaxe du Langage Fazer
+
+Fazer est un langage orienté flux. La plupart des opérations se font de gauche à droite via l'opérateur pipe.
+
+## Commentaires
+
+```fazer
+// Ceci est un commentaire sur une ligne
+```
+
+## Variables
+
+Il n'y a pas de mot-clé de déclaration explicite comme `var` ou `let` pour l'assignation simple dans le flux, mais vous pouvez nommer des valeurs dans des arguments de fonctions.
+
+Cependant, Fazer utilise principalement le passage de valeurs. Pour stocker des états globaux ou complexes, on utilise souvent des objets JSON ou la mémoire interne via `set`/`get`.
+
+```fazer
+// Exemple d'utilisation de set/get (mémoire clé-valeur)
+"ma_valeur" "cle" ->> set
+"cle" ->> get ->> println // Affiche "ma_valeur"
+```
+
+## Opérateur Pipe (`->>`)
+
+L'opérateur `->>` passe le résultat de l'expression de gauche comme **premier argument** de la fonction de droite.
+
+```fazer
+"Bonjour" ->> println
+// Équivalent à println("Bonjour") dans d'autres langages
+```
+
+Chaînage :
+
+```fazer
+"mot_de_passe" ->> sha256 ->> println
+```
+
+## Chaînes de Caractères et Nombres
+
+```fazer
+"Ceci est une chaîne"
+123
+12.34
+```
+
+## Fonctions (Définition)
+
+Fazer supporte la définition de fonctions nommées.
+
+```fazer
+fn ma_fonction (arg1) {
+  arg1 ->> println
+}
+
+"test" ->> ma_fonction
+```
+
+## Contrôle de Flux : `case`
+
+Fazer n'a pas de `if/else` traditionnel. Tout se fait via `case` (pattern matching).
+
+```fazer
+valeur ->> case {
+  "option1" : {
+    "C'est l'option 1" ->> println
+  }
+  "option2" : {
+    "C'est l'option 2" ->> println
+  }
+  _ : {
+    "Cas par défaut (wildcard)" ->> println
+  }
+}
+```
+
+### Conditionnelle (If-Else simulé)
+
+Pour faire un `if`, on matche souvent sur un booléen ou une valeur spécifique. Notez que Fazer évalue l'égalité stricte.
+
+```fazer
+// Exemple conceptuel
+variable ->> case {
+  "vrai" : { ... }
+  _ : { ... }
+}
+```