// ---------- Évaluation des conditions ---------- // Extrait de templates/play.html (voir plan de modularisation) : partie // PURE du moteur (aucun accès DOM) — lecture de champs/variables et // comparaison, c'est la logique la plus amenée à grossir (nouvelles // opérations...), donc la plus utile à tester (voir // static/js/play/__tests__/conditions.test.js). SEULE EXCEPTION : // elementsOverlap() (Phase 5, condition de collision) touche forcément le // DOM (getBoundingClientRect) — isolée dans sa propre fonction, non // testée par node:test (voir son commentaire), le reste du fichier reste // pur et testable. // Lit la valeur actuelle d'un champ d'objet dans l'instantané de données // du jeu (gameData.data), pour l'évaluation d'une condition. function readFieldValue(definitionId, rowId, fieldName) { // CLICKED_ROW_ID (-1, voir flow_node_run_data.py) : "la ligne de // Répéteur sur laquelle on vient de cliqué" — jamais connue à l'avance // dans l'éditeur (choisie ici via "🖱️ Ligne cliquée (Répéteur)"), // résolue seulement au moment de l'évaluation via le dernier clic // capturé (voir bindClicks() dans triggers.js). if (rowId === -1) rowId = window.lastClickedRowId; const rows = gameData.data[String(definitionId)] || []; const row = rows.find(r => r.id === rowId); return row ? row[fieldName] : undefined; } function compareValues(actual, operator, expected, fieldType) { if (fieldType === 'booleen') { const a = actual ? 1 : 0; // "oui"/"non" (voir data_list.html) est le vocabulaire affiché // partout ailleurs pour un champ booléen — une valeur de comparaison // fixe tapée "Oui" doit donc être reconnue vraie ici aussi, pas // seulement "1"/"true" (et insensible à la casse, aligné avec // _compare() côté Python, voir filter_repeater_rows.py). const expectedStr = String(expected).trim().toLowerCase(); const e = (expected === true || ['1', 'true', 'vrai', 'oui'].includes(expectedStr)) ? 1 : 0; return operator === 'different' ? a !== e : a === e; } const an = parseFloat(actual), en = parseFloat(expected); const numeric = !isNaN(an) && !isNaN(en); if (numeric) { switch (operator) { case 'egal': return an === en; case 'different': return an !== en; case 'superieur': return an > en; case 'inferieur': return an < en; case 'superieur_egal': return an >= en; case 'inferieur_egal': return an <= en; } } const as = (actual === undefined || actual === null) ? '' : String(actual); const es = (expected === undefined || expected === null) ? '' : String(expected); switch (operator) { case 'egal': return as === es; case 'different': return as !== es; case 'superieur': return as > es; case 'inferieur': return as < es; case 'superieur_egal': return as >= es; case 'inferieur_egal': return as <= es; default: return false; } } // Lit la valeur ACTUELLE d'une variable globale (gameData.variables, // exposé par full_game_payload.py, tenu à jour par refreshRuntimeData() // après toute action qui en modifie une), pour l'évaluation d'une // condition — équivalent, côté client, de _resolve_filter_value côté // serveur (screens/rendering/filter_repeater_rows.py), mais SANS la // syntaxe utilisée par le Répéteur/la Condition de visibilité (jamais // nécessaire ici : le nom de la variable est choisi dans un menu // déroulant, voir screen_edit.html). function readVariableValue(name) { const v = (gameData.variables || {})[name]; return v ? v.value : undefined; } // Navigue dans une valeur JSON (variable de type "objet"/"tableau") // selon un chemin ".champ"/"[index]" chaînable — équivalent JS de // _resolve_variable_path (même fichier Python que ci-dessus). Chemin // vide -> valeur brute inchangée (le cas normal pour une variable // scalaire). Ne lève jamais : JSON invalide ou chemin qui ne correspond // à rien -> null, comme côté serveur. function resolveVariablePath(rawValue, path) { if (!path) return rawValue; let current; try { current = rawValue ? JSON.parse(rawValue) : null; } catch (e) { return null; } const segmentRe = /\.([^.\[\]]+)|\[(\d+)\]/g; let m; while ((m = segmentRe.exec(path)) !== null) { if (current === null || current === undefined) return null; current = m[1] !== undefined ? current[m[1]] : current[parseInt(m[2], 10)]; } return current === undefined ? null : current; } // 2.4 — conditions combinées (ET/OU) : un nœud Condition peut porter une // liste cond_clauses (JSON) en plus de sa clause historique. Un nœud sans // cond_clauses (tous les nœuds créés avant 2.4, ou un nœud à une seule // clause) garde EXACTEMENT son ancien comportement — une seule comparaison. // // Chaque clause peut tester soit un champ d'objet (source absente/"objet", // comportement historique), soit une VARIABLE GLOBALE (source // "variable" — voir ensure_flow_schema.py pour cond_source/cond_variable/ // cond_variable_chemin). // Boîte de collision (voir screens/rendering/collision_settings.py) : // centrée par défaut sur le rectangle VISUEL (getBoundingClientRect), // réduite/décalée si réglée dans le panneau de propriétés — un sprite // très paddé (ex. les frames CraftPix) peut ainsi avoir une silhouette de // collision bien plus petite que son canevas. `collision` absent (élément // de l'éditeur document, ou objet de scène posé avant l'ajout de ce // réglage) => le rectangle visuel EXACT, comportement inchangé. Fonction // PURE (aucun accès DOM) — testée par static/js/play/__tests__/ // conditions.test.js, contrairement à elementsOverlap() ci-dessous. function forgeCollisionRectFromBox(box, collision) { const width = (collision && collision.width) || box.width; const height = (collision && collision.height) || box.height; const offsetX = (collision && collision.offset_x) || 0; const offsetY = (collision && collision.offset_y) || 0; const left = box.left + (box.width - width) / 2 + offsetX; const top = box.top + (box.height - height) / 2 + offsetY; const shape = (collision && collision.shape) || 'rectangle'; return { left, top, right: left + width, bottom: top + height, width, height, shape }; } function forgeRectanglesOverlap(a, b) { return a.left < b.right && a.right > b.left && a.top < b.bottom && a.bottom > b.top; } // Cercle-cercle uniquement (rayon = le plus petit des deux côtés/2) — une // paire rectangle/cercle retombe sur un chevauchement de rectangles (repli // volontairement approximatif plutôt qu'une vraie intersection cercle- // rectangle, hors scope de ce premier réglage). function forgeCirclesOverlap(a, b) { const acx = a.left + a.width / 2, acy = a.top + a.height / 2, ar = Math.min(a.width, a.height) / 2; const bcx = b.left + b.width / 2, bcy = b.top + b.height / 2, br = Math.min(b.width, b.height) / 2; const dx = acx - bcx, dy = acy - bcy; return Math.sqrt(dx * dx + dy * dy) < (ar + br); } // Choisit rectangle-rectangle ou cercle-cercle selon la forme des DEUX // boîtes (voir forgeCollisionRectFromBox, qui pose `shape` dessus) — // réutilisée aussi bien par elementsOverlap() ci-dessous (condition de // flow) que par forgeWouldCollide() (personnage-controller.js, blocage // physique du déplacement au clavier) : UNE seule règle de "qu'est-ce qui // se touche", jamais deux implémentations qui pourraient diverger. function forgeShapesOverlap(a, b) { if (a.shape === 'cercle' && b.shape === 'cercle') return forgeCirclesOverlap(a, b); return forgeRectanglesOverlap(a, b); } // Phase 5 — condition de collision : chevauchement des BOÎTES DE // COLLISION (voir forgeCollisionRectFromBox ci-dessus) de deux éléments, // positionnées sur leur rectangle RÉEL à l'écran (getBoundingClientRect — // reflète les déplacements posés via "Modifier un élément"/"Modifier un // objet de scène", voir static/js/play/actions.js, ET la caméra qui suit // le personnage, voir personnage-controller.js : un décalage de caméra // est un simple transform CSS, déjà reflété par getBoundingClientRect). // Aucun élément trouvé (id invalide, élément masqué avec display:none — // getBoundingClientRect renvoie alors une boîte de largeur/hauteur // nulles), ou collision explicitement désactivée => pas de chevauchement // plutôt que de planter. function elementsOverlap(elementIdA, elementIdB) { const a = document.querySelector('[data-element-id="' + elementIdA + '"]'); const b = document.querySelector('[data-element-id="' + elementIdB + '"]'); if (!a || !b) return false; const screenData = (typeof screensData !== 'undefined' && typeof window !== 'undefined') && screensData.find(function (s) { return s.id === window.currentScreenId; }); const objA = screenData && (screenData.elements || []).find(function (o) { return o.id === elementIdA; }); const objB = screenData && (screenData.elements || []).find(function (o) { return o.id === elementIdB; }); if ((objA && objA.collision && objA.collision.enabled === false) || (objB && objB.collision && objB.collision.enabled === false)) { return false; } const rectA = forgeCollisionRectFromBox(a.getBoundingClientRect(), objA && objA.collision); const rectB = forgeCollisionRectFromBox(b.getBoundingClientRect(), objB && objB.collision); return forgeShapesOverlap(rectA, rectB); } function evaluateConditionClause(clause) { const source = clause.source ?? clause.cond_source ?? 'objet'; const operator = clause.operator ?? clause.cond_operator; const expected = clause.value ?? clause.cond_value; if (source === 'collision') { // Pas d'opérateur/valeur à comparer (contrairement à "objet"/ // "variable") : le chevauchement EST directement le booléen vrai/faux // du nœud — pour "ne se touchent pas", le créateur relie simplement // le port "Faux" plutôt que "Vrai" dans le graphe, comme pour // n'importe quelle autre condition. return elementsOverlap(clause.element_a ?? clause.cond_element_a, clause.element_b ?? clause.cond_element_b); } if (source === 'variable') { const varName = clause.variable ?? clause.cond_variable; const path = clause.variable_chemin ?? clause.cond_variable_chemin; const varInfo = (gameData.variables || {})[varName]; const actual = resolveVariablePath(readVariableValue(varName), path); const fieldType = varInfo && varInfo.type === 'booleen' ? 'booleen' : ''; return compareValues(actual, operator, expected, fieldType); } const actual = readFieldValue(clause.definition_id ?? clause.cond_definition_id, clause.row_id ?? clause.cond_row_id, clause.field ?? clause.cond_field); return compareValues(actual, operator, expected, clause.field_type ?? clause.cond_field_type); } function evaluateConditionNode(node) { if (node.cond_clauses) { let clauses; try { clauses = JSON.parse(node.cond_clauses); } catch (e) { clauses = null; } if (Array.isArray(clauses) && clauses.length) { const results = clauses.map(evaluateConditionClause); return node.cond_combinator === 'ou' ? results.some(Boolean) : results.every(Boolean); } } return evaluateConditionClause(node); } // static/js/play/__tests__/ (node:test) importe ces fonctions via // require() — pas de risque en navigateur : `module` n'existe pas là-bas, // cette branche ne s'exécute jamais côté client. if (typeof module !== 'undefined' && module.exports) { module.exports = { readFieldValue, compareValues, readVariableValue, resolveVariablePath, evaluateConditionClause, evaluateConditionNode, forgeCollisionRectFromBox, forgeRectanglesOverlap, forgeCirclesOverlap, forgeShapesOverlap, }; }