@continuumdao/continuum-node-sdk 1.3.37 → 1.3.39

package/dist/core/chart/analysis/trade-setups/donchian-trade-setup.d.ts

@@ -0,0 +1,137 @@
+import type { EntryOffsetMode, EntryProximityMode } from './pattern-limit-entry.js';
+import type { TradeSetupSide, TradeSetupStatus } from './shared.js';
+export declare const DEFAULT_DONCHIAN_PERIOD = 20;
+export declare const DEFAULT_DONCHIAN_ENTRY_MODE: "retest";
+export declare const DEFAULT_DONCHIAN_BREAK_LOOKBACK = 30;
+/** Target = entry ± (multiple × ATR). Desk: universal.donchianTargetAtrMultiple. */
+export declare const DEFAULT_DONCHIAN_TARGET_ATR_MULTIPLE = 3;
+export type DonchianEntryMode = 'retest' | 'immediate';
+export type DonchianTradeSetup = {
+    status: TradeSetupStatus;
+    source: 'donchian_breakout';
+    entryMode: DonchianEntryMode;
+    lastClose: number;
+    upper: number;
+    middle: number;
+    lower: number;
+    priorUpper: number;
+    priorLower: number;
+    channelWidth: number;
+    period: number;
+    entryProximityPct: number;
+    entryOffsetMode: EntryOffsetMode;
+    entryOffsetPct: number;
+    invalidationOffsetPct: number;
+    invalidationOffsetMode?: EntryProximityMode;
+    /** ATR at last bar used for target distance (entry ± multiple × ATR). */
+    atrAtLastBar?: number;
+    /** Desk multiple for ATR target (default 3). */
+    targetAtrMultiple: number;
+    setupPurposeCode: string;
+    invalidated: boolean;
+    side: TradeSetupSide;
+    brokeOnLastBar: boolean;
+    breakBarIndex?: number;
+    entryPrice?: number;
+    entryLabel?: string;
+    targetPrice?: number;
+    targetLabel?: string;
+    invalidationPrice?: number;
+    invalidationLabel?: string;
+    conditionalNote: string;
+    confidence: number;
+    unclearReason?: string;
+    /** Nested when primary mode is retest. */
+    immediateAlternative?: DonchianTradeSetup | null;
+    /** Nested when primary mode is immediate. */
+    breakRetestAlternative?: DonchianTradeSetup | null;
+};
+export type DonchianChannelPoint = {
+    upper: number;
+    middle: number;
+    lower: number;
+};
+export declare function buildImmediateDonchianSetup(input: {
+    lastClose: number;
+    prevClose: number;
+    upper: number;
+    middle: number;
+    lower: number;
+    priorUpper: number;
+    priorLower: number;
+    period: number;
+    entryProximityPct?: number;
+    entryOffsetPct?: number;
+    invalidationOffsetPct?: number;
+    invalidationOffsetMode?: EntryProximityMode;
+    atr?: number | null;
+    targetAtrMultiple?: number;
+}): DonchianTradeSetup | null;
+export declare function buildRetestDonchianSetup(input: {
+    closes: number[];
+    channels: Array<DonchianChannelPoint | null>;
+    lastClose: number;
+    upper: number;
+    middle: number;
+    lower: number;
+    priorUpper: number;
+    priorLower: number;
+    period: number;
+    entryProximityPct?: number;
+    entryOffsetPct?: number;
+    invalidationOffsetPct?: number;
+    invalidationOffsetMode?: EntryProximityMode;
+    atr?: number | null;
+    targetAtrMultiple?: number;
+    lookback?: number;
+}): DonchianTradeSetup | null;
+export declare function buildDonchianTradeSetup(input: {
+    closes: number[];
+    channels: Array<DonchianChannelPoint | null>;
+    period: number;
+    entryMode?: DonchianEntryMode;
+    entryProximityPct?: number;
+    entryOffsetPct?: number;
+    invalidationOffsetPct?: number;
+    invalidationOffsetMode?: EntryProximityMode;
+    atr?: number | null;
+    targetAtrMultiple?: number;
+}): DonchianTradeSetup | null;
+export type DonchianTradeIdeaContext = {
+    period: number;
+    entryMode: DonchianEntryMode;
+    setupPurposeCode: string;
+    channelWidth: number;
+    upper: number;
+    middle: number;
+    lower: number;
+    priorUpper: number;
+    priorLower: number;
+    invalidated: boolean;
+    entryProximityPct: number;
+    entryOffsetPct: number;
+    invalidationOffsetPct: number;
+    atrAtLastBar?: number;
+    targetAtrMultiple: number;
+};
+export declare function donchianTradeIdeaContextFromSetup(setup: DonchianTradeSetup): DonchianTradeIdeaContext;
+export declare function normalizeDonchianTradeSetup(setup: DonchianTradeSetup): {
+    unclearReason: string | undefined;
+    invalidation?: {
+        price: number;
+        label: string;
+    } | undefined;
+    target?: {
+        price: number;
+        label: string;
+    } | undefined;
+    status: TradeSetupStatus;
+    side: TradeSetupSide;
+    confidence: number;
+    lastClose: number;
+    entry: {
+        price: number;
+        label: string;
+    } | undefined;
+};
+//# sourceMappingURL=donchian-trade-setup.d.ts.map

