@hoox-sh/pynets 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-09-23
+
+`once` / multi-value `switch`, and a Python `Runtime.run` interpret parity slice (drawings, strategy fields, host helpers, TA/matrix). Compile emit for the TA/matrix/host names from that slice.
+
+### Added
+- `once [cond]` structure — parse / unparse / interpret / compile fire the body the first time the test is true (or bar 0 with no test), regen from PYNE grammar
+- multi-value `switch` arms (`1, 2 =>`) match any element on interpret and compile
+- `matrix.sum_row` / `sum_col`, `avg_*`, `min_*`, `max_*`, `mode_*`, `copy_row` / `copy_col`, `fill_row` / `fill_col` / `fill_diagonal`, `reverse_rows` / `reverse_cols`, `stdev`, `variance`
+- `ta.uo`, `ta.rci`, `ta.dpo`, `ta.kst`, `ta.stochrsi`, `ta.donchian`, `ta.ichimoku`, `ta.bb_pct`, `ta.emv`, `ta.fractal`, `ta.atr_stop`, `ta.zigzag` (interpret; v3/v4 bare aliases)
+- `timeframe.change`, `time_close`, `syminfo.prefix`, bare `round_to_mintick`, v4 `array.new*` constructors, `plotcandle` / `plotbar`
+- JS compile emit for those TA / matrix / host names so `compileToResult` matches interpret
+- Drawing getters/setters, `*.all`, `*.copy`, remaining deletes, `chart.point.*`, `line.fill`
+- `strategy.cash` is free cash (tagged for `default_qty_type`); trade-history fields; `oca` / `direction` / `commission` constants; zero-arg `strategy.netprofit()` calls
+- `timenow`, `max_bars_back`, `alertcondition`, `plot.linestyle_*`, bare `random`, bare `security` / `security_lower_tf`
+- `FunctionDef.returns` — UDF/method return types survive parse → unparse (`int ilog2(...)`)
+- `Runtime.run(..., timeout_seconds)` — interpret wall-clock circuit breaker (every 32 bars); `timed_out` + `error_kind=runtime`
+- `Runtime.run(..., libraries=[{namespace, name, version, source}])` — same list shape as Python `Runtime.run`
+- `Type.new(...)` positional args fill fields in declaration order (kwargs still override)
+- `ta.vpt` / `vpt` alias of `ta.pvt` (Python `ta.pvt` / `ta.vpt` cumulative)
+- `strategy.exit` pending stop/limit/trail, tick `profit`/`loss`, `qty_percent`, `from_entry`; `trail_points=0`/`na` does not disable `trail_offset`
+- UDT array cells; `array.sort` / `binary_search*` `sort_field` (default `0` on UDT arrays)
+- Incremental `ta.cmf` / `ta.klinger`; `ta.wad` volume-scaled; `ta.wvad` is WAD / rolling volume
+- ASDL `AugAssign`, `Qualify`/`Specialize`, bitwise/shift (`& | ^ << >>`)
+- Incremental interpret `ta.ao` / `ta.aroon` (SMA(hl2,5)−SMA(hl2,34); Aroon pair, ties keep oldest)
+
+### Changed
+- Parser regen from PYNE 0.3.11: left-factored typed names; bare `x =` is `Assign`; `=` reassignment only on attribute/subscript
+- Compile `strategy.exit` uses `placeExit` (trail / ticks / `qty_percent` / `from_entry`)
+- Compile arrays keep UDT/object cells; `sort` / `binary_search*` pass `sort_field`
+- Compile `ta.wad` / `ta.wvad` / `ta.cmf` / `ta.klinger` match interpret kernels
+- Compile emit bitwise/shift, `AugAssign`, and zero-arg `ta.*` attributes
+- Interpret `order.ascending` / `order.descending` (1 / -1)
+- Interpret `plot(ta.wvad)` / `plot(ta.cmf)` as the 0-arg forms (period 20)
+- `matrix.sort` / `matrix.sort_indices` take `sort_field`; UDT cells allowed
+- Pine namespace constants (`order`/`format`/`display`/`shape`/`dayofweek`/`month`/…) on interpret and compile
+- Compile matrix UDT cells and `matrix.sort_indices`
+- Interpret `strategy(..., avg_price_model=, leverage=)` plus `strategy.leverage` / liquidation price
+- Compile `strategy(...)` folds `leverage` / `avg_price_model` / default qty / margins; `strategy.leverage` / `position_avg_price` / `margin_liquidation_price`; omitted entry qty uses `resolveDefaultQty`; close passes qty
+
 ## [0.2.0] - 2026-08-16
 
 JS compile backend (`mode: "compile" | "auto"`). Interpret unchanged.

package/README.md

@@ -1,5 +1,11 @@
 # PyneTS
 
