edfcore 0.4.520 → 0.4.522

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

package/docs/CHANGELOG.md

@@ -6,6 +6,49 @@ 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.4.522
+
+- **Added** the reading/scaling/decimating agreement checks to the offline suite — the third group
+  in `tests/corpus/whole-api.test.ts`, which skips without the corpus. These are four calls a
+  viewer makes in sequence: read a window, join the chunks, convert to units, draw a decimated
+  envelope. Each can be individually right while contradicting the one before it.
+- The envelope is where that bites. `readEnvelope` reads and reduces on its own path rather than
+  decimating what `readWindow` returned, so its extremes and the samples' extremes are two
+  independent answers to the same question about the same window, and only comparing them says
+  they agree.
+- Running it on built files covers more than running it on real ones. The shapes include a file
+  with no data signal at all and one with a zero record duration, where the honest answer to "read
+  a window of it" is nothing — and a helper that returns nothing where its neighbour throws is
+  exactly the disagreement this group exists to find. The corpus reaches those shapes by luck.
+- Every case returns early on a file it cannot apply to, so the file ends by asserting how many
+  times it got through: windows read, envelopes compared, samples located. Without that the whole
+  run could return early and report green.
+- The **annotation-helper** group lands with it, since it is the same argument about a different
+  four calls: a census, a text filter, a formatter and two time lookups, all describing one list.
+  Each is asked about every event's OWN onset, which puts every event on the boundary of the
+  half-open interval it is being looked for in rather than hoping one lands there — and half-open
+  boundaries are where five of the comparisons this project has had to fix went wrong. Four of the
+  eight shapes carry no annotations channel, and two empty lists agree about everything, so that
+  file also counts the events it reached.
+
+## 0.4.521
+
+- **Added** the timeline-helper agreement checks to the offline suite, the second group in
+  `tests/corpus/whole-api.test.ts` that skips without the corpus. `contiguityOf`, `segmentAt` and
+  `gapAt` each answer a question the index already answers, and the way they fail is by
+  disagreeing with it: a time reported as inside a segment AND inside a gap, a gap count that does
+  not match the segments it separates, segments that skip a record or claim one twice.
+- The zero-record-duration shape is why this group is worth running on built files as well as real
+  ones. Records then occupy no time, so every segment's half-open interval `[start, start)` is
+  empty and `segmentAt` returns `undefined` for every instant — the same answer the sample helpers
+  give for the same reason, and one that looks like a bug until you notice there is no time axis to
+  be on. The sleep-edfx hypnogram is a file of exactly that shape, and a fresh clone had none.
+- Each gap is checked to name the two segments it lies between and to start and end exactly where
+  they do, in ticks: a gap derived independently of the pair it separates is how a boundary comes
+  to be reported twice with two different numbers.
+- The last case asserts the shapes reach both branches — one file discontinuous, one contiguous,
+  one with a zero-width segment — so a green run is not one where every branch was skipped.
+
 ## 0.4.520
 
 - **Added** the header-helper agreement checks to the offline suite. `tests/corpus/whole-api.test.ts`

package/package.json

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