Aktraiser
commited on
Commit
·
a4d9764
1
Parent(s):
0eed2ad
refacto code
Browse files- app.py +111 -633
- tools/__init__.py +86 -0
- tools/config.py +102 -0
- tools/figjam.py +361 -0
- tools/figma_design.py +92 -0
- tools/navigation.py +67 -0
- tools/user_account.py +237 -0
app.py
CHANGED
|
@@ -7,647 +7,17 @@ import gradio as gr
|
|
| 7 |
import asyncio
|
| 8 |
import json
|
| 9 |
import logging
|
| 10 |
-
import requests
|
| 11 |
-
from typing import Dict, Any, Optional, List
|
| 12 |
from PIL import Image
|
| 13 |
import base64
|
| 14 |
import io
|
| 15 |
|
|
|
|
|
|
|
|
|
|
| 16 |
# Configuration du logging
|
| 17 |
logging.basicConfig(level=logging.INFO)
|
| 18 |
logger = logging.getLogger(__name__)
|
| 19 |
|
| 20 |
-
# Configuration Figma API
|
| 21 |
-
FIGMA_API_BASE = "https://api.figma.com/v1"
|
| 22 |
-
|
| 23 |
-
# === CONFIGURATION ET ÉTAT ===
|
| 24 |
-
|
| 25 |
-
# Variables globales pour stocker la configuration
|
| 26 |
-
figma_config = {
|
| 27 |
-
"token": None,
|
| 28 |
-
"file_id": None,
|
| 29 |
-
"team_id": None
|
| 30 |
-
}
|
| 31 |
-
|
| 32 |
-
def configure_figma_token(token: str) -> str:
|
| 33 |
-
"""Configure le token d'accès Figma"""
|
| 34 |
-
global figma_config
|
| 35 |
-
|
| 36 |
-
if not token or not token.startswith(('figd_', 'figc_')):
|
| 37 |
-
return "❌ Token invalide. Le token doit commencer par 'figd_' ou 'figc_'"
|
| 38 |
-
|
| 39 |
-
figma_config["token"] = token
|
| 40 |
-
|
| 41 |
-
# Test de connexion
|
| 42 |
-
try:
|
| 43 |
-
headers = {"X-Figma-Token": token}
|
| 44 |
-
response = requests.get(f"{FIGMA_API_BASE}/me", headers=headers, timeout=10)
|
| 45 |
-
|
| 46 |
-
if response.status_code == 200:
|
| 47 |
-
user_data = response.json()
|
| 48 |
-
username = user_data.get("handle", "Utilisateur inconnu")
|
| 49 |
-
return f"✅ Token configuré avec succès ! Connecté en tant que : {username}"
|
| 50 |
-
else:
|
| 51 |
-
return f"❌ Erreur lors de la vérification du token : {response.status_code}"
|
| 52 |
-
|
| 53 |
-
except Exception as e:
|
| 54 |
-
return f"❌ Erreur de connexion à l'API Figma : {str(e)}"
|
| 55 |
-
|
| 56 |
-
def configure_figma_file_id(file_id: str) -> str:
|
| 57 |
-
"""Configure l'ID du fichier Figma à utiliser"""
|
| 58 |
-
global figma_config
|
| 59 |
-
|
| 60 |
-
if not file_id:
|
| 61 |
-
return "❌ L'ID du fichier est requis"
|
| 62 |
-
|
| 63 |
-
figma_config["file_id"] = file_id
|
| 64 |
-
|
| 65 |
-
# Test d'accès au fichier
|
| 66 |
-
if figma_config["token"]:
|
| 67 |
-
try:
|
| 68 |
-
headers = {"X-Figma-Token": figma_config["token"]}
|
| 69 |
-
response = requests.get(f"{FIGMA_API_BASE}/files/{file_id}", headers=headers, timeout=10)
|
| 70 |
-
|
| 71 |
-
if response.status_code == 200:
|
| 72 |
-
file_data = response.json()
|
| 73 |
-
file_name = file_data.get("name", "Fichier inconnu")
|
| 74 |
-
return f"✅ Fichier configuré avec succès : {file_name}"
|
| 75 |
-
else:
|
| 76 |
-
return f"❌ Impossible d'accéder au fichier : {response.status_code}"
|
| 77 |
-
|
| 78 |
-
except Exception as e:
|
| 79 |
-
return f"❌ Erreur lors de l'accès au fichier : {str(e)}"
|
| 80 |
-
else:
|
| 81 |
-
return "⚠️ ID du fichier configuré, mais token manquant"
|
| 82 |
-
|
| 83 |
-
# === FONCTIONS API FIGMA ===
|
| 84 |
-
|
| 85 |
-
def make_figma_request(endpoint: str, method: str = "GET", data: Dict = None) -> Dict[str, Any]:
|
| 86 |
-
"""Effectue une requête à l'API Figma"""
|
| 87 |
-
if not figma_config["token"]:
|
| 88 |
-
return {"error": "Token Figma non configuré"}
|
| 89 |
-
|
| 90 |
-
headers = {
|
| 91 |
-
"X-Figma-Token": figma_config["token"],
|
| 92 |
-
"Content-Type": "application/json"
|
| 93 |
-
}
|
| 94 |
-
|
| 95 |
-
url = f"{FIGMA_API_BASE}/{endpoint}"
|
| 96 |
-
|
| 97 |
-
try:
|
| 98 |
-
if method == "GET":
|
| 99 |
-
response = requests.get(url, headers=headers, timeout=30)
|
| 100 |
-
elif method == "POST":
|
| 101 |
-
response = requests.post(url, headers=headers, json=data, timeout=30)
|
| 102 |
-
elif method == "PUT":
|
| 103 |
-
response = requests.put(url, headers=headers, json=data, timeout=30)
|
| 104 |
-
elif method == "DELETE":
|
| 105 |
-
response = requests.delete(url, headers=headers, timeout=30)
|
| 106 |
-
else:
|
| 107 |
-
return {"error": f"Méthode HTTP non supportée : {method}"}
|
| 108 |
-
|
| 109 |
-
if response.status_code in [200, 201]:
|
| 110 |
-
return response.json()
|
| 111 |
-
else:
|
| 112 |
-
return {"error": f"Erreur API {response.status_code}: {response.text}"}
|
| 113 |
-
|
| 114 |
-
except Exception as e:
|
| 115 |
-
return {"error": f"Erreur de requête : {str(e)}"}
|
| 116 |
-
|
| 117 |
-
# === OUTILS MCP FIGMA ===
|
| 118 |
-
|
| 119 |
-
def get_figma_file_info(file_id: str = "") -> str:
|
| 120 |
-
"""Récupère les informations d'un fichier Figma"""
|
| 121 |
-
file_id = file_id or figma_config["file_id"]
|
| 122 |
-
|
| 123 |
-
if not file_id:
|
| 124 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 125 |
-
|
| 126 |
-
result = make_figma_request(f"files/{file_id}")
|
| 127 |
-
|
| 128 |
-
if "error" in result:
|
| 129 |
-
return f"❌ Erreur : {result['error']}"
|
| 130 |
-
|
| 131 |
-
file_info = {
|
| 132 |
-
"nom": result.get("name", ""),
|
| 133 |
-
"derniere_modification": result.get("lastModified", ""),
|
| 134 |
-
"version": result.get("version", ""),
|
| 135 |
-
"pages": [page.get("name", "") for page in result.get("document", {}).get("children", [])]
|
| 136 |
-
}
|
| 137 |
-
|
| 138 |
-
return f"📄 **Fichier Figma :**\n{json.dumps(file_info, indent=2, ensure_ascii=False)}"
|
| 139 |
-
|
| 140 |
-
def create_figma_rectangle(x: str, y: str, width: str, height: str, name: str = "Rectangle", color: str = "#FF0000") -> str:
|
| 141 |
-
"""Crée un rectangle dans Figma (via commentaire pour notification)"""
|
| 142 |
-
if not figma_config["file_id"]:
|
| 143 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 144 |
-
|
| 145 |
-
try:
|
| 146 |
-
x_pos, y_pos = float(x), float(y)
|
| 147 |
-
w, h = float(width), float(height)
|
| 148 |
-
|
| 149 |
-
# Créer un commentaire avec les instructions de création
|
| 150 |
-
comment_text = f"🟦 **Rectangle à créer :**\n- Nom: {name}\n- Position: ({x_pos}, {y_pos})\n- Taille: {w}x{h}\n- Couleur: {color}"
|
| 151 |
-
|
| 152 |
-
comment_data = {
|
| 153 |
-
"message": comment_text,
|
| 154 |
-
"client_meta": {
|
| 155 |
-
"x": x_pos,
|
| 156 |
-
"y": y_pos
|
| 157 |
-
}
|
| 158 |
-
}
|
| 159 |
-
|
| 160 |
-
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 161 |
-
|
| 162 |
-
if "error" in result:
|
| 163 |
-
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 164 |
-
|
| 165 |
-
return f"✅ Rectangle {name} créé (via commentaire) à ({x_pos}, {y_pos}) avec la taille {w}x{h}"
|
| 166 |
-
|
| 167 |
-
except ValueError:
|
| 168 |
-
return "❌ Les coordonnées et dimensions doivent être des nombres"
|
| 169 |
-
|
| 170 |
-
def create_figma_frame(x: str, y: str, width: str, height: str, name: str = "Frame") -> str:
|
| 171 |
-
"""Crée un frame dans Figma (via commentaire pour notification)"""
|
| 172 |
-
if not figma_config["file_id"]:
|
| 173 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 174 |
-
|
| 175 |
-
try:
|
| 176 |
-
x_pos, y_pos = float(x), float(y)
|
| 177 |
-
w, h = float(width), float(height)
|
| 178 |
-
|
| 179 |
-
comment_text = f"🖼️ **Frame à créer :**\n- Nom: {name}\n- Position: ({x_pos}, {y_pos})\n- Taille: {w}x{h}"
|
| 180 |
-
|
| 181 |
-
comment_data = {
|
| 182 |
-
"message": comment_text,
|
| 183 |
-
"client_meta": {
|
| 184 |
-
"x": x_pos,
|
| 185 |
-
"y": y_pos
|
| 186 |
-
}
|
| 187 |
-
}
|
| 188 |
-
|
| 189 |
-
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 190 |
-
|
| 191 |
-
if "error" in result:
|
| 192 |
-
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 193 |
-
|
| 194 |
-
return f"✅ Frame {name} créé (via commentaire) à ({x_pos}, {y_pos}) avec la taille {w}x{h}"
|
| 195 |
-
|
| 196 |
-
except ValueError:
|
| 197 |
-
return "❌ Les coordonnées et dimensions doivent être des nombres"
|
| 198 |
-
|
| 199 |
-
def create_figma_text(x: str, y: str, text: str, name: str = "Text", font_size: str = "16") -> str:
|
| 200 |
-
"""Crée un élément texte dans Figma (via commentaire pour notification)"""
|
| 201 |
-
if not figma_config["file_id"]:
|
| 202 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 203 |
-
|
| 204 |
-
try:
|
| 205 |
-
x_pos, y_pos = float(x), float(y)
|
| 206 |
-
size = float(font_size)
|
| 207 |
-
|
| 208 |
-
comment_text = f"📝 **Texte à créer :**\n- Nom: {name}\n- Position: ({x_pos}, {y_pos})\n- Texte: \"{text}\"\n- Taille: {size}px"
|
| 209 |
-
|
| 210 |
-
comment_data = {
|
| 211 |
-
"message": comment_text,
|
| 212 |
-
"client_meta": {
|
| 213 |
-
"x": x_pos,
|
| 214 |
-
"y": y_pos
|
| 215 |
-
}
|
| 216 |
-
}
|
| 217 |
-
|
| 218 |
-
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 219 |
-
|
| 220 |
-
if "error" in result:
|
| 221 |
-
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 222 |
-
|
| 223 |
-
return f"✅ Texte \"{text}\" créé (via commentaire) à ({x_pos}, {y_pos})"
|
| 224 |
-
|
| 225 |
-
except ValueError:
|
| 226 |
-
return "❌ Les coordonnées et la taille doivent être des nombres"
|
| 227 |
-
|
| 228 |
-
def get_figma_comments(file_id: str = "") -> str:
|
| 229 |
-
"""Récupère tous les commentaires d'un fichier Figma"""
|
| 230 |
-
file_id = file_id or figma_config["file_id"]
|
| 231 |
-
|
| 232 |
-
if not file_id:
|
| 233 |
-
return "❌ ID du fichier requis"
|
| 234 |
-
|
| 235 |
-
result = make_figma_request(f"files/{file_id}/comments")
|
| 236 |
-
|
| 237 |
-
if "error" in result:
|
| 238 |
-
return f"❌ Erreur : {result['error']}"
|
| 239 |
-
|
| 240 |
-
comments = result.get("comments", [])
|
| 241 |
-
|
| 242 |
-
if not comments:
|
| 243 |
-
return "📝 Aucun commentaire trouvé dans ce fichier"
|
| 244 |
-
|
| 245 |
-
comment_list = []
|
| 246 |
-
for comment in comments[:10]: # Limiter à 10 commentaires
|
| 247 |
-
user = comment.get("user", {}).get("handle", "Anonyme")
|
| 248 |
-
message = comment.get("message", "")
|
| 249 |
-
created_at = comment.get("created_at", "")
|
| 250 |
-
comment_list.append(f"👤 {user} ({created_at}): {message}")
|
| 251 |
-
|
| 252 |
-
return f"📝 **Commentaires récents :**\n" + "\n\n".join(comment_list)
|
| 253 |
-
|
| 254 |
-
def get_figma_user_info() -> str:
|
| 255 |
-
"""Récupère les informations de l'utilisateur connecté"""
|
| 256 |
-
result = make_figma_request("me")
|
| 257 |
-
|
| 258 |
-
if "error" in result:
|
| 259 |
-
return f"❌ Erreur : {result['error']}"
|
| 260 |
-
|
| 261 |
-
user_info = {
|
| 262 |
-
"nom": result.get("handle", ""),
|
| 263 |
-
"email": result.get("email", ""),
|
| 264 |
-
"id": result.get("id", "")
|
| 265 |
-
}
|
| 266 |
-
|
| 267 |
-
return f"👤 **Utilisateur connecté :**\n{json.dumps(user_info, indent=2, ensure_ascii=False)}"
|
| 268 |
-
|
| 269 |
-
def list_figma_team_projects(team_id: str = "") -> str:
|
| 270 |
-
"""Liste les projets d'une équipe Figma"""
|
| 271 |
-
team_id = team_id or figma_config["team_id"]
|
| 272 |
-
|
| 273 |
-
if not team_id:
|
| 274 |
-
return "❌ ID de l'équipe requis. Configurez-le avec figma_config['team_id'] = 'VOTRE_TEAM_ID'"
|
| 275 |
-
|
| 276 |
-
result = make_figma_request(f"teams/{team_id}/projects")
|
| 277 |
-
|
| 278 |
-
if "error" in result:
|
| 279 |
-
return f"❌ Erreur : {result['error']}"
|
| 280 |
-
|
| 281 |
-
projects = result.get("projects", [])
|
| 282 |
-
|
| 283 |
-
if not projects:
|
| 284 |
-
return "📁 Aucun projet trouvé dans cette équipe"
|
| 285 |
-
|
| 286 |
-
project_list = []
|
| 287 |
-
for project in projects[:10]: # Limiter à 10 projets
|
| 288 |
-
name = project.get("name", "Sans nom")
|
| 289 |
-
project_id = project.get("id", "")
|
| 290 |
-
project_list.append(f"📁 {name} (ID: {project_id})")
|
| 291 |
-
|
| 292 |
-
return f"📁 **Projets de l'équipe :**\n" + "\n".join(project_list)
|
| 293 |
-
|
| 294 |
-
def create_figjam_sticky_note(x: str, y: str, text: str, width: str = "240", height: str = "240") -> str:
|
| 295 |
-
"""Crée un post-it (sticky note) dans FigJam avec les dimensions officielles"""
|
| 296 |
-
if not figma_config["file_id"]:
|
| 297 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 298 |
-
|
| 299 |
-
try:
|
| 300 |
-
x_pos, y_pos = float(x), float(y)
|
| 301 |
-
w, h = float(width), float(height)
|
| 302 |
-
|
| 303 |
-
comment_text = f"🟡 **Sticky Note à créer (API FigJam) :**\n- Position: ({x_pos}, {y_pos})\n- Taille: {w}x{h}px (défaut: 240x240)\n- Texte: \"{text}\"\n\n📋 **Code Plugin Figma :**\n```javascript\nconst sticky = figma.createSticky()\nsticky.x = {x_pos}\nsticky.y = {y_pos}\nsticky.resize({w}, {h})\nawait figma.loadFontAsync(sticky.text.fontName)\nsticky.text.characters = '{text}'\n```"
|
| 304 |
-
|
| 305 |
-
comment_data = {
|
| 306 |
-
"message": comment_text,
|
| 307 |
-
"client_meta": {
|
| 308 |
-
"x": x_pos,
|
| 309 |
-
"y": y_pos
|
| 310 |
-
}
|
| 311 |
-
}
|
| 312 |
-
|
| 313 |
-
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 314 |
-
|
| 315 |
-
if "error" in result:
|
| 316 |
-
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 317 |
-
|
| 318 |
-
return f"✅ Instructions Sticky Note créées à ({x_pos}, {y_pos}) - Taille: {w}x{h}px"
|
| 319 |
-
|
| 320 |
-
except ValueError:
|
| 321 |
-
return "❌ Les coordonnées et dimensions doivent être des nombres"
|
| 322 |
-
|
| 323 |
-
def create_figjam_connector_between_elements(element1_name: str, element2_name: str, style: str = "solid") -> str:
|
| 324 |
-
"""Crée un connecteur entre deux éléments FigJam (officiel)"""
|
| 325 |
-
if not figma_config["file_id"]:
|
| 326 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 327 |
-
|
| 328 |
-
comment_text = f"🔗 **Connecteur FigJam à créer (API officielle) :**\n- Entre: {element1_name}\n- Et: {element2_name}\n- Style: {style}\n\n📋 **Code Plugin Figma :**\n```javascript\n// Trouver les éléments par nom\nconst element1 = figma.currentPage.findOne(n => n.name === '{element1_name}')\nconst element2 = figma.currentPage.findOne(n => n.name === '{element2_name}')\n\n// Créer le connecteur\nconst connector = figma.createConnector()\nconnector.connectorStart = {{\n endpointNodeId: element1.id,\n magnet: 'AUTO'\n}}\nconnector.connectorEnd = {{\n endpointNodeId: element2.id,\n magnet: 'AUTO'\n}}\n```"
|
| 329 |
-
|
| 330 |
-
comment_data = {
|
| 331 |
-
"message": comment_text,
|
| 332 |
-
"client_meta": {
|
| 333 |
-
"x": 0,
|
| 334 |
-
"y": 0
|
| 335 |
-
}
|
| 336 |
-
}
|
| 337 |
-
|
| 338 |
-
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 339 |
-
|
| 340 |
-
if "error" in result:
|
| 341 |
-
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 342 |
-
|
| 343 |
-
return f"✅ Instructions connecteur créées entre {element1_name} et {element2_name}"
|
| 344 |
-
|
| 345 |
-
def create_figjam_shape_with_text(x: str, y: str, shape_type: str, text: str, width: str = "208", height: str = "208") -> str:
|
| 346 |
-
"""Crée une forme avec texte intégré dans FigJam (API officielle)"""
|
| 347 |
-
if not figma_config["file_id"]:
|
| 348 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 349 |
-
|
| 350 |
-
try:
|
| 351 |
-
x_pos, y_pos = float(x), float(y)
|
| 352 |
-
w, h = float(width), float(height)
|
| 353 |
-
|
| 354 |
-
# Types de formes supportés par l'API Figma
|
| 355 |
-
supported_shapes = {
|
| 356 |
-
"rectangle": "ROUNDED_RECTANGLE",
|
| 357 |
-
"circle": "ELLIPSE",
|
| 358 |
-
"triangle": "TRIANGLE",
|
| 359 |
-
"diamond": "DIAMOND",
|
| 360 |
-
"star": "STAR",
|
| 361 |
-
"hexagon": "HEXAGON"
|
| 362 |
-
}
|
| 363 |
-
|
| 364 |
-
figma_shape = supported_shapes.get(shape_type.lower(), "ROUNDED_RECTANGLE")
|
| 365 |
-
|
| 366 |
-
comment_text = f"🔶 **Forme avec texte FigJam (API officielle) :**\n- Position: ({x_pos}, {y_pos})\n- Type: {shape_type} → {figma_shape}\n- Taille: {w}x{h}px (défaut: 208x208)\n- Texte: \"{text}\"\n\n📋 **Code Plugin Figma :**\n```javascript\nconst shape = figma.createShapeWithText()\nshape.x = {x_pos}\nshape.y = {y_pos}\nshape.resize({w}, {h})\nshape.shapeType = '{figma_shape}'\nawait figma.loadFontAsync(shape.text.fontName)\nshape.text.characters = '{text}'\n```"
|
| 367 |
-
|
| 368 |
-
comment_data = {
|
| 369 |
-
"message": comment_text,
|
| 370 |
-
"client_meta": {
|
| 371 |
-
"x": x_pos,
|
| 372 |
-
"y": y_pos
|
| 373 |
-
}
|
| 374 |
-
}
|
| 375 |
-
|
| 376 |
-
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 377 |
-
|
| 378 |
-
if "error" in result:
|
| 379 |
-
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 380 |
-
|
| 381 |
-
return f"✅ Instructions forme {shape_type} avec texte créées à ({x_pos}, {y_pos})"
|
| 382 |
-
|
| 383 |
-
except ValueError:
|
| 384 |
-
return "❌ Les coordonnées et dimensions doivent être des nombres"
|
| 385 |
-
|
| 386 |
-
def create_figjam_table(rows: str, columns: str, x: str = "0", y: str = "0") -> str:
|
| 387 |
-
"""Crée un tableau dans FigJam (API officielle)"""
|
| 388 |
-
if not figma_config["file_id"]:
|
| 389 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 390 |
-
|
| 391 |
-
try:
|
| 392 |
-
num_rows, num_cols = int(rows), int(columns)
|
| 393 |
-
x_pos, y_pos = float(x), float(y)
|
| 394 |
-
|
| 395 |
-
comment_text = f"📊 **Tableau FigJam (API officielle) :**\n- Position: ({x_pos}, {y_pos})\n- Dimensions: {num_rows} lignes × {num_cols} colonnes\n\n📋 **Code Plugin Figma :**\n```javascript\nconst table = figma.createTable({num_rows}, {num_cols})\ntable.x = {x_pos}\ntable.y = {y_pos}\n\n// Exemple: ajouter du texte dans les cellules\nawait figma.loadFontAsync(table.cellAt(0, 0).text.fontName)\ntable.cellAt(0, 0).text.characters = 'Titre 1'\ntable.cellAt(0, 1).text.characters = 'Titre 2'\n```"
|
| 396 |
-
|
| 397 |
-
comment_data = {
|
| 398 |
-
"message": comment_text,
|
| 399 |
-
"client_meta": {
|
| 400 |
-
"x": x_pos,
|
| 401 |
-
"y": y_pos
|
| 402 |
-
}
|
| 403 |
-
}
|
| 404 |
-
|
| 405 |
-
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 406 |
-
|
| 407 |
-
if "error" in result:
|
| 408 |
-
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 409 |
-
|
| 410 |
-
return f"✅ Instructions tableau {num_rows}×{num_cols} créées à ({x_pos}, {y_pos})"
|
| 411 |
-
|
| 412 |
-
except ValueError:
|
| 413 |
-
return "❌ Les dimensions et coordonnées doivent être des nombres"
|
| 414 |
-
|
| 415 |
-
def create_figjam_code_block(x: str, y: str, code: str, language: str = "javascript") -> str:
|
| 416 |
-
"""Crée un bloc de code dans FigJam (API officielle)"""
|
| 417 |
-
if not figma_config["file_id"]:
|
| 418 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 419 |
-
|
| 420 |
-
try:
|
| 421 |
-
x_pos, y_pos = float(x), float(y)
|
| 422 |
-
|
| 423 |
-
# Échapper les caractères spéciaux pour l'affichage
|
| 424 |
-
escaped_code = code.replace('\\', '\\\\').replace('"', '\\"').replace('\n', '\\n')
|
| 425 |
-
|
| 426 |
-
comment_text = f"💻 **Bloc de code FigJam (API officielle) :**\n- Position: ({x_pos}, {y_pos})\n- Langage: {language}\n- Code: \"{code[:100]}{'...' if len(code) > 100 else ''}\"\n\n📋 **Code Plugin Figma :**\n```javascript\nconst codeBlock = figma.createCodeBlock()\ncodeBlock.x = {x_pos}\ncodeBlock.y = {y_pos}\nawait figma.loadFontAsync(codeBlock.codeBlockText.fontName)\ncodeBlock.codeBlockText.characters = \"{escaped_code}\"\n```"
|
| 427 |
-
|
| 428 |
-
comment_data = {
|
| 429 |
-
"message": comment_text,
|
| 430 |
-
"client_meta": {
|
| 431 |
-
"x": x_pos,
|
| 432 |
-
"y": y_pos
|
| 433 |
-
}
|
| 434 |
-
}
|
| 435 |
-
|
| 436 |
-
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 437 |
-
|
| 438 |
-
if "error" in result:
|
| 439 |
-
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 440 |
-
|
| 441 |
-
return f"✅ Instructions bloc de code {language} créées à ({x_pos}, {y_pos})"
|
| 442 |
-
|
| 443 |
-
except ValueError:
|
| 444 |
-
return "❌ Les coordonnées doivent être des nombres"
|
| 445 |
-
|
| 446 |
-
def create_figjam_background_shape(x: str, y: str, width: str, height: str, color: str = "#F3F4F6", title: str = "", corner_radius: str = "8") -> str:
|
| 447 |
-
"""Crée une forme de fond rectangulaire pour organiser le contenu FigJam"""
|
| 448 |
-
if not figma_config["file_id"]:
|
| 449 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 450 |
-
|
| 451 |
-
try:
|
| 452 |
-
x_pos, y_pos = float(x), float(y)
|
| 453 |
-
w, h = float(width), float(height)
|
| 454 |
-
radius = float(corner_radius)
|
| 455 |
-
|
| 456 |
-
comment_text = f"📐 **Forme de fond FigJam (zone de travail) :**\n- Position: ({x_pos}, {y_pos})\n- Taille: {w}x{h}px\n- Couleur: {color}\n- Titre: \"{title}\"\n- Rayon coins: {radius}px\n\n📋 **Code Plugin Figma :**\n```javascript\n// Créer la forme de fond\nconst background = figma.createRectangle()\nbackground.x = {x_pos}\nbackground.y = {y_pos}\nbackground.resize({w}, {h})\nbackground.cornerRadius = {radius}\nbackground.fills = [{{\n type: 'SOLID',\n color: {{ r: 0.95, g: 0.96, b: 0.97 }} // {color}\n}}]\nbackground.name = 'Zone - {title}'\n\n// Optionnel: ajouter un titre\nif ('{title}') {{\n const titleText = figma.createText()\n titleText.x = {x_pos + 16}\n titleText.y = {y_pos + 16}\n await figma.loadFontAsync(titleText.fontName)\n titleText.characters = '{title}'\n titleText.fontSize = 18\n}}\n```"
|
| 457 |
-
|
| 458 |
-
comment_data = {
|
| 459 |
-
"message": comment_text,
|
| 460 |
-
"client_meta": {
|
| 461 |
-
"x": x_pos,
|
| 462 |
-
"y": y_pos
|
| 463 |
-
}
|
| 464 |
-
}
|
| 465 |
-
|
| 466 |
-
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 467 |
-
|
| 468 |
-
if "error" in result:
|
| 469 |
-
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 470 |
-
|
| 471 |
-
return f"✅ Zone de travail \"{title}\" créée à ({x_pos}, {y_pos}) - {w}x{h}px"
|
| 472 |
-
|
| 473 |
-
except ValueError:
|
| 474 |
-
return "❌ Les coordonnées et dimensions doivent être des nombres"
|
| 475 |
-
|
| 476 |
-
def create_figjam_sticker(x: str, y: str, sticker_type: str, size: str = "40") -> str:
|
| 477 |
-
"""Crée un sticker/emoji dans FigJam pour les réactions et annotations"""
|
| 478 |
-
if not figma_config["file_id"]:
|
| 479 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 480 |
-
|
| 481 |
-
try:
|
| 482 |
-
x_pos, y_pos = float(x), float(y)
|
| 483 |
-
sticker_size = float(size)
|
| 484 |
-
|
| 485 |
-
# Mapping des stickers populaires
|
| 486 |
-
stickers = {
|
| 487 |
-
"thumbs_up": "👍",
|
| 488 |
-
"thumbs_down": "👎",
|
| 489 |
-
"heart": "❤️",
|
| 490 |
-
"star": "⭐",
|
| 491 |
-
"fire": "🔥",
|
| 492 |
-
"rocket": "🚀",
|
| 493 |
-
"bulb": "💡",
|
| 494 |
-
"warning": "⚠️",
|
| 495 |
-
"check": "✅",
|
| 496 |
-
"cross": "❌",
|
| 497 |
-
"question": "❓",
|
| 498 |
-
"idea": "💭",
|
| 499 |
-
"clock": "⏰",
|
| 500 |
-
"money": "💰",
|
| 501 |
-
"target": "🎯",
|
| 502 |
-
"celebrate": "🎉",
|
| 503 |
-
"thinking": "🤔",
|
| 504 |
-
"confused": "😕"
|
| 505 |
-
}
|
| 506 |
-
|
| 507 |
-
emoji = stickers.get(sticker_type.lower(), sticker_type)
|
| 508 |
-
|
| 509 |
-
comment_text = f"🎭 **Sticker FigJam :**\n- Position: ({x_pos}, {y_pos})\n- Type: {sticker_type} → {emoji}\n- Taille: {sticker_size}px\n\n📋 **Code Plugin Figma :**\n```javascript\n// Créer un sticker comme texte stylisé\nconst sticker = figma.createText()\nsticker.x = {x_pos}\nsticker.y = {y_pos}\nsticker.resize({sticker_size}, {sticker_size})\nawait figma.loadFontAsync({{ family: 'Inter', style: 'Regular' }})\nsticker.characters = '{emoji}'\nsticker.fontSize = {sticker_size}\nsticker.textAlignHorizontal = 'CENTER'\nsticker.textAlignVertical = 'CENTER'\nsticker.name = 'Sticker - {sticker_type}'\n```"
|
| 510 |
-
|
| 511 |
-
comment_data = {
|
| 512 |
-
"message": comment_text,
|
| 513 |
-
"client_meta": {
|
| 514 |
-
"x": x_pos,
|
| 515 |
-
"y": y_pos
|
| 516 |
-
}
|
| 517 |
-
}
|
| 518 |
-
|
| 519 |
-
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 520 |
-
|
| 521 |
-
if "error" in result:
|
| 522 |
-
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 523 |
-
|
| 524 |
-
return f"✅ Sticker {emoji} créé à ({x_pos}, {y_pos}) - Taille: {sticker_size}px"
|
| 525 |
-
|
| 526 |
-
except ValueError:
|
| 527 |
-
return "❌ Les coordonnées et la taille doivent être des nombres"
|
| 528 |
-
|
| 529 |
-
def create_figjam_workshop_template(template_type: str, x: str = "0", y: str = "0") -> str:
|
| 530 |
-
"""Crée des templates d'atelier FigJam prêts à utiliser"""
|
| 531 |
-
if not figma_config["file_id"]:
|
| 532 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 533 |
-
|
| 534 |
-
try:
|
| 535 |
-
x_pos, y_pos = float(x), float(y)
|
| 536 |
-
|
| 537 |
-
templates = {
|
| 538 |
-
"retrospective": {
|
| 539 |
-
"title": "Rétrospective Sprint",
|
| 540 |
-
"zones": [
|
| 541 |
-
{"title": "😊 Ce qui s'est bien passé", "x": 0, "y": 100, "width": 300, "height": 400, "color": "#D1FAE5"},
|
| 542 |
-
{"title": "😐 Ce qui peut être amélioré", "x": 320, "y": 100, "width": 300, "height": 400, "color": "#FEF3C7"},
|
| 543 |
-
{"title": "🚀 Actions à prendre", "x": 640, "y": 100, "width": 300, "height": 400, "color": "#DBEAFE"}
|
| 544 |
-
]
|
| 545 |
-
},
|
| 546 |
-
"brainstorm": {
|
| 547 |
-
"title": "Session Brainstorming",
|
| 548 |
-
"zones": [
|
| 549 |
-
{"title": "🎯 Objectif", "x": 0, "y": 100, "width": 960, "height": 120, "color": "#F3E8FF"},
|
| 550 |
-
{"title": "💡 Idées", "x": 0, "y": 240, "width": 480, "height": 400, "color": "#FEF3C7"},
|
| 551 |
-
{"title": "⭐ Meilleures idées", "x": 500, "y": 240, "width": 460, "height": 400, "color": "#D1FAE5"}
|
| 552 |
-
]
|
| 553 |
-
},
|
| 554 |
-
"user_journey": {
|
| 555 |
-
"title": "Parcours Utilisateur",
|
| 556 |
-
"zones": [
|
| 557 |
-
{"title": "👤 Persona", "x": 0, "y": 100, "width": 200, "height": 300, "color": "#F3E8FF"},
|
| 558 |
-
{"title": "🎯 Découverte", "x": 220, "y": 100, "width": 180, "height": 300, "color": "#DBEAFE"},
|
| 559 |
-
{"title": "🔍 Exploration", "x": 420, "y": 100, "width": 180, "height": 300, "color": "#FEF3C7"},
|
| 560 |
-
{"title": "✅ Conversion", "x": 620, "y": 100, "width": 180, "height": 300, "color": "#D1FAE5"},
|
| 561 |
-
{"title": "💝 Fidélisation", "x": 820, "y": 100, "width": 180, "height": 300, "color": "#FECACA"}
|
| 562 |
-
]
|
| 563 |
-
}
|
| 564 |
-
}
|
| 565 |
-
|
| 566 |
-
template = templates.get(template_type.lower())
|
| 567 |
-
|
| 568 |
-
if not template:
|
| 569 |
-
available = ", ".join(templates.keys())
|
| 570 |
-
return f"❌ Template non trouvé. Disponibles: {available}"
|
| 571 |
-
|
| 572 |
-
# Générer le code pour créer le template complet
|
| 573 |
-
zones_code = []
|
| 574 |
-
for i, zone in enumerate(template["zones"]):
|
| 575 |
-
zone_x = x_pos + zone["x"]
|
| 576 |
-
zone_y = y_pos + zone["y"]
|
| 577 |
-
zones_code.append(f"""
|
| 578 |
-
// Zone {i+1}: {zone['title']}
|
| 579 |
-
const zone{i+1} = figma.createRectangle()
|
| 580 |
-
zone{i+1}.x = {zone_x}
|
| 581 |
-
zone{i+1}.y = {zone_y}
|
| 582 |
-
zone{i+1}.resize({zone['width']}, {zone['height']})
|
| 583 |
-
zone{i+1}.cornerRadius = 8
|
| 584 |
-
zone{i+1}.fills = [{{ type: 'SOLID', color: {{ r: 0.95, g: 0.96, b: 0.97 }} }}]
|
| 585 |
-
zone{i+1}.name = '{zone['title']}'
|
| 586 |
-
|
| 587 |
-
const title{i+1} = figma.createText()
|
| 588 |
-
title{i+1}.x = {zone_x + 16}
|
| 589 |
-
title{i+1}.y = {zone_y + 16}
|
| 590 |
-
await figma.loadFontAsync(title{i+1}.fontName)
|
| 591 |
-
title{i+1}.characters = '{zone['title']}'
|
| 592 |
-
title{i+1}.fontSize = 16""")
|
| 593 |
-
|
| 594 |
-
comment_text = f"🏗️ **Template FigJam: {template['title']} :**\n- Position: ({x_pos}, {y_pos})\n- {len(template['zones'])} zones de travail\n\n📋 **Code Plugin Figma :**\n```javascript\n// Template: {template['title']}{''.join(zones_code)}\n```"
|
| 595 |
-
|
| 596 |
-
comment_data = {
|
| 597 |
-
"message": comment_text,
|
| 598 |
-
"client_meta": {
|
| 599 |
-
"x": x_pos,
|
| 600 |
-
"y": y_pos
|
| 601 |
-
}
|
| 602 |
-
}
|
| 603 |
-
|
| 604 |
-
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 605 |
-
|
| 606 |
-
if "error" in result:
|
| 607 |
-
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 608 |
-
|
| 609 |
-
return f"✅ Template \"{template['title']}\" créé avec {len(template['zones'])} zones à ({x_pos}, {y_pos})"
|
| 610 |
-
|
| 611 |
-
except ValueError:
|
| 612 |
-
return "❌ Les coordonnées doivent être des nombres"
|
| 613 |
-
|
| 614 |
-
def create_figjam_organized_zone(title: str, x: str, y: str, width: str = "400", height: str = "500", max_stickies: str = "12") -> str:
|
| 615 |
-
"""Crée une zone organisée avec grille pour post-its dans FigJam"""
|
| 616 |
-
if not figma_config["file_id"]:
|
| 617 |
-
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 618 |
-
|
| 619 |
-
try:
|
| 620 |
-
x_pos, y_pos = float(x), float(y)
|
| 621 |
-
w, h = float(width), float(height)
|
| 622 |
-
max_notes = int(max_stickies)
|
| 623 |
-
|
| 624 |
-
# Calculer la grille optimale
|
| 625 |
-
cols = 3 if max_notes <= 9 else 4
|
| 626 |
-
rows = (max_notes + cols - 1) // cols # Division avec arrondi vers le haut
|
| 627 |
-
|
| 628 |
-
sticky_width = (w - 80) // cols # 80px de marge totale
|
| 629 |
-
sticky_height = 120 # Hauteur standard d'un post-it
|
| 630 |
-
|
| 631 |
-
comment_text = f"📋 **Zone organisée FigJam :**\n- Titre: \"{title}\"\n- Position: ({x_pos}, {y_pos})\n- Taille: {w}x{h}px\n- Grille: {cols}×{rows} ({max_notes} post-its max)\n\n📋 **Code Plugin Figma :**\n```javascript\n// Zone de fond\nconst zone = figma.createRectangle()\nzone.x = {x_pos}\nzone.y = {y_pos}\nzone.resize({w}, {h})\nzone.cornerRadius = 12\nzone.fills = [{{ type: 'SOLID', color: {{ r: 0.98, g: 0.98, b: 0.99 }} }}]\nzone.strokes = [{{ type: 'SOLID', color: {{ r: 0.9, g: 0.9, b: 0.92 }} }}]\nzone.strokeWeight = 2\nzone.name = 'Zone - {title}'\n\n// Titre\nconst titleText = figma.createText()\ntitleText.x = {x_pos + 20}\ntitleText.y = {y_pos + 20}\nawait figma.loadFontAsync(titleText.fontName)\ntitleText.characters = '{title}'\ntitleText.fontSize = 20\ntitleText.fontName = {{ family: 'Inter', style: 'Bold' }}\n\n// Grille de post-its exemple\nfor (let row = 0; row < {rows}; row++) {{\n for (let col = 0; col < {cols}; col++) {{\n const index = row * {cols} + col\n if (index >= {max_notes}) break\n \n const sticky = figma.createSticky()\n sticky.x = {x_pos + 20} + col * ({sticky_width} + 10)\n sticky.y = {y_pos + 70} + row * ({sticky_height} + 10)\n sticky.resize({sticky_width}, {sticky_height})\n await figma.loadFontAsync(sticky.text.fontName)\n sticky.text.characters = `Idée ${{index + 1}}`\n sticky.name = `Sticky ${{index + 1}}`\n }}\n}}\n```"
|
| 632 |
-
|
| 633 |
-
comment_data = {
|
| 634 |
-
"message": comment_text,
|
| 635 |
-
"client_meta": {
|
| 636 |
-
"x": x_pos,
|
| 637 |
-
"y": y_pos
|
| 638 |
-
}
|
| 639 |
-
}
|
| 640 |
-
|
| 641 |
-
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 642 |
-
|
| 643 |
-
if "error" in result:
|
| 644 |
-
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 645 |
-
|
| 646 |
-
return f"✅ Zone organisée \"{title}\" créée avec grille {cols}×{rows} pour {max_notes} post-its"
|
| 647 |
-
|
| 648 |
-
except ValueError:
|
| 649 |
-
return "❌ Les coordonnées et dimensions doivent être des nombres"
|
| 650 |
-
|
| 651 |
# === CONFIGURATION DE L'APPLICATION GRADIO ===
|
| 652 |
|
| 653 |
def setup_demo():
|
|
@@ -663,6 +33,21 @@ def setup_demo():
|
|
| 663 |
def test_user():
|
| 664 |
return get_figma_user_info()
|
| 665 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 666 |
with gr.Blocks(
|
| 667 |
title="🎨 Figma MCP Server",
|
| 668 |
theme=gr.themes.Soft(),
|
|
@@ -721,6 +106,18 @@ def setup_demo():
|
|
| 721 |
test_comments_btn = gr.Button("📝 Commentaires")
|
| 722 |
test_user_btn = gr.Button("👤 Info Utilisateur")
|
| 723 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 724 |
# Connexions des événements
|
| 725 |
token_btn.click(
|
| 726 |
configure_figma_token,
|
|
@@ -748,6 +145,31 @@ def setup_demo():
|
|
| 748 |
test_user,
|
| 749 |
outputs=[status_output]
|
| 750 |
)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 751 |
|
| 752 |
gr.Markdown("""
|
| 753 |
---
|
|
@@ -762,6 +184,15 @@ def setup_demo():
|
|
| 762 |
- `get_figma_comments()` - Récupère les commentaires
|
| 763 |
- `get_figma_user_info()` - Info utilisateur connecté
|
| 764 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 765 |
**🎨 Création d'éléments de base (Figma Design) :**
|
| 766 |
- `create_figma_rectangle(x, y, width, height, name, color)` - Crée un rectangle
|
| 767 |
- `create_figma_frame(x, y, width, height, name)` - Crée un frame
|
|
@@ -794,6 +225,53 @@ def setup_demo():
|
|
| 794 |
4. Ajouter des stickers pour les réactions avec `create_figjam_sticker()`
|
| 795 |
|
| 796 |
**✨ Toutes les fonctions génèrent du code JavaScript prêt à utiliser dans un plugin Figma !**
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 797 |
""")
|
| 798 |
|
| 799 |
return demo
|
|
|
|
| 7 |
import asyncio
|
| 8 |
import json
|
| 9 |
import logging
|
|
|
|
|
|
|
| 10 |
from PIL import Image
|
| 11 |
import base64
|
| 12 |
import io
|
| 13 |
|
| 14 |
+
# Import de tous les outils MCP depuis le dossier tools
|
| 15 |
+
from tools import *
|
| 16 |
+
|
| 17 |
# Configuration du logging
|
| 18 |
logging.basicConfig(level=logging.INFO)
|
| 19 |
logger = logging.getLogger(__name__)
|
| 20 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 21 |
# === CONFIGURATION DE L'APPLICATION GRADIO ===
|
| 22 |
|
| 23 |
def setup_demo():
|
|
|
|
| 33 |
def test_user():
|
| 34 |
return get_figma_user_info()
|
| 35 |
|
| 36 |
+
def test_user_detailed():
|
| 37 |
+
return get_figma_user_detailed_info()
|
| 38 |
+
|
| 39 |
+
def test_user_teams():
|
| 40 |
+
return list_figma_user_teams()
|
| 41 |
+
|
| 42 |
+
def test_user_permissions():
|
| 43 |
+
return get_figma_current_user_permissions()
|
| 44 |
+
|
| 45 |
+
def test_workspace_stats():
|
| 46 |
+
return get_figma_workspace_usage_stats()
|
| 47 |
+
|
| 48 |
+
def test_api_limitations():
|
| 49 |
+
return get_figma_api_limitations_info()
|
| 50 |
+
|
| 51 |
with gr.Blocks(
|
| 52 |
title="🎨 Figma MCP Server",
|
| 53 |
theme=gr.themes.Soft(),
|
|
|
|
| 106 |
test_comments_btn = gr.Button("📝 Commentaires")
|
| 107 |
test_user_btn = gr.Button("👤 Info Utilisateur")
|
| 108 |
|
| 109 |
+
# Nouveaux boutons pour les infos utilisateur détaillées
|
| 110 |
+
with gr.Row():
|
| 111 |
+
test_user_detailed_btn = gr.Button("👤 Profil Détaillé")
|
| 112 |
+
test_teams_btn = gr.Button("🏢 Mes Équipes")
|
| 113 |
+
test_permissions_btn = gr.Button("🔐 Permissions")
|
| 114 |
+
|
| 115 |
+
with gr.Row():
|
| 116 |
+
test_stats_btn = gr.Button("📊 Stats Workspace")
|
| 117 |
+
|
| 118 |
+
with gr.Row():
|
| 119 |
+
test_limitations_btn = gr.Button("📚 Limitations API")
|
| 120 |
+
|
| 121 |
# Connexions des événements
|
| 122 |
token_btn.click(
|
| 123 |
configure_figma_token,
|
|
|
|
| 145 |
test_user,
|
| 146 |
outputs=[status_output]
|
| 147 |
)
|
| 148 |
+
|
| 149 |
+
test_user_detailed_btn.click(
|
| 150 |
+
test_user_detailed,
|
| 151 |
+
outputs=[status_output]
|
| 152 |
+
)
|
| 153 |
+
|
| 154 |
+
test_teams_btn.click(
|
| 155 |
+
test_user_teams,
|
| 156 |
+
outputs=[status_output]
|
| 157 |
+
)
|
| 158 |
+
|
| 159 |
+
test_permissions_btn.click(
|
| 160 |
+
test_user_permissions,
|
| 161 |
+
outputs=[status_output]
|
| 162 |
+
)
|
| 163 |
+
|
| 164 |
+
test_stats_btn.click(
|
| 165 |
+
test_workspace_stats,
|
| 166 |
+
outputs=[status_output]
|
| 167 |
+
)
|
| 168 |
+
|
| 169 |
+
test_limitations_btn.click(
|
| 170 |
+
test_api_limitations,
|
| 171 |
+
outputs=[status_output]
|
| 172 |
+
)
|
| 173 |
|
| 174 |
gr.Markdown("""
|
| 175 |
---
|
|
|
|
| 184 |
- `get_figma_comments()` - Récupère les commentaires
|
| 185 |
- `get_figma_user_info()` - Info utilisateur connecté
|
| 186 |
|
| 187 |
+
**👤 Compte utilisateur et équipe :**
|
| 188 |
+
- `get_figma_user_detailed_info()` - Informations détaillées de l'utilisateur (profil complet)
|
| 189 |
+
- `list_figma_user_teams()` - Liste toutes les équipes de l'utilisateur avec rôles et plans
|
| 190 |
+
- `get_figma_team_info(team_id)` - Infos détaillées d'une équipe (plan, limites, stockage)
|
| 191 |
+
- `get_figma_current_user_permissions()` - Permissions dans le fichier actuel (via Plugin API)
|
| 192 |
+
- `get_figma_workspace_usage_stats()` - Statistiques d'utilisation de l'espace de travail
|
| 193 |
+
- `list_figma_team_projects(team_id)` - Projets d'une équipe
|
| 194 |
+
- `get_figma_api_limitations_info()` - Explique les limitations API Plugin vs REST
|
| 195 |
+
|
| 196 |
**🎨 Création d'éléments de base (Figma Design) :**
|
| 197 |
- `create_figma_rectangle(x, y, width, height, name, color)` - Crée un rectangle
|
| 198 |
- `create_figma_frame(x, y, width, height, name)` - Crée un frame
|
|
|
|
| 225 |
4. Ajouter des stickers pour les réactions avec `create_figjam_sticker()`
|
| 226 |
|
| 227 |
**✨ Toutes les fonctions génèrent du code JavaScript prêt à utiliser dans un plugin Figma !**
|
| 228 |
+
|
| 229 |
+
---
|
| 230 |
+
|
| 231 |
+
## 🔍 **Informations du compte utilisateur disponibles :**
|
| 232 |
+
|
| 233 |
+
### **Via l'API REST Figma :**
|
| 234 |
+
- **Profil utilisateur** : ID, nom d'utilisateur, email, photo de profil
|
| 235 |
+
- **Équipes** : Liste des équipes, rôles, plans d'abonnement
|
| 236 |
+
- **Informations équipe** : Plan (Starter/Pro/Org), limites d'éditeurs, stockage utilisé
|
| 237 |
+
- **Projets** : Accès aux projets de l'équipe, statistiques d'utilisation
|
| 238 |
+
|
| 239 |
+
### **Via le Plugin API (dans les plugins Figma) :**
|
| 240 |
+
- **Utilisateur actuel** : `figma.currentUser` (nom, email, couleur, session)
|
| 241 |
+
- **Utilisateurs actifs** : `figma.activeUsers` (FigJam uniquement)
|
| 242 |
+
- **Contexte** : Type d'éditeur, mode du plugin, clé du fichier
|
| 243 |
+
- **Permissions** : Accès aux fonctionnalités selon les droits
|
| 244 |
+
|
| 245 |
+
### **Plans d'abonnement détectables :**
|
| 246 |
+
- **Starter** : 3 pages max, fonctionnalités limitées
|
| 247 |
+
- **Professional** : Pages illimitées, fonctionnalités avancées
|
| 248 |
+
- **Organization** : Gestion d'équipe, contrôles admin
|
| 249 |
+
- **Education** : Fonctionnalités spéciales pour l'éducation
|
| 250 |
+
|
| 251 |
+
**💡 Note :** Certaines informations nécessitent des permissions spéciales ou des plugins privés.
|
| 252 |
+
|
| 253 |
+
---
|
| 254 |
+
|
| 255 |
+
## ⚠️ **Limitation importante : Lister les projets**
|
| 256 |
+
|
| 257 |
+
**🚫 L'API Plugin Figma ne peut PAS lister les projets !**
|
| 258 |
+
|
| 259 |
+
Selon la documentation officielle Context7 MCP :
|
| 260 |
+
- L'API Plugin s'exécute uniquement dans le contexte du fichier actuel
|
| 261 |
+
- Aucune fonction `figma.listProjects()` ou équivalent n'existe
|
| 262 |
+
- Pas d'accès aux informations de navigation entre fichiers
|
| 263 |
+
|
| 264 |
+
**✅ Solution : Notre serveur MCP utilise l'API REST**
|
| 265 |
+
- `list_figma_user_teams()` - Via `GET /teams`
|
| 266 |
+
- `list_figma_team_projects(team_id)` - Via `GET /teams/{team_id}/projects`
|
| 267 |
+
- `get_figma_file_info()` - Via `GET /files/{file_id}`
|
| 268 |
+
|
| 269 |
+
**💡 Approche hybride recommandée :**
|
| 270 |
+
1. **API REST** : Navigation, projets, informations utilisateur
|
| 271 |
+
2. **Plugin API** : Création/modification dans le fichier actuel
|
| 272 |
+
3. **Code JavaScript** : Manipulation avancée des objets
|
| 273 |
+
|
| 274 |
+
Utilisez `get_figma_api_limitations_info()` pour plus de détails !
|
| 275 |
""")
|
| 276 |
|
| 277 |
return demo
|
tools/__init__.py
ADDED
|
@@ -0,0 +1,86 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
"""
|
| 2 |
+
🎨 Figma MCP Tools - Outils organisés par catégorie
|
| 3 |
+
"""
|
| 4 |
+
|
| 5 |
+
# Import de la configuration
|
| 6 |
+
from .config import figma_config, make_figma_request
|
| 7 |
+
|
| 8 |
+
# Import des outils de configuration
|
| 9 |
+
from .config import configure_figma_token, configure_figma_file_id
|
| 10 |
+
|
| 11 |
+
# Import des outils de navigation
|
| 12 |
+
from .navigation import (
|
| 13 |
+
get_figma_file_info,
|
| 14 |
+
get_figma_comments,
|
| 15 |
+
get_figma_user_info
|
| 16 |
+
)
|
| 17 |
+
|
| 18 |
+
# Import des outils de compte utilisateur
|
| 19 |
+
from .user_account import (
|
| 20 |
+
get_figma_user_detailed_info,
|
| 21 |
+
list_figma_user_teams,
|
| 22 |
+
get_figma_team_info,
|
| 23 |
+
get_figma_current_user_permissions,
|
| 24 |
+
get_figma_workspace_usage_stats,
|
| 25 |
+
get_figma_api_limitations_info,
|
| 26 |
+
list_figma_team_projects
|
| 27 |
+
)
|
| 28 |
+
|
| 29 |
+
# Import des outils Figma Design
|
| 30 |
+
from .figma_design import (
|
| 31 |
+
create_figma_rectangle,
|
| 32 |
+
create_figma_frame,
|
| 33 |
+
create_figma_text
|
| 34 |
+
)
|
| 35 |
+
|
| 36 |
+
# Import des outils FigJam
|
| 37 |
+
from .figjam import (
|
| 38 |
+
create_figjam_sticky_note,
|
| 39 |
+
create_figjam_connector_between_elements,
|
| 40 |
+
create_figjam_shape_with_text,
|
| 41 |
+
create_figjam_table,
|
| 42 |
+
create_figjam_code_block,
|
| 43 |
+
create_figjam_background_shape,
|
| 44 |
+
create_figjam_sticker,
|
| 45 |
+
create_figjam_workshop_template,
|
| 46 |
+
create_figjam_organized_zone
|
| 47 |
+
)
|
| 48 |
+
|
| 49 |
+
# Liste de tous les outils disponibles pour l'export
|
| 50 |
+
__all__ = [
|
| 51 |
+
# Configuration
|
| 52 |
+
'figma_config',
|
| 53 |
+
'make_figma_request',
|
| 54 |
+
'configure_figma_token',
|
| 55 |
+
'configure_figma_file_id',
|
| 56 |
+
|
| 57 |
+
# Navigation
|
| 58 |
+
'get_figma_file_info',
|
| 59 |
+
'get_figma_comments',
|
| 60 |
+
'get_figma_user_info',
|
| 61 |
+
|
| 62 |
+
# Compte utilisateur
|
| 63 |
+
'get_figma_user_detailed_info',
|
| 64 |
+
'list_figma_user_teams',
|
| 65 |
+
'get_figma_team_info',
|
| 66 |
+
'get_figma_current_user_permissions',
|
| 67 |
+
'get_figma_workspace_usage_stats',
|
| 68 |
+
'get_figma_api_limitations_info',
|
| 69 |
+
'list_figma_team_projects',
|
| 70 |
+
|
| 71 |
+
# Figma Design
|
| 72 |
+
'create_figma_rectangle',
|
| 73 |
+
'create_figma_frame',
|
| 74 |
+
'create_figma_text',
|
| 75 |
+
|
| 76 |
+
# FigJam
|
| 77 |
+
'create_figjam_sticky_note',
|
| 78 |
+
'create_figjam_connector_between_elements',
|
| 79 |
+
'create_figjam_shape_with_text',
|
| 80 |
+
'create_figjam_table',
|
| 81 |
+
'create_figjam_code_block',
|
| 82 |
+
'create_figjam_background_shape',
|
| 83 |
+
'create_figjam_sticker',
|
| 84 |
+
'create_figjam_workshop_template',
|
| 85 |
+
'create_figjam_organized_zone'
|
| 86 |
+
]
|
tools/config.py
ADDED
|
@@ -0,0 +1,102 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
"""
|
| 2 |
+
🔧 Configuration et utilitaires pour les outils Figma MCP
|
| 3 |
+
"""
|
| 4 |
+
import requests
|
| 5 |
+
import logging
|
| 6 |
+
from typing import Dict, Any
|
| 7 |
+
|
| 8 |
+
# Configuration du logging
|
| 9 |
+
logger = logging.getLogger(__name__)
|
| 10 |
+
|
| 11 |
+
# Configuration Figma API
|
| 12 |
+
FIGMA_API_BASE = "https://api.figma.com/v1"
|
| 13 |
+
|
| 14 |
+
# Variables globales pour stocker la configuration
|
| 15 |
+
figma_config = {
|
| 16 |
+
"token": None,
|
| 17 |
+
"file_id": None,
|
| 18 |
+
"team_id": None
|
| 19 |
+
}
|
| 20 |
+
|
| 21 |
+
def make_figma_request(endpoint: str, method: str = "GET", data: Dict = None) -> Dict[str, Any]:
|
| 22 |
+
"""Effectue une requête à l'API Figma"""
|
| 23 |
+
if not figma_config["token"]:
|
| 24 |
+
return {"error": "Token Figma non configuré"}
|
| 25 |
+
|
| 26 |
+
headers = {
|
| 27 |
+
"X-Figma-Token": figma_config["token"],
|
| 28 |
+
"Content-Type": "application/json"
|
| 29 |
+
}
|
| 30 |
+
|
| 31 |
+
url = f"{FIGMA_API_BASE}/{endpoint}"
|
| 32 |
+
|
| 33 |
+
try:
|
| 34 |
+
if method == "GET":
|
| 35 |
+
response = requests.get(url, headers=headers, timeout=30)
|
| 36 |
+
elif method == "POST":
|
| 37 |
+
response = requests.post(url, headers=headers, json=data, timeout=30)
|
| 38 |
+
elif method == "PUT":
|
| 39 |
+
response = requests.put(url, headers=headers, json=data, timeout=30)
|
| 40 |
+
elif method == "DELETE":
|
| 41 |
+
response = requests.delete(url, headers=headers, timeout=30)
|
| 42 |
+
else:
|
| 43 |
+
return {"error": f"Méthode HTTP non supportée : {method}"}
|
| 44 |
+
|
| 45 |
+
if response.status_code in [200, 201]:
|
| 46 |
+
return response.json()
|
| 47 |
+
else:
|
| 48 |
+
return {"error": f"Erreur API {response.status_code}: {response.text}"}
|
| 49 |
+
|
| 50 |
+
except Exception as e:
|
| 51 |
+
return {"error": f"Erreur de requête : {str(e)}"}
|
| 52 |
+
|
| 53 |
+
def configure_figma_token(token: str) -> str:
|
| 54 |
+
"""Configure le token d'accès Figma"""
|
| 55 |
+
global figma_config
|
| 56 |
+
|
| 57 |
+
if not token or not token.startswith(('figd_', 'figc_')):
|
| 58 |
+
return "❌ Token invalide. Le token doit commencer par 'figd_' ou 'figc_'"
|
| 59 |
+
|
| 60 |
+
figma_config["token"] = token
|
| 61 |
+
|
| 62 |
+
# Test de connexion
|
| 63 |
+
try:
|
| 64 |
+
headers = {"X-Figma-Token": token}
|
| 65 |
+
response = requests.get(f"{FIGMA_API_BASE}/me", headers=headers, timeout=10)
|
| 66 |
+
|
| 67 |
+
if response.status_code == 200:
|
| 68 |
+
user_data = response.json()
|
| 69 |
+
username = user_data.get("handle", "Utilisateur inconnu")
|
| 70 |
+
return f"✅ Token configuré avec succès ! Connecté en tant que : {username}"
|
| 71 |
+
else:
|
| 72 |
+
return f"❌ Erreur lors de la vérification du token : {response.status_code}"
|
| 73 |
+
|
| 74 |
+
except Exception as e:
|
| 75 |
+
return f"❌ Erreur de connexion à l'API Figma : {str(e)}"
|
| 76 |
+
|
| 77 |
+
def configure_figma_file_id(file_id: str) -> str:
|
| 78 |
+
"""Configure l'ID du fichier Figma à utiliser"""
|
| 79 |
+
global figma_config
|
| 80 |
+
|
| 81 |
+
if not file_id:
|
| 82 |
+
return "❌ L'ID du fichier est requis"
|
| 83 |
+
|
| 84 |
+
figma_config["file_id"] = file_id
|
| 85 |
+
|
| 86 |
+
# Test d'accès au fichier
|
| 87 |
+
if figma_config["token"]:
|
| 88 |
+
try:
|
| 89 |
+
headers = {"X-Figma-Token": figma_config["token"]}
|
| 90 |
+
response = requests.get(f"{FIGMA_API_BASE}/files/{file_id}", headers=headers, timeout=10)
|
| 91 |
+
|
| 92 |
+
if response.status_code == 200:
|
| 93 |
+
file_data = response.json()
|
| 94 |
+
file_name = file_data.get("name", "Fichier inconnu")
|
| 95 |
+
return f"✅ Fichier configuré avec succès : {file_name}"
|
| 96 |
+
else:
|
| 97 |
+
return f"❌ Impossible d'accéder au fichier : {response.status_code}"
|
| 98 |
+
|
| 99 |
+
except Exception as e:
|
| 100 |
+
return f"❌ Erreur lors de l'accès au fichier : {str(e)}"
|
| 101 |
+
else:
|
| 102 |
+
return "⚠️ ID du fichier configuré, mais token manquant"
|
tools/figjam.py
ADDED
|
@@ -0,0 +1,361 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
"""
|
| 2 |
+
🟡 Outils de création d'éléments FigJam
|
| 3 |
+
"""
|
| 4 |
+
from .config import figma_config, make_figma_request
|
| 5 |
+
|
| 6 |
+
def create_figjam_sticky_note(x: str, y: str, text: str, width: str = "240", height: str = "240") -> str:
|
| 7 |
+
"""Crée un post-it (sticky note) dans FigJam avec les dimensions officielles"""
|
| 8 |
+
if not figma_config["file_id"]:
|
| 9 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 10 |
+
|
| 11 |
+
try:
|
| 12 |
+
x_pos, y_pos = float(x), float(y)
|
| 13 |
+
w, h = float(width), float(height)
|
| 14 |
+
|
| 15 |
+
comment_text = f"🟡 **Sticky Note à créer (API FigJam) :**\n- Position: ({x_pos}, {y_pos})\n- Taille: {w}x{h}px (défaut: 240x240)\n- Texte: \"{text}\"\n\n📋 **Code Plugin Figma :**\n```javascript\nconst sticky = figma.createSticky()\nsticky.x = {x_pos}\nsticky.y = {y_pos}\nsticky.resize({w}, {h})\nawait figma.loadFontAsync(sticky.text.fontName)\nsticky.text.characters = '{text}'\n```"
|
| 16 |
+
|
| 17 |
+
comment_data = {
|
| 18 |
+
"message": comment_text,
|
| 19 |
+
"client_meta": {
|
| 20 |
+
"x": x_pos,
|
| 21 |
+
"y": y_pos
|
| 22 |
+
}
|
| 23 |
+
}
|
| 24 |
+
|
| 25 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 26 |
+
|
| 27 |
+
if "error" in result:
|
| 28 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 29 |
+
|
| 30 |
+
return f"✅ Instructions Sticky Note créées à ({x_pos}, {y_pos}) - Taille: {w}x{h}px"
|
| 31 |
+
|
| 32 |
+
except ValueError:
|
| 33 |
+
return "❌ Les coordonnées et dimensions doivent être des nombres"
|
| 34 |
+
|
| 35 |
+
def create_figjam_connector_between_elements(element1_name: str, element2_name: str, style: str = "solid") -> str:
|
| 36 |
+
"""Crée un connecteur entre deux éléments FigJam (officiel)"""
|
| 37 |
+
if not figma_config["file_id"]:
|
| 38 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 39 |
+
|
| 40 |
+
comment_text = f"🔗 **Connecteur FigJam à créer (API officielle) :**\n- Entre: {element1_name}\n- Et: {element2_name}\n- Style: {style}\n\n📋 **Code Plugin Figma :**\n```javascript\n// Trouver les éléments par nom\nconst element1 = figma.currentPage.findOne(n => n.name === '{element1_name}')\nconst element2 = figma.currentPage.findOne(n => n.name === '{element2_name}')\n\n// Créer le connecteur\nconst connector = figma.createConnector()\nconnector.connectorStart = {{\n endpointNodeId: element1.id,\n magnet: 'AUTO'\n}}\nconnector.connectorEnd = {{\n endpointNodeId: element2.id,\n magnet: 'AUTO'\n}}\n```"
|
| 41 |
+
|
| 42 |
+
comment_data = {
|
| 43 |
+
"message": comment_text,
|
| 44 |
+
"client_meta": {
|
| 45 |
+
"x": 0,
|
| 46 |
+
"y": 0
|
| 47 |
+
}
|
| 48 |
+
}
|
| 49 |
+
|
| 50 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 51 |
+
|
| 52 |
+
if "error" in result:
|
| 53 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 54 |
+
|
| 55 |
+
return f"✅ Instructions connecteur créées entre {element1_name} et {element2_name}"
|
| 56 |
+
|
| 57 |
+
def create_figjam_shape_with_text(x: str, y: str, shape_type: str, text: str, width: str = "208", height: str = "208") -> str:
|
| 58 |
+
"""Crée une forme avec texte intégré dans FigJam (API officielle)"""
|
| 59 |
+
if not figma_config["file_id"]:
|
| 60 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 61 |
+
|
| 62 |
+
try:
|
| 63 |
+
x_pos, y_pos = float(x), float(y)
|
| 64 |
+
w, h = float(width), float(height)
|
| 65 |
+
|
| 66 |
+
# Types de formes supportés par l'API Figma
|
| 67 |
+
supported_shapes = {
|
| 68 |
+
"rectangle": "ROUNDED_RECTANGLE",
|
| 69 |
+
"circle": "ELLIPSE",
|
| 70 |
+
"triangle": "TRIANGLE",
|
| 71 |
+
"diamond": "DIAMOND",
|
| 72 |
+
"star": "STAR",
|
| 73 |
+
"hexagon": "HEXAGON"
|
| 74 |
+
}
|
| 75 |
+
|
| 76 |
+
figma_shape = supported_shapes.get(shape_type.lower(), "ROUNDED_RECTANGLE")
|
| 77 |
+
|
| 78 |
+
comment_text = f"🔶 **Forme avec texte FigJam (API officielle) :**\n- Position: ({x_pos}, {y_pos})\n- Type: {shape_type} → {figma_shape}\n- Taille: {w}x{h}px (défaut: 208x208)\n- Texte: \"{text}\"\n\n📋 **Code Plugin Figma :**\n```javascript\nconst shape = figma.createShapeWithText()\nshape.x = {x_pos}\nshape.y = {y_pos}\nshape.resize({w}, {h})\nshape.shapeType = '{figma_shape}'\nawait figma.loadFontAsync(shape.text.fontName)\nshape.text.characters = '{text}'\n```"
|
| 79 |
+
|
| 80 |
+
comment_data = {
|
| 81 |
+
"message": comment_text,
|
| 82 |
+
"client_meta": {
|
| 83 |
+
"x": x_pos,
|
| 84 |
+
"y": y_pos
|
| 85 |
+
}
|
| 86 |
+
}
|
| 87 |
+
|
| 88 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 89 |
+
|
| 90 |
+
if "error" in result:
|
| 91 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 92 |
+
|
| 93 |
+
return f"✅ Instructions forme {shape_type} avec texte créées à ({x_pos}, {y_pos})"
|
| 94 |
+
|
| 95 |
+
except ValueError:
|
| 96 |
+
return "❌ Les coordonnées et dimensions doivent être des nombres"
|
| 97 |
+
|
| 98 |
+
def create_figjam_table(rows: str, columns: str, x: str = "0", y: str = "0") -> str:
|
| 99 |
+
"""Crée un tableau dans FigJam (API officielle)"""
|
| 100 |
+
if not figma_config["file_id"]:
|
| 101 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 102 |
+
|
| 103 |
+
try:
|
| 104 |
+
num_rows, num_cols = int(rows), int(columns)
|
| 105 |
+
x_pos, y_pos = float(x), float(y)
|
| 106 |
+
|
| 107 |
+
comment_text = f"📊 **Tableau FigJam (API officielle) :**\n- Position: ({x_pos}, {y_pos})\n- Dimensions: {num_rows} lignes × {num_cols} colonnes\n\n📋 **Code Plugin Figma :**\n```javascript\nconst table = figma.createTable({num_rows}, {num_cols})\ntable.x = {x_pos}\ntable.y = {y_pos}\n\n// Exemple: ajouter du texte dans les cellules\nawait figma.loadFontAsync(table.cellAt(0, 0).text.fontName)\ntable.cellAt(0, 0).text.characters = 'Titre 1'\ntable.cellAt(0, 1).text.characters = 'Titre 2'\n```"
|
| 108 |
+
|
| 109 |
+
comment_data = {
|
| 110 |
+
"message": comment_text,
|
| 111 |
+
"client_meta": {
|
| 112 |
+
"x": x_pos,
|
| 113 |
+
"y": y_pos
|
| 114 |
+
}
|
| 115 |
+
}
|
| 116 |
+
|
| 117 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 118 |
+
|
| 119 |
+
if "error" in result:
|
| 120 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 121 |
+
|
| 122 |
+
return f"✅ Instructions tableau {num_rows}×{num_cols} créées à ({x_pos}, {y_pos})"
|
| 123 |
+
|
| 124 |
+
except ValueError:
|
| 125 |
+
return "❌ Les dimensions et coordonnées doivent être des nombres"
|
| 126 |
+
|
| 127 |
+
def create_figjam_code_block(x: str, y: str, code: str, language: str = "javascript") -> str:
|
| 128 |
+
"""Crée un bloc de code dans FigJam (API officielle)"""
|
| 129 |
+
if not figma_config["file_id"]:
|
| 130 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 131 |
+
|
| 132 |
+
try:
|
| 133 |
+
x_pos, y_pos = float(x), float(y)
|
| 134 |
+
|
| 135 |
+
# Échapper les caractères spéciaux pour l'affichage
|
| 136 |
+
escaped_code = code.replace('\\', '\\\\').replace('"', '\\"').replace('\n', '\\n')
|
| 137 |
+
|
| 138 |
+
comment_text = f"💻 **Bloc de code FigJam (API officielle) :**\n- Position: ({x_pos}, {y_pos})\n- Langage: {language}\n- Code: \"{code[:100]}{'...' if len(code) > 100 else ''}\"\n\n📋 **Code Plugin Figma :**\n```javascript\nconst codeBlock = figma.createCodeBlock()\ncodeBlock.x = {x_pos}\ncodeBlock.y = {y_pos}\nawait figma.loadFontAsync(codeBlock.codeBlockText.fontName)\ncodeBlock.codeBlockText.characters = \"{escaped_code}\"\n```"
|
| 139 |
+
|
| 140 |
+
comment_data = {
|
| 141 |
+
"message": comment_text,
|
| 142 |
+
"client_meta": {
|
| 143 |
+
"x": x_pos,
|
| 144 |
+
"y": y_pos
|
| 145 |
+
}
|
| 146 |
+
}
|
| 147 |
+
|
| 148 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 149 |
+
|
| 150 |
+
if "error" in result:
|
| 151 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 152 |
+
|
| 153 |
+
return f"✅ Instructions bloc de code {language} créées à ({x_pos}, {y_pos})"
|
| 154 |
+
|
| 155 |
+
except ValueError:
|
| 156 |
+
return "❌ Les coordonnées doivent être des nombres"
|
| 157 |
+
|
| 158 |
+
def create_figjam_background_shape(x: str, y: str, width: str, height: str, color: str = "#F3F4F6", title: str = "", corner_radius: str = "8") -> str:
|
| 159 |
+
"""Crée une forme de fond rectangulaire pour organiser le contenu FigJam"""
|
| 160 |
+
if not figma_config["file_id"]:
|
| 161 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 162 |
+
|
| 163 |
+
try:
|
| 164 |
+
x_pos, y_pos = float(x), float(y)
|
| 165 |
+
w, h = float(width), float(height)
|
| 166 |
+
radius = float(corner_radius)
|
| 167 |
+
|
| 168 |
+
comment_text = f"📐 **Forme de fond FigJam (zone de travail) :**\n- Position: ({x_pos}, {y_pos})\n- Taille: {w}x{h}px\n- Couleur: {color}\n- Titre: \"{title}\"\n- Rayon coins: {radius}px\n\n📋 **Code Plugin Figma :**\n```javascript\n// Créer la forme de fond\nconst background = figma.createRectangle()\nbackground.x = {x_pos}\nbackground.y = {y_pos}\nbackground.resize({w}, {h})\nbackground.cornerRadius = {radius}\nbackground.fills = [{{\n type: 'SOLID',\n color: {{ r: 0.95, g: 0.96, b: 0.97 }} // {color}\n}}]\nbackground.name = 'Zone - {title}'\n\n// Optionnel: ajouter un titre\nif ('{title}') {{\n const titleText = figma.createText()\n titleText.x = {x_pos + 16}\n titleText.y = {y_pos + 16}\n await figma.loadFontAsync(titleText.fontName)\n titleText.characters = '{title}'\n titleText.fontSize = 18\n}}\n```"
|
| 169 |
+
|
| 170 |
+
comment_data = {
|
| 171 |
+
"message": comment_text,
|
| 172 |
+
"client_meta": {
|
| 173 |
+
"x": x_pos,
|
| 174 |
+
"y": y_pos
|
| 175 |
+
}
|
| 176 |
+
}
|
| 177 |
+
|
| 178 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 179 |
+
|
| 180 |
+
if "error" in result:
|
| 181 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 182 |
+
|
| 183 |
+
return f"✅ Zone de travail \"{title}\" créée à ({x_pos}, {y_pos}) - {w}x{h}px"
|
| 184 |
+
|
| 185 |
+
except ValueError:
|
| 186 |
+
return "❌ Les coordonnées et dimensions doivent être des nombres"
|
| 187 |
+
|
| 188 |
+
def create_figjam_sticker(x: str, y: str, sticker_type: str, size: str = "40") -> str:
|
| 189 |
+
"""Crée un sticker/emoji dans FigJam pour les réactions et annotations"""
|
| 190 |
+
if not figma_config["file_id"]:
|
| 191 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 192 |
+
|
| 193 |
+
try:
|
| 194 |
+
x_pos, y_pos = float(x), float(y)
|
| 195 |
+
sticker_size = float(size)
|
| 196 |
+
|
| 197 |
+
# Mapping des stickers populaires
|
| 198 |
+
stickers = {
|
| 199 |
+
"thumbs_up": "👍",
|
| 200 |
+
"thumbs_down": "👎",
|
| 201 |
+
"heart": "❤️",
|
| 202 |
+
"star": "⭐",
|
| 203 |
+
"fire": "🔥",
|
| 204 |
+
"rocket": "🚀",
|
| 205 |
+
"bulb": "💡",
|
| 206 |
+
"warning": "⚠️",
|
| 207 |
+
"check": "✅",
|
| 208 |
+
"cross": "❌",
|
| 209 |
+
"question": "❓",
|
| 210 |
+
"idea": "💭",
|
| 211 |
+
"clock": "⏰",
|
| 212 |
+
"money": "💰",
|
| 213 |
+
"target": "🎯",
|
| 214 |
+
"celebrate": "🎉",
|
| 215 |
+
"thinking": "🤔",
|
| 216 |
+
"confused": "😕"
|
| 217 |
+
}
|
| 218 |
+
|
| 219 |
+
emoji = stickers.get(sticker_type.lower(), sticker_type)
|
| 220 |
+
|
| 221 |
+
comment_text = f"🎭 **Sticker FigJam :**\n- Position: ({x_pos}, {y_pos})\n- Type: {sticker_type} → {emoji}\n- Taille: {sticker_size}px\n\n📋 **Code Plugin Figma :**\n```javascript\n// Créer un sticker comme texte stylisé\nconst sticker = figma.createText()\nsticker.x = {x_pos}\nsticker.y = {y_pos}\nsticker.resize({sticker_size}, {sticker_size})\nawait figma.loadFontAsync({{ family: 'Inter', style: 'Regular' }})\nsticker.characters = '{emoji}'\nsticker.fontSize = {sticker_size}\nsticker.textAlignHorizontal = 'CENTER'\nsticker.textAlignVertical = 'CENTER'\nsticker.name = 'Sticker - {sticker_type}'\n```"
|
| 222 |
+
|
| 223 |
+
comment_data = {
|
| 224 |
+
"message": comment_text,
|
| 225 |
+
"client_meta": {
|
| 226 |
+
"x": x_pos,
|
| 227 |
+
"y": y_pos
|
| 228 |
+
}
|
| 229 |
+
}
|
| 230 |
+
|
| 231 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 232 |
+
|
| 233 |
+
if "error" in result:
|
| 234 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 235 |
+
|
| 236 |
+
return f"✅ Sticker {emoji} créé à ({x_pos}, {y_pos}) - Taille: {sticker_size}px"
|
| 237 |
+
|
| 238 |
+
except ValueError:
|
| 239 |
+
return "❌ Les coordonnées et la taille doivent être des nombres"
|
| 240 |
+
|
| 241 |
+
def create_figjam_workshop_template(template_type: str, x: str = "0", y: str = "0") -> str:
|
| 242 |
+
"""Crée des templates d'atelier FigJam prêts à utiliser"""
|
| 243 |
+
if not figma_config["file_id"]:
|
| 244 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 245 |
+
|
| 246 |
+
try:
|
| 247 |
+
x_pos, y_pos = float(x), float(y)
|
| 248 |
+
|
| 249 |
+
templates = {
|
| 250 |
+
"retrospective": {
|
| 251 |
+
"title": "Rétrospective Sprint",
|
| 252 |
+
"zones": [
|
| 253 |
+
{"title": "😊 Ce qui s'est bien passé", "x": 0, "y": 100, "width": 300, "height": 400, "color": "#D1FAE5"},
|
| 254 |
+
{"title": "😐 Ce qui peut être amélioré", "x": 320, "y": 100, "width": 300, "height": 400, "color": "#FEF3C7"},
|
| 255 |
+
{"title": "🚀 Actions à prendre", "x": 640, "y": 100, "width": 300, "height": 400, "color": "#DBEAFE"}
|
| 256 |
+
]
|
| 257 |
+
},
|
| 258 |
+
"brainstorm": {
|
| 259 |
+
"title": "Session Brainstorming",
|
| 260 |
+
"zones": [
|
| 261 |
+
{"title": "🎯 Objectif", "x": 0, "y": 100, "width": 960, "height": 120, "color": "#F3E8FF"},
|
| 262 |
+
{"title": "💡 Idées", "x": 0, "y": 240, "width": 480, "height": 400, "color": "#FEF3C7"},
|
| 263 |
+
{"title": "⭐ Meilleures idées", "x": 500, "y": 240, "width": 460, "height": 400, "color": "#D1FAE5"}
|
| 264 |
+
]
|
| 265 |
+
},
|
| 266 |
+
"user_journey": {
|
| 267 |
+
"title": "Parcours Utilisateur",
|
| 268 |
+
"zones": [
|
| 269 |
+
{"title": "👤 Persona", "x": 0, "y": 100, "width": 200, "height": 300, "color": "#F3E8FF"},
|
| 270 |
+
{"title": "🎯 Découverte", "x": 220, "y": 100, "width": 180, "height": 300, "color": "#DBEAFE"},
|
| 271 |
+
{"title": "🔍 Exploration", "x": 420, "y": 100, "width": 180, "height": 300, "color": "#FEF3C7"},
|
| 272 |
+
{"title": "✅ Conversion", "x": 620, "y": 100, "width": 180, "height": 300, "color": "#D1FAE5"},
|
| 273 |
+
{"title": "💝 Fidélisation", "x": 820, "y": 100, "width": 180, "height": 300, "color": "#FECACA"}
|
| 274 |
+
]
|
| 275 |
+
}
|
| 276 |
+
}
|
| 277 |
+
|
| 278 |
+
template = templates.get(template_type.lower())
|
| 279 |
+
|
| 280 |
+
if not template:
|
| 281 |
+
available = ", ".join(templates.keys())
|
| 282 |
+
return f"❌ Template non trouvé. Disponibles: {available}"
|
| 283 |
+
|
| 284 |
+
# Générer le code pour créer le template complet
|
| 285 |
+
zones_code = []
|
| 286 |
+
for i, zone in enumerate(template["zones"]):
|
| 287 |
+
zone_x = x_pos + zone["x"]
|
| 288 |
+
zone_y = y_pos + zone["y"]
|
| 289 |
+
zones_code.append(f"""
|
| 290 |
+
// Zone {i+1}: {zone['title']}
|
| 291 |
+
const zone{i+1} = figma.createRectangle()
|
| 292 |
+
zone{i+1}.x = {zone_x}
|
| 293 |
+
zone{i+1}.y = {zone_y}
|
| 294 |
+
zone{i+1}.resize({zone['width']}, {zone['height']})
|
| 295 |
+
zone{i+1}.cornerRadius = 8
|
| 296 |
+
zone{i+1}.fills = [{{ type: 'SOLID', color: {{ r: 0.95, g: 0.96, b: 0.97 }} }}]
|
| 297 |
+
zone{i+1}.name = '{zone['title']}'
|
| 298 |
+
|
| 299 |
+
const title{i+1} = figma.createText()
|
| 300 |
+
title{i+1}.x = {zone_x + 16}
|
| 301 |
+
title{i+1}.y = {zone_y + 16}
|
| 302 |
+
await figma.loadFontAsync(title{i+1}.fontName)
|
| 303 |
+
title{i+1}.characters = '{zone['title']}'
|
| 304 |
+
title{i+1}.fontSize = 16""")
|
| 305 |
+
|
| 306 |
+
comment_text = f"🏗️ **Template FigJam: {template['title']} :**\n- Position: ({x_pos}, {y_pos})\n- {len(template['zones'])} zones de travail\n\n📋 **Code Plugin Figma :**\n```javascript\n// Template: {template['title']}{''.join(zones_code)}\n```"
|
| 307 |
+
|
| 308 |
+
comment_data = {
|
| 309 |
+
"message": comment_text,
|
| 310 |
+
"client_meta": {
|
| 311 |
+
"x": x_pos,
|
| 312 |
+
"y": y_pos
|
| 313 |
+
}
|
| 314 |
+
}
|
| 315 |
+
|
| 316 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 317 |
+
|
| 318 |
+
if "error" in result:
|
| 319 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 320 |
+
|
| 321 |
+
return f"✅ Template \"{template['title']}\" créé avec {len(template['zones'])} zones à ({x_pos}, {y_pos})"
|
| 322 |
+
|
| 323 |
+
except ValueError:
|
| 324 |
+
return "❌ Les coordonnées doivent être des nombres"
|
| 325 |
+
|
| 326 |
+
def create_figjam_organized_zone(title: str, x: str, y: str, width: str = "400", height: str = "500", max_stickies: str = "12") -> str:
|
| 327 |
+
"""Crée une zone organisée avec grille pour post-its dans FigJam"""
|
| 328 |
+
if not figma_config["file_id"]:
|
| 329 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 330 |
+
|
| 331 |
+
try:
|
| 332 |
+
x_pos, y_pos = float(x), float(y)
|
| 333 |
+
w, h = float(width), float(height)
|
| 334 |
+
max_notes = int(max_stickies)
|
| 335 |
+
|
| 336 |
+
# Calculer la grille optimale
|
| 337 |
+
cols = 3 if max_notes <= 9 else 4
|
| 338 |
+
rows = (max_notes + cols - 1) // cols # Division avec arrondi vers le haut
|
| 339 |
+
|
| 340 |
+
sticky_width = (w - 80) // cols # 80px de marge totale
|
| 341 |
+
sticky_height = 120 # Hauteur standard d'un post-it
|
| 342 |
+
|
| 343 |
+
comment_text = f"📋 **Zone organisée FigJam :**\n- Titre: \"{title}\"\n- Position: ({x_pos}, {y_pos})\n- Taille: {w}x{h}px\n- Grille: {cols}×{rows} ({max_notes} post-its max)\n\n📋 **Code Plugin Figma :**\n```javascript\n// Zone de fond\nconst zone = figma.createRectangle()\nzone.x = {x_pos}\nzone.y = {y_pos}\nzone.resize({w}, {h})\nzone.cornerRadius = 12\nzone.fills = [{{ type: 'SOLID', color: {{ r: 0.98, g: 0.98, b: 0.99 }} }}]\nzone.strokes = [{{ type: 'SOLID', color: {{ r: 0.9, g: 0.9, b: 0.92 }} }}]\nzone.strokeWeight = 2\nzone.name = 'Zone - {title}'\n\n// Titre\nconst titleText = figma.createText()\ntitleText.x = {x_pos + 20}\ntitleText.y = {y_pos + 20}\nawait figma.loadFontAsync(titleText.fontName)\ntitleText.characters = '{title}'\ntitleText.fontSize = 20\ntitleText.fontName = {{ family: 'Inter', style: 'Bold' }}\n\n// Grille de post-its exemple\nfor (let row = 0; row < {rows}; row++) {{\n for (let col = 0; col < {cols}; col++) {{\n const index = row * {cols} + col\n if (index >= {max_notes}) break\n \n const sticky = figma.createSticky()\n sticky.x = {x_pos + 20} + col * ({sticky_width} + 10)\n sticky.y = {y_pos + 70} + row * ({sticky_height} + 10)\n sticky.resize({sticky_width}, {sticky_height})\n await figma.loadFontAsync(sticky.text.fontName)\n sticky.text.characters = `Idée ${{index + 1}}`\n sticky.name = `Sticky ${{index + 1}}`\n }}\n}}\n```"
|
| 344 |
+
|
| 345 |
+
comment_data = {
|
| 346 |
+
"message": comment_text,
|
| 347 |
+
"client_meta": {
|
| 348 |
+
"x": x_pos,
|
| 349 |
+
"y": y_pos
|
| 350 |
+
}
|
| 351 |
+
}
|
| 352 |
+
|
| 353 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 354 |
+
|
| 355 |
+
if "error" in result:
|
| 356 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 357 |
+
|
| 358 |
+
return f"✅ Zone organisée \"{title}\" créée avec grille {cols}×{rows} pour {max_notes} post-its"
|
| 359 |
+
|
| 360 |
+
except ValueError:
|
| 361 |
+
return "❌ Les coordonnées et dimensions doivent être des nombres"
|
tools/figma_design.py
ADDED
|
@@ -0,0 +1,92 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
"""
|
| 2 |
+
🎨 Outils de création d'éléments Figma Design
|
| 3 |
+
"""
|
| 4 |
+
from .config import figma_config, make_figma_request
|
| 5 |
+
|
| 6 |
+
def create_figma_rectangle(x: str, y: str, width: str, height: str, name: str = "Rectangle", color: str = "#FF0000") -> str:
|
| 7 |
+
"""Crée un rectangle dans Figma (via commentaire pour notification)"""
|
| 8 |
+
if not figma_config["file_id"]:
|
| 9 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 10 |
+
|
| 11 |
+
try:
|
| 12 |
+
x_pos, y_pos = float(x), float(y)
|
| 13 |
+
w, h = float(width), float(height)
|
| 14 |
+
|
| 15 |
+
# Créer un commentaire avec les instructions de création
|
| 16 |
+
comment_text = f"🟦 **Rectangle à créer :**\n- Nom: {name}\n- Position: ({x_pos}, {y_pos})\n- Taille: {w}x{h}\n- Couleur: {color}"
|
| 17 |
+
|
| 18 |
+
comment_data = {
|
| 19 |
+
"message": comment_text,
|
| 20 |
+
"client_meta": {
|
| 21 |
+
"x": x_pos,
|
| 22 |
+
"y": y_pos
|
| 23 |
+
}
|
| 24 |
+
}
|
| 25 |
+
|
| 26 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 27 |
+
|
| 28 |
+
if "error" in result:
|
| 29 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 30 |
+
|
| 31 |
+
return f"✅ Rectangle {name} créé (via commentaire) à ({x_pos}, {y_pos}) avec la taille {w}x{h}"
|
| 32 |
+
|
| 33 |
+
except ValueError:
|
| 34 |
+
return "❌ Les coordonnées et dimensions doivent être des nombres"
|
| 35 |
+
|
| 36 |
+
def create_figma_frame(x: str, y: str, width: str, height: str, name: str = "Frame") -> str:
|
| 37 |
+
"""Crée un frame dans Figma (via commentaire pour notification)"""
|
| 38 |
+
if not figma_config["file_id"]:
|
| 39 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 40 |
+
|
| 41 |
+
try:
|
| 42 |
+
x_pos, y_pos = float(x), float(y)
|
| 43 |
+
w, h = float(width), float(height)
|
| 44 |
+
|
| 45 |
+
comment_text = f"🖼️ **Frame à créer :**\n- Nom: {name}\n- Position: ({x_pos}, {y_pos})\n- Taille: {w}x{h}"
|
| 46 |
+
|
| 47 |
+
comment_data = {
|
| 48 |
+
"message": comment_text,
|
| 49 |
+
"client_meta": {
|
| 50 |
+
"x": x_pos,
|
| 51 |
+
"y": y_pos
|
| 52 |
+
}
|
| 53 |
+
}
|
| 54 |
+
|
| 55 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 56 |
+
|
| 57 |
+
if "error" in result:
|
| 58 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 59 |
+
|
| 60 |
+
return f"✅ Frame {name} créé (via commentaire) à ({x_pos}, {y_pos}) avec la taille {w}x{h}"
|
| 61 |
+
|
| 62 |
+
except ValueError:
|
| 63 |
+
return "❌ Les coordonnées et dimensions doivent être des nombres"
|
| 64 |
+
|
| 65 |
+
def create_figma_text(x: str, y: str, text: str, name: str = "Text", font_size: str = "16") -> str:
|
| 66 |
+
"""Crée un élément texte dans Figma (via commentaire pour notification)"""
|
| 67 |
+
if not figma_config["file_id"]:
|
| 68 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 69 |
+
|
| 70 |
+
try:
|
| 71 |
+
x_pos, y_pos = float(x), float(y)
|
| 72 |
+
size = float(font_size)
|
| 73 |
+
|
| 74 |
+
comment_text = f"📝 **Texte à créer :**\n- Nom: {name}\n- Position: ({x_pos}, {y_pos})\n- Texte: \"{text}\"\n- Taille: {size}px"
|
| 75 |
+
|
| 76 |
+
comment_data = {
|
| 77 |
+
"message": comment_text,
|
| 78 |
+
"client_meta": {
|
| 79 |
+
"x": x_pos,
|
| 80 |
+
"y": y_pos
|
| 81 |
+
}
|
| 82 |
+
}
|
| 83 |
+
|
| 84 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 85 |
+
|
| 86 |
+
if "error" in result:
|
| 87 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 88 |
+
|
| 89 |
+
return f"✅ Texte \"{text}\" créé (via commentaire) à ({x_pos}, {y_pos})"
|
| 90 |
+
|
| 91 |
+
except ValueError:
|
| 92 |
+
return "❌ Les coordonnées et la taille doivent être des nombres"
|
tools/navigation.py
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
"""
|
| 2 |
+
🧭 Outils de navigation et d'information sur les fichiers Figma
|
| 3 |
+
"""
|
| 4 |
+
import json
|
| 5 |
+
from .config import figma_config, make_figma_request
|
| 6 |
+
|
| 7 |
+
def get_figma_file_info(file_id: str = "") -> str:
|
| 8 |
+
"""Récupère les informations d'un fichier Figma"""
|
| 9 |
+
file_id = file_id or figma_config["file_id"]
|
| 10 |
+
|
| 11 |
+
if not file_id:
|
| 12 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 13 |
+
|
| 14 |
+
result = make_figma_request(f"files/{file_id}")
|
| 15 |
+
|
| 16 |
+
if "error" in result:
|
| 17 |
+
return f"❌ Erreur : {result['error']}"
|
| 18 |
+
|
| 19 |
+
file_info = {
|
| 20 |
+
"nom": result.get("name", ""),
|
| 21 |
+
"derniere_modification": result.get("lastModified", ""),
|
| 22 |
+
"version": result.get("version", ""),
|
| 23 |
+
"pages": [page.get("name", "") for page in result.get("document", {}).get("children", [])]
|
| 24 |
+
}
|
| 25 |
+
|
| 26 |
+
return f"📄 **Fichier Figma :**\n{json.dumps(file_info, indent=2, ensure_ascii=False)}"
|
| 27 |
+
|
| 28 |
+
def get_figma_comments(file_id: str = "") -> str:
|
| 29 |
+
"""Récupère tous les commentaires d'un fichier Figma"""
|
| 30 |
+
file_id = file_id or figma_config["file_id"]
|
| 31 |
+
|
| 32 |
+
if not file_id:
|
| 33 |
+
return "❌ ID du fichier requis"
|
| 34 |
+
|
| 35 |
+
result = make_figma_request(f"files/{file_id}/comments")
|
| 36 |
+
|
| 37 |
+
if "error" in result:
|
| 38 |
+
return f"❌ Erreur : {result['error']}"
|
| 39 |
+
|
| 40 |
+
comments = result.get("comments", [])
|
| 41 |
+
|
| 42 |
+
if not comments:
|
| 43 |
+
return "📝 Aucun commentaire trouvé dans ce fichier"
|
| 44 |
+
|
| 45 |
+
comment_list = []
|
| 46 |
+
for comment in comments[:10]: # Limiter à 10 commentaires
|
| 47 |
+
user = comment.get("user", {}).get("handle", "Anonyme")
|
| 48 |
+
message = comment.get("message", "")
|
| 49 |
+
created_at = comment.get("created_at", "")
|
| 50 |
+
comment_list.append(f"👤 {user} ({created_at}): {message}")
|
| 51 |
+
|
| 52 |
+
return f"📝 **Commentaires récents :**\n" + "\n\n".join(comment_list)
|
| 53 |
+
|
| 54 |
+
def get_figma_user_info() -> str:
|
| 55 |
+
"""Récupère les informations de l'utilisateur connecté"""
|
| 56 |
+
result = make_figma_request("me")
|
| 57 |
+
|
| 58 |
+
if "error" in result:
|
| 59 |
+
return f"❌ Erreur : {result['error']}"
|
| 60 |
+
|
| 61 |
+
user_info = {
|
| 62 |
+
"nom": result.get("handle", ""),
|
| 63 |
+
"email": result.get("email", ""),
|
| 64 |
+
"id": result.get("id", "")
|
| 65 |
+
}
|
| 66 |
+
|
| 67 |
+
return f"👤 **Utilisateur connecté :**\n{json.dumps(user_info, indent=2, ensure_ascii=False)}"
|
tools/user_account.py
ADDED
|
@@ -0,0 +1,237 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
"""
|
| 2 |
+
👤 Outils de gestion du compte utilisateur et des équipes Figma
|
| 3 |
+
"""
|
| 4 |
+
import json
|
| 5 |
+
from .config import figma_config, make_figma_request
|
| 6 |
+
|
| 7 |
+
def get_figma_user_detailed_info() -> str:
|
| 8 |
+
"""Récupère les informations détaillées de l'utilisateur connecté avec plus de données"""
|
| 9 |
+
result = make_figma_request("me")
|
| 10 |
+
|
| 11 |
+
if "error" in result:
|
| 12 |
+
return f"❌ Erreur : {result['error']}"
|
| 13 |
+
|
| 14 |
+
user_info = {
|
| 15 |
+
"id": result.get("id", ""),
|
| 16 |
+
"nom_utilisateur": result.get("handle", ""),
|
| 17 |
+
"email": result.get("email", ""),
|
| 18 |
+
"nom_affichage": result.get("img_url", "").split("/")[-1] if result.get("img_url") else "",
|
| 19 |
+
"url_image": result.get("img_url", ""),
|
| 20 |
+
"date_creation": result.get("created_at", ""),
|
| 21 |
+
"derniere_connexion": result.get("last_activity_at", ""),
|
| 22 |
+
"plan_actuel": "Non spécifié (utiliser get_figma_team_info pour plus de détails)"
|
| 23 |
+
}
|
| 24 |
+
|
| 25 |
+
return f"👤 **Informations détaillées utilisateur :**\n{json.dumps(user_info, indent=2, ensure_ascii=False)}"
|
| 26 |
+
|
| 27 |
+
def get_figma_team_info(team_id: str = "") -> str:
|
| 28 |
+
"""Récupère les informations détaillées d'une équipe Figma incluant le plan d'abonnement"""
|
| 29 |
+
team_id = team_id or figma_config.get("team_id", "")
|
| 30 |
+
|
| 31 |
+
if not team_id:
|
| 32 |
+
return "❌ ID de l'équipe requis. Utilisez d'abord list_figma_user_teams() pour trouver votre équipe."
|
| 33 |
+
|
| 34 |
+
result = make_figma_request(f"teams/{team_id}")
|
| 35 |
+
|
| 36 |
+
if "error" in result:
|
| 37 |
+
return f"❌ Erreur : {result['error']}"
|
| 38 |
+
|
| 39 |
+
team_info = {
|
| 40 |
+
"id": result.get("id", ""),
|
| 41 |
+
"nom": result.get("name", ""),
|
| 42 |
+
"plan_abonnement": result.get("billing_plan", "Inconnu"),
|
| 43 |
+
"limite_editeurs": result.get("editor_limit", "Non spécifié"),
|
| 44 |
+
"editeurs_actifs": result.get("active_editors", 0),
|
| 45 |
+
"stockage_utilise": result.get("storage_used", "Non spécifié"),
|
| 46 |
+
"limite_stockage": result.get("storage_limit", "Non spécifié"),
|
| 47 |
+
"fonctionnalites": result.get("features", []),
|
| 48 |
+
"date_creation": result.get("created_at", ""),
|
| 49 |
+
"statut": result.get("status", "")
|
| 50 |
+
}
|
| 51 |
+
|
| 52 |
+
return f"🏢 **Informations équipe :**\n{json.dumps(team_info, indent=2, ensure_ascii=False)}"
|
| 53 |
+
|
| 54 |
+
def list_figma_user_teams() -> str:
|
| 55 |
+
"""Liste toutes les équipes auxquelles l'utilisateur appartient"""
|
| 56 |
+
result = make_figma_request("teams")
|
| 57 |
+
|
| 58 |
+
if "error" in result:
|
| 59 |
+
return f"❌ Erreur : {result['error']}"
|
| 60 |
+
|
| 61 |
+
teams = result.get("teams", [])
|
| 62 |
+
|
| 63 |
+
if not teams:
|
| 64 |
+
return "🏢 Aucune équipe trouvée pour cet utilisateur"
|
| 65 |
+
|
| 66 |
+
team_list = []
|
| 67 |
+
for team in teams:
|
| 68 |
+
team_id = team.get("id", "")
|
| 69 |
+
name = team.get("name", "Sans nom")
|
| 70 |
+
role = team.get("role", "Membre")
|
| 71 |
+
plan = team.get("billing_plan", "Plan inconnu")
|
| 72 |
+
team_list.append(f"🏢 **{name}** (ID: {team_id})\n - Rôle: {role}\n - Plan: {plan}")
|
| 73 |
+
|
| 74 |
+
return f"🏢 **Équipes de l'utilisateur :**\n\n" + "\n\n".join(team_list)
|
| 75 |
+
|
| 76 |
+
def get_figma_current_user_permissions() -> str:
|
| 77 |
+
"""Récupère les permissions et capacités de l'utilisateur actuel dans un fichier"""
|
| 78 |
+
if not figma_config["file_id"]:
|
| 79 |
+
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
|
| 80 |
+
|
| 81 |
+
comment_text = f"""👥 **Informations utilisateur actuel (Plugin API) :**
|
| 82 |
+
|
| 83 |
+
📋 **Code Plugin Figma pour récupérer les infos utilisateur :**
|
| 84 |
+
```javascript
|
| 85 |
+
// Informations utilisateur actuel
|
| 86 |
+
const currentUser = figma.currentUser
|
| 87 |
+
if (currentUser) {{
|
| 88 |
+
console.log('Utilisateur:', {{
|
| 89 |
+
id: currentUser.id,
|
| 90 |
+
nom: currentUser.name,
|
| 91 |
+
email: currentUser.email || 'Non disponible',
|
| 92 |
+
couleur: currentUser.color,
|
| 93 |
+
sessionId: currentUser.sessionId,
|
| 94 |
+
photoUrl: currentUser.photoUrl || 'Pas de photo'
|
| 95 |
+
}})
|
| 96 |
+
}} else {{
|
| 97 |
+
console.log('Aucun utilisateur connecté')
|
| 98 |
+
}}
|
| 99 |
+
|
| 100 |
+
// Type d'éditeur actuel
|
| 101 |
+
console.log('Type éditeur:', figma.editorType) // 'figma' | 'figjam' | 'dev' | 'slides'
|
| 102 |
+
|
| 103 |
+
// Mode du plugin
|
| 104 |
+
console.log('Mode plugin:', figma.mode) // 'default' | 'textreview' | 'inspect' | etc.
|
| 105 |
+
|
| 106 |
+
// Utilisateurs actifs (FigJam uniquement)
|
| 107 |
+
if (figma.editorType === 'figjam' && figma.activeUsers) {{
|
| 108 |
+
console.log('Utilisateurs actifs:', figma.activeUsers.map(user => ({{
|
| 109 |
+
id: user.id,
|
| 110 |
+
nom: user.name,
|
| 111 |
+
couleur: user.color,
|
| 112 |
+
sessionId: user.sessionId
|
| 113 |
+
}})))
|
| 114 |
+
}}
|
| 115 |
+
|
| 116 |
+
// Clé du fichier (plugins privés uniquement)
|
| 117 |
+
if (figma.fileKey) {{
|
| 118 |
+
console.log('Clé fichier:', figma.fileKey)
|
| 119 |
+
}}
|
| 120 |
+
```"""
|
| 121 |
+
|
| 122 |
+
comment_data = {
|
| 123 |
+
"message": comment_text,
|
| 124 |
+
"client_meta": {"x": 0, "y": 0}
|
| 125 |
+
}
|
| 126 |
+
|
| 127 |
+
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
|
| 128 |
+
|
| 129 |
+
if "error" in result:
|
| 130 |
+
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
|
| 131 |
+
|
| 132 |
+
return f"✅ Code généré pour récupérer les permissions et infos utilisateur"
|
| 133 |
+
|
| 134 |
+
def get_figma_workspace_usage_stats() -> str:
|
| 135 |
+
"""Récupère les statistiques d'utilisation de l'espace de travail"""
|
| 136 |
+
if not figma_config.get("team_id"):
|
| 137 |
+
return "❌ ID de l'équipe requis. Utilisez list_figma_user_teams() pour trouver votre équipe puis configurez figma_config['team_id']"
|
| 138 |
+
|
| 139 |
+
# Récupérer les projets de l'équipe
|
| 140 |
+
projects_result = make_figma_request(f"teams/{figma_config['team_id']}/projects")
|
| 141 |
+
|
| 142 |
+
if "error" in projects_result:
|
| 143 |
+
return f"❌ Erreur : {projects_result['error']}"
|
| 144 |
+
|
| 145 |
+
projects = projects_result.get("projects", [])
|
| 146 |
+
|
| 147 |
+
stats = {
|
| 148 |
+
"nombre_projets": len(projects),
|
| 149 |
+
"projets_recents": [],
|
| 150 |
+
"statistiques_utilisation": "Disponible via l'API Team (nécessite permissions admin)"
|
| 151 |
+
}
|
| 152 |
+
|
| 153 |
+
# Récupérer les 5 projets les plus récents
|
| 154 |
+
for project in projects[:5]:
|
| 155 |
+
stats["projets_recents"].append({
|
| 156 |
+
"nom": project.get("name", ""),
|
| 157 |
+
"id": project.get("id", ""),
|
| 158 |
+
"derniere_modification": project.get("modified_at", "")
|
| 159 |
+
})
|
| 160 |
+
|
| 161 |
+
return f"📊 **Statistiques d'utilisation :**\n{json.dumps(stats, indent=2, ensure_ascii=False)}"
|
| 162 |
+
|
| 163 |
+
def get_figma_api_limitations_info() -> str:
|
| 164 |
+
"""Explique les limitations de l'API Plugin Figma vs l'API REST pour la gestion des projets"""
|
| 165 |
+
|
| 166 |
+
limitations_info = {
|
| 167 |
+
"api_plugin_limitations": {
|
| 168 |
+
"titre": "🚫 Limitations de l'API Plugin Figma",
|
| 169 |
+
"description": "L'API Plugin Figma ne peut PAS :",
|
| 170 |
+
"limitations": [
|
| 171 |
+
"Lister tous les projets d'un utilisateur",
|
| 172 |
+
"Naviguer entre différents fichiers Figma",
|
| 173 |
+
"Accéder aux informations de facturation/abonnement",
|
| 174 |
+
"Créer ou supprimer des projets",
|
| 175 |
+
"Gérer les permissions d'équipe"
|
| 176 |
+
],
|
| 177 |
+
"contexte": "Le plugin s'exécute uniquement dans le contexte du fichier actuel"
|
| 178 |
+
},
|
| 179 |
+
"api_rest_capacites": {
|
| 180 |
+
"titre": "✅ Capacités de l'API REST Figma",
|
| 181 |
+
"description": "L'API REST Figma peut :",
|
| 182 |
+
"capacites": [
|
| 183 |
+
"Lister les équipes de l'utilisateur",
|
| 184 |
+
"Lister les projets d'une équipe",
|
| 185 |
+
"Lister les fichiers d'un projet",
|
| 186 |
+
"Accéder aux informations de profil utilisateur",
|
| 187 |
+
"Récupérer les commentaires des fichiers",
|
| 188 |
+
"Exporter des assets (avec limitations)"
|
| 189 |
+
],
|
| 190 |
+
"note": "Nécessite un token d'accès personnel"
|
| 191 |
+
},
|
| 192 |
+
"recommendation": {
|
| 193 |
+
"titre": "💡 Approche hybride recommandée",
|
| 194 |
+
"description": "Utiliser les deux APIs en complémentarité :",
|
| 195 |
+
"strategies": [
|
| 196 |
+
"API REST : Navigation, gestion des projets, informations utilisateur",
|
| 197 |
+
"API Plugin : Création/modification d'éléments dans le fichier actuel",
|
| 198 |
+
"Plugin avec code JavaScript : Manipulation avancée des objets"
|
| 199 |
+
]
|
| 200 |
+
},
|
| 201 |
+
"workarounds": {
|
| 202 |
+
"titre": "🔧 Solutions de contournement",
|
| 203 |
+
"alternatives": [
|
| 204 |
+
"Utiliser l'API REST pour lister les projets (comme nous faisons)",
|
| 205 |
+
"Stocker les IDs de fichiers dans le clientStorage du plugin",
|
| 206 |
+
"Utiliser des plugins privés pour accéder à figma.fileKey",
|
| 207 |
+
"Implémenter un système de cache des informations projets"
|
| 208 |
+
]
|
| 209 |
+
}
|
| 210 |
+
}
|
| 211 |
+
|
| 212 |
+
return f"📚 **Limitations et capacités des APIs Figma :**\n{json.dumps(limitations_info, indent=2, ensure_ascii=False)}"
|
| 213 |
+
|
| 214 |
+
def list_figma_team_projects(team_id: str = "") -> str:
|
| 215 |
+
"""Liste les projets d'une équipe Figma"""
|
| 216 |
+
team_id = team_id or figma_config["team_id"]
|
| 217 |
+
|
| 218 |
+
if not team_id:
|
| 219 |
+
return "❌ ID de l'équipe requis. Configurez-le avec figma_config['team_id'] = 'VOTRE_TEAM_ID'"
|
| 220 |
+
|
| 221 |
+
result = make_figma_request(f"teams/{team_id}/projects")
|
| 222 |
+
|
| 223 |
+
if "error" in result:
|
| 224 |
+
return f"❌ Erreur : {result['error']}"
|
| 225 |
+
|
| 226 |
+
projects = result.get("projects", [])
|
| 227 |
+
|
| 228 |
+
if not projects:
|
| 229 |
+
return "📁 Aucun projet trouvé dans cette équipe"
|
| 230 |
+
|
| 231 |
+
project_list = []
|
| 232 |
+
for project in projects[:10]: # Limiter à 10 projets
|
| 233 |
+
name = project.get("name", "Sans nom")
|
| 234 |
+
project_id = project.get("id", "")
|
| 235 |
+
project_list.append(f"📁 {name} (ID: {project_id})")
|
| 236 |
+
|
| 237 |
+
return f"📁 **Projets de l'équipe :**\n" + "\n".join(project_list)
|