edfcore 0.5.32 → 0.5.34

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

package/docs/CHANGELOG.md

@@ -6,6 +6,53 @@ 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.34
+
+- **Added** the `Next:` clause, followed. Every message edfcore throws ends with one, and
+  `next-clause.test.ts` proves that — it enumerates the throws out of `src/` and fails on a message
+  without one. What it cannot check is whether the sentence is any good. A clause naming a function
+  that was renamed, or advising something the API no longer allows, still passes, and advice that
+  does not work is worse than none: the reader spends their time on it before doubting it.
+- The package's own docblocks record two of those. `options.ts`: a `NaN` budget was refused with
+  "read fewer records per call", "advice no record count can satisfy", and elsewhere with "clamp the
+  range against header.recordCount", "a range neither function takes as a parameter" (0.3.21).
+  `validate.ts`: offering "drop scanSamples" on an EDF+ file "sent the reader round a loop" (0.3.77).
+  Both were caught by reading, not by a test.
+- Eight refusals whose advice is a concrete instruction now have it followed: build the index and
+  pass it, for both `readWindow` and `sampleAt`; merge each contiguous run separately; read fewer
+  records **or** raise the budget, both levers exercised against the numbers the refusal reported;
+  call `readAnnotations` and pass `header.dataSignalIndices` instead; `findSignals` or an index for a
+  duplicate label; `decodeDigital` on a signal with no scale; one of the annotation signals or none
+  of them; and omitting `--limit` after a bad one.
+- Each case reads the clause off the message it actually threw before following it, so advice that
+  is reworded has to stay true rather than stay identical.
+
+## 0.5.33
+
+- **Added** an overlap driven through every surface that could call it a gap. This is the defect the
+  changelog has fixed four times. An overlap travels in `index.gaps` with a NEGATIVE duration —
+  0.2.69 decided that and `api-reading.md` documents it — so every consumer of that array has to
+  branch on the sign, and each one that did not printed "a gap of -0.2 s": a gap of negative
+  duration, with an explanation that inverts what an overlap does. Across a gap two samples are
+  seconds apart; across an overlap they cover the same time, so concatenating duplicates it rather
+  than skipping it.
+- 0.3.3 partitioned `edfcore gaps`. 0.3.33 applied the rule to "the two places that still said it
+  was". 0.3.41 found a third in `src/chunks.ts`, which mentioned an overlap nowhere. 0.3.59 found a
+  fourth forty lines below the third, on the branch a probed index actually reaches. Every fix was
+  local, and no test treated it as one rule over one file.
+- One overlapping recording now goes through all of them — both `mergeChunks` branches, the
+  validation report on an EDF+D and on an EDF+C that claims to be continuous, the CLI's summary line
+  and its tab-separated row, and the record probes at open — and each is asserted to use the word
+  `overlap` and to present no negative magnitude as a duration. The second is what would have failed
+  all four times: `gap of -0.2 s` is what the defect looked like on screen, at every one of them.
+- A blanket ban on the word "gap" would be wrong, and the test says so: the diagnostics correctly use
+  it in the rule they cite — "a discontinuous file may leave gaps between records but never overlaps
+  them" — which is the sentence that makes them understandable. The check is about how the observed
+  boundary is described, not about a vocabulary.
+- The three modules that partition a gap's own duration by its sign are read out of `src/`, so a
+  fourth consumer fails here until it is driven. That is the part that stops this being a fifth
+  local fix.
+
 ## 0.5.32
 
 - **Added** a lattice check over the ten microvolt values `quick-start.md` prints. That page prints

package/package.json

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