oakscriptjs 0.8.1 → 0.9.0

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

package/dist/cjs/types/metadata.d.ts.map

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

package/dist/cjs/types/metadata.js

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 metadata_exports = {};
+module.exports = __toCommonJS(metadata_exports);
+//# sourceMappingURL=metadata.js.map

package/dist/cjs/types/metadata.js.map

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

package/dist/cjs/utils/index.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Utility functions for OakScriptJS
+ * These are internal helpers and not part of the PineScript API
+ */
+import type { series_float, int, float, Source, Bar, OHLC } from '../types/index.js';
+import { Series } from '../runtime/series.js';
+/**
+ * Validates that a series has sufficient data for a given length
+ */
+export declare function validateSeriesLength(source: Source, length: int, functionName: string): void;
+/**
+ * Creates a series filled with NaN values
+ */
+export declare function createNaNSeries(length: int): series_float;
+/**
+ * Checks if a value is `na`: NaN, null, undefined, +/-Infinity, or a deleted drawing object
+ * (as in PineScript, `na(l)` is true after `line.delete(l)`, and `na(1 / 0)` is true).
+ */
+export declare function isNA(value: any): boolean;
+/**
+ * Returns the value or a default if it's NA
+ */
+export declare function nz(value: any, defaultValue?: any): any;
+/**
+ * PineScript `fixnan(source)`: replaces each `na` value (NaN, null or undefined) with the
+ * previous non-`na` value. Values before the first non-`na` value stay `na`.
+ * Works for numeric series and for color series (arrays of color strings with `undefined` for `na`).
+ */
+export declare function fixnan<T>(source: T[]): T[];
+/**
+ * PineScript history reference `x[offset]` at bar `i` of an array: the value `offset` bars back,
+ * `na` (NaN) before the first bar. A negative offset (a later bar) throws, as in PineScript.
+ */
+export declare function at(source: ArrayLike<number>, i: int, offset?: int): float;
+/**
+ * PineScript division: `a / 0` is +/-Infinity (0 / 0 is NaN), as in JavaScript. PineScript keeps the infinite value
+ * in comparisons (`1 / 0 > 0` is true) and treats it as `na` in `na()`, `nz()` and plots.
+ */
+export declare function div(a: float, b: float): float;
+/**
+ * Ensures a value is within bounds
+ */
+export declare function clamp(value: float, min: float, max: float): float;
+/**
+ * Linear interpolation
+ */
+export declare function lerp(start: float, end: float, t: float): float;
+/**
+ * Normalize a value from one range to another
+ */
+export declare function normalize(value: float, min: float, max: float, newMin?: float, newMax?: float): float;
+/**
+ * Creates OHLC data from bar array
+ * @param bars - Array of bar data
+ * @returns OHLC data structure
+ */
+export declare function ohlcFromBars(bars: Bar[]): OHLC;
+/**
+ * Gets close prices from OHLC
+ * @param ohlc - OHLC data
+ * @returns Close price series
+ */
+export declare function getClose(ohlc: OHLC): series_float;
+/**
+ * Gets high prices from OHLC
+ * @param ohlc - OHLC data
+ * @returns High price series
+ */
+export declare function getHigh(ohlc: OHLC): series_float;
+/**
+ * Gets low prices from OHLC
+ * @param ohlc - OHLC data
+ * @returns Low price series
+ */
+export declare function getLow(ohlc: OHLC): series_float;
+/**
+ * Gets open prices from OHLC
+ * @param ohlc - OHLC data
+ * @returns Open price series
+ */
+export declare function getOpen(ohlc: OHLC): series_float;
+/**
+ * Extract a specific source from OHLC data or bar array
+ *
+ * @param data - Bar array or OHLC data
+ * @param source - Source type: 'close', 'open', 'high', 'low', 'hl2', 'hlc3', 'ohlc4'
+ * @returns Series of the requested source
+ *
+ * @example
+ * ```typescript
+ * const bars = [{ open: 100, high: 105, low: 98, close: 102 }, ...];
+ * const closes = getSource(bars, 'close'); // [102, ...]
+ * const hl2 = getSource(bars, 'hl2'); // [(105+98)/2, ...]
+ * ```
+ */
+export declare function getSource(data: Bar[] | OHLC, source?: 'close' | 'open' | 'high' | 'low' | 'hl2' | 'hlc3' | 'ohlc4' | 'hlcc4'): series_float;
+/**
+ * Creates a Series from bars based on the specified source type.
+ * Unlike getSource() which returns number[], this returns a Series
+ * with chainable methods like .add(), .sub(), .mul(), .div()
+ *
+ * @param bars - Array of bar data
+ * @param source - Source type (default: 'close')
+ * @returns Series object for the requested source
+ *
+ * @example
+ * ```typescript
+ * const bars = [{ time: 1, open: 100, high: 105, low: 98, close: 102, volume: 1000 }, ...];
+ * const source = getSourceSeries(bars, 'hlc3');
+ * const smaResult = ta.sma(source, 14);
+ * ```
+ */
+export declare function getSourceSeries(bars: Bar[], source?: 'open' | 'high' | 'low' | 'close' | 'hl2' | 'hlc3' | 'ohlc4' | 'hlcc4'): Series;
+/**
+ * Shift (offset) a series forward or backward in time
+ *
+ * @param series - Series to shift
+ * @param offset - Number of bars to shift (positive = forward/right, negative = backward/left)
+ * @returns Shifted series with NaN padding
+ *
+ * @example
+ * ```typescript
+ * const values = [1, 2, 3, 4, 5];
+ * shift(values, 2);  // [NaN, NaN, 1, 2, 3]  (shift forward)
+ * shift(values, -2); // [3, 4, 5, NaN, NaN]  (shift backward)
+ * ```
+ */
+export declare function shift(series: series_float, offset: int): series_float;
+/**
+ * Apply smoothing to a series using a specified method
+ *
+ * @param series - Series to smooth
+ * @param method - Smoothing method: 'SMA', 'EMA', 'WMA', 'RMA'
+ * @param length - Smoothing length
+ * @returns Smoothed series
+ *
+ * @example
+ * ```typescript
+ * const values = [10, 11, 12, 13, 14];
+ * const smoothed = smooth(values, 'EMA', 3);
+ * ```
+ *
+ * @remarks
+ * This is a convenience function that delegates to the appropriate ta function.
+ * Import this from utils, not from ta namespace.
+ */
+export declare function smooth(series: series_float, method: 'SMA' | 'EMA' | 'WMA' | 'RMA', length: int): series_float;
+/**
+ * Format series values with timestamps for output
+ *
+ * @param values - Series of values to format
+ * @param timestamps - Array of timestamps (optional)
+ * @returns Array of objects with time and value properties
+ *
+ * @example
+ * ```typescript
+ * const values = [100, 101, NaN, 103];
+ * const times = [1, 2, 3, 4];
+ * const formatted = formatOutput(values, times);
+ * // [{ time: 1, value: 100 }, { time: 2, value: 101 }, { time: 3, value: null }, { time: 4, value: 103 }]
+ * ```
+ */
+export declare function formatOutput(values: series_float, timestamps?: number[]): Array<{
+    time: number;
+    value: number | null;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/utils/index.d.ts.map

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