@hoox-sh/pynets 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -7,6 +7,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.10.0] - 2026-11-04
+
+Multi-tick realtime windows, reference `varip`, and list subscripts.
+
+### Added
+- `RuntimeOptions.realtimeTicks` / `realtimeBars` / `realtimeFromBar` — Python `realtime_ticks` / `realtime_bars` / `realtime_from_bar` realtime windows with `_resolve_realtime_first` precedence (`realtimeFromBar` > `realtimeBars` > last-bar flags).
+- Per-tick rollback for intermediate realtime ticks: `var` scope, container contents (array/map/UDT/matrix, in place so aliases keep identity), UDF-site `var` state and series pushes, plot cells, TA windows, and broker state — matching Python `_run_batch`.
+- `barstate.isnew` is `0` after the first realtime tick; `barstate.isconfirmed` is `0` on intermediate ticks; `once` and `alert.freq_once_per_bar_close` commit on confirmed bars only, `alert.freq_all` fires every tick.
+- List subscript `g[0]` on array-valued names (Python `visit_Subscript` newest-first semantics: `value[-(offset + 1)]`, OOB → na), on both interpret and JS compile, for names bound from `ta.gamma_levels`, `array.from`, `array.new*`, `array.copy`, `array.concat`, `array.slice`.
+- `TaEngine.snapshot`/`restore`, `StrategyBook.snapshot`/`restore`, and `snapshotContents`/`restoreContents`/`clone` on `PineArray`/`PineMap`/`UdtInstance`/`PineMatrix`; `PineSeries.truncate`; shared `cloneValue`.
+- Exported `resolveRealtimeWindow`.
+
+### Fixed
+- `varip` now initializes once and persists across historical bars (previously re-initialized every bar like a plain assignment), and re-runs its initializer on every realtime tick (reference `varip`) — matching Python `visit_Assign` `ast.VarIp` handling.
+
+## [0.9.0] - 2026-11-04
+
+Realtime stream session API and forming-bar semantics.
+
+### Added
+- `RuntimeStream.updateLastBar(bar)` — re-tick the forming last bar without advancing `barCount`; `once`, TA state, and broker fills recompute from the revised history.
+- `RuntimeStream.appendBars(bars)` and `RuntimeStream.barCount`.
+- `RuntimeOptions.realtimeLastBar` / `Runtime.run(..., { realtimeLastBar: true })` — last bar sees `barstate.isrealtime=1`, `ishistory=0`, `islastconfirmedhistory=0`.
+- `RuntimeStream.push` uses realtime last-bar semantics; `close()` confirms the last bar.
+
+### Changed
+- `barstate.ishistory` is `1` on historical bars (including the last), matching PYNE; the realtime forming bar is `0`.
+- `once` commits its fired flag only on a confirmed bar, ready for multi-tick rollback.
+
+### Fixed
+- README stream example used the non-existent `stream.end()`; it now uses `close()`.
+
 ## [0.8.0] - 2026-11-04
 
 Full builtin surface: every name registered by PYNE's `BuiltinEvaluator`

package/README.md

@@ -178,7 +178,23 @@ const stream = rt.stream(source);
 stream.on("bar", (out) => { /* one result per push */ });
 stream.push({ close: 1 });
 stream.push({ close: 2 });
-stream.end();
+
+// Re-tick the forming last bar (does not advance barCount):
+// barstate.isrealtime is 1, ishistory 0; once/TA/broker state recomputes.
+stream.updateLastBar({ open: 2, high: 3, low: 1, close: 2.5 });
+stream.appendBars([{ close: 3 }, { close: 4 }]);
+stream.close(); // confirm the last bar (realtimeLastBar: false)
+```
+
+`Runtime.run(src, bars, { realtimeLastBar: true })` exposes the same flag for a
+single call. Multi-tick realtime windows work too (Python `realtime_ticks` /
+`realtime_bars` / `realtime_from_bar`):
+
+```ts
+// Visit bars 12.. as realtime, 3 ticks per bar: intermediate ticks roll back
+// var / TA / broker / plot state (varip persists, plots capture the final tick).
+rt.run(src, bars, { realtimeFromBar: 12, realtimeTicks: 3 });
+rt.run(src, bars, { realtimeBars: 5, realtimeTicks: 2 });
 ```
 
 ### Bars you actually have