oakscriptjs 0.8.1 → 0.9.0

package/dist/esm/box/index.js

@@ -0,0 +1,602 @@
+/**
+ * Box namespace
+ * Functions for creating and manipulating box drawing objects.
+ *
+ * @remarks
+ * Box objects represent rectangular areas on the chart. The getter functions
+ * (get_top, get_bottom, get_left, get_right) enable computational use cases like:
+ * - Gap detection and tracking (detecting when price fills gaps)
+ * - Range breakout analysis (detecting when price breaks out of consolidation)
+ * - Rectangle pattern recognition
+ *
+ * @version 6
+ */
+import { all as allDrawings, isDeleted, register, remove } from '../drawing/registry.js';
+export function new_box(...args) {
+    let left, top, right, bottom, rest;
+    if (typeof args[0] === 'object' && args[0] !== null) {
+        const [tl, br, ...others] = args;
+        const xloc = others[4] ?? 'bar_index';
+        [left, top, right, bottom, rest] = [pointX(tl, xloc), tl.price, pointX(br, xloc), br.price, others];
+    }
+    else {
+        [left, top, right, bottom] = args;
+        rest = args.slice(4);
+    }
+    const [border_color, border_width, border_style, extend, xloc, bgcolor, text, text_size, text_color, text_halign, text_valign, text_wrap, text_font_family, force_overlay, text_formatting] = rest;
+    return register('box', {
+        left,
+        top,
+        right,
+        bottom,
+        xloc: xloc ?? 'bar_index',
+        extend: extend ?? 'none',
+        border_color,
+        border_width: border_width || 1,
+        border_style: border_style || 'solid',
+        bgcolor,
+        text,
+        text_size,
+        text_color,
+        text_halign,
+        text_valign,
+        text_wrap,
+        text_font_family,
+        force_overlay: force_overlay ?? false,
+        text_formatting,
+    });
+}
+/**
+ * Returns the left border x coordinate.
+ *
+ * @param id - Box object
+ * @returns Left border coordinate (bar index or timestamp)
+ *
+ * @remarks
+ * **COMPUTATIONAL USE**: Calculate gap duration, validate range timeframes
+ *
+ * @example
+ * ```typescript
+ * const gap = box.new(10, 105, 20, 100);
+ * const currentBar = 30;
+ * const duration = currentBar - box.get_left(gap); // Returns 20
+ *
+ * if (duration > 50) {
+ *   console.log('Gap has been open for 50+ bars');
+ * }
+ * ```
+ */
+export function get_left(id) {
+    return id.left;
+}
+/**
+ * Returns the right border x coordinate.
+ *
+ * @param id - Box object
+ * @returns Right border coordinate (bar index or timestamp)
+ *
+ * @remarks
+ * **COMPUTATIONAL USE**: Calculate gap duration, update trailing edges
+ *
+ * @example
+ * ```typescript
+ * const range = box.new(100, 155, 150, 145);
+ * const width = box.get_right(range) - box.get_left(range); // Returns 50 bars
+ * ```
+ */
+export function get_right(id) {
+    return id.right;
+}
+/**
+ * Returns the top border price level.
+ *
+ * @param id - Box object
+ * @returns Top border price
+ *
+ * @remarks
+ * **COMPUTATIONAL USE**: Detect breakouts above resistance, check gap fills
+ *
+ * @example
+ * ```typescript
+ * const gap = box.new(10, 105, 20, 100);  // Bearish gap
+ *
+ * // Check if price has filled gap from below
+ * const high = 106;
+ * if (high > box.get_top(gap)) {
+ *   console.log('Gap completely filled!');
+ * }
+ * ```
+ */
+export function get_top(id) {
+    return id.top;
+}
+/**
+ * Returns the bottom border price level.
+ *
+ * @param id - Box object
+ * @returns Bottom border price
+ *
+ * @remarks
+ * **COMPUTATIONAL USE**: Detect breakouts below support, check gap fills
+ *
+ * @example
+ * ```typescript
+ * const gap = box.new(10, 105, 20, 100);  // Bearish gap
+ *
+ * // Check if price has touched gap from above
+ * const low = 104;
+ * if (low < box.get_top(gap) && low > box.get_bottom(gap)) {
+ *   console.log('Price entered the gap!');
+ * }
+ * ```
+ */
+export function get_bottom(id) {
+    return id.bottom;
+}
+/**
+ * Creates a copy of the box object.
+ *
+ * @param id - Box object to copy
+ * @returns New box object with same properties
+ *
+ * @remarks
+ * Creates a shallow copy of the box. Modifications to the copy won't affect the original.
+ *
+ * @example
+ * ```typescript
+ * const originalBox = box.new(10, 105, 20, 100);
+ * const copiedBox = box.copy(originalBox);
+ *
+ * // Modify copy without affecting original
+ * copiedBox.top = 110;
+ * ```
+ */
+export function copy(id) {
+    return register('box', { ...id });
+}
+// =============================================================================
+// COORDINATE SETTERS
+// =============================================================================
+/**
+ * Sets the left border x coordinate.
+ *
+ * @param id - Box object to modify
+ * @param left - New left border coordinate
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_left(box, 15); // Move left edge to bar 15
+ * ```
+ */
+export function set_left(id, left) {
+    if (isDeleted(id))
+        return id;
+    id.left = left;
+    return id;
+}
+/**
+ * Sets the right border x coordinate.
+ *
+ * @param id - Box object to modify
+ * @param right - New right border coordinate
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_right(box, 25); // Move right edge to bar 25
+ * ```
+ */
+export function set_right(id, right) {
+    if (isDeleted(id))
+        return id;
+    id.right = right;
+    return id;
+}
+/**
+ * Sets the top border price level.
+ *
+ * @param id - Box object to modify
+ * @param top - New top border price
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_top(box, 110); // Move top edge to price 110
+ * ```
+ */
+export function set_top(id, top) {
+    if (isDeleted(id))
+        return id;
+    id.top = top;
+    return id;
+}
+/**
+ * Sets the bottom border price level.
+ *
+ * @param id - Box object to modify
+ * @param bottom - New bottom border price
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_bottom(box, 95); // Move bottom edge to price 95
+ * ```
+ */
+export function set_bottom(id, bottom) {
+    if (isDeleted(id))
+        return id;
+    id.bottom = bottom;
+    return id;
+}
+/**
+ * Sets the left and top coordinates.
+ *
+ * @param id - Box object to modify
+ * @param left - New left border coordinate
+ * @param top - New top border price
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_lefttop(box, 12, 108); // Move top-left corner
+ * ```
+ */
+export function set_lefttop(id, left, top) {
+    if (isDeleted(id))
+        return id;
+    id.left = left;
+    id.top = top;
+    return id;
+}
+/**
+ * Sets the right and bottom coordinates.
+ *
+ * @param id - Box object to modify
+ * @param right - New right border coordinate
+ * @param bottom - New bottom border price
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_rightbottom(box, 25, 98); // Move bottom-right corner
+ * ```
+ */
+export function set_rightbottom(id, right, bottom) {
+    if (isDeleted(id))
+        return id;
+    id.right = right;
+    id.bottom = bottom;
+    return id;
+}
+/**
+ * Sets the coordinate system for the box.
+ *
+ * @param id - Box object to modify
+ * @param left - New left border coordinate
+ * @param right - New right border coordinate
+ * @param xloc - New coordinate system ('bar_index' or 'bar_time')
+ * @returns Modified box object
+ *
+ * @remarks
+ * When changing xloc, you must provide appropriate x coordinates for the new system.
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * // Change to timestamp-based coordinates
+ * box.set_xloc(box, 1609459200000, 1609545600000, 'bar_time');
+ * ```
+ */
+export function set_xloc(id, left, right, xloc) {
+    if (isDeleted(id))
+        return id;
+    id.left = left;
+    id.right = right;
+    id.xloc = xloc;
+    return id;
+}
+/**
+ * Sets the horizontal extension mode.
+ *
+ * @param id - Box object to modify
+ * @param extend - New extension mode
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_extend(box, 'right'); // Extend box to the right
+ * ```
+ */
+export function set_extend(id, extend) {
+    if (isDeleted(id))
+        return id;
+    id.extend = extend;
+    return id;
+}
+// =============================================================================
+// STYLING SETTERS
+// =============================================================================
+/**
+ * Sets the border color.
+ *
+ * @param id - Box object to modify
+ * @param borderColor - New border color
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_border_color(box, '#FF0000'); // Red border
+ * ```
+ */
+export function set_border_color(id, borderColor) {
+    if (isDeleted(id))
+        return id;
+    id.border_color = borderColor;
+    return id;
+}
+/**
+ * Sets the border width.
+ *
+ * @param id - Box object to modify
+ * @param width - New border width in pixels
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_border_width(box, 2); // Thicker border
+ * ```
+ */
+export function set_border_width(id, width) {
+    if (isDeleted(id))
+        return id;
+    id.border_width = width;
+    return id;
+}
+/**
+ * Sets the border style.
+ *
+ * @param id - Box object to modify
+ * @param style - New border style
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_border_style(box, 'dashed'); // Dashed border
+ * ```
+ */
+export function set_border_style(id, style) {
+    if (isDeleted(id))
+        return id;
+    id.border_style = style;
+    return id;
+}
+/**
+ * Sets the background fill color.
+ *
+ * @param id - Box object to modify
+ * @param bgColor - New background color
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_bgcolor(box, '#00FF0030'); // Transparent green fill
+ * ```
+ */
+export function set_bgcolor(id, bgColor) {
+    if (isDeleted(id))
+        return id;
+    id.bgcolor = bgColor;
+    return id;
+}
+// =============================================================================
+// TEXT SETTERS
+// =============================================================================
+/**
+ * Sets the text content.
+ *
+ * @param id - Box object to modify
+ * @param text - New text content
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_text(box, 'Gap Filled'); // Update text
+ * ```
+ */
+export function set_text(id, text) {
+    if (isDeleted(id))
+        return id;
+    id.text = text;
+    return id;
+}
+/**
+ * Sets the text color.
+ *
+ * @param id - Box object to modify
+ * @param textColor - New text color
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_text_color(box, '#FFFFFF'); // White text
+ * ```
+ */
+export function set_text_color(id, textColor) {
+    if (isDeleted(id))
+        return id;
+    id.text_color = textColor;
+    return id;
+}
+/**
+ * Sets the text size.
+ *
+ * @param id - Box object to modify
+ * @param size - New text size
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_text_size(box, 'large'); // Larger text
+ * ```
+ */
+export function set_text_size(id, size) {
+    if (isDeleted(id))
+        return id;
+    id.text_size = size;
+    return id;
+}
+/**
+ * Sets the horizontal text alignment.
+ *
+ * @param id - Box object to modify
+ * @param align - New horizontal alignment
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_text_halign(box, 'center'); // Center text horizontally
+ * ```
+ */
+export function set_text_halign(id, align) {
+    if (isDeleted(id))
+        return id;
+    id.text_halign = align;
+    return id;
+}
+/**
+ * Sets the vertical text alignment.
+ *
+ * @param id - Box object to modify
+ * @param align - New vertical alignment
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_text_valign(box, 'center'); // Center text vertically
+ * ```
+ */
+export function set_text_valign(id, align) {
+    if (isDeleted(id))
+        return id;
+    id.text_valign = align;
+    return id;
+}
+/**
+ * Sets the text wrapping mode.
+ *
+ * @param id - Box object to modify
+ * @param wrap - New text wrap mode
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_text_wrap(box, 'auto'); // Enable text wrapping
+ * ```
+ */
+export function set_text_wrap(id, wrap) {
+    if (isDeleted(id))
+        return id;
+    id.text_wrap = wrap;
+    return id;
+}
+/**
+ * Sets the text font family.
+ *
+ * @param id - Box object to modify
+ * @param font - New font family
+ * @returns Modified box object
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.set_text_font_family(box, 'monospace'); // Monospace font
+ * ```
+ */
+export function set_text_font_family(id, font) {
+    if (isDeleted(id))
+        return id;
+    id.text_font_family = font;
+    return id;
+}
+/**
+ * Deletes the box object.
+ *
+ * @param id - Box object to delete
+ *
+ * @remarks
+ * Removes the box from `box.all()`. As in PineScript, the deleted box is `na`: its getters
+ * return NaN and its setters do nothing. Deleting it twice has no effect.
+ *
+ * @example
+ * ```typescript
+ * const box = box.new(10, 105, 20, 100);
+ * box.delete(box);
+ * // box.all() no longer contains it
+ * ```
+ */
+export function delete_box(id) {
+    remove('box', 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 boxes, in creation order (PineScript `box.all`). A new array.
+ */
+export function all() {
+    return allDrawings('box');
+}
+/**
+ * Sets the left and top borders from a chart point (`point.index` or `point.time` by xloc, and `point.price`).
+ */
+export function set_top_left_point(id, point) {
+    if (isDeleted(id))
+        return id;
+    id.left = pointX(point, id.xloc);
+    id.top = point.price;
+    return id;
+}
+/**
+ * Sets the right and bottom borders from a chart point (`point.index` or `point.time` by xloc, and `point.price`).
+ */
+export function set_bottom_right_point(id, point) {
+    if (isDeleted(id))
+        return id;
+    id.right = pointX(point, id.xloc);
+    id.bottom = point.price;
+    return id;
+}
+/**
+ * Sets the text formatting: `text.format_none`, `text.format_bold`, `text.format_italic`,
+ * or `text.format_bold + text.format_italic`.
+ */
+export function set_text_formatting(id, formatting) {
+    if (isDeleted(id))
+        return id;
+    id.text_formatting = formatting;
+    return id;
+}
+// Alias to match PineScript API
+export { new_box as new };
+export { delete_box as delete };
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Per-call history of ta.* functions called in a conditional block.
+ *
+ * In PineScript, every ta.* call keeps its own history of the values it receives. A call inside
+ * an `if` block receives values only on the bars where the block runs, so its history skips the
+ * other bars: `ta.crossover(a, b)` is false on the first bar the block runs, and `ta.sma(x, 3)`
+ * averages the last 3 values it received, not the last 3 bars.
+ *
+ * - {@link whenCalled}: vectorized, when the bars of the calls are known in advance.
+ * - {@link crossover} / {@link crossunder} / {@link cross} / {@link barssince}: one stateful call site for bar
+ *   loops, called only on the bars where the Pine call runs.
+ *
+ * Since PineScript v6, `and` / `or` are lazy: the right operand runs only when the left operand does not decide
+ * the result. A ta.* call in the right operand of `a or b` runs on the bars where `a` is false, in `a and b` on the
+ * bars where `a` is true, so it needs a call site too:
+ *
+ * ```typescript
+ * // Pine:  longCond = longUp or (src > sig and ta.barssince(longUp) <= lookback)
+ * const since = callsite.whenCalled(longUp.map((u, i) => !u && src[i] > sig[i]), (c) => taCore.barssince(c.map(Boolean)), longUp);
+ * // ta.barssince(longUp) only runs where longUp is false: it never sees true and stays na
+ * ```
+ *
+ * ```typescript
+ * // Pine:  if inRange
+ * //            buy = ta.crossover(cumRsi, 60)
+ * const buy = callsite.whenCalled(inRange, (a) => taCore.crossover(a, a.map(() => 60)), cumRsi);
+ *
+ * // Same call in a bar loop
+ * const buyCross = callsite.crossover();
+ * for (let i = 0; i < n; i++) {
+ *   if (inRange[i]) {
+ *     const buy = buyCross(cumRsi[i], 60);
+ *   }
+ * }
+ * ```
+ *
+ * @module callsite
+ */
+import type { Source } from '../types/index.js';
+/**
+ * Runs `fn` on the bars where `called` is true only, like a ta.* call inside an `if` block.
+ * `fn` receives the values of `sources` on those bars, in order; its results are placed back on
+ * the same bars. The other bars get na (NaN).
+ *
+ * @param called - true (or non-zero) on the bars where the call runs
+ * @param fn - the calculation, for example `(x) => taCore.sma(x, 3)`
+ * @param sources - the arguments of the call, one value per chart bar
+ */
+export declare function whenCalled<T extends number | boolean>(called: ArrayLike<boolean | number>, fn: (...values: number[][]) => ArrayLike<T>, ...sources: Source[]): Array<T | number>;
+/** One `ta.crossover(a, b)` call site: false on its first call, as its history is na. */
+export declare function crossover(): (a: number, b: number) => boolean;
+/** One `ta.crossunder(a, b)` call site: false on its first call, as its history is na. */
+export declare function crossunder(): (a: number, b: number) => boolean;
+/**
+ * One `ta.barssince(condition)` call site: the number of calls since the condition was true on a call (0 on that
+ * call), na before the first true condition. An na condition counts as false.
+ */
+export declare function barssince(): (condition: boolean | number) => number;
+/** One `ta.cross(a, b)` call site: false on its first call, as its history is na. */
+export declare function cross(): (a: number, b: number) => boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/callsite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,EACnD,MAAM,EAAE,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC,EACnC,EAAE,EAAE,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAC3C,GAAG,OAAO,EAAE,MAAM,EAAE,GACnB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CASnB;AAcD,yFAAyF;AACzF,wBAAgB,SAAS,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAE7D;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAE9D;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,KAAK,MAAM,CAOnE;AAED,qFAAqF;AACrF,wBAAgB,KAAK,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAEzD"}