oakscriptjs 0.8.2 → 0.9.1

package/dist/esm/array/index.js

@@ -0,0 +1,984 @@
+/**
+ * Array namespace
+ * Mirrors PineScript's array.* functions
+ */
+/**
+ * Creates a new array with initial size and default value
+ */
+export function new_array(size = 0, initial_value) {
+    const arr = [];
+    for (let i = 0; i < size; i++) {
+        arr.push(initial_value);
+    }
+    return arr;
+}
+/**
+ * Returns the number of elements in an array
+ */
+export function size(id) {
+    return id.length;
+}
+/**
+ * Returns the element at the specified index
+ */
+export function get(id, index) {
+    return id[index];
+}
+/**
+ * Sets the value of the element at the specified index
+ */
+export function set(id, index, value) {
+    id[index] = value;
+}
+/**
+ * Appends a value to the end of the array
+ */
+export function push(id, value) {
+    id.push(value);
+}
+/**
+ * Removes and returns the last element of the array
+ */
+export function pop(id) {
+    return id.pop();
+}
+/**
+ * Inserts a value at the beginning of the array
+ */
+export function unshift(id, value) {
+    id.unshift(value);
+}
+/**
+ * Removes and returns the first element of the array
+ */
+export function shift(id) {
+    return id.shift();
+}
+/**
+ * Removes all elements from the array
+ */
+export function clear(id) {
+    id.length = 0;
+}
+/**
+ * Inserts a value at the specified index
+ */
+export function insert(id, index, value) {
+    id.splice(index, 0, value);
+}
+/**
+ * Removes the element at the specified index
+ */
+export function remove(id, index) {
+    return id.splice(index, 1)[0];
+}
+/**
+ * Returns true if the array contains the value
+ */
+export function includes(id, value) {
+    return id.includes(value);
+}
+/**
+ * Returns the index of the first occurrence of the value
+ */
+export function indexof(id, value) {
+    return id.indexOf(value);
+}
+/**
+ * Returns the index of the last occurrence of the value
+ */
+export function lastindexof(id, value) {
+    return id.lastIndexOf(value);
+}
+/**
+ * Returns a shallow copy of the array
+ */
+export function copy(id) {
+    return [...id];
+}
+/**
+ * Concatenates two arrays
+ */
+export function concat(id1, id2) {
+    return [...id1, ...id2];
+}
+/**
+ * Joins all elements into a string
+ */
+export function join(id, separator = ',') {
+    return id.join(separator);
+}
+/**
+ * Reverses the array in place
+ */
+export function reverse(id) {
+    id.reverse();
+}
+/**
+ * Returns a slice of the array
+ */
+export function slice(id, index_from, index_to) {
+    return id.slice(index_from, index_to);
+}
+/**
+ * Sorts array elements (numeric)
+ */
+export function sort(id, order = 'asc') {
+    id.sort((a, b) => {
+        if (order === 'asc') {
+            return a - b;
+        }
+        else {
+            return b - a;
+        }
+    });
+}
+/**
+ * Returns the sum of all elements (numeric arrays only)
+ */
+export function sum(id) {
+    return id.reduce((acc, val) => acc + val, 0);
+}
+/**
+ * Average of the non-na elements (PineScript `array.avg(id)`); an array without values gives NaN.
+ */
+export function avg(id) {
+    const values = id.filter((v) => !Number.isNaN(v));
+    return values.length ? values.reduce((a, b) => a + b, 0) / values.length : NaN;
+}
+/**
+ * The `nth` smallest value (0 = the smallest) of the non-na elements (PineScript `array.min(id, nth)`).
+ * An `nth` past the end gives the greatest value; an array without values gives NaN.
+ */
+export function min(id, nth = 0) {
+    const values = id.filter((v) => !Number.isNaN(v)).sort((a, b) => a - b);
+    return values.length ? values[Math.min(nth, values.length - 1)] : NaN;
+}
+/**
+ * The `nth` greatest value (0 = the greatest) of the non-na elements (PineScript `array.max(id, nth)`).
+ * An `nth` past the end gives the smallest value; an array without values gives NaN.
+ */
+export function max(id, nth = 0) {
+    const values = id.filter((v) => !Number.isNaN(v)).sort((a, b) => b - a);
+    return values.length ? values[Math.min(nth, values.length - 1)] : NaN;
+}
+/**
+ * Returns the median value (numeric arrays only)
+ */
+export function median(id) {
+    const sorted = [...id].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
+}
+/**
+ * Returns the mode (most frequent value)
+ */
+export function mode(id) {
+    const frequency = new Map();
+    let maxFreq = 0;
+    let mode = id[0];
+    for (const val of id) {
+        const freq = (frequency.get(val) || 0) + 1;
+        frequency.set(val, freq);
+        if (freq > maxFreq) {
+            maxFreq = freq;
+            mode = val;
+        }
+    }
+    return mode;
+}
+/**
+ * Standard deviation of the non-na elements (PineScript `array.stdev(id, biased)`).
+ * `biased` true (default) divides by the count, false by the count - 1.
+ */
+export function stdev(id, biased = true) {
+    return Math.sqrt(variance(id, biased));
+}
+/**
+ * Variance of the non-na elements (PineScript `array.variance(id, biased)`).
+ * `biased` true (default) divides by the count, false by the count - 1.
+ */
+export function variance(id, biased = true) {
+    const values = id.filter((v) => !Number.isNaN(v));
+    if (!values.length)
+        return NaN;
+    const mean = values.reduce((a, b) => a + b, 0) / values.length;
+    const squares = values.reduce((a, b) => a + (b - mean) * (b - mean), 0);
+    return squares / (biased ? values.length : values.length - 1);
+}
+/**
+ * Fills the array with the specified value
+ */
+export function fill(id, value, index_from = 0, index_to) {
+    const end = index_to ?? id.length;
+    for (let i = index_from; i < end; i++) {
+        id[i] = value;
+    }
+}
+/**
+ * Creates an array from its arguments (PineScript `array.from(arg0, arg1, ...)`).
+ * `na` values are kept.
+ *
+ * @example
+ * ```typescript
+ * array.from(0.236, 0.382, 0.5, 0.618); // [0.236, 0.382, 0.5, 0.618]
+ * ```
+ */
+export function from(...values) {
+    return [...values];
+}
+/**
+ * Returns the first element of the array
+ *
+ * @param id - The array
+ * @returns The first element, or undefined if array is empty
+ *
+ * @remarks
+ * - Equivalent to `array.get(id, 0)`
+ * - Returns undefined for empty arrays
+ *
+ * @example
+ * ```typescript
+ * const arr = [1, 2, 3, 4, 5];
+ * const firstElement = array.first(arr); // Returns: 1
+ * ```
+ */
+export function first(id) {
+    return id[0];
+}
+/**
+ * Returns the last element of the array
+ *
+ * @param id - The array
+ * @returns The last element, or undefined if array is empty
+ *
+ * @remarks
+ * - Equivalent to `array.get(id, array.size(id) - 1)`
+ * - Returns undefined for empty arrays
+ *
+ * @example
+ * ```typescript
+ * const arr = [1, 2, 3, 4, 5];
+ * const lastElement = array.last(arr); // Returns: 5
+ * ```
+ */
+export function last(id) {
+    return id[id.length - 1];
+}
+/**
+ * True when at least one element of a bool array is true (PineScript `array.some(id)`).
+ * An empty array gives false.
+ */
+export function some(id) {
+    return id.some((v) => v === true);
+}
+/**
+ * True when every element of a bool array is true (PineScript `array.every(id)`).
+ * An empty array gives false, as in PineScript.
+ */
+export function every(id) {
+    return id.length > 0 && id.every((v) => v === true);
+}
+/**
+ * Create new boolean array
+ *
+ * Creates a new array object of bool type elements.
+ *
+ * @param size - Initial size of array (default: 0)
+ * @param initial_value - Initial value for all elements (default: false)
+ * @returns New boolean array
+ *
+ * @example
+ * ```typescript
+ * const arr = array.new_bool(5, true);
+ * // Creates: [true, true, true, true, true]
+ * ```
+ */
+export function new_bool(size = 0, initial_value = false) {
+    return new_array(size, initial_value);
+}
+/**
+ * Create new float array
+ *
+ * Creates a new array object of float type elements.
+ *
+ * @param size - Initial size of array (default: 0)
+ * @param initial_value - Initial value for all elements (default: NaN)
+ * @returns New float array
+ *
+ * @example
+ * ```typescript
+ * const arr = array.new_float(5, 0.0);
+ * // Creates: [0.0, 0.0, 0.0, 0.0, 0.0]
+ * ```
+ */
+export function new_float(size = 0, initial_value = NaN) {
+    return new_array(size, initial_value);
+}
+/**
+ * Create new integer array
+ *
+ * Creates a new array object of int type elements.
+ *
+ * @param size - Initial size of array (default: 0)
+ * @param initial_value - Initial value for all elements (default: NaN)
+ * @returns New integer array
+ *
+ * @example
+ * ```typescript
+ * const arr = array.new_int(5, 0);
+ * // Creates: [0, 0, 0, 0, 0]
+ * ```
+ */
+export function new_int(size = 0, initial_value = NaN) {
+    return new_array(size, initial_value);
+}
+/**
+ * Create new string array
+ *
+ * Creates a new array object of string type elements.
+ *
+ * @param size - Initial size of array (default: 0)
+ * @param initial_value - Initial value for all elements (default: undefined)
+ * @returns New string array
+ *
+ * @example
+ * ```typescript
+ * const arr = array.new_string(5, "text");
+ * // Creates: ["text", "text", "text", "text", "text"]
+ * ```
+ */
+export function new_string(size = 0, initial_value) {
+    return new_array(size, initial_value);
+}
+/**
+ * Create new color array
+ *
+ * Creates a new array object of color type elements.
+ *
+ * @param size - Initial size of array (default: 0)
+ * @param initial_value - Initial value for all elements (default: undefined)
+ * @returns New color array
+ *
+ * @example
+ * ```typescript
+ * const arr = array.new_color(5, "#FF0000");
+ * // Creates: ["#FF0000", "#FF0000", "#FF0000", "#FF0000", "#FF0000"]
+ * ```
+ */
+export function new_color(size = 0, initial_value) {
+    return new_array(size, initial_value);
+}
+/**
+ * Create new line array
+ *
+ * Creates a new array object of line type elements.
+ *
+ * @param size - Initial size of array (default: 0)
+ * @param initial_value - Initial value for all elements (default: undefined)
+ * @returns New line array
+ *
+ * @example
+ * ```typescript
+ * import { array, line } from 'oakscriptjs';
+ *
+ * // Create array to store last 15 lines
+ * const lines = array.new_line();
+ * const trendLine = line.new(0, 100, 50, 150);
+ * array.push(lines, trendLine);
+ *
+ * // Manage line count
+ * if (array.size(lines) > 15) {
+ *   const oldLine = array.shift(lines);
+ * }
+ * ```
+ *
+ * @remarks
+ * Useful for managing collections of trend lines, support/resistance levels, or channel lines.
+ * In PineScript, this is typically used with line.delete() to manage chart object limits.
+ */
+export function new_line(size = 0, initial_value) {
+    return new_array(size, initial_value);
+}
+/**
+ * Create new box array
+ *
+ * Creates a new array object of box type elements.
+ *
+ * @param size - Initial size of array (default: 0)
+ * @param initial_value - Initial value for all elements (default: undefined)
+ * @returns New box array
+ *
+ * @example
+ * ```typescript
+ * import { array, box } from 'oakscriptjs';
+ *
+ * // Create array to store gap boxes
+ * const gaps = array.new_box();
+ * const gapBox = box.new(10, 120, 15, 110);
+ * array.push(gaps, gapBox);
+ *
+ * // Track multiple gaps
+ * for (let i = 0; i < array.size(gaps); i++) {
+ *   const gap = array.get(gaps, i);
+ *   const gapTop = box.get_top(gap);
+ *   const gapBottom = box.get_bottom(gap);
+ *   // Check if gap filled...
+ * }
+ * ```
+ *
+ * @remarks
+ * Useful for tracking ranges, gaps, consolidation zones, or rectangle patterns.
+ * Enables systematic analysis of multiple box objects.
+ */
+export function new_box(size = 0, initial_value) {
+    return new_array(size, initial_value);
+}
+/**
+ * Create new label array
+ *
+ * Creates a new array object of label type elements.
+ *
+ * @param size - Initial size of array (default: 0)
+ * @param initial_value - Initial value for all elements (default: undefined)
+ * @returns New label array
+ *
+ * @example
+ * ```typescript
+ * import { array, label } from 'oakscriptjs';
+ *
+ * // Create array to store pivot labels
+ * const pivotLabels = array.new_label();
+ *
+ * // Add labels for pivot highs
+ * const pivotLabel = label.new(50, 155.5, 'PH', 'bar_index', 'abovebar');
+ * array.push(pivotLabels, pivotLabel);
+ *
+ * // Limit number of labels shown
+ * const maxLabels = 50;
+ * if (array.size(pivotLabels) > maxLabels) {
+ *   array.shift(pivotLabels);
+ * }
+ * ```
+ *
+ * @remarks
+ * Useful for managing collections of annotations, pivot markers, or signal labels.
+ * Helps limit the number of labels displayed by removing old ones.
+ */
+export function new_label(size = 0, initial_value) {
+    return new_array(size, initial_value);
+}
+/**
+ * Create new linefill array
+ *
+ * Creates a new array object of linefill type elements.
+ *
+ * @param size - Initial size of array (default: 0)
+ * @param initial_value - Initial value for all elements (default: undefined)
+ * @returns New linefill array
+ *
+ * @example
+ * ```typescript
+ * import { array, line, linefill } from 'oakscriptjs';
+ *
+ * // Create array to store channel fills
+ * const channels = array.new_linefill();
+ *
+ * // Create channel
+ * const upperLine = line.new(0, 120, 50, 130);
+ * const lowerLine = line.new(0, 100, 50, 110);
+ * const channelFill = linefill.new(upperLine, lowerLine, '#0000FF15');
+ *
+ * array.push(channels, channelFill);
+ * ```
+ *
+ * @remarks
+ * Useful for managing collections of channel fills, Bollinger Band fills, or regression channel fills.
+ * Enables dynamic color changes across multiple channels.
+ */
+export function new_linefill(size = 0, initial_value) {
+    return new_array(size, initial_value);
+}
+/**
+ * Absolute value of array elements
+ *
+ * Returns an array containing the absolute value of each element in the original array.
+ *
+ * @param id - Array of numeric values
+ * @returns New array with absolute values
+ *
+ * @example
+ * ```typescript
+ * const arr = [-1, -2, 3, -4, 5];
+ * const result = array.abs(arr);
+ * // Returns: [1, 2, 3, 4, 5]
+ * ```
+ */
+export function abs(id) {
+    return id.map(x => Math.abs(x));
+}
+/**
+ * Range of array values
+ *
+ * Returns the difference between the maximum and minimum values in the array.
+ *
+ * @param id - Array of numeric values
+ * @returns Difference between max and min (range)
+ *
+ * @example
+ * ```typescript
+ * const arr = [1, 5, 3, 9, 2];
+ * const result = array.range(arr);
+ * // Returns: 8 (9 - 1)
+ * ```
+ *
+ * @remarks
+ * Returns NaN if the array is empty.
+ */
+export function range(id) {
+    if (id.length === 0) {
+        return NaN;
+    }
+    return max(id) - min(id);
+}
+/**
+ * Binary Search
+ *
+ * Searches for a value in a sorted array using binary search algorithm.
+ * Returns the index of the value if found, or -1 if not found.
+ *
+ * @param id - Sorted array (ascending order)
+ * @param val - Value to search for
+ * @returns Index of the value, or -1 if not found
+ *
+ * @example
+ * ```typescript
+ * const arr = [-2, 0, 1, 5, 9]; // Must be sorted
+ * const index = array.binary_search(arr, 5);
+ * // Returns: 3
+ * ```
+ *
+ * @remarks
+ * - Array must be sorted in ascending order
+ * - Uses standard binary search algorithm
+ * - Time complexity: O(log n)
+ */
+export function binary_search(id, val) {
+    let left = 0;
+    let right = id.length - 1;
+    while (left <= right) {
+        const mid = Math.floor((left + right) / 2);
+        if (id[mid] === val) {
+            return mid;
+        }
+        if (id[mid] < val) {
+            left = mid + 1;
+        }
+        else {
+            right = mid - 1;
+        }
+    }
+    return -1; // Not found
+}
+/**
+ * Binary Search Leftmost
+ *
+ * Returns the index of the value if found. When not found, returns the index
+ * of the next smallest element to the left of where the value would be.
+ *
+ * @param id - Sorted array (ascending order)
+ * @param val - Value to search for
+ * @returns Index of value or insertion point to the left
+ *
+ * @example
+ * ```typescript
+ * const arr = [-2, 0, 1, 5, 9];
+ * const index = array.binary_search_leftmost(arr, 3);
+ * // Returns: 2 (index of 1, which is left of where 3 would be)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const arr = [4, 5, 5, 5];
+ * const index = array.binary_search_leftmost(arr, 5);
+ * // Returns: 1 (index of first instance of 5)
+ * ```
+ *
+ * @remarks
+ * - Array must be sorted in ascending order
+ * - For duplicate values, returns leftmost occurrence
+ * - When value not found, returns position of next smaller element
+ */
+export function binary_search_leftmost(id, val) {
+    let left = 0;
+    let right = id.length - 1;
+    let result = -1;
+    let found = false;
+    while (left <= right) {
+        const mid = Math.floor((left + right) / 2);
+        if (id[mid] < val) {
+            if (!found) {
+                result = mid; // Track the last element smaller than val (only if not found)
+            }
+            left = mid + 1;
+        }
+        else if (id[mid] === val) {
+            result = mid;
+            found = true;
+            // Continue searching to the left for leftmost occurrence
+            right = mid - 1;
+        }
+        else {
+            // id[mid] > val
+            right = mid - 1;
+        }
+    }
+    return result;
+}
+/**
+ * Binary Search Rightmost
+ *
+ * Returns the index of the value if found. When not found, returns the index
+ * of the element to the right of where the value would be.
+ *
+ * @param id - Sorted array (ascending order)
+ * @param val - Value to search for
+ * @returns Index of value or insertion point to the right
+ *
+ * @example
+ * ```typescript
+ * const arr = [-2, 0, 1, 5, 9];
+ * const index = array.binary_search_rightmost(arr, 3);
+ * // Returns: 3 (index of 5, which is right of where 3 would be)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const arr = [4, 5, 5, 5];
+ * const index = array.binary_search_rightmost(arr, 5);
+ * // Returns: 3 (index of last instance of 5)
+ * ```
+ *
+ * @remarks
+ * - Array must be sorted in ascending order
+ * - For duplicate values, returns rightmost occurrence
+ * - When value not found, returns position of next larger element
+ */
+export function binary_search_rightmost(id, val) {
+    let left = 0;
+    let right = id.length - 1;
+    let result = -1;
+    let found = false;
+    while (left <= right) {
+        const mid = Math.floor((left + right) / 2);
+        if (id[mid] <= val) {
+            if (id[mid] === val) {
+                result = mid;
+                found = true;
+            }
+            // Continue searching to the right for rightmost occurrence
+            left = mid + 1;
+        }
+        else {
+            // id[mid] > val
+            if (!found) {
+                result = mid; // Track the first element greater than val (only if not found)
+            }
+            right = mid - 1;
+        }
+    }
+    return result;
+}
+/**
+ * Covariance
+ *
+ * Returns the covariance between two arrays.
+ *
+ * @param id1 - First array
+ * @param id2 - Second array
+ * @param biased - If true, uses biased estimate (population). If false, uses unbiased estimate (sample). Default: true
+ * @returns Covariance between the two arrays
+ *
+ * @example
+ * ```typescript
+ * const prices = [100, 102, 98, 105, 103];
+ * const volume = [1000, 1200, 950, 1300, 1100];
+ * const cov = array.covariance(prices, volume);
+ * // Returns covariance between price and volume
+ * ```
+ *
+ * @remarks
+ * - Biased (true): divides by n (population covariance)
+ * - Unbiased (false): divides by n-1 (sample covariance)
+ * - Returns NaN if arrays are empty or have different lengths
+ * - Formula: Cov(X,Y) = E[(X - μX)(Y - μY)]
+ */
+export function covariance(id1, id2, biased = true) {
+    if (id1.length === 0 || id2.length === 0) {
+        return NaN;
+    }
+    if (id1.length !== id2.length) {
+        return NaN;
+    }
+    const n = id1.length;
+    const mean1 = avg(id1);
+    const mean2 = avg(id2);
+    let sum = 0;
+    for (let i = 0; i < n; i++) {
+        sum += (id1[i] - mean1) * (id2[i] - mean2);
+    }
+    // Biased: divide by n, Unbiased: divide by n-1
+    const divisor = biased ? n : n - 1;
+    return sum / divisor;
+}
+/**
+ * Percentile Linear Interpolation
+ *
+ * Returns the value for which the specified percentage of array values are
+ * less than or equal to it, using linear interpolation.
+ *
+ * @param id - Array of numeric values
+ * @param percentage - Percentage (0-100)
+ * @returns Percentile value using linear interpolation
+ *
+ * @example
+ * ```typescript
+ * const arr = [1, 2, 3, 4, 5];
+ * const p50 = array.percentile_linear_interpolation(arr, 50);
+ * // Returns: 3 (median)
+ * ```
+ *
+ * @remarks
+ * - Uses linear interpolation between adjacent values
+ * - Result may not be a member of the array
+ * - Returns NaN if array is empty
+ *
+ * PineScript rules:
+ * - position in the sorted array: `percentage / 100 * size - 0.5`, clamped to the first / last value, linear
+ *   interpolation between the two neighbours
+ * - `na` values are sorted after all numbers; with an `na` in the array, a position between two values gives `na`
+ */
+export function percentile_linear_interpolation(id, percentage) {
+    if (id.length === 0) {
+        return NaN;
+    }
+    const s = sortedNaLast(id);
+    const n = s.length;
+    const pos = (percentage / 100) * n - 0.5;
+    if (pos <= 0)
+        return s[0];
+    if (pos >= n - 1)
+        return s[n - 1];
+    const lo = Math.floor(pos);
+    const f = pos - lo;
+    if (f === 0)
+        return s[lo];
+    return Number.isNaN(s[n - 1]) ? NaN : s[lo] + f * (s[lo + 1] - s[lo]);
+}
+/** Array values sorted ascending, `na` values after the numbers (array.percentile_*). */
+function sortedNaLast(id) {
+    const numbers = id.filter((v) => !Number.isNaN(v)).sort((a, b) => a - b);
+    return [...numbers, ...Array(id.length - numbers.length).fill(NaN)];
+}
+/**
+ * Percentile Nearest Rank
+ *
+ * Returns the value for which the specified percentage of array values are
+ * less than or equal to it, using the nearest-rank method.
+ *
+ * @param id - Array of numeric values
+ * @param percentage - Percentage (0-100)
+ * @returns Percentile value using nearest rank
+ *
+ * @example
+ * ```typescript
+ * const arr = [1, 2, 3, 4, 5];
+ * const p50 = array.percentile_nearest_rank(arr, 50);
+ * // Returns: 3 (median, always a member of array)
+ * ```
+ *
+ * @remarks
+ * - Result is always a member of the array
+ * - Uses nearest-rank method (no interpolation)
+ * - Returns NaN if array is empty
+ *
+ * PineScript rules:
+ * - the value at rank `ceil(percentage / 100 * size)` of the sorted array
+ * - `na` values are sorted after all numbers (na when that rank holds an `na`)
+ */
+export function percentile_nearest_rank(id, percentage) {
+    if (id.length === 0) {
+        return NaN;
+    }
+    const s = sortedNaLast(id);
+    const rank = Math.min(s.length, Math.max(1, Math.ceil((percentage / 100) * s.length)));
+    return s[rank - 1];
+}
+/**
+ * Percent Rank
+ *
+ * Returns the percentile rank of the element at the specified index.
+ * The percentile rank is the percentage of elements that are less than
+ * or equal to the reference value.
+ *
+ * @param id - Array of numeric values
+ * @param index - Index of element to rank
+ * @returns Percentile rank (0-100)
+ *
+ * @example
+ * ```typescript
+ * const arr = [1, 2, 3, 4, 5];
+ * const rank = array.percentrank(arr, 2); // Value at index 2 is 3
+ * // Returns: 40 (40% of values <= 3)
+ * ```
+ *
+ * @remarks
+ * - Returns percentage of elements <= the value at given index
+ * - Range: 0 to 100
+ * - Returns NaN if array is empty or index out of bounds
+ */
+export function percentrank(id, index) {
+    if (id.length === 0 || index < 0 || index >= id.length) {
+        return NaN;
+    }
+    const value = id[index];
+    if (isNaN(value)) {
+        return NaN;
+    }
+    // Count elements less than or equal to the value
+    let count = 0;
+    for (let i = 0; i < id.length; i++) {
+        if (!isNaN(id[i]) && id[i] <= value) {
+            count++;
+        }
+    }
+    // Calculate percentage
+    return (count / id.length) * 100;
+}
+/**
+ * Sort Indices
+ *
+ * Returns an array of indices which, when used to index the original array,
+ * will access its elements in their sorted order. Does not modify the original array.
+ *
+ * @param id - Array to get sorted indices from
+ * @param order - Sort order: 'asc' or 'desc' (default: 'asc')
+ * @returns Array of indices in sorted order
+ *
+ * @example
+ * ```typescript
+ * const arr = [5, -2, 0, 9, 1];
+ * const indices = array.sort_indices(arr); // [1, 2, 4, 0, 3]
+ * // arr[1] = -2 (smallest)
+ * // arr[2] = 0
+ * // arr[4] = 1
+ * // arr[0] = 5
+ * // arr[3] = 9 (largest)
+ * ```
+ *
+ * @remarks
+ * - Original array is not modified
+ * - Returns indices that would sort the array
+ * - Useful for maintaining correspondence with other arrays
+ */
+export function sort_indices(id, order = 'asc') {
+    // Create array of indices
+    const indices = Array.from({ length: id.length }, (_, i) => i);
+    // Sort indices based on values in original array
+    indices.sort((a, b) => {
+        if (order === 'asc') {
+            return id[a] - id[b];
+        }
+        else {
+            return id[b] - id[a];
+        }
+    });
+    return indices;
+}
+/**
+ * Standardize
+ *
+ * Returns an array of standardized elements (z-score normalization).
+ * Each element is transformed to (value - mean) / stddev.
+ *
+ * @param id - Array of numeric values
+ * @returns Array of standardized values (z-scores)
+ *
+ * @example
+ * ```typescript
+ * const arr = [1, 2, 3, 4, 5];
+ * const standardized = array.standardize(arr);
+ * // Mean = 3, StdDev ≈ 1.414
+ * // Result ≈ [-1.414, -0.707, 0, 0.707, 1.414]
+ * ```
+ *
+ * @remarks
+ * - Formula: z = (x - μ) / σ
+ * - Result has mean of 0 and standard deviation of 1
+ * - Returns array of NaN if standard deviation is 0
+ * - Useful for comparing values on different scales
+ */
+export function standardize(id) {
+    if (id.length === 0) {
+        return [];
+    }
+    const mean = avg(id);
+    const stdDev = stdev(id);
+    // If stddev is 0, all values are the same - return array of 0s or NaN
+    if (stdDev === 0) {
+        return id.map(() => NaN);
+    }
+    // Calculate z-score for each element
+    return id.map(value => (value - mean) / stdDev);
+}
+/**
+ * New Type (User-Defined Type Array)
+ *
+ * Creates a new array of user-defined type elements.
+ *
+ * @param size - Initial size of array (default: 0)
+ * @param initial_value - Initial value for all elements
+ * @returns New array of user-defined type
+ *
+ * @example
+ * ```typescript
+ * // NOTE: User-defined types (UDTs) are not fully supported yet
+ * // This is a placeholder for future implementation
+ * const arr = array.newtype<MyType>(5);
+ * ```
+ *
+ * @remarks
+ * - **⚠️ LIMITED SUPPORT**: User-defined types (UDTs) require a type system
+ *   that is not yet fully implemented in this library
+ * - This function currently works like `new_array<T>()` for basic types
+ * - Full UDT support will be added in a future version
+ * - See PineScript documentation for UDT usage patterns
+ */
+export function newtype(size = 0, initial_value) {
+    // For now, this is just an alias for new_array
+    // Full UDT support requires implementing the type system
+    return new_array(size, initial_value);
+}
+/**
+ * ⚠️ RENDERING FUNCTIONS NOT IMPLEMENTED
+ *
+ * The following array constructor functions are intentionally excluded
+ * because they create arrays for rendering objects, which are outside
+ * the scope of this calculation-focused library:
+ *
+ * - `new_box()` - Creates arrays of box drawing objects
+ * - `new_label()` - Creates arrays of label objects
+ * - `new_line()` - Creates arrays of line drawing objects
+ * - `new_linefill()` - Creates arrays of line fill objects
+ * - `new_table()` - Creates arrays of table layout objects
+ *
+ * **Design Constraint**: This library focuses on calculation and indicator
+ * functions only. Rendering, visualization, and UI functions require a
+ * rendering engine and are not included.
+ *
+ * If you need these functions, consider:
+ * 1. Using PineScript directly
+ * 2. Implementing a rendering layer separately
+ * 3. Using this library for calculations and another library for visualization
+ */
+//# sourceMappingURL=index.js.map