edfcore 0.5.28 → 0.5.30

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.28";
+export declare const VERSION = "0.5.30";
 //# 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.28';
+export const VERSION = '0.5.30';
 //# 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.30
+
+- **Added** what `diagnostics.md` prints for one header, printed. The page introduces the two ways of
+  looking at a diagnostics array by showing both on the same file: `formatDiagnostics` renders one
+  entry in full, five detail lines and all, and `summarizeDiagnostics` reduces the same four
+  diagnostics to `total 4, errors 1, warnings 1, infos 2`. Neither transcript was run.
+  `diagnostics.test.ts` covers the vocabulary and the sink, `diagnostic-message-lines.test.ts` the
+  line discipline, and `summarize-diagnostics.test.ts` the counting rules — all against fixtures of
+  their own.
+- The rendered block is the one worth comparing whole. It is what a user pastes into an issue, and
+  every part of it is load-bearing differently: the severity and code a reader greps for, the
+  message, the byte offset they take to a hex editor, the raw bytes as written, the expected/actual
+  pair, and the spec clause. The page is the only place the whole shape appears.
+- The paragraph under it makes four smaller claims and each is now checked: no ANSI escapes unless
+  you ask; `color` adds them, and stripping them gives back the uncoloured text exactly, so colour
+  is decoration and not content; `maxItems` caps the blocks and appends `... and N more`, dimmed
+  with SGR 2 when colour is on; and `formatDiagnostics([])` returns the empty string rather than a
+  blank line, which is what lets it concatenate into a larger report.
+- The fixture is built to the page's own numbers rather than to a convenient shape — one error, one
+  warning and two infos is what the summary transcript says, and the two infos come from two
+  different codes because `byCode` is printed beside them.
+
+## 0.5.29
+
+- **Added** the contract `signalIndices` has to keep at all five reads that take one.
+  `duplicate-signal-indices.test.ts` covers two of the rules `api-reading.md` states — duplicates are
+  dropped, the order given is the order returned — over `readRecords`, `readWindow` and
+  `streamRecords`. It does not reach the two envelope entry points, and nothing covered what the
+  option does when it is wrong.
+- The refusals are the part worth pinning, because there are two of them and they are deliberately
+  different classes. An index the file does not have is an `EdfChannelNotFoundError`, an `EdfError`
+  carrying `selector` and `availableLabels` so a caller can offer the right one. An index naming the
+  annotations channel is a plain `RangeError`, because it can only be a caller's mistake and never a
+  file's — the bytes there are TAL text, and decoding them as samples produces numbers that look
+  exactly like a signal. `isEdfError` is the split, and a caller writing one `catch` for bad files
+  and another for bad calls depends on it holding at every entry point rather than at the one they
+  tested against.
+- There is no reason for five functions to diverge — they share `resolveSignals` — which is exactly
+  why it is worth a test: a sixth entry point, or one that grows its own validation to report
+  something friendlier, is how a shared rule stops being one. All nine functions in `src/` that take
+  a `signalIndices` are enumerated by resolving their parameter types, and split into the five under
+  test, the two shared helpers, and the two annotation reads whose `signalIndices` selects annotation
+  signals and inverts both rules.
+- Nine cases run at every one of the five: out of range, negative, fractional, the annotations
+  channel alone and mixed with a real signal, a repeat, a repeat out of order, a reversal, and an
+  empty selection — which returns no signals rather than all of them.
+
 ## 0.5.28
 
 - **Added** an already-aborted signal driven through every entry point that takes one.

package/package.json

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