Update readme, documentation and changelog

Author: alaa-eddine

CHANGELOG.md

@@ -1,5 +1,29 @@
 # Change Log
 
+## [0.5.0] - 2025-12-04 - Extensive TA implementation & Transpiler enhancements
+
+### Added
+
+-   Comprehensive implementation of `ta` namespace methods:
+    -   **Trend**: `supertrend`, `dmi`, `sar`, `falling`, `rising`, `cross`
+    -   **Volatility/Range**: `bb` (Bollinger Bands), `bbw`, `kc` (Keltner Channels), `kcw`, `range`, `tr` (True Range as method)
+    -   **Volume**: `accdist`, `cum`, `iii`, `nvi`, `pvi`, `pvt`, `wad`, `wvad`
+    -   **Oscillators**: `cci`, `cmo`, `cog`, `mfi`, `stoch`, `tsi`, `wpr`
+    -   **Statistical/Rank**: `correlation`, `barssince`, `valuewhen`, `percentrank`, `percentile_linear_interpolation`, `percentile_nearest_rank`, `mode`, `highestbars`, `lowestbars`
+-   Core `bar_index` variable support
+
+### Changed
+
+-   **Unified Namespace Architecture**: All namespace members (e.g., `ta.tr`, `ta.obv`) are now implemented as methods. The transpiler automatically handles the conversion from property access to method call (e.g., `ta.tr` → `ta.tr()`)
+-   Updated `ta.tr` and `ta.obv` to align with the unified method pattern
+
+### Fixed
+
+-   **`var` keyword semantics**: Implemented correct Pine Script behavior for `var` variables (initialize once, persist state across bars) via `$.initVar`
+-   `math.sum` handling of `NaN` values
+-   Transpiler handling of tertiary conditions involving Series access
+-   `ta.supertrend` calculation logic
+
 ## [0.4.0] - TBD - Request.security implementation and transpiler enhancements
 
 ### Added

README.md

@@ -28,6 +28,7 @@ PineTS is used to generate plot data, and tradingview light weight chart is used
 ## Key Features
 
 -   **Pine Script Compatibility**: Supports Pine Script v5+ syntax and functionality
+-   **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 TA indicators and calculations
 -   **Mathematical Operations**: Advanced mathematical functions and precision handling
@@ -156,6 +157,8 @@ const { result } = await pineTS.run((context) => {
 
 ## Project Goals
 
+PineTS aims for **full coverage** of Pine Script functions and capabilities. The ultimate goal is to enable running **original Pine Script code directly** without manual conversion to PineTS syntax.
+
 -   Runtime Transpiler
 -   Core Pine Script functions and variables
 -   Series and scope management

docs/api-coverage/ta.md

@@ -108,7 +108,7 @@ All functions listed below are verified to exist in Pine Script v5.
 
 | Function         | Status | Description              |
 | ---------------- | ------ | ------------------------ |
-| `ta.valuewhen()` | ⬜     | Value When Condition Met |
+| `ta.valuewhen()` | ✅     | Value When Condition Met |
 | `ta.barssince()` | ✅     | Bars Since Condition     |
 | `ta.cum()`       | ✅     | Cumulative Sum           |
 

package.json

@@ -1,6 +1,6 @@
 {
     "name": "pinets",
-    "version": "0.4.0",
+    "version": "0.5.0",
     "description": "",
     "main": "dist/pinets.dev.es.js",
     "types": "dist/types/index.d.ts",

src/namespaces/ta/methods/valuewhen.ts

@@ -18,7 +18,7 @@ export function valuewhen(context: any) {
             };
         }
         const state = context.taState[stateKey];
-        
+
         const cond = Series.from(condition).get(0);
         const val = Series.from(source).get(0);
         const occurrence = Series.from(_occurrence).get(0);
@@ -32,18 +32,17 @@ export function valuewhen(context: any) {
         }
 
         const index = state.values.length - 1 - occurrence;
-        
+
         if (index < 0) {
             return NaN;
         }
 
         const result = state.values[index];
-        
+
         // Check if result is a number to apply precision, else return as is (e.g. boolean/color)
         if (typeof result === 'number') {
             return context.precision(result);
         }
         return result;
     };
 }
-