edfcore 0.6.111 → 0.6.112

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

package/dist/sample-grid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sample-grid.d.ts","sourceRoot":"","sources":["../src/sample-grid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAgC/D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,MAAM,GAC1B,iBAAiB,CAoBnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAiBR;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAKR"}
+{"version":3,"file":"sample-grid.d.ts","sourceRoot":"","sources":["../src/sample-grid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAyD/D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,MAAM,GAC1B,iBAAiB,CAoBnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAiBR;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAQR"}

package/dist/sample-grid.js

@@ -43,7 +43,28 @@
 import { TICKS_PER_SECOND } from './constants.js';
 import { secondsToTicks } from './tal/ticks.js';
 import { describeValue } from './text/describe.js';
-function assertGrid(signal, recordDurationTicks) {
+function assertGrid(signal, recordDurationTicks, call) {
+    /*
+     * Both arguments, before either is read. `signal.kind` on a chunk signal — the per-signal shape a
+     * reader holds after a read, and the one whose samples they are indexing — is `undefined`, so the
+     * whole family answered V8's `Cannot read properties of undefined (reading 'kind')`.
+     *
+     * The ticks are the sharper of the two. `recordDurationSeconds` sits beside
+     * `recordDurationTicks` on the same header, is a float, and reads as the obvious thing to pass;
+     * it reached `recordDurationTicks <= 0n` and threw "Cannot mix BigInt and other types, use
+     * explicit conversions", which names neither the argument nor the call nor which of the two
+     * fields to use (fixed in 0.6.112).
+     */
+    if (typeof signal?.kind !== 'string') {
+        throw new RangeError(`${call}(): the signal is ${describeValue(signal)}, not one of header.signals — a chunk ` +
+            'signal carries the samples rather than the grid they sit on. Next: pass ' +
+            'header.signals[chunkSignal.signalIndex], or resolve it with getSignal(header, label).');
+    }
+    if (typeof recordDurationTicks !== 'bigint') {
+        throw new RangeError(`${call}(): recordDurationTicks is ${describeValue(recordDurationTicks)}, not a BigInt. ` +
+            'Next: pass header.recordDurationTicks — the seconds beside it on the same header are a ' +
+            'float, and this family is exact on purpose.');
+    }
     if (signal.kind === 'annotations') {
         throw new RangeError(`signal ${signal.index} (${JSON.stringify(signal.label)}) is an annotations channel, ` +
             'whose region holds TAL text rather than samples, so it has no sample grid. Next: use ' +
@@ -74,7 +95,7 @@ function assertGrid(signal, recordDurationTicks) {
  * NEXT sample for anything past the halfway point, which puts a window boundary one sample late.
  */
 export function gridSampleIndexAt(signal, seconds, recordDurationTicks) {
-    assertGrid(signal, recordDurationTicks);
+    assertGrid(signal, recordDurationTicks, 'gridSampleIndexAt');
     const ticks = secondsToTicks(seconds, 'seconds');
     const perRecord = BigInt(signal.samplesPerRecord);
     // Exact integer arithmetic throughout: ticks * samplesPerRecord / recordDurationTicks, floored
@@ -106,7 +127,7 @@ export function gridSampleIndexAt(signal, seconds, recordDurationTicks) {
  * tick at or after the exact start keeps the two functions inverse for every index.
  */
 export function gridSampleStartTicks(signal, sampleIndex, recordDurationTicks) {
-    assertGrid(signal, recordDurationTicks);
+    assertGrid(signal, recordDurationTicks, 'gridSampleStartTicks');
     if (!Number.isSafeInteger(sampleIndex)) {
         throw new RangeError(`gridSampleStartTicks(): sampleIndex must be a whole number, received ` +
             `${describeValue(sampleIndex)}. ` +
@@ -124,6 +145,9 @@ export function gridSampleStartTicks(signal, sampleIndex, recordDurationTicks) {
 }
 /** `gridSampleStartTicks` in seconds, for display. Compare ticks, not this. */
 export function gridSampleStartSeconds(signal, sampleIndex, recordDurationTicks) {
+    // Its own, before the delegation, for the reason `sampleStartSecondsOf` grew one in 0.6.101: a
+    // reader who wrote this call should not be told about `gridSampleStartTicks`.
+    assertGrid(signal, recordDurationTicks, 'gridSampleStartSeconds');
     const ticks = gridSampleStartTicks(signal, sampleIndex, recordDurationTicks);
     const whole = ticks / TICKS_PER_SECOND;
     const remainder = ticks % TICKS_PER_SECOND;

package/dist/sample-grid.js.map

@@ -1 +1 @@
-{"version":3,"file":"sample-grid.js","sourceRoot":"","sources":["../src/sample-grid.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sample-grid.js","sourceRoot":"","sources":["../src/sample-grid.ts"],"names":[],"mappings":"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"}

package/docs/CHANGELOG.md

@@ -6,6 +6,22 @@ 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.112
+
+- **Fixed** the sample-grid family checking neither of its two arguments.
+- A chunk signal has no `kind` — it is the per-signal shape a reader holds after a read, and the one
+  whose samples they are indexing — so `gridSampleStartTicks`, `gridSampleStartSeconds` and
+  `gridSampleIndexAt` all answered `Cannot read properties of undefined (reading 'kind')` for one.
+- The record duration is the sharper of the two. `recordDurationSeconds` sits beside
+  `recordDurationTicks` on the same header, is a float, and reads as the obvious thing to pass; it
+  reached `recordDurationTicks <= 0n` and threw "Cannot mix BigInt and other types, use explicit
+  conversions", which names neither the argument, nor the call, nor which of the two fields to use.
+- **Behaviour change**: a hand-built partial signal is now refused. `{ samplesPerRecord: 128 }` cast
+  to `EdfSignal` reached the arithmetic before; it has no `kind`, and that is the field the
+  annotations refusal reads. Pass a signal from `header.signals`.
+- This is 0.6.101's fix on the pure half of the pair, and `gridSampleStartSeconds` got its own guard
+  before it delegates, for the same reason `sampleStartSecondsOf` did.
+
 ## 0.6.111
 
 - **Fixed** the five reading entry points 0.6.89's recording guard did not cover: `readAnnotations`,

package/package.json

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

package/src/sample-grid.ts

@@ -46,7 +46,32 @@ import { secondsToTicks } from './tal/ticks.js';
 import { describeValue } from './text/describe.js';
 import type { EdfSampleLocation, EdfSignal } from './types.js';
 
-function assertGrid(signal: EdfSignal, recordDurationTicks: bigint): void {
+function assertGrid(signal: EdfSignal, recordDurationTicks: bigint, call: string): void {
+  /*
+   * Both arguments, before either is read. `signal.kind` on a chunk signal — the per-signal shape a
+   * reader holds after a read, and the one whose samples they are indexing — is `undefined`, so the
+   * whole family answered V8's `Cannot read properties of undefined (reading 'kind')`.
+   *
+   * The ticks are the sharper of the two. `recordDurationSeconds` sits beside
+   * `recordDurationTicks` on the same header, is a float, and reads as the obvious thing to pass;
+   * it reached `recordDurationTicks <= 0n` and threw "Cannot mix BigInt and other types, use
+   * explicit conversions", which names neither the argument nor the call nor which of the two
+   * fields to use (fixed in 0.6.112).
+   */
+  if (typeof (signal as { kind?: unknown } | null | undefined)?.kind !== 'string') {
+    throw new RangeError(
+      `${call}(): the signal is ${describeValue(signal)}, not one of header.signals — a chunk ` +
+        'signal carries the samples rather than the grid they sit on. Next: pass ' +
+        'header.signals[chunkSignal.signalIndex], or resolve it with getSignal(header, label).',
+    );
+  }
+  if (typeof recordDurationTicks !== 'bigint') {
+    throw new RangeError(
+      `${call}(): recordDurationTicks is ${describeValue(recordDurationTicks)}, not a BigInt. ` +
+        'Next: pass header.recordDurationTicks — the seconds beside it on the same header are a ' +
+        'float, and this family is exact on purpose.',
+    );
+  }
   if (signal.kind === 'annotations') {
     throw new RangeError(
       `signal ${signal.index} (${JSON.stringify(signal.label)}) is an annotations channel, ` +
@@ -88,7 +113,7 @@ export function gridSampleIndexAt(
   seconds: number,
   recordDurationTicks: bigint,
 ): EdfSampleLocation {
-  assertGrid(signal, recordDurationTicks);
+  assertGrid(signal, recordDurationTicks, 'gridSampleIndexAt');
 
   const ticks = secondsToTicks(seconds, 'seconds');
   const perRecord = BigInt(signal.samplesPerRecord);
@@ -127,7 +152,7 @@ export function gridSampleStartTicks(
   sampleIndex: number,
   recordDurationTicks: bigint,
 ): bigint {
-  assertGrid(signal, recordDurationTicks);
+  assertGrid(signal, recordDurationTicks, 'gridSampleStartTicks');
   if (!Number.isSafeInteger(sampleIndex)) {
     throw new RangeError(
       `gridSampleStartTicks(): sampleIndex must be a whole number, received ` +
@@ -151,6 +176,9 @@ export function gridSampleStartSeconds(
   sampleIndex: number,
   recordDurationTicks: bigint,
 ): number {
+  // Its own, before the delegation, for the reason `sampleStartSecondsOf` grew one in 0.6.101: a
+  // reader who wrote this call should not be told about `gridSampleStartTicks`.
+  assertGrid(signal, recordDurationTicks, 'gridSampleStartSeconds');
   const ticks = gridSampleStartTicks(signal, sampleIndex, recordDurationTicks);
   const whole = ticks / TICKS_PER_SECOND;
   const remainder = ticks % TICKS_PER_SECOND;