edfcore 0.5.48 → 0.5.50

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

package/docs/CHANGELOG.md

@@ -6,6 +6,48 @@ 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.50
+
+- **Added** three ways a header can be written and mean the same thing. Each is documented, each is
+  reached by real writers, and each was tested for the thing it produces rather than for the
+  equivalence it implies.
+- **A record count of `-1`.** `types.ts` says of the field: "Verbatim. `-1` means the writer never
+  closed the file." `parseHeader` recovers the count from the source's length and says so with
+  `RECORD_COUNT_RECOVERED` and `recordCountSource: 'sourceByteLength'`. `parse.test.ts` checks the
+  recovery; nothing checked that the recovered file is the same recording as one that declares its
+  count — which is the only reason recovering beats refusing.
+- **Either family's annotation label.** `annotations.md`: "edfcore accepts either label in either
+  family, because the label names the channel's *role*." `isAnnotationLabel` is tested on the
+  strings; whether a BDF+ file whose channel says `EDF Annotations` reads its events was not. Both
+  crossings now do, with the same events, the same record onsets and the same data indices — and the
+  label reported verbatim, which is the one thing that differs.
+- **NUL padding.** EDF pads with spaces; real writers pad with NUL, which is why `trimEdfField`
+  exists and why five docblocks in `src/` warn that `String.prototype.trim` does not strip it. The
+  function is tested. That the two paddings give the same header, with no diagnostic between them,
+  was not — and the test asserts that `.trim()` on the raw field really would have got it wrong, so
+  the equivalence is not a coincidence of the fixture.
+- Each is asserted as a whole-recording equivalence — every sample, every event, every derived
+  number — with the one legitimately differing field named beside it.
+
+## 0.5.49
+
+- **Added** the two things about an EDF+ annotations channel that are decisions of the writer rather
+  than facts about the recording: how wide the channel is declared, and which record a given TAL was
+  put in. `annotations.md` says the second in as many words — "`recordIndex` is where the event was
+  *stored*, which is not necessarily the record its onset falls in. Writers usually put an event in
+  the record covering it, but nothing in the format requires that" — and says the first by
+  implication: `samplesPerRecord` on that channel is what buys the writer room for text.
+- Neither was tested as a transformation. `tal/annotations.test.ts` reads events out of fixtures and
+  `annotations-page.test.ts` runs the page's file; both hold the layout fixed.
+- The same event is now written three ways — into record 0, into record 3 where its onset falls, and
+  into record 5, after it — and the resulting annotation must differ in exactly two fields:
+  `recordIndex`, which is the provenance the page tells you to use it for, and `byteOffsetInRecord`.
+  Onset, duration, text, channel, both axes and both exact tick counts are identical, and so is
+  every entry of `recordOnsetTicks` — a timekeeping TAL is not moved by where an ordinary one sits.
+- Then the width: the same events in a 20-sample region and in a 120-sample one, which is a record
+  200 bytes longer with every data offset moved, produce the same event list, the same record onsets
+  and the same samples.
+
 ## 0.5.48
 
 - **Added** two shapes to the `AWKWARD` matrix: a file with no records at all, and a file with

package/package.json

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