sigma / tools /figjam.py
Aktraiser
probleme init2
98b6105
"""
🟡 Outils de création d'éléments FigJam
"""
from .config import figma_config, make_figma_request
def create_figjam_sticky_note(x: str, y: str, text: str, width: str = "240", height: str = "240") -> str:
"""
Crée un post-it (sticky note) dans FigJam avec les dimensions officielles.
Args:
x (str): Position X du post-it en pixels
y (str): Position Y du post-it en pixels
text (str): Texte à afficher sur le post-it
width (str): Largeur du post-it en pixels (défaut: 240)
height (str): Hauteur du post-it en pixels (défaut: 240)
Returns:
str: Message de confirmation ou d'erreur
"""
if not figma_config["file_id"]:
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
try:
x_pos, y_pos = float(x), float(y)
w, h = float(width), float(height)
comment_text = f"Sticky Note a creer a ({x_pos}, {y_pos}) taille {w}x{h} texte: {text}"
comment_data = {
"message": comment_text,
"client_meta": {
"x": x_pos,
"y": y_pos
}
}
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
if "error" in result:
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
return f"✅ Instructions Sticky Note créées à ({x_pos}, {y_pos}) - Taille: {w}x{h}px"
except ValueError:
return "❌ Les coordonnées et dimensions doivent être des nombres"
def create_figjam_connector_between_elements(element1_name: str, element2_name: str, style: str = "solid") -> str:
"""
Crée un connecteur entre deux éléments FigJam.
Args:
element1_name (str): Nom du premier élément à connecter
element2_name (str): Nom du deuxième élément à connecter
style (str): Style du connecteur (défaut: solid)
Returns:
str: Message de confirmation ou d'erreur
"""
if not figma_config["file_id"]:
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
comment_text = f"Connecteur a creer entre {element1_name} et {element2_name} style {style}"
comment_data = {
"message": comment_text,
"client_meta": {
"x": 0,
"y": 0
}
}
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
if "error" in result:
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
return f"✅ Instructions connecteur créées entre {element1_name} et {element2_name}"
def create_figjam_shape_with_text(x: str, y: str, shape_type: str, text: str, width: str = "208", height: str = "208") -> str:
"""
Crée une forme avec texte intégré dans FigJam.
Args:
x (str): Position X de la forme en pixels
y (str): Position Y de la forme en pixels
shape_type (str): Type de forme (rectangle, circle, triangle, diamond, star, hexagon)
text (str): Texte à afficher dans la forme
width (str): Largeur de la forme en pixels (défaut: 208)
height (str): Hauteur de la forme en pixels (défaut: 208)
Returns:
str: Message de confirmation ou d'erreur
"""
if not figma_config["file_id"]:
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
try:
x_pos, y_pos = float(x), float(y)
w, h = float(width), float(height)
comment_text = f"Forme {shape_type} avec texte a creer a ({x_pos}, {y_pos}) taille {w}x{h} texte: {text}"
comment_data = {
"message": comment_text,
"client_meta": {
"x": x_pos,
"y": y_pos
}
}
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
if "error" in result:
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
return f"✅ Instructions forme {shape_type} avec texte créées à ({x_pos}, {y_pos})"
except ValueError:
return "❌ Les coordonnées et dimensions doivent être des nombres"
def create_figjam_table(rows: str, columns: str, x: str = "0", y: str = "0") -> str:
"""
Crée un tableau dans FigJam (API officielle).
Args:
rows (str): Nombre de lignes du tableau
columns (str): Nombre de colonnes du tableau
x (str): Position X du tableau en pixels (défaut: 0)
y (str): Position Y du tableau en pixels (défaut: 0)
Returns:
str: Message de confirmation ou d'erreur
"""
if not figma_config["file_id"]:
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
try:
num_rows, num_cols = int(rows), int(columns)
x_pos, y_pos = float(x), float(y)
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```"
comment_data = {
"message": comment_text,
"client_meta": {
"x": x_pos,
"y": y_pos
}
}
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
if "error" in result:
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
return f"✅ Instructions tableau {num_rows}×{num_cols} créées à ({x_pos}, {y_pos})"
except ValueError:
return "❌ Les dimensions et coordonnées doivent être des nombres"
def create_figjam_code_block(x: str, y: str, code: str, language: str = "javascript") -> str:
"""
Crée un bloc de code dans FigJam (API officielle).
Args:
x (str): Position X du bloc de code en pixels
y (str): Position Y du bloc de code en pixels
code (str): Code source à afficher
language (str): Langage de programmation (défaut: javascript)
Returns:
str: Message de confirmation ou d'erreur
"""
if not figma_config["file_id"]:
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
try:
x_pos, y_pos = float(x), float(y)
# Échapper les caractères spéciaux pour l'affichage
escaped_code = code.replace('\\', '\\\\').replace('"', '\\"').replace('\n', '\\n')
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```"
comment_data = {
"message": comment_text,
"client_meta": {
"x": x_pos,
"y": y_pos
}
}
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
if "error" in result:
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
return f"✅ Instructions bloc de code {language} créées à ({x_pos}, {y_pos})"
except ValueError:
return "❌ Les coordonnées doivent être des nombres"
def create_figjam_background_shape(x: str, y: str, width: str, height: str, color: str = "#F3F4F6", title: str = "", corner_radius: str = "8") -> str:
"""
Crée une forme de fond rectangulaire pour organiser le contenu FigJam.
Args:
x (str): Position X de la forme en pixels
y (str): Position Y de la forme en pixels
width (str): Largeur de la forme en pixels
height (str): Hauteur de la forme en pixels
color (str): Couleur de fond en format hex (défaut: #F3F4F6)
title (str): Titre de la zone (optionnel)
corner_radius (str): Rayon des coins en pixels (défaut: 8)
Returns:
str: Message de confirmation ou d'erreur
"""
if not figma_config["file_id"]:
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
try:
x_pos, y_pos = float(x), float(y)
w, h = float(width), float(height)
radius = float(corner_radius)
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```"
comment_data = {
"message": comment_text,
"client_meta": {
"x": x_pos,
"y": y_pos
}
}
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
if "error" in result:
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
return f"✅ Zone de travail \"{title}\" créée à ({x_pos}, {y_pos}) - {w}x{h}px"
except ValueError:
return "❌ Les coordonnées et dimensions doivent être des nombres"
def create_figjam_sticker(x: str, y: str, sticker_type: str, size: str = "40") -> str:
"""
Crée un sticker/emoji dans FigJam pour les réactions et annotations.
Args:
x (str): Position X du sticker en pixels
y (str): Position Y du sticker en pixels
sticker_type (str): Type de sticker (thumbs_up, heart, fire, etc.)
size (str): Taille du sticker en pixels (défaut: 40)
Returns:
str: Message de confirmation ou d'erreur
"""
if not figma_config["file_id"]:
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
try:
x_pos, y_pos = float(x), float(y)
sticker_size = float(size)
# Mapping des stickers populaires
stickers = {
"thumbs_up": "👍",
"thumbs_down": "👎",
"heart": "❤️",
"star": "⭐",
"fire": "🔥",
"rocket": "🚀",
"bulb": "💡",
"warning": "⚠️",
"check": "✅",
"cross": "❌",
"question": "❓",
"idea": "💭",
"clock": "⏰",
"money": "💰",
"target": "🎯",
"celebrate": "🎉",
"thinking": "🤔",
"confused": "😕"
}
emoji = stickers.get(sticker_type.lower(), sticker_type)
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```"
comment_data = {
"message": comment_text,
"client_meta": {
"x": x_pos,
"y": y_pos
}
}
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
if "error" in result:
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
return f"✅ Sticker {emoji} créé à ({x_pos}, {y_pos}) - Taille: {sticker_size}px"
except ValueError:
return "❌ Les coordonnées et la taille doivent être des nombres"
def create_figjam_workshop_template(template_type: str, x: str = "0", y: str = "0") -> str:
"""
Crée des templates d'atelier FigJam prêts à utiliser.
Args:
template_type (str): Type de template (retrospective, brainstorm, user_journey)
x (str): Position X du template en pixels (défaut: 0)
y (str): Position Y du template en pixels (défaut: 0)
Returns:
str: Message de confirmation ou d'erreur
"""
if not figma_config["file_id"]:
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
try:
x_pos, y_pos = float(x), float(y)
templates = {
"retrospective": {
"title": "Rétrospective Sprint",
"zones": [
{"title": "😊 Ce qui s'est bien passé", "x": 0, "y": 100, "width": 300, "height": 400, "color": "#D1FAE5"},
{"title": "😐 Ce qui peut être amélioré", "x": 320, "y": 100, "width": 300, "height": 400, "color": "#FEF3C7"},
{"title": "🚀 Actions à prendre", "x": 640, "y": 100, "width": 300, "height": 400, "color": "#DBEAFE"}
]
},
"brainstorm": {
"title": "Session Brainstorming",
"zones": [
{"title": "🎯 Objectif", "x": 0, "y": 100, "width": 960, "height": 120, "color": "#F3E8FF"},
{"title": "💡 Idées", "x": 0, "y": 240, "width": 480, "height": 400, "color": "#FEF3C7"},
{"title": "⭐ Meilleures idées", "x": 500, "y": 240, "width": 460, "height": 400, "color": "#D1FAE5"}
]
},
"user_journey": {
"title": "Parcours Utilisateur",
"zones": [
{"title": "👤 Persona", "x": 0, "y": 100, "width": 200, "height": 300, "color": "#F3E8FF"},
{"title": "🎯 Découverte", "x": 220, "y": 100, "width": 180, "height": 300, "color": "#DBEAFE"},
{"title": "🔍 Exploration", "x": 420, "y": 100, "width": 180, "height": 300, "color": "#FEF3C7"},
{"title": "✅ Conversion", "x": 620, "y": 100, "width": 180, "height": 300, "color": "#D1FAE5"},
{"title": "💝 Fidélisation", "x": 820, "y": 100, "width": 180, "height": 300, "color": "#FECACA"}
]
}
}
template = templates.get(template_type.lower())
if not template:
available = ", ".join(templates.keys())
return f"❌ Template non trouvé. Disponibles: {available}"
# Générer le code pour créer le template complet
zones_code = []
for i, zone in enumerate(template["zones"]):
zone_x = x_pos + zone["x"]
zone_y = y_pos + zone["y"]
zones_code.append(f"""
// Zone {i+1}: {zone['title']}
const zone{i+1} = figma.createRectangle()
zone{i+1}.x = {zone_x}
zone{i+1}.y = {zone_y}
zone{i+1}.resize({zone['width']}, {zone['height']})
zone{i+1}.cornerRadius = 8
zone{i+1}.fills = [{{ type: 'SOLID', color: {{ r: 0.95, g: 0.96, b: 0.97 }} }}]
zone{i+1}.name = '{zone['title']}'
const title{i+1} = figma.createText()
title{i+1}.x = {zone_x + 16}
title{i+1}.y = {zone_y + 16}
await figma.loadFontAsync(title{i+1}.fontName)
title{i+1}.characters = '{zone['title']}'
title{i+1}.fontSize = 16""")
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```"
comment_data = {
"message": comment_text,
"client_meta": {
"x": x_pos,
"y": y_pos
}
}
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
if "error" in result:
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
return f"✅ Template \"{template['title']}\" créé avec {len(template['zones'])} zones à ({x_pos}, {y_pos})"
except ValueError:
return "❌ Les coordonnées doivent être des nombres"
def create_figjam_organized_zone(title: str, x: str, y: str, width: str = "400", height: str = "500", max_stickies: str = "12") -> str:
"""
Crée une zone organisée avec grille pour post-its dans FigJam.
Args:
title (str): Titre de la zone organisée
x (str): Position X de la zone en pixels
y (str): Position Y de la zone en pixels
width (str): Largeur de la zone en pixels (défaut: 400)
height (str): Hauteur de la zone en pixels (défaut: 500)
max_stickies (str): Nombre maximum de post-its dans la grille (défaut: 12)
Returns:
str: Message de confirmation ou d'erreur
"""
if not figma_config["file_id"]:
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord."
try:
x_pos, y_pos = float(x), float(y)
w, h = float(width), float(height)
max_notes = int(max_stickies)
# Calculer la grille optimale
cols = 3 if max_notes <= 9 else 4
rows = (max_notes + cols - 1) // cols # Division avec arrondi vers le haut
sticky_width = (w - 80) // cols # 80px de marge totale
sticky_height = 120 # Hauteur standard d'un post-it
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```"
comment_data = {
"message": comment_text,
"client_meta": {
"x": x_pos,
"y": y_pos
}
}
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data)
if "error" in result:
return f"❌ Erreur lors de la création du commentaire : {result['error']}"
return f"✅ Zone organisée \"{title}\" créée avec grille {cols}×{rows} pour {max_notes} post-its"
except ValueError:
return "❌ Les coordonnées et dimensions doivent être des nombres"