oakscriptjs 0.10.1 → 0.11.1

package/src/index.ts

@@ -43,6 +43,48 @@ export { taCore, math, array, map, str, color, time, timeframe, matrix, line, bo
 export { drawingOutputs, type DrawingOutputs } from './drawing/output.js';
 export { barInterval, barTime } from './drawing/bar-time.js';
 
+// Drawing registry limits (PineScript indicator(max_lines_count / max_labels_count / max_boxes_count / max_polylines_count))
+export {
+  resetDrawings,
+  setDrawingLimits,
+  setDrawingBar,
+  holdDrawing,
+  releaseDrawing,
+  varDrawing,
+  type DrawingLimits,
+  type DrawingVariable,
+} from './drawing/registry.js';
+
+// The session of a chart context without a script run: time(tf), time_close(tf), time_tradingday, session.* flags,
+// request.security periods with the session and holidays, and bars after the last bar on the trading calendar
+export {
+  chartSessions,
+  periodTime,
+  periodClose,
+  tradingDayTime,
+  chartSessionFlags,
+  resampleSession,
+  barTimeAfter,
+  barsUntil,
+  type SessionContext,
+  type ChartSessions,
+  type SessionResample,
+} from './session/context.js';
+export { TradingCalendar, type SessionSpec } from './session/calendar.js';
+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';
 export type { SeriesExtractor } from './runtime/series.js';
@@ -137,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';
@@ -172,7 +215,7 @@ export type { LightweightSeriesDefinitions } from './runtime/adapters/Lightweigh
 export { SimpleInputAdapter } from './runtime/adapters/SimpleInputAdapter.js';
 
 // Version
-export const VERSION = '0.10.1';
+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

@@ -10,7 +10,7 @@
  * @version 6
  */
 
-import { all as allDrawings, isDeleted, register, remove } from '../drawing/registry.js';
+import { all as allDrawings, checkBarIndex, isDeleted, register, remove } from '../drawing/registry.js';
 import type { ChartPoint, Label, color } from '../types/index.js';
 
 type LabelXloc = 'bar_index' | 'bar_time';
@@ -80,6 +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?,
   ];
+  x = checkBarIndex('label.new', 'x', x, xloc);
   return register('label', {
     x,
     y,
@@ -188,6 +189,7 @@ export function copy(id: Label): Label {
  */
 export function set_x(id: Label, x: number): Label {
   if (isDeleted(id)) return id;
+  x = checkBarIndex('label.set_x', 'x', x, id.xloc);
   id.x = x;
   return id;
 }
@@ -227,6 +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;
+  x = checkBarIndex('label.set_x', 'x', x, id.xloc);
   id.x = x;
   id.y = y;
   return id;

package/src/line/index.ts

@@ -10,7 +10,7 @@
  * @version 6
  */
 
-import { all as allDrawings, isDeleted, register, remove } from '../drawing/registry.js';
+import { all as allDrawings, checkBarIndex, isDeleted, register, remove } from '../drawing/registry.js';
 import type { ChartPoint, Line, color } from '../types/index.js';
 
 type LineXloc = 'bar_index' | 'bar_time';
@@ -70,6 +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?,
   ];
+  x1 = checkBarIndex('line.new', 'x1', x1, xloc);
+  x2 = checkBarIndex('line.new', 'x2', x2, xloc);
   return register('line', {
     x1,
     y1,
@@ -79,89 +81,41 @@ export function new_line(...args: unknown[]): Line {
     extend: extend ?? 'none',
     color: lineColor,
     style: style || 'solid',
-    width: width || 1,
+    width: width ?? 1,
     force_overlay: force_overlay ?? false,
   });
 }
 
 /**
- * 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);
 }
 
 /**
@@ -265,6 +219,7 @@ export function copy(id: Line): Line {
  */
 export function set_x1(id: Line, x: number): Line {
   if (isDeleted(id)) return id;
+  x = checkBarIndex('line.set_x***', 'x1', x, id.xloc);
   id.x1 = x;
   return id;
 }
@@ -284,6 +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;
+  x = checkBarIndex('line.set_x***', 'x2', x, id.xloc);
   id.x2 = x;
   return id;
 }
@@ -342,6 +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;
+  x = checkBarIndex('line.set_x***', 'x1', x, id.xloc);
   id.x1 = x;
   id.y1 = y;
   return id;
@@ -363,6 +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;
+  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/math/index.ts

@@ -19,6 +19,7 @@
 import type { float, int, simple_int, series_float } from '../types/index.js';
 import { Series } from '../runtime/series.js';
 import { runningSum, runningSumSeries } from '../ta/running-sum.js';
+import { checkSumLength } from '../ta/limits.js';
 
 /**
  * Returns the absolute value of a number.
@@ -489,6 +490,7 @@ export function sum(
 ): series_float | Series {
   // Handle Series objects - extract to array first
   const sourceArray = source instanceof Series ? source.toArray() : source;
+  if (typeof length === 'number') checkSumLength('math.sum', length, 0);
   // PineScript: the sum of the last `length` non-na values (also +/-Infinity skipped); an na bar keeps the previous
   // result. A compensated running sum, bit for bit as PineScript.
   const result: series_float =

package/src/polyline/index.ts

@@ -11,7 +11,7 @@
  */
 
 import type { ChartPoint, Polyline, color } from '../types/index.js';
-import { all as allDrawings, register, remove } from '../drawing/registry.js';
+import { all as allDrawings, checkBarIndex, register, remove } from '../drawing/registry.js';
 
 // Re-export the Polyline type for convenience
 export type { Polyline };
@@ -86,6 +86,8 @@ export function new_polyline(
     line_width = 1;
   }
 
+  if (xloc === 'bar_index') for (const point of points) if (point.index !== null) checkBarIndex('polyline.new', 'points', point.index, xloc);
+
   const polyline: Polyline = {
     id: generateId(),
     points: [...points], // Create a copy of the points array

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 */