From 7ce5efb9e98af1dcaabd025e0f8d5f02a9e2bee8 Mon Sep 17 00:00:00 2001 From: Julien Quiaios Date: Sat, 24 Oct 2026 16:43:45 +0000 Subject: [PATCH] =?UTF-8?q?feat:=20carnet=20selon=20la=20difficult=C3=A9,?= =?UTF-8?q?=20messages=20informatifs,=20objet=20inutilisable=20en=20l?= =?UTF-8?q?=E2=80=99=C3=A9tat,=20combinaison=20par=20glisser-d=C3=A9poser?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01PAZVXsUH5YDVmMp46Bii1C --- README.md | 2 + src/engine/BaseRenderer.ts | 96 ++++++++++++++++++++++----- src/engine/Engine.ts | 25 +++++-- src/engine/types.ts | 7 +- src/scenarios/chapitre1/scenario.json | 57 ++++++++++------ src/style.css | 8 +++ tests/engine.test.ts | 15 +++++ tests/smoke.cjs | 4 +- 8 files changed, 171 insertions(+), 43 deletions(-) diff --git a/README.md b/README.md index 6f9c04b..aa02185 100644 --- a/README.md +++ b/README.md @@ -113,6 +113,8 @@ tests/ - `{ "goto" }`, `{ "message" }`, `{ "setFlag" }`, `{ "give" }`, `{ "remove" }`, `{ "puzzle" }`, `{ "sound" }`, `{ "win" }` ; - les variables : `{ "add": "molette1", "mod": 10 }` et `{ "set": "x", "value": 0 }` ; - les conditionnelles : `{ "if": [...], "then": [...], "else": [...] }`. + - les messages : par défaut, une **observation** (en difficile, le joueur peut la noter au carnet) ; `{ "message": "…", "info": true }` pour un retour d'action ou une consigne, jamais notable. Les messages du moteur (intro, « ne sert à rien », combinaison ratée, `unusable` d'un objet, indices H) sont toujours informatifs ; + - le carnet : `{ "clue": "id" }` après un message lie ce message à un indice des `clues` (noté d'office en facile). - **Props** : l'état visuel des objets selon les conditions (`visible`, `offset`, `rotation`, `emissive`), ou selon une variable (`spin` : une molette tourne de `step` radians par unité). Tout est animé : tiroir qui coulisse, porte qui s'ouvre, molettes, voyants, plafonnier. - **Déclencheurs** (`triggers`) : des actions exécutées une seule fois, dès que leurs conditions deviennent vraies. Par exemple, un déclic quand un mécanisme se débloque. - **Combinaisons** (`combinations`) : deux objets d'inventaire et les actions à exécuter quand on les combine. diff --git a/src/engine/BaseRenderer.ts b/src/engine/BaseRenderer.ts index 0449c41..69613e8 100644 --- a/src/engine/BaseRenderer.ts +++ b/src/engine/BaseRenderer.ts @@ -56,6 +56,10 @@ export abstract class BaseRenderer implements View { private notebookEl: HTMLElement | null = null; /** Dernier objet obtenu : sa case clignote dans l'inventaire. */ private freshItem: string | null = null; + /** Indice porté par le message affiché (noté via le bouton en mode difficile). */ + private messageClue: Clue | null = null; + /** Objet en cours de glisser-déposer dans l'inventaire. */ + private dragItem: string | null = null; private tooltipEl: HTMLElement; private puzzleLayer: HTMLElement; private inventoryEl: HTMLElement; @@ -287,15 +291,44 @@ export abstract class BaseRenderer implements View { img.src = item ? this.opts.resolveImage(item.icon) : ''; img.alt = item?.name ?? id; img.draggable = false; - slot.title = item ? `${item.name}${item.description ? ' — ' + item.description : ''}` : id; slot.dataset.item = id; slot.classList.toggle('selected', state.selected === id); + // Objet en main : toutes les autres cases proposent d'essayer, sans dire si ça marche. + const held = state.selected && state.selected !== id ? this.engine.getItem(state.selected) : undefined; + slot.classList.toggle('target', !!held); + slot.title = held + ? `Essayer de combiner « ${held.name} » avec « ${item?.name ?? id} »` + : item ? `${item.name}${item.description ? ' — ' + item.description : ''}` : id; if (id === this.freshItem) slot.classList.add('fresh'); slot.onclick = () => { const sel = this.engine.state.selected; if (sel && sel !== id) this.engine.combine(sel, id); else this.engine.selectItem(id); }; + // Glisser un objet sur un autre = essayer de les combiner (équivalent aux deux clics). + slot.draggable = true; + slot.ondragstart = (e) => { + this.dragItem = id; + e.dataTransfer?.setData('text/plain', id); + if (e.dataTransfer) e.dataTransfer.effectAllowed = 'move'; + this.inventoryEl.classList.add('dragging'); + }; + slot.ondragend = () => { + this.dragItem = null; + this.inventoryEl.classList.remove('dragging'); + this.inventoryEl.querySelectorAll('.drop-over').forEach((n) => n.classList.remove('drop-over')); + }; + slot.ondragover = (e) => { + if (!this.dragItem || this.dragItem === id) return; + e.preventDefault(); + slot.classList.add('drop-over'); + }; + slot.ondragleave = () => slot.classList.remove('drop-over'); + slot.ondrop = (e) => { + e.preventDefault(); + const src = this.dragItem; + if (src && src !== id) this.engine.combine(src, id); + }; } const uv = this.engine.scenario.uvLight; this.uvHaloEl.classList.toggle('visible', !!uv && state.selected === uv.item); @@ -315,7 +348,10 @@ export abstract class BaseRenderer implements View { this.messageEl.className = `message visible ${kind}`; this.messageText.textContent = text; this.messageEl.querySelector('.clue-btn')?.remove(); + this.messageEl.querySelector('.clue-noted')?.remove(); + this.messageClue = null; if (kind === 'hint') playSound('beep'); + if (this.engine.state.difficulty === 'hard' && kind === 'observation') this.addNoteButton(text); // Fermeture automatique (le clic suivant le ferme aussi). this.messageTimer = window.setTimeout(() => this.hideMessage(), Math.max(5000, text.length * 70)); } @@ -325,25 +361,48 @@ export abstract class BaseRenderer implements View { this.messageEl.classList.remove('visible'); } - /** Bouton « Noter dans le carnet » sous le message courant. */ - offerClue(clue: Clue): void { - this.messageEl.querySelector('.clue-btn')?.remove(); + /** Mode difficile : bouton « Noter dans le carnet » en bas à droite de chaque message. */ + private addNoteButton(text: string): void { const btn = el('button', 'clue-btn', this.messageEl); - btn.textContent = 'Noter dans le carnet'; - btn.title = clue.text; - btn.onclick = (e) => { - e.stopPropagation(); - this.engine.noteClue(clue.id); + const noted = () => { btn.textContent = 'Noté ✓'; btn.disabled = true; - this.notebookBtn.classList.remove('pulse'); - void this.notebookBtn.offsetWidth; - this.notebookBtn.classList.add('pulse'); - window.setTimeout(() => this.hideMessage(), 700); }; - // Laisse le temps de cliquer : la fermeture automatique est repoussée. - window.clearTimeout(this.messageTimer); - this.messageTimer = window.setTimeout(() => this.hideMessage(), 9000); + btn.textContent = 'Noter dans le carnet'; + if (this.engine.state.notebook.includes(text)) noted(); + btn.onclick = (e) => { + e.stopPropagation(); + // Message porteur d'un indice : on note sa version rédigée, sinon le texte tel quel. + const clue = this.messageClue; + if (clue) this.engine.noteClue(clue.id); + else this.engine.noteText(text); + noted(); + this.pulseNotebook(); + window.clearTimeout(this.messageTimer); + this.messageTimer = window.setTimeout(() => this.hideMessage(), 700); + }; + // Survoler le bouton suspend la fermeture automatique. + btn.onmouseenter = () => window.clearTimeout(this.messageTimer); + btn.onmouseleave = () => { + window.clearTimeout(this.messageTimer); + this.messageTimer = window.setTimeout(() => this.hideMessage(), 4000); + }; + } + + /** Le message courant porte un indice : noté d'office en facile (le moteur l'a déjà fait). */ + offerClue(clue: Clue): void { + this.messageClue = clue; + if (this.engine.state.difficulty === 'hard') return; + if (!this.engine.state.notebook.includes(clue.id)) return; + this.messageEl.querySelector('.clue-noted')?.remove(); + el('span', 'clue-noted', this.messageEl).textContent = 'Noté dans le carnet'; + this.pulseNotebook(); + } + + private pulseNotebook(): void { + this.notebookBtn.classList.remove('pulse'); + void this.notebookBtn.offsetWidth; + this.notebookBtn.classList.add('pulse'); } /** Annonce centrale « Objet obtenu » + case de l'inventaire qui clignote. */ @@ -392,7 +451,10 @@ export abstract class BaseRenderer implements View { close.onclick = () => this.toggleNotebook(false); el('h3', '', book).textContent = 'Carnet'; if (!ids.length) { - el('p', 'notebook-empty', book).textContent = 'Aucune note pour l’instant. Quand vous découvrez un indice, choisissez « Noter dans le carnet ».'; + el('p', 'notebook-empty', book).textContent = + this.engine.state.difficulty === 'hard' + ? 'Aucune note pour l’instant. Sous chaque message, « Noter dans le carnet » garde ce qui vous semble utile.' + : 'Aucune note pour l’instant. Les indices importants s’y inscrivent d’eux-mêmes.'; return; } const list = el('ol', '', book); diff --git a/src/engine/Engine.ts b/src/engine/Engine.ts index 16e9863..9883902 100644 --- a/src/engine/Engine.ts +++ b/src/engine/Engine.ts @@ -3,7 +3,8 @@ import { checkAll, saveState, type GameState } from './state'; import type { Action, Clue, Hotspot, Interaction, Item, PuzzleDef, Scenario, Scene } from './types'; import type { PuzzleContext } from '../puzzles/registry'; -export type MessageKind = 'info' | 'hint' | 'item'; +/** `observation` : ce que le joueur découvre (notable au carnet en difficile). `info` : retour du jeu, jamais notable. */ +export type MessageKind = 'info' | 'hint' | 'item' | 'observation'; export type Transition = 'fade' | 'zoom-in' | 'zoom-out' | 'turn-left' | 'turn-right' | 'none'; /** @@ -98,6 +99,17 @@ export class Engine { return true; } + /** Note un texte libre dans le carnet (mode difficile : n'importe quel message). */ + noteText(text: string): boolean { + const t = text.trim(); + if (!t || this.state.notebook.includes(t)) return false; + this.state.notebook.push(t); + playSound('pickup'); + saveState(this.state); + this.view.refresh(); + return true; + } + /** Zones actives de la scène, y compris les bandes de navigation générées. */ activeHotspots(scene: Scene): Hotspot[] { const [w, h] = this.scenario.resolution; @@ -129,7 +141,8 @@ export class Engine { // Dans tous les cas, l'objet est « rangé » après usage : on le reprend en main si besoin. this.state.selected = null; if (!usesSelection) { - this.view.showMessage(`${item?.name ?? 'Cet objet'} ne sert à rien ici.`, 'info'); + // Objet inutilisable en l'état (ex. lampe sans piles) : on le dit, plutôt que d'accuser l'endroit. + this.view.showMessage(item?.unusable ?? `${item?.name ?? 'Cet objet'} ne sert à rien ici.`, 'info'); this.view.refresh(); return false; } @@ -232,7 +245,7 @@ export class Engine { playSound('step'); this.view.showScene(to, t); } else if ('message' in action) { - this.view.showMessage(action.message, 'info'); + this.view.showMessage(action.message, action.info ? 'info' : 'observation'); } else if ('setFlag' in action) { this.state.flags[action.setFlag] = true; } else if ('clearFlag' in action) { @@ -261,7 +274,11 @@ export class Engine { for (const a of checkAll(this.state, action.if) ? action.then : (action.else ?? [])) this.exec(a); } else if ('clue' in action) { const clue = this.getClue(action.clue); - if (clue && !this.state.notebook.includes(clue.id)) this.view.offerClue?.(clue); + if (clue && !this.state.notebook.includes(clue.id)) { + // Facile : noté d'office. Difficile : le joueur choisit (bouton sur chaque message). + if (this.state.difficulty === 'easy') this.noteClue(clue.id); + this.view.offerClue?.(clue); + } } else if ('win' in action) { this.state.won = true; this.state.selected = null; diff --git a/src/engine/types.ts b/src/engine/types.ts index 005e2a2..e52fcd5 100644 --- a/src/engine/types.ts +++ b/src/engine/types.ts @@ -21,7 +21,8 @@ export type Condition = string; /** Une action = un objet à clé unique, lisible et facile à écrire à la main. */ export type Action = | { goto: string } - | { message: string } + /** `info: true` : message purement informatif (retour d'action, consigne), sans bouton « Noter dans le carnet ». */ + | { message: string; info?: boolean } | { setFlag: string } | { clearFlag: string } | { give: string } @@ -34,7 +35,7 @@ export type Action = | { set: string; value: number } /** Action conditionnelle. */ | { if: Condition[]; then: Action[]; else?: Action[] } - /** Propose de noter un indice dans le carnet (bouton dans le message affiché). */ + /** Indice du message affiché : noté d'office en facile, notable par le bouton en difficile. */ | { clue: string }; export type SoundName = 'click' | 'step' | 'success' | 'error' | 'unlock' | 'drawer' | 'pickup' | 'beep' | 'dial' | 'switch' | 'power' | 'reveal' | 'locked'; @@ -144,6 +145,8 @@ export interface Item { name: string; icon: string; description?: string; + /** Message quand on tente de s'en servir sur une zone qui ne l'attend pas : l'objet est inutilisable en l'état. */ + unusable?: string; } export interface PuzzleDef { diff --git a/src/scenarios/chapitre1/scenario.json b/src/scenarios/chapitre1/scenario.json index d6bc8f2..bb9efa8 100644 --- a/src/scenarios/chapitre1/scenario.json +++ b/src/scenarios/chapitre1/scenario.json @@ -22,7 +22,8 @@ "id": "uvlamp", "name": "Lampe UV", "icon": "images/uvlamp.svg", - "description": "Une petite lampe à ultraviolets. Elle n’a pas de piles." + "description": "Une petite lampe à ultraviolets. Elle n’a pas de piles.", + "unusable": "La lampe ne s’allume pas : elle n’a pas de piles." }, { "id": "batteries", @@ -66,7 +67,8 @@ "give": "uvlampOn" }, { - "message": "Vous glissez les piles dans la lampe : une lueur violette s’allume." + "message": "Vous glissez les piles dans la lampe : une lueur violette s’allume.", + "info": true } ] } @@ -611,14 +613,16 @@ ], "do": [ { - "message": "Le fond du vase est vide, maintenant." + "message": "Le fond du vase est vide, maintenant.", + "info": true } ] }, { "do": [ { - "message": "Vous écartez les fleurs fanées : quelque chose brille au fond du vase." + "message": "Vous écartez les fleurs fanées : quelque chose brille au fond du vase.", + "info": true } ] } @@ -641,7 +645,8 @@ "setFlag": "batteries_found" }, { - "message": "Deux piles, encore chargées." + "message": "Deux piles, encore chargées.", + "info": true } ] } @@ -995,7 +1000,8 @@ { "do": [ { - "message": "Le tiroir secret est vide, maintenant." + "message": "Le tiroir secret est vide, maintenant.", + "info": true } ] } @@ -1019,7 +1025,8 @@ "setFlag": "key_taken" }, { - "message": "Vous prenez une clé en laiton. Elle est lourde et froide." + "message": "Vous prenez une clé en laiton. Elle est lourde et froide.", + "info": true } ] } @@ -1077,7 +1084,8 @@ "setFlag": "uvlamp_found" }, { - "message": "Une petite lampe à ultraviolets, cachée sous les factures. Elle ne s’allume pas : il manque les piles." + "message": "Une petite lampe à ultraviolets, cachée sous les factures. Elle ne s’allume pas : il manque les piles.", + "info": true } ] } @@ -1198,7 +1206,8 @@ "sound": "reveal" }, { - "message": "Sous la lumière violette, des lettres luminescentes apparaissent sur la toile ! Cliquez sur le message pour l’examiner." + "message": "Sous la lumière violette, des lettres luminescentes apparaissent sur la toile ! Cliquez sur le message pour l’examiner.", + "info": true } ] }, @@ -1208,7 +1217,8 @@ ], "do": [ { - "message": "Le message brille toujours sous la lampe." + "message": "Le message brille toujours sous la lampe.", + "info": true } ] }, @@ -1521,7 +1531,8 @@ "sound": "unlock" }, { - "message": "1-0-4-0 : clic ! La porte du coffret s’entrouvre." + "message": "1-0-4-0 : clic ! La porte du coffret s’entrouvre.", + "info": true } ] }, @@ -1534,7 +1545,8 @@ "sound": "locked" }, { - "message": "La poignée résiste : la combinaison n’est pas la bonne." + "message": "La poignée résiste : la combinaison n’est pas la bonne.", + "info": true } ] } @@ -1552,7 +1564,8 @@ ], "do": [ { - "message": "Le coffret est ouvert." + "message": "Le coffret est ouvert.", + "info": true } ] }, @@ -1629,7 +1642,8 @@ "sound": "switch" }, { - "message": "La manette s’emboîte parfaitement. Elle est en position haute." + "message": "La manette s’emboîte parfaitement. Elle est en position haute.", + "info": true } ] }, @@ -1639,7 +1653,8 @@ ], "do": [ { - "message": "Le voyant est vert : le courant est rétabli." + "message": "Le voyant est vert : le courant est rétabli.", + "info": true } ] }, @@ -1649,7 +1664,8 @@ ], "do": [ { - "message": "La manette est en position basse. Il suffit de la relever." + "message": "La manette est en position basse. Il suffit de la relever.", + "info": true } ] }, @@ -1659,7 +1675,8 @@ ], "do": [ { - "message": "La manette du coffret devrait s’emboîter ici. Sélectionnez-la dans l’inventaire, puis cliquez sur le disjoncteur." + "message": "La manette du coffret devrait s’emboîter ici. Sélectionnez-la dans l’inventaire, puis cliquez sur le disjoncteur.", + "info": true } ] }, @@ -1694,7 +1711,8 @@ "sound": "power" }, { - "message": "Clac ! Le plafonnier grésille puis s’allume. Le courant est revenu dans la pièce." + "message": "Clac ! Le plafonnier grésille puis s’allume. Le courant est revenu dans la pièce.", + "info": true } ] } @@ -1804,7 +1822,8 @@ ], "do": [ { - "message": "Cette clé en laiton devrait aller dans la serrure. Sélectionnez-la dans l’inventaire, puis cliquez ici." + "message": "Cette clé en laiton devrait aller dans la serrure. Sélectionnez-la dans l’inventaire, puis cliquez ici.", + "info": true } ] }, diff --git a/src/style.css b/src/style.css index b88815e..fdf6420 100644 --- a/src/style.css +++ b/src/style.css @@ -229,6 +229,11 @@ button.primary:hover { background: #dbb55c; } } .clue-btn::before { content: ''; display: inline-block; width: 12px; height: 14px; margin-right: 8px; vertical-align: -2px; background: linear-gradient(#e9dec4, #cdb88a); border-left: 3px solid #8a3a2a; border-radius: 1px; } .clue-btn:disabled { opacity: .8; cursor: default; } +/* Mode difficile : bouton discret, en bas à droite du message. */ +.message .clue-btn { display: block; margin: 10px -8px -4px auto; padding: 6px 10px; font-size: 12px; } +/* Mode facile : mention « noté d'office ». */ +.clue-noted { display: block; margin-top: 8px; font: italic 12px/1 system-ui, sans-serif; color: #c9a24a; text-align: right; } +.clue-noted::before { content: '✓ '; } /* Halo de la lampe UV (le révélateur d'encre est calculé en 3D, ceci est l'effet lumineux) */ .uv-halo { @@ -342,6 +347,9 @@ button.primary:hover { background: #dbb55c; } place-items: center; } .slot:disabled { opacity: .45; cursor: default; } +/* Objet en main ou glissé : toutes les cases invitent à essayer (sans trahir les bonnes paires). */ +.slot.target:hover, .slot.drop-over { border-color: var(--brass); box-shadow: 0 0 0 2px rgba(201, 162, 74, .35); } +.inventory.dragging .slot:not(:disabled) { border-style: dashed; } .slot img { width: 100%; height: 100%; object-fit: contain; pointer-events: none; } .slot.selected { border-color: var(--brass); box-shadow: 0 0 0 2px rgba(201, 162, 74, .35), 0 0 18px rgba(201, 162, 74, .35); background: #242014; } .hud-right { display: flex; align-items: center; gap: 8px; } diff --git a/tests/engine.test.ts b/tests/engine.test.ts index 82808df..23332ab 100644 --- a/tests/engine.test.ts +++ b/tests/engine.test.ts @@ -124,6 +124,21 @@ describe('moteur', () => { expect(state.notebook).toEqual(['c1']); }); + it('carnet : texte libre (mode difficile), sans doublon', () => { + const { engine, state } = makeEngine(); + expect(engine.noteText('un message')).toBe(true); + expect(engine.noteText('un message')).toBe(false); + expect(state.notebook).toEqual(['un message']); + }); + + it('objet inutilisable en l\'état : son propre message', () => { + const { engine, state, hs, messages } = makeEngine({ items: [{ id: 'x', name: 'X', icon: '', unusable: 'éteint' }] }); + state.inventory = ['x']; + engine.selectItem('x'); + engine.click(hs('dial')); + expect(messages.at(-1)).toBe('éteint'); + }); + it('navigation générée (flèches)', () => { const { engine, state, hs } = makeEngine(); engine.click(hs('__right')); diff --git a/tests/smoke.cjs b/tests/smoke.cjs index c6ca913..0a60ff3 100644 --- a/tests/smoke.cjs +++ b/tests/smoke.cjs @@ -146,7 +146,9 @@ function check(state, c) { await slot(step.combine[0]); await slot(step.combine[1]); } else if ('note' in step) { - await page.click('.message .clue-btn'); + // Facile : noté d'office. Difficile : bouton sur le message. + const noted = await page.evaluate((id) => window.__escape.engine.state.notebook.includes(id), step.note); + if (!noted) await page.click('.message .clue-btn'); await page.waitForFunction((id) => window.__escape.engine.state.notebook.includes(id), step.note); } else if ('solve' in step) { const def = await page.evaluate((id) => window.__escape.engine.scenario.puzzles.find((p) => p.id === id), step.solve);