SNIFOFF_51_Lang

Library "SNIFOFF_51_Lang"
Multilingual translation layer for Smart Trader, SNIF-OFF 5.1, Trade Finder.
Provides 13 exported functions covering all dashboard labels, status badges,
and 3 narrative engines (trend, efficiency, volume) in 4 languages.
Consumed by the main indicator via import and i18n.f_*() calls.

f_trSig(en, lang)
Translates trend engine signal labels from English to the selected language.
Parameters:
en (string): The English signal label from the _sigTxt priority chain.
lang (string): The dashboard language selected by the user.
Returns: The translated signal label string.

f_trConv(en, lang)
Translates conviction level labels.
Parameters:
en (string): The English conviction label (HIGH, MODERATE, LOW).
lang (string): The dashboard language.
Returns: The translated conviction label.

f_trCoup(en, lang)
Translates efficiency coupling labels.
Parameters:
en (string): The English coupling label from the _effCoupledMsg matrix.
lang (string): The dashboard language.
Returns: The translated coupling label.

f_trMom(en, lang)
Translates efficiency momentum labels.
Parameters:
en (string): The English momentum label (Accelerating, Sharpening, Steady, Fading).
lang (string): The dashboard language.
Returns: The translated momentum label.

f_trVol(en, lang)
Translates volume scenario display labels.
Parameters:
en (string): The English scenario label from f_volScenarioMsg output.
lang (string): The dashboard language.
Returns: The translated scenario label.

f_trVolZone(zone, delta, lang)
Builds the directional arrow + intensity label for the volume zone cell.
Parameters:
zone (string): The volume zone classification (extreme/strong/normal/weak).
delta (int): The delta direction integer (+1 buyers, -1 sellers, 0 balanced).
lang (string): The dashboard language.
Returns: The composed volume zone display string.

f_trPocCons(count, lang)
Builds the volume center agreement label.
Parameters:
count (int): The number of agreeing scales (1-6).
lang (string): The dashboard language.
Returns: The composed POC consensus display string.

f_trTitle(en, lang)
Translates dashboard module header titles.
Parameters:
en (string): The English section title.
lang (string): The dashboard language.
Returns: The translated section title.

f_trBadge(en, lang)
Translates status badge labels (ACTIVE, LOCKED, LIVE, HIST).
Parameters:
en (string): The English badge label.
lang (string): The dashboard language.
Returns: The translated badge label.

f_trVolLabel(en, lang)
Translates volume data row cell labels.
Parameters:
en (string): The English label (Total, Buy, Sell, Group, Maximum, Minimum, Control).
lang (string): The dashboard language.
Returns: The translated data row label.

f_trendNarrative(cas, casDir, div, smD, algn, mBias, mBiasDir, conv, lang)
Builds a human-readable trend situation summary for the dashboard narrative row.
Parameters:
cas (bool): Cascade active flag.
casDir (int): Cascade direction (+1 bullish, -1 bearish).
div (bool): Divergence active flag.
smD (int): Micro direction from slope engine.
algn (int): Alignment score (-6 to +6).
mBias (bool): Macro bias active flag.
mBiasDir (int): Macro bias direction.
conv (string): Conviction label string (HIGH, MODERATE, LOW).
lang (string): The dashboard language.
Returns: A 3-line narrative string (state + structure + conviction).

f_effNarrative(rz, al, op, td, mom, lang)
Builds a human-readable efficiency situation summary.
Parameters:
rz (string): Rank zone string (extreme/strong/normal/weak).
al (bool): Aligned flag (bar direction matches trend).
op (bool): Opposed flag (bar direction opposes trend).
td (int): Trend direction (+1, -1, 0).
mom (string): Momentum label string (Accelerating, Sharpening, Steady, Fading).
lang (string): The dashboard language.
Returns: A 2-line narrative string (situation + trajectory).

f_volNarrative(sid, td, pocCon, pocMidPrice, conv, mom, liveAlert, lang)
Builds a human-readable 3-line volume situation summary.
Parameters:
sid (string): Scenario ID (S1–S16).
td (int): Trend direction (+1, -1, 0).
pocCon (int): Volume center consensus count (0-6).
pocMidPrice (float): Consensus center price (weighted average of cluster).
conv (string): Conviction label (HIGH, MODERATE, LOW).
mom (string): Efficiency momentum label.
liveAlert (bool): Explosive bar [0] volume spike flag.
lang (string): The dashboard language.
Returns: A multi-line narrative string (live alert prefix + what + why + outlook).

Release Notes

v2

Added:
f_trTipDash(key, lang)
Returns translated tooltip text for dashboard-level cells.
Parameters:
key (string): Tooltip key identifier (see header for valid keys).
lang (string): The dashboard language selected by the user.
Returns: The translated tooltip string. Empty string for unknown keys.

f_trTipTrend(key, lang)
Returns translated tooltip text for Trend Engine cells.
Parameters:
key (string): Tooltip key identifier.
lang (string): The dashboard language selected by the user.
Returns: The translated tooltip string. Empty string for unknown keys.

f_trTipEff(key, lang)
Returns translated tooltip text for Efficiency module cells.
Parameters:
key (string): Tooltip key identifier.
lang (string): The dashboard language selected by the user.
Returns: The translated tooltip string. Empty string for unknown keys.

f_trTipVol(key, lang)
Returns translated tooltip text for Volume decomposition cells.
Parameters:
key (string): Tooltip key identifier.
lang (string): The dashboard language selected by the user.
Returns: The translated tooltip string. Empty string for unknown keys.

