Imported from wmioch/DandyCharacterExplorer (AGENTS.md). Install upstream with npx skills add wmioch/DandyCharacterExplorer. Copyright stays with the author.

AGENTS.md

This file provides guidance to Codex (Codex.ai/code) when working with code in this repository.

Running the App

This is a static site that requires a local web server due to CORS restrictions — never open index.html directly via file://.

python -m http.server 8000
# Then open http://localhost:8000

Alternatively, start_server.bat handles server lifecycle (kills existing, auto-detects http-server / live-server / python).

Do NOT run start index.html or any command that opens a browser. No build step, no tests, no linting — changes are visible immediately on page refresh.

Architecture

Pure HTML/CSS/Vanilla JS for the frontend. The feedback backend lives in api/ as a small Node.js Azure Functions app.

JS Modules (loaded as globals via <script> tags)

Backend (api/)

• Azure Functions Node v4 app
• Entry point: api/src/index.js
• Endpoints:
  • POST /api/feedback
  • GET /api/feedback
  • GET /api/healthz
• Uses Azure Table Storage via AzureWebJobsStorage
• Install backend deps with npm ci inside api/

Data Flow

App.init()
  → DataLoader.loadAllData()   (fetches 5 JSON files)
  → App.populateUI()           (calls UI.populate* functions)
  → user interaction
  → App.handleToonChange() etc.
      → Calculator.calculateFinalStats(toon, trinkets, teamAbilities, items, conditionalStat, teamSize)
      → UI.updateStatDisplay(finalStats)

Stat Calculation Order (in calculator.js)

1. Start with toon.baseStats
2. Apply conditional stat set overrides (e.g., Looey's hearts, Razzle & Dazzle floors)
3. Apply base stat overrides from player abilities (Flutter, Rudie, Eclipse)
4. Apply baseStatIncrease effects from trinkets/items (e.g., +50 stamina flat)
5. Collect multiplicative and additive modifiers from: player abilities → conditional modifier overrides → trinket effects → team abilities → item effects
6. Apply Bone trinket with special 40-unit stealth cap logic
7. Apply all modifiers and compute final display stats

Data Files (data/)

• toons.json — character definitions: baseStats, starRatings, ability, ability2, optional conditionalStats
• trinkets.json — each trinket has effects[] with applicationType: multiplicative | additive | baseStatIncrease. hidden: true trinkets are excluded from the visible list.
• items.json — consumable items with stackable counts
• twisteds.json — enemy speed data for the comparison table
• stat-mappings.json — maps star ratings (1–5) to numeric stat values

Key App State (App.state)

• selectedToon — current player toon object
• equippedTrinkets — array of {trinket, count} for stackable trinkets
• teamMembers[7] — team slots (null = empty)
• teamToons — map of toonId → count for team selection UI
• activeAbilities / activeItems — toggled buffs
• currentStarFilters — per-stat star rating filter active in the toon grid modal
• skillCheckSuccessRate — slider value (0–1) for machine extraction time calculation

Feedback Notes

• The frontend feedback button is always present, but submission stays unconfigured until js/feedback-config.js contains the deployed Azure Function URL.
• Dandy-specific context stays embedded inside feedback.message; ecg_case remains null.
• The live site still runs as a static GitHub Pages site; only the feedback backend deploys through GitHub Actions.