edfcore 0.4.524 → 0.4.526

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

package/docs/CHANGELOG.md

@@ -6,6 +6,44 @@ 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.526
+
+- **Added** the callout on `diagnostics.md` that stops a reader gating a read on the wrong number:
+  "`report.ok` is `severity !== 'error'` over a superset of `header.diagnostics`". It says three
+  things, each a claim about behaviour, and `diagnostic-docs.test.ts` checked only that the page
+  still words it that way.
+- The superset half is the one that could rot in silence. `validateRecording` builds its own list,
+  so a header diagnostic dropped on the way in leaves the report describing a cleaner file than the
+  header did — and the report is the stricter of the two by construction, which is the direction
+  nobody thinks to check. Every diagnostic is now matched by severity, code and message, so two
+  occurrences of one code are two entries rather than one.
+- `ok` is asserted as the sentence the page writes it as, twice over: directly against the report's
+  own diagnostics, and through `summarizeDiagnostics(...).errors === 0`, which is what a caller
+  actually counts with.
+- The last clause is checked on the file it is about. A signal with a degenerate digital range
+  carries an `error`-severity diagnostic and makes `report.ok` false — and the file reads perfectly,
+  including that channel's samples, which is the deferred-fatal contract and the entire reason the
+  callout exists. Both verdicts are reached across the eight shapes, so neither is a constant.
+
+## 0.4.525
+
+- **Added** a check that what the CLI prints is what the library reports, over the eight awkward
+  shapes. 0.4.524 checks the six commands survive them; surviving is not agreeing, and a command
+  that caught its own exception and printed a plausible summary would pass that while being worse
+  than a crash — the output is what a reader pastes into an issue.
+- Three commands carry values rather than prose, and each is re-derived from the library and
+  compared. They rot differently. `json` is read by scripts, so a field that quietly stops matching
+  the header is acted on rather than noticed. `events` prints a count and then a listing, which can
+  disagree with each other as well as with the file. `gaps` runs its own full scan — deliberately,
+  since the probed index cannot see a gap in the middle — so its numbers come from a second
+  traversal that nothing had compared with the first.
+- The `json` case pins the shape a zero record duration produces: `JSON.stringify` drops a key
+  whose value is `undefined`, so an absent sample rate is an absent KEY rather than a null, and the
+  test asserts the key is present exactly when the rate is. `--patient` is checked to print the raw
+  field with padding trimmed, and its absence to be a missing key rather than an empty string.
+- `signals` is not here — `cli-signals-columns.test.ts` ties all six of its columns to the header
+  already, which is this check in the same shape.
+
 ## 0.4.524
 
 - **Added** the six CLI commands over the eight awkward shapes, without the corpus. The CLI is

package/package.json

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