oakscriptjs 0.8.1 → 0.9.0

package/dist/cjs/line/index.d.ts

@@ -0,0 +1,342 @@
+/**
+ * Line namespace
+ * Functions for creating and manipulating line drawing objects.
+ *
+ * @remarks
+ * While lines are primarily visual in PineScript, the line.get_price() function provides
+ * computational value for algorithmic trading - calculating trend line breakouts,
+ * support/resistance levels, and pattern recognition.
+ *
+ * @version 6
+ */
+import type { ChartPoint, Line, color } from '../types/index.js';
+type LineXloc = 'bar_index' | 'bar_time';
+type LineExtend = 'none' | 'left' | 'right' | 'both';
+type LineStyle = 'solid' | 'dotted' | 'dashed' | 'arrow_left' | 'arrow_right' | 'arrow_both';
+/**
+ * Creates a new line (PineScript `line.new`), with two chart points or with coordinates:
+ *
+ * - `line.new(first_point, second_point, xloc?, extend?, color?, style?, width?, force_overlay?)`
+ * - `line.new(x1, y1, x2, y2, xloc?, extend?, color?, style?, width?, force_overlay?)`
+ *
+ * With chart points, x is `point.index` for `bar_index` lines and `point.time` for `bar_time` lines.
+ *
+ * @example
+ * ```typescript
+ * // Create a trend line from bar 0 (price 100) to bar 50 (price 150)
+ * const trendLine = line.new(0, 100, 50, 150, 'bar_index', 'right');
+ * const fromPoints = line.new(chartPoint.from_index(0, 100), chartPoint.from_index(50, 150));
+ *
+ * // Calculate price at bar 75 (extrapolated)
+ * const price = line.get_price(trendLine, 75); // Returns 175
+ * ```
+ */
+export declare function new_line(first_point: ChartPoint, second_point: ChartPoint, xloc?: LineXloc, extend?: LineExtend, lineColor?: color, style?: LineStyle, width?: number, force_overlay?: boolean): Line;
+export declare function new_line(x1: number, y1: number, x2: number, y2: number, xloc?: LineXloc, extend?: LineExtend, lineColor?: color, style?: LineStyle, width?: number, force_overlay?: boolean): Line;
+/**
+ * Returns the price level of a line at a given bar index.
+ *
+ * @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
+ *
+ * @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
+ *
+ * @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!');
+ * }
+ * ```
+ */
+export declare function get_price(id: Line, x: number): number;
+/**
+ * Returns the first point's x coordinate.
+ *
+ * @param id - Line object
+ * @returns X coordinate of the first point
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(10, 100, 50, 150);
+ * const x1 = line.get_x1(line); // Returns 10
+ * ```
+ */
+export declare function get_x1(id: Line): number;
+/**
+ * Returns the second point's x coordinate.
+ *
+ * @param id - Line object
+ * @returns X coordinate of the second point
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(10, 100, 50, 150);
+ * const x2 = line.get_x2(line); // Returns 50
+ * ```
+ */
+export declare function get_x2(id: Line): number;
+/**
+ * Returns the first point's y coordinate (price level).
+ *
+ * @param id - Line object
+ * @returns Y coordinate (price) of the first point
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(10, 100, 50, 150);
+ * const y1 = line.get_y1(line); // Returns 100
+ * ```
+ */
+export declare function get_y1(id: Line): number;
+/**
+ * Returns the second point's y coordinate (price level).
+ *
+ * @param id - Line object
+ * @returns Y coordinate (price) of the second point
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(10, 100, 50, 150);
+ * const y2 = line.get_y2(line); // Returns 150
+ * ```
+ */
+export declare function get_y2(id: Line): number;
+/**
+ * Creates a copy of the line object.
+ *
+ * @param id - Line object to copy
+ * @returns New line object with same properties
+ *
+ * @remarks
+ * Creates a shallow copy of the line. Modifications to the copy won't affect the original.
+ *
+ * @example
+ * ```typescript
+ * const originalLine = line.new(0, 100, 50, 150);
+ * const copiedLine = line.copy(originalLine);
+ *
+ * // Modify copy without affecting original
+ * copiedLine.y2 = 200;
+ * ```
+ */
+export declare function copy(id: Line): Line;
+/**
+ * Sets the first point's x coordinate.
+ *
+ * @param id - Line object to modify
+ * @param x - New x coordinate (bar index or timestamp)
+ * @returns Modified line object
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(0, 100, 50, 150);
+ * line.set_x1(line, 10); // Move first point to bar 10
+ * ```
+ */
+export declare function set_x1(id: Line, x: number): Line;
+/**
+ * Sets the second point's x coordinate.
+ *
+ * @param id - Line object to modify
+ * @param x - New x coordinate (bar index or timestamp)
+ * @returns Modified line object
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(0, 100, 50, 150);
+ * line.set_x2(line, 60); // Move second point to bar 60
+ * ```
+ */
+export declare function set_x2(id: Line, x: number): Line;
+/**
+ * Sets the first point's y coordinate (price level).
+ *
+ * @param id - Line object to modify
+ * @param y - New y coordinate (price)
+ * @returns Modified line object
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(0, 100, 50, 150);
+ * line.set_y1(line, 110); // Move first point to price 110
+ * ```
+ */
+export declare function set_y1(id: Line, y: number): Line;
+/**
+ * Sets the second point's y coordinate (price level).
+ *
+ * @param id - Line object to modify
+ * @param y - New y coordinate (price)
+ * @returns Modified line object
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(0, 100, 50, 150);
+ * line.set_y2(line, 160); // Move second point to price 160
+ * ```
+ */
+export declare function set_y2(id: Line, y: number): Line;
+/**
+ * Sets both coordinates of the first point.
+ *
+ * @param id - Line object to modify
+ * @param x - New x coordinate
+ * @param y - New y coordinate
+ * @returns Modified line object
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(0, 100, 50, 150);
+ * line.set_xy1(line, 5, 105); // Move first point to (5, 105)
+ * ```
+ */
+export declare function set_xy1(id: Line, x: number, y: number): Line;
+/**
+ * Sets both coordinates of the second point.
+ *
+ * @param id - Line object to modify
+ * @param x - New x coordinate
+ * @param y - New y coordinate
+ * @returns Modified line object
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(0, 100, 50, 150);
+ * line.set_xy2(line, 60, 160); // Move second point to (60, 160)
+ * ```
+ */
+export declare function set_xy2(id: Line, x: number, y: number): Line;
+/**
+ * Sets the coordinate system for the line.
+ *
+ * @param id - Line object to modify
+ * @param x1 - New first point x coordinate
+ * @param x2 - New second point x coordinate
+ * @param xloc - New coordinate system ('bar_index' or 'bar_time')
+ * @returns Modified line object
+ *
+ * @remarks
+ * When changing xloc, you must provide appropriate x coordinates for the new system.
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(0, 100, 50, 150);
+ * // Change to timestamp-based coordinates
+ * line.set_xloc(line, 1609459200000, 1609545600000, 'bar_time');
+ * ```
+ */
+export declare function set_xloc(id: Line, x1: number, x2: number, xloc: 'bar_index' | 'bar_time'): Line;
+/**
+ * Sets the extension mode of the line.
+ *
+ * @param id - Line object to modify
+ * @param extend - New extension mode
+ * @returns Modified line object
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(0, 100, 50, 150);
+ * line.set_extend(line, 'right'); // Extend line to the right
+ * ```
+ */
+export declare function set_extend(id: Line, extend: 'none' | 'left' | 'right' | 'both'): Line;
+/**
+ * Sets the line color.
+ *
+ * @param id - Line object to modify
+ * @param color - New line color
+ * @returns Modified line object
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(0, 100, 50, 150);
+ * line.set_color(line, '#FF0000'); // Change to red
+ * ```
+ */
+export declare function set_color(id: Line, lineColor: color): Line;
+/**
+ * Sets the line style.
+ *
+ * @param id - Line object to modify
+ * @param style - New line style
+ * @returns Modified line object
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(0, 100, 50, 150);
+ * line.set_style(line, 'dashed'); // Change to dashed line
+ * ```
+ */
+export declare function set_style(id: Line, style: 'solid' | 'dotted' | 'dashed' | 'arrow_left' | 'arrow_right' | 'arrow_both'): Line;
+/**
+ * Sets the line width.
+ *
+ * @param id - Line object to modify
+ * @param width - New line width in pixels
+ * @returns Modified line object
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(0, 100, 50, 150);
+ * line.set_width(line, 3); // Make line thicker
+ * ```
+ */
+export declare function set_width(id: Line, width: number): Line;
+/**
+ * Deletes the line object.
+ *
+ * @param id - Line object to delete
+ *
+ * @remarks
+ * Removes the line from `line.all()`. As in PineScript, the deleted line is `na`: its getters
+ * return NaN and its setters do nothing. Deleting it twice has no effect. Deleting a line also deletes the linefills that use it.
+ *
+ * @example
+ * ```typescript
+ * const line = line.new(0, 100, 50, 150);
+ * line.delete(line);
+ * // line.all() no longer contains it
+ * ```
+ */
+export declare function delete_line(id: Line): void;
+/**
+ * All live lines, in creation order (PineScript `line.all`). A new array: later changes do not affect it.
+ */
+export declare function all(): Line[];
+/**
+ * Sets the first point of the line from a chart point: `point.index` for `bar_index` lines,
+ * `point.time` for `bar_time` lines (`na` when the point does not have it), and `point.price`.
+ */
+export declare function set_first_point(id: Line, point: ChartPoint): Line;
+/**
+ * Sets the second point of the line from a chart point (see {@link set_first_point}).
+ */
+export declare function set_second_point(id: Line, point: ChartPoint): Line;
+export { new_line as new };
+export { delete_line as delete };
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/line/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/line/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEjE,KAAK,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AACzC,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AACrD,KAAK,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;AAE7F;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,UAAU,EACvB,YAAY,EAAE,UAAU,EACxB,IAAI,CAAC,EAAE,QAAQ,EACf,MAAM,CAAC,EAAE,UAAU,EACnB,SAAS,CAAC,EAAE,KAAK,EACjB,KAAK,CAAC,EAAE,SAAS,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,OAAO,GACtB,IAAI,CAAC;AACR,wBAAgB,QAAQ,CACtB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE,QAAQ,EACf,MAAM,CAAC,EAAE,UAAU,EACnB,SAAS,CAAC,EAAE,KAAK,EACjB,KAAK,CAAC,EAAE,SAAS,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,OAAO,GACtB,IAAI,CAAC;AA4BR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAsCrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,MAAM,CAEvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,MAAM,CAEvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,MAAM,CAEvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,MAAM,CAEvC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,CAEnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAK5D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAK5D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI,CAM/F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAIrF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAI1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,GAAG,IAAI,CAI5H;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIvD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,CAE1C;AAQD;;GAEG;AACH,wBAAgB,GAAG,IAAI,IAAI,EAAE,CAE5B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAKjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAKlE;AAGD,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,CAAC;AAC3B,OAAO,EAAE,WAAW,IAAI,MAAM,EAAE,CAAC"}