+[![CI](https://img.shields.io/github/actions/workflow/status/hoox-sh/pynets/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/hoox-sh/pynets/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/hoox-sh/pynets/graph/badge.svg)](https://codecov.io/gh/hoox-sh/pynets)
+[![npm](https://img.shields.io/npm/v/@hoox-sh/pynets?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@hoox-sh/pynets)
+[![License](https://img.shields.io/github/license/hoox-sh/pynets?style=flat-square)](LICENSE)
+[![Bun](https://img.shields.io/badge/Bun-1.4-000000?style=flat-square&logo=bun&logoColor=white)](https://bun.sh)
+
 TypeScript / Bun library for **Pine Script**: parse, unparse, and interpret.
 
 <p align="center">
@@ -9,6 +15,8 @@ TypeScript / Bun library for **Pine Script**: parse, unparse, and interpret.
 Same public names as Python [`pynescript`](https://github.com/hoox-sh/pyne): `parse`, `unparse`, `Runtime.run`.
 Python `pynescript.runtime` is the **source of truth**. When semantics disagree, Python wins. This is not a TradingView platform certification.
 
+**Docs (hoox.sh):** [PyneTS](https://hoox.sh/pyne/docs/pynets) · [install](https://hoox.sh/pyne/docs/pynets/install) · [runtime](https://hoox.sh/pyne/docs/pynets/runtime) · [CLI](https://hoox.sh/pyne/docs/pynets/cli) · [JS compile](https://hoox.sh/pyne/docs/pynets/compile) · [parity](https://hoox.sh/pyne/docs/pynets/parity) · [ecosystem](https://hoox.sh/pyne/docs/reference/ecosystem)
+
 ```ts
 import { parse, unparse, Runtime } from "@hoox-sh/pynets";
 
@@ -81,15 +89,16 @@ Most TypeScript Pine ports rewrite the language. PyneTS does not. It is the libr
 
 Family map — library vs edge host, same SoT:
 
-| | [pynescript](https://github.com/hoox-sh/pyne) | [pyne-worker](https://github.com/hoox-sh/pyne-worker) | **PyneTS** |
-|---|---|---|---|
-| Role | SoT library | Production **Python** Cloudflare Worker | TS / Bun library + CLI |
-| Engine | interpret + Numba compile | Vendors `pynescript.runtime` | interpret + **JS compile** |
-| Grammar | `*.g4` | Same Python engine (not a fork) | **same `.g4`**, TS ANTLR target |
-| How you call it | `Runtime.run` | `POST /run` (`interpret` / `compile` / `auto`) | `Runtime.run` (`interpret` / `compile` / `auto`) |
-| Extra | LSP, Pro API | R2 OHLCV, 1m cron, alerts, trade-worker | Local TTY (`check` / `format` / `run` / `dump`) |
+| | [pynescript](https://github.com/hoox-sh/pyne) | [pyne-worker](https://github.com/hoox-sh/pyne-worker) | [pyne-agent-worker](https://github.com/hoox-sh/pyne-agent-worker) | **PyneTS** |
+|---|---|---|---|---|
+| Role | SoT library | Production **Python** Cloudflare Worker | NL **authoring** (Workers AI™) | TS / Bun library + CLI |
+| Engine | interpret + Numba compile | Vendors `pynescript.runtime` | Writes source; optional `/run` validate | interpret + **JS compile** |
+| Grammar | `*.g4` | Same Python engine (not a fork) | — | **same `.g4`**, TS ANTLR target |
+| How you call it | `Runtime.run` | `POST /run` | `POST /v1/chat` | `Runtime.run` (`interpret` / `compile` / `auto`) |
+| Extra | LSP, Pro API | R2 OHLCV, 1m cron, alerts, trade-worker | AXIS plugin | Local TTY (`check` / `format` / `run` / `dump`) |
+| Docs | [hoox.sh/pyne/docs](https://hoox.sh/pyne/docs) | [pyne-worker](https://hoox.sh/pyne/docs/pyne-worker) | [agent](https://hoox.sh/pyne/docs/agent) | [pynets](https://hoox.sh/pyne/docs/pynets) |
 
-[pyne-worker](https://github.com/hoox-sh/pyne-worker) is the edge evaluate host of the **Python** engine. PyneTS is the TypeScript library you import and the CLI you run on a laptop. They share the PYNE contract; this repo is not a Worker.
+[pyne-worker](https://github.com/hoox-sh/pyne-worker) is the edge evaluate host of the **Python** engine. [pyne-agent-worker](https://github.com/hoox-sh/pyne-agent-worker) writes scripts. PyneTS is the TypeScript library you import and the CLI you run on a laptop. They share the PYNE contract; this repo is not a Worker.
 
 This repository is the standalone `@hoox-sh/pynets` checkout. PYNE consumes it **only** as the `pynets/` git submodule — never copy sources back into `hoox-sh/pyne`.