package/dist/core/chart/analysis/trade-setups/donchian-trade-setup.d.ts.map

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

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

@@ -0,0 +1,436 @@
+import { isFiniteTradePrice } from './shared.js';
+import { tradeDeskConfig } from './trade-desk-defaults.js';
+export const DEFAULT_DONCHIAN_PERIOD = 20;
+export const DEFAULT_DONCHIAN_ENTRY_MODE = 'retest';
+export const DEFAULT_DONCHIAN_BREAK_LOOKBACK = 30;
+/** Target = entry ± (multiple × ATR). Desk: universal.donchianTargetAtrMultiple. */
+export const DEFAULT_DONCHIAN_TARGET_ATR_MULTIPLE = 3;
+function withinPriceProximity(lastClose, entryPrice, proximityPct) {
+    if (!isFiniteTradePrice(lastClose) || !isFiniteTradePrice(entryPrice) || entryPrice === 0) {
+        return false;
+    }
+    return (Math.abs(lastClose - entryPrice) / Math.abs(entryPrice)) * 100 <= proximityPct;
+}
+function resolveTargetAtrMultiple(raw) {
+    if (raw != null && Number.isFinite(raw) && raw > 0) {
+        return raw;
+    }
+    return DEFAULT_DONCHIAN_TARGET_ATR_MULTIPLE;
+}
+/** Target = breakout entry ± (multiple × ATR); invalidation = Donchian mid. */
+function donchianTargetAndInvalidation(input) {
+    if (input.status !== 'clear' || (input.side !== 'long' && input.side !== 'short')) {
+        return {};
+    }
+    const invalidationPrice = isFiniteTradePrice(input.middle) ? input.middle : undefined;
+    const invalidationLabel = invalidationPrice != null ? 'Donchian mid-channel' : undefined;
+    const atr = input.atr;
+    const multiple = input.targetAtrMultiple;
+    let targetPrice;
+    let targetLabel;
+    if (input.entryPrice != null &&
+        isFiniteTradePrice(input.entryPrice) &&
+        atr != null &&
+        Number.isFinite(atr) &&
+        atr > 0) {
+        const distance = multiple * atr;
+        targetPrice =
+            input.side === 'long' ? input.entryPrice + distance : input.entryPrice - distance;
+        targetLabel =
+            input.side === 'long'
+                ? `entry + ${multiple}× ATR`
+                : `entry - ${multiple}× ATR`;
+    }
+    return {
+        ...(targetPrice != null && targetLabel ? { targetPrice, targetLabel } : {}),
+        ...(invalidationPrice != null && invalidationLabel
+            ? { invalidationPrice, invalidationLabel }
+            : {}),
+    };
+}
+function baseSetupFields(input) {
+    const channelWidth = input.upper - input.lower;
+    return {
+        source: 'donchian_breakout',
+        entryMode: input.entryMode,
+        lastClose: input.lastClose,
+        upper: input.upper,
+        middle: input.middle,
+        lower: input.lower,
+        priorUpper: input.priorUpper,
+        priorLower: input.priorLower,
+        channelWidth,
+        period: input.period,
+        entryProximityPct: input.entryProximityPct,
+        entryOffsetPct: input.entryOffsetPct,
+        invalidationOffsetPct: input.invalidationOffsetPct,
+        ...(input.invalidationOffsetMode != null
+            ? { invalidationOffsetMode: input.invalidationOffsetMode }
+            : {}),
+        targetAtrMultiple: input.targetAtrMultiple,
+        ...(input.atrAtLastBar != null && Number.isFinite(input.atrAtLastBar) && input.atrAtLastBar > 0
+            ? { atrAtLastBar: input.atrAtLastBar }
+            : {}),
+    };
+}
+export function buildImmediateDonchianSetup(input) {
+    const { lastClose, prevClose, upper, middle, lower, priorUpper, priorLower, period, } = input;
+    if (![lastClose, prevClose, upper, middle, lower, priorUpper, priorLower].every(isFiniteTradePrice) ||
+        upper <= lower ||
+        priorUpper <= priorLower) {
+        return null;
+    }
+    const desk = tradeDeskConfig({
+        entryProximityPct: input.entryProximityPct,
+        entryOffsetPct: input.entryOffsetPct,
+        invalidationOffsetPct: input.invalidationOffsetPct,
+        invalidationOffsetMode: input.invalidationOffsetMode,
+    });
+    const targetAtrMultiple = resolveTargetAtrMultiple(input.targetAtrMultiple);
+    const atr = input.atr != null && Number.isFinite(input.atr) && input.atr > 0 ? input.atr : undefined;
+    const base = baseSetupFields({
+        lastClose,
+        upper,
+        middle,
+        lower,
+        priorUpper,
+        priorLower,
+        period,
+        entryMode: 'immediate',
+        entryProximityPct: desk.entryProximityPct,
+        entryOffsetPct: desk.entryOffsetPct,
+        invalidationOffsetPct: desk.invalidationOffsetPct,
+        invalidationOffsetMode: desk.invalidationOffsetMode,
+        atrAtLastBar: atr,
+        targetAtrMultiple,
+    });
+    const brokeLong = prevClose <= priorUpper && lastClose > priorUpper;
+    const brokeShort = prevClose >= priorLower && lastClose < priorLower;
+    const holdingLong = lastClose > priorUpper;
+    const holdingShort = lastClose < priorLower;
+    let side = 'neutral';
+    let brokeOnLastBar = false;
+    let status = 'unclear';
+    let confidence = 0.4;
+    let conditionalNote = 'No Donchian channel breakout — price inside prior channel.';
+    let unclearReason = 'No immediate Donchian breakout on the latest bar.';
+    if (brokeLong || (holdingLong && !holdingShort)) {
+        side = 'long';
+        brokeOnLastBar = brokeLong;
+        conditionalNote = brokeLong
+            ? 'Fresh bullish Donchian breakout above prior channel high.'
+            : 'Price holding above prior Donchian high — continuation long.';
+        const nearEntry = withinPriceProximity(lastClose, priorUpper, desk.entryProximityPct);
+        if (brokeLong || nearEntry) {
+            status = 'clear';
+            unclearReason = '';
+            confidence = brokeLong ? 0.58 : 0.5;
+        }
+        else {
+            unclearReason = `Price extended beyond prior high — not within ${desk.entryProximityPct}% of breakout entry.`;
+        }
+    }
+    else if (brokeShort || holdingShort) {
+        side = 'short';
+        brokeOnLastBar = brokeShort;
+        conditionalNote = brokeShort
+            ? 'Fresh bearish Donchian breakout below prior channel low.'
+            : 'Price holding below prior Donchian low — continuation short.';
+        const nearEntry = withinPriceProximity(lastClose, priorLower, desk.entryProximityPct);
+        if (brokeShort || nearEntry) {
+            status = 'clear';
+            unclearReason = '';
+            confidence = brokeShort ? 0.58 : 0.5;
+        }
+        else {
+            unclearReason = `Price extended beyond prior low — not within ${desk.entryProximityPct}% of breakout entry.`;
+        }
+    }
+    const entryPrice = status === 'clear' && side === 'long'
+        ? priorUpper
+        : status === 'clear' && side === 'short'
+            ? priorLower
+            : undefined;
+    const entryLabel = side === 'long' ? 'prior Donchian high' : side === 'short' ? 'prior Donchian low' : undefined;
+    const levels = donchianTargetAndInvalidation({
+        side,
+        status,
+        entryPrice,
+        middle,
+        atr,
+        targetAtrMultiple,
+    });
+    return {
+        ...base,
+        status,
+        setupPurposeCode: 'dc-brk',
+        invalidated: false,
+        side,
+        brokeOnLastBar,
+        entryOffsetMode: 'bounce',
+        conditionalNote,
+        confidence,
+        ...(entryPrice != null && entryLabel ? { entryPrice, entryLabel } : {}),
+        ...levels,
+        ...(unclearReason ? { unclearReason } : {}),
+    };
+}
+export function buildRetestDonchianSetup(input) {
+    const { closes, channels, lastClose, upper, middle, lower, priorUpper, priorLower, period } = input;
+    if (![lastClose, upper, middle, lower, priorUpper, priorLower].every(isFiniteTradePrice) ||
+        closes.length < 3 ||
+        channels.length !== closes.length) {
+        return null;
+    }
+    const desk = tradeDeskConfig({
+        entryProximityPct: input.entryProximityPct,
+        entryOffsetPct: input.entryOffsetPct,
+        invalidationOffsetPct: input.invalidationOffsetPct,
+        invalidationOffsetMode: input.invalidationOffsetMode,
+    });
+    const targetAtrMultiple = resolveTargetAtrMultiple(input.targetAtrMultiple);
+    const atr = input.atr != null && Number.isFinite(input.atr) && input.atr > 0 ? input.atr : undefined;
+    const lookback = input.lookback ?? DEFAULT_DONCHIAN_BREAK_LOOKBACK;
+    const lastIndex = closes.length - 1;
+    const start = Math.max(period, lastIndex - lookback + 1);
+    let breakIndex = -1;
+    let side = 'neutral';
+    let brokenBand = 0;
+    for (let i = start; i <= lastIndex; i++) {
+        const prior = channels[i - 1];
+        const prevClose = closes[i - 1];
+        const curClose = closes[i];
+        if (prior == null ||
+            prevClose == null ||
+            curClose == null ||
+            !isFiniteTradePrice(prior.upper) ||
+            !isFiniteTradePrice(prior.lower)) {
+            continue;
+        }
+        if (prevClose <= prior.upper && curClose > prior.upper) {
+            breakIndex = i;
+            side = 'long';
+            brokenBand = prior.upper;
+        }
+        else if (prevClose >= prior.lower && curClose < prior.lower) {
+            breakIndex = i;
+            side = 'short';
+            brokenBand = prior.lower;
+        }
+    }
+    const base = baseSetupFields({
+        lastClose,
+        upper,
+        middle,
+        lower,
+        priorUpper,
+        priorLower,
+        period,
+        entryMode: 'retest',
+        entryProximityPct: desk.entryProximityPct,
+        entryOffsetPct: desk.entryOffsetPct,
+        invalidationOffsetPct: desk.invalidationOffsetPct,
+        invalidationOffsetMode: desk.invalidationOffsetMode,
+        atrAtLastBar: atr,
+        targetAtrMultiple,
+    });
+    if (breakIndex < 0 || side === 'neutral') {
+        return {
+            ...base,
+            status: 'unclear',
+            setupPurposeCode: 'dc-ret',
+            invalidated: false,
+            side: 'neutral',
+            brokeOnLastBar: false,
+            entryOffsetMode: 'retest',
+            conditionalNote: 'No recent Donchian breakout to retest.',
+            confidence: 0.35,
+            unclearReason: 'No channel break found in lookback — wait for breakout then retest.',
+        };
+    }
+    const brokeOnLastBar = breakIndex === lastIndex;
+    const nearBand = withinPriceProximity(lastClose, brokenBand, desk.entryProximityPct);
+    let invalidated = false;
+    if (side === 'long' && lastClose < brokenBand) {
+        invalidated = true;
+    }
+    else if (side === 'short' && lastClose > brokenBand) {
+        invalidated = true;
+    }
+    let status = 'unclear';
+    let confidence = 0.42;
+    let conditionalNote = side === 'long'
+        ? 'Bullish Donchian break occurred — wait for retest of broken high.'
+        : 'Bearish Donchian break occurred — wait for retest of broken low.';
+    let unclearReason = conditionalNote;
+    if (invalidated) {
+        status = 'unclear';
+        conditionalNote =
+            side === 'long'
+                ? 'Retest failed — price closed back below broken Donchian high.'
+                : 'Retest failed — price closed back above broken Donchian low.';
+        unclearReason = conditionalNote;
+    }
+    else if (!brokeOnLastBar && nearBand) {
+        status = 'clear';
+        unclearReason = '';
+        confidence = 0.56;
+        conditionalNote =
+            side === 'long'
+                ? 'Post-breakout retest of Donchian high — long entry.'
+                : 'Post-breakout retest of Donchian low — short entry.';
+    }
+    else if (brokeOnLastBar) {
+        unclearReason = 'Fresh breakout on last bar — wait for pullback retest of the broken band.';
+        conditionalNote = unclearReason;
+    }
+    else {
+        unclearReason = `Price not within ${desk.entryProximityPct}% of broken band for retest entry.`;
+        conditionalNote = unclearReason;
+    }
+    const entryPrice = status === 'clear' ? brokenBand : undefined;
+    const entryLabel = side === 'long' ? 'broken Donchian high' : side === 'short' ? 'broken Donchian low' : undefined;
+    const levels = donchianTargetAndInvalidation({
+        side,
+        status,
+        entryPrice,
+        middle,
+        atr,
+        targetAtrMultiple,
+    });
+    return {
+        ...base,
+        status,
+        setupPurposeCode: 'dc-ret',
+        invalidated,
+        side,
+        brokeOnLastBar,
+        breakBarIndex: breakIndex,
+        entryOffsetMode: 'retest',
+        conditionalNote,
+        confidence,
+        ...(entryPrice != null && entryLabel ? { entryPrice, entryLabel } : {}),
+        ...levels,
+        ...(unclearReason ? { unclearReason } : {}),
+    };
+}
+export function buildDonchianTradeSetup(input) {
+    const { closes, channels, period } = input;
+    if (closes.length < period + 1 || channels.length !== closes.length) {
+        return null;
+    }
+    const lastIndex = closes.length - 1;
+    const lastClose = closes[lastIndex];
+    const prevClose = closes[lastIndex - 1];
+    const current = channels[lastIndex];
+    const prior = channels[lastIndex - 1];
+    if (current == null || prior == null) {
+        return null;
+    }
+    const entryMode = input.entryMode ?? DEFAULT_DONCHIAN_ENTRY_MODE;
+    const desk = tradeDeskConfig({
+        entryProximityPct: input.entryProximityPct,
+        entryOffsetPct: input.entryOffsetPct,
+        invalidationOffsetPct: input.invalidationOffsetPct,
+        invalidationOffsetMode: input.invalidationOffsetMode,
+    });
+    const deskPcts = {
+        entryProximityPct: desk.entryProximityPct,
+        entryOffsetPct: desk.entryOffsetPct,
+        invalidationOffsetPct: desk.invalidationOffsetPct,
+        invalidationOffsetMode: desk.invalidationOffsetMode,
+    };
+    const atrLevels = {
+        atr: input.atr,
+        targetAtrMultiple: resolveTargetAtrMultiple(input.targetAtrMultiple),
+    };
+    const immediate = buildImmediateDonchianSetup({
+        lastClose,
+        prevClose,
+        upper: current.upper,
+        middle: current.middle,
+        lower: current.lower,
+        priorUpper: prior.upper,
+        priorLower: prior.lower,
+        period,
+        ...deskPcts,
+        ...atrLevels,
+    });
+    const retest = buildRetestDonchianSetup({
+        closes,
+        channels,
+        lastClose,
+        upper: current.upper,
+        middle: current.middle,
+        lower: current.lower,
+        priorUpper: prior.upper,
+        priorLower: prior.lower,
+        period,
+        ...deskPcts,
+        ...atrLevels,
+    });
+    if (entryMode === 'immediate') {
+        if (!immediate) {
+            return retest;
+        }
+        return {
+            ...immediate,
+            breakRetestAlternative: retest,
+            immediateAlternative: null,
+        };
+    }
+    if (!retest) {
+        return immediate;
+    }
+    return {
+        ...retest,
+        immediateAlternative: immediate,
+        breakRetestAlternative: null,
+    };
+}
+export function donchianTradeIdeaContextFromSetup(setup) {
+    return {
+        period: setup.period,
+        entryMode: setup.entryMode,
+        setupPurposeCode: setup.setupPurposeCode,
+        channelWidth: setup.channelWidth,
+        upper: setup.upper,
+        middle: setup.middle,
+        lower: setup.lower,
+        priorUpper: setup.priorUpper,
+        priorLower: setup.priorLower,
+        invalidated: setup.invalidated,
+        entryProximityPct: setup.entryProximityPct,
+        entryOffsetPct: setup.entryOffsetPct,
+        invalidationOffsetPct: setup.invalidationOffsetPct,
+        targetAtrMultiple: setup.targetAtrMultiple,
+        ...(setup.atrAtLastBar != null ? { atrAtLastBar: setup.atrAtLastBar } : {}),
+    };
+}
+export function normalizeDonchianTradeSetup(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 ?? 'Donchian entry' }
+            : undefined,
+        ...(setup.targetPrice != null && isFiniteTradePrice(setup.targetPrice)
+            ? { target: { price: setup.targetPrice, label: setup.targetLabel ?? 'Donchian target' } }
+            : {}),
+        ...(setup.invalidationPrice != null && isFiniteTradePrice(setup.invalidationPrice)
+            ? {
+                invalidation: {
+                    price: setup.invalidationPrice,
+                    label: setup.invalidationLabel ?? 'Donchian invalidation',
+                },
+            }
+            : {}),
+        unclearReason: setup.unclearReason,
+    };
+}
+//# sourceMappingURL=donchian-trade-setup.js.map

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

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

