edfcore 0.6.19 → 0.6.21

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.6.19";
+export declare const VERSION = "0.6.21";
 //# 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.6.19';
+export const VERSION = '0.6.21';
 //# sourceMappingURL=constants.js.map

package/docs/CHANGELOG.md

@@ -6,6 +6,44 @@ 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.6.21
+
+- **Added** the check that calling twice gives the same answer. Every function in the reading API is
+  documented as a question about a file, and a question about a file has one answer — and nothing
+  checked it. The suite calls each of them once per test, which is exactly the shape that cannot see
+  state left behind by the first call: a memo filled with the wrong key, a cursor advanced and not
+  reset, an array handed out and then written into by the next caller.
+- Two axes, because they catch different things. The same recording asked twice catches state on the
+  recording; two recordings over the same bytes catch state shared beneath them. Over all thirteen
+  shapes, for `buildRecordIndex`, `readAnnotations`, `validateRecording`, `readRecords`, `readWindow`
+  and `readEnvelope`, plus `inspectEdf` on the bytes.
+- And a third claim the first two cannot make: a second call hands back arrays of its own. Equal
+  contents, different objects, different buffers — because two callers reading one recording must not
+  be able to write into each other's results. `nothing-points-at-your-buffer` says a result never
+  points into the caller's bytes; this says a second result never points into the first one's.
+- `buildRecordIndex` returns methods as well as data, so results are compared through a projection
+  that drops function-valued properties — two calls necessarily build two closures, and whether they
+  are the same function is not the question. `locate` and `onsetTicks` are then exercised directly at
+  every record and at five instants, which is the half that projection drops.
+- Nothing disagreed. No behaviour changed.
+
+## 0.6.20
+
+- **Added** a thirteenth shape to the `AWKWARD` matrix: a record duration with no exact binary
+  form. `formatHeader` carries the story in a comment beside the function it forced — "100 records
+  of 0.29 s is exactly 29 s and computes as 28.999999999999996, which floors to 28. The header line
+  then reports a recording a whole second shorter than it is (fixed in 0.2.67)."
+- That file is exactly this one, and the matrix had never held it. Every sweep over `AWKWARD` ran
+  on durations of 1 s and 0 s — the two values where the float and the rational agree — so the
+  arithmetic this whole package is written in ticks to avoid was never exercised by any of them.
+  Twenty-three sweeps see it now, and they all pass.
+- `a-duration-float64-cannot-hold.test.ts` spells the hazard out in both directions on the fixture
+  itself: the float product is less than 29 and floors to 28, the tick product is exactly
+  `29n * TICKS_PER_SECOND`, and the header line reads `00:00:29`. It also checks this is the only
+  shape in the matrix whose duration is inexact, and that its derived rate is a clean 100 Hz — an
+  inexact duration does not have to make the rate inexact, and a fixture where both were awkward
+  would not tell the two apart.
+
 ## 0.6.19
 
 - **Added** a twelfth shape to the `AWKWARD` matrix: a file whose record count field says `-1`, so

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edfcore",
-  "version": "0.6.19",
+  "version": "0.6.21",
   "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.6.19';
+export const VERSION = '0.6.21';