oakscriptjs 0.8.1 → 0.9.0

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

@@ -0,0 +1,343 @@
+/**
+ * Core types for OakScriptJS
+ * These types mirror the PineScript type system
+ */
+export type int = number;
+export type float = number;
+export type bool = boolean;
+export type color = string | number;
+export type series<T> = T[];
+export type series_int = series<int>;
+export type series_float = series<float>;
+export type series_bool = series<bool>;
+export type series_string = series<string>;
+export type series_color = series<color>;
+export type simple_int = int;
+export type simple_float = float;
+export type simple_bool = bool;
+export type simple_string = string;
+export type simple_color = color;
+export type input_int = int;
+export type input_float = float;
+export type input_bool = bool;
+export type input_string = string;
+export type input_color = color;
+export type const_int = int;
+export type const_float = float;
+export type const_bool = bool;
+export type const_string = string;
+export type const_color = color;
+export type Source = series_float;
+export type PineArray<T> = Array<T>;
+export type PineMapKey = number | string | boolean;
+export type PineMap<K extends PineMapKey, V> = Map<K, V>;
+export interface PineMatrix<T> {
+    rows: int;
+    columns: int;
+    data: T[][];
+}
+/**
+ * Line object - Represents a line on the chart
+ * @remarks
+ * While lines are visual in PineScript, line.get_price() provides computational value
+ * for detecting trend line breakouts, calculating support/resistance levels, etc.
+ */
+export interface Line {
+    /** First point's x coordinate (bar index or UNIX timestamp) */
+    x1: number;
+    /** First point's y coordinate (price level) */
+    y1: number;
+    /** Second point's x coordinate (bar index or UNIX timestamp) */
+    x2: number;
+    /** Second point's y coordinate (price level) */
+    y2: number;
+    /** X-axis coordinate system */
+    xloc: 'bar_index' | 'bar_time';
+    /** Extension mode */
+    extend: 'none' | 'left' | 'right' | 'both';
+    /** Line color (stored but not used for calculations) */
+    color?: color;
+    /** Line style (stored but not used for calculations) */
+    style?: 'solid' | 'dotted' | 'dashed' | 'arrow_left' | 'arrow_right' | 'arrow_both';
+    /** Line width in pixels (stored but not used for calculations) */
+    width?: number;
+    /** Display on the main chart pane (PineScript force_overlay) */
+    force_overlay?: boolean;
+}
+/**
+ * Box object - Represents a rectangular area on the chart
+ * @remarks
+ * Box getters (get_top, get_bottom, get_left, get_right) enable gap detection,
+ * range breakout analysis, and consolidation zone identification.
+ */
+export interface Box {
+    /** Left border x coordinate (bar index or UNIX timestamp) */
+    left: number;
+    /** Top border y coordinate (price level) */
+    top: number;
+    /** Right border x coordinate (bar index or UNIX timestamp) */
+    right: number;
+    /** Bottom border y coordinate (price level) */
+    bottom: number;
+    /** X-axis coordinate system */
+    xloc: 'bar_index' | 'bar_time';
+    /** Horizontal extension mode */
+    extend: 'none' | 'left' | 'right' | 'both';
+    /** Border color (stored but not used for calculations) */
+    border_color?: color;
+    /** Border width in pixels (stored but not used for calculations) */
+    border_width?: number;
+    /** Border style (stored but not used for calculations) */
+    border_style?: 'solid' | 'dotted' | 'dashed';
+    /** Background fill color (stored but not used for calculations) */
+    bgcolor?: color;
+    /** Text content displayed in the box */
+    text?: string;
+    /** Text size */
+    text_size?: string | number;
+    /** Text color */
+    text_color?: color;
+    /** Horizontal text alignment */
+    text_halign?: 'left' | 'center' | 'right';
+    /** Vertical text alignment */
+    text_valign?: 'top' | 'center' | 'bottom';
+    /** Text wrapping mode */
+    text_wrap?: 'none' | 'auto';
+    /** Text font family */
+    text_font_family?: 'default' | 'monospace';
+    /** Text formatting flags: 0 none, 1 bold, 2 italic, 3 bold + italic (PineScript text.format_*) */
+    text_formatting?: number;
+    /** Display on the main chart pane (PineScript force_overlay) */
+    force_overlay?: boolean;
+}
+/**
+ * Label object - Represents a label/annotation on the chart
+ * @remarks
+ * Labels have limited computational value. Primarily used for marking points and displaying text.
+ */
+export interface Label {
+    /** X coordinate (bar index or UNIX timestamp) */
+    x: number;
+    /** Y coordinate (price level when yloc = 'price') */
+    y: number;
+    /** X-axis coordinate system */
+    xloc: 'bar_index' | 'bar_time';
+    /** Y-axis positioning mode */
+    yloc: 'price' | 'abovebar' | 'belowbar';
+    /** Label text content */
+    text?: string;
+    /** Tooltip text shown on hover */
+    tooltip?: string;
+    /** Border and arrow color */
+    color?: color;
+    /** Label style */
+    style?: 'none' | 'xcross' | 'cross' | 'triangleup' | 'triangledown' | 'flag' | 'circle' | 'arrowup' | 'arrowdown' | 'label_up' | 'label_down' | 'label_left' | 'label_right' | 'label_lower_left' | 'label_lower_right' | 'label_upper_left' | 'label_upper_right' | 'label_center' | 'square' | 'diamond' | 'text_outline';
+    /** Text color */
+    textcolor?: color;
+    /** Label size */
+    size?: string | number;
+    /** Text alignment */
+    textalign?: 'left' | 'center' | 'right';
+    /** Text font family */
+    text_font_family?: 'default' | 'monospace';
+    /** Text formatting flags: 0 none, 1 bold, 2 italic, 3 bold + italic (PineScript text.format_*) */
+    text_formatting?: number;
+    /** Display on the main chart pane (PineScript force_overlay) */
+    force_overlay?: boolean;
+}
+/**
+ * Linefill object - Represents a filled area between two lines
+ * @remarks
+ * Minimal computational value. Used to fill channel areas visually.
+ */
+export interface Linefill {
+    /** First line reference */
+    line1: Line;
+    /** Second line reference */
+    line2: Line;
+    /** Fill color */
+    color?: color;
+}
+/**
+ * Table object - Represents a table for displaying data
+ * @remarks
+ * Tables have NO computational value (no getter functions in PineScript).
+ * Purely for display/visualization purposes.
+ */
+export interface Table {
+    /** Table position on chart */
+    position: 'top_left' | 'top_center' | 'top_right' | 'middle_left' | 'middle_center' | 'middle_right' | 'bottom_left' | 'bottom_center' | 'bottom_right';
+    /** Number of columns */
+    columns: number;
+    /** Number of rows */
+    rows: number;
+    /** Outer frame color */
+    frame_color?: color;
+    /** Outer frame width */
+    frame_width?: number;
+    /** Cell border color */
+    border_color?: color;
+    /** Cell border width */
+    border_width?: number;
+    /** Table background color */
+    bgcolor?: color;
+    /** Cell data (internal storage) */
+    cells?: Map<string, TableCell>;
+}
+/**
+ * Table cell data
+ */
+export interface TableCell {
+    /** Cell text content */
+    text?: string;
+    /** Cell width as percentage */
+    width?: number;
+    /** Cell height as percentage */
+    height?: number;
+    /** Text color */
+    text_color?: color;
+    /** Horizontal text alignment */
+    text_halign?: 'left' | 'center' | 'right';
+    /** Vertical text alignment */
+    text_valign?: 'top' | 'center' | 'bottom';
+    /** Text size */
+    text_size?: string | number;
+    /** Cell background color */
+    bgcolor?: color;
+    /** Cell tooltip */
+    tooltip?: string;
+    /** Text font family */
+    text_font_family?: 'default' | 'monospace';
+}
+export type series_line = series<Line>;
+export type series_box = series<Box>;
+export type series_label = series<Label>;
+export type series_linefill = series<Linefill>;
+export type series_table = series<Table>;
+/**
+ * Plot object - Represents a plot instance created by plot() function
+ * @remarks
+ * In PineScript, plot() returns a reference to a plot instance that can be used with fill().
+ * This ID is used to reference the plot for filling between plots.
+ */
+export interface Plot {
+    /** Unique identifier for this plot */
+    id: string;
+    /** Series being plotted */
+    series: any;
+    /** Plot title */
+    title?: string;
+    /** Plot color */
+    color?: any;
+    /** Line width */
+    linewidth?: number;
+    /** Plot style */
+    style?: 'line' | 'stepline' | 'histogram' | 'area' | 'circles' | 'columns';
+    /** Track price on y-axis */
+    trackprice?: boolean;
+    /** Histogram base level */
+    histbase?: number;
+    /** Offset in bars */
+    offset?: number;
+    /** Join gaps */
+    join?: boolean;
+    /** Editable in chart */
+    editable?: boolean;
+    /** Display mode */
+    display?: 'all' | 'none';
+}
+/**
+ * HLine object - Represents a horizontal line instance created by hline() function
+ * @remarks
+ * In PineScript, hline() returns a reference to an hline instance that can be used with fill().
+ * This ID is used to reference the horizontal line for filling between levels.
+ */
+export interface HLine {
+    /** Unique identifier for this hline */
+    id: string;
+    /** Price level for the horizontal line */
+    price: number;
+    /** Line title */
+    title?: string;
+    /** Line color */
+    color?: any;
+    /** Line style */
+    linestyle?: 'solid' | 'dashed' | 'dotted';
+    /** Line width */
+    linewidth?: number;
+    /** Editable in chart */
+    editable?: boolean;
+}
+export type series_plot = Plot;
+export type series_hline = HLine;
+export interface Bar {
+    time: int;
+    open: float;
+    high: float;
+    low: float;
+    close: float;
+    volume?: float;
+}
+export interface OHLC {
+    open: series_float;
+    high: series_float;
+    low: series_float;
+    close: series_float;
+}
+export declare const na: null;
+export type na = null;
+/**
+ * X-axis location constants
+ * Used to specify whether x-coordinates are bar indices or timestamps
+ */
+export declare const xloc: {
+    /** X-coordinates are bar indices */
+    bar_index: "bar_index";
+    /** X-coordinates are UNIX timestamps in milliseconds */
+    bar_time: "bar_time";
+};
+/**
+ * ChartPoint interface - Represents a point on the chart
+ * @remarks
+ * A chart point can have time, index, and price coordinates.
+ * At least one of time or index should be provided for x-coordinate positioning.
+ */
+export interface ChartPoint {
+    /** UNIX timestamp in milliseconds (null if using bar index) */
+    readonly time: number | null;
+    /** Bar index (null if using time) */
+    readonly index: number | null;
+    /** Y-axis price value */
+    readonly price: number;
+}
+/**
+ * Polyline interface - Represents a polyline on the chart
+ * @remarks
+ * A polyline connects multiple chart points with line segments.
+ * When closed, it forms a polygon that can be filled with color.
+ */
+export interface Polyline {
+    /** Unique identifier for this polyline */
+    readonly id: string;
+    /** Array of chart points that define the polyline */
+    readonly points: readonly ChartPoint[];
+    /** If true, use curved line segments (not yet supported - uses straight lines) */
+    readonly curved: boolean;
+    /** If true, connect the first point to the last point */
+    readonly closed: boolean;
+    /** X-coordinate mode: 'bar_index' or 'bar_time' */
+    readonly xloc: 'bar_index' | 'bar_time';
+    /** Color of line segments */
+    readonly line_color: color;
+    /** Fill color for closed polylines (null for no fill) */
+    readonly fill_color: color | null;
+    /** Line style */
+    readonly line_style: 'solid' | 'dotted' | 'dashed';
+    /** Line width in pixels */
+    readonly line_width: number;
+    /** Force display on main pane */
+    readonly force_overlay: boolean;
+}
+export type series_chartpoint = series<ChartPoint>;
+export type series_polyline = series<Polyline>;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/esm/types/index.js

