TTM Squeeze Pro Enhanced v1.5.1 [pyrevo]

# TTM Squeeze Pro Enhanced

**Version:** 1.5.1
**Author:** pyrevo
**License:** MPL 2.0

## Credits
This indicator is a collective work based on the contributions of the TradingView community:
* **John Carter**: Creator of the original TTM Squeeze and TTM Squeeze Pro concepts.
* **Lazybear**: Original interpretation of the TTM Squeeze (Squeeze Momentum Indicator).
* **Makit0**: Evolution of Lazybear's script to factor in TTM Squeeze Pro upgrades (Squeeze PRO Arrows).
* **marsrides**: Some aesthetics solutions.
* **Beardy_Fred**: The base code from which this enhanced version was derived.

## Overview
**TTM Squeeze Pro Enhanced** is a professional-grade momentum and volatility indicator designed to identify explosive breakout opportunities. It is a refined version of the community's collective works, with amendments primarily to the Squeeze Conditions and visual aesthetics to provide a clearer, more actionable reading of market state.

### The Concept
For those unfamiliar with the TTM Squeeze, it is a visual way of seeing how Bollinger Bands (standard deviations from a simple moving average) relate to Keltner Channels (average true range bands) compared with the momentum of the price action.

The concept is that as Bollinger Bands compress within Keltner Channels, price volatility decreases, giving way for a potential explosive price movement up or down.

### TTM Squeeze vs. TTM Squeeze Pro
* **Original TTM Squeeze:** Uses a 1.5 ATR Keltner Channel.
* **TTM Squeeze Pro (Enhanced):** Uses 1.0, 1.5, and 2.0 ATR Keltner Channels.

This helps differentiate between levels of squeeze (compression). The greater the compression (Bollinger Bands moving deeper into tighter Keltner Channels), the more potential for explosive moves.

## Indicator Analysis

### 1. Squeeze Detection (Dots)
The colored dots along the zero line represent the state of market volatility. This enhanced version uses a distinct color palette to indicate compression levels:

* **🔴 Red Dots (High Compression):** Extreme squeeze. One or both Bollinger Bands are inside the 1.0 ATR Keltner Channel.
* **🟠 Orange Dots (Medium Compression):** Significant squeeze. One or both BBs are inside the 1.5 ATR Keltner Channel.
* **⚪ Gray Dots (Low Compression):** Standard squeeze. One or both BBs are inside the 2.0 ATR Keltner Channel.
* **◽ Light Gray Dots (No Squeeze):** Volatility is normal or expanding. Squeeze has "fired".

### 2. Momentum (Histogram)
The histogram bars show price momentum relative to the squeeze:
* **Bright Green:** Positive, increasing momentum (Bullish).
* **Dark Green:** Positive, decreasing momentum (Bullish exhaustion).
* **Bright Red:** Negative, increasing momentum (Bearish).
* **Dark Red:** Negative, decreasing momentum (Bearish exhaustion).

### 3. Dual Momentum System
An optional secondary system to gauge trend strength:
* **Fast & Slow Momentum Lines:** Moving averages of the momentum to help identify crossovers.
* **Trend Crossovers:** Triangle markers indicate when fast momentum crosses slow momentum.

## Ideal Scenario
As the ticker enters the squeeze, **Gray dots** would warn of the beginning of a low compression squeeze. As the Bollinger bands continue to constrict, **Orange dots** would highlight a medium compression. As the price action and momentum continues to compress, a **Red dot** shows warning of high compression.

As price action leaves the squeeze, the coloring would reverse (Red → Orange → Gray → Light Gray). Any compression squeeze is considered "fired" at the first Light Gray dot that appears.

*Note: This is an ideal progression, however any type of squeeze sequence may appear at anytime.*

## Entry and Exit Guide
* **Entry:** John Carter recommends entering a position after at least 5 dots of compression (Gray/Orange/Red) or waiting for the first "No Squeeze" dot (Light Gray) to appear with confirming momentum.
* **Exit:** Exit on the second bar of decreasing momentum (Dark Green or Dark Red), or remain in the position after confirming a continuing trend through a separate indicator.

## Settings & Customization
* **Timeframe:** Built-in Multi-Timeframe (MTF) support allowing you to view higher-timeframe squeeze signals on lower-timeframe charts.
* **Appearance Modes:**
* **Default:** Standard enhanced palette.
* **Modern:** High-contrast palette (Teal/Red/Gold).
* **Classic MACD:** Traditional Blue/Orange line configuration.
* **Dashboard:** An on-chart table providing real-time data on squeeze status, momentum value, and trend strength.