edfcore 0.5.58 → 0.5.60

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.60";
 //# 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.60';
 //# sourceMappingURL=constants.js.map

package/docs/CHANGELOG.md

@@ -6,6 +6,51 @@ 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.60
+
+- **Added** the boundary six documentation pages talk about and nothing executed: `postMessage`.
+  `api-errors.md`, `diagnostics.md`, `concepts.md`, `api-reading.md`, `api-primitives.md` and
+  `data-sources.md` each tell a reader that a value crossing a worker or an iframe fails
+  `instanceof` and that `edfErrorKind` is what to branch on instead.
+  `cross-realm-errors.test.ts` executes the case those pages name — two copies of the module in one
+  dependency tree — where the object is passed by REFERENCE and only its constructor identity
+  differs. Nothing is passed by reference out of a worker: it goes through the structured clone
+  algorithm, which is a different question with different answers.
+- `what-crosses-a-worker.test.ts` clones every value a worker would hand back, over all ten
+  `AWKWARD` shapes and a gapped file — 109 checks. Every DATA result survives and compares equal,
+  `Int32Array` samples and `bigint` ticks included, and the sweep asserts it is carrying both so a
+  pass is not a JSON round trip in disguise.
+- Three things do not survive, and each is pinned with the workaround beside it. The record index
+  is refused outright, because `locate` is a function — `index.segments` and `index.gaps` cross
+  fine, and those are what a viewer wants. So is the recording, because a `ByteSource` has a
+  `read`; the header crosses instead. And `Object.freeze` is dropped, so the guarantee
+  `every-array-is-frozen.test.ts` pins is a within-realm one.
+- An `EdfError` does not cross as an edfcore error at all. The algorithm keeps `name`, `message`,
+  `stack` and `cause` and drops every own property, so `code`, `field`, `byteOffset`, `diagnostic`
+  — and `edfErrorKind` itself — are gone, and `isEdfError` returns false on the far side. The
+  string beats `instanceof` for a second copy in the tree; across a `postMessage` neither works,
+  and a sender has to post the discriminator rather than the error.
+
+## 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.60",
   "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.60';