@continuumdao/continuum-node-sdk 1.3.28 → 1.3.30

package/dist/core/chart/analysis/trade-setups/moving-averages-trade-setup.js

@@ -0,0 +1,330 @@
+import { isFiniteTradePrice } from './shared.js';
+import { entryProximityAtrFromOhlcvRows } from './entry-proximity-atr.js';
+import { assessTradeSetupEntryActionability } from './trade-entry-gates.js';
+import { tradeDeskConfig } from './trade-desk-defaults.js';
+export const DEFAULT_MA_FAST_PERIOD = 50;
+export const DEFAULT_MA_SLOW_PERIOD = 200;
+export const DEFAULT_MA_TYPE = 'sma';
+export const DEFAULT_FRESH_CROSSOVER_MAX_BARS = 5;
+const MIN_CLEAR_CONFIDENCE = 0.45;
+export function maPairLabel(maType, fastPeriod, slowPeriod) {
+    const prefix = maType === 'ema' ? 'EMA' : 'SMA';
+    return `${prefix}(${fastPeriod})/${prefix}(${slowPeriod})`;
+}
+function sideFromRegime(fastMa, slowMa) {
+    if (fastMa > slowMa) {
+        return 'long';
+    }
+    if (fastMa < slowMa) {
+        return 'short';
+    }
+    return 'neutral';
+}
+function crossoverLabelFromState(state) {
+    if (state === 'bullish') {
+        return 'golden_cross';
+    }
+    if (state === 'bearish') {
+        return 'death_cross';
+    }
+    return 'none';
+}
+function proximityTypeFromSide(side) {
+    if (side === 'long') {
+        return 'slow_ma_retest_bullish';
+    }
+    if (side === 'short') {
+        return 'slow_ma_retest_bearish';
+    }
+    return 'none';
+}
+function crossoverConfidence(barsSinceCrossover, fastMa, slowMa) {
+    let confidence = 0.45;
+    if (barsSinceCrossover != null && barsSinceCrossover <= 2) {
+        confidence += 0.1;
+    }
+    else if (barsSinceCrossover != null && barsSinceCrossover <= 5) {
+        confidence += 0.05;
+    }
+    const spread = Math.abs(fastMa - slowMa);
+    const mid = (fastMa + slowMa) / 2;
+    if (mid > 0 && spread / mid > 0.002) {
+        confidence = Math.min(0.75, confidence + 0.05);
+    }
+    return confidence;
+}
+function retestConfidence(fastMa, slowMa) {
+    const spread = Math.abs(fastMa - slowMa);
+    const mid = (fastMa + slowMa) / 2;
+    let confidence = 0.45;
+    if (mid > 0 && spread / mid > 0.003) {
+        confidence = Math.min(0.65, confidence + 0.07);
+    }
+    return confidence;
+}
+function formatCrossoverAge(barsSinceCrossover) {
+    if (barsSinceCrossover == null) {
+        return '';
+    }
+    if (barsSinceCrossover === 0) {
+        return '';
+    }
+    return ` ${barsSinceCrossover} bar${barsSinceCrossover === 1 ? '' : 's'} ago`;
+}
+export function buildMovingAveragesTradeSummary(input) {
+    const pair = maPairLabel(input.maType, input.fastPeriod, input.slowPeriod);
+    if (input.strategy === 'crossover') {
+        const crossName = input.crossoverLabel === 'golden_cross' ? 'Golden cross' : 'Death cross';
+        const age = formatCrossoverAge(input.barsSinceCrossover);
+        if (input.status === 'clear' && input.side !== 'neutral') {
+            const sideWord = input.side === 'long' ? 'long' : 'short';
+            return `${crossName}${age} · ${pair} · ${sideWord} entry at last close`;
+        }
+        return `${crossName}${age} · ${pair} · no actionable entry`;
+    }
+    const regime = input.proximityType === 'slow_ma_retest_bullish'
+        ? 'bullish regime'
+        : input.proximityType === 'slow_ma_retest_bearish'
+            ? 'bearish regime'
+            : 'neutral regime';
+    const slowLabel = `${input.maType === 'ema' ? 'EMA' : 'SMA'}(${input.slowPeriod})`;
+    if (input.status === 'clear' && input.side !== 'neutral') {
+        const sideWord = input.side === 'long' ? 'long' : 'short';
+        return `Proximity + retest · ${regime} · ${sideWord} limit at ${slowLabel}`;
+    }
+    if (input.unclearReason?.includes('proximity')) {
+        return `Proximity + retest · ${regime} · price not within proximity of ${slowLabel}`;
+    }
+    return `Proximity + retest · ${regime} · no actionable entry`;
+}
+export function detectMaCrossover(fastSeries, slowSeries) {
+    const len = Math.min(fastSeries.length, slowSeries.length);
+    if (len < 2) {
+        return { crossoverState: 'none', barsSinceCrossover: null };
+    }
+    for (let offset = 0; offset < len - 1; offset++) {
+        const i = len - 1 - offset;
+        const prev = i - 1;
+        const fast = fastSeries[i];
+        const slow = slowSeries[i];
+        const fastPrev = fastSeries[prev];
+        const slowPrev = slowSeries[prev];
+        if (!isFiniteTradePrice(fast) ||
+            !isFiniteTradePrice(slow) ||
+            !isFiniteTradePrice(fastPrev) ||
+            !isFiniteTradePrice(slowPrev)) {
+            continue;
+        }
+        if (fast > slow && fastPrev <= slowPrev) {
+            return { crossoverState: 'bullish', barsSinceCrossover: offset };
+        }
+        if (fast < slow && fastPrev >= slowPrev) {
+            return { crossoverState: 'bearish', barsSinceCrossover: offset };
+        }
+    }
+    return { crossoverState: 'none', barsSinceCrossover: null };
+}
+export function buildMovingAveragesTradeSetup(input) {
+    const close = input.lastClose;
+    const fastMa = input.fastMa;
+    const slowMa = input.slowMa;
+    if (!isFiniteTradePrice(close) || !isFiniteTradePrice(fastMa) || !isFiniteTradePrice(slowMa)) {
+        return null;
+    }
+    const desk = tradeDeskConfig({
+        entryProximityPct: input.entryProximityPct,
+        entryProximityMode: input.entryProximityMode,
+        entryProximityAtrPeriod: input.entryProximityAtrPeriod,
+        entryOffsetPct: input.entryOffsetPct,
+    });
+    const freshMax = input.freshCrossoverMaxBars ?? DEFAULT_FRESH_CROSSOVER_MAX_BARS;
+    const regimeSide = sideFromRegime(fastMa, slowMa);
+    const crossoverLabel = crossoverLabelFromState(input.crossoverState);
+    const proximityType = proximityTypeFromSide(regimeSide);
+    const atrAtLastBar = desk.entryProximityMode === 'atr' && input.bars?.length
+        ? entryProximityAtrFromOhlcvRows(input.bars, desk.entryProximityAtrPeriod)
+        : null;
+    const freshCrossover = input.crossoverState !== 'none' &&
+        input.barsSinceCrossover != null &&
+        input.barsSinceCrossover <= freshMax;
+    let strategy = 'proximity_retest';
+    let side = regimeSide;
+    let status = 'unclear';
+    let confidence = 0.35;
+    let entryPrice;
+    let entryLabel;
+    let entryOffsetMode = 'retest';
+    let setupPurposeCode = 'ma-ret';
+    let unclearReason = regimeSide === 'neutral'
+        ? 'Fast and slow moving averages are aligned — no directional regime.'
+        : 'No actionable moving-average setup on the current bar.';
+    if (freshCrossover && input.crossoverState === 'bullish') {
+        strategy = 'crossover';
+        side = 'long';
+        confidence = crossoverConfidence(input.barsSinceCrossover, fastMa, slowMa);
+        entryOffsetMode = 'bounce';
+        setupPurposeCode = 'ma-cross';
+        if (confidence >= MIN_CLEAR_CONFIDENCE) {
+            status = 'clear';
+            entryPrice = close;
+            entryLabel = 'last close (crossover)';
+            unclearReason = '';
+        }
+    }
+    else if (freshCrossover && input.crossoverState === 'bearish') {
+        strategy = 'crossover';
+        side = 'short';
+        confidence = crossoverConfidence(input.barsSinceCrossover, fastMa, slowMa);
+        entryOffsetMode = 'bounce';
+        setupPurposeCode = 'ma-cross';
+        if (confidence >= MIN_CLEAR_CONFIDENCE) {
+            status = 'clear';
+            entryPrice = close;
+            entryLabel = 'last close (crossover)';
+            unclearReason = '';
+        }
+    }
+    else if (input.crossoverState !== 'none' &&
+        input.barsSinceCrossover != null &&
+        input.barsSinceCrossover > freshMax) {
+        strategy = 'crossover';
+        side = input.crossoverState === 'bullish' ? 'long' : 'short';
+        confidence = crossoverConfidence(input.barsSinceCrossover, fastMa, slowMa);
+        entryOffsetMode = 'bounce';
+        setupPurposeCode = 'ma-cross';
+        unclearReason = `Crossover occurred ${input.barsSinceCrossover} bars ago — outside fresh window (${freshMax} bars).`;
+    }
+    else if (regimeSide !== 'neutral') {
+        strategy = 'proximity_retest';
+        side = regimeSide;
+        confidence = retestConfidence(fastMa, slowMa);
+        entryOffsetMode = 'retest';
+        setupPurposeCode = 'ma-ret';
+        const entryCheck = assessTradeSetupEntryActionability({
+            lastClose: close,
+            entryPrice: slowMa,
+            side,
+            entryOffsetMode: 'retest',
+            entryProximityPct: desk.entryProximityPct,
+            entryProximityMode: desk.entryProximityMode,
+            entryProximityAtr: atrAtLastBar,
+            entryOffsetPct: desk.entryOffsetPct,
+        });
+        if (entryCheck.ok && confidence >= MIN_CLEAR_CONFIDENCE) {
+            status = 'clear';
+            entryPrice = slowMa;
+            entryLabel = `${input.maType === 'ema' ? 'EMA' : 'SMA'}(${input.slowPeriod}) retest`;
+            unclearReason = '';
+            confidence = Math.min(0.7, confidence + 0.05);
+        }
+        else if (!entryCheck.ok) {
+            unclearReason = entryCheck.unclearReason;
+        }
+    }
+    const targetPrice = status === 'clear' && side === 'long'
+        ? fastMa
+        : status === 'clear' && side === 'short'
+            ? fastMa
+            : undefined;
+    const targetLabel = status === 'clear' ? `${input.maType === 'ema' ? 'EMA' : 'SMA'}(${input.fastPeriod})` : undefined;
+    const invalidationPrice = status === 'clear' && side === 'long'
+        ? slowMa
+        : status === 'clear' && side === 'short'
+            ? slowMa
+            : undefined;
+    const invalidationLabel = status === 'clear'
+        ? `below ${input.maType === 'ema' ? 'EMA' : 'SMA'}(${input.slowPeriod})`
+        : undefined;
+    const tradeSummary = buildMovingAveragesTradeSummary({
+        maType: input.maType,
+        fastPeriod: input.fastPeriod,
+        slowPeriod: input.slowPeriod,
+        strategy,
+        crossoverLabel: strategy === 'crossover' ? crossoverLabel : 'none',
+        proximityType: strategy === 'proximity_retest' ? proximityType : 'none',
+        side,
+        status,
+        barsSinceCrossover: input.barsSinceCrossover,
+        unclearReason,
+    });
+    const conditionalNote = status === 'clear'
+        ? tradeSummary
+        : strategy === 'crossover' && crossoverLabel !== 'none'
+            ? `${crossoverLabel === 'golden_cross' ? 'Golden cross' : 'Death cross'} detected but not actionable — ${unclearReason || 'wait for a fresh crossover or proximity retest.'}`
+            : unclearReason ||
+                'Moving-average setup is unclear — wait for crossover or slow MA retest within proximity.';
+    return {
+        status,
+        source: 'moving_averages',
+        lastClose: close,
+        fastMa,
+        slowMa,
+        fastPeriod: input.fastPeriod,
+        slowPeriod: input.slowPeriod,
+        maType: input.maType,
+        crossoverState: input.crossoverState,
+        barsSinceCrossover: input.barsSinceCrossover,
+        strategy,
+        crossoverLabel: strategy === 'crossover' ? crossoverLabel : 'none',
+        proximityType: strategy === 'proximity_retest' ? proximityType : 'none',
+        setupPurposeCode,
+        entryOffsetMode,
+        entryProximityPct: desk.entryProximityPct,
+        entryProximityMode: desk.entryProximityMode,
+        entryOffsetPct: desk.entryOffsetPct,
+        invalidationOffsetPct: desk.invalidationOffsetPct,
+        ...(atrAtLastBar != null ? { atrAtLastBar } : {}),
+        side,
+        confidence,
+        tradeSummary,
+        conditionalNote,
+        ...(status === 'clear' && entryPrice != null && entryLabel
+            ? { entryPrice, entryLabel }
+            : {}),
+        ...(targetPrice != null && targetLabel ? { targetPrice, targetLabel } : {}),
+        ...(invalidationPrice != null && invalidationLabel
+            ? { invalidationPrice, invalidationLabel }
+            : {}),
+        ...(unclearReason && status === 'unclear' ? { unclearReason } : {}),
+    };
+}
+export function movingAveragesTradeIdeaContextFromSetup(setup) {
+    return {
+        tradeSummary: setup.tradeSummary,
+        strategy: setup.strategy,
+        crossoverLabel: setup.crossoverLabel,
+        proximityType: setup.proximityType,
+        fastPeriod: setup.fastPeriod,
+        slowPeriod: setup.slowPeriod,
+        maType: setup.maType,
+        barsSinceCrossover: setup.barsSinceCrossover,
+        setupPurposeCode: setup.setupPurposeCode,
+    };
+}
+export function normalizeMovingAveragesTradeSetup(setup) {
+    return {
+        status: setup.status,
+        side: setup.side,
+        confidence: setup.confidence,
+        lastClose: setup.lastClose,
+        entry: setup.status === 'clear' &&
+            setup.side !== 'neutral' &&
+            setup.entryPrice != null &&
+            isFiniteTradePrice(setup.entryPrice)
+            ? { price: setup.entryPrice, label: setup.entryLabel ?? 'MA entry' }
+            : undefined,
+        ...(setup.targetPrice != null && isFiniteTradePrice(setup.targetPrice)
+            ? { target: { price: setup.targetPrice, label: setup.targetLabel ?? 'fast MA' } }
+            : {}),
+        ...(setup.invalidationPrice != null && isFiniteTradePrice(setup.invalidationPrice)
+            ? {
+                invalidation: {
+                    price: setup.invalidationPrice,
+                    label: setup.invalidationLabel ?? 'slow MA breach',
+                },
+            }
+            : {}),
+        unclearReason: setup.unclearReason,
+    };
+}
+//# sourceMappingURL=moving-averages-trade-setup.js.map

