edfcore 0.4.400 → 0.4.402

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

package/docs/CHANGELOG.md

@@ -6,6 +6,44 @@ 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.402
+
+- **Added** tests for what `httpSource` accepts before it issues anything: a URL, a `fetch` and a
+  length. Three sentences on `api-sources.md` describe constructing a source, and all three were
+  prose.
+- "It accepts a `URL` object as well as a string, because `URL` structurally satisfies
+  `{ href: string }`." A `URL` is what `new URL(name, base)` hands you, so passing one is the
+  normal case rather than the clever one — and nothing here had ever passed anything but a string
+  literal.
+- `fetch` defaults to `globalThis.fetch`, and throws `EdfSourceError` at construction when neither
+  is available. That is the path every browser caller takes and the one no test could take, because
+  the suite replaces the global with a trap that refuses. It is exercised now by standing a
+  counting double in the global's place for the length of one test, which is the only way to
+  observe the fallback without reaching a network.
+- `byteLength` must be a non-negative safe integer. Its whole purpose is to skip the probes, so a
+  bad value is a value that would otherwise be trusted as the size of a resource nobody measured,
+  and every read is then range-checked against a fiction. Zero is accepted, because an empty
+  resource is a real one.
+
+## 0.4.401
+
+- **Added** a check that the palette has one definition. `tokens.css` opens by explaining the
+  pairing — the signal green carries the trace, the rose is semantic and marks events, and rose
+  rather than red because red-on-green is the one pairing red-green colourblindness collapses, with
+  the measured separation written down. That reasoning is worth something only while the colours it
+  describes are the colours a visitor sees.
+- Three places cannot say `var(--signal)` and so restate the value. `og.svg`, because an SVG
+  exported by `qlmanage` has no stylesheet: nine literal hexes. The two `theme-color` metas, because
+  the browser paints the chrome before any CSS arrives — wrong values put a stale band above and
+  below a scrolling page, on phones, where nobody developing the site is looking. And
+  `TraceStrip.astro`, which reads the tokens at runtime and is right to, but whose fallbacks are the
+  palette written a third way in decimal RGB — the copy least likely to be recognised as one.
+- Each is now required to be the specific token that does its job, resolved through `var()` the way
+  the cascade does: `theme-color` is `--bg` in each layer, the card's rose is on the annotation, and
+  each canvas fallback is its own token's default-theme value.
+- The beam head is deliberately exempt. Its core is a near-white green brighter than any token,
+  because a phosphor blowout is additive light and there is no palette entry for it.
+
 ## 0.4.400
 
 - **Added** a check that the two tsconfigs differ only where they are meant to. `npm run typecheck`

package/package.json

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