pinets 0.7.8 → 0.8.0

package/README.md

@@ -1,335 +1,394 @@
-[![npm version](https://img.shields.io/npm/v/pinets.svg?style=flat-square)](https://www.npmjs.com/package/pinets)
-[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=flat-square)](https://opensource.org/licenses/AGPL-3.0)
-[![Coverage](./.github/badges/coverage.svg)](./.github/badges/coverage.svg)
-[![Documentation](https://img.shields.io/badge/docs-github--pages-blue?style=flat-square)](https://quantforgeorg.github.io/PineTS/)
-[![Reddit](https://img.shields.io/reddit/subreddit-subscribers/QuantForge?style=flat-square&logo=reddit)](https://www.reddit.com/r/QuantForge/)
+<p align="center">
+  <img src="./.github/images/banner.png" alt="PineTS" />
+</p>
+
+<p align="center">
+  <strong>Run Pine Script Anywhere</strong><br>
+  Execute TradingView indicators in Node.js, browsers, and any JavaScript runtime
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/pinets"><img src="https://img.shields.io/npm/v/pinets.svg?style=flat-square" alt="npm version"></a>
+  <a href="https://opensource.org/licenses/AGPL-3.0"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=flat-square" alt="License"></a>
+  <a href="./.github/badges/coverage.svg"><img src="./.github/badges/coverage.svg" alt="Coverage"></a>
+  <a href="https://quantforgeorg.github.io/PineTS/"><img src="https://img.shields.io/badge/docs-github--pages-blue?style=flat-square" alt="Documentation"></a>
+  <a href="https://www.reddit.com/r/QuantForge/"><img src="https://img.shields.io/reddit/subreddit-subscribers/QuantForge?style=flat-square&logo=reddit" alt="Reddit"></a>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#features">Features</a> •
+  <a href="#live-demos">Live Demos</a> •
+  <a href="#usage">Usage</a> •
+  <a href="#api-coverage">API Coverage</a> •
+  <a href="#documentation">Docs</a>
+</p>
 
 ---
 
-**PineTS** is a JavaScript/TypeScript runtime that enables execution of Pine Script indicators in JavaScript environments. It supports two input formats:
+## What is PineTS?
 
-1. **Native Pine Script v5/v6** _(experimental)_ - Run original Pine Script code directly
-2. **PineTS Syntax** - A JavaScript/TypeScript syntax that closely mirrors Pine Script
+**PineTS** is an open-source transpiler and runtime that brings Pine Script to JavaScript. Write indicators once, run them anywhere : on your own servers, in the browser, or embedded in your trading applications.
 
-This makes it possible to run Pine Script indicators in Node.js, browsers, and other JavaScript runtimes without modification or with minimal conversion effort.
-
-> _Disclaimer : PineTS is an independent project and is not affiliated with, endorsed by, or associated with TradingView or Pine Script™. All trademarks and registered trademarks mentioned belong to their respective owners._
-
-## Overview
-
-PineTS is a runtime + transpiler that converts Pine Script (or PineTS syntax) into executable JavaScript. It preserves the original functionality and behavior while providing robust handling of time-series data processing, technical analysis calculations, and Pine Script's distinctive scoping mechanisms.
-
-### Input Format Support
-
--   **Native Pine Script** _(experimental)_: Run original Pine Script v5 and v6 indicators directly. Note that some indicators may fail if they use Pine Script API features not yet implemented in PineTS. Check the [API coverage badges](#pine-script-api-coverage) below to verify compatibility.
--   **PineTS Syntax**: A JavaScript/TypeScript syntax that mirrors Pine Script closely, requiring minimal conversion effort from original Pine Script code.
-
-## See it in action
-
-Bellow are two ports of Pine Script indicators running in the browser.
-PineTS is used to generate plot data, and tradingview light weight chart is used to display the plot.
-
--   [Williams Vix Fix](https://quantforgeorg.github.io/PineTS/indicators/willvixfix/)
--   [Squeeze Momentum](https://quantforgeorg.github.io/PineTS/indicators/sqzmom/)
+```javascript
+import { PineTS, Provider } from 'pinets';
 
-## Key Features
+const pineTS = new PineTS(Provider.Binance, 'BTCUSDT', '1h', 100);
 
--   **Native Pine Script Support**: Run original Pine Script v5/v6 code directly _(experimental)_
--   **Dual Input Format**: Support for both native Pine Script and PineTS syntax
--   **High Precision**: Aims for the same precision as Pine Script (up to the 8th digit)
--   **Time-Series Processing**: Handles historical data and series operations
--   **Technical Analysis Functions**: Comprehensive set of 60+ TA indicators and calculations
--   **Mathematical Operations**: Advanced mathematical functions and precision handling
--   **Input Management**: Flexible parameter and input handling system
--   **Context Management**: Maintains proper scoping and variable access rules
--   **Runtime Transpilation**: Converts code to executable JavaScript at runtime without pre-compilation
+// Run native Pine Script directly
+const { plots } = await pineTS.run(`
+//@version=5
+indicator("EMA Cross")
+plot(ta.ema(close, 9), "Fast", color.blue)
+plot(ta.ema(close, 21), "Slow", color.red)
+`);
+```
 
-## Core Components
+> _**Disclaimer** : PineTS is an independent project and is not affiliated with, endorsed by, or associated with TradingView or Pine Script™. All trademarks and registered trademarks mentioned belong to their respective owners._
 
-### PineTS Class
+---
 
-The main class that handles:
+## Why PineTS?
 
--   Market data management
--   Series calculations
--   Built-in variables (open, high, low, close, volume, etc.)
--   Runtime execution context
+| Challenge                                   | PineTS Solution                                      |
+| ------------------------------------------- | ---------------------------------------------------- |
+| Pine Script only runs on TradingView        | Run indicators on your own infrastructure            |
+| Can't integrate indicators with custom apps | Full JavaScript/TypeScript integration               |
+| Limited to TradingView's data sources       | Use any data source (Binance, custom APIs, CSV)      |
+| No programmatic access to indicator values  | Get raw values for backtesting, alerts, ML pipelines |
+| Can't run indicators server-side            | Works in Node.js, Deno, Bun, browsers                |
 
-### Namespaces
+---
 
--   **Core**: Essential Pine Script functionality and base operations
--   **TechnicalAnalysis**: Comprehensive set of technical indicators and analysis functions
--   **PineMath**: Mathematical operations and precision handling
--   **Input**: Parameter and input management system
--   **Syminfo**: Symbol information and market data helpers
+## Quick Start
 
-## Installation
+### Installation
 
 ```bash
 npm install pinets
 ```
 
-## Usage Examples
-
-### Streaming Data
-
-PineTS provides a convenient event-based interface for streaming live data:
+### Hello World
 
 ```javascript
 import { PineTS, Provider } from 'pinets';
 
-const pineTS = new PineTS(Provider.Binance, 'BTCUSDT', '1m');
-
-// Start streaming with 1 second interval
-const evt = pineTS.stream(
-    indicator,
-    //assuming that indicator is a pine source code or pineTS function
-    {
-        pageSize: 10,
-        live: true,
-        interval: 1000,
-    }
-);
+// Initialize with Binance data
+const pineTS = new PineTS(Provider.Binance, 'BTCUSDT', '1h', 100);
 
-evt.on('data', (ctx) => {
-    console.log('Update:', ctx.result.close);
-});
+// Calculate a simple moving average
+const { plots } = await pineTS.run(`
+//@version=5
+indicator("My First Indicator")
+sma20 = ta.sma(close, 20)
+plot(sma20, "SMA 20")
+`);
 
-// See documentation for full details
+console.log('SMA values:', plots['SMA 20'].data);
 ```
 
-### Option 1: Run Native Pine Script Directly _(Experimental)_
+**That's it!** You're running Pine Script in JavaScript.
 
-Starting with v0.7.0, you can run original Pine Script code directly:
+---
 
-```javascript
-import { PineTS, Provider } from 'pinets';
+## Features
 
-// Initialize with market data
-const pineTS = new PineTS(Provider.Binance, 'BTCUSDT', 'D', 100);
+### Core Capabilities
 
-// Run native Pine Script directly
-const pineScriptCode = `
-//@version=5
-indicator('My EMA Cross Strategy')
+-   **Native Pine Script v5/v6** : Run original TradingView code directly _(experimental)_
+-   **60+ Technical Indicators** : SMA, EMA, RSI, MACD, Bollinger Bands, and more
+-   **Time-Series Processing** : Full Pine Script semantics with lookback support
+-   **Real-time Streaming** : Live data processing with event-based updates
+-   **Multi-Timeframe Analysis** : `request.security()` for MTF indicators
+-   **High Precision** : Matches TradingView's calculation precision
+
+### Two Ways to Write Indicators
 
-ema9 = ta.ema(close, 9)
-ema18 = ta.ema(close, 18)
+<table width="100%">
+<tr>
+<th>Native Pine Script</th>
+<th>PineTS Syntax (JavaScript)</th>
+</tr>
+<tr>
+<td>
 
-bull_bias = ema9 > ema18
-bear_bias = ema9 < ema18
+```pinescript
+//@version=5
+indicator("RSI Strategy")
 
-plot(ema9, title = '9 EMA', color = color.yellow)
-plot(ema18, title = '18 EMA', color = color.red)
-`;
+rsi = ta.rsi(close, 14)
+sma = ta.sma(rsi, 10)
 
-const { plots } = await pineTS.run(pineScriptCode);
-//access ema9 and ema18 plots data
+plot(rsi, "RSI")
+plot(sma, "Signal")
 ```
 
-> **⚠️ Note**: Native Pine Script support is experimental. Some indicators may fail if they use API features not yet implemented. Refer to the [API coverage badges](#pine-script-api-coverage) to check compatibility.
-
-### Option 2: Use PineTS Syntax
+</td>
+<td>
 
-PineTS syntax is a JavaScript/TypeScript version of Pine Script with minimal differences:
+```javascript
+//@PineTS
+indicator('RSI Strategy');
 
-#### Converting Pine Script to PineTS
+const rsi = ta.rsi(close, 14);
+const sma = ta.sma(rsi, 10);
 
-Original Pine Script:
+plot(rsi, 'RSI');
+plot(sma, 'Signal');
+```
 
-<table width="100%">
-<tr>
-<td>
+</td>
+</tr>
+</table>
 
-```pinescript
-/*==[ Original Pine Script ]==*/
+---
 
-//@version=5
-indicator('My EMA Cross Strategy');
+## Live Demos
 
-ema9 = ta.ema(close, 9);
-ema18 = ta.ema(close, 18);
+See PineTS in action with these browser-based examples:
 
-bull_bias = ema9 > ema18;
-bear_bias = ema9 < ema18;
+-   **[Williams Vix Fix](https://quantforgeorg.github.io/PineTS/indicators/willvixfix/)** : Volatility-based indicator
+-   **[Squeeze Momentum](https://quantforgeorg.github.io/PineTS/indicators/sqzmom/)** : Momentum oscillator
+-   **[Playground](https://quantforge.org/playground/)** : Test your own Pine Script code
 
-prev_close = close[1];
-diff_close = close - prev_close;
+_Demos are Built with PineTS + [QFChart](https://github.com/QuantForgeOrg/QFChart)_
 
-_oo = open;
-_oo = math.abs(open[1] - close[2]);
+---
 
-// plot ema's
-plot(ema9, title = '9 EMA', color = color.yellow)
-plot(ema18, title = '18 EMA', color = color.red)
-```
+## Usage
 
-</td>
-<td>
+### Running Native Pine Script
 
 ```javascript
-/*==[ Equivalent PineTS ]==*/
-
-//
-indicator('My EMA Cross Strategy');
+import { PineTS, Provider } from 'pinets';
 
-let ema9 = ta.ema(close, 9);
-let ema18 = ta.ema(close, 18);
+const pineTS = new PineTS(Provider.Binance, 'BTCUSDT', 'D', 200);
 
-let bull_bias = ema9 > ema18;
-let bear_bias = ema9 < ema18;
+const { plots } = await pineTS.run(`
+//@version=5
+indicator("MACD", overlay=false)
 
-let prev_close = close[1];
-let diff_close = close - prev_close;
+[macdLine, signalLine, hist] = ta.macd(close, 12, 26, 9)
 
-let _oo = open;
-_oo = math.abs(open[1] - close[2]);
+plot(macdLine, "MACD", color.blue)
+plot(signalLine, "Signal", color.orange)
+plot(hist, "Histogram", color.gray, style=plot.style_histogram)
+`);
 
-// plot ema's
-plot(ema9, { title: '9 EMA', color: color.yellow });
-plot(ema18, { title: '18 EMA', color: color.red });
+// Access the calculated values
+console.log('MACD Line:', plots['MACD'].data);
+console.log('Signal Line:', plots['Signal'].data);
 ```
 
-</td>
-</tr>
-</table>
-
-### Running PineTS Code
+### Using PineTS Syntax
 
 ```javascript
 import { PineTS, Provider } from 'pinets';
 
-// Initialize with market data
-const pineTS = new PineTS(Provider.Binance, 'BTCUSDT', 'D', 100);
-
-// Run your indicator
-const { result } = await pineTS.run((context) => {
-    const { ta, math } = context;
-    const { close, open } = context.data;
+const pineTS = new PineTS(Provider.Binance, 'ETHUSDT', '4h', 100);
 
-    let ema9 = ta.ema(close, 9);
-    let ema18 = ta.ema(close, 18);
+const { plots } = await pineTS.run(($) => {
+    const { close, high, low } = $.data;
+    const { ta, plot, plotchar } = $.pine;
 
-    let bull_bias = ema9 > ema18;
-    let bear_bias = ema9 < ema18;
+    // Calculate indicators
+    const ema9 = ta.ema(close, 9);
+    const ema21 = ta.ema(close, 21);
+    const atr = ta.atr(14);
 
-    let prev_close = close[1];
-    let diff_close = close - prev_close;
+    // Detect crossovers
+    const bullish = ta.crossover(ema9, ema21);
+    const bearish = ta.crossunder(ema9, ema21);
 
-    let _oo = open;
-    _oo = math.abs(open[1] - close[2]);
+    // Plot results
+    plot(ema9, 'Fast EMA');
+    plot(ema21, 'Slow EMA');
+    plotchar(bullish, 'Buy Signal');
+    plotchar(bearish, 'Sell Signal');
 
-    return { ema9, ema18, bull_bias, bear_bias };
+    return { ema9, ema21, atr, bullish, bearish };
 });
 ```
 
-> **📖 For detailed documentation on initialization options, parameters, and advanced usage, see the [Initialization and Usage Guide](https://quantforgeorg.github.io/PineTS/initialization-and-usage/)**
-
-## Key Differences: PineTS Syntax vs Native Pine Script
+### Real-time Streaming
 
-When using **PineTS syntax** (not native Pine Script), note these differences:
-
-1. **Variable Declaration**: Use JavaScript's `const`, `let`, and `var` instead of Pine Script's implicit declaration
-2. **Function Syntax**: JavaScript arrow functions and standard function syntax
-3. **Module System**: Import Pine Script namespaces from context: `const { ta } = context; const { close, open } = context.data;`
-4. **Object Syntax**: Use JavaScript object notation for parameters: `plot(ema9, { title: '9 EMA', color: color.yellow })`
-5. **Scoping Rules**: Maintains Pine Script's series behavior through runtime transformation
-6. **Return Syntax**: Can return an object with indicator results for easy access in JavaScript
+```javascript
+import { PineTS, Provider } from 'pinets';
 
-When using **Native Pine Script**, write code exactly as you would in TradingView - no conversion needed!
+const pineTS = new PineTS(Provider.Binance, 'BTCUSDT', '1m');
 
-## Project Goals
+const stream = pineTS.stream(
+    `
+    //@version=5
+    indicator("Live RSI")
+    plot(ta.rsi(close, 14), "RSI")
+    `,
+    { live: true, interval: 1000 }
+);
 
-PineTS aims for **full coverage** of Pine Script functions and capabilities to enable seamless execution of Pine Script indicators in JavaScript environments.
+stream.on('data', (ctx) => {
+    const rsi = ctx.plots['RSI'].data.slice(-1)[0].value;
+    console.log(`RSI: ${rsi.toFixed(2)}`);
 
-**Current Status (v0.7.3)**:
+    if (rsi < 30) console.log('Oversold!');
+    if (rsi > 70) console.log('Overbought!');
+});
 
--   ✅ **Native Pine Script Support (Experimental)**: Run original Pine Script v5/v6 code directly
--   ✅ **PineTS Runtime Transpiler**: Convert PineTS syntax to executable JavaScript
--   ✅ **Core Pine Script API**: ~75% coverage of built-in functions and variables
--   ✅ **Series and Scope Management**: Full Pine Script semantics preserved
--   ✅ **Technical Analysis**: 60+ indicators and analysis functions
--   ✅ **Mathematical Operations**: Comprehensive math functions
--   ✅ **Data Structures**: Arrays and Matrices (90+ operations)
--   ✅ **Input System**: Dynamic parameter handling
--   ✅ **Plot Data Management**: Multi-series plotting support
--   ✅ **Real-time Execution**: Live data processing capability
--   ✔️🚧 **Market Data Providers**: Binance supported (more coming soon)
--   ✅ **Visualization**: Interactive charting ==> handled in [QFChart](https://github.com/QuantForgeOrg/QFChart)
--   🚧 **Caching System**: Script and market data optimization (in progress)
--   🎯 **Strategy Execution**: Backtesting and live trading (planned)
+stream.on('error', (err) => console.error('Stream error:', err));
+```
 
-> **⚠️ API Coverage**: While PineTS supports native Pine Script execution, not all Pine Script API features are implemented yet. Check the [API coverage badges](#pine-script-api-coverage) below to verify if specific functions are available. Indicators using unimplemented features will fail with descriptive error messages.
+### Custom Data Source
 
-## Technical Details
+```javascript
+import { PineTS } from 'pinets';
 
-The library uses a dual-layer transpilation system:
+// Your own OHLCV data
+const candles = [
+    { open: 100, high: 105, low: 99, close: 103, volume: 1000, openTime: 1704067200000 },
+    { open: 103, high: 108, low: 102, close: 107, volume: 1200, openTime: 1704153600000 },
+    // ... more candles
+];
 
-### Pine Script Parser _(v0.7.0+, Experimental)_
+const pineTS = new PineTS(candles);
 
--   Automatically detects Pine Script v5 and v6 code
--   Converts native Pine Script syntax to PineTS intermediate representation
--   Preserves Pine Script semantics and behavior
+const { plots } = await pineTS.run(`
+//@version=5
+indicator("Custom Data")
+plot(ta.sma(close, 10))
+`);
+```
 
-### Runtime Transpiler
+---
 
--   Transforms PineTS source (or converted Pine Script) to handle time-series data
--   Manages variable scoping and context
--   Handles array indexing and series operations
--   Provides Pine Script-compatible function calls
--   Executes in real-time without pre-compilation
-    ==> The resulting code is a low level javascript that allows handling the complex structures and specificities of PineScript
+## API Coverage
 
-### Pine Script API Coverage
+PineTS aims for complete Pine Script API compatibility. Current status:
 
-#### Data
+### Data & Context
 
 [![syminfo](./.github/badges/api-syminfo.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/syminfo.html)
-[![session](./.github/badges/api-session.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/session.html)
-[![timeframe](./.github/badges/api-timeframe.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/timeframe.html)
 [![barstate](./.github/badges/api-barstate.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/barstate.html)
+[![timeframe](./.github/badges/api-timeframe.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/timeframe.html)
 [![ticker](./.github/badges/api-ticker.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/ticker.html)
 [![builtin](./.github/badges/api-builtin.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/builtin.html)
+[![session](./.github/badges/api-session.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/session.html)
 
-#### Calculation
+### Technical Analysis & Math
 
 [![ta](./.github/badges/api-ta.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/ta.html)
 [![math](./.github/badges/api-math.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/math.html)
+[![request](./.github/badges/api-request.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/request.html)
+[![input](./.github/badges/api-input.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/input.html)
+
+### Data Structures
+
 [![array](./.github/badges/api-array.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/array.html)
-[![map](./.github/badges/api-map.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/map.html)
 [![matrix](./.github/badges/api-matrix.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/matrix.html)
-[![request](./.github/badges/api-request.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/request.html)
+[![map](./.github/badges/api-map.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/map.html)
 [![types](./.github/badges/api-types.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/types.html)
-[![strategy](./.github/badges/api-strategy.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/strategy.html)
-[![input](./.github/badges/api-input.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/input.html)
 
-#### Visualization
+### Visualization
 
-[![color](./.github/badges/api-color.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/color.html)
 [![plots](./.github/badges/api-plots.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/plots.html)
+[![color](./.github/badges/api-color.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/color.html)
 [![chart](./.github/badges/api-chart.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/chart.html)
 [![label](./.github/badges/api-label.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/label.html)
 [![line](./.github/badges/api-line.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/line.html)
-[![polyline](./.github/badges/api-polyline.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/polyline.html)
 [![box](./.github/badges/api-box.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/box.html)
 [![table](./.github/badges/api-table.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/table.html)
 [![linefill](./.github/badges/api-linefill.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/linefill.html)
+[![polyline](./.github/badges/api-polyline.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/polyline.html)
 
-#### Logging
+### Utilities
 
-[![log](./.github/badges/api-log.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/log.html)
 [![str](./.github/badges/api-str.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/str.html)
+[![log](./.github/badges/api-log.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/log.html)
+[![strategy](./.github/badges/api-strategy.svg)](https://quantforgeorg.github.io/PineTS/api-coverage/strategy.html)
+
+> Click any badge to see detailed function-level coverage
+
+---
+
+## Documentation
+
+-   **[Full Documentation](https://quantforgeorg.github.io/PineTS/)** — Complete guides and API reference
+-   **[Initialization Guide](https://quantforgeorg.github.io/PineTS/initialization-and-usage/)** — Setup options and configuration
+-   **[Architecture Overview](https://quantforgeorg.github.io/PineTS/architecture/)** — How PineTS works internally
+-   **[API Coverage Details](https://quantforgeorg.github.io/PineTS/api-coverage/)** — Function-by-function compatibility
+
+---
+
+## Use Cases
+
+**Algorithmic Trading**
+
+-   Build custom trading bots using Pine Script strategies
+-   Integrate indicators with your execution systems
+
+**Backtesting**
+
+-   Test Pine Script strategies against historical data
+-   Export indicator values for analysis in Python/R
+
+**Alert Systems**
+
+-   Create custom alert pipelines based on indicator signals
+-   Monitor multiple assets with server-side indicator calculations
+
+**Research & Analysis**
+
+-   Process large datasets with Pine Script indicators
+-   Feed indicator outputs into machine learning models
+
+**Custom Dashboards**
+
+-   Embed live indicators in web applications
+-   Build real-time monitoring dashboards
+
+---
+
+## Roadmap
+
+| Status | Feature                                   |
+| ------ | ----------------------------------------- |
+| ✅     | Native Pine Script v5/v6 support          |
+| ✅     | 60+ technical analysis functions          |
+| ✅     | Arrays, matrices, and maps                |
+| ✅     | Real-time streaming                       |
+| ✅     | Multi-timeframe with `request.security()` |
+| 🚧     | Strategy backtesting engine               |
+| 🚧     | Additional data providers                 |
+| 🎯     | Pine Script v6 full compatibility         |
+| 🎯     | Market data Providers                     |
+| 🎯     | Trading Connectors                        |
+
+---
+
+## Related Projects
+
+-   **[QFChart](https://github.com/QuantForgeOrg/QFChart)** : Charting library optimized for PineTS visualization
 
 ---
 
 ## Contributing
 
-Contributions are welcome! Please feel free to submit pull requests, create issues, or suggest improvements.
+Contributions are welcome! Whether it's:
+
+-   Adding missing Pine Script functions
+-   Improving documentation
+-   Fixing bugs
+-   Suggesting features
+
+Please feel free to open issues or submit pull requests.
+
+---
 
 ## License
 
-This project is open-source and available under the AGPL License.
+AGPL-3.0 - See [LICENSE](LICENSE) for details.
 
-## Disclaimer
+---
 
-PineTS is an independent project and is not affiliated with, endorsed by, or associated with TradingView or Pine Script. All trademarks and registered trademarks mentioned belong to their respective owners.
+<p align="center">
+  <sub>Built with passion by <a href="https://quantforge.org">QuantForge</a></sub>
+</p>