تحويل مؤشر من أي لغة إلى JavaScript

source — يصل compute مصفوفة قيم لا نصّاً، وقائمته تشمل نواتج المؤشرات النشطة الأخرى فتُركَّب المؤشرات بعضها على بعض. التفصيل في القسم ٣.٦.

{ id: 'src', type: 'source', label: 'المصدر', def: 'close' }

symbol — لا تكتب قائمة أزواج بيدك في select. هذا النوع يفتح قائمة رموز المنصّة نفسها (ببحثها وتصنيفاتها ومفضّلتها) كما يفعل input.symbol في TradingView، فتبقى القائمة صحيحة كلّما أُضيف زوج. قيمته نصّ رمز يُمرَّر إلى request.security مباشرةً، والفارغ '' يعني «اتبع رمز الشارت» — وهو خيار ظاهر في أعلى القائمة، فلا يعلق المستخدم على رمز ثابت.

{ id: 'partner', type: 'symbol', label: 'الرمز المقارَن', def: 'US30' }

xloc: 'bar_index' — الإحداثي برقم الشمعة (مقابل xloc.bar_index في Pine)

أضِف xloc: 'bar_index' إلى الشكل فيصير كل إحداثي أفقي فيه رقم شمعة لا وقتاً:

{ kind: 'line', xloc: 'bar_index', x1: i, x2: i + 20, y1: p1, y2: p2 }

يسري على box وline وlabel وcircle وfill (حقل t) وlinefill. الأرقام خارج المدى تُسقَط بخطوة الفريم (n + 5 = خمس شمعات بعد الأخيرة، والسالب قبل الأولى) — لكن الأوقات المستقبلية تبقى خارج المقياس الزمني كما هي موضّح في ملاحظة الإسقاط أدناه. بلا xloc يبقى x وقتاً حرفياً، فلا يتغيّر أي مؤشر قائم.

قواعد اللوحة:

• ٤ لوحات لكل مؤشر كحدّ أقصى، ٢٤ صفاً × ٨ أعمدة، و٦٤ حرفاً للخليّة. تُحتسب من سقف الـ ١٥٠٠ شكل بعدد خلاياها لا كشكل واحد.
• لوحات عدّة مؤشرات في نفس الموضع تتكدّس تلقائياً ولا تتراكب؛ وترتيبها ثابت لا يتبدّل بين إطار وآخر. لوحات الأسفل تتكدّس صعوداً.
• تُرسم فوق كل شيء دائماً، ولا تؤثّر في مقياس السعر إطلاقاً.
• نصّ أعرض من خليّته يُقصّ عند حدّها ولا يزحف على جارتها.

قيود الأشكال:

• تعمل على الشارت الرئيسي (overlay: true) وفي اللوحة السفلية (overlay: false) معاً — الإحداثيات بالسعر، فمؤشر أشكال بحت في لوحة مستقلّة يضبط قيم y ضمن نطاقه الخاص.
• الحدّ الأقصى ١٥٠٠ شكل. احترم بارامتراً مثل maxDays بدل رسم كل التاريخ.
• الأشكال غير تفاعلية وتُحذف تلقائياً مع المؤشر.

قواعد الخلفية:

• تُرسم تحت كل شيء — تحت أشكال المؤشر نفسه وتحت الشموع.
• لا تؤثّر في مقياس السعر إطلاقاً: لا سعر لها أصلاً، تمتدّ من أعلى اللوحة إلى أسفلها.
• الشمعات المتجاورة ذات اللون الواحد تُدمج تلقائياً في عمود واحد، فلا تقلق من تلوين التاريخ كلّه: ٣٠٠٠ شمعة بلونين تصير عشرات الأعمدة لا ٣٠٠٠ شكل. (ولا تُحتسب من سقف الـ ١٥٠٠ شكل — هي ليست أشكالاً.)
• استعمل ألواناً شفّافة جداً (٠٫٠٥–٠٫١٥). اللون المصمت يبتلع الشموع.
• تعمل في الشارت الرئيسي وفي اللوحة السفلية معاً.

قواعد المصدر:

