edf2csv 0.5.102 → 0.5.104

package/CHANGELOG.md

@@ -3,6 +3,63 @@
 Notable changes to edf2csv. Versions follow [semantic versioning](https://semver.org); while the
 major version is 0, a minor bump may contain breaking changes.
 
+## 0.5.104
+
+### Fixed: signals.csv and annotations.csv came out a thousand seconds apart, in silence
+
+The reserved field decides whether a recording's origin is applied. The annotation channel is
+found by its label. A file carrying an annotation channel whose timekeeping says the records
+begin at 1000s, with neither `EDF+C` nor `EDF+D` in its reserved field, got both halves of that:
+
+```
+$ head -2 out/signals.csv        $ cat out/annotations.csv
+time_s,EEG                       onset_s,duration_s,description,record_index
+0.000,0.0244                     1001.5,,event,1
+```
+
+One conversion, two files, a thousand seconds apart, exit 0 and nothing said — against a
+documented promise that "`onset_s` is on the same clock as `time_s` in the signal files".
+
+New warning `MISSING_EDF_PLUS_MARKER`, naming the offset and both consequences. Reported rather
+than repaired: which field is wrong is not knowable from inside the file. The marker says plain
+EDF and the annotation channel says otherwise; applying the origin moves every sample and
+ignoring the onsets moves every event, each on a guess. A file whose records begin at zero has
+no disagreement and says nothing.
+
+### Fixed: the docs test was checking 24 of the 27 diagnostic codes
+
+It reads the `DiagnosticCode` union by scanning to the semicolon that ends the declaration, and
+the members carry doc comments — so a semicolon inside one of those ended the scan three codes
+early. The checks built on it went on passing: the missing three were never looked for, and the
+opposite check called them codes the source does not have.
+
+Found by writing a comment containing a semicolon. Comments are stripped before the scan now,
+and the member count is checked against the source, because a guard that quietly measures less
+than it claims is the failure this file exists to prevent.
+
+## 0.5.103
+
+### Fixed: the advice for reaching an awkward channel printed a command that exits 2
+
+`NONPRINTABLE_LABEL` exists to say how to reach a channel whose header text you cannot type, so
+a hint whose command fails is worse than no hint. One branch of it quoted the label back:
+
+```
+warning: Signal 0's unit contains 1 control character (\x07), ...
+         The column name is unaffected, so --channels "" still selects it.
+```
+
+`--channels ""` exits 2 with "--channels was given but lists no channel names". The channel has
+no label — 0.5.73's `EMPTY_LABEL` message already says the position is the only way in for one
+of those, and this hint, added in 0.5.71 and widened in 0.5.102, did not.
+
+It gives `--channels "#0"` for an unlabelled channel now, and keeps quoting the label when there
+is one to quote.
+
+The test runs what the hint says rather than matching it, across all three branches — no label,
+a typeable label, an untypeable one — and requires the command to exit 0 and select a channel.
+Checking a hint any other way is checking the sentence rather than the advice.
+
 ## 0.5.102
 
 ### Fixed: NONPRINTABLE_LABEL checked two of the four free-text fields

package/dist/convert/timing.js

@@ -55,8 +55,39 @@ export function deriveRecordStarts(file, annotationData) {
       TAL of +0 needs no table at all, and that is nearly every file.
     */
     if (file.header.continuity !== 'EDF+D') {
-        if (file.header.continuity !== 'EDF+C')
+        if (file.header.continuity !== 'EDF+C') {
+            /*
+              An annotation channel the reserved field never claimed.
+      
+              Without an `EDF+C` or `EDF+D` marker this is a plain EDF file, so the origin is not
+              applied and the samples are timed from zero. The annotation channel is found by label
+              rather than by the marker, though, so its events are still read and exported — with
+              the onsets the file gives them.
+      
+              On a file whose timekeeping says the records start at 1000s, that put signals.csv at
+              0.000 and the event at 1000.5 in annotations.csv: two files from one conversion, a
+              thousand seconds apart, and nothing said so. output-files promises the opposite —
+              "`onset_s` is on the same clock as `time_s` in the signal files".
+      
+              Reported rather than repaired. Which clock is right is not knowable from here: the
+              marker says plain EDF and the annotation channel says otherwise, and picking one would
+              move either the samples or the events by the origin on a guess.
+            */
+            const stated = annotationData.recordStarts.find((start) => start !== null) ?? null;
+            if (stated !== null && Math.abs(stated) > 0) {
+                diagnostics.push({
+                    code: 'MISSING_EDF_PLUS_MARKER',
+                    severity: 'warning',
+                    message: `This file has an annotation channel stating that its records begin at ` +
+                        `${stated}s, but its reserved field carries no EDF+C or EDF+D marker — so it is ` +
+                        `read as plain EDF, time_s counts from zero, and the two disagree by ${stated}s.`,
+                    hint: 'annotations.csv keeps the onsets the file gives, so its events and signals.csv ' +
+                        'are on different clocks. Mark the file EDF+C, or subtract the offset from the ' +
+                        'onsets, before joining them.',
+                });
+            }
             return { starts: null, diagnostics };
+        }
         /*
           The origin comes from whichever record first states one, not from record 0 alone.
     

package/dist/convert/timing.js.map

@@ -1 +1 @@
-{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/convert/timing.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Diagnostic } from '../edf/errors.js';\nimport type { EdfFile } from '../edf/reader.js';\n\nexport interface AnnotationTimingData {\n  recordStarts: (number | null)[];\n  malformed: number;\n  /** Unreadable TALs in first position, which carry timing rather than an event. */\n  malformedTimekeeping?: number;\n}\n\n/**\n * Resolve the true start time of every data record.\n *\n * Continuous recordings need no table because their record positions are\n * arithmetic. EDF+D recordings carry their positions in the annotation channel;\n * missing or malformed timekeeping entries are reported before falling back.\n */\nexport function deriveRecordStarts(\n  file: EdfFile,\n  annotationData: AnnotationTimingData,\n): { starts: Float64Array | null; diagnostics: Diagnostic[] } {\n  const diagnostics: Diagnostic[] = [];\n\n  if (annotationData.malformed > 0) {\n    diagnostics.push({\n      code: 'ANNOTATION_DECODE_FAILED',\n      severity: 'warning',\n      message:\n        `${annotationData.malformed} annotation entr${annotationData.malformed === 1 ? 'y was' : 'ies were'} ` +\n        `unreadable and could not be exported.`,\n      hint: 'The rest were exported normally. The file may have been written by a non-conforming tool.',\n    });\n  }\n\n\n  /*\n    A timekeeping TAL is not an event, and saying it \"could not be exported\" describes the\n    wrong loss twice over.\n\n    These were counted among the annotations, so a file with one unreadable timekeeping TAL\n    and three good events announced \"1 annotation entry was unreadable and could not be\n    exported\" — while exporting all three. Nothing was missing from annotations.csv; what\n    went missing was a record's position in time, which the message never mentioned.\n  */\n  const lostTimekeeping = annotationData.malformedTimekeeping ?? 0;\n  // The EDF+D branch below raises its own, which names the records and is more specific.\n  // Saying both would report one problem twice.\n  if (lostTimekeeping > 0 && file.header.continuity !== 'EDF+D') {\n    const one = lostTimekeeping === 1;\n    diagnostics.push({\n      code: 'ANNOTATION_DECODE_FAILED',\n      severity: 'warning',\n      message:\n        `${lostTimekeeping} data record${one ? '' : 's'} carr${one ? 'ies' : 'y'} a timekeeping ` +\n        `annotation that could not be read, so ${one ? 'it does' : 'they do'} not say where in ` +\n        `time ${one ? 'it sits' : 'they sit'}.`,\n      hint:\n        'No event was lost — a timekeeping annotation states a record\\'s start time and is ' +\n        'never exported. Times are derived from the records that could be read.',\n    });\n  }\n\n  /*\n    A continuous recording's records are contiguous, but the first one need not sit at zero.\n\n    EDF+ puts the header's start time and every annotation onset on one origin, and says the\n    first data record's timekeeping TAL \"always starts with +0.X\", stating the fraction of a\n    second by which that record follows it. Ignoring that fraction timed the samples from 0\n    while the events kept their true onsets, so the two ended up on origins half a second\n    apart — an event at +0.75 in a 4 Hz recording whose first TAL reads +0.5 landed on sample\n    3 instead of sample 1. The same file marked EDF+D, byte-identical but for the reserved\n    field, placed it correctly, which is what gives the omission away.\n\n    Records stay contiguous, which is what continuous means: only the origin moves. A first\n    TAL of +0 needs no table at all, and that is nearly every file.\n  */\n  if (file.header.continuity !== 'EDF+D') {\n    if (file.header.continuity !== 'EDF+C') return { starts: null, diagnostics };\n\n    /*\n      The origin comes from whichever record first states one, not from record 0 alone.\n\n      Reading only `recordStarts[0]` meant a single unreadable timekeeping TAL threw the\n      origin away and timed the whole file from zero — while records 1 and 2, saying plainly\n      that they start at 1.5s and 2.5s, went unread. A recording whose records sit at 0.5s,\n      1.5s and 2.5s came out with every sample 0.5s earlier than the file states, against\n      annotation onsets that kept their true values. That is precisely the mismatch 0.4.9\n      fixed, arriving through the one hole left in it, and the byte-identical EDF+D twin\n      timed it correctly, which is what gives it away.\n\n      Continuity is what makes this recoverable: record i sits at `origin + i * duration`,\n      so any readable record determines the origin for all of them.\n    */\n    const origin = originOf(annotationData.recordStarts, file.header.recordDuration);\n    if (origin === null) return { starts: null, diagnostics };\n\n    const contiguous = new Float64Array(file.recordCount);\n    for (let i = 0; i < file.recordCount; i++) {\n      contiguous[i] = origin + i * file.header.recordDuration;\n    }\n\n    /*\n      A file marked continuous whose own records disagree about it.\n\n      Nothing looked at records past the first, so an EDF+C file whose records are in fact\n      spread out was timed as though they were contiguous and said nothing. The records are\n      being read here anyway, so the contradiction costs nothing to notice — and it is the\n      file, not the reader, that has to be wrong for this to fire.\n\n      Compared against what the file can express, not for equality. 0.4.41 asked whether the\n      two doubles were the same, which they are not: a recording of 0.1s records sitting at\n      0.1, 0.2, 0.3 ... is contiguous by construction, and 0.1 + 2 * 0.1 is\n      0.30000000000000004. Two of its eight records were reported as contradicting\n      continuity, on an ordinary file — and under --strict that was a failed run. The\n      smallest interval the recording distinguishes is one sample of its fastest channel;\n      anything below half of that is arithmetic, not a gap. `canCarry` has already refused\n      origins where the double spacing swamps that interval, so the representation error is\n      under the tolerance by construction rather than by hope.\n    */\n    const tolerance = finestInterval(file) / 2;\n    const contradicting = annotationData.recordStarts.filter(\n      (declared, i) =>\n        typeof declared === 'number' && Math.abs(declared - (contiguous[i] as number)) > tolerance,\n    ).length;\n    if (contradicting > 0) {\n      diagnostics.push({\n        code: 'DISCONTINUOUS',\n        severity: 'warning',\n        message:\n          `This file is marked continuous (EDF+C), but ${contradicting} of its ` +\n          `${file.recordCount} data records say they start somewhere other than where ` +\n          `continuity puts them.`,\n        hint:\n          'Times are written as if the records were contiguous, which is what EDF+C means. ' +\n          'If the recording really has gaps, the file should have been marked EDF+D.',\n      });\n    }\n    const first = origin;\n    const last = contiguous[file.recordCount - 1] ?? first;\n    if (!canCarry(last, file)) {\n      diagnostics.push(unusableOrigin(first, file));\n      return { starts: null, diagnostics };\n    }\n    /*\n      An origin of zero is the same as no origin, for timing. It is not the same for the\n      check above.\n\n      This returned early on `origin === 0`, which is right about the times — contiguous\n      starts from zero are what timing from zero already produces — and skipped the\n      contradiction check on the way past. So an EDF+C file whose records say 0, 5 and 10 on\n      one-second records went unreported, while the same file shifted one second, saying 1, 6\n      and 11, was reported. The contradiction is in records 1 and 2 either way; where record 0\n      happens to sit decides nothing about it.\n    */\n    if (origin === 0) return { starts: null, diagnostics };\n    return { starts: contiguous, diagnostics };\n  }\n\n  if (file.annotationSignals.length === 0) {\n    diagnostics.push({\n      code: 'DISCONTINUOUS',\n      severity: 'warning',\n      message:\n        'This file is marked discontinuous but has no annotation channel, so where its ' +\n        'records sit in time is not recorded anywhere.',\n      hint: 'Times are written as if the records were contiguous. Any gaps are lost.',\n    });\n    return { starts: null, diagnostics };\n  }\n\n  /*\n    A record with no readable time is placed from the origin the other records establish,\n    not from zero.\n\n    `i * recordDuration` assumed the recording began at zero, which is the one thing the\n    other records are in a position to contradict: a file starting at 0.5s put its\n    unreadable record at 0.000 while its neighbours sat at 1.5s and 2.5s. The guess is still\n    a guess — a discontinuous file may have a gap exactly there — and it is still reported\n    below, but starting it from where the recording actually begins is strictly closer, and\n    it makes an EDF+D file agree with its byte-identical EDF+C twin about record 0.\n  */\n  const base = originOf(annotationData.recordStarts, file.header.recordDuration) ?? 0;\n  const starts = new Float64Array(file.recordCount);\n  const missing: number[] = [];\n  for (let i = 0; i < file.recordCount; i++) {\n    const declared = annotationData.recordStarts[i];\n    if (declared === null || declared === undefined) {\n      missing.push(i);\n      starts[i] = base + i * file.header.recordDuration;\n    } else {\n      starts[i] = declared;\n    }\n  }\n\n  if (missing.length > 0) {\n    const shown = missing.slice(0, 5).join(', ');\n    diagnostics.push({\n      code: 'ANNOTATION_DECODE_FAILED',\n      severity: 'warning',\n      message:\n        `${missing.length} of ${file.recordCount} data records carry no readable timekeeping ` +\n        `annotation (record${missing.length === 1 ? '' : 's'} ${shown}` +\n        `${missing.length > 5 ? ', …' : ''}), so their true position in time is unknown.`,\n      hint: 'Those records are timed as if they were contiguous; treat their timestamps as unreliable.',\n    });\n  }\n\n  /*\n    Furthest from zero, in either direction.\n\n    This took the signed maximum and seeded it with 0, so a recording whose records all sit\n    at negative onsets never got past the seed: `furthest` stayed 0, which any interval can\n    carry. Then the samples collapsed anyway, because the arithmetic that defeats a large\n    positive origin defeats a large negative one identically — at -1e16 seconds, adding a\n    1-second sample interval leaves the double unchanged.\n\n    A four-record recording of eight samples wrote two rows, exit 0, no warning. Its\n    byte-for-byte positive mirror wrote all eight and explained why it had to time them from\n    zero. Same file, same failure, opposite sign, opposite outcome — and the silent one is\n    the one that loses data, which is exactly what unusableOrigin exists to prevent.\n  */\n  let furthest = 0;\n  for (const start of starts) if (Math.abs(start) > Math.abs(furthest)) furthest = start;\n  if (!canCarry(furthest, file)) {\n    diagnostics.push(unusableOrigin(furthest, file));\n    return { starts: null, diagnostics };\n  }\n\n  /*\n    Two ways a record can put the time column out of order, and only one was being looked for.\n\n    A record starting before the one before it is the obvious case. The other is a record\n    starting before the one before it *ends*: starts of 0, 0.5 and 1.0 on one-second records\n    are strictly increasing, so nothing fired, and the rows still came out 0.25, 0.5, 0.75,\n    0.5 — because record 0's samples run to 0.75 while record 1 begins at 0.5. Overlapping\n    acquisition is what a device does when it re-sends a buffer, and the reader has no more\n    to say about it than about the reversed case: every sample is written, in file order,\n    with the time the file gives it.\n\n    Contiguity is not overlap. A continuous recording has `starts[i] === starts[i-1] +\n    duration` exactly, so the comparison is made strict by a fraction of the finest interval\n    the recording can express — the same measure the origin check uses.\n  */\n  const slack = finestInterval(file) / 2;\n  let outOfOrder = 0;\n  let overlapping = 0;\n  for (let i = 1; i < starts.length; i++) {\n    const previous = starts[i - 1] as number;\n    const current = starts[i] as number;\n    if (current < previous) outOfOrder++;\n    else if (current + slack < previous + file.header.recordDuration) overlapping++;\n  }\n  if (outOfOrder > 0) {\n    diagnostics.push({\n      code: 'DISCONTINUOUS',\n      severity: 'warning',\n      message: `${outOfOrder} data record${outOfOrder === 1 ? '' : 's'} start earlier than the record before it.`,\n      hint: 'Rows are written in file order, so the time column will not increase monotonically.',\n    });\n  }\n  if (overlapping > 0) {\n    diagnostics.push({\n      code: 'DISCONTINUOUS',\n      severity: 'warning',\n      message:\n        `${overlapping} data record${overlapping === 1 ? '' : 's'} start before the record ` +\n        `before ${overlapping === 1 ? 'it' : 'them'} ends, so their samples overlap in time.`,\n      hint: 'Rows are written in file order, so the time column will not increase monotonically.',\n    });\n  }\n\n  return { starts, diagnostics };\n}\n\n/**\n * The recording's origin, from the first record that states where it is.\n *\n * Records of a continuous recording sit end to end, so record `i` beginning at `t` puts the\n * origin at `t - i * duration`. Any one readable timekeeping TAL is therefore enough, which\n * is what stops one unreadable entry from costing the whole file its position in time.\n */\nfunction originOf(recordStarts: readonly (number | null)[], recordDuration: number): number | null {\n  for (const [index, declared] of recordStarts.entries()) {\n    if (typeof declared !== 'number') continue;\n    const origin = declared - index * recordDuration;\n    return Number.isFinite(origin) ? origin : null;\n  }\n  return null;\n}\n\n/**\n * Whether times this far out can still tell one sample from the next.\n *\n * A double spaces its values further apart the larger they get: at 1e16 the gap is 2\n * seconds, so `t + 1` is `t`. Past that point a recording's declared origin stops being a\n * position and becomes a wall — the arithmetic that places records and samples returns the\n * origin itself, whatever is added to it.\n *\n * The finest thing that has to survive is the gap between two consecutive samples of the\n * fastest channel, since that is what the time column is made of. If that survives, so does\n * a whole record.\n */\nfunction canCarry(origin: number, file: EdfFile): boolean {\n  if (!Number.isFinite(origin)) return false;\n  // Asked of the origin furthest from zero, whichever side it is on: the spacing of doubles\n  // grows with magnitude, not with value, so -1e16 and +1e16 fail this identically.\n  return origin + finestInterval(file) > origin;\n}\n\n/**\n * The shortest span this recording can tell apart: one sample of its fastest channel.\n *\n * The time column is made of these, so nothing below one is a distinction the file is in a\n * position to make — which is what makes it the right size for both the \"can this origin\n * still separate two samples\" question and the \"is this record really somewhere else\"\n * question.\n */\nfunction finestInterval(file: EdfFile): number {\n  let interval = file.header.recordDuration;\n  for (const signal of file.header.signals) {\n    if (signal.isAnnotations || !(signal.samplesPerRecord > 0)) continue;\n    const step = file.header.recordDuration / signal.samplesPerRecord;\n    if (step > 0 && step < interval) interval = step;\n  }\n  return interval;\n}\n\n/**\n * An origin the file's own arithmetic cannot express, reported rather than acted on.\n *\n * Two things went wrong when this was taken at face value, both of them quiet. A file whose\n * records all collapsed onto one instant made the recording zero seconds long, and the\n * window resolver — which had no reason to suspect the recording rather than the request —\n * blamed a flag nobody had passed:\n *\n *     error: --start 100000000000000000s is at or past the end of this\n *            100000000000000000s recording.\n *\n * Slightly below that, the collapse is partial: `records[i].start + recordDuration` equals\n * the start again, so the test for \"does this record overlap the window\" fails for every\n * record whose neighbour rounded onto it. A twelve-row recording wrote four rows, exit 0,\n * no warning — the eight that vanished looked exactly like a file that never had them.\n *\n * Timing from zero is what the file did before 0.4.9 taught it to honour the first\n * timekeeping TAL, and at this magnitude it is the only column that can hold distinct\n * values. The origin is lost, so this says so.\n */\nfunction unusableOrigin(origin: number, file: EdfFile): Diagnostic {\n  return {\n    code: 'DISCONTINUOUS',\n    severity: 'warning',\n    message:\n      `This recording's timekeeping annotations place it ${origin}s from its own start ` +\n      `date, which is too far out for its ${file.header.recordDuration}s records to be told ` +\n      `apart: at that magnitude adding a sample interval leaves the number unchanged.`,\n    hint:\n      'Sample times are written from zero instead, so every row is present and the column ' +\n      'increases. Add the onsets in annotations.csv to recover absolute times if you need them.',\n  };\n}\n"]}
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/convert/timing.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Diagnostic } from '../edf/errors.js';\nimport type { EdfFile } from '../edf/reader.js';\n\nexport interface AnnotationTimingData {\n  recordStarts: (number | null)[];\n  malformed: number;\n  /** Unreadable TALs in first position, which carry timing rather than an event. */\n  malformedTimekeeping?: number;\n}\n\n/**\n * Resolve the true start time of every data record.\n *\n * Continuous recordings need no table because their record positions are\n * arithmetic. EDF+D recordings carry their positions in the annotation channel;\n * missing or malformed timekeeping entries are reported before falling back.\n */\nexport function deriveRecordStarts(\n  file: EdfFile,\n  annotationData: AnnotationTimingData,\n): { starts: Float64Array | null; diagnostics: Diagnostic[] } {\n  const diagnostics: Diagnostic[] = [];\n\n  if (annotationData.malformed > 0) {\n    diagnostics.push({\n      code: 'ANNOTATION_DECODE_FAILED',\n      severity: 'warning',\n      message:\n        `${annotationData.malformed} annotation entr${annotationData.malformed === 1 ? 'y was' : 'ies were'} ` +\n        `unreadable and could not be exported.`,\n      hint: 'The rest were exported normally. The file may have been written by a non-conforming tool.',\n    });\n  }\n\n\n  /*\n    A timekeeping TAL is not an event, and saying it \"could not be exported\" describes the\n    wrong loss twice over.\n\n    These were counted among the annotations, so a file with one unreadable timekeeping TAL\n    and three good events announced \"1 annotation entry was unreadable and could not be\n    exported\" — while exporting all three. Nothing was missing from annotations.csv; what\n    went missing was a record's position in time, which the message never mentioned.\n  */\n  const lostTimekeeping = annotationData.malformedTimekeeping ?? 0;\n  // The EDF+D branch below raises its own, which names the records and is more specific.\n  // Saying both would report one problem twice.\n  if (lostTimekeeping > 0 && file.header.continuity !== 'EDF+D') {\n    const one = lostTimekeeping === 1;\n    diagnostics.push({\n      code: 'ANNOTATION_DECODE_FAILED',\n      severity: 'warning',\n      message:\n        `${lostTimekeeping} data record${one ? '' : 's'} carr${one ? 'ies' : 'y'} a timekeeping ` +\n        `annotation that could not be read, so ${one ? 'it does' : 'they do'} not say where in ` +\n        `time ${one ? 'it sits' : 'they sit'}.`,\n      hint:\n        'No event was lost — a timekeeping annotation states a record\\'s start time and is ' +\n        'never exported. Times are derived from the records that could be read.',\n    });\n  }\n\n  /*\n    A continuous recording's records are contiguous, but the first one need not sit at zero.\n\n    EDF+ puts the header's start time and every annotation onset on one origin, and says the\n    first data record's timekeeping TAL \"always starts with +0.X\", stating the fraction of a\n    second by which that record follows it. Ignoring that fraction timed the samples from 0\n    while the events kept their true onsets, so the two ended up on origins half a second\n    apart — an event at +0.75 in a 4 Hz recording whose first TAL reads +0.5 landed on sample\n    3 instead of sample 1. The same file marked EDF+D, byte-identical but for the reserved\n    field, placed it correctly, which is what gives the omission away.\n\n    Records stay contiguous, which is what continuous means: only the origin moves. A first\n    TAL of +0 needs no table at all, and that is nearly every file.\n  */\n  if (file.header.continuity !== 'EDF+D') {\n    if (file.header.continuity !== 'EDF+C') {\n      /*\n        An annotation channel the reserved field never claimed.\n\n        Without an `EDF+C` or `EDF+D` marker this is a plain EDF file, so the origin is not\n        applied and the samples are timed from zero. The annotation channel is found by label\n        rather than by the marker, though, so its events are still read and exported — with\n        the onsets the file gives them.\n\n        On a file whose timekeeping says the records start at 1000s, that put signals.csv at\n        0.000 and the event at 1000.5 in annotations.csv: two files from one conversion, a\n        thousand seconds apart, and nothing said so. output-files promises the opposite —\n        \"`onset_s` is on the same clock as `time_s` in the signal files\".\n\n        Reported rather than repaired. Which clock is right is not knowable from here: the\n        marker says plain EDF and the annotation channel says otherwise, and picking one would\n        move either the samples or the events by the origin on a guess.\n      */\n      const stated = annotationData.recordStarts.find((start) => start !== null) ?? null;\n      if (stated !== null && Math.abs(stated) > 0) {\n        diagnostics.push({\n          code: 'MISSING_EDF_PLUS_MARKER',\n          severity: 'warning',\n          message:\n            `This file has an annotation channel stating that its records begin at ` +\n            `${stated}s, but its reserved field carries no EDF+C or EDF+D marker — so it is ` +\n            `read as plain EDF, time_s counts from zero, and the two disagree by ${stated}s.`,\n          hint:\n            'annotations.csv keeps the onsets the file gives, so its events and signals.csv ' +\n            'are on different clocks. Mark the file EDF+C, or subtract the offset from the ' +\n            'onsets, before joining them.',\n        });\n      }\n      return { starts: null, diagnostics };\n    }\n\n    /*\n      The origin comes from whichever record first states one, not from record 0 alone.\n\n      Reading only `recordStarts[0]` meant a single unreadable timekeeping TAL threw the\n      origin away and timed the whole file from zero — while records 1 and 2, saying plainly\n      that they start at 1.5s and 2.5s, went unread. A recording whose records sit at 0.5s,\n      1.5s and 2.5s came out with every sample 0.5s earlier than the file states, against\n      annotation onsets that kept their true values. That is precisely the mismatch 0.4.9\n      fixed, arriving through the one hole left in it, and the byte-identical EDF+D twin\n      timed it correctly, which is what gives it away.\n\n      Continuity is what makes this recoverable: record i sits at `origin + i * duration`,\n      so any readable record determines the origin for all of them.\n    */\n    const origin = originOf(annotationData.recordStarts, file.header.recordDuration);\n    if (origin === null) return { starts: null, diagnostics };\n\n    const contiguous = new Float64Array(file.recordCount);\n    for (let i = 0; i < file.recordCount; i++) {\n      contiguous[i] = origin + i * file.header.recordDuration;\n    }\n\n    /*\n      A file marked continuous whose own records disagree about it.\n\n      Nothing looked at records past the first, so an EDF+C file whose records are in fact\n      spread out was timed as though they were contiguous and said nothing. The records are\n      being read here anyway, so the contradiction costs nothing to notice — and it is the\n      file, not the reader, that has to be wrong for this to fire.\n\n      Compared against what the file can express, not for equality. 0.4.41 asked whether the\n      two doubles were the same, which they are not: a recording of 0.1s records sitting at\n      0.1, 0.2, 0.3 ... is contiguous by construction, and 0.1 + 2 * 0.1 is\n      0.30000000000000004. Two of its eight records were reported as contradicting\n      continuity, on an ordinary file — and under --strict that was a failed run. The\n      smallest interval the recording distinguishes is one sample of its fastest channel;\n      anything below half of that is arithmetic, not a gap. `canCarry` has already refused\n      origins where the double spacing swamps that interval, so the representation error is\n      under the tolerance by construction rather than by hope.\n    */\n    const tolerance = finestInterval(file) / 2;\n    const contradicting = annotationData.recordStarts.filter(\n      (declared, i) =>\n        typeof declared === 'number' && Math.abs(declared - (contiguous[i] as number)) > tolerance,\n    ).length;\n    if (contradicting > 0) {\n      diagnostics.push({\n        code: 'DISCONTINUOUS',\n        severity: 'warning',\n        message:\n          `This file is marked continuous (EDF+C), but ${contradicting} of its ` +\n          `${file.recordCount} data records say they start somewhere other than where ` +\n          `continuity puts them.`,\n        hint:\n          'Times are written as if the records were contiguous, which is what EDF+C means. ' +\n          'If the recording really has gaps, the file should have been marked EDF+D.',\n      });\n    }\n    const first = origin;\n    const last = contiguous[file.recordCount - 1] ?? first;\n    if (!canCarry(last, file)) {\n      diagnostics.push(unusableOrigin(first, file));\n      return { starts: null, diagnostics };\n    }\n    /*\n      An origin of zero is the same as no origin, for timing. It is not the same for the\n      check above.\n\n      This returned early on `origin === 0`, which is right about the times — contiguous\n      starts from zero are what timing from zero already produces — and skipped the\n      contradiction check on the way past. So an EDF+C file whose records say 0, 5 and 10 on\n      one-second records went unreported, while the same file shifted one second, saying 1, 6\n      and 11, was reported. The contradiction is in records 1 and 2 either way; where record 0\n      happens to sit decides nothing about it.\n    */\n    if (origin === 0) return { starts: null, diagnostics };\n    return { starts: contiguous, diagnostics };\n  }\n\n  if (file.annotationSignals.length === 0) {\n    diagnostics.push({\n      code: 'DISCONTINUOUS',\n      severity: 'warning',\n      message:\n        'This file is marked discontinuous but has no annotation channel, so where its ' +\n        'records sit in time is not recorded anywhere.',\n      hint: 'Times are written as if the records were contiguous. Any gaps are lost.',\n    });\n    return { starts: null, diagnostics };\n  }\n\n  /*\n    A record with no readable time is placed from the origin the other records establish,\n    not from zero.\n\n    `i * recordDuration` assumed the recording began at zero, which is the one thing the\n    other records are in a position to contradict: a file starting at 0.5s put its\n    unreadable record at 0.000 while its neighbours sat at 1.5s and 2.5s. The guess is still\n    a guess — a discontinuous file may have a gap exactly there — and it is still reported\n    below, but starting it from where the recording actually begins is strictly closer, and\n    it makes an EDF+D file agree with its byte-identical EDF+C twin about record 0.\n  */\n  const base = originOf(annotationData.recordStarts, file.header.recordDuration) ?? 0;\n  const starts = new Float64Array(file.recordCount);\n  const missing: number[] = [];\n  for (let i = 0; i < file.recordCount; i++) {\n    const declared = annotationData.recordStarts[i];\n    if (declared === null || declared === undefined) {\n      missing.push(i);\n      starts[i] = base + i * file.header.recordDuration;\n    } else {\n      starts[i] = declared;\n    }\n  }\n\n  if (missing.length > 0) {\n    const shown = missing.slice(0, 5).join(', ');\n    diagnostics.push({\n      code: 'ANNOTATION_DECODE_FAILED',\n      severity: 'warning',\n      message:\n        `${missing.length} of ${file.recordCount} data records carry no readable timekeeping ` +\n        `annotation (record${missing.length === 1 ? '' : 's'} ${shown}` +\n        `${missing.length > 5 ? ', …' : ''}), so their true position in time is unknown.`,\n      hint: 'Those records are timed as if they were contiguous; treat their timestamps as unreliable.',\n    });\n  }\n\n  /*\n    Furthest from zero, in either direction.\n\n    This took the signed maximum and seeded it with 0, so a recording whose records all sit\n    at negative onsets never got past the seed: `furthest` stayed 0, which any interval can\n    carry. Then the samples collapsed anyway, because the arithmetic that defeats a large\n    positive origin defeats a large negative one identically — at -1e16 seconds, adding a\n    1-second sample interval leaves the double unchanged.\n\n    A four-record recording of eight samples wrote two rows, exit 0, no warning. Its\n    byte-for-byte positive mirror wrote all eight and explained why it had to time them from\n    zero. Same file, same failure, opposite sign, opposite outcome — and the silent one is\n    the one that loses data, which is exactly what unusableOrigin exists to prevent.\n  */\n  let furthest = 0;\n  for (const start of starts) if (Math.abs(start) > Math.abs(furthest)) furthest = start;\n  if (!canCarry(furthest, file)) {\n    diagnostics.push(unusableOrigin(furthest, file));\n    return { starts: null, diagnostics };\n  }\n\n  /*\n    Two ways a record can put the time column out of order, and only one was being looked for.\n\n    A record starting before the one before it is the obvious case. The other is a record\n    starting before the one before it *ends*: starts of 0, 0.5 and 1.0 on one-second records\n    are strictly increasing, so nothing fired, and the rows still came out 0.25, 0.5, 0.75,\n    0.5 — because record 0's samples run to 0.75 while record 1 begins at 0.5. Overlapping\n    acquisition is what a device does when it re-sends a buffer, and the reader has no more\n    to say about it than about the reversed case: every sample is written, in file order,\n    with the time the file gives it.\n\n    Contiguity is not overlap. A continuous recording has `starts[i] === starts[i-1] +\n    duration` exactly, so the comparison is made strict by a fraction of the finest interval\n    the recording can express — the same measure the origin check uses.\n  */\n  const slack = finestInterval(file) / 2;\n  let outOfOrder = 0;\n  let overlapping = 0;\n  for (let i = 1; i < starts.length; i++) {\n    const previous = starts[i - 1] as number;\n    const current = starts[i] as number;\n    if (current < previous) outOfOrder++;\n    else if (current + slack < previous + file.header.recordDuration) overlapping++;\n  }\n  if (outOfOrder > 0) {\n    diagnostics.push({\n      code: 'DISCONTINUOUS',\n      severity: 'warning',\n      message: `${outOfOrder} data record${outOfOrder === 1 ? '' : 's'} start earlier than the record before it.`,\n      hint: 'Rows are written in file order, so the time column will not increase monotonically.',\n    });\n  }\n  if (overlapping > 0) {\n    diagnostics.push({\n      code: 'DISCONTINUOUS',\n      severity: 'warning',\n      message:\n        `${overlapping} data record${overlapping === 1 ? '' : 's'} start before the record ` +\n        `before ${overlapping === 1 ? 'it' : 'them'} ends, so their samples overlap in time.`,\n      hint: 'Rows are written in file order, so the time column will not increase monotonically.',\n    });\n  }\n\n  return { starts, diagnostics };\n}\n\n/**\n * The recording's origin, from the first record that states where it is.\n *\n * Records of a continuous recording sit end to end, so record `i` beginning at `t` puts the\n * origin at `t - i * duration`. Any one readable timekeeping TAL is therefore enough, which\n * is what stops one unreadable entry from costing the whole file its position in time.\n */\nfunction originOf(recordStarts: readonly (number | null)[], recordDuration: number): number | null {\n  for (const [index, declared] of recordStarts.entries()) {\n    if (typeof declared !== 'number') continue;\n    const origin = declared - index * recordDuration;\n    return Number.isFinite(origin) ? origin : null;\n  }\n  return null;\n}\n\n/**\n * Whether times this far out can still tell one sample from the next.\n *\n * A double spaces its values further apart the larger they get: at 1e16 the gap is 2\n * seconds, so `t + 1` is `t`. Past that point a recording's declared origin stops being a\n * position and becomes a wall — the arithmetic that places records and samples returns the\n * origin itself, whatever is added to it.\n *\n * The finest thing that has to survive is the gap between two consecutive samples of the\n * fastest channel, since that is what the time column is made of. If that survives, so does\n * a whole record.\n */\nfunction canCarry(origin: number, file: EdfFile): boolean {\n  if (!Number.isFinite(origin)) return false;\n  // Asked of the origin furthest from zero, whichever side it is on: the spacing of doubles\n  // grows with magnitude, not with value, so -1e16 and +1e16 fail this identically.\n  return origin + finestInterval(file) > origin;\n}\n\n/**\n * The shortest span this recording can tell apart: one sample of its fastest channel.\n *\n * The time column is made of these, so nothing below one is a distinction the file is in a\n * position to make — which is what makes it the right size for both the \"can this origin\n * still separate two samples\" question and the \"is this record really somewhere else\"\n * question.\n */\nfunction finestInterval(file: EdfFile): number {\n  let interval = file.header.recordDuration;\n  for (const signal of file.header.signals) {\n    if (signal.isAnnotations || !(signal.samplesPerRecord > 0)) continue;\n    const step = file.header.recordDuration / signal.samplesPerRecord;\n    if (step > 0 && step < interval) interval = step;\n  }\n  return interval;\n}\n\n/**\n * An origin the file's own arithmetic cannot express, reported rather than acted on.\n *\n * Two things went wrong when this was taken at face value, both of them quiet. A file whose\n * records all collapsed onto one instant made the recording zero seconds long, and the\n * window resolver — which had no reason to suspect the recording rather than the request —\n * blamed a flag nobody had passed:\n *\n *     error: --start 100000000000000000s is at or past the end of this\n *            100000000000000000s recording.\n *\n * Slightly below that, the collapse is partial: `records[i].start + recordDuration` equals\n * the start again, so the test for \"does this record overlap the window\" fails for every\n * record whose neighbour rounded onto it. A twelve-row recording wrote four rows, exit 0,\n * no warning — the eight that vanished looked exactly like a file that never had them.\n *\n * Timing from zero is what the file did before 0.4.9 taught it to honour the first\n * timekeeping TAL, and at this magnitude it is the only column that can hold distinct\n * values. The origin is lost, so this says so.\n */\nfunction unusableOrigin(origin: number, file: EdfFile): Diagnostic {\n  return {\n    code: 'DISCONTINUOUS',\n    severity: 'warning',\n    message:\n      `This recording's timekeeping annotations place it ${origin}s from its own start ` +\n      `date, which is too far out for its ${file.header.recordDuration}s records to be told ` +\n      `apart: at that magnitude adding a sample interval leaves the number unchanged.`,\n    hint:\n      'Sample times are written from zero instead, so every row is present and the column ' +\n      'increases. Add the onsets in annotations.csv to recover absolute times if you need them.',\n  };\n}\n"]}

package/dist/edf/errors.d.ts

@@ -15,7 +15,14 @@ export type DiagnosticCode = 'MIXED_SAMPLING_RATES' | 'DISCONTINUOUS' | 'RECORD_
  * `start_datetime_local` null in metadata.json with nothing saying why — on the field the
  * documented recipe for an absolute instant depends on.
  */
- | 'START_TIME_UNREADABLE'
+/**
+ * An annotation channel with a non-zero origin, in a file marked neither EDF+C nor EDF+D.
+ *
+ * The marker decides whether the origin is applied, and the annotation channel is found by
+ * label instead. So a file carrying one without the marker got samples timed from zero and events
+ * timed from the origin, and the two CSVs came out on clocks seconds apart.
+ */
+ | 'MISSING_EDF_PLUS_MARKER' | 'START_TIME_UNREADABLE'
 /**
  * `--info --stdout` on a recording `--stdout` would refuse.
  *

package/dist/edf/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/edf/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6DH;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAe;IACnB,IAAI,CAAqB;IAElC,YAAY,IAAkB,EAAE,OAAe,EAAE,IAAa;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF","sourcesContent":["/**\n * Error and diagnostic types.\n *\n * The distinction that matters here: an EdfError means we cannot produce\n * trustworthy output and must stop. A Diagnostic with severity 'warning' means\n * we can continue, but the user needs to know something about their data that\n * they would not otherwise see.\n */\n\nexport type DiagnosticCode =\n  | 'MIXED_SAMPLING_RATES'\n  | 'DISCONTINUOUS'\n  | 'RECORD_COUNT_UNKNOWN'\n  | 'RECORD_COUNT_MISMATCH'\n  | 'TRAILING_BYTES'\n  | 'DEGENERATE_DIGITAL_RANGE'\n  | 'DEGENERATE_PHYSICAL_RANGE'\n  | 'UNUSABLE_PHYSICAL_RANGE'\n  | 'INVERTED_PHYSICAL_RANGE'\n  | 'DUPLICATE_LABEL'\n  | 'EMPTY_LABEL'\n  | 'NO_ANNOTATIONS'\n  | 'ANNOTATION_DECODE_FAILED'\n  | 'COMMA_DECIMAL'\n  | 'LARGE_OUTPUT'\n  | 'NO_SIGNAL_CHANNELS'\n  | 'NO_SAMPLES'\n  | 'STALE_OUTPUT'\n  | 'INPUT_CHANGED'\n  | 'EMPTY_WINDOW'\n  | 'TIME_RESOLUTION'\n  | 'VALUE_RESOLUTION'\n  | 'HEADER_BYTES_MISMATCH'\n  | 'NONPRINTABLE_LABEL'\n  /**\n   * The header's start date or time is not a date or a time.\n   *\n   * Every other unusable header field reports itself. This one did not, so a recording whose\n   * timestamp cannot be read converted in silence, passed `--strict`, and left\n   * `start_datetime_local` null in metadata.json with nothing saying why — on the field the\n   * documented recipe for an absolute instant depends on.\n   */\n  | 'START_TIME_UNREADABLE'\n  /**\n   * `--info --stdout` on a recording `--stdout` would refuse.\n   *\n   * Only `--info` raises it. A conversion refuses outright instead, with the same words —\n   * this is that refusal shown ahead of time, which is what `--info` is for.\n   */\n  | 'STDOUT_UNSUPPORTED';\n\nexport interface Diagnostic {\n  code: DiagnosticCode;\n  severity: 'warning' | 'info';\n  message: string;\n  /** What the user can do about it. Omitted when there is nothing useful to say. */\n  hint?: string;\n}\n\nexport type EdfErrorCode =\n  | 'FILE_TOO_SMALL'\n  | 'BAD_HEADER_FIELD'\n  | 'NO_DATA_RECORDS'\n  | 'INVALID_SIGNAL_COUNT'\n  | 'INVALID_RECORD_DURATION'\n  | 'NO_SAMPLES'\n  | 'UNREADABLE';\n\n/**\n * A fatal problem with the recording itself. Carries a stable `code` so the CLI\n * can map it to an exit status, and a `hint` so the user is not left guessing.\n */\nexport class EdfError extends Error {\n  readonly code: EdfErrorCode;\n  readonly hint: string | undefined;\n\n  constructor(code: EdfErrorCode, message: string, hint?: string) {\n    super(message);\n    this.name = 'EdfError';\n    this.code = code;\n    this.hint = hint;\n  }\n}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/edf/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqEH;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAe;IACnB,IAAI,CAAqB;IAElC,YAAY,IAAkB,EAAE,OAAe,EAAE,IAAa;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF","sourcesContent":["/**\n * Error and diagnostic types.\n *\n * The distinction that matters here: an EdfError means we cannot produce\n * trustworthy output and must stop. A Diagnostic with severity 'warning' means\n * we can continue, but the user needs to know something about their data that\n * they would not otherwise see.\n */\n\nexport type DiagnosticCode =\n  | 'MIXED_SAMPLING_RATES'\n  | 'DISCONTINUOUS'\n  | 'RECORD_COUNT_UNKNOWN'\n  | 'RECORD_COUNT_MISMATCH'\n  | 'TRAILING_BYTES'\n  | 'DEGENERATE_DIGITAL_RANGE'\n  | 'DEGENERATE_PHYSICAL_RANGE'\n  | 'UNUSABLE_PHYSICAL_RANGE'\n  | 'INVERTED_PHYSICAL_RANGE'\n  | 'DUPLICATE_LABEL'\n  | 'EMPTY_LABEL'\n  | 'NO_ANNOTATIONS'\n  | 'ANNOTATION_DECODE_FAILED'\n  | 'COMMA_DECIMAL'\n  | 'LARGE_OUTPUT'\n  | 'NO_SIGNAL_CHANNELS'\n  | 'NO_SAMPLES'\n  | 'STALE_OUTPUT'\n  | 'INPUT_CHANGED'\n  | 'EMPTY_WINDOW'\n  | 'TIME_RESOLUTION'\n  | 'VALUE_RESOLUTION'\n  | 'HEADER_BYTES_MISMATCH'\n  | 'NONPRINTABLE_LABEL'\n  /**\n   * The header's start date or time is not a date or a time.\n   *\n   * Every other unusable header field reports itself. This one did not, so a recording whose\n   * timestamp cannot be read converted in silence, passed `--strict`, and left\n   * `start_datetime_local` null in metadata.json with nothing saying why — on the field the\n   * documented recipe for an absolute instant depends on.\n   */\n  /**\n   * An annotation channel with a non-zero origin, in a file marked neither EDF+C nor EDF+D.\n   *\n   * The marker decides whether the origin is applied, and the annotation channel is found by\n   * label instead. So a file carrying one without the marker got samples timed from zero and events\n   * timed from the origin, and the two CSVs came out on clocks seconds apart.\n   */\n  | 'MISSING_EDF_PLUS_MARKER'\n  | 'START_TIME_UNREADABLE'\n  /**\n   * `--info --stdout` on a recording `--stdout` would refuse.\n   *\n   * Only `--info` raises it. A conversion refuses outright instead, with the same words —\n   * this is that refusal shown ahead of time, which is what `--info` is for.\n   */\n  | 'STDOUT_UNSUPPORTED';\n\nexport interface Diagnostic {\n  code: DiagnosticCode;\n  severity: 'warning' | 'info';\n  message: string;\n  /** What the user can do about it. Omitted when there is nothing useful to say. */\n  hint?: string;\n}\n\nexport type EdfErrorCode =\n  | 'FILE_TOO_SMALL'\n  | 'BAD_HEADER_FIELD'\n  | 'NO_DATA_RECORDS'\n  | 'INVALID_SIGNAL_COUNT'\n  | 'INVALID_RECORD_DURATION'\n  | 'NO_SAMPLES'\n  | 'UNREADABLE';\n\n/**\n * A fatal problem with the recording itself. Carries a stable `code` so the CLI\n * can map it to an exit status, and a `hint` so the user is not left guessing.\n */\nexport class EdfError extends Error {\n  readonly code: EdfErrorCode;\n  readonly hint: string | undefined;\n\n  constructor(code: EdfErrorCode, message: string, hint?: string) {\n    super(message);\n    this.name = 'EdfError';\n    this.code = code;\n    this.hint = hint;\n  }\n}\n"]}

package/dist/edf/header.js

@@ -313,9 +313,20 @@ export function parseHeader(buf, fileSize) {
                     message: `Signal ${i}'s ${named} ${affected.length === 1 ? 'contains' : 'contain'} ` +
                         `${control.length} control character${plural} (${shown}), ${lands} exactly as the ` +
                         `header has them.`,
-                    hint: (inLabel
+                    hint: 
+                    /*
+                      Every branch has to print a command that works.
+        
+                      The middle one quoted the label back, which is right until the label is empty:
+                      an unlabelled channel got `--channels ""`, and that exits 2 with "--channels was
+                      given but lists no channel names". A hint whose command fails is worse than no
+                      hint, and this warning's whole job is to say how to reach a channel whose header
+                      text you cannot type. `EMPTY_LABEL` already says the position is the only way in
+                      for such a channel; so does this now.
+                    */
+                    (inLabel || label === ''
                         ? `Address the channel by position with --channels "#${i}" rather than by name, ` +
-                            'since the name cannot be typed. '
+                            `since ${inLabel ? 'the name cannot be typed' : 'it has no label'}. `
                         : `The column name is unaffected, so --channels "${label}" still selects it. `) +
                         'Printing the CSV to a terminal may do more than print it.',
                 });

package/dist/edf/header.js.map

@@ -1 +1 @@
-{"version":3,"file":"header.js","sourceRoot":"","sources":["../../src/edf/header.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * EDF / EDF+ header parsing.\n *\n * Layout (all fields are ASCII, left-justified, space-padded):\n *\n *   fixed header, 256 bytes\n *     0    8   version ('0', or 255 + 'BIOSEMI' for BDF)\n *     8   80   patient identification\n *    88   80   recording identification\n *   168    8   start date  dd.mm.yy\n *   176    8   start time  hh.mm.ss\n *   184    8   number of bytes in the header record\n *   192   44   reserved  ('EDF+C' / 'EDF+D' live here)\n *   236    8   number of data records (-1 if unknown)\n *   244    8   duration of a data record, in seconds (may be fractional)\n *   252    4   number of signals (ns)\n *\n *   signal header, ns * 256 bytes, stored FIELD-major rather than signal-major:\n *   all ns labels, then all ns transducer types, and so on.\n *     ns * 16   label\n *     ns * 80   transducer type\n *     ns *  8   physical dimension\n *     ns *  8   physical minimum\n *     ns *  8   physical maximum\n *     ns *  8   digital minimum\n *     ns *  8   digital maximum\n *     ns * 80   prefiltering\n *     ns *  8   number of samples in each data record\n *     ns * 32   reserved\n */\n\nimport { EdfError } from './errors.js';\nimport type { Diagnostic } from './errors.js';\nimport { counted, listed } from '../format/list.js';\nimport { decodeLatin1 } from './bytes.js';\n\n/** Label the EDF+ spec reserves for the annotations channel. */\nexport const ANNOTATIONS_LABEL = 'EDF Annotations';\n/** BDF+ uses its own spelling for the same channel. */\nexport const BDF_ANNOTATIONS_LABEL = 'BDF Annotations';\n\nexport const FIXED_HEADER_BYTES = 256;\nexport const SIGNAL_HEADER_BYTES = 256;\n\nexport interface EdfSignal {\n  /** Position in the file, 0-based. Stable even when labels collide. */\n  index: number;\n  label: string;\n  transducer: string;\n  physicalDimension: string;\n  physicalMin: number;\n  physicalMax: number;\n  digitalMin: number;\n  digitalMax: number;\n  prefiltering: string;\n  samplesPerRecord: number;\n  reserved: string;\n  /** True for the EDF+ 'EDF Annotations' channel, which carries text, not signal. */\n  isAnnotations: boolean;\n  /** samplesPerRecord / recordDuration, in Hz. */\n  samplingRate: number;\n  /** Byte offset of this signal's samples within one data record. */\n  byteOffsetInRecord: number;\n}\n\nexport interface EdfHeader {\n  version: string;\n  patientId: string;\n  recordingId: string;\n  /** Raw 'dd.mm.yy' as written in the file. */\n  startDateRaw: string;\n  /** Raw 'hh.mm.ss' as written in the file. */\n  startTimeRaw: string;\n  /** Resolved start instant, or null when the file's date/time fields are unusable. */\n  startDateTime: Date | null;\n  /**\n   * Header size in bytes, computed from the signal count rather than read from the field.\n   *\n   * Every data record offset is derived from this, so it has to be the one the layout\n   * actually uses: 256 for the fixed header plus 256 per signal. A writer that fills the\n   * field in carelessly is common enough to have its own warning, HEADER_BYTES_MISMATCH,\n   * and trusting the field over the arithmetic would put every sample at the wrong offset.\n   */\n  headerBytes: number;\n  /**\n   * What the header's own length field says, which need not be the above.\n   *\n   * Exposed for the same reason `declaredRecordCount` is: the two disagreeing is a fact\n   * about the file, and a caller checking how a recording was written should be able to see\n   * what it claimed rather than only what was believed.\n   */\n  declaredHeaderBytes: number;\n  reserved: string;\n  isEdfPlus: boolean;\n  /** True for BioSemi BDF/BDF+ files, whose samples are 3 bytes rather than 2. */\n  isBdf: boolean;\n  /** 'EDF+C' continuous, 'EDF+D' discontinuous, or null for plain EDF. */\n  continuity: 'EDF+C' | 'EDF+D' | null;\n  /** As declared in the header. -1 means \"unknown\", which the spec permits. */\n  declaredRecordCount: number;\n  recordDuration: number;\n  signalCount: number;\n  signals: EdfSignal[];\n  bytesPerSample: number;\n  recordBytes: number;\n}\n\n/** Everything derived by combining the header with the file's real size. */\nexport interface EdfHeaderInfo {\n  header: EdfHeader;\n  /** Record count implied by the actual file size — the one we trust for reading. */\n  recordCount: number;\n  /** Bytes after the last complete data record. */\n  trailingBytes: number;\n  diagnostics: Diagnostic[];\n}\n\n/**\n * A byte the terminal treats as an instruction rather than as text.\n *\n * C0 and C1, plus DEL. Tab is included deliberately: it is harmless to a terminal but it\n * makes a CSV column name that cannot be typed or matched reliably, which is the other half\n * of what this warning is for.\n */\nfunction isControlCharacter(character: string): boolean {\n  const code = character.codePointAt(0) as number;\n  return code <= 0x1f || (code >= 0x7f && code <= 0x9f);\n}\n\nconst dec = (buf: Uint8Array, start: number, len: number): string =>\n  decodeLatin1(buf, start, start + len);\n\n/** EDF fields are space-padded; trailing NULs also occur in files written by sloppy tools. */\nconst trimField = (s: string): string => s.replace(/[\\0\\s]+$/u, '').replace(/^\\s+/u, '');\n\n/**\n * How many signals the fixed header says there are, read exactly as `parseHeader` will.\n *\n * `EdfFile.open` needs this before it can know how much header to read, and it used to work\n * it out with its own `Number(...)` — which was NUL-tolerant but not comma-tolerant, unlike\n * every other numeric field here. A header written with a comma decimal separator, which\n * COMMA_DECIMAL exists to accept and which the documentation lists this field among, was\n * therefore never given its signal headers at all, and the file died on a message that\n * contradicted itself: \"needs a 768-byte header, but the file is only 848 bytes\".\n *\n * Sharing the parse is what keeps the two from disagreeing again about which files are\n * readable. Null means \"not a usable count\", and the caller reads no further header — the\n * real error then comes from `parseHeader`, which is the one place that decides.\n */\nexport function peekSignalCount(fixed: Uint8Array): number | null {\n  const count = Number(normaliseNumberField(dec(fixed, 252, 4)).text);\n  return Number.isInteger(count) && count > 0 ? count : null;\n}\n\n/** A numeric header field, trimmed and with a comma decimal separator turned into a dot. */\nfunction normaliseNumberField(raw: string): { text: string; sawComma: boolean } {\n  const text = trimField(raw);\n  // Some writers emit a comma decimal separator despite the spec requiring '.'.\n  if (text.includes(',') && !text.includes('.')) {\n    return { text: text.replace(',', '.'), sawComma: true };\n  }\n  return { text, sawComma: false };\n}\n\nfunction parseNumberField(\n  raw: string,\n  field: string,\n  { integer = false, sawComma }: { integer?: boolean; sawComma?: { value: boolean } } = {},\n): number {\n  const normalised = normaliseNumberField(raw);\n  const text = normalised.text;\n  if (normalised.sawComma && sawComma) sawComma.value = true;\n  if (text === '') {\n    throw new EdfError('BAD_HEADER_FIELD', `Header field \"${field}\" is empty.`);\n  }\n  const n = Number(text);\n  if (!Number.isFinite(n)) {\n    throw new EdfError(\n      'BAD_HEADER_FIELD',\n      `Header field \"${field}\" is not a number (found ${JSON.stringify(text)}).`,\n      'The file may be truncated, byte-shifted, or not an EDF file at all.',\n    );\n  }\n  if (integer && !Number.isInteger(n)) {\n    throw new EdfError(\n      'BAD_HEADER_FIELD',\n      `Header field \"${field}\" must be a whole number (found ${JSON.stringify(text)}).`,\n    );\n  }\n  return n;\n}\n\n/**\n * EDF stores a two-digit year. The spec pins the century: 85-99 mean 1985-1999\n * and 00-84 mean 2000-2084. Files outside 1985-2084 cannot express their date.\n */\nfunction resolveStartDateTime(dateRaw: string, timeRaw: string): Date | null {\n  const d = /^(\\d{2})[.\\-/](\\d{2})[.\\-/](\\d{2})$/u.exec(trimField(dateRaw));\n  const t = /^(\\d{2})[.:\\-](\\d{2})[.:\\-](\\d{2})$/u.exec(trimField(timeRaw));\n  if (!d || !t) return null;\n\n  const dd = Number(d[1]);\n  const mm = Number(d[2]);\n  const yy = Number(d[3]);\n  const hh = Number(t[1]);\n  const mi = Number(t[2]);\n  const ss = Number(t[3]);\n\n  if (mm < 1 || mm > 12 || dd < 1 || dd > 31 || hh > 23 || mi > 59 || ss > 60) return null;\n\n  const year = yy >= 85 ? 1900 + yy : 2000 + yy;\n  const date = new Date(Date.UTC(year, mm - 1, dd, hh, mi, Math.min(ss, 59)));\n  // Reject dates that rolled over, e.g. 31.02.\n  if (date.getUTCMonth() !== mm - 1 || date.getUTCDate() !== dd) return null;\n  return date;\n}\n\n/**\n * Parse the fixed 256-byte header plus the per-signal header block.\n *\n * @param buf   At least FIXED_HEADER_BYTES + ns * SIGNAL_HEADER_BYTES bytes.\n * @param fileSize Total size of the file on disk, used to derive the real record count.\n */\nexport function parseHeader(buf: Uint8Array, fileSize: number): EdfHeaderInfo {\n  const diagnostics: Diagnostic[] = [];\n  const sawComma = { value: false };\n\n  if (buf.length < FIXED_HEADER_BYTES) {\n    throw new EdfError(\n      'FILE_TOO_SMALL',\n      `File is ${fileSize} bytes; an EDF header alone needs at least ${FIXED_HEADER_BYTES}.`,\n    );\n  }\n\n  // BDF (BioSemi) marks itself with byte 255 followed by 'BIOSEMI', and stores\n  // 3-byte samples instead of 2. Everything else about the layout is identical.\n  const isBdf = buf[0] === 0xff && dec(buf, 1, 7) === 'BIOSEMI';\n  const version = isBdf ? 'BIOSEMI' : trimField(dec(buf, 0, 8));\n\n  const patientId = trimField(dec(buf, 8, 80));\n  const recordingId = trimField(dec(buf, 88, 80));\n  const startDateRaw = trimField(dec(buf, 168, 8));\n  const startTimeRaw = trimField(dec(buf, 176, 8));\n  const headerBytes = parseNumberField(dec(buf, 184, 8), 'number of header bytes', {\n    integer: true,\n    sawComma,\n  });\n  const reserved = trimField(dec(buf, 192, 44));\n  const declaredRecordCount = parseNumberField(dec(buf, 236, 8), 'number of data records', {\n    integer: true,\n    sawComma,\n  });\n  const recordDuration = parseNumberField(dec(buf, 244, 8), 'duration of a data record', {\n    sawComma,\n  });\n  const signalCount = parseNumberField(dec(buf, 252, 4), 'number of signals', {\n    integer: true,\n    sawComma,\n  });\n\n  if (signalCount <= 0) {\n    throw new EdfError(\n      'INVALID_SIGNAL_COUNT',\n      `Header declares ${signalCount} signals; expected at least 1.`,\n    );\n  }\n  if (!(recordDuration > 0)) {\n    throw new EdfError(\n      'INVALID_RECORD_DURATION',\n      `Header declares a data record duration of ${recordDuration}s; expected a positive number.`,\n    );\n  }\n\n  const expectedHeaderBytes = FIXED_HEADER_BYTES + signalCount * SIGNAL_HEADER_BYTES;\n  if (buf.length < expectedHeaderBytes) {\n    throw new EdfError(\n      'FILE_TOO_SMALL',\n      /*\n        Which of the two is actually short.\n\n        The file size was quoted either way, so a caller that had read too little — the\n        signal count parsed one way here and another way there — produced arithmetic that\n        refuted itself: \"needs a 768-byte header, but the file is only 848 bytes\". A reader\n        following that looks for a truncation that is not there.\n      */\n      `File declares ${signalCount} signals, which needs a ${expectedHeaderBytes}-byte header, ` +\n        (fileSize < expectedHeaderBytes\n          ? `but the file is only ${fileSize} bytes.`\n          : `but only ${buf.length} bytes of it were handed to the parser.`),\n    );\n  }\n  if (headerBytes !== expectedHeaderBytes) {\n    diagnostics.push({\n      code: 'HEADER_BYTES_MISMATCH',\n      severity: 'warning',\n      message:\n        `Header says it is ${headerBytes} bytes, but ${signalCount} signals require ` +\n        `${expectedHeaderBytes} bytes. Using the value computed from the signal count.`,\n    });\n  }\n\n  // Signal headers are field-major: all labels, then all transducers, and so on.\n  const base = FIXED_HEADER_BYTES;\n  const readField = (offsetUnits: number, width: number, i: number): string =>\n    dec(buf, base + offsetUnits * signalCount + i * width, width);\n\n  // EDF+ writes 'EDF+C'/'EDF+D' here; BDF+ writes 'BDF+C'/'BDF+D'. The two mean the\n  // same thing, so both are normalised to a single continuity marker.\n  const continuityTag = /^(?:EDF|BDF)\\+([CD])/u.exec(reserved);\n  const continuity: 'EDF+C' | 'EDF+D' | null =\n    continuityTag === null ? null : continuityTag[1] === 'D' ? 'EDF+D' : 'EDF+C';\n\n  const signals: EdfSignal[] = [];\n  let byteOffsetInRecord = 0;\n  const bytesPerSample = isBdf ? 3 : 2;\n  const seenLabels = new Map<string, number[]>();\n  const emptyLabels: number[] = [];\n\n  for (let i = 0; i < signalCount; i++) {\n    const label = trimField(readField(0, 16, i));\n    const transducer = trimField(readField(16, 80, i));\n    const physicalDimension = trimField(readField(96, 8, i));\n    const physicalMin = parseNumberField(readField(104, 8, i), `physical minimum (signal ${i})`, {\n      sawComma,\n    });\n    const physicalMax = parseNumberField(readField(112, 8, i), `physical maximum (signal ${i})`, {\n      sawComma,\n    });\n    const digitalMin = parseNumberField(readField(120, 8, i), `digital minimum (signal ${i})`, {\n      integer: true,\n      sawComma,\n    });\n    const digitalMax = parseNumberField(readField(128, 8, i), `digital maximum (signal ${i})`, {\n      integer: true,\n      sawComma,\n    });\n    const prefiltering = trimField(readField(136, 80, i));\n    const samplesPerRecord = parseNumberField(\n      readField(216, 8, i),\n      `samples per record (signal ${i})`,\n      { integer: true, sawComma },\n    );\n    const sigReserved = trimField(readField(224, 32, i));\n\n    if (samplesPerRecord < 0) {\n      throw new EdfError(\n        'BAD_HEADER_FIELD',\n        `Signal ${i} (\"${label}\") declares ${samplesPerRecord} samples per record.`,\n      );\n    }\n\n    const isAnnotations = label === ANNOTATIONS_LABEL || label === BDF_ANNOTATIONS_LABEL;\n\n    signals.push({\n      index: i,\n      label,\n      transducer,\n      physicalDimension,\n      physicalMin,\n      physicalMax,\n      digitalMin,\n      digitalMax,\n      prefiltering,\n      samplesPerRecord,\n      reserved: sigReserved,\n      isAnnotations,\n      samplingRate: samplesPerRecord / recordDuration,\n      byteOffsetInRecord,\n    });\n    byteOffsetInRecord += samplesPerRecord * bytesPerSample;\n\n    if (!isAnnotations) {\n      /*\n        A label is free text out of the file, and it becomes a column name in signals.csv.\n\n        `--info` has escaped control bytes since it was written, because an ANSI escape in a\n        header can drive the reader's terminal — `\\x1b[2J` clears the screen. The CSV had no\n        such protection and needed none for correctness: quoting makes any byte safe for a\n        parser, and this still passes the label through exactly as the file gives it, because\n        losing what the header says is not an improvement.\n\n        What was missing is the sentence saying so. A recording whose channel is labelled\n        `\\x1b[2Jgone` converted with no warning at all, and `cat signals.csv` then cleared\n        the terminal — while a script referencing that column by name carried an invisible\n        control character in it. NONPRINTABLE_LABEL has been declared and documented as\n        reserved since 0.1; this is it doing its job.\n      */\n      /*\n        Which of the two fields carries them, because the consequences are not the same.\n\n        The message said \"label or unit\", and then said the bytes \"will appear in the CSV\n        column name\" and that \"the name cannot be typed\" — both of which are about the label.\n        A channel labelled plainly `ECG` in a unit of `u\\x07V` got all of it: its column is\n        `ECG`, `--channels ECG` selects it and exits 0, and the byte is in channels.csv's\n        `unit` cell, which the warning never mentioned. Three sentences, none of them true of\n        the file that raised it, on a warning whose whole purpose is to say where an invisible\n        byte went.\n      */\n      /*\n        All four free-text fields, not the two that were checked.\n\n        `transducer` and `prefiltering` are free text out of the header exactly as the label\n        and the unit are, and they land in channels.csv exactly as the unit does — so an ESC\n        byte in a transducer field reached the CSV raw with nothing said, and `cat\n        channels.csv` would drive the terminal. That is the hazard this warning exists for,\n        two columns over. 0.5.71 made it name which field carries them; this is the rest of\n        the fields it can name.\n      */\n      const fields = [\n        ['label', label],\n        ['unit', physicalDimension],\n        ['transducer', transducer],\n        ['prefiltering', prefiltering],\n      ] as const;\n      const affected = fields.filter(([, text]) => [...text].some(isControlCharacter));\n      const control = affected.flatMap(([, text]) => [...text].filter(isControlCharacter));\n      if (control.length > 0) {\n        const shown = [...new Set(control)]\n          .map((c) => `\\\\x${(c.codePointAt(0) as number).toString(16).padStart(2, '0')}`)\n          .join(', ');\n        const plural = control.length === 1 ? '' : 's';\n        const inLabel = affected.some(([name]) => name === 'label');\n        // \"label and unit\", not \"label, unit\" — `listed` is for long enumerations that get\n        // truncated, and this is a sentence with at most four items in it.\n        const names = affected.map(([name]) => name);\n        const named =\n          names.length === 1\n            ? (names[0] as string)\n            : `${names.slice(0, -1).join(', ')} and ${names[names.length - 1] as string}`;\n        // Where they land, which is the question the reader has. A label becomes a column\n        // name in signals.csv; the other three are cells of channels.csv and nothing else.\n        // Named down to the cell when there is one of them, because that is the answer to\n        // \"where did it go\" — `channels.csv` alone leaves a reader scanning fourteen columns.\n        const cells = affected.filter(([name]) => name !== 'label').map(([name]) => name);\n        const where =\n          cells.length === 1 ? `channels.csv's ${cells[0] as string} cell` : 'channels.csv';\n        const lands =\n          inLabel && cells.length > 0\n            ? `which will appear in the CSV column name and in ${where}`\n            : inLabel\n              ? 'which will appear in the CSV column name'\n              : `which will appear in ${where}`;\n        diagnostics.push({\n          code: 'NONPRINTABLE_LABEL',\n          severity: 'warning',\n          message:\n            `Signal ${i}'s ${named} ${affected.length === 1 ? 'contains' : 'contain'} ` +\n            `${control.length} control character${plural} (${shown}), ${lands} exactly as the ` +\n            `header has them.`,\n          hint:\n            (inLabel\n              ? `Address the channel by position with --channels \"#${i}\" rather than by name, ` +\n                'since the name cannot be typed. '\n              : `The column name is unaffected, so --channels \"${label}\" still selects it. `) +\n            'Printing the CSV to a terminal may do more than print it.',\n        });\n      }\n\n      if (label === '') {\n        // Collected, not reported here: what this channel's column ends up called depends on\n        // whether some later channel is literally labelled `signal_<i>`, and inside this loop\n        // the later channels do not exist yet. See the pass below.\n        emptyLabels.push(i);\n      } else {\n        // Collected rather than reported here: a label repeated five times should\n        // produce one warning naming all five, not four near-identical pairs.\n        const seen = seenLabels.get(label);\n        if (seen) seen.push(i);\n        else seenLabels.set(label, [i]);\n      }\n\n      if (samplesPerRecord === 0) {\n        diagnostics.push({\n          code: 'NO_SAMPLES',\n          severity: 'warning',\n          message: `Signal ${i} (\"${label}\") carries no samples at all (0 per data record).`,\n          hint: 'It is described in channels.csv but left out of the converted data.',\n        });\n      }\n\n      /*\n        Too large to represent, and too small — the second was silent.\n\n        The gain is the span divided by the digital range, and a span of 2e-320 over 65,535\n        codes is 3e-325: below the smallest subnormal double, so it underflows to +0. The\n        scaler's flat-range branch then handed every code the same physical value, and a\n        channel of 65,536 distinct readings became one repeated number with nothing raised at\n        all. One power of ten away, at 1e-319, the same file raises VALUE_RESOLUTION.\n\n        Both are the same fact about the header — the span cannot be turned into a mapping —\n        so both get this code, and both leave the cells empty rather than filling them with a\n        value the header cannot justify.\n      */\n      const span = physicalMax - physicalMin;\n      const underflowed = span !== 0 && span / (digitalMax - digitalMin) === 0;\n      if (!Number.isFinite(span) || underflowed) {\n        diagnostics.push({\n          code: 'UNUSABLE_PHYSICAL_RANGE',\n          severity: 'warning',\n          message:\n            `Signal ${i} (\"${label}\") declares a physical range from ${physicalMin} to ` +\n            `${physicalMax}, whose span is too ${underflowed ? 'small' : 'large'} to ` +\n            `represent, so its values cannot be scaled.`,\n          hint: 'Its cells are left empty rather than filled with a value the header cannot justify.',\n        });\n      } else if (digitalMax === digitalMin) {\n        diagnostics.push({\n          code: 'DEGENERATE_DIGITAL_RANGE',\n          severity: 'warning',\n          message:\n            `Signal ${i} (\"${label}\") has digital minimum equal to digital maximum ` +\n            `(${digitalMin}), so its values cannot be scaled.`,\n          hint: 'Its cells are left empty rather than filled with a value the header cannot justify.',\n        });\n      } else if (physicalMax === physicalMin) {\n        diagnostics.push({\n          code: 'DEGENERATE_PHYSICAL_RANGE',\n          severity: 'warning',\n          message:\n            `Signal ${i} (\"${label}\") has physical minimum equal to physical maximum ` +\n            `(${physicalMin}), so every sample converts to the same value.`,\n        });\n      } else if ((physicalMax - physicalMin) * (digitalMax - digitalMin) < 0) {\n        /*\n          Polarity is inverted when the gain is negative, and the gain is\n          (physicalMax - physicalMin) / (digitalMax - digitalMin) — so it is the sign of the\n          two spans together that matters, not the physical pair alone.\n\n          Testing only `physicalMax < physicalMin` was wrong in both directions. A file with\n          its DIGITAL bounds reversed is just as inverted and drew no warning at all, handing\n          back sign-flipped EEG with nothing to indicate it. A file with BOTH pairs reversed\n          has a positive gain and is not inverted, yet was warned about — a message that was\n          simply untrue of that recording.\n        */\n        const reversed =\n          physicalMax < physicalMin\n            ? `physical minimum ${physicalMin} above physical maximum ${physicalMax}`\n            : `digital minimum ${digitalMin} above digital maximum ${digitalMax}`;\n        diagnostics.push({\n          code: 'INVERTED_PHYSICAL_RANGE',\n          severity: 'warning',\n          message: `Signal ${i} (\"${label}\") declares ${reversed}, which inverts its polarity.`,\n          hint: 'The values are converted exactly as the header specifies, inversion included.',\n        });\n      }\n    }\n  }\n\n  /*\n    What an unlabelled channel is actually called, which the message used to guess.\n\n    A channel with no label takes `signal_<index>` — unless another channel is literally\n    labelled that, which EDF permits, since labels are free text and nothing enforces anything\n    about them. Then both collide and both are suffixed. The warning said \"It will appear as\n    \"signal_0\"\" while the file's header read `time_s,signal_0_ch0,signal_0_ch1`: the one\n    sentence the run printed named a column that exists in neither signals.csv nor\n    channels.csv.\n\n    The other half was silent. The channel that genuinely carries the label `signal_0` lost\n    its own column name to a collision with a synthesised one, and nothing said so —\n    DUPLICATE_LABEL did not fire, because the two labels are not the same label. Both halves\n    are one sentence here, because they are one event.\n\n    No specific suffixed name is quoted. The suffix rule has a second pass for names that are\n    still shared afterwards, and a message that hard-coded `_ch<index>` would be guessing again\n    in exactly the way this is fixing.\n  */\n  for (const index of emptyLabels) {\n    const taken = seenLabels.get(`signal_${index}`);\n    diagnostics.push({\n      code: 'EMPTY_LABEL',\n      severity: 'warning',\n      message:\n        taken === undefined\n          ? `Signal ${index} has no label. It will appear as \"signal_${index}\".`\n          : `Signal ${index} has no label, so it takes the name \"signal_${index}\" — which ` +\n            `${taken.length === 1 ? 'signal' : 'signals'} ${listed(taken.map(String))} already ` +\n            `${taken.length === 1 ? 'carries' : 'carry'} as a label, so both columns are ` +\n            `suffixed with their position instead.`,\n    });\n  }\n\n  /*\n    A timestamp that is not one.\n\n    EDF gives the start date and time eight characters each, and nothing stops a writer\n    putting `32.13.99` and `25.61.61` there. `--info` has always echoed the raw fields with\n    \"(unparseable)\" beside them, but nothing was raised: the conversion exited 0, `--strict`\n    passed, and metadata.json recorded `start_datetime_local: null` with no note against it.\n\n    Every other unusable header field reports itself — a degenerate digital range, a physical\n    span that cannot be represented, a comma decimal separator, a header whose declared size\n    disagrees with its signal count. This was the one that did not, and it is the field\n    output-files points at for turning `time_s` into an absolute instant.\n  */\n  if (resolveStartDateTime(startDateRaw, startTimeRaw) === null) {\n    diagnostics.push({\n      code: 'START_TIME_UNREADABLE',\n      severity: 'warning',\n      message:\n        `The header's start date and time (\"${startDateRaw}\" and ` +\n        `\"${startTimeRaw}\") are not a date and a time, so the recording has ` +\n        `no start instant.`,\n      hint:\n        'time_s is unaffected — it counts from the start of the recording either way. What ' +\n        'cannot be done is turning it into a wall-clock instant, and metadata.json records ' +\n        'start_datetime_local as null.',\n    });\n  }\n\n  for (const [label, indices] of seenLabels) {\n    if (indices.length < 2) continue;\n    diagnostics.push({\n      code: 'DUPLICATE_LABEL',\n      severity: 'warning',\n      message: `${indices.length} signals share the label \"${label}\" (positions ${indices.join(', ')}).`,\n      hint: 'Their columns are suffixed with the signal number so they stay distinguishable.',\n    });\n  }\n\n  const recordBytes = byteOffsetInRecord;\n  if (recordBytes <= 0) {\n    throw new EdfError(\n      'NO_SAMPLES',\n      'No signal in this file carries any samples (every channel declares 0 samples per record).',\n    );\n  }\n\n  if (sawComma.value) {\n    diagnostics.push({\n      code: 'COMMA_DECIMAL',\n      severity: 'warning',\n      message: 'Some header numbers use a comma decimal separator, which the EDF spec does not allow.',\n      hint: 'They were read as decimal points. Check the values in the channel table.',\n    });\n  }\n\n  const dataBytes = fileSize - expectedHeaderBytes;\n  if (dataBytes < 0) {\n    throw new EdfError('FILE_TOO_SMALL', `File is smaller than its own header.`);\n  }\n  const recordCount = Math.floor(dataBytes / recordBytes);\n  const trailingBytes = dataBytes - recordCount * recordBytes;\n\n  if (recordCount === 0) {\n    /*\n      Which of the two, and with the numbers.\n\n      \"The recording was probably interrupted before any data was written\" is right about an\n      empty file and wrong about the other way to get here: a header declaring records larger\n      than the data present. A 606 KB file holding 589 KB of samples — 60% of one record, more\n      than half a million readings — was told no data was written, and the message carried no\n      figures at all, so nothing in it could be checked against the file. The declared record\n      size is the thing to look at, and it was the one thing not said.\n\n      Still an error either way. A record is the unit the format is addressed in, and there is\n      nothing smaller to convert.\n    */\n    const empty = dataBytes === 0;\n    throw new EdfError(\n      'NO_DATA_RECORDS',\n      empty\n        ? 'The file contains a header and no data at all.'\n        : `The file contains ${counted(dataBytes, 'byte')} of data, which is less than the ` +\n          `${recordBytes} its header says one data record takes.`,\n      empty\n        ? 'The recording was probably interrupted before any data was written.'\n        : 'Either the recording was cut short part way through its first record, or the ' +\n          'header describes records larger than the ones actually written. Check the ' +\n          'samples-per-record fields against the file size.',\n    );\n  }\n\n  if (declaredRecordCount === -1) {\n    diagnostics.push({\n      code: 'RECORD_COUNT_UNKNOWN',\n      severity: 'warning',\n      message:\n        `The header does not say how many data records the file has (-1), which the spec allows ` +\n        `for recordings still in progress. Using the ${counted(recordCount, 'record')} the file actually contains.`,\n    });\n  } else if (declaredRecordCount !== recordCount) {\n    diagnostics.push({\n      code: 'RECORD_COUNT_MISMATCH',\n      severity: 'warning',\n      message:\n        `The header declares ${declaredRecordCount} data records but the file contains ` +\n        `${recordCount}. Converting the ${counted(recordCount, 'record')} that ${recordCount === 1 ? 'is' : 'are'} present.`,\n      hint:\n        declaredRecordCount > recordCount\n          ? 'The recording looks truncated. It may have been cut short or copied incompletely.'\n          : 'The file is longer than its header claims.',\n    });\n  }\n\n  if (trailingBytes > 0) {\n    diagnostics.push({\n      code: 'TRAILING_BYTES',\n      severity: 'warning',\n      message: `${counted(trailingBytes, 'byte')} after the last complete data record ${trailingBytes === 1 ? 'was' : 'were'} ignored.`,\n    });\n  }\n\n  const isEdfPlus = continuity !== null;\n  if (continuity === 'EDF+D') {\n    diagnostics.push({\n      code: 'DISCONTINUOUS',\n      severity: 'warning',\n      message:\n        `This is a discontinuous (${isBdf ? 'BDF+D' : 'EDF+D'}) recording: its data records are ` +\n        `not contiguous in time.`,\n      hint: 'Each row carries its true recording time, so gaps stay visible instead of being closed.',\n    });\n  }\n\n  const dataSignals = signals.filter((s) => !s.isAnnotations);\n  if (dataSignals.length === 0) {\n    diagnostics.push({\n      code: 'NO_SIGNAL_CHANNELS',\n      severity: 'warning',\n      message: 'This file has no signal channels; it contains only EDF+ annotations.',\n    });\n  }\n\n  // A channel declaring zero samples per record has no sampling rate to speak of — it is\n  // reported separately as NO_SAMPLES and no file is written for it. Counting its nominal\n  // 0 Hz as a rate made a single-rate recording warn that it used \"2 different sampling\n  // rates (4 Hz, 0 Hz)\" and claim it was splitting output it never split.\n  const rates = new Set(dataSignals.filter((s) => s.samplesPerRecord > 0).map((s) => s.samplingRate));\n  if (rates.size > 1) {\n    diagnostics.push({\n      code: 'MIXED_SAMPLING_RATES',\n      severity: 'warning',\n      message:\n        `Channels use ${rates.size} different sampling rates ` +\n        `(${listed(formatRates([...rates].sort((a, b) => b - a)).map((r) => `${r} Hz`))}).`,\n      hint: 'They are written to one file per rate so no channel is resampled.',\n    });\n  }\n\n  return {\n    header: {\n      version,\n      patientId,\n      recordingId,\n      startDateRaw,\n      startTimeRaw,\n      startDateTime: resolveStartDateTime(startDateRaw, startTimeRaw),\n      headerBytes: expectedHeaderBytes,\n      declaredHeaderBytes: headerBytes,\n      reserved,\n      isEdfPlus,\n      isBdf,\n      continuity,\n      declaredRecordCount,\n      recordDuration,\n      signalCount,\n      signals,\n      bytesPerSample,\n      recordBytes,\n    },\n    recordCount,\n    trailingBytes,\n    diagnostics,\n  };\n}\n\n/**\n * The recording start as a zone-less wall clock, \"YYYY-MM-DDTHH:MM:SS\".\n *\n * EDF stores the start time as local wall-clock digits with no timezone anywhere in\n * the format. `startDateTime` is built with Date.UTC purely so those digits survive a\n * round trip unshifted, which makes it a carrier for the wall clock rather than a\n * real instant. Serialising it with `toISOString()` would append a Z and assert UTC,\n * and any reader converting to local time would then shift the recording by their own\n * offset: 13:43:04 in the file becomes 08:43:04 in New York. The Z is omitted because\n * the file genuinely does not say which zone it meant.\n */\nexport function formatWallClock(date: Date | null): string | null {\n  if (!date) return null;\n  return date.toISOString().slice(0, 19);\n}\n\n/** \"EDF\", \"EDF+ (EDF+D)\", \"BDF\", \"BDF+ (EDF+C)\". */\nexport function describeFormat(header: EdfHeader): string {\n  const base = header.isBdf ? 'BDF' : 'EDF';\n  if (!header.isEdfPlus) return base;\n  return `${base}+ (${header.continuity === 'EDF+D' ? 'discontinuous' : 'continuous'})`;\n}\n\n/** Render a sampling rate without trailing noise: 256, 0.5, 12.5. */\nexport function formatRate(hz: number): string {\n  if (Number.isInteger(hz)) return String(hz);\n  const rounded = Number(hz.toFixed(6));\n  // A rate below 5e-7 rounds away to \"0\", which reads as \"this channel has no sampling\n  // rate\" and made the mixed-rate warning contradict itself: it announced two different\n  // rates and then printed both as \"0 Hz\". Exponent form keeps a real rate legible, and\n  // keeps distinct rates distinct in the channel table and in output filenames.\n  if (rounded === 0) return hz.toExponential(3);\n  return String(rounded);\n}\n\n/**\n * Renders a group of rates so that rates which differ read as differing.\n *\n * `formatRate` rounds to six decimals, which is what keeps an ordinary rate free of\n * float noise — 30 samples in a 0.1-second record is 299.99999999999994 as a double,\n * and belongs on screen as 300. Two rates separated by less than that round to one\n * string, so a file carrying 1e-6 Hz and 1.25e-6 Hz warned that it used \"2 different\n * sampling rates (0.000001 Hz, 0.000001 Hz)\" and named both files the same thing.\n *\n * That is the contradiction the exponent fallback above already removes for rates that\n * round away to zero; this is the same one a step further out. On a collision every rate\n * in the group switches to its shortest exact form, which is unique for distinct values,\n * rather than only the pair that collided — one column in one notation reads better than\n * two.\n */\nexport function formatRates(rates: readonly number[]): string[] {\n  const rounded = rates.map(formatRate);\n  const distinct = new Set(rates).size;\n  return new Set(rounded).size === distinct ? rounded : rates.map((hz) => String(hz));\n}\n"]}
+{"version":3,"file":"header.js","sourceRoot":"","sources":["../../src/edf/header.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * EDF / EDF+ header parsing.\n *\n * Layout (all fields are ASCII, left-justified, space-padded):\n *\n *   fixed header, 256 bytes\n *     0    8   version ('0', or 255 + 'BIOSEMI' for BDF)\n *     8   80   patient identification\n *    88   80   recording identification\n *   168    8   start date  dd.mm.yy\n *   176    8   start time  hh.mm.ss\n *   184    8   number of bytes in the header record\n *   192   44   reserved  ('EDF+C' / 'EDF+D' live here)\n *   236    8   number of data records (-1 if unknown)\n *   244    8   duration of a data record, in seconds (may be fractional)\n *   252    4   number of signals (ns)\n *\n *   signal header, ns * 256 bytes, stored FIELD-major rather than signal-major:\n *   all ns labels, then all ns transducer types, and so on.\n *     ns * 16   label\n *     ns * 80   transducer type\n *     ns *  8   physical dimension\n *     ns *  8   physical minimum\n *     ns *  8   physical maximum\n *     ns *  8   digital minimum\n *     ns *  8   digital maximum\n *     ns * 80   prefiltering\n *     ns *  8   number of samples in each data record\n *     ns * 32   reserved\n */\n\nimport { EdfError } from './errors.js';\nimport type { Diagnostic } from './errors.js';\nimport { counted, listed } from '../format/list.js';\nimport { decodeLatin1 } from './bytes.js';\n\n/** Label the EDF+ spec reserves for the annotations channel. */\nexport const ANNOTATIONS_LABEL = 'EDF Annotations';\n/** BDF+ uses its own spelling for the same channel. */\nexport const BDF_ANNOTATIONS_LABEL = 'BDF Annotations';\n\nexport const FIXED_HEADER_BYTES = 256;\nexport const SIGNAL_HEADER_BYTES = 256;\n\nexport interface EdfSignal {\n  /** Position in the file, 0-based. Stable even when labels collide. */\n  index: number;\n  label: string;\n  transducer: string;\n  physicalDimension: string;\n  physicalMin: number;\n  physicalMax: number;\n  digitalMin: number;\n  digitalMax: number;\n  prefiltering: string;\n  samplesPerRecord: number;\n  reserved: string;\n  /** True for the EDF+ 'EDF Annotations' channel, which carries text, not signal. */\n  isAnnotations: boolean;\n  /** samplesPerRecord / recordDuration, in Hz. */\n  samplingRate: number;\n  /** Byte offset of this signal's samples within one data record. */\n  byteOffsetInRecord: number;\n}\n\nexport interface EdfHeader {\n  version: string;\n  patientId: string;\n  recordingId: string;\n  /** Raw 'dd.mm.yy' as written in the file. */\n  startDateRaw: string;\n  /** Raw 'hh.mm.ss' as written in the file. */\n  startTimeRaw: string;\n  /** Resolved start instant, or null when the file's date/time fields are unusable. */\n  startDateTime: Date | null;\n  /**\n   * Header size in bytes, computed from the signal count rather than read from the field.\n   *\n   * Every data record offset is derived from this, so it has to be the one the layout\n   * actually uses: 256 for the fixed header plus 256 per signal. A writer that fills the\n   * field in carelessly is common enough to have its own warning, HEADER_BYTES_MISMATCH,\n   * and trusting the field over the arithmetic would put every sample at the wrong offset.\n   */\n  headerBytes: number;\n  /**\n   * What the header's own length field says, which need not be the above.\n   *\n   * Exposed for the same reason `declaredRecordCount` is: the two disagreeing is a fact\n   * about the file, and a caller checking how a recording was written should be able to see\n   * what it claimed rather than only what was believed.\n   */\n  declaredHeaderBytes: number;\n  reserved: string;\n  isEdfPlus: boolean;\n  /** True for BioSemi BDF/BDF+ files, whose samples are 3 bytes rather than 2. */\n  isBdf: boolean;\n  /** 'EDF+C' continuous, 'EDF+D' discontinuous, or null for plain EDF. */\n  continuity: 'EDF+C' | 'EDF+D' | null;\n  /** As declared in the header. -1 means \"unknown\", which the spec permits. */\n  declaredRecordCount: number;\n  recordDuration: number;\n  signalCount: number;\n  signals: EdfSignal[];\n  bytesPerSample: number;\n  recordBytes: number;\n}\n\n/** Everything derived by combining the header with the file's real size. */\nexport interface EdfHeaderInfo {\n  header: EdfHeader;\n  /** Record count implied by the actual file size — the one we trust for reading. */\n  recordCount: number;\n  /** Bytes after the last complete data record. */\n  trailingBytes: number;\n  diagnostics: Diagnostic[];\n}\n\n/**\n * A byte the terminal treats as an instruction rather than as text.\n *\n * C0 and C1, plus DEL. Tab is included deliberately: it is harmless to a terminal but it\n * makes a CSV column name that cannot be typed or matched reliably, which is the other half\n * of what this warning is for.\n */\nfunction isControlCharacter(character: string): boolean {\n  const code = character.codePointAt(0) as number;\n  return code <= 0x1f || (code >= 0x7f && code <= 0x9f);\n}\n\nconst dec = (buf: Uint8Array, start: number, len: number): string =>\n  decodeLatin1(buf, start, start + len);\n\n/** EDF fields are space-padded; trailing NULs also occur in files written by sloppy tools. */\nconst trimField = (s: string): string => s.replace(/[\\0\\s]+$/u, '').replace(/^\\s+/u, '');\n\n/**\n * How many signals the fixed header says there are, read exactly as `parseHeader` will.\n *\n * `EdfFile.open` needs this before it can know how much header to read, and it used to work\n * it out with its own `Number(...)` — which was NUL-tolerant but not comma-tolerant, unlike\n * every other numeric field here. A header written with a comma decimal separator, which\n * COMMA_DECIMAL exists to accept and which the documentation lists this field among, was\n * therefore never given its signal headers at all, and the file died on a message that\n * contradicted itself: \"needs a 768-byte header, but the file is only 848 bytes\".\n *\n * Sharing the parse is what keeps the two from disagreeing again about which files are\n * readable. Null means \"not a usable count\", and the caller reads no further header — the\n * real error then comes from `parseHeader`, which is the one place that decides.\n */\nexport function peekSignalCount(fixed: Uint8Array): number | null {\n  const count = Number(normaliseNumberField(dec(fixed, 252, 4)).text);\n  return Number.isInteger(count) && count > 0 ? count : null;\n}\n\n/** A numeric header field, trimmed and with a comma decimal separator turned into a dot. */\nfunction normaliseNumberField(raw: string): { text: string; sawComma: boolean } {\n  const text = trimField(raw);\n  // Some writers emit a comma decimal separator despite the spec requiring '.'.\n  if (text.includes(',') && !text.includes('.')) {\n    return { text: text.replace(',', '.'), sawComma: true };\n  }\n  return { text, sawComma: false };\n}\n\nfunction parseNumberField(\n  raw: string,\n  field: string,\n  { integer = false, sawComma }: { integer?: boolean; sawComma?: { value: boolean } } = {},\n): number {\n  const normalised = normaliseNumberField(raw);\n  const text = normalised.text;\n  if (normalised.sawComma && sawComma) sawComma.value = true;\n  if (text === '') {\n    throw new EdfError('BAD_HEADER_FIELD', `Header field \"${field}\" is empty.`);\n  }\n  const n = Number(text);\n  if (!Number.isFinite(n)) {\n    throw new EdfError(\n      'BAD_HEADER_FIELD',\n      `Header field \"${field}\" is not a number (found ${JSON.stringify(text)}).`,\n      'The file may be truncated, byte-shifted, or not an EDF file at all.',\n    );\n  }\n  if (integer && !Number.isInteger(n)) {\n    throw new EdfError(\n      'BAD_HEADER_FIELD',\n      `Header field \"${field}\" must be a whole number (found ${JSON.stringify(text)}).`,\n    );\n  }\n  return n;\n}\n\n/**\n * EDF stores a two-digit year. The spec pins the century: 85-99 mean 1985-1999\n * and 00-84 mean 2000-2084. Files outside 1985-2084 cannot express their date.\n */\nfunction resolveStartDateTime(dateRaw: string, timeRaw: string): Date | null {\n  const d = /^(\\d{2})[.\\-/](\\d{2})[.\\-/](\\d{2})$/u.exec(trimField(dateRaw));\n  const t = /^(\\d{2})[.:\\-](\\d{2})[.:\\-](\\d{2})$/u.exec(trimField(timeRaw));\n  if (!d || !t) return null;\n\n  const dd = Number(d[1]);\n  const mm = Number(d[2]);\n  const yy = Number(d[3]);\n  const hh = Number(t[1]);\n  const mi = Number(t[2]);\n  const ss = Number(t[3]);\n\n  if (mm < 1 || mm > 12 || dd < 1 || dd > 31 || hh > 23 || mi > 59 || ss > 60) return null;\n\n  const year = yy >= 85 ? 1900 + yy : 2000 + yy;\n  const date = new Date(Date.UTC(year, mm - 1, dd, hh, mi, Math.min(ss, 59)));\n  // Reject dates that rolled over, e.g. 31.02.\n  if (date.getUTCMonth() !== mm - 1 || date.getUTCDate() !== dd) return null;\n  return date;\n}\n\n/**\n * Parse the fixed 256-byte header plus the per-signal header block.\n *\n * @param buf   At least FIXED_HEADER_BYTES + ns * SIGNAL_HEADER_BYTES bytes.\n * @param fileSize Total size of the file on disk, used to derive the real record count.\n */\nexport function parseHeader(buf: Uint8Array, fileSize: number): EdfHeaderInfo {\n  const diagnostics: Diagnostic[] = [];\n  const sawComma = { value: false };\n\n  if (buf.length < FIXED_HEADER_BYTES) {\n    throw new EdfError(\n      'FILE_TOO_SMALL',\n      `File is ${fileSize} bytes; an EDF header alone needs at least ${FIXED_HEADER_BYTES}.`,\n    );\n  }\n\n  // BDF (BioSemi) marks itself with byte 255 followed by 'BIOSEMI', and stores\n  // 3-byte samples instead of 2. Everything else about the layout is identical.\n  const isBdf = buf[0] === 0xff && dec(buf, 1, 7) === 'BIOSEMI';\n  const version = isBdf ? 'BIOSEMI' : trimField(dec(buf, 0, 8));\n\n  const patientId = trimField(dec(buf, 8, 80));\n  const recordingId = trimField(dec(buf, 88, 80));\n  const startDateRaw = trimField(dec(buf, 168, 8));\n  const startTimeRaw = trimField(dec(buf, 176, 8));\n  const headerBytes = parseNumberField(dec(buf, 184, 8), 'number of header bytes', {\n    integer: true,\n    sawComma,\n  });\n  const reserved = trimField(dec(buf, 192, 44));\n  const declaredRecordCount = parseNumberField(dec(buf, 236, 8), 'number of data records', {\n    integer: true,\n    sawComma,\n  });\n  const recordDuration = parseNumberField(dec(buf, 244, 8), 'duration of a data record', {\n    sawComma,\n  });\n  const signalCount = parseNumberField(dec(buf, 252, 4), 'number of signals', {\n    integer: true,\n    sawComma,\n  });\n\n  if (signalCount <= 0) {\n    throw new EdfError(\n      'INVALID_SIGNAL_COUNT',\n      `Header declares ${signalCount} signals; expected at least 1.`,\n    );\n  }\n  if (!(recordDuration > 0)) {\n    throw new EdfError(\n      'INVALID_RECORD_DURATION',\n      `Header declares a data record duration of ${recordDuration}s; expected a positive number.`,\n    );\n  }\n\n  const expectedHeaderBytes = FIXED_HEADER_BYTES + signalCount * SIGNAL_HEADER_BYTES;\n  if (buf.length < expectedHeaderBytes) {\n    throw new EdfError(\n      'FILE_TOO_SMALL',\n      /*\n        Which of the two is actually short.\n\n        The file size was quoted either way, so a caller that had read too little — the\n        signal count parsed one way here and another way there — produced arithmetic that\n        refuted itself: \"needs a 768-byte header, but the file is only 848 bytes\". A reader\n        following that looks for a truncation that is not there.\n      */\n      `File declares ${signalCount} signals, which needs a ${expectedHeaderBytes}-byte header, ` +\n        (fileSize < expectedHeaderBytes\n          ? `but the file is only ${fileSize} bytes.`\n          : `but only ${buf.length} bytes of it were handed to the parser.`),\n    );\n  }\n  if (headerBytes !== expectedHeaderBytes) {\n    diagnostics.push({\n      code: 'HEADER_BYTES_MISMATCH',\n      severity: 'warning',\n      message:\n        `Header says it is ${headerBytes} bytes, but ${signalCount} signals require ` +\n        `${expectedHeaderBytes} bytes. Using the value computed from the signal count.`,\n    });\n  }\n\n  // Signal headers are field-major: all labels, then all transducers, and so on.\n  const base = FIXED_HEADER_BYTES;\n  const readField = (offsetUnits: number, width: number, i: number): string =>\n    dec(buf, base + offsetUnits * signalCount + i * width, width);\n\n  // EDF+ writes 'EDF+C'/'EDF+D' here; BDF+ writes 'BDF+C'/'BDF+D'. The two mean the\n  // same thing, so both are normalised to a single continuity marker.\n  const continuityTag = /^(?:EDF|BDF)\\+([CD])/u.exec(reserved);\n  const continuity: 'EDF+C' | 'EDF+D' | null =\n    continuityTag === null ? null : continuityTag[1] === 'D' ? 'EDF+D' : 'EDF+C';\n\n  const signals: EdfSignal[] = [];\n  let byteOffsetInRecord = 0;\n  const bytesPerSample = isBdf ? 3 : 2;\n  const seenLabels = new Map<string, number[]>();\n  const emptyLabels: number[] = [];\n\n  for (let i = 0; i < signalCount; i++) {\n    const label = trimField(readField(0, 16, i));\n    const transducer = trimField(readField(16, 80, i));\n    const physicalDimension = trimField(readField(96, 8, i));\n    const physicalMin = parseNumberField(readField(104, 8, i), `physical minimum (signal ${i})`, {\n      sawComma,\n    });\n    const physicalMax = parseNumberField(readField(112, 8, i), `physical maximum (signal ${i})`, {\n      sawComma,\n    });\n    const digitalMin = parseNumberField(readField(120, 8, i), `digital minimum (signal ${i})`, {\n      integer: true,\n      sawComma,\n    });\n    const digitalMax = parseNumberField(readField(128, 8, i), `digital maximum (signal ${i})`, {\n      integer: true,\n      sawComma,\n    });\n    const prefiltering = trimField(readField(136, 80, i));\n    const samplesPerRecord = parseNumberField(\n      readField(216, 8, i),\n      `samples per record (signal ${i})`,\n      { integer: true, sawComma },\n    );\n    const sigReserved = trimField(readField(224, 32, i));\n\n    if (samplesPerRecord < 0) {\n      throw new EdfError(\n        'BAD_HEADER_FIELD',\n        `Signal ${i} (\"${label}\") declares ${samplesPerRecord} samples per record.`,\n      );\n    }\n\n    const isAnnotations = label === ANNOTATIONS_LABEL || label === BDF_ANNOTATIONS_LABEL;\n\n    signals.push({\n      index: i,\n      label,\n      transducer,\n      physicalDimension,\n      physicalMin,\n      physicalMax,\n      digitalMin,\n      digitalMax,\n      prefiltering,\n      samplesPerRecord,\n      reserved: sigReserved,\n      isAnnotations,\n      samplingRate: samplesPerRecord / recordDuration,\n      byteOffsetInRecord,\n    });\n    byteOffsetInRecord += samplesPerRecord * bytesPerSample;\n\n    if (!isAnnotations) {\n      /*\n        A label is free text out of the file, and it becomes a column name in signals.csv.\n\n        `--info` has escaped control bytes since it was written, because an ANSI escape in a\n        header can drive the reader's terminal — `\\x1b[2J` clears the screen. The CSV had no\n        such protection and needed none for correctness: quoting makes any byte safe for a\n        parser, and this still passes the label through exactly as the file gives it, because\n        losing what the header says is not an improvement.\n\n        What was missing is the sentence saying so. A recording whose channel is labelled\n        `\\x1b[2Jgone` converted with no warning at all, and `cat signals.csv` then cleared\n        the terminal — while a script referencing that column by name carried an invisible\n        control character in it. NONPRINTABLE_LABEL has been declared and documented as\n        reserved since 0.1; this is it doing its job.\n      */\n      /*\n        Which of the two fields carries them, because the consequences are not the same.\n\n        The message said \"label or unit\", and then said the bytes \"will appear in the CSV\n        column name\" and that \"the name cannot be typed\" — both of which are about the label.\n        A channel labelled plainly `ECG` in a unit of `u\\x07V` got all of it: its column is\n        `ECG`, `--channels ECG` selects it and exits 0, and the byte is in channels.csv's\n        `unit` cell, which the warning never mentioned. Three sentences, none of them true of\n        the file that raised it, on a warning whose whole purpose is to say where an invisible\n        byte went.\n      */\n      /*\n        All four free-text fields, not the two that were checked.\n\n        `transducer` and `prefiltering` are free text out of the header exactly as the label\n        and the unit are, and they land in channels.csv exactly as the unit does — so an ESC\n        byte in a transducer field reached the CSV raw with nothing said, and `cat\n        channels.csv` would drive the terminal. That is the hazard this warning exists for,\n        two columns over. 0.5.71 made it name which field carries them; this is the rest of\n        the fields it can name.\n      */\n      const fields = [\n        ['label', label],\n        ['unit', physicalDimension],\n        ['transducer', transducer],\n        ['prefiltering', prefiltering],\n      ] as const;\n      const affected = fields.filter(([, text]) => [...text].some(isControlCharacter));\n      const control = affected.flatMap(([, text]) => [...text].filter(isControlCharacter));\n      if (control.length > 0) {\n        const shown = [...new Set(control)]\n          .map((c) => `\\\\x${(c.codePointAt(0) as number).toString(16).padStart(2, '0')}`)\n          .join(', ');\n        const plural = control.length === 1 ? '' : 's';\n        const inLabel = affected.some(([name]) => name === 'label');\n        // \"label and unit\", not \"label, unit\" — `listed` is for long enumerations that get\n        // truncated, and this is a sentence with at most four items in it.\n        const names = affected.map(([name]) => name);\n        const named =\n          names.length === 1\n            ? (names[0] as string)\n            : `${names.slice(0, -1).join(', ')} and ${names[names.length - 1] as string}`;\n        // Where they land, which is the question the reader has. A label becomes a column\n        // name in signals.csv; the other three are cells of channels.csv and nothing else.\n        // Named down to the cell when there is one of them, because that is the answer to\n        // \"where did it go\" — `channels.csv` alone leaves a reader scanning fourteen columns.\n        const cells = affected.filter(([name]) => name !== 'label').map(([name]) => name);\n        const where =\n          cells.length === 1 ? `channels.csv's ${cells[0] as string} cell` : 'channels.csv';\n        const lands =\n          inLabel && cells.length > 0\n            ? `which will appear in the CSV column name and in ${where}`\n            : inLabel\n              ? 'which will appear in the CSV column name'\n              : `which will appear in ${where}`;\n        diagnostics.push({\n          code: 'NONPRINTABLE_LABEL',\n          severity: 'warning',\n          message:\n            `Signal ${i}'s ${named} ${affected.length === 1 ? 'contains' : 'contain'} ` +\n            `${control.length} control character${plural} (${shown}), ${lands} exactly as the ` +\n            `header has them.`,\n          hint:\n            /*\n              Every branch has to print a command that works.\n\n              The middle one quoted the label back, which is right until the label is empty:\n              an unlabelled channel got `--channels \"\"`, and that exits 2 with \"--channels was\n              given but lists no channel names\". A hint whose command fails is worse than no\n              hint, and this warning's whole job is to say how to reach a channel whose header\n              text you cannot type. `EMPTY_LABEL` already says the position is the only way in\n              for such a channel; so does this now.\n            */\n            (inLabel || label === ''\n              ? `Address the channel by position with --channels \"#${i}\" rather than by name, ` +\n                `since ${inLabel ? 'the name cannot be typed' : 'it has no label'}. `\n              : `The column name is unaffected, so --channels \"${label}\" still selects it. `) +\n            'Printing the CSV to a terminal may do more than print it.',\n        });\n      }\n\n      if (label === '') {\n        // Collected, not reported here: what this channel's column ends up called depends on\n        // whether some later channel is literally labelled `signal_<i>`, and inside this loop\n        // the later channels do not exist yet. See the pass below.\n        emptyLabels.push(i);\n      } else {\n        // Collected rather than reported here: a label repeated five times should\n        // produce one warning naming all five, not four near-identical pairs.\n        const seen = seenLabels.get(label);\n        if (seen) seen.push(i);\n        else seenLabels.set(label, [i]);\n      }\n\n      if (samplesPerRecord === 0) {\n        diagnostics.push({\n          code: 'NO_SAMPLES',\n          severity: 'warning',\n          message: `Signal ${i} (\"${label}\") carries no samples at all (0 per data record).`,\n          hint: 'It is described in channels.csv but left out of the converted data.',\n        });\n      }\n\n      /*\n        Too large to represent, and too small — the second was silent.\n\n        The gain is the span divided by the digital range, and a span of 2e-320 over 65,535\n        codes is 3e-325: below the smallest subnormal double, so it underflows to +0. The\n        scaler's flat-range branch then handed every code the same physical value, and a\n        channel of 65,536 distinct readings became one repeated number with nothing raised at\n        all. One power of ten away, at 1e-319, the same file raises VALUE_RESOLUTION.\n\n        Both are the same fact about the header — the span cannot be turned into a mapping —\n        so both get this code, and both leave the cells empty rather than filling them with a\n        value the header cannot justify.\n      */\n      const span = physicalMax - physicalMin;\n      const underflowed = span !== 0 && span / (digitalMax - digitalMin) === 0;\n      if (!Number.isFinite(span) || underflowed) {\n        diagnostics.push({\n          code: 'UNUSABLE_PHYSICAL_RANGE',\n          severity: 'warning',\n          message:\n            `Signal ${i} (\"${label}\") declares a physical range from ${physicalMin} to ` +\n            `${physicalMax}, whose span is too ${underflowed ? 'small' : 'large'} to ` +\n            `represent, so its values cannot be scaled.`,\n          hint: 'Its cells are left empty rather than filled with a value the header cannot justify.',\n        });\n      } else if (digitalMax === digitalMin) {\n        diagnostics.push({\n          code: 'DEGENERATE_DIGITAL_RANGE',\n          severity: 'warning',\n          message:\n            `Signal ${i} (\"${label}\") has digital minimum equal to digital maximum ` +\n            `(${digitalMin}), so its values cannot be scaled.`,\n          hint: 'Its cells are left empty rather than filled with a value the header cannot justify.',\n        });\n      } else if (physicalMax === physicalMin) {\n        diagnostics.push({\n          code: 'DEGENERATE_PHYSICAL_RANGE',\n          severity: 'warning',\n          message:\n            `Signal ${i} (\"${label}\") has physical minimum equal to physical maximum ` +\n            `(${physicalMin}), so every sample converts to the same value.`,\n        });\n      } else if ((physicalMax - physicalMin) * (digitalMax - digitalMin) < 0) {\n        /*\n          Polarity is inverted when the gain is negative, and the gain is\n          (physicalMax - physicalMin) / (digitalMax - digitalMin) — so it is the sign of the\n          two spans together that matters, not the physical pair alone.\n\n          Testing only `physicalMax < physicalMin` was wrong in both directions. A file with\n          its DIGITAL bounds reversed is just as inverted and drew no warning at all, handing\n          back sign-flipped EEG with nothing to indicate it. A file with BOTH pairs reversed\n          has a positive gain and is not inverted, yet was warned about — a message that was\n          simply untrue of that recording.\n        */\n        const reversed =\n          physicalMax < physicalMin\n            ? `physical minimum ${physicalMin} above physical maximum ${physicalMax}`\n            : `digital minimum ${digitalMin} above digital maximum ${digitalMax}`;\n        diagnostics.push({\n          code: 'INVERTED_PHYSICAL_RANGE',\n          severity: 'warning',\n          message: `Signal ${i} (\"${label}\") declares ${reversed}, which inverts its polarity.`,\n          hint: 'The values are converted exactly as the header specifies, inversion included.',\n        });\n      }\n    }\n  }\n\n  /*\n    What an unlabelled channel is actually called, which the message used to guess.\n\n    A channel with no label takes `signal_<index>` — unless another channel is literally\n    labelled that, which EDF permits, since labels are free text and nothing enforces anything\n    about them. Then both collide and both are suffixed. The warning said \"It will appear as\n    \"signal_0\"\" while the file's header read `time_s,signal_0_ch0,signal_0_ch1`: the one\n    sentence the run printed named a column that exists in neither signals.csv nor\n    channels.csv.\n\n    The other half was silent. The channel that genuinely carries the label `signal_0` lost\n    its own column name to a collision with a synthesised one, and nothing said so —\n    DUPLICATE_LABEL did not fire, because the two labels are not the same label. Both halves\n    are one sentence here, because they are one event.\n\n    No specific suffixed name is quoted. The suffix rule has a second pass for names that are\n    still shared afterwards, and a message that hard-coded `_ch<index>` would be guessing again\n    in exactly the way this is fixing.\n  */\n  for (const index of emptyLabels) {\n    const taken = seenLabels.get(`signal_${index}`);\n    diagnostics.push({\n      code: 'EMPTY_LABEL',\n      severity: 'warning',\n      message:\n        taken === undefined\n          ? `Signal ${index} has no label. It will appear as \"signal_${index}\".`\n          : `Signal ${index} has no label, so it takes the name \"signal_${index}\" — which ` +\n            `${taken.length === 1 ? 'signal' : 'signals'} ${listed(taken.map(String))} already ` +\n            `${taken.length === 1 ? 'carries' : 'carry'} as a label, so both columns are ` +\n            `suffixed with their position instead.`,\n    });\n  }\n\n  /*\n    A timestamp that is not one.\n\n    EDF gives the start date and time eight characters each, and nothing stops a writer\n    putting `32.13.99` and `25.61.61` there. `--info` has always echoed the raw fields with\n    \"(unparseable)\" beside them, but nothing was raised: the conversion exited 0, `--strict`\n    passed, and metadata.json recorded `start_datetime_local: null` with no note against it.\n\n    Every other unusable header field reports itself — a degenerate digital range, a physical\n    span that cannot be represented, a comma decimal separator, a header whose declared size\n    disagrees with its signal count. This was the one that did not, and it is the field\n    output-files points at for turning `time_s` into an absolute instant.\n  */\n  if (resolveStartDateTime(startDateRaw, startTimeRaw) === null) {\n    diagnostics.push({\n      code: 'START_TIME_UNREADABLE',\n      severity: 'warning',\n      message:\n        `The header's start date and time (\"${startDateRaw}\" and ` +\n        `\"${startTimeRaw}\") are not a date and a time, so the recording has ` +\n        `no start instant.`,\n      hint:\n        'time_s is unaffected — it counts from the start of the recording either way. What ' +\n        'cannot be done is turning it into a wall-clock instant, and metadata.json records ' +\n        'start_datetime_local as null.',\n    });\n  }\n\n  for (const [label, indices] of seenLabels) {\n    if (indices.length < 2) continue;\n    diagnostics.push({\n      code: 'DUPLICATE_LABEL',\n      severity: 'warning',\n      message: `${indices.length} signals share the label \"${label}\" (positions ${indices.join(', ')}).`,\n      hint: 'Their columns are suffixed with the signal number so they stay distinguishable.',\n    });\n  }\n\n  const recordBytes = byteOffsetInRecord;\n  if (recordBytes <= 0) {\n    throw new EdfError(\n      'NO_SAMPLES',\n      'No signal in this file carries any samples (every channel declares 0 samples per record).',\n    );\n  }\n\n  if (sawComma.value) {\n    diagnostics.push({\n      code: 'COMMA_DECIMAL',\n      severity: 'warning',\n      message: 'Some header numbers use a comma decimal separator, which the EDF spec does not allow.',\n      hint: 'They were read as decimal points. Check the values in the channel table.',\n    });\n  }\n\n  const dataBytes = fileSize - expectedHeaderBytes;\n  if (dataBytes < 0) {\n    throw new EdfError('FILE_TOO_SMALL', `File is smaller than its own header.`);\n  }\n  const recordCount = Math.floor(dataBytes / recordBytes);\n  const trailingBytes = dataBytes - recordCount * recordBytes;\n\n  if (recordCount === 0) {\n    /*\n      Which of the two, and with the numbers.\n\n      \"The recording was probably interrupted before any data was written\" is right about an\n      empty file and wrong about the other way to get here: a header declaring records larger\n      than the data present. A 606 KB file holding 589 KB of samples — 60% of one record, more\n      than half a million readings — was told no data was written, and the message carried no\n      figures at all, so nothing in it could be checked against the file. The declared record\n      size is the thing to look at, and it was the one thing not said.\n\n      Still an error either way. A record is the unit the format is addressed in, and there is\n      nothing smaller to convert.\n    */\n    const empty = dataBytes === 0;\n    throw new EdfError(\n      'NO_DATA_RECORDS',\n      empty\n        ? 'The file contains a header and no data at all.'\n        : `The file contains ${counted(dataBytes, 'byte')} of data, which is less than the ` +\n          `${recordBytes} its header says one data record takes.`,\n      empty\n        ? 'The recording was probably interrupted before any data was written.'\n        : 'Either the recording was cut short part way through its first record, or the ' +\n          'header describes records larger than the ones actually written. Check the ' +\n          'samples-per-record fields against the file size.',\n    );\n  }\n\n  if (declaredRecordCount === -1) {\n    diagnostics.push({\n      code: 'RECORD_COUNT_UNKNOWN',\n      severity: 'warning',\n      message:\n        `The header does not say how many data records the file has (-1), which the spec allows ` +\n        `for recordings still in progress. Using the ${counted(recordCount, 'record')} the file actually contains.`,\n    });\n  } else if (declaredRecordCount !== recordCount) {\n    diagnostics.push({\n      code: 'RECORD_COUNT_MISMATCH',\n      severity: 'warning',\n      message:\n        `The header declares ${declaredRecordCount} data records but the file contains ` +\n        `${recordCount}. Converting the ${counted(recordCount, 'record')} that ${recordCount === 1 ? 'is' : 'are'} present.`,\n      hint:\n        declaredRecordCount > recordCount\n          ? 'The recording looks truncated. It may have been cut short or copied incompletely.'\n          : 'The file is longer than its header claims.',\n    });\n  }\n\n  if (trailingBytes > 0) {\n    diagnostics.push({\n      code: 'TRAILING_BYTES',\n      severity: 'warning',\n      message: `${counted(trailingBytes, 'byte')} after the last complete data record ${trailingBytes === 1 ? 'was' : 'were'} ignored.`,\n    });\n  }\n\n  const isEdfPlus = continuity !== null;\n  if (continuity === 'EDF+D') {\n    diagnostics.push({\n      code: 'DISCONTINUOUS',\n      severity: 'warning',\n      message:\n        `This is a discontinuous (${isBdf ? 'BDF+D' : 'EDF+D'}) recording: its data records are ` +\n        `not contiguous in time.`,\n      hint: 'Each row carries its true recording time, so gaps stay visible instead of being closed.',\n    });\n  }\n\n  const dataSignals = signals.filter((s) => !s.isAnnotations);\n  if (dataSignals.length === 0) {\n    diagnostics.push({\n      code: 'NO_SIGNAL_CHANNELS',\n      severity: 'warning',\n      message: 'This file has no signal channels; it contains only EDF+ annotations.',\n    });\n  }\n\n  // A channel declaring zero samples per record has no sampling rate to speak of — it is\n  // reported separately as NO_SAMPLES and no file is written for it. Counting its nominal\n  // 0 Hz as a rate made a single-rate recording warn that it used \"2 different sampling\n  // rates (4 Hz, 0 Hz)\" and claim it was splitting output it never split.\n  const rates = new Set(dataSignals.filter((s) => s.samplesPerRecord > 0).map((s) => s.samplingRate));\n  if (rates.size > 1) {\n    diagnostics.push({\n      code: 'MIXED_SAMPLING_RATES',\n      severity: 'warning',\n      message:\n        `Channels use ${rates.size} different sampling rates ` +\n        `(${listed(formatRates([...rates].sort((a, b) => b - a)).map((r) => `${r} Hz`))}).`,\n      hint: 'They are written to one file per rate so no channel is resampled.',\n    });\n  }\n\n  return {\n    header: {\n      version,\n      patientId,\n      recordingId,\n      startDateRaw,\n      startTimeRaw,\n      startDateTime: resolveStartDateTime(startDateRaw, startTimeRaw),\n      headerBytes: expectedHeaderBytes,\n      declaredHeaderBytes: headerBytes,\n      reserved,\n      isEdfPlus,\n      isBdf,\n      continuity,\n      declaredRecordCount,\n      recordDuration,\n      signalCount,\n      signals,\n      bytesPerSample,\n      recordBytes,\n    },\n    recordCount,\n    trailingBytes,\n    diagnostics,\n  };\n}\n\n/**\n * The recording start as a zone-less wall clock, \"YYYY-MM-DDTHH:MM:SS\".\n *\n * EDF stores the start time as local wall-clock digits with no timezone anywhere in\n * the format. `startDateTime` is built with Date.UTC purely so those digits survive a\n * round trip unshifted, which makes it a carrier for the wall clock rather than a\n * real instant. Serialising it with `toISOString()` would append a Z and assert UTC,\n * and any reader converting to local time would then shift the recording by their own\n * offset: 13:43:04 in the file becomes 08:43:04 in New York. The Z is omitted because\n * the file genuinely does not say which zone it meant.\n */\nexport function formatWallClock(date: Date | null): string | null {\n  if (!date) return null;\n  return date.toISOString().slice(0, 19);\n}\n\n/** \"EDF\", \"EDF+ (EDF+D)\", \"BDF\", \"BDF+ (EDF+C)\". */\nexport function describeFormat(header: EdfHeader): string {\n  const base = header.isBdf ? 'BDF' : 'EDF';\n  if (!header.isEdfPlus) return base;\n  return `${base}+ (${header.continuity === 'EDF+D' ? 'discontinuous' : 'continuous'})`;\n}\n\n/** Render a sampling rate without trailing noise: 256, 0.5, 12.5. */\nexport function formatRate(hz: number): string {\n  if (Number.isInteger(hz)) return String(hz);\n  const rounded = Number(hz.toFixed(6));\n  // A rate below 5e-7 rounds away to \"0\", which reads as \"this channel has no sampling\n  // rate\" and made the mixed-rate warning contradict itself: it announced two different\n  // rates and then printed both as \"0 Hz\". Exponent form keeps a real rate legible, and\n  // keeps distinct rates distinct in the channel table and in output filenames.\n  if (rounded === 0) return hz.toExponential(3);\n  return String(rounded);\n}\n\n/**\n * Renders a group of rates so that rates which differ read as differing.\n *\n * `formatRate` rounds to six decimals, which is what keeps an ordinary rate free of\n * float noise — 30 samples in a 0.1-second record is 299.99999999999994 as a double,\n * and belongs on screen as 300. Two rates separated by less than that round to one\n * string, so a file carrying 1e-6 Hz and 1.25e-6 Hz warned that it used \"2 different\n * sampling rates (0.000001 Hz, 0.000001 Hz)\" and named both files the same thing.\n *\n * That is the contradiction the exponent fallback above already removes for rates that\n * round away to zero; this is the same one a step further out. On a collision every rate\n * in the group switches to its shortest exact form, which is unique for distinct values,\n * rather than only the pair that collided — one column in one notation reads better than\n * two.\n */\nexport function formatRates(rates: readonly number[]): string[] {\n  const rounded = rates.map(formatRate);\n  const distinct = new Set(rates).size;\n  return new Set(rounded).size === distinct ? rounded : rates.map((hz) => String(hz));\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edf2csv",
-  "version": "0.5.102",
+  "version": "0.5.104",
   "description": "Convert EDF, EDF+ and BDF biosignal recordings (European Data Format) to CSV from the command line. Local, streaming, and never resamples or alters units.",
   "keywords": [
     "edf",