edfcore 0.5.51 → 0.5.53

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

package/docs/CHANGELOG.md

@@ -6,6 +6,49 @@ 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.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
+  type-system question: "`records` is typed, and the type is not the only way in: a selection built
+  from JSON, from a config file or from a JavaScript call site arrives at run time." It then records
+  what used to happen — every wrong shape reached a refusal with a next step, "while `undefined` and
+  `null` threw `TypeError: Cannot read properties of undefined (reading 'start')` ... which names
+  neither the option nor anything to do about it" (fixed in 0.4.443).
+- That is a whole class and it had one test. A saved view, a URL parameter, a job on a queue: all of
+  them arrive as `JSON.parse` output, where a number written as a string stays a string and an
+  omitted field is simply absent. `record-range-contract.test.ts` covers ranges that are well formed
+  and out of bounds; this covers ranges that are not ranges.
+- Nine malformed `records` shapes — absent, null, empty, half-filled, an array, a string,
+  string-valued fields, a null field — are each refused at all three entry points with an
+  `EdfRangeError` carrying the same next step, and absent and null are asserted not to raise the
+  `TypeError` they once did. A valid range survives a JSON round-trip, extra properties and all.
+- Four malformed `signalIndices` shapes are a plain `RangeError`, since a selection that is not an
+  array is a caller's mistake and not a file's.
+- One shape is accepted, and it is named rather than left to be discovered: an array holding the
+  canonical decimal string for an index — `['0']`, which is what `JSON.parse('["0"]')` from a query
+  string gives — resolves to that signal. It is ordinary array-index coercion and it is tight:
+  `'00'`, `' 0'`, `'0.0'`, `'+0'` and a label are each an `EdfChannelNotFoundError` naming the
+  selector verbatim, and the chunk reports `signalIndex` as a number, so nothing downstream carries
+  the string.
+
 ## 0.5.51
 
 - **Added** the promise `annotations.md` makes about partial reads, and the thing it costs.

package/package.json

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