edfcore 0.6.37 → 0.6.39

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

package/docs/CHANGELOG.md

@@ -6,6 +6,45 @@ 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.6.39
+
+- **Added** four more promises to the set that is executed rather than read, over all seventeen
+  shapes. `the-page-says-always.test.ts` did this for the five on `api-reading.md` and found one
+  that was true and incomplete; these four are spread over two pages and a module docblock:
+  `matchSignals` never returns an annotations channel, events outside a window are never returned
+  even though the scan is record-aligned, `onsetRaw` never loses precision the file had, and
+  ISO-8859-1 is the identity map onto U+0000..U+00FF — which is the whole argument for decoding
+  header text by hand rather than with `TextDecoder`.
+- All four hold. The one worth looking at is the first: on the file whose only channel is an
+  annotations channel, `matchSignals(/.*/)` returns nothing at all. A helper that answered "every
+  signal" with the one signal there is would be exactly the mistake `api-helpers.md` calls "the
+  usual way" a montage filter ends up decoding a TAL region as if it were samples, and the empty
+  answer is that rule at its sharpest.
+- The window check uses windows narrower than a record, so a record-aligned scan has to be trimmed
+  to answer them; the decoder check crosses the 4096-byte boundary it chunks on, which a maximal
+  2.56 MB header crosses hundreds of times.
+
+## 0.6.38
+
+- **Documented** the third regime the sample helpers have. `api-helpers.md` described two: on a
+  contiguous file the recording-aware forms agree with the grid functions exactly, and on a
+  discontinuous one they differ by the gaps, with `sampleAt` able to answer `undefined` for an
+  instant in a hole.
+- A file whose records OVERLAP is neither. Two samples start at the same instant there, so
+  `sampleAt(sampleStartSecondsOf(recording, signal, i))` can answer with a sample that is not `i`
+  — on the shape added in 0.6.36 it does for twenty of the first forty-eight indices. No error, no
+  `undefined`: the sample it names does start at the instant asked for, and nothing can choose
+  between two that do. A caller round-tripping an index through an instant gets a different index
+  back, which is the answer the page did not prepare them for.
+- The page now names the regime, says how to detect it (`contiguityOf`, or the timeline's
+  `RECORD_ONSET_SPACING_VIOLATION`), and says to compare instants rather than indices.
+- `an-instant-two-samples-share.test.ts` executes the property in both forms over all seventeen
+  shapes: the weak one that holds everywhere — the sample found starts at the instant asked for —
+  and the strong one that holds on the sixteen whose records do not overlap. The overlapping shape
+  is asserted to be the only place they differ, and to differ on twenty indices rather than on one
+  edge case.
+- No library change: there is no better answer for it to give.
+
 ## 0.6.37
 
 - **Fixed** an incomplete sentence on `api-reading.md`. It said the index traversal "is chunked so

package/package.json

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