oakscriptjs 0.11.0 → 0.11.1

package/src/array/index.ts

@@ -41,7 +41,7 @@ function position(name: string, id: PineArray<unknown>, index: number, extra = 0
   const i = Math.trunc(index);
   const n = id.length;
   if (i < -n || i >= n + extra) {
-    throw new Error(`array.${name}: index ${i} is out of bounds, array size is ${n}`);
+    throw new Error(`In 'array.${name}()' function. Index ${i} is out of bounds, array size is ${n}.`);
   }
   return i < 0 ? i + n : i;
 }
@@ -50,7 +50,12 @@ function position(name: string, id: PineArray<unknown>, index: number, extra = 0
  * Returns the element at the specified index.
  *
  * PineScript rules: a negative index counts from the end (`get(a, -1)` is the last element); an index outside
- * `-size .. size - 1` is a runtime error (throws); an `na` index gives `na`.
+ * `-size .. size - 1` is a runtime error (throws "In 'array.get()' function. Index 5 is out of bounds, array size
+ * is 3."); an `na` index gives `na`.
+ *
+ * Negative indexes are a PineScript v6 rule, which oakscriptjs follows: a version 5 script stops on them with the
+ * same out of bounds error (`array.get(a, -1)`, #176). A port of a v5 script that the original stops must check the
+ * index itself.
  */
 export function get<T>(id: PineArray<T>, index: simple_int): T {
   if (Number.isNaN(index)) return naOf(id);
@@ -973,7 +978,8 @@ export function binary_search_rightmost(id: PineArray<float>, val: float): int {
  * - Formula: Cov(X,Y) = E[(X - μX)(Y - μY)]
  *
  * PineScript rules: a pair where either value is `na` is skipped and the count is the number of pairs kept; both
- * means first, then the sum of the products from the first to the last pair. One pair gives 0 biased, NaN unbiased.
+ * means first, then the sum of the products from the first to the last pair, set to 0 whenever it is within 1e-10 of
+ * zero (#177: five equal closes give 0, not -1.7e-18). One pair gives 0 biased, NaN unbiased.
  */
 export function covariance(id1: PineArray<float>, id2: PineArray<float>, biased: bool = true): float {
   if (id1.length !== id2.length) {
@@ -996,9 +1002,11 @@ export function covariance(id1: PineArray<float>, id2: PineArray<float>, biased:
   }
   mean1 /= n;
   mean2 /= n;
+  // the co-moment is a running sum set to 0 when it is within 1e-10 of zero, as array.sum (#177)
   let sum = 0;
   for (let i = 0; i < n; i++) {
     sum += (xs[i]! - mean1) * (ys[i]! - mean2);
+    if (Math.abs(sum) <= 1e-10) sum = 0;
   }
   return sum / (biased ? n : n - 1);
 }

package/src/box/index.ts

@@ -91,8 +91,8 @@ export function new_box(...args: unknown[]): Box {
     (string | number)?, color?, ('left' | 'center' | 'right')?, ('top' | 'center' | 'bottom')?,
     ('none' | 'auto')?, ('default' | 'monospace')?, boolean?, number?,
   ];
-  checkBarIndex('box.new', 'left', left, xloc);
-  checkBarIndex('box.new', 'right', right, xloc);
+  left = checkBarIndex('box.new', 'left', left, xloc);
+  right = checkBarIndex('box.new', 'right', right, xloc);
   return register('box', {
     left,
     top,
@@ -248,7 +248,7 @@ export function copy(id: Box): Box {
  */
 export function set_left(id: Box, left: number): Box {
   if (isDeleted(id)) return id;
-  checkBarIndex('box.set_(left*/xloc)', 'left', left, id.xloc);
+  left = checkBarIndex('box.set_(left*/xloc)', 'left', left, id.xloc);
   id.left = left;
   return id;
 }
@@ -268,7 +268,7 @@ export function set_left(id: Box, left: number): Box {
  */
 export function set_right(id: Box, right: number): Box {
   if (isDeleted(id)) return id;
-  checkBarIndex('box.set_(right*/xlock)', 'right', right, id.xloc);
+  right = checkBarIndex('box.set_(right*/xlock)', 'right', right, id.xloc);
   id.right = right;
   return id;
 }
@@ -327,7 +327,7 @@ export function set_bottom(id: Box, bottom: number): Box {
  */
 export function set_lefttop(id: Box, left: number, top: number): Box {
   if (isDeleted(id)) return id;
-  checkBarIndex('box.set_(left*/xloc)', 'left', left, id.xloc);
+  left = checkBarIndex('box.set_(left*/xloc)', 'left', left, id.xloc);
   id.left = left;
   id.top = top;
   return id;
@@ -349,7 +349,7 @@ export function set_lefttop(id: Box, left: number, top: number): Box {
  */
 export function set_rightbottom(id: Box, right: number, bottom: number): Box {
   if (isDeleted(id)) return id;
-  checkBarIndex('box.set_(right*/xlock)', 'right', right, id.xloc);
+  right = checkBarIndex('box.set_(right*/xlock)', 'right', right, id.xloc);
   id.right = right;
   id.bottom = bottom;
   return id;

package/src/callsite/index.ts

@@ -364,8 +364,8 @@ function loopSumSite(
   let pending = false;
   return (barIndex, value, length) => {
     const len = Math.floor(length);
-    if (!(len >= 1)) throw new Error(`callsite.${name}: length must be at least 1 (got ${length})`);
     checkSumLength(name === 'sum' ? 'math.sum' : `ta.${name}`, len, barIndex);
+    if (!(len >= 1)) throw new Error(`callsite.${name}: length must be at least 1 (got ${length})`);
     if (barIndex !== lastBar) {
       if (pending) {
         running.commit();

package/src/drawing/registry.ts

@@ -36,8 +36,9 @@
  * - polylines on the last bar: the `P` carried from the bar before is counted twice (the first creation adds it once
  *   more, unless it sets `P` to 0), later creations do not set `P` to 0, and the polylines of the bars before that a
  *   cut deletes are added to `P`. Once none is
- *   left, a cut deletes polylines of the last bar and `P` becomes the number of polylines of the bars before deleted
- *   on the last bar (by the count or by the script). Equal to PineScript for the polylines alive at the end on 271 of
+ *   left, `P` is at least the number of polylines of the bars before deleted on the last bar (by the count or by
+ *   the script) and a cut deletes polylines of the last bar: a script that deletes its 100 polylines and creates 200
+ *   on the last bar keeps them all (#176). Equal to PineScript for the polylines alive at the end on 271 of
  *   281 probe runs; the count inside the bar can differ when the script deletes polylines of the last bar
  *
  * - a bar index (`xloc.bar_index`) more than 10,000 bars before the current bar stops the script (runtime error
@@ -171,7 +172,10 @@ export function varDrawing<T extends object>(initial?: T): DrawingVariable<T> {
 
 /** Largest distance, in bars, of a bar index before the current bar (PineScript runtime error RE10026 above it). */
 export const MAX_DRAWING_BARS_BACK = 10000;
+/** Largest distance, in bars, of a bar index after the last bar of the data (PineScript runtime error RE10020 above it). */
+export const MAX_DRAWING_BARS_FORWARD = 500;
 let currentBar: number | null = null;
+let lastBarIndex: number | null = null;
 
 /** Kinds whose allowance on the last bar is the `P` they had when the bar started. */
 type AllowanceKind = 'line' | 'label' | 'box';
@@ -198,11 +202,14 @@ let lastBar: LastBar | null = null;
  * bars back throws as in PineScript; `null` turns the check off. `eachBar` of the script API calls it.
  *
  * The bar also dates the objects held by a `var` variable (protected from the next bar on). `last` says that it is
- * the last bar of the data, which has rules of its own for the maximum count.
+ * the last bar of the data, which has rules of its own for the maximum count. `lastIndex` is the bar index of the
+ * last bar of the data (PineScript `last_bar_index`): with it, a bar index more than 500 bars after it throws, also
+ * on the bars before the last one (RE10020).
  */
-export function setDrawingBar(barIndex: number | null, last: boolean = false): void {
+export function setDrawingBar(barIndex: number | null, last: boolean = false, lastIndex?: number): void {
   if (lastBar && !(last && barIndex === lastBar.bar)) lastBar = null;
   currentBar = barIndex;
+  lastBarIndex = barIndex === null ? null : (lastIndex ?? (last ? barIndex : null));
   if (barIndex !== null && last && !lastBar) {
     const start = (kind: AllowanceKind): number => (pending[kind] >= PENDING_RESET[kind] ? 0 : pending[kind]);
     lastBar = {
@@ -217,17 +224,30 @@ export function setDrawingBar(barIndex: number | null, last: boolean = false): v
 }
 
 /**
- * Throws the PineScript runtime error RE10026 when `x` is a bar index more than 10,000 bars before the current bar.
+ * Throws the PineScript runtime error RE10026 when `x` is a bar index more than 10,000 bars before the current bar,
+ * and RE10020 when it is more than 500 bars after the last bar of the data (when {@link setDrawingBar} knows it).
  * `method` and `variable` are the names of the PineScript message ("line.new", "x1").
+ *
+ * Returns `x`, truncated when it is a bar index: PineScript's x is an int (a box from 5537.94 starts on bar 5537,
+ * #176).
  */
-export function checkBarIndex(method: string, variable: string, x: number, xloc: string | undefined): void {
-  if (currentBar === null || (xloc ?? 'bar_index') !== 'bar_index') return;
+export function checkBarIndex(method: string, variable: string, x: number, xloc: string | undefined): number {
+  if ((xloc ?? 'bar_index') !== 'bar_index') return x;
+  x = Math.trunc(x);
+  if (currentBar === null) return x;
+  if (lastBarIndex !== null && x - lastBarIndex > MAX_DRAWING_BARS_FORWARD) {
+    throw new Error(
+      `Error on bar ${currentBar}: Objects positioned using xloc.bar_index cannot be drawn further than ` +
+        `${MAX_DRAWING_BARS_FORWARD} bars into the future.`
+    );
+  }
   if (currentBar - x > MAX_DRAWING_BARS_BACK) {
     throw new Error(
       `Error on bar ${currentBar}: Bar index value of the \`${variable}\` argument (${x}) in \`${method}()\` is too far ` +
         'from the current bar index. Try using `time` instead.'
     );
   }
+  return x;
 }
 
 /** Numeric fields that become NaN when an object is deleted, so that its getters return `na`. */
@@ -314,6 +334,8 @@ function registerLast<K extends DrawingKind>(bar: LastBar, kind: K, obj: Drawing
     }
     for (const old of cut) markDeleted(kind, old, true);
   } else {
+    // the polylines of the bars before deleted on this bar count before the cut (#176)
+    if (kind === 'polyline' && pending.polyline < bar.oldPolylinesGone) pending.polyline = bar.oldPolylinesGone;
     const cut = cutOldest(kind, list, obj);
     if (kind === 'polyline' && cut.length > 0) pending.polyline = bar.oldPolylinesGone;
     for (const old of cut) markDeleted(kind, old, false);
@@ -351,6 +373,7 @@ export function resetDrawings(newLimits: DrawingLimits = {}): void {
   heldAt = new WeakMap();
   pending = { line: 0, label: 0, box: 0, polyline: 0 };
   currentBar = null;
+  lastBarIndex = null;
   lastBar = null;
   limits = {
     line: newLimits.line ?? DEFAULT_MAX_COUNT,

package/src/index.ts

@@ -75,6 +75,15 @@ export { SessionBars, sessionFlags, type SessionFlags } from './session/bars.js'
 
 // Same-symbol request.security on a higher timeframe (completion and lookahead rules) and ticker.heikinashi
 export { resample, periodsOf, afterCompletion, mapToChart, heikinAshi, type Resampled } from './security/resample.js';
+// request.security of another symbol: which bar of the other symbol each chart bar shows (#179)
+export {
+  securityOther,
+  securityOtherValues,
+  securityLowerTf,
+  type OtherSymbolChart,
+  type OtherSymbolOptions,
+  type SymbolCalendar,
+} from './security/other.js';
 
 // Export Series class (self-contained, no context)
 export { Series, BarData } from './runtime/series.js';
@@ -170,6 +179,7 @@ export {
   input_source,
   input_timeframe,
   input_session,
+  input_symbol,
   input_time,
 } from './runtime/inputs.js';
 export { isInputActive } from './runtime/input-active.js';
@@ -205,7 +215,7 @@ export type { LightweightSeriesDefinitions } from './runtime/adapters/Lightweigh
 export { SimpleInputAdapter } from './runtime/adapters/SimpleInputAdapter.js';
 
 // Version
-export const VERSION = '0.11.0';
+export const VERSION = '0.11.1';
 
 /**
  * Library information

package/src/input.ts

@@ -9,7 +9,7 @@
  */
 export interface InputValue<T> {
   /** Input type identifier */
-  type: 'int' | 'float' | 'source' | 'bool' | 'string' | 'timeframe' | 'session' | 'time';
+  type: 'int' | 'float' | 'source' | 'bool' | 'string' | 'timeframe' | 'session' | 'time' | 'symbol';
   /** Default value */
   defaultValue: T;
   /** Current value (initially equals defaultValue) */
@@ -254,6 +254,23 @@ export const input = {
     };
   },
 
+  /**
+   * Create a symbol input parameter (PineScript `input.symbol`): a ticker id ("NASDAQ:MSFT") that an application can
+   * edit with a symbol picker (#180)
+   * @param defaultValue - Default ticker id
+   * @param options - Additional options (title, options for dropdown)
+   * @returns Input value object
+   */
+  symbol(defaultValue: string, options: StringInputOptions = {}): InputValue<string> {
+    return {
+      type: 'symbol' as const,
+      defaultValue,
+      value: defaultValue,
+      title: options.title,
+      options: options.options,
+    };
+  },
+
   /**
    * Create a date/time input parameter (PineScript `input.time`)
    * @param defaultValue - Default UNIX time in milliseconds, e.g. `time.timestamp('2024-01-01')`

package/src/label/index.ts

@@ -80,7 +80,7 @@ export function new_label(...args: unknown[]): Label {
     string?, LabelXloc?, LabelYloc?, color?, LabelStyle?, color?, (string | number)?,
     ('left' | 'center' | 'right')?, string?, ('default' | 'monospace')?, boolean?, number?,
   ];
-  checkBarIndex('label.new', 'x', x, xloc);
+  x = checkBarIndex('label.new', 'x', x, xloc);
   return register('label', {
     x,
     y,
@@ -189,7 +189,7 @@ export function copy(id: Label): Label {
  */
 export function set_x(id: Label, x: number): Label {
   if (isDeleted(id)) return id;
-  checkBarIndex('label.set_x', 'x', x, id.xloc);
+  x = checkBarIndex('label.set_x', 'x', x, id.xloc);
   id.x = x;
   return id;
 }
@@ -229,7 +229,7 @@ export function set_y(id: Label, y: number): Label {
  */
 export function set_xy(id: Label, x: number, y: number): Label {
   if (isDeleted(id)) return id;
-  checkBarIndex('label.set_x', 'x', x, id.xloc);
+  x = checkBarIndex('label.set_x', 'x', x, id.xloc);
   id.x = x;
   id.y = y;
   return id;

package/src/line/index.ts

@@ -70,8 +70,8 @@ export function new_line(...args: unknown[]): Line {
   const [xloc, extend, lineColor, style, width, force_overlay] = rest as [
     LineXloc?, LineExtend?, color?, LineStyle?, number?, boolean?,
   ];
-  checkBarIndex('line.new', 'x1', x1, xloc);
-  checkBarIndex('line.new', 'x2', x2, xloc);
+  x1 = checkBarIndex('line.new', 'x1', x1, xloc);
+  x2 = checkBarIndex('line.new', 'x2', x2, xloc);
   return register('line', {
     x1,
     y1,
@@ -87,83 +87,35 @@ export function new_line(...args: unknown[]): Line {
 }
 
 /**
- * Returns the price level of a line at a given bar index.
+ * Returns the price level of a line at a given bar index (PineScript `line.get_price`).
  *
  * @param id - Line object
  * @param x - Bar index to calculate price at
- * @returns Price level at the given bar index, or NaN if outside bounds and not extended
+ * @returns Price level at the given bar index; NaN for a vertical line (x1 == x2) or a deleted line
  *
  * @remarks
- * - **CRITICAL COMPUTATIONAL FUNCTION** - Enables trend line breakout detection
- * - Uses linear interpolation: y = y1 + (y2 - y1) * (x - x1) / (x2 - x1)
- * - Respects extend mode:
- *   - 'none': Returns NaN if x is outside [x1, x2]
- *   - 'left': Extends infinitely to the left (x < x1)
- *   - 'right': Extends infinitely to the right (x > x2)
- *   - 'both': Extends infinitely in both directions
- * - Only works with xloc='bar_index' lines (not xloc='bar_time')
- * - In PineScript, this function treats all lines as if extend='both' regardless of actual setting
- *   For compatibility, we follow the actual extend setting
+ * As in PineScript (#174):
+ * - the line is read as extended on both sides whatever its `extend`: a point before x1 or after x2 has a price
+ * - the price is `y1 + (y2 - y1) * (x - x1) / (x2 - x1)`, in that order (bit for bit)
+ * - a line placed with `xloc.bar_time` throws "'line.get_price' must be used with lines created using
+ *   'xloc=xloc.bar_index'." (runtime error RE10119)
  *
  * @example
  * ```typescript
  * const trendLine = line.new(0, 100, 50, 150, 'bar_index', 'right');
  *
- * // Within segment
- * line.get_price(trendLine, 25);  // Returns 125
- *
- * // Extended right
- * line.get_price(trendLine, 100); // Returns 200
- *
- * // Not extended left (with extend='right')
- * line.get_price(trendLine, -10); // Returns NaN
- *
- * // Use for breakout detection
- * const currentPrice = close[close.length - 1];
- * const linePrice = line.get_price(trendLine, close.length - 1);
- * if (currentPrice > linePrice) {
- *   console.log('Breakout above trend line!');
- * }
+ * line.get_price(trendLine, 25);  // 125
+ * line.get_price(trendLine, 100); // 200
+ * line.get_price(trendLine, -10); // 90: extended to the left too
  * ```
  */
 export function get_price(id: Line, x: number): number {
-  const { x1, y1, x2, y2, extend, xloc } = id;
-
-  // Only works with bar_index xloc
+  const { x1, y1, x2, y2, xloc } = id;
   if (xloc === 'bar_time') {
-    throw new Error('line.get_price() only works with xloc.bar_index lines, not xloc.bar_time');
-  }
-
-  // Avoid division by zero
-  if (x2 === x1) {
-    // Vertical line - return NaN or could return y1/y2
-    return NaN;
+    throw new Error("'line.get_price' must be used with lines created using 'xloc=xloc.bar_index'.");
   }
-
-  // Linear interpolation formula: y = y1 + (y2 - y1) * (x - x1) / (x2 - x1)
-  const slope = (y2 - y1) / (x2 - x1);
-  const price = y1 + slope * (x - x1);
-
-  // Check bounds based on extend mode
-  if (extend === 'none') {
-    // Only valid within the segment
-    if (x < Math.min(x1, x2) || x > Math.max(x1, x2)) {
-      return NaN;
-    }
-  } else if (extend === 'left') {
-    // Valid to the left and within, but not to the right
-    if (x > Math.max(x1, x2)) {
-      return NaN;
-    }
-  } else if (extend === 'right') {
-    // Valid to the right and within, but not to the left
-    if (x < Math.min(x1, x2)) {
-      return NaN;
-    }
-  }
-  // extend === 'both': always valid
-
-  return price;
+  if (x2 === x1) return NaN;
+  return y1 + ((y2 - y1) * (x - x1)) / (x2 - x1);
 }
 
 /**
@@ -267,7 +219,7 @@ export function copy(id: Line): Line {
  */
 export function set_x1(id: Line, x: number): Line {
   if (isDeleted(id)) return id;
-  checkBarIndex('line.set_x***', 'x1', x, id.xloc);
+  x = checkBarIndex('line.set_x***', 'x1', x, id.xloc);
   id.x1 = x;
   return id;
 }
@@ -287,7 +239,7 @@ export function set_x1(id: Line, x: number): Line {
  */
 export function set_x2(id: Line, x: number): Line {
   if (isDeleted(id)) return id;
-  checkBarIndex('line.set_x***', 'x2', x, id.xloc);
+  x = checkBarIndex('line.set_x***', 'x2', x, id.xloc);
   id.x2 = x;
   return id;
 }
@@ -346,7 +298,7 @@ export function set_y2(id: Line, y: number): Line {
  */
 export function set_xy1(id: Line, x: number, y: number): Line {
   if (isDeleted(id)) return id;
-  checkBarIndex('line.set_x***', 'x1', x, id.xloc);
+  x = checkBarIndex('line.set_x***', 'x1', x, id.xloc);
   id.x1 = x;
   id.y1 = y;
   return id;
@@ -368,7 +320,7 @@ export function set_xy1(id: Line, x: number, y: number): Line {
  */
 export function set_xy2(id: Line, x: number, y: number): Line {
   if (isDeleted(id)) return id;
-  checkBarIndex('line.set_x***', 'x2', x, id.xloc);
+  x = checkBarIndex('line.set_x***', 'x2', x, id.xloc);
   id.x2 = x;
   id.y2 = y;
   return id;

package/src/linefill/index.ts

@@ -24,6 +24,9 @@ import type { Linefill, Line, color } from '../types/index.js';
  * @remarks
  * - Automatically follows line movements (if lines are updated, fill updates too)
  * - Automatically deleted if either line is deleted
+ * - One linefill per pair of lines, as in PineScript (#174): when both lines already belong to a live linefill
+ *   (`linefill.new(b, a)` after `linefill.new(a, b)`, or `linefill.new(a, a)` after either), that linefill is
+ *   returned with the new colour instead of a new one; with several, the one created or returned last
  * - If both lines extend in same direction, fill extends too
  * - Purely visual in PineScript, but getters allow retrieving line references
  *
@@ -42,13 +45,29 @@ import type { Linefill, Line, color } from '../types/index.js';
 export function new_linefill(line1: Line, line2: Line, fillColor?: color): Linefill {
   // PineScript: an na line gives an na linefill
   if (line1 === null || line1 === undefined || line2 === null || line2 === undefined) return null as unknown as Linefill;
-  return register('linefill', {
+  let found: Linefill | undefined;
+  for (const fill of allDrawings('linefill')) {
+    const has = (l: Line): boolean => fill.line1 === l || fill.line2 === l;
+    if (has(line1) && has(line2) && (!found || (touched.get(fill) ?? 0) > (touched.get(found) ?? 0))) found = fill;
+  }
+  if (found) {
+    found.color = fillColor;
+    touched.set(found, ++touchCount);
+    return found;
+  }
+  const fill = register('linefill', {
     line1,
     line2,
     color: fillColor
   });
+  touched.set(fill, ++touchCount);
+  return fill;
 }
 
+/** Order in which the linefills were created or returned by `linefill.new` (the last one wins a lookup). */
+const touched = new WeakMap<Linefill, number>();
+let touchCount = 0;
+
 /**
  * Returns the first line reference.
  *

package/src/runtime/adapters/SimpleInputAdapter.ts

@@ -70,7 +70,7 @@ export class SimpleInputAdapter implements InputAdapter {
 
     // Validate string, timeframe and session inputs with options
     if (
-      (config.type === 'string' || config.type === 'timeframe' || config.type === 'session') &&
+      (config.type === 'string' || config.type === 'timeframe' || config.type === 'session' || config.type === 'symbol') &&
       config.options &&
       typeof value === 'string'
     ) {

package/src/runtime/index.ts

@@ -27,6 +27,7 @@ export {
   input_source,
   input_timeframe,
   input_session,
+  input_symbol,
   input_time,
   enableAutoRecalculate,
   disableAutoRecalculate,

package/src/runtime/inputs.ts

@@ -277,6 +277,22 @@ export function input_session(defval: string, title?: string, options?: string[]
   return typeof value === 'string' ? value : defval;
 }
 
+/**
+ * Register a symbol input (PineScript `input.symbol`): a ticker id such as "NASDAQ:MSFT" (#180)
+ * First call registers with defval, subsequent calls return current value
+ * @param defval - Default ticker id
+ * @param title - Display title (optional)
+ * @param options - Array of symbols for a dropdown (optional)
+ * @returns Current ticker id
+ */
+export function input_symbol(defval: string, title?: string, options?: string[]): string {
+  if (!getContext()) {
+    return defval;
+  }
+  const value = registerOnce({ id: generateInputId(title, defval, 'symbol'), type: 'symbol', defval, title, options });
+  return typeof value === 'string' ? value : defval;
+}
+
 /**
  * Register a date/time input (PineScript `input.time`)
  * First call registers with defval, subsequent calls return current value

package/src/runtime/types.ts

@@ -72,7 +72,7 @@ export interface InputConfig {
    * Type of input. `timeframe` and `session` values are strings ("60", "1D", "0930-1600:23456";
    * an empty timeframe means the chart timeframe), `time` values are UNIX times in milliseconds.
    */
-  type: 'int' | 'float' | 'bool' | 'string' | 'source' | 'color' | 'timeframe' | 'session' | 'time';
+  type: 'int' | 'float' | 'bool' | 'string' | 'source' | 'color' | 'timeframe' | 'session' | 'time' | 'symbol';
   /** Default value */
   defval: unknown;
   /** Display title */