package/dist/core/chart/analysis/trade-setups/moving-averages-trade-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moving-averages-trade-setup.js","sourceRoot":"","sources":["../../../../../src/core/chart/analysis/trade-setups/moving-averages-trade-setup.ts"],"names":[],"mappings":"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"}

package/dist/core/chart/analysis/trade-setups/pattern-limit-entry.d.ts

@@ -3,6 +3,13 @@ import type { PatternKeyLevelSummary } from '../../../chart-patterns/pattern-men
 import type { TradeSetupSide } from './shared.js';
 export declare const DEFAULT_BREAK_TOLERANCE_PCT = 0.1;
 export declare const DEFAULT_ENTRY_PROXIMITY_PCT = 1;
+export type EntryProximityMode = 'price' | 'atr';
+export declare const DEFAULT_ENTRY_PROXIMITY_MODE: EntryProximityMode;
+export type WithinEntryProximityOptions = {
+    mode?: EntryProximityMode;
+    atr?: number | null;
+};
+export declare function entryProximityGateLabel(pct: number, mode?: EntryProximityMode): string;
 export type PatternEntryPhase = 'inside_pattern' | 'post_breakout_retest';
 export type EntryOffsetMode = 'bounce' | 'retest';
 export type PatternPhase = 'inside' | 'broken_above' | 'broken_below';
