oakscriptjs 0.8.2 → 0.9.0

package/dist/esm/callsite/index.js

@@ -0,0 +1,97 @@
+/**
+ * @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
+ */
+/**
+ * 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 function whenCalled(called, fn, ...sources) {
+    const bars = [];
+    for (let i = 0; i < called.length; i++)
+        if (called[i])
+            bars.push(i);
+    const result = fn(...sources.map(s => bars.map(i => s[i] ?? NaN)));
+    const out = new Array(called.length).fill(NaN);
+    bars.forEach((bar, k) => {
+        out[bar] = result[k];
+    });
+    return out;
+}
+/** A call site that keeps the two previous arguments (na before the first call). */
+function twoSeriesSite(test) {
+    let prevA = NaN;
+    let prevB = NaN;
+    return (a, b) => {
+        const result = test(a, b, prevA, prevB);
+        prevA = a;
+        prevB = b;
+        return result;
+    };
+}
+/** One `ta.crossover(a, b)` call site: false on its first call, as its history is na. */
+export function crossover() {
+    return twoSeriesSite((a, b, pa, pb) => a > b && pa <= pb);
+}
+/** One `ta.crossunder(a, b)` call site: false on its first call, as its history is na. */
+export function crossunder() {
+    return twoSeriesSite((a, b, pa, pb) => a < b && pa >= pb);
+}
+/**
+ * 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 function barssince() {
+    let count = NaN;
+    return (condition) => {
+        if (condition && !Number.isNaN(condition))
+            count = 0;
+        else if (!Number.isNaN(count))
+            count++;
+        return count;
+    };
+}
+/** One `ta.cross(a, b)` call site: false on its first call, as its history is na. */
+export function cross() {
+    return twoSeriesSite((a, b, pa, pb) => (a > b && pa <= pb) || (a < b && pa >= pb));
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/callsite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CACxB,MAAmC,EACnC,EAA2C,EAC3C,GAAG,OAAiB;IAEpB,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,IAAI,MAAM,CAAC,CAAC,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,GAAG,GAAG,IAAI,KAAK,CAAa,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACtB,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,oFAAoF;AACpF,SAAS,aAAa,CAAC,IAAqE;IAC1F,IAAI,KAAK,GAAG,GAAG,CAAC;IAChB,IAAI,KAAK,GAAG,GAAG,CAAC;IAChB,OAAO,CAAC,CAAS,EAAE,CAAS,EAAW,EAAE;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,KAAK,GAAG,CAAC,CAAC;QACV,KAAK,GAAG,CAAC,CAAC;QACV,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS;IACvB,OAAO,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,UAAU;IACxB,OAAO,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,IAAI,KAAK,GAAG,GAAG,CAAC;IAChB,OAAO,CAAC,SAAS,EAAE,EAAE;QACnB,IAAI,SAAS,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;YAAE,KAAK,GAAG,CAAC,CAAC;aAChD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;YAAE,KAAK,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,KAAK;IACnB,OAAO,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACrF,CAAC"}

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

@@ -0,0 +1,90 @@
+/**
+ * Chart Point namespace
+ * Functions for creating and manipulating chart point objects.
+ *
+ * @remarks
+ * Chart points represent specific locations on a chart with time, index, and price coordinates.
+ * They are primarily used with polylines and other drawing objects that require multiple points.
+ *
+ * @version 6
+ */
+import type { ChartPoint } from '../types/index.js';
+export type { ChartPoint };
+/**
+ * Creates a new chart point with all coordinates.
+ *
+ * @param time - UNIX timestamp in milliseconds (or null if using bar index)
+ * @param index - Bar index (or null if using time)
+ * @param price - Y-axis price value
+ * @returns New ChartPoint object
+ *
+ * @remarks
+ * Creates a chart point that can be used with polylines and other multi-point drawing objects.
+ * Typically, you would provide either time or index, not both, depending on the xloc mode.
+ *
+ * @example
+ * ```typescript
+ * // Create a point with both time and index
+ * const point = chartPoint.new(1609459200000, 100, 150.5);
+ *
+ * // Create a point with only index
+ * const indexPoint = chartPoint.new(null, 50, 200);
+ *
+ * // Create a point with only time
+ * const timePoint = chartPoint.new(1609459200000, null, 175);
+ * ```
+ */
+export declare function new_point(time: number | null, index: number | null, price: number): ChartPoint;
+/**
+ * Creates a chart point from time and price.
+ *
+ * @param time - UNIX timestamp in milliseconds
+ * @param price - Y-axis price value
+ * @returns New ChartPoint object with index set to null
+ *
+ * @remarks
+ * Convenience function for creating points when using xloc.bar_time mode.
+ *
+ * @example
+ * ```typescript
+ * // Create a point using timestamp
+ * const point = chartPoint.from_time(1609459200000, 150.5);
+ * ```
+ */
+export declare function from_time(time: number, price: number): ChartPoint;
+/**
+ * Creates a chart point from bar index and price.
+ *
+ * @param index - Bar index
+ * @param price - Y-axis price value
+ * @returns New ChartPoint object with time set to null
+ *
+ * @remarks
+ * Convenience function for creating points when using xloc.bar_index mode.
+ *
+ * @example
+ * ```typescript
+ * // Create a point using bar index
+ * const point = chartPoint.from_index(50, 150.5);
+ * ```
+ */
+export declare function from_index(index: number, price: number): ChartPoint;
+/**
+ * Creates a copy of a chart point.
+ *
+ * @param point - ChartPoint to copy
+ * @returns New ChartPoint object with same values
+ *
+ * @remarks
+ * Creates a shallow copy of the chart point. Since ChartPoint is immutable (readonly properties),
+ * this creates an independent copy.
+ *
+ * @example
+ * ```typescript
+ * const original = chartPoint.from_index(10, 100);
+ * const copied = chartPoint.copy(original);
+ * ```
+ */
+export declare function copy(point: ChartPoint): ChartPoint;
+export { new_point as new };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/chartpoint/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,KAAK,EAAE,MAAM,GACZ,UAAU,CAMZ;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAMjE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAMnE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAMlD;AAGD,OAAO,EAAE,SAAS,IAAI,GAAG,EAAE,CAAC"}

package/dist/esm/chartpoint/index.js

@@ -0,0 +1,113 @@
+/**
+ * Chart Point namespace
+ * Functions for creating and manipulating chart point objects.
+ *
+ * @remarks
+ * Chart points represent specific locations on a chart with time, index, and price coordinates.
+ * They are primarily used with polylines and other drawing objects that require multiple points.
+ *
+ * @version 6
+ */
+/**
+ * Creates a new chart point with all coordinates.
+ *
+ * @param time - UNIX timestamp in milliseconds (or null if using bar index)
+ * @param index - Bar index (or null if using time)
+ * @param price - Y-axis price value
+ * @returns New ChartPoint object
+ *
+ * @remarks
+ * Creates a chart point that can be used with polylines and other multi-point drawing objects.
+ * Typically, you would provide either time or index, not both, depending on the xloc mode.
+ *
+ * @example
+ * ```typescript
+ * // Create a point with both time and index
+ * const point = chartPoint.new(1609459200000, 100, 150.5);
+ *
+ * // Create a point with only index
+ * const indexPoint = chartPoint.new(null, 50, 200);
+ *
+ * // Create a point with only time
+ * const timePoint = chartPoint.new(1609459200000, null, 175);
+ * ```
+ */
+export function new_point(time, index, price) {
+    return {
+        time,
+        index,
+        price,
+    };
+}
+/**
+ * Creates a chart point from time and price.
+ *
+ * @param time - UNIX timestamp in milliseconds
+ * @param price - Y-axis price value
+ * @returns New ChartPoint object with index set to null
+ *
+ * @remarks
+ * Convenience function for creating points when using xloc.bar_time mode.
+ *
+ * @example
+ * ```typescript
+ * // Create a point using timestamp
+ * const point = chartPoint.from_time(1609459200000, 150.5);
+ * ```
+ */
+export function from_time(time, price) {
+    return {
+        time,
+        index: null,
+        price,
+    };
+}
+/**
+ * Creates a chart point from bar index and price.
+ *
+ * @param index - Bar index
+ * @param price - Y-axis price value
+ * @returns New ChartPoint object with time set to null
+ *
+ * @remarks
+ * Convenience function for creating points when using xloc.bar_index mode.
+ *
+ * @example
+ * ```typescript
+ * // Create a point using bar index
+ * const point = chartPoint.from_index(50, 150.5);
+ * ```
+ */
+export function from_index(index, price) {
+    return {
+        time: null,
+        index,
+        price,
+    };
+}
+/**
+ * Creates a copy of a chart point.
+ *
+ * @param point - ChartPoint to copy
+ * @returns New ChartPoint object with same values
+ *
+ * @remarks
+ * Creates a shallow copy of the chart point. Since ChartPoint is immutable (readonly properties),
+ * this creates an independent copy.
+ *
+ * @example
+ * ```typescript
+ * const original = chartPoint.from_index(10, 100);
+ * const copied = chartPoint.copy(original);
+ * ```
+ */
+export function copy(point) {
+    return {
+        time: point.time,
+        index: point.index,
+        price: point.price,
+    };
+}
+// Alias to match PineScript API (chart.point.new)
+export { new_point as new };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/chartpoint/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,SAAS,CACvB,IAAmB,EACnB,KAAoB,EACpB,KAAa;IAEb,OAAO;QACL,IAAI;QACJ,KAAK;QACL,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa;IACnD,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,IAAI;QACX,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,KAAa;IACrD,OAAO;QACL,IAAI,EAAE,IAAI;QACV,KAAK;QACL,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,IAAI,CAAC,KAAiB;IACpC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC;AACJ,CAAC;AAED,kDAAkD;AAClD,OAAO,EAAE,SAAS,IAAI,GAAG,EAAE,CAAC"}

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

@@ -0,0 +1,285 @@
+/**
+ * Color namespace
+ * Mirrors PineScript's color.* functions for color creation and manipulation.
+ *
+ * @remarks
+ * All color functions in this namespace follow PineScript v6 API specifications.
+ * Colors are represented as RGB or RGBA strings.
+ * Transparency values range from 0 (fully opaque) to 100 (fully transparent).
+ *
+ * @version 6
+ */
+import type { color, int, float, simple_int, simple_float } from '../types/index.js';
+/**
+ * Creates a color from RGB values with optional transparency.
+ *
+ * @param red - Red component (0-255, values are clamped)
+ * @param green - Green component (0-255, values are clamped)
+ * @param blue - Blue component (0-255, values are clamped)
+ * @param transp - Optional transparency (0-100). 0 = opaque, 100 = fully transparent
+ * @returns Color string in rgb() or rgba() format
+ *
+ * @remarks
+ * - RGB values are automatically clamped to the 0-255 range
+ * - Transparency of 0 or omitted results in rgb() format
+ * - Transparency > 0 results in rgba() format
+ * - Transparency is converted to alpha channel (0-1 range)
+ *
+ * PineScript rules:
+ * - an `na` channel is 0; a fractional channel is truncated (127.6 is 127)
+ * - the transparency is clamped to 0..100 (140 is fully transparent, -5 is opaque); an `na` transparency is fully
+ *   transparent
+ *
+ * @example
+ * ```typescript
+ * color.rgb(255, 0, 0) // Returns: "rgb(255, 0, 0)" - Red
+ * color.rgb(0, 255, 0, 50) // Returns: "rgba(0, 255, 0, 0.5)" - Semi-transparent green
+ * color.rgb(300, 0, 0) // Returns: "rgb(255, 0, 0)" - Clamped to 255
+ * ```
+ */
+export declare function rgb(red: simple_int, green: simple_int, blue: simple_int, transp?: simple_float): string;
+/**
+ * Creates a color from a hexadecimal string with optional transparency.
+ *
+ * @param hex - Hex color string (with or without '#' prefix, e.g., "#FF0000" or "FF0000")
+ * @param transp - Optional transparency (0-100). 0 = opaque, 100 = fully transparent
+ * @returns Color string in rgb() or rgba() format
+ *
+ * @remarks
+ * - Accepts hex strings with or without '#' prefix
+ * - Case-insensitive (accepts both "FF0000" and "ff0000")
+ * - Must be 6 characters (excluding '#')
+ * - Format: RRGGBB where each component is 00-FF
+ *
+ * @example
+ * ```typescript
+ * color.from_hex("#FF0000") // Returns: "rgb(255, 0, 0)" - Red
+ * color.from_hex("00FF00", 50) // Returns: "rgba(0, 255, 0, 0.5)" - Semi-transparent green
+ * color.from_hex("#0000FF") // Returns: "rgb(0, 0, 255)" - Blue
+ * color.from_hex("FFA500") // Returns: "rgb(255, 165, 0)" - Orange
+ * ```
+ */
+export declare function from_hex(hex: string, transp?: simple_float): string;
+/**
+ * Creates a new color with modified transparency, preserving RGB components.
+ *
+ * @param baseColor - The base color to modify
+ * @param transp - New transparency value (0-100). 0 = opaque, 100 = fully transparent
+ * @returns New color with updated transparency
+ *
+ * @remarks
+ * - Preserves the RGB values from the base color
+ * - Replaces the transparency with the new value
+ * - Useful for creating semi-transparent versions of existing colors
+ * - PineScript clamps the transparency to 0..100 (`color.new(c, 140)` is fully transparent, `color.new(c, -5)` is
+ *   opaque); an `na` transparency is fully transparent
+ *
+ * @example
+ * ```typescript
+ * const red = color.rgb(255, 0, 0)
+ * color.new_color(red, 50) // Returns: "rgba(255, 0, 0, 0.5)" - Semi-transparent red
+ * color.new_color(red, 0) // Returns: "rgb(255, 0, 0)" - Fully opaque
+ * color.new_color(red, 100) // Returns: "rgba(255, 0, 0, 0)" - Fully transparent
+ * ```
+ */
+export declare function new_color(baseColor: color, transp: simple_float): string;
+/**
+ * Extracts the red component from a color.
+ *
+ * @param clr - The color to extract from
+ * @returns Red component value (0-255)
+ *
+ * @example
+ * ```typescript
+ * color.r(color.rgb(255, 128, 64)) // Returns: 255
+ * color.r(color.from_hex("#FF0000")) // Returns: 255
+ * color.r(color.from_hex("#FFA500")) // Returns: 255 (orange)
+ * ```
+ */
+export declare function r(clr: color): int;
+/**
+ * Extracts the green component from a color.
+ *
+ * @param clr - The color to extract from
+ * @returns Green component value (0-255)
+ *
+ * @example
+ * ```typescript
+ * color.g(color.rgb(255, 128, 64)) // Returns: 128
+ * color.g(color.from_hex("#00FF00")) // Returns: 255
+ * color.g(color.from_hex("#FFA500")) // Returns: 165 (orange)
+ * ```
+ */
+export declare function g(clr: color): int;
+/**
+ * Extracts the blue component from a color.
+ *
+ * @param clr - The color to extract from
+ * @returns Blue component value (0-255)
+ *
+ * @example
+ * ```typescript
+ * color.b(color.rgb(255, 128, 64)) // Returns: 64
+ * color.b(color.from_hex("#0000FF")) // Returns: 255
+ * color.b(color.from_hex("#FFA500")) // Returns: 0 (orange)
+ * ```
+ */
+export declare function b(clr: color): int;
+/**
+ * Extracts the transparency component from a color.
+ *
+ * @param clr - The color to extract from
+ * @returns Transparency value (0-100). 0 = fully opaque, 100 = fully transparent
+ *
+ * @remarks
+ * - Returns 0 for colors without transparency (rgb format)
+ * - Converts alpha channel (0-1) to transparency (0-100)
+ * - PineScript stores the alpha as a byte (0-255) and returns an integer transparency:
+ *   `color.t(color.new(c, 33.3))` is 33
+ *
+ * @example
+ * ```typescript
+ * color.t(color.rgb(255, 0, 0)) // Returns: 0 (opaque)
+ * color.t(color.rgb(255, 0, 0, 50)) // Returns: 50
+ * color.t(color.rgb(255, 0, 0, 100)) // Returns: 100 (fully transparent)
+ * ```
+ */
+export declare function t(clr: color): float;
+/**
+ * Aqua/Cyan color constant
+ * @constant {string} #00BCD4 - RGB(0, 188, 212)
+ */
+export declare const aqua = "#00BCD4";
+/**
+ * Black color constant
+ * @constant {string} #363A45 - RGB(54, 58, 69)
+ */
+export declare const black = "#363A45";
+/**
+ * Blue color constant
+ * @constant {string} #2962FF - RGB(41, 98, 255)
+ */
+export declare const blue = "#2962FF";
+/**
+ * Fuchsia/Magenta color constant
+ * @constant {string} #E040FB - RGB(224, 64, 251)
+ */
+export declare const fuchsia = "#E040FB";
+/**
+ * Gray color constant
+ * @constant {string} #787B86 - RGB(120, 123, 134)
+ */
+export declare const gray = "#787B86";
+/**
+ * Green color constant (same as lime)
+ * @constant {string} #4CAF50 - RGB(76, 175, 80)
+ */
+export declare const green = "#4CAF50";
+/**
+ * Lime color constant (same as green)
+ * @constant {string} #00E676 - RGB(0, 230, 118)
+ */
+export declare const lime = "#00E676";
+/**
+ * Maroon color constant
+ * @constant {string} #880E4F - RGB(136, 14, 79)
+ */
+export declare const maroon = "#880E4F";
+/**
+ * Navy color constant
+ * @constant {string} #311B92 - RGB(49, 27, 146)
+ */
+export declare const navy = "#311B92";
+/**
+ * Olive color constant
+ * @constant {string} #808000 - RGB(128, 128, 0)
+ */
+export declare const olive = "#808000";
+/**
+ * Orange color constant
+ * @constant {string} #FF9800 - RGB(255, 152, 0)
+ */
+export declare const orange = "#FF9800";
+/**
+ * Purple color constant
+ * @constant {string} #9C27B0 - RGB(156, 39, 176)
+ */
+export declare const purple = "#9C27B0";
+/**
+ * Red color constant
+ * @constant {string} #F23645 - RGB(242, 54, 69)
+ */
+export declare const red = "#F23645";
+/**
+ * Silver color constant
+ * @constant {string} #B2B5BE - RGB(178, 181, 190)
+ */
+export declare const silver = "#B2B5BE";
+/**
+ * Teal color constant
+ * @constant {string} #089981 - RGB(8, 153, 129)
+ */
+export declare const teal = "#089981";
+/**
+ * White color constant
+ * @constant {string} #FFFFFF - RGB(255, 255, 255)
+ */
+export declare const white = "#FFFFFF";
+/**
+ * Yellow color constant
+ * @constant {string} #FDD835 - RGB(253, 216, 53)
+ */
+export declare const yellow = "#FDD835";
+/**
+ * Creates a color from a gradient based on value position.
+ *
+ * @param value - Value to calculate position-dependent color
+ * @param bottom_value - Bottom position value corresponding to bottom_color
+ * @param top_value - Top position value corresponding to top_color
+ * @param bottom_color - Bottom position color
+ * @param top_color - Top position color
+ * @returns Color calculated from linear gradient
+ *
+ * @remarks
+ * PineScript rules:
+ * - If value <= bottom_value, returns bottom_color; else if value >= top_value, returns top_color
+ * - Otherwise the colours are mixed with their transparency (premultiplied alpha, alpha as a byte); the RGB channels
+ *   and the alpha are truncated. PineScript's float rounding order is not known: a channel can differ by 1 when the
+ *   exact result is an integer (same RGB at both ends)
+ * - An na value or bottom_value / top_value, or bottom_value == top_value, gives a fully transparent colour
+ * - An na colour counts as fully transparent
+ * - Works with rgb(), rgba() and hex (#RRGGBB, #RRGGBBAA) colours
+ *
+ * @example
+ * ```typescript
+ * // Value at middle of range gets middle color
+ * const midColor = color.from_gradient(50, 0, 100,
+ *   color.rgb(255, 0, 0),    // Red at bottom
+ *   color.rgb(0, 255, 0)      // Green at top
+ * ); // Returns color between red and green
+ *
+ * // Value at extremes
+ * const lowColor = color.from_gradient(-10, 0, 100, red, green); // Returns red
+ * const highColor = color.from_gradient(150, 0, 100, red, green); // Returns green
+ * ```
+ */
+export declare function from_gradient(value: float, bottom_value: float, top_value: float, bottom_color: color, top_color: color): string;
+/**
+ * Alias for new_color function.
+ * Creates a new color with specified transparency from an existing color.
+ *
+ * @param baseColor - The base color
+ * @param transp - Transparency value (0-100). 0 = fully opaque, 100 = fully transparent
+ * @returns New color with applied transparency
+ *
+ * @remarks
+ * This is an alias for `new_color()` to match PineScript's `color.new()` syntax.
+ *
+ * @example
+ * ```typescript
+ * const redColor = color.rgb(255, 0, 0);
+ * const transparentRed = color.new(redColor, 50); // 50% transparent red
+ * ```
+ */
+export { new_color as new };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/color/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAUrF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAUvG;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CASnE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAIxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,GAAG,CAEjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,GAAG,CAEjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,GAAG,CAEjC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,KAAK,CAGnC;AAmCD;;;GAGG;AACH,eAAO,MAAM,IAAI,YAAY,CAAC;AAE9B;;;GAGG;AACH,eAAO,MAAM,KAAK,YAAY,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,IAAI,YAAY,CAAC;AAE9B;;;GAGG;AACH,eAAO,MAAM,OAAO,YAAY,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,IAAI,YAAY,CAAC;AAE9B;;;GAGG;AACH,eAAO,MAAM,KAAK,YAAY,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,IAAI,YAAY,CAAC;AAE9B;;;GAGG;AACH,eAAO,MAAM,MAAM,YAAY,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,IAAI,YAAY,CAAC;AAE9B;;;GAGG;AACH,eAAO,MAAM,KAAK,YAAY,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,MAAM,YAAY,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,MAAM,YAAY,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,GAAG,YAAY,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,MAAM,YAAY,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,IAAI,YAAY,CAAC;AAE9B;;;GAGG;AACH,eAAO,MAAM,KAAK,YAAY,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,MAAM,YAAY,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,KAAK,EACnB,SAAS,EAAE,KAAK,EAChB,YAAY,EAAE,KAAK,EACnB,SAAS,EAAE,KAAK,GACf,MAAM,CAqBR;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,SAAS,IAAI,GAAG,EAAE,CAAC"}