edfcore 0.2.33 → 0.2.34

package/CHANGELOG.md

@@ -6,6 +6,27 @@ alone does not tell you whether you were affected.
 edfcore is pre-1.0. Patch releases have carried behaviour changes where the old behaviour was a
 defect; those are called out below.
 
+## 0.2.34
+
+- **Added** the golden-value harness this README has withheld a numerical-interop claim for since
+  0.1.0. edfcore now **reproduces pyEDFlib's float64 physical values bit for bit** on EDF and
+  24-bit BDF, across symmetric and asymmetric declared ranges. `scripts/golden/generate.py` writes
+  the fixtures with pyEDFlib's own writer, reads them back with pyEDFlib, and records every sample
+  as its exact IEEE-754 bit pattern; the test compares with `Object.is`, so one ULP is a failure.
+  Nothing under `tests/corpus/golden/` was produced by edfcore, and the goldens are committed so
+  CI never needs Python.
+
+  Every previous test of the pinned scaling expression re-derived that same expression inside the
+  test, which proved edfcore agrees with itself and nothing more. This is the first evidence that
+  the choice to keep EDFlib's numerically worse form was worth making: substituting the textbook
+  `physicalMinimum + (digital - digitalMinimum) * gain` fails on 140 of 256 samples of the
+  symmetric fixture — `-492.15686274509807` where pyEDFlib says `-492.156862745098` — and a test
+  asserts that the goldens can tell the two apart, so the parity is a real constraint rather than
+  a coincidence of the fixtures.
+
+  Still not claimed, because no test produces it yet: parity with MNE, and validation across the
+  public corpora.
+
 ## 0.2.33
 
 - **Fixed** annotations being dropped with no diagnostic naming them. `TIMEKEEPING_TAL_NONCONFORMANT`

package/README.md

@@ -291,10 +291,17 @@ the reason to trust the reader.
 **0.1 — reads everything, lies about nothing.** All six variants, the primitive/I/O/convenience
 layers, `inspectEdf`, `edfcore/validate`, six source adapters, the full diagnostic vocabulary.
 
-**Before 1.0.** Validation against public corpora (sleep-edfx, CHB-MIT, the BioSemi and
-edfplus.info test files) and a golden-value harness cross-checking physical values against
-pyEDFlib and MNE. Until that harness exists this README makes no numerical-interop claim, and it
-will not make one that a test did not produce.
+**Numerical interop, as of 0.2.34.** edfcore reproduces **pyEDFlib's float64 physical values bit
+for bit** on EDF and 24-bit BDF, across symmetric and asymmetric ranges. That is a test, not a
+belief: `scripts/golden/generate.py` writes the fixtures with pyEDFlib's own writer, reads them
+back with pyEDFlib, and records every sample as its exact IEEE-754 bit pattern;
+`tests/corpus/golden-values.test.ts` compares with `Object.is`, so one ULP is a failure. Nothing in
+`tests/corpus/golden/` was produced by edfcore. Substituting the numerically better textbook
+expression fails it on 140 of 256 samples — which is why the EDFlib form is pinned.
+
+**Still open before 1.0.** The same harness against MNE, and validation across public corpora
+(sleep-edfx, CHB-MIT, the BioSemi and edfplus.info test files). Those claims are not made here
+until a test produces them.
 
 **Shipped since 0.1.6.** Min/max envelope decimation (`readEnvelope`,
 `readEnvelopeAtResolution`). BioSemi Status-byte helpers (`readTriggers`). Streaming iteration

package/dist/constants.d.ts

@@ -109,5 +109,5 @@ export declare const SIGNAL_FIELD_BLOCK_OFFSETS: {
     readonly reserved: 224;
 };
 /** Published package version. Kept in sync with package.json by a test. */
-export declare const VERSION = "0.2.33";
+export declare const VERSION = "0.2.34";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.js

@@ -79,5 +79,5 @@ export const SIGNAL_FIELD_BLOCK_OFFSETS = {
     reserved: 224,
 };
 /** Published package version. Kept in sync with package.json by a test. */
-export const VERSION = '0.2.33';
+export const VERSION = '0.2.34';
 //# sourceMappingURL=constants.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edfcore",
-  "version": "0.2.33",
+  "version": "0.2.34",
   "description": "Modern, typed, zero-dependency reader for EDF, EDF+, BDF and BDF+ biosignal files. Works in browsers and Node with true random access.",
   "keywords": [
     "edf",

package/src/constants.ts

@@ -93,4 +93,4 @@ export const SIGNAL_FIELD_BLOCK_OFFSETS = {
 } as const;
 
 /** Published package version. Kept in sync with package.json by a test. */
-export const VERSION = '0.2.33';
+export const VERSION = '0.2.34';