edfcore 0.5.58 → 0.5.59

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

package/docs/CHANGELOG.md

@@ -6,6 +6,26 @@ 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.5.59
+
+- **Added** the round trip a streaming pipeline actually performs: stream a window in pieces, merge
+  the pieces, and get the window. `merge-split.test.ts` proves it for `readWindow`. `streamRecords`
+  is the other way to get a window in pieces and is different code — a `readRecords` per piece, a
+  seam check between them, and a `chunkRecords` knob that decides how many pieces there are. Its
+  docblock says the pieces must be "the same object in every respect" as a read chunk, and
+  `stream-equals-read.test.ts` checks that one piece at a time. Whether they reassemble was not
+  checked.
+- If they do not join, the memory bound the call exists for is bought with an answer the caller
+  cannot reconstruct — which is the whole point of streaming a twelve-hour recording and then
+  running a filter over it.
+- The stream is merged at four chunk sizes, from one piece per record to a single piece, and
+  compared against `readWindow` on the same window: the samples, the record range, the byte offset
+  and length, the exact start and duration in ticks, `precededByGap` and the diagnostics.
+- On a discontinuous file the answer changes, correctly. The stream crosses the gap in pieces, so
+  merging all of them is refused with the message `chunks.ts` produces — and the advice that refusal
+  ends with is followed: grouped by run, each run reassembles into exactly the chunk `readWindow`
+  returns for it.
+
 ## 0.5.58
 
 - **Added** the composition rule for `trimToWindow`: trimming to A and then to B is trimming once to

package/package.json

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