Files

Claude Agent dba7fff7a2 Iterația 3: Joc-în-URL + QR (compresie, player hash, encoder QR, UI share)

Stage 1: `deflateToBase64url`/`inflateFromBase64url` (CompressionStream deflate-raw,
offline, file://); `SNIP.compressJs` cu helpers inflate (doubled backslashes).

Stage 2: `campaignShell({tplJson,masterExpr,titleExpr,nStyles,bootMode})` refactor;
gameCampaign = wrapper subțire; bootMode='inline' (nop) | 'hash' (player).

Stage 3: `playerHTML()` — toate 5 motoare inline; boot async cu `(async function(){})()`
(fix: lipsea `function`, eroare Unexpected token '{' în Chromium); MASTER din
location.hash deflate-raw; orchestrator în <script type="text/plain" id="run">.

Stage 4: Encoder QR vanilla JS — GF(256), Reed-Solomon ECC L, byte mode, versiuni 1-22,
8 măști + penalty, BCH format/version. `makeQrSvg(text, opts)` → SVG.

Stage 5: UI builder — fieldset distribuie, #btnShare/#btnCopyLink/#btnDownloadPlayer/
#btnPrintQr, #qrBox, #qrCard (print A4). baseUrl în state, deleted din cleanState().

Tests: 41/41 (6 noi @share). Fix test player: necesită __ow.enterDoor(0) după btn-start
(overworld first, then enter room). Demo files: restaurate din git (configs hardcodate în @regresie).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-06-14 12:58:41 +00:00

4.3 KiB

Raw Blame History

AGENTS.md — Escape Room Builder (root)

Generator de jocuri escape room: un singur fișier HTML, fără backend/build/dependențe. Același set de puzzle-uri se exportă în 6 motoare de joc. Acest arbore AGENTS.md e sursa de adevăr tehnică pentru agenți.

Protocol DOX

Citire — înainte de a edita un path, cobori din rădăcină citind fiecare AGENTS.md întâlnit; dacă un părinte indexează un copil al cărui scope conține path-ul, citești copilul.
Editare — AGENTS.md-ul cel mai apropiat = contract local; părinții = reguli globale. Un copil NU poate slăbi o constrângere a unui părinte.
Update — după orice schimbare semnificativă, actualizezi AGENTS.md-ul care deține zona
- indexul părintelui; ștergi textul învechit.

Quick Reference

# Rulare/verificare — deschide direct în browser (merge de pe file://) sau servește local:
python3 -m http.server 8000

# Teste (Playwright; fără package.json commitat — vezi tests/AGENTS.md):
npx playwright test tests/smoke.mjs                    # suita completă: 41/41
npx playwright test tests/smoke.mjs --grep @regresie   # regresie: 16
npx playwright test tests/smoke.mjs --grep @campanie   # campanie E2E: 21
npx playwright test tests/smoke.mjs --grep @share      # Iterația 3: 6

Durable Rules (repo-wide)

Zero dependențe. Produsul (fișierele *.html) e vanilla HTML/CSS/JS, merge offline de pe file://. node_modules/, package.json, playwright.config.mjs, scratch/, test-results/ sunt gitignored — doar dev tooling, nu fac parte din produs.
Un singur fișier. Toată aplicația trăiește în escape-builder.html (~3200 linii), pe secțiuni comentate: stare · editor · preview · template-urile jocului exportat.
Dispatch. gameHTML(cfg) rutează pe cfg.style către 6 motoare: gameClassic · gameTerminal · gameArcade · gameChat · gamePoint · gameCampaign. Fiecare returnează un string HTML complet, standalone. playerHTML() generează player universal (hash-mode, toate 5 motoare inline, MASTER din location.hash comprimat deflate-raw+base64url).
Cod partajat = blast radius global. libJS(cfg) (CFG, norm, checkAnswer, starsFor, finalWord, beep, confetti) și SNIP.* (baseCss, modal, ecran final) sunt injectate în TOATE motoarele. O schimbare aici → verifică fiecare stil în preview înainte de commit.
Backslash dublu. Motoarele sunt template literals mari: backslash-urile din codul GENERAT se dublează (\\u0300, \\n). Codul generat folosește var/function clasic — intenționat.
Sentinel __CFG__. Templatele per stil emit __CFG__ (la cfg === '__TEMPLATE__') și se injectează prin replace-FUNCȚIE, nu string — protejează $/$& din config (D1).
Demo-urile sunt generate. exemplu-*.html = jocuri exportate din builder, unul per stil. NU le edita manual — după modificări la motoare, regenerează prin export. index.html = doar landing care leagă builder-ul + demo-urile.
Stare. Obiectul state (titlu, poveste, culoare, style, puzzles) se persistă în localStorage sub cheia escape-builder-v1; export/import ca JSON. Editorul scrie via data-g → onChange() → persist + refreshPreview() (debounce 400ms) care setează iframe.srcdoc.
Design = DESIGN.md. Sursă unică de adevăr vizual pentru campanie (tokens :root, intro-poster, coridor, diplomă). Note „nu se repară" (violet default, system-ui, lipsa webfonturilor pe file://) sunt deliberate — consultă fișierul înainte de schimbări vizuale.

Documente conexe (conținut, nu contracte)

DESIGN.md — contract de design campanie (vizual/interacțiune).
TODOS.md — board de progres durabil + backlog. Secțiunea „▶ BOARD ACTIV" sus = sursa de adevăr pentru ce e în lucru; harness task list-ul se resetează între sesiuni, ăsta nu. La START de sesiune citește board-ul; mută [ ]→[~]→[x]→[!] pe măsură ce avansezi și commit.
HANDOFF.md — handoff de sesiune (efemer; direcția curentă de lucru).
README.md — descriere pentru utilizatorul final.

Child DOX Index

tests/ → tests/AGENTS.md — harness Playwright (smoke/regresie/campanie E2E).
scratch/ → scratch/AGENTS.md — zonă de prototipuri & QA (gitignored, efemer).

4.3 KiB Raw Blame History