oakscriptjs 0.8.1 → 0.9.0

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

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

package/dist/cjs/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/cjs/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"}

package/dist/cjs/callsite/index.js

@@ -0,0 +1,65 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[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 callsite_exports = {};
+__export(callsite_exports, {
+  barssince: () => barssince,
+  cross: () => cross,
+  crossover: () => crossover,
+  crossunder: () => crossunder,
+  whenCalled: () => whenCalled
+});
+module.exports = __toCommonJS(callsite_exports);
+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;
+}
+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;
+  };
+}
+function crossover() {
+  return twoSeriesSite((a, b, pa, pb) => a > b && pa <= pb);
+}
+function crossunder() {
+  return twoSeriesSite((a, b, pa, pb) => a < b && pa >= pb);
+}
+function barssince() {
+  let count = NaN;
+  return (condition) => {
+    if (condition && !Number.isNaN(condition)) count = 0;
+    else if (!Number.isNaN(count)) count++;
+    return count;
+  };
+}
+function cross() {
+  return twoSeriesSite((a, b, pa, pb) => a > b && pa <= pb || a < b && pa >= pb);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/callsite/index.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Per-call history of ta.* functions called in a conditional block.\n *\n * In PineScript, every ta.* call keeps its own history of the values it receives. A call inside\n * an `if` block receives values only on the bars where the block runs, so its history skips the\n * other bars: `ta.crossover(a, b)` is false on the first bar the block runs, and `ta.sma(x, 3)`\n * averages the last 3 values it received, not the last 3 bars.\n *\n * - {@link whenCalled}: vectorized, when the bars of the calls are known in advance.\n * - {@link crossover} / {@link crossunder} / {@link cross} / {@link barssince}: one stateful call site for bar\n *   loops, called only on the bars where the Pine call runs.\n *\n * Since PineScript v6, `and` / `or` are lazy: the right operand runs only when the left operand does not decide\n * 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\n * bars where `a` is true, so it needs a call site too:\n *\n * ```typescript\n * // Pine:  longCond = longUp or (src > sig and ta.barssince(longUp) <= lookback)\n * const since = callsite.whenCalled(longUp.map((u, i) => !u && src[i] > sig[i]), (c) => taCore.barssince(c.map(Boolean)), longUp);\n * // ta.barssince(longUp) only runs where longUp is false: it never sees true and stays na\n * ```\n *\n * ```typescript\n * // Pine:  if inRange\n * //            buy = ta.crossover(cumRsi, 60)\n * const buy = callsite.whenCalled(inRange, (a) => taCore.crossover(a, a.map(() => 60)), cumRsi);\n *\n * // Same call in a bar loop\n * const buyCross = callsite.crossover();\n * for (let i = 0; i < n; i++) {\n *   if (inRange[i]) {\n *     const buy = buyCross(cumRsi[i], 60);\n *   }\n * }\n * ```\n *\n * @module callsite\n */\n\nimport type { Source } from '../types/index.js';\n\n/**\n * Runs `fn` on the bars where `called` is true only, like a ta.* call inside an `if` block.\n * `fn` receives the values of `sources` on those bars, in order; its results are placed back on\n * the same bars. The other bars get na (NaN).\n *\n * @param called - true (or non-zero) on the bars where the call runs\n * @param fn - the calculation, for example `(x) => taCore.sma(x, 3)`\n * @param sources - the arguments of the call, one value per chart bar\n */\nexport function whenCalled<T extends number | boolean>(\n  called: ArrayLike<boolean | number>,\n  fn: (...values: number[][]) => ArrayLike<T>,\n  ...sources: Source[]\n): Array<T | number> {\n  const bars: number[] = [];\n  for (let i = 0; i < called.length; i++) if (called[i]) bars.push(i);\n  const result = fn(...sources.map(s => bars.map(i => s[i] ?? NaN)));\n  const out = new Array<T | number>(called.length).fill(NaN);\n  bars.forEach((bar, k) => {\n    out[bar] = result[k]!;\n  });\n  return out;\n}\n\n/** A call site that keeps the two previous arguments (na before the first call). */\nfunction twoSeriesSite(test: (a: number, b: number, prevA: number, prevB: number) => boolean) {\n  let prevA = NaN;\n  let prevB = NaN;\n  return (a: number, b: number): boolean => {\n    const result = test(a, b, prevA, prevB);\n    prevA = a;\n    prevB = b;\n    return result;\n  };\n}\n\n/** One `ta.crossover(a, b)` call site: false on its first call, as its history is na. */\nexport function crossover(): (a: number, b: number) => boolean {\n  return twoSeriesSite((a, b, pa, pb) => a > b && pa <= pb);\n}\n\n/** One `ta.crossunder(a, b)` call site: false on its first call, as its history is na. */\nexport function crossunder(): (a: number, b: number) => boolean {\n  return twoSeriesSite((a, b, pa, pb) => a < b && pa >= pb);\n}\n\n/**\n * One `ta.barssince(condition)` call site: the number of calls since the condition was true on a call (0 on that\n * call), na before the first true condition. An na condition counts as false.\n */\nexport function barssince(): (condition: boolean | number) => number {\n  let count = NaN;\n  return (condition) => {\n    if (condition && !Number.isNaN(condition)) count = 0;\n    else if (!Number.isNaN(count)) count++;\n    return count;\n  };\n}\n\n/** One `ta.cross(a, b)` call site: false on its first call, as its history is na. */\nexport function cross(): (a: number, b: number) => boolean {\n  return twoSeriesSite((a, b, pa, pb) => (a > b && pa <= pb) || (a < b && pa >= pb));\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkDO,SAAS,WACd,QACA,OACG,SACgB;AACnB,QAAM,OAAiB,CAAC;AACxB,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,IAAK,KAAI,OAAO,CAAC,EAAG,MAAK,KAAK,CAAC;AAClE,QAAM,SAAS,GAAG,GAAG,QAAQ,IAAI,OAAK,KAAK,IAAI,OAAK,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;AACjE,QAAM,MAAM,IAAI,MAAkB,OAAO,MAAM,EAAE,KAAK,GAAG;AACzD,OAAK,QAAQ,CAAC,KAAK,MAAM;AACvB,QAAI,GAAG,IAAI,OAAO,CAAC;AAAA,EACrB,CAAC;AACD,SAAO;AACT;AAGA,SAAS,cAAc,MAAuE;AAC5F,MAAI,QAAQ;AACZ,MAAI,QAAQ;AACZ,SAAO,CAAC,GAAW,MAAuB;AACxC,UAAM,SAAS,KAAK,GAAG,GAAG,OAAO,KAAK;AACtC,YAAQ;AACR,YAAQ;AACR,WAAO;AAAA,EACT;AACF;AAGO,SAAS,YAA+C;AAC7D,SAAO,cAAc,CAAC,GAAG,GAAG,IAAI,OAAO,IAAI,KAAK,MAAM,EAAE;AAC1D;AAGO,SAAS,aAAgD;AAC9D,SAAO,cAAc,CAAC,GAAG,GAAG,IAAI,OAAO,IAAI,KAAK,MAAM,EAAE;AAC1D;AAMO,SAAS,YAAqD;AACnE,MAAI,QAAQ;AACZ,SAAO,CAAC,cAAc;AACpB,QAAI,aAAa,CAAC,OAAO,MAAM,SAAS,EAAG,SAAQ;AAAA,aAC1C,CAAC,OAAO,MAAM,KAAK,EAAG;AAC/B,WAAO;AAAA,EACT;AACF;AAGO,SAAS,QAA2C;AACzD,SAAO,cAAc,CAAC,GAAG,GAAG,IAAI,OAAQ,IAAI,KAAK,MAAM,MAAQ,IAAI,KAAK,MAAM,EAAG;AACnF;",
+  "names": []
+}

package/dist/cjs/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/cjs/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/cjs/chartpoint/index.js

@@ -0,0 +1,56 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[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 chartpoint_exports = {};
+__export(chartpoint_exports, {
+  copy: () => copy,
+  from_index: () => from_index,
+  from_time: () => from_time,
+  new: () => new_point,
+  new_point: () => new_point
+});
+module.exports = __toCommonJS(chartpoint_exports);
+function new_point(time, index, price) {
+  return {
+    time,
+    index,
+    price
+  };
+}
+function from_time(time, price) {
+  return {
+    time,
+    index: null,
+    price
+  };
+}
+function from_index(index, price) {
+  return {
+    time: null,
+    index,
+    price
+  };
+}
+function copy(point) {
+  return {
+    time: point.time,
+    index: point.index,
+    price: point.price
+  };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/chartpoint/index.ts"],
+  "sourcesContent": ["/**\n * Chart Point namespace\n * Functions for creating and manipulating chart point objects.\n *\n * @remarks\n * Chart points represent specific locations on a chart with time, index, and price coordinates.\n * They are primarily used with polylines and other drawing objects that require multiple points.\n *\n * @version 6\n */\n\nimport type { ChartPoint } from '../types/index.js';\n\n// Re-export the ChartPoint type for convenience\nexport type { ChartPoint };\n\n/**\n * Creates a new chart point with all coordinates.\n *\n * @param time - UNIX timestamp in milliseconds (or null if using bar index)\n * @param index - Bar index (or null if using time)\n * @param price - Y-axis price value\n * @returns New ChartPoint object\n *\n * @remarks\n * Creates a chart point that can be used with polylines and other multi-point drawing objects.\n * Typically, you would provide either time or index, not both, depending on the xloc mode.\n *\n * @example\n * ```typescript\n * // Create a point with both time and index\n * const point = chartPoint.new(1609459200000, 100, 150.5);\n *\n * // Create a point with only index\n * const indexPoint = chartPoint.new(null, 50, 200);\n *\n * // Create a point with only time\n * const timePoint = chartPoint.new(1609459200000, null, 175);\n * ```\n */\nexport function new_point(\n  time: number | null,\n  index: number | null,\n  price: number\n): ChartPoint {\n  return {\n    time,\n    index,\n    price,\n  };\n}\n\n/**\n * Creates a chart point from time and price.\n *\n * @param time - UNIX timestamp in milliseconds\n * @param price - Y-axis price value\n * @returns New ChartPoint object with index set to null\n *\n * @remarks\n * Convenience function for creating points when using xloc.bar_time mode.\n *\n * @example\n * ```typescript\n * // Create a point using timestamp\n * const point = chartPoint.from_time(1609459200000, 150.5);\n * ```\n */\nexport function from_time(time: number, price: number): ChartPoint {\n  return {\n    time,\n    index: null,\n    price,\n  };\n}\n\n/**\n * Creates a chart point from bar index and price.\n *\n * @param index - Bar index\n * @param price - Y-axis price value\n * @returns New ChartPoint object with time set to null\n *\n * @remarks\n * Convenience function for creating points when using xloc.bar_index mode.\n *\n * @example\n * ```typescript\n * // Create a point using bar index\n * const point = chartPoint.from_index(50, 150.5);\n * ```\n */\nexport function from_index(index: number, price: number): ChartPoint {\n  return {\n    time: null,\n    index,\n    price,\n  };\n}\n\n/**\n * Creates a copy of a chart point.\n *\n * @param point - ChartPoint to copy\n * @returns New ChartPoint object with same values\n *\n * @remarks\n * Creates a shallow copy of the chart point. Since ChartPoint is immutable (readonly properties),\n * this creates an independent copy.\n *\n * @example\n * ```typescript\n * const original = chartPoint.from_index(10, 100);\n * const copied = chartPoint.copy(original);\n * ```\n */\nexport function copy(point: ChartPoint): ChartPoint {\n  return {\n    time: point.time,\n    index: point.index,\n    price: point.price,\n  };\n}\n\n// Alias to match PineScript API (chart.point.new)\nexport { new_point as new };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAwCO,SAAS,UACd,MACA,OACA,OACY;AACZ,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAkBO,SAAS,UAAU,MAAc,OAA2B;AACjE,SAAO;AAAA,IACL;AAAA,IACA,OAAO;AAAA,IACP;AAAA,EACF;AACF;AAkBO,SAAS,WAAW,OAAe,OAA2B;AACnE,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EACF;AACF;AAkBO,SAAS,KAAK,OAA+B;AAClD,SAAO;AAAA,IACL,MAAM,MAAM;AAAA,IACZ,OAAO,MAAM;AAAA,IACb,OAAO,MAAM;AAAA,EACf;AACF;",
+  "names": []
+}

package/dist/cjs/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/cjs/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"}