edfcore 0.4.386 → 0.4.388

package/README.md

@@ -78,7 +78,7 @@ for (const event of annotations) {
 }
 ```
 
-> **Status: 0.4.x, early.** edfcore runs 1,900+ tests on generated fixtures, and it's checked
+> **Status: 0.4.x, early.** edfcore runs 2,000+ tests on generated fixtures, and it's checked
 > against public corpora it didn't author: the EDF, EDF+ and 24-bit BDF+ test files from
 > teuniz.net, and PhysioNet's sleep-edfx (a real 22-hour polysomnography recording and its
 > sleep-staging file). Those checks are numeric. Channels labelled `sine 8.5 Hz` decode to

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

package/docs/CHANGELOG.md

@@ -6,6 +6,43 @@ 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.4.388
+
+- **Fixed** the figure three places give for the size of this suite. The README said 1,900 or more
+  tests, the note at the foot of `installation.md` said 1,200 or more, and the docblock of
+  `browser-safety.test.ts` said 1,900-odd — three figures for one fact, the smallest of them eight
+  hundred behind. All three now say 2,000.
+- None of them was ever false, which is why nothing caught them. A claim of the form "N or more"
+  stays true forever once it is true, and the property that makes it safe is the property that
+  makes it worthless: it can never be wrong, so it is never re-read. What a reader takes from it is
+  a sense of scale, and half the real scale is a wrong impression conveyed in a true sentence.
+- **Added** the check that keeps it current: the figure has to be one figure wherever it is stated,
+  and no smaller than the number of `it(...)` and `test(...)` declarations the suite writes out. It
+  fails when the suite grows past what the pages claim, which is the direction this rots in.
+- It does not check the other direction. Four dozen of those declarations are `it.each(...)`,
+  expanding at run time to one case per row, so the count read out of the files is a floor rather
+  than the total — the right side to be wrong on, since a figure that clears it is true of the real
+  total too, but nothing here would notice one inflated past both.
+
+## 0.4.387
+
+- **Added** a check that the published `bin` runs as a program. `cli.test.ts` and the rest drive
+  `runCli` through an injected `CliIo`, deliberately, so they need no build; `cli-pipe.test.ts`
+  spawns the built file but always as `node dist/cli.js`, naming the interpreter itself. Between
+  them they covered every line of the program and none of the mechanism that starts it.
+- Delete the `#!/usr/bin/env node` from `src/cli.ts` and every test here still passes: the build
+  succeeds, `verify:tarball` finds the bin target in the tarball, and `node dist/cli.js header
+  f.edf` works exactly as before. `npx edfcore header f.edf` — the first command the README prints
+  — fails on the first line of JavaScript, because the shell it was handed to is not a JavaScript
+  engine.
+- So the built file is given the executable bit npm's tarball carries for a bin and run with no
+  interpreter named, which is the only way to check the shebang rather than the file's first line:
+  a CRLF ending, a leading blank line or a BOM each leave the text intact and the program
+  unloadable.
+- Both spawns close stdin and carry a timeout, because that failure does not look like an error. A
+  file with no shebang is handed to `/bin/sh`, which reads JavaScript as shell and sits waiting for
+  input — without the timeout a deleted shebang hangs the suite instead of failing it.
+
 ## 0.4.386
 
 - **Added** a property test for the window rule annotations are filtered by: overlap rather than

package/package.json

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