@@ -22,6 +29,8 @@ export type ResolvePatternLimitInput = {
     classificationSide: TradeSetupSide;
     breakTolerancePct?: number;
     entryProximityPct?: number;
+    entryProximityMode?: EntryProximityMode;
+    entryProximityAtr?: number | null;
 };
 export type ResolvePatternLimitResult = {
     ok: true;
@@ -31,7 +40,7 @@ export type ResolvePatternLimitResult = {
     unclearReason: string;
 };
 export declare function patternPhase(lastClose: number, support: number, resistance: number, tolerancePct?: number): PatternPhase;
-export declare function withinEntryProximity(lastClose: number, entry: number, maxPct?: number): boolean;
+export declare function withinEntryProximity(lastClose: number, entry: number, maxPct?: number, options?: WithinEntryProximityOptions): boolean;
 export declare function boundaryAtRightEdge(levels: PatternKeyLevelSummary[]): {
     support: number;
     resistance: number;

package/dist/core/chart/analysis/trade-setups/pattern-limit-entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pattern-limit-entry.d.ts","sourceRoot":"","sources":["../../../../../src/core/chart/analysis/trade-setups/pattern-limit-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,iDAAiD,CAAC;AAC5F,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,sBAAsB,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,cAAc,GAAG,cAAc,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAAG;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,eAAe,EAAE,eAAe,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,sBAAsB,EAAE,CAAC;IACpC,kBAAkB,EAAE,cAAc,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAClC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAC,GACtC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAC,CAAC;AAMtC,wBAAgB,YAAY,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,SAA8B,GACxC,YAAY,CAYd;AAED,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,SAA8B,GAClC,OAAO,CAKT;AA4CD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACxB,GAAG,IAAI,CA+BP;AAqID,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,wBAAwB,GAAG,yBAAyB,CA0XpG"}
+{"version":3,"file":"pattern-limit-entry.d.ts","sourceRoot":"","sources":["../../../../../src/core/chart/analysis/trade-setups/pattern-limit-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,iDAAiD,CAAC;AAC5F,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,KAAK,CAAC;AACjD,eAAO,MAAM,4BAA4B,EAAE,kBAA4B,CAAC;AAExE,MAAM,MAAM,2BAA2B,GAAG;IACzC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB,CAAC;AAEF,wBAAgB,uBAAuB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,kBAAiD,GACrD,MAAM,CAER;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,sBAAsB,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,cAAc,GAAG,cAAc,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAAG;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,eAAe,EAAE,eAAe,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,sBAAsB,EAAE,CAAC;IACpC,kBAAkB,EAAE,cAAc,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAClC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAC,GACtC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAC,CAAC;AAMtC,wBAAgB,YAAY,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,SAA8B,GACxC,YAAY,CAYd;AAED,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,SAA8B,EACpC,OAAO,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAiBT;AA6DD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACxB,GAAG,IAAI,CA+BP;AAqJD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,wBAAwB,GAAG,yBAAyB,CAqcpG"}

package/dist/core/chart/analysis/trade-setups/pattern-limit-entry.js

@@ -1,5 +1,9 @@
 export const DEFAULT_BREAK_TOLERANCE_PCT = 0.1;
 export const DEFAULT_ENTRY_PROXIMITY_PCT = 1;
+export const DEFAULT_ENTRY_PROXIMITY_MODE = 'price';
+export function entryProximityGateLabel(pct, mode = DEFAULT_ENTRY_PROXIMITY_MODE) {
+    return mode === 'atr' ? `${pct}% of ATR` : `${pct}% of entry`;
+}
 function tolPrice(price, pct) {
     return Math.abs(price) * (pct / 100);
 }
@@ -16,11 +20,33 @@ export function patternPhase(lastClose, support, resistance, tolerancePct = DEFA
     }
     return 'inside';
 }
-export function withinEntryProximity(lastClose, entry, maxPct = DEFAULT_ENTRY_PROXIMITY_PCT) {
-    if (!Number.isFinite(lastClose) || !Number.isFinite(entry) || entry === 0) {
+export function withinEntryProximity(lastClose, entry, maxPct = DEFAULT_ENTRY_PROXIMITY_PCT, options) {
+    if (!Number.isFinite(lastClose) || !Number.isFinite(entry)) {
+        return false;
+    }
+    const distance = Math.abs(lastClose - entry);
+    const mode = options?.mode ?? DEFAULT_ENTRY_PROXIMITY_MODE;
+    if (mode === 'atr') {
+        const atr = options?.atr;
+        if (atr == null || !Number.isFinite(atr) || atr <= 0) {
+            return false;
+        }
+        return distance <= (atr * maxPct) / 100;
+    }
+    if (entry === 0) {
         return false;
     }
-    return (Math.abs(lastClose - entry) / Math.abs(entry)) * 100 <= maxPct;
+    return (distance / Math.abs(entry)) * 100 <= maxPct;
+}
+function failUnlessWithinEntryProximity(lastClose, entryPrice, pct, label, options) {
+    if (withinEntryProximity(lastClose, entryPrice, pct, options)) {
+        return null;
+    }
+    const mode = options?.mode ?? DEFAULT_ENTRY_PROXIMITY_MODE;
+    return {
+        ok: false,
+        unclearReason: `Price not within ${entryProximityGateLabel(pct, mode)} of ${label}.`,
+    };
 }
 function levelByLabels(levels, labels) {
     for (const want of labels) {
@@ -135,7 +161,7 @@ function okLevels(trigger, invalidation, entryPhase, entryOffsetMode, limitSide)
         },
     };
 }
-function boundaryLong(support, resistance, phase, proximityPct, lastClose, requireBreakoutOnly) {
+function boundaryLong(support, resistance, phase, proximityPct, proximityOptions, lastClose, requireBreakoutOnly) {
     if (requireBreakoutOnly) {
         if (phase === 'inside') {
             return { ok: false, unclearReason: 'Price still inside pattern — no trade until breakout.' };
@@ -154,12 +180,13 @@ function boundaryLong(support, resistance, phase, proximityPct, lastClose, requi
     }
     const entry = { price: support.price, label: `${support.label} bounce` };
     const inv = { price: support.price, label: `${support.label} pattern fail` };
-    if (!withinEntryProximity(lastClose, entry.price, proximityPct)) {
-        return { ok: false, unclearReason: `Price not within ${proximityPct}% of support entry.` };
+    const proximityFail = failUnlessWithinEntryProximity(lastClose, entry.price, proximityPct, 'support entry', proximityOptions);
+    if (proximityFail) {
+        return proximityFail;
     }
     return okLevels(entry, inv, 'inside_pattern', 'bounce', 'long');
 }
-function boundaryShort(support, resistance, phase, proximityPct, lastClose, requireBreakoutOnly) {
+function boundaryShort(support, resistance, phase, proximityPct, proximityOptions, lastClose, requireBreakoutOnly) {
     if (requireBreakoutOnly) {
         if (phase === 'inside') {
             return { ok: false, unclearReason: 'Price still inside pattern — no trade until breakout.' };
@@ -178,13 +205,18 @@ function boundaryShort(support, resistance, phase, proximityPct, lastClose, requ
     }
     const entry = { price: resistance.price, label: `${resistance.label} bounce` };
     const inv = { price: resistance.price, label: `${resistance.label} pattern fail` };
-    if (!withinEntryProximity(lastClose, entry.price, proximityPct)) {
-        return { ok: false, unclearReason: `Price not within ${proximityPct}% of resistance entry.` };
+    const proximityFail = failUnlessWithinEntryProximity(lastClose, entry.price, proximityPct, 'resistance entry', proximityOptions);
+    if (proximityFail) {
+        return proximityFail;
     }
     return okLevels(entry, inv, 'inside_pattern', 'bounce', 'short');
 }
 export function resolvePatternLimitLevels(input) {
-    const { patternId, lastClose, keyLevels, breakTolerancePct = DEFAULT_BREAK_TOLERANCE_PCT, entryProximityPct = DEFAULT_ENTRY_PROXIMITY_PCT, } = input;
+    const { patternId, lastClose, keyLevels, breakTolerancePct = DEFAULT_BREAK_TOLERANCE_PCT, entryProximityPct = DEFAULT_ENTRY_PROXIMITY_PCT, entryProximityMode, entryProximityAtr, } = input;
+    const proximityOptions = {
+        mode: entryProximityMode,
+        atr: entryProximityAtr,
+    };
     const bounds = boundaryAtRightEdge(keyLevels);
     const phase = bounds != null
         ? patternPhase(lastClose, bounds.support, bounds.resistance, breakTolerancePct)
@@ -194,23 +226,23 @@ export function resolvePatternLimitLevels(input) {
             if (!bounds) {
                 return { ok: false, unclearReason: 'Missing wedge boundary levels.' };
             }
-            return boundaryLong({ price: bounds.support, label: bounds.supportLabel }, { price: bounds.resistance, label: bounds.resistanceLabel }, phase, entryProximityPct, lastClose, false);
+            return boundaryLong({ price: bounds.support, label: bounds.supportLabel }, { price: bounds.resistance, label: bounds.resistanceLabel }, phase, entryProximityPct, proximityOptions, lastClose, false);
         }
         case 'rising_wedge': {
             if (!bounds) {
                 return { ok: false, unclearReason: 'Missing wedge boundary levels.' };
             }
-            return boundaryShort({ price: bounds.support, label: bounds.supportLabel }, { price: bounds.resistance, label: bounds.resistanceLabel }, phase, entryProximityPct, lastClose, false);
+            return boundaryShort({ price: bounds.support, label: bounds.supportLabel }, { price: bounds.resistance, label: bounds.resistanceLabel }, phase, entryProximityPct, proximityOptions, lastClose, false);
         }
         case 'symmetrical_triangle': {
             if (!bounds) {
                 return { ok: false, unclearReason: 'Missing triangle boundary levels.' };
             }
             if (phase === 'broken_above') {
-                return boundaryLong({ price: bounds.support, label: bounds.supportLabel }, { price: bounds.resistance, label: bounds.resistanceLabel }, phase, entryProximityPct, lastClose, true);
+                return boundaryLong({ price: bounds.support, label: bounds.supportLabel }, { price: bounds.resistance, label: bounds.resistanceLabel }, phase, entryProximityPct, proximityOptions, lastClose, true);
             }
             if (phase === 'broken_below') {
-                return boundaryShort({ price: bounds.support, label: bounds.supportLabel }, { price: bounds.resistance, label: bounds.resistanceLabel }, phase, entryProximityPct, lastClose, true);
+                return boundaryShort({ price: bounds.support, label: bounds.supportLabel }, { price: bounds.resistance, label: bounds.resistanceLabel }, phase, entryProximityPct, proximityOptions, lastClose, true);
             }
             return { ok: false, unclearReason: 'Symmetrical triangle — no trade until breakout.' };
         }
@@ -225,8 +257,9 @@ export function resolvePatternLimitLevels(input) {
                 return okLevels({ price: res.price, label: `${res.label} retest` }, { price: sup.price, label: `${sup.label} pattern fail` }, 'post_breakout_retest', 'retest', 'long');
             }
             const entry = { price: sup.price, label: `${sup.label} bounce` };
-            if (!withinEntryProximity(lastClose, entry.price, entryProximityPct)) {
-                return { ok: false, unclearReason: `Price not within ${entryProximityPct}% of support entry.` };
+            const proximityFail = failUnlessWithinEntryProximity(lastClose, entry.price, entryProximityPct, 'support entry', proximityOptions);
+            if (proximityFail) {
+                return proximityFail;
             }
             return okLevels(entry, { price: sup.price, label: `${sup.label} pattern fail` }, 'inside_pattern', 'bounce', 'long');
         }
@@ -241,8 +274,9 @@ export function resolvePatternLimitLevels(input) {
                 return okLevels({ price: sup.price, label: `${sup.label} retest` }, { price: res.price, label: `${res.label} pattern fail` }, 'post_breakout_retest', 'retest', 'short');
             }
             const entry = { price: res.price, label: `${res.label} bounce` };
-            if (!withinEntryProximity(lastClose, entry.price, entryProximityPct)) {
-                return { ok: false, unclearReason: `Price not within ${entryProximityPct}% of resistance entry.` };
+            const proximityFail = failUnlessWithinEntryProximity(lastClose, entry.price, entryProximityPct, 'resistance entry', proximityOptions);
+            if (proximityFail) {
+                return proximityFail;
             }
             return okLevels(entry, { price: res.price, label: `${res.label} pattern fail` }, 'inside_pattern', 'bounce', 'short');
         }
@@ -250,13 +284,13 @@ export function resolvePatternLimitLevels(input) {
             if (!bounds) {
                 return { ok: false, unclearReason: 'Missing channel boundary levels.' };
             }
-            return boundaryLong({ price: bounds.support, label: bounds.supportLabel }, { price: bounds.resistance, label: bounds.resistanceLabel }, phase, entryProximityPct, lastClose, false);
+            return boundaryLong({ price: bounds.support, label: bounds.supportLabel }, { price: bounds.resistance, label: bounds.resistanceLabel }, phase, entryProximityPct, proximityOptions, lastClose, false);
         }
         case 'channel_down': {
             if (!bounds) {
                 return { ok: false, unclearReason: 'Missing channel boundary levels.' };
             }
-            return boundaryShort({ price: bounds.support, label: bounds.supportLabel }, { price: bounds.resistance, label: bounds.resistanceLabel }, phase, entryProximityPct, lastClose, false);
+            return boundaryShort({ price: bounds.support, label: bounds.supportLabel }, { price: bounds.resistance, label: bounds.resistanceLabel }, phase, entryProximityPct, proximityOptions, lastClose, false);
         }
         case 'double_bottom':
         case 'double_bottom_adam_eve': {
@@ -269,8 +303,9 @@ export function resolvePatternLimitLevels(input) {
                 return okLevels({ price: neck.price, label: 'neckline retest' }, { price: trough.price, label: 'trough pattern fail' }, 'post_breakout_retest', 'retest', 'long');
             }
             const entry = { price: trough.price, label: 'trough bounce' };
-            if (!withinEntryProximity(lastClose, entry.price, entryProximityPct)) {
-                return { ok: false, unclearReason: `Price not within ${entryProximityPct}% of trough entry.` };
+            const proximityFail = failUnlessWithinEntryProximity(lastClose, entry.price, entryProximityPct, 'trough entry', proximityOptions);
+            if (proximityFail) {
+                return proximityFail;
             }
             return okLevels(entry, { price: trough.price, label: 'trough pattern fail' }, 'inside_pattern', 'bounce', 'long');
         }
@@ -284,8 +319,9 @@ export function resolvePatternLimitLevels(input) {
                 return okLevels({ price: neck.price, label: 'neckline retest' }, { price: peak.price, label: 'peak pattern fail' }, 'post_breakout_retest', 'retest', 'short');
             }
             const entry = { price: peak.price, label: 'peak bounce' };
-            if (!withinEntryProximity(lastClose, entry.price, entryProximityPct)) {
-                return { ok: false, unclearReason: `Price not within ${entryProximityPct}% of peak entry.` };
+            const proximityFail = failUnlessWithinEntryProximity(lastClose, entry.price, entryProximityPct, 'peak entry', proximityOptions);
+            if (proximityFail) {
+                return proximityFail;
             }
             return okLevels(entry, { price: peak.price, label: 'peak pattern fail' }, 'inside_pattern', 'bounce', 'short');
         }
@@ -299,8 +335,9 @@ export function resolvePatternLimitLevels(input) {
                 return okLevels({ price: neck.price, label: 'neckline retest' }, { price: head.price, label: 'head pattern fail' }, 'post_breakout_retest', 'retest', 'long');
             }
             const entry = { price: head.price, label: 'head bounce' };
-            if (!withinEntryProximity(lastClose, entry.price, entryProximityPct)) {
-                return { ok: false, unclearReason: `Price not within ${entryProximityPct}% of head entry.` };
+            const proximityFail = failUnlessWithinEntryProximity(lastClose, entry.price, entryProximityPct, 'head entry', proximityOptions);
+            if (proximityFail) {
+                return proximityFail;
             }
             return okLevels(entry, { price: head.price, label: 'head pattern fail' }, 'inside_pattern', 'bounce', 'long');
         }
@@ -314,8 +351,9 @@ export function resolvePatternLimitLevels(input) {
                 return okLevels({ price: neck.price, label: 'neckline retest' }, { price: head.price, label: 'head pattern fail' }, 'post_breakout_retest', 'retest', 'short');
             }
             const entry = { price: head.price, label: 'head bounce' };
-            if (!withinEntryProximity(lastClose, entry.price, entryProximityPct)) {
-                return { ok: false, unclearReason: `Price not within ${entryProximityPct}% of head entry.` };
+            const proximityFail = failUnlessWithinEntryProximity(lastClose, entry.price, entryProximityPct, 'head entry', proximityOptions);
+            if (proximityFail) {
+                return proximityFail;
             }
             return okLevels(entry, { price: head.price, label: 'head pattern fail' }, 'inside_pattern', 'bounce', 'short');
         }
@@ -331,8 +369,9 @@ export function resolvePatternLimitLevels(input) {
                 return okLevels({ price: rim.price, label: 'rim retest' }, { price: invPrice, label: 'cup/handle pattern fail' }, 'post_breakout_retest', 'retest', 'long');
             }
             const entry = { price: (handle ?? cupLow).price, label: 'handle bounce' };
-            if (!withinEntryProximity(lastClose, entry.price, entryProximityPct)) {
-                return { ok: false, unclearReason: `Price not within ${entryProximityPct}% of handle entry.` };
+            const proximityFail = failUnlessWithinEntryProximity(lastClose, entry.price, entryProximityPct, 'handle entry', proximityOptions);
+            if (proximityFail) {
+                return proximityFail;
             }
             return okLevels(entry, { price: invPrice, label: 'cup/handle pattern fail' }, 'inside_pattern', 'bounce', 'long');
         }
@@ -347,8 +386,9 @@ export function resolvePatternLimitLevels(input) {
                 return okLevels({ price: high.price, label: 'flag upper retest' }, { price: low.price, label: 'flag low pattern fail' }, 'post_breakout_retest', 'retest', 'long');
             }
             const entry = { price: low.price, label: 'flag low bounce' };
-            if (!withinEntryProximity(lastClose, entry.price, entryProximityPct)) {
-                return { ok: false, unclearReason: `Price not within ${entryProximityPct}% of flag support entry.` };
+            const proximityFail = failUnlessWithinEntryProximity(lastClose, entry.price, entryProximityPct, 'flag support entry', proximityOptions);
+            if (proximityFail) {
+                return proximityFail;
             }
             return okLevels(entry, { price: low.price, label: 'flag low pattern fail' }, 'inside_pattern', 'bounce', 'long');
         }
@@ -363,8 +403,9 @@ export function resolvePatternLimitLevels(input) {
                 return okLevels({ price: low.price, label: 'flag lower retest' }, { price: high.price, label: 'flag high pattern fail' }, 'post_breakout_retest', 'retest', 'short');
             }
             const entry = { price: high.price, label: 'flag upper bounce' };
-            if (!withinEntryProximity(lastClose, entry.price, entryProximityPct)) {
-                return { ok: false, unclearReason: `Price not within ${entryProximityPct}% of flag resistance entry.` };
+            const proximityFail = failUnlessWithinEntryProximity(lastClose, entry.price, entryProximityPct, 'flag resistance entry', proximityOptions);
+            if (proximityFail) {
+                return proximityFail;
             }
             return okLevels(entry, { price: high.price, label: 'flag high pattern fail' }, 'inside_pattern', 'bounce', 'short');
         }