edfcore 0.5.52 → 0.5.54

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

package/docs/CHANGELOG.md

@@ -6,6 +6,43 @@ 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.54
+
+- **Added** the claim the `index` option on `validateRecording` is only worth having if it holds: a
+  sweep that was handed an index says what a sweep that read one says. `api-validate.md` prices the
+  option — a supplied complete index is the difference between a scan of every record and no
+  traversal at all — and `inspect-validate.test.ts` checks that it does skip the traversal and that
+  a probed index is not accepted as a substitute. Nothing checked that the report is the same.
+- It is a real risk rather than a formality. The two paths reach `segmentCount` and `gaps` through
+  different code — one from `buildSegmentation` over onsets it just read, the other from the
+  `segments` and `gaps` already on the supplied index — and everything the report says about
+  structure is derived from those two. A supplied index that produced a different segment count
+  would be a faster answer to a different question.
+- Both now run over every shape in the matrix and are compared whole, with `scanSamples` on so the
+  sample statistics are in it: `ok`, every diagnostic and every entry of `signalStats`. The matrix
+  is asserted to reach both verdicts and to produce real statistics, so the comparison is of
+  something.
+- `bytesRead` is the one number that legitimately differs, and it is asserted to be lower — on the
+  files where there is anything to skip, which is the reason the option exists.
+
+## 0.5.53
+
+- **Added** the CLI's half of determinism. `diagnostics.md` says of the formatter underneath it that
+  "the output is deterministic (no locale-sensitive formatting, no ANSI escapes unless you ask), so
+  it's safe to snapshot in a test", and 0.5.26 checked that for the library. The CLI is a second
+  surface over those formatters, with joins, sorts, caps and column padding of its own, and the
+  claim that matters for it is the one a script depends on: run it twice on the same bytes and you
+  get the same bytes back.
+- That is what `edfcore signals big.edf | sort | diff -` is built on and what makes `edfcore json`
+  usable in a build. It is easy to lose in ways no single-run test would see — a `Map` iterated
+  where a `Set` was meant, a sort that is not total, a count formatted from a float — and each
+  produces output that is right most of the time.
+- Every command now runs twice over every shape in the matrix: sixty pairs over ten files, with the
+  exit code and the full text of both streams compared. The stronger form runs too — a second
+  recording opened over a copy of the bytes gives the same output, so it is a function of the file
+  rather than stable per process. And the totals are asserted, so sixty pairs of empty strings could
+  not pass.
+
 ## 0.5.52
 
 - **Added** the sweep for a selection that came from JSON. `io/read.ts` says why this is not a

package/package.json

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