# API & Exports

Ce document liste tous les exports et événements disponibles pour intégrer le StretcherMod avec vos propres scripts (menus radiaux, context menus, dispatch, MDT, etc.).

> **⚠️ IMPORTANT :** Si vous utilisez vos propres menus via ces exports, n'oubliez pas de désactiver le système de ciblage intégré en mettant `Config.TargetSystem = "none"` dans votre `config.lua` pour éviter les conflits et les erreurs dans la console !

---

## 💻 EXPORTS CLIENT

Vous pouvez appeler ces fonctions depuis n'importe quel script client. 
La plupart de nos exports retournent deux valeurs : `success` (boolean) et `message` (string ou boolean selon le cas) pour vous permettre de gérer vos erreurs proprement (ex: si le joueur n'a pas le bon métier).

*Note : Si vous ne précisez pas d'entité en paramètre, le script ciblera automatiquement le brancard ou l'ambulance la plus proche du joueur.*

### 🛠️ Actions

**1. Pousser / Lâcher un brancard**
```lua
local success, action = exports['StretcherMod-MasterMods-v7']:TogglePush(entity)
-- action retourne "pushed" ou "dropped"
```

**2. Ouvrir le menu de gestion du brancard**
```lua
local success, reason = exports['StretcherMod-MasterMods-v7']:OpenMenu(entity)
```

**3. Ranger le brancard dans l'ambulance**
*(Vérifie automatiquement que les portes requises de l'ambulance sont ouvertes)*
```lua
local success, reason = exports['StretcherMod-MasterMods-v7']:StowStretcher(ambulanceVehicle)
```

**4. Sortir le brancard de l'ambulance**
```lua
local success, reason = exports['StretcherMod-MasterMods-v7']:UnstowStretcher(ambulanceVehicle)
```

**5. Ouvrir le menu du brancard depuis l'intérieur de l'ambulance**
```lua
local success, reason = exports['StretcherMod-MasterMods-v7']:OpenAmbulanceMenu(ambulanceVehicle)
```

**6. Bloquer / Débloquer les freins**
```lua
local success, isBraked = exports['StretcherMod-MasterMods-v7']:ToggleBrakes(entity)
-- isBraked retourne le nouvel état des freins (true = bloqué)
```

### 🔍 Lecture d'informations (Getters)

**Savoir si le joueur pousse actuellement un brancard :**
```lua
local isPushing = exports['StretcherMod-MasterMods-v7']:IsPushingStretcher() -- Retourne true/false
```

**Récupérer l'entité du brancard tenu par le joueur :**
```lua
local stretcherEntity = exports['StretcherMod-MasterMods-v7']:GetAttachedStretcher() -- Retourne l'entité ou nil
```

**Savoir si un brancard est occupé (Joueur ou PNJ) :**
```lua
local isOccupied = exports['StretcherMod-MasterMods-v7']:IsStretcherOccupied(entity) -- Retourne true/false
```

---

## 📡 ÉVÉNEMENTS CLIENT (Hooks)

Le script diffuse ces événements en local. Vous pouvez les écouter dans vos autres scripts pour déclencher actions automatiques (ex: allumer les gyrophares quand on sort le brancard, envoyer un message radio, etc.).

* **`stretchermod:onPushStart`**(entity) : Se déclenche quand le joueur attrape le brancard.
* **`stretchermod:onPushStop`**(entity, position) : Se déclenche quand le joueur lâche le brancard (`position` = 'debout' ou 'couche').
* **`stretchermod:onStretcherStowed`**(ambulanceEntity, stretcherEntity) : Se déclenche quand un brancard est rangé dans un véhicule.
* **`stretchermod:onStretcherUnstowed`**(ambulanceEntity, stretcherEntity) : Se déclenche quand un brancard est sorti d'un véhicule.

*Exemple d'utilisation :*
```lua
AddEventHandler('stretchermod:onStretcherStowed', function(ambulance, stretcher)
    print("Un brancard vient d'être chargé dans l'ambulance !")
    -- Insérez ici votre code pour fermer les portes arrière automatiquement, par exemple.
end)
```