Files
wickra/bindings/wasm/tests/golden.test.js
T
kingchencandGitHub 4f708d410d test: golden-pin the four de-duplicated indicators across all bindings (#305)
* test: golden-pin the four de-duplicated indicators across all C-ABI bindings

Extend gen_golden to emit reference fixtures for AdOscillator (ADOSC),
IntradayIntensity, AwesomeOscillatorHistogram and AverageDrawdown, and replay
them through the Go / C# / Java / R golden harnesses so their corrected
definitions stay bit-identical to the Rust core in every binding. Go suite
verified locally (gcc 13 + cgo): all 9 golden tests pass; C#/Java/R use the
same fixtures and harness pattern (CI-verified). First step of extending the
golden coverage beyond the seven archetype representatives.

* test: golden-pin the scalar-output tranche (308 indicators) against Rust

Extend gen_golden with a generated emit_scalar that writes reference fixtures
for every single-f64-output indicator (scalar / candle / pairwise input) using
valid constructor params, and add a manifest-driven generic Python golden
replay that reconstructs each by its native name and checks it bit-for-bit
against the Rust output. 308 indicators now value-tied to the Rust core in
Python (pytest: 308/308). Takes golden coverage from the 7 archetype
representatives to 308+ of the catalogue.

22 scalar indicators with non-default constructor constraints are skipped by
gen_golden for now (logged), as are non-f64-output ones; multi-output, exotic
inputs and the per-indicator arg arities of the C-ABI/Node replays follow.
Generated + verified locally with the full toolchain.

* test: golden-pin the multi-output tranche (70 indicators) in Python

Add a generated emit_multi to gen_golden (per-indicator Output-field access,
one CSV column per field) and a manifest-driven generic Python replay that
checks every field of each multi-output indicator against the Rust reference.
70 multi-output indicators now value-tied to Rust in Python; combined with the
scalar tranche, 378 indicators are golden-pinned. 8 multi with non-default
param constraints and 5 with non-f64 Output fields (Option/Vec/i64) are
deferred. pytest green.

* test(golden): add 30 constraint-tuned indicators to scalar/multi golden suite

Emit golden fixtures for 22 scalar-output and 8 multi-output indicators
whose constructors need non-default parameters (Alma, Jma, Psar, T3, Mama,
DoubleBollinger, ZigZag, ...). All 408 fixtures replay bit-for-bit through
the Python binding.

* test(golden): cover 36 missed scalar/multi indicators

Add 26 single-output (LinearRegression family, HT cycle, Candle
volatility estimators, DrawdownDuration) and 10 multi-output
(BollingerBands, MACD/MACDEXT/MACDFIX, Camarilla, VWAP bands, ...)
indicators to the golden suite. 444 fixtures replay bit-for-bit
through the Python binding.

* test(golden): cover 50 exotic-input indicators

Add deterministic synthetic feeders for the DerivativesTick (17),
CrossSection (15), Trade (8), TradeQuote (3) and OrderBook (7)
families, derived from the shared OHLCV input series in both
gen_golden and a new Python replay harness (test_golden_exotic).
All 494 fixtures replay bit-for-bit through the Python binding.

* test(golden): complete 514-indicator golden coverage

Add the final tranches: 3 mixed multi-output indicators (Ichimoku,
WilliamsFractals, LeadLagCrossCorrelation), 6 histogram profiles
(time/volume seasonality + TPO/volume price profiles), 10 alt-chart
bar builders and the footprint. Every one of the 514 distinct
indicators now has a Rust-generated g_<Canonical>.csv fixture and a
generic Python replay (scalar/multi/exotic/profile/bars), all passing
bit-for-bit.

* test(golden): add generic Node replay for all 514 indicators

A manifest-driven node:test harness reconstructs every indicator by its
native class, feeds the same synthetic stream derived from the shared
golden input, and checks output bit-for-bit against the Rust reference
fixtures (scalar/multi/exotic/profile/bars). node_manifest.json is
generated from index.d.ts plus the Python-side manifests. 514/514 pass.

* test(golden): add generated Go replay for all 514 indicators

golden_all_test.go (generated by gen_golden_test.py) reconstructs every
Go indicator, feeds the shared synthetic stream and checks output
bit-for-bit against the Rust reference fixtures. A reflection-based
comparator flattens multi-output structs, profiles and bar slices so one
path covers all archetypes. This is the first C-ABI binding verified
across the full catalogue. 514/514 pass.

* test(golden): add generated C# replay for all 514 indicators

GoldenAllTests.g.cs (generated by gen_golden_test.py) reconstructs every
C# indicator, feeds the shared synthetic stream and checks output
bit-for-bit against the Rust reference fixtures via a reflection-based
flatten covering scalar/multi/profile/bar archetypes. 514/514 pass.

Also add the '#nullable enable' directive the compiler requires to the
generated Indicators.g.cs, clearing the four CS8669 warnings on the
nullable double[] profile return types.

* fix(java): marshal C ABI bool params correctly; add 514 golden replay

The Java FFM binding marshalled the cross-section state flags (newHigh,
newLow, aboveMa, onBuySignal) as JAVA_DOUBLE arrays, but the C ABI takes
them as const bool* (one byte each), so the native side read the low byte
of each 8-byte double and saw every flag as false. Add WickraNative.
boolSegment and use it across the 15 cross-section indicators. Also pass
the MacdExt MaType arguments as byte to match the uint8_t downcall
descriptor (was int, throwing WrongMethodTypeException).

Add GoldenAllTest.java (generated by gen_golden_test.py): a reflection
runner replaying all 514 indicators against the Rust reference fixtures.
The bugs above were found by this test; 514/514 now pass.

* fix(r): marshal C ABI bool flags correctly; add 514 golden replay

The R wrapper passed the cross-section state flags as (bool *)REAL(x),
reinterpreting the 8-byte doubles as 1-byte bools so the native side read
every flag as false. Add wk_bool_vec to convert each flag vector into a
real C bool buffer and use it for all 15 cross-section update wrappers.

Add test-golden-all.R + generated golden_specs.R: a reflective runner
replaying all 514 indicators against the Rust reference fixtures. The bug
above was found by this test; verified 514/514 pass locally.

* test(golden): add WASM replay for all 514 indicators

A manifest-driven node:test harness loads the nodejs-target wasm-pack
build, reconstructs every indicator by its JS class, feeds the shared
synthetic stream and checks output bit-for-bit against the Rust
reference fixtures. wasm_manifest.json is generated from the wasm .d.ts
plus the shared manifests; a recursive flattener covers scalar, multi
(Reflect objects), profile and bar shapes. 514/514 pass locally
(wasm-pack build --target nodejs, then node --test).

* test(golden): add C and C++ replay for all 514 indicators

golden_test.c (generated by gen_golden_test.py) drives every indicator
through the C ABI (wickra.h) and checks output bit-for-bit against the
Rust reference fixtures. golden_test.cpp #includes the same source so the
identical runner is compiled and run under both gcc (C) and g++ (C++) via
the CMake targets golden_test / golden_test_cpp — proving the extern "C"
header is consumable from each language. Both 514/514 (verified via ctest).

* test(golden): gofmt the generated Go golden replay

* test(golden): make the Node fixture reader CRLF-safe and pin fixtures to LF
2026-06-15 04:48:51 +02:00

157 lines
5.7 KiB
JavaScript

// Generic golden-fixture parity for the WASM (wasm-bindgen) binding, run under
// Node's test runner against the nodejs-target build in ../pkg.
//
// Every one of the 514 indicators is reconstructed from wasm_manifest.json (JS
// class, constructor params, ordered update args parsed from the generated
// .d.ts), fed the synthetic stream derived from the shared golden input — the
// same construction gen_golden uses — and checked bit-for-bit against the Rust
// reference fixtures g_<Canonical>.csv.
//
// wasm-pack build --target nodejs --out-dir pkg
// node --test tests/
const test = require('node:test');
const assert = require('node:assert/strict');
const fs = require('node:fs');
const path = require('node:path');
const W = require('../pkg/wickra_wasm.js');
const GOLDEN = path.resolve(__dirname, '..', '..', '..', 'testdata', 'golden');
function cell(s) {
if (s === 'nan') return NaN;
if (s === 'inf') return Infinity;
if (s === '-inf') return -Infinity;
return Number(s);
}
function readCsv(name) {
const lines = fs.readFileSync(path.join(GOLDEN, name + '.csv'), 'utf8').split('\n');
lines.shift();
return lines.filter((l) => l.length > 0).map((l) => l.split(',').map(cell));
}
function readBarRows(name) {
const lines = fs.readFileSync(path.join(GOLDEN, name + '.csv'), 'utf8').split('\n');
lines.shift();
if (lines.length && lines[lines.length - 1] === '') lines.pop();
return lines.map((l) => (l.length === 0 ? [] : l.split(',').map(cell)));
}
const MANIFEST = JSON.parse(fs.readFileSync(path.join(GOLDEN, 'wasm_manifest.json'), 'utf8'));
const ROWS = readCsv('input');
function deriv(o, h, l, c, v) {
return {
funding_rate: ((c - o) / c) * 0.01,
mark_price: c,
index_price: c - 0.5,
futures_price: c + 1.0,
open_interest: v * 10.0,
long_size: v * 0.6,
short_size: v * 0.4,
taker_buy_volume: v * 0.55,
taker_sell_volume: v * 0.45,
long_liquidation: h - c,
short_liquidation: c - l,
};
}
function resolveArg(arg, o, h, l, c, v, i) {
const n = arg.name;
if (arg.array) {
const j5 = [0, 1, 2, 3, 4];
switch (n) {
case 'change': return Float64Array.from(j5.map((j) => c - o + j));
case 'volume': return Float64Array.from(j5.map((j) => v + j * 10.0));
case 'new_high': return Float64Array.from(j5.map((j) => (j % 2 === 0 ? 1 : 0)));
case 'new_low': return Float64Array.from(j5.map((j) => (j % 3 === 0 ? 1 : 0)));
case 'above_ma': return Float64Array.from(j5.map((j) => (j % 2 === 0 ? 1 : 0)));
case 'on_buy_signal': return Float64Array.from(j5.map((j) => (j % 3 === 0 ? 1 : 0)));
case 'bid_px': return Float64Array.from(j5.map((k) => c - 0.1 * (k + 1)));
case 'bid_sz': return Float64Array.from(j5.map((k) => v / (k + 1)));
case 'ask_px': return Float64Array.from(j5.map((k) => c + 0.1 * (k + 1)));
case 'ask_sz': return Float64Array.from(j5.map((k) => (v * 0.9) / (k + 1)));
default: throw new Error('array arg ' + n);
}
}
if (arg.bigint) return BigInt(i);
switch (n) {
case 'value': case 'close': case 'price': case 'x': case 'a': case 'asset': return c;
case 'y': case 'b': case 'open': case 'benchmark': return o;
case 'high': return h;
case 'low': return l;
case 'volume': case 'size': return v;
case 'is_buy': return c >= o;
case 'mid': return (h + l) / 2.0;
case 'timestamp': return BigInt(i);
default: {
const d = deriv(o, h, l, c, v);
if (n in d) return d[n];
throw new Error('scalar arg ' + n);
}
}
}
// Recursively flatten a WASM output (number, object with field props, typed/array
// of either) into a flat number list. Returns null for warmup (null/undefined).
function flat(v) {
if (v === null || v === undefined) return null;
if (typeof v === 'number' || typeof v === 'bigint') return [Number(v)];
if (Array.isArray(v) || ArrayBuffer.isView(v)) {
const out = [];
for (const e of v) { const f = flat(e); if (f) out.push(...f); }
return out;
}
if (typeof v === 'object') {
const out = [];
for (const val of Object.values(v)) { const f = flat(val); if (f) out.push(...f); }
return out;
}
return [Number(v)];
}
function nanRow(n) {
return Array.from({ length: n }, () => NaN);
}
function widthOf(spec) {
if (spec.out.startsWith('multi') || spec.out === 'deriv_multi') return spec.n;
if (spec.out.startsWith('profile')) return spec.width;
return 1; // scalar archetypes
}
function closeEq(got, want, label) {
if (Number.isNaN(want)) { assert.ok(Number.isNaN(got), `${label}: want NaN got ${got}`); return; }
if (!Number.isFinite(want)) { assert.ok(got === want, `${label}: want ${want} got ${got}`); return; }
const tol = 1e-6 * Math.max(1.0, Math.abs(want));
assert.ok(Math.abs(got - want) <= tol, `${label}: got ${got} want ${want}`);
}
for (const spec of MANIFEST) {
test(`wasm golden: ${spec.canonical}`, () => {
const Cls = W[spec.js];
assert.ok(Cls, `missing WASM class ${spec.js}`);
const ind = new Cls(...spec.ctor);
const isBars = spec.out === 'bars' || spec.out === 'footprint';
const expected = isBars ? readBarRows('g_' + spec.canonical) : readCsv('g_' + spec.canonical);
for (let i = 0; i < ROWS.length; i++) {
const [o, h, l, c, v] = ROWS[i];
const args = spec.args.map((a) => resolveArg(a, o, h, l, c, v, i));
const raw = ind.update(...args);
const want = expected[i];
const label = `${spec.canonical} row ${i}`;
let got = flat(raw);
if (isBars) {
if (got === null) got = [];
} else if (got === null) {
got = nanRow(widthOf(spec));
}
assert.equal(got.length, want.length, `${label}: arity ${got.length} vs ${want.length}`);
for (let k = 0; k < want.length; k++) closeEq(got[k], want[k], `${label} col ${k}`);
}
});
}