""" 🟡 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"