# XWUIGameComboCounter

A hit-combo display whose number grows in font size as the `count` climbs and shakes on every registered hit, with a score `multiplier` (e.g. x1.5) that steps up every 5 hits. After `decayTime` seconds of inactivity the combo decays and fades out via `reset()`. Call `hit()` to add to the streak; tune `maxSize` for the peak font size at high combos and `position` to anchor it on screen.

## Basic Usage

A combo counter that scales up and shakes on each hit, showing a rising score multiplier.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A combo counter that scales up and shakes on each hit, showing a rising score multiplier.
```

## Rising Combo

A combo built from zero with rapid hits, scaling the number and stepping the multiplier.

```example
file: examples/RisingCombo.ts
html: examples/RisingCombo.html
title: Rising Combo
description: A combo built from zero with rapid hits, scaling the number and stepping the multiplier.
```

## Combo Decay

A short combo that is allowed to lapse, fading out after the decay window.

```example
file: examples/ComboDecay.ts
html: examples/ComboDecay.html
title: Combo Decay
description: A short combo that is allowed to lapse, fading out after the decay window.
```

## High Streak

A 50-hit combo anchored top-right at maximum font size with a high x5.5 score multiplier.

```example
file: examples/HighStreak.ts
html: examples/HighStreak.html
title: High Streak
description: A peak 50-hit streak pinned top-right at max font size with a x5.5 multiplier.
```

## Live Rally

Starts from zero and drives the combo upward with successive `hit()` calls, scaling and shaking on every hit.

```example
file: examples/LiveRally.ts
html: examples/LiveRally.html
title: Live Rally
description: A combo that climbs live as repeated hit() calls scale the number and shake it on each hit.
```

```api
```