# rabi-alz/strikemath architecture

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

- Interactive diagram: https://gitdiagram.com/rabi-alz/strikemath
- Repository: https://github.com/rabi-alz/strikemath

## Overview

strikemath is a dependency-free TypeScript options-mathematics library. A consumer calls its named exports for European Black–Scholes or European/American binomial prices, analytical Greeks and explicit unit conversions, implied volatility, or risk measures. Those domain calculations rely on shared normal-distribution and input-validation utilities. The source index establishes module references, while excerpts show several calls; unsampled risk and helper internals are represented at module level, and no external service or persistent store is indicated.

Main entry points: [`src/index.ts`](https://github.com/rabi-alz/strikemath/blob/main/src/index.ts) (Named exports), [`src/utils/validate.ts`](https://github.com/rabi-alz/strikemath/blob/main/src/utils/validate.ts) (Input validation), [`src/utils/normal.ts`](https://github.com/rabi-alz/strikemath/blob/main/src/utils/normal.ts) (Normal functions), [`src/volatility/impliedVol.ts`](https://github.com/rabi-alz/strikemath/blob/main/src/volatility/impliedVol.ts) (Implied volatility)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public API"]
  node_exports["Named exports<br/>[index.ts]"]
  node_types["Option types<br/>[types.ts]"]
end

subgraph group_options["Option Analytics"]
  node_blackscholes["Black–Scholes<br/>[blackScholes.ts]"]
  node_binomial["Binomial pricing<br/>[binomial.ts]"]
  node_greeks["Analytical Greeks<br/>[analytical.ts]"]
  node_scaling["Greek scaling<br/>[scaling.ts]"]
  node_implied["Implied volatility<br/>[impliedVol.ts]"]
end

subgraph group_risk["Risk Measures"]
  node_probability["Q probabilities<br/>[probability.ts]"]
  node_var["Value at Risk<br/>[var.ts]"]
  node_cvar["Conditional VaR<br/>[cvar.ts]"]
  node_kelly["Kelly sizing<br/>[kelly.ts]"]
end

subgraph group_math["Math Utilities"]
  node_normal["Normal functions<br/>[normal.ts]"]
  node_validate["Input validation<br/>[validate.ts]"]
end

node_consumer(("TypeScript consumer"))

node_consumer -->|"calls"| node_exports
node_exports -->|"exports types"| node_types
node_exports -->|"exports pricing"| node_blackscholes
node_exports -->|"exports pricing"| node_binomial
node_exports -->|"exports Greeks"| node_greeks
node_exports -->|"exports scaling"| node_scaling
node_exports -->|"exports solver"| node_implied
node_exports -->|"exports risk"| node_probability
node_exports -->|"exports risk"| node_var
node_exports -->|"exports risk"| node_cvar
node_exports -->|"exports risk"| node_kelly
node_blackscholes -->|"uses distribution"| node_normal
node_blackscholes -->|"resolves inputs"| node_validate
node_binomial -->|"resolves inputs"| node_validate
node_greeks -->|"uses distribution"| node_normal
node_greeks -->|"resolves inputs"| node_validate
node_implied -->|"prices candidates"| node_blackscholes
node_implied -->|"uses vega"| node_greeks
node_implied -->|"checks inputs"| node_validate
node_probability -->|"uses CDF"| node_normal
node_probability -->|"resolves inputs"| node_validate
node_var -->|"uses quantile"| node_normal
node_var -->|"checks inputs"| node_validate
node_cvar -->|"uses density quantile"| node_normal
node_cvar -->|"reuses loss helpers"| node_var
node_kelly -->|"checks inputs"| node_validate

click node_exports "https://github.com/rabi-alz/strikemath/blob/main/src/index.ts"
click node_types "https://github.com/rabi-alz/strikemath/blob/main/src/utils/types.ts"
click node_blackscholes "https://github.com/rabi-alz/strikemath/blob/main/src/pricing/blackScholes.ts"
click node_binomial "https://github.com/rabi-alz/strikemath/blob/main/src/pricing/binomial.ts"
click node_greeks "https://github.com/rabi-alz/strikemath/blob/main/src/greeks/analytical.ts"
click node_scaling "https://github.com/rabi-alz/strikemath/blob/main/src/greeks/scaling.ts"
click node_implied "https://github.com/rabi-alz/strikemath/blob/main/src/volatility/impliedVol.ts"
click node_probability "https://github.com/rabi-alz/strikemath/blob/main/src/risk/probability.ts"
click node_var "https://github.com/rabi-alz/strikemath/blob/main/src/risk/var.ts"
click node_cvar "https://github.com/rabi-alz/strikemath/blob/main/src/risk/cvar.ts"
click node_kelly "https://github.com/rabi-alz/strikemath/blob/main/src/risk/kelly.ts"
click node_normal "https://github.com/rabi-alz/strikemath/blob/main/src/utils/normal.ts"
click node_validate "https://github.com/rabi-alz/strikemath/blob/main/src/utils/validate.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_exports,node_types toneBlue
class node_blackscholes,node_binomial,node_greeks,node_scaling,node_implied toneAmber
class node_probability,node_var,node_cvar,node_kelly toneMint
class node_normal,node_validate toneRose
class node_consumer toneIndigo
```

## Components

### Public API

- [Named exports](https://github.com/rabi-alz/strikemath/blob/main/src/index.ts): `src/index.ts`
- [Option types](https://github.com/rabi-alz/strikemath/blob/main/src/utils/types.ts): `src/utils/types.ts`

### Option Analytics

- [Black–Scholes](https://github.com/rabi-alz/strikemath/blob/main/src/pricing/blackScholes.ts): `src/pricing/blackScholes.ts`
- [Binomial pricing](https://github.com/rabi-alz/strikemath/blob/main/src/pricing/binomial.ts): `src/pricing/binomial.ts`
- [Analytical Greeks](https://github.com/rabi-alz/strikemath/blob/main/src/greeks/analytical.ts): `src/greeks/analytical.ts`
- [Greek scaling](https://github.com/rabi-alz/strikemath/blob/main/src/greeks/scaling.ts): `src/greeks/scaling.ts`
- [Implied volatility](https://github.com/rabi-alz/strikemath/blob/main/src/volatility/impliedVol.ts): `src/volatility/impliedVol.ts`

### Risk Measures

- [Q probabilities](https://github.com/rabi-alz/strikemath/blob/main/src/risk/probability.ts): `src/risk/probability.ts`
- [Value at Risk](https://github.com/rabi-alz/strikemath/blob/main/src/risk/var.ts): `src/risk/var.ts`
- [Conditional VaR](https://github.com/rabi-alz/strikemath/blob/main/src/risk/cvar.ts): `src/risk/cvar.ts`
- [Kelly sizing](https://github.com/rabi-alz/strikemath/blob/main/src/risk/kelly.ts): `src/risk/kelly.ts`

### Math Utilities

- [Normal functions](https://github.com/rabi-alz/strikemath/blob/main/src/utils/normal.ts): `src/utils/normal.ts`
- [Input validation](https://github.com/rabi-alz/strikemath/blob/main/src/utils/validate.ts): `src/utils/validate.ts`

### Other components

- **TypeScript consumer**

## Connections

- TypeScript consumer → Named exports: calls (evidence: `README.md`)
- Named exports → Option types: exports types (evidence: `src/index.ts`)
- Named exports → Black–Scholes: exports pricing (evidence: `src/index.ts`)
- Named exports → Binomial pricing: exports pricing (evidence: `src/index.ts`)
- Named exports → Analytical Greeks: exports Greeks (evidence: `src/index.ts`)
- Named exports → Greek scaling: exports scaling (evidence: `src/index.ts`)
- Named exports → Implied volatility: exports solver (evidence: `src/index.ts`)
- Named exports → Q probabilities: exports risk (evidence: `src/index.ts`)
- Named exports → Value at Risk: exports risk (evidence: `src/index.ts`)
- Named exports → Conditional VaR: exports risk (evidence: `src/index.ts`)
- Named exports → Kelly sizing: exports risk (evidence: `src/index.ts`)
- Black–Scholes → Normal functions: uses distribution (evidence: `src/pricing/blackScholes.ts`)
- Black–Scholes → Input validation: resolves inputs (evidence: `src/pricing/blackScholes.ts`)
- Binomial pricing → Input validation: resolves inputs (evidence: `src/pricing/binomial.ts`)
- Analytical Greeks → Normal functions: uses distribution (evidence: `src/greeks/analytical.ts`)
- Analytical Greeks → Input validation: resolves inputs (evidence: `src/greeks/analytical.ts`)
- Implied volatility → Black–Scholes: prices candidates (evidence: `src/volatility/impliedVol.ts`)
- Implied volatility → Analytical Greeks: uses vega (evidence: `src/volatility/impliedVol.ts`)
- Implied volatility → Input validation: checks inputs (evidence: `src/volatility/impliedVol.ts`)
- Q probabilities → Normal functions: uses CDF (evidence: `src/risk/probability.ts`)
- Q probabilities → Input validation: resolves inputs (evidence: `src/risk/probability.ts`)
- Value at Risk → Normal functions: uses quantile (evidence: `src/risk/var.ts`)
- Value at Risk → Input validation: checks inputs (evidence: `src/risk/var.ts`)
- Conditional VaR → Normal functions: uses density quantile (evidence: `src/risk/cvar.ts`)
- Conditional VaR → Value at Risk: reuses loss helpers (evidence: `src/risk/cvar.ts`)
- Kelly sizing → Input validation: checks inputs (evidence: `src/risk/kelly.ts`)
