# junxiangzhan/gacha-compute architecture

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

- Interactive diagram: https://gitdiagram.com/junxiangzhan/gacha-compute
- Repository: https://github.com/junxiangzhan/gacha-compute

## Overview

This Rust library computes exact gacha-pull probability distributions, exposing game-specific calculations through a WebAssembly interface and returning rounded distributions, cumulative probabilities, threshold indexes, expected value, and variance. The principal workflow is input data and thresholds → game-specific pity/guarantee model → exact distribution operations → result conversion. The README also documents three game models and optimized convolution. Arknights Endfield’s excerpt is partial; unsampled internals are represented only at their supported module path.

Main entry points: [`src/distribution.rs`](https://github.com/junxiangzhan/gacha-compute/blob/master/src/distribution.rs) (Exact distribution), [`src/lib.rs`](https://github.com/junxiangzhan/gacha-compute/blob/master/src/lib.rs) (Wasm compute API), [`src/games/wuthering_waves.rs`](https://github.com/junxiangzhan/gacha-compute/blob/master/src/games/wuthering_waves.rs) (Wuthering Waves), [`src/games/honkai_star_rail.rs`](https://github.com/junxiangzhan/gacha-compute/blob/master/src/games/honkai_star_rail.rs) (Honkai Star Rail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Public interface"]
  node_wasm_api["Wasm compute API<br/>[lib.rs]"]
  node_result["Result conversion<br/>[lib.rs]"]
end

subgraph group_models["Game models"]
  node_ww_model["Wuthering Waves<br/>[wuthering_waves.rs]"]
  node_hsr_model["Honkai Star Rail"]
  node_endfield_model["Endfield model"]
  node_game_utils["Game probability helpers<br/>[utils.rs]"]
end

subgraph group_math["Exact probability math"]
  node_distribution["Exact distribution<br/>[distribution.rs]"]
  node_addition["Distribution addition<br/>[add.rs]"]
  node_convolution["Packed convolution<br/>[convolve.rs]"]
  node_scaling["Distribution scaling<br/>[scale.rs]"]
end

subgraph group_optimization["Calculation optimization"]
  node_merge["Cost-priority merge<br/>[commutative.rs]"]
end

node_consumer(("Frontend caller"))
node_wasm_runtime{{"WebAssembly runtime"}}

node_consumer -->|"submits inputs"| node_wasm_api
node_wasm_api -->|"dispatches compute"| node_ww_model
node_wasm_api -->|"dispatches compute"| node_hsr_model
node_wasm_api -->|"dispatches compute"| node_endfield_model
node_ww_model -->|"passes distribution"| node_result
node_hsr_model -->|"passes distribution"| node_result
node_endfield_model -->|"passes distribution"| node_result
node_result -->|"returns metrics"| node_consumer
node_wasm_api -->|"exports bindings"| node_wasm_runtime
node_ww_model -->|"builds pull probabilities"| node_game_utils
node_hsr_model -->|"builds pull probabilities"| node_game_utils
node_endfield_model -->|"builds pull probabilities"| node_game_utils
node_game_utils -->|"constructs distributions"| node_distribution
node_ww_model -->|"combines distributions"| node_distribution
node_hsr_model -->|"combines distributions"| node_distribution
node_endfield_model -->|"uses distributions"| node_distribution
node_ww_model -->|"decomposes and merges"| node_merge
node_hsr_model -->|"decomposes and merges"| node_merge
node_addition -->|"implements addition"| node_distribution
node_convolution -->|"implements multiplication"| node_distribution
node_scaling -->|"implements scaling"| node_distribution

click node_wasm_api "https://github.com/junxiangzhan/gacha-compute/blob/master/src/lib.rs"
click node_result "https://github.com/junxiangzhan/gacha-compute/blob/master/src/lib.rs"
click node_ww_model "https://github.com/junxiangzhan/gacha-compute/blob/master/src/games/wuthering_waves.rs"
click node_hsr_model "https://github.com/junxiangzhan/gacha-compute/blob/master/src/games/honkai_star_rail.rs"
click node_endfield_model "https://github.com/junxiangzhan/gacha-compute/blob/master/src/games/arknights_endfield.rs"
click node_game_utils "https://github.com/junxiangzhan/gacha-compute/blob/master/src/games/utils.rs"
click node_distribution "https://github.com/junxiangzhan/gacha-compute/blob/master/src/distribution.rs"
click node_addition "https://github.com/junxiangzhan/gacha-compute/blob/master/src/distribution/add.rs"
click node_convolution "https://github.com/junxiangzhan/gacha-compute/blob/master/src/distribution/convolve.rs"
click node_scaling "https://github.com/junxiangzhan/gacha-compute/blob/master/src/distribution/scale.rs"
click node_merge "https://github.com/junxiangzhan/gacha-compute/blob/master/src/commutative.rs"

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_wasm_api,node_result,node_consumer toneBlue
class node_ww_model,node_hsr_model,node_endfield_model,node_game_utils toneAmber
class node_distribution,node_addition,node_convolution,node_scaling toneMint
class node_merge toneRose
class node_wasm_runtime toneIndigo
```

## Components

### Public interface

- [Wasm compute API](https://github.com/junxiangzhan/gacha-compute/blob/master/src/lib.rs): `src/lib.rs`
- [Result conversion](https://github.com/junxiangzhan/gacha-compute/blob/master/src/lib.rs): `src/lib.rs`

### Game models

- [Wuthering Waves](https://github.com/junxiangzhan/gacha-compute/blob/master/src/games/wuthering_waves.rs): `src/games/wuthering_waves.rs`
- [Honkai Star Rail](https://github.com/junxiangzhan/gacha-compute/blob/master/src/games/honkai_star_rail.rs): `src/games/honkai_star_rail.rs`
- [Endfield model](https://github.com/junxiangzhan/gacha-compute/blob/master/src/games/arknights_endfield.rs): `src/games/arknights_endfield.rs`
- [Game probability helpers](https://github.com/junxiangzhan/gacha-compute/blob/master/src/games/utils.rs): `src/games/utils.rs`

### Exact probability math

- [Exact distribution](https://github.com/junxiangzhan/gacha-compute/blob/master/src/distribution.rs): `src/distribution.rs`
- [Distribution addition](https://github.com/junxiangzhan/gacha-compute/blob/master/src/distribution/add.rs): `src/distribution/add.rs`
- [Packed convolution](https://github.com/junxiangzhan/gacha-compute/blob/master/src/distribution/convolve.rs): `src/distribution/convolve.rs`
- [Distribution scaling](https://github.com/junxiangzhan/gacha-compute/blob/master/src/distribution/scale.rs): `src/distribution/scale.rs`

### Calculation optimization

- [Cost-priority merge](https://github.com/junxiangzhan/gacha-compute/blob/master/src/commutative.rs): `src/commutative.rs`

### Other components

- **Frontend caller**
- **WebAssembly runtime**

## Connections

- Frontend caller → Wasm compute API: submits inputs (evidence: `readme.md`)
- Wasm compute API → Wuthering Waves: dispatches compute (evidence: `src/lib.rs`)
- Wasm compute API → Honkai Star Rail: dispatches compute (evidence: `src/lib.rs`)
- Wasm compute API → Endfield model: dispatches compute (evidence: `src/lib.rs`)
- Wuthering Waves → Result conversion: passes distribution (evidence: `src/lib.rs`)
- Honkai Star Rail → Result conversion: passes distribution (evidence: `src/lib.rs`)
- Endfield model → Result conversion: passes distribution (evidence: `src/lib.rs`)
- Result conversion → Frontend caller: returns metrics (evidence: `src/lib.rs`)
- Wasm compute API → WebAssembly runtime: exports bindings (evidence: `readme.md`)
- Wuthering Waves → Game probability helpers: builds pull probabilities (evidence: `src/games/wuthering_waves.rs`)
- Honkai Star Rail → Game probability helpers: builds pull probabilities (evidence: `src/games/honkai_star_rail.rs`)
- Endfield model → Game probability helpers: builds pull probabilities (evidence: `src/games/arknights_endfield.rs`)
- Game probability helpers → Exact distribution: constructs distributions (evidence: `src/games/utils.rs`)
- Wuthering Waves → Exact distribution: combines distributions (evidence: `src/games/wuthering_waves.rs`)
- Honkai Star Rail → Exact distribution: combines distributions (evidence: `src/games/honkai_star_rail.rs`)
- Endfield model → Exact distribution: uses distributions (evidence: `src/games/arknights_endfield.rs`)
- Wuthering Waves → Cost-priority merge: decomposes and merges (evidence: `src/games/wuthering_waves.rs`)
- Honkai Star Rail → Cost-priority merge: decomposes and merges (evidence: `src/games/honkai_star_rail.rs`)
- Distribution addition → Exact distribution: implements addition (evidence: `src/distribution/add.rs`)
- Packed convolution → Exact distribution: implements multiplication (evidence: `src/distribution/convolve.rs`)
- Distribution scaling → Exact distribution: implements scaling (evidence: `src/distribution/scale.rs`)
