Volume Price Trend

This indicator provides an implementation of the Volume Price
Trend (VPT) momentum indicator, enhanced with a built-in
divergence detection engine.

Key Features:

1. **Full Divergence Suite (Class A, B, C):** The primary feature
is the integrated divergence engine. It automatically
detects and plots all three major types of divergences:
- Regular (A): Signals potential trend reversals.
- Hidden (B): Signals potential trend continuations.
- Exaggerated (C): Signals weakness at double tops/bottoms.

2. **Divergence Filtering and Visualization:**
- **Price Tolerance Filter:** Divergence detection is enhanced
with a percentage-based price tolerance (`pivPrcTol`) to
filter out insignificant market noise, leading to more
robust signals.
- **Persistent Visualization:** Divergence markers are plotted
for the entire duration of the signal and are visually
anchored to the VPT level of the confirming pivot.
- **Flexible Pivot Algorithms:** Supports various underlying
mathematical models for pivot detection provided by the
core library

3. **Note on Confirmation (Lag):** Divergence signals rely on a
pivot confirmation method to ensure they do not repaint.
- The **Start** of a divergence is only detected *after* the
confirming pivot is fully formed (a delay based on
`Pivot Right Bars`).
- The **End** of a divergence is detected either instantly
(if the signal is invalidated by price action) or with
a delay (when a new, non-divergent pivot is confirmed).

4. **Multi-Timeframe (MTF) Capability:**
- **MTF VPT Line:** The VPT line *itself* can be calculated on a
higher timeframe, with standard options to handle gaps
(`Fill Gaps`) and prevent repainting (`Wait for...`).
- **Limitation:** The Divergence detection engine (`pivDiv`)
is **disabled** if a timeframe other than the chart's
timeframe is selected. Divergences are only calculated
on the active chart timeframe.

5. **Integrated Alerts:** Includes comprehensive alerts that
trigger on the *start* and *end* of all divergence types
(e.g., "Regular Bullish Started", "Regular Bullish Ended").

---

**DISCLAIMER**

1. **For Informational/Educational Use Only:** This indicator is
provided for informational and educational purposes only. It does
not constitute financial, investment, or trading advice, nor is
it a recommendation to buy or sell any asset.

2. **Use at Your Own Risk:** All trading decisions you make based on
the information or signals generated by this indicator are made
solely at your own risk.

3. **No Guarantee of Performance:** Past performance is not an
indicator of future results. The author makes no guarantee
regarding the accuracy of the signals or future profitability.

4. **No Liability:** The author shall not be held liable for any
financial losses or damages incurred directly or indirectly from
the use of this indicator.

5. **Signals Are Not Recommendations:** The alerts and visual signals
(e.g., crossovers) generated by this tool are not direct
recommendations to buy or sell. They are technical observations
for your own analysis and consideration.