@@ -0,0 +1,17 @@
+/**
+ * Core types for OakScriptJS
+ * These types mirror the PineScript type system
+ */
+// Constants
+export const na = null;
+/**
+ * X-axis location constants
+ * Used to specify whether x-coordinates are bar indices or timestamps
+ */
+export const xloc = {
+    /** X-coordinates are bar indices */
+    bar_index: 'bar_index',
+    /** X-coordinates are UNIX timestamps in milliseconds */
+    bar_time: 'bar_time',
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6UH,YAAY;AACZ,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;AAGvB;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,oCAAoC;IACpC,SAAS,EAAE,WAAoB;IAC/B,wDAAwD;IACxD,QAAQ,EAAE,UAAmB;CAC9B,CAAC"}

package/dist/esm/types/metadata.d.ts

@@ -0,0 +1,300 @@
+/**
+ * @fileoverview Type definitions for indicator metadata
+ * These types define the structure of data returned by indicators
+ * @module types/metadata
+ */
+/**
+ * Plot style options
+ */
+export type PlotStyle = 'line' | 'stepline' | 'histogram' | 'area' | 'circles' | 'columns' | 'cross' | 'areabr' | 'steplinebr' | 'linebr' | 'stepline_diamond';
+/**
+ * Line style options
+ */
+export type LineStyle = 'solid' | 'dashed' | 'dotted';
+/**
+ * Plot display options
+ */
+export type PlotDisplay = 'all' | 'none' | 'data_window' | 'status_line' | 'pane';
+/**
+ * Options for a plot
+ */
+export interface PlotOptions {
+    /** Plot title */
+    title?: string;
+    /** Plot color (hex string or named color) */
+    color?: string;
+    /** Line width */
+    linewidth?: number;
+    /** Plot style */
+    style?: PlotStyle;
+    /** Line style (PineScript `linestyle`); default solid. A constant or an input value, not per bar */
+    linestyle?: LineStyle;
+    /** Track price on price scale */
+    trackprice?: boolean;
+    /** Histogram base value */
+    histbase?: number;
+    /** Offset from current bar */
+    offset?: number;
+    /** Join gaps in data */
+    join?: boolean;
+    /** User can edit */
+    editable?: boolean;
+    /** Display mode */
+    display?: PlotDisplay;
+    /** Transparency (0-100) */
+    transp?: number;
+    /** Draw the plot on the main chart pane even when the indicator is not an overlay; default false */
+    force_overlay?: boolean;
+}
+/**
+ * Options for a horizontal line
+ */
+export interface HLineOptions {
+    /** Line title */
+    title?: string;
+    /** Line color */
+    color?: string;
+    /** Line style (PineScript default: dashed) */
+    linestyle?: LineStyle;
+    /** Line width */
+    linewidth?: number;
+    /** User can edit */
+    editable?: boolean;
+}
+/**
+ * Options for a fill
+ */
+export interface FillOptions {
+    /** Fill color */
+    color?: string;
+    /** Transparency (0-100) */
+    transp?: number;
+    /** Fill title */
+    title?: string;
+    /** User can edit */
+    editable?: boolean;
+    /** Fill gaps in data */
+    fillgaps?: boolean;
+}
+/**
+ * Input parameter type
+ */
+export type InputType = 'int' | 'float' | 'bool' | 'string' | 'source' | 'color' | 'timeframe' | 'session' | 'time';
+/**
+ * Input parameter metadata
+ */
+export interface InputMetadata {
+    /** Input type */
+    type: InputType;
+    /** Internal name (snake_case) */
+    name: string;
+    /** Display title */
+    title: string;
+    /** Default value */
+    defval: any;
+    /** Minimum value (for numeric inputs) */
+    minval?: number;
+    /** Maximum value (for numeric inputs) */
+    maxval?: number;
+    /** Step size (for numeric inputs) */
+    step?: number;
+    /** Tooltip text */
+    tooltip?: string;
+    /** Inline group */
+    inline?: string;
+    /** Parameter group */
+    group?: string;
+    /** Options for dropdown (for string/source inputs) */
+    options?: any[];
+    /** Confirm before changing */
+    confirm?: boolean;
+}
+/**
+ * Plot metadata
+ */
+export interface PlotMetadata {
+    /** Variable name for the plot */
+    varName: string;
+    /** Plot title */
+    title: string;
+    /** Plot color */
+    color: string;
+    /** Line width */
+    linewidth: number;
+    /** Plot style */
+    style: PlotStyle;
+}
+/**
+ * Indicator metadata
+ */
+export interface IndicatorMetadata {
+    /** Indicator title */
+    title: string;
+    /** Short title */
+    shorttitle?: string;
+    /** Overlay on main chart */
+    overlay: boolean;
+    /** Number format precision */
+    precision?: number;
+    /** Number format */
+    format?: string;
+    /** Timeframe */
+    timeframe?: string;
+    /** Show gaps in timeframes */
+    timeframe_gaps?: boolean;
+    /** Input parameters */
+    inputs?: InputMetadata[];
+    /** Plots */
+    plots?: PlotMetadata[];
+}
+/**
+ * Time-value pair for charting
+ */
+export interface TimeValue {
+    /** Time (timestamp or string) */
+    time: any;
+    /** Value */
+    value: number;
+    /** Per-bar color override */
+    color?: string;
+}
+/**
+ * Plot data with options
+ */
+export interface PlotData {
+    /** Time-value pairs */
+    data: TimeValue[];
+    /** Plot options */
+    options?: PlotOptions;
+}
+/**
+ * Horizontal line data
+ */
+export interface HLineData {
+    /** Y-axis value */
+    value: number;
+    /** Line options */
+    options?: HLineOptions;
+}
+/**
+ * Fill data (area between two plots)
+ */
+export interface FillData {
+    /** First plot index or name */
+    plot1: number | string;
+    /** Second plot index or name */
+    plot2: number | string;
+    /** Fill options */
+    options?: FillOptions;
+    /** Per-bar fill colors (overrides static options.color) */
+    colors?: string[];
+    /** Gradient fill (PineScript `fill(p1, p2, top_value, bottom_value, top_color, bottom_color)`) */
+    gradient?: FillGradient;
+}
+/**
+ * Gradient of a fill, one entry per bar. PineScript rules: the colour
+ * changes with the price, `topColor` at `topValue` and `bottomColor` at `bottomValue`; outside that range the end
+ * colour is kept; each bar has its own gradient (the part from bar i-1 to bar i uses the values of bar i).
+ */
+export interface FillGradient {
+    /** Price of `topColor`, per bar */
+    topValue: number[];
+    /** Price of `bottomColor`, per bar */
+    bottomValue: number[];
+    /** Colour at `topValue`, per bar (null: na) */
+    topColor: Array<string | null>;
+    /** Colour at `bottomValue`, per bar (null: na) */
+    bottomColor: Array<string | null>;
+}
+/**
+ * Marker location on the chart (PineScript plotshape/plotchar locations)
+ */
+export type MarkerLocation = 'abovebar' | 'belowbar' | 'top' | 'bottom' | 'absolute';
+/**
+ * Marker size (PineScript size.* constants)
+ */
+export type MarkerSize = 'auto' | 'tiny' | 'small' | 'normal' | 'large' | 'huge';
+/**
+ * Shape style (PineScript shape.* constants)
+ */
+export type ShapeStyle = 'xcross' | 'cross' | 'triangleup' | 'triangledown' | 'flag' | 'circle' | 'arrowup' | 'arrowdown' | 'labelup' | 'labeldown' | 'square' | 'diamond';
+/**
+ * One marker emitted by plotshape()/plotchar() on a bar where the condition held
+ */
+export interface MarkerData {
+    /** Time of the bar the marker is displayed on (offset already applied) */
+    time: any;
+    /** Id of the plotshape/plotchar declaration that produced it */
+    id: string;
+    /** Marker location relative to the bar */
+    location: MarkerLocation;
+    /** Shape style, or 'char' for plotchar markers */
+    style: ShapeStyle | 'char';
+    /** Character (plotchar only) */
+    char?: string;
+    /** Marker color */
+    color?: string;
+    /** Text shown near the marker */
+    text?: string;
+    /** Text color */
+    textcolor?: string;
+    /** Marker size */
+    size?: MarkerSize;
+    /** Hover tooltip (extension over PineScript plotshape, used by label.new ports) */
+    tooltip?: string;
+    /** Price for location 'absolute' (the series value on that bar) */
+    price?: number;
+}
+/**
+ * Per-bar arrow from plotarrow(): up arrow for a positive value, down arrow for a negative value
+ */
+export interface ArrowData {
+    /** Time of the bar the arrow is displayed on (offset already applied) */
+    time: any;
+    /** Id of the plotarrow declaration that produced it */
+    id: string;
+    /** Series value (non-zero): its sign gives the direction, its absolute value the height */
+    value: number;
+    /** Arrow color (colorup or colordown of that bar) */
+    color: string;
+}
+/**
+ * Per-bar color for bgcolor()/barcolor() output
+ */
+export interface BarColorData {
+    /** Time of the colored bar (offset already applied) */
+    time: any;
+    /** Color */
+    color: string;
+}
+/**
+ * Complete indicator calculation result
+ */
+export interface IndicatorResult {
+    /** Indicator metadata */
+    metadata: IndicatorMetadata;
+    /** Plot data as Record mapping plot IDs to TimeValue arrays */
+    plots: Record<string, TimeValue[]>;
+    /** Horizontal lines */
+    hlines?: HLineData[];
+    /** Fills */
+    fills?: FillData[];
+    /** Markers from plotshape()/plotchar() */
+    markers?: MarkerData[];
+    /** Arrows from plotarrow() */
+    arrows?: ArrowData[];
+    /** Background colors from bgcolor() */
+    bgcolors?: BarColorData[];
+    /** Bar colors from barcolor() */
+    barcolors?: BarColorData[];
+}
+/**
+ * Indicator factory function type
+ */
+export type IndicatorFactory = (options?: Record<string, any>) => {
+    /** Indicator metadata */
+    metadata: IndicatorMetadata;
+    /** Calculate function */
+    calculate: (bars: any[]) => PlotData[] | TimeValue[];
+};
+//# sourceMappingURL=metadata.d.ts.map