edfcore 0.5.26 → 0.5.28

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

package/docs/CHANGELOG.md

@@ -6,6 +6,53 @@ 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.28
+
+- **Added** an already-aborted signal driven through every entry point that takes one.
+  `api-sources.md` says edfcore "polls `.aborted` before and after each read and throws an `Error`
+  whose `name` is `'AbortError'`"; `data-sources.md` adds that every bundled adapter checks it
+  before it starts, and that the rejection "is a plain `Error` ... not an `EdfError`.
+  `isEdfError` returns false for it, so a `catch` that re-throws aborts stays simple."
+- `http-abort-signal.test.ts` covers the adapter with the most to go wrong. What nothing covered is
+  the sentence's scope. The guard lives in the SOURCES, and every reading function reaches it only
+  by issuing a read — so whether each of them actually does, before allocating, before scanning,
+  before decoding, is a property of thirteen call paths rather than of the four adapters. A function
+  that resolved its window or sized its buffer first would do that work for a caller who had already
+  cancelled.
+- All thirteen are now driven, and each must reject with `name === 'AbortError'` and `isEdfError`
+  false — the discriminator the page says consumers branch on, chosen because `DOMException` cannot
+  be named without the DOM lib. The four adapters are driven directly alongside them, and each is
+  also shown to read normally when the signal is simply not aborted.
+- The one place it does not fire is checked with them, because it is documented rather than
+  accidental: `api-reading.md` says a record range with `count: 0` "issues no read at all", and a
+  call that reads nothing has nothing to abort.
+- The last block is the other half of `ReadOptions`' own docblock — "cancelling a read and capping an
+  allocation never alter what a completed call returns". A signal that is never aborted leaves every
+  result identical to one passed no options at all.
+
+## 0.5.27
+
+- **Added** a non-finite bound driven through every entry point that takes a time in seconds.
+  `secondsToTicks` is the one place a caller's seconds become the integers everything else works in,
+  and it refuses a non-finite one; `ticks.test.ts` covers that, once, on the resolver.
+- The resolver is not the guarantee. The guarantee is that a `NaN` cannot get past it, and `NaN`
+  reaches a time bound the way it reaches a byte budget: `Number(searchParams.get('t'))`, a slider
+  whose value has not been set, an absent key in a saved view. What makes it worth a sweep is what
+  happens if one entry point misses. `NaN` compares false against everything, so a window bound that
+  skipped the resolver would not throw — it would return `[]`, which is the legitimate answer for a
+  window past the end of a recording and indistinguishable from one. That contrast is asserted
+  rather than described.
+- The entry points are enumerated out of `src/` the way `nan-budget-reaches.test.ts` enumerates the
+  budget's: sixteen exported functions declare one of `seconds`, `startSeconds`, `durationSeconds`
+  or `secondsPerBucket`, directly or through a selection type whose `extends` chain is followed.
+  Two of the sixteen take a `startSeconds` edfcore itself produced — `envelopeOfSamples` and
+  `toPhysicalEnvelope`, on an `EdfChunkSignal` and an `EdfEnvelopeSignal` — and that is stated
+  rather than filtered out silently.
+- Each of the remaining thirteen, plus `index.locate`, is driven with `NaN`, `Infinity` and
+  `-Infinity`, and each must throw a plain `RangeError` — `isEdfError` false, since a bad bound is a
+  caller's mistake and never a file's — whose message names the value it was given and ends with a
+  `Next:` clause.
+
 ## 0.5.26
 
 - **Added** the two sentences that promise nothing changes when you run it again. `validation.md`:

package/package.json

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