edfcore 0.4.491 → 0.4.493

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

package/docs/CHANGELOG.md

@@ -6,6 +6,42 @@ 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.493
+
+- **Added** the two edges of `readHeader`'s prefetch decision, both of which could be moved with
+  the suite green.
+- The upper one is the one that matters. Narrowing `<= 9999` refuses the hint for a file declaring
+  the most signals a header can — and the consequence is not a slower read but a wrong answer: the
+  second read is skipped, `parseHeader` gets a quarter of a kilobyte of a 2.56 MB header, and a
+  perfectly good recording is reported `SOURCE_TOO_SMALL`. At exactly one signal count.
+- The other side of that guard is unreachable, and the test says so with a check rather than in
+  prose: the field is four ASCII bytes and `parseEdfInteger` admits no exponent, so `9999` is the
+  largest value that parses. Widening the field or admitting `9e9` makes the guard live, and fails
+  this in the same commit.
+- The lower edge is a source that ends with the fixed header. `remaining` is zero, and asking for
+  zero bytes is still a read — a round trip over HTTP, and an entry in every read-count claim this
+  file makes.
+
+## 0.4.492
+
+- **Added** a test that runs the worked example on `reading-signals.md`. That page carries the
+  argument the whole indexing design exists for — `trimToWindow` compares integers taken from the
+  header as written, never `round(t * sampleRateHz)` — and it makes the case with six concrete
+  numbers and a footnote counting how often the two disagree. Nothing ran any of them.
+  `documented-examples.test-d.ts` compiles the snippets, which proves they are valid TypeScript
+  and says nothing about whether 8534 is the answer.
+- Numbers in prose rot in a direction that is hard to see. A value that was right when it was
+  written stays plausible for ever, because a reader checks it against their intuition rather than
+  against the library — and this page exists to correct an intuition. The footnote is the extreme
+  case: "1,000 of the first 3,001, always by exactly one sample" is a claim nobody can check by
+  reading, and the argument leans on it.
+- Every figure is read OUT OF THE PAGE and compared with what the library does, the way
+  `scaling-page-arithmetic.test.ts` reads the count it checks, so neither side can drift from the
+  other. All of them hold, footnote included: 1,000 disagreements over 3,001 second boundaries,
+  every one of them exactly one sample, and the float answer earlier every time.
+- Restoring the pre-0.3.56 rounding — the defect the code's own comment records — now fails this
+  file rather than only the unit tests written for it.
+
 ## 0.4.491
 
 - **Added** the `maxMaterializeBytes` boundary for `toPhysical` and `clampToDigitalRange` — the

package/package.json

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