Momentum Cascade

// This Pine Script® code is subject to the terms of the Mozilla Public License 2.0 at https://mozilla.org/MPL/2.0/
// © LyroRS

//@version=6
indicator("Momentum Cascade | Lyro RS", overlay=false)

import LyroRS/LMAs/1 as DynamicMAs

// ╔══════════════════════════════════════════════════╗
// ║                INPUT GROUPS                      ║
// ╚══════════════════════════════════════════════════╝
settings_g = '𝗦𝗘𝗧𝗧𝗜𝗡𝗚𝗦'
features_g = '𝗙𝗘𝗔𝗧𝗨𝗥𝗘𝗦'
color_g    = '𝗖𝗢𝗟𝗢𝗥'

// ╔══════════════════════════════════════════════════╗
// ║               CORE SETTINGS                      ║
// ╚══════════════════════════════════════════════════╝
length = input.int(14, "𝗠𝗼𝗺𝗲𝗻𝘁𝘂𝗺 𝗟𝗲𝗻𝗴𝘁𝗵", minval=2, group=settings_g, tooltip="Rate-of-change length feeding the cascade.")
stage  = input.int(14, "𝗦𝘁𝗮𝗴𝗲 𝗦𝗺𝗼𝗼𝘁𝗵𝗶𝗻𝗴", minval=2, group=settings_g, tooltip="EMA length of each cascade stage. The same momentum is passed through three stages — instant, reactive, and committed. A trend requires all three to agree.")

// ╔══════════════════════════════════════════════════╗
// ║                 FEATURES                         ║
// ╚══════════════════════════════════════════════════╝
showSignals = input.bool(true, "𝗦𝗵𝗼𝘄 𝗦𝗶𝗴𝗻𝗮𝗹𝘀", group=features_g)
candleColor = input.bool(true, "𝗖𝗮𝗻𝗱𝗹𝗲 𝗖𝗼𝗹𝗼𝗿𝗶𝗻𝗴", group=features_g)

// ╔══════════════════════════════════════════════════╗
// ║                   COLOR                          ║
// ╚══════════════════════════════════════════════════╝
ColMode = input.string("Mystic", "Custom Color Palette", inline="drop", options=["Classic", "Mystic", "Accented", "Royal"], display=display.none, group=color_g)
cpyn   = input.bool(true, "Use Custom Palette", group=color_g, display=display.none)
cp_UpC = input.color(#00ff00, "Custom Up", inline="Custom Palette", group=color_g, display=display.none)
cp_DnC = input.color(#ff0000, "Custom Down", inline="Custom Palette", group=color_g, display=display.none)

color UpC = na
color DnC = na

switch ColMode
    "Classic" =>
        UpC := #00E676
        DnC := #880E4F
    "Mystic" =>
        UpC := #30FDCF
        DnC := #E117B7
    "Accented" =>
        UpC := #9618F7
        DnC := #FF0078
    "Royal" =>
        UpC := #FFC107
        DnC := #673AB7

if cpyn
    UpC := cp_UpC
    DnC := cp_DnC

// ╔══════════════════════════════════════════════════╗
// ║               CASCADE ENGINE                     ║
// ╚══════════════════════════════════════════════════╝
// One momentum, three reaction speeds. Stage 1 is the raw impulse,
// stage 2 is its first smoothing, stage 3 the second. Early in a
// move only stage 1 has turned; a real trend is when the turn has
// cascaded all the way down to stage 3.
m1 = ta.roc(close, length)
m2 = DynamicMAs.EMA(m1, stage)
m3 = DynamicMAs.EMA(m2, stage)

score = (m1 > 0 ? 1 : -1) + (m2 > 0 ? 1 : -1) + (m3 > 0 ? 1 : -1)

// ╔══════════════════════════════════════════════════╗
// ║                 TREND ENGINE                     ║
// ╚══════════════════════════════════════════════════╝
var int trend = 0
if score == 3
    trend := 1
else if score == -3
    trend := -1

flipUp   = trend == 1  and trend[1] != 1
flipDown = trend == -1 and trend[1] != -1

// ╔══════════════════════════════════════════════════╗
// ║                   VISUALS                        ║
// ╚══════════════════════════════════════════════════╝
trendCol = trend == 1 ? UpC : trend == -1 ? DnC : color.gray

strength = math.abs(score) / 3.0
gradCol  = color.from_gradient(strength, 0, 1, color.new(trendCol, 65), trendCol)

// Cascade stages — thin instant, mid reactive, committed with glow
plot(m1, "Stage 1 [Instant]", color=color.new(trendCol, 70), linewidth=1)
plot(m2, "Stage 2 [Reactive]", color=color.new(trendCol, 45), linewidth=1)
plot(m3, "Stage 3 [Glow]", color=color.new(trendCol, 78), linewidth=8, editable=false)
pMain = plot(m3, "Stage 3 [Committed]", color=gradCol, linewidth=2)
pZero = plot(0, "Zero Anchor", color=na, editable=false)
// fill(pMain, pZero, color=color.new(trendCol, 88 - math.round(15 * strength)), title="Cascade Fill")
fill(pMain, pZero, 0, m3, color.new(chart.bg_color, 45), color.new(trendCol, 35), editable=false)

hline(0, "Zero Line", color=color.gray, linestyle=hline.style_dotted)

plotshape(showSignals and flipUp, "Buy Signal", style=shape.labelup, location=location.belowbar, color=UpC, text="𝓛𝓸𝓷𝓰", textcolor=#000000, size=size.small, force_overlay=true, display=display.pane)
plotshape(showSignals and flipDown, "Sell Signal", style=shape.labeldown, location=location.abovebar, color=DnC, text="𝓢𝓱𝓸𝓻𝓽", textcolor=#000000, size=size.small, force_overlay=true, display=display.pane)

plotcandle(open, high, low, close, "Candle Plot", candleColor ? gradCol : na, candleColor ? gradCol : na, true, bordercolor=candleColor ? gradCol : na, display=display.pane, force_overlay=true)

// ╔══════════════════════════════════════════════════╗
// ║                    ALERTS                        ║
// ╚══════════════════════════════════════════════════╝
alertcondition(flipUp, "Bullish Trend Flip", "Cascade | Lyro RS: Bullish cascade complete on {{ticker}} ({{interval}})")
alertcondition(flipDown, "Bearish Trend Flip", "Cascade | Lyro RS: Bearish cascade complete on {{ticker}} ({{interval}})")
alertcondition(flipUp or flipDown, "Any Trend Flip", "Cascade | Lyro RS: Trend flip on {{ticker}} ({{interval}})")