edfcore 0.5.59 → 0.5.61

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

package/docs/CHANGELOG.md

@@ -6,6 +6,46 @@ 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.61
+
+- **Fixed** a sentence both `api-errors.md` and `diagnostics.md` end their cross-realm advice with,
+  and which is wrong for one of the three cases it names. "A string property survives all three"
+  covers `instanceof` failing across a worker, an iframe and a second copy of edfcore in one
+  dependency tree — and `edfErrorKind` survives the second copy, because that object is passed by
+  reference and only its constructor identity differs.
+- A worker is not passed by reference. Everything leaving one goes through `postMessage`, which is
+  a structured clone, and the algorithm keeps an `Error`'s `name`, `message`, `stack` and `cause`
+  and drops every own property. `edfErrorKind`, `code`, `field`, `byteOffset` and `diagnostic` all
+  arrive `undefined`, and `isEdfError` returns false — so the page's advice fails in exactly the
+  case a reader followed it for. `what-crosses-a-worker.test.ts` executed that in 0.5.60.
+- Both pages now separate the two ways a value crosses, and name what a worker has to do instead:
+  send the discriminator beside the error, because a string clones and the error does not.
+
+## 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

package/package.json

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