Spaces:
Sleeping
Sleeping
| """ | |
| 🟡 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" |