oakscriptjs 0.8.2 → 0.9.1

package/dist/cjs/indicator.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/indicator.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Indicator function for creating reusable technical indicators\n * This module provides the `indicator()` function that handles pane management\n * automatically based on the overlay metadata.\n * @module indicator\n */\n\nimport type { Bar } from './types/index.js';\n\n/**\n * Indicator metadata that defines how the indicator should be displayed\n */\nexport interface IndicatorMetadataConfig {\n  /** Full title of the indicator */\n  title: string;\n  /** Short title (for compact display) */\n  shortTitle?: string;\n  /** If true, overlay on price chart; if false, create separate pane (default: false) */\n  overlay?: boolean;\n  /** Number format for values */\n  format?: 'price' | 'percent' | 'volume';\n  /** Decimal precision for displayed values */\n  precision?: number;\n}\n\n/**\n * Input definition for indicator parameters\n */\nexport interface InputDefinition {\n  /** Unique identifier for the input */\n  name: string;\n  /** Input type */\n  type: 'int' | 'float' | 'source' | 'bool' | 'string';\n  /** Display title */\n  title: string;\n  /** Default value */\n  defaultValue: number | string | boolean;\n  /** Minimum value (for numeric inputs) */\n  min?: number;\n  /** Maximum value (for numeric inputs) */\n  max?: number;\n  /** Step size (for numeric inputs) */\n  step?: number;\n  /** Available options (for source/string types) */\n  options?: string[];\n}\n\n/**\n * Context provided to indicator setup/compute functions\n */\nexport interface IndicatorContext {\n  /** Bar data for calculation */\n  readonly data: Bar[];\n  /** Open prices array */\n  readonly open: number[];\n  /** High prices array */\n  readonly high: number[];\n  /** Low prices array */\n  readonly low: number[];\n  /** Close prices array */\n  readonly close: number[];\n  /** Volume array */\n  readonly volume: number[];\n  /** Time values array */\n  readonly time: number[];\n  /** Pane index (0 for overlay, higher for separate panes) */\n  readonly paneIndex: number;\n}\n\n/**\n * Instance of a created indicator\n */\nexport interface IndicatorInstance {\n  /** Indicator metadata */\n  readonly metadata: IndicatorMetadataConfig;\n  /** Get the pane index for this indicator */\n  getPaneIndex(): number;\n  /** Check if this is an overlay indicator */\n  isOverlay(): boolean;\n  /** Get input definitions */\n  getInputs(): InputDefinition[];\n  /** Update input values */\n  updateInputs(inputs: Record<string, number | string | boolean>): void;\n  /** Get current input values */\n  getInputValues(): Record<string, number | string | boolean>;\n  /** Calculate indicator with given bar data */\n  calculate(data: Bar[]): void;\n}\n\n/**\n * Indicator class constructor type\n */\nexport interface IndicatorConstructor {\n  new (): IndicatorInstance;\n}\n\n/**\n * Creates an indicator class that handles pane management automatically.\n * \n * When `overlay: false` (default), the indicator will be displayed in a separate pane.\n * When `overlay: true`, the indicator will be overlaid on the main price chart.\n * \n * @param metadata - Indicator metadata (title, overlay setting, etc.)\n * @param setup - Setup function that receives the indicator context and defines calculations\n * @returns A class constructor for creating indicator instances\n * \n * @example\n * ```typescript\n * const SMAIndicator = indicator({\n *   title: 'Simple Moving Average',\n *   shortTitle: 'SMA',\n *   overlay: true, // Display on price chart\n * }, (ctx) => {\n *   const length = 9;\n *   const sma = ta.sma(ctx.close, length);\n *   // Plot or return data...\n * });\n * \n * const instance = new SMAIndicator();\n * instance.calculate(barData);\n * ```\n */\nexport function indicator(\n  metadata: IndicatorMetadataConfig,\n  setup: (ctx: IndicatorContext) => void\n): IndicatorConstructor {\n  // Normalize metadata with defaults\n  const normalizedMetadata: IndicatorMetadataConfig = {\n    title: metadata.title,\n    shortTitle: metadata.shortTitle ?? metadata.title,\n    overlay: metadata.overlay ?? false, // Default to separate pane\n    format: metadata.format ?? 'price',\n    precision: metadata.precision ?? 2,\n  };\n\n  return class implements IndicatorInstance {\n    readonly metadata = normalizedMetadata;\n    private inputDefinitions: InputDefinition[] = [];\n    private inputValues: Record<string, number | string | boolean> = {};\n    private paneIndex: number = 0;\n\n    constructor() {\n      // Calculate initial pane index based on overlay setting\n      this.paneIndex = normalizedMetadata.overlay ? 0 : 1;\n    }\n\n    getPaneIndex(): number {\n      return this.paneIndex;\n    }\n\n    isOverlay(): boolean {\n      return normalizedMetadata.overlay ?? false;\n    }\n\n    getInputs(): InputDefinition[] {\n      return [...this.inputDefinitions];\n    }\n\n    updateInputs(inputs: Record<string, number | string | boolean>): void {\n      this.inputValues = { ...this.inputValues, ...inputs };\n    }\n\n    getInputValues(): Record<string, number | string | boolean> {\n      return { ...this.inputValues };\n    }\n\n    calculate(data: Bar[]): void {\n      const ctx = this.createContext(data);\n      setup(ctx);\n    }\n\n    private createContext(data: Bar[]): IndicatorContext {\n      return {\n        data,\n        open: data.map(d => d.open),\n        high: data.map(d => d.high),\n        low: data.map(d => d.low),\n        close: data.map(d => d.close),\n        volume: data.map(d => d.volume ?? 0),\n        time: data.map(d => d.time),\n        paneIndex: this.paneIndex,\n      };\n    }\n  };\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA0HO,SAAS,UACd,UACA,OACsB;AAEtB,QAAM,qBAA8C;AAAA,IAClD,OAAO,SAAS;AAAA,IAChB,YAAY,SAAS,cAAc,SAAS;AAAA,IAC5C,SAAS,SAAS,WAAW;AAAA;AAAA,IAC7B,QAAQ,SAAS,UAAU;AAAA,IAC3B,WAAW,SAAS,aAAa;AAAA,EACnC;AAEA,SAAO,MAAmC;AAAA,IAC/B,WAAW;AAAA,IACZ,mBAAsC,CAAC;AAAA,IACvC,cAAyD,CAAC;AAAA,IAC1D,YAAoB;AAAA,IAE5B,cAAc;AAEZ,WAAK,YAAY,mBAAmB,UAAU,IAAI;AAAA,IACpD;AAAA,IAEA,eAAuB;AACrB,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,YAAqB;AACnB,aAAO,mBAAmB,WAAW;AAAA,IACvC;AAAA,IAEA,YAA+B;AAC7B,aAAO,CAAC,GAAG,KAAK,gBAAgB;AAAA,IAClC;AAAA,IAEA,aAAa,QAAyD;AACpE,WAAK,cAAc,EAAE,GAAG,KAAK,aAAa,GAAG,OAAO;AAAA,IACtD;AAAA,IAEA,iBAA4D;AAC1D,aAAO,EAAE,GAAG,KAAK,YAAY;AAAA,IAC/B;AAAA,IAEA,UAAU,MAAmB;AAC3B,YAAM,MAAM,KAAK,cAAc,IAAI;AACnC,YAAM,GAAG;AAAA,IACX;AAAA,IAEQ,cAAc,MAA+B;AACnD,aAAO;AAAA,QACL;AAAA,QACA,MAAM,KAAK,IAAI,OAAK,EAAE,IAAI;AAAA,QAC1B,MAAM,KAAK,IAAI,OAAK,EAAE,IAAI;AAAA,QAC1B,KAAK,KAAK,IAAI,OAAK,EAAE,GAAG;AAAA,QACxB,OAAO,KAAK,IAAI,OAAK,EAAE,KAAK;AAAA,QAC5B,QAAQ,KAAK,IAAI,OAAK,EAAE,UAAU,CAAC;AAAA,QACnC,MAAM,KAAK,IAAI,OAAK,EAAE,IAAI;AAAA,QAC1B,WAAW,KAAK;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/cjs/input.d.ts

@@ -0,0 +1,196 @@
+/**
+ * @fileoverview Input helper functions for indicator parameters
+ * These functions create input definitions that can be used with the indicator system.
+ * @module input
+ */
+/**
+ * Input value with its configuration
+ */
+export interface InputValue<T> {
+    /** Input type identifier */
+    type: 'int' | 'float' | 'source' | 'bool' | 'string' | 'timeframe' | 'session' | 'time';
+    /** Default value */
+    defaultValue: T;
+    /** Current value (initially equals defaultValue) */
+    value: T;
+    /** Display title */
+    title?: string;
+    /** Minimum value (for numeric inputs) */
+    min?: number;
+    /** Maximum value (for numeric inputs) */
+    max?: number;
+    /** Step size (for numeric inputs) */
+    step?: number;
+    /** Available options (for source/string/timeframe/session types) */
+    options?: string[];
+}
+/**
+ * Options for integer input
+ */
+export interface IntInputOptions {
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Step size */
+    step?: number;
+    /** Display title */
+    title?: string;
+}
+/**
+ * Options for float input
+ */
+export interface FloatInputOptions {
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Step size */
+    step?: number;
+    /** Display title */
+    title?: string;
+}
+/**
+ * Options for source input
+ */
+export interface SourceInputOptions {
+    /** Display title */
+    title?: string;
+}
+/**
+ * Options for boolean input
+ */
+export interface BoolInputOptions {
+    /** Display title */
+    title?: string;
+}
+/**
+ * Options for string input
+ */
+export interface StringInputOptions {
+    /** Display title */
+    title?: string;
+    /** Available options for dropdown */
+    options?: string[];
+}
+/**
+ * Options for time input
+ */
+export interface TimeInputOptions {
+    /** Display title */
+    title?: string;
+}
+/**
+ * Source type for price data
+ */
+export type SourceType = 'open' | 'high' | 'low' | 'close' | 'hl2' | 'hlc3' | 'ohlc4' | 'hlcc4';
+/**
+ * Input helper functions for creating indicator parameters
+ */
+export declare const input: {
+    /**
+     * Create an integer input parameter
+     * @param defaultValue - Default value for the input
+     * @param options - Additional options (min, max, step, title)
+     * @returns Input value object
+     *
+     * @example
+     * ```typescript
+     * const length = input.int(14, { min: 1, max: 500, title: 'Length' });
+     * console.log(length.value); // 14
+     * ```
+     */
+    int(defaultValue: number, options?: IntInputOptions): InputValue<number>;
+    /**
+     * Create a float input parameter
+     * @param defaultValue - Default value for the input
+     * @param options - Additional options (min, max, step, title)
+     * @returns Input value object
+     *
+     * @example
+     * ```typescript
+     * const multiplier = input.float(2.5, { min: 0.1, max: 10, step: 0.1, title: 'Multiplier' });
+     * console.log(multiplier.value); // 2.5
+     * ```
+     */
+    float(defaultValue: number, options?: FloatInputOptions): InputValue<number>;
+    /**
+     * Create a source input parameter (for selecting price data type)
+     * @param defaultValue - Default source type (default: 'close')
+     * @param options - Additional options (title)
+     * @returns Input value object
+     *
+     * @example
+     * ```typescript
+     * const src = input.source('close', { title: 'Source' });
+     * console.log(src.value); // 'close'
+     * ```
+     */
+    source(defaultValue?: SourceType, options?: SourceInputOptions): InputValue<SourceType>;
+    /**
+     * Create a boolean input parameter
+     * @param defaultValue - Default value for the input
+     * @param options - Additional options (title)
+     * @returns Input value object
+     *
+     * @example
+     * ```typescript
+     * const showSignal = input.bool(true, { title: 'Show Signal' });
+     * console.log(showSignal.value); // true
+     * ```
+     */
+    bool(defaultValue: boolean, options?: BoolInputOptions): InputValue<boolean>;
+    /**
+     * Create a string input parameter
+     * @param defaultValue - Default value for the input
+     * @param options - Additional options (title, options for dropdown)
+     * @returns Input value object
+     *
+     * @example
+     * ```typescript
+     * const maType = input.string('SMA', { title: 'MA Type', options: ['SMA', 'EMA', 'WMA'] });
+     * console.log(maType.value); // 'SMA'
+     * ```
+     */
+    string(defaultValue: string, options?: StringInputOptions): InputValue<string>;
+    /**
+     * Create a timeframe input parameter (PineScript `input.timeframe`)
+     * @param defaultValue - Default timeframe string ("60", "1D", "W"); "" means the chart timeframe
+     * @param options - Additional options (title, options for dropdown)
+     * @returns Input value object
+     *
+     * @example
+     * ```typescript
+     * const htf = input.timeframe('1D', { title: 'Higher timeframe' });
+     * console.log(htf.value); // '1D'
+     * ```
+     */
+    timeframe(defaultValue: string, options?: StringInputOptions): InputValue<string>;
+    /**
+     * Create a session input parameter (PineScript `input.session`)
+     * @param defaultValue - Default session string ("0930-1600", "0930-1600:23456")
+     * @param options - Additional options (title, options for dropdown)
+     * @returns Input value object
+     *
+     * @example
+     * ```typescript
+     * const rth = input.session('0930-1600', { title: 'Regular hours' });
+     * console.log(rth.value); // '0930-1600'
+     * ```
+     */
+    session(defaultValue: string, options?: StringInputOptions): InputValue<string>;
+    /**
+     * Create a date/time input parameter (PineScript `input.time`)
+     * @param defaultValue - Default UNIX time in milliseconds, e.g. `time.timestamp('2024-01-01')`
+     * @param options - Additional options (title)
+     * @returns Input value object
+     *
+     * @example
+     * ```typescript
+     * const start = input.time(time.timestamp('2024-01-01'), { title: 'Start' });
+     * console.log(start.value); // 1704067200000
+     * ```
+     */
+    time(defaultValue: number, options?: TimeInputOptions): InputValue<number>;
+};
+//# sourceMappingURL=input.d.ts.map

package/dist/cjs/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/input.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,4BAA4B;IAC5B,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;IACxF,oBAAoB;IACpB,YAAY,EAAE,CAAC,CAAC;IAChB,oDAAoD;IACpD,KAAK,EAAE,CAAC,CAAC;IACT,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,KAAK;IAChB;;;;;;;;;;;OAWG;sBACe,MAAM,YAAW,eAAe,GAAQ,UAAU,CAAC,MAAM,CAAC;IAY5E;;;;;;;;;;;OAWG;wBACiB,MAAM,YAAW,iBAAiB,GAAQ,UAAU,CAAC,MAAM,CAAC;IAYhF;;;;;;;;;;;OAWG;0BACkB,UAAU,YAAqB,kBAAkB,GAAQ,UAAU,CAAC,UAAU,CAAC;IAUpG;;;;;;;;;;;OAWG;uBACgB,OAAO,YAAW,gBAAgB,GAAQ,UAAU,CAAC,OAAO,CAAC;IAShF;;;;;;;;;;;OAWG;yBACkB,MAAM,YAAW,kBAAkB,GAAQ,UAAU,CAAC,MAAM,CAAC;IAUlF;;;;;;;;;;;OAWG;4BACqB,MAAM,YAAW,kBAAkB,GAAQ,UAAU,CAAC,MAAM,CAAC;IAUrF;;;;;;;;;;;OAWG;0BACmB,MAAM,YAAW,kBAAkB,GAAQ,UAAU,CAAC,MAAM,CAAC;IAUnF;;;;;;;;;;;OAWG;uBACgB,MAAM,YAAW,gBAAgB,GAAQ,UAAU,CAAC,MAAM,CAAC;CAQ/E,CAAC"}

package/dist/cjs/input.js

@@ -0,0 +1,197 @@
+"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 input_exports = {};
+__export(input_exports, {
+  input: () => input
+});
+module.exports = __toCommonJS(input_exports);
+const input = {
+  /**
+   * Create an integer input parameter
+   * @param defaultValue - Default value for the input
+   * @param options - Additional options (min, max, step, title)
+   * @returns Input value object
+   * 
+   * @example
+   * ```typescript
+   * const length = input.int(14, { min: 1, max: 500, title: 'Length' });
+   * console.log(length.value); // 14
+   * ```
+   */
+  int(defaultValue, options = {}) {
+    return {
+      type: "int",
+      defaultValue,
+      value: defaultValue,
+      title: options.title,
+      min: options.min,
+      max: options.max,
+      step: options.step ?? 1
+    };
+  },
+  /**
+   * Create a float input parameter
+   * @param defaultValue - Default value for the input
+   * @param options - Additional options (min, max, step, title)
+   * @returns Input value object
+   * 
+   * @example
+   * ```typescript
+   * const multiplier = input.float(2.5, { min: 0.1, max: 10, step: 0.1, title: 'Multiplier' });
+   * console.log(multiplier.value); // 2.5
+   * ```
+   */
+  float(defaultValue, options = {}) {
+    return {
+      type: "float",
+      defaultValue,
+      value: defaultValue,
+      title: options.title,
+      min: options.min,
+      max: options.max,
+      step: options.step ?? 0.1
+    };
+  },
+  /**
+   * Create a source input parameter (for selecting price data type)
+   * @param defaultValue - Default source type (default: 'close')
+   * @param options - Additional options (title)
+   * @returns Input value object
+   * 
+   * @example
+   * ```typescript
+   * const src = input.source('close', { title: 'Source' });
+   * console.log(src.value); // 'close'
+   * ```
+   */
+  source(defaultValue = "close", options = {}) {
+    return {
+      type: "source",
+      defaultValue,
+      value: defaultValue,
+      title: options.title,
+      options: ["open", "high", "low", "close", "hl2", "hlc3", "ohlc4", "hlcc4"]
+    };
+  },
+  /**
+   * Create a boolean input parameter
+   * @param defaultValue - Default value for the input
+   * @param options - Additional options (title)
+   * @returns Input value object
+   * 
+   * @example
+   * ```typescript
+   * const showSignal = input.bool(true, { title: 'Show Signal' });
+   * console.log(showSignal.value); // true
+   * ```
+   */
+  bool(defaultValue, options = {}) {
+    return {
+      type: "bool",
+      defaultValue,
+      value: defaultValue,
+      title: options.title
+    };
+  },
+  /**
+   * Create a string input parameter
+   * @param defaultValue - Default value for the input
+   * @param options - Additional options (title, options for dropdown)
+   * @returns Input value object
+   * 
+   * @example
+   * ```typescript
+   * const maType = input.string('SMA', { title: 'MA Type', options: ['SMA', 'EMA', 'WMA'] });
+   * console.log(maType.value); // 'SMA'
+   * ```
+   */
+  string(defaultValue, options = {}) {
+    return {
+      type: "string",
+      defaultValue,
+      value: defaultValue,
+      title: options.title,
+      options: options.options
+    };
+  },
+  /**
+   * Create a timeframe input parameter (PineScript `input.timeframe`)
+   * @param defaultValue - Default timeframe string ("60", "1D", "W"); "" means the chart timeframe
+   * @param options - Additional options (title, options for dropdown)
+   * @returns Input value object
+   *
+   * @example
+   * ```typescript
+   * const htf = input.timeframe('1D', { title: 'Higher timeframe' });
+   * console.log(htf.value); // '1D'
+   * ```
+   */
+  timeframe(defaultValue, options = {}) {
+    return {
+      type: "timeframe",
+      defaultValue,
+      value: defaultValue,
+      title: options.title,
+      options: options.options
+    };
+  },
+  /**
+   * Create a session input parameter (PineScript `input.session`)
+   * @param defaultValue - Default session string ("0930-1600", "0930-1600:23456")
+   * @param options - Additional options (title, options for dropdown)
+   * @returns Input value object
+   *
+   * @example
+   * ```typescript
+   * const rth = input.session('0930-1600', { title: 'Regular hours' });
+   * console.log(rth.value); // '0930-1600'
+   * ```
+   */
+  session(defaultValue, options = {}) {
+    return {
+      type: "session",
+      defaultValue,
+      value: defaultValue,
+      title: options.title,
+      options: options.options
+    };
+  },
+  /**
+   * Create a date/time input parameter (PineScript `input.time`)
+   * @param defaultValue - Default UNIX time in milliseconds, e.g. `time.timestamp('2024-01-01')`
+   * @param options - Additional options (title)
+   * @returns Input value object
+   *
+   * @example
+   * ```typescript
+   * const start = input.time(time.timestamp('2024-01-01'), { title: 'Start' });
+   * console.log(start.value); // 1704067200000
+   * ```
+   */
+  time(defaultValue, options = {}) {
+    return {
+      type: "time",
+      defaultValue,
+      value: defaultValue,
+      title: options.title
+    };
+  }
+};
+Object.freeze(input);
+//# sourceMappingURL=input.js.map

package/dist/cjs/input.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/input.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Input helper functions for indicator parameters\n * These functions create input definitions that can be used with the indicator system.\n * @module input\n */\n\n/**\n * Input value with its configuration\n */\nexport interface InputValue<T> {\n  /** Input type identifier */\n  type: 'int' | 'float' | 'source' | 'bool' | 'string' | 'timeframe' | 'session' | 'time';\n  /** Default value */\n  defaultValue: T;\n  /** Current value (initially equals defaultValue) */\n  value: T;\n  /** Display title */\n  title?: string;\n  /** Minimum value (for numeric inputs) */\n  min?: number;\n  /** Maximum value (for numeric inputs) */\n  max?: number;\n  /** Step size (for numeric inputs) */\n  step?: number;\n  /** Available options (for source/string/timeframe/session types) */\n  options?: string[];\n}\n\n/**\n * Options for integer input\n */\nexport interface IntInputOptions {\n  /** Minimum value */\n  min?: number;\n  /** Maximum value */\n  max?: number;\n  /** Step size */\n  step?: number;\n  /** Display title */\n  title?: string;\n}\n\n/**\n * Options for float input\n */\nexport interface FloatInputOptions {\n  /** Minimum value */\n  min?: number;\n  /** Maximum value */\n  max?: number;\n  /** Step size */\n  step?: number;\n  /** Display title */\n  title?: string;\n}\n\n/**\n * Options for source input\n */\nexport interface SourceInputOptions {\n  /** Display title */\n  title?: string;\n}\n\n/**\n * Options for boolean input\n */\nexport interface BoolInputOptions {\n  /** Display title */\n  title?: string;\n}\n\n/**\n * Options for string input\n */\nexport interface StringInputOptions {\n  /** Display title */\n  title?: string;\n  /** Available options for dropdown */\n  options?: string[];\n}\n\n/**\n * Options for time input\n */\nexport interface TimeInputOptions {\n  /** Display title */\n  title?: string;\n}\n\n/**\n * Source type for price data\n */\nexport type SourceType = 'open' | 'high' | 'low' | 'close' | 'hl2' | 'hlc3' | 'ohlc4' | 'hlcc4';\n\n/**\n * Input helper functions for creating indicator parameters\n */\nexport const input = {\n  /**\n   * Create an integer input parameter\n   * @param defaultValue - Default value for the input\n   * @param options - Additional options (min, max, step, title)\n   * @returns Input value object\n   * \n   * @example\n   * ```typescript\n   * const length = input.int(14, { min: 1, max: 500, title: 'Length' });\n   * console.log(length.value); // 14\n   * ```\n   */\n  int(defaultValue: number, options: IntInputOptions = {}): InputValue<number> {\n    return {\n      type: 'int' as const,\n      defaultValue,\n      value: defaultValue,\n      title: options.title,\n      min: options.min,\n      max: options.max,\n      step: options.step ?? 1,\n    };\n  },\n\n  /**\n   * Create a float input parameter\n   * @param defaultValue - Default value for the input\n   * @param options - Additional options (min, max, step, title)\n   * @returns Input value object\n   * \n   * @example\n   * ```typescript\n   * const multiplier = input.float(2.5, { min: 0.1, max: 10, step: 0.1, title: 'Multiplier' });\n   * console.log(multiplier.value); // 2.5\n   * ```\n   */\n  float(defaultValue: number, options: FloatInputOptions = {}): InputValue<number> {\n    return {\n      type: 'float' as const,\n      defaultValue,\n      value: defaultValue,\n      title: options.title,\n      min: options.min,\n      max: options.max,\n      step: options.step ?? 0.1,\n    };\n  },\n\n  /**\n   * Create a source input parameter (for selecting price data type)\n   * @param defaultValue - Default source type (default: 'close')\n   * @param options - Additional options (title)\n   * @returns Input value object\n   * \n   * @example\n   * ```typescript\n   * const src = input.source('close', { title: 'Source' });\n   * console.log(src.value); // 'close'\n   * ```\n   */\n  source(defaultValue: SourceType = 'close', options: SourceInputOptions = {}): InputValue<SourceType> {\n    return {\n      type: 'source' as const,\n      defaultValue,\n      value: defaultValue,\n      title: options.title,\n      options: ['open', 'high', 'low', 'close', 'hl2', 'hlc3', 'ohlc4', 'hlcc4'],\n    };\n  },\n\n  /**\n   * Create a boolean input parameter\n   * @param defaultValue - Default value for the input\n   * @param options - Additional options (title)\n   * @returns Input value object\n   * \n   * @example\n   * ```typescript\n   * const showSignal = input.bool(true, { title: 'Show Signal' });\n   * console.log(showSignal.value); // true\n   * ```\n   */\n  bool(defaultValue: boolean, options: BoolInputOptions = {}): InputValue<boolean> {\n    return {\n      type: 'bool' as const,\n      defaultValue,\n      value: defaultValue,\n      title: options.title,\n    };\n  },\n\n  /**\n   * Create a string input parameter\n   * @param defaultValue - Default value for the input\n   * @param options - Additional options (title, options for dropdown)\n   * @returns Input value object\n   * \n   * @example\n   * ```typescript\n   * const maType = input.string('SMA', { title: 'MA Type', options: ['SMA', 'EMA', 'WMA'] });\n   * console.log(maType.value); // 'SMA'\n   * ```\n   */\n  string(defaultValue: string, options: StringInputOptions = {}): InputValue<string> {\n    return {\n      type: 'string' as const,\n      defaultValue,\n      value: defaultValue,\n      title: options.title,\n      options: options.options,\n    };\n  },\n\n  /**\n   * Create a timeframe input parameter (PineScript `input.timeframe`)\n   * @param defaultValue - Default timeframe string (\"60\", \"1D\", \"W\"); \"\" means the chart timeframe\n   * @param options - Additional options (title, options for dropdown)\n   * @returns Input value object\n   *\n   * @example\n   * ```typescript\n   * const htf = input.timeframe('1D', { title: 'Higher timeframe' });\n   * console.log(htf.value); // '1D'\n   * ```\n   */\n  timeframe(defaultValue: string, options: StringInputOptions = {}): InputValue<string> {\n    return {\n      type: 'timeframe' as const,\n      defaultValue,\n      value: defaultValue,\n      title: options.title,\n      options: options.options,\n    };\n  },\n\n  /**\n   * Create a session input parameter (PineScript `input.session`)\n   * @param defaultValue - Default session string (\"0930-1600\", \"0930-1600:23456\")\n   * @param options - Additional options (title, options for dropdown)\n   * @returns Input value object\n   *\n   * @example\n   * ```typescript\n   * const rth = input.session('0930-1600', { title: 'Regular hours' });\n   * console.log(rth.value); // '0930-1600'\n   * ```\n   */\n  session(defaultValue: string, options: StringInputOptions = {}): InputValue<string> {\n    return {\n      type: 'session' as const,\n      defaultValue,\n      value: defaultValue,\n      title: options.title,\n      options: options.options,\n    };\n  },\n\n  /**\n   * Create a date/time input parameter (PineScript `input.time`)\n   * @param defaultValue - Default UNIX time in milliseconds, e.g. `time.timestamp('2024-01-01')`\n   * @param options - Additional options (title)\n   * @returns Input value object\n   *\n   * @example\n   * ```typescript\n   * const start = input.time(time.timestamp('2024-01-01'), { title: 'Start' });\n   * console.log(start.value); // 1704067200000\n   * ```\n   */\n  time(defaultValue: number, options: TimeInputOptions = {}): InputValue<number> {\n    return {\n      type: 'time' as const,\n      defaultValue,\n      value: defaultValue,\n      title: options.title,\n    };\n  },\n};\n\n// Freeze the input object to prevent accidental modifications\nObject.freeze(input);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAkGO,MAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAanB,IAAI,cAAsB,UAA2B,CAAC,GAAuB;AAC3E,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MACA,OAAO;AAAA,MACP,OAAO,QAAQ;AAAA,MACf,KAAK,QAAQ;AAAA,MACb,KAAK,QAAQ;AAAA,MACb,MAAM,QAAQ,QAAQ;AAAA,IACxB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,cAAsB,UAA6B,CAAC,GAAuB;AAC/E,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MACA,OAAO;AAAA,MACP,OAAO,QAAQ;AAAA,MACf,KAAK,QAAQ;AAAA,MACb,KAAK,QAAQ;AAAA,MACb,MAAM,QAAQ,QAAQ;AAAA,IACxB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,OAAO,eAA2B,SAAS,UAA8B,CAAC,GAA2B;AACnG,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MACA,OAAO;AAAA,MACP,OAAO,QAAQ;AAAA,MACf,SAAS,CAAC,QAAQ,QAAQ,OAAO,SAAS,OAAO,QAAQ,SAAS,OAAO;AAAA,IAC3E;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,KAAK,cAAuB,UAA4B,CAAC,GAAwB;AAC/E,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MACA,OAAO;AAAA,MACP,OAAO,QAAQ;AAAA,IACjB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,OAAO,cAAsB,UAA8B,CAAC,GAAuB;AACjF,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MACA,OAAO;AAAA,MACP,OAAO,QAAQ;AAAA,MACf,SAAS,QAAQ;AAAA,IACnB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,UAAU,cAAsB,UAA8B,CAAC,GAAuB;AACpF,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MACA,OAAO;AAAA,MACP,OAAO,QAAQ;AAAA,MACf,SAAS,QAAQ;AAAA,IACnB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,QAAQ,cAAsB,UAA8B,CAAC,GAAuB;AAClF,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MACA,OAAO;AAAA,MACP,OAAO,QAAQ;AAAA,MACf,SAAS,QAAQ;AAAA,IACnB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,KAAK,cAAsB,UAA4B,CAAC,GAAuB;AAC7E,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MACA,OAAO;AAAA,MACP,OAAO,QAAQ;AAAA,IACjB;AAAA,EACF;AACF;AAGA,OAAO,OAAO,KAAK;",
+  "names": []
+}