# azedl/danqingsimulator architecture

> Architecture diagram of the GitHub repository azedl/danqingsimulator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azedl/danqingsimulator
- Repository: https://github.com/azedl/danqingsimulator

## Overview

This is a browser-based card-combat damage simulator. Users configure baseline DPS, duration, skill upgrades, and card loadouts, then run a manual simulation or search combinations automatically and inspect damage results. The engine advances card actions and queued effects over time while accumulating damage. The graph includes the documented card catalog and configuration capabilities; several UI panels and simulator internals are unsampled, so their detailed interactions are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/azedl/danqingsimulator/blob/main/src/App.tsx) (Application shell), [`src/features/autoMock/useAutoMock.ts`](https://github.com/azedl/danqingsimulator/blob/main/src/features/autoMock/useAutoMock.ts) (Auto-search coordinator), [`src/features/simulator/useSimulation.ts`](https://github.com/azedl/danqingsimulator/blob/main/src/features/simulator/useSimulation.ts) (Manual simulation state), [`src/kernel/core/Core.ts`](https://github.com/azedl/danqingsimulator/blob/main/src/kernel/core/Core.ts) (Simulation core)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Simulator interface"]
  node_app["Application shell<br/>[App.tsx]"]
  node_basic["Basic settings"]
  node_loadout["Card loadout"]
  node_controls["Simulation controls"]
  node_results["Results view<br/>[ResultPanel.tsx]"]
end

subgraph group_workflow["Simulation workflow"]
  node_config["Simulator configuration<br/>[simulatorUi.ts]"]
  node_defaults["Default settings"]
  node_simulation["Manual simulation state<br/>[useSimulation.ts]"]
  node_format["Damage result formatting<br/>[result.ts]"]
end

subgraph group_search["Automatic search"]
  node_auto_hook["Auto-search coordinator<br/>[useAutoMock.ts]"]
  node_worker["Search worker<br/>[autoMock.worker.ts]"]
  node_search_logic["Combination search<br/>[autoMock.ts]"]
  node_search_settings["Search settings"]
  node_worker_pool["Worker sizing"]
end

subgraph group_engine["Combat engine"]
  node_core["Simulation core<br/>[Core.ts]"]
  node_damage["Damage accounting<br/>[Damage.ts]"]
  node_cards["Card catalog<br/>[index.ts]"]
  node_card_model["Card behavior model<br/>[Card.ts]"]
  node_card_ids["Card identifiers<br/>[cardIds.ts]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"creates state"| node_simulation
node_app -->|"renders"| node_basic
node_app -->|"renders"| node_loadout
node_app -->|"renders"| node_controls
node_app -->|"renders"| node_results
node_app -->|"resolves upgrades"| node_config
node_simulation -->|"uses defaults"| node_defaults
node_simulation -->|"runs simulation"| node_core
node_simulation -->|"builds results"| node_format
node_results -->|"formats damage"| node_format
node_app -->|"coordinates search"| node_auto_hook
node_auto_hook -->|"dispatches work"| node_worker
node_auto_hook -->|"merges results"| node_search_logic
node_auto_hook -->|"reads limits"| node_search_settings
node_auto_hook -->|"sizes worker pool"| node_worker_pool
node_worker -->|"executes search"| node_search_logic
node_search_logic -->|"simulates candidates"| node_core
node_core -->|"loads cards"| node_cards
node_core -->|"records damage"| node_damage
node_cards -->|"uses card model"| node_card_model
node_card_model -->|"uses identifiers"| node_card_ids
node_config -->|"defines choices"| node_card_ids

click node_app "https://github.com/azedl/danqingsimulator/blob/main/src/App.tsx"
click node_basic "https://github.com/azedl/danqingsimulator/blob/main/src/components/panels/BasicConfigPanel.tsx"
click node_loadout "https://github.com/azedl/danqingsimulator/blob/main/src/components/panels/CardLoadoutPanel.tsx"
click node_controls "https://github.com/azedl/danqingsimulator/blob/main/src/components/panels/SimulationControlPanel.tsx"
click node_results "https://github.com/azedl/danqingsimulator/blob/main/src/components/panels/ResultPanel.tsx"
click node_config "https://github.com/azedl/danqingsimulator/blob/main/src/features/config/simulatorUi.ts"
click node_defaults "https://github.com/azedl/danqingsimulator/blob/main/src/features/config/simulatorDefaults.ts"
click node_simulation "https://github.com/azedl/danqingsimulator/blob/main/src/features/simulator/useSimulation.ts"
click node_format "https://github.com/azedl/danqingsimulator/blob/main/src/features/simulator/result.ts"
click node_auto_hook "https://github.com/azedl/danqingsimulator/blob/main/src/features/autoMock/useAutoMock.ts"
click node_worker "https://github.com/azedl/danqingsimulator/blob/main/src/features/autoMock/autoMock.worker.ts"
click node_search_logic "https://github.com/azedl/danqingsimulator/blob/main/src/features/autoMock/autoMock.ts"
click node_search_settings "https://github.com/azedl/danqingsimulator/blob/main/src/features/autoMock/autoMockSettings.ts"
click node_worker_pool "https://github.com/azedl/danqingsimulator/blob/main/src/features/autoMock/autoMockWorkerPool.ts"
click node_core "https://github.com/azedl/danqingsimulator/blob/main/src/kernel/core/Core.ts"
click node_damage "https://github.com/azedl/danqingsimulator/blob/main/src/kernel/core/Damage.ts"
click node_cards "https://github.com/azedl/danqingsimulator/blob/main/src/kernel/cards/index.ts"
click node_card_model "https://github.com/azedl/danqingsimulator/blob/main/src/kernel/cards/Card.ts"
click node_card_ids "https://github.com/azedl/danqingsimulator/blob/main/src/kernel/cards/cardIds.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_basic,node_loadout,node_controls,node_results,node_user toneBlue
class node_config,node_defaults,node_simulation,node_format toneAmber
class node_auto_hook,node_worker,node_search_logic,node_search_settings,node_worker_pool toneMint
class node_core,node_damage,node_cards,node_card_model,node_card_ids toneRose
```

## Components

### Simulator interface

- [Application shell](https://github.com/azedl/danqingsimulator/blob/main/src/App.tsx): `src/App.tsx`
- [Basic settings](https://github.com/azedl/danqingsimulator/blob/main/src/components/panels/BasicConfigPanel.tsx): `src/components/panels/BasicConfigPanel.tsx`
- [Card loadout](https://github.com/azedl/danqingsimulator/blob/main/src/components/panels/CardLoadoutPanel.tsx): `src/components/panels/CardLoadoutPanel.tsx`
- [Simulation controls](https://github.com/azedl/danqingsimulator/blob/main/src/components/panels/SimulationControlPanel.tsx): `src/components/panels/SimulationControlPanel.tsx`
- [Results view](https://github.com/azedl/danqingsimulator/blob/main/src/components/panels/ResultPanel.tsx): `src/components/panels/ResultPanel.tsx`

### Simulation workflow

- [Simulator configuration](https://github.com/azedl/danqingsimulator/blob/main/src/features/config/simulatorUi.ts): `src/features/config/simulatorUi.ts`
- [Default settings](https://github.com/azedl/danqingsimulator/blob/main/src/features/config/simulatorDefaults.ts): `src/features/config/simulatorDefaults.ts`
- [Manual simulation state](https://github.com/azedl/danqingsimulator/blob/main/src/features/simulator/useSimulation.ts): `src/features/simulator/useSimulation.ts`
- [Damage result formatting](https://github.com/azedl/danqingsimulator/blob/main/src/features/simulator/result.ts): `src/features/simulator/result.ts`

### Automatic search

- [Auto-search coordinator](https://github.com/azedl/danqingsimulator/blob/main/src/features/autoMock/useAutoMock.ts): `src/features/autoMock/useAutoMock.ts`
- [Search worker](https://github.com/azedl/danqingsimulator/blob/main/src/features/autoMock/autoMock.worker.ts): `src/features/autoMock/autoMock.worker.ts`
- [Combination search](https://github.com/azedl/danqingsimulator/blob/main/src/features/autoMock/autoMock.ts): `src/features/autoMock/autoMock.ts`
- [Search settings](https://github.com/azedl/danqingsimulator/blob/main/src/features/autoMock/autoMockSettings.ts): `src/features/autoMock/autoMockSettings.ts`
- [Worker sizing](https://github.com/azedl/danqingsimulator/blob/main/src/features/autoMock/autoMockWorkerPool.ts): `src/features/autoMock/autoMockWorkerPool.ts`

### Combat engine

- [Simulation core](https://github.com/azedl/danqingsimulator/blob/main/src/kernel/core/Core.ts): `src/kernel/core/Core.ts`
- [Damage accounting](https://github.com/azedl/danqingsimulator/blob/main/src/kernel/core/Damage.ts): `src/kernel/core/Damage.ts`
- [Card catalog](https://github.com/azedl/danqingsimulator/blob/main/src/kernel/cards/index.ts): `src/kernel/cards/index.ts`
- [Card behavior model](https://github.com/azedl/danqingsimulator/blob/main/src/kernel/cards/Card.ts): `src/kernel/cards/Card.ts`
- [Card identifiers](https://github.com/azedl/danqingsimulator/blob/main/src/kernel/cards/cardIds.ts): `src/kernel/cards/cardIds.ts`

### Other components

- **User**

## Connections

- User → Application shell: uses (evidence: `src/App.tsx`)
- Application shell → Manual simulation state: creates state (evidence: `src/App.tsx`)
- Application shell → Basic settings: renders (evidence: `src/App.tsx`)
- Application shell → Card loadout: renders (evidence: `src/App.tsx`)
- Application shell → Simulation controls: renders (evidence: `src/App.tsx`)
- Application shell → Results view: renders (evidence: `src/App.tsx`)
- Application shell → Simulator configuration: resolves upgrades (evidence: `src/App.tsx`)
- Manual simulation state → Default settings: uses defaults (evidence: `src/features/simulator/useSimulation.ts`)
- Manual simulation state → Simulation core: runs simulation (evidence: `src/features/simulator/useSimulation.ts`)
- Manual simulation state → Damage result formatting: builds results (evidence: `src/features/simulator/useSimulation.ts`)
- Results view → Damage result formatting: formats damage (evidence: `src/components/panels/ResultPanel.tsx`)
- Application shell → Auto-search coordinator: coordinates search (evidence: `src/App.tsx`)
- Auto-search coordinator → Search worker: dispatches work (evidence: `src/features/autoMock/useAutoMock.ts`)
- Auto-search coordinator → Combination search: merges results (evidence: `src/features/autoMock/useAutoMock.ts`)
- Auto-search coordinator → Search settings: reads limits (evidence: `src/features/autoMock/useAutoMock.ts`)
- Auto-search coordinator → Worker sizing: sizes worker pool (evidence: `src/features/autoMock/useAutoMock.ts`)
- Search worker → Combination search: executes search (evidence: `src/features/autoMock/autoMock.worker.ts`)
- Combination search → Simulation core: simulates candidates (evidence: `src/features/autoMock/autoMock.ts`)
- Simulation core → Card catalog: loads cards (evidence: `src/kernel/core/Core.ts`)
- Simulation core → Damage accounting: records damage (evidence: `src/kernel/core/Core.ts`)
- Card catalog → Card behavior model: uses card model (evidence: `src/kernel/cards/index.ts`)
- Card behavior model → Card identifiers: uses identifiers (evidence: `src/kernel/cards/Card.ts`)
- Simulator configuration → Card identifiers: defines choices (evidence: `src/features/config/simulatorUi.ts`)