package/dist/cjs/line/index.js

@@ -0,0 +1,193 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all2) => {
+  for (var name in all2)
+    __defProp(target, name, { get: all2[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var line_exports = {};
+__export(line_exports, {
+  all: () => all,
+  copy: () => copy,
+  delete: () => delete_line,
+  delete_line: () => delete_line,
+  get_price: () => get_price,
+  get_x1: () => get_x1,
+  get_x2: () => get_x2,
+  get_y1: () => get_y1,
+  get_y2: () => get_y2,
+  new: () => new_line,
+  new_line: () => new_line,
+  set_color: () => set_color,
+  set_extend: () => set_extend,
+  set_first_point: () => set_first_point,
+  set_second_point: () => set_second_point,
+  set_style: () => set_style,
+  set_width: () => set_width,
+  set_x1: () => set_x1,
+  set_x2: () => set_x2,
+  set_xloc: () => set_xloc,
+  set_xy1: () => set_xy1,
+  set_xy2: () => set_xy2,
+  set_y1: () => set_y1,
+  set_y2: () => set_y2
+});
+module.exports = __toCommonJS(line_exports);
+var import_registry = require("../drawing/registry.js");
+function new_line(...args) {
+  let x1, y1, x2, y2, rest;
+  if (typeof args[0] === "object" && args[0] !== null) {
+    const [p1, p2, ...others] = args;
+    const xloc2 = others[0] ?? "bar_index";
+    [x1, y1, x2, y2, rest] = [pointX(p1, xloc2), p1.price, pointX(p2, xloc2), p2.price, others];
+  } else {
+    [x1, y1, x2, y2] = args;
+    rest = args.slice(4);
+  }
+  const [xloc, extend, lineColor, style, width, force_overlay] = rest;
+  return (0, import_registry.register)("line", {
+    x1,
+    y1,
+    x2,
+    y2,
+    xloc: xloc ?? "bar_index",
+    extend: extend ?? "none",
+    color: lineColor,
+    style: style || "solid",
+    width: width || 1,
+    force_overlay: force_overlay ?? false
+  });
+}
+function get_price(id, x) {
+  const { x1, y1, x2, y2, extend, xloc } = id;
+  if (xloc === "bar_time") {
+    throw new Error("line.get_price() only works with xloc.bar_index lines, not xloc.bar_time");
+  }
+  if (x2 === x1) {
+    return NaN;
+  }
+  const slope = (y2 - y1) / (x2 - x1);
+  const price = y1 + slope * (x - x1);
+  if (extend === "none") {
+    if (x < Math.min(x1, x2) || x > Math.max(x1, x2)) {
+      return NaN;
+    }
+  } else if (extend === "left") {
+    if (x > Math.max(x1, x2)) {
+      return NaN;
+    }
+  } else if (extend === "right") {
+    if (x < Math.min(x1, x2)) {
+      return NaN;
+    }
+  }
+  return price;
+}
+function get_x1(id) {
+  return id.x1;
+}
+function get_x2(id) {
+  return id.x2;
+}
+function get_y1(id) {
+  return id.y1;
+}
+function get_y2(id) {
+  return id.y2;
+}
+function copy(id) {
+  return (0, import_registry.register)("line", { ...id });
+}
+function set_x1(id, x) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.x1 = x;
+  return id;
+}
+function set_x2(id, x) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.x2 = x;
+  return id;
+}
+function set_y1(id, y) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.y1 = y;
+  return id;
+}
+function set_y2(id, y) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.y2 = y;
+  return id;
+}
+function set_xy1(id, x, y) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.x1 = x;
+  id.y1 = y;
+  return id;
+}
+function set_xy2(id, x, y) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.x2 = x;
+  id.y2 = y;
+  return id;
+}
+function set_xloc(id, x1, x2, xloc) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.x1 = x1;
+  id.x2 = x2;
+  id.xloc = xloc;
+  return id;
+}
+function set_extend(id, extend) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.extend = extend;
+  return id;
+}
+function set_color(id, lineColor) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.color = lineColor;
+  return id;
+}
+function set_style(id, style) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.style = style;
+  return id;
+}
+function set_width(id, width) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.width = width;
+  return id;
+}
+function delete_line(id) {
+  (0, import_registry.remove)("line", id);
+}
+function pointX(point, xloc) {
+  const x = xloc === "bar_time" ? point.time : point.index;
+  return x ?? NaN;
+}
+function all() {
+  return (0, import_registry.all)("line");
+}
+function set_first_point(id, point) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.x1 = pointX(point, id.xloc);
+  id.y1 = point.price;
+  return id;
+}
+function set_second_point(id, point) {
+  if ((0, import_registry.isDeleted)(id)) return id;
+  id.x2 = pointX(point, id.xloc);
+  id.y2 = point.price;
+  return id;
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/line/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/line/index.ts"],
+  "sourcesContent": ["/**\n * Line namespace\n * Functions for creating and manipulating line drawing objects.\n *\n * @remarks\n * While lines are primarily visual in PineScript, the line.get_price() function provides\n * computational value for algorithmic trading - calculating trend line breakouts,\n * support/resistance levels, and pattern recognition.\n *\n * @version 6\n */\n\nimport { all as allDrawings, isDeleted, register, remove } from '../drawing/registry.js';\nimport type { ChartPoint, Line, color } from '../types/index.js';\n\ntype LineXloc = 'bar_index' | 'bar_time';\ntype LineExtend = 'none' | 'left' | 'right' | 'both';\ntype LineStyle = 'solid' | 'dotted' | 'dashed' | 'arrow_left' | 'arrow_right' | 'arrow_both';\n\n/**\n * Creates a new line (PineScript `line.new`), with two chart points or with coordinates:\n *\n * - `line.new(first_point, second_point, xloc?, extend?, color?, style?, width?, force_overlay?)`\n * - `line.new(x1, y1, x2, y2, xloc?, extend?, color?, style?, width?, force_overlay?)`\n *\n * With chart points, x is `point.index` for `bar_index` lines and `point.time` for `bar_time` lines.\n *\n * @example\n * ```typescript\n * // Create a trend line from bar 0 (price 100) to bar 50 (price 150)\n * const trendLine = line.new(0, 100, 50, 150, 'bar_index', 'right');\n * const fromPoints = line.new(chartPoint.from_index(0, 100), chartPoint.from_index(50, 150));\n *\n * // Calculate price at bar 75 (extrapolated)\n * const price = line.get_price(trendLine, 75); // Returns 175\n * ```\n */\nexport function new_line(\n  first_point: ChartPoint,\n  second_point: ChartPoint,\n  xloc?: LineXloc,\n  extend?: LineExtend,\n  lineColor?: color,\n  style?: LineStyle,\n  width?: number,\n  force_overlay?: boolean\n): Line;\nexport function new_line(\n  x1: number,\n  y1: number,\n  x2: number,\n  y2: number,\n  xloc?: LineXloc,\n  extend?: LineExtend,\n  lineColor?: color,\n  style?: LineStyle,\n  width?: number,\n  force_overlay?: boolean\n): Line;\nexport function new_line(...args: unknown[]): Line {\n  let x1: number, y1: number, x2: number, y2: number, rest: unknown[];\n  if (typeof args[0] === 'object' && args[0] !== null) {\n    const [p1, p2, ...others] = args as [ChartPoint, ChartPoint, ...unknown[]];\n    const xloc = (others[0] as LineXloc | undefined) ?? 'bar_index';\n    [x1, y1, x2, y2, rest] = [pointX(p1, xloc), p1.price, pointX(p2, xloc), p2.price, others];\n  } else {\n    [x1, y1, x2, y2] = args as [number, number, number, number];\n    rest = args.slice(4);\n  }\n  const [xloc, extend, lineColor, style, width, force_overlay] = rest as [\n    LineXloc?, LineExtend?, color?, LineStyle?, number?, boolean?,\n  ];\n  return register('line', {\n    x1,\n    y1,\n    x2,\n    y2,\n    xloc: xloc ?? 'bar_index',\n    extend: extend ?? 'none',\n    color: lineColor,\n    style: style || 'solid',\n    width: width || 1,\n    force_overlay: force_overlay ?? false,\n  });\n}\n\n/**\n * Returns the price level of a line at a given bar index.\n *\n * @param id - Line object\n * @param x - Bar index to calculate price at\n * @returns Price level at the given bar index, or NaN if outside bounds and not extended\n *\n * @remarks\n * - **CRITICAL COMPUTATIONAL FUNCTION** - Enables trend line breakout detection\n * - Uses linear interpolation: y = y1 + (y2 - y1) * (x - x1) / (x2 - x1)\n * - Respects extend mode:\n *   - 'none': Returns NaN if x is outside [x1, x2]\n *   - 'left': Extends infinitely to the left (x < x1)\n *   - 'right': Extends infinitely to the right (x > x2)\n *   - 'both': Extends infinitely in both directions\n * - Only works with xloc='bar_index' lines (not xloc='bar_time')\n * - In PineScript, this function treats all lines as if extend='both' regardless of actual setting\n *   For compatibility, we follow the actual extend setting\n *\n * @example\n * ```typescript\n * const trendLine = line.new(0, 100, 50, 150, 'bar_index', 'right');\n *\n * // Within segment\n * line.get_price(trendLine, 25);  // Returns 125\n *\n * // Extended right\n * line.get_price(trendLine, 100); // Returns 200\n *\n * // Not extended left (with extend='right')\n * line.get_price(trendLine, -10); // Returns NaN\n *\n * // Use for breakout detection\n * const currentPrice = close[close.length - 1];\n * const linePrice = line.get_price(trendLine, close.length - 1);\n * if (currentPrice > linePrice) {\n *   console.log('Breakout above trend line!');\n * }\n * ```\n */\nexport function get_price(id: Line, x: number): number {\n  const { x1, y1, x2, y2, extend, xloc } = id;\n\n  // Only works with bar_index xloc\n  if (xloc === 'bar_time') {\n    throw new Error('line.get_price() only works with xloc.bar_index lines, not xloc.bar_time');\n  }\n\n  // Avoid division by zero\n  if (x2 === x1) {\n    // Vertical line - return NaN or could return y1/y2\n    return NaN;\n  }\n\n  // Linear interpolation formula: y = y1 + (y2 - y1) * (x - x1) / (x2 - x1)\n  const slope = (y2 - y1) / (x2 - x1);\n  const price = y1 + slope * (x - x1);\n\n  // Check bounds based on extend mode\n  if (extend === 'none') {\n    // Only valid within the segment\n    if (x < Math.min(x1, x2) || x > Math.max(x1, x2)) {\n      return NaN;\n    }\n  } else if (extend === 'left') {\n    // Valid to the left and within, but not to the right\n    if (x > Math.max(x1, x2)) {\n      return NaN;\n    }\n  } else if (extend === 'right') {\n    // Valid to the right and within, but not to the left\n    if (x < Math.min(x1, x2)) {\n      return NaN;\n    }\n  }\n  // extend === 'both': always valid\n\n  return price;\n}\n\n/**\n * Returns the first point's x coordinate.\n *\n * @param id - Line object\n * @returns X coordinate of the first point\n *\n * @example\n * ```typescript\n * const line = line.new(10, 100, 50, 150);\n * const x1 = line.get_x1(line); // Returns 10\n * ```\n */\nexport function get_x1(id: Line): number {\n  return id.x1;\n}\n\n/**\n * Returns the second point's x coordinate.\n *\n * @param id - Line object\n * @returns X coordinate of the second point\n *\n * @example\n * ```typescript\n * const line = line.new(10, 100, 50, 150);\n * const x2 = line.get_x2(line); // Returns 50\n * ```\n */\nexport function get_x2(id: Line): number {\n  return id.x2;\n}\n\n/**\n * Returns the first point's y coordinate (price level).\n *\n * @param id - Line object\n * @returns Y coordinate (price) of the first point\n *\n * @example\n * ```typescript\n * const line = line.new(10, 100, 50, 150);\n * const y1 = line.get_y1(line); // Returns 100\n * ```\n */\nexport function get_y1(id: Line): number {\n  return id.y1;\n}\n\n/**\n * Returns the second point's y coordinate (price level).\n *\n * @param id - Line object\n * @returns Y coordinate (price) of the second point\n *\n * @example\n * ```typescript\n * const line = line.new(10, 100, 50, 150);\n * const y2 = line.get_y2(line); // Returns 150\n * ```\n */\nexport function get_y2(id: Line): number {\n  return id.y2;\n}\n\n/**\n * Creates a copy of the line object.\n *\n * @param id - Line object to copy\n * @returns New line object with same properties\n *\n * @remarks\n * Creates a shallow copy of the line. Modifications to the copy won't affect the original.\n *\n * @example\n * ```typescript\n * const originalLine = line.new(0, 100, 50, 150);\n * const copiedLine = line.copy(originalLine);\n *\n * // Modify copy without affecting original\n * copiedLine.y2 = 200;\n * ```\n */\nexport function copy(id: Line): Line {\n  return register('line', { ...id });\n}\n\n/**\n * Sets the first point's x coordinate.\n *\n * @param id - Line object to modify\n * @param x - New x coordinate (bar index or timestamp)\n * @returns Modified line object\n *\n * @example\n * ```typescript\n * const line = line.new(0, 100, 50, 150);\n * line.set_x1(line, 10); // Move first point to bar 10\n * ```\n */\nexport function set_x1(id: Line, x: number): Line {\n  if (isDeleted(id)) return id;\n  id.x1 = x;\n  return id;\n}\n\n/**\n * Sets the second point's x coordinate.\n *\n * @param id - Line object to modify\n * @param x - New x coordinate (bar index or timestamp)\n * @returns Modified line object\n *\n * @example\n * ```typescript\n * const line = line.new(0, 100, 50, 150);\n * line.set_x2(line, 60); // Move second point to bar 60\n * ```\n */\nexport function set_x2(id: Line, x: number): Line {\n  if (isDeleted(id)) return id;\n  id.x2 = x;\n  return id;\n}\n\n/**\n * Sets the first point's y coordinate (price level).\n *\n * @param id - Line object to modify\n * @param y - New y coordinate (price)\n * @returns Modified line object\n *\n * @example\n * ```typescript\n * const line = line.new(0, 100, 50, 150);\n * line.set_y1(line, 110); // Move first point to price 110\n * ```\n */\nexport function set_y1(id: Line, y: number): Line {\n  if (isDeleted(id)) return id;\n  id.y1 = y;\n  return id;\n}\n\n/**\n * Sets the second point's y coordinate (price level).\n *\n * @param id - Line object to modify\n * @param y - New y coordinate (price)\n * @returns Modified line object\n *\n * @example\n * ```typescript\n * const line = line.new(0, 100, 50, 150);\n * line.set_y2(line, 160); // Move second point to price 160\n * ```\n */\nexport function set_y2(id: Line, y: number): Line {\n  if (isDeleted(id)) return id;\n  id.y2 = y;\n  return id;\n}\n\n/**\n * Sets both coordinates of the first point.\n *\n * @param id - Line object to modify\n * @param x - New x coordinate\n * @param y - New y coordinate\n * @returns Modified line object\n *\n * @example\n * ```typescript\n * const line = line.new(0, 100, 50, 150);\n * line.set_xy1(line, 5, 105); // Move first point to (5, 105)\n * ```\n */\nexport function set_xy1(id: Line, x: number, y: number): Line {\n  if (isDeleted(id)) return id;\n  id.x1 = x;\n  id.y1 = y;\n  return id;\n}\n\n/**\n * Sets both coordinates of the second point.\n *\n * @param id - Line object to modify\n * @param x - New x coordinate\n * @param y - New y coordinate\n * @returns Modified line object\n *\n * @example\n * ```typescript\n * const line = line.new(0, 100, 50, 150);\n * line.set_xy2(line, 60, 160); // Move second point to (60, 160)\n * ```\n */\nexport function set_xy2(id: Line, x: number, y: number): Line {\n  if (isDeleted(id)) return id;\n  id.x2 = x;\n  id.y2 = y;\n  return id;\n}\n\n/**\n * Sets the coordinate system for the line.\n *\n * @param id - Line object to modify\n * @param x1 - New first point x coordinate\n * @param x2 - New second point x coordinate\n * @param xloc - New coordinate system ('bar_index' or 'bar_time')\n * @returns Modified line object\n *\n * @remarks\n * When changing xloc, you must provide appropriate x coordinates for the new system.\n *\n * @example\n * ```typescript\n * const line = line.new(0, 100, 50, 150);\n * // Change to timestamp-based coordinates\n * line.set_xloc(line, 1609459200000, 1609545600000, 'bar_time');\n * ```\n */\nexport function set_xloc(id: Line, x1: number, x2: number, xloc: 'bar_index' | 'bar_time'): Line {\n  if (isDeleted(id)) return id;\n  id.x1 = x1;\n  id.x2 = x2;\n  id.xloc = xloc;\n  return id;\n}\n\n/**\n * Sets the extension mode of the line.\n *\n * @param id - Line object to modify\n * @param extend - New extension mode\n * @returns Modified line object\n *\n * @example\n * ```typescript\n * const line = line.new(0, 100, 50, 150);\n * line.set_extend(line, 'right'); // Extend line to the right\n * ```\n */\nexport function set_extend(id: Line, extend: 'none' | 'left' | 'right' | 'both'): Line {\n  if (isDeleted(id)) return id;\n  id.extend = extend;\n  return id;\n}\n\n/**\n * Sets the line color.\n *\n * @param id - Line object to modify\n * @param color - New line color\n * @returns Modified line object\n *\n * @example\n * ```typescript\n * const line = line.new(0, 100, 50, 150);\n * line.set_color(line, '#FF0000'); // Change to red\n * ```\n */\nexport function set_color(id: Line, lineColor: color): Line {\n  if (isDeleted(id)) return id;\n  id.color = lineColor;\n  return id;\n}\n\n/**\n * Sets the line style.\n *\n * @param id - Line object to modify\n * @param style - New line style\n * @returns Modified line object\n *\n * @example\n * ```typescript\n * const line = line.new(0, 100, 50, 150);\n * line.set_style(line, 'dashed'); // Change to dashed line\n * ```\n */\nexport function set_style(id: Line, style: 'solid' | 'dotted' | 'dashed' | 'arrow_left' | 'arrow_right' | 'arrow_both'): Line {\n  if (isDeleted(id)) return id;\n  id.style = style;\n  return id;\n}\n\n/**\n * Sets the line width.\n *\n * @param id - Line object to modify\n * @param width - New line width in pixels\n * @returns Modified line object\n *\n * @example\n * ```typescript\n * const line = line.new(0, 100, 50, 150);\n * line.set_width(line, 3); // Make line thicker\n * ```\n */\nexport function set_width(id: Line, width: number): Line {\n  if (isDeleted(id)) return id;\n  id.width = width;\n  return id;\n}\n\n/**\n * Deletes the line object.\n *\n * @param id - Line object to delete\n *\n * @remarks\n * Removes the line from `line.all()`. As in PineScript, the deleted line is `na`: its getters\n * return NaN and its setters do nothing. Deleting it twice has no effect. Deleting a line also deletes the linefills that use it.\n *\n * @example\n * ```typescript\n * const line = line.new(0, 100, 50, 150);\n * line.delete(line);\n * // line.all() no longer contains it\n * ```\n */\nexport function delete_line(id: Line): void {\n  remove('line', id);\n}\n\n/** x coordinate of a chart point for an object's xloc (`na` when the point has no such coordinate). */\nfunction pointX(point: ChartPoint, xloc: 'bar_index' | 'bar_time'): number {\n  const x = xloc === 'bar_time' ? point.time : point.index;\n  return x ?? NaN;\n}\n\n/**\n * All live lines, in creation order (PineScript `line.all`). A new array: later changes do not affect it.\n */\nexport function all(): Line[] {\n  return allDrawings('line');\n}\n\n/**\n * Sets the first point of the line from a chart point: `point.index` for `bar_index` lines,\n * `point.time` for `bar_time` lines (`na` when the point does not have it), and `point.price`.\n */\nexport function set_first_point(id: Line, point: ChartPoint): Line {\n  if (isDeleted(id)) return id;\n  id.x1 = pointX(point, id.xloc);\n  id.y1 = point.price;\n  return id;\n}\n\n/**\n * Sets the second point of the line from a chart point (see {@link set_first_point}).\n */\nexport function set_second_point(id: Line, point: ChartPoint): Line {\n  if (isDeleted(id)) return id;\n  id.x2 = pointX(point, id.xloc);\n  id.y2 = point.price;\n  return id;\n}\n\n// Alias to match PineScript API\nexport { new_line as new };\nexport { delete_line as delete };\n"],
+  "mappings": "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",
+  "names": ["xloc", "allDrawings"]
+}