package/dist/core/chart/analysis/trade-setups/elliott-waves-trade-setup.d.ts

@@ -24,10 +24,14 @@ export type ElliottWaveTradeSetup = {
     }>;
     waveMenuNumber?: number;
     setupPurposeCode?: 'ew-imp' | 'ew-dia' | 'ew-corr';
+    atrAtLastBar?: number;
     unclearReason?: string;
     dataGuidance?: string;
 };
-export declare function buildElliottWaveTradeSetup(analysis: AnalyzeElliottWavesResult, waveMenuNumber?: number): ElliottWaveTradeSetup;
+export declare function buildElliottWaveTradeSetup(analysis: AnalyzeElliottWavesResult, waveMenuNumber?: number, options?: {
+    bars?: Record<string, unknown>[];
+    entryProximityAtrPeriod?: number;
+}): ElliottWaveTradeSetup;
 export declare function normalizeElliottWaveTradeSetup(setup: ElliottWaveTradeSetup): {
     status: TradeSetupStatus;
     side: TradeSetupSide;

package/dist/core/chart/analysis/trade-setups/elliott-waves-trade-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elliott-waves-trade-setup.d.ts","sourceRoot":"","sources":["../../../../../src/core/chart/analysis/trade-setups/elliott-waves-trade-setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAC,cAAc,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAIlE,MAAM,MAAM,qBAAqB,GAAG;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,IAAI,GAAG,MAAM,CAAC;IAC9B,WAAW,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,KAAK,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAyCF,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,yBAAyB,EACnC,cAAc,SAAI,GAChB,qBAAqB,CAoGvB;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;EAoB1E"}
+{"version":3,"file":"elliott-waves-trade-setup.d.ts","sourceRoot":"","sources":["../../../../../src/core/chart/analysis/trade-setups/elliott-waves-trade-setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAC,cAAc,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAMlE,MAAM,MAAM,qBAAqB,GAAG;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,IAAI,GAAG,MAAM,CAAC;IAC9B,WAAW,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,KAAK,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAyCF,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,yBAAyB,EACnC,cAAc,SAAI,EAClB,OAAO,CAAC,EAAE;IACT,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACjC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CACjC,GACC,qBAAqB,CA2GvB;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;EAoB1E"}

package/dist/core/chart/analysis/trade-setups/elliott-waves-trade-setup.js

@@ -1,4 +1,6 @@
 import { isFiniteTradePrice } from './shared.js';
+import { entryProximityAtrFromOhlcvRows } from './entry-proximity-atr.js';
+import { DEFAULT_ENTRY_PROXIMITY_ATR_PERIOD } from './trade-desk-defaults.js';
 import { THRESHOLDS } from '../../../elliott-waves/constants.js';
 function sideFromTrend(trendDirection, patternType) {
     if (patternType === 'corrective') {
@@ -27,7 +29,12 @@ function purposeCode(patternType) {
             return 'ew-imp';
     }
 }
-export function buildElliottWaveTradeSetup(analysis, waveMenuNumber = 1) {
+export function buildElliottWaveTradeSetup(analysis, waveMenuNumber = 1, options) {
+    const atrPeriod = options?.entryProximityAtrPeriod ?? DEFAULT_ENTRY_PROXIMITY_ATR_PERIOD;
+    const atrAtLastBar = options?.bars?.length
+        ? entryProximityAtrFromOhlcvRows(options.bars, atrPeriod)
+        : null;
+    const atrFields = atrAtLastBar != null ? { atrAtLastBar } : {};
     const base = {
         status: 'unclear',
         source: 'elliott_waves',
@@ -39,6 +46,7 @@ export function buildElliottWaveTradeSetup(analysis, waveMenuNumber = 1) {
         confirmedWaveCount: analysis.confirmedWaveCount,
         waveMenuNumber,
         setupPurposeCode: purposeCode(analysis.patternType),
+        ...atrFields,
     };
     if (analysis.dataStatus === 'insufficient_data') {
         return {