f_trTipFp(key, gs, lang)
Returns translated tooltip text for Volume Footprint cells.
Parameters:
key (string): Tooltip key identifier.
gs (string): Group size string (e.g. "3", "47"). Pass "" for static keys.
lang (string): The dashboard language selected by the user.
Returns: The translated tooltip string. Empty string for unknown keys.

f_trTipVi(key, lang)
Returns translated tooltip text for Volume Insight cells.
Parameters:
key (string): Tooltip key identifier.
lang (string): The dashboard language selected by the user.
Returns: The translated tooltip string. Empty string for unknown keys.

f_trTrendDesc(cas, casDir, div, smD, algn, mBias, mBiasDir, lang)
Builds the trend state description with conviction suffix for the tooltip.
Parameters:
cas (bool): Cascade active flag.
casDir (int): Cascade direction (+1 bullish, -1 bearish).
div (bool): Divergence active flag.
smD (int): Micro direction from slope engine.
algn (int): Alignment score (-6 to +6).
mBias (bool): Macro bias active flag.
mBiasDir (int): Macro bias direction.
lang (string): The dashboard language.
Returns: Complete tooltip string (description + conviction explanation).

f_trInlineLabel(key, lang)
Returns translated inline labels used in dashboard cell content and display messages.
Parameters:
key (string): Label key identifier.
lang (string): The dashboard language selected by the user.
Returns: The translated label string. Empty string for unknown keys.

Release Notes

v3

Updated:
f_trPocCons(count, scN, lang)
Builds the volume center agreement label.
Parameters:
count (int): The number of agreeing scales, range 1 to scN.
scN (int): Active scale count: 6 in classic mode, 19 in Microscope mode.
lang (string): The dashboard language.
Returns: The composed POC consensus display string.

f_trendNarrative(cas, casDir, div, smD, algn, mBias, mBiasDir, conv, scN, lang)
Builds a human-readable trend situation summary for the dashboard narrative row.
Parameters:
cas (bool): Cascade active flag.
casDir (int): Cascade direction (+1 bullish, -1 bearish).
div (bool): Divergence active flag.
smD (int): Micro direction from slope engine.
algn (int): Alignment score, range -scN to +scN.
mBias (bool): Macro bias active flag.
mBiasDir (int): Macro bias direction.
conv (string): Conviction label string (HIGH, MODERATE, LOW).
scN (int): Active scale count: 6 in classic mode, 19 in Microscope mode.
lang (string): The dashboard language.
Returns: A 3-line narrative string (state + structure + conviction).

f_volNarrative(sid, td, pocCon, pocMidPrice, conv, mom, liveAlert, scN, lang)
Builds a human-readable 3-line volume situation summary.
Parameters:
sid (string): Scenario ID (S1–S16).
td (int): Trend direction (+1, -1, 0).
pocCon (int): Volume center consensus count, range 0 to scN.
pocMidPrice (float): Consensus center price (weighted average of cluster).
conv (string): Conviction label (HIGH, MODERATE, LOW).
mom (string): Efficiency momentum label.
liveAlert (bool): Explosive bar [0] volume spike flag.
scN (int): Active scale count: 6 in classic mode, 19 in Microscope mode.
lang (string): The dashboard language.
Returns: A multi-line narrative string (live alert prefix + what + why + outlook).

f_trTipDash(key, scN, lang)
Returns translated tooltip text for dashboard-level cells.
Parameters:
key (string): Tooltip key identifier (see header for valid keys).
scN (int): Active scale count: 6 in classic mode, 19 in Microscope mode.
lang (string): The dashboard language selected by the user.
Returns: The translated tooltip string. Empty string for unknown keys.

f_trTipTrend(key, scN, lang)
Returns translated tooltip text for Trend Engine cells.
Parameters:
key (string): Tooltip key identifier.
scN (int): Active scale count: 6 in classic mode, 19 in Microscope mode.
lang (string): The dashboard language selected by the user.
Returns: The translated tooltip string. Empty string for unknown keys.

f_trTipVi(key, scN, lang)
Returns translated tooltip text for Volume Insight cells.
Parameters:
key (string): Tooltip key identifier.
scN (int): Active scale count: 6 in classic mode, 19 in Microscope mode.
lang (string): The dashboard language selected by the user.
Returns: The translated tooltip string. Empty string for unknown keys.

f_trTrendDesc(cas, casDir, div, smD, algn, mBias, mBiasDir, scN, lang)
Builds the trend state description with conviction suffix for the tooltip.
Parameters:
cas (bool): Cascade active flag.
casDir (int): Cascade direction (+1 bullish, -1 bearish).
div (bool): Divergence active flag.
smD (int): Micro direction from slope engine.
algn (int): Alignment score, range -scN to +scN.
mBias (bool): Macro bias active flag.
mBiasDir (int): Macro bias direction.
scN (int): Active scale count: 6 in classic mode, 19 in Microscope mode.
lang (string): The dashboard language.
Returns: Complete tooltip string (description + conviction explanation).

Pine library

In true TradingView spirit, the author has published this Pine code as an open-source library so that other Pine programmers from our community can reuse it. Cheers to the author! You may use this library privately or in other open-source publications, but reuse of this code in publications is governed by House Rules.

ata_sabanci

Measuring markets through Volume Dynamics & Geometric Frameworks.
For invite-only script access, DM on TradingView or via x.com/sabanci_ata

Also on:

Disclaimer

The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.

Pine library

ata_sabanci

Measuring markets through Volume Dynamics & Geometric Frameworks.
For invite-only script access, DM on TradingView or via x.com/sabanci_ata

Also on: