edfcore 0.4.510 → 0.4.512

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

package/docs/CHANGELOG.md

@@ -6,6 +6,45 @@ 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.512
+
+- **Added** a read behind each of the four header-recovery diagnostics. When the header's numbers
+  disagree with the file, `parseHeader` recovers rather than refuses, and each recovery ends by
+  saying what a read will now do: which byte record 0 comes from, which records exist, which bytes
+  are never decoded. Every one of those is a claim about `decodeDigital` output, made in a module
+  that never calls it, and the existing tests stopped at the header fields the sentence mentions.
+- The gap is not hypothetical for `HEADER_SIZE_MISMATCH`. A three-signal file declaring a 512-byte
+  header has the same `recordCount` under either size, because the arithmetic that produced it used
+  whichever size the reader used; what separates the two readings is which 1024 bytes come back as
+  record 0. The declared offset lands in the middle of the per-signal block and decodes to numbers
+  rather than to an error, so the test asserts the ramp the writer wrote — and asserts alongside it
+  that the declared offset would have given something else, or the first assertion proves nothing.
+- `TRAILING_BYTES` and `PARTIAL_FINAL_RECORD` claim their bytes are never decoded and never padded
+  into existence. Both fixtures now write those bytes as `0x7F`, which decodes to 32639, a value
+  the sample ramp never produces — so "never decoded" is checked by looking for it in the output
+  rather than by trusting an offset. Reaching either by record number is refused, not returned.
+- `TRUNCATED_FILE` says the missing records are not readable and will not be fabricated. The
+  surviving records read exactly as they do in the intact file, and the pair the header claimed is
+  an `EdfRangeError` rather than zeros.
+
+## 0.4.511
+
+- **Fixed** `physical-values.md` documenting the limitation 0.4.509 removed. Its note said a fifth
+  refusal condition exists, that the header calls it `DEGENERATE_PHYSICAL_RANGE`, and that
+  `toPhysical` "can't re-derive this one" so it throws `SCALE_UNAVAILABLE`. The last clause stopped
+  being true one release ago.
+- The page's table now lists five conditions rather than four, so the fifth is documented where a
+  reader looks for it rather than in an aside below. Five rows, four distinct codes: two conditions
+  reach `DEGENERATE_PHYSICAL_RANGE`, which is why the table is of conditions.
+- The table is not prose. `scaling-page-arithmetic.test.ts` parses these rows out of the page and,
+  for each, builds the signal and asserts `toPhysical` refuses it with the code in that row — so
+  the new row is checked by the same mechanism as the other four, and the page cannot describe a
+  refusal the library does not make. The order it claims is checked too: a channel that is both
+  log-transformed and unusably scaled is refused as the log-transformed one, which is the answer
+  that says something about the data rather than about the map.
+- The note is kept, rewritten as history: what the two sides used to report, and why looking up
+  `SCALE_UNAVAILABLE` in `header.diagnostics` used to find nothing.
+
 ## 0.4.510
 
 - **Added** the one claim every diagnostic makes at once, as a property test: `raw` quotes the

package/package.json

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