• TA.src(candles, 'hl2') يبقى موجوداً لمن يريد مصدراً ثابتاً في الكود بلا مدخل. المدخل هو ما يجعله اختيار المستخدم.
• اكتب الكود ليحتمل NaN. ناتج مؤشر آخر يبدأ بفترة إحماء، والمؤشر المُغذّي قد يُوقَف فتصل السلسلة كلّها NaN. لا ترمِ خطأً — أرجِع سلسلة ولو فارغة القيم.
• تأخّر دورة رسم واحدة. المصدر هو آخر ما رُسم فعلاً للمؤشر المُغذّي، لا إعادة حساب له. أثره محصور في آخر شمعة أثناء التيك الحيّ، والدورتان تتقاربان فوراً. (هذا ما يمنع التكرار الدائري: أ يقرأ ب يقرأ أ.)
• تبديل الرمز أو الفريم آمن: المحاذاة بالوقت لا بالفهرس، فبيانات السوق القديم لا تطابق أوقات الشموع الجديدة فتخرج فجوةً لا قيمةً كاذبة.
• المؤشرات المدمجة (SMA وRSI وما إليها) تبقى على مصدرها النصّي القديم — تركيب المؤشرات ميزةُ المؤشرات المخصّصة.

النمط الموصى به مع التقاطعات: ارفع المتوسطين لكامل الطول ثم قاطِع:

const f = TA.align(candles, TA.ema(close, 12), 11);
const s = TA.align(candles, TA.ema(close, 26), 25);
const buy = TA.crossover(f, s);          // مصفوفة منطقية بطول الشموع

source — compute receives an array of values, not a string, and its list includes the outputs of other active indicators, so indicators can be stacked on one another. Details in section 3.6.

{ id: 'src', type: 'source', label: 'Source', def: 'close' }

symbol — do not hand-write a list of pairs in a select. This type opens the platform's own symbol list (with its search, categories and favourites) exactly as input.symbol does in TradingView, so the list stays correct whenever a pair is added. Its value is a symbol string passed straight to request.security, and an empty '' means "follow the chart's symbol" — an option shown at the top of the list, so the user is never stuck on a fixed symbol.

{ id: 'partner', type: 'symbol', label: 'Compared symbol', def: 'US30' }

xloc: 'bar_index' — bar-number coordinates (the counterpart of Pine's xloc.bar_index)

Add xloc: 'bar_index' to the shape and every horizontal coordinate in it becomes a bar number rather than a time:

{ kind: 'line', xloc: 'bar_index', x1: i, x2: i + 20, y1: p1, y2: p2 }

It applies to box, line, label, circle, fill (the t field) and linefill. Numbers outside the range are projected by the timeframe's step (n + 5 = five bars past the last, negatives before the first) — but future times remain outside the time scale as explained in the projection note below. Without xloc, x stays a literal time, so no existing indicator changes.

Panel rules:

• 4 panels per indicator at most, 24 rows × 8 columns, and 64 characters per cell. They count against the 1,500-shape ceiling by their cell count, not as one shape.
• Panels from several indicators in the same position stack automatically and never overlap; their order is stable and does not change from frame to frame. Bottom panels stack upwards.
• They are always drawn above everything, and never affect the price scale.
• Text wider than its cell is clipped at the cell's edge and never creeps onto its neighbour.

Shape constraints:

• They work on the main chart (overlay: true) and in the lower pane (overlay: false) alike — the coordinates are prices, so a pure-shapes indicator in its own pane sets its y values within its own range.
• The maximum is 1,500 shapes. Honour a parameter such as maxDays rather than drawing the whole history.
• Shapes are not interactive and are removed automatically with the indicator.

Background rules:

• It is drawn beneath everything — beneath the indicator's own shapes and beneath the candles.
• It never affects the price scale: it has no price at all, it spans from the top of the pane to the bottom.
• Adjacent candles of the same colour are merged automatically into one column, so do not worry about colouring the whole history: 3,000 candles in two colours become dozens of columns, not 3,000 shapes. (And they do not count against the 1,500-shape ceiling — they are not shapes.)
• Use very transparent colours (0.05–0.15). A solid colour swallows the candles.
• It works on the main chart and in the lower pane alike.

Source rules:

• TA.src(candles, 'hl2') still exists for anyone who wants a fixed source in the code with no input. The input is what makes it the user's choice.
• Write code that tolerates NaN. Another indicator's output starts with a warm-up period, and the feeding indicator may be switched off so the whole series arrives as NaN. Do not throw — return a series even if it has no values.
• One draw cycle of lag. The source is the last thing actually drawn for the feeding indicator, not a recalculation of it. Its effect is confined to the last candle during a live tick, and the two cycles converge immediately. (This is what prevents circular recursion: A reads B reads A.)
• Switching the symbol or the timeframe is safe: alignment is by time, not by index, so the old market's data does not match the new candles' times and comes out as a gap rather than a false value.
• The built-in indicators (SMA, RSI and so on) keep their old string source — indicator stacking is a custom-indicator feature.

The recommended pattern with crossings: lift both averages to full length, then cross them:

const f = TA.align(candles, TA.ema(close, 12), 11);
const s = TA.align(candles, TA.ema(close, 26), 25);
const buy = TA.crossover(f, s);          // a boolean array the length of the candles