oakscriptjs 0.8.1 → 0.9.0

package/dist/esm/line/index.js

@@ -0,0 +1,470 @@
+/**
+ * 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 { all as allDrawings, isDeleted, register, remove } from '../drawing/registry.js';
+export function new_line(...args) {
+    let x1, y1, x2, y2, rest;
+    if (typeof args[0] === 'object' && args[0] !== null) {
+        const [p1, p2, ...others] = args;
+        const xloc = others[0] ?? 'bar_index';
+        [x1, y1, x2, y2, rest] = [pointX(p1, xloc), p1.price, pointX(p2, xloc), p2.price, others];
+    }
+    else {
+        [x1, y1, x2, y2] = args;
+        rest = args.slice(4);
+    }
+    const [xloc, extend, lineColor, style, width, force_overlay] = rest;
+    return 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,
+    });
+}
+/**
+ * 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 function get_price(id, x) {
+    const { x1, y1, x2, y2, extend, xloc } = id;
+    // Only works with bar_index xloc
+    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;
+    }
+    // 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;
+}
+/**
+ * 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 function get_x1(id) {
+    return id.x1;
+}
+/**
+ * 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 function get_x2(id) {
+    return id.x2;
+}
+/**
+ * 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 function get_y1(id) {
+    return id.y1;
+}
+/**
+ * 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 function get_y2(id) {
+    return id.y2;
+}
+/**
+ * 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 function copy(id) {
+    return register('line', { ...id });
+}
+/**
+ * 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 function set_x1(id, x) {
+    if (isDeleted(id))
+        return id;
+    id.x1 = x;
+    return id;
+}
+/**
+ * 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 function set_x2(id, x) {
+    if (isDeleted(id))
+        return id;
+    id.x2 = x;
+    return id;
+}
+/**
+ * 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 function set_y1(id, y) {
+    if (isDeleted(id))
+        return id;
+    id.y1 = y;
+    return id;
+}
+/**
+ * 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 function set_y2(id, y) {
+    if (isDeleted(id))
+        return id;
+    id.y2 = y;
+    return id;
+}
+/**
+ * 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 function set_xy1(id, x, y) {
+    if (isDeleted(id))
+        return id;
+    id.x1 = x;
+    id.y1 = y;
+    return id;
+}
+/**
+ * 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 function set_xy2(id, x, y) {
+    if (isDeleted(id))
+        return id;
+    id.x2 = x;
+    id.y2 = y;
+    return id;
+}
+/**
+ * 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 function set_xloc(id, x1, x2, xloc) {
+    if (isDeleted(id))
+        return id;
+    id.x1 = x1;
+    id.x2 = x2;
+    id.xloc = xloc;
+    return id;
+}
+/**
+ * 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 function set_extend(id, extend) {
+    if (isDeleted(id))
+        return id;
+    id.extend = extend;
+    return id;
+}
+/**
+ * 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 function set_color(id, lineColor) {
+    if (isDeleted(id))
+        return id;
+    id.color = lineColor;
+    return id;
+}
+/**
+ * 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 function set_style(id, style) {
+    if (isDeleted(id))
+        return id;
+    id.style = style;
+    return id;
+}
+/**
+ * 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 function set_width(id, width) {
+    if (isDeleted(id))
+        return id;
+    id.width = width;
+    return id;
+}
+/**
+ * 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 function delete_line(id) {
+    remove('line', id);
+}
+/** x coordinate of a chart point for an object's xloc (`na` when the point has no such coordinate). */
+function pointX(point, xloc) {
+    const x = xloc === 'bar_time' ? point.time : point.index;
+    return x ?? NaN;
+}
+/**
+ * All live lines, in creation order (PineScript `line.all`). A new array: later changes do not affect it.
+ */
+export function all() {
+    return allDrawings('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 function set_first_point(id, point) {
+    if (isDeleted(id))
+        return id;
+    id.x1 = pointX(point, id.xloc);
+    id.y1 = point.price;
+    return id;
+}
+/**
+ * Sets the second point of the line from a chart point (see {@link set_first_point}).
+ */
+export function set_second_point(id, point) {
+    if (isDeleted(id))
+        return id;
+    id.x2 = pointX(point, id.xloc);
+    id.y2 = point.price;
+    return id;
+}
+// Alias to match PineScript API
+export { new_line as new };
+export { delete_line as delete };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/line/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/linefill/index.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Linefill namespace
+ * Functions for creating and manipulating linefill drawing objects.
+ *
+ * @remarks
+ * Linefill objects fill the area between two lines with a color.
+ * They have minimal computational value but automatically follow line movements
+ * and provide a way to retrieve the underlying line references.
+ *
+ * @version 6
+ */
+import type { Linefill, Line, color } from '../types/index.js';
+/**
+ * Creates a new linefill object that fills the area between two lines.
+ *
+ * @param line1 - First line object
+ * @param line2 - Second line object
+ * @param fillColor - Fill color (optional)
+ * @returns New linefill object
+ *
+ * @remarks
+ * - Automatically follows line movements (if lines are updated, fill updates too)
+ * - Automatically deleted if either line is deleted
+ * - If both lines extend in same direction, fill extends too
+ * - Purely visual in PineScript, but getters allow retrieving line references
+ *
+ * @example
+ * ```typescript
+ * import { line, linefill } from 'oakscriptjs';
+ *
+ * // Create channel lines
+ * const upperLine = line.new(0, 160, 50, 170, 'bar_index', 'right');
+ * const lowerLine = line.new(0, 140, 50, 150, 'bar_index', 'right');
+ *
+ * // Fill channel with color
+ * const channelFill = linefill.new(upperLine, lowerLine, '#0000FF20'); // Transparent blue
+ * ```
+ */
+export declare function new_linefill(line1: Line, line2: Line, fillColor?: color): Linefill;
+/**
+ * Returns the first line reference.
+ *
+ * @param id - Linefill object
+ * @returns First line object
+ *
+ * @remarks
+ * Can be used to retrieve and manipulate the first line.
+ *
+ * @example
+ * ```typescript
+ * const channelFill = linefill.new(upperLine, lowerLine);
+ *
+ * // Later, retrieve and update the first line
+ * const line1 = linefill.get_line1(channelFill);
+ * line.set_y2(line1, 175); // Update upper line's second point
+ * ```
+ */
+export declare function get_line1(id: Linefill): Line;
+/**
+ * Returns the second line reference.
+ *
+ * @param id - Linefill object
+ * @returns Second line object
+ *
+ * @remarks
+ * Can be used to retrieve and manipulate the second line.
+ *
+ * @example
+ * ```typescript
+ * const channelFill = linefill.new(upperLine, lowerLine);
+ *
+ * // Later, retrieve and update the second line
+ * const line2 = linefill.get_line2(channelFill);
+ * line.set_y2(line2, 145); // Update lower line's second point
+ * ```
+ */
+export declare function get_line2(id: Linefill): Line;
+/**
+ * Sets the fill color.
+ *
+ * @param id - Linefill object to modify
+ * @param fillColor - New fill color
+ * @returns Modified linefill object
+ *
+ * @remarks
+ * Useful for dynamically changing channel colors based on conditions.
+ *
+ * @example
+ * ```typescript
+ * const channelFill = linefill.new(upperLine, lowerLine, '#0000FF20');
+ *
+ * // Change color based on trend
+ * if (bullish) {
+ *   linefill.set_color(channelFill, '#00FF0020'); // Green
+ * } else {
+ *   linefill.set_color(channelFill, '#FF000020'); // Red
+ * }
+ * ```
+ */
+export declare function set_color(id: Linefill, fillColor: color): Linefill;
+/**
+ * Deletes the linefill object.
+ *
+ * @param id - Linefill object to delete
+ *
+ * @remarks
+ * Removes the linefill from `linefill.all()`. As in PineScript, the deleted linefill is `na`: its getters
+ * return NaN and its setters do nothing. Deleting it twice has no effect.
+ *
+ * @example
+ * ```typescript
+ * const channelFill = linefill.new(upperLine, lowerLine);
+ * linefill.delete(channelFill);
+ * // linefill.all() no longer contains it
+ * ```
+ */
+export declare function delete_linefill(id: Linefill): void;
+/**
+ * All live linefills, in creation order (PineScript `linefill.all`). A new array.
+ */
+export declare function all(): Linefill[];
+export { new_linefill as new };
+export { delete_linefill as delete };
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/linefill/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/linefill/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAMlF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAE5C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAE5C;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,GAAG,QAAQ,CAIlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAElD;AAGD;;GAEG;AACH,wBAAgB,GAAG,IAAI,QAAQ,EAAE,CAEhC;AAGD,OAAO,EAAE,YAAY,IAAI,GAAG,EAAE,CAAC;AAC/B,OAAO,EAAE,eAAe,IAAI,MAAM,EAAE,CAAC"}