Beast Mode - Hull Suite Pro

Beast Mode – Hull Suite Pro is a trend-following overlay indicator built around a dual “Hull ribbon” concept: a fast ribbon for swing/entry timing and an optional slow ribbon for higher-timeframe style trend context. It aims to make trend direction, trend changes, and lower-quality (choppy/ranging) conditions easy to see directly on price.

---

Core concept (what it does)

1) Fast Signal Ribbon (primary direction + flips)
The indicator computes a fast Hull-style moving average using your selected Hull variation and length. It then plots two lines:
- Fast Main = current fast Hull value
- Fast Lag = prior-bar fast Hull value

The space between them is filled to form a ribbon. When Fast Main is above Fast Lag, the ribbon is considered bullish and plotted green. When Fast Main is below Fast Lag, it is considered bearish and plotted red. This creates a simple, visual “slope/continuation” read without needing extra panels.

2) Slow Trend Ribbon (optional trend filter / bias)
A second, slower Hull-style ribbon (default length is user-configurable) can be plotted as a trend context layer. Like the fast ribbon, it uses a main line and its prior-bar value to determine direction. When enabled, it provides a higher-level bias that can be used to filter signals from the fast ribbon.

3) Chop Filter (optional ranging-market filter)
The script includes an optional Choppiness Index filter. When enabled, it blocks buy/sell labels during choppy conditions where trend-following signals often degrade. “Choppy” is defined as Choppiness Index above the user threshold.

4) Visual helpers (optional)
- Candle coloring can be enabled to match the fast ribbon direction.
- A compact dashboard table can be shown on the chart to summarize the current fast trend, slow trend, and whether filters are enabled.

---

How it works (calculation overview)

Hull variations
The indicator lets you choose one of three smoothing/response styles for both the fast ribbon and the slow ribbon:
- Hma: Hull Moving Average
- Ehma: EMA-based Hull variant
- Thma: Triangular/WMA-based Hull variant

A “Length Multiplier” scales the fast length to quickly tune sensitivity without changing your base length.

Preset system
A preset selector automatically adjusts the fast length and Hull variation for common use-cases:
- Fast: shorter length, more responsive (more signals, more noise)
- Balanced: middle ground
- Trend: longer and smoother (fewer signals)

Selecting “Custom” uses your manual inputs.

Fast ribbon direction state
- fastUp is true when the fast Hull value is higher than its previous value (Fast Main > Fast Lag).
- Color and candle coloring (if enabled) follow this state.

Slow ribbon direction state
- slowUp is true when the slow Hull value is higher than its previous value (Trend Main > Trend Lag).
- The slow ribbon is optional and can be hidden.

Choppiness Index
When enabled, the script computes the Choppiness Index over the chosen length and flags the market as choppy if it exceeds the threshold. Signals can be blocked during these flagged periods.

---

Signals (how buy/sell labels are generated)

Buy label (raw):
A Buy is triggered when the fast ribbon flips from bearish to bullish (fastUp becomes true after being false on the prior bar).

Sell label (raw):
A Sell is triggered when the fast ribbon flips from bullish to bearish (fastUp becomes false after being true on the prior bar).

Optional filters:
- Trend Filter (optional):
- If enabled, Buy labels only appear when the slow ribbon is bullish (slowUp = true).
- Sell labels only appear when the slow ribbon is bearish (slowUp = false).
- Chop Filter (optional):
- If enabled, both Buy and Sell labels are suppressed when the market is flagged as choppy (Choppiness Index > threshold).

These filters are designed to reduce low-quality flips in sideways markets and align signals with the broader trend context when desired.

---

How to use it (practical guidance)

1) Trend direction / bias
- Use the fast ribbon color and slope as your near-term trend read.
- If enabled, use the slow ribbon as a higher-level bias filter (e.g., focus on longs when the slow ribbon is green).

2) Entries and timing
- Buy/Sell labels are based on fast ribbon flips. Many traders treat flips as potential momentum shifts rather than guaranteed reversals. Consider confirming with your own market context (structure, levels, volume, session, etc.).

3) Avoiding chop (optional)
- If you trade trend continuation, enabling the Chop Filter can help avoid frequent flips during consolidation.
- Lower chop thresholds are stricter (fewer signals). Higher thresholds allow more signals through.

4) Parameter tuning
- Faster settings will react earlier but can whipsaw.
- Smoother settings reduce noise but can lag.
- The Length Multiplier is a quick way to adjust sensitivity without redesigning the setup.

---

Visual settings
- Show Buy/Sell Labels: toggles label plotting.
- Color Candles: colors bars based on the fast ribbon direction.
- Line Thickness / Fill Transparency: adjust readability.
- Dashboard: shows a small table with current states and filter status. Position is user-selectable.

---

Limitations / notes
- This indicator is not a strategy and does not provide backtest performance results.
- Like all moving-average-based tools, it is lagging by nature and can produce false flips in ranging conditions.
- The Chop Filter helps reduce ranging-market noise but will also filter out some early trend transitions.
- Signals are conditional visual markers and should be used with risk management and confirmation rules appropriate